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

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

@@ -21,4 +21,20 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLooseResourceCandidateDecl = isLooseResourceCandidateDecl;
+exports.isLooseResourceDecl = isLooseResourceDecl;
+/**
+ * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.
+ * @public
+ */
+function isLooseResourceCandidateDecl(decl) {
+    return 'id' in decl;
+}
+/**
+ * Type guard function to check if a resource declaration is a loose resource declaration.
+ * @public
+ */
+function isLooseResourceDecl(decl) {
+    return 'id' in decl;
+}
 //# sourceMappingURL=json.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { JsonObject } from '@fgv/ts-json-base';\nimport { ConditionOperator, ResourceValueMergeMethod } from '../common';\n\n/**\n * Non-validated loose declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface ILooseConditionDecl {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: string;\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated child declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface IChildConditionDecl {\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly baseName?: string;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly baseName?: string;\n  readonly baseConditions?: ConditionSetDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n}\n"]}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAsQH,oEAIC;AAMD,kDAEC;AAhBD;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,IAAoC;IAEpC,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAA2B;IAC7D,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { ConditionOperator, ResourceValueMergeMethod } from '../common';\n\n/**\n * Non-validated loose declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface ILooseConditionDecl {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: string;\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated child declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface IChildConditionDecl {\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Non-validated declaration of a resource candidate for import,\n * which can be either a loose or child resource candidate.\n * @public\n */\nexport interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id?: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Declared context for a resource container.\n * @public\n */\nexport interface IContainerContextDecl {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly context?: IContainerContextDecl;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a resource for import,\n * which can be either a loose or child resource.\n * @public\n */\nexport type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;\n\n/**\n * Non-validated declaration of a collection of resources for an importer.\n * @public\n */\nexport interface IImporterResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.\n * @public\n */\nexport function isLooseResourceCandidateDecl(\n  decl: IImporterResourceCandidateDecl\n): decl is ILooseResourceCandidateDecl {\n  return 'id' in decl;\n}\n\n/**\n * Type guard function to check if a resource declaration is a loose resource declaration.\n * @public\n */\nexport function isLooseResourceDecl(decl: IImporterResourceDecl): decl is ILooseResourceDecl {\n  return 'id' in decl;\n}\n"]}

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

@@ -29,6 +29,21 @@ export interface IChildResourceCandidateDecl {
      */
     readonly mergeMethod?: ResourceValueMergeMethod;
 }
+/**
+ * Normalized non-validated declaration of a resource candidate for import,
+ * which can be either a loose or child resource candidate.
+ * @public
+ */
+export interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {
+    /**
+     * The {@link ResourceId | id} of the resource.
+     */
+    readonly id?: string;
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName?: string;
+}
 /**
  * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.
  * @public
@@ -100,24 +115,52 @@ export interface IResourceTreeChildNodeDecl {
     readonly resources?: Record<string, IChildResourceDecl>;
     readonly children?: Record<string, IResourceTreeChildNodeDecl>;
 }
+/**
+ * Declared context for a resource container.
+ * @public
+ */
+export interface IContainerContextDecl {
+    readonly baseId?: string;
+    readonly conditions?: ConditionSetDecl;
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
 /**
  * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.
  * @public
  */
 export interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
-    readonly baseName?: string;
+    readonly context?: IContainerContextDecl;
     readonly resources?: Record<string, IChildResourceDecl>;
     readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+    readonly metadata?: JsonObject;
 }
 /**
  * Normalized non-validated declaration of a collection of resources.
  * @public
  */
 export interface IResourceCollectionDecl {
-    readonly baseName?: string;
-    readonly baseConditions?: ConditionSetDecl;
+    readonly context?: IContainerContextDecl;
     readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
     readonly resources?: ReadonlyArray<ILooseResourceDecl>;
     readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+    readonly metadata?: JsonObject;
+}
+/**
+ * Normalized non-validated declaration of a resource for import,
+ * which can be either a loose or child resource.
+ * @public
+ */
+export type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;
+/**
+ * Normalized non-validated declaration of a collection of resources for importers.
+ * This allows for a mix of loose and child resource declarations.
+ * @public
+ */
+export interface IImporterResourceCollectionDecl {
+    readonly context?: IContainerContextDecl;
+    readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;
+    readonly resources?: ReadonlyArray<IImporterResourceDecl>;
+    readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;
+    readonly metadata?: JsonObject;
 }
 //# sourceMappingURL=normalized.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"normalized.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAC/D"}
