@fgv/ts-res 4.5.0-0

package/lib/packlets/common/helpers/conditions.d.ts

@@ -0,0 +1,39 @@
+import { Result } from '@fgv/ts-utils';
+import { ConditionSetToken, ConditionToken } from '../conditions';
+/**
+ * The values needed to create a {@link ConditionToken | condition token}.
+ * @public
+ */
+export interface IConditionTokenParts {
+    qualifier?: string;
+    value: string;
+}
+/**
+ * Converts a {@link Helpers.IConditionTokenParts | the parts that make up a condition token} into
+ * a syntactically validated {@link ConditionToken | condition token}.
+ * @param parts - the parts to convert
+ * @public
+ */
+export declare function buildConditionToken({ qualifier, value }: IConditionTokenParts): Result<ConditionToken>;
+/**
+ * Converts an array of {@link Helpers.IConditionTokenParts | condition token parts} into an array of
+ * syntactically validated {@link ConditionToken | condition tokens}.
+ * @param parts - the parts to convert
+ * @public
+ */
+export declare function buildConditionSetToken(parts: ReadonlyArray<IConditionTokenParts>): Result<ConditionSetToken>;
+/**
+ * Parses a condition token string into its {@link Helpers.IConditionTokenParts | parts}.
+ * @param token - the token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+export declare function parseConditionTokenParts(token: string): Result<IConditionTokenParts>;
+/**
+ * Parses a condition set token string into an array of {@link Helpers.IConditionTokenParts | condition token parts}.
+ * @param token - the conditions set token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+export declare function parseConditionSetTokenParts(token: string): Result<IConditionTokenParts[]>;
+//# sourceMappingURL=conditions.d.ts.map

package/lib/packlets/common/helpers/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/conditions.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAW,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,oBAAoB,GAAG,MAAM,CAAC,cAAc,CAAC,CAEtG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,oBAAoB,CAAC,GACzC,MAAM,CAAC,iBAAiB,CAAC,CAI3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAQpF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAEzF"}

package/lib/packlets/common/helpers/conditions.js

@@ -0,0 +1,105 @@
+"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.buildConditionToken = buildConditionToken;
+exports.buildConditionSetToken = buildConditionSetToken;
+exports.parseConditionTokenParts = parseConditionTokenParts;
+exports.parseConditionSetTokenParts = parseConditionSetTokenParts;
+const ts_utils_1 = require("@fgv/ts-utils");
+const Validate = __importStar(require("../validate"));
+/**
+ * Converts a {@link Helpers.IConditionTokenParts | the parts that make up a condition token} into
+ * a syntactically validated {@link ConditionToken | condition token}.
+ * @param parts - the parts to convert
+ * @public
+ */
+function buildConditionToken({ qualifier, value }) {
+    return Validate.toConditionToken(qualifier ? `${qualifier}=${value}` : value);
+}
+/**
+ * Converts an array of {@link Helpers.IConditionTokenParts | condition token parts} into an array of
+ * syntactically validated {@link ConditionToken | condition tokens}.
+ * @param parts - the parts to convert
+ * @public
+ */
+function buildConditionSetToken(parts) {
+    return (0, ts_utils_1.mapResults)(parts.map(buildConditionToken)).onSuccess((tokens) => Validate.toConditionSetToken(tokens.join(',')));
+}
+/**
+ * Parses a condition token string into its {@link Helpers.IConditionTokenParts | parts}.
+ * @param token - the token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+function parseConditionTokenParts(token) {
+    return Validate.toConditionToken(token).onSuccess((t) => {
+        const parts = t.split('=');
+        if (parts.length === 1) {
+            return (0, ts_utils_1.succeed)({ value: parts[0] });
+        }
+        return (0, ts_utils_1.succeed)({ qualifier: parts[0], value: parts[1] });
+    });
+}
+/**
+ * Parses a condition set token string into an array of {@link Helpers.IConditionTokenParts | condition token parts}.
+ * @param token - the conditions set token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+function parseConditionSetTokenParts(token) {
+    return (0, ts_utils_1.mapResults)(token.split(',').map(parseConditionTokenParts));
+}
+//# sourceMappingURL=conditions.js.map

package/lib/packlets/common/helpers/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/conditions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBH,kDAEC;AAQD,wDAMC;AAQD,4DAQC;AAQD,kEAEC;AA7DD,4CAA4D;AAC5D,sDAAwC;AAYxC;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAwB;IAC5E,OAAO,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,KAA0C;IAE1C,OAAO,IAAA,qBAAU,EAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CACrE,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,KAAa;IACpD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAA,kBAAO,EAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAA,kBAAO,EAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,KAAa;IACvD,OAAO,IAAA,qBAAU,EAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;AACpE,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 { mapResults, Result, succeed } from '@fgv/ts-utils';\nimport * as Validate from '../validate';\nimport { ConditionSetToken, ConditionToken } from '../conditions';\n\n/**\n * The values needed to create a {@link ConditionToken | condition token}.\n * @public\n */\nexport interface IConditionTokenParts {\n  qualifier?: string;\n  value: string;\n}\n\n/**\n * Converts a {@link Helpers.IConditionTokenParts | the parts that make up a condition token} into\n * a syntactically validated {@link ConditionToken | condition token}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildConditionToken({ qualifier, value }: IConditionTokenParts): Result<ConditionToken> {\n  return Validate.toConditionToken(qualifier ? `${qualifier}=${value}` : value);\n}\n\n/**\n * Converts an array of {@link Helpers.IConditionTokenParts | condition token parts} into an array of\n * syntactically validated {@link ConditionToken | condition tokens}.\n * @param parts - the parts to convert\n * @public\n */\nexport function buildConditionSetToken(\n  parts: ReadonlyArray<IConditionTokenParts>\n): Result<ConditionSetToken> {\n  return mapResults(parts.map(buildConditionToken)).onSuccess((tokens) =>\n    Validate.toConditionSetToken(tokens.join(','))\n  );\n}\n\n/**\n * Parses a condition token string into its {@link Helpers.IConditionTokenParts | parts}.\n * @param token - the token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseConditionTokenParts(token: string): Result<IConditionTokenParts> {\n  return Validate.toConditionToken(token).onSuccess((t) => {\n    const parts = t.split('=');\n    if (parts.length === 1) {\n      return succeed({ value: parts[0] });\n    }\n    return succeed({ qualifier: parts[0], value: parts[1] });\n  });\n}\n\n/**\n * Parses a condition set token string into an array of {@link Helpers.IConditionTokenParts | condition token parts}.\n * @param token - the conditions set token string to parse.\n * @returns `Success` with the parts if successful, `Failure` with an error message if not.\n * @public\n */\nexport function parseConditionSetTokenParts(token: string): Result<IConditionTokenParts[]> {\n  return mapResults(token.split(',').map(parseConditionTokenParts));\n}\n"]}

