@fgv/ts-res 5.1.0-2 → 5.1.0-21

package/dist/packlets/import/importers/fsItemImporter.js

@@ -19,7 +19,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-import { captureResult, failWithDetail, succeed, succeedWithDetail, MessageAggregator } from '@fgv/ts-utils';
+import { captureResult, failWithDetail, MessageAggregator, succeed, succeedWithDetail } from '@fgv/ts-utils';
 import { Converters as JsonConverters } from '@fgv/ts-json-base';
 import { FsItem } from '../fsItem';
 /**
@@ -37,6 +37,8 @@ export class FsItemImporter {
          */
         this.types = ['fsItem'];
         this.qualifiers = params.qualifiers;
+        this.fileContentConverter = params.fileContentConverter;
+        this.fileContentExtensions = params.fileContentExtensions;
     }
     /**
      * Creates a new {@link Import.Importers.FsItemImporter | FsItemImporter}.
@@ -47,7 +49,7 @@ export class FsItemImporter {
         return captureResult(() => new FsItemImporter(params));
     }
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item, __manager) {
         const { value: fsItem, message: getTreeMessage, detail: getTreeDetail } = this._getFileTreeItemFromImportable(item);
@@ -81,23 +83,37 @@ export class FsItemImporter {
                 .withDetail('failed', 'processed');
         }
         else if (fsItem.item.type === 'file') {
-            if (fsItem.item.extension === '.json') {
-                return fsItem.item
-                    .getContents(JsonConverters.jsonValue)
-                    .onSuccess((json) => {
-                    const jsonItem = {
-                        type: 'json',
-                        json,
-                        context
-                    };
-                    return succeed([jsonItem]);
-                })
-                    .withDetail('failed', 'processed');
+            if (!this._isSupportedFileExtension(fsItem.item.extension)) {
+                return succeedWithDetail([], 'skipped');
             }
+            return this._getJsonContents(fsItem.item)
+                .onSuccess((json) => {
+                const jsonItem = {
+                    type: 'json',
+                    json,
+                    context
+                };
+                return succeed([jsonItem]);
+            })
+                .withDetail('failed', 'processed');
         }
         /* c8 ignore next 2 - defensive coding: fallback case for unsupported file types */
         return succeedWithDetail([], 'skipped');
     }
