@tiptap/react 3.0.0-next.0 → 3.0.0-next.2

package/dist/index.d.cts

@@ -0,0 +1,334 @@
+import { BubbleMenuPluginProps } from '@tiptap/extension-bubble-menu';
+import * as React from 'react';
+import React__default, { DependencyList, ReactNode, HTMLAttributes, HTMLProps, ForwardedRef, ComponentType as ComponentType$1 } from 'react';
+import { EditorOptions, Editor, NodeViewRendererOptions, NodeViewProps, NodeView, NodeViewRenderer } from '@tiptap/core';
+export * from '@tiptap/core';
+import { FloatingMenuPluginProps } from '@tiptap/extension-floating-menu';
+import { Node } from '@tiptap/pm/model';
+import { Decoration, DecorationSource } from '@tiptap/pm/view';
+
+type Optional$1<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+type BubbleMenuProps = Omit<Optional$1<BubbleMenuPluginProps, 'pluginKey'>, 'element' | 'editor'> & {
+    editor: BubbleMenuPluginProps['editor'] | null;
+    updateDelay?: number;
+    resizeDelay?: number;
+    options?: BubbleMenuPluginProps['options'];
+} & React__default.HTMLAttributes<HTMLDivElement>;
+declare const BubbleMenu: React__default.ForwardRefExoticComponent<Omit<Optional$1<BubbleMenuPluginProps, "pluginKey">, "editor" | "element"> & {
+    editor: BubbleMenuPluginProps["editor"] | null;
+    updateDelay?: number;
+    resizeDelay?: number;
+    options?: BubbleMenuPluginProps["options"];
+} & React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * The options for the `useEditor` hook.
+ */
+type UseEditorOptions = Partial<EditorOptions> & {
+    /**
+     * Whether to render the editor on the first render.
+     * If client-side rendering, set this to `true`.
+     * If server-side rendering, set this to `false`.
+     * @default true
+     */
+    immediatelyRender?: boolean;
+    /**
+     * Whether to re-render the editor on each transaction.
+     * This is legacy behavior that will be removed in future versions.
+     * @default false
+     */
+    shouldRerenderOnTransaction?: boolean;
+};
+/**
+ * This hook allows you to create an editor instance.
+ * @param options The editor options
+ * @param deps The dependencies to watch for changes
+ * @returns The editor instance
+ * @example const editor = useEditor({ extensions: [...] })
+ */
+declare function useEditor(options: UseEditorOptions & {
+    immediatelyRender: false;
+}, deps?: DependencyList): Editor | null;
+/**
+ * This hook allows you to create an editor instance.
+ * @param options The editor options
+ * @param deps The dependencies to watch for changes
+ * @returns The editor instance
+ * @example const editor = useEditor({ extensions: [...] })
+ */
+declare function useEditor(options: UseEditorOptions, deps?: DependencyList): Editor;
+
+type EditorContextValue = {
+    editor: Editor | null;
+};
+declare const EditorContext: React__default.Context<EditorContextValue>;
+declare const EditorConsumer: React__default.Consumer<EditorContextValue>;
+/**
+ * A hook to get the current editor instance.
+ */
+declare const useCurrentEditor: () => EditorContextValue;
+type EditorProviderProps = {
+    children?: ReactNode;
+    slotBefore?: ReactNode;
+    slotAfter?: ReactNode;
+    editorContainerProps?: HTMLAttributes<HTMLDivElement>;
+} & UseEditorOptions;
+/**
+ * This is the provider component for the editor.
+ * It allows the editor to be accessible across the entire component tree
+ * with `useCurrentEditor`.
+ */
+declare function EditorProvider({ children, slotAfter, slotBefore, editorContainerProps, ...editorOptions }: EditorProviderProps): React__default.JSX.Element | null;
+
+interface EditorContentProps extends HTMLProps<HTMLDivElement> {
+    editor: Editor | null;
+    innerRef?: ForwardedRef<HTMLDivElement | null>;
+}
+declare class PureEditorContent extends React__default.Component<EditorContentProps, {
+    hasContentComponentInitialized: boolean;
+}> {
+    editorContentRef: React__default.RefObject<any>;
+    initialized: boolean;
+    unsubscribeToContentComponent?: () => void;
+    constructor(props: EditorContentProps);
+    componentDidMount(): void;
+    componentDidUpdate(): void;
+    init(): void;
+    componentWillUnmount(): void;
+    render(): React__default.JSX.Element;
+}
+declare const EditorContent: React__default.MemoExoticComponent<React__default.ForwardRefExoticComponent<Omit<EditorContentProps, "ref"> & React__default.RefAttributes<HTMLDivElement>>>;
+
+type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+type FloatingMenuProps = Omit<Optional<FloatingMenuPluginProps, 'pluginKey'>, 'element' | 'editor'> & {
+    editor: FloatingMenuPluginProps['editor'] | null;
+    options?: FloatingMenuPluginProps['options'];
+} & React__default.HTMLAttributes<HTMLDivElement>;
+declare const FloatingMenu: React__default.ForwardRefExoticComponent<Omit<Optional<FloatingMenuPluginProps, "pluginKey">, "editor" | "element"> & {
+    editor: FloatingMenuPluginProps["editor"] | null;
+    options?: FloatingMenuPluginProps["options"];
+} & React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+interface NodeViewContentProps {
+    [key: string]: any;
+    as?: React__default.ElementType;
+}
+declare const NodeViewContent: React__default.FC<NodeViewContentProps>;
+
+interface NodeViewWrapperProps {
+    [key: string]: any;
+    as?: React__default.ElementType;
+}
+declare const NodeViewWrapper: React__default.FC<NodeViewWrapperProps>;
+
+interface ReactRendererOptions {
+    /**
+     * The editor instance.
+     * @type {Editor}
+     */
+    editor: Editor;
+    /**
+     * The props for the component.
+     * @type {Record<string, any>}
+     * @default {}
+     */
+    props?: Record<string, any>;
+    /**
+     * The tag name of the element.
+     * @type {string}
+     * @default 'div'
+     */
+    as?: string;
+    /**
+     * The class name of the element.
+     * @type {string}
+     * @default ''
+     * @example 'foo bar'
+     */
+    className?: string;
+}
+type ComponentType<R, P> = React__default.ComponentClass<P> | React__default.FunctionComponent<P> | React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<P> & React__default.RefAttributes<R>>;
+/**
+ * The ReactRenderer class. It's responsible for rendering React components inside the editor.
+ * @example
+ * new ReactRenderer(MyComponent, {
+ *   editor,
+ *   props: {
+ *     foo: 'bar',
+ *   },
+ *   as: 'span',
+ * })
+*/
+declare class ReactRenderer<R = unknown, P extends Record<string, any> = {}> {
+    id: string;
+    editor: Editor;
+    component: any;
+    element: Element;
+    props: P;
+    reactElement: React__default.ReactNode;
+    ref: R | null;
+    /**
+     * Immediately creates element and renders the provided React component.
+     */
+    constructor(component: ComponentType<R, P>, { editor, props, as, className, }: ReactRendererOptions);
+    /**
+     * Render the React component.
+     */
+    render(): void;
+    /**
+     * Re-renders the React component with new props.
+     */
+    updateProps(props?: Record<string, any>): void;
+    /**
+     * Destroy the React component.
+     */
+    destroy(): void;
+    /**
+     * Update the attributes of the element that holds the React component.
+     */
+    updateAttributes(attributes: Record<string, string>): void;
+}
+
+interface ReactNodeViewRendererOptions extends NodeViewRendererOptions {
+    /**
+     * This function is called when the node view is updated.
+     * It allows you to compare the old node with the new node and decide if the component should update.
+     */
+    update: ((props: {
+        oldNode: Node;
+        oldDecorations: readonly Decoration[];
+        oldInnerDecorations: DecorationSource;
+        newNode: Node;
+        newDecorations: readonly Decoration[];
+        innerDecorations: DecorationSource;
+        updateProps: () => void;
+    }) => boolean) | null;
+    /**
+     * The tag name of the element wrapping the React component.
+     */
+    as?: string;
+    /**
+     * The class name of the element wrapping the React component.
+     */
+    className?: string;
+    /**
+     * Attributes that should be applied to the element wrapping the React component.
+     * If this is a function, it will be called each time the node view is updated.
+     * If this is an object, it will be applied once when the node view is mounted.
+     */
+    attrs?: Record<string, string> | ((props: {
+        node: Node;
+        HTMLAttributes: Record<string, any>;
+    }) => Record<string, string>);
+}
+declare class ReactNodeView<Component extends ComponentType$1<NodeViewProps> = ComponentType$1<NodeViewProps>, NodeEditor extends Editor = Editor, Options extends ReactNodeViewRendererOptions = ReactNodeViewRendererOptions> extends NodeView<Component, NodeEditor, Options> {
+    /**
+     * The renderer instance.
+     */
+    renderer: ReactRenderer<unknown, NodeViewProps>;
+    /**
+     * The element that holds the rich-text content of the node.
+     */
+    contentDOMElement: HTMLElement | null;
+    /**
+     * Setup the React component.
+     * Called on initialization.
+     */
+    mount(): void;
+    /**
+     * Return the DOM element.
+     * This is the element that will be used to display the node view.
+     */
+    get dom(): HTMLElement;
+    /**
+     * Return the content DOM element.
+     * This is the element that will be used to display the rich-text content of the node.
+     */
+    get contentDOM(): HTMLElement | null;
+    /**
+     * On editor selection update, check if the node is selected.
+     * If it is, call `selectNode`, otherwise call `deselectNode`.
+     */
+    handleSelectionUpdate(): void;
+    /**
+     * On update, update the React component.
+     * To prevent unnecessary updates, the `update` option can be used.
+     */
+    update(node: Node, decorations: readonly Decoration[], innerDecorations: DecorationSource): boolean;
+    /**
+     * Select the node.
+     * Add the `selected` prop and the `ProseMirror-selectednode` class.
+     */
+    selectNode(): void;
+    /**
+     * Deselect the node.
+     * Remove the `selected` prop and the `ProseMirror-selectednode` class.
+     */
+    deselectNode(): void;
+    /**
+     * Destroy the React component instance.
+     */
+    destroy(): void;
+    /**
+     * Update the attributes of the top-level element that holds the React component.
+     * Applying the attributes defined in the `attrs` option.
+     */
+    updateElementAttributes(): void;
+}
+/**
+ * Create a React node view renderer.
+ */
+declare function ReactNodeViewRenderer(component: ComponentType$1<NodeViewProps>, options?: Partial<ReactNodeViewRendererOptions>): NodeViewRenderer;
+
+type EditorStateSnapshot<TEditor extends Editor | null = Editor | null> = {
+    editor: TEditor;
+    transactionNumber: number;
+};
+type UseEditorStateOptions<TSelectorResult, TEditor extends Editor | null = Editor | null> = {
+    /**
+     * The editor instance.
+     */
+    editor: TEditor;
+    /**
+     * A selector function to determine the value to compare for re-rendering.
+     */
+    selector: (context: EditorStateSnapshot<TEditor>) => TSelectorResult;
+    /**
+     * A custom equality function to determine if the editor should re-render.
+     * @default `deepEqual` from `fast-deep-equal`
+     */
+    equalityFn?: (a: TSelectorResult, b: TSelectorResult | null) => boolean;
+};
+/**
+ * This hook allows you to watch for changes on the editor instance.
+ * It will allow you to select a part of the editor state and re-render the component when it changes.
+ * @example
+ * ```tsx
+ * const editor = useEditor({...options})
+ * const { currentSelection } = useEditorState({
+ *  editor,
+ *  selector: snapshot => ({ currentSelection: snapshot.editor.state.selection }),
+ * })
+ */
+declare function useEditorState<TSelectorResult>(options: UseEditorStateOptions<TSelectorResult, Editor>): TSelectorResult;
+/**
+ * This hook allows you to watch for changes on the editor instance.
+ * It will allow you to select a part of the editor state and re-render the component when it changes.
+ * @example
+ * ```tsx
+ * const editor = useEditor({...options})
+ * const { currentSelection } = useEditorState({
+ *  editor,
+ *  selector: snapshot => ({ currentSelection: snapshot.editor.state.selection }),
+ * })
+ */
+declare function useEditorState<TSelectorResult>(options: UseEditorStateOptions<TSelectorResult, Editor | null>): TSelectorResult | null;
+
+interface ReactNodeViewContextProps {
+    onDragStart: (event: DragEvent) => void;
+    nodeViewContentRef: (element: HTMLElement | null) => void;
+}
+declare const ReactNodeViewContext: React.Context<Partial<ReactNodeViewContextProps>>;
+declare const useReactNodeView: () => Partial<ReactNodeViewContextProps>;
+
+export { BubbleMenu, type BubbleMenuProps, EditorConsumer, EditorContent, type EditorContentProps, EditorContext, type EditorContextValue, EditorProvider, type EditorProviderProps, type EditorStateSnapshot, FloatingMenu, type FloatingMenuProps, NodeViewContent, type NodeViewContentProps, NodeViewWrapper, type NodeViewWrapperProps, PureEditorContent, ReactNodeView, ReactNodeViewContext, type ReactNodeViewContextProps, ReactNodeViewRenderer, type ReactNodeViewRendererOptions, ReactRenderer, type ReactRendererOptions, type UseEditorOptions, type UseEditorStateOptions, useCurrentEditor, useEditor, useEditorState, useReactNodeView };

