@fgv/ts-res 5.0.1-9 → 5.0.1

package/dist/packlets/context/convert/index.js

@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+export * from './decls';
+//# sourceMappingURL=index.js.map

package/dist/packlets/context/index.js

@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+import * as Convert from './convert';
+export * from './contextDecls';
+export * from './contextToken';
+export { Convert };
+//# sourceMappingURL=index.js.map

package/dist/packlets/decisions/abstractDecision.js

@@ -0,0 +1,68 @@
+/*
+ * 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.
+ */
+import { captureResult } from '@fgv/ts-utils';
+import { Candidate } from './candidate';
+import { Decision } from './decision';
+/**
+ * An abstract decision represents a class of decisions with candidates
+ * that differ only in value.  It is a {@link Decisions.Decision | IDecision<number>}
+ * in which the `number` values are sequentially assigned indexes.
+ * This allows us to represent each related {@link Decisions.IDecision | decision} as an
+ * {@link Decisions.AbstractDecision | abstract decision} and a matching array containing
+ * the corresponding value for each candidate.  This representation is highly cacheable.
+ * @public
+ */
+export class AbstractDecision extends Decision {
+    /**
+     * Constructor for an {@link Decisions.AbstractDecision | AbstractDecision} object.
+     * @param params - {@link Decisions.IAbstractDecisionCreateParams | Parameters}
+     * used to create the decision.
+     * @public
+     */
+    constructor(params) {
+        const candidates = Array.from(params.conditionSets)
+            .map((conditionSet, value) => Candidate.createCandidate({ conditionSet, value }).orThrow())
+            .sort(Candidate.compare);
+        super({ candidates, index: params.index, isAbstract: true });
+    }
+    /**
+     * Creates a new {@link Decisions.AbstractDecision | AbstractDecision} object.
+     * @param params - {@link Decisions.IAbstractDecisionCreateParams | Parameters}
+     * used to create the decision.
+     * @returns `Success` with the new decision if successful, or `Failure` with an
+     * error message if not.
+     * @public
+     */
+    static createAbstractDecision(params) {
+        return captureResult(() => new AbstractDecision(params));
+    }
+    /**
+     * Converts this abstract decision to a compiled abstract decision representation.
+     * @param options - Optional compilation options controlling the output format.
+     * @returns A compiled abstract decision object that can be used for serialization or runtime processing.
+     * @public
+     */
+    toCompiled(options) {
+        return Object.assign({ conditionSets: this.candidates.map((c) => c.conditionSet.index) }, ((options === null || options === void 0 ? void 0 : options.includeMetadata) === true ? { metadata: { key: this.key } } : {}));
+    }
+}
+//# sourceMappingURL=abstractDecision.js.map

package/dist/packlets/decisions/abstractDecisionCollector.js

