@tiptap/core 3.12.1 → 3.13.0

package/dist/index.d.cts

@@ -3761,6 +3761,10 @@ type ResizableNodeViewOptions = {
      * The ProseMirror node instance
      */
     node: Node$1;
+    /**
+     * The Tiptap editor instance
+     */
+    editor: Editor;
     /**
      * Function that returns the current position of the node in the document
      */
@@ -3884,6 +3888,50 @@ type ResizableNodeViewOptions = {
             /** Class added to container while actively resizing */
             resizing?: string;
         };
+        /**
+         * Optional callback for creating custom resize handle elements.
+         *
+         * This function allows developers to define their own handle element
+         * (e.g., custom icons, classes, or styles) for a given resize direction.
+         * It is called internally for each handle direction.
+         *
+         * @param direction - The direction of the handle being created (e.g., 'top', 'bottom-right').
+         * @returns The custom handle HTMLElement.
+         *
+         * @example
+         * ```ts
+         * createCustomHandle: (direction) => {
+         *   const handle = document.createElement('div')
+         *   handle.dataset.resizeHandle = direction
+         *   handle.style.position = 'absolute'
+         *   handle.className = 'tiptap-custom-handle'
+         *
+         *   const isTop = direction.includes('top')
+         *   const isBottom = direction.includes('bottom')
+         *   const isLeft = direction.includes('left')
+         *   const isRight = direction.includes('right')
+         *
+         *   if (isTop) handle.style.top = '0'
+         *   if (isBottom) handle.style.bottom = '0'
+         *   if (isLeft) handle.style.left = '0'
+         *   if (isRight) handle.style.right = '0'
+         *
+         *   // Edge handles span the full width or height
+         *   if (direction === 'top' || direction === 'bottom') {
+         *     handle.style.left = '0'
+         *     handle.style.right = '0'
+         *   }
+         *
+         *   if (direction === 'left' || direction === 'right') {
+         *     handle.style.top = '0'
+         *     handle.style.bottom = '0'
+         *   }
+         *
+         *   return handle
+         * }
+         * ```
+         */
+        createCustomHandle?: (direction: ResizableNodeViewDirection) => HTMLElement;
     };
 };
 /**
@@ -3925,6 +3973,8 @@ type ResizableNodeViewOptions = {
 declare class ResizableNodeView {
     /** The ProseMirror node instance */
     node: Node$1;
+    /** The Tiptap editor instance */
+    editor: Editor;
     /** The DOM element being made resizable */
     element: HTMLElement;
     /** The editable DOM element inside the DOM */
@@ -3956,6 +4006,8 @@ declare class ResizableNodeView {
         handle: string;
         resizing: string;
     };
+    /** Optional callback for creating custom resize handles */
+    createCustomHandle?: (direction: ResizableNodeViewDirection) => HTMLElement;
     /** Initial width of the element (for aspect ratio calculation) */
     private initialWidth;
     /** Initial height of the element (for aspect ratio calculation) */
