@fgv/ts-res 5.1.0-1 → 5.1.0-11

package/lib/packlets/config/systemConfiguration.js

@@ -0,0 +1,152 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemConfiguration = void 0;
+exports.updateSystemConfigurationQualifierDefaultValues = updateSystemConfigurationQualifierDefaultValues;
+const ts_utils_1 = require("@fgv/ts-utils");
+const qualifier_types_1 = require("../qualifier-types");
+const qualifiers_1 = require("../qualifiers");
+const resource_types_1 = require("../resource-types");
+const convert_1 = require("./convert");
+const ts_json_base_1 = require("@fgv/ts-json-base");
+const configInitFactory_1 = require("./configInitFactory");
+/**
+ * Creates a copy of the provided {@link Config.Model.ISystemConfiguration | system configuration}
+ * with updated qualifier default values.
+ * @param config - The base {@link Config.Model.ISystemConfiguration | system configuration} to copy.
+ * @param qualifierDefaultValues - Map of qualifier names to default values. Use `null` to remove existing values.
+ * @returns `Success` with the updated {@link Config.Model.ISystemConfiguration | system configuration}
+ * if successful, `Failure` with an error message otherwise.
+ * @public
+ */
+function updateSystemConfigurationQualifierDefaultValues(config, qualifierDefaultValues // eslint-disable-line @rushstack/no-new-null
+) {
+    // Create a copy of the config
+    return (0, ts_json_base_1.sanitizeJsonObject)(config).onSuccess((updatedConfig) => {
+        // Create a map of existing qualifier names for validation
+        const existingQualifierNames = new Set(updatedConfig.qualifiers.map((q) => q.name));
+        // Validate that all specified qualifiers exist in the configuration
+        for (const qualifierName of Object.keys(qualifierDefaultValues)) {
+            if (!existingQualifierNames.has(qualifierName)) {
+                return (0, ts_utils_1.fail)(`Qualifier '${qualifierName}' not found in system configuration`);
+            }
+        }
+        // Update qualifier default values
+        updatedConfig.qualifiers = updatedConfig.qualifiers.map((qualifier) => {
+            if (qualifier.name in qualifierDefaultValues) {
+                const newDefaultValue = qualifierDefaultValues[qualifier.name];
+                // Create a copy of the qualifier
+                const updatedQualifier = Object.assign({}, qualifier);
+                if (newDefaultValue === null) {
+                    // Remove the default value
+                    delete updatedQualifier.defaultValue;
+                }
+                else {
+                    // Set the new default value
+                    updatedQualifier.defaultValue = newDefaultValue;
+                }
+                return updatedQualifier;
+            }
+            return qualifier;
+        });
+        return (0, ts_utils_1.succeed)(updatedConfig);
+    });
+}
+/**
+ * A system configuration for both runtime or build.
+ * @public
+ */
+class SystemConfiguration {
+    /**
+     * The name of this system configuration.
+     */
+    get name() {
+        return this._config.name;
+    }
+    /**
+     * The description of this system configuration.
+     */
+    get description() {
+        return this._config.description;
+    }
+    /**
+     * Constructs a new instance of a {@link Config.SystemConfiguration | SystemConfiguration} from the
+     * supplied {@link Config.Model.ISystemConfiguration | system configuration}.
+     * @param config - The {@link Config.Model.ISystemConfiguration | system configuration} to use.
+     * @public
+     */
+    constructor(config, initParams) {
+        var _a, _b;
+        this._config = config;
+        const qualifierTypeFactory = (_a = initParams === null || initParams === void 0 ? void 0 : initParams.qualifierTypeFactory) !== null && _a !== void 0 ? _a : new configInitFactory_1.BuiltInQualifierTypeFactory();
+        const resourceTypeFactory = (_b = initParams === null || initParams === void 0 ? void 0 : initParams.resourceTypeFactory) !== null && _b !== void 0 ? _b : new configInitFactory_1.BuiltInResourceTypeFactory();
+        this.qualifierTypes = qualifier_types_1.QualifierTypeCollector.create({
+            qualifierTypes: (0, ts_utils_1.mapResults)(config.qualifierTypes.map((tc) => qualifierTypeFactory.create(tc))).orThrow()
+        }).orThrow();
+        this.qualifiers = qualifiers_1.QualifierCollector.create({
+            qualifierTypes: this.qualifierTypes,
+            qualifiers: config.qualifiers
+        }).orThrow();
+        this.resourceTypes = resource_types_1.ResourceTypeCollector.create({
+            resourceTypes: (0, ts_utils_1.mapResults)(config.resourceTypes.map((rt) => resourceTypeFactory.create(rt))).orThrow()
+        }).orThrow();
+    }
+    /**
+     * Creates a new {@link Config.SystemConfiguration | SystemConfiguration} from the supplied
+     * {@link Config.Model.ISystemConfiguration | system configuration}.
+     * @param config - The {@link Config.Model.ISystemConfiguration | system configuration} to use.
+     * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.
+     * @returns `Success` with the new {@link Config.SystemConfiguration | SystemConfiguration}
+     * if successful, `Failure` with an error message otherwise.
+     * @public
+     */
+    static create(config, initParams) {
+        if (initParams === null || initParams === void 0 ? void 0 : initParams.qualifierDefaultValues) {
+            /* c8 ignore next 9 - functional code tested but coverage intermittently missed */
+            return updateSystemConfigurationQualifierDefaultValues(config, initParams.qualifierDefaultValues).onSuccess((updatedConfig) => (0, ts_utils_1.captureResult)(() => new SystemConfiguration(updatedConfig, (0, ts_utils_1.omit)(initParams, ['qualifierDefaultValues']))));
+        }
+        return (0, ts_utils_1.captureResult)(() => new SystemConfiguration(config, initParams));
+    }
+    /**
+     * Loads a {@link Config.SystemConfiguration | SystemConfiguration} from a file.
+     * @param path - The path to the file to load.
+     * @returns `Success` with the {@link Config.SystemConfiguration | SystemConfiguration}
+     * if successful, `Failure` with an error message otherwise.
+     * @public
+     */
+    static loadFromFile(path, initParams) {
+        return ts_json_base_1.JsonFile.convertJsonFileSync(path, convert_1.systemConfiguration).onSuccess((config) => SystemConfiguration.create(config, initParams));
+    }
+    /**
+     * Returns the {@link Config.Model.ISystemConfiguration | system configuration} that this
+     * {@link Config.SystemConfiguration | SystemConfiguration} was created from.
+     * @returns `Success` with the {@link Config.Model.ISystemConfiguration | system configuration}
+     * if successful, `Failure` with an error message otherwise.
+     * @public
+     */
+    getConfig() {
+        return convert_1.systemConfiguration.convert(this._config);
+    }
+}
+exports.SystemConfiguration = SystemConfiguration;
+//# sourceMappingURL=systemConfiguration.js.map

