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

package/lib/packlets/config/predefined/extended.js

@@ -0,0 +1,193 @@
+"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.ExtendedSystemConfiguration = exports.ExtendedResourceTypes = exports.ExtendedQualifiers = exports.ExtendedQualifierTypes = void 0;
+/**
+ * Example extended qualifier types.
+ * @public
+ */
+exports.ExtendedQualifierTypes = [
+    {
+        name: 'language',
+        systemType: 'language',
+        configuration: {
+            allowContextList: true
+        }
+    },
+    {
+        name: 'territory',
+        systemType: 'territory',
+        configuration: {
+            allowContextList: false,
+            acceptLowercase: false
+        }
+    },
+    {
+        name: 'role',
+        systemType: 'literal',
+        configuration: {
+            enumeratedValues: ['admin', 'agent', 'user', 'guest']
+        }
+    },
+    {
+        name: 'environment',
+        systemType: 'literal',
+        configuration: {
+            enumeratedValues: ['production', 'integration', 'development', 'test', 'ephemeral']
+        }
+    },
+    {
+        name: 'currency',
+        systemType: 'literal',
+        configuration: {
+            caseSensitive: true,
+            enumeratedValues: ['USD', 'EUR', 'GBP', 'JPY', 'CNY']
+        }
+    },
+    {
+        name: 'market',
+        systemType: 'literal',
+        configuration: {
+            enumeratedValues: [
+                'world',
+                'americas',
+                'europe',
+                'asia',
+                'oceania',
+                'africa',
+                'middle-east',
+                'latin-america',
+                'caribbean',
+                'central-america',
+                'south-america',
+                'north-america',
+                'nordics',
+                'baltic',
+                'balkans',
+                'eastern-europe',
+                'western-europe',
+                'central-europe',
+                'eastern-africa',
+                'western-africa',
+                'central-africa',
+                'north-africa',
+                'south-africa',
+                'middle-africa',
+                'southeast-asia'
+            ],
+            hierarchy: {
+                americas: 'world',
+                europe: 'world',
+                asia: 'world',
+                oceania: 'world',
+                africa: 'world',
+                'middle-east': 'world',
+                'latin-america': 'americas',
+                caribbean: 'americas',
+                'central-america': 'americas',
+                'south-america': 'americas',
+                'north-america': 'americas',
+                nordics: 'europe',
+                baltic: 'europe',
+                balkans: 'europe',
+                'eastern-europe': 'europe',
+                'western-europe': 'europe',
+                'central-europe': 'europe',
+                'eastern-africa': 'africa',
+                'western-africa': 'africa',
+                'central-africa': 'africa',
+                'north-africa': 'africa',
+                'south-africa': 'africa',
+                'middle-africa': 'africa',
+                'southeast-asia': 'asia'
+            }
+        }
+    }
+];
+/**
+ * Example extended qualifiers.
+ * @public
+ */
+exports.ExtendedQualifiers = [
+    {
+        name: 'homeTerritory',
+        token: 'home',
+        typeName: 'territory',
+        defaultPriority: 900
+    },
+    {
+        name: 'currentTerritory',
+        token: 'geo',
+        typeName: 'territory',
+        defaultPriority: 850
+    },
+    {
+        name: 'language',
+        token: 'lang',
+        typeName: 'language',
+        defaultPriority: 800
+    },
+    {
+        name: 'market',
+        typeName: 'market',
+        defaultPriority: 750
+    },
+    {
+        name: 'role',
+        typeName: 'role',
+        defaultPriority: 700
+    },
+    {
+        name: 'environment',
+        token: 'env',
+        typeName: 'environment',
+        defaultPriority: 650
+    },
+    {
+        name: 'currency',
+        typeName: 'currency',
+        defaultPriority: 600
+    }
+];
+/**
+ * Example resource types.
+ * @public
+ */
+exports.ExtendedResourceTypes = [
+    {
+        name: 'json',
+        typeName: 'json'
+    }
+];
+/**
+ * An example system configuration demonstrating various configuration options.
+ * @public
+ */
+exports.ExtendedSystemConfiguration = {
+    name: 'extended-example',
+    description: 'An example system configuration demonstrating various configuration options',
+    qualifierTypes: [...exports.ExtendedQualifierTypes],
+    qualifiers: [...exports.ExtendedQualifiers],
+    resourceTypes: [...exports.ExtendedResourceTypes]
+};
+//# sourceMappingURL=extended.js.map

