@fgv/ts-res 5.0.0-3 → 5.0.0-31

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"resourceDeclContainer.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclContainer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Normalized from './normalized';\n\n/**\n * Generic container for resource and resource candidate\n * declarations.\n * @public\n */\nexport interface IResourceDeclContainer {\n  /**\n   * Optional initial {@link ResourceJson.Normalized.IContainerContextDecl | resource context}\n   * declaration for the container.\n   */\n  readonly context?: Normalized.IContainerContextDecl;\n\n  /**\n   * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource}\n   * declarations for all resources in the container, including children.\n   */\n  getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl>;\n\n  /**\n   * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate}\n   * declarations for all resources in the container, including children.\n   */\n  getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl>;\n}\n"]}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"resourceDeclTree.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclTree.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAA8F;AAE9F,mDAAqC;AAGrC,sCAAqD;AACrD,uCAA+C;AAE/C;;;;GAIG;AACH,MAAa,gBAAgB;IAO3B;;OAEG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC3B,CAAC;IAKD,YAAsB,IAAsC;;QAHlD,eAAU,GAAoC,EAAE,CAAC;QACjD,gBAAW,GAA6C,EAAE,CAAC;QAGnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,EAAE,GAAG,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,CAAC;QAChC,MAAM,UAAU,GAAG,MAAA,IAAI,CAAC,OAAO,0CAAE,UAAU,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,IAAa;QAChC,OAAO,OAAO,CAAC,oBAAoB;aAChC,OAAO,CAAC,IAAI,CAAC;aACb,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,0BAA0B,GAAG,EAAE,CAAC;aACzD,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,QAAQ,CACd,IAA2C,EAC3C,UAAmB,EACnB,gBAA0D;;QAE1D,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAE1D,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,SAAS,mCAAI,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC/D,IAAA,4BAAkB,EAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,CAAC,CACjE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAA,qBAAU,EAAC,eAAe,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAE1F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAA,IAAI,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,CAAC;QACjE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE;YACrC,gBAAa,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC;iBAC5C,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;gBACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACtF,CAAC,CAAC;iBACD,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF;AAhFD,4CAgFC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport { mergeChildResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root}.\n * @public\n */\nexport class ResourceDeclTree implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}\n   * being processed.\n   */\n  public readonly tree: Normalized.IResourceTreeRootDecl;\n\n  /**\n   * {@inheritdoc ResourceJson.IResourceDeclContainer.context}\n   */\n  public get context(): Normalized.IContainerContextDecl | undefined {\n    return this.tree.context;\n  }\n\n  protected _resources: Normalized.ILooseResourceDecl[] = [];\n  protected _candidates: Normalized.ILooseResourceCandidateDecl[] = [];\n\n  protected constructor(tree: Normalized.IResourceTreeRootDecl) {\n    this.tree = tree;\n    const id = tree.context?.baseId;\n    const conditions = tree.context?.conditions;\n    this._extract(tree, id, conditions).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclTree | ResourceDeclTree} from an\n   * untyped {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new tree if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclTree> {\n    return Convert.resourceTreeRootDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource tree: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclTree(decl));\n      });\n  }\n\n  /**\n   * Gets the loose resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}\n   * extracted from the collection.\n   */\n  public getImporterResources(): ReadonlyArray<Normalized.ILooseResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the loose candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getImporterCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    node: Normalized.IResourceTreeChildNodeDecl,\n    parentName?: string,\n    parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n\n    const resourceEntries = Array.from(Object.entries(node.resources ?? {}));\n    const mergedResources = resourceEntries.map(([name, resource]) =>\n      mergeChildResource(resource, name, parentName, parentConditions)\n    );\n    this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n    const children = Array.from(Object.entries(node.children ?? {}));\n    children.forEach(([name, childNode]) => {\n      CommonHelpers.joinResourceIds(parentName, name)\n        .onSuccess((childName) => {\n          return this._extract(childNode, childName, parentConditions).aggregateError(errors);\n        })\n        .aggregateError(errors);\n    });\n    return errors.returnOrReport(succeed(this));\n  }\n}\n"]}

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

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

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

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AAI5B,0BAAO;AAFhB,yCAAuB","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Convert from './convert';\n\nexport * from './json';\n\nexport { Convert };\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/json.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Configuration for a {@link ResourceTypes.ResourceType | resource type}.\n * @public\n */\nexport interface IResourceTypeConfig {\n  name: string;\n  typeName: string;\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/helpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAQ,MAAM,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAO9F"}

package/lib/packlets/resource-types/helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAgBH,oEAOC;AArBD,4CAA6C;AAG7C,yDAAsD;AACtD,sCAAwD;AAExD;;;;;;;GAOG;AACH,SAAgB,4BAA4B,CAAC,MAA2B;IACtE,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,gBAAgB;aACrC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;aACpB,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mCAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAA,eAAI,EAAC,GAAG,MAAM,CAAC,QAAQ,0BAA0B,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { fail, Result } from '@fgv/ts-utils';\nimport { IResourceTypeConfig } from './config';\nimport { ResourceType } from './resourceType';\nimport { JsonResourceType } from './jsonResourceType';\nimport { Convert as CommonConverters } from '../common';\n\n/**\n * Creates a {@link ResourceTypes.ResourceType | ResourceType} from a configuration object.\n * @param config - The {@link ResourceTypes.Config.IResourceTypeConfig | configuration object}\n * containing the name and type name of the resource type.\n * @returns `Success` with the new {@link ResourceTypes.ResourceType | ResourceType}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function createResourceTypeFromConfig(config: IResourceTypeConfig): Result<ResourceType> {\n  if (config.typeName === 'json') {\n    return CommonConverters.resourceTypeName\n      .convert(config.name)\n      .onSuccess((key) => JsonResourceType.create({ key }));\n  }\n  return fail(`${config.typeName}: Unknown resource type.`);\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/lib/packlets/resource-types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAAmC;AAO1B,wBAAM;AALf,iDAA+B;AAC/B,0DAAwC;AACxC,qDAAmC;AACnC,4CAA0B","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Config from './config';\n\nexport * from './resourceType';\nexport * from './resourceTypeCollector';\nexport * from './jsonResourceType';\nexport * from './helpers';\n\nexport { Config };\n"]}

package/lib/packlets/resource-types/jsonResourceType.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonResourceType.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAgC,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,sCAAsC,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAW,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,UAAU,CAAC;IAC5D;;;;;OAKG;IACH,SAAS,aAAa,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAI3D;;;;;OAKG;WACW,MAAM,CAAC,MAAM,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAMtF;;OAEG;IAEI,mBAAmB,CAAC,KAAK,EAAE,sCAAsC,GAAG,MAAM,CAAC,UAAU,CAAC;IAI7F;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;IACtE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IACvE;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC;CAI1E"}

package/lib/packlets/resource-types/jsonResourceType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonResourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,oDAA6E;AAC7E,iDAAsF;AACtF,sCAAsD;AACtD,4CAAsD;AAoBtD;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,2BAAwB;IAC5D;;;;;OAKG;IACH,YAAsB,GAAqB,EAAE,KAAc;QACzD,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAAsC;;QACzD,OAAO,gBAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/E,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IAEI,mBAAmB,CAAC,KAA6C;QACtE,OAAO,yBAAc,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAcM,QAAQ,CAAC,IAAgB,EAAE,WAAqB;QACrD,OAAO,yBAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF;AA9CD,4CA8CC","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 { Converters as JsonConverters, JsonObject } from '@fgv/ts-json-base';\nimport { IResourceCandidateValidationProperties, ResourceType } from './resourceType';\nimport { Convert, ResourceTypeName } from '../common';\nimport { captureResult, Result } from '@fgv/ts-utils';\n\n/**\n * Parameters to create a {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n * @public\n */\nexport interface IJsonResourceTypeCreateParams {\n  /**\n   * Optional key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * Defaults to 'json'.\n   */\n  key?: string;\n\n  /**\n   * Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType}\n   * instance.\n   */\n  index?: number;\n}\n\n/**\n * Implementation of a {@link ResourceTypes.ResourceType | ResourceType} for JSON values.\n * @public\n */\nexport class JsonResourceType extends ResourceType<JsonObject> {\n  /**\n   * Protected {@link ResourceTypes.JsonResourceType | JsonResourceType} constructor for use by subclasses.\n   * Use {@link ResourceTypes.JsonResourceType.create | JsonResourceType.create} to create a new instance.\n   * @param key - The key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param index - Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   */\n  protected constructor(key: ResourceTypeName, index?: number) {\n    super(key, index);\n  }\n\n  /**\n   * Factory method to create a new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param params - {@link ResourceTypes.IJsonResourceTypeCreateParams | Parameters} to create the new instance.\n   * @returns `Success` with the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance if successful\n   * or `Failure` with an error message if not.\n   */\n  public static create(params?: IJsonResourceTypeCreateParams): Result<JsonResourceType> {\n    return Convert.resourceTypeName.convert(params?.key ?? 'json').onSuccess((key) => {\n      return captureResult(() => new JsonResourceType(key, params?.index));\n    });\n  }\n\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.validateDeclaration}\n   */\n\n  public validateDeclaration(props: IResourceCandidateValidationProperties): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(props.json);\n  }\n\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:1)}\n   */\n  public validate(json: JsonObject, isPartial: true): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:2)}\n   */\n  public validate(json: JsonObject, isPartial: false): Result<JsonObject>;\n  /**\n   * {@inheritdoc ResourceTypes.ResourceType.(validate:3)}\n   */\n  public validate(json: JsonObject, isPartial: boolean): Result<JsonObject>;\n  public validate(json: JsonObject, __isPartial?: boolean): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(json);\n  }\n}\n"]}

