@pixerate/editor 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { T as Token } from './tokens-7kRTEtPb.cjs';
 export { C as ColorGradient, I as INSTRUCTION_REGEX, a as TEMPLATE_REGEX, b as Template, c as TemplateVersion, d as TokenType, V as VARIABLE_REGEX, i as instructionRegex, t as templateRegex, v as variableRegex } from './tokens-7kRTEtPb.cjs';
 export { ResolveTemplatesOptions, SourceMapSegment, extractInstructionNames, extractTemplateNames, extractVariableNames, getLatestVersion, mapRawOffsetToResolved, mapResolvedOffsetToRaw, resolveTemplates, resolveTemplatesWithMapping, resolveVariables, tokenizePrompt } from './grammar/index.cjs';
-export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, Mention, MentionEntity, MentionOptions, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createMentionExtension, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, updateImageSrc } from './extensions/index.cjs';
+export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, Mention, MentionEntity, MentionOptions, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createMentionExtension, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, removeImageNode, updateImageSrc } from './extensions/index.cjs';
 export { ExtractedMention, escapeHtml, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, plainTextToTipTapHtml } from './serializers/index.cjs';
 import { Editor, EditorOptions, Content, Extensions } from '@tiptap/core';
 export { Content, Editor, EditorOptions, Extensions } from '@tiptap/core';
@@ -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

@@ -1,7 +1,7 @@
 import { T as Token } from './tokens-7kRTEtPb.js';
 export { C as ColorGradient, I as INSTRUCTION_REGEX, a as TEMPLATE_REGEX, b as Template, c as TemplateVersion, d as TokenType, V as VARIABLE_REGEX, i as instructionRegex, t as templateRegex, v as variableRegex } from './tokens-7kRTEtPb.js';
 export { ResolveTemplatesOptions, SourceMapSegment, extractInstructionNames, extractTemplateNames, extractVariableNames, getLatestVersion, mapRawOffsetToResolved, mapResolvedOffsetToRaw, resolveTemplates, resolveTemplatesWithMapping, resolveVariables, tokenizePrompt } from './grammar/index.js';
-export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, Mention, MentionEntity, MentionOptions, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createMentionExtension, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, updateImageSrc } from './extensions/index.js';
+export { ColorHighlighter, FontSize, GradientText, GradientTextOptions, Image, ImageOptions, LoadingNode, Markdown, Mention, MentionEntity, MentionOptions, RichTextPresetOptions, SlashCommandMatchData, SlashCommands, SlashCommandsOptions, SmilieReplacer, TemplateSuggestions, TemplateSuggestionsOptions, createMentionExtension, createRichTextPreset, findHexColors, handleImageInsertion, imagePastePluginKey, insertImageNode, removeImageNode, updateImageSrc } from './extensions/index.js';
 export { ExtractedMention, escapeHtml, extractMentionsFromDoc, getEditorMarkdown, getEditorText, htmlToPlainText, markdownToTipTapHtml, plainTextToTipTapHtml } from './serializers/index.js';
 import { Editor, EditorOptions, Content, Extensions } from '@tiptap/core';
 export { Content, Editor, EditorOptions, Extensions } from '@tiptap/core';
@@ -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

@@ -1919,6 +1919,22 @@ function updateImageSrc(view, oldSrc, newSrc) {
     view.dispatch(tr);
   }
 }
+function removeImageNode(view, src) {
+  const { doc } = view.state;
+  let foundPos = null;
+  let nodeSize = 0;
+  doc.descendants((node, pos) => {
+    if (node.type.name === "image" && node.attrs.src === src) {
+      foundPos = pos;
+      nodeSize = node.nodeSize;
+      return false;
+    }
+  });
+  if (foundPos !== null) {
+    const tr = view.state.tr.delete(foundPos, foundPos + nodeSize);
+    view.dispatch(tr);
+  }
+}
 function handleImageInsertion(view, file, options) {
   if (typeof options.upload === "function") {
     const hasObjectUrl = typeof URL !== "undefined" && typeof URL.createObjectURL === "function";
@@ -1927,7 +1943,9 @@ function handleImageInsertion(view, file, options) {
       insertImageNode(view, tempUrl, file.name);
     }
     Promise.resolve(options.upload(file)).then((uploadedUrl) => {
-      if (!uploadedUrl) return;
+      if (!uploadedUrl) {
+        throw new Error("Upload handler returned empty URL");
+      }
       if (tempUrl) {
         updateImageSrc(view, tempUrl, uploadedUrl);
         if (typeof URL.revokeObjectURL === "function") {
@@ -1937,9 +1955,32 @@ function handleImageInsertion(view, file, options) {
         insertImageNode(view, uploadedUrl, file.name);
       }
     }).catch((err) => {
-      console.error("Failed to upload pasted image:", err);
+      const error = err instanceof Error ? err : new Error(String(err));
+      console.error("Failed to upload pasted image:", error);
+      if (tempUrl) {
+        removeImageNode(view, tempUrl);
+        if (typeof URL.revokeObjectURL === "function") {
+          URL.revokeObjectURL(tempUrl);
+        }
+      }
+      if (typeof options.onUploadError === "function") {
+        options.onUploadError(error, file);
+      }
     });
   } else if (options.allowBase64 !== false) {
+    const maxBase64Size = options.maxBase64Size ?? 65536;
+    if (file.size > maxBase64Size) {
+      const err = new Error(
+        `Image size (${Math.round(file.size / 1024)}KB) exceeds maxBase64Size (${Math.round(
+          maxBase64Size / 1024
+        )}KB). Provide an upload handler to support large images.`
+      );
+      console.warn(`[Editor] ${err.message}`);
+      if (typeof options.onUploadError === "function") {
+        options.onUploadError(err, file);
+      }
+      return;
+    }
     if (typeof FileReader !== "undefined") {
       const reader = new FileReader();
       reader.onload = () => {
@@ -1957,9 +1998,11 @@ var Image2 = BaseImage.extend({
     return {
       ...this.parent?.(),
       allowBase64: true,
+      maxBase64Size: 65536,
       enablePaste: true,
       enableDrop: true,
       upload: void 0,
+      onUploadError: void 0,
       HTMLAttributes: {
         class: "rounded-md max-w-full h-auto my-2"
       }
@@ -2315,6 +2358,7 @@ var EditorController = class {
   onMarkdownChange;
   onTokensChange;
   onSelectionChange;
+  baselineContent;
   constructor(options = {}) {
     const {
       element,
@@ -2352,6 +2396,7 @@ var EditorController = class {
     if (plainTextMode) {
       this.enforcePlainTextClipboard();
     }
+    this.baselineContent = this.getCurrentContentString();
   }
   enforcePlainTextClipboard() {
     this.editor.setOptions({
@@ -2425,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();
   }
@@ -3707,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,
@@ -3728,9 +3856,11 @@ export {
   TemplateSuggestions,
   VARIABLE_REGEX,
   colNameToIndex,
+  createDirtyTracker,
   createEditor,
   createMentionExtension,
   createRichTextPreset,
+  defaultIsEqual,
   escapeHtml,
   extractCellDependencies,
   extractInstructionNames,
@@ -3754,6 +3884,7 @@ export {
   parseFormula,
   parseRange,
   plainTextToTipTapHtml,
+  removeImageNode,
   resolveTemplates,
   resolveTemplatesWithMapping,
   resolveVariables,