@@ -0,0 +1,90 @@
+/*
+ * 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.
+ */
+import { captureResult, Collections, fail, succeed, ValidatingCollector } from '@fgv/ts-utils';
+import { AbstractDecision } from './abstractDecision';
+import { Convert as CommonConvert, Validate } from '../common';
+import { ConditionSet } from '../conditions';
+/**
+ * A `ValidatingCollector` for {@link Decisions.AbstractDecision | AbstractDecisions}.
+ * @public
+ */
+export class AbstractDecisionCollector extends ValidatingCollector {
+    /**
+     * The empty decision (no condition sets) for this collector.
+     */
+    get emptyDecision() {
+        return this.getAt(AbstractDecisionCollector.EmptyDecisionIndex).orThrow();
+    }
+    /**
+     * The default-only decision (one condition set with no conditions) for this collector.
+     */
+    get defaultOnlyDecision() {
+        return this.getAt(AbstractDecisionCollector.DefaultOnlyDecisionIndex).orThrow();
+    }
+    /**
+     * Creates a new instance of {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector}.
+     */
+    constructor(params) {
+        super({
+            converters: new Collections.KeyValueConverters({
+                key: CommonConvert.decisionKey,
+                value: (from) => this._toAbstractDecision(from)
+            })
+        });
+        this.conditionSets = params.conditionSets;
+        this.add(AbstractDecision.createAbstractDecision({ conditionSets: [] }).orThrow()).orThrow();
+        const cs = this.conditionSets.validating.get('').orThrow();
+        this.add(AbstractDecision.createAbstractDecision({ conditionSets: [cs] }).orThrow()).orThrow();
+    }
+    /**
+     * Creates a new instance of {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector}.
+     * @returns `Success` with the new instance, or `Failure` with an error if the instance could not be created.
+     */
+    static create(params) {
+        return captureResult(() => new AbstractDecisionCollector(params));
+    }
+    _toAbstractDecision(from) {
+        /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */
+        if (from instanceof AbstractDecision) {
+            return succeed(from);
+        }
+        if (this._isConditionSetArray(from)) {
+            return AbstractDecision.createAbstractDecision({
+                conditionSets: from
+            });
+        }
+        /* c8 ignore next 2 - functional code path tested but coverage intermittently missed */
+        return fail('invalid value: not an abstract decision or condition sets');
+    }
+    _isConditionSetArray(from) {
+        return Array.isArray(from) && from.every((e) => e instanceof ConditionSet);
+    }
+}
+/**
+ * The index for the empty decision.
+ */
+AbstractDecisionCollector.EmptyDecisionIndex = Validate.toDecisionIndex(0).orThrow();
+/**
+ * The index for the default-only decision.
+ */
+AbstractDecisionCollector.DefaultOnlyDecisionIndex = Validate.toDecisionIndex(1).orThrow();
+//# sourceMappingURL=abstractDecisionCollector.js.map

package/dist/packlets/decisions/candidate.js

@@ -0,0 +1,76 @@
+/*
+ * 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.
+ */
+import { ConditionSet } from '../conditions';
+import { captureResult } from '@fgv/ts-utils';
+/**
+ * Simple implementation of {@link Decisions.ICandidate | ICandidate} with
+ * helper methods for sorting and presentation.
+ * @public
+ */
+export class Candidate {
+    /**
+     * Key of the condition set for this candidate.
+     */
+    get key() {
+        return this.conditionSet.key;
+    }
+    /**
+     * Construct a new {@link Decisions.Candidate | Candidate}.
+     * @param params - The {@link Decisions.ICandidate | parameters} to use to create the
+     * new candidate.
+     */
+    constructor(params) {
+        var _a;
+        this.conditionSet = params.conditionSet;
+        this.value = params.value;
+        this.isPartial = params.isPartial === true;
+        this.mergeMethod = (_a = params.mergeMethod) !== null && _a !== void 0 ? _a : 'augment';
+    }
+    /**
+     * Create a new {@link Decisions.Candidate | candidate}.
+     * @param params - The {@link Decisions.ICandidate | parameters} to use to create the
+     * new candidate.
+     * @returns `Success` with the new candidate if successful, or `Failure` if the
+     * candidate could not be created.
+     */
+    static createCandidate(params) {
+        return captureResult(() => new Candidate(params));
+    }
+    /**
+     * Compare two {@link Decisions.ICandidate | candidates} for sorting purposes.
+     * @param c1 - The first candidate to compare.
+     * @param c2 - The second candidate to compare.
+     * @returns A negative number if c1 should come before c2, a positive number if c1 should
+     * come after c2, or zero if they are equivalent.
+     */
+    static compare(c1, c2) {
+        return ConditionSet.compare(c1.conditionSet, c2.conditionSet);
+    }
+    /**
+     * Returns a string representation of the {@link Decisions.Candidate | candidate}.
+     * @returns A string representation of this candidate.
+     */
+    toString() {
+        return `${this.key}: ${JSON.stringify(this.value)}`;
+    }
+}
+//# sourceMappingURL=candidate.js.map

package/dist/packlets/decisions/common.js

@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/packlets/decisions/concreteDecision.js

