@tiptap/core 3.0.0-beta.2 → 3.0.0-beta.22

package/dist/index.d.cts

@@ -183,13 +183,17 @@ interface MarkConfig<Options = any, Storage = any> extends ExtendableConfig<Opti
  */
 declare class Mark<Options = any, Storage = any> extends Extendable<Options, Storage, MarkConfig<Options, Storage>> {
     type: string;
-    static create<O = any, S = any>(config?: Partial<MarkConfig<O, S>>): Mark<O, S>;
+    /**
+     * Create a new Mark instance
+     * @param config - Mark configuration object or a function that returns a configuration object
+     */
+    static create<O = any, S = any>(config?: Partial<MarkConfig<O, S>> | (() => Partial<MarkConfig<O, S>>)): Mark<O, S>;
     static handleExit({ editor, mark }: {
         editor: Editor;
         mark: Mark;
     }): boolean;
     configure(options?: Partial<Options>): Mark<Options, Storage>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = MarkConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig>): Mark<ExtendedOptions, ExtendedStorage>;
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = MarkConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig> | (() => Partial<ExtendedConfig>)): Mark<ExtendedOptions, ExtendedStorage>;
 }
 
 interface NodeConfig<Options = any, Storage = any> extends ExtendableConfig<Options, Storage, NodeConfig<Options, Storage>, NodeType$1> {
@@ -470,9 +474,13 @@ interface NodeConfig<Options = any, Storage = any> extends ExtendableConfig<Opti
  */
 declare class Node<Options = any, Storage = any> extends Extendable<Options, Storage, NodeConfig<Options, Storage>> {
     type: string;
-    static create<O = any, S = any>(config?: Partial<NodeConfig<O, S>>): Node<O, S>;
+    /**
+     * Create a new Node instance
+     * @param config - Node configuration object or a function that returns a configuration object
+     */
+    static create<O = any, S = any>(config?: Partial<NodeConfig<O, S>> | (() => Partial<NodeConfig<O, S>>)): Node<O, S>;
     configure(options?: Partial<Options>): Node<Options, Storage>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = NodeConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig>): Node<ExtendedOptions, ExtendedStorage>;
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = NodeConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig> | (() => Partial<ExtendedConfig>)): Node<ExtendedOptions, ExtendedStorage>;
 }
 
 type PasteRuleMatch = {
@@ -1155,6 +1163,27 @@ interface EditorOptions {
      * @default false
      */
     enableContentCheck: boolean;
+    /**
+     * If `true`, the editor will emit the `contentError` event if invalid content is
+     * encountered but `enableContentCheck` is `false`. This lets you preserve the
+     * invalid editor content while still showing a warning or error message to
+     * the user.
+     *
+     * @default false
+     */
+    emitContentError: boolean;
+    /**
+     * Enable a lazy-loaded Prosemirror DevTools integration.
+     *
+     * Requires having the `prosemirror-dev-tools` npm package installed.
+     * @type boolean
+     * @default false
+     * @example
+     * ```js
+     * enableDevTools: true
+     * ```
+     */
+    enableDevTools: boolean;
     /**
      * Called before the editor is constructed.
      */
@@ -1622,9 +1651,13 @@ interface ExtensionConfig<Options = any, Storage = any> extends ExtendableConfig
  */
 declare class Extension<Options = any, Storage = any> extends Extendable<Options, Storage, ExtensionConfig<Options, Storage>> {
     type: string;
-    static create<O = any, S = any>(config?: Partial<ExtensionConfig<O, S>>): Extension<O, S>;
+    /**
+     * Create a new Extension instance
+     * @param config - Extension configuration object or a function that returns a configuration object
+     */
+    static create<O = any, S = any>(config?: Partial<ExtensionConfig<O, S>> | (() => Partial<ExtensionConfig<O, S>>)): Extension<O, S>;
     configure(options?: Partial<Options>): Extension<Options, Storage>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = ExtensionConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig>): Extension<ExtendedOptions, ExtendedStorage>;
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = ExtensionConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig> | (() => Partial<ExtendedConfig>)): Extension<ExtendedOptions, ExtendedStorage>;
 }
 
 /**
@@ -2891,6 +2924,25 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * Remove the editor from the DOM, but still allow remounting at a different point in time
      */
     unmount(): void;
