@domternal/core 0.3.0 → 0.4.1

package/dist/Mark.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Mark - Base class for mark extensions
+ *
+ * Marks define inline formatting that can be applied to text.
+ * Examples: Bold, Italic, Link, Code, 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 Bold = Mark.create({
+ *   name: 'bold',
+ *   parseHTML() {
+ *     return [
+ *       { tag: 'strong' },
+ *       { tag: 'b' },
+ *       { style: 'font-weight=bold' },
+ *     ];
+ *   },
+ *   renderHTML({ HTMLAttributes }) {
+ *     return ['strong', HTMLAttributes, 0];
+ *   },
+ * });
+ */
+import type { MarkSpec, MarkType } from '@domternal/pm/model';
+import { Extension, type ExtensionEditorInterface } from './Extension.js';
+import type { MarkConfig, MarkContext } from './types/MarkConfig.js';
+/**
+ * Extended editor interface for Mark
+ * Includes schema access for MarkType getter
+ */
+export interface MarkEditorInterface extends ExtensionEditorInterface {
+    readonly schema: {
+        marks: Record<string, MarkType>;
+    };
+}
+/**
+ * Base class for mark extensions
+ *
+ * @typeParam Options - Mark options type
+ * @typeParam Storage - Mark storage type
+ */
+export declare class Mark<Options = unknown, Storage = unknown> extends Extension<Options, Storage> {
+    /**
+     * Mark type identifier
+     * Distinguishes marks from extensions and nodes
+     */
+    readonly type: "mark";
+    /**
+     * The original configuration object
+     * Typed as MarkConfig for mark-specific properties
+     */
+    readonly config: MarkConfig<Options, Storage>;
+    /**
+     * Editor instance with schema access
+     * null until set by ExtensionManager
+     */
+    editor: MarkEditorInterface | null;
+    /**
+     * Protected constructor - use Mark.create() instead
+     */
+    protected constructor(config: MarkConfig<Options, Storage>);
+    /**
+     * Whether this mark represents visual formatting.
+     * Returns false for semantic marks (links, comments) that should
+     * survive `unsetAllMarks`. Defaults to true.
+     */
+    get isFormatting(): boolean;
+    /**
+     * Get the ProseMirror MarkType from schema
+     *
+     * This is a lazy getter because schema doesn't exist at mark creation time.
+     * Schema is built FROM marks by ExtensionManager.
+     *
+     * Returns null if editor is not yet initialized.
+     * Always check editor is set before using markType.
+     */
+    get markType(): MarkType | null;
+    /**
+     * Get MarkType or throw if not initialized.
+     * Use in contexts where editor is guaranteed to be set (like addCommands).
+     */
+    get markTypeOrThrow(): MarkType;
+    /**
+     * Creates a new mark instance
+     *
+     * @param config - Mark configuration
+     * @returns New mark instance
+     *
+     * @example
+     * const Bold = Mark.create({
+     *   name: 'bold',
+     *   parseHTML() {
+     *     return [{ tag: 'strong' }, { tag: 'b' }];
+     *   },
+     * });
+     */
+    static create<O = unknown, S = unknown>(config: MarkConfig<O, S>): Mark<O, S>;
+    /**
+     * Creates a new mark with merged options
+     * Original mark 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 mark instance with merged options
+     *
+     * @example
+     * const CustomBold = Bold.configure({ HTMLAttributes: { class: 'custom-bold' } });
+     *
+     * @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> & {
+        isFormatting?: boolean;
+    }): Mark<Options, Storage>;
+    /**
+     * Creates a new mark with extended configuration
+     * Original mark is not modified
+     *
+     * **Note:** Config is merged shallowly using object spread (`...`).
+     * Config properties (like `addAttributes`, `parseHTML`) are
+     * replaced entirely, not combined with the base mark's config.
+     *
+     * @param extendedConfig - Configuration to extend/override
+     * @returns New mark instance with extended config
+     *
+     * @example
+     * const CustomBold = Bold.extend({
+     *   name: 'customBold',
+     *   addAttributes() {
+     *     return { ...this.parent?.(), weight: { default: 'bold' } };
+     *   },
+     * });
+     *
+     * @example
+     * // To preserve base mark's parse rules while adding new ones:
+     * const Extended = BaseMark.extend({
+     *   parseHTML() {
+     *     const baseRules = BaseMark.config.parseHTML?.call(this) ?? [];
+     *     return [...baseRules, { tag: 'custom-tag' }];
+     *   },
+     * });
+     */
+    extend<ExtendedOptions = Options, ExtendedStorage = Storage>(extendedConfig: Partial<MarkConfig<ExtendedOptions, ExtendedStorage>> & ThisType<MarkContext<ExtendedOptions, ExtendedStorage>>): Mark<ExtendedOptions, ExtendedStorage>;
+    /**
+     * Creates a ProseMirror MarkSpec from this mark's configuration
+     *
+     * Called by ExtensionManager when building the schema.
+     * Converts our config format to ProseMirror's MarkSpec format.
+     *
+     * @returns ProseMirror MarkSpec
+     */
+    createMarkSpec(): MarkSpec;
+}
+//# sourceMappingURL=Mark.d.ts.map

package/dist/Mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mark.d.ts","sourceRoot":"","sources":["../src/Mark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAa,MAAM,qBAAqB,CAAC;AACzE,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;;;;OAIG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;;;;OAQG;IACH,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAK9B;IAED;;;OAGG;IACH,IAAI,eAAe,IAAI,QAAQ,CAS9B;IAED;;;;;;;;;;;;;OAaG;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;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;IAclG;;;;;;;;;;;;;;;;;;;;;;;;;;;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;CA+F3B"}

package/dist/Mark.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for Mark class
+ */
+export {};
+//# sourceMappingURL=Mark.test.d.ts.map

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

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

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":"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"}

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":""}