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

package/lib/packlets/resources/resource.js

@@ -25,12 +25,26 @@ exports.Resource = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const common_1 = require("../common");
 const resourceCandidate_1 = require("./resourceCandidate");
+const candidateReducer_1 = require("./candidateReducer");
+const decisions_1 = require("../decisions");
 /**
  * Represents a single logical resource, with a unique id and a set of possible
  * candidate instances.
  * @public
  */
 class Resource {
+    /**
+     * Gets the resource type (implements IResource interface).
+     */
+    get resourceType() {
+        return this._resourceType;
+    }
+    /**
+     * Gets the resource type name as a string.
+     */
+    get resourceTypeName() {
+        return this._resourceType.key;
+    }
     /**
      * Constructor for a {@link Resources.Resource | Resource} object.
      * @param params - {@link Resources.IResourceCreateParams | Parameters} used to create the resource.
@@ -39,8 +53,9 @@ class Resource {
     constructor(params) {
         const id = params.id ? common_1.Validate.toResourceId(params.id).orThrow() : undefined;
         this.id = Resource._validateCandidateResourceIds(id, params.candidates).orThrow();
-        this.resourceType = resourceCandidate_1.ResourceCandidate.validateResourceTypes(params.candidates, params.resourceType)
+        this._resourceType = resourceCandidate_1.ResourceCandidate.validateResourceTypes(params.candidates, params.resourceType)
             .onSuccess((t) => {
+            /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
             if (t === undefined) {
                 return (0, ts_utils_1.fail)(`${params.id}: no type specified and no candidates with types.`);
             }
@@ -48,6 +63,7 @@ class Resource {
         })
             .orThrow();
         this.candidates = Resource._validateAndNormalizeCandidates(params.candidates).orThrow();
+        this.decision = Resource._createOptimizedDecision(this.candidates, params.decisions).orThrow();
     }
     /**
      * Creates a new {@link Resources.Resource | Resource} object.
@@ -59,23 +75,61 @@ class Resource {
     static create(params) {
         return (0, ts_utils_1.captureResult)(() => new Resource(params));
     }
+    /**
+     * Gets the candidates for this resource that match the specified {@link Context.IValidatedContextDecl | context}.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns The array of {@link Resources.ResourceCandidate | candidates} that match the context.
+     */
+    getCandidatesForContext(context, options) {
+        return this.candidates.filter((c) => c.canMatchPartialContext(context, options));
+    }
     /**
      * Gets the {@link ResourceJson.Json.IChildResourceDecl | child resource declaration} for this resource.
      * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the declaration.
      * @returns The {@link ResourceJson.Json.IChildResourceDecl | child resource declaration}.
      */
     toChildResourceDecl(options) {
-        const candidates = this.candidates.map((c) => c.toChildResourceCandidateDecl(options));
-        return Object.assign({ resourceTypeName: this.resourceType.key }, (candidates.length > 0 ? { candidates } : {}));
+        /* c8 ignore next 1 - defense in depth */
+        options = options !== null && options !== void 0 ? options : {};
+        const matches = this._getMatchingCandidates(options);
+        const candidates = options.reduceQualifiers
+            ? candidateReducer_1.CandidateReducer.reduceToChildResourceCandidateDecls(matches, options.filterForContext).orThrow()
+            : matches.map((c) => c.toChildResourceCandidateDecl());
+        return Object.assign({ resourceTypeName: this.resourceTypeName }, (candidates.length > 0 ? { candidates } : {}));
     }
     /**
      * Gets the {@link ResourceJson.Json.ILooseResourceDecl | loose resource declaration} for this resource.
-     * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the declaration.
+     * @param options - {@link Resources.IResourceDeclarationOptions | options} for the declaration.
      * @returns The {@link ResourceJson.Json.ILooseResourceDecl | loose resource declaration}.
      */
     toLooseResourceDecl(options) {
-        const candidates = this.candidates.map((c) => c.toChildResourceCandidateDecl(options));
-        return Object.assign({ id: this.id, resourceTypeName: this.resourceType.key }, (candidates.length > 0 ? { candidates } : {}));
+        /* c8 ignore next 1 - defense in depth */
+        options = options !== null && options !== void 0 ? options : {};
+        const matches = this._getMatchingCandidates(options);
+        const candidates = options.reduceQualifiers
+            ? candidateReducer_1.CandidateReducer.reduceToChildResourceCandidateDecls(matches, options.filterForContext).orThrow()
+            : matches.map((c) => c.toChildResourceCandidateDecl());
+        return Object.assign({ id: this.id, resourceTypeName: this.resourceTypeName }, (candidates.length > 0 ? { candidates } : {}));
+    }
+    /**
+     * Converts this resource to a compiled resource representation.
+     * @param options - Optional compilation options controlling the output format and filtering.
+     * @returns A compiled resource object that can be used for serialization or runtime processing.
+     * @public
+     */
+    toCompiled(options) {
+        const candidates = this._getMatchingCandidates(options).map((c) => ({
+            json: c.json,
+            isPartial: c.isPartial,
+            mergeMethod: c.mergeMethod
+        }));
+        return {
+            id: this.id,
+            type: this.resourceType.index,
+            decision: this.decision.baseDecision.index,
+            candidates
+        };
     }
     /**
      * Validates that all candidates have the same id as the resource.
@@ -86,16 +140,36 @@ class Resource {
      * @internal
      */
     static _validateCandidateResourceIds(resourceId, candidates) {
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (!resourceId && candidates.length === 0) {
             return (0, ts_utils_1.fail)('unknown: no resource id and no candidates.');
         }
         resourceId = resourceId !== null && resourceId !== void 0 ? resourceId : candidates[0].id;
         const mismatched = candidates.filter((c) => c.id !== resourceId).map((c) => c.id);
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (mismatched.length > 0) {
             return (0, ts_utils_1.fail)(`${resourceId}: candidates with mismatched ids ${mismatched.join(', ')}.`);
         }
         return (0, ts_utils_1.succeed)(resourceId);
     }
+    /**
+     * Creates an optimized decision for the given candidates using the decisions collector.
+     * @param candidates - The validated and normalized candidates to create a decision for.
+     * @param decisions - The {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} to use.
+     * @returns `Success` with the {@link Decisions.ConcreteDecision | ConcreteDecision} if successful,
+     * `Failure` with an error message otherwise.
+     * @internal
+     */
+    static _createOptimizedDecision(candidates, decisions) {
+        const decisionCandidates = candidates.map((c) => ({
+            conditionSet: c.conditions,
+            value: c.json
+        }));
+        return decisions_1.ConcreteDecision.create({
+            decisions,
+            candidates: decisionCandidates
+        });
+    }
     /**
      * Validates and normalizes an array of {@link Resources.ResourceCandidate | candidates}. Fails if there
      * are multiple candidates for the same set of conditions.
@@ -111,6 +185,7 @@ class Resource {
             const conditionSetString = candidate.conditions.toString();
             const existing = validated.get(conditionSetString);
             if (existing) {
+                /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
                 if (!resourceCandidate_1.ResourceCandidate.equal(candidate, existing)) {
                     errors.addMessage(`${candidate.id}: duplicate candidates for ${conditionSetString}.`);
                 }
@@ -121,6 +196,21 @@ class Resource {
         }
         return errors.returnOrReport((0, ts_utils_1.succeed)(Array.from(validated.values()).sort(resourceCandidate_1.ResourceCandidate.compare).reverse()));
     }
+    /**
+     * Gets the appropriate candidates based on filtering options.
+     * If a validated filter context is provided, returns only matching candidates.
+     * Otherwise returns all candidates.
+     * @param options - Options that may contain a validated filter context
+     * @returns The filtered array of candidates
+     * @internal
+     */
+    _getMatchingCandidates(options) {
+        /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */
+        if (options === null || options === void 0 ? void 0 : options.filterForContext) {
+            return this.candidates.filter((candidate) => candidate.canMatchPartialContext(options.filterForContext, { partialContextMatch: true }));
+        }
+        return this.candidates;
+    }
 }
 exports.Resource = Resource;
 //# sourceMappingURL=resource.js.map

