@domternal/core 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -134,6 +134,16 @@ interface EditorEvents {
     notionColorOpen: {
         anchorElement?: HTMLElement | null;
     };
+    /**
+     * Fired after the document has been marked for printing and before the
+     * browser's print dialog opens. Listeners run synchronously: this is the
+     * last moment to add page rules or set `document.title`.
+     */
+    beforePrint: {
+        root: HTMLElement;
+    };
+    /** Fired once the print dialog is done and the print marks are removed. */
+    afterPrint: undefined;
 }
 /**
  * Event names as a type
@@ -172,6 +182,19 @@ interface AnyExtension {
  * - number: Focus at specific position
  */
 type FocusPosition = boolean | 'start' | 'end' | 'all' | number | null;
+/**
+ * The editing experience the editor is assembled for.
+ *
+ * - 'classic': the default toolbar-driven experience
+ * - 'notion': the block-based Notion-style experience; the editor paints
+ *   `dm-notion-mode` on its `.dm-editor` host, and preset-aware extensions
+ *   (the bubble menu contexts, the image placement controls) adapt
+ *
+ * Read the resolved value via `editor.preset`, never this option directly:
+ * consumers that predate the option declare Notion mode with the theme
+ * class alone, and the getter honors that.
+ */
+type EditorPreset = 'classic' | 'notion';
 /**
  * Configuration options for creating an Editor instance
  */
@@ -203,6 +226,15 @@ interface EditorOptions {
      * @default true
      */
     editable?: boolean;
+    /**
+     * Editing experience preset. `'notion'` paints `dm-notion-mode` on the
+     * `.dm-editor` host and switches preset-aware extensions to their Notion
+     * behavior, so one option replaces setting the class by hand. When omitted,
+     * a `dm-notion-mode` class already on the host still counts as Notion;
+     * an explicit `'classic'` overrides even that.
+     * @default undefined (resolved from the host class, else 'classic')
+     */
+    preset?: EditorPreset;
     /**
      * Accessible label for the editor.
      * Sets aria-label on the contenteditable element.
@@ -1085,6 +1117,12 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * True while EditorView's constructor runs; see buildViewDispatch.
      */
     private _isViewConstructing;
+    /**
+     * The `.dm-editor` host this editor painted `dm-notion-mode` onto because
+     * of `preset: 'notion'`. Tracked so destroy() removes only a class the
+     * editor itself added, never one the consumer wrote.
+     */
+    private _presetClassHost;
     /**
      * Creates a new Editor instance
      *
@@ -1105,6 +1143,26 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * Checks if the editor is editable
      */
     get isEditable(): boolean;
+    /**
+     * The resolved editing-experience preset.
+     *
+     * The `preset` option wins when provided (so an explicit 'classic' can
+     * opt out of everything). Otherwise a `dm-notion-mode` class on or above
+     * the view counts as 'notion': consumers that predate the option declare
+     * Notion mode with the theme class alone, and behavior must follow what
+     * the user actually sees. Resolved on every read, not cached, so a class
+     * toggled at runtime is picked up.
+     */
+    get preset(): EditorPreset;
+    /**
+     * Paints `dm-notion-mode` on the `.dm-editor` host when the editor was
+     * created with `preset: 'notion'`. Runs during creation, and framework
+     * wrappers call it again after adopting the view's DOM: they construct
+     * the editor in a detached element, so the creation-time run cannot see
+     * the host yet. Idempotent; a no-op for any other preset. Only a class
+     * added here is removed again on destroy.
+     */
+    adoptPresetClass(): void;
     /**
      * Checks if the editor content is empty
      */
@@ -1381,6 +1439,11 @@ interface ExtensionEditor {
     readonly schema: unknown;
     readonly commands: SingleCommands;
     readonly isEditable: boolean;
+    /**
+     * Resolved editing-experience preset; see Editor.preset. Optional so
+     * minimal editor mocks keep compiling; treat undefined as 'classic'.
+     */
+    readonly preset?: EditorPreset;
 }
 /**
  * Any extension type (forward declaration)
@@ -1749,6 +1812,11 @@ interface NodeEditorContext {
         nodes: Record<string, NodeType>;
     };
     readonly commands: Record<string, (...args: unknown[]) => boolean>;
+    /**
+     * Resolved editing-experience preset; see Editor.preset. Optional so
+     * minimal editor mocks keep compiling; treat undefined as 'classic'.
+     */
+    readonly preset?: EditorPreset;
 }
 /**
  * Context interface for Node config methods.
@@ -2089,11 +2157,21 @@ interface MarkSchemaProperties {
      * Marks that this mark excludes (cannot coexist with)
      *
      * - '_' excludes all marks
-     * - Space-separated mark names exclude specific marks
+     * - Space-separated mark names or group names exclude those marks
      * - Empty string or undefined means no exclusions
      *
+     * Note: mark NAMES listed here must exist in the schema or schema
+     * compilation throws, so extensions meant to work in minimal setups
+     * should exclude by group. The core formatting marks (bold, italic,
+     * underline, strike, code, sub/superscript, textStyle) all declare
+     * group 'formatting', and Code excludes that group: a third-party
+     * formatting mark joins the exclusion by declaring the same group,
+     * while semantic marks (link, comment anchors) stay combinable with
+     * code by staying out of it.
+     *
      * @example 'code' - excludes code mark
      * @example 'bold italic' - excludes bold and italic
+     * @example 'formatting' - excludes the formatting group
      * @example '_' - excludes all other marks
      */
     excludes?: string;
