@tiptap/extension-drag-handle-vue-2 3.29.2 → 3.30.0

package/dist/index.d.cts

@@ -2,9 +2,9 @@ import * as vue_types_vue from 'vue/types/vue';
 import * as prosemirror_model from 'prosemirror-model';
 import * as prosemirror_state from 'prosemirror-state';
 import * as vue from 'vue';
-import { MarkType as MarkType$1, MarkSpec, Mark as Mark$1, DOMOutputSpec, NodeType as NodeType$1, NodeSpec, Node as Node$2, Slice, ParseOptions, Schema, ResolvedPos, Fragment } from '@tiptap/pm/model';
-import { EditorState, Plugin, Transaction, PluginKey } from '@tiptap/pm/state';
-import { NodeViewConstructor, NodeView, MarkViewConstructor, MarkView, EditorProps, EditorView } from '@tiptap/pm/view';
+import { Mark as Mark$1, MarkType as MarkType$1, MarkSpec, DOMOutputSpec, NodeType as NodeType$1, NodeSpec, Node as Node$2, Slice, ParseOptions, Schema, ResolvedPos, Fragment } from '@tiptap/pm/model';
+import { EditorState, Transaction, Plugin, PluginKey } from '@tiptap/pm/state';
+import { Decoration as Decoration$1, DecorationAttrs, EditorView, DecorationSet, NodeViewConstructor, NodeView, MarkViewConstructor, MarkView, EditorProps } from '@tiptap/pm/view';
 import { MapResult, Transform } from '@tiptap/pm/transform';
 import { NestedOptions, DragHandlePluginProps } from '@tiptap/extension-drag-handle';
 
@@ -20,6 +20,256 @@ declare class EventEmitter<T extends Record<string, any>> {
     removeAllListeners(): void;
 }
 
