@pixerate/editor 0.6.1 → 0.7.0

package/dist/index.d.cts

@@ -40,6 +40,7 @@ declare class EditorController {
     private readonly onMarkdownChange?;
     private readonly onTokensChange?;
     private readonly onSelectionChange?;
+    private baselineContent;
     constructor(options?: EditorControllerOptions);
     private enforcePlainTextClipboard;
     private handleUpdate;
@@ -51,6 +52,11 @@ declare class EditorController {
     insertText(text: string): void;
     insertTextAt(pos: number, text: string): void;
     replaceRange(from: number, to: number, text: string): void;
+    getCurrentContentString(): string;
+    isDirty(): boolean;
+    setCheckpoint(content?: string): void;
+    resetDirty(): void;
+    getBaselineContent(): string;
     destroy(): void;
 }
 /**
@@ -58,4 +64,41 @@ declare class EditorController {
  */
 declare function createEditor(options?: EditorControllerOptions): EditorController;
 
-export { EditorController, type EditorControllerOptions, Token, createEditor };
+/**
+ * Compares two values for structural equality.
+ * Handles primitives, objects, arrays, and null/undefined.
+ */
+declare function defaultIsEqual<T>(a: T, b: T): boolean;
+interface DirtyTrackerOptions<T> {
+    isEqual?: (a: T, b: T) => boolean;
+}
+/**
+ * Tracks a baseline value and determines if the current state is dirty (modified).
+ */
+declare class DirtyTracker<T = unknown> {
+    private baseline;
+    private readonly isEqual;
+    constructor(initialBaseline: T, options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean));
+    /**
+     * Returns current baseline value.
+     */
+    getBaseline(): T;
+    /**
+     * Sets a new baseline value without triggering any dirty state.
+     */
+    setBaseline(value: T): void;
+    /**
+     * Checks whether the given value differs from the baseline.
+     */
+    isDirty(current: T): boolean;
+    /**
+     * Resets the baseline to the provided current value (or clears dirty status).
+     */
+    reset(current: T): void;
+}
+/**
+ * Creates a DirtyTracker instance.
+ */
+declare function createDirtyTracker<T>(initialBaseline: T, options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean)): DirtyTracker<T>;
+
+export { DirtyTracker, type DirtyTrackerOptions, EditorController, type EditorControllerOptions, Token, createDirtyTracker, createEditor, defaultIsEqual };

package/dist/index.d.ts

@@ -40,6 +40,7 @@ declare class EditorController {
     private readonly onMarkdownChange?;
     private readonly onTokensChange?;
     private readonly onSelectionChange?;
+    private baselineContent;
     constructor(options?: EditorControllerOptions);
     private enforcePlainTextClipboard;
     private handleUpdate;
@@ -51,6 +52,11 @@ declare class EditorController {
     insertText(text: string): void;
     insertTextAt(pos: number, text: string): void;
     replaceRange(from: number, to: number, text: string): void;
+    getCurrentContentString(): string;
+    isDirty(): boolean;
+    setCheckpoint(content?: string): void;
+    resetDirty(): void;
+    getBaselineContent(): string;
     destroy(): void;
 }
 /**
@@ -58,4 +64,41 @@ declare class EditorController {
  */
 declare function createEditor(options?: EditorControllerOptions): EditorController;
 
-export { EditorController, type EditorControllerOptions, Token, createEditor };
+/**
+ * Compares two values for structural equality.
+ * Handles primitives, objects, arrays, and null/undefined.
+ */
+declare function defaultIsEqual<T>(a: T, b: T): boolean;
+interface DirtyTrackerOptions<T> {
+    isEqual?: (a: T, b: T) => boolean;
+}
+/**
+ * Tracks a baseline value and determines if the current state is dirty (modified).
+ */
+declare class DirtyTracker<T = unknown> {
+    private baseline;
+    private readonly isEqual;
+    constructor(initialBaseline: T, options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean));
+    /**
+     * Returns current baseline value.
+     */
+    getBaseline(): T;
+    /**
+     * Sets a new baseline value without triggering any dirty state.
+     */
+    setBaseline(value: T): void;
+    /**
+     * Checks whether the given value differs from the baseline.
+     */
+    isDirty(current: T): boolean;
+    /**
+     * Resets the baseline to the provided current value (or clears dirty status).
+     */
+    reset(current: T): void;
+}
+/**
+ * Creates a DirtyTracker instance.
+ */
+declare function createDirtyTracker<T>(initialBaseline: T, options?: DirtyTrackerOptions<T> | ((a: T, b: T) => boolean)): DirtyTracker<T>;
+
+export { DirtyTracker, type DirtyTrackerOptions, EditorController, type EditorControllerOptions, Token, createDirtyTracker, createEditor, defaultIsEqual };

