@pixerate/editor 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -6,6 +6,7 @@ export { ExtractedMention, escapeHtml, extractMentionsFromDoc, getEditorMarkdown
 import { Editor, EditorOptions, Content, Extensions } from '@tiptap/core';
 export { Content, Editor, EditorOptions, Extensions } from '@tiptap/core';
 export { ASTNode, BinaryOpNode, CellCoordinate, CellData, CellDep, CellFormat, CellRange, CellRefNode, ColumnBinding, ColumnType, DataSourceBinder, DependencyGraph, EvaluationContext, FormulaEvaluator, FormulaParser, FormulaToken, FormulaTokenType, FunctionCallNode, LiteralNode, PropertyRefNode, RangeNode, RowType, SpreadsheetColumn, SpreadsheetController, SpreadsheetControllerOptions, SpreadsheetDataSource, SpreadsheetDataSourceField, SpreadsheetDocument, SpreadsheetRow, UnaryOpNode, colNameToIndex, extractCellDependencies, indexToColName, parseCellReference, parseFormula, parseRange, tokenizeFormula } from './spreadsheet/index.cjs';
+export { Command, HistoryManager, HistoryManagerOptions, HistoryState, MergedExecutionOptions, SnapshotCommandOptions, createHistoryManager } from './history/index.cjs';
 export { MarkdownOptions } from 'tiptap-markdown';
 import '@tiptap/pm/view';
 import '@tiptap/pm/model';

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { ExtractedMention, escapeHtml, extractMentionsFromDoc, getEditorMarkdown
 import { Editor, EditorOptions, Content, Extensions } from '@tiptap/core';
 export { Content, Editor, EditorOptions, Extensions } from '@tiptap/core';
 export { ASTNode, BinaryOpNode, CellCoordinate, CellData, CellDep, CellFormat, CellRange, CellRefNode, ColumnBinding, ColumnType, DataSourceBinder, DependencyGraph, EvaluationContext, FormulaEvaluator, FormulaParser, FormulaToken, FormulaTokenType, FunctionCallNode, LiteralNode, PropertyRefNode, RangeNode, RowType, SpreadsheetColumn, SpreadsheetController, SpreadsheetControllerOptions, SpreadsheetDataSource, SpreadsheetDataSourceField, SpreadsheetDocument, SpreadsheetRow, UnaryOpNode, colNameToIndex, extractCellDependencies, indexToColName, parseCellReference, parseFormula, parseRange, tokenizeFormula } from './spreadsheet/index.js';
+export { Command, HistoryManager, HistoryManagerOptions, HistoryState, MergedExecutionOptions, SnapshotCommandOptions, createHistoryManager } from './history/index.js';
 export { MarkdownOptions } from 'tiptap-markdown';
 import '@tiptap/pm/view';
 import '@tiptap/pm/model';

package/dist/index.js

@@ -3834,6 +3834,234 @@ var DirtyTracker = class {
 function createDirtyTracker(initialBaseline, options) {
   return new DirtyTracker(initialBaseline, options);
 }
+
+// src/history/HistoryManager.ts
+var HistoryManager = class {
+  undoStack = [];
+  redoStack = [];
+  maxDepth;
+  isApplying = false;
+  batchDepth = 0;
+  currentBatch = null;
+  listeners = /* @__PURE__ */ new Set();
+  onStateChange;
+  cachedState;
+  constructor(options = {}) {
+    this.maxDepth = options.maxDepth ?? 50;
+    this.onStateChange = options.onStateChange;
+    this.cachedState = this.computeState();
+  }
+  computeState() {
+    const canUndo = this.undoStack.length > 0;
+    const canRedo = this.redoStack.length > 0;
+    return {
+      canUndo,
+      canRedo,
+      undoName: canUndo ? this.undoStack[this.undoStack.length - 1].name : "",
+      redoName: canRedo ? this.redoStack[this.redoStack.length - 1].name : "",
+      undoCount: this.undoStack.length,
+      redoCount: this.redoStack.length
+    };
+  }
+  /**
+   * Returns a snapshot of the current history state.
+   * Cached to maintain referential equality across renders for useSyncExternalStore.
+   */
+  getState() {
+    return this.cachedState;
+  }
+  notify() {
+    this.cachedState = this.computeState();
+    const state = this.cachedState;
+    this.onStateChange?.(state);
+    this.listeners.forEach((listener) => {
+      try {
+        listener(state);
+      } catch (err) {
+        console.error("[HistoryManager] Error in state listener:", err);
+      }
+    });
+  }
+  /**
+   * Executes a command and pushes it onto the undo stack.
+   * Clears the redo stack.
+   */
+  execute(command) {
+    if (this.isApplying) {
+      command.execute();
+      return;
+    }
+    if (this.batchDepth > 0 && this.currentBatch) {
+      command.execute();
+      this.currentBatch.push({
+        ...command,
+        timestamp: command.timestamp ?? Date.now()
+      });
+      return;
+    }
+    command.execute();
+    this.undoStack.push({
+      ...command,
+      timestamp: command.timestamp ?? Date.now()
+    });
+    if (this.undoStack.length > this.maxDepth) {
+      this.undoStack.shift();
+    }
+    this.redoStack = [];
+    this.notify();
+  }
+  /**
+   * Executes a command, coalescing it with the previous command if they share
+   * the same `tag` and occurred within `windowMs` (default: 300ms).
+   * Useful for high-frequency interactions like slider scrubs or node drags.
+   */
+  executeMerged(command, options = {}) {
+    const windowMs = options.windowMs ?? 300;
+    const now = Date.now();
+    if (command.tag && this.undoStack.length > 0 && this.batchDepth === 0 && !this.isApplying) {
+      const top = this.undoStack[this.undoStack.length - 1];
+      const elapsed = top.timestamp ? now - top.timestamp : Infinity;
+      if (top.tag === command.tag && elapsed <= windowMs) {
+        command.execute();
+        const initialUndo = top.undo;
+        this.undoStack[this.undoStack.length - 1] = {
+          name: command.name,
+          tag: command.tag,
+          timestamp: now,
+          execute: command.execute,
+          undo: initialUndo,
+          redo: command.redo ?? command.execute
+        };
+        this.redoStack = [];
+        this.notify();
+        return;
+      }
+    }
+    this.execute({ ...command, timestamp: now });
+  }
+  /**
+   * Batches multiple commands executed within `fn` into a single atomic undo entry.
+   */
+  batch(name, fn) {
+    if (this.isApplying) {
+      fn();
+      return;
+    }
+    if (this.batchDepth > 0) {
+      fn();
+      return;
+    }
+    this.batchDepth++;
+    this.currentBatch = [];
+    try {
+      fn();
+    } finally {
+      this.batchDepth--;
+      const batchCommands = this.currentBatch;
+      this.currentBatch = null;
+      if (batchCommands && batchCommands.length > 0) {
+        const compoundCommand = {
+          name,
+          timestamp: Date.now(),
+          execute: () => {
+            for (let i = 0; i < batchCommands.length; i++) {
+              (batchCommands[i].redo ?? batchCommands[i].execute)();
+            }
+          },
+          undo: () => {
+            for (let i = batchCommands.length - 1; i >= 0; i--) {
+              batchCommands[i].undo();
+            }
+          },
+          redo: () => {
+            for (let i = 0; i < batchCommands.length; i++) {
+              (batchCommands[i].redo ?? batchCommands[i].execute)();
+            }
+          }
+        };
+        this.undoStack.push(compoundCommand);
+        if (this.undoStack.length > this.maxDepth) {
+          this.undoStack.shift();
+        }
+        this.redoStack = [];
+        this.notify();
+      }
+    }
+  }
+  /**
+   * Reverts the most recent command on the undo stack.
+   * Returns true if a command was undone, false otherwise.
+   */
+  undo() {
+    if (this.undoStack.length === 0 || this.isApplying || this.batchDepth > 0) {
+      return false;
+    }
+    this.isApplying = true;
+    try {
+      const command = this.undoStack.pop();
+      command.undo();
+      this.redoStack.push(command);
+      return true;
+    } finally {
+      this.isApplying = false;
+      this.notify();
+    }
+  }
+  /**
+   * Re-applies the most recent undone command on the redo stack.
+   * Returns true if a command was redone, false otherwise.
+   */
+  redo() {
+    if (this.redoStack.length === 0 || this.isApplying || this.batchDepth > 0) {
+      return false;
+    }
+    this.isApplying = true;
+    try {
+      const command = this.redoStack.pop();
+      (command.redo ?? command.execute)();
+      this.undoStack.push(command);
+      return true;
+    } finally {
+      this.isApplying = false;
+      this.notify();
+    }
+  }
+  /**
+   * Clears both undo and redo stacks.
+   */
+  clear() {
+    this.undoStack = [];
+    this.redoStack = [];
+    this.notify();
+  }
+  /**
+   * Subscribes to history state changes.
+   * The listener is immediately invoked with the current state.
+   * Returns an unsubscribe function.
+   */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    listener(this.getState());
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Utility helper to create a Command from before/after state snapshots.
+   */
+  static createSnapshotCommand(options) {
+    return {
+      name: options.name,
+      tag: options.tag,
+      execute: () => options.apply(options.after),
+      undo: () => options.apply(options.before),
+      redo: () => options.apply(options.after)
+    };
+  }
+};
+function createHistoryManager(options = {}) {
+  return new HistoryManager(options);
+}
 export {
   ColorHighlighter,
   DataSourceBinder,
@@ -3844,6 +4072,7 @@ export {
   FormulaEvaluator,
   FormulaParser,
   GradientText,
+  HistoryManager,
   INSTRUCTION_REGEX,
   Image2 as Image,
   LoadingNode,
@@ -3858,6 +4087,7 @@ export {
   colNameToIndex,
   createDirtyTracker,
   createEditor,
+  createHistoryManager,
   createMentionExtension,
   createRichTextPreset,
   defaultIsEqual,