@openeditor/react 0.0.27 → 0.0.28

package/README.md

@@ -9,6 +9,7 @@ Pass `attachmentRuntime` to `useOpenEditorController` for editable attachments a
 - `useOpenEditorController` for editor state, commands, document exports, and selection state
 - `OpenEditorContent` for the editable Tiptap-backed content surface
 - `OpenEditorViewer` for read-only React rendering
+- `OpenEditorPageHeader` for host-backed page title and icon editing
 - `getDefaultBlockPickerItems` for host-owned block rails, pickers, and command palettes
 - `getDefaultSlashMenuItems` for UI packages that want the built-in insert actions
 - stable-identity block targeting and transaction-backed copy, duplicate, move, and delete commands
@@ -120,12 +121,24 @@ themeable SVG rendering and retain their canonical Mermaid source in the documen
 import { OpenEditorContent, useOpenEditorController } from "@openeditor/react";
 
 export function Example() {
-  const controller = useOpenEditorController();
+  const controller = useOpenEditorController({ initialDocument });
 
   return <OpenEditorContent controller={controller} />;
 }
 ```
 
+Editors are uncontrolled on both web and native. `initialDocument` is read once;
+use `controller.setContent(document)` for an undoable programmatic replacement.
+It emits `onChange` and preserves the current selection where possible. Runtime
+changes to callbacks, `editable`, and `placeholder` are applied without remounting.
+
+Exports are lazy. `controller.export("html")` returns publishing-safe built-in
+HTML. `controller.exportUnsafe("html")` opts into trusted custom extension HTML.
+
+Pass `enabledBlocks` to restrict authoring without removing nodes from the
+schema. Existing disabled blocks remain readable. Runtime-dependent insertion
+is automatically disabled unless page creation or attachment upload is wired.
+
 ## Custom blocks
 
 Custom blocks belong to the consuming product. OpenEditor hosts them without
@@ -215,8 +228,9 @@ export function ProductEditor() {
 }
 ```
 
-Pass the same extension array to `OpenEditorViewer`. The controller automatically
-uses registered exporters for `controller.exports` and registered blocks appear
+Pass the same extension array to `OpenEditorViewer`. The controller uses
+registered exporters only through the explicit `controller.exportUnsafe(...)`
+path, and registered blocks appear
 in `getDefaultSlashMenuItems`, which powers `@openeditor/ui`.
 
 Insert-menu entries accept an optional React `icon` component and numeric `order`.
@@ -225,8 +239,7 @@ blocks can be placed between them (for example, `order: 250` appears between
 Heading 1 and Heading 2). Entries with the same order retain their declaration
 order, and entries without an order appear after ordered entries. This metadata
 is shared by slash menus and `getDefaultBlockPickerItems`; use `insertMenu: false`
-to keep a block out of both discovery surfaces. The legacy `slashMenu` extension
-field remains supported. The same fields are available on direct
+to keep a block out of both discovery surfaces. The same fields are available on direct
 `slashMenuItems`; a slash menu's explicit `items` prop is also sorted by this rule.
 
 Block `name` is the stable public identifier. Namespace consumer blocks to avoid
@@ -238,19 +251,23 @@ Duplicate names and node types fail immediately during editor construction.
 
 The first-party `page` block models a Notion-style child page as a reference to
 a separately persisted document. Supply `pageRuntime` to connect creation,
-resolution, renaming, and navigation to your application:
+resolution, metadata updates, and navigation to your application:
 
 ```tsx
 const controller = useOpenEditorController({
   pageRuntime: {
     createPage: async ({ title, icon }) => api.pages.create({ title, icon }),
     resolvePage: async (pageId) => api.pages.get(pageId),
-    renamePage: async (pageId, title) => api.pages.rename(pageId, title),
+    updatePage: async (pageId, update) => api.pages.update(pageId, update),
     openPage: (page) => router.push(`/pages/${page.pageId}`),
   },
 });
 ```
 