package/dist/index.js

@@ -2358,6 +2358,7 @@ var EditorController = class {
   onMarkdownChange;
   onTokensChange;
   onSelectionChange;
+  baselineContent;
   constructor(options = {}) {
     const {
       element,
@@ -2395,6 +2396,7 @@ var EditorController = class {
     if (plainTextMode) {
       this.enforcePlainTextClipboard();
     }
+    this.baselineContent = this.getCurrentContentString();
   }
   enforcePlainTextClipboard() {
     this.editor.setOptions({
@@ -2468,6 +2470,23 @@ var EditorController = class {
   replaceRange(from, to, text) {
     this.editor.chain().focus().deleteRange({ from, to }).insertContentAt(from, text).run();
   }
+  getCurrentContentString() {
+    if (this.plainTextMode) return this.getPlainText();
+    if (this.markdownMode) return this.getMarkdown();
+    return this.editor.getHTML();
+  }
+  isDirty() {
+    return this.getCurrentContentString() !== this.baselineContent;
+  }
+  setCheckpoint(content) {
+    this.baselineContent = content !== void 0 ? content : this.getCurrentContentString();
+  }
+  resetDirty() {
+    this.setCheckpoint();
+  }
+  getBaselineContent() {
+    return this.baselineContent;
+  }
   destroy() {
     this.editor.destroy();
   }
@@ -3750,10 +3769,76 @@ var SpreadsheetController = class {
     this.onDocumentChange?.(this.document);
   }
 };
+
+// src/dirty.ts
+function defaultIsEqual(a, b) {
+  if (Object.is(a, b)) return true;
+  if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) {
+    return false;
+  }
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    for (let i = 0; i < a.length; i++) {
+      if (!defaultIsEqual(a[i], b[i])) return false;
+    }
+    return true;
+  }
+  if (Array.isArray(a) !== Array.isArray(b)) {
+    return false;
+  }
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+    if (!defaultIsEqual(a[key], b[key])) return false;
+  }
+  return true;
+}
+var DirtyTracker = class {
+  baseline;
+  isEqual;
+  constructor(initialBaseline, options) {
+    this.baseline = initialBaseline;
+    if (typeof options === "function") {
+      this.isEqual = options;
+    } else {
+      this.isEqual = options?.isEqual ?? defaultIsEqual;
+    }
+  }
+  /**
+   * Returns current baseline value.
+   */
+  getBaseline() {
+    return this.baseline;
+  }
+  /**
+   * Sets a new baseline value without triggering any dirty state.
+   */
+  setBaseline(value) {
+    this.baseline = value;
+  }
+  /**
+   * Checks whether the given value differs from the baseline.
+   */
+  isDirty(current) {
+    return !this.isEqual(this.baseline, current);
+  }
+  /**
+   * Resets the baseline to the provided current value (or clears dirty status).
+   */
+  reset(current) {
+    this.baseline = current;
+  }
+};
+function createDirtyTracker(initialBaseline, options) {
+  return new DirtyTracker(initialBaseline, options);
+}
 export {
   ColorHighlighter,
   DataSourceBinder,
   DependencyGraph,
+  DirtyTracker,
   EditorController,
   FontSize,
   FormulaEvaluator,
@@ -3771,9 +3856,11 @@ export {
   TemplateSuggestions,
   VARIABLE_REGEX,
   colNameToIndex,
+  createDirtyTracker,
   createEditor,
   createMentionExtension,
   createRichTextPreset,
+  defaultIsEqual,
   escapeHtml,
   extractCellDependencies,
   extractInstructionNames,