@fgv/ts-res 4.5.0-0

package/lib/packlets/qualifier-types/qualifierTypeCollector.js

@@ -0,0 +1,102 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QualifierTypeCollector = void 0;
+const Common = __importStar(require("../common"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const qualifierType_1 = require("./qualifierType");
+/**
+ * Collector for {@link QualifierTypes.QualifierType | QualifierType} objects.
+ * @public
+ */
+class QualifierTypeCollector extends ts_utils_1.ValidatingConvertingCollector {
+    /**
+     * Constructor for a {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} object.
+     * @param params - Optional {@link QualifierTypes.IQualifierTypeCollectorCreateParams | parameters} used to construct the collector.
+     */
+    constructor({ qualifierTypes }) {
+        super({
+            converters: new ts_utils_1.Collections.KeyValueConverters({
+                key: Common.Convert.qualifierTypeName,
+                value: QualifierTypeCollector._toQualifierType
+            }),
+            factory: QualifierTypeCollector._qualifierTypeFactory
+        });
+        /* c8 ignore next 1 - coverage seems to intermittently miss the branch */
+        qualifierTypes === null || qualifierTypes === void 0 ? void 0 : qualifierTypes.forEach((qt) => {
+            this.add(qt).orThrow();
+        });
+    }
+    /**
+     * Creates a new {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} object.
+     * @param params - Optional {@link QualifierTypes.IQualifierTypeCollectorCreateParams | parameters}
+     * used to create the collector.
+     * @returns `Success` with the new collector if successful, or `Failure` if not.
+     */
+    static create(params) {
+        /* c8 ignore next 1 - coverage seems to miss the branch intermittently */
+        params = params !== null && params !== void 0 ? params : {};
+        return (0, ts_utils_1.captureResult)(() => new QualifierTypeCollector(params));
+    }
+    static _qualifierTypeFactory(key, index, value) {
+        return (0, ts_utils_1.succeed)(value);
+    }
+    static _toQualifierType(from) {
+        return from instanceof qualifierType_1.QualifierType ? (0, ts_utils_1.succeed)(from) : (0, ts_utils_1.fail)('not a QualifierType');
+    }
+}
+exports.QualifierTypeCollector = QualifierTypeCollector;
+//# sourceMappingURL=qualifierTypeCollector.js.map

package/lib/packlets/qualifier-types/qualifierTypeCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierTypeCollector.js","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/qualifierTypeCollector.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,kDAAoC;AACpC,4CAOuB;AACvB,mDAAgD;AAehD;;;GAGG;AACH,MAAa,sBAAuB,SAAQ,wCAA2D;IACrG;;;OAGG;IACH,YAAsB,EAAE,cAAc,EAAuC;QAC3E,KAAK,CAAC;YACJ,UAAU,EAAE,IAAI,sBAAW,CAAC,kBAAkB,CAAC;gBAC7C,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB;gBACrC,KAAK,EAAE,sBAAsB,CAAC,gBAAgB;aAC/C,CAAC;YACF,OAAO,EAAE,sBAAsB,CAAC,qBAAqB;SACtD,CAAC,CAAC;QAEH,yEAAyE;QACzE,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAA4C;QAC/D,yEAAyE;QACzE,MAAM,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;QACtB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IAES,MAAM,CAAC,qBAAqB,CACpC,GAAsB,EACtB,KAAa,EACb,KAAoB;QAEpB,OAAO,IAAA,kBAAO,EAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAES,MAAM,CAAC,gBAAgB,CAAC,IAAa;QAC7C,OAAO,IAAI,YAAY,6BAAa,CAAC,CAAC,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,eAAI,EAAC,qBAAqB,CAAC,CAAC;IACrF,CAAC;CACF;AA3CD,wDA2CC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as Common from '../common';\nimport {\n  Collections,\n  Result,\n  ValidatingConvertingCollector,\n  captureResult,\n  fail,\n  succeed\n} from '@fgv/ts-utils';\nimport { QualifierType } from './qualifierType';\nimport { QualifierTypeName } from '../common';\n\n/**\n * Parameters for creating a new {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector}.\n * @public\n */\nexport interface IQualifierTypeCollectorCreateParams {\n  /**\n   * Optional list of {@link QualifierTypes.QualifierType | QualifierTypes} to add to the collector\n   * on creation.\n   */\n  qualifierTypes?: QualifierType[];\n}\n\n/**\n * Collector for {@link QualifierTypes.QualifierType | QualifierType} objects.\n * @public\n */\nexport class QualifierTypeCollector extends ValidatingConvertingCollector<QualifierType, QualifierType> {\n  /**\n   * Constructor for a {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} object.\n   * @param params - Optional {@link QualifierTypes.IQualifierTypeCollectorCreateParams | parameters} used to construct the collector.\n   */\n  protected constructor({ qualifierTypes }: IQualifierTypeCollectorCreateParams) {\n    super({\n      converters: new Collections.KeyValueConverters({\n        key: Common.Convert.qualifierTypeName,\n        value: QualifierTypeCollector._toQualifierType\n      }),\n      factory: QualifierTypeCollector._qualifierTypeFactory\n    });\n\n    /* c8 ignore next 1 - coverage seems to intermittently miss the branch */\n    qualifierTypes?.forEach((qt) => {\n      this.add(qt).orThrow();\n    });\n  }\n\n  /**\n   * Creates a new {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector} object.\n   * @param params - Optional {@link QualifierTypes.IQualifierTypeCollectorCreateParams | parameters}\n   * used to create the collector.\n   * @returns `Success` with the new collector if successful, or `Failure` if not.\n   */\n  public static create(params?: IQualifierTypeCollectorCreateParams): Result<QualifierTypeCollector> {\n    /* c8 ignore next 1 - coverage seems to miss the branch intermittently */\n    params = params ?? {};\n    return captureResult(() => new QualifierTypeCollector(params));\n  }\n\n  protected static _qualifierTypeFactory(\n    key: QualifierTypeName,\n    index: number,\n    value: QualifierType\n  ): Result<QualifierType> {\n    return succeed(value);\n  }\n\n  protected static _toQualifierType(from: unknown): Result<QualifierType> {\n    return from instanceof QualifierType ? succeed(from) : fail('not a QualifierType');\n  }\n}\n\n/**\n * Interface exposing non-mutating members of a {@link QualifierTypes.QualifierTypeCollector | QualifierTypeCollector}.\n * @public\n */\nexport type ReadOnlyQualifierTypeCollector = Collections.IReadOnlyValidatingCollector<QualifierType>;\n"]}

package/lib/packlets/qualifier-types/territoryQualifierType.d.ts

@@ -0,0 +1,74 @@
+import { Result } from '@fgv/ts-utils';
+import { QualifierConditionValue, QualifierContextValue, QualifierMatchScore } from '../common';
+import { QualifierType } from './qualifierType';
+/**
+ * Parameters used to create a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.
+ * @public
+ */
+export interface ITerritoryQualifierTypeCreateParams {
+    /**
+     * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.name}
+     */
+    name?: string;
+    /**
+     * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.allowContextList}
+     */
+    allowContextList?: boolean;
+    /**
+     * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.index}
+     */
+    index?: number;
+    /**
+     * Optional array enumerating allowed territories to further constrain the type.
+     */
+    allowedTerritories?: string[];
+}
+/**
+ * Qualifier type for territory values. Territories are two-letter ISO-3166-2
+ * Alpha-2 country codes.  Canonical territory codes are uppercase, but this
+ * implementation handles incorrect casing.
+ * @public
+ */
+export declare class TerritoryQualifierType extends QualifierType {
+    /**
+     * Optional array enumerating allowed territories to further constrain the type.
+     */
+    readonly allowedTerritories?: ReadonlyArray<QualifierConditionValue>;
+    /**
+     * Creates a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.
+     * @public
+     */
+    protected constructor({ allowedTerritories, allowContextList, name, index }: ITerritoryQualifierTypeCreateParams);
+    /**
+     * {@inheritdoc QualifierTypes.QualifierType.isValidConditionValue}
+     */
+    isValidConditionValue(value: string): value is QualifierConditionValue;
+    /**
+     * Creates a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.
+     * @param params - Optional {@link QualifierTypes.ITerritoryQualifierTypeCreateParams | parameters} to use
+     * when creating the instance.
+     * @returns `Success` with the new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} if successful,
+     * `Failure` with an error message otherwise.
+     * @public
+     */
+    static create(params?: ITerritoryQualifierTypeCreateParams): Result<TerritoryQualifierType>;
+    /**
+     * {@inheritdoc QualifierTypes.QualifierType._matchOne}
+     */
+    protected _matchOne(condition: QualifierConditionValue, context: QualifierContextValue): QualifierMatchScore;
+    /**
+     * Determines whether a value is a valid condition value for a territory qualifier.
+     * @param value - The value to validate.
+     * @returns `true` if the value is a valid condition value, `false` otherwise.
+     * @public
+     */
+    static isValidTerritoryConditionValue(value: string): value is QualifierConditionValue;
+    /**
+     * Converts a string value to a territory condition value.
+     * @param value - The value to convert.
+     * @returns `Success` with the converted value if successful, `Failure` with an error message otherwise.
+     * @public
+     */
+    static toTerritoryConditionValue(value: string): Result<QualifierConditionValue>;
+}
+//# sourceMappingURL=territoryQualifierType.d.ts.map

package/lib/packlets/qualifier-types/territoryQualifierType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"territoryQualifierType.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/territoryQualifierType.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,MAAM,EAA6B,MAAM,eAAe,CAAC;AACjF,OAAO,EAIL,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EAEpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD;;OAEG;IACH,SAAgB,kBAAkB,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAE5E;;;OAGG;IACH,SAAS,aAAa,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,IAAI,EACJ,KAAK,EACN,EAAE,mCAAmC;IAoBtC;;OAEG;IACI,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB;IAY7E;;;;;;;OAOG;WACW,MAAM,CAAC,MAAM,CAAC,EAAE,mCAAmC,GAAG,MAAM,CAAC,sBAAsB,CAAC;IAMlG;;OAEG;IACH,SAAS,CAAC,SAAS,CACjB,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,qBAAqB,GAC7B,mBAAmB;IAOtB;;;;;OAKG;WACW,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,uBAAuB;IAI7F;;;;;OAKG;WACW,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,uBAAuB,CAAC;CAMxF"}

package/lib/packlets/qualifier-types/territoryQualifierType.js

@@ -0,0 +1,113 @@
+"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.TerritoryQualifierType = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+const qualifierType_1 = require("./qualifierType");
+/**
+ * Qualifier type for territory values. Territories are two-letter ISO-3166-2
+ * Alpha-2 country codes.  Canonical territory codes are uppercase, but this
+ * implementation handles incorrect casing.
+ * @public
+ */
+class TerritoryQualifierType extends qualifierType_1.QualifierType {
+    /**
+     * Creates a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.
+     * @public
+     */
+    constructor({ allowedTerritories, allowContextList, name, index }) {
+        /* c8 ignore next 7 - coverage seems to be missing coalescing branches */
+        name = name !== null && name !== void 0 ? name : 'territory';
+        const validIndex = index !== undefined ? common_1.Convert.qualifierTypeIndex.convert(index).orThrow() : undefined;
+        const validTerritories = allowedTerritories !== undefined
+            ? (0, ts_utils_1.mapResults)(allowedTerritories.map((t) => TerritoryQualifierType.toTerritoryConditionValue(t))).orThrow()
+            : undefined;
+        allowContextList = allowContextList === true;
+        super({
+            name: name,
+            allowContextList,
+            index: validIndex
+        });
+        this.allowedTerritories = validTerritories;
+    }
+    /**
+     * {@inheritdoc QualifierTypes.QualifierType.isValidConditionValue}
+     */
+    isValidConditionValue(value) {
+        const normalized = value.toUpperCase();
+        /* c8 ignore next 6 - definitely tested but coverage is missing it */
+        if (!TerritoryQualifierType.isValidTerritoryConditionValue(normalized)) {
+            return false;
+        }
+        if (this.allowedTerritories !== undefined) {
+            return this.allowedTerritories.includes(normalized);
+        }
+        return true;
+    }
+    /**
+     * Creates a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.
+     * @param params - Optional {@link QualifierTypes.ITerritoryQualifierTypeCreateParams | parameters} to use
+     * when creating the instance.
+     * @returns `Success` with the new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} if successful,
+     * `Failure` with an error message otherwise.
+     * @public
+     */
+    static create(params) {
+        /* c8 ignore next 1 - coverage having problems with conditional branches */
+        params = params !== null && params !== void 0 ? params : {};
+        return (0, ts_utils_1.captureResult)(() => new TerritoryQualifierType(params));
+    }
+    /**
+     * {@inheritdoc QualifierTypes.QualifierType._matchOne}
+     */
+    _matchOne(condition, context) {
+        if (this.isValidConditionValue(condition) && condition.toUpperCase() === context.toUpperCase()) {
+            return common_1.PerfectMatch;
+        }
+        return common_1.NoMatch;
+    }
+    /**
+     * Determines whether a value is a valid condition value for a territory qualifier.
+     * @param value - The value to validate.
+     * @returns `true` if the value is a valid condition value, `false` otherwise.
+     * @public
+     */
+    static isValidTerritoryConditionValue(value) {
+        return common_1.Validate.RegularExpressions.territoryCode.test(value);
+    }
+    /**
+     * Converts a string value to a territory condition value.
+     * @param value - The value to convert.
+     * @returns `Success` with the converted value if successful, `Failure` with an error message otherwise.
+     * @public
+     */
+    static toTerritoryConditionValue(value) {
+        const normalized = value.toUpperCase();
+        return TerritoryQualifierType.isValidTerritoryConditionValue(normalized)
+            ? (0, ts_utils_1.succeed)(normalized)
+            : (0, ts_utils_1.fail)(`${value}: not a valid territory code`);
+    }
+}
+exports.TerritoryQualifierType = TerritoryQualifierType;
+//# sourceMappingURL=territoryQualifierType.js.map

package/lib/packlets/qualifier-types/territoryQualifierType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"territoryQualifierType.js","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/territoryQualifierType.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAiF;AACjF,sCAQmB;AACnB,mDAAgD;AA4BhD;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,6BAAa;IAMvD;;;OAGG;IACH,YAAsB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,IAAI,EACJ,KAAK,EAC+B;QACpC,yEAAyE;QACzE,IAAI,GAAG,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,WAAW,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzG,MAAM,gBAAgB,GACpB,kBAAkB,KAAK,SAAS;YAC9B,CAAC,CAAC,IAAA,qBAAU,EACR,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CACnF,CAAC,OAAO,EAAE;YACb,CAAC,CAAC,SAAS,CAAC;QAEhB,gBAAgB,GAAG,gBAAgB,KAAK,IAAI,CAAC;QAC7C,KAAK,CAAC;YACJ,IAAI,EAAE,IAAI;YACV,gBAAgB;YAChB,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,kBAAkB,GAAG,gBAAgB,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,qBAAqB,CAAC,KAAa;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,qEAAqE;QACrE,IAAI,CAAC,sBAAsB,CAAC,8BAA8B,CAAC,UAAU,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,CAAC,MAA4C;QAC/D,2EAA2E;QAC3E,MAAM,GAAG,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC;QACtB,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACO,SAAS,CACjB,SAAkC,EAClC,OAA8B;QAE9B,IAAI,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/F,OAAO,qBAAY,CAAC;QACtB,CAAC;QACD,OAAO,gBAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,8BAA8B,CAAC,KAAa;QACxD,OAAO,iBAAQ,CAAC,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,yBAAyB,CAAC,KAAa;QACnD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC,8BAA8B,CAAC,UAAU,CAAC;YACtE,CAAC,CAAC,IAAA,kBAAO,EAAC,UAAU,CAAC;YACrB,CAAC,CAAC,IAAA,eAAI,EAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IACnD,CAAC;CACF;AAnGD,wDAmGC","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, fail, succeed, mapResults } from '@fgv/ts-utils';\nimport {\n  Convert,\n  NoMatch,\n  PerfectMatch,\n  QualifierConditionValue,\n  QualifierContextValue,\n  QualifierMatchScore,\n  Validate\n} from '../common';\nimport { QualifierType } from './qualifierType';\n\n/**\n * Parameters used to create a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.\n * @public\n */\nexport interface ITerritoryQualifierTypeCreateParams {\n  /**\n   * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.name}\n   */\n  name?: string;\n\n  /**\n   * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.allowContextList}\n   */\n  allowContextList?: boolean;\n\n  /**\n   * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.index}\n   */\n  index?: number;\n\n  /**\n   * Optional array enumerating allowed territories to further constrain the type.\n   */\n  allowedTerritories?: string[];\n}\n\n/**\n * Qualifier type for territory values. Territories are two-letter ISO-3166-2\n * Alpha-2 country codes.  Canonical territory codes are uppercase, but this\n * implementation handles incorrect casing.\n * @public\n */\nexport class TerritoryQualifierType extends QualifierType {\n  /**\n   * Optional array enumerating allowed territories to further constrain the type.\n   */\n  public readonly allowedTerritories?: ReadonlyArray<QualifierConditionValue>;\n\n  /**\n   * Creates a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.\n   * @public\n   */\n  protected constructor({\n    allowedTerritories,\n    allowContextList,\n    name,\n    index\n  }: ITerritoryQualifierTypeCreateParams) {\n    /* c8 ignore next 7 - coverage seems to be missing coalescing branches */\n    name = name ?? 'territory';\n    const validIndex = index !== undefined ? Convert.qualifierTypeIndex.convert(index).orThrow() : undefined;\n    const validTerritories =\n      allowedTerritories !== undefined\n        ? mapResults(\n            allowedTerritories.map((t) => TerritoryQualifierType.toTerritoryConditionValue(t))\n          ).orThrow()\n        : undefined;\n\n    allowContextList = allowContextList === true;\n    super({\n      name: name,\n      allowContextList,\n      index: validIndex\n    });\n    this.allowedTerritories = validTerritories;\n  }\n\n  /**\n   * {@inheritdoc QualifierTypes.QualifierType.isValidConditionValue}\n   */\n  public isValidConditionValue(value: string): value is QualifierConditionValue {\n    const normalized = value.toUpperCase();\n    /* c8 ignore next 6 - definitely tested but coverage is missing it */\n    if (!TerritoryQualifierType.isValidTerritoryConditionValue(normalized)) {\n      return false;\n    }\n    if (this.allowedTerritories !== undefined) {\n      return this.allowedTerritories.includes(normalized);\n    }\n    return true;\n  }\n\n  /**\n   * Creates a new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} instance.\n   * @param params - Optional {@link QualifierTypes.ITerritoryQualifierTypeCreateParams | parameters} to use\n   * when creating the instance.\n   * @returns `Success` with the new {@link QualifierTypes.TerritoryQualifierType | TerritoryQualifierType} if successful,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public static create(params?: ITerritoryQualifierTypeCreateParams): Result<TerritoryQualifierType> {\n    /* c8 ignore next 1 - coverage having problems with conditional branches */\n    params = params ?? {};\n    return captureResult(() => new TerritoryQualifierType(params));\n  }\n\n  /**\n   * {@inheritdoc QualifierTypes.QualifierType._matchOne}\n   */\n  protected _matchOne(\n    condition: QualifierConditionValue,\n    context: QualifierContextValue\n  ): QualifierMatchScore {\n    if (this.isValidConditionValue(condition) && condition.toUpperCase() === context.toUpperCase()) {\n      return PerfectMatch;\n    }\n    return NoMatch;\n  }\n\n  /**\n   * Determines whether a value is a valid condition value for a territory qualifier.\n   * @param value - The value to validate.\n   * @returns `true` if the value is a valid condition value, `false` otherwise.\n   * @public\n   */\n  public static isValidTerritoryConditionValue(value: string): value is QualifierConditionValue {\n    return Validate.RegularExpressions.territoryCode.test(value);\n  }\n\n  /**\n   * Converts a string value to a territory condition value.\n   * @param value - The value to convert.\n   * @returns `Success` with the converted value if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public static toTerritoryConditionValue(value: string): Result<QualifierConditionValue> {\n    const normalized = value.toUpperCase();\n    return TerritoryQualifierType.isValidTerritoryConditionValue(normalized)\n      ? succeed(normalized)\n      : fail(`${value}: not a valid territory code`);\n  }\n}\n"]}