package/lib/packlets/config/predefined/extended.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended.js","sourceRoot":"","sources":["../../../../src/packlets/config/predefined/extended.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as ResourceTypes from '../../resource-types';\nimport * as QualifierTypes from '../../qualifier-types';\nimport * as Qualifiers from '../../qualifiers';\nimport { ISystemConfiguration } from '../json';\n\n/**\n * Example extended qualifier types.\n * @public\n */\nexport const ExtendedQualifierTypes: ReadonlyArray<QualifierTypes.Config.ISystemQualifierTypeConfig> = [\n  {\n    name: 'language',\n    systemType: 'language',\n    configuration: {\n      allowContextList: true\n    }\n  },\n  {\n    name: 'territory',\n    systemType: 'territory',\n    configuration: {\n      allowContextList: false,\n      acceptLowercase: false\n    }\n  },\n  {\n    name: 'role',\n    systemType: 'literal',\n    configuration: {\n      enumeratedValues: ['admin', 'agent', 'user', 'guest']\n    }\n  },\n  {\n    name: 'environment',\n    systemType: 'literal',\n    configuration: {\n      enumeratedValues: ['production', 'integration', 'development', 'test', 'ephemeral']\n    }\n  },\n  {\n    name: 'currency',\n    systemType: 'literal',\n    configuration: {\n      caseSensitive: true,\n      enumeratedValues: ['USD', 'EUR', 'GBP', 'JPY', 'CNY']\n    }\n  },\n  {\n    name: 'market',\n    systemType: 'literal',\n    configuration: {\n      enumeratedValues: [\n        'world',\n        'americas',\n        'europe',\n        'asia',\n        'oceania',\n        'africa',\n        'middle-east',\n        'latin-america',\n        'caribbean',\n        'central-america',\n        'south-america',\n        'north-america',\n        'nordics',\n        'baltic',\n        'balkans',\n        'eastern-europe',\n        'western-europe',\n        'central-europe',\n        'eastern-africa',\n        'western-africa',\n        'central-africa',\n        'north-africa',\n        'south-africa',\n        'middle-africa',\n        'southeast-asia'\n      ],\n      hierarchy: {\n        americas: 'world',\n        europe: 'world',\n        asia: 'world',\n        oceania: 'world',\n        africa: 'world',\n        'middle-east': 'world',\n        'latin-america': 'americas',\n        caribbean: 'americas',\n        'central-america': 'americas',\n        'south-america': 'americas',\n        'north-america': 'americas',\n        nordics: 'europe',\n        baltic: 'europe',\n        balkans: 'europe',\n        'eastern-europe': 'europe',\n        'western-europe': 'europe',\n        'central-europe': 'europe',\n        'eastern-africa': 'africa',\n        'western-africa': 'africa',\n        'central-africa': 'africa',\n        'north-africa': 'africa',\n        'south-africa': 'africa',\n        'middle-africa': 'africa',\n        'southeast-asia': 'asia'\n      }\n    }\n  }\n];\n\n/**\n * Example extended qualifiers.\n * @public\n */\nexport const ExtendedQualifiers: ReadonlyArray<Qualifiers.IQualifierDecl> = [\n  {\n    name: 'homeTerritory',\n    token: 'home',\n    typeName: 'territory',\n    defaultPriority: 900\n  },\n  {\n    name: 'currentTerritory',\n    token: 'geo',\n    typeName: 'territory',\n    defaultPriority: 850\n  },\n  {\n    name: 'language',\n    token: 'lang',\n    typeName: 'language',\n    defaultPriority: 800\n  },\n  {\n    name: 'market',\n    typeName: 'market',\n    defaultPriority: 750\n  },\n  {\n    name: 'role',\n    typeName: 'role',\n    defaultPriority: 700\n  },\n  {\n    name: 'environment',\n    token: 'env',\n    typeName: 'environment',\n    defaultPriority: 650\n  },\n  {\n    name: 'currency',\n    typeName: 'currency',\n    defaultPriority: 600\n  }\n];\n\n/**\n * Example resource types.\n * @public\n */\nexport const ExtendedResourceTypes: ReadonlyArray<ResourceTypes.Config.IResourceTypeConfig> = [\n  {\n    name: 'json',\n    typeName: 'json'\n  }\n];\n\n/**\n * An example system configuration demonstrating various configuration options.\n * @public\n */\nexport const ExtendedSystemConfiguration: ISystemConfiguration = {\n  name: 'extended-example',\n  description: 'An example system configuration demonstrating various configuration options',\n  qualifierTypes: [...ExtendedQualifierTypes],\n  qualifiers: [...ExtendedQualifiers],\n  resourceTypes: [...ExtendedResourceTypes]\n};\n"]}