package/lib/packlets/resources/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/packlets/resources/resource.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { MessageAggregator, Result, captureResult, fail, succeed } from '@fgv/ts-utils';\nimport { ResourceId, Validate } from '../common';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { ResourceType } from '../resource-types';\nimport * as ResourceJson from '../resource-json';\n\n/**\n * Parameters used to create a {@link Resources.Resource | Resource} object.\n * @public\n */\nexport interface IResourceCreateParams {\n  /**\n   * The id of the resource.\n   */\n  id?: string;\n  /**\n   * Optional {@link ResourceTypes.ResourceType | type} of the resource. If not specified, the type will be inferred\n   * from the candidates.\n   */\n  resourceType?: ResourceType;\n  /**\n   * Array of {@link Resources.ResourceCandidate | candidates} for the resource.\n   */\n  candidates: ReadonlyArray<ResourceCandidate>;\n}\n\n/**\n * Represents a single logical resource, with a unique id and a set of possible\n * candidate instances.\n * @public\n */\nexport class Resource {\n  /**\n   * The unique {@link ResourceId | id} of the resource.\n   */\n  public readonly id: ResourceId;\n  /**\n   * The {@link ResourceTypes.ResourceType | type} of the resource.\n   */\n  public readonly resourceType: ResourceType;\n  /**\n   * The array of {@link Resources.ResourceCandidate | candidates} for the resource.\n   */\n  public readonly candidates: ReadonlyArray<ResourceCandidate>;\n\n  /**\n   * Constructor for a {@link Resources.Resource | Resource} object.\n   * @param params - {@link Resources.IResourceCreateParams | Parameters} used to create the resource.\n   * @public\n   */\n  protected constructor(params: IResourceCreateParams) {\n    const id = params.id ? Validate.toResourceId(params.id).orThrow() : undefined;\n    this.id = Resource._validateCandidateResourceIds(id, params.candidates).orThrow();\n    this.resourceType = ResourceCandidate.validateResourceTypes(params.candidates, params.resourceType)\n      .onSuccess((t) => {\n        if (t === undefined) {\n          return fail<ResourceType>(`${params.id}: no type specified and no candidates with types.`);\n        }\n        return succeed(t);\n      })\n      .orThrow();\n\n    this.candidates = Resource._validateAndNormalizeCandidates(params.candidates).orThrow();\n  }\n\n  /**\n   * Creates a new {@link Resources.Resource | Resource} object.\n   * @param params - {@link Resources.IResourceCreateParams | Parameters} used to create the resource.\n   * @returns `Success` with the new {@link Resources.Resource | Resource} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceCreateParams): Result<Resource> {\n    return captureResult(() => new Resource(params));\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.IChildResourceDecl | child resource declaration} for this resource.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the declaration.\n   * @returns The {@link ResourceJson.Json.IChildResourceDecl | child resource declaration}.\n   */\n  public toChildResourceDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.IChildResourceDecl {\n    const candidates = this.candidates.map((c) => c.toChildResourceCandidateDecl(options));\n    return {\n      resourceTypeName: this.resourceType.key,\n      ...(candidates.length > 0 ? { candidates } : {})\n    };\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ILooseResourceDecl | loose resource declaration} for this resource.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the declaration.\n   * @returns The {@link ResourceJson.Json.ILooseResourceDecl | loose resource declaration}.\n   */\n  public toLooseResourceDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.ILooseResourceDecl {\n    const candidates = this.candidates.map((c) => c.toChildResourceCandidateDecl(options));\n    return {\n      id: this.id,\n      resourceTypeName: this.resourceType.key,\n      ...(candidates.length > 0 ? { candidates } : {})\n    };\n  }\n\n  /**\n   * Validates that all candidates have the same id as the resource.\n   * @param resourceId - The expected id of the resource.\n   * @param candidates - The array of candidates to validate.\n   * @returns `Success` with the resource id if all candidates have the same id,\n   * `Failure` with an error message otherwise.\n   * @internal\n   */\n  private static _validateCandidateResourceIds(\n    resourceId: ResourceId | undefined,\n    candidates: ReadonlyArray<ResourceCandidate>\n  ): Result<ResourceId> {\n    if (!resourceId && candidates.length === 0) {\n      return fail('unknown: no resource id and no candidates.');\n    }\n    resourceId = resourceId ?? candidates[0].id;\n\n    const mismatched = candidates.filter((c) => c.id !== resourceId).map((c) => c.id);\n    if (mismatched.length > 0) {\n      return fail(`${resourceId}: candidates with mismatched ids ${mismatched.join(', ')}.`);\n    }\n    return succeed(resourceId);\n  }\n\n  /**\n   * Validates and normalizes an array of {@link Resources.ResourceCandidate | candidates}. Fails if there\n   * are multiple candidates for the same set of conditions.\n   * @param candidates - The array of candidates to validate.\n   * @returns `Success` with the validated and sorted array of candidates if successful,\n   * `Failure` with an error message otherwise.\n   * @internal\n   */\n  private static _validateAndNormalizeCandidates(\n    candidates: ReadonlyArray<ResourceCandidate>\n  ): Result<ReadonlyArray<ResourceCandidate>> {\n    const errors = new MessageAggregator();\n    const validated: Map<string, ResourceCandidate> = new Map();\n\n    for (const candidate of candidates) {\n      const conditionSetString = candidate.conditions.toString();\n      const existing = validated.get(conditionSetString);\n      if (existing) {\n        if (!ResourceCandidate.equal(candidate, existing)) {\n          errors.addMessage(`${candidate.id}: duplicate candidates for ${conditionSetString}.`);\n        }\n      } else {\n        validated.set(conditionSetString, candidate);\n      }\n    }\n    return errors.returnOrReport(\n      succeed(Array.from(validated.values()).sort(ResourceCandidate.compare).reverse())\n    );\n  }\n}\n"]}
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/packlets/resources/resource.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { MessageAggregator, Result, captureResult, fail, succeed } from '@fgv/ts-utils';\nimport { ResourceId, Validate } from '../common';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { CandidateReducer } from './candidateReducer';\nimport { ResourceType } from '../resource-types';\nimport { ConcreteDecision, AbstractDecisionCollector } from '../decisions';\nimport { IResource } from '../runtime';\nimport { IResourceDeclarationOptions, ICompiledResourceOptionsWithFilter } from './common';\nimport * as ResourceJson from '../resource-json';\nimport * as Context from '../context';\n\n/**\n * Parameters used to create a {@link Resources.Resource | Resource} object.\n * @public\n */\nexport interface IResourceCreateParams {\n  /**\n   * The id of the resource.\n   */\n  id?: string;\n  /**\n   * Optional {@link ResourceTypes.ResourceType | type} of the resource. If not specified, the type will be inferred\n   * from the candidates.\n   */\n  resourceType?: ResourceType;\n  /**\n   * Array of {@link Resources.ResourceCandidate | candidates} for the resource.\n   */\n  candidates: ReadonlyArray<ResourceCandidate>;\n  /**\n   * {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} used to create the optimized decision.\n   */\n  decisions: AbstractDecisionCollector;\n}\n\n/**\n * Represents a single logical resource, with a unique id and a set of possible\n * candidate instances.\n * @public\n */\nexport class Resource implements IResource {\n  /**\n   * The unique {@link ResourceId | id} of the resource.\n   */\n  public readonly id: ResourceId;\n  /**\n   * The {@link ResourceTypes.ResourceType | type} of the resource.\n   */\n  public readonly _resourceType: ResourceType;\n  /**\n   * The array of {@link Resources.ResourceCandidate | candidates} for the resource.\n   */\n  public readonly candidates: ReadonlyArray<ResourceCandidate>;\n  /**\n   * {@link Decisions.ConcreteDecision | Decision} for optimized resource resolution.\n   */\n  public readonly decision: ConcreteDecision;\n\n  /**\n   * Gets the resource type (implements IResource interface).\n   */\n  public get resourceType(): ResourceType {\n    return this._resourceType;\n  }\n\n  /**\n   * Gets the resource type name as a string.\n   */\n  public get resourceTypeName(): string {\n    return this._resourceType.key;\n  }\n\n  /**\n   * Constructor for a {@link Resources.Resource | Resource} object.\n   * @param params - {@link Resources.IResourceCreateParams | Parameters} used to create the resource.\n   * @public\n   */\n  protected constructor(params: IResourceCreateParams) {\n    const id = params.id ? Validate.toResourceId(params.id).orThrow() : undefined;\n    this.id = Resource._validateCandidateResourceIds(id, params.candidates).orThrow();\n    this._resourceType = ResourceCandidate.validateResourceTypes(params.candidates, params.resourceType)\n      .onSuccess((t) => {\n        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n        if (t === undefined) {\n          return fail<ResourceType>(`${params.id}: no type specified and no candidates with types.`);\n        }\n        return succeed(t);\n      })\n      .orThrow();\n\n    this.candidates = Resource._validateAndNormalizeCandidates(params.candidates).orThrow();\n    this.decision = Resource._createOptimizedDecision(this.candidates, params.decisions).orThrow();\n  }\n\n  /**\n   * Creates a new {@link Resources.Resource | Resource} object.\n   * @param params - {@link Resources.IResourceCreateParams | Parameters} used to create the resource.\n   * @returns `Success` with the new {@link Resources.Resource | Resource} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceCreateParams): Result<Resource> {\n    return captureResult(() => new Resource(params));\n  }\n\n  /**\n   * Gets the candidates for this resource that match the specified {@link Context.IValidatedContextDecl | context}.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to match against.\n   * @param options - {@link Context.IContextMatchOptions | options} for the context match.\n   * @returns The array of {@link Resources.ResourceCandidate | candidates} that match the context.\n   */\n  public getCandidatesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): ReadonlyArray<ResourceCandidate> {\n    return this.candidates.filter((c) => c.canMatchPartialContext(context, options));\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.IChildResourceDecl | child resource declaration} for this resource.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the declaration.\n   * @returns The {@link ResourceJson.Json.IChildResourceDecl | child resource declaration}.\n   */\n  public toChildResourceDecl(options?: IResourceDeclarationOptions): ResourceJson.Json.IChildResourceDecl {\n    /* c8 ignore next 1 - defense in depth */\n    options = options ?? {};\n    const matches = this._getMatchingCandidates(options);\n\n    const candidates = options.reduceQualifiers\n      ? CandidateReducer.reduceToChildResourceCandidateDecls(matches, options.filterForContext).orThrow()\n      : matches.map((c) => c.toChildResourceCandidateDecl());\n\n    return {\n      resourceTypeName: this.resourceTypeName,\n      ...(candidates.length > 0 ? { candidates } : {})\n    };\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ILooseResourceDecl | loose resource declaration} for this resource.\n   * @param options - {@link Resources.IResourceDeclarationOptions | options} for the declaration.\n   * @returns The {@link ResourceJson.Json.ILooseResourceDecl | loose resource declaration}.\n   */\n  public toLooseResourceDecl(options?: IResourceDeclarationOptions): ResourceJson.Json.ILooseResourceDecl {\n    /* c8 ignore next 1 - defense in depth */\n    options = options ?? {};\n    const matches = this._getMatchingCandidates(options);\n\n    const candidates = options.reduceQualifiers\n      ? CandidateReducer.reduceToChildResourceCandidateDecls(matches, options.filterForContext).orThrow()\n      : matches.map((c) => c.toChildResourceCandidateDecl());\n\n    return {\n      id: this.id,\n      resourceTypeName: this.resourceTypeName,\n      ...(candidates.length > 0 ? { candidates } : {})\n    };\n  }\n\n  /**\n   * Converts this resource to a compiled resource representation.\n   * @param options - Optional compilation options controlling the output format and filtering.\n   * @returns A compiled resource object that can be used for serialization or runtime processing.\n   * @public\n   */\n  public toCompiled(\n    options?: IResourceDeclarationOptions | ICompiledResourceOptionsWithFilter\n  ): ResourceJson.Compiled.ICompiledResource {\n    const candidates: ResourceJson.Compiled.ICompiledCandidate[] = this._getMatchingCandidates(options).map(\n      (c) => ({\n        json: c.json,\n        isPartial: c.isPartial,\n        mergeMethod: c.mergeMethod\n      })\n    );\n\n    return {\n      id: this.id,\n      type: this.resourceType.index!,\n      decision: this.decision.baseDecision.index!,\n      candidates\n    };\n  }\n\n  /**\n   * Validates that all candidates have the same id as the resource.\n   * @param resourceId - The expected id of the resource.\n   * @param candidates - The array of candidates to validate.\n   * @returns `Success` with the resource id if all candidates have the same id,\n   * `Failure` with an error message otherwise.\n   * @internal\n   */\n  private static _validateCandidateResourceIds(\n    resourceId: ResourceId | undefined,\n    candidates: ReadonlyArray<ResourceCandidate>\n  ): Result<ResourceId> {\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (!resourceId && candidates.length === 0) {\n      return fail('unknown: no resource id and no candidates.');\n    }\n    resourceId = resourceId ?? candidates[0].id;\n\n    const mismatched = candidates.filter((c) => c.id !== resourceId).map((c) => c.id);\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (mismatched.length > 0) {\n      return fail(`${resourceId}: candidates with mismatched ids ${mismatched.join(', ')}.`);\n    }\n    return succeed(resourceId);\n  }\n\n  /**\n   * Creates an optimized decision for the given candidates using the decisions collector.\n   * @param candidates - The validated and normalized candidates to create a decision for.\n   * @param decisions - The {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} to use.\n   * @returns `Success` with the {@link Decisions.ConcreteDecision | ConcreteDecision} if successful,\n   * `Failure` with an error message otherwise.\n   * @internal\n   */\n  private static _createOptimizedDecision(\n    candidates: ReadonlyArray<ResourceCandidate>,\n    decisions: AbstractDecisionCollector\n  ): Result<ConcreteDecision> {\n    const decisionCandidates = candidates.map((c) => ({\n      conditionSet: c.conditions,\n      value: c.json\n    }));\n\n    return ConcreteDecision.create({\n      decisions,\n      candidates: decisionCandidates\n    });\n  }\n\n  /**\n   * Validates and normalizes an array of {@link Resources.ResourceCandidate | candidates}. Fails if there\n   * are multiple candidates for the same set of conditions.\n   * @param candidates - The array of candidates to validate.\n   * @returns `Success` with the validated and sorted array of candidates if successful,\n   * `Failure` with an error message otherwise.\n   * @internal\n   */\n  private static _validateAndNormalizeCandidates(\n    candidates: ReadonlyArray<ResourceCandidate>\n  ): Result<ReadonlyArray<ResourceCandidate>> {\n    const errors = new MessageAggregator();\n    const validated: Map<string, ResourceCandidate> = new Map();\n\n    for (const candidate of candidates) {\n      const conditionSetString = candidate.conditions.toString();\n      const existing = validated.get(conditionSetString);\n      if (existing) {\n        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n        if (!ResourceCandidate.equal(candidate, existing)) {\n          errors.addMessage(`${candidate.id}: duplicate candidates for ${conditionSetString}.`);\n        }\n      } else {\n        validated.set(conditionSetString, candidate);\n      }\n    }\n    return errors.returnOrReport(\n      succeed(Array.from(validated.values()).sort(ResourceCandidate.compare).reverse())\n    );\n  }\n\n  /**\n   * Gets the appropriate candidates based on filtering options.\n   * If a validated filter context is provided, returns only matching candidates.\n   * Otherwise returns all candidates.\n   * @param options - Options that may contain a validated filter context\n   * @returns The filtered array of candidates\n   * @internal\n   */\n  protected _getMatchingCandidates(\n    options?: IResourceDeclarationOptions | ICompiledResourceOptionsWithFilter\n  ): ReadonlyArray<ResourceCandidate> {\n    /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */\n    if (options?.filterForContext) {\n      return this.candidates.filter((candidate) =>\n        candidate.canMatchPartialContext(options.filterForContext!, { partialContextMatch: true })\n      );\n    }\n    return this.candidates;\n  }\n}\n"]}

package/lib/packlets/resources/resourceBuilder.d.ts

@@ -4,7 +4,9 @@ import { ResourceCandidate } from './resourceCandidate';
 import { ReadOnlyResourceTypeCollector, ResourceType } from '../resource-types';
 import { Resource } from './resource';
 import { ConditionSetCollector } from '../conditions';
+import { AbstractDecisionCollector } from '../decisions';
 import * as ResourceJson from '../resource-json';
+import * as Context from '../context';
 /**
  * Parameters for creating a {@link Resources.ResourceBuilder}.
  * @public
@@ -14,6 +16,7 @@ export interface IResourceBuilderCreateParams {
     typeName?: string;
     conditionSets: ConditionSetCollector;
     resourceTypes: ReadOnlyResourceTypeCollector;
+    decisions: AbstractDecisionCollector;
 }
 /**
  * Possible result details returned by the resource builder
@@ -59,6 +62,10 @@ export declare class ResourceBuilder {
      * Common collector for {@link Conditions.ConditionSet | condition sets}.
      */
     protected _conditionSets: ConditionSetCollector;
+    /**
+     * Collector for {@link Decisions.AbstractDecision | abstract decisions}.
+     */
+    protected _decisions: AbstractDecisionCollector;
     /**
      * Constructor for a {@link Resources.ResourceBuilder | ResourceBuilder} object.
      * @param params - Parameters to construct the new {@link Resources.ResourceBuilder | ResourceBuilder}.
@@ -72,6 +79,13 @@ export declare class ResourceBuilder {
      * @public
      */
     static create(params: IResourceBuilderCreateParams): Result<ResourceBuilder>;
