@domternal/core 0.4.0 → 0.4.1

package/dist/Node.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Node - Base class for node extensions
+ *
+ * Nodes define document structure elements that contribute to the schema.
+ * Examples: Paragraph, Heading, List, Image, etc.
+ *
+ * Three-tier model:
+ * - Extension (type: 'extension') → Pure functionality (History, Placeholder, etc.)
+ * - Node (type: 'node') → Schema nodes (Paragraph, Heading, etc.)
+ * - Mark (type: 'mark') → Schema marks (Bold, Italic, etc.)
+ *
+ * @example
+ * const Paragraph = Node.create({
+ *   name: 'paragraph',
+ *   group: 'block',
+ *   content: 'inline*',
+ *   parseHTML() {
+ *     return [{ tag: 'p' }];
+ *   },
+ *   renderHTML({ HTMLAttributes }) {
+ *     return ['p', HTMLAttributes, 0];
+ *   },
+ * });
+ */
+import type { NodeSpec, NodeType } from '@domternal/pm/model';
+import { Extension, type ExtensionEditorInterface } from './Extension.js';
+import type { NodeConfig, NodeContext } from './types/NodeConfig.js';
+/**
+ * Extended editor interface for Node
+ * Includes schema access for NodeType getter
+ */
+export interface NodeEditorInterface extends ExtensionEditorInterface {
+    readonly schema: {
+        nodes: Record<string, NodeType>;
+    };
+}
+/**
+ * Base class for node extensions
+ *
+ * @typeParam Options - Node options type
+ * @typeParam Storage - Node storage type
+ */
+export declare class Node<Options = unknown, Storage = unknown> extends Extension<Options, Storage> {
+    /**
+     * Node type identifier
+     * Distinguishes nodes from extensions and marks
+     */
+    readonly type: "node";
+    /**
+     * The original configuration object
+     * Typed as NodeConfig for node-specific properties
+     */
+    readonly config: NodeConfig<Options, Storage>;
+    /**
+     * Editor instance with schema access
+     * null until set by ExtensionManager
+     */
+    editor: NodeEditorInterface | null;
+    /**
+     * Protected constructor - use Node.create() instead
+     */
+    protected constructor(config: NodeConfig<Options, Storage>);
+    /**
+     * Get the ProseMirror NodeType from schema
+     *
+     * This is a lazy getter because schema doesn't exist at node creation time.
+     * Schema is built FROM nodes by ExtensionManager.
+     *
+     * Returns null if editor is not yet initialized.
+     * Always check editor is set before using nodeType.
+     */
+    get nodeType(): NodeType | null;
+    /**
+     * Get NodeType or throw if not initialized.
+     * Use in contexts where editor is guaranteed to be set (like addCommands).
+     */
+    get nodeTypeOrThrow(): NodeType;
+    /**
+     * Creates a new node instance
+     *
+     * @param config - Node configuration
+     * @returns New node instance
+     *
+     * @example
+     * const Paragraph = Node.create({
+     *   name: 'paragraph',
+     *   group: 'block',
+     *   content: 'inline*',
+     * });
+     */
+    static create<O = unknown, S = unknown>(config: NodeConfig<O, S>): Node<O, S>;
+    /**
+     * Creates a new node with merged options
+     * Original node is not modified
+     *
+     * **Note:** Options are merged shallowly using object spread (`...`).
+     * Nested objects are replaced entirely, not deeply merged.
+     *
+     * @param options - Options to merge with existing options
+     * @returns New node instance with merged options
+     *
+     * @example
+     * const CustomParagraph = Paragraph.configure({ HTMLAttributes: { class: 'custom' } });
+     *
+     * @example
+     * // Shallow merge behavior with nested objects:
+     * // Given: options = { HTMLAttributes: { class: 'a', id: 'b' } }
+     * // configure({ HTMLAttributes: { class: 'c' } })
+     * // Result: { HTMLAttributes: { class: 'c' } } — 'id' is lost!
+     * // To preserve nested values, spread manually:
+     * // configure({ HTMLAttributes: { ...original.options.HTMLAttributes, class: 'c' } })
+     */
+    configure(options: Partial<Options>): Node<Options, Storage>;
+    /**
+     * Creates a new node with extended configuration
+     * Original node is not modified
+     *
+     * **Note:** Config is merged shallowly using object spread (`...`).
+     * Config properties (like `addAttributes`, `parseHTML`) are
+     * replaced entirely, not combined with the base node's config.
+     *
+     * @param extendedConfig - Configuration to extend/override
+     * @returns New node instance with extended config
+     *
+     * @example
+     * const CustomParagraph = Paragraph.extend({
+     *   name: 'customParagraph',
+     *   addAttributes() {
+     *     return { ...this.parent?.(), align: { default: 'left' } };
+     *   },
+     * });
+     *
+     * @example
+     * // To preserve base node's parse rules while adding new ones:
+     * const Extended = BaseNode.extend({
+     *   parseHTML() {
+     *     const baseRules = BaseNode.config.parseHTML?.call(this) ?? [];
+     *     return [...baseRules, { tag: 'custom-tag' }];
+     *   },
+     * });
+     */
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage>(extendedConfig: Partial<NodeConfig<ExtendedOptions, ExtendedStorage>> & ThisType<NodeContext<ExtendedOptions, ExtendedStorage>>): Node<ExtendedOptions, ExtendedStorage>;
+    /**
+     * Creates a ProseMirror NodeSpec from this node's configuration
+     *
+     * Called by ExtensionManager when building the schema.
+     * Converts our config format to ProseMirror's NodeSpec format.
+     *
+     * @returns ProseMirror NodeSpec
+     */
+    createNodeSpec(): NodeSpec;
+}
+//# sourceMappingURL=Node.d.ts.map

