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

package/dist/packlets/conditions/conditionCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionCollector.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAU,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGjG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAgB,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAmBnD;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,mBAA8B;IAQpE;;;;OAIG;IACH,YAAsB,MAAuC;;QAC3D,KAAK,CAAC;YACJ,UAAU,EAAE,IAAI,WAAW,CAAC,kBAAkB,CAA0B;gBACtE,GAAG,EAAE,aAAa,CAAC,YAAY;gBAC/B,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;aAClD,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,8CAA8C;QAC9C,MAAA,MAAM,CAAC,UAAU,0CAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,MAAuC;QAC1D,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEO,YAAY,CAAC,IAAa;QAChC,IAAI,IAAI,YAAY,SAAS,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,sBAAsB;aAC1B,OAAO,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aACzE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, Collections, Result, succeed, ValidatingCollector } from '@fgv/ts-utils';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\nimport { IConditionDecl } from './conditionDecls';\nimport { Condition } from './condition';\nimport { Convert as CommonConvert, ConditionKey } from '../common';\nimport { validatedConditionDecl } from './convert';\n\n/**\n * Parameters for creating a {@link Conditions.ConditionCollector | ConditionCollector}.\n * @public\n */\nexport interface IConditionCollectorCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | ReadOnlyQualifierCollector} used to\n   * create conditions in this collector.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional array of condition declarations to add to the collector.\n   */\n  conditions?: IConditionDecl[];\n}\n\n/**\n * A `ValidatingCollector` for {@link Conditions.Condition | Conditions},\n * which collects conditions supplied as either {@link Conditions.Condition | Condition} or\n * {@link Conditions.IConditionDecl | IConditionDecl}.\n * @public\n */\nexport class ConditionCollector extends ValidatingCollector<Condition> {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | ReadOnlyQualifierCollector} used to create conditions\n   * in this collector.\n   * @public\n   */\n  public qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Constructor for a {@link Conditions.ConditionCollector | ConditionCollector} object.\n   * @param params - Required {@link Conditions.IConditionCollectorCreateParams | parameters} for\n   * creating the collector.\n   */\n  protected constructor(params: IConditionCollectorCreateParams) {\n    super({\n      converters: new Collections.KeyValueConverters<ConditionKey, Condition>({\n        key: CommonConvert.conditionKey,\n        value: (from: unknown) => this._toCondition(from)\n      })\n    });\n    this.qualifiers = params.qualifiers;\n    /* c8 ignore next 1 - ? is defense in depth */\n    params.conditions?.forEach((c) => this.validating.add(c).orThrow());\n  }\n\n  /**\n   * Creates a new {@link Conditions.ConditionCollector | ConditionCollector} object.\n   * @param params - Required {@link Conditions.IConditionCollectorCreateParams | parameters} for\n   * creating the collector.\n   * @returns `Success` with the new collector if successful, or `Failure` with\n   * an error message if not.\n   */\n  public static create(params: IConditionCollectorCreateParams): Result<ConditionCollector> {\n    return captureResult(() => new ConditionCollector(params));\n  }\n\n  private _toCondition(from: unknown): Result<Condition> {\n    if (from instanceof Condition) {\n      return succeed(from);\n    }\n    return validatedConditionDecl\n      .convert(from, { qualifiers: this.qualifiers, conditionIndex: this.size })\n      .onSuccess((c) => Condition.create(c));\n  }\n}\n\n/**\n * Type alias for a read-only {@link Conditions.ConditionCollector | ConditionCollector}.\n * @public\n */\nexport type ReadOnlyConditionCollector = Collections.IReadOnlyValidatingCollector<Condition>;\n"]}

