@blocknote/core 0.40.0 → 0.41.0

package/types/src/editor/BlockNoteEditor.d.ts

@@ -2,25 +2,24 @@ import { AnyExtension, EditorOptions, FocusPosition, Editor as TiptapEditor } fr
 import { type Command, type Plugin, type Transaction } from "@tiptap/pm/state";
 import { Node, Schema } from "prosemirror-model";
 import * as Y from "yjs";
-import { BlocksChanged } from "../api/getBlocksChangedByTransaction.js";
+import type { BlocksChanged } from "../api/getBlocksChangedByTransaction.js";
+import { Block, BlockNoteSchema, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from "../blocks/index.js";
 import type { ThreadStore, User } from "../comments/index.js";
-import type { ForkYDocPlugin } from "../extensions/Collaboration/ForkYDocPlugin.js";
 import type { CommentsPlugin } from "../extensions/Comments/CommentsPlugin.js";
-import { FilePanelProsemirrorPlugin } from "../extensions/FilePanel/FilePanelPlugin.js";
-import { FormattingToolbarProsemirrorPlugin } from "../extensions/FormattingToolbar/FormattingToolbarPlugin.js";
-import { LinkToolbarProsemirrorPlugin } from "../extensions/LinkToolbar/LinkToolbarPlugin.js";
-import { SideMenuProsemirrorPlugin } from "../extensions/SideMenu/SideMenuPlugin.js";
-import { SuggestionMenuProseMirrorPlugin } from "../extensions/SuggestionMenu/SuggestionPlugin.js";
-import { TableHandlesProsemirrorPlugin } from "../extensions/TableHandles/TableHandlesPlugin.js";
-import { Dictionary } from "../i18n/dictionary.js";
-import { BlockIdentifier, BlockNoteDOMAttributes, BlockSchema, BlockSpecs, CustomBlockNoteSchema, InlineContentSchema, InlineContentSpecs, PartialInlineContent, Styles, StyleSchema, StyleSpecs } from "../schema/index.js";
-import "../style.css";
+import type { FilePanelProsemirrorPlugin } from "../extensions/FilePanel/FilePanelPlugin.js";
+import type { FormattingToolbarProsemirrorPlugin } from "../extensions/FormattingToolbar/FormattingToolbarPlugin.js";
+import type { LinkToolbarProsemirrorPlugin } from "../extensions/LinkToolbar/LinkToolbarPlugin.js";
+import type { ShowSelectionPlugin } from "../extensions/ShowSelection/ShowSelectionPlugin.js";
+import type { SideMenuProsemirrorPlugin } from "../extensions/SideMenu/SideMenuPlugin.js";
+import type { SuggestionMenuProseMirrorPlugin } from "../extensions/SuggestionMenu/SuggestionPlugin.js";
+import type { TableHandlesProsemirrorPlugin } from "../extensions/TableHandles/TableHandlesPlugin.js";
+import type { Dictionary } from "../i18n/dictionary.js";
+import type { BlockIdentifier, BlockNoteDOMAttributes, BlockSchema, BlockSpecs, CustomBlockNoteSchema, InlineContentSchema, InlineContentSpecs, PartialInlineContent, Styles, StyleSchema, StyleSpecs } from "../schema/index.js";
 import { EventEmitter } from "../util/EventEmitter.js";
-import { NoInfer } from "../util/typescript.js";
+import type { NoInfer } from "../util/typescript.js";
 import { BlockNoteExtension } from "./BlockNoteExtension.js";
-import { TextCursorPosition } from "./cursorPositionTypes.js";
-import { Selection } from "./selectionTypes.js";
-import { Block, BlockNoteSchema, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from "../blocks/index.js";
+import type { TextCursorPosition } from "./cursorPositionTypes.js";
+import type { Selection } from "./selectionTypes.js";
 import "../style.css";
 /**
  * A factory function that returns a BlockNoteExtension
@@ -323,22 +322,22 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
     /**
      * The schema of the editor. The schema defines which Blocks, InlineContent, and Styles are available in the editor.
      */
-    readonly schema: CustomBlockNoteSchema<BSchema, ISchema, SSchema>;
+    readonly schema: BlockNoteSchema<BSchema, ISchema, SSchema>;
     readonly blockImplementations: BlockSpecs;
     readonly inlineContentImplementations: InlineContentSpecs;
     readonly styleImplementations: StyleSpecs;
-    readonly formattingToolbar: FormattingToolbarProsemirrorPlugin;
-    readonly linkToolbar: LinkToolbarProsemirrorPlugin<BSchema, ISchema, SSchema>;
-    readonly sideMenu: SideMenuProsemirrorPlugin<BSchema, ISchema, SSchema>;
-    readonly suggestionMenus: SuggestionMenuProseMirrorPlugin<BSchema, ISchema, SSchema>;
-    readonly filePanel?: FilePanelProsemirrorPlugin<ISchema, SSchema>;
-    readonly tableHandles?: TableHandlesProsemirrorPlugin<ISchema, SSchema>;
-    readonly comments?: CommentsPlugin;
-    private readonly showSelectionPlugin;
+    get formattingToolbar(): FormattingToolbarProsemirrorPlugin;
+    get linkToolbar(): LinkToolbarProsemirrorPlugin<BSchema, ISchema, SSchema>;
+    get sideMenu(): SideMenuProsemirrorPlugin<BSchema, ISchema, SSchema>;
+    get suggestionMenus(): SuggestionMenuProseMirrorPlugin<BSchema, ISchema, SSchema>;
+    get filePanel(): FilePanelProsemirrorPlugin<ISchema, SSchema> | undefined;
+    get tableHandles(): TableHandlesProsemirrorPlugin<ISchema, SSchema> | undefined;
+    get comments(): CommentsPlugin | undefined;
+    get showSelectionPlugin(): ShowSelectionPlugin;
     /**
      * The plugin for forking a document, only defined if in collaboration mode
      */
-    readonly forkYDocPlugin?: ForkYDocPlugin;
+    get forkYDocPlugin(): import("../extensions/Collaboration/ForkYDocPlugin.js").ForkYDocPlugin | undefined;
     /**
      * The `uploadFile` method is what the editor uses when files need to be uploaded (for example when selecting an image to upload).
      * This method should set when creating the editor as this is application-specific.
@@ -368,10 +367,14 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
         schema: CustomBlockNoteSchema<infer BSchema, infer ISchema, infer SSchema>;
     } ? BlockNoteEditor<BSchema, ISchema, SSchema> : BlockNoteEditor<DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema>;
     protected constructor(options: Partial<BlockNoteEditorOptions<BSchema, ISchema, SSchema>>);
-    /**
-     * Stores the currently active transaction, which is the accumulated transaction from all {@link dispatch} calls during a {@link transact} calls
-     */
-    private activeTransaction;
+    private readonly _blockManager;
+    private readonly _collaborationManager?;
+    private readonly _eventManager;
+    private readonly _exportManager;
+    private readonly _extensionManager;
+    private readonly _selectionManager;
+    private readonly _stateManager;
+    private readonly _styleManager;
     /**
      * Execute a prosemirror command. This is mostly for backwards compatibility with older code.
      *
@@ -584,7 +587,7 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @param placement Whether the blocks should be inserted just before, just after, or nested inside the
      * `referenceBlock`.
      */
-    insertBlocks(blocksToInsert: PartialBlock<BSchema, ISchema, SSchema>[], referenceBlock: BlockIdentifier, placement?: "before" | "after"): Block<BSchema, ISchema, SSchema>[];
+    insertBlocks(blocksToInsert: PartialBlock<BSchema, ISchema, SSchema>[], referenceBlock: BlockIdentifier, placement?: "before" | "after"): Block<any, any, any>[];
     /**
      * Updates an existing block in the editor. Since updatedBlock is a PartialBlock object, some fields might not be
      * defined. These undefined fields are kept as-is from the existing block. Throws an error if the block to update could
@@ -592,7 +595,7 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @param blockToUpdate The block that should be updated.
      * @param update A partial block which defines how the existing block should be changed.
      */
-    updateBlock(blockToUpdate: BlockIdentifier, update: PartialBlock<BSchema, ISchema, SSchema>): Block<BSchema, ISchema, SSchema>;
+    updateBlock(blockToUpdate: BlockIdentifier, update: PartialBlock<BSchema, ISchema, SSchema>): Block<any, any, any>;
     /**
      * Removes existing blocks from the editor. Throws an error if any of the blocks could not be found.
      * @param blocksToRemove An array of identifiers for existing blocks that should be removed.
@@ -606,8 +609,8 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @param blocksToInsert An array of partial blocks to replace the old ones with.
      */
     replaceBlocks(blocksToRemove: BlockIdentifier[], blocksToInsert: PartialBlock<BSchema, ISchema, SSchema>[]): {
-        insertedBlocks: Block<BSchema, ISchema, SSchema>[];
-        removedBlocks: Block<BSchema, ISchema, SSchema>[];
+        insertedBlocks: Block<any, any, any>[];
+        removedBlocks: Block<any, any, any>[];
     };
     /**
      * Undo the last action.
@@ -726,7 +729,7 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @param markdown The Markdown string to parse blocks from.
      * @returns The blocks parsed from the Markdown string.
      */
-    tryParseMarkdownToBlocks(markdown: string): Promise<Block<BSchema, ISchema, SSchema>[]>;
+    tryParseMarkdownToBlocks(markdown: string): Block<BSchema, ISchema, SSchema>[];
     /**
      * Updates the user info for the current user that's shown to other collaborators.
      */
@@ -734,17 +737,6 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
         name: string;
         color: string;
     }): void;
