@pixerate/editor 0.21.0 → 0.23.0

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

@@ -168,18 +168,22 @@ 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). */
+declare const FORMAT_CHANGE_MARK_NAME = "formatChange";
+/** Node attribute recording a tracked block change (type, attributes or wrapping). */
+declare const BLOCK_CHANGE_ATTRIBUTE = "blockChange";
 /**
  * Set this transaction meta to `true` to apply a change without tracking it,
  * e.g. `editor.chain().command(({ tr }) => { tr.setMeta(TRACK_CHANGES_SKIP_META, true); return true; }).setContent(…).run()`.
  */
 declare const TRACK_CHANGES_SKIP_META = "trackChangesSkip";
-type TrackedChangeType = "insertion" | "deletion";
+type TrackedChangeType = "insertion" | "deletion" | "format" | "block";
 /**
  * How tracked content is rendered by serializers:
  * - `accepted` (default): as if every change were accepted (deleted text is
- *   dropped, inserted text kept).
+ *   dropped, inserted text kept, new formatting and block types kept).
  * - `original`: as if every change were rejected.
- * - `all`: both inserted and deleted text.
+ * - `all`: both inserted and deleted text, current formatting and blocks.
  */
 type TrackedChangesView = "accepted" | "original" | "all";
 interface TrackedChangeAttributes {
@@ -189,6 +193,40 @@ interface TrackedChangeAttributes {
     authorColor: string | null;
     createdAt: number;
 }
+/** A serializable mark (`mark.toJSON()`). */
+interface TrackedMark {
+    type: string;
+    attrs?: Record<string, any>;
+}
+/** Attributes of the `formatChange` mark. */
+interface TrackedFormatChangeAttributes extends TrackedChangeAttributes {
+    /** Formatting marks before the change. */
+    before: TrackedMark[];
+    /** Formatting marks after the change. */
+    after: TrackedMark[];
+}
+/** A textblock's type, attributes and enclosing wrappers (lists, quotes). */
+interface TrackedBlockSnapshot {
+    type: string;
+    attrs: Record<string, any>;
+    /** Ancestors from the outermost (below the document) to the parent. */
+    wrappers: {
+        type: string;
+        attrs: Record<string, any>;
+    }[];
+}
+/** Value of the `blockChange` node attribute. */
+interface TrackedBlockChangeAttributes extends TrackedChangeAttributes {
+    previous: TrackedBlockSnapshot;
+}
+interface TrackedFormatSummary {
+    /** Labels of added formatting, e.g. `["Bold"]`. */
+    added: string[];
+    /** Labels of removed formatting. */
+    removed: string[];
+    /** Labels of changed formatting (same mark, different attributes), e.g. `["Font size"]`. */
+    changed: string[];
+}
 interface TrackedChange {
     id: string;
     type: TrackedChangeType;
@@ -198,12 +236,24 @@ interface TrackedChange {
     from: number;
     /** End of the last range. */
     to: number;
-    /** A change can be split into several ranges by other marks or blocks. */
+    /**
+     * A change can be split into several ranges by other marks or blocks.
+     * Block changes cover whole textblock nodes.
+     */
     ranges: {
         from: number;
         to: number;
     }[];
     text: string;
+    /** Human-readable summary, e.g. `Formatted: Bold` or `Changed Paragraph to Heading 2`. */
+    description: string;
+    /** Formatting changes (`type: "format"`). */
+    format?: TrackedFormatSummary;
+    /** Block changes (`type: "block"`): the first block's previous and current state. */
+    block?: {
+        previous: TrackedBlockSnapshot;
+        current: TrackedBlockSnapshot;
+    };
 }
 interface TrackChangesSnapshot {
     enabled: boolean;
@@ -221,6 +271,25 @@ interface TrackChangesOptions {
     generateId: () => string;
     insertionHTMLAttributes: Record<string, any>;
     deletionHTMLAttributes: Record<string, any>;
+    /** HTML attributes (e.g. `class`) of tracked formatting. Replaces the default dotted underline. */
+    formatChangeHTMLAttributes: Record<string, any>;
+    /** Class added to blocks with a tracked block change (margin bar by default). */
+    blockChangeClass: 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`. */
+    trackBlocks: boolean;
+    /**
+     * Track insertions and deletions inside code blocks by allowing the
+     * insertion/deletion marks there. Default `true`.
+     */
+    trackCodeBlocks: boolean;
+    /** Textblock node types that can record block changes. */
+    blockTypes: string[];
+    /** Extra mark names not tracked as formatting. */
+    ignoredMarks: string[];
+    /** Node attributes ignored when comparing blocks (e.g. generated ids). */
+    ignoredBlockAttributes: string[];
 }
 /**
  * External store over the editor's tracked-change state. Snapshots only
@@ -277,12 +346,24 @@ declare const TrackedInsertion: Mark<{
 declare const TrackedDeletion: Mark<{
     HTMLAttributes: Record<string, any>;
 }, any>;
+/**
+ * Existing text whose formatting changed while tracking was on. Stores the
+ * formatting before and after the change, rendered as
+ * `<span data-change-type="format">` (dotted underline by default).
+ */
+declare const TrackedFormatChange: Mark<{
+    HTMLAttributes: Record<string, any>;
+}, any>;
+/** Describes a formatting change, e.g. `Formatted: Bold; Removed formatting: Italic`. */
+declare function describeFormatChange(summary: TrackedFormatSummary): string;
+/** Describes a block change, e.g. `Changed Paragraph to Heading 2`. */
+declare function describeBlockChange(previous: TrackedBlockSnapshot, current: TrackedBlockSnapshot, ignoredAttributes?: readonly string[]): string;
 /**
  * Lists tracked changes in document order. Accepts an editor, an editor
  * state or a ProseMirror document.
  */
 declare function getTrackedChanges(source: Editor | EditorState | Node | null | undefined): TrackedChange[];
-/** The change containing `pos` (defaults to the selection start). */
+/** The change containing `pos` (defaults to the selection start). Inline changes win over block changes. */
 declare function getTrackedChangeAt(state: EditorState, pos?: number, changes?: readonly TrackedChange[]): TrackedChange | null;
 declare function isTrackChangesEnabled(source: Editor | EditorState | null | undefined): boolean;
 /** Returns the tracked-changes store of an editor using `TrackChanges`. */
@@ -296,11 +377,13 @@ declare function resolveTrackedChanges(doc: Node, view?: TrackedChangesView): No
  * Suggestion mode / track changes. When enabled, typed and pasted content is
  * marked as an insertion and deleted content is kept but marked as a
  * deletion (struck through) until the change is accepted or rejected.
+ * Formatting changes on existing text are recorded with the `formatChange`
+ * mark, and textblock type/attribute/wrapping changes with the `blockChange`
+ * node attribute.
  *
- * Deleting your own insertion really deletes it. Formatting-only changes and
- * block-structure changes (splitting/joining paragraphs, lists) are not
- * tracked. IME composition is tracked once the composition ends.
+ * Deleting your own insertion really deletes it. Paragraph splits and joins
+ * are not tracked. IME composition is tracked once the composition ends.
  */
 declare const TrackChanges: Extension<TrackChangesOptions, TrackChangesStorage>;
 
-export { getTrackedChanges as A, isTrackChangesEnabled as B, type CommentAnchor as C, DELETION_MARK_NAME as D, resolveTrackedChanges as E, trackChangesPluginKey as F, INSERTION_MARK_NAME as I, Mention as M, type ReviewAuthor as R, type SerializedComments as S, TRACK_CHANGES_SKIP_META as T, 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 TrackedChange as o, type TrackedChangeAttributes as p, type TrackedChangeType as q, type TrackedChangesView as r, TrackedDeletion as s, TrackedInsertion as t, createCommentStore as u, createMentionExtension as v, createReviewId as w, formatReviewTime as x, getTrackChangesStore as y, getTrackedChangeAt as z };
+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 };

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

@@ -168,18 +168,22 @@ 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). */
+declare const FORMAT_CHANGE_MARK_NAME = "formatChange";
+/** Node attribute recording a tracked block change (type, attributes or wrapping). */
+declare const BLOCK_CHANGE_ATTRIBUTE = "blockChange";
 /**
  * Set this transaction meta to `true` to apply a change without tracking it,
  * e.g. `editor.chain().command(({ tr }) => { tr.setMeta(TRACK_CHANGES_SKIP_META, true); return true; }).setContent(…).run()`.
  */
 declare const TRACK_CHANGES_SKIP_META = "trackChangesSkip";
-type TrackedChangeType = "insertion" | "deletion";
+type TrackedChangeType = "insertion" | "deletion" | "format" | "block";
 /**
  * How tracked content is rendered by serializers:
  * - `accepted` (default): as if every change were accepted (deleted text is
- *   dropped, inserted text kept).
+ *   dropped, inserted text kept, new formatting and block types kept).
  * - `original`: as if every change were rejected.
- * - `all`: both inserted and deleted text.
+ * - `all`: both inserted and deleted text, current formatting and blocks.
  */
 type TrackedChangesView = "accepted" | "original" | "all";
 interface TrackedChangeAttributes {
@@ -189,6 +193,40 @@ interface TrackedChangeAttributes {
     authorColor: string | null;
     createdAt: number;
 }
+/** A serializable mark (`mark.toJSON()`). */
+interface TrackedMark {
+    type: string;
+    attrs?: Record<string, any>;
+}
+/** Attributes of the `formatChange` mark. */
+interface TrackedFormatChangeAttributes extends TrackedChangeAttributes {
+    /** Formatting marks before the change. */
+    before: TrackedMark[];
+    /** Formatting marks after the change. */
+    after: TrackedMark[];
+}
+/** A textblock's type, attributes and enclosing wrappers (lists, quotes). */
+interface TrackedBlockSnapshot {
+    type: string;
+    attrs: Record<string, any>;
+    /** Ancestors from the outermost (below the document) to the parent. */
+    wrappers: {
+        type: string;
+        attrs: Record<string, any>;
+    }[];
+}
+/** Value of the `blockChange` node attribute. */
+interface TrackedBlockChangeAttributes extends TrackedChangeAttributes {
+    previous: TrackedBlockSnapshot;
+}
+interface TrackedFormatSummary {
+    /** Labels of added formatting, e.g. `["Bold"]`. */
+    added: string[];
+    /** Labels of removed formatting. */
+    removed: string[];
+    /** Labels of changed formatting (same mark, different attributes), e.g. `["Font size"]`. */
+    changed: string[];
+}
 interface TrackedChange {
     id: string;
     type: TrackedChangeType;
@@ -198,12 +236,24 @@ interface TrackedChange {
     from: number;
     /** End of the last range. */
     to: number;
-    /** A change can be split into several ranges by other marks or blocks. */
+    /**
+     * A change can be split into several ranges by other marks or blocks.
+     * Block changes cover whole textblock nodes.
+     */
     ranges: {
         from: number;
         to: number;
     }[];
     text: string;
+    /** Human-readable summary, e.g. `Formatted: Bold` or `Changed Paragraph to Heading 2`. */
+    description: string;
+    /** Formatting changes (`type: "format"`). */
+    format?: TrackedFormatSummary;
+    /** Block changes (`type: "block"`): the first block's previous and current state. */
+    block?: {
+        previous: TrackedBlockSnapshot;
+        current: TrackedBlockSnapshot;
+    };
 }
 interface TrackChangesSnapshot {
     enabled: boolean;
@@ -221,6 +271,25 @@ interface TrackChangesOptions {
     generateId: () => string;
     insertionHTMLAttributes: Record<string, any>;
     deletionHTMLAttributes: Record<string, any>;
+    /** HTML attributes (e.g. `class`) of tracked formatting. Replaces the default dotted underline. */
+    formatChangeHTMLAttributes: Record<string, any>;
+    /** Class added to blocks with a tracked block change (margin bar by default). */
+    blockChangeClass: 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`. */
+    trackBlocks: boolean;
+    /**
+     * Track insertions and deletions inside code blocks by allowing the
+     * insertion/deletion marks there. Default `true`.
+     */
+    trackCodeBlocks: boolean;
+    /** Textblock node types that can record block changes. */
+    blockTypes: string[];
+    /** Extra mark names not tracked as formatting. */
+    ignoredMarks: string[];
+    /** Node attributes ignored when comparing blocks (e.g. generated ids). */
+    ignoredBlockAttributes: string[];
 }
 /**
  * External store over the editor's tracked-change state. Snapshots only
@@ -277,12 +346,24 @@ declare const TrackedInsertion: Mark<{
 declare const TrackedDeletion: Mark<{
     HTMLAttributes: Record<string, any>;
 }, any>;
+/**
+ * Existing text whose formatting changed while tracking was on. Stores the
+ * formatting before and after the change, rendered as
+ * `<span data-change-type="format">` (dotted underline by default).
+ */
+declare const TrackedFormatChange: Mark<{
+    HTMLAttributes: Record<string, any>;
+}, any>;
+/** Describes a formatting change, e.g. `Formatted: Bold; Removed formatting: Italic`. */
+declare function describeFormatChange(summary: TrackedFormatSummary): string;
+/** Describes a block change, e.g. `Changed Paragraph to Heading 2`. */
+declare function describeBlockChange(previous: TrackedBlockSnapshot, current: TrackedBlockSnapshot, ignoredAttributes?: readonly string[]): string;
 /**
  * Lists tracked changes in document order. Accepts an editor, an editor
  * state or a ProseMirror document.
  */
 declare function getTrackedChanges(source: Editor | EditorState | Node | null | undefined): TrackedChange[];
-/** The change containing `pos` (defaults to the selection start). */
+/** The change containing `pos` (defaults to the selection start). Inline changes win over block changes. */
 declare function getTrackedChangeAt(state: EditorState, pos?: number, changes?: readonly TrackedChange[]): TrackedChange | null;
 declare function isTrackChangesEnabled(source: Editor | EditorState | null | undefined): boolean;
 /** Returns the tracked-changes store of an editor using `TrackChanges`. */
@@ -296,11 +377,13 @@ declare function resolveTrackedChanges(doc: Node, view?: TrackedChangesView): No
  * Suggestion mode / track changes. When enabled, typed and pasted content is
  * marked as an insertion and deleted content is kept but marked as a
  * deletion (struck through) until the change is accepted or rejected.
+ * Formatting changes on existing text are recorded with the `formatChange`
+ * mark, and textblock type/attribute/wrapping changes with the `blockChange`
+ * node attribute.
  *
- * Deleting your own insertion really deletes it. Formatting-only changes and
- * block-structure changes (splitting/joining paragraphs, lists) are not
- * tracked. IME composition is tracked once the composition ends.
+ * Deleting your own insertion really deletes it. Paragraph splits and joins
+ * are not tracked. IME composition is tracked once the composition ends.
  */
 declare const TrackChanges: Extension<TrackChangesOptions, TrackChangesStorage>;
 
-export { getTrackedChanges as A, isTrackChangesEnabled as B, type CommentAnchor as C, DELETION_MARK_NAME as D, resolveTrackedChanges as E, trackChangesPluginKey as F, INSERTION_MARK_NAME as I, Mention as M, type ReviewAuthor as R, type SerializedComments as S, TRACK_CHANGES_SKIP_META as T, 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 TrackedChange as o, type TrackedChangeAttributes as p, type TrackedChangeType as q, type TrackedChangesView as r, TrackedDeletion as s, TrackedInsertion as t, createCommentStore as u, createMentionExtension as v, createReviewId as w, formatReviewTime as x, getTrackChangesStore as y, getTrackedChangeAt as z };
+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 };

package/dist/{types-DMe0vFB1.d.cts → 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, CanvasDockingCallbacks as g, CollapseNodeOptions as h, DisplacementDirection as i, DockStrategy as j, ExplosionSnapshot as k, Point 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-DMe0vFB1.d.ts → 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, CanvasDockingCallbacks as g, CollapseNodeOptions as h, DisplacementDirection as i, DockStrategy as j, ExplosionSnapshot as k, Point 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.21.0",
+  "version": "0.23.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -58,10 +58,16 @@
       "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"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "sideEffects": false,
   "dependencies": {