@domternal/core 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -1399,6 +1399,7 @@ interface ExtensionEditor {
     readonly view: EditorView;
     readonly schema: unknown;
     readonly commands: SingleCommands;
+    readonly isEditable: boolean;
 }
 /**
  * Any extension type (forward declaration)
@@ -2392,8 +2393,18 @@ declare const lift: CommandSpec;
  * @param listNodeName - The name of the list node type (e.g., 'bulletList', 'orderedList')
  * @param listItemNodeName - The name of the list item node type (usually 'listItem')
  * @param attributes - Optional attributes for the list node
- */
-declare const toggleList: CommandSpec<[listNodeName: string, listItemNodeName: string, attributes?: Attrs]>;
+ * @param options - `perItem: true` converts ONLY the cursor's item (Notion
+ *   turn-into via slash / block menu); the default whole-list toggle is what the
+ *   toolbar button and Mod-Shift shortcut use.
+ */
+declare const toggleList: CommandSpec<[
+    listNodeName: string,
+    listItemNodeName: string,
+    attributes?: Attrs,
+    options?: {
+        perItem?: boolean;
+    }
+]>;
 
 /**
  * Attribute commands - updateAttributes, resetAttributes
@@ -2446,7 +2457,14 @@ declare module '@domternal/core' {
         wrapIn: CommandSpec<[nodeName: string, attributes?: Attrs]>;
         toggleWrap: CommandSpec<[nodeName: string, attributes?: Attrs]>;
         lift: CommandSpec;
-        toggleList: CommandSpec<[listNodeName: string, listItemNodeName: string, attributes?: Attrs]>;
+        toggleList: CommandSpec<[
+            listNodeName: string,
+            listItemNodeName: string,
+            attributes?: Attrs,
+            options?: {
+                perItem?: boolean;
+            }
+        ]>;
         insertContent: CommandSpec<[content: Content]>;
         selectNodeBackward: CommandSpec;
         updateAttributes: CommandSpec<[typeOrName: string, attributes: Record<string, unknown>]>;
@@ -2553,6 +2571,14 @@ interface PositionFloatingOptions {
     padding?: number;
     /** Track ancestor scroll events. Disable for static anchors (e.g. toolbar buttons). @default true */
     trackScroll?: boolean;
