@blocknote/core 0.14.5 → 0.15.2

package/src/index.ts

@@ -2,13 +2,14 @@ import * as locales from "./i18n/locales";
 export * from "./api/exporters/html/externalHTMLExporter";
 export * from "./api/exporters/html/internalHTMLSerializer";
 export * from "./api/testUtil";
+export * from "./blocks/AudioBlockContent/AudioBlockContent";
 export * from "./blocks/FileBlockContent/FileBlockContent";
 export * from "./blocks/ImageBlockContent/ImageBlockContent";
 export * from "./blocks/VideoBlockContent/VideoBlockContent";
-export * from "./blocks/AudioBlockContent/AudioBlockContent";
 
 export * from "./blocks/FileBlockContent/fileBlockHelpers";
 export * from "./blocks/FileBlockContent/uploadToTmpFilesDotOrg_DEV_ONLY";
+export { parseImageElement } from "./blocks/ImageBlockContent/imageBlockHelpers";
 export * from "./blocks/defaultBlockTypeGuards";
 export * from "./blocks/defaultBlocks";
 export * from "./blocks/defaultProps";
@@ -22,17 +23,25 @@ export * from "./extensions/FormattingToolbar/FormattingToolbarPlugin";
 export * from "./extensions/LinkToolbar/LinkToolbarPlugin";
 export * from "./extensions/SideMenu/SideMenuPlugin";
 export * from "./extensions/SuggestionMenu/DefaultSuggestionItem";
+export * from "./extensions/SuggestionMenu/DefaultGridSuggestionItem";
 export * from "./extensions/SuggestionMenu/SuggestionPlugin";
 export * from "./extensions/SuggestionMenu/getDefaultSlashMenuItems";
+export * from "./extensions/SuggestionMenu/getDefaultEmojiPickerItems";
 export * from "./extensions/TableHandles/TableHandlesPlugin";
+export * from "./i18n/dictionary";
 export * from "./schema";
 export * from "./util/browser";
 export * from "./util/string";
+export * from "./util/typescript";
+export { UnreachableCaseError, assertEmpty } from "./util/typescript";
+export { locales };
+
 // for testing from react (TODO: move):
 export * from "./api/nodeConversions/nodeConversions";
 export * from "./api/testUtil/partialBlockTestUtil";
 export * from "./extensions/UniqueID/UniqueID";
-export * from "./i18n/dictionary";
-export { UnreachableCaseError, assertEmpty } from "./util/typescript";
-export { locales };
-export { parseImageElement } from "./blocks/ImageBlockContent/imageBlockHelpers";
+
+// for server-util (TODO: maybe move):
+export * from "./api/exporters/markdown/markdownExporter";
+export * from "./api/parsers/html/parseHTML";
+export * from "./api/parsers/markdown/parseMarkdown";

package/src/style.css

@@ -1,7 +1,2 @@
-/*
-This is an empty placeholder file, which should NOT contain CSS code.
-It's here so DEV environment doesn't show a 404
-
-- In DEV environment, examples/editor loads this stub file, but actual CSS is loaded from CSS modules directly
-- In PROD environment, the actual dist/style.css file is built from the CSS modules
-*/
+@import url("./editor/Block.css");
+@import url("./editor/editor.css");

package/types/src/api/blockManipulation/blockManipulation.d.ts

