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

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+import * as Bundle from './packlets/bundle';
 import * as QualifierTypes from './packlets/qualifier-types';
 import * as Qualifiers from './packlets/qualifiers';
 import * as Conditions from './packlets/conditions';
@@ -17,5 +18,6 @@ import { Qualifier } from './packlets/qualifiers';
 import { ResourceType } from './packlets/resource-types';
 import { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';
 import { IResourceManager, ResourceResolver } from './packlets/runtime';
-export { Condition, Conditions, ConditionSet, Config, Context, Decision, Decisions, Import, IResourceManager, Qualifier, QualifierType, QualifierTypes, Qualifiers, Resource, ResourceCandidate, ResourceJson, ResourceResolver, ResourceManagerBuilder, ResourceType, ResourceTypes, Resources, Runtime };
+import { BundleBuilder, BundleLoader } from './packlets/bundle';
+export { Bundle, BundleBuilder, BundleLoader, Condition, Conditions, ConditionSet, Config, Context, Decision, Decisions, Import, IResourceManager, Qualifier, QualifierType, QualifierTypes, Qualifiers, Resource, ResourceCandidate, ResourceJson, ResourceResolver, ResourceManagerBuilder, ResourceType, ResourceTypes, Resources, Runtime };
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACR,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EACL,MAAM,EACN,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,EACN,OAAO,EACP,QAAQ,EACR,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACR,CAAC"}

package/lib/index.js

@@ -57,7 +57,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Runtime = exports.Resources = exports.ResourceTypes = exports.ResourceType = exports.ResourceManagerBuilder = exports.ResourceResolver = exports.ResourceJson = exports.ResourceCandidate = exports.Resource = exports.Qualifiers = exports.QualifierTypes = exports.QualifierType = exports.Qualifier = exports.Import = exports.Decisions = exports.Decision = exports.Context = exports.Config = exports.ConditionSet = exports.Conditions = exports.Condition = void 0;
+exports.Runtime = exports.Resources = exports.ResourceTypes = exports.ResourceType = exports.ResourceManagerBuilder = exports.ResourceResolver = exports.ResourceJson = exports.ResourceCandidate = exports.Resource = exports.Qualifiers = exports.QualifierTypes = exports.QualifierType = exports.Qualifier = exports.Import = exports.Decisions = exports.Decision = exports.Context = exports.Config = exports.ConditionSet = exports.Conditions = exports.Condition = exports.BundleLoader = exports.BundleBuilder = exports.Bundle = void 0;
+const Bundle = __importStar(require("./packlets/bundle"));
+exports.Bundle = Bundle;
 const QualifierTypes = __importStar(require("./packlets/qualifier-types"));
 exports.QualifierTypes = QualifierTypes;
 const Qualifiers = __importStar(require("./packlets/qualifiers"));
@@ -98,4 +100,7 @@ Object.defineProperty(exports, "ResourceCandidate", { enumerable: true, get: fun
 Object.defineProperty(exports, "ResourceManagerBuilder", { enumerable: true, get: function () { return resources_1.ResourceManagerBuilder; } });
 const runtime_1 = require("./packlets/runtime");
 Object.defineProperty(exports, "ResourceResolver", { enumerable: true, get: function () { return runtime_1.ResourceResolver; } });
+const bundle_1 = require("./packlets/bundle");
+Object.defineProperty(exports, "BundleBuilder", { enumerable: true, get: function () { return bundle_1.BundleBuilder; } });
+Object.defineProperty(exports, "BundleLoader", { enumerable: true, get: function () { return bundle_1.BundleLoader; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,2EAA6D;AAkC3D,wCAAc;AAjChB,kEAAoD;AAkClD,gCAAU;AAjCZ,kEAAoD;AAsBlD,gCAAU;AArBZ,0DAA4C;AAuB1C,wBAAM;AAtBR,4DAA8C;AAuB5C,0BAAO;AAtBT,gEAAkD;AAwBhD,8BAAS;AAvBX,uEAAyD;AAgCvD,oCAAY;AA/Bd,gEAAkD;AAoChD,8BAAS;AAnCX,yEAA2D;AAkCzD,sCAAa;AAjCf,0DAA4C;AAqB1C,wBAAM;AApBR,4DAA8C;AAkC5C,0BAAO;AAhCT,oDAAkC;AAElC,sDAAgE;AAS9D,0FATO,sBAAS,OASP;AAET,6FAXkB,yBAAY,OAWlB;AAVd,oDAAgD;AAa9C,yFAbO,oBAAQ,OAaP;AAZV,gEAA2D;AAiBzD,8FAjBO,+BAAa,OAiBP;AAhBf,sDAAkD;AAehD,0FAfO,sBAAS,OAeP;AAdX,8DAAyD;AAuBvD,6FAvBO,6BAAY,OAuBP;AAtBd,oDAA2F;AAiBzF,yFAjBO,oBAAQ,OAiBP;AACR,kGAlBiB,6BAAiB,OAkBjB;AAGjB,uGArBoC,kCAAsB,OAqBpC;AApBxB,gDAAwE;AAmBtE,iGAnByB,0BAAgB,OAmBzB","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 * as QualifierTypes from './packlets/qualifier-types';\nimport * as Qualifiers from './packlets/qualifiers';\nimport * as Conditions from './packlets/conditions';\nimport * as Config from './packlets/config';\nimport * as Context from './packlets/context';\nimport * as Decisions from './packlets/decisions';\nimport * as ResourceJson from './packlets/resource-json';\nimport * as Resources from './packlets/resources';\nimport * as ResourceTypes from './packlets/resource-types';\nimport * as Import from './packlets/import';\nimport * as Runtime from './packlets/runtime';\n\nexport * from './packlets/common';\n\nimport { Condition, ConditionSet } from './packlets/conditions';\nimport { Decision } from './packlets/decisions';\nimport { QualifierType } from './packlets/qualifier-types';\nimport { Qualifier } from './packlets/qualifiers';\nimport { ResourceType } from './packlets/resource-types';\nimport { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';\nimport { IResourceManager, ResourceResolver } from './packlets/runtime';\n\nexport {\n  Condition,\n  Conditions,\n  ConditionSet,\n  Config,\n  Context,\n  Decision,\n  Decisions,\n  Import,\n  IResourceManager,\n  Qualifier,\n  QualifierType,\n  QualifierTypes,\n  Qualifiers,\n  Resource,\n  ResourceCandidate,\n  ResourceJson,\n  ResourceResolver,\n  ResourceManagerBuilder,\n  ResourceType,\n  ResourceTypes,\n  Resources,\n  Runtime\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,0DAA4C;AAyB1C,wBAAM;AAxBR,2EAA6D;AAsC3D,wCAAc;AArChB,kEAAoD;AAsClD,gCAAU;AArCZ,kEAAoD;AA0BlD,gCAAU;AAzBZ,0DAA4C;AA2B1C,wBAAM;AA1BR,4DAA8C;AA2B5C,0BAAO;AA1BT,gEAAkD;AA4BhD,8BAAS;AA3BX,uEAAyD;AAoCvD,oCAAY;AAnCd,gEAAkD;AAwChD,8BAAS;AAvCX,yEAA2D;AAsCzD,sCAAa;AArCf,0DAA4C;AAyB1C,wBAAM;AAxBR,4DAA8C;AAsC5C,0BAAO;AApCT,oDAAkC;AAElC,sDAAgE;AAa9D,0FAbO,sBAAS,OAaP;AAET,6FAfkB,yBAAY,OAelB;AAdd,oDAAgD;AAiB9C,yFAjBO,oBAAQ,OAiBP;AAhBV,gEAA2D;AAqBzD,8FArBO,+BAAa,OAqBP;AApBf,sDAAkD;AAmBhD,0FAnBO,sBAAS,OAmBP;AAlBX,8DAAyD;AA2BvD,6FA3BO,6BAAY,OA2BP;AA1Bd,oDAA2F;AAqBzF,yFArBO,oBAAQ,OAqBP;AACR,kGAtBiB,6BAAiB,OAsBjB;AAGjB,uGAzBoC,kCAAsB,OAyBpC;AAxBxB,gDAAwE;AAuBtE,iGAvByB,0BAAgB,OAuBzB;AAtBlB,8CAAgE;AAI9D,8FAJO,sBAAa,OAIP;AACb,6FALsB,qBAAY,OAKtB","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 * as Bundle from './packlets/bundle';\nimport * as QualifierTypes from './packlets/qualifier-types';\nimport * as Qualifiers from './packlets/qualifiers';\nimport * as Conditions from './packlets/conditions';\nimport * as Config from './packlets/config';\nimport * as Context from './packlets/context';\nimport * as Decisions from './packlets/decisions';\nimport * as ResourceJson from './packlets/resource-json';\nimport * as Resources from './packlets/resources';\nimport * as ResourceTypes from './packlets/resource-types';\nimport * as Import from './packlets/import';\nimport * as Runtime from './packlets/runtime';\n\nexport * from './packlets/common';\n\nimport { Condition, ConditionSet } from './packlets/conditions';\nimport { Decision } from './packlets/decisions';\nimport { QualifierType } from './packlets/qualifier-types';\nimport { Qualifier } from './packlets/qualifiers';\nimport { ResourceType } from './packlets/resource-types';\nimport { Resource, ResourceCandidate, ResourceManagerBuilder } from './packlets/resources';\nimport { IResourceManager, ResourceResolver } from './packlets/runtime';\nimport { BundleBuilder, BundleLoader } from './packlets/bundle';\n\nexport {\n  Bundle,\n  BundleBuilder,\n  BundleLoader,\n  Condition,\n  Conditions,\n  ConditionSet,\n  Config,\n  Context,\n  Decision,\n  Decisions,\n  Import,\n  IResourceManager,\n  Qualifier,\n  QualifierType,\n  QualifierTypes,\n  Qualifiers,\n  Resource,\n  ResourceCandidate,\n  ResourceJson,\n  ResourceResolver,\n  ResourceManagerBuilder,\n  ResourceType,\n  ResourceTypes,\n  Resources,\n  Runtime\n};\n"]}

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

@@ -0,0 +1,41 @@
+import { Result } from '@fgv/ts-utils';
+import { ResourceManagerBuilder } from '../resources';
+import { SystemConfiguration, PredefinedSystemConfiguration } from '../config';
+import { IBundle, IBundleCreateParams } from './model';
+/**
+ * Builder for creating resource bundles from a ResourceManagerBuilder.
+ * Handles the compilation, configuration extraction, and integrity verification
+ * needed to create a complete, portable bundle.
+ * @public
+ */
+export declare class BundleBuilder {
+    /**
+     * Creates a resource bundle from a ResourceManagerBuilder.
+     * @param builder - The ResourceManagerBuilder containing the resources to bundle
+     * @param systemConfig - The SystemConfiguration used to create the builder
+     * @param params - Optional parameters for bundle creation
+     * @returns Success with the created bundle if successful, Failure with error message otherwise
+     * @public
+     */
+    static create(builder: ResourceManagerBuilder, systemConfig: SystemConfiguration, params?: IBundleCreateParams): Result<IBundle>;
+    /**
+     * Creates a resource bundle from a ResourceManagerBuilder using a predefined system configuration.
+     * This is a convenience method for the common case of using predefined configurations.
+     * @param builder - The ResourceManagerBuilder containing the resources to bundle
+     * @param configName - The name of the predefined system configuration used
+     * @param params - Optional parameters for bundle creation
+     * @returns Success with the created bundle if successful, Failure with error message otherwise
+     * @public
+     */
+    static createFromPredefined(builder: ResourceManagerBuilder, configName: PredefinedSystemConfiguration, params?: IBundleCreateParams): Result<IBundle>;
+    /**
+     * Generates a hash checksum for the compiled resource collection.
+     * The checksum is calculated using the provided hash normalizer.
+     * @param compiledCollection - The compiled resource collection to generate checksum for
+     * @param hashNormalizer - The hash normalizer to use for checksum generation
+     * @returns Success with the checksum string if successful, Failure otherwise
+     * @internal
+     */
+    private static _generateChecksum;
+}
+//# sourceMappingURL=bundleBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundleBuilder.d.ts","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleBuilder.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAE9B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAmB,MAAM,SAAS,CAAC;AAGxE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB;;;;;;;OAOG;WACW,MAAM,CAClB,OAAO,EAAE,sBAAsB,EAC/B,YAAY,EAAE,mBAAmB,EACjC,MAAM,CAAC,EAAE,mBAAmB,GAC3B,MAAM,CAAC,OAAO,CAAC;IAoClB;;;;;;;;OAQG;WACW,oBAAoB,CAChC,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE,6BAA6B,EACzC,MAAM,CAAC,EAAE,mBAAmB,GAC3B,MAAM,CAAC,OAAO,CAAC;IAwClB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAMjC"}

package/lib/packlets/bundle/bundleBuilder.js

@@ -0,0 +1,131 @@
+"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.BundleBuilder = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const config_1 = require("../config");
+const bundleNormalizer_1 = require("./bundleNormalizer");
+/**
+ * Builder for creating resource bundles from a ResourceManagerBuilder.
+ * Handles the compilation, configuration extraction, and integrity verification
+ * needed to create a complete, portable bundle.
+ * @public
+ */
+class BundleBuilder {
+    /**
+     * Creates a resource bundle from a ResourceManagerBuilder.
+     * @param builder - The ResourceManagerBuilder containing the resources to bundle
+     * @param systemConfig - The SystemConfiguration used to create the builder
+     * @param params - Optional parameters for bundle creation
+     * @returns Success with the created bundle if successful, Failure with error message otherwise
+     * @public
+     */
+    static create(builder, systemConfig, params) {
+        var _a;
+        /* c8 ignore next 1 */
+        params = params !== null && params !== void 0 ? params : {};
+        const hashNormalizer = (_a = params.hashNormalizer) !== null && _a !== void 0 ? _a : new ts_utils_1.Hash.Crc32Normalizer();
+        // Determine which builder to use based on normalization setting
+        const builderToUse = params.normalize
+            ? bundleNormalizer_1.BundleNormalizer.normalize(builder, systemConfig)
+            : (0, ts_utils_1.succeed)(builder);
+        return builderToUse.onSuccess((targetBuilder) => {
+            return systemConfig.getConfig().onSuccess((config) => {
+                return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {
+                    return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess((checksum) => {
+                        var _a;
+                        const dateBuilt = (_a = params.dateBuilt) !== null && _a !== void 0 ? _a : new Date().toISOString();
+                        const metadata = {
+                            dateBuilt,
+                            checksum,
+                            version: params.version,
+                            description: params.description
+                        };
+                        const bundle = {
+                            metadata,
+                            config,
+                            compiledCollection
+                        };
+                        return (0, ts_utils_1.succeed)(bundle);
+                    });
+                });
+            });
+        });
+    }
+    /**
+     * Creates a resource bundle from a ResourceManagerBuilder using a predefined system configuration.
+     * This is a convenience method for the common case of using predefined configurations.
+     * @param builder - The ResourceManagerBuilder containing the resources to bundle
+     * @param configName - The name of the predefined system configuration used
+     * @param params - Optional parameters for bundle creation
+     * @returns Success with the created bundle if successful, Failure with error message otherwise
+     * @public
+     */
+    static createFromPredefined(builder, configName, params) {
+        var _a;
+        /* c8 ignore next 1 */
+        params = params !== null && params !== void 0 ? params : {};
+        const hashNormalizer = (_a = params.hashNormalizer) !== null && _a !== void 0 ? _a : new ts_utils_1.Hash.Crc32Normalizer();
+        // Determine which builder to use based on normalization setting
+        const builderToUse = params.normalize
+            ? bundleNormalizer_1.BundleNormalizer.normalizeFromPredefined(builder, configName)
+            : (0, ts_utils_1.succeed)(builder);
+        return builderToUse.onSuccess((targetBuilder) => {
+            return (0, config_1.getPredefinedSystemConfiguration)(configName).onSuccess((systemConfig) => {
+                return systemConfig.getConfig().onSuccess((config) => {
+                    return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {
+                        return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess((checksum) => {
+                            var _a;
+                            const dateBuilt = (_a = params.dateBuilt) !== null && _a !== void 0 ? _a : new Date().toISOString();
+                            const metadata = {
+                                dateBuilt,
+                                checksum,
+                                version: params.version,
+                                description: params === null || params === void 0 ? void 0 : params.description
+                            };
+                            const bundle = {
+                                metadata,
+                                config,
+                                compiledCollection
+                            };
+                            return (0, ts_utils_1.succeed)(bundle);
+                        });
+                    });
+                });
+            });
+        });
+    }
+    /**
+     * Generates a hash checksum for the compiled resource collection.
+     * The checksum is calculated using the provided hash normalizer.
+     * @param compiledCollection - The compiled resource collection to generate checksum for
+     * @param hashNormalizer - The hash normalizer to use for checksum generation
+     * @returns Success with the checksum string if successful, Failure otherwise
+     * @internal
+     */
+    static _generateChecksum(compiledCollection, hashNormalizer) {
+        return hashNormalizer.computeHash(compiledCollection);
+    }
+}
+exports.BundleBuilder = BundleBuilder;
+//# sourceMappingURL=bundleBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundleBuilder.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleBuilder.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, Hash } from '@fgv/ts-utils';\nimport { ResourceManagerBuilder } from '../resources';\nimport {\n  SystemConfiguration,\n  PredefinedSystemConfiguration,\n  getPredefinedSystemConfiguration\n} from '../config';\nimport { IBundle, IBundleCreateParams, IBundleMetadata } from './model';\nimport { BundleNormalizer } from './bundleNormalizer';\n\n/**\n * Builder for creating resource bundles from a ResourceManagerBuilder.\n * Handles the compilation, configuration extraction, and integrity verification\n * needed to create a complete, portable bundle.\n * @public\n */\nexport class BundleBuilder {\n  /**\n   * Creates a resource bundle from a ResourceManagerBuilder.\n   * @param builder - The ResourceManagerBuilder containing the resources to bundle\n   * @param systemConfig - The SystemConfiguration used to create the builder\n   * @param params - Optional parameters for bundle creation\n   * @returns Success with the created bundle if successful, Failure with error message otherwise\n   * @public\n   */\n  public static create(\n    builder: ResourceManagerBuilder,\n    systemConfig: SystemConfiguration,\n    params?: IBundleCreateParams\n  ): Result<IBundle> {\n    /* c8 ignore next 1 */\n    params = params ?? {};\n    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();\n\n    // Determine which builder to use based on normalization setting\n    const builderToUse = params.normalize\n      ? BundleNormalizer.normalize(builder, systemConfig)\n      : succeed(builder);\n\n    return builderToUse.onSuccess((targetBuilder) => {\n      return systemConfig.getConfig().onSuccess((config) => {\n        return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {\n          return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess((checksum) => {\n            const dateBuilt = params.dateBuilt ?? new Date().toISOString();\n\n            const metadata: IBundleMetadata = {\n              dateBuilt,\n              checksum,\n              version: params.version,\n              description: params.description\n            };\n\n            const bundle: IBundle = {\n              metadata,\n              config,\n              compiledCollection\n            };\n\n            return succeed(bundle);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Creates a resource bundle from a ResourceManagerBuilder using a predefined system configuration.\n   * This is a convenience method for the common case of using predefined configurations.\n   * @param builder - The ResourceManagerBuilder containing the resources to bundle\n   * @param configName - The name of the predefined system configuration used\n   * @param params - Optional parameters for bundle creation\n   * @returns Success with the created bundle if successful, Failure with error message otherwise\n   * @public\n   */\n  public static createFromPredefined(\n    builder: ResourceManagerBuilder,\n    configName: PredefinedSystemConfiguration,\n    params?: IBundleCreateParams\n  ): Result<IBundle> {\n    /* c8 ignore next 1 */\n    params = params ?? {};\n    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();\n\n    // Determine which builder to use based on normalization setting\n    const builderToUse = params.normalize\n      ? BundleNormalizer.normalizeFromPredefined(builder, configName)\n      : succeed(builder);\n\n    return builderToUse.onSuccess((targetBuilder) => {\n      return getPredefinedSystemConfiguration(configName).onSuccess((systemConfig) => {\n        return systemConfig.getConfig().onSuccess((config) => {\n          return targetBuilder.getCompiledResourceCollection().onSuccess((compiledCollection) => {\n            return BundleBuilder._generateChecksum(compiledCollection, hashNormalizer).onSuccess(\n              (checksum) => {\n                const dateBuilt = params.dateBuilt ?? new Date().toISOString();\n\n                const metadata: IBundleMetadata = {\n                  dateBuilt,\n                  checksum,\n                  version: params.version,\n                  description: params?.description\n                };\n\n                const bundle: IBundle = {\n                  metadata,\n                  config,\n                  compiledCollection\n                };\n\n                return succeed(bundle);\n              }\n            );\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Generates a hash checksum for the compiled resource collection.\n   * The checksum is calculated using the provided hash normalizer.\n   * @param compiledCollection - The compiled resource collection to generate checksum for\n   * @param hashNormalizer - The hash normalizer to use for checksum generation\n   * @returns Success with the checksum string if successful, Failure otherwise\n   * @internal\n   */\n  private static _generateChecksum(\n    compiledCollection: unknown,\n    hashNormalizer: Hash.HashingNormalizer\n  ): Result<string> {\n    return hashNormalizer.computeHash(compiledCollection);\n  }\n}\n"]}

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

@@ -0,0 +1,72 @@
+import { Result, Hash } from '@fgv/ts-utils';
+import { IResourceManager } from '../runtime';
+import { IBundle } from './model';
+/**
+ * Parameters for creating a BundleLoader.
+ * @public
+ */
+export interface IBundleLoaderCreateParams {
+    /**
+     * The bundle to load.
+     */
+    bundle: IBundle;
+    /**
+     * Whether to skip checksum verification during loading.
+     * Default is false - checksum verification is performed.
+     */
+    skipChecksumVerification?: boolean;
+    /**
+     * Optional hash normalizer for verifying checksums. If not provided,
+     * a CRC32 normalizer will be used for browser compatibility.
+     * Must match the normalizer used during bundle creation.
+     */
+    hashNormalizer?: Hash.HashingNormalizer;
+}
+/**
+ * Loader for creating an IResourceManager from a resource bundle.
+ * Handles integrity verification and reconstruction of the runtime resource manager.
+ * @public
+ */
+export declare class BundleLoader {
+    /**
+     * Creates an IResourceManager from a resource bundle.
+     * @param params - Parameters for bundle loading including the bundle and options
+     * @returns Success with the IResourceManager if successful, Failure with error message otherwise
+     * @public
+     */
+    static createManagerFromBundle(params: IBundleLoaderCreateParams): Result<IResourceManager>;
+    /**
+     * Verifies the integrity of a bundle by checking its checksum.
+     * @param bundle - The bundle to verify
+     * @param skipVerification - Whether to skip verification
+     * @param hashNormalizer - The hash normalizer to use for verification
+     * @returns Success if verification passes or is skipped, Failure otherwise
+     * @internal
+     */
+    private static _verifyBundleIntegrity;
+    /**
+     * Generates a hash checksum for the compiled resource collection.
+     * @param compiledCollection - The compiled resource collection to generate checksum for
+     * @param hashNormalizer - The hash normalizer to use for checksum generation
+     * @returns Success with the checksum string if successful, Failure otherwise
+     * @internal
+     */
+    private static _generateChecksum;
+    /**
+     * Creates a SystemConfiguration from the bundle's configuration.
+     * @param bundle - The bundle containing the configuration
+     * @returns Success with the SystemConfiguration if successful, Failure otherwise
+     * @internal
+     */
+    private static _createSystemConfiguration;
+    /**
+     * Creates a CompiledResourceCollection from the bundle.
+     * @param bundle - The bundle to load
+     * @param qualifierTypes - The qualifier type collector from the system configuration
+     * @param resourceTypes - The resource type collector from the system configuration
+     * @returns Success with the CompiledResourceCollection if successful, Failure otherwise
+     * @internal
+     */
+    private static _createCompiledResourceCollection;
+}
+//# sourceMappingURL=bundleLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundleLoader.d.ts","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleLoader.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAA8B,IAAI,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAA8B,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI1E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC;CACzC;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;WACW,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAkBlG;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAqBrC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAOhC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAIzC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,iCAAiC;CAWjD"}

package/lib/packlets/bundle/bundleLoader.js

@@ -0,0 +1,104 @@
+"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.BundleLoader = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const runtime_1 = require("../runtime");
+const config_1 = require("../config");
+/**
+ * Loader for creating an IResourceManager from a resource bundle.
+ * Handles integrity verification and reconstruction of the runtime resource manager.
+ * @public
+ */
+class BundleLoader {
+    /**
+     * Creates an IResourceManager from a resource bundle.
+     * @param params - Parameters for bundle loading including the bundle and options
+     * @returns Success with the IResourceManager if successful, Failure with error message otherwise
+     * @public
+     */
+    static createManagerFromBundle(params) {
+        var _a, _b;
+        const hashNormalizer = (_a = params.hashNormalizer) !== null && _a !== void 0 ? _a : new ts_utils_1.Hash.Crc32Normalizer();
+        return BundleLoader._verifyBundleIntegrity(params.bundle, (_b = params.skipChecksumVerification) !== null && _b !== void 0 ? _b : false, hashNormalizer).onSuccess(() => {
+            return BundleLoader._createSystemConfiguration(params.bundle).onSuccess((systemConfig) => {
+                return BundleLoader._createCompiledResourceCollection(params.bundle, systemConfig.qualifierTypes, systemConfig.resourceTypes);
+            });
+        });
+    }
+    /**
+     * Verifies the integrity of a bundle by checking its checksum.
+     * @param bundle - The bundle to verify
+     * @param skipVerification - Whether to skip verification
+     * @param hashNormalizer - The hash normalizer to use for verification
+     * @returns Success if verification passes or is skipped, Failure otherwise
+     * @internal
+     */
+    static _verifyBundleIntegrity(bundle, skipVerification, hashNormalizer) {
+        if (skipVerification) {
+            return (0, ts_utils_1.succeed)(true);
+        }
+        return BundleLoader._generateChecksum(bundle.compiledCollection, hashNormalizer).onSuccess((calculatedChecksum) => {
+            if (calculatedChecksum !== bundle.metadata.checksum) {
+                return (0, ts_utils_1.fail)(`Bundle integrity verification failed: expected checksum ${bundle.metadata.checksum}, got ${calculatedChecksum}`);
+            }
+            return (0, ts_utils_1.succeed)(true);
+        });
+    }
+    /**
+     * Generates a hash checksum for the compiled resource collection.
+     * @param compiledCollection - The compiled resource collection to generate checksum for
+     * @param hashNormalizer - The hash normalizer to use for checksum generation
+     * @returns Success with the checksum string if successful, Failure otherwise
+     * @internal
+     */
+    static _generateChecksum(compiledCollection, hashNormalizer) {
+        return hashNormalizer.computeHash(compiledCollection);
+    }
+    /**
+     * Creates a SystemConfiguration from the bundle's configuration.
+     * @param bundle - The bundle containing the configuration
+     * @returns Success with the SystemConfiguration if successful, Failure otherwise
+     * @internal
+     */
+    static _createSystemConfiguration(bundle) {
+        return config_1.SystemConfiguration.create(bundle.config);
+    }
+    /**
+     * Creates a CompiledResourceCollection from the bundle.
+     * @param bundle - The bundle to load
+     * @param qualifierTypes - The qualifier type collector from the system configuration
+     * @param resourceTypes - The resource type collector from the system configuration
+     * @returns Success with the CompiledResourceCollection if successful, Failure otherwise
+     * @internal
+     */
+    static _createCompiledResourceCollection(bundle, qualifierTypes, resourceTypes) {
+        return runtime_1.CompiledResourceCollection.create({
+            compiledCollection: bundle.compiledCollection,
+            qualifierTypes,
+            resourceTypes
+        });
+    }
+}
+exports.BundleLoader = BundleLoader;
+//# sourceMappingURL=bundleLoader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundleLoader.js","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleLoader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAyE;AACzE,wCAA0E;AAC1E,sCAAgD;AA6BhD;;;;GAIG;AACH,MAAa,YAAY;IACvB;;;;;OAKG;IACI,MAAM,CAAC,uBAAuB,CAAC,MAAiC;;QACrE,MAAM,cAAc,GAAG,MAAA,MAAM,CAAC,cAAc,mCAAI,IAAI,eAAI,CAAC,eAAe,EAAE,CAAC;QAE3E,OAAO,YAAY,CAAC,sBAAsB,CACxC,MAAM,CAAC,MAAM,EACb,MAAA,MAAM,CAAC,wBAAwB,mCAAI,KAAK,EACxC,cAAc,CACf,CAAC,SAAS,CAAC,GAAG,EAAE;YACf,OAAO,YAAY,CAAC,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,YAAY,EAAE,EAAE;gBACvF,OAAO,YAAY,CAAC,iCAAiC,CACnD,MAAM,CAAC,MAAM,EACb,YAAY,CAAC,cAAc,EAC3B,YAAY,CAAC,aAAa,CAC3B,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,sBAAsB,CACnC,MAAe,EACf,gBAAyB,EACzB,cAAsC;QAEtC,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,YAAY,CAAC,iBAAiB,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC,SAAS,CACxF,CAAC,kBAAkB,EAAE,EAAE;YACrB,IAAI,kBAAkB,KAAK,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACpD,OAAO,IAAA,eAAI,EACT,2DAA2D,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAS,kBAAkB,EAAE,CACjH,CAAC;YACJ,CAAC;YACD,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,iBAAiB,CAC9B,kBAA2B,EAC3B,cAAsC;QAEtC,OAAO,cAAc,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,0BAA0B,CAAC,MAAe;QACvD,OAAO,4BAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,iCAAiC,CAC9C,MAAe,EACf,cAAqE,EACrE,aAAmE;QAEnE,OAAO,oCAA0B,CAAC,MAAM,CAAC;YACvC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,cAAc;YACd,aAAa;SACd,CAAC,CAAC;IACL,CAAC;CACF;AAjGD,oCAiGC","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, Collections, Hash } from '@fgv/ts-utils';\nimport { CompiledResourceCollection, IResourceManager } from '../runtime';\nimport { SystemConfiguration } from '../config';\nimport { ResourceType } from '../resource-types';\nimport { QualifierType } from '../qualifier-types';\nimport { IBundle } from './model';\n\n/**\n * Parameters for creating a BundleLoader.\n * @public\n */\nexport interface IBundleLoaderCreateParams {\n  /**\n   * The bundle to load.\n   */\n  bundle: IBundle;\n\n  /**\n   * Whether to skip checksum verification during loading.\n   * Default is false - checksum verification is performed.\n   */\n  skipChecksumVerification?: boolean;\n\n  /**\n   * Optional hash normalizer for verifying checksums. If not provided,\n   * a CRC32 normalizer will be used for browser compatibility.\n   * Must match the normalizer used during bundle creation.\n   */\n  hashNormalizer?: Hash.HashingNormalizer;\n}\n\n/**\n * Loader for creating an IResourceManager from a resource bundle.\n * Handles integrity verification and reconstruction of the runtime resource manager.\n * @public\n */\nexport class BundleLoader {\n  /**\n   * Creates an IResourceManager from a resource bundle.\n   * @param params - Parameters for bundle loading including the bundle and options\n   * @returns Success with the IResourceManager if successful, Failure with error message otherwise\n   * @public\n   */\n  public static createManagerFromBundle(params: IBundleLoaderCreateParams): Result<IResourceManager> {\n    const hashNormalizer = params.hashNormalizer ?? new Hash.Crc32Normalizer();\n\n    return BundleLoader._verifyBundleIntegrity(\n      params.bundle,\n      params.skipChecksumVerification ?? false,\n      hashNormalizer\n    ).onSuccess(() => {\n      return BundleLoader._createSystemConfiguration(params.bundle).onSuccess((systemConfig) => {\n        return BundleLoader._createCompiledResourceCollection(\n          params.bundle,\n          systemConfig.qualifierTypes,\n          systemConfig.resourceTypes\n        );\n      });\n    });\n  }\n\n  /**\n   * Verifies the integrity of a bundle by checking its checksum.\n   * @param bundle - The bundle to verify\n   * @param skipVerification - Whether to skip verification\n   * @param hashNormalizer - The hash normalizer to use for verification\n   * @returns Success if verification passes or is skipped, Failure otherwise\n   * @internal\n   */\n  private static _verifyBundleIntegrity(\n    bundle: IBundle,\n    skipVerification: boolean,\n    hashNormalizer: Hash.HashingNormalizer\n  ): Result<boolean> {\n    if (skipVerification) {\n      return succeed(true);\n    }\n\n    return BundleLoader._generateChecksum(bundle.compiledCollection, hashNormalizer).onSuccess(\n      (calculatedChecksum) => {\n        if (calculatedChecksum !== bundle.metadata.checksum) {\n          return fail(\n            `Bundle integrity verification failed: expected checksum ${bundle.metadata.checksum}, got ${calculatedChecksum}`\n          );\n        }\n        return succeed(true);\n      }\n    );\n  }\n\n  /**\n   * Generates a hash checksum for the compiled resource collection.\n   * @param compiledCollection - The compiled resource collection to generate checksum for\n   * @param hashNormalizer - The hash normalizer to use for checksum generation\n   * @returns Success with the checksum string if successful, Failure otherwise\n   * @internal\n   */\n  private static _generateChecksum(\n    compiledCollection: unknown,\n    hashNormalizer: Hash.HashingNormalizer\n  ): Result<string> {\n    return hashNormalizer.computeHash(compiledCollection);\n  }\n\n  /**\n   * Creates a SystemConfiguration from the bundle's configuration.\n   * @param bundle - The bundle containing the configuration\n   * @returns Success with the SystemConfiguration if successful, Failure otherwise\n   * @internal\n   */\n  private static _createSystemConfiguration(bundle: IBundle): Result<SystemConfiguration> {\n    return SystemConfiguration.create(bundle.config);\n  }\n\n  /**\n   * Creates a CompiledResourceCollection from the bundle.\n   * @param bundle - The bundle to load\n   * @param qualifierTypes - The qualifier type collector from the system configuration\n   * @param resourceTypes - The resource type collector from the system configuration\n   * @returns Success with the CompiledResourceCollection if successful, Failure otherwise\n   * @internal\n   */\n  private static _createCompiledResourceCollection(\n    bundle: IBundle,\n    qualifierTypes: Collections.IReadOnlyResultMap<string, QualifierType>,\n    resourceTypes: Collections.IReadOnlyResultMap<string, ResourceType>\n  ): Result<CompiledResourceCollection> {\n    return CompiledResourceCollection.create({\n      compiledCollection: bundle.compiledCollection,\n      qualifierTypes,\n      resourceTypes\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,73 @@
+import { Result } from '@fgv/ts-utils';
+import { ResourceManagerBuilder } from '../resources';
+import { SystemConfiguration, PredefinedSystemConfiguration } from '../config';
+/**
+ * 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
+ */
+export declare 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: ResourceManagerBuilder, systemConfig: SystemConfiguration): Result<ResourceManagerBuilder>;
+    /**
+     * 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: ResourceManagerBuilder, configName: PredefinedSystemConfiguration): Result<ResourceManagerBuilder>;
+    /**
+     * 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
+     */
+    private static _normalizeConditions;
+    /**
+     * 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
+     */
+    private static _normalizeConditionSets;
+    /**
+     * 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
+     */
+    private static _normalizeCandidates;
+    /**
+     * 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
+     */
+    private static _addNormalizedResources;
+}
+//# sourceMappingURL=bundleNormalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundleNormalizer.d.ts","sourceRoot":"","sources":["../../../src/packlets/bundle/bundleNormalizer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAA8B,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAG/E;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;OAQG;WACW,SAAS,CACrB,eAAe,EAAE,sBAAsB,EACvC,YAAY,EAAE,mBAAmB,GAChC,MAAM,CAAC,sBAAsB,CAAC;IAYjC;;;;;;;OAOG;WACW,uBAAuB,CACnC,eAAe,EAAE,sBAAsB,EACvC,UAAU,EAAE,6BAA6B,GACxC,MAAM,CAAC,sBAAsB,CAAC;IAQjC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAenC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAetC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAkBnC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAQvC"}