@pixerate/editor 0.269.2 → 0.271.0

package/README.md

@@ -573,9 +573,12 @@ const mark = history.mark();
 history.revertTo(mark); // returns the number of steps reverted (0 if the mark is gone)
 
 // History panel
-history.getEntries(); // [{ id, label, index, current, undone }]
+history.getEntries(); // [{ id, label, index, current, undone, origin, tag? }]
 history.goTo(2); // undo / redo until entry 2 is current; goTo(-1) undoes everything
 
+// Stale steps: when remote content replaces what some steps change, remove them unrun.
+history.dropSteps((step) => step.tag === "paint"); // returns how many were removed
+
 // Dirty vs saved: undoing back to the saved state is clean again.
 const dirty = bindDirtyToHistory({
   history,
@@ -587,7 +590,7 @@ dirty.markClean(); // after saving
 dirty.dirty; // feed to useNavigationGuard / createNavigationGuard
 ```
 
-Tag-only `executeMerged(cmd)` keeps its 300 ms time-window coalescing. React exposes the same API through `useHistory()` (`entries`, `goTo`, `mark`, `revertTo`, `beginGesture`, `endGesture`) and `useHistoryDirty()`; Svelte through `createHistory()` and `createHistoryDirty()`.
+Tag-only `executeMerged(cmd)` keeps its 300 ms time-window coalescing. React exposes the same API through `useHistory()` (`entries`, `goTo`, `mark`, `revertTo`, `dropSteps`, `beginGesture`, `endGesture`) and `useHistoryDirty()`; Svelte through `createHistory()` and `createHistoryDirty()`.
 
 ## License
 

package/dist/agent/index.cjs

@@ -140,10 +140,10 @@ var _chunkN2FGYZ4Qcjs = require('../chunk-N2FGYZ4Q.cjs');
 
 
 
-var _chunkT4JPGBW3cjs = require('../chunk-T4JPGBW3.cjs');
+var _chunkDGITFN73cjs = require('../chunk-DGITFN73.cjs');
 
 
-var _chunkYYBW6DF2cjs = require('../chunk-YYBW6DF2.cjs');
+var _chunkGSLOH2INcjs = require('../chunk-GSLOH2IN.cjs');
 require('../chunk-TTCJPX4U.cjs');
 require('../chunk-MDLEGVEN.cjs');
 require('../chunk-VU6WQSMB.cjs');
@@ -191,7 +191,7 @@ var _chunkWOFXZ3XUcjs = require('../chunk-WOFXZ3XU.cjs');
 
 
 var _chunk2BSBFBOAcjs = require('../chunk-2BSBFBOA.cjs');
-require('../chunk-WKPXOGZZ.cjs');
+require('../chunk-WPLGZBNE.cjs');
 require('../chunk-I3Y2Q3PM.cjs');
 require('../chunk-MEGSQUQO.cjs');
 require('../chunk-MLLTWAXH.cjs');
@@ -691,14 +691,14 @@ function describe(chart, includeSpec) {
     series: spec.series.map((s) => ({ id: s.id, name: s.name })),
     width: _nullishCoalesce(node.attrs.width, () => ( null)),
     height: node.attrs.height,
-    description: _chunkYYBW6DF2cjs.describeChart.call(void 0, spec),
+    description: _chunkGSLOH2INcjs.describeChart.call(void 0, spec),
     ...includeSpec ? { spec } : {}
   };
 }
 function sparklines(doc) {
   const found = [];
   doc.descendants((node, pos) => {
-    if (node.type.name === "sparkline") found.push({ pos, kind: node.attrs.kind, values: node.attrs.values, label: _chunkT4JPGBW3cjs.sparklineLabel.call(void 0, node) });
+    if (node.type.name === "sparkline") found.push({ pos, kind: node.attrs.kind, values: node.attrs.values, label: _chunkDGITFN73cjs.sparklineLabel.call(void 0, node) });
   });
   return found;
 }
@@ -709,7 +709,7 @@ function checkPosition(editor, at) {
 function createDocumentChartTools(editor) {
   const chartType = () => editor().schema.nodes.chart;
   const findChart = (args) => {
-    const charts = _chunkT4JPGBW3cjs.getDocumentCharts.call(void 0, editor().state.doc);
+    const charts = _chunkDGITFN73cjs.getDocumentCharts.call(void 0, editor().state.doc);
     const list = charts.map((c) => `"${c.id}" at ${c.pos}`).join(", ") || "none; add one with insert_chart";
     if (args.chartId !== void 0) {
       const chart = charts.find((c) => c.id === args.chartId);
@@ -736,7 +736,7 @@ function createDocumentChartTools(editor) {
     annotations: { title: "List charts in the document", ...READ },
     handler: ({ includeSpec = false }) => {
       const doc = editor().state.doc;
-      return { charts: _chunkT4JPGBW3cjs.getDocumentCharts.call(void 0, doc).map((c) => describe(c, includeSpec)), sparklines: editor().schema.nodes.sparkline ? sparklines(doc) : [] };
+      return { charts: _chunkDGITFN73cjs.getDocumentCharts.call(void 0, doc).map((c) => describe(c, includeSpec)), sparklines: editor().schema.nodes.sparkline ? sparklines(doc) : [] };
     }
   };
   const insertChart = {
@@ -763,7 +763,7 @@ function createDocumentChartTools(editor) {
       const node = { type: "chart", attrs: { id, spec, width, ...height !== void 0 ? { height } : {} } };
       const chain = ed.chain().command(({ tr }) => (_history.closeHistory.call(void 0, tr), true));
       const ok = (at !== void 0 ? chain.insertContentAt(at, node) : chain.insertContent(node)).run();
-      const chart = _chunkT4JPGBW3cjs.getDocumentCharts.call(void 0, ed.state.doc).find((c) => c.id === id);
+      const chart = _chunkDGITFN73cjs.getDocumentCharts.call(void 0, ed.state.doc).find((c) => c.id === id);
       if (!ok || !chart) throw new Error(`A chart cannot go at ${_nullishCoalesce(at, () => ( ed.state.selection.from))}; pass a position between blocks or inside a paragraph.`);
       return { id: chart.id, pos: chart.pos, spec: chart.spec, width: chart.node.attrs.width, height: chart.node.attrs.height };
     }
@@ -810,8 +810,8 @@ function createDocumentChartTools(editor) {
     inputSchema: {
       type: "object",
       properties: {
-        values: { type: "array", items: _chunkG23BTQA5cjs.VALUE, minItems: 1, maxItems: _chunkT4JPGBW3cjs.MAX_SPARKLINE_VALUES, description: "Values in order (null for a gap)." },
-        kind: { type: "string", enum: [..._chunkT4JPGBW3cjs.SPARKLINE_KINDS], description: "line (default), column, or win-loss (sign only)." },
+        values: { type: "array", items: _chunkG23BTQA5cjs.VALUE, minItems: 1, maxItems: _chunkDGITFN73cjs.MAX_SPARKLINE_VALUES, description: "Values in order (null for a gap)." },
+        kind: { type: "string", enum: [..._chunkDGITFN73cjs.SPARKLINE_KINDS], description: "line (default), column, or win-loss (sign only)." },
         at: { type: "integer", minimum: 0, description: "Document position inside a paragraph (default: the selection)." },
         width: { type: "number", minimum: 4, maximum: 1e3, description: "Width in pixels (default 80)." },
         height: { type: "number", minimum: 4, maximum: 200, description: "Height in pixels (default 18)." },
@@ -830,7 +830,7 @@ function createDocumentChartTools(editor) {
       if (bad >= 0) throw new Error(`values[${bad}] ("${String(values[bad])}") is not a number; pass numbers, numeric text or null. Nothing was inserted.`);
       const pos = _nullishCoalesce(at, () => ( ed.state.selection.from));
       if (!ed.state.doc.resolve(pos).parent.inlineContent) throw new Error(`Position ${pos} is between blocks; a sparkline goes inside a paragraph (use a position from get_text {blocks: true}).`);
-      const stored = _chunkT4JPGBW3cjs.normalizeSparklineValues.call(void 0, parsed);
+      const stored = _chunkDGITFN73cjs.normalizeSparklineValues.call(void 0, parsed);
       ed.chain().command(({ tr }) => (_history.closeHistory.call(void 0, tr), true)).insertContentAt(pos, { type: "sparkline", attrs: { values: stored, kind, width, height, color, label } }).run();
       return { pos, kind, values: stored };
     }
@@ -1168,8 +1168,8 @@ function createTextPresence(editor, providerId, option) {
   const config = option === false ? null : option === true || option === void 0 ? {} : option;
   const caret = {
     id: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _43 => _43.id]), () => ( providerId)),
-    name: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _44 => _44.name]), () => ( _chunkT4JPGBW3cjs.DEFAULT_AGENT_CARET_NAME)),
-    color: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _45 => _45.color]), () => ( _chunkT4JPGBW3cjs.DEFAULT_AGENT_CARET_COLOR))
+    name: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _44 => _44.name]), () => ( _chunkDGITFN73cjs.DEFAULT_AGENT_CARET_NAME)),
+    color: _nullishCoalesce(_optionalChain([config, 'optionalAccess', _45 => _45.color]), () => ( _chunkDGITFN73cjs.DEFAULT_AGENT_CARET_COLOR))
   };
   const typing = !_optionalChain([config, 'optionalAccess', _46 => _46.typing]) ? null : config.typing === true ? {} : config.typing;
   const idleMs = _nullishCoalesce(_optionalChain([config, 'optionalAccess', _47 => _47.idleMs]), () => ( 12e3));
@@ -1182,19 +1182,19 @@ function createTextPresence(editor, providerId, option) {
   };
   const touch = () => {
     clearTimeout(idleTimer);
-    if (idleMs > 0) idleTimer = setTimeout(() => live() && _chunkT4JPGBW3cjs.clearAgentCaret.call(void 0, live(), caret.id), idleMs);
+    if (idleMs > 0) idleTimer = setTimeout(() => live() && _chunkDGITFN73cjs.clearAgentCaret.call(void 0, live(), caret.id), idleMs);
   };
   const tint = (ed, ranges) => {
     clearTimeout(tintTimer);
-    _chunkT4JPGBW3cjs.markAgentChanges.call(void 0, ed, caret.id, ranges);
-    if (changedMs > 0 && ranges.length) tintTimer = setTimeout(() => live() && _chunkT4JPGBW3cjs.markAgentChanges.call(void 0, live(), caret.id, []), changedMs);
+    _chunkDGITFN73cjs.markAgentChanges.call(void 0, ed, caret.id, ranges);
+    if (changedMs > 0 && ranges.length) tintTimer = setTimeout(() => live() && _chunkDGITFN73cjs.markAgentChanges.call(void 0, live(), caret.id, []), changedMs);
   };
   return {
     /** Puts the caret at `head`, selecting from `anchor`. */
     show(anchor, head = anchor) {
       const ed = live();
       if (!ed) return;
-      _chunkT4JPGBW3cjs.setAgentCaret.call(void 0, ed, { ...caret, from: anchor, to: head });
+      _chunkDGITFN73cjs.setAgentCaret.call(void 0, ed, { ...caret, from: anchor, to: head });
       touch();
     },
     /** Shows the caret after ranges just changed by a tool, tinting them. */
@@ -1202,7 +1202,7 @@ function createTextPresence(editor, providerId, option) {
       const ed = live();
       if (!ed || !ranges.length) return;
       const last = ranges[ranges.length - 1];
-      _chunkT4JPGBW3cjs.setAgentCaret.call(void 0, ed, { ...caret, from: last.to });
+      _chunkDGITFN73cjs.setAgentCaret.call(void 0, ed, { ...caret, from: last.to });
       tint(ed, ranges);
       touch();
     },
@@ -1210,12 +1210,12 @@ function createTextPresence(editor, providerId, option) {
     async write(ed, from, to, text, signal) {
       if (live() && typing) {
         clearTimeout(tintTimer);
-        const range2 = await _chunkT4JPGBW3cjs.typeAgentText.call(void 0, ed, { ...typing, from, to, text, caret, signal });
-        if (changedMs > 0) tintTimer = setTimeout(() => live() && _chunkT4JPGBW3cjs.markAgentChanges.call(void 0, live(), caret.id, []), changedMs);
+        const range2 = await _chunkDGITFN73cjs.typeAgentText.call(void 0, ed, { ...typing, from, to, text, caret, signal });
+        if (changedMs > 0) tintTimer = setTimeout(() => live() && _chunkDGITFN73cjs.markAgentChanges.call(void 0, live(), caret.id, []), changedMs);
         touch();
         return range2;
       }
-      const tr = _history.closeHistory.call(void 0, _chunkT4JPGBW3cjs.replaceWithTextTransaction.call(void 0, ed.state, from, to, text));
+      const tr = _history.closeHistory.call(void 0, _chunkDGITFN73cjs.replaceWithTextTransaction.call(void 0, ed.state, from, to, text));
       const end = tr.mapping.map(to, 1);
       const range = { from: Math.min(tr.mapping.map(from, -1), end), to: end };
       ed.view.dispatch(tr.scrollIntoView());
@@ -1244,7 +1244,7 @@ function findMatches(editor, query, args, replacement) {
     wholeWord: !!args.wholeWord,
     ...args.regex ? { regex: true } : { literal: true }
   };
-  const result = _chunkT4JPGBW3cjs.searchDocument.call(void 0, editor.state.doc, query, options, replacement !== void 0 ? { replacement } : {});
+  const result = _chunkDGITFN73cjs.searchDocument.call(void 0, editor.state.doc, query, options, replacement !== void 0 ? { replacement } : {});
   if (result.error) throw new Error(`Invalid search pattern: ${result.error.message}`);
   return { matches: result.matches, truncated: result.truncated };
 }
@@ -1406,7 +1406,7 @@ function createRichTextToolProvider(target, options) {
         replacement: String(replace).replace(/\r\n?|\n/g, "\r")
       }));
       const tr = _history.closeHistory.call(void 0, ed.state.tr);
-      const ends = _chunkT4JPGBW3cjs.applyReplacements.call(void 0, tr, chosen);
+      const ends = _chunkDGITFN73cjs.applyReplacements.call(void 0, tr, chosen);
       ed.view.dispatch(tr.scrollIntoView());
       const ranges = chosen.map((m, i) => ({ from: tr.mapping.map(m.from, -1), to: ends[i] }));
       presence.changed(ranges.filter((r) => r.from < r.to));
@@ -1507,7 +1507,7 @@ function createRichTextToolProvider(target, options) {
     inputSchema: {
       type: "object",
       properties: {
-        operation: { type: "string", enum: _chunkT4JPGBW3cjs.TABLE_ACTIONS.map((a) => a.action), description: "Table operation." },
+        operation: { type: "string", enum: _chunkDGITFN73cjs.TABLE_ACTIONS.map((a) => a.action), description: "Table operation." },
         at: { type: "integer", minimum: 0, description: "Document position to place the cursor first (e.g. inside a cell)." },
         rows: { type: "integer", minimum: 1, maximum: 100, description: "insertTable: rows (default 3)." },
         cols: { type: "integer", minimum: 1, maximum: 50, description: "insertTable: columns (default 3)." },
@@ -1537,10 +1537,10 @@ function createRichTextToolProvider(target, options) {
         ed.view.dispatch(ed.state.tr.setSelection(_state.TextSelection.near(ed.state.doc.resolve(at))));
       }
       const action = operation;
-      const state = _chunkT4JPGBW3cjs.getTableActionState.call(void 0, ed, action, params);
+      const state = _chunkDGITFN73cjs.getTableActionState.call(void 0, ed, action, params);
       if (state !== true) throw new Error(state);
-      _chunkT4JPGBW3cjs.runTableAction.call(void 0, ed, action, params);
-      const table = _chunkT4JPGBW3cjs.getTableState.call(void 0, ed);
+      _chunkDGITFN73cjs.runTableAction.call(void 0, ed, action, params);
+      const table = _chunkDGITFN73cjs.getTableState.call(void 0, ed);
       return {
         operation,
         table: table.inTable ? { rows: table.rows, columns: table.columns, row: table.row, column: table.column } : null,
@@ -1559,7 +1559,7 @@ function createRichTextToolProvider(target, options) {
       if (!ed || ed.isDestroyed) return [];
       if (!ed.isEditable) return [getText, findText, ...charts.read()];
       const tools = [getText, findText, insertText, replaceText, replaceRange, replaceSelection, setSelection, ...formatting.tools(ed)];
-      return [...tools, ..._chunkT4JPGBW3cjs.isTableEnabled.call(void 0, ed) ? [editTable] : [], ...charts.read(), ...charts.write().map(withCaret)];
+      return [...tools, ..._chunkDGITFN73cjs.isTableEnabled.call(void 0, ed) ? [editTable] : [], ...charts.read(), ...charts.write().map(withCaret)];
     },
     subscribe: (notify) => {
       const ed = editor();
@@ -2235,7 +2235,7 @@ function createReviewToolProvider(target, options) {
   const editor = () => toEditor2(target);
   const author = _nullishCoalesce(options.author, () => ( { id: "agent", name: "Agent" }));
   const store = () => {
-    const s = _chunkT4JPGBW3cjs.getCommentStore.call(void 0, editor());
+    const s = _chunkDGITFN73cjs.getCommentStore.call(void 0, editor());
     if (!s) throw new Error("This editor has no Comments extension.");
     return s;
   };
@@ -2430,7 +2430,7 @@ function createReviewToolProvider(target, options) {
     tools: () => {
       const ed = editor();
       if (!ed || ed.isDestroyed) return [];
-      const comments = !!_chunkT4JPGBW3cjs.getCommentStore.call(void 0, ed);
+      const comments = !!_chunkDGITFN73cjs.getCommentStore.call(void 0, ed);
       const changes = !!_chunk34RQAGWIcjs.getTrackChangesStore.call(void 0, ed);
       const tools = [...comments ? [listComments] : [], ...changes ? [listChanges] : []];
       if (!ed.isEditable) return tools;

package/dist/agent/index.js

@@ -140,10 +140,10 @@ import {
   setAgentCaret,
   sparklineLabel,
   typeAgentText
-} from "../chunk-N3UMQVKX.js";
+} from "../chunk-X4FTNFIA.js";
 import {
   describeChart
-} from "../chunk-MQ6MGIQM.js";
+} from "../chunk-NMZQMPFZ.js";
 import "../chunk-KGRZMHZB.js";
 import "../chunk-C2WEIEUB.js";
 import "../chunk-O6OGNDND.js";
@@ -191,7 +191,7 @@ import {
   isUnsafeJsonKey,
   stripPrototypeKeys
 } from "../chunk-HF5QZS7Z.js";
-import "../chunk-NS62CQ2B.js";
+import "../chunk-GAZPHCTV.js";
 import "../chunk-2EUW2XZX.js";
 import "../chunk-E2V5DA3W.js";
 import "../chunk-VR6OGHU5.js";