package/lib/packlets/common/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './conditions';
+export * from './resources';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/common/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/index.ts"],"names":[],"mappings":"AAsBA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/lib/packlets/common/helpers/index.js

@@ -0,0 +1,40 @@
+"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 __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 });
+__exportStar(require("./conditions"), exports);
+__exportStar(require("./resources"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/common/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,8CAA4B","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 './conditions';\nexport * from './resources';\n"]}

package/lib/packlets/common/helpers/resources.d.ts

@@ -0,0 +1,34 @@
+import { Result } from '@fgv/ts-utils';
+import { ResourceId, ResourceName } from '../resources';
+/**
+ * Splits a {@link ResourceId | resource id} into its component {@link ResourceName | resource names}.
+ *
+ * @param id - The ID to split.
+ * @returns `Success`with an array of {@link ResourceName | ResourceName} objects if the ID is valid, or
+ * `Failure` with an error message if not.
+ * @public
+ */
+export declare function splitResourceId(id: string | undefined): Result<ResourceName[]>;
+/**
+ * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
+ * to create a new {@link ResourceId | resource ID}. Fails if resulting ID is invalid or empty.
+ *
+ * @param base - The base name or ID to join.
+ * @param names - Additional names to join.
+ * @returns `Success` with the new ID if the base and names are valid, or `Failure` with an error message
+ * if not.
+ * @public
+ */
+export declare function joinResourceIds(...ids: (string | undefined)[]): Result<ResourceId>;
+/**
+ * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
+ * to create a new {@link ResourceId | resource ID}. Returns `undefined` if no names are defined.
+ *
+ * @param base - The base name or ID to join.
+ * @param names - Additional names to join.
+ * @returns `Success` with the new ID if the base and names are valid, `Success` with `undefined`
+ * if names were present, or `Failure` with an error message if the resulting id is invalid.
+ * @public
+ */
+export declare function joinOptionalResourceIds(...ids: (string | undefined)[]): Result<ResourceId | undefined>;
+//# sourceMappingURL=resources.d.ts.map

package/lib/packlets/common/helpers/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/resources.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAqB,MAAM,EAAuB,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGxD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,CAK9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAQlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,CAQtG"}

package/lib/packlets/common/helpers/resources.js

@@ -0,0 +1,81 @@
+"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.splitResourceId = splitResourceId;
+exports.joinResourceIds = joinResourceIds;
+exports.joinOptionalResourceIds = joinOptionalResourceIds;
+const ts_utils_1 = require("@fgv/ts-utils");
+const resources_1 = require("../validate/resources");
+/**
+ * Splits a {@link ResourceId | resource id} into its component {@link ResourceName | resource names}.
+ *
+ * @param id - The ID to split.
+ * @returns `Success`with an array of {@link ResourceName | ResourceName} objects if the ID is valid, or
+ * `Failure` with an error message if not.
+ * @public
+ */
+function splitResourceId(id) {
+    if (id === undefined) {
+        return (0, ts_utils_1.succeed)([]);
+    }
+    return (0, ts_utils_1.mapResults)(id.split('.').map(resources_1.toResourceName));
+}
+/**
+ * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
+ * to create a new {@link ResourceId | resource ID}. Fails if resulting ID is invalid or empty.
+ *
+ * @param base - The base name or ID to join.
+ * @param names - Additional names to join.
+ * @returns `Success` with the new ID if the base and names are valid, or `Failure` with an error message
+ * if not.
+ * @public
+ */
+function joinResourceIds(...ids) {
+    const errors = new ts_utils_1.MessageAggregator();
+    const parts = [];
+    ids.forEach((id) => {
+        parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));
+    });
+    const id = parts.join('.');
+    return errors.returnOrReport((0, resources_1.toResourceId)(id));
+}
+/**
+ * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with
+ * to create a new {@link ResourceId | resource ID}. Returns `undefined` if no names are defined.
+ *
+ * @param base - The base name or ID to join.
+ * @param names - Additional names to join.
+ * @returns `Success` with the new ID if the base and names are valid, `Success` with `undefined`
+ * if names were present, or `Failure` with an error message if the resulting id is invalid.
+ * @public
+ */
+function joinOptionalResourceIds(...ids) {
+    const errors = new ts_utils_1.MessageAggregator();
+    const parts = [];
+    ids.forEach((id) => {
+        parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));
+    });
+    const id = parts.join('.');
+    return errors.returnOrReport(id ? (0, resources_1.toResourceId)(id) : (0, ts_utils_1.succeed)(undefined));
+}
+//# sourceMappingURL=resources.js.map

