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

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 { 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.
      */
@@ -62,20 +78,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 +135,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,EAAgB,aAAa,EAAE,UAAU,EAAE,wBAAwB,EAAY,MAAM,WAAW,CAAC;AACxG,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;;;;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"}

package/lib/packlets/resources/resourceCandidate.js

@@ -80,7 +80,7 @@ class ResourceCandidate {
         this.mergeMethod = (_b = params.decl.mergeMethod) !== null && _b !== void 0 ? _b : 'augment';
         this.resourceType = params.resourceType;
         if (this.resourceType) {
-            this.resourceType.validateDeclaration(this.json, this.isPartial, this.mergeMethod).orThrow();
+            this.resourceType.validateDeclaration(this).orThrow();
         }
     }
     /**
@@ -93,6 +93,15 @@ class ResourceCandidate {
     static create(params) {
         return (0, ts_utils_1.captureResult)(() => new ResourceCandidate(params));
     }
+    /**
+     * 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, options) {
+        return this.conditions.canMatchPartialContext(context, options);
+    }
     /**
      * Gets the {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}
      * for this candidate.
@@ -128,9 +137,11 @@ class ResourceCandidate {
         let selectedType = expectedType;
         for (const candidate of candidates) {
             if (selectedType === undefined) {
+                /* c8 ignore next 1 - functional code path tested but coverage intermittently missed */
                 selectedType = candidate.resourceType;
             }
             else if (candidate.resourceType && selectedType !== candidate.resourceType) {
+                /* c8 ignore next 4 - functional code path tested but coverage intermittently missed */
                 errors.addMessage(`${candidate.id}: resource type mismatch (${selectedType.key} != ${candidate.resourceType.key})`);
             }
         }
@@ -155,6 +166,7 @@ class ResourceCandidate {
      * @public
      */
     static equal(rc1, rc2) {
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (rc1 === rc2) {
             return true;
         }
@@ -184,6 +196,7 @@ class ResourceCandidate {
         declared = declared !== null && declared !== void 0 ? declared : {};
         parent = parent !== null && parent !== void 0 ? parent : [];
         const { value: conditionDecls, message } = ResourceJson.Convert.conditionSetDecl.convert(declared);
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (message !== undefined) {
             return (0, ts_utils_1.fail)(message);
         }
@@ -197,6 +210,32 @@ class ResourceCandidate {
             });
         });
     }
