@canmi/seam-react 0.2.3 → 0.2.14

package/dist/index.d.ts

@@ -21,6 +21,7 @@ interface RouteDef {
   loaders?: Record<string, LoaderDef>;
   mock?: Record<string, unknown>;
   nullable?: string[];
+  staleTime?: number;
 }
 //#endregion
 //#region src/define-routes.d.ts
@@ -40,7 +41,7 @@ declare function parseSeamData(): Record<string, unknown>;
  * sentinel array where each leaf in the object template uses `$.` path prefix.
  * Arrays of primitives, empty arrays, and null remain leaf sentinels.
  */
-declare function buildSentinelData(obj: Record<string, unknown>, prefix?: string): Record<string, unknown>;
+declare function buildSentinelData(obj: Record<string, unknown>, prefix?: string, htmlPaths?: Set<string>): Record<string, unknown>;
 //#endregion
 //#region src/use-seam-subscription.d.ts
 type SubscriptionStatus = "connecting" | "active" | "error" | "closed";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/define-routes.ts","../src/use-seam-data.ts","../src/sentinel.ts","../src/use-seam-subscription.ts","../src/use-seam-navigate.ts"],"mappings":";;;;;UAIiB,YAAA;EACf,IAAA;EACA,IAAA;AAAA;AAAA,UAGe,SAAA;EACf,SAAA;EACA,MAAA,GAAS,MAAA,SAAe,YAAA;AAAA;AAAA,UAGT,QAAA;EACf,IAAA;EACA,SAAA,GAAY,aAAA,CAAc,MAAA;EAC1B,MAAA,GAAS,aAAA;IAAgB,QAAA,EAAU,SAAA;EAAA;EACnC,QAAA,GAAW,QAAA;EACX,OAAA,GAAU,MAAA,SAAe,SAAA;EACzB,IAAA,GAAO,MAAA;EACP,QAAA;AAAA;;;iBCjBc,YAAA,CAAa,MAAA,EAAQ,QAAA,KAAa,QAAA;;;cCErC,gBAAA,EAA2C,KAAA,CAA3B,QAAA;AAAA,iBAEb,WAAA,oBAA+B,MAAA,kBAAA,CAAA,GAA4B,CAAA;AAAA,iBAO3D,aAAA,CAAA,GAAiB,MAAA;;;;;;;;AFXjC;;;iBGMgB,iBAAA,CACd,GAAA,EAAK,MAAA,mBACL,MAAA,YACC,MAAA;;;KCRS,kBAAA;AAAA,UAEK,yBAAA;EACf,IAAA,EAAM,CAAA;EACN,KAAA,EAAO,eAAA;EACP,MAAA,EAAQ,kBAAA;AAAA;AAAA,iBAGM,mBAAA,GAAA,CACd,OAAA,UACA,SAAA,UACA,KAAA,YACC,yBAAA,CAA0B,CAAA;;;cCThB,oBAAA,EAAmD,KAAA,CAA/B,QAAA,EAAA,GAAA;AAAA,iBAEjB,eAAA,CAAA,IAAoB,GAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/define-routes.ts","../src/use-seam-data.ts","../src/sentinel.ts","../src/use-seam-subscription.ts","../src/use-seam-navigate.ts"],"mappings":";;;;;UAIiB,YAAA;EACf,IAAA;EACA,IAAA;AAAA;AAAA,UAGe,SAAA;EACf,SAAA;EACA,MAAA,GAAS,MAAA,SAAe,YAAA;AAAA;AAAA,UAGT,QAAA;EACf,IAAA;EACA,SAAA,GAAY,aAAA,CAAc,MAAA;EAC1B,MAAA,GAAS,aAAA;IAAgB,QAAA,EAAU,SAAA;EAAA;EACnC,QAAA,GAAW,QAAA;EACX,OAAA,GAAU,MAAA,SAAe,SAAA;EACzB,IAAA,GAAO,MAAA;EACP,QAAA;EACA,SAAA;AAAA;;;iBClBc,YAAA,CAAa,MAAA,EAAQ,QAAA,KAAa,QAAA;;;cCErC,gBAAA,EAA2C,KAAA,CAA3B,QAAA;AAAA,iBAEb,WAAA,oBAA+B,MAAA,kBAAA,CAAA,GAA4B,CAAA;AAAA,iBAO3D,aAAA,CAAA,GAAiB,MAAA;;;;;;;;AFXjC;;;iBGMgB,iBAAA,CACd,GAAA,EAAK,MAAA,mBACL,MAAA,WACA,SAAA,GAAY,GAAA,WACX,MAAA;;;KCTS,kBAAA;AAAA,UAEK,yBAAA;EACf,IAAA,EAAM,CAAA;EACN,KAAA,EAAO,eAAA;EACP,MAAA,EAAQ,kBAAA;AAAA;AAAA,iBAGM,mBAAA,GAAA,CACd,OAAA,UACA,SAAA,UACA,KAAA,YACC,yBAAA,CAA0B,CAAA;;;cCThB,oBAAA,EAAmD,KAAA,CAA/B,QAAA,EAAA,GAAA;AAAA,iBAEjB,eAAA,CAAA,IAAoB,GAAA"}

package/dist/index.js

