@fgv/ts-res 4.5.0-3 → 5.0.0-10

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

@@ -1 +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"]}
+{"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    /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n    if (this.validating.has(nameOrToken)) {\n      return true;\n    }\n    for (const q of this.values()) {\n      /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\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        /* c8 ignore next 9 - coverage intermittently misses this block */\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

@@ -1,4 +1,4 @@
-import { ConditionPriority, QualifierIndex, QualifierName } from '../common';
+import { ConditionPriority, QualifierContextValue, QualifierIndex, QualifierName } from '../common';
 import { QualifierType } from '../qualifier-types';
 /**
  * Simple declaration for a {@link Qualifiers.Qualifier | Qualifier}.
@@ -10,6 +10,7 @@ export interface IQualifierDecl {
     defaultPriority: number;
     token?: string;
     tokenIsOptional?: boolean;
+    defaultValue?: string;
 }
 /**
  * Validated declaration for a {@link Qualifiers.Qualifier | Qualifier}.
@@ -38,6 +39,10 @@ export interface IValidatedQualifierDecl {
      * Indicates whether the token is optional when parsing a resource token.
      */
     tokenIsOptional: boolean;
+    /**
+     * Optional default value for the qualifier.
+     */
+    defaultValue?: QualifierContextValue;
     /**
      * Index of the qualifier.
      */

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

@@ -1 +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"}
+{"version":3,"file":"qualifierDecl.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDecl.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACpG,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;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;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,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAErC;;OAEG;IACH,KAAK,EAAE,cAAc,GAAG,SAAS,CAAC;CACnC"}

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

@@ -1 +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"]}
+{"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, QualifierContextValue, 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  defaultValue?: string;\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   * Optional default value for the qualifier.\n   */\n  defaultValue?: QualifierContextValue;\n\n  /**\n   * Index of the qualifier.\n   */\n  index: QualifierIndex | undefined;\n}\n"]}

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

@@ -0,0 +1,32 @@
+import { QualifierContextValue, QualifierName } from '../common';
+import { Qualifier } from './qualifier';
+/**
+ * Non-validated declaration of a single qualifier default value.
+ * @public
+ */
+export interface IQualifierDefaultValueDecl {
+    qualifier: string;
+    value: string;
+}
+/**
+ * Non-validated declaration of qualifier default values, consisting of named
+ * default values.
+ * @public
+ */
+export type IQualifierDefaultValuesDecl = Record<string, string>;
+/**
+ * Validated declaration of a single qualifier default value.
+ * @public
+ */
+export interface IValidatedQualifierDefaultValueDecl {
+    qualifier: Qualifier;
+    value: QualifierContextValue;
+}
+/**
+ * Validated declaration of qualifier default values, a record with strongly-typed
+ * {@link QualifierName | qualifier names} as keys and
+ * {@link QualifierContextValue | qualifier context values} as values.
+ * @public
+ */
+export type IValidatedQualifierDefaultValuesDecl = Record<QualifierName, QualifierContextValue>;
+//# sourceMappingURL=qualifierDefaultValueDecls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDefaultValueDecls.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDefaultValueDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,oCAAoC,GAAG,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDefaultValueDecls.js","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDefaultValueDecls.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 { QualifierContextValue, QualifierName } from '../common';\nimport { Qualifier } from './qualifier';\n\n/**\n * Non-validated declaration of a single qualifier default value.\n * @public\n */\nexport interface IQualifierDefaultValueDecl {\n  qualifier: string;\n  value: string;\n}\n\n/**\n * Non-validated declaration of qualifier default values, consisting of named\n * default values.\n * @public\n */\nexport type IQualifierDefaultValuesDecl = Record<string, string>;\n\n/**\n * Validated declaration of a single qualifier default value.\n * @public\n */\nexport interface IValidatedQualifierDefaultValueDecl {\n  qualifier: Qualifier;\n  value: QualifierContextValue;\n}\n\n/**\n * Validated declaration of qualifier default values, a record with strongly-typed\n * {@link QualifierName | qualifier names} as keys and\n * {@link QualifierContextValue | qualifier context values} as values.\n * @public\n */\nexport type IValidatedQualifierDefaultValuesDecl = Record<QualifierName, QualifierContextValue>;\n"]}

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