+Render `OpenEditorPageHeader` on the opened page surface to provide the canonical
+editable title and icon. Both fields call `pageRuntime.updatePage`; page references
+resolve the same page entity instead of owning independent metadata.
+
 The document stores only the stable reference and cached presentation. Page
 contents, hierarchy, permissions, routing, and deletion remain host-owned.
 

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { ReactNode, CSSProperties, RefObject, ComponentType } from 'react';
-import { OpenEditorBlockRef, OpenEditorDocument, BlockSpec, ProseMirrorNode, OpenEditorAttachmentRuntime } from '@openeditor/core';
-export { OpenEditorBlockRef } from '@openeditor/core';
-import { toExportBundle, OpenEditorExporters } from '@openeditor/exporters';
+import { OpenEditorBlockRef, OpenEditorDocument, BlockSpec, ProseMirrorNode, OpenEditorPageRuntime, OpenEditorAttachmentRuntime, OpenEditorPageSnapshot, OpenEditorAuthoringCapabilities } from '@openeditor/core';
+export { OpenEditorBlockRef, OpenEditorPageRuntime, OpenEditorPageSnapshot } from '@openeditor/core';
+import { ExportFormat, OpenEditorExporters } from '@openeditor/exporters';
 export { seedDocument } from '@openeditor/extensions';
 import { AnyExtension, NodeConfig } from '@tiptap/core';
 import { ReactNodeViewProps } from '@tiptap/react';
@@ -29,23 +29,7 @@ declare function OpenEditorThemeProvider({ children, className, theme }: {
     theme: OpenEditorTheme;
 }): react.JSX.Element;
 