package/lib/packlets/qualifiers/convert/decls.d.ts

@@ -0,0 +1,23 @@
+import { IQualifierDecl, IValidatedQualifierDecl } from '../qualifierDecl';
+import { ReadOnlyQualifierTypeCollector } from '../../qualifier-types';
+/**
+ * Converter for a {@link Qualifiers.IQualifierDecl | qualifier declaration}.
+ * @public
+ */
+export declare const qualifierDecl: import("@fgv/ts-utils").ObjectConverter<IQualifierDecl, unknown>;
+/**
+ * Context necessary to convert a {@link Qualifiers.IValidatedQualifierDecl | validated qualifier declaration}.
+ * @public
+ */
+export interface IQualifierDeclConvertContext {
+    readonly qualifierTypes: ReadOnlyQualifierTypeCollector;
+    qualifierIndex?: number;
+}
+/**
+ * Converter which constructs a {@link Qualifiers.IValidatedQualifierDecl | validated qualifier declaration}
+ * from a {@link Qualifiers.IQualifierDecl | qualifier declaration}, instantiating qualifier types by name
+ * from a supplied {@link Qualifiers.Convert.IQualifierDeclConvertContext | conversion context}.
+ * @public
+ */
+export declare const validatedQualifierDecl: import("@fgv/ts-utils").Converter<IValidatedQualifierDecl, IQualifierDeclConvertContext>;
+//# sourceMappingURL=decls.d.ts.map

