@blocknote/core 0.19.2 → 0.21.0

package/src/extensions/LinkToolbar/protocols.ts

@@ -0,0 +1,13 @@
+export const VALID_LINK_PROTOCOLS = [
+  "http",
+  "https",
+  "ftp",
+  "ftps",
+  "mailto",
+  "tel",
+  "callto",
+  "sms",
+  "cid",
+  "xmpp",
+];
+export const DEFAULT_LINK_PROTOCOL = "https";

package/src/extensions/Placeholder/PlaceholderPlugin.ts

@@ -18,10 +18,10 @@ export class PlaceholderPlugin {
         if (nonce) {
           styleEl.setAttribute("nonce", nonce);
         }
-        if (editor._tiptapEditor.view.root instanceof ShadowRoot) {
-          editor._tiptapEditor.view.root.append(styleEl);
+        if (editor.prosemirrorView?.root instanceof ShadowRoot) {
+          editor.prosemirrorView.root.append(styleEl);
         } else {
-          editor._tiptapEditor.view.root.head.appendChild(styleEl);
+          editor.prosemirrorView?.root.head.appendChild(styleEl);
         }
 
         const styleSheet = styleEl.sheet!;
@@ -48,32 +48,40 @@ export class PlaceholderPlugin {
         for (const [blockType, placeholder] of Object.entries(placeholders)) {
           const mustBeFocused = blockType === "default";
 
-          styleSheet.insertRule(
-            `${getSelector(
-              blockType,
-              mustBeFocused
-            )}{ content: ${JSON.stringify(placeholder)}; }`
-          );
-
-          // For some reason, the placeholders which show when the block is focused
-          // take priority over ones which show depending on block type, so we need
-          // to make sure the block specific ones are also used when the block is
-          // focused.
-          if (!mustBeFocused) {
+          try {
             styleSheet.insertRule(
-              `${getSelector(blockType, true)}{ content: ${JSON.stringify(
-                placeholder
-              )}; }`
+              `${getSelector(
+                blockType,
+                mustBeFocused
+              )} { content: ${JSON.stringify(placeholder)}; }`
+            );
+
+            // For some reason, the placeholders which show when the block is focused
+            // take priority over ones which show depending on block type, so we need
+            // to make sure the block specific ones are also used when the block is
+            // focused.
+            if (!mustBeFocused) {
+              styleSheet.insertRule(
+                `${getSelector(blockType, true)} { content: ${JSON.stringify(
+                  placeholder
+                )}; }`
+              );
+            }
+          } catch (e) {
+            // eslint-disable-next-line no-console
+            console.warn(
+              `Failed to insert placeholder CSS rule - this is likely due to the browser not supporting certain CSS pseudo-element selectors (:has, :only-child:, or :before)`,
+              e
             );
           }
         }
 
         return {
           destroy: () => {
-            if (editor._tiptapEditor.view.root instanceof ShadowRoot) {
-              editor._tiptapEditor.view.root.removeChild(styleEl);
+            if (editor.prosemirrorView?.root instanceof ShadowRoot) {
+              editor.prosemirrorView.root.removeChild(styleEl);
             } else {
-              editor._tiptapEditor.view.root.head.removeChild(styleEl);
+              editor.prosemirrorView?.root.head.removeChild(styleEl);
             }
           },
         };

package/src/extensions/SideMenu/SideMenuPlugin.ts

@@ -485,7 +485,11 @@ export class SideMenuProsemirrorPlugin<
   /**
    * Handles drag & drop events for blocks.
    */
-  blockDragEnd = () => unsetDragImage(this.editor.prosemirrorView.root);
+  blockDragEnd = () => {
+    if (this.editor.prosemirrorView) {
+      unsetDragImage(this.editor.prosemirrorView.root);
+    }
+  };
   /**
    * Freezes the side menu. When frozen, the side menu will stay
    * attached to the same block regardless of which block is hovered by the

package/src/extensions/SideMenu/dragging.ts

@@ -148,8 +148,15 @@ export function dragStart<
   }
 
   const view = editor.prosemirrorView;
+  if (!view) {
+    return;
+  }
 
-  const pos = getNodeById(block.id, view.state.doc).posBeforeNode;
+  const posInfo = getNodeById(block.id, view.state.doc);
+  if (!posInfo) {
+    throw new Error(`Block with ID ${block.id} not found`);
+  }
+  const pos = posInfo.posBeforeNode;
 
   if (pos != null) {
     const selection = view.state.selection;

package/src/extensions/SuggestionMenu/SuggestionPlugin.ts

@@ -45,12 +45,12 @@ class SuggestionMenuView<
       });
     };
 
-    this.rootEl = this.editor._tiptapEditor.view.root;
+    this.rootEl = this.editor.prosemirrorView?.root;
 
     // Setting capture=true ensures that any parent container of the editor that
     // gets scrolled will trigger the scroll event. Scroll events do not bubble
     // and so won't propagate to the document by default.
-    this.rootEl.addEventListener("scroll", this.handleScroll, true);
+    this.rootEl?.addEventListener("scroll", this.handleScroll, true);
   }
 
   handleScroll = () => {
@@ -113,10 +113,7 @@ class SuggestionMenuView<
 
   closeMenu = () => {
     this.editor.dispatch(
-      this.editor._tiptapEditor.view.state.tr.setMeta(
-        suggestionMenuPluginKey,
-        null
-      )
+      this.editor._tiptapEditor.state.tr.setMeta(suggestionMenuPluginKey, null)
     );
   };
 

package/src/extensions/TableHandles/TableHandlesPlugin.ts

@@ -236,6 +236,9 @@ export class TableHandlesView<
       blockEl.id,
       this.editor._tiptapEditor.state.doc
     );
+    if (!pmNodeInfo) {
+      throw new Error(`Block with ID ${blockEl.id} not found`);
+    }
 
     const block = nodeToBlock(
       pmNodeInfo.node,
@@ -468,17 +471,26 @@ export class TableHandlesView<
     // the existing selection out of the block.
     this.editor.setTextCursorPosition(this.state.block.id);
   };
-  // Updates drag handle positions on table content updates.
+  // Updates drag handles when the table is modified or removed.
   update() {
     if (!this.state || !this.state.show) {
       return;
     }
 
-    const tableBody = this.tableElement!.querySelector("tbody");
-    if (!tableBody) {
+    // Hide handles if the table block has been removed.
+    this.state.block = this.editor.getBlock(this.state.block.id)!;
+    if (!this.state.block) {
+      this.state.show = false;
+      this.state.showAddOrRemoveRowsButton = false;
+      this.state.showAddOrRemoveColumnsButton = false;
+      this.emitUpdate();
+
       return;
     }
 
+    const rowCount = this.state.block.content.rows.length;
+    const colCount = this.state.block.content.rows[0].cells.length;
+
     if (
       this.state.rowIndex !== undefined &&
       this.state.colIndex !== undefined
@@ -486,20 +498,33 @@ export class TableHandlesView<
       // If rows or columns are deleted in the update, the hovered indices for
       // those may now be out of bounds. If this is the case, they are moved to
       // the new last row or column.
-      if (this.state.rowIndex >= tableBody.children.length) {
-        this.state.rowIndex = tableBody.children.length - 1;
+      if (this.state.rowIndex >= rowCount) {
+        this.state.rowIndex = rowCount - 1;
       }
-      if (this.state.colIndex >= tableBody.children[0].children.length) {
-        this.state.colIndex = tableBody.children[0].children.length - 1;
+      if (this.state.colIndex >= colCount) {
+        this.state.colIndex = colCount - 1;
       }
+    }
+
+    // Update bounding boxes.
+    const tableBody = this.tableElement!.querySelector("tbody");
+    if (!tableBody) {
+      throw new Error(
+        "Table block does not contain a 'tbody' HTML element. This should never happen."
+      );
+    }
 
+    if (
+      this.state.rowIndex !== undefined &&
+      this.state.colIndex !== undefined
+    ) {
       const row = tableBody.children[this.state.rowIndex];
       const cell = row.children[this.state.colIndex];
+
       this.state.referencePosCell = cell.getBoundingClientRect();
     }
-
-    this.state.block = this.editor.getBlock(this.state.block.id)!;
     this.state.referencePosTable = tableBody.getBoundingClientRect();
+
     this.emitUpdate();
   }
 
@@ -717,7 +742,11 @@ export class TableHandlesProsemirrorPlugin<
       })
     );
 
-    setHiddenDragImage(this.editor._tiptapEditor.view.root);
+    if (!this.editor.prosemirrorView) {
+      throw new Error("Editor view not initialized.");
+    }
+
+    setHiddenDragImage(this.editor.prosemirrorView.root);
     event.dataTransfer!.setDragImage(dragImageElement!, 0, 0);
     event.dataTransfer!.effectAllowed = "move";
   };
@@ -756,7 +785,11 @@ export class TableHandlesProsemirrorPlugin<
       })
     );
 
-    setHiddenDragImage(this.editor._tiptapEditor.view.root);
+    if (!this.editor.prosemirrorView) {
+      throw new Error("Editor view not initialized.");
+    }
+
+    setHiddenDragImage(this.editor.prosemirrorView.root);
     event.dataTransfer!.setDragImage(dragImageElement!, 0, 0);
     event.dataTransfer!.effectAllowed = "copyMove";
   };
@@ -779,7 +812,11 @@ export class TableHandlesProsemirrorPlugin<
       this.editor._tiptapEditor.state.tr.setMeta(tableHandlesPluginKey, null)
     );
 
-    unsetHiddenDragImage(this.editor._tiptapEditor.view.root);
+    if (!this.editor.prosemirrorView) {
+      throw new Error("Editor view not initialized.");
+    }
+
+    unsetHiddenDragImage(this.editor.prosemirrorView.root);
   };
 
   /**

package/src/i18n/locales/ru.ts

@@ -271,7 +271,7 @@ export const ru: Dictionary = {
         image: "Удалить картинку",
         video: "Удалить видео",
         audio: "Удалить аудио",
-        file: "Скачать файл",
+        file: "Удалить файл",
       },
     },
     file_preview_toggle: {

package/src/index.ts

@@ -7,10 +7,16 @@ export * from "./api/testUtil/index.js";
 export * from "./blocks/AudioBlockContent/AudioBlockContent.js";
 export * from "./blocks/CodeBlockContent/CodeBlockContent.js";
 export * from "./blocks/FileBlockContent/FileBlockContent.js";
-export * from "./blocks/FileBlockContent/fileBlockHelpers.js";
+export * from "./blocks/FileBlockContent/helpers/parse/parseEmbedElement.js";
+export * from "./blocks/FileBlockContent/helpers/parse/parseFigureElement.js";
+export * from "./blocks/FileBlockContent/helpers/render/createAddFileButton.js";
+export * from "./blocks/FileBlockContent/helpers/render/createFileBlockWrapper.js";
+export * from "./blocks/FileBlockContent/helpers/render/createFileNameWithIcon.js";
+export * from "./blocks/FileBlockContent/helpers/render/createResizableFileBlockWrapper.js";
+export * from "./blocks/FileBlockContent/helpers/toExternalHTML/createFigureWithCaption.js";
+export * from "./blocks/FileBlockContent/helpers/toExternalHTML/createLinkWithCaption.js";
 export * from "./blocks/FileBlockContent/uploadToTmpFilesDotOrg_DEV_ONLY.js";
 export * from "./blocks/ImageBlockContent/ImageBlockContent.js";
-export { parseImageElement } from "./blocks/ImageBlockContent/imageBlockHelpers.js";
 export {
   EMPTY_CELL_HEIGHT,
   EMPTY_CELL_WIDTH,
@@ -30,6 +36,7 @@ export * from "./extensions-shared/UiElementPosition.js";
 export * from "./extensions/FilePanel/FilePanelPlugin.js";
 export * from "./extensions/FormattingToolbar/FormattingToolbarPlugin.js";
 export * from "./extensions/LinkToolbar/LinkToolbarPlugin.js";
+export * from "./extensions/LinkToolbar/protocols.js";
 export * from "./extensions/SideMenu/SideMenuPlugin.js";
 export * from "./extensions/SuggestionMenu/DefaultGridSuggestionItem.js";
 export * from "./extensions/SuggestionMenu/DefaultSuggestionItem.js";

package/src/schema/inlineContent/createSpec.ts

@@ -142,8 +142,8 @@ export function createInlineContentSpec<
               editor.schema.styleSchema
             );
 
-            editor._tiptapEditor.view.dispatch(
-              editor._tiptapEditor.view.state.tr.replaceWith(
+            editor.dispatch(
+              editor.prosemirrorView.state.tr.replaceWith(
                 getPos(),
                 getPos() + node.nodeSize,
                 content

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

@@ -0,0 +1,15 @@
+import type { BlockNoteEditor } from "../../../../editor/BlockNoteEditor";
+import { BlockIdentifier } from "../../../../schema/index.js";
+/**
+ * Removes the selected blocks from the editor, then inserts them before/after a
+ * reference block. Also updates the selection to match the original selection
+ * using `getBlockSelectionData` and `updateBlockSelectionFromData`.
+ * @param editor The BlockNote editor instance to move the blocks in.
+ * @param referenceBlock The reference block to insert the selected blocks
+ * before/after.
+ * @param placement Whether to insert the selected blocks before or after the
+ * reference block.
+ */
+export declare function moveSelectedBlocksAndSelection(editor: BlockNoteEditor<any, any, any>, referenceBlock: BlockIdentifier, placement: "before" | "after"): void;
+export declare function moveBlocksUp(editor: BlockNoteEditor<any, any, any>): void;
+export declare function moveBlocksDown(editor: BlockNoteEditor<any, any, any>): void;

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

@@ -0,0 +1,7 @@
+import { Block } from "../../../blocks/defaultBlocks.js";
+import type { BlockNoteEditor } from "../../../editor/BlockNoteEditor.js";
+import { BlockIdentifier, BlockSchema, InlineContentSchema, StyleSchema } from "../../../schema/index.js";
+export declare function getBlock<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, blockIdentifier: BlockIdentifier): Block<BSchema, I, S> | undefined;
+export declare function getPrevBlock<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, blockIdentifier: BlockIdentifier): Block<BSchema, I, S> | undefined;
+export declare function getNextBlock<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, blockIdentifier: BlockIdentifier): Block<BSchema, I, S> | undefined;
+export declare function getParentBlock<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, blockIdentifier: BlockIdentifier): Block<BSchema, I, S> | undefined;

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

@@ -0,0 +1,5 @@
+import type { BlockNoteEditor } from "../../../editor/BlockNoteEditor";
+import { Selection } from "../../../editor/selectionTypes.js";
+import { BlockIdentifier, BlockSchema, InlineContentSchema, StyleSchema } from "../../../schema/index.js";
+export declare function getSelection<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>): Selection<BSchema, I, S> | undefined;
+export declare function setSelection<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(editor: BlockNoteEditor<BSchema, I, S>, startBlock: BlockIdentifier, endBlock: BlockIdentifier): void;