package/lib/packlets/common/helpers/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../../src/packlets/common/helpers/resources.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAcH,0CAKC;AAYD,0CAQC;AAYD,0DAQC;AAzDD,4CAA+E;AAE/E,qDAAqE;AAErE;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,EAAsB;IACpD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,IAAA,kBAAO,EAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAA,qBAAU,EAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,0BAAc,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAAC,GAAG,GAA2B;IAC5D,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,cAAc,CAAC,IAAA,wBAAY,EAAC,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CAAC,GAAG,GAA2B;IACpE,MAAM,MAAM,GAAsB,IAAI,4BAAiB,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,IAAA,wBAAY,EAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC,CAAC;AAC3E,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 { MessageAggregator, Result, mapResults, succeed } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName } from '../resources';\nimport { toResourceId, toResourceName } from '../validate/resources';\n\n/**\n * Splits a {@link ResourceId | resource id} into its component {@link ResourceName | resource names}.\n *\n * @param id - The ID to split.\n * @returns `Success`with an array of {@link ResourceName | ResourceName} objects if the ID is valid, or\n * `Failure` with an error message if not.\n * @public\n */\nexport function splitResourceId(id: string | undefined): Result<ResourceName[]> {\n  if (id === undefined) {\n    return succeed([]);\n  }\n  return mapResults(id.split('.').map(toResourceName));\n}\n\n/**\n * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with\n * to create a new {@link ResourceId | resource ID}. Fails if resulting ID is invalid or empty.\n *\n * @param base - The base name or ID to join.\n * @param names - Additional names to join.\n * @returns `Success` with the new ID if the base and names are valid, or `Failure` with an error message\n * if not.\n * @public\n */\nexport function joinResourceIds(...ids: (string | undefined)[]): Result<ResourceId> {\n  const errors: MessageAggregator = new MessageAggregator();\n  const parts: ResourceName[] = [];\n  ids.forEach((id) => {\n    parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));\n  });\n  const id = parts.join('.');\n  return errors.returnOrReport(toResourceId(id));\n}\n\n/**\n * Joins a list of {@link ResourceId | resource ID} or {@link ResourceName | resource name} with\n * to create a new {@link ResourceId | resource ID}. Returns `undefined` if no names are defined.\n *\n * @param base - The base name or ID to join.\n * @param names - Additional names to join.\n * @returns `Success` with the new ID if the base and names are valid, `Success` with `undefined`\n * if names were present, or `Failure` with an error message if the resulting id is invalid.\n * @public\n */\nexport function joinOptionalResourceIds(...ids: (string | undefined)[]): Result<ResourceId | undefined> {\n  const errors: MessageAggregator = new MessageAggregator();\n  const parts: ResourceName[] = [];\n  ids.forEach((id) => {\n    parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));\n  });\n  const id = parts.join('.');\n  return errors.returnOrReport(id ? toResourceId(id) : succeed(undefined));\n}\n"]}

