yamlover 0.3.23 → 0.3.25

package/dist/server.js

@@ -62331,6 +62331,7 @@ var require_ignore = __commonJS({
 // src/server/engine-api.ts
 import path10 from "node:path";
 import fs10 from "node:fs";
+import os from "node:os";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // ../parser/ts/src/ir.ts
@@ -62374,7 +62375,8 @@ function resolveDocument(doc) {
     node.entries?.forEach((e3, i2) => {
       const seg = e3.key != null ? ":" + e3.key : "[" + i2 + "]";
       if (isPointer(e3.value)) {
-        const target = resolve(doc, chains, chain, e3.value, /* @__PURE__ */ new Set([e3.value]), keys);
+        const host = hasRelindex(e3.value) ? hostPositions(chain, i2) : void 0;
+        const target = resolve(doc, chains, chain, e3.value, /* @__PURE__ */ new Set([e3.value]), keys, host);
         out.push({ from: prefix + seg, holder: base, label: e3.key, pos: i2, raw: e3.value.raw, edge: e3.edge, target, ptr: e3.value, docRoot: dr });
       } else {
         walk(e3.value, dr);
@@ -62400,6 +62402,21 @@ function resolveDocument(doc) {
   walk(doc.root, ":");
   return out;
 }
+function hasRelindex(p2) {
+  return p2.steps.some((s2) => s2.sel === "relindex");
+}
+function hostPositions(chain, entryIdx) {
+  const pos = [];
+  for (let i2 = 1; i2 < chain.length; i2++) {
+    const idx = chain[i2 - 1].entries?.findIndex((e3) => e3.value === chain[i2]) ?? -1;
+    pos[i2] = idx >= 0 ? idx : void 0;
+  }
+  pos[chain.length] = entryIdx;
+  return pos;
+}
+function relRaw(k) {
+  return `[.${k === 0 ? "" : k > 0 ? "+" + k : k}]`;
+}
 function anchorKeyOf(a2) {
   return a2.ordinal ? null : lastKey(a2.path);
 }
@@ -62438,7 +62455,7 @@ function realizeAnchors(doc, chains) {
   }
   return { edges, keys };
 }
-function resolve(doc, chains, fromChain, ptr, visited, anchorKeys) {
+function resolve(doc, chains, fromChain, ptr, visited, anchorKeys, host) {
   const root = doc.root;
   let steps = ptr.steps;
   let chain;
@@ -62480,7 +62497,16 @@ function resolve(doc, chains, fromChain, ptr, visited, anchorKeys) {
     }
     const node = chain[chain.length - 1];
     if (node === void 0) return { kind: "unresolved", reason: "empty resolution scope" };
-    const entry = st.sel === "key" ? node.entries?.find((e3) => e3.key === st.name) : node.entries?.[st.n];
+    let idx;
+    if (st.sel === "key") idx = node.entries?.findIndex((e3) => e3.key === st.name) ?? -1;
+    else if (st.sel === "index") idx = st.n;
+    else {
+      const at = host?.[chain.length];
+      if (at === void 0) return { kind: "unresolved", reason: `relative index ${relRaw(st.k)} has no host frame at this depth (URIs.md \xA7Relative indexes)` };
+      idx = at + st.k;
+      if (idx < 0) return { kind: "unresolved", reason: `relative index ${relRaw(st.k)} out of range (position ${at})` };
+    }
+    const entry = idx >= 0 ? node.entries?.[idx] : void 0;
     if (!entry) {
       if (st.sel === "key") {
         const via = anchorKeys?.get(node)?.get(st.name);
@@ -62490,13 +62516,14 @@ function resolve(doc, chains, fromChain, ptr, visited, anchorKeys) {
         }
       }
       if (!node.entries) return isWorld ? external() : { kind: "unresolved", reason: "step into a node with no fields" };
-      return isWorld ? external() : { kind: "unresolved", reason: `no ${st.sel === "key" ? `key "${st.name}"` : `index [${st.n}]`}` };
+      return isWorld ? external() : { kind: "unresolved", reason: `no ${st.sel === "key" ? `key "${st.name}"` : st.sel === "index" ? `index [${st.n}]` : `entry at relative index ${relRaw(st.k)} (position ${idx})`}` };
     }
     if (isPointer(entry.value)) {
       if (visited.has(entry.value)) return { kind: "unresolved", reason: "pointer cycle" };
       const next = new Set(visited);
       next.add(entry.value);
-      const r2 = resolve(doc, chains, chain, entry.value, next, anchorKeys);
+      const innerHost = hasRelindex(entry.value) ? hostPositions(chain, idx) : void 0;
+      const r2 = resolve(doc, chains, chain, entry.value, next, anchorKeys, innerHost);
       if (r2.kind !== "node") return r2;
       chain = chains.get(r2.node) ?? [r2.node];
     } else {
@@ -62535,7 +62562,7 @@ function pathOf(chain) {
 
 // ../engine/ts/src/store.ts
 import { DatabaseSync } from "node:sqlite";
-var SCHEMA_VERSION = 5;
+var SCHEMA_VERSION = 6;
 var SCHEMA = `
 CREATE TABLE IF NOT EXISTS node (
   path         TEXT PRIMARY KEY,
@@ -62565,8 +62592,14 @@ CREATE TABLE IF NOT EXISTS file (
 CREATE TABLE IF NOT EXISTS dangling (
   from_path TEXT NOT NULL,               -- the entry holding the pointer
   raw       TEXT NOT NULL,               -- the pointer text as authored
-  reason    TEXT NOT NULL                -- why it did not resolve
+  reason    TEXT NOT NULL,               -- why it did not resolve (externals: the authority)
+  holder    TEXT NOT NULL,               -- the mapping that holds the entry
+  label     TEXT,                        -- the entry's key; null for keyless/positional
+  pos       INTEGER,                     -- the entry's index in the holder (source order)
+  edge      TEXT NOT NULL,               -- ref | back (as authored)
+  external  INTEGER NOT NULL DEFAULT 0   -- 1 = an external-authority link, not an error
 );
+CREATE INDEX IF NOT EXISTS dangling_holder ON dangling (holder);
 `;
 function encodeScalarValue(v) {
   if (typeof v === "number" && !Number.isFinite(v)) return JSON.stringify({ "@nonfinite": String(v) });
@@ -62631,10 +62664,10 @@ var Store = class {
         insNode.run(path11, node.kind, format, value, hash, size, isArray ? 1 : 0, meta);
         if (parent !== null) insEdge.run(parent, path11, label, "contain", pos);
       });
-      const insDangling = this.db.prepare("INSERT INTO dangling (from_path, raw, reason) VALUES (?, ?, ?)");
+      const insDangling = this.db.prepare(INSERT_DANGLING);
       for (const r2 of resolveDocument(doc)) {
         if (r2.target.kind === "node") insEdge.run(r2.holder, r2.target.path, r2.label, r2.edge, r2.pos);
-        else if (r2.target.kind === "unresolved") insDangling.run(r2.from, r2.raw, r2.target.reason);
+        else insDanglingRef(insDangling, r2);
       }
       if (files) {
         const insFile = this.db.prepare("INSERT OR REPLACE INTO file (path, hash, size, mtime_ms) VALUES (?, ?, ?, ?)");
@@ -62675,7 +62708,7 @@ var Store = class {
     const insEdge = this.db.prepare(
       `INSERT INTO edge (from_path, to_path, label, kind, pos) VALUES (?, ?, ?, ?, ?)`
     );
-    const insDangling = this.db.prepare("INSERT INTO dangling (from_path, raw, reason) VALUES (?, ?, ?)");
+    const insDangling = this.db.prepare(INSERT_DANGLING);
     const insFile = this.db.prepare("INSERT OR REPLACE INTO file (path, hash, size, mtime_ms) VALUES (?, ?, ?, ?)");
     this.db.exec("BEGIN");
     try {
@@ -62684,7 +62717,7 @@ var Store = class {
       };
       delUnder("path", "node");
       delUnder("from_path", "edge");
-      delUnder("from_path", "dangling");
+      delUnder("holder", "dangling");
       if (relPrefix) this.db.prepare("DELETE FROM file WHERE substr(path,1,?) = ?").run(relPrefix.length, relPrefix);
       walkNodes(doc.root, ":", (p2, node, parent, label, pos) => {
         if (!underP(p2)) return;
@@ -62701,7 +62734,7 @@ var Store = class {
       for (const r2 of edges) {
         if (!underP(r2.holder)) continue;
         if (r2.target.kind === "node") insEdge.run(r2.holder, r2.target.path, r2.label, r2.edge, r2.pos);
-        else if (r2.target.kind === "unresolved") insDangling.run(r2.from, r2.raw, r2.target.reason);
+        else insDanglingRef(insDangling, r2);
       }
       for (const f2 of files) insFile.run(f2.path, f2.hash, f2.size, f2.mtimeMs);
       this.db.exec("COMMIT");
@@ -62835,14 +62868,27 @@ var Store = class {
       throw e3;
     }
   }
-  /** The pointers that failed to resolve at index time (ENGINE.md: reported, never dropped). */
+  /** The pointers that failed to resolve at index time (ENGINE.md: reported, never dropped).
+   *  External-authority links are not errors, so they are excluded here. */
   dangling() {
-    return this.db.prepare("SELECT * FROM dangling").all().map((r2) => ({
+    return this.db.prepare("SELECT * FROM dangling WHERE external = 0").all().map((r2) => ({
       from: r2.from_path,
       raw: r2.raw,
       reason: r2.reason
     }));
   }
+  /** A node's pointer ENTRIES with no local target — unresolved (dangling) plus external-
+   *  authority links — in source order. These are the entries {@link entries} cannot list (no
+   *  edge exists), returned so a projection can still show the authored pointer in place. */
+  unrealizedRefs(holder) {
+    return this.db.prepare("SELECT label, pos, raw, edge, external FROM dangling WHERE holder = ? ORDER BY pos").all(holder).map((r2) => ({
+      label: r2.label ?? null,
+      pos: r2.pos ?? null,
+      raw: r2.raw,
+      edge: r2.edge,
+      external: r2.external === 1
+    }));
+  }
   /** A node's attributes (null if no such path). */
   node(path11) {
     const row = this.db.prepare("SELECT * FROM node WHERE path = ?").get(path11);
@@ -62905,6 +62951,13 @@ var Store = class {
     return { out, in: [...inc, ...derivedIn] };
   }
 };
+var INSERT_DANGLING = "INSERT INTO dangling (from_path, raw, reason, holder, label, pos, edge, external) VALUES (?, ?, ?, ?, ?, ?, ?, ?)";
+function insDanglingRef(stmt, r2) {
+  if (r2.target.kind === "node") return;
+  const ext = r2.target.kind === "external";
+  const reason = r2.target.kind === "external" ? r2.target.authority : r2.target.reason;
+  stmt.run(r2.from, r2.raw, reason, r2.anchor ? "" : r2.holder, r2.label, r2.pos, r2.edge, ext ? 1 : 0);
+}
 function walkNodes(node, path11, visit2, parent = null, label = null, pos = null) {
   visit2(path11, node, parent, label, pos);
   if (!node.entries) return;
@@ -62915,6 +62968,7 @@ function walkNodes(node, path11, visit2, parent = null, label = null, pos = null
   });
 }
 function formatFromMeta(node) {
+  if (node.meta?.derivedFormat) return node.meta.derivedFormat;
   const s2 = node.meta?.schema;
   if (!s2) return null;
   if (isPointer(s2)) {
@@ -63112,6 +63166,7 @@ function portionsToSteps(portions) {
 }
 function portionToSteps(p2) {
   if (p2 === "..") return [{ sel: "parent" }];
+  if (p2.startsWith("..") && p2[2] === "[") return [{ sel: "parent" }, ...indexGroups(p2.slice(2), p2, "portion")];
   let name = "";
   let i2 = 0;
   if (p2[0] === "'" || p2[0] === '"') {
@@ -63149,15 +63204,40 @@ function portionToSteps(p2) {
   }
   const steps = [];
   if (name !== "") steps.push({ sel: "key", name });
-  while (i2 < p2.length) {
-    if (p2[i2] !== "[") throw new SyntaxError(`pointer: malformed portion "${p2}"`);
+  if (i2 < p2.length) steps.push(...indexGroups(p2.slice(i2), p2, "portion"));
+  return steps;
+}
+function indexGroups(s2, whole, noun) {
+  const steps = [];
+  let i2 = 0;
+  while (i2 < s2.length) {
+    if (s2[i2] !== "[") throw new SyntaxError(`pointer: malformed ${noun} "${whole}"`);
     let j = i2 + 1;
+    if (s2[j] === ".") {
+      j++;
+      let k = 0;
+      if (s2[j] === "+" || s2[j] === "-") {
+        const sign = s2[j] === "-" ? -1 : 1;
+        j++;
+        let digits2 = "";
+        while (j < s2.length && s2[j] >= "0" && s2[j] <= "9") {
+          digits2 += s2[j];
+          j++;
+        }
+        if (digits2 === "") throw new SyntaxError(`pointer: malformed index in "${whole}"`);
+        k = sign * Number.parseInt(digits2, 10);
+      }
+      if (s2[j] !== "]") throw new SyntaxError(`pointer: malformed index in "${whole}"`);
+      steps.push({ sel: "relindex", k });
+      i2 = j + 1;
+      continue;
+    }
     let digits = "";
-    while (j < p2.length && p2[j] >= "0" && p2[j] <= "9") {
-      digits += p2[j];
+    while (j < s2.length && s2[j] >= "0" && s2[j] <= "9") {
+      digits += s2[j];
       j++;
     }
-    if (digits === "" || p2[j] !== "]") throw new SyntaxError(`pointer: malformed index in "${p2}"`);
+    if (digits === "" || s2[j] !== "]") throw new SyntaxError(`pointer: malformed index in "${whole}"`);
     steps.push({ sel: "index", n: Number.parseInt(digits, 10) });
     i2 = j + 1;
   }
@@ -63173,10 +63253,17 @@ function renderPointer(p2, opts = {}) {
   const sep2 = spaced ? ": " : ":";
   const toks = [];
   for (const st of p2.steps) {
-    if (st.sel === "parent") toks.push("..");
-    else if (st.sel === "key") toks.push(colonSegment(st.name));
-    else if (toks.length > 0 && !toks[toks.length - 1].endsWith("..")) toks[toks.length - 1] += `[${st.n}]`;
-    else toks.push(`[${st.n}]`);
+    if (st.sel === "parent") {
+      toks.push("..");
+      continue;
+    }
+    if (st.sel === "key") {
+      toks.push(colonSegment(st.name));
+      continue;
+    }
+    const t3 = st.sel === "index" ? `[${st.n}]` : `[.${st.k === 0 ? "" : (st.k > 0 ? "+" : "") + st.k}]`;
+    if (toks.length > 0 && (st.sel === "relindex" || !toks[toks.length - 1].endsWith(".."))) toks[toks.length - 1] += t3;
+    else toks.push(t3);
   }
   const body = toks.join(sep2);
   switch (p2.base.scope) {
@@ -63244,6 +63331,7 @@ function readUntilSlash(s2) {
 }
 function segToSteps(seg) {
   if (seg === "..") return [{ sel: "parent" }];
+  if (seg.startsWith("..") && seg[2] === "[") return [{ sel: "parent" }, ...indexGroups(seg.slice(2), seg, "segment")];
   let i2 = 0;
   let name = "";
   for (; i2 < seg.length; i2++) {
@@ -63258,18 +63346,7 @@ function segToSteps(seg) {
   }
   const steps = [];
   if (name !== "") steps.push({ sel: "key", name: unescape(name) });
-  while (i2 < seg.length) {
-    if (seg[i2] !== "[") throw new SyntaxError(`pointer: malformed segment "${seg}"`);
-    let j = i2 + 1;
-    let digits = "";
-    while (j < seg.length && seg[j] >= "0" && seg[j] <= "9") {
-      digits += seg[j];
-      j++;
-    }
-    if (digits === "" || seg[j] !== "]") throw new SyntaxError(`pointer: malformed index in "${seg}"`);
-    steps.push({ sel: "index", n: Number.parseInt(digits, 10) });
-    i2 = j + 1;
-  }
+  if (i2 < seg.length) steps.push(...indexGroups(seg.slice(i2), seg, "segment"));
   return steps;
 }
 function unescape(s2) {
@@ -63291,6 +63368,7 @@ function makeAnchor(body, fail, yaml = false) {
     body = body.slice(0, -2);
   }
   const path11 = parsePointer(body, yaml);
+  if (path11.steps.some((s2) => s2.sel === "relindex")) fail('an anchor may not claim a position \u2014 "[.\xB1k]" is link-only');
   if (!ordinal) {
     const last = path11.steps[path11.steps.length - 1];
     if (last === void 0) fail('an anchor path needs a key segment (or a trailing "[]" for ordinal membership)');
@@ -64916,7 +64994,7 @@ function applyMeta(node, meta) {
     if (!m) continue;
     if (m.uniqueItems) e3.value = { ...e3.value, meta: { ...e3.value.meta, set: true } };
     if (e3.value.kind === "blob") continue;
-    if (m.format && !e3.value.meta?.schema) e3.value = { ...e3.value, meta: { ...e3.value.meta, schema: inlineFormat(m.format) } };
+    if (m.format && !e3.value.meta?.schema) e3.value = { ...e3.value, meta: { ...e3.value.meta, derivedFormat: m.format } };
   }
   return node;
 }
@@ -64935,7 +65013,7 @@ function blob(abs, format, ctx) {
 }
 function textScalar(abs, format, ctx) {
   const text = readTracked(ctx, abs).toString("utf8");
-  return { kind: "scalar", value: text, raw: text, meta: { schema: inlineFormat(format) } };
+  return { kind: "scalar", value: text, raw: text, meta: { derivedFormat: format } };
 }
 function parsedScalar(abs, ext, ctx) {
   const lang = ext === ".json" || ext === ".json5" || ext === ".json5p" ? "json5p" : ext === ".yaml" || ext === ".yml" ? "yaml" : "yamlover";
@@ -64983,7 +65061,7 @@ function applySchemas(root, defsRoot, builtinDefs) {
     return v && !isPointer(v) && v.kind === "scalar" && v.value != null ? String(v.value) : null;
   };
   const hasFormat = (inst) => {
-    if (inst.kind === "blob") return true;
+    if (inst.kind === "blob" || inst.meta?.derivedFormat) return true;
     const s2 = inst.meta?.schema;
     return !!s2 && !isPointer(s2) && s2.kind === "mapping" && !!field(s2, "format");
   };
@@ -65000,7 +65078,7 @@ function applySchemas(root, defsRoot, builtinDefs) {
   const applyItems = (inst, items, depth) => {
     const { node: itemsNode } = resolveSchema(items);
     const anyOf = itemsNode ? field(itemsNode, "anyOf") : null;
-    const elems = (inst.entries ?? []).filter((e3) => e3.key == null && !isPointer(e3.value));
+    const elems = (inst.entries ?? []).filter((e3) => e3.key == null && !isPointer(e3.value) && !(e3.value.meta?.schema && isPointer(e3.value.meta.schema)));
     if (anyOf && !isPointer(anyOf) && anyOf.entries) {
       const branches = anyOf.entries.map((e3) => e3.value).map((b) => ({ ptr: b, ...resolveSchema(b) }));
       for (const e3 of elems) {
@@ -65019,7 +65097,7 @@ function applySchemas(root, defsRoot, builtinDefs) {
     const stype = str(s2, "type");
     const named = name && (stype === "object" || stype === "variant" || stype === "mixed" || !!field(s2, "allOf"));
     const fmt = str(s2, "format") ?? (named ? `x-yamlover-${name}` : null);
-    if (fmt && !hasFormat(inst)) inst.meta = { ...inst.meta, schema: inlineFormat(fmt) };
+    if (fmt && !hasFormat(inst)) inst.meta = { ...inst.meta, derivedFormat: fmt };
     if (stype === "object" || stype === "variant" || stype === "mixed" || stype === "array" || field(s2, "items")) {
       const props = field(s2, "properties");
       const addl = field(s2, "additionalProperties");
@@ -65044,9 +65122,6 @@ function applySchemas(root, defsRoot, builtinDefs) {
   };
   walk(root);
 }
-function inlineFormat(format) {
-  return { kind: "mapping", entries: [{ key: "format", edge: "contain", value: { kind: "scalar", value: format, raw: format } }], array: false };
-}
 function applyBody(dir, node, ctx) {
   const file = path2.join(dir, YAMLOVER_DIR, "body.yamlover");
   if (!fs2.existsSync(file)) return node;
@@ -65189,11 +65264,21 @@ var DOC_FORMATS = {
 import * as path3 from "node:path";
 
 // ../parser/ts/src/serialize-common.ts
+var LossyError = class extends Error {
+};
 function anchorBody(a2) {
   return renderPointer(a2.path) + (a2.ordinal ? "[]" : "");
 }
 
 // ../parser/ts/src/serialize-yamlover.ts
+function schemaText(v) {
+  const text = isPointer(v) ? `*${renderPointer(v)}` : schemaNodeText(v);
+  if (/[>\n]/.test(text)) throw new LossyError(`a !!<\u2026> schema tag cannot contain ">" or a newline: ${text}`);
+  return text;
+}
+function schemaTagToken(v) {
+  return `!!<${schemaText(v)}>`;
+}
 function pointerToken(raw) {
   if (raw !== raw.trim()) return `*'${raw.replace(/'/g, "''")}'`;
   return "*" + raw;
@@ -65222,6 +65307,73 @@ function hasUnquotedSpace(s2) {
   }
   return false;
 }
+function dq(s2) {
+  return JSON.stringify(s2);
+}
+function keyText(key) {
+  const needsQuote = key === "" || key !== key.trim() || /[\u0000-\u001f\u007f]/.test(key) || key.includes(": ") || // splitKV would split at the inner colon
+  key === "-" || key.startsWith("- ") || /^['"]/.test(key) || key.includes("\\");
+  if (needsQuote) return dq(key);
+  return key.replace(/[/[\]*&#~?!()<>=|]/g, (c3) => "\\" + c3);
+}
+function schemaNodeText(n2) {
+  if (n2.kind === "mapping") {
+    const ents = n2.entries;
+    const keyed = ents.filter((e3) => e3.key !== null);
+    if (keyed.length === ents.length && ents.length === 1 && ents[0].edge !== "back") {
+      const e3 = ents[0];
+      const v = isPointer(e3.value) ? flowPtr(e3.value) : flowText(e3.value);
+      return `${keyText(e3.key)}: ${v}`;
+    }
+    if (keyed.length > 0) {
+      throw new LossyError("an inline !!<\u2026> schema holds at most one top-level key");
+    }
+  }
+  return flowText(n2);
+}
+function flowText(n2) {
+  if (n2.kind === "blob") throw new LossyError("a blob has no flow form");
+  if (n2.meta?.schema !== void 0 || n2.meta?.set === true) {
+    throw new LossyError("tags inside an inline !!<\u2026> schema are not serializable");
+  }
+  const ents = n2.entries ?? [];
+  if (n2.kind === "scalar") {
+    if (ents.length > 0) throw new LossyError("a value-plus-fields node has no flow form");
+    return flowTok(n2);
+  }
+  if (ents.length === 0) return n2.array ? "[]" : "{}";
+  const keyed = ents.filter((e3) => e3.key !== null);
+  if (keyed.length > 0 && keyed.length < ents.length) throw new LossyError("a mixed container has no flow form");
+  if (ents.some((e3) => e3.edge === "back")) throw new LossyError("back-edges inside an inline !!<\u2026> schema are not serializable");
+  const item = (e3) => {
+    const v = isPointer(e3.value) ? flowPtr(e3.value) : flowText(e3.value);
+    return e3.key === null ? v : `${flowKey(e3.key)}: ${v}`;
+  };
+  return keyed.length === 0 ? `[${ents.map(item).join(", ")}]` : `{${ents.map(item).join(", ")}}`;
+}
+function nonFinite(v) {
+  return Number.isNaN(v) ? ".nan" : v === Infinity ? ".inf" : "-.inf";
+}
+function flowTok(s2) {
+  const v = s2.value;
+  if (v === null) return "null";
+  if (typeof v === "boolean") return v ? "true" : "false";
+  if (typeof v === "number") {
+    if (!Number.isFinite(v)) return nonFinite(v);
+    return String(v);
+  }
+  if (v !== "" && /^[^,:[\]{}'"#\s]+$/.test(v) && !"*&~!|>".includes(v[0]) && plainScalar(v).value === v) return v;
+  if (/[\n\r\u0000-\u0008\u000b-\u001f\u007f]/.test(v)) throw new LossyError("a control character has no flow form inside a !!<\u2026> tag");
+  return `'${v.replace(/'/g, "''")}'`;
+}
+function flowPtr(p2) {
+  const compact2 = renderPointer(p2, { spaced: false });
+  if (/['"\s]/.test(compact2)) throw new LossyError(`pointer "*${compact2}" does not fit a flow context`);
+  return `*${compact2}`;
+}
+function flowKey(k) {
+  return /^[\w.$/-]+$/.test(k) ? k : `'${k.replace(/'/g, "''")}'`;
+}
 
 // ../engine/ts/src/rewrite.ts
 function under(p2, x2) {
@@ -65369,7 +65521,8 @@ function nominalPath(doc, e3) {
       if (up === null) return null;
       p2 = up === ":" ? "" : up;
     } else if (st.sel === "key") p2 += ":" + st.name;
-    else p2 += "[" + st.n + "]";
+    else if (st.sel === "index") p2 += "[" + st.n + "]";
+    else return null;
   }
   return p2 === "" ? ":" : p2;
 }
@@ -65556,7 +65709,9 @@ var DEFAULT_SETTINGS = {
   exports: [],
   annotations: ":annotations",
   tags: ":tags",
-  sidecars: "per-directory"
+  sidecars: "per-directory",
+  width: void 0,
+  theme: void 0
 };
 var DEFAULT_SETTINGS_SOURCE = `# .yamlover/settings.yamlover \u2014 project settings for this root (created with defaults).
 # Settings are DEFAULTS, never constraints: they only say where the server CREATES things when you
@@ -65569,6 +65724,7 @@ var DEFAULT_SETTINGS_SOURCE = `# .yamlover/settings.yamlover \u2014 project sett
 annotations: *:: annotations   # create new annotations in :annotations
 tags: *:: tags                 # create new tags in :tags
 sidecars: per-directory        # where derived thumbnail/crop blobs go (enum, not a path)
+# width: 100                   # reading width (ch) for prose views; browser settings override it
 `;
 function ensureSettingsFile(absRoot) {
   const file = path6.join(absRoot, ".yamlover", "settings.yamlover");
@@ -65592,9 +65748,20 @@ function loadSettings(absRoot) {
     exports: exportsSetting(valueAt(root, "exports")),
     annotations: locationSetting(valueAt(root, "annotations"), DEFAULT_SETTINGS.annotations),
     tags: locationSetting(valueAt(root, "tags"), DEFAULT_SETTINGS.tags),
-    sidecars: sidecarLocation(valueAt(root, "sidecars"), DEFAULT_SETTINGS.sidecars)
+    sidecars: sidecarLocation(valueAt(root, "sidecars"), DEFAULT_SETTINGS.sidecars),
+    width: intSetting(valueAt(root, "width"), 20, 400),
+    theme: enumSetting(valueAt(root, "theme"), ["dark", "light"])
   };
 }
+function intSetting(v, min, max) {
+  if (v === void 0 || isPointer(v) || v.kind !== "scalar") return void 0;
+  const n2 = typeof v.value === "number" ? v.value : NaN;
+  return Number.isInteger(n2) && n2 >= min && n2 <= max ? n2 : void 0;
+}
+function enumSetting(v, values) {
+  if (v === void 0 || isPointer(v) || v.kind !== "scalar") return void 0;
+  return values.includes(v.value) ? v.value : void 0;
+}
 function uriSetting(v) {
   if (v === void 0) return void 0;
   if (isPointer(v)) return v.base.scope === "link" ? v.base.authority : void 0;
@@ -65744,7 +65911,12 @@ function parsePortion(r2) {
   const test = parseValTest(r2);
   if (test !== null) return [test];
   const steps = parsePointer(r2).steps;
-  return steps.map((st) => st.sel === "key" ? { kind: "key", name: st.name } : st.sel === "index" ? { kind: "index", n: st.n } : { kind: "spine" });
+  return steps.map((st) => {
+    if (st.sel === "key") return { kind: "key", name: st.name };
+    if (st.sel === "index") return { kind: "index", n: st.n };
+    if (st.sel === "relindex") throw new SyntaxError('query: a relative index "[.\xB1k]" is a link step, not a query portion (URIs.md \xA7Relative indexes)');
+    return { kind: "spine" };
+  });
 }
 function parseValTest(r2) {
   const m = CMP.exec(r2);
@@ -66434,7 +66606,11 @@ function findGitRoot(start) {
 
 // src/server/node-kind.ts
 function ownedEntries(s2, p2) {
-  return s2.entries(p2).filter((e3) => e3.kind !== "back");
+  const own = s2.entries(p2).filter((e3) => e3.kind !== "back");
+  const unrealized = s2.unrealizedRefs(p2).filter((u2) => u2.edge !== "back");
+  if (unrealized.length === 0) return own;
+  for (const u2 of unrealized) own.push({ to: "", label: u2.label, pos: u2.pos, kind: "ref", raw: u2.raw });
+  return own.sort((a2, b) => (a2.pos ?? 0) - (b.pos ?? 0));
 }
 function displayKind(s2, p2, row) {
   const ents = ownedEntries(s2, p2);
@@ -66529,6 +66705,7 @@ function createHandlers(dataRoot, opts = {}) {
   const rootName = path10.basename(path10.resolve(dataRoot)) || "/";
   const dbPath = path10.join(dataRoot, ".yamlover", "index.db");
   const settingsFile = path10.join(dataRoot, ".yamlover", "settings.yamlover");
+  const settingsRel = path10.relative(dataRoot, settingsFile).split(path10.sep).join("/");
   if (opts.ensureSettings) {
     try {
       ensureSettingsFile(dataRoot);
@@ -66555,6 +66732,7 @@ function createHandlers(dataRoot, opts = {}) {
   };
   const broadcast = (diff2) => {
     if (diff2.added.length + diff2.changed.length + diff2.removed.length + diff2.moved.length === 0) return;
+    if (diff2.changed.includes(settingsRel) || diff2.added.includes(settingsRel)) settings = loadSettings(dataRoot);
     const toClient = (rel) => segsToStr(rel.split("/"));
     sseWrite({
       type: "diff",
@@ -66867,6 +67045,17 @@ function createHandlers(dataRoot, opts = {}) {
         ).then((body) => sendJson(res, 200, body)).catch((e3) => sendJson(res, 400, { error: String(e3.message || e3) }));
         return;
       }
+      if (req.method === "POST" && url.pathname === "/api/preview") {
+        readBody(req).then((data) => sendJson(res, 200, previewPayload(String(data.source ?? "")))).catch((e3) => sendJson(res, 400, { error: String(e3.message || e3) }));
+        return;
+      }
+      if (req.method === "POST" && url.pathname === "/api/edit-text") {
+        readBody(req).then((data) => {
+          const d = data;
+          sendJson(res, 200, { source: applyTextEdits(String(d.source ?? ""), Array.isArray(d.edits) ? d.edits : []) });
+        }).catch((e3) => sendJson(res, 400, { error: String(e3.message || e3) }));
+        return;
+      }
       if (req.method === "POST" && url.pathname === "/api/mv") {
         readBody(req).then(
           (data) => enqueue(async () => {
@@ -66912,20 +67101,6 @@ function createHandlers(dataRoot, opts = {}) {
         sendJson(res, 200, { source, settings, path: ":.yamlover:settings.yamlover" });
         return;
       }
-      if (req.method === "POST" && url.pathname === "/api/config") {
-        readBody(req).then(
-          (data) => enqueue(async () => {
-            const source = String(data?.source ?? "");
-            parseYamlover(source, settingsFile);
-            fs10.mkdirSync(path10.dirname(settingsFile), { recursive: true });
-            fs10.writeFileSync(settingsFile, source);
-            settings = loadSettings(dataRoot);
-            broadcast(await doReindexFile(settingsFile));
-            return { ok: true, settings };
-          })
-        ).then((body) => sendJson(res, 200, body)).catch((e3) => sendJson(res, 400, { error: String(e3.message || e3) }));
-        return;
-      }
       const segs = strToSegs(url.searchParams.get("path") || ":");
       const p2 = storePath(segs);
       const depth = parseDepth(url.searchParams.get("depth"));
@@ -67030,6 +67205,7 @@ function createHandlers(dataRoot, opts = {}) {
   return Object.assign(handler, {
     ready,
     close: () => {
+      if (closed) return;
       closed = true;
       stopWatch?.();
       for (const r2 of sseClients) r2.end();
@@ -67074,12 +67250,12 @@ var hasSubchapterChild = (s2, p2) => s2.children(p2).some((c3) => {
 });
 function downstreamEntries(s2, p2) {
   const isSet = !!s2.node(p2)?.meta?.set;
-  let own = s2.entries(p2).filter((e3) => e3.kind !== "back" && !(e3.kind === "contain" && isHidden(s2, e3.to)));
-  const seen = new Set(own.map((e3) => relKey(e3.label, e3.to)));
+  let own = ownedEntries(s2, p2).filter((e3) => !(e3.kind === "contain" && isHidden(s2, e3.to)));
+  const seen = new Set(own.map((e3) => relKey(e3.label, e3.to || e3.raw || "")));
   if (isSet) {
     const kept = /* @__PURE__ */ new Set();
     own = own.filter((e3) => {
-      const k = relKey(e3.label, e3.to);
+      const k = relKey(e3.label, e3.to || e3.raw || "");
       if (kept.has(k)) return false;
       kept.add(k);
       return true;
@@ -67108,6 +67284,7 @@ function projectValue(dataRoot, s2, segs, depth, top) {
   const currentDoc = documentRootSegs(s2, segs);
   const project = (c3) => {
     if (c3.kind === "contain") return projectValue(dataRoot, s2, [...segs, c3.label ?? c3.pos ?? 0], depth - 1, false);
+    if (!c3.to) return refMarker(c3.raw ?? "", null);
     const targetSegs = storePathToSegs(c3.to);
     return depth === Infinity ? refMarker(refPointerText(s2, targetSegs, currentDoc), segsToStr(targetSegs)) : linkMarker(dataRoot, s2, targetSegs);
   };
@@ -67115,6 +67292,7 @@ function projectValue(dataRoot, s2, segs, depth, top) {
   if (k === "omni" || k === "mix") {
     const entries = kids.map((c3) => ({ key: c3.label, value: project(c3) }));
     const marker = { kind: k, entries };
+    if (row.format) marker.format = row.format;
     if (k === "omni") {
       marker.value = row.type === "blob" ? binaryValueMarker(segs, row) : wireScalar(row.value);
       if (typeof row.meta?.selfAt === "number") marker.selfAt = row.meta.selfAt;
@@ -67145,8 +67323,25 @@ function irNodeAt(doc, segs) {
   }
   return node;
 }
+function scalarRawToken(node) {
+  if (isPointer(node) || node.kind !== "scalar") return void 0;
+  const raw = node.raw;
+  if (raw == null || raw.includes("\n")) return void 0;
+  const v = node.value;
+  if (typeof v === "string" && v.includes("\n")) return void 0;
+  const plain = v === null ? "null" : String(v);
+  return raw === plain ? void 0 : raw;
+}
 function tagOf(n2) {
-  return n2.meta?.set ? "!!set" : void 0;
+  const parts = [];
+  if (n2.meta?.schema !== void 0) {
+    try {
+      parts.push(schemaTagToken(n2.meta.schema));
+    } catch {
+    }
+  }
+  if (n2.meta?.set) parts.push("!!set");
+  return parts.length ? parts.join(" ") : void 0;
 }
 function nodeDeco(bucket, node) {
   const anchors = (node.meta?.anchors ?? []).map(anchorBody);
@@ -67163,7 +67358,9 @@ function collectComments(doc, segs, depth) {
   {
     const self2 = {};
     nodeDeco(self2, root);
-    if (self2.anchors || self2.tag || self2.valueTrailing) out[""] = self2;
+    const raw = scalarRawToken(root);
+    if (raw) self2.raw = raw;
+    if (self2.anchors || self2.tag || self2.valueTrailing || self2.raw) out[""] = self2;
   }
   const head = (root.meta?.head ?? []).map((c3) => c3.text);
   if (head.length > 0) out.$head = head;
@@ -67186,7 +67383,11 @@ function collectComments(doc, segs, depth) {
       const leadComment = e3.meta?.comments?.find((c3) => c3.placement === "leading");
       if (e3.meta?.blankBefore || leadComment?.blankBefore) bucket.blankBefore = true;
       if (isPointer(e3.value)) bucket.pointer = renderPointer(e3.value);
-      else nodeDeco(bucket, e3.value);
+      else {
+        nodeDeco(bucket, e3.value);
+        const raw = scalarRawToken(e3.value);
+        if (raw) bucket.raw = raw;
+      }
       if (Object.keys(bucket).length > 0) out[rel + cont] = bucket;
       if (e3.edge === "contain" && !isPointer(e3.value)) walk(e3.value, rel + cont, d - 1, false);
     }
@@ -67203,7 +67404,7 @@ function projectSchema(dataRoot, s2, segs, depth, top) {
   const schema = { type: typeName(s2, p2, row) };
   if (row.format) schema.format = row.format;
   const kids = downstreamEntries(s2, p2);
-  const sub = (c3) => c3.kind === "contain" ? projectSchema(dataRoot, s2, [...segs, c3.label ?? c3.pos ?? 0], depth - 1, false) : linkMarker(dataRoot, s2, storePathToSegs(c3.to));
+  const sub = (c3) => c3.kind === "contain" ? projectSchema(dataRoot, s2, [...segs, c3.label ?? c3.pos ?? 0], depth - 1, false) : c3.to ? linkMarker(dataRoot, s2, storePathToSegs(c3.to)) : refMarker(c3.raw ?? "", null);
   if (k === "object" || k === "mix" || k === "omni") {
     const props = {};
     for (const c3 of kids) props[c3.label ?? `[${c3.pos}]`] = sub(c3);
@@ -67235,7 +67436,9 @@ function linkMarker(dataRoot, s2, segs) {
   else if (k === "omni" || k === "mix") {
     info.count = ownedEntries(s2, p2).length;
     if (k === "omni") info.value = wireScalar(row.value);
-  } else info.count = s2.children(p2).filter((c3) => !isHidden(s2, c3.to)).length;
+  } else {
+    info.count = ownedEntries(s2, p2).filter((e3) => !(e3.kind === "contain" && isHidden(s2, e3.to))).length;
+  }
   if (row.format === TAG_FORMAT) {
     const c3 = s2.node(p2 + ":color")?.value;
     if (typeof c3 === "string") info.color = c3;
@@ -67318,7 +67521,13 @@ function chapterOrderedChildren(s2, p2, format) {
   const bodyPos = /* @__PURE__ */ new Map();
   for (const e3 of s2.entries(p2)) if (e3.kind === "ref" && !bodyPos.has(e3.to)) bodyPos.set(e3.to, e3.pos ?? 0);
   if (bodyPos.size === 0) return kids;
-  const key = (c3) => bodyPos.get(c3.to) ?? c3.pos ?? 0;
+  const maxPos = Math.max(...bodyPos.values(), ...kids.map((c3) => c3.pos ?? 0));
+  const key = (c3) => {
+    const bp = bodyPos.get(c3.to);
+    if (bp != null) return bp;
+    if (c3.label != null) return maxPos + 1 + (c3.pos ?? 0);
+    return c3.pos ?? 0;
+  };
   return kids.map((c3, i2) => ({ c: c3, i: i2 })).sort((a2, b) => key(a2.c) - key(b.c) || a2.i - b.i).map((x2) => x2.c);
 }
 function labelFor(s2, p2, keyOrIdx) {
@@ -67663,16 +67872,24 @@ function nearestDirSegs(dataRoot, segs) {
   }
   return null;
 }
-function chapterSource(dataRoot, s2, segs) {
+var YAMLOVER_ONLY = /\.yamlover$/i;
+var BLOCK_YAML = /\.(ya?ml|yamlover)$/i;
+var JSON_FILE = /\.(json|json5|json5p)$/i;
+function resolveBacking(dataRoot, s2, segs) {
   const docSegs = documentRootSegs(s2, segs);
   const docFs = path10.resolve(dataRoot, ...docSegs.map(String));
   const dirBacked = fs10.existsSync(docFs) && fs10.statSync(docFs).isDirectory();
   const bodyFile = dirBacked ? path10.join(docFs, ".yamlover", "body.yamlover") : docFs;
-  if (!bodyFile.endsWith(".yamlover") || !fs10.existsSync(bodyFile)) {
-    throw new Error("unsupported chapter source (need a .yamlover body)");
-  }
   return { docSegs, bodyFile, dirBacked };
 }
+function chapterSource(dataRoot, s2, segs, allow = YAMLOVER_ONLY) {
+  const r2 = resolveBacking(dataRoot, s2, segs);
+  const okExt = r2.dirBacked ? r2.bodyFile.endsWith(".yamlover") : allow.test(r2.bodyFile);
+  if (!okExt || !fs10.existsSync(r2.bodyFile)) {
+    throw new Error("unsupported edit source (need a .yamlover / .yaml / .yml body)");
+  }
+  return r2;
+}
 function pasteIntoChapter(dataRoot, s2, segs, name, bytes) {
   const { docSegs, bodyFile, dirBacked } = chapterSource(dataRoot, s2, segs);
   const writeDirSegs = dirBacked ? docSegs : docSegs.slice(0, -1);
@@ -67902,8 +68119,11 @@ function textChunkLines(text, indent) {
 function chapterEntries(lines, r2) {
   const starts = [];
   if (r2.marker >= 0) {
-    const inline = lines[r2.marker].replace(/^\s*-\s*/, "");
-    if (inline.trim()) starts.push({ key: /^-/.test(inline) ? null : inline.match(/^([^:\s]+):/)?.[1] ?? null, start: r2.marker, inline: true });
+    const raw = lines[r2.marker].replace(/^\s*/, "");
+    if (raw === "-" || raw.startsWith("- ")) {
+      const inline = raw.replace(/^-\s*/, "").replace(/^!!<[^>]*>\s*/, "");
+      if (inline.trim()) starts.push({ key: /^-/.test(inline) ? null : inline.match(/^([^:\s]+):/)?.[1] ?? null, start: r2.marker, inline: true });
+    }
   }
   for (let i2 = r2.lo; i2 < r2.hi; i2++) {
     if (!isContentLine2(lines[i2])) continue;
@@ -67934,7 +68154,8 @@ function entryHead(lines, e3) {
 function isContainerEntry(lines, e3, childIndent) {
   const head = entryHead(lines, e3);
   if (/^[|>][+-]?\d*$/.test(head.trim())) return itemHasFields(lines, e3, childIndent);
-  if (/^[^\s"'*|>#-][^:]*:(\s|$)/.test(head)) return true;
+  const bare = head.replace(/\s+#.*$/, "");
+  if (/^[^\s"'*|>#-][^:]*:(\s|$)/.test(bare)) return true;
   for (let i2 = e3.start + 1; i2 < e3.end; i2++) {
     if (!isContentLine2(lines[i2])) continue;
     const ind = indentOf2(lines[i2]);
@@ -68140,6 +68361,76 @@ function setRootTag(lines, meta) {
   if (existing >= 0) lines[existing] = `!!<${meta}>`;
   else lines.splice(Math.max(at, 0), 0, `!!<${meta}>`);
 }
+function flowValueStart(raw, e3) {
+  let i2 = indentOf2(raw);
+  if (raw.startsWith("- ", i2)) i2 += 2;
+  while (raw[i2] === " ") i2++;
+  if (raw.startsWith("!!<", i2)) {
+    const gt = raw.indexOf(">", i2);
+    if (gt < 0) return -1;
+    i2 = gt + 1;
+    while (raw[i2] === " ") i2++;
+  }
+  if (e3.key !== null) {
+    const c3 = raw.indexOf(":", i2);
+    if (c3 < 0) return -1;
+    i2 = c3 + 1;
+    while (raw[i2] === " ") i2++;
+  }
+  return raw[i2] === "[" ? i2 : -1;
+}
+function scanFlowSeq(s2, open) {
+  let depth = 0;
+  let q = null;
+  const cells = [];
+  let cellStart = open + 1;
+  for (let j = open; j < s2.length; j++) {
+    const ch = s2[j];
+    if (q) {
+      if (ch === q) {
+        if (q === "'" && s2[j + 1] === "'") j++;
+        else q = null;
+      }
+      continue;
+    }
+    if (ch === "'" || ch === '"') q = ch;
+    else if (ch === "[") depth++;
+    else if (ch === "]") {
+      depth--;
+      if (depth === 0) {
+        if (j > open + 1 || s2.slice(open + 1, j).trim().length) cells.push({ start: cellStart, end: j });
+        return { close: j, cells };
+      }
+    } else if (ch === "," && depth === 1) {
+      cells.push({ start: cellStart, end: j });
+      cellStart = j + 1;
+    }
+  }
+  return null;
+}
+function flowCellToken(s2) {
+  const plain = s2.length > 0 && s2 === s2.trim() && !/[\s,[\]:#'"{}]/.test(s2) && !/^[*&\-|>!]/.test(s2);
+  return plain ? s2 : `'${s2.replace(/'/g, "''")}'`;
+}
+function editFlowRowCell(lines, row, cellIdx, op, valueSrc) {
+  const raw = lines[row.start];
+  const open = flowValueStart(raw, row);
+  if (open < 0) return false;
+  const scan2 = scanFlowSeq(raw, open);
+  if (!scan2) return false;
+  if (op !== "emplace" && op !== "replace") throw new Error(`a flow-row cell supports emplace/replace only (got \`${op}\`)`);
+  const payload = payloadFacets(valueSrc);
+  if (payload.scalar === void 0) throw new Error("a flow-row cell takes a scalar value");
+  const parsed = parseYamlover(payload.scalar, "cell").root;
+  if (parsed.kind !== "scalar") throw new Error("a flow-row cell takes a scalar value");
+  const text = String(parsed.value ?? "");
+  if (text.includes("\n")) throw new Error("a flow-row cell cannot hold multi-line text \u2014 rewrite the row in block form (TABLE.md)");
+  const cell = scan2.cells[cellIdx];
+  if (!cell) throw new Error(`no cell [${cellIdx}] in the flow row (${scan2.cells.length} cells)`);
+  const lead = cellIdx === 0 ? "" : " ";
+  lines[row.start] = raw.slice(0, cell.start) + lead + flowCellToken(text) + raw.slice(cell.end);
+  return true;
+}
 function editChapterSource(src, within, op, valueSrc, meta) {
   const lines = src.split("\n");
   if (within.length === 0) {
@@ -68153,9 +68444,62 @@ function editChapterSource(src, within, op, valueSrc, meta) {
     }
     throw new Error(`\`${op}\` at a document root needs a key or index target`);
   }
+  const last = within[within.length - 1];
+  if (within.length >= 2 && typeof last === "number") {
+    const parentR = reachChapter(lines, within.slice(0, -2));
+    const rowEntry = findEntry(lines, parentR, within[within.length - 2]);
+    if (rowEntry && !isContainerEntry(lines, rowEntry, parentR.indent + 2) && editFlowRowCell(lines, rowEntry, last, op, valueSrc)) {
+      return lines.join("\n");
+    }
+  }
   assignAt(lines, reachChapter(lines, within.slice(0, -1)), within[within.length - 1], op, valueSrc, meta);
   return lines.join("\n");
 }
+function jsonValueSpan(src, es, ee) {
+  const last = src[ee - 1];
+  if (last === '"' || last === "'") {
+    for (let j2 = ee - 2; j2 >= es; j2--) {
+      if (src[j2] !== last) continue;
+      let bs = 0;
+      for (let k = j2 - 1; k >= es && src[k] === "\\"; k--) bs++;
+      if (bs % 2 === 0) return [j2, ee];
+    }
+    throw new Error("could not locate the string value in the source");
+  }
+  let j = ee;
+  while (j > es && !/[\s,:{}[\]]/.test(src[j - 1])) j--;
+  return [j, ee];
+}
+function yamloverScalarToJsonToken(valueSrc) {
+  const root = parseYamlover(valueSrc, "<edit>").root;
+  if (root.kind !== "scalar") throw new Error("only a scalar value is editable in a JSON file");
+  const v = root.value;
+  if (v === null) return "null";
+  if (typeof v === "boolean") return v ? "true" : "false";
+  if (typeof v === "number") return /^[-+]?(\d+\.?\d*|\.\d+)([eE][-+]?\d+)?$/.test(root.raw) ? root.raw : String(v);
+  return JSON.stringify(v);
+}
+function editJsonScalar(src, within, token) {
+  if (within.length === 0) throw new Error("cannot edit the JSON document root as a scalar value");
+  let node = parseJson5p(src, "<edit>").root;
+  for (let k = 0; k < within.length; k++) {
+    const seg = within[k];
+    const entries = node.entries ?? [];
+    const entry = typeof seg === "number" ? entries.filter((e3) => e3.edge === "contain" && e3.key === null)[seg] : entries.find((e3) => e3.edge === "contain" && e3.key === seg);
+    if (!entry) throw new Error(`no entry at ${typeof seg === "number" ? `[${seg}]` : seg}`);
+    const value = entry.value;
+    if (k === within.length - 1) {
+      if (isPointer(value) || value.kind !== "scalar") throw new Error("only a scalar value is editable in a JSON file");
+      const span = entry.meta?.span;
+      if (!span) throw new Error("no source span for the target value");
+      const [vs, ve] = jsonValueSpan(src, span.start, span.end);
+      return src.slice(0, vs) + token + src.slice(ve);
+    }
+    if (isPointer(value) || value.kind !== "mapping") throw new Error(`cannot descend into a non-container at ${typeof seg === "number" ? `[${seg}]` : seg}`);
+    node = value;
+  }
+  throw new Error("empty JSON edit path");
+}
 var isPointerValue = (src) => /^\*\S*$/.test(src.trim()) && !src.includes("\n");
 function isPlainDir(dataRoot, s2, segs) {
   if (!segs.every((g) => typeof g === "string")) return false;
@@ -68178,6 +68522,7 @@ function bornAsDocument(dataRoot, e3, tag) {
 }
 function applyEdits2(dataRoot, s2, edits) {
   const byFile = /* @__PURE__ */ new Map();
+  const jsonByFile = /* @__PURE__ */ new Map();
   const appended = [];
   const created = [];
   for (const e3 of edits) {
@@ -68191,7 +68536,15 @@ function applyEdits2(dataRoot, s2, edits) {
       created.push(segsToStr([...editSegs, final]));
       continue;
     }
-    const { docSegs, bodyFile, dirBacked } = chapterSource(dataRoot, s2, editSegs);
+    const backing = resolveBacking(dataRoot, s2, editSegs);
+    if (!backing.dirBacked && JSON_FILE.test(backing.bodyFile)) {
+      if (op !== "emplace") throw new Error("only scalar value edits (emplace) are supported for JSON files");
+      const jlist = jsonByFile.get(backing.bodyFile) ?? [];
+      jlist.push({ within: editSegs.slice(backing.docSegs.length), valueSrc: String(e3.yamlover ?? "") });
+      jsonByFile.set(backing.bodyFile, jlist);
+      continue;
+    }
+    const { docSegs, bodyFile, dirBacked } = chapterSource(dataRoot, s2, editSegs, BLOCK_YAML);
     if (op === "insert" && !e3.concrete?.includes("/")) {
       const last = editSegs[editSegs.length - 1];
       if (typeof last !== "number") appended.push(editSegs);
@@ -68232,8 +68585,55 @@ function applyEdits2(dataRoot, s2, edits) {
     fs10.writeFileSync(bodyFile, src);
     touched.push(bodyFile);
   }
+  for (const [file, jedits] of jsonByFile) {
+    let src = fs10.readFileSync(file, "utf8");
+    for (const j of jedits) {
+      src = editJsonScalar(src, j.within, yamloverScalarToJsonToken(j.valueSrc));
+    }
+    fs10.writeFileSync(file, src);
+    touched.push(file);
+  }
   return { touched, created, appended };
 }
+var PREVIEW_ROOT = path10.join(os.tmpdir(), ".yamlover-preview-nonexistent");
+function previewPayload(source) {
+  const doc = parseYamlover(source, "<preview>");
+  doc.root.meta = { ...doc.root.meta, documentRoot: true, ...doc.head?.length ? { head: doc.head } : {} };
+  const s2 = new Store(":memory:");
+  try {
+    s2.indexDocument(doc);
+    const row = s2.node(":");
+    return {
+      path: ":",
+      type: tocType(s2, ":", row),
+      format: row.format ?? null,
+      ...facetsOf(s2, ":", row),
+      concrete: "yamlover",
+      // by construction — the document IS yamlover text
+      documentPath: ":",
+      title: titleOf(s2, ":"),
+      description: descriptionOf(s2, ":"),
+      value: projectValue(PREVIEW_ROOT, s2, [], Infinity, true),
+      comments: collectComments(doc, [], Infinity),
+      relations: {}
+      // a standalone document has no project around it
+    };
+  } finally {
+    s2.close();
+  }
+}
+function applyTextEdits(src, edits) {
+  let out = src;
+  for (const e3 of edits) {
+    if (e3.concrete || e3.name) throw new Error("`concrete`/`name` are only for file-backed edits");
+    const valueSrc = String(e3.yamlover ?? "");
+    const meta = e3.meta === void 0 ? void 0 : e3.meta === null ? null : String(e3.meta);
+    if (valueSrc && !isPointerValue(valueSrc)) parseYamlover(valueSrc, "<edit>");
+    out = editChapterSource(out, strToSegs(String(e3.path ?? "")), String(e3.op ?? ""), valueSrc, meta);
+  }
+  parseYamlover(out, "<edit-result>");
+  return out;
+}
 function firstContentIndent2(lines) {
   for (const l2 of lines) if (isContentLine2(l2)) return indentOf2(l2);
   return 0;
@@ -68354,8 +68754,10 @@ function notFound(res, url) {
   sendJson(res, 404, { error: `no such node/endpoint: ${url.pathname}?${url.searchParams}` });
 }
 export {
+  applyTextEdits,
   createHandlers,
-  mergeAgentDoc
+  mergeAgentDoc,
+  previewPayload
 };
 /*! Bundled license information: