@narrative.io/jsonforms-provider-protocols 3.0.0-beta.18 → 3.0.0-beta.19

package/dist/core/initFormData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initFormData.d.ts","sourceRoot":"","sources":["../../src/core/initFormData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB"}
+{"version":3,"file":"initFormData.d.ts","sourceRoot":"","sources":["../../src/core/initFormData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB"}

package/dist/core/initFormData.js

@@ -1,4 +1,5 @@
 import { resolveRef } from "./refs.js";
+import { debugLog } from "../debug/overlay.js";
 function initFormDataFromSchema(schema, seed) {
   const result = initProperty(schema, schema, seed, true);
   const base = result && typeof result === "object" && !Array.isArray(result) ? result : {};
@@ -14,6 +15,7 @@ function initFormDataFromSchema(schema, seed) {
       }
     }
   }
+  debugLog("[initFormData] initFormDataFromSchema", { schema, seed, output: base });
   return base;
 }
 function initProperty(property, root, seed, required) {

package/dist/core/initFormData.js.map

@@ -1 +1 @@
-{"version":3,"file":"initFormData.js","sources":["../../src/core/initFormData.ts"],"sourcesContent":["/**\n * Initialize a form data object from a JSON Schema.\n * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.\n *\n * Optional fields (not listed in the parent schema's `required` array) that\n * have no `const`, no single-value `enum`, and no `default` are omitted\n * entirely from the result. This avoids seeding values (e.g. `null` for\n * `type: \"integer\"`) that fail AJV's type check and surface spurious errors\n * on untouched fields. Required fields retain legacy typed-empty seeding\n * (`\"\"`, `null`, `false`, `[]`) so that \"is required\" surfaces cleanly.\n *\n * @param schema - The full JSON Schema (must include $defs if $refs are used)\n * @param seed   - Optional existing data to merge (seed values take priority)\n * @returns A data object with schema-defined fields initialized\n */\nexport function initFormDataFromSchema(\n  schema: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = initProperty(schema, schema, seed, true) as\n    | Record<string, unknown>\n    | undefined;\n\n  const base =\n    result && typeof result === \"object\" && !Array.isArray(result)\n      ? result\n      : {};\n\n  // Preserve seed keys not described by the schema's properties.\n  if (seed && typeof seed === \"object\") {\n    const schemaKeys = new Set(\n      Object.keys(\n        (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??\n          {},\n      ),\n    );\n    for (const key of Object.keys(seed)) {\n      if (!schemaKeys.has(key) && !(key in base)) {\n        base[key] = seed[key];\n      }\n    }\n  }\n\n  return base;\n}\n\nimport { resolveRef } from \"./refs\";\n\n/**\n * Initialize a single property value based on its schema definition.\n * Returns `undefined` when the property is optional and has nothing\n * concrete to seed — the caller then omits the key from its result.\n */\nfunction initProperty(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: unknown,\n  required: boolean,\n): unknown {\n  if (!property || typeof property !== \"object\") {\n    return required ? null : undefined;\n  }\n\n  const resolved = resolveRef(property, root);\n  const type = resolved.type as string | undefined;\n  const isOneOf = Array.isArray(resolved.oneOf);\n\n  // Priority 1: seed wins for non-object, non-oneOf types. For oneOf we still\n  // descend so that a partial seed (e.g. `{value: 5}` missing the\n  // discriminator) picks up the variant's const/default for untouched fields.\n  if (seed !== undefined && seed !== null && type !== \"object\" && !isOneOf) {\n    return seed;\n  }\n\n  // Priority 2: const (schema-invariant — always set).\n  if (\"const\" in resolved) {\n    return resolved.const;\n  }\n\n  // Priority 3: single-value enum (same reasoning — only one valid value).\n  if (\n    Array.isArray(resolved.enum) &&\n    (resolved.enum as unknown[]).length === 1\n  ) {\n    return (resolved.enum as unknown[])[0];\n  }\n\n  // Priority 4: default (explicit author intent — always honored).\n  if (\"default\" in resolved) {\n    return resolved.default;\n  }\n\n  // Priority 5: oneOf. Recurse into the first variant, propagating the\n  // `required` flag so that the variant's own schema-declared required fields\n  // only get typed-empty seeding when the container is required. For optional\n  // containers, the variant's const / default / single-value enum still seed\n  // (author intent is unconditional) but typed-empty placeholders do not.\n  // If recursion yields nothing forced, we collapse back to undefined.\n  if (isOneOf) {\n    const value = initOneOf(resolved, root, seed, required);\n    if (\n      !required &&\n      (value === undefined ||\n        (value !== null &&\n          typeof value === \"object\" &&\n          !Array.isArray(value) &&\n          Object.keys(value as Record<string, unknown>).length === 0))\n    ) {\n      return undefined;\n    }\n    return value;\n  }\n\n  // Priority 6: objects recurse. The `required` flag propagates downward:\n  // inside an optional ancestor, nested required primitives also collapse,\n  // so an optional object with nested required fields stays absent instead\n  // of materializing a shell that AJV would flag.\n  if (type === \"object\") {\n    const obj = initObject(\n      resolved,\n      root,\n      seed as Record<string, unknown>,\n      required,\n    );\n    if (!required && Object.keys(obj).length === 0) return undefined;\n    return obj;\n  }\n\n  // Priority 7: optional primitives — omit.\n  if (!required) return undefined;\n\n  // Priority 8: required primitives — legacy typed empty.\n  switch (type) {\n    case \"array\":\n      return seed !== undefined && seed !== null ? seed : [];\n    case \"string\":\n      return \"\";\n    case \"boolean\":\n      return false;\n    case \"number\":\n    case \"integer\":\n    default:\n      return null;\n  }\n}\n\n/**\n * Initialize an object type by recursing into its properties.\n * Keys whose initialization returns `undefined` are omitted.\n *\n * `parentRequired` controls how schema.required propagates: a child is\n * treated as required only if both its parent is required AND it appears in\n * the parent's required array. Inside an optional ancestor the whole\n * subtree collapses (except for author-forced values: const, default,\n * single-value enum, or seeded values).\n */\nfunction initObject(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: Record<string, unknown> | undefined,\n  parentRequired: boolean,\n): Record<string, unknown> {\n  const properties = schema.properties as\n    | Record<string, Record<string, unknown>>\n    | undefined;\n  if (!properties) {\n    return seed && typeof seed === \"object\" ? { ...seed } : {};\n  }\n\n  const requiredSet = new Set<string>(\n    Array.isArray(schema.required) ? (schema.required as string[]) : [],\n  );\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const seedValue = seed && typeof seed === \"object\" ? seed[key] : undefined;\n    const effectiveRequired = parentRequired && requiredSet.has(key);\n    const value = initProperty(propSchema, root, seedValue, effectiveRequired);\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Handle oneOf schemas — pick the first variant and initialize it.\n * `required` propagates: if the outer oneOf is required, the variant is\n * materialized with typed-empty seeding for its required fields; if optional,\n * only author-forced values (const / default / single-enum / seed) survive.\n */\nfunction initOneOf(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: unknown,\n  required: boolean,\n): unknown {\n  const variants = schema.oneOf as Record<string, unknown>[];\n  if (!variants || variants.length === 0) return required ? null : undefined;\n\n  const first = variants[0];\n  if (!first) return required ? null : undefined;\n\n  const firstVariant = resolveRef(first, root);\n  return initProperty(firstVariant, root, seed, required);\n}\n"],"names":[],"mappings":";AAeO,SAAS,uBACd,QACA,MACyB;AACzB,QAAM,SAAS,aAAa,QAAQ,QAAQ,MAAM,IAAI;AAItD,QAAM,OACJ,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,MAAM,IACzD,SACA,CAAA;AAGN,MAAI,QAAQ,OAAO,SAAS,UAAU;AACpC,UAAM,aAAa,IAAI;AAAA,MACrB,OAAO;AAAA,QACJ,WAAW,QAAQ,MAAM,GAA+B,cACvD,CAAA;AAAA,MAAC;AAAA,IACL;AAEF,eAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,UAAI,CAAC,WAAW,IAAI,GAAG,KAAK,EAAE,OAAO,OAAO;AAC1C,aAAK,GAAG,IAAI,KAAK,GAAG;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AASA,SAAS,aACP,UACA,MACA,MACA,UACS;AACT,MAAI,CAAC,YAAY,OAAO,aAAa,UAAU;AAC7C,WAAO,WAAW,OAAO;AAAA,EAC3B;AAEA,QAAM,WAAW,WAAW,UAAU,IAAI;AAC1C,QAAM,OAAO,SAAS;AACtB,QAAM,UAAU,MAAM,QAAQ,SAAS,KAAK;AAK5C,MAAI,SAAS,UAAa,SAAS,QAAQ,SAAS,YAAY,CAAC,SAAS;AACxE,WAAO;AAAA,EACT;AAGA,MAAI,WAAW,UAAU;AACvB,WAAO,SAAS;AAAA,EAClB;AAGA,MACE,MAAM,QAAQ,SAAS,IAAI,KAC1B,SAAS,KAAmB,WAAW,GACxC;AACA,WAAQ,SAAS,KAAmB,CAAC;AAAA,EACvC;AAGA,MAAI,aAAa,UAAU;AACzB,WAAO,SAAS;AAAA,EAClB;AAQA,MAAI,SAAS;AACX,UAAM,QAAQ,UAAU,UAAU,MAAM,MAAM,QAAQ;AACtD,QACE,CAAC,aACA,UAAU,UACR,UAAU,QACT,OAAO,UAAU,YACjB,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAO,KAAK,KAAgC,EAAE,WAAW,IAC7D;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAMA,MAAI,SAAS,UAAU;AACrB,UAAM,MAAM;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAEF,QAAI,CAAC,YAAY,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AACvD,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,SAAU,QAAO;AAGtB,UAAQ,MAAA;AAAA,IACN,KAAK;AACH,aAAO,SAAS,UAAa,SAAS,OAAO,OAAO,CAAA;AAAA,IACtD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL;AACE,aAAO;AAAA,EAAA;AAEb;AAYA,SAAS,WACP,QACA,MACA,MACA,gBACyB;AACzB,QAAM,aAAa,OAAO;AAG1B,MAAI,CAAC,YAAY;AACf,WAAO,QAAQ,OAAO,SAAS,WAAW,EAAE,GAAG,KAAA,IAAS,CAAA;AAAA,EAC1D;AAEA,QAAM,cAAc,IAAI;AAAA,IACtB,MAAM,QAAQ,OAAO,QAAQ,IAAK,OAAO,WAAwB,CAAA;AAAA,EAAC;AAGpE,QAAM,SAAkC,CAAA;AAExC,aAAW,CAAC,KAAK,UAAU,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC1D,UAAM,YAAY,QAAQ,OAAO,SAAS,WAAW,KAAK,GAAG,IAAI;AACjE,UAAM,oBAAoB,kBAAkB,YAAY,IAAI,GAAG;AAC/D,UAAM,QAAQ,aAAa,YAAY,MAAM,WAAW,iBAAiB;AACzE,QAAI,UAAU,QAAW;AACvB,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AAEA,SAAO;AACT;AAQA,SAAS,UACP,QACA,MACA,MACA,UACS;AACT,QAAM,WAAW,OAAO;AACxB,MAAI,CAAC,YAAY,SAAS,WAAW,EAAG,QAAO,WAAW,OAAO;AAEjE,QAAM,QAAQ,SAAS,CAAC;AACxB,MAAI,CAAC,MAAO,QAAO,WAAW,OAAO;AAErC,QAAM,eAAe,WAAW,OAAO,IAAI;AAC3C,SAAO,aAAa,cAAc,MAAM,MAAM,QAAQ;AACxD;"}
+{"version":3,"file":"initFormData.js","sources":["../../src/core/initFormData.ts"],"sourcesContent":["/**\n * Initialize a form data object from a JSON Schema.\n * Resolves $ref, const, default, oneOf/discriminator, and typed empty values.\n *\n * Optional fields (not listed in the parent schema's `required` array) that\n * have no `const`, no single-value `enum`, and no `default` are omitted\n * entirely from the result. This avoids seeding values (e.g. `null` for\n * `type: \"integer\"`) that fail AJV's type check and surface spurious errors\n * on untouched fields. Required fields retain legacy typed-empty seeding\n * (`\"\"`, `null`, `false`, `[]`) so that \"is required\" surfaces cleanly.\n *\n * @param schema - The full JSON Schema (must include $defs if $refs are used)\n * @param seed   - Optional existing data to merge (seed values take priority)\n * @returns A data object with schema-defined fields initialized\n */\nexport function initFormDataFromSchema(\n  schema: Record<string, unknown>,\n  seed?: Record<string, unknown>,\n): Record<string, unknown> {\n  const result = initProperty(schema, schema, seed, true) as\n    | Record<string, unknown>\n    | undefined;\n\n  const base =\n    result && typeof result === \"object\" && !Array.isArray(result)\n      ? result\n      : {};\n\n  // Preserve seed keys not described by the schema's properties.\n  if (seed && typeof seed === \"object\") {\n    const schemaKeys = new Set(\n      Object.keys(\n        (resolveRef(schema, schema) as Record<string, unknown>)?.properties ??\n          {},\n      ),\n    );\n    for (const key of Object.keys(seed)) {\n      if (!schemaKeys.has(key) && !(key in base)) {\n        base[key] = seed[key];\n      }\n    }\n  }\n\n  debugLog(\"[initFormData] initFormDataFromSchema\", { schema, seed, output: base });\n  return base;\n}\n\nimport { resolveRef } from \"./refs\";\nimport { debugLog } from \"../debug/overlay\";\n\n/**\n * Initialize a single property value based on its schema definition.\n * Returns `undefined` when the property is optional and has nothing\n * concrete to seed — the caller then omits the key from its result.\n */\nfunction initProperty(\n  property: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: unknown,\n  required: boolean,\n): unknown {\n  if (!property || typeof property !== \"object\") {\n    return required ? null : undefined;\n  }\n\n  const resolved = resolveRef(property, root);\n  const type = resolved.type as string | undefined;\n  const isOneOf = Array.isArray(resolved.oneOf);\n\n  // Priority 1: seed wins for non-object, non-oneOf types. For oneOf we still\n  // descend so that a partial seed (e.g. `{value: 5}` missing the\n  // discriminator) picks up the variant's const/default for untouched fields.\n  if (seed !== undefined && seed !== null && type !== \"object\" && !isOneOf) {\n    return seed;\n  }\n\n  // Priority 2: const (schema-invariant — always set).\n  if (\"const\" in resolved) {\n    return resolved.const;\n  }\n\n  // Priority 3: single-value enum (same reasoning — only one valid value).\n  if (\n    Array.isArray(resolved.enum) &&\n    (resolved.enum as unknown[]).length === 1\n  ) {\n    return (resolved.enum as unknown[])[0];\n  }\n\n  // Priority 4: default (explicit author intent — always honored).\n  if (\"default\" in resolved) {\n    return resolved.default;\n  }\n\n  // Priority 5: oneOf. Recurse into the first variant, propagating the\n  // `required` flag so that the variant's own schema-declared required fields\n  // only get typed-empty seeding when the container is required. For optional\n  // containers, the variant's const / default / single-value enum still seed\n  // (author intent is unconditional) but typed-empty placeholders do not.\n  // If recursion yields nothing forced, we collapse back to undefined.\n  if (isOneOf) {\n    const value = initOneOf(resolved, root, seed, required);\n    if (\n      !required &&\n      (value === undefined ||\n        (value !== null &&\n          typeof value === \"object\" &&\n          !Array.isArray(value) &&\n          Object.keys(value as Record<string, unknown>).length === 0))\n    ) {\n      return undefined;\n    }\n    return value;\n  }\n\n  // Priority 6: objects recurse. The `required` flag propagates downward:\n  // inside an optional ancestor, nested required primitives also collapse,\n  // so an optional object with nested required fields stays absent instead\n  // of materializing a shell that AJV would flag.\n  if (type === \"object\") {\n    const obj = initObject(\n      resolved,\n      root,\n      seed as Record<string, unknown>,\n      required,\n    );\n    if (!required && Object.keys(obj).length === 0) return undefined;\n    return obj;\n  }\n\n  // Priority 7: optional primitives — omit.\n  if (!required) return undefined;\n\n  // Priority 8: required primitives — legacy typed empty.\n  switch (type) {\n    case \"array\":\n      return seed !== undefined && seed !== null ? seed : [];\n    case \"string\":\n      return \"\";\n    case \"boolean\":\n      return false;\n    case \"number\":\n    case \"integer\":\n    default:\n      return null;\n  }\n}\n\n/**\n * Initialize an object type by recursing into its properties.\n * Keys whose initialization returns `undefined` are omitted.\n *\n * `parentRequired` controls how schema.required propagates: a child is\n * treated as required only if both its parent is required AND it appears in\n * the parent's required array. Inside an optional ancestor the whole\n * subtree collapses (except for author-forced values: const, default,\n * single-value enum, or seeded values).\n */\nfunction initObject(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: Record<string, unknown> | undefined,\n  parentRequired: boolean,\n): Record<string, unknown> {\n  const properties = schema.properties as\n    | Record<string, Record<string, unknown>>\n    | undefined;\n  if (!properties) {\n    return seed && typeof seed === \"object\" ? { ...seed } : {};\n  }\n\n  const requiredSet = new Set<string>(\n    Array.isArray(schema.required) ? (schema.required as string[]) : [],\n  );\n\n  const result: Record<string, unknown> = {};\n\n  for (const [key, propSchema] of Object.entries(properties)) {\n    const seedValue = seed && typeof seed === \"object\" ? seed[key] : undefined;\n    const effectiveRequired = parentRequired && requiredSet.has(key);\n    const value = initProperty(propSchema, root, seedValue, effectiveRequired);\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Handle oneOf schemas — pick the first variant and initialize it.\n * `required` propagates: if the outer oneOf is required, the variant is\n * materialized with typed-empty seeding for its required fields; if optional,\n * only author-forced values (const / default / single-enum / seed) survive.\n */\nfunction initOneOf(\n  schema: Record<string, unknown>,\n  root: Record<string, unknown>,\n  seed: unknown,\n  required: boolean,\n): unknown {\n  const variants = schema.oneOf as Record<string, unknown>[];\n  if (!variants || variants.length === 0) return required ? null : undefined;\n\n  const first = variants[0];\n  if (!first) return required ? null : undefined;\n\n  const firstVariant = resolveRef(first, root);\n  return initProperty(firstVariant, root, seed, required);\n}\n"],"names":[],"mappings":"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"}

package/dist/core/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/core/projection.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAMrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAGT;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAEhC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,GAEX,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAmCrB"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/core/projection.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAMrE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAGT;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAEhC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,GAEX,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA2CrB"}