@@ -0,0 +1,96 @@
+import { Result } from '@fgv/ts-utils';
+import { Helpers as CommonHelpers } from '../common';
+import { IValidatedQualifierDefaultValueDecl, IValidatedQualifierDefaultValuesDecl } from './qualifierDefaultValueDecls';
+import { IReadOnlyQualifierCollector } from './qualifierCollector';
+/**
+ * Helper class to parse and validate qualifier default value tokens.
+ * @public
+ */
+export declare class QualifierDefaultValueTokens {
+    /**
+     * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to validate
+     * qualifier names and values.
+     */
+    readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Constructs a new {@link Qualifiers.QualifierDefaultValueTokens | QualifierDefaultValueTokens } instance.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     */
+    constructor(qualifiers: IReadOnlyQualifierCollector);
+    /**
+     * Parses a {@link QualifierDefaultValueToken | qualifier default value token} string and validates the parts
+     * against the qualifiers present in the {@link Qualifiers.QualifierDefaultValueTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseQualifierDefaultValueToken(token: string): Result<IValidatedQualifierDefaultValueDecl>;
+    /**
+     * Parses a {@link QualifierDefaultValuesToken | qualifier default values token} string and validates the parts
+     * against the qualifiers present in the {@link Qualifiers.QualifierDefaultValueTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the array of {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declarations}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseQualifierDefaultValuesToken(token: string): Result<IValidatedQualifierDefaultValueDecl[]>;
+    /**
+     * Validates the {@link Helpers.IQualifierDefaultValueTokenParts | parts} of a {@link QualifierDefaultValueToken | qualifier default value token}.
+     * @param parts - the parts to validate
+     * @returns `Success` with the validated declaration if successful, `Failure` with an error message if not.
+     */
+    validateQualifierDefaultValueTokenParts(parts: CommonHelpers.IQualifierDefaultValueTokenParts): Result<IValidatedQualifierDefaultValueDecl>;
+    /**
+     * Converts a {@link QualifierDefaultValuesToken | qualifier default values token} to a validated qualifier default values declaration.
+     * @param token - the qualifier default values token to convert
+     * @returns `Success` with the validated qualifier default values declaration if successful, `Failure` with an error message if not.
+     */
+    qualifierDefaultValuesTokenToDecl(token: string): Result<IValidatedQualifierDefaultValuesDecl>;
+    /**
+     * Converts a validated qualifier default values declaration to a {@link QualifierDefaultValuesToken | qualifier default values token}.
+     * @param decl - the validated qualifier default values declaration to convert
+     * @returns `Success` with the qualifier default values token if successful, `Failure` with an error message if not.
+     */
+    declToQualifierDefaultValuesToken(decl: IValidatedQualifierDefaultValuesDecl): Result<string>;
+    /**
+     * Parses a {@link QualifierDefaultValueToken | qualifier default value token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with a {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static parseQualifierDefaultValueToken(token: string, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedQualifierDefaultValueDecl>;
+    /**
+     * Parses a {@link QualifierDefaultValuesToken | qualifier default values token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with an array of {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declarations}
+     * if successful, `Failure` with an error message if not
+     */
+    static parseQualifierDefaultValuesToken(token: string, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedQualifierDefaultValueDecl[]>;
+    /**
+     * Validates the parts of a qualifier default value token against the qualifiers present in the supplied
+     * {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param parts - the {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts} to validate.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to
+     * validate qualifier names and values.
+     * @returns `Success` with a {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static validateQualifierDefaultValueTokenParts(parts: CommonHelpers.IQualifierDefaultValueTokenParts, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedQualifierDefaultValueDecl>;
+    /**
+     * Converts a {@link QualifierDefaultValuesToken | qualifier default values token} to a validated qualifier default values declaration.
+     * @param token - the qualifier default values token to convert
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with the validated qualifier default values declaration if successful, `Failure` with an error message if not.
+     */
+    static qualifierDefaultValuesTokenToDecl(token: string, qualifiers: IReadOnlyQualifierCollector): Result<IValidatedQualifierDefaultValuesDecl>;
+    /**
+     * Converts a validated qualifier default values declaration to a {@link QualifierDefaultValuesToken | qualifier default values token}.
+     * @param decl - the validated qualifier default values declaration to convert
+     * @returns `Success` with the qualifier default values token if successful, `Failure` with an error message if not.
+     */
+    static declToQualifierDefaultValuesToken(decl: IValidatedQualifierDefaultValuesDecl): Result<string>;
+}
+//# sourceMappingURL=qualifierDefaultValueToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDefaultValueToken.d.ts","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDefaultValueToken.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAwC,MAAM,WAAW,CAAC;AAC3F,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,qBAAa,2BAA2B;IACtC;;;OAGG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;;OAGG;gBACgB,UAAU,EAAE,2BAA2B;IAI1D;;;;;;OAMG;IACI,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,mCAAmC,CAAC;IAIlG;;;;;;OAMG;IACI,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,mCAAmC,EAAE,CAAC;IAIrG;;;;OAIG;IACI,uCAAuC,CAC5C,KAAK,EAAE,aAAa,CAAC,gCAAgC,GACpD,MAAM,CAAC,mCAAmC,CAAC;IAI9C;;;;OAIG;IACI,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,oCAAoC,CAAC;IAIrG;;;;OAIG;IACI,iCAAiC,CAAC,IAAI,EAAE,oCAAoC,GAAG,MAAM,CAAC,MAAM,CAAC;IAIpG;;;;;;;OAOG;WACW,+BAA+B,CAC3C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,mCAAmC,CAAC;IAM9C;;;;;;;OAOG;WACW,gCAAgC,CAC5C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,mCAAmC,EAAE,CAAC;IAUhD;;;;;;;;OAQG;WACW,uCAAuC,CACnD,KAAK,EAAE,aAAa,CAAC,gCAAgC,EACrD,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,mCAAmC,CAAC;IAgB9C;;;;;OAKG;WACW,iCAAiC,CAC7C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,2BAA2B,GACtC,MAAM,CAAC,oCAAoC,CAAC;IAyB/C;;;;OAIG;WACW,iCAAiC,CAC7C,IAAI,EAAE,oCAAoC,GACzC,MAAM,CAAC,MAAM,CAAC;CAsBlB"}

package/lib/packlets/qualifiers/qualifierDefaultValueToken.js

@@ -0,0 +1,179 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QualifierDefaultValueTokens = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+/**
+ * Helper class to parse and validate qualifier default value tokens.
+ * @public
+ */
+class QualifierDefaultValueTokens {
+    /**
+     * Constructs a new {@link Qualifiers.QualifierDefaultValueTokens | QualifierDefaultValueTokens } instance.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     */
+    constructor(qualifiers) {
+        this.qualifiers = qualifiers;
+    }
+    /**
+     * Parses a {@link QualifierDefaultValueToken | qualifier default value token} string and validates the parts
+     * against the qualifiers present in the {@link Qualifiers.QualifierDefaultValueTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseQualifierDefaultValueToken(token) {
+        return QualifierDefaultValueTokens.parseQualifierDefaultValueToken(token, this.qualifiers);
+    }
+    /**
+     * Parses a {@link QualifierDefaultValuesToken | qualifier default values token} string and validates the parts
+     * against the qualifiers present in the {@link Qualifiers.QualifierDefaultValueTokens.qualifiers | qualifier collector}.
+     * @param token - the token string to parse.
+     * @returns `Success` with the array of {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declarations}
+     * if successful, `Failure` with an error message if not.
+     */
+    parseQualifierDefaultValuesToken(token) {
+        return QualifierDefaultValueTokens.parseQualifierDefaultValuesToken(token, this.qualifiers);
+    }
+    /**
+     * Validates the {@link Helpers.IQualifierDefaultValueTokenParts | parts} of a {@link QualifierDefaultValueToken | qualifier default value token}.
+     * @param parts - the parts to validate
+     * @returns `Success` with the validated declaration if successful, `Failure` with an error message if not.
+     */
+    validateQualifierDefaultValueTokenParts(parts) {
+        return QualifierDefaultValueTokens.validateQualifierDefaultValueTokenParts(parts, this.qualifiers);
+    }
+    /**
+     * Converts a {@link QualifierDefaultValuesToken | qualifier default values token} to a validated qualifier default values declaration.
+     * @param token - the qualifier default values token to convert
+     * @returns `Success` with the validated qualifier default values declaration if successful, `Failure` with an error message if not.
+     */
+    qualifierDefaultValuesTokenToDecl(token) {
+        return QualifierDefaultValueTokens.qualifierDefaultValuesTokenToDecl(token, this.qualifiers);
+    }
+    /**
+     * Converts a validated qualifier default values declaration to a {@link QualifierDefaultValuesToken | qualifier default values token}.
+     * @param decl - the validated qualifier default values declaration to convert
+     * @returns `Success` with the qualifier default values token if successful, `Failure` with an error message if not.
+     */
+    declToQualifierDefaultValuesToken(decl) {
+        return QualifierDefaultValueTokens.declToQualifierDefaultValuesToken(decl);
+    }
+    /**
+     * Parses a {@link QualifierDefaultValueToken | qualifier default value token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with a {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static parseQualifierDefaultValueToken(token, qualifiers) {
+        return common_1.Helpers.parseQualifierDefaultValueTokenParts(token).onSuccess((parts) => {
+            return QualifierDefaultValueTokens.validateQualifierDefaultValueTokenParts(parts, qualifiers);
+        });
+    }
+    /**
+     * Parses a {@link QualifierDefaultValuesToken | qualifier default values token} and validates it against the qualifiers
+     * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param token - the token string to parse.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with an array of {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declarations}
+     * if successful, `Failure` with an error message if not
+     */
+    static parseQualifierDefaultValuesToken(token, qualifiers) {
+        return common_1.Helpers.parseQualifierDefaultValuesTokenParts(token).onSuccess((parts) => {
+            return (0, ts_utils_1.mapResults)(parts.map((part) => QualifierDefaultValueTokens.validateQualifierDefaultValueTokenParts(part, qualifiers)));
+        });
+    }
+    /**
+     * Validates the parts of a qualifier default value token against the qualifiers present in the supplied
+     * {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.
+     * @param parts - the {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts} to validate.
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to
+     * validate qualifier names and values.
+     * @returns `Success` with a {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration} if successful,
+     * `Failure` with an error message if not.
+     */
+    static validateQualifierDefaultValueTokenParts(parts, qualifiers) {
+        return qualifiers.getByNameOrToken(parts.qualifier).onSuccess((qualifier) => {
+            // Allow empty values to remove defaults
+            if (parts.value === '') {
+                return (0, ts_utils_1.succeed)({ qualifier, value: '' });
+            }
+            return qualifier.type
+                .validateContextValue(parts.value)
+                .onSuccess((value) => {
+                return (0, ts_utils_1.succeed)({ qualifier, value });
+            })
+                .withDetail('failure', 'success');
+        });
+    }
+    /**
+     * Converts a {@link QualifierDefaultValuesToken | qualifier default values token} to a validated qualifier default values declaration.
+     * @param token - the qualifier default values token to convert
+     * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use
+     * @returns `Success` with the validated qualifier default values declaration if successful, `Failure` with an error message if not.
+     */
+    static qualifierDefaultValuesTokenToDecl(token, qualifiers) {
+        return QualifierDefaultValueTokens.parseQualifierDefaultValuesToken(token, qualifiers).onSuccess((qualifierDefaultValues) => {
+            const defaultValues = {};
+            for (const { qualifier, value } of qualifierDefaultValues) {
+                const qualifierName = qualifier.name;
+                const contextValue = value;
+                // Check for duplicate qualifiers
+                if (qualifierName in defaultValues) {
+                    return (0, ts_utils_1.fail)(`${qualifier.name}: duplicate qualifier in default values token`);
+                }
+                // Only add non-empty values (empty values remove defaults)
+                if (contextValue !== '') {
+                    defaultValues[qualifierName] = contextValue;
+                }
+            }
+            return (0, ts_utils_1.succeed)(defaultValues);
+        });
+    }
+    /**
+     * Converts a validated qualifier default values declaration to a {@link QualifierDefaultValuesToken | qualifier default values token}.
+     * @param decl - the validated qualifier default values declaration to convert
+     * @returns `Success` with the qualifier default values token if successful, `Failure` with an error message if not.
+     */
+    static declToQualifierDefaultValuesToken(decl) {
+        const tokens = [];
+        for (const [qualifierName, contextValue] of Object.entries(decl)) {
+            // Build token as "qualifier=value"
+            tokens.push(`${qualifierName}=${contextValue}`);
+        }
+        if (tokens.length === 0) {
+            return (0, ts_utils_1.succeed)('');
+        }
+        const tokenString = tokens.join('|');
+        // Validate the generated token
+        return common_1.Helpers.buildQualifierDefaultValuesToken(tokens.map((token) => {
+            const [qualifier, value] = token.split('=');
+            return { qualifier, value };
+        })).onSuccess(() => (0, ts_utils_1.succeed)(tokenString));
+    }
+}
+exports.QualifierDefaultValueTokens = QualifierDefaultValueTokens;
+//# sourceMappingURL=qualifierDefaultValueToken.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualifierDefaultValueToken.js","sourceRoot":"","sources":["../../../src/packlets/qualifiers/qualifierDefaultValueToken.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 { mapResults, Result, fail, succeed } from '@fgv/ts-utils';\nimport { Helpers as CommonHelpers, QualifierName, QualifierContextValue } from '../common';\nimport {\n  IValidatedQualifierDefaultValueDecl,\n  IValidatedQualifierDefaultValuesDecl\n} from './qualifierDefaultValueDecls';\nimport { IReadOnlyQualifierCollector } from './qualifierCollector';\n\n/**\n * Helper class to parse and validate qualifier default value tokens.\n * @public\n */\nexport class QualifierDefaultValueTokens {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to validate\n   * qualifier names and values.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Constructs a new {@link Qualifiers.QualifierDefaultValueTokens | QualifierDefaultValueTokens } instance.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   */\n  public constructor(qualifiers: IReadOnlyQualifierCollector) {\n    this.qualifiers = qualifiers;\n  }\n\n  /**\n   * Parses a {@link QualifierDefaultValueToken | qualifier default value token} string and validates the parts\n   * against the qualifiers present in the {@link Qualifiers.QualifierDefaultValueTokens.qualifiers | qualifier collector}.\n   * @param token - the token string to parse.\n   * @returns `Success` with the {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration}\n   * if successful, `Failure` with an error message if not.\n   */\n  public parseQualifierDefaultValueToken(token: string): Result<IValidatedQualifierDefaultValueDecl> {\n    return QualifierDefaultValueTokens.parseQualifierDefaultValueToken(token, this.qualifiers);\n  }\n\n  /**\n   * Parses a {@link QualifierDefaultValuesToken | qualifier default values token} string and validates the parts\n   * against the qualifiers present in the {@link Qualifiers.QualifierDefaultValueTokens.qualifiers | qualifier collector}.\n   * @param token - the token string to parse.\n   * @returns `Success` with the array of {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declarations}\n   * if successful, `Failure` with an error message if not.\n   */\n  public parseQualifierDefaultValuesToken(token: string): Result<IValidatedQualifierDefaultValueDecl[]> {\n    return QualifierDefaultValueTokens.parseQualifierDefaultValuesToken(token, this.qualifiers);\n  }\n\n  /**\n   * Validates the {@link Helpers.IQualifierDefaultValueTokenParts | parts} of a {@link QualifierDefaultValueToken | qualifier default value token}.\n   * @param parts - the parts to validate\n   * @returns `Success` with the validated declaration if successful, `Failure` with an error message if not.\n   */\n  public validateQualifierDefaultValueTokenParts(\n    parts: CommonHelpers.IQualifierDefaultValueTokenParts\n  ): Result<IValidatedQualifierDefaultValueDecl> {\n    return QualifierDefaultValueTokens.validateQualifierDefaultValueTokenParts(parts, this.qualifiers);\n  }\n\n  /**\n   * Converts a {@link QualifierDefaultValuesToken | qualifier default values token} to a validated qualifier default values declaration.\n   * @param token - the qualifier default values token to convert\n   * @returns `Success` with the validated qualifier default values declaration if successful, `Failure` with an error message if not.\n   */\n  public qualifierDefaultValuesTokenToDecl(token: string): Result<IValidatedQualifierDefaultValuesDecl> {\n    return QualifierDefaultValueTokens.qualifierDefaultValuesTokenToDecl(token, this.qualifiers);\n  }\n\n  /**\n   * Converts a validated qualifier default values declaration to a {@link QualifierDefaultValuesToken | qualifier default values token}.\n   * @param decl - the validated qualifier default values declaration to convert\n   * @returns `Success` with the qualifier default values token if successful, `Failure` with an error message if not.\n   */\n  public declToQualifierDefaultValuesToken(decl: IValidatedQualifierDefaultValuesDecl): Result<string> {\n    return QualifierDefaultValueTokens.declToQualifierDefaultValuesToken(decl);\n  }\n\n  /**\n   * Parses a {@link QualifierDefaultValueToken | qualifier default value token} and validates it against the qualifiers\n   * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.\n   * @param token - the token string to parse.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   * @returns `Success` with a {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration} if successful,\n   * `Failure` with an error message if not.\n   */\n  public static parseQualifierDefaultValueToken(\n    token: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedQualifierDefaultValueDecl> {\n    return CommonHelpers.parseQualifierDefaultValueTokenParts(token).onSuccess((parts) => {\n      return QualifierDefaultValueTokens.validateQualifierDefaultValueTokenParts(parts, qualifiers);\n    });\n  }\n\n  /**\n   * Parses a {@link QualifierDefaultValuesToken | qualifier default values token} and validates it against the qualifiers\n   * present in the supplied {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.\n   * @param token - the token string to parse.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   * @returns `Success` with an array of {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declarations}\n   * if successful, `Failure` with an error message if not\n   */\n  public static parseQualifierDefaultValuesToken(\n    token: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedQualifierDefaultValueDecl[]> {\n    return CommonHelpers.parseQualifierDefaultValuesTokenParts(token).onSuccess((parts) => {\n      return mapResults(\n        parts.map((part) =>\n          QualifierDefaultValueTokens.validateQualifierDefaultValueTokenParts(part, qualifiers)\n        )\n      );\n    });\n  }\n\n  /**\n   * Validates the parts of a qualifier default value token against the qualifiers present in the supplied\n   * {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector}.\n   * @param parts - the {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts} to validate.\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} used to\n   * validate qualifier names and values.\n   * @returns `Success` with a {@link Qualifiers.IValidatedQualifierDefaultValueDecl | validated qualifier default value declaration} if successful,\n   * `Failure` with an error message if not.\n   */\n  public static validateQualifierDefaultValueTokenParts(\n    parts: CommonHelpers.IQualifierDefaultValueTokenParts,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedQualifierDefaultValueDecl> {\n    return qualifiers.getByNameOrToken(parts.qualifier).onSuccess((qualifier) => {\n      // Allow empty values to remove defaults\n      if (parts.value === '') {\n        return succeed({ qualifier, value: '' as QualifierContextValue });\n      }\n\n      return qualifier.type\n        .validateContextValue(parts.value)\n        .onSuccess((value) => {\n          return succeed({ qualifier, value });\n        })\n        .withDetail('failure', 'success');\n    });\n  }\n\n  /**\n   * Converts a {@link QualifierDefaultValuesToken | qualifier default values token} to a validated qualifier default values declaration.\n   * @param token - the qualifier default values token to convert\n   * @param qualifiers - the {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use\n   * @returns `Success` with the validated qualifier default values declaration if successful, `Failure` with an error message if not.\n   */\n  public static qualifierDefaultValuesTokenToDecl(\n    token: string,\n    qualifiers: IReadOnlyQualifierCollector\n  ): Result<IValidatedQualifierDefaultValuesDecl> {\n    return QualifierDefaultValueTokens.parseQualifierDefaultValuesToken(token, qualifiers).onSuccess(\n      (qualifierDefaultValues) => {\n        const defaultValues: IValidatedQualifierDefaultValuesDecl = {};\n\n        for (const { qualifier, value } of qualifierDefaultValues) {\n          const qualifierName = qualifier.name as QualifierName;\n          const contextValue = value as QualifierContextValue;\n\n          // Check for duplicate qualifiers\n          if (qualifierName in defaultValues) {\n            return fail(`${qualifier.name}: duplicate qualifier in default values token`);\n          }\n\n          // Only add non-empty values (empty values remove defaults)\n          if (contextValue !== '') {\n            defaultValues[qualifierName] = contextValue;\n          }\n        }\n\n        return succeed(defaultValues);\n      }\n    );\n  }\n\n  /**\n   * Converts a validated qualifier default values declaration to a {@link QualifierDefaultValuesToken | qualifier default values token}.\n   * @param decl - the validated qualifier default values declaration to convert\n   * @returns `Success` with the qualifier default values token if successful, `Failure` with an error message if not.\n   */\n  public static declToQualifierDefaultValuesToken(\n    decl: IValidatedQualifierDefaultValuesDecl\n  ): Result<string> {\n    const tokens: string[] = [];\n\n    for (const [qualifierName, contextValue] of Object.entries(decl)) {\n      // Build token as \"qualifier=value\"\n      tokens.push(`${qualifierName}=${contextValue}`);\n    }\n\n    if (tokens.length === 0) {\n      return succeed('');\n    }\n\n    const tokenString = tokens.join('|');\n\n    // Validate the generated token\n    return CommonHelpers.buildQualifierDefaultValuesToken(\n      tokens.map((token) => {\n        const [qualifier, value] = token.split('=');\n        return { qualifier, value };\n      })\n    ).onSuccess(() => succeed(tokenString));\n  }\n}\n"]}

package/lib/packlets/resource-json/compiled/common.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Options for controlling the compilation of resource objects.
+ * @public
+ */
+export interface ICompiledResourceOptions {
+    /**
+     * Whether to include metadata in the compiled objects.
+     * Metadata includes human-readable information like semantic keys
+     * that can be useful for debugging or tooling.
+     * @defaultValue false
+     */
+    includeMetadata?: boolean;
+}
+//# sourceMappingURL=common.d.ts.map

package/lib/packlets/resource-json/compiled/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/packlets/resource-json/compiled/common.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/lib/packlets/resource-json/compiled/common.js

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

package/lib/packlets/resource-json/compiled/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/packlets/resource-json/compiled/common.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Options for controlling the compilation of resource objects.\n * @public\n */\nexport interface ICompiledResourceOptions {\n  /**\n   * Whether to include metadata in the compiled objects.\n   * Metadata includes human-readable information like semantic keys\n   * that can be useful for debugging or tooling.\n   * @defaultValue false\n   */\n  includeMetadata?: boolean;\n}\n"]}

package/lib/packlets/resource-json/compiled/convert.d.ts

@@ -0,0 +1,63 @@
+import * as Model from './json';
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledConditionMetadata | compiled condition metadata}.
+ * @public
+ */
+export declare const compiledConditionMetadata: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledConditionMetadata, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledConditionSetMetadata | compiled condition set metadata}.
+ * @public
+ */
+export declare const compiledConditionSetMetadata: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledConditionSetMetadata, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledDecisionMetadata | compiled decision metadata}.
+ * @public
+ */
+export declare const compiledDecisionMetadata: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledDecisionMetadata, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledQualifierType | compiled qualifier type}.
+ * @public
+ */
+export declare const compiledQualifierType: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledQualifierType, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledQualifier | compiled qualifier}.
+ * @public
+ */
+export declare const compiledQualifier: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledQualifier, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledResourceType | compiled resource type}.
+ * @public
+ */
+export declare const compiledResourceType: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledResourceType, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledCondition | compiled condition}.
+ * @public
+ */
+export declare const compiledCondition: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledCondition, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledConditionSet | compiled condition set}.
+ * @public
+ */
+export declare const compiledConditionSet: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledConditionSet, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledAbstractDecision | compiled abstract decision}.
+ * @public
+ */
+export declare const compiledAbstractDecision: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledAbstractDecision, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledCandidate | compiled candidate}.
+ * @public
+ */
+export declare const compiledCandidate: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledCandidate, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledResource | compiled resource}.
+ * @public
+ */
+export declare const compiledResource: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledResource, unknown>;
+/**
+ * Converter for a {@link ResourceJson.Compiled.ICompiledResourceCollection | compiled resource collection}.
+ * This combines all the individual converters into a single converter for the entire resource collection.
+ * @public
+ */
+export declare const compiledResourceCollection: import("@fgv/ts-utils").ObjectConverter<Model.ICompiledResourceCollection, unknown>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/packlets/resource-json/compiled/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../../src/packlets/resource-json/compiled/convert.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,KAAK,MAAM,QAAQ,CAAC;AAIhC;;;GAGG;AACH,eAAO,MAAM,yBAAyB,oFAEpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,4BAA4B,uFAEvC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mFAEnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,gFAEhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4EAI5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+EAE/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4EAO5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+EAG/B,CAAC;AACH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mFAGnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4EAI5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,2EAK3B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,qFAQrC,CAAC"}