@domternal/core 0.3.0 → 0.4.1

package/dist/types/NodeConfig.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Node configuration types
+ *
+ * These types define the configuration object passed to Node.create()
+ * for creating ProseMirror node extensions.
+ */
+import type { Node as PMNode, DOMOutputSpec, NodeType } from '@domternal/pm/model';
+import type { EditorState, Plugin } from '@domternal/pm/state';
+import type { EditorView, NodeViewConstructor } from '@domternal/pm/view';
+import type { ExtensionConfigBase, ExtensionContext } from './ExtensionConfig.js';
+import type { AttributeSpecs } from './AttributeSpec.js';
+/**
+ * Editor interface for Node context
+ * Includes schema with nodes for NodeType getter
+ */
+export interface NodeEditorContext {
+    readonly state: EditorState;
+    readonly view: EditorView;
+    readonly schema: {
+        nodes: Record<string, NodeType>;
+    };
+    readonly commands: Record<string, (...args: unknown[]) => boolean>;
+}
+/**
+ * Context interface for Node config methods.
+ * Extends ExtensionContext with node-specific properties.
+ * This enables proper typing of `this.options`, `this.nodeType`, etc.
+ *
+ * @typeParam Options - Node options type
+ * @typeParam Storage - Node storage type
+ */
+export interface NodeContext<Options = unknown, Storage = unknown> extends Omit<ExtensionContext<Options, Storage>, 'editor' | 'type'> {
+    /** Node type identifier */
+    readonly type: 'node';
+    /** Editor instance with schema access */
+    editor: NodeEditorContext | null;
+    /** ProseMirror NodeType (null until editor is initialized) */
+    readonly nodeType: NodeType | null;
+}
+/**
+ * Parse rule for converting HTML to ProseMirror node
+ * Simplified version of ProseMirror's ParseRule
+ */
+export interface NodeParseRule {
+    /**
+     * CSS selector or tag name to match
+     * @example 'p', 'h1', 'div.my-class'
+     */
+    tag?: string;
+    /**
+     * Match by CSS style
+     * @example 'font-weight'
+     */
+    style?: string;
+    /**
+     * Priority for this rule (higher = checked first)
+     * @default 50
+     */
+    priority?: number;
+    /**
+     * Whether to consume the matched element
+     * @default true
+     */
+    consuming?: boolean;
+    /**
+     * Context required for this rule to match
+     * ProseMirror content expression
+     */
+    context?: string;
+    /**
+     * Get attributes from the matched element
+     * Return null/undefined to skip this rule
+     */
+    getAttrs?: ((node: HTMLElement) => Record<string, unknown> | null | undefined) | null;
+    /**
+     * Get content from the matched element
+     * Return false to use default content parsing
+     */
+    getContent?: (node: HTMLElement, schema: unknown) => unknown;
+    /**
+     * How to preserve whitespace
+     */
+    preserveWhitespace?: boolean | 'full';
+}
+/**
+ * Props passed to renderHTML function
+ */
+export interface NodeRenderHTMLProps {
+    /**
+     * The ProseMirror node being rendered
+     */
+    node: PMNode;
+    /**
+     * Merged HTML attributes from all sources
+     */
+    HTMLAttributes: Record<string, unknown>;
+}
+/**
+ * Node-specific configuration properties (schema-related)
+ */
+interface NodeSchemaProperties {
+    /**
+     * Node group(s) this node belongs to
+     * Used in content expressions
+     *
+     * @example 'block', 'inline', 'block list'
+     * Can be a function that returns the group string (useful for dynamic group based on options)
+     */
+    group?: string | (() => string);
+    /**
+     * Content expression defining allowed children
+     * Uses ProseMirror content expression syntax
+     *
+     * @example 'inline*', 'block+', 'paragraph block*'
+     */
+    content?: string;
+    /**
+     * Whether this is an inline node
+     * Can be a function for dynamic inline based on options
+     * @default false
+     */
+    inline?: boolean | (() => boolean);
+    /**
+     * Whether this node is an atom (no direct content editing)
+     * Cursor moves around atoms, not into them
+     *
+     * @example true for images, mentions, emoji
+     */
+    atom?: boolean;
+    /**
+     * Whether the node can be selected as a whole
+     * @default true for leaf nodes, false for others
+     */
+    selectable?: boolean;
+    /**
+     * Whether the node can be dragged
+     * @default false
+     */
+    draggable?: boolean;
+    /**
+     * Whether this node represents code
+     * Affects text input handling (disables smart quotes, etc.)
+     */
+    code?: boolean;
+    /**
+     * How whitespace is handled in this node
+     * - 'pre': preserve whitespace (like <pre>)
+     * - 'normal': collapse whitespace (default)
+     */
+    whitespace?: 'pre' | 'normal';
+    /**
+     * Whether this node isolates marks at its boundaries
+     * Marks don't extend across isolating boundaries
+     */
+    isolating?: boolean;
+    /**
+     * Whether a gap cursor is allowed inside this node.
+     * Set to false to prevent gapcursor from appearing inside this node.
+     * Set to true to force gapcursor even if the default heuristic disallows it.
+     * When undefined, uses ProseMirror's default heuristic.
+     */
+    allowGapCursor?: boolean;
+    /**
+     * Table role for prosemirror-tables integration.
+     * Nodes with a tableRole are discovered by prosemirror-tables via spec.tableRole.
+     * One of: 'table', 'row', 'cell', 'header_cell'
+     */
+    tableRole?: 'table' | 'row' | 'cell' | 'header_cell';
+    /**
+     * Whether this is a top-level node (document root)
+     * Only one node should have this set to true
+     */
+    topNode?: boolean;
+    /**
+     * Whether this node defines its own scope
+     * Content and marks don't leak out of defining nodes
+     */
+    defining?: boolean;
+    /**
+     * Which marks are allowed in this node
+     * Empty string means no marks allowed
+     *
+     * @example '', '_', 'bold italic'
+     */
+    marks?: string;
+    /**
+     * Custom text for leaf nodes
+     * Used by getText() and textContent
+     *
+     * @example '\n' for hard break
+     */
+    leafText?: string | ((node: PMNode) => string);
+    /**
+     * Define node attributes
+     * Returns attribute specifications
+     *
+     * @example
+     * addAttributes() {
+     *   return {
+     *     level: { default: 1 },
+     *   };
+     * }
+     */
+    addAttributes?: () => AttributeSpecs;
+    /**
+     * Parse rules for converting HTML to this node
+     * Each rule defines how to match and parse HTML elements
+     *
+     * @example
+     * parseHTML() {
+     *   return [
+     *     { tag: 'p' },
+     *     { tag: 'div', priority: 10 },
+     *   ];
+     * }
+     */
+    parseHTML?: () => NodeParseRule[];
+    /**
+     * Render this node to DOM
+     * Returns DOMOutputSpec (tag, attributes, children)
+     *
+     * @example
+     * renderHTML({ node, HTMLAttributes }) {
+     *   return ['p', HTMLAttributes, 0];
+     * }
+     */
+    renderHTML?: (props: NodeRenderHTMLProps) => DOMOutputSpec;
+    /**
+     * Custom node view constructor
+     * For complex interactive nodes
+     */
+    addNodeView?: () => NodeViewConstructor;
+    /**
+     * Additional ProseMirror plugins for this node
+     * Called during plugin collection
+     */
+    addProseMirrorPlugins?: () => Plugin[];
+}
+/**
+ * Configuration for Node extensions
+ * Combines ExtensionConfig base with node-specific schema properties.
+ * Uses ThisType<NodeContext> to provide proper typing for `this` in config methods.
+ *
+ * @typeParam Options - Node options type
+ * @typeParam Storage - Node storage type
+ *
+ * @example
+ * const Paragraph = Node.create({
+ *   name: 'paragraph',
+ *   group: 'block',
+ *   content: 'inline*',
+ *   parseHTML() {
+ *     // `this` is properly typed here!
+ *     return [{ tag: 'p' }];
+ *   },
+ *   renderHTML({ HTMLAttributes }) {
+ *     return ['p', HTMLAttributes, 0];
+ *   },
+ * });
+ */
+export type NodeConfig<Options = unknown, Storage = unknown> = ExtensionConfigBase<Options, Storage> & NodeSchemaProperties & ThisType<NodeContext<Options, Storage>>;
+export {};
+//# sourceMappingURL=NodeConfig.d.ts.map