+{"version":3,"file":"normalized.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA+B,SAAQ,2BAA2B;IACjF;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,8BAA8B,CAAC,CAAC;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,+BAA+B,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC"}

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

@@ -1 +1 @@
-{"version":3,"file":"normalized.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { JsonObject } from '@fgv/ts-json-base';\nimport { ResourceValueMergeMethod } from '../common';\nimport { ILooseConditionDecl } from './json';\n\n/**\n * Normalized non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly baseName?: string;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly baseName?: string;\n  readonly baseConditions?: ConditionSetDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n}\n"]}
+{"version":3,"file":"normalized.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { JsonObject } from '@fgv/ts-json-base';\nimport { ResourceValueMergeMethod } from '../common';\nimport { ILooseConditionDecl } from './json';\n\n/**\n * Normalized non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a resource candidate for import,\n * which can be either a loose or child resource candidate.\n * @public\n */\nexport interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id?: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Declared context for a resource container.\n * @public\n */\nexport interface IContainerContextDecl {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly context?: IContainerContextDecl;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Normalized non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Normalized non-validated declaration of a resource for import,\n * which can be either a loose or child resource.\n * @public\n */\nexport type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;\n\n/**\n * Normalized non-validated declaration of a collection of resources for importers.\n * This allows for a mix of loose and child resource declarations.\n * @public\n */\nexport interface IImporterResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n"]}

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

@@ -11,10 +11,14 @@ export declare class ResourceDeclCollection implements IResourceDeclContainer {
      * The {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}
      * being processed.
      */
-    readonly collection: Normalized.IResourceCollectionDecl;
-    protected _resources: Normalized.ILooseResourceDecl[];
-    protected _candidates: Normalized.ILooseResourceCandidateDecl[];
-    protected constructor(collection: Normalized.IResourceCollectionDecl);
+    readonly collection: Normalized.IImporterResourceCollectionDecl;
+    /**
+     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     */
+    get context(): Normalized.IContainerContextDecl | undefined;
+    protected _resources: Normalized.IImporterResourceDecl[];
+    protected _candidates: Normalized.IImporterResourceCandidateDecl[];
+    protected constructor(collection: Normalized.IImporterResourceCollectionDecl);
     /**
      * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an
      * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
@@ -23,17 +27,17 @@ export declare class ResourceDeclCollection implements IResourceDeclContainer {
      */
     static create(from: unknown): Result<ResourceDeclCollection>;
     /**
-     * Gets the loose resources extracted from the collection.
-     * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}
+     * Gets the importer resources extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource declarations}
      * extracted from the collection.
      */
-    getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl>;
+    getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl>;
     /**
-     * Gets the loose candidates extracted from the collection.
-     * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}
+     * Gets the importer candidates extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declarations}
      * extracted from the collection.
      */
-    getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl>;
+    getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl>;
     private _extract;
 }
 //# sourceMappingURL=resourceDeclCollection.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resourceDeclCollection.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclCollection.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgD,MAAM,EAAW,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAK3C;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,sBAAsB;IACnE;;;OAGG;IACH,SAAgB,UAAU,EAAE,UAAU,CAAC,uBAAuB,CAAC;IAE/D,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,kBAAkB,EAAE,CAAM;IAC3D,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,2BAA2B,EAAE,CAAM;IAErE,SAAS,aAAa,UAAU,EAAE,UAAU,CAAC,uBAAuB;IAKpE;;;;;OAKG;WACW,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,sBAAsB,CAAC;IASnE;;;;OAIG;IACI,iBAAiB,IAAI,aAAa,CAAC,UAAU,CAAC,kBAAkB,CAAC;IAIxE;;;;OAIG;IACI,kBAAkB,IAAI,aAAa,CAAC,UAAU,CAAC,2BAA2B,CAAC;IAIlF,OAAO,CAAC,QAAQ;CAwBjB"}
