@june-ai/june-ui 0.2.5 → 0.2.6

package/dist/index.cjs

@@ -145,6 +145,184 @@ var init_document_utils = __esm({
   }
 });
 
+// src/components/document-editor/document-pagination.ts
+function gapWidget(height) {
+  return () => {
+    const el = document.createElement("div");
+    el.className = "june-doc__page-gap";
+    el.contentEditable = "false";
+    el.setAttribute("aria-hidden", "true");
+    el.style.height = `${height}px`;
+    return el;
+  };
+}
+function build(doc, breaks) {
+  return import_view.DecorationSet.create(
+    doc,
+    breaks.map(
+      (b) => import_view.Decoration.widget(b.pos, gapWidget(b.height), {
+        side: -1,
+        ignoreSelection: true,
+        key: `jd-gap-${b.pos}-${Math.round(b.height)}`
+      })
+    )
+  );
+}
+function collectUnits(doc) {
+  const units = [];
+  const walk = (parent, start, inheritedBreak) => {
+    parent.forEach((child, offset, index) => {
+      const pos = start + offset;
+      const breakPos = index === 0 && inheritedBreak !== null ? inheritedBreak : pos;
+      if (SPLITTABLE.has(child.type.name) && child.childCount > 0) {
+        walk(child, pos + 1, breakPos);
+      } else {
+        units.push({ pos, breakPos, node: child });
+      }
+    });
+  };
+  walk(doc, 0, null);
+  return units;
+}
+function measure(view, cfg) {
+  const prose = view.dom;
+  const proseRect = prose.getBoundingClientRect();
+  const scale = prose.offsetWidth ? proseRect.width / prose.offsetWidth : 1;
+  if (!scale || !proseRect.width) return { breaks: [], pages: 1 };
+  const gaps = [...prose.querySelectorAll(".june-doc__page-gap")].map((g) => {
+    const r = g.getBoundingClientRect();
+    return { top: (r.top - proseRect.top) / scale, height: r.height / scale };
+  });
+  const gapsAbove = (y) => gaps.reduce((sum, g) => g.top <= y + 0.5 ? sum + g.height : sum, 0);
+  const contentH = Math.max(80, cfg.pageHeight - cfg.padTop - cfg.padBottom);
+  const stride = cfg.pageHeight + cfg.gap;
+  const breaks = /* @__PURE__ */ new Map();
+  let pageStart = 0;
+  let added = 0;
+  let force = false;
+  for (const unit of collectUnits(view.state.doc)) {
+    const el = view.nodeDOM(unit.pos);
+    if (!(el instanceof HTMLElement)) continue;
+    const r = el.getBoundingClientRect();
+    const rawTop = (r.top - proseRect.top) / scale;
+    const natural = rawTop - gapsAbove(rawTop);
+    const h = r.height / scale;
+    let top = natural + added;
+    let bottom = top + h;
+    const overflows = bottom > pageStart + contentH + 0.5 && top > pageStart + 1;
+    if (force || overflows) {
+      const target = pageStart + stride;
+      if (top < target) {
+        const spacer = target - top;
+        breaks.set(unit.breakPos, (breaks.get(unit.breakPos) ?? 0) + spacer);
+        added += spacer;
+        top = target;
+        bottom = top + h;
+      }
+      pageStart = target;
+      while (top >= pageStart + stride) pageStart += stride;
+      force = false;
+    }
+    while (bottom > pageStart + contentH + 0.5) pageStart += stride;
+    if (unit.node.type.name === "pageBreak") force = true;
+  }
+  const pages = Math.max(1, Math.round(pageStart / stride) + 1 + (force ? 1 : 0));
+  return {
+    breaks: [...breaks].map(([pos, height]) => ({ pos, height: Math.round(height * 10) / 10 })).sort((a, b) => a.pos - b.pos),
+    pages
+  };
+}
+function setPaginationConfig(editor, cfg) {
+  if (editor.isDestroyed) return;
+  const prev = configs.get(editor.view);
+  configs.set(editor.view, cfg);
+  if (!prev || prev.enabled !== cfg.enabled || prev.pageHeight !== cfg.pageHeight || prev.gap !== cfg.gap || prev.padTop !== cfg.padTop || prev.padBottom !== cfg.padBottom) {
+    remeasurePagination(editor);
+  }
+}
+function remeasurePagination(editor) {
+  if (editor.isDestroyed) return;
+  const s = paginationKey.getState(editor.state);
+  if (!s) return;
+  editor.view.dispatch(editor.state.tr.setMeta(paginationKey, { remeasure: true }).setMeta("addToHistory", false));
+}
+function getPageCount(editor) {
+  return editor && paginationKey.getState(editor.state)?.pages || 1;
+}
+var import_core, import_state, import_view, paginationKey, configs, SPLITTABLE, same2, DocumentPagination;
+var init_document_pagination = __esm({
+  "src/components/document-editor/document-pagination.ts"() {
+    "use strict";
+    import_core = require("@tiptap/core");
+    import_state = require("@tiptap/pm/state");
+    import_view = require("@tiptap/pm/view");
+    paginationKey = new import_state.PluginKey("juneDocPagination");
+    configs = /* @__PURE__ */ new WeakMap();
+    SPLITTABLE = /* @__PURE__ */ new Set(["bulletList", "orderedList", "listItem", "blockquote"]);
+    same2 = (a, b) => a.length === b.length && a.every((x, i) => x.pos === b[i].pos && Math.abs(x.height - b[i].height) < 1);
+    DocumentPagination = import_core.Extension.create({
+      name: "juneDocPagination",
+      addProseMirrorPlugins() {
+        return [
+          new import_state.Plugin({
+            key: paginationKey,
+            state: {
+              init: () => ({ breaks: [], pages: 1, decorations: import_view.DecorationSet.empty, epoch: 0 }),
+              apply(tr, prev, _old, state) {
+                const meta = tr.getMeta(paginationKey);
+                if (meta?.remeasure) return { ...prev, epoch: prev.epoch + 1 };
+                if (meta?.breaks) {
+                  return { ...prev, breaks: meta.breaks, pages: meta.pages ?? prev.pages, decorations: build(state.doc, meta.breaks) };
+                }
+                if (tr.docChanged) {
+                  const breaks = prev.breaks.map((b) => ({ ...b, pos: tr.mapping.map(b.pos, -1) })).filter((b) => b.pos >= 0 && b.pos <= state.doc.content.size);
+                  return { ...prev, breaks, decorations: prev.decorations.map(tr.mapping, tr.doc) };
+                }
+                return prev;
+              }
+            },
+            props: {
+              decorations: (state) => paginationKey.getState(state)?.decorations
+            },
+            view(view) {
+              let frame = null;
+              let rounds = 0;
+              const schedule = (reset) => {
+                if (reset) rounds = 0;
+                if (frame !== null || typeof window === "undefined") return;
+                const raf = window.requestAnimationFrame ?? ((cb) => window.setTimeout(() => cb(0), 16));
+                frame = raf(() => {
+                  frame = null;
+                  if (view.isDestroyed) return;
+                  const cfg = configs.get(view);
+                  const current = paginationKey.getState(view.state);
+                  if (!current) return;
+                  const next = cfg?.enabled ? measure(view, cfg) : { breaks: [], pages: 1 };
+                  if (same2(next.breaks, current.breaks) && next.pages === current.pages) return;
+                  if (++rounds > 4) return;
+                  view.dispatch(view.state.tr.setMeta(paginationKey, next).setMeta("addToHistory", false));
+                });
+              };
+              schedule(true);
+              return {
+                update(v, prevState) {
+                  const pg = paginationKey.getState(v.state);
+                  const prevPg = paginationKey.getState(prevState);
+                  if (v.state.doc !== prevState.doc || pg?.epoch !== prevPg?.epoch) schedule(true);
+                  else if (pg !== prevPg) schedule(false);
+                },
+                destroy() {
+                  frame = null;
+                }
+              };
+            }
+          })
+        ];
+      }
+    });
+  }
+});
+
 // src/components/document-editor/document-search.ts
 function findMatches(doc, term, caseSensitive) {
   if (!term) return [];
@@ -174,13 +352,13 @@ function findMatches(doc, term, caseSensitive) {
   });
   return out;
 }