package/lib/packlets/import/importManager.d.ts

@@ -1,5 +1,7 @@
 import { Result } from '@fgv/ts-utils';
 import { FileTree } from '@fgv/ts-json-base';
+import { Converter } from '@fgv/ts-utils';
+import { JsonValue } from '@fgv/ts-json-base';
 import { ResourceManagerBuilder } from '../resources';
 import { ImportContext } from './importContext';
 import { IImportable } from './importable';
@@ -27,6 +29,14 @@ export interface IImporterCreateParams {
      * An optional list of {@link Import.Importers.IImporter | importers} to use for the import.
      */
     importers?: IImporter[];
+    /**
+     * An optional converter used to pre-process file contents before JSON import validation.
+     */
+    fileContentConverter?: Converter<JsonValue>;
+    /**
+     * Optional file extensions which should be parsed using the supplied file content converter.
+     */
+    fileContentExtensions?: ReadonlyArray<string>;
 }
 /**
  * Class to manage the import of resources from various sources.
@@ -80,9 +90,13 @@ export declare class ImportManager {
      * and optional `FileTree`.
      * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for the import.
      * @param tree - An optional `FileTree` for importing path items.
+     * @param fileContentConverter - An optional converter used to pre-process raw file contents before JSON import
+     * validation.
+     * @param fileContentExtensions - Optional file extensions which should be parsed using the supplied file
+     * content converter.
      * @returns A read-only array of {@link Import.Importers.IImporter | importers}.
      */