+{"version":3,"file":"resourceDeclCollection.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclCollection.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgD,MAAM,EAAW,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAI3C;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,sBAAsB;IACnE;;;OAGG;IACH,SAAgB,UAAU,EAAE,UAAU,CAAC,+BAA+B,CAAC;IAEvE;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAAC,qBAAqB,GAAG,SAAS,CAEjE;IAED,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,qBAAqB,EAAE,CAAM;IAC9D,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,8BAA8B,EAAE,CAAM;IAExE,SAAS,aAAa,UAAU,EAAE,UAAU,CAAC,+BAA+B;IAK5E;;;;;OAKG;WACW,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,sBAAsB,CAAC;IASnE;;;;OAIG;IACI,oBAAoB,IAAI,aAAa,CAAC,UAAU,CAAC,qBAAqB,CAAC;IAI9E;;;;OAIG;IACI,qBAAqB,IAAI,aAAa,CAAC,UAAU,CAAC,8BAA8B,CAAC;IAIxF,OAAO,CAAC,QAAQ;CA2BjB"}

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

@@ -57,7 +57,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResourceDeclCollection = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const Convert = __importStar(require("./convert"));
-const common_1 = require("../common");
 const helpers_1 = require("./helpers");
 /**
  * Class that extracts resources and candidates from a
@@ -65,6 +64,12 @@ const helpers_1 = require("./helpers");
  * @public
  */
 class ResourceDeclCollection {
+    /**
+     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     */
+    get context() {
+        return this.collection.context;
+    }
     constructor(collection) {
         this._resources = [];
         this._candidates = [];
@@ -78,7 +83,7 @@ class ResourceDeclCollection {
      * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.
      */
     static create(from) {
-        return Convert.resourceCollectionDecl
+        return Convert.importerResourceCollectionDecl
             .convert(from)
             .withErrorFormat((err) => `Invalid resource collection: ${err}`)
             .onSuccess((decl) => {
@@ -86,31 +91,30 @@ class ResourceDeclCollection {
         });
     }
     /**
-     * Gets the loose resources extracted from the collection.
-     * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}
+     * Gets the importer resources extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource declarations}
      * extracted from the collection.
      */
-    getLooseResources() {
+    getImporterResources() {
         return this._resources;
     }
     /**
-     * Gets the loose candidates extracted from the collection.
-     * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}
+     * Gets the importer candidates extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declarations}
      * extracted from the collection.
      */
-    getLooseCandidates() {
+    getImporterCandidates() {
         return this._candidates;
     }
     _extract(collection, parentName, parentConditions) {
         const errors = new ts_utils_1.MessageAggregator();
-        return common_1.Helpers.joinOptionalResourceIds(parentName, collection.baseName).onSuccess((baseName) => {
-            var _a, _b, _c, _d, _e, _f;
-            const baseConditions = [...(parentConditions !== null && parentConditions !== void 0 ? parentConditions : []), ...((_a = collection.baseConditions) !== null && _a !== void 0 ? _a : [])];
-            const mergedCandidates = (_c = (_b = collection.candidates) === null || _b === void 0 ? void 0 : _b.map((candidate) => (0, helpers_1.mergeLooseCandidate)(candidate, baseName, baseConditions))) !== null && _c !== void 0 ? _c : [];
+        return (0, helpers_1.mergeContextDecl)(collection.context, parentName, parentConditions).onSuccess(({ baseId: baseName, conditions: baseConditions }) => {
+            var _a, _b, _c, _d, _e;
+            const mergedCandidates = (_b = (_a = collection.candidates) === null || _a === void 0 ? void 0 : _a.map((candidate) => (0, helpers_1.mergeImporterCandidate)(candidate, baseName, baseConditions))) !== null && _b !== void 0 ? _b : [];
             this._candidates.push(...(0, ts_utils_1.mapResults)(mergedCandidates).aggregateError(errors).orDefault([]));
-            const mergedResources = (_e = (_d = collection.resources) === null || _d === void 0 ? void 0 : _d.map((resource) => (0, helpers_1.mergeLooseResource)(resource, baseName, baseConditions))) !== null && _e !== void 0 ? _e : [];
+            const mergedResources = (_d = (_c = collection.resources) === null || _c === void 0 ? void 0 : _c.map((resource) => (0, helpers_1.mergeImporterResource)(resource, baseName, baseConditions))) !== null && _d !== void 0 ? _d : [];
             this._resources.push(...(0, ts_utils_1.mapResults)(mergedResources).aggregateError(errors).orDefault([]));
-            (_f = collection.collections) === null || _f === void 0 ? void 0 : _f.forEach((subCollection) => {
+            (_e = collection.collections) === null || _e === void 0 ? void 0 : _e.forEach((subCollection) => {
                 this._extract(subCollection, baseName, baseConditions).aggregateError(errors);
             });
             return errors.returnOrReport((0, ts_utils_1.succeed)(this));

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

@@ -1 +1 @@
-{"version":3,"file":"resourceDeclCollection.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclCollection.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA8F;AAE9F,mDAAqC;AAGrC,sCAAqD;AACrD,uCAAoE;AAEpE;;;;GAIG;AACH,MAAa,sBAAsB;IAUjC,YAAsB,UAA8C;QAH1D,eAAU,GAAoC,EAAE,CAAC;QACjD,gBAAW,GAA6C,EAAE,CAAC;QAGnE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,IAAa;QAChC,OAAO,OAAO,CAAC,sBAAsB;aAClC,OAAO,CAAC,IAAI,CAAC;aACb,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gCAAgC,GAAG,EAAE,CAAC;aAC/D,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,kBAAkB;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,QAAQ,CACd,UAA8C,EAC9C,UAAmB,EACnB,gBAA6C;QAE7C,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAC1D,OAAO,gBAAa,CAAC,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;;YACnG,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,UAAU,CAAC,cAAc,mCAAI,EAAE,CAAC,CAAC,CAAC;YAE3F,MAAM,gBAAgB,GACpB,MAAA,MAAA,UAAU,CAAC,UAAU,0CAAE,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,6BAAmB,EAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,mCACnG,EAAE,CAAC;YACL,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,gBAAgB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAE5F,MAAM,eAAe,GACnB,MAAA,MAAA,UAAU,CAAC,SAAS,0CAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,4BAAkB,EAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,mCAAI,EAAE,CAAC;YACxG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,eAAe,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAE1F,MAAA,UAAU,CAAC,WAAW,0CAAE,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;gBAChD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAxED,wDAwEC","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 { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport { mergeLooseCandidate, mergeLooseResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.\n * @public\n */\nexport class ResourceDeclCollection implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}\n   * being processed.\n   */\n  public readonly collection: Normalized.IResourceCollectionDecl;\n\n  protected _resources: Normalized.ILooseResourceDecl[] = [];\n  protected _candidates: Normalized.ILooseResourceCandidateDecl[] = [];\n\n  protected constructor(collection: Normalized.IResourceCollectionDecl) {\n    this.collection = collection;\n    this._extract(collection).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an\n   * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclCollection> {\n    return Convert.resourceCollectionDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource collection: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclCollection(decl));\n      });\n  }\n\n  /**\n   * Gets the loose resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}\n   * extracted from the collection.\n   */\n  public getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the loose candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    collection: Normalized.IResourceCollectionDecl,\n    parentName?: string,\n    parentConditions?: Json.ILooseConditionDecl[]\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n    return CommonHelpers.joinOptionalResourceIds(parentName, collection.baseName).onSuccess((baseName) => {\n      const baseConditions = [...(parentConditions ?? []), ...(collection.baseConditions ?? [])];\n\n      const mergedCandidates =\n        collection.candidates?.map((candidate) => mergeLooseCandidate(candidate, baseName, baseConditions)) ??\n        [];\n      this._candidates.push(...mapResults(mergedCandidates).aggregateError(errors).orDefault([]));\n\n      const mergedResources =\n        collection.resources?.map((resource) => mergeLooseResource(resource, baseName, baseConditions)) ?? [];\n      this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n      collection.collections?.forEach((subCollection) => {\n        this._extract(subCollection, baseName, baseConditions).aggregateError(errors);\n      });\n      return errors.returnOrReport(succeed(this));\n    });\n  }\n}\n"]}
+{"version":3,"file":"resourceDeclCollection.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclCollection.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA8F;AAE9F,mDAAqC;AAGrC,uCAA4F;AAE5F;;;;GAIG;AACH,MAAa,sBAAsB;IAOjC;;OAEG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IACjC,CAAC;IAKD,YAAsB,UAAsD;QAHlE,eAAU,GAAuC,EAAE,CAAC;QACpD,gBAAW,GAAgD,EAAE,CAAC;QAGtE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,IAAa;QAChC,OAAO,OAAO,CAAC,8BAA8B;aAC1C,OAAO,CAAC,IAAI,CAAC;aACb,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gCAAgC,GAAG,EAAE,CAAC;aAC/D,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,QAAQ,CACd,UAAsD,EACtD,UAAmB,EACnB,gBAA0D;QAE1D,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAC1D,OAAO,IAAA,0BAAgB,EAAC,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,SAAS,CACjF,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,EAAE;;YACnD,MAAM,gBAAgB,GACpB,MAAA,MAAA,UAAU,CAAC,UAAU,0CAAE,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACvC,IAAA,gCAAsB,EAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAC5D,mCAAI,EAAE,CAAC;YACV,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,gBAAgB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAE5F,MAAM,eAAe,GACnB,MAAA,MAAA,UAAU,CAAC,SAAS,0CAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrC,IAAA,+BAAqB,EAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAC1D,mCAAI,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,eAAe,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAE1F,MAAA,UAAU,CAAC,WAAW,0CAAE,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;gBAChD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAlFD,wDAkFC","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 { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { mergeContextDecl, mergeImporterCandidate, mergeImporterResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.\n * @public\n */\nexport class ResourceDeclCollection implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}\n   * being processed.\n   */\n  public readonly collection: Normalized.IImporterResourceCollectionDecl;\n\n  /**\n   * {@inheritdoc ResourceJson.IResourceDeclContainer.context}\n   */\n  public get context(): Normalized.IContainerContextDecl | undefined {\n    return this.collection.context;\n  }\n\n  protected _resources: Normalized.IImporterResourceDecl[] = [];\n  protected _candidates: Normalized.IImporterResourceCandidateDecl[] = [];\n\n  protected constructor(collection: Normalized.IImporterResourceCollectionDecl) {\n    this.collection = collection;\n    this._extract(collection).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an\n   * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclCollection> {\n    return Convert.importerResourceCollectionDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource collection: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclCollection(decl));\n      });\n  }\n\n  /**\n   * Gets the importer resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource declarations}\n   * extracted from the collection.\n   */\n  public getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the importer candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    collection: Normalized.IImporterResourceCollectionDecl,\n    parentName?: string,\n    parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n    return mergeContextDecl(collection.context, parentName, parentConditions).onSuccess(\n      ({ baseId: baseName, conditions: baseConditions }) => {\n        const mergedCandidates =\n          collection.candidates?.map((candidate) =>\n            mergeImporterCandidate(candidate, baseName, baseConditions)\n          ) ?? [];\n        this._candidates.push(...mapResults(mergedCandidates).aggregateError(errors).orDefault([]));\n\n        const mergedResources =\n          collection.resources?.map((resource) =>\n            mergeImporterResource(resource, baseName, baseConditions)\n          ) ?? [];\n        this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n        collection.collections?.forEach((subCollection) => {\n          this._extract(subCollection, baseName, baseConditions).aggregateError(errors);\n        });\n        return errors.returnOrReport(succeed(this));\n      }\n    );\n  }\n}\n"]}

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

@@ -5,7 +5,20 @@ import * as Normalized from './normalized';
  * @public
  */
 export interface IResourceDeclContainer {
-    getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl>;
-    getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl>;
+    /**
+     * Optional initial {@link ResourceJson.Normalized.IContainerContextDecl | resource context}
+     * declaration for the container.
+     */
+    readonly context?: Normalized.IContainerContextDecl;
+    /**
+     * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource}
+     * declarations for all resources in the container, including children.
+     */
+    getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl>;
+    /**
+     * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate}
+     * declarations for all resources in the container, including children.
+     */
+    getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl>;
 }
 //# sourceMappingURL=resourceDeclContainer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resourceDeclContainer.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclContainer.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,IAAI,aAAa,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAClE,kBAAkB,IAAI,aAAa,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC;CAC7E"}
+{"version":3,"file":"resourceDeclContainer.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclContainer.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,qBAAqB,CAAC;IAEpD;;;OAGG;IACH,oBAAoB,IAAI,aAAa,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAExE;;;OAGG;IACH,qBAAqB,IAAI,aAAa,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;CACnF"}

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

@@ -1 +1 @@
-{"version":3,"file":"resourceDeclContainer.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclContainer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 Normalized from './normalized';\n\n/**\n * Generic container for resource and resource candidate\n * declarations.\n * @public\n */\nexport interface IResourceDeclContainer {\n  getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl>;\n  getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl>;\n}\n"]}
+{"version":3,"file":"resourceDeclContainer.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclContainer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 Normalized from './normalized';\n\n/**\n * Generic container for resource and resource candidate\n * declarations.\n * @public\n */\nexport interface IResourceDeclContainer {\n  /**\n   * Optional initial {@link ResourceJson.Normalized.IContainerContextDecl | resource context}\n   * declaration for the container.\n   */\n  readonly context?: Normalized.IContainerContextDecl;\n\n  /**\n   * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource}\n   * declarations for all resources in the container, including children.\n   */\n  getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl>;\n\n  /**\n   * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate}\n   * declarations for all resources in the container, including children.\n   */\n  getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl>;\n}\n"]}

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

@@ -12,6 +12,10 @@ export declare class ResourceDeclTree implements IResourceDeclContainer {
      * being processed.
      */
     readonly tree: Normalized.IResourceTreeRootDecl;
+    /**
+     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     */
+    get context(): Normalized.IContainerContextDecl | undefined;
     protected _resources: Normalized.ILooseResourceDecl[];
     protected _candidates: Normalized.ILooseResourceCandidateDecl[];
     protected constructor(tree: Normalized.IResourceTreeRootDecl);
@@ -27,13 +31,13 @@ export declare class ResourceDeclTree implements IResourceDeclContainer {
      * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}
      * extracted from the collection.
      */
-    getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl>;
+    getImporterResources(): ReadonlyArray<Normalized.ILooseResourceDecl>;
     /**
      * Gets the loose candidates extracted from the collection.
      * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}
      * extracted from the collection.
      */
-    getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl>;
+    getImporterCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl>;
     private _extract;
 }
 //# sourceMappingURL=resourceDeclTree.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resourceDeclTree.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgD,MAAM,EAAW,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAK3C;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,sBAAsB;IAC7D;;;OAGG;IACH,SAAgB,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC;IAEvD,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,kBAAkB,EAAE,CAAM;IAC3D,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,2BAA2B,EAAE,CAAM;IAErE,SAAS,aAAa,IAAI,EAAE,UAAU,CAAC,qBAAqB;IAK5D;;;;;OAKG;WACW,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAS7D;;;;OAIG;IACI,iBAAiB,IAAI,aAAa,CAAC,UAAU,CAAC,kBAAkB,CAAC;IAIxE;;;;OAIG;IACI,kBAAkB,IAAI,aAAa,CAAC,UAAU,CAAC,2BAA2B,CAAC;IAIlF,OAAO,CAAC,QAAQ;CAuBjB"}
+{"version":3,"file":"resourceDeclTree.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgD,MAAM,EAAW,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAK3C;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,sBAAsB;IAC7D;;;OAGG;IACH,SAAgB,IAAI,EAAE,UAAU,CAAC,qBAAqB,CAAC;IAEvD;;OAEG;IACH,IAAW,OAAO,IAAI,UAAU,CAAC,qBAAqB,GAAG,SAAS,CAEjE;IAED,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,kBAAkB,EAAE,CAAM;IAC3D,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,2BAA2B,EAAE,CAAM;IAErE,SAAS,aAAa,IAAI,EAAE,UAAU,CAAC,qBAAqB;IAO5D;;;;;OAKG;WACW,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAS7D;;;;OAIG;IACI,oBAAoB,IAAI,aAAa,CAAC,UAAU,CAAC,kBAAkB,CAAC;IAI3E;;;;OAIG;IACI,qBAAqB,IAAI,aAAa,CAAC,UAAU,CAAC,2BAA2B,CAAC;IAIrF,OAAO,CAAC,QAAQ;CAuBjB"}

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

@@ -65,11 +65,20 @@ const helpers_1 = require("./helpers");
  * @public
  */
 class ResourceDeclTree {
+    /**
+     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     */
+    get context() {
+        return this.tree.context;
+    }
     constructor(tree) {
+        var _a, _b;
         this._resources = [];
         this._candidates = [];
         this.tree = tree;
-        this._extract(tree, tree.baseName).orThrow();
+        const id = (_a = tree.context) === null || _a === void 0 ? void 0 : _a.baseId;
+        const conditions = (_b = tree.context) === null || _b === void 0 ? void 0 : _b.conditions;
+        this._extract(tree, id, conditions).orThrow();
     }
     /**
      * Creates a new {@link ResourceJson.ResourceDeclTree | ResourceDeclTree} from an
@@ -90,7 +99,7 @@ class ResourceDeclTree {
      * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}
      * extracted from the collection.
      */
-    getLooseResources() {
+    getImporterResources() {
         return this._resources;
     }
     /**
@@ -98,7 +107,7 @@ class ResourceDeclTree {
      * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}
      * extracted from the collection.
      */
-    getLooseCandidates() {
+    getImporterCandidates() {
         return this._candidates;
     }
     _extract(node, parentName, parentConditions) {

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

@@ -1 +1 @@
-{"version":3,"file":"resourceDeclTree.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclTree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA8F;AAE9F,mDAAqC;AAGrC,sCAAqD;AACrD,uCAA+C;AAE/C;;;;GAIG;AACH,MAAa,gBAAgB;IAU3B,YAAsB,IAAsC;QAHlD,eAAU,GAAoC,EAAE,CAAC;QACjD,gBAAW,GAA6C,EAAE,CAAC;QAGnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,IAAa;QAChC,OAAO,OAAO,CAAC,oBAAoB;aAChC,OAAO,CAAC,IAAI,CAAC;aACb,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0BAA0B,GAAG,EAAE,CAAC;aACzD,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,kBAAkB;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,QAAQ,CACd,IAA2C,EAC3C,UAAmB,EACnB,gBAA6C;;QAE7C,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAE1D,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC/D,IAAA,4BAAkB,EAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,CAAC,CACjE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,eAAe,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAE1F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,CAAC;QACjE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE;YACrC,gBAAa,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC;iBAC5C,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;gBACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACtF,CAAC,CAAC;iBACD,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF;AAvED,4CAuEC","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 { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport { mergeChildResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root}.\n * @public\n */\nexport class ResourceDeclTree implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}\n   * being processed.\n   */\n  public readonly tree: Normalized.IResourceTreeRootDecl;\n\n  protected _resources: Normalized.ILooseResourceDecl[] = [];\n  protected _candidates: Normalized.ILooseResourceCandidateDecl[] = [];\n\n  protected constructor(tree: Normalized.IResourceTreeRootDecl) {\n    this.tree = tree;\n    this._extract(tree, tree.baseName).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclTree | ResourceDeclTree} from an\n   * untyped {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new tree if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclTree> {\n    return Convert.resourceTreeRootDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource tree: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclTree(decl));\n      });\n  }\n\n  /**\n   * Gets the loose resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}\n   * extracted from the collection.\n   */\n  public getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the loose candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    node: Normalized.IResourceTreeChildNodeDecl,\n    parentName?: string,\n    parentConditions?: Json.ILooseConditionDecl[]\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n\n    const resourceEntries = Array.from(Object.entries(node.resources ?? {}));\n    const mergedResources = resourceEntries.map(([name, resource]) =>\n      mergeChildResource(resource, name, parentName, parentConditions)\n    );\n    this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n    const children = Array.from(Object.entries(node.children ?? {}));\n    children.forEach(([name, childNode]) => {\n      CommonHelpers.joinResourceIds(parentName, name)\n        .onSuccess((childName) => {\n          return this._extract(childNode, childName, parentConditions).aggregateError(errors);\n        })\n        .aggregateError(errors);\n    });\n    return errors.returnOrReport(succeed(this));\n  }\n}\n"]}
+{"version":3,"file":"resourceDeclTree.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclTree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA8F;AAE9F,mDAAqC;AAGrC,sCAAqD;AACrD,uCAA+C;AAE/C;;;;GAIG;AACH,MAAa,gBAAgB;IAO3B;;OAEG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC3B,CAAC;IAKD,YAAsB,IAAsC;;QAHlD,eAAU,GAAoC,EAAE,CAAC;QACjD,gBAAW,GAA6C,EAAE,CAAC;QAGnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,EAAE,GAAG,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,CAAC;QAChC,MAAM,UAAU,GAAG,MAAA,IAAI,CAAC,OAAO,0CAAE,UAAU,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,IAAa;QAChC,OAAO,OAAO,CAAC,oBAAoB;aAChC,OAAO,CAAC,IAAI,CAAC;aACb,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0BAA0B,GAAG,EAAE,CAAC;aACzD,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,QAAQ,CACd,IAA2C,EAC3C,UAAmB,EACnB,gBAA0D;;QAE1D,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAE1D,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC/D,IAAA,4BAAkB,EAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,CAAC,CACjE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,eAAe,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAE1F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,CAAC;QACjE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE;YACrC,gBAAa,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC;iBAC5C,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;gBACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACtF,CAAC,CAAC;iBACD,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF;AAhFD,4CAgFC","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 { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport { mergeChildResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root}.\n * @public\n */\nexport class ResourceDeclTree implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}\n   * being processed.\n   */\n  public readonly tree: Normalized.IResourceTreeRootDecl;\n\n  /**\n   * {@inheritdoc ResourceJson.IResourceDeclContainer.context}\n   */\n  public get context(): Normalized.IContainerContextDecl | undefined {\n    return this.tree.context;\n  }\n\n  protected _resources: Normalized.ILooseResourceDecl[] = [];\n  protected _candidates: Normalized.ILooseResourceCandidateDecl[] = [];\n\n  protected constructor(tree: Normalized.IResourceTreeRootDecl) {\n    this.tree = tree;\n    const id = tree.context?.baseId;\n    const conditions = tree.context?.conditions;\n    this._extract(tree, id, conditions).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclTree | ResourceDeclTree} from an\n   * untyped {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new tree if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclTree> {\n    return Convert.resourceTreeRootDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource tree: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclTree(decl));\n      });\n  }\n\n  /**\n   * Gets the loose resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}\n   * extracted from the collection.\n   */\n  public getImporterResources(): ReadonlyArray<Normalized.ILooseResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the loose candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getImporterCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    node: Normalized.IResourceTreeChildNodeDecl,\n    parentName?: string,\n    parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n\n    const resourceEntries = Array.from(Object.entries(node.resources ?? {}));\n    const mergedResources = resourceEntries.map(([name, resource]) =>\n      mergeChildResource(resource, name, parentName, parentConditions)\n    );\n    this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n    const children = Array.from(Object.entries(node.children ?? {}));\n    children.forEach(([name, childNode]) => {\n      CommonHelpers.joinResourceIds(parentName, name)\n        .onSuccess((childName) => {\n          return this._extract(childNode, childName, parentConditions).aggregateError(errors);\n        })\n        .aggregateError(errors);\n    });\n    return errors.returnOrReport(succeed(this));\n  }\n}\n"]}

package/lib/packlets/resource-types/config/convert.d.ts

@@ -0,0 +1,8 @@
+import { IResourceTypeConfig } from './json';
+/**
+ * A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.
+ * @returns A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.
+ * @public
+ */
+export declare const resourceTypeConfig: import("@fgv/ts-utils").ObjectConverter<IResourceTypeConfig, unknown>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/packlets/resource-types/config/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/convert.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,uEAG7B,CAAC"}

package/lib/packlets/resource-types/config/convert.js

@@ -0,0 +1,36 @@
+"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.resourceTypeConfig = void 0;
+/* eslint-disable @rushstack/typedef-var */
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.
+ * @returns A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.
+ * @public
+ */
+exports.resourceTypeConfig = ts_utils_1.Converters.strictObject({
+    name: ts_utils_1.Converters.string,
+    typeName: ts_utils_1.Converters.string
+});
+//# sourceMappingURL=convert.js.map

package/lib/packlets/resource-types/config/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/convert.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,2CAA2C;AAE3C,4CAA2C;AAG3C;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,qBAAU,CAAC,YAAY,CAAsB;IAC7E,IAAI,EAAE,qBAAU,CAAC,MAAM;IACvB,QAAQ,EAAE,qBAAU,CAAC,MAAM;CAC5B,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/* eslint-disable @rushstack/typedef-var */\n\nimport { Converters } from '@fgv/ts-utils';\nimport { IResourceTypeConfig } from './json';\n\n/**\n * A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.\n * @returns A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.\n * @public\n */\nexport const resourceTypeConfig = Converters.strictObject<IResourceTypeConfig>({\n  name: Converters.string,\n  typeName: Converters.string\n});\n"]}

package/lib/packlets/resource-types/config/index.d.ts

@@ -0,0 +1,4 @@
+import * as Convert from './convert';
+export * from './json';
+export { Convert };
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/resource-types/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,cAAc,QAAQ,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,CAAC"}