package/lib/packlets/common/index.d.ts

@@ -0,0 +1,7 @@
+import * as Convert from './convert';
+import * as Helpers from './helpers';
+import * as Validate from './validate';
+export * from './conditions';
+export * from './resources';
+export { Convert, Helpers, Validate };
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/common/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AAEvC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/lib/packlets/common/index.js

@@ -0,0 +1,69 @@
+"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.Validate = exports.Helpers = exports.Convert = void 0;
+const Convert = __importStar(require("./convert"));
+exports.Convert = Convert;
+const Helpers = __importStar(require("./helpers"));
+exports.Helpers = Helpers;
+const Validate = __importStar(require("./validate"));
+exports.Validate = Validate;
+__exportStar(require("./conditions"), exports);
+__exportStar(require("./resources"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/common/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AAO5B,0BAAO;AANhB,mDAAqC;AAMnB,0BAAO;AALzB,qDAAuC;AAKZ,4BAAQ;AAHnC,+CAA6B;AAC7B,8CAA4B","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';\nimport * as Helpers from './helpers';\nimport * as Validate from './validate';\n\nexport * from './conditions';\nexport * from './resources';\n\nexport { Convert, Helpers, Validate };\n"]}

package/lib/packlets/common/resources.d.ts

@@ -0,0 +1,41 @@
+import { Brand } from '@fgv/ts-utils';
+/**
+ * Branded string representing a validated resource id.  A resource ID
+ * is a dot-separated sequence of resource names.
+ * @public
+ */
+export type ResourceId = Brand<string, 'ResourceId'>;
+/**
+ * Branded string representing a validated resource name.
+ * @public
+ */
+export type ResourceName = Brand<string, 'ResourceName'>;
+/**
+ * Branded number representing a validated resource index.
+ * @public
+ */
+export type ResourceIndex = Brand<number, 'ResourceIndex'>;
+/**
+ * Branded string representing a validated resource type name.
+ * @public
+ */
+export type ResourceTypeName = Brand<string, 'ResourceTypeName'>;
+/**
+ * Branded number representing a validated resource type index.
+ * @public
+ */
+export type ResourceTypeIndex = Brand<number, 'ResourceTypeIndex'>;
+/**
+ * Type representing the possible ways that a resource value can be merged into an existing resource.
+ * - 'augment' means that the new value should be merged into the existing value, with new properties added and existing properties updated.
+ * - 'delete' means that the existing values should be deleted.
+ * - 'replace' means that the new value should replace the existing value.
+ * @public
+ */
+export type ResourceValueMergeMethod = 'augment' | 'delete' | 'replace';
+/**
+ * Array of all possible {@link ResourceValueMergeMethod | resource merge type} values.
+ * @public
+ */
+export declare const allResourceValueMergeMethods: ResourceValueMergeMethod[];
+//# sourceMappingURL=resources.d.ts.map

package/lib/packlets/common/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/packlets/common/resources.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,wBAAwB,EAAqC,CAAC"}

package/lib/packlets/common/resources.js

@@ -0,0 +1,30 @@
+"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.allResourceValueMergeMethods = void 0;
+/**
+ * Array of all possible {@link ResourceValueMergeMethod | resource merge type} values.
+ * @public
+ */
+exports.allResourceValueMergeMethods = ['augment', 'delete', 'replace'];
+//# sourceMappingURL=resources.js.map

package/lib/packlets/common/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/packlets/common/resources.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AA4CH;;;GAGG;AACU,QAAA,4BAA4B,GAA+B,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,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 { Brand } from '@fgv/ts-utils';\n\n/**\n * Branded string representing a validated resource id.  A resource ID\n * is a dot-separated sequence of resource names.\n * @public\n */\nexport type ResourceId = Brand<string, 'ResourceId'>;\n\n/**\n * Branded string representing a validated resource name.\n * @public\n */\nexport type ResourceName = Brand<string, 'ResourceName'>;\n\n/**\n * Branded number representing a validated resource index.\n * @public\n */\nexport type ResourceIndex = Brand<number, 'ResourceIndex'>;\n\n/**\n * Branded string representing a validated resource type name.\n * @public\n */\nexport type ResourceTypeName = Brand<string, 'ResourceTypeName'>;\n\n/**\n * Branded number representing a validated resource type index.\n * @public\n */\nexport type ResourceTypeIndex = Brand<number, 'ResourceTypeIndex'>;\n\n/**\n * Type representing the possible ways that a resource value can be merged into an existing resource.\n * - 'augment' means that the new value should be merged into the existing value, with new properties added and existing properties updated.\n * - 'delete' means that the existing values should be deleted.\n * - 'replace' means that the new value should replace the existing value.\n * @public\n */\nexport type ResourceValueMergeMethod = 'augment' | 'delete' | 'replace';\n\n/**\n * Array of all possible {@link ResourceValueMergeMethod | resource merge type} values.\n * @public\n */\nexport const allResourceValueMergeMethods: ResourceValueMergeMethod[] = ['augment', 'delete', 'replace'];\n"]}