@json-render/core 0.4.3 → 0.4.4

package/dist/index.mjs

@@ -28,17 +28,27 @@ function resolveDynamicValue(value, dataModel) {
   }
   return value;
 }
+function unescapeJsonPointer(token) {
+  return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function parseJsonPointer(path) {
+  const raw = path.startsWith("/") ? path.slice(1).split("/") : path.split("/");
+  return raw.map(unescapeJsonPointer);
+}
 function getByPath(obj, path) {
   if (!path || path === "/") {
     return obj;
   }
-  const segments = path.startsWith("/") ? path.slice(1).split("/") : path.split("/");
+  const segments = parseJsonPointer(path);
   let current = obj;
   for (const segment of segments) {
     if (current === null || current === void 0) {
       return void 0;
     }
-    if (typeof current === "object") {
+    if (Array.isArray(current)) {
+      const index = parseInt(segment, 10);
+      current = current[index];
+    } else if (typeof current === "object") {
       current = current[segment];
     } else {
       return void 0;
@@ -50,13 +60,13 @@ function isNumericIndex(str) {
   return /^\d+$/.test(str);
 }
 function setByPath(obj, path, value) {
-  const segments = path.startsWith("/") ? path.slice(1).split("/") : path.split("/");
+  const segments = parseJsonPointer(path);
   if (segments.length === 0) return;
   let current = obj;
   for (let i = 0; i < segments.length - 1; i++) {
     const segment = segments[i];
     const nextSegment = segments[i + 1];
-    const nextIsNumeric = nextSegment !== void 0 && isNumericIndex(nextSegment);
+    const nextIsNumeric = nextSegment !== void 0 && (isNumericIndex(nextSegment) || nextSegment === "-");
     if (Array.isArray(current)) {
       const index = parseInt(segment, 10);
       if (current[index] === void 0 || typeof current[index] !== "object") {
@@ -72,12 +82,95 @@ function setByPath(obj, path, value) {
   }
   const lastSegment = segments[segments.length - 1];
   if (Array.isArray(current)) {
-    const index = parseInt(lastSegment, 10);
-    current[index] = value;
+    if (lastSegment === "-") {
+      current.push(value);
+    } else {
+      const index = parseInt(lastSegment, 10);
+      current[index] = value;
+    }
+  } else {
+    current[lastSegment] = value;
+  }
+}
+function addByPath(obj, path, value) {
+  const segments = parseJsonPointer(path);
+  if (segments.length === 0) return;
+  let current = obj;
+  for (let i = 0; i < segments.length - 1; i++) {
+    const segment = segments[i];
+    const nextSegment = segments[i + 1];
+    const nextIsNumeric = nextSegment !== void 0 && (isNumericIndex(nextSegment) || nextSegment === "-");
+    if (Array.isArray(current)) {
+      const index = parseInt(segment, 10);
+      if (current[index] === void 0 || typeof current[index] !== "object") {
+        current[index] = nextIsNumeric ? [] : {};
+      }
+      current = current[index];
+    } else {
+      if (!(segment in current) || typeof current[segment] !== "object") {
+        current[segment] = nextIsNumeric ? [] : {};
+      }
+      current = current[segment];
+    }
+  }
+  const lastSegment = segments[segments.length - 1];
+  if (Array.isArray(current)) {
+    if (lastSegment === "-") {
+      current.push(value);
+    } else {
+      const index = parseInt(lastSegment, 10);
+      current.splice(index, 0, value);
+    }
   } else {
     current[lastSegment] = value;
   }
 }
+function removeByPath(obj, path) {
+  const segments = parseJsonPointer(path);
+  if (segments.length === 0) return;
+  let current = obj;
+  for (let i = 0; i < segments.length - 1; i++) {
+    const segment = segments[i];
+    if (Array.isArray(current)) {
+      const index = parseInt(segment, 10);
+      if (current[index] === void 0 || typeof current[index] !== "object") {
+        return;
+      }
+      current = current[index];
+    } else {
+      if (!(segment in current) || typeof current[segment] !== "object") {
+        return;
+      }
+      current = current[segment];
+    }
+  }
+  const lastSegment = segments[segments.length - 1];
+  if (Array.isArray(current)) {
+    const index = parseInt(lastSegment, 10);
+    if (index >= 0 && index < current.length) {
+      current.splice(index, 1);
+    }
+  } else {
+    delete current[lastSegment];
+  }
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  if (Array.isArray(a)) {
+    if (!Array.isArray(b)) return false;
+    if (a.length !== b.length) return false;
+    return a.every((item, i) => deepEqual(item, b[i]));
+  }
+  const aObj = a;
+  const bObj = b;
+  const aKeys = Object.keys(aObj);
+  const bKeys = Object.keys(bObj);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every((key) => deepEqual(aObj[key], bObj[key]));
+}
 function findFormValue(fieldName, params, data) {
   if (params?.[fieldName] !== void 0) {
     const val = params[fieldName];
@@ -126,10 +219,38 @@ function parseSpecStreamLine(line) {
   }
 }
 function applySpecStreamPatch(obj, patch) {
-  if (patch.op === "set" || patch.op === "add" || patch.op === "replace") {
-    setByPath(obj, patch.path, patch.value);
-  } else if (patch.op === "remove") {
-    setByPath(obj, patch.path, void 0);
+  switch (patch.op) {
+    case "add":
+      addByPath(obj, patch.path, patch.value);
+      break;
+    case "replace":
+      setByPath(obj, patch.path, patch.value);
+      break;
+    case "remove":
+      removeByPath(obj, patch.path);
+      break;
+    case "move": {
+      if (!patch.from) break;
+      const moveValue = getByPath(obj, patch.from);
+      removeByPath(obj, patch.from);
+      addByPath(obj, patch.path, moveValue);
+      break;
+    }
+    case "copy": {
+      if (!patch.from) break;
+      const copyValue = getByPath(obj, patch.from);
+      addByPath(obj, patch.path, copyValue);
+      break;
+    }
+    case "test": {
+      const actual = getByPath(obj, patch.path);
+      if (!deepEqual(actual, patch.value)) {
+        throw new Error(
+          `Test operation failed: value at "${patch.path}" does not match`
+        );
+      }
+      break;
+    }
   }
   return obj;
 }
@@ -872,10 +993,10 @@ function generatePrompt(catalog, options) {
   lines.push("");
   lines.push("Example output (each line is a separate JSON object):");
   lines.push("");
-  lines.push(`{"op":"set","path":"/root","value":"card-1"}
-{"op":"set","path":"/elements/card-1","value":{"key":"card-1","type":"Card","props":{"title":"Dashboard"},"children":["metric-1","chart-1"],"parentKey":""}}
-{"op":"set","path":"/elements/metric-1","value":{"key":"metric-1","type":"Metric","props":{"label":"Revenue","valuePath":"analytics.revenue","format":"currency"},"children":[],"parentKey":"card-1"}}
-{"op":"set","path":"/elements/chart-1","value":{"key":"chart-1","type":"Chart","props":{"type":"bar","dataPath":"analytics.salesByRegion"},"children":[],"parentKey":"card-1"}}`);
+  lines.push(`{"op":"add","path":"/root","value":"card-1"}
+{"op":"add","path":"/elements/card-1","value":{"type":"Card","props":{"title":"Dashboard"},"children":["metric-1","chart-1"]}}
+{"op":"add","path":"/elements/metric-1","value":{"type":"Metric","props":{"label":"Revenue","valuePath":"analytics.revenue","format":"currency"},"children":[]}}
+{"op":"add","path":"/elements/chart-1","value":{"type":"Chart","props":{"type":"bar","dataPath":"analytics.salesByRegion"},"children":[]}}`);
   lines.push("");
   const components = catalog.data.components;
   if (components) {
@@ -902,12 +1023,11 @@ function generatePrompt(catalog, options) {
   lines.push("RULES:");
   const baseRules = [
     "Output ONLY JSONL patches - one JSON object per line, no markdown, no code fences",
-    'First line sets root: {"op":"set","path":"/root","value":"<root-key>"}',
-    'Then add each element: {"op":"set","path":"/elements/<key>","value":{...}}',
+    'First line sets root: {"op":"add","path":"/root","value":"<root-key>"}',
+    'Then add each element: {"op":"add","path":"/elements/<key>","value":{...}}',
     "ONLY use components listed above",
-    "Each element value needs: key, type, props, children (array of child keys), parentKey",
-    "Use unique keys (e.g., 'header', 'metric-1', 'chart-revenue')",
-    "Root element's parentKey is empty string, children reference their parent's key"
+    "Each element value needs: type, props, children (array of child keys)",
+    "Use unique keys for the element map entries (e.g., 'header', 'metric-1', 'chart-revenue')"
   ];
   const allRules = [...baseRules, ...customRules];
   allRules.forEach((rule, i) => {
@@ -1063,22 +1183,18 @@ function createCatalog(config) {
   const componentSchemas = componentNames.map((componentName) => {
     const def = components[componentName];
     return z6.object({
-      key: z6.string(),
       type: z6.literal(componentName),
       props: def.props,
       children: z6.array(z6.string()).optional(),
-      parentKey: z6.string().nullable().optional(),
       visible: VisibilityConditionSchema.optional()
     });
   });
   let elementSchema;
   if (componentSchemas.length === 0) {
     elementSchema = z6.object({
-      key: z6.string(),
       type: z6.string(),
       props: z6.record(z6.string(), z6.unknown()),
       children: z6.array(z6.string()).optional(),
-      parentKey: z6.string().nullable().optional(),
       visible: VisibilityConditionSchema.optional()
     });
   } else if (componentSchemas.length === 1) {
@@ -1299,21 +1415,21 @@ function generateSystemPrompt(catalog, options = {}) {
     }
     lines.push("");
   }
-  lines.push("OUTPUT FORMAT (JSONL):");
-  lines.push('{"op":"set","path":"/root","value":"element-key"}');
+  lines.push("OUTPUT FORMAT (JSONL, RFC 6902 JSON Patch):");
+  lines.push('{"op":"add","path":"/root","value":"element-key"}');
   lines.push(
-    '{"op":"add","path":"/elements/key","value":{"key":"...","type":"...","props":{...},"children":[...]}}'
+    '{"op":"add","path":"/elements/key","value":{"type":"...","props":{...},"children":[...]}}'
   );
   lines.push('{"op":"remove","path":"/elements/key"}');
   lines.push("");
   lines.push("RULES:");
   const baseRules = [
-    "First line sets /root to root element key",
-    "Add elements with /elements/{key}",
+    'First line sets /root to root element key: {"op":"add","path":"/root","value":"<key>"}',
+    'Add elements with /elements/{key}: {"op":"add","path":"/elements/<key>","value":{...}}',
     "Remove elements with op:remove - also update the parent's children array to exclude the removed key",
     "Children array contains string keys, not objects",
     "Parent first, then children",
-    "Each element needs: key, type, props",
+    "Each element needs: type, props",
     "ONLY use props listed above - never invent new props"
   ];
   const allRules = [...baseRules, ...customRules];
@@ -1343,6 +1459,7 @@ export {
   ValidationConfigSchema,
   VisibilityConditionSchema,
   action,
+  addByPath,
   applySpecStreamPatch,
   builtInValidationFunctions,
   check,
@@ -1360,6 +1477,7 @@ export {
   getByPath,
   interpolateString,
   parseSpecStreamLine,
+  removeByPath,
   resolveAction,
   resolveDynamicValue,
   runValidation,