[code_assets] [data_assets] Explicitly mention buildXXXAssets (#2676)

Author: dcharkes

pkgs/code_assets/lib/src/code_assets/config.dart

@@ -16,6 +16,8 @@ import 'syntax.g.dart';
 /// to code assets (only available if code assets are supported).
 extension HookConfigCodeConfig on HookConfig {
   /// Code asset specific configuration.
+  ///
+  /// Only available if [buildCodeAssets] is true.
   CodeConfig get code => CodeConfig._fromJson(json, path);
 
   /// Whether the hook invoker (e.g. the Dart or Flutter SDK) expects this
@@ -29,6 +31,8 @@ extension HookConfigCodeConfig on HookConfig {
 extension LinkInputCodeAssets on LinkInputAssets {
   /// The [CodeAsset]s in this [LinkInputAssets.encodedAssets].
   ///
+  /// Only available if [HookConfigCodeConfig.buildCodeAssets] is true.
+  ///
   /// NOTE: If the linker implementation depends on the contents of the files
   /// the code assets refer (e.g. looks at static archives and links them) then
   /// the linker script has to add those files as dependencies via
@@ -148,6 +152,8 @@ final class MacOSCodeConfig {
 /// Extension on [BuildOutputBuilder] to add [CodeAsset]s.
 extension BuildOutputAssetsBuilderCode on BuildOutputAssetsBuilder {
   /// Provides access to emitting code assets.
+  ///
+  /// Should only be used if [HookConfigCodeConfig.buildCodeAssets] is true.
   BuildOutputCodeAssetBuilder get code => BuildOutputCodeAssetBuilder._(this);
 }
 

pkgs/data_assets/lib/src/data_assets/config.dart

@@ -23,9 +23,12 @@ extension BuildOutputBuilderAddDataAssetsDirectories on BuildOutputBuilder {
   ///
   /// When recursive is set to true, the method will also add all subdirectories
   /// and their files as dependencies.
+  ///
+  /// Should only be used if [HookConfigDataConfig.buildDataAssets] in [input]
+  /// is true.
   Future<void> addDataAssetDirectories(
     List<String> paths, {
-    required BuildInput input,
+    required HookInput input,
     bool recursive = false,
     AssetRouting routing = const ToAppBundle(),
   }) async {
@@ -104,6 +107,8 @@ extension LinkInputDataAssets on LinkInputAssets {
 /// Extension on [BuildOutputBuilder] to add [DataAsset]s.
 extension BuildOutputAssetsBuilderData on BuildOutputAssetsBuilder {
   /// Provides access to emitting data assets.
+  ///
+  /// Should only be used if [HookConfigDataConfig.buildDataAssets] is true.
   BuildOutputDataAssetsBuilder get data => BuildOutputDataAssetsBuilder._(this);
 }