+interface WidgetDecorationOptions {
+    side?: number;
+    relaxedSide?: boolean;
+    marks?: readonly Mark$1[];
+    stopEvent?: (event: Event) => boolean;
+    ignoreSelection?: boolean;
+    /**
+     * runs when ProseMirror drops the widget, also on editor destroy and unmount.
+     * skipped on teardown for widgets made with the React or Vue widget renderer.
+     * receives the DOM node, not a ProseMirror node.
+     */
+    destroy?: (node: globalThis.Node) => void;
+}
+type DecorationKind = 'inline' | 'node' | 'widget';
+/**
+ * Base class for decorations built in `addDecorations()`. Shadows `Decoration`
+ * from `@tiptap/pm/view`, like core's `Node` and `Mark` do, so alias one of them
+ * in files that need both.
+ *
+ * @example
+ * import { Decoration } from '@tiptap/core'
+ * import { Decoration as PMDecoration } from '@tiptap/pm/view'
+ *
+ * const highlight = Decoration.Inline(1, 5, { class: 'highlight' })
+ */
+declare abstract class Decoration {
+    abstract kind: DecorationKind;
+    abstract get anchor(): number;
+    /**
+     * Builds the ProseMirror decoration. When `extensionName` is provided,
+     * it is embedded into the decoration spec for incremental merge tracking.
+     * @param extensionName The name of the extension that produced this decoration.
+     * @returns The ProseMirror decoration.
+     */
+    abstract toPMDecoration(extensionName?: string): Decoration$1;
+    static Inline(from: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>): InlineDecoration;
+    static Node(pos: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>): NodeDecoration;
+    /**
+     * Creates a widget decoration: a DOM node drawn at a document position.
+     *
+     * The `key` is the widget's identity. While it stays the same, ProseMirror
+     * keeps the widget mounted and only its position tracks the document.
+     * `render`, `side`, `destroy` and other options are fixed on first mount.
+     * Change the key to remount with new options.
+     *
+     * @param pos The document position where the widget is drawn.
+     * @param render Called once on first mount. Returns the DOM node.
+     * @param options Must include a unique `key`. See `WidgetDecorationOptions`.
+     * @returns The widget decoration.
+     */
+    static Widget(pos: number, render: (view: EditorView, getPos: () => number | undefined) => HTMLElement, options: {
+        key: string;
+    } & WidgetDecorationOptions & Record<string, any>): WidgetDecoration;
+}
+/**
+ * Represents an inline decoration (text-level highlighting, etc.).
+ */
+declare class InlineDecoration extends Decoration {
+    kind: "inline";
+    from: number;
+    to: number;
+    attrs: DecorationAttrs;
+    spec?: Record<string, any>;
+    constructor(from: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>);
+    get anchor(): number;
+    toPMDecoration(extensionName?: string): Decoration$1;
+}
+/**
+ * Represents a node-level decoration (block-level highlights, etc.).
+ */
+declare class NodeDecoration extends Decoration {
+    kind: "node";
+    from: number;
+    to: number;
+    attrs: DecorationAttrs;
+    spec?: Record<string, any>;
+    constructor(pos: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>);
+    get anchor(): number;
+    toPMDecoration(extensionName?: string): Decoration$1;
+}
+/**
+ * Represents a widget decoration (inline widgets, etc.).
+ */
+declare class WidgetDecoration extends Decoration {
+    kind: "widget";
+    pos: number;
+    key: string;
+    render: (view: EditorView, getPos: () => number | undefined) => HTMLElement;
+    spec?: WidgetDecorationOptions & Record<string, any>;
+    constructor(pos: number, render: (view: EditorView, getPos: () => number | undefined) => HTMLElement, key: string, spec?: WidgetDecorationOptions & Record<string, any>);
+    get anchor(): number;
+    toPMDecoration(extensionName?: string): Decoration$1;
+}
+
+interface DecorationCreateProps {
+    /**
+     * The editor instance. Read `state` from the `state` argument, not
+     * `editor.state` — during `create()` the editor's view state has not been
+     * updated yet, so `editor.state` points at the pre-transaction document.
+     */
+    editor: Editor;
+    /**
+     * The editor state being built. This is the correct state to read from
+     * inside `create()`; `editor.state` is stale until the transaction finishes
+     * applying.
+     */
+    state: EditorState;
+    /** The editor view, or `null` while the editor is not mounted. */
+    view: EditorView | null;
+}
+interface DecorationShouldUpdateProps {
+    editor: Editor;
+    tr: Transaction;
+    oldState: EditorState;
+    newState: EditorState;
+}
+interface DecorationRangeProps extends DecorationCreateProps {
+    /** Start of the block range to scan, inclusive. */
+    from: number;
+    /**
+     * End of the block range to scan, exclusive. `to` is the next block's start
+     * and that block rebuilds it, so decorations anchored there are ignored.
+     * The last block is the exception: it owns the end of the document.
+     */
+    to: number;
+}
+interface BaseDecorationSpec {
+    create: (props: DecorationCreateProps) => Decoration[];
+    shouldUpdate?: (props: DecorationShouldUpdateProps) => boolean;
+}
+interface DocumentDecorationSpec extends BaseDecorationSpec {
+    update?: 'document';
+    createInRange?: never;
+}
+interface ChangedRangesDecorationSpec extends BaseDecorationSpec {
+    update: 'changedRanges';
+    createInRange: (props: DecorationRangeProps) => Decoration[];
+}
+interface ManualDecorationSpec extends BaseDecorationSpec {
+    update: 'manual';
+    shouldUpdate?: never;
+    createInRange?: never;
+}
+type DecorationSpec = DocumentDecorationSpec | ChangedRangesDecorationSpec | ManualDecorationSpec;
+interface DecorationManagerState {
+    decorationSetsByExtension: Record<string, DecorationSet>;
+    widgetKeysByExtension: Record<string, Set<string>>;
+    mergedDecorationSet: DecorationSet;
+    widgetKeys: Set<string>;
+}
+interface ResolvedDecorationEntry {
+    name: string;
+    spec: DecorationSpec;
+}
+interface DecorationManagerEntry {
+    name: string;
+    addDecorations: () => DecorationSpec | null;
+}
+
+declare class DecorationManager {
+    editor: Editor;
+    entries: ResolvedDecorationEntry[];
+    plugin: Plugin<DecorationManagerState> | null;
+    private warnedWidgetKeys;
+    private warnedOutOfRangeExtensions;
+    private readonly handleBeforeTransaction;
+    constructor(options: {
+        editor: Editor;
+        entries: DecorationManagerEntry[];
+    });
+    destroy(): void;
+    /**
+     * Returns the set of live widget keys from all decoration extensions.
+     * @returns A readonly set of widget keys
+     */
+    liveWidgetKeys(): ReadonlySet<string>;
+    /**
+     * The mounted editor view, or `null` when destroyed. Decoration callbacks
+     * must never receive the placeholder view `editor.view` falls back to.
+     * @returns The mounted editor view, or `null`
+     */
+    private get mountedView();
+    /**
+     * Resolves decoration entries by calling the addDecorations function for each extension entry.
+     * @param entries The decoration manager entries to resolve
+     * @returns An array of resolved decoration entries
+     */
+    private resolveEntries;
+    /**
+     * Creates the ProseMirror plugin for managing decorations.
+     * @returns A ProseMirror plugin with state management
+     */
+    private createPlugin;
+    /**
+     * Applies changed ranges recomputation to a decoration set, dropping stale decorations and rebuilding only the touched blocks.
+     * @param name The name of the decoration extension
+     * @param spec The decoration spec
+     * @param previous The previous decoration manager state
+     * @param tr The transaction to apply
+     * @param newState The new editor state
+     * @returns The updated decoration set and widget keys
+     */
+    private applyChangedRangesRecompute;
+    /**
+     * Rebuilds decorations for the changed block ranges: maps the previous set
+     * forward, then for each range removes stale decorations, calls
+     * `createInRange`, and adds the new ones while syncing widget keys.
+     * @param name The extension name.
+     * @param spec The decoration spec.
+     * @param previous The previous decoration manager state.
+     * @param tr The transaction to apply.
+     * @param newState The new editor state.
+     * @param ranges The block ranges to rebuild.
+     * @returns The updated decoration set and widget keys.
+     */
+    private rebuildRanges;
+    /**
+     * Builds a full decoration set for the entire document.
+     * @param name The name of the decoration extension
+     * @param spec The decoration spec
+     * @param state The editor state
+     * @returns The decoration set and widget keys
+     */
+    private buildFullSet;
+    /**
+     * Runs a decoration callback and swallows anything it throws. These run inside
+     * `state.apply`, where an uncaught error would abort the whole transaction.
+     * @param name The extension name.
+     * @param method The callback name, used in the error message.
+     * @param create The callback to run.
+     * @returns The decorations, or an empty array if the callback threw.
+     */
+    private runCreate;
+    private warnDuplicateWidgetKeys;
+    /**
+     * Builds the merged DecorationSet during init. Skips the merge for a
+     * single extension since its per-extension set is already correct.
+     * @param doc The document to build the merged set for.
+     * @param decorationSetsByExtension The per-extension decoration sets.
+     * @returns The merged decoration set.
+     */
+    private buildMergedSet;
+    /**
+     * Computes the merged DecorationSet after apply. Single extension skips the
+     * merge; nothing recomputed maps the previous merged set forward; otherwise
+     * the merge is rebuilt from the per-extension sets.
+     */
+    private mergeAfterApply;
+}
+
 type InputRuleMatch = {
     index: number;
     text: string;
@@ -694,6 +944,36 @@ interface ExtendableConfig<Options = any, Storage = any, Config extends Extensio
         type: PMType;
         parent: ParentConfig<Config>['addProseMirrorPlugins'];
     }) => Plugin[];
