@fgv/ts-res 5.0.1-9 → 5.0.2-0

package/dist/packlets/bundle/index.js

@@ -0,0 +1,42 @@
+/*
+ * 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.
+ */
+/**
+ * Bundle packlet providing functionality for creating and loading resource bundles.
+ *
+ * Resource bundles encapsulate compiled resources, configuration, and metadata with
+ * integrity verification. They provide a portable way to distribute pre-compiled
+ * resource collections.
+ *
+ * @packageDocumentation
+ */
+import * as Model from './model';
+import * as Convert from './convert';
+// Builder and loader classes
+export { BundleBuilder } from './bundleBuilder';
+export { BundleLoader } from './bundleLoader';
+// Utilities
+export { BundleUtils } from './bundleUtils';
+export { Model, Convert };
+// Internal utilities (not part of public API)
+/** @internal */
+export { BundleNormalizer } from './bundleNormalizer';
+//# sourceMappingURL=index.js.map

package/dist/packlets/bundle/model.js

@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=model.js.map

package/dist/packlets/common/conditions.js

@@ -0,0 +1,47 @@
+/*
+ * 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.
+ */
+/**
+ * {@link QualifierMatchScore | Match score} indicating no match.
+ * @public
+ */
+export const NoMatch = 0.0;
+/**
+ * {@link QualifierMatchScore | Match score} indicating a perfect match.
+ * @public
+ */
+export const PerfectMatch = 1.0;
+/**
+ * Minimum valid priority for a condition.
+ * @public
+ */
+export const MinConditionPriority = 0;
+/**
+ * Maximum valid priority for a condition.
+ * @public
+ */
+export const MaxConditionPriority = 1000;
+/**
+ * Array of all valid condition operators.
+ * @public
+ */
+export const allConditionOperators = ['always', 'never', 'matches'];
+//# sourceMappingURL=conditions.js.map

package/dist/packlets/common/convert.js