package/dist/Node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../src/Node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAgB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,KAAK,wBAAwB,EAAgC,MAAM,gBAAgB,CAAC;AACxG,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIrE;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB;IACnE,QAAQ,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KACjC,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,CAAE,SAAQ,SAAS,CACvE,OAAO,EACP,OAAO,CACR;IACC;;;OAGG;IACH,SAAkB,IAAI,EAAG,MAAM,CAAU;IAEzC;;;OAGG;IACH,SAAiB,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEtD;;;OAGG;IACM,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAEnD;;OAEG;IACH,SAAS,aAAa,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;IAI1D;;;;;;;;OAQG;IACH,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAK9B;IAED;;;OAGG;IACH,IAAI,eAAe,IAAI,QAAQ,CAS9B;IAED;;;;;;;;;;;;OAYG;WACa,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC7C,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACvB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAIb;;;;;;;;;;;;;;;;;;;;OAoBG;IACM,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;IAYrE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACM,MAAM,CAAC,eAAe,GAAG,OAAO,EAAE,eAAe,GAAG,OAAO,EAClE,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,GACnE,QAAQ,CAAC,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,GACxD,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC;IAMzC;;;;;;;OAOG;IACH,cAAc,IAAI,QAAQ;CAqI3B"}

package/dist/Node.test.d.ts

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

package/dist/Node.test.d.ts.map

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

package/dist/ToolbarController.d.ts