package/lib/packlets/resource-types/resourceType.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resourceType.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAGL,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,UAAU,EACX,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD;;;OAGG;IACH,EAAE,EAAE,UAAU,CAAC;IAEf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED;;;;;GAKG;AACH,8BAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,YAAY,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;IAC1G,OAAO,CAAC,YAAY,CAA+D;IACnF;;OAEG;IACH,IAAW,GAAG,IAAI,gBAAgB,CAEjC;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,iBAAiB,GAAG,SAAS,CAEhD;IAED,SAAS,aAAa,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM;IAS3D;;;;;;;OAOG;aACa,mBAAmB,CAAC,KAAK,EAAE,sCAAsC,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1G;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;IAEtE;;;;;;;OAOG;aACa,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtF;;OAEG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;CAG1D"}

package/lib/packlets/resource-types/resourceType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAGH,4CAAkE;AAClE,sCAOmB;AAgCnB;;;;;GAKG;AACH,MAAsB,YAAY;IAEhC;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,YAAsB,GAAqB,EAAE,KAAc;QACzD,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAW,CAAC,WAAW,CAAsC;YACnF,GAAG;YACH,qDAAqD;YACrD,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;YACtF,cAAc,EAAE,gBAAa,CAAC,iBAAiB;SAChD,CAAC,CAAC;IACL,CAAC;IA0CD;;OAEG;IACI,QAAQ,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AAvED,oCAuEC","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 { JsonValue } from '@fgv/ts-json-base';\nimport { Collections, ICollectible, Result } from '@fgv/ts-utils';\nimport {\n  Convert as CommonConvert,\n  Validate,\n  ResourceTypeIndex,\n  ResourceTypeName,\n  ResourceValueMergeMethod,\n  ResourceId\n} from '../common';\n\n/**\n * Parameters used to validate a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}.\n * @public\n */\nexport interface IResourceCandidateValidationProperties {\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.id}\n   * @public\n   */\n  id: ResourceId;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.isPartial}\n   * @public\n   */\n  isPartial: boolean;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.json}\n   * @public\n   */\n  json: JsonValue;\n\n  /**\n   * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.mergeMethod}\n   * @public\n   */\n  mergeMethod: ResourceValueMergeMethod;\n}\n\n/**\n * Abstract base class for resource types which are responsible for\n * validating and converting JSON values into the appropriate strongly-typed\n * resource value.\n * @public\n */\nexport abstract class ResourceType<T = unknown> implements ICollectible<ResourceTypeName, ResourceTypeIndex> {\n  private _collectible: Collections.Collectible<ResourceTypeName, ResourceTypeIndex>;\n  /**\n   * The key for this resource type.\n   */\n  public get key(): ResourceTypeName {\n    return this._collectible.key;\n  }\n\n  /**\n   * The index for this resource type.\n   */\n  public get index(): ResourceTypeIndex | undefined {\n    return this._collectible.index;\n  }\n\n  protected constructor(key: ResourceTypeName, index?: number) {\n    this._collectible = new Collections.Collectible<ResourceTypeName, ResourceTypeIndex>({\n      key,\n      /* c8 ignore next 1 - coverage having a rough time */\n      index: index !== undefined ? Validate.toResourceTypeIndex(index).orThrow() : undefined,\n      indexConverter: CommonConvert.resourceTypeIndex\n    });\n  }\n\n  /**\n   * Validates properties of a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration} for\n   * a resource instance value.\n   * @param props - The {@link ResourceTypes.IResourceCandidateValidationProperties | properties } to validate.\n   * @returns `Success` with the strongly-typed resource value if the JSON and merge method\n   * are valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validateDeclaration(props: IResourceCandidateValidationProperties): Result<T | Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - `true` indicates that the value is expected to be partial.\n   * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, isPartial: true): Result<Partial<T>>;\n\n  /**\n   * Validates a JSON value for use as a complete resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - `false` indicates that the value is expected to be complete.\n   * @returns `Success` with the strongly-typed resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, isPartial: false): Result<T>;\n\n  /**\n   * Validates a JSON value for use as a full or partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param isPartial - Indicates whether the value is expected to be partial.\n   * @returns `Success` with the strongly-typed full or partial resource value if\n   * the JSON is valid, `Failure` with an error message otherwise.\n   * @public\n   */\n  public abstract validate(json: JsonValue, isPartial?: boolean): Result<T | Partial<T>>;\n\n  /**\n   * Sets the index for this resource type.  Once set, the index cannot be changed.\n   */\n  public setIndex(index: number): Result<ResourceTypeIndex> {\n    return this._collectible.setIndex(index);\n  }\n}\n"]}

package/lib/packlets/resource-types/resourceTypeCollector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resourceTypeCollector.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceTypeCollector.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAiB,mBAAmB,EAAiB,MAAM,eAAe,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB,CAAC,YAAY,CAAC;IAC1E,SAAS,aAAa,EAAE,aAAa,EAAE,EAAE,8BAA8B;IAevE;;;;;OAKG;WACW,MAAM,CAAC,MAAM,CAAC,EAAE,8BAA8B,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAM5F,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC;CAM/D;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,WAAW,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC"}