package/lib/packlets/qualifiers/convert/decls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decls.d.ts","sourceRoot":"","sources":["../../../../src/packlets/qualifiers/convert/decls.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAIvE;;;GAGG;AACH,eAAO,MAAM,aAAa,kEAMxB,CAAC;AAEH;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,0FA6BjC,CAAC"}

package/lib/packlets/qualifiers/convert/decls.js

@@ -0,0 +1,71 @@
+"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.validatedQualifierDecl = exports.qualifierDecl = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../../common");
+/* eslint-disable @rushstack/typedef-var */
+/**
+ * Converter for a {@link Qualifiers.IQualifierDecl | qualifier declaration}.
+ * @public
+ */
+exports.qualifierDecl = ts_utils_1.Converters.strictObject({
+    name: ts_utils_1.Converters.string,
+    typeName: ts_utils_1.Converters.string,
+    defaultPriority: ts_utils_1.Converters.number,
+    token: ts_utils_1.Converters.string.optional(),
+    tokenIsOptional: ts_utils_1.Converters.boolean.optional()
+});
+/**
+ * Converter which constructs a {@link Qualifiers.IValidatedQualifierDecl | validated qualifier declaration}
+ * from a {@link Qualifiers.IQualifierDecl | qualifier declaration}, instantiating qualifier types by name
+ * from a supplied {@link Qualifiers.Convert.IQualifierDeclConvertContext | conversion context}.
+ * @public
+ */
+exports.validatedQualifierDecl = ts_utils_1.Converters.generic((from, __self, context) => {
+    /* c8 ignore next 7  - this is tested but code coverage is losing its mind */
+    if (context === undefined) {
+        return (0, ts_utils_1.fail)('validatedQualifierDecl converter requires a context');
+    }
+    const validatedIndexResult = context.qualifierIndex !== undefined
+        ? common_1.Validate.toQualifierIndex(context.qualifierIndex)
+        : (0, ts_utils_1.succeed)(undefined);
+    return exports.qualifierDecl.convert(from).onSuccess((decl) => {
+        var _a;
+        const token = (_a = decl.token) !== null && _a !== void 0 ? _a : decl.name;
+        return (0, ts_utils_1.populateObject)({
+            name: () => common_1.Validate.toQualifierName(decl.name),
+            token: () => common_1.Validate.toQualifierName(token),
+            tokenIsOptional: () => (0, ts_utils_1.succeed)(decl.tokenIsOptional === true),
+            type: () => context.qualifierTypes.validating.get(decl.typeName),
+            defaultPriority: () => common_1.Validate.toConditionPriority(decl.defaultPriority),
+            index: () => validatedIndexResult
+        }).onSuccess((validated) => {
+            if (context.qualifierIndex !== undefined) {
+                context.qualifierIndex++;
+            }
+            return (0, ts_utils_1.succeed)(validated);
+        });
+    });
+});
+//# sourceMappingURL=decls.js.map