@@ -0,0 +1,169 @@
+/**
+ * ToolbarController — Headless, framework-agnostic toolbar state machine
+ *
+ * Manages toolbar item collection, grouping, active state tracking,
+ * dropdown state, and keyboard navigation. Framework wrappers (Angular,
+ * React, Vue) bind their templates to this controller.
+ *
+ * @example
+ * const controller = new ToolbarController(editor, () => {
+ *   // Called on every state change — trigger framework re-render
+ * });
+ * controller.subscribe();
+ * // ... use controller.groups, controller.activeMap, etc.
+ * controller.destroy();
+ */
+import type { ToolbarItem, ToolbarButton, ToolbarLayoutEntry } from './types/Toolbar.js';
+/**
+ * Editor interface for ToolbarController.
+ * Minimal surface to avoid circular dependency on Editor class.
+ */
+export interface ToolbarControllerEditor {
+    readonly toolbarItems: ToolbarItem[];
+    readonly storage: Record<string, unknown>;
+    isActive(nameOrAttributes: string | {
+        name: string;
+        attributes?: Record<string, unknown>;
+    }, attributes?: Record<string, unknown>): boolean;
+    readonly commands: Record<string, (...args: unknown[]) => boolean>;
+    can(): Record<string, (...args: unknown[]) => boolean>;
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+}
+/**
+ * A group of toolbar items with the same group name.
+ */
+export interface ToolbarGroup {
+    name: string;
+    items: ToolbarItem[];
+}
+/** Minimal editor shape for static helpers (avoids strict ToolbarControllerEditor compatibility issues) */
+interface ToolbarItemEditor {
+    readonly storage: Record<string, unknown>;
+    readonly commands: Record<string, (...args: unknown[]) => boolean>;
+    isActive(nameOrAttributes: string | {
+        name: string;
+        attributes?: Record<string, unknown>;
+    }, attributes?: Record<string, unknown>): boolean;
+}
+export declare class ToolbarController {
+    /**
+     * Resolves the active state of a toolbar button against the editor.
+     * Shared between ToolbarController and framework components (e.g. bubble-menu).
+     */
+    static resolveActive(editor: ToolbarItemEditor, item: ToolbarButton): boolean;
+    /**
+     * Executes a toolbar button's command on the editor.
+     * Shared between ToolbarController and framework components (e.g. bubble-menu).
+     */
+    static executeItem(editor: ToolbarItemEditor, item: ToolbarButton): void;
+    private editor;
+    private onChange;
+    private _layout;
+    private transactionHandler;
+    /** Grouped and sorted toolbar items */
+    private _groups;
+    /** Active state for each button (keyed by item.name) */
+    private _activeMap;
+    /** Disabled state for each button (keyed by item.name) */
+    private _disabledMap;
+    /** Expanded state for emitEvent buttons — true when their panel is open */
+    private _expandedMap;
+    /** Currently open dropdown name (null = none) */
+    private _openDropdown;
+    /** Focused button index for roving tabindex (-1 = none) */
+    private _focusedIndex;
+    /** Flat list of top-level buttons/dropdowns for keyboard nav */
+    private _flatButtons;
+    constructor(editor: ToolbarControllerEditor, onChange: () => void, layout?: ToolbarLayoutEntry[]);
+    get groups(): ToolbarGroup[];
+    get activeMap(): ReadonlyMap<string, boolean>;
+    get disabledMap(): ReadonlyMap<string, boolean>;
+    get expandedMap(): ReadonlyMap<string, boolean>;
+    get openDropdown(): string | null;
+    get focusedIndex(): number;
+    get flatButtonCount(): number;
+    /**
+     * Checks if a toolbar button is currently active.
+     */
+    isActive(item: ToolbarButton): boolean;
+    /**
+     * Checks if a toolbar button is currently disabled (command cannot execute).
+     */
+    isDisabled(item: ToolbarButton): boolean;
+    /**
+     * Executes a toolbar button's command.
+     */
+    executeCommand(item: ToolbarButton): void;
+    /**
+     * Toggles a dropdown open/closed.
+     */
+    toggleDropdown(name: string): void;
+    /**
+     * Closes any open dropdown.
+     */
+    closeDropdown(): void;
+    /**
+     * Move focus to the next button (ArrowRight).
+     */
+    navigateNext(): number;
+    /**
+     * Move focus to the previous button (ArrowLeft).
+     */
+    navigatePrev(): number;
+    /**
+     * Move focus to the first button (Home).
+     */
+    navigateFirst(): number;
+    /**
+     * Move focus to the last button (End).
+     */
+    navigateLast(): number;
+    /**
+     * Set focused index directly (e.g. on mouse enter).
+     */
+    setFocusedIndex(index: number): void;
+    /**
+     * Get the flat index of a top-level item by name.
+     */
+    getFlatIndex(name: string): number;
+    /**
+     * Subscribes to editor transaction events for active state tracking.
+     */
+    subscribe(): void;
+    /**
+     * Unsubscribes from editor events and cleans up.
+     */
+    destroy(): void;
+    /**
+     * Rebuilds groups and flat button list from editor.toolbarItems.
+     * When a layout is provided, uses layout-based resolution instead of default grouping.
+     */
+    private rebuild;
+    /**
+     * Groups items by their `group` property, preserving extension order within groups.
+     * Items without a group go into a default '' group.
+     * Within each group, items are sorted by priority (higher first).
+     */
+    private groupItems;
+    /**
+     * Resolves a layout array into ToolbarGroups by looking up registered items by name.
+     * Separators ('|') split items into visual groups.
+     * String entries resolve to existing buttons or dropdowns.
+     * ToolbarLayoutDropdown entries build custom dropdowns from named sub-items.
+     */
+    private resolveLayout;
+    /**
+     * Builds a flat list of top-level buttons/dropdowns for keyboard navigation.
+     */
+    private buildFlatList;
+    /**
+     * Updates active state map by checking editor.isActive() for each button.
+     */
+    private updateActiveStates;
+    private checkButtonDisabled;
+    private checkButtonActive;
+    private checkButtonExpanded;
+}
+export {};
+//# sourceMappingURL=ToolbarController.d.ts.map