package/dist/packlets/conditions/conditionDecls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionDecls.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionDecls.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 {\n  ConditionIndex,\n  ConditionOperator,\n  ConditionPriority,\n  QualifierConditionValue,\n  QualifierMatchScore\n} from '../common';\nimport { Qualifier } from '../qualifiers';\nimport * as ResourceJson from '../resource-json';\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` (defaulting to `string`) so consumers\n * authoring conditions in code can opt into compile-time axis-name discipline.\n *\n * @public\n */\nexport type IConditionDecl<TQualifierNames extends string = string> =\n  ResourceJson.Json.ILooseConditionDecl<TQualifierNames>;\n\n/**\n * Validated declaration of a {@link Conditions.Condition | condition} with all defaults applied.\n * @public\n */\nexport interface IValidatedConditionDecl {\n  qualifier: Qualifier;\n  value: QualifierConditionValue;\n  operator: ConditionOperator;\n  priority: ConditionPriority;\n  scoreAsDefault?: QualifierMatchScore;\n  index?: ConditionIndex;\n}\n"]}

package/dist/packlets/conditions/conditionSet.js

@@ -145,16 +145,25 @@ export class ConditionSet {
             conditionSetDecl = { conditions: conditionSet };
         }
         else {
-            // ConditionSetDeclAsRecord: Record<string, string | IChildConditionDecl>
-            const conditions = Object.entries(conditionSet).map(([qualifierName, value]) => {
+            // ConditionSetDeclAsRecord: Readonly<Partial<Record<string, string | IChildConditionDecl>>>.
+            // The record-form type is `Readonly<Partial<Record<..., V>>>`, so
+            // `Object.entries` produces `[string, V | undefined]` — runtime
+            // `undefined` values (a key explicitly set to undefined) skip;
+            // they're semantically equivalent to omitting the key.
+            const conditions = [];
+            for (const [qualifierName, value] of Object.entries(conditionSet)) {
+                /* c8 ignore next 3 - defensive: explicit-undefined-value entries skipped */
+                if (value === undefined) {
+                    continue;
+                }
                 if (typeof value === 'string') {
-                    return { qualifierName, value };
+                    conditions.push({ qualifierName, value });
                     /* c8 ignore next 3 - edge case */
                 }
                 else {
-                    return Object.assign({ qualifierName }, value);
+                    conditions.push(Object.assign({ qualifierName }, value));
                 }
-            });
+            }
             conditionSetDecl = { conditions };
         }
         // Validate and convert to IValidatedConditionSetDecl

package/dist/packlets/conditions/conditionSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSet.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSet.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 { captureResult, Collections, Hash, mapResults, Result, succeed } from '@fgv/ts-utils';\nimport { Condition } from './condition';\nimport {\n  Convert as CommonConvert,\n  ConditionSetIndex,\n  ConditionSetKey,\n  QualifierName,\n  Validate\n} from '../common';\nimport { IValidatedConditionSetDecl } from './conditionSetDecls';\nimport * as ConditionsConvert from './convert';\nimport { ConditionCollector } from './conditionCollector';\nimport * as ResourceJson from '../resource-json';\nimport * as Context from '../context';\n\n/**\n * Options for creating a {@link Conditions.ConditionSet | ConditionSet} declaration.\n * @remarks\n * This interface extends the {@link ResourceJson.Helpers.IDeclarationOptions | declaration options}\n * interface to include a `reduceQualifiers` option.\n * @public\n */\nexport interface IConditionSetDeclOptions extends ResourceJson.Helpers.IDeclarationOptions {\n  /**\n   * If provided, reduces the qualifiers of the condition set by removing qualifiers that are made\n   * irrelevant by the filterForContext.\n   */\n  qualifiersToReduce?: ReadonlySet<QualifierName>;\n}\n\n/**\n * Represents a set of {@link Conditions.Condition | conditions} that must all be met in some runtime\n * context for a resource instance to be valid.\n * @public\n */\nexport class ConditionSet implements IValidatedConditionSetDecl {\n  protected readonly _collectible: Collections.Collectible<ConditionSetKey, ConditionSetIndex>;\n  /**\n   * The {@link Conditions.Condition | conditions} that make up this condition\n   * set.\n   * @public\n   */\n  public readonly conditions: ReadonlyArray<Condition>;\n\n  /**\n   * The key for this condition set.\n   */\n  public get key(): ConditionSetKey {\n    return this._collectible.key;\n  }\n\n  /**\n   * The number of conditions in this condition set.\n   */\n  public get size(): number {\n    return this.conditions.length;\n  }\n\n  /**\n   * The index for this condition set.\n   */\n  public get index(): ConditionSetIndex | undefined {\n    return this._collectible.index;\n  }\n\n  /**\n   * The key for an unconditional condition set.\n   */\n  public static UnconditionalKey: ConditionSetKey = Validate.toConditionSetKey('').orThrow();\n\n  /**\n   * Constructor for a {@link Conditions.ConditionSet | ConditionSet} object.\n   * @param params - {@link Conditions.IValidatedConditionSetDecl | Validated declaration}\n   * used to create the condition set.\n   */\n  protected constructor(params: IValidatedConditionSetDecl) {\n    const qualifiers = new Map<QualifierName, Condition>();\n    for (const condition of params.conditions) {\n      /* c8 ignore next 9 - there's a test for this but coverage is having a bad day */\n      if (qualifiers.has(condition.qualifier.name)) {\n        const existing = qualifiers.get(condition.qualifier.name)?.toString() ?? 'unknown';\n        throw new Error(\n          `${\n            condition.qualifier.name\n          }: Duplicate conditions ${existing} and ${condition.toString()} are not supported.`\n        );\n      }\n      qualifiers.set(condition.qualifier.name, condition);\n    }\n    this.conditions = Array.from(params.conditions).sort(Condition.compare).reverse();\n    this._collectible = new Collections.Collectible({\n      key: this.toKey(),\n      index: params.index,\n      indexConverter: CommonConvert.conditionSetIndex\n    });\n  }\n\n  /**\n   * Creates a new {@link Conditions.ConditionSet | ConditionSet} object.\n   * @param params - {@link Conditions.IValidatedConditionSetDecl | Validated declaration}\n   * used to create the condition set.\n   * @returns `Success` with the new {@link Conditions.ConditionSet | ConditionSet} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IValidatedConditionSetDecl): Result<ConditionSet> {\n    return captureResult(() => new ConditionSet(params));\n  }\n\n  /**\n   * Compares two {@link Conditions.ConditionSet | ConditionSets} for sorting purposes.\n   * @param cs1 - The first {@link Conditions.ConditionSet | ConditionSet} to compare.\n   * @param cs2 - The second {@link Conditions.ConditionSet | ConditionSet} to compare.\n   * @returns A negative number if `cs1` should come before `cs2`, a positive\n   * number if `cs1` should come after `cs2`, or zero if they are equivalent.\n   * @public\n   */\n  public static compare(cs1: ConditionSet, cs2: ConditionSet): number {\n    const len = Math.min(cs1.conditions.length, cs2.conditions.length);\n    for (let i = 0; i < len; i++) {\n      const diff = Condition.compare(cs1.conditions[i], cs2.conditions[i]);\n      if (diff !== 0) {\n        return diff;\n      }\n    }\n    return cs1.conditions.length - cs2.conditions.length;\n  }\n\n  /**\n   * Sets the global index for this condition set.  Once set, the index cannot be changed.\n   * @param index - The index to set for this condition set.\n   * @returns `Success` with the index if successful, `Failure` otherwise.\n   */\n  public setIndex(index: number): Result<ConditionSetIndex> {\n    return this._collectible.setIndex(index);\n  }\n\n  /**\n   * Determines if this condition set can match a supplied context, even if the context is partial.\n   * Returns true if all conditions in the set can match the context (using canMatchPartialContext).\n   * Returns false otherwise.\n   * @param context - The context to match.\n   * @param options - Options to use when matching.\n   * @returns `true` if all conditions can match the context, `false` otherwise.\n   */\n  public canMatchPartialContext(\n    context: Context.IValidatedContextDecl,\n    options?: Context.IContextMatchOptions\n  ): boolean {\n    return this.conditions.every((c) => c.canMatchPartialContext(context, options));\n  }\n\n  /**\n   * Gets the {@link ConditionSetKey | key} for a supplied {@link Conditions.IValidatedConditionSetDecl | condition set declaration}.\n   * @param decl - The {@link Conditions.IValidatedConditionSetDecl | condition set declaration} for which to get the key.\n   * @returns `Success` with the condition set key if successful, `Failure` otherwise.\n   * @public\n   */\n  public static getKeyForDecl(decl: IValidatedConditionSetDecl): Result<ConditionSetKey> {\n    return Validate.toConditionSetKey(decl.conditions.map((c) => c.toKey()).join('+'));\n  }\n\n  /**\n   * Gets a condition set key from a loose condition set declaration.\n   * @param conditionSet - The loose condition set declaration to convert.\n   * @param conditionCollector - The condition collector used for validation.\n   * @returns `Success` with the condition set key if successful, `Failure` otherwise.\n   * @public\n   */\n  public static getKeyFromLooseDecl(\n    conditionSet: ResourceJson.Json.ConditionSetDecl | undefined,\n    conditionCollector: ConditionCollector\n  ): Result<ConditionSetKey> {\n    if (!conditionSet) {\n      return succeed(ConditionSet.UnconditionalKey);\n    }\n\n    // Convert ConditionSetDecl to IConditionSetDecl format\n    let conditionSetDecl: { conditions: ResourceJson.Json.ILooseConditionDecl[] };\n\n    if (Array.isArray(conditionSet)) {\n      // ConditionSetDeclAsArray: array of ILooseConditionDecl\n      conditionSetDecl = { conditions: conditionSet };\n    } else {\n      // ConditionSetDeclAsRecord: Readonly<Partial<Record<string, string | IChildConditionDecl>>>.\n      // The record-form type is `Readonly<Partial<Record<..., V>>>`, so\n      // `Object.entries` produces `[string, V | undefined]` — runtime\n      // `undefined` values (a key explicitly set to undefined) skip;\n      // they're semantically equivalent to omitting the key.\n      const conditions: ResourceJson.Json.ILooseConditionDecl[] = [];\n      for (const [qualifierName, value] of Object.entries(conditionSet)) {\n        /* c8 ignore next 3 - defensive: explicit-undefined-value entries skipped */\n        if (value === undefined) {\n          continue;\n        }\n        if (typeof value === 'string') {\n          conditions.push({ qualifierName, value });\n          /* c8 ignore next 3 - edge case */\n        } else {\n          conditions.push({ qualifierName, ...value });\n        }\n      }\n      conditionSetDecl = { conditions };\n    }\n\n    // Validate and convert to IValidatedConditionSetDecl\n    return ConditionsConvert.validatedConditionSetDecl\n      .convert(conditionSetDecl, { conditions: conditionCollector })\n      .onSuccess((validatedDecl) => {\n        // Use proper ConditionSet.getKeyForDecl method to generate the key\n        return ConditionSet.getKeyForDecl(validatedDecl);\n      });\n  }\n\n  /**\n   * Gets a {@link ConditionSetToken | condition set token} for this condition set,\n   * if possible.\n   * @param terse - If true, the token will be terse, omitting qualifier names where\n   * possible.\n   * @returns `Success` with the {@link ConditionSetToken | condition set token} if successful,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public toToken(terse?: boolean): Result<string> {\n    return mapResults(this.conditions.map((c) => c.toToken(terse))).onSuccess((tokens) => {\n      return Validate.toConditionSetToken(tokens.join(','));\n    });\n  }\n\n  /**\n   * Gets the {@link ConditionSetKey | key} for this condition set.\n   * @returns The key for this condition set.\n   */\n  public toKey(): ConditionSetKey {\n    return ConditionSet.getKeyForDecl(this).orThrow();\n  }\n\n  /**\n   * Gets a hash of this condition set.\n   * @returns A hash of this condition\n   * set key.\n   * @public\n   */\n  public toHash(): string {\n    return Hash.Crc32Normalizer.crc32Hash([this.key]).padStart(8, '0');\n  }\n\n  /**\n   * Gets a human-readable string representation of this condition set.\n   * @returns A string representation of this condition set.\n   */\n  public toString(): string {\n    return this.toKey();\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ConditionSetDeclAsRecord | condition set declaration as a record} for this condition set.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the condition set declaration.\n   * @returns The {@link ResourceJson.Json.ConditionSetDeclAsRecord | condition set declaration as a record} for this condition set.\n   */\n  public toConditionSetRecordDecl(\n    options?: IConditionSetDeclOptions\n  ): ResourceJson.Json.ConditionSetDeclAsRecord {\n    const qualifiersToReduce = options?.qualifiersToReduce;\n    const conditions = qualifiersToReduce\n      ? /* c8 ignore next 1 - coverage intermittently misses the next line */\n        this.conditions.filter((c) => !qualifiersToReduce.has(c.qualifier.name))\n      : this.conditions;\n    return Object.fromEntries(\n      conditions.map((c): [string, ResourceJson.Json.IChildConditionDecl | string] => {\n        return [c.qualifier.name, c.toValueOrChildConditionDecl(options)];\n      })\n    );\n  }\n\n  /**\n   * Gets the {@link ResourceJson.Json.ConditionSetDeclAsArray | condition set declaration as an array} for this condition set.\n   * @param options - {@link ResourceJson.Helpers.IDeclarationOptions | options} for the condition set declaration.\n   * @returns The {@link ResourceJson.Json.ConditionSetDeclAsArray | condition set declaration as an array} for this condition set.\n   */\n  public toConditionSetArrayDecl(\n    options?: IConditionSetDeclOptions\n  ): ResourceJson.Json.ConditionSetDeclAsArray {\n    /* c8 ignore next 1 - defense in depth */\n    const qualifiersToReduce = options?.qualifiersToReduce;\n    const conditions = qualifiersToReduce\n      ? this.conditions.filter((c) => !qualifiersToReduce.has(c.qualifier.name))\n      : this.conditions;\n    return conditions.map((c) => c.toLooseConditionDecl(options));\n  }\n\n  /**\n   * Converts this condition set to a compiled condition set representation.\n   * @param options - Optional compilation options controlling the output format.\n   * @returns A compiled condition set object that can be used for serialization or runtime processing.\n   * @public\n   */\n  public toCompiled(\n    options?: ResourceJson.Compiled.ICompiledResourceOptions\n  ): ResourceJson.Compiled.ICompiledConditionSet {\n    return {\n      conditions: this.conditions.map((c) => c.index!),\n      ...(options?.includeMetadata === true ? { metadata: { key: this.key } } : {})\n    };\n  }\n}\n"]}

package/dist/packlets/conditions/conditionSetCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetCollector.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAU,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG7G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAmB,OAAO,IAAI,aAAa,EAAqB,QAAQ,EAAE,MAAM,WAAW,CAAC;AAoBnG;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,mBAAiC;IAO1E;;;OAGG;IACH,IAAW,yBAAyB;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,CAAC;IACxE,CAAC;IAOD;;;;OAIG;IACH,YAAsB,MAA0C;;QAC9D,KAAK,CAAC;YACJ,UAAU,EAAE,IAAI,WAAW,CAAC,kBAAkB,CAAgC;gBAC5E,GAAG,EAAE,aAAa,CAAC,eAAe;gBAClC,wEAAwE;gBACxE,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;aACrD,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,+EAA+E;QAC/E,gBAAgB;QAChB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACjF,8CAA8C;QAC9C,MAAA,MAAM,CAAC,aAAa,0CAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,MAA0C;QAC7D,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,eAAe,CAAC,IAAa;QACnC,IAAI,IAAI,YAAY,YAAY,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CACxF,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CACpD,CAAC;QACJ,CAAC;QACD,uFAAuF;QACvF,OAAO,yBAAyB;aAC7B,OAAO,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aAC5E,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;;AAlDD;;GAEG;AACW,wCAAkB,GAAsB,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, Collections, mapResults, Result, succeed, ValidatingCollector } from '@fgv/ts-utils';\nimport { ConditionCollector } from './conditionCollector';\nimport { IConditionSetDecl } from './conditionSetDecls';\nimport { ConditionSet } from './conditionSet';\nimport { validatedConditionSetDecl } from './convert';\nimport { ConditionSetKey, Convert as CommonConvert, ConditionSetIndex, Validate } from '../common';\n\n/**\n * Parameters for creating a {@link Conditions.ConditionSetCollector | ConditionSetCollector}.\n * @public\n */\nexport interface IConditionSetCollectorCreateParams {\n  /**\n   * The {@link Conditions.ConditionCollector | ConditionCollector} used to create conditions\n   * for conditions in this collector.\n   */\n  conditions: ConditionCollector;\n\n  /**\n   * Optional array of {@link Conditions.IConditionSetDecl | condition set declarations} to add to\n   * the collector.\n   */\n  conditionSets?: IConditionSetDecl[];\n}\n\n/**\n * A `ValidatingCollector` for {@link Conditions.ConditionSet | ConditionSets},\n * which collects condition sets supplied as {@link Conditions.ConditionSet | ConditionSet} or\n * as {@link Conditions.IConditionSetDecl | IConditionSetDecl} via the methods on the\n * `validating` property.\n * @public\n */\nexport class ConditionSetCollector extends ValidatingCollector<ConditionSet> {\n  /**\n   * Gets the {@link Conditions.ConditionCollector | ConditionCollector} used to create conditions\n   * for conditions in this collector.\n   */\n  public conditions: ConditionCollector;\n\n  /**\n   * Gets the {@link Conditions.ConditionSet | ConditionSet} at the unconditional\n   * condition set index.\n   */\n  public get unconditionalConditionSet(): ConditionSet {\n    return this.getAt(ConditionSetCollector.UnconditionalIndex).orThrow();\n  }\n\n  /**\n   * The index of the unconditional condition set.\n   */\n  public static UnconditionalIndex: ConditionSetIndex = Validate.toConditionSetIndex(0).orThrow();\n\n  /**\n   * Creates a new {@link Conditions.ConditionSetCollector | ConditionSetCollector}.\n   * @param params - {@link Conditions.IConditionSetCollectorCreateParams | Parameters} used to create\n   * the collector.\n   */\n  protected constructor(params: IConditionSetCollectorCreateParams) {\n    super({\n      converters: new Collections.KeyValueConverters<ConditionSetKey, ConditionSet>({\n        key: CommonConvert.conditionSetKey,\n        /* c8 ignore next 1 - there's a test but coverage is having a bad day */\n        value: (from: unknown) => this._toConditionSet(from)\n      })\n    });\n    this.conditions = params.conditions;\n    // it's very helpful for debugging if the unconditional condition set is always\n    // in position 0\n    this.validating.add(ConditionSet.create({ conditions: [] }).orThrow()).orThrow();\n    /* c8 ignore next 1 - ? is defense in depth */\n    params.conditionSets?.forEach((item) => this.validating.add(item).orThrow());\n  }\n\n  /**\n   * Creates a new {@link Conditions.ConditionSetCollector | ConditionSetCollector}.\n   * @param params - {@link Conditions.IConditionSetCollectorCreateParams | Parameters} used to create\n   * the collector.\n   * @returns `Success` with the new collector if successful, or `Failure` with an error message\n   * if not.\n   */\n  public static create(params: IConditionSetCollectorCreateParams): Result<ConditionSetCollector> {\n    return captureResult(() => new ConditionSetCollector(params));\n  }\n\n  private _toConditionSet(from: unknown): Result<ConditionSet> {\n    if (from instanceof ConditionSet) {\n      return succeed(from);\n    }\n    if (Array.isArray(from)) {\n      return mapResults(from.map((item) => this.conditions.validating.getOrAdd(item))).onSuccess(\n        (conditions) => ConditionSet.create({ conditions })\n      );\n    }\n    /* c8 ignore next 4 - functional code path tested but coverage intermittently missed */\n    return validatedConditionSetDecl\n      .convert(from, { conditions: this.conditions, conditionSetIndex: this.size })\n      .onSuccess((c) => ConditionSet.create(c));\n  }\n}\n\n/**\n * A read-only {@link Conditions.ConditionSetCollector | ConditionSetCollector}.\n * @public\n */\nexport type ReadOnlyConditionSetCollector = Collections.IReadOnlyValidatingCollector<ConditionSet>;\n"]}

package/dist/packlets/conditions/conditionSetDecls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetDecls.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetDecls.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 { Condition } from './condition';\nimport { IConditionDecl } from './conditionDecls';\n\n/**\n * Non-validated declaration of a {@link Conditions.ConditionSet | set of conditions}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` (defaulting to `string`) so consumers can\n * opt into compile-time axis-name discipline by supplying a literal-string union.\n *\n * @public\n */\nexport interface IConditionSetDecl<TQualifierNames extends string = string> {\n  conditions: IConditionDecl<TQualifierNames>[];\n}\n\n/**\n * Validated declaration of a {@link Conditions.ConditionSet | set of conditions}.\n * @public\n */\nexport interface IValidatedConditionSetDecl {\n  conditions: ReadonlyArray<Condition>;\n  index?: number;\n}\n"]}