-    static getDefaultImporters(qualifiers: IReadOnlyQualifierCollector, tree?: FileTree.FileTree): ReadonlyArray<IImporter>;
+    static getDefaultImporters(qualifiers: IReadOnlyQualifierCollector, tree?: FileTree.FileTree, fileContentConverter?: Converter<JsonValue>, fileContentExtensions?: ReadonlyArray<string>): ReadonlyArray<IImporter>;
     /**
      * Imports any items on the import stack.
      * @returns `Success` with the {@link Import.ImportManager | ImportManager} if successful,

package/lib/packlets/import/importManager.js

@@ -48,7 +48,7 @@ class ImportManager {
         this._importers = [];
         this.resources = params.resources;
         this.initialContext = (_a = params.initialContext) !== null && _a !== void 0 ? _a : importContext_1.ImportContext.create().orThrow();
-        this._importers = Array.from((_b = params.importers) !== null && _b !== void 0 ? _b : ImportManager.getDefaultImporters(this.resources.qualifiers, params.fileTree));
+        this._importers = Array.from((_b = params.importers) !== null && _b !== void 0 ? _b : ImportManager.getDefaultImporters(this.resources.qualifiers, params.fileTree, params.fileContentConverter, params.fileContentExtensions));
     }
     /**
      * Factory method to create a new {@link Import.ImportManager | ImportManager}.
@@ -84,12 +84,16 @@ class ImportManager {
      * and optional `FileTree`.
      * @param qualifiers - The {@link Qualifiers.IReadOnlyQualifierCollector | qualifiers} to use for the import.
      * @param tree - An optional `FileTree` for importing path items.
+     * @param fileContentConverter - An optional converter used to pre-process raw file contents before JSON import
+     * validation.
+     * @param fileContentExtensions - Optional file extensions which should be parsed using the supplied file
+     * content converter.
      * @returns A read-only array of {@link Import.Importers.IImporter | importers}.
      */
