@fgv/ts-res 4.5.0-3 → 5.0.0-2

package/lib/packlets/resource-json/compiled/index.js

@@ -0,0 +1,65 @@
+"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;
+    };
+})();
+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.Convert = void 0;
+const Convert = __importStar(require("./convert"));
+exports.Convert = Convert;
+__exportStar(require("./common"), exports);
+__exportStar(require("./json"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/resource-json/compiled/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/resource-json/compiled/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AAI5B,0BAAO;AAFhB,2CAAyB;AACzB,yCAAuB","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 Convert from './convert';\n\nexport * from './common';\nexport * from './json';\nexport { Convert };\n"]}

package/lib/packlets/resource-json/compiled/json.d.ts

@@ -0,0 +1,204 @@
+import * as Common from '../../common';
+import { JsonValue } from '@fgv/ts-json-base';
+/**
+ * Metadata for a compiled condition, containing human-readable information.
+ * @public
+ */
+export interface ICompiledConditionMetadata {
+    /**
+     * The semantic key of the condition (e.g., "language=en-US").
+     */
+    key: Common.ConditionKey;
+}
+/**
+ * Metadata for a compiled condition set, containing human-readable information.
+ * @public
+ */
+export interface ICompiledConditionSetMetadata {
+    /**
+     * The semantic key of the condition set (e.g., "language=en-US,territory=US").
+     */
+    key: Common.ConditionSetKey;
+}
+/**
+ * Metadata for a compiled decision, containing human-readable information.
+ * @public
+ */
+export interface ICompiledDecisionMetadata {
+    /**
+     * The semantic key of the decision (e.g., "language=en-US,territory=US OR language=fr,territory=CA").
+     */
+    key: Common.DecisionKey;
+}
+/**
+ * Represents a compiled qualifier type with a name.
+ * @public
+ */
+export interface ICompiledQualifierType {
+    /**
+     * The name of the qualifier type.
+     */
+    name: Common.QualifierTypeName;
+}
+/**
+ * Represents a compiled qualifier with a name and type reference.
+ * @public
+ */
+export interface ICompiledQualifier {
+    /**
+     * The name of the qualifier.
+     */
+    name: Common.QualifierName;
+    /**
+     * Index reference to the qualifier type.
+     */
+    type: Common.QualifierTypeIndex;
+    /**
+     * The token used to identify the qualifier in resource names or paths.
+     */
+    defaultPriority: Common.ConditionPriority;
+}
+/**
+ * Represents a compiled resource type with a name.
+ * @public
+ */
+export interface ICompiledResourceType {
+    /**
+     * The name of the resource type.
+     */
+    name: Common.ResourceTypeName;
+}
+/**
+ * Represents a compiled condition used for resource selection.
+ * @public
+ */
+export interface ICompiledCondition {
+    /**
+     * Index reference to the qualifier being evaluated.
+     */
+    qualifierIndex: Common.QualifierIndex;
+    /**
+     * Optional operator to apply in the condition evaluation.
+     */
+    operator?: Common.ConditionOperator;
+    /**
+     * The value to compare against when evaluating the condition.
+     */
+    value: string;
+    /**
+     * The priority of the condition when multiple conditions match.
+     */
+    priority: Common.ConditionPriority;
+    /**
+     * Optional score to use when treating this condition as a default.
+     */
+    scoreAsDefault?: Common.QualifierMatchScore;
+    /**
+     * Optional metadata containing human-readable information about this condition.
+     */
+    metadata?: ICompiledConditionMetadata;
+}
+/**
+ * Represents a compiled set of conditions that must be satisfied together.
+ * @public
+ */
+export interface ICompiledConditionSet {
+    /**
+     * Array of indices referencing the conditions in this set.
+     */
+    conditions: ReadonlyArray<Common.ConditionIndex>;
+    /**
+     * Optional metadata containing human-readable information about this condition set.
+     */
+    metadata?: ICompiledConditionSetMetadata;
+}
+/**
+ * Represents a compiled abstract decision with condition sets.
+ * @public
+ */
+export interface ICompiledAbstractDecision {
+    /**
+     * Array of indices referencing the condition sets for this decision.
+     */
+    conditionSets: ReadonlyArray<Common.ConditionSetIndex>;
+    /**
+     * Optional metadata containing human-readable information about this decision.
+     */
+    metadata?: ICompiledDecisionMetadata;
+}
+/**
+ * Represents a compiled resource candidate with JSON value and merge properties.
+ * @public
+ */
+export interface ICompiledCandidate {
+    /**
+     * The JSON value of the candidate.
+     */
+    json: JsonValue;
+    /**
+     * Indicates if this is a partial resource that needs to be merged.
+     */
+    isPartial: boolean;
+    /**
+     * The method to use when merging this candidate with others.
+     */
+    mergeMethod: Common.ResourceValueMergeMethod;
+}
+/**
+ * Represents a compiled resource with an identifier and associated candidates.
+ * @public
+ */
+export interface ICompiledResource {
+    /**
+     * The unique identifier of the resource.
+     */
+    id: Common.ResourceId;
+    /**
+     * Index reference to the resource type of this resource.
+     */
+    type: Common.ResourceTypeIndex;
+    /**
+     * Index reference to the decision that determines when this resource applies.
+     */
+    decision: Common.DecisionIndex;
+    /**
+     * Array of candidate values for this resource.
+     */
+    candidates: ReadonlyArray<ICompiledCandidate>;
+}
+/**
+ * Represents a complete compiled collection of resources with their associated
+ * qualifiers, types, conditions, and decisions.
+ * @public
+ */
+export interface ICompiledResourceCollection {
+    /**
+     * Array of all qualifier types in the collection.
+     */
+    qualifierTypes: ReadonlyArray<ICompiledQualifierType>;
+    /**
+     * Array of all qualifiers in the collection.
+     */
+    qualifiers: ReadonlyArray<ICompiledQualifier>;
+    /**
+     * Array of all resource types in the collection.
+     */
+    resourceTypes: ReadonlyArray<ICompiledResourceType>;
+    /**
+     * Array of all conditions in the collection.
+     */
+    conditions: ReadonlyArray<ICompiledCondition>;
+    /**
+     * Array of all condition sets in the collection.
+     */
+    conditionSets: ReadonlyArray<ICompiledConditionSet>;
+    /**
+     * Array of all decisions in the collection.
+     */
+    decisions: ReadonlyArray<ICompiledAbstractDecision>;
+    /**
+     * Array of all resources in the collection.
+     */
+    resources: ReadonlyArray<ICompiledResource>;
+}
+//# sourceMappingURL=json.d.ts.map

package/lib/packlets/resource-json/compiled/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/packlets/resource-json/compiled/json.ts"],"names":[],"mappings":"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"}

package/lib/packlets/resource-json/compiled/json.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=json.js.map

package/lib/packlets/resource-json/compiled/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../src/packlets/resource-json/compiled/json.ts"],"names":[],"mappings":"","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 */\nimport * as Common from '../../common';\nimport { JsonValue } from '@fgv/ts-json-base';\n\n/**\n * Metadata for a compiled condition, containing human-readable information.\n * @public\n */\nexport interface ICompiledConditionMetadata {\n  /**\n   * The semantic key of the condition (e.g., \"language=en-US\").\n   */\n  key: Common.ConditionKey;\n}\n\n/**\n * Metadata for a compiled condition set, containing human-readable information.\n * @public\n */\nexport interface ICompiledConditionSetMetadata {\n  /**\n   * The semantic key of the condition set (e.g., \"language=en-US,territory=US\").\n   */\n  key: Common.ConditionSetKey;\n}\n\n/**\n * Metadata for a compiled decision, containing human-readable information.\n * @public\n */\nexport interface ICompiledDecisionMetadata {\n  /**\n   * The semantic key of the decision (e.g., \"language=en-US,territory=US OR language=fr,territory=CA\").\n   */\n  key: Common.DecisionKey;\n}\n\n/**\n * Represents a compiled qualifier type with a name.\n * @public\n */\nexport interface ICompiledQualifierType {\n  /**\n   * The name of the qualifier type.\n   */\n  name: Common.QualifierTypeName;\n}\n\n/**\n * Represents a compiled qualifier with a name and type reference.\n * @public\n */\nexport interface ICompiledQualifier {\n  /**\n   * The name of the qualifier.\n   */\n  name: Common.QualifierName;\n  /**\n   * Index reference to the qualifier type.\n   */\n  type: Common.QualifierTypeIndex;\n\n  /**\n   * The token used to identify the qualifier in resource names or paths.\n   */\n  defaultPriority: Common.ConditionPriority;\n}\n\n/**\n * Represents a compiled resource type with a name.\n * @public\n */\nexport interface ICompiledResourceType {\n  /**\n   * The name of the resource type.\n   */\n  name: Common.ResourceTypeName;\n}\n\n/**\n * Represents a compiled condition used for resource selection.\n * @public\n */\nexport interface ICompiledCondition {\n  /**\n   * Index reference to the qualifier being evaluated.\n   */\n  qualifierIndex: Common.QualifierIndex;\n  /**\n   * Optional operator to apply in the condition evaluation.\n   */\n  operator?: Common.ConditionOperator;\n  /**\n   * The value to compare against when evaluating the condition.\n   */\n  value: string;\n  /**\n   * The priority of the condition when multiple conditions match.\n   */\n  priority: Common.ConditionPriority;\n  /**\n   * Optional score to use when treating this condition as a default.\n   */\n  scoreAsDefault?: Common.QualifierMatchScore;\n  /**\n   * Optional metadata containing human-readable information about this condition.\n   */\n  metadata?: ICompiledConditionMetadata;\n}\n\n/**\n * Represents a compiled set of conditions that must be satisfied together.\n * @public\n */\nexport interface ICompiledConditionSet {\n  /**\n   * Array of indices referencing the conditions in this set.\n   */\n  conditions: ReadonlyArray<Common.ConditionIndex>;\n  /**\n   * Optional metadata containing human-readable information about this condition set.\n   */\n  metadata?: ICompiledConditionSetMetadata;\n}\n\n/**\n * Represents a compiled abstract decision with condition sets.\n * @public\n */\nexport interface ICompiledAbstractDecision {\n  /**\n   * Array of indices referencing the condition sets for this decision.\n   */\n  conditionSets: ReadonlyArray<Common.ConditionSetIndex>;\n  /**\n   * Optional metadata containing human-readable information about this decision.\n   */\n  metadata?: ICompiledDecisionMetadata;\n}\n\n/**\n * Represents a compiled resource candidate with JSON value and merge properties.\n * @public\n */\nexport interface ICompiledCandidate {\n  /**\n   * The JSON value of the candidate.\n   */\n  json: JsonValue;\n  /**\n   * Indicates if this is a partial resource that needs to be merged.\n   */\n  isPartial: boolean;\n  /**\n   * The method to use when merging this candidate with others.\n   */\n  mergeMethod: Common.ResourceValueMergeMethod;\n}\n\n/**\n * Represents a compiled resource with an identifier and associated candidates.\n * @public\n */\nexport interface ICompiledResource {\n  /**\n   * The unique identifier of the resource.\n   */\n  id: Common.ResourceId;\n\n  /**\n   * Index reference to the resource type of this resource.\n   */\n  type: Common.ResourceTypeIndex;\n\n  /**\n   * Index reference to the decision that determines when this resource applies.\n   */\n  decision: Common.DecisionIndex;\n  /**\n   * Array of candidate values for this resource.\n   */\n  candidates: ReadonlyArray<ICompiledCandidate>;\n}\n\n/**\n * Represents a complete compiled collection of resources with their associated\n * qualifiers, types, conditions, and decisions.\n * @public\n */\nexport interface ICompiledResourceCollection {\n  /**\n   * Array of all qualifier types in the collection.\n   */\n  qualifierTypes: ReadonlyArray<ICompiledQualifierType>;\n  /**\n   * Array of all qualifiers in the collection.\n   */\n  qualifiers: ReadonlyArray<ICompiledQualifier>;\n  /**\n   * Array of all resource types in the collection.\n   */\n  resourceTypes: ReadonlyArray<ICompiledResourceType>;\n  /**\n   * Array of all conditions in the collection.\n   */\n  conditions: ReadonlyArray<ICompiledCondition>;\n  /**\n   * Array of all condition sets in the collection.\n   */\n  conditionSets: ReadonlyArray<ICompiledConditionSet>;\n  /**\n   * Array of all decisions in the collection.\n   */\n  decisions: ReadonlyArray<ICompiledAbstractDecision>;\n  /**\n   * Array of all resources in the collection.\n   */\n  resources: ReadonlyArray<ICompiledResource>;\n}\n"]}

package/lib/packlets/resource-json/convert.d.ts

@@ -21,6 +21,11 @@ export declare const conditionSetDecl: Converter<Normalized.ConditionSetDecl>;
  * @public
  */
 export declare const looseResourceCandidateDecl: Converter<Normalized.ILooseResourceCandidateDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declaration}.
+ * @public
+ */
+export declare const importerResourceCandidateDecl: Converter<Normalized.IImporterResourceCandidateDecl>;
 /**
  * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.
  * @public
@@ -36,6 +41,11 @@ export declare const looseResourceDecl: Converter<Normalized.ILooseResourceDecl>
  * @public
  */
 export declare const childResourceDecl: Converter<Normalized.IChildResourceDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IContainerContextDecl | resource context declaration}.
