@notectl/core 1.0.3 → 1.0.5

package/dist/plugins/text-formatting.mjs

@@ -0,0 +1,52 @@
+import { A as t, r as e } from "../chunks/Commands-DLP85Mp5.mjs";
+import { m as i } from "../chunks/TypeBrands-C09nE2qO.mjs";
+import { f as o } from "../chunks/ToolbarItem-ugDymuXi.mjs";
+const r = { bold: true, italic: true, underline: true }, s = [{ type: "bold", configKey: "bold", rank: 0, tag: "strong", label: "Bold", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.6 10.79c.97-.67 1.65-1.77 1.65-2.79 0-2.26-1.75-4-4-4H7v14h7.04c2.09 0 3.71-1.7 3.71-3.79 0-1.52-.86-2.82-2.15-3.42zM10 6.5h3c.83 0 1.5.67 1.5 1.5s-.67 1.5-1.5 1.5h-3v-3zm3.5 9H10v-3h3.5c.83 0 1.5.67 1.5 1.5s-.67 1.5-1.5 1.5z"/></svg>', keyBinding: "Mod-B", toHTMLString: (t2) => `<strong>${t2}</strong>`, parseHTML: [{ tag: "strong" }, { tag: "b" }], sanitize: { tags: ["strong", "b"] } }, { type: "italic", configKey: "italic", rank: 1, tag: "em", label: "Italic", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 4v3h2.21l-3.42 8H6v3h8v-3h-2.21l3.42-8H18V4z"/></svg>', keyBinding: "Mod-I", toHTMLString: (t2) => `<em>${t2}</em>`, parseHTML: [{ tag: "em" }, { tag: "i" }], sanitize: { tags: ["em", "i"] } }, { type: "underline", configKey: "underline", rank: 2, tag: "u", label: "Underline", icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 17c3.31 0 6-2.69 6-6V3h-2.5v8c0 1.93-1.57 3.5-3.5 3.5S8.5 12.93 8.5 11V3H6v8c0 3.31 2.69 6 6 6zm-7 2v2h14v-2H5z"/></svg>', keyBinding: "Mod-U", toHTMLString: (t2) => `<u>${t2}</u>`, parseHTML: [{ tag: "u" }], sanitize: { tags: ["u"] } }];
+class n {
+  id = "text-formatting";
+  name = "Text Formatting";
+  priority = 20;
+  config;
+  constructor(t2) {
+    this.config = { ...r, ...t2 };
+  }
+  init(t2) {
+    const e2 = s.filter((t3) => this.config[t3.configKey]), i2 = e2.filter((t3) => this.isToolbarVisible(t3.configKey)).at(-1);
+    for (const o2 of e2) {
+      const e3 = this.config.separatorAfter && o2 === i2;
+      this.registerMark(t2, o2, e3);
+    }
+    this.registerKeymaps(t2, e2), this.registerDisabledToolbarItems(t2);
+  }
+  registerMark(r2, s2, n2) {
+    const g = a(s2.type), c = this.isToolbarVisible(s2.configKey);
+    r2.registerMarkSpec({ type: s2.type, rank: s2.rank, toDOM: () => document.createElement(s2.tag), toHTMLString: (t2, e2) => s2.toHTMLString(e2), parseHTML: s2.parseHTML, sanitize: s2.sanitize }), r2.registerCommand(g, () => {
+      const e2 = t(r2.getState(), i(s2.type));
+      return !!e2 && (r2.dispatch(e2), true);
+    }), c && r2.registerToolbarItem({ id: s2.type, group: "format", icon: s2.icon, label: s2.label, tooltip: `${s2.label} (${o(s2.keyBinding)})`, command: g, priority: 10 * s2.rank + 10, separatorAfter: n2, isActive: (t2) => e(t2, i(s2.type)) });
+  }
+  registerKeymaps(t2, e2) {
+    const i2 = {};
+    for (const o2 of e2) {
+      const e3 = a(o2.type);
+      i2[o2.keyBinding] = () => t2.executeCommand(e3);
+    }
+    Object.keys(i2).length > 0 && t2.registerKeymap(i2);
+  }
+  registerDisabledToolbarItems(t2) {
+    if (this.config.toolbar) for (const e2 of s) {
+      const i2 = this.config[e2.configKey], o2 = this.config.toolbar[e2.configKey] ?? true;
+      !i2 && o2 && t2.registerToolbarItem({ id: e2.type, group: "format", icon: e2.icon, label: e2.label, command: a(e2.type), priority: 10 * e2.rank + 10, isEnabled: () => false });
+    }
+  }
+  isToolbarVisible(t2) {
+    return !this.config.toolbar || (this.config.toolbar[t2] ?? true);
+  }
+}
+function a(t2) {
+  return `toggle${t2.charAt(0).toUpperCase()}${t2.slice(1)}`;
+}
+export {
+  n as TextFormattingPlugin
+};
+//# sourceMappingURL=text-formatting.mjs.map

