@fgv/ts-res 4.5.0-3 → 5.0.0-10

package/lib/packlets/conditions/conditionSet.js

@@ -20,11 +20,45 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConditionSet = void 0;
 const ts_utils_1 = require("@fgv/ts-utils");
 const condition_1 = require("./condition");
 const common_1 = require("../common");
+const ConditionsConvert = __importStar(require("./convert"));
 /**
  * Represents a set of {@link Conditions.Condition | conditions} that must all be met in some runtime
  * context for a resource instance to be valid.
@@ -58,8 +92,8 @@ class ConditionSet {
         var _a, _b;
         const qualifiers = new Map();
         for (const condition of params.conditions) {
+            /* c8 ignore next 9 - there's a test for this but coverage is having a bad day */
             if (qualifiers.has(condition.qualifier.name)) {
-                /* c8 ignore next */
                 const existing = (_b = (_a = qualifiers.get(condition.qualifier.name)) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 'unknown';
                 throw new Error(`${condition.qualifier.name}: Duplicate conditions ${existing} and ${condition.toString()} are not supported.`);
             }
@@ -109,6 +143,17 @@ class ConditionSet {
     setIndex(index) {
         return this._collectible.setIndex(index);
     }
+    /**
+     * Determines if this condition set can match a supplied context, even if the context is partial.
+     * Returns true if all conditions in the set can match the context (using canMatchPartialContext).
+     * Returns false otherwise.
+     * @param context - The context to match.
+     * @param options - Options to use when matching.
+     * @returns `true` if all conditions can match the context, `false` otherwise.
+     */
+    canMatchPartialContext(context, options) {
+        return this.conditions.every((c) => c.canMatchPartialContext(context, options));
+    }
     /**
      * Gets the {@link ConditionSetKey | key} for a supplied {@link Conditions.IValidatedConditionSetDecl | condition set declaration}.
      * @param decl - The {@link Conditions.IValidatedConditionSetDecl | condition set declaration} for which to get the key.
@@ -118,6 +163,43 @@ class ConditionSet {
     static getKeyForDecl(decl) {
         return common_1.Validate.toConditionSetKey(decl.conditions.map((c) => c.toKey()).join('+'));
     }
+    /**
+     * Gets a condition set key from a loose condition set declaration.
+     * @param conditionSet - The loose condition set declaration to convert.
+     * @param conditionCollector - The condition collector used for validation.
+     * @returns `Success` with the condition set key if successful, `Failure` otherwise.
+     * @public
+     */
+    static getKeyFromLooseDecl(conditionSet, conditionCollector) {
+        if (!conditionSet) {
+            return (0, ts_utils_1.succeed)(ConditionSet.UnconditionalKey);
+        }
+        // Convert ConditionSetDecl to IConditionSetDecl format
+        let conditionSetDecl;
+        if (Array.isArray(conditionSet)) {
+            // ConditionSetDeclAsArray: array of ILooseConditionDecl
+            conditionSetDecl = { conditions: conditionSet };
+        }
+        else {
+            // ConditionSetDeclAsRecord: Record<string, string | IChildConditionDecl>
+            const conditions = Object.entries(conditionSet).map(([qualifierName, value]) => {
+                if (typeof value === 'string') {
+                    return { qualifierName, value };
+                }
+                else {
+                    return Object.assign({ qualifierName }, value);
+                }
+            });
+            conditionSetDecl = { conditions };
+        }
+        // Validate and convert to IValidatedConditionSetDecl
+        return ConditionsConvert.validatedConditionSetDecl
+            .convert(conditionSetDecl, { conditions: conditionCollector })
+            .onSuccess((validatedDecl) => {
+            // Use proper ConditionSet.getKeyForDecl method to generate the key
+            return ConditionSet.getKeyForDecl(validatedDecl);
+        });
+    }
     /**
      * Gets a {@link ConditionSetToken | condition set token} for this condition set,
      * if possible.
@@ -161,7 +243,12 @@ class ConditionSet {
      * @returns The {@link ResourceJson.Json.ConditionSetDeclAsRecord | condition set declaration as a record} for this condition set.
      */
     toConditionSetRecordDecl(options) {
-        return Object.fromEntries(this.conditions.map((c) => {
+        const qualifiersToReduce = options === null || options === void 0 ? void 0 : options.qualifiersToReduce;
+        const conditions = qualifiersToReduce
+            ? /* c8 ignore next 1 - coverage intermittently misses the next line */
+                this.conditions.filter((c) => !qualifiersToReduce.has(c.qualifier.name))
+            : this.conditions;
+        return Object.fromEntries(conditions.map((c) => {
             return [c.qualifier.name, c.toValueOrChildConditionDecl(options)];
         }));
     }
@@ -171,7 +258,21 @@ class ConditionSet {
      * @returns The {@link ResourceJson.Json.ConditionSetDeclAsArray | condition set declaration as an array} for this condition set.
      */
     toConditionSetArrayDecl(options) {
-        return this.conditions.map((c) => c.toLooseConditionDecl(options));
+        /* c8 ignore next 1 - defense in depth */
+        const qualifiersToReduce = options === null || options === void 0 ? void 0 : options.qualifiersToReduce;
+        const conditions = qualifiersToReduce
+            ? this.conditions.filter((c) => !qualifiersToReduce.has(c.qualifier.name))
+            : this.conditions;
+        return conditions.map((c) => c.toLooseConditionDecl(options));
+    }
+    /**
+     * Converts this condition set to a compiled condition set representation.
+     * @param options - Optional compilation options controlling the output format.
+     * @returns A compiled condition set object that can be used for serialization or runtime processing.
+     * @public
+     */
+    toCompiled(options) {
+        return Object.assign({ conditions: this.conditions.map((c) => c.index) }, ((options === null || options === void 0 ? void 0 : options.includeMetadata) === true ? { metadata: { key: this.key } } : {}));
     }
 }
 exports.ConditionSet = ConditionSet;

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 } 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 ResourceJson from '../resource-json';\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      if (qualifiers.has(condition.qualifier.name)) {\n        /* c8 ignore next */\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   * 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 {@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?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.ConditionSetDeclAsRecord {\n    return Object.fromEntries(\n      this.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?: ResourceJson.Helpers.IDeclarationOptions\n  ): ResourceJson.Json.ConditionSetDeclAsArray {\n    return this.conditions.map((c) => c.toLooseConditionDecl(options));\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: Record<string, string | IChildConditionDecl>\n      const conditions = Object.entries(conditionSet).map(([qualifierName, value]) => {\n        if (typeof value === 'string') {\n          return { qualifierName, value };\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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"conditionSetCollector.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetCollector.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,WAAW,EAAc,MAAM,EAAW,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAA6C,iBAAiB,EAAY,MAAM,WAAW,CAAC;AAEnG;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAE/B;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB,CAAC,YAAY,CAAC;IAC1E;;;OAGG;IACI,UAAU,EAAE,kBAAkB,CAAC;IAEtC;;;OAGG;IACH,IAAW,yBAAyB,IAAI,YAAY,CAEnD;IAED;;OAEG;IACH,OAAc,kBAAkB,EAAE,iBAAiB,CAA6C;IAEhG;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,kCAAkC;IAchE;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,kCAAkC,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAI/F,OAAO,CAAC,eAAe;CAaxB;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,WAAW,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"conditionSetCollector.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetCollector.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,WAAW,EAAc,MAAM,EAAW,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAA6C,iBAAiB,EAAY,MAAM,WAAW,CAAC;AAEnG;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAE/B;;;OAGG;IACH,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB,CAAC,YAAY,CAAC;IAC1E;;;OAGG;IACI,UAAU,EAAE,kBAAkB,CAAC;IAEtC;;;OAGG;IACH,IAAW,yBAAyB,IAAI,YAAY,CAEnD;IAED;;OAEG;IACH,OAAc,kBAAkB,EAAE,iBAAiB,CAA6C;IAEhG;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,kCAAkC;IAgBhE;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,kCAAkC,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAI/F,OAAO,CAAC,eAAe;CAcxB;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,WAAW,CAAC,4BAA4B,CAAC,YAAY,CAAC,CAAC"}

package/lib/packlets/conditions/conditionSetCollector.js

@@ -51,6 +51,7 @@ class ConditionSetCollector extends ts_utils_1.ValidatingCollector {
         super({
             converters: new ts_utils_1.Collections.KeyValueConverters({
                 key: common_1.Convert.conditionSetKey,
+                /* c8 ignore next 1 - there's a test but coverage is having a bad day */
                 value: (from) => this._toConditionSet(from)
             })
         });
@@ -58,6 +59,7 @@ class ConditionSetCollector extends ts_utils_1.ValidatingCollector {
         // it's very helpful for debugging if the unconditional condition set is always
         // in position 0
         this.validating.add(conditionSet_1.ConditionSet.create({ conditions: [] }).orThrow()).orThrow();
+        /* c8 ignore next 1 - ? is defense in depth */
         (_a = params.conditionSets) === null || _a === void 0 ? void 0 : _a.forEach((item) => this.validating.add(item).orThrow());
     }
     /**
@@ -77,6 +79,7 @@ class ConditionSetCollector extends ts_utils_1.ValidatingCollector {
         if (Array.isArray(from)) {
             return (0, ts_utils_1.mapResults)(from.map((item) => this.conditions.validating.getOrAdd(item))).onSuccess((conditions) => conditionSet_1.ConditionSet.create({ conditions }));
         }
+        /* c8 ignore next 4 - functional code path tested but coverage intermittently missed */
         return convert_1.validatedConditionSetDecl
             .convert(from, { conditions: this.conditions, conditionSetIndex: this.size })
             .onSuccess((c) => conditionSet_1.ConditionSet.create(c));

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

@@ -1 +1 @@
-{"version":3,"file":"conditionSetCollector.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetCollector.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAA6G;AAG7G,iDAA8C;AAC9C,uCAAsD;AACtD,sCAAmG;AAoBnG;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,8BAAiC;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,sBAAW,CAAC,kBAAkB,CAAgC;gBAC5E,GAAG,EAAE,gBAAa,CAAC,eAAe;gBAClC,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,2BAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACjF,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,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,eAAe,CAAC,IAAa;QACnC,IAAI,IAAI,YAAY,2BAAY,EAAE,CAAC;YACjC,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAA,qBAAU,EAAC,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,2BAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CACpD,CAAC;QACJ,CAAC;QACD,OAAO,mCAAyB;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,2BAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;;AA9DH,sDA+DC;AAhDC;;GAEG;AACW,wCAAkB,GAAsB,iBAAQ,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        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    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    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"]}
+{"version":3,"file":"conditionSetCollector.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetCollector.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAA6G;AAG7G,iDAA8C;AAC9C,uCAAsD;AACtD,sCAAmG;AAoBnG;;;;;;GAMG;AACH,MAAa,qBAAsB,SAAQ,8BAAiC;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,sBAAW,CAAC,kBAAkB,CAAgC;gBAC5E,GAAG,EAAE,gBAAa,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,2BAAY,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,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,eAAe,CAAC,IAAa;QACnC,IAAI,IAAI,YAAY,2BAAY,EAAE,CAAC;YACjC,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAA,qBAAU,EAAC,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,2BAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CACpD,CAAC;QACJ,CAAC;QACD,uFAAuF;QACvF,OAAO,mCAAyB;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,2BAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;;AAjEH,sDAkEC;AAnDC;;GAEG;AACW,wCAAkB,GAAsB,iBAAQ,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/lib/packlets/conditions/conditionToken.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditionToken.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionToken.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAqB,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEvE;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;;OAGG;gBACgB,UAAU,EAAE,2BAA2B;IAI1D;;;;;;OAMG;IACI,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,uBAAuB,CAAC;IAI1E;;;;;;OAMG;IACI,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAI/E;;;;OAIG;IACI,2BAA2B,CAChC,KAAK,EAAE,aAAa,CAAC,oBAAoB,GACxC,MAAM,CAAC,uBAAuB,CAAC;IAIlC;;;;;OAKG;IACI,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;IAI9D;;;;;;;OAOG;WACW,mBAAmB,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,uBAAuB,CAAC;IAMlC;;;;;;;OAOG;WACW,sBAAsB,CAClC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAMpC;;;;;;;;OAQG;WACW,2BAA2B,CACvC,KAAK,EAAE,aAAa,CAAC,oBAAoB,EACzC,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,uBAAuB,CAAC;IAkBlC;;;;;;OAMG;WACW,qBAAqB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,SAAS,CAAC;CAerB"}
+{"version":3,"file":"conditionToken.d.ts","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionToken.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAqB,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEvE;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;;OAGG;gBACgB,UAAU,EAAE,2BAA2B;IAI1D;;;;;;OAMG;IACI,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,uBAAuB,CAAC;IAI1E;;;;;;OAMG;IACI,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAI/E;;;;OAIG;IACI,2BAA2B,CAChC,KAAK,EAAE,aAAa,CAAC,oBAAoB,GACxC,MAAM,CAAC,uBAAuB,CAAC;IAIlC;;;;;OAKG;IACI,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;IAI9D;;;;;;;OAOG;WACW,mBAAmB,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,uBAAuB,CAAC;IAMlC;;;;;;;OAOG;WACW,sBAAsB,CAClC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAMpC;;;;;;;;OAQG;WACW,2BAA2B,CACvC,KAAK,EAAE,aAAa,CAAC,oBAAoB,EACzC,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,uBAAuB,CAAC;IAkBlC;;;;;;OAMG;WACW,qBAAqB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,SAAS,CAAC;CAgBrB"}

package/lib/packlets/conditions/conditionToken.js

@@ -133,13 +133,14 @@ class ConditionTokens {
     static findQualifierForValue(value, qualifiers) {
         const matched = [];
         for (const qualifier of qualifiers.values()) {
-            if (qualifier.tokenIsOptional && qualifier.type.validateCondition(value).isSuccess()) {
+            if (qualifier.tokenIsOptional && qualifier.validateCondition(value).isSuccess()) {
                 matched.push(qualifier);
             }
         }
         if (matched.length === 0) {
             return (0, ts_utils_1.fail)(`${value}: does not match any qualifier`);
         }
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
         if (matched.length > 1) {
             return (0, ts_utils_1.fail)(`${value}: matches multiple qualifiers (${matched.map((q) => q.name).join(', ')})`);
         }

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

@@ -1 +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.type.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    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"]}
+{"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/lib/packlets/conditions/convert/decls.js

@@ -86,7 +86,7 @@ exports.validatedConditionDecl = ts_utils_1.Converters.generic((from, __self, co
         return context.qualifiers.validating.get(decl.qualifierName).onSuccess((qualifier) => {
             return (0, ts_utils_1.populateObject)({
                 qualifier: () => (0, ts_utils_1.succeed)(qualifier),
-                value: () => qualifier.type.validateCondition(decl.value, operator),
+                value: () => qualifier.validateCondition(decl.value, operator),
                 operator: () => (0, ts_utils_1.succeed)(operator),
                 priority: () => decl.priority
                     ? Common.Convert.conditionPriority.convert(decl.priority)

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,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;gBACnE,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.type.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":";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"]}

package/lib/packlets/config/common.d.ts

@@ -0,0 +1,35 @@
+import { Result } from '@fgv/ts-utils';
+import { ISystemConfiguration } from './json';
+import { SystemConfiguration, ISystemConfigurationInitParams } from './systemConfiguration';
+/**
+ * A `string` literal type representing a well-known predefined system configuration.
+ * @public
+ */
+export type PredefinedSystemConfiguration = 'default' | 'language-priority' | 'territory-priority' | 'extended-example';
+/**
+ * An array of all well-known predefined system configurations.
+ * @public
+ */
+export declare const allPredefinedSystemConfigurations: ReadonlyArray<PredefinedSystemConfiguration>;
+export * from './predefined';
+/**
+ * Returns the {@link Config.Model.ISystemConfiguration | system configuration} declaration for the
+ * specified predefined system configuration.
+ * @param name - The name of the predefined system configuration.
+ * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.
+ * @returns `Success` with the {@link Config.Model.ISystemConfiguration | system configuration}
+ * declaration if successful, `Failure` with an error message otherwise.
+ * @public
+ */
+export declare function getPredefinedDeclaration(name: PredefinedSystemConfiguration, initParams?: ISystemConfigurationInitParams): Result<ISystemConfiguration>;
+/**
+ * Returns the {@link Config.SystemConfiguration | SystemConfiguration} for the specified
+ * predefined system configuration.
+ * @param name - The name of the predefined system configuration.
+ * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.
+ * @returns `Success` with the {@link Config.SystemConfiguration | SystemConfiguration}
+ * if successful, `Failure` with an error message otherwise.
+ * @public
+ */
+export declare function getPredefinedSystemConfiguration(name: PredefinedSystemConfiguration, initParams?: ISystemConfigurationInitParams): Result<SystemConfiguration>;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/config/common.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAQ,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAE/B,MAAM,uBAAuB,CAAC;AAI/B;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GACrC,SAAS,GACT,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB;;;GAGG;AACH,eAAO,MAAM,iCAAiC,EAAE,aAAa,CAAC,6BAA6B,CAK1F,CAAC;AAEF,cAAc,cAAc,CAAC;AAS7B;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,6BAA6B,EACnC,UAAU,CAAC,EAAE,8BAA8B,GAC1C,MAAM,CAAC,oBAAoB,CAAC,CAY9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,6BAA6B,EACnC,UAAU,CAAC,EAAE,8BAA8B,GAC1C,MAAM,CAAC,mBAAmB,CAAC,CAM7B"}

package/lib/packlets/config/common.js

@@ -0,0 +1,96 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allPredefinedSystemConfigurations = void 0;
+exports.getPredefinedDeclaration = getPredefinedDeclaration;
+exports.getPredefinedSystemConfiguration = getPredefinedSystemConfiguration;
+const ts_utils_1 = require("@fgv/ts-utils");
+const systemConfiguration_1 = require("./systemConfiguration");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const predefined_1 = require("./predefined");
+/**
+ * An array of all well-known predefined system configurations.
+ * @public
+ */
+exports.allPredefinedSystemConfigurations = [
+    'default',
+    'language-priority',
+    'territory-priority',
+    'extended-example'
+];
+__exportStar(require("./predefined"), exports);
+const predefinedDecls = {
+    default: predefined_1.Default.DefaultSystemConfiguration,
+    'language-priority': predefined_1.Default.LanguagePrioritySystemConfiguration,
+    'territory-priority': predefined_1.Default.TerritoryPrioritySystemConfiguration,
+    'extended-example': predefined_1.Example.ExtendedSystemConfiguration
+};
+/**
+ * Returns the {@link Config.Model.ISystemConfiguration | system configuration} declaration for the
+ * specified predefined system configuration.
+ * @param name - The name of the predefined system configuration.
+ * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.
+ * @returns `Success` with the {@link Config.Model.ISystemConfiguration | system configuration}
+ * declaration if successful, `Failure` with an error message otherwise.
+ * @public
+ */
+function getPredefinedDeclaration(name, initParams) {
+    if (name in predefinedDecls) {
+        const baseConfig = (0, ts_json_base_1.sanitizeJsonObject)(predefinedDecls[name]);
+        if (initParams === null || initParams === void 0 ? void 0 : initParams.qualifierDefaultValues) {
+            return baseConfig.onSuccess((config) => (0, systemConfiguration_1.updateSystemConfigurationQualifierDefaultValues)(config, initParams.qualifierDefaultValues));
+        }
+        return baseConfig;
+    }
+    return (0, ts_utils_1.fail)(`Unknown predefined system configuration: ${name}`);
+}
+/**
+ * Returns the {@link Config.SystemConfiguration | SystemConfiguration} for the specified
+ * predefined system configuration.
+ * @param name - The name of the predefined system configuration.
+ * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.
+ * @returns `Success` with the {@link Config.SystemConfiguration | SystemConfiguration}
+ * if successful, `Failure` with an error message otherwise.
+ * @public
+ */
+function getPredefinedSystemConfiguration(name, initParams) {
+    if (name in predefinedDecls) {
+        return systemConfiguration_1.SystemConfiguration.create(predefinedDecls[name], initParams);
+    }
+    return (0, ts_utils_1.fail)(`Unknown predefined system configuration: ${name}`);
+}
+//# sourceMappingURL=common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/config/common.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;AAmDH,4DAeC;AAWD,4EASC;AApFD,4CAA6C;AAE7C,+DAI+B;AAC/B,oDAAuD;AACvD,6CAAgD;AAYhD;;;GAGG;AACU,QAAA,iCAAiC,GAAiD;IAC7F,SAAS;IACT,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;CACnB,CAAC;AAEF,+CAA6B;AAE7B,MAAM,eAAe,GAAgE;IACnF,OAAO,EAAE,oBAAO,CAAC,0BAA0B;IAC3C,mBAAmB,EAAE,oBAAO,CAAC,mCAAmC;IAChE,oBAAoB,EAAE,oBAAO,CAAC,oCAAoC;IAClE,kBAAkB,EAAE,oBAAO,CAAC,2BAA2B;CACxD,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CACtC,IAAmC,EACnC,UAA2C;IAE3C,IAAI,IAAI,IAAI,eAAe,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,IAAA,iCAAkB,EAAC,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,IAAA,qEAA+C,EAAC,MAAM,EAAE,UAAU,CAAC,sBAAuB,CAAC,CAC5F,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,IAAA,eAAI,EAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,gCAAgC,CAC9C,IAAmC,EACnC,UAA2C;IAE3C,IAAI,IAAI,IAAI,eAAe,EAAE,CAAC;QAC5B,OAAO,yCAAmB,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,IAAA,eAAI,EAAC,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\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/lib/packlets/config/convert.d.ts

@@ -0,0 +1,14 @@
+import { ISystemConfiguration } from './json';
+/**
+ * A `Converter` for {@link Config.Model.ISystemConfiguration | ISystemConfiguration} objects.
+ * @returns A `Converter` for {@link Config.Model.ISystemConfiguration | ISystemConfiguration} objects.
+ * @public
+ */
+export declare const systemConfiguration: import("@fgv/ts-utils").ObjectConverter<ISystemConfiguration, unknown>;
+/**
+ * A `Converter` for {@link Config.PredefinedSystemConfiguration | PredefinedSystemConfiguration} values.
+ * @returns A `Converter` for {@link Config.PredefinedSystemConfiguration | PredefinedSystemConfiguration} values.
+ * @public
+ */
+export declare const predefinedSystemConfiguration: import("@fgv/ts-utils").Converter<import("./common").PredefinedSystemConfiguration, readonly import("./common").PredefinedSystemConfiguration[]>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/packlets/config/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/packlets/config/convert.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAM9C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,wEAM9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,kJAAgE,CAAC"}