package/lib/packlets/config/predefined/index.d.ts

@@ -0,0 +1,4 @@
+import * as Default from './default';
+import * as Example from './extended';
+export { Default, Example };
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/config/predefined/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/config/predefined/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/lib/packlets/config/predefined/index.js

@@ -0,0 +1,62 @@
+"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.Example = exports.Default = void 0;
+const Default = __importStar(require("./default"));
+exports.Default = Default;
+const Example = __importStar(require("./extended"));
+exports.Example = Example;
+//# sourceMappingURL=index.js.map

package/lib/packlets/config/predefined/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/config/predefined/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AAG5B,0BAAO;AAFhB,oDAAsC;AAEpB,0BAAO","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 Default from './default';\nimport * as Example from './extended';\n\nexport { Default, Example };\n"]}

package/lib/packlets/config/systemConfiguration.d.ts

@@ -0,0 +1,81 @@
+import { Result } from '@fgv/ts-utils';
+import { ReadOnlyQualifierTypeCollector } from '../qualifier-types';
+import { IReadOnlyQualifierCollector } from '../qualifiers';
+import { ReadOnlyResourceTypeCollector } from '../resource-types';
+import { ISystemConfiguration } from './json';
+/**
+ * Parameters used to initialize a {@link Config.SystemConfiguration | SystemConfiguration}.
+ * @public
+ */
+export interface ISystemConfigurationInitParams {
+    /**
+     * Optional map of qualifier names to default values. If provided, qualifiers
+     * in the system configuration will be updated with these default values.
+     * Use `null` as the value to remove an existing default value.
+     */
+    qualifierDefaultValues?: Record<string, string | null>;
+}
+/**
+ * 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
+ */
+export declare function updateSystemConfigurationQualifierDefaultValues(config: ISystemConfiguration, qualifierDefaultValues: Record<string, string | null>): Result<ISystemConfiguration>;
+/**
+ * A system configuration for both runtime or build.
+ * @public
+ */
+export declare class SystemConfiguration {
+    /**
+     * The name of this system configuration.
+     */
+    get name(): string | undefined;
+    /**
+     * The description of this system configuration.
+     */
+    get description(): string | undefined;
+    /**
+     * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this system configuration uses.
+     */
+    readonly qualifierTypes: ReadOnlyQualifierTypeCollector;
+    /**
+     * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this system configuration uses.
+     * @public
+     */
+    readonly qualifiers: IReadOnlyQualifierCollector;
+    /**
+     * The {@link ResourceTypes.ResourceTypeCollector | resource types} that this system configuration uses.
+     */
+    readonly resourceTypes: ReadOnlyResourceTypeCollector;
+    private readonly _config;
+    /**
+     * 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
+     */
+    protected constructor(config: ISystemConfiguration);
+    /**
+     * 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: ISystemConfiguration, initParams?: ISystemConfigurationInitParams): Result<SystemConfiguration>;
+    /**
+     * 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(): Result<ISystemConfiguration>;
+}
+//# sourceMappingURL=systemConfiguration.d.ts.map

package/lib/packlets/config/systemConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemConfiguration.d.ts","sourceRoot":"","sources":["../../../src/packlets/config/systemConfiguration.ts"],"names":[],"mappings":"AAsBA,OAAO,EAA6B,MAAM,EAAiB,MAAM,eAAe,CAAC;AAGjF,OAAO,EAA0B,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAsB,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAyB,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAI9C;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,+CAA+C,CAC7D,MAAM,EAAE,oBAAoB,EAC5B,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GACpD,MAAM,CAAC,oBAAoB,CAAC,CAoC9B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,SAAgB,cAAc,EAAE,8BAA8B,CAAC;IAE/D;;;OAGG;IACH,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IAExD;;OAEG;IACH,SAAgB,aAAa,EAAE,6BAA6B,CAAC;IAE7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C;;;;;OAKG;IACH,SAAS,aAAa,MAAM,EAAE,oBAAoB;IAqBlD;;;;;;;;OAQG;WACW,MAAM,CAClB,MAAM,EAAE,oBAAoB,EAC5B,UAAU,CAAC,EAAE,8BAA8B,GAC1C,MAAM,CAAC,mBAAmB,CAAC;IAU9B;;;;;;OAMG;IACI,SAAS,IAAI,MAAM,CAAC,oBAAoB,CAAC;CAGjD"}

package/lib/packlets/config/systemConfiguration.js

@@ -0,0 +1,172 @@
+"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.SystemConfiguration = void 0;
+exports.updateSystemConfigurationQualifierDefaultValues = updateSystemConfigurationQualifierDefaultValues;
+const ts_utils_1 = require("@fgv/ts-utils");
+const QualifierTypes = __importStar(require("../qualifier-types"));
+const ResourceTypes = __importStar(require("../resource-types"));
+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");
+/**
+ * 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) {
+        this._config = config;
+        this.qualifierTypes = qualifier_types_1.QualifierTypeCollector.create({
+            qualifierTypes: (0, ts_utils_1.mapResults)(config.qualifierTypes.map(QualifierTypes.createQualifierTypeFromSystemConfig)).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(ResourceTypes.createResourceTypeFromConfig)).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) {
+            return updateSystemConfigurationQualifierDefaultValues(config, initParams.qualifierDefaultValues).onSuccess((updatedConfig) => (0, ts_utils_1.captureResult)(() => new SystemConfiguration(updatedConfig)));
+        }
+        return (0, ts_utils_1.captureResult)(() => new SystemConfiguration(config));
+    }
+    /**
+     * 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/config/systemConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemConfiguration.js","sourceRoot":"","sources":["../../../src/packlets/config/systemConfiguration.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 { captureResult, mapResults, Result, fail, succeed } from '@fgv/ts-utils';\nimport * as QualifierTypes from '../qualifier-types';\nimport * as ResourceTypes from '../resource-types';\nimport { QualifierTypeCollector, ReadOnlyQualifierTypeCollector } from '../qualifier-types';\nimport { IReadOnlyQualifierCollector, QualifierCollector } from '../qualifiers';\nimport { ReadOnlyResourceTypeCollector, ResourceTypeCollector } from '../resource-types';\nimport { ISystemConfiguration } from './json';\nimport { systemConfiguration } from './convert';\nimport { sanitizeJsonObject } from '@fgv/ts-json-base';\n\n/**\n * Parameters used to initialize a {@link Config.SystemConfiguration | SystemConfiguration}.\n * @public\n */\nexport interface ISystemConfigurationInitParams {\n  /**\n   * Optional map of qualifier names to default values. If provided, qualifiers\n   * in the system configuration will be updated with these default values.\n   * Use `null` as the value to remove an existing default value.\n   */\n  qualifierDefaultValues?: Record<string, string | null>; // eslint-disable-line @rushstack/no-new-null\n}\n\n/**\n * Creates a copy of the provided {@link Config.Model.ISystemConfiguration | system configuration}\n * with updated qualifier default values.\n * @param config - The base {@link Config.Model.ISystemConfiguration | system configuration} to copy.\n * @param qualifierDefaultValues - Map of qualifier names to default values. Use `null` to remove existing values.\n * @returns `Success` with the updated {@link Config.Model.ISystemConfiguration | system configuration}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function updateSystemConfigurationQualifierDefaultValues(\n  config: ISystemConfiguration,\n  qualifierDefaultValues: Record<string, string | null> // eslint-disable-line @rushstack/no-new-null\n): Result<ISystemConfiguration> {\n  // Create a copy of the config\n  return sanitizeJsonObject<ISystemConfiguration>(config).onSuccess((updatedConfig) => {\n    // Create a map of existing qualifier names for validation\n    const existingQualifierNames = new Set(updatedConfig.qualifiers.map((q) => q.name));\n\n    // Validate that all specified qualifiers exist in the configuration\n    for (const qualifierName of Object.keys(qualifierDefaultValues)) {\n      if (!existingQualifierNames.has(qualifierName)) {\n        return fail(`Qualifier '${qualifierName}' not found in system configuration`);\n      }\n    }\n\n    // Update qualifier default values\n    updatedConfig.qualifiers = updatedConfig.qualifiers.map((qualifier) => {\n      if (qualifier.name in qualifierDefaultValues) {\n        const newDefaultValue = qualifierDefaultValues[qualifier.name];\n\n        // Create a copy of the qualifier\n        const updatedQualifier = { ...qualifier };\n\n        if (newDefaultValue === null) {\n          // Remove the default value\n          delete updatedQualifier.defaultValue;\n        } else {\n          // Set the new default value\n          updatedQualifier.defaultValue = newDefaultValue;\n        }\n\n        return updatedQualifier;\n      }\n      return qualifier;\n    });\n\n    return succeed(updatedConfig);\n  });\n}\n\n/**\n * A system configuration for both runtime or build.\n * @public\n */\nexport class SystemConfiguration {\n  /**\n   * The name of this system configuration.\n   */\n  public get name(): string | undefined {\n    return this._config.name;\n  }\n\n  /**\n   * The description of this system configuration.\n   */\n  public get description(): string | undefined {\n    return this._config.description;\n  }\n\n  /**\n   * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this system configuration uses.\n   */\n  public readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * The {@link QualifierTypes.QualifierTypeCollector | qualifier types} that this system configuration uses.\n   * @public\n   */\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * The {@link ResourceTypes.ResourceTypeCollector | resource types} that this system configuration uses.\n   */\n  public readonly resourceTypes: ReadOnlyResourceTypeCollector;\n\n  private readonly _config: ISystemConfiguration;\n\n  /**\n   * Constructs a new instance of a {@link Config.SystemConfiguration | SystemConfiguration} from the\n   * supplied {@link Config.Model.ISystemConfiguration | system configuration}.\n   * @param config - The {@link Config.Model.ISystemConfiguration | system configuration} to use.\n   * @public\n   */\n  protected constructor(config: ISystemConfiguration) {\n    this._config = config;\n\n    this.qualifierTypes = QualifierTypeCollector.create({\n      qualifierTypes: mapResults(\n        config.qualifierTypes.map(QualifierTypes.createQualifierTypeFromSystemConfig)\n      ).orThrow()\n    }).orThrow();\n\n    this.qualifiers = QualifierCollector.create({\n      qualifierTypes: this.qualifierTypes,\n      qualifiers: config.qualifiers\n    }).orThrow();\n\n    this.resourceTypes = ResourceTypeCollector.create({\n      resourceTypes: mapResults(\n        config.resourceTypes.map(ResourceTypes.createResourceTypeFromConfig)\n      ).orThrow()\n    }).orThrow();\n  }\n\n  /**\n   * Creates a new {@link Config.SystemConfiguration | SystemConfiguration} from the supplied\n   * {@link Config.Model.ISystemConfiguration | system configuration}.\n   * @param config - The {@link Config.Model.ISystemConfiguration | system configuration} to use.\n   * @param initParams - Optional {@link Config.ISystemConfigurationInitParams | initialization parameters}.\n   * @returns `Success` with the new {@link Config.SystemConfiguration | SystemConfiguration}\n   * if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public static create(\n    config: ISystemConfiguration,\n    initParams?: ISystemConfigurationInitParams\n  ): Result<SystemConfiguration> {\n    if (initParams?.qualifierDefaultValues) {\n      return updateSystemConfigurationQualifierDefaultValues(\n        config,\n        initParams.qualifierDefaultValues\n      ).onSuccess((updatedConfig) => captureResult(() => new SystemConfiguration(updatedConfig)));\n    }\n    return captureResult(() => new SystemConfiguration(config));\n  }\n\n  /**\n   * Returns the {@link Config.Model.ISystemConfiguration | system configuration} that this\n   * {@link Config.SystemConfiguration | SystemConfiguration} was created from.\n   * @returns `Success` with the {@link Config.Model.ISystemConfiguration | system configuration}\n   * if successful, `Failure` with an error message otherwise.\n   * @public\n   */\n  public getConfig(): Result<ISystemConfiguration> {\n    return systemConfiguration.convert(this._config);\n  }\n}\n"]}

package/lib/packlets/context/contextDecls.d.ts

@@ -0,0 +1,49 @@
+import { QualifierContextValue, QualifierName } from '../common';
+import { Qualifier } from '../qualifiers';
+/**
+ * Options to control matching of conditions against a context.
+ * @public
+ */
+export interface IContextMatchOptions {
+    /**
+     * If true, then conditions which would otherwise yield
+     * {@link NoMatch | NoMatch} but have a defined {@link Conditions.Condition.scoreAsDefault | scoreAsDefault}
+     * will yield `scoreAsDefault`instead of `NoMatch`.
+     */
+    acceptDefaultScore?: boolean;
+    /**
+     * If true, then conditions for which a corresponding values is not present in the
+     * context being matched will yield `undefined` instead of `NoMatch`.
+     */
+    partialContextMatch?: boolean;
+}
+/**
+ * Non-validated declaration of a single context qualifier value.
+ * @public
+ */
+export interface IContextQualifierValueDecl {
+    qualifier: string;
+    value: string;
+}
+/**
+ * Non-validated declaration of a context, consisting of named
+ * values.
+ * @public
+ */
+export type IContextDecl = Record<string, string>;
+/**
+ * Validated declaration of a single context qualifier value.
+ * @public
+ */
+export interface IValidatedContextQualifierValueDecl {
+    qualifier: Qualifier;
+    value: QualifierContextValue;
+}
+/**
+ * Validated declaration of a context, a record with strongly-typed
+ * {@link QualifierTypeName | qualifier type names} as keys and
+ * {@link QualifierContextValue | qualifier context values} as values.
+ * @public
+ */
+export type IValidatedContextDecl = Record<QualifierName, QualifierContextValue>;
+//# sourceMappingURL=contextDecls.d.ts.map

package/lib/packlets/context/contextDecls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextDecls.d.ts","sourceRoot":"","sources":["../../../src/packlets/context/contextDecls.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC"}

package/lib/packlets/context/contextDecls.js

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