+    /**
+     *
+     * @returns
+     */
+    /**
+     * Applies ProseMirror dev tools to the editor instance if enabled and running in a browser environment.
+     *
+     * This method dynamically imports the `prosemirror-dev-tools` package and applies it to the current
+     * editor view. If the dev tools are not installed, a warning is logged to the console.
+     *
+     * @private
+     * @remarks
+     * - Dev tools are only applied if `this.options.enableDevTools` is `true` and the code is running in a browser.
+     * - If the editor view is not available, the dev tools are not applied.
+     * - If the `prosemirror-dev-tools` package is missing, a warning is shown in the console.
+     *
+     * @returns {void}
+     */
+    private applyDevTools;
     /**
      * Returns the editor storage.
      */
@@ -3256,6 +3308,8 @@ declare class Tracker {
  */
 declare function callOrReturn<T>(value: T, context?: any, ...props: any[]): MaybeReturnType<T>;
 
+declare function canInsertNode(state: EditorState, nodeType: NodeType$1): boolean;
+
 declare function createStyleTag(style: string, nonce?: string, suffix?: string): HTMLStyleElement;
 
 /**
@@ -3323,4 +3377,4 @@ interface Commands<ReturnType = any> {
 interface Storage {
 }
 
-export { type AnyCommands, type AnyConfig, type AnyExtension, type Attribute, type Attributes$1 as Attributes, 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, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type GlobalAttributes, type HTMLContent, InputRule, type InputRuleFinder, type InputRuleMatch, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, 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, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, callOrReturn, combineTransactionSteps, createChainableState, createDocument, h as createElement, createNodeFromContent, createStyleTag, defaultBlockAt, deleteProps, elementFromString, escapeForRegEx, index as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, flattenExtensions, 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, h, injectExtensionAttributesToParseRule, inputRulesPlugin, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, markInputRule, markPasteRule, mergeAttributes, mergeDeep, minMax, nodeInputRule, nodePasteRule, objectIncludes, pasteRulesPlugin, posToDOMRect, removeDuplicates, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, selectionToInsertionEnd, sortExtensions, splitExtensions, textInputRule, textPasteRule, textblockTypeInputRule, wrappingInputRule };
+export { type AnyCommands, type AnyConfig, type AnyExtension, type Attribute, type Attributes$1 as Attributes, 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, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type GlobalAttributes, type HTMLContent, InputRule, type InputRuleFinder, type InputRuleMatch, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, 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, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, callOrReturn, canInsertNode, combineTransactionSteps, createChainableState, createDocument, h as createElement, createNodeFromContent, createStyleTag, defaultBlockAt, deleteProps, elementFromString, escapeForRegEx, index as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, flattenExtensions, 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, h, injectExtensionAttributesToParseRule, inputRulesPlugin, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, markInputRule, markPasteRule, mergeAttributes, mergeDeep, minMax, nodeInputRule, nodePasteRule, objectIncludes, pasteRulesPlugin, posToDOMRect, removeDuplicates, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, selectionToInsertionEnd, sortExtensions, splitExtensions, textInputRule, textPasteRule, textblockTypeInputRule, wrappingInputRule };

package/dist/index.d.ts

@@ -183,13 +183,17 @@ interface MarkConfig<Options = any, Storage = any> extends ExtendableConfig<Opti
  */
 declare class Mark<Options = any, Storage = any> extends Extendable<Options, Storage, MarkConfig<Options, Storage>> {
     type: string;
-    static create<O = any, S = any>(config?: Partial<MarkConfig<O, S>>): Mark<O, S>;
+    /**
+     * Create a new Mark instance
+     * @param config - Mark configuration object or a function that returns a configuration object
+     */
+    static create<O = any, S = any>(config?: Partial<MarkConfig<O, S>> | (() => Partial<MarkConfig<O, S>>)): Mark<O, S>;
     static handleExit({ editor, mark }: {
         editor: Editor;
         mark: Mark;
     }): boolean;
     configure(options?: Partial<Options>): Mark<Options, Storage>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = MarkConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig>): Mark<ExtendedOptions, ExtendedStorage>;
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = MarkConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig> | (() => Partial<ExtendedConfig>)): Mark<ExtendedOptions, ExtendedStorage>;
 }
 
 interface NodeConfig<Options = any, Storage = any> extends ExtendableConfig<Options, Storage, NodeConfig<Options, Storage>, NodeType$1> {
@@ -470,9 +474,13 @@ interface NodeConfig<Options = any, Storage = any> extends ExtendableConfig<Opti
  */
 declare class Node<Options = any, Storage = any> extends Extendable<Options, Storage, NodeConfig<Options, Storage>> {
     type: string;
-    static create<O = any, S = any>(config?: Partial<NodeConfig<O, S>>): Node<O, S>;
+    /**
+     * Create a new Node instance
+     * @param config - Node configuration object or a function that returns a configuration object
+     */
+    static create<O = any, S = any>(config?: Partial<NodeConfig<O, S>> | (() => Partial<NodeConfig<O, S>>)): Node<O, S>;
     configure(options?: Partial<Options>): Node<Options, Storage>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = NodeConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig>): Node<ExtendedOptions, ExtendedStorage>;
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = NodeConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig> | (() => Partial<ExtendedConfig>)): Node<ExtendedOptions, ExtendedStorage>;
 }
 
 type PasteRuleMatch = {
@@ -1155,6 +1163,27 @@ interface EditorOptions {
      * @default false
      */
     enableContentCheck: boolean;
+    /**
+     * If `true`, the editor will emit the `contentError` event if invalid content is
+     * encountered but `enableContentCheck` is `false`. This lets you preserve the
+     * invalid editor content while still showing a warning or error message to
+     * the user.
+     *
+     * @default false
+     */
+    emitContentError: boolean;
+    /**
+     * Enable a lazy-loaded Prosemirror DevTools integration.
+     *
+     * Requires having the `prosemirror-dev-tools` npm package installed.
+     * @type boolean
+     * @default false
+     * @example
+     * ```js
+     * enableDevTools: true
+     * ```
+     */
+    enableDevTools: boolean;
     /**
      * Called before the editor is constructed.
      */
@@ -1622,9 +1651,13 @@ interface ExtensionConfig<Options = any, Storage = any> extends ExtendableConfig
  */
 declare class Extension<Options = any, Storage = any> extends Extendable<Options, Storage, ExtensionConfig<Options, Storage>> {
     type: string;
-    static create<O = any, S = any>(config?: Partial<ExtensionConfig<O, S>>): Extension<O, S>;
+    /**
+     * Create a new Extension instance
+     * @param config - Extension configuration object or a function that returns a configuration object
+     */
+    static create<O = any, S = any>(config?: Partial<ExtensionConfig<O, S>> | (() => Partial<ExtensionConfig<O, S>>)): Extension<O, S>;
     configure(options?: Partial<Options>): Extension<Options, Storage>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = ExtensionConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig>): Extension<ExtendedOptions, ExtendedStorage>;
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage, ExtendedConfig = ExtensionConfig<ExtendedOptions, ExtendedStorage>>(extendedConfig?: Partial<ExtendedConfig> | (() => Partial<ExtendedConfig>)): Extension<ExtendedOptions, ExtendedStorage>;
 }
 
 /**
@@ -2891,6 +2924,25 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * Remove the editor from the DOM, but still allow remounting at a different point in time
      */
     unmount(): void;
+    /**
+     *
+     * @returns
+     */
+    /**
+     * Applies ProseMirror dev tools to the editor instance if enabled and running in a browser environment.
+     *
+     * This method dynamically imports the `prosemirror-dev-tools` package and applies it to the current
+     * editor view. If the dev tools are not installed, a warning is logged to the console.
+     *
+     * @private
+     * @remarks
+     * - Dev tools are only applied if `this.options.enableDevTools` is `true` and the code is running in a browser.
+     * - If the editor view is not available, the dev tools are not applied.
+     * - If the `prosemirror-dev-tools` package is missing, a warning is shown in the console.
+     *
+     * @returns {void}
+     */
+    private applyDevTools;
     /**
      * Returns the editor storage.
      */
@@ -3256,6 +3308,8 @@ declare class Tracker {
  */
 declare function callOrReturn<T>(value: T, context?: any, ...props: any[]): MaybeReturnType<T>;
 
+declare function canInsertNode(state: EditorState, nodeType: NodeType$1): boolean;
+
 declare function createStyleTag(style: string, nonce?: string, suffix?: string): HTMLStyleElement;
 
 /**
@@ -3323,4 +3377,4 @@ interface Commands<ReturnType = any> {
 interface Storage {
 }
 
-export { type AnyCommands, type AnyConfig, type AnyExtension, type Attribute, type Attributes$1 as Attributes, 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, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type GlobalAttributes, type HTMLContent, InputRule, type InputRuleFinder, type InputRuleMatch, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, 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, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, callOrReturn, combineTransactionSteps, createChainableState, createDocument, h as createElement, createNodeFromContent, createStyleTag, defaultBlockAt, deleteProps, elementFromString, escapeForRegEx, index as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, flattenExtensions, 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, h, injectExtensionAttributesToParseRule, inputRulesPlugin, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, markInputRule, markPasteRule, mergeAttributes, mergeDeep, minMax, nodeInputRule, nodePasteRule, objectIncludes, pasteRulesPlugin, posToDOMRect, removeDuplicates, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, selectionToInsertionEnd, sortExtensions, splitExtensions, textInputRule, textPasteRule, textblockTypeInputRule, wrappingInputRule };
+export { type AnyCommands, type AnyConfig, type AnyExtension, type Attribute, type Attributes$1 as Attributes, 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, type ExtendedRegExpMatchArray, Extension, type ExtensionAttribute, type ExtensionConfig, type Extensions, type FocusPosition, Fragment, type GlobalAttributes, type HTMLContent, InputRule, type InputRuleFinder, type InputRuleMatch, type JSONContent, type KeyboardShortcutCommand, type KeysWithTypeOf, Mark, type MarkConfig, type MarkRange, type MarkType, MarkView, type MarkViewProps, type MarkViewRenderer, type MarkViewRendererOptions, type MarkViewRendererProps, 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, PasteRule, type PasteRuleFinder, type PasteRuleMatch, type PickValue, type Predicate, type Primitive, type Range, type RawCommands, type RemoveThis, type SingleCommands, type Storage, type TextSerializer, type TextType, type TiptapEditorHTMLElement, Tracker, type TrackerResult, type UnionCommands, type UnionToIntersection, type ValuesOf, callOrReturn, canInsertNode, combineTransactionSteps, createChainableState, createDocument, h as createElement, createNodeFromContent, createStyleTag, defaultBlockAt, deleteProps, elementFromString, escapeForRegEx, index as extensions, findChildren, findChildrenInRange, findDuplicates, findParentNode, findParentNodeClosestToPos, flattenExtensions, 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, h, injectExtensionAttributesToParseRule, inputRulesPlugin, isActive, isAndroid, isAtEndOfNode, isAtStartOfNode, isEmptyObject, isExtensionRulesEnabled, isFunction, isList, isMacOS, isMarkActive, isNodeActive, isNodeEmpty, isNodeSelection, isNumber, isPlainObject, isRegExp, isString, isTextSelection, isiOS, markInputRule, markPasteRule, mergeAttributes, mergeDeep, minMax, nodeInputRule, nodePasteRule, objectIncludes, pasteRulesPlugin, posToDOMRect, removeDuplicates, resolveExtensions, resolveFocusPosition, rewriteUnknownContent, selectionToInsertionEnd, sortExtensions, splitExtensions, textInputRule, textPasteRule, textblockTypeInputRule, wrappingInputRule };

package/dist/index.js

@@ -1,8 +1,6 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
+import {
+  __export
+} from "./chunk-PR4QN5HX.js";
 
 // src/helpers/createChainableState.ts
 function createChainableState(config) {
@@ -1831,8 +1829,13 @@ var Mark = class _Mark extends Extendable {
     super(...arguments);
     this.type = "mark";
   }
+  /**
+   * Create a new Mark instance
+   * @param config - Mark configuration object or a function that returns a configuration object
+   */
   static create(config = {}) {
-    return new _Mark(config);
+    const resolvedConfig = typeof config === "function" ? config() : config;
+    return new _Mark(resolvedConfig);
   }
   static handleExit({ editor, mark }) {
     const { tr } = editor.state;
@@ -1858,7 +1861,8 @@ var Mark = class _Mark extends Extendable {
     return super.configure(options);
   }
   extend(extendedConfig) {
-    return super.extend(extendedConfig);
+    const resolvedConfig = typeof extendedConfig === "function" ? extendedConfig() : extendedConfig;
+    return super.extend(resolvedConfig);
   }
 };
 
@@ -2026,7 +2030,7 @@ function pasteRulesPlugin(props) {
             dropEvent = event;
             if (!isDroppedFromProseMirror) {
               const dragFromOtherEditor = tiptapDragFromOtherEditor;
-              if (dragFromOtherEditor) {
+              if (dragFromOtherEditor == null ? void 0 : dragFromOtherEditor.isEditable) {
                 setTimeout(() => {
                   const selection = dragFromOtherEditor.state.selection;
                   if (selection) {
@@ -2363,14 +2367,20 @@ var Extension = class _Extension extends Extendable {
     super(...arguments);
     this.type = "extension";
   }
+  /**
+   * Create a new Extension instance
+   * @param config - Extension configuration object or a function that returns a configuration object
+   */
   static create(config = {}) {
-    return new _Extension(config);
+    const resolvedConfig = typeof config === "function" ? config() : config;
+    return new _Extension(resolvedConfig);
   }
   configure(options) {
     return super.configure(options);
   }
   extend(extendedConfig) {
-    return super.extend(extendedConfig);
+    const resolvedConfig = typeof extendedConfig === "function" ? extendedConfig() : extendedConfig;
+    return super.extend(resolvedConfig);
   }
 };
 
@@ -2540,7 +2550,7 @@ var cut = (originRange, targetPos) => ({ editor, tr }) => {
   tr.deleteRange(originRange.from, originRange.to);
   const newPos = tr.mapping.map(targetPos);
   tr.insert(newPos, contentSlice.content);
-  tr.setSelection(new TextSelection3(tr.doc.resolve(newPos - 1)));
+  tr.setSelection(new TextSelection3(tr.doc.resolve(Math.max(newPos - 1, 0))));
   return true;
 };
 
@@ -2716,18 +2726,10 @@ var insertContentAt = (position, value, options) => ({ tr, dispatch, editor }) =
     };
     let content;
     const { selection } = editor.state;
-    try {
-      content = createNodeFromContent(value, editor.schema, {
-        parseOptions: {
-          preserveWhitespace: "full",
-          ...options.parseOptions
-        },
-        errorOnInvalidContent: (_a = options.errorOnInvalidContent) != null ? _a : editor.options.enableContentCheck
-      });
-    } catch (e) {
+    const emitContentError = (error) => {
       editor.emit("contentError", {
         editor,
-        error: e,
+        error,
         disableCollaboration: () => {
           if ("collaboration" in editor.storage && typeof editor.storage.collaboration === "object" && editor.storage.collaboration) {
             ;
@@ -2735,6 +2737,28 @@ var insertContentAt = (position, value, options) => ({ tr, dispatch, editor }) =
           }
         }
       });
+    };
+    const parseOptions = {
+      preserveWhitespace: "full",
+      ...options.parseOptions
+    };
+    if (!options.errorOnInvalidContent && !editor.options.enableContentCheck && editor.options.emitContentError) {
+      try {
+        createNodeFromContent(value, editor.schema, {
+          parseOptions,
+          errorOnInvalidContent: true
+        });
+      } catch (e) {
+        emitContentError(e);
+      }
+    }
+    try {
+      content = createNodeFromContent(value, editor.schema, {
+        parseOptions,
+        errorOnInvalidContent: (_a = options.errorOnInvalidContent) != null ? _a : editor.options.enableContentCheck
+      });
+    } catch (e) {
+      emitContentError(e);
       return false;
     }
     let { from, to } = typeof position === "number" ? { from: position, to: position } : { from: position.from, to: position.to };
@@ -2776,7 +2800,8 @@ var insertContentAt = (position, value, options) => ({ tr, dispatch, editor }) =
       newContent = content;
       const fromSelectionAtStart = selection.$from.parentOffset === 0;
       const isTextSelection2 = selection.$from.node().isText || selection.$from.node().isTextblock;
-      if (fromSelectionAtStart && isTextSelection2) {
+      const hasContent = selection.$from.node().content.size > 0;
+      if (fromSelectionAtStart && isTextSelection2 && hasContent) {
         from = Math.max(0, from - 1);
       }
       tr.replaceWith(from, to, newContent);
@@ -4072,6 +4097,9 @@ var NodePos = class _NodePos {
       const isBlock = node.isBlock && !node.isTextblock;
       const isNonTextAtom = node.isAtom && !node.isText;
       const targetPos = this.pos + offset + (isNonTextAtom ? 0 : 1);
+      if (targetPos < 0 || targetPos > this.resolvedPos.doc.nodeSize - 2) {
+        return;
+      }
       const $pos = this.resolvedPos.doc.resolve(targetPos);
       if (!isBlock && $pos.depth <= this.depth) {
         return;
@@ -4269,6 +4297,8 @@ var Editor = class extends EventEmitter {
       enablePasteRules: true,
       enableCoreExtensions: true,
       enableContentCheck: false,
+      enableDevTools: false,
+      emitContentError: false,
       onBeforeCreate: () => null,
       onCreate: () => null,
       onUpdate: () => null,
@@ -4350,6 +4380,38 @@ var Editor = class extends EventEmitter {
     (_a = this.css) == null ? void 0 : _a.remove();
     this.css = null;
   }
+  /**
+   *
+   * @returns
+   */
+  /**
+   * Applies ProseMirror dev tools to the editor instance if enabled and running in a browser environment.
+   *
+   * This method dynamically imports the `prosemirror-dev-tools` package and applies it to the current
+   * editor view. If the dev tools are not installed, a warning is logged to the console.
+   *
+   * @private
+   * @remarks
+   * - Dev tools are only applied if `this.options.enableDevTools` is `true` and the code is running in a browser.
+   * - If the editor view is not available, the dev tools are not applied.
+   * - If the `prosemirror-dev-tools` package is missing, a warning is shown in the console.
+   *
+   * @returns {void}
+   */
+  applyDevTools() {
+    if (typeof window === "undefined" || !this.options.enableDevTools) {
+      return;
+    }
+    import("./esm-7BF7U2WM.js").then(({ default: apply }) => {
+      if (!this.editorView) {
+        return;
+      }
+      apply(this.editorView);
+    }).catch(() => {
+      console.warn("[Tiptap warning]: Devtools are enabled but `prosemirror-dev-tools` is not installed.");
+      console.warn("Install 'prosemirror-dev-tools' as a dev dependency to use the dev tools.");
+    });
+  }
   /**
    * Returns the editor storage.
    */
@@ -4434,7 +4496,8 @@ var Editor = class extends EventEmitter {
         // Stub some commonly accessed properties to prevent errors
         composing: false,
         dragging: null,
-        editable: true
+        editable: true,
+        isDestroyed: false
       },
       {
         get: (obj, key) => {
@@ -4487,7 +4550,7 @@ var Editor = class extends EventEmitter {
     let plugins = prevPlugins;
     [].concat(nameOrPluginKeyToRemove).forEach((nameOrPluginKey) => {
       const name = typeof nameOrPluginKey === "string" ? `${nameOrPluginKey}$` : nameOrPluginKey.key;
-      plugins = prevPlugins.filter((plugin) => !plugin.key.startsWith(name));
+      plugins = plugins.filter((plugin) => !plugin.key.startsWith(name));
     });
     if (prevPlugins.length === plugins.length) {
       return void 0;
@@ -4586,6 +4649,9 @@ var Editor = class extends EventEmitter {
       dispatchTransaction: this.dispatchTransaction.bind(this),
       state: this.editorState
     });
+    if (this.options.enableDevTools) {
+      this.applyDevTools();
+    }
     const newState = this.state.reconfigure({
       plugins: this.extensionManager.plugins
     });
@@ -4748,8 +4814,8 @@ var Editor = class extends EventEmitter {
    * Check if the editor is already destroyed.
    */
   get isDestroyed() {
-    var _a;
-    return !((_a = this.view) == null ? void 0 : _a.docView);
+    var _a, _b;
+    return (_b = (_a = this.editorView) == null ? void 0 : _a.isDestroyed) != null ? _b : true;
   }
   $node(selector, attributes) {
     var _a;
@@ -4927,6 +4993,29 @@ var h = (tag, attributes) => {
   return [tag, rest, children];
 };
 
+// src/utilities/canInsertNode.ts
+import { NodeSelection as NodeSelection4 } from "@tiptap/pm/state";
+function canInsertNode(state, nodeType) {
+  const { selection } = state;
+  const { $from } = selection;
+  if (selection instanceof NodeSelection4) {
+    const index = $from.index();
+    const parent = $from.parent;
+    return parent.canReplaceWith(index, index + 1, nodeType);
+  }
+  let depth = $from.depth;
+  while (depth >= 0) {
+    const index = $from.index(depth);
+    const parent = $from.node(depth);
+    const match = parent.contentMatchAt(index);
+    if (match.matchType(nodeType)) {
+      return true;
+    }
+    depth -= 1;
+  }
+  return false;
+}
+
 // src/utilities/escapeForRegEx.ts
 function escapeForRegEx(string) {
   return string.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
@@ -4984,19 +5073,25 @@ var Node3 = class _Node extends Extendable {
     super(...arguments);
     this.type = "node";
   }
+  /**
+   * Create a new Node instance
+   * @param config - Node configuration object or a function that returns a configuration object
+   */
   static create(config = {}) {
-    return new _Node(config);
+    const resolvedConfig = typeof config === "function" ? config() : config;
+    return new _Node(resolvedConfig);
   }
   configure(options) {
     return super.configure(options);
   }
   extend(extendedConfig) {
-    return super.extend(extendedConfig);
+    const resolvedConfig = typeof extendedConfig === "function" ? extendedConfig() : extendedConfig;
+    return super.extend(resolvedConfig);
   }
 };
 
 // src/NodeView.ts
-import { NodeSelection as NodeSelection4 } from "@tiptap/pm/state";
+import { NodeSelection as NodeSelection5 } from "@tiptap/pm/state";
 var NodeView = class {
   constructor(component, props, options) {
     this.isDragging = false;
@@ -5049,7 +5144,7 @@ var NodeView = class {
     if (typeof pos !== "number") {
       return;
     }
-    const selection = NodeSelection4.create(view.state.doc, pos);
+    const selection = NodeSelection5.create(view.state.doc, pos);
     const transaction = view.state.tr.setSelection(selection);
     view.dispatch(transaction);
   }
@@ -5075,7 +5170,7 @@ var NodeView = class {
     const { isEditable } = this.editor;
     const { isDragging } = this;
     const isDraggable = !!this.node.type.spec.draggable;
-    const isSelectable = NodeSelection4.isSelectable(this.node);
+    const isSelectable = NodeSelection5.isSelectable(this.node);
     const isCopyEvent = event.type === "copy";
     const isPasteEvent = event.type === "paste";
     const isCutEvent = event.type === "cut";
@@ -5298,6 +5393,7 @@ export {
   PasteRule,
   Tracker,
   callOrReturn,
+  canInsertNode,
   combineTransactionSteps,
   createChainableState,
   createDocument,