@fgv/ts-res 5.1.0-28 → 5.1.0-29

package/lib/packlets/conditions/conditionDecls.d.ts

@@ -3,9 +3,14 @@ import { Qualifier } from '../qualifiers';
 import * as ResourceJson from '../resource-json';
 /**
  * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` (defaulting to `string`) so consumers
+ * authoring conditions in code can opt into compile-time axis-name discipline.
+ *
  * @public
  */
-export type IConditionDecl = ResourceJson.Json.ILooseConditionDecl;
+export type IConditionDecl<TQualifierNames extends string = string> = ResourceJson.Json.ILooseConditionDecl<TQualifierNames>;
 /**
  * Validated declaration of a {@link Conditions.Condition | condition} with all defaults applied.
  * @public

package/lib/packlets/conditions/conditionDecls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditionDecls.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}
+{"version":3,"file":"conditionDecls.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,CAAC,eAAe,SAAS,MAAM,GAAG,MAAM,IAChE,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB"}

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

@@ -1 +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 * @public\n */\nexport type IConditionDecl = ResourceJson.Json.ILooseConditionDecl;\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"]}
+{"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/lib/packlets/conditions/conditionSet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditionSet.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSet.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,WAAW,EAAoB,MAAM,EAAW,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAEL,iBAAiB,EACjB,eAAe,EACf,aAAa,EAEd,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,wBAAyB,SAAQ,YAAY,CAAC,OAAO,CAAC,mBAAmB;IACxF;;;OAGG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;CACjD;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,0BAA0B;IAC7D,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IAC7F;;;;OAIG;IACH,SAAgB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAErD;;OAEG;IACH,IAAW,GAAG,IAAI,eAAe,CAEhC;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,iBAAiB,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,OAAc,gBAAgB,EAAE,eAAe,CAA4C;IAE3F;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,0BAA0B;IAsBxD;;;;;;;OAOG;WACW,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAAC,YAAY,CAAC;IAI9E;;;;;;;OAOG;WACW,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM;IAWnE;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAIzD;;;;;;;OAOG;IACI,sBAAsB,CAC3B,OAAO,EAAE,OAAO,CAAC,qBAAqB,EACtC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,GACrC,OAAO;IAIV;;;;;OAKG;WACW,aAAa,CAAC,IAAI,EAAE,0BAA0B,GAAG,MAAM,CAAC,eAAe,CAAC;IAItF;;;;;;OAMG;WACW,mBAAmB,CAC/B,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,GAAG,SAAS,EAC5D,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAAC,eAAe,CAAC;IAiC1B;;;;;;;;OAQG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IAM/C;;;OAGG;IACI,KAAK,IAAI,eAAe;IAI/B;;;;;OAKG;IACI,MAAM,IAAI,MAAM;IAIvB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;OAIG;IACI,wBAAwB,CAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,YAAY,CAAC,IAAI,CAAC,wBAAwB;IAa7C;;;;OAIG;IACI,uBAAuB,CAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,YAAY,CAAC,IAAI,CAAC,uBAAuB;IAS5C;;;;;OAKG;IACI,UAAU,CACf,OAAO,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,wBAAwB,GACvD,YAAY,CAAC,QAAQ,CAAC,qBAAqB;CAM/C"}
+{"version":3,"file":"conditionSet.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSet.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,WAAW,EAAoB,MAAM,EAAW,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAEL,iBAAiB,EACjB,eAAe,EACf,aAAa,EAEd,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,WAAW,wBAAyB,SAAQ,YAAY,CAAC,OAAO,CAAC,mBAAmB;IACxF;;;OAGG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;CACjD;AAED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,0BAA0B;IAC7D,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IAC7F;;;;OAIG;IACH,SAAgB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAErD;;OAEG;IACH,IAAW,GAAG,IAAI,eAAe,CAEhC;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,iBAAiB,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,OAAc,gBAAgB,EAAE,eAAe,CAA4C;IAE3F;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,0BAA0B;IAsBxD;;;;;;;OAOG;WACW,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAAC,YAAY,CAAC;IAI9E;;;;;;;OAOG;WACW,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM;IAWnE;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAIzD;;;;;;;OAOG;IACI,sBAAsB,CAC3B,OAAO,EAAE,OAAO,CAAC,qBAAqB,EACtC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,GACrC,OAAO;IAIV;;;;;OAKG;WACW,aAAa,CAAC,IAAI,EAAE,0BAA0B,GAAG,MAAM,CAAC,eAAe,CAAC;IAItF;;;;;;OAMG;WACW,mBAAmB,CAC/B,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,GAAG,SAAS,EAC5D,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAAC,eAAe,CAAC;IA0C1B;;;;;;;;OAQG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IAM/C;;;OAGG;IACI,KAAK,IAAI,eAAe;IAI/B;;;;;OAKG;IACI,MAAM,IAAI,MAAM;IAIvB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;OAIG;IACI,wBAAwB,CAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,YAAY,CAAC,IAAI,CAAC,wBAAwB;IAa7C;;;;OAIG;IACI,uBAAuB,CAC5B,OAAO,CAAC,EAAE,wBAAwB,GACjC,YAAY,CAAC,IAAI,CAAC,uBAAuB;IAS5C;;;;;OAKG;IACI,UAAU,CACf,OAAO,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,wBAAwB,GACvD,YAAY,CAAC,QAAQ,CAAC,qBAAqB;CAM/C"}