package/dist/core/projection.js

@@ -1,4 +1,5 @@
 import { deref, tryCombinatorBranches } from "./refs.js";
+import { debugLog } from "../debug/overlay.js";
 function parseProjectionPath(path) {
   if (!path) return [];
   return path.split(".").map((s) => {
@@ -48,7 +49,10 @@ function getProjectedSchema(schema, path) {
   let current = schema;
   for (const seg of segments) {
     current = deref(current, schema);
-    if (!current) return {};
+    if (!current) {
+      debugLog("[projection] empty (deref miss)", { path, segment: seg, rootSchema: schema });
+      return {};
+    }
     const navigate = (node) => {
       if (typeof seg === "number") {
         const items = node.items;
@@ -62,11 +66,16 @@ function getProjectedSchema(schema, path) {
     if (next === void 0) {
       next = tryCombinatorBranches(current, schema, navigate);
     }
-    if (!next) return {};
+    if (!next) {
+      debugLog("[projection] empty (segment unresolved)", { path, segment: seg, current, rootSchema: schema });
+      return {};
+    }
     current = next;
   }
   const resolved = deref(current, schema);
-  return resolved ?? {};
+  const out = resolved ?? {};
+  debugLog("[projection] getProjectedSchema", { path, output: out, rootSchema: schema });
+  return out;
 }
 export {
   getProjectedSchema,

package/dist/core/projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection.js","sources":["../../src/core/projection.ts"],"sourcesContent":["import {\n  deref as derefSchema,\n  tryCombinatorBranches,\n} from \"./refs\";\n\n/**\n * Projection utilities for navigating complex data structures\n * through a dot-separated path where numeric segments are array indices.\n *\n * Examples:\n *   \"0\"                → first element of an array\n *   \"include\"          → the `include` property of an object\n *   \"0.video_rate_usd\" → nested property inside the first array element\n */\n\nexport type ProjectionSegment = string | number;\n\n/**\n * Parse a projection path string into typed segments.\n * Numeric strings become numbers (array indices), others stay as strings (object keys).\n */\nexport function parseProjectionPath(path: string): ProjectionSegment[] {\n  if (!path) return [];\n  return path.split(\".\").map((s) => {\n    const n = Number(s);\n    return Number.isInteger(n) && n >= 0 ? n : s;\n  });\n}\n\n/**\n * Read a value from `data` by following the projection path.\n * Returns `undefined` if any segment along the path is missing.\n */\nexport function getProjectedValue(data: unknown, path: string): unknown {\n  const segments = parseProjectionPath(path);\n  let current: unknown = data;\n\n  for (const seg of segments) {\n    if (current === null || current === undefined) return undefined;\n\n    if (typeof seg === \"number\") {\n      if (!Array.isArray(current)) return undefined;\n      current = current[seg];\n    } else {\n      if (typeof current !== \"object\") return undefined;\n      current = (current as Record<string, unknown>)[seg];\n    }\n  }\n\n  return current;\n}\n\n/**\n * Immutably set a value at the projection path, preserving all sibling data.\n * Constructs missing intermediate structures (arrays for numeric segments, objects for string segments).\n */\nexport function setProjectedValue(\n  data: unknown,\n  path: string,\n  value: unknown,\n): unknown {\n  const segments = parseProjectionPath(path);\n  return setAtPath(data, segments, 0, value);\n}\n\nfunction setAtPath(\n  current: unknown,\n  segments: ProjectionSegment[],\n  index: number,\n  value: unknown,\n): unknown {\n  if (index === segments.length) {\n    return value;\n  }\n\n  const seg = segments[index]!;\n\n  if (typeof seg === \"number\") {\n    // Array index — ensure we have an array\n    const arr = Array.isArray(current) ? [...current] : [];\n    // Pad array if index is out of bounds\n    while (arr.length <= seg) {\n      arr.push(undefined);\n    }\n    arr[seg] = setAtPath(arr[seg], segments, index + 1, value);\n    return arr;\n  } else {\n    // Object key — ensure we have an object\n    const obj: Record<string, unknown> =\n      current !== null &&\n      current !== undefined &&\n      typeof current === \"object\" &&\n      !Array.isArray(current)\n        ? { ...(current as Record<string, unknown>) }\n        : {};\n    obj[seg] = setAtPath(obj[seg], segments, index + 1, value);\n    return obj;\n  }\n}\n\n/**\n * Resolve the schema at the projected path.\n * Numeric segments traverse into `items` (array item schema).\n * String segments traverse into `properties[segment]`.\n *\n * Dereferences `$ref` nodes transparently at every step, and falls through\n * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve\n * directly — picks the first branch that satisfies the navigation.\n */\nexport function getProjectedSchema(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: Record<string, any>,\n  path: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> {\n  const segments = parseProjectionPath(path);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: Record<string, any> | undefined = schema;\n\n  for (const seg of segments) {\n    current = derefSchema(current, schema);\n    if (!current) return {};\n\n    const navigate = (\n      node: Record<string, unknown>,\n    ): Record<string, unknown> | undefined => {\n      if (typeof seg === \"number\") {\n        const items = (node as { items?: unknown }).items;\n        return items && typeof items === \"object\"\n          ? (items as Record<string, unknown>)\n          : undefined;\n      }\n      const properties = (node as { properties?: unknown }).properties as\n        | Record<string, Record<string, unknown>>\n        | undefined;\n      if (properties && properties[seg]) return properties[seg];\n      return undefined;\n    };\n\n    let next = navigate(current);\n    if (next === undefined) {\n      next = tryCombinatorBranches(current, schema, navigate);\n    }\n    if (!next) return {};\n    current = next;\n  }\n\n  const resolved = derefSchema(current, schema);\n  return resolved ?? {};\n}\n"],"names":["derefSchema"],"mappings":";AAqBO,SAAS,oBAAoB,MAAmC;AACrE,MAAI,CAAC,KAAM,QAAO,CAAA;AAClB,SAAO,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM;AAChC,UAAM,IAAI,OAAO,CAAC;AAClB,WAAO,OAAO,UAAU,CAAC,KAAK,KAAK,IAAI,IAAI;AAAA,EAC7C,CAAC;AACH;AAMO,SAAS,kBAAkB,MAAe,MAAuB;AACtE,QAAM,WAAW,oBAAoB,IAAI;AACzC,MAAI,UAAmB;AAEvB,aAAW,OAAO,UAAU;AAC1B,QAAI,YAAY,QAAQ,YAAY,OAAW,QAAO;AAEtD,QAAI,OAAO,QAAQ,UAAU;AAC3B,UAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO;AACpC,gBAAU,QAAQ,GAAG;AAAA,IACvB,OAAO;AACL,UAAI,OAAO,YAAY,SAAU,QAAO;AACxC,gBAAW,QAAoC,GAAG;AAAA,IACpD;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,kBACd,MACA,MACA,OACS;AACT,QAAM,WAAW,oBAAoB,IAAI;AACzC,SAAO,UAAU,MAAM,UAAU,GAAG,KAAK;AAC3C;AAEA,SAAS,UACP,SACA,UACA,OACA,OACS;AACT,MAAI,UAAU,SAAS,QAAQ;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,MAAM,SAAS,KAAK;AAE1B,MAAI,OAAO,QAAQ,UAAU;AAE3B,UAAM,MAAM,MAAM,QAAQ,OAAO,IAAI,CAAC,GAAG,OAAO,IAAI,CAAA;AAEpD,WAAO,IAAI,UAAU,KAAK;AACxB,UAAI,KAAK,MAAS;AAAA,IACpB;AACA,QAAI,GAAG,IAAI,UAAU,IAAI,GAAG,GAAG,UAAU,QAAQ,GAAG,KAAK;AACzD,WAAO;AAAA,EACT,OAAO;AAEL,UAAM,MACJ,YAAY,QACZ,YAAY,UACZ,OAAO,YAAY,YACnB,CAAC,MAAM,QAAQ,OAAO,IAClB,EAAE,GAAI,QAAA,IACN,CAAA;AACN,QAAI,GAAG,IAAI,UAAU,IAAI,GAAG,GAAG,UAAU,QAAQ,GAAG,KAAK;AACzD,WAAO;AAAA,EACT;AACF;AAWO,SAAS,mBAEd,QACA,MAEqB;AACrB,QAAM,WAAW,oBAAoB,IAAI;AAEzC,MAAI,UAA2C;AAE/C,aAAW,OAAO,UAAU;AAC1B,cAAUA,MAAY,SAAS,MAAM;AACrC,QAAI,CAAC,QAAS,QAAO,CAAA;AAErB,UAAM,WAAW,CACf,SACwC;AACxC,UAAI,OAAO,QAAQ,UAAU;AAC3B,cAAM,QAAS,KAA6B;AAC5C,eAAO,SAAS,OAAO,UAAU,WAC5B,QACD;AAAA,MACN;AACA,YAAM,aAAc,KAAkC;AAGtD,UAAI,cAAc,WAAW,GAAG,EAAG,QAAO,WAAW,GAAG;AACxD,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,SAAS,OAAO;AAC3B,QAAI,SAAS,QAAW;AACtB,aAAO,sBAAsB,SAAS,QAAQ,QAAQ;AAAA,IACxD;AACA,QAAI,CAAC,KAAM,QAAO,CAAA;AAClB,cAAU;AAAA,EACZ;AAEA,QAAM,WAAWA,MAAY,SAAS,MAAM;AAC5C,SAAO,YAAY,CAAA;AACrB;"}
+{"version":3,"file":"projection.js","sources":["../../src/core/projection.ts"],"sourcesContent":["import {\n  deref as derefSchema,\n  tryCombinatorBranches,\n} from \"./refs\";\nimport { debugLog } from \"../debug/overlay\";\n\n/**\n * Projection utilities for navigating complex data structures\n * through a dot-separated path where numeric segments are array indices.\n *\n * Examples:\n *   \"0\"                → first element of an array\n *   \"include\"          → the `include` property of an object\n *   \"0.video_rate_usd\" → nested property inside the first array element\n */\n\nexport type ProjectionSegment = string | number;\n\n/**\n * Parse a projection path string into typed segments.\n * Numeric strings become numbers (array indices), others stay as strings (object keys).\n */\nexport function parseProjectionPath(path: string): ProjectionSegment[] {\n  if (!path) return [];\n  return path.split(\".\").map((s) => {\n    const n = Number(s);\n    return Number.isInteger(n) && n >= 0 ? n : s;\n  });\n}\n\n/**\n * Read a value from `data` by following the projection path.\n * Returns `undefined` if any segment along the path is missing.\n */\nexport function getProjectedValue(data: unknown, path: string): unknown {\n  const segments = parseProjectionPath(path);\n  let current: unknown = data;\n\n  for (const seg of segments) {\n    if (current === null || current === undefined) return undefined;\n\n    if (typeof seg === \"number\") {\n      if (!Array.isArray(current)) return undefined;\n      current = current[seg];\n    } else {\n      if (typeof current !== \"object\") return undefined;\n      current = (current as Record<string, unknown>)[seg];\n    }\n  }\n\n  return current;\n}\n\n/**\n * Immutably set a value at the projection path, preserving all sibling data.\n * Constructs missing intermediate structures (arrays for numeric segments, objects for string segments).\n */\nexport function setProjectedValue(\n  data: unknown,\n  path: string,\n  value: unknown,\n): unknown {\n  const segments = parseProjectionPath(path);\n  return setAtPath(data, segments, 0, value);\n}\n\nfunction setAtPath(\n  current: unknown,\n  segments: ProjectionSegment[],\n  index: number,\n  value: unknown,\n): unknown {\n  if (index === segments.length) {\n    return value;\n  }\n\n  const seg = segments[index]!;\n\n  if (typeof seg === \"number\") {\n    // Array index — ensure we have an array\n    const arr = Array.isArray(current) ? [...current] : [];\n    // Pad array if index is out of bounds\n    while (arr.length <= seg) {\n      arr.push(undefined);\n    }\n    arr[seg] = setAtPath(arr[seg], segments, index + 1, value);\n    return arr;\n  } else {\n    // Object key — ensure we have an object\n    const obj: Record<string, unknown> =\n      current !== null &&\n      current !== undefined &&\n      typeof current === \"object\" &&\n      !Array.isArray(current)\n        ? { ...(current as Record<string, unknown>) }\n        : {};\n    obj[seg] = setAtPath(obj[seg], segments, index + 1, value);\n    return obj;\n  }\n}\n\n/**\n * Resolve the schema at the projected path.\n * Numeric segments traverse into `items` (array item schema).\n * String segments traverse into `properties[segment]`.\n *\n * Dereferences `$ref` nodes transparently at every step, and falls through\n * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve\n * directly — picks the first branch that satisfies the navigation.\n */\nexport function getProjectedSchema(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schema: Record<string, any>,\n  path: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> {\n  const segments = parseProjectionPath(path);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: Record<string, any> | undefined = schema;\n\n  for (const seg of segments) {\n    current = derefSchema(current, schema);\n    if (!current) {\n      debugLog(\"[projection] empty (deref miss)\", { path, segment: seg, rootSchema: schema });\n      return {};\n    }\n\n    const navigate = (\n      node: Record<string, unknown>,\n    ): Record<string, unknown> | undefined => {\n      if (typeof seg === \"number\") {\n        const items = (node as { items?: unknown }).items;\n        return items && typeof items === \"object\"\n          ? (items as Record<string, unknown>)\n          : undefined;\n      }\n      const properties = (node as { properties?: unknown }).properties as\n        | Record<string, Record<string, unknown>>\n        | undefined;\n      if (properties && properties[seg]) return properties[seg];\n      return undefined;\n    };\n\n    let next = navigate(current);\n    if (next === undefined) {\n      next = tryCombinatorBranches(current, schema, navigate);\n    }\n    if (!next) {\n      debugLog(\"[projection] empty (segment unresolved)\", { path, segment: seg, current, rootSchema: schema });\n      return {};\n    }\n    current = next;\n  }\n\n  const resolved = derefSchema(current, schema);\n  const out = resolved ?? {};\n  debugLog(\"[projection] getProjectedSchema\", { path, output: out, rootSchema: schema });\n  return out;\n}\n"],"names":["derefSchema"],"mappings":";;AAsBO,SAAS,oBAAoB,MAAmC;AACrE,MAAI,CAAC,KAAM,QAAO,CAAA;AAClB,SAAO,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM;AAChC,UAAM,IAAI,OAAO,CAAC;AAClB,WAAO,OAAO,UAAU,CAAC,KAAK,KAAK,IAAI,IAAI;AAAA,EAC7C,CAAC;AACH;AAMO,SAAS,kBAAkB,MAAe,MAAuB;AACtE,QAAM,WAAW,oBAAoB,IAAI;AACzC,MAAI,UAAmB;AAEvB,aAAW,OAAO,UAAU;AAC1B,QAAI,YAAY,QAAQ,YAAY,OAAW,QAAO;AAEtD,QAAI,OAAO,QAAQ,UAAU;AAC3B,UAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO;AACpC,gBAAU,QAAQ,GAAG;AAAA,IACvB,OAAO;AACL,UAAI,OAAO,YAAY,SAAU,QAAO;AACxC,gBAAW,QAAoC,GAAG;AAAA,IACpD;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,kBACd,MACA,MACA,OACS;AACT,QAAM,WAAW,oBAAoB,IAAI;AACzC,SAAO,UAAU,MAAM,UAAU,GAAG,KAAK;AAC3C;AAEA,SAAS,UACP,SACA,UACA,OACA,OACS;AACT,MAAI,UAAU,SAAS,QAAQ;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,MAAM,SAAS,KAAK;AAE1B,MAAI,OAAO,QAAQ,UAAU;AAE3B,UAAM,MAAM,MAAM,QAAQ,OAAO,IAAI,CAAC,GAAG,OAAO,IAAI,CAAA;AAEpD,WAAO,IAAI,UAAU,KAAK;AACxB,UAAI,KAAK,MAAS;AAAA,IACpB;AACA,QAAI,GAAG,IAAI,UAAU,IAAI,GAAG,GAAG,UAAU,QAAQ,GAAG,KAAK;AACzD,WAAO;AAAA,EACT,OAAO;AAEL,UAAM,MACJ,YAAY,QACZ,YAAY,UACZ,OAAO,YAAY,YACnB,CAAC,MAAM,QAAQ,OAAO,IAClB,EAAE,GAAI,QAAA,IACN,CAAA;AACN,QAAI,GAAG,IAAI,UAAU,IAAI,GAAG,GAAG,UAAU,QAAQ,GAAG,KAAK;AACzD,WAAO;AAAA,EACT;AACF;AAWO,SAAS,mBAEd,QACA,MAEqB;AACrB,QAAM,WAAW,oBAAoB,IAAI;AAEzC,MAAI,UAA2C;AAE/C,aAAW,OAAO,UAAU;AAC1B,cAAUA,MAAY,SAAS,MAAM;AACrC,QAAI,CAAC,SAAS;AACZ,eAAS,mCAAmC,EAAE,MAAM,SAAS,KAAK,YAAY,QAAQ;AACtF,aAAO,CAAA;AAAA,IACT;AAEA,UAAM,WAAW,CACf,SACwC;AACxC,UAAI,OAAO,QAAQ,UAAU;AAC3B,cAAM,QAAS,KAA6B;AAC5C,eAAO,SAAS,OAAO,UAAU,WAC5B,QACD;AAAA,MACN;AACA,YAAM,aAAc,KAAkC;AAGtD,UAAI,cAAc,WAAW,GAAG,EAAG,QAAO,WAAW,GAAG;AACxD,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,SAAS,OAAO;AAC3B,QAAI,SAAS,QAAW;AACtB,aAAO,sBAAsB,SAAS,QAAQ,QAAQ;AAAA,IACxD;AACA,QAAI,CAAC,MAAM;AACT,eAAS,2CAA2C,EAAE,MAAM,SAAS,KAAK,SAAS,YAAY,QAAQ;AACvG,aAAO,CAAA;AAAA,IACT;AACA,cAAU;AAAA,EACZ;AAEA,QAAM,WAAWA,MAAY,SAAS,MAAM;AAC5C,QAAM,MAAM,YAAY,CAAA;AACxB,WAAS,mCAAmC,EAAE,MAAM,QAAQ,KAAK,YAAY,QAAQ;AACrF,SAAO;AACT;"}

package/dist/core/resolveScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveScope.d.ts","sourceRoot":"","sources":["../../src/core/resolveScope.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAEb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAE9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CA+BjC"}
+{"version":3,"file":"resolveScope.d.ts","sourceRoot":"","sources":["../../src/core/resolveScope.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EAEb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAE9B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CA8CjC"}

package/dist/core/resolveScope.js

@@ -1,13 +1,24 @@
 import { deepDeref, deref, tryCombinatorBranches } from "./refs.js";
+import { debugLog } from "../debug/overlay.js";
 function resolveScopeSchema(scope, rootSchema) {
-  if (!scope || !rootSchema) return void 0;
+  if (!scope || !rootSchema) {
+    debugLog("[resolveScope] undefined (empty input)", { scope, rootSchema });
+    return void 0;
+  }
   const path = scope.replace(/^#\/?/, "");
-  if (!path) return deepDeref(rootSchema, rootSchema);
+  if (!path) {
+    const out2 = deepDeref(rootSchema, rootSchema);
+    debugLog("[resolveScope] root deepDeref", { scope, output: out2, rootSchema });
+    return out2;
+  }
   const segments = path.split("/");
   let current = rootSchema;
   for (const segment of segments) {
     current = deref(current, rootSchema);
-    if (!current || typeof current !== "object") return void 0;
+    if (!current || typeof current !== "object") {
+      debugLog("[resolveScope] undefined (deref miss)", { scope, segment, rootSchema });
+      return void 0;
+    }
     const navigate = (node) => {
       if (segment === "properties") return node.properties;
       if (segment === "items") return node.items;
@@ -17,10 +28,15 @@ function resolveScopeSchema(scope, rootSchema) {
     if (next === void 0) {
       next = tryCombinatorBranches(current, rootSchema, navigate);
     }
-    if (next === void 0) return void 0;
+    if (next === void 0) {
+      debugLog("[resolveScope] undefined (segment unresolved)", { scope, segment, current, rootSchema });
+      return void 0;
+    }
     current = next;
   }
-  return deepDeref(current, rootSchema);
+  const out = deepDeref(current, rootSchema);
+  debugLog("[resolveScope] resolveScopeSchema", { scope, output: out, rootSchema });
+  return out;
 }
 export {
   resolveScopeSchema

package/dist/core/resolveScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveScope.js","sources":["../../src/core/resolveScope.ts"],"sourcesContent":["import { deepDeref, deref, tryCombinatorBranches } from \"./refs\";\n\n/**\n * Resolve a JSON Forms scope path to its schema within a root schema.\n * Handles nested paths like \"#/properties/parent/properties/child\".\n *\n * Follows JSON Schema structure:\n *   - \"properties\" segments navigate into object `.properties`\n *   - \"items\" segments navigate into array `.items`\n *   - all other segments index directly into the current object\n *\n * Dereferences `$ref` nodes transparently at every step, and falls through\n * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve\n * directly — picks the first branch that satisfies the navigation. The\n * returned schema is deep-dereferenced so downstream walkers can operate on\n * a self-contained sub-schema without needing the original root.\n */\nexport function resolveScopeSchema(\n  scope: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  rootSchema: Record<string, any>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> | undefined {\n  if (!scope || !rootSchema) return undefined;\n\n  // Remove the leading \"#/\" and split into segments\n  const path = scope.replace(/^#\\/?/, \"\");\n  if (!path) return deepDeref(rootSchema, rootSchema);\n\n  const segments = path.split(\"/\");\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: any = rootSchema;\n\n  for (const segment of segments) {\n    current = deref(current, rootSchema);\n    if (!current || typeof current !== \"object\") return undefined;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const navigate = (node: Record<string, any>): unknown => {\n      if (segment === \"properties\") return node.properties;\n      if (segment === \"items\") return node.items;\n      return node[segment];\n    };\n\n    let next = navigate(current);\n    if (next === undefined) {\n      next = tryCombinatorBranches(current, rootSchema, navigate);\n    }\n    if (next === undefined) return undefined;\n    current = next;\n  }\n\n  return deepDeref(current, rootSchema);\n}\n"],"names":[],"mappings":";AAiBO,SAAS,mBACd,OAEA,YAEiC;AACjC,MAAI,CAAC,SAAS,CAAC,WAAY,QAAO;AAGlC,QAAM,OAAO,MAAM,QAAQ,SAAS,EAAE;AACtC,MAAI,CAAC,KAAM,QAAO,UAAU,YAAY,UAAU;AAElD,QAAM,WAAW,KAAK,MAAM,GAAG;AAE/B,MAAI,UAAe;AAEnB,aAAW,WAAW,UAAU;AAC9B,cAAU,MAAM,SAAS,UAAU;AACnC,QAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AAGpD,UAAM,WAAW,CAAC,SAAuC;AACvD,UAAI,YAAY,aAAc,QAAO,KAAK;AAC1C,UAAI,YAAY,QAAS,QAAO,KAAK;AACrC,aAAO,KAAK,OAAO;AAAA,IACrB;AAEA,QAAI,OAAO,SAAS,OAAO;AAC3B,QAAI,SAAS,QAAW;AACtB,aAAO,sBAAsB,SAAS,YAAY,QAAQ;AAAA,IAC5D;AACA,QAAI,SAAS,OAAW,QAAO;AAC/B,cAAU;AAAA,EACZ;AAEA,SAAO,UAAU,SAAS,UAAU;AACtC;"}
+{"version":3,"file":"resolveScope.js","sources":["../../src/core/resolveScope.ts"],"sourcesContent":["import { deepDeref, deref, tryCombinatorBranches } from \"./refs\";\nimport { debugLog } from \"../debug/overlay\";\n\n/**\n * Resolve a JSON Forms scope path to its schema within a root schema.\n * Handles nested paths like \"#/properties/parent/properties/child\".\n *\n * Follows JSON Schema structure:\n *   - \"properties\" segments navigate into object `.properties`\n *   - \"items\" segments navigate into array `.items`\n *   - all other segments index directly into the current object\n *\n * Dereferences `$ref` nodes transparently at every step, and falls through\n * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve\n * directly — picks the first branch that satisfies the navigation. The\n * returned schema is deep-dereferenced so downstream walkers can operate on\n * a self-contained sub-schema without needing the original root.\n */\nexport function resolveScopeSchema(\n  scope: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  rootSchema: Record<string, any>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Record<string, any> | undefined {\n  if (!scope || !rootSchema) {\n    debugLog(\"[resolveScope] undefined (empty input)\", { scope, rootSchema });\n    return undefined;\n  }\n\n  // Remove the leading \"#/\" and split into segments\n  const path = scope.replace(/^#\\/?/, \"\");\n  if (!path) {\n    const out = deepDeref(rootSchema, rootSchema);\n    debugLog(\"[resolveScope] root deepDeref\", { scope, output: out, rootSchema });\n    return out;\n  }\n\n  const segments = path.split(\"/\");\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: any = rootSchema;\n\n  for (const segment of segments) {\n    current = deref(current, rootSchema);\n    if (!current || typeof current !== \"object\") {\n      debugLog(\"[resolveScope] undefined (deref miss)\", { scope, segment, rootSchema });\n      return undefined;\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const navigate = (node: Record<string, any>): unknown => {\n      if (segment === \"properties\") return node.properties;\n      if (segment === \"items\") return node.items;\n      return node[segment];\n    };\n\n    let next = navigate(current);\n    if (next === undefined) {\n      next = tryCombinatorBranches(current, rootSchema, navigate);\n    }\n    if (next === undefined) {\n      debugLog(\"[resolveScope] undefined (segment unresolved)\", { scope, segment, current, rootSchema });\n      return undefined;\n    }\n    current = next;\n  }\n\n  const out = deepDeref(current, rootSchema);\n  debugLog(\"[resolveScope] resolveScopeSchema\", { scope, output: out, rootSchema });\n  return out;\n}\n"],"names":["out"],"mappings":";;AAkBO,SAAS,mBACd,OAEA,YAEiC;AACjC,MAAI,CAAC,SAAS,CAAC,YAAY;AACzB,aAAS,0CAA0C,EAAE,OAAO,WAAA,CAAY;AACxE,WAAO;AAAA,EACT;AAGA,QAAM,OAAO,MAAM,QAAQ,SAAS,EAAE;AACtC,MAAI,CAAC,MAAM;AACT,UAAMA,OAAM,UAAU,YAAY,UAAU;AAC5C,aAAS,iCAAiC,EAAE,OAAO,QAAQA,MAAK,YAAY;AAC5E,WAAOA;AAAAA,EACT;AAEA,QAAM,WAAW,KAAK,MAAM,GAAG;AAE/B,MAAI,UAAe;AAEnB,aAAW,WAAW,UAAU;AAC9B,cAAU,MAAM,SAAS,UAAU;AACnC,QAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,eAAS,yCAAyC,EAAE,OAAO,SAAS,YAAY;AAChF,aAAO;AAAA,IACT;AAGA,UAAM,WAAW,CAAC,SAAuC;AACvD,UAAI,YAAY,aAAc,QAAO,KAAK;AAC1C,UAAI,YAAY,QAAS,QAAO,KAAK;AACrC,aAAO,KAAK,OAAO;AAAA,IACrB;AAEA,QAAI,OAAO,SAAS,OAAO;AAC3B,QAAI,SAAS,QAAW;AACtB,aAAO,sBAAsB,SAAS,YAAY,QAAQ;AAAA,IAC5D;AACA,QAAI,SAAS,QAAW;AACtB,eAAS,iDAAiD,EAAE,OAAO,SAAS,SAAS,YAAY;AACjG,aAAO;AAAA,IACT;AACA,cAAU;AAAA,EACZ;AAEA,QAAM,MAAM,UAAU,SAAS,UAAU;AACzC,WAAS,qCAAqC,EAAE,OAAO,QAAQ,KAAK,YAAY;AAChF,SAAO;AACT;"}

package/dist/debug/overlay.d.ts

@@ -0,0 +1,18 @@
+/**
+ * In-DOM debug overlay for `@narrative.io/jsonforms-provider-protocols`.
+ *
+ * Renders a fixed-position panel with a scrollable list of structured log
+ * entries. Used in place of `console.*` because some host apps strip console
+ * output in production. No-op unless explicitly enabled at runtime via
+ * either `window.__PP_DEBUG__ = true` or `localStorage.PP_DEBUG = "1"`.
+ *
+ * Internal API. Not part of the package's public surface.
+ */
+/**
+ * Append a structured debug entry to the in-DOM overlay. No-op unless the
+ * runtime gate is on (`window.__PP_DEBUG__ === true` or
+ * `localStorage.PP_DEBUG === "1"`). Stringification is lazy: the payload is
+ * not serialized when the gate is off, so this is safe to leave in hot paths.
+ */
+export declare function debugLog(label: string, payload: unknown): void;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/debug/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/debug/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0TH;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA4B9D"}

package/dist/debug/overlay.js

@@ -0,0 +1,308 @@
+const RING_SIZE = 250;
+const PANEL_ID = "__pp_debug_panel__";
+const STYLE_ID = "__pp_debug_styles__";
+let entries = [];
+let panel = null;
+let listEl = null;
+function isEnabled() {
+  if (typeof window === "undefined") return false;
+  const w = window;
+  if (w.__PP_DEBUG__ === true) return true;
+  try {
+    return window.localStorage?.getItem("PP_DEBUG") === "1";
+  } catch {
+    return false;
+  }
+}
+function safeStringify(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  try {
+    const out = JSON.stringify(
+      value,
+      (_key, v) => {
+        if (typeof v === "object" && v !== null) {
+          if (seen.has(v)) return "[Circular]";
+          seen.add(v);
+        }
+        if (typeof v === "function")
+          return `[Function ${v.name || "anonymous"}]`;
+        if (typeof v === "undefined") return "[undefined]";
+        return v;
+      },
+      2
+    );
+    return out ?? String(value);
+  } catch (e) {
+    return `[unstringifiable: ${e.message}]`;
+  }
+}
+function ensureStyles() {
+  if (document.getElementById(STYLE_ID)) return;
+  const style = document.createElement("style");
+  style.id = STYLE_ID;
+  style.textContent = `
+#${PANEL_ID} {
+  position: fixed;
+  top: 12px;
+  left: 12px;
+  width: 460px;
+  max-height: 70vh;
+  z-index: 2147483647;
+  background: #0b0f17;
+  color: #d6e1ff;
+  border: 1px solid #2a3656;
+  border-radius: 6px;
+  font: 12px/1.35 ui-monospace, SFMono-Regular, Menlo, monospace;
+  box-shadow: 0 8px 32px rgba(0,0,0,0.45);
+  display: flex;
+  flex-direction: column;
+  resize: both;
+  overflow: hidden;
+}
+#${PANEL_ID} .pp-header {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  padding: 6px 8px;
+  background: #131a2c;
+  border-bottom: 1px solid #2a3656;
+  cursor: move;
+  user-select: none;
+  flex-shrink: 0;
+}
+#${PANEL_ID} .pp-title {
+  flex: 1;
+  font-weight: 600;
+  color: #9fb4ff;
+}
+#${PANEL_ID} .pp-count {
+  color: #6f7fa6;
+  font-weight: 400;
+  margin-left: 4px;
+}
+#${PANEL_ID} button {
+  background: #1f2a47;
+  color: #d6e1ff;
+  border: 1px solid #2a3656;
+  border-radius: 3px;
+  padding: 2px 6px;
+  cursor: pointer;
+  font: inherit;
+  line-height: 1.2;
+}
+#${PANEL_ID} button:hover { background: #2a3656; }
+#${PANEL_ID} .pp-list {
+  flex: 1;
+  overflow: auto;
+  padding: 4px 6px;
+}
+#${PANEL_ID}.pp-collapsed { resize: none; max-height: none; }
+#${PANEL_ID}.pp-collapsed .pp-list { display: none; }
+#${PANEL_ID} details {
+  margin: 4px 0;
+  border: 1px solid #2a3656;
+  border-radius: 3px;
+  background: #0f1422;
+}
+#${PANEL_ID} summary {
+  padding: 4px 6px;
+  cursor: pointer;
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  list-style: none;
+}
+#${PANEL_ID} summary::-webkit-details-marker { display: none; }
+#${PANEL_ID} summary::before {
+  content: "▸";
+  color: #6f7fa6;
+  width: 10px;
+}
+#${PANEL_ID} details[open] > summary::before { content: "▾"; }
+#${PANEL_ID} .pp-label {
+  color: #ffd479;
+  font-weight: 600;
+}
+#${PANEL_ID} .pp-ts {
+  color: #6f7fa6;
+}
+#${PANEL_ID} summary button { margin-left: auto; }
+#${PANEL_ID} pre {
+  margin: 0;
+  padding: 6px 8px;
+  max-height: 320px;
+  overflow: auto;
+  background: #050811;
+  color: #c9d6ff;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+`;
+  document.head.appendChild(style);
+}
+function makeButton(label, onClick) {
+  const btn = document.createElement("button");
+  btn.type = "button";
+  btn.textContent = label;
+  btn.addEventListener("click", onClick);
+  return btn;
+}
+function flashButton(btn, msg, original) {
+  btn.textContent = msg;
+  setTimeout(() => {
+    btn.textContent = original;
+  }, 1200);
+}
+function copyToClipboard(text, btn, original) {
+  const fallback = () => {
+    try {
+      const ta = document.createElement("textarea");
+      ta.value = text;
+      ta.style.position = "fixed";
+      ta.style.left = "-9999px";
+      document.body.appendChild(ta);
+      ta.select();
+      document.execCommand("copy");
+      document.body.removeChild(ta);
+      flashButton(btn, "copied", original);
+    } catch {
+      flashButton(btn, "fail", original);
+    }
+  };
+  if (navigator.clipboard?.writeText) {
+    navigator.clipboard.writeText(text).then(
+      () => flashButton(btn, "copied", original),
+      fallback
+    );
+  } else {
+    fallback();
+  }
+}
+function updateCount() {
+  if (!panel) return;
+  const countEl = panel.querySelector(".pp-count");
+  if (countEl) countEl.textContent = `(${entries.length})`;
+}
+function attachDrag(panelEl, header) {
+  let dragging = false;
+  let offX = 0;
+  let offY = 0;
+  header.addEventListener("mousedown", (e) => {
+    if (e.target.tagName === "BUTTON") return;
+    dragging = true;
+    const rect = panelEl.getBoundingClientRect();
+    offX = e.clientX - rect.left;
+    offY = e.clientY - rect.top;
+    e.preventDefault();
+  });
+  window.addEventListener("mousemove", (e) => {
+    if (!dragging) return;
+    panelEl.style.left = `${e.clientX - offX}px`;
+    panelEl.style.top = `${e.clientY - offY}px`;
+  });
+  window.addEventListener("mouseup", () => {
+    dragging = false;
+  });
+}
+function ensurePanel() {
+  if (panel && document.body.contains(panel)) return panel;
+  ensureStyles();
+  panel = document.createElement("div");
+  panel.id = PANEL_ID;
+  const header = document.createElement("div");
+  header.className = "pp-header";
+  const title = document.createElement("span");
+  title.className = "pp-title";
+  title.textContent = "[provider-protocols] debug";
+  const count = document.createElement("span");
+  count.className = "pp-count";
+  count.textContent = `(${entries.length})`;
+  title.appendChild(count);
+  header.appendChild(title);
+  const copyAllBtn = makeButton("copy all", (e) => {
+    e.stopPropagation();
+    const blob = entries.map((en) => `// ${new Date(en.ts).toISOString()} ${en.label}
+${en.json}`).join("\n\n");
+    copyToClipboard(blob, copyAllBtn, "copy all");
+  });
+  header.appendChild(copyAllBtn);
+  const clearBtn = makeButton("clear", (e) => {
+    e.stopPropagation();
+    entries = [];
+    if (listEl) listEl.innerHTML = "";
+    updateCount();
+  });
+  header.appendChild(clearBtn);
+  const collapseBtn = makeButton("−", (e) => {
+    e.stopPropagation();
+    panel.classList.toggle("pp-collapsed");
+    collapseBtn.textContent = panel.classList.contains("pp-collapsed") ? "+" : "−";
+  });
+  header.appendChild(collapseBtn);
+  attachDrag(panel, header);
+  panel.appendChild(header);
+  listEl = document.createElement("div");
+  listEl.className = "pp-list";
+  panel.appendChild(listEl);
+  document.body.appendChild(panel);
+  return panel;
+}
+function renderEntry(entry) {
+  if (!listEl) return;
+  const det = document.createElement("details");
+  det.open = false;
+  const sum = document.createElement("summary");
+  const lbl = document.createElement("span");
+  lbl.className = "pp-label";
+  lbl.textContent = entry.label;
+  const ts = document.createElement("span");
+  ts.className = "pp-ts";
+  ts.textContent = new Date(entry.ts).toISOString().slice(11, 23);
+  const copyBtn = makeButton("copy", (e) => {
+    e.preventDefault();
+    e.stopPropagation();
+    copyToClipboard(entry.json, copyBtn, "copy");
+  });
+  sum.appendChild(lbl);
+  sum.appendChild(ts);
+  sum.appendChild(copyBtn);
+  det.appendChild(sum);
+  const pre = document.createElement("pre");
+  pre.textContent = entry.json;
+  det.appendChild(pre);
+  listEl.appendChild(det);
+  listEl.scrollTop = listEl.scrollHeight;
+  while (listEl.children.length > RING_SIZE) {
+    const first = listEl.firstChild;
+    if (first) listEl.removeChild(first);
+    else break;
+  }
+}
+function debugLog(label, payload) {
+  if (!isEnabled()) return;
+  if (typeof document === "undefined") return;
+  const entry = {
+    ts: Date.now(),
+    label,
+    json: safeStringify(payload)
+  };
+  entries.push(entry);
+  if (entries.length > RING_SIZE) entries.shift();
+  const append = () => {
+    try {
+      ensurePanel();
+      renderEntry(entry);
+      updateCount();
+    } catch {
+    }
+  };
+  if (document.body) {
+    append();
+  } else {
+    document.addEventListener("DOMContentLoaded", append, { once: true });
+  }
+}
+export {
+  debugLog
+};
+//# sourceMappingURL=overlay.js.map

package/dist/debug/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sources":["../../src/debug/overlay.ts"],"sourcesContent":["/**\n * In-DOM debug overlay for `@narrative.io/jsonforms-provider-protocols`.\n *\n * Renders a fixed-position panel with a scrollable list of structured log\n * entries. Used in place of `console.*` because some host apps strip console\n * output in production. No-op unless explicitly enabled at runtime via\n * either `window.__PP_DEBUG__ = true` or `localStorage.PP_DEBUG = \"1\"`.\n *\n * Internal API. Not part of the package's public surface.\n */\n\nconst RING_SIZE = 250;\nconst PANEL_ID = \"__pp_debug_panel__\";\nconst STYLE_ID = \"__pp_debug_styles__\";\n\ninterface Entry {\n  ts: number;\n  label: string;\n  json: string;\n}\n\nlet entries: Entry[] = [];\nlet panel: HTMLElement | null = null;\nlet listEl: HTMLElement | null = null;\n\nfunction isEnabled(): boolean {\n  if (typeof window === \"undefined\") return false;\n  const w = window as unknown as { __PP_DEBUG__?: boolean };\n  if (w.__PP_DEBUG__ === true) return true;\n  try {\n    return window.localStorage?.getItem(\"PP_DEBUG\") === \"1\";\n  } catch {\n    return false;\n  }\n}\n\nfunction safeStringify(value: unknown): string {\n  const seen = new WeakSet<object>();\n  try {\n    const out = JSON.stringify(\n      value,\n      (_key, v) => {\n        if (typeof v === \"object\" && v !== null) {\n          if (seen.has(v as object)) return \"[Circular]\";\n          seen.add(v as object);\n        }\n        if (typeof v === \"function\")\n          return `[Function ${(v as { name?: string }).name || \"anonymous\"}]`;\n        if (typeof v === \"undefined\") return \"[undefined]\";\n        return v;\n      },\n      2,\n    );\n    return out ?? String(value);\n  } catch (e) {\n    return `[unstringifiable: ${(e as Error).message}]`;\n  }\n}\n\nfunction ensureStyles(): void {\n  if (document.getElementById(STYLE_ID)) return;\n  const style = document.createElement(\"style\");\n  style.id = STYLE_ID;\n  style.textContent = `\n#${PANEL_ID} {\n  position: fixed;\n  top: 12px;\n  left: 12px;\n  width: 460px;\n  max-height: 70vh;\n  z-index: 2147483647;\n  background: #0b0f17;\n  color: #d6e1ff;\n  border: 1px solid #2a3656;\n  border-radius: 6px;\n  font: 12px/1.35 ui-monospace, SFMono-Regular, Menlo, monospace;\n  box-shadow: 0 8px 32px rgba(0,0,0,0.45);\n  display: flex;\n  flex-direction: column;\n  resize: both;\n  overflow: hidden;\n}\n#${PANEL_ID} .pp-header {\n  display: flex;\n  gap: 6px;\n  align-items: center;\n  padding: 6px 8px;\n  background: #131a2c;\n  border-bottom: 1px solid #2a3656;\n  cursor: move;\n  user-select: none;\n  flex-shrink: 0;\n}\n#${PANEL_ID} .pp-title {\n  flex: 1;\n  font-weight: 600;\n  color: #9fb4ff;\n}\n#${PANEL_ID} .pp-count {\n  color: #6f7fa6;\n  font-weight: 400;\n  margin-left: 4px;\n}\n#${PANEL_ID} button {\n  background: #1f2a47;\n  color: #d6e1ff;\n  border: 1px solid #2a3656;\n  border-radius: 3px;\n  padding: 2px 6px;\n  cursor: pointer;\n  font: inherit;\n  line-height: 1.2;\n}\n#${PANEL_ID} button:hover { background: #2a3656; }\n#${PANEL_ID} .pp-list {\n  flex: 1;\n  overflow: auto;\n  padding: 4px 6px;\n}\n#${PANEL_ID}.pp-collapsed { resize: none; max-height: none; }\n#${PANEL_ID}.pp-collapsed .pp-list { display: none; }\n#${PANEL_ID} details {\n  margin: 4px 0;\n  border: 1px solid #2a3656;\n  border-radius: 3px;\n  background: #0f1422;\n}\n#${PANEL_ID} summary {\n  padding: 4px 6px;\n  cursor: pointer;\n  display: flex;\n  gap: 6px;\n  align-items: center;\n  list-style: none;\n}\n#${PANEL_ID} summary::-webkit-details-marker { display: none; }\n#${PANEL_ID} summary::before {\n  content: \"▸\";\n  color: #6f7fa6;\n  width: 10px;\n}\n#${PANEL_ID} details[open] > summary::before { content: \"▾\"; }\n#${PANEL_ID} .pp-label {\n  color: #ffd479;\n  font-weight: 600;\n}\n#${PANEL_ID} .pp-ts {\n  color: #6f7fa6;\n}\n#${PANEL_ID} summary button { margin-left: auto; }\n#${PANEL_ID} pre {\n  margin: 0;\n  padding: 6px 8px;\n  max-height: 320px;\n  overflow: auto;\n  background: #050811;\n  color: #c9d6ff;\n  white-space: pre-wrap;\n  word-break: break-word;\n}\n`;\n  document.head.appendChild(style);\n}\n\nfunction makeButton(label: string, onClick: (e: MouseEvent) => void): HTMLButtonElement {\n  const btn = document.createElement(\"button\");\n  btn.type = \"button\";\n  btn.textContent = label;\n  btn.addEventListener(\"click\", onClick);\n  return btn;\n}\n\nfunction flashButton(btn: HTMLButtonElement, msg: string, original: string): void {\n  btn.textContent = msg;\n  setTimeout(() => {\n    btn.textContent = original;\n  }, 1200);\n}\n\nfunction copyToClipboard(text: string, btn: HTMLButtonElement, original: string): void {\n  const fallback = () => {\n    try {\n      const ta = document.createElement(\"textarea\");\n      ta.value = text;\n      ta.style.position = \"fixed\";\n      ta.style.left = \"-9999px\";\n      document.body.appendChild(ta);\n      ta.select();\n      document.execCommand(\"copy\");\n      document.body.removeChild(ta);\n      flashButton(btn, \"copied\", original);\n    } catch {\n      flashButton(btn, \"fail\", original);\n    }\n  };\n  if (navigator.clipboard?.writeText) {\n    navigator.clipboard.writeText(text).then(\n      () => flashButton(btn, \"copied\", original),\n      fallback,\n    );\n  } else {\n    fallback();\n  }\n}\n\nfunction updateCount(): void {\n  if (!panel) return;\n  const countEl = panel.querySelector(\".pp-count\");\n  if (countEl) countEl.textContent = `(${entries.length})`;\n}\n\nfunction attachDrag(panelEl: HTMLElement, header: HTMLElement): void {\n  let dragging = false;\n  let offX = 0;\n  let offY = 0;\n  header.addEventListener(\"mousedown\", (e) => {\n    if ((e.target as HTMLElement).tagName === \"BUTTON\") return;\n    dragging = true;\n    const rect = panelEl.getBoundingClientRect();\n    offX = e.clientX - rect.left;\n    offY = e.clientY - rect.top;\n    e.preventDefault();\n  });\n  window.addEventListener(\"mousemove\", (e) => {\n    if (!dragging) return;\n    panelEl.style.left = `${e.clientX - offX}px`;\n    panelEl.style.top = `${e.clientY - offY}px`;\n  });\n  window.addEventListener(\"mouseup\", () => {\n    dragging = false;\n  });\n}\n\nfunction ensurePanel(): HTMLElement {\n  if (panel && document.body.contains(panel)) return panel;\n  ensureStyles();\n\n  panel = document.createElement(\"div\");\n  panel.id = PANEL_ID;\n\n  const header = document.createElement(\"div\");\n  header.className = \"pp-header\";\n\n  const title = document.createElement(\"span\");\n  title.className = \"pp-title\";\n  title.textContent = \"[provider-protocols] debug\";\n  const count = document.createElement(\"span\");\n  count.className = \"pp-count\";\n  count.textContent = `(${entries.length})`;\n  title.appendChild(count);\n  header.appendChild(title);\n\n  const copyAllBtn = makeButton(\"copy all\", (e) => {\n    e.stopPropagation();\n    const blob = entries\n      .map((en) => `// ${new Date(en.ts).toISOString()} ${en.label}\\n${en.json}`)\n      .join(\"\\n\\n\");\n    copyToClipboard(blob, copyAllBtn, \"copy all\");\n  });\n  header.appendChild(copyAllBtn);\n\n  const clearBtn = makeButton(\"clear\", (e) => {\n    e.stopPropagation();\n    entries = [];\n    if (listEl) listEl.innerHTML = \"\";\n    updateCount();\n  });\n  header.appendChild(clearBtn);\n\n  const collapseBtn = makeButton(\"−\", (e) => {\n    e.stopPropagation();\n    panel!.classList.toggle(\"pp-collapsed\");\n    collapseBtn.textContent = panel!.classList.contains(\"pp-collapsed\") ? \"+\" : \"−\";\n  });\n  header.appendChild(collapseBtn);\n\n  attachDrag(panel, header);\n  panel.appendChild(header);\n\n  listEl = document.createElement(\"div\");\n  listEl.className = \"pp-list\";\n  panel.appendChild(listEl);\n\n  document.body.appendChild(panel);\n  return panel;\n}\n\nfunction renderEntry(entry: Entry): void {\n  if (!listEl) return;\n  const det = document.createElement(\"details\");\n  det.open = false;\n\n  const sum = document.createElement(\"summary\");\n  const lbl = document.createElement(\"span\");\n  lbl.className = \"pp-label\";\n  lbl.textContent = entry.label;\n  const ts = document.createElement(\"span\");\n  ts.className = \"pp-ts\";\n  ts.textContent = new Date(entry.ts).toISOString().slice(11, 23);\n  const copyBtn = makeButton(\"copy\", (e) => {\n    e.preventDefault();\n    e.stopPropagation();\n    copyToClipboard(entry.json, copyBtn, \"copy\");\n  });\n  sum.appendChild(lbl);\n  sum.appendChild(ts);\n  sum.appendChild(copyBtn);\n  det.appendChild(sum);\n\n  const pre = document.createElement(\"pre\");\n  pre.textContent = entry.json;\n  det.appendChild(pre);\n\n  listEl.appendChild(det);\n  listEl.scrollTop = listEl.scrollHeight;\n\n  while (listEl.children.length > RING_SIZE) {\n    const first = listEl.firstChild;\n    if (first) listEl.removeChild(first);\n    else break;\n  }\n}\n\n/**\n * Append a structured debug entry to the in-DOM overlay. No-op unless the\n * runtime gate is on (`window.__PP_DEBUG__ === true` or\n * `localStorage.PP_DEBUG === \"1\"`). Stringification is lazy: the payload is\n * not serialized when the gate is off, so this is safe to leave in hot paths.\n */\nexport function debugLog(label: string, payload: unknown): void {\n  if (!isEnabled()) return;\n  if (typeof document === \"undefined\") return;\n\n  const entry: Entry = {\n    ts: Date.now(),\n    label,\n    json: safeStringify(payload),\n  };\n\n  entries.push(entry);\n  if (entries.length > RING_SIZE) entries.shift();\n\n  const append = () => {\n    try {\n      ensurePanel();\n      renderEntry(entry);\n      updateCount();\n    } catch {\n      // never break the host on debug failure\n    }\n  };\n\n  if (document.body) {\n    append();\n  } else {\n    document.addEventListener(\"DOMContentLoaded\", append, { once: true });\n  }\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narrative.io/jsonforms-provider-protocols",
-	"version": "3.0.0-beta.18",
+	"version": "3.0.0-beta.19",
 	"description": "Dynamic data provider capabilities for JSONForms with Vue 3 integration",
 	"type": "module",
 	"author": "Narrative I/O",

package/src/core/initFormData.ts

@@ -41,10 +41,12 @@ export function initFormDataFromSchema(
     }
   }
 
+  debugLog("[initFormData] initFormDataFromSchema", { schema, seed, output: base });
   return base;
 }
 
 import { resolveRef } from "./refs";
+import { debugLog } from "../debug/overlay";
 
 /**
  * Initialize a single property value based on its schema definition.

package/src/core/projection.ts

@@ -2,6 +2,7 @@ import {
   deref as derefSchema,
   tryCombinatorBranches,
 } from "./refs";
+import { debugLog } from "../debug/overlay";
 
 /**
  * Projection utilities for navigating complex data structures
@@ -119,7 +120,10 @@ export function getProjectedSchema(
 
   for (const seg of segments) {
     current = derefSchema(current, schema);
-    if (!current) return {};
+    if (!current) {
+      debugLog("[projection] empty (deref miss)", { path, segment: seg, rootSchema: schema });
+      return {};
+    }
 
     const navigate = (
       node: Record<string, unknown>,
@@ -141,10 +145,15 @@ export function getProjectedSchema(
     if (next === undefined) {
       next = tryCombinatorBranches(current, schema, navigate);
     }
-    if (!next) return {};
+    if (!next) {
+      debugLog("[projection] empty (segment unresolved)", { path, segment: seg, current, rootSchema: schema });
+      return {};
+    }
     current = next;
   }
 
   const resolved = derefSchema(current, schema);
-  return resolved ?? {};
+  const out = resolved ?? {};
+  debugLog("[projection] getProjectedSchema", { path, output: out, rootSchema: schema });
+  return out;
 }

package/src/core/resolveScope.ts

@@ -1,4 +1,5 @@
 import { deepDeref, deref, tryCombinatorBranches } from "./refs";
+import { debugLog } from "../debug/overlay";
 
 /**
  * Resolve a JSON Forms scope path to its schema within a root schema.
@@ -21,11 +22,18 @@ export function resolveScopeSchema(
   rootSchema: Record<string, any>,
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ): Record<string, any> | undefined {
-  if (!scope || !rootSchema) return undefined;
+  if (!scope || !rootSchema) {
+    debugLog("[resolveScope] undefined (empty input)", { scope, rootSchema });
+    return undefined;
+  }
 
   // Remove the leading "#/" and split into segments
   const path = scope.replace(/^#\/?/, "");
-  if (!path) return deepDeref(rootSchema, rootSchema);
+  if (!path) {
+    const out = deepDeref(rootSchema, rootSchema);
+    debugLog("[resolveScope] root deepDeref", { scope, output: out, rootSchema });
+    return out;
+  }
 
   const segments = path.split("/");
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -33,7 +41,10 @@ export function resolveScopeSchema(
 
   for (const segment of segments) {
     current = deref(current, rootSchema);
-    if (!current || typeof current !== "object") return undefined;
+    if (!current || typeof current !== "object") {
+      debugLog("[resolveScope] undefined (deref miss)", { scope, segment, rootSchema });
+      return undefined;
+    }
 
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const navigate = (node: Record<string, any>): unknown => {
@@ -46,9 +57,14 @@ export function resolveScopeSchema(
     if (next === undefined) {
       next = tryCombinatorBranches(current, rootSchema, navigate);
     }
-    if (next === undefined) return undefined;
+    if (next === undefined) {
+      debugLog("[resolveScope] undefined (segment unresolved)", { scope, segment, current, rootSchema });
+      return undefined;
+    }
     current = next;
   }
 
-  return deepDeref(current, rootSchema);
+  const out = deepDeref(current, rootSchema);
+  debugLog("[resolveScope] resolveScopeSchema", { scope, output: out, rootSchema });
+  return out;
 }

package/src/debug/overlay.ts

@@ -0,0 +1,358 @@
+/**
+ * In-DOM debug overlay for `@narrative.io/jsonforms-provider-protocols`.
+ *
+ * Renders a fixed-position panel with a scrollable list of structured log
+ * entries. Used in place of `console.*` because some host apps strip console
+ * output in production. No-op unless explicitly enabled at runtime via
+ * either `window.__PP_DEBUG__ = true` or `localStorage.PP_DEBUG = "1"`.
+ *
+ * Internal API. Not part of the package's public surface.
+ */
+
+const RING_SIZE = 250;
+const PANEL_ID = "__pp_debug_panel__";
+const STYLE_ID = "__pp_debug_styles__";
+
+interface Entry {
+  ts: number;
+  label: string;
+  json: string;
+}
+
+let entries: Entry[] = [];
+let panel: HTMLElement | null = null;
+let listEl: HTMLElement | null = null;
+
+function isEnabled(): boolean {
+  if (typeof window === "undefined") return false;
+  const w = window as unknown as { __PP_DEBUG__?: boolean };
+  if (w.__PP_DEBUG__ === true) return true;
+  try {
+    return window.localStorage?.getItem("PP_DEBUG") === "1";
+  } catch {
+    return false;
+  }
+}
+
+function safeStringify(value: unknown): string {
+  const seen = new WeakSet<object>();
+  try {
+    const out = JSON.stringify(
+      value,
+      (_key, v) => {
+        if (typeof v === "object" && v !== null) {
+          if (seen.has(v as object)) return "[Circular]";
+          seen.add(v as object);
+        }
+        if (typeof v === "function")
+          return `[Function ${(v as { name?: string }).name || "anonymous"}]`;
+        if (typeof v === "undefined") return "[undefined]";
+        return v;
+      },
+      2,
+    );
+    return out ?? String(value);
+  } catch (e) {
+    return `[unstringifiable: ${(e as Error).message}]`;
+  }
+}
+
+function ensureStyles(): void {
+  if (document.getElementById(STYLE_ID)) return;
+  const style = document.createElement("style");
+  style.id = STYLE_ID;
+  style.textContent = `
+#${PANEL_ID} {
+  position: fixed;
+  top: 12px;
+  left: 12px;
+  width: 460px;
+  max-height: 70vh;
+  z-index: 2147483647;
+  background: #0b0f17;
+  color: #d6e1ff;
+  border: 1px solid #2a3656;
+  border-radius: 6px;
+  font: 12px/1.35 ui-monospace, SFMono-Regular, Menlo, monospace;
+  box-shadow: 0 8px 32px rgba(0,0,0,0.45);
+  display: flex;
+  flex-direction: column;
+  resize: both;
+  overflow: hidden;
+}
+#${PANEL_ID} .pp-header {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  padding: 6px 8px;
+  background: #131a2c;
+  border-bottom: 1px solid #2a3656;
+  cursor: move;
+  user-select: none;
+  flex-shrink: 0;
+}
+#${PANEL_ID} .pp-title {
+  flex: 1;
+  font-weight: 600;
+  color: #9fb4ff;
+}
+#${PANEL_ID} .pp-count {
+  color: #6f7fa6;
+  font-weight: 400;
+  margin-left: 4px;
+}
+#${PANEL_ID} button {
+  background: #1f2a47;
+  color: #d6e1ff;
+  border: 1px solid #2a3656;
+  border-radius: 3px;
+  padding: 2px 6px;
+  cursor: pointer;
+  font: inherit;
+  line-height: 1.2;
+}
+#${PANEL_ID} button:hover { background: #2a3656; }
+#${PANEL_ID} .pp-list {
+  flex: 1;
+  overflow: auto;
+  padding: 4px 6px;
+}
+#${PANEL_ID}.pp-collapsed { resize: none; max-height: none; }
+#${PANEL_ID}.pp-collapsed .pp-list { display: none; }
+#${PANEL_ID} details {
+  margin: 4px 0;
+  border: 1px solid #2a3656;
+  border-radius: 3px;
+  background: #0f1422;
+}
+#${PANEL_ID} summary {
+  padding: 4px 6px;
+  cursor: pointer;
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  list-style: none;
+}
+#${PANEL_ID} summary::-webkit-details-marker { display: none; }
+#${PANEL_ID} summary::before {
+  content: "▸";
+  color: #6f7fa6;
+  width: 10px;
+}
+#${PANEL_ID} details[open] > summary::before { content: "▾"; }
+#${PANEL_ID} .pp-label {
+  color: #ffd479;
+  font-weight: 600;
+}
+#${PANEL_ID} .pp-ts {
+  color: #6f7fa6;
+}
+#${PANEL_ID} summary button { margin-left: auto; }
+#${PANEL_ID} pre {
+  margin: 0;
+  padding: 6px 8px;
+  max-height: 320px;
+  overflow: auto;
+  background: #050811;
+  color: #c9d6ff;
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+`;
+  document.head.appendChild(style);
+}
+
+function makeButton(label: string, onClick: (e: MouseEvent) => void): HTMLButtonElement {
+  const btn = document.createElement("button");
+  btn.type = "button";
+  btn.textContent = label;
+  btn.addEventListener("click", onClick);
+  return btn;
+}
+
+function flashButton(btn: HTMLButtonElement, msg: string, original: string): void {
+  btn.textContent = msg;
+  setTimeout(() => {
+    btn.textContent = original;
+  }, 1200);
+}
+
+function copyToClipboard(text: string, btn: HTMLButtonElement, original: string): void {
+  const fallback = () => {
+    try {
+      const ta = document.createElement("textarea");
+      ta.value = text;
+      ta.style.position = "fixed";
+      ta.style.left = "-9999px";
+      document.body.appendChild(ta);
+      ta.select();
+      document.execCommand("copy");
+      document.body.removeChild(ta);
+      flashButton(btn, "copied", original);
+    } catch {
+      flashButton(btn, "fail", original);
+    }
+  };
+  if (navigator.clipboard?.writeText) {
+    navigator.clipboard.writeText(text).then(
+      () => flashButton(btn, "copied", original),
+      fallback,
+    );
+  } else {
+    fallback();
+  }
+}
+
+function updateCount(): void {
+  if (!panel) return;
+  const countEl = panel.querySelector(".pp-count");
+  if (countEl) countEl.textContent = `(${entries.length})`;
+}
+
+function attachDrag(panelEl: HTMLElement, header: HTMLElement): void {
+  let dragging = false;
+  let offX = 0;
+  let offY = 0;
+  header.addEventListener("mousedown", (e) => {
+    if ((e.target as HTMLElement).tagName === "BUTTON") return;
+    dragging = true;
+    const rect = panelEl.getBoundingClientRect();
+    offX = e.clientX - rect.left;
+    offY = e.clientY - rect.top;
+    e.preventDefault();
+  });
+  window.addEventListener("mousemove", (e) => {
+    if (!dragging) return;
+    panelEl.style.left = `${e.clientX - offX}px`;
+    panelEl.style.top = `${e.clientY - offY}px`;
+  });
+  window.addEventListener("mouseup", () => {
+    dragging = false;
+  });
+}
+
+function ensurePanel(): HTMLElement {
+  if (panel && document.body.contains(panel)) return panel;
+  ensureStyles();
+
+  panel = document.createElement("div");
+  panel.id = PANEL_ID;
+
+  const header = document.createElement("div");
+  header.className = "pp-header";
+
+  const title = document.createElement("span");
+  title.className = "pp-title";
+  title.textContent = "[provider-protocols] debug";
+  const count = document.createElement("span");
+  count.className = "pp-count";
+  count.textContent = `(${entries.length})`;
+  title.appendChild(count);
+  header.appendChild(title);
+
+  const copyAllBtn = makeButton("copy all", (e) => {
+    e.stopPropagation();
+    const blob = entries
+      .map((en) => `// ${new Date(en.ts).toISOString()} ${en.label}\n${en.json}`)
+      .join("\n\n");
+    copyToClipboard(blob, copyAllBtn, "copy all");
+  });
+  header.appendChild(copyAllBtn);
+
+  const clearBtn = makeButton("clear", (e) => {
+    e.stopPropagation();
+    entries = [];
+    if (listEl) listEl.innerHTML = "";
+    updateCount();
+  });
+  header.appendChild(clearBtn);
+
+  const collapseBtn = makeButton("−", (e) => {
+    e.stopPropagation();
+    panel!.classList.toggle("pp-collapsed");
+    collapseBtn.textContent = panel!.classList.contains("pp-collapsed") ? "+" : "−";
+  });
+  header.appendChild(collapseBtn);
+
+  attachDrag(panel, header);
+  panel.appendChild(header);
+
+  listEl = document.createElement("div");
+  listEl.className = "pp-list";
+  panel.appendChild(listEl);
+
+  document.body.appendChild(panel);
+  return panel;
+}
+
+function renderEntry(entry: Entry): void {
+  if (!listEl) return;
+  const det = document.createElement("details");
+  det.open = false;
+
+  const sum = document.createElement("summary");
+  const lbl = document.createElement("span");
+  lbl.className = "pp-label";
+  lbl.textContent = entry.label;
+  const ts = document.createElement("span");
+  ts.className = "pp-ts";
+  ts.textContent = new Date(entry.ts).toISOString().slice(11, 23);
+  const copyBtn = makeButton("copy", (e) => {
+    e.preventDefault();
+    e.stopPropagation();
+    copyToClipboard(entry.json, copyBtn, "copy");
+  });
+  sum.appendChild(lbl);
+  sum.appendChild(ts);
+  sum.appendChild(copyBtn);
+  det.appendChild(sum);
+
+  const pre = document.createElement("pre");
+  pre.textContent = entry.json;
+  det.appendChild(pre);
+
+  listEl.appendChild(det);
+  listEl.scrollTop = listEl.scrollHeight;
+
+  while (listEl.children.length > RING_SIZE) {
+    const first = listEl.firstChild;
+    if (first) listEl.removeChild(first);
+    else break;
+  }
+}
+
+/**
+ * Append a structured debug entry to the in-DOM overlay. No-op unless the
+ * runtime gate is on (`window.__PP_DEBUG__ === true` or
+ * `localStorage.PP_DEBUG === "1"`). Stringification is lazy: the payload is
+ * not serialized when the gate is off, so this is safe to leave in hot paths.
+ */
+export function debugLog(label: string, payload: unknown): void {
+  if (!isEnabled()) return;
+  if (typeof document === "undefined") return;
+
+  const entry: Entry = {
+    ts: Date.now(),
+    label,
+    json: safeStringify(payload),
+  };
+
+  entries.push(entry);
+  if (entries.length > RING_SIZE) entries.shift();
+
+  const append = () => {
+    try {
+      ensurePanel();
+      renderEntry(entry);
+      updateCount();
+    } catch {
+      // never break the host on debug failure
+    }
+  };
+
+  if (document.body) {
+    append();
+  } else {
+    document.addEventListener("DOMContentLoaded", append, { once: true });
+  }
+}