+ * @public
+ */
+export declare const containerContextDecl: Converter<Normalized.IContainerContextDecl>;
 /**
  * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.
  * @public
@@ -51,4 +61,10 @@ export declare const resourceTreeRootDecl: Converter<Normalized.IResourceTreeRoo
  * @public
  */
 export declare const resourceCollectionDecl: Converter<Normalized.IResourceCollectionDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCollectionDecl | importer resource collection declaration}.
+ * This allows for a mix of loose and child resource declarations.
+ * @public
+ */
+export declare const importerResourceCollectionDecl: Converter<Normalized.IImporterResourceCollectionDecl>;
 //# sourceMappingURL=convert.d.ts.map

package/lib/packlets/resource-json/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAwC,MAAM,eAAe,CAAC;AAGhF,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAO/D,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAM/D,CAAC;AA+BL;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,gBAAgB,CACoC,CAAC;AAEzG;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAQrF,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAMrF,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAKnE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAInE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,CAAC,UAAU,CAAC,0BAA0B,CActF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,UAAU,CAAC,qBAAqB,CAKzE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,UAAU,CAAC,uBAAuB,CAiBhF,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAwC,MAAM,eAAe,CAAC;AAGhF,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAO/D,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAM/D,CAAC;AA+BL;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,gBAAgB,CACoC,CAAC;AAEzG;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAQrF,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,CAAC,UAAU,CAAC,8BAA8B,CAQ3F,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAMrF,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAKnE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAInE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,UAAU,CAAC,qBAAqB,CAKzE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,CAAC,UAAU,CAAC,0BAA0B,CActF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,UAAU,CAAC,qBAAqB,CAKzE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,UAAU,CAAC,uBAAuB,CAiBhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,CAAC,UAAU,CAAC,+BAA+B,CAe9F,CAAC"}