+    /**
+     * Adds editor decorations (node, inline, widget). Return a spec with a `create`
+     * function that builds instances via `Decoration.Node`/`Inline`/`Widget`. Use
+     * `shouldUpdate`, `update: 'changedRanges'` + `createInRange`, or `update: 'manual'` to control recomputation.
+     * @see https://tiptap.dev/docs/editor/core-concepts/decorations
+     * @example
+     * addDecorations() {
+     *   return {
+     *     create: ({ state }) =>
+     *       findChildren(state.doc, node => node.type.name === 'heading').map(
+     *         ({ pos, node }) =>
+     *           Decoration.Node(pos, pos + node.nodeSize, { class: 'is-heading' }),
+     *       ),
+     *   }
+     * }
+     *
+     * For framework widgets, use `ReactWidgetRenderer` or `VueWidgetRenderer`
+     * from the matching framework package. Give stateful widgets a stable key.
+     *
+     * `create` and `createInRange` must not throw. An exception escapes through
+     * `editor.commands.*` and stops the document from updating until it stops.
+     */
+    addDecorations?: (this: {
+        name: string;
+        options: Options;
+        storage: Storage;
+        editor: Editor;
+        type: PMType;
+        parent: ParentConfig<Config>['addDecorations'];
+    }) => DecorationSpec | null;
     /**
      * This function transforms pasted HTML content before it's parsed.
      * Extensions can use this to modify or clean up pasted HTML.
@@ -1829,6 +2109,7 @@ declare class ExtensionManager {
     baseExtensions: Extensions;
     splittableMarks: string[];
     nonClearableMarks: string[];
+    decorationManager: DecorationManager | null;
     constructor(extensions: Extensions, editor: Editor);
     static resolve: typeof resolveExtensions;
     static sort: typeof sortExtensions;
@@ -1843,6 +2124,14 @@ declare class ExtensionManager {
      * @returns An array of Prosemirror plugins
      */
     get plugins(): Plugin[];
