@fgv/ts-res 5.1.0-3 → 5.1.0-30

package/lib/packlets/runtime/context/contextQualifierProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/contextQualifierProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA0GH;;;;GAIG;AACH,MAAsB,wBAAwB;CAwC7C;AAxCD,4DAwCC","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 { Result } from '@fgv/ts-utils';\nimport { QualifierName, QualifierContextValue, QualifierIndex } from '../../common';\nimport { IReadOnlyQualifierCollector, Qualifier } from '../../qualifiers';\n\n/**\n * Base interface for providing qualifier values in an optimized runtime context.\n * Contains common read-only operations shared by both mutable and immutable providers.\n * Acts as a property bag using the Result pattern for qualifier value lookups.\n * @public\n */\nexport interface IContextQualifierProviderBase {\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  get(nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier): Result<QualifierContextValue>;\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue>;\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  has(name: QualifierName): Result<boolean>;\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  getNames(): Result<ReadonlyArray<QualifierName>>;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  readonly qualifiers: IReadOnlyQualifierCollector;\n}\n\n/**\n * Read-only interface for providing qualifier values in an optimized runtime context.\n * Explicitly marked as immutable with compile-time type discrimination.\n * @public\n */\nexport interface IReadOnlyContextQualifierProvider extends IContextQualifierProviderBase {\n  /**\n   * Explicit mutability marker for compile-time type discrimination.\n   * Always `false` for read-only providers.\n   */\n  readonly mutable: false;\n}\n\n/**\n * Mutable interface for providing qualifier values in an optimized runtime context.\n * Extends the base interface with mutation operations and explicit mutability marker.\n * @public\n */\nexport interface IMutableContextQualifierProvider extends IContextQualifierProviderBase {\n  /**\n   * Explicit mutability marker for compile-time type discrimination.\n   * Always `true` for mutable providers.\n   */\n  readonly mutable: true;\n  /**\n   * Sets a qualifier value in this provider.\n   * @param name - The {@link QualifierName | qualifier name} to set.\n   * @param value - The {@link QualifierContextValue | qualifier context value} to set.\n   * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not.\n   */\n  set(name: QualifierName, value: QualifierContextValue): Result<QualifierContextValue>;\n\n  /**\n   * Removes a qualifier value from this provider.\n   * @param name - The {@link QualifierName | qualifier name} to remove.\n   * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  remove(name: QualifierName): Result<QualifierContextValue>;\n\n  /**\n   * Clears all qualifier values from this provider.\n   */\n  clear(): void;\n}\n\n/**\n * Union type for context qualifier providers that can be either read-only or mutable.\n * Provides compile-time type discrimination via the `mutable` property.\n * @public\n */\nexport type IContextQualifierProvider = IReadOnlyContextQualifierProvider | IMutableContextQualifierProvider;\n\n/**\n * Abstract base class for implementing context qualifier providers.\n * Provides common functionality and enforces the contract for derived classes.\n * @public\n */\nexport abstract class ContextQualifierProvider implements IContextQualifierProviderBase {\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  public abstract readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public abstract get(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue>;\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public abstract getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue>;\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  public abstract has(name: QualifierName): Result<boolean>;\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  public abstract getNames(): Result<ReadonlyArray<QualifierName>>;\n}\n"]}

package/lib/packlets/runtime/context/contextQualifierProviderValidator.d.ts.map

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

package/lib/packlets/runtime/context/contextQualifierProviderValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextQualifierProviderValidator.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/contextQualifierProviderValidator.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 { Result, captureResult, Converters } from '@fgv/ts-utils';\nimport { QualifierContextValue, Convert as CommonConverters } from '../../common';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport {\n  IContextQualifierProvider,\n  IReadOnlyContextQualifierProvider,\n  IMutableContextQualifierProvider\n} from './contextQualifierProvider';\n\n/**\n * Base interface for shared operations between read-only and mutable context qualifier provider validators.\n * Contains common methods that don't depend on provider mutability.\n * @public\n */\nexport interface IContextQualifierProviderValidatorBase<\n  T extends IContextQualifierProvider = IContextQualifierProvider\n> {\n  /**\n   * The wrapped context qualifier provider.\n   */\n  readonly provider: T;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Gets a qualifier value by its string name, converting to strongly-typed QualifierName.\n   * @param name - The string name to convert and look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  get(name: string): Result<QualifierContextValue>;\n\n  /**\n   * Gets a qualifier value by its number index, converting to strongly-typed QualifierIndex.\n   * @param index - The number index to convert and look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  getByIndex(index: number): Result<QualifierContextValue>;\n\n  /**\n   * Gets a validated qualifier context value by its string name.\n   * @param name - The string name to convert and look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  getValidated(name: string): Result<QualifierContextValue>;\n\n  /**\n   * Gets a validated qualifier context value by its number index.\n   * @param index - The number index to convert and look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  getValidatedByIndex(index: number): Result<QualifierContextValue>;\n\n  /**\n   * Checks if a qualifier value exists with the given string name.\n   * @param name - The string name to convert and check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  has(name: string): Result<boolean>;\n}\n\n/**\n * A read-only interface for validators wrapping read-only context qualifier providers.\n * Only exposes read operations, providing compile-time type safety by excluding mutation methods.\n * @public\n */\nexport interface IReadOnlyContextQualifierProviderValidator<\n  T extends IReadOnlyContextQualifierProvider = IReadOnlyContextQualifierProvider\n> {\n  /**\n   * The wrapped read-only context qualifier provider.\n   */\n  readonly provider: T;\n}\n\n/**\n * A mutable interface for validators wrapping mutable context qualifier providers.\n * Extends the base interface with mutation operations and provides compile-time type safety.\n * @public\n */\nexport interface IMutableContextQualifierProviderValidator<\n  T extends IMutableContextQualifierProvider = IMutableContextQualifierProvider\n> extends IContextQualifierProviderValidatorBase<T> {\n  /**\n   * The wrapped mutable context qualifier provider.\n   */\n  readonly provider: T;\n\n  /**\n   * Sets a qualifier value using string inputs, converting to strongly-typed values.\n   * @param name - The string name to convert.\n   * @param value - The string value to convert.\n   * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if an error occurs.\n   */\n  set(name: string, value: string): Result<QualifierContextValue>;\n\n  /**\n   * Removes a qualifier value using string input, converting to strongly-typed QualifierName.\n   * @param name - The string name to convert.\n   * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if an error occurs.\n   */\n  remove(name: string): Result<QualifierContextValue>;\n}\n\n/**\n * Parameters for constructing a read-only context qualifier provider validator.\n * @public\n */\nexport interface IReadOnlyContextQualifierProviderValidatorCreateParams<\n  T extends IReadOnlyContextQualifierProvider = IReadOnlyContextQualifierProvider\n> {\n  provider: T;\n}\n\n/**\n * Parameters for constructing a mutable context qualifier provider validator.\n * @public\n */\nexport interface IMutableContextQualifierProviderValidatorCreateParams<\n  T extends IMutableContextQualifierProvider = IMutableContextQualifierProvider\n> {\n  provider: T;\n}\n\n/**\n * Union type for validator constructor parameters.\n * @public\n */\nexport type IContextQualifierProviderValidatorCreateParams =\n  | IReadOnlyContextQualifierProviderValidatorCreateParams\n  | IMutableContextQualifierProviderValidatorCreateParams;\n\n/**\n * Base implementation class containing shared validation logic for both read-only and mutable validators.\n * @internal\n */\nabstract class BaseContextQualifierProviderValidator<\n  T extends IContextQualifierProvider = IContextQualifierProvider\n> implements IContextQualifierProviderValidatorBase<T>\n{\n  /**\n   * The wrapped context qualifier provider.\n   */\n  public abstract readonly provider: T;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  public get qualifiers(): IReadOnlyQualifierCollector {\n    return this.provider.qualifiers;\n  }\n\n  /**\n   * Gets a qualifier value by its string name, converting to strongly-typed QualifierName.\n   * @param name - The string name to convert and look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public get(name: string): Result<QualifierContextValue> {\n    return CommonConverters.qualifierName.convert(name).onSuccess((qualifierName) => {\n      return this.provider.get(qualifierName);\n    });\n  }\n\n  /**\n   * Gets a qualifier value by its number index, converting to strongly-typed QualifierIndex.\n   * @param index - The number index to convert and look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public getByIndex(index: number): Result<QualifierContextValue> {\n    return CommonConverters.qualifierIndex.convert(index).onSuccess((qualifierIndex) => {\n      return this.provider.get(qualifierIndex);\n    });\n  }\n\n  /**\n   * Gets a validated qualifier context value by its string name.\n   * @param name - The string name to convert and look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public getValidated(name: string): Result<QualifierContextValue> {\n    return CommonConverters.qualifierName.convert(name).onSuccess((qualifierName) => {\n      return this.provider.getValidated(qualifierName);\n    });\n  }\n\n  /**\n   * Gets a validated qualifier context value by its number index.\n   * @param index - The number index to convert and look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public getValidatedByIndex(index: number): Result<QualifierContextValue> {\n    return CommonConverters.qualifierIndex.convert(index).onSuccess((qualifierIndex) => {\n      return this.provider.getValidated(qualifierIndex);\n    });\n  }\n\n  /**\n   * Checks if a qualifier value exists with the given string name.\n   * @param name - The string name to convert and check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  public has(name: string): Result<boolean> {\n    return CommonConverters.qualifierName.convert(name).onSuccess((qualifierName) => {\n      return this.provider.has(qualifierName);\n    });\n  }\n}\n\n/**\n * A validator for read-only context qualifier providers that accepts string inputs\n * and converts them to strongly-typed values before calling the wrapped provider.\n * Only provides read operations for compile-time type safety.\n * @public\n */\nexport class ReadOnlyContextQualifierProviderValidator<\n    T extends IReadOnlyContextQualifierProvider = IReadOnlyContextQualifierProvider\n  >\n  extends BaseContextQualifierProviderValidator<T>\n  implements IReadOnlyContextQualifierProviderValidator<T>\n{\n  /**\n   * The wrapped read-only context qualifier provider.\n   */\n  public readonly provider: T;\n\n  /**\n   * Constructs a new {@link Runtime.Context.ReadOnlyContextQualifierProviderValidator | ReadOnlyContextQualifierProviderValidator}.\n   * @param params - Required parameters for constructing the validator.\n   */\n  public constructor(params: IReadOnlyContextQualifierProviderValidatorCreateParams<T>) {\n    super();\n    this.provider = params.provider;\n  }\n}\n\n/**\n * A validator for mutable context qualifier providers that accepts string inputs\n * and converts them to strongly-typed values before calling the wrapped provider.\n * Provides both read and mutation operations.\n * @public\n */\nexport class MutableContextQualifierProviderValidator<\n    T extends IMutableContextQualifierProvider = IMutableContextQualifierProvider\n  >\n  extends BaseContextQualifierProviderValidator<T>\n  implements IMutableContextQualifierProviderValidator<T>\n{\n  /**\n   * The wrapped mutable context qualifier provider.\n   */\n  public readonly provider: T;\n\n  /**\n   * Constructs a new {@link Runtime.Context.MutableContextQualifierProviderValidator | MutableContextQualifierProviderValidator}.\n   * @param params - Required parameters for constructing the validator.\n   */\n  public constructor(params: IMutableContextQualifierProviderValidatorCreateParams<T>) {\n    super();\n    this.provider = params.provider;\n  }\n\n  /**\n   * Sets a qualifier value using string inputs, converting to strongly-typed values.\n   * @param name - The string name to convert.\n   * @param value - The string value to convert.\n   * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if an error occurs.\n   */\n  public set(name: string, value: string): Result<QualifierContextValue> {\n    return CommonConverters.qualifierName.convert(name).onSuccess((qualifierName) =>\n      this.provider.qualifiers.validating.get(name).asResult.onSuccess((qualifier) =>\n        Converters.string.convert(value).onSuccess((stringValue) =>\n          qualifier.validateContextValue(stringValue).onSuccess((qualifierValue) => {\n            return captureResult(() => this.provider.set(qualifierName, qualifierValue)).onSuccess(\n              (result) => result\n            );\n          })\n        )\n      )\n    );\n  }\n\n  /**\n   * Removes a qualifier value using string input, converting to strongly-typed QualifierName.\n   * @param name - The string name to convert.\n   * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if an error occurs.\n   */\n  public remove(name: string): Result<QualifierContextValue> {\n    return CommonConverters.qualifierName.convert(name).onSuccess((qualifierName) => {\n      return captureResult(() => this.provider.remove(qualifierName)).onSuccess((result) => result);\n    });\n  }\n}\n"]}

package/lib/packlets/runtime/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/index.ts"],"names":[],"mappings":"AAsBA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,kCAAkC,CAAC;AACjD,cAAc,4CAA4C,CAAC"}

package/lib/packlets/runtime/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,6DAA2C;AAC3C,sEAAoD;AACpD,mEAAiD;AACjD,6EAA2D","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 './contextQualifierProvider';\nexport * from './contextQualifierProviderValidator';\nexport * from './simpleContextQualifierProvider';\nexport * from './validatingSimpleContextQualifierProvider';\n"]}

package/lib/packlets/runtime/context/simpleContextQualifierProvider.d.ts

@@ -13,8 +13,15 @@ export interface ISimpleContextQualifierProviderCreateParams {
     qualifiers: IReadOnlyQualifierCollector;
     /**
      * Optional record of initial qualifier name-value pairs to populate the provider.
-     */
-    qualifierValues?: Record<string, QualifierContextValue>;
+     *
+     * @remarks
+     * Typed as `Readonly<Partial<Record<string, QualifierContextValue>>>` so a
+     * caller can naturally express conditional context construction, e.g.
+     * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is
+     * `undefined` are skipped on load - semantically equivalent to omitting
+     * the key, which is how the candidate selector treats a missing key.
+     */
+    qualifierValues?: Readonly<Partial<Record<string, QualifierContextValue>>>;
 }
 /**
  * Simple concrete implementation of {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider}

package/lib/packlets/runtime/context/simpleContextQualifierProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/simpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAoE,MAAM,eAAe,CAAC;AACzG,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EAGf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAExG;;;GAGG;AACH,MAAM,WAAW,2CAA2C;IAC1D;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED;;;;GAIG;AACH,qBAAa,8BACX,SAAQ,wBACR,YAAW,gCAAgC;IAE3C;;;OAGG;IACH,SAAgB,OAAO,EAAE,IAAI,CAAiB;IAE9C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkD;IAEnF;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,2CAA2C;IAgBzE;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,2CAA2C,GAClD,MAAM,CAAC,8BAA8B,CAAC;IAIzC;;;;;OAKG;IACI,GAAG,CACR,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAMhC;;;;;;OAMG;IACI,YAAY,CACjB,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAQhC;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAIhD;;;;OAIG;IACI,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAIvD;;;;;;;OAOG;IACI,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAK5F;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAOjE;;;;OAIG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;CAc/C"}

package/lib/packlets/runtime/context/simpleContextQualifierProvider.js

@@ -47,6 +47,9 @@ class SimpleContextQualifierProvider extends contextQualifierProvider_1.ContextQ
         this._qualifierValues = new ts_utils_1.ResultMap();
         if (params.qualifierValues) {
             for (const [name, value] of Object.entries(params.qualifierValues)) {
+                if (value === undefined) {
+                    continue;
+                }
                 const qualifierName = common_1.Validate.toQualifierName(name).orThrow();
                 this._qualifierValues.set(qualifierName, value);
             }

package/lib/packlets/runtime/context/simpleContextQualifierProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/simpleContextQualifierProvider.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 { Result, ResultMap, captureResult, succeed, succeedWithDetail, Converters } from '@fgv/ts-utils';\nimport {\n  QualifierName,\n  QualifierContextValue,\n  QualifierIndex,\n  Validate,\n  Convert as CommonConverters\n} from '../../common';\nimport { IReadOnlyQualifierCollector, Qualifier } from '../../qualifiers';\nimport { ContextQualifierProvider, IMutableContextQualifierProvider } from './contextQualifierProvider';\n\n/**\n * Parameters for creating a {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider}.\n * @public\n */\nexport interface ISimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   *\n   * @remarks\n   * Typed as `Readonly<Partial<Record<string, QualifierContextValue>>>` so a\n   * caller can naturally express conditional context construction, e.g.\n   * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is\n   * `undefined` are skipped on load - semantically equivalent to omitting\n   * the key, which is how the candidate selector treats a missing key.\n   */\n  qualifierValues?: Readonly<Partial<Record<string, QualifierContextValue>>>;\n}\n\n/**\n * Simple concrete implementation of {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider}\n * using a `ResultMap` for qualifier value storage.\n * @public\n */\nexport class SimpleContextQualifierProvider\n  extends ContextQualifierProvider\n  implements IMutableContextQualifierProvider\n{\n  /**\n   * Explicit mutability marker for compile-time type discrimination.\n   * Always `true` for mutable providers.\n   */\n  public readonly mutable: true = true as const;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Internal storage for qualifier values using a ResultMap.\n   */\n  private readonly _qualifierValues: ResultMap<QualifierName, QualifierContextValue>;\n\n  /**\n   * Constructor for a {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.ISimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: ISimpleContextQualifierProviderCreateParams) {\n    super();\n    this.qualifiers = params.qualifiers;\n    this._qualifierValues = new ResultMap<QualifierName, QualifierContextValue>();\n\n    if (params.qualifierValues) {\n      for (const [name, value] of Object.entries(params.qualifierValues)) {\n        if (value === undefined) {\n          continue;\n        }\n        const qualifierName = Validate.toQualifierName(name).orThrow();\n        this._qualifierValues.set(qualifierName, value);\n      }\n    }\n  }\n\n  /**\n   * Creates a new {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.ISimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: ISimpleContextQualifierProviderCreateParams\n  ): Result<SimpleContextQualifierProvider> {\n    return captureResult(() => new SimpleContextQualifierProvider(params));\n  }\n\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public get(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue> {\n    return this._resolveQualifierName(nameOrIndexOrQualifier).onSuccess((qualifierName) => {\n      return this._qualifierValues.get(qualifierName);\n    });\n  }\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * TODO: Implement validation logic using qualifier collectors.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue> {\n    return this._resolveQualifier(nameOrIndexOrQualifier).onSuccess((qualifier) => {\n      return this._qualifierValues.get(qualifier.name).asResult.onSuccess((value) => {\n        return qualifier.validateContextValue(value);\n      });\n    });\n  }\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  public has(name: QualifierName): Result<boolean> {\n    return succeed(this._qualifierValues.has(name));\n  }\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  public getNames(): Result<ReadonlyArray<QualifierName>> {\n    return succeed(Array.from(this._qualifierValues.keys()));\n  }\n\n  /**\n   * Sets a qualifier value in this provider.\n   * @param name - The {@link QualifierName | qualifier name} to set.\n   * @param value - The {@link QualifierContextValue | qualifier context value} to set.\n   * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public set(name: QualifierName, value: QualifierContextValue): Result<QualifierContextValue> {\n    this._qualifierValues.set(name, value);\n    return succeed(value);\n  }\n\n  /**\n   * Removes a qualifier value from this provider.\n   * @param name - The {@link QualifierName | qualifier name} to remove.\n   * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not found or an error occurs.\n   * @public\n   */\n  public remove(name: QualifierName): Result<QualifierContextValue> {\n    return this._qualifierValues.get(name).onSuccess((value) => {\n      this._qualifierValues.delete(name);\n      return succeedWithDetail(value, 'success');\n    });\n  }\n\n  /**\n   * Gets the number of qualifier values in this provider.\n   * @returns The count of qualifier values.\n   * @public\n   */\n  public get size(): number {\n    return this._qualifierValues.size;\n  }\n\n  /**\n   * Clears all qualifier values from this provider.\n   * @public\n   */\n  public clear(): void {\n    this._qualifierValues.clear();\n  }\n\n  /**\n   * Resolves a qualifier from a name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link Qualifier | qualifier} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private _resolveQualifier(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<Qualifier> {\n    if (nameOrIndexOrQualifier instanceof Qualifier) {\n      return succeed(nameOrIndexOrQualifier);\n    }\n    /* c8 ignore next 16 - functional code tested but coverage intermittently missed */\n    if (typeof nameOrIndexOrQualifier === 'string') {\n      return this.qualifiers.validating\n        .get(nameOrIndexOrQualifier)\n        .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid qualifier name.`);\n    }\n\n    if (typeof nameOrIndexOrQualifier === 'number') {\n      return this.qualifiers\n        .getAt(nameOrIndexOrQualifier)\n        .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid qualifier index.`);\n    }\n\n    return SimpleContextQualifierProvider._qualifierNameFromQualifierLike(nameOrIndexOrQualifier)\n      .onSuccess((qualifierName) => this.qualifiers.validating.get(qualifierName))\n      .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid Qualifier, name or index.`);\n  }\n\n  /**\n   * Resolves a qualifier name from a name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link QualifierName | qualifier name} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private _resolveQualifierName(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierName> {\n    return this._resolveQualifier(nameOrIndexOrQualifier).onSuccess((qualifier) => succeed(qualifier.name));\n  }\n\n  /**\n   * Resolves a qualifier name from a qualifier-like object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link QualifierName | qualifier name} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private static _qualifierNameFromQualifierLike(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierName> {\n    return Converters.isA(\n      'Qualifier-like object',\n      (v): v is { name: QualifierName } =>\n        typeof v === 'object' &&\n        v !== null &&\n        'name' in v &&\n        typeof (v as Record<string, unknown>).name === 'string'\n    )\n      .map((v) => CommonConverters.qualifierName.convert(v.name))\n      .convert(nameOrIndexOrQualifier);\n  }\n}\n"]}

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.d.ts

@@ -14,8 +14,15 @@ export interface IValidatingSimpleContextQualifierProviderCreateParams {
     /**
      * Optional record of initial qualifier name-value pairs to populate the provider.
      * Accepts string keys and values which will be converted to strongly-typed values.
+     *
+     * @remarks
+     * Typed as `Readonly<Partial<Record<string, string>>>` so callers can
+     * naturally express conditional context construction, e.g.
+     * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is
+     * `undefined` are skipped on load - semantically equivalent to omitting
+     * the key.
      */
-    qualifierValues?: Record<string, string>;
+    qualifierValues?: Readonly<Partial<Record<string, string>>>;
 }
 /**
  * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatingSimpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EACL,yCAAyC,EAE1C,MAAM,qCAAqC,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,qDAAqD;IACpE;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,qBAAa,wCAAyC,SAAQ,8BAA8B;IAC1F;;;OAGG;IACH,SAAgB,UAAU,EAAE,yCAAyC,CAAC;IAEtE;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,qDAAqD;IAenF;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,qDAAqD,GAC5D,MAAM,CAAC,wCAAwC,CAAC;CAGpD"}

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.js

@@ -38,11 +38,9 @@ class ValidatingSimpleContextQualifierProvider extends simpleContextQualifierPro
      * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.
      */
     constructor(params) {
-        // Convert string values to QualifierContextValue for the base class
-        /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */
-        const convertedValues = params.qualifierValues
-            ? Object.fromEntries(Object.entries(params.qualifierValues).map(([key, value]) => [key, value]))
-            : undefined;
+        // The branded QualifierContextValue is structurally a string; widen via cast
+        // and let the base class skip undefined entries on load.
+        const convertedValues = params.qualifierValues;
         super({
             qualifiers: params.qualifiers,
             qualifierValues: convertedValues

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatingSimpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AAGtD,qFAAkF;AAClF,2FAG6C;AA0B7C;;;;;;GAMG;AACH,MAAa,wCAAyC,SAAQ,+DAA8B;IAO1F;;;OAGG;IACH,YAAsB,MAA6D;QACjF,6EAA6E;QAC7E,yDAAyD;QACzD,MAAM,eAAe,GAAG,MAAM,CAAC,eAElB,CAAC;QAEd,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,eAAe;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,4EAAwC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,MAA6D;QAE7D,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,wCAAwC,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC;CACF;AAtCD,4FAsCC","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 { Result, captureResult } from '@fgv/ts-utils';\nimport { QualifierContextValue } from '../../common';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { SimpleContextQualifierProvider } from './simpleContextQualifierProvider';\nimport {\n  IMutableContextQualifierProviderValidator,\n  MutableContextQualifierProviderValidator\n} from './contextQualifierProviderValidator';\n\n/**\n * Parameters for creating a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider}.\n * @public\n */\nexport interface IValidatingSimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   * Accepts string keys and values which will be converted to strongly-typed values.\n   *\n   * @remarks\n   * Typed as `Readonly<Partial<Record<string, string>>>` so callers can\n   * naturally express conditional context construction, e.g.\n   * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is\n   * `undefined` are skipped on load - semantically equivalent to omitting\n   * the key.\n   */\n  qualifierValues?: Readonly<Partial<Record<string, string>>>;\n}\n\n/**\n * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a\n * {@link Runtime.Context.MutableContextQualifierProviderValidator | validator} property that enables\n * validated use of the underlying provider with string keys and values.\n * This eliminates the need for type casting in consumer code.\n * @public\n */\nexport class ValidatingSimpleContextQualifierProvider extends SimpleContextQualifierProvider {\n  /**\n   * A {@link Runtime.Context.MutableContextQualifierProviderValidator | MutableContextQualifierProviderValidator} which validates\n   * string inputs before passing them to this provider.\n   */\n  public readonly validating: IMutableContextQualifierProviderValidator;\n\n  /**\n   * Constructor for a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: IValidatingSimpleContextQualifierProviderCreateParams) {\n    // The branded QualifierContextValue is structurally a string; widen via cast\n    // and let the base class skip undefined entries on load.\n    const convertedValues = params.qualifierValues as\n      | Readonly<Partial<Record<string, QualifierContextValue>>>\n      | undefined;\n\n    super({\n      qualifiers: params.qualifiers,\n      qualifierValues: convertedValues\n    });\n\n    this.validating = new MutableContextQualifierProviderValidator({ provider: this });\n  }\n\n  /**\n   * Creates a new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: IValidatingSimpleContextQualifierProviderCreateParams\n  ): Result<ValidatingSimpleContextQualifierProvider> {\n    return captureResult(() => new ValidatingSimpleContextQualifierProvider(params));\n  }\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"iResourceManager.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/iResourceManager.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,iCAAiC,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,EAAE,SAAS,SAAS,GAAG,SAAS;IAChE;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,iCAAiC,CAAC;IAEtD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAEzC;;;OAGG;IACH,oBAAoB,IAAI,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,4BAA4B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElF;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;CACvE"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"iResourceManager.js","sourceRoot":"","sources":["../../../src/packlets/runtime/iResourceManager.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 { Result, Collections } from '@fgv/ts-utils';\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { ReadOnlyConditionCollector, ReadOnlyConditionSetCollector } from '../conditions';\nimport { ReadOnlyAbstractDecisionCollector, ConcreteDecision } from '../decisions';\nimport { ResourceId, ResourceValueMergeMethod } from '../common';\nimport { IResourceType } from '../resource-types';\nimport { IContextDecl, IValidatedContextDecl } from '../context';\nimport { IReadOnlyResourceTreeRoot } from './resource-tree';\n\n/**\n * Runtime representation of a resource candidate with the minimal data needed for resolution.\n * @public\n */\nexport interface IResourceCandidate {\n  /** The JSON value for this candidate */\n  readonly json: JsonObject;\n\n  /**\n   * Indicates if this candidate is a partial resource.\n   */\n  readonly isPartial: boolean;\n\n  /**\n   * Specifies the resource type of this candidate.\n   */\n  readonly mergeMethod: ResourceValueMergeMethod;\n}\n\n/**\n * Interface for a resource that can be used in the runtime layer.\n * This provides the minimal properties needed from a resource without requiring\n * the full Resources layer dependencies.\n * @public\n */\nexport interface IResource {\n  /** The resource identifier */\n  readonly id: string;\n  /** The resource name */\n  readonly name: string;\n  /** The resource type */\n  readonly resourceType: IResourceType;\n  /** The decision used to select candidates */\n  readonly decision: ConcreteDecision;\n  /** The available candidates for this resource */\n  readonly candidates: ReadonlyArray<IResourceCandidate>;\n}\n\n/**\n * Interface defining the read-only properties that the runtime resource resolver needs\n * from a resource manager. This abstraction allows the runtime to work with different\n * implementations without requiring the full ResourceManagerBuilder build mechanics.\n * @public\n */\nexport interface IResourceManager<TR extends IResource = IResource> {\n  /**\n   * A {@link Conditions.ReadOnlyConditionCollector | ReadOnlyConditionCollector} which\n   * contains the {@link Conditions.Condition | conditions} used by resource candidates.\n   */\n  readonly conditions: ReadOnlyConditionCollector;\n\n  /**\n   * A {@link Conditions.ReadOnlyConditionSetCollector | ReadOnlyConditionSetCollector} which\n   * contains the {@link Conditions.ConditionSet | condition sets} used by resource candidates.\n   */\n  readonly conditionSets: ReadOnlyConditionSetCollector;\n\n  /**\n   * A {@link Decisions.ReadOnlyAbstractDecisionCollector | ReadOnlyAbstractDecisionCollector} which\n   * contains the {@link Decisions.Decision | abstract decisions} used by resource candidates.\n   */\n  readonly decisions: ReadOnlyAbstractDecisionCollector;\n\n  /**\n   * Gets a built resource by ID for runtime resolution.\n   * @param id - The resource identifier\n   * @returns Success with the runtime resource if found, Failure otherwise\n   */\n  getBuiltResource(id: string): Result<TR>;\n\n  /**\n   * Gets a resource tree built from the resources in this resource manager.\n   * @returns Result containing the resource tree root, or failure if tree construction fails\n   */\n  getBuiltResourceTree(): Result<IReadOnlyResourceTreeRoot<TR>>;\n\n  /**\n   * A read-only result map of all built resources, keyed by resource ID.\n   * Resources are built on-demand when accessed and returns Results for error handling.\n   */\n  readonly builtResources: Collections.IReadOnlyValidatingResultMap<ResourceId, TR>;\n\n  /**\n   * The number of resources in this resource manager.\n   */\n  readonly numResources: number;\n\n  /**\n   * The resource IDs that this resource manager can resolve.\n   */\n  readonly resourceIds: ReadonlyArray<ResourceId>;\n\n  /**\n   * The number of candidates in this resource manager.\n   */\n  readonly numCandidates: number;\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   */\n  validateContext(context: IContextDecl): Result<IValidatedContextDecl>;\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/index.ts"],"names":[],"mappings":"AAsBA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,0CAA0C,CAAC;AACzD,cAAc,oDAAoD,CAAC;AACnE,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/runtime/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,+DAA6C;AAC7C,qDAAmC;AACnC,2EAAyD;AACzD,qFAAmE;AACnE,qDAAmC;AACnC,yDAAuC;AACvC,iEAA+C;AAC/C,kDAAgC;AAChC,iDAA+B;AAE/B,mDAAqC;AAG5B,0BAAO;AAFhB,8DAAgD;AAE9B,oCAAY","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 './compiledResourceCollection';\nexport * from './iResourceManager';\nexport * from './context/simpleContextQualifierProvider';\nexport * from './context/validatingSimpleContextQualifierProvider';\nexport * from './resourceResolver';\nexport * from './resourceTreeResolver';\nexport * from './conditionSetResolutionResult';\nexport * from './cacheListener';\nexport * from './cacheMetrics';\n\nimport * as Context from './context';\nimport * as ResourceTree from './resource-tree';\n\nexport { Context, ResourceTree };\n"]}

package/lib/packlets/runtime/resource-tree/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/common.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,yBAAyB,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAAC;AAEzG;;;GAGG;AACH,MAAM,WAAW,6BAA6B,CAC5C,CAAC,EACD,GAAG,SAAS,MAAM,GAAG,UAAU,EAC/B,KAAK,SAAS,MAAM,GAAG,YAAY,CACnC,SAAQ,kBAAkB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAC/D;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,uCAAuC,CAAC,CAAC,CAAE,SAAQ,6BAA6B,CAAC,CAAC,CAAC;IAClG,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvE"}

package/lib/packlets/runtime/resource-tree/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/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 { IReadOnlyResultMap, Result } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName } from '../../common';\n\n/**\n * Interface for leaf nodes in a resource tree.\n * Leaf nodes contain resource values and cannot have child nodes.\n * In a valid resource tree, if a path has child resources (e.g., 'app.messages.welcome'),\n * then that path cannot itself be a resource (i.e., 'app' cannot be both a resource and have children).\n * @public\n */\nexport interface IReadOnlyResourceTreeLeaf<T> {\n  readonly id: ResourceId;\n  readonly name: ResourceName;\n  readonly resource: T;\n  readonly isLeaf: true;\n  readonly isBranch: false;\n  readonly isRoot: false;\n}\n\n/**\n * Interface for branch nodes in a resource tree that contain child nodes.\n * Branch nodes organize the tree structure and cannot have resource values.\n * If a path has child resources, it must be a branch and cannot itself be a resource.\n * @public\n */\nexport interface IReadOnlyResourceTreeBranch<T> {\n  readonly id: ResourceId;\n  readonly name: ResourceName;\n  readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n  readonly isLeaf: false;\n  readonly isBranch: true;\n  readonly isRoot: false;\n}\n\n/**\n * Interface for the root node of a resource tree.\n * @public\n */\nexport interface IReadOnlyResourceTreeRoot<T> {\n  readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n  readonly isRoot: true;\n  readonly isLeaf: false;\n  readonly isBranch: false;\n}\n\n/**\n * Union type representing any node in the resource tree, which can be a leaf or a branch.\n * This allows for flexible handling of different node types in the tree structure.\n * @public\n */\nexport type IReadOnlyResourceTreeNode<T> = IReadOnlyResourceTreeLeaf<T> | IReadOnlyResourceTreeBranch<T>;\n\n/**\n * Interface for a read-only result-based resource tree with navigation methods.\n * @public\n */\nexport interface IReadOnlyResourceTreeChildren<\n  T,\n  TID extends string = ResourceId,\n  TNAME extends string = ResourceName\n> extends IReadOnlyResultMap<TNAME, IReadOnlyResourceTreeNode<T>> {\n  /**\n   * Gets a tree node by its full ResourceId path.\n   * @param id - The ResourceId path to look up\n   * @returns Result containing the node if found, or failure if not found\n   */\n  getById(id: TID): Result<IReadOnlyResourceTreeNode<T>>;\n\n  /**\n   * Gets a resource node by its direct name (single component).\n   * @param name - The ResourceName to look up\n   * @returns Result containing the node if it's a resource, or failure if not found or not a resource\n   */\n  getResource(name: TNAME): Result<IReadOnlyResourceTreeNode<T>>;\n\n  /**\n   * Gets a branch node by its direct name (single component).\n   * @param name - The ResourceName to look up\n   * @returns Result containing the node if it's a branch, or failure if not found or not a branch\n   */\n  getBranch(name: TNAME): Result<IReadOnlyResourceTreeNode<T>>;\n\n  /**\n   * Gets a resource leaf node by its full ResourceId path.\n   * @param id - The ResourceId path to look up\n   * @returns Result containing the leaf if found and is a resource, or failure otherwise\n   */\n  getResourceById(id: TID): Result<IReadOnlyResourceTreeLeaf<T>>;\n\n  /**\n   * Gets a branch node by its full ResourceId path.\n   * @param id - The ResourceId path to look up\n   * @returns Result containing the branch if found and has children, or failure otherwise\n   */\n  getBranchById(id: TID): Result<IReadOnlyResourceTreeBranch<T>>;\n}\n\n/**\n * A read-only interface for accessing resource tree children using weakly-typed string keys.\n * @public\n */\nexport interface IReadOnlyValidatingResourceTreeChildren<T> extends IReadOnlyResourceTreeChildren<T> {\n  readonly validating: IReadOnlyResourceTreeChildren<T, string, string>;\n}\n"]}

package/lib/packlets/runtime/resource-tree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/index.ts"],"names":[],"mappings":"AAsBA,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/lib/packlets/runtime/resource-tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,yDAAuC;AACvC,kEAAgD;AAChD,yDAAuC","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 './common';\nexport * from './resourceTreeChildren';\nexport * from './resourceTreeChildrenValidator';\nexport * from './readOnlyResourceTree';\n"]}

package/lib/packlets/runtime/resource-tree/readOnlyResourceTree.d.ts.map

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

package/lib/packlets/runtime/resource-tree/readOnlyResourceTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnlyResourceTree.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/readOnlyResourceTree.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, mapResults, succeed } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName, Helpers } from '../../common';\nimport {\n  IReadOnlyResourceTreeNode,\n  IReadOnlyResourceTreeLeaf,\n  IReadOnlyResourceTreeBranch,\n  IReadOnlyResourceTreeRoot,\n  IReadOnlyValidatingResourceTreeChildren\n} from './common';\nimport { ReadOnlyResourceTreeChildren } from './resourceTreeChildren';\n\n/**\n * Interface for initializing a resource tree root with child nodes.\n * @public\n */\nexport interface IResourceTreeRootInit<T> {\n  readonly children: Record<ResourceName, ResourceTreeNodeInit<T>>;\n}\n\n/**\n * Interface for initializing a leaf node with a resource value.\n * @public\n */\nexport interface IResourceTreeLeafInit<T> {\n  readonly resource: T;\n}\n\n/**\n * Interface for initializing a branch node with child nodes.\n * @public\n */\nexport interface IResourceTreeBranchInit<T> {\n  readonly children: Record<ResourceName, ResourceTreeNodeInit<T>>;\n}\n\n/**\n * Union type for tree node initialization data.\n * @public\n */\nexport type ResourceTreeNodeInit<T> = IResourceTreeLeafInit<T> | IResourceTreeBranchInit<T>;\n\n// Type guards\n/**\n * Type guard to determine if an init object represents a branch or root with children.\n * @param init - The initialization object to test\n * @returns True if the init object has children property\n * @public\n */\nexport function isResourceTreeRootOrNodeInit<T>(\n  init: ResourceTreeNodeInit<T> | IResourceTreeRootInit<T>\n): init is IResourceTreeBranchInit<T> {\n  return 'children' in init;\n}\n\n/**\n * Type guard to determine if an init object represents a leaf node with a resource.\n * @param init - The initialization object to test\n * @returns True if the init object has a resource but no children\n * @public\n */\nexport function isResourceTreeLeafInit<T>(init: ResourceTreeNodeInit<T>): init is IResourceTreeLeafInit<T> {\n  return 'resource' in init && !('children' in init);\n}\n\n/**\n * Implementation of a read-only resource tree leaf node that contains a resource value.\n * Leaf nodes represent the actual resources in the tree and cannot have children.\n * @public\n */\nexport class ReadOnlyResourceTreeLeaf<T> implements IReadOnlyResourceTreeLeaf<T> {\n  public readonly name: ResourceName;\n  public readonly id: ResourceId;\n  public readonly resource: T;\n\n  public get isRoot(): false {\n    return false;\n  }\n\n  public get isBranch(): false {\n    return false;\n  }\n\n  public get isLeaf(): true {\n    return true;\n  }\n\n  /**\n   * Creates a new leaf node. Use the static create method instead.\n   * @param name - The name of this node (last segment of the path)\n   * @param parentPath - The path to the parent node (undefined for root-level nodes)\n   * @param resource - The resource value stored in this leaf\n   */\n  protected constructor(name: ResourceName, parentPath: ResourceId | undefined, resource: T) {\n    this.name = name;\n    this.id = Helpers.joinResourceIds(parentPath, name).orThrow();\n    this.resource = resource;\n  }\n\n  /**\n   * Creates a new ReadOnlyResourceTreeLeaf instance.\n   * @param name - The name of this node (last segment of the path)\n   * @param parentPath - The path to the parent node (undefined for root-level nodes)\n   * @param resource - The resource value to store in this leaf\n   * @returns Result containing the new leaf node or failure if construction fails\n   */\n  public static create<T>(\n    name: ResourceName,\n    parentPath: ResourceId | undefined,\n    resource: T\n  ): Result<ReadOnlyResourceTreeLeaf<T>> {\n    return captureResult(() => new ReadOnlyResourceTreeLeaf(name, parentPath, resource));\n  }\n}\n\n/**\n * Implementation of a read-only resource tree branch node that contains child nodes.\n * Branch nodes organize other nodes in a hierarchical structure and may optionally contain a resource value.\n * @public\n */\nexport class ReadOnlyResourceTreeBranch<T> implements IReadOnlyResourceTreeBranch<T> {\n  public readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n  public readonly name: ResourceName;\n  public readonly id: ResourceId;\n\n  public get isRoot(): false {\n    return false;\n  }\n\n  public get isBranch(): true {\n    return true;\n  }\n\n  public get isLeaf(): false {\n    return false;\n  }\n\n  /**\n   * Creates a new branch node. Use the static create method instead.\n   * @param name - The name of this node (last segment of the path)\n   * @param parentPath - The path to the parent node (undefined for root-level nodes)\n   * @param init - Initialization data containing child nodes\n   */\n  private constructor(\n    name: ResourceName,\n    parentPath: ResourceId | undefined,\n    init: IResourceTreeBranchInit<T>\n  ) {\n    this.name = name;\n    this.id = Helpers.joinResourceIds(parentPath, name).orThrow();\n\n    const children = mapResults<IReadOnlyResourceTreeNode<T>>(\n      (\n        Array.from(Object.entries(init.children)) as [\n          ResourceName,\n          IResourceTreeBranchInit<T> | IResourceTreeLeafInit<T>\n        ][]\n      ).map(([childName, childInit]) => {\n        if (isResourceTreeLeafInit(childInit)) {\n          return ReadOnlyResourceTreeLeaf.create(childName, this.id, childInit.resource);\n        }\n        return ReadOnlyResourceTreeBranch.create(childName, this.id, childInit);\n      })\n    ).orThrow();\n\n    this.children = new ReadOnlyResourceTreeChildren(\n      this.id,\n      children.map((c): [ResourceName, IReadOnlyResourceTreeNode<T>] => [c.name, c])\n    );\n  }\n\n  /**\n   * Creates a new ReadOnlyResourceTreeBranch instance.\n   * @param childName - The name of this node (last segment of the path)\n   * @param path - The path to the parent node (undefined for root-level nodes)\n   * @param childInit - Initialization data containing child nodes\n   * @returns Result containing the new branch node or failure if construction fails\n   */\n  public static create<T>(\n    childName: ResourceName,\n    path: ResourceId | undefined,\n    childInit: IResourceTreeBranchInit<T>\n  ): Result<ReadOnlyResourceTreeBranch<T>> {\n    return captureResult(() => new ReadOnlyResourceTreeBranch(childName, path, childInit));\n  }\n}\n\n/**\n * Union type representing any node in a read-only resource tree.\n * @public\n */\nexport type ReadOnlyResourceTreeNode<T> = ReadOnlyResourceTreeBranch<T> | ReadOnlyResourceTreeLeaf<T>;\n\n/**\n * Implementation of a read-only resource tree root that organizes resources hierarchically.\n * The root provides the entry point for tree navigation and resource access by ResourceId paths.\n * @public\n */\nexport class ReadOnlyResourceTreeRoot<T> implements IReadOnlyResourceTreeRoot<T> {\n  public readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n\n  public get isRoot(): true {\n    return true;\n  }\n\n  public get isBranch(): false {\n    return false;\n  }\n\n  public get isLeaf(): false {\n    return false;\n  }\n\n  /**\n   * Creates a new root node. Use the static create method instead.\n   * @param init - Initialization data containing child nodes\n   */\n  protected constructor(init: IResourceTreeRootInit<T>) {\n    const children = mapResults<ReadOnlyResourceTreeBranch<T> | ReadOnlyResourceTreeLeaf<T>>(\n      (\n        Array.from(Object.entries(init.children)) as [\n          ResourceName,\n          IResourceTreeBranchInit<T> | IResourceTreeLeafInit<T>\n        ][]\n      ).map(([childName, childInit]) => {\n        if (isResourceTreeLeafInit(childInit)) {\n          return ReadOnlyResourceTreeLeaf.create(childName, undefined, childInit.resource);\n        }\n        return ReadOnlyResourceTreeBranch.create(childName, undefined, childInit);\n      })\n    ).orThrow();\n\n    this.children = new ReadOnlyResourceTreeChildren(\n      undefined,\n      children.map((c): [ResourceName, IReadOnlyResourceTreeNode<T>] => [c.name, c])\n    );\n  }\n\n  /**\n   * Creates a new ReadOnlyResourceTreeRoot from an array of resources.\n   * @param resources - Array of [ResourceId, resource] pairs to build the tree from\n   * @returns Result containing the new root or failure if construction fails\n   */\n  public static create<T>(resources: [ResourceId, T][]): Result<ReadOnlyResourceTreeRoot<T>>;\n\n  /**\n   * Creates a new ReadOnlyResourceTreeRoot from initialization data.\n   * @param init - Tree initialization structure\n   * @returns Result containing the new root or failure if construction fails\n   */\n  public static create<T>(init: IResourceTreeRootInit<T>): Result<ReadOnlyResourceTreeRoot<T>>;\n\n  /**\n   * Creates a new ReadOnlyResourceTreeRoot from either resources or initialization data.\n   * @param init - Either an array of [ResourceId, resource] pairs or tree initialization structure\n   * @returns Result containing the new root or failure if construction fails\n   */\n  public static create<T>(\n    init: IResourceTreeRootInit<T> | [ResourceId, T][]\n  ): Result<ReadOnlyResourceTreeRoot<T>> {\n    if (Array.isArray(init)) {\n      return ReadOnlyResourceTreeRoot.createResourceTreeInit(init).onSuccess((treeInit) =>\n        captureResult(() => new ReadOnlyResourceTreeRoot(treeInit))\n      );\n    }\n    return captureResult(() => new ReadOnlyResourceTreeRoot(init));\n  }\n\n  /**\n   * Converts an array of resources into tree initialization data.\n   * Validates that resource paths do not conflict - if a path has child resources,\n   * it cannot itself be a resource (e.g., if 'app.messages.welcome' exists, then 'app' cannot be a resource).\n   * @param resources - Array of [ResourceId, resource] pairs to convert\n   * @returns Result containing the initialization structure or failure if validation fails\n   */\n  public static createResourceTreeInit<T>(resources: [ResourceId, T][]): Result<IResourceTreeRootInit<T>> {\n    const errors: MessageAggregator = new MessageAggregator();\n    const root: IResourceTreeRootInit<T> = { children: {} };\n\n    for (const [id, resource] of resources) {\n      Helpers.splitResourceId(id)\n        .onSuccess((pathComponents) => {\n          let currentNode: IResourceTreeBranchInit<T> | IResourceTreeRootInit<T> = root;\n          const resourceName = pathComponents.pop()!;\n\n          for (const nodeName of pathComponents) {\n            if (isResourceTreeRootOrNodeInit(currentNode)) {\n              if (!(nodeName in currentNode.children)) {\n                currentNode.children[nodeName] = { children: {} };\n              }\n              if (isResourceTreeLeafInit(currentNode.children[nodeName])) {\n                errors.addMessage(`${id}: Expected a branch but found a leaf at ${nodeName}.`);\n              } else {\n                currentNode = currentNode.children[nodeName];\n              }\n            } /* c8 ignore next 4 - defense in depth, not reachable without chicanery */ else if (\n              isResourceTreeLeafInit(currentNode)\n            ) {\n              errors.addMessage(`${id}: Expected a branch but found a leaf.`);\n              break;\n            } /* c8 ignore next 3 - defense in depth, not reachable without chicanery */ else {\n              errors.addMessage(`${id}: Unexpected structure in resource tree`);\n            }\n          }\n\n          if (isResourceTreeRootOrNodeInit(currentNode)) {\n            if (resourceName in currentNode.children) {\n              errors.addMessage(`${id}: Duplicate resource at path.`);\n            } else {\n              currentNode.children[resourceName] = { resource };\n            } /* c8 ignore next 3 - defense in depth, not reachable without chicanery */\n          } else {\n            errors.addMessage(`${id}: Expected a branch but found a leaf.`);\n          }\n          return succeed(currentNode.children[resourceName]);\n        })\n        .aggregateError(errors);\n    }\n    return errors.returnOrReport(succeed(root));\n  }\n}\n"]}

package/lib/packlets/runtime/resource-tree/resourceTreeChildren.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeChildren.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/resourceTreeChildren.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAe,MAAM,EAAE,SAAS,EAAiB,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAW,MAAM,cAAc,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,uCAAuC,EACxC,MAAM,UAAU,CAAC;AAGlB;;;;GAIG;AACH,qBAAa,4BAA4B,CAAC,CAAC,CACzC,SAAQ,SAAS,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAC5D,YAAW,uCAAuC,CAAC,CAAC,CAAC;IAErD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,6BAA6B,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpE;;;;OAIG;gBACgB,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE;IAMjG,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAYrE,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAYnE,OAAO,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAqB7D,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAarE,aAAa,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC;CAa7E"}

package/lib/packlets/runtime/resource-tree/resourceTreeChildren.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeChildren.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/resourceTreeChildren.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 { Collections, Result, ResultMap, fail, succeed } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName, Helpers } from '../../common';\nimport {\n  IReadOnlyResourceTreeBranch,\n  IReadOnlyResourceTreeChildren,\n  IReadOnlyResourceTreeLeaf,\n  IReadOnlyResourceTreeNode,\n  IReadOnlyValidatingResourceTreeChildren\n} from './common';\nimport { ResourceTreeChildrenValidator } from './resourceTreeChildrenValidator';\n\n/**\n * Implementation of a result-based resource tree that provides hierarchical access to resources.\n * Extends ResultMap to provide collection-like access while adding tree-specific navigation methods.\n * @public\n */\nexport class ReadOnlyResourceTreeChildren<T>\n  extends ResultMap<ResourceName, IReadOnlyResourceTreeNode<T>>\n  implements IReadOnlyValidatingResourceTreeChildren<T>\n{\n  protected path: ResourceId | undefined;\n  public validating: IReadOnlyResourceTreeChildren<T, string, string>;\n\n  /**\n   * Creates a new ReadOnlyResourceTreeChildren instance.\n   * @param path - The path to this tree node (undefined for root)\n   * @param entries - Array of [name, node] tuples to populate the tree\n   */\n  public constructor(path: ResourceId | undefined, entries: [ResourceName, IReadOnlyResourceTreeNode<T>][]) {\n    super(entries);\n    this.path = path;\n    this.validating = new ResourceTreeChildrenValidator<T>(this);\n  }\n\n  public getResource(name: ResourceName): Result<IReadOnlyResourceTreeNode<T>> {\n    return this.get(name).onSuccess((node) => {\n      if (node.isLeaf) {\n        return succeed(node).withDetail<Collections.ResultMapResultDetail>('success');\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      return fail<IReadOnlyResourceTreeNode<T>>(\n        `${name}: not a resource${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n\n  public getBranch(name: ResourceName): Result<IReadOnlyResourceTreeNode<T>> {\n    return this.get(name).onSuccess((node) => {\n      if (node.isBranch) {\n        return succeed(node).withDetail<Collections.ResultMapResultDetail>('success');\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      return fail<IReadOnlyResourceTreeNode<T>>(\n        `${name}: not a branch${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n\n  public getById(id: ResourceId): Result<IReadOnlyResourceTreeNode<T>> {\n    return Helpers.splitResourceId(id).onSuccess((names) => {\n      let name = names.shift();\n      if (name !== undefined) {\n        let node = this.get(name).orDefault();\n        while (node) {\n          name = names.shift();\n          if (name === undefined) {\n            return succeed(node);\n          }\n          if (node.isLeaf) {\n            /* c8 ignore next 1 - defense in depth */\n            return fail(`${id}: resource not found${this.path ? ` in ${this.path}` : ''}.`);\n          }\n          node = (node as IReadOnlyResourceTreeBranch<T>).children.get(name).orDefault();\n        }\n      }\n      return fail(`${id}: resource not found${this.path ? ` in ${this.path}` : ''}.`);\n    });\n  }\n\n  public getResourceById(id: ResourceId): Result<IReadOnlyResourceTreeLeaf<T>> {\n    return this.getById(id).onSuccess((node) => {\n      if (node.isLeaf) {\n        return succeed(node as IReadOnlyResourceTreeLeaf<T>).withDetail<Collections.ResultMapResultDetail>(\n          'success'\n        );\n      }\n      return fail<IReadOnlyResourceTreeLeaf<T>>(\n        `${id}: not a resource${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n\n  public getBranchById(id: ResourceId): Result<IReadOnlyResourceTreeBranch<T>> {\n    return this.getById(id).onSuccess((node) => {\n      if (node.isBranch) {\n        return succeed(node as IReadOnlyResourceTreeBranch<T>).withDetail<Collections.ResultMapResultDetail>(\n          'success'\n        );\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      return fail<IReadOnlyResourceTreeBranch<T>>(\n        `${id}: not a branch${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n}\n"]}

package/lib/packlets/runtime/resource-tree/resourceTreeChildrenValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeChildrenValidator.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/resourceTreeChildrenValidator.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAkB,MAAM,eAAe,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,6BAA6B,CAAC,CAAC,CAAE,YAAW,6BAA6B,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC;IACvG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D;;;OAGG;gBACgB,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC;IAI1D;;;;OAIG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAMhE;;;;OAIG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAMtE;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAMpE;;;;OAIG;IACI,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAMxE;;;;OAIG;IACI,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC;IAMxE;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,OAAO,IAAI,gBAAgB,CAAC,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAIhF;;;;OAIG;IACI,OAAO,CACZ,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,EACtG,GAAG,CAAC,EAAE,OAAO,GACZ,IAAI;IAMP;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,qBAAqB,CAAC;IAOxG;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;;OAGG;IACI,IAAI,IAAI,gBAAgB,CAAC,YAAY,CAAC;IAI7C;;;OAGG;IACI,MAAM,IAAI,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAI/D;;;OAGG;IACI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;CAG3F"}

package/lib/packlets/runtime/resource-tree/resourceTreeChildrenValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeChildrenValidator.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/resourceTreeChildrenValidator.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 { Validate } from '../../common';\nimport { Result, IReadOnlyResultMap, DetailedResult, Collections, failWithDetail } from '@fgv/ts-utils';\nimport { ResourceName } from '../../common';\nimport {\n  IReadOnlyResourceTreeBranch,\n  IReadOnlyResourceTreeChildren,\n  IReadOnlyResourceTreeLeaf,\n  IReadOnlyResourceTreeNode\n} from './common';\n\n/**\n * A validator wrapper for resource tree children that validates string inputs before\n * delegating to the underlying tree children collection.\n *\n * This class implements {@link Runtime.ResourceTree.IReadOnlyValidatingResourceTreeChildren | IReadOnlyValidatingResourceTreeChildren}\n * by wrapping an {@link Runtime.ResourceTree.IReadOnlyResourceTreeChildren | IReadOnlyResourceTreeChildren} instance and\n * providing string-based access to all tree operations. All string inputs are validated using the library's\n * validation utilities before being passed to the underlying collection.\n *\n * The validator acts as a bridge between string-based external APIs and the\n * strongly-typed internal tree operations, ensuring type safety and consistent\n * error handling throughout the resource tree navigation.\n *\n * @public\n */\nexport class ResourceTreeChildrenValidator<T> implements IReadOnlyResourceTreeChildren<T, string, string> {\n  private readonly _inner: IReadOnlyResourceTreeChildren<T>;\n\n  /**\n   * Creates a new validator wrapper for resource tree children.\n   * @param inner - The underlying resource tree children collection to wrap with validation\n   */\n  public constructor(inner: IReadOnlyResourceTreeChildren<T>) {\n    this._inner = inner;\n  }\n\n  /**\n   * Gets a tree node by its string ResourceId path, validating the input.\n   * @param id - The string ResourceId path to validate and look up\n   * @returns Result containing the node if found, or failure if validation fails or not found\n   */\n  public getById(id: string): Result<IReadOnlyResourceTreeNode<T>> {\n    return Validate.toResourceId(id).onSuccess((resourceId) => {\n      return this._inner.getById(resourceId);\n    });\n  }\n\n  /**\n   * Gets a resource node by its string name (single component), validating the input.\n   * @param name - The string ResourceName to validate and look up\n   * @returns Result containing the node if it's a resource, or failure if validation fails or not found\n   */\n  public getResource(name: string): Result<IReadOnlyResourceTreeNode<T>> {\n    return Validate.toResourceName(name).onSuccess((resourceName) => {\n      return this._inner.getResource(resourceName);\n    });\n  }\n\n  /**\n   * Gets a branch node by its string name (single component), validating the input.\n   * @param name - The string ResourceName to validate and look up\n   * @returns Result containing the node if it's a branch, or failure if validation fails or not found\n   */\n  public getBranch(name: string): Result<IReadOnlyResourceTreeNode<T>> {\n    return Validate.toResourceName(name).onSuccess((resourceName) => {\n      return this._inner.getBranch(resourceName);\n    });\n  }\n\n  /**\n   * Gets a resource leaf node by its string ResourceId path, validating the input.\n   * @param id - The string ResourceId path to validate and look up\n   * @returns Result containing the leaf if found and is a resource, or failure otherwise\n   */\n  public getResourceById(id: string): Result<IReadOnlyResourceTreeLeaf<T>> {\n    return Validate.toResourceId(id).onSuccess((resourceId) => {\n      return this._inner.getResourceById(resourceId);\n    });\n  }\n\n  /**\n   * Gets a branch node by its string ResourceId path, validating the input.\n   * @param id - The string ResourceId path to validate and look up\n   * @returns Result containing the branch if found and has children, or failure otherwise\n   */\n  public getBranchById(id: string): Result<IReadOnlyResourceTreeBranch<T>> {\n    return Validate.toResourceId(id).onSuccess((resourceId) => {\n      return this._inner.getBranchById(resourceId);\n    });\n  }\n\n  /**\n   * The number of direct child nodes in this collection.\n   */\n  public get size(): number {\n    return this._inner.size;\n  }\n\n  /**\n   * Returns an iterator of [ResourceName, node] pairs for all child nodes.\n   * @returns Map iterator for all child nodes\n   */\n  public entries(): IterableIterator<[ResourceName, IReadOnlyResourceTreeNode<T>]> {\n    return this._inner.entries();\n  }\n\n  /**\n   * Executes a callback function for each child node in the collection.\n   * @param cb - The callback function to execute for each child node\n   * @param arg - Optional argument to pass to the callback\n   */\n  public forEach(\n    cb: (value: unknown, key: string, map: IReadOnlyResultMap<string, unknown>, thisArg?: unknown) => void,\n    arg?: unknown\n  ): void {\n    for (const [key, value] of this._inner.entries()) {\n      cb(value, key as ResourceName, this, arg);\n    }\n  }\n\n  /**\n   * Gets a child node by its string key with detailed error information.\n   * @param key - The string key to look up\n   * @returns DetailedResult containing the node if found, or failure with details\n   */\n  public get(key: string): DetailedResult<IReadOnlyResourceTreeNode<T>, Collections.ResultMapResultDetail> {\n    if (Validate.isValidResourceName(key)) {\n      return this._inner.get(key);\n    }\n    return failWithDetail(`${key}: invalid resource name.`, 'invalid-key');\n  }\n\n  /**\n   * Checks if a child node exists at the given string key.\n   * @param key - The string key to check\n   * @returns True if a child node exists at the key, false otherwise\n   */\n  public has(key: string): boolean {\n    return this._inner.has(key as ResourceName);\n  }\n\n  /**\n   * Returns an iterator of ResourceName keys for all child nodes.\n   * @returns Map iterator for all child node keys\n   */\n  public keys(): IterableIterator<ResourceName> {\n    return this._inner.keys();\n  }\n\n  /**\n   * Returns an iterator of child node values.\n   * @returns Map iterator for all child node values\n   */\n  public values(): IterableIterator<IReadOnlyResourceTreeNode<T>> {\n    return this._inner.values();\n  }\n\n  /**\n   * Returns an iterator for [ResourceName, node] pairs, enabling for...of iteration.\n   * @returns Iterable iterator for all child nodes\n   */\n  public [Symbol.iterator](): IterableIterator<[ResourceName, IReadOnlyResourceTreeNode<T>]> {\n    return this._inner[Symbol.iterator]();\n  }\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceResolver.js","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceResolver.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 { Result, captureResult, fail, succeed } from '@fgv/ts-utils';\nimport { JsonValue, JsonObject, isJsonObject } from '@fgv/ts-json-base';\nimport { JsonEditor } from '@fgv/ts-json';\nimport { IResourceResolver, NoMatch, ResourceId } from '../common';\nimport { Condition, ConditionSet } from '../conditions';\nimport { AbstractDecision } from '../decisions';\nimport { ReadOnlyQualifierTypeCollector } from '../qualifier-types';\nimport { IContextQualifierProvider, ValidatingSimpleContextQualifierProvider } from './context';\nimport { IResourceManager, IResource, IResourceCandidate } from './iResourceManager';\nimport {\n  ConditionMatchType,\n  ConditionSetResolutionResult,\n  IConditionMatchResult\n} from './conditionSetResolutionResult';\nimport { IResourceResolverCacheListener } from './cacheListener';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\n\n/**\n * Represents the cached result of resolving a decision.\n * Contains either a failure indicator or a list of instance indices for matching condition sets,\n * ordered by condition set priority.\n * @public\n */\nexport type DecisionResolutionResult =\n  | { success: false }\n  | { success: true; instanceIndices: ReadonlyArray<number>; defaultInstanceIndices: ReadonlyArray<number> };\n\n/**\n * Options for configuring a {@link Runtime.ResourceResolver | ResourceResolver}.\n * @public\n */\nexport interface IResourceResolverOptions {\n  /**\n   * Controls whether null values in resource composition should suppress properties\n   * instead of setting them to null. When true, properties with null values from\n   * higher-priority partial candidates will be omitted from the final composed resource.\n   * @defaultValue false\n   */\n  suppressNullAsDelete?: boolean;\n}\n\n/**\n * Parameters for creating a {@link Runtime.ResourceResolver | ResourceResolver}.\n * @public\n */\nexport interface IResourceResolverCreateParams {\n  /**\n   * The {@link Runtime.IResourceManager | resource manager} that defines the resources available\n   * and provides access to qualifiers and conditions.\n   */\n  resourceManager: IResourceManager;\n\n  /**\n   * The {@link QualifierTypes.ReadOnlyQualifierTypeCollector | readonly qualifier type collector}\n   * that provides qualifier implementations for condition evaluation.\n   */\n  qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * The {@link Runtime.Context.IContextQualifierProvider | context qualifier provider} that resolves\n   * qualifier values for the current context.\n   */\n  contextQualifierProvider: IContextQualifierProvider;\n\n  /**\n   * An optional listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n   */\n  listener?: IResourceResolverCacheListener;\n\n  /**\n   * Optional configuration options for the {@link Runtime.ResourceResolver | ResourceResolver}.\n   */\n  options?: IResourceResolverOptions;\n}\n\n/**\n * High-performance runtime resource resolver with O(1) condition caching.\n * Resolves resources for a given context by evaluating conditions against qualifier values\n * and caching results for optimal performance.\n * @public\n */\nexport class ResourceResolver implements IResourceResolver {\n  /**\n   * The resource manager that defines available resources and provides condition access.\n   */\n  public readonly resourceManager: IResourceManager;\n\n  /**\n   * The readonly qualifier type collector that provides qualifier implementations.\n   */\n  public readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * The context qualifier provider that resolves qualifier values.\n   */\n  public readonly contextQualifierProvider: IContextQualifierProvider;\n\n  /**\n   * The configuration options for this resource resolver.\n   */\n  public readonly options: IResourceResolverOptions;\n\n  /**\n   * The readonly qualifier collector that provides qualifier implementations.\n   */\n  public get qualifiers(): IReadOnlyQualifierCollector {\n    return this.contextQualifierProvider.qualifiers;\n  }\n\n  /**\n   * The resource IDs that this resolver can resolve.\n   */\n  public get resourceIds(): ReadonlyArray<ResourceId> {\n    return this.resourceManager.resourceIds;\n  }\n\n  /**\n   * The cache array for resolved conditions, indexed by condition index for O(1) lookup.\n   * Each entry stores the resolved {@link Runtime.IConditionMatchResult | condition match result} for\n   * the corresponding condition.\n   */\n  public get conditionCache(): ReadonlyArray<IConditionMatchResult | undefined> {\n    return this._conditionCache;\n  }\n\n  /**\n   * The cache array for resolved condition sets, indexed by condition set index for O(1) lookup.\n   * Each entry stores the resolved ConditionSetResolutionResult for the corresponding condition set.\n   */\n  public get conditionSetCache(): ReadonlyArray<ConditionSetResolutionResult | undefined> {\n    return this._conditionSetCache;\n  }\n\n  /**\n   * The cache array for resolved decisions, indexed by decision index for O(1) lookup.\n   * Each entry stores the resolved DecisionResolutionResult for the corresponding decision.\n   */\n  public get decisionCache(): ReadonlyArray<DecisionResolutionResult | undefined> {\n    return this._decisionCache;\n  }\n\n  /**\n   * Cache array for resolved conditions, indexed by condition index for O(1) lookup.\n   * Each entry stores the resolved QualifierMatchScore for the corresponding condition.\n   */\n  private readonly _conditionCache: Array<IConditionMatchResult | undefined>;\n\n  /**\n   * Cache array for resolved condition sets, indexed by condition set index for O(1) lookup.\n   * Each entry stores the resolved ConditionSetResolutionResult for the corresponding condition set.\n   */\n  private readonly _conditionSetCache: Array<ConditionSetResolutionResult | undefined>;\n\n  /**\n   * Cache array for resolved decisions, indexed by decision index for O(1) lookup.\n   * Each entry stores the resolved DecisionResolutionResult for the corresponding decision.\n   */\n  private readonly _decisionCache: Array<DecisionResolutionResult | undefined>;\n\n  /**\n   * The listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n   */\n  private readonly _listener?: IResourceResolverCacheListener;\n\n  /**\n   * Constructor for a {@link Runtime.ResourceResolver | ResourceResolver} object.\n   * @param params - {@link Runtime.IResourceResolverCreateParams | Parameters} used to create the resolver.\n   */\n  protected constructor(params: IResourceResolverCreateParams) {\n    this.resourceManager = params.resourceManager;\n    this.qualifierTypes = params.qualifierTypes;\n    this.contextQualifierProvider = params.contextQualifierProvider;\n    this.options = {\n      suppressNullAsDelete: params.options?.suppressNullAsDelete ?? false\n    };\n\n    // Initialize condition cache array with size matching the condition collector\n    const conditionCollectorSize = this.resourceManager.conditions.size;\n    this._conditionCache = new Array<IConditionMatchResult | undefined>(conditionCollectorSize);\n\n    // Initialize condition set cache array with size matching the condition set collector\n    const conditionSetCollectorSize = this.resourceManager.conditionSets.size;\n    this._conditionSetCache = new Array<ConditionSetResolutionResult | undefined>(conditionSetCollectorSize);\n\n    // Initialize decision cache array with size matching the decision collector\n    const decisionCollectorSize = this.resourceManager.decisions.size;\n    this._decisionCache = new Array<DecisionResolutionResult | undefined>(decisionCollectorSize);\n\n    this._listener = params.listener;\n  }\n\n  /**\n   * Creates a new {@link Runtime.ResourceResolver | ResourceResolver} object.\n   * @param params - {@link Runtime.IResourceResolverCreateParams | Parameters} used to create the resolver.\n   * @returns `Success` with the new {@link Runtime.ResourceResolver | ResourceResolver} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceResolverCreateParams): Result<ResourceResolver> {\n    return captureResult(() => new ResourceResolver(params));\n  }\n\n  /**\n   * Resolves a condition by evaluating it against the current context.\n   * Uses O(1) caching based on the condition's globally unique sequential index.\n   * @param condition - The {@link Conditions.Condition | condition} to resolve.\n   * @returns `Success` with the {@link QualifierMatchScore | match score} if successful,\n   * or `Failure` with an error message if the condition cannot be resolved.\n   * @public\n   */\n  public resolveCondition(condition: Condition): Result<IConditionMatchResult> {\n    // Get the condition's index for cache lookup\n    const conditionIndex = condition.index;\n    if (conditionIndex === undefined) {\n      return fail(`Condition \"${condition.key}\" does not have a valid index`);\n    }\n\n    // Check cache first for O(1) lookup\n    const cachedResult = this._conditionCache[conditionIndex];\n    if (cachedResult !== undefined) {\n      this._listener?.onCacheHit('condition', conditionIndex);\n      return succeed(cachedResult);\n    }\n\n    // Resolve the condition by getting qualifier value and evaluating with qualifier type\n    const score = this.contextQualifierProvider\n      .get(condition.qualifier)\n      .onSuccess((qualifierValue) => {\n        // Evaluate the condition using the qualifier type's matching logic\n        return succeed(condition.qualifier.type.matches(condition.value, qualifierValue, condition.operator));\n      })\n      .onFailure((err) => {\n        this._listener?.onContextError(condition.qualifier.name, err);\n        return fail(err);\n      })\n      .orDefault(NoMatch);\n\n    const priority = condition.priority;\n    const scoreAsDefault = condition.scoreAsDefault ?? NoMatch;\n    const matchResult: IConditionMatchResult =\n      score > NoMatch\n        ? { score, priority, matchType: 'match' }\n        : scoreAsDefault > NoMatch\n        ? { score: scoreAsDefault, priority, matchType: 'matchAsDefault' }\n        : { score: NoMatch, priority, matchType: 'noMatch' };\n\n    // Cache the resolved value for future O(1) lookup\n    this._conditionCache[conditionIndex] = matchResult;\n    this._listener?.onCacheMiss('condition', conditionIndex);\n\n    return succeed(matchResult);\n  }\n\n  /**\n   * Resolves a condition set by evaluating all its constituent conditions against the current context.\n   * Uses O(1) caching based on the condition set's globally unique sequential index.\n   * @param conditionSet - The {@link Conditions.ConditionSet | condition set} to resolve.\n   * @returns `Success` with the {@link Runtime.ConditionSetResolutionResult | resolution result} if successful,\n   * or `Failure` with an error message if the condition set cannot be resolved.\n   * @public\n   */\n  public resolveConditionSet(conditionSet: ConditionSet): Result<ConditionSetResolutionResult> {\n    // Get the condition set's index for cache lookup\n    const conditionSetIndex = conditionSet.index;\n    if (conditionSetIndex === undefined) {\n      return fail(`ConditionSet \"${conditionSet.key}\" does not have a valid index`);\n    }\n\n    // Check cache first for O(1) lookup\n    const cachedResult = this._conditionSetCache[conditionSetIndex];\n    if (cachedResult !== undefined) {\n      this._listener?.onCacheHit('conditionSet', conditionSetIndex);\n      return succeed(cachedResult);\n    }\n\n    // Resolve all conditions in the condition set\n    const conditions: Array<IConditionMatchResult> = [];\n    let matchType: ConditionMatchType = 'match';\n\n    for (const condition of conditionSet.conditions) {\n      const { value: conditionResult, message: conditionMessage } = this.resolveCondition(condition);\n\n      /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n      if (conditionMessage !== undefined) {\n        this._listener?.onCacheError('conditionSet', conditionSetIndex);\n        return fail(`Failed to resolve condition \"${condition.key}\": ${conditionMessage}`);\n      }\n\n      conditions.push(conditionResult);\n\n      if (conditionResult.matchType === 'noMatch') {\n        // Cache the failure result\n        return ConditionSetResolutionResult.create('noMatch', conditions)\n          .onSuccess((result) => {\n            this._conditionSetCache[conditionSetIndex] = result;\n            this._listener?.onCacheMiss('conditionSet', conditionSetIndex);\n            return succeed(result);\n          })\n          .onFailure((err) => {\n            /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n            this._conditionSetCache[conditionSetIndex] = undefined;\n            this._listener?.onCacheError('conditionSet', conditionSetIndex);\n            return fail(`${conditionSetIndex}: error creating condition set resolution result: ${err}`);\n          });\n      }\n\n      /* c8 ignore next 3 - edge case: matchAsDefault fallback logic rarely triggered */\n      if (conditionResult.matchType === 'matchAsDefault') {\n        matchType = 'matchAsDefault';\n      }\n    }\n\n    // Cache the successful result\n    return ConditionSetResolutionResult.create(matchType, conditions)\n      .onSuccess((result) => {\n        this._conditionSetCache[conditionSetIndex] = result;\n        this._listener?.onCacheMiss('conditionSet', conditionSetIndex);\n        return succeed(result);\n      })\n      .onFailure((err) => {\n        /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n        this._conditionSetCache[conditionSetIndex] = undefined;\n        this._listener?.onCacheError('conditionSet', conditionSetIndex);\n        return fail(`${conditionSetIndex}: error creating condition set resolution result: ${err}`);\n      });\n  }\n\n  /**\n   * Resolves a decision by evaluating all its constituent condition sets against the current context.\n   * Uses O(1) caching based on the decision's globally unique sequential index.\n   * @param decision - The {@link Decisions.AbstractDecision | abstract decision} to resolve.\n   * @returns `Success` with the {@link Runtime.DecisionResolutionResult | resolution result} if successful,\n   * or `Failure` with an error message if the decision cannot be resolved.\n   * @public\n   */\n  public resolveDecision(decision: AbstractDecision): Result<DecisionResolutionResult> {\n    // Get the decision's index for cache lookup\n    const decisionIndex = decision.index;\n    if (decisionIndex === undefined) {\n      return fail(`Decision \"${decision.key}\" does not have a valid index`);\n    }\n\n    // Check cache first for O(1) lookup\n    const cachedResult = this._decisionCache[decisionIndex];\n    if (cachedResult !== undefined) {\n      this._listener?.onCacheHit('decision', decisionIndex);\n      return succeed(cachedResult);\n    }\n\n    // Resolve all condition sets in the decision\n    const matchingInstanceResults: Array<{ index: number; result: ConditionSetResolutionResult }> = [];\n    const matchingDefaultInstanceResults: Array<{ index: number; result: ConditionSetResolutionResult }> = [];\n\n    for (let instanceIndex = 0; instanceIndex < decision.candidates.length; instanceIndex++) {\n      const candidate = decision.candidates[instanceIndex];\n      const conditionSetResult = this.resolveConditionSet(candidate.conditionSet);\n\n      /* c8 ignore next 4 - defensive in depth */\n      if (conditionSetResult.isFailure()) {\n        this._listener?.onCacheError('decision', decisionIndex);\n        return fail(`${decision.key}: Failed to resolve condition set\": ${conditionSetResult.message}`);\n      }\n\n      const resolution = conditionSetResult.value;\n\n      // Only include condition sets that match\n      if (resolution.matchType === 'match') {\n        matchingInstanceResults.push({\n          index: instanceIndex,\n          result: resolution\n        });\n      } else if (resolution.matchType === 'matchAsDefault') {\n        matchingDefaultInstanceResults.push({\n          index: instanceIndex,\n          result: resolution\n        });\n      }\n      // If condition set doesn't match, we simply skip it and continue (don't fail the decision)\n    }\n\n    // Sort by condition set resolution priority using the proper comparison logic\n    matchingInstanceResults.sort((a, b) => ConditionSetResolutionResult.compare(a.result, b.result));\n    matchingDefaultInstanceResults.sort((a, b) => ConditionSetResolutionResult.compare(a.result, b.result));\n\n    // Extract just the instance indices in priority order\n    const instanceIndices = matchingInstanceResults.map((item) => item.index);\n    const defaultInstanceIndices = matchingDefaultInstanceResults.map((item) => item.index);\n\n    // Cache the successful result\n    const successResult: DecisionResolutionResult = {\n      success: true,\n      instanceIndices,\n      defaultInstanceIndices\n    };\n    this._decisionCache[decisionIndex] = successResult;\n    this._listener?.onCacheMiss('decision', decisionIndex);\n\n    return succeed(successResult);\n  }\n\n  /**\n   * Resolves a resource by finding the best matching candidate.\n   * Uses the resource's associated decision to determine the best match based on the current context.\n   * @param resource - The {@link Resources.Resource | resource} to resolve.\n   * @returns `Success` with the best matching candidate if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveResource(resource: IResource): Result<IResourceCandidate>;\n\n  /**\n   * Resolves a resource by finding the best matching candidate.\n   * Uses the resource's associated decision to determine the best match based on the current context.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with the best matching candidate if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveResource(resource: string): Result<IResourceCandidate>;\n  public resolveResource(idOrResource: string | IResource): Result<IResourceCandidate> {\n    /* c8 ignore next 4 - defensive coding: string resource resolution should use direct resource calls */\n    if (typeof idOrResource === 'string') {\n      return this.resourceManager\n        .getBuiltResource(idOrResource)\n        .onSuccess((resource) => this.resolveResource(resource));\n    }\n\n    const resource = idOrResource;\n\n    // Get the abstract decision from the resource's concrete decision\n    const abstractDecision = resource.decision.baseDecision;\n\n    // Resolve the decision to get candidate indices in priority order\n    const decisionResult = this.resolveDecision(abstractDecision);\n    /* c8 ignore next 3 - defense in depth almost impossible to hit */\n    if (decisionResult.isFailure()) {\n      return fail(`Failed to resolve decision for resource \"${resource.id}\": ${decisionResult.message}`);\n    }\n\n    const resolution = decisionResult.value;\n\n    // Check if any candidates matched (regular or default)\n    if (\n      !resolution.success ||\n      (resolution.instanceIndices.length === 0 && resolution.defaultInstanceIndices.length === 0)\n    ) {\n      return fail(`No matching candidates found for resource \"${resource.id}\"`);\n    }\n\n    // Prefer regular matches over default matches\n    const candidateIndex =\n      resolution.instanceIndices.length > 0\n        ? resolution.instanceIndices[0] // Best regular match\n        : resolution.defaultInstanceIndices[0]; // Best default match\n\n    if (candidateIndex >= resource.candidates.length) {\n      return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n    }\n\n    const bestCandidate = resource.candidates[candidateIndex];\n    return succeed(bestCandidate);\n  }\n\n  /**\n   * Resolves all matching resource candidates in priority order.\n   * Uses the resource's associated decision to determine all matching candidates based on the current context.\n   * @param resource - The {@link Resources.Resource | resource} to resolve.\n   * @returns `Success` with an array of all matching candidates in priority order if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveAllResourceCandidates(resource: IResource): Result<ReadonlyArray<IResourceCandidate>>;\n\n  /**\n   * Resolves all matching resource candidates in priority order.\n   * Uses the resource's associated decision to determine all matching candidates based on the current context.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with an array of all matching candidates in priority order if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveAllResourceCandidates(resource: string): Result<ReadonlyArray<IResourceCandidate>>;\n  public resolveAllResourceCandidates(\n    idOrResource: string | IResource\n  ): Result<ReadonlyArray<IResourceCandidate>> {\n    if (typeof idOrResource === 'string') {\n      return this.resourceManager\n        .getBuiltResource(idOrResource)\n        .onSuccess((resource) => this.resolveAllResourceCandidates(resource));\n    }\n\n    const resource = idOrResource;\n\n    // Get the abstract decision from the resource's concrete decision\n    const abstractDecision = resource.decision.baseDecision;\n\n    // Resolve the decision to get candidate indices in priority order\n    const decisionResult = this.resolveDecision(abstractDecision);\n    /* c8 ignore next 3 - defense in depth almost impossible to hit */\n    if (decisionResult.isFailure()) {\n      return fail(`Failed to resolve decision for resource \"${resource.id}\": ${decisionResult.message}`);\n    }\n\n    const resolution = decisionResult.value;\n\n    // Check if any candidates matched (regular or default)\n    if (\n      !resolution.success ||\n      (resolution.instanceIndices.length === 0 && resolution.defaultInstanceIndices.length === 0)\n    ) {\n      return fail(`No matching candidates found for resource \"${resource.id}\"`);\n    }\n\n    // Get all matching candidates: regular matches first, then default matches\n    const candidates: IResourceCandidate[] = [];\n\n    // Add all regular matches first (already sorted by priority)\n    for (const candidateIndex of resolution.instanceIndices) {\n      if (candidateIndex >= resource.candidates.length) {\n        return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n      }\n      const candidate = resource.candidates[candidateIndex];\n      candidates.push(candidate);\n    }\n\n    // Add all default matches after regular matches (already sorted by priority)\n    for (const candidateIndex of resolution.defaultInstanceIndices) {\n      /* c8 ignore next 3 - defense in depth should not happen */\n      if (candidateIndex >= resource.candidates.length) {\n        return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n      }\n      const candidate = resource.candidates[candidateIndex];\n      candidates.push(candidate);\n    }\n\n    return succeed(candidates);\n  }\n\n  /**\n   * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n   * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n   * priority \"partial\" candidates into it in ascending order of priority.\n   * @param resource - The {@link Resources.Resource | resource} to resolve.\n   * @returns `Success` with the composed JsonValue if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveComposedResourceValue(resource: IResource): Result<JsonValue>;\n\n  /**\n   * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n   * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n   * priority \"partial\" candidates into it in ascending order of priority.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with the composed JsonValue if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveComposedResourceValue(resource: string): Result<JsonValue>;\n  public resolveComposedResourceValue(idOrResource: string | IResource): Result<JsonValue> {\n    /* c8 ignore next 4 - defensive coding: string resource resolution should use direct resource calls */\n    if (typeof idOrResource === 'string') {\n      return this.resourceManager\n        .getBuiltResource(idOrResource)\n        .onSuccess((resource) => this.resolveComposedResourceValue(resource));\n    }\n\n    const resource = idOrResource;\n\n    return this.resolveAllResourceCandidates(resource).onSuccess((candidates) => {\n      /* c8 ignore next 3 - defense in depth should never occur */\n      if (candidates.length === 0) {\n        return fail(`${resource.id}: No matching candidates found.`);\n      }\n\n      // Find the first full candidate and collect all partial candidates above it\n      let fullCandidateIndex = -1;\n      const partialCandidates: IResourceCandidate[] = [];\n\n      for (let i = 0; i < candidates.length; i++) {\n        const candidate = candidates[i];\n        if (!candidate.isPartial) {\n          // Found the first full candidate\n          fullCandidateIndex = i;\n          break;\n        } else {\n          // Collect partial candidates (these are in ascending priority order)\n          partialCandidates.unshift(candidate);\n        }\n      }\n\n      // If no full candidate found, use the last candidate as the base\n      const baseCandidateIndex = fullCandidateIndex >= 0 ? fullCandidateIndex : candidates.length - 1;\n      const baseCandidate = candidates[baseCandidateIndex];\n\n      // If there are no partial candidates to merge, but null-as-delete is enabled,\n      // still process through JsonEditor to handle null properties in the base candidate\n      if (partialCandidates.length === 0) {\n        if (this.options.suppressNullAsDelete || !isJsonObject(baseCandidate.json)) {\n          return succeed(baseCandidate.json);\n        }\n\n        // Process single candidate through JsonEditor to apply null-as-delete\n        const editor = JsonEditor.create({\n          merge: {\n            arrayMergeBehavior: 'replace',\n            nullAsDelete: true\n          }\n        }).orThrow(); // Should never fail with valid options\n\n        return editor\n          .mergeObjectsInPlace({}, [baseCandidate.json])\n          .withErrorFormat((err) => `${resource.id}: Composition failed: ${err}`);\n      }\n\n      const allCandidates = [\n        baseCandidate.json,\n        ...partialCandidates.map((candidate) => candidate.json)\n      ].filter((v): v is JsonObject => isJsonObject(v));\n\n      /* c8 ignore next 3 - defensive check: non-object values in resource candidates should be prevented at validation time */\n      if (allCandidates.length !== partialCandidates.length + 1) {\n        return fail(`${resource.id}: Unable to compose non-object candidate values.`);\n      }\n\n      // Create JsonEditor with array replacement behavior and null-as-delete for resource composition\n      const editor = JsonEditor.create({\n        merge: {\n          arrayMergeBehavior: 'replace',\n          nullAsDelete: !this.options.suppressNullAsDelete\n        }\n      }).orThrow(); // Should never fail with valid options\n\n      return editor\n        .mergeObjectsInPlace({}, allCandidates)\n        .withErrorFormat((err) => `${resource.id}: Composition failed: ${err}`);\n    });\n  }\n\n  /**\n   * {@inheritDoc IResourceResolver.withContext}\n   */\n  public withContext(context: Record<string, string>): Result<ResourceResolver> {\n    const { resourceManager, qualifierTypes, options } = this;\n    return ValidatingSimpleContextQualifierProvider.create({\n      qualifiers: this.qualifiers,\n      qualifierValues: context\n    }).onSuccess((contextQualifierProvider) => {\n      return ResourceResolver.create({\n        resourceManager,\n        qualifierTypes,\n        options,\n        contextQualifierProvider\n      });\n    });\n  }\n\n  /**\n   * Clears all caches (condition, condition set, and decision), forcing all cached items\n   * to be re-evaluated on next access. This should be called when the context changes and cached\n   * results are no longer valid.\n   * @public\n   */\n  public clearConditionCache(): void {\n    this._conditionCache.fill(undefined);\n    this._conditionSetCache.fill(undefined);\n    this._decisionCache.fill(undefined);\n\n    this._listener?.onCacheClear('condition');\n    this._listener?.onCacheClear('conditionSet');\n    this._listener?.onCacheClear('decision');\n  }\n\n  /**\n   * Gets the current size of the condition cache array.\n   * @returns The size of the condition cache array.\n   * @public\n   */\n  public get conditionCacheSize(): number {\n    return this._conditionCache.length;\n  }\n\n  /**\n   * Gets the current size of the condition set cache array.\n   * @returns The size of the condition set cache array.\n   * @public\n   */\n  public get conditionSetCacheSize(): number {\n    return this._conditionSetCache.length;\n  }\n\n  /**\n   * Gets the current size of the decision cache array.\n   * @returns The size of the decision cache array.\n   * @public\n   */\n  public get decisionCacheSize(): number {\n    return this._decisionCache.length;\n  }\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeResolver.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceTreeResolver.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAmD,MAAM,eAAe,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAgC,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAoB,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,KACvB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,UAAU,EAAE,yBAAyB,CAAC,SAAS,CAAC,EAChD,gBAAgB,EAAE,MAAM,EAAE,EAC1B,QAAQ,EAAE,gBAAgB,KACvB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,oBAAoB,CAAC;IAE3D;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,kBAAkB,CAAC;CACvD;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IAC/D;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,CAA+C;IAE7D;;;OAGG;gBACgB,QAAQ,EAAE,gBAAgB;IAK7C;;;OAGG;WACW,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAI9E;;;;;OAKG;IACH,IAAW,IAAI,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAEtD;IAED;;;;;;OAMG;IACI,2BAA2B,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAEjC;;;;;;OAMG;IACI,2BAA2B,CAChC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,EAC1C,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAejC,OAAO,CAAC,QAAQ;IAOhB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;CA4D3B"}