@fgv/ts-res 4.5.0-0

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

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

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

@@ -0,0 +1,65 @@
+import { Collections, Result, ValidatingCollector } from '@fgv/ts-utils';
+import { ConditionCollector } from './conditionCollector';
+import { IConditionSetDecl } from './conditionSetDecls';
+import { ConditionSet } from './conditionSet';
+import { ConditionSetIndex } from '../common';
+/**
+ * Parameters for creating a {@link Conditions.ConditionSetCollector | ConditionSetCollector}.
+ * @public
+ */
+export interface IConditionSetCollectorCreateParams {
+    /**
+     * The {@link Conditions.ConditionCollector | ConditionCollector} used to create conditions
+     * for conditions in this collector.
+     */
+    conditions: ConditionCollector;
+    /**
+     * Optional array of {@link Conditions.IConditionSetDecl | condition set declarations} to add to
+     * the collector.
+     */
+    conditionSets?: IConditionSetDecl[];
+}
+/**
+ * A `ValidatingCollector` for {@link Conditions.ConditionSet | ConditionSets},
+ * which collects condition sets supplied as {@link Conditions.ConditionSet | ConditionSet} or
+ * as {@link Conditions.IConditionSetDecl | IConditionSetDecl} via the methods on the
+ * `validating` property.
+ * @public
+ */
+export declare class ConditionSetCollector extends ValidatingCollector<ConditionSet> {
+    /**
+     * Gets the {@link Conditions.ConditionCollector | ConditionCollector} used to create conditions
+     * for conditions in this collector.
+     */
+    conditions: ConditionCollector;
+    /**
+     * Gets the {@link Conditions.ConditionSet | ConditionSet} at the unconditional
+     * condition set index.
+     */
+    get unconditionalConditionSet(): ConditionSet;
+    /**
+     * The index of the unconditional condition set.
+     */
+    static UnconditionalIndex: ConditionSetIndex;
+    /**
+     * Creates a new {@link Conditions.ConditionSetCollector | ConditionSetCollector}.
+     * @param params - {@link Conditions.IConditionSetCollectorCreateParams | Parameters} used to create
+     * the collector.
+     */
+    protected constructor(params: IConditionSetCollectorCreateParams);
+    /**
+     * Creates a new {@link Conditions.ConditionSetCollector | ConditionSetCollector}.
+     * @param params - {@link Conditions.IConditionSetCollectorCreateParams | Parameters} used to create
+     * the collector.
+     * @returns `Success` with the new collector if successful, or `Failure` with an error message
+     * if not.
+     */
+    static create(params: IConditionSetCollectorCreateParams): Result<ConditionSetCollector>;
+    private _toConditionSet;
+}
+/**
+ * A read-only {@link Conditions.ConditionSetCollector | ConditionSetCollector}.
+ * @public
+ */
+export type ReadOnlyConditionSetCollector = Collections.IReadOnlyValidatingCollector<ConditionSet>;
+//# sourceMappingURL=conditionSetCollector.d.ts.map

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

@@ -0,0 +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"}

package/lib/packlets/conditions/conditionSetCollector.js