package/dist/ToolbarController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarController.d.ts","sourceRoot":"","sources":["../src/ToolbarController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAmB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE1G;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CACN,gBAAgB,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACjF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC;IACX,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACnE,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACvD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAWD,2GAA2G;AAC3G,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACnE,QAAQ,CACN,gBAAgB,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACjF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC;CACZ;AAED,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO;IAW7E;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAWxE,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,uCAAuC;IACvC,OAAO,CAAC,OAAO,CAAsB;IAErC,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAA8B;IAEhD,0DAA0D;IAC1D,OAAO,CAAC,YAAY,CAA8B;IAElD,2EAA2E;IAC3E,OAAO,CAAC,YAAY,CAA8B;IAElD,iDAAiD;IACjD,OAAO,CAAC,aAAa,CAAuB;IAE5C,2DAA2D;IAC3D,OAAO,CAAC,aAAa,CAAK;IAE1B,gEAAgE;IAChE,OAAO,CAAC,YAAY,CAAoB;gBAE5B,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,MAAM,CAAC,EAAE,kBAAkB,EAAE;IAShG,IAAI,MAAM,IAAI,YAAY,EAAE,CAE3B;IAED,IAAI,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5C;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9C;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9C;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAID;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO;IAItC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO;IAIxC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAKzC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,aAAa,IAAI,IAAI;IASrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAOtB;;OAEG;IACH,YAAY,IAAI,MAAM;IAQtB;;OAEG;IACH,aAAa,IAAI,MAAM;IAMvB;;OAEG;IACH,YAAY,IAAI,MAAM;IAMtB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMlC;;OAEG;IACH,SAAS,IAAI,IAAI;IAQjB;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf;;;OAGG;IACH,OAAO,CAAC,OAAO;IASf;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAgClB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAoErB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;CAc5B"}

package/dist/ToolbarController.test.d.ts

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

package/dist/ToolbarController.test.d.ts.map

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

package/dist/commandPropsBuilder.d.ts

@@ -0,0 +1,70 @@
+import type { EditorState, Transaction } from '@domternal/pm/state';
+import type { EditorView } from '@domternal/pm/view';
+import type { CommandProps, ChainedCommands, CanCommands, SingleCommands } from './types/Commands.js';
+/**
+ * Minimal editor interface for command props building
+ */
+export interface CommandPropsEditor {
+    readonly view: EditorView;
+    readonly state: EditorState;
+}
+/**
+ * Options for building CommandProps
+ */
+export interface BuildCommandPropsOptions {
+    /** The editor instance */
+    editor: CommandPropsEditor;
+    /** The transaction to use */
+    tr: Transaction;
+    /**
+     * Dispatch function - undefined for dry-run mode
+     * In chain mode, this accumulates changes on shared transaction
+     */
+    dispatch: ((tr: Transaction) => void) | undefined;
+    /** Function to create chain commands */
+    chain: () => ChainedCommands;
+    /** Function to create can commands */
+    can: () => CanCommands;
+    /** Function to create single commands */
+    commands: () => SingleCommands;
+}
+/**
+ * Builds a CommandProps object with the given options
+ *
+ * @example
+ * // For chain mode with dispatch
+ * const props = buildCommandProps({
+ *   editor,
+ *   tr,
+ *   dispatch: (transaction) => { ... },
+ *   chain: () => this.proxy(),
+ *   can: () => this.buildCanCommands(),
+ *   commands: () => this.buildSingleCommands(),
+ * });
+ *
+ * @example
+ * // For dry-run mode (can check)
+ * const props = buildCommandProps({
+ *   editor,
+ *   tr,
+ *   dispatch: undefined,
+ *   chain: () => createChainBuilder(),
+ *   can: () => this.proxy(),
+ *   commands: () => this.buildSingleCommands(tr),
+ * });
+ */
+export declare function buildCommandProps(options: BuildCommandPropsOptions): CommandProps;
+/**
+ * Creates a dispatch function that accumulates steps on a shared transaction
+ *
+ * Used in chain mode where multiple commands share the same transaction.
+ * If a command creates a new transaction, its steps and metadata are copied
+ * to the shared one.
+ *
+ * Metadata propagation is critical for commands like undo/redo:
+ * prosemirror-history sets metadata (addToHistory, plugin state) on its
+ * transactions. Without copying this metadata, the shared transaction
+ * would be recorded as a new history entry, causing undo to oscillate.
+ */
+export declare function createAccumulatingDispatch(sharedTr: Transaction): (tr: Transaction) => void;
+//# sourceMappingURL=commandPropsBuilder.d.ts.map