+    /**
+     * 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, filterForContext) {
+        const qualifiersToReduce = new Set(Object.keys(filterForContext));
+        for (const candidate of candidates) {
+            for (const condition of candidate.conditions.conditions) {
+                if (qualifiersToReduce.has(condition.qualifier.name)) {
+                    const match = condition.qualifier.type.matches(condition.value, filterForContext[condition.qualifier.name], 'matches');
+                    if (match !== common_1.PerfectMatch) {
+                        qualifiersToReduce.delete(condition.qualifier.name);
+                    }
+                }
+            }
+        }
+        return qualifiersToReduce.size > 0 ? qualifiersToReduce : undefined;
+    }
 }
 exports.ResourceCandidate = ResourceCandidate;
 //# sourceMappingURL=resourceCandidate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"resourceCandidate.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceCandidate.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 { JsonObject, JsonValue } from '@fgv/ts-json-base';\nimport { ResourceId, ResourceValueMergeMethod, Validate } from '../common';\nimport { Condition, ConditionSet, ConditionSetCollector } from '../conditions';\nimport * as ResourceJson from '../resource-json';\nimport { ResourceType } from '../resource-types';\nimport { captureResult, mapResults, Hash, MessageAggregator, Result, fail, succeed } from '@fgv/ts-utils';\n\n/**\n * Parameters to create a {@link Resources.ResourceCandidate | ResourceCandidate}.\n * @public\n */\nexport interface IResourceCandidateCreateParams {\n  id: string;\n  decl: ResourceJson.Json.IChildResourceCandidateDecl;\n  resourceType?: ResourceType;\n  parentConditions?: ReadonlyArray<Condition>;\n  conditionSets: ConditionSetCollector;\n}\n\n/**\n * A {@link Resources.ResourceCandidate | resource candidate} represents a single possible\n * instance value for some resource, with the conditions under which it applies\n * and instructions on how to merge it with other instances.\n * @public\n */\nexport class ResourceCandidate {\n  /**\n   * The unique identifier of the resource for which this candidate\n   * is a possible instance.\n   */\n  public readonly id: ResourceId;\n\n  /**\n   * The JSON representation of the instance data to be applied.\n   */\n  public readonly json: JsonValue;\n\n  /**\n   * The conditions under which this candidate applies.\n   */\n  public readonly conditions: ConditionSet;\n\n  /**\n   * True if this candidate is a partial instance.\n   */\n  public readonly isPartial: boolean;\n\n  /**\n   * The method to use when merging this candidate with other instances.\n   */\n  public readonly mergeMethod: ResourceValueMergeMethod;\n\n  /**\n   * The {@link ResourceTypes.ResourceType | resource type} for the resource to which\n   * this candidate belongs.\n   */\n  public readonly resourceType: ResourceType | undefined;\n\n  /**\n   * Constructor for a {@link Resources.ResourceCandidate | ResourceCandidate} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.\n   * @public\n   */\n  protected constructor(params: IResourceCandidateCreateParams) {\n    this.id = Validate.toResourceId(params.id).orThrow();\n    this.json = params.decl.json;\n    this.conditions = ResourceCandidate._mergeConditions(\n      params.conditionSets,\n      params.decl.conditions,\n      params.parentConditions\n    ).orThrow();\n    this.isPartial = params.decl.isPartial ?? false;\n    this.mergeMethod = params.decl.mergeMethod ?? 'augment';\n    this.resourceType = params.resourceType;\n    if (this.resourceType) {\n      this.resourceType.validateDeclaration(this.json, this.isPartial, this.mergeMethod).orThrow();\n    }\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceCandidate | ResourceCandidate} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.\n   * @returns `Success` with the new {@link Resources.ResourceCandidate | ResourceCandidate} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceCandidateCreateParams): Result<ResourceCandidate> {\n    return captureResult(() => new ResourceCandidate(params));\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}\n   * for this candidate.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the declaration.\n   * @returns The {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.\n   */\n  public toChildResourceCandidateDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.IChildResourceCandidateDecl {\n    const showDefaults = options?.showDefaults === true;\n    return {\n      json: this.json as JsonObject,\n      conditions: this.conditions.toConditionSetRecordDecl(options),\n      ...(showDefaults || this.isPartial ? { isPartial: this.isPartial } : {}),\n      ...(showDefaults || this.mergeMethod !== 'augment' ? { mergeMethod: this.mergeMethod } : {})\n    };\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}\n   * for this candidate.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the declaration.\n   * @returns The {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.\n   */\n  public toLooseResourceCandidateDecl(\n    options?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.ILooseResourceCandidateDecl {\n    const showDefaults = options?.showDefaults === true;\n    const resourceTypeName = this.resourceType?.key;\n    return {\n      id: this.id.toString(),\n      json: this.json as JsonObject,\n      conditions: this.conditions.toConditionSetRecordDecl(options),\n      ...(showDefaults || this.isPartial ? { isPartial: this.isPartial } : {}),\n      ...(showDefaults || this.mergeMethod !== 'augment' ? { mergeMethod: this.mergeMethod } : {}),\n      ...(resourceTypeName ? { resourceTypeName } : {})\n    };\n  }\n\n  /**\n   * Extracts the {@link ResourceTypes.ResourceType | resource type} from a list of {@link Resources.ResourceCandidate | resource candidates},\n   * if present.\n   * @param candidates - The list of candidates from which to extract the resource type.\n   * @returns `Success` with the resource type if successful, `Success` with `undefined` if none of the candidates\n   * specify a resource tap, and `Failure` with an error message if clients specify conflicting resource types.\n   * @public\n   */\n  public static validateResourceTypes(\n    candidates: ReadonlyArray<ResourceCandidate>,\n    expectedType?: ResourceType\n  ): Result<ResourceType | undefined> {\n    const errors = new MessageAggregator();\n    let selectedType: ResourceType | undefined = expectedType;\n    for (const candidate of candidates) {\n      if (selectedType === undefined) {\n        selectedType = candidate.resourceType;\n      } else if (candidate.resourceType && selectedType !== candidate.resourceType) {\n        errors.addMessage(\n          `${candidate.id}: resource type mismatch (${selectedType.key} != ${candidate.resourceType.key})`\n        );\n      }\n    }\n    return errors.returnOrReport(succeed(selectedType));\n  }\n\n  /**\n   * Compares two {@link Resources.ResourceCandidate | ResourceCandidates} for sorting purposes.\n   * @param rc1 - The first candidate to compare.\n   * @param rc2 - The second candidate to compare.\n   * @returns A negative number if `rc1` should come before `rc2`, a positive number if `rc2` should come before `rc1`,\n   * or zero if they are equivalent.\n   * @public\n   */\n  public static compare(rc1: ResourceCandidate, rc2: ResourceCandidate): number {\n    return ConditionSet.compare(rc1.conditions, rc2.conditions);\n  }\n\n  /**\n   * Compares two {@link Resources.ResourceCandidate | ResourceCandidates} for equality.\n   * @param rc1 - The first candidate to compare.\n   * @param rc2 - The second candidate to compare.\n   * @returns `true` if the candidates are equal, `false` otherwise.\n   * @public\n   */\n  public static equal(rc1: ResourceCandidate, rc2: ResourceCandidate): boolean {\n    if (rc1 === rc2) {\n      return true;\n    }\n    let equal =\n      rc1.id === rc2.id &&\n      rc1.isPartial === rc2.isPartial &&\n      rc1.mergeMethod === rc2.mergeMethod &&\n      ConditionSet.compare(rc1.conditions, rc2.conditions) === 0;\n    if (equal) {\n      const normalizer = new Hash.Crc32Normalizer();\n      const n1 = normalizer.computeHash(rc1.json).orDefault('(n1 normalization failed)');\n      const n2 = normalizer.computeHash(rc2.json).orDefault('(n2 normalization failed)');\n      equal = n1 === n2;\n    }\n    return equal;\n  }\n\n  /**\n   * Validates declared conditions and merges them with parent conditions.\n   * @param conditionSets - The {@link Conditions.ConditionSetCollector | condition set collector}\n   * to use for this candidate.\n   * @param declared - The declared conditions for the candidate.\n   * @param parent - The parent conditions to merge with the declared conditions.\n   * @returns `Success` with the merged conditions if successful, `Failure` otherwise.\n   * @internal\n   */\n  private static _mergeConditions(\n    conditionSets: ConditionSetCollector,\n    declared: ResourceJson.Json.ConditionSetDecl | undefined,\n    parent: ReadonlyArray<Condition> | undefined\n  ): Result<ConditionSet> {\n    /* c8 ignore next 2 - code coverage is flaky */\n    declared = declared ?? {};\n    parent = parent ?? [];\n\n    const { value: conditionDecls, message } = ResourceJson.Convert.conditionSetDecl.convert(declared);\n    if (message !== undefined) {\n      return fail(message);\n    }\n\n    return mapResults(\n      // get or add all declared conditions from our condition collector\n      conditionDecls.map((decl) => conditionSets.conditions.validating.getOrAdd(decl))\n    ).onSuccess((declaredConditions) => {\n      // make sure our parent conditions all come from our condition collector too\n      return mapResults(parent.map((c) => conditionSets.conditions.getOrAdd(c))).onSuccess(\n        (parentConditions) => {\n          const conditions = [...parentConditions, ...declaredConditions];\n          return conditionSets.validating.getOrAdd(conditions);\n        }\n      );\n    });\n  }\n}\n"]}
+{"version":3,"file":"resourceCandidate.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceCandidate.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 { JsonObject } from '@fgv/ts-json-base';\nimport { PerfectMatch, QualifierName, ResourceId, ResourceValueMergeMethod, Validate } from '../common';\nimport { Condition, ConditionSet, ConditionSetCollector } from '../conditions';\nimport * as ResourceJson from '../resource-json';\nimport { ResourceType } from '../resource-types';\nimport { captureResult, mapResults, Hash, MessageAggregator, Result, fail, succeed } from '@fgv/ts-utils';\nimport * as Context from '../context';\nimport { IResourceCandidate } from '../runtime';\n\n/**\n * Parameters to create a {@link Resources.ResourceCandidate | ResourceCandidate}.\n * @public\n */\nexport interface IResourceCandidateCreateParams {\n  id: string;\n  decl: ResourceJson.Json.IChildResourceCandidateDecl;\n  resourceType?: ResourceType;\n  parentConditions?: ReadonlyArray<Condition>;\n  conditionSets: ConditionSetCollector;\n}\n\n/**\n * Options for creating a {@link Resources.ResourceCandidate | ResourceCandidate} declaration.\n * @remarks\n * This interface extends the {@link ResourceJson.Helpers.IDeclarationOptions | declaration options}\n * interface to include a `reduceQualifiers` option.\n * @public\n */\nexport interface ICandidateDeclOptions extends ResourceJson.Helpers.IDeclarationOptions {\n  /**\n   * If provided, reduces the qualifiers of the candidate by removing qualifiers that are made\n   * irrelevant by the filterForContext.\n   */\n  qualifiersToReduce?: ReadonlySet<QualifierName>;\n}\n\n/**\n * A {@link Resources.ResourceCandidate | resource candidate} represents a single possible\n * instance value for some resource, with the conditions under which it applies\n * and instructions on how to merge it with other instances.\n * @public\n */\nexport class ResourceCandidate implements IResourceCandidate {\n  /**\n   * The unique identifier of the resource for which this candidate\n   * is a possible instance.\n   */\n  public readonly id: ResourceId;\n\n  /**\n   * The JSON representation of the instance data to be applied.\n   */\n  public readonly json: JsonObject;\n\n  /**\n   * The conditions under which this candidate applies.\n   */\n  public readonly conditions: ConditionSet;\n\n  /**\n   * True if this candidate is a partial instance.\n   */\n  public readonly isPartial: boolean;\n\n  /**\n   * The method to use when merging this candidate with other instances.\n   */\n  public readonly mergeMethod: ResourceValueMergeMethod;\n\n  /**\n   * The {@link ResourceTypes.ResourceType | resource type} for the resource to which\n   * this candidate belongs.\n   */\n  public readonly resourceType: ResourceType | undefined;\n\n  /**\n   * Constructor for a {@link Resources.ResourceCandidate | ResourceCandidate} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.\n   * @public\n   */\n  protected constructor(params: IResourceCandidateCreateParams) {\n    this.id = Validate.toResourceId(params.id).orThrow();\n    this.json = params.decl.json;\n    this.conditions = ResourceCandidate._mergeConditions(\n      params.conditionSets,\n      params.decl.conditions,\n      params.parentConditions\n    ).orThrow();\n    this.isPartial = params.decl.isPartial ?? false;\n    this.mergeMethod = params.decl.mergeMethod ?? 'augment';\n    this.resourceType = params.resourceType;\n    if (this.resourceType) {\n      this.resourceType.validateDeclaration(this).orThrow();\n    }\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceCandidate | ResourceCandidate} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceCandidate | ResourceCandidate}.\n   * @returns `Success` with the new {@link Resources.ResourceCandidate | ResourceCandidate} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceCandidateCreateParams): Result<ResourceCandidate> {\n    return captureResult(() => new ResourceCandidate(params));\n  }\n\n  /**\n   * Determines if this candidate can match the supplied context (possibly partial).\n   * @param context - The context to match.\n   * @param options - Options to use when matching.\n   * @returns `true` if the candidate can match the context, `false` otherwise.\n   */\n  public canMatchPartialContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): boolean {\n    return this.conditions.canMatchPartialContext(context, options);\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}\n   * for this candidate.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the declaration.\n   * @returns The {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.\n   */\n  public toChildResourceCandidateDecl(\n    options?: ICandidateDeclOptions\n  ): ResourceJson.Json.IChildResourceCandidateDecl {\n    const showDefaults = options?.showDefaults === true;\n    return {\n      json: this.json as JsonObject,\n      conditions: this.conditions.toConditionSetRecordDecl(options),\n      ...(showDefaults || this.isPartial ? { isPartial: this.isPartial } : {}),\n      ...(showDefaults || this.mergeMethod !== 'augment' ? { mergeMethod: this.mergeMethod } : {})\n    };\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}\n   * for this candidate.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} to use when creating the declaration.\n   * @returns The {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.\n   */\n  public toLooseResourceCandidateDecl(\n    options?: ICandidateDeclOptions\n  ): ResourceJson.Json.ILooseResourceCandidateDecl {\n    const showDefaults = options?.showDefaults === true;\n    const resourceTypeName = this.resourceType?.key;\n    return {\n      id: this.id.toString(),\n      json: this.json as JsonObject,\n      conditions: this.conditions.toConditionSetRecordDecl(options),\n      ...(showDefaults || this.isPartial ? { isPartial: this.isPartial } : {}),\n      ...(showDefaults || this.mergeMethod !== 'augment' ? { mergeMethod: this.mergeMethod } : {}),\n      ...(resourceTypeName ? { resourceTypeName } : {})\n    };\n  }\n\n  /**\n   * Extracts the {@link ResourceTypes.ResourceType | resource type} from a list of {@link Resources.ResourceCandidate | resource candidates},\n   * if present.\n   * @param candidates - The list of candidates from which to extract the resource type.\n   * @returns `Success` with the resource type if successful, `Success` with `undefined` if none of the candidates\n   * specify a resource tap, and `Failure` with an error message if clients specify conflicting resource types.\n   * @public\n   */\n  public static validateResourceTypes(\n    candidates: ReadonlyArray<ResourceCandidate>,\n    expectedType?: ResourceType\n  ): Result<ResourceType | undefined> {\n    const errors = new MessageAggregator();\n    let selectedType: ResourceType | undefined = expectedType;\n    for (const candidate of candidates) {\n      if (selectedType === undefined) {\n        /* c8 ignore next 1 - functional code path tested but coverage intermittently missed */\n        selectedType = candidate.resourceType;\n      } else if (candidate.resourceType && selectedType !== candidate.resourceType) {\n        /* c8 ignore next 4 - functional code path tested but coverage intermittently missed */\n        errors.addMessage(\n          `${candidate.id}: resource type mismatch (${selectedType.key} != ${candidate.resourceType.key})`\n        );\n      }\n    }\n    return errors.returnOrReport(succeed(selectedType));\n  }\n\n  /**\n   * Compares two {@link Resources.ResourceCandidate | ResourceCandidates} for sorting purposes.\n   * @param rc1 - The first candidate to compare.\n   * @param rc2 - The second candidate to compare.\n   * @returns A negative number if `rc1` should come before `rc2`, a positive number if `rc2` should come before `rc1`,\n   * or zero if they are equivalent.\n   * @public\n   */\n  public static compare(rc1: ResourceCandidate, rc2: ResourceCandidate): number {\n    return ConditionSet.compare(rc1.conditions, rc2.conditions);\n  }\n\n  /**\n   * Compares two {@link Resources.ResourceCandidate | ResourceCandidates} for equality.\n   * @param rc1 - The first candidate to compare.\n   * @param rc2 - The second candidate to compare.\n   * @returns `true` if the candidates are equal, `false` otherwise.\n   * @public\n   */\n  public static equal(rc1: ResourceCandidate, rc2: ResourceCandidate): boolean {\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (rc1 === rc2) {\n      return true;\n    }\n    let equal =\n      rc1.id === rc2.id &&\n      rc1.isPartial === rc2.isPartial &&\n      rc1.mergeMethod === rc2.mergeMethod &&\n      ConditionSet.compare(rc1.conditions, rc2.conditions) === 0;\n    if (equal) {\n      const normalizer = new Hash.Crc32Normalizer();\n      const n1 = normalizer.computeHash(rc1.json).orDefault('(n1 normalization failed)');\n      const n2 = normalizer.computeHash(rc2.json).orDefault('(n2 normalization failed)');\n      equal = n1 === n2;\n    }\n    return equal;\n  }\n\n  /**\n   * Validates declared conditions and merges them with parent conditions.\n   * @param conditionSets - The {@link Conditions.ConditionSetCollector | condition set collector}\n   * to use for this candidate.\n   * @param declared - The declared conditions for the candidate.\n   * @param parent - The parent conditions to merge with the declared conditions.\n   * @returns `Success` with the merged conditions if successful, `Failure` otherwise.\n   * @internal\n   */\n  private static _mergeConditions(\n    conditionSets: ConditionSetCollector,\n    declared: ResourceJson.Json.ConditionSetDecl | undefined,\n    parent: ReadonlyArray<Condition> | undefined\n  ): Result<ConditionSet> {\n    /* c8 ignore next 2 - code coverage is flaky */\n    declared = declared ?? {};\n    parent = parent ?? [];\n\n    const { value: conditionDecls, message } = ResourceJson.Convert.conditionSetDecl.convert(declared);\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (message !== undefined) {\n      return fail(message);\n    }\n\n    return mapResults(\n      // get or add all declared conditions from our condition collector\n      conditionDecls.map((decl) => conditionSets.conditions.validating.getOrAdd(decl))\n    ).onSuccess((declaredConditions) => {\n      // make sure our parent conditions all come from our condition collector too\n      return mapResults(parent.map((c) => conditionSets.conditions.getOrAdd(c))).onSuccess(\n        (parentConditions) => {\n          const conditions = [...parentConditions, ...declaredConditions];\n          return conditionSets.validating.getOrAdd(conditions);\n        }\n      );\n    });\n  }\n\n  /**\n   * Finds the qualifiers that are made irrelevant by the supplied filterForContext.\n   * @param candidates - The candidates to find the reducible qualifiers for.\n   * @param filterForContext - The filter for context to use.\n   * @returns The qualifiers that are made irrelevant by the filterForContext.\n   * @remarks\n   * For any given set of candidates, qualifiers that match every candidate perfectly\n   * are irrelevant to the filtered content and can be removed.  Qualifiers that do not\n   * match, that are not in the filterForContext, or which partially match at least one\n   * candidate remain relevant and must not be removed.\n   * @public\n   */\n  public static findReducibleQualifiers(\n    candidates: ReadonlyArray<ResourceCandidate>,\n    filterForContext: Context.IValidatedContextDecl\n  ): ReadonlySet<QualifierName> | undefined {\n    const qualifiersToReduce = new Set<QualifierName>(Object.keys(filterForContext) as QualifierName[]);\n    for (const candidate of candidates) {\n      for (const condition of candidate.conditions.conditions) {\n        if (qualifiersToReduce.has(condition.qualifier.name)) {\n          const match = condition.qualifier.type.matches(\n            condition.value,\n            filterForContext[condition.qualifier.name],\n            'matches'\n          );\n          if (match !== PerfectMatch) {\n            qualifiersToReduce.delete(condition.qualifier.name);\n          }\n        }\n      }\n    }\n    return qualifiersToReduce.size > 0 ? qualifiersToReduce : undefined;\n  }\n}\n"]}

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

@@ -0,0 +1,220 @@
+import { Collections, DetailedResult, Result, ValidatingResultMap } from '@fgv/ts-utils';
+import { ConditionCollector, ConditionSetCollector, ReadOnlyConditionCollector, ReadOnlyConditionSetCollector } from '../conditions';
+import { AbstractDecisionCollector, ReadOnlyAbstractDecisionCollector } from '../decisions';
+import { IReadOnlyQualifierCollector } from '../qualifiers';
+import { ReadOnlyResourceTypeCollector } from '../resource-types';
+import { ResourceId } from '../common';
+import { IResourceManager } from '../runtime';
+import { ResourceBuilder, ResourceBuilderResultDetail } from './resourceBuilder';
+import { Resource } from './resource';
+import { ResourceCandidate } from './resourceCandidate';
+import { IResourceDeclarationOptions } from './common';
+import * as ResourceJson from '../resource-json';
+import * as Context from '../context';
+/**
+ * Interface for parameters to the {@link Resources.ResourceManagerBuilder.create | ResourceManagerBuilder create method}.
+ * @public
+ */
+export interface IResourceManagerBuilderCreateParams {
+    qualifiers: IReadOnlyQualifierCollector;
+    resourceTypes: ReadOnlyResourceTypeCollector;
+}
+/**
+ * Error details that can be returned by a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.
+ * @public
+ */
+export type ResourceManagerBuilderResultDetail = Collections.ResultMapResultDetail | ResourceBuilderResultDetail;
+/**
+ * Builder for a collection of {@link Resources.Resource | resources}. Collects
+ * {@link Resources.ResourceCandidate | candidates} for each resource into a
+ * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,
+ * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.
+ * @public
+ */
+export declare class ResourceManagerBuilder implements IResourceManager {
+    readonly qualifiers: IReadOnlyQualifierCollector;
+    readonly resourceTypes: ReadOnlyResourceTypeCollector;
+    protected readonly _conditions: ConditionCollector;
+    protected readonly _conditionSets: ConditionSetCollector;
+    protected readonly _decisions: AbstractDecisionCollector;
+    protected readonly _resources: ValidatingResultMap<ResourceId, ResourceBuilder>;
+    readonly _builtResources: ValidatingResultMap<ResourceId, Resource>;
+    protected _built: boolean;
+    /**
+     * A {@link Conditions.ConditionCollector | ConditionCollector} which
+     * contains the {@link Conditions.Condition | conditions} used so far by
+     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
+     */
+    get conditions(): ReadOnlyConditionCollector;
+    /**
+     * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which
+     * contains the {@link Conditions.ConditionSet | condition sets} used so far by
+     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
+     */
+    get conditionSets(): ReadOnlyConditionSetCollector;
+    /**
+     * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which
+     * contains the {@link Decisions.Decision | abstract decisions} used so far by
+     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
+     */
+    get decisions(): ReadOnlyAbstractDecisionCollector;
+    /**
+     * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.
+     */
+    get resources(): Collections.IReadOnlyValidatingResultMap<ResourceId, ResourceBuilder>;
+    /**
+     * The number of {@link Resources.Resource | resources} contained by the manager.
+     */
+    get size(): number;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numResources}
+     */
+    get numResources(): number;
+    /**
+     * The number of candidates in this resource manager.
+     */
+    protected _numCandidates?: number;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.numCandidates}
+     */
+    get numCandidates(): number;
+    /**
+     * {@inheritdoc Runtime.IResourceManager.builtResources}
+     */
+    get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>;
+    /**
+     * Constructor for a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.
+     * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.
+     * @public
+     */
+    protected constructor(params: IResourceManagerBuilderCreateParams);
+    /**
+     * Creates a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.
+     * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.
+     * @returns `Success` with the new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params: IResourceManagerBuilderCreateParams): Result<ResourceManagerBuilder>;
+    /**
+     * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
+     * a {@link Resources.ResourceCandidate | candidate} to the manager.
+     * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.
+     * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    addLooseCandidate(decl: ResourceJson.Json.ILooseResourceCandidateDecl): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail>;
+    addResource(decl: ResourceJson.Json.ILooseResourceDecl): DetailedResult<ResourceBuilder, ResourceBuilderResultDetail>;
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} present in the manager.
+     * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder} if successful,
+     * or `Failure` with an error message if not.
+     */
+    getAllResources(): ReadonlyArray<ResourceBuilder>;
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} present in the manager.
+     */
+    getAllCandidates(): ReadonlyArray<ResourceCandidate>;
+    /**
+     * Gets an individual {@link Resources.Resource | built resource} from the manager.
+     * @param id - The {@link ResourceId | id} of the resource to get.
+     * @returns `Success` with the resource if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getBuiltResource(id: string): Result<Resource>;
+    /**
+     * Validates a context declaration against the qualifiers managed by this resource manager.
+     * @param context - The context declaration to validate
+     * @returns Success with the validated context if successful, Failure otherwise
+     * @public
+     */
+    validateContext(context: Context.IContextDecl): Result<Context.IValidatedContextDecl>;
+    /**
+     * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.
+     * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getAllBuiltResources(): Result<ReadonlyArray<Resource>>;
+    /**
+     * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.
+     * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getAllBuiltCandidates(): Result<ReadonlyArray<ResourceCandidate>>;
+    /**
+     * Internal helper method that performs the actual building of resources.
+     * @returns `Success` with the built resources if all resources were built successfully, `Failure` otherwise.
+     * @internal
+     */
+    _performBuild(): Result<Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>>;
+    /**
+     * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.
+     * @returns `Success` with the {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    build(): Result<this>;
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns A read-only array of {@link Resources.ResourceCandidate | candidates} that can match the context.
+     * @public
+     */
+    getCandidatesForContext(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): ReadonlyArray<ResourceCandidate>;
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} that have at least one candidate
+     * that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns A read-only array of {@link Resources.ResourceBuilder | resource builders} with matching candidates.
+     * @public
+     */
+    getResourcesForContext(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): ReadonlyArray<ResourceBuilder>;
+    /**
+     * Gets a read-only array of all {@link Resources.ResourceCandidate | built resource candidates} that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns `Success` with an array of {@link Resources.ResourceCandidate | candidates} if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getBuiltCandidatesForContext(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): Result<ReadonlyArray<ResourceCandidate>>;
+    /**
+     * Gets a read-only array of all {@link Resources.Resource | built resources} that have at least one candidate
+     * that can match the supplied context.
+     * @param context - The {@link Context.IValidatedContextDecl | context} to match against.
+     * @param options - {@link Context.IContextMatchOptions | options} for the context match.
+     * @returns `Success` with an array of {@link Resources.Resource | resources} if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    getBuiltResourcesForContext(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): Result<ReadonlyArray<Resource>>;
+    /**
+     * Gets a compiled resource collection from the current state of the resource manager builder.
+     * This method generates an optimized, index-based representation of all resources, conditions,
+     * and decisions that can be used for serialization or efficient runtime processing.
+     * @param options - Optional compilation options controlling the output format.
+     * @returns Success with the compiled resource collection if successful, Failure otherwise.
+     * @public
+     */
+    getCompiledResourceCollection(options?: ResourceJson.Compiled.ICompiledResourceOptions): Result<ResourceJson.Compiled.ICompiledResourceCollection>;
+    /**
+     * Gets a resource collection declaration containing all built resources in a flat array structure.
+     * This method returns all built resources as an {@link ResourceJson.Normalized.IResourceCollectionDecl | IResourceCollectionDecl}
+     * that can be used for serialization, export, or re-import. Resources are sorted by ID for consistent ordering.
+     * @param options - Optional {@link Resources.IResourceDeclarationOptions | declaration options} controlling the output format.
+     * If `options.normalized` is `true`, applies hash-based normalization for additional consistency guarantees.
+     * @returns Success with the resource collection declaration if successful, Failure otherwise.
+     * @public
+     */
+    getResourceCollectionDecl(options?: IResourceDeclarationOptions): Result<ResourceJson.Normalized.IResourceCollectionDecl>;
+    /**
+     * Creates a filtered clone of this ResourceManagerBuilder using the specified context.
+     * This is a convenience method that creates a new ResourceManagerBuilder with the same
+     * configuration but filtered to include only candidates that match the provided context.
+     * @param options - Options for the cloning operation, including the strongly-typed filterForContext property.
+     * @returns A Result containing the new filtered ResourceManagerBuilder.
+     * @public
+     */
+    clone(options?: IResourceDeclarationOptions): Result<ResourceManagerBuilder>;
+}
+//# sourceMappingURL=resourceManagerBuilder.d.ts.map

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

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