+    /**
+     * Gets the {@link Resources.ResourceCandidate | candidates} that match a given {@link Context.IValidatedContextDecl | context}.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to get candidates for.
+     * @param options - Optional {@link Context.IContextMatchOptions | context match options} to use when matching candidates.
+     * @returns An array of {@link Resources.ResourceCandidate | candidates} that match the given context.
+     */
+    getCandidatesForContext(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): ReadonlyArray<ResourceCandidate>;
     /**
      * Given a {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}, creates and adds a
      * {@link Resources.ResourceCandidate | candidate} to the resource being built.

package/lib/packlets/resources/resourceBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceBuilder.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceBuilder.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,WAAW,EACX,cAAc,EACd,MAAM,EACN,SAAS,EAMV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAY,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,qBAAqB,CAAC;IACrC,aAAa,EAAE,6BAA6B,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,qBAAqB,GAAG,aAAa,GAAG,eAAe,CAAC;AAE9G;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,SAAgB,EAAE,EAAE,UAAU,CAAC;IAE/B;;;;OAIG;IACH,IAAW,YAAY,IAAI,YAAY,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,aAAa,CAAC,iBAAiB,CAAC,CAExD;IAED;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,YAAY,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE5D;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,6BAA6B,CAAC;IAExD;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAEhD;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,4BAA4B;IAU1D;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM,CAAC,eAAe,CAAC;IAInF;;;;;;;OAOG;IACI,iBAAiB,CACtB,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,GACvD,cAAc,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IAyBjE;;;;;;;;;;OAUG;IACI,iBAAiB,CACtB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,GAClD,cAAc,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IAkBjE;;;;;;OAMG;IACI,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IAczE;;;;;OAKG;IACI,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC;CAUjC"}
+{"version":3,"file":"resourceBuilder.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceBuilder.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,WAAW,EACX,cAAc,EACd,MAAM,EACN,SAAS,EAMV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAY,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,qBAAqB,CAAC;IACrC,aAAa,EAAE,6BAA6B,CAAC;IAC7C,SAAS,EAAE,yBAAyB,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,qBAAqB,GAAG,aAAa,GAAG,eAAe,CAAC;AAE9G;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,SAAgB,EAAE,EAAE,UAAU,CAAC;IAE/B;;;;OAIG;IACH,IAAW,YAAY,IAAI,YAAY,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,aAAa,CAAC,iBAAiB,CAAC,CAExD;IAED;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,YAAY,GAAG,SAAS,CAAC;IAElD;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE5D;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,6BAA6B,CAAC;IAExD;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAEhD;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,4BAA4B;IAW1D;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM,CAAC,eAAe,CAAC;IAInF;;;;;OAKG;IACI,uBAAuB,CAC5B,OAAO,EAAE,OAAO,CAAC,qBAAqB,EACtC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,GACrC,aAAa,CAAC,iBAAiB,CAAC;IAMnC;;;;;;;OAOG;IACI,iBAAiB,CACtB,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,GACvD,cAAc,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IAyBjE;;;;;;;;;;OAUG;IACI,iBAAiB,CACtB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,GAClD,cAAc,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IAmBjE;;;;;;OAMG;IACI,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IAczE;;;;;OAKG;IACI,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC;CAkBjC"}

package/lib/packlets/resources/resourceBuilder.js

@@ -55,6 +55,7 @@ class ResourceBuilder {
         this.id = common_1.Validate.toResourceId(params.id).orThrow();
         this._resourceTypes = params.resourceTypes;
         this._conditionSets = params.conditionSets;
+        this._decisions = params.decisions;
         this._candidates = new ts_utils_1.ResultMap();
         if (params.typeName) {
             this._resourceType = this._resourceTypes.validating.get(params.typeName).orThrow();
@@ -70,6 +71,15 @@ class ResourceBuilder {
     static create(params) {
         return (0, ts_utils_1.captureResult)(() => new ResourceBuilder(params));
     }
+    /**
+     * Gets the {@link Resources.ResourceCandidate | candidates} that match a given {@link Context.IValidatedContextDecl | context}.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to get candidates for.
+     * @param options - Optional {@link Context.IContextMatchOptions | context match options} to use when matching candidates.
+     * @returns An array of {@link Resources.ResourceCandidate | candidates} that match the given context.
+     */
+    getCandidatesForContext(context, options) {
+        return Array.from(this._candidates.values()).filter((candidate) => candidate.canMatchPartialContext(context, options));
+    }
     /**
      * Given a {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}, creates and adds a
      * {@link Resources.ResourceCandidate | candidate} to the resource being built.
@@ -111,6 +121,7 @@ class ResourceBuilder {
      * existing candidate if the candidate to be added is identical to an existing candidate.
      */
     addLooseCandidate(decl) {
+        /* c8 ignore next 6 - functional code path tested but coverage intermittently missed */
         if (decl.id !== this.id) {
             return (0, ts_utils_1.failWithDetail)(`${this.id}: mismatched candidate id ${decl.id}.`, 'id-mismatch');
         }
@@ -149,13 +160,20 @@ class ResourceBuilder {
      * or if the resource type is not defined.
      */
     build() {
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (this._candidates.size === 0) {
             return (0, ts_utils_1.fail)(`${this.id}: no candidates supplied.`);
         }
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (this._resourceType === undefined) {
             return (0, ts_utils_1.fail)(`${this.id}: no resource type supplied or inferred.`);
         }
-        return resource_1.Resource.create({ id: this.id, resourceType: this._resourceType, candidates: this.candidates });
+        return resource_1.Resource.create({
+            id: this.id,
+            resourceType: this._resourceType,
+            candidates: this.candidates,
+            decisions: this._decisions
+        });
     }
 }
 exports.ResourceBuilder = ResourceBuilder;

package/lib/packlets/resources/resourceBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"resourceBuilder.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport {\n  Collections,\n  DetailedResult,\n  Result,\n  ResultMap,\n  captureResult,\n  fail,\n  failWithDetail,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\nimport { ResourceId, Validate } from '../common';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { ReadOnlyResourceTypeCollector, ResourceType } from '../resource-types';\nimport { Resource } from './resource';\nimport { ConditionSetCollector } from '../conditions';\nimport * as ResourceJson from '../resource-json';\n\n/**\n * Parameters for creating a {@link Resources.ResourceBuilder}.\n * @public\n */\nexport interface IResourceBuilderCreateParams {\n  id: string;\n  typeName?: string;\n  conditionSets: ConditionSetCollector;\n  resourceTypes: ReadOnlyResourceTypeCollector;\n}\n\n/**\n * Possible result details returned by the resource builder\n * {@link Resources.ResourceBuilder.addLooseCandidate | addLooseCandidate} method.\n * @public\n */\nexport type ResourceBuilderResultDetail = Collections.ResultMapResultDetail | 'id-mismatch' | 'type-mismatch';\n\n/**\n * Represents a builder for a single logical {@link Resources.Resource | resource}.  Collects candidates\n * with a common resource ID, validates them against each other and builds a {@link Resources.Resource | resource}\n * object once all candidates are collected.\n * @public\n */\nexport class ResourceBuilder {\n  /**\n   * The unique {@link ResourceId | id} of the resource being built.\n   */\n  public readonly id: ResourceId;\n\n  /**\n   * Supplied or inferred {@link ResourceTypes.ResourceType | type} of the resource being built.\n   * If no type is supplied, the type will be inferred from the candidates - at least one candidate must\n   * define resource type and all candidates must be of the same type.\n   */\n  public get resourceType(): ResourceType | undefined {\n    return this._resourceType;\n  }\n\n  /**\n   * Array of {@link Resources.ResourceCandidate | candidates} for the resource being built.\n   */\n  public get candidates(): ReadonlyArray<ResourceCandidate> {\n    return Array.from(this._candidates.values()).sort(ResourceCandidate.compare).reverse();\n  }\n\n  /**\n   * The supplied or inferred {@link ResourceTypes.ResourceType | type} of the resource\n   * being built.\n   */\n  protected _resourceType: ResourceType | undefined;\n\n  /**\n   * Map of {@link Resources.ResourceCandidate | candidates} for the resource being built.\n   */\n  protected _candidates: ResultMap<string, ResourceCandidate>;\n\n  /**\n   * Map of all known {@link ResourceTypes.ResourceType | resource types}.\n   */\n  protected _resourceTypes: ReadOnlyResourceTypeCollector;\n\n  /**\n   * Common collector for {@link Conditions.ConditionSet | condition sets}.\n   */\n  protected _conditionSets: ConditionSetCollector;\n\n  /**\n   * Constructor for a {@link Resources.ResourceBuilder | ResourceBuilder} object.\n   * @param params - Parameters to construct the new {@link Resources.ResourceBuilder | ResourceBuilder}.\n   */\n  protected constructor(params: IResourceBuilderCreateParams) {\n    this.id = Validate.toResourceId(params.id).orThrow();\n    this._resourceTypes = params.resourceTypes;\n    this._conditionSets = params.conditionSets;\n    this._candidates = new ResultMap<string, ResourceCandidate>();\n    if (params.typeName) {\n      this._resourceType = this._resourceTypes.validating.get(params.typeName).orThrow();\n    }\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceBuilder | ResourceBuilder} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceBuilder | ResourceBuilder}.\n   * @returns `Success` with the new {@link Resources.ResourceBuilder | ResourceBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceBuilderCreateParams): Result<ResourceBuilder> {\n    return captureResult(() => new ResourceBuilder(params));\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}, creates and adds a\n   * {@link Resources.ResourceCandidate | candidate} to the resource being built.\n   * @param candidate - The {@link ResourceJson.Json.IChildResourceCandidateDecl | IChildResourceCandidateDecl} to add to the\n   * resource being built.\n   * @returns `Success` with the added {@link Resources.ResourceCandidate | candidate} if successful,\n   * or `Failure` with an error message if not.\n   */\n  public addChildCandidate(\n    childDecl: ResourceJson.Json.IChildResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail> {\n    return ResourceCandidate.create({\n      id: this.id,\n      resourceType: this._resourceType,\n      decl: childDecl,\n      conditionSets: this._conditionSets\n    })\n      .withDetail<ResourceBuilderResultDetail>('failure', 'success')\n      .onSuccess((candidate) => {\n        return this._candidates\n          .getOrAdd(candidate.conditions.toString(), candidate)\n          .onSuccess((added, detail) => {\n            if (detail === 'exists') {\n              if (!ResourceCandidate.equal(added, candidate)) {\n                return failWithDetail<ResourceCandidate, Collections.ResultMapResultDetail>(\n                  `${this.id}: conflicting candidates.`,\n                  'exists'\n                );\n              }\n            }\n            return succeedWithDetail(added, detail);\n          });\n      });\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, creates and adds a\n   * {@link Resources.ResourceCandidate | candidate} to the resource being built.\n   * @param candidate - The {@link ResourceJson.Json.ILooseResourceCandidateDecl | IResourceCandidateDecl} to add to the\n   * resource being built.\n   * @returns `Success` with the added {@link Resources.ResourceCandidate | candidate} if successful,\n   * or `Failure` with an error message if not. Fails with error detail 'type-mismatch' if the candidate\n   * specifies a different resource type than previously added candidates, or with 'exists' if a candidate\n   * already exists with the same conditions but different values.  Succeeds with 'exists' and returns the\n   * existing candidate if the candidate to be added is identical to an existing candidate.\n   */\n  public addLooseCandidate(\n    decl: ResourceJson.Json.ILooseResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail> {\n    if (decl.id !== this.id) {\n      return failWithDetail<ResourceCandidate, ResourceBuilderResultDetail>(\n        `${this.id}: mismatched candidate id ${decl.id}.`,\n        'id-mismatch'\n      );\n    }\n\n    if (decl.resourceTypeName !== undefined) {\n      const rt = this.setResourceType(decl.resourceTypeName);\n      if (rt.isFailure()) {\n        return failWithDetail<ResourceCandidate, ResourceBuilderResultDetail>(rt.message, 'type-mismatch');\n      }\n    }\n\n    return this.addChildCandidate(decl);\n  }\n\n  /**\n   * Sets the resource type for the resource being built.  Fails if a resource type has already been set\n   * and it does not match the new resource type.\n   * @param resourceTypeName - The name of the resource type to set.\n   * @returns `Success` with the updated {@link Resources.ResourceBuilder | ResourceBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   */\n  public setResourceType(resourceTypeName: string): Result<ResourceBuilder> {\n    if (this._resourceType?.key === resourceTypeName) {\n      return succeed(this);\n    } else if (this._resourceType !== undefined) {\n      return fail(\n        `${this.id}: conflicting resource types ${this._resourceType.key} !== ${resourceTypeName}.`\n      );\n    }\n    return this._resourceTypes.validating.get(resourceTypeName).onSuccess((resourceType) => {\n      this._resourceType = resourceType;\n      return succeedWithDetail(this, 'success');\n    });\n  }\n\n  /**\n   * Builds the {@link Resources.Resource | resource} object from this builder.\n   * @returns `Success` with the new {@link Resources.Resource | Resource} object if successful,\n   * or `Failure` with an error message if not. Fails if no candidates have been added\n   * or if the resource type is not defined.\n   */\n  public build(): Result<Resource> {\n    if (this._candidates.size === 0) {\n      return fail(`${this.id}: no candidates supplied.`);\n    }\n\n    if (this._resourceType === undefined) {\n      return fail(`${this.id}: no resource type supplied or inferred.`);\n    }\n    return Resource.create({ id: this.id, resourceType: this._resourceType, candidates: this.candidates });\n  }\n}\n"]}
+{"version":3,"file":"resourceBuilder.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport {\n  Collections,\n  DetailedResult,\n  Result,\n  ResultMap,\n  captureResult,\n  fail,\n  failWithDetail,\n  succeed,\n  succeedWithDetail\n} from '@fgv/ts-utils';\nimport { ResourceId, Validate } from '../common';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { ReadOnlyResourceTypeCollector, ResourceType } from '../resource-types';\nimport { Resource } from './resource';\nimport { ConditionSetCollector } from '../conditions';\nimport { AbstractDecisionCollector } from '../decisions';\nimport * as ResourceJson from '../resource-json';\nimport * as Context from '../context';\n\n/**\n * Parameters for creating a {@link Resources.ResourceBuilder}.\n * @public\n */\nexport interface IResourceBuilderCreateParams {\n  id: string;\n  typeName?: string;\n  conditionSets: ConditionSetCollector;\n  resourceTypes: ReadOnlyResourceTypeCollector;\n  decisions: AbstractDecisionCollector;\n}\n\n/**\n * Possible result details returned by the resource builder\n * {@link Resources.ResourceBuilder.addLooseCandidate | addLooseCandidate} method.\n * @public\n */\nexport type ResourceBuilderResultDetail = Collections.ResultMapResultDetail | 'id-mismatch' | 'type-mismatch';\n\n/**\n * Represents a builder for a single logical {@link Resources.Resource | resource}.  Collects candidates\n * with a common resource ID, validates them against each other and builds a {@link Resources.Resource | resource}\n * object once all candidates are collected.\n * @public\n */\nexport class ResourceBuilder {\n  /**\n   * The unique {@link ResourceId | id} of the resource being built.\n   */\n  public readonly id: ResourceId;\n\n  /**\n   * Supplied or inferred {@link ResourceTypes.ResourceType | type} of the resource being built.\n   * If no type is supplied, the type will be inferred from the candidates - at least one candidate must\n   * define resource type and all candidates must be of the same type.\n   */\n  public get resourceType(): ResourceType | undefined {\n    return this._resourceType;\n  }\n\n  /**\n   * Array of {@link Resources.ResourceCandidate | candidates} for the resource being built.\n   */\n  public get candidates(): ReadonlyArray<ResourceCandidate> {\n    return Array.from(this._candidates.values()).sort(ResourceCandidate.compare).reverse();\n  }\n\n  /**\n   * The supplied or inferred {@link ResourceTypes.ResourceType | type} of the resource\n   * being built.\n   */\n  protected _resourceType: ResourceType | undefined;\n\n  /**\n   * Map of {@link Resources.ResourceCandidate | candidates} for the resource being built.\n   */\n  protected _candidates: ResultMap<string, ResourceCandidate>;\n\n  /**\n   * Map of all known {@link ResourceTypes.ResourceType | resource types}.\n   */\n  protected _resourceTypes: ReadOnlyResourceTypeCollector;\n\n  /**\n   * Common collector for {@link Conditions.ConditionSet | condition sets}.\n   */\n  protected _conditionSets: ConditionSetCollector;\n\n  /**\n   * Collector for {@link Decisions.AbstractDecision | abstract decisions}.\n   */\n  protected _decisions: AbstractDecisionCollector;\n\n  /**\n   * Constructor for a {@link Resources.ResourceBuilder | ResourceBuilder} object.\n   * @param params - Parameters to construct the new {@link Resources.ResourceBuilder | ResourceBuilder}.\n   */\n  protected constructor(params: IResourceBuilderCreateParams) {\n    this.id = Validate.toResourceId(params.id).orThrow();\n    this._resourceTypes = params.resourceTypes;\n    this._conditionSets = params.conditionSets;\n    this._decisions = params.decisions;\n    this._candidates = new ResultMap<string, ResourceCandidate>();\n    if (params.typeName) {\n      this._resourceType = this._resourceTypes.validating.get(params.typeName).orThrow();\n    }\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceBuilder | ResourceBuilder} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceBuilder | ResourceBuilder}.\n   * @returns `Success` with the new {@link Resources.ResourceBuilder | ResourceBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceBuilderCreateParams): Result<ResourceBuilder> {\n    return captureResult(() => new ResourceBuilder(params));\n  }\n\n  /**\n   * Gets the {@link Resources.ResourceCandidate | candidates} that match a given {@link Context.IValidatedContextDecl | context}.\n   * @param context - The {@link Context.IValidatedContextDecl | context} to get candidates for.\n   * @param options - Optional {@link Context.IContextMatchOptions | context match options} to use when matching candidates.\n   * @returns An array of {@link Resources.ResourceCandidate | candidates} that match the given context.\n   */\n  public getCandidatesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): ReadonlyArray<ResourceCandidate> {\n    return Array.from(this._candidates.values()).filter((candidate) =>\n      candidate.canMatchPartialContext(context, options)\n    );\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}, creates and adds a\n   * {@link Resources.ResourceCandidate | candidate} to the resource being built.\n   * @param candidate - The {@link ResourceJson.Json.IChildResourceCandidateDecl | IChildResourceCandidateDecl} to add to the\n   * resource being built.\n   * @returns `Success` with the added {@link Resources.ResourceCandidate | candidate} if successful,\n   * or `Failure` with an error message if not.\n   */\n  public addChildCandidate(\n    childDecl: ResourceJson.Json.IChildResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail> {\n    return ResourceCandidate.create({\n      id: this.id,\n      resourceType: this._resourceType,\n      decl: childDecl,\n      conditionSets: this._conditionSets\n    })\n      .withDetail<ResourceBuilderResultDetail>('failure', 'success')\n      .onSuccess((candidate) => {\n        return this._candidates\n          .getOrAdd(candidate.conditions.toString(), candidate)\n          .onSuccess((added, detail) => {\n            if (detail === 'exists') {\n              if (!ResourceCandidate.equal(added, candidate)) {\n                return failWithDetail<ResourceCandidate, Collections.ResultMapResultDetail>(\n                  `${this.id}: conflicting candidates.`,\n                  'exists'\n                );\n              }\n            }\n            return succeedWithDetail(added, detail);\n          });\n      });\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, creates and adds a\n   * {@link Resources.ResourceCandidate | candidate} to the resource being built.\n   * @param candidate - The {@link ResourceJson.Json.ILooseResourceCandidateDecl | IResourceCandidateDecl} to add to the\n   * resource being built.\n   * @returns `Success` with the added {@link Resources.ResourceCandidate | candidate} if successful,\n   * or `Failure` with an error message if not. Fails with error detail 'type-mismatch' if the candidate\n   * specifies a different resource type than previously added candidates, or with 'exists' if a candidate\n   * already exists with the same conditions but different values.  Succeeds with 'exists' and returns the\n   * existing candidate if the candidate to be added is identical to an existing candidate.\n   */\n  public addLooseCandidate(\n    decl: ResourceJson.Json.ILooseResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail> {\n    /* c8 ignore next 6 - functional code path tested but coverage intermittently missed */\n    if (decl.id !== this.id) {\n      return failWithDetail<ResourceCandidate, ResourceBuilderResultDetail>(\n        `${this.id}: mismatched candidate id ${decl.id}.`,\n        'id-mismatch'\n      );\n    }\n\n    if (decl.resourceTypeName !== undefined) {\n      const rt = this.setResourceType(decl.resourceTypeName);\n      if (rt.isFailure()) {\n        return failWithDetail<ResourceCandidate, ResourceBuilderResultDetail>(rt.message, 'type-mismatch');\n      }\n    }\n\n    return this.addChildCandidate(decl);\n  }\n\n  /**\n   * Sets the resource type for the resource being built.  Fails if a resource type has already been set\n   * and it does not match the new resource type.\n   * @param resourceTypeName - The name of the resource type to set.\n   * @returns `Success` with the updated {@link Resources.ResourceBuilder | ResourceBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   */\n  public setResourceType(resourceTypeName: string): Result<ResourceBuilder> {\n    if (this._resourceType?.key === resourceTypeName) {\n      return succeed(this);\n    } else if (this._resourceType !== undefined) {\n      return fail(\n        `${this.id}: conflicting resource types ${this._resourceType.key} !== ${resourceTypeName}.`\n      );\n    }\n    return this._resourceTypes.validating.get(resourceTypeName).onSuccess((resourceType) => {\n      this._resourceType = resourceType;\n      return succeedWithDetail(this, 'success');\n    });\n  }\n\n  /**\n   * Builds the {@link Resources.Resource | resource} object from this builder.\n   * @returns `Success` with the new {@link Resources.Resource | Resource} object if successful,\n   * or `Failure` with an error message if not. Fails if no candidates have been added\n   * or if the resource type is not defined.\n   */\n  public build(): Result<Resource> {\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (this._candidates.size === 0) {\n      return fail(`${this.id}: no candidates supplied.`);\n    }\n\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (this._resourceType === undefined) {\n      return fail(`${this.id}: no resource type supplied or inferred.`);\n    }\n\n    return Resource.create({\n      id: this.id,\n      resourceType: this._resourceType,\n      candidates: this.candidates,\n      decisions: this._decisions\n    });\n  }\n}\n"]}