@@ -2104,6 +2182,17 @@ interface MarkSchemaProperties {
      * @example 'formatting', 'inline'
      */
     group?: string;
+    /**
+     * Whether block duplication keeps this mark on the copied content
+     *
+     * Set false for marks that reference identity-bearing external state
+     * (a comment thread anchor, a suggestion id): duplicating such a mark
+     * would make one identity point at two unrelated places, so block
+     * duplicate strips it from the copy instead.
+     *
+     * @default true
+     */
+    keepOnDuplicate?: boolean;
     /**
      * Whether this mark can span multiple nodes
      *
@@ -2714,11 +2803,10 @@ declare function refocusEditorAfterCommand(view: {
 
 /**
  * Default `contexts` map for a bubble menu when the consumer has not
- * supplied one. Returns a richer item set when the editor (or any
- * ancestor) carries the `.dm-notion-mode` class - that class is the
- * project-wide signal that the host is rendering Notion-style UX, so
- * the bubble menu mirrors it by leading with `ai` and including `link`
- * and `textAlign`.
+ * supplied one. Returns a richer item set when the editor resolves to the
+ * Notion preset (the `preset` option, or the `.dm-notion-mode` class the
+ * getter also honors), so the bubble menu mirrors the Notion UX by leading
+ * with `ai` and including `link` and `textAlign`.
  *
  * Consumers can always override by passing their own `contexts` prop.
  */
@@ -3922,6 +4010,10 @@ interface FloatingMenuGroup {
  * order of groups. Within each group, items are sorted by `priority`
  * descending (higher first, default 100).
  *
+ * An item with NO group leads: declining a category marks a primary action,
+ * and insertion order would file it last, since whatever adds one loads after
+ * the extensions defining the categories. Renderers give it no heading.
+ *
  * Shared between `FloatingMenuController` (which renders grouped item lists
  * for FloatingMenu + framework wrappers) and `createSlashSuggestionRenderer`
  * (the popup shown by SlashCommand). Having one implementation keeps visual
@@ -6303,6 +6395,62 @@ declare const NotionColorPicker: Extension<NotionColorPickerOptions, NotionColor
 
 declare const ClearFormatting: Extension<unknown, unknown>;
 
+/**
+ * Print Extension
+ *
+ * Sends the document to the browser's own print dialog, which is also the
+ * one place a reader can save a PDF that looks exactly like the editor:
+ * the same engine paints both, so floats, columns and fonts survive
+ * untouched. What it cannot do is hand a file back to code, so it
+ * complements a file exporter rather than replacing one.
+ *
+ * The paper styling itself lives in `@domternal/theme` (`_print.scss`) and
+ * applies to the reader's own Ctrl/Cmd+P with no code involved. This
+ * extension adds the two things CSS cannot do on its own: a button, and
+ * isolating the document from the host application's chrome.
+ *
+ * @example
+ * ```ts
+ * import { Print } from '@domternal/core';
+ *
+ * const editor = new Editor({ extensions: [Print] });
+ * editor.commands.printDocument();
+ * ```
+ */
+
+interface PrintOptions {
+    /** Show the toolbar button. @default true */
+    toolbar: boolean;
+    /**
+     * Resolve the element to print. Defaults to the editor's `.dm-editor`
+     * wrapper, falling back to the ProseMirror element itself.
+     */
+    root: ((editor: ExtensionEditor) => HTMLElement | null) | null;
+    /**
+     * Also isolate the document when the reader presses Ctrl/Cmd+P instead of
+     * using the command.
+     *
+     * Off by default, and deliberately: isolating means erasing everything
+     * else on the page. That is obviously right for an app that IS the
+     * editor, and obviously wrong for an article with an editor embedded in
+     * it, and only the host knows which one it is. With it off, a native
+     * print still gets the whole paper stylesheet, just not the erasure.
+     *
+     * @default false
+     */
+    isolateNativePrint: boolean;
+}
+interface PrintStorage {
+    /** Removes the native print listeners; set only when they were attached. */
+    cleanup: (() => void) | null;
+}
+declare const Print: Extension<PrintOptions, PrintStorage>;
+declare module '@domternal/core' {
+    interface RawCommands {
+        printDocument: CommandSpec;
+    }
+}
+
 interface LinkPopoverOptions {
     /**
      * List of allowed URL protocols (should match Link mark's protocols)
@@ -6502,6 +6650,6 @@ declare const StarterKit: Extension<StarterKitOptions, unknown>;
  * @domternal/core
  * Framework-agnostic ProseMirror editor engine
  */
-declare const VERSION = "0.14.0";
+declare const VERSION = "0.15.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, type CreateFloatingMenuPluginOptions, DEFAULT_BLOCK_COLORS, DEFAULT_BLOCK_COLOR_TYPES, DEFAULT_HIGHLIGHT_COLORS, DEFAULT_NOTION_COLOR_PALETTE, DEFAULT_TEXT_COLORS, Document$1 as Document, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, EventEmitter, Extension, type ExtensionConfig, type ExtensionConfigBase, ExtensionConfigurationError, 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, 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, announce, 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, refocusEditorAfterCommand, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, showFloatingMenu, 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, Document$1 as Document, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, type EditorPreset, EventEmitter, Extension, type ExtensionConfig, type ExtensionConfigBase, ExtensionConfigurationError, 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, Placeholder, type PlaceholderOptions, type PositionFloatingOptions, Print, type PrintOptions, type PrintStorage, 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, announce, 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, refocusEditorAfterCommand, 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

@@ -134,6 +134,16 @@ interface EditorEvents {
     notionColorOpen: {
         anchorElement?: HTMLElement | null;
     };
+    /**
+     * Fired after the document has been marked for printing and before the
+     * browser's print dialog opens. Listeners run synchronously: this is the
+     * last moment to add page rules or set `document.title`.
+     */
+    beforePrint: {
+        root: HTMLElement;
+    };
+    /** Fired once the print dialog is done and the print marks are removed. */
+    afterPrint: undefined;
 }
 /**
  * Event names as a type
@@ -172,6 +182,19 @@ interface AnyExtension {
  * - number: Focus at specific position
  */
 type FocusPosition = boolean | 'start' | 'end' | 'all' | number | null;
+/**
+ * The editing experience the editor is assembled for.
+ *
+ * - 'classic': the default toolbar-driven experience
+ * - 'notion': the block-based Notion-style experience; the editor paints
+ *   `dm-notion-mode` on its `.dm-editor` host, and preset-aware extensions
+ *   (the bubble menu contexts, the image placement controls) adapt
+ *
+ * Read the resolved value via `editor.preset`, never this option directly:
+ * consumers that predate the option declare Notion mode with the theme
+ * class alone, and the getter honors that.
+ */
+type EditorPreset = 'classic' | 'notion';
 /**
  * Configuration options for creating an Editor instance
  */
@@ -203,6 +226,15 @@ interface EditorOptions {
      * @default true
      */
     editable?: boolean;
+    /**
+     * Editing experience preset. `'notion'` paints `dm-notion-mode` on the
+     * `.dm-editor` host and switches preset-aware extensions to their Notion
+     * behavior, so one option replaces setting the class by hand. When omitted,
+     * a `dm-notion-mode` class already on the host still counts as Notion;
+     * an explicit `'classic'` overrides even that.
+     * @default undefined (resolved from the host class, else 'classic')
+     */
+    preset?: EditorPreset;
     /**
      * Accessible label for the editor.
      * Sets aria-label on the contenteditable element.
@@ -1085,6 +1117,12 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * True while EditorView's constructor runs; see buildViewDispatch.
      */
     private _isViewConstructing;
+    /**
+     * The `.dm-editor` host this editor painted `dm-notion-mode` onto because
+     * of `preset: 'notion'`. Tracked so destroy() removes only a class the
+     * editor itself added, never one the consumer wrote.
+     */
+    private _presetClassHost;
     /**
      * Creates a new Editor instance
      *
@@ -1105,6 +1143,26 @@ declare class Editor extends EventEmitter<EditorEvents> {
      * Checks if the editor is editable
      */
     get isEditable(): boolean;
+    /**
+     * The resolved editing-experience preset.
+     *
+     * The `preset` option wins when provided (so an explicit 'classic' can
+     * opt out of everything). Otherwise a `dm-notion-mode` class on or above
+     * the view counts as 'notion': consumers that predate the option declare
+     * Notion mode with the theme class alone, and behavior must follow what
+     * the user actually sees. Resolved on every read, not cached, so a class
+     * toggled at runtime is picked up.
+     */
+    get preset(): EditorPreset;
+    /**
+     * Paints `dm-notion-mode` on the `.dm-editor` host when the editor was
+     * created with `preset: 'notion'`. Runs during creation, and framework
+     * wrappers call it again after adopting the view's DOM: they construct
+     * the editor in a detached element, so the creation-time run cannot see
+     * the host yet. Idempotent; a no-op for any other preset. Only a class
+     * added here is removed again on destroy.
+     */
+    adoptPresetClass(): void;
     /**
      * Checks if the editor content is empty
      */
@@ -1381,6 +1439,11 @@ interface ExtensionEditor {
     readonly schema: unknown;
     readonly commands: SingleCommands;
     readonly isEditable: boolean;
+    /**
+     * Resolved editing-experience preset; see Editor.preset. Optional so
+     * minimal editor mocks keep compiling; treat undefined as 'classic'.
+     */
+    readonly preset?: EditorPreset;
 }
 /**
  * Any extension type (forward declaration)
@@ -1749,6 +1812,11 @@ interface NodeEditorContext {
         nodes: Record<string, NodeType>;
     };
     readonly commands: Record<string, (...args: unknown[]) => boolean>;
+    /**
+     * Resolved editing-experience preset; see Editor.preset. Optional so
+     * minimal editor mocks keep compiling; treat undefined as 'classic'.
+     */
+    readonly preset?: EditorPreset;
 }
 /**
  * Context interface for Node config methods.
@@ -2089,11 +2157,21 @@ interface MarkSchemaProperties {
      * Marks that this mark excludes (cannot coexist with)
      *
      * - '_' excludes all marks
-     * - Space-separated mark names exclude specific marks
+     * - Space-separated mark names or group names exclude those marks
      * - Empty string or undefined means no exclusions
      *
+     * Note: mark NAMES listed here must exist in the schema or schema
+     * compilation throws, so extensions meant to work in minimal setups
+     * should exclude by group. The core formatting marks (bold, italic,
+     * underline, strike, code, sub/superscript, textStyle) all declare
+     * group 'formatting', and Code excludes that group: a third-party
+     * formatting mark joins the exclusion by declaring the same group,
+     * while semantic marks (link, comment anchors) stay combinable with
+     * code by staying out of it.
+     *
      * @example 'code' - excludes code mark
      * @example 'bold italic' - excludes bold and italic
+     * @example 'formatting' - excludes the formatting group
      * @example '_' - excludes all other marks
      */
     excludes?: string;
@@ -2104,6 +2182,17 @@ interface MarkSchemaProperties {
      * @example 'formatting', 'inline'
      */
     group?: string;
+    /**
+     * Whether block duplication keeps this mark on the copied content
+     *
+     * Set false for marks that reference identity-bearing external state
+     * (a comment thread anchor, a suggestion id): duplicating such a mark
+     * would make one identity point at two unrelated places, so block
+     * duplicate strips it from the copy instead.
+     *
+     * @default true
+     */
+    keepOnDuplicate?: boolean;
     /**
      * Whether this mark can span multiple nodes
      *
@@ -2714,11 +2803,10 @@ declare function refocusEditorAfterCommand(view: {
 
 /**
  * Default `contexts` map for a bubble menu when the consumer has not
- * supplied one. Returns a richer item set when the editor (or any
- * ancestor) carries the `.dm-notion-mode` class - that class is the
- * project-wide signal that the host is rendering Notion-style UX, so
- * the bubble menu mirrors it by leading with `ai` and including `link`
- * and `textAlign`.
+ * supplied one. Returns a richer item set when the editor resolves to the
+ * Notion preset (the `preset` option, or the `.dm-notion-mode` class the
+ * getter also honors), so the bubble menu mirrors the Notion UX by leading
+ * with `ai` and including `link` and `textAlign`.
  *
  * Consumers can always override by passing their own `contexts` prop.
  */
@@ -3922,6 +4010,10 @@ interface FloatingMenuGroup {
  * order of groups. Within each group, items are sorted by `priority`
  * descending (higher first, default 100).
  *
+ * An item with NO group leads: declining a category marks a primary action,
+ * and insertion order would file it last, since whatever adds one loads after
+ * the extensions defining the categories. Renderers give it no heading.
+ *
  * Shared between `FloatingMenuController` (which renders grouped item lists
  * for FloatingMenu + framework wrappers) and `createSlashSuggestionRenderer`
  * (the popup shown by SlashCommand). Having one implementation keeps visual
@@ -6303,6 +6395,62 @@ declare const NotionColorPicker: Extension<NotionColorPickerOptions, NotionColor
 
 declare const ClearFormatting: Extension<unknown, unknown>;
 
+/**
+ * Print Extension
+ *
+ * Sends the document to the browser's own print dialog, which is also the
+ * one place a reader can save a PDF that looks exactly like the editor:
+ * the same engine paints both, so floats, columns and fonts survive
+ * untouched. What it cannot do is hand a file back to code, so it
+ * complements a file exporter rather than replacing one.
+ *
+ * The paper styling itself lives in `@domternal/theme` (`_print.scss`) and
+ * applies to the reader's own Ctrl/Cmd+P with no code involved. This
+ * extension adds the two things CSS cannot do on its own: a button, and
+ * isolating the document from the host application's chrome.
+ *
+ * @example
+ * ```ts
+ * import { Print } from '@domternal/core';
+ *
+ * const editor = new Editor({ extensions: [Print] });
+ * editor.commands.printDocument();
+ * ```
+ */
+
+interface PrintOptions {
+    /** Show the toolbar button. @default true */
+    toolbar: boolean;
+    /**
+     * Resolve the element to print. Defaults to the editor's `.dm-editor`
+     * wrapper, falling back to the ProseMirror element itself.
+     */
+    root: ((editor: ExtensionEditor) => HTMLElement | null) | null;
+    /**
+     * Also isolate the document when the reader presses Ctrl/Cmd+P instead of
+     * using the command.
+     *
+     * Off by default, and deliberately: isolating means erasing everything
+     * else on the page. That is obviously right for an app that IS the
+     * editor, and obviously wrong for an article with an editor embedded in
+     * it, and only the host knows which one it is. With it off, a native
+     * print still gets the whole paper stylesheet, just not the erasure.
+     *
+     * @default false
+     */
+    isolateNativePrint: boolean;
+}
+interface PrintStorage {
+    /** Removes the native print listeners; set only when they were attached. */
+    cleanup: (() => void) | null;
+}
+declare const Print: Extension<PrintOptions, PrintStorage>;
+declare module '@domternal/core' {
+    interface RawCommands {
+        printDocument: CommandSpec;
+    }
+}
+
 interface LinkPopoverOptions {
     /**
      * List of allowed URL protocols (should match Link mark's protocols)
@@ -6502,6 +6650,6 @@ declare const StarterKit: Extension<StarterKitOptions, unknown>;
  * @domternal/core
  * Framework-agnostic ProseMirror editor engine
  */
-declare const VERSION = "0.14.0";
+declare const VERSION = "0.15.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, type CreateFloatingMenuPluginOptions, DEFAULT_BLOCK_COLORS, DEFAULT_BLOCK_COLOR_TYPES, DEFAULT_HIGHLIGHT_COLORS, DEFAULT_NOTION_COLOR_PALETTE, DEFAULT_TEXT_COLORS, Document$1 as Document, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, EventEmitter, Extension, type ExtensionConfig, type ExtensionConfigBase, ExtensionConfigurationError, 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, 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, announce, 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, refocusEditorAfterCommand, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, showFloatingMenu, 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, Document$1 as Document, Dropcursor, type DropcursorOptions, Editor, type EditorEventName, type EditorEvents, type EditorInstance, type EditorOptions, type EditorPreset, EventEmitter, Extension, type ExtensionConfig, type ExtensionConfigBase, ExtensionConfigurationError, 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, Placeholder, type PlaceholderOptions, type PositionFloatingOptions, Print, type PrintOptions, type PrintStorage, 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, announce, 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, refocusEditorAfterCommand, resetAttributes, selectAll, selectNodeBackward, selectionDecorationPluginKey, setBlockType, setContent, setMark, showFloatingMenu, splitListForInsert, stripInlineColorConflicts, textInputRule, textblockTypeInputRule, toggleBlockType, toggleList, toggleMark, toggleWrap, uniqueIDPluginKey, unsetAllMarks, unsetMark, updateAttributes, wrapIn, wrappingInputRule, writeToClipboard };