-    /**
-     * Registers a callback which will be called before any change is applied to the editor, allowing you to cancel the change.
-     */
-    onBeforeChange(
-    /**
-     * If the callback returns `false`, the change will be canceled & not applied to the editor.
-     */
-    callback: (editor: BlockNoteEditor<BSchema, ISchema, SSchema>, context: {
-        getChanges: () => BlocksChanged<BSchema, ISchema, SSchema>;
-        tr: Transaction;
-    }) => boolean | void): () => void;
     /**
      * A callback function that runs whenever the editor's contents change.
      *
@@ -756,20 +748,49 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
          * Returns the blocks that were inserted, updated, or deleted by the change that occurred.
          */
         getChanges(): BlocksChanged<BSchema, ISchema, SSchema>;
-    }) => void): () => void;
+    }) => void): import("./managers/EventManager.js").Unsubscribe;
     /**
      * A callback function that runs whenever the text cursor position or selection changes.
      *
      * @param callback The callback to execute.
      * @returns A function to remove the callback.
      */
-    onSelectionChange(callback: (editor: BlockNoteEditor<BSchema, ISchema, SSchema>) => void, includeSelectionChangedByRemote?: boolean): () => void;
+    onSelectionChange(callback: (editor: BlockNoteEditor<BSchema, ISchema, SSchema>) => void, includeSelectionChangedByRemote?: boolean): import("./managers/EventManager.js").Unsubscribe;
     /**
      * A callback function that runs when the editor has been initialized.
      *
      * This can be useful for plugins to initialize themselves after the editor has been initialized.
+     *
+     * @param callback The callback to execute.
+     * @returns A function to remove the callback.
      */
     onCreate(callback: () => void): () => void;
