@fgv/ts-res 5.1.0-3 → 5.1.0-30

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

@@ -168,4 +168,229 @@ export const importerResourceCollectionDecl = Converters.generic((from, self, co
         metadata: JsonConverters.jsonObject.optional()
     }).convert(from, context);
 });
+// --- Typed sibling converters (Phase B-2) -----------------------------------
+//
+// Each `typed*<TQualifierNames>(qualifierNameConverter)` returns a converter
+// whose result type is narrowed on `TQualifierNames`. The existing untyped
+// exports above remain unchanged at the signature and behavior level; consumers
+// opt in by calling a typed sibling. Internally each typed factory composes
+// lower-level typed factories so a single `qualifierNameConverter` flows
+// end-to-end through the converter tree.
+//
+// DRIFT HAZARD: each typed sibling duplicates the field list of its untyped
+// twin (the duplication exists to preserve `ObjectConverter` return types on
+// the defaults — see phase-b2-result.md). If a field is added, removed, or
+// re-typed on an untyped converter above, the typed sibling MUST be updated
+// in lockstep. The per-pair `keep in sync with X` markers below flag each
+// pair at the call site.
+/**
+ * Returns a `Converter` for a `Json.ILooseConditionDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `looseConditionDecl` above.
+export function typedLooseConditionDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        qualifierName: qualifierNameConverter,
+        value: Converters.string,
+        operator: CommonConvert.conditionOperator.optional(),
+        priority: CommonConvert.conditionPriority.optional(),
+        scoreAsDefault: Converters.number.optional()
+    });
+}
+function _typedConditionSetDeclFromArray(innerLooseConditionDecl) {
+    return Converters.arrayOf(innerLooseConditionDecl);
+}
+function _typedConditionSetDeclFromRecord(innerLooseConditionDecl) {
+    return Converters.generic((from, __self, context) => {
+        /* c8 ignore next 3 - branch covered by underlying record check */
+        if (!_isConditionSetRecord(from)) {
+            return fail('Expected an object');
+        }
+        return mapResults(Array.from(Object.entries(from)).map(([qualifierName, value]) => {
+            const toConvert = typeof value === 'string' ? { qualifierName, value } : Object.assign({ qualifierName }, value);
+            return innerLooseConditionDecl.convert(toConvert, context);
+        }));
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.ConditionSetDecl<TQualifierNames>`
+ * (either array form or record form) narrowed on a supplied `qualifierName`
+ * converter.
+ *
+ * @public
+ */
+// Keep in sync with `conditionSetDecl` (and its two private feeder converters
+// `conditionSetDeclFromArray` / `conditionSetDeclFromRecord`) above.
+export function typedConditionSetDecl(qualifierNameConverter) {
+    const inner = typedLooseConditionDecl(qualifierNameConverter);
+    return Converters.oneOf([
+        _typedConditionSetDeclFromArray(inner),
+        _typedConditionSetDeclFromRecord(inner)
+    ]);
+}
+/**
+ * Returns a `Converter` for a `Json.ILooseResourceCandidateDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `looseResourceCandidateDecl` above.
+export function typedLooseResourceCandidateDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        id: CommonConvert.resourceId,
+        json: JsonConverters.jsonObject,
+        conditions: typedConditionSetDecl(qualifierNameConverter).optional(),
+        mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),
+        isPartial: Converters.boolean.optional(),
+        resourceTypeName: CommonConvert.resourceTypeName.optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IImporterResourceCandidateDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `importerResourceCandidateDecl` above.
+export function typedImporterResourceCandidateDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        id: CommonConvert.resourceId.optional(),
+        json: JsonConverters.jsonObject,
+        conditions: typedConditionSetDecl(qualifierNameConverter).optional(),
+        mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),
+        isPartial: Converters.boolean.optional(),
+        resourceTypeName: CommonConvert.resourceTypeName.optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IChildResourceCandidateDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `childResourceCandidateDecl` above.
+export function typedChildResourceCandidateDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        json: JsonConverters.jsonObject,
+        conditions: typedConditionSetDecl(qualifierNameConverter).optional(),
+        isPartial: Converters.boolean.optional(),
+        mergeMethod: CommonConvert.resourceValueMergeMethod.optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.ILooseResourceDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `looseResourceDecl` above.
+export function typedLooseResourceDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        id: CommonConvert.resourceId,
+        resourceTypeName: CommonConvert.resourceTypeName,
+        candidates: Converters.arrayOf(typedChildResourceCandidateDecl(qualifierNameConverter)).optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IChildResourceDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `childResourceDecl` above.
+export function typedChildResourceDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        resourceTypeName: CommonConvert.resourceTypeName,
+        candidates: Converters.arrayOf(typedChildResourceCandidateDecl(qualifierNameConverter)).optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IContainerContextDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `containerContextDecl` above.
+export function typedContainerContextDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        baseId: Converters.oneOf([CommonConvert.resourceId, Converters.literal('')]).optional(),
+        conditions: typedConditionSetDecl(qualifierNameConverter).optional(),
+        mergeMethod: CommonConvert.resourceValueMergeMethod.optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IResourceTreeChildNodeDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `resourceTreeChildNodeDecl` above.
+export function typedResourceTreeChildNodeDecl(qualifierNameConverter) {
+    const childResource = typedChildResourceDecl(qualifierNameConverter);
+    return Converters.generic((from, self, context) => {
+        return Converters.strictObject({
+            resources: Converters.recordOf(childResource).optional(),
+            children: Converters.recordOf(self).optional()
+        }).convert(from, context);
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IResourceTreeRootDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `resourceTreeRootDecl` above.
+export function typedResourceTreeRootDecl(qualifierNameConverter) {
+    return Converters.strictObject({
+        context: typedContainerContextDecl(qualifierNameConverter).optional(),
+        resources: Converters.recordOf(typedChildResourceDecl(qualifierNameConverter)).optional(),
+        children: Converters.recordOf(typedResourceTreeChildNodeDecl(qualifierNameConverter)).optional()
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IResourceCollectionDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `resourceCollectionDecl` above.
+export function typedResourceCollectionDecl(qualifierNameConverter) {
+    const containerContext = typedContainerContextDecl(qualifierNameConverter);
+    const looseCandidate = typedLooseResourceCandidateDecl(qualifierNameConverter);
+    const looseResource = typedLooseResourceDecl(qualifierNameConverter);
+    return Converters.generic((from, self, context) => {
+        return Converters.strictObject({
+            context: containerContext.optional(),
+            candidates: Converters.arrayOf(looseCandidate).optional(),
+            resources: Converters.arrayOf(looseResource).optional(),
+            collections: Converters.arrayOf(self).optional(),
+            metadata: JsonConverters.jsonObject.optional()
+        }).convert(from, context);
+    });
+}
+/**
+ * Returns a `Converter` for a `Json.IImporterResourceCollectionDecl<TQualifierNames>`
+ * narrowed on a supplied `qualifierName` converter.
+ *
+ * @public
+ */
+// Keep in sync with `importerResourceCollectionDecl` above.
+export function typedImporterResourceCollectionDecl(qualifierNameConverter) {
+    const containerContext = typedContainerContextDecl(qualifierNameConverter);
+    const importerCandidate = typedImporterResourceCandidateDecl(qualifierNameConverter);
+    const looseResource = typedLooseResourceDecl(qualifierNameConverter);
+    const childResource = typedChildResourceDecl(qualifierNameConverter);
+    return Converters.generic((from, self, context) => {
+        return Converters.strictObject({
+            context: containerContext.optional(),
+            candidates: Converters.arrayOf(importerCandidate).optional(),
+            resources: Converters.arrayOf(Converters.oneOf([looseResource, childResource])).optional(),
+            collections: Converters.arrayOf(self).optional(),
+            metadata: JsonConverters.jsonObject.optional()
+        }).convert(from, context);
+    });
+}
 //# sourceMappingURL=convert.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/convert.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Converter, Converters, mapResults, Result, fail } from '@fgv/ts-utils';\nimport { Convert as CommonConvert } from '../common';\nimport { isJsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';\nimport * as Json from './json';\nimport * as Normalized from './normalized';\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseConditionDecl | loose condition declaration}.\n * @public\n */\nexport const looseConditionDecl: Converter<Json.ILooseConditionDecl> =\n  Converters.strictObject<Json.ILooseConditionDecl>({\n    qualifierName: CommonConvert.qualifierName,\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.IChildConditionDecl | child condition declaration}.\n * @public\n */\nexport const childConditionDecl: Converter<Json.IChildConditionDecl> =\n  Converters.strictObject<Json.IChildConditionDecl>({\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n\nfunction _isConditionSetRecord(from: unknown): from is Record<string, string | Json.IChildConditionDecl> {\n  return isJsonObject(from);\n}\n\nconst conditionSetDeclFromArray: Converter<Normalized.ConditionSetDecl> =\n  Converters.arrayOf(looseConditionDecl);\nconst conditionSetDeclFromRecord: Converter<Normalized.ConditionSetDecl> = Converters.generic<\n  Normalized.ConditionSetDecl,\n  unknown\n>(\n  (\n    from: unknown,\n    __self: Converter<Normalized.ConditionSetDecl, unknown>,\n    context?: unknown\n  ): Result<Normalized.ConditionSetDecl> => {\n    /* c8 ignore next 3 - this is tested but coverage is confused */\n    if (!_isConditionSetRecord(from)) {\n      return fail('Expected an object');\n    }\n    return mapResults(\n      Array.from(Object.entries(from)).map(([qualifierName, value]) => {\n        const toConvert: Json.ILooseConditionDecl =\n          typeof value === 'string' ? { qualifierName, value } : { qualifierName, ...value };\n        return looseConditionDecl.convert(toConvert, context);\n      })\n    );\n  }\n);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Normalized.ConditionSetDecl | condition set declaration}.\n * @public\n */\nexport const conditionSetDecl: Converter<Normalized.ConditionSetDecl> =\n  Converters.oneOf<Normalized.ConditionSetDecl>([conditionSetDeclFromArray, conditionSetDeclFromRecord]);\n\n/**\n * `Converter` for a normalized {@link ResourceJson.Json.ILooseResourceCandidateDecl | loose resource candidate declaration}.\n * @public\n */\nexport const looseResourceCandidateDecl: Converter<Normalized.ILooseResourceCandidateDecl> =\n  Converters.strictObject<Normalized.ILooseResourceCandidateDecl>({\n    id: CommonConvert.resourceId,\n    json: JsonConverters.jsonObject,\n    conditions: conditionSetDecl.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n\n/**\n * `Converter` for a normalized {@link ResourceJson.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\n// --- Typed sibling converters (Phase B-2) -----------------------------------\n//\n// Each `typed*<TQualifierNames>(qualifierNameConverter)` returns a converter\n// whose result type is narrowed on `TQualifierNames`. The existing untyped\n// exports above remain unchanged at the signature and behavior level; consumers\n// opt in by calling a typed sibling. Internally each typed factory composes\n// lower-level typed factories so a single `qualifierNameConverter` flows\n// end-to-end through the converter tree.\n//\n// DRIFT HAZARD: each typed sibling duplicates the field list of its untyped\n// twin (the duplication exists to preserve `ObjectConverter` return types on\n// the defaults — see phase-b2-result.md). If a field is added, removed, or\n// re-typed on an untyped converter above, the typed sibling MUST be updated\n// in lockstep. The per-pair `keep in sync with X` markers below flag each\n// pair at the call site.\n\n/**\n * Returns a `Converter` for a `Json.ILooseConditionDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `looseConditionDecl` above.\nexport function typedLooseConditionDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.ILooseConditionDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.ILooseConditionDecl<TQualifierNames>>({\n    qualifierName: qualifierNameConverter,\n    value: Converters.string,\n    operator: CommonConvert.conditionOperator.optional(),\n    priority: CommonConvert.conditionPriority.optional(),\n    scoreAsDefault: Converters.number.optional()\n  });\n}\n\nfunction _typedConditionSetDeclFromArray<TQualifierNames extends string>(\n  innerLooseConditionDecl: Converter<Json.ILooseConditionDecl<TQualifierNames>>\n): Converter<Json.ConditionSetDeclAsArray<TQualifierNames>> {\n  return Converters.arrayOf(innerLooseConditionDecl);\n}\n\nfunction _typedConditionSetDeclFromRecord<TQualifierNames extends string>(\n  innerLooseConditionDecl: Converter<Json.ILooseConditionDecl<TQualifierNames>>\n): Converter<Json.ConditionSetDecl<TQualifierNames>> {\n  return Converters.generic<Json.ConditionSetDecl<TQualifierNames>, unknown>(\n    (\n      from: unknown,\n      __self: Converter<Json.ConditionSetDecl<TQualifierNames>, unknown>,\n      context?: unknown\n    ): Result<Json.ConditionSetDecl<TQualifierNames>> => {\n      /* c8 ignore next 3 - branch covered by underlying record check */\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 innerLooseConditionDecl.convert(toConvert, context);\n        })\n      );\n    }\n  );\n}\n\n/**\n * Returns a `Converter` for a `Json.ConditionSetDecl<TQualifierNames>`\n * (either array form or record form) narrowed on a supplied `qualifierName`\n * converter.\n *\n * @public\n */\n// Keep in sync with `conditionSetDecl` (and its two private feeder converters\n// `conditionSetDeclFromArray` / `conditionSetDeclFromRecord`) above.\nexport function typedConditionSetDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.ConditionSetDecl<TQualifierNames>> {\n  const inner = typedLooseConditionDecl(qualifierNameConverter);\n  return Converters.oneOf<Json.ConditionSetDecl<TQualifierNames>>([\n    _typedConditionSetDeclFromArray(inner),\n    _typedConditionSetDeclFromRecord(inner)\n  ]);\n}\n\n/**\n * Returns a `Converter` for a `Json.ILooseResourceCandidateDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `looseResourceCandidateDecl` above.\nexport function typedLooseResourceCandidateDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.ILooseResourceCandidateDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.ILooseResourceCandidateDecl<TQualifierNames>>({\n    id: CommonConvert.resourceId,\n    json: JsonConverters.jsonObject,\n    conditions: typedConditionSetDecl(qualifierNameConverter).optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.IImporterResourceCandidateDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `importerResourceCandidateDecl` above.\nexport function typedImporterResourceCandidateDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IImporterResourceCandidateDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.IImporterResourceCandidateDecl<TQualifierNames>>({\n    id: CommonConvert.resourceId.optional(),\n    json: JsonConverters.jsonObject,\n    conditions: typedConditionSetDecl(qualifierNameConverter).optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional(),\n    isPartial: Converters.boolean.optional(),\n    resourceTypeName: CommonConvert.resourceTypeName.optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.IChildResourceCandidateDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `childResourceCandidateDecl` above.\nexport function typedChildResourceCandidateDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IChildResourceCandidateDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.IChildResourceCandidateDecl<TQualifierNames>>({\n    json: JsonConverters.jsonObject,\n    conditions: typedConditionSetDecl(qualifierNameConverter).optional(),\n    isPartial: Converters.boolean.optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.ILooseResourceDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `looseResourceDecl` above.\nexport function typedLooseResourceDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.ILooseResourceDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.ILooseResourceDecl<TQualifierNames>>({\n    id: CommonConvert.resourceId,\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(typedChildResourceCandidateDecl(qualifierNameConverter)).optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.IChildResourceDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `childResourceDecl` above.\nexport function typedChildResourceDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IChildResourceDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.IChildResourceDecl<TQualifierNames>>({\n    resourceTypeName: CommonConvert.resourceTypeName,\n    candidates: Converters.arrayOf(typedChildResourceCandidateDecl(qualifierNameConverter)).optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.IContainerContextDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `containerContextDecl` above.\nexport function typedContainerContextDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IContainerContextDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.IContainerContextDecl<TQualifierNames>>({\n    baseId: Converters.oneOf([CommonConvert.resourceId, Converters.literal('')]).optional(),\n    conditions: typedConditionSetDecl(qualifierNameConverter).optional(),\n    mergeMethod: CommonConvert.resourceValueMergeMethod.optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.IResourceTreeChildNodeDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `resourceTreeChildNodeDecl` above.\nexport function typedResourceTreeChildNodeDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IResourceTreeChildNodeDecl<TQualifierNames>> {\n  const childResource = typedChildResourceDecl(qualifierNameConverter);\n  return Converters.generic<Json.IResourceTreeChildNodeDecl<TQualifierNames>, unknown>(\n    (\n      from: unknown,\n      self: Converter<Json.IResourceTreeChildNodeDecl<TQualifierNames>, unknown>,\n      context?: unknown\n    ): Result<Json.IResourceTreeChildNodeDecl<TQualifierNames>> => {\n      return Converters.strictObject<Json.IResourceTreeChildNodeDecl<TQualifierNames>>({\n        resources: Converters.recordOf(childResource).optional(),\n        children: Converters.recordOf(self).optional()\n      }).convert(from, context);\n    }\n  );\n}\n\n/**\n * Returns a `Converter` for a `Json.IResourceTreeRootDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `resourceTreeRootDecl` above.\nexport function typedResourceTreeRootDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IResourceTreeRootDecl<TQualifierNames>> {\n  return Converters.strictObject<Json.IResourceTreeRootDecl<TQualifierNames>>({\n    context: typedContainerContextDecl(qualifierNameConverter).optional(),\n    resources: Converters.recordOf(typedChildResourceDecl(qualifierNameConverter)).optional(),\n    children: Converters.recordOf(typedResourceTreeChildNodeDecl(qualifierNameConverter)).optional()\n  });\n}\n\n/**\n * Returns a `Converter` for a `Json.IResourceCollectionDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `resourceCollectionDecl` above.\nexport function typedResourceCollectionDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IResourceCollectionDecl<TQualifierNames>> {\n  const containerContext = typedContainerContextDecl(qualifierNameConverter);\n  const looseCandidate = typedLooseResourceCandidateDecl(qualifierNameConverter);\n  const looseResource = typedLooseResourceDecl(qualifierNameConverter);\n  return Converters.generic<Json.IResourceCollectionDecl<TQualifierNames>, unknown>(\n    (\n      from: unknown,\n      self: Converter<Json.IResourceCollectionDecl<TQualifierNames>, unknown>,\n      context?: unknown\n    ): Result<Json.IResourceCollectionDecl<TQualifierNames>> => {\n      return Converters.strictObject<Json.IResourceCollectionDecl<TQualifierNames>>({\n        context: containerContext.optional(),\n        candidates: Converters.arrayOf(looseCandidate).optional(),\n        resources: Converters.arrayOf(looseResource).optional(),\n        collections: Converters.arrayOf(self).optional(),\n        metadata: JsonConverters.jsonObject.optional()\n      }).convert(from, context);\n    }\n  );\n}\n\n/**\n * Returns a `Converter` for a `Json.IImporterResourceCollectionDecl<TQualifierNames>`\n * narrowed on a supplied `qualifierName` converter.\n *\n * @public\n */\n// Keep in sync with `importerResourceCollectionDecl` above.\nexport function typedImporterResourceCollectionDecl<TQualifierNames extends string>(\n  qualifierNameConverter: Converter<TQualifierNames>\n): Converter<Json.IImporterResourceCollectionDecl<TQualifierNames>> {\n  const containerContext = typedContainerContextDecl(qualifierNameConverter);\n  const importerCandidate = typedImporterResourceCandidateDecl(qualifierNameConverter);\n  const looseResource = typedLooseResourceDecl(qualifierNameConverter);\n  const childResource = typedChildResourceDecl(qualifierNameConverter);\n  return Converters.generic<Json.IImporterResourceCollectionDecl<TQualifierNames>, unknown>(\n    (\n      from: unknown,\n      self: Converter<Json.IImporterResourceCollectionDecl<TQualifierNames>, unknown>,\n      context?: unknown\n    ): Result<Json.IImporterResourceCollectionDecl<TQualifierNames>> => {\n      return Converters.strictObject<Json.IImporterResourceCollectionDecl<TQualifierNames>>({\n        context: containerContext.optional(),\n        candidates: Converters.arrayOf(importerCandidate).optional(),\n        resources: Converters.arrayOf(Converters.oneOf([looseResource, childResource])).optional(),\n        collections: Converters.arrayOf(self).optional(),\n        metadata: JsonConverters.jsonObject.optional()\n      }).convert(from, context);\n    }\n  );\n}\n"]}

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

@@ -0,0 +1 @@
+{"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  /* c8 ignore next 7 - functional code tested but coverage intermittently missed */\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 5 - functional code tested but coverage intermittently missed */\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  /* c8 ignore next 10 - functional code tested but coverage intermittently missed */\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    /* c8 ignore next 8 - functional code tested but coverage intermittently missed */\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/dist/packlets/resource-json/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,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","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/dist/packlets/resource-json/json.js

@@ -24,13 +24,13 @@
  * @public
  */
 export function isLooseResourceCandidateDecl(decl) {
-    return 'id' in decl;
+    return 'id' in decl && typeof decl.id === 'string';
 }
 /**
  * Type guard function to check if a resource declaration is a loose resource declaration.
  * @public
  */
 export function isLooseResourceDecl(decl) {
-    return 'id' in decl;
+    return 'id' in decl && typeof decl.id === 'string';
 }
 //# sourceMappingURL=json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuWH;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAqD;IAErD,OAAO,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA4C;IAE5C,OAAO,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC;AACrD,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 *\n * @remarks\n * Parameterized on `TQualifierNames` so consumers authoring conditions\n * in code can opt into compile-time axis-name discipline (e.g. via a\n * literal-string union derived from a `qualifiers: ['tone'] as const`\n * decl-array). Defaults to `string`, so existing untyped callers\n * compile unchanged.\n *\n * @public\n */\nexport interface ILooseConditionDecl<TQualifierNames extends string = string> {\n  /**\n   * The name of the {@link Qualifiers.Qualifier | qualifier} to be compared.\n   */\n  qualifierName: TQualifierNames;\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 array-form declaration of a {@link Conditions.ConditionSet | condition set}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` via `ILooseConditionDecl`;\n * defaults to `string` for back-compat with existing untyped callers.\n *\n * @public\n */\nexport type ConditionSetDeclAsArray<TQualifierNames extends string = string> = ReadonlyArray<\n  ILooseConditionDecl<TQualifierNames>\n>;\n\n/**\n * Non-validated record-form declaration of a {@link Conditions.ConditionSet | condition set}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; defaults to `string` for back-compat with\n * existing untyped callers. Uses `Readonly<Partial<Record<...>>>` to align with\n * runtime reality (missing keys produce `undefined`; the `Partial` makes TypeScript\n * aware of this, which is a strict type-system tightening).\n *\n * @public\n */\nexport type ConditionSetDeclAsRecord<TQualifierNames extends string = string> = Readonly<\n  Partial<Record<TQualifierNames, string | IChildConditionDecl>>\n>;\n\n/**\n * Non-validated declaration of a {@link Conditions.ConditionSet | condition set}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; defaults to `string`. Both the\n * array form (`ConditionSetDeclAsArray`) and the record form\n * (`ConditionSetDeclAsRecord`) inherit the parameter, so a\n * consumer threading a narrow `TQualifierNames` gets compile-time\n * rejection of typo'd axis names in either form.\n *\n * @public\n */\nexport type ConditionSetDecl<TQualifierNames extends string = string> =\n  | ConditionSetDeclAsArray<TQualifierNames>\n  | ConditionSetDeclAsRecord<TQualifierNames>;\n\n/**\n * Non-validated child declaration of a {@link Resources.ResourceCandidate | resource candidate}.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `conditions` field can carry a\n * narrowed axis-name set. Defaults to `string` so existing untyped callers\n * compile unchanged.\n *\n * @public\n */\nexport interface IChildResourceCandidateDecl<TQualifierNames extends string = string> {\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<TQualifierNames>;\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 *\n * @remarks\n * Parameterized on `TQualifierNames`; inherits via `IChildResourceCandidateDecl`.\n * Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface IImporterResourceCandidateDecl<TQualifierNames extends string = string>\n  extends IChildResourceCandidateDecl<TQualifierNames> {\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 *\n * @remarks\n * Parameterized on `TQualifierNames`; inherits via `IChildResourceCandidateDecl`.\n * Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface ILooseResourceCandidateDecl<TQualifierNames extends string = string>\n  extends IChildResourceCandidateDecl<TQualifierNames> {\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<TQualifierNames>;\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 *\n * @remarks\n * Parameterized on `TQualifierNames` so the `candidates` field threads the\n * narrowed axis-name set down to each candidate. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IChildResourceDecl<TQualifierNames extends string = string> {\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<TQualifierNames>>;\n}\n\n/**\n * Non-validated loose declaration of a {@link Resources.Resource | resource}.\n *\n * @remarks\n * Parameterized on `TQualifierNames`; inherits via `IChildResourceDecl`.\n * Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface ILooseResourceDecl<TQualifierNames extends string = string>\n  extends IChildResourceDecl<TQualifierNames> {\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<TQualifierNames>>;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree node.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `resources` and `children` fields\n * thread the narrowed axis-name set throughout the tree. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IResourceTreeChildNodeDecl<TQualifierNames extends string = string> {\n  readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;\n}\n\n/**\n * Declared context for a resource container.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `conditions` field threads the\n * narrowed axis-name set to the container context. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IContainerContextDecl<TQualifierNames extends string = string> {\n  readonly baseId?: string;\n  readonly conditions?: ConditionSetDecl<TQualifierNames>;\n  readonly mergeMethod?: ResourceValueMergeMethod;\n}\n\n/**\n * Normalized non-validated declaration of a {@link Resources.Resource | resource} tree root.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `context` field threads the\n * narrowed axis-name set to the tree root context. Defaults to `string` for\n * back-compat.\n *\n * @public\n */\nexport interface IResourceTreeRootDecl<TQualifierNames extends string = string>\n  extends IResourceTreeChildNodeDecl<TQualifierNames> {\n  readonly context?: IContainerContextDecl<TQualifierNames>;\n  readonly resources?: Record<string, IChildResourceDecl<TQualifierNames>>;\n  readonly children?: Record<string, IResourceTreeChildNodeDecl<TQualifierNames>>;\n  readonly metadata?: JsonObject;\n}\n\n/**\n * Non-validated declaration of a collection of resources.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `context`, `candidates`, and\n * `resources` fields thread the narrowed axis-name set throughout the\n * collection. Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface IResourceCollectionDecl<TQualifierNames extends string = string> {\n  readonly context?: IContainerContextDecl<TQualifierNames>;\n  readonly candidates?: ReadonlyArray<ILooseResourceCandidateDecl<TQualifierNames>>;\n  readonly resources?: ReadonlyArray<ILooseResourceDecl<TQualifierNames>>;\n  readonly collections?: ReadonlyArray<IResourceCollectionDecl<TQualifierNames>>;\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 *\n * @remarks\n * Parameterized on `TQualifierNames`; defaults to `string` for back-compat.\n *\n * @public\n */\nexport type IImporterResourceDecl<TQualifierNames extends string = string> =\n  | ILooseResourceDecl<TQualifierNames>\n  | IChildResourceDecl<TQualifierNames>;\n\n/**\n * Non-validated declaration of a collection of resources for an importer.\n *\n * @remarks\n * Parameterized on `TQualifierNames` so the `context`, `candidates`, and\n * `resources` fields thread the narrowed axis-name set throughout the\n * importer collection. Defaults to `string` for back-compat.\n *\n * @public\n */\nexport interface IImporterResourceCollectionDecl<TQualifierNames extends string = string> {\n  readonly context?: IContainerContextDecl<TQualifierNames>;\n  readonly candidates?: ReadonlyArray<IImporterResourceCandidateDecl<TQualifierNames>>;\n  readonly resources?: ReadonlyArray<IImporterResourceDecl<TQualifierNames>>;\n  readonly collections?: ReadonlyArray<IImporterResourceCollectionDecl<TQualifierNames>>;\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<TQualifierNames extends string = string>(\n  decl: IImporterResourceCandidateDecl<TQualifierNames>\n): decl is ILooseResourceCandidateDecl<TQualifierNames> {\n  return 'id' in decl && typeof decl.id === 'string';\n}\n\n/**\n * Type guard function to check if a resource declaration is a loose resource declaration.\n * @public\n */\nexport function isLooseResourceDecl<TQualifierNames extends string = string>(\n  decl: IImporterResourceDecl<TQualifierNames>\n): decl is ILooseResourceDecl<TQualifierNames> {\n  return 'id' in decl && typeof decl.id === 'string';\n}\n"]}

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

@@ -0,0 +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 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"]}

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

@@ -29,7 +29,7 @@ import { mergeContextDecl, mergeImporterCandidate, mergeImporterResource } from
  */
 export class ResourceDeclCollection {
     /**
-     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     * {@inheritDoc ResourceJson.IResourceDeclContainer.context}
      */
     get context() {
         return this.collection.context;

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceDeclCollection.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclCollection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9F,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE5F;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAOjC;;OAEG;IACH,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IACjC,CAAC;IAKD,YAAsB,UAAsD;QAHlE,eAAU,GAAuC,EAAE,CAAC;QACpD,gBAAW,GAAgD,EAAE,CAAC;QAGtE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,IAAa;QAChC,OAAO,OAAO,CAAC,8BAA8B;aAC1C,OAAO,CAAC,IAAI,CAAC;aACb,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gCAAgC,GAAG,EAAE,CAAC;aAC/D,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACI,oBAAoB;QACzB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAEO,QAAQ,CACd,UAAsD,EACtD,UAAmB,EACnB,gBAA0D;QAE1D,MAAM,MAAM,GAAsB,IAAI,iBAAiB,EAAE,CAAC;QAC1D,OAAO,gBAAgB,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,SAAS,CACjF,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,EAAE;;YACnD,MAAM,gBAAgB,GACpB,MAAA,MAAA,UAAU,CAAC,UAAU,0CAAE,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACvC,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAC5D,mCAAI,EAAE,CAAC;YACV,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAE5F,MAAM,eAAe,GACnB,MAAA,MAAA,UAAU,CAAC,SAAS,0CAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACrC,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAC1D,mCAAI,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;YAE1F,MAAA,UAAU,CAAC,WAAW,0CAAE,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;gBAChD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC,CACF,CAAC;IACJ,CAAC;CACF","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 { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { mergeContextDecl, mergeImporterCandidate, mergeImporterResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.\n * @public\n */\nexport class ResourceDeclCollection implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceCollectionDecl | resource collection declaration}\n   * being processed.\n   */\n  public readonly collection: Normalized.IImporterResourceCollectionDecl;\n\n  /**\n   * {@inheritDoc ResourceJson.IResourceDeclContainer.context}\n   */\n  public get context(): Normalized.IContainerContextDecl | undefined {\n    return this.collection.context;\n  }\n\n  protected _resources: Normalized.IImporterResourceDecl[] = [];\n  protected _candidates: Normalized.IImporterResourceCandidateDecl[] = [];\n\n  protected constructor(collection: Normalized.IImporterResourceCollectionDecl) {\n    this.collection = collection;\n    this._extract(collection).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclCollection | ResourceDeclCollection} from an\n   * untyped {@link ResourceJson.Json.IResourceCollectionDecl | resource collection declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new collection if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclCollection> {\n    return Convert.importerResourceCollectionDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource collection: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclCollection(decl));\n      });\n  }\n\n  /**\n   * Gets the importer resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource declarations}\n   * extracted from the collection.\n   */\n  public getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the importer candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    collection: Normalized.IImporterResourceCollectionDecl,\n    parentName?: string,\n    parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n    return mergeContextDecl(collection.context, parentName, parentConditions).onSuccess(\n      ({ baseId: baseName, conditions: baseConditions }) => {\n        const mergedCandidates =\n          collection.candidates?.map((candidate) =>\n            mergeImporterCandidate(candidate, baseName, baseConditions)\n          ) ?? [];\n        this._candidates.push(...mapResults(mergedCandidates).aggregateError(errors).orDefault([]));\n\n        const mergedResources =\n          collection.resources?.map((resource) =>\n            mergeImporterResource(resource, baseName, baseConditions)\n          ) ?? [];\n        this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n        collection.collections?.forEach((subCollection) => {\n          this._extract(subCollection, baseName, baseConditions).aggregateError(errors);\n        });\n        return errors.returnOrReport(succeed(this));\n      }\n    );\n  }\n}\n"]}

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceDeclContainer.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclContainer.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 * as Normalized from './normalized';\n\n/**\n * Generic container for resource and resource candidate\n * declarations.\n * @public\n */\nexport interface IResourceDeclContainer {\n  /**\n   * Optional initial {@link ResourceJson.Normalized.IContainerContextDecl | resource context}\n   * declaration for the container.\n   */\n  readonly context?: Normalized.IContainerContextDecl;\n\n  /**\n   * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceDecl | importer resource}\n   * declarations for all resources in the container, including children.\n   */\n  getImporterResources(): ReadonlyArray<Normalized.IImporterResourceDecl>;\n\n  /**\n   * Gets a normalized array of {@link ResourceJson.Normalized.IImporterResourceCandidateDecl | importer resource candidate}\n   * declarations for all resources in the container, including children.\n   */\n  getImporterCandidates(): ReadonlyArray<Normalized.IImporterResourceCandidateDecl>;\n}\n"]}

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

@@ -30,7 +30,7 @@ import { mergeChildResource } from './helpers';
  */
 export class ResourceDeclTree {
     /**
-     * {@inheritdoc ResourceJson.IResourceDeclContainer.context}
+     * {@inheritDoc ResourceJson.IResourceDeclContainer.context}
      */
     get context() {
         return this.tree.context;

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceDeclTree.js","sourceRoot":"","sources":["../../../src/packlets/resource-json/resourceDeclTree.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 { captureResult, mapResults, MessageAggregator, Result, succeed } from '@fgv/ts-utils';\nimport { IResourceDeclContainer } from './resourceDeclContainer';\nimport * as Convert from './convert';\nimport * as Normalized from './normalized';\nimport * as Json from './json';\nimport { Helpers as CommonHelpers } from '../common';\nimport { mergeChildResource } from './helpers';\n\n/**\n * Class that extracts resources and candidates from a\n * {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root}.\n * @public\n */\nexport class ResourceDeclTree implements IResourceDeclContainer {\n  /**\n   * The {@link ResourceJson.Normalized.IResourceTreeRootDecl | resource tree root declaration}\n   * being processed.\n   */\n  public readonly tree: Normalized.IResourceTreeRootDecl;\n\n  /**\n   * {@inheritDoc ResourceJson.IResourceDeclContainer.context}\n   */\n  public get context(): Normalized.IContainerContextDecl | undefined {\n    return this.tree.context;\n  }\n\n  protected _resources: Normalized.ILooseResourceDecl[] = [];\n  protected _candidates: Normalized.ILooseResourceCandidateDecl[] = [];\n\n  protected constructor(tree: Normalized.IResourceTreeRootDecl) {\n    this.tree = tree;\n    const id = tree.context?.baseId;\n    const conditions = tree.context?.conditions;\n    this._extract(tree, id, conditions).orThrow();\n  }\n\n  /**\n   * Creates a new {@link ResourceJson.ResourceDeclTree | ResourceDeclTree} from an\n   * untyped {@link ResourceJson.Json.IResourceTreeRootDecl | resource tree root declaration}.\n   * @param from - The JSON object to convert.\n   * @returns `Success` with the new tree if the JSON object is valid, otherwise `Failure`.\n   */\n  public static create(from: unknown): Result<ResourceDeclTree> {\n    return Convert.resourceTreeRootDecl\n      .convert(from)\n      .withErrorFormat((err) => `Invalid resource tree: ${err}`)\n      .onSuccess((decl) => {\n        return captureResult(() => new ResourceDeclTree(decl));\n      });\n  }\n\n  /**\n   * Gets the loose resources extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceDecl | loose resource declarations}\n   * extracted from the collection.\n   */\n  public getImporterResources(): ReadonlyArray<Normalized.ILooseResourceDecl> {\n    return this._resources;\n  }\n\n  /**\n   * Gets the loose candidates extracted from the collection.\n   * @returns The {@link ResourceJson.Normalized.ILooseResourceCandidateDecl | loose resource candidate declarations}\n   * extracted from the collection.\n   */\n  public getImporterCandidates(): ReadonlyArray<Normalized.ILooseResourceCandidateDecl> {\n    return this._candidates;\n  }\n\n  private _extract(\n    node: Normalized.IResourceTreeChildNodeDecl,\n    parentName?: string,\n    parentConditions?: ReadonlyArray<Json.ILooseConditionDecl>\n  ): Result<this> {\n    const errors: MessageAggregator = new MessageAggregator();\n\n    const resourceEntries = Array.from(Object.entries(node.resources ?? {}));\n    const mergedResources = resourceEntries.map(([name, resource]) =>\n      mergeChildResource(resource, name, parentName, parentConditions)\n    );\n    this._resources.push(...mapResults(mergedResources).aggregateError(errors).orDefault([]));\n\n    const children = Array.from(Object.entries(node.children ?? {}));\n    children.forEach(([name, childNode]) => {\n      CommonHelpers.joinResourceIds(parentName, name)\n        .onSuccess((childName) => {\n          return this._extract(childNode, childName, parentConditions).aggregateError(errors);\n        })\n        .aggregateError(errors);\n    });\n    return errors.returnOrReport(succeed(this));\n  }\n}\n"]}

package/dist/packlets/resource-types/config/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,2CAA2C;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,YAAY,CAAsB;IAC7E,IAAI,EAAE,UAAU,CAAC,MAAM;IACvB,QAAQ,EAAE,UAAU,CAAC,MAAM;IAC3B,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,QAAQ,EAAE;CAC/C,CAAC,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\n/* eslint-disable @rushstack/typedef-var */\n\nimport { Converters } from '@fgv/ts-utils';\nimport { Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { IResourceTypeConfig } from './json';\n\n/**\n * A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.\n * @returns A `Converter` for {@link ResourceTypes.Config.IResourceTypeConfig | ResourceTypeConfig} objects.\n * @public\n */\nexport const resourceTypeConfig = Converters.strictObject<IResourceTypeConfig>({\n  name: Converters.string,\n  typeName: Converters.string,\n  template: JsonConverters.jsonObject.optional()\n});\n"]}

package/dist/packlets/resource-types/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,cAAc,QAAQ,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,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 * as Convert from './convert';\n\nexport * from './json';\n\nexport { Convert };\n"]}

package/dist/packlets/resource-types/config/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../src/packlets/resource-types/config/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';\n\n/**\n * Configuration for a {@link ResourceTypes.ResourceType | resource type}.\n * @public\n */\nexport interface IResourceTypeConfig<T extends JsonObject = JsonObject> {\n  name: string;\n  typeName: string;\n  template?: T;\n}\n"]}

package/dist/packlets/resource-types/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,IAAI,EAAU,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAA2B;IACtE,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,gBAAgB;aACrC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;aACpB,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,kFAAkF;IAClF,OAAO,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,0BAA0B,CAAC,CAAC;AAC5D,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 { fail, Result } from '@fgv/ts-utils';\nimport { IResourceTypeConfig } from './config';\nimport { ResourceType } from './resourceType';\nimport { JsonResourceType } from './jsonResourceType';\nimport { Convert as CommonConverters } from '../common';\n\n/**\n * Creates a {@link ResourceTypes.ResourceType | ResourceType} from a configuration object.\n * @param config - The {@link ResourceTypes.Config.IResourceTypeConfig | configuration object}\n * containing the name and type name of the resource type.\n * @returns `Success` with the new {@link ResourceTypes.ResourceType | ResourceType}\n * if successful, `Failure` with an error message otherwise.\n * @public\n */\nexport function createResourceTypeFromConfig(config: IResourceTypeConfig): Result<ResourceType> {\n  if (config.typeName === 'json') {\n    return CommonConverters.resourceTypeName\n      .convert(config.name)\n      .onSuccess((key) => JsonResourceType.create({ key }));\n  }\n  /* c8 ignore next 2 - functional code tested but coverage intermittently missed */\n  return fail(`${config.typeName}: Unknown resource type.`);\n}\n"]}

package/dist/packlets/resource-types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,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 * as Config from './config';\n\nexport * from './resourceType';\nexport * from './resourceTypeCollector';\nexport * from './jsonResourceType';\nexport * from './helpers';\n\nexport { Config };\n"]}

package/dist/packlets/resource-types/jsonResourceType.js

@@ -37,7 +37,7 @@ export class JsonResourceType extends ResourceType {
     constructor(key, index, template) {
         super(key, index, template);
         /**
-         * {@inheritdoc ResourceTypes.ResourceType.systemTypeName}
+         * {@inheritDoc ResourceTypes.ResourceType.systemTypeName}
          */
         this.systemTypeName = Convert.resourceTypeName.convert('json').orThrow();
     }
@@ -54,7 +54,7 @@ export class JsonResourceType extends ResourceType {
         });
     }
     /**
-     * {@inheritdoc ResourceTypes.ResourceType.validateDeclaration}
+     * {@inheritDoc ResourceTypes.ResourceType.validateDeclaration}
      */
     validateDeclaration(props) {
         return JsonConverters.jsonObject.convert(props.json);

package/dist/packlets/resource-types/jsonResourceType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonResourceType.js","sourceRoot":"","sources":["../../../src/packlets/resource-types/jsonResourceType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,IAAI,cAAc,EAAc,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAA0C,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAyB,OAAO,EAAoB,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAU,MAAM,eAAe,CAAC;AA0BtD;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAwB;IAM5D;;;;;OAKG;IACH,YAAsB,GAAqB,EAAE,KAAc,EAAE,QAAqB;QAChF,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAZ9B;;WAEG;QACa,mBAAc,GAAqB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAUtG,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAAsC;;QACzD,OAAO,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,mCAAI,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/E,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,GAAG,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,QAAQ,CAAC,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IAEI,mBAAmB,CAAC,KAA6C;QACtE,OAAO,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IA0BM,QAAQ,CAAC,IAAgB,EAAE,cAAsC;QACtE,OAAO,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;CACF","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 { Converters as JsonConverters, JsonObject } from '@fgv/ts-json-base';\nimport { IResourceCandidateValidationProperties, ResourceType } from './resourceType';\nimport { CandidateCompleteness, Convert, ResourceTypeName } from '../common';\nimport { captureResult, Result } from '@fgv/ts-utils';\n\n/**\n * Parameters to create a {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n * @public\n */\nexport interface IJsonResourceTypeCreateParams {\n  /**\n   * Optional key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * Defaults to 'json'.\n   */\n  key?: string;\n\n  /**\n   * Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType}\n   * instance.\n   */\n  index?: number;\n\n  /**\n   * Optional template for new instances of {@link ResourceTypes.JsonResourceType | JsonResourceType}\n   * resources.\n   */\n  template?: JsonObject;\n}\n\n/**\n * Implementation of a {@link ResourceTypes.ResourceType | ResourceType} for JSON values.\n * @public\n */\nexport class JsonResourceType extends ResourceType<JsonObject> {\n  /**\n   * {@inheritDoc ResourceTypes.ResourceType.systemTypeName}\n   */\n  public readonly systemTypeName: ResourceTypeName = Convert.resourceTypeName.convert('json').orThrow();\n\n  /**\n   * Protected {@link ResourceTypes.JsonResourceType | JsonResourceType} constructor for use by subclasses.\n   * Use {@link ResourceTypes.JsonResourceType.create | JsonResourceType.create} to create a new instance.\n   * @param key - The key for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param index - Optional index for the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   */\n  protected constructor(key: ResourceTypeName, index?: number, template?: JsonObject) {\n    super(key, index, template);\n  }\n\n  /**\n   * Factory method to create a new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance.\n   * @param params - {@link ResourceTypes.IJsonResourceTypeCreateParams | Parameters} to create the new instance.\n   * @returns `Success` with the new {@link ResourceTypes.JsonResourceType | JsonResourceType} instance if successful\n   * or `Failure` with an error message if not.\n   */\n  public static create(params?: IJsonResourceTypeCreateParams): Result<JsonResourceType> {\n    return Convert.resourceTypeName.convert(params?.key ?? 'json').onSuccess((key) => {\n      return captureResult(() => new JsonResourceType(key, params?.index, params?.template));\n    });\n  }\n\n  /**\n   * {@inheritDoc ResourceTypes.ResourceType.validateDeclaration}\n   */\n\n  public validateDeclaration(props: IResourceCandidateValidationProperties): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(props.json);\n  }\n\n  /**\n   * Validates a JSON value for use as a resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Describes {@link CandidateCompleteness | how complete} the candidate value is.\n   * @returns `Success` with the strongly-typed resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   */\n  public validate(json: JsonObject, completeness: CandidateCompleteness): Result<JsonObject>;\n  /**\n   * Validates a JSON value for use as a complete resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Must be `'full'` to indicate a complete value.\n   * @returns `Success` with the strongly-typed resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   */\n  public validate(json: JsonObject, completeness: 'full'): Result<JsonObject>;\n  /**\n   * Validates a JSON value for use as a partial resource instance value.\n   * @param json - The JSON value to validate.\n   * @param completeness - Must be `'partial'` to indicate a partial value.\n   * @returns `Success` with the strongly-typed partial resource value if the JSON is valid,\n   * `Failure` with an error message otherwise.\n   */\n  public validate(json: JsonObject, completeness: 'partial'): Result<JsonObject>;\n  public validate(json: JsonObject, __completeness?: CandidateCompleteness): Result<JsonObject> {\n    return JsonConverters.jsonObject.convert(json);\n  }\n}\n"]}

package/dist/packlets/resource-types/resourceType.js

@@ -30,13 +30,13 @@ import { Convert as CommonConvert, Validate } from '../common';
  */
 export class ResourceType {
     /**
-     * {@inheritdoc ResourceTypes.IResourceType.key}
+     * {@inheritDoc ResourceTypes.IResourceType.key}
      */
     get key() {
         return this._collectible.key;
     }
     /**
-     * {@inheritdoc ResourceTypes.IResourceType.index}
+     * {@inheritDoc ResourceTypes.IResourceType.index}
      */
     get index() {
         return this._collectible.index;