package/lib/packlets/conditions/conditionSet.js

@@ -181,16 +181,25 @@ 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/lib/packlets/conditions/conditionSet.js.map

@@ -1 +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: Record<string, string | IChildConditionDecl>\n      const conditions = Object.entries(conditionSet).map(([qualifierName, value]) => {\n        if (typeof value === 'string') {\n          return { qualifierName, value };\n          /* c8 ignore next 3 - edge case */\n        } else {\n          return { 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"]}
+{"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/lib/packlets/conditions/conditionSetDecls.d.ts

@@ -2,10 +2,15 @@ import { Condition } from './condition';
 import { IConditionDecl } from './conditionDecls';
 /**
  * Non-validated declaration of a {@link Conditions.ConditionSet | set of conditions}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` (defaulting to `string`) so consumers can
+ * opt into compile-time axis-name discipline by supplying a literal-string union.
+ *
  * @public
  */
-export interface IConditionSetDecl {
-    conditions: IConditionDecl[];
+export interface IConditionSetDecl<TQualifierNames extends string = string> {
+    conditions: IConditionDecl<TQualifierNames>[];
 }
 /**
  * Validated declaration of a {@link Conditions.ConditionSet | set of conditions}.

package/lib/packlets/conditions/conditionSetDecls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditionSetDecls.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"conditionSetDecls.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB,CAAC,eAAe,SAAS,MAAM,GAAG,MAAM;IACxE,UAAU,EAAE,cAAc,CAAC,eAAe,CAAC,EAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

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

@@ -1 +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 * @public\n */\nexport interface IConditionSetDecl {\n  conditions: IConditionDecl[];\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"]}
+{"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/lib/packlets/conditions/convert/conditionSetDecls.d.ts

@@ -1,10 +1,26 @@
+import { Converter } from '@fgv/ts-utils';
 import { IConditionSetDecl, IValidatedConditionSetDecl } from '../conditionSetDecls';
 import { ConditionCollector } from '../conditionCollector';
 /**
  * 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 declare const conditionSetDecl: import("@fgv/ts-utils").ObjectConverter<IConditionSetDecl, unknown>;
+export declare const conditionSetDecl: import("@fgv/ts-utils").ObjectConverter<IConditionSetDecl<string>, unknown>;
+/**
+ * Returns a `Converter` for an `IConditionSetDecl<TQualifierNames>` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * Each contained condition is converted via `typedConditionDecl(qualifierNameConverter)`.
+ *
+ * @public
+ */
+export declare function typedConditionSetDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IConditionSetDecl<TQualifierNames>>;
 /**
  * Context for converting a {@link Conditions.IConditionSetDecl | condition set declaration}
  * into an instantiated {@link Conditions.ConditionSet | condition set} object.
@@ -18,7 +34,19 @@ export interface IConditionSetDeclConvertContext {
  * 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 declare const validatedConditionSetDecl: Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>;
+/**
+ * Returns a `Converter` for an `IValidatedConditionSetDecl` narrowed on a supplied
+ * `qualifierName` converter.
+ *
  * @public
  */
-export declare const validatedConditionSetDecl: import("@fgv/ts-utils").Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>;
+export declare function typedValidatedConditionSetDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>;
 //# sourceMappingURL=conditionSetDecls.d.ts.map

package/lib/packlets/conditions/convert/conditionSetDecls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditionSetDecls.d.ts","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,qEAE3B,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,gGAkBpC,CAAC"}
+{"version":3,"file":"conditionSetDecls.d.ts","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAiD,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,6EAE3B,CAAC;AAEH;;;;;;;;GAQG;AAGH,wBAAgB,qBAAqB,CAAC,eAAe,SAAS,MAAM,EAClE,sBAAsB,EAAE,SAAS,CAAC,eAAe,CAAC,GACjD,SAAS,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAI/C;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAuBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,wEAKpC,CAAC;AAEH;;;;;GAKG;AAIH,wBAAgB,8BAA8B,CAAC,eAAe,SAAS,MAAM,EAC3E,sBAAsB,EAAE,SAAS,CAAC,eAAe,CAAC,GACjD,SAAS,CAAC,0BAA0B,EAAE,+BAA+B,CAAC,CAWxE"}

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

@@ -22,33 +22,79 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validatedConditionSetDecl = exports.conditionSetDecl = void 0;
+exports.typedConditionSetDecl = typedConditionSetDecl;
+exports.typedValidatedConditionSetDecl = typedValidatedConditionSetDecl;
 const ts_utils_1 = require("@fgv/ts-utils");
 const decls_1 = require("./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
  */
 exports.conditionSetDecl = ts_utils_1.Converters.strictObject({
     conditions: ts_utils_1.Converters.arrayOf(decls_1.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
  */
-exports.validatedConditionSetDecl = ts_utils_1.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.
+function typedConditionSetDecl(qualifierNameConverter) {
+    return ts_utils_1.Converters.strictObject({
+        conditions: ts_utils_1.Converters.arrayOf((0, decls_1.typedConditionDecl)(qualifierNameConverter))
+    });
+}
+function _validatedConditionSetDeclBody(innerConditionSetDecl, from, context) {
     /* c8 ignore next 3 - coverage is having a bad day */
     if (!context) {
         return (0, ts_utils_1.fail)('validatedConditionSetDecl converter requires a context');
     }
-    return exports.conditionSetDecl.convert(from).onSuccess((decl) => {
+    return innerConditionSetDecl.convert(from).onSuccess((decl) => {
         return (0, ts_utils_1.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 (0, ts_utils_1.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
+ */
+exports.validatedConditionSetDecl = ts_utils_1.Converters.generic((from, __self, context) => {
+    return _validatedConditionSetDeclBody(exports.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.
+function typedValidatedConditionSetDecl(qualifierNameConverter) {
+    const inner = typedConditionSetDecl(qualifierNameConverter);
+    return ts_utils_1.Converters.generic((from, __self, context) => {
+        return _validatedConditionSetDeclBody(inner, from, context);
+    });
+}
 //# sourceMappingURL=conditionSetDecls.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"conditionSetDecls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAA8E;AAE9E,mCAAwC;AAGxC,2CAA2C;AAE3C;;;GAGG;AACU,QAAA,gBAAgB,GAAG,qBAAU,CAAC,YAAY,CAAoB;IACzE,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,qBAAa,CAAC;CAC9C,CAAC,CAAC;AAYH;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,qBAAU,CAAC,OAAO,CAGzD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAyC,EAAsC,EAAE;IACzG,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAA,eAAI,EAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,wBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACvD,OAAO,IAAA,qBAAU,EACf,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,IAAA,kBAAO,EAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converters, Result, fail, mapResults, succeed } from '@fgv/ts-utils';\nimport { IConditionSetDecl, IValidatedConditionSetDecl } from '../conditionSetDecls';\nimport { conditionDecl } 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 * @public\n */\nexport const conditionSetDecl = Converters.strictObject<IConditionSetDecl>({\n  conditions: Converters.arrayOf(conditionDecl)\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\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 * @public\n */\nexport const validatedConditionSetDecl = Converters.generic<\n  IValidatedConditionSetDecl,\n  IConditionSetDeclConvertContext\n>((from: unknown, __self, context?: IConditionSetDeclConvertContext): 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 conditionSetDecl.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"]}
+{"version":3,"file":"conditionSetDecls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAiCH,sDAMC;AA4DD,wEAaC;AA9GD,4CAAyF;AAEzF,mCAA4D;AAG5D,2CAA2C;AAE3C;;;;;;;;GAQG;AACU,QAAA,gBAAgB,GAAG,qBAAU,CAAC,YAAY,CAAoB;IACzE,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,qBAAa,CAAC;CAC9C,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,uEAAuE;AACvE,0EAA0E;AAC1E,SAAgB,qBAAqB,CACnC,sBAAkD;IAElD,OAAO,qBAAU,CAAC,YAAY,CAAqC;QACjE,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,IAAA,0BAAkB,EAAC,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,IAAA,eAAI,EAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5D,OAAO,IAAA,qBAAU,EACf,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,IAAA,kBAAO,EAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACU,QAAA,yBAAyB,GAAG,qBAAU,CAAC,OAAO,CAGzD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAyC,EAAsC,EAAE;IACzG,OAAO,8BAA8B,CAAC,wBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,0DAA0D;AAC1D,8EAA8E;AAC9E,wCAAwC;AACxC,SAAgB,8BAA8B,CAC5C,sBAAkD;IAElD,MAAM,KAAK,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;IAC5D,OAAO,qBAAU,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/lib/packlets/conditions/convert/decls.d.ts

@@ -1,10 +1,29 @@
-import { IValidatedConditionDecl } from '../conditionDecls';
+import { Converter } from '@fgv/ts-utils';
+import { IConditionDecl, IValidatedConditionDecl } from '../conditionDecls';
 import { IReadOnlyQualifierCollector } from '../../qualifiers';
 /**
  * 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 declare const conditionDecl: import("@fgv/ts-utils").ObjectConverter<import("../../resource-json/json").ILooseConditionDecl, unknown>;
+export declare const conditionDecl: import("@fgv/ts-utils").ObjectConverter<IConditionDecl, unknown>;
+/**
+ * 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 declare function typedConditionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IConditionDecl<TQualifierNames>>;
 /**
  * Conversion context to uses when converting
  * a {@link Conditions.IValidatedConditionDecl | validated condition declaration}.
@@ -18,7 +37,24 @@ export interface IConditionDeclConvertContext {
  * 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 declare const validatedConditionDecl: Converter<IValidatedConditionDecl, IConditionDeclConvertContext>;
+/**
+ * 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
  */
-export declare const validatedConditionDecl: import("@fgv/ts-utils").Converter<IValidatedConditionDecl, IConditionDeclConvertContext>;
+export declare function typedValidatedConditionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IValidatedConditionDecl, IConditionDeclConvertContext>;
 //# sourceMappingURL=decls.d.ts.map

package/lib/packlets/conditions/convert/decls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decls.d.ts","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/decls.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAkB,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAI/D;;;GAGG;AACH,eAAO,MAAM,aAAa,0GAMxB,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,0FAqCjC,CAAC"}
+{"version":3,"file":"decls.d.ts","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/decls.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,SAAS,EAAqD,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAI/D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,kEAMxB,CAAC;AAEH;;;;;;;;;;;GAWG;AAGH,wBAAgB,kBAAkB,CAAC,eAAe,SAAS,MAAM,EAC/D,sBAAsB,EAAE,SAAS,CAAC,eAAe,CAAC,GACjD,SAAS,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAQ5C;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0CD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,kEAKjC,CAAC;AAEH;;;;;;;;;GASG;AAIH,wBAAgB,2BAA2B,CAAC,eAAe,SAAS,MAAM,EACxE,sBAAsB,EAAE,SAAS,CAAC,eAAe,CAAC,GACjD,SAAS,CAAC,uBAAuB,EAAE,4BAA4B,CAAC,CAOlE"}

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

@@ -55,11 +55,18 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validatedConditionDecl = exports.conditionDecl = void 0;
+exports.typedConditionDecl = typedConditionDecl;
+exports.typedValidatedConditionDecl = typedValidatedConditionDecl;
 const Common = __importStar(require("../../common"));
 const ts_utils_1 = require("@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
  */
 exports.conditionDecl = ts_utils_1.Converters.strictObject({
@@ -70,17 +77,34 @@ exports.conditionDecl = ts_utils_1.Converters.strictObject({
     scoreAsDefault: ts_utils_1.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
  */
-exports.validatedConditionDecl = ts_utils_1.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.
+function typedConditionDecl(qualifierNameConverter) {
+    return ts_utils_1.Converters.strictObject({
+        qualifierName: qualifierNameConverter,
+        value: ts_utils_1.Converters.string,
+        operator: Common.Convert.conditionOperator.optional(),
+        priority: ts_utils_1.Converters.number.optional(),
+        scoreAsDefault: ts_utils_1.Converters.number.optional()
+    });
+}
+function _validatedConditionDeclBody(innerConditionDecl, from, context) {
     /* c8 ignore next 3 - coverage is having a bad day */
     if (!context) {
         return (0, ts_utils_1.fail)('validatedConditionDecl converter requires a context');
     }
-    return exports.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) => {
@@ -107,5 +131,39 @@ exports.validatedConditionDecl = ts_utils_1.Converters.generic((from, __self, co
                 .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
+ */
+exports.validatedConditionDecl = ts_utils_1.Converters.generic((from, __self, context) => {
+    return _validatedConditionDeclBody(exports.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.
+function typedValidatedConditionDecl(qualifierNameConverter) {
+    const inner = typedConditionDecl(qualifierNameConverter);
+    return ts_utils_1.Converters.generic((from, __self, context) => {
+        return _validatedConditionDeclBody(inner, from, context);
+    });
+}
 //# sourceMappingURL=decls.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"decls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/decls.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,qDAAuC;AACvC,4CAAkF;AAIlF,2CAA2C;AAE3C;;;GAGG;AACU,QAAA,aAAa,GAAG,qBAAU,CAAC,YAAY,CAAiB;IACnE,aAAa,EAAE,qBAAU,CAAC,MAAM;IAChC,KAAK,EAAE,qBAAU,CAAC,MAAM;IACxB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE;IACrD,QAAQ,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACtC,cAAc,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAYH;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,qBAAU,CAAC,OAAO,CAGtD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAsC,EAAmC,EAAE;IACnG,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAA,eAAI,EAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,qBAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;;QACpD,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,IAAA,yBAAc,EAA0B;gBAC7C,SAAS,EAAE,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,SAAS,CAAC;gBACnC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAC9D,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,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,IAAA,kBAAO,EAAC,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,IAAA,kBAAO,EAAC,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,IAAA,kBAAO,EAAC,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,IAAA,kBAAO,EAAC,MAAM,CAAC,CAAC;YACzB,CAAC,CAAC;iBACD,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Common from '../../common';\nimport { 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 * @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 * 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\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 * @public\n */\nexport const validatedConditionDecl = Converters.generic<\n  IValidatedConditionDecl,\n  IConditionDeclConvertContext\n>((from: unknown, __self, context?: IConditionDeclConvertContext): 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 conditionDecl.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"]}
+{"version":3,"file":"decls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/decls.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 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"]}