package/dist/types/NodeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeConfig.d.ts","sourceRoot":"","sources":["../../src/types/NodeConfig.ts"],"names":[],"mappings":"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"}

package/dist/types/Toolbar.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Toolbar configuration types
+ *
+ * These types define toolbar items that extensions can register
+ * via the `addToolbarItems()` hook. Framework wrappers (Angular, React, Vue)
+ * read these items and render the toolbar UI.
+ */
+/**
+ * Maps icon names to SVG strings.
+ *
+ * @example
+ * const icons: IconSet = {
+ *   textB: '<svg>...</svg>',
+ *   textItalic: '<svg>...</svg>',
+ * };
+ */
+export type IconSet = Record<string, string>;
+/**
+ * A toolbar button that executes a command.
+ *
+ * @example
+ * {
+ *   type: 'button',
+ *   name: 'bold',
+ *   command: 'toggleBold',
+ *   isActive: 'bold',
+ *   icon: 'textB',
+ *   label: 'Bold',
+ *   shortcut: 'Mod-b',
+ *   group: 'format',
+ *   priority: 100,
+ * }
+ */
+export interface ToolbarButton {
+    type: 'button';
+    /** Unique identifier for this toolbar item */
+    name: string;
+    /** Command name to execute (key of editor.commands) */
+    command: string;
+    /** Arguments to pass to the command */
+    commandArgs?: unknown[];
+    /**
+     * How to check if this button is active.
+     * - string: extension name passed to `editor.isActive(name)`
+     * - object: `{ name, attributes }` passed to `editor.isActive(name, attributes)`
+     * - array: OR-check — active if ANY entry matches (useful for attributes on multiple node types)
+     * - undefined: button has no active state (e.g. undo/redo)
+     */
+    isActive?: string | {
+        name: string;
+        attributes?: Record<string, unknown>;
+    } | (string | {
+        name: string;
+        attributes?: Record<string, unknown>;
+    })[];
+    /** Icon key (resolved against IconSet) */
+    icon: string;
+    /** Tooltip text and aria-label */
+    label: string;
+    /** Keyboard shortcut for display (e.g. "Mod-b") */
+    shortcut?: string;
+    /** Group name for visual grouping (separators between groups) */
+    group?: string;
+    /** Sort order within group (higher = first). @default 100 */
+    priority?: number;
+    /** Inline CSS style string applied to the button element (e.g. for font preview) */
+    style?: string;
+    /**
+     * Custom function to check active state.
+     * Use for extensions that track state in plugin storage rather than node/mark state.
+     * Takes precedence over `isActive` when defined.
+     */
+    isActiveFn?: (editor: {
+        readonly storage: Record<string, unknown>;
+    }) => boolean;
+    /** Event name to emit on the editor when clicked. If set, the UI emits this event instead of executing the command. */
+    emitEvent?: string;
+    /** Color value (hex) for color-swatch rendering in grid-layout dropdowns. */
+    color?: string;
+    /** Show in the main toolbar. @default true. Set false for bubble-menu-only items. */
+    toolbar?: boolean;
+    /** Bubble menu context name. When set, this item is included in the default bubble menu for this context. */
+    bubbleMenu?: string;
+}
+/**
+ * A dropdown toolbar item containing multiple buttons.
+ *
+ * @example
+ * {
+ *   type: 'dropdown',
+ *   name: 'heading',
+ *   icon: 'textH',
+ *   label: 'Heading',
+ *   group: 'blocks',
+ *   items: [
+ *     { type: 'button', name: 'h1', command: 'toggleHeading', ... },
+ *     { type: 'button', name: 'h2', command: 'toggleHeading', ... },
+ *   ],
+ * }
+ */
+export interface ToolbarDropdown {
+    type: 'dropdown';
+    /** Unique identifier for this toolbar item */
+    name: string;
+    /** Icon key for the dropdown trigger button */
+    icon: string;
+    /** Tooltip text and aria-label */
+    label: string;
+    /** Buttons shown in the dropdown panel */
+    items: ToolbarButton[];
+    /** Group name for visual grouping */
+    group?: string;
+    /** Sort order within group (higher = first). @default 100 */
+    priority?: number;
+    /** Panel layout: 'list' (default vertical) or 'grid' (color-swatch grid). */
+    layout?: 'list' | 'grid';
+    /** Number of columns in grid layout. @default 10 */
+    gridColumns?: number;
+    /** How to display items in the dropdown panel: icon + text (default), text only, or icon only. */
+    displayMode?: 'icon-text' | 'text' | 'icon';
+    /** Default color for the trigger indicator bar when no item is active (grid dropdowns only). */
+    defaultIndicatorColor?: string;
+    /** When true, the trigger icon updates to reflect the active sub-item's icon. */
+    dynamicIcon?: boolean;
+    /** When true, the trigger shows the active sub-item's label as text instead of an icon. */
+    dynamicLabel?: boolean;
+    /** Text shown in trigger when dynamicLabel is true and no item is active. Falls back to icon if not set. */
+    dynamicLabelFallback?: string;
+    /** CSS property to read from computed style at cursor when no item is active (e.g. 'font-size', 'font-family'). */
+    computedStyleProperty?: string;
+}
+/**
+ * A visual separator between toolbar groups.
+ * Typically inserted automatically when group names change.
+ */
+export interface ToolbarSeparator {
+    type: 'separator';
+    /** Unique identifier (needed so all ToolbarItem variants share a `name` field) */
+    name?: string;
+    /** Group name (used for ordering) */
+    group?: string;
+    /** Sort order within group. @default 100 */
+    priority?: number;
+}
+/** Any toolbar item */
+export type ToolbarItem = ToolbarButton | ToolbarDropdown | ToolbarSeparator;
+/**
+ * A custom dropdown defined in a toolbar layout.
+ *
+ * @example
+ * { dropdown: 'Format', icon: 'textB', items: ['bold', 'italic', 'underline'] }
+ */
+export interface ToolbarLayoutDropdown {
+    /** Label for the dropdown trigger */
+    dropdown: string;
+    /** Icon key for the dropdown trigger */
+    icon: string;
+    /** Item names to include as sub-items */
+    items: string[];
+    /** How to display items in the dropdown panel: icon + text (default), text only, or icon only. */
+    displayMode?: 'icon-text' | 'text' | 'icon';
+    /** When true, the trigger icon updates to reflect the active sub-item's icon. */
+    dynamicIcon?: boolean;
+}
+/**
+ * A single entry in a toolbar layout array.
+ *
+ * - `string` — item name (e.g. `'bold'`) or separator (`'|'`)
+ * - `ToolbarLayoutDropdown` — custom dropdown grouping
+ */
+export type ToolbarLayoutEntry = string | ToolbarLayoutDropdown;
+//# sourceMappingURL=Toolbar.d.ts.map

