pkgs/data_assets/lib/data_assets.dart

// Copyright (c) 2023, the Dart project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

/// @docImport 'src/data_assets/config.dart';
/// @docImport 'src/data_assets/data_asset.dart';

/// Data asset support for hook authors.
///
/// A data asset is an asset bundled as data (String or bytes) with a Dart or
/// Flutter application.
///
/// Data assets can be added in a build hook as follows:
///
/// <!-- file://./../example/api/data_assets_snippet.dart -->
/// ```dart
/// import 'package:data_assets/data_assets.dart';
/// import 'package:hooks/hooks.dart';
///
/// void main(List<String> args) async {
///   await build(args, (input, output) async {
///     if (input.config.buildDataAssets) {
///       final packageName = input.packageName;
///       final assetPathInPackage = input.packageRoot.resolve('...');
///       final assetPathDownload = input.outputDirectoryShared.resolve('...');
///
///       output.assets.data.add(
///         DataAsset(
///           package: packageName,
///           name: '...',
///           file: assetPathInPackage,
///         ),
///       );
///     }
///   });
/// }
/// ```
///
/// See [DataAsset] and [BuildOutputDataAssetsBuilder.add] for more details.
///
/// For more documentation of hooks, refer to the API docs of
/// [`package:hooks`](https://pub.dev/packages/hooks).
library;

export 'src/data_assets/config.dart'
    show
        BuildOutputAssetsBuilderData,
        BuildOutputBuilderAddDataAssetsDirectories,
        BuildOutputDataAssets,
        BuildOutputDataAssetsBuilder,
        HookConfigDataConfig,
        LinkInputDataAssets,
        LinkOutputAssetsBuilderData,
        LinkOutputDataAssets,
        LinkOutputDataAssetsBuilder;
export 'src/data_assets/data_asset.dart' show DataAsset, EncodedDataAsset;
export 'src/data_assets/extension.dart';