@fgv/ts-res 4.5.0-2 → 5.0.0-0

package/lib/packlets/runtime/conditionSetResolutionResult.js

@@ -0,0 +1,135 @@
+"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.ConditionSetResolutionResult = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * Represents the result of resolving a condition set.
+ * Contains either a failure indicator or a list of condition priority/score tuples sorted by priority then score.
+ * @public
+ */
+class ConditionSetResolutionResult {
+    /**
+     * Constructor for a {@link Runtime.ConditionSetResolutionResult | ConditionSetResolutionResult}.
+     * @param success - Whether the condition set resolution was successful.
+     * @param matches - Array of condition match results, if successful.
+     */
+    constructor(matchType, matches) {
+        this.matchType = matchType;
+        this.matches = [...matches];
+    }
+    /**
+     * Creates a new condition set resolution result.
+     * @param matchType - The type of match.
+     * @param matches - Array of condition match results.
+     * @returns A new {@link Runtime.ConditionSetResolutionResult | ConditionSetResolutionResult}.
+     * @public
+     */
+    static create(matchType, matches) {
+        return (0, ts_utils_1.captureResult)(() => new ConditionSetResolutionResult(matchType, matches));
+    }
+    /**
+     * Compares two condition set resolution results for sorting purposes.
+     * The priority of a condition set result cannot be boiled down to a single number -
+     * we have to examine each condition result in turn.
+     *
+     * Comparison logic:
+     * - If priority differs, return the higher priority
+     * - If priority matches but score is different, return the higher score
+     * - If priority and score both match, proceed to the next condition
+     * - Failed results are considered lower priority than successful results
+     *
+     * @param a - The first condition set resolution result to compare.
+     * @param b - The second condition set resolution result to compare.
+     * @returns A negative number if a should come before b, a positive number if a should
+     * come after b, or zero if they are equivalent.
+     * @public
+     */
+    static compare(a, b) {
+        // Failed results are always lower priority than default match which are lower than match
+        if (a.matchType === 'match') {
+            if (b.matchType !== 'match')
+                return -1;
+        }
+        else if (a.matchType === 'matchAsDefault') {
+            if (b.matchType === 'match') {
+                return 1;
+            }
+            else if (b.matchType === 'noMatch') {
+                return -1;
+            }
+        }
+        else {
+            // a.matchType === 'noMatch'
+            if (b.matchType === 'noMatch') {
+                return 0;
+            }
+            else {
+                return 1; // noMatch comes after any other match type
+            }
+        }
+        // Both are successful with the same match type - compare condition by condition
+        const minLength = Math.min(a.matches.length, b.matches.length);
+        for (let i = 0; i < minLength; i++) {
+            const matchA = a.matches[i];
+            const matchB = b.matches[i];
+            // Compare priority first
+            const priorityDiff = matchB.priority - matchA.priority;
+            if (priorityDiff !== 0) {
+                return priorityDiff;
+            }
+            // If priority matches, compare score
+            const scoreDiff = matchB.score - matchA.score;
+            if (scoreDiff !== 0) {
+                return scoreDiff;
+            }
+            // If both priority and score match, continue to next condition
+        }
+        // If all compared conditions are equal, the one with more conditions wins
+        return b.matches.length - a.matches.length;
+    }
+    /**
+     * Gets the highest priority among all condition matches.
+     * @returns The highest priority, or 0 if no matches.
+     * @public
+     */
+    get maxPriority() {
+        if (this.matchType === 'noMatch' || this.matches.length === 0) {
+            return 0;
+        }
+        return Math.max(...this.matches.map((m) => m.priority));
+    }
+    /**
+     * Gets the total score by summing all condition match scores.
+     * @returns The total score, or 0 if no matches.
+     * @public
+     */
+    get totalScore() {
+        if (this.matchType === 'noMatch' || this.matches.length === 0) {
+            return 0;
+        }
+        return this.matches.reduce((sum, match) => sum + match.score, 0);
+    }
+}
+exports.ConditionSetResolutionResult = ConditionSetResolutionResult;
+//# sourceMappingURL=conditionSetResolutionResult.js.map