@@ -31,13 +31,13 @@ function parseSeamData() {
 * sentinel array where each leaf in the object template uses `$.` path prefix.
 * Arrays of primitives, empty arrays, and null remain leaf sentinels.
 */
-function buildSentinelData(obj, prefix = "") {
+function buildSentinelData(obj, prefix = "", htmlPaths) {
 	const result = {};
 	for (const [key, value] of Object.entries(obj)) {
 		const path = prefix ? `${prefix}.${key}` : key;
-		if (value !== null && typeof value === "object" && !Array.isArray(value)) result[key] = buildSentinelData(value, path);
-		else if (Array.isArray(value) && value.length > 0 && typeof value[0] === "object" && value[0] !== null) result[key] = [buildSentinelData(value[0], `${path}.$`)];
-		else result[key] = `%%SEAM:${path}%%`;
+		if (value !== null && typeof value === "object" && !Array.isArray(value)) result[key] = buildSentinelData(value, path, htmlPaths);
+		else if (Array.isArray(value) && value.length > 0 && typeof value[0] === "object" && value[0] !== null) result[key] = [buildSentinelData(value[0], `${path}.$`, htmlPaths)];
+		else result[key] = `%%SEAM:${path}${htmlPaths?.has(path) ? ":html" : ""}%%`;
 	}
 	return result;
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/define-routes.ts","../src/use-seam-data.ts","../src/sentinel.ts","../src/use-seam-subscription.ts","../src/use-seam-navigate.ts"],"sourcesContent":["/* packages/client/react/src/define-routes.ts */\n\nimport type { RouteDef } from \"./types.js\";\n\nexport function defineRoutes(routes: RouteDef[]): RouteDef[] {\n  return routes;\n}\n","/* packages/client/react/src/use-seam-data.ts */\n\nimport { createContext, useContext } from \"react\";\n\nconst SeamDataContext = createContext<unknown>(null);\n\nexport const SeamDataProvider = SeamDataContext.Provider;\n\nexport function useSeamData<T extends object = Record<string, unknown>>(): T {\n  const value = useContext(SeamDataContext);\n  if (value === null || value === undefined)\n    throw new Error(\"useSeamData must be used inside <SeamDataProvider>\");\n  return value as T;\n}\n\nexport function parseSeamData(): Record<string, unknown> {\n  const el = document.getElementById(\"__SEAM_DATA__\");\n  if (!el?.textContent) throw new Error(\"__SEAM_DATA__ not found\");\n  return JSON.parse(el.textContent) as Record<string, unknown>;\n}\n","/* packages/client/react/src/sentinel.ts */\n\n/**\n * Replace every leaf value in `obj` with a sentinel string `%%SEAM:dotted.path%%`.\n * Nested objects are recursed; primitives and null become leaf sentinels.\n *\n * Arrays of objects (length > 0, first element is object) produce a 1-element\n * sentinel array where each leaf in the object template uses `$.` path prefix.\n * Arrays of primitives, empty arrays, and null remain leaf sentinels.\n */\nexport function buildSentinelData(\n  obj: Record<string, unknown>,\n  prefix = \"\",\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(obj)) {\n    const path = prefix ? `${prefix}.${key}` : key;\n    if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n      result[key] = buildSentinelData(value as Record<string, unknown>, path);\n    } else if (\n      Array.isArray(value) &&\n      value.length > 0 &&\n      typeof value[0] === \"object\" &&\n      value[0] !== null\n    ) {\n      // Array of objects: produce 1-element sentinel array with $.field paths\n      result[key] = [buildSentinelData(value[0] as Record<string, unknown>, `${path}.$`)];\n    } else {\n      result[key] = `%%SEAM:${path}%%`;\n    }\n  }\n  return result;\n}\n","/* packages/client/react/src/use-seam-subscription.ts */\n\nimport { useEffect, useRef, useState } from \"react\";\nimport { SeamClientError } from \"@canmi/seam-client\";\n\nexport type SubscriptionStatus = \"connecting\" | \"active\" | \"error\" | \"closed\";\n\nexport interface UseSeamSubscriptionResult<T> {\n  data: T | null;\n  error: SeamClientError | null;\n  status: SubscriptionStatus;\n}\n\nexport function useSeamSubscription<T>(\n  baseUrl: string,\n  procedure: string,\n  input: unknown,\n): UseSeamSubscriptionResult<T> {\n  const [data, setData] = useState<T | null>(null);\n  const [error, setError] = useState<SeamClientError | null>(null);\n  const [status, setStatus] = useState<SubscriptionStatus>(\"connecting\");\n\n  // Serialize input for stable dependency\n  const inputKey = JSON.stringify(input);\n  const inputRef = useRef(inputKey);\n  inputRef.current = inputKey;\n\n  useEffect(() => {\n    setData(null);\n    setError(null);\n    setStatus(\"connecting\");\n\n    const cleanBase = baseUrl.replace(/\\/+$/, \"\");\n    const params = new URLSearchParams({ input: inputKey });\n    const url = `${cleanBase}/_seam/subscribe/${procedure}?${params.toString()}`;\n    const es = new EventSource(url);\n\n    es.addEventListener(\"data\", (e) => {\n      try {\n        setData(JSON.parse(e.data as string) as T);\n        setStatus(\"active\");\n      } catch {\n        setError(new SeamClientError(\"INTERNAL_ERROR\", \"Failed to parse SSE data\", 0));\n        setStatus(\"error\");\n        es.close();\n      }\n    });\n\n    es.addEventListener(\"error\", (e) => {\n      if (e instanceof MessageEvent) {\n        try {\n          const payload = JSON.parse(e.data as string) as { code?: string; message?: string };\n          setError(\n            new SeamClientError(\n              \"INTERNAL_ERROR\",\n              typeof payload.message === \"string\" ? payload.message : \"SSE error\",\n              0,\n            ),\n          );\n        } catch {\n          setError(new SeamClientError(\"INTERNAL_ERROR\", \"SSE error\", 0));\n        }\n      } else {\n        setError(new SeamClientError(\"INTERNAL_ERROR\", \"SSE connection error\", 0));\n      }\n      setStatus(\"error\");\n      es.close();\n    });\n\n    es.addEventListener(\"complete\", () => {\n      setStatus(\"closed\");\n      es.close();\n    });\n\n    return () => {\n      es.close();\n    };\n  }, [baseUrl, procedure, inputKey]);\n\n  return { data, error, status };\n}\n","/* packages/client/react/src/use-seam-navigate.ts */\n\nimport { createContext, useContext } from \"react\";\n\nconst SeamNavigateContext = createContext<(url: string) => void>((url) => {\n  globalThis.location.href = url;\n});\n\nexport const SeamNavigateProvider = SeamNavigateContext.Provider;\n\nexport function useSeamNavigate(): (url: string) => void {\n  return useContext(SeamNavigateContext);\n}\n"],"mappings":";;;;AAIA,SAAgB,aAAa,QAAgC;AAC3D,QAAO;;;;;ACDT,MAAM,kBAAkB,cAAuB,KAAK;AAEpD,MAAa,mBAAmB,gBAAgB;AAEhD,SAAgB,cAA6D;CAC3E,MAAM,QAAQ,WAAW,gBAAgB;AACzC,KAAI,UAAU,QAAQ,UAAU,OAC9B,OAAM,IAAI,MAAM,qDAAqD;AACvE,QAAO;;AAGT,SAAgB,gBAAyC;CACvD,MAAM,KAAK,SAAS,eAAe,gBAAgB;AACnD,KAAI,CAAC,IAAI,YAAa,OAAM,IAAI,MAAM,0BAA0B;AAChE,QAAO,KAAK,MAAM,GAAG,YAAY;;;;;;;;;;;;;ACRnC,SAAgB,kBACd,KACA,SAAS,IACgB;CACzB,MAAM,SAAkC,EAAE;AAC1C,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,EAAE;EAC9C,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,QAAQ;AAC3C,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,CACtE,QAAO,OAAO,kBAAkB,OAAkC,KAAK;WAEvE,MAAM,QAAQ,MAAM,IACpB,MAAM,SAAS,KACf,OAAO,MAAM,OAAO,YACpB,MAAM,OAAO,KAGb,QAAO,OAAO,CAAC,kBAAkB,MAAM,IAA+B,GAAG,KAAK,IAAI,CAAC;MAEnF,QAAO,OAAO,UAAU,KAAK;;AAGjC,QAAO;;;;;AClBT,SAAgB,oBACd,SACA,WACA,OAC8B;CAC9B,MAAM,CAAC,MAAM,WAAW,SAAmB,KAAK;CAChD,MAAM,CAAC,OAAO,YAAY,SAAiC,KAAK;CAChE,MAAM,CAAC,QAAQ,aAAa,SAA6B,aAAa;CAGtE,MAAM,WAAW,KAAK,UAAU,MAAM;CACtC,MAAM,WAAW,OAAO,SAAS;AACjC,UAAS,UAAU;AAEnB,iBAAgB;AACd,UAAQ,KAAK;AACb,WAAS,KAAK;AACd,YAAU,aAAa;EAIvB,MAAM,MAAM,GAFM,QAAQ,QAAQ,QAAQ,GAAG,CAEpB,mBAAmB,UAAU,GADvC,IAAI,gBAAgB,EAAE,OAAO,UAAU,CAAC,CACS,UAAU;EAC1E,MAAM,KAAK,IAAI,YAAY,IAAI;AAE/B,KAAG,iBAAiB,SAAS,MAAM;AACjC,OAAI;AACF,YAAQ,KAAK,MAAM,EAAE,KAAe,CAAM;AAC1C,cAAU,SAAS;WACb;AACN,aAAS,IAAI,gBAAgB,kBAAkB,4BAA4B,EAAE,CAAC;AAC9E,cAAU,QAAQ;AAClB,OAAG,OAAO;;IAEZ;AAEF,KAAG,iBAAiB,UAAU,MAAM;AAClC,OAAI,aAAa,aACf,KAAI;IACF,MAAM,UAAU,KAAK,MAAM,EAAE,KAAe;AAC5C,aACE,IAAI,gBACF,kBACA,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,aACxD,EACD,CACF;WACK;AACN,aAAS,IAAI,gBAAgB,kBAAkB,aAAa,EAAE,CAAC;;OAGjE,UAAS,IAAI,gBAAgB,kBAAkB,wBAAwB,EAAE,CAAC;AAE5E,aAAU,QAAQ;AAClB,MAAG,OAAO;IACV;AAEF,KAAG,iBAAiB,kBAAkB;AACpC,aAAU,SAAS;AACnB,MAAG,OAAO;IACV;AAEF,eAAa;AACX,MAAG,OAAO;;IAEX;EAAC;EAAS;EAAW;EAAS,CAAC;AAElC,QAAO;EAAE;EAAM;EAAO;EAAQ;;;;;AC3EhC,MAAM,sBAAsB,eAAsC,QAAQ;AACxE,YAAW,SAAS,OAAO;EAC3B;AAEF,MAAa,uBAAuB,oBAAoB;AAExD,SAAgB,kBAAyC;AACvD,QAAO,WAAW,oBAAoB"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/define-routes.ts","../src/use-seam-data.ts","../src/sentinel.ts","../src/use-seam-subscription.ts","../src/use-seam-navigate.ts"],"sourcesContent":["/* packages/client/react/src/define-routes.ts */\n\nimport type { RouteDef } from \"./types.js\";\n\nexport function defineRoutes(routes: RouteDef[]): RouteDef[] {\n  return routes;\n}\n","/* packages/client/react/src/use-seam-data.ts */\n\nimport { createContext, useContext } from \"react\";\n\nconst SeamDataContext = createContext<unknown>(null);\n\nexport const SeamDataProvider = SeamDataContext.Provider;\n\nexport function useSeamData<T extends object = Record<string, unknown>>(): T {\n  const value = useContext(SeamDataContext);\n  if (value === null || value === undefined)\n    throw new Error(\"useSeamData must be used inside <SeamDataProvider>\");\n  return value as T;\n}\n\nexport function parseSeamData(): Record<string, unknown> {\n  const el = document.getElementById(\"__SEAM_DATA__\");\n  if (!el?.textContent) throw new Error(\"__SEAM_DATA__ not found\");\n  return JSON.parse(el.textContent) as Record<string, unknown>;\n}\n","/* packages/client/react/src/sentinel.ts */\n\n/**\n * Replace every leaf value in `obj` with a sentinel string `%%SEAM:dotted.path%%`.\n * Nested objects are recursed; primitives and null become leaf sentinels.\n *\n * Arrays of objects (length > 0, first element is object) produce a 1-element\n * sentinel array where each leaf in the object template uses `$.` path prefix.\n * Arrays of primitives, empty arrays, and null remain leaf sentinels.\n */\nexport function buildSentinelData(\n  obj: Record<string, unknown>,\n  prefix = \"\",\n  htmlPaths?: Set<string>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(obj)) {\n    const path = prefix ? `${prefix}.${key}` : key;\n    if (value !== null && typeof value === \"object\" && !Array.isArray(value)) {\n      result[key] = buildSentinelData(value as Record<string, unknown>, path, htmlPaths);\n    } else if (\n      Array.isArray(value) &&\n      value.length > 0 &&\n      typeof value[0] === \"object\" &&\n      value[0] !== null\n    ) {\n      // Array of objects: produce 1-element sentinel array with $.field paths\n      result[key] = [\n        buildSentinelData(value[0] as Record<string, unknown>, `${path}.$`, htmlPaths),\n      ];\n    } else {\n      const suffix = htmlPaths?.has(path) ? \":html\" : \"\";\n      result[key] = `%%SEAM:${path}${suffix}%%`;\n    }\n  }\n  return result;\n}\n","/* packages/client/react/src/use-seam-subscription.ts */\n\nimport { useEffect, useRef, useState } from \"react\";\nimport { SeamClientError } from \"@canmi/seam-client\";\n\nexport type SubscriptionStatus = \"connecting\" | \"active\" | \"error\" | \"closed\";\n\nexport interface UseSeamSubscriptionResult<T> {\n  data: T | null;\n  error: SeamClientError | null;\n  status: SubscriptionStatus;\n}\n\nexport function useSeamSubscription<T>(\n  baseUrl: string,\n  procedure: string,\n  input: unknown,\n): UseSeamSubscriptionResult<T> {\n  const [data, setData] = useState<T | null>(null);\n  const [error, setError] = useState<SeamClientError | null>(null);\n  const [status, setStatus] = useState<SubscriptionStatus>(\"connecting\");\n\n  // Serialize input for stable dependency\n  const inputKey = JSON.stringify(input);\n  const inputRef = useRef(inputKey);\n  inputRef.current = inputKey;\n\n  useEffect(() => {\n    setData(null);\n    setError(null);\n    setStatus(\"connecting\");\n\n    const cleanBase = baseUrl.replace(/\\/+$/, \"\");\n    const params = new URLSearchParams({ input: inputKey });\n    const url = `${cleanBase}/_seam/subscribe/${procedure}?${params.toString()}`;\n    const es = new EventSource(url);\n\n    es.addEventListener(\"data\", (e) => {\n      try {\n        setData(JSON.parse(e.data as string) as T);\n        setStatus(\"active\");\n      } catch {\n        setError(new SeamClientError(\"INTERNAL_ERROR\", \"Failed to parse SSE data\", 0));\n        setStatus(\"error\");\n        es.close();\n      }\n    });\n\n    es.addEventListener(\"error\", (e) => {\n      if (e instanceof MessageEvent) {\n        try {\n          const payload = JSON.parse(e.data as string) as { code?: string; message?: string };\n          setError(\n            new SeamClientError(\n              \"INTERNAL_ERROR\",\n              typeof payload.message === \"string\" ? payload.message : \"SSE error\",\n              0,\n            ),\n          );\n        } catch {\n          setError(new SeamClientError(\"INTERNAL_ERROR\", \"SSE error\", 0));\n        }\n      } else {\n        setError(new SeamClientError(\"INTERNAL_ERROR\", \"SSE connection error\", 0));\n      }\n      setStatus(\"error\");\n      es.close();\n    });\n\n    es.addEventListener(\"complete\", () => {\n      setStatus(\"closed\");\n      es.close();\n    });\n\n    return () => {\n      es.close();\n    };\n  }, [baseUrl, procedure, inputKey]);\n\n  return { data, error, status };\n}\n","/* packages/client/react/src/use-seam-navigate.ts */\n\nimport { createContext, useContext } from \"react\";\n\nconst SeamNavigateContext = createContext<(url: string) => void>((url) => {\n  globalThis.location.href = url;\n});\n\nexport const SeamNavigateProvider = SeamNavigateContext.Provider;\n\nexport function useSeamNavigate(): (url: string) => void {\n  return useContext(SeamNavigateContext);\n}\n"],"mappings":";;;;AAIA,SAAgB,aAAa,QAAgC;AAC3D,QAAO;;;;;ACDT,MAAM,kBAAkB,cAAuB,KAAK;AAEpD,MAAa,mBAAmB,gBAAgB;AAEhD,SAAgB,cAA6D;CAC3E,MAAM,QAAQ,WAAW,gBAAgB;AACzC,KAAI,UAAU,QAAQ,UAAU,OAC9B,OAAM,IAAI,MAAM,qDAAqD;AACvE,QAAO;;AAGT,SAAgB,gBAAyC;CACvD,MAAM,KAAK,SAAS,eAAe,gBAAgB;AACnD,KAAI,CAAC,IAAI,YAAa,OAAM,IAAI,MAAM,0BAA0B;AAChE,QAAO,KAAK,MAAM,GAAG,YAAY;;;;;;;;;;;;;ACRnC,SAAgB,kBACd,KACA,SAAS,IACT,WACyB;CACzB,MAAM,SAAkC,EAAE;AAC1C,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,EAAE;EAC9C,MAAM,OAAO,SAAS,GAAG,OAAO,GAAG,QAAQ;AAC3C,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM,CACtE,QAAO,OAAO,kBAAkB,OAAkC,MAAM,UAAU;WAElF,MAAM,QAAQ,MAAM,IACpB,MAAM,SAAS,KACf,OAAO,MAAM,OAAO,YACpB,MAAM,OAAO,KAGb,QAAO,OAAO,CACZ,kBAAkB,MAAM,IAA+B,GAAG,KAAK,KAAK,UAAU,CAC/E;MAGD,QAAO,OAAO,UAAU,OADT,WAAW,IAAI,KAAK,GAAG,UAAU,GACV;;AAG1C,QAAO;;;;;ACtBT,SAAgB,oBACd,SACA,WACA,OAC8B;CAC9B,MAAM,CAAC,MAAM,WAAW,SAAmB,KAAK;CAChD,MAAM,CAAC,OAAO,YAAY,SAAiC,KAAK;CAChE,MAAM,CAAC,QAAQ,aAAa,SAA6B,aAAa;CAGtE,MAAM,WAAW,KAAK,UAAU,MAAM;CACtC,MAAM,WAAW,OAAO,SAAS;AACjC,UAAS,UAAU;AAEnB,iBAAgB;AACd,UAAQ,KAAK;AACb,WAAS,KAAK;AACd,YAAU,aAAa;EAIvB,MAAM,MAAM,GAFM,QAAQ,QAAQ,QAAQ,GAAG,CAEpB,mBAAmB,UAAU,GADvC,IAAI,gBAAgB,EAAE,OAAO,UAAU,CAAC,CACS,UAAU;EAC1E,MAAM,KAAK,IAAI,YAAY,IAAI;AAE/B,KAAG,iBAAiB,SAAS,MAAM;AACjC,OAAI;AACF,YAAQ,KAAK,MAAM,EAAE,KAAe,CAAM;AAC1C,cAAU,SAAS;WACb;AACN,aAAS,IAAI,gBAAgB,kBAAkB,4BAA4B,EAAE,CAAC;AAC9E,cAAU,QAAQ;AAClB,OAAG,OAAO;;IAEZ;AAEF,KAAG,iBAAiB,UAAU,MAAM;AAClC,OAAI,aAAa,aACf,KAAI;IACF,MAAM,UAAU,KAAK,MAAM,EAAE,KAAe;AAC5C,aACE,IAAI,gBACF,kBACA,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,aACxD,EACD,CACF;WACK;AACN,aAAS,IAAI,gBAAgB,kBAAkB,aAAa,EAAE,CAAC;;OAGjE,UAAS,IAAI,gBAAgB,kBAAkB,wBAAwB,EAAE,CAAC;AAE5E,aAAU,QAAQ;AAClB,MAAG,OAAO;IACV;AAEF,KAAG,iBAAiB,kBAAkB;AACpC,aAAU,SAAS;AACnB,MAAG,OAAO;IACV;AAEF,eAAa;AACX,MAAG,OAAO;;IAEX;EAAC;EAAS;EAAW;EAAS,CAAC;AAElC,QAAO;EAAE;EAAM;EAAO;EAAQ;;;;;AC3EhC,MAAM,sBAAsB,eAAsC,QAAQ;AACxE,YAAW,SAAS,OAAO;EAC3B;AAEF,MAAa,uBAAuB,oBAAoB;AAExD,SAAgB,kBAAyC;AACvD,QAAO,WAAW,oBAAoB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canmi/seam-react",
-  "version": "0.2.3",
+  "version": "0.2.14",
   "files": [
     "dist",
     "scripts"

package/scripts/build-skeletons.mjs

@@ -3,7 +3,8 @@
 import { build } from "esbuild";
 import { createElement } from "react";
 import { renderToString } from "react-dom/server";
-import { readFileSync, unlinkSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { SeamDataProvider, buildSentinelData } from "@canmi/seam-react";
@@ -12,7 +13,14 @@ import {
   cartesianProduct,
   buildVariantSentinel,
 } from "./variant-generator.mjs";
-import { generateMockFromSchema, flattenLoaderMock, deepMerge } from "./mock-generator.mjs";
+import {
+  generateMockFromSchema,
+  flattenLoaderMock,
+  deepMerge,
+  collectHtmlPaths,
+  createAccessTracker,
+  checkFieldAccess,
+} from "./mock-generator.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -32,6 +40,7 @@ class SeamBuildError extends Error {
 }
 
 const buildWarnings = [];
+const seenWarnings = new Set();
 
 // Matches React-injected resource hint <link> tags.
 // Only rel values used by React's resource APIs are targeted (preload, dns-prefetch, preconnect,
@@ -121,6 +130,15 @@ function guardedRender(routePath, component, data) {
   let html;
   try {
     html = renderWithData(component, data);
+  } catch (e) {
+    if (e instanceof SeamBuildError) {
+      throw new SeamBuildError(
+        `[seam] error: Skeleton rendering failed for route "${routePath}":\n` +
+          `       ${e.message}\n\n` +
+          "       Move browser API calls into useEffect() or event handlers.",
+      );
+    }
+    throw e;
   } finally {
     for (const teardown of teardowns) teardown();
   }
@@ -133,9 +151,13 @@ function guardedRender(routePath, component, data) {
     throw new SeamBuildError(msg);
   }
 
-  // After fatal check, only warnings remain
+  // After fatal check, only warnings remain — dedup per message
   for (const v of violations) {
-    buildWarnings.push(`[seam] warning: ${routePath}\n  ${v.reason}`);
+    const msg = `[seam] warning: ${routePath}\n  ${v.reason}`;
+    if (!seenWarnings.has(msg)) {
+      seenWarnings.add(msg);
+      buildWarnings.push(msg);
+    }
   }
   if (violations.length > 0) {
     html = stripResourceHints(html);
@@ -200,8 +222,9 @@ function resolveRouteMock(route, manifest) {
 
 function renderRoute(route, manifest) {
   const mock = resolveRouteMock(route, manifest);
-  const baseSentinel = buildSentinelData(mock);
   const pageSchema = buildPageSchema(route, manifest);
+  const htmlPaths = pageSchema ? collectHtmlPaths(pageSchema) : new Set();
+  const baseSentinel = buildSentinelData(mock, "", htmlPaths);
   const axes = pageSchema ? collectStructuralAxes(pageSchema, mock) : [];
   const combos = cartesianProduct(axes);
 
@@ -211,8 +234,20 @@ function renderRoute(route, manifest) {
     return { variant, html };
   });
 
-  // Render with real mock data for CTR equivalence check
-  const mockHtml = stripResourceHints(guardedRender(route.path, route.component, mock));
+  // Render with real mock data for CTR equivalence check.
+  // Wrap mock with Proxy to track field accesses and detect schema mismatches.
+  const accessed = new Set();
+  const trackedMock = createAccessTracker(mock, accessed);
+  const mockHtml = stripResourceHints(guardedRender(route.path, route.component, trackedMock));
+
+  const fieldWarnings = checkFieldAccess(accessed, pageSchema, route.path);
+  for (const w of fieldWarnings) {
+    const msg = `[seam] warning: ${w}`;
+    if (!seenWarnings.has(msg)) {
+      seenWarnings.add(msg);
+      buildWarnings.push(msg);
+    }
+  }
 
   return {
     path: route.path,
@@ -276,11 +311,30 @@ function resolveLayoutMock(entry, manifest) {
 /** Render layout with seam-outlet placeholder, optionally with sentinel data */
 function renderLayout(LayoutComponent, id, entry, manifest) {
   const mock = resolveLayoutMock(entry, manifest);
-  const data = Object.keys(mock).length > 0 ? buildSentinelData(mock) : {};
+  const schema =
+    Object.keys(entry.loaders || {}).length > 0 ? buildPageSchema(entry, manifest) : null;
+  const htmlPaths = schema ? collectHtmlPaths(schema) : new Set();
+  const data = Object.keys(mock).length > 0 ? buildSentinelData(mock, "", htmlPaths) : {};
+
+  // Wrap data with Proxy to detect schema/component field mismatches
+  const accessed = new Set();
+  const trackedData = Object.keys(data).length > 0 ? createAccessTracker(data, accessed) : data;
+
   function LayoutWithOutlet() {
     return createElement(LayoutComponent, null, createElement("seam-outlet", null));
   }
-  return guardedRender(`layout:${id}`, LayoutWithOutlet, data);
+  const html = guardedRender(`layout:${id}`, LayoutWithOutlet, trackedData);
+
+  const fieldWarnings = checkFieldAccess(accessed, schema, `layout:${id}`);
+  for (const w of fieldWarnings) {
+    const msg = `[seam] warning: ${w}`;
+    if (!seenWarnings.has(msg)) {
+      seenWarnings.add(msg);
+      buildWarnings.push(msg);
+    }
+  }
+
+  return html;
 }
 
 /** Flatten routes, annotating each leaf with its parent layout id */
@@ -299,6 +353,157 @@ function flattenRoutes(routes, currentLayout) {
   return leaves;
 }
 
+// -- Cache helpers --
+
+/** Parse import statements to map local names to specifiers */
+function parseComponentImports(source) {
+  const map = new Map();
+  const re = /import\s+(?:(\w+)\s*,?\s*)?(?:\{([^}]*)\}\s*)?from\s+['"]([^'"]+)['"]/g;
+  let m;
+  while ((m = re.exec(source)) !== null) {
+    const [, defaultName, namedPart, specifier] = m;
+    if (defaultName) map.set(defaultName, specifier);
+    if (namedPart) {
+      for (const part of namedPart.split(",")) {
+        const t = part.trim();
+        if (!t) continue;
+        const asMatch = t.match(/^(\w+)\s+as\s+(\w+)$/);
+        if (asMatch) {
+          map.set(asMatch[2], specifier);
+          map.set(asMatch[1], specifier);
+        } else {
+          map.set(t, specifier);
+        }
+      }
+    }
+  }
+  return map;
+}
+
+/** Bundle each component via esbuild (write: false) and SHA-256 hash the output */
+async function computeComponentHashes(names, importMap, routesDir) {
+  const hashes = new Map();
+  const seen = new Set();
+  const tasks = [];
+  for (const name of names) {
+    const specifier = importMap.get(name);
+    if (!specifier || seen.has(specifier)) continue;
+    seen.add(specifier);
+    tasks.push(
+      build({
+        stdin: { contents: `import '${specifier}'`, resolveDir: routesDir, loader: "js" },
+        bundle: true,
+        write: false,
+        format: "esm",
+        platform: "node",
+        treeShaking: false,
+        external: ["react", "react-dom", "@canmi/seam-react"],
+        logLevel: "silent",
+      })
+        .then((result) => {
+          const content = result.outputFiles[0]?.text || "";
+          const hash = createHash("sha256").update(content).digest("hex");
+          for (const [n, s] of importMap) {
+            if (s === specifier) hashes.set(n, hash);
+          }
+        })
+        .catch(() => {}),
+    );
+  }
+  await Promise.all(tasks);
+  return hashes;
+}
+
+function computeScriptHash() {
+  const files = ["build-skeletons.mjs", "variant-generator.mjs", "mock-generator.mjs"];
+  const h = createHash("sha256");
+  for (const f of files) h.update(readFileSync(join(__dirname, f), "utf-8"));
+  return h.digest("hex");
+}
+
+function pathToSlug(path) {
+  const t = path
+    .replace(/^\/|\/$/g, "")
+    .replace(/\//g, "-")
+    .replace(/:/g, "");
+  return t || "index";
+}
+
+function readCache(cacheDir, slug) {
+  try {
+    return JSON.parse(readFileSync(join(cacheDir, `${slug}.json`), "utf-8"));
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(cacheDir, slug, key, data) {
+  writeFileSync(join(cacheDir, `${slug}.json`), JSON.stringify({ key, data }));
+}
+
+function computeCacheKey(componentHash, manifestContent, config, scriptHash) {
+  const h = createHash("sha256");
+  h.update(componentHash);
+  h.update(manifestContent);
+  h.update(JSON.stringify(config));
+  h.update(scriptHash);
+  return h.digest("hex").slice(0, 16);
+}
+
+function processLayoutsWithCache(layoutMap, ctx) {
+  return [...layoutMap.entries()].map(([id, entry]) => {
+    const compHash = ctx.componentHashes.get(entry.component?.name);
+    if (compHash) {
+      const config = { id, loaders: entry.loaders, mock: entry.mock };
+      const key = computeCacheKey(compHash, ctx.manifestContent, config, ctx.scriptHash);
+      const slug = `layout_${id}`;
+      const cached = readCache(ctx.cacheDir, slug);
+      if (cached && cached.key === key) {
+        ctx.stats.hits++;
+        return cached.data;
+      }
+      const data = {
+        id,
+        html: renderLayout(entry.component, id, entry, ctx.manifest),
+        loaders: entry.loaders,
+        parent: entry.parentId,
+      };
+      writeCache(ctx.cacheDir, slug, key, data);
+      ctx.stats.misses++;
+      return data;
+    }
+    ctx.stats.misses++;
+    return {
+      id,
+      html: renderLayout(entry.component, id, entry, ctx.manifest),
+      loaders: entry.loaders,
+      parent: entry.parentId,
+    };
+  });
+}
+
+function processRoutesWithCache(flat, ctx) {
+  return flat.map((r) => {
+    const compHash = ctx.componentHashes.get(r.component?.name);
+    if (compHash) {
+      const config = { path: r.path, loaders: r.loaders, mock: r.mock, nullable: r.nullable };
+      const key = computeCacheKey(compHash, ctx.manifestContent, config, ctx.scriptHash);
+      const slug = `route_${pathToSlug(r.path)}`;
+      const cached = readCache(ctx.cacheDir, slug);
+      if (cached && cached.key === key) {
+        ctx.stats.hits++;
+        return cached.data;
+      }
+      const data = renderRoute(r, ctx.manifest);
+      writeCache(ctx.cacheDir, slug, key, data);
+      ctx.stats.misses++;
+      return data;
+    }
+    ctx.stats.misses++;
+    return renderRoute(r, ctx.manifest);
+  });
+}
+
 // -- Main --
 
 async function main() {
@@ -312,17 +517,24 @@ async function main() {
 
   // Load manifest if provided
   let manifest = null;
+  let manifestContent = "";
   if (manifestFile && manifestFile !== "none") {
     try {
-      manifest = JSON.parse(readFileSync(resolve(manifestFile), "utf-8"));
+      manifestContent = readFileSync(resolve(manifestFile), "utf-8");
+      manifest = JSON.parse(manifestContent);
     } catch (e) {
       console.error(`warning: could not read manifest: ${e.message}`);
     }
   }
 
   const absRoutes = resolve(routesFile);
+  const routesDir = dirname(absRoutes);
   const outfile = join(__dirname, ".tmp-routes-bundle.mjs");
 
+  // Parse imports from source (before bundle) for component hash resolution
+  const routesSource = readFileSync(absRoutes, "utf-8");
+  const importMap = parseComponentImports(routesSource);
+
   await build({
     entryPoints: [absRoutes],
     bundle: true,
@@ -340,17 +552,43 @@ async function main() {
     }
 
     const layoutMap = extractLayouts(routes);
-    const layouts = [...layoutMap.entries()].map(([id, entry]) => ({
-      id,
-      html: renderLayout(entry.component, id, entry, manifest),
-      loaders: entry.loaders,
-      parent: entry.parentId,
-    }));
     const flat = flattenRoutes(routes);
+
+    // Collect all unique component names for hashing
+    const componentNames = new Set();
+    for (const [, entry] of layoutMap) {
+      if (entry.component?.name) componentNames.add(entry.component.name);
+    }
+    for (const route of flat) {
+      if (route.component?.name) componentNames.add(route.component.name);
+    }
+
+    const [componentHashes, scriptHash] = await Promise.all([
+      computeComponentHashes([...componentNames], importMap, routesDir),
+      Promise.resolve(computeScriptHash()),
+    ]);
+
+    // Set up cache directory
+    const cacheDir = join(process.cwd(), ".seam", "cache", "skeletons");
+    mkdirSync(cacheDir, { recursive: true });
+
+    const ctx = {
+      componentHashes,
+      scriptHash,
+      manifestContent,
+      manifest,
+      cacheDir,
+      stats: { hits: 0, misses: 0 },
+    };
+
+    const layouts = processLayoutsWithCache(layoutMap, ctx);
+    const renderedRoutes = processRoutesWithCache(flat, ctx);
+
     const output = {
       layouts,
-      routes: flat.map((r) => renderRoute(r, manifest)),
+      routes: renderedRoutes,
       warnings: buildWarnings,
+      cacheStats: ctx.stats,
     };
     process.stdout.write(JSON.stringify(output));
   } finally {

package/scripts/mock-generator.mjs

@@ -41,6 +41,11 @@ export function generateMockFromSchema(schema, fieldPath = "") {
     return generateMockFromSchema(inner, fieldPath);
   }
 
+  // HTML format: return sample HTML content instead of plain text
+  if (schema.type === "string" && schema.metadata?.format === "html") {
+    return "<p>Sample HTML content</p>";
+  }
+
   // Primitive type forms
   if (schema.type) {
     switch (schema.type) {
@@ -163,3 +168,307 @@ export function deepMerge(base, override) {
   }
   return result;
 }
+
+/**
+ * Recursively walk a JTD schema collecting dot-separated paths
+ * where metadata.format === "html".
+ * Returns a Set including both full paths and flattened paths
+ * (first segment stripped) to match flattenLoaderMock behavior.
+ * @param {object} schema - page-level JTD schema
+ * @returns {Set<string>}
+ */
+/**
+ * Walk JTD schema collecting all valid dot-separated field paths.
+ * Returns a Set including both keyed paths and flattened paths
+ * (first segment stripped) to match flattenLoaderMock behavior.
+ * @param {object} schema - page-level JTD schema
+ * @returns {Set<string>}
+ */
+export function collectSchemaPaths(schema) {
+  const paths = new Set();
+
+  function walk(node, prefix) {
+    if (!node || typeof node !== "object") return;
+
+    if (node.nullable) {
+      const inner = { ...node };
+      delete inner.nullable;
+      walk(inner, prefix);
+      return;
+    }
+
+    if (node.properties || node.optionalProperties) {
+      for (const [key, sub] of Object.entries({
+        ...node.properties,
+        ...node.optionalProperties,
+      })) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        paths.add(path);
+        walk(sub, path);
+      }
+      return;
+    }
+
+    if (node.elements) {
+      walk(node.elements, prefix ? `${prefix}.$` : "$");
+      return;
+    }
+  }
+
+  walk(schema, "");
+
+  // Add flattened paths (strip first segment) to match flattenLoaderMock.
+  // Snapshot before iterating because we mutate paths in the loop body.
+  const snapshot = Array.from(paths);
+  for (const p of snapshot) {
+    const dot = p.indexOf(".");
+    if (dot !== -1) paths.add(p.slice(dot + 1));
+  }
+  return paths;
+}
+
+/**
+ * Standard Levenshtein distance between two strings.
+ * @param {string} a
+ * @param {string} b
+ * @returns {number}
+ */
+export function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from({ length: m + 1 }, () => Array.from({ length: n + 1 }, () => 0));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] =
+        a[i - 1] === b[j - 1]
+          ? dp[i - 1][j - 1]
+          : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+
+/**
+ * Return the closest candidate within Levenshtein distance <= 3, or null.
+ * @param {string} name
+ * @param {Iterable<string>} candidates
+ * @returns {string | null}
+ */
+export function didYouMean(name, candidates) {
+  let best = null;
+  let bestDist = 4; // threshold: distance must be <= 3
+  for (const c of candidates) {
+    const d = levenshtein(name, c);
+    if (d < bestDist) {
+      bestDist = d;
+      best = c;
+    }
+  }
+  return best;
+}
+
+// Keys to ignore in Proxy tracking — React internals, framework hooks, and prototype methods
+const SKIP_KEYS = new Set([
+  "$$typeof",
+  "then",
+  "toJSON",
+  "constructor",
+  "valueOf",
+  "toString",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable",
+  "toLocaleString",
+  "__proto__",
+  "_owner",
+  "_store",
+  "ref",
+  "key",
+  "type",
+  "props",
+  "_self",
+  "_source",
+]);
+
+const ARRAY_METHODS = new Set([
+  "length",
+  "map",
+  "filter",
+  "forEach",
+  "find",
+  "findIndex",
+  "some",
+  "every",
+  "reduce",
+  "reduceRight",
+  "includes",
+  "indexOf",
+  "lastIndexOf",
+  "flat",
+  "flatMap",
+  "slice",
+  "concat",
+  "join",
+  "sort",
+  "reverse",
+  "entries",
+  "keys",
+  "values",
+  "at",
+  "fill",
+  "copyWithin",
+  "push",
+  "pop",
+  "shift",
+  "unshift",
+  "splice",
+]);
+
+/**
+ * Wrap an object with a Proxy that records all property access paths into `accessed`.
+ * Nested objects/arrays are recursively wrapped.
+ * @param {unknown} obj - object to wrap
+ * @param {Set<string>} accessed - set to record accessed paths
+ * @param {string} [prefix=""] - current dot-separated path prefix
+ * @returns {unknown}
+ */
+export function createAccessTracker(obj, accessed, prefix = "") {
+  if (obj === null || obj === undefined || typeof obj !== "object") return obj;
+
+  return new Proxy(obj, {
+    get(target, prop, receiver) {
+      // Skip symbols (React internals: Symbol.toPrimitive, Symbol.iterator, etc.)
+      if (typeof prop === "symbol") return Reflect.get(target, prop, receiver);
+
+      // Skip framework / prototype keys
+      if (SKIP_KEYS.has(prop)) return Reflect.get(target, prop, receiver);
+
+      const isArr = Array.isArray(target);
+
+      // Skip array methods but still wrap returned object values
+      if (isArr && ARRAY_METHODS.has(prop)) {
+        const val = Reflect.get(target, prop, receiver);
+        return val;
+      }
+
+      // Numeric index on array — record as prefix.$
+      if (isArr && /^\d+$/.test(prop)) {
+        const path = prefix ? `${prefix}.$` : "$";
+        accessed.add(path);
+        const val = target[prop];
+        if (val !== null && val !== undefined && typeof val === "object") {
+          return createAccessTracker(val, accessed, path);
+        }
+        return val;
+      }
+
+      const path = prefix ? `${prefix}.${prop}` : prop;
+      accessed.add(path);
+
+      const val = Reflect.get(target, prop, receiver);
+      if (val !== null && val !== undefined && typeof val === "object") {
+        return createAccessTracker(val, accessed, path);
+      }
+      return val;
+    },
+  });
+}
+
+/**
+ * Compare accessed property paths against schema-defined paths.
+ * Returns an array of warning strings for fields accessed but not in schema.
+ * @param {Set<string>} accessed - paths recorded by createAccessTracker
+ * @param {object | null} schema - page-level JTD schema
+ * @param {string} routePath - route path for warning messages
+ * @returns {string[]}
+ */
+export function checkFieldAccess(accessed, schema, routePath) {
+  if (!schema) return [];
+
+  const known = collectSchemaPaths(schema);
+  if (known.size === 0) return [];
+
+  const warnings = [];
+  // Collect leaf field names for did-you-mean suggestions
+  const leafNames = new Set();
+  for (const p of known) {
+    const dot = p.lastIndexOf(".");
+    leafNames.add(dot === -1 ? p : p.slice(dot + 1));
+  }
+
+  for (const path of accessed) {
+    if (known.has(path)) continue;
+
+    // Skip if it's a parent prefix of a known path (e.g. "user" when "user.name" exists)
+    let isParent = false;
+    for (const k of known) {
+      if (k.startsWith(path + ".")) {
+        isParent = true;
+        break;
+      }
+    }
+    if (isParent) continue;
+
+    const fieldName = path.includes(".") ? path.slice(path.lastIndexOf(".") + 1) : path;
+    const suggestion = didYouMean(fieldName, leafNames);
+
+    const knownList = [...leafNames].sort().join(", ");
+    let msg = `Route "${routePath}" component accessed data.${path},\n       but schema only defines: ${knownList}`;
+    if (suggestion) {
+      msg += `\n       Did you mean: ${suggestion}?`;
+    }
+    warnings.push(msg);
+  }
+
+  return warnings;
+}
+
+export function collectHtmlPaths(schema) {
+  const paths = new Set();
+
+  function walk(node, prefix) {
+    if (!node || typeof node !== "object") return;
+
+    if (node.nullable) {
+      const inner = { ...node };
+      delete inner.nullable;
+      walk(inner, prefix);
+      return;
+    }
+
+    if (node.type === "string" && node.metadata?.format === "html") {
+      paths.add(prefix);
+      return;
+    }
+
+    if (node.properties || node.optionalProperties) {
+      for (const [key, sub] of Object.entries(node.properties || {})) {
+        walk(sub, prefix ? `${prefix}.${key}` : key);
+      }
+      for (const [key, sub] of Object.entries(node.optionalProperties || {})) {
+        walk(sub, prefix ? `${prefix}.${key}` : key);
+      }
+      return;
+    }
+
+    if (node.elements) {
+      walk(node.elements, prefix ? `${prefix}.$` : "$");
+      return;
+    }
+  }
+
+  walk(schema, "");
+
+  // Add flattened paths (strip first segment) to match flattenLoaderMock
+  const flattened = new Set(paths);
+  for (const p of paths) {
+    const dot = p.indexOf(".");
+    if (dot !== -1) {
+      flattened.add(p.slice(dot + 1));
+    }
+  }
+
+  return flattened;
+}