package/lib/packlets/resource-types/resourceTypeCollector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resourceTypeCollector.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/resourceTypeCollector.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAuG;AACvG,iDAA8C;AAC9C,sCAAuE;AAUvE;;;GAGG;AACH,MAAa,qBAAsB,SAAQ,8BAAiC;IAC1E,YAAsB,EAAE,aAAa,EAAkC;QACrE,oDAAoD;QACpD,aAAa,GAAG,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,EAAE,CAAC;QAEpC,KAAK,CAAC;YACJ,UAAU,EAAE,IAAI,sBAAW,CAAC,kBAAkB,CAAiC;gBAC7E,GAAG,EAAE,gBAAa,CAAC,gBAAgB;gBACnC,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;aACrD,CAAC;SACH,CAAC,CAAC;QACH,aAAa,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YACrC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAAuC;QAC1D,oDAAoD;QACpD,MAAM,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;QACtB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAES,eAAe,CAAC,IAAa;QACrC,IAAI,IAAI,YAAY,2BAAY,EAAE,CAAC;YACjC,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,IAAA,eAAI,EAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;CACF;AAlCD,sDAkCC","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 { Collections, Result, fail, succeed, ValidatingCollector, captureResult } from '@fgv/ts-utils';\nimport { ResourceType } from './resourceType';\nimport { Convert as CommonConvert, ResourceTypeName } from '../common';\n\n/**\n * Parameters for creating a {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector}.\n * @public\n */\nexport interface IResourceCollectorCreateParams {\n  resourceTypes?: ResourceType[];\n}\n\n/**\n * Map {@link ResourceTypeName | resource type names} to {@link ResourceTypes.ResourceType | resource types}.\n * @public\n */\nexport class ResourceTypeCollector extends ValidatingCollector<ResourceType> {\n  protected constructor({ resourceTypes }: IResourceCollectorCreateParams) {\n    /* c8 ignore next 1 - coverage having a rough day */\n    resourceTypes = resourceTypes ?? [];\n\n    super({\n      converters: new Collections.KeyValueConverters<ResourceTypeName, ResourceType>({\n        key: CommonConvert.resourceTypeName,\n        value: (from: unknown) => this._toResourceType(from)\n      })\n    });\n    resourceTypes.forEach((resourceType) => {\n      this.add(resourceType).orThrow();\n    });\n  }\n\n  /**\n   * Creates a new {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector}.\n   * @param params - Optional for creating the new collector.\n   * @returns `Success` with the new instance, or `Failure` with an error\n   * message if the collector could not be created.\n   */\n  public static create(params?: IResourceCollectorCreateParams): Result<ResourceTypeCollector> {\n    /* c8 ignore next 1 - coverage having a rough day */\n    params = params ?? {};\n    return captureResult(() => new ResourceTypeCollector(params));\n  }\n\n  protected _toResourceType(from: unknown): Result<ResourceType> {\n    if (from instanceof ResourceType) {\n      return succeed(from);\n    }\n    return fail('Not a resource type.');\n  }\n}\n\n/**\n * A read-only version of {@link ResourceTypes.ResourceTypeCollector | ResourceTypeCollector}.\n * @public\n */\nexport type ReadOnlyResourceTypeCollector = Collections.IReadOnlyValidatingCollector<ResourceType>;\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"candidateReducer.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/candidateReducer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,UAAU,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAChF,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAA6B,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACpD,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6B;IAEjE;;;;OAIG;gBAED,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,EAAE,OAAO,CAAC,qBAAqB;IAiCjD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAWtC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAW/B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IA2E1B;;;;;;;OAOG;WACW,mCAAmC,CAC/C,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC,qBAAqB,GAC/C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC;IAyB1D;;;;;;;;OAQG;WACW,mCAAmC,CAC/C,EAAE,EAAE,UAAU,EACd,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,EAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC,qBAAqB,GAC/C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,2BAA2B,EAAE,CAAC;IA0B1D;;;;OAIG;IACI,eAAe,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC;CAuB5F"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"candidateReducer.js","sourceRoot":"","sources":["../../../src/packlets/resources/candidateReducer.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 { QualifierName, ResourceId, ResourceValueMergeMethod } from '../common';\nimport * as Context from '../context';\nimport * as ResourceJson from '../resource-json';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { JsonEditor } from '@fgv/ts-json';\nimport { Result, succeed, fail, mapResults } from '@fgv/ts-utils';\n\n/**\n * Action taken on a candidate during reduction processing.\n * @public\n */\nexport type CandidateAction = 'unchanged' | 'reduced' | 'suppressed';\n\n/**\n * Information about a candidate being processed by the reducer.\n * @public\n */\nexport interface ICandidateInfo {\n  readonly originalCandidate: ResourceCandidate;\n  action: CandidateAction;\n  conditions: ResourceJson.Json.ILooseConditionDecl[];\n  conditionSetKey: string;\n  readonly json?: JsonObject;\n}\n\n/**\n * Represents a reduced candidate after applying reduction logic.\n * @public\n */\nexport interface IReducedCandidate {\n  readonly candidate: ResourceCandidate;\n  readonly conditions: ResourceJson.Json.ConditionSetDecl;\n  readonly json?: JsonObject;\n  readonly isPartial?: boolean;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Manages candidate reduction logic for filtering and qualifier reduction operations.\n * Encapsulates the state and logic needed to consistently process candidates for reduction.\n * @public\n */\nexport class CandidateReducer {\n  private readonly _candidateInfos: ICandidateInfo[];\n  private readonly _filterForContext: Context.IValidatedContextDecl;\n  private readonly _qualifiersToReduce: ReadonlySet<QualifierName>;\n\n  /**\n   * Constructor for CandidateReducer.\n   * @param candidates - The set of candidates to potentially reduce\n   * @param filterForContext - Context to filter candidates against\n   */\n  public constructor(\n    candidates: ReadonlyArray<ResourceCandidate>,\n    filterForContext: Context.IValidatedContextDecl\n  ) {\n    this._filterForContext = filterForContext;\n\n    // Use existing logic to determine reducible qualifiers\n    this._qualifiersToReduce =\n      ResourceCandidate.findReducibleQualifiers(candidates, filterForContext) ?? new Set();\n\n    // Initialize candidate info array with initial reduction attempts\n    this._candidateInfos = candidates.map((candidate): ICandidateInfo => {\n      const filteredConditions = candidate.conditions.conditions.filter(\n        (c) => !this._qualifiersToReduce.has(c.qualifier.name)\n      );\n\n      const reducedConditions = filteredConditions.map((c) => c.toLooseConditionDecl());\n      const conditionSetKey = CandidateReducer._computeConditionSetKey(reducedConditions);\n\n      const action: CandidateAction =\n        filteredConditions.length < candidate.conditions.conditions.length ? 'reduced' : 'unchanged';\n\n      return {\n        originalCandidate: candidate,\n        action,\n        conditions: reducedConditions,\n        conditionSetKey,\n        json: undefined // Will be set later when needed\n      };\n    });\n\n    // Resolve collisions by reverting reduced candidates to unchanged when they collide\n    this._resolveCollisions();\n  }\n\n  /**\n   * Computes a string key for a set of condition declarations for collision detection.\n   * @param conditions - The conditions to compute a key for\n   * @returns A string key representing the condition set\n   */\n  private static _computeConditionSetKey(conditions: ResourceJson.Json.ILooseConditionDecl[]): string {\n    if (conditions.length === 0) {\n      return '{}';\n    }\n\n    // Sort conditions by qualifier name for consistent keys\n    const sortedConditions = [...conditions].sort((a, b) => a.qualifierName.localeCompare(b.qualifierName));\n    const pairs = sortedConditions.map((c) => `${c.qualifierName}:${c.value}`);\n    return `{${pairs.join(',')}}`;\n  }\n\n  /**\n   * Merges a partial candidate's JSON value into a base candidate's JSON value.\n   * @param baseJson - The base JSON value to merge into\n   * @param partialJson - The partial JSON value to merge from\n   * @returns The merged JSON value\n   * @internal\n   */\n  private static _mergeJsonValues(baseJson: JsonObject, partialJson: JsonObject): JsonObject {\n    // Create JsonEditor with array replacement behavior for candidate merging\n    const editor = JsonEditor.create({\n      merge: {\n        arrayMergeBehavior: 'replace'\n      }\n    }).orThrow(); // Should never fail with valid options\n\n    return editor.mergeObjectsInPlace({}, [baseJson, partialJson]).orThrow(); // Internal method should throw on error - this indicates a serious bug\n  }\n\n  /**\n   * Resolves collisions using smart collision resolution rules.\n   * - If a reduced candidate collides with an unchanged candidate and only one reduced candidate collides:\n   *   - If reduced candidate is complete: suppress unchanged, keep reduced\n   *   - If reduced candidate is partial: merge into unchanged, suppress reduced\n   * - Otherwise: revert reduced candidates to unchanged to avoid collisions\n   * @internal\n   */\n  private _resolveCollisions(): void {\n    let hasCollisions = true;\n    let iterationCount = 0;\n    const maxIterations = this._candidateInfos.length; // Safety limit\n\n    while (hasCollisions && iterationCount < maxIterations) {\n      hasCollisions = false;\n      iterationCount++;\n\n      // Group candidates by their condition set keys (excluding suppressed)\n      const conditionKeyGroups = new Map<string, ICandidateInfo[]>();\n\n      for (const candidateInfo of this._candidateInfos) {\n        if (candidateInfo.action !== 'suppressed') {\n          // Don't include suppressed candidates\n          const key = candidateInfo.conditionSetKey;\n          if (!conditionKeyGroups.has(key)) {\n            conditionKeyGroups.set(key, []);\n          }\n          conditionKeyGroups.get(key)!.push(candidateInfo);\n        }\n      }\n\n      // Apply smart collision resolution\n      for (const [, candidatesWithSameKey] of conditionKeyGroups) {\n        if (candidatesWithSameKey.length > 1) {\n          // Categorize candidates\n          const unchangedCandidates = candidatesWithSameKey.filter((c) => c.action === 'unchanged');\n          const reducedCandidates = candidatesWithSameKey.filter((c) => c.action === 'reduced');\n\n          if (unchangedCandidates.length === 1 && reducedCandidates.length === 1) {\n            // Simple case: one unchanged vs one reduced - apply smart resolution\n            const unchangedCandidate = unchangedCandidates[0];\n            const reducedCandidate = reducedCandidates[0];\n\n            if (!reducedCandidate.originalCandidate.isPartial) {\n              // Complete reduced candidate wins - suppress unchanged\n              unchangedCandidate.action = 'suppressed';\n              hasCollisions = true;\n            } else {\n              // Partial reduced candidate - merge into unchanged and suppress reduced\n              const mergedJson = CandidateReducer._mergeJsonValues(\n                unchangedCandidate.originalCandidate.json,\n                reducedCandidate.originalCandidate.json\n              );\n\n              // Update unchanged candidate with merged JSON, keeping its isPartial status\n              (unchangedCandidate as { json?: JsonObject }).json = mergedJson;\n\n              // Suppress the reduced candidate\n              reducedCandidate.action = 'suppressed';\n              hasCollisions = true;\n            }\n          } else {\n            // Complex collision case - revert all reduced candidates to unchanged\n            for (const candidateInfo of reducedCandidates) {\n              // Revert to original conditions and mark as unchanged\n              const originalConditions = candidateInfo.originalCandidate.conditions.conditions.map((c) =>\n                c.toLooseConditionDecl()\n              );\n              const originalKey = CandidateReducer._computeConditionSetKey(originalConditions);\n\n              // Update the candidate info to revert to original state\n              candidateInfo.action = 'unchanged';\n              candidateInfo.conditions = originalConditions;\n              candidateInfo.conditionSetKey = originalKey;\n\n              hasCollisions = true;\n            }\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Static convenience method to construct an array of properly reduced\n   * {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declarations}\n   * from a set of {@link Resources.ResourceCandidate | resource candidates}.\n   * @param candidates - The candidates to reduce\n   * @param filterForContext - Optional context to filter against\n   * @returns Result with array of reduced candidate declarations, or Failure if reduction fails\n   */\n  public static reduceToChildResourceCandidateDecls(\n    candidates: ReadonlyArray<ResourceCandidate>,\n    filterForContext?: Context.IValidatedContextDecl\n  ): Result<ResourceJson.Json.IChildResourceCandidateDecl[]> {\n    if (!filterForContext || Object.keys(filterForContext).length === 0) {\n      return succeed(candidates.map((candidate) => candidate.toChildResourceCandidateDecl()));\n    }\n\n    const reducer = new CandidateReducer(candidates, filterForContext);\n    const reductionResults = mapResults(candidates.map((candidate) => reducer.reduceCandidate(candidate)));\n\n    return reductionResults.onSuccess((reductions) => {\n      const validReductions = reductions.filter(\n        (reduction): reduction is IReducedCandidate => reduction !== undefined\n      );\n\n      return succeed(\n        validReductions.map((reduction) => ({\n          /* c8 ignore next 3 -- defense in depth */\n          json: reduction.json ?? reduction.candidate.json,\n          isPartial: reduction.isPartial ?? reduction.candidate.isPartial,\n          mergeMethod: reduction.mergeMethod ?? reduction.candidate.mergeMethod,\n          conditions: reduction.conditions\n        }))\n      );\n    });\n  }\n\n  /**\n   * Static convenience method to construct an array of properly reduced\n   * {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declarations}\n   * from a set of {@link Resources.ResourceCandidate | resource candidates}.\n   * @param id - The id of the resource\n   * @param candidates - The candidates to reduce\n   * @param filterForContext - Optional context to filter against\n   * @returns Result with array of reduced candidate declarations, or Failure if reduction fails\n   */\n  public static reduceToLooseResourceCandidateDecls(\n    id: ResourceId,\n    candidates: ReadonlyArray<ResourceCandidate>,\n    filterForContext?: Context.IValidatedContextDecl\n  ): Result<ResourceJson.Json.ILooseResourceCandidateDecl[]> {\n    if (!filterForContext || Object.keys(filterForContext).length === 0) {\n      return succeed(candidates.map((candidate) => candidate.toLooseResourceCandidateDecl()));\n    }\n\n    const reducer = new CandidateReducer(candidates, filterForContext);\n    const reductionResults = mapResults(candidates.map((candidate) => reducer.reduceCandidate(candidate)));\n\n    return reductionResults.onSuccess((reductions) => {\n      const validReductions = reductions.filter(\n        (reduction): reduction is IReducedCandidate => reduction !== undefined\n      );\n\n      return succeed(\n        validReductions.map((reduction) => ({\n          id,\n          /* c8 ignore next 3 -- defense in depth */\n          json: reduction.json ?? reduction.candidate.json,\n          isPartial: reduction.isPartial ?? reduction.candidate.isPartial,\n          mergeMethod: reduction.mergeMethod ?? reduction.candidate.mergeMethod,\n          conditions: reduction.conditions\n        }))\n      );\n    });\n  }\n\n  /**\n   * Reduces a single candidate according to the configured reduction rules.\n   * @param candidate - The candidate to reduce\n   * @returns Either a reduced candidate declaration or an error if the candidate is not found\n   */\n  public reduceCandidate(candidate: ResourceCandidate): Result<IReducedCandidate | undefined> {\n    const candidateInfo = this._candidateInfos.find((info) => info.originalCandidate === candidate);\n    if (!candidateInfo) {\n      return fail(`Candidate not found in reducer state`);\n    }\n\n    if (candidateInfo.action === 'suppressed') {\n      return succeed(undefined);\n    }\n\n    // Convert array of conditions back to ConditionSetDecl for compatibility\n    const conditionsAsRecord = candidateInfo.conditions.reduce((acc, condition) => {\n      return { ...acc, [condition.qualifierName]: condition.value };\n    }, {} as ResourceJson.Json.ConditionSetDecl);\n\n    return succeed({\n      candidate,\n      conditions: conditionsAsRecord,\n      json: candidateInfo.json ?? candidate.json,\n      isPartial: candidate.isPartial,\n      mergeMethod: candidate.mergeMethod\n    });\n  }\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/common.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,2BAA4B,SAAQ,YAAY,CAAC,OAAO,CAAC,mBAAmB;IAC3F;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAEzC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kCAAmC,SAAQ,YAAY,CAAC,QAAQ,CAAC,wBAAwB;IACxG;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/resources/common.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as ResourceJson from '../resource-json';\nimport { IValidatedContextDecl } from '../context';\n\n/**\n * Options for resource declaration operations with strongly-typed context filtering.\n * Extends the base IDeclarationOptions with proper type safety for context filtering.\n *\n * @example\n * ```typescript\n * // Preferred Result pattern with onSuccess chaining\n * resourceManager.validateContext({ language: 'en' })\n *   .onSuccess((validatedContext) => {\n *     return resourceManager.clone({ filterForContext: validatedContext });\n *   })\n *   .onSuccess((clonedManager) => {\n *     return clonedManager.getResourceCollectionDecl();\n *   })\n *   .onFailure((error) => {\n *     console.error('Failed to create filtered clone:', error);\n *   });\n * ```\n * @public\n */\nexport interface IResourceDeclarationOptions extends ResourceJson.Helpers.IDeclarationOptions {\n  /**\n   * If provided, filters resource candidates to only include those that can match the\n   * specified validated context. This provides strongly-typed context filtering.\n   *\n   * Use resourceManager.validateContext() to create a validated context from an IContextDecl.\n   */\n  filterForContext?: IValidatedContextDecl;\n\n  /**\n   * If true, reduces the qualifiers of the resource candidates by removing qualifiers that are made\n   * irrelevant by the filterForContext.\n   * @defaultValue false\n   */\n  reduceQualifiers?: boolean;\n\n  /**\n   * Whether to include metadata in compiled outputs.\n   * Metadata includes human-readable information like semantic keys\n   * that can be useful for debugging or tooling.\n   * @defaultValue false\n   */\n  includeMetadata?: boolean;\n}\n\n/**\n * Extended compiled resource options that includes context filtering capabilities.\n * This interface combines the standard compilation options with strongly-typed\n * context filtering for resource candidates.\n * @public\n */\nexport interface ICompiledResourceOptionsWithFilter extends ResourceJson.Compiled.ICompiledResourceOptions {\n  /**\n   * If provided, filters resource candidates to only include those that can match the\n   * specified validated context. This provides strongly-typed context filtering.\n   *\n   * Use resourceManager.validateContext() to create a validated context from an IContextDecl.\n   */\n  filterForContext?: IValidatedContextDecl;\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/index.ts"],"names":[],"mappings":"AAsBA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resources/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,qDAAmC;AACnC,sDAAoC;AACpC,6CAA2B;AAC3B,oDAAkC;AAClC,2DAAyC;AACzC,2CAAyB","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\nexport * from './candidateReducer';\nexport * from './resourceCandidate';\nexport * from './resource';\nexport * from './resourceBuilder';\nexport * from './resourceManagerBuilder';\nexport * from './common';\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resource.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAqB,MAAM,EAAgC,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,UAAU,EAAY,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,kCAAkC,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;OAEG;IACH,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC7C;;OAEG;IACH,SAAS,EAAE,yBAAyB,CAAC;CACtC;AAED;;;;GAIG;AACH,qBAAa,QAAS,YAAW,SAAS;IACxC;;OAEG;IACH,SAAgB,EAAE,EAAE,UAAU,CAAC;IAC/B;;OAEG;IACH,SAAgB,aAAa,EAAE,YAAY,CAAC;IAC5C;;OAEG;IACH,SAAgB,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC7D;;OAEG;IACH,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAE3C;;OAEG;IACH,IAAW,YAAY,IAAI,YAAY,CAEtC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,qBAAqB;IAiBnD;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAIrE;;;;;OAKG;IACI,uBAAuB,CAC5B,OAAO,EAAE,OAAO,CAAC,qBAAqB,EACtC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,GACrC,aAAa,CAAC,iBAAiB,CAAC;IAInC;;;;OAIG;IACI,mBAAmB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,YAAY,CAAC,IAAI,CAAC,kBAAkB;IAevG;;;;OAIG;IACI,mBAAmB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,YAAY,CAAC,IAAI,CAAC,kBAAkB;IAgBvG;;;;;OAKG;IACI,UAAU,CACf,OAAO,CAAC,EAAE,2BAA2B,GAAG,kCAAkC,GACzE,YAAY,CAAC,QAAQ,CAAC,iBAAiB;IAiB1C;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IAkB5C;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAevC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;IAuB9C;;;;;;;OAOG;IACH,SAAS,CAAC,sBAAsB,CAC9B,OAAO,CAAC,EAAE,2BAA2B,GAAG,kCAAkC,GACzE,aAAa,CAAC,iBAAiB,CAAC;CASpC"}

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"resourceManagerBuilder.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceManagerBuilder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAauB;AACvB,8CAKuB;AACvB,4CAA4F;AAG5F,sCAA0D;AAE1D,uDAAiF;AACjF,yCAAsC;AAGtC,+DAAiD;AACjD,oDAAsC;AAmBtC;;;;;;GAMG;AACH,MAAa,sBAAsB;IAYjC;;;;OAIG;IACH,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAOD;;OAEG;IACH,IAAW,aAAa;QACtB,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,YAAsB,MAA2C;QAC/D,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,+BAAkB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1F,IAAI,CAAC,cAAc,GAAG,kCAAqB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/F,IAAI,CAAC,UAAU,GAAG,qCAAyB,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACrG,IAAI,CAAC,UAAU,GAAG,IAAI,8BAAmB,CAAC;YACxC,UAAU,EAAE,IAAI,sBAAW,CAAC,kBAAkB,CAA8B;gBAC1E,GAAG,EAAE,gBAAO,CAAC,UAAU;gBACvB,gEAAgE;gBAChE,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CACvB,IAAI,YAAY,iCAAe,CAAC,CAAC,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,eAAI,EAAC,wBAAwB,CAAC;aACnF,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,GAAG,IAAI,8BAAmB,CAAC;YAC7C,UAAU,EAAE,IAAI,sBAAW,CAAC,kBAAkB,CAAuB;gBACnE,GAAG,EAAE,gBAAO,CAAC,UAAU;gBACvB,gEAAgE;gBAChE,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,IAAI,YAAY,mBAAQ,CAAC,CAAC,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,eAAI,EAAC,gBAAgB,CAAC,CAAC;aAC9F,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,MAA2C;QAC9D,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;OAMG;IACI,iBAAiB,CACtB,IAAmD;QAEnD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,iBAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAA,yBAAc,EAAC,GAAG,EAAE,kBAAkB,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CACtD,iCAAe,CAAC,MAAM,CAAC;YACrB,EAAE;YACF,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC,CACH,CAAC;QACF,gEAAgE;QAChE,IAAI,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC;YAC9B,OAAO,IAAA,yBAAc,EACnB,GAAG,EAAE,oCAAoC,aAAa,CAAC,OAAO,EAAE,EAChE,aAAa,CAAC,MAAM,CACrB,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,OAAO,IAAA,4BAAiB,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,WAAW,CAChB,IAA0C;;QAE1C,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,iBAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAA,yBAAc,EAAC,GAAG,EAAE,kBAAkB,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,EACJ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,MAAM,EACP,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CACpC,iCAAe,CAAC,MAAM,CAAC;YACrB,EAAE;YACF,QAAQ,EAAE,IAAI,CAAC,gBAAgB;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC,CACH,CAAC;QACF,gEAAgE;QAChE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,IAAA,yBAAc,EAAC,GAAG,EAAE,oCAAoC,eAAe,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACnE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,IAAA,yBAAc,EAAC,GAAG,EAAE,kCAAkC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,MAAA,IAAI,CAAC,UAAU,mCAAI,EAAE,CAAC;QACzC,OAAO,IAAA,qBAAU,EAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;aACnE,SAAS,CAAC,GAAG,EAAE;YACd,OAAO,IAAA,kBAAO,EAAC,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC;aACD,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACI,eAAe;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACI,gBAAgB;QACrB,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,EAAU;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU;aAC9B,GAAG,CAAC,EAAE,CAAC;aACP,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjG,CAAC;IAED;;;;;OAKG;IACH,uFAAuF;IAChF,eAAe,CAAC,OAA6B;QAClD,OAAO,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE;YAC3D,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CACxC,IAAA,kBAAO,EAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC/F,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,kBAAO,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvG,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YAChC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QACH,gEAAgE;QAChE,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,IAAA,eAAI,EAAC,iBAAiB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACI,KAAK;QACV,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;OAMG;IACI,uBAAuB,CAC5B,OAAsC,EACtC,OAAsC;QAEtC,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3G,CAAC;IAED;;;;;;;OAOG;IACI,sBAAsB,CAC3B,OAAsC,EACtC,OAAsC;QAEtC,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAClC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAC5E,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,4BAA4B,CACjC,OAAsC,EACtC,OAAsC;QAEtC,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE,CAC3D,IAAA,kBAAO,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAC9F,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,2BAA2B,CAChC,OAAsC,EACtC,OAAsC;QAEtC,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CACzD,IAAA,kBAAO,EAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CACvG,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,6BAA6B,CAClC,OAAwD;QAExD,wDAAwD;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;YAC5B,OAAO,IAAA,eAAI,EAAC,8BAA8B,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,oFAAoF;QACpF,iIAAiI;QACjI,MAAM,YAAY,GAAG;YACnB,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC/E,IAAI,EAAE,EAAE,CAAC,IAAI;aACd,CAAC,CAAC;YACH,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3D,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAM;gBACnB,eAAe,EAAE,CAAC,CAAC,eAAe;aACnC,CAAC,CAAC;YACH,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAClE,IAAI,EAAE,EAAE,CAAC,GAAG;aACb,CAAC,CAAC;YACH,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnF,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC3F,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACjF,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;SACvF,CAAC;QAEF,yCAAyC;QACzC,OAAO,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;OAQG;IACI,yBAAyB,CAC9B,OAAqC;QAErC,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE;YACzC,qEAAqE;YACrE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3E,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CACtC,CAAC;YAEF,+CAA+C;YAC/C,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEnD,8CAA8C;YAC9C,MAAM,cAAc,GAAG;gBACrB,SAAS;aACV,CAAC;YAEF,sDAAsD;YACtD,OAAO,YAAY,CAAC,OAAO,CAAC,sBAAsB;iBAC/C,OAAO,CAAC,cAAc,CAAC;iBACvB,SAAS,CAAC,CAAC,kBAAkB,EAAE,EAAE;gBAChC,mDAAmD;gBACnD,IAAI,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,MAAK,IAAI,EAAE,CAAC;oBACjC,MAAM,UAAU,GAAG,IAAI,eAAI,CAAC,eAAe,EAAE,CAAC;oBAC9C,OAAO,UAAU;yBACd,SAAS,CAAC,kBAAkB,CAAC;yBAC7B,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,4CAA4C,CAAC,EAAE,CAAC,CAAC;gBAC7E,CAAC;gBACD,OAAO,IAAA,kBAAO,EAAC,kBAAkB,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,wFAAwF;IACjF,KAAK,CAAC,OAAqC;QAChD,OAAO,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACtE,OAAO,sBAAsB,CAAC,MAAM,CAAC;gBACnC,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC1B,oEAAoE;gBACpE,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;oBACzB,KAAK,MAAM,YAAY,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;wBAChD,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;wBACvD,IAAI,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC;4BAC1B,OAAO,IAAA,eAAI,EACT,GAAG,YAAY,CAAC,EAAE,+CAA+C,SAAS,CAAC,OAAO,EAAE,CACrF,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,OAAO,IAAA,kBAAO,EAAC,UAAU,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAvdD,wDAudC","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  captureResult,\n  Collections,\n  DetailedResult,\n  fail,\n  failWithDetail,\n  Hash,\n  mapResults,\n  MessageAggregator,\n  Result,\n  succeed,\n  succeedWithDetail,\n  ValidatingResultMap\n} from '@fgv/ts-utils';\nimport {\n  ConditionCollector,\n  ConditionSetCollector,\n  ReadOnlyConditionCollector,\n  ReadOnlyConditionSetCollector\n} from '../conditions';\nimport { AbstractDecisionCollector, ReadOnlyAbstractDecisionCollector } from '../decisions';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\nimport { ReadOnlyResourceTypeCollector } from '../resource-types';\nimport { Convert, ResourceId, Validate } from '../common';\nimport { IResourceManager } from '../runtime';\nimport { ResourceBuilder, ResourceBuilderResultDetail } from './resourceBuilder';\nimport { Resource } from './resource';\nimport { ResourceCandidate } from './resourceCandidate';\nimport { IResourceDeclarationOptions } from './common';\nimport * as ResourceJson from '../resource-json';\nimport * as Context from '../context';\n\n/**\n * Interface for parameters to the {@link Resources.ResourceManagerBuilder.create | ResourceManagerBuilder create method}.\n * @public\n */\nexport interface IResourceManagerBuilderCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  resourceTypes: ReadOnlyResourceTypeCollector;\n}\n\n/**\n * Error details that can be returned by a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.\n * @public\n */\nexport type ResourceManagerBuilderResultDetail =\n  | Collections.ResultMapResultDetail\n  | ResourceBuilderResultDetail;\n\n/**\n * Builder for a collection of {@link Resources.Resource | resources}. Collects\n * {@link Resources.ResourceCandidate | candidates} for each resource into a\n * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,\n * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.\n * @public\n */\nexport class ResourceManagerBuilder implements IResourceManager {\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n  public readonly resourceTypes: ReadOnlyResourceTypeCollector;\n\n  protected readonly _conditions: ConditionCollector;\n  protected readonly _conditionSets: ConditionSetCollector;\n  protected readonly _decisions: AbstractDecisionCollector;\n  protected readonly _resources: ValidatingResultMap<ResourceId, ResourceBuilder>;\n  public readonly _builtResources: ValidatingResultMap<ResourceId, Resource>;\n\n  protected _built: boolean;\n\n  /**\n   * A {@link Conditions.ConditionCollector | ConditionCollector} which\n   * contains the {@link Conditions.Condition | conditions} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get conditions(): ReadOnlyConditionCollector {\n    return this._conditions;\n  }\n\n  /**\n   * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which\n   * contains the {@link Conditions.ConditionSet | condition sets} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get conditionSets(): ReadOnlyConditionSetCollector {\n    return this._conditionSets;\n  }\n\n  /**\n   * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which\n   * contains the {@link Decisions.Decision | abstract decisions} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get decisions(): ReadOnlyAbstractDecisionCollector {\n    return this._decisions;\n  }\n\n  /**\n   * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.\n   */\n  public get resources(): Collections.IReadOnlyValidatingResultMap<ResourceId, ResourceBuilder> {\n    return this._resources;\n  }\n\n  /**\n   * The number of {@link Resources.Resource | resources} contained by the manager.\n   */\n  public get size(): number {\n    return this._resources.size;\n  }\n\n  /**\n   * {@inheritdoc Runtime.IResourceManager.numResources}\n   */\n  public get numResources(): number {\n    return this._resources.size;\n  }\n\n  /**\n   * The number of candidates in this resource manager.\n   */\n  protected _numCandidates?: number;\n\n  /**\n   * {@inheritdoc Runtime.IResourceManager.numCandidates}\n   */\n  public get numCandidates(): number {\n    if (this._numCandidates === undefined) {\n      this._numCandidates = this.getAllCandidates().length;\n    }\n    return this._numCandidates;\n  }\n\n  /**\n   * {@inheritdoc Runtime.IResourceManager.builtResources}\n   */\n  public get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, Resource> {\n    return this._performBuild().orThrow();\n  }\n\n  /**\n   * Constructor for a {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.\n   * @public\n   */\n  protected constructor(params: IResourceManagerBuilderCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.resourceTypes = params.resourceTypes;\n    this._conditions = ConditionCollector.create({ qualifiers: params.qualifiers }).orThrow();\n    this._conditionSets = ConditionSetCollector.create({ conditions: this._conditions }).orThrow();\n    this._decisions = AbstractDecisionCollector.create({ conditionSets: this._conditionSets }).orThrow();\n    this._resources = new ValidatingResultMap({\n      converters: new Collections.KeyValueConverters<ResourceId, ResourceBuilder>({\n        key: Convert.resourceId,\n        /* c8 ignore next 2 - defense in depth against internal error */\n        value: (from: unknown) =>\n          from instanceof ResourceBuilder ? succeed(from) : fail('not a resource builder')\n      })\n    });\n    this._builtResources = new ValidatingResultMap({\n      converters: new Collections.KeyValueConverters<ResourceId, Resource>({\n        key: Convert.resourceId,\n        /* c8 ignore next 1 - defense in depth against internal error */\n        value: (from: unknown) => (from instanceof Resource ? succeed(from) : fail('not a resource'))\n      })\n    });\n    this._built = false;\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder}.\n   * @returns `Success` with the new {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceManagerBuilderCreateParams): Result<ResourceManagerBuilder> {\n    return captureResult(() => new ResourceManagerBuilder(params));\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds\n   * a {@link Resources.ResourceCandidate | candidate} to the manager.\n   * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.\n   * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public addLooseCandidate(\n    decl: ResourceJson.Json.ILooseResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceBuilderResultDetail> {\n    const { value: id, message } = Validate.toResourceId(decl.id);\n    if (message !== undefined) {\n      return failWithDetail(`${id}: invalid id - ${message}`, 'failure');\n    }\n\n    const builderResult = this._resources.getOrAdd(id, () =>\n      ResourceBuilder.create({\n        id,\n        resourceTypes: this.resourceTypes,\n        conditionSets: this._conditionSets,\n        decisions: this._decisions\n      })\n    );\n    /* c8 ignore next 6 - defense in depth against internal error */\n    if (builderResult.isFailure()) {\n      return failWithDetail(\n        `${id}: unable to get or add resource\\n${builderResult.message}`,\n        builderResult.detail\n      );\n    }\n    return builderResult.value.addLooseCandidate(decl).onSuccess((c, d) => {\n      this._builtResources.delete(id);\n      this._built = false;\n      this._numCandidates = undefined;\n      return succeedWithDetail(c, d);\n    });\n  }\n\n  public addResource(\n    decl: ResourceJson.Json.ILooseResourceDecl\n  ): DetailedResult<ResourceBuilder, ResourceBuilderResultDetail> {\n    const { value: id, message } = Validate.toResourceId(decl.id);\n    if (message !== undefined) {\n      return failWithDetail(`${id}: invalid id - ${message}`, 'failure');\n    }\n\n    const {\n      value: builder,\n      message: getOrAddMessage,\n      detail\n    } = this._resources.getOrAdd(id, () =>\n      ResourceBuilder.create({\n        id,\n        typeName: decl.resourceTypeName,\n        resourceTypes: this.resourceTypes,\n        conditionSets: this._conditionSets,\n        decisions: this._decisions\n      })\n    );\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (getOrAddMessage !== undefined) {\n      return failWithDetail(`${id}: unable to get or add resource\\n${getOrAddMessage}`, detail);\n    }\n\n    if (detail === 'exists') {\n      const { message } = builder.setResourceType(decl.resourceTypeName);\n      if (message !== undefined) {\n        return failWithDetail(`${id}: unable to set resource type\\n${message}`, 'type-mismatch');\n      }\n    }\n\n    const candidates = decl.candidates ?? [];\n    return mapResults(candidates.map((c) => builder.addChildCandidate(c)))\n      .onSuccess(() => {\n        return succeed(builder);\n      })\n      .withDetail('failure', detail);\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} present in the manager.\n   * @returns `Success` with the {@link Resources.ResourceBuilder | resource builder} if successful,\n   * or `Failure` with an error message if not.\n   */\n  public getAllResources(): ReadonlyArray<ResourceBuilder> {\n    return Array.from(this._resources.values()).sort((a, b) => a.id.localeCompare(b.id));\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} present in the manager.\n   */\n  public getAllCandidates(): ReadonlyArray<ResourceCandidate> {\n    return this.getAllResources().flatMap((r) => r.candidates);\n  }\n\n  /**\n   * Gets an individual {@link Resources.Resource | built resource} from the manager.\n   * @param id - The {@link ResourceId | id} of the resource to get.\n   * @returns `Success` with the resource if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltResource(id: string): Result<Resource> {\n    return this._resources.validating\n      .get(id)\n      .onSuccess((builder) => this._builtResources.validating.getOrAdd(id, () => builder.build()));\n  }\n\n  /**\n   * Validates a context declaration against the qualifiers managed by this resource manager.\n   * @param context - The context declaration to validate\n   * @returns Success with the validated context if successful, Failure otherwise\n   * @public\n   */\n  /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */\n  public validateContext(context: Context.IContextDecl): Result<Context.IValidatedContextDecl> {\n    return Context.Convert.validatedContextDecl.convert(context, {\n      qualifiers: this.qualifiers\n    });\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.\n   * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getAllBuiltResources(): Result<ReadonlyArray<Resource>> {\n    return this.build().onSuccess((manager) =>\n      succeed(Array.from(manager._builtResources.values()).sort((a, b) => a.id.localeCompare(b.id)))\n    );\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.Resource | built resources} in the manager.\n   * @returns `Success` with an array of resources if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getAllBuiltCandidates(): Result<ReadonlyArray<ResourceCandidate>> {\n    return this.getAllBuiltResources().onSuccess((built) => succeed(built.flatMap((r) => r.candidates)));\n  }\n\n  /**\n   * Internal helper method that performs the actual building of resources.\n   * @returns `Success` with the built resources if all resources were built successfully, `Failure` otherwise.\n   * @internal\n   */\n  public _performBuild(): Result<Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>> {\n    if (this._built) {\n      return succeed(this._builtResources);\n    }\n\n    const errors: MessageAggregator = new MessageAggregator();\n    this._resources.forEach((r, id) => {\n      this._builtResources.getOrAdd(id, () => r.build()).aggregateError(errors);\n    });\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (errors.hasMessages) {\n      return fail(`build failed: ${errors.toString()}`);\n    }\n    this._built = true;\n    return succeed(this._builtResources);\n  }\n\n  /**\n   * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.\n   * @returns `Success` with the {@link Resources.ResourceManagerBuilder | ResourceManagerBuilder} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public build(): Result<this> {\n    return this._performBuild().onSuccess(() => succeed(this));\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceCandidate | resource candidates} that can match the supplied 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 A read-only array of {@link Resources.ResourceCandidate | candidates} that can match the context.\n   * @public\n   */\n  public getCandidatesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): ReadonlyArray<ResourceCandidate> {\n    return this.getAllCandidates().filter((candidate) => candidate.canMatchPartialContext(context, options));\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceBuilder | resource builders} that have at least one candidate\n   * that can match the supplied 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 A read-only array of {@link Resources.ResourceBuilder | resource builders} with matching candidates.\n   * @public\n   */\n  public getResourcesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): ReadonlyArray<ResourceBuilder> {\n    return this.getAllResources().filter(\n      (resource) => resource.getCandidatesForContext(context, options).length > 0\n    );\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.ResourceCandidate | built resource candidates} that can match the supplied 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 `Success` with an array of {@link Resources.ResourceCandidate | candidates} if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltCandidatesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): Result<ReadonlyArray<ResourceCandidate>> {\n    return this.getAllBuiltCandidates().onSuccess((candidates) =>\n      succeed(candidates.filter((candidate) => candidate.canMatchPartialContext(context, options)))\n    );\n  }\n\n  /**\n   * Gets a read-only array of all {@link Resources.Resource | built resources} that have at least one candidate\n   * that can match the supplied 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 `Success` with an array of {@link Resources.Resource | resources} if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltResourcesForContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): Result<ReadonlyArray<Resource>> {\n    return this.getAllBuiltResources().onSuccess((resources) =>\n      succeed(resources.filter((resource) => resource.getCandidatesForContext(context, options).length > 0))\n    );\n  }\n\n  /**\n   * Gets a compiled resource collection from the current state of the resource manager builder.\n   * This method generates an optimized, index-based representation of all resources, conditions,\n   * and decisions that can be used for serialization or efficient runtime processing.\n   * @param options - Optional compilation options controlling the output format.\n   * @returns Success with the compiled resource collection if successful, Failure otherwise.\n   * @public\n   */\n  public getCompiledResourceCollection(\n    options?: ResourceJson.Compiled.ICompiledResourceOptions\n  ): Result<ResourceJson.Compiled.ICompiledResourceCollection> {\n    // Build resources first to ensure all data is available\n    const buildResult = this._performBuild();\n    if (buildResult.isFailure()) {\n      return fail(`Failed to build resources: ${buildResult.message}`);\n    }\n\n    // Generate compiled data from internal collections using the new toCompiled methods\n    // Note: All objects have a defined index property due to the collector pattern - indices are assigned during collection building\n    const compiledData = {\n      qualifierTypes: Array.from(this.qualifiers.qualifierTypes.values()).map((qt) => ({\n        name: qt.name\n      })),\n      qualifiers: Array.from(this.qualifiers.values()).map((q) => ({\n        name: q.name,\n        type: q.type.index!,\n        defaultPriority: q.defaultPriority\n      })),\n      resourceTypes: Array.from(this.resourceTypes.values()).map((rt) => ({\n        name: rt.key\n      })),\n      conditions: Array.from(this._conditions.values()).map((c) => c.toCompiled(options)),\n      conditionSets: Array.from(this._conditionSets.values()).map((cs) => cs.toCompiled(options)),\n      decisions: Array.from(this._decisions.values()).map((d) => d.toCompiled(options)),\n      resources: Array.from(this._builtResources.values()).map((r) => r.toCompiled(options))\n    };\n\n    // Apply validation through the converter\n    return ResourceJson.Compiled.Convert.compiledResourceCollection.convert(compiledData);\n  }\n\n  /**\n   * Gets a resource collection declaration containing all built resources in a flat array structure.\n   * This method returns all built resources as an {@link ResourceJson.Normalized.IResourceCollectionDecl | IResourceCollectionDecl}\n   * that can be used for serialization, export, or re-import. Resources are sorted by ID for consistent ordering.\n   * @param options - Optional {@link Resources.IResourceDeclarationOptions | declaration options} controlling the output format.\n   * If `options.normalized` is `true`, applies hash-based normalization for additional consistency guarantees.\n   * @returns Success with the resource collection declaration if successful, Failure otherwise.\n   * @public\n   */\n  public getResourceCollectionDecl(\n    options?: IResourceDeclarationOptions\n  ): Result<ResourceJson.Normalized.IResourceCollectionDecl> {\n    return this._performBuild().onSuccess(() => {\n      // Get all built resources and convert to loose resource declarations\n      const resources = Array.from(this._builtResources.values()).map((resource) =>\n        resource.toLooseResourceDecl(options)\n      );\n\n      // Sort resources by ID for consistent ordering\n      resources.sort((a, b) => a.id.localeCompare(b.id));\n\n      // Create the collection declaration structure\n      const collectionData = {\n        resources\n      };\n\n      // Convert and validate using the normalized converter\n      return ResourceJson.Convert.resourceCollectionDecl\n        .convert(collectionData)\n        .onSuccess((compiledCollection) => {\n          // Apply hash-based normalization only if requested\n          if (options?.normalized === true) {\n            const normalizer = new Hash.Crc32Normalizer();\n            return normalizer\n              .normalize(compiledCollection)\n              .withErrorFormat((e) => `Failed to normalize resource collection: ${e}`);\n          }\n          return succeed(compiledCollection);\n        });\n    });\n  }\n\n  /**\n   * Creates a filtered clone of this ResourceManagerBuilder using the specified context.\n   * This is a convenience method that creates a new ResourceManagerBuilder with the same\n   * configuration but filtered to include only candidates that match the provided context.\n   * @param options - Options for the cloning operation, including the strongly-typed filterForContext property.\n   * @returns A Result containing the new filtered ResourceManagerBuilder.\n   * @public\n   */\n  /* c8 ignore next 21 - functional code path tested but coverage intermittently missed */\n  public clone(options?: IResourceDeclarationOptions): Result<ResourceManagerBuilder> {\n    return this.getResourceCollectionDecl(options).onSuccess((collection) => {\n      return ResourceManagerBuilder.create({\n        qualifiers: this.qualifiers,\n        resourceTypes: this.resourceTypes\n      }).onSuccess((newManager) => {\n        // Add each resource from the filtered collection to the new manager\n        if (collection.resources) {\n          for (const resourceDecl of collection.resources) {\n            const addResult = newManager.addResource(resourceDecl);\n            if (addResult.isFailure()) {\n              return fail(\n                `${resourceDecl.id}: Failed to add resource to cloned manager: ${addResult.message}`\n              );\n            }\n          }\n        }\n        return succeed(newManager);\n      });\n    });\n  }\n}\n"]}