package/lib/packlets/qualifiers/convert/decls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decls.js","sourceRoot":"","sources":["../../../../src/packlets/qualifiers/convert/decls.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAkF;AAElF,yCAAwC;AAGxC,2CAA2C;AAE3C;;;GAGG;AACU,QAAA,aAAa,GAAG,qBAAU,CAAC,YAAY,CAAiB;IACnE,IAAI,EAAE,qBAAU,CAAC,MAAM;IACvB,QAAQ,EAAE,qBAAU,CAAC,MAAM;IAC3B,eAAe,EAAE,qBAAU,CAAC,MAAM;IAClC,KAAK,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;IACnC,eAAe,EAAE,qBAAU,CAAC,OAAO,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAWH;;;;;GAKG;AACU,QAAA,sBAAsB,GAAG,qBAAU,CAAC,OAAO,CAGtD,CAAC,IAAa,EAAE,MAAM,EAAE,OAAsC,EAAmC,EAAE;IACnG,6EAA6E;IAC7E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAA,eAAI,EAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,oBAAoB,GACxB,OAAO,CAAC,cAAc,KAAK,SAAS;QAClC,CAAC,CAAC,iBAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,cAAc,CAAC;QACnD,CAAC,CAAC,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;IAEzB,OAAO,qBAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;;QACpD,MAAM,KAAK,GAAG,MAAA,IAAI,CAAC,KAAK,mCAAI,IAAI,CAAC,IAAI,CAAC;QACtC,OAAO,IAAA,yBAAc,EAA0B;YAC7C,IAAI,EAAE,GAAG,EAAE,CAAC,iBAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAC/C,KAAK,EAAE,GAAG,EAAE,CAAC,iBAAQ,CAAC,eAAe,CAAC,KAAK,CAAC;YAC5C,eAAe,EAAE,GAAG,EAAE,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC;YAC7D,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChE,eAAe,EAAE,GAAG,EAAE,CAAC,iBAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,eAAe,CAAC;YACzE,KAAK,EAAE,GAAG,EAAE,CAAC,oBAAoB;SAClC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACzB,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACzC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,CAAC;YACD,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converters, populateObject, Result, fail, succeed } from '@fgv/ts-utils';\nimport { IQualifierDecl, IValidatedQualifierDecl } from '../qualifierDecl';\nimport { Validate } from '../../common';\nimport { ReadOnlyQualifierTypeCollector } from '../../qualifier-types';\n\n/* eslint-disable @rushstack/typedef-var */\n\n/**\n * Converter for a {@link Qualifiers.IQualifierDecl | qualifier declaration}.\n * @public\n */\nexport const qualifierDecl = Converters.strictObject<IQualifierDecl>({\n  name: Converters.string,\n  typeName: Converters.string,\n  defaultPriority: Converters.number,\n  token: Converters.string.optional(),\n  tokenIsOptional: Converters.boolean.optional()\n});\n\n/**\n * Context necessary to convert a {@link Qualifiers.IValidatedQualifierDecl | validated qualifier declaration}.\n * @public\n */\nexport interface IQualifierDeclConvertContext {\n  readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n  qualifierIndex?: number;\n}\n\n/**\n * Converter which constructs a {@link Qualifiers.IValidatedQualifierDecl | validated qualifier declaration}\n * from a {@link Qualifiers.IQualifierDecl | qualifier declaration}, instantiating qualifier types by name\n * from a supplied {@link Qualifiers.Convert.IQualifierDeclConvertContext | conversion context}.\n * @public\n */\nexport const validatedQualifierDecl = Converters.generic<\n  IValidatedQualifierDecl,\n  IQualifierDeclConvertContext\n>((from: unknown, __self, context?: IQualifierDeclConvertContext): Result<IValidatedQualifierDecl> => {\n  /* c8 ignore next 7  - this is tested but code coverage is losing its mind */\n  if (context === undefined) {\n    return fail('validatedQualifierDecl converter requires a context');\n  }\n  const validatedIndexResult =\n    context.qualifierIndex !== undefined\n      ? Validate.toQualifierIndex(context.qualifierIndex)\n      : succeed(undefined);\n\n  return qualifierDecl.convert(from).onSuccess((decl) => {\n    const token = decl.token ?? decl.name;\n    return populateObject<IValidatedQualifierDecl>({\n      name: () => Validate.toQualifierName(decl.name),\n      token: () => Validate.toQualifierName(token),\n      tokenIsOptional: () => succeed(decl.tokenIsOptional === true),\n      type: () => context.qualifierTypes.validating.get(decl.typeName),\n      defaultPriority: () => Validate.toConditionPriority(decl.defaultPriority),\n      index: () => validatedIndexResult\n    }).onSuccess((validated) => {\n      if (context.qualifierIndex !== undefined) {\n        context.qualifierIndex++;\n      }\n      return succeed(validated);\n    });\n  });\n});\n"]}