package/dist/types/Toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../src/types/Toolbar.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core type definitions for @domternal/core
+ */
+export type { JSONAttribute, JSONMark, JSONContent, Content, Range, } from './Content.js';
+export type { AnyExtension, FocusPosition, EditorOptions, } from './EditorOptions.js';
+export type { EditorInstance, TransactionEventProps, FocusEventProps, CreateEventProps, ContentErrorProps, PasteEventProps, DropEventProps, MountEventProps, DeleteEventProps, ErrorEventProps, EditorEvents, EditorEventName, } from './EditorEvents.js';
+export type { CommandEditor, CommandProps, Command, CommandSpec, CommandMap, RawCommands, SingleCommands, ChainedCommands, ChainFailure, CanCommands, CanChainedCommands, KeyboardShortcutCommand, } from './Commands.js';
+export type { ExtensionEditor, AnyExtensionConfig, GlobalAttributeSpec, GlobalAttributes, ExtensionConfig, } from './ExtensionConfig.js';
+export type { AttributeSpec, AttributeSpecs } from './AttributeSpec.js';
+export type { NodeParseRule, NodeRenderHTMLProps, NodeConfig, } from './NodeConfig.js';
+export type { MarkParseRule, MarkRenderHTMLProps, MarkConfig, } from './MarkConfig.js';
+export type { IconSet, ToolbarButton, ToolbarDropdown, ToolbarSeparator, ToolbarItem, ToolbarLayoutDropdown, ToolbarLayoutEntry, } from './Toolbar.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,OAAO,EACP,KAAK,GACN,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,OAAO,EACP,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGxE,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,OAAO,EACP,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/utils/inlineStyles.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Inline Styles Utility
+ *
+ * Applies inline CSS styles to serialized HTML so it renders correctly
+ * when pasted outside the editor (email clients, CMS, Google Docs, etc.).
+ *
+ * Uses hardcoded light-theme defaults (same approach as Google Docs, Notion,
+ * TinyMCE). Optionally accepts overrides for custom styling.
+ *
+ * Only structural styles are inlined (borders, padding, margins, fonts).
+ * Colors are NOT inlined — explicit colors (TextColor, Highlight, cell bg)
+ * are already inline from renderHTML, and default text color is browser default.
+ */
+export interface InlineStyleOverrides {
+    blockquoteBorder?: string;
+    blockquoteColor?: string;
+    tableBorder?: string;
+    tableHeaderBg?: string;
+    codeBg?: string;
+    codeFont?: string;
+    codeBorder?: string;
+    codeBlockBg?: string;
+    codeBlockFont?: string;
+    hrBorder?: string;
+    linkColor?: string;
+    detailsBorder?: string;
+    detailsBg?: string;
+    /**
+     * How to export table column widths from `data-colwidth` attributes.
+     * - `'percent'` (default): convert to percentage widths on first-row cells
+     * - `'pixel'`: convert to pixel widths on first-row cells, table gets fixed width
+     * - `'none'`: leave `data-colwidth` as-is, no width styles applied
+     */
+    tableColumnWidths?: 'percent' | 'pixel' | 'none';
+    /**
+     * Optional callback to syntax-highlight code blocks.
+     * Receives the raw text content and optional language, returns highlighted HTML
+     * with `<span class="hljs-*">` markup (or any spans with inline styles).
+     *
+     * @example
+     * ```ts
+     * import { createLowlight, common } from 'lowlight';
+     * import { toHtml } from 'hast-util-to-html';
+     * const lowlight = createLowlight(common);
+     *
+     * inlineStyles(html, {
+     *   codeHighlighter: (code, language) => {
+     *     if (language && lowlight.registered(language)) {
+     *       return toHtml(lowlight.highlight(language, code));
+     *     }
+     *     return null; // no highlighting
+     *   },
+     * });
+     * ```
+     */
+    codeHighlighter?: (code: string, language: string | null) => string | null;
+}
+/**
+ * Applies inline styles to all elements in a container.
+ * Exported for use in clipboardSerializer (operates on DOM directly).
+ */
+export declare function applyInlineStyles(container: HTMLElement, overrides?: InlineStyleOverrides): void;
+/**
+ * Takes an HTML string and returns it with inline CSS styles applied
+ * to all elements, so it renders correctly outside the editor.
+ *
+ * @param html - Serialized HTML string from editor.getHTML()
+ * @param overrides - Optional style overrides for custom theming
+ *
+ * @example
+ * ```ts
+ * // Default light-theme styles
+ * const styled = inlineStyles(editor.getHTML());
+ *
+ * // With custom overrides
+ * const styled = inlineStyles(editor.getHTML(), {
+ *   blockquoteBorder: '5px solid red',
+ *   linkColor: '#ff6600',
+ * });
+ * ```
+ */
+export declare function inlineStyles(html: string, overrides?: InlineStyleOverrides): string;
+//# sourceMappingURL=inlineStyles.d.ts.map