+    /**
+     * A callback function that runs when the editor has been mounted.
+     *
+     * This can be useful for plugins to initialize themselves after the editor has been mounted.
+     *
+     * @param callback The callback to execute.
+     * @returns A function to remove the callback.
+     */
+    onMount(callback: (ctx: {
+        editor: BlockNoteEditor<BSchema, ISchema, SSchema>;
+    }) => void): void;
+    /**
+     * A callback function that runs when the editor has been unmounted.
+     *
+     * This can be useful for plugins to clean up themselves after the editor has been unmounted.
+     *
+     * @param callback The callback to execute.
+     * @returns A function to remove the callback.
+     */
+    onUnmount(callback: (ctx: {
+        editor: BlockNoteEditor<BSchema, ISchema, SSchema>;
+    }) => void): void;
+    /**
+     * Gets the bounding box of the current selection.
+     * @returns The bounding box of the current selection.
+     */
     getSelectionBoundingBox(): DOMRect | undefined;
     get isEmpty(): boolean;
     openSuggestionMenu(triggerCharacter: string, pluginState?: {

package/types/src/editor/BlockNoteExtensions.d.ts

@@ -1,6 +1,6 @@
 import { Plugin } from "prosemirror-state";
 import * as Y from "yjs";
-import type { ThreadStore } from "../comments/index.js";
+import type { ThreadStore, User } from "../comments/index.js";
 import { BlockNoteDOMAttributes, BlockSchema, BlockSpecs, InlineContentSchema, InlineContentSpecs, StyleSchema, StyleSpecs } from "../schema/index.js";
 import type { BlockNoteEditor, BlockNoteEditorOptions, SupportedExtension } from "./BlockNoteEditor.js";
 import { BlockNoteSchema } from "../blocks/BlockNoteSchema.js";
@@ -32,6 +32,7 @@ type ExtensionOptions<BSchema extends BlockSchema, I extends InlineContentSchema
     comments?: {
         schema?: BlockNoteSchema<any, any, any>;
         threadStore: ThreadStore;
+        resolveUsers?: (userIds: string[]) => Promise<User[]>;
     };
     pasteHandler: BlockNoteEditorOptions<any, any, any>["pasteHandler"];
 };

package/types/src/editor/managers/BlockManager.d.ts

@@ -0,0 +1,114 @@
+import { Block, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from "../../blocks/defaultBlocks.js";
+import { BlockIdentifier, BlockSchema, InlineContentSchema, StyleSchema } from "../../schema/index.js";
+import { BlockNoteEditor } from "../BlockNoteEditor.js";
+export declare class BlockManager<BSchema extends BlockSchema = DefaultBlockSchema, ISchema extends InlineContentSchema = DefaultInlineContentSchema, SSchema extends StyleSchema = DefaultStyleSchema> {
+    private editor;
+    constructor(editor: BlockNoteEditor<BSchema, ISchema, SSchema>);
+    /**
+     * Gets a snapshot of all top-level (non-nested) blocks in the editor.
+     * @returns A snapshot of all top-level (non-nested) blocks in the editor.
+     */
+    get document(): Block<BSchema, ISchema, SSchema>[];
+    /**
+     * Gets a snapshot of an existing block from the editor.
+     * @param blockIdentifier The identifier of an existing block that should be
+     * retrieved.
+     * @returns The block that matches the identifier, or `undefined` if no
+     * matching block was found.
+     */
+    getBlock(blockIdentifier: BlockIdentifier): Block<BSchema, ISchema, SSchema> | undefined;
+    /**
+     * Gets a snapshot of the previous sibling of an existing block from the
+     * editor.
+     * @param blockIdentifier The identifier of an existing block for which the
+     * previous sibling should be retrieved.
+     * @returns The previous sibling of the block that matches the identifier.
+     * `undefined` if no matching block was found, or it's the first child/block
+     * in the document.
+     */
+    getPrevBlock(blockIdentifier: BlockIdentifier): Block<BSchema, ISchema, SSchema> | undefined;
+    /**
+     * Gets a snapshot of the next sibling of an existing block from the editor.
+     * @param blockIdentifier The identifier of an existing block for which the
+     * next sibling should be retrieved.
+     * @returns The next sibling of the block that matches the identifier.
+     * `undefined` if no matching block was found, or it's the last child/block in
+     * the document.
+     */
+    getNextBlock(blockIdentifier: BlockIdentifier): Block<BSchema, ISchema, SSchema> | undefined;
+    /**
+     * Gets a snapshot of the parent of an existing block from the editor.
+     * @param blockIdentifier The identifier of an existing block for which the
+     * parent should be retrieved.
+     * @returns The parent of the block that matches the identifier. `undefined`
+     * if no matching block was found, or the block isn't nested.
+     */
+    getParentBlock(blockIdentifier: BlockIdentifier): Block<BSchema, ISchema, SSchema> | undefined;
+    /**
+     * Traverses all blocks in the editor depth-first, and executes a callback for each.
+     * @param callback The callback to execute for each block. Returning `false` stops the traversal.
+     * @param reverse Whether the blocks should be traversed in reverse order.
+     */
+    forEachBlock(callback: (block: Block<BSchema, ISchema, SSchema>) => boolean, reverse?: boolean): void;
+    /**
+     * Inserts new blocks into the editor. If a block's `id` is undefined, BlockNote generates one automatically. Throws an
+     * error if the reference block could not be found.
+     * @param blocksToInsert An array of partial blocks that should be inserted.
+     * @param referenceBlock An identifier for an existing block, at which the new blocks should be inserted.
+     * @param placement Whether the blocks should be inserted just before, just after, or nested inside the
+     * `referenceBlock`.
+     */
+    insertBlocks(blocksToInsert: PartialBlock<BSchema, ISchema, SSchema>[], referenceBlock: BlockIdentifier, placement?: "before" | "after"): Block<BSchema, ISchema, SSchema>[];
+    /**
+     * Updates an existing block in the editor. Since updatedBlock is a PartialBlock object, some fields might not be
+     * defined. These undefined fields are kept as-is from the existing block. Throws an error if the block to update could
+     * not be found.
+     * @param blockToUpdate The block that should be updated.
+     * @param update A partial block which defines how the existing block should be changed.
+     */
+    updateBlock(blockToUpdate: BlockIdentifier, update: PartialBlock<BSchema, ISchema, SSchema>): Block<BSchema, ISchema, SSchema>;
+    /**
+     * Removes existing blocks from the editor. Throws an error if any of the blocks could not be found.
+     * @param blocksToRemove An array of identifiers for existing blocks that should be removed.
+     */
+    removeBlocks(blocksToRemove: BlockIdentifier[]): Block<Record<string, import("../../index.js").BlockConfig<string, import("../../index.js").PropSchema, "inline" | "none" | "table">>, InlineContentSchema, StyleSchema>[];
+    /**
+     * Replaces existing blocks in the editor with new blocks. If the blocks that should be removed are not adjacent or
+     * are at different nesting levels, `blocksToInsert` will be inserted at the position of the first block in
+     * `blocksToRemove`. Throws an error if any of the blocks to remove could not be found.
+     * @param blocksToRemove An array of blocks that should be replaced.
+     * @param blocksToInsert An array of partial blocks to replace the old ones with.
+     */
+    replaceBlocks(blocksToRemove: BlockIdentifier[], blocksToInsert: PartialBlock<BSchema, ISchema, SSchema>[]): {
+        insertedBlocks: Block<BSchema, ISchema, SSchema>[];
+        removedBlocks: Block<BSchema, ISchema, SSchema>[];
+    };
+    /**
+     * Checks if the block containing the text cursor can be nested.
+     */
+    canNestBlock(): boolean;
+    /**
+     * Nests the block containing the text cursor into the block above it.
+     */
+    nestBlock(): void;
+    /**
+     * Checks if the block containing the text cursor is nested.
+     */
+    canUnnestBlock(): boolean;
+    /**
+     * Lifts the block containing the text cursor out of its parent.
+     */
+    unnestBlock(): void;
+    /**
+     * Moves the selected blocks up. If the previous block has children, moves
+     * them to the end of its children. If there is no previous block, but the
+     * current blocks share a common parent, moves them out of & before it.
+     */
+    moveBlocksUp(): void;
+    /**
+     * Moves the selected blocks down. If the next block has children, moves
+     * them to the start of its children. If there is no next block, but the
+     * current blocks share a common parent, moves them out of & after it.
+     */
+    moveBlocksDown(): void;
+}

package/types/src/editor/managers/CollaborationManager.d.ts

@@ -0,0 +1,115 @@
+import * as Y from "yjs";
+import { CommentsPlugin } from "../../extensions/Comments/CommentsPlugin.js";
+import { ForkYDocPlugin } from "../../extensions/Collaboration/ForkYDocPlugin.js";
+import { SyncPlugin } from "../../extensions/Collaboration/SyncPlugin.js";
+import { UndoPlugin } from "../../extensions/Collaboration/UndoPlugin.js";
+import { CursorPlugin } from "../../extensions/Collaboration/CursorPlugin.js";
+import type { ThreadStore, User } from "../../comments/index.js";
+import type { BlockNoteEditor } from "../BlockNoteEditor.js";
+import { CustomBlockNoteSchema } from "../../schema/schema.js";
+export interface CollaborationOptions {
+    /**
+     * The Yjs XML fragment that's used for collaboration.
+     */
+    fragment: Y.XmlFragment;
+    /**
+     * The user info for the current user that's shown to other collaborators.
+     */
+    user: {
+        name: string;
+        color: string;
+    };
+    /**
+     * A Yjs provider (used for awareness / cursor information)
+     * Can be null for comments-only mode
+     */
+    provider: any;
+    /**
+     * Optional function to customize how cursors of users are rendered
+     */
+    renderCursor?: (user: any) => HTMLElement;
+    /**
+     * Optional flag to set when the user label should be shown with the default
+     * collaboration cursor. Setting to "always" will always show the label,
+     * while "activity" will only show the label when the user moves the cursor
+     * or types. Defaults to "activity".
+     */
+    showCursorLabels?: "always" | "activity";
+    /**
+     * Comments configuration - can be used with or without collaboration
+     */
+    comments?: {
+        schema?: CustomBlockNoteSchema<any, any, any>;
+        threadStore: ThreadStore;
+    };
+    /**
+     * Function to resolve user IDs to user objects - required for comments
+     */
+    resolveUsers?: (userIds: string[]) => Promise<User[]>;
+}
+/**
+ * CollaborationManager handles all collaboration-related functionality
+ * This manager is completely optional and can be tree-shaken if not used
+ */
+export declare class CollaborationManager {
+    private editor;
+    private options;
+    private _commentsPlugin?;
+    private _forkYDocPlugin?;
+    private _syncPlugin?;
+    private _undoPlugin?;
+    private _cursorPlugin?;
+    constructor(editor: BlockNoteEditor, options: CollaborationOptions);
+    /**
+     * Get the sync plugin instance
+     */
+    get syncPlugin(): SyncPlugin | undefined;
+    /**
+     * Get the undo plugin instance
+     */
+    get undoPlugin(): UndoPlugin | undefined;
+    /**
+     * Get the cursor plugin instance
+     */
+    get cursorPlugin(): CursorPlugin | undefined;
+    /**
+     * Get the fork YDoc plugin instance
+     */
+    get forkYDocPlugin(): ForkYDocPlugin | undefined;
+    initExtensions(): Record<string, unknown>;
+    /**
+     * Update the user info for the current user that's shown to other collaborators
+     */
+    updateUserInfo(user: {
+        name: string;
+        color: string;
+    }): void;
+    /**
+     * Get the collaboration undo command
+     */
+    getUndoCommand(): import("prosemirror-state").Command;
+    /**
+     * Get the collaboration redo command
+     */
+    getRedoCommand(): import("prosemirror-state").Command;
+    /**
+     * Check if initial content should be avoided due to collaboration
+     */
+    shouldAvoidInitialContent(): boolean;
+    /**
+     * Get the collaboration options
+     */
+    getOptions(): CollaborationOptions;
+    /**
+     * Get the comments plugin if available
+     */
+    get comments(): CommentsPlugin | undefined;
+    /**
+     * Check if comments are enabled
+     */
+    get hasComments(): boolean;
+    /**
+     * Get the resolveUsers function
+     */
+    get resolveUsers(): ((userIds: string[]) => Promise<User[]>) | undefined;
+}

package/types/src/editor/managers/EventManager.d.ts

@@ -0,0 +1,58 @@
+import type { BlockNoteEditor } from "../BlockNoteEditor.js";
+import { type BlocksChanged } from "../../api/getBlocksChangedByTransaction.js";
+import { Transaction } from "prosemirror-state";
+import { EventEmitter } from "../../util/EventEmitter.js";
+/**
+ * A function that can be used to unsubscribe from an event.
+ */
+export type Unsubscribe = () => void;
+/**
+ * EventManager is a class which manages the events of the editor
+ */
+export declare class EventManager<Editor extends BlockNoteEditor> extends EventEmitter<{
+    onChange: [
+        editor: Editor,
+        ctx: {
+            getChanges(): BlocksChanged<Editor["schema"]["blockSchema"], Editor["schema"]["inlineContentSchema"], Editor["schema"]["styleSchema"]>;
+        }
+    ];
+    onSelectionChange: [ctx: {
+        editor: Editor;
+        transaction: Transaction;
+    }];
+    onMount: [ctx: {
+        editor: Editor;
+    }];
+    onUnmount: [ctx: {
+        editor: Editor;
+    }];
+}> {
+    private editor;
+    constructor(editor: Editor);
+    /**
+     * Register a callback that will be called when the editor changes.
+     */
+    onChange(callback: (editor: Editor, ctx: {
+        getChanges(): BlocksChanged<Editor["schema"]["blockSchema"], Editor["schema"]["inlineContentSchema"], Editor["schema"]["styleSchema"]>;
+    }) => void): Unsubscribe;
+    /**
+     * Register a callback that will be called when the selection changes.
+     */
+    onSelectionChange(callback: (editor: Editor) => void, 
+    /**
+     * If true, the callback will be triggered when the selection changes due to a yjs sync (i.e.: other user was typing)
+     */
+    includeSelectionChangedByRemote?: boolean): Unsubscribe;
+    /**
+     * Register a callback that will be called when the editor is mounted.
+     */
+    onMount(callback: (ctx: {
+        editor: Editor;
+    }) => void): Unsubscribe;
+    /**
+     * Register a callback that will be called when the editor is unmounted.
+     */
+    onUnmount(callback: (ctx: {
+        editor: Editor;
+    }) => void): Unsubscribe;
+}

package/types/src/editor/managers/ExportManager.d.ts

@@ -0,0 +1,64 @@
+import { Block, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from "../../blocks/defaultBlocks.js";
+import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema/index.js";
+import { BlockNoteEditor } from "../BlockNoteEditor.js";
+export declare class ExportManager<BSchema extends BlockSchema = DefaultBlockSchema, ISchema extends InlineContentSchema = DefaultInlineContentSchema, SSchema extends StyleSchema = DefaultStyleSchema> {
+    private editor;
+    constructor(editor: BlockNoteEditor<BSchema, ISchema, SSchema>);
+    /**
+     * Exports blocks into a simplified HTML string. To better conform to HTML standards, children of blocks which aren't list
+     * items are un-nested in the output HTML.
+     *
+     * @param blocks An array of blocks that should be serialized into HTML.
+     * @returns The blocks, serialized as an HTML string.
+     */
+    blocksToHTMLLossy(blocks?: PartialBlock<BSchema, ISchema, SSchema>[]): string;
+    /**
+     * Serializes blocks into an HTML string in the format that would normally be rendered by the editor.
+     *
+     * Use this method if you want to server-side render HTML (for example, a blog post that has been edited in BlockNote)
+     * and serve it to users without loading the editor on the client (i.e.: displaying the blog post)
+     *
+     * @param blocks An array of blocks that should be serialized into HTML.
+     * @returns The blocks, serialized as an HTML string.
+     */
+    blocksToFullHTML(blocks: PartialBlock<BSchema, ISchema, SSchema>[]): string;
+    /**
+     * Parses blocks from an HTML string. Tries to create `Block` objects out of any HTML block-level elements, and
+     * `InlineNode` objects from any HTML inline elements, though not all element types are recognized. If BlockNote
+     * doesn't recognize an HTML element's tag, it will parse it as a paragraph or plain text.
+     * @param html The HTML string to parse blocks from.
+     * @returns The blocks parsed from the HTML string.
+     */
+    tryParseHTMLToBlocks(html: string): Block<BSchema, ISchema, SSchema>[];
+    /**
+     * Serializes blocks into a Markdown string. The output is simplified as Markdown does not support all features of
+     * BlockNote - children of blocks which aren't list items are un-nested and certain styles are removed.
+     * @param blocks An array of blocks that should be serialized into Markdown.
+     * @returns The blocks, serialized as a Markdown string.
+     */
+    blocksToMarkdownLossy(blocks?: PartialBlock<BSchema, ISchema, SSchema>[]): string;
+    /**
+     * Creates a list of blocks from a Markdown string. Tries to create `Block` and `InlineNode` objects based on
+     * Markdown syntax, though not all symbols are recognized. If BlockNote doesn't recognize a symbol, it will parse it
+     * as text.
+     * @param markdown The Markdown string to parse blocks from.
+     * @returns The blocks parsed from the Markdown string.
+     */
+    tryParseMarkdownToBlocks(markdown: string): Block<BSchema, ISchema, SSchema>[];
+    /**
+     * Paste HTML into the editor. Defaults to converting HTML to BlockNote HTML.
+     * @param html The HTML to paste.
+     * @param raw Whether to paste the HTML as is, or to convert it to BlockNote HTML.
+     */
+    pasteHTML(html: string, raw?: boolean): void;
+    /**
+     * Paste text into the editor. Defaults to interpreting text as markdown.
+     * @param text The text to paste.
+     */
+    pasteText(text: string): boolean;
+    /**
+     * Paste markdown into the editor.
+     * @param markdown The markdown to paste.
+     */
+    pasteMarkdown(markdown: string): void;
+}

package/types/src/editor/managers/ExtensionManager.d.ts

@@ -0,0 +1,68 @@
+import { FilePanelProsemirrorPlugin } from "../../extensions/FilePanel/FilePanelPlugin.js";
+import { FormattingToolbarProsemirrorPlugin } from "../../extensions/FormattingToolbar/FormattingToolbarPlugin.js";
+import { LinkToolbarProsemirrorPlugin } from "../../extensions/LinkToolbar/LinkToolbarPlugin.js";
+import { ShowSelectionPlugin } from "../../extensions/ShowSelection/ShowSelectionPlugin.js";
+import { SideMenuProsemirrorPlugin } from "../../extensions/SideMenu/SideMenuPlugin.js";
+import { SuggestionMenuProseMirrorPlugin } from "../../extensions/SuggestionMenu/SuggestionPlugin.js";
+import { TableHandlesProsemirrorPlugin } from "../../extensions/TableHandles/TableHandlesPlugin.js";
+import { BlockNoteExtension } from "../BlockNoteExtension.js";
+import { BlockNoteEditor } from "../BlockNoteEditor.js";
+export declare class ExtensionManager {
+    private editor;
+    constructor(editor: BlockNoteEditor);
+    /**
+     * Shorthand to get a typed extension from the editor, by
+     * just passing in the extension class.
+     *
+     * @param ext - The extension class to get
+     * @param key - optional, the key of the extension in the extensions object (defaults to the extension name)
+     * @returns The extension instance
+     */
+    extension<T extends BlockNoteExtension>(ext: {
+        new (...args: any[]): T;
+    } & typeof BlockNoteExtension, key?: string): T;
+    /**
+     * Get all extensions
+     */
+    getExtensions(): Record<string, import("../BlockNoteEditor.js").SupportedExtension>;
+    /**
+     * Get a specific extension by key
+     */
+    getExtension(key: string): import("../BlockNoteEditor.js").SupportedExtension;
+    /**
+     * Check if an extension exists
+     */
+    hasExtension(key: string): boolean;
+    /**
+     * Get the formatting toolbar plugin
+     */
+    get formattingToolbar(): FormattingToolbarProsemirrorPlugin;
+    /**
+     * Get the link toolbar plugin
+     */
+    get linkToolbar(): LinkToolbarProsemirrorPlugin<any, any, any>;
+    /**
+     * Get the side menu plugin
+     */
+    get sideMenu(): SideMenuProsemirrorPlugin<any, any, any>;
+    /**
+     * Get the suggestion menus plugin
+     */
+    get suggestionMenus(): SuggestionMenuProseMirrorPlugin<any, any, any>;
+    /**
+     * Get the file panel plugin (if available)
+     */
+    get filePanel(): FilePanelProsemirrorPlugin<any, any> | undefined;
+    /**
+     * Get the table handles plugin (if available)
+     */
+    get tableHandles(): TableHandlesProsemirrorPlugin<any, any> | undefined;
+    /**
+     * Get the show selection plugin
+     */
+    get showSelectionPlugin(): ShowSelectionPlugin;
+    /**
+     * Check if collaboration is enabled (Yjs or Liveblocks)
+     */
+    get isCollaborationEnabled(): boolean;
+}