package/dist/commandPropsBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandPropsBuilder.d.ts","sourceRoot":"","sources":["../src/commandPropsBuilder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAE3B,6BAA6B;IAC7B,EAAE,EAAE,WAAW,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAElD,wCAAwC;IACxC,KAAK,EAAE,MAAM,eAAe,CAAC;IAE7B,sCAAsC;IACtC,GAAG,EAAE,MAAM,WAAW,CAAC;IAEvB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,cAAc,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAcjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,WAAW,GAAG,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAgC3F"}

package/dist/commandPropsBuilder.test.d.ts

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

package/dist/commandPropsBuilder.test.d.ts.map

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

package/dist/commands/attributeCommands.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Attribute commands — updateAttributes, resetAttributes
+ */
+import type { CommandSpec } from '../types/Commands.js';
+/**
+ * UpdateAttributes command - updates attributes on nodes matching a type
+ *
+ * Updates attributes on all nodes of the specified type within the selection.
+ *
+ * @param typeOrName - The node type name or NodeType to update
+ * @param attributes - The attributes to merge into existing attributes
+ */
+export declare const updateAttributes: CommandSpec<[typeOrName: string, attributes: Record<string, unknown>]>;
+/**
+ * ResetAttributes command - resets an attribute to its default value
+ *
+ * Resets the specified attribute on all nodes of the given type within the selection
+ * to the default value defined in the schema.
+ *
+ * @param typeOrName - The node type name to update
+ * @param attributeName - The name of the attribute to reset
+ */
+export declare const resetAttributes: CommandSpec<[typeOrName: string, attributeName: string]>;
+//# sourceMappingURL=attributeCommands.d.ts.map

package/dist/commands/attributeCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributeCommands.d.ts","sourceRoot":"","sources":["../../src/commands/attributeCommands.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8DjG,CAAC;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,CAoElF,CAAC"}

package/dist/commands/attributeCommands.test.d.ts

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

package/dist/commands/attributeCommands.test.d.ts.map

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

package/dist/commands/builtIn.test.d.ts

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

package/dist/commands/builtIn.test.d.ts.map

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

package/dist/commands/contentCommands.d.ts

@@ -0,0 +1,52 @@
+import type { CommandSpec } from '../types/Commands.js';
+import type { Content } from '../types/index.js';
+/**
+ * Options for setContent command
+ */
+export interface SetContentOptions {
+    /**
+     * Emit update event after setting content
+     * @default true
+     */
+    emitUpdate?: boolean;
+    /**
+     * Parse options for HTML content
+     */
+    parseOptions?: Record<string, unknown>;
+}
+/**
+ * Options for clearContent command
+ */
+export interface ClearContentOptions {
+    /**
+     * Emit update event after clearing content
+     * @default true
+     */
+    emitUpdate?: boolean;
+}
+/**
+ * SetContent command - sets the editor content
+ *
+ * @param content - JSON or HTML content
+ * @param options - Options for setting content
+ */
+export declare const setContent: CommandSpec<[content: Content, options?: SetContentOptions]>;
+/**
+ * ClearContent command - clears the editor content to empty state
+ *
+ * @param options - Options for clearing content
+ */
+export declare const clearContent: CommandSpec<[options?: ClearContentOptions]>;
+/**
+ * InsertText command - inserts text at the current selection
+ *
+ * @param text - Text to insert
+ */
+export declare const insertText: CommandSpec<[text: string]>;
+/**
+ * InsertContent command - inserts content at the current selection
+ *
+ * @param content - The content to insert (JSON object, array, or HTML string)
+ */
+export declare const insertContent: CommandSpec<[content: Content]>;
+//# sourceMappingURL=contentCommands.d.ts.map