package/dist/plugins/text-formatting.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-formatting.mjs","sources":["../../src/plugins/text-formatting/TextFormattingPlugin.ts"],"sourcesContent":["/**\n * TextFormattingPlugin: registers inline marks (bold, italic, underline)\n * with their MarkSpecs, toggle commands, keyboard shortcuts, and toolbar items.\n *\n * This plugin is data-driven — each mark type is defined declaratively and\n * all registrations (MarkSpec, command, keymap, toolbar item) are derived\n * from the same definition.\n *\n * Supports two separate config dimensions:\n * - Feature config (bold/italic/underline): controls whether the mark is\n *   registered in the schema. When disabled, the keyboard shortcut does nothing.\n * - Toolbar config: controls whether the toolbar button is visible.\n *   When a feature is disabled but toolbar is enabled, the button renders as disabled.\n */\n\nimport { isMarkActive, toggleMark } from '../../commands/Commands.js';\nimport type { ParseRule } from '../../model/ParseRule.js';\nimport type { SanitizeConfig } from '../../model/SanitizeConfig.js';\nimport { markType as mkType } from '../../model/TypeBrands.js';\nimport type { Plugin, PluginContext } from '../Plugin.js';\nimport { formatShortcut } from '../toolbar/ToolbarItem.js';\n\n// --- Configuration ---\n\n/** Controls toolbar button visibility per mark. */\nexport interface TextFormattingToolbarConfig {\n\treadonly bold?: boolean;\n\treadonly italic?: boolean;\n\treadonly underline?: boolean;\n}\n\n/** Controls which inline marks are enabled and which toolbar buttons are shown. */\nexport interface TextFormattingConfig {\n\treadonly bold: boolean;\n\treadonly italic: boolean;\n\treadonly underline: boolean;\n\treadonly toolbar?: TextFormattingToolbarConfig;\n\t/** When true, a separator is rendered after the last text-formatting toolbar item. */\n\treadonly separatorAfter?: boolean;\n}\n\nconst DEFAULT_CONFIG: TextFormattingConfig = {\n\tbold: true,\n\titalic: true,\n\tunderline: true,\n};\n\n// --- Mark Definitions ---\n\ninterface MarkDefinition {\n\treadonly type: string;\n\treadonly configKey: keyof Omit<TextFormattingConfig, 'toolbar' | 'separatorAfter'>;\n\treadonly rank: number;\n\treadonly tag: string;\n\treadonly label: string;\n\treadonly icon: string;\n\treadonly keyBinding: string;\n\treadonly toHTMLString: (content: string) => string;\n\treadonly parseHTML: readonly ParseRule[];\n\treadonly sanitize: SanitizeConfig;\n}\n\nconst BOLD_ICON =\n\t'<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\"><path d=\"M15.6 10.79c.97-.67 1.65-1.77 1.65-2.79 0-2.26-1.75-4-4-4H7v14h7.04c2.09 0 3.71-1.7 3.71-3.79 0-1.52-.86-2.82-2.15-3.42zM10 6.5h3c.83 0 1.5.67 1.5 1.5s-.67 1.5-1.5 1.5h-3v-3zm3.5 9H10v-3h3.5c.83 0 1.5.67 1.5 1.5s-.67 1.5-1.5 1.5z\"/></svg>';\nconst ITALIC_ICON =\n\t'<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\"><path d=\"M10 4v3h2.21l-3.42 8H6v3h8v-3h-2.21l3.42-8H18V4z\"/></svg>';\nconst UNDERLINE_ICON =\n\t'<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\"><path d=\"M12 17c3.31 0 6-2.69 6-6V3h-2.5v8c0 1.93-1.57 3.5-3.5 3.5S8.5 12.93 8.5 11V3H6v8c0 3.31 2.69 6 6 6zm-7 2v2h14v-2H5z\"/></svg>';\n\nconst MARK_DEFINITIONS: readonly MarkDefinition[] = [\n\t{\n\t\ttype: 'bold',\n\t\tconfigKey: 'bold',\n\t\trank: 0,\n\t\ttag: 'strong',\n\t\tlabel: 'Bold',\n\t\ticon: BOLD_ICON,\n\t\tkeyBinding: 'Mod-B',\n\t\ttoHTMLString: (content) => `<strong>${content}</strong>`,\n\t\tparseHTML: [{ tag: 'strong' }, { tag: 'b' }],\n\t\tsanitize: { tags: ['strong', 'b'] },\n\t},\n\t{\n\t\ttype: 'italic',\n\t\tconfigKey: 'italic',\n\t\trank: 1,\n\t\ttag: 'em',\n\t\tlabel: 'Italic',\n\t\ticon: ITALIC_ICON,\n\t\tkeyBinding: 'Mod-I',\n\t\ttoHTMLString: (content) => `<em>${content}</em>`,\n\t\tparseHTML: [{ tag: 'em' }, { tag: 'i' }],\n\t\tsanitize: { tags: ['em', 'i'] },\n\t},\n\t{\n\t\ttype: 'underline',\n\t\tconfigKey: 'underline',\n\t\trank: 2,\n\t\ttag: 'u',\n\t\tlabel: 'Underline',\n\t\ticon: UNDERLINE_ICON,\n\t\tkeyBinding: 'Mod-U',\n\t\ttoHTMLString: (content) => `<u>${content}</u>`,\n\t\tparseHTML: [{ tag: 'u' }],\n\t\tsanitize: { tags: ['u'] },\n\t},\n];\n\n// --- Plugin ---\n\nexport class TextFormattingPlugin implements Plugin {\n\treadonly id = 'text-formatting';\n\treadonly name = 'Text Formatting';\n\treadonly priority = 20;\n\n\tprivate readonly config: TextFormattingConfig;\n\n\tconstructor(config?: Partial<TextFormattingConfig>) {\n\t\tthis.config = { ...DEFAULT_CONFIG, ...config };\n\t}\n\n\tinit(context: PluginContext): void {\n\t\tconst enabledMarks = MARK_DEFINITIONS.filter((def) => this.config[def.configKey]);\n\n\t\t// Determine which marks will have visible toolbar items\n\t\tconst visibleToolbarMarks = enabledMarks.filter((def) => this.isToolbarVisible(def.configKey));\n\t\tconst lastVisibleMark = visibleToolbarMarks.at(-1);\n\n\t\tfor (const def of enabledMarks) {\n\t\t\tconst isSeparatorTarget = this.config.separatorAfter && def === lastVisibleMark;\n\t\t\tthis.registerMark(context, def, isSeparatorTarget);\n\t\t}\n\n\t\tthis.registerKeymaps(context, enabledMarks);\n\n\t\t// Register disabled placeholder buttons for marks that are disabled\n\t\t// as features but explicitly requested in the toolbar config\n\t\tthis.registerDisabledToolbarItems(context);\n\t}\n\n\tprivate registerMark(\n\t\tcontext: PluginContext,\n\t\tdef: MarkDefinition,\n\t\tseparatorAfter?: boolean,\n\t): void {\n\t\tconst commandName = toCommandName(def.type);\n\t\tconst toolbarVisible = this.isToolbarVisible(def.configKey);\n\n\t\tcontext.registerMarkSpec({\n\t\t\ttype: def.type,\n\t\t\trank: def.rank,\n\t\t\ttoDOM() {\n\t\t\t\treturn document.createElement(def.tag);\n\t\t\t},\n\t\t\ttoHTMLString: (_mark, content) => def.toHTMLString(content),\n\t\t\tparseHTML: def.parseHTML,\n\t\t\tsanitize: def.sanitize,\n\t\t});\n\n\t\tcontext.registerCommand(commandName, () => {\n\t\t\tconst tr = toggleMark(context.getState(), mkType(def.type));\n\t\t\tif (tr) {\n\t\t\t\tcontext.dispatch(tr);\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\treturn false;\n\t\t});\n\n\t\tif (toolbarVisible) {\n\t\t\tcontext.registerToolbarItem({\n\t\t\t\tid: def.type,\n\t\t\t\tgroup: 'format',\n\t\t\t\ticon: def.icon,\n\t\t\t\tlabel: def.label,\n\t\t\t\ttooltip: `${def.label} (${formatShortcut(def.keyBinding)})`,\n\t\t\t\tcommand: commandName,\n\t\t\t\tpriority: def.rank * 10 + 10,\n\t\t\t\tseparatorAfter,\n\t\t\t\tisActive: (state) => isMarkActive(state, mkType(def.type)),\n\t\t\t});\n\t\t}\n\t}\n\n\tprivate registerKeymaps(context: PluginContext, marks: readonly MarkDefinition[]): void {\n\t\tconst keymap: Record<string, () => boolean> = {};\n\t\tfor (const def of marks) {\n\t\t\tconst commandName = toCommandName(def.type);\n\t\t\tkeymap[def.keyBinding] = () => context.executeCommand(commandName);\n\t\t}\n\t\tif (Object.keys(keymap).length > 0) {\n\t\t\tcontext.registerKeymap(keymap);\n\t\t}\n\t}\n\n\t/**\n\t * Registers disabled toolbar buttons for marks whose feature is disabled\n\t * but whose toolbar button is explicitly requested.\n\t */\n\tprivate registerDisabledToolbarItems(context: PluginContext): void {\n\t\tif (!this.config.toolbar) return;\n\n\t\tfor (const def of MARK_DEFINITIONS) {\n\t\t\tconst featureEnabled = this.config[def.configKey];\n\t\t\tconst toolbarVisible = this.config.toolbar[def.configKey] ?? true;\n\n\t\t\tif (!featureEnabled && toolbarVisible) {\n\t\t\t\tcontext.registerToolbarItem({\n\t\t\t\t\tid: def.type,\n\t\t\t\t\tgroup: 'format',\n\t\t\t\t\ticon: def.icon,\n\t\t\t\t\tlabel: def.label,\n\t\t\t\t\tcommand: toCommandName(def.type),\n\t\t\t\t\tpriority: def.rank * 10 + 10,\n\t\t\t\t\tisEnabled: () => false,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Checks if a toolbar button should be visible for a given mark. */\n\tprivate isToolbarVisible(\n\t\tconfigKey: keyof Omit<TextFormattingConfig, 'toolbar' | 'separatorAfter'>,\n\t): boolean {\n\t\tif (!this.config.toolbar) return true;\n\t\treturn this.config.toolbar[configKey] ?? true;\n\t}\n}\n\n/** Converts a mark type to its toggle command name (e.g. 'bold' → 'toggleBold'). */\nfunction toCommandName(markType: string): string {\n\treturn `toggle${markType.charAt(0).toUpperCase()}${markType.slice(1)}`;\n}\n"],"names":["DEFAULT_CONFIG","bold","italic","underline","MARK_DEFINITIONS","type","configKey","rank","tag","label","icon","keyBinding","toHTMLString","content","parseHTML","sanitize","tags","TextFormattingPlugin","id","name","priority","config","this","context","enabledMarks","filter","def","lastVisibleMark","isToolbarVisible","at","isSeparatorTarget","separatorAfter","registerMark","registerKeymaps","registerDisabledToolbarItems","commandName","toCommandName","toolbarVisible","registerMarkSpec","toDOM","document","createElement","_mark","registerCommand","tr","toggleMark","getState","mkType","dispatch","registerToolbarItem","group","tooltip","formatShortcut","command","isActive","state","isMarkActive","marks","keymap","executeCommand","Object","keys","length","registerKeymap","toolbar","featureEnabled","isEnabled","markType","charAt","toUpperCase","slice"],"mappings":"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"}