+    _isSupportedFileExtension(extension) {
+        return extension === '.json' || this._canConvertFileExtension(extension);
+    }
+    _getJsonContents(file) {
+        const converter = this.fileContentConverter;
+        if (converter !== undefined) {
+            return file.getRawContents().onSuccess((contents) => converter.convert(contents));
+        }
+        return file.getContents(JsonConverters.jsonValue);
+    }
+    _canConvertFileExtension(extension) {
+        var _a;
+        return (this.fileContentConverter !== undefined && ((_a = this.fileContentExtensions) === null || _a === void 0 ? void 0 : _a.includes(extension)) === true);
+    }
     /**
      * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.
      * @param item - The importable to convert.

package/dist/packlets/import/importers/fsItemImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsItemImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/fsItemImporter.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 {\n  captureResult,\n  DetailedResult,\n  failWithDetail,\n  MessageAggregator,\n  Result,\n  succeed,\n  succeedWithDetail,\n  Converter\n} from '@fgv/ts-utils';\nimport { Converters as JsonConverters, FileTree, JsonValue } from '@fgv/ts-json-base';\nimport { ResourceManagerBuilder } from '../../resources';\nimport { IImportable, IImportableJson, Importable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { FsItem, FsItemResultDetail } from '../fsItem';\n\n/**\n * Parameters for creating a {@link Import.Importers.FsItemImporter | FsItemImporter}.\n * @public\n */\nexport interface IFsItemImporterCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  fileContentConverter?: Converter<JsonValue>;\n  fileContentExtensions?: ReadonlyArray<string>;\n}\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`.\n * @public\n */\nexport class FsItemImporter implements IImporter {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional converter used to parse raw file contents before they are exposed as JSON importables.\n   */\n  public readonly fileContentConverter?: Converter<JsonValue>;\n\n  /**\n   * Optional list of file extensions which should be parsed using the file content converter.\n   */\n  public readonly fileContentExtensions?: ReadonlyArray<string>;\n\n  /**\n   * The types of {@link Import.IImportable | importables} that this importer can handle.\n   */\n  public readonly types: ReadonlyArray<string> = ['fsItem'];\n\n  /**\n   * Protected constructor for the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   */\n  protected constructor(params: IFsItemImporterCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.fileContentConverter = params.fileContentConverter;\n    this.fileContentExtensions = params.fileContentExtensions;\n  }\n\n  /**\n   * Creates a new {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.FsItemImporter | FsItemImporter}.\n   * @returns `Success` with the new `FsItemImporter` if successful, `Failure` with an error message if not.\n   */\n  public static create(params: IFsItemImporterCreateParams): Result<FsItemImporter> {\n    return captureResult(() => new FsItemImporter(params));\n  }\n\n  /**\n   * {@inheritDoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    __manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    const {\n      value: fsItem,\n      message: getTreeMessage,\n      detail: getTreeDetail\n    } = this._getFileTreeItemFromImportable(item);\n    if (getTreeMessage !== undefined) {\n      return failWithDetail(getTreeMessage, getTreeDetail === 'skipped' ? 'skipped' : 'failed');\n    }\n\n    const { value: context, message: getContextMessage } = fsItem.getContext().onSuccess((fsItemContext) => {\n      return item.context ? item.context.extend(fsItemContext) : succeed(fsItemContext);\n    });\n\n    /* c8 ignore next 3 - defensive coding: getContext failure is extremely rare in practice */\n    if (getContextMessage) {\n      return failWithDetail(getContextMessage, 'failed');\n    }\n\n    if (fsItem.item.type === 'directory') {\n      return fsItem.item\n        .getChildren()\n        .onSuccess((children) => {\n          const errors = new MessageAggregator();\n          const items: Importable[] = [];\n          for (const child of children) {\n            const { value: item, message, detail } = FsItem.createForItem(child, this.qualifiers);\n            if (item) {\n              items.push({ type: 'fsItem', item, context });\n            } else if (detail !== 'skipped') {\n              errors.addMessage(message);\n            }\n          }\n          return errors.returnOrReport(succeed(items));\n        })\n        .withDetail('failed', 'processed');\n    } else if (fsItem.item.type === 'file') {\n      if (!this._isSupportedFileExtension(fsItem.item.extension)) {\n        return succeedWithDetail([], 'skipped');\n      }\n\n      return this._getJsonContents(fsItem.item)\n        .onSuccess((json) => {\n          const jsonItem: IImportableJson = {\n            type: 'json',\n            json,\n            context\n          };\n          return succeed([jsonItem]);\n        })\n        .withDetail('failed', 'processed');\n    }\n    /* c8 ignore next 2 - defensive coding: fallback case for unsupported file types */\n    return succeedWithDetail([], 'skipped');\n  }\n\n  private _isSupportedFileExtension(extension: string): boolean {\n    return extension === '.json' || this._canConvertFileExtension(extension);\n  }\n\n  private _getJsonContents(file: FileTree.IFileTreeFileItem): Result<JsonValue> {\n    const converter = this.fileContentConverter;\n    if (converter !== undefined) {\n      return file.getRawContents().onSuccess((contents) => converter.convert(contents));\n    }\n\n    return file.getContents(JsonConverters.jsonValue);\n  }\n\n  private _canConvertFileExtension(extension: string): boolean {\n    return (\n      this.fileContentConverter !== undefined && this.fileContentExtensions?.includes(extension) === true\n    );\n  }\n\n  /**\n   * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.\n   * @param item - The importable to convert.\n   * @returns `Success` containing the `FsItem` if successful, `Failure` with an error message if not.\n   */\n  protected _getFileTreeItemFromImportable(item: IImportable): DetailedResult<FsItem, FsItemResultDetail> {\n    if (item.type === 'fsItem') {\n      if ('item' in item && item.item instanceof FsItem) {\n        return succeedWithDetail(item.item, 'succeeded');\n      }\n      return failWithDetail(`malformed fsItem importable does not contain a valid item`, 'failed');\n    }\n    return failWithDetail(`${item.type}: invalid importable type for an FsItemImporter`, 'skipped');\n  }\n}\n"]}

package/dist/packlets/import/importers/importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/importer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { DetailedResult } from '@fgv/ts-utils';\nimport { IImportable } from '../importable';\nimport { ResourceManagerBuilder } from '../../resources';\n\n/**\n * Possible results of an import operation.\n * @public\n */\nexport type ImporterResultDetail = 'consumed' | 'processed' | 'skipped' | 'failed';\n\n/**\n * Generic interface for an importer than accepts a typed\n * {@link Import.IImportable | importable} item, extracts any resources\n * or candidates from it, and returns an optional list of\n * additional importable items derived from the original.\n * @public\n */\nexport interface IImporter {\n  /**\n   * The types of {@link Import.Importable | importable} items that this importer can process.\n   */\n  readonly types: ReadonlyArray<string>;\n\n  /**\n   * Imports an item, extracting any resources or candidates from it and returns an optional\n   * list of additional importable items derived from it.\n   * @param item - The {@link Import.IImportable | importable} item to import.\n   * @param manager - The {@link Resources.ResourceManagerBuilder | resource manager builder} to use for the import.\n   * @returns `Success` with a list of additional importable items derived from the original, or\n   * `Failure` with an error message and a {@link Import.Importers.ImporterResultDetail | result detail}.\n   */\n  import(\n    item: IImportable,\n    manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail>;\n}\n"]}

package/dist/packlets/import/importers/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,oEAAoE;AAEpE,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAE/B,yBAAyB;AACzB,gDAAgD;AAChD,oEAAoE","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n// Browser-safe importers - excludes Node.js filesystem dependencies\n\nexport * from './importer';\nexport * from './collectionImporter';\nexport * from './jsonImporter';\n\n// Excluded from browser:\n// - fsItemImporter (processes filesystem items)\n// - pathImporter (requires Node.js fs via FileTree.forFilesystem())\n"]}

package/dist/packlets/import/importers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,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\nexport * from './importer';\nexport * from './collectionImporter';\nexport * from './fsItemImporter';\nexport * from './jsonImporter';\nexport * from './pathImporter';\n"]}

package/dist/packlets/import/importers/jsonImporter.js

@@ -32,7 +32,7 @@ export class JsonImporter {
      */
     constructor() {
         /**
-         * {@inheritdoc Import.Importers.IImporter.types}
+         * {@inheritDoc Import.Importers.IImporter.types}
          */
         this.types = ['json'];
     }
@@ -45,7 +45,7 @@ export class JsonImporter {
         return captureResult(() => new JsonImporter());
     }
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item, manager) {
         var _a, _b;

package/dist/packlets/import/importers/jsonImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/jsonImporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAkB,cAAc,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAG/F,OAAO,EAA4C,YAAY,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,MAAM,OAAO,YAAY;IAMvB;;OAEG;IACH;QARA;;WAEG;QACa,UAAK,GAA0B,CAAC,MAAM,CAAC,CAAC;IAK/B,CAAC;IAE1B;;;;OAIG;IACI,MAAM,CAAC,MAAM;QAClB,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,OAA+B;;QAE/B,qEAAqE;QACrE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChD,uFAAuF;YACvF,MAAM,IAAI,GAAG,MAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,mCAAI,SAAS,CAAC;YAC/C,OAAO,cAAc,CAAC,GAAG,IAAI,8BAA8B,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CACL,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC;aACpC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACnD,mEAAmE;YACnE,mEAAmE;YACnE,qEAAqE;YACrE,uEAAuE;YACvE,2DAA2D;aAC1D,SAAS,CAAC,GAAG,EAAE;QACd,yCAAyC;QACzC,OAAA,cAAc,CAAC,GAAG,MAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,MAAM,mCAAI,SAAS,6BAA6B,EAAE,QAAQ,CAAC,CAAA,EAAA,CAC5F,CACJ,CAAC;IACJ,CAAC;IAEO,4BAA4B,CAClC,IAAqB;QAErB,OAAO,YAAY,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACzD,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACxB,MAAM,UAAU,GAAe;gBAC7B,IAAI,EAAE,oBAAoB;gBAC1B,UAAU;gBACV,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YACF,OAAO,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;aACD,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAEO,sBAAsB,CAAC,IAAqB;QAClD,OAAO,YAAY,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACnD,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,UAAU,GAAe;gBAC7B,IAAI,EAAE,cAAc;gBACpB,IAAI;gBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YACF,OAAO,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;aACD,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;CA0BF","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, DetailedResult, failWithDetail, Result, succeed } from '@fgv/ts-utils';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { ResourceManagerBuilder } from '../../resources';\nimport { IImportable, IImportableJson, Importable, isImportable } from '../importable';\nimport * as ResourceJson from '../../resource-json';\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a JSON object.\n * @public\n */\nexport class JsonImporter implements IImporter {\n  /**\n   * {@inheritDoc Import.Importers.IImporter.types}\n   */\n  public readonly types: ReadonlyArray<string> = ['json'];\n\n  /**\n   * Protected {@link Import.Importers.JsonImporter | JsonImporter} constructor for derived classes.\n   */\n  protected constructor() {}\n\n  /**\n   * Creates a new {@link Import.Importers.JsonImporter | JsonImporter} instance.\n   * @returns `Success` with the new {@link Import.Importers.JsonImporter | JsonImporter} if successful,\n   * `Failure` otherwise.\n   */\n  public static create(): Result<JsonImporter> {\n    return captureResult(() => new JsonImporter());\n  }\n\n  /**\n   * {@inheritDoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    /* c8 ignore next 1 - coverage intermittently misses the next line */\n    if (!isImportable(item) || item.type !== 'json') {\n      /* c8 ignore next 3 - functional code path tested but coverage intermittently missed */\n      const name = item.context?.baseId ?? 'unknown';\n      return failWithDetail(`${name}: invalid JSON importable (${item.type})`, 'skipped');\n    }\n    return (\n      this._tryImportResourceCollection(item)\n        .onFailure(() => this._tryImportResourceTree(item))\n        // experimenting with this, accepting any JSON object here makes it\n        // very hard to distinguish a collection or tree with a typo from a\n        // legitimate single loose resource, which yields extremely confusing\n        // error messages. Disabled until/unless we come up with a better plan.\n        //.onFailure(() => this._tryImportResource(item, manager));\n        .onFailure(() =>\n          /* c8 ignore next 1 - defense in depth */\n          failWithDetail(`${item.context?.baseId ?? 'unknown'}: unrecognized JSON format.`, 'failed')\n        )\n    );\n  }\n\n  private _tryImportResourceCollection(\n    item: IImportableJson\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    return ResourceJson.ResourceDeclCollection.create(item.json)\n      .onSuccess((collection) => {\n        const importable: Importable = {\n          type: 'resourceCollection',\n          collection,\n          context: item.context\n        };\n        return succeed([importable]);\n      })\n      .withDetail('skipped', 'consumed');\n  }\n\n  private _tryImportResourceTree(item: IImportableJson): DetailedResult<IImportable[], ImporterResultDetail> {\n    return ResourceJson.ResourceDeclTree.create(item.json)\n      .onSuccess((tree) => {\n        const importable: Importable = {\n          type: 'resourceTree',\n          tree,\n          context: item.context\n        };\n        return succeed([importable]);\n      })\n      .withDetail('skipped', 'consumed');\n  }\n\n  /* \n   * This is disabled for now because it's too easy to accidentally import\n   * a single loose resource as a collection or tree, which yields extremely\n   * confusing error messages.\n\n  private _tryImportResource(\n    item: IImportableJson,\n    manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    return JsonConverters.jsonObject\n      .convert(item.json)\n      .onSuccess((json) => {\n        // c8 ignore next 2 - defense in depth\n        const id = item.context?.baseId ?? '';\n        const conditions = item.context?.conditions;\n        const candidate: ResourceJson.Json.ILooseResourceCandidateDecl = { id, conditions, json };\n        return manager.addLooseCandidate(candidate);\n      })\n      .onSuccess(() => {\n        return succeed([]);\n      })\n      .withDetail('failed', 'consumed');\n  }\n  */\n}\n"]}

package/dist/packlets/import/importers/pathImporter.js

@@ -51,7 +51,7 @@ export class PathImporter {
         return captureResult(() => new PathImporter(params));
     }
     /**
-     * {@inheritdoc Import.Importers.IImporter.import}
+     * {@inheritDoc Import.Importers.IImporter.import}
      */
     import(item, __manager) {
         const { value: fsItem, message: getTreeMessage, detail: getTreeDetail } = this._getFileTreeItemFromImportable(item);

package/dist/packlets/import/importers/pathImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathImporter.js","sourceRoot":"","sources":["../../../../src/packlets/import/importers/pathImporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAkB,cAAc,EAAU,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK7C,OAAO,EAAE,MAAM,EAAsB,MAAM,WAAW,CAAC;AAYvD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAsBvB;;;OAGG;IACH,YAAsB,MAAiC;;QAfvD;;WAEG;QACa,UAAK,GAA0B,CAAC,MAAM,CAAC,CAAC;QAatD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,MAAA,MAAM,CAAC,IAAI,mCAAI,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,CAAC,eAAe,GAAG,MAAA,MAAM,CAAC,eAAe,mCAAI,EAAE,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,MAAiC;QACpD,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,SAAiC;QAEjC,MAAM,EACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACtB,GAAG,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,cAAc,CAAC,cAAc,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACxF,OAAO,iBAAiB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;QAED,8EAA8E;QAC9E,mCAAmC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAE7B,OAAO,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IACrF,CAAC;IAED;;;;OAIG;IACO,8BAA8B,CAAC,IAAiB;QACxD,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpD,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,cAAc,CAAC,0DAA0D,EAAE,QAAQ,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,cAAc,CAAC,GAAG,IAAI,CAAC,IAAI,8CAA8C,EAAE,SAAS,CAAC,CAAC;IAC/F,CAAC;CACF","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { captureResult, DetailedResult, failWithDetail, Result, succeedWithDetail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport { ResourceManagerBuilder } from '../../resources';\nimport { IImportable } from '../importable';\nimport { IImporter, ImporterResultDetail } from './importer';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { FsItem, FsItemResultDetail } from '../fsItem';\n\n/**\n * Parameters for creating a {@link Import.Importers.PathImporter | PathImporter}.\n * @public\n */\nexport interface IPathImporterCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  tree?: FileTree.FileTree;\n  ignoreFileTypes?: string[];\n}\n\n/**\n * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`\n * given a path.\n * @public\n */\nexport class PathImporter implements IImporter {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The `FileTree` from which resources will be imported.\n   */\n  public readonly tree: FileTree.FileTree;\n\n  /**\n   * The types of {@link Import.IImportable | importables} that this importer can handle.\n   */\n  public readonly types: ReadonlyArray<string> = ['path'];\n\n  /**\n   * The types of files to ignore when importing.  Any file not ignored is converted\n   * to an {@link Import.IImportableFsItem | IImportableFsItem}.\n   */\n  public readonly ignoreFileTypes: string[];\n\n  /**\n   * Protected constructor for the {@link Import.Importers.PathImporter | PathImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.PathImporter | PathImporter}.\n   */\n  protected constructor(params: IPathImporterCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.tree = params.tree ?? FileTree.forFilesystem().orThrow();\n    this.ignoreFileTypes = params.ignoreFileTypes ?? [];\n  }\n\n  /**\n   * Creates a new {@link Import.Importers.PathImporter | PathImporter}.\n   * @param params - Parameters for creating the {@link Import.Importers.PathImporter | dirPathImporter}.\n   * @returns `Success` with the new `PathImporter` if successful, `Failure` with an error message if not.\n   */\n  public static create(params: IPathImporterCreateParams): Result<PathImporter> {\n    return captureResult(() => new PathImporter(params));\n  }\n\n  /**\n   * {@inheritDoc Import.Importers.IImporter.import}\n   */\n  public import(\n    item: IImportable,\n    __manager: ResourceManagerBuilder\n  ): DetailedResult<IImportable[], ImporterResultDetail> {\n    const {\n      value: fsItem,\n      message: getTreeMessage,\n      detail: getTreeDetail\n    } = this._getFileTreeItemFromImportable(item);\n    if (getTreeMessage !== undefined) {\n      return failWithDetail(getTreeMessage, getTreeDetail === 'skipped' ? 'skipped' : 'failed');\n    }\n\n    if (fsItem.item.type === 'file' && this.ignoreFileTypes.includes(fsItem.item.extension)) {\n      return succeedWithDetail([], 'processed');\n    }\n\n    // extracted characteristics are in the fsItem so add them to the context when\n    // that is imported instead of now.\n    const context = item.context;\n\n    return succeedWithDetail([{ type: 'fsItem', item: fsItem, context }], 'processed');\n  }\n\n  /**\n   * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.\n   * @param item - The importable to convert.\n   * @returns `Success` containing the `FsItem` if successful, `Failure` with an error message if not.\n   */\n  protected _getFileTreeItemFromImportable(item: IImportable): DetailedResult<FsItem, FsItemResultDetail> {\n    if (item.type === 'path') {\n      if ('path' in item && typeof item.path === 'string') {\n        return FsItem.createForPath(item.path, this.qualifiers, this.tree);\n      }\n      return failWithDetail(`malformed path importable does not contain a string path`, 'failed');\n    }\n    return failWithDetail(`${item.type}: invalid importable type for a PathImporter`, 'skipped');\n  }\n}\n"]}

package/dist/packlets/import/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../../src/packlets/import/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,yEAAyE;AAEzE,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAEhC,kEAAkE;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,mCAAmC;AACnC,OAAO,KAAK,SAAS,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,yBAAyB;AACzB,4FAA4F;AAC5F,qEAAqE","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n// Browser-safe import exports - excludes Node.js filesystem dependencies\n\nexport * from './importContext';\nexport * from './importable';\nexport * from './importManager';\n\n// Export FsItem class (browser-safe for in-memory FileTree usage)\nexport { FsItem } from './fsItem';\n\n// Use browser-safe importers index\nimport * as Importers from './importers/index.browser';\nexport { Importers };\n\n// Excluded from browser:\n// - FsItem.createForPath() static method (requires Node.js fs via FileTree.forFilesystem())\n// - PathImporter and FsItemImporter (via importers/index.browser.ts)\n"]}

package/dist/packlets/import/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAEhC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,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\nexport * from './importContext';\nexport * from './importable';\nexport * from './fsItem';\nexport * from './importManager';\n\nimport * as Importers from './importers';\nexport { Importers };\n"]}

package/dist/packlets/qualifier-types/config/convert.js

@@ -0,0 +1,124 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/* eslint-disable @rushstack/typedef-var */
+import { Converters } from '@fgv/ts-utils';
+import * as Common from '../../common';
+import { Converters as JsonConverters } from '@fgv/ts-json-base';
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ILanguageQualifierTypeConfig | LanguageQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ILanguageQualifierTypeConfig | LanguageQualifierTypeConfig} objects.
+ * @public
+ */
+export const languageQualifierTypeConfig = Converters.strictObject({
+    allowContextList: Converters.boolean.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.
+ * @public
+ */
+export const territoryQualifierTypeConfig = Converters.strictObject({
+    allowContextList: Converters.boolean,
+    acceptLowercase: Converters.boolean.optional(),
+    allowedTerritories: Converters.arrayOf(Converters.string).optional(),
+    hierarchy: Converters.recordOf(Converters.string).optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.
+ * @public
+ */
+export const literalQualifierTypeConfig = Converters.strictObject({
+    allowContextList: Converters.boolean.optional(),
+    caseSensitive: Converters.boolean.optional(),
+    enumeratedValues: Converters.arrayOf(Converters.string).optional(),
+    hierarchy: Converters.recordOf(Converters.string).optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.
+ * @public
+ */
+export const systemLanguageQualifierTypeConfig = Converters.strictObject({
+    name: Converters.string,
+    systemType: Converters.literal('language'),
+    configuration: languageQualifierTypeConfig.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.
+ * @public
+ */
+export const systemTerritoryQualifierTypeConfig = Converters.strictObject({
+    name: Converters.string,
+    systemType: Converters.literal('territory'),
+    configuration: territoryQualifierTypeConfig.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.
+ * @public
+ */
+export const systemLiteralQualifierTypeConfig = Converters.strictObject({
+    name: Converters.string,
+    systemType: Converters.literal('literal'),
+    configuration: literalQualifierTypeConfig.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.
+ * @public
+ */
+export const systemQualifierTypeConfig = Converters.discriminatedObject('systemType', {
+    language: systemLanguageQualifierTypeConfig,
+    territory: systemTerritoryQualifierTypeConfig,
+    literal: systemLiteralQualifierTypeConfig
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.
+ * @param config - A `Converter` for the configuration object.
+ * @public
+ */
+export function qualifierTypeConfig(config) {
+    return Converters.strictObject({
+        name: Common.Convert.qualifierTypeName,
+        systemType: Common.Convert.qualifierTypeName,
+        configuration: config.optional()
+    });
+}
+/**
+ * A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.
+ * @public
+ */
+export const jsonQualifierTypeConfig = qualifierTypeConfig(JsonConverters.jsonObject);
+/**
+ * A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.
+ * @public
+ */
+export const anyQualifierTypeConfig = Converters.oneOf([
+    jsonQualifierTypeConfig,
+    systemQualifierTypeConfig
+]);
+//# sourceMappingURL=convert.js.map

package/dist/packlets/qualifier-types/config/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../../src/packlets/qualifier-types/config/convert.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\n/* eslint-disable @rushstack/typedef-var */\n\nimport { Converter, Converters } from '@fgv/ts-utils';\nimport * as Model from './json';\nimport * as Common from '../../common';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ILanguageQualifierTypeConfig | LanguageQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ILanguageQualifierTypeConfig | LanguageQualifierTypeConfig} objects.\n * @public\n */\nexport const languageQualifierTypeConfig = Converters.strictObject<Model.ILanguageQualifierTypeConfig>({\n  allowContextList: Converters.boolean.optional()\n});\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.\n * @public\n */\nexport const territoryQualifierTypeConfig = Converters.strictObject<Model.ITerritoryQualifierTypeConfig>({\n  allowContextList: Converters.boolean,\n  acceptLowercase: Converters.boolean.optional(),\n  allowedTerritories: Converters.arrayOf(Converters.string).optional(),\n  hierarchy: Converters.recordOf(Converters.string).optional()\n});\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.\n * @public\n */\nexport const literalQualifierTypeConfig = Converters.strictObject<Model.ILiteralQualifierTypeConfig>({\n  allowContextList: Converters.boolean.optional(),\n  caseSensitive: Converters.boolean.optional(),\n  enumeratedValues: Converters.arrayOf(Converters.string).optional(),\n  hierarchy: Converters.recordOf(Converters.string).optional()\n});\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.\n * @public\n */\nexport const systemLanguageQualifierTypeConfig =\n  Converters.strictObject<Model.ISystemLanguageQualifierTypeConfig>({\n    name: Converters.string,\n    systemType: Converters.literal('language'),\n    configuration: languageQualifierTypeConfig.optional()\n  });\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.\n * @public\n */\nexport const systemTerritoryQualifierTypeConfig =\n  Converters.strictObject<Model.ISystemTerritoryQualifierTypeConfig>({\n    name: Converters.string,\n    systemType: Converters.literal('territory'),\n    configuration: territoryQualifierTypeConfig.optional()\n  });\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.\n * @public\n */\nexport const systemLiteralQualifierTypeConfig =\n  Converters.strictObject<Model.ISystemLiteralQualifierTypeConfig>({\n    name: Converters.string,\n    systemType: Converters.literal('literal'),\n    configuration: literalQualifierTypeConfig.optional()\n  });\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.\n * @public\n */\nexport const systemQualifierTypeConfig = Converters.discriminatedObject<Model.ISystemQualifierTypeConfig>(\n  'systemType',\n  {\n    language: systemLanguageQualifierTypeConfig,\n    territory: systemTerritoryQualifierTypeConfig,\n    literal: systemLiteralQualifierTypeConfig\n  }\n);\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.\n * @param config - A `Converter` for the configuration object.\n * @public\n */\nexport function qualifierTypeConfig<T, TD = unknown>(\n  config: Converter<T, TD>\n): Converter<Model.IQualifierTypeConfig<T>, TD> {\n  return Converters.strictObject<Model.IQualifierTypeConfig<T>, TD>({\n    name: Common.Convert.qualifierTypeName,\n    systemType: Common.Convert.qualifierTypeName,\n    configuration: config.optional()\n  });\n}\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.\n * @public\n */\nexport const jsonQualifierTypeConfig = qualifierTypeConfig(JsonConverters.jsonObject);\n\n/**\n * A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.\n * @returns A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.\n * @public\n */\nexport const anyQualifierTypeConfig = Converters.oneOf<Model.IAnyQualifierTypeConfig>([\n  jsonQualifierTypeConfig,\n  systemQualifierTypeConfig\n]);\n"]}

package/dist/packlets/qualifier-types/config/index.js

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

package/dist/packlets/qualifier-types/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/qualifier-types/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,cAAc,QAAQ,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,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 * as Convert from './convert';\n\nexport * from './json';\n\nexport { Convert };\n"]}

package/dist/packlets/qualifier-types/config/json.js

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+/**
+ * Checks if a {@link QualifierTypes.Config.IAnyQualifierTypeConfig | qualifier type configuration} is a
+ * {@link QualifierTypes.Config.ISystemQualifierTypeConfig | system qualifier type configuration}.
+ * @param config - The {@link QualifierTypes.Config.IAnyQualifierTypeConfig | qualifier type configuration} to check.
+ * @returns `true` if the configuration is a system qualifier type configuration, `false` otherwise.
+ * @public
+ */
+export function isSystemQualifierTypeConfig(config) {
+    return (config.systemType === 'language' || config.systemType === 'territory' || config.systemType === 'literal');
+}
+//# sourceMappingURL=json.js.map

package/dist/packlets/qualifier-types/config/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../src/packlets/qualifier-types/config/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAsGH;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAA+B;IAE/B,OAAO,CACL,MAAM,CAAC,UAAU,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CACzG,CAAC;AACJ,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';\n\n/**\n * Templated configuration for {@link QualifierTypes.QualifierType | qualifier type} configuration.\n * @public\n */\nexport interface IQualifierTypeConfig<T = JsonObject> {\n  name: string;\n  systemType: string;\n  configuration?: T;\n}\n\n/**\n * Configuration for {@link QualifierTypes.LanguageQualifierType | language qualifier type} configuration.\n * @public\n */\nexport interface ILanguageQualifierTypeConfig {\n  allowContextList?: boolean;\n}\n\n/**\n * Declares a hierarchy of literal values. The keys are the names of the values, and the\n * values are the names of their parents.\n * @remarks\n * The hierarchy is defined as a tree, where each value can have multiple children but\n * only one parent. The root of the tree has no parent. The hierarchy is used to\n * determine the relationship between values when matching conditions and contexts.\n * @public\n */\nexport type LiteralValueHierarchyDecl<T extends string> = Record<T, T>;\n\n/**\n * Configuration for {@link QualifierTypes.TerritoryQualifierType | territory qualifier type} configuration.\n * @public\n */\nexport interface ITerritoryQualifierTypeConfig {\n  allowContextList?: boolean;\n\n  acceptLowercase?: boolean;\n  allowedTerritories?: string[];\n\n  /**\n   * Optional {@link QualifierTypes.Config.LiteralValueHierarchyDecl | hierarchy declaration}\n   * of territory values to use for matching. If not provided, no hierarchy will be used.\n   */\n  hierarchy?: LiteralValueHierarchyDecl<string>;\n}\n\n/**\n * Configuration for {@link QualifierTypes.LiteralQualifierType | literal qualifier type} configuration.\n * @public\n */\nexport interface ILiteralQualifierTypeConfig {\n  allowContextList?: boolean;\n  caseSensitive?: boolean;\n  enumeratedValues?: string[];\n  hierarchy?: LiteralValueHierarchyDecl<string>;\n}\n\n/**\n * Discriminated configuration for {@link QualifierTypes.LanguageQualifierType | language qualifier type} configuration.\n * @public\n */\nexport interface ISystemLanguageQualifierTypeConfig\n  extends IQualifierTypeConfig<ILanguageQualifierTypeConfig> {\n  systemType: 'language';\n}\n\n/**\n * Discriminated configuration for {@link QualifierTypes.TerritoryQualifierType | territory qualifier type} configuration.\n * @public\n */\nexport interface ISystemTerritoryQualifierTypeConfig\n  extends IQualifierTypeConfig<ITerritoryQualifierTypeConfig> {\n  systemType: 'territory';\n}\n\n/**\n * Discriminated configuration for {@link QualifierTypes.LiteralQualifierType | literal qualifier type} configuration.\n * @public\n */\nexport interface ISystemLiteralQualifierTypeConfig extends IQualifierTypeConfig<ILiteralQualifierTypeConfig> {\n  systemType: 'literal';\n}\n\n/**\n * Discriminated configuration for {@link QualifierTypes.QualifierType | qualifier type} configuration.\n * @public\n */\nexport type ISystemQualifierTypeConfig =\n  | ISystemLanguageQualifierTypeConfig\n  | ISystemTerritoryQualifierTypeConfig\n  | ISystemLiteralQualifierTypeConfig;\n\n/**\n * A union of all qualifier type configurations.\n * @public\n */\nexport type IAnyQualifierTypeConfig = IQualifierTypeConfig | ISystemQualifierTypeConfig;\n\n/**\n * Checks if a {@link QualifierTypes.Config.IAnyQualifierTypeConfig | qualifier type configuration} is a\n * {@link QualifierTypes.Config.ISystemQualifierTypeConfig | system qualifier type configuration}.\n * @param config - The {@link QualifierTypes.Config.IAnyQualifierTypeConfig | qualifier type configuration} to check.\n * @returns `true` if the configuration is a system qualifier type configuration, `false` otherwise.\n * @public\n */\nexport function isSystemQualifierTypeConfig(\n  config: IAnyQualifierTypeConfig\n): config is ISystemQualifierTypeConfig {\n  return (\n    config.systemType === 'language' || config.systemType === 'territory' || config.systemType === 'literal'\n  );\n}\n"]}

package/dist/packlets/qualifier-types/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAa,UAAU,EAAU,IAAI,EAAE,MAAM,eAAe,CAAC;AAcpE;;;;;GAKG;AACH,kDAAkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAC7C,CACE,IAAa,EACb,MAA8D,EAC9D,OAAsC,EACf,EAAE;IACzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC,qDAAqD,CAAC,CAAC;AACrE,CAAC,CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAC/C,cAA4B;IAE5B,OAAO,UAAU,CAAC,MAAM,CAAwC;QAC9D,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC;QAC1C,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,cAAc,EAAE;YAC7C,YAAY,EAAE,cAAc;SAC7B,CAAC;KACH,CAAC,CAAC;AACL,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 { Converter, Converters, Result, fail } from '@fgv/ts-utils';\nimport { QualifierType } from './qualifierType';\nimport { ReadOnlyQualifierTypeCollector } from './qualifierTypeCollector';\nimport { ILiteralValueHierarchyCreateParams } from './literalValueHierarchy';\n\n/**\n * Context necessary to convert a qualifier name or number to an instantiated\n * {@link QualifierTypes.QualifierType}.\n * @public\n */\nexport interface IQualifierTypeConvertContext {\n  qualifierTypes: ReadOnlyQualifierTypeCollector;\n}\n\n/**\n * Converter for {@link QualifierTypes.QualifierType | QualifierType} objects,\n * retrieves a {@link QualifierTypes.QualifierType | QualifierType} by name or\n * index from a supplied {@link QualifierTypes.Convert.IQualifierTypeConvertContext | conversion context}.\n * @public\n */\n// eslint-disable-next-line @rushstack/typedef-var\nexport const qualifierType = Converters.generic<QualifierType, IQualifierTypeConvertContext>(\n  (\n    from: unknown,\n    __self: Converter<QualifierType, IQualifierTypeConvertContext>,\n    context?: IQualifierTypeConvertContext\n  ): Result<QualifierType> => {\n    if (!context) {\n      return fail('qualifierType converter requires a context');\n    }\n    if (typeof from === 'string') {\n      return context.qualifierTypes.validating.get(from);\n    } else if (typeof from === 'number') {\n      return context.qualifierTypes.getAt(from);\n    }\n    return fail('qualifierType converter requires a string or number');\n  }\n);\n\n/**\n * Gets a converter for {@link QualifierTypes.ILiteralValueHierarchyCreateParams | ILiteralValueHierarchyCreateParams}\n * objects with values validated by a supplied value converter.\n * @param valueConverter - Converter for the literal value type.\n * @public\n */\nexport function literalValueHierarchyCreateParams<T extends string>(\n  valueConverter: Converter<T>\n): Converter<ILiteralValueHierarchyCreateParams<T>> {\n  return Converters.object<ILiteralValueHierarchyCreateParams<T>>({\n    values: Converters.arrayOf(valueConverter),\n    hierarchy: Converters.recordOf(valueConverter, {\n      keyConverter: valueConverter\n    })\n  });\n}\n"]}

package/dist/packlets/qualifier-types/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,IAAI,EAAU,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAU9D;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAA0C;;IAE1C,yCAAyC;IACzC,MAAM,WAAW,GAAG,MAAA,UAAU,CAAC,aAAa,mCAAI,EAAE,CAAC;IACnD,QAAQ,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9B,KAAK,UAAU;YACb,OAAO,MAAM,CAAC,OAAO,CAAC,2BAA2B;iBAC9C,OAAO,CAAC,WAAW,CAAC;iBACpB,SAAS,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3B,qBAAqB,CAAC,gBAAgB,iCAAM,UAAU,KAAE,aAAa,IAAG,CACzE,CAAC;QACN,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,OAAO,CAAC,4BAA4B;iBAC/C,OAAO,CAAC,WAAW,CAAC;iBACpB,SAAS,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3B,sBAAsB,CAAC,gBAAgB,iCAAM,UAAU,KAAE,aAAa,IAAG,CAC1E,CAAC;QACN,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,OAAO,CAAC,0BAA0B;iBAC7C,OAAO,CAAC,WAAW,CAAC;iBACpB,SAAS,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3B,oBAAoB,CAAC,gBAAgB,iCAAM,UAAU,KAAE,aAAa,IAAG,CACxE,CAAC;IACR,CAAC;IACD,yCAAyC;IACzC,OAAO,IAAI,CAAC,2BAA2B,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mCAAmC,CACjD,UAA6C;IAE7C,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;IAClC,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,qBAAqB,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC5D,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IACD,0CAA0C;IAC1C,mBAAmB;IACnB,OAAO,IAAI,CAAC,GAAG,UAAU,kCAAkC,CAAC,CAAC;AAC/D,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 { fail, Result } from '@fgv/ts-utils';\nimport * as Config from './config';\nimport { QualifierType } from './qualifierType';\nimport { LanguageQualifierType } from './languageQualifierType';\nimport { TerritoryQualifierType } from './territoryQualifierType';\nimport { LiteralQualifierType } from './literalQualifierType';\n\n/**\n * A discriminated union of all system qualifier types.\n * This allows TypeScript to properly discriminate between specific qualifier type implementations\n * and access their specific methods like getConfiguration().\n * @public\n */\nexport type SystemQualifierType = LanguageQualifierType | TerritoryQualifierType | LiteralQualifierType;\n\n/**\n * Creates a {@link QualifierTypes.QualifierType | QualifierType} from a configuration object.\n * This factory function determines the appropriate qualifier type based on the systemType\n * and delegates to the appropriate type-specific createFromConfig method.\n * @param typeConfig - The {@link QualifierTypes.Config.IQualifierTypeConfig | configuration object}\n * containing the name, systemType, and optional type-specific configuration.\n * @returns `Success` with the new {@link QualifierTypes.QualifierType | QualifierType}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function createQualifierTypeFromConfig(\n  typeConfig: Config.IAnyQualifierTypeConfig\n): Result<QualifierType> {\n  /* c8 ignore next 1 - defense in depth */\n  const childConfig = typeConfig.configuration ?? {};\n  switch (typeConfig.systemType) {\n    case 'language':\n      return Config.Convert.languageQualifierTypeConfig\n        .convert(childConfig)\n        .onSuccess((configuration) =>\n          LanguageQualifierType.createFromConfig({ ...typeConfig, configuration })\n        );\n    case 'territory':\n      return Config.Convert.territoryQualifierTypeConfig\n        .convert(childConfig)\n        .onSuccess((configuration) =>\n          TerritoryQualifierType.createFromConfig({ ...typeConfig, configuration })\n        );\n    case 'literal':\n      return Config.Convert.literalQualifierTypeConfig\n        .convert(childConfig)\n        .onSuccess((configuration) =>\n          LiteralQualifierType.createFromConfig({ ...typeConfig, configuration })\n        );\n  }\n  /* c8 ignore next 1 - defense in depth */\n  return fail(`Unknown qualifier type: ${typeConfig.systemType}`);\n}\n\n/**\n * Creates a {@link QualifierTypes.SystemQualifierType | SystemQualifierType} from a system configuration object.\n * This factory function determines the appropriate qualifier type based on the systemType\n * and delegates to the appropriate type-specific createFromConfig method.\n * @param typeConfig - The {@link QualifierTypes.Config.ISystemQualifierTypeConfig | configuration object}\n * containing the name, systemType, and optional type-specific configuration.\n * @returns `Success` with the new {@link QualifierTypes.SystemQualifierType | SystemQualifierType}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function createQualifierTypeFromSystemConfig(\n  typeConfig: Config.ISystemQualifierTypeConfig\n): Result<SystemQualifierType> {\n  const { systemType } = typeConfig;\n  switch (systemType) {\n    case 'language':\n      return LanguageQualifierType.createFromConfig(typeConfig);\n    case 'territory':\n      return TerritoryQualifierType.createFromConfig(typeConfig);\n    case 'literal':\n      return LiteralQualifierType.createFromConfig(typeConfig);\n  }\n  /* c8 ignore next 3 - should not happen */\n  // @ts-expect-error\n  return fail(`${systemType}: Unknown system qualifier type.`);\n}\n"]}

package/dist/packlets/qualifier-types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,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 * as Config from './config';\nimport * as Convert from './convert';\n\nexport * from './qualifierType';\nexport * from './languageQualifierType';\nexport * from './literalQualifierType';\nexport * from './literalValueHierarchy';\nexport * from './territoryQualifierType';\nexport * from './qualifierTypeCollector';\nexport * from './helpers';\n\nexport { Config, Convert };\n"]}

package/dist/packlets/qualifier-types/languageQualifierType.js

@@ -34,9 +34,8 @@ import { sanitizeJsonObject } from '@fgv/ts-json-base';
 export class LanguageQualifierType extends QualifierType {
     /**
      * 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
      */
     constructor({ name, allowContextList, index }) {
@@ -47,7 +46,7 @@ export class LanguageQualifierType extends QualifierType {
         super(Object.assign({ name,
             allowContextList }, validated));
         /**
-         * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
+         * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}
          */
         this.systemTypeName = Convert.qualifierTypeName.convert('language').orThrow();
     }
@@ -79,7 +78,7 @@ export class LanguageQualifierType extends QualifierType {
         }).onSuccess(LanguageQualifierType.create);
     }
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isValidConditionValue}
+     * {@inheritDoc QualifierTypes.IQualifierType.isValidConditionValue}
      */
     isValidConditionValue(value) {
         return Bcp47.tag(value)
@@ -95,7 +94,7 @@ export class LanguageQualifierType extends QualifierType {
         return this.getConfigurationJson().onSuccess((json) => Config.Convert.systemLanguageQualifierTypeConfig.convert(json));
     }
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
     getConfigurationJson() {
         return succeed({
@@ -107,7 +106,7 @@ export class LanguageQualifierType extends QualifierType {
         });
     }
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
     validateConfigurationJson(from) {
         return Config.Convert.systemLanguageQualifierTypeConfig.convert(from);

package/dist/packlets/qualifier-types/languageQualifierType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languageQualifierType.js","sourceRoot":"","sources":["../../../src/packlets/qualifier-types/languageQualifierType.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, captureResult, succeed } from '@fgv/ts-utils';\nimport { Bcp47 } from '@fgv/ts-bcp47';\nimport {\n  ConditionOperator,\n  Convert,\n  NoMatch,\n  QualifierConditionValue,\n  QualifierContextValue,\n  QualifierMatchScore,\n  QualifierTypeName,\n  Validate\n} from '../common';\nimport { IQualifierTypeCreateParams, QualifierType } from './qualifierType';\nimport * as Config from './config';\nimport { JsonCompatibleType, sanitizeJsonObject } from '@fgv/ts-json-base';\n\n/**\n * Interface defining the parameters that can be used to create a new\n * {@link QualifierTypes.LanguageQualifierType | LanguageQualifierType}.\n * @public\n */\nexport interface ILanguageQualifierTypeCreateParams extends Partial<IQualifierTypeCreateParams> {\n  /**\n   * Optional name for the qualifier type. Defaults to 'language'.\n   */\n  name?: string;\n\n  /**\n   * Optional flag indicating whether the context can be a list of values.\n   * Defaults to `true`.\n   */\n  allowContextList?: boolean;\n}\n\n/**\n * {@link QualifierTypes.QualifierType | Qualifier type} which matches BCP-47 language tags\n * applying {@link https://github.com/ErikFortune/fgv/tree/main/libraries/ts-bcp47#tag-matching | similarity matching}.\n * Accepts a list of language tags in the context by default.\n * @public\n */\nexport class LanguageQualifierType extends QualifierType<\n  JsonCompatibleType<Config.ILanguageQualifierTypeConfig>\n> {\n  /**\n   * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}\n   */\n  public readonly systemTypeName: QualifierTypeName = Convert.qualifierTypeName.convert('language').orThrow();\n\n  /**\n   * Creates a new instance of a {@link QualifierTypes.LanguageQualifierType | language qualifier type}.\n   * @param params - The {@link QualifierTypes.ILanguageQualifierTypeCreateParams | create parameters}\n   * for this qualifier type.\n   * @public\n   */\n  protected constructor({ name, allowContextList, index }: ILanguageQualifierTypeCreateParams) {\n    allowContextList = allowContextList !== false;\n    /* c8 ignore next 2 - coverage intermittently drops these two lines even though they're tested */\n    name = name ?? 'language';\n    const validated = index ? { index: Convert.qualifierTypeIndex.convert(index).orThrow() } : {};\n\n    super({\n      name,\n      allowContextList,\n      ...validated\n    });\n  }\n\n  /**\n   * Creates a new instance of a {@link QualifierTypes.LanguageQualifierType | language qualifier type}.\n   * @param params - Optional {@link QualifierTypes.ILanguageQualifierTypeCreateParams | parameters}\n   * to use when creating the new instance.\n   * @returns `Success` with the new {@link QualifierTypes.LanguageQualifierType | language qualifier type}\n   * if successful, `Failure` otherwise.\n   */\n  public static create(params?: ILanguageQualifierTypeCreateParams): Result<LanguageQualifierType> {\n    /* c8 ignore next 1 - coverage seems to intermittently miss the branch even though it's tested */\n    params = params ?? {};\n    return captureResult(() => new LanguageQualifierType(params));\n  }\n\n  /**\n   * Creates a new {@link QualifierTypes.LanguageQualifierType | LanguageQualifierType} from a configuration object.\n   * @param config - The {@link QualifierTypes.Config.IQualifierTypeConfig | configuration object} containing\n   * the name, systemType, and optional language-specific configuration.\n   * @returns `Success` with the new {@link QualifierTypes.LanguageQualifierType | LanguageQualifierType}\n   * if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public static createFromConfig(\n    config: Config.IQualifierTypeConfig<Config.ILanguageQualifierTypeConfig>\n  ): Result<LanguageQualifierType> {\n    return sanitizeJsonObject<ILanguageQualifierTypeCreateParams>({\n      name: config.name,\n      allowContextList: config.configuration?.allowContextList === true\n    }).onSuccess(LanguageQualifierType.create);\n  }\n\n  /**\n   * {@inheritDoc QualifierTypes.IQualifierType.isValidConditionValue}\n   */\n  public isValidConditionValue(value: string): value is QualifierConditionValue {\n    return Bcp47.tag(value)\n      .onSuccess((tag) => succeed(tag.isValid))\n      .orDefault(false);\n  }\n\n  /**\n   * Gets a {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | strongly typed configuration object}\n   * for this qualifier type.\n   * @returns `Success` with the configuration if successful, `Failure` with an error message otherwise.\n   */\n  public getConfiguration(): Result<Config.ISystemLanguageQualifierTypeConfig> {\n    return this.getConfigurationJson().onSuccess((json) =>\n      Config.Convert.systemLanguageQualifierTypeConfig.convert(json)\n    );\n  }\n\n  /**\n   * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}\n   */\n  public getConfigurationJson(): Result<JsonCompatibleType<Config.ISystemLanguageQualifierTypeConfig>> {\n    return succeed({\n      name: this.name,\n      systemType: 'language' as const,\n      configuration: {\n        allowContextList: this.allowContextList\n      }\n    });\n  }\n\n  /**\n   * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}\n   */\n  public validateConfigurationJson(\n    from: unknown\n  ): Result<JsonCompatibleType<Config.ISystemLanguageQualifierTypeConfig>> {\n    return Config.Convert.systemLanguageQualifierTypeConfig.convert(from);\n  }\n\n  /**\n   * Validates a {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | strongly typed configuration object}\n   * for this qualifier type.\n   * @param from - The unknown data to validate as a configuration object.\n   * @returns `Success` with the validated configuration if successful, `Failure` with an error message otherwise.\n   */\n  public validateConfiguration(from: unknown): Result<Config.ISystemLanguageQualifierTypeConfig> {\n    return Config.Convert.systemLanguageQualifierTypeConfig.convert(from);\n  }\n\n  /**\n   * Matches a single language condition against a single language context value using\n   * {@link https://github.com/ErikFortune/fgv/tree/main/libraries/ts-bcp47#tag-matching | similarity matching}.\n   * @param condition - The language condition value to match.\n   * @param context - The language context value to match against.\n   * @param operator - The operator to use for the match. Must be 'matches'.\n   * @returns The match score, or `noMatch` if the match fails.\n   */\n  protected _matchOne(\n    condition: QualifierConditionValue,\n    context: QualifierContextValue,\n    operator: ConditionOperator\n  ): QualifierMatchScore {\n    if (operator === 'matches') {\n      const similarity = Bcp47.similarity(condition, context).orDefault(Bcp47.tagSimilarity.none);\n      if (similarity > 0.0 && Validate.isValidQualifierMatchScore(similarity)) {\n        return similarity;\n      }\n    }\n    return NoMatch;\n  }\n}\n"]}

package/dist/packlets/qualifier-types/literalQualifierType.js

@@ -33,11 +33,8 @@ import { sanitizeJsonObject } from '@fgv/ts-json-base';
 export class LiteralQualifierType extends QualifierType {
     /**
      * 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
      */
     constructor({ name, caseSensitive, allowContextList, enumeratedValues, hierarchy, index }) {
@@ -48,7 +45,7 @@ export class LiteralQualifierType extends QualifierType {
             index: index !== undefined ? Convert.qualifierTypeIndex.convert(index).orThrow() : undefined
         });
         /**
-         * {@inheritdoc QualifierTypes.IQualifierType.systemTypeName}
+         * {@inheritDoc QualifierTypes.IQualifierType.systemTypeName}
          */
         this.systemTypeName = Convert.qualifierTypeName.convert('literal').orThrow();
         this.caseSensitive = caseSensitive === true;
@@ -80,7 +77,7 @@ export class LiteralQualifierType extends QualifierType {
         return LiteralQualifierType.isValidLiteralConditionValue(value);
     }
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.isPotentialMatch}
+     * {@inheritDoc QualifierTypes.IQualifierType.isPotentialMatch}
      */
     isPotentialMatch(conditionValue, contextValue) {
         if (this.isValidConditionValue(conditionValue) && this.isValidContextValue(contextValue)) {
@@ -102,7 +99,7 @@ export class LiteralQualifierType extends QualifierType {
         return this.getConfigurationJson().onSuccess((json) => Config.Convert.systemLiteralQualifierTypeConfig.convert(json));
     }
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.getConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.getConfigurationJson}
      */
     getConfigurationJson() {
         const hierarchy = this.hierarchy ? { hierarchy: this.hierarchy.asRecord() } : {};
@@ -116,7 +113,7 @@ export class LiteralQualifierType extends QualifierType {
         });
     }
     /**
-     * {@inheritdoc QualifierTypes.IQualifierType.validateConfigurationJson}
+     * {@inheritDoc QualifierTypes.IQualifierType.validateConfigurationJson}
      */
     validateConfigurationJson(from) {
         return Config.Convert.systemLiteralQualifierTypeConfig.convert(from);
@@ -131,7 +128,7 @@ export class LiteralQualifierType extends QualifierType {
         return Config.Convert.systemLiteralQualifierTypeConfig.convert(from);
     }
     /**
-     * {@inheritdoc QualifierTypes.QualifierType._matchOne}
+     * {@inheritDoc QualifierTypes.QualifierType._matchOne}
      */
     _matchOne(condition, context, __operator) {
         if (this.hierarchy) {