@fgv/ts-res 4.5.0-0

package/lib/packlets/decisions/candidate.d.ts

@@ -0,0 +1,58 @@
+import { JsonValue } from '@fgv/ts-json-base';
+import { ConditionSet } from '../conditions';
+import { Result } from '@fgv/ts-utils';
+import { ResourceValueMergeMethod } from '../common';
+/**
+ * A {@link Decisions.ICandidate | resource candidate} represents a single
+ * possible value for some resource, with the conditions under which it is valid.
+ * @public
+ */
+export interface ICandidate<TVALUE extends JsonValue = JsonValue> {
+    readonly conditionSet: ConditionSet;
+    readonly value: TVALUE;
+    readonly isPartial?: boolean;
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
+/**
+ * Simple implementation of {@link Decisions.ICandidate | ICandidate} with
+ * helper methods for sorting and presentation.
+ * @public
+ */
+export declare class Candidate<TVALUE extends JsonValue = JsonValue> implements ICandidate<TVALUE> {
+    readonly conditionSet: ConditionSet;
+    readonly value: TVALUE;
+    readonly isPartial: boolean;
+    readonly mergeMethod: ResourceValueMergeMethod;
+    /**
+     * Key of the condition set for this candidate.
+     */
+    get key(): string;
+    /**
+     * Construct a new {@link Decisions.Candidate | Candidate}.
+     * @param params - The {@link Decisions.ICandidate | parameters} to use to create the
+     * new candidate.
+     */
+    protected constructor(params: ICandidate<TVALUE>);
+    /**
+     * 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<TVALUE extends JsonValue>(params: ICandidate<TVALUE>): Result<Candidate<TVALUE>>;
+    /**
+     * 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: ICandidate, c2: ICandidate): number;
+    /**
+     * Returns a string representation of the {@link Decisions.Candidate | candidate}.
+     * @returns A string representation of this candidate.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=candidate.d.ts.map

package/lib/packlets/decisions/candidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.d.ts","sourceRoot":"","sources":["../../../src/packlets/decisions/candidate.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAiB,MAAM,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IAC9D,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;;GAIG;AACH,qBAAa,SAAS,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,UAAU,CAAC,MAAM,CAAC;IACxF,SAAgB,YAAY,EAAE,YAAY,CAAC;IAC3C,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,WAAW,EAAE,wBAAwB,CAAC;IAEtD;;OAEG;IACH,IAAW,GAAG,IAAI,MAAM,CAEvB;IAED;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;IAOhD;;;;;;OAMG;WACW,eAAe,CAAC,MAAM,SAAS,SAAS,EACpD,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GACzB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAI5B;;;;;;OAMG;WACW,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,MAAM;IAI7D;;;OAGG;IACI,QAAQ,IAAI,MAAM;CAG1B"}

package/lib/packlets/decisions/candidate.js

@@ -0,0 +1,80 @@
+"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.Candidate = void 0;
+const conditions_1 = require("../conditions");
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * Simple implementation of {@link Decisions.ICandidate | ICandidate} with
+ * helper methods for sorting and presentation.
+ * @public
+ */
+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 (0, ts_utils_1.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 conditions_1.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)}`;
+    }
+}
+exports.Candidate = Candidate;
+//# sourceMappingURL=candidate.js.map

package/lib/packlets/decisions/candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.js","sourceRoot":"","sources":["../../../src/packlets/decisions/candidate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAGH,8CAA6C;AAC7C,4CAAsD;AAetD;;;;GAIG;AACH,MAAa,SAAS;IAMpB;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,YAAsB,MAA0B;;QAC9C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC;QAC3C,IAAI,CAAC,WAAW,GAAG,MAAA,MAAM,CAAC,WAAW,mCAAI,SAAS,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,eAAe,CAC3B,MAA0B;QAE1B,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,OAAO,CAAC,EAAc,EAAE,EAAc;QAClD,OAAO,yBAAY,CAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,OAAO,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACtD,CAAC;CACF;AAxDD,8BAwDC","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 { JsonValue } from '@fgv/ts-json-base';\nimport { ConditionSet } from '../conditions';\nimport { captureResult, Result } from '@fgv/ts-utils';\nimport { ResourceValueMergeMethod } from '../common';\n\n/**\n * A {@link Decisions.ICandidate | resource candidate} represents a single\n * possible value for some resource, with the conditions under which it is valid.\n * @public\n */\nexport interface ICandidate<TVALUE extends JsonValue = JsonValue> {\n  readonly conditionSet: ConditionSet;\n  readonly value: TVALUE;\n  readonly isPartial?: boolean;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Simple implementation of {@link Decisions.ICandidate | ICandidate} with\n * helper methods for sorting and presentation.\n * @public\n */\nexport class Candidate<TVALUE extends JsonValue = JsonValue> implements ICandidate<TVALUE> {\n  public readonly conditionSet: ConditionSet;\n  public readonly value: TVALUE;\n  public readonly isPartial: boolean;\n  public readonly mergeMethod: ResourceValueMergeMethod;\n\n  /**\n   * Key of the condition set for this candidate.\n   */\n  public get key(): string {\n    return this.conditionSet.key;\n  }\n\n  /**\n   * Construct a new {@link Decisions.Candidate | Candidate}.\n   * @param params - The {@link Decisions.ICandidate | parameters} to use to create the\n   * new candidate.\n   */\n  protected constructor(params: ICandidate<TVALUE>) {\n    this.conditionSet = params.conditionSet;\n    this.value = params.value;\n    this.isPartial = params.isPartial === true;\n    this.mergeMethod = params.mergeMethod ?? 'augment';\n  }\n\n  /**\n   * Create a new {@link Decisions.Candidate | candidate}.\n   * @param params - The {@link Decisions.ICandidate | parameters} to use to create the\n   * new candidate.\n   * @returns `Success` with the new candidate if successful, or `Failure` if the\n   * candidate could not be created.\n   */\n  public static createCandidate<TVALUE extends JsonValue>(\n    params: ICandidate<TVALUE>\n  ): Result<Candidate<TVALUE>> {\n    return captureResult(() => new Candidate(params));\n  }\n\n  /**\n   * Compare two {@link Decisions.ICandidate | candidates} for sorting purposes.\n   * @param c1 - The first candidate to compare.\n   * @param c2 - The second candidate to compare.\n   * @returns A negative number if c1 should come before c2, a positive number if c1 should\n   * come after c2, or zero if they are equivalent.\n   */\n  public static compare(c1: ICandidate, c2: ICandidate): number {\n    return ConditionSet.compare(c1.conditionSet, c2.conditionSet);\n  }\n\n  /**\n   * Returns a string representation of the {@link Decisions.Candidate | candidate}.\n   * @returns A string representation of this candidate.\n   */\n  public toString(): string {\n    return `${this.key}: ${JSON.stringify(this.value)}`;\n  }\n}\n"]}

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

@@ -0,0 +1,15 @@
+import { DecisionIndex, DecisionKey } from '../common';
+import { JsonValue } from '@fgv/ts-json-base';
+import { ICandidate } from './candidate';
+/**
+ * Represents a decision, which is comprised of zero or more
+ * {@link Decisions.Candidate | candidates}, each of which represents a possible
+ * value for some resource, along with the conditions under which that value is valid.
+ * @public
+ */
+export interface IDecision<TVALUE extends JsonValue = JsonValue> {
+    key: DecisionKey;
+    candidates: ReadonlyArray<ICandidate<TVALUE>>;
+    index?: DecisionIndex;
+}
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/packlets/decisions/common.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IAC7D,GAAG,EAAE,WAAW,CAAC;IACjB,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/lib/packlets/decisions/common.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=common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/packlets/decisions/common.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 { DecisionIndex, DecisionKey } from '../common';\nimport { JsonValue } from '@fgv/ts-json-base';\nimport { ICandidate } from './candidate';\n\n/**\n * Represents a decision, which is comprised of zero or more\n * {@link Decisions.Candidate | candidates}, each of which represents a possible\n * value for some resource, along with the conditions under which that value is valid.\n * @public\n */\nexport interface IDecision<TVALUE extends JsonValue = JsonValue> {\n  key: DecisionKey;\n  candidates: ReadonlyArray<ICandidate<TVALUE>>;\n  index?: DecisionIndex;\n}\n"]}

package/lib/packlets/decisions/concreteDecision.d.ts

@@ -0,0 +1,74 @@
+import { JsonValue } from '@fgv/ts-json-base';
+import { ICandidate } from './candidate';
+import { IDecision } from './common';
+import { AbstractDecisionCollector } from './abstractDecisionCollector';
+import { AbstractDecision } from './abstractDecision';
+import { Result } from '@fgv/ts-utils';
+import { DecisionIndex, DecisionKey } from '../common';
+/**
+ * Parameters used to create a new {@link Decisions.ConcreteDecision | ConcreteDecision},
+ * given an {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} and a
+ * list of {@link Decisions.ICandidate | candidates}.
+ * @public
+ */
+export interface IConcreteDecisionCreateParams<TVALUE extends JsonValue = JsonValue> {
+    decisions: AbstractDecisionCollector;
+    candidates: ReadonlyArray<ICandidate<TVALUE>>;
+    index?: number;
+}
+/**
+ * Protected constructor parameters for {@link Decisions.ConcreteDecision | ConcreteDecision},
+ * used to create a new concrete decision from an existing {@link Decisions.AbstractDecision | AbstractDecision}
+ * and a list of values.
+ * @public
+ */
+export interface IConcreteDecisionConstructorParams<TVALUE extends JsonValue = JsonValue> {
+    baseDecision: AbstractDecision;
+    values: TVALUE[];
+    index?: DecisionIndex;
+}
+/**
+ * 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 declare class ConcreteDecision<TVALUE extends JsonValue = JsonValue> implements IDecision<TVALUE> {
+    readonly baseDecision: AbstractDecision;
+    readonly values: TVALUE[];
+    readonly candidates: ReadonlyArray<ICandidate<TVALUE>>;
+    /**
+     * Unique global key for this decision, derived from the condition set and
+     * candidate values.
+     */
+    get key(): DecisionKey;
+    /**
+     * Unique global index for this decision.
+     */
+    get index(): DecisionIndex | undefined;
+    private _collectible;
+    /**
+     * Constructor for a {@link Decisions.ConcreteDecision | ConcreteDecision} object.
+     * @param params - {@link Decisions.IConcreteDecisionConstructorParams | Parameters}
+     * used to create the decision.
+     * @public
+     */
+    protected constructor(params: IConcreteDecisionConstructorParams<TVALUE>);
+    /**
+     * 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<TVALUE extends JsonValue = JsonValue>(params: IConcreteDecisionCreateParams<TVALUE>): Result<ConcreteDecision<TVALUE>>;
+    /**
+     * 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: number): Result<DecisionIndex>;
+}
+//# sourceMappingURL=concreteDecision.d.ts.map

package/lib/packlets/decisions/concreteDecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concreteDecision.d.ts","sourceRoot":"","sources":["../../../src/packlets/decisions/concreteDecision.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAa,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAA0C,MAAM,EAAW,MAAM,eAAe,CAAC;AAExF,OAAO,EAA4B,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGjF;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACjF,SAAS,EAAE,yBAAyB,CAAC;IACrC,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kCAAkC,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACtF,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,SAAS,CAAC,MAAM,CAAC;IAC9F,SAAgB,YAAY,EAAE,gBAAgB,CAAC;IAC/C,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjC,SAAgB,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,IAAW,GAAG,IAAI,WAAW,CAE5B;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,aAAa,GAAG,SAAS,CAE5C;IAED,OAAO,CAAC,YAAY,CAAsD;IAE1E;;;;;OAKG;IACH,SAAS,aAAa,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC;IAcxE;;;;;;;OAOG;WACW,MAAM,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,EACvD,MAAM,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAC5C,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAgCnC;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;CAGtD"}

package/lib/packlets/decisions/concreteDecision.js

@@ -0,0 +1,114 @@
+"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.ConcreteDecision = void 0;
+const candidate_1 = require("./candidate");
+const ts_utils_1 = require("@fgv/ts-utils");
+const conditions_1 = require("../conditions");
+const common_1 = require("../common");
+const decision_1 = require("./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
+ */
+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_1.Candidate.createCandidate({ conditionSet: candidate.conditionSet, value }).orThrow();
+        });
+        this._collectible = new ts_utils_1.Collections.Collectible({
+            key: decision_1.Decision.getKey(this.candidates),
+            index: params.index,
+            indexConverter: common_1.Convert.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(conditions_1.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 (0, ts_utils_1.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 (0, ts_utils_1.succeed)(candidate.value);
+        })).onSuccess((values) => {
+            if (params.index) {
+                return common_1.Convert.decisionIndex.convert(params.index).onSuccess((index) => {
+                    return (0, ts_utils_1.captureResult)(() => new ConcreteDecision({ baseDecision, values, index }));
+                });
+            }
+            return (0, ts_utils_1.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);
+    }
+}
+exports.ConcreteDecision = ConcreteDecision;
+//# sourceMappingURL=concreteDecision.js.map

package/lib/packlets/decisions/concreteDecision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concreteDecision.js","sourceRoot":"","sources":["../../../src/packlets/decisions/concreteDecision.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 { JsonValue } from '@fgv/ts-json-base';\nimport { Candidate, ICandidate } from './candidate';\nimport { IDecision } from './common';\nimport { AbstractDecisionCollector } from './abstractDecisionCollector';\nimport { AbstractDecision } from './abstractDecision';\nimport { captureResult, Collections, mapResults, Result, succeed } from '@fgv/ts-utils';\nimport { ConditionSet } from '../conditions';\nimport { Convert as CommonConvert, DecisionIndex, DecisionKey } from '../common';\nimport { Decision } from './decision';\n\n/**\n * Parameters used to create a new {@link Decisions.ConcreteDecision | ConcreteDecision},\n * given an {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} and a\n * list of {@link Decisions.ICandidate | candidates}.\n * @public\n */\nexport interface IConcreteDecisionCreateParams<TVALUE extends JsonValue = JsonValue> {\n  decisions: AbstractDecisionCollector;\n  candidates: ReadonlyArray<ICandidate<TVALUE>>;\n  index?: number;\n}\n\n/**\n * Protected constructor parameters for {@link Decisions.ConcreteDecision | ConcreteDecision},\n * used to create a new concrete decision from an existing {@link Decisions.AbstractDecision | AbstractDecision}\n * and a list of values.\n * @public\n */\nexport interface IConcreteDecisionConstructorParams<TVALUE extends JsonValue = JsonValue> {\n  baseDecision: AbstractDecision;\n  values: TVALUE[];\n  index?: DecisionIndex;\n}\n\n/**\n * A {@link Decisions.ConcreteDecision | concrete decision} is a {@link Decisions.IDecision | decision}\n * implemented as a reference to a common {@link Decisions.AbstractDecision | abstract decision} and a list of\n * values that correspond to the candidates in the abstract decision.  This allows us to represent a large\n * number of related decisions with a single abstract decision and a list of values.\n * @public\n */\nexport class ConcreteDecision<TVALUE extends JsonValue = JsonValue> implements IDecision<TVALUE> {\n  public readonly baseDecision: AbstractDecision;\n  public readonly values: TVALUE[];\n  public readonly candidates: ReadonlyArray<ICandidate<TVALUE>>;\n\n  /**\n   * Unique global key for this decision, derived from the condition set and\n   * candidate values.\n   */\n  public get key(): DecisionKey {\n    return this._collectible.key;\n  }\n\n  /**\n   * Unique global index for this decision.\n   */\n  public get index(): DecisionIndex | undefined {\n    return this._collectible.index;\n  }\n\n  private _collectible: Collections.Collectible<DecisionKey, DecisionIndex>;\n\n  /**\n   * Constructor for a {@link Decisions.ConcreteDecision | ConcreteDecision} object.\n   * @param params - {@link Decisions.IConcreteDecisionConstructorParams | Parameters}\n   * used to create the decision.\n   * @public\n   */\n  protected constructor(params: IConcreteDecisionConstructorParams<TVALUE>) {\n    this.baseDecision = params.baseDecision;\n    this.values = params.values;\n    this.candidates = this.baseDecision.candidates.map((candidate) => {\n      const value = this.values[candidate.value];\n      return Candidate.createCandidate({ conditionSet: candidate.conditionSet, value }).orThrow();\n    });\n    this._collectible = new Collections.Collectible({\n      key: Decision.getKey(this.candidates),\n      index: params.index,\n      indexConverter: CommonConvert.decisionIndex\n    });\n  }\n\n  /**\n   * Creates a new {@link Decisions.ConcreteDecision | ConcreteDecision} object.\n   * @param params - {@link Decisions.IConcreteDecisionCreateParams | Parameters}\n   * used to create the decision.\n   * @returns `Success` with the new decision if successful, or `Failure` with an\n   * error message if not.\n   * @public\n   */\n  public static create<TVALUE extends JsonValue = JsonValue>(\n    params: IConcreteDecisionCreateParams<TVALUE>\n  ): Result<ConcreteDecision<TVALUE>> {\n    const conditionSets = params.candidates\n      .map((candidate) => candidate.conditionSet)\n      .sort(ConditionSet.compare)\n      .reverse();\n\n    const getBase = params.decisions.validating.getOrAdd(conditionSets);\n    /* c8 ignore next 3 - defense in depth against internal error hard to repro */\n    if (getBase.isFailure()) {\n      return fail(getBase.message);\n    }\n    const baseDecision = getBase.value;\n    return mapResults(\n      params.candidates.map((candidate, index) => {\n        /* c8 ignore next 5 - defense in depth against internal error hard to repro */\n        if (candidate.conditionSet.key !== baseDecision.candidates[index].conditionSet.key) {\n          return fail(\n            `${candidate.conditionSet.key}: Candidate does not match base decision ${candidate.conditionSet.key}`\n          );\n        }\n        return succeed(candidate.value);\n      })\n    ).onSuccess((values) => {\n      if (params.index) {\n        return CommonConvert.decisionIndex.convert(params.index).onSuccess((index) => {\n          return captureResult(() => new ConcreteDecision({ baseDecision, values, index }));\n        });\n      }\n      return captureResult(() => new ConcreteDecision({ baseDecision, values }));\n    });\n  }\n\n  /**\n   * Sets the index for this decision.  Once set, index is immutable.\n   * @param index - The index to set.\n   * @returns `Success` with the new index if successful, or `Failure` with an error message if not.\n   */\n  public setIndex(index: number): Result<DecisionIndex> {\n    return this._collectible.setIndex(index);\n  }\n}\n"]}

package/lib/packlets/decisions/decision.d.ts

@@ -0,0 +1,91 @@
+import { Result } from '@fgv/ts-utils';
+import { DecisionIndex, DecisionKey } from '../common';
+import { JsonValue } from '@fgv/ts-json-base';
+import { Candidate, ICandidate } from './candidate';
+import { IDecision } from './common';
+import { ConditionSet } from '../conditions';
+/**
+ * Parameters used to create a new {@link Decisions.Decision | Decision}
+ * with the {@link Decisions.Decision.createDecision | createDecision}
+ * static method.
+ * @public
+ */
+export interface IDecisionCreateParams<TVALUE extends JsonValue = JsonValue> {
+    candidates: ReadonlyArray<ICandidate<TVALUE>>;
+    index?: number;
+}
+/**
+ * Parameters used to construct a new {@link Decisions.Decision | Decision} with
+ * the protected constructor.
+ * @public
+ */
+export interface IDecisionConstructorParams<TVALUE extends JsonValue = JsonValue> extends IDecisionCreateParams<TVALUE> {
+    isAbstract: boolean;
+}
+/**
+ * Simple collectible implementation of {@link Decisions.IDecision | IDecision}.
+ * @public
+ */
+export declare class Decision<TVALUE extends JsonValue = JsonValue> implements IDecision<TVALUE> {
+    /**
+     * The sorted {@link Conditions.ConditionSet  | ConditionSets} that make up this decision.
+     * @public
+     */
+    readonly candidates: ReadonlyArray<Candidate<TVALUE>>;
+    /**
+     * Unique global key for this decision, derived from the contents
+     * of the decision.
+     */
+    get key(): DecisionKey;
+    /**
+     * Unique global index for this decision.
+     */
+    get index(): DecisionIndex | undefined;
+    /**
+     * Key for the empty decision (no condition sets).
+     */
+    static readonly EmptyDecisionKey: DecisionKey;
+    /**
+     * Key for the default-only decision (single condition set with no conditions).
+     */
+    static readonly DefaultOnlyDecisionKey: DecisionKey;
+    private _collectible;
+    /**
+     * Constructor for a {@link Decisions.Decision | Decision} object.
+     * @param params - {@link Decisions.IDecisionConstructorParams | Parameters} used to create the decision.
+     * @public
+     */
+    protected constructor(params: IDecisionConstructorParams<TVALUE>);
+    /**
+     * 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: IDecisionCreateParams): Result<Decision>;
+    /**
+     * 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: number): Result<DecisionIndex>;
+    /**
+     * 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: ReadonlyArray<ConditionSet>): DecisionKey;
+    /**
+     * 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<TVALUE extends JsonValue = JsonValue>(candidates: ReadonlyArray<ICandidate<TVALUE>>): DecisionKey;
+}
+//# sourceMappingURL=decision.d.ts.map

package/lib/packlets/decisions/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../src/packlets/decisions/decision.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAoC,MAAM,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAA4B,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS;IACzE,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,CAC9E,SAAQ,qBAAqB,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,QAAQ,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,SAAS,CAAC,MAAM,CAAC;IACtF;;;OAGG;IACH,SAAgB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7D;;;OAGG;IACH,IAAW,GAAG,IAAI,WAAW,CAE5B;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,aAAa,GAAG,SAAS,CAE5C;IAED;;OAEG;IACH,gBAAuB,gBAAgB,EAAE,WAAW,CAAmD;IAEvG;;OAEG;IACH,gBAAuB,sBAAsB,EAAE,WAAW,CAE7C;IAEb,OAAO,CAAC,YAAY,CAAsD;IAE1E;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,0BAA0B,CAAC,MAAM,CAAC;IAkBhE;;;;;OAKG;WACW,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAI7E;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IAIrD;;;;;;;;OAQG;WACW,cAAc,CAAC,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,WAAW;IAYrF;;;;;OAKG;WACW,MAAM,CAAC,MAAM,SAAS,SAAS,GAAG,SAAS,EACvD,UAAU,EAAE,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAC5C,WAAW;CAKf"}

package/lib/packlets/decisions/decision.js

@@ -0,0 +1,126 @@
+"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.Decision = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+const candidate_1 = require("./candidate");
+const conditions_1 = require("../conditions");
+/**
+ * Simple collectible implementation of {@link Decisions.IDecision | IDecision}.
+ * @public
+ */
+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_1.Candidate.createCandidate(c).orThrow())
+            .sort(candidate_1.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 ts_utils_1.Collections.Collectible({
+            key,
+            index: params.index,
+            indexConverter: common_1.Convert.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 (0, ts_utils_1.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 common_1.Convert.decisionKey
+            .convert(Array.from(conditionSets)
+            .sort(conditions_1.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) {
+        const abstractKey = Decision.getAbstractKey(candidates.map((c) => c.conditionSet));
+        const valueKey = ts_utils_1.Hash.Crc32Normalizer.crc32Hash(candidates.map((c) => JSON.stringify(c.value)));
+        return common_1.Convert.decisionKey.convert(`${abstractKey}|${valueKey}`).orThrow();
+    }
+}
+exports.Decision = Decision;
+/**
+ * Key for the empty decision (no condition sets).
+ */
+Decision.EmptyDecisionKey = common_1.Convert.decisionKey.convert('').orThrow();
+/**
+ * Key for the default-only decision (single condition set with no conditions).
+ */
+Decision.DefaultOnlyDecisionKey = common_1.Convert.decisionKey
+    .convert('00000000')
+    .orThrow();
+//# sourceMappingURL=decision.js.map