package/dist/commands/contentCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentCommands.d.ts","sourceRoot":"","sources":["../../src/commands/contentCommands.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAgCjF,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAyBnE,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAsBhD,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CA8CvD,CAAC"}

package/dist/commands/contentCommands.test.d.ts

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

package/dist/commands/contentCommands.test.d.ts.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Built-in commands for @domternal/core
+ *
+ * Re-exports from domain-specific command files and assembles the
+ * builtInCommands map consumed by CommandManager.
+ */
+import type { CommandMap } from '../types/Commands.js';
+export { focus, blur, selectAll, selectNodeBackward, deleteSelection, } from './selectionCommands.js';
+export { setContent, clearContent, insertText, insertContent, type SetContentOptions, type ClearContentOptions, } from './contentCommands.js';
+export { toggleMark, setMark, unsetMark, unsetAllMarks, } from './markCommands.js';
+export { setBlockType, toggleBlockType, wrapIn, toggleWrap, lift, } from './nodeCommands.js';
+export { toggleList } from './listCommands.js';
+export { updateAttributes, resetAttributes, } from './attributeCommands.js';
+export declare const builtInCommands: CommandMap;
+import type { Attrs } from '@domternal/pm/model';
+import type { FocusPosition, Content } from '../types/index.js';
+import type { SetContentOptions, ClearContentOptions } from './contentCommands.js';
+declare module '../types/Commands.js' {
+    interface RawCommands {
+        focus: CommandSpec<[position?: FocusPosition]>;
+        blur: CommandSpec;
+        setContent: CommandSpec<[content: Content, options?: SetContentOptions]>;
+        clearContent: CommandSpec<[options?: ClearContentOptions]>;
+        insertText: CommandSpec<[text: string]>;
+        deleteSelection: CommandSpec;
+        selectAll: CommandSpec;
+        toggleMark: CommandSpec<[markName: string, attributes?: Attrs]>;
+        setMark: CommandSpec<[markName: string, attributes?: Attrs]>;
+        unsetMark: CommandSpec<[markName: string]>;
+        unsetAllMarks: CommandSpec;
+        setBlockType: CommandSpec<[nodeName: string, attributes?: Attrs]>;
+        toggleBlockType: CommandSpec<[nodeName: string, defaultNodeName: string, attributes?: Attrs]>;
+        wrapIn: CommandSpec<[nodeName: string, attributes?: Attrs]>;
+        toggleWrap: CommandSpec<[nodeName: string, attributes?: Attrs]>;
+        lift: CommandSpec;
+        toggleList: CommandSpec<[listNodeName: string, listItemNodeName: string, attributes?: Attrs]>;
+        insertContent: CommandSpec<[content: Content]>;
+        selectNodeBackward: CommandSpec;
+        updateAttributes: CommandSpec<[typeOrName: string, attributes: Record<string, unknown>]>;
+        resetAttributes: CommandSpec<[typeOrName: string, attributeName: string]>;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/commands/listCommands.d.ts

@@ -0,0 +1,15 @@
+import type { Attrs } from '@domternal/pm/model';
+import type { CommandSpec } from '../types/Commands.js';
+/**
+ * ToggleList command - toggles a list type on the current selection
+ *
+ * If the selection is not in a list, wraps it in the specified list type.
+ * If it's in the same list type, lifts the list items out.
+ * If it's in a different list type, converts to the new list type in-place.
+ *
+ * @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
+ */
+export declare const toggleList: CommandSpec<[listNodeName: string, listItemNodeName: string, attributes?: Attrs]>;
+//# sourceMappingURL=listCommands.d.ts.map

package/dist/commands/listCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listCommands.d.ts","sourceRoot":"","sources":["../../src/commands/listCommands.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAA4B,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsCxD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAmQtG,CAAC"}

package/dist/commands/listCommands.test.d.ts

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

package/dist/commands/listCommands.test.d.ts.map

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