@fgv/ts-res 4.5.0-0

package/lib/packlets/resource-json/convert.d.ts

@@ -0,0 +1,54 @@
+import { Converter } from '@fgv/ts-utils';
+import * as Json from './json';
+import * as Normalized from './normalized';
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration}.
+ * @public
+ */
+export declare const looseConditionDecl: Converter<Json.ILooseConditionDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}.
+ * @public
+ */
+export declare const childConditionDecl: Converter<Json.IChildConditionDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.
+ * @public
+ */
+export declare const conditionSetDecl: Converter<Normalized.ConditionSetDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.
+ * @public
+ */
+export declare const looseResourceCandidateDecl: Converter<Normalized.ILooseResourceCandidateDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.
+ * @public
+ */
+export declare const childResourceCandidateDecl: Converter<Normalized.IChildResourceCandidateDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declaration}.
+ * @public
+ */
+export declare const looseResourceDecl: Converter<Normalized.ILooseResourceDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IChildResourceDecl | child resource declaration}.
+ * @public
+ */
+export declare const childResourceDecl: Converter<Normalized.IChildResourceDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.
+ * @public
+ */
+export declare const resourceTreeChildNodeDecl: Converter<Normalized.IResourceTreeChildNodeDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}.
+ * @public
+ */
+export declare const resourceTreeRootDecl: Converter<Normalized.IResourceTreeRootDecl>;
+/**
+ * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}.
+ * @public
+ */
+export declare const resourceCollectionDecl: Converter<Normalized.IResourceCollectionDecl>;
+//# sourceMappingURL=convert.d.ts.map

package/lib/packlets/resource-json/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,SAAS,EAAwC,MAAM,eAAe,CAAC;AAGhF,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAO/D,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAM/D,CAAC;AA+BL;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,UAAU,CAAC,gBAAgB,CACoC,CAAC;AAEzG;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAQrF,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,CAAC,UAAU,CAAC,2BAA2B,CAMrF,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAKnE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAInE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,CAAC,UAAU,CAAC,0BAA0B,CActF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,CAAC,UAAU,CAAC,qBAAqB,CAKzE,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,UAAU,CAAC,uBAAuB,CAiBhF,CAAC"}

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

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

