@pixerate/editor 0.22.0 → 0.24.0

package/dist/{track-changes-BSF58RK0.d.cts → track-changes-BK5sVf4_.d.cts}

@@ -5,6 +5,7 @@ import { MentionOptions as MentionOptions$1 } from '@tiptap/extension-mention';
 import { SuggestionOptions } from '@tiptap/suggestion';
 import { EditorState, PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
+import { R as ReviewAuthor } from './comment-store-BEMgVlAA.cjs';
 
 interface MentionEntity {
     id: string;
@@ -32,140 +33,6 @@ declare const Mention: _tiptap_core.Node<MentionOptions$1<any, _tiptap_extension
  */
 declare function createMentionExtension(options?: Partial<MentionOptions>): _tiptap_core.Node<MentionOptions$1<any, _tiptap_extension_mention.MentionNodeAttrs>, any>;
 
-/**
- * Who made a comment, reply or tracked change.
- */
-interface ReviewAuthor {
-    id: string;
-    name: string;
-    color?: string;
-    avatarUrl?: string;
-}
-/**
- * Where a comment thread is attached in the document. `from`/`to` are
- * ProseMirror positions and `quote` is the commented text at the time the
- * anchor was last synced. Positions are only meaningful for the current
- * document; the `comment` mark in the document is the source of truth.
- */
-interface CommentAnchor {
-    from: number;
-    to: number;
-    quote: string;
-}
-interface CommentReply {
-    id: string;
-    author: ReviewAuthor;
-    body: string;
-    createdAt: number;
-    editedAt?: number;
-}
-interface CommentThread {
-    id: string;
-    /** `null` while the thread has no text in the document (see `orphaned`). */
-    anchor: CommentAnchor | null;
-    author: ReviewAuthor;
-    createdAt: number;
-    /** An empty body marks a draft that has not been posted yet. */
-    body: string;
-    editedAt?: number;
-    replies: CommentReply[];
-    resolved: boolean;
-    resolvedAt?: number;
-    resolvedBy?: ReviewAuthor;
-    /**
-     * True when the commented text was deleted from the document. Undoing the
-     * deletion re-attaches the thread.
-     */
-    orphaned: boolean;
-    /** The quote the thread had before it was orphaned. */
-    lastQuote?: string;
-}
-interface CommentStoreSnapshot {
-    /** Threads in document order (anchored first), then orphaned threads. */
-    threads: readonly CommentThread[];
-    activeThreadId: string | null;
-}
-/** JSON shape produced by `CommentStore.toJSON()`. */
-interface SerializedComments {
-    version: 1;
-    threads: CommentThread[];
-}
-interface CommentStoreOptions {
-    threads?: CommentThread[] | SerializedComments;
-    generateId?: () => string;
-    now?: () => number;
-}
-interface CreateThreadInput {
-    id?: string;
-    body: string;
-    author: ReviewAuthor;
-    anchor?: CommentAnchor | null;
-    createdAt?: number;
-}
-type CommentStoreListener = (snapshot: CommentStoreSnapshot) => void;
-/**
- * Generates a reasonably unique id without depending on `crypto`.
- */
-declare function createReviewId(prefix?: string): string;
-/**
- * Headless, framework-agnostic store of comment threads.
- *
- * The store never talks to a server: persist `toJSON()` yourself and pass it
- * back via `new CommentStore({ threads })` or `load()`. Snapshots are
- * immutable and only replaced when something changes, so `getSnapshot` is safe
- * to use with React's `useSyncExternalStore`. `subscribe` calls the listener
- * immediately (Svelte store contract).
- */
-declare class CommentStore {
-    private threads;
-    private activeThreadId;
-    private snapshot;
-    private listeners;
-    /** Deleted threads, kept so undoing a "Delete Comment" can restore them. */
-    private deleted;
-    private generateId;
-    private now;
-    constructor(options?: CommentStoreOptions);
-    /** Parses `toJSON()` output (or a plain thread array). */
-    static parse(json: string | CommentThread[] | SerializedComments): CommentThread[];
-    subscribe: (listener: CommentStoreListener) => (() => void);
-    getSnapshot: () => CommentStoreSnapshot;
-    getThread(id: string): CommentThread | undefined;
-    createThread(input: CreateThreadInput): CommentThread;
-    /** Edits the thread's body, or one of its replies when `replyId` is given. */
-    editComment(threadId: string, body: string, replyId?: string): boolean;
-    addReply(threadId: string, input: {
-        body: string;
-        author: ReviewAuthor;
-        id?: string;
-    }): CommentReply | null;
-    deleteReply(threadId: string, replyId: string): boolean;
-    resolveThread(id: string, resolved?: boolean, by?: ReviewAuthor): boolean;
-    deleteThread(id: string): boolean;
-    /** Deletes every thread whose text is no longer in the document. */
-    removeOrphanedThreads(): string[];
-    setActiveThread(id: string | null): void;
-    /**
-     * Updates anchors from the document. Threads missing from `anchors` become
-     * orphaned. Threads that were deleted but whose mark re-appeared (e.g. after
-     * undoing "Delete Comment") are restored. Returns true if anything changed.
-     */
-    syncAnchors(anchors: Map<string, CommentAnchor>): boolean;
-    /** Replaces all threads, e.g. with data loaded from a server. */
-    load(json: string | CommentThread[] | SerializedComments): void;
-    clear(): void;
-    toJSON(): SerializedComments;
-    private updateThread;
-    private computeSnapshot;
-    private emit;
-}
-declare function createCommentStore(options?: CommentStoreOptions): CommentStore;
-/**
- * Short, human-readable timestamp for review UIs ("just now", "5m ago",
- * "3h ago", then a locale date). Shared by the React and Svelte components.
- */
-declare function formatReviewTime(timestamp: number, now?: number): string;
-
 declare const INSERTION_MARK_NAME = "insertion";
 declare const DELETION_MARK_NAME = "deletion";
 /** Mark recording a tracked formatting change (mark added/removed on existing text). */
@@ -215,9 +82,16 @@ interface TrackedBlockSnapshot {
         attrs: Record<string, any>;
     }[];
 }
+/**
+ * Whole-block operation of a `blockChange` record: the block was inserted
+ * (rejecting removes it) or deleted (accepting removes it). Produced by
+ * `compareDocuments`; absent for type/attribute/wrapping changes.
+ */
+type TrackedBlockOperation = "insert" | "delete";
 /** Value of the `blockChange` node attribute. */
 interface TrackedBlockChangeAttributes extends TrackedChangeAttributes {
     previous: TrackedBlockSnapshot;
+    operation?: TrackedBlockOperation;
 }
 interface TrackedFormatSummary {
     /** Labels of added formatting, e.g. `["Bold"]`. */
@@ -249,10 +123,14 @@ interface TrackedChange {
     description: string;
     /** Formatting changes (`type: "format"`). */
     format?: TrackedFormatSummary;
-    /** Block changes (`type: "block"`): the first block's previous and current state. */
+    /**
+     * Block changes (`type: "block"`): the first block's previous and current
+     * state, and the whole-block operation for inserted/deleted blocks.
+     */
     block?: {
         previous: TrackedBlockSnapshot;
         current: TrackedBlockSnapshot;
+        operation?: TrackedBlockOperation;
     };
 }
 interface TrackChangesSnapshot {
@@ -275,6 +153,10 @@ interface TrackChangesOptions {
     formatChangeHTMLAttributes: Record<string, any>;
     /** Class added to blocks with a tracked block change (margin bar by default). */
     blockChangeClass: string;
+    /** Extra class of wholly inserted blocks (`blockChange.operation: "insert"`, from comparisons). */
+    blockInsertedClass: string;
+    /** Extra class of wholly deleted blocks (`blockChange.operation: "delete"`, from comparisons). */
+    blockDeletedClass: string;
     /** Track mark changes (bold, links, font size, …) on existing text. Default `true`. */
     trackFormatting: boolean;
     /** Track textblock type/attribute and wrapping (list, quote) changes. Default `true`. */
@@ -386,4 +268,4 @@ declare function resolveTrackedChanges(doc: Node, view?: TrackedChangesView): No
  */
 declare const TrackChanges: Extension<TrackChangesOptions, TrackChangesStorage>;
 
-export { createCommentStore as A, BLOCK_CHANGE_ATTRIBUTE as B, type CommentAnchor as C, DELETION_MARK_NAME as D, createMentionExtension as E, FORMAT_CHANGE_MARK_NAME as F, createReviewId as G, describeBlockChange as H, INSERTION_MARK_NAME as I, describeFormatChange as J, formatReviewTime as K, getTrackChangesStore as L, Mention as M, getTrackedChangeAt as N, getTrackedChanges as O, isTrackChangesEnabled as P, resolveTrackedChanges as Q, type ReviewAuthor as R, type SerializedComments as S, TRACK_CHANGES_SKIP_META as T, trackChangesPluginKey as U, type CommentReply as a, CommentStore as b, type CommentStoreListener as c, type CommentStoreOptions as d, type CommentStoreSnapshot as e, type CommentThread as f, type CreateThreadInput as g, type MentionEntity as h, type MentionOptions as i, TrackChanges as j, type TrackChangesOptions as k, type TrackChangesSnapshot as l, type TrackChangesStorage as m, TrackChangesStore as n, type TrackedBlockChangeAttributes as o, type TrackedBlockSnapshot as p, type TrackedChange as q, type TrackedChangeAttributes as r, type TrackedChangeType as s, type TrackedChangesView as t, TrackedDeletion as u, TrackedFormatChange as v, type TrackedFormatChangeAttributes as w, type TrackedFormatSummary as x, TrackedInsertion as y, type TrackedMark as z };
+export { isTrackChangesEnabled as A, BLOCK_CHANGE_ATTRIBUTE as B, resolveTrackedChanges as C, DELETION_MARK_NAME as D, trackChangesPluginKey as E, FORMAT_CHANGE_MARK_NAME as F, INSERTION_MARK_NAME as I, Mention as M, TRACK_CHANGES_SKIP_META as T, type MentionEntity as a, type MentionOptions as b, TrackChanges as c, type TrackChangesOptions as d, type TrackChangesSnapshot as e, type TrackChangesStorage as f, TrackChangesStore as g, type TrackedBlockChangeAttributes as h, type TrackedBlockOperation as i, type TrackedBlockSnapshot as j, type TrackedChange as k, type TrackedChangeAttributes as l, type TrackedChangeType as m, type TrackedChangesView as n, TrackedDeletion as o, TrackedFormatChange as p, type TrackedFormatChangeAttributes as q, type TrackedFormatSummary as r, TrackedInsertion as s, type TrackedMark as t, createMentionExtension as u, describeBlockChange as v, describeFormatChange as w, getTrackChangesStore as x, getTrackedChangeAt as y, getTrackedChanges as z };

package/dist/{track-changes-BSF58RK0.d.ts → track-changes-CDjCrwKe.d.ts}

@@ -5,6 +5,7 @@ import { MentionOptions as MentionOptions$1 } from '@tiptap/extension-mention';
 import { SuggestionOptions } from '@tiptap/suggestion';
 import { EditorState, PluginKey } from '@tiptap/pm/state';
 import { Node } from '@tiptap/pm/model';
+import { R as ReviewAuthor } from './comment-store-BEMgVlAA.js';
 
 interface MentionEntity {
     id: string;
@@ -32,140 +33,6 @@ declare const Mention: _tiptap_core.Node<MentionOptions$1<any, _tiptap_extension
  */
 declare function createMentionExtension(options?: Partial<MentionOptions>): _tiptap_core.Node<MentionOptions$1<any, _tiptap_extension_mention.MentionNodeAttrs>, any>;
 
-/**
- * Who made a comment, reply or tracked change.
- */
-interface ReviewAuthor {
-    id: string;
-    name: string;
-    color?: string;
-    avatarUrl?: string;
-}
-/**
- * Where a comment thread is attached in the document. `from`/`to` are
- * ProseMirror positions and `quote` is the commented text at the time the
- * anchor was last synced. Positions are only meaningful for the current
- * document; the `comment` mark in the document is the source of truth.
- */
-interface CommentAnchor {
-    from: number;
-    to: number;
-    quote: string;
-}
-interface CommentReply {
-    id: string;
-    author: ReviewAuthor;
-    body: string;
-    createdAt: number;
-    editedAt?: number;
-}
-interface CommentThread {
-    id: string;
-    /** `null` while the thread has no text in the document (see `orphaned`). */
-    anchor: CommentAnchor | null;
-    author: ReviewAuthor;
-    createdAt: number;
-    /** An empty body marks a draft that has not been posted yet. */
-    body: string;
-    editedAt?: number;
-    replies: CommentReply[];
-    resolved: boolean;
-    resolvedAt?: number;
-    resolvedBy?: ReviewAuthor;
-    /**
-     * True when the commented text was deleted from the document. Undoing the
-     * deletion re-attaches the thread.
-     */
-    orphaned: boolean;
-    /** The quote the thread had before it was orphaned. */
-    lastQuote?: string;
-}
-interface CommentStoreSnapshot {
-    /** Threads in document order (anchored first), then orphaned threads. */
-    threads: readonly CommentThread[];
-    activeThreadId: string | null;
-}
-/** JSON shape produced by `CommentStore.toJSON()`. */
-interface SerializedComments {
-    version: 1;
-    threads: CommentThread[];
-}
-interface CommentStoreOptions {
-    threads?: CommentThread[] | SerializedComments;
-    generateId?: () => string;
-    now?: () => number;
-}
-interface CreateThreadInput {
-    id?: string;
-    body: string;
-    author: ReviewAuthor;
-    anchor?: CommentAnchor | null;
-    createdAt?: number;
-}
-type CommentStoreListener = (snapshot: CommentStoreSnapshot) => void;
-/**
- * Generates a reasonably unique id without depending on `crypto`.
- */
-declare function createReviewId(prefix?: string): string;
-/**
- * Headless, framework-agnostic store of comment threads.
- *
- * The store never talks to a server: persist `toJSON()` yourself and pass it
- * back via `new CommentStore({ threads })` or `load()`. Snapshots are
- * immutable and only replaced when something changes, so `getSnapshot` is safe
- * to use with React's `useSyncExternalStore`. `subscribe` calls the listener
- * immediately (Svelte store contract).
- */
-declare class CommentStore {
-    private threads;
-    private activeThreadId;
-    private snapshot;
-    private listeners;
-    /** Deleted threads, kept so undoing a "Delete Comment" can restore them. */
-    private deleted;
-    private generateId;
-    private now;
-    constructor(options?: CommentStoreOptions);
-    /** Parses `toJSON()` output (or a plain thread array). */
-    static parse(json: string | CommentThread[] | SerializedComments): CommentThread[];
-    subscribe: (listener: CommentStoreListener) => (() => void);
-    getSnapshot: () => CommentStoreSnapshot;
-    getThread(id: string): CommentThread | undefined;
-    createThread(input: CreateThreadInput): CommentThread;
-    /** Edits the thread's body, or one of its replies when `replyId` is given. */
-    editComment(threadId: string, body: string, replyId?: string): boolean;
-    addReply(threadId: string, input: {
-        body: string;
-        author: ReviewAuthor;
-        id?: string;
-    }): CommentReply | null;
-    deleteReply(threadId: string, replyId: string): boolean;
-    resolveThread(id: string, resolved?: boolean, by?: ReviewAuthor): boolean;
-    deleteThread(id: string): boolean;
-    /** Deletes every thread whose text is no longer in the document. */
-    removeOrphanedThreads(): string[];
-    setActiveThread(id: string | null): void;
-    /**
-     * Updates anchors from the document. Threads missing from `anchors` become
-     * orphaned. Threads that were deleted but whose mark re-appeared (e.g. after
-     * undoing "Delete Comment") are restored. Returns true if anything changed.
-     */
-    syncAnchors(anchors: Map<string, CommentAnchor>): boolean;
-    /** Replaces all threads, e.g. with data loaded from a server. */
-    load(json: string | CommentThread[] | SerializedComments): void;
-    clear(): void;
-    toJSON(): SerializedComments;
-    private updateThread;
-    private computeSnapshot;
-    private emit;
-}
-declare function createCommentStore(options?: CommentStoreOptions): CommentStore;
-/**
- * Short, human-readable timestamp for review UIs ("just now", "5m ago",
- * "3h ago", then a locale date). Shared by the React and Svelte components.
- */
-declare function formatReviewTime(timestamp: number, now?: number): string;
-
 declare const INSERTION_MARK_NAME = "insertion";
 declare const DELETION_MARK_NAME = "deletion";
 /** Mark recording a tracked formatting change (mark added/removed on existing text). */
@@ -215,9 +82,16 @@ interface TrackedBlockSnapshot {
         attrs: Record<string, any>;
     }[];
 }
+/**
+ * Whole-block operation of a `blockChange` record: the block was inserted
+ * (rejecting removes it) or deleted (accepting removes it). Produced by
+ * `compareDocuments`; absent for type/attribute/wrapping changes.
+ */
+type TrackedBlockOperation = "insert" | "delete";
 /** Value of the `blockChange` node attribute. */
 interface TrackedBlockChangeAttributes extends TrackedChangeAttributes {
     previous: TrackedBlockSnapshot;
+    operation?: TrackedBlockOperation;
 }
 interface TrackedFormatSummary {
     /** Labels of added formatting, e.g. `["Bold"]`. */
@@ -249,10 +123,14 @@ interface TrackedChange {
     description: string;
     /** Formatting changes (`type: "format"`). */
     format?: TrackedFormatSummary;
-    /** Block changes (`type: "block"`): the first block's previous and current state. */
+    /**
+     * Block changes (`type: "block"`): the first block's previous and current
+     * state, and the whole-block operation for inserted/deleted blocks.
+     */
     block?: {
         previous: TrackedBlockSnapshot;
         current: TrackedBlockSnapshot;
+        operation?: TrackedBlockOperation;
     };
 }
 interface TrackChangesSnapshot {
@@ -275,6 +153,10 @@ interface TrackChangesOptions {
     formatChangeHTMLAttributes: Record<string, any>;
     /** Class added to blocks with a tracked block change (margin bar by default). */
     blockChangeClass: string;
+    /** Extra class of wholly inserted blocks (`blockChange.operation: "insert"`, from comparisons). */
+    blockInsertedClass: string;
+    /** Extra class of wholly deleted blocks (`blockChange.operation: "delete"`, from comparisons). */
+    blockDeletedClass: string;
     /** Track mark changes (bold, links, font size, …) on existing text. Default `true`. */
     trackFormatting: boolean;
     /** Track textblock type/attribute and wrapping (list, quote) changes. Default `true`. */
@@ -386,4 +268,4 @@ declare function resolveTrackedChanges(doc: Node, view?: TrackedChangesView): No
  */
 declare const TrackChanges: Extension<TrackChangesOptions, TrackChangesStorage>;
 
-export { createCommentStore as A, BLOCK_CHANGE_ATTRIBUTE as B, type CommentAnchor as C, DELETION_MARK_NAME as D, createMentionExtension as E, FORMAT_CHANGE_MARK_NAME as F, createReviewId as G, describeBlockChange as H, INSERTION_MARK_NAME as I, describeFormatChange as J, formatReviewTime as K, getTrackChangesStore as L, Mention as M, getTrackedChangeAt as N, getTrackedChanges as O, isTrackChangesEnabled as P, resolveTrackedChanges as Q, type ReviewAuthor as R, type SerializedComments as S, TRACK_CHANGES_SKIP_META as T, trackChangesPluginKey as U, type CommentReply as a, CommentStore as b, type CommentStoreListener as c, type CommentStoreOptions as d, type CommentStoreSnapshot as e, type CommentThread as f, type CreateThreadInput as g, type MentionEntity as h, type MentionOptions as i, TrackChanges as j, type TrackChangesOptions as k, type TrackChangesSnapshot as l, type TrackChangesStorage as m, TrackChangesStore as n, type TrackedBlockChangeAttributes as o, type TrackedBlockSnapshot as p, type TrackedChange as q, type TrackedChangeAttributes as r, type TrackedChangeType as s, type TrackedChangesView as t, TrackedDeletion as u, TrackedFormatChange as v, type TrackedFormatChangeAttributes as w, type TrackedFormatSummary as x, TrackedInsertion as y, type TrackedMark as z };
+export { isTrackChangesEnabled as A, BLOCK_CHANGE_ATTRIBUTE as B, resolveTrackedChanges as C, DELETION_MARK_NAME as D, trackChangesPluginKey as E, FORMAT_CHANGE_MARK_NAME as F, INSERTION_MARK_NAME as I, Mention as M, TRACK_CHANGES_SKIP_META as T, type MentionEntity as a, type MentionOptions as b, TrackChanges as c, type TrackChangesOptions as d, type TrackChangesSnapshot as e, type TrackChangesStorage as f, TrackChangesStore as g, type TrackedBlockChangeAttributes as h, type TrackedBlockOperation as i, type TrackedBlockSnapshot as j, type TrackedChange as k, type TrackedChangeAttributes as l, type TrackedChangeType as m, type TrackedChangesView as n, TrackedDeletion as o, TrackedFormatChange as p, type TrackedFormatChangeAttributes as q, type TrackedFormatSummary as r, TrackedInsertion as s, type TrackedMark as t, createMentionExtension as u, describeBlockChange as v, describeFormatChange as w, getTrackChangesStore as x, getTrackedChangeAt as y, getTrackedChanges as z };

package/dist/{types-CJ4U-HHI.d.ts → types-DX4Mh4SL.d.cts}

@@ -214,4 +214,4 @@ interface CanvasDockingCallbacks<TNode extends CanvasNode = CanvasNode> {
     onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void;
 }
 
-export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasEdge as a, CanvasLayoutOptions as b, CanvasNodeStyle as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };
+export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasNodeStyle as a, CanvasEdge as b, CanvasLayoutOptions as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };

package/dist/{types-CJ4U-HHI.d.cts → types-DX4Mh4SL.d.ts}

@@ -214,4 +214,4 @@ interface CanvasDockingCallbacks<TNode extends CanvasNode = CanvasNode> {
     onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void;
 }
 
-export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasEdge as a, CanvasLayoutOptions as b, CanvasNodeStyle as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };
+export type { CanvasNode as C, DirectionalDisplacementOptions as D, ExplodeNodeOptions as E, FanOutTrajectoryOptions as F, GraphDifferences as G, IncrementalLayoutOptions as I, NodeTransition as N, PlaceBesideOptions as P, Rect as R, Side as S, TrajectoryFunction as T, XYPosition as X, CanvasNodeStyle as a, CanvasEdge as b, CanvasLayoutOptions as c, ReflowDisplacementOptions as d, CanvasClipboardPayload as e, Position as f, Point as g, CanvasDockingCallbacks as h, CollapseNodeOptions as i, DisplacementDirection as j, DockStrategy as k, ExplosionSnapshot as l, TrajectoryPoint as m };

package/dist/types-GT5a5YAX.d.cts

@@ -0,0 +1,86 @@
+interface Command {
+    execute: () => void;
+    undo: () => void;
+    redo?: () => void;
+    name: string;
+    tag?: string;
+    timestamp?: number;
+    /**
+     * Approximate memory held by this command (closures, snapshots), in bytes.
+     * Counted against `HistoryManagerOptions.maxBytes` when no `sizeOf` hook is set.
+     */
+    byteSize?: number;
+}
+interface HistoryState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoName: string;
+    redoName: string;
+    undoCount: number;
+    redoCount: number;
+}
+interface HistoryManagerOptions {
+    /**
+     * Maximum number of undo states to keep. Defaults to 50.
+     */
+    maxDepth?: number;
+    /**
+     * Approximate memory budget in bytes for the undo and redo stacks
+     * (0 or omitted = unlimited). The oldest undo steps that do not fit are
+     * dropped; the most recent one is always kept so the last step can be undone.
+     */
+    maxBytes?: number;
+    /**
+     * Measures a command for `maxBytes`. Defaults to `command.byteSize ?? 0`.
+     */
+    sizeOf?: (command: Command) => number;
+    /**
+     * Optional callback fired whenever the history state changes.
+     */
+    onStateChange?: (state: HistoryState) => void;
+}
+interface SnapshotCommandOptions<T> {
+    name: string;
+    before: T;
+    after: T;
+    apply: (state: T) => void;
+    tag?: string;
+}
+interface MergedExecutionOptions {
+    /**
+     * Window in milliseconds during which commands with the same tag will be coalesced.
+     * Defaults to 300ms. Ignored when `key` is set or a gesture is held.
+     */
+    windowMs?: number;
+    /**
+     * Gesture key. Consecutive merged executes with the same key fold into one
+     * undo step regardless of timing, until another command is recorded, undo /
+     * redo / `revertTo` / `goTo` runs, or `endGesture()` is called.
+     */
+    key?: string;
+}
+/** One row of a History panel (see `HistoryManager.getEntries`). */
+interface HistoryEntry {
+    /** Stable id of the step (unchanged while a gesture merges into it). */
+    id: number;
+    /** The step's command name. */
+    label: string;
+    /** Position in the timeline: undo steps first (oldest = 0), then redo steps. */
+    index: number;
+    /** True for the step that produced the current state (the top of the undo stack). */
+    current: boolean;
+    /** True for steps on the redo stack (undone, can be redone). */
+    undone: boolean;
+}
+/**
+ * A point in the undo history, from `HistoryManager.mark()`, for `revertTo`.
+ * Treat it as opaque.
+ */
+interface HistoryMark {
+    readonly topId: number | null;
+    readonly nextId: number;
+    readonly epoch: number;
+    readonly dropped: number;
+}
+
+export type { Command as C, HistoryState as H, MergedExecutionOptions as M, SnapshotCommandOptions as S, HistoryEntry as a, HistoryManagerOptions as b, HistoryMark as c };

package/dist/types-GT5a5YAX.d.ts

@@ -0,0 +1,86 @@
+interface Command {
+    execute: () => void;
+    undo: () => void;
+    redo?: () => void;
+    name: string;
+    tag?: string;
+    timestamp?: number;
+    /**
+     * Approximate memory held by this command (closures, snapshots), in bytes.
+     * Counted against `HistoryManagerOptions.maxBytes` when no `sizeOf` hook is set.
+     */
+    byteSize?: number;
+}
+interface HistoryState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoName: string;
+    redoName: string;
+    undoCount: number;
+    redoCount: number;
+}
+interface HistoryManagerOptions {
+    /**
+     * Maximum number of undo states to keep. Defaults to 50.
+     */
+    maxDepth?: number;
+    /**
+     * Approximate memory budget in bytes for the undo and redo stacks
+     * (0 or omitted = unlimited). The oldest undo steps that do not fit are
+     * dropped; the most recent one is always kept so the last step can be undone.
+     */
+    maxBytes?: number;
+    /**
+     * Measures a command for `maxBytes`. Defaults to `command.byteSize ?? 0`.
+     */
+    sizeOf?: (command: Command) => number;
+    /**
+     * Optional callback fired whenever the history state changes.
+     */
+    onStateChange?: (state: HistoryState) => void;
+}
+interface SnapshotCommandOptions<T> {
+    name: string;
+    before: T;
+    after: T;
+    apply: (state: T) => void;
+    tag?: string;
+}
+interface MergedExecutionOptions {
+    /**
+     * Window in milliseconds during which commands with the same tag will be coalesced.
+     * Defaults to 300ms. Ignored when `key` is set or a gesture is held.
+     */
+    windowMs?: number;
+    /**
+     * Gesture key. Consecutive merged executes with the same key fold into one
+     * undo step regardless of timing, until another command is recorded, undo /
+     * redo / `revertTo` / `goTo` runs, or `endGesture()` is called.
+     */
+    key?: string;
+}
+/** One row of a History panel (see `HistoryManager.getEntries`). */
+interface HistoryEntry {
+    /** Stable id of the step (unchanged while a gesture merges into it). */
+    id: number;
+    /** The step's command name. */
+    label: string;
+    /** Position in the timeline: undo steps first (oldest = 0), then redo steps. */
+    index: number;
+    /** True for the step that produced the current state (the top of the undo stack). */
+    current: boolean;
+    /** True for steps on the redo stack (undone, can be redone). */
+    undone: boolean;
+}
+/**
+ * A point in the undo history, from `HistoryManager.mark()`, for `revertTo`.
+ * Treat it as opaque.
+ */
+interface HistoryMark {
+    readonly topId: number | null;
+    readonly nextId: number;
+    readonly epoch: number;
+    readonly dropped: number;
+}
+
+export type { Command as C, HistoryState as H, MergedExecutionOptions as M, SnapshotCommandOptions as S, HistoryEntry as a, HistoryManagerOptions as b, HistoryMark as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -58,10 +58,31 @@
       "types": "./dist/image-editor/index.d.ts",
       "import": "./dist/image-editor/index.js",
       "require": "./dist/image-editor/index.cjs"
+    },
+    "./commands": {
+      "types": "./dist/commands/index.d.ts",
+      "import": "./dist/commands/index.js",
+      "require": "./dist/commands/index.cjs"
+    },
+    "./persistence": {
+      "types": "./dist/persistence/index.d.ts",
+      "import": "./dist/persistence/index.js",
+      "require": "./dist/persistence/index.cjs"
+    },
+    "./generation": {
+      "types": "./dist/generation/index.d.ts",
+      "import": "./dist/generation/index.js",
+      "require": "./dist/generation/index.cjs"
+    },
+    "./compare": {
+      "types": "./dist/compare/index.d.ts",
+      "import": "./dist/compare/index.js",
+      "require": "./dist/compare/index.cjs"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": false,
   "dependencies": {