package/lib/packlets/resources/resourceCandidate.d.ts

@@ -1,9 +1,11 @@
-import { JsonValue } from '@fgv/ts-json-base';
-import { ResourceId, ResourceValueMergeMethod } from '../common';
+import { JsonObject } from '@fgv/ts-json-base';
+import { CandidateCompleteness, QualifierName, ResourceId, ResourceValueMergeMethod } from '../common';
 import { Condition, ConditionSet, ConditionSetCollector } from '../conditions';
 import * as ResourceJson from '../resource-json';
 import { ResourceType } from '../resource-types';
 import { Result } from '@fgv/ts-utils';
+import * as Context from '../context';
+import { IResourceCandidate } from '../runtime';
 /**
  * Parameters to create a {@link Resources.ResourceCandidate | ResourceCandidate}.
  * @public
@@ -15,13 +17,27 @@ export interface IResourceCandidateCreateParams {
     parentConditions?: ReadonlyArray<Condition>;
     conditionSets: ConditionSetCollector;
 }
+/**
+ * Options for creating a {@link Resources.ResourceCandidate | ResourceCandidate} declaration.
+ * @remarks
+ * This interface extends the {@link ResourceJson.Helpers.IDeclarationOptions | declaration options}
+ * interface to include a `reduceQualifiers` option.
+ * @public
+ */
+export interface ICandidateDeclOptions extends ResourceJson.Helpers.IDeclarationOptions {
+    /**
+     * If provided, reduces the qualifiers of the candidate by removing qualifiers that are made
+     * irrelevant by the filterForContext.
+     */
+    qualifiersToReduce?: ReadonlySet<QualifierName>;
+}
 /**
  * A {@link Resources.ResourceCandidate | resource candidate} represents a single possible
  * instance value for some resource, with the conditions under which it applies
  * and instructions on how to merge it with other instances.
  * @public
  */