@@ -0,0 +1,90 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionSetCollector = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const conditionSet_1 = require("./conditionSet");
+const convert_1 = require("./convert");
+const common_1 = require("../common");
+/**
+ * A `ValidatingCollector` for {@link Conditions.ConditionSet | ConditionSets},
+ * which collects condition sets supplied as {@link Conditions.ConditionSet | ConditionSet} or
+ * as {@link Conditions.IConditionSetDecl | IConditionSetDecl} via the methods on the
+ * `validating` property.
+ * @public
+ */
+class ConditionSetCollector extends ts_utils_1.ValidatingCollector {
+    /**
+     * Gets the {@link Conditions.ConditionSet | ConditionSet} at the unconditional
+     * condition set index.
+     */
+    get unconditionalConditionSet() {
+        return this.getAt(ConditionSetCollector.UnconditionalIndex).orThrow();
+    }
+    /**
+     * Creates a new {@link Conditions.ConditionSetCollector | ConditionSetCollector}.
+     * @param params - {@link Conditions.IConditionSetCollectorCreateParams | Parameters} used to create
+     * the collector.
+     */
+    constructor(params) {
+        var _a;
+        super({
+            converters: new ts_utils_1.Collections.KeyValueConverters({
+                key: common_1.Convert.conditionSetKey,
+                value: (from) => this._toConditionSet(from)
+            })
+        });
+        this.conditions = params.conditions;
+        // 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();
+        (_a = params.conditionSets) === null || _a === void 0 ? void 0 : _a.forEach((item) => this.validating.add(item).orThrow());
+    }
+    /**
+     * Creates a new {@link Conditions.ConditionSetCollector | ConditionSetCollector}.
+     * @param params - {@link Conditions.IConditionSetCollectorCreateParams | Parameters} used to create
+     * the collector.
+     * @returns `Success` with the new collector if successful, or `Failure` with an error message
+     * if not.
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new ConditionSetCollector(params));
+    }
+    _toConditionSet(from) {
+        if (from instanceof conditionSet_1.ConditionSet) {
+            return (0, ts_utils_1.succeed)(from);
+        }
+        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 }));
+        }
+        return convert_1.validatedConditionSetDecl
+            .convert(from, { conditions: this.conditions, conditionSetIndex: this.size })
+            .onSuccess((c) => conditionSet_1.ConditionSet.create(c));
+    }
+}
+exports.ConditionSetCollector = ConditionSetCollector;
+/**
+ * The index of the unconditional condition set.
+ */
+ConditionSetCollector.UnconditionalIndex = common_1.Validate.toConditionSetIndex(0).orThrow();
+//# sourceMappingURL=conditionSetCollector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetCollector.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionSetCollector.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,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"]}

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

@@ -0,0 +1,18 @@
+import { Condition } from './condition';
+import { IConditionDecl } from './conditionDecls';
+/**
+ * Non-validated declaration of a {@link Conditions.ConditionSet | set of conditions}.
+ * @public
+ */
+export interface IConditionSetDecl {
+    conditions: IConditionDecl[];
+}
+/**
+ * Validated declaration of a {@link Conditions.ConditionSet | set of conditions}.
+ * @public
+ */
+export interface IValidatedConditionSetDecl {
+    conditions: ReadonlyArray<Condition>;
+    index?: number;
+}
+//# sourceMappingURL=conditionSetDecls.d.ts.map

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

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

package/lib/packlets/conditions/conditionSetDecls.js

@@ -0,0 +1,24 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=conditionSetDecls.js.map

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

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

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

@@ -0,0 +1,86 @@
+import { Result } from '@fgv/ts-utils';
+import { Helpers as CommonHelpers } from '../common';
+import { IValidatedConditionDecl } from './conditionDecls';
+import { IReadOnlyQualifierCollector, Qualifier } from '../qualifiers';
+/**
+ * Helper class to parse and validate condition tokens.
+ * @public
+ */
+export declare class ConditionTokens {
+    /**
+     * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to validate
+     * qualifier names and values.
+     */
+    readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Constructs a new {@link Conditions.ConditionTokens | ConditionTokens } instance.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     */
+    constructor(qualifiers: IReadOnlyQualifierCollector);
+    /**i
+     * Parses a {@link ConditionToken | condition token} string and validates the parts
+     * against the qualifiers present in the {@link Conditions.ConditionTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the {@link Conditions.IValidatedConditionDecl | validated condition declaration}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseConditionToken(token: string): Result<IValidatedConditionDecl>;
+    /**
+     * Parses a {@link ConditionSetToken | condition set token} string and validates the parts
+     * against the qualifiers present in the {@link Conditions.ConditionTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the array of {@link Conditions.IValidatedConditionDecl | validated condition declarations}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseConditionSetToken(token: string): Result<IValidatedConditionDecl[]>;
+    /**
+     * Validates the {@link Helpers.IConditionTokenParts | parts} of a {@link ConditionToken | condition token}.
+     * @param parts - the parts to validate
+     * @returns `Success` with the validated declaration if successful, `Failure` with an error message if not.
+     */
+    validateConditionTokenParts(parts: CommonHelpers.IConditionTokenParts): Result<IValidatedConditionDecl>;
+    /**
+     * Given a value, finds a single token-optional qualifier that matches the value.
+     * Fails if no qualifiers match, or if more than one qualifier matches.
+     * @param value - the value to match.
+     * @returns `Success` with the matching qualifier if successful, `Failure` with an error message if not.
+     */
+    findQualifierForValue(value: string): Result<Qualifier>;
+    /**
+     * Parses a {@link ConditionToken | condition token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with a {@link Conditions.IValidatedConditionDecl | validated condition declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static parseConditionToken(token: string, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedConditionDecl>;
+    /**
+     * Parses a {@link ConditionSetToken | condition set token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with an array of {@link Conditions.IValidatedConditionDecl | validated condition declarations}
+     * if successful, `Failure` with an error message if not
+     */
+    static parseConditionSetToken(token: string, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedConditionDecl[]>;
+    /**
+     * Validates the parts of a condition token against the qualifiers present in the supplied
+     * {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param parts - the {@link Helpers.IConditionTokenParts | condition token parts} to validate.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to
+     * validate qualifier names and values.
+     * @returns `Success` with a {@link Conditions.IValidatedConditionDecl | validated condition declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static validateConditionTokenParts(parts: CommonHelpers.IConditionTokenParts, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedConditionDecl>;
+    /**
+     * Given a value and a set of qualifiers, finds a single token-optional qualifier that matches the value.
+     * Fails if no qualifiers match, or if more than one qualifier matches.
+     * @param value - the value to match.
+     * @param qualifiers - the qualifiers to match against.
+     * @returns `Success` with the matching qualifier if successful, `Failure` with an error message if not.
+     */
+    static findQualifierForValue(value: string, qualifiers: IReadOnlyQualifierCollector): Result<Qualifier>;
+}
+//# sourceMappingURL=conditionToken.d.ts.map

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

@@ -0,0 +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"}

package/lib/packlets/conditions/conditionToken.js

@@ -0,0 +1,150 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionTokens = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+/**
+ * Helper class to parse and validate condition tokens.
+ * @public
+ */
+class ConditionTokens {
+    /**
+     * Constructs a new {@link Conditions.ConditionTokens | ConditionTokens } instance.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     */
+    constructor(qualifiers) {
+        this.qualifiers = qualifiers;
+    }
+    /**i
+     * Parses a {@link ConditionToken | condition token} string and validates the parts
+     * against the qualifiers present in the {@link Conditions.ConditionTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the {@link Conditions.IValidatedConditionDecl | validated condition declaration}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseConditionToken(token) {
+        return ConditionTokens.parseConditionToken(token, this.qualifiers);
+    }
+    /**
+     * Parses a {@link ConditionSetToken | condition set token} string and validates the parts
+     * against the qualifiers present in the {@link Conditions.ConditionTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the array of {@link Conditions.IValidatedConditionDecl | validated condition declarations}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseConditionSetToken(token) {
+        return ConditionTokens.parseConditionSetToken(token, this.qualifiers);
+    }
+    /**
+     * Validates the {@link Helpers.IConditionTokenParts | parts} of a {@link ConditionToken | condition token}.
+     * @param parts - the parts to validate
+     * @returns `Success` with the validated declaration if successful, `Failure` with an error message if not.
+     */
+    validateConditionTokenParts(parts) {
+        return ConditionTokens.validateConditionTokenParts(parts, this.qualifiers);
+    }
+    /**
+     * Given a value, finds a single token-optional qualifier that matches the value.
+     * Fails if no qualifiers match, or if more than one qualifier matches.
+     * @param value - the value to match.
+     * @returns `Success` with the matching qualifier if successful, `Failure` with an error message if not.
+     */
+    findQualifierForValue(value) {
+        return ConditionTokens.findQualifierForValue(value, this.qualifiers);
+    }
+    /**
+     * Parses a {@link ConditionToken | condition token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with a {@link Conditions.IValidatedConditionDecl | validated condition declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static parseConditionToken(token, qualifiers) {
+        return common_1.Helpers.parseConditionTokenParts(token).onSuccess((parts) => {
+            return ConditionTokens.validateConditionTokenParts(parts, qualifiers);
+        });
+    }
+    /**
+     * Parses a {@link ConditionSetToken | condition set token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with an array of {@link Conditions.IValidatedConditionDecl | validated condition declarations}
+     * if successful, `Failure` with an error message if not
+     */
+    static parseConditionSetToken(token, qualifiers) {
+        return common_1.Helpers.parseConditionSetTokenParts(token).onSuccess((parts) => {
+            return (0, ts_utils_1.mapResults)(parts.map((part) => ConditionTokens.validateConditionTokenParts(part, qualifiers)));
+        });
+    }
+    /**
+     * Validates the parts of a condition token against the qualifiers present in the supplied
+     * {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param parts - the {@link Helpers.IConditionTokenParts | condition token parts} to validate.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to
+     * validate qualifier names and values.
+     * @returns `Success` with a {@link Conditions.IValidatedConditionDecl | validated condition declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static validateConditionTokenParts(parts, qualifiers) {
+        const qualifierLookup = parts.qualifier === undefined
+            ? ConditionTokens.findQualifierForValue(parts.value, qualifiers)
+            : qualifiers.getByNameOrToken(parts.qualifier);
+        return qualifierLookup.onSuccess((qualifier) => {
+            return qualifier.type
+                .validateCondition(parts.value)
+                .onSuccess((value) => {
+                const operator = 'matches';
+                const priority = qualifier.defaultPriority;
+                return (0, ts_utils_1.succeed)({ qualifier, value, operator, priority });
+            })
+                .withDetail('failure', 'success');
+        });
+    }
+    /**
+     * Given a value and a set of qualifiers, finds a single token-optional qualifier that matches the value.
+     * Fails if no qualifiers match, or if more than one qualifier matches.
+     * @param value - the value to match.
+     * @param qualifiers - the qualifiers to match against.
+     * @returns `Success` with the matching qualifier if successful, `Failure` with an error message if not.
+     */
+    static findQualifierForValue(value, qualifiers) {
+        const matched = [];
+        for (const qualifier of qualifiers.values()) {
+            if (qualifier.tokenIsOptional && qualifier.type.validateCondition(value).isSuccess()) {
+                matched.push(qualifier);
+            }
+        }
+        if (matched.length === 0) {
+            return (0, ts_utils_1.fail)(`${value}: does not match any qualifier`);
+        }
+        if (matched.length > 1) {
+            return (0, ts_utils_1.fail)(`${value}: matches multiple qualifiers (${matched.map((q) => q.name).join(', ')})`);
+        }
+        return (0, ts_utils_1.succeed)(matched[0]);
+    }
+}
+exports.ConditionTokens = ConditionTokens;
+//# sourceMappingURL=conditionToken.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditionToken.js","sourceRoot":"","sources":["../../../src/packlets/conditions/conditionToken.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAkE;AAClE,sCAAwE;AAIxE;;;GAGG;AACH,MAAa,eAAe;IAO1B;;;OAGG;IACH,YAAmB,UAAuC;QACxD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACI,mBAAmB,CAAC,KAAa;QACtC,OAAO,eAAe,CAAC,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;OAMG;IACI,sBAAsB,CAAC,KAAa;QACzC,OAAO,eAAe,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACI,2BAA2B,CAChC,KAAyC;QAEzC,OAAO,eAAe,CAAC,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACI,qBAAqB,CAAC,KAAa;QACxC,OAAO,eAAe,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACvE,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,mBAAmB,CAC/B,KAAa,EACb,UAAuC;QAEvC,OAAO,gBAAa,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YACvE,OAAO,eAAe,CAAC,2BAA2B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,sBAAsB,CAClC,KAAa,EACb,UAAuC;QAEvC,OAAO,gBAAa,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1E,OAAO,IAAA,qBAAU,EAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,2BAA2B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,2BAA2B,CACvC,KAAyC,EACzC,UAAuC;QAEvC,MAAM,eAAe,GACnB,KAAK,CAAC,SAAS,KAAK,SAAS;YAC3B,CAAC,CAAC,eAAe,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC;YAChE,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEnD,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YAC7C,OAAO,SAAS,CAAC,IAAI;iBAClB,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC;iBAC9B,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;gBACnB,MAAM,QAAQ,GAAsB,SAAS,CAAC;gBAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,eAAe,CAAC;gBAC3C,OAAO,IAAA,kBAAO,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3D,CAAC,CAAC;iBACD,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,qBAAqB,CACjC,KAAa,EACb,UAAuC;QAEvC,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,IAAI,SAAS,CAAC,eAAe,IAAI,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;gBACrF,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAA,eAAI,EAAC,GAAG,KAAK,gCAAgC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,IAAA,eAAI,EAAC,GAAG,KAAK,kCAAkC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,IAAA,kBAAO,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;CACF;AAnJD,0CAmJC","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"]}

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

@@ -0,0 +1,24 @@
+import { IConditionSetDecl, IValidatedConditionSetDecl } from '../conditionSetDecls';
+import { ConditionCollector } from '../conditionCollector';
+/**
+ * Converter which converts to a {@link Conditions.IConditionSetDecl | condition set declaration}.
+ * @public
+ */
+export declare const conditionSetDecl: import("@fgv/ts-utils").ObjectConverter<IConditionSetDecl, unknown>;
+/**
+ * Context for converting a {@link Conditions.IConditionSetDecl | condition set declaration}
+ * into an instantiated {@link Conditions.ConditionSet | condition set} object.
+ * @public
+ */
+export interface IConditionSetDeclConvertContext {
+    readonly conditions: ConditionCollector;
+    conditionSetIndex?: number;
+}
+/**
+ * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}
+ * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name
+ * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.
+ * @public
+ */
+export declare const validatedConditionSetDecl: import("@fgv/ts-utils").Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>;
+//# sourceMappingURL=conditionSetDecls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetDecls.d.ts","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,qEAE3B,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,gGAkBpC,CAAC"}

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

@@ -0,0 +1,54 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatedConditionSetDecl = exports.conditionSetDecl = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const decls_1 = require("./decls");
+/* eslint-disable @rushstack/typedef-var */
+/**
+ * Converter which converts to a {@link Conditions.IConditionSetDecl | condition set declaration}.
+ * @public
+ */
+exports.conditionSetDecl = ts_utils_1.Converters.strictObject({
+    conditions: ts_utils_1.Converters.arrayOf(decls_1.conditionDecl)
+});
+/**
+ * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}
+ * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name
+ * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.
+ * @public
+ */
+exports.validatedConditionSetDecl = ts_utils_1.Converters.generic((from, __self, context) => {
+    /* c8 ignore next 3 - coverage is having a bad day */
+    if (!context) {
+        return (0, ts_utils_1.fail)('validatedConditionSetDecl converter requires a context');
+    }
+    return exports.conditionSetDecl.convert(from).onSuccess((decl) => {
+        return (0, ts_utils_1.mapResults)(decl.conditions.map((condition) => context.conditions.validating.getOrAdd(condition))).onSuccess((conditions) => {
+            /* c8 ignore next 1 - coverage having issues */
+            const index = context.conditionSetIndex ? context.conditionSetIndex++ : undefined;
+            return (0, ts_utils_1.succeed)({ conditions, index });
+        });
+    });
+});
+//# sourceMappingURL=conditionSetDecls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetDecls.js","sourceRoot":"","sources":["../../../../src/packlets/conditions/convert/conditionSetDecls.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAA8E;AAE9E,mCAAwC;AAGxC,2CAA2C;AAE3C;;;GAGG;AACU,QAAA,gBAAgB,GAAG,qBAAU,CAAC,YAAY,CAAoB;IACzE,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,qBAAa,CAAC;CAC9C,CAAC,CAAC;AAYH;;;;;GAKG;AACU,QAAA,yBAAyB,GAAG,qBAAU,CAAC,OAAO,CAGzD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAyC,EAAsC,EAAE;IACzG,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAA,eAAI,EAAC,wDAAwD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,wBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACvD,OAAO,IAAA,qBAAU,EACf,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACtF,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACzB,+CAA+C;YAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAClF,OAAO,IAAA,kBAAO,EAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converters, Result, fail, mapResults, succeed } from '@fgv/ts-utils';\nimport { IConditionSetDecl, IValidatedConditionSetDecl } from '../conditionSetDecls';\nimport { conditionDecl } from './decls';\nimport { ConditionCollector } from '../conditionCollector';\n\n/* eslint-disable @rushstack/typedef-var */\n\n/**\n * Converter which converts to a {@link Conditions.IConditionSetDecl | condition set declaration}.\n * @public\n */\nexport const conditionSetDecl = Converters.strictObject<IConditionSetDecl>({\n  conditions: Converters.arrayOf(conditionDecl)\n});\n\n/**\n * Context for converting a {@link Conditions.IConditionSetDecl | condition set declaration}\n * into an instantiated {@link Conditions.ConditionSet | condition set} object.\n * @public\n */\nexport interface IConditionSetDeclConvertContext {\n  readonly conditions: ConditionCollector;\n  conditionSetIndex?: number;\n}\n\n/**\n * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}\n * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name\n * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.\n * @public\n */\nexport const validatedConditionSetDecl = Converters.generic<\n  IValidatedConditionSetDecl,\n  IConditionSetDeclConvertContext\n>((from: unknown, __self, context?: IConditionSetDeclConvertContext): Result<IValidatedConditionSetDecl> => {\n  /* c8 ignore next 3 - coverage is having a bad day */\n  if (!context) {\n    return fail('validatedConditionSetDecl converter requires a context');\n  }\n\n  return conditionSetDecl.convert(from).onSuccess((decl) => {\n    return mapResults(\n      decl.conditions.map((condition) => context.conditions.validating.getOrAdd(condition))\n    ).onSuccess((conditions) => {\n      /* c8 ignore next 1 - coverage having issues */\n      const index = context.conditionSetIndex ? context.conditionSetIndex++ : undefined;\n      return succeed({ conditions, index });\n    });\n  });\n});\n"]}