@fgv/ts-res 5.1.0-28 → 5.1.0-29

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

@@ -2,13 +2,21 @@ import { JsonObject } from '@fgv/ts-json-base';
 import { ConditionOperator, ResourceValueMergeMethod } from '../common';
 /**
  * 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
  */
-export interface ILooseConditionDecl {
+export 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.
      */
@@ -51,25 +59,51 @@ export interface IChildConditionDecl {
     scoreAsDefault?: number;
 }
 /**
- * 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
  */
-export type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;
+export 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
  */
-export type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;
+export type ConditionSetDeclAsRecord<TQualifierNames extends string = string> = Readonly<Partial<Record<TQualifierNames, string | IChildConditionDecl>>>;
 /**
- * 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
  */
-export type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;
+export type ConditionSetDecl<TQualifierNames extends string = string> = ConditionSetDeclAsArray<TQualifierNames> | ConditionSetDeclAsRecord<TQualifierNames>;
 /**
  * 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
  */
-export interface IChildResourceCandidateDecl {
+export interface IChildResourceCandidateDecl<TQualifierNames extends string = string> {
     /**
      * The JSON value of the resource.
      */
@@ -77,7 +111,7 @@ export 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.
      */
@@ -91,9 +125,14 @@ export interface IChildResourceCandidateDecl {
 /**
  * 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
  */
-export interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {
+export interface IImporterResourceCandidateDecl<TQualifierNames extends string = string> extends IChildResourceCandidateDecl<TQualifierNames> {
     /**
      * The {@link ResourceId | id} of the resource.
      */
@@ -105,9 +144,14 @@ export interface IImporterResourceCandidateDecl extends IChildResourceCandidateD
 }
 /**
  * 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
  */
-export interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {
+export interface ILooseResourceCandidateDecl<TQualifierNames extends string = string> extends IChildResourceCandidateDecl<TQualifierNames> {
     /**
      * The {@link ResourceId | id} of the resource.
      */
@@ -119,7 +163,7 @@ export interface ILooseResourceCandidateDecl extends 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.
      */
@@ -136,9 +180,15 @@ export interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl
 }
 /**
  * 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
  */
-export interface IChildResourceDecl {
+export interface IChildResourceDecl<TQualifierNames extends string = string> {
     /**
      * The name of the type of this resource.
      */
@@ -146,13 +196,18 @@ export interface IChildResourceDecl {
     /**
      * Possible candidates for this value.
      */
-    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl<TQualifierNames>>;
 }
 /**
  * Non-validated loose declaration of a {@link Resources.Resource | resource}.
+ *
+ * @remarks
+ * Parameterized on `TQualifierNames`; inherits via `IChildResourceDecl`.
+ * Defaults to `string` for back-compat.
+ *
  * @public
  */
-export interface ILooseResourceDecl extends IChildResourceDecl {
+export interface ILooseResourceDecl<TQualifierNames extends string = string> extends IChildResourceDecl<TQualifierNames> {
     /**
      * The id of the resource.
      */
@@ -164,71 +219,105 @@ export interface ILooseResourceDecl extends IChildResourceDecl {
     /**
      * Possible candidates for this value.
      */
-    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;
+    readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl<TQualifierNames>>;
 }
 /**
  * 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
  */
-export interface IResourceTreeChildNodeDecl {
-    readonly resources?: Record<string, IChildResourceDecl>;
-    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+export interface IResourceTreeChildNodeDecl<TQualifierNames extends string = string> {
+    readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;
+    readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;
 }
 /**
  * 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
  */
-export interface IContainerContextDecl {
+export interface IContainerContextDecl<TQualifierNames extends string = string> {
     readonly baseId?: string;
-    readonly conditions?: ConditionSetDecl;
+    readonly conditions?: ConditionSetDecl<TQualifierNames>;
     readonly mergeMethod?: ResourceValueMergeMethod;
 }
 /**
  * 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
  */
-export interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
-    readonly context?: IContainerContextDecl;
-    readonly resources?: Record<string, IChildResourceDecl>;
-    readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+export 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;
 }
 /**
  * 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
  */
-export interface IResourceCollectionDecl {
-    readonly context?: IContainerContextDecl;
-    readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
-    readonly resources?: ReadonlyArray<ILooseResourceDecl>;
-    readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+export 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;
 }
 /**
  * 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
  */
-export type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;
+export type IImporterResourceDecl<TQualifierNames extends string = string> = ILooseResourceDecl<TQualifierNames> | IChildResourceDecl<TQualifierNames>;
 /**
  * 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
  */
-export interface IImporterResourceCollectionDecl {
-    readonly context?: IContainerContextDecl;
-    readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;
-    readonly resources?: ReadonlyArray<IImporterResourceDecl>;
-    readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;
+export 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;
 }
 /**
  * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.
  * @public
  */
-export declare function isLooseResourceCandidateDecl(decl: IImporterResourceCandidateDecl): decl is ILooseResourceCandidateDecl;
+export 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
  */
-export declare function isLooseResourceDecl(decl: IImporterResourceDecl): decl is ILooseResourceDecl;
+export declare function isLooseResourceDecl<TQualifierNames extends string = string>(decl: IImporterResourceDecl<TQualifierNames>): decl is ILooseResourceDecl<TQualifierNames>;
 //# sourceMappingURL=json.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":"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"}

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

@@ -28,13 +28,13 @@ exports.isLooseResourceDecl = isLooseResourceDecl;
  * @public
  */
 function isLooseResourceCandidateDecl(decl) {
-    return 'id' in decl;
+    return 'id' in decl && typeof decl.id === 'string';
 }
 /**
  * Type guard function to check if a resource declaration is a loose resource declaration.
  * @public
  */
 function isLooseResourceDecl(decl) {
-    return 'id' in decl;
+    return 'id' in decl && typeof decl.id === 'string';
 }
 //# sourceMappingURL=json.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAsQH,oEAIC;AAMD,kDAEC;AAhBD;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,IAAoC;IAEpC,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAA2B;IAC7D,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { ConditionOperator, ResourceValueMergeMethod } from '../common';\n\n/**\n * Non-validated loose declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface ILooseConditionDecl {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: string;\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated child declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface IChildConditionDecl {\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Non-validated declaration of a resource candidate for import,\n * which can be either a loose or child resource candidate.\n * @public\n */\nexport interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id?: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Declared context for a resource container.\n * @public\n */\nexport interface IContainerContextDecl {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly context?: IContainerContextDecl;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a resource for import,\n * which can be either a loose or child resource.\n * @public\n */\nexport type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;\n\n/**\n * Non-validated declaration of a collection of resources for an importer.\n * @public\n */\nexport interface IImporterResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.\n * @public\n */\nexport function isLooseResourceCandidateDecl(\n  decl: IImporterResourceCandidateDecl\n): decl is ILooseResourceCandidateDecl {\n  return 'id' in decl;\n}\n\n/**\n * Type guard function to check if a resource declaration is a loose resource declaration.\n * @public\n */\nexport function isLooseResourceDecl(decl: IImporterResourceDecl): decl is ILooseResourceDecl {\n  return 'id' in decl;\n}\n"]}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AA2WH,oEAIC;AAMD,kDAIC;AAlBD;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,IAAqD;IAErD,OAAO,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CACjC,IAA4C;IAE5C,OAAO,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC;AACrD,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { ConditionOperator, ResourceValueMergeMethod } from '../common';\n\n/**\n * Non-validated loose declaration of a {@link Conditions.Condition | condition}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so consumers authoring conditions\n * in code can opt into compile-time axis-name discipline (e.g. via a\n * literal-string union derived from a `qualifiers: ['tone'] as const`\n * decl-array). Defaults to `string`, so existing untyped callers\n * compile unchanged.\n *\n * @public\n */\nexport interface ILooseConditionDecl<TQualifierNames extends string = string> {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: TQualifierNames;\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated child declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface IChildConditionDecl {\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated array-form declaration of a {@link Conditions.ConditionSet | condition set}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` via `ILooseConditionDecl`;\n * defaults to `string` for back-compat with existing untyped callers.\n *\n * @public\n */\nexport type ConditionSetDeclAsArray<TQualifierNames extends string = string> = ReadonlyArray<\n  ILooseConditionDecl<TQualifierNames>\n>;\n\n/**\n * Non-validated record-form declaration of a {@link Conditions.ConditionSet | condition set}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; defaults to `string` for back-compat with\n * existing untyped callers. Uses `Readonly<Partial<Record<...>>>` to align with\n * runtime reality (missing keys produce `undefined`; the `Partial` makes TypeScript\n * aware of this, which is a strict type-system tightening).\n *\n * @public\n */\nexport type ConditionSetDeclAsRecord<TQualifierNames extends string = string> = Readonly<\n  Partial<Record<TQualifierNames, string | IChildConditionDecl>>\n>;\n\n/**\n * Non-validated declaration of a {@link Conditions.ConditionSet | condition set}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; defaults to `string`. Both the\n * array form (`ConditionSetDeclAsArray`) and the record form\n * (`ConditionSetDeclAsRecord`) inherit the parameter, so a\n * consumer threading a narrow `TQualifierNames` gets compile-time\n * rejection of typo'd axis names in either form.\n *\n * @public\n */\nexport type ConditionSetDecl<TQualifierNames extends string = string> =\n  | ConditionSetDeclAsArray<TQualifierNames>\n  | ConditionSetDeclAsRecord<TQualifierNames>;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `conditions` field can carry a\n * narrowed axis-name set. Defaults to `string` so existing untyped callers\n * compile unchanged.\n *\n * @public\n */\nexport interface IChildResourceCandidateDecl<TQualifierNames extends string = string> {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl<TQualifierNames>;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Non-validated declaration of a resource candidate for import,\n * which can be either a loose or child resource candidate.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; inherits via `IChildResourceCandidateDecl`.\n * Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface IImporterResourceCandidateDecl<TQualifierNames extends string = string>\n  extends IChildResourceCandidateDecl<TQualifierNames> {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id?: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; inherits via `IChildResourceCandidateDecl`.\n * Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface ILooseResourceCandidateDecl<TQualifierNames extends string = string>\n  extends IChildResourceCandidateDecl<TQualifierNames> {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl<TQualifierNames>;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated child declaration of a {@link Resources.Resource | resource}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `candidates` field threads the\n * narrowed axis-name set down to each candidate. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IChildResourceDecl<TQualifierNames extends string = string> {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl<TQualifierNames>>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; inherits via `IChildResourceDecl`.\n * Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface ILooseResourceDecl<TQualifierNames extends string = string>\n  extends IChildResourceDecl<TQualifierNames> {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl<TQualifierNames>>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `resources` and `children` fields\n * thread the narrowed axis-name set throughout the tree. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IResourceTreeChildNodeDecl<TQualifierNames extends string = string> {\n  readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;\n}\n\n/**\n * Declared context for a resource container.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `conditions` field threads the\n * narrowed axis-name set to the container context. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IContainerContextDecl<TQualifierNames extends string = string> {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl<TQualifierNames>;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `context` field threads the\n * narrowed axis-name set to the tree root context. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IResourceTreeRootDecl<TQualifierNames extends string = string>\n  extends IResourceTreeChildNodeDecl<TQualifierNames> {\n  readonly context?: IContainerContextDecl<TQualifierNames>;\n  readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `context`, `candidates`, and\n * `resources` fields thread the narrowed axis-name set throughout the\n * collection. Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface IResourceCollectionDecl<TQualifierNames extends string = string> {\n  readonly context?: IContainerContextDecl<TQualifierNames>;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl<TQualifierNames>>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl<TQualifierNames>>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl<TQualifierNames>>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a resource for import,\n * which can be either a loose or child resource.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; defaults to `string` for back-compat.\n *\n * @public\n */\nexport type IImporterResourceDecl<TQualifierNames extends string = string> =\n  | ILooseResourceDecl<TQualifierNames>\n  | IChildResourceDecl<TQualifierNames>;\n\n/**\n * Non-validated declaration of a collection of resources for an importer.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `context`, `candidates`, and\n * `resources` fields thread the narrowed axis-name set throughout the\n * importer collection. Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface IImporterResourceCollectionDecl<TQualifierNames extends string = string> {\n  readonly context?: IContainerContextDecl<TQualifierNames>;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl<TQualifierNames>>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl<TQualifierNames>>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl<TQualifierNames>>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.\n * @public\n */\nexport function isLooseResourceCandidateDecl<TQualifierNames extends string = string>(\n  decl: IImporterResourceCandidateDecl<TQualifierNames>\n): decl is ILooseResourceCandidateDecl<TQualifierNames> {\n  return 'id' in decl && typeof decl.id === 'string';\n}\n\n/**\n * Type guard function to check if a resource declaration is a loose resource declaration.\n * @public\n */\nexport function isLooseResourceDecl<TQualifierNames extends string = string>(\n  decl: IImporterResourceDecl<TQualifierNames>\n): decl is ILooseResourceDecl<TQualifierNames> {\n  return 'id' in decl && typeof decl.id === 'string';\n}\n"]}

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

@@ -13,8 +13,15 @@ export interface ISimpleContextQualifierProviderCreateParams {
     qualifiers: IReadOnlyQualifierCollector;
     /**
      * Optional record of initial qualifier name-value pairs to populate the provider.
-     */
-    qualifierValues?: Record<string, QualifierContextValue>;
+     *
+     * @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?: Readonly<Partial<Record<string, QualifierContextValue>>>;
 }
 /**
  * Simple concrete implementation of {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider}

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

@@ -1 +1 @@
-{"version":3,"file":"simpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/simpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAoE,MAAM,eAAe,CAAC;AACzG,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EAGf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAExG;;;GAGG;AACH,MAAM,WAAW,2CAA2C;IAC1D;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,qBAAa,8BACX,SAAQ,wBACR,YAAW,gCAAgC;IAE3C;;;OAGG;IACH,SAAgB,OAAO,EAAE,IAAI,CAAiB;IAE9C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkD;IAEnF;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,2CAA2C;IAazE;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,2CAA2C,GAClD,MAAM,CAAC,8BAA8B,CAAC;IAIzC;;;;;OAKG;IACI,GAAG,CACR,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAMhC;;;;;;OAMG;IACI,YAAY,CACjB,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAQhC;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAIhD;;;;OAIG;IACI,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAIvD;;;;;;;OAOG;IACI,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAK5F;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAOjE;;;;OAIG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;CAc/C"}
+{"version":3,"file":"simpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/simpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAoE,MAAM,eAAe,CAAC;AACzG,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EAGf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAExG;;;GAGG;AACH,MAAM,WAAW,2CAA2C;IAC1D;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED;;;;GAIG;AACH,qBAAa,8BACX,SAAQ,wBACR,YAAW,gCAAgC;IAE3C;;;OAGG;IACH,SAAgB,OAAO,EAAE,IAAI,CAAiB;IAE9C;;OAEG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkD;IAEnF;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,2CAA2C;IAgBzE;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,2CAA2C,GAClD,MAAM,CAAC,8BAA8B,CAAC;IAIzC;;;;;OAKG;IACI,GAAG,CACR,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAMhC;;;;;;OAMG;IACI,YAAY,CACjB,sBAAsB,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,GACjE,MAAM,CAAC,qBAAqB,CAAC;IAQhC;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;IAIhD;;;;OAIG;IACI,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAIvD;;;;;;;OAOG;IACI,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAK5F;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAOjE;;;;OAIG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;CAc/C"}

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

@@ -47,6 +47,9 @@ class SimpleContextQualifierProvider extends contextQualifierProvider_1.ContextQ
         this._qualifierValues = new ts_utils_1.ResultMap();
         if (params.qualifierValues) {
             for (const [name, value] of Object.entries(params.qualifierValues)) {
+                if (value === undefined) {
+                    continue;
+                }
                 const qualifierName = common_1.Validate.toQualifierName(name).orThrow();
                 this._qualifierValues.set(qualifierName, value);
             }

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

@@ -1 +1 @@
-{"version":3,"file":"simpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/simpleContextQualifierProvider.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 { Result, ResultMap, captureResult, succeed, succeedWithDetail, Converters } from '@fgv/ts-utils';\nimport {\n  QualifierName,\n  QualifierContextValue,\n  QualifierIndex,\n  Validate,\n  Convert as CommonConverters\n} from '../../common';\nimport { IReadOnlyQualifierCollector, Qualifier } from '../../qualifiers';\nimport { ContextQualifierProvider, IMutableContextQualifierProvider } from './contextQualifierProvider';\n\n/**\n * Parameters for creating a {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider}.\n * @public\n */\nexport interface ISimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   */\n  qualifierValues?: Record<string, QualifierContextValue>;\n}\n\n/**\n * Simple concrete implementation of {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider}\n * using a `ResultMap` for qualifier value storage.\n * @public\n */\nexport class SimpleContextQualifierProvider\n  extends ContextQualifierProvider\n  implements IMutableContextQualifierProvider\n{\n  /**\n   * Explicit mutability marker for compile-time type discrimination.\n   * Always `true` for mutable providers.\n   */\n  public readonly mutable: true = true as const;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Internal storage for qualifier values using a ResultMap.\n   */\n  private readonly _qualifierValues: ResultMap<QualifierName, QualifierContextValue>;\n\n  /**\n   * Constructor for a {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.ISimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: ISimpleContextQualifierProviderCreateParams) {\n    super();\n    this.qualifiers = params.qualifiers;\n    this._qualifierValues = new ResultMap<QualifierName, QualifierContextValue>();\n\n    if (params.qualifierValues) {\n      for (const [name, value] of Object.entries(params.qualifierValues)) {\n        const qualifierName = Validate.toQualifierName(name).orThrow();\n        this._qualifierValues.set(qualifierName, value);\n      }\n    }\n  }\n\n  /**\n   * Creates a new {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.ISimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: ISimpleContextQualifierProviderCreateParams\n  ): Result<SimpleContextQualifierProvider> {\n    return captureResult(() => new SimpleContextQualifierProvider(params));\n  }\n\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public get(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue> {\n    return this._resolveQualifierName(nameOrIndexOrQualifier).onSuccess((qualifierName) => {\n      return this._qualifierValues.get(qualifierName);\n    });\n  }\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * TODO: Implement validation logic using qualifier collectors.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue> {\n    return this._resolveQualifier(nameOrIndexOrQualifier).onSuccess((qualifier) => {\n      return this._qualifierValues.get(qualifier.name).asResult.onSuccess((value) => {\n        return qualifier.validateContextValue(value);\n      });\n    });\n  }\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  public has(name: QualifierName): Result<boolean> {\n    return succeed(this._qualifierValues.has(name));\n  }\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  public getNames(): Result<ReadonlyArray<QualifierName>> {\n    return succeed(Array.from(this._qualifierValues.keys()));\n  }\n\n  /**\n   * Sets a qualifier value in this provider.\n   * @param name - The {@link QualifierName | qualifier name} to set.\n   * @param value - The {@link QualifierContextValue | qualifier context value} to set.\n   * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public set(name: QualifierName, value: QualifierContextValue): Result<QualifierContextValue> {\n    this._qualifierValues.set(name, value);\n    return succeed(value);\n  }\n\n  /**\n   * Removes a qualifier value from this provider.\n   * @param name - The {@link QualifierName | qualifier name} to remove.\n   * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not found or an error occurs.\n   * @public\n   */\n  public remove(name: QualifierName): Result<QualifierContextValue> {\n    return this._qualifierValues.get(name).onSuccess((value) => {\n      this._qualifierValues.delete(name);\n      return succeedWithDetail(value, 'success');\n    });\n  }\n\n  /**\n   * Gets the number of qualifier values in this provider.\n   * @returns The count of qualifier values.\n   * @public\n   */\n  public get size(): number {\n    return this._qualifierValues.size;\n  }\n\n  /**\n   * Clears all qualifier values from this provider.\n   * @public\n   */\n  public clear(): void {\n    this._qualifierValues.clear();\n  }\n\n  /**\n   * Resolves a qualifier from a name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link Qualifier | qualifier} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private _resolveQualifier(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<Qualifier> {\n    if (nameOrIndexOrQualifier instanceof Qualifier) {\n      return succeed(nameOrIndexOrQualifier);\n    }\n    /* c8 ignore next 16 - functional code tested but coverage intermittently missed */\n    if (typeof nameOrIndexOrQualifier === 'string') {\n      return this.qualifiers.validating\n        .get(nameOrIndexOrQualifier)\n        .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid qualifier name.`);\n    }\n\n    if (typeof nameOrIndexOrQualifier === 'number') {\n      return this.qualifiers\n        .getAt(nameOrIndexOrQualifier)\n        .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid qualifier index.`);\n    }\n\n    return SimpleContextQualifierProvider._qualifierNameFromQualifierLike(nameOrIndexOrQualifier)\n      .onSuccess((qualifierName) => this.qualifiers.validating.get(qualifierName))\n      .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid Qualifier, name or index.`);\n  }\n\n  /**\n   * Resolves a qualifier name from a name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link QualifierName | qualifier name} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private _resolveQualifierName(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierName> {\n    return this._resolveQualifier(nameOrIndexOrQualifier).onSuccess((qualifier) => succeed(qualifier.name));\n  }\n\n  /**\n   * Resolves a qualifier name from a qualifier-like object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link QualifierName | qualifier name} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private static _qualifierNameFromQualifierLike(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierName> {\n    return Converters.isA(\n      'Qualifier-like object',\n      (v): v is { name: QualifierName } =>\n        typeof v === 'object' &&\n        v !== null &&\n        'name' in v &&\n        typeof (v as Record<string, unknown>).name === 'string'\n    )\n      .map((v) => CommonConverters.qualifierName.convert(v.name))\n      .convert(nameOrIndexOrQualifier);\n  }\n}\n"]}
+{"version":3,"file":"simpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/simpleContextQualifierProvider.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 { Result, ResultMap, captureResult, succeed, succeedWithDetail, Converters } from '@fgv/ts-utils';\nimport {\n  QualifierName,\n  QualifierContextValue,\n  QualifierIndex,\n  Validate,\n  Convert as CommonConverters\n} from '../../common';\nimport { IReadOnlyQualifierCollector, Qualifier } from '../../qualifiers';\nimport { ContextQualifierProvider, IMutableContextQualifierProvider } from './contextQualifierProvider';\n\n/**\n * Parameters for creating a {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider}.\n * @public\n */\nexport interface ISimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   *\n   * @remarks\n   * Typed as `Readonly<Partial<Record<string, QualifierContextValue>>>` so a\n   * caller can naturally express conditional context construction, e.g.\n   * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is\n   * `undefined` are skipped on load - semantically equivalent to omitting\n   * the key, which is how the candidate selector treats a missing key.\n   */\n  qualifierValues?: Readonly<Partial<Record<string, QualifierContextValue>>>;\n}\n\n/**\n * Simple concrete implementation of {@link Runtime.Context.IContextQualifierProvider | IContextQualifierProvider}\n * using a `ResultMap` for qualifier value storage.\n * @public\n */\nexport class SimpleContextQualifierProvider\n  extends ContextQualifierProvider\n  implements IMutableContextQualifierProvider\n{\n  /**\n   * Explicit mutability marker for compile-time type discrimination.\n   * Always `true` for mutable providers.\n   */\n  public readonly mutable: true = true as const;\n\n  /**\n   * The readonly qualifier collector that defines and validates the qualifiers for this context.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Internal storage for qualifier values using a ResultMap.\n   */\n  private readonly _qualifierValues: ResultMap<QualifierName, QualifierContextValue>;\n\n  /**\n   * Constructor for a {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.ISimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: ISimpleContextQualifierProviderCreateParams) {\n    super();\n    this.qualifiers = params.qualifiers;\n    this._qualifierValues = new ResultMap<QualifierName, QualifierContextValue>();\n\n    if (params.qualifierValues) {\n      for (const [name, value] of Object.entries(params.qualifierValues)) {\n        if (value === undefined) {\n          continue;\n        }\n        const qualifierName = Validate.toQualifierName(name).orThrow();\n        this._qualifierValues.set(qualifierName, value);\n      }\n    }\n  }\n\n  /**\n   * Creates a new {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.ISimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: ISimpleContextQualifierProviderCreateParams\n  ): Result<SimpleContextQualifierProvider> {\n    return captureResult(() => new SimpleContextQualifierProvider(params));\n  }\n\n  /**\n   * Gets a qualifier value by its name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found or an error occurs.\n   */\n  public get(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue> {\n    return this._resolveQualifierName(nameOrIndexOrQualifier).onSuccess((qualifierName) => {\n      return this._qualifierValues.get(qualifierName);\n    });\n  }\n\n  /**\n   * Gets a validated qualifier context value by its name, index, or qualifier object.\n   * TODO: Implement validation logic using qualifier collectors.\n   * @param nameOrIndexOrQualifier - The {@link QualifierName | qualifier name}, {@link QualifierIndex | index}, or {@link Qualifiers.Qualifier | qualifier object} to look up.\n   * @returns `Success` with the validated {@link QualifierContextValue | qualifier context value} if found,\n   * or `Failure` with an error message if not found, invalid, or an error occurs.\n   */\n  public getValidated(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierContextValue> {\n    return this._resolveQualifier(nameOrIndexOrQualifier).onSuccess((qualifier) => {\n      return this._qualifierValues.get(qualifier.name).asResult.onSuccess((value) => {\n        return qualifier.validateContextValue(value);\n      });\n    });\n  }\n\n  /**\n   * Checks if a qualifier value exists with the given name.\n   * @param name - The {@link QualifierName | qualifier name} to check.\n   * @returns `Success` with `true` if the qualifier value exists, `false` if it doesn't,\n   * or `Failure` with an error message if an error occurs during the check.\n   */\n  public has(name: QualifierName): Result<boolean> {\n    return succeed(this._qualifierValues.has(name));\n  }\n\n  /**\n   * Gets all available qualifier names in this context.\n   * @returns `Success` with an array of all {@link QualifierName | qualifier names},\n   * or `Failure` with an error message if an error occurs.\n   */\n  public getNames(): Result<ReadonlyArray<QualifierName>> {\n    return succeed(Array.from(this._qualifierValues.keys()));\n  }\n\n  /**\n   * Sets a qualifier value in this provider.\n   * @param name - The {@link QualifierName | qualifier name} to set.\n   * @param value - The {@link QualifierContextValue | qualifier context value} to set.\n   * @returns `Success` with the set {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public set(name: QualifierName, value: QualifierContextValue): Result<QualifierContextValue> {\n    this._qualifierValues.set(name, value);\n    return succeed(value);\n  }\n\n  /**\n   * Removes a qualifier value from this provider.\n   * @param name - The {@link QualifierName | qualifier name} to remove.\n   * @returns `Success` with the removed {@link QualifierContextValue | qualifier context value} if successful,\n   * or `Failure` with an error message if not found or an error occurs.\n   * @public\n   */\n  public remove(name: QualifierName): Result<QualifierContextValue> {\n    return this._qualifierValues.get(name).onSuccess((value) => {\n      this._qualifierValues.delete(name);\n      return succeedWithDetail(value, 'success');\n    });\n  }\n\n  /**\n   * Gets the number of qualifier values in this provider.\n   * @returns The count of qualifier values.\n   * @public\n   */\n  public get size(): number {\n    return this._qualifierValues.size;\n  }\n\n  /**\n   * Clears all qualifier values from this provider.\n   * @public\n   */\n  public clear(): void {\n    this._qualifierValues.clear();\n  }\n\n  /**\n   * Resolves a qualifier from a name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link Qualifier | qualifier} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private _resolveQualifier(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<Qualifier> {\n    if (nameOrIndexOrQualifier instanceof Qualifier) {\n      return succeed(nameOrIndexOrQualifier);\n    }\n    /* c8 ignore next 16 - functional code tested but coverage intermittently missed */\n    if (typeof nameOrIndexOrQualifier === 'string') {\n      return this.qualifiers.validating\n        .get(nameOrIndexOrQualifier)\n        .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid qualifier name.`);\n    }\n\n    if (typeof nameOrIndexOrQualifier === 'number') {\n      return this.qualifiers\n        .getAt(nameOrIndexOrQualifier)\n        .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid qualifier index.`);\n    }\n\n    return SimpleContextQualifierProvider._qualifierNameFromQualifierLike(nameOrIndexOrQualifier)\n      .onSuccess((qualifierName) => this.qualifiers.validating.get(qualifierName))\n      .withErrorFormat((error) => `${nameOrIndexOrQualifier}: invalid Qualifier, name or index.`);\n  }\n\n  /**\n   * Resolves a qualifier name from a name, index, or qualifier object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link QualifierName | qualifier name} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private _resolveQualifierName(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierName> {\n    return this._resolveQualifier(nameOrIndexOrQualifier).onSuccess((qualifier) => succeed(qualifier.name));\n  }\n\n  /**\n   * Resolves a qualifier name from a qualifier-like object.\n   * @param nameOrIndexOrQualifier - The input to resolve.\n   * @returns `Success` with the {@link QualifierName | qualifier name} if successful,\n   * or `Failure` with an error message if not found or invalid.\n   * @internal\n   */\n  private static _qualifierNameFromQualifierLike(\n    nameOrIndexOrQualifier: QualifierName | QualifierIndex | Qualifier\n  ): Result<QualifierName> {\n    return Converters.isA(\n      'Qualifier-like object',\n      (v): v is { name: QualifierName } =>\n        typeof v === 'object' &&\n        v !== null &&\n        'name' in v &&\n        typeof (v as Record<string, unknown>).name === 'string'\n    )\n      .map((v) => CommonConverters.qualifierName.convert(v.name))\n      .convert(nameOrIndexOrQualifier);\n  }\n}\n"]}

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

@@ -14,8 +14,15 @@ export 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>>>;
 }
 /**
  * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a

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

@@ -1 +1 @@
-{"version":3,"file":"validatingSimpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EACL,yCAAyC,EAE1C,MAAM,qCAAqC,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,qDAAqD;IACpE;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,qBAAa,wCAAyC,SAAQ,8BAA8B;IAC1F;;;OAGG;IACH,SAAgB,UAAU,EAAE,yCAAyC,CAAC;IAEtE;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,qDAAqD;IAiBnF;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,qDAAqD,GAC5D,MAAM,CAAC,wCAAwC,CAAC;CAGpD"}
+{"version":3,"file":"validatingSimpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EACL,yCAAyC,EAE1C,MAAM,qCAAqC,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,qDAAqD;IACpE;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,qBAAa,wCAAyC,SAAQ,8BAA8B;IAC1F;;;OAGG;IACH,SAAgB,UAAU,EAAE,yCAAyC,CAAC;IAEtE;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,qDAAqD;IAenF;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,qDAAqD,GAC5D,MAAM,CAAC,wCAAwC,CAAC;CAGpD"}

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

@@ -38,11 +38,9 @@ class ValidatingSimpleContextQualifierProvider extends simpleContextQualifierPro
      * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.
      */
     constructor(params) {
-        // Convert string values to QualifierContextValue for the base class
-        /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */
-        const convertedValues = params.qualifierValues
-            ? Object.fromEntries(Object.entries(params.qualifierValues).map(([key, value]) => [key, value]))
-            : undefined;
+        // The branded QualifierContextValue is structurally a string; widen via cast
+        // and let the base class skip undefined entries on load.
+        const convertedValues = params.qualifierValues;
         super({
             qualifiers: params.qualifiers,
             qualifierValues: convertedValues

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

@@ -1 +1 @@
-{"version":3,"file":"validatingSimpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AAGtD,qFAAkF;AAClF,2FAG6C;AAmB7C;;;;;;GAMG;AACH,MAAa,wCAAyC,SAAQ,+DAA8B;IAO1F;;;OAGG;IACH,YAAsB,MAA6D;QACjF,oEAAoE;QACpE,uFAAuF;QACvF,MAAM,eAAe,GAAsD,MAAM,CAAC,eAAe;YAC/F,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAA8B,CAAC,CAAC,CACpG;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,eAAe;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,4EAAwC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,MAA6D;QAE7D,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,wCAAwC,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC;CACF;AAxCD,4FAwCC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, captureResult } from '@fgv/ts-utils';\nimport { QualifierContextValue } from '../../common';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { SimpleContextQualifierProvider } from './simpleContextQualifierProvider';\nimport {\n  IMutableContextQualifierProviderValidator,\n  MutableContextQualifierProviderValidator\n} from './contextQualifierProviderValidator';\n\n/**\n * Parameters for creating a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider}.\n * @public\n */\nexport interface IValidatingSimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   * Accepts string keys and values which will be converted to strongly-typed values.\n   */\n  qualifierValues?: Record<string, string>;\n}\n\n/**\n * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a\n * {@link Runtime.Context.MutableContextQualifierProviderValidator | validator} property that enables\n * validated use of the underlying provider with string keys and values.\n * This eliminates the need for type casting in consumer code.\n * @public\n */\nexport class ValidatingSimpleContextQualifierProvider extends SimpleContextQualifierProvider {\n  /**\n   * A {@link Runtime.Context.MutableContextQualifierProviderValidator | MutableContextQualifierProviderValidator} which validates\n   * string inputs before passing them to this provider.\n   */\n  public readonly validating: IMutableContextQualifierProviderValidator;\n\n  /**\n   * Constructor for a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: IValidatingSimpleContextQualifierProviderCreateParams) {\n    // Convert string values to QualifierContextValue for the base class\n    /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */\n    const convertedValues: Record<string, QualifierContextValue> | undefined = params.qualifierValues\n      ? Object.fromEntries(\n          Object.entries(params.qualifierValues).map(([key, value]) => [key, value as QualifierContextValue])\n        )\n      : undefined;\n\n    super({\n      qualifiers: params.qualifiers,\n      qualifierValues: convertedValues\n    });\n\n    this.validating = new MutableContextQualifierProviderValidator({ provider: this });\n  }\n\n  /**\n   * Creates a new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: IValidatingSimpleContextQualifierProviderCreateParams\n  ): Result<ValidatingSimpleContextQualifierProvider> {\n    return captureResult(() => new ValidatingSimpleContextQualifierProvider(params));\n  }\n}\n"]}
+{"version":3,"file":"validatingSimpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AAGtD,qFAAkF;AAClF,2FAG6C;AA0B7C;;;;;;GAMG;AACH,MAAa,wCAAyC,SAAQ,+DAA8B;IAO1F;;;OAGG;IACH,YAAsB,MAA6D;QACjF,6EAA6E;QAC7E,yDAAyD;QACzD,MAAM,eAAe,GAAG,MAAM,CAAC,eAElB,CAAC;QAEd,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,eAAe;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,4EAAwC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,MAA6D;QAE7D,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,wCAAwC,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC;CACF;AAtCD,4FAsCC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, captureResult } from '@fgv/ts-utils';\nimport { QualifierContextValue } from '../../common';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { SimpleContextQualifierProvider } from './simpleContextQualifierProvider';\nimport {\n  IMutableContextQualifierProviderValidator,\n  MutableContextQualifierProviderValidator\n} from './contextQualifierProviderValidator';\n\n/**\n * Parameters for creating a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider}.\n * @public\n */\nexport interface IValidatingSimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   * Accepts string keys and values which will be converted to strongly-typed values.\n   *\n   * @remarks\n   * Typed as `Readonly<Partial<Record<string, string>>>` so callers can\n   * naturally express conditional context construction, e.g.\n   * `tone === 'formal' ? { tone: 'formal' } : {}`. Entries whose value is\n   * `undefined` are skipped on load - semantically equivalent to omitting\n   * the key.\n   */\n  qualifierValues?: Readonly<Partial<Record<string, string>>>;\n}\n\n/**\n * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a\n * {@link Runtime.Context.MutableContextQualifierProviderValidator | validator} property that enables\n * validated use of the underlying provider with string keys and values.\n * This eliminates the need for type casting in consumer code.\n * @public\n */\nexport class ValidatingSimpleContextQualifierProvider extends SimpleContextQualifierProvider {\n  /**\n   * A {@link Runtime.Context.MutableContextQualifierProviderValidator | MutableContextQualifierProviderValidator} which validates\n   * string inputs before passing them to this provider.\n   */\n  public readonly validating: IMutableContextQualifierProviderValidator;\n\n  /**\n   * Constructor for a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: IValidatingSimpleContextQualifierProviderCreateParams) {\n    // The branded QualifierContextValue is structurally a string; widen via cast\n    // and let the base class skip undefined entries on load.\n    const convertedValues = params.qualifierValues as\n      | Readonly<Partial<Record<string, QualifierContextValue>>>\n      | undefined;\n\n    super({\n      qualifiers: params.qualifiers,\n      qualifierValues: convertedValues\n    });\n\n    this.validating = new MutableContextQualifierProviderValidator({ provider: this });\n  }\n\n  /**\n   * Creates a new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: IValidatingSimpleContextQualifierProviderCreateParams\n  ): Result<ValidatingSimpleContextQualifierProvider> {\n    return captureResult(() => new ValidatingSimpleContextQualifierProvider(params));\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fgv/ts-res",
-  "version": "5.1.0-28",
+  "version": "5.1.0-29",
   "description": "Multi-dimensional Resource Runtime",
   "main": "lib/index.js",
   "types": "dist/ts-res.d.ts",
@@ -45,18 +45,18 @@
     "@types/heft-jest": "1.0.6",
     "eslint-plugin-tsdoc": "~0.5.2",
     "typedoc": "~0.28.16",
-    "@fgv/heft-dual-rig": "5.1.0-28",
-    "@fgv/typedoc-compact-theme": "5.1.0-28",
-    "@fgv/ts-utils-jest": "5.1.0-28",
-    "@fgv/ts-extras": "5.1.0-28"
+    "@fgv/heft-dual-rig": "5.1.0-29",
+    "@fgv/typedoc-compact-theme": "5.1.0-29",
+    "@fgv/ts-utils-jest": "5.1.0-29",
+    "@fgv/ts-extras": "5.1.0-29"
   },
   "dependencies": {
     "luxon": "^3.7.2",
     "fflate": "~0.8.2",
-    "@fgv/ts-utils": "5.1.0-28",
-    "@fgv/ts-json-base": "5.1.0-28",
-    "@fgv/ts-bcp47": "5.1.0-28",
-    "@fgv/ts-json": "5.1.0-28"
+    "@fgv/ts-utils": "5.1.0-29",
+    "@fgv/ts-json-base": "5.1.0-29",
+    "@fgv/ts-bcp47": "5.1.0-29",
+    "@fgv/ts-json": "5.1.0-29"
   },
   "exports": {
     ".": {