package/types/src/api/blockManipulation/selections/selection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/src/api/clipboard/fromClipboard/handleVSCodePaste.d.ts

@@ -1,3 +1,2 @@
-import { BlockNoteEditor } from "../../../editor/BlockNoteEditor.js";
-import { BlockSchema, InlineContentSchema, StyleSchema } from "../../../schema/index.js";
-export declare function handleVSCodePaste<BSchema extends BlockSchema, I extends InlineContentSchema, S extends StyleSchema>(event: ClipboardEvent, editor: BlockNoteEditor<BSchema, I, S>): Promise<boolean>;
+import { EditorView } from "prosemirror-view";
+export declare function handleVSCodePaste(event: ClipboardEvent, view: EditorView): Promise<boolean>;

package/types/src/api/clipboard/fromClipboard/pasteExtension.d.ts

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

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

@@ -5,4 +5,4 @@ import { Node } from "prosemirror-model";
 export declare function getNodeById(id: string, doc: Node): {
     node: Node;
     posBeforeNode: number;
-};
+} | undefined;

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

@@ -42,11 +42,8 @@ export declare const audioBlockConfig: {
     fileBlockAccept: string[];
 };
 export declare const audioRender: (block: BlockFromConfig<typeof audioBlockConfig, any, any>, editor: BlockNoteEditor<any, any, any>) => {
-    dom: HTMLDivElement;
-    destroy?: undefined;
-} | {
-    dom: HTMLDivElement;
-    destroy: (() => void) | undefined;
+    dom: HTMLElement;
+    destroy?: (() => void) | undefined;
 };
 export declare const audioParse: (element: HTMLElement) => Partial<Props<typeof audioBlockConfig.propSchema>> | undefined;
 export declare const audioToExternalHTML: (block: BlockFromConfig<typeof audioBlockConfig, any, any>) => {

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

@@ -34,11 +34,8 @@ export declare const fileBlockConfig: {
     isFileBlock: true;
 };
 export declare const fileRender: (block: BlockFromConfig<typeof fileBlockConfig, any, any>, editor: BlockNoteEditor<any, any, any>) => {
-    dom: HTMLDivElement;
-    destroy?: undefined;
-} | {
-    dom: HTMLDivElement;
-    destroy: (() => void) | undefined;
+    dom: HTMLElement;
+    destroy?: (() => void) | undefined;
 };
 export declare const fileParse: (element: HTMLElement) => {
     url: string | undefined;

package/types/src/blocks/FileBlockContent/helpers/parse/parseEmbedElement.d.ts

@@ -0,0 +1,3 @@
+export declare const parseEmbedElement: (embedElement: HTMLEmbedElement) => {
+    url: string | undefined;
+};

package/types/src/blocks/FileBlockContent/helpers/parse/parseFigureElement.d.ts

@@ -0,0 +1,4 @@
+export declare const parseFigureElement: (figureElement: HTMLElement, targetTag: string) => {
+    targetElement: HTMLElement;
+    caption: string | undefined;
+} | undefined;

package/types/src/blocks/FileBlockContent/helpers/render/createAddFileButton.d.ts

@@ -0,0 +1,6 @@
+import type { BlockNoteEditor } from "../../../../editor/BlockNoteEditor.js";
+import { BlockFromConfig, FileBlockConfig } from "../../../../schema/index.js";
+export declare const createAddFileButton: (block: BlockFromConfig<FileBlockConfig, any, any>, editor: BlockNoteEditor<any, any, any>, buttonText?: string, buttonIcon?: HTMLElement) => {
+    dom: HTMLDivElement;
+    destroy: () => void;
+};

package/types/src/blocks/FileBlockContent/helpers/render/createFileBlockWrapper.d.ts

@@ -0,0 +1,9 @@
+import type { BlockNoteEditor } from "../../../../editor/BlockNoteEditor.js";
+import { BlockFromConfig, BlockSchemaWithBlock, FileBlockConfig } from "../../../../schema/index.js";
+export declare const createFileBlockWrapper: (block: BlockFromConfig<FileBlockConfig, any, any>, editor: BlockNoteEditor<BlockSchemaWithBlock<FileBlockConfig["type"], FileBlockConfig>, any, any>, element?: {
+    dom: HTMLElement;
+    destroy?: () => void;
+}, buttonText?: string, buttonIcon?: HTMLElement) => {
+    dom: HTMLElement;
+    destroy?: (() => void) | undefined;
+};

package/types/src/blocks/FileBlockContent/helpers/render/createFileNameWithIcon.d.ts

@@ -0,0 +1,6 @@
+import { BlockFromConfig, FileBlockConfig } from "../../../../schema/index.js";
+export declare const FILE_ICON_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"currentColor\"><path d=\"M3 8L9.00319 2H19.9978C20.5513 2 21 2.45531 21 2.9918V21.0082C21 21.556 20.5551 22 20.0066 22H3.9934C3.44476 22 3 21.5501 3 20.9932V8ZM10 4V9H5V20H19V4H10Z\"></path></svg>";
+export declare const createFileNameWithIcon: (block: BlockFromConfig<FileBlockConfig, any, any>) => {
+    dom: HTMLElement;
+    destroy?: () => void;
+};

package/types/src/blocks/FileBlockContent/helpers/render/createResizableFileBlockWrapper.d.ts

@@ -0,0 +1,9 @@
+import type { BlockNoteEditor } from "../../../../editor/BlockNoteEditor.js";
+import { BlockFromConfig, FileBlockConfig } from "../../../../schema/index.js";
+export declare const createResizableFileBlockWrapper: (block: BlockFromConfig<FileBlockConfig, any, any>, editor: BlockNoteEditor<any, any, any>, element: {
+    dom: HTMLElement;
+    destroy?: () => void;
+}, resizeHandlesContainerElement: HTMLElement, buttonText: string, buttonIcon: HTMLElement) => {
+    dom: HTMLElement;
+    destroy: () => void;
+};

package/types/src/blocks/FileBlockContent/helpers/toExternalHTML/createFigureWithCaption.d.ts

@@ -0,0 +1,3 @@
+export declare const createFigureWithCaption: (element: HTMLElement, caption: string) => {
+    dom: HTMLElement;
+};

package/types/src/blocks/FileBlockContent/helpers/toExternalHTML/createLinkWithCaption.d.ts

@@ -0,0 +1,3 @@
+export declare const createLinkWithCaption: (element: HTMLElement, caption: string) => {
+    dom: HTMLDivElement;
+};

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

@@ -56,11 +56,8 @@ export declare const imageBlockConfig: {
     fileBlockAccept: string[];
 };
 export declare const imageRender: (block: BlockFromConfig<typeof imageBlockConfig, any, any>, editor: BlockNoteEditor<any, any, any>) => {
-    dom: HTMLDivElement;
-    destroy?: undefined;
-} | {
-    dom: HTMLDivElement;
-    destroy: (() => void) | undefined;
+    dom: HTMLElement;
+    destroy: () => void;
 };
 export declare const imageParse: (element: HTMLElement) => Partial<Props<typeof imageBlockConfig.propSchema>> | undefined;
 export declare const imageToExternalHTML: (block: BlockFromConfig<typeof imageBlockConfig, any, any>) => {

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

@@ -56,11 +56,8 @@ export declare const videoBlockConfig: {
     fileBlockAccept: string[];
 };
 export declare const videoRender: (block: BlockFromConfig<typeof videoBlockConfig, any, any>, editor: BlockNoteEditor<any, any, any>) => {
-    dom: HTMLDivElement;
-    destroy?: undefined;
-} | {
-    dom: HTMLDivElement;
-    destroy: (() => void) | undefined;
+    dom: HTMLElement;
+    destroy: () => void;
 };
 export declare const videoParse: (element: HTMLElement) => Partial<Props<typeof videoBlockConfig.propSchema>> | undefined;
 export declare const videoToExternalHTML: (block: BlockFromConfig<typeof videoBlockConfig, any, any>) => {

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

@@ -17,6 +17,7 @@ import { BlockNoteTipTapEditor } from "./BlockNoteTipTapEditor.js";
 import { Dictionary } from "../i18n/dictionary.js";
 import { Plugin, Transaction } from "@tiptap/pm/state";
 import "../style.css";
+import { EditorView } from "prosemirror-view";
 export type BlockNoteExtension = AnyExtension | {
     plugin: Plugin;
 };
@@ -123,6 +124,20 @@ export type BlockNoteEditorOptions<BSchema extends BlockSchema, ISchema extends
      */
     setIdAttribute?: boolean;
     dropCursor?: (opts: any) => Plugin;
+    /**
+     Select desired behavior when pressing `Tab` (or `Shift-Tab`). Specifically,
+     what should happen when a user has selected multiple blocks while a toolbar
+     is open:
+     - `"prefer-navigate-ui"`: Change focus to the toolbar. The user needs to
+     first press `Escape` to close the toolbar, and can then indent multiple
+     blocks. Better for keyboard accessibility.
+     - `"prefer-indent"`: Regardless of whether toolbars are open, indent the
+     selection of blocks. In this case, it's not possible to navigate toolbars
+     with the keyboard.
+  
+     @default "prefer-navigate-ui"
+     */
+    tabBehavior: "prefer-navigate-ui" | "prefer-indent";
 };
 export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockSchema, ISchema extends InlineContentSchema = DefaultInlineContentSchema, SSchema extends StyleSchema = DefaultStyleSchema> {
     protected readonly options: Partial<BlockNoteEditorOptions<any, any, any>>;
@@ -139,7 +154,8 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * 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 & {
+    readonly _tiptapEditor: Omit<BlockNoteTipTapEditor, "view"> & {
+        view: EditorView | undefined;
         contentComponent: any;
     };
     /**
@@ -182,7 +198,7 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
     readonly uploadFile: ((file: File, blockId?: string) => Promise<string | Record<string, any>>) | undefined;
     private onUploadStartCallbacks;
     private onUploadEndCallbacks;
-    readonly resolveFileUrl: (url: string) => Promise<string>;
+    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>;
     protected constructor(options: Partial<BlockNoteEditorOptions<any, any, any>>);
@@ -193,8 +209,8 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * @warning Not needed to call manually when using React, use BlockNoteView to take care of mounting
      */
     mount: (parentElement?: HTMLElement | null) => void;
-    get prosemirrorView(): import("prosemirror-view").EditorView;
-    get domElement(): HTMLDivElement;
+    get prosemirrorView(): EditorView | undefined;
+    get domElement(): HTMLDivElement | undefined;
     isFocused(): boolean;
     focus(): void;
     onUploadStart(callback: (blockId?: string) => void): () => void;
@@ -210,10 +226,39 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
     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.
+     * @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.
@@ -246,6 +291,7 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      * Gets a snapshot of the current selection.
      */
     getSelection(): Selection<BSchema, ISchema, SSchema> | undefined;
+    setSelection(startBlock: BlockIdentifier, endBlock: BlockIdentifier): void;
     /**
      * Checks if the editor is currently editable, or if it's locked.
      * @returns True if the editor is editable, false otherwise.
@@ -345,17 +391,17 @@ export declare class BlockNoteEditor<BSchema extends BlockSchema = DefaultBlockS
      */
     unnestBlock(): void;
     /**
-     * Moves the block containing the text cursor up. If the previous block has
-     * children, moves it to the end of its children. If there is no previous
-     * block, but the current block is nested, moves it out of & before its parent.
+     * 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.
      */
-    moveBlockUp(): void;
+    moveBlocksUp(): void;
     /**
-     * Moves the block containing the text cursor down. If the next block has
-     * children, moves it to the start of its children. If there is no next block,
-     * but the current block is nested, moves it out of & after its parent.
+     * 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.
      */
-    moveBlockDown(): void;
+    moveBlocksDown(): void;
     /**
      * 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.

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

@@ -25,6 +25,7 @@ type ExtensionOptions<BSchema extends BlockSchema, I extends InlineContentSchema
     tableHandles: boolean;
     dropCursor: (opts: any) => Plugin;
     placeholders: Record<string | "default", string>;
+    tabBehavior?: "prefer-navigate-ui" | "prefer-indent";
 };
 /**
  * Get all the Tiptap extensions BlockNote is configured with by default