@fgv/ts-res 5.0.1-0 → 5.0.1-10

package/dist/packlets/resource-json/convert.js

@@ -0,0 +1,171 @@
+/*
+ * 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, mapResults, fail } from '@fgv/ts-utils';
+import { Convert as CommonConvert } from '../common';
+import { isJsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration}.
+ * @public
+ */
+export const looseConditionDecl = Converters.strictObject({
+    qualifierName: CommonConvert.qualifierName,
+    value: Converters.string,
+    operator: CommonConvert.conditionOperator.optional(),
+    priority: CommonConvert.conditionPriority.optional(),
+    scoreAsDefault: Converters.number.optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}.
+ * @public
+ */
+export const childConditionDecl = Converters.strictObject({
+    value: Converters.string,
+    operator: CommonConvert.conditionOperator.optional(),
+    priority: CommonConvert.conditionPriority.optional(),
+    scoreAsDefault: Converters.number.optional()
+});
+function _isConditionSetRecord(from) {
+    return isJsonObject(from);
+}
+const conditionSetDeclFromArray = Converters.arrayOf(looseConditionDecl);
+const conditionSetDeclFromRecord = Converters.generic((from, __self, context) => {
+    /* c8 ignore next 3 - this is tested but coverage is confused */
+    if (!_isConditionSetRecord(from)) {
+        return fail('Expected an object');
+    }
+    return mapResults(Array.from(Object.entries(from)).map(([qualifierName, value]) => {
+        const toConvert = typeof value === 'string' ? { qualifierName, value } : Object.assign({ qualifierName }, value);
+        return looseConditionDecl.convert(toConvert, context);
+    }));
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.
+ * @public
+ */
+export const conditionSetDecl = Converters.oneOf([conditionSetDeclFromArray, conditionSetDeclFromRecord]);
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.
+ * @public
+ */
+export const looseResourceCandidateDecl = Converters.strictObject({
+    id: CommonConvert.resourceId,
+    json: JsonConverters.jsonObject,
+    conditions: conditionSetDecl.optional(),
+    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),
+    isPartial: Converters.boolean.optional(),
+    resourceTypeName: CommonConvert.resourceTypeName.optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declaration}.
+ * @public
+ */
+export const importerResourceCandidateDecl = Converters.strictObject({
+    id: CommonConvert.resourceId.optional(),
+    json: JsonConverters.jsonObject,
+    conditions: conditionSetDecl.optional(),
+    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),
+    isPartial: Converters.boolean.optional(),
+    resourceTypeName: CommonConvert.resourceTypeName.optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.
+ * @public
+ */
+export const childResourceCandidateDecl = Converters.strictObject({
+    json: JsonConverters.jsonObject,
+    conditions: conditionSetDecl.optional(),
+    isPartial: Converters.boolean.optional(),
+    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declaration}.
+ * @public
+ */
+export const looseResourceDecl = Converters.strictObject({
+    id: CommonConvert.resourceId,
+    resourceTypeName: CommonConvert.resourceTypeName,
+    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IChildResourceDecl | child resource declaration}.
+ * @public
+ */
+export const childResourceDecl = Converters.strictObject({
+    resourceTypeName: CommonConvert.resourceTypeName,
+    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IContainerContextDecl | resource context declaration}.
+ * @public
+ */
+export const containerContextDecl = Converters.strictObject({
+    baseId: Converters.oneOf([CommonConvert.resourceId, Converters.literal('')]).optional(),
+    conditions: conditionSetDecl.optional(),
+    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.
+ * @public
+ */
+export const resourceTreeChildNodeDecl = Converters.generic((from, self, context) => {
+    return Converters.strictObject({
+        resources: Converters.recordOf(childResourceDecl).optional(),
+        children: Converters.recordOf(self).optional()
+    }).convert(from, context);
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}.
+ * @public
+ */
+export const resourceTreeRootDecl = Converters.strictObject({
+    context: containerContextDecl.optional(),
+    resources: Converters.recordOf(childResourceDecl).optional(),
+    children: Converters.recordOf(resourceTreeChildNodeDecl).optional()
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}.
+ * @public
+ */
+export const resourceCollectionDecl = Converters.generic((from, self, context) => {
+    return Converters.strictObject({
+        context: containerContextDecl.optional(),
+        candidates: Converters.arrayOf(looseResourceCandidateDecl).optional(),
+        resources: Converters.arrayOf(looseResourceDecl).optional(),
+        collections: Converters.arrayOf(self).optional(),
+        metadata: JsonConverters.jsonObject.optional()
+    }).convert(from, context);
+});
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCollectionDecl | importer resource collection declaration}.
+ * This allows for a mix of loose and child resource declarations.
+ * @public
+ */
+export const importerResourceCollectionDecl = Converters.generic((from, self, context) => {
+    return Converters.strictObject({
+        context: containerContextDecl.optional(),
+        candidates: Converters.arrayOf(importerResourceCandidateDecl).optional(),
+        resources: Converters.arrayOf(Converters.oneOf([looseResourceDecl, childResourceDecl])).optional(),
+        collections: Converters.arrayOf(self).optional(),
+        metadata: JsonConverters.jsonObject.optional()
+    }).convert(from, context);
+});
+//# sourceMappingURL=convert.js.map

package/dist/packlets/resource-json/helpers.js

@@ -0,0 +1,241 @@
+/*
+ * 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, fail, succeed } from '@fgv/ts-utils';
+import * as Json from './json';
+import { Helpers as CommonHelpers } from '../common';
+import { sanitizeJsonObject } from '@fgv/ts-json-base';
+/**
+ * Helper method to merge a resource context declaration with a parent name and conditions.
+ * @param decl - The resource context declaration to merge.
+ * @param parentName - The name of the parent resource.
+ * @param parentConditions - The conditions of the parent resource.
+ * @returns `Success` with the merged resource context declaration if successful, otherwise `Failure`.
+ * @public
+ */
+export function mergeContextDecl(decl, parentName, parentConditions) {
+    var _a, _b, _c;
+    if (!decl) {
+        return sanitizeJsonObject({ baseId: parentName, conditions: parentConditions });
+    }
+    else if (!parentName && !parentConditions) {
+        return succeed(decl);
+    }
+    switch ((_a = decl.mergeMethod) !== null && _a !== void 0 ? _a : 'augment') {
+        case 'augment':
+            return CommonHelpers.joinResourceIds(parentName, decl.baseId).onSuccess((baseId) => {
+                var _a;
+                /* c8 ignore next 1 - defense in depth */
+                const conditions = [...(parentConditions !== null && parentConditions !== void 0 ? parentConditions : []), ...((_a = decl.conditions) !== null && _a !== void 0 ? _a : [])];
+                return sanitizeJsonObject({ baseId, conditions });
+            });
+        case 'replace': {
+            const baseId = (_b = decl.baseId) !== null && _b !== void 0 ? _b : parentName;
+            const conditions = (_c = decl.conditions) !== null && _c !== void 0 ? _c : parentConditions;
+            return sanitizeJsonObject({ baseId, conditions });
+        }
+        case 'delete': {
+            return sanitizeJsonObject({});
+        }
+    }
+}
+/**
+ * Helper method to merge a loose candidate with a base name and conditions.
+ * @param candidate - The candidate to merge.
+ * @param baseName - The base name to merge with the candidate.
+ * @param baseConditions - The base conditions to merge with the candidate.
+ * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
+ * @public
+ */
+export function mergeLooseCandidate(candidate, baseName, baseConditions) {
+    const candidateId = Json.isLooseResourceCandidateDecl(candidate) ? candidate.id : '';
+    if (!Json.isLooseResourceCandidateDecl(candidate) && !baseName) {
+        return fail('id is required in mergeLooseCandidate');
+    }
+    /* c8 ignore next 7 - functional code tested but coverage intermittently missed */
+    return CommonHelpers.joinResourceIds(baseName, candidateId).onSuccess((id) => {
+        var _a;
+        /* c8 ignore next 1 - defense in depth */
+        const conditions = [...(baseConditions !== null && baseConditions !== void 0 ? baseConditions : []), ...((_a = candidate.conditions) !== null && _a !== void 0 ? _a : [])];
+        return succeed(Object.assign(Object.assign({}, candidate), { id, conditions }));
+    });
+}
+/**
+ * Helper method to merge a resource candidate with a base name and conditions from import context.
+ * This function enables name inheritance for resource candidates, similar to resources.
+ *
+ * @param candidate - The candidate to merge. Can have an optional ID that will be joined with baseName.
+ * @param baseName - The base name from import context to merge with the candidate.
+ * When provided, this will be used as the parent component of the candidate ID.
+ * @param baseConditions - The base conditions from import context to merge with the candidate's conditions.
+ * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
+ *
+ * @remarks
+ * This function supports name inheritance for candidates:
+ * - Joins baseName with candidate's existing ID using dot notation
+ * - If candidate has no ID, uses baseName as the full ID
+ * - Always merges base conditions with candidate's existing conditions
+ *
+ * @example
+ * ```typescript
+ * // Candidate inherits full name from import context
+ * const candidate = { value: "Hello", conditions: [...] }; // No id field
+ * const result = mergeImporterCandidate(candidate, "pages.home.greeting", []);
+ * // Result: { id: "pages.home.greeting", value: "Hello", conditions: [...] }
+ * ```
+ *
+ * @public
+ */
+export function mergeImporterCandidate(candidate, baseName, baseConditions) {
+    var _a;
+    if (baseName || Json.isLooseResourceCandidateDecl(candidate)) {
+        const candidateId = 'id' in candidate ? candidate.id : '';
+        return CommonHelpers.joinResourceIds(baseName, candidateId).onSuccess((id) => {
+            var _a;
+            /* c8 ignore next 1 - defense in depth */
+            const conditions = [...(baseConditions !== null && baseConditions !== void 0 ? baseConditions : []), ...((_a = candidate.conditions) !== null && _a !== void 0 ? _a : [])];
+            return succeed(Object.assign(Object.assign({}, candidate), { id, conditions }));
+        });
+    }
+    else {
+        /* c8 ignore next 5 - functional code tested but coverage intermittently missed */
+        /* c8 ignore next 1 - defense in depth */
+        const conditions = [...(baseConditions !== null && baseConditions !== void 0 ? baseConditions : []), ...((_a = candidate.conditions) !== null && _a !== void 0 ? _a : [])];
+        return succeed(Object.assign(Object.assign({}, candidate), { conditions }));
+    }
+}
+/**
+ * Helper method to merge a child candidate with base conditions.
+ * @param candidate - The candidate to merge.
+ * @param baseConditions - The base conditions to merge with the candidate.
+ * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
+ * @public
+ */
+export function mergeChildCandidate(candidate, baseConditions) {
+    var _a;
+    /* c8 ignore next 1 - defense in depth */
+    const conditions = [...(baseConditions !== null && baseConditions !== void 0 ? baseConditions : []), ...((_a = candidate.conditions) !== null && _a !== void 0 ? _a : [])];
+    return succeed(Object.assign(Object.assign({}, candidate), { conditions }));
+}
+/**
+ * Helper method to merge a loose resource with a base name and conditions.
+ * @param resource - The resource to merge.
+ * @param baseName - The base name to merge with the resource.
+ * @param baseConditions - The base conditions to merge with the resource.
+ * @returns `Success` with the merged resource if successful, otherwise `Failure`.
+ * @public
+ */
+export function mergeLooseResource(resource, baseName, baseConditions) {
+    /* c8 ignore next 1 - defense in depth */
+    const resourceId = Json.isLooseResourceDecl(resource) ? resource.id : '';
+    if (!baseName && !Json.isLooseResourceDecl(resource)) {
+        return fail('id is required in mergeLooseResource');
+    }
+    /* c8 ignore next 10 - functional code tested but coverage intermittently missed */
+    return CommonHelpers.joinResourceIds(baseName, resourceId).onSuccess((id) => {
+        var _a;
+        return mapResults(
+        /* c8 ignore next 1 - defense in depth */
+        ((_a = resource.candidates) !== null && _a !== void 0 ? _a : []).map((candidate) => mergeChildCandidate(candidate, baseConditions))).onSuccess((candidates) => {
+            return succeed(Object.assign(Object.assign({}, resource), { id, candidates }));
+        });
+    });
+}
+/**
+ * Helper method to merge a resource with a base name and conditions from import context.
+ * This function enables name inheritance where resources can automatically inherit their
+ * resource ID from the import context when no explicit ID is provided in the resource declaration.
+ *
+ * @param resource - The resource to merge. Can be either a loose resource (with optional ID)
+ * or a child resource (without ID).
+ * @param baseName - The base name from import context to merge with the resource.
+ * When provided, this will be used as the parent component of the resource ID.
+ * @param baseConditions - The base conditions from import context to merge with the resource's conditions.
+ * @returns `Success` with the merged resource if successful, otherwise `Failure`.
+ *
+ * @remarks
+ * This function supports several scenarios for name inheritance:
+ * - **Explicit ID + Base Name**: Joins baseName.resourceId (e.g., "pages.home" + "greeting" = "pages.home.greeting")
+ * - **No ID + Base Name**: Uses baseName as the resource ID (enables name inheritance from import context)
+ * - **Explicit ID + No Base Name**: Uses the resource's existing ID
+ * - **No ID + No Base Name**: Returns resource without ID (for child resources)
+ *
+ * Base conditions are always merged with the resource's existing conditions.
+ *
+ * @example
+ * ```typescript
+ * // Resource without ID inherits name from import context
+ * const resource = { candidates: [...] }; // No id field
+ * const result = mergeImporterResource(resource, "pages.home", []);
+ * // Result: { id: "pages.home", candidates: [...] }
+ *
+ * // Resource with ID gets joined with base name
+ * const resource = { id: "greeting", candidates: [...] };
+ * const result = mergeImporterResource(resource, "pages.home", []);
+ * // Result: { id: "pages.home.greeting", candidates: [...] }
+ * ```
+ *
+ * @public
+ */
+export function mergeImporterResource(resource, baseName, baseConditions) {
+    var _a;
+    if (baseName || `id` in resource) {
+        const resourceId = 'id' in resource ? resource.id : '';
+        // If we have a base name or the resource has no id, we can just
+        return CommonHelpers.joinResourceIds(baseName, resourceId).onSuccess((id) => {
+            var _a;
+            return mapResults(
+            /* c8 ignore next 1 - defense in depth */
+            ((_a = resource.candidates) !== null && _a !== void 0 ? _a : []).map((candidate) => mergeChildCandidate(candidate, baseConditions))).onSuccess((candidates) => {
+                return succeed(Object.assign(Object.assign({}, resource), { id, candidates }));
+            });
+        });
+    }
+    else {
+        /* c8 ignore next 8 - functional code tested but coverage intermittently missed */
+        return mapResults(
+        /* c8 ignore next 1 - defense in depth */
+        ((_a = resource.candidates) !== null && _a !== void 0 ? _a : []).map((candidate) => mergeChildCandidate(candidate, baseConditions))).onSuccess((candidates) => {
+            return succeed(Object.assign(Object.assign({}, resource), { candidates }));
+        });
+    }
+}
+/**
+ * Helper method to merge a child resource with a parent name and conditions.
+ * @param resource - The resource to merge.
+ * @param name - The name of the resource.
+ *
+ * @param parentName - The name of the parent resource.
+ * @param parentConditions - The conditions of the parent resource.
+ * @returns `Success` with the merged resource if successful, otherwise `Failure`.
+ * @public
+ */
+export function mergeChildResource(resource, name, parentName, parentConditions) {
+    return CommonHelpers.joinResourceIds(parentName, name).onSuccess((id) => {
+        var _a;
+        return mapResults(
+        /* c8 ignore next 1 - defense in depth */
+        ((_a = resource.candidates) !== null && _a !== void 0 ? _a : []).map((candidate) => mergeChildCandidate(candidate, parentConditions))).onSuccess((candidates) => {
+            return succeed(Object.assign(Object.assign({}, resource), { id, candidates }));
+        });
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/packlets/resource-json/index.js

@@ -0,0 +1,31 @@
+/*
+ * 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 Compiled from './compiled';
+import * as Convert from './convert';
+import * as Helpers from './helpers';
+import * as Json from './json';
+import * as Normalized from './normalized';
+export { Compiled, Convert, Helpers, Json, Normalized };
+export * from './resourceDeclContainer';
+export * from './resourceDeclCollection';
+export * from './resourceDeclTree';
+//# sourceMappingURL=index.js.map

package/dist/packlets/resource-json/json.js

@@ -0,0 +1,36 @@
+/*
+ * 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.
+ */
+/**
+ * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.
+ * @public
+ */
+export function isLooseResourceCandidateDecl(decl) {
+    return 'id' in decl;
+}
+/**
+ * Type guard function to check if a resource declaration is a loose resource declaration.
+ * @public
+ */
+export function isLooseResourceDecl(decl) {
+    return 'id' in decl;
+}
+//# sourceMappingURL=json.js.map

package/dist/packlets/resource-json/normalized.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=normalized.js.map

package/dist/packlets/resource-json/resourceDeclCollection.js

@@ -0,0 +1,88 @@
+/*
+ * 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 { captureResult, mapResults, MessageAggregator, succeed } from '@fgv/ts-utils';
+import * as Convert from './convert';
+import { mergeContextDecl, mergeImporterCandidate, mergeImporterResource } from './helpers';
+/**
+ * Class that extracts resources and candidates from a
+ * {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
+ * @public
+ */
+export class ResourceDeclCollection {
+    /**
+     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     */
+    get context() {
+        return this.collection.context;
+    }
+    constructor(collection) {
+        this._resources = [];
+        this._candidates = [];
+        this.collection = collection;
+        this._extract(collection).orThrow();
+    }
+    /**
+     * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an
+     * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.
+     * @param from - The JSON object to convert.
+     * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.
+     */
+    static create(from) {
+        return Convert.importerResourceCollectionDecl
+            .convert(from)
+            .withErrorFormat((err) => `Invalid resource collection: ${err}`)
+            .onSuccess((decl) => {
+            return captureResult(() => new ResourceDeclCollection(decl));
+        });
+    }
+    /**
+     * Gets the importer resources extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource declarations}
+     * extracted from the collection.
+     */
+    getImporterResources() {
+        return this._resources;
+    }
+    /**
+     * Gets the importer candidates extracted from the collection.
+     * @returns The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declarations}
+     * extracted from the collection.
+     */
+    getImporterCandidates() {
+        return this._candidates;
+    }
+    _extract(collection, parentName, parentConditions) {
+        const errors = new MessageAggregator();
+        return mergeContextDecl(collection.context, parentName, parentConditions).onSuccess(({ baseId: baseName, conditions: baseConditions }) => {
+            var _a, _b, _c, _d, _e;
+            const mergedCandidates = (_b = (_a = collection.candidates) === null || _a === void 0 ? void 0 : _a.map((candidate) => mergeImporterCandidate(candidate, baseName, baseConditions))) !== null && _b !== void 0 ? _b : [];
+            this._candidates.push(...mapResults(mergedCandidates).aggregateError(errors).orDefault([]));
+            const mergedResources = (_d = (_c = collection.resources) === null || _c === void 0 ? void 0 : _c.map((resource) => mergeImporterResource(resource, baseName, baseConditions))) !== null && _d !== void 0 ? _d : [];
+            this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));
+            (_e = collection.collections) === null || _e === void 0 ? void 0 : _e.forEach((subCollection) => {
+                this._extract(subCollection, baseName, baseConditions).aggregateError(errors);
+            });
+            return errors.returnOrReport(succeed(this));
+        });
+    }
+}
+//# sourceMappingURL=resourceDeclCollection.js.map

package/dist/packlets/resource-json/resourceDeclContainer.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=resourceDeclContainer.js.map