-    static getDefaultImporters(qualifiers, tree) {
+    static getDefaultImporters(qualifiers, tree, fileContentConverter, fileContentExtensions) {
         return [
             importers_1.PathImporter.create({ qualifiers, tree }).orThrow(),
-            fsItemImporter_1.FsItemImporter.create({ qualifiers }).orThrow(),
+            fsItemImporter_1.FsItemImporter.create({ qualifiers, fileContentConverter, fileContentExtensions }).orThrow(),
             importers_1.JsonImporter.create().orThrow(),
             importers_1.CollectionImporter.create().orThrow()
         ];

package/lib/packlets/import/importers/fsItemImporter.d.ts

@@ -1,4 +1,5 @@
-import { DetailedResult, Result } from '@fgv/ts-utils';
+import { DetailedResult, Result, Converter } from '@fgv/ts-utils';
+import { JsonValue } from '@fgv/ts-json-base';
 import { ResourceManagerBuilder } from '../../resources';
 import { IImportable } from '../importable';
 import { IImporter, ImporterResultDetail } from './importer';
@@ -10,6 +11,8 @@ import { FsItem, FsItemResultDetail } from '../fsItem';
  */
 export interface IFsItemImporterCreateParams {
     qualifiers: IReadOnlyQualifierCollector;
+    fileContentConverter?: Converter<JsonValue>;
+    fileContentExtensions?: ReadonlyArray<string>;
 }
 /**
  * {@link Import.Importers.IImporter | Importer} implementation which imports resources from a `FileTree`.
@@ -20,6 +23,14 @@ export declare class FsItemImporter implements IImporter {
      * The {@link Qualifiers.IReadOnlyQualifierCollector | qualifier collector} to use for this importer.
      */
     readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * Optional converter used to parse raw file contents before they are exposed as JSON importables.
+     */
+    readonly fileContentConverter?: Converter<JsonValue>;
+    /**
+     * Optional list of file extensions which should be parsed using the file content converter.
+     */
+    readonly fileContentExtensions?: ReadonlyArray<string>;
     /**
      * The types of {@link Import.IImportable | importables} that this importer can handle.
      */
@@ -39,6 +50,9 @@ export declare class FsItemImporter implements IImporter {
      * {@inheritdoc Import.Importers.IImporter.import}
      */
     import(item: IImportable, __manager: ResourceManagerBuilder): DetailedResult<IImportable[], ImporterResultDetail>;
+    private _isSupportedFileExtension;
+    private _getJsonContents;
+    private _canConvertFileExtension;
     /**
      * Gets an {@link Import.FsItem | FsItem} from an {@link Import.IImportable | importable}.
      * @param item - The importable to convert.

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

@@ -40,6 +40,8 @@ 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}.
@@ -84,23 +86,37 @@ class FsItemImporter {
                 .withDetail('failed', 'processed');
         }
         else if (fsItem.item.type === 'file') {
-            if (fsItem.item.extension === '.json') {
-                return fsItem.item
-                    .getContents(ts_json_base_1.Converters.jsonValue)
-                    .onSuccess((json) => {
-                    const jsonItem = {
-                        type: 'json',
-                        json,
-                        context
-                    };
-                    return (0, ts_utils_1.succeed)([jsonItem]);
-                })
-                    .withDetail('failed', 'processed');
+            if (!this._isSupportedFileExtension(fsItem.item.extension)) {
+                return (0, ts_utils_1.succeedWithDetail)([], 'skipped');
             }
+            return this._getJsonContents(fsItem.item)
+                .onSuccess((json) => {
+                const jsonItem = {
+                    type: 'json',
+                    json,
+                    context
+                };
+                return (0, ts_utils_1.succeed)([jsonItem]);
+            })
+                .withDetail('failed', 'processed');
         }
         /* c8 ignore next 2 - defensive coding: fallback case for unsupported file types */
         return (0, ts_utils_1.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(ts_json_base_1.Converters.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/lib/packlets/qualifier-types/config/convert.d.ts

@@ -0,0 +1,65 @@
+import { Converter } from '@fgv/ts-utils';
+import * as Model from './json';
+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 declare const languageQualifierTypeConfig: import("@fgv/ts-utils").ObjectConverter<Model.ILanguageQualifierTypeConfig, unknown>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const territoryQualifierTypeConfig: import("@fgv/ts-utils").ObjectConverter<Model.ITerritoryQualifierTypeConfig, unknown>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const literalQualifierTypeConfig: import("@fgv/ts-utils").ObjectConverter<Model.ILiteralQualifierTypeConfig, unknown>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const systemLanguageQualifierTypeConfig: import("@fgv/ts-utils").ObjectConverter<Model.ISystemLanguageQualifierTypeConfig, unknown>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const systemTerritoryQualifierTypeConfig: import("@fgv/ts-utils").ObjectConverter<Model.ISystemTerritoryQualifierTypeConfig, unknown>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const systemLiteralQualifierTypeConfig: import("@fgv/ts-utils").ObjectConverter<Model.ISystemLiteralQualifierTypeConfig, unknown>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const systemQualifierTypeConfig: Converter<Model.ISystemQualifierTypeConfig, unknown>;
+/**
+ * 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 declare function qualifierTypeConfig<T, TD = unknown>(config: Converter<T, TD>): Converter<Model.IQualifierTypeConfig<T>, TD>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.IQualifierTypeConfig | QualifierTypeConfig} objects.
+ * @public
+ */
+export declare const jsonQualifierTypeConfig: Converter<Model.IQualifierTypeConfig<import("@fgv/ts-json-base").JsonObject>, JsonConverters.IJsonConverterContext>;
+/**
+ * A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.
+ * @public
+ */
+export declare const anyQualifierTypeConfig: Converter<Model.IAnyQualifierTypeConfig, unknown>;
+//# sourceMappingURL=convert.d.ts.map

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

@@ -0,0 +1,161 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anyQualifierTypeConfig = exports.jsonQualifierTypeConfig = exports.systemQualifierTypeConfig = exports.systemLiteralQualifierTypeConfig = exports.systemTerritoryQualifierTypeConfig = exports.systemLanguageQualifierTypeConfig = exports.literalQualifierTypeConfig = exports.territoryQualifierTypeConfig = exports.languageQualifierTypeConfig = void 0;
+exports.qualifierTypeConfig = qualifierTypeConfig;
+/* eslint-disable @rushstack/typedef-var */
+const ts_utils_1 = require("@fgv/ts-utils");
+const Common = __importStar(require("../../common"));
+const ts_json_base_1 = require("@fgv/ts-json-base");
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ILanguageQualifierTypeConfig | LanguageQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ILanguageQualifierTypeConfig | LanguageQualifierTypeConfig} objects.
+ * @public
+ */
+exports.languageQualifierTypeConfig = ts_utils_1.Converters.strictObject({
+    allowContextList: ts_utils_1.Converters.boolean.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ITerritoryQualifierTypeConfig | TerritoryQualifierTypeConfig} objects.
+ * @public
+ */
+exports.territoryQualifierTypeConfig = ts_utils_1.Converters.strictObject({
+    allowContextList: ts_utils_1.Converters.boolean,
+    acceptLowercase: ts_utils_1.Converters.boolean.optional(),
+    allowedTerritories: ts_utils_1.Converters.arrayOf(ts_utils_1.Converters.string).optional(),
+    hierarchy: ts_utils_1.Converters.recordOf(ts_utils_1.Converters.string).optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ILiteralQualifierTypeConfig | LiteralQualifierTypeConfig} objects.
+ * @public
+ */
+exports.literalQualifierTypeConfig = ts_utils_1.Converters.strictObject({
+    allowContextList: ts_utils_1.Converters.boolean.optional(),
+    caseSensitive: ts_utils_1.Converters.boolean.optional(),
+    enumeratedValues: ts_utils_1.Converters.arrayOf(ts_utils_1.Converters.string).optional(),
+    hierarchy: ts_utils_1.Converters.recordOf(ts_utils_1.Converters.string).optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLanguageQualifierTypeConfig | SystemLanguageQualifierTypeConfig} objects.
+ * @public
+ */
+exports.systemLanguageQualifierTypeConfig = ts_utils_1.Converters.strictObject({
+    name: ts_utils_1.Converters.string,
+    systemType: ts_utils_1.Converters.literal('language'),
+    configuration: exports.languageQualifierTypeConfig.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemTerritoryQualifierTypeConfig | SystemTerritoryQualifierTypeConfig} objects.
+ * @public
+ */
+exports.systemTerritoryQualifierTypeConfig = ts_utils_1.Converters.strictObject({
+    name: ts_utils_1.Converters.string,
+    systemType: ts_utils_1.Converters.literal('territory'),
+    configuration: exports.territoryQualifierTypeConfig.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemLiteralQualifierTypeConfig | SystemLiteralQualifierTypeConfig} objects.
+ * @public
+ */
+exports.systemLiteralQualifierTypeConfig = ts_utils_1.Converters.strictObject({
+    name: ts_utils_1.Converters.string,
+    systemType: ts_utils_1.Converters.literal('literal'),
+    configuration: exports.literalQualifierTypeConfig.optional()
+});
+/**
+ * A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.ISystemQualifierTypeConfig | SystemQualifierTypeConfig} objects.
+ * @public
+ */
+exports.systemQualifierTypeConfig = ts_utils_1.Converters.discriminatedObject('systemType', {
+    language: exports.systemLanguageQualifierTypeConfig,
+    territory: exports.systemTerritoryQualifierTypeConfig,
+    literal: exports.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
+ */
+function qualifierTypeConfig(config) {
+    return ts_utils_1.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
+ */
+exports.jsonQualifierTypeConfig = qualifierTypeConfig(ts_json_base_1.Converters.jsonObject);
+/**
+ * A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.
+ * @returns A `Converter` for {@link QualifierTypes.Config.IAnyQualifierTypeConfig | AnyQualifierTypeConfig} objects.
+ * @public
+ */
+exports.anyQualifierTypeConfig = ts_utils_1.Converters.oneOf([
+    exports.jsonQualifierTypeConfig,
+    exports.systemQualifierTypeConfig
+]);
+//# sourceMappingURL=convert.js.map

package/lib/packlets/qualifier-types/config/index.d.ts

@@ -0,0 +1,4 @@
+import * as Convert from './convert';
+export * from './json';
+export { Convert };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Convert = void 0;
+const Convert = __importStar(require("./convert"));
+exports.Convert = Convert;
+__exportStar(require("./json"), exports);
+//# sourceMappingURL=index.js.map