@@ -2,7 +2,7 @@ import { Node } from "prosemirror-model";
 import { Block, PartialBlock } from "../../blocks/defaultBlocks";
 import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
 import { BlockIdentifier, BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
-export declare function insertBlocks<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blocksToInsert: PartialBlock<BSchema, I, S>[], referenceBlock: BlockIdentifier, placement: "before" | "after" | "nested" | undefined, editor: BlockNoteEditor<BSchema, I, S>): Block<BSchema, I, S>[];
+export declare function insertBlocks<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blocksToInsert: PartialBlock<BSchema, I, S>[], referenceBlock: BlockIdentifier, placement: ("before" | "after" | "nested") | undefined, editor: BlockNoteEditor<BSchema, I, S>): Block<BSchema, I, S>[];
 export declare function updateBlock<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blockToUpdate: BlockIdentifier, update: PartialBlock<BSchema, I, S>, editor: BlockNoteEditor<BSchema, I, S>): Block<BSchema, I, S>;
 export declare function removeBlocks<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blocksToRemove: BlockIdentifier[], editor: BlockNoteEditor<BSchema, I, S>): Block<BSchema, I, S>[];
 export declare function replaceBlocks<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blocksToRemove: BlockIdentifier[], blocksToInsert: PartialBlock<BSchema, I, S>[], editor: BlockNoteEditor<BSchema, I, S>): {

package/types/src/api/exporters/copyExtension.d.ts

@@ -1,6 +1,6 @@
 import { Extension } from "@tiptap/core";
 import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
-import { InlineContentSchema, StyleSchema } from "../../schema";
-export declare const createCopyToClipboardExtension: <BSchema extends Record<string, import("../../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>) => Extension<{
+import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
+export declare const createCopyToClipboardExtension: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>) => Extension<{
     editor: BlockNoteEditor<BSchema, I, S>;
 }, undefined>;

package/types/src/api/exporters/html/externalHTMLExporter.d.ts

@@ -3,7 +3,11 @@ import { PartialBlock } from "../../../blocks/defaultBlocks";
 import type { BlockNoteEditor } from "../../../editor/BlockNoteEditor";
 import { BlockSchema, InlineContentSchema, StyleSchema } from "../../../schema";
 export interface ExternalHTMLExporter<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema> {
-    exportBlocks: (blocks: PartialBlock<BSchema, I, S>[]) => string;
-    exportProseMirrorFragment: (fragment: Fragment) => string;
+    exportBlocks: (blocks: PartialBlock<BSchema, I, S>[], options: {
+        document?: Document;
+    }) => string;
+    exportProseMirrorFragment: (fragment: Fragment, options: {
+        document?: Document;
+    }) => string;
 }
-export declare const createExternalHTMLExporter: <BSchema extends Record<string, import("../../../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(schema: Schema, editor: BlockNoteEditor<BSchema, I, S>) => ExternalHTMLExporter<BSchema, I, S>;
+export declare const createExternalHTMLExporter: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(schema: Schema, editor: BlockNoteEditor<BSchema, I, S>) => ExternalHTMLExporter<BSchema, I, S>;

package/types/src/api/exporters/html/internalHTMLSerializer.d.ts

@@ -3,7 +3,11 @@ import { PartialBlock } from "../../../blocks/defaultBlocks";
 import type { BlockNoteEditor } from "../../../editor/BlockNoteEditor";
 import { BlockSchema, InlineContentSchema, StyleSchema } from "../../../schema";
 export interface InternalHTMLSerializer<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema> {
-    serializeProseMirrorFragment: (fragment: Fragment) => string;
-    serializeBlocks: (blocks: PartialBlock<BSchema, I, S>[]) => string;
+    serializeProseMirrorFragment: (fragment: Fragment, options: {
+        document?: Document;
+    }) => string;
+    serializeBlocks: (blocks: PartialBlock<BSchema, I, S>[], options: {
+        document?: Document;
+    }) => string;
 }
-export declare const createInternalHTMLSerializer: <BSchema extends Record<string, import("../../../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(schema: Schema, editor: BlockNoteEditor<BSchema, I, S>) => InternalHTMLSerializer<BSchema, I, S>;
+export declare const createInternalHTMLSerializer: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(schema: Schema, editor: BlockNoteEditor<BSchema, I, S>) => InternalHTMLSerializer<BSchema, I, S>;

package/types/src/api/exporters/html/util/sharedHTMLConversion.d.ts

@@ -1,7 +1,9 @@
 import { DOMSerializer, Fragment, Node } from "prosemirror-model";
 import type { BlockNoteEditor } from "../../../../editor/BlockNoteEditor";
-import { InlineContentSchema, StyleSchema } from "../../../../schema";
-export declare const serializeNodeInner: <BSchema extends Record<string, import("../../../../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(node: Node, options: {
+import { BlockSchema, InlineContentSchema, StyleSchema } from "../../../../schema";
+export declare const serializeNodeInner: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(node: Node, options: {
     document?: Document;
 }, serializer: DOMSerializer, editor: BlockNoteEditor<BSchema, I, S>, toExternalHTML: boolean) => HTMLElement;
-export declare const serializeProseMirrorFragment: (fragment: Fragment, serializer: DOMSerializer) => string;
+export declare const serializeProseMirrorFragment: (fragment: Fragment, serializer: DOMSerializer, options?: {
+    document?: Document;
+}) => string;

package/types/src/api/exporters/markdown/markdownExporter.d.ts

@@ -1,6 +1,8 @@
 import { Schema } from "prosemirror-model";
-import { Block } from "../../../blocks/defaultBlocks";
+import { PartialBlock } from "../../../blocks/defaultBlocks";
 import type { BlockNoteEditor } from "../../../editor/BlockNoteEditor";
 import { BlockSchema, InlineContentSchema, StyleSchema } from "../../../schema";
 export declare function cleanHTMLToMarkdown(cleanHTMLString: string): string;
-export declare function blocksToMarkdown<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blocks: Block<BSchema, I, S>[], schema: Schema, editor: BlockNoteEditor<BSchema, I, S>): string;
+export declare function blocksToMarkdown<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blocks: PartialBlock<BSchema, I, S>[], schema: Schema, editor: BlockNoteEditor<BSchema, I, S>, options: {
+    document?: Document;
+}): string;

package/types/src/api/parsers/fileDropExtension.d.ts

@@ -1,6 +1,6 @@
 import { Extension } from "@tiptap/core";
 import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
-import { InlineContentSchema, StyleSchema } from "../../schema";
-export declare const createDropFileExtension: <BSchema extends Record<string, import("../../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>) => Extension<{
+import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
+export declare const createDropFileExtension: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>) => Extension<{
     editor: BlockNoteEditor<BSchema, I, S>;
 }, undefined>;

package/types/src/api/parsers/pasteExtension.d.ts

@@ -1,6 +1,6 @@
 import { Extension } from "@tiptap/core";
 import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
-import { InlineContentSchema, StyleSchema } from "../../schema";
-export declare const createPasteFromClipboardExtension: <BSchema extends Record<string, import("../../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>) => Extension<{
+import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
+export declare const createPasteFromClipboardExtension: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>) => Extension<{
     editor: BlockNoteEditor<BSchema, I, S>;
 }, undefined>;

package/types/src/blocks/defaultBlockHelpers.d.ts

@@ -1,10 +1,10 @@
 import type { BlockNoteEditor } from "../editor/BlockNoteEditor";
-import type { BlockNoDefaults, InlineContentSchema, StyleSchema } from "../schema";
+import type { BlockNoDefaults, BlockSchema, InlineContentSchema, StyleSchema } from "../schema";
 export declare function createDefaultBlockDOMOutputSpec(blockName: string, htmlTag: string, blockContentHTMLAttributes: Record<string, string>, inlineContentHTMLAttributes: Record<string, string>): {
     dom: HTMLDivElement;
     contentDOM: HTMLElement;
 };
-export declare const defaultBlockToHTML: <BSchema extends Record<string, import("../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(block: BlockNoDefaults<BSchema, I, S>, editor: BlockNoteEditor<BSchema, I, S>) => {
+export declare const defaultBlockToHTML: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(block: BlockNoDefaults<BSchema, I, S>, editor: BlockNoteEditor<BSchema, I, S>) => {
     dom: HTMLElement;
     contentDOM?: HTMLElement;
 };

package/types/src/blocks/defaultBlockTypeGuards.d.ts

@@ -1,10 +1,13 @@
 import type { BlockNoteEditor } from "../editor/BlockNoteEditor";
 import { BlockFromConfig, BlockSchema, FileBlockConfig, InlineContentSchema, StyleSchema } from "../schema";
-import { Block, DefaultBlockSchema } from "./defaultBlocks";
+import { Block, DefaultBlockSchema, DefaultInlineContentSchema } from "./defaultBlocks";
 import { defaultProps } from "./defaultProps";
 export declare function checkDefaultBlockTypeInSchema<BlockType extends keyof DefaultBlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blockType: BlockType, editor: BlockNoteEditor<any, I, S>): editor is BlockNoteEditor<{
     Type: DefaultBlockSchema[BlockType];
 }, I, S>;
+export declare function checkDefaultInlineContentTypeInSchema<InlineContentType extends keyof DefaultInlineContentSchema, B extends BlockSchema, S extends StyleSchema>(inlineContentType: InlineContentType, editor: BlockNoteEditor<B, any, S>): editor is BlockNoteEditor<B, {
+    Type: DefaultInlineContentSchema[InlineContentType];
+}, S>;
 export declare function checkBlockIsDefaultType<BlockType extends keyof DefaultBlockSchema, I extends InlineContentSchema, S extends StyleSchema>(blockType: BlockType, block: Block<any, I, S>, editor: BlockNoteEditor<any, I, S>): block is BlockFromConfig<DefaultBlockSchema[BlockType], I, S>;
 export declare function checkBlockIsFileBlock<B extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(block: Block<any, I, S>, editor: BlockNoteEditor<B, I, S>): block is BlockFromConfig<FileBlockConfig, I, S>;
 export declare function checkBlockIsFileBlockWithPreview<B extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(block: Block<any, I, S>, editor: BlockNoteEditor<B, I, S>): block is BlockFromConfig<FileBlockConfig & {

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

@@ -1,5 +1,5 @@
 import { EditorOptions } from "@tiptap/core";
-import { Node } from "prosemirror-model";
+import { Node, Schema } from "prosemirror-model";
 import * as Y from "yjs";
 import { Block, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from "../blocks/defaultBlocks";
 import { FilePanelProsemirrorPlugin } from "../extensions/FilePanel/FilePanelPlugin";
@@ -15,8 +15,8 @@ import { Selection } from "./selectionTypes";
 import { BlockNoteSchema } from "./BlockNoteSchema";
 import { BlockNoteTipTapEditor } from "./BlockNoteTipTapEditor";
 import { Dictionary } from "../i18n/dictionary";
-import "./Block.css";
-import "./editor.css";
+import { Transaction } from "@tiptap/pm/state";
+import "../style.css";
 export type BlockNoteEditorOptions<BSchema extends BlockSchema, ISchema extends InlineContentSchema, SSchema extends StyleSchema> = {
     disableExtensions: string[];
     /**
@@ -45,7 +45,11 @@ export type BlockNoteEditorOptions<BSchema extends BlockSchema, ISchema extends
     defaultStyles: boolean;
     schema: BlockNoteSchema<BSchema, ISchema, SSchema>;
     /**
-     * A custom function to handle file uploads.
+     * 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.
+     *
+     * `undefined` means the application doesn't support file uploads.
+     *
      * @param file The file that should be uploaded.
      * @returns The URL of the uploaded file OR an object containing props that should be set on the file block (such as an id)
      */
@@ -82,14 +86,47 @@ export type BlockNoteEditorOptions<BSchema extends BlockSchema, ISchema extends
     };
     _tiptapOptions: Partial<EditorOptions>;
     trailingBlock?: boolean;
+    /**
+     * Boolean indicating whether the editor is in headless mode.
+     * Headless mode means we can use features like importing / exporting blocks,
+     * but there's no underlying editor (UI) instantiated.
+     *
+     * You probably don't need to set this manually, but use the `server-util` package instead that uses this option internally
+     */
+    _headless: boolean;
 };
 export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockSchema, ISchema extends InlineContentSchema = DefaultInlineContentSchema, SSchema extends StyleSchema = DefaultStyleSchema> {
     private readonly options;
+    private readonly _pmSchema;
+    /**
+     * Boolean indicating whether the editor is in headless mode.
+     * Headless mode means we can use features like importing / exporting blocks,
+     * but there's no underlying editor (UI) instantiated.
+     *
+     * You probably don't need to set this manually, but use the `server-util` package instead that uses this option internally
+     */
+    readonly headless: boolean;
     readonly _tiptapEditor: BlockNoteTipTapEditor & {
         contentComponent: any;
     };
+    /**
+     * Used by React to store a reference to an `ElementRenderer` helper utility to make sure we can render React elements
+     * in the correct context (used by `ReactRenderUtil`)
+     */
+    elementRenderer: ((node: any, container: HTMLElement) => void) | null;
+    /**
+     * Cache of all blocks. This makes sure we don't have to "recompute" blocks if underlying Prosemirror Nodes haven't changed.
+     * This is especially useful when we want to keep track of the same block across multiple operations,
+     * with this cache, blocks stay the same object reference (referential equality with ===).
+     */
     blockCache: WeakMap<Node, Block<any, any, any>>;
+    /**
+     * The dictionary contains translations for the editor.
+     */
     readonly dictionary: Dictionary;
+    /**
+     * The schema of the editor. The schema defines which Blocks, InlineContent, and Styles are available in the editor.
+     */
     readonly schema: BlockNoteSchema<BSchema, ISchema, SSchema>;
     readonly blockImplementations: BlockSpecs;
     readonly inlineContentImplementations: InlineContentSpecs;
@@ -100,16 +137,27 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
     readonly suggestionMenus: SuggestionMenuProseMirrorPlugin<BSchema, ISchema, SSchema>;
     readonly filePanel?: FilePanelProsemirrorPlugin<ISchema, SSchema>;
     readonly tableHandles?: TableHandlesProsemirrorPlugin<ISchema, SSchema>;
+    /**
+     * 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.
+     *
+     * `undefined` means the application doesn't support file uploads.
+     *
+     * @param file The file that should be uploaded.
+     * @returns The URL of the uploaded file OR an object containing props that should be set on the file block (such as an id)
+     */
     readonly uploadFile: ((file: File) => Promise<string | Record<string, any>>) | undefined;
     readonly resolveFileUrl: (url: string) => Promise<string>;
+    get pmSchema(): Schema<any, any>;
     static create<BSchema extends BlockSchema = DefaultBlockSchema, ISchema extends InlineContentSchema = DefaultInlineContentSchema, SSchema extends StyleSchema = DefaultStyleSchema>(options?: Partial<BlockNoteEditorOptions<BSchema, ISchema, SSchema>>): BlockNoteEditor<BSchema, ISchema, SSchema>;
     private constructor();
+    dispatch(tr: Transaction): void;
     /**
      * Mount the editor to a parent DOM element. Call mount(undefined) to clean up
      *
-     * @warning Not needed for React, use BlockNoteView to take care of this
+     * @warning Not needed to call manually when using React, use BlockNoteView to take care of mounting
      */
-    mount(parentElement?: HTMLElement | null): void;
+    mount: (parentElement?: HTMLElement | null) => void;
     get prosemirrorView(): import("prosemirror-view").EditorView;
     get domElement(): HTMLDivElement;
     isFocused(): boolean;
@@ -260,12 +308,23 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      */
     unnestBlock(): void;
     /**
-     * Serializes blocks into an HTML string. To better conform to HTML standards, children of blocks which aren't list
+     * 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>[]): Promise<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.
      */
-    blocksToHTMLLossy(blocks?: Block<BSchema, ISchema, SSchema>[]): Promise<string>;
+    blocksToFullHTML(blocks: PartialBlock<BSchema, ISchema, SSchema>[]): Promise<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
@@ -280,7 +339,7 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @param blocks An array of blocks that should be serialized into Markdown.
      * @returns The blocks, serialized as a Markdown string.
      */
-    blocksToMarkdownLossy(blocks?: Block<BSchema, ISchema, SSchema>[]): Promise<string>;
+    blocksToMarkdownLossy(blocks?: PartialBlock<BSchema, ISchema, SSchema>[]): Promise<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
@@ -302,12 +361,13 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @param callback The callback to execute.
      * @returns A function to remove the callback.
      */
-    onChange(callback: (editor: BlockNoteEditor<BSchema, ISchema, SSchema>) => void): () => void;
+    onChange(callback: (editor: BlockNoteEditor<BSchema, ISchema, SSchema>) => void): (() => void) | undefined;
     /**
      * 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): () => void;
+    onSelectionChange(callback: (editor: BlockNoteEditor<BSchema, ISchema, SSchema>) => void): (() => void) | undefined;
+    openSelectionMenu(triggerCharacter: string): void;
 }

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

@@ -1,13 +1,12 @@
 import type { BlockNoteEditor } from "./BlockNoteEditor";
 import * as Y from "yjs";
-import { BlockNoteDOMAttributes, BlockSpecs, InlineContentSchema, InlineContentSpecs, StyleSchema, StyleSpecs } from "../schema";
+import { BlockNoteDOMAttributes, BlockSchema, BlockSpecs, InlineContentSchema, InlineContentSpecs, StyleSchema, StyleSpecs } from "../schema";
 /**
  * Get all the Tiptap extensions BlockNote is configured with by default
  */
-export declare const getBlockNoteExtensions: <BSchema extends Record<string, import("../schema").BlockConfig>, I extends InlineContentSchema, S extends StyleSchema>(opts: {
+export declare const getBlockNoteExtensions: <BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(opts: {
     editor: BlockNoteEditor<BSchema, I, S>;
     domAttributes: Partial<BlockNoteDOMAttributes>;
-    blockSchema: BSchema;
     blockSpecs: BlockSpecs;
     inlineContentSpecs: InlineContentSpecs;
     styleSpecs: StyleSpecs;

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

@@ -1,6 +1,6 @@
 import { EditorOptions } from "@tiptap/core";
 import { Editor as TiptapEditor } from "@tiptap/core";
-import { EditorState } from "prosemirror-state";
+import { EditorState, Transaction } from "@tiptap/pm/state";
 import { PartialBlock } from "../blocks/defaultBlocks";
 import { StyleSchema } from "../schema";
 export type BlockNoteTipTapEditorOptions = Partial<Omit<EditorOptions, "content">> & {
@@ -14,7 +14,7 @@ export declare class BlockNoteTipTapEditor extends TiptapEditor {
     private _state;
     constructor(options: BlockNoteTipTapEditorOptions, styleSchema: StyleSchema);
     get state(): EditorState;
-    createView(): void;
+    dispatch(tr: Transaction): void;
     /**
      * Replace the default `createView` method with a custom one - which we call on mount
      */

package/types/src/extensions/FormattingToolbar/FormattingToolbarPlugin.d.ts

@@ -19,6 +19,7 @@ export declare class FormattingToolbarView implements PluginView {
         to: number;
     }) => boolean;
     constructor(editor: BlockNoteEditor<BlockSchema, InlineContentSchema, StyleSchema>, pmView: EditorView, emitUpdate: (state: FormattingToolbarState) => void);
+    blurHandler: (event: FocusEvent) => void;
     viewMousedownHandler: () => void;
     viewMouseupHandler: () => void;
     dragHandler: () => void;

package/types/src/extensions/SuggestionMenu/DefaultGridSuggestionItem.d.ts

@@ -0,0 +1,4 @@
+export type DefaultGridSuggestionItem = {
+    id: string;
+    onItemClick: () => void;
+};

package/types/src/extensions/SuggestionMenu/SuggestionPlugin.d.ts

@@ -1,4 +1,4 @@
-import { Plugin, PluginKey } from "prosemirror-state";
+import { Plugin } from "prosemirror-state";
 import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
 import { UiElementPosition } from "../../extensions-shared/UiElementPosition";
 import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
@@ -6,7 +6,6 @@ import { EventEmitter } from "../../util/EventEmitter";
 export type SuggestionMenuState = UiElementPosition & {
     query: string;
 };
-export declare const suggestionMenuPluginKey: PluginKey<any>;
 /**
  * A ProseMirror plugin for suggestions, designed to make '/'-commands possible as well as mentions.
  *

package/types/src/extensions/SuggestionMenu/getDefaultEmojiPickerItems.d.ts

@@ -0,0 +1,4 @@
+import { BlockNoteEditor } from "../../editor/BlockNoteEditor";
+import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
+import { DefaultGridSuggestionItem } from "./DefaultGridSuggestionItem";
+export declare function getDefaultEmojiPickerItems<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, query: string): Promise<DefaultGridSuggestionItem[]>;

package/types/src/extensions/SuggestionMenu/getDefaultSlashMenuItems.d.ts

@@ -1,5 +1,5 @@
-import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
 import { Block, PartialBlock } from "../../blocks/defaultBlocks";
+import type { BlockNoteEditor } from "../../editor/BlockNoteEditor";
 import { BlockSchema, InlineContentSchema, StyleSchema } from "../../schema";
 import { DefaultSuggestionItem } from "./DefaultSuggestionItem";
 export declare function insertOrUpdateBlock<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, block: PartialBlock<BSchema, I, S>): Block<BSchema, I, S>;

package/types/src/i18n/locales/en.d.ts

@@ -72,6 +72,12 @@ export declare const en: {
             aliases: string[];
             group: string;
         };
+        emoji: {
+            title: string;
+            subtext: string;
+            aliases: string[];
+            group: string;
+        };
     };
     placeholders: {
         default: string;

package/types/src/index.d.ts

@@ -2,12 +2,13 @@ import * as locales from "./i18n/locales";
 export * from "./api/exporters/html/externalHTMLExporter";
 export * from "./api/exporters/html/internalHTMLSerializer";
 export * from "./api/testUtil";
+export * from "./blocks/AudioBlockContent/AudioBlockContent";
 export * from "./blocks/FileBlockContent/FileBlockContent";
 export * from "./blocks/ImageBlockContent/ImageBlockContent";
 export * from "./blocks/VideoBlockContent/VideoBlockContent";
-export * from "./blocks/AudioBlockContent/AudioBlockContent";
 export * from "./blocks/FileBlockContent/fileBlockHelpers";
 export * from "./blocks/FileBlockContent/uploadToTmpFilesDotOrg_DEV_ONLY";
+export { parseImageElement } from "./blocks/ImageBlockContent/imageBlockHelpers";
 export * from "./blocks/defaultBlockTypeGuards";
 export * from "./blocks/defaultBlocks";
 export * from "./blocks/defaultProps";
@@ -21,16 +22,21 @@ export * from "./extensions/FormattingToolbar/FormattingToolbarPlugin";
 export * from "./extensions/LinkToolbar/LinkToolbarPlugin";
 export * from "./extensions/SideMenu/SideMenuPlugin";
 export * from "./extensions/SuggestionMenu/DefaultSuggestionItem";
+export * from "./extensions/SuggestionMenu/DefaultGridSuggestionItem";
 export * from "./extensions/SuggestionMenu/SuggestionPlugin";
 export * from "./extensions/SuggestionMenu/getDefaultSlashMenuItems";
+export * from "./extensions/SuggestionMenu/getDefaultEmojiPickerItems";
 export * from "./extensions/TableHandles/TableHandlesPlugin";
+export * from "./i18n/dictionary";
 export * from "./schema";
 export * from "./util/browser";
 export * from "./util/string";
+export * from "./util/typescript";
+export { UnreachableCaseError, assertEmpty } from "./util/typescript";
+export { locales };
 export * from "./api/nodeConversions/nodeConversions";
 export * from "./api/testUtil/partialBlockTestUtil";
 export * from "./extensions/UniqueID/UniqueID";
-export * from "./i18n/dictionary";
-export { UnreachableCaseError, assertEmpty } from "./util/typescript";
-export { locales };
-export { parseImageElement } from "./blocks/ImageBlockContent/imageBlockHelpers";
+export * from "./api/exporters/markdown/markdownExporter";
+export * from "./api/parsers/html/parseHTML";
+export * from "./api/parsers/markdown/parseMarkdown";

package/types/src/pm-nodes/BlockContainer.d.ts

@@ -1,7 +1,7 @@
 import { Node } from "@tiptap/core";
 import { PartialBlock } from "../blocks/defaultBlocks";
 import type { BlockNoteEditor } from "../editor/BlockNoteEditor";
-import { BlockSchema, InlineContentSchema, StyleSchema } from "../schema";
+import { BlockNoteDOMAttributes, BlockSchema, InlineContentSchema, StyleSchema } from "../schema";
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         block: {
@@ -18,12 +18,6 @@ declare module "@tiptap/core" {
  * The main "Block node" documents consist of
  */
 export declare const BlockContainer: Node<{
-    domAttributes?: Partial<{
-        blockGroup: Record<string, string>;
-        block: Record<string, string>;
-        editor: Record<string, string>;
-        blockContent: Record<string, string>;
-        inlineContent: Record<string, string>;
-    }> | undefined;
+    domAttributes?: BlockNoteDOMAttributes;
     editor: BlockNoteEditor<any, any, any>;
 }, any>;

package/types/src/pm-nodes/BlockGroup.d.ts

@@ -1,10 +1,5 @@
 import { Node } from "@tiptap/core";
+import { BlockNoteDOMAttributes } from "../schema";
 export declare const BlockGroup: Node<{
-    domAttributes?: Partial<{
-        blockGroup: Record<string, string>;
-        block: Record<string, string>;
-        editor: Record<string, string>;
-        blockContent: Record<string, string>;
-        inlineContent: Record<string, string>;
-    }> | undefined;
+    domAttributes?: BlockNoteDOMAttributes;
 }, any>;

package/types/src/schema/inlineContent/internal.d.ts

@@ -22,7 +22,7 @@ export declare function createInlineContentSpecFromTipTapNode<T extends Node, P
         content: "styled" | "none";
     };
     implementation: {
-        node: Node<any, any>;
+        node: Node;
     };
 };
 export declare function getInlineContentSchemaFromSpecs<T extends InlineContentSpecs>(specs: T): InlineContentSchemaFromSpecs<T>;