+    /**
+     * Clipping boundary for flip/shift overflow detection. Defaults to the
+     * floating-ui clipping ancestors (overflow containers plus viewport).
+     * Since the theme stopped clipping `.dm-editor` itself, floats that must
+     * stay inside the editor box (e.g. the table cell toolbar, which would
+     * otherwise cover app chrome above the editor) pass the wrapper here.
+     */
+    boundary?: Element;
 }
 /**
  * Positions a floating element relative to a reference element or virtual rect,
@@ -3957,6 +3983,87 @@ declare class FloatingMenuController {
     private updateDisabledStates;
 }
 
+declare const floatingMenuPluginKey: PluginKey<any>;
+/** Default visibility: cursor at the start of an empty `paragraph` in an editable editor. */
+declare function defaultFloatingMenuShouldShow({ editor, state, }: {
+    editor: Editor;
+    view: EditorView;
+    state: EditorState;
+}): boolean;
+/**
+ * Keyboard shortcuts to move focus from the editor into the menu. Defaults
+ * pair the WAI-ARIA `Alt-F10` with `Mod-/`; empty array disables keyboard entry.
+ */
+interface FloatingMenuKeymap {
+    /** Shortcuts that focus the first menu item when the menu is visible. */
+    enterMenu?: string[];
+}
+interface FloatingMenuOptions {
+    /**
+     * The HTML element that contains the menu. Required when used directly;
+     * framework wrappers create this element and pass it in.
+     */
+    element: HTMLElement | null;
+    /**
+     * Visibility predicate. Defaults to `defaultFloatingMenuShouldShow` (empty
+     * paragraph at cursor start).
+     */
+    shouldShow: (props: {
+        editor: Editor;
+        view: EditorView;
+        state: EditorState;
+    }) => boolean;
+    /**
+     * Pixel offset from the anchor. @default 0
+     */
+    offset: number;
+    /**
+     * Items override. Array replaces defaults entirely; function receives the
+     * collected defaults and returns a new list. Consumed by the controller;
+     * the plugin reads it only when the wrapper doesn't build its own controller.
+     */
+    items?: FloatingMenuItemsOverride;
+    /** Keyboard shortcuts for entering the menu via keyboard. */
+    keymap?: FloatingMenuKeymap;
+    /**
+     * When `true`, the menu only opens via `showFloatingMenu(view)` (the gutter
+     * `+` button); pressing Enter into an empty paragraph no longer auto-shows
+     * it. Mirrors Notion: empty rows show a placeholder, `/` is the keyboard trigger.
+     *
+     * @default false (auto-shows on every empty paragraph, backward compat)
+     */
+    requireExplicitTrigger?: boolean;
+}
+interface CreateFloatingMenuPluginOptions {
+    pluginKey: PluginKey;
+    editor: Editor;
+    element: HTMLElement;
+    shouldShow?: FloatingMenuOptions['shouldShow'];
+    offset?: number;
+    keymap?: FloatingMenuKeymap | undefined;
+    requireExplicitTrigger?: boolean;
+}
+/**
+ * Meta key for `showFloatingMenu` / `hideFloatingMenu`. A STRING (not a
+ * PluginKey) so callers don't need a plugin-instance reference: framework
+ * wrappers create per-instance PluginKeys but all read this shared meta.
+ */
+declare const FLOATING_MENU_META = "dm:floatingMenuTrigger";
+/**
+ * Programmatically show the FloatingMenu, used by BlockHandle's `+` button
+ * after inserting a fresh empty paragraph. With `requireExplicitTrigger: true`
+ * this is the only way the menu opens (the `Mod-/` shortcut still focuses an
+ * already-visible menu).
+ */
+declare function showFloatingMenu(view: EditorView): void;
+/** Programmatically hide the FloatingMenu (clears the explicit-trigger flag). */
+declare function hideFloatingMenu(view: EditorView): void;
+/**
+ * Creates the FloatingMenu plugin. Framework wrappers call this directly so
+ * they own element creation and rendering.
+ */
+declare function createFloatingMenuPlugin(options: CreateFloatingMenuPluginOptions): Plugin;
+
 declare const defaultIcons: IconSet;
 
 /**
@@ -4485,6 +4592,7 @@ declare const CodeBlock: Node<CodeBlockOptions, unknown>;
 declare module '@domternal/core' {
     interface RawCommands {
         toggleBulletList: CommandSpec;
+        turnIntoBulletList: CommandSpec;
     }
 }
 interface BulletListOptions {
@@ -4503,6 +4611,7 @@ declare const BulletList: Node<BulletListOptions, unknown>;
 declare module '@domternal/core' {
     interface RawCommands {
         toggleOrderedList: CommandSpec;
+        turnIntoOrderedList: CommandSpec;
     }
 }
 interface OrderedListOptions {
@@ -4577,6 +4686,7 @@ declare const HardBreak: Node<HardBreakOptions, unknown>;
 declare module '@domternal/core' {
     interface RawCommands {
         toggleTaskList: CommandSpec;
+        turnIntoTaskList: CommandSpec;
     }
 }
 interface TaskListOptions {
@@ -5317,8 +5427,8 @@ declare const ListKeymap: Extension<ListKeymapOptions, unknown>;
 /**
  * Keyboard indent across list boundaries. `Tab` on a top-level block whose
  * previous sibling is a list moves the block INTO the last item as a nested
- * child; `Shift-Tab` reverses for a block sitting as the last child of the
- * last item.
+ * child; `Shift-Tab` lifts the last child of a list item back out to a
+ * top-level sibling, splitting the list when that item is not the last one.
  *
  * Trigger is intentionally narrow so ListKeymap retains in-list Tab/Shift-Tab
  * (`sinkListItem` / `liftListItem`). Schema is validated via `canReplaceWith`;
@@ -5330,9 +5440,9 @@ declare const ListKeymap: Extension<ListKeymapOptions, unknown>;
  *    inside the now-nested context (then ListKeymap takes over).
  *  - Tab only fires for cursors in TOP-LEVEL blocks (depth === 1). Cursors
  *    inside other containers (blockquote, table cell) fall through.
- *  - Shift-Tab only fires when the block is BOTH the last child of its
- *    item AND the item is the last in its wrapper. Mid-position outdent
- *    would require splitting the list item, which is deferred.
+ *  - Shift-Tab fires for the LAST child of a list item; a non-last item is
+ *    split so the parent survives (Notion parity). Mid children-zone blocks
+ *    are still deferred.
  *
  * Registration order: must come AFTER ListKeymap so this extension's keymap
  * runs FIRST and can defer to ListKeymap for in-list flows.
@@ -5347,10 +5457,9 @@ declare const ListKeymap: Extension<ListKeymapOptions, unknown>;
  */
 declare function indentBlockAsListChild(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
 /**
- * `Shift-Tab` handler: lift a non-label nested block out of its list
- * item to become a top-level sibling AFTER the list wrapper. Only
- * fires for the strict end-of-end case (last child of last item) so
- * the lift is deterministic and never needs to split a list item.
+ * `Shift-Tab` handler: lift the last child of a list item out to a
+ * top-level sibling. Lands after the whole list when the item is last
+ * in its wrapper, else splits the wrapper and lands between the halves.
  *
  * Precondition table:
  *   - cursor empty
@@ -5363,7 +5472,6 @@ declare function indentBlockAsListChild(state: EditorState, dispatch?: (tr: Tran
  *     immediate li children rather than reaching deeper into nested
  *     containers
  *   - the block is the LAST child of the list item
- *   - the list item is the LAST child of its wrapper
  *   - the wrapper's parent accepts the block as a sibling (schema)
  */
 declare function outdentBlockFromListItem(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
@@ -6351,4 +6459,4 @@ declare const StarterKit: Extension<StarterKitOptions, unknown>;
  */
 declare const VERSION = "0.1.0";
 
-export { type AnyExtension, type AnyExtensionConfig, type AttributeSpec, type AttributeSpecs, type AutolinkPluginOptions, BaseKeymap, type BaseKeymapOptions, BlockColor, type BlockColorOptions, Blockquote, type BlockquoteOptions, Bold, type BoldOptions, BubbleMenu, type BubbleMenuOptions, type BuildCommandPropsOptions, BulletList, type BulletListOptions, type CanChainedCommands, CanChecker, type CanCheckerEditor, type CanCheckerOptions, type CanCommands, ChainBuilder, type ChainBuilderEditor, type ChainBuilderOptions, type ChainFailure, type ChainedCommands, CharacterCount, type CharacterCountOptions, type CharacterCountStorage, type ClearContentOptions, ClearFormatting, Code, CodeBlock, type CodeBlockOptions, type CodeOptions, type Command, type CommandEditor, CommandManager, type CommandManagerEditor, type CommandMap, type CommandProps, type CommandPropsEditor, type CommandSpec, type Content, type ContentErrorProps, type CreateBubbleMenuPluginOptions, type CreateDocumentOptions, type CreateEventProps, DEFAULT_BLOCK_COLORS, DEFAULT_BLOCK_COLOR_TYPES, DEFAULT_HIGHLIGHT_COLORS, DEFAULT_NOTION_COLOR_PALETTE, DEFAULT_TEXT_COLORS, type DeleteEventProps, Document$1 as Document, type DropEventProps, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, EventEmitter, Extension, type ExtensionConfig, type ExtensionEditor, ExtensionManager, type ExtensionManagerEditor, type ExtensionManagerOptions, FLOATING_MENU_NO_FOCUS, type FindChildResult, type FindParentNodeResult, FloatingMenuController, type FloatingMenuGroup, type FloatingMenuItem, type FloatingMenuItemsOverride, Focus, type FocusEventProps, type FocusOptions, type FocusPosition, FontFamily, type FontFamilyOptions, FontSize, type FontSizeOptions, Gapcursor, type GenerateHTMLOptions, type GenerateJSONOptions, type GenerateTextOptions, type GlobalAttributeSpec, type GlobalAttributes, HardBreak, type HardBreakOptions, Heading, type HeadingOptions, Highlight, type HighlightOptions, History, type HistoryOptions, HorizontalRule, type HorizontalRuleOptions, type IconSet, type InlineStyleOverrides, type InsertAsListItemChildArgs, type InsertAsListItemChildResult, InvisibleChars, type InvisibleCharsOptions, type InvisibleCharsStorage, type IsNodeEmptyOptions, type IsValidUrlOptions, Italic, type ItalicOptions, type JSONAttribute, type JSONContent, type JSONMark, type KeyboardShortcutCommand, LIST_ITEM_TYPE_NAMES, LineHeight, type LineHeightOptions, Link, type LinkAttributes, type LinkClickPluginOptions, type LinkExitPluginOptions, type LinkOptions, type LinkPastePluginOptions, LinkPopover, type LinkPopoverOptions, ListIndent, ListItem, type ListItemCursorContext, type ListItemOptions, ListKeymap, type ListKeymapOptions, Mark, type MarkConfig, type MarkInputRuleOptions, type MarkParseRule, type MarkRange, type MarkRenderHTMLProps, type MountEventProps, Node, type NodeConfig, type NodeInputRuleOptions, type NodeParseRule, type NodeRenderHTMLProps, type NodeViewContext, NotionColorPicker, type NotionColorPickerOptions, type NotionColorPickerStorage, OrderedList, type OrderedListOptions, Paragraph, type ParagraphOptions, type PasteEventProps, Placeholder, type PlaceholderOptions, type PositionFloatingOptions, type Range, type RawCommands, Selection, SelectionDecoration, type SelectionDecorationOptions, type SelectionOptions, type SelectionStorage, type SetContentOptions, type SingleCommands, type SplitListForInsertRange, StarterKit, type StarterKitOptions, Strike, type StrikeOptions, Subscript, type SubscriptOptions, Superscript, type SuperscriptOptions, TaskItem, type TaskItemOptions, TaskList, type TaskListOptions, Text, TextAlign, type TextAlignOptions, TextColor, type TextColorOptions, type TextInputRuleOptions, TextStyle, type TextStyleOptions, type TextblockTypeInputRuleOptions, type ToolbarButton, ToolbarController, type ToolbarControllerEditor, type ToolbarDropdown, type ToolbarGroup, type ToolbarItem, type ToolbarLayoutDropdown, type ToolbarLayoutEntry, type ToolbarSeparator, TrailingNode, type TrailingNodeOptions, type TransactionEventProps, Typography, type TypographyOptions, Underline, type UnderlineOptions, UniqueID, type UniqueIDOptions, VERSION, type WrappingInputRuleOptions, applyInlineStyles, autolinkPlugin, autolinkPluginKey, blur, bubbleMenuPluginKey, buildCommandProps, builtInCommands, callOrReturn, characterCountPluginKey, clearContent, copyThemeClass, createAccumulatingDispatch, createBubbleMenuPlugin, createCanChecker, createChainBuilder, createDocument, defaultBlockAt, defaultBubbleContexts, defaultIcons, deleteSelection, findChildren, findListItemAncestorDepth, findParentNode, focus, focusPluginKey, generateHTML, generateJSON, generateText, getListItemCursorContext, getMarkRange, groupFloatingMenuItems, indentBlockAsListChild, inlineStyles, insertAsListItemChild, insertChildrenZoneSibling, insertContent, insertText, invisibleCharsPluginKey, isDocumentEmpty, isInListItemLabel, isInsideListItem, isNodeEmpty, isValidUrl, lift, liftCurrentListItem, liftEmptyChildrenZoneParagraph, linkClickPlugin, linkClickPluginKey, linkExitPlugin, linkExitPluginKey, linkPastePlugin, linkPastePluginKey, markInputRule, markInputRulePatterns, nodeInputRule, outdentBlockFromListItem, placeholderPluginKey, positionFloating, positionFloatingOnce, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, splitListForInsert, stripInlineColorConflicts, textInputRule, textblockTypeInputRule, toggleBlockType, toggleList, toggleMark, toggleWrap, uniqueIDPluginKey, unsetAllMarks, unsetMark, updateAttributes, wrapIn, wrappingInputRule, writeToClipboard };
+export { type AnyExtension, type AnyExtensionConfig, type AttributeSpec, type AttributeSpecs, type AutolinkPluginOptions, BaseKeymap, type BaseKeymapOptions, BlockColor, type BlockColorOptions, Blockquote, type BlockquoteOptions, Bold, type BoldOptions, BubbleMenu, type BubbleMenuOptions, type BuildCommandPropsOptions, BulletList, type BulletListOptions, type CanChainedCommands, CanChecker, type CanCheckerEditor, type CanCheckerOptions, type CanCommands, ChainBuilder, type ChainBuilderEditor, type ChainBuilderOptions, type ChainFailure, type ChainedCommands, CharacterCount, type CharacterCountOptions, type CharacterCountStorage, type ClearContentOptions, ClearFormatting, Code, CodeBlock, type CodeBlockOptions, type CodeOptions, type Command, type CommandEditor, CommandManager, type CommandManagerEditor, type CommandMap, type CommandProps, type CommandPropsEditor, type CommandSpec, type Content, type ContentErrorProps, type CreateBubbleMenuPluginOptions, type CreateDocumentOptions, type CreateEventProps, type CreateFloatingMenuPluginOptions, DEFAULT_BLOCK_COLORS, DEFAULT_BLOCK_COLOR_TYPES, DEFAULT_HIGHLIGHT_COLORS, DEFAULT_NOTION_COLOR_PALETTE, DEFAULT_TEXT_COLORS, type DeleteEventProps, Document$1 as Document, type DropEventProps, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, EventEmitter, Extension, type ExtensionConfig, type ExtensionEditor, ExtensionManager, type ExtensionManagerEditor, type ExtensionManagerOptions, FLOATING_MENU_META, FLOATING_MENU_NO_FOCUS, type FindChildResult, type FindParentNodeResult, FloatingMenuController, type FloatingMenuGroup, type FloatingMenuItem, type FloatingMenuItemsOverride, type FloatingMenuKeymap, type FloatingMenuOptions, Focus, type FocusEventProps, type FocusOptions, type FocusPosition, FontFamily, type FontFamilyOptions, FontSize, type FontSizeOptions, Gapcursor, type GenerateHTMLOptions, type GenerateJSONOptions, type GenerateTextOptions, type GlobalAttributeSpec, type GlobalAttributes, HardBreak, type HardBreakOptions, Heading, type HeadingOptions, Highlight, type HighlightOptions, History, type HistoryOptions, HorizontalRule, type HorizontalRuleOptions, type IconSet, type InlineStyleOverrides, type InsertAsListItemChildArgs, type InsertAsListItemChildResult, InvisibleChars, type InvisibleCharsOptions, type InvisibleCharsStorage, type IsNodeEmptyOptions, type IsValidUrlOptions, Italic, type ItalicOptions, type JSONAttribute, type JSONContent, type JSONMark, type KeyboardShortcutCommand, LIST_ITEM_TYPE_NAMES, LineHeight, type LineHeightOptions, Link, type LinkAttributes, type LinkClickPluginOptions, type LinkExitPluginOptions, type LinkOptions, type LinkPastePluginOptions, LinkPopover, type LinkPopoverOptions, ListIndent, ListItem, type ListItemCursorContext, type ListItemOptions, ListKeymap, type ListKeymapOptions, Mark, type MarkConfig, type MarkInputRuleOptions, type MarkParseRule, type MarkRange, type MarkRenderHTMLProps, type MountEventProps, Node, type NodeConfig, type NodeInputRuleOptions, type NodeParseRule, type NodeRenderHTMLProps, type NodeViewContext, NotionColorPicker, type NotionColorPickerOptions, type NotionColorPickerStorage, OrderedList, type OrderedListOptions, Paragraph, type ParagraphOptions, type PasteEventProps, Placeholder, type PlaceholderOptions, type PositionFloatingOptions, type Range, type RawCommands, Selection, SelectionDecoration, type SelectionDecorationOptions, type SelectionOptions, type SelectionStorage, type SetContentOptions, type SingleCommands, type SplitListForInsertRange, StarterKit, type StarterKitOptions, Strike, type StrikeOptions, Subscript, type SubscriptOptions, Superscript, type SuperscriptOptions, TaskItem, type TaskItemOptions, TaskList, type TaskListOptions, Text, TextAlign, type TextAlignOptions, TextColor, type TextColorOptions, type TextInputRuleOptions, TextStyle, type TextStyleOptions, type TextblockTypeInputRuleOptions, type ToolbarButton, ToolbarController, type ToolbarControllerEditor, type ToolbarDropdown, type ToolbarGroup, type ToolbarItem, type ToolbarLayoutDropdown, type ToolbarLayoutEntry, type ToolbarSeparator, TrailingNode, type TrailingNodeOptions, type TransactionEventProps, Typography, type TypographyOptions, Underline, type UnderlineOptions, UniqueID, type UniqueIDOptions, VERSION, type WrappingInputRuleOptions, applyInlineStyles, autolinkPlugin, autolinkPluginKey, blur, bubbleMenuPluginKey, buildCommandProps, builtInCommands, callOrReturn, characterCountPluginKey, clearContent, copyThemeClass, createAccumulatingDispatch, createBubbleMenuPlugin, createCanChecker, createChainBuilder, createDocument, createFloatingMenuPlugin, defaultBlockAt, defaultBubbleContexts, defaultFloatingMenuShouldShow, defaultIcons, deleteSelection, findChildren, findListItemAncestorDepth, findParentNode, floatingMenuPluginKey, focus, focusPluginKey, generateHTML, generateJSON, generateText, getListItemCursorContext, getMarkRange, groupFloatingMenuItems, hideFloatingMenu, indentBlockAsListChild, inlineStyles, insertAsListItemChild, insertChildrenZoneSibling, insertContent, insertText, invisibleCharsPluginKey, isDocumentEmpty, isInListItemLabel, isInsideListItem, isNodeEmpty, isValidUrl, lift, liftCurrentListItem, liftEmptyChildrenZoneParagraph, linkClickPlugin, linkClickPluginKey, linkExitPlugin, linkExitPluginKey, linkPastePlugin, linkPastePluginKey, markInputRule, markInputRulePatterns, nodeInputRule, outdentBlockFromListItem, placeholderPluginKey, positionFloating, positionFloatingOnce, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, showFloatingMenu, splitListForInsert, stripInlineColorConflicts, textInputRule, textblockTypeInputRule, toggleBlockType, toggleList, toggleMark, toggleWrap, uniqueIDPluginKey, unsetAllMarks, unsetMark, updateAttributes, wrapIn, wrappingInputRule, writeToClipboard };

package/dist/index.d.ts

@@ -1399,6 +1399,7 @@ interface ExtensionEditor {
     readonly view: EditorView;
     readonly schema: unknown;
     readonly commands: SingleCommands;
+    readonly isEditable: boolean;
 }
 /**
  * Any extension type (forward declaration)
@@ -2392,8 +2393,18 @@ declare const lift: CommandSpec;
  * @param listNodeName - The name of the list node type (e.g., 'bulletList', 'orderedList')
  * @param listItemNodeName - The name of the list item node type (usually 'listItem')
  * @param attributes - Optional attributes for the list node
- */
-declare const toggleList: CommandSpec<[listNodeName: string, listItemNodeName: string, attributes?: Attrs]>;
+ * @param options - `perItem: true` converts ONLY the cursor's item (Notion
+ *   turn-into via slash / block menu); the default whole-list toggle is what the
+ *   toolbar button and Mod-Shift shortcut use.
+ */
+declare const toggleList: CommandSpec<[
+    listNodeName: string,
+    listItemNodeName: string,
+    attributes?: Attrs,
+    options?: {
+        perItem?: boolean;
+    }
+]>;
 
 /**
  * Attribute commands - updateAttributes, resetAttributes
@@ -2446,7 +2457,14 @@ declare module '@domternal/core' {
         wrapIn: CommandSpec<[nodeName: string, attributes?: Attrs]>;
         toggleWrap: CommandSpec<[nodeName: string, attributes?: Attrs]>;
         lift: CommandSpec;
-        toggleList: CommandSpec<[listNodeName: string, listItemNodeName: string, attributes?: Attrs]>;
+        toggleList: CommandSpec<[
+            listNodeName: string,
+            listItemNodeName: string,
+            attributes?: Attrs,
+            options?: {
+                perItem?: boolean;
+            }
+        ]>;
         insertContent: CommandSpec<[content: Content]>;
         selectNodeBackward: CommandSpec;
         updateAttributes: CommandSpec<[typeOrName: string, attributes: Record<string, unknown>]>;
@@ -2553,6 +2571,14 @@ interface PositionFloatingOptions {
     padding?: number;
     /** Track ancestor scroll events. Disable for static anchors (e.g. toolbar buttons). @default true */
     trackScroll?: boolean;
+    /**
+     * Clipping boundary for flip/shift overflow detection. Defaults to the
+     * floating-ui clipping ancestors (overflow containers plus viewport).
+     * Since the theme stopped clipping `.dm-editor` itself, floats that must
+     * stay inside the editor box (e.g. the table cell toolbar, which would
+     * otherwise cover app chrome above the editor) pass the wrapper here.
+     */
+    boundary?: Element;
 }
 /**
  * Positions a floating element relative to a reference element or virtual rect,
@@ -3957,6 +3983,87 @@ declare class FloatingMenuController {
     private updateDisabledStates;
 }
 
+declare const floatingMenuPluginKey: PluginKey<any>;
+/** Default visibility: cursor at the start of an empty `paragraph` in an editable editor. */
+declare function defaultFloatingMenuShouldShow({ editor, state, }: {
+    editor: Editor;
+    view: EditorView;
+    state: EditorState;
+}): boolean;
+/**
+ * Keyboard shortcuts to move focus from the editor into the menu. Defaults
+ * pair the WAI-ARIA `Alt-F10` with `Mod-/`; empty array disables keyboard entry.
+ */
+interface FloatingMenuKeymap {
+    /** Shortcuts that focus the first menu item when the menu is visible. */
+    enterMenu?: string[];
+}
+interface FloatingMenuOptions {
+    /**
+     * The HTML element that contains the menu. Required when used directly;
+     * framework wrappers create this element and pass it in.
+     */
+    element: HTMLElement | null;
+    /**
+     * Visibility predicate. Defaults to `defaultFloatingMenuShouldShow` (empty
+     * paragraph at cursor start).
+     */
+    shouldShow: (props: {
+        editor: Editor;
+        view: EditorView;
+        state: EditorState;
+    }) => boolean;
+    /**
+     * Pixel offset from the anchor. @default 0
+     */
+    offset: number;
+    /**
+     * Items override. Array replaces defaults entirely; function receives the
+     * collected defaults and returns a new list. Consumed by the controller;
+     * the plugin reads it only when the wrapper doesn't build its own controller.
+     */
+    items?: FloatingMenuItemsOverride;
+    /** Keyboard shortcuts for entering the menu via keyboard. */
+    keymap?: FloatingMenuKeymap;
+    /**
+     * When `true`, the menu only opens via `showFloatingMenu(view)` (the gutter
+     * `+` button); pressing Enter into an empty paragraph no longer auto-shows
+     * it. Mirrors Notion: empty rows show a placeholder, `/` is the keyboard trigger.
+     *
+     * @default false (auto-shows on every empty paragraph, backward compat)
+     */
+    requireExplicitTrigger?: boolean;
+}
+interface CreateFloatingMenuPluginOptions {
+    pluginKey: PluginKey;
+    editor: Editor;
+    element: HTMLElement;
+    shouldShow?: FloatingMenuOptions['shouldShow'];
+    offset?: number;
+    keymap?: FloatingMenuKeymap | undefined;
+    requireExplicitTrigger?: boolean;
+}
+/**
+ * Meta key for `showFloatingMenu` / `hideFloatingMenu`. A STRING (not a
+ * PluginKey) so callers don't need a plugin-instance reference: framework
+ * wrappers create per-instance PluginKeys but all read this shared meta.
+ */
+declare const FLOATING_MENU_META = "dm:floatingMenuTrigger";
+/**
+ * Programmatically show the FloatingMenu, used by BlockHandle's `+` button
+ * after inserting a fresh empty paragraph. With `requireExplicitTrigger: true`
+ * this is the only way the menu opens (the `Mod-/` shortcut still focuses an
+ * already-visible menu).
+ */
+declare function showFloatingMenu(view: EditorView): void;
+/** Programmatically hide the FloatingMenu (clears the explicit-trigger flag). */
+declare function hideFloatingMenu(view: EditorView): void;
+/**
+ * Creates the FloatingMenu plugin. Framework wrappers call this directly so
+ * they own element creation and rendering.
+ */
+declare function createFloatingMenuPlugin(options: CreateFloatingMenuPluginOptions): Plugin;
+
 declare const defaultIcons: IconSet;
 
 /**
@@ -4485,6 +4592,7 @@ declare const CodeBlock: Node<CodeBlockOptions, unknown>;
 declare module '@domternal/core' {
     interface RawCommands {
         toggleBulletList: CommandSpec;
+        turnIntoBulletList: CommandSpec;
     }
 }
 interface BulletListOptions {
@@ -4503,6 +4611,7 @@ declare const BulletList: Node<BulletListOptions, unknown>;
 declare module '@domternal/core' {
     interface RawCommands {
         toggleOrderedList: CommandSpec;
+        turnIntoOrderedList: CommandSpec;
     }
 }
 interface OrderedListOptions {
@@ -4577,6 +4686,7 @@ declare const HardBreak: Node<HardBreakOptions, unknown>;
 declare module '@domternal/core' {
     interface RawCommands {
         toggleTaskList: CommandSpec;
+        turnIntoTaskList: CommandSpec;
     }
 }
 interface TaskListOptions {
@@ -5317,8 +5427,8 @@ declare const ListKeymap: Extension<ListKeymapOptions, unknown>;
 /**
  * Keyboard indent across list boundaries. `Tab` on a top-level block whose
  * previous sibling is a list moves the block INTO the last item as a nested
- * child; `Shift-Tab` reverses for a block sitting as the last child of the
- * last item.
+ * child; `Shift-Tab` lifts the last child of a list item back out to a
+ * top-level sibling, splitting the list when that item is not the last one.
  *
  * Trigger is intentionally narrow so ListKeymap retains in-list Tab/Shift-Tab
  * (`sinkListItem` / `liftListItem`). Schema is validated via `canReplaceWith`;
@@ -5330,9 +5440,9 @@ declare const ListKeymap: Extension<ListKeymapOptions, unknown>;
  *    inside the now-nested context (then ListKeymap takes over).
  *  - Tab only fires for cursors in TOP-LEVEL blocks (depth === 1). Cursors
  *    inside other containers (blockquote, table cell) fall through.
- *  - Shift-Tab only fires when the block is BOTH the last child of its
- *    item AND the item is the last in its wrapper. Mid-position outdent
- *    would require splitting the list item, which is deferred.
+ *  - Shift-Tab fires for the LAST child of a list item; a non-last item is
+ *    split so the parent survives (Notion parity). Mid children-zone blocks
+ *    are still deferred.
  *
  * Registration order: must come AFTER ListKeymap so this extension's keymap
  * runs FIRST and can defer to ListKeymap for in-list flows.
@@ -5347,10 +5457,9 @@ declare const ListKeymap: Extension<ListKeymapOptions, unknown>;
  */
 declare function indentBlockAsListChild(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
 /**
- * `Shift-Tab` handler: lift a non-label nested block out of its list
- * item to become a top-level sibling AFTER the list wrapper. Only
- * fires for the strict end-of-end case (last child of last item) so
- * the lift is deterministic and never needs to split a list item.
+ * `Shift-Tab` handler: lift the last child of a list item out to a
+ * top-level sibling. Lands after the whole list when the item is last
+ * in its wrapper, else splits the wrapper and lands between the halves.
  *
  * Precondition table:
  *   - cursor empty
@@ -5363,7 +5472,6 @@ declare function indentBlockAsListChild(state: EditorState, dispatch?: (tr: Tran
  *     immediate li children rather than reaching deeper into nested
  *     containers
  *   - the block is the LAST child of the list item
- *   - the list item is the LAST child of its wrapper
  *   - the wrapper's parent accepts the block as a sibling (schema)
  */
 declare function outdentBlockFromListItem(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
@@ -6351,4 +6459,4 @@ declare const StarterKit: Extension<StarterKitOptions, unknown>;
  */
 declare const VERSION = "0.1.0";
 
-export { type AnyExtension, type AnyExtensionConfig, type AttributeSpec, type AttributeSpecs, type AutolinkPluginOptions, BaseKeymap, type BaseKeymapOptions, BlockColor, type BlockColorOptions, Blockquote, type BlockquoteOptions, Bold, type BoldOptions, BubbleMenu, type BubbleMenuOptions, type BuildCommandPropsOptions, BulletList, type BulletListOptions, type CanChainedCommands, CanChecker, type CanCheckerEditor, type CanCheckerOptions, type CanCommands, ChainBuilder, type ChainBuilderEditor, type ChainBuilderOptions, type ChainFailure, type ChainedCommands, CharacterCount, type CharacterCountOptions, type CharacterCountStorage, type ClearContentOptions, ClearFormatting, Code, CodeBlock, type CodeBlockOptions, type CodeOptions, type Command, type CommandEditor, CommandManager, type CommandManagerEditor, type CommandMap, type CommandProps, type CommandPropsEditor, type CommandSpec, type Content, type ContentErrorProps, type CreateBubbleMenuPluginOptions, type CreateDocumentOptions, type CreateEventProps, DEFAULT_BLOCK_COLORS, DEFAULT_BLOCK_COLOR_TYPES, DEFAULT_HIGHLIGHT_COLORS, DEFAULT_NOTION_COLOR_PALETTE, DEFAULT_TEXT_COLORS, type DeleteEventProps, Document$1 as Document, type DropEventProps, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, EventEmitter, Extension, type ExtensionConfig, type ExtensionEditor, ExtensionManager, type ExtensionManagerEditor, type ExtensionManagerOptions, FLOATING_MENU_NO_FOCUS, type FindChildResult, type FindParentNodeResult, FloatingMenuController, type FloatingMenuGroup, type FloatingMenuItem, type FloatingMenuItemsOverride, Focus, type FocusEventProps, type FocusOptions, type FocusPosition, FontFamily, type FontFamilyOptions, FontSize, type FontSizeOptions, Gapcursor, type GenerateHTMLOptions, type GenerateJSONOptions, type GenerateTextOptions, type GlobalAttributeSpec, type GlobalAttributes, HardBreak, type HardBreakOptions, Heading, type HeadingOptions, Highlight, type HighlightOptions, History, type HistoryOptions, HorizontalRule, type HorizontalRuleOptions, type IconSet, type InlineStyleOverrides, type InsertAsListItemChildArgs, type InsertAsListItemChildResult, InvisibleChars, type InvisibleCharsOptions, type InvisibleCharsStorage, type IsNodeEmptyOptions, type IsValidUrlOptions, Italic, type ItalicOptions, type JSONAttribute, type JSONContent, type JSONMark, type KeyboardShortcutCommand, LIST_ITEM_TYPE_NAMES, LineHeight, type LineHeightOptions, Link, type LinkAttributes, type LinkClickPluginOptions, type LinkExitPluginOptions, type LinkOptions, type LinkPastePluginOptions, LinkPopover, type LinkPopoverOptions, ListIndent, ListItem, type ListItemCursorContext, type ListItemOptions, ListKeymap, type ListKeymapOptions, Mark, type MarkConfig, type MarkInputRuleOptions, type MarkParseRule, type MarkRange, type MarkRenderHTMLProps, type MountEventProps, Node, type NodeConfig, type NodeInputRuleOptions, type NodeParseRule, type NodeRenderHTMLProps, type NodeViewContext, NotionColorPicker, type NotionColorPickerOptions, type NotionColorPickerStorage, OrderedList, type OrderedListOptions, Paragraph, type ParagraphOptions, type PasteEventProps, Placeholder, type PlaceholderOptions, type PositionFloatingOptions, type Range, type RawCommands, Selection, SelectionDecoration, type SelectionDecorationOptions, type SelectionOptions, type SelectionStorage, type SetContentOptions, type SingleCommands, type SplitListForInsertRange, StarterKit, type StarterKitOptions, Strike, type StrikeOptions, Subscript, type SubscriptOptions, Superscript, type SuperscriptOptions, TaskItem, type TaskItemOptions, TaskList, type TaskListOptions, Text, TextAlign, type TextAlignOptions, TextColor, type TextColorOptions, type TextInputRuleOptions, TextStyle, type TextStyleOptions, type TextblockTypeInputRuleOptions, type ToolbarButton, ToolbarController, type ToolbarControllerEditor, type ToolbarDropdown, type ToolbarGroup, type ToolbarItem, type ToolbarLayoutDropdown, type ToolbarLayoutEntry, type ToolbarSeparator, TrailingNode, type TrailingNodeOptions, type TransactionEventProps, Typography, type TypographyOptions, Underline, type UnderlineOptions, UniqueID, type UniqueIDOptions, VERSION, type WrappingInputRuleOptions, applyInlineStyles, autolinkPlugin, autolinkPluginKey, blur, bubbleMenuPluginKey, buildCommandProps, builtInCommands, callOrReturn, characterCountPluginKey, clearContent, copyThemeClass, createAccumulatingDispatch, createBubbleMenuPlugin, createCanChecker, createChainBuilder, createDocument, defaultBlockAt, defaultBubbleContexts, defaultIcons, deleteSelection, findChildren, findListItemAncestorDepth, findParentNode, focus, focusPluginKey, generateHTML, generateJSON, generateText, getListItemCursorContext, getMarkRange, groupFloatingMenuItems, indentBlockAsListChild, inlineStyles, insertAsListItemChild, insertChildrenZoneSibling, insertContent, insertText, invisibleCharsPluginKey, isDocumentEmpty, isInListItemLabel, isInsideListItem, isNodeEmpty, isValidUrl, lift, liftCurrentListItem, liftEmptyChildrenZoneParagraph, linkClickPlugin, linkClickPluginKey, linkExitPlugin, linkExitPluginKey, linkPastePlugin, linkPastePluginKey, markInputRule, markInputRulePatterns, nodeInputRule, outdentBlockFromListItem, placeholderPluginKey, positionFloating, positionFloatingOnce, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, splitListForInsert, stripInlineColorConflicts, textInputRule, textblockTypeInputRule, toggleBlockType, toggleList, toggleMark, toggleWrap, uniqueIDPluginKey, unsetAllMarks, unsetMark, updateAttributes, wrapIn, wrappingInputRule, writeToClipboard };
+export { type AnyExtension, type AnyExtensionConfig, type AttributeSpec, type AttributeSpecs, type AutolinkPluginOptions, BaseKeymap, type BaseKeymapOptions, BlockColor, type BlockColorOptions, Blockquote, type BlockquoteOptions, Bold, type BoldOptions, BubbleMenu, type BubbleMenuOptions, type BuildCommandPropsOptions, BulletList, type BulletListOptions, type CanChainedCommands, CanChecker, type CanCheckerEditor, type CanCheckerOptions, type CanCommands, ChainBuilder, type ChainBuilderEditor, type ChainBuilderOptions, type ChainFailure, type ChainedCommands, CharacterCount, type CharacterCountOptions, type CharacterCountStorage, type ClearContentOptions, ClearFormatting, Code, CodeBlock, type CodeBlockOptions, type CodeOptions, type Command, type CommandEditor, CommandManager, type CommandManagerEditor, type CommandMap, type CommandProps, type CommandPropsEditor, type CommandSpec, type Content, type ContentErrorProps, type CreateBubbleMenuPluginOptions, type CreateDocumentOptions, type CreateEventProps, type CreateFloatingMenuPluginOptions, DEFAULT_BLOCK_COLORS, DEFAULT_BLOCK_COLOR_TYPES, DEFAULT_HIGHLIGHT_COLORS, DEFAULT_NOTION_COLOR_PALETTE, DEFAULT_TEXT_COLORS, type DeleteEventProps, Document$1 as Document, type DropEventProps, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, EventEmitter, Extension, type ExtensionConfig, type ExtensionEditor, ExtensionManager, type ExtensionManagerEditor, type ExtensionManagerOptions, FLOATING_MENU_META, FLOATING_MENU_NO_FOCUS, type FindChildResult, type FindParentNodeResult, FloatingMenuController, type FloatingMenuGroup, type FloatingMenuItem, type FloatingMenuItemsOverride, type FloatingMenuKeymap, type FloatingMenuOptions, Focus, type FocusEventProps, type FocusOptions, type FocusPosition, FontFamily, type FontFamilyOptions, FontSize, type FontSizeOptions, Gapcursor, type GenerateHTMLOptions, type GenerateJSONOptions, type GenerateTextOptions, type GlobalAttributeSpec, type GlobalAttributes, HardBreak, type HardBreakOptions, Heading, type HeadingOptions, Highlight, type HighlightOptions, History, type HistoryOptions, HorizontalRule, type HorizontalRuleOptions, type IconSet, type InlineStyleOverrides, type InsertAsListItemChildArgs, type InsertAsListItemChildResult, InvisibleChars, type InvisibleCharsOptions, type InvisibleCharsStorage, type IsNodeEmptyOptions, type IsValidUrlOptions, Italic, type ItalicOptions, type JSONAttribute, type JSONContent, type JSONMark, type KeyboardShortcutCommand, LIST_ITEM_TYPE_NAMES, LineHeight, type LineHeightOptions, Link, type LinkAttributes, type LinkClickPluginOptions, type LinkExitPluginOptions, type LinkOptions, type LinkPastePluginOptions, LinkPopover, type LinkPopoverOptions, ListIndent, ListItem, type ListItemCursorContext, type ListItemOptions, ListKeymap, type ListKeymapOptions, Mark, type MarkConfig, type MarkInputRuleOptions, type MarkParseRule, type MarkRange, type MarkRenderHTMLProps, type MountEventProps, Node, type NodeConfig, type NodeInputRuleOptions, type NodeParseRule, type NodeRenderHTMLProps, type NodeViewContext, NotionColorPicker, type NotionColorPickerOptions, type NotionColorPickerStorage, OrderedList, type OrderedListOptions, Paragraph, type ParagraphOptions, type PasteEventProps, Placeholder, type PlaceholderOptions, type PositionFloatingOptions, type Range, type RawCommands, Selection, SelectionDecoration, type SelectionDecorationOptions, type SelectionOptions, type SelectionStorage, type SetContentOptions, type SingleCommands, type SplitListForInsertRange, StarterKit, type StarterKitOptions, Strike, type StrikeOptions, Subscript, type SubscriptOptions, Superscript, type SuperscriptOptions, TaskItem, type TaskItemOptions, TaskList, type TaskListOptions, Text, TextAlign, type TextAlignOptions, TextColor, type TextColorOptions, type TextInputRuleOptions, TextStyle, type TextStyleOptions, type TextblockTypeInputRuleOptions, type ToolbarButton, ToolbarController, type ToolbarControllerEditor, type ToolbarDropdown, type ToolbarGroup, type ToolbarItem, type ToolbarLayoutDropdown, type ToolbarLayoutEntry, type ToolbarSeparator, TrailingNode, type TrailingNodeOptions, type TransactionEventProps, Typography, type TypographyOptions, Underline, type UnderlineOptions, UniqueID, type UniqueIDOptions, VERSION, type WrappingInputRuleOptions, applyInlineStyles, autolinkPlugin, autolinkPluginKey, blur, bubbleMenuPluginKey, buildCommandProps, builtInCommands, callOrReturn, characterCountPluginKey, clearContent, copyThemeClass, createAccumulatingDispatch, createBubbleMenuPlugin, createCanChecker, createChainBuilder, createDocument, createFloatingMenuPlugin, defaultBlockAt, defaultBubbleContexts, defaultFloatingMenuShouldShow, defaultIcons, deleteSelection, findChildren, findListItemAncestorDepth, findParentNode, floatingMenuPluginKey, focus, focusPluginKey, generateHTML, generateJSON, generateText, getListItemCursorContext, getMarkRange, groupFloatingMenuItems, hideFloatingMenu, indentBlockAsListChild, inlineStyles, insertAsListItemChild, insertChildrenZoneSibling, insertContent, insertText, invisibleCharsPluginKey, isDocumentEmpty, isInListItemLabel, isInsideListItem, isNodeEmpty, isValidUrl, lift, liftCurrentListItem, liftEmptyChildrenZoneParagraph, linkClickPlugin, linkClickPluginKey, linkExitPlugin, linkExitPluginKey, linkPastePlugin, linkPastePluginKey, markInputRule, markInputRulePatterns, nodeInputRule, outdentBlockFromListItem, placeholderPluginKey, positionFloating, positionFloatingOnce, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, showFloatingMenu, splitListForInsert, stripInlineColorConflicts, textInputRule, textblockTypeInputRule, toggleBlockType, toggleList, toggleMark, toggleWrap, uniqueIDPluginKey, unsetAllMarks, unsetMark, updateAttributes, wrapIn, wrappingInputRule, writeToClipboard };