+    /**
+     * Aggregates decorations from extensions into a single plugin, or returns null
+     * if none exist. Destroys the previous manager to avoid orphaned listeners.
+     * @returns A ProseMirror plugin or `null`
+     * @example
+     * const plugin = editor.extensionManager.createDecorationPlugin()
+     */
+    createDecorationPlugin(): Plugin | null;
     /**
      * Get all attributes from the extensions.
      * @returns An array of attributes
@@ -2858,6 +3147,22 @@ declare module '@tiptap/core' {
     }
 }
 
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        updateDecorations: {
+            /**
+             * Force declarative decorations to recompute, bypassing each extension's
+             * `shouldUpdate` gate. Pass an extension name to recompute only that
+             * extension's decorations, or omit it to recompute all of them.
+             * @param extensionName The name of the extension to recompute (optional).
+             * @example editor.commands.updateDecorations()
+             * @example editor.commands.updateDecorations('myExtension')
+             */
+            updateDecorations: (extensionName?: string) => ReturnType;
+        };
+    }
+}
+
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         wrapIn: {
@@ -2905,6 +3210,7 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * A unique ID for this editor instance.
      */
     instanceId: string;
+    private hasWarnedStaleDecorationRead;
     options: EditorOptions;
     constructor(options?: Partial<EditorOptions>);
     /**

package/dist/index.d.ts

@@ -2,9 +2,9 @@ import * as vue_types_vue from 'vue/types/vue';
 import * as prosemirror_model from 'prosemirror-model';
 import * as prosemirror_state from 'prosemirror-state';
 import * as vue from 'vue';
-import { MarkType as MarkType$1, MarkSpec, Mark as Mark$1, DOMOutputSpec, NodeType as NodeType$1, NodeSpec, Node as Node$2, Slice, ParseOptions, Schema, ResolvedPos, Fragment } from '@tiptap/pm/model';
-import { EditorState, Plugin, Transaction, PluginKey } from '@tiptap/pm/state';
-import { NodeViewConstructor, NodeView, MarkViewConstructor, MarkView, EditorProps, EditorView } from '@tiptap/pm/view';
+import { Mark as Mark$1, MarkType as MarkType$1, MarkSpec, DOMOutputSpec, NodeType as NodeType$1, NodeSpec, Node as Node$2, Slice, ParseOptions, Schema, ResolvedPos, Fragment } from '@tiptap/pm/model';
+import { EditorState, Transaction, Plugin, PluginKey } from '@tiptap/pm/state';
+import { Decoration as Decoration$1, DecorationAttrs, EditorView, DecorationSet, NodeViewConstructor, NodeView, MarkViewConstructor, MarkView, EditorProps } from '@tiptap/pm/view';
 import { MapResult, Transform } from '@tiptap/pm/transform';
 import { NestedOptions, DragHandlePluginProps } from '@tiptap/extension-drag-handle';
 
@@ -20,6 +20,256 @@ declare class EventEmitter<T extends Record<string, any>> {
     removeAllListeners(): void;
 }
 
+interface WidgetDecorationOptions {
+    side?: number;
+    relaxedSide?: boolean;
+    marks?: readonly Mark$1[];
+    stopEvent?: (event: Event) => boolean;
+    ignoreSelection?: boolean;
+    /**
+     * runs when ProseMirror drops the widget, also on editor destroy and unmount.
+     * skipped on teardown for widgets made with the React or Vue widget renderer.
+     * receives the DOM node, not a ProseMirror node.
+     */
+    destroy?: (node: globalThis.Node) => void;
+}
+type DecorationKind = 'inline' | 'node' | 'widget';
+/**
+ * Base class for decorations built in `addDecorations()`. Shadows `Decoration`
+ * from `@tiptap/pm/view`, like core's `Node` and `Mark` do, so alias one of them
+ * in files that need both.
+ *
+ * @example
+ * import { Decoration } from '@tiptap/core'
+ * import { Decoration as PMDecoration } from '@tiptap/pm/view'
+ *
+ * const highlight = Decoration.Inline(1, 5, { class: 'highlight' })
+ */
+declare abstract class Decoration {
+    abstract kind: DecorationKind;
+    abstract get anchor(): number;
+    /**
+     * Builds the ProseMirror decoration. When `extensionName` is provided,
+     * it is embedded into the decoration spec for incremental merge tracking.
+     * @param extensionName The name of the extension that produced this decoration.
+     * @returns The ProseMirror decoration.
+     */
+    abstract toPMDecoration(extensionName?: string): Decoration$1;
+    static Inline(from: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>): InlineDecoration;
+    static Node(pos: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>): NodeDecoration;
+    /**
+     * Creates a widget decoration: a DOM node drawn at a document position.
+     *
+     * The `key` is the widget's identity. While it stays the same, ProseMirror
+     * keeps the widget mounted and only its position tracks the document.
+     * `render`, `side`, `destroy` and other options are fixed on first mount.
+     * Change the key to remount with new options.
+     *
+     * @param pos The document position where the widget is drawn.
+     * @param render Called once on first mount. Returns the DOM node.
+     * @param options Must include a unique `key`. See `WidgetDecorationOptions`.
+     * @returns The widget decoration.
+     */
+    static Widget(pos: number, render: (view: EditorView, getPos: () => number | undefined) => HTMLElement, options: {
+        key: string;
+    } & WidgetDecorationOptions & Record<string, any>): WidgetDecoration;
+}
+/**
+ * Represents an inline decoration (text-level highlighting, etc.).
+ */
+declare class InlineDecoration extends Decoration {
+    kind: "inline";
+    from: number;
+    to: number;
+    attrs: DecorationAttrs;
+    spec?: Record<string, any>;
+    constructor(from: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>);
+    get anchor(): number;
+    toPMDecoration(extensionName?: string): Decoration$1;
+}
+/**
+ * Represents a node-level decoration (block-level highlights, etc.).
+ */
+declare class NodeDecoration extends Decoration {
+    kind: "node";
+    from: number;
+    to: number;
+    attrs: DecorationAttrs;
+    spec?: Record<string, any>;
+    constructor(pos: number, to: number, attrs?: DecorationAttrs, spec?: Record<string, any>);
+    get anchor(): number;
+    toPMDecoration(extensionName?: string): Decoration$1;
+}
+/**
+ * Represents a widget decoration (inline widgets, etc.).
+ */
+declare class WidgetDecoration extends Decoration {
+    kind: "widget";
+    pos: number;
+    key: string;
+    render: (view: EditorView, getPos: () => number | undefined) => HTMLElement;
+    spec?: WidgetDecorationOptions & Record<string, any>;
+    constructor(pos: number, render: (view: EditorView, getPos: () => number | undefined) => HTMLElement, key: string, spec?: WidgetDecorationOptions & Record<string, any>);
+    get anchor(): number;
+    toPMDecoration(extensionName?: string): Decoration$1;
+}
+
+interface DecorationCreateProps {
+    /**
+     * The editor instance. Read `state` from the `state` argument, not
+     * `editor.state` — during `create()` the editor's view state has not been
+     * updated yet, so `editor.state` points at the pre-transaction document.
+     */
+    editor: Editor;
+    /**
+     * The editor state being built. This is the correct state to read from
+     * inside `create()`; `editor.state` is stale until the transaction finishes
+     * applying.
+     */
+    state: EditorState;
+    /** The editor view, or `null` while the editor is not mounted. */
+    view: EditorView | null;
+}
+interface DecorationShouldUpdateProps {
+    editor: Editor;
+    tr: Transaction;
+    oldState: EditorState;
+    newState: EditorState;
+}
+interface DecorationRangeProps extends DecorationCreateProps {
+    /** Start of the block range to scan, inclusive. */
+    from: number;
+    /**
+     * End of the block range to scan, exclusive. `to` is the next block's start
+     * and that block rebuilds it, so decorations anchored there are ignored.
+     * The last block is the exception: it owns the end of the document.
+     */
+    to: number;
+}
+interface BaseDecorationSpec {
+    create: (props: DecorationCreateProps) => Decoration[];
+    shouldUpdate?: (props: DecorationShouldUpdateProps) => boolean;
+}
+interface DocumentDecorationSpec extends BaseDecorationSpec {
+    update?: 'document';
+    createInRange?: never;
+}
+interface ChangedRangesDecorationSpec extends BaseDecorationSpec {
+    update: 'changedRanges';
+    createInRange: (props: DecorationRangeProps) => Decoration[];
+}
+interface ManualDecorationSpec extends BaseDecorationSpec {
+    update: 'manual';
+    shouldUpdate?: never;
+    createInRange?: never;
+}
+type DecorationSpec = DocumentDecorationSpec | ChangedRangesDecorationSpec | ManualDecorationSpec;
+interface DecorationManagerState {
+    decorationSetsByExtension: Record<string, DecorationSet>;
+    widgetKeysByExtension: Record<string, Set<string>>;
+    mergedDecorationSet: DecorationSet;
+    widgetKeys: Set<string>;
+}
+interface ResolvedDecorationEntry {
+    name: string;
+    spec: DecorationSpec;
+}
+interface DecorationManagerEntry {
+    name: string;
+    addDecorations: () => DecorationSpec | null;
+}
+
+declare class DecorationManager {
+    editor: Editor;
+    entries: ResolvedDecorationEntry[];
+    plugin: Plugin<DecorationManagerState> | null;
+    private warnedWidgetKeys;
+    private warnedOutOfRangeExtensions;
+    private readonly handleBeforeTransaction;
+    constructor(options: {
+        editor: Editor;
+        entries: DecorationManagerEntry[];
+    });
+    destroy(): void;
+    /**
+     * Returns the set of live widget keys from all decoration extensions.
+     * @returns A readonly set of widget keys
+     */
+    liveWidgetKeys(): ReadonlySet<string>;
+    /**
+     * The mounted editor view, or `null` when destroyed. Decoration callbacks
+     * must never receive the placeholder view `editor.view` falls back to.
+     * @returns The mounted editor view, or `null`
+     */
+    private get mountedView();
+    /**
+     * Resolves decoration entries by calling the addDecorations function for each extension entry.
+     * @param entries The decoration manager entries to resolve
+     * @returns An array of resolved decoration entries
+     */
+    private resolveEntries;
+    /**
+     * Creates the ProseMirror plugin for managing decorations.
+     * @returns A ProseMirror plugin with state management
+     */
+    private createPlugin;
+    /**
+     * Applies changed ranges recomputation to a decoration set, dropping stale decorations and rebuilding only the touched blocks.
+     * @param name The name of the decoration extension
+     * @param spec The decoration spec
+     * @param previous The previous decoration manager state
+     * @param tr The transaction to apply
+     * @param newState The new editor state
+     * @returns The updated decoration set and widget keys
+     */
+    private applyChangedRangesRecompute;
+    /**
+     * Rebuilds decorations for the changed block ranges: maps the previous set
+     * forward, then for each range removes stale decorations, calls
+     * `createInRange`, and adds the new ones while syncing widget keys.
+     * @param name The extension name.
+     * @param spec The decoration spec.
+     * @param previous The previous decoration manager state.
+     * @param tr The transaction to apply.
+     * @param newState The new editor state.
+     * @param ranges The block ranges to rebuild.
+     * @returns The updated decoration set and widget keys.
+     */
+    private rebuildRanges;
+    /**
+     * Builds a full decoration set for the entire document.
+     * @param name The name of the decoration extension
+     * @param spec The decoration spec
+     * @param state The editor state
+     * @returns The decoration set and widget keys
+     */
+    private buildFullSet;
+    /**
+     * Runs a decoration callback and swallows anything it throws. These run inside
+     * `state.apply`, where an uncaught error would abort the whole transaction.
+     * @param name The extension name.
+     * @param method The callback name, used in the error message.
+     * @param create The callback to run.
+     * @returns The decorations, or an empty array if the callback threw.
+     */
+    private runCreate;
+    private warnDuplicateWidgetKeys;
+    /**
+     * Builds the merged DecorationSet during init. Skips the merge for a
+     * single extension since its per-extension set is already correct.
+     * @param doc The document to build the merged set for.
+     * @param decorationSetsByExtension The per-extension decoration sets.
+     * @returns The merged decoration set.
+     */
+    private buildMergedSet;
+    /**
+     * Computes the merged DecorationSet after apply. Single extension skips the
+     * merge; nothing recomputed maps the previous merged set forward; otherwise
+     * the merge is rebuilt from the per-extension sets.
+     */
+    private mergeAfterApply;
+}
+
 type InputRuleMatch = {
     index: number;
     text: string;
@@ -694,6 +944,36 @@ interface ExtendableConfig<Options = any, Storage = any, Config extends Extensio
         type: PMType;
         parent: ParentConfig<Config>['addProseMirrorPlugins'];
     }) => Plugin[];