@@ -0,0 +1,172 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { Converters } from '@fgv/ts-utils';
+import * as Validate from './validate';
+import { allConditionOperators } from './conditions';
+import { allResourceValueMergeMethods } from './resources';
+/* eslint-disable @rushstack/typedef-var */
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierName | QualifierName}.
+ * @public
+ */
+export const qualifierName = Converters.string.map(Validate.toQualifierName);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierIndex | QualifierIndex}.
+ * @public
+ */
+export const qualifierIndex = Converters.number.map(Validate.toQualifierIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierTypeName | QualifierTypeName}.
+ * @public
+ */
+export const qualifierTypeName = Converters.string.map(Validate.toQualifierTypeName);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierTypeIndex | QualifierTypeIndex}.
+ * @public
+ */
+export const qualifierTypeIndex = Converters.number.map(Validate.toQualifierTypeIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierContextValue | QualifierContextValue}.
+ * @public
+ */
+export const qualifierContextValue = Converters.string.map(Validate.toQualifierContextValue);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierConditionValue | QualifierConditionValue}.
+ * @public
+ */
+export const qualifierMatchScore = Converters.number.map(Validate.toQualifierMatchScore);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionPriority | ConditionPriority}.
+ * @public
+ */
+export const conditionPriority = Converters.number.map(Validate.toConditionPriority);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionOperator | ConditionOperator}.
+ * @public
+ */
+export const conditionOperator = Converters.enumeratedValue(allConditionOperators);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionIndex | ConditionIndex}.
+ * @public
+ */
+export const conditionIndex = Converters.number.map(Validate.toConditionIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionKey | ConditionKey}.
+ * @public
+ */
+export const conditionKey = Converters.string.map(Validate.toConditionKey);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionToken | ConditionToken}.
+ * @public
+ */
+export const conditionToken = Converters.string.map(Validate.toConditionToken);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionSetIndex | ConditionSetIndex}.
+ * @public
+ */
+export const conditionSetIndex = Converters.number.map(Validate.toConditionSetIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionSetKey | ConditionSetKey}.
+ * @public
+ */
+export const conditionSetKey = Converters.string.map(Validate.toConditionSetKey);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionSetToken | ConditionSetToken}.
+ * @public
+ */
+export const conditionSetToken = Converters.string.map(Validate.toConditionSetToken);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ConditionSetHash | ConditionSetHash}.
+ * @public
+ */
+export const conditionSetHash = Converters.string.map(Validate.toConditionSetHash);
+/**
+ * `Converter` which validates an `unknown` value as a {@link DecisionIndex | DecisionIndex}.
+ * @public
+ */
+export const decisionIndex = Converters.number.map(Validate.toDecisionIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link DecisionKey | DecisionKey}.
+ * @public
+ */
+export const decisionKey = Converters.string.map(Validate.toDecisionKey);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ResourceId | ResourceId}.
+ * @public
+ */
+export const resourceId = Converters.string.map(Validate.toResourceId);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ResourceName | ResourceName}.
+ * @public
+ */
+export const resourceName = Converters.string.map(Validate.toResourceName);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ResourceIndex | ResourceIndex}.
+ * @public
+ */
+export const resourceIndex = Converters.number.map(Validate.toResourceIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ResourceTypeName | ResourceTypeName}.
+ * @public
+ */
+export const resourceTypeName = Converters.string.map(Validate.toResourceTypeName);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ResourceTypeIndex | ResourceTypeIndex}.
+ * @public
+ */
+export const resourceTypeIndex = Converters.number.map(Validate.toResourceTypeIndex);
+/**
+ * `Converter` which validates an `unknown` value as a {@link CandidateValueKey | CandidateValueKey}.
+ * @public
+ */
+export const candidateValueKey = Converters.string.map(Validate.toCandidateValueKey);
+/**
+ * `Converter` which validates an `unknown` value as a {@link CandidateValueIndex | CandidateValueIndex}.
+ * @public
+ */
+export const candidateValueIndex = Converters.number.map(Validate.toCandidateValueIndex);
+/**
+ * `Converter` for a resource value merge method.
+ * @public
+ */
+export const resourceValueMergeMethod = Converters.enumeratedValue(allResourceValueMergeMethods);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ContextQualifierToken | ContextQualifierToken}.
+ * @public
+ */
+export const contextQualifierToken = Converters.string.map(Validate.toContextQualifierToken);
+/**
+ * `Converter` which validates an `unknown` value as a {@link ContextToken | ContextToken}.
+ * @public
+ */
+export const contextToken = Converters.string.map(Validate.toContextToken);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierDefaultValueToken | QualifierDefaultValueToken}.
+ * @public
+ */
+export const qualifierDefaultValueToken = Converters.string.map(Validate.toQualifierDefaultValueToken);
+/**
+ * `Converter` which validates an `unknown` value as a {@link QualifierDefaultValuesToken | QualifierDefaultValuesToken}.
+ * @public
+ */
+export const qualifierDefaultValuesToken = Converters.string.map(Validate.toQualifierDefaultValuesToken);
+//# sourceMappingURL=convert.js.map

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

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { mapResults, succeed } from '@fgv/ts-utils';
+import * as Validate from '../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
+ */
+export 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
+ */
+export function buildConditionSetToken(parts) {
+    return 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
+ */
+export function parseConditionTokenParts(token) {
+    return Validate.toConditionToken(token).onSuccess((t) => {
+        const parts = t.split('=');
+        if (parts.length === 1) {
+            return succeed({ value: parts[0] });
+        }
+        return 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
+ */
+export function parseConditionSetTokenParts(token) {
+    return mapResults(token.split(',').map(parseConditionTokenParts));
+}
+//# sourceMappingURL=conditions.js.map

package/dist/packlets/common/helpers/context.js

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { mapResults, succeed } from '@fgv/ts-utils';
+import * as Validate from '../validate';
+/**
+ * Converts a {@link Helpers.IContextTokenParts | the parts that make up a context qualifier token} into
+ * a syntactically validated {@link ContextQualifierToken | context qualifier token}.
+ * @param parts - the parts to convert
+ * @public
+ */
+export function buildContextQualifierToken({ qualifier, value }) {
+    /* c8 ignore next 1 - edge case: ternary expression alternate branch rarely hit */
+    return Validate.toContextQualifierToken(qualifier ? `${qualifier}=${value}` : value);
+}
+/**
+ * Converts an array of {@link Helpers.IContextTokenParts | context qualifier token parts} into a
+ * syntactically validated {@link ContextToken | context token}.
+ * @param parts - the parts to convert
+ * @public
+ */
+export function buildContextToken(parts) {
+    return mapResults(parts.map(buildContextQualifierToken)).onSuccess((tokens) => Validate.toContextToken(tokens.join('|')));
+}
+/**
+ * Parses a context qualifier token string into its {@link Helpers.IContextTokenParts | parts}.
+ * @param token - the token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+export function parseContextQualifierTokenParts(token) {
+    return Validate.toContextQualifierToken(token).onSuccess((t) => {
+        const parts = t.split('=');
+        if (parts.length === 1) {
+            return succeed({ value: parts[0] });
+        }
+        return succeed({ qualifier: parts[0], value: parts[1] });
+    });
+}
+/**
+ * Parses a context token string into an array of {@link Helpers.IContextTokenParts | context qualifier token parts}.
+ * @param token - the context token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+export function parseContextTokenParts(token) {
+    if (token === '') {
+        return succeed([]);
+    }
+    return mapResults(token.split('|').map((part) => parseContextQualifierTokenParts(part.trim())));
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+export * from './conditions';
+export * from './context';
+export * from './qualifierDefaultValues';
+export * from './resources';
+//# sourceMappingURL=index.js.map

package/dist/packlets/common/helpers/qualifierDefaultValues.js

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { mapResults, succeed } from '@fgv/ts-utils';
+import * as Validate from '../validate';
+/**
+ * Converts a {@link Helpers.IQualifierDefaultValueTokenParts | the parts that make up a qualifier default value token} into
+ * a syntactically validated {@link QualifierDefaultValueToken | qualifier default value token}.
+ * @param parts - the parts to convert
+ * @public
+ */
+export function buildQualifierDefaultValueToken({ qualifier, value }) {
+    return Validate.toQualifierDefaultValueToken(`${qualifier}=${value}`);
+}
+/**
+ * Converts an array of {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts} into a
+ * syntactically validated {@link QualifierDefaultValuesToken | qualifier default values token}.
+ * @param parts - the parts to convert
+ * @public
+ */
+export function buildQualifierDefaultValuesToken(parts) {
+    return mapResults(parts.map(buildQualifierDefaultValueToken)).onSuccess((tokens) => Validate.toQualifierDefaultValuesToken(tokens.join('|')));
+}
+/**
+ * Parses a qualifier default value token string into its {@link Helpers.IQualifierDefaultValueTokenParts | parts}.
+ * @param token - the token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+export function parseQualifierDefaultValueTokenParts(token) {
+    return Validate.toQualifierDefaultValueToken(token).onSuccess((t) => {
+        const [qualifier, value] = t.split('=');
+        return succeed({ qualifier, value });
+    });
+}
+/**
+ * Parses a qualifier default values token string into an array of {@link Helpers.IQualifierDefaultValueTokenParts | qualifier default value token parts}.
+ * @param token - the qualifier default values token string to parse.
+ * @returns `Success` with the parts if successful, `Failure` with an error message if not.
+ * @public
+ */
+export function parseQualifierDefaultValuesTokenParts(token) {
+    if (token === '') {
+        return succeed([]);
+    }
+    return mapResults(token.split('|').map((part) => parseQualifierDefaultValueTokenParts(part.trim())));
+}
+//# sourceMappingURL=qualifierDefaultValues.js.map

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

@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { MessageAggregator, mapResults, succeed } from '@fgv/ts-utils';
+import { toResourceId, toResourceName } from '../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
+ */
+export function splitResourceId(id) {
+    /* c8 ignore next 3 - edge case: undefined resource ID should not occur in normal operation */
+    if (id === undefined) {
+        return succeed([]);
+    }
+    return mapResults(id.split('.').map(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
+ */
+export function joinResourceIds(...ids) {
+    const errors = new MessageAggregator();
+    const parts = [];
+    ids
+        .filter((id) => id !== '')
+        .forEach((id) => {
+        parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));
+    });
+    const id = parts.join('.');
+    return errors.returnOrReport(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
+ */
+export function joinOptionalResourceIds(...ids) {
+    const errors = new MessageAggregator();
+    const parts = [];
+    ids
+        .filter((id) => id !== '')
+        .forEach((id) => {
+        parts.push(...splitResourceId(id).aggregateError(errors).orDefault([]));
+    });
+    const id = parts.join('.');
+    return errors.returnOrReport(id ? toResourceId(id) : succeed(undefined));
+}
+/**
+ * Gets the name for a resource ID.
+ * @param id - The resource ID to get the name for.
+ * @returns `Success` with the resource name if found, or `Failure` with an error message if not.
+ * @public
+ */
+export function getNameForResourceId(id) {
+    return splitResourceId(id).onSuccess((parts) => {
+        /* c8 ignore next 1 - tested but coverage having issues */
+        return parts.length > 0 ? succeed(parts[parts.length - 1]) : fail(`${id}: invalid resource id`);
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/packlets/common/index.js

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

package/dist/packlets/common/resources.js

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