package/lib/packlets/runtime/cacheListener.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cacheListener.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheListener.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElE;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnE;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpE;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,qBAAa,iCAAkC,YAAW,8BAA8B;IACtF;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxE;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzE;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1E;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;CAG5D"}

package/lib/packlets/runtime/cacheListener.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cacheListener.js","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheListener.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA+CH;;;GAGG;AACH,MAAa,iCAAiC;IAC5C;;OAEG;IACI,UAAU,CAAC,KAAgC,EAAE,KAAa;QAC/D,QAAQ;IACV,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,KAAgC,EAAE,KAAa;QAChE,QAAQ;IACV,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,KAAgC,EAAE,KAAa;QACjE,QAAQ;IACV,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,KAAgC;QAClD,QAAQ;IACV,CAAC;CACF;AA5BD,8EA4BC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Type indicating which {@link Runtime.ResourceResolver | ResourceResolver} cache is affected.\n * @public\n */\nexport type ResourceResolverCacheType = 'condition' | 'conditionSet' | 'decision';\n\n/**\n * Type indicating the action performed on a {@link Runtime.ResourceResolver | ResourceResolver} cache.\n * @public\n */\nexport type ResourceResolverCacheActivity = 'hit' | 'miss' | 'error' | 'clear';\n\n/**\n * A listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n * @public\n */\nexport interface IResourceResolverCacheListener {\n  /**\n   * Called when a cache hit occurs.\n   * @param cache - The type of cache that was hit.\n   * @param index - The index of the cache that was hit.\n   */\n  onCacheHit(cache: ResourceResolverCacheType, index: number): void;\n\n  /**\n   * Called when a cache miss occurs.\n   * @param cache - The type of cache that was missed.\n   * @param index - The index of the cache that was missed.\n   */\n  onCacheMiss(cache: ResourceResolverCacheType, index: number): void;\n\n  /**\n   * Called when a cache error occurs.\n   * @param cache - The type of cache that had an error.\n   * @param index - The index of the cache that had an error.\n   */\n  onCacheError(cache: ResourceResolverCacheType, index: number): void;\n\n  /**\n   * Called when a cache is cleared.\n   * @param cache - The type of cache that was cleared.\n   */\n  onCacheClear(cache: ResourceResolverCacheType): void;\n}\n\n/**\n * A no-op implementation of {@link Runtime.IResourceResolverCacheListener}.\n * @public\n */\nexport class NoOpResourceResolverCacheListener implements IResourceResolverCacheListener {\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}\n   */\n  public onCacheHit(cache: ResourceResolverCacheType, index: number): void {\n    // no-op\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}\n   */\n  public onCacheMiss(cache: ResourceResolverCacheType, index: number): void {\n    // no-op\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}\n   */\n  public onCacheError(cache: ResourceResolverCacheType, index: number): void {\n    // no-op\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}\n   */\n  public onCacheClear(cache: ResourceResolverCacheType): void {\n    // no-op\n  }\n}\n"]}

package/lib/packlets/runtime/cacheMetrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cacheMetrics.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheMetrics.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAa;;IASrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,IAAI,IAAI;IAOtB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAEM,KAAK,IAAI,IAAI;CAMrB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,EAAE,SAAS,aAAa,GAAG,aAAa,IAAI,MAAM,CAChF,yBAAyB,EACzB,EAAE,CACH,CAAC;AAEF;;;;GAIG;AACH,qBAAa,oCAAoC,CAAC,EAAE,SAAS,aAAa,CACxE,YAAW,8BAA8B;IAEzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAEhC,OAAO,EAAE,MAAM,EAAE;gBACjB,OAAO,EAAE,mBAAmB,CAAC,EAAE,CAAC;IAanD;;;OAGG;IACH,IAAW,OAAO,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAElD;IAED;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxE;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzE;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1E;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI;IAI3D;;OAEG;IACI,KAAK,IAAI,IAAI;CAKrB"}

package/lib/packlets/runtime/cacheMetrics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cacheMetrics.js","sourceRoot":"","sources":["../../../src/packlets/runtime/cacheMetrics.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 { IResourceResolverCacheListener, ResourceResolverCacheType } from './cacheListener';\n\n/**\n * Cache metrics interface for tracking cache performance.\n * @public\n */\nexport interface ICacheMetrics {\n  hits: number;\n  misses: number;\n  errors: number;\n  clears: number;\n  totalAccesses: number;\n  hitRate: number;\n  onHit(index: number): void;\n  onMiss(index: number): void;\n  onError(index: number): void;\n  onClear(): void;\n  reset(): void;\n}\n\n/**\n * Aggregate cache metrics for a specific cache type.\n * @public\n */\nexport class AggregateCacheMetrics implements ICacheMetrics {\n  private _hits: number = 0;\n  private _misses: number = 0;\n  private _errors: number = 0;\n  private _clears: number = 0;\n\n  public constructor() {\n    this._hits = 0;\n    this._misses = 0;\n    this._errors = 0;\n    this._clears = 0;\n  }\n\n  public onHit(__index: number): void {\n    this._hits++;\n  }\n\n  public onMiss(__index: number): void {\n    this._misses++;\n  }\n\n  public onError(__index: number): void {\n    this._errors++;\n  }\n\n  public onClear(): void {\n    this._hits = 0;\n    this._misses = 0;\n    this._errors = 0;\n    this._clears++;\n  }\n\n  public get hits(): number {\n    return this._hits;\n  }\n\n  public get misses(): number {\n    return this._misses;\n  }\n\n  public get errors(): number {\n    return this._errors;\n  }\n\n  public get clears(): number {\n    return this._clears;\n  }\n\n  public get totalAccesses(): number {\n    return this._hits + this._misses + this._errors;\n  }\n\n  public get hitRate(): number {\n    return this.totalAccesses > 0 ? (this._hits / this.totalAccesses) * 100 : 0;\n  }\n\n  public get errorRate(): number {\n    return this.totalAccesses > 0 ? (this._errors / this.totalAccesses) * 100 : 0;\n  }\n\n  public reset(): void {\n    this._hits = 0;\n    this._misses = 0;\n    this._errors = 0;\n    this._clears = 0;\n  }\n}\n\n/**\n * Overall cache metrics across all cache types.\n * @public\n */\nexport type OverallCacheMetrics<TM extends ICacheMetrics = ICacheMetrics> = Record<\n  ResourceResolverCacheType,\n  TM\n>;\n\n/**\n * A metrics implementation of {@link Runtime.IResourceResolverCacheListener} that tracks\n * hit counts and rates across all cache types.\n * @public\n */\nexport class ResourceResolverCacheMetricsListener<TM extends ICacheMetrics>\n  implements IResourceResolverCacheListener\n{\n  private readonly _metrics: OverallCacheMetrics<TM>;\n\n  public constructor(factory: () => TM);\n  public constructor(metrics: OverallCacheMetrics<TM>);\n  public constructor(factoryOrMetrics: OverallCacheMetrics<TM> | (() => TM)) {\n    if (typeof factoryOrMetrics === 'function') {\n      this._metrics = {\n        condition: factoryOrMetrics(),\n        conditionSet: factoryOrMetrics(),\n        decision: factoryOrMetrics()\n      };\n    } else {\n      this._metrics = factoryOrMetrics;\n    }\n  }\n\n  /**\n   * Get the metrics for all cache types.\n   * @returns The metrics for all cache types.\n   */\n  public get metrics(): Readonly<OverallCacheMetrics> {\n    return this._metrics;\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheHit}\n   */\n  public onCacheHit(cache: ResourceResolverCacheType, index: number): void {\n    this._metrics[cache].onHit(index);\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheMiss}\n   */\n  public onCacheMiss(cache: ResourceResolverCacheType, index: number): void {\n    this._metrics[cache].onMiss(index);\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheError}\n   */\n  public onCacheError(cache: ResourceResolverCacheType, index: number): void {\n    this._metrics[cache].onError(index);\n  }\n\n  /**\n   * {@inheritDoc Runtime.IResourceResolverCacheListener.onCacheClear}\n   */\n  public onCacheClear(cache: ResourceResolverCacheType): void {\n    this._metrics[cache].onClear();\n  }\n\n  /**\n   * Reset all metrics to zero.\n   */\n  public reset(): void {\n    this._metrics.condition.reset();\n    this._metrics.conditionSet.reset();\n    this._metrics.decision.reset();\n  }\n}\n"]}

package/lib/packlets/runtime/compiledResourceCollection.d.ts.map

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