package/lib/packlets/resource-json/convert.js

@@ -21,7 +21,7 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resourceCollectionDecl = exports.resourceTreeRootDecl = exports.resourceTreeChildNodeDecl = exports.childResourceDecl = exports.looseResourceDecl = exports.childResourceCandidateDecl = exports.looseResourceCandidateDecl = exports.conditionSetDecl = exports.childConditionDecl = exports.looseConditionDecl = void 0;
+exports.importerResourceCollectionDecl = exports.resourceCollectionDecl = exports.resourceTreeRootDecl = exports.resourceTreeChildNodeDecl = exports.containerContextDecl = exports.childResourceDecl = exports.looseResourceDecl = exports.childResourceCandidateDecl = exports.importerResourceCandidateDecl = exports.looseResourceCandidateDecl = exports.conditionSetDecl = exports.childConditionDecl = exports.looseConditionDecl = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const common_1 = require("../common");
 const ts_json_base_1 = require("@fgv/ts-json-base");
@@ -50,7 +50,7 @@ function _isConditionSetRecord(from) {
     return (0, ts_json_base_1.isJsonObject)(from);
 }
 const conditionSetDeclFromArray = ts_utils_1.Converters.arrayOf(exports.looseConditionDecl);
-const conditionSetDeclFromRecord = ts_utils_1.Converters.generic((from, self, context) => {
+const conditionSetDeclFromRecord = ts_utils_1.Converters.generic((from, __self, context) => {
     /* c8 ignore next 3 - this is tested but coverage is confused */
     if (!_isConditionSetRecord(from)) {
         return (0, ts_utils_1.fail)('Expected an object');
@@ -77,6 +77,18 @@ exports.looseResourceCandidateDecl = ts_utils_1.Converters.strictObject({
     isPartial: ts_utils_1.Converters.boolean.optional(),
     resourceTypeName: common_1.Convert.resourceTypeName.optional()
 });
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declaration}.
+ * @public
+ */
+exports.importerResourceCandidateDecl = ts_utils_1.Converters.strictObject({
+    id: common_1.Convert.resourceId.optional(),
+    json: ts_json_base_1.Converters.jsonObject,
+    conditions: exports.conditionSetDecl.optional(),
+    mergeMethod: common_1.Convert.resourceValueMergeMethod.optional(),
+    isPartial: ts_utils_1.Converters.boolean.optional(),
+    resourceTypeName: common_1.Convert.resourceTypeName.optional()
+});
 /**
  * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.
  * @public
@@ -104,6 +116,15 @@ exports.childResourceDecl = ts_utils_1.Converters.strictObject({
     resourceTypeName: common_1.Convert.resourceTypeName,
     candidates: ts_utils_1.Converters.arrayOf(exports.childResourceCandidateDecl).optional()
 });
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IContainerContextDecl | resource context declaration}.
+ * @public
+ */
+exports.containerContextDecl = ts_utils_1.Converters.strictObject({
+    baseId: ts_utils_1.Converters.oneOf([common_1.Convert.resourceId, ts_utils_1.Converters.literal('')]).optional(),
+    conditions: exports.conditionSetDecl.optional(),
+    mergeMethod: common_1.Convert.resourceValueMergeMethod.optional()
+});
 /**
  * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.
  * @public
@@ -119,7 +140,7 @@ exports.resourceTreeChildNodeDecl = ts_utils_1.Converters.generic((from, self, c
  * @public
  */
 exports.resourceTreeRootDecl = ts_utils_1.Converters.strictObject({
-    baseName: common_1.Convert.resourceId.optional(),
+    context: exports.containerContextDecl.optional(),
     resources: ts_utils_1.Converters.recordOf(exports.childResourceDecl).optional(),
     children: ts_utils_1.Converters.recordOf(exports.resourceTreeChildNodeDecl).optional()
 });
@@ -129,11 +150,25 @@ exports.resourceTreeRootDecl = ts_utils_1.Converters.strictObject({
  */
 exports.resourceCollectionDecl = ts_utils_1.Converters.generic((from, self, context) => {
     return ts_utils_1.Converters.strictObject({
-        baseName: common_1.Convert.resourceId.optional(),
-        baseConditions: exports.conditionSetDecl.optional(),
+        context: exports.containerContextDecl.optional(),
         candidates: ts_utils_1.Converters.arrayOf(exports.looseResourceCandidateDecl).optional(),
         resources: ts_utils_1.Converters.arrayOf(exports.looseResourceDecl).optional(),
-        collections: ts_utils_1.Converters.arrayOf(self).optional()
+        collections: ts_utils_1.Converters.arrayOf(self).optional(),
+        metadata: ts_json_base_1.Converters.jsonObject.optional()
+    }).convert(from, context);
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCollectionDecl | importer resource collection declaration}.
+ * This allows for a mix of loose and child resource declarations.
+ * @public
+ */
+exports.importerResourceCollectionDecl = ts_utils_1.Converters.generic((from, self, context) => {
+    return ts_utils_1.Converters.strictObject({
+        context: exports.containerContextDecl.optional(),
+        candidates: ts_utils_1.Converters.arrayOf(exports.importerResourceCandidateDecl).optional(),
+        resources: ts_utils_1.Converters.arrayOf(ts_utils_1.Converters.oneOf([exports.looseResourceDecl, exports.childResourceDecl])).optional(),
+        collections: ts_utils_1.Converters.arrayOf(self).optional(),
+        metadata: ts_json_base_1.Converters.jsonObject.optional()
     }).convert(from, context);
 });
 //# sourceMappingURL=convert.js.map

package/lib/packlets/resource-json/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.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 { Converter, Converters, mapResults, Result, fail } from '@fgv/ts-utils';\nimport { Convert as CommonConvert } from '../common';\nimport { isJsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';\nimport * as Json from './json';\nimport * as Normalized from './normalized';\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration}.\n * @public\n */\nexport const looseConditionDecl: Converter<Json.ILooseConditionDecl> =\n  Converters.strictObject<Json.ILooseConditionDecl>({\n    qualifierName: CommonConvert.qualifierName,\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}.\n * @public\n */\nexport const childConditionDecl: Converter<Json.IChildConditionDecl> =\n  Converters.strictObject<Json.IChildConditionDecl>({\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\nfunction _isConditionSetRecord(from: unknown): from is Record<string, string | Json.IChildConditionDecl> {\n  return isJsonObject(from);\n}\n\nconst conditionSetDeclFromArray: Converter<Normalized.ConditionSetDecl> =\n  Converters.arrayOf(looseConditionDecl);\nconst conditionSetDeclFromRecord: Converter<Normalized.ConditionSetDecl> = Converters.generic<\n  Normalized.ConditionSetDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.ConditionSetDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.ConditionSetDecl> => {\n    /* c8 ignore next 3 - this is tested but coverage is confused */\n    if (!_isConditionSetRecord(from)) {\n      return fail('Expected an object');\n    }\n    return mapResults(\n      Array.from(Object.entries(from)).map(([qualifierName, value]) => {\n        const toConvert: Json.ILooseConditionDecl =\n          typeof value === 'string' ? { qualifierName, value } : { qualifierName, ...value };\n        return looseConditionDecl.convert(toConvert, context);\n      })\n    );\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.\n * @public\n */\nexport const conditionSetDecl: Converter<Normalized.ConditionSetDecl> =\n  Converters.oneOf<Normalized.ConditionSetDecl>([conditionSetDeclFromArray, conditionSetDeclFromRecord]);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.\n * @public\n */\nexport const looseResourceCandidateDecl: Converter<Normalized.ILooseResourceCandidateDecl> =\n  Converters.strictObject<Normalized.ILooseResourceCandidateDecl>({\n    id: CommonConvert.resourceId,\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.\n * @public\n */\nexport const childResourceCandidateDecl: Converter<Normalized.IChildResourceCandidateDecl> =\n  Converters.strictObject<Normalized.IChildResourceCandidateDecl>({\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    isPartial: Converters.boolean.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declaration}.\n * @public\n */\nexport const looseResourceDecl: Converter<Normalized.ILooseResourceDecl> =\n  Converters.strictObject<Normalized.ILooseResourceDecl>({\n    id: CommonConvert.resourceId,\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IChildResourceDecl | child resource declaration}.\n * @public\n */\nexport const childResourceDecl: Converter<Normalized.IChildResourceDecl> =\n  Converters.strictObject<Normalized.IChildResourceDecl>({\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.\n * @public\n */\nexport const resourceTreeChildNodeDecl: Converter<Normalized.IResourceTreeChildNodeDecl> = Converters.generic<\n  Normalized.IResourceTreeChildNodeDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.IResourceTreeChildNodeDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.IResourceTreeChildNodeDecl> => {\n    return Converters.strictObject<Normalized.IResourceTreeChildNodeDecl>({\n      resources: Converters.recordOf(childResourceDecl).optional(),\n      children: Converters.recordOf(self).optional()\n    }).convert(from, context);\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}.\n * @public\n */\nexport const resourceTreeRootDecl: Converter<Normalized.IResourceTreeRootDecl> =\n  Converters.strictObject<Normalized.IResourceTreeRootDecl>({\n    baseName: CommonConvert.resourceId.optional(),\n    resources: Converters.recordOf(childResourceDecl).optional(),\n    children: Converters.recordOf(resourceTreeChildNodeDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}.\n * @public\n */\nexport const resourceCollectionDecl: Converter<Normalized.IResourceCollectionDecl> = Converters.generic<\n  Normalized.IResourceCollectionDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.IResourceCollectionDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.IResourceCollectionDecl> => {\n    return Converters.strictObject<Normalized.IResourceCollectionDecl>({\n      baseName: CommonConvert.resourceId.optional(),\n      baseConditions: conditionSetDecl.optional(),\n      candidates: Converters.arrayOf(looseResourceCandidateDecl).optional(),\n      resources: Converters.arrayOf(looseResourceDecl).optional(),\n      collections: Converters.arrayOf(self).optional()\n    }).convert(from, context);\n  }\n);\n"]}
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.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 { Converter, Converters, mapResults, Result, fail } from '@fgv/ts-utils';\nimport { Convert as CommonConvert } from '../common';\nimport { isJsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';\nimport * as Json from './json';\nimport * as Normalized from './normalized';\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration}.\n * @public\n */\nexport const looseConditionDecl: Converter<Json.ILooseConditionDecl> =\n  Converters.strictObject<Json.ILooseConditionDecl>({\n    qualifierName: CommonConvert.qualifierName,\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}.\n * @public\n */\nexport const childConditionDecl: Converter<Json.IChildConditionDecl> =\n  Converters.strictObject<Json.IChildConditionDecl>({\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\nfunction _isConditionSetRecord(from: unknown): from is Record<string, string | Json.IChildConditionDecl> {\n  return isJsonObject(from);\n}\n\nconst conditionSetDeclFromArray: Converter<Normalized.ConditionSetDecl> =\n  Converters.arrayOf(looseConditionDecl);\nconst conditionSetDeclFromRecord: Converter<Normalized.ConditionSetDecl> = Converters.generic<\n  Normalized.ConditionSetDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    __self: Converter<Normalized.ConditionSetDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.ConditionSetDecl> => {\n    /* c8 ignore next 3 - this is tested but coverage is confused */\n    if (!_isConditionSetRecord(from)) {\n      return fail('Expected an object');\n    }\n    return mapResults(\n      Array.from(Object.entries(from)).map(([qualifierName, value]) => {\n        const toConvert: Json.ILooseConditionDecl =\n          typeof value === 'string' ? { qualifierName, value } : { qualifierName, ...value };\n        return looseConditionDecl.convert(toConvert, context);\n      })\n    );\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.\n * @public\n */\nexport const conditionSetDecl: Converter<Normalized.ConditionSetDecl> =\n  Converters.oneOf<Normalized.ConditionSetDecl>([conditionSetDeclFromArray, conditionSetDeclFromRecord]);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.\n * @public\n */\nexport const looseResourceCandidateDecl: Converter<Normalized.ILooseResourceCandidateDecl> =\n  Converters.strictObject<Normalized.ILooseResourceCandidateDecl>({\n    id: CommonConvert.resourceId,\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declaration}.\n * @public\n */\nexport const importerResourceCandidateDecl: Converter<Normalized.IImporterResourceCandidateDecl> =\n  Converters.strictObject<Normalized.IImporterResourceCandidateDecl>({\n    id: CommonConvert.resourceId.optional(),\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.\n * @public\n */\nexport const childResourceCandidateDecl: Converter<Normalized.IChildResourceCandidateDecl> =\n  Converters.strictObject<Normalized.IChildResourceCandidateDecl>({\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    isPartial: Converters.boolean.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declaration}.\n * @public\n */\nexport const looseResourceDecl: Converter<Normalized.ILooseResourceDecl> =\n  Converters.strictObject<Normalized.ILooseResourceDecl>({\n    id: CommonConvert.resourceId,\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IChildResourceDecl | child resource declaration}.\n * @public\n */\nexport const childResourceDecl: Converter<Normalized.IChildResourceDecl> =\n  Converters.strictObject<Normalized.IChildResourceDecl>({\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IContainerContextDecl | resource context declaration}.\n * @public\n */\nexport const containerContextDecl: Converter<Normalized.IContainerContextDecl> =\n  Converters.strictObject<Normalized.IContainerContextDecl>({\n    baseId: Converters.oneOf([CommonConvert.resourceId, Converters.literal('')]).optional(),\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.\n * @public\n */\nexport const resourceTreeChildNodeDecl: Converter<Normalized.IResourceTreeChildNodeDecl> = Converters.generic<\n  Normalized.IResourceTreeChildNodeDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.IResourceTreeChildNodeDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.IResourceTreeChildNodeDecl> => {\n    return Converters.strictObject<Normalized.IResourceTreeChildNodeDecl>({\n      resources: Converters.recordOf(childResourceDecl).optional(),\n      children: Converters.recordOf(self).optional()\n    }).convert(from, context);\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}.\n * @public\n */\nexport const resourceTreeRootDecl: Converter<Normalized.IResourceTreeRootDecl> =\n  Converters.strictObject<Normalized.IResourceTreeRootDecl>({\n    context: containerContextDecl.optional(),\n    resources: Converters.recordOf(childResourceDecl).optional(),\n    children: Converters.recordOf(resourceTreeChildNodeDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}.\n * @public\n */\nexport const resourceCollectionDecl: Converter<Normalized.IResourceCollectionDecl> = Converters.generic<\n  Normalized.IResourceCollectionDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.IResourceCollectionDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.IResourceCollectionDecl> => {\n    return Converters.strictObject<Normalized.IResourceCollectionDecl>({\n      context: containerContextDecl.optional(),\n      candidates: Converters.arrayOf(looseResourceCandidateDecl).optional(),\n      resources: Converters.arrayOf(looseResourceDecl).optional(),\n      collections: Converters.arrayOf(self).optional(),\n      metadata: JsonConverters.jsonObject.optional()\n    }).convert(from, context);\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCollectionDecl | importer resource collection declaration}.\n * This allows for a mix of loose and child resource declarations.\n * @public\n */\nexport const importerResourceCollectionDecl: Converter<Normalized.IImporterResourceCollectionDecl> =\n  Converters.generic<Normalized.IImporterResourceCollectionDecl, unknown>(\n    (\n      from: unknown,\n      self: Converter<Normalized.IImporterResourceCollectionDecl, unknown>,\n      context?: unknown\n    ): Result<Normalized.IImporterResourceCollectionDecl> => {\n      return Converters.strictObject<Normalized.IImporterResourceCollectionDecl>({\n        context: containerContextDecl.optional(),\n        candidates: Converters.arrayOf(importerResourceCandidateDecl).optional(),\n        resources: Converters.arrayOf(Converters.oneOf([looseResourceDecl, childResourceDecl])).optional(),\n        collections: Converters.arrayOf(self).optional(),\n        metadata: JsonConverters.jsonObject.optional()\n      }).convert(from, context);\n    }\n  );\n"]}

package/lib/packlets/resource-json/helpers.d.ts

@@ -8,10 +8,24 @@ import * as Json from './json';
 export interface IDeclarationOptions {
     /**
      * If `true`, properties with default values will be included in the
-     * output. IF omitted or `false`, properties with default values will be omitted.
+     * output. If omitted or `false`, properties with default values will be omitted.
      */
     showDefaults?: boolean;
+    /**
+     * If `true`, the output will be normalized using hash-based ordering for consistent structure.
+     * If omitted or `false`, no normalization will be applied. Defaults to `false`.
+     */
+    normalized?: boolean;
 }
+/**
+ * Helper method to merge a resource context declaration with a parent name and conditions.
+ * @param decl - The resource context declaration to merge.
+ * @param parentName - The name of the parent resource.
+ * @param parentConditions - The conditions of the parent resource.
+ * @returns `Success` with the merged resource context declaration if successful, otherwise `Failure`.
+ * @public
+ */
+export declare function mergeContextDecl(decl?: Normalized.IContainerContextDecl, parentName?: string, parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.IContainerContextDecl>;
 /**
  * Helper method to merge a loose candidate with a base name and conditions.
  * @param candidate - The candidate to merge.
@@ -20,7 +34,34 @@ export interface IDeclarationOptions {
  * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
  * @public
  */
-export declare function mergeLooseCandidate(candidate: Normalized.ILooseResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceCandidateDecl>;
+export declare function mergeLooseCandidate(candidate: Normalized.IImporterResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceCandidateDecl>;
+/**
+ * Helper method to merge a resource candidate with a base name and conditions from import context.
+ * This function enables name inheritance for resource candidates, similar to resources.
+ *
+ * @param candidate - The candidate to merge. Can have an optional ID that will be joined with baseName.
+ * @param baseName - The base name from import context to merge with the candidate.
+ * When provided, this will be used as the parent component of the candidate ID.
+ * @param baseConditions - The base conditions from import context to merge with the candidate's conditions.
+ * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
+ *
+ * @remarks
+ * This function supports name inheritance for candidates:
+ * - Joins baseName with candidate's existing ID using dot notation
+ * - If candidate has no ID, uses baseName as the full ID
+ * - Always merges base conditions with candidate's existing conditions
+ *
+ * @example
+ * ```typescript
+ * // Candidate inherits full name from import context
+ * const candidate = { value: "Hello", conditions: [...] }; // No id field
+ * const result = mergeImporterCandidate(candidate, "pages.home.greeting", []);
+ * // Result: { id: "pages.home.greeting", value: "Hello", conditions: [...] }
+ * ```
+ *
+ * @public
+ */
+export declare function mergeImporterCandidate(candidate: Normalized.IImporterResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.IImporterResourceCandidateDecl>;
 /**
  * Helper method to merge a child candidate with base conditions.
  * @param candidate - The candidate to merge.
@@ -37,11 +78,49 @@ export declare function mergeChildCandidate(candidate: Normalized.IChildResource
  * @returns `Success` with the merged resource if successful, otherwise `Failure`.
  * @public
  */
-export declare function mergeLooseResource(resource: Normalized.ILooseResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceDecl>;
+export declare function mergeLooseResource(resource: Normalized.IImporterResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceDecl>;
+/**
+ * Helper method to merge a resource with a base name and conditions from import context.
+ * This function enables name inheritance where resources can automatically inherit their
+ * resource ID from the import context when no explicit ID is provided in the resource declaration.
+ *
+ * @param resource - The resource to merge. Can be either a loose resource (with optional ID)
+ * or a child resource (without ID).
+ * @param baseName - The base name from import context to merge with the resource.
+ * When provided, this will be used as the parent component of the resource ID.
+ * @param baseConditions - The base conditions from import context to merge with the resource's conditions.
+ * @returns `Success` with the merged resource if successful, otherwise `Failure`.
+ *
+ * @remarks
+ * This function supports several scenarios for name inheritance:
+ * - **Explicit ID + Base Name**: Joins baseName.resourceId (e.g., "pages.home" + "greeting" = "pages.home.greeting")
+ * - **No ID + Base Name**: Uses baseName as the resource ID (enables name inheritance from import context)
+ * - **Explicit ID + No Base Name**: Uses the resource's existing ID
+ * - **No ID + No Base Name**: Returns resource without ID (for child resources)
+ *
+ * Base conditions are always merged with the resource's existing conditions.
+ *
+ * @example
+ * ```typescript
+ * // Resource without ID inherits name from import context
+ * const resource = { candidates: [...] }; // No id field
+ * const result = mergeImporterResource(resource, "pages.home", []);
+ * // Result: { id: "pages.home", candidates: [...] }
+ *
+ * // Resource with ID gets joined with base name
+ * const resource = { id: "greeting", candidates: [...] };
+ * const result = mergeImporterResource(resource, "pages.home", []);
+ * // Result: { id: "pages.home.greeting", candidates: [...] }
+ * ```
+ *
+ * @public
+ */
+export declare function mergeImporterResource(resource: Normalized.IImporterResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.IImporterResourceDecl>;
 /**
  * Helper method to merge a child resource with a parent name and conditions.
  * @param resource - The resource to merge.
  * @param name - The name of the resource.
+ *
  * @param parentName - The name of the parent resource.
  * @param parentConditions - The conditions of the parent resource.
  * @returns `Success` with the merged resource if successful, otherwise `Failure`.

package/lib/packlets/resource-json/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAW,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAG/B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAIhD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,kBAAkB,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,kBAAkB,EACvC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACzD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAI/B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,CAAC,EAAE,UAAU,CAAC,qBAAqB,EACvC,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACzD,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAsB1C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,8BAA8B,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAWhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,UAAU,CAAC,8BAA8B,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAanD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAIhD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,qBAAqB,EAC1C,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAevC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,UAAU,CAAC,qBAAqB,EAC1C,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAoB1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,kBAAkB,EACvC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACzD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC"}