@fgv/ts-res 4.5.0-0

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

@@ -0,0 +1,182 @@
+import { JsonObject } from '@fgv/ts-json-base';
+import { ConditionOperator, ResourceValueMergeMethod } from '../common';
+/**
+ * Non-validated loose declaration of a {@link Conditions.Condition | condition}.
+ * @public
+ */
+export interface ILooseConditionDecl {
+    /**
+     * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.
+     */
+    qualifierName: string;
+    /**
+     * The value to be compared.
+     */
+    value: string;
+    /**
+     * The operator to be used in the comparison.
+     * Default is 'matches'.
+     */
+    operator?: ConditionOperator;
+    /**
+     * The priority of the condition. Default is the default priority for the qualifier.
+     */
+    priority?: number;
+    /**
+     * The score to be used if the condition is used as a default.
+     */
+    scoreAsDefault?: number;
+}
+/**
+ * Non-validated child declaration of a {@link Conditions.Condition | condition}.
+ * @public
+ */
+export interface IChildConditionDecl {
+    /**
+     * The value to be compared.
+     */
+    value: string;
+    /**
+     * The operator to be used in the comparison.
+     * Default is 'matches'.
+     */
+    operator?: ConditionOperator;
+    /**
+     * The priority of the condition. Default is the default priority for the qualifier.
+     */
+    priority?: number;
+    /**
+     * The score to be used if the condition is used as a default.
+     */
+    scoreAsDefault?: number;
+}
+/**
+ * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ * @public
+ */
+export type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;
+/**
+ * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ * @public
+ */
+export type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;
+/**
+ * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ * @public
+ */
+export type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;
+/**
+ * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.
+ * @public
+ */
+export interface IChildResourceCandidateDecl {
+    /**
+     * The JSON value of the resource.
+     */
+    readonly json: JsonObject;
+    /**
+     * The conditions that must be met for the resource to be selected.
+     */
+    readonly conditions?: ConditionSetDecl;
+    /**
+     * If true, the resource is only a partial representation of the full resource.
+     */
+    readonly isPartial?: boolean;
+    /**
+     * The merge method to be used when merging the resource into the existing resource.
+     * default is 'augment'.
+     */
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
+/**
+ * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.
+ * @public
+ */
+export interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {
+    /**
+     * The {@link ResourceId | id} of the resource.
+     */
+    readonly id: string;
+    /**
+     * The JSON value of the resource.
+     */
+    readonly json: JsonObject;
+    /**
+     * The conditions that must be met for the resource to be selected.
+     */
+    readonly conditions?: ConditionSetDecl;
+    /**
+     * If true, the resource is only a partial representation of the full resource.
+     */
+    readonly isPartial?: boolean;
+    /**
+     * The merge method to be used when merging the resource into the existing resource.
+     * default is 'augment'.
+     */
+    readonly mergeMethod?: ResourceValueMergeMethod;
+    /**
+     * The type of the resource.
+     */
+    readonly resourceTypeName?: string;
+}
+/**
+ * Non-validated child declaration of a {@link Resources.Resource | resource}.
+ * @public
+ */
+export interface IChildResourceDecl {
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName: string;
+    /**
+     * Possible candidates for this value.
+     */
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+}
+/**
+ * Non-validated loose declaration of a {@link Resources.Resource | resource}.
+ * @public
+ */
+export interface ILooseResourceDecl extends IChildResourceDecl {
+    /**
+     * The id of the resource.
+     */
+    readonly id: string;
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName: string;
+    /**
+     * Possible candidates for this value.
+     */
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+}
+/**
+ * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.
+ * @public
+ */
+export interface IResourceTreeChildNodeDecl {
+    readonly resources?: Record<string, IChildResourceDecl>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+}
+/**
+ * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.
+ * @public
+ */
+export interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
+    readonly baseName?: string;
+    readonly resources?: Record<string, IChildResourceDecl>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+}
+/**
+ * Non-validated declaration of a collection of resources.
+ * @public
+ */
+export interface IResourceCollectionDecl {
+    readonly baseName?: string;
+    readonly baseConditions?: ConditionSetDecl;
+    readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
+    readonly resources?: ReadonlyArray<ILooseResourceDecl>;
+    readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+}
+//# sourceMappingURL=json.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+"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 });
+//# sourceMappingURL=json.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,123 @@
+import { JsonObject } from '@fgv/ts-json-base';
+import { ResourceValueMergeMethod } from '../common';
+import { ILooseConditionDecl } from './json';
+/**
+ * Normalized non-validated declaration of a {@link Conditions.Condition | condition}.
+ * @public
+ */
+export type ConditionSetDecl = ReadonlyArray<ILooseConditionDecl>;
+/**
+ * Normalized non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.
+ * @public
+ */
+export interface IChildResourceCandidateDecl {
+    /**
+     * The JSON value of the resource.
+     */
+    readonly json: JsonObject;
+    /**
+     * The conditions that must be met for the resource to be selected.
+     */
+    readonly conditions?: ConditionSetDecl;
+    /**
+     * If true, the resource is only a partial representation of the full resource.
+     */
+    readonly isPartial?: boolean;
+    /**
+     * The merge method to be used when merging the resource into the existing resource.
+     * default is 'augment'.
+     */
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
+/**
+ * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.
+ * @public
+ */
+export interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {
+    /**
+     * The {@link ResourceId | id} of the resource.
+     */
+    readonly id: string;
+    /**
+     * The JSON value of the resource.
+     */
+    readonly json: JsonObject;
+    /**
+     * The conditions that must be met for the resource to be selected.
+     */
+    readonly conditions?: ConditionSetDecl;
+    /**
+     * If true, the resource is only a partial representation of the full resource.
+     */
+    readonly isPartial?: boolean;
+    /**
+     * The merge method to be used when merging the resource into the existing resource.
+     * default is 'augment'.
+     */
+    readonly mergeMethod?: ResourceValueMergeMethod;
+    /**
+     * The type of the resource.
+     */
+    readonly resourceTypeName?: string;
+}
+/**
+ * Normalized non-validated child declaration of a {@link Resources.Resource | resource}.
+ * @public
+ */
+export interface IChildResourceDecl {
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName: string;
+    /**
+     * Possible candidates for this value.
+     */
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+}
+/**
+ * Normalized non-validated loose declaration of a {@link Resources.Resource | resource}.
+ * @public
+ */
+export interface ILooseResourceDecl extends IChildResourceDecl {
+    /**
+     * The id of the resource.
+     */
+    readonly id: string;
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName: string;
+    /**
+     * Possible candidates for this value.
+     */
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+}
+/**
+ * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.
+ * @public
+ */
+export interface IResourceTreeChildNodeDecl {
+    readonly resources?: Record<string, IChildResourceDecl>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+}
+/**
+ * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.
+ * @public
+ */
+export interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
+    readonly baseName?: string;
+    readonly resources?: Record<string, IChildResourceDecl>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+}
+/**
+ * Normalized non-validated declaration of a collection of resources.
+ * @public
+ */
+export interface IResourceCollectionDecl {
+    readonly baseName?: string;
+    readonly baseConditions?: ConditionSetDecl;
+    readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
+    readonly resources?: ReadonlyArray<ILooseResourceDecl>;
+    readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+}
+//# sourceMappingURL=normalized.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+"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 });
+//# sourceMappingURL=normalized.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,39 @@
+import { Result } from '@fgv/ts-utils';
+import { IResourceDeclContainer } from './resourceDeclContainer';
+import * as Normalized from './normalized';
+/**
+ * Class that extracts resources and candidates from a
+ * {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
+ * @public
+ */
+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);
+    /**
+     * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an
+     * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
+     * @param from - The JSON object to convert.
+     * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.
+     */
+    static create(from: unknown): Result<ResourceDeclCollection>;
+    /**
+     * Gets the loose resources extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}
+     * extracted from the collection.
+     */
+    getLooseResources(): 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>;
+    private _extract;
+}
+//# sourceMappingURL=resourceDeclCollection.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,121 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.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
+ * {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
+ * @public
+ */
+class ResourceDeclCollection {
+    constructor(collection) {
+        this._resources = [];
+        this._candidates = [];
+        this.collection = collection;
+        this._extract(collection).orThrow();
+    }
+    /**
+     * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an
+     * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
+     * @param from - The JSON object to convert.
+     * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.
+     */
+    static create(from) {
+        return Convert.resourceCollectionDecl
+            .convert(from)
+            .withErrorFormat((err) => `Invalid resource collection: ${err}`)
+            .onSuccess((decl) => {
+            return (0, ts_utils_1.captureResult)(() => new ResourceDeclCollection(decl));
+        });
+    }
+    /**
+     * Gets the loose resources extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}
+     * extracted from the collection.
+     */
+    getLooseResources() {
+        return this._resources;
+    }
+    /**
+     * Gets the loose candidates extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}
+     * extracted from the collection.
+     */
+    getLooseCandidates() {
+        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 : [];
+            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 : [];
+            this._resources.push(...(0, ts_utils_1.mapResults)(mergedResources).aggregateError(errors).orDefault([]));
+            (_f = collection.collections) === null || _f === void 0 ? void 0 : _f.forEach((subCollection) => {
+                this._extract(subCollection, baseName, baseConditions).aggregateError(errors);
+            });
+            return errors.returnOrReport((0, ts_utils_1.succeed)(this));
+        });
+    }
+}
+exports.ResourceDeclCollection = ResourceDeclCollection;
+//# sourceMappingURL=resourceDeclCollection.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,11 @@
+import * as Normalized from './normalized';
+/**
+ * Generic container for resource and resource candidate
+ * declarations.
+ * @public
+ */
+export interface IResourceDeclContainer {
+    getLooseResources(): ReadonlyArray<Normalized.ILooseResourceDecl>;
+    getLooseCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl>;
+}
+//# sourceMappingURL=resourceDeclContainer.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,24 @@
+"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 });
+//# sourceMappingURL=resourceDeclContainer.js.map

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

@@ -0,0 +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"]}