@fgv/ts-res 5.0.0-8 → 5.0.0-9

package/lib/packlets/bundle/bundleNormalizer.js

@@ -0,0 +1,142 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundleNormalizer = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const resources_1 = require("../resources");
+const resources_2 = require("../resources");
+const conditions_1 = require("../conditions");
+/**
+ * Normalizes ResourceManagerBuilder instances to ensure consistent ordering
+ * of internal entities, enabling order-independent bundle checksums.
+ *
+ * The normalization process rebuilds the ResourceManagerBuilder from the ground up
+ * in a canonical order to ensure identical index assignments regardless of
+ * original construction order.
+ * @public
+ */
+class BundleNormalizer {
+    /**
+     * Creates a normalized ResourceManagerBuilder from an existing builder.
+     * The normalized builder will have identical entities but arranged in
+     * canonical order to ensure consistent index assignments.
+     *
+     * @param originalBuilder - The ResourceManagerBuilder to normalize
+     * @param systemConfig - The SystemConfiguration used to create the original builder
+     * @returns Success with the normalized ResourceManagerBuilder if successful, Failure otherwise
+     */
+    static normalize(originalBuilder, systemConfig) {
+        // Create a fresh builder using the same system configuration
+        return resources_1.ResourceManagerBuilder.create({
+            qualifiers: systemConfig.qualifiers,
+            resourceTypes: systemConfig.resourceTypes
+        }).onSuccess((normalizedBuilder) => {
+            return BundleNormalizer._addNormalizedResources(originalBuilder, normalizedBuilder).onSuccess(() => (0, ts_utils_1.succeed)(normalizedBuilder));
+        });
+    }
+    /**
+     * Creates a normalized ResourceManagerBuilder using a predefined system configuration.
+     * This is a convenience method for the common case of using predefined configurations.
+     *
+     * @param originalBuilder - The ResourceManagerBuilder to normalize
+     * @param configName - The name of the predefined system configuration used
+     * @returns Success with the normalized ResourceManagerBuilder if successful, Failure otherwise
+     */
+    static normalizeFromPredefined(originalBuilder, configName) {
+        return resources_1.ResourceManagerBuilder.createPredefined(configName).onSuccess((normalizedBuilder) => {
+            return BundleNormalizer._addNormalizedResources(originalBuilder, normalizedBuilder).onSuccess(() => (0, ts_utils_1.succeed)(normalizedBuilder));
+        });
+    }
+    /**
+     * Normalizes all conditions from the original builder by adding them to the
+     * normalized builder in sorted order using loose condition declarations.
+     *
+     * @param originalBuilder - The source ResourceManagerBuilder
+     * @param normalizedBuilder - The target normalized ResourceManagerBuilder
+     * @returns Success if all conditions were normalized successfully, Failure otherwise
+     * @internal
+     */
+    static _normalizeConditions(originalBuilder, normalizedBuilder) {
+        const conditions = Array.from(originalBuilder.conditions.values()).sort(conditions_1.Condition.compare);
+        const errors = new ts_utils_1.MessageAggregator();
+        for (const condition of conditions) {
+            const looseDecl = condition.toLooseConditionDecl();
+            normalizedBuilder.addCondition(looseDecl).aggregateError(errors);
+        }
+        return errors.returnOrReport((0, ts_utils_1.succeed)(true));
+    }
+    /**
+     * Normalizes all condition sets from the original builder by adding them to the
+     * normalized builder in sorted order using loose condition set declarations.
+     *
+     * @param originalBuilder - The source ResourceManagerBuilder
+     * @param normalizedBuilder - The target normalized ResourceManagerBuilder
+     * @returns Success if all condition sets were normalized successfully, Failure otherwise
+     * @internal
+     */
+    static _normalizeConditionSets(originalBuilder, normalizedBuilder) {
+        const conditionSets = Array.from(originalBuilder.conditionSets.values()).sort(conditions_1.ConditionSet.compare);
+        const errors = new ts_utils_1.MessageAggregator();
+        for (const conditionSet of conditionSets) {
+            const conditions = conditionSet.toConditionSetArrayDecl();
+            normalizedBuilder.addConditionSet(conditions).aggregateError(errors);
+        }
+        return errors.returnOrReport((0, ts_utils_1.succeed)(true));
+    }
+    /**
+     * Normalizes all candidates by sorting them first by resource ID, then by condition set.
+     *
+     * @param originalBuilder - The source ResourceManagerBuilder
+     * @param normalizedBuilder - The target normalized ResourceManagerBuilder
+     * @returns Success if all candidates were normalized successfully, Failure otherwise
+     * @internal
+     */
+    static _normalizeCandidates(originalBuilder, normalizedBuilder) {
+        const candidates = Array.from(originalBuilder.getAllCandidates()).sort((c1, c2) => {
+            const idCompare = c1.id.localeCompare(c2.id);
+            return idCompare !== 0 ? idCompare : resources_2.ResourceCandidate.compare(c1, c2);
+        });
+        const errors = new ts_utils_1.MessageAggregator();
+        for (const candidate of candidates) {
+            const decl = candidate.toLooseResourceCandidateDecl();
+            normalizedBuilder.addLooseCandidate(decl).aggregateError(errors);
+        }
+        return errors.returnOrReport((0, ts_utils_1.succeed)(true));
+    }
+    /**
+     * Adds normalized resources to the target builder by first normalizing conditions,
+     * then condition sets, then candidates.
+     *
+     * @param originalBuilder - The source ResourceManagerBuilder
+     * @param normalizedBuilder - The target normalized ResourceManagerBuilder
+     * @returns Success if all resources were added successfully, Failure otherwise
+     * @internal
+     */
+    static _addNormalizedResources(originalBuilder, normalizedBuilder) {
+        return BundleNormalizer._normalizeConditions(originalBuilder, normalizedBuilder)
+            .onSuccess(() => BundleNormalizer._normalizeConditionSets(originalBuilder, normalizedBuilder))
+            .onSuccess(() => BundleNormalizer._normalizeCandidates(originalBuilder, normalizedBuilder));
+    }
+}
+exports.BundleNormalizer = BundleNormalizer;
+//# sourceMappingURL=bundleNormalizer.js.map

