@fgv/ts-res 5.1.0-4 → 5.1.0-40

package/dist/ts-res.d.ts

@@ -799,7 +799,7 @@ declare const childResourceDecl: Converter<Normalized.IChildResourceDecl>;
  */
 declare class CollectionImporter implements IImporter {
     /**
-     * {@inheritdoc Import.Importers.IImporter.types}
+     * {@inheritDoc Import.Importers.IImporter.types}
      */
     readonly types: string[];
     /**
@@ -813,7 +813,7 @@ declare class CollectionImporter implements IImporter {
      */
     static create(): Result<CollectionImporter>;
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item: IImportable, manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     /**
@@ -1010,16 +1010,16 @@ declare class CompiledResourceCollection implements IResourceManager<IResource>
      */
     get candidateValues(): ReadonlyArray<JsonValue>;
     /**
-     * {@inheritdoc Runtime.IResourceManager.builtResources}
+     * {@inheritDoc Runtime.IResourceManager.builtResources}
      */
     get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, IResource>;
     /**
-     * {@inheritdoc Runtime.IResourceManager.numResources}
+     * {@inheritDoc Runtime.IResourceManager.numResources}
      */
     get numResources(): number;
     protected _numCandidates?: number;
     /**
-     * {@inheritdoc Runtime.IResourceManager.numCandidates}
+     * {@inheritDoc Runtime.IResourceManager.numCandidates}
      */
     get numCandidates(): number;
     /**
@@ -1037,11 +1037,11 @@ declare class CompiledResourceCollection implements IResourceManager<IResource>
      */
     static create(params: ICompiledResourceCollectionCreateParams): Result<CompiledResourceCollection>;
     /**
-     * {@inheritdoc Runtime.IResourceManager.getBuiltResource}
+     * {@inheritDoc Runtime.IResourceManager.getBuiltResource}
      */
     getBuiltResource(id: string): Result<IResource>;
     /**
-     * {@inheritdoc Runtime.IResourceManager.validateContext}
+     * {@inheritDoc Runtime.IResourceManager.validateContext}
      */
     validateContext(context: Context.IContextDecl): Result<Context.IValidatedContextDecl>;
     /**
@@ -1209,12 +1209,8 @@ export declare class Condition implements IValidatedConditionDecl {
     protected _collectible: Collections.Collectible<ConditionKey, ConditionIndex>;
     /**
      * Constructs a new {@link Conditions.Condition | Condition} object.
-     * @param qualifier - The {@link Qualifiers.Qualifier | qualifier} used in this condition.
-     * @param value - The value to be matched in this condition.
-     * @param operator - The {@link ConditionOperator | operator} used when matching context value to condition value.
-     * @param priority - The {@link ConditionPriority | relative priority} of this condition.
-     * @param scoreAsDefault - The {@link QualifierMatchScore | score} to be used when this condition is the default.
-     * @param index - The index of this condition.
+     * @param params - The {@link Conditions.IValidatedConditionDecl | validated condition declaration}
+     * used to construct this condition.
      * @public
      */
     protected constructor({ qualifier, value, operator, priority, scoreAsDefault, index }: IValidatedConditionDecl);
@@ -1238,7 +1234,7 @@ export declare class Condition implements IValidatedConditionDecl {
      * @returns A {@link QualifierMatchScore | match score} indicating match quality if the condition is present
      * in the context to be matched, `undefined` otherwise.
      * @remarks
-     * If {@link Context.IContextMatchOptions.partialContextMatch | `options.partialContextMatch``} is `true`, then
+     * If {@link Context.IContextMatchOptions.partialContextMatch | `options.partialContextMatch`} is `true`, then
      * the method will return `undefined` if the corresponding qualifier is not present in the context.
      */
     getContextMatch(context: Context.IValidatedContextDecl, options?: Context.IContextMatchOptions): QualifierMatchScore | undefined;
@@ -1361,9 +1357,14 @@ declare class ConditionCollector extends ValidatingCollector<Condition> {
 
 /**
  * Converter for a {@link Conditions.IConditionDecl | condition declaration}.
+ *
+ * @remarks
+ * Accepts any string as the `qualifierName`. Use `typedConditionDecl` to narrow the
+ * accepted set of qualifier names to a literal-string union.
+ *
  * @public
  */
-declare const conditionDecl: ObjectConverter<ILooseConditionDecl, unknown>;
+declare const conditionDecl: ObjectConverter<IConditionDecl, unknown>;
 
 /**
  * Branded number representing a validated condition index.
@@ -1394,8 +1395,8 @@ declare const conditionKey: Converter<ConditionKey, unknown>;
 
 /**
  * The format of a {@link ConditionKey | condition key} is:
- * <qualifierName>-[<value>][\@<priority>](<scoreAsDefault>) where operator is `matches`, or
- * <qualifierName>-<operator>-[<value>][\@<priority>](<scoreAsDefault>)
+ * \<qualifierName\>-\[<value>\]\[\@<priority>\]\(\<scoreAsDefault\>\) where operator is `matches`, or
+ * \<qualifierName\>-\<operator\>-\[<value>\]\[\@<priority>\]\(\<scoreAsDefault\>\)
  * @internal
  */
 declare const conditionKey_2: RegExp;
@@ -1622,10 +1623,18 @@ declare class ConditionSetCollector extends ValidatingCollector<ConditionSet> {
 }
 
 /**
- * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ * Non-validated declaration of a {@link Conditions.ConditionSet | condition set}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; defaults to `string`. Both the
+ * array form (`ConditionSetDeclAsArray`) and the record form
+ * (`ConditionSetDeclAsRecord`) inherit the parameter, so a
+ * consumer threading a narrow `TQualifierNames` gets compile-time
+ * rejection of typo'd axis names in either form.
+ *
  * @public
  */
-declare type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;
+declare type ConditionSetDecl<TQualifierNames extends string = string> = ConditionSetDeclAsArray<TQualifierNames> | ConditionSetDeclAsRecord<TQualifierNames>;
 
 /**
  * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.
@@ -1641,21 +1650,38 @@ declare type ConditionSetDecl_2 = ReadonlyArray<ILooseConditionDecl>;
 
 /**
  * Converter which converts to a {@link Conditions.IConditionSetDecl | condition set declaration}.
+ *
+ * @remarks
+ * Accepts any string as the qualifier name of each contained condition. Use
+ * `typedConditionSetDecl` to narrow the accepted set of qualifier names to a literal-string union.
+ *
  * @public
  */
-declare const conditionSetDecl_2: ObjectConverter<IConditionSetDecl, unknown>;
+declare const conditionSetDecl_2: ObjectConverter<IConditionSetDecl<string>, unknown>;
 
 /**
- * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ * Non-validated array-form declaration of a {@link Conditions.ConditionSet | condition set}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` via `ILooseConditionDecl`;
+ * defaults to `string` for back-compat with existing untyped callers.
+ *
  * @public
  */
-declare type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;
+declare type ConditionSetDeclAsArray<TQualifierNames extends string = string> = ReadonlyArray<ILooseConditionDecl<TQualifierNames>>;
 
 /**
- * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ * Non-validated record-form declaration of a {@link Conditions.ConditionSet | condition set}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; defaults to `string` for back-compat with
+ * existing untyped callers. Uses `Readonly<Partial<Record<...>>>` to align with
+ * runtime reality (missing keys produce `undefined`; the `Partial` makes TypeScript
+ * aware of this, which is a strict type-system tightening).
+ *
  * @public
  */
-declare type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;
+declare type ConditionSetDeclAsRecord<TQualifierNames extends string = string> = Readonly<Partial<Record<TQualifierNames, string | IChildConditionDecl>>>;
 
 /**
  * Branded string representing a hash value for a condition set. The hash value
@@ -2214,9 +2240,13 @@ declare namespace Convert_10 {
 
 declare namespace Convert_11 {
     export {
+        typedConditionDecl,
+        typedValidatedConditionDecl,
         conditionDecl,
         IConditionDeclConvertContext,
         validatedConditionDecl,
+        typedConditionSetDecl_2 as typedConditionSetDecl,
+        typedValidatedConditionSetDecl,
         conditionSetDecl_2 as conditionSetDecl,
         IConditionSetDeclConvertContext,
         validatedConditionSetDecl
@@ -2295,6 +2325,18 @@ declare namespace Convert_6 {
 
 declare namespace Convert_7 {
     export {
+        typedLooseConditionDecl,
+        typedConditionSetDecl,
+        typedLooseResourceCandidateDecl,
+        typedImporterResourceCandidateDecl,
+        typedChildResourceCandidateDecl,
+        typedLooseResourceDecl,
+        typedChildResourceDecl,
+        typedContainerContextDecl,
+        typedResourceTreeChildNodeDecl,
+        typedResourceTreeRootDecl,
+        typedResourceCollectionDecl,
+        typedImporterResourceCollectionDecl,
         looseConditionDecl,
         childConditionDecl,
         conditionSetDecl,
@@ -2450,7 +2492,7 @@ export declare class Decision<TVALUE extends JsonValue = JsonValue> implements I
     static getAbstractKey(conditionSets: ReadonlyArray<ConditionSet>): DecisionKey;
     /**
      * Helper function to return a stable key for a set of condition sets.
-     * @param conditionSets - The condition sets to use to create the key.
+     * @param candidates - The candidates whose condition sets are used to create the key.
      * @returns A key derived from the condition set hashes.
      * @public
      */
@@ -2771,9 +2813,6 @@ declare class FsItem implements IFsItemProps {
      * @param props - The {@link Import.IFsItemProps | file system item properties} to use for this item.
      * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
      * embedded condition set tokens.
-     * @param tree - file tree implementation to use for this item.
-     * @returns `Success` containing the new {@link Import.FsItem | FsItem} if successful, or a `Failure`
-     * containing an error message if not.
      */
     protected constructor(props: IFsItemProps, qualifiers: IReadOnlyQualifierCollector);
     /**
@@ -2791,7 +2830,7 @@ declare class FsItem implements IFsItemProps {
      * @param importPath - The path to the file system item to import.
      * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} used to parse
      * embedded condition set tokens.
-     * @param fs - An optional {@link Import.IImporterFilesystem | file system implementation} to use for this item.
+     * @param tree - An optional {@link FileTree.FileTree | file tree} to use for this item.
      * @returns `Success` containing the new {@link Import.FsItem | FsItem} if an item is created
      * successfully, or a `Failure` containing an error message if it is not.  Note that the result detail
      * `skipped` indicates that the item was not created because it is not relevant - this is a soft error
@@ -2824,6 +2863,14 @@ declare class FsItemImporter implements IImporter {
      * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.
      */
     readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Optional converter used to parse raw file contents before they are exposed as JSON importables.
+     */
+    readonly fileContentConverter?: Converter<JsonValue>;
+    /**
+     * Optional list of file extensions which should be parsed using the file content converter.
+     */
+    readonly fileContentExtensions?: ReadonlyArray<string>;
     /**
      * The types of {@link Import.IImportable | importables} that this importer can handle.
      */
@@ -2840,9 +2887,12 @@ declare class FsItemImporter implements IImporter {
      */
     static create(params: IFsItemImporterCreateParams): Result<FsItemImporter>;
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item: IImportable, __manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
+    private _isSupportedFileExtension;
+    private _getJsonContents;
+    private _canConvertFileExtension;
     /**
      * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.
      * @param item - The importable to convert.
@@ -3255,9 +3305,15 @@ declare interface IChildConditionDecl {
 
 /**
  * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `conditions` field can carry a
+ * narrowed axis-name set. Defaults to `string` so existing untyped callers
+ * compile unchanged.
+ *
  * @public
  */
-declare interface IChildResourceCandidateDecl {
+declare interface IChildResourceCandidateDecl<TQualifierNames extends string = string> {
     /**
      * The JSON value of the resource.
      */
@@ -3265,7 +3321,7 @@ declare interface IChildResourceCandidateDecl {
     /**
      * The conditions that must be met for the resource to be selected.
      */
-    readonly conditions?: ConditionSetDecl;
+    readonly conditions?: ConditionSetDecl<TQualifierNames>;
     /**
      * If true, the resource is only a partial representation of the full resource.
      */
@@ -3303,9 +3359,15 @@ declare interface IChildResourceCandidateDecl_2 {
 
 /**
  * Non-validated child declaration of a {@link Resources.Resource | resource}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `candidates` field threads the
+ * narrowed axis-name set down to each candidate. Defaults to `string` for
+ * back-compat.
+ *
  * @public
  */
-declare interface IChildResourceDecl {
+declare interface IChildResourceDecl<TQualifierNames extends string = string> {
     /**
      * The name of the type of this resource.
      */
@@ -3313,7 +3375,7 @@ declare interface IChildResourceDecl {
     /**
      * Possible candidates for this value.
      */
-    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl<TQualifierNames>>;
 }
 
 /**
@@ -3639,9 +3701,14 @@ declare interface IConditionCollectorCreateParams {
 
 /**
  * Non-validated declaration of a {@link Conditions.Condition | condition}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` (defaulting to `string`) so consumers
+ * authoring conditions in code can opt into compile-time axis-name discipline.
+ *
  * @public
  */
-declare type IConditionDecl = ResourceJson.Json.ILooseConditionDecl;
+declare type IConditionDecl<TQualifierNames extends string = string> = ResourceJson.Json.ILooseConditionDecl<TQualifierNames>;
 
 /**
  * Conversion context to uses when converting
@@ -3682,10 +3749,15 @@ declare interface IConditionSetCollectorCreateParams {
 
 /**
  * Non-validated declaration of a {@link Conditions.ConditionSet | set of conditions}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` (defaulting to `string`) so consumers can
+ * opt into compile-time axis-name discipline by supplying a literal-string union.
+ *
  * @public
  */
-declare interface IConditionSetDecl {
-    conditions: IConditionDecl[];
+declare interface IConditionSetDecl<TQualifierNames extends string = string> {
+    conditions: IConditionDecl<TQualifierNames>[];
 }
 
 /**
@@ -3737,11 +3809,17 @@ declare interface IConfigInitFactory<TConfig, T> {
 
 /**
  * Declared context for a resource container.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `conditions` field threads the
+ * narrowed axis-name set to the container context. Defaults to `string` for
+ * back-compat.
+ *
  * @public
  */
-declare interface IContainerContextDecl {
+declare interface IContainerContextDecl<TQualifierNames extends string = string> {
     readonly baseId?: string;
-    readonly conditions?: ConditionSetDecl;
+    readonly conditions?: ConditionSetDecl<TQualifierNames>;
     readonly mergeMethod?: ResourceValueMergeMethod;
 }
 
@@ -4021,6 +4099,8 @@ declare const identifierList: RegExp;
  */
 declare interface IFsItemImporterCreateParams {
     qualifiers: IReadOnlyQualifierCollector;
+    fileContentConverter?: Converter<JsonValue>;
+    fileContentExtensions?: ReadonlyArray<string>;
 }
 
 /**
@@ -4204,14 +4284,27 @@ declare interface IImporterCreateParams {
      * An optional list of {@link Import.Importers.IImporter | importers} to use for the import.
      */
     importers?: IImporter[];
+    /**
+     * An optional converter used to pre-process file contents before JSON import validation.
+     */
+    fileContentConverter?: Converter<JsonValue>;
+    /**
+     * Optional file extensions which should be parsed using the supplied file content converter.
+     */
+    fileContentExtensions?: ReadonlyArray<string>;
 }
 
 /**
  * Non-validated declaration of a resource candidate for import,
  * which can be either a loose or child resource candidate.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; inherits via `IChildResourceCandidateDecl`.
+ * Defaults to `string` for back-compat.
+ *
  * @public
  */
-declare interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {
+declare interface IImporterResourceCandidateDecl<TQualifierNames extends string = string> extends IChildResourceCandidateDecl<TQualifierNames> {
     /**
      * The {@link ResourceId | id} of the resource.
      */
@@ -4240,13 +4333,19 @@ declare interface IImporterResourceCandidateDecl_2 extends IChildResourceCandida
 
 /**
  * Non-validated declaration of a collection of resources for an importer.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `context`, `candidates`, and
+ * `resources` fields thread the narrowed axis-name set throughout the
+ * importer collection. Defaults to `string` for back-compat.
+ *
  * @public
  */
-declare interface IImporterResourceCollectionDecl {
-    readonly context?: IContainerContextDecl;
-    readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;
-    readonly resources?: ReadonlyArray<IImporterResourceDecl>;
-    readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;
+declare interface IImporterResourceCollectionDecl<TQualifierNames extends string = string> {
+    readonly context?: IContainerContextDecl<TQualifierNames>;
+    readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl<TQualifierNames>>;
+    readonly resources?: ReadonlyArray<IImporterResourceDecl<TQualifierNames>>;
+    readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl<TQualifierNames>>;
     readonly metadata?: JsonObject;
 }
 
@@ -4266,9 +4365,13 @@ declare interface IImporterResourceCollectionDecl_2 {
 /**
  * Non-validated declaration of a resource for import,
  * which can be either a loose or child resource.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; defaults to `string` for back-compat.
+ *
  * @public
  */
-declare type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;
+declare type IImporterResourceDecl<TQualifierNames extends string = string> = ILooseResourceDecl<TQualifierNames> | IChildResourceDecl<TQualifierNames>;
 
 /**
  * Normalized non-validated declaration of a resource for import,
@@ -4393,13 +4496,21 @@ declare interface ILiteralValueHierarchyCreateParams<T extends string = string>
 
 /**
  * Non-validated loose declaration of a {@link Conditions.Condition | condition}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so consumers authoring conditions
+ * in code can opt into compile-time axis-name discipline (e.g. via a
+ * literal-string union derived from a `qualifiers: ['tone'] as const`
+ * decl-array). Defaults to `string`, so existing untyped callers
+ * compile unchanged.
+ *
  * @public
  */
-declare interface ILooseConditionDecl {
+declare interface ILooseConditionDecl<TQualifierNames extends string = string> {
     /**
      * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.
      */
-    qualifierName: string;
+    qualifierName: TQualifierNames;
     /**
      * The value to be compared.
      */
@@ -4421,9 +4532,14 @@ declare interface ILooseConditionDecl {
 
 /**
  * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; inherits via `IChildResourceCandidateDecl`.
+ * Defaults to `string` for back-compat.
+ *
  * @public
  */
-declare interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {
+declare interface ILooseResourceCandidateDecl<TQualifierNames extends string = string> extends IChildResourceCandidateDecl<TQualifierNames> {
     /**
      * The {@link ResourceId | id} of the resource.
      */
@@ -4435,7 +4551,7 @@ declare interface ILooseResourceCandidateDecl extends IChildResourceCandidateDec
     /**
      * The conditions that must be met for the resource to be selected.
      */
-    readonly conditions?: ConditionSetDecl;
+    readonly conditions?: ConditionSetDecl<TQualifierNames>;
     /**
      * If true, the resource is only a partial representation of the full resource.
      */
@@ -4485,9 +4601,14 @@ declare interface ILooseResourceCandidateDecl_2 extends IChildResourceCandidateD
 
 /**
  * Non-validated loose declaration of a {@link Resources.Resource | resource}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; inherits via `IChildResourceDecl`.
+ * Defaults to `string` for back-compat.
+ *
  * @public
  */
-declare interface ILooseResourceDecl extends IChildResourceDecl {
+declare interface ILooseResourceDecl<TQualifierNames extends string = string> extends IChildResourceDecl<TQualifierNames> {
     /**
      * The id of the resource.
      */
@@ -4499,7 +4620,7 @@ declare interface ILooseResourceDecl extends IChildResourceDecl {
     /**
      * Possible candidates for this value.
      */
-    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl<TQualifierNames>>;
 }
 
 /**
@@ -4556,18 +4677,18 @@ declare type Importable = IImportablePath | IImportableFsItem | IImportableJson
  */
 declare class ImportContext implements IValidatedImportContext {
     /**
-     * {@inheritdoc Import.IImportContext.baseId}
+     * {@inheritDoc Import.IImportContext.baseId}
      */
     readonly baseId: ResourceId | undefined;
     /**
-     * {@inheritdoc Import.IImportContext.conditions}
+     * {@inheritDoc Import.IImportContext.conditions}
      */
     readonly conditions: ReadonlyArray<IConditionDecl>;
     /**
      * Protected {@link Import.ImportContext | import context} for derived classes.
      * Public consumers use {@link Import.ImportContext.create | create} to create new instances.
-     * @param baseId - The base ID for the import context.
-     * @param conditions - Conditions to be applied to resources imported in this context.
+     * @param params - The {@link Import.IImportContext | import context} parameters including
+     * the base ID and conditions to be applied to resources imported in this context.
      */
     protected constructor({ baseId, conditions }: IImportContext);
     /**
@@ -4587,7 +4708,7 @@ declare class ImportContext implements IValidatedImportContext {
     withConditions(conditions: IConditionDecl[]): Result<ImportContext>;
     /**
      * Appends names to the base ID of the import context.
-     * @param name - The base name to set.
+     * @param names - The name segments to append to the base ID.
      * @returns `Success` with a new {@link Import.ImportContext | import context} containing the new base ID
      * if successful, or `Failure` with an error message if the operation fails.
      */
@@ -4717,9 +4838,13 @@ declare class ImportManager {
      * and optional `FileTree`.
      * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for the import.
      * @param tree - An optional `FileTree` for importing path items.
+     * @param fileContentConverter - An optional converter used to pre-process raw file contents before JSON import
+     * validation.
+     * @param fileContentExtensions - Optional file extensions which should be parsed using the supplied file
+     * content converter.
      * @returns A read-only array of {@link Import.Importers.IImporter | importers}.
      */
-    static getDefaultImporters(qualifiers: IReadOnlyQualifierCollector, tree?: FileTree.FileTree): ReadonlyArray<IImporter>;
+    static getDefaultImporters(qualifiers: IReadOnlyQualifierCollector, tree?: FileTree.FileTree, fileContentConverter?: Converter<JsonValue>, fileContentExtensions?: ReadonlyArray<string>): ReadonlyArray<IImporter>;
     /**
      * Imports any items on the import stack.
      * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,
@@ -4809,18 +4934,49 @@ declare interface IPathImporterCreateParams {
 /**
  * Parameters for creating a new {@link Qualifiers.QualifierCollector}.
  * @public
+ *
+ * @remarks
+ * `qualifiers` accepts a mixed array of bare axis-name strings and full
+ * {@link Qualifiers.IQualifierDecl | declarations}. A string element is
+ * sugar for "literal qualifier with this name"; the library synthesizes a
+ * {@link QualifierTypes.LiteralQualifierType | LiteralQualifierType} and a
+ * declaration `{ name, typeName: name, defaultPriority: <descending> }`.
+ *
+ * Synthesized priorities are distributed across the
+ * `[MinConditionPriority..MaxConditionPriority]` range adaptively to the
+ * array length: `step = max(1, floor((Max - Min) / length))`,
+ * `priority = max(Min, Max - index * step)`. Earlier elements get higher
+ * priority. The formula never overflows the `ConditionPriority` range
+ * regardless of input length; for inputs whose length exceeds the range
+ * cardinality (\>1000 axes), trailing priorities collapse at
+ * `MinConditionPriority` — supply explicit priorities in that regime
+ * if uniqueness matters.
+ *
+ * `qualifierTypes` may be omitted only when every element of `qualifiers`
+ * is a string. If any element is an {@link Qualifiers.IQualifierDecl},
+ * `qualifierTypes` must be supplied and must contain the referenced
+ * {@link Qualifiers.IQualifierDecl.typeName | typeNames}.
  */
 declare interface IQualifierCollectorCreateParams {
     /**
      * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} used to
      * create {@link Qualifiers.Qualifier | qualifiers} from {@link Qualifiers.IQualifierDecl | declarations}.
+     *
+     * Optional only when every entry in `qualifiers` is a bare axis-name string
+     * (in which case the library synthesizes a literal qualifier type per name).
      */
-    qualifierTypes: ReadOnlyQualifierTypeCollector;
+    qualifierTypes?: ReadOnlyQualifierTypeCollector;
     /**
-     * Optional list of {@link Qualifiers.IQualifierDecl | declarations} for the qualifiers to add to the collection
-     * upon creation.
+     * Optional list of {@link Qualifiers.IQualifierDecl | declarations} or bare
+     * axis-name strings for the qualifiers to add to the collection on creation.
+     *
+     * @remarks
+     * A string element `'foo'` is sugar for a literal qualifier:
+     * `{ name: 'foo', typeName: 'foo', defaultPriority: <descending> }` backed by
+     * a synthesized {@link QualifierTypes.LiteralQualifierType | LiteralQualifierType}
+     * named `'foo'`.
      */
-    qualifiers?: IQualifierDecl[];
+    qualifiers?: ReadonlyArray<string | IQualifierDecl>;
 }
 
 /**
@@ -5059,7 +5215,7 @@ declare interface IReadOnlyContextQualifierProviderValidatorCreateParams<T exten
  */
 declare interface IReadOnlyQualifierCollector extends Collections.IReadOnlyValidatingCollector<Qualifier> {
     /**
-     * {@inheritdoc Qualifiers.QualifierCollector.qualifierTypes}
+     * {@inheritDoc Qualifiers.QualifierCollector.qualifierTypes}
      */
     readonly qualifierTypes: ReadOnlyQualifierTypeCollector;
     /**
@@ -5273,7 +5429,7 @@ declare interface IResourceCandidateCreateParams {
  */
 declare interface IResourceCandidateValidationProperties {
     /**
-     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.id}
+     * {@inheritDoc ResourceJson.Json.ILooseResourceCandidateDecl.id}
      * @public
      */
     id: ResourceId;
@@ -5283,12 +5439,12 @@ declare interface IResourceCandidateValidationProperties {
      */
     completeness: CandidateCompleteness;
     /**
-     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.json}
+     * {@inheritDoc ResourceJson.Json.ILooseResourceCandidateDecl.json}
      * @public
      */
     json: JsonValue;
     /**
-     * {@inheritdoc ResourceJson.Json.ILooseResourceCandidateDecl.mergeMethod}
+     * {@inheritDoc ResourceJson.Json.ILooseResourceCandidateDecl.mergeMethod}
      * @public
      */
     mergeMethod: ResourceValueMergeMethod;
@@ -5296,13 +5452,19 @@ declare interface IResourceCandidateValidationProperties {
 
 /**
  * Non-validated declaration of a collection of resources.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `context`, `candidates`, and
+ * `resources` fields thread the narrowed axis-name set throughout the
+ * collection. Defaults to `string` for back-compat.
+ *
  * @public
  */
-declare interface IResourceCollectionDecl {
-    readonly context?: IContainerContextDecl;
-    readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
-    readonly resources?: ReadonlyArray<ILooseResourceDecl>;
-    readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+declare interface IResourceCollectionDecl<TQualifierNames extends string = string> {
+    readonly context?: IContainerContextDecl<TQualifierNames>;
+    readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl<TQualifierNames>>;
+    readonly resources?: ReadonlyArray<ILooseResourceDecl<TQualifierNames>>;
+    readonly collections?: ReadonlyArray<IResourceCollectionDecl<TQualifierNames>>;
     readonly metadata?: JsonObject;
 }
 
@@ -5626,11 +5788,17 @@ declare interface IResourceTreeBranchInit<T> {
 
 /**
  * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `resources` and `children` fields
+ * thread the narrowed axis-name set throughout the tree. Defaults to `string` for
+ * back-compat.
+ *
  * @public
  */
-declare interface IResourceTreeChildNodeDecl {
-    readonly resources?: Record<string, IChildResourceDecl>;
-    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+declare interface IResourceTreeChildNodeDecl<TQualifierNames extends string = string> {
+    readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;
 }
 
 /**
@@ -5652,12 +5820,18 @@ declare interface IResourceTreeLeafInit<T> {
 
 /**
  * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames` so the `context` field threads the
+ * narrowed axis-name set to the tree root context. Defaults to `string` for
+ * back-compat.
+ *
  * @public
  */
-declare interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
-    readonly context?: IContainerContextDecl;
-    readonly resources?: Record<string, IChildResourceDecl>;
-    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+declare interface IResourceTreeRootDecl<TQualifierNames extends string = string> extends IResourceTreeChildNodeDecl<TQualifierNames> {
+    readonly context?: IContainerContextDecl<TQualifierNames>;
+    readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;
     readonly metadata?: JsonObject;
 }
 
@@ -5769,8 +5943,15 @@ declare interface ISimpleContextQualifierProviderCreateParams {
     qualifiers: IReadOnlyQualifierCollector;
     /**
      * Optional record of initial qualifier name-value pairs to populate the provider.
+     *
+     * @remarks
+     * Typed as `Readonly<Partial<Record<string, QualifierContextValue>>>` so a
+     * caller can naturally express conditional context construction, e.g.
+     * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is
+     * `undefined` are skipped on load - semantically equivalent to omitting
+     * the key, which is how the candidate selector treats a missing key.
      */
-    qualifierValues?: Record<string, QualifierContextValue>;
+    qualifierValues?: Readonly<Partial<Record<string, QualifierContextValue>>>;
 }
 
 /**
@@ -5786,13 +5967,13 @@ declare function isImportable(i: IImportable): i is Importable;
  * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.
  * @public
  */
-declare function isLooseResourceCandidateDecl(decl: IImporterResourceCandidateDecl): decl is ILooseResourceCandidateDecl;
+declare function isLooseResourceCandidateDecl<TQualifierNames extends string = string>(decl: IImporterResourceCandidateDecl<TQualifierNames>): decl is ILooseResourceCandidateDecl<TQualifierNames>;
 
 /**
  * Type guard function to check if a resource declaration is a loose resource declaration.
  * @public
  */
-declare function isLooseResourceDecl(decl: IImporterResourceDecl): decl is ILooseResourceDecl;
+declare function isLooseResourceDecl<TQualifierNames extends string = string>(decl: IImporterResourceDecl<TQualifierNames>): decl is ILooseResourceDecl<TQualifierNames>;
 
 /**
  * Type guard to determine if an init object represents a leaf node with a resource.
@@ -6155,15 +6336,15 @@ declare interface ITerritoryQualifierTypeConfig {
  */
 declare interface ITerritoryQualifierTypeCreateParams {
     /**
-     * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.name}
+     * {@inheritDoc QualifierTypes.IQualifierTypeCreateParams.name}
      */
     name?: string;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.allowContextList}
+     * {@inheritDoc QualifierTypes.IQualifierTypeCreateParams.allowContextList}
      */
     allowContextList?: boolean;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierTypeCreateParams.index}
+     * {@inheritDoc QualifierTypes.IQualifierTypeCreateParams.index}
      */
     index?: number;
     /**
@@ -6303,8 +6484,15 @@ declare interface IValidatingSimpleContextQualifierProviderCreateParams {
     /**
      * Optional record of initial qualifier name-value pairs to populate the provider.
      * Accepts string keys and values which will be converted to strongly-typed values.
+     *
+     * @remarks
+     * Typed as `Readonly<Partial<Record<string, string>>>` so callers can
+     * naturally express conditional context construction, e.g.
+     * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is
+     * `undefined` are skipped on load - semantically equivalent to omitting
+     * the key.
      */
-    qualifierValues?: Record<string, string>;
+    qualifierValues?: Readonly<Partial<Record<string, string>>>;
 }
 
 /**
@@ -6416,8 +6604,7 @@ declare interface IZipArchiveResult {
  * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
  * to create a new {@link ResourceId | resource ID}. Returns `undefined` if no names are defined.
  *
- * @param base - The base name or ID to join.
- * @param names - Additional names to join.
+ * @param ids - The names or IDs to join.
  * @returns `Success` with the new ID if the base and names are valid, `Success` with `undefined`
  * if names were present, or `Failure` with an error message if the resulting id is invalid.
  * @public
@@ -6428,8 +6615,7 @@ declare function joinOptionalResourceIds(...ids: (string | undefined)[]): Result
  * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
  * to create a new {@link ResourceId | resource ID}. Fails if resulting ID is invalid or empty.
  *
- * @param base - The base name or ID to join.
- * @param names - Additional names to join.
+ * @param ids - The names or IDs to join.
  * @returns `Success` with the new ID if the base and names are valid, or `Failure` with an error message
  * if not.
  * @public
@@ -6475,7 +6661,7 @@ declare namespace Json_2 {
  */
 declare class JsonImporter implements IImporter {
     /**
-     * {@inheritdoc Import.Importers.IImporter.types}
+     * {@inheritDoc Import.Importers.IImporter.types}
      */
     readonly types: ReadonlyArray<string>;
     /**
@@ -6489,7 +6675,7 @@ declare class JsonImporter implements IImporter {
      */
     static create(): Result<JsonImporter>;
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item: IImportable, manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     private _tryImportResourceCollection;
@@ -6509,7 +6695,7 @@ declare const jsonQualifierTypeConfig: Converter<Model_2.IQualifierTypeConfig<Js
  */
 declare class JsonResourceType extends ResourceType<JsonObject> {
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.systemTypeName}
+     * {@inheritDoc ResourceTypes.ResourceType.systemTypeName}
      */
     readonly systemTypeName: ResourceTypeName;
     /**
@@ -6527,19 +6713,31 @@ declare class JsonResourceType extends ResourceType<JsonObject> {
      */
     static create(params?: IJsonResourceTypeCreateParams): Result<JsonResourceType>;
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.validateDeclaration}
+     * {@inheritDoc ResourceTypes.ResourceType.validateDeclaration}
      */
     validateDeclaration(props: IResourceCandidateValidationProperties): Result<JsonObject>;
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.(validate:1)}
+     * Validates a JSON value for use as a resource instance value.
+     * @param json - The JSON value to validate.
+     * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.
+     * @returns `Success` with the strongly-typed resource value if the JSON is valid,
+     * `Failure` with an error message otherwise.
      */
     validate(json: JsonObject, completeness: CandidateCompleteness): Result<JsonObject>;
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.(validate:2)}
+     * Validates a JSON value for use as a complete resource instance value.
+     * @param json - The JSON value to validate.
+     * @param completeness - Must be `'full'` to indicate a complete value.
+     * @returns `Success` with the strongly-typed resource value if the JSON is valid,
+     * `Failure` with an error message otherwise.
      */
     validate(json: JsonObject, completeness: 'full'): Result<JsonObject>;
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.(validate:3)}
+     * Validates a JSON value for use as a partial resource instance value.
+     * @param json - The JSON value to validate.
+     * @param completeness - Must be `'partial'` to indicate a partial value.
+     * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,
+     * `Failure` with an error message otherwise.
      */
     validate(json: JsonObject, completeness: 'partial'): Result<JsonObject>;
 }
@@ -6570,14 +6768,13 @@ declare const LanguagePrioritySystemConfiguration: ISystemConfiguration;
  */
 declare class LanguageQualifierType extends QualifierType<JsonCompatibleType<Config_2.ILanguageQualifierTypeConfig>> {
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
+     * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}
      */
     readonly systemTypeName: QualifierTypeName;
     /**
      * Creates a new instance of a {@link QualifierTypes.LanguageQualifierType | language qualifier type}.
-     * @param name - Optional name for the qualifier type. Defaults to 'language'.
-     * @param allowContextList - Optional flag indicating whether the context can be a
-     * list of values. Defaults to `true`.
+     * @param params - The {@link QualifierTypes.ILanguageQualifierTypeCreateParams | create parameters}
+     * for this qualifier type.
      * @public
      */
     protected constructor({ name, allowContextList, index }: ILanguageQualifierTypeCreateParams);
@@ -6599,7 +6796,7 @@ declare class LanguageQualifierType extends QualifierType<JsonCompatibleType<Con
      */
     static createFromConfig(config: Config_2.IQualifierTypeConfig<Config_2.ILanguageQualifierTypeConfig>): Result<LanguageQualifierType>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isValidConditionValue}
+     * {@inheritDoc QualifierTypes.IQualifierType.isValidConditionValue}
      */
     isValidConditionValue(value: string): value is QualifierConditionValue;
     /**
@@ -6609,11 +6806,11 @@ declare class LanguageQualifierType extends QualifierType<JsonCompatibleType<Con
      */
     getConfiguration(): Result<Config_2.ISystemLanguageQualifierTypeConfig>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
     getConfigurationJson(): Result<JsonCompatibleType<Config_2.ISystemLanguageQualifierTypeConfig>>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
     validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.ISystemLanguageQualifierTypeConfig>>;
     /**
@@ -6648,7 +6845,7 @@ declare const languageQualifierTypeConfig: ObjectConverter<Model_2.ILanguageQual
  */
 declare class LiteralQualifierType extends QualifierType<JsonCompatibleType<Config_2.ILiteralQualifierTypeConfig>> {
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
+     * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}
      */
     readonly systemTypeName: QualifierTypeName;
     /**
@@ -6666,11 +6863,8 @@ declare class LiteralQualifierType extends QualifierType<JsonCompatibleType<Conf
     readonly hierarchy?: LiteralValueHierarchy<string>;
     /**
      * Constructs a new {@link QualifierTypes.LiteralQualifierType | LiteralQualifierType}.
-     * @param name - Optional name for the qualifier type. Defaults to 'literal'.
-     * @param caseSensitive - Optional flag indicating whether the match should be
-     * case-sensitive. Defaults to `false`.
-     * @param allowContextList - Optional flag indicating whether the context can be a
-     * list of values. Defaults to `false`.
+     * @param params - The {@link QualifierTypes.ILiteralQualifierTypeCreateParams | create parameters}
+     * for this qualifier type.
      * @public
      */
     protected constructor({ name, caseSensitive, allowContextList, enumeratedValues, hierarchy, index }: ILiteralQualifierTypeCreateParams);
@@ -6683,7 +6877,7 @@ declare class LiteralQualifierType extends QualifierType<JsonCompatibleType<Conf
      */
     isValidConditionValue(value: string): value is QualifierConditionValue;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isPotentialMatch}
+     * {@inheritDoc QualifierTypes.IQualifierType.isPotentialMatch}
      */
     isPotentialMatch(conditionValue: string, contextValue: string): boolean;
     /**
@@ -6693,11 +6887,11 @@ declare class LiteralQualifierType extends QualifierType<JsonCompatibleType<Conf
      */
     getConfiguration(): Result<Config_2.ISystemLiteralQualifierTypeConfig>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
     getConfigurationJson(): Result<JsonCompatibleType<Config_2.ISystemLiteralQualifierTypeConfig>>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
     validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.ISystemLiteralQualifierTypeConfig>>;
     /**
@@ -6708,7 +6902,7 @@ declare class LiteralQualifierType extends QualifierType<JsonCompatibleType<Conf
      */
     validateConfiguration(from: unknown): Result<Config_2.ISystemLiteralQualifierTypeConfig>;
     /**
-     * {@inheritdoc QualifierTypes.QualifierType._matchOne}
+     * {@inheritDoc QualifierTypes.QualifierType._matchOne}
      */
     protected _matchOne(condition: QualifierConditionValue, context: QualifierContextValue, __operator: ConditionOperator): QualifierMatchScore;
     /**
@@ -7259,7 +7453,7 @@ declare class PathImporter implements IImporter {
      */
     static create(params: IPathImporterCreateParams): Result<PathImporter>;
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item: IImportable, __manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
     /**
@@ -7333,9 +7527,8 @@ export declare class Qualifier implements IValidatedQualifierDecl, ICollectible<
     /**
      * 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
+     * @param decl - The {@link Qualifiers.IValidatedQualifierDecl | validated declaration}
+     * describing the qualifier to construct.
      * @public
      */
     protected constructor({ name, token, type, defaultPriority, tokenIsOptional, defaultValue, index }: IValidatedQualifierDecl);
@@ -7356,19 +7549,19 @@ export declare class Qualifier implements IValidatedQualifierDecl, ICollectible<
      */
     setIndex(index: QualifierIndex): Result<QualifierIndex>;
     /**
-     * {@inheritdoc QualifierTypes.QualifierType.isValidContextValue}
+     * {@inheritDoc QualifierTypes.QualifierType.isValidContextValue}
      */
     isValidContextValue(value: string): value is QualifierContextValue;
     /**
-     * {@inheritdoc QualifierTypes.QualifierType.isValidConditionValue}
+     * {@inheritDoc QualifierTypes.QualifierType.isValidConditionValue}
      */
     isValidConditionValue(value: string): value is QualifierConditionValue;
     /**
-     * {@inheritdoc QualifierTypes.QualifierType.validateCondition}
+     * {@inheritDoc QualifierTypes.QualifierType.validateCondition}
      */
     validateCondition(value: string, operator?: ConditionOperator): Result<QualifierConditionValue>;
     /**
-     * {@inheritdoc QualifierTypes.QualifierType.validateContextValue}
+     * {@inheritDoc QualifierTypes.QualifierType.validateContextValue}
      */
     validateContextValue(value: string): Result<QualifierContextValue>;
 }
@@ -7393,22 +7586,89 @@ declare class QualifierCollector extends ValidatingConvertingCollector<Qualifier
     qualifierTypes: ReadOnlyQualifierTypeCollector;
     /**
      * Constructor for a {@link Qualifiers.QualifierCollector | QualifierCollector} object.
-     * @param params - Parameters for creating the collector.
+     * @param qualifierTypes - The {@link QualifierTypes.ReadOnlyQualifierTypeCollector | qualifier types}
+     * used to validate declarations.
+     * @param qualifiers - Optional list of fully-resolved {@link Qualifiers.IQualifierDecl | declarations}.
      * @public
      */
-    protected constructor(params: IQualifierCollectorCreateParams);
+    protected constructor(qualifierTypes: ReadOnlyQualifierTypeCollector, qualifiers?: ReadonlyArray<IQualifierDecl>);
     /**
      * 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.
+     *
+     * @remarks
+     * Accepts a mixed array of bare axis-name strings and full
+     * {@link Qualifiers.IQualifierDecl | declarations}. String elements are sugar
+     * for a literal qualifier: the library synthesizes a
+     * {@link QualifierTypes.LiteralQualifierType | LiteralQualifierType} named
+     * after the string and a declaration `{ name, typeName: name, defaultPriority }`.
+     * Synthesized priorities are distributed across the
+     * `[MinConditionPriority..MaxConditionPriority]` range adaptively to the
+     * input length (`step = max(1, floor((Max - Min) / length))`,
+     * `priority = max(Min, Max - index * step)`). Earlier elements get higher
+     * priority — matching the "earlier qualifier wins when multiple match"
+     * mental model — and the formula never overflows the `ConditionPriority`
+     * range regardless of input length.
+     *
+     * `qualifierTypes` may be omitted only when every element of `qualifiers`
+     * is a string. If any element is a declaration, `qualifierTypes` is
+     * required (and must include the referenced typeNames); the error message
+     * names the offending typeName when it is missing.
      */
     static create(params: IQualifierCollectorCreateParams): Result<QualifierCollector>;
     /**
-     * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.getByNameOrToken}
+     * Resolves the public {@link Qualifiers.IQualifierCollectorCreateParams | create params}
+     * into the concrete `(qualifierTypes, qualifiers)` pair the constructor expects.
+     *
+     * @remarks
+     * Validates the mixed-shape `qualifiers` input through
+     * {@link Converters.oneOf} (string vs {@link Qualifiers.IQualifierDecl})
+     * at the public-API boundary, then partitions into bare-string and decl
+     * buckets to drive type synthesis. If any decl is present and
+     * `qualifierTypes` is omitted, fails with an error that names the
+     * offending typeNames.
+     *
+     * @internal
+     */
+    private static _resolveCreateParams;
+    /**
+     * Returns the provided {@link QualifierTypes.ReadOnlyQualifierTypeCollector | qualifier-type collector}
+     * (or synthesizes a new one) augmented with synthesized literal qualifier types for the supplied
+     * string names that are not already present.
+     *
+     * @internal
+     */
+    private static _resolveQualifierTypes;
+    /**
+     * Normalizes a mixed `(string | IQualifierDecl)[]` into a fully-resolved
+     * `IQualifierDecl[]`, assigning descending default priorities to synthesized
+     * decls within the `[MinConditionPriority..MaxConditionPriority]` range.
+     *
+     * @remarks
+     * Step size is adaptive to input length:
+     * `step = max(1, floor((Max - Min) / length))`. Each synthesized priority
+     * is `max(Min, Max - index * step)` — clamped at the bottom so length
+     * extremes (\>1000 axes) degrade gracefully into a tail of equal-`Min`
+     * priorities rather than overflowing the `ConditionPriority` range.
+     *
+     * @internal
+     */
+    private static _normalizeQualifierDecls;
+    /**
+     * Returns an empty {@link QualifierTypes.ReadOnlyQualifierTypeCollector | qualifier-type collector}
+     * used as a placeholder when no qualifiers are supplied and the caller omits
+     * `qualifierTypes`.
+     *
+     * @internal
+     */
+    private static _emptyQualifierTypes;
+    /**
+     * {@inheritDoc Qualifiers.IReadOnlyQualifierCollector.getByNameOrToken}
      */
     getByNameOrToken(nameOrToken: string): Result<Qualifier>;
     /**
-     * {@inheritdoc Qualifiers.IReadOnlyQualifierCollector.hasNameOrToken}
+     * {@inheritDoc Qualifiers.IReadOnlyQualifierCollector.hasNameOrToken}
      */
     hasNameOrToken(nameOrToken: string): boolean;
     /**
@@ -7662,19 +7922,19 @@ export { Qualifiers }
  */
 export declare abstract class QualifierType<TCFGJSON extends JsonObject = JsonObject> implements IQualifierType<TCFGJSON> {
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.name}
+     * {@inheritDoc QualifierTypes.IQualifierType.name}
      */
     readonly name: QualifierTypeName;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
+     * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}
      */
     abstract readonly systemTypeName: QualifierTypeName;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.key}
+     * {@inheritDoc QualifierTypes.IQualifierType.key}
      */
     get key(): QualifierTypeName;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.index}
+     * {@inheritDoc QualifierTypes.IQualifierType.index}
      */
     get index(): QualifierTypeIndex | undefined;
     protected readonly _collectible: Collections.Collectible<QualifierTypeName, QualifierTypeIndex>;
@@ -7685,53 +7945,52 @@ export declare abstract class QualifierType<TCFGJSON extends JsonObject = JsonOb
     readonly allowContextList: boolean;
     /**
      * Constructor for use by derived classes.
-     * @param name - The name of the qualifier type.
-     * @param allowContextList - Flag indicating whether this qualifier type allows a
-     * comma-separated list of runtime values in the context. Defaults to `false`.
+     * @param params - The {@link QualifierTypes.IQualifierTypeCreateParams | create parameters}
+     * for this qualifier type.
      */
     protected constructor({ name, index, allowContextList }: IQualifierTypeCreateParams);
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isValidConditionValue}
+     * {@inheritDoc QualifierTypes.IQualifierType.isValidConditionValue}
      */
     abstract isValidConditionValue(value: string): value is QualifierConditionValue;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isValidContextValue}
+     * {@inheritDoc QualifierTypes.IQualifierType.isValidContextValue}
      */
     isValidContextValue(value: string): value is QualifierContextValue;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isPotentialMatch}
+     * {@inheritDoc QualifierTypes.IQualifierType.isPotentialMatch}
      */
     isPotentialMatch(conditionValue: string, contextValue: string): boolean;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateCondition}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateCondition}
      */
     validateCondition(value: string, operator?: ConditionOperator): Result<QualifierConditionValue>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateContextValue}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateContextValue}
      */
     validateContextValue(value: string): Result<QualifierContextValue>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.matches}
+     * {@inheritDoc QualifierTypes.IQualifierType.matches}
      */
     matches(condition: QualifierConditionValue, context: QualifierContextValue, operator: ConditionOperator): QualifierMatchScore;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
     abstract getConfigurationJson(): Result<JsonCompatibleType<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
     abstract validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.IQualifierTypeConfig<TCFGJSON>>>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.setIndex}
+     * {@inheritDoc QualifierTypes.IQualifierType.setIndex}
      */
     setIndex(index: number): Result<QualifierTypeIndex>;
     /**
-     * {@inheritdoc Validate.isValidQualifierTypeName}
+     * {@inheritDoc Validate.isValidQualifierTypeName}
      */
     static isValidName(name: string): name is QualifierTypeName;
     /**
-     * {@inheritdoc Validate.isValidQualifierTypeIndex}
+     * {@inheritDoc Validate.isValidQualifierTypeIndex}
      */
     static isValidIndex(index: number): index is QualifierTypeIndex;
     /**
@@ -8284,7 +8543,7 @@ declare class ResourceBuilder {
     /**
      * Given a {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}, creates and adds a
      * {@link Resources.ResourceCandidate | candidate} to the resource being built.
-     * @param candidate - The {@link ResourceJson.Json.IChildResourceCandidateDecl | IChildResourceCandidateDecl} to add to the
+     * @param childDecl - The {@link ResourceJson.Json.IChildResourceCandidateDecl | IChildResourceCandidateDecl} to add to the
      * resource being built.
      * @returns `Success` with the added {@link Resources.ResourceCandidate | candidate} if successful,
      * or `Failure` with an error message if not.
@@ -8293,7 +8552,7 @@ declare class ResourceBuilder {
     /**
      * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, creates and adds a
      * {@link Resources.ResourceCandidate | candidate} to the resource being built.
-     * @param candidate - The {@link ResourceJson.Json.ILooseResourceCandidateDecl | IResourceCandidateDecl} to add to the
+     * @param decl - The {@link ResourceJson.Json.ILooseResourceCandidateDecl | IResourceCandidateDecl} to add to the
      * resource being built.
      * @returns `Success` with the added {@link Resources.ResourceCandidate | candidate} if successful,
      * or `Failure` with an error message if not. Fails with error detail 'type-mismatch' if the candidate
@@ -8473,7 +8732,7 @@ declare class ResourceDeclCollection implements IResourceDeclContainer {
      */
     readonly collection: Normalized.IImporterResourceCollectionDecl;
     /**
-     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     * {@inheritDoc ResourceJson.IResourceDeclContainer.context}
      */
     get context(): Normalized.IContainerContextDecl | undefined;
     protected _resources: Normalized.IImporterResourceDecl[];
@@ -8513,7 +8772,7 @@ declare class ResourceDeclTree implements IResourceDeclContainer {
      */
     readonly tree: Normalized.IResourceTreeRootDecl;
     /**
-     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     * {@inheritDoc ResourceJson.IResourceDeclContainer.context}
      */
     get context(): Normalized.IContainerContextDecl | undefined;
     protected _resources: Normalized.ILooseResourceDecl[];
@@ -8682,7 +8941,7 @@ export declare class ResourceManagerBuilder implements IResourceManager<Resource
      */
     get size(): number;
     /**
-     * {@inheritdoc Runtime.IResourceManager.numResources}
+     * {@inheritDoc Runtime.IResourceManager.numResources}
      */
     get numResources(): number;
     /**
@@ -8690,11 +8949,11 @@ export declare class ResourceManagerBuilder implements IResourceManager<Resource
      */
     protected _numCandidates?: number;
     /**
-     * {@inheritdoc Runtime.IResourceManager.numCandidates}
+     * {@inheritDoc Runtime.IResourceManager.numCandidates}
      */
     get numCandidates(): number;
     /**
-     * {@inheritdoc Runtime.IResourceManager.builtResources}
+     * {@inheritDoc Runtime.IResourceManager.builtResources}
      */
     get builtResources(): Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>;
     /**
@@ -8734,7 +8993,7 @@ export declare class ResourceManagerBuilder implements IResourceManager<Resource
     /**
      * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
      * a {@link Resources.ResourceCandidate | candidate} to the manager.
-     * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.
+     * @param decl - The {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration} to add.
      * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.
      * @public
      */
@@ -8749,7 +9008,7 @@ export declare class ResourceManagerBuilder implements IResourceManager<Resource
     addCondition(decl: ResourceJson.Json.ILooseConditionDecl): Result<Condition>;
     /**
      * Adds a condition set to the manager.
-     * @param decl - The condition set declaration to add.
+     * @param conditions - The {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration} to add.
      * @returns `Success` with the condition set if successful, or `Failure` with an error message if not.
      * @public
      */
@@ -9513,7 +9772,7 @@ export declare abstract class ResourceType<T = unknown> implements IResourceType
     private _collectible;
     private _template;
     /**
-     * {@inheritdoc ResourceTypes.IResourceType.key}
+     * {@inheritDoc ResourceTypes.IResourceType.key}
      */
     get key(): ResourceTypeName;
     /**
@@ -9521,7 +9780,7 @@ export declare abstract class ResourceType<T = unknown> implements IResourceType
      */
     abstract readonly systemTypeName: ResourceTypeName;
     /**
-     * {@inheritdoc ResourceTypes.IResourceType.index}
+     * {@inheritDoc ResourceTypes.IResourceType.index}
      */
     get index(): ResourceTypeIndex | undefined;
     protected constructor(key: ResourceTypeName, index?: number, template?: JsonObject);
@@ -10012,7 +10271,7 @@ declare const TerritoryPrioritySystemConfiguration: ISystemConfiguration;
  */
 declare class TerritoryQualifierType extends QualifierType<JsonCompatibleType<Config_2.ITerritoryQualifierTypeConfig>> {
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
+     * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}
      */
     readonly systemTypeName: QualifierTypeName;
     /**
@@ -10035,7 +10294,7 @@ declare class TerritoryQualifierType extends QualifierType<JsonCompatibleType<Co
      */
     protected constructor({ acceptLowercase, allowedTerritories, allowContextList, name, index, hierarchy }: ITerritoryQualifierTypeCreateParams);
     /**
-     * {@inheritdoc QualifierTypes.QualifierType.isValidConditionValue}
+     * {@inheritDoc QualifierTypes.QualifierType.isValidConditionValue}
      */
     isValidConditionValue(value: string): value is QualifierConditionValue;
     /**
@@ -10063,11 +10322,11 @@ declare class TerritoryQualifierType extends QualifierType<JsonCompatibleType<Co
      */
     getConfiguration(): Result<Config_2.ISystemTerritoryQualifierTypeConfig>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
     getConfigurationJson(): Result<JsonCompatibleType<Config_2.ISystemTerritoryQualifierTypeConfig>>;
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
     validateConfigurationJson(from: unknown): Result<JsonCompatibleType<Config_2.ISystemTerritoryQualifierTypeConfig>>;
     /**
@@ -10078,7 +10337,7 @@ declare class TerritoryQualifierType extends QualifierType<JsonCompatibleType<Co
      */
     validateConfiguration(from: unknown): Result<Config_2.ISystemTerritoryQualifierTypeConfig>;
     /**
-     * {@inheritdoc QualifierTypes.QualifierType._matchOne}
+     * {@inheritDoc QualifierTypes.QualifierType._matchOne}
      */
     protected _matchOne(condition: QualifierConditionValue, context: QualifierContextValue, __operator?: ConditionOperator): QualifierMatchScore;
     /**
@@ -10167,7 +10426,7 @@ declare function toConditionPriority(priority: number): Result<ConditionPriority
 
 /**
  * Converts a string to a {@link ConditionSetHash} if it is a valid condition set hash.
- * @param key - the string to convert
+ * @param hash - the string to convert
  * @returns `Success` with the converted {@link ConditionSetHash} if successful, or `Failure` with an
  * error message if not.
  * @public
@@ -10238,9 +10497,9 @@ declare function toContextToken(token: string): Result<ContextToken>;
 declare function toDecisionIndex(index: number): Result<DecisionIndex>;
 
 /**
- * Converts a number to a {@link DecisionIndex} if it is a valid decision index.
- * @param index - the number to convert
- * @returns `Success` with the converted {@link DecisionIndex} if successful, or `Failure` with an
+ * Converts a string to a {@link DecisionKey} if it is a valid decision key.
+ * @param key - the string to convert
+ * @returns `Success` with the converted {@link DecisionKey} if successful, or `Failure` with an
  * error message if not.
  * @public
  */
@@ -10351,7 +10610,7 @@ declare function toResourceIndex(index: number): Result<ResourceIndex>;
 /**
  * Converts a string to a {@link ResourceName | resource name}.
  *
- * @param id - The string to convert.
+ * @param name - The string to convert.
  * @returns `Success` with the converted name if valid, or `Failure` with an error message
  * if not.
  * @public
@@ -10378,6 +10637,148 @@ declare function toResourceTypeIndex(index: number): Result<ResourceTypeIndex>;
  */
 declare function toResourceTypeName(name: string): Result<ResourceTypeName>;
 
+/**
+ * Returns a `Converter` for a `Json.IChildResourceCandidateDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedChildResourceCandidateDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IChildResourceCandidateDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IChildResourceDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedChildResourceDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IChildResourceDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for an `IConditionDecl<TQualifierNames>` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * Pass e.g. `Converters.enumeratedValue(['tone', 'language'] as const)` to reject
+ * typo'd qualifier names at convert time and to narrow the resulting
+ * `IConditionDecl<T>` type to the same literal-string union. The default
+ * `conditionDecl` is the `Converters.string` instantiation of this shape.
+ *
+ * @public
+ */
+declare function typedConditionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IConditionDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.ConditionSetDecl<TQualifierNames>`
+ * (either array form or record form) narrowed on a supplied `qualifierName`
+ * converter.
+ *
+ * @public
+ */
+declare function typedConditionSetDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.ConditionSetDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for an `IConditionSetDecl<TQualifierNames>` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * Each contained condition is converted via `typedConditionDecl(qualifierNameConverter)`.
+ *
+ * @public
+ */
+declare function typedConditionSetDecl_2<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IConditionSetDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IContainerContextDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedContainerContextDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IContainerContextDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IImporterResourceCandidateDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedImporterResourceCandidateDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IImporterResourceCandidateDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IImporterResourceCollectionDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedImporterResourceCollectionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IImporterResourceCollectionDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.ILooseConditionDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedLooseConditionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.ILooseConditionDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.ILooseResourceCandidateDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedLooseResourceCandidateDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.ILooseResourceCandidateDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.ILooseResourceDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedLooseResourceDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.ILooseResourceDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IResourceCollectionDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedResourceCollectionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IResourceCollectionDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IResourceTreeChildNodeDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedResourceTreeChildNodeDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IResourceTreeChildNodeDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for a `Json.IResourceTreeRootDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedResourceTreeRootDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<Json.IResourceTreeRootDecl<TQualifierNames>>;
+
+/**
+ * Returns a `Converter` for an `IValidatedConditionDecl` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @remarks
+ * The typed sibling layers literal-string narrowing on top of the existing
+ * collector-membership check performed by `validatedConditionDecl`.
+ *
+ * @public
+ */
+declare function typedValidatedConditionDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IValidatedConditionDecl, IConditionDeclConvertContext>;
+
+/**
+ * Returns a `Converter` for an `IValidatedConditionSetDecl` narrowed on a supplied
+ * `qualifierName` converter.
+ *
+ * @public
+ */
+declare function typedValidatedConditionSetDecl<TQualifierNames extends string>(qualifierNameConverter: Converter<TQualifierNames>): Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>;
+
 /**
  * Creates a copy of the provided {@link Config.Model.ISystemConfiguration | system configuration}
  * with updated qualifier default values.
@@ -10457,6 +10858,12 @@ export { Validate }
  * Converter which constructs a {@link Conditions.IValidatedConditionDecl | validated condition declaration}
  * from a {@link Conditions.IConditionDecl | condition declaration}, instantiating qualifiers by name
  * from a supplied {@link Conditions.Convert.IConditionDeclConvertContext | conversion context}.
+ *
+ * @remarks
+ * Accepts any string as the `qualifierName`; the collector membership check still rejects unknown
+ * names. Use `typedValidatedConditionDecl` to layer literal-string narrowing on top of the
+ * collector check.
+ *
  * @public
  */
 declare const validatedConditionDecl: Converter<IValidatedConditionDecl, IConditionDeclConvertContext>;
@@ -10465,6 +10872,11 @@ declare const validatedConditionDecl: Converter<IValidatedConditionDecl, ICondit
  * Converter which constructs a {@link Conditions.IValidatedConditionSetDecl | validated condition set declaration}
  * from a {@link Conditions.IConditionSetDecl | condition set declaration}, instantiating qualifiers by name
  * from a supplied {@link Conditions.Convert.IConditionSetDeclConvertContext | conversion context}.
+ *
+ * @remarks
+ * Accepts any string as the qualifier name. Use `typedValidatedConditionSetDecl` to layer
+ * literal-string narrowing on top of the collector-membership check.
+ *
  * @public
  */
 declare const validatedConditionSetDecl: Converter<IValidatedConditionSetDecl, IConditionSetDeclConvertContext>;