+    /**
+     * Adds editor decorations (node, inline, widget). Return a spec with a `create`
+     * function that builds instances via `Decoration.Node`/`Inline`/`Widget`. Use
+     * `shouldUpdate`, `update: 'changedRanges'` + `createInRange`, or `update: 'manual'` to control recomputation.
+     * @see https://tiptap.dev/docs/editor/core-concepts/decorations
+     * @example
+     * addDecorations() {
+     *   return {
+     *     create: ({ state }) =>
+     *       findChildren(state.doc, node => node.type.name === 'heading').map(
+     *         ({ pos, node }) =>
+     *           Decoration.Node(pos, pos + node.nodeSize, { class: 'is-heading' }),
+     *       ),
+     *   }
+     * }
+     *
+     * For framework widgets, use `ReactWidgetRenderer` or `VueWidgetRenderer`
+     * from the matching framework package. Give stateful widgets a stable key.
+     *
+     * `create` and `createInRange` must not throw. An exception escapes through
+     * `editor.commands.*` and stops the document from updating until it stops.
+     */
+    addDecorations?: (this: {
+        name: string;
+        options: Options;
+        storage: Storage;
+        editor: Editor;
+        type: PMType;
+        parent: ParentConfig<Config>['addDecorations'];
+    }) => DecorationSpec | null;
     /**
      * This function transforms pasted HTML content before it's parsed.
      * Extensions can use this to modify or clean up pasted HTML.
@@ -1829,6 +2109,7 @@ declare class ExtensionManager {
     baseExtensions: Extensions;
     splittableMarks: string[];
     nonClearableMarks: string[];
+    decorationManager: DecorationManager | null;
     constructor(extensions: Extensions, editor: Editor);
     static resolve: typeof resolveExtensions;
     static sort: typeof sortExtensions;
@@ -1843,6 +2124,14 @@ declare class ExtensionManager {
      * @returns An array of Prosemirror plugins
      */
     get plugins(): Plugin[];