package/lib/packlets/bundle/bundleNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleNormalizer.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleNormalizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, succeed, MessageAggregator } from '@fgv/ts-utils';\nimport { ResourceManagerBuilder } from '../resources';\nimport { ResourceCandidate } from '../resources';\nimport { SystemConfiguration, PredefinedSystemConfiguration } from '../config';\nimport { Condition, ConditionSet } from '../conditions';\n\n/**\n * Normalizes ResourceManagerBuilder instances to ensure consistent ordering\n * of internal entities, enabling order-independent bundle checksums.\n *\n * The normalization process rebuilds the ResourceManagerBuilder from the ground up\n * in a canonical order to ensure identical index assignments regardless of\n * original construction order.\n * @public\n */\nexport class BundleNormalizer {\n  /**\n   * Creates a normalized ResourceManagerBuilder from an existing builder.\n   * The normalized builder will have identical entities but arranged in\n   * canonical order to ensure consistent index assignments.\n   *\n   * @param originalBuilder - The ResourceManagerBuilder to normalize\n   * @param systemConfig - The SystemConfiguration used to create the original builder\n   * @returns Success with the normalized ResourceManagerBuilder if successful, Failure otherwise\n   */\n  public static normalize(\n    originalBuilder: ResourceManagerBuilder,\n    systemConfig: SystemConfiguration\n  ): Result<ResourceManagerBuilder> {\n    // Create a fresh builder using the same system configuration\n    return ResourceManagerBuilder.create({\n      qualifiers: systemConfig.qualifiers,\n      resourceTypes: systemConfig.resourceTypes\n    }).onSuccess((normalizedBuilder) => {\n      return BundleNormalizer._addNormalizedResources(originalBuilder, normalizedBuilder).onSuccess(() =>\n        succeed(normalizedBuilder)\n      );\n    });\n  }\n\n  /**\n   * Creates a normalized ResourceManagerBuilder using a predefined system configuration.\n   * This is a convenience method for the common case of using predefined configurations.\n   *\n   * @param originalBuilder - The ResourceManagerBuilder to normalize\n   * @param configName - The name of the predefined system configuration used\n   * @returns Success with the normalized ResourceManagerBuilder if successful, Failure otherwise\n   */\n  public static normalizeFromPredefined(\n    originalBuilder: ResourceManagerBuilder,\n    configName: PredefinedSystemConfiguration\n  ): Result<ResourceManagerBuilder> {\n    return ResourceManagerBuilder.createPredefined(configName).onSuccess((normalizedBuilder) => {\n      return BundleNormalizer._addNormalizedResources(originalBuilder, normalizedBuilder).onSuccess(() =>\n        succeed(normalizedBuilder)\n      );\n    });\n  }\n\n  /**\n   * Normalizes all conditions from the original builder by adding them to the\n   * normalized builder in sorted order using loose condition declarations.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all conditions were normalized successfully, Failure otherwise\n   * @internal\n   */\n  private static _normalizeConditions(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    const conditions = Array.from(originalBuilder.conditions.values()).sort(Condition.compare);\n\n    const errors = new MessageAggregator();\n    for (const condition of conditions) {\n      const looseDecl = condition.toLooseConditionDecl();\n      normalizedBuilder.addCondition(looseDecl).aggregateError(errors);\n    }\n\n    return errors.returnOrReport(succeed(true));\n  }\n\n  /**\n   * Normalizes all condition sets from the original builder by adding them to the\n   * normalized builder in sorted order using loose condition set declarations.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all condition sets were normalized successfully, Failure otherwise\n   * @internal\n   */\n  private static _normalizeConditionSets(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    const conditionSets = Array.from(originalBuilder.conditionSets.values()).sort(ConditionSet.compare);\n\n    const errors = new MessageAggregator();\n    for (const conditionSet of conditionSets) {\n      const conditions = conditionSet.toConditionSetArrayDecl();\n      normalizedBuilder.addConditionSet(conditions).aggregateError(errors);\n    }\n\n    return errors.returnOrReport(succeed(true));\n  }\n\n  /**\n   * Normalizes all candidates by sorting them first by resource ID, then by condition set.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all candidates were normalized successfully, Failure otherwise\n   * @internal\n   */\n  private static _normalizeCandidates(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    const candidates = Array.from(originalBuilder.getAllCandidates()).sort((c1, c2) => {\n      const idCompare = c1.id.localeCompare(c2.id);\n      return idCompare !== 0 ? idCompare : ResourceCandidate.compare(c1, c2);\n    });\n\n    const errors = new MessageAggregator();\n    for (const candidate of candidates) {\n      const decl = candidate.toLooseResourceCandidateDecl();\n      normalizedBuilder.addLooseCandidate(decl).aggregateError(errors);\n    }\n\n    return errors.returnOrReport(succeed(true));\n  }\n\n  /**\n   * Adds normalized resources to the target builder by first normalizing conditions,\n   * then condition sets, then candidates.\n   *\n   * @param originalBuilder - The source ResourceManagerBuilder\n   * @param normalizedBuilder - The target normalized ResourceManagerBuilder\n   * @returns Success if all resources were added successfully, Failure otherwise\n   * @internal\n   */\n  private static _addNormalizedResources(\n    originalBuilder: ResourceManagerBuilder,\n    normalizedBuilder: ResourceManagerBuilder\n  ): Result<boolean> {\n    return BundleNormalizer._normalizeConditions(originalBuilder, normalizedBuilder)\n      .onSuccess(() => BundleNormalizer._normalizeConditionSets(originalBuilder, normalizedBuilder))\n      .onSuccess(() => BundleNormalizer._normalizeCandidates(originalBuilder, normalizedBuilder));\n  }\n}\n"]}

package/lib/packlets/bundle/bundleUtils.d.ts

@@ -0,0 +1,70 @@
+import { Result } from '@fgv/ts-utils';
+import { SystemConfiguration } from '../config';
+import { Compiled as ResourceJsonCompiled } from '../resource-json';
+import { IBundleMetadata } from './model';
+/**
+ * Components extracted from a bundle for reuse in different contexts.
+ * @public
+ */
+export interface IBundleComponents {
+    /**
+     * The system configuration from the bundle.
+     */
+    systemConfiguration: SystemConfiguration;
+    /**
+     * The compiled resource collection from the bundle.
+     */
+    compiledCollection: ResourceJsonCompiled.ICompiledResourceCollection;
+    /**
+     * The bundle metadata including build information.
+     */
+    metadata: IBundleMetadata;
+}
+/**
+ * Utility functions for working with resource bundles.
+ * Provides reusable logic for bundle detection, parsing, and component extraction.
+ * @public
+ */
+export declare class BundleUtils {
+    /**
+     * Checks if the given object appears to be a bundle file by examining its structure.
+     * This is a lightweight check that doesn't perform full validation.
+     * @param data - The data to check
+     * @returns True if the data appears to be a bundle structure
+     * @public
+     */
+    static isBundleFile(data: unknown): boolean;
+    /**
+     * Extracts and validates components from a bundle for reuse.
+     * Performs full validation of the bundle structure and creates typed components.
+     * @param bundleData - The raw bundle data to extract components from
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static extractBundleComponents(bundleData: unknown): Result<IBundleComponents>;
+    /**
+     * Extracts just the metadata from potential bundle data without full validation.
+     * Useful for displaying bundle information without processing the entire bundle.
+     * @param data - The data to extract metadata from
+     * @returns Success with metadata if found and valid, Failure otherwise
+     * @public
+     */
+    static extractBundleMetadata(data: unknown): Result<IBundleMetadata>;
+    /**
+     * Parses bundle data from a JSON string.
+     * Convenience method that combines JSON parsing with bundle component extraction.
+     * @param jsonString - The JSON string containing bundle data
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static parseBundleFromJson(jsonString: string): Result<IBundleComponents>;
+    /**
+     * Checks if a file name suggests it might be a bundle file.
+     * This is a heuristic check based on file naming conventions.
+     * @param fileName - The file name to check
+     * @returns True if the file name suggests a bundle file
+     * @public
+     */
+    static isBundleFileName(fileName: string): boolean;
+}
+//# sourceMappingURL=bundleUtils.d.ts.map

package/lib/packlets/bundle/bundleUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleUtils.d.ts","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleUtils.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,mBAAmB,EAAE,mBAAmB,CAAC;IAEzC;;OAEG;IACH,kBAAkB,EAAE,oBAAoB,CAAC,2BAA2B,CAAC;IAErE;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;WACW,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAIlD;;;;;;OAMG;WACW,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAwBrF;;;;;;OAMG;WACW,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC;IAW3E;;;;;;OAMG;WACW,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAShF;;;;;;OAMG;WACW,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAS1D"}

package/lib/packlets/bundle/bundleUtils.js

@@ -0,0 +1,119 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundleUtils = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const config_1 = require("../config");
+const convert_1 = require("./convert");
+/**
+ * Utility functions for working with resource bundles.
+ * Provides reusable logic for bundle detection, parsing, and component extraction.
+ * @public
+ */
+class BundleUtils {
+    /**
+     * Checks if the given object appears to be a bundle file by examining its structure.
+     * This is a lightweight check that doesn't perform full validation.
+     * @param data - The data to check
+     * @returns True if the data appears to be a bundle structure
+     * @public
+     */
+    static isBundleFile(data) {
+        return convert_1.bundle.convert(data).isSuccess();
+    }
+    /**
+     * Extracts and validates components from a bundle for reuse.
+     * Performs full validation of the bundle structure and creates typed components.
+     * @param bundleData - The raw bundle data to extract components from
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static extractBundleComponents(bundleData) {
+        // First validate and convert the bundle
+        const bundleResult = convert_1.bundle.convert(bundleData);
+        if (bundleResult.isFailure()) {
+            return (0, ts_utils_1.fail)(`Invalid bundle structure: ${bundleResult.message}`);
+        }
+        const bundle = bundleResult.value;
+        // Create SystemConfiguration from the bundle config
+        const systemConfigResult = config_1.SystemConfiguration.create(bundle.config);
+        if (systemConfigResult.isFailure()) {
+            return (0, ts_utils_1.fail)(`Invalid system configuration in bundle: ${systemConfigResult.message}`);
+        }
+        const systemConfiguration = systemConfigResult.value;
+        return (0, ts_utils_1.succeed)({
+            systemConfiguration,
+            compiledCollection: bundle.compiledCollection,
+            metadata: bundle.metadata
+        });
+    }
+    /**
+     * Extracts just the metadata from potential bundle data without full validation.
+     * Useful for displaying bundle information without processing the entire bundle.
+     * @param data - The data to extract metadata from
+     * @returns Success with metadata if found and valid, Failure otherwise
+     * @public
+     */
+    static extractBundleMetadata(data) {
+        return convert_1.bundle
+            .convert(data)
+            .onSuccess((bundle) => {
+            return (0, ts_utils_1.succeed)(bundle.metadata);
+        })
+            .withErrorFormat((err) => {
+            return `Not a bundle file: ${err}`;
+        });
+    }
+    /**
+     * Parses bundle data from a JSON string.
+     * Convenience method that combines JSON parsing with bundle component extraction.
+     * @param jsonString - The JSON string containing bundle data
+     * @returns Success with bundle components if valid, Failure with error message otherwise
+     * @public
+     */
+    static parseBundleFromJson(jsonString) {
+        try {
+            const data = JSON.parse(jsonString);
+            return BundleUtils.extractBundleComponents(data);
+        }
+        catch (error) {
+            return (0, ts_utils_1.fail)(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Checks if a file name suggests it might be a bundle file.
+     * This is a heuristic check based on file naming conventions.
+     * @param fileName - The file name to check
+     * @returns True if the file name suggests a bundle file
+     * @public
+     */
+    static isBundleFileName(fileName) {
+        const lowerName = fileName.toLowerCase();
+        return (lowerName.endsWith('.bundle.json') ||
+            lowerName.endsWith('-bundle.json') ||
+            lowerName.endsWith('_bundle.json') ||
+            (lowerName.includes('bundle') && lowerName.endsWith('.json')));
+    }
+}
+exports.BundleUtils = BundleUtils;
+//# sourceMappingURL=bundleUtils.js.map

package/lib/packlets/bundle/bundleUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleUtils.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleUtils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AACtD,sCAAgD;AAGhD,uCAAsD;AAuBtD;;;;GAIG;AACH,MAAa,WAAW;IACtB;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,CAAC,IAAa;QACtC,OAAO,gBAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,uBAAuB,CAAC,UAAmB;QACvD,wCAAwC;QACxC,MAAM,YAAY,GAAG,gBAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;YAC7B,OAAO,IAAA,eAAI,EAAC,6BAA6B,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC;QAElC,oDAAoD;QACpD,MAAM,kBAAkB,GAAG,4BAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC;YACnC,OAAO,IAAA,eAAI,EAAC,2CAA2C,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,CAAC;QAErD,OAAO,IAAA,kBAAO,EAAC;YACb,mBAAmB;YACnB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,qBAAqB,CAAC,IAAa;QAC/C,OAAO,gBAAe;aACnB,OAAO,CAAC,IAAI,CAAC;aACb,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACpB,OAAO,IAAA,kBAAO,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;aACD,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE;YACvB,OAAO,sBAAsB,GAAG,EAAE,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,mBAAmB,CAAC,UAAkB;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACpC,OAAO,WAAW,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,eAAI,EAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,CACL,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC9D,CAAC;IACJ,CAAC;CACF;AA7FD,kCA6FC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { SystemConfiguration } from '../config';\nimport { Compiled as ResourceJsonCompiled } from '../resource-json';\nimport { IBundleMetadata } from './model';\nimport { bundle as bundleConverter } from './convert';\n\n/**\n * Components extracted from a bundle for reuse in different contexts.\n * @public\n */\nexport interface IBundleComponents {\n  /**\n   * The system configuration from the bundle.\n   */\n  systemConfiguration: SystemConfiguration;\n\n  /**\n   * The compiled resource collection from the bundle.\n   */\n  compiledCollection: ResourceJsonCompiled.ICompiledResourceCollection;\n\n  /**\n   * The bundle metadata including build information.\n   */\n  metadata: IBundleMetadata;\n}\n\n/**\n * Utility functions for working with resource bundles.\n * Provides reusable logic for bundle detection, parsing, and component extraction.\n * @public\n */\nexport class BundleUtils {\n  /**\n   * Checks if the given object appears to be a bundle file by examining its structure.\n   * This is a lightweight check that doesn't perform full validation.\n   * @param data - The data to check\n   * @returns True if the data appears to be a bundle structure\n   * @public\n   */\n  public static isBundleFile(data: unknown): boolean {\n    return bundleConverter.convert(data).isSuccess();\n  }\n\n  /**\n   * Extracts and validates components from a bundle for reuse.\n   * Performs full validation of the bundle structure and creates typed components.\n   * @param bundleData - The raw bundle data to extract components from\n   * @returns Success with bundle components if valid, Failure with error message otherwise\n   * @public\n   */\n  public static extractBundleComponents(bundleData: unknown): Result<IBundleComponents> {\n    // First validate and convert the bundle\n    const bundleResult = bundleConverter.convert(bundleData);\n    if (bundleResult.isFailure()) {\n      return fail(`Invalid bundle structure: ${bundleResult.message}`);\n    }\n\n    const bundle = bundleResult.value;\n\n    // Create SystemConfiguration from the bundle config\n    const systemConfigResult = SystemConfiguration.create(bundle.config);\n    if (systemConfigResult.isFailure()) {\n      return fail(`Invalid system configuration in bundle: ${systemConfigResult.message}`);\n    }\n\n    const systemConfiguration = systemConfigResult.value;\n\n    return succeed({\n      systemConfiguration,\n      compiledCollection: bundle.compiledCollection,\n      metadata: bundle.metadata\n    });\n  }\n\n  /**\n   * Extracts just the metadata from potential bundle data without full validation.\n   * Useful for displaying bundle information without processing the entire bundle.\n   * @param data - The data to extract metadata from\n   * @returns Success with metadata if found and valid, Failure otherwise\n   * @public\n   */\n  public static extractBundleMetadata(data: unknown): Result<IBundleMetadata> {\n    return bundleConverter\n      .convert(data)\n      .onSuccess((bundle) => {\n        return succeed(bundle.metadata);\n      })\n      .withErrorFormat((err) => {\n        return `Not a bundle file: ${err}`;\n      });\n  }\n\n  /**\n   * Parses bundle data from a JSON string.\n   * Convenience method that combines JSON parsing with bundle component extraction.\n   * @param jsonString - The JSON string containing bundle data\n   * @returns Success with bundle components if valid, Failure with error message otherwise\n   * @public\n   */\n  public static parseBundleFromJson(jsonString: string): Result<IBundleComponents> {\n    try {\n      const data = JSON.parse(jsonString);\n      return BundleUtils.extractBundleComponents(data);\n    } catch (error) {\n      return fail(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Checks if a file name suggests it might be a bundle file.\n   * This is a heuristic check based on file naming conventions.\n   * @param fileName - The file name to check\n   * @returns True if the file name suggests a bundle file\n   * @public\n   */\n  public static isBundleFileName(fileName: string): boolean {\n    const lowerName = fileName.toLowerCase();\n    return (\n      lowerName.endsWith('.bundle.json') ||\n      lowerName.endsWith('-bundle.json') ||\n      lowerName.endsWith('_bundle.json') ||\n      (lowerName.includes('bundle') && lowerName.endsWith('.json'))\n    );\n  }\n}\n"]}

package/lib/packlets/bundle/convert.d.ts

@@ -0,0 +1,33 @@
+import { Converter } from '@fgv/ts-utils';
+import { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';
+/**
+ * `Converter` for a {@link Bundle.IBundleMetadata | bundle metadata} object.
+ * @public
+ */
+export declare const bundleMetadata: Converter<IBundleMetadata>;
+/**
+ * `Converter` for {@link Bundle.IBundleExportMetadata | bundle export metadata}.
+ * @public
+ */
+export declare const bundleExportMetadata: Converter<IBundleExportMetadata>;
+/**
+ * `Converter` for a {@link Bundle.IBundle | bundle} object.
+ * @public
+ */
+export declare const bundle: Converter<IBundle>;
+/**
+ * `Converter` for {@link Bundle.IBundleCreateParams | bundle creation parameters}.
+ * @public
+ */
+export declare const bundleCreateParams: Converter<IBundleCreateParams>;
+/**
+ * Lightweight converter for bundle structure validation without full processing.
+ * Useful for detecting bundle files without the overhead of full validation.
+ * @public
+ */
+export declare const bundleStructure: Converter<{
+    metadata: IBundleMetadata;
+    config: unknown;
+    compiledCollection: unknown;
+}>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/packlets/bundle/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/packlets/bundle/convert.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AAItD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE/F;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,eAAe,CAKpD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,qBAAqB,CAM9D,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,CAAC,OAAO,CAKpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,mBAAmB,CAK1D,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC;IACtC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAIC,CAAC"}

package/lib/packlets/bundle/convert.js

@@ -0,0 +1,78 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleStructure = exports.bundleCreateParams = exports.bundle = exports.bundleExportMetadata = exports.bundleMetadata = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const config_1 = require("../config");
+const resource_json_1 = require("../resource-json");
+/**
+ * `Converter` for a {@link Bundle.IBundleMetadata | bundle metadata} object.
+ * @public
+ */
+exports.bundleMetadata = ts_utils_1.Converters.strictObject({
+    dateBuilt: ts_utils_1.Converters.string,
+    checksum: ts_utils_1.Converters.string,
+    version: ts_utils_1.Converters.string.optional(),
+    description: ts_utils_1.Converters.string.optional()
+});
+/**
+ * `Converter` for {@link Bundle.IBundleExportMetadata | bundle export metadata}.
+ * @public
+ */
+exports.bundleExportMetadata = ts_utils_1.Converters.strictObject({
+    exportedAt: ts_utils_1.Converters.string,
+    exportedFrom: ts_utils_1.Converters.string,
+    type: ts_utils_1.Converters.string,
+    filterContext: ts_json_base_1.Converters.jsonObject.optional()
+});
+/**
+ * `Converter` for a {@link Bundle.IBundle | bundle} object.
+ * @public
+ */
+exports.bundle = ts_utils_1.Converters.strictObject({
+    metadata: exports.bundleMetadata,
+    config: config_1.Convert.systemConfiguration,
+    compiledCollection: resource_json_1.Compiled.Convert.compiledResourceCollection,
+    exportMetadata: exports.bundleExportMetadata.optional()
+});
+/**
+ * `Converter` for {@link Bundle.IBundleCreateParams | bundle creation parameters}.
+ * @public
+ */
+exports.bundleCreateParams = ts_utils_1.Converters.strictObject({
+    version: ts_utils_1.Converters.string.optional(),
+    description: ts_utils_1.Converters.string.optional(),
+    dateBuilt: ts_utils_1.Converters.string.optional()
+});
+/**
+ * Lightweight converter for bundle structure validation without full processing.
+ * Useful for detecting bundle files without the overhead of full validation.
+ * @public
+ */
+exports.bundleStructure = ts_utils_1.Converters.strictObject({
+    metadata: exports.bundleMetadata,
+    config: ts_json_base_1.Converters.jsonValue,
+    compiledCollection: ts_json_base_1.Converters.jsonValue
+});
+//# sourceMappingURL=convert.js.map

package/lib/packlets/bundle/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/bundle/convert.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AACtD,oDAAiE;AACjE,sCAAqD;AACrD,oDAAoE;AAGpE;;;GAGG;AACU,QAAA,cAAc,GAA+B,qBAAU,CAAC,YAAY,CAAkB;IACjG,SAAS,EAAE,qBAAU,CAAC,MAAM;IAC5B,QAAQ,EAAE,qBAAU,CAAC,MAAM;IAC3B,OAAO,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,oBAAoB,GAC/B,qBAAU,CAAC,YAAY,CAAwB;IAC7C,UAAU,EAAE,qBAAU,CAAC,MAAM;IAC7B,YAAY,EAAE,qBAAU,CAAC,MAAM;IAC/B,IAAI,EAAE,qBAAU,CAAC,MAAM;IACvB,aAAa,EAAE,yBAAc,CAAC,UAAU,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,MAAM,GAAuB,qBAAU,CAAC,YAAY,CAAU;IACzE,QAAQ,EAAE,sBAAc;IACxB,MAAM,EAAE,gBAAa,CAAC,mBAAmB;IACzC,kBAAkB,EAAE,wBAAoB,CAAC,OAAO,CAAC,0BAA0B;IAC3E,cAAc,EAAE,4BAAoB,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,kBAAkB,GAC7B,qBAAU,CAAC,YAAY,CAAsB;IAC3C,OAAO,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEL;;;;GAIG;AACU,QAAA,eAAe,GAIvB,qBAAU,CAAC,YAAY,CAAC;IAC3B,QAAQ,EAAE,sBAAc;IACxB,MAAM,EAAE,yBAAc,CAAC,SAAS;IAChC,kBAAkB,EAAE,yBAAc,CAAC,SAAS;CAC7C,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converter, Converters } from '@fgv/ts-utils';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { Convert as ConfigConvert } from '../config';\nimport { Compiled as ResourceJsonCompiled } from '../resource-json';\nimport { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';\n\n/**\n * `Converter` for a {@link Bundle.IBundleMetadata | bundle metadata} object.\n * @public\n */\nexport const bundleMetadata: Converter<IBundleMetadata> = Converters.strictObject<IBundleMetadata>({\n  dateBuilt: Converters.string,\n  checksum: Converters.string,\n  version: Converters.string.optional(),\n  description: Converters.string.optional()\n});\n\n/**\n * `Converter` for {@link Bundle.IBundleExportMetadata | bundle export metadata}.\n * @public\n */\nexport const bundleExportMetadata: Converter<IBundleExportMetadata> =\n  Converters.strictObject<IBundleExportMetadata>({\n    exportedAt: Converters.string,\n    exportedFrom: Converters.string,\n    type: Converters.string,\n    filterContext: JsonConverters.jsonObject.optional()\n  });\n\n/**\n * `Converter` for a {@link Bundle.IBundle | bundle} object.\n * @public\n */\nexport const bundle: Converter<IBundle> = Converters.strictObject<IBundle>({\n  metadata: bundleMetadata,\n  config: ConfigConvert.systemConfiguration,\n  compiledCollection: ResourceJsonCompiled.Convert.compiledResourceCollection,\n  exportMetadata: bundleExportMetadata.optional()\n});\n\n/**\n * `Converter` for {@link Bundle.IBundleCreateParams | bundle creation parameters}.\n * @public\n */\nexport const bundleCreateParams: Converter<IBundleCreateParams> =\n  Converters.strictObject<IBundleCreateParams>({\n    version: Converters.string.optional(),\n    description: Converters.string.optional(),\n    dateBuilt: Converters.string.optional()\n  });\n\n/**\n * Lightweight converter for bundle structure validation without full processing.\n * Useful for detecting bundle files without the overhead of full validation.\n * @public\n */\nexport const bundleStructure: Converter<{\n  metadata: IBundleMetadata;\n  config: unknown;\n  compiledCollection: unknown;\n}> = Converters.strictObject({\n  metadata: bundleMetadata,\n  config: JsonConverters.jsonValue,\n  compiledCollection: JsonConverters.jsonValue\n});\n"]}

package/lib/packlets/bundle/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Bundle packlet providing functionality for creating and loading resource bundles.
+ *
+ * Resource bundles encapsulate compiled resources, configuration, and metadata with
+ * integrity verification. They provide a portable way to distribute pre-compiled
+ * resource collections.
+ *
+ * @packageDocumentation
+ */
+export type { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';
+export { BundleBuilder } from './bundleBuilder';
+export { BundleLoader } from './bundleLoader';
+export type { IBundleLoaderCreateParams } from './bundleLoader';
+export { BundleUtils } from './bundleUtils';
+export type { IBundleComponents } from './bundleUtils';
+export * as Convert from './convert';
+/** @internal */
+export { BundleNormalizer } from './bundleNormalizer';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/bundle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/bundle/index.ts"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AAGH,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGpG,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAGrC,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/packlets/bundle/index.js

@@ -0,0 +1,72 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundleNormalizer = exports.Convert = exports.BundleUtils = exports.BundleLoader = exports.BundleBuilder = void 0;
+// Builder and loader classes
+var bundleBuilder_1 = require("./bundleBuilder");
+Object.defineProperty(exports, "BundleBuilder", { enumerable: true, get: function () { return bundleBuilder_1.BundleBuilder; } });
+var bundleLoader_1 = require("./bundleLoader");
+Object.defineProperty(exports, "BundleLoader", { enumerable: true, get: function () { return bundleLoader_1.BundleLoader; } });
+// Utilities
+var bundleUtils_1 = require("./bundleUtils");
+Object.defineProperty(exports, "BundleUtils", { enumerable: true, get: function () { return bundleUtils_1.BundleUtils; } });
+// Converters
+exports.Convert = __importStar(require("./convert"));
+// Internal utilities (not part of public API)
+/** @internal */
+var bundleNormalizer_1 = require("./bundleNormalizer");
+Object.defineProperty(exports, "BundleNormalizer", { enumerable: true, get: function () { return bundleNormalizer_1.BundleNormalizer; } });
+//# sourceMappingURL=index.js.map

package/lib/packlets/bundle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/bundle/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeH,6BAA6B;AAC7B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAGrB,YAAY;AACZ,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAGpB,aAAa;AACb,qDAAqC;AAErC,8CAA8C;AAC9C,gBAAgB;AAChB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Bundle packlet providing functionality for creating and loading resource bundles.\n *\n * Resource bundles encapsulate compiled resources, configuration, and metadata with\n * integrity verification. They provide a portable way to distribute pre-compiled\n * resource collections.\n *\n * @packageDocumentation\n */\n\n// Model interfaces\nexport type { IBundleMetadata, IBundleExportMetadata, IBundle, IBundleCreateParams } from './model';\n\n// Builder and loader classes\nexport { BundleBuilder } from './bundleBuilder';\nexport { BundleLoader } from './bundleLoader';\nexport type { IBundleLoaderCreateParams } from './bundleLoader';\n\n// Utilities\nexport { BundleUtils } from './bundleUtils';\nexport type { IBundleComponents } from './bundleUtils';\n\n// Converters\nexport * as Convert from './convert';\n\n// Internal utilities (not part of public API)\n/** @internal */\nexport { BundleNormalizer } from './bundleNormalizer';\n"]}