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

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.17",
+	"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

@@ -1,4 +1,8 @@
-import { deref as derefSchema } from "./refs";
+import {
+  deref as derefSchema,
+  tryCombinatorBranches,
+} from "./refs";
+import { debugLog } from "../debug/overlay";
 
 /**
  * Projection utilities for navigating complex data structures
@@ -100,9 +104,9 @@ function setAtPath(
  * Numeric segments traverse into `items` (array item schema).
  * String segments traverse into `properties[segment]`.
  *
- * `$ref` nodes are dereferenced transparently at every step, so projections
- * that cross a `$ref` boundary (e.g. `items: { $ref: "#/$defs/X" }`) resolve
- * to the target schema rather than collapsing to `{}`.
+ * Dereferences `$ref` nodes transparently at every step, and falls through
+ * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve
+ * directly — picks the first branch that satisfies the navigation.
  */
 export function getProjectedSchema(
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -116,29 +120,40 @@ 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 {};
+    }
 
-    if (typeof seg === "number") {
-      // Array index → traverse into items schema
-      const items = current.items;
-      if (items && typeof items === "object") {
-        current = items as Record<string, unknown>;
-      } else {
-        return {};
+    const navigate = (
+      node: Record<string, unknown>,
+    ): Record<string, unknown> | undefined => {
+      if (typeof seg === "number") {
+        const items = (node as { items?: unknown }).items;
+        return items && typeof items === "object"
+          ? (items as Record<string, unknown>)
+          : undefined;
       }
-    } else {
-      // Object key → traverse into properties[key]
-      const properties = current.properties as
+      const properties = (node as { properties?: unknown }).properties as
         | Record<string, Record<string, unknown>>
         | undefined;
-      if (properties && properties[seg]) {
-        current = properties[seg];
-      } else {
-        return {};
-      }
+      if (properties && properties[seg]) return properties[seg];
+      return undefined;
+    };
+
+    let next = navigate(current);
+    if (next === undefined) {
+      next = tryCombinatorBranches(current, schema, navigate);
+    }
+    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/refs.ts

@@ -74,6 +74,58 @@ export function deref(
   return resolveRef(node, root) as Record<string, unknown> | undefined;
 }
 
+/**
+ * Depth limit for combinator (oneOf/anyOf/allOf) branch descent. Schemas
+ * rarely nest combinators beyond one or two levels; this guard protects
+ * against pathological nesting and cycles (e.g. `oneOf: [$ref back to self]`).
+ */
+const COMBINATOR_DEPTH_LIMIT = 8;
+
+/**
+ * Try to navigate a segment through a schema node's combinator branches
+ * (`oneOf` / `anyOf` / `allOf`) when direct navigation has failed.
+ *
+ * Semantics: for walker purposes (renderer-tester matching), we only need
+ * ONE concrete schema that satisfies the next navigation step. First-match
+ * by structural shape wins, same convention as `initOneOf` uses for seeding.
+ *
+ * @param node     the schema node to search (already dereffed by caller)
+ * @param root     the root schema, for dereferencing branch `$ref`s
+ * @param tryFn    predicate that attempts navigation on a candidate branch
+ *                 and returns the navigated value, or `undefined` if the
+ *                 branch doesn't have what the caller's looking for
+ * @param depth    recursion depth (capped at `COMBINATOR_DEPTH_LIMIT`)
+ */
+export function tryCombinatorBranches<T>(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  node: Record<string, any> | undefined,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  root: Record<string, any>,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  tryFn: (candidate: Record<string, any>) => T | undefined,
+  depth = 0,
+): T | undefined {
+  if (depth > COMBINATOR_DEPTH_LIMIT) return undefined;
+  if (!node || typeof node !== "object") return undefined;
+
+  const branches = (node.oneOf || node.anyOf || node.allOf) as
+    | Record<string, unknown>[]
+    | undefined;
+  if (!Array.isArray(branches)) return undefined;
+
+  for (const raw of branches) {
+    const branch = deref(raw as Record<string, unknown>, root);
+    if (!branch || typeof branch !== "object") continue;
+
+    const direct = tryFn(branch);
+    if (direct !== undefined) return direct;
+
+    const nested = tryCombinatorBranches(branch, root, tryFn, depth + 1);
+    if (nested !== undefined) return nested;
+  }
+  return undefined;
+}
+
 /**
  * Recursively dereference every `$ref` in a schema subtree, producing a
  * concrete schema with no remaining refs. Cycles along any single chain are

package/src/core/resolveScope.ts

@@ -1,4 +1,5 @@
-import { deepDeref, deref } from "./refs";
+import { deepDeref, deref, tryCombinatorBranches } from "./refs";
+import { debugLog } from "../debug/overlay";
 
 /**
  * Resolve a JSON Forms scope path to its schema within a root schema.
@@ -9,11 +10,11 @@ import { deepDeref, deref } from "./refs";
  *   - "items" segments navigate into array `.items`
  *   - all other segments index directly into the current object
  *
- * `$ref` nodes are dereferenced transparently at every step, so scopes that
- * cross a `$ref` boundary (e.g. `items: { $ref: "#/$defs/X" }`) resolve to
- * the target schema rather than returning `{}`. The returned schema is also
- * deep-dereferenced so downstream walkers (e.g. `getProjectedSchema`) can
- * operate on a self-contained sub-schema without needing the original root.
+ * Dereferences `$ref` nodes transparently at every step, and falls through
+ * to `oneOf` / `anyOf` / `allOf` branches when a segment can't resolve
+ * directly — picks the first branch that satisfies the navigation. The
+ * returned schema is deep-dereferenced so downstream walkers can operate on
+ * a self-contained sub-schema without needing the original root.
  */
 export function resolveScopeSchema(
   scope: string,
@@ -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,16 +41,30 @@ 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;
+    }
 
-    if (segment === "properties") {
-      current = current.properties;
-    } else if (segment === "items") {
-      current = current.items;
-    } else {
-      current = current[segment];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const navigate = (node: Record<string, any>): unknown => {
+      if (segment === "properties") return node.properties;
+      if (segment === "items") return node.items;
+      return node[segment];
+    };
+
+    let next = navigate(current);
+    if (next === undefined) {
+      next = tryCombinatorBranches(current, rootSchema, navigate);
+    }
+    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;
 }