-type OpenEditorPageSnapshot = {
-    pageId: string;
-    title: string;
-    icon?: string | null;
-    href?: string | null;
-};
-type OpenEditorPageRuntime = {
-    createPage?: (input: {
-        title: string;
-        icon?: string | null;
-    }) => Promise<OpenEditorPageSnapshot>;
-    resolvePage?: (pageId: string) => Promise<OpenEditorPageSnapshot | null>;
-    renamePage?: (pageId: string, title: string) => Promise<void> | void;
-    updatePageIcon?: (pageId: string, icon: string) => Promise<void> | void;
-    openPage?: (page: OpenEditorPageSnapshot) => Promise<void> | void;
-};
-type OpenEditorReactProps = {
+type OpenEditorReactProps = OpenEditorAuthoringCapabilities & {
     initialDocument?: OpenEditorDocument;
     editable?: boolean;
     placeholder?: string;
@@ -72,7 +56,8 @@ type OpenEditorBlockAction = {
 type OpenEditorReactConfig = OpenEditorReactProps;
 type OpenEditorController = {
     document: OpenEditorDocument;
-    exports: ReturnType<typeof toExportBundle>;
+    export: (format: ExportFormat) => string;
+    exportUnsafe: (format: ExportFormat) => string;
     ready: boolean;
     editable: boolean;
     placeholder: string;
@@ -95,6 +80,7 @@ type OpenEditorController = {
     undo: () => void;
     redo: () => void;
     insertBlock: (blockName?: string, range?: InsertRange) => boolean;
+    isBlockEnabled: (blockName: string) => boolean;
     setLink: (url?: string | null) => void;
     getActiveLink: () => string | undefined;
     selectBlock: (block: OpenEditorBlockRef) => boolean;
@@ -112,6 +98,7 @@ type OpenEditorController = {
     extensions: readonly OpenEditorReactExtension[];
     pageRuntime?: OpenEditorPageRuntime;
     attachmentRuntime?: OpenEditorAttachmentRuntime<any>;
+    enabledBlocks?: readonly string[];
     slashState: SlashState | null;
     selectionBubbleState: SelectionBubbleState | null;
 };
@@ -206,8 +193,6 @@ type OpenEditorReactExtension = {
     blockHandle?: "self" | "nested";
     /** Discovery metadata shared by slash menus and host-owned block pickers. */
     insertMenu?: false | OpenEditorExtensionMenu;
-    /** @deprecated Use `insertMenu`. */
-    slashMenu?: false | OpenEditorExtensionMenu;
     viewer: OpenEditorViewerRenderer;
     exporters?: OpenEditorExporters;
 };
@@ -234,7 +219,15 @@ declare module "@tiptap/core" {
     }
 }
 declare const formatAttachmentSize: (size: number | null) => string;
-declare const useOpenEditorController: ({ initialDocument, editable, placeholder, onChange, onFilePasteDrop, pageRuntime, attachmentRuntime, slashMenuItems, extensions, blockActions, }?: OpenEditorReactProps) => OpenEditorController;
+type OpenEditorPageHeaderProps = {
+    page: OpenEditorPageSnapshot;
+    runtime: OpenEditorPageRuntime;
+    className?: string;
+    onPageChange?: (page: OpenEditorPageSnapshot) => void;
+};
+/** Canonical Notion-style page metadata editor shared by host page surfaces. */
+declare const OpenEditorPageHeader: ({ page, runtime, className, onPageChange, }: OpenEditorPageHeaderProps) => react.JSX.Element;
+declare const useOpenEditorController: ({ initialDocument, editable, placeholder, onChange, onFilePasteDrop, pageRuntime, attachmentRuntime, enabledBlocks, slashMenuItems, extensions, blockActions, }?: OpenEditorReactProps) => OpenEditorController;
 declare const useOpenEditorBlockInteraction: (controller: OpenEditorController) => OpenEditorBlockInteractionSnapshot;
 type OpenEditorBlockDragHandleProps = {
     controller: OpenEditorController;
@@ -258,6 +251,6 @@ declare const getDefaultBlockPickerItems: (controller: OpenEditorController) =>
 declare const getDefaultSlashMenuItems: (controller: OpenEditorController) => OpenEditorSlashMenuItem[];
 declare const OpenEditorContent: ({ controller, className, }: OpenEditorContentProps) => react.JSX.Element;
 declare const OpenEditorViewer: ({ document, className, renderers, extensions, pageRuntime, attachmentRuntime, }: OpenEditorViewerProps) => react.JSX.Element;
-declare const useOpenEditor: ({ initialDocument, editable, placeholder, onChange, onFilePasteDrop, pageRuntime, attachmentRuntime, slashMenuItems, extensions, blockActions, }?: OpenEditorReactProps) => OpenEditorController;
+declare const useOpenEditor: ({ initialDocument, editable, placeholder, onChange, onFilePasteDrop, pageRuntime, attachmentRuntime, enabledBlocks, slashMenuItems, extensions, blockActions, }?: OpenEditorReactProps) => OpenEditorController;
 
-export { type InsertRange, type OpenEditorBlockAction, type OpenEditorBlockActionContext, OpenEditorBlockDragHandle, type OpenEditorBlockDragHandleProps, type OpenEditorBlockPickerItem, OpenEditorContent, type OpenEditorContentProps, type OpenEditorController, type OpenEditorExtensionMenu, type OpenEditorOverlayRect, type OpenEditorPageRuntime, type OpenEditorPageSnapshot, type OpenEditorReactConfig, type OpenEditorReactExtension, type OpenEditorReactNodeExtension, type OpenEditorReactProps, type OpenEditorSlashMenuIcon, type OpenEditorSlashMenuIconProps, type OpenEditorSlashMenuItem, type OpenEditorTheme, OpenEditorThemeProvider, type OpenEditorThemeStyle, type OpenEditorThemeToken, OpenEditorViewer, type OpenEditorViewerProps, type OpenEditorViewerRenderer, type SelectionBubbleState, type SlashState, createOpenEditorThemeStyle, defineOpenEditorReactExtension, defineOpenEditorReactNode, formatAttachmentSize, getDefaultBlockPickerItems, getDefaultSlashMenuItems, openEditorThemeTokenNames, sortBlockPickerItems, sortSlashMenuItems, useOpenEditor, useOpenEditorBlockInteraction, useOpenEditorController, useOpenEditorThemeStyle };
+export { type InsertRange, type OpenEditorBlockAction, type OpenEditorBlockActionContext, OpenEditorBlockDragHandle, type OpenEditorBlockDragHandleProps, type OpenEditorBlockPickerItem, OpenEditorContent, type OpenEditorContentProps, type OpenEditorController, type OpenEditorExtensionMenu, type OpenEditorOverlayRect, OpenEditorPageHeader, type OpenEditorPageHeaderProps, type OpenEditorReactConfig, type OpenEditorReactExtension, type OpenEditorReactNodeExtension, type OpenEditorReactProps, type OpenEditorSlashMenuIcon, type OpenEditorSlashMenuIconProps, type OpenEditorSlashMenuItem, type OpenEditorTheme, OpenEditorThemeProvider, type OpenEditorThemeStyle, type OpenEditorThemeToken, OpenEditorViewer, type OpenEditorViewerProps, type OpenEditorViewerRenderer, type SelectionBubbleState, type SlashState, createOpenEditorThemeStyle, defineOpenEditorReactExtension, defineOpenEditorReactNode, formatAttachmentSize, getDefaultBlockPickerItems, getDefaultSlashMenuItems, openEditorThemeTokenNames, sortBlockPickerItems, sortSlashMenuItems, useOpenEditor, useOpenEditorBlockInteraction, useOpenEditorController, useOpenEditorThemeStyle };

package/dist/index.js

@@ -1,11 +1,11 @@
-import { DEFAULT_CALLOUT_EMOJI, normalizeEmoji, DEFAULT_PAGE_EMOJI, normalizeDocument, toProseMirrorDocument, createDocument as createDocument$1, createBlockRegistry, OPENEDITOR_BLOCK_ID_ATTR, createBlockId, fromProseMirrorDocument, findBlockSpecForNode } from '@openeditor/core';
+import { DEFAULT_CALLOUT_EMOJI, normalizeEmoji, DEFAULT_PAGE_EMOJI, normalizeDocument, toProseMirrorDocument, createDocument as createDocument$1, isOpenEditorBlockEnabled, createBlockRegistry, OPENEDITOR_BLOCK_ID_ATTR, createBlockId, fromProseMirrorDocument, findBlockSpecForNode } from '@openeditor/core';
 import { Checkbox } from '@base-ui/react/checkbox';
 import { shift as shift$1, autoUpdate, computePosition } from '@floating-ui/dom';
 import { OpenEditorEmojiPicker } from '@openeditor/emoji';
-import React, { createContext, forwardRef, useContext, useMemo, createRef, memo, createElement, version, useState, useRef, useEffect, useSyncExternalStore as useSyncExternalStore$1, useCallback, use, useDebugValue, Fragment as Fragment$2, useLayoutEffect } from 'react';
+import React, { createContext, forwardRef, useContext, useMemo, createRef, memo, createElement, version, useState, useEffect, useRef, useSyncExternalStore as useSyncExternalStore$1, useCallback, use, useDebugValue, Fragment as Fragment$2, useLayoutEffect } from 'react';
 import { jsxs, Fragment as Fragment$1, jsx } from 'react/jsx-runtime';
 import { renderMermaidSVG } from 'beautiful-mermaid';
-import { toExportBundle } from '@openeditor/exporters';
+import { exportDocumentUnsafe, exportDocument } from '@openeditor/exporters';
 import { openEditorInsertPresets, resolveOpenEditorInsertBlock, defaultBlockRegistry } from '@openeditor/extensions';
 export { seedDocument } from '@openeditor/extensions';
 import ReactDOM, { flushSync, createPortal } from 'react-dom';
@@ -31524,11 +31524,12 @@ var OpenEditorPageNodeView = ({ editor, node, updateAttributes: updateAttributes
   };
   const updateIcon = async (nextIcon) => {
     updateAttributes2({ icon: nextIcon });
-    if (!page?.pageId || !runtime?.updatePageIcon) return;
+    if (!page?.pageId || !runtime) return;
     setResolvedPage({ ...page, icon: nextIcon });
     setError(null);
     try {
-      await runtime.updatePageIcon(page.pageId, nextIcon);
+      const updated = await runtime.updatePage(page.pageId, { icon: nextIcon });
+      if (updated) setResolvedPage(updated);
     } catch (cause) {
       setError(cause instanceof Error ? cause.message : "Could not update the page icon.");
     }
@@ -31557,7 +31558,7 @@ var OpenEditorPageNodeView = ({ editor, node, updateAttributes: updateAttributes
           OpenEditorEmojiPicker,
           {
             className: "oe-page-icon-trigger",
-            disabled: !editor.isEditable,
+            disabled: !editor.isEditable || !runtime,
             emoji: icon,
             label: "Change page emoji",
             popupStyle: themeStyle,
@@ -31626,6 +31627,61 @@ var OpenEditorPageViewer = ({ node }) => {
   }
   return /* @__PURE__ */ jsx("div", { className: "oe-page oe-page-viewer", children: content });
 };
+var OpenEditorPageHeader = ({
+  page,
+  runtime,
+  className = "oe-page-header",
+  onPageChange
+}) => {
+  const [title, setTitle] = useState(page.title);
+  const [icon, setIcon] = useState(normalizeEmoji(page.icon, DEFAULT_PAGE_EMOJI));
+  const [error, setError] = useState(null);
+  useEffect(() => setTitle(page.title), [page.pageId, page.title]);
+  useEffect(() => setIcon(normalizeEmoji(page.icon, DEFAULT_PAGE_EMOJI)), [page.icon, page.pageId]);
+  const updatePage = async (update) => {
+    setError(null);
+    try {
+      const resolved = await runtime.updatePage(page.pageId, update);
+      const next = resolved ?? { ...page, ...update };
+      setTitle(next.title);
+      setIcon(normalizeEmoji(next.icon, DEFAULT_PAGE_EMOJI));
+      onPageChange?.(next);
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : "Could not update the page.");
+    }
+  };
+  return /* @__PURE__ */ jsxs("header", { className: `oe-page-header${className === "oe-page-header" ? "" : ` ${className}`}`, children: [
+    /* @__PURE__ */ jsx(
+      OpenEditorEmojiPicker,
+      {
+        emoji: icon,
+        label: "Change page icon",
+        onEmojiSelect: (nextIcon) => {
+          setIcon(nextIcon);
+          void updatePage({ icon: nextIcon });
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        "aria-label": "Page title",
+        className: "oe-page-header-title",
+        onBlur: () => {
+          const nextTitle = title.trim() || "Untitled";
+          setTitle(nextTitle);
+          if (nextTitle !== page.title) void updatePage({ title: nextTitle });
+        },
+        onChange: (event) => setTitle(event.target.value),
+        onKeyDown: (event) => {
+          if (event.key === "Enter") event.currentTarget.blur();
+        },
+        value: title
+      }
+    ),
+    error ? /* @__PURE__ */ jsx("span", { className: "oe-page-error", role: "alert", children: error }) : null
+  ] });
+};
 var MermaidPreview = ({ code }) => {
   const rendered = useMemo(() => {
     try {
@@ -31698,7 +31754,7 @@ var MermaidDiagram = Node3.create({
     return ReactNodeViewRenderer(OpenEditorDiagramNodeView);
   }
 });
-var createEditorExtensions = (placeholder, customExtensions) => [
+var createEditorExtensions = (getPlaceholder, customExtensions) => [
   index_default12.configure({
     attributeName: OPENEDITOR_BLOCK_ID_ATTR,
     types: "all",
@@ -31719,7 +31775,7 @@ var createEditorExtensions = (placeholder, customExtensions) => [
   index_default6,
   index_default5,
   index_default10.configure({ types: ["heading", "paragraph"] }),
-  index_default4.configure({ placeholder, showOnlyCurrent: true }),
+  index_default4.configure({ placeholder: () => getPlaceholder(), showOnlyCurrent: true }),
   Columns,
   Column,
   ToggleList,
@@ -31825,12 +31881,12 @@ var useOpenEditorController = ({
   onFilePasteDrop,
   pageRuntime,
   attachmentRuntime,
+  enabledBlocks,
   slashMenuItems = [],
   extensions = EMPTY_EXTENSIONS,
   blockActions = []
 } = {}) => {
   const [document2, setDocument] = useState(() => normalizeDocument(initialDocument));
-  const [initialEditorContent] = useState(() => toProseMirrorDocument(document2));
   const [selectedBlock, setSelectedBlock] = useState("paragraph");
   const [slashState, setSlashState] = useState(null);
   const [selectionBubbleState, setSelectionBubbleState] = useState(null);
@@ -31839,12 +31895,29 @@ var useOpenEditorController = ({
   const slashStateRef = useRef(null);
   const selectionBubbleStateRef = useRef(null);
   const documentMetaRef = useRef(document2.meta);
+  const placeholderRef = useRef(placeholder);
+  placeholderRef.current = placeholder;
+  const onChangeRef = useRef(onChange);
+  onChangeRef.current = onChange;
+  const onFilePasteDropRef = useRef(onFilePasteDrop);
+  onFilePasteDropRef.current = onFilePasteDrop;
+  const isBlockEnabled = (blockName) => {
+    const canonicalName = /^heading[1-6]$/.test(blockName) ? "heading" : blockName;
+    if (!isOpenEditorBlockEnabled(canonicalName, { enabledBlocks })) return false;
+    if (canonicalName === "attachment") {
+      return Boolean(attachmentRuntime?.selectAttachment && attachmentRuntime.uploadAttachment);
+    }
+    if (canonicalName === "page") return Boolean(pageRuntime?.createPage);
+    return true;
+  };
+  const isBlockEnabledRef = useRef(isBlockEnabled);
+  isBlockEnabledRef.current = isBlockEnabled;
   const registry = useMemo(() => createReactBlockRegistry(extensions), [extensions]);
   const exporters = useMemo(() => createReactExporters(extensions), [extensions]);
   const editor = useEditor({
     immediatelyRender: false,
-    extensions: createEditorExtensions(placeholder, extensions),
-    content: initialEditorContent,
+    extensions: createEditorExtensions(() => placeholderRef.current, extensions),
+    content: toProseMirrorDocument(document2),
     editable,
     editorProps: {
       attributes: {
@@ -31861,6 +31934,12 @@ var useOpenEditorController = ({
           try {
             const payload = JSON.parse(encoded);
             if (payload.format === "openeditor-blocks" && payload.version === 1 && Array.isArray(payload.blocks)) {
+              const firstBlock = payload.blocks[0];
+              const blockName = firstBlock ? findBlockSpecForNode(registry, firstBlock)?.name : void 0;
+              if (blockName && !isBlockEnabledRef.current(blockName)) {
+                event.preventDefault();
+                return true;
+              }
               const nodes = payload.blocks.map(
                 (node) => view.state.schema.nodeFromJSON(regenerateClipboardNodeIds(node))
               );
@@ -31877,7 +31956,7 @@ var useOpenEditorController = ({
           }
         }
         const file = event.clipboardData?.files?.[0];
-        if (!file || !onFilePasteDrop?.(file)) {
+        if (!file || !isBlockEnabledRef.current("attachment") || !onFilePasteDropRef.current?.(file)) {
           return false;
         }
         event.preventDefault();
@@ -31885,7 +31964,7 @@ var useOpenEditorController = ({
       },
       handleDrop: (_view, event, _slice, moved) => {
         const file = event.dataTransfer?.files?.[0];
-        if (moved || !file || !onFilePasteDrop?.(file)) {
+        if (moved || !file || !isBlockEnabledRef.current("attachment") || !onFilePasteDropRef.current?.(file)) {
           return false;
         }
         event.preventDefault();
@@ -31907,7 +31986,7 @@ var useOpenEditorController = ({
         documentMetaRef.current
       );
       setDocument(nextDocument);
-      onChange?.(nextDocument);
+      onChangeRef.current?.(nextDocument);
       setSlashState(getSlashState(currentEditor));
       setSelectionBubbleState(
         isPointerSelectingRef.current ? null : getSelectionBubbleState(currentEditor)
@@ -31923,10 +32002,12 @@ var useOpenEditorController = ({
       }
     }
   }, [extensions]);
-  const exports = useMemo(
-    () => toExportBundle(document2, exporters),
-    [document2, exporters]
-  );
+  useEffect(() => {
+    editor?.setEditable(editable, false);
+  }, [editable, editor]);
+  useEffect(() => {
+    if (editor && !editor.isDestroyed) editor.view.dispatch(editor.state.tr);
+  }, [editor, placeholder]);
   useEffect(() => {
     slashStateRef.current = slashState;
   }, [slashState]);
@@ -31975,7 +32056,7 @@ var useOpenEditorController = ({
     };
   }, [editor]);
   const insertBlock = (blockName = selectedBlock, range) => {
-    if (!editor) {
+    if (!editor || !isBlockEnabled(blockName)) {
       return false;
     }
     const block = resolveOpenEditorInsertBlock(blockName, registry);
@@ -31985,14 +32066,14 @@ var useOpenEditorController = ({
       return range ? commandChain.deleteRange(range) : commandChain;
     };
     if (blockName === "page" && pageRuntime?.createPage) {
-      const prepared = chain().run();
-      if (!prepared) return false;
       setSlashState(null);
       void pageRuntime.createPage({
         title: "Untitled",
         icon: DEFAULT_PAGE_EMOJI
       }).then((created) => {
-        editor.chain().focus().insertContent({
+        const insertion = editor.chain().focus();
+        const prepared = range ? insertion.deleteRange(range) : insertion;
+        prepared.insertContent({
           ...block,
           attrs: {
             ...block.attrs,
@@ -32002,9 +32083,7 @@ var useOpenEditorController = ({
           },
           content: [{ type: "text", text: created.title || "Untitled" }]
         }).run();
-      }).catch(() => {
-        editor.chain().focus().insertContent(block).run();
-      });
+      }).catch(() => void 0);
       return true;
     }
     const inserted = chain().insertContent(block).run();
@@ -32017,7 +32096,9 @@ var useOpenEditorController = ({
     }
     const normalized = normalizeDocument(nextDocument);
     documentMetaRef.current = normalized.meta;
-    editor.commands.setContent(toProseMirrorDocument(normalized));
+    editor.commands.setContent(toProseMirrorDocument(normalized), { emitUpdate: false });
+    setDocument(normalized);
+    onChangeRef.current?.(normalized);
   };
   const resolveBlock = (block) => block ?? (editor ? selectedBlockRef(editor, registry) : null);
   const resolveBlockAt = (position) => editor ? blockRefAtPosition(editor, position, registry) : null;
@@ -32091,10 +32172,10 @@ var useOpenEditorController = ({
     editor.chain().focus().extendMarkRange("link").setLink({ href: url }).run();
   };
   const setParagraph = () => {
-    editor?.chain().focus().setParagraph().run();
+    if (isBlockEnabled("paragraph")) editor?.chain().focus().setParagraph().run();
   };
   const toggleHeading = (level) => {
-    editor?.chain().focus().toggleHeading({ level }).run();
+    if (isBlockEnabled("heading")) editor?.chain().focus().toggleHeading({ level }).run();
   };
   const toggleBold = () => {
     editor?.chain().focus().toggleBold().run();
@@ -32112,19 +32193,19 @@ var useOpenEditorController = ({
     editor?.chain().focus().toggleCode().run();
   };
   const toggleBulletList = () => {
-    editor?.chain().focus().toggleBulletList().run();
+    if (isBlockEnabled("bulletList")) editor?.chain().focus().toggleBulletList().run();
   };
   const toggleOrderedList = () => {
-    editor?.chain().focus().toggleOrderedList().run();
+    if (isBlockEnabled("orderedList")) editor?.chain().focus().toggleOrderedList().run();
   };
   const toggleTaskList = () => {
-    editor?.chain().focus().toggleTaskList().run();
+    if (isBlockEnabled("taskList")) editor?.chain().focus().toggleTaskList().run();
   };
   const toggleBlockquote = () => {
-    editor?.chain().focus().toggleBlockquote().run();
+    if (isBlockEnabled("blockquote")) editor?.chain().focus().toggleBlockquote().run();
   };
   const toggleCodeBlock = () => {
-    editor?.chain().focus().toggleCodeBlock().run();
+    if (isBlockEnabled("codeBlock")) editor?.chain().focus().toggleCodeBlock().run();
   };
   const undo2 = () => {
     editor?.chain().focus().undo().run();
@@ -32135,7 +32216,8 @@ var useOpenEditorController = ({
   const controller = {
     document: document2,
     editor,
-    exports,
+    export: (format) => exportDocument(document2, format),
+    exportUnsafe: (format) => exportDocumentUnsafe(document2, format, exporters),
     ready: editor !== null,
     editable,
     placeholder,
@@ -32158,6 +32240,7 @@ var useOpenEditorController = ({
     undo: undo2,
     redo: redo2,
     insertBlock,
+    isBlockEnabled,
     setLink,
     getActiveLink: () => editor?.getAttributes("link").href,
     selectBlock,
@@ -32178,6 +32261,7 @@ var useOpenEditorController = ({
     extensions,
     pageRuntime,
     attachmentRuntime,
+    enabledBlocks,
     slashState,
     selectionBubbleState
   };
@@ -32402,9 +32486,9 @@ var sortMenuItems = (items) => [...items].sort((left, right) => {
 });
 var sortSlashMenuItems = (items) => sortMenuItems(items);
 var sortBlockPickerItems = (items) => sortMenuItems(items);
-var getExtensionInsertMenu = (extension) => extension.insertMenu ?? extension.slashMenu;
+var getExtensionInsertMenu = (extension) => extension.insertMenu;
 var getDefaultBlockPickerItems = (controller) => sortBlockPickerItems([
-  ...openEditorInsertPresets.map((preset, index) => ({
+  ...openEditorInsertPresets.filter((preset) => controller.isBlockEnabled(preset.key)).map((preset, index) => ({
     key: preset.key,
     label: preset.label,
     group: preset.group,
@@ -32412,7 +32496,7 @@ var getDefaultBlockPickerItems = (controller) => sortBlockPickerItems([
     order: (index + 1) * 100,
     insert: () => controller.insertBlock(preset.key)
   })),
-  ...controller.extensions.filter((extension) => getExtensionInsertMenu(extension) !== false).map((extension) => {
+  ...controller.extensions.filter((extension) => getExtensionInsertMenu(extension) !== false && controller.isBlockEnabled(extension.block.name)).map((extension) => {
     const menu = getExtensionInsertMenu(extension) || void 0;
     return {
       key: extension.block.name,
@@ -32428,7 +32512,7 @@ var getDefaultBlockPickerItems = (controller) => sortBlockPickerItems([
 var getDefaultSlashMenuItems = (controller) => {
   const internalController = controller;
   return sortSlashMenuItems([
-    ...openEditorInsertPresets.map((preset, index) => ({
+    ...openEditorInsertPresets.filter((preset) => controller.isBlockEnabled(preset.key)).map((preset, index) => ({
       key: preset.key,
       label: preset.label,
       group: preset.group,
@@ -32460,7 +32544,7 @@ var getDefaultSlashMenuItems = (controller) => {
         return true;
       }
     },
-    ...controller.extensions.filter((extension) => getExtensionInsertMenu(extension) !== false).map((extension) => {
+    ...controller.extensions.filter((extension) => getExtensionInsertMenu(extension) !== false && controller.isBlockEnabled(extension.block.name)).map((extension) => {
       const menu = getExtensionInsertMenu(extension) || void 0;
       return {
         key: extension.block.name,
@@ -32615,6 +32699,6 @@ var OpenEditorViewer = ({
 };
 var useOpenEditor = useOpenEditorController;
 
-export { NodeViewContent, NodeViewWrapper, OpenEditorBlockDragHandle, OpenEditorContent, OpenEditorThemeProvider, OpenEditorViewer, createOpenEditorThemeStyle, defineOpenEditorReactExtension, defineOpenEditorReactNode, formatAttachmentSize, getDefaultBlockPickerItems, getDefaultSlashMenuItems, openEditorThemeTokenNames, sortBlockPickerItems, sortSlashMenuItems, useOpenEditor, useOpenEditorBlockInteraction, useOpenEditorController, useOpenEditorThemeStyle };
+export { NodeViewContent, NodeViewWrapper, OpenEditorBlockDragHandle, OpenEditorContent, OpenEditorPageHeader, OpenEditorThemeProvider, OpenEditorViewer, createOpenEditorThemeStyle, defineOpenEditorReactExtension, defineOpenEditorReactNode, formatAttachmentSize, getDefaultBlockPickerItems, getDefaultSlashMenuItems, openEditorThemeTokenNames, sortBlockPickerItems, sortSlashMenuItems, useOpenEditor, useOpenEditorBlockInteraction, useOpenEditorController, useOpenEditorThemeStyle };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map