package/dist/plugins/toolbar/ToolbarItem.d.ts

@@ -0,0 +1,66 @@
+import { EditorState } from '../../state/EditorState.js';
+import { PluginContext } from '../Plugin.js';
+export interface GridPickerConfig {
+    readonly maxRows: number;
+    readonly maxCols: number;
+    onSelect(rows: number, cols: number): void;
+}
+export interface DropdownConfig {
+    readonly items: readonly {
+        label: string;
+        command: string;
+        icon?: string;
+    }[];
+}
+export type ToolbarGroup = 'format' | 'block' | 'insert' | (string & {});
+export type PopupType = 'gridPicker' | 'dropdown' | 'custom';
+interface ToolbarItemBase {
+    readonly id: string;
+    /** Grouping key: 'format' | 'insert' | 'block' or custom. */
+    readonly group: ToolbarGroup;
+    /** Icon content: inline SVG markup or plain text. Rendered via innerHTML. */
+    readonly icon: string;
+    readonly label: string;
+    /** Tooltip shown on hover, e.g. "Bold (Ctrl+B)". Falls back to label. */
+    readonly tooltip?: string;
+    /** Command name to execute on click. */
+    readonly command: string;
+    /**
+     * Lower priority renders further left.
+     * @deprecated Use the declarative `toolbar` config on `createEditor()` instead.
+     */
+    readonly priority?: number;
+    /**
+     * When true, a visual separator is rendered after this item.
+     * @deprecated Use the declarative `toolbar` config on `createEditor()` instead.
+     */
+    readonly separatorAfter?: boolean;
+    isActive?(state: EditorState): boolean;
+    isEnabled?(state: EditorState): boolean;
+}
+interface ToolbarItemNoPopup extends ToolbarItemBase {
+    readonly popupType?: undefined;
+}
+interface ToolbarItemGridPicker extends ToolbarItemBase {
+    readonly popupType: 'gridPicker';
+    readonly popupConfig: GridPickerConfig;
+}
+interface ToolbarItemDropdown extends ToolbarItemBase {
+    readonly popupType: 'dropdown';
+    readonly popupConfig: DropdownConfig;
+}
+interface ToolbarItemCustomPopup extends ToolbarItemBase {
+    readonly popupType: 'custom';
+    renderPopup(container: HTMLElement, context: PluginContext, onClose: () => void): void;
+}
+export type ToolbarItem = ToolbarItemNoPopup | ToolbarItemGridPicker | ToolbarItemDropdown | ToolbarItemCustomPopup;
+/**
+ * Formats a keymap binding string into a human-readable shortcut,
+ * using platform-appropriate modifier symbols (⌘ on Mac, Ctrl on others).
+ *
+ * @example formatShortcut('Mod-B') → "Ctrl+B" or "⌘B"
+ * @example formatShortcut('Mod-Shift-X') → "Ctrl+Shift+X" or "⌘⇧X"
+ */
+export declare function formatShortcut(binding: string): string;
+export {};
+//# sourceMappingURL=ToolbarItem.d.ts.map