+    /**
+     * Aggregates decorations from extensions into a single plugin, or returns null
+     * if none exist. Destroys the previous manager to avoid orphaned listeners.
+     * @returns A ProseMirror plugin or `null`
+     * @example
+     * const plugin = editor.extensionManager.createDecorationPlugin()
+     */
+    createDecorationPlugin(): Plugin | null;
     /**
      * Get all attributes from the extensions.
      * @returns An array of attributes
@@ -2858,6 +3147,22 @@ declare module '@tiptap/core' {
     }
 }
 
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        updateDecorations: {
+            /**
+             * Force declarative decorations to recompute, bypassing each extension's
+             * `shouldUpdate` gate. Pass an extension name to recompute only that
+             * extension's decorations, or omit it to recompute all of them.
+             * @param extensionName The name of the extension to recompute (optional).
+             * @example editor.commands.updateDecorations()
+             * @example editor.commands.updateDecorations('myExtension')
+             */
+            updateDecorations: (extensionName?: string) => ReturnType;
+        };
+    }
+}
+
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         wrapIn: {
@@ -2905,6 +3210,7 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * A unique ID for this editor instance.
      */
     instanceId: string;
+    private hasWarnedStaleDecorationRead;
     options: EditorOptions;
     constructor(options?: Partial<EditorOptions>);
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiptap/extension-drag-handle-vue-2",
-  "version": "3.29.2",
+  "version": "3.30.0",
   "description": "drag handle extension for tiptap with vue 2",
   "keywords": [
     "tiptap",
@@ -41,15 +41,15 @@
   "devDependencies": {
     "vue": "^2.0.0",
     "vue-ts-types": "1.6.2",
-    "@tiptap/extension-drag-handle": "^3.29.2",
-    "@tiptap/pm": "^3.29.2",
-    "@tiptap/vue-2": "^3.29.2"
+    "@tiptap/extension-drag-handle": "^3.30.0",
+    "@tiptap/pm": "^3.30.0",
+    "@tiptap/vue-2": "^3.30.0"
   },
   "peerDependencies": {
     "vue": "^2.0.0",
-    "@tiptap/pm": "3.29.2",
-    "@tiptap/extension-drag-handle": "3.29.2",
-    "@tiptap/vue-2": "3.29.2"
+    "@tiptap/extension-drag-handle": "3.30.0",
+    "@tiptap/pm": "3.30.0",
+    "@tiptap/vue-2": "3.30.0"
   },
   "scripts": {
     "build": "tsup"