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

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

@@ -1 +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"]}
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAgF;AAChF,sCAAqD;AACrD,oDAA+E;AAI/E;;;GAGG;AACU,QAAA,kBAAkB,GAC7B,qBAAU,CAAC,YAAY,CAA2B;IAChD,aAAa,EAAE,gBAAa,CAAC,aAAa;IAC1C,KAAK,EAAE,qBAAU,CAAC,MAAM;IACxB,QAAQ,EAAE,gBAAa,CAAC,iBAAiB,CAAC,QAAQ,EAAE;IACpD,QAAQ,EAAE,gBAAa,CAAC,iBAAiB,CAAC,QAAQ,EAAE;IACpD,cAAc,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,kBAAkB,GAC7B,qBAAU,CAAC,YAAY,CAA2B;IAChD,KAAK,EAAE,qBAAU,CAAC,MAAM;IACxB,QAAQ,EAAE,gBAAa,CAAC,iBAAiB,CAAC,QAAQ,EAAE;IACpD,QAAQ,EAAE,gBAAa,CAAC,iBAAiB,CAAC,QAAQ,EAAE;IACpD,cAAc,EAAE,qBAAU,CAAC,MAAM,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEL,SAAS,qBAAqB,CAAC,IAAa;IAC1C,OAAO,IAAA,2BAAY,EAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,yBAAyB,GAC7B,qBAAU,CAAC,OAAO,CAAC,0BAAkB,CAAC,CAAC;AACzC,MAAM,0BAA0B,GAA2C,qBAAU,CAAC,OAAO,CAI3F,CACE,IAAa,EACb,MAAuD,EACvD,OAAiB,EACoB,EAAE;IACvC,gEAAgE;IAChE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAA,eAAI,EAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAA,qBAAU,EACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9D,MAAM,SAAS,GACb,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,iBAAG,aAAa,IAAK,KAAK,CAAE,CAAC;QACrF,OAAO,0BAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,gBAAgB,GAC3B,qBAAU,CAAC,KAAK,CAA8B,CAAC,yBAAyB,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAEzG;;;GAGG;AACU,QAAA,0BAA0B,GACrC,qBAAU,CAAC,YAAY,CAAyC;IAC9D,EAAE,EAAE,gBAAa,CAAC,UAAU;IAC5B,IAAI,EAAE,yBAAc,CAAC,UAAU;IAC/B,UAAU,EAAE,wBAAgB,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,gBAAa,CAAC,wBAAwB,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,qBAAU,CAAC,OAAO,CAAC,QAAQ,EAAE;IACxC,gBAAgB,EAAE,gBAAa,CAAC,gBAAgB,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,6BAA6B,GACxC,qBAAU,CAAC,YAAY,CAA4C;IACjE,EAAE,EAAE,gBAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;IACvC,IAAI,EAAE,yBAAc,CAAC,UAAU;IAC/B,UAAU,EAAE,wBAAgB,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,gBAAa,CAAC,wBAAwB,CAAC,QAAQ,EAAE;IAC9D,SAAS,EAAE,qBAAU,CAAC,OAAO,CAAC,QAAQ,EAAE;IACxC,gBAAgB,EAAE,gBAAa,CAAC,gBAAgB,CAAC,QAAQ,EAAE;CAC5D,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,0BAA0B,GACrC,qBAAU,CAAC,YAAY,CAAyC;IAC9D,IAAI,EAAE,yBAAc,CAAC,UAAU;IAC/B,UAAU,EAAE,wBAAgB,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,qBAAU,CAAC,OAAO,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,gBAAa,CAAC,wBAAwB,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,iBAAiB,GAC5B,qBAAU,CAAC,YAAY,CAAgC;IACrD,EAAE,EAAE,gBAAa,CAAC,UAAU;IAC5B,gBAAgB,EAAE,gBAAa,CAAC,gBAAgB;IAChD,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,kCAA0B,CAAC,CAAC,QAAQ,EAAE;CACtE,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,iBAAiB,GAC5B,qBAAU,CAAC,YAAY,CAAgC;IACrD,gBAAgB,EAAE,gBAAa,CAAC,gBAAgB;IAChD,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,kCAA0B,CAAC,CAAC,QAAQ,EAAE;CACtE,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,oBAAoB,GAC/B,qBAAU,CAAC,YAAY,CAAmC;IACxD,MAAM,EAAE,qBAAU,CAAC,KAAK,CAAC,CAAC,gBAAa,CAAC,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvF,UAAU,EAAE,wBAAgB,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,gBAAa,CAAC,wBAAwB,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,yBAAyB,GAAqD,qBAAU,CAAC,OAAO,CAI3G,CACE,IAAa,EACb,IAA+D,EAC/D,OAAiB,EAC8B,EAAE;IACjD,OAAO,qBAAU,CAAC,YAAY,CAAwC;QACpE,SAAS,EAAE,qBAAU,CAAC,QAAQ,CAAC,yBAAiB,CAAC,CAAC,QAAQ,EAAE;QAC5D,QAAQ,EAAE,qBAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;KAC/C,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC,CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,oBAAoB,GAC/B,qBAAU,CAAC,YAAY,CAAmC;IACxD,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,qBAAU,CAAC,QAAQ,CAAC,yBAAiB,CAAC,CAAC,QAAQ,EAAE;IAC5D,QAAQ,EAAE,qBAAU,CAAC,QAAQ,CAAC,iCAAyB,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC;AAEL;;;GAGG;AACU,QAAA,sBAAsB,GAAkD,qBAAU,CAAC,OAAO,CAIrG,CACE,IAAa,EACb,IAA4D,EAC5D,OAAiB,EAC2B,EAAE;IAC9C,OAAO,qBAAU,CAAC,YAAY,CAAqC;QACjE,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE;QACxC,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,kCAA0B,CAAC,CAAC,QAAQ,EAAE;QACrE,SAAS,EAAE,qBAAU,CAAC,OAAO,CAAC,yBAAiB,CAAC,CAAC,QAAQ,EAAE;QAC3D,WAAW,EAAE,qBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAChD,QAAQ,EAAE,yBAAc,CAAC,UAAU,CAAC,QAAQ,EAAE;KAC/C,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC,CACF,CAAC;AAEF;;;;GAIG;AACU,QAAA,8BAA8B,GACzC,qBAAU,CAAC,OAAO,CAChB,CACE,IAAa,EACb,IAAoE,EACpE,OAAiB,EACmC,EAAE;IACtD,OAAO,qBAAU,CAAC,YAAY,CAA6C;QACzE,OAAO,EAAE,4BAAoB,CAAC,QAAQ,EAAE;QACxC,UAAU,EAAE,qBAAU,CAAC,OAAO,CAAC,qCAA6B,CAAC,CAAC,QAAQ,EAAE;QACxE,SAAS,EAAE,qBAAU,CAAC,OAAO,CAAC,qBAAU,CAAC,KAAK,CAAC,CAAC,yBAAiB,EAAE,yBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAClG,WAAW,EAAE,qBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAChD,QAAQ,EAAE,yBAAc,CAAC,UAAU,CAAC,QAAQ,EAAE;KAC/C,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC,CACF,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 { 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.Normalized.IImporterResourceCandidateDecl | importer resource candidate declaration}.\n * @public\n */\nexport const importerResourceCandidateDecl: Converter<Normalized.IImporterResourceCandidateDecl> =\n  Converters.strictObject<Normalized.IImporterResourceCandidateDecl>({\n    id: CommonConvert.resourceId.optional(),\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.IContainerContextDecl | resource context declaration}.\n * @public\n */\nexport const containerContextDecl: Converter<Normalized.IContainerContextDecl> =\n  Converters.strictObject<Normalized.IContainerContextDecl>({\n    baseId: Converters.oneOf([CommonConvert.resourceId, Converters.literal('')]).optional(),\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.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    context: containerContextDecl.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      context: containerContextDecl.optional(),\n      candidates: Converters.arrayOf(looseResourceCandidateDecl).optional(),\n      resources: Converters.arrayOf(looseResourceDecl).optional(),\n      collections: Converters.arrayOf(self).optional(),\n      metadata: JsonConverters.jsonObject.optional()\n    }).convert(from, context);\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.IImporterResourceCollectionDecl | importer resource collection declaration}.\n * This allows for a mix of loose and child resource declarations.\n * @public\n */\nexport const importerResourceCollectionDecl: Converter<Normalized.IImporterResourceCollectionDecl> =\n  Converters.generic<Normalized.IImporterResourceCollectionDecl, unknown>(\n    (\n      from: unknown,\n      self: Converter<Normalized.IImporterResourceCollectionDecl, unknown>,\n      context?: unknown\n    ): Result<Normalized.IImporterResourceCollectionDecl> => {\n      return Converters.strictObject<Normalized.IImporterResourceCollectionDecl>({\n        context: containerContextDecl.optional(),\n        candidates: Converters.arrayOf(importerResourceCandidateDecl).optional(),\n        resources: Converters.arrayOf(Converters.oneOf([looseResourceDecl, childResourceDecl])).optional(),\n        collections: Converters.arrayOf(self).optional(),\n        metadata: JsonConverters.jsonObject.optional()\n      }).convert(from, context);\n    }\n  );\n"]}

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