package/dist/plugins/toolbar/ToolbarItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarItem.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/ToolbarItem.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7E;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACzE,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE7D,UAAU,eAAe;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IACvC,SAAS,CAAC,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;CACxC;AAED,UAAU,kBAAmB,SAAQ,eAAe;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED,UAAU,qBAAsB,SAAQ,eAAe;IACtD,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;CACvC;AAED,UAAU,mBAAoB,SAAQ,eAAe;IACpD,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;CACrC;AAED,UAAU,sBAAuB,SAAQ,eAAe;IACvD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACvF;AAED,MAAM,MAAM,WAAW,GACpB,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,sBAAsB,CAAC;AAE1B;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUtD"}

package/dist/plugins/toolbar/ToolbarKeyboardNav.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Keyboard navigation helpers for the toolbar (WAI-ARIA Toolbar pattern).
+ * Pure functions that operate on arrays of buttons and DOM elements.
+ */
+/** Returns indices of all enabled buttons. */
+export declare function getEnabledIndices(buttons: readonly HTMLButtonElement[]): number[];
+/** Finds the next enabled button index in the given direction (wraps around). */
+export declare function findNextEnabled(buttons: readonly HTMLButtonElement[], current: number, direction: 1 | -1): number;
+/** Finds the first enabled button index. */
+export declare function findFirstEnabled(buttons: readonly HTMLButtonElement[]): number;
+/** Finds the last enabled button index. */
+export declare function findLastEnabled(buttons: readonly HTMLButtonElement[]): number;
+/**
+ * Applies roving tabindex: sets tabindex="0" on the focused button,
+ * tabindex="-1" on all others.
+ */
+export declare function applyRovingTabindex(buttons: readonly HTMLButtonElement[], focusedIndex: number): void;
+/** Navigates dropdown items with arrow keys (wraps around). */
+export declare function findNextDropdownItem(items: readonly HTMLElement[], current: number, direction: 1 | -1): number;
+/**
+ * Navigates a grid of cells with arrow keys.
+ * Returns the new [row, col] position.
+ */
+export declare function navigateGrid(row: number, col: number, maxRows: number, maxCols: number, key: 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight'): [number, number];
+//# sourceMappingURL=ToolbarKeyboardNav.d.ts.map

package/dist/plugins/toolbar/ToolbarKeyboardNav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarKeyboardNav.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/ToolbarKeyboardNav.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAQjF;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAC9B,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GACf,MAAM,CAYR;AAED,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAK9E;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAK7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,YAAY,EAAE,MAAM,GAClB,IAAI,CAON;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GACf,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GACvD,CAAC,MAAM,EAAE,MAAM,CAAC,CAWlB"}

package/dist/plugins/toolbar/ToolbarPlugin.d.ts

@@ -0,0 +1,47 @@
+import { EditorState } from '../../state/EditorState.js';
+import { Transaction } from '../../state/Transaction.js';
+import { ServiceKey, Plugin, PluginConfig, PluginContext } from '../Plugin.js';
+export interface ToolbarLayoutConfig {
+    readonly groups: ReadonlyArray<ReadonlyArray<string>>;
+}
+export interface ToolbarServiceAPI {
+    /** Re-reads isActive/isEnabled from state and updates all buttons. */
+    refresh(): void;
+    /** Closes the currently open popup, if any. */
+    closePopup(): void;
+}
+export declare const ToolbarServiceKey: ServiceKey<ToolbarServiceAPI>;
+export declare class ToolbarPlugin implements Plugin {
+    readonly id = "toolbar";
+    readonly name = "Toolbar";
+    readonly priority = 10;
+    private context;
+    private toolbarElement;
+    private buttons;
+    private readonly hiddenItems;
+    private readonly layoutConfig;
+    private focusedIndex;
+    private tooltip;
+    private popupController;
+    constructor(layoutConfig?: ToolbarLayoutConfig);
+    init(context: PluginContext): void;
+    onReady(): void;
+    destroy(): void;
+    onStateChange(_oldState: EditorState, newState: EditorState, _tr: Transaction): void;
+    onConfigure(config: PluginConfig): void;
+    private createToolbarElement;
+    private renderItems;
+    private initRovingTabindex;
+    private setRovingFocus;
+    /** Returns the active element, respecting shadow DOM boundaries. */
+    private getActiveElement;
+    private syncFocusedIndex;
+    private handleToolbarKeydown;
+    /** Activates a toolbar button (shared between mouse click and keyboard). */
+    private activateButton;
+    private renderItemsByLayout;
+    private renderItemsByPriority;
+    private createButton;
+    private updateButtonStates;
+}
+//# sourceMappingURL=ToolbarPlugin.d.ts.map

package/dist/plugins/toolbar/ToolbarPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/ToolbarPlugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAcxE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;CACtD;AAID,MAAM,WAAW,iBAAiB;IACjC,sEAAsE;IACtE,OAAO,IAAI,IAAI,CAAC;IAChB,+CAA+C;IAC/C,UAAU,IAAI,IAAI,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,+BAA+C,CAAC;AAS9E,qBAAa,aAAc,YAAW,MAAM;IAC3C,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,QAAQ,MAAM;IAEvB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,eAAe,CAAuC;gBAElD,YAAY,CAAC,EAAE,mBAAmB;IAI9C,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAelC,OAAO,IAAI,IAAI;IAIf,OAAO,IAAI,IAAI;IAaf,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;IAIpF,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAavC,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,cAAc;IAQtB,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,oBAAoB;IAyC5B,4EAA4E;IAC5E,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,qBAAqB;IAwD7B,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,kBAAkB;CAc1B"}

package/dist/plugins/toolbar/ToolbarPopupController.d.ts

@@ -0,0 +1,25 @@
+import { PluginContext } from '../Plugin.js';
+import { ToolbarItem } from './ToolbarItem.js';
+export declare class ToolbarPopupController {
+    private activePopup;
+    private activePopupButton;
+    private closePopupHandler;
+    private readonly getActiveElement;
+    constructor(getActiveElement: () => Element | null);
+    /** Whether a popup is currently open. */
+    isOpen(): boolean;
+    /** Toggles a popup for the given toolbar button. */
+    toggle(button: HTMLButtonElement, item: ToolbarItem, context: PluginContext): void;
+    /** Closes the active popup and cleans up event listeners. */
+    close(): void;
+    /** Closes popup and restores focus to the trigger button. */
+    closeAndRestoreFocus(): void;
+    destroy(): void;
+    private positionAndAppend;
+    private focusFirstItem;
+    private handlePopupKeydown;
+    private handleDropdownKeydown;
+    private handleGridKeydown;
+    private handleCustomPopupKeydown;
+}
+//# sourceMappingURL=ToolbarPopupController.d.ts.map

package/dist/plugins/toolbar/ToolbarPopupController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarPopupController.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/ToolbarPopupController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,qBAAa,sBAAsB;IAClC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;gBAE5C,gBAAgB,EAAE,MAAM,OAAO,GAAG,IAAI;IAIlD,yCAAyC;IACzC,MAAM,IAAI,OAAO;IAIjB,oDAAoD;IACpD,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAkDlF,6DAA6D;IAC7D,KAAK,IAAI,IAAI;IAgBb,6DAA6D;IAC7D,oBAAoB,IAAI,IAAI;IAM5B,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,wBAAwB;CA8BhC"}

package/dist/plugins/toolbar/ToolbarRenderers.d.ts

@@ -0,0 +1,19 @@
+import { DropdownConfig, GridPickerConfig } from './ToolbarItem.js';
+/**
+ * Renders a grid picker into the given container.
+ * Calls `onClose` after a cell is selected so the popup can be dismissed.
+ */
+export declare function renderGridPicker(container: HTMLElement, config: GridPickerConfig, onClose: () => void): void;
+/**
+ * Highlights grid cells up to the given row/col and updates the label.
+ * Used by both mouse hover and keyboard navigation.
+ */
+export declare function highlightCells(grid: HTMLElement, targetRow: number, targetCol: number): void;
+/**
+ * Renders a dropdown menu into the given container.
+ * Calls `onClose` after an item is activated so the popup can be dismissed.
+ */
+export declare function renderDropdown(container: HTMLElement, config: DropdownConfig, executeCommand: (command: string) => void, onClose: () => void): void;
+/** Creates a toolbar group separator element. */
+export declare function createSeparator(): HTMLSpanElement;
+//# sourceMappingURL=ToolbarRenderers.d.ts.map

package/dist/plugins/toolbar/ToolbarRenderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarRenderers.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/ToolbarRenderers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzE;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,MAAM,IAAI,GACjB,IAAI,CAwDN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO5F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACzC,OAAO,EAAE,MAAM,IAAI,GACjB,IAAI,CAqCN;AAED,iDAAiD;AACjD,wBAAgB,eAAe,IAAI,eAAe,CAKjD"}

package/dist/plugins/toolbar/ToolbarTooltip.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ToolbarTooltip: manages the tooltip lifecycle for toolbar buttons.
+ * Shows a tooltip after a short delay when hovering or focusing a button,
+ * hides it when the cursor leaves or focus moves away.
+ */
+export declare class ToolbarTooltip {
+    private readonly element;
+    private timer;
+    private target;
+    private readonly isPopupActive;
+    static readonly TOOLTIP_ID = "notectl-toolbar-tooltip";
+    constructor(isPopupActive: () => boolean);
+    show(button: HTMLButtonElement): void;
+    hide(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ToolbarTooltip.d.ts.map

package/dist/plugins/toolbar/ToolbarTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolbarTooltip.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/ToolbarTooltip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,MAAM,CAAC,QAAQ,CAAC,UAAU,6BAA6B;gBAE3C,aAAa,EAAE,MAAM,OAAO;IASxC,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAiCrC,IAAI,IAAI,IAAI;IAYZ,OAAO,IAAI,IAAI;CAIf"}

package/dist/plugins/toolbar/index.d.ts

@@ -0,0 +1,4 @@
+export { ToolbarPlugin, ToolbarServiceKey, type ToolbarServiceAPI, type ToolbarLayoutConfig, } from './ToolbarPlugin.js';
+export type { ToolbarItem, ToolbarGroup, PopupType, GridPickerConfig, DropdownConfig, } from './ToolbarItem.js';
+export { formatShortcut } from './ToolbarItem.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/toolbar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/toolbar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,cAAc,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugins/toolbar.mjs

@@ -0,0 +1,8 @@
+import { T, a } from "../chunks/ToolbarPlugin-D5VqeBPT.mjs";
+import { f } from "../chunks/ToolbarItem-ugDymuXi.mjs";
+export {
+  T as ToolbarPlugin,
+  a as ToolbarServiceKey,
+  f as formatShortcut
+};
+//# sourceMappingURL=toolbar.mjs.map

package/dist/plugins/toolbar.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/state/EditorState.d.ts

@@ -0,0 +1,40 @@
+import { BlockNode, Document, Mark } from '../model/Document.js';
+import { Schema } from '../model/Schema.js';
+import { EditorSelection } from '../model/Selection.js';
+import { BlockId } from '../model/TypeBrands.js';
+import { Transaction, TransactionBuilder } from './Transaction.js';
+export declare class EditorState {
+    readonly doc: Document;
+    readonly selection: EditorSelection;
+    readonly storedMarks: readonly Mark[] | null;
+    readonly schema: Schema;
+    private _blockMap;
+    private _blockOrder;
+    private constructor();
+    /** Creates a new EditorState with default document. */
+    static create(options?: {
+        doc?: Document;
+        selection?: EditorSelection;
+        schema?: Schema;
+    }): EditorState;
+    /** Creates a TransactionBuilder from this state. */
+    transaction(origin?: 'input' | 'paste' | 'command' | 'history' | 'api'): TransactionBuilder;
+    /** Applies a transaction and returns a new EditorState. */
+    apply(tr: Transaction): EditorState;
+    /** Finds a block by its ID anywhere in the tree. Uses a lazy-built Map for O(1) lookup. */
+    getBlock(blockId: BlockId): BlockNode | undefined;
+    /** Returns leaf-block IDs in depth-first order. Cached after first call. */
+    getBlockOrder(): readonly BlockId[];
+    /** Returns the path (array of block IDs) to a node. */
+    getNodePath(nodeId: BlockId): BlockId[] | undefined;
+    /** Returns the parent BlockNode of a node, or undefined for top-level blocks. */
+    getParent(nodeId: BlockId): BlockNode | undefined;
+    /** Serializes the state to JSON. */
+    toJSON(): object;
+    /** Deserializes a state from JSON. */
+    static fromJSON(json: {
+        doc: Document;
+        selection: EditorSelection;
+    }, schema?: Schema): EditorState;
+}
+//# sourceMappingURL=EditorState.d.ts.map

package/dist/state/EditorState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditorState.d.ts","sourceRoot":"","sources":["../../src/state/EditorState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,IAAI,EAKT,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,uBAAuB,CAAC;AAOvE,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,qBAAa,WAAW;IACvB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,IAAI,EAAE,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,WAAW,CAAmC;IAEtD,OAAO;IAYP,uDAAuD;IACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QACvB,GAAG,CAAC,EAAE,QAAQ,CAAC;QACf,SAAS,CAAC,EAAE,eAAe,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,WAAW;IAUf,oDAAoD;IACpD,WAAW,CACV,MAAM,GAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,KAAa,GAC/D,kBAAkB;IAIrB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW;IAWnC,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;IAKjD,4EAA4E;IAC5E,aAAa,IAAI,SAAS,OAAO,EAAE;IAKnC,uDAAuD;IACvD,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS;IAInD,iFAAiF;IACjF,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS;IAQjD,oCAAoC;IACpC,MAAM,IAAI,MAAM;IAOhB,sCAAsC;IACtC,MAAM,CAAC,QAAQ,CACd,IAAI,EAAE;QAAE,GAAG,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,EACnD,MAAM,CAAC,EAAE,MAAM,GACb,WAAW;CAGd"}

package/dist/state/History.d.ts

@@ -0,0 +1,38 @@
+import { EditorState } from './EditorState.js';
+import { Transaction } from './Transaction.js';
+export interface HistoryResult {
+    readonly state: EditorState;
+    readonly transaction: Transaction;
+}
+export declare class HistoryManager {
+    private undoStack;
+    private redoStack;
+    private readonly groupTimeoutMs;
+    private readonly maxDepth;
+    private lastOrigin;
+    constructor(options?: {
+        groupTimeoutMs?: number;
+        maxDepth?: number;
+    });
+    /**
+     * Pushes a transaction onto the undo stack.
+     * Groups consecutive input transactions within the timeout window.
+     */
+    push(tr: Transaction): void;
+    /** Undoes the last group and returns the new state with transaction, or null if nothing to undo. */
+    undo(state: EditorState): HistoryResult | null;
+    /** Redoes the last undone group and returns the new state with transaction, or null if nothing to redo. */
+    redo(state: EditorState): HistoryResult | null;
+    /** Returns true if there are entries to undo. */
+    canUndo(): boolean;
+    /** Returns true if there are entries to redo. */
+    canRedo(): boolean;
+    /** Clears all history. */
+    clear(): void;
+    /**
+     * Checks if consecutive transactions are of the same "type" for grouping.
+     * Groups text insertion together, deletion together, but not mixed.
+     */
+    private isSameInputType;
+}
+//# sourceMappingURL=History.d.ts.map

package/dist/state/History.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"History.d.ts","sourceRoot":"","sources":["../../src/state/History.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG1D,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CAClC;AAUD,qBAAa,cAAc;IAC1B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAuB;gBAE7B,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAKpE;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAsC3B,oGAAoG;IACpG,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI;IAmC9C,2GAA2G;IAC3G,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI;IAgC9C,iDAAiD;IACjD,OAAO,IAAI,OAAO;IAIlB,iDAAiD;IACjD,OAAO,IAAI,OAAO;IAIlB,0BAA0B;IAC1B,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,OAAO,CAAC,eAAe;CAUvB"}

package/dist/state/StepApplication.d.ts

@@ -0,0 +1,5 @@
+import { Document } from '../model/Document.js';
+import { Step } from './Transaction.js';
+/** Applies a single step to a document and returns the new document. */
+export declare function applyStep(doc: Document, step: Step): Document;
+//# sourceMappingURL=StepApplication.d.ts.map

package/dist/state/StepApplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepApplication.d.ts","sourceRoot":"","sources":["../../src/state/StepApplication.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGN,KAAK,QAAQ,EAeb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAcX,IAAI,EACJ,MAAM,kBAAkB,CAAC;AAE1B,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CA+B7D"}

package/dist/state/Transaction.d.ts

@@ -0,0 +1,185 @@
+import { BlockAttrs, BlockNode, Document, InlineNode, Mark, TextSegment } from '../model/Document.js';
+import { EditorSelection } from '../model/Selection.js';
+import { BlockId, NodeTypeName } from '../model/TypeBrands.js';
+export interface InsertTextStep {
+    readonly type: 'insertText';
+    readonly blockId: BlockId;
+    readonly offset: number;
+    readonly text: string;
+    readonly marks: readonly Mark[];
+    readonly segments?: readonly TextSegment[];
+    readonly path?: readonly BlockId[];
+}
+export interface DeleteTextStep {
+    readonly type: 'deleteText';
+    readonly blockId: BlockId;
+    readonly from: number;
+    readonly to: number;
+    readonly deletedText: string;
+    readonly deletedMarks: readonly Mark[];
+    readonly deletedSegments: readonly TextSegment[];
+    readonly path?: readonly BlockId[];
+}
+export interface SplitBlockStep {
+    readonly type: 'splitBlock';
+    readonly blockId: BlockId;
+    readonly offset: number;
+    readonly newBlockId: BlockId;
+    readonly path?: readonly BlockId[];
+}
+export interface MergeBlocksStep {
+    readonly type: 'mergeBlocks';
+    readonly targetBlockId: BlockId;
+    readonly sourceBlockId: BlockId;
+    readonly targetLengthBefore: number;
+    readonly path?: readonly BlockId[];
+}
+export interface AddMarkStep {
+    readonly type: 'addMark';
+    readonly blockId: BlockId;
+    readonly from: number;
+    readonly to: number;
+    readonly mark: Mark;
+    readonly path?: readonly BlockId[];
+}
+export interface RemoveMarkStep {
+    readonly type: 'removeMark';
+    readonly blockId: BlockId;
+    readonly from: number;
+    readonly to: number;
+    readonly mark: Mark;
+    readonly path?: readonly BlockId[];
+}
+export interface SetStoredMarksStep {
+    readonly type: 'setStoredMarks';
+    readonly marks: readonly Mark[] | null;
+    readonly previousMarks: readonly Mark[] | null;
+}
+export interface SetBlockTypeStep {
+    readonly type: 'setBlockType';
+    readonly blockId: BlockId;
+    readonly nodeType: NodeTypeName;
+    readonly attrs?: BlockAttrs;
+    readonly previousNodeType: NodeTypeName;
+    readonly previousAttrs?: BlockAttrs;
+    readonly path?: readonly BlockId[];
+}
+export interface InsertNodeStep {
+    readonly type: 'insertNode';
+    readonly parentPath: readonly BlockId[];
+    readonly index: number;
+    readonly node: BlockNode;
+}
+export interface RemoveNodeStep {
+    readonly type: 'removeNode';
+    readonly parentPath: readonly BlockId[];
+    readonly index: number;
+    readonly removedNode: BlockNode;
+}
+export interface SetNodeAttrStep {
+    readonly type: 'setNodeAttr';
+    readonly path: readonly BlockId[];
+    readonly attrs: BlockAttrs | undefined;
+    readonly previousAttrs?: BlockAttrs;
+}
+export interface InsertInlineNodeStep {
+    readonly type: 'insertInlineNode';
+    readonly blockId: BlockId;
+    readonly offset: number;
+    readonly node: InlineNode;
+    readonly path?: readonly BlockId[];
+}
+export interface RemoveInlineNodeStep {
+    readonly type: 'removeInlineNode';
+    readonly blockId: BlockId;
+    readonly offset: number;
+    readonly removedNode: InlineNode;
+    readonly path?: readonly BlockId[];
+}
+export interface SetInlineNodeAttrStep {
+    readonly type: 'setInlineNodeAttr';
+    readonly blockId: BlockId;
+    readonly offset: number;
+    readonly attrs: Readonly<Record<string, string | number | boolean>>;
+    readonly previousAttrs: Readonly<Record<string, string | number | boolean>>;
+    readonly path?: readonly BlockId[];
+}
+export type Step = InsertTextStep | DeleteTextStep | SplitBlockStep | MergeBlocksStep | AddMarkStep | RemoveMarkStep | SetStoredMarksStep | SetBlockTypeStep | InsertNodeStep | RemoveNodeStep | SetNodeAttrStep | InsertInlineNodeStep | RemoveInlineNodeStep | SetInlineNodeAttrStep;
+export type TransactionOrigin = 'input' | 'paste' | 'command' | 'history' | 'api';
+export interface TransactionMetadata {
+    readonly origin: TransactionOrigin;
+    readonly timestamp: number;
+    readonly historyDirection?: 'undo' | 'redo';
+}
+export interface Transaction {
+    readonly steps: readonly Step[];
+    readonly selectionBefore: EditorSelection;
+    readonly selectionAfter: EditorSelection;
+    readonly storedMarksAfter: readonly Mark[] | null;
+    readonly metadata: TransactionMetadata;
+}
+/** Inverts a single step for undo. */
+export declare function invertStep(step: Step): Step;
+/** Inverts an entire transaction (reverses step order and swaps selections). */
+export declare function invertTransaction(tr: Transaction): Transaction;
+/** Fluent API for building transactions. */
+export declare class TransactionBuilder {
+    private readonly steps;
+    private selection;
+    private storedMarks;
+    private readonly selectionBefore;
+    private readonly origin;
+    private workingDoc;
+    constructor(currentSelection: EditorSelection, currentStoredMarks: readonly Mark[] | null, origin?: TransactionOrigin, doc?: Document);
+    /** Adds an insert-text step. Updates workingDoc if available. */
+    insertText(blockId: BlockId, offset: number, text: string, marks: readonly Mark[], segments?: readonly TextSegment[]): this;
+    /** Adds a delete-text step with explicit data. Updates workingDoc if available. */
+    deleteText(blockId: BlockId, from: number, to: number, deletedText: string, deletedMarks: readonly Mark[], deletedSegments?: readonly TextSegment[]): this;
+    /**
+     * Deletes text at the given range, auto-deriving deletedText, deletedMarks, and deletedSegments
+     * from the working document. Requires a document to be provided at construction.
+     */
+    deleteTextAt(blockId: BlockId, from: number, to: number): this;
+    /** Adds a split-block step. Updates workingDoc if available. */
+    splitBlock(blockId: BlockId, offset: number, newBlockId: BlockId): this;
+    /** Adds a merge-blocks step with explicit targetLengthBefore. Updates workingDoc if available. */
+    mergeBlocks(targetBlockId: BlockId, sourceBlockId: BlockId, targetLengthBefore: number): this;
+    /**
+     * Merges two blocks, auto-deriving targetLengthBefore from the working document.
+     * Requires a document to be provided at construction.
+     */
+    mergeBlocksAt(targetBlockId: BlockId, sourceBlockId: BlockId): this;
+    /** Adds an add-mark step. Updates workingDoc if available. */
+    addMark(blockId: BlockId, from: number, to: number, mark: Mark): this;
+    /** Adds a remove-mark step. Updates workingDoc if available. */
+    removeMark(blockId: BlockId, from: number, to: number, mark: Mark): this;
+    /** Adds a set-block-type step, changing a block's node type and optionally its attrs. */
+    setBlockType(blockId: BlockId, nodeType: NodeTypeName, attrs?: BlockAttrs): this;
+    /** Inserts a node as a child of the parent at the given path and index. */
+    insertNode(parentPath: readonly BlockId[], index: number, node: BlockNode): this;
+    /** Removes a node at the given index from the parent at the given path. */
+    removeNode(parentPath: readonly BlockId[], index: number): this;
+    /** Sets attributes on a node at the given path. */
+    setNodeAttr(path: readonly BlockId[], attrs: BlockAttrs): this;
+    /** Inserts an InlineNode at the given offset within a block. */
+    insertInlineNode(blockId: BlockId, offset: number, node: InlineNode): this;
+    /** Removes an InlineNode at the given offset, deriving removedNode from workingDoc. */
+    removeInlineNode(blockId: BlockId, offset: number): this;
+    /** Sets attributes on an InlineNode at the given offset. */
+    setInlineNodeAttr(blockId: BlockId, offset: number, attrs: Readonly<Record<string, string | number | boolean>>): this;
+    /** Sets the selection for the resulting state. */
+    setSelection(selection: EditorSelection): this;
+    /** Sets a NodeSelection for the resulting state. */
+    setNodeSelection(nodeId: BlockId, path: readonly BlockId[]): this;
+    /** Sets stored marks for the resulting state. */
+    setStoredMarks(marks: readonly Mark[] | null, previousMarks: readonly Mark[] | null): this;
+    /** Builds the final transaction. */
+    build(): Transaction;
+    /** Advances the working document by applying a step. */
+    private advanceDoc;
+}
+/** Helper to create a TransactionBuilder with input origin. */
+export declare function inputTransaction(selection: EditorSelection, storedMarks: readonly Mark[] | null): TransactionBuilder;
+/** Helper to create a TransactionBuilder with command origin. */
+export declare function commandTransaction(selection: EditorSelection, storedMarks: readonly Mark[] | null): TransactionBuilder;
+//# sourceMappingURL=Transaction.d.ts.map