package/dist/utils/inlineStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineStyles.d.ts","sourceRoot":"","sources":["../../src/utils/inlineStyles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;CAC5E;AA0FD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAkOhG;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAOnF"}

package/dist/utils/inlineStyles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inlineStyles.test.d.ts.map

package/dist/utils/inlineStyles.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineStyles.test.d.ts","sourceRoot":"","sources":["../../src/utils/inlineStyles.test.ts"],"names":[],"mappings":""}

package/dist/utils/positionFloating.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Thin wrapper around @floating-ui/dom for consistent floating element positioning.
+ *
+ * Used by BubbleMenu, FloatingMenu, Link Popover, and exposed for extension
+ * authors building custom floating UI (emoji suggestion, slash command, etc.).
+ */
+import { type Placement } from '@floating-ui/dom';
+export interface PositionFloatingOptions {
+    /** Placement relative to reference. @default 'bottom' */
+    placement?: Placement;
+    /** Distance from reference in px. @default 4 */
+    offsetValue?: number;
+    /** Viewport padding for flip/shift in px. @default 10 */
+    padding?: number;
+    /** Track ancestor scroll events. Disable for static anchors (e.g. toolbar buttons). @default true */
+    trackScroll?: boolean;
+}
+/**
+ * Positions a floating element relative to a reference element or virtual rect,
+ * and keeps it positioned on scroll, resize, and layout shifts.
+ *
+ * Uses `autoUpdate` from floating-ui with `animationFrame` polling for
+ * jitter-free scroll tracking (rAF syncs with browser paint).
+ *
+ * Includes `hide` middleware — when the reference element is scrolled out of
+ * view, the floating element is hidden via `visibility: hidden`.
+ *
+ * The floating element must have `position: fixed`.
+ *
+ * Returns a cleanup function. **Always call it** when hiding or destroying
+ * the floating element to stop listeners and prevent memory leaks.
+ *
+ * @example
+ * ```ts
+ * // Start auto-positioning (follows scroll/resize)
+ * const cleanup = positionFloating(buttonEl, dropdownEl, {
+ *   placement: 'bottom-start',
+ * });
+ *
+ * // Virtual reference (e.g. cursor position — must return fresh coords)
+ * const virtualEl = {
+ *   getBoundingClientRect: () => {
+ *     const coords = view.coordsAtPos(pos);
+ *     return new DOMRect(coords.left, coords.top, 0, coords.bottom - coords.top);
+ *   },
+ * };
+ * const cleanup = positionFloating(virtualEl, tooltipEl, { placement: 'top' });
+ *
+ * // Stop when done
+ * cleanup();
+ * ```
+ */
+export declare function positionFloating(reference: Element | {
+    getBoundingClientRect: () => DOMRect;
+}, floating: HTMLElement, options?: PositionFloatingOptions): () => void;
+/**
+ * Positions a floating element using `strategy: 'absolute'` so it scrolls
+ * together with its offsetParent — zero jitter by design.
+ *
+ * Ideal for dropdowns inside scroll containers (e.g. emoji suggestion inside
+ * `.dm-editor`) and toolbar dropdowns. The absolute coordinates are stable
+ * across scrolls — only `flip`/`shift` decisions change on scroll, producing
+ * a discrete jump rather than continuous jitter.
+ *
+ * The floating element must have `position: absolute` and its offsetParent
+ * must have `position: relative`.
+ *
+ * Returns a cleanup function — call it when hiding or destroying the
+ * floating element.
+ */
+export declare function positionFloatingOnce(reference: Element | {
+    getBoundingClientRect: () => DOMRect;
+}, floating: HTMLElement, options?: PositionFloatingOptions): () => void;
+//# sourceMappingURL=positionFloating.d.ts.map

package/dist/utils/positionFloating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionFloating.d.ts","sourceRoot":"","sources":["../../src/utils/positionFloating.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qGAAqG;IACrG,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,OAAO,GAAG;IAAE,qBAAqB,EAAE,MAAM,OAAO,CAAA;CAAE,EAC7D,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,uBAAuB,GAChC,MAAM,IAAI,CA+CZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,OAAO,GAAG;IAAE,qBAAqB,EAAE,MAAM,OAAO,CAAA;CAAE,EAC7D,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,uBAAuB,GAChC,MAAM,IAAI,CAmCZ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domternal/core",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Framework-agnostic ProseMirror editor engine",
   "author": "https://github.com/ThomasNowHere",
   "license": "MIT",
@@ -29,7 +29,7 @@
     "dist"
   ],
   "dependencies": {
-    "@domternal/pm": ">=0.2.0",
+    "@domternal/pm": ">=0.4.0",
     "@floating-ui/dom": "^1.7.5",
     "linkifyjs": "^4.3.2"
   },