package/lib/packlets/resource-json/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converter, Converters, mapResults, Result, fail } from '@fgv/ts-utils';\nimport { Convert as CommonConvert } from '../common';\nimport { isJsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';\nimport * as Json from './json';\nimport * as Normalized from './normalized';\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration}.\n * @public\n */\nexport const looseConditionDecl: Converter<Json.ILooseConditionDecl> =\n  Converters.strictObject<Json.ILooseConditionDecl>({\n    qualifierName: CommonConvert.qualifierName,\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}.\n * @public\n */\nexport const childConditionDecl: Converter<Json.IChildConditionDecl> =\n  Converters.strictObject<Json.IChildConditionDecl>({\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\nfunction _isConditionSetRecord(from: unknown): from is Record<string, string | Json.IChildConditionDecl> {\n  return isJsonObject(from);\n}\n\nconst conditionSetDeclFromArray: Converter<Normalized.ConditionSetDecl> =\n  Converters.arrayOf(looseConditionDecl);\nconst conditionSetDeclFromRecord: Converter<Normalized.ConditionSetDecl> = Converters.generic<\n  Normalized.ConditionSetDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.ConditionSetDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.ConditionSetDecl> => {\n    /* c8 ignore next 3 - this is tested but coverage is confused */\n    if (!_isConditionSetRecord(from)) {\n      return fail('Expected an object');\n    }\n    return mapResults(\n      Array.from(Object.entries(from)).map(([qualifierName, value]) => {\n        const toConvert: Json.ILooseConditionDecl =\n          typeof value === 'string' ? { qualifierName, value } : { qualifierName, ...value };\n        return looseConditionDecl.convert(toConvert, context);\n      })\n    );\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.\n * @public\n */\nexport const conditionSetDecl: Converter<Normalized.ConditionSetDecl> =\n  Converters.oneOf<Normalized.ConditionSetDecl>([conditionSetDeclFromArray, conditionSetDeclFromRecord]);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.\n * @public\n */\nexport const looseResourceCandidateDecl: Converter<Normalized.ILooseResourceCandidateDecl> =\n  Converters.strictObject<Normalized.ILooseResourceCandidateDecl>({\n    id: CommonConvert.resourceId,\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildResourceCandidateDecl | child resource candidate declaration}.\n * @public\n */\nexport const childResourceCandidateDecl: Converter<Normalized.IChildResourceCandidateDecl> =\n  Converters.strictObject<Normalized.IChildResourceCandidateDecl>({\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    isPartial: Converters.boolean.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declaration}.\n * @public\n */\nexport const looseResourceDecl: Converter<Normalized.ILooseResourceDecl> =\n  Converters.strictObject<Normalized.ILooseResourceDecl>({\n    id: CommonConvert.resourceId,\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IChildResourceDecl | child resource declaration}.\n * @public\n */\nexport const childResourceDecl: Converter<Normalized.IChildResourceDecl> =\n  Converters.strictObject<Normalized.IChildResourceDecl>({\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(childResourceCandidateDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeChildNodeDecl | resource tree child node declaration}.\n * @public\n */\nexport const resourceTreeChildNodeDecl: Converter<Normalized.IResourceTreeChildNodeDecl> = Converters.generic<\n  Normalized.IResourceTreeChildNodeDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.IResourceTreeChildNodeDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.IResourceTreeChildNodeDecl> => {\n    return Converters.strictObject<Normalized.IResourceTreeChildNodeDecl>({\n      resources: Converters.recordOf(childResourceDecl).optional(),\n      children: Converters.recordOf(self).optional()\n    }).convert(from, context);\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}.\n * @public\n */\nexport const resourceTreeRootDecl: Converter<Normalized.IResourceTreeRootDecl> =\n  Converters.strictObject<Normalized.IResourceTreeRootDecl>({\n    baseName: CommonConvert.resourceId.optional(),\n    resources: Converters.recordOf(childResourceDecl).optional(),\n    children: Converters.recordOf(resourceTreeChildNodeDecl).optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}.\n * @public\n */\nexport const resourceCollectionDecl: Converter<Normalized.IResourceCollectionDecl> = Converters.generic<\n  Normalized.IResourceCollectionDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    self: Converter<Normalized.IResourceCollectionDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.IResourceCollectionDecl> => {\n    return Converters.strictObject<Normalized.IResourceCollectionDecl>({\n      baseName: CommonConvert.resourceId.optional(),\n      baseConditions: conditionSetDecl.optional(),\n      candidates: Converters.arrayOf(looseResourceCandidateDecl).optional(),\n      resources: Converters.arrayOf(looseResourceDecl).optional(),\n      collections: Converters.arrayOf(self).optional()\n    }).convert(from, context);\n  }\n);\n"]}

package/lib/packlets/resource-json/helpers.d.ts

@@ -0,0 +1,41 @@
+import { Result } from '@fgv/ts-utils';
+import * as Normalized from './normalized';
+import * as Json from './json';
+import * as Conditions from '../conditions';
+/**
+ * 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 declare function mergeLooseCandidate(candidate: Normalized.ILooseResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>): Result<Normalized.ILooseResourceCandidateDecl>;
+/**
+ * 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 declare function mergeChildCandidate(candidate: Normalized.IChildResourceCandidateDecl, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>): Result<Normalized.IChildResourceCandidateDecl>;
+/**
+ * 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 declare function mergeLooseResource(resource: Normalized.ILooseResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>): Result<Normalized.ILooseResourceDecl>;
+/**
+ * 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 declare function mergeChildResource(resource: Normalized.IChildResourceDecl, name: string, parentName?: string, parentConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>): Result<Normalized.ILooseResourceDecl>;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/packlets/resource-json/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAW,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B,OAAO,KAAK,UAAU,MAAM,eAAe,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,cAAc,CAAC,GACnF,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,cAAc,CAAC,GACnF,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAIhD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,kBAAkB,EACvC,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,cAAc,CAAC,GACnF,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,kBAAkB,EACvC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,cAAc,CAAC,GACrF,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC"}

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

@@ -0,0 +1,96 @@
+"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.mergeLooseCandidate = mergeLooseCandidate;
+exports.mergeChildCandidate = mergeChildCandidate;
+exports.mergeLooseResource = mergeLooseResource;
+exports.mergeChildResource = mergeChildResource;
+const ts_utils_1 = require("@fgv/ts-utils");
+const common_1 = require("../common");
+/**
+ * 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
+ */
+function mergeLooseCandidate(candidate, baseName, baseConditions) {
+    return common_1.Helpers.joinResourceIds(baseName, candidate.id).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 (0, ts_utils_1.succeed)(Object.assign(Object.assign({}, candidate), { id, 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
+ */
+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 (0, ts_utils_1.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
+ */
+function mergeLooseResource(resource, baseName, baseConditions) {
+    return common_1.Helpers.joinResourceIds(baseName, resource.id).onSuccess((id) => {
+        var _a;
+        return (0, ts_utils_1.mapResults)(
+        /* c8 ignore next 1 - defense in depth */
+        ((_a = resource.candidates) !== null && _a !== void 0 ? _a : []).map((candidate) => mergeChildCandidate(candidate, baseConditions))).onSuccess((candidates) => {
+            return (0, ts_utils_1.succeed)(Object.assign(Object.assign({}, resource), { id, 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
+ */
+function mergeChildResource(resource, name, parentName, parentConditions) {
+    return common_1.Helpers.joinResourceIds(parentName, name).onSuccess((id) => {
+        var _a;
+        return (0, ts_utils_1.mapResults)(
+        /* c8 ignore next 1 - defense in depth */
+        ((_a = resource.candidates) !== null && _a !== void 0 ? _a : []).map((candidate) => mergeChildCandidate(candidate, parentConditions))).onSuccess((candidates) => {
+            return (0, ts_utils_1.succeed)(Object.assign(Object.assign({}, resource), { id, candidates }));
+        });
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/lib/packlets/resource-json/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAgBH,kDAUC;AASD,kDAOC;AAUD,gDAaC;AAWD,gDAcC;AAxFD,4CAA4D;AAG5D,sCAAqD;AAGrD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,SAAiD,EACjD,QAAiB,EACjB,cAAoF;IAEpF,OAAO,gBAAa,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE;;QAC5E,yCAAyC;QACzC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,SAAS,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAC,CAAC;QAChF,OAAO,IAAA,kBAAO,kCAAM,SAAS,KAAE,EAAE,EAAE,UAAU,IAAG,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,SAAiD,EACjD,cAAoF;;IAEpF,yCAAyC;IACzC,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAA,SAAS,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,IAAA,kBAAO,kCAAM,SAAS,KAAE,UAAU,IAAG,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,QAAuC,EACvC,QAAiB,EACjB,cAAoF;IAEpF,OAAO,gBAAa,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE;;QAC3E,OAAO,IAAA,qBAAU;QACf,yCAAyC;QACzC,CAAC,MAAA,QAAQ,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAC/F,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACzB,OAAO,IAAA,kBAAO,kCAAM,QAAQ,KAAE,EAAE,EAAE,UAAU,IAAG,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAChC,QAAuC,EACvC,IAAY,EACZ,UAAmB,EACnB,gBAAsF;IAEtF,OAAO,gBAAa,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE;;QACtE,OAAO,IAAA,qBAAU;QACf,yCAAyC;QACzC,CAAC,MAAA,QAAQ,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CACjG,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACzB,OAAO,IAAA,kBAAO,kCAAM,QAAQ,KAAE,EAAE,EAAE,UAAU,IAAG,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,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 Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport * as Conditions from '../conditions';\n\n/**\n * Helper method to merge a loose candidate with a base name and conditions.\n * @param candidate - The candidate to merge.\n * @param baseName - The base name to merge with the candidate.\n * @param baseConditions - The base conditions to merge with the candidate.\n * @returns `Success` with the merged candidate if successful, otherwise `Failure`.\n * @public\n */\nexport function mergeLooseCandidate(\n  candidate: Normalized.ILooseResourceCandidateDecl,\n  baseName?: string,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>\n): Result<Normalized.ILooseResourceCandidateDecl> {\n  return CommonHelpers.joinResourceIds(baseName, candidate.id).onSuccess((id) => {\n    /* c8 ignore next 1 - defense in depth */\n    const conditions = [...(baseConditions ?? []), ...(candidate.conditions ?? [])];\n    return succeed({ ...candidate, id, conditions });\n  });\n}\n\n/**\n * Helper method to merge a child candidate with base conditions.\n * @param candidate - The candidate to merge.\n * @param baseConditions - The base conditions to merge with the candidate.\n * @returns `Success` with the merged candidate if successful, otherwise `Failure`.\n * @public\n */\nexport function mergeChildCandidate(\n  candidate: Normalized.IChildResourceCandidateDecl,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>\n): Result<Normalized.IChildResourceCandidateDecl> {\n  /* c8 ignore next 1 - defense in depth */\n  const conditions = [...(baseConditions ?? []), ...(candidate.conditions ?? [])];\n  return succeed({ ...candidate, conditions });\n}\n\n/**\n * Helper method to merge a loose resource with a base name and conditions.\n * @param resource - The resource to merge.\n * @param baseName - The base name to merge with the resource.\n * @param baseConditions - The base conditions to merge with the resource.\n * @returns `Success` with the merged resource if successful, otherwise `Failure`.\n * @public\n */\nexport function mergeLooseResource(\n  resource: Normalized.ILooseResourceDecl,\n  baseName?: string,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>\n): Result<Normalized.ILooseResourceDecl> {\n  return CommonHelpers.joinResourceIds(baseName, resource.id).onSuccess((id) => {\n    return mapResults(\n      /* c8 ignore next 1 - defense in depth */\n      (resource.candidates ?? []).map((candidate) => mergeChildCandidate(candidate, baseConditions))\n    ).onSuccess((candidates) => {\n      return succeed({ ...resource, id, candidates });\n    });\n  });\n}\n\n/**\n * Helper method to merge a child resource with a parent name and conditions.\n * @param resource - The resource to merge.\n * @param name - The name of the resource.\n * @param parentName - The name of the parent resource.\n * @param parentConditions - The conditions of the parent resource.\n * @returns `Success` with the merged resource if successful, otherwise `Failure`.\n * @public\n */\nexport function mergeChildResource(\n  resource: Normalized.IChildResourceDecl,\n  name: string,\n  parentName?: string,\n  parentConditions?: ReadonlyArray<Json.ILooseConditionDecl | Conditions.IConditionDecl>\n): Result<Normalized.ILooseResourceDecl> {\n  return CommonHelpers.joinResourceIds(parentName, name).onSuccess((id) => {\n    return mapResults(\n      /* c8 ignore next 1 - defense in depth */\n      (resource.candidates ?? []).map((candidate) => mergeChildCandidate(candidate, parentConditions))\n    ).onSuccess((candidates) => {\n      return succeed({ ...resource, id, candidates });\n    });\n  });\n}\n"]}

package/lib/packlets/resource-json/index.d.ts

@@ -0,0 +1,9 @@
+import * as Convert from './convert';
+import * as Helpers from './helpers';
+import * as Json from './json';
+import * as Normalized from './normalized';
+export { Convert, Helpers, Json, Normalized };
+export * from './resourceDeclContainer';
+export * from './resourceDeclCollection';
+export * from './resourceDeclTree';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/resource-json/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAE9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,72 @@
+"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.Normalized = exports.Json = exports.Helpers = exports.Convert = void 0;
+const Convert = __importStar(require("./convert"));
+exports.Convert = Convert;
+const Helpers = __importStar(require("./helpers"));
+exports.Helpers = Helpers;
+const Json = __importStar(require("./json"));
+exports.Json = Json;
+const Normalized = __importStar(require("./normalized"));
+exports.Normalized = Normalized;
+__exportStar(require("./resourceDeclContainer"), exports);
+__exportStar(require("./resourceDeclCollection"), exports);
+__exportStar(require("./resourceDeclTree"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/resource-json/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mDAAqC;AAK5B,0BAAO;AAJhB,mDAAqC;AAInB,0BAAO;AAHzB,6CAA+B;AAGJ,oBAAI;AAF/B,yDAA2C;AAEV,gCAAU;AAE3C,0DAAwC;AACxC,2DAAyC;AACzC,qDAAmC","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 Json from './json';\nimport * as Normalized from './normalized';\n\nexport { Convert, Helpers, Json, Normalized };\n\nexport * from './resourceDeclContainer';\nexport * from './resourceDeclCollection';\nexport * from './resourceDeclTree';\n"]}