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

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

@@ -20,13 +20,85 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeContextDecl = mergeContextDecl;
 exports.mergeLooseCandidate = mergeLooseCandidate;
+exports.mergeImporterCandidate = mergeImporterCandidate;
 exports.mergeChildCandidate = mergeChildCandidate;
 exports.mergeLooseResource = mergeLooseResource;
+exports.mergeImporterResource = mergeImporterResource;
 exports.mergeChildResource = mergeChildResource;
 const ts_utils_1 = require("@fgv/ts-utils");
+const Json = __importStar(require("./json"));
 const common_1 = require("../common");
+const ts_json_base_1 = require("@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
+ */
+function mergeContextDecl(decl, parentName, parentConditions) {
+    var _a, _b, _c;
+    if (!decl) {
+        return (0, ts_json_base_1.sanitizeJsonObject)({ baseId: parentName, conditions: parentConditions });
+    }
+    else if (!parentName && !parentConditions) {
+        return (0, ts_utils_1.succeed)(decl);
+    }
+    switch ((_a = decl.mergeMethod) !== null && _a !== void 0 ? _a : 'augment') {
+        case 'augment':
+            return common_1.Helpers.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 (0, ts_json_base_1.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 (0, ts_json_base_1.sanitizeJsonObject)({ baseId, conditions });
+        }
+        case 'delete': {
+            return (0, ts_json_base_1.sanitizeJsonObject)({});
+        }
+    }
+}
 /**
  * Helper method to merge a loose candidate with a base name and conditions.
  * @param candidate - The candidate to merge.
@@ -36,13 +108,60 @@ const common_1 = require("../common");
  * @public
  */
 function mergeLooseCandidate(candidate, baseName, baseConditions) {
-    return common_1.Helpers.joinResourceIds(baseName, candidate.id).onSuccess((id) => {
+    const candidateId = Json.isLooseResourceCandidateDecl(candidate) ? candidate.id : '';
+    if (!Json.isLooseResourceCandidateDecl(candidate) && !baseName) {
+        return (0, ts_utils_1.fail)('id is required in mergeLooseCandidate');
+    }
+    return common_1.Helpers.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 (0, ts_utils_1.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
+ */
+function mergeImporterCandidate(candidate, baseName, baseConditions) {
+    var _a;
+    if (baseName || Json.isLooseResourceCandidateDecl(candidate)) {
+        const candidateId = 'id' in candidate ? candidate.id : '';
+        return common_1.Helpers.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 (0, ts_utils_1.succeed)(Object.assign(Object.assign({}, candidate), { id, conditions }));
+        });
+    }
+    else {
+        /* 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 child candidate with base conditions.
  * @param candidate - The candidate to merge.
@@ -65,7 +184,12 @@ function mergeChildCandidate(candidate, baseConditions) {
  * @public
  */
 function mergeLooseResource(resource, baseName, baseConditions) {
-    return common_1.Helpers.joinResourceIds(baseName, resource.id).onSuccess((id) => {
+    /* c8 ignore next 1 - defense in depth */
+    const resourceId = Json.isLooseResourceDecl(resource) ? resource.id : '';
+    if (!baseName && !Json.isLooseResourceDecl(resource)) {
+        return (0, ts_utils_1.fail)('id is required in mergeLooseResource');
+    }
+    return common_1.Helpers.joinResourceIds(baseName, resourceId).onSuccess((id) => {
         var _a;
         return (0, ts_utils_1.mapResults)(
         /* c8 ignore next 1 - defense in depth */
@@ -74,10 +198,69 @@ function mergeLooseResource(resource, baseName, baseConditions) {
         });
     });
 }
+/**
+ * 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
+ */
+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 common_1.Helpers.joinResourceIds(baseName, resourceId).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 }));
+            });
+        });
+    }
+    else {
+        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), { 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`.

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AA2BH,kDAUC;AASD,kDAOC;AAUD,gDAaC;AAWD,gDAcC;AAnGD,4CAA4D;AAG5D,sCAAqD;AAcrD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,SAAiD,EACjD,QAAiB,EACjB,cAAwD;IAExD,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,cAAwD;;IAExD,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,cAAwD;IAExD,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,gBAA0D;IAE1D,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';\n\n/**\n * Common options when creating or displaying declarations.\n * @public\n */\nexport interface IDeclarationOptions {\n  /**\n   * If `true`, properties with default values will be included in the\n   * output. IF omitted or `false`, properties with default values will be omitted.\n   */\n  showDefaults?: boolean;\n}\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>\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>\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>\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>\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"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.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 { mapResults, Result, fail, succeed } from '@fgv/ts-utils';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport { sanitizeJsonObject } from '@fgv/ts-json-base';\n\n/**\n * Common options when creating or displaying declarations.\n * @public\n */\nexport interface IDeclarationOptions {\n  /**\n   * If `true`, properties with default values will be included in the\n   * output. If omitted or `false`, properties with default values will be omitted.\n   */\n  showDefaults?: boolean;\n\n  /**\n   * If `true`, the output will be normalized using hash-based ordering for consistent structure.\n   * If omitted or `false`, no normalization will be applied. Defaults to `false`.\n   */\n  normalized?: boolean;\n}\n\n/**\n * Helper method to merge a resource context declaration with a parent name and conditions.\n * @param decl - The resource context declaration to merge.\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 context declaration if successful, otherwise `Failure`.\n * @public\n */\nexport function mergeContextDecl(\n  decl?: Normalized.IContainerContextDecl,\n  parentName?: string,\n  parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n): Result<Normalized.IContainerContextDecl> {\n  if (!decl) {\n    return sanitizeJsonObject({ baseId: parentName, conditions: parentConditions });\n  } else if (!parentName && !parentConditions) {\n    return succeed(decl);\n  }\n  switch (decl.mergeMethod ?? 'augment') {\n    case 'augment':\n      return CommonHelpers.joinResourceIds(parentName, decl.baseId).onSuccess((baseId) => {\n        /* c8 ignore next 1 - defense in depth */\n        const conditions = [...(parentConditions ?? []), ...(decl.conditions ?? [])];\n        return sanitizeJsonObject({ baseId, conditions });\n      });\n    case 'replace': {\n      const baseId = decl.baseId ?? parentName;\n      const conditions = decl.conditions ?? parentConditions;\n      return sanitizeJsonObject({ baseId, conditions });\n    }\n    case 'delete': {\n      return sanitizeJsonObject({});\n    }\n  }\n}\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.IImporterResourceCandidateDecl,\n  baseName?: string,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n): Result<Normalized.ILooseResourceCandidateDecl> {\n  const candidateId = Json.isLooseResourceCandidateDecl(candidate) ? candidate.id : '';\n  if (!Json.isLooseResourceCandidateDecl(candidate) && !baseName) {\n    return fail('id is required in mergeLooseCandidate');\n  }\n\n  return CommonHelpers.joinResourceIds(baseName, candidateId).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 resource candidate with a base name and conditions from import context.\n * This function enables name inheritance for resource candidates, similar to resources.\n *\n * @param candidate - The candidate to merge. Can have an optional ID that will be joined with baseName.\n * @param baseName - The base name from import context to merge with the candidate.\n * When provided, this will be used as the parent component of the candidate ID.\n * @param baseConditions - The base conditions from import context to merge with the candidate's conditions.\n * @returns `Success` with the merged candidate if successful, otherwise `Failure`.\n *\n * @remarks\n * This function supports name inheritance for candidates:\n * - Joins baseName with candidate's existing ID using dot notation\n * - If candidate has no ID, uses baseName as the full ID\n * - Always merges base conditions with candidate's existing conditions\n *\n * @example\n * ```typescript\n * // Candidate inherits full name from import context\n * const candidate = { value: \"Hello\", conditions: [...] }; // No id field\n * const result = mergeImporterCandidate(candidate, \"pages.home.greeting\", []);\n * // Result: { id: \"pages.home.greeting\", value: \"Hello\", conditions: [...] }\n * ```\n *\n * @public\n */\nexport function mergeImporterCandidate(\n  candidate: Normalized.IImporterResourceCandidateDecl,\n  baseName?: string,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n): Result<Normalized.IImporterResourceCandidateDecl> {\n  if (baseName || Json.isLooseResourceCandidateDecl(candidate)) {\n    const candidateId = 'id' in candidate ? candidate.id : '';\n    return CommonHelpers.joinResourceIds(baseName, candidateId).onSuccess((id) => {\n      /* c8 ignore next 1 - defense in depth */\n      const conditions = [...(baseConditions ?? []), ...(candidate.conditions ?? [])];\n      return succeed({ ...candidate, id, conditions });\n    });\n  } else {\n    /* c8 ignore next 1 - defense in depth */\n    const conditions = [...(baseConditions ?? []), ...(candidate.conditions ?? [])];\n    return succeed({ ...candidate, 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>\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.IImporterResourceDecl,\n  baseName?: string,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n): Result<Normalized.ILooseResourceDecl> {\n  /* c8 ignore next 1 - defense in depth */\n  const resourceId = Json.isLooseResourceDecl(resource) ? resource.id : '';\n  if (!baseName && !Json.isLooseResourceDecl(resource)) {\n    return fail('id is required in mergeLooseResource');\n  }\n\n  return CommonHelpers.joinResourceIds(baseName, resourceId).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 resource with a base name and conditions from import context.\n * This function enables name inheritance where resources can automatically inherit their\n * resource ID from the import context when no explicit ID is provided in the resource declaration.\n *\n * @param resource - The resource to merge. Can be either a loose resource (with optional ID)\n * or a child resource (without ID).\n * @param baseName - The base name from import context to merge with the resource.\n * When provided, this will be used as the parent component of the resource ID.\n * @param baseConditions - The base conditions from import context to merge with the resource's conditions.\n * @returns `Success` with the merged resource if successful, otherwise `Failure`.\n *\n * @remarks\n * This function supports several scenarios for name inheritance:\n * - **Explicit ID + Base Name**: Joins baseName.resourceId (e.g., \"pages.home\" + \"greeting\" = \"pages.home.greeting\")\n * - **No ID + Base Name**: Uses baseName as the resource ID (enables name inheritance from import context)\n * - **Explicit ID + No Base Name**: Uses the resource's existing ID\n * - **No ID + No Base Name**: Returns resource without ID (for child resources)\n *\n * Base conditions are always merged with the resource's existing conditions.\n *\n * @example\n * ```typescript\n * // Resource without ID inherits name from import context\n * const resource = { candidates: [...] }; // No id field\n * const result = mergeImporterResource(resource, \"pages.home\", []);\n * // Result: { id: \"pages.home\", candidates: [...] }\n *\n * // Resource with ID gets joined with base name\n * const resource = { id: \"greeting\", candidates: [...] };\n * const result = mergeImporterResource(resource, \"pages.home\", []);\n * // Result: { id: \"pages.home.greeting\", candidates: [...] }\n * ```\n *\n * @public\n */\nexport function mergeImporterResource(\n  resource: Normalized.IImporterResourceDecl,\n  baseName?: string,\n  baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n): Result<Normalized.IImporterResourceDecl> {\n  if (baseName || `id` in resource) {\n    const resourceId = 'id' in resource ? resource.id : '';\n    // If we have a base name or the resource has no id, we can just\n    return CommonHelpers.joinResourceIds(baseName, resourceId).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  } else {\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, 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 *\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>\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

@@ -1,8 +1,9 @@
+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 { Convert, Helpers, Json, Normalized };
+export { Compiled, Convert, Helpers, Json, Normalized };
 export * from './resourceDeclContainer';
 export * from './resourceDeclCollection';
 export * from './resourceDeclTree';

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/index.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,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,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAExD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

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

@@ -57,7 +57,9 @@ 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;
+exports.Normalized = exports.Json = exports.Helpers = exports.Convert = exports.Compiled = void 0;
+const Compiled = __importStar(require("./compiled"));
+exports.Compiled = Compiled;
 const Convert = __importStar(require("./convert"));
 exports.Convert = Convert;
 const Helpers = __importStar(require("./helpers"));

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

@@ -1 +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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,qDAAuC;AAM9B,4BAAQ;AALjB,mDAAqC;AAKlB,0BAAO;AAJ1B,mDAAqC;AAIT,0BAAO;AAHnC,6CAA+B;AAGM,oBAAI;AAFzC,yDAA2C;AAEA,gCAAU;AAErD,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 Compiled from './compiled';\nimport * as Convert from './convert';\nimport * as Helpers from './helpers';\nimport * as Json from './json';\nimport * as Normalized from './normalized';\n\nexport { Compiled, Convert, Helpers, Json, Normalized };\n\nexport * from './resourceDeclContainer';\nexport * from './resourceDeclCollection';\nexport * from './resourceDeclTree';\n"]}

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

@@ -88,6 +88,21 @@ export interface IChildResourceCandidateDecl {
      */
     readonly mergeMethod?: ResourceValueMergeMethod;
 }
+/**
+ * Non-validated declaration of a resource candidate for import,
+ * which can be either a loose or child resource candidate.
+ * @public
+ */
+export interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {
+    /**
+     * The {@link ResourceId | id} of the resource.
+     */
+    readonly id?: string;
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName?: string;
+}
 /**
  * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.
  * @public
@@ -159,24 +174,61 @@ export interface IResourceTreeChildNodeDecl {
     readonly resources?: Record<string, IChildResourceDecl>;
     readonly children?: Record<string, IResourceTreeChildNodeDecl>;
 }
+/**
+ * Declared context for a resource container.
+ * @public
+ */
+export interface IContainerContextDecl {
+    readonly baseId?: string;
+    readonly conditions?: ConditionSetDecl;
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
 /**
  * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.
  * @public
  */
 export interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
-    readonly baseName?: string;
+    readonly context?: IContainerContextDecl;
     readonly resources?: Record<string, IChildResourceDecl>;
     readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+    readonly metadata?: JsonObject;
 }
 /**
  * Non-validated declaration of a collection of resources.
  * @public
  */
 export interface IResourceCollectionDecl {
-    readonly baseName?: string;
-    readonly baseConditions?: ConditionSetDecl;
+    readonly context?: IContainerContextDecl;
     readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
     readonly resources?: ReadonlyArray<ILooseResourceDecl>;
     readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+    readonly metadata?: JsonObject;
 }
+/**
+ * Non-validated declaration of a resource for import,
+ * which can be either a loose or child resource.
+ * @public
+ */
+export type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;
+/**
+ * Non-validated declaration of a collection of resources for an importer.
+ * @public
+ */
+export interface IImporterResourceCollectionDecl {
+    readonly context?: IContainerContextDecl;
+    readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;
+    readonly resources?: ReadonlyArray<IImporterResourceDecl>;
+    readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;
+    readonly metadata?: JsonObject;
+}
+/**
+ * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.
+ * @public
+ */
+export declare function isLooseResourceCandidateDecl(decl: IImporterResourceCandidateDecl): decl is ILooseResourceCandidateDecl;
+/**
+ * Type guard function to check if a resource declaration is a loose resource declaration.
+ * @public
+ */
+export declare function isLooseResourceDecl(decl: IImporterResourceDecl): decl is ILooseResourceDecl;
 //# sourceMappingURL=json.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":"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"}

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

@@ -21,4 +21,20 @@
  * SOFTWARE.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLooseResourceCandidateDecl = isLooseResourceCandidateDecl;
+exports.isLooseResourceDecl = isLooseResourceDecl;
+/**
+ * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.
+ * @public
+ */
+function isLooseResourceCandidateDecl(decl) {
+    return 'id' in decl;
+}
+/**
+ * Type guard function to check if a resource declaration is a loose resource declaration.
+ * @public
+ */
+function isLooseResourceDecl(decl) {
+    return 'id' in decl;
+}
 //# sourceMappingURL=json.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { JsonObject } from '@fgv/ts-json-base';\nimport { ConditionOperator, ResourceValueMergeMethod } from '../common';\n\n/**\n * Non-validated loose declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface ILooseConditionDecl {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: string;\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated child declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface IChildConditionDecl {\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly baseName?: string;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly baseName?: string;\n  readonly baseConditions?: ConditionSetDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n}\n"]}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAsQH,oEAIC;AAMD,kDAEC;AAhBD;;;GAGG;AACH,SAAgB,4BAA4B,CAC1C,IAAoC;IAEpC,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAA2B;IAC7D,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,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 { JsonObject } from '@fgv/ts-json-base';\nimport { ConditionOperator, ResourceValueMergeMethod } from '../common';\n\n/**\n * Non-validated loose declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface ILooseConditionDecl {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: string;\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated child declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport interface IChildConditionDecl {\n  /**\n   * The value to be compared.\n   */\n  value: string;\n  /**\n   * The operator to be used in the comparison.\n   * Default is 'matches'.\n   */\n  operator?: ConditionOperator;\n\n  /**\n   * The priority of the condition. Default is the default priority for the qualifier.\n   */\n  priority?: number;\n\n  /**\n   * The score to be used if the condition is used as a default.\n   */\n  scoreAsDefault?: number;\n}\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsArray = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDeclAsRecord = Record<string, string | IChildConditionDecl>;\n\n/**\n * Non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ConditionSetDeclAsArray | ConditionSetDeclAsRecord;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Non-validated declaration of a resource candidate for import,\n * which can be either a loose or child resource candidate.\n * @public\n */\nexport interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id?: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Declared context for a resource container.\n * @public\n */\nexport interface IContainerContextDecl {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly context?: IContainerContextDecl;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a resource for import,\n * which can be either a loose or child resource.\n * @public\n */\nexport type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;\n\n/**\n * Non-validated declaration of a collection of resources for an importer.\n * @public\n */\nexport interface IImporterResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Type guard function to check if a resource candidate declaration is a loose resource candidate declaration.\n * @public\n */\nexport function isLooseResourceCandidateDecl(\n  decl: IImporterResourceCandidateDecl\n): decl is ILooseResourceCandidateDecl {\n  return 'id' in decl;\n}\n\n/**\n * Type guard function to check if a resource declaration is a loose resource declaration.\n * @public\n */\nexport function isLooseResourceDecl(decl: IImporterResourceDecl): decl is ILooseResourceDecl {\n  return 'id' in decl;\n}\n"]}

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

@@ -29,6 +29,21 @@ export interface IChildResourceCandidateDecl {
      */
     readonly mergeMethod?: ResourceValueMergeMethod;
 }
+/**
+ * Normalized non-validated declaration of a resource candidate for import,
+ * which can be either a loose or child resource candidate.
+ * @public
+ */
+export interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {
+    /**
+     * The {@link ResourceId | id} of the resource.
+     */
+    readonly id?: string;
+    /**
+     * The name of the type of this resource.
+     */
+    readonly resourceTypeName?: string;
+}
 /**
  * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.
  * @public
@@ -100,24 +115,52 @@ export interface IResourceTreeChildNodeDecl {
     readonly resources?: Record<string, IChildResourceDecl>;
     readonly children?: Record<string, IResourceTreeChildNodeDecl>;
 }
+/**
+ * Declared context for a resource container.
+ * @public
+ */
+export interface IContainerContextDecl {
+    readonly baseId?: string;
+    readonly conditions?: ConditionSetDecl;
+    readonly mergeMethod?: ResourceValueMergeMethod;
+}
 /**
  * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.
  * @public
  */
 export interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {
-    readonly baseName?: string;
+    readonly context?: IContainerContextDecl;
     readonly resources?: Record<string, IChildResourceDecl>;
     readonly children?: Record<string, IResourceTreeChildNodeDecl>;
+    readonly metadata?: JsonObject;
 }
 /**
  * Normalized non-validated declaration of a collection of resources.
  * @public
  */
 export interface IResourceCollectionDecl {
-    readonly baseName?: string;
-    readonly baseConditions?: ConditionSetDecl;
+    readonly context?: IContainerContextDecl;
     readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;
     readonly resources?: ReadonlyArray<ILooseResourceDecl>;
     readonly collections?: ReadonlyArray<IResourceCollectionDecl>;
+    readonly metadata?: JsonObject;
+}
+/**
+ * Normalized non-validated declaration of a resource for import,
+ * which can be either a loose or child resource.
+ * @public
+ */
+export type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;
+/**
+ * Normalized non-validated declaration of a collection of resources for importers.
+ * This allows for a mix of loose and child resource declarations.
+ * @public
+ */
+export interface IImporterResourceCollectionDecl {
+    readonly context?: IContainerContextDecl;
+    readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;
+    readonly resources?: ReadonlyArray<IImporterResourceDecl>;
+    readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;
+    readonly metadata?: JsonObject;
 }
 //# sourceMappingURL=normalized.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"normalized.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA4B,SAAQ,2BAA2B;IAC9E;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CAC/D"}
+{"version":3,"file":"normalized.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"normalized.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { JsonObject } from '@fgv/ts-json-base';\nimport { ResourceValueMergeMethod } from '../common';\nimport { ILooseConditionDecl } from './json';\n\n/**\n * Normalized non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly baseName?: string;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly baseName?: string;\n  readonly baseConditions?: ConditionSetDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n}\n"]}
+{"version":3,"file":"normalized.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/normalized.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","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 { JsonObject } from '@fgv/ts-json-base';\nimport { ResourceValueMergeMethod } from '../common';\nimport { ILooseConditionDecl } from './json';\n\n/**\n * Normalized non-validated declaration of a {@link Conditions.Condition | condition}.\n * @public\n */\nexport type ConditionSetDecl = ReadonlyArray<ILooseConditionDecl>;\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface IChildResourceCandidateDecl {\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a resource candidate for import,\n * which can be either a loose or child resource candidate.\n * @public\n */\nexport interface IImporterResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id?: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n * @public\n */\nexport interface ILooseResourceCandidateDecl extends IChildResourceCandidateDecl {\n  /**\n   * The {@link ResourceId | id} of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The JSON value of the resource.\n   */\n  readonly json: JsonObject;\n\n  /**\n   * The conditions that must be met for the resource to be selected.\n   */\n  readonly conditions?: ConditionSetDecl;\n\n  /**\n   * If true, the resource is only a partial representation of the full resource.\n   */\n  readonly isPartial?: boolean;\n\n  /**\n   * The merge method to be used when merging the resource into the existing resource.\n   * default is 'augment'.\n   */\n  readonly mergeMethod?: ResourceValueMergeMethod;\n\n  /**\n   * The type of the resource.\n   */\n  readonly resourceTypeName?: string;\n}\n\n/**\n * Normalized non-validated child declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface IChildResourceDecl {\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated loose declaration of a {@link Resources.Resource | resource}.\n * @public\n */\nexport interface ILooseResourceDecl extends IChildResourceDecl {\n  /**\n   * The id of the resource.\n   */\n  readonly id: string;\n\n  /**\n   * The name of the type of this resource.\n   */\n  readonly resourceTypeName: string;\n\n  /**\n   * Possible candidates for this value.\n   */\n  readonly candidates?: ReadonlyArray<IChildResourceCandidateDecl>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n * @public\n */\nexport interface IResourceTreeChildNodeDecl {\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n}\n\n/**\n * Declared context for a resource container.\n * @public\n */\nexport interface IContainerContextDecl {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n * @public\n */\nexport interface IResourceTreeRootDecl extends IResourceTreeChildNodeDecl {\n  readonly context?: IContainerContextDecl;\n  readonly resources?: Record<string, IChildResourceDecl>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Normalized non-validated declaration of a collection of resources.\n * @public\n */\nexport interface IResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Normalized non-validated declaration of a resource for import,\n * which can be either a loose or child resource.\n * @public\n */\nexport type IImporterResourceDecl = ILooseResourceDecl | IChildResourceDecl;\n\n/**\n * Normalized non-validated declaration of a collection of resources for importers.\n * This allows for a mix of loose and child resource declarations.\n * @public\n */\nexport interface IImporterResourceCollectionDecl {\n  readonly context?: IContainerContextDecl;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl>;\n  readonly metadata?: JsonObject;\n}\n"]}