package/lib/packlets/qualifiers/convert/index.d.ts

@@ -0,0 +1,3 @@
+export * from './decls';
+export * from './qualifier';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/qualifiers/convert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/qualifiers/convert/index.ts"],"names":[],"mappings":"AAsBA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/lib/packlets/qualifiers/convert/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./decls"), exports);
+__exportStar(require("./qualifier"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/qualifiers/convert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/qualifiers/convert/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,8CAA4B","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\nexport * from './decls';\nexport * from './qualifier';\n"]}

package/lib/packlets/qualifiers/convert/qualifier.d.ts

@@ -0,0 +1,17 @@
+import { IReadOnlyQualifierCollector } from '../qualifierCollector';
+import { Qualifier } from '../qualifier';
+/**
+ * Context necessary to convert a string or number to a
+ * {@link Qualifiers.Qualifier | Qualifier} object.
+ * @public
+ */
+export interface IQualifierConvertContext {
+    qualifiers: IReadOnlyQualifierCollector;
+}
+/**
+ * Converter which choose a qualifier by name or number from a
+ * supplied {@link Qualifiers.Convert.IQualifierConvertContext | conversion context}.
+ * @public
+ */
+export declare const qualifier: import("@fgv/ts-utils").Converter<Qualifier, IQualifierConvertContext>;
+//# sourceMappingURL=qualifier.d.ts.map

package/lib/packlets/qualifiers/convert/qualifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifier.d.ts","sourceRoot":"","sources":["../../../../src/packlets/qualifiers/convert/qualifier.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,2BAA2B,CAAC;CACzC;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,wEAYrB,CAAC"}

package/lib/packlets/qualifiers/convert/qualifier.js

@@ -0,0 +1,43 @@
+"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.qualifier = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+/**
+ * Converter which choose a qualifier by name or number from a
+ * supplied {@link Qualifiers.Convert.IQualifierConvertContext | conversion context}.
+ * @public
+ */
+exports.qualifier = ts_utils_1.Converters.generic((from, __self, context) => {
+    if (context === undefined) {
+        return (0, ts_utils_1.fail)('qualifier converter requires a context');
+    }
+    if (typeof from === 'string') {
+        return context.qualifiers.validating.get(from);
+    }
+    else if (typeof from === 'number') {
+        return context.qualifiers.getAt(from);
+    }
+    return (0, ts_utils_1.fail)('qualifier converter requires a string or number');
+});
+//# sourceMappingURL=qualifier.js.map

package/lib/packlets/qualifiers/convert/qualifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifier.js","sourceRoot":"","sources":["../../../../src/packlets/qualifiers/convert/qualifier.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAyD;AAezD;;;;GAIG;AACU,QAAA,SAAS,GAAG,qBAAU,CAAC,OAAO,CACzC,CAAC,IAAa,EAAE,MAAM,EAAE,OAAkC,EAAqB,EAAE;IAC/E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAA,eAAI,EAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAA,eAAI,EAAC,iDAAiD,CAAC,CAAC;AACjE,CAAC,CACF,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converters, Result, fail } from '@fgv/ts-utils';\nimport { IReadOnlyQualifierCollector } from '../qualifierCollector';\nimport { Qualifier } from '../qualifier';\n\n/* eslint-disable @rushstack/typedef-var */\n\n/**\n * Context necessary to convert a string or number to a\n * {@link Qualifiers.Qualifier | Qualifier} object.\n * @public\n */\nexport interface IQualifierConvertContext {\n  qualifiers: IReadOnlyQualifierCollector;\n}\n\n/**\n * Converter which choose a qualifier by name or number from a\n * supplied {@link Qualifiers.Convert.IQualifierConvertContext | conversion context}.\n * @public\n */\nexport const qualifier = Converters.generic<Qualifier, IQualifierConvertContext>(\n  (from: unknown, __self, context?: IQualifierConvertContext): Result<Qualifier> => {\n    if (context === undefined) {\n      return fail('qualifier converter requires a context');\n    }\n    if (typeof from === 'string') {\n      return context.qualifiers.validating.get(from);\n    } else if (typeof from === 'number') {\n      return context.qualifiers.getAt(from);\n    }\n    return fail('qualifier converter requires a string or number');\n  }\n);\n"]}

package/lib/packlets/qualifiers/index.d.ts

@@ -0,0 +1,6 @@
+import * as Convert from './convert';
+export * from './qualifier';
+export * from './qualifierDecl';
+export * from './qualifierCollector';
+export { Convert };
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/qualifiers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,CAAC"}