@@ -0,0 +1,111 @@
+/*
+ * 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.
+ */
+import { Candidate } from './candidate';
+import { captureResult, Collections, mapResults, fail, succeed } from '@fgv/ts-utils';
+import { ConditionSet } from '../conditions';
+import { Convert as CommonConvert } from '../common';
+import { Decision } from './decision';
+/**
+ * A {@link Decisions.ConcreteDecision | concrete decision} is a {@link Decisions.IDecision | decision}
+ * implemented as a reference to a common {@link Decisions.AbstractDecision | abstract decision} and a list of
+ * values that correspond to the candidates in the abstract decision.  This allows us to represent a large
+ * number of related decisions with a single abstract decision and a list of values.
+ * @public
+ */
+export class ConcreteDecision {
+    /**
+     * Unique global key for this decision, derived from the condition set and
+     * candidate values.
+     */
+    get key() {
+        return this._collectible.key;
+    }
+    /**
+     * Unique global index for this decision.
+     */
+    get index() {
+        return this._collectible.index;
+    }
+    /**
+     * Constructor for a {@link Decisions.ConcreteDecision | ConcreteDecision} object.
+     * @param params - {@link Decisions.IConcreteDecisionConstructorParams | Parameters}
+     * used to create the decision.
+     * @public
+     */
+    constructor(params) {
+        this.baseDecision = params.baseDecision;
+        this.values = params.values;
+        this.candidates = this.baseDecision.candidates.map((candidate) => {
+            const value = this.values[candidate.value];
+            return Candidate.createCandidate({ conditionSet: candidate.conditionSet, value }).orThrow();
+        });
+        this._collectible = new Collections.Collectible({
+            key: Decision.getKey(this.candidates),
+            index: params.index,
+            indexConverter: CommonConvert.decisionIndex
+        });
+    }
+    /**
+     * Creates a new {@link Decisions.ConcreteDecision | ConcreteDecision} object.
+     * @param params - {@link Decisions.IConcreteDecisionCreateParams | Parameters}
+     * used to create the decision.
+     * @returns `Success` with the new decision if successful, or `Failure` with an
+     * error message if not.
+     * @public
+     */
+    static create(params) {
+        const conditionSets = params.candidates
+            .map((candidate) => candidate.conditionSet)
+            .sort(ConditionSet.compare)
+            .reverse();
+        const getBase = params.decisions.validating.getOrAdd(conditionSets);
+        /* c8 ignore next 3 - defense in depth against internal error hard to repro */
+        if (getBase.isFailure()) {
+            return fail(getBase.message);
+        }
+        const baseDecision = getBase.value;
+        return mapResults(params.candidates.map((candidate, index) => {
+            /* c8 ignore next 5 - defense in depth against internal error hard to repro */
+            if (candidate.conditionSet.key !== baseDecision.candidates[index].conditionSet.key) {
+                return fail(`${candidate.conditionSet.key}: Candidate does not match base decision ${candidate.conditionSet.key}`);
+            }
+            return succeed(candidate.value);
+        })).onSuccess((values) => {
+            /* c8 ignore next 5 - defense in depth against invalid index conversion */
+            if (params.index) {
+                return CommonConvert.decisionIndex.convert(params.index).onSuccess((index) => {
+                    return captureResult(() => new ConcreteDecision({ baseDecision, values, index }));
+                });
+            }
+            return captureResult(() => new ConcreteDecision({ baseDecision, values }));
+        });
+    }
+    /**
+     * Sets the index for this decision.  Once set, index is immutable.
+     * @param index - The index to set.
+     * @returns `Success` with the new index if successful, or `Failure` with an error message if not.
+     */
+    setIndex(index) {
+        return this._collectible.setIndex(index);
+    }
+}
+//# sourceMappingURL=concreteDecision.js.map

package/dist/packlets/decisions/decision.js