-function build(doc, term, caseSensitive, current) {
+function build2(doc, term, caseSensitive, current) {
   const matches = findMatches(doc, term, caseSensitive);
   const active = matches.length ? Math.min(Math.max(current, 0), matches.length - 1) : -1;
-  const decorations = import_view.DecorationSet.create(
+  const decorations = import_view2.DecorationSet.create(
     doc,
     matches.map(
-      (m, i) => import_view.Decoration.inline(m.from, m.to, {
+      (m, i) => import_view2.Decoration.inline(m.from, m.to, {
         class: i === active ? "june-doc__match june-doc__match--active" : "june-doc__match"
       })
     )
@@ -226,27 +404,27 @@ function replaceAll(editor, replacement) {
   }).run();
   return matches.length;
 }
-var import_core, import_state, import_view, searchKey, DocumentSearch;
+var import_core2, import_state2, import_view2, searchKey, DocumentSearch;
 var init_document_search = __esm({
   "src/components/document-editor/document-search.ts"() {
     "use strict";
-    import_core = require("@tiptap/core");
-    import_state = require("@tiptap/pm/state");
-    import_view = require("@tiptap/pm/view");
-    searchKey = new import_state.PluginKey("juneDocSearch");
-    DocumentSearch = import_core.Extension.create({
+    import_core2 = require("@tiptap/core");
+    import_state2 = require("@tiptap/pm/state");
+    import_view2 = require("@tiptap/pm/view");
+    searchKey = new import_state2.PluginKey("juneDocSearch");
+    DocumentSearch = import_core2.Extension.create({
       name: "juneDocSearch",
       addProseMirrorPlugins() {
         return [
-          new import_state.Plugin({
+          new import_state2.Plugin({
             key: searchKey,
             state: {
-              init: () => ({ term: "", caseSensitive: false, current: -1, matches: [], decorations: import_view.DecorationSet.empty }),
+              init: () => ({ term: "", caseSensitive: false, current: -1, matches: [], decorations: import_view2.DecorationSet.empty }),
               apply(tr, prev, _old, state) {
                 const meta = tr.getMeta(searchKey);
                 if (!meta && !tr.docChanged) return prev;
                 if (!meta && !prev.term) return prev;
-                return build(
+                return build2(
                   state.doc,
                   meta?.term ?? prev.term,
                   meta?.caseSensitive ?? prev.caseSensitive,
@@ -288,14 +466,16 @@ function createDocumentExtensions() {
     }),
     PageBreak,
     DocumentSearch,
+    DocumentPagination,
+    // inactive until the live editor sets a page geometry
     import_markdown.Markdown
   ];
 }
-var import_core2, import_extension_highlight, import_extension_image, import_extension_subscript, import_extension_superscript, import_extension_table, import_extension_text_align, import_extension_text_style, import_markdown, import_starter_kit, PageBreak;
+var import_core3, import_extension_highlight, import_extension_image, import_extension_subscript, import_extension_superscript, import_extension_table, import_extension_text_align, import_extension_text_style, import_markdown, import_starter_kit, PageBreak;
 var init_document_extensions = __esm({
   "src/components/document-editor/document-extensions.ts"() {
     "use strict";
-    import_core2 = require("@tiptap/core");
+    import_core3 = require("@tiptap/core");
     import_extension_highlight = __toESM(require("@tiptap/extension-highlight"), 1);
     import_extension_image = __toESM(require("@tiptap/extension-image"), 1);
     import_extension_subscript = __toESM(require("@tiptap/extension-subscript"), 1);
@@ -305,8 +485,9 @@ var init_document_extensions = __esm({
     import_extension_text_style = require("@tiptap/extension-text-style");
     import_markdown = require("@tiptap/markdown");
     import_starter_kit = __toESM(require("@tiptap/starter-kit"), 1);
+    init_document_pagination();
     init_document_search();
-    PageBreak = import_core2.Node.create({
+    PageBreak = import_core3.Node.create({
       name: "pageBreak",
       group: "block",
       atom: true,
@@ -317,7 +498,7 @@ var init_document_extensions = __esm({
       renderHTML({ HTMLAttributes }) {
         return [
           "div",
-          (0, import_core2.mergeAttributes)(HTMLAttributes, {
+          (0, import_core3.mergeAttributes)(HTMLAttributes, {
             "data-page-break": "true",
             class: "june-doc__page-break",
             style: "break-after: page; page-break-after: always;"
@@ -348,7 +529,7 @@ __export(document_engine_exports, {
 });
 function scratchEditor() {
   if (!scratch || scratch.isDestroyed) {
-    scratch = new import_core3.Editor({ extensions: createDocumentExtensions(), content: "" });
+    scratch = new import_core4.Editor({ extensions: createDocumentExtensions(), content: "" });
   }
   return scratch;
 }
@@ -374,11 +555,11 @@ function load(doc) {
   editor.commands.setContent(doc, { emitUpdate: false });
   return editor;
 }
-var import_core3, scratch, docToHtml, docToMarkdown, docToText;
+var import_core4, scratch, docToHtml, docToMarkdown, docToText;
 var init_document_engine = __esm({
   "src/components/document-editor/document-engine.ts"() {
     "use strict";
-    import_core3 = require("@tiptap/core");
+    import_core4 = require("@tiptap/core");
     init_errors();
     init_document_extensions();
     init_document_utils();
@@ -418,17 +599,21 @@ __export(index_exports, {
   getDefaultDocumentStore: () => getDefaultDocumentStore,
   getDocumentEditorInstructions: () => getDocumentEditorInstructions,
   getDocumentEditorRules: () => getDocumentEditorRules,
+  isDocumentEcho: () => isDocumentEcho,
   isJuneError: () => isJuneError,
   jsonFieldExtractor: () => jsonFieldExtractor,
   juneLibrary: () => juneLibrary,
   lightTheme: () => lightTheme,
   listDocumentExporters: () => listDocumentExporters,
   mergeDocuments: () => mergeDocuments,
+  readDocumentFromProgram: () => readDocumentFromProgram,
   registerDocumentExporter: () => registerDocumentExporter,
+  rememberDocumentEcho: () => rememberDocumentEcho,
   runAction: () => runAction,
   serializeDocumentsForAgent: () => serializeDocumentsForAgent,
   sseToText: () => sseToText,
   toJuneError: () => toJuneError,
+  updateDocumentInProgram: () => updateDocumentInProgram,
   useDocumentOptions: () => useDocumentOptions,
   useJuneRuntime: () => useJuneRuntime,
   useJuneStream: () => useJuneStream,
@@ -511,9 +696,321 @@ var JuneDocumentContext = (0, import_react.createContext)({});
 function useDocumentOptions() {
   return (0, import_react.useContext)(JuneDocumentContext);
 }
-function useDocumentValue(store, id, selector) {
-  const read = () => selector(store.get(id));
-  return (0, import_react.useSyncExternalStore)(store.subscribe, read, read);
+function useDocumentValue(store, id, selector) {
+  const read = () => selector(store.get(id));
+  return (0, import_react.useSyncExternalStore)(store.subscribe, read, read);
+}
+
+// src/components/document-editor/document-merge.ts
+init_document_utils();
+var MAX_CELLS = 4e6;
+function matchIndices(a, b) {
+  const n = a.length;
+  const m = b.length;
+  if (n * m > MAX_CELLS) return null;
+  const dp = Array.from({ length: n + 1 }, () => new Uint32Array(m + 1));
+  for (let i2 = n - 1; i2 >= 0; i2--) {
+    for (let j2 = m - 1; j2 >= 0; j2--) {
+      dp[i2][j2] = a[i2] === b[j2] ? dp[i2 + 1][j2 + 1] + 1 : Math.max(dp[i2 + 1][j2], dp[i2][j2 + 1]);
+    }
+  }
+  const matches = /* @__PURE__ */ new Map();
+  let i = 0;
+  let j = 0;
+  while (i < n && j < m) {
+    if (a[i] === b[j]) {
+      matches.set(i, j);
+      i++;
+      j++;
+    } else if (dp[i + 1][j] >= dp[i][j + 1]) i++;
+    else j++;
+  }
+  return matches;
+}
+var same = (x, y) => x.length === y.length && x.every((v, i) => v === y[i]);
+function mergeBlocks(base, local, incoming) {
+  if (same(local, base)) return { blocks: incoming, conflicts: 0 };
+  if (same(incoming, base) || same(local, incoming)) return { blocks: local, conflicts: 0 };
+  const ml = matchIndices(base, local);
+  const mn = matchIndices(base, incoming);
+  if (!ml || !mn) return { blocks: null, conflicts: 1 };
+  const anchors = [...ml.keys()].filter((i) => mn.has(i)).sort((x, y) => x - y);
+  const out = [];
+  let conflicts = 0;
+  let pb = -1;
+  let pl = -1;
+  let pn = -1;
+  const region = (bEnd, lEnd, nEnd) => {
+    const B = base.slice(pb + 1, bEnd);
+    const L = local.slice(pl + 1, lEnd);
+    const N = incoming.slice(pn + 1, nEnd);
+    if (B.length === L.length && L.length === N.length) {
+      for (let k = 0; k < B.length; k++) {
+        if (L[k] === B[k]) out.push(N[k]);
+        else if (N[k] === B[k] || N[k] === L[k]) out.push(L[k]);
+        else {
+          conflicts++;
+          out.push(L[k]);
+        }
+      }
+      return;
+    }
+    if (same(L, B)) out.push(...N);
+    else if (same(N, B) || same(L, N)) out.push(...L);
+    else {
+      conflicts++;
+      out.push(...L);
+    }
+  };
+  for (const a of anchors) {
+    const la = ml.get(a);
+    const na = mn.get(a);
+    region(a, la, na);
+    out.push(local[la]);
+    pb = a;
+    pl = la;
+    pn = na;
+  }
+  region(base.length, local.length, incoming.length);
+  return { blocks: out, conflicts };
+}
+function mergeDocuments(base, local, incoming) {
+  const toBlocks = (d) => (d.content ?? []).map((node) => JSON.stringify(node));
+  const { blocks: blocks2, conflicts } = mergeBlocks(toBlocks(base), toBlocks(local), toBlocks(incoming));
+  if (!blocks2) return { doc: local, conflicts: Math.max(1, conflicts) };
+  if (blocks2.length === 0) return { doc: emptyDoc(), conflicts };
+  return { doc: { type: "doc", content: blocks2.map((b) => JSON.parse(b)) }, conflicts };
+}
+
+// src/components/document-editor/document-store.ts
+init_document_utils();
+var incomingKey = (doc) => JSON.stringify([doc.title, docKey(doc.json)]);
+function createDocumentStore() {
+  const records = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  const emit = () => listeners.forEach((listener) => listener());
+  const put = (record) => {
+    records.set(record.id, record);
+    emit();
+  };
+  const fresh2 = (doc) => ({
+    id: doc.id,
+    title: doc.title,
+    documentType: doc.documentType,
+    status: doc.status,
+    json: doc.json,
+    baseJson: doc.json,
+    baseTitle: doc.title,
+    lastIncomingKey: incomingKey(doc),
+    revision: 0,
+    origin: "external",
+    pending: null,
+    updatedAt: Date.now()
+  });
+  return {
+    get: (id) => records.get(id),
+    list: () => [...records.values()],
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    receive(incoming) {
+      const current = records.get(incoming.id);
+      if (!current) {
+        put(fresh2(incoming));
+        return "created";
+      }
+      const key = incomingKey(incoming);
+      if (current.lastIncomingKey === key) return "unchanged";
+      const userEditedBody = docKey(current.json) !== docKey(current.baseJson);
+      const userEditedTitle = current.title !== current.baseTitle;
+      const title = userEditedTitle ? current.title : incoming.title;
+      const meta = {
+        documentType: incoming.documentType ?? current.documentType,
+        status: incoming.status ?? current.status
+      };
+      if (!userEditedBody) {
+        put({
+          ...current,
+          ...meta,
+          title,
+          baseTitle: incoming.title,
+          json: incoming.json,
+          baseJson: incoming.json,
+          lastIncomingKey: key,
+          revision: current.revision + 1,
+          origin: "external",
+          pending: null,
+          updatedAt: Date.now()
+        });
+        return "applied";
+      }
+      const { doc, conflicts } = mergeDocuments(current.baseJson, current.json, incoming.json);
+      if (conflicts === 0) {
+        put({
+          ...current,
+          ...meta,
+          title,
+          baseTitle: incoming.title,
+          json: doc,
+          baseJson: incoming.json,
+          lastIncomingKey: key,
+          revision: current.revision + 1,
+          origin: "external",
+          pending: null,
+          updatedAt: Date.now()
+        });
+        return "merged";
+      }
+      put({
+        ...current,
+        ...meta,
+        lastIncomingKey: key,
+        pending: { json: incoming.json, title: incoming.title, merged: doc, conflicts }
+      });
+      return "conflict";
+    },
+    hydrate(doc) {
+      put(fresh2(doc));
+    },
+    edit(id, json, origin) {
+      const current = records.get(id);
+      if (!current || docKey(current.json) === docKey(json)) return;
+      put({ ...current, json, origin, revision: current.revision + 1, updatedAt: Date.now() });
+    },
+    setTitle(id, title) {
+      const current = records.get(id);
+      if (!current || current.title === title) return;
+      put({ ...current, title, updatedAt: Date.now() });
+    },
+    resolve(id, choice) {
+      const current = records.get(id);
+      const pending = current?.pending;
+      if (!current || !pending) return;
+      if (choice === "keep") {
+        put({ ...current, baseJson: pending.json, baseTitle: pending.title, pending: null });
+        return;
+      }
+      const json = choice === "merge" ? pending.merged : pending.json;
+      const title = choice === "merge" ? current.title : pending.title;
+      put({
+        ...current,
+        title,
+        json,
+        baseJson: pending.json,
+        baseTitle: pending.title,
+        revision: current.revision + 1,
+        origin: "external",
+        pending: null,
+        updatedAt: Date.now()
+      });
+    },
+    remove(id) {
+      if (records.delete(id)) emit();
+    }
+  };
+}
+var echoes = /* @__PURE__ */ new WeakMap();
+var ECHO_MEMORY = 8;
+function rememberDocumentEcho(store, id, content) {
+  let byId = echoes.get(store);
+  if (!byId) echoes.set(store, byId = /* @__PURE__ */ new Map());
+  const list2 = byId.get(id) ?? [];
+  list2.push(content);
+  if (list2.length > ECHO_MEMORY) list2.shift();
+  byId.set(id, list2);
+}
+function isDocumentEcho(store, id, content) {
+  return !!content && !!echoes.get(store)?.get(id)?.includes(content);
+}
+var defaultStore = null;
+function getDefaultDocumentStore() {
+  if (!defaultStore) defaultStore = createDocumentStore();
+  return defaultStore;
+}
+
+// src/utils/update-document-program.ts
+function readString(src, i) {
+  if (src[i] !== '"') return null;
+  let j = i + 1;
+  let value = "";
+  while (j < src.length) {
+    const ch = src[j];
+    if (ch === '"') return { start: i, end: j + 1, value };
+    if (ch === "\\") {
+      const next = src[j + 1];
+      if (next === void 0) return null;
+      if (next === "u" && /^[0-9a-fA-F]{4}$/.test(src.slice(j + 2, j + 6))) {
+        value += String.fromCharCode(parseInt(src.slice(j + 2, j + 6), 16));
+        j += 6;
+        continue;
+      }
+      value += next === "n" ? "\n" : next === "t" ? "	" : next === "r" ? "\r" : next === "b" ? "\b" : next === "f" ? "\f" : next;
+      j += 2;
+      continue;
+    }
+    value += ch;
+    j++;
+  }
+  return null;
+}
+var skipSpace = (src, i) => {
+  while (i < src.length && /\s/.test(src[i])) i++;
+  return i;
+};
+var toLangString = (value) => JSON.stringify(value);
+function updateDocumentInProgram(program, documentId, update, componentName = "DocumentEditor") {
+  const re = new RegExp(`\\b${componentName}\\s*\\(`, "g");
+  let match;
+  while (match = re.exec(program)) {
+    const args = [];
+    let i = match.index + match[0].length;
+    for (let n = 0; n < 3; n++) {
+      i = skipSpace(program, i);
+      const tok = readString(program, i);
+      if (!tok) break;
+      args.push(tok);
+      i = skipSpace(program, tok.end);
+      if (program[i] === ",") i++;
+      else break;
+    }
+    if (args[0]?.value !== documentId) continue;
+    const edits = [];
+    if (update.title !== void 0 && args[1] && args[1].value !== update.title) {
+      edits.push({ start: args[1].start, end: args[1].end, text: toLangString(update.title) });
+    }
+    if (update.content !== void 0 && args[2] && args[2].value !== update.content) {
+      edits.push({ start: args[2].start, end: args[2].end, text: toLangString(update.content) });
+    }
+    if (!args[2] && update.content !== void 0) return null;
+    let out = program;
+    for (const e of edits.sort((a, b) => b.start - a.start)) {
+      out = out.slice(0, e.start) + e.text + out.slice(e.end);
+    }
+    return out;
+  }
+  return null;
+}
+function readDocumentFromProgram(program, documentId, componentName = "DocumentEditor") {
+  const re = new RegExp(`\\b${componentName}\\s*\\(`, "g");
+  let match;
+  while (match = re.exec(program)) {
+    const args = [];
+    let i = match.index + match[0].length;
+    for (let n = 0; n < 3; n++) {
+      i = skipSpace(program, i);
+      const tok = readString(program, i);
+      if (!tok) break;
+      args.push(tok);
+      i = skipSpace(program, tok.end);
+      if (program[i] === ",") i++;
+      else break;
+    }
+    if (args[0]?.value === documentId && args[1] && args[2]) return { title: args[1].value, content: args[2].value };
+  }
+  return null;
 }
 
 // src/core/context.ts
@@ -1074,14 +1571,43 @@ function JuneRenderer(props) {
     onError,
     onJuneError,
     documents,
+    onResponseChange,
+    responseChangeDelay = 300,
     loadingFallback = null,
     emptyFallback = null,
     errorFallback,
     resetKeys,
     ...rendererProps
   } = props;
-  const latest = (0, import_react5.useRef)({ actions, confirmAction, parseActionEvent, onAction, onError, onJuneError });
-  latest.current = { actions, confirmAction, parseActionEvent, onAction, onError, onJuneError };
+  const latest = (0, import_react5.useRef)({ actions, confirmAction, parseActionEvent, onAction, onError, onJuneError, onResponseChange, responseChangeDelay, response });
+  latest.current = { actions, confirmAction, parseActionEvent, onAction, onError, onJuneError, onResponseChange, responseChangeDelay, response };
+  const syncTimers = (0, import_react5.useRef)(/* @__PURE__ */ new Map());
+  (0, import_react5.useEffect)(() => {
+    const timers = syncTimers.current;
+    return () => {
+      timers.forEach(clearTimeout);
+      timers.clear();
+    };
+  }, []);
+  const syncProgram = (0, import_react5.useCallback)(async (change, store) => {
+    const l = latest.current;
+    if (!l.onResponseChange || typeof l.response !== "string") return;
+    const record = store.get(change.documentId);
+    const title = record?.title ?? change.title;
+    const json = record?.json ?? change.json;
+    try {
+      const { docToMarkdown: docToMarkdown2 } = await Promise.resolve().then(() => (init_document_engine(), document_engine_exports));
+      const markdown = docToMarkdown2(json);
+      const program = latest.current.response;
+      if (typeof program !== "string") return;
+      const next = updateDocumentInProgram(program, change.documentId, { title, content: markdown });
+      if (next === null || next === program) return;
+      rememberDocumentEcho(store, change.documentId, markdown);
+      latest.current.onResponseChange?.(next, { documentId: change.documentId, title, markdown, source: change.source });
+    } catch (error) {
+      latest.current.onJuneError?.(toJuneError(error, "DOCUMENT_ERROR", "Updating the program failed"));
+    }
+  }, []);
   const handleAction = (0, import_react5.useCallback)((event) => {
     const l = latest.current;
     l.onAction?.(event);
@@ -1120,12 +1646,27 @@ function JuneRenderer(props) {
   const documentOptions = (0, import_react5.useMemo)(
     () => ({
       ...documents,
+      onDocumentChange: (change) => {
+        documents?.onDocumentChange?.(change);
+        if (!latest.current.onResponseChange || change.source === "ai") return;
+        const store = documents?.store ?? getDefaultDocumentStore();
+        const timers = syncTimers.current;
+        const prev = timers.get(change.documentId);
+        if (prev) clearTimeout(prev);
+        timers.set(
+          change.documentId,
+          setTimeout(() => {
+            timers.delete(change.documentId);
+            void syncProgram(change, store);
+          }, Math.max(0, latest.current.responseChangeDelay))
+        );
+      },
       onError: (error) => {
         documents?.onError?.(error);
         latest.current.onJuneError?.(error);
       }
     }),
-    [documents]
+    [documents, syncProgram]
   );
   const parts = (0, import_react5.useMemo)(
     () => mixedContent && response ? splitResponse(response, { streaming: isStreaming }) : null,
@@ -2383,53 +2924,110 @@ function DocumentBubbleMenu({ editor }) {
 // src/components/document-editor/document-content.tsx
 var import_react11 = require("@tiptap/react");
 var import_react12 = require("react");
+init_document_pagination();
 var import_jsx_runtime9 = require("react/jsx-runtime");
+var PAGE_WIDTH = 794;
 var PAGE_HEIGHT = 1123;
-var PAGE_PAD_Y = 96;
+var PAGE_GAP = 28;
+var CANVAS_PAD_X = 24;
+var useIsoLayoutEffect = typeof window === "undefined" ? import_react12.useEffect : import_react12.useLayoutEffect;
+function geometry(width) {
+  const ratio = width / PAGE_WIDTH;
+  const height = Math.round(PAGE_HEIGHT * ratio);
+  const padX = Math.round(Math.min(96, Math.max(20, width * 0.12)));
+  const padY = Math.round(Math.min(96, Math.max(36, 96 * ratio)));
+  return { width, height, padX, padY };
+}
 function DocumentContent({ editor, layout = "page", zoom = 1, showMarks = false, onMetrics }) {
   const canvas = (0, import_react12.useRef)(null);
   const sheet = (0, import_react12.useRef)(null);
+  const [avail, setAvail] = (0, import_react12.useState)(PAGE_WIDTH);
+  const [sheetH, setSheetH] = (0, import_react12.useState)(0);
   const [pages, setPages] = (0, import_react12.useState)(1);
   const metricsRef = (0, import_react12.useRef)(onMetrics);
   metricsRef.current = onMetrics;
   const last = (0, import_react12.useRef)({ page: 0, pages: 0 });
+  const paged = layout === "page";
+  const width = paged ? Math.max(260, Math.min(PAGE_WIDTH, Math.floor(avail / zoom))) : Math.max(260, Math.floor(avail / zoom));
+  const g = geometry(width);
+  const stride = g.height + PAGE_GAP;
+  useIsoLayoutEffect(() => {
+    const c = canvas.current;
+    if (!c) return;
+    const read = () => {
+      const cs = typeof getComputedStyle === "function" ? getComputedStyle(c) : null;
+      const padX = cs ? (parseFloat(cs.paddingLeft) || 0) + (parseFloat(cs.paddingRight) || 0) : CANVAS_PAD_X * 2;
+      const w = c.clientWidth - padX;
+      if (w > 0) setAvail(w);
+    };
+    read();
+    if (typeof ResizeObserver === "undefined") return;
+    const ro = new ResizeObserver(read);
+    ro.observe(c);
+    return () => ro.disconnect();
+  }, []);
+  (0, import_react12.useEffect)(() => {
+    if (!editor) return;
+    setPaginationConfig(editor, {
+      enabled: paged,
+      pageHeight: g.height,
+      gap: PAGE_GAP,
+      padTop: g.padY,
+      padBottom: g.padY
+    });
+  }, [editor, paged, g.height, g.padY, width]);
   (0, import_react12.useEffect)(() => {
     const c = canvas.current;
-    const p = sheet.current;
-    const prose = editor?.view.dom;
-    if (!c || !p || !prose) return;
-    const measure = () => {
-      const contentH = prose.getBoundingClientRect().height / zoom;
-      const total = layout === "page" ? Math.max(1, Math.ceil((contentH + PAGE_PAD_Y * 2) / PAGE_HEIGHT)) : 1;
-      const cRect = c.getBoundingClientRect();
-      const pRect = p.getBoundingClientRect();
-      const y = cRect.top + c.clientHeight * 0.35 - pRect.top;
-      const page = Math.min(total, Math.max(1, Math.floor(y / (PAGE_HEIGHT * zoom)) + 1));
+    const s = sheet.current;
+    if (!editor || !c || !s) return;
+    const prose = editor.view.dom;
+    const report = () => {
+      const total = paged ? getPageCount(editor) : 1;
       setPages(total);
+      setSheetH(s.offsetHeight);
+      const cRect = c.getBoundingClientRect();
+      const sRect = s.getBoundingClientRect();
+      const y = (cRect.top + c.clientHeight * 0.35 - sRect.top) / zoom;
+      const page = paged ? Math.min(total, Math.max(1, Math.floor(y / stride) + 1)) : 1;
       if (last.current.page !== page || last.current.pages !== total) {
         last.current = { page, pages: total };
         metricsRef.current?.({ page, pages: total });
       }
     };
-    measure();
-    c.addEventListener("scroll", measure, { passive: true });
-    const ro = typeof ResizeObserver !== "undefined" ? new ResizeObserver(measure) : null;
-    ro?.observe(prose);
-    ro?.observe(c);
-    editor?.on("update", measure);
+    report();
+    editor.on("transaction", report);
+    c.addEventListener("scroll", report, { passive: true });
+    const onLoad = () => remeasurePagination(editor);
+    prose.addEventListener("load", onLoad, true);
+    const ro = typeof ResizeObserver !== "undefined" ? new ResizeObserver(report) : null;
+    ro?.observe(s);
     return () => {
-      c.removeEventListener("scroll", measure);
+      editor.off("transaction", report);
+      c.removeEventListener("scroll", report);
+      prose.removeEventListener("load", onLoad, true);
       ro?.disconnect();
-      editor?.off("update", measure);
     };
-  }, [editor, layout, zoom]);
-  const sheetStyle = layout === "page" ? {
-    zoom,
-    minHeight: pages * PAGE_HEIGHT,
-    maxWidth: `calc(100% / ${zoom})`,
-    "--jd-page-h": `${PAGE_HEIGHT}px`
-  } : { zoom };
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { ref: canvas, className: "june-doc__content june-doc__canvas", "data-layout": layout, "data-marks": showMarks || void 0, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { ref: sheet, className: "june-doc__sheet", style: sheetStyle, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react11.EditorContent, { editor }) }) });
+  }, [editor, paged, zoom, stride]);
+  const minHeight = paged ? pages * g.height + (pages - 1) * PAGE_GAP : void 0;
+  const sheetStyle = {
+    width,
+    minHeight,
+    transform: zoom === 1 ? void 0 : `scale(${zoom})`,
+    "--jd-pad-x": `${g.padX}px`,
+    "--jd-pad-y": `${g.padY}px`
+  };
+  const zoomerStyle = {
+    width: width * zoom,
+    height: zoom === 1 ? void 0 : Math.max(sheetH, minHeight ?? 0) * zoom
+  };
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { ref: canvas, className: "june-doc__content june-doc__canvas", "data-layout": layout, "data-marks": showMarks || void 0, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: "june-doc__zoomer", style: zoomerStyle, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("div", { ref: sheet, className: "june-doc__sheet", style: sheetStyle, children: [
+    paged ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: "june-doc__pages", "aria-hidden": "true", children: Array.from({ length: pages }, (_, i) => /* @__PURE__ */ (0, import_jsx_runtime9.jsx)("div", { className: "june-doc__page", style: { top: i * stride, height: g.height }, children: /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)("span", { className: "june-doc__page-num", children: [
+      i + 1,
+      " / ",
+      pages
+    ] }) }, i)) }) : null,
+    /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_react11.EditorContent, { editor })
+  ] }) }) });
 }
 
 // src/components/document-editor/document-findbar.tsx
@@ -2578,7 +3176,7 @@ var FORMATS = {
   txt: { label: "Plain text", hint: ".txt", icon: "file" }
 };
 function DocumentHeader(props) {
-  const { title, editable, isDraft, fullscreen, onToggleFullscreen, onTitle, exportFormats, canSave, saveState, onExport, onCopy, onSave } = props;
+  const { title, editable, isDraft, fullscreen, onToggleFullscreen, onTitle, exportFormats, canSave, showSave = canSave, saveState, onExport, onCopy, onSave } = props;
   return /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "june-doc__header", children: [
     fullscreen ? /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("button", { type: "button", className: "june-doc__btn june-doc__btn--icon june-doc__btn--ghost", "aria-label": "Close full screen", title: "Close (Esc)", onClick: onToggleFullscreen, children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Icon, { name: "close", size: 18 }) }) : /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("span", { className: "june-doc__doc-icon", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(Icon, { name: "file", size: 16 }) }),
     /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(DocumentTitle, { value: title, disabled: !editable, onChange: onTitle }),
@@ -2587,11 +3185,12 @@ function DocumentHeader(props) {
       "AI draft"
     ] }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)("div", { className: "june-doc__header-actions", children: [
-      canSave ? /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(
+      showSave ? /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(
         "button",
         {
           type: "button",
-          className: "june-doc__btn june-doc__btn--outline",
+          className: "june-doc__btn june-doc__btn--outline june-doc__save",
+          "data-state": saveState,
           "aria-label": "Save",
           title: "Save (Ctrl+S)",
           disabled: saveState === "saving" || saveState === "saved" || saveState === "idle",
@@ -3105,223 +3704,6 @@ ${docToText2(doc.json)}`;
 // src/components/document-editor/document-editor.tsx
 init_document_extensions();
 
-// src/components/document-editor/document-merge.ts
-init_document_utils();
-var MAX_CELLS = 4e6;
-function matchIndices(a, b) {
-  const n = a.length;
-  const m = b.length;
-  if (n * m > MAX_CELLS) return null;
-  const dp = Array.from({ length: n + 1 }, () => new Uint32Array(m + 1));
-  for (let i2 = n - 1; i2 >= 0; i2--) {
-    for (let j2 = m - 1; j2 >= 0; j2--) {
-      dp[i2][j2] = a[i2] === b[j2] ? dp[i2 + 1][j2 + 1] + 1 : Math.max(dp[i2 + 1][j2], dp[i2][j2 + 1]);
-    }
-  }
-  const matches = /* @__PURE__ */ new Map();
-  let i = 0;
-  let j = 0;
-  while (i < n && j < m) {
-    if (a[i] === b[j]) {
-      matches.set(i, j);
-      i++;
-      j++;
-    } else if (dp[i + 1][j] >= dp[i][j + 1]) i++;
-    else j++;
-  }
-  return matches;
-}
-var same = (x, y) => x.length === y.length && x.every((v, i) => v === y[i]);
-function mergeBlocks(base, local, incoming) {
-  if (same(local, base)) return { blocks: incoming, conflicts: 0 };
-  if (same(incoming, base) || same(local, incoming)) return { blocks: local, conflicts: 0 };
-  const ml = matchIndices(base, local);
-  const mn = matchIndices(base, incoming);
-  if (!ml || !mn) return { blocks: null, conflicts: 1 };
-  const anchors = [...ml.keys()].filter((i) => mn.has(i)).sort((x, y) => x - y);
-  const out = [];
-  let conflicts = 0;
-  let pb = -1;
-  let pl = -1;
-  let pn = -1;
-  const region = (bEnd, lEnd, nEnd) => {
-    const B = base.slice(pb + 1, bEnd);
-    const L = local.slice(pl + 1, lEnd);
-    const N = incoming.slice(pn + 1, nEnd);
-    if (B.length === L.length && L.length === N.length) {
-      for (let k = 0; k < B.length; k++) {
-        if (L[k] === B[k]) out.push(N[k]);
-        else if (N[k] === B[k] || N[k] === L[k]) out.push(L[k]);
-        else {
-          conflicts++;
-          out.push(L[k]);
-        }
-      }
-      return;
-    }
-    if (same(L, B)) out.push(...N);
-    else if (same(N, B) || same(L, N)) out.push(...L);
-    else {
-      conflicts++;
-      out.push(...L);
-    }
-  };
-  for (const a of anchors) {
-    const la = ml.get(a);
-    const na = mn.get(a);
-    region(a, la, na);
-    out.push(local[la]);
-    pb = a;
-    pl = la;
-    pn = na;
-  }
-  region(base.length, local.length, incoming.length);
-  return { blocks: out, conflicts };
-}
-function mergeDocuments(base, local, incoming) {
-  const toBlocks = (d) => (d.content ?? []).map((node) => JSON.stringify(node));
-  const { blocks: blocks2, conflicts } = mergeBlocks(toBlocks(base), toBlocks(local), toBlocks(incoming));
-  if (!blocks2) return { doc: local, conflicts: Math.max(1, conflicts) };
-  if (blocks2.length === 0) return { doc: emptyDoc(), conflicts };
-  return { doc: { type: "doc", content: blocks2.map((b) => JSON.parse(b)) }, conflicts };
-}
-
-// src/components/document-editor/document-store.ts
-init_document_utils();
-var incomingKey = (doc) => JSON.stringify([doc.title, docKey(doc.json)]);
-function createDocumentStore() {
-  const records = /* @__PURE__ */ new Map();
-  const listeners = /* @__PURE__ */ new Set();
-  const emit = () => listeners.forEach((listener) => listener());
-  const put = (record) => {
-    records.set(record.id, record);
-    emit();
-  };
-  const fresh2 = (doc) => ({
-    id: doc.id,
-    title: doc.title,
-    documentType: doc.documentType,
-    status: doc.status,
-    json: doc.json,
-    baseJson: doc.json,
-    baseTitle: doc.title,
-    lastIncomingKey: incomingKey(doc),
-    revision: 0,
-    origin: "external",
-    pending: null,
-    updatedAt: Date.now()
-  });
-  return {
-    get: (id) => records.get(id),
-    list: () => [...records.values()],
-    subscribe: (listener) => {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    receive(incoming) {
-      const current = records.get(incoming.id);
-      if (!current) {
-        put(fresh2(incoming));
-        return "created";
-      }
-      const key = incomingKey(incoming);
-      if (current.lastIncomingKey === key) return "unchanged";
-      const userEditedBody = docKey(current.json) !== docKey(current.baseJson);
-      const userEditedTitle = current.title !== current.baseTitle;
-      const title = userEditedTitle ? current.title : incoming.title;
-      const meta = {
-        documentType: incoming.documentType ?? current.documentType,
-        status: incoming.status ?? current.status
-      };
-      if (!userEditedBody) {
-        put({
-          ...current,
-          ...meta,
-          title,
-          baseTitle: incoming.title,
-          json: incoming.json,
-          baseJson: incoming.json,
-          lastIncomingKey: key,
-          revision: current.revision + 1,
-          origin: "external",
-          pending: null,
-          updatedAt: Date.now()
-        });
-        return "applied";
-      }
-      const { doc, conflicts } = mergeDocuments(current.baseJson, current.json, incoming.json);
-      if (conflicts === 0) {
-        put({
-          ...current,
-          ...meta,
-          title,
-          baseTitle: incoming.title,
-          json: doc,
-          baseJson: incoming.json,
-          lastIncomingKey: key,
-          revision: current.revision + 1,
-          origin: "external",
-          pending: null,
-          updatedAt: Date.now()
-        });
-        return "merged";
-      }
-      put({
-        ...current,
-        ...meta,
-        lastIncomingKey: key,
-        pending: { json: incoming.json, title: incoming.title, merged: doc, conflicts }
-      });
-      return "conflict";
-    },
-    hydrate(doc) {
-      put(fresh2(doc));
-    },
-    edit(id, json, origin) {
-      const current = records.get(id);
-      if (!current || docKey(current.json) === docKey(json)) return;
-      put({ ...current, json, origin, revision: current.revision + 1, updatedAt: Date.now() });
-    },
-    setTitle(id, title) {
-      const current = records.get(id);
-      if (!current || current.title === title) return;
-      put({ ...current, title, updatedAt: Date.now() });
-    },
-    resolve(id, choice) {
-      const current = records.get(id);
-      const pending = current?.pending;
-      if (!current || !pending) return;
-      if (choice === "keep") {
-        put({ ...current, baseJson: pending.json, baseTitle: pending.title, pending: null });
-        return;
-      }
-      const json = choice === "merge" ? pending.merged : pending.json;
-      const title = choice === "merge" ? current.title : pending.title;
-      put({
-        ...current,
-        title,
-        json,
-        baseJson: pending.json,
-        baseTitle: pending.title,
-        revision: current.revision + 1,
-        origin: "external",
-        pending: null,
-        updatedAt: Date.now()
-      });
-    },
-    remove(id) {
-      if (records.delete(id)) emit();
-    }
-  };
-}
-var defaultStore = null;
-function getDefaultDocumentStore() {
-  if (!defaultStore) defaultStore = createDocumentStore();
-  return defaultStore;
-}
-
 // src/components/document-editor/document-types.ts
 var ALL_EXPORT_FORMATS = [
   "html",
@@ -3431,8 +3813,13 @@ function DocumentEditorImpl(props) {
   saveRef.current = async () => {
     const record = store.get(documentId);
     const onSave = optionsRef.current.onSave;
-    if (!record || !onSave) return;
+    if (!record) return;
     const key = JSON.stringify([record.title, docKey(record.json)]);
+    if (!onSave) {
+      lastSavedKey.current = key;
+      setSaveState("saved");
+      return;
+    }
     if (key === lastSavedKey.current) {
       setSaveState("saved");
       return;
@@ -3453,11 +3840,22 @@ function DocumentEditorImpl(props) {
       optionsRef.current.onError?.(toJuneError(error, "DOCUMENT_ERROR", "Saving the document failed"));
     }
   };
-  const markDirty = (0, import_react16.useCallback)(() => {
-    if (!optionsRef.current.onSave) return;
-    setSaveState("dirty");
-    autosave?.();
-  }, [autosave]);
+  const markDirty = (0, import_react16.useCallback)(
+    (userEdit = true) => {
+      if (!optionsRef.current.onSave) {
+        if (userEdit) setSaveState("dirty");
+        return;
+      }
+      setSaveState("dirty");
+      autosave?.();
+    },
+    [autosave]
+  );
+  (0, import_react16.useEffect)(() => {
+    if (saveState !== "saved" || options.onSave) return;
+    const t = setTimeout(() => setSaveState((s) => s === "saved" ? "idle" : s), 2500);
+    return () => clearTimeout(t);
+  }, [saveState, options.onSave]);
   const [initialJson] = (0, import_react16.useState)(() => store.get(documentId)?.json ?? parsed.json ?? emptyDoc());
   const extensions = (0, import_react16.useMemo)(() => createDocumentExtensions(), []);
   const onUpdateRef = (0, import_react16.useRef)(() => {
@@ -3483,10 +3881,12 @@ function DocumentEditorImpl(props) {
     onUpdate: ({ editor: ed }) => onUpdateRef.current(ed.getJSON())
   });
   (0, import_react16.useEffect)(() => {
-    editor?.setEditable(editable);
+    if (!editor || editor.isEditable === editable) return;
+    editor.setEditable(editable);
   }, [editor, editable]);
   (0, import_react16.useEffect)(() => {
     if (!parsed.json) return;
+    if (isDocumentEcho(store, documentId, contentKey)) return;
     const outcome = store.receive({
       id: documentId,
       title: titleProp,
@@ -3496,7 +3896,7 @@ function DocumentEditorImpl(props) {
     });
     if (outcome === "applied" || outcome === "merged") {
       emitChange(outcome === "applied" ? "ai" : "merge");
-      markDirty();
+      markDirty(false);
     } else if (outcome === "conflict") {
       const record = store.get(documentId);
       optionsRef.current.onConflict?.({
@@ -3611,6 +4011,7 @@ function DocumentEditorImpl(props) {
             onTitle: handleTitle,
             exportFormats: formats,
             canSave: !!options.onSave,
+            showSave: !!options.onSave || editable && saveState !== "idle",
             saveState,
             onExport: (f) => void handleExport(f),
             onCopy: () => void handleCopy(),
@@ -3821,17 +4222,21 @@ function JuneUI({ library = juneLibrary, ...props }) {
   getDefaultDocumentStore,
   getDocumentEditorInstructions,
   getDocumentEditorRules,
+  isDocumentEcho,
   isJuneError,
   jsonFieldExtractor,
   juneLibrary,
   lightTheme,
   listDocumentExporters,
   mergeDocuments,
+  readDocumentFromProgram,
   registerDocumentExporter,
+  rememberDocumentEcho,
   runAction,
   serializeDocumentsForAgent,
   sseToText,
   toJuneError,
+  updateDocumentInProgram,
   useDocumentOptions,
   useJuneRuntime,
   useJuneStream,