@fgv/ts-res 4.5.0-0

package/lib/packlets/qualifiers/index.js

@@ -0,0 +1,66 @@
+"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;
+    };
+})();
+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 });
+exports.Convert = void 0;
+const Convert = __importStar(require("./convert"));
+exports.Convert = Convert;
+__exportStar(require("./qualifier"), exports);
+__exportStar(require("./qualifierDecl"), exports);
+__exportStar(require("./qualifierCollector"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/qualifiers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AAM5B,0BAAO;AAJhB,8CAA4B;AAC5B,kDAAgC;AAChC,uDAAqC","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 Convert from './convert';\n\nexport * from './qualifier';\nexport * from './qualifierDecl';\nexport * from './qualifierCollector';\n\nexport { Convert };\n"]}

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

@@ -0,0 +1,68 @@
+import { Collections, ICollectible, Result } from '@fgv/ts-utils';
+import { ConditionPriority, QualifierIndex, QualifierName } from '../common';
+import { QualifierType } from '../qualifier-types';
+import { IValidatedQualifierDecl } from './qualifierDecl';
+/**
+ * Represents a qualifier that can be used to identify the context in
+ * which a resource is used.
+ * @public
+ */
+export declare class Qualifier implements IValidatedQualifierDecl, ICollectible<QualifierName, QualifierIndex> {
+    /**
+     * The name of the qualifier.
+     */
+    readonly name: QualifierName;
+    /**
+     * The token used to identify the qualifier in the name or
+     * path of a resource being imported.
+     */
+    readonly token: QualifierName;
+    /**
+     * The {@link QualifierTypes.QualifierType | type} of the qualifier.
+     */
+    readonly type: QualifierType;
+    /**
+     * Indicates whether the token is optional in the name or path of a resource being imported.
+     */
+    readonly tokenIsOptional: boolean;
+    /**
+     * The index of the qualifier.
+     */
+    get index(): QualifierIndex | undefined;
+    /**
+     * The collector key for this qualifier.
+     */
+    get key(): QualifierName;
+    /**
+     * The default {@link ConditionPriority | priority} of conditions
+     * that depend on this qualifier.
+     */
+    readonly defaultPriority: ConditionPriority;
+    protected readonly _collectible: Collections.Collectible<QualifierName, QualifierIndex>;
+    /**
+     * Constructs a new instance of a {@link Qualifiers.Qualifier | Qualifier} from the
+     * supplied {@link Qualifiers.IValidatedQualifierDecl | validated declaration}.
+     * @param name - The name of the qualifier.
+     * @param type - The {@link QualifierTypes.QualifierType | type} of the qualifier.
+     * @param defaultPriority - The default {@link ConditionPriority | priority} of conditions
+     * @public
+     */
+    protected constructor({ name, token, type, defaultPriority, tokenIsOptional, index }: IValidatedQualifierDecl);
+    /**
+     * Creates a new instance of a {@link Qualifiers.Qualifier | Qualifier} from the
+     * supplied {@link Qualifiers.IValidatedQualifierDecl | validated declaration}.
+     * @param decl - The {@link Qualifiers.IValidatedQualifierDecl | validated declaration}
+     * for the new instance.
+     * @returns `Success` with the new {@link Qualifiers.Qualifier | Qualifier} if successful,
+     * `Failure` with an error message otherwise.
+     * @public
+     */
+    static create(decl: IValidatedQualifierDecl): Result<Qualifier>;
+    /**
+     * Sets the index of this qualifier.  Once set, the index cannot be changed.
+     * @param index - The index to set.
+     * @returns `Success` with the index if successful, `Failure` with an error message otherwise.
+     */
+    setIndex(index: QualifierIndex): Result<QualifierIndex>;
+}
+//# sourceMappingURL=qualifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifier.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifier.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiB,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAA4B,MAAM,WAAW,CAAC;AACvG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;GAIG;AACH,qBAAa,SAAU,YAAW,uBAAuB,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC;IACpG;;OAEG;IACH,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;;OAGG;IACH,SAAgB,KAAK,EAAE,aAAa,CAAC;IAErC;;OAEG;IACH,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;OAEG;IACH,SAAgB,eAAe,EAAE,OAAO,CAAC;IAEzC;;OAEG;IACH,IAAW,KAAK,IAAI,cAAc,GAAG,SAAS,CAE7C;IAED;;OAEG;IACH,IAAW,GAAG,IAAI,aAAa,CAE9B;IAED;;;OAGG;IACH,SAAgB,eAAe,EAAE,iBAAiB,CAAC;IAEnD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAExF;;;;;;;OAOG;IACH,SAAS,aAAa,EACpB,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,eAAe,EACf,eAAe,EACf,KAAK,EACN,EAAE,uBAAuB;IAa1B;;;;;;;;OAQG;WACW,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,SAAS,CAAC;IAItE;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;CAG/D"}

package/lib/packlets/qualifiers/qualifier.js

@@ -0,0 +1,87 @@
+"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");
+const common_1 = require("../common");
+/**
+ * Represents a qualifier that can be used to identify the context in
+ * which a resource is used.
+ * @public
+ */
+class Qualifier {
+    /**
+     * The index of the qualifier.
+     */
+    get index() {
+        return this._collectible.index;
+    }
+    /**
+     * The collector key for this qualifier.
+     */
+    get key() {
+        return this._collectible.key;
+    }
+    /**
+     * Constructs a new instance of a {@link Qualifiers.Qualifier | Qualifier} from the
+     * supplied {@link Qualifiers.IValidatedQualifierDecl | validated declaration}.
+     * @param name - The name of the qualifier.
+     * @param type - The {@link QualifierTypes.QualifierType | type} of the qualifier.
+     * @param defaultPriority - The default {@link ConditionPriority | priority} of conditions
+     * @public
+     */
+    constructor({ name, token, type, defaultPriority, tokenIsOptional, index }) {
+        this.name = name;
+        this.token = token;
+        this.type = type;
+        this.defaultPriority = defaultPriority;
+        this.tokenIsOptional = tokenIsOptional;
+        this._collectible = new ts_utils_1.Collections.Collectible({
+            key: name,
+            index,
+            indexConverter: common_1.Convert.qualifierIndex
+        });
+    }
+    /**
+     * Creates a new instance of a {@link Qualifiers.Qualifier | Qualifier} from the
+     * supplied {@link Qualifiers.IValidatedQualifierDecl | validated declaration}.
+     * @param decl - The {@link Qualifiers.IValidatedQualifierDecl | validated declaration}
+     * for the new instance.
+     * @returns `Success` with the new {@link Qualifiers.Qualifier | Qualifier} if successful,
+     * `Failure` with an error message otherwise.
+     * @public
+     */
+    static create(decl) {
+        return (0, ts_utils_1.captureResult)(() => new Qualifier(decl));
+    }
+    /**
+     * Sets the index of this qualifier.  Once set, the index cannot be changed.
+     * @param index - The index to set.
+     * @returns `Success` with the index if successful, `Failure` with an error message otherwise.
+     */
+    setIndex(index) {
+        return this._collectible.setIndex(index);
+    }
+}
+exports.Qualifier = Qualifier;
+//# sourceMappingURL=qualifier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifier.js","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifier.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAiF;AACjF,sCAAuG;AAIvG;;;;GAIG;AACH,MAAa,SAAS;IAsBpB;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;IAC/B,CAAC;IAUD;;;;;;;OAOG;IACH,YAAsB,EACpB,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,eAAe,EACf,eAAe,EACf,KAAK,EACmB;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,IAAI,sBAAW,CAAC,WAAW,CAAgC;YAC7E,GAAG,EAAE,IAAI;YACT,KAAK;YACL,cAAc,EAAE,gBAAa,CAAC,cAAc;SAC7C,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,IAA6B;QAChD,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,KAAqB;QACnC,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF;AA7FD,8BA6FC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, Collections, ICollectible, Result } from '@fgv/ts-utils';\nimport { ConditionPriority, QualifierIndex, QualifierName, Convert as CommonConvert } from '../common';\nimport { QualifierType } from '../qualifier-types';\nimport { IValidatedQualifierDecl } from './qualifierDecl';\n\n/**\n * Represents a qualifier that can be used to identify the context in\n * which a resource is used.\n * @public\n */\nexport class Qualifier implements IValidatedQualifierDecl, ICollectible<QualifierName, QualifierIndex> {\n  /**\n   * The name of the qualifier.\n   */\n  public readonly name: QualifierName;\n\n  /**\n   * The token used to identify the qualifier in the name or\n   * path of a resource being imported.\n   */\n  public readonly token: QualifierName;\n\n  /**\n   * The {@link QualifierTypes.QualifierType | type} of the qualifier.\n   */\n  public readonly type: QualifierType;\n\n  /**\n   * Indicates whether the token is optional in the name or path of a resource being imported.\n   */\n  public readonly tokenIsOptional: boolean;\n\n  /**\n   * The index of the qualifier.\n   */\n  public get index(): QualifierIndex | undefined {\n    return this._collectible.index;\n  }\n\n  /**\n   * The collector key for this qualifier.\n   */\n  public get key(): QualifierName {\n    return this._collectible.key;\n  }\n\n  /**\n   * The default {@link ConditionPriority | priority} of conditions\n   * that depend on this qualifier.\n   */\n  public readonly defaultPriority: ConditionPriority;\n\n  protected readonly _collectible: Collections.Collectible<QualifierName, QualifierIndex>;\n\n  /**\n   * Constructs a new instance of a {@link Qualifiers.Qualifier | Qualifier} from the\n   * supplied {@link Qualifiers.IValidatedQualifierDecl | validated declaration}.\n   * @param name - The name of the qualifier.\n   * @param type - The {@link QualifierTypes.QualifierType | type} of the qualifier.\n   * @param defaultPriority - The default {@link ConditionPriority | priority} of conditions\n   * @public\n   */\n  protected constructor({\n    name,\n    token,\n    type,\n    defaultPriority,\n    tokenIsOptional,\n    index\n  }: IValidatedQualifierDecl) {\n    this.name = name;\n    this.token = token;\n    this.type = type;\n    this.defaultPriority = defaultPriority;\n    this.tokenIsOptional = tokenIsOptional;\n    this._collectible = new Collections.Collectible<QualifierName, QualifierIndex>({\n      key: name,\n      index,\n      indexConverter: CommonConvert.qualifierIndex\n    });\n  }\n\n  /**\n   * Creates a new instance of a {@link Qualifiers.Qualifier | Qualifier} from the\n   * supplied {@link Qualifiers.IValidatedQualifierDecl | validated declaration}.\n   * @param decl - The {@link Qualifiers.IValidatedQualifierDecl | validated declaration}\n   * for the new instance.\n   * @returns `Success` with the new {@link Qualifiers.Qualifier | Qualifier} if successful,\n   * `Failure` with an error message otherwise.\n   * @public\n   */\n  public static create(decl: IValidatedQualifierDecl): Result<Qualifier> {\n    return captureResult(() => new Qualifier(decl));\n  }\n\n  /**\n   * Sets the index of this qualifier.  Once set, the index cannot be changed.\n   * @param index - The index to set.\n   * @returns `Success` with the index if successful, `Failure` with an error message otherwise.\n   */\n  public setIndex(index: QualifierIndex): Result<QualifierIndex> {\n    return this._collectible.setIndex(index);\n  }\n}\n"]}

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

@@ -0,0 +1,90 @@
+import { Collections, Result, ValidatingConvertingCollector } from '@fgv/ts-utils';
+import { IQualifierDecl } from './qualifierDecl';
+import { QualifierName } from '../common';
+import { Qualifier } from './qualifier';
+import { ReadOnlyQualifierTypeCollector } from '../qualifier-types';
+/**
+ * Readonly version of {@link Qualifiers.QualifierCollector | QualifierCollector}.
+ * @public
+ */
+export interface IReadOnlyQualifierCollector extends Collections.IReadOnlyValidatingCollector<Qualifier> {
+    /**
+     * {@inheritdoc Qualifiers.QualifierCollector.qualifierTypes}
+     */
+    readonly qualifierTypes: ReadOnlyQualifierTypeCollector;
+    /**
+     * Gets a {@link Qualifiers.Qualifier | qualifier} by name or token.
+     * @param nameOrToken - The name or token of the qualifier to retrieve.
+     * @returns `Success` with the qualifier if found, or `Failure` if not.
+     */
+    getByNameOrToken(nameOrToken: string): Result<Qualifier>;
+    /**
+     * Checks if a qualifier with a given name or token is in the collection.
+     * @param nameOrToken - The name or token of the qualifier to check.
+     * @returns `true` if the qualifier is in the collection, `false` if not.
+     */
+    hasNameOrToken(nameOrToken: string): boolean;
+}
+/**
+ * Parameters for creating a new {@link Qualifiers.QualifierCollector}.
+ * @public
+ */
+export interface IQualifierCollectorCreateParams {
+    /**
+     * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} used to
+     * create {@link Qualifiers.Qualifier | qualifiers} from {@link Qualifiers.IQualifierDecl | declarations}.
+     */
+    qualifierTypes: ReadOnlyQualifierTypeCollector;
+    /**
+     * Optional list of {@link Qualifiers.IQualifierDecl | declarations} for the qualifiers to add to the collection
+     * upon creation.
+     */
+    qualifiers?: IQualifierDecl[];
+}
+/**
+ * Collects {@link Qualifiers.Qualifier | Qualifiers} from {@link Qualifiers.IQualifierDecl | declarations},
+ * with strongly-typed ({@link QualifierName | QualifierName} and {@link QualifierIndex | QualifierIndex}) key
+ * and index.
+ * @public
+ */
+export declare class QualifierCollector extends ValidatingConvertingCollector<Qualifier, IQualifierDecl> implements IReadOnlyQualifierCollector {
+    /**
+     * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this collector uses.
+     */
+    qualifierTypes: ReadOnlyQualifierTypeCollector;
+    /**
+     * Constructor for a {@link Qualifiers.QualifierCollector | QualifierCollector} object.
+     * @param params - Parameters for creating the collector.
+     * @public
+     */
+    protected constructor(params: IQualifierCollectorCreateParams);
+    /**
+     * Creates a new {@link Qualifiers.QualifierCollector | QualifierCollector} object.
+     * @param params - {@link Qualifiers.IQualifierCollectorCreateParams | Parameters} for creating a new {@link Qualifiers.QualifierCollector | QualifierCollector}.
+     * @returns `Success` with the new collector if successful, or `Failure` if not.
+     */
+    static create(params: IQualifierCollectorCreateParams): Result<QualifierCollector>;
+    /**
+     * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.getByNameOrToken}
+     */
+    getByNameOrToken(nameOrToken: string): Result<Qualifier>;
+    /**
+     * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.hasNameOrToken}
+     */
+    hasNameOrToken(nameOrToken: string): boolean;
+    /**
+     * Gets a read-only view of this collector.
+     * @returns A read-only view of this collector.
+     */
+    toReadOnly(): IReadOnlyQualifierCollector;
+    /**
+     * Factory method for creating a {@link Qualifiers.Qualifier | Qualifier} from a {@link Qualifiers.IQualifierDecl | declaration}.
+     * @param __key - The key for the qualifier.
+     * @param index - The index of the qualifier.
+     * @param decl - The {@link Qualifiers.IQualifierDecl | declaration} for the qualifier.
+     * @returns `Success` with the new {@link Qualifiers.Qualifier | Qualifier} if successful, or `Failure` if not.
+     * @public
+     */
+    protected _qualifierFactory(__key: QualifierName, index: number, decl: IQualifierDecl): Result<Qualifier>;
+}
+//# sourceMappingURL=qualifierCollector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierCollector.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierCollector.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,WAAW,EAEX,MAAM,EAIN,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAA2B,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,WAAW,CAAC,4BAA4B,CAAC,SAAS,CAAC;IACtG;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IAExD;;;;OAIG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEzD;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,cAAc,EAAE,8BAA8B,CAAC;IAE/C;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,kBACX,SAAQ,6BAA6B,CAAC,SAAS,EAAE,cAAc,CAC/D,YAAW,2BAA2B;IAEtC;;OAEG;IACI,cAAc,EAAE,8BAA8B,CAAC;IAEtD;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,+BAA+B;IAa7D;;;;OAIG;WACW,MAAM,CAAC,MAAM,EAAE,+BAA+B,GAAG,MAAM,CAAC,kBAAkB,CAAC;IAIzF;;OAEG;IACI,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;IAW/D;;OAEG;IACI,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAYnD;;;OAGG;IACI,UAAU,IAAI,2BAA2B;IAIhD;;;;;;;OAOG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC;CAqB1G"}

package/lib/packlets/qualifiers/qualifierCollector.js

@@ -0,0 +1,157 @@
+"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.QualifierCollector = void 0;
+const Common = __importStar(require("../common"));
+const ts_utils_1 = require("@fgv/ts-utils");
+const qualifier_1 = require("./qualifier");
+const convert_1 = require("./convert");
+/**
+ * Collects {@link Qualifiers.Qualifier | Qualifiers} from {@link Qualifiers.IQualifierDecl | declarations},
+ * with strongly-typed ({@link QualifierName | QualifierName} and {@link QualifierIndex | QualifierIndex}) key
+ * and index.
+ * @public
+ */
+class QualifierCollector extends ts_utils_1.ValidatingConvertingCollector {
+    /**
+     * Constructor for a {@link Qualifiers.QualifierCollector | QualifierCollector} object.
+     * @param params - Parameters for creating the collector.
+     * @public
+     */
+    constructor(params) {
+        var _a;
+        super({
+            factory: (k, i, v) => this._qualifierFactory(k, i, v),
+            converters: new ts_utils_1.Collections.KeyValueConverters({
+                key: Common.Convert.qualifierName,
+                value: convert_1.qualifierDecl
+            })
+        });
+        this.qualifierTypes = params.qualifierTypes;
+        /* c8 ignore next 1 - coverage misses the branch intermittently */
+        (_a = params.qualifiers) === null || _a === void 0 ? void 0 : _a.forEach((q) => this.validating.add(q.name, q).orThrow());
+    }
+    /**
+     * Creates a new {@link Qualifiers.QualifierCollector | QualifierCollector} object.
+     * @param params - {@link Qualifiers.IQualifierCollectorCreateParams | Parameters} for creating a new {@link Qualifiers.QualifierCollector | QualifierCollector}.
+     * @returns `Success` with the new collector if successful, or `Failure` if not.
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new QualifierCollector(params));
+    }
+    /**
+     * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.getByNameOrToken}
+     */
+    getByNameOrToken(nameOrToken) {
+        return this.validating.get(nameOrToken).onFailure((message) => {
+            for (const q of this.values()) {
+                if (q.token === nameOrToken) {
+                    return (0, ts_utils_1.succeedWithDetail)(q, 'success');
+                }
+            }
+            return (0, ts_utils_1.failWithDetail)(`Qualifier token '${nameOrToken}' not found`, 'not-found');
+        });
+    }
+    /**
+     * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.hasNameOrToken}
+     */
+    hasNameOrToken(nameOrToken) {
+        if (this.validating.has(nameOrToken)) {
+            return true;
+        }
+        for (const q of this.values()) {
+            if (q.token === nameOrToken) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Gets a read-only view of this collector.
+     * @returns A read-only view of this collector.
+     */
+    toReadOnly() {
+        return this;
+    }
+    /**
+     * Factory method for creating a {@link Qualifiers.Qualifier | Qualifier} from a {@link Qualifiers.IQualifierDecl | declaration}.
+     * @param __key - The key for the qualifier.
+     * @param index - The index of the qualifier.
+     * @param decl - The {@link Qualifiers.IQualifierDecl | declaration} for the qualifier.
+     * @returns `Success` with the new {@link Qualifiers.Qualifier | Qualifier} if successful, or `Failure` if not.
+     * @public
+     */
+    _qualifierFactory(__key, index, decl) {
+        const convertContext = {
+            qualifierTypes: this.qualifierTypes,
+            qualifierIndex: index
+        };
+        return convert_1.validatedQualifierDecl
+            .convert(decl, convertContext)
+            .onSuccess((validated) => {
+            if (this.hasNameOrToken(validated.token)) {
+                return (0, ts_utils_1.fail)(`Qualifier token '${validated.token}' is not unique or collides with name`);
+            }
+            else if (this.hasNameOrToken(validated.name)) {
+                return (0, ts_utils_1.fail)(`Qualifier name '${validated.name}' is not unique or collides with token`);
+            }
+            return (0, ts_utils_1.succeed)(validated);
+        })
+            .onSuccess(qualifier_1.Qualifier.create);
+    }
+}
+exports.QualifierCollector = QualifierCollector;
+//# sourceMappingURL=qualifierCollector.js.map

package/lib/packlets/qualifiers/qualifierCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierCollector.js","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierCollector.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 * as Common from '../common';\nimport {\n  captureResult,\n  Collections,\n  failWithDetail,\n  Result,\n  fail,\n  succeed,\n  succeedWithDetail,\n  ValidatingConvertingCollector\n} from '@fgv/ts-utils';\nimport { IQualifierDecl, IValidatedQualifierDecl } from './qualifierDecl';\nimport { QualifierName } from '../common';\nimport { Qualifier } from './qualifier';\nimport { IQualifierDeclConvertContext, qualifierDecl, validatedQualifierDecl } from './convert';\nimport { ReadOnlyQualifierTypeCollector } from '../qualifier-types';\n\n/**\n * Readonly version of {@link Qualifiers.QualifierCollector | QualifierCollector}.\n * @public\n */\nexport interface IReadOnlyQualifierCollector extends Collections.IReadOnlyValidatingCollector<Qualifier> {\n  /**\n   * {@inheritdoc Qualifiers.QualifierCollector.qualifierTypes}\n   */\n  readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * Gets a {@link Qualifiers.Qualifier | qualifier} by name or token.\n   * @param nameOrToken - The name or token of the qualifier to retrieve.\n   * @returns `Success` with the qualifier if found, or `Failure` if not.\n   */\n  getByNameOrToken(nameOrToken: string): Result<Qualifier>;\n\n  /**\n   * Checks if a qualifier with a given name or token is in the collection.\n   * @param nameOrToken - The name or token of the qualifier to check.\n   * @returns `true` if the qualifier is in the collection, `false` if not.\n   */\n  hasNameOrToken(nameOrToken: string): boolean;\n}\n\n/**\n * Parameters for creating a new {@link Qualifiers.QualifierCollector}.\n * @public\n */\nexport interface IQualifierCollectorCreateParams {\n  /**\n   * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} used to\n   * create {@link Qualifiers.Qualifier | qualifiers} from {@link Qualifiers.IQualifierDecl | declarations}.\n   */\n  qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * Optional list of {@link Qualifiers.IQualifierDecl | declarations} for the qualifiers to add to the collection\n   * upon creation.\n   */\n  qualifiers?: IQualifierDecl[];\n}\n\n/**\n * Collects {@link Qualifiers.Qualifier | Qualifiers} from {@link Qualifiers.IQualifierDecl | declarations},\n * with strongly-typed ({@link QualifierName | QualifierName} and {@link QualifierIndex | QualifierIndex}) key\n * and index.\n * @public\n */\nexport class QualifierCollector\n  extends ValidatingConvertingCollector<Qualifier, IQualifierDecl>\n  implements IReadOnlyQualifierCollector\n{\n  /**\n   * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this collector uses.\n   */\n  public qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * Constructor for a {@link Qualifiers.QualifierCollector | QualifierCollector} object.\n   * @param params - Parameters for creating the collector.\n   * @public\n   */\n  protected constructor(params: IQualifierCollectorCreateParams) {\n    super({\n      factory: (k, i, v) => this._qualifierFactory(k, i, v),\n      converters: new Collections.KeyValueConverters({\n        key: Common.Convert.qualifierName,\n        value: qualifierDecl\n      })\n    });\n    this.qualifierTypes = params.qualifierTypes;\n    /* c8 ignore next 1 - coverage misses the branch intermittently */\n    params.qualifiers?.forEach((q) => this.validating.add(q.name, q).orThrow());\n  }\n\n  /**\n   * Creates a new {@link Qualifiers.QualifierCollector | QualifierCollector} object.\n   * @param params - {@link Qualifiers.IQualifierCollectorCreateParams | Parameters} for creating a new {@link Qualifiers.QualifierCollector | QualifierCollector}.\n   * @returns `Success` with the new collector if successful, or `Failure` if not.\n   */\n  public static create(params: IQualifierCollectorCreateParams): Result<QualifierCollector> {\n    return captureResult(() => new QualifierCollector(params));\n  }\n\n  /**\n   * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.getByNameOrToken}\n   */\n  public getByNameOrToken(nameOrToken: string): Result<Qualifier> {\n    return this.validating.get(nameOrToken).onFailure((message) => {\n      for (const q of this.values()) {\n        if (q.token === nameOrToken) {\n          return succeedWithDetail(q, 'success');\n        }\n      }\n      return failWithDetail(`Qualifier token '${nameOrToken}' not found`, 'not-found');\n    });\n  }\n\n  /**\n   * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.hasNameOrToken}\n   */\n  public hasNameOrToken(nameOrToken: string): boolean {\n    if (this.validating.has(nameOrToken)) {\n      return true;\n    }\n    for (const q of this.values()) {\n      if (q.token === nameOrToken) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Gets a read-only view of this collector.\n   * @returns A read-only view of this collector.\n   */\n  public toReadOnly(): IReadOnlyQualifierCollector {\n    return this;\n  }\n\n  /**\n   * Factory method for creating a {@link Qualifiers.Qualifier | Qualifier} from a {@link Qualifiers.IQualifierDecl | declaration}.\n   * @param __key - The key for the qualifier.\n   * @param index - The index of the qualifier.\n   * @param decl - The {@link Qualifiers.IQualifierDecl | declaration} for the qualifier.\n   * @returns `Success` with the new {@link Qualifiers.Qualifier | Qualifier} if successful, or `Failure` if not.\n   * @public\n   */\n  protected _qualifierFactory(__key: QualifierName, index: number, decl: IQualifierDecl): Result<Qualifier> {\n    const convertContext: IQualifierDeclConvertContext = {\n      qualifierTypes: this.qualifierTypes,\n      qualifierIndex: index\n    };\n    return validatedQualifierDecl\n      .convert(decl, convertContext)\n      .onSuccess((validated) => {\n        if (this.hasNameOrToken(validated.token)) {\n          return fail<IValidatedQualifierDecl>(\n            `Qualifier token '${validated.token}' is not unique or collides with name`\n          );\n        } else if (this.hasNameOrToken(validated.name)) {\n          return fail<IValidatedQualifierDecl>(\n            `Qualifier name '${validated.name}' is not unique or collides with token`\n          );\n        }\n        return succeed(validated);\n      })\n      .onSuccess(Qualifier.create);\n  }\n}\n"]}

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

@@ -0,0 +1,46 @@
+import { ConditionPriority, QualifierIndex, QualifierName } from '../common';
+import { QualifierType } from '../qualifier-types';
+/**
+ * Simple declaration for a {@link Qualifiers.Qualifier | Qualifier}.
+ * @public
+ */
+export interface IQualifierDecl {
+    name: string;
+    typeName: string;
+    defaultPriority: number;
+    token?: string;
+    tokenIsOptional?: boolean;
+}
+/**
+ * Validated declaration for a {@link Qualifiers.Qualifier | Qualifier}.
+ * @public
+ */
+export interface IValidatedQualifierDecl {
+    /**
+     * The name of the qualifier.
+     */
+    name: QualifierName;
+    /**
+     * The token used to identify the qualifier in the name or
+     * path of a resource being imported.
+     */
+    token: QualifierName;
+    /**
+     * The {@link QualifierTypes.QualifierType | type} of the qualifier.
+     */
+    type: QualifierType;
+    /**
+     * The default {@link ConditionPriority | priority} of conditions
+     * that depend on this qualifier.
+     */
+    defaultPriority: ConditionPriority;
+    /**
+     * Indicates whether the token is optional when parsing a resource token.
+     */
+    tokenIsOptional: boolean;
+    /**
+     * Index of the qualifier.
+     */
+    index: QualifierIndex | undefined;
+}
+//# sourceMappingURL=qualifierDecl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDecl.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDecl.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;;OAGG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;;OAGG;IACH,eAAe,EAAE,iBAAiB,CAAC;IAEnC;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;CACnC"}

package/lib/packlets/qualifiers/qualifierDecl.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=qualifierDecl.js.map

package/lib/packlets/qualifiers/qualifierDecl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDecl.js","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDecl.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { ConditionPriority, QualifierIndex, QualifierName } from '../common';\nimport { QualifierType } from '../qualifier-types';\n\n/**\n * Simple declaration for a {@link Qualifiers.Qualifier | Qualifier}.\n * @public\n */\nexport interface IQualifierDecl {\n  name: string;\n  typeName: string;\n  defaultPriority: number;\n  token?: string;\n  tokenIsOptional?: boolean;\n}\n\n/**\n * Validated declaration for a {@link Qualifiers.Qualifier | Qualifier}.\n * @public\n */\nexport interface IValidatedQualifierDecl {\n  /**\n   * The name of the qualifier.\n   */\n  name: QualifierName;\n\n  /**\n   * The token used to identify the qualifier in the name or\n   * path of a resource being imported.\n   */\n  token: QualifierName;\n\n  /**\n   * The {@link QualifierTypes.QualifierType | type} of the qualifier.\n   */\n  type: QualifierType;\n\n  /**\n   * The default {@link ConditionPriority | priority} of conditions\n   * that depend on this qualifier.\n   */\n  defaultPriority: ConditionPriority;\n\n  /**\n   * Indicates whether the token is optional when parsing a resource token.\n   */\n  tokenIsOptional: boolean;\n\n  /**\n   * Index of the qualifier.\n   */\n  index: QualifierIndex | undefined;\n}\n"]}