package/dist/index.d.ts

@@ -0,0 +1,334 @@
+import { BubbleMenuPluginProps } from '@tiptap/extension-bubble-menu';
+import * as React from 'react';
+import React__default, { DependencyList, ReactNode, HTMLAttributes, HTMLProps, ForwardedRef, ComponentType as ComponentType$1 } from 'react';
+import { EditorOptions, Editor, NodeViewRendererOptions, NodeViewProps, NodeView, NodeViewRenderer } from '@tiptap/core';
+export * from '@tiptap/core';
+import { FloatingMenuPluginProps } from '@tiptap/extension-floating-menu';
+import { Node } from '@tiptap/pm/model';
+import { Decoration, DecorationSource } from '@tiptap/pm/view';
+
+type Optional$1<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+type BubbleMenuProps = Omit<Optional$1<BubbleMenuPluginProps, 'pluginKey'>, 'element' | 'editor'> & {
+    editor: BubbleMenuPluginProps['editor'] | null;
+    updateDelay?: number;
+    resizeDelay?: number;
+    options?: BubbleMenuPluginProps['options'];
+} & React__default.HTMLAttributes<HTMLDivElement>;
+declare const BubbleMenu: React__default.ForwardRefExoticComponent<Omit<Optional$1<BubbleMenuPluginProps, "pluginKey">, "editor" | "element"> & {
+    editor: BubbleMenuPluginProps["editor"] | null;
+    updateDelay?: number;
+    resizeDelay?: number;
+    options?: BubbleMenuPluginProps["options"];
+} & React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * The options for the `useEditor` hook.
+ */
+type UseEditorOptions = Partial<EditorOptions> & {
+    /**
+     * Whether to render the editor on the first render.
+     * If client-side rendering, set this to `true`.
+     * If server-side rendering, set this to `false`.
+     * @default true
+     */
+    immediatelyRender?: boolean;
+    /**
+     * Whether to re-render the editor on each transaction.
+     * This is legacy behavior that will be removed in future versions.
+     * @default false
+     */
+    shouldRerenderOnTransaction?: boolean;
+};
+/**
+ * This hook allows you to create an editor instance.
+ * @param options The editor options
+ * @param deps The dependencies to watch for changes
+ * @returns The editor instance
+ * @example const editor = useEditor({ extensions: [...] })
+ */
+declare function useEditor(options: UseEditorOptions & {
+    immediatelyRender: false;
+}, deps?: DependencyList): Editor | null;
+/**
+ * This hook allows you to create an editor instance.
+ * @param options The editor options
+ * @param deps The dependencies to watch for changes
+ * @returns The editor instance
+ * @example const editor = useEditor({ extensions: [...] })
+ */
+declare function useEditor(options: UseEditorOptions, deps?: DependencyList): Editor;
+
+type EditorContextValue = {
+    editor: Editor | null;
+};
+declare const EditorContext: React__default.Context<EditorContextValue>;
+declare const EditorConsumer: React__default.Consumer<EditorContextValue>;
+/**
+ * A hook to get the current editor instance.
+ */
+declare const useCurrentEditor: () => EditorContextValue;
+type EditorProviderProps = {
+    children?: ReactNode;
+    slotBefore?: ReactNode;
+    slotAfter?: ReactNode;
+    editorContainerProps?: HTMLAttributes<HTMLDivElement>;
+} & UseEditorOptions;
+/**
+ * This is the provider component for the editor.
+ * It allows the editor to be accessible across the entire component tree
+ * with `useCurrentEditor`.
+ */
+declare function EditorProvider({ children, slotAfter, slotBefore, editorContainerProps, ...editorOptions }: EditorProviderProps): React__default.JSX.Element | null;
+
+interface EditorContentProps extends HTMLProps<HTMLDivElement> {
+    editor: Editor | null;
+    innerRef?: ForwardedRef<HTMLDivElement | null>;
+}
+declare class PureEditorContent extends React__default.Component<EditorContentProps, {
+    hasContentComponentInitialized: boolean;
+}> {
+    editorContentRef: React__default.RefObject<any>;
+    initialized: boolean;
+    unsubscribeToContentComponent?: () => void;
+    constructor(props: EditorContentProps);
+    componentDidMount(): void;
+    componentDidUpdate(): void;
+    init(): void;
+    componentWillUnmount(): void;
+    render(): React__default.JSX.Element;
+}
+declare const EditorContent: React__default.MemoExoticComponent<React__default.ForwardRefExoticComponent<Omit<EditorContentProps, "ref"> & React__default.RefAttributes<HTMLDivElement>>>;
+
+type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+type FloatingMenuProps = Omit<Optional<FloatingMenuPluginProps, 'pluginKey'>, 'element' | 'editor'> & {
+    editor: FloatingMenuPluginProps['editor'] | null;
+    options?: FloatingMenuPluginProps['options'];
+} & React__default.HTMLAttributes<HTMLDivElement>;
+declare const FloatingMenu: React__default.ForwardRefExoticComponent<Omit<Optional<FloatingMenuPluginProps, "pluginKey">, "editor" | "element"> & {
+    editor: FloatingMenuPluginProps["editor"] | null;
+    options?: FloatingMenuPluginProps["options"];
+} & React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+interface NodeViewContentProps {
+    [key: string]: any;
+    as?: React__default.ElementType;
+}
+declare const NodeViewContent: React__default.FC<NodeViewContentProps>;
+
+interface NodeViewWrapperProps {
+    [key: string]: any;
+    as?: React__default.ElementType;
+}
+declare const NodeViewWrapper: React__default.FC<NodeViewWrapperProps>;
+
+interface ReactRendererOptions {
+    /**
+     * The editor instance.
+     * @type {Editor}
+     */
+    editor: Editor;
+    /**
+     * The props for the component.
+     * @type {Record<string, any>}
+     * @default {}
+     */
+    props?: Record<string, any>;
+    /**
+     * The tag name of the element.
+     * @type {string}
+     * @default 'div'
+     */
+    as?: string;
+    /**
+     * The class name of the element.
+     * @type {string}
+     * @default ''
+     * @example 'foo bar'
+     */
+    className?: string;
+}
+type ComponentType<R, P> = React__default.ComponentClass<P> | React__default.FunctionComponent<P> | React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<P> & React__default.RefAttributes<R>>;
+/**
+ * The ReactRenderer class. It's responsible for rendering React components inside the editor.
+ * @example
+ * new ReactRenderer(MyComponent, {
+ *   editor,
+ *   props: {
+ *     foo: 'bar',
+ *   },
+ *   as: 'span',
+ * })
+*/
+declare class ReactRenderer<R = unknown, P extends Record<string, any> = {}> {
+    id: string;
+    editor: Editor;
+    component: any;
+    element: Element;
+    props: P;
+    reactElement: React__default.ReactNode;
+    ref: R | null;
+    /**
+     * Immediately creates element and renders the provided React component.
+     */
+    constructor(component: ComponentType<R, P>, { editor, props, as, className, }: ReactRendererOptions);
+    /**
+     * Render the React component.
+     */
+    render(): void;
+    /**
+     * Re-renders the React component with new props.
+     */
+    updateProps(props?: Record<string, any>): void;
+    /**
+     * Destroy the React component.
+     */
+    destroy(): void;
+    /**
+     * Update the attributes of the element that holds the React component.
+     */
+    updateAttributes(attributes: Record<string, string>): void;
+}
+
+interface ReactNodeViewRendererOptions extends NodeViewRendererOptions {
+    /**
+     * This function is called when the node view is updated.
+     * It allows you to compare the old node with the new node and decide if the component should update.
+     */
+    update: ((props: {
+        oldNode: Node;
+        oldDecorations: readonly Decoration[];
+        oldInnerDecorations: DecorationSource;
+        newNode: Node;
+        newDecorations: readonly Decoration[];
+        innerDecorations: DecorationSource;
+        updateProps: () => void;
+    }) => boolean) | null;
+    /**
+     * The tag name of the element wrapping the React component.
+     */
+    as?: string;
+    /**
+     * The class name of the element wrapping the React component.
+     */
+    className?: string;
+    /**
+     * Attributes that should be applied to the element wrapping the React component.
+     * If this is a function, it will be called each time the node view is updated.
+     * If this is an object, it will be applied once when the node view is mounted.
+     */
+    attrs?: Record<string, string> | ((props: {
+        node: Node;
+        HTMLAttributes: Record<string, any>;
+    }) => Record<string, string>);
+}
+declare class ReactNodeView<Component extends ComponentType$1<NodeViewProps> = ComponentType$1<NodeViewProps>, NodeEditor extends Editor = Editor, Options extends ReactNodeViewRendererOptions = ReactNodeViewRendererOptions> extends NodeView<Component, NodeEditor, Options> {
+    /**
+     * The renderer instance.
+     */
+    renderer: ReactRenderer<unknown, NodeViewProps>;
+    /**
+     * The element that holds the rich-text content of the node.
+     */
+    contentDOMElement: HTMLElement | null;
+    /**
+     * Setup the React component.
+     * Called on initialization.
+     */
+    mount(): void;
+    /**
+     * Return the DOM element.
+     * This is the element that will be used to display the node view.
+     */
+    get dom(): HTMLElement;
+    /**
+     * Return the content DOM element.
+     * This is the element that will be used to display the rich-text content of the node.
+     */
+    get contentDOM(): HTMLElement | null;
+    /**
+     * On editor selection update, check if the node is selected.
+     * If it is, call `selectNode`, otherwise call `deselectNode`.
+     */
+    handleSelectionUpdate(): void;
+    /**
+     * On update, update the React component.
+     * To prevent unnecessary updates, the `update` option can be used.
+     */
+    update(node: Node, decorations: readonly Decoration[], innerDecorations: DecorationSource): boolean;
+    /**
+     * Select the node.
+     * Add the `selected` prop and the `ProseMirror-selectednode` class.
+     */
+    selectNode(): void;
+    /**
+     * Deselect the node.
+     * Remove the `selected` prop and the `ProseMirror-selectednode` class.
+     */
+    deselectNode(): void;
+    /**
+     * Destroy the React component instance.
+     */
+    destroy(): void;
+    /**
+     * Update the attributes of the top-level element that holds the React component.
+     * Applying the attributes defined in the `attrs` option.
+     */
+    updateElementAttributes(): void;
+}
+/**
+ * Create a React node view renderer.
+ */
+declare function ReactNodeViewRenderer(component: ComponentType$1<NodeViewProps>, options?: Partial<ReactNodeViewRendererOptions>): NodeViewRenderer;
+
+type EditorStateSnapshot<TEditor extends Editor | null = Editor | null> = {
+    editor: TEditor;
+    transactionNumber: number;
+};
+type UseEditorStateOptions<TSelectorResult, TEditor extends Editor | null = Editor | null> = {
+    /**
+     * The editor instance.
+     */
+    editor: TEditor;
+    /**
+     * A selector function to determine the value to compare for re-rendering.
+     */
+    selector: (context: EditorStateSnapshot<TEditor>) => TSelectorResult;
+    /**
+     * A custom equality function to determine if the editor should re-render.
+     * @default `deepEqual` from `fast-deep-equal`
+     */
+    equalityFn?: (a: TSelectorResult, b: TSelectorResult | null) => boolean;
+};
+/**
+ * This hook allows you to watch for changes on the editor instance.
+ * It will allow you to select a part of the editor state and re-render the component when it changes.
+ * @example
+ * ```tsx
+ * const editor = useEditor({...options})
+ * const { currentSelection } = useEditorState({
+ *  editor,
+ *  selector: snapshot => ({ currentSelection: snapshot.editor.state.selection }),
+ * })
+ */
+declare function useEditorState<TSelectorResult>(options: UseEditorStateOptions<TSelectorResult, Editor>): TSelectorResult;
+/**
+ * This hook allows you to watch for changes on the editor instance.
+ * It will allow you to select a part of the editor state and re-render the component when it changes.
+ * @example
+ * ```tsx
+ * const editor = useEditor({...options})
+ * const { currentSelection } = useEditorState({
+ *  editor,
+ *  selector: snapshot => ({ currentSelection: snapshot.editor.state.selection }),
+ * })
+ */
+declare function useEditorState<TSelectorResult>(options: UseEditorStateOptions<TSelectorResult, Editor | null>): TSelectorResult | null;
+
+interface ReactNodeViewContextProps {
+    onDragStart: (event: DragEvent) => void;
+    nodeViewContentRef: (element: HTMLElement | null) => void;
+}
+declare const ReactNodeViewContext: React.Context<Partial<ReactNodeViewContextProps>>;
+declare const useReactNodeView: () => Partial<ReactNodeViewContextProps>;
+
+export { BubbleMenu, type BubbleMenuProps, EditorConsumer, EditorContent, type EditorContentProps, EditorContext, type EditorContextValue, EditorProvider, type EditorProviderProps, type EditorStateSnapshot, FloatingMenu, type FloatingMenuProps, NodeViewContent, type NodeViewContentProps, NodeViewWrapper, type NodeViewWrapperProps, PureEditorContent, ReactNodeView, ReactNodeViewContext, type ReactNodeViewContextProps, ReactNodeViewRenderer, type ReactNodeViewRendererOptions, ReactRenderer, type ReactRendererOptions, type UseEditorOptions, type UseEditorStateOptions, useCurrentEditor, useEditor, useEditorState, useReactNodeView };