package/lib/packlets/runtime/conditionSetResolutionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditionSetResolutionResult.js","sourceRoot":"","sources":["../../../src/packlets/runtime/conditionSetResolutionResult.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, Result } from '@fgv/ts-utils';\nimport { QualifierMatchScore, ConditionPriority } from '../common';\n\n/**\n * The outcome of a condition match.\n * @public\n */\nexport type ConditionMatchType = 'match' | 'matchAsDefault' | 'noMatch';\n\n/**\n * Represents a single condition match result with priority and outcome.\n * @public\n */\nexport interface IConditionMatchResult {\n  readonly priority: ConditionPriority;\n  readonly matchType: ConditionMatchType;\n  readonly score: QualifierMatchScore;\n}\n\n/**\n * Represents the result of resolving a condition set.\n * Contains either a failure indicator or a list of condition priority/score tuples sorted by priority then score.\n * @public\n */\nexport class ConditionSetResolutionResult {\n  public readonly matchType: ConditionMatchType;\n  public readonly matches: ReadonlyArray<IConditionMatchResult>;\n\n  /**\n   * Constructor for a {@link Runtime.ConditionSetResolutionResult | ConditionSetResolutionResult}.\n   * @param success - Whether the condition set resolution was successful.\n   * @param matches - Array of condition match results, if successful.\n   */\n  private constructor(matchType: ConditionMatchType, matches: ReadonlyArray<IConditionMatchResult>) {\n    this.matchType = matchType;\n    this.matches = [...matches];\n  }\n\n  /**\n   * Creates a new condition set resolution result.\n   * @param matchType - The type of match.\n   * @param matches - Array of condition match results.\n   * @returns A new {@link Runtime.ConditionSetResolutionResult | ConditionSetResolutionResult}.\n   * @public\n   */\n  public static create(\n    matchType: ConditionMatchType,\n    matches: ReadonlyArray<IConditionMatchResult>\n  ): Result<ConditionSetResolutionResult> {\n    return captureResult(() => new ConditionSetResolutionResult(matchType, matches));\n  }\n\n  /**\n   * Compares two condition set resolution results for sorting purposes.\n   * The priority of a condition set result cannot be boiled down to a single number -\n   * we have to examine each condition result in turn.\n   *\n   * Comparison logic:\n   * - If priority differs, return the higher priority\n   * - If priority matches but score is different, return the higher score\n   * - If priority and score both match, proceed to the next condition\n   * - Failed results are considered lower priority than successful results\n   *\n   * @param a - The first condition set resolution result to compare.\n   * @param b - The second condition set resolution result to compare.\n   * @returns A negative number if a should come before b, a positive number if a should\n   * come after b, or zero if they are equivalent.\n   * @public\n   */\n  public static compare(a: ConditionSetResolutionResult, b: ConditionSetResolutionResult): number {\n    // Failed results are always lower priority than default match which are lower than match\n    if (a.matchType === 'match') {\n      if (b.matchType !== 'match') return -1;\n    } else if (a.matchType === 'matchAsDefault') {\n      if (b.matchType === 'match') {\n        return 1;\n      } else if (b.matchType === 'noMatch') {\n        return -1;\n      }\n    } else {\n      // a.matchType === 'noMatch'\n      if (b.matchType === 'noMatch') {\n        return 0;\n      } else {\n        return 1; // noMatch comes after any other match type\n      }\n    }\n\n    // Both are successful with the same match type - compare condition by condition\n    const minLength = Math.min(a.matches.length, b.matches.length);\n\n    for (let i = 0; i < minLength; i++) {\n      const matchA = a.matches[i];\n      const matchB = b.matches[i];\n\n      // Compare priority first\n      const priorityDiff = matchB.priority - matchA.priority;\n      if (priorityDiff !== 0) {\n        return priorityDiff;\n      }\n\n      // If priority matches, compare score\n      const scoreDiff = matchB.score - matchA.score;\n      if (scoreDiff !== 0) {\n        return scoreDiff;\n      }\n\n      // If both priority and score match, continue to next condition\n    }\n\n    // If all compared conditions are equal, the one with more conditions wins\n    return b.matches.length - a.matches.length;\n  }\n\n  /**\n   * Gets the highest priority among all condition matches.\n   * @returns The highest priority, or 0 if no matches.\n   * @public\n   */\n  public get maxPriority(): ConditionPriority {\n    if (this.matchType === 'noMatch' || this.matches.length === 0) {\n      return 0 as ConditionPriority;\n    }\n    return Math.max(...this.matches.map((m) => m.priority)) as ConditionPriority;\n  }\n\n  /**\n   * Gets the total score by summing all condition match scores.\n   * @returns The total score, or 0 if no matches.\n   * @public\n   */\n  public get totalScore(): QualifierMatchScore {\n    if (this.matchType === 'noMatch' || this.matches.length === 0) {\n      return 0 as QualifierMatchScore;\n    }\n    return this.matches.reduce((sum, match) => sum + match.score, 0) as QualifierMatchScore;\n  }\n}\n"]}

package/lib/packlets/runtime/context/contextQualifierProvider.d.ts

@@ -0,0 +1,80 @@
+import { Result } from '@fgv/ts-utils';
+import { QualifierName, QualifierContextValue, QualifierIndex } from '../../common';
+import { IReadOnlyQualifierCollector, Qualifier } from '../../qualifiers';
+/**
+ * Abstract interface for providing qualifier values in an optimized runtime context.
+ * Acts as a property bag using the Result pattern for qualifier value lookups.
+ * @public
+ */
+export interface IContextQualifierProvider {
+    /**
+     * Gets a qualifier value by its name, index, or qualifier object.
+     * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    get(nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier): Result<QualifierContextValue>;
+    /**
+     * Gets a validated qualifier context value by its name, index, or qualifier object.
+     * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidated(nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier): Result<QualifierContextValue>;
+    /**
+     * Checks if a qualifier value exists with the given name.
+     * @param name - The {@link QualifierName | qualifier name} to check.
+     * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,
+     * or `Failure` with an error message if an error occurs during the check.
+     */
+    has(name: QualifierName): Result<boolean>;
+    /**
+     * Gets all available qualifier names in this context.
+     * @returns `Success` with an array of all {@link QualifierName | qualifier names},
+     * or `Failure` with an error message if an error occurs.
+     */
+    getNames(): Result<ReadonlyArray<QualifierName>>;
+    /**
+     * The readonly qualifier collector that defines and validates the qualifiers for this context.
+     */
+    readonly qualifiers: IReadOnlyQualifierCollector;
+}
+/**
+ * Abstract base class for implementing context qualifier providers.
+ * Provides common functionality and enforces the contract for derived classes.
+ * @public
+ */
+export declare abstract class ContextQualifierProvider implements IContextQualifierProvider {
+    /**
+     * The readonly qualifier collector that defines and validates the qualifiers for this context.
+     */
+    abstract readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Gets a qualifier value by its name, index, or qualifier object.
+     * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    abstract get(nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier): Result<QualifierContextValue>;
+    /**
+     * Gets a validated qualifier context value by its name, index, or qualifier object.
+     * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    abstract getValidated(nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier): Result<QualifierContextValue>;
+    /**
+     * Checks if a qualifier value exists with the given name.
+     * @param name - The {@link QualifierName | qualifier name} to check.
+     * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,
+     * or `Failure` with an error message if an error occurs during the check.
+     */
+    abstract has(name: QualifierName): Result<boolean>;
+    /**
+     * Gets all available qualifier names in this context.
+     * @returns `Success` with an array of all {@link QualifierName | qualifier names},
+     * or `Failure` with an error message if an error occurs.
+     */
+    abstract getNames(): Result<ReadonlyArray<QualifierName>>;
+}
+//# sourceMappingURL=contextQualifierProvider.d.ts.map

package/lib/packlets/runtime/context/contextQualifierProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/contextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,GAAG,CAAC,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEvG;;;;;OAKG;IACH,YAAY,CACV,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAE1C;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;CAClD;AAED;;;;GAIG;AACH,8BAAsB,wBAAyB,YAAW,yBAAyB;IACjF;;OAEG;IACH,kBAAyB,UAAU,EAAE,2BAA2B,CAAC;IAEjE;;;;;OAKG;aACa,GAAG,CACjB,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAEhC;;;;;OAKG;aACa,YAAY,CAC1B,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAEhC;;;;;OAKG;aACa,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAEzD;;;;OAIG;aACa,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;CACjE"}

package/lib/packlets/runtime/context/contextQualifierProvider.js

@@ -0,0 +1,33 @@
+"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.ContextQualifierProvider = void 0;
+/**
+ * Abstract base class for implementing context qualifier providers.
+ * Provides common functionality and enforces the contract for derived classes.
+ * @public
+ */
+class ContextQualifierProvider {
+}
+exports.ContextQualifierProvider = ContextQualifierProvider;
+//# sourceMappingURL=contextQualifierProvider.js.map

package/lib/packlets/runtime/context/contextQualifierProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/contextQualifierProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAmDH;;;;GAIG;AACH,MAAsB,wBAAwB;CAwC7C;AAxCD,4DAwCC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result } from '@fgv/ts-utils';\nimport { QualifierName, QualifierContextValue, QualifierIndex } from '../../common';\nimport { IReadOnlyQualifierCollector, Qualifier } from '../../qualifiers';\n\n/**\n * Abstract interface for providing qualifier values in an optimized runtime context.\n * Acts as a property bag using the Result pattern for qualifier value lookups.\n * @public\n */\nexport interface IContextQualifierProvider {\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  get(nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier): Result<QualifierContextValue>;\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue>;\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  has(name: QualifierName): Result<boolean>;\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  getNames(): Result<ReadonlyArray<QualifierName>>;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  readonly qualifiers: IReadOnlyQualifierCollector;\n}\n\n/**\n * Abstract base class for implementing context qualifier providers.\n * Provides common functionality and enforces the contract for derived classes.\n * @public\n */\nexport abstract class ContextQualifierProvider implements IContextQualifierProvider {\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  public abstract readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public abstract get(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue>;\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public abstract getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue>;\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  public abstract has(name: QualifierName): Result<boolean>;\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  public abstract getNames(): Result<ReadonlyArray<QualifierName>>;\n}\n"]}

package/lib/packlets/runtime/context/contextQualifierProviderValidator.d.ts

@@ -0,0 +1,165 @@
+import { Result } from '@fgv/ts-utils';
+import { QualifierContextValue } from '../../common';
+import { IReadOnlyQualifierCollector } from '../../qualifiers';
+import { IContextQualifierProvider } from './contextQualifierProvider';
+/**
+ * A read-only interface exposing non-mutating methods of a {@link Runtime.Context.ContextQualifierProviderValidator | ContextQualifierProviderValidator}.
+ * @public
+ */
+export interface IReadOnlyContextQualifierProviderValidator {
+    /**
+     * {@inheritdoc Runtime.Context.ContextQualifierProviderValidator.provider}
+     */
+    readonly provider: IContextQualifierProvider;
+    /**
+     * {@inheritdoc Runtime.Context.ContextQualifierProviderValidator.qualifiers}
+     */
+    readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Gets a qualifier value by its string name, converting to strongly-typed QualifierName.
+     * @param name - The string name to convert and look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    get(name: string): Result<QualifierContextValue>;
+    /**
+     * Gets a qualifier value by its number index, converting to strongly-typed QualifierIndex.
+     * @param index - The number index to convert and look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    getByIndex(index: number): Result<QualifierContextValue>;
+    /**
+     * Gets a validated qualifier context value by its string name.
+     * @param name - The string name to convert and look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidated(name: string): Result<QualifierContextValue>;
+    /**
+     * Gets a validated qualifier context value by its number index.
+     * @param index - The number index to convert and look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidatedByIndex(index: number): Result<QualifierContextValue>;
+    /**
+     * Checks if a qualifier value exists with the given string name.
+     * @param name - The string name to convert and check.
+     * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,
+     * or `Failure` with an error message if an error occurs during the check.
+     */
+    has(name: string): Result<boolean>;
+    /**
+     * Sets a qualifier value using string inputs, converting to strongly-typed values.
+     * @param name - The string name to convert.
+     * @param value - The string value to convert.
+     * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,
+     * or `Failure` with an error message if an error occurs.
+     */
+    set(name: string, value: string): Result<QualifierContextValue>;
+    /**
+     * Removes a qualifier value using string input, converting to strongly-typed QualifierName.
+     * @param name - The string name to convert.
+     * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,
+     * or `Failure` with an error message if an error occurs.
+     */
+    remove(name: string): Result<QualifierContextValue>;
+}
+/**
+ * Parameters for constructing a {@link Runtime.Context.ContextQualifierProviderValidator | ContextQualifierProviderValidator}.
+ * @public
+ */
+export interface IContextQualifierProviderValidatorCreateParams {
+    provider: IContextQualifierProvider;
+}
+/**
+ * A wrapper for {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider} that accepts
+ * string inputs and converts them to strongly-typed values before calling the wrapped provider.
+ * This eliminates the need for type casting in consumer code while maintaining type safety.
+ * @public
+ */
+export declare class ContextQualifierProviderValidator implements IReadOnlyContextQualifierProviderValidator {
+    /**
+     * The wrapped context qualifier provider.
+     */
+    readonly provider: IContextQualifierProvider;
+    /**
+     * The readonly qualifier collector that defines and validates the qualifiers for this context.
+     */
+    get qualifiers(): IReadOnlyQualifierCollector;
+    /**
+     * Constructs a new {@link Runtime.Context.ContextQualifierProviderValidator | ContextQualifierProviderValidator}.
+     * @param params - Required parameters for constructing the validator.
+     */
+    constructor(params: IContextQualifierProviderValidatorCreateParams);
+    /**
+     * Gets a qualifier value by its string name, converting to strongly-typed QualifierName.
+     * @param name - The string name to convert and look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    get(name: string): Result<QualifierContextValue>;
+    /**
+     * Gets a qualifier value by its number index, converting to strongly-typed QualifierIndex.
+     * @param index - The number index to convert and look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    getByIndex(index: number): Result<QualifierContextValue>;
+    /**
+     * Gets a validated qualifier context value by its string name.
+     * @param name - The string name to convert and look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidated(name: string): Result<QualifierContextValue>;
+    /**
+     * Gets a validated qualifier context value by its number index.
+     * @param index - The number index to convert and look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidatedByIndex(index: number): Result<QualifierContextValue>;
+    /**
+     * Checks if a qualifier value exists with the given string name.
+     * @param name - The string name to convert and check.
+     * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,
+     * or `Failure` with an error message if an error occurs during the check.
+     */
+    has(name: string): Result<boolean>;
+    /**
+     * Sets a qualifier value using string inputs, converting to strongly-typed values.
+     * @param name - The string name to convert.
+     * @param value - The string value to convert.
+     * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,
+     * or `Failure` with an error message if an error occurs.
+     */
+    set(name: string, value: string): Result<QualifierContextValue>;
+    /**
+     * Removes a qualifier value using string input, converting to strongly-typed QualifierName.
+     * @param name - The string name to convert.
+     * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,
+     * or `Failure` with an error message if an error occurs.
+     */
+    remove(name: string): Result<QualifierContextValue>;
+    /**
+     * Validates a string as a QualifierName.
+     * @param name - The string to validate.
+     * @returns `Success` with the strongly-typed QualifierName, or `Failure` if invalid.
+     */
+    private _validateQualifierName;
+    /**
+     * Validates a number as a QualifierIndex.
+     * @param index - The number to validate.
+     * @returns `Success` with the strongly-typed QualifierIndex, or `Failure` if invalid.
+     */
+    private _validateQualifierIndex;
+    /**
+     * Validates a string as a QualifierContextValue.
+     * @param value - The string to validate.
+     * @returns `Success` with the strongly-typed QualifierContextValue, or `Failure` if invalid.
+     */
+    private _validateQualifierContextValue;
+}
+//# sourceMappingURL=contextQualifierProviderValidator.d.ts.map

package/lib/packlets/runtime/context/contextQualifierProviderValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextQualifierProviderValidator.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/contextQualifierProviderValidator.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAiB,qBAAqB,EAAkB,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IAEjD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAElE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,WAAW,8CAA8C;IAC7D,QAAQ,EAAE,yBAAyB,CAAC;CACrC;AAED;;;;;GAKG;AACH,qBAAa,iCAAkC,YAAW,0CAA0C;IAClG;;OAEG;IACH,SAAgB,QAAQ,EAAE,yBAAyB,CAAC;IAEpD;;OAEG;IACH,IAAW,UAAU,IAAI,2BAA2B,CAEnD;IAED;;;OAGG;gBACgB,MAAM,EAAE,8CAA8C;IAIzE;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAMvD;;;;;OAKG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAM/D;;;;;OAKG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAMhE;;;;;OAKG;IACI,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAMxE;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;IAMzC;;;;;;OAMG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAqBtE;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAgB1D;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;CAMvC"}

package/lib/packlets/runtime/context/contextQualifierProviderValidator.js

@@ -0,0 +1,179 @@
+"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.ContextQualifierProviderValidator = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * A wrapper for {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider} that accepts
+ * string inputs and converts them to strongly-typed values before calling the wrapped provider.
+ * This eliminates the need for type casting in consumer code while maintaining type safety.
+ * @public
+ */
+class ContextQualifierProviderValidator {
+    /**
+     * The readonly qualifier collector that defines and validates the qualifiers for this context.
+     */
+    get qualifiers() {
+        return this.provider.qualifiers;
+    }
+    /**
+     * Constructs a new {@link Runtime.Context.ContextQualifierProviderValidator | ContextQualifierProviderValidator}.
+     * @param params - Required parameters for constructing the validator.
+     */
+    constructor(params) {
+        this.provider = params.provider;
+    }
+    /**
+     * Gets a qualifier value by its string name, converting to strongly-typed QualifierName.
+     * @param name - The string name to convert and look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    get(name) {
+        return this._validateQualifierName(name).onSuccess((qualifierName) => {
+            return this.provider.get(qualifierName);
+        });
+    }
+    /**
+     * Gets a qualifier value by its number index, converting to strongly-typed QualifierIndex.
+     * @param index - The number index to convert and look up.
+     * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found or an error occurs.
+     */
+    getByIndex(index) {
+        return this._validateQualifierIndex(index).onSuccess((qualifierIndex) => {
+            return this.provider.get(qualifierIndex);
+        });
+    }
+    /**
+     * Gets a validated qualifier context value by its string name.
+     * @param name - The string name to convert and look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidated(name) {
+        return this._validateQualifierName(name).onSuccess((qualifierName) => {
+            return this.provider.getValidated(qualifierName);
+        });
+    }
+    /**
+     * Gets a validated qualifier context value by its number index.
+     * @param index - The number index to convert and look up.
+     * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,
+     * or `Failure` with an error message if not found, invalid, or an error occurs.
+     */
+    getValidatedByIndex(index) {
+        return this._validateQualifierIndex(index).onSuccess((qualifierIndex) => {
+            return this.provider.getValidated(qualifierIndex);
+        });
+    }
+    /**
+     * Checks if a qualifier value exists with the given string name.
+     * @param name - The string name to convert and check.
+     * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,
+     * or `Failure` with an error message if an error occurs during the check.
+     */
+    has(name) {
+        return this._validateQualifierName(name).onSuccess((qualifierName) => {
+            return this.provider.has(qualifierName);
+        });
+    }
+    /**
+     * Sets a qualifier value using string inputs, converting to strongly-typed values.
+     * @param name - The string name to convert.
+     * @param value - The string value to convert.
+     * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,
+     * or `Failure` with an error message if an error occurs.
+     */
+    set(name, value) {
+        return this._validateQualifierName(name)
+            .onSuccess((qualifierName) => this._validateQualifierContextValue(value))
+            .onSuccess((qualifierValue) => {
+            // Check if the provider has a set method (only available on mutable providers)
+            if ('set' in this.provider && typeof this.provider.set === 'function') {
+                try {
+                    return this.provider.set(name, qualifierValue);
+                }
+                catch (_a) {
+                    return (0, ts_utils_1.fail)(`Provider does not support setting values`);
+                }
+            }
+            return (0, ts_utils_1.fail)(`Provider does not support setting values`);
+        });
+    }
+    /**
+     * Removes a qualifier value using string input, converting to strongly-typed QualifierName.
+     * @param name - The string name to convert.
+     * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,
+     * or `Failure` with an error message if an error occurs.
+     */
+    remove(name) {
+        return this._validateQualifierName(name).onSuccess((qualifierName) => {
+            // Check if the provider has a remove method (only available on mutable providers)
+            if ('remove' in this.provider && typeof this.provider.remove === 'function') {
+                try {
+                    return this.provider.remove(qualifierName);
+                }
+                catch (_a) {
+                    return (0, ts_utils_1.fail)(`Provider does not support removing values`);
+                }
+            }
+            return (0, ts_utils_1.fail)(`Provider does not support removing values`);
+        });
+    }
+    /**
+     * Validates a string as a QualifierName.
+     * @param name - The string to validate.
+     * @returns `Success` with the strongly-typed QualifierName, or `Failure` if invalid.
+     */
+    _validateQualifierName(name) {
+        if (typeof name !== 'string' || name.length === 0) {
+            return (0, ts_utils_1.fail)(`Invalid qualifier name: "${name}"`);
+        }
+        return (0, ts_utils_1.succeed)(name);
+    }
+    /**
+     * Validates a number as a QualifierIndex.
+     * @param index - The number to validate.
+     * @returns `Success` with the strongly-typed QualifierIndex, or `Failure` if invalid.
+     */
+    _validateQualifierIndex(index) {
+        if (typeof index !== 'number' || !Number.isInteger(index) || index < 0) {
+            return (0, ts_utils_1.fail)(`Invalid qualifier index: ${index}`);
+        }
+        return (0, ts_utils_1.succeed)(index);
+    }
+    /**
+     * Validates a string as a QualifierContextValue.
+     * @param value - The string to validate.
+     * @returns `Success` with the strongly-typed QualifierContextValue, or `Failure` if invalid.
+     */
+    _validateQualifierContextValue(value) {
+        if (typeof value !== 'string') {
+            return (0, ts_utils_1.fail)(`Invalid qualifier context value: "${value}"`);
+        }
+        return (0, ts_utils_1.succeed)(value);
+    }
+}
+exports.ContextQualifierProviderValidator = ContextQualifierProviderValidator;
+//# sourceMappingURL=contextQualifierProviderValidator.js.map