-export declare class ResourceCandidate {
+export declare class ResourceCandidate implements IResourceCandidate {
     /**
      * The unique identifier of the resource for which this candidate
      * is a possible instance.
@@ -30,7 +46,7 @@ export declare class ResourceCandidate {
     /**
      * The JSON representation of the instance data to be applied.
      */
-    readonly json: JsonValue;
+    readonly json: JsonObject;
     /**
      * The conditions under which this candidate applies.
      */
@@ -48,6 +64,10 @@ export declare class ResourceCandidate {
      * this candidate belongs.
      */
     readonly resourceType: ResourceType | undefined;
+    /**
+     * The completeness of the candidate value.
+     */
+    get completeness(): CandidateCompleteness;
     /**
      * Constructor for a {@link Resources.ResourceCandidate | ResourceCandidate} object.
      * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.
@@ -62,20 +82,27 @@ export declare class ResourceCandidate {
      * @public
      */
     static create(params: IResourceCandidateCreateParams): Result<ResourceCandidate>;
+    /**
+     * Determines if this candidate can match the supplied context (possibly partial).
+     * @param context - The context to match.
+     * @param options - Options to use when matching.
+     * @returns `true` if the candidate can match the context, `false` otherwise.
+     */
+    canMatchPartialContext(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): boolean;
     /**
      * Gets the {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}
      * for this candidate.
      * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the declaration.
      * @returns The {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.
      */
-    toChildResourceCandidateDecl(options?: ResourceJson.Helpers.IDeclarationOptions): ResourceJson.Json.IChildResourceCandidateDecl;
+    toChildResourceCandidateDecl(options?: ICandidateDeclOptions): ResourceJson.Json.IChildResourceCandidateDecl;
     /**
      * Gets the {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}
      * for this candidate.
      * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the declaration.
      * @returns The {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.
      */
-    toLooseResourceCandidateDecl(options?: ResourceJson.Helpers.IDeclarationOptions): ResourceJson.Json.ILooseResourceCandidateDecl;
+    toLooseResourceCandidateDecl(options?: ICandidateDeclOptions): ResourceJson.Json.ILooseResourceCandidateDecl;
     /**
      * Extracts the {@link ResourceTypes.ResourceType | resource type} from a list of {@link Resources.ResourceCandidate | resource candidates},
      * if present.
@@ -112,5 +139,18 @@ export declare class ResourceCandidate {
      * @internal
      */
     private static _mergeConditions;
+    /**
+     * Finds the qualifiers that are made irrelevant by the supplied filterForContext.
+     * @param candidates - The candidates to find the reducible qualifiers for.
+     * @param filterForContext - The filter for context to use.
+     * @returns The qualifiers that are made irrelevant by the filterForContext.
+     * @remarks
+     * For any given set of candidates, qualifiers that match every candidate perfectly
+     * are irrelevant to the filtered content and can be removed.  Qualifiers that do not
+     * match, that are not in the filterForContext, or which partially match at least one
+     * candidate remain relevant and must not be removed.
+     * @public
+     */
+    static findReducibleQualifiers(candidates: ReadonlyArray<ResourceCandidate>, filterForContext: Context.IValidatedContextDecl): ReadonlySet<QualifierName> | undefined;
 }
 //# sourceMappingURL=resourceCandidate.d.ts.map

package/lib/packlets/resources/resourceCandidate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceCandidate.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceCandidate.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAY,MAAM,WAAW,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAsD,MAAM,EAAiB,MAAM,eAAe,CAAC;AAE1G;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,CAAC;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,aAAa,EAAE,qBAAqB,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,SAAgB,EAAE,EAAE,UAAU,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC;;OAEG;IACH,SAAgB,UAAU,EAAE,YAAY,CAAC;IAEzC;;OAEG;IACH,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,SAAgB,WAAW,EAAE,wBAAwB,CAAC;IAEtD;;;OAGG;IACH,SAAgB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IAEvD;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,8BAA8B;IAgB5D;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAIvF;;;;;OAKG;IACI,4BAA4B,CACjC,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,mBAAmB,GACjD,YAAY,CAAC,IAAI,CAAC,2BAA2B;IAUhD;;;;;OAKG;IACI,4BAA4B,CACjC,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,mBAAmB,GACjD,YAAY,CAAC,IAAI,CAAC,2BAA2B;IAahD;;;;;;;OAOG;WACW,qBAAqB,CACjC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,GAC1B,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAenC;;;;;;;OAOG;WACW,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAI7E;;;;;;OAMG;WACW,KAAK,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO;IAkB5E;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CA2BhC"}
+{"version":3,"file":"resourceCandidate.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceCandidate.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EAErB,aAAa,EACb,UAAU,EACV,wBAAwB,EAEzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAsD,MAAM,EAAiB,MAAM,eAAe,CAAC;AAC1G,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,CAAC;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,aAAa,EAAE,qBAAqB,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY,CAAC,OAAO,CAAC,mBAAmB;IACrF;;;OAGG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D;;;OAGG;IACH,SAAgB,EAAE,EAAE,UAAU,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC;;OAEG;IACH,SAAgB,UAAU,EAAE,YAAY,CAAC;IAEzC;;OAEG;IACH,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC;;OAEG;IACH,SAAgB,WAAW,EAAE,wBAAwB,CAAC;IAEtD;;;OAGG;IACH,SAAgB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IAEvD;;OAEG;IACH,IAAW,YAAY,IAAI,qBAAqB,CAE/C;IAED;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,8BAA8B;IAgB5D;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAIvF;;;;;OAKG;IACI,sBAAsB,CAC3B,OAAO,EAAE,OAAO,CAAC,qBAAqB,EACtC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,GACrC,OAAO;IAIV;;;;;OAKG;IACI,4BAA4B,CACjC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,YAAY,CAAC,IAAI,CAAC,2BAA2B;IAUhD;;;;;OAKG;IACI,4BAA4B,CACjC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,YAAY,CAAC,IAAI,CAAC,2BAA2B;IAahD;;;;;;;OAOG;WACW,qBAAqB,CACjC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,GAC1B,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC;IAiBnC;;;;;;;OAOG;WACW,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,GAAG,MAAM;IAI7E;;;;;;OAMG;WACW,KAAK,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO;IAmB5E;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA6B/B;;;;;;;;;;;OAWG;WACW,uBAAuB,CACnC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,EAAE,OAAO,CAAC,qBAAqB,GAC9C,WAAW,CAAC,aAAa,CAAC,GAAG,SAAS;CAkB1C"}