package/dist/packlets/conditions/conditionToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionToken.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionToken.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 { mapResults, Result, fail, succeed } from '@fgv/ts-utils';\nimport { Helpers as CommonHelpers, ConditionOperator } from '../common';\nimport { IValidatedConditionDecl } from './conditionDecls';\nimport { IReadOnlyQualifierCollector, Qualifier } from '../qualifiers';\n\n/**\n * Helper class to parse and validate condition tokens.\n * @public\n */\nexport class ConditionTokens {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to validate\n   * qualifier names and values.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Constructs a new {@link Conditions.ConditionTokens | ConditionTokens } instance.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   */\n  public constructor(qualifiers: IReadOnlyQualifierCollector) {\n    this.qualifiers = qualifiers;\n  }\n\n  /**i\n   * Parses a {@link ConditionToken | condition token} string and validates the parts\n   * against the qualifiers present in the {@link Conditions.ConditionTokens.qualifiers | qualifier collector}.\n   * @param token - the token string to parse.\n   * @returns `Success` with the {@link Conditions.IValidatedConditionDecl | validated condition declaration}\n   * if successful, `Failure` with an error message if not.\n   */\n  public parseConditionToken(token: string): Result<IValidatedConditionDecl> {\n    return ConditionTokens.parseConditionToken(token, this.qualifiers);\n  }\n\n  /**\n   * Parses a {@link ConditionSetToken | condition set token} string and validates the parts\n   * against the qualifiers present in the {@link Conditions.ConditionTokens.qualifiers | qualifier collector}.\n   * @param token - the token string to parse.\n   * @returns `Success` with the array of {@link Conditions.IValidatedConditionDecl | validated condition declarations}\n   * if successful, `Failure` with an error message if not.\n   */\n  public parseConditionSetToken(token: string): Result<IValidatedConditionDecl[]> {\n    return ConditionTokens.parseConditionSetToken(token, this.qualifiers);\n  }\n\n  /**\n   * Validates the {@link Helpers.IConditionTokenParts | parts} of a {@link ConditionToken | condition token}.\n   * @param parts - the parts to validate\n   * @returns `Success` with the validated declaration if successful, `Failure` with an error message if not.\n   */\n  public validateConditionTokenParts(\n    parts: CommonHelpers.IConditionTokenParts\n  ): Result<IValidatedConditionDecl> {\n    return ConditionTokens.validateConditionTokenParts(parts, this.qualifiers);\n  }\n\n  /**\n   * Given a value, finds a single token-optional qualifier that matches the value.\n   * Fails if no qualifiers match, or if more than one qualifier matches.\n   * @param value - the value to match.\n   * @returns `Success` with the matching qualifier if successful, `Failure` with an error message if not.\n   */\n  public findQualifierForValue(value: string): Result<Qualifier> {\n    return ConditionTokens.findQualifierForValue(value, this.qualifiers);\n  }\n\n  /**\n   * Parses a {@link ConditionToken | condition token} and validates it against the qualifiers\n   * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.\n   * @param token - the token string to parse.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   * @returns `Success` with a {@link Conditions.IValidatedConditionDecl | validated condition declaration} if successful,\n   * `Failure` with an error message if not.\n   */\n  public static parseConditionToken(\n    token: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedConditionDecl> {\n    return CommonHelpers.parseConditionTokenParts(token).onSuccess((parts) => {\n      return ConditionTokens.validateConditionTokenParts(parts, qualifiers);\n    });\n  }\n\n  /**\n   * Parses a {@link ConditionSetToken | condition set token} and validates it against the qualifiers\n   * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.\n   * @param token - the token string to parse.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   * @returns `Success` with an array of {@link Conditions.IValidatedConditionDecl | validated condition declarations}\n   * if successful, `Failure` with an error message if not\n   */\n  public static parseConditionSetToken(\n    token: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedConditionDecl[]> {\n    return CommonHelpers.parseConditionSetTokenParts(token).onSuccess((parts) => {\n      return mapResults(parts.map((part) => ConditionTokens.validateConditionTokenParts(part, qualifiers)));\n    });\n  }\n\n  /**\n   * Validates the parts of a condition token against the qualifiers present in the supplied\n   * {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.\n   * @param parts - the {@link Helpers.IConditionTokenParts | condition token parts} to validate.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to\n   * validate qualifier names and values.\n   * @returns `Success` with a {@link Conditions.IValidatedConditionDecl | validated condition declaration} if successful,\n   * `Failure` with an error message if not.\n   */\n  public static validateConditionTokenParts(\n    parts: CommonHelpers.IConditionTokenParts,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedConditionDecl> {\n    const qualifierLookup =\n      parts.qualifier === undefined\n        ? ConditionTokens.findQualifierForValue(parts.value, qualifiers)\n        : qualifiers.getByNameOrToken(parts.qualifier);\n\n    return qualifierLookup.onSuccess((qualifier) => {\n      return qualifier.type\n        .validateCondition(parts.value)\n        .onSuccess((value) => {\n          const operator: ConditionOperator = 'matches';\n          const priority = qualifier.defaultPriority;\n          return succeed({ qualifier, value, operator, priority });\n        })\n        .withDetail('failure', 'success');\n    });\n  }\n\n  /**\n   * Given a value and a set of qualifiers, finds a single token-optional qualifier that matches the value.\n   * Fails if no qualifiers match, or if more than one qualifier matches.\n   * @param value - the value to match.\n   * @param qualifiers - the qualifiers to match against.\n   * @returns `Success` with the matching qualifier if successful, `Failure` with an error message if not.\n   */\n  public static findQualifierForValue(\n    value: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<Qualifier> {\n    const matched: Qualifier[] = [];\n    for (const qualifier of qualifiers.values()) {\n      if (qualifier.tokenIsOptional && qualifier.validateCondition(value).isSuccess()) {\n        matched.push(qualifier);\n      }\n    }\n    if (matched.length === 0) {\n      return fail(`${value}: does not match any qualifier`);\n    }\n    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (matched.length > 1) {\n      return fail(`${value}: matches multiple qualifiers (${matched.map((q) => q.name).join(', ')})`);\n    }\n    return succeed(matched[0]);\n  }\n}\n"]}

package/dist/packlets/conditions/convert/conditionSetDecls.js

@@ -20,32 +20,76 @@
  * SOFTWARE.
  */
 import { Converters, fail, mapResults, succeed } from '@fgv/ts-utils';
-import { conditionDecl } from './decls';
+import { conditionDecl, typedConditionDecl } from './decls';
 /* eslint-disable @rushstack/typedef-var */
 /**
  * Converter which converts to a {@link Conditions.IConditionSetDecl | condition set declaration}.
+ *
+ * @remarks
+ * Accepts any string as the qualifier name of each contained condition. Use
+ * `typedConditionSetDecl` to narrow the accepted set of qualifier names to a literal-string union.
+ *
  * @public
  */
 export const conditionSetDecl = Converters.strictObject({
     conditions: Converters.arrayOf(conditionDecl)
 });
 /**
- * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}
- * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name
- * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.
+ * Returns a `Converter` for an `IConditionSetDecl<TQualifierNames>` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * Each contained condition is converted via `typedConditionDecl(qualifierNameConverter)`.
+ *
  * @public
  */
-export const validatedConditionSetDecl = Converters.generic((from, __self, context) => {
+// Keep the field list below in sync with `conditionSetDecl` above; the
+// duplication preserves the `ObjectConverter` return type on the default.
+export function typedConditionSetDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        conditions: Converters.arrayOf(typedConditionDecl(qualifierNameConverter))
+    });
+}
+function _validatedConditionSetDeclBody(innerConditionSetDecl, from, context) {
     /* c8 ignore next 3 - coverage is having a bad day */
     if (!context) {
         return fail('validatedConditionSetDecl converter requires a context');
     }
-    return conditionSetDecl.convert(from).onSuccess((decl) => {
+    return innerConditionSetDecl.convert(from).onSuccess((decl) => {
         return mapResults(decl.conditions.map((condition) => context.conditions.validating.getOrAdd(condition))).onSuccess((conditions) => {
             /* c8 ignore next 1 - coverage having issues */
             const index = context.conditionSetIndex ? context.conditionSetIndex++ : undefined;
             return succeed({ conditions, index });
         });
     });
+}
+/**
+ * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}
+ * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name
+ * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.
+ *
+ * @remarks
+ * Accepts any string as the qualifier name. Use `typedValidatedConditionSetDecl` to layer
+ * literal-string narrowing on top of the collector-membership check.
+ *
+ * @public
+ */
+export const validatedConditionSetDecl = Converters.generic((from, __self, context) => {
+    return _validatedConditionSetDeclBody(conditionSetDecl, from, context);
 });
+/**
+ * Returns a `Converter` for an `IValidatedConditionSetDecl` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @public
+ */
+// Shares the `_validatedConditionSetDeclBody` helper with
+// `validatedConditionSetDecl` above, so the body cannot drift; only the inner
+// condition-set-decl converter differs.
+export function typedValidatedConditionSetDecl(qualifierNameConverter) {
+    const inner = typedConditionSetDecl(qualifierNameConverter);
+    return Converters.generic((from, __self, context) => {
+        return _validatedConditionSetDeclBody(inner, from, context);
+    });
+}
 //# sourceMappingURL=conditionSetDecls.js.map

package/dist/packlets/conditions/convert/conditionSetDecls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetDecls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAa,UAAU,EAAU,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG5D,2CAA2C;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC,YAAY,CAAoB;IACzE,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC;CAC9C,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,uEAAuE;AACvE,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CACnC,sBAAkD;IAElD,OAAO,UAAU,CAAC,YAAY,CAAqC;QACjE,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC;AAYD,SAAS,8BAA8B,CACrC,qBAAoE,EACpE,IAAa,EACb,OAAyC;IAEzC,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5D,OAAO,UAAU,CACf,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACtF,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACzB,+CAA+C;YAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAClF,OAAO,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,CAGzD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAyC,EAAsC,EAAE;IACzG,OAAO,8BAA8B,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,0DAA0D;AAC1D,8EAA8E;AAC9E,wCAAwC;AACxC,MAAM,UAAU,8BAA8B,CAC5C,sBAAkD;IAElD,MAAM,KAAK,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;IAC5D,OAAO,UAAU,CAAC,OAAO,CACvB,CACE,IAAa,EACb,MAAM,EACN,OAAyC,EACL,EAAE;QACtC,OAAO,8BAA8B,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC,CACF,CAAC;AACJ,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converter, Converters, Result, fail, mapResults, succeed } from '@fgv/ts-utils';\nimport { IConditionSetDecl, IValidatedConditionSetDecl } from '../conditionSetDecls';\nimport { conditionDecl, typedConditionDecl } from './decls';\nimport { ConditionCollector } from '../conditionCollector';\n\n/* eslint-disable @rushstack/typedef-var */\n\n/**\n * Converter which converts to a {@link Conditions.IConditionSetDecl | condition set declaration}.\n *\n * @remarks\n * Accepts any string as the qualifier name of each contained condition. Use\n * `typedConditionSetDecl` to narrow the accepted set of qualifier names to a literal-string union.\n *\n * @public\n */\nexport const conditionSetDecl = Converters.strictObject<IConditionSetDecl>({\n  conditions: Converters.arrayOf(conditionDecl)\n});\n\n/**\n * Returns a `Converter` for an `IConditionSetDecl<TQualifierNames>` narrowed on a supplied\n * `qualifierName` converter.\n *\n * @remarks\n * Each contained condition is converted via `typedConditionDecl(qualifierNameConverter)`.\n *\n * @public\n */\n// Keep the field list below in sync with `conditionSetDecl` above; the\n// duplication preserves the `ObjectConverter` return type on the default.\nexport function typedConditionSetDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<IConditionSetDecl<TQualifierNames>> {\n  return Converters.strictObject<IConditionSetDecl<TQualifierNames>>({\n    conditions: Converters.arrayOf(typedConditionDecl(qualifierNameConverter))\n  });\n}\n\n/**\n * Context for converting a {@link Conditions.IConditionSetDecl | condition set declaration}\n * into an instantiated {@link Conditions.ConditionSet | condition set} object.\n * @public\n */\nexport interface IConditionSetDeclConvertContext {\n  readonly conditions: ConditionCollector;\n  conditionSetIndex?: number;\n}\n\nfunction _validatedConditionSetDeclBody<TQualifierNames extends string>(\n  innerConditionSetDecl: Converter<IConditionSetDecl<TQualifierNames>>,\n  from: unknown,\n  context?: IConditionSetDeclConvertContext\n): Result<IValidatedConditionSetDecl> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!context) {\n    return fail('validatedConditionSetDecl converter requires a context');\n  }\n\n  return innerConditionSetDecl.convert(from).onSuccess((decl) => {\n    return mapResults(\n      decl.conditions.map((condition) => context.conditions.validating.getOrAdd(condition))\n    ).onSuccess((conditions) => {\n      /* c8 ignore next 1 - coverage having issues */\n      const index = context.conditionSetIndex ? context.conditionSetIndex++ : undefined;\n      return succeed({ conditions, index });\n    });\n  });\n}\n\n/**\n * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}\n * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name\n * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.\n *\n * @remarks\n * Accepts any string as the qualifier name. Use `typedValidatedConditionSetDecl` to layer\n * literal-string narrowing on top of the collector-membership check.\n *\n * @public\n */\nexport const validatedConditionSetDecl = Converters.generic<\n  IValidatedConditionSetDecl,\n  IConditionSetDeclConvertContext\n>((from: unknown, __self, context?: IConditionSetDeclConvertContext): Result<IValidatedConditionSetDecl> => {\n  return _validatedConditionSetDeclBody(conditionSetDecl, from, context);\n});\n\n/**\n * Returns a `Converter` for an `IValidatedConditionSetDecl` narrowed on a supplied\n * `qualifierName` converter.\n *\n * @public\n */\n// Shares the `_validatedConditionSetDeclBody` helper with\n// `validatedConditionSetDecl` above, so the body cannot drift; only the inner\n// condition-set-decl converter differs.\nexport function typedValidatedConditionSetDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext> {\n  const inner = typedConditionSetDecl(qualifierNameConverter);\n  return Converters.generic<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>(\n    (\n      from: unknown,\n      __self,\n      context?: IConditionSetDeclConvertContext\n    ): Result<IValidatedConditionSetDecl> => {\n      return _validatedConditionSetDeclBody(inner, from, context);\n    }\n  );\n}\n"]}

package/dist/packlets/conditions/convert/decls.js

@@ -24,6 +24,11 @@ import { Converters, populateObject, fail, succeed } from '@fgv/ts-utils';
 /* eslint-disable @rushstack/typedef-var */
 /**
  * Converter for a {@link Conditions.IConditionDecl | condition declaration}.
+ *
+ * @remarks
+ * Accepts any string as the `qualifierName`. Use `typedConditionDecl` to narrow the
+ * accepted set of qualifier names to a literal-string union.
+ *
  * @public
  */
 export const conditionDecl = Converters.strictObject({
@@ -34,17 +39,34 @@ export const conditionDecl = Converters.strictObject({
     scoreAsDefault: Converters.number.optional()
 });
 /**
- * Converter which constructs a {@link Conditions.IValidatedConditionDecl | validated condition declaration}
- * from a {@link Conditions.IConditionDecl | condition declaration}, instantiating qualifiers by name
- * from a supplied {@link Conditions.Convert.IConditionDeclConvertContext | conversion context}.
+ * Returns a `Converter` for an `IConditionDecl<TQualifierNames>` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * Pass e.g. `Converters.enumeratedValue(['tone', 'language'] as const)` to reject
+ * typo'd qualifier names at convert time and to narrow the resulting
+ * `IConditionDecl<T>` type to the same literal-string union. The default
+ * `conditionDecl` is the `Converters.string` instantiation of this shape.
+ *
  * @public
  */
-export const validatedConditionDecl = Converters.generic((from, __self, context) => {
+// Keep the field list below in sync with `conditionDecl` above; the
+// duplication preserves the `ObjectConverter` return type on the default.
+export function typedConditionDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        qualifierName: qualifierNameConverter,
+        value: Converters.string,
+        operator: Common.Convert.conditionOperator.optional(),
+        priority: Converters.number.optional(),
+        scoreAsDefault: Converters.number.optional()
+    });
+}
+function _validatedConditionDeclBody(innerConditionDecl, from, context) {
     /* c8 ignore next 3 - coverage is having a bad day */
     if (!context) {
         return fail('validatedConditionDecl converter requires a context');
     }
-    return conditionDecl.convert(from).onSuccess((decl) => {
+    return innerConditionDecl.convert(from).onSuccess((decl) => {
         var _a;
         const operator = (_a = decl.operator) !== null && _a !== void 0 ? _a : 'matches';
         return context.qualifiers.validating.get(decl.qualifierName).onSuccess((qualifier) => {
@@ -71,5 +93,39 @@ export const validatedConditionDecl = Converters.generic((from, __self, context)
                 .withDetail('success');
         });
     });
+}
+/**
+ * Converter which constructs a {@link Conditions.IValidatedConditionDecl | validated condition declaration}
+ * from a {@link Conditions.IConditionDecl | condition declaration}, instantiating qualifiers by name
+ * from a supplied {@link Conditions.Convert.IConditionDeclConvertContext | conversion context}.
+ *
+ * @remarks
+ * Accepts any string as the `qualifierName`; the collector membership check still rejects unknown
+ * names. Use `typedValidatedConditionDecl` to layer literal-string narrowing on top of the
+ * collector check.
+ *
+ * @public
+ */
+export const validatedConditionDecl = Converters.generic((from, __self, context) => {
+    return _validatedConditionDeclBody(conditionDecl, from, context);
 });
+/**
+ * Returns a `Converter` for an `IValidatedConditionDecl` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * The typed sibling layers literal-string narrowing on top of the existing
+ * collector-membership check performed by `validatedConditionDecl`.
+ *
+ * @public
+ */
+// Shares the `_validatedConditionDeclBody` helper with `validatedConditionDecl`
+// above, so the populate-object body cannot drift; only the inner condition-decl
+// converter differs.
+export function typedValidatedConditionDecl(qualifierNameConverter) {
+    const inner = typedConditionDecl(qualifierNameConverter);
+    return Converters.generic((from, __self, context) => {
+        return _validatedConditionDeclBody(inner, from, context);
+    });
+}
 //# sourceMappingURL=decls.js.map

package/dist/packlets/conditions/convert/decls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/decls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAa,UAAU,EAAE,cAAc,EAAU,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7F,2CAA2C;AAE3C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,CAAiB;IACnE,aAAa,EAAE,UAAU,CAAC,MAAM;IAChC,KAAK,EAAE,UAAU,CAAC,MAAM;IACxB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE;IACrD,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACtC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,oEAAoE;AACpE,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAChC,sBAAkD;IAElD,OAAO,UAAU,CAAC,YAAY,CAAkC;QAC9D,aAAa,EAAE,sBAAsB;QACrC,KAAK,EAAE,UAAU,CAAC,MAAM;QACxB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE;QACrD,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;QACtC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;KAC7C,CAAC,CAAC;AACL,CAAC;AAYD,SAAS,2BAA2B,CAClC,kBAA8D,EAC9D,IAAa,EACb,OAAsC;IAEtC,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;;QACzD,MAAM,QAAQ,GAAG,MAAA,IAAI,CAAC,QAAQ,mCAAI,SAAS,CAAC;QAC5C,OAAO,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACnF,OAAO,cAAc,CAA0B;gBAC7C,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;gBACnC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAC9D,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACjC,QAAQ,EAAE,GAAG,EAAE,CACb,IAAI,CAAC,QAAQ;oBACX,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;oBACzD,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC;gBACxC,cAAc,EAAE,GAAG,EAAE,CACnB,IAAI,CAAC,cAAc;oBACjB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC;oBACjE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;gBACxB,KAAK,EAAE,GAAG,EAAE,CACV,OAAO,CAAC,cAAc;oBACpB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;oBAC/D,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;aACzB,CAAC;iBACC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;gBACpB,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;oBACzC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC3B,CAAC;gBACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC,CAAC;iBACD,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,CAGtD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAsC,EAAmC,EAAE;IACnG,OAAO,2BAA2B,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,gFAAgF;AAChF,iFAAiF;AACjF,qBAAqB;AACrB,MAAM,UAAU,2BAA2B,CACzC,sBAAkD;IAElD,MAAM,KAAK,GAAG,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IACzD,OAAO,UAAU,CAAC,OAAO,CACvB,CAAC,IAAa,EAAE,MAAM,EAAE,OAAsC,EAAmC,EAAE;QACjG,OAAO,2BAA2B,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC,CACF,CAAC;AACJ,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Common from '../../common';\nimport { Converter, Converters, populateObject, Result, fail, succeed } from '@fgv/ts-utils';\nimport { IConditionDecl, IValidatedConditionDecl } from '../conditionDecls';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\n\n/* eslint-disable @rushstack/typedef-var */\n\n/**\n * Converter for a {@link Conditions.IConditionDecl | condition declaration}.\n *\n * @remarks\n * Accepts any string as the `qualifierName`. Use `typedConditionDecl` to narrow the\n * accepted set of qualifier names to a literal-string union.\n *\n * @public\n */\nexport const conditionDecl = Converters.strictObject<IConditionDecl>({\n  qualifierName: Converters.string,\n  value: Converters.string,\n  operator: Common.Convert.conditionOperator.optional(),\n  priority: Converters.number.optional(),\n  scoreAsDefault: Converters.number.optional()\n});\n\n/**\n * Returns a `Converter` for an `IConditionDecl<TQualifierNames>` narrowed on a supplied\n * `qualifierName` converter.\n *\n * @remarks\n * Pass e.g. `Converters.enumeratedValue(['tone', 'language'] as const)` to reject\n * typo'd qualifier names at convert time and to narrow the resulting\n * `IConditionDecl<T>` type to the same literal-string union. The default\n * `conditionDecl` is the `Converters.string` instantiation of this shape.\n *\n * @public\n */\n// Keep the field list below in sync with `conditionDecl` above; the\n// duplication preserves the `ObjectConverter` return type on the default.\nexport function typedConditionDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<IConditionDecl<TQualifierNames>> {\n  return Converters.strictObject<IConditionDecl<TQualifierNames>>({\n    qualifierName: qualifierNameConverter,\n    value: Converters.string,\n    operator: Common.Convert.conditionOperator.optional(),\n    priority: Converters.number.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n}\n\n/**\n * Conversion context to uses when converting\n * a {@link Conditions.IValidatedConditionDecl | validated condition declaration}.\n * @public\n */\nexport interface IConditionDeclConvertContext {\n  readonly qualifiers: IReadOnlyQualifierCollector;\n  conditionIndex?: number;\n}\n\nfunction _validatedConditionDeclBody<TQualifierNames extends string>(\n  innerConditionDecl: Converter<IConditionDecl<TQualifierNames>>,\n  from: unknown,\n  context?: IConditionDeclConvertContext\n): Result<IValidatedConditionDecl> {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!context) {\n    return fail('validatedConditionDecl converter requires a context');\n  }\n  return innerConditionDecl.convert(from).onSuccess((decl) => {\n    const operator = decl.operator ?? 'matches';\n    return context.qualifiers.validating.get(decl.qualifierName).onSuccess((qualifier) => {\n      return populateObject<IValidatedConditionDecl>({\n        qualifier: () => succeed(qualifier),\n        value: () => qualifier.validateCondition(decl.value, operator),\n        operator: () => succeed(operator),\n        priority: () =>\n          decl.priority\n            ? Common.Convert.conditionPriority.convert(decl.priority)\n            : succeed(qualifier.defaultPriority),\n        scoreAsDefault: () =>\n          decl.scoreAsDefault\n            ? Common.Convert.qualifierMatchScore.convert(decl.scoreAsDefault)\n            : succeed(undefined),\n        index: () =>\n          context.conditionIndex\n            ? Common.Convert.conditionIndex.convert(context.conditionIndex)\n            : succeed(undefined)\n      })\n        .onSuccess((result) => {\n          if (context.conditionIndex !== undefined) {\n            context.conditionIndex++;\n          }\n          return succeed(result);\n        })\n        .withDetail('success');\n    });\n  });\n}\n\n/**\n * Converter which constructs a {@link Conditions.IValidatedConditionDecl | validated condition declaration}\n * from a {@link Conditions.IConditionDecl | condition declaration}, instantiating qualifiers by name\n * from a supplied {@link Conditions.Convert.IConditionDeclConvertContext | conversion context}.\n *\n * @remarks\n * Accepts any string as the `qualifierName`; the collector membership check still rejects unknown\n * names. Use `typedValidatedConditionDecl` to layer literal-string narrowing on top of the\n * collector check.\n *\n * @public\n */\nexport const validatedConditionDecl = Converters.generic<\n  IValidatedConditionDecl,\n  IConditionDeclConvertContext\n>((from: unknown, __self, context?: IConditionDeclConvertContext): Result<IValidatedConditionDecl> => {\n  return _validatedConditionDeclBody(conditionDecl, from, context);\n});\n\n/**\n * Returns a `Converter` for an `IValidatedConditionDecl` narrowed on a supplied\n * `qualifierName` converter.\n *\n * @remarks\n * The typed sibling layers literal-string narrowing on top of the existing\n * collector-membership check performed by `validatedConditionDecl`.\n *\n * @public\n */\n// Shares the `_validatedConditionDeclBody` helper with `validatedConditionDecl`\n// above, so the populate-object body cannot drift; only the inner condition-decl\n// converter differs.\nexport function typedValidatedConditionDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<IValidatedConditionDecl, IConditionDeclConvertContext> {\n  const inner = typedConditionDecl(qualifierNameConverter);\n  return Converters.generic<IValidatedConditionDecl, IConditionDeclConvertContext>(\n    (from: unknown, __self, context?: IConditionDeclConvertContext): Result<IValidatedConditionDecl> => {\n      return _validatedConditionDeclBody(inner, from, context);\n    }\n  );\n}\n"]}

package/dist/packlets/conditions/convert/index.js.map

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

package/dist/packlets/conditions/index.js.map

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

package/dist/packlets/config/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/config/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAU,IAAI,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,mBAAmB,EAEnB,+CAA+C,EAChD,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAYhD;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAiD;IAC7F,SAAS;IACT,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;CACnB,CAAC;AAEF,cAAc,cAAc,CAAC;AAE7B,MAAM,eAAe,GAAgE;IACnF,OAAO,EAAE,OAAO,CAAC,0BAA0B;IAC3C,mBAAmB,EAAE,OAAO,CAAC,mCAAmC;IAChE,oBAAoB,EAAE,OAAO,CAAC,oCAAoC;IAClE,kBAAkB,EAAE,OAAO,CAAC,2BAA2B;CACxD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAmC,EACnC,UAA2C;IAE3C,IAAI,IAAI,IAAI,eAAe,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,sBAAsB,EAAE,CAAC;YACvC,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CACrC,+CAA+C,CAAC,MAAM,EAAE,UAAU,CAAC,sBAAuB,CAAC,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,yCAAyC;IACzC,OAAO,IAAI,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAAmC,EACnC,UAA2C;IAE3C,IAAI,IAAI,IAAI,eAAe,EAAE,CAAC;QAC5B,OAAO,mBAAmB,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,IAAI,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, fail } from '@fgv/ts-utils';\nimport { ISystemConfiguration } from './json';\nimport {\n  SystemConfiguration,\n  ISystemConfigurationInitParams,\n  updateSystemConfigurationQualifierDefaultValues\n} from './systemConfiguration';\nimport { sanitizeJsonObject } from '@fgv/ts-json-base';\nimport { Default, Example } from './predefined';\n\n/**\n * A `string` literal type representing a well-known predefined system configuration.\n * @public\n */\nexport type PredefinedSystemConfiguration =\n  | 'default'\n  | 'language-priority'\n  | 'territory-priority'\n  | 'extended-example';\n\n/**\n * An array of all well-known predefined system configurations.\n * @public\n */\nexport const allPredefinedSystemConfigurations: ReadonlyArray<PredefinedSystemConfiguration> = [\n  'default',\n  'language-priority',\n  'territory-priority',\n  'extended-example'\n];\n\nexport * from './predefined';\n\nconst predefinedDecls: Record<PredefinedSystemConfiguration, ISystemConfiguration> = {\n  default: Default.DefaultSystemConfiguration,\n  'language-priority': Default.LanguagePrioritySystemConfiguration,\n  'territory-priority': Default.TerritoryPrioritySystemConfiguration,\n  'extended-example': Example.ExtendedSystemConfiguration\n};\n\n/**\n * Returns the {@link Config.Model.ISystemConfiguration | system configuration} declaration for the\n * specified predefined system configuration.\n * @param name - The name of the predefined system configuration.\n * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.\n * @returns `Success` with the {@link Config.Model.ISystemConfiguration | system configuration}\n * declaration if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function getPredefinedDeclaration(\n  name: PredefinedSystemConfiguration,\n  initParams?: ISystemConfigurationInitParams\n): Result<ISystemConfiguration> {\n  if (name in predefinedDecls) {\n    const baseConfig = sanitizeJsonObject(predefinedDecls[name]);\n    if (initParams?.qualifierDefaultValues) {\n      return baseConfig.onSuccess((config) =>\n        updateSystemConfigurationQualifierDefaultValues(config, initParams.qualifierDefaultValues!)\n      );\n    }\n    return baseConfig;\n  }\n  /* c8 ignore next 3 - defense in depth */\n  return fail(`Unknown predefined system configuration: ${name}`);\n}\n\n/**\n * Returns the {@link Config.SystemConfiguration | SystemConfiguration} for the specified\n * predefined system configuration.\n * @param name - The name of the predefined system configuration.\n * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.\n * @returns `Success` with the {@link Config.SystemConfiguration | SystemConfiguration}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function getPredefinedSystemConfiguration(\n  name: PredefinedSystemConfiguration,\n  initParams?: ISystemConfigurationInitParams\n): Result<SystemConfiguration> {\n  if (name in predefinedDecls) {\n    return SystemConfiguration.create(predefinedDecls[name], initParams);\n  }\n\n  return fail(`Unknown predefined system configuration: ${name}`);\n}\n"]}

package/dist/packlets/config/configInitFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configInitFactory.js","sourceRoot":"","sources":["../../../src/packlets/config/configInitFactory.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, fail } from '@fgv/ts-utils';\nimport { QualifierType, SystemQualifierType } from '../qualifier-types';\nimport * as QualifierTypes from '../qualifier-types';\nimport * as ResourceTypes from '../resource-types';\nimport { ResourceType } from '../resource-types';\n\n/**\n * Function signature for creating a qualifier type from configuration.\n * @public\n */\nexport type QualifierTypeFactoryFunction<T extends QualifierType = QualifierType> = (\n  config: QualifierTypes.Config.IAnyQualifierTypeConfig\n) => Result<T>;\n\n/**\n * Function signature for creating a resource type from configuration.\n * @public\n */\nexport type ResourceTypeFactoryFunction = (\n  config: ResourceTypes.Config.IResourceTypeConfig\n) => Result<ResourceType>;\n\n/**\n * Interface for a factory that creates a new instance of a configuration object.\n * @public\n */\nexport interface IConfigInitFactory<TConfig, T> {\n  /**\n   * Creates a new instance of a configuration object.\n   * @param config - The configuration object to create.\n   * @returns A result containing the new instance of the configuration object.\n   */\n  create(config: TConfig): Result<T>;\n}\n\n/**\n * Creates a {@link Config.IConfigInitFactory | IConfigInitFactory} from a factory function.\n * @param fn - The factory function to wrap.\n * @returns An `IConfigInitFactory` instance that delegates to the function.\n * @public\n */\nexport function createQualifierTypeFactory<T extends QualifierType = QualifierType>(\n  fn: QualifierTypeFactoryFunction<T>\n): IConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, T> {\n  return {\n    create: fn\n  };\n}\n\n/**\n * Creates a {@link Config.IConfigInitFactory | IConfigInitFactory} from a resource type factory function.\n * @param fn - The factory function to wrap.\n * @returns An `IConfigInitFactory` instance that delegates to the function.\n * @public\n */\nexport function createResourceTypeFactory(\n  fn: ResourceTypeFactoryFunction\n): IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceType> {\n  return {\n    create: fn\n  };\n}\n\n/**\n * A factory that chains multiple factories together.\n * @public\n */\nexport class ChainedConfigInitFactory<TConfig, T> implements IConfigInitFactory<TConfig, T> {\n  public readonly factories: IConfigInitFactory<TConfig, T>[];\n\n  /**\n   * Constructor for a chained config init factory.\n   * @param factories - The factories to chain.\n   */\n  public constructor(factories: IConfigInitFactory<TConfig, T>[]) {\n    this.factories = factories;\n  }\n\n  /**\n   * Creates a new instance of a configuration object.\n   * @param config - The configuration object to create.\n   * @returns A result containing the new instance of the configuration object.\n   */\n  public create(config: TConfig): Result<T> {\n    for (const factory of this.factories) {\n      const result = factory.create(config);\n      if (result.isSuccess()) {\n        return result;\n      }\n    }\n    return fail('No factory was able to create the configuration object');\n  }\n}\n\n/**\n * A factory that creates a {@link QualifierTypes.SystemQualifierType | SystemQualifierType} from\n * {@link QualifierTypes.Config.IAnyQualifierTypeConfig | any qualifier type configuration}.\n * @returns `Success` with the new {@link QualifierTypes.SystemQualifierType | SystemQualifierType}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport class BuiltInQualifierTypeFactory\n  implements IConfigInitFactory<QualifierTypes.Config.ISystemQualifierTypeConfig, SystemQualifierType>\n{\n  /** {@inheritDoc Config.IConfigInitFactory.create} */\n  public create(config: QualifierTypes.Config.IAnyQualifierTypeConfig): Result<SystemQualifierType> {\n    if (QualifierTypes.Config.isSystemQualifierTypeConfig(config)) {\n      return QualifierTypes.createQualifierTypeFromSystemConfig(config);\n    }\n    /* c8 ignore next 2 - functional code tested but coverage intermittently missed */\n    return fail(`${config.name}: unknown built-in qualifier type (${config.systemType})`);\n  }\n}\n\n/**\n * A factory that creates {@link QualifierTypes.QualifierType | QualifierType} instances from configuration,\n * supporting both built-in system types and custom external types.\n *\n * This factory allows external consumers to extend the qualifier type system with their own custom types\n * while maintaining support for all built-in types (Language, Territory, Literal).\n *\n * @typeParam T - The custom qualifier type(s) to support. Defaults to {@link QualifierTypes.SystemQualifierType | SystemQualifierType}.\n *\n * @example Creating a factory with custom qualifier types\n * ```typescript\n * // Define a custom qualifier type\n * class CustomQualifierType extends QualifierType {\n *   // ... implementation\n * }\n *\n * // Define a discriminated union of all types\n * type AppQualifierType = SystemQualifierType | CustomQualifierType;\n *\n * // Create a factory that handles custom types\n * const customFactory: IConfigInitFactory<IAnyQualifierTypeConfig, CustomQualifierType> = {\n *   create(config) {\n *     // ... handle custom type creation\n *   }\n * };\n *\n * // Create the combined factory\n * const qualifierTypeFactory = new QualifierTypeFactory<AppQualifierType>([customFactory]);\n *\n * // The factory returns T | SystemQualifierType, supporting all types\n * const result = qualifierTypeFactory.create(config); // Result<AppQualifierType | SystemQualifierType>\n * ```\n *\n * @remarks\n * - The factory chains custom factories with the built-in factory\n * - Custom factories are tried first, falling back to built-in types\n * - The return type is a union of custom types (T) and system types\n *\n * @public\n */\nexport class QualifierTypeFactory<\n  T extends QualifierType = SystemQualifierType\n> extends ChainedConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, T | SystemQualifierType> {\n  /**\n   * Constructor for a {@link Config.QualifierTypeFactory | qualifier type factory}.\n   * @param factories - Array of factories for custom qualifier types. Can be:\n   *                    - {@link Config.IConfigInitFactory | IConfigInitFactory} instances\n   *                    - {@link Config.QualifierTypeFactoryFunction | Factory functions}\n   *                    - A mix of both\n   *                    These are tried in order before falling back to built-in types.\n   * @remarks The {@link Config.BuiltInQualifierTypeFactory | built-in factory} is always appended to handle\n   *          system qualifier types (Language, Territory, Literal).\n   */\n  public constructor(\n    factories: Array<\n      IConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, T> | QualifierTypeFactoryFunction<T>\n    >\n  ) {\n    const normalizedFactories = factories.map((f) =>\n      typeof f === 'function' ? createQualifierTypeFactory(f) : f\n    );\n    super([...normalizedFactories, new BuiltInQualifierTypeFactory()]);\n  }\n}\n\n/**\n * A factory that validates and creates {@link QualifierTypes.QualifierType | QualifierType} instances\n * from weakly-typed configuration objects. This factory accepts configurations with unvalidated\n * string properties and validates them before delegating to the underlying factory chain.\n *\n * This pattern is useful at package boundaries where type identity issues may occur with\n * branded types across different package instances.\n *\n * @example\n * ```typescript\n * // Accept weakly-typed config from external source\n * const validatingFactory = new ValidatingQualifierTypeFactory([customFactory]);\n *\n * // Config can have plain string types instead of branded types\n * const config = {\n *   name: 'my-qualifier',  // plain string, not QualifierTypeName\n *   systemType: 'custom',   // plain string\n *   configuration: { ... }\n * };\n *\n * const result = validatingFactory.create(config); // Validates and converts internally\n * ```\n *\n * @public\n */\nexport class ValidatingQualifierTypeFactory<T extends QualifierType = SystemQualifierType>\n  implements IConfigInitFactory<unknown, T | SystemQualifierType>\n{\n  private readonly _innerFactory: QualifierTypeFactory<T>;\n\n  /**\n   * Constructor for a validating qualifier type factory.\n   * @param factories - Array of factories for custom qualifier types. Can be:\n   *                    - {@link Config.IConfigInitFactory | IConfigInitFactory} instances\n   *                    - {@link Config.QualifierTypeFactoryFunction | Factory functions}\n   *                    - A mix of both\n   */\n  public constructor(\n    factories: Array<\n      IConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, T> | QualifierTypeFactoryFunction<T>\n    >\n  ) {\n    this._innerFactory = new QualifierTypeFactory(factories);\n  }\n\n  /**\n   * Creates a qualifier type from a weakly-typed configuration object.\n   * @param config - The configuration object to validate and use for creation.\n   * @returns A result containing the new qualifier type if successful.\n   */\n  public create(config: unknown): Result<T | SystemQualifierType> {\n    return QualifierTypes.Config.Convert.anyQualifierTypeConfig\n      .convert(config)\n      .onSuccess((validatedConfig) => {\n        return this._innerFactory.create(validatedConfig);\n      });\n  }\n}\n\n/**\n * A factory that creates a {@link ResourceTypes.ResourceType | ResourceType} from a {@link ResourceTypes.Config.IResourceTypeConfig | resource type configuration}.\n * @public\n */\nexport class BuiltInResourceTypeFactory\n  implements IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceType>\n{\n  /** {@inheritDoc Config.IConfigInitFactory.create} */\n  public create(config: ResourceTypes.Config.IResourceTypeConfig): Result<ResourceType> {\n    return ResourceTypes.createResourceTypeFromConfig(config);\n  }\n}\n\n/**\n * A factory that creates a {@link ResourceTypes.ResourceType | ResourceType} from a {@link ResourceTypes.Config.IResourceTypeConfig | resource type configuration}\n * by chaining a supplied factory with a {@link Config.BuiltInResourceTypeFactory | built-in factory} that handles built-in resource types.\n * @public\n */\nexport class ResourceTypeFactory extends ChainedConfigInitFactory<\n  ResourceTypes.Config.IResourceTypeConfig,\n  ResourceType\n> {\n  /**\n   * Constructor for a resource type factory.\n   * @param factories - Array of factories for resource types. Can be:\n   *                    - {@link Config.IConfigInitFactory | IConfigInitFactory} instances\n   *                    - {@link Config.ResourceTypeFactoryFunction | Factory functions}\n   *                    - A mix of both\n   * @remarks The {@link Config.BuiltInResourceTypeFactory | built-in factory} is always added to the end of the chain.\n   */\n  public constructor(\n    factories: Array<\n      IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceType> | ResourceTypeFactoryFunction\n    >\n  ) {\n    factories = factories ?? [];\n    const normalizedFactories = factories.map((f) =>\n      typeof f === 'function' ? createResourceTypeFactory(f) : f\n    );\n    super([...normalizedFactories, new BuiltInResourceTypeFactory()]);\n  }\n}\n\n/**\n * A factory that validates and creates {@link ResourceTypes.ResourceType | ResourceType} instances\n * from weakly-typed configuration objects. This factory accepts configurations with unvalidated\n * string properties and validates them before delegating to the underlying factory chain.\n *\n * This pattern is useful at package boundaries where type identity issues may occur with\n * branded types across different package instances.\n *\n * @public\n */\nexport class ValidatingResourceTypeFactory implements IConfigInitFactory<unknown, ResourceType> {\n  private readonly _innerFactory: ResourceTypeFactory;\n\n  /**\n   * Constructor for a validating resource type factory.\n   * @param factories - Array of factories for resource types. Can be:\n   *                    - {@link Config.IConfigInitFactory | IConfigInitFactory} instances\n   *                    - {@link Config.ResourceTypeFactoryFunction | Factory functions}\n   *                    - A mix of both\n   */\n  public constructor(\n    factories: Array<\n      IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceType> | ResourceTypeFactoryFunction\n    >\n  ) {\n    this._innerFactory = new ResourceTypeFactory(factories);\n  }\n\n  /**\n   * Creates a resource type from a weakly-typed configuration object.\n   * @param config - The configuration object to validate and use for creation.\n   * @returns A result containing the new resource type if successful.\n   */\n  public create(config: unknown): Result<ResourceType> {\n    return ResourceTypes.Config.Convert.resourceTypeConfig.convert(config).onSuccess((validatedConfig) => {\n      return this._innerFactory.create(validatedConfig);\n    });\n  }\n}\n"]}

package/dist/packlets/config/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/config/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,2CAA2C;AAE3C,OAAO,EAAE,UAAU,EAAU,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,cAAc,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,aAAa,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC,YAAY,CAAuB;IAC/E,IAAI,EAAE,UAAU,CAAC,cAAc;IAC/B,WAAW,EAAE,UAAU,CAAC,cAAc;IACtC,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACxF,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC;IAChE,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC;CACnF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC,eAAe,CAAC,iCAAiC,CAAC,CAAC;AAE3G;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAe;IACzD,OAAO,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/* eslint-disable @rushstack/typedef-var */\n\nimport { Converters, Result } from '@fgv/ts-utils';\nimport { ISystemConfiguration } from './json';\nimport * as QualifierTypes from '../qualifier-types';\nimport * as Qualifiers from '../qualifiers';\nimport * as ResourceTypes from '../resource-types';\nimport { allPredefinedSystemConfigurations } from './common';\n\n/**\n * A `Converter` for {@link Config.Model.ISystemConfiguration | ISystemConfiguration} objects.\n * @returns A `Converter` for {@link Config.Model.ISystemConfiguration | ISystemConfiguration} objects.\n * @public\n */\nexport const systemConfiguration = Converters.strictObject<ISystemConfiguration>({\n  name: Converters.optionalString,\n  description: Converters.optionalString,\n  qualifierTypes: Converters.arrayOf(QualifierTypes.Config.Convert.anyQualifierTypeConfig),\n  qualifiers: Converters.arrayOf(Qualifiers.Convert.qualifierDecl),\n  resourceTypes: Converters.arrayOf(ResourceTypes.Config.Convert.resourceTypeConfig)\n});\n\n/**\n * A `Converter` for {@link Config.PredefinedSystemConfiguration | PredefinedSystemConfiguration} values.\n * @returns A `Converter` for {@link Config.PredefinedSystemConfiguration | PredefinedSystemConfiguration} values.\n * @public\n */\nexport const predefinedSystemConfiguration = Converters.enumeratedValue(allPredefinedSystemConfigurations);\n\n/**\n * Validate a {@link Config.Model.ISystemConfiguration | ISystemConfiguration} object.\n * @param config - The system configuration to validate\n * @returns `Success` with the validated system configuration if successful,\n * or `Failure` with an error message if validation fails.\n * @public\n */\nexport function validateSystemConfiguration(config: unknown): Result<ISystemConfiguration> {\n  return systemConfiguration.convert(config);\n}\n"]}

package/dist/packlets/config/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../../src/packlets/config/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,yEAAyE;AAEzE,OAAO,KAAK,KAAK,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AAEzB,wFAAwF;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,oBAAoB;AACpB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAE1B,yBAAyB;AACzB,iFAAiF","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n// Browser-safe config exports - excludes Node.js filesystem dependencies\n\nimport * as Model from './json';\nimport * as Convert from './convert';\n\n// Export all modules\nexport * from './configInitFactory';\nexport * from './common';\n\n// Export SystemConfiguration class but not as wildcard to avoid pulling in loadFromFile\nexport { SystemConfiguration } from './systemConfiguration';\n\n// Export namespaces\nexport { Model, Convert };\n\n// Excluded from browser:\n// - SystemConfiguration.loadFromFile() method (requires Node.js fs via JsonFile)\n"]}

package/dist/packlets/config/index.js.map

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

package/dist/packlets/config/json.js.map

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

package/dist/packlets/config/predefined/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../src/packlets/config/predefined/default.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoE;IACpG;QACE,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,UAAU;QACtB,aAAa,EAAE;YACb,gBAAgB,EAAE,IAAI;SACvB;KACF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,WAAW;QACvB,aAAa,EAAE;YACb,gBAAgB,EAAE,KAAK;SACxB;KACF;CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA6C;IACnF;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,WAAW;QACrB,eAAe,EAAE,GAAG;KACrB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,GAAG;KACrB;CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA6C;IAClF;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,UAAU;QACpB,eAAe,EAAE,GAAG;KACrB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,WAAW;QACrB,eAAe,EAAE,GAAG;KACrB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA4D;IAC3F;QACE,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,MAAM;KACjB;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAyB;IACxE,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,yCAAyC;IACtD,cAAc,EAAE,CAAC,GAAG,qBAAqB,CAAC;IAC1C,UAAU,EAAE,CAAC,GAAG,2BAA2B,CAAC;IAC5C,aAAa,EAAE,CAAC,GAAG,oBAAoB,CAAC;CACzC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAyB;IACvE,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,wCAAwC;IACrD,cAAc,EAAE,CAAC,GAAG,qBAAqB,CAAC;IAC1C,UAAU,EAAE,CAAC,GAAG,0BAA0B,CAAC;IAC3C,aAAa,EAAE,CAAC,GAAG,oBAAoB,CAAC;CACzC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAyB;IAC9D,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,8BAA8B;IAC3C,cAAc,EAAE,CAAC,GAAG,qBAAqB,CAAC;IAC1C,UAAU,EAAE,CAAC,GAAG,2BAA2B,CAAC;IAC5C,aAAa,EAAE,CAAC,GAAG,oBAAoB,CAAC;CACzC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { ISystemConfiguration } from '../json';\n\nimport * as QualifierTypes from '../../qualifier-types';\nimport * as Qualifiers from '../../qualifiers';\nimport * as ResourceTypes from '../../resource-types';\n\n/**\n * Default qualifier types.\n * @remarks\n * The default qualifier types are:\n * - language: recognizes BCP 47 language tags, accepts a comma-separated list of language tags in the context\n * - territory: recognizes ISO 3166-1 alpha-2 territory codes, accepts a single code in the context\n * @public\n */\nexport const DefaultQualifierTypes: ReadonlyArray<QualifierTypes.Config.ISystemQualifierTypeConfig> = [\n  {\n    name: 'language',\n    systemType: 'language',\n    configuration: {\n      allowContextList: true\n    }\n  },\n  {\n    name: 'territory',\n    systemType: 'territory',\n    configuration: {\n      allowContextList: false\n    }\n  }\n];\n\n/**\n * Qualifier definitions in which territory is the primary qualifier, with\n * language as a secondary qualifier.\n * @remarks\n * The default qualifiers are:\n * - currentTerritory(token: geo): territory qualifier, priority 850\n * - language(token: lang): language qualifier, priority 800\n * @public\n */\nexport const TerritoryPriorityQualifiers: ReadonlyArray<Qualifiers.IQualifierDecl> = [\n  {\n    name: 'currentTerritory',\n    token: 'geo',\n    typeName: 'territory',\n    defaultPriority: 850\n  },\n  {\n    name: 'language',\n    token: 'lang',\n    typeName: 'language',\n    defaultPriority: 800\n  }\n];\n\n/**\n * Qualifier definitions in which language is the primary qualifier, with\n * territory as a secondary qualifier.\n * @remarks\n * The default qualifiers are:\n * - language(token: lang): language qualifier, priority 850\n * - currentTerritory(token: geo): territory qualifier, priority 800\n * @public\n */\nexport const LanguagePriorityQualifiers: ReadonlyArray<Qualifiers.IQualifierDecl> = [\n  {\n    name: 'language',\n    token: 'lang',\n    typeName: 'language',\n    defaultPriority: 850\n  },\n  {\n    name: 'currentTerritory',\n    token: 'geo',\n    typeName: 'territory',\n    defaultPriority: 800\n  }\n];\n\n/**\n * Default resource types.\n * @public\n */\nexport const DefaultResourceTypes: ReadonlyArray<ResourceTypes.Config.IResourceTypeConfig> = [\n  {\n    name: 'json',\n    typeName: 'json'\n  }\n];\n\n/**\n * System configuration with territory as the primary qualifier, and\n * language as a secondary qualifier.\n * @public\n */\nexport const TerritoryPrioritySystemConfiguration: ISystemConfiguration = {\n  name: 'territory-priority',\n  description: 'Territory priority system configuration',\n  qualifierTypes: [...DefaultQualifierTypes],\n  qualifiers: [...TerritoryPriorityQualifiers],\n  resourceTypes: [...DefaultResourceTypes]\n};\n\n/**\n * System configuration with language as the primary qualifier, and\n * territory as a secondary qualifier.\n * @public\n */\nexport const LanguagePrioritySystemConfiguration: ISystemConfiguration = {\n  name: 'language-priority',\n  description: 'Language priority system configuration',\n  qualifierTypes: [...DefaultQualifierTypes],\n  qualifiers: [...LanguagePriorityQualifiers],\n  resourceTypes: [...DefaultResourceTypes]\n};\n\n/**\n * The default system configuration gives priority to territory as the primary qualifier,\n * with language as a secondary qualifier.\n * @public\n */\nexport const DefaultSystemConfiguration: ISystemConfiguration = {\n  name: 'default',\n  description: 'Default system configuration',\n  qualifierTypes: [...DefaultQualifierTypes],\n  qualifiers: [...TerritoryPriorityQualifiers],\n  resourceTypes: [...DefaultResourceTypes]\n};\n"]}

package/dist/packlets/config/predefined/extended.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended.js","sourceRoot":"","sources":["../../../../src/packlets/config/predefined/extended.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 * as ResourceTypes from '../../resource-types';\nimport * as QualifierTypes from '../../qualifier-types';\nimport * as Qualifiers from '../../qualifiers';\nimport { ISystemConfiguration } from '../json';\n\n/**\n * Example extended qualifier types.\n * @public\n */\nexport const ExtendedQualifierTypes: ReadonlyArray<QualifierTypes.Config.ISystemQualifierTypeConfig> = [\n  {\n    name: 'language',\n    systemType: 'language',\n    configuration: {\n      allowContextList: true\n    }\n  },\n  {\n    name: 'territory',\n    systemType: 'territory',\n    configuration: {\n      allowContextList: false,\n      acceptLowercase: false\n    }\n  },\n  {\n    name: 'role',\n    systemType: 'literal',\n    configuration: {\n      enumeratedValues: ['admin', 'agent', 'user', 'guest']\n    }\n  },\n  {\n    name: 'environment',\n    systemType: 'literal',\n    configuration: {\n      enumeratedValues: ['production', 'integration', 'development', 'test', 'ephemeral']\n    }\n  },\n  {\n    name: 'currency',\n    systemType: 'literal',\n    configuration: {\n      caseSensitive: true,\n      enumeratedValues: ['USD', 'EUR', 'GBP', 'JPY', 'CNY']\n    }\n  },\n  {\n    name: 'market',\n    systemType: 'literal',\n    configuration: {\n      enumeratedValues: [\n        'world',\n        'americas',\n        'europe',\n        'asia',\n        'oceania',\n        'africa',\n        'middle-east',\n        'latin-america',\n        'caribbean',\n        'central-america',\n        'south-america',\n        'north-america',\n        'nordics',\n        'baltic',\n        'balkans',\n        'eastern-europe',\n        'western-europe',\n        'central-europe',\n        'eastern-africa',\n        'western-africa',\n        'central-africa',\n        'north-africa',\n        'south-africa',\n        'middle-africa',\n        'southeast-asia'\n      ],\n      hierarchy: {\n        americas: 'world',\n        europe: 'world',\n        asia: 'world',\n        oceania: 'world',\n        africa: 'world',\n        'middle-east': 'world',\n        'latin-america': 'americas',\n        caribbean: 'americas',\n        'central-america': 'americas',\n        'south-america': 'americas',\n        'north-america': 'americas',\n        nordics: 'europe',\n        baltic: 'europe',\n        balkans: 'europe',\n        'eastern-europe': 'europe',\n        'western-europe': 'europe',\n        'central-europe': 'europe',\n        'eastern-africa': 'africa',\n        'western-africa': 'africa',\n        'central-africa': 'africa',\n        'north-africa': 'africa',\n        'south-africa': 'africa',\n        'middle-africa': 'africa',\n        'southeast-asia': 'asia'\n      }\n    }\n  }\n];\n\n/**\n * Example extended qualifiers.\n * @public\n */\nexport const ExtendedQualifiers: ReadonlyArray<Qualifiers.IQualifierDecl> = [\n  {\n    name: 'homeTerritory',\n    token: 'home',\n    typeName: 'territory',\n    defaultPriority: 900\n  },\n  {\n    name: 'currentTerritory',\n    token: 'geo',\n    typeName: 'territory',\n    defaultPriority: 850\n  },\n  {\n    name: 'language',\n    token: 'lang',\n    typeName: 'language',\n    defaultPriority: 800\n  },\n  {\n    name: 'market',\n    typeName: 'market',\n    defaultPriority: 750\n  },\n  {\n    name: 'role',\n    typeName: 'role',\n    defaultPriority: 700\n  },\n  {\n    name: 'environment',\n    token: 'env',\n    typeName: 'environment',\n    defaultPriority: 650\n  },\n  {\n    name: 'currency',\n    typeName: 'currency',\n    defaultPriority: 600\n  }\n];\n\n/**\n * Example resource types.\n * @public\n */\nexport const ExtendedResourceTypes: ReadonlyArray<ResourceTypes.Config.IResourceTypeConfig> = [\n  {\n    name: 'json',\n    typeName: 'json'\n  }\n];\n\n/**\n * An example system configuration demonstrating various configuration options.\n * @public\n */\nexport const ExtendedSystemConfiguration: ISystemConfiguration = {\n  name: 'extended-example',\n  description: 'An example system configuration demonstrating various configuration options',\n  qualifierTypes: [...ExtendedQualifierTypes],\n  qualifiers: [...ExtendedQualifiers],\n  resourceTypes: [...ExtendedResourceTypes]\n};\n"]}

package/dist/packlets/config/predefined/index.js.map

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

package/dist/packlets/config/systemConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemConfiguration.js","sourceRoot":"","sources":["../../../src/packlets/config/systemConfiguration.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 { captureResult, mapResults, Result, fail, succeed, omit } from '@fgv/ts-utils';\nimport * as QualifierTypes from '../qualifier-types';\nimport * as ResourceTypes from '../resource-types';\nimport { QualifierType, QualifierTypeCollector, ReadOnlyQualifierTypeCollector } from '../qualifier-types';\nimport { IReadOnlyQualifierCollector, QualifierCollector } from '../qualifiers';\nimport { ReadOnlyResourceTypeCollector, ResourceType, ResourceTypeCollector } from '../resource-types';\nimport { ISystemConfiguration } from './json';\nimport { systemConfiguration } from './convert';\nimport { JsonFile, sanitizeJsonObject } from '@fgv/ts-json-base';\nimport {\n  BuiltInQualifierTypeFactory,\n  BuiltInResourceTypeFactory,\n  IConfigInitFactory\n} from './configInitFactory';\n\n/**\n * Parameters used to initialize a {@link Config.SystemConfiguration | SystemConfiguration}.\n * @public\n */\nexport interface ISystemConfigurationInitParams {\n  /**\n   * Optional map of qualifier names to default values. If provided, qualifiers\n   * in the system configuration will be updated with these default values.\n   * Use `null` as the value to remove an existing default value.\n   */\n  qualifierDefaultValues?: Record<string, string | null>; // eslint-disable-line @rushstack/no-new-null\n  qualifierTypeFactory?: IConfigInitFactory<QualifierTypes.Config.IAnyQualifierTypeConfig, QualifierType>;\n  resourceTypeFactory?: IConfigInitFactory<ResourceTypes.Config.IResourceTypeConfig, ResourceType>;\n}\n\n/**\n * Creates a copy of the provided {@link Config.Model.ISystemConfiguration | system configuration}\n * with updated qualifier default values.\n * @param config - The base {@link Config.Model.ISystemConfiguration | system configuration} to copy.\n * @param qualifierDefaultValues - Map of qualifier names to default values. Use `null` to remove existing values.\n * @returns `Success` with the updated {@link Config.Model.ISystemConfiguration | system configuration}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function updateSystemConfigurationQualifierDefaultValues(\n  config: ISystemConfiguration,\n  qualifierDefaultValues: Record<string, string | null> // eslint-disable-line @rushstack/no-new-null\n): Result<ISystemConfiguration> {\n  // Create a copy of the config\n  return sanitizeJsonObject<ISystemConfiguration>(config).onSuccess((updatedConfig) => {\n    // Create a map of existing qualifier names for validation\n    const existingQualifierNames = new Set(updatedConfig.qualifiers.map((q) => q.name));\n\n    // Validate that all specified qualifiers exist in the configuration\n    for (const qualifierName of Object.keys(qualifierDefaultValues)) {\n      if (!existingQualifierNames.has(qualifierName)) {\n        return fail(`Qualifier '${qualifierName}' not found in system configuration`);\n      }\n    }\n\n    // Update qualifier default values\n    updatedConfig.qualifiers = updatedConfig.qualifiers.map((qualifier) => {\n      if (qualifier.name in qualifierDefaultValues) {\n        const newDefaultValue = qualifierDefaultValues[qualifier.name];\n\n        // Create a copy of the qualifier\n        const updatedQualifier = { ...qualifier };\n\n        if (newDefaultValue === null) {\n          // Remove the default value\n          delete updatedQualifier.defaultValue;\n        } else {\n          // Set the new default value\n          updatedQualifier.defaultValue = newDefaultValue;\n        }\n\n        return updatedQualifier;\n      }\n      return qualifier;\n    });\n\n    return succeed(updatedConfig);\n  });\n}\n\n/**\n * A system configuration for both runtime or build.\n * @public\n */\nexport class SystemConfiguration {\n  /**\n   * The name of this system configuration.\n   */\n  public get name(): string | undefined {\n    return this._config.name;\n  }\n\n  /**\n   * The description of this system configuration.\n   */\n  public get description(): string | undefined {\n    return this._config.description;\n  }\n\n  /**\n   * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this system configuration uses.\n   */\n  public readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this system configuration uses.\n   * @public\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The {@link ResourceTypes.ResourceTypeCollector | resource types} that this system configuration uses.\n   */\n  public readonly resourceTypes: ReadOnlyResourceTypeCollector;\n\n  private readonly _config: ISystemConfiguration;\n\n  /**\n   * Constructs a new instance of a {@link Config.SystemConfiguration | SystemConfiguration} from the\n   * supplied {@link Config.Model.ISystemConfiguration | system configuration}.\n   * @param config - The {@link Config.Model.ISystemConfiguration | system configuration} to use.\n   * @public\n   */\n  protected constructor(config: ISystemConfiguration, initParams?: ISystemConfigurationInitParams) {\n    this._config = config;\n    const qualifierTypeFactory = initParams?.qualifierTypeFactory ?? new BuiltInQualifierTypeFactory();\n    const resourceTypeFactory = initParams?.resourceTypeFactory ?? new BuiltInResourceTypeFactory();\n\n    this.qualifierTypes = QualifierTypeCollector.create({\n      qualifierTypes: mapResults(config.qualifierTypes.map((tc) => qualifierTypeFactory.create(tc))).orThrow()\n    }).orThrow();\n\n    this.qualifiers = QualifierCollector.create({\n      qualifierTypes: this.qualifierTypes,\n      qualifiers: config.qualifiers\n    }).orThrow();\n\n    this.resourceTypes = ResourceTypeCollector.create({\n      resourceTypes: mapResults(config.resourceTypes.map((rt) => resourceTypeFactory.create(rt))).orThrow()\n    }).orThrow();\n  }\n\n  /**\n   * Creates a new {@link Config.SystemConfiguration | SystemConfiguration} from the supplied\n   * {@link Config.Model.ISystemConfiguration | system configuration}.\n   * @param config - The {@link Config.Model.ISystemConfiguration | system configuration} to use.\n   * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.\n   * @returns `Success` with the new {@link Config.SystemConfiguration | SystemConfiguration}\n   * if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public static create(\n    config: ISystemConfiguration,\n    initParams?: ISystemConfigurationInitParams\n  ): Result<SystemConfiguration> {\n    if (initParams?.qualifierDefaultValues) {\n      /* c8 ignore next 9 - functional code tested but coverage intermittently missed */\n      return updateSystemConfigurationQualifierDefaultValues(\n        config,\n        initParams.qualifierDefaultValues\n      ).onSuccess((updatedConfig) =>\n        captureResult(\n          () => new SystemConfiguration(updatedConfig, omit(initParams, ['qualifierDefaultValues']))\n        )\n      );\n    }\n    return captureResult(() => new SystemConfiguration(config, initParams));\n  }\n\n  /**\n   * Loads a {@link Config.SystemConfiguration | SystemConfiguration} from a file.\n   * @param path - The path to the file to load.\n   * @returns `Success` with the {@link Config.SystemConfiguration | SystemConfiguration}\n   * if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public static loadFromFile(\n    path: string,\n    initParams?: ISystemConfigurationInitParams\n  ): Result<SystemConfiguration> {\n    return JsonFile.convertJsonFileSync(path, systemConfiguration).onSuccess((config) =>\n      SystemConfiguration.create(config, initParams)\n    );\n  }\n\n  /**\n   * Returns the {@link Config.Model.ISystemConfiguration | system configuration} that this\n   * {@link Config.SystemConfiguration | SystemConfiguration} was created from.\n   * @returns `Success` with the {@link Config.Model.ISystemConfiguration | system configuration}\n   * if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public getConfig(): Result<ISystemConfiguration> {\n    return systemConfiguration.convert(this._config);\n  }\n}\n"]}

package/dist/packlets/context/contextDecls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextDecls.js","sourceRoot":"","sources":["../../../src/packlets/context/contextDecls.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 { QualifierContextValue, QualifierName } from '../common';\nimport { Qualifier } from '../qualifiers';\n\n/**\n * Options to control matching of conditions against a context.\n * @public\n */\nexport interface IContextMatchOptions {\n  /**\n   * If true, then conditions which would otherwise yield\n   * {@link NoMatch | NoMatch} but have a defined {@link Conditions.Condition.scoreAsDefault | scoreAsDefault}\n   * will yield `scoreAsDefault`instead of `NoMatch`.\n   */\n  acceptDefaultScore?: boolean;\n\n  /**\n   * If true, then conditions for which a corresponding values is not present in the\n   * context being matched will yield `undefined` instead of `NoMatch`.\n   */\n  partialContextMatch?: boolean;\n}\n\n/**\n * Non-validated declaration of a single context qualifier value.\n * @public\n */\nexport interface IContextQualifierValueDecl {\n  qualifier: string;\n  value: string;\n}\n\n/**\n * Non-validated declaration of a context, consisting of named\n * values.\n * @public\n */\nexport type IContextDecl = Record<string, string>;\n\n/**\n * Validated declaration of a single context qualifier value.\n * @public\n */\nexport interface IValidatedContextQualifierValueDecl {\n  qualifier: Qualifier;\n  value: QualifierContextValue;\n}\n\n/**\n * Validated declaration of a context, a record with strongly-typed\n * {@link QualifierTypeName | qualifier type names} as keys and\n * {@link QualifierContextValue | qualifier context values} as values.\n * @public\n */\nexport type IValidatedContextDecl = Record<QualifierName, QualifierContextValue>;\n"]}