@@ -3976,6 +4028,10 @@ declare class ResizableNodeView {
     private startHeight;
     /** Whether Shift key is currently pressed (for temporary aspect ratio lock) */
     private isShiftKeyPressed;
+    /** Last known editable state of the editor */
+    private lastEditableState;
+    /** Map of handle elements by direction */
+    private handleMap;
     /**
      * Creates a new ResizableNodeView instance.
      *
@@ -3995,6 +4051,7 @@ declare class ResizableNodeView {
      */
     get dom(): HTMLElement;
     get contentDOM(): HTMLElement | undefined;
+    private handleEditorUpdate;
     /**
      * Called when the node's content or attributes change.
      *
@@ -4062,6 +4119,12 @@ declare class ResizableNodeView {
      * positions it, attaches the mousedown listener, and appends it to the DOM.
      */
     private attachHandles;
+    /**
+     * Removes all resize handles from the wrapper.
+     *
+     * Cleans up the handle map and removes each handle element from the DOM.
+     */
+    private removeHandles;
     /**
      * Applies initial sizing from node attributes to the element.
      *
@@ -4455,6 +4518,20 @@ declare function createBlockMarkdownSpec(options: BlockMarkdownSpecOptions): {
     renderMarkdown: (node: JSONContent, h: MarkdownRendererHelpers) => string;
 };
 
+/**
+ * Configuration for an allowed attribute in markdown serialization.
+ * Can be a simple string (attribute name) or an object with additional options.
+ */
+type AllowedAttribute = string | {
+    /** The attribute name */
+    name: string;
+    /**
+     * If provided, the attribute will be skipped during serialization when its value
+     * equals this default value. This keeps markdown output clean by omitting
+     * attributes that have their default values.
+     */
+    skipIfDefault?: any;
+};
 interface InlineMarkdownSpecOptions {
     /** The Tiptap node name this spec is for */
     nodeName: string;
@@ -4470,8 +4547,26 @@ interface InlineMarkdownSpecOptions {
     defaultAttributes?: Record<string, any>;
     /** Whether this is a self-closing shortcode (no content, like [emoji name=party]) */
     selfClosing?: boolean;
-    /** Allowlist of attributes to include in markdown (if not provided, all attributes are included) */
-    allowedAttributes?: string[];
+    /**
+     * Allowlist of attributes to include in markdown serialization.
+     * If not provided, all attributes are included.
+     *
+     * Each item can be either:
+     * - A string: the attribute name (always included if present)
+     * - An object: `{ name: string, skipIfDefault?: any }` for conditional inclusion
+     *
+     * @example
+     * // Simple string attributes (backward compatible)
+     * allowedAttributes: ['id', 'label']
+     *
+     * // Mixed with conditional attributes
+     * allowedAttributes: [
+     *   'id',
+     *   'label',
+     *   { name: 'mentionSuggestionChar', skipIfDefault: '@' }
+     * ]
+     */
+    allowedAttributes?: AllowedAttribute[];
 }
 /**
  * Creates a complete markdown spec for inline nodes using attribute syntax.
@@ -4669,6 +4764,7 @@ declare function renderNestedMarkdownContent(node: JSONContent, h: {
  * for different types of nodes using unified syntax patterns.
  */
 
+type index_AllowedAttribute = AllowedAttribute;
 type index_AtomBlockMarkdownSpecOptions = AtomBlockMarkdownSpecOptions;
 type index_BlockMarkdownSpecOptions = BlockMarkdownSpecOptions;
 type index_BlockParserConfig = BlockParserConfig;
@@ -4682,7 +4778,7 @@ declare const index_parseIndentedBlocks: typeof parseIndentedBlocks;
 declare const index_renderNestedMarkdownContent: typeof renderNestedMarkdownContent;
 declare const index_serializeAttributes: typeof serializeAttributes;
 declare namespace index {
-  export { type index_AtomBlockMarkdownSpecOptions as AtomBlockMarkdownSpecOptions, type index_BlockMarkdownSpecOptions as BlockMarkdownSpecOptions, type index_BlockParserConfig as BlockParserConfig, type index_InlineMarkdownSpecOptions as InlineMarkdownSpecOptions, type index_ParsedBlock as ParsedBlock, index_createAtomBlockMarkdownSpec as createAtomBlockMarkdownSpec, index_createBlockMarkdownSpec as createBlockMarkdownSpec, index_createInlineMarkdownSpec as createInlineMarkdownSpec, index_parseAttributes as parseAttributes, index_parseIndentedBlocks as parseIndentedBlocks, index_renderNestedMarkdownContent as renderNestedMarkdownContent, index_serializeAttributes as serializeAttributes };
+  export { type index_AllowedAttribute as AllowedAttribute, type index_AtomBlockMarkdownSpecOptions as AtomBlockMarkdownSpecOptions, type index_BlockMarkdownSpecOptions as BlockMarkdownSpecOptions, type index_BlockParserConfig as BlockParserConfig, type index_InlineMarkdownSpecOptions as InlineMarkdownSpecOptions, type index_ParsedBlock as ParsedBlock, index_createAtomBlockMarkdownSpec as createAtomBlockMarkdownSpec, index_createBlockMarkdownSpec as createBlockMarkdownSpec, index_createInlineMarkdownSpec as createInlineMarkdownSpec, index_parseAttributes as parseAttributes, index_parseIndentedBlocks as parseIndentedBlocks, index_renderNestedMarkdownContent as renderNestedMarkdownContent, index_serializeAttributes as serializeAttributes };
 }
 
 declare function mergeAttributes(...objects: Record<string, any>[]): Record<string, any>;
@@ -4714,4 +4810,4 @@ interface Commands<ReturnType = any> {
 interface Storage {
 }
 
-export { type AnyCommands, type AnyConfig, type AnyExtension, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GetUpdatedPositionResult, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, MappablePosition, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResizableNodeDimensions, ResizableNodeView, type ResizableNodeViewDirection, type ResizableNodeViewOptions, ResizableNodeview, type SetContentOptions, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type Utils, type ValuesOf, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createMappablePosition, createNodeFromContent, createParagraphNear, createStyleTag, cut, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getUpdatedPosition, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, pasteRulesPlugin, posToDOMRect, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextDirection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, unsetTextDirection, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };
+export { type AllowedAttribute, type AnyCommands, type AnyConfig, type AnyExtension, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GetUpdatedPositionResult, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, MappablePosition, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResizableNodeDimensions, ResizableNodeView, type ResizableNodeViewDirection, type ResizableNodeViewOptions, ResizableNodeview, type SetContentOptions, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type Utils, type ValuesOf, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createMappablePosition, createNodeFromContent, createParagraphNear, createStyleTag, cut, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getUpdatedPosition, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, pasteRulesPlugin, posToDOMRect, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextDirection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, unsetTextDirection, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };

package/dist/index.d.ts

@@ -3761,6 +3761,10 @@ type ResizableNodeViewOptions = {
      * The ProseMirror node instance
      */
     node: Node$1;
+    /**
+     * The Tiptap editor instance
+     */
+    editor: Editor;
     /**
      * Function that returns the current position of the node in the document
      */
@@ -3884,6 +3888,50 @@ type ResizableNodeViewOptions = {
             /** Class added to container while actively resizing */
             resizing?: string;
         };
+        /**
+         * Optional callback for creating custom resize handle elements.
+         *
+         * This function allows developers to define their own handle element
+         * (e.g., custom icons, classes, or styles) for a given resize direction.
+         * It is called internally for each handle direction.
+         *
+         * @param direction - The direction of the handle being created (e.g., 'top', 'bottom-right').
+         * @returns The custom handle HTMLElement.
+         *
+         * @example
+         * ```ts
+         * createCustomHandle: (direction) => {
+         *   const handle = document.createElement('div')
+         *   handle.dataset.resizeHandle = direction
+         *   handle.style.position = 'absolute'
+         *   handle.className = 'tiptap-custom-handle'
+         *
+         *   const isTop = direction.includes('top')
+         *   const isBottom = direction.includes('bottom')
+         *   const isLeft = direction.includes('left')
+         *   const isRight = direction.includes('right')
+         *
+         *   if (isTop) handle.style.top = '0'
+         *   if (isBottom) handle.style.bottom = '0'
+         *   if (isLeft) handle.style.left = '0'
+         *   if (isRight) handle.style.right = '0'
+         *
+         *   // Edge handles span the full width or height
+         *   if (direction === 'top' || direction === 'bottom') {
+         *     handle.style.left = '0'
+         *     handle.style.right = '0'
+         *   }
+         *
+         *   if (direction === 'left' || direction === 'right') {
+         *     handle.style.top = '0'
+         *     handle.style.bottom = '0'
+         *   }
+         *
+         *   return handle
+         * }
+         * ```
+         */
+        createCustomHandle?: (direction: ResizableNodeViewDirection) => HTMLElement;
     };
 };
 /**
@@ -3925,6 +3973,8 @@ type ResizableNodeViewOptions = {
 declare class ResizableNodeView {
     /** The ProseMirror node instance */
     node: Node$1;
+    /** The Tiptap editor instance */
+    editor: Editor;
     /** The DOM element being made resizable */
     element: HTMLElement;
     /** The editable DOM element inside the DOM */
@@ -3956,6 +4006,8 @@ declare class ResizableNodeView {
         handle: string;
         resizing: string;
     };
+    /** Optional callback for creating custom resize handles */
+    createCustomHandle?: (direction: ResizableNodeViewDirection) => HTMLElement;
     /** Initial width of the element (for aspect ratio calculation) */
     private initialWidth;
     /** Initial height of the element (for aspect ratio calculation) */
@@ -3976,6 +4028,10 @@ declare class ResizableNodeView {
     private startHeight;
     /** Whether Shift key is currently pressed (for temporary aspect ratio lock) */
     private isShiftKeyPressed;
+    /** Last known editable state of the editor */
+    private lastEditableState;
+    /** Map of handle elements by direction */
+    private handleMap;
     /**
      * Creates a new ResizableNodeView instance.
      *
@@ -3995,6 +4051,7 @@ declare class ResizableNodeView {
      */
     get dom(): HTMLElement;
     get contentDOM(): HTMLElement | undefined;
+    private handleEditorUpdate;
     /**
      * Called when the node's content or attributes change.
      *
@@ -4062,6 +4119,12 @@ declare class ResizableNodeView {
      * positions it, attaches the mousedown listener, and appends it to the DOM.
      */
     private attachHandles;
+    /**
+     * Removes all resize handles from the wrapper.
+     *
+     * Cleans up the handle map and removes each handle element from the DOM.
+     */
+    private removeHandles;
     /**
      * Applies initial sizing from node attributes to the element.
      *
@@ -4455,6 +4518,20 @@ declare function createBlockMarkdownSpec(options: BlockMarkdownSpecOptions): {
     renderMarkdown: (node: JSONContent, h: MarkdownRendererHelpers) => string;
 };
 
+/**
+ * Configuration for an allowed attribute in markdown serialization.
+ * Can be a simple string (attribute name) or an object with additional options.
+ */
+type AllowedAttribute = string | {
+    /** The attribute name */
+    name: string;
+    /**
+     * If provided, the attribute will be skipped during serialization when its value
+     * equals this default value. This keeps markdown output clean by omitting
+     * attributes that have their default values.
+     */
+    skipIfDefault?: any;
+};
 interface InlineMarkdownSpecOptions {
     /** The Tiptap node name this spec is for */
     nodeName: string;
@@ -4470,8 +4547,26 @@ interface InlineMarkdownSpecOptions {
     defaultAttributes?: Record<string, any>;
     /** Whether this is a self-closing shortcode (no content, like [emoji name=party]) */
     selfClosing?: boolean;
-    /** Allowlist of attributes to include in markdown (if not provided, all attributes are included) */
-    allowedAttributes?: string[];
+    /**
+     * Allowlist of attributes to include in markdown serialization.
+     * If not provided, all attributes are included.
+     *
+     * Each item can be either:
+     * - A string: the attribute name (always included if present)
+     * - An object: `{ name: string, skipIfDefault?: any }` for conditional inclusion
+     *
+     * @example
+     * // Simple string attributes (backward compatible)
+     * allowedAttributes: ['id', 'label']
+     *
+     * // Mixed with conditional attributes
+     * allowedAttributes: [
+     *   'id',
+     *   'label',
+     *   { name: 'mentionSuggestionChar', skipIfDefault: '@' }
+     * ]
+     */
+    allowedAttributes?: AllowedAttribute[];
 }
 /**
  * Creates a complete markdown spec for inline nodes using attribute syntax.
@@ -4669,6 +4764,7 @@ declare function renderNestedMarkdownContent(node: JSONContent, h: {
  * for different types of nodes using unified syntax patterns.
  */
 
+type index_AllowedAttribute = AllowedAttribute;
 type index_AtomBlockMarkdownSpecOptions = AtomBlockMarkdownSpecOptions;
 type index_BlockMarkdownSpecOptions = BlockMarkdownSpecOptions;
 type index_BlockParserConfig = BlockParserConfig;
@@ -4682,7 +4778,7 @@ declare const index_parseIndentedBlocks: typeof parseIndentedBlocks;
 declare const index_renderNestedMarkdownContent: typeof renderNestedMarkdownContent;
 declare const index_serializeAttributes: typeof serializeAttributes;
 declare namespace index {
-  export { type index_AtomBlockMarkdownSpecOptions as AtomBlockMarkdownSpecOptions, type index_BlockMarkdownSpecOptions as BlockMarkdownSpecOptions, type index_BlockParserConfig as BlockParserConfig, type index_InlineMarkdownSpecOptions as InlineMarkdownSpecOptions, type index_ParsedBlock as ParsedBlock, index_createAtomBlockMarkdownSpec as createAtomBlockMarkdownSpec, index_createBlockMarkdownSpec as createBlockMarkdownSpec, index_createInlineMarkdownSpec as createInlineMarkdownSpec, index_parseAttributes as parseAttributes, index_parseIndentedBlocks as parseIndentedBlocks, index_renderNestedMarkdownContent as renderNestedMarkdownContent, index_serializeAttributes as serializeAttributes };
+  export { type index_AllowedAttribute as AllowedAttribute, type index_AtomBlockMarkdownSpecOptions as AtomBlockMarkdownSpecOptions, type index_BlockMarkdownSpecOptions as BlockMarkdownSpecOptions, type index_BlockParserConfig as BlockParserConfig, type index_InlineMarkdownSpecOptions as InlineMarkdownSpecOptions, type index_ParsedBlock as ParsedBlock, index_createAtomBlockMarkdownSpec as createAtomBlockMarkdownSpec, index_createBlockMarkdownSpec as createBlockMarkdownSpec, index_createInlineMarkdownSpec as createInlineMarkdownSpec, index_parseAttributes as parseAttributes, index_parseIndentedBlocks as parseIndentedBlocks, index_renderNestedMarkdownContent as renderNestedMarkdownContent, index_serializeAttributes as serializeAttributes };
 }
 
 declare function mergeAttributes(...objects: Record<string, any>[]): Record<string, any>;
@@ -4714,4 +4810,4 @@ interface Commands<ReturnType = any> {
 interface Storage {
 }
 
-export { type AnyCommands, type AnyConfig, type AnyExtension, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GetUpdatedPositionResult, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, MappablePosition, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResizableNodeDimensions, ResizableNodeView, type ResizableNodeViewDirection, type ResizableNodeViewOptions, ResizableNodeview, type SetContentOptions, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type Utils, type ValuesOf, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createMappablePosition, createNodeFromContent, createParagraphNear, createStyleTag, cut, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getUpdatedPosition, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, pasteRulesPlugin, posToDOMRect, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextDirection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, unsetTextDirection, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };
+export { type AllowedAttribute, type AnyCommands, type AnyConfig, type AnyExtension, type AtomBlockMarkdownSpecOptions, type Attribute, type Attributes$1 as Attributes, type BlockMarkdownSpecOptions, type BlockParserConfig, type CanCommands, type ChainedCommands, type ChangedRange, type Command, CommandManager, type CommandProps, type CommandSpec, type Commands, type Content, type CreateNodeFromContentOptions, type DOMNode, type DOMOutputSpecArray$1 as DOMOutputSpecArray, type DecorationType, type DecorationWithType, type Diff, type Dispatch, type DocumentType, Editor, type EditorEvents, type EditorOptions, type EnableRules, Extendable, type ExtendableConfig, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type FullMarkdownHelpers, type GetUpdatedPositionResult, type GlobalAttributes, type HTMLContent, type InlineMarkdownSpecOptions, InputRule, type InputRuleFinder, type InputRuleMatch, type InsertContentAtOptions, type InsertContentOptions, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, MappablePosition, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, type MarkdownExtensionSpec, type MarkdownHelpers, type MarkdownLexerConfiguration, type MarkdownParseHelpers, type MarkdownParseResult, type MarkdownRendererHelpers, type MarkdownToken, type MarkdownTokenizer, type MaybeReturnType, type MaybeThisParameterType, Node, type NodeConfig, NodePos, type NodeRange, type NodeType, NodeView, type NodeViewProps, type NodeViewRenderer, type NodeViewRendererOptions, type NodeViewRendererProps, type NodeWithPos, type Overwrite, type ParentConfig, type ParsedBlock, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type RenderContext, type ResizableNodeDimensions, ResizableNodeView, type ResizableNodeViewDirection, type ResizableNodeViewOptions, ResizableNodeview, type SetContentOptions, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type Utils, type ValuesOf, blur, callOrReturn, canInsertNode, clearContent, clearNodes, combineTransactionSteps, command, index$2 as commands, createAtomBlockMarkdownSpec, createBlockMarkdownSpec, createChainableState, createDocument, h as createElement, createInlineMarkdownSpec, createMappablePosition, createNodeFromContent, createParagraphNear, createStyleTag, cut, defaultBlockAt, deleteCurrentNode, deleteNode, deleteProps, deleteRange, deleteSelection, elementFromString, enter, escapeForRegEx, exitCode, extendMarkRange, index$1 as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, first, flattenExtensions, focus, forEach, fromString, generateHTML, generateJSON, generateText, getAttributes, getAttributesFromExtensions, getChangedRanges, getDebugJSON, getExtensionField, getHTMLFromFragment, getMarkAttributes, getMarkRange, getMarkType, getMarksBetween, getNodeAtPosition, getNodeAttributes, getNodeType, getRenderedAttributes, getSchema, getSchemaByResolvedExtensions, getSchemaTypeByName, getSchemaTypeNameByName, getSplittedAttributes, getText, getTextBetween, getTextContentFromNodes, getTextSerializersFromSchema, getUpdatedPosition, h, injectExtensionAttributesToParseRule, inputRulesPlugin, insertContent, insertContentAt, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, joinBackward, joinDown, joinForward, joinItemBackward, joinItemForward, joinTextblockBackward, joinTextblockForward, joinUp, keyboardShortcut, lift, liftEmptyBlock, liftListItem, markInputRule, markPasteRule, index as markdown, mergeAttributes, mergeDeep, minMax, newlineInCode, nodeInputRule, nodePasteRule, objectIncludes, parseAttributes, parseIndentedBlocks, pasteRulesPlugin, posToDOMRect, removeDuplicates, renderNestedMarkdownContent, resetAttributes, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, scrollIntoView, selectAll, selectNodeBackward, selectNodeForward, selectParentNode, selectTextblockEnd, selectTextblockStart, selectionToInsertionEnd, serializeAttributes, setContent, setMark, setMeta, setNode, setNodeSelection, setTextDirection, setTextSelection, sinkListItem, sortExtensions, splitBlock, splitExtensions, splitListItem, textInputRule, textPasteRule, textblockTypeInputRule, toggleList, toggleMark, toggleNode, toggleWrap, undoInputRule, unsetAllMarks, unsetMark, unsetTextDirection, updateAttributes, updateMarkViewAttributes, wrapIn, wrapInList, wrappingInputRule };

package/dist/index.js

@@ -5235,6 +5235,10 @@ var ResizableNodeView = class {
     this.startHeight = 0;
     /** Whether Shift key is currently pressed (for temporary aspect ratio lock) */
     this.isShiftKeyPressed = false;
+    /** Last known editable state of the editor */
+    this.lastEditableState = void 0;
+    /** Map of handle elements by direction */
+    this.handleMap = /* @__PURE__ */ new Map();
     /**
      * Handles mouse movement during an active resize.
      *
@@ -5311,8 +5315,9 @@ var ResizableNodeView = class {
         this.isShiftKeyPressed = false;
       }
     };
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     this.node = options.node;
+    this.editor = options.editor;
     this.element = options.element;
     this.contentElement = options.contentElement;
     this.getPos = options.getPos;
@@ -5342,10 +5347,14 @@ var ResizableNodeView = class {
         resizing: options.options.className.resizing || ""
       };
     }
+    if ((_f = options.options) == null ? void 0 : _f.createCustomHandle) {
+      this.createCustomHandle = options.options.createCustomHandle;
+    }
     this.wrapper = this.createWrapper();
     this.container = this.createContainer();
     this.applyInitialSize();
     this.attachHandles();
+    this.editor.on("update", this.handleEditorUpdate.bind(this));
   }
   /**
    * Returns the top-level DOM node that should be placed in the editor.
@@ -5361,6 +5370,18 @@ var ResizableNodeView = class {
   get contentDOM() {
     return this.contentElement;
   }
+  handleEditorUpdate() {
+    const isEditable = this.editor.isEditable;
+    if (isEditable === this.lastEditableState) {
+      return;
+    }
+    this.lastEditableState = isEditable;
+    if (!isEditable) {
+      this.removeHandles();
+    } else if (isEditable && this.handleMap.size === 0) {
+      this.attachHandles();
+    }
+  }
   /**
    * Called when the node's content or attributes change.
    *
@@ -5402,6 +5423,7 @@ var ResizableNodeView = class {
       this.isResizing = false;
       this.activeHandle = null;
     }
+    this.editor.off("update", this.handleEditorUpdate.bind(this));
     this.container.remove();
   }
   /**
@@ -5418,8 +5440,6 @@ var ResizableNodeView = class {
     element.dataset.resizeContainer = "";
     element.dataset.node = this.node.type.name;
     element.style.display = "flex";
-    element.style.justifyContent = "flex-start";
-    element.style.alignItems = "flex-start";
     if (this.classNames.container) {
       element.className = this.classNames.container;
     }
@@ -5507,13 +5527,36 @@ var ResizableNodeView = class {
    */
   attachHandles() {
     this.directions.forEach((direction) => {
-      const handle = this.createHandle(direction);
-      this.positionHandle(handle, direction);
+      let handle;
+      if (this.createCustomHandle) {
+        handle = this.createCustomHandle(direction);
+      } else {
+        handle = this.createHandle(direction);
+      }
+      if (!(handle instanceof HTMLElement)) {
+        console.warn(
+          `[ResizableNodeView] createCustomHandle("${direction}") did not return an HTMLElement. Falling back to default handle.`
+        );
+        handle = this.createHandle(direction);
+      }
+      if (!this.createCustomHandle) {
+        this.positionHandle(handle, direction);
+      }
       handle.addEventListener("mousedown", (event) => this.handleResizeStart(event, direction));
       handle.addEventListener("touchstart", (event) => this.handleResizeStart(event, direction));
+      this.handleMap.set(direction, handle);
       this.wrapper.appendChild(handle);
     });
   }
+  /**
+   * Removes all resize handles from the wrapper.
+   *
+   * Cleans up the handle map and removes each handle element from the DOM.
+   */
+  removeHandles() {
+    this.handleMap.forEach((el) => el.remove());
+    this.handleMap.clear();
+  }
   /**
    * Applies initial sizing from node attributes to the element.
    *
@@ -6060,9 +6103,15 @@ function createInlineMarkdownSpec(options) {
       return attrs;
     }
     const filtered = {};
-    allowedAttributes.forEach((key) => {
-      if (key in attrs) {
-        filtered[key] = attrs[key];
+    allowedAttributes.forEach((attr) => {
+      const attrName = typeof attr === "string" ? attr : attr.name;
+      const skipIfDefault = typeof attr === "string" ? void 0 : attr.skipIfDefault;
+      if (attrName in attrs) {
+        const value = attrs[attrName];
+        if (skipIfDefault !== void 0 && value === skipIfDefault) {
+          return;
+        }
+        filtered[attrName] = value;
       }
     });
     return filtered;