@@ -8,10 +8,24 @@ import * as Json from './json';
 export interface IDeclarationOptions {
     /**
      * If `true`, properties with default values will be included in the
-     * output. IF omitted or `false`, properties with default values will be omitted.
+     * output. If omitted or `false`, properties with default values will be omitted.
      */
     showDefaults?: boolean;
+    /**
+     * If `true`, the output will be normalized using hash-based ordering for consistent structure.
+     * If omitted or `false`, no normalization will be applied. Defaults to `false`.
+     */
+    normalized?: boolean;
 }
+/**
+ * Helper method to merge a resource context declaration with a parent name and conditions.
+ * @param decl - The resource context declaration to merge.
+ * @param parentName - The name of the parent resource.
+ * @param parentConditions - The conditions of the parent resource.
+ * @returns `Success` with the merged resource context declaration if successful, otherwise `Failure`.
+ * @public
+ */
+export declare function mergeContextDecl(decl?: Normalized.IContainerContextDecl, parentName?: string, parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.IContainerContextDecl>;
 /**
  * Helper method to merge a loose candidate with a base name and conditions.
  * @param candidate - The candidate to merge.
@@ -20,7 +34,34 @@ export interface IDeclarationOptions {
  * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
  * @public
  */
-export declare function mergeLooseCandidate(candidate: Normalized.ILooseResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceCandidateDecl>;
+export declare function mergeLooseCandidate(candidate: Normalized.IImporterResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceCandidateDecl>;
+/**
+ * Helper method to merge a resource candidate with a base name and conditions from import context.
+ * This function enables name inheritance for resource candidates, similar to resources.
+ *
+ * @param candidate - The candidate to merge. Can have an optional ID that will be joined with baseName.
+ * @param baseName - The base name from import context to merge with the candidate.
+ * When provided, this will be used as the parent component of the candidate ID.
+ * @param baseConditions - The base conditions from import context to merge with the candidate's conditions.
+ * @returns `Success` with the merged candidate if successful, otherwise `Failure`.
+ *
+ * @remarks
+ * This function supports name inheritance for candidates:
+ * - Joins baseName with candidate's existing ID using dot notation
+ * - If candidate has no ID, uses baseName as the full ID
+ * - Always merges base conditions with candidate's existing conditions
+ *
+ * @example
+ * ```typescript
+ * // Candidate inherits full name from import context
+ * const candidate = { value: "Hello", conditions: [...] }; // No id field
+ * const result = mergeImporterCandidate(candidate, "pages.home.greeting", []);
+ * // Result: { id: "pages.home.greeting", value: "Hello", conditions: [...] }
+ * ```
+ *
+ * @public
+ */
+export declare function mergeImporterCandidate(candidate: Normalized.IImporterResourceCandidateDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.IImporterResourceCandidateDecl>;
 /**
  * Helper method to merge a child candidate with base conditions.
  * @param candidate - The candidate to merge.
@@ -37,11 +78,49 @@ export declare function mergeChildCandidate(candidate: Normalized.IChildResource
  * @returns `Success` with the merged resource if successful, otherwise `Failure`.
  * @public
  */
-export declare function mergeLooseResource(resource: Normalized.ILooseResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceDecl>;
+export declare function mergeLooseResource(resource: Normalized.IImporterResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.ILooseResourceDecl>;
+/**
+ * Helper method to merge a resource with a base name and conditions from import context.
+ * This function enables name inheritance where resources can automatically inherit their
+ * resource ID from the import context when no explicit ID is provided in the resource declaration.
+ *
+ * @param resource - The resource to merge. Can be either a loose resource (with optional ID)
+ * or a child resource (without ID).
+ * @param baseName - The base name from import context to merge with the resource.
+ * When provided, this will be used as the parent component of the resource ID.
+ * @param baseConditions - The base conditions from import context to merge with the resource's conditions.
+ * @returns `Success` with the merged resource if successful, otherwise `Failure`.
+ *
+ * @remarks
+ * This function supports several scenarios for name inheritance:
+ * - **Explicit ID + Base Name**: Joins baseName.resourceId (e.g., "pages.home" + "greeting" = "pages.home.greeting")
+ * - **No ID + Base Name**: Uses baseName as the resource ID (enables name inheritance from import context)
+ * - **Explicit ID + No Base Name**: Uses the resource's existing ID
+ * - **No ID + No Base Name**: Returns resource without ID (for child resources)
+ *
+ * Base conditions are always merged with the resource's existing conditions.
+ *
+ * @example
+ * ```typescript
+ * // Resource without ID inherits name from import context
+ * const resource = { candidates: [...] }; // No id field
+ * const result = mergeImporterResource(resource, "pages.home", []);
+ * // Result: { id: "pages.home", candidates: [...] }
+ *
+ * // Resource with ID gets joined with base name
+ * const resource = { id: "greeting", candidates: [...] };
+ * const result = mergeImporterResource(resource, "pages.home", []);
+ * // Result: { id: "pages.home.greeting", candidates: [...] }
+ * ```
+ *
+ * @public
+ */
+export declare function mergeImporterResource(resource: Normalized.IImporterResourceDecl, baseName?: string, baseConditions?: ReadonlyArray<Json.ILooseConditionDecl>): Result<Normalized.IImporterResourceDecl>;
 /**
  * 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.d.ts.map

@@ -1 +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;AAG/B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,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,CAAC,GACvD,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,CAAC,GACvD,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,CAAC,GACzD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/helpers.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAc,MAAM,EAAiB,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAI/B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,CAAC,EAAE,UAAU,CAAC,qBAAqB,EACvC,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACzD,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAsB1C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,8BAA8B,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAWhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,UAAU,CAAC,8BAA8B,EACpD,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAanD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,UAAU,CAAC,2BAA2B,EACjD,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAIhD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,UAAU,CAAC,qBAAqB,EAC1C,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAevC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,UAAU,CAAC,qBAAqB,EAC1C,QAAQ,CAAC,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,mBAAmB,CAAC,GACvD,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAoB1C;AAED;;;;;;;;;GASG;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,CAAC,GACzD,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CASvC"}

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":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAElF;;;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":"json.d.ts","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAElF;;;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;;;;GAIG;AACH,MAAM,WAAW,8BAA+B,SAAQ,2BAA2B;IACjF;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;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,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;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;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,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;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,8BAA8B,CAAC,CAAC;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,+BAA+B,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,8BAA8B,GACnC,IAAI,IAAI,2BAA2B,CAErC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,kBAAkB,CAE3F"}