@@ -0,0 +1,126 @@
+/*
+ * 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.
+ */
+import { captureResult, Collections, Hash } from '@fgv/ts-utils';
+import { Convert as CommonConvert } from '../common';
+import { Candidate } from './candidate';
+import { ConditionSet } from '../conditions';
+/**
+ * Simple collectible implementation of {@link Decisions.IDecision | IDecision}.
+ * @public
+ */
+export class Decision {
+    /**
+     * Unique global key for this decision, derived from the contents
+     * of the decision.
+     */
+    get key() {
+        return this._collectible.key;
+    }
+    /**
+     * Unique global index for this decision.
+     */
+    get index() {
+        return this._collectible.index;
+    }
+    /**
+     * Constructor for a {@link Decisions.Decision | Decision} object.
+     * @param params - {@link Decisions.IDecisionConstructorParams | Parameters} used to create the decision.
+     * @public
+     */
+    constructor(params) {
+        this.candidates = Array.from(params.candidates)
+            .map((c) => Candidate.createCandidate(c).orThrow())
+            .sort(Candidate.compare)
+            .reverse();
+        /* c8 ignore next 3 - coverage having a rough time */
+        const key = params.isAbstract
+            ? Decision.getAbstractKey(this.candidates.map((c) => c.conditionSet))
+            : Decision.getKey(this.candidates);
+        this._collectible = new Collections.Collectible({
+            key,
+            index: params.index,
+            indexConverter: CommonConvert.decisionIndex
+        });
+    }
+    /**
+     * Creates a new {@link Decisions.Decision | Decision} object.
+     * @param params - {@link Decisions.IDecisionCreateParams | Parameters} used to create the decision.
+     * @returns `Success` with the new decision if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    static createDecision(params) {
+        return captureResult(() => new Decision(Object.assign(Object.assign({}, params), { isAbstract: false })));
+    }
+    /**
+     * Sets the index for this decision.  Once set, index is immutable.
+     * @param index - The index to set.
+     * @returns `Success` with the new index if successful, or `Failure` with an error message if not.
+     * @public
+     */
+    setIndex(index) {
+        return this._collectible.setIndex(index);
+    }
+    /**
+     * Helper function to return a stable key for a the condition sets that
+     * make up a {@link Decisions.Decision | decision}.  The abstract
+     * key is a `+`-separated list of the hashes of the sorted condition sets
+     * that make up the decision.
+     * @param conditionSets - The condition sets to use to create the key.
+     * @returns A key derived from the condition set hashes.
+     * @public
+     */
+    static getAbstractKey(conditionSets) {
+        return CommonConvert.decisionKey
+            .convert(Array.from(conditionSets)
+            .sort(ConditionSet.compare)
+            .reverse()
+            .map((c) => c.toHash())
+            .join('+'))
+            .orThrow();
+    }
+    /**
+     * Helper function to return a stable key for a set of condition sets.
+     * @param conditionSets - The condition sets to use to create the key.
+     * @returns A key derived from the condition set hashes.
+     * @public
+     */
+    static getKey(candidates) {
+        if (candidates.length === 0) {
+            /* c8 ignore next 2 - functional code path tested but coverage intermittently missed */
+            return Decision.EmptyDecisionKey;
+        }
+        const abstractKey = Decision.getAbstractKey(candidates.map((c) => c.conditionSet));
+        const valueKey = Hash.Crc32Normalizer.crc32Hash(candidates.map((c) => JSON.stringify(c.value)));
+        return CommonConvert.decisionKey.convert(`${abstractKey}|${valueKey}`).orThrow();
+    }
+}
+/**
+ * Key for the empty decision (no condition sets).
+ */
+Decision.EmptyDecisionKey = CommonConvert.decisionKey.convert('').orThrow();
+/**
+ * Key for the default-only decision (single condition set with no conditions).
+ */
+Decision.DefaultOnlyDecisionKey = CommonConvert.decisionKey
+    .convert('00000000')
+    .orThrow();
+//# sourceMappingURL=decision.js.map

package/dist/packlets/decisions/index.js

@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+export * from './common';
+export * from './candidate';
+export * from './decision';
+export * from './abstractDecision';
+export * from './abstractDecisionCollector';
+export * from './concreteDecision';
+//# sourceMappingURL=index.js.map