@one2x/medeo-rte 0.0.0-stage → 0.1.0

package/dist/types/commands/shortcuts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 快捷键表。
+ *
+ * 一张纯数据表:按键组合 → 命令。它不认识 DOM 事件,也不认识编辑器 —— 匹配用的
+ * 是 {@link KeyStroke} 这个最小结构,由输入源从事件里摘出来。这样这张表可以被
+ * 直接断言,也可以将来换成宿主配置的。
+ */
+import { CommandTable } from './types';
+/** 一次按键,从平台事件里摘出来的最小信息。 */
+export interface KeyStroke {
+    /** `KeyboardEvent.key`,大小写原样 */
+    key: string;
+    /** Cmd(mac)或 Ctrl */
+    mod: boolean;
+    shift: boolean;
+}
+export interface Shortcut {
+    /** 匹配的键名,单字母键写小写 */
+    key: string;
+    /** 是否要求按下 Cmd/Ctrl。省略等同 false —— 必须**没**按 */
+    mod?: boolean;
+    /** true 要求按 Shift,false 要求没按,省略则不管 */
+    shift?: boolean;
+    /**
+     * 这个键本身会引发一次文本输入(beforeInput)。吞掉按键之后还得把那次输入一并
+     * 压掉,否则内容会被写两遍。只有真正产生输入的键要标。
+     *
+     * 注意：keydown 里会 preventDefault，部分浏览器因此不再派 beforeinput。
+     * IME 层只能按 inputType 吞删除/换段回声，不能无差别丢掉下一次 insertText。
+     */
+    suppressesInput?: boolean;
+    /** 返回 false 表示这次没处理,事件不该被吞 */
+    run(c: CommandTable, stroke: KeyStroke): void | boolean;
+}
+/**
+ * 顺序有意义:从上往下取第一条匹配的。带修饰键的排在前面,免得被无修饰键的
+ * 条目截住。
+ */
+export declare const SHORTCUTS: Shortcut[];
+export declare const INPUT_SHORTCUTS: Shortcut[];
+/**
+ * 输入框快捷键。
+ * - `newline`：Enter / Shift+Enter 都换行；Cmd/Ctrl+Enter 不登记，留给宿主提交。
+ * - `enter` / `shift-enter`：旧口径（引擎仍提供，嵌入式输入框不要用）。
+ */
+export declare function inputShortcuts(submit?: 'newline' | 'enter' | 'shift-enter'): Shortcut[];
+export declare function findShortcut(stroke: KeyStroke, table?: Shortcut[]): Shortcut | null;
+//# sourceMappingURL=shortcuts.d.ts.map

package/dist/types/commands/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../../../src/commands/shortcuts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAY,YAAY,EAAE,MAAM,SAAS,CAAC;AAEjD,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC;CACzD;AAOD;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,EAoB/B,CAAC;AASF,eAAO,MAAM,eAAe,EAAE,QAAQ,EAerC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,SAAS,GAAG,OAAO,GAAG,aAAyB,GACtD,QAAQ,EAAE,CAkBZ;AAWD,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,GAAE,QAAQ,EAAc,GAAG,QAAQ,GAAG,IAAI,CAE9F"}

package/dist/types/commands/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 命令层的契约。
+ *
+ * 命令是「用户意图」的名字,不含任何文档语义 —— 它只负责被触发,具体怎么改文档
+ * 是 Edit 层和 Operation 层的事。所以这一层没有实现,只有一张表:输入源(键盘、
+ * 指针、宿主的工具栏)往里打,编辑器把表填上。
+ */
+import { SlotKind } from '../model/types';
+/** 编辑命令集合。宿主搭建自己的工具栏时调这些。 */
+export interface EditorCommands {
+    toggleBold(): void;
+    toggleItalic(): void;
+    toggleUnderline(): void;
+    toggleStrike(): void;
+    setFontSize(size: number): void;
+    setColor(color: string): void;
+    setHeading(level: 0 | 1 | 2 | 3): void;
+    setAlign(align: 'left' | 'center' | 'right'): void;
+    toggleList(kind: 'ul' | 'ol'): void;
+    indent(delta: number): void;
+    insertImage(file: File): void;
+    insertVideo(file: File): void;
+    insertCode(): void;
+    insertFormula(): void;
+    insertSlot(kind: SlotKind): void;
+    /**
+     * 在光标处插入一个由宿主渲染的内嵌块。`hostType` 标识业务类型,`data` 是随实体
+     * 引用携带的业务数据(编辑器不解释)。可选 `size` 给初始占位尺寸;省略时按渲染器
+     * 首次挂载后回报的尺寸重排。
+     */
+    insertHostEmbed(hostType: string, data?: unknown, size?: {
+        width: number;
+        height: number;
+    }): void;
+    insertTable(): void;
+    addRow(): void;
+    addCol(): void;
+    removeRow(): void;
+    removeCol(): void;
+    toggleLink(): void;
+    promoteRef(): void;
+    insertRef(): void;
+    unlinkRef(): void;
+    undo(): void;
+    redo(): void;
+}
+/** 方向键的四个取值,和 `KeyboardEvent.key` 一致。 */
+export type ArrowKey = 'ArrowLeft' | 'ArrowRight' | 'ArrowUp' | 'ArrowDown';
+/**
+ * 键盘能触发的全部命令。{@link EditorCommands} 是它的公开子集 —— 多出来的这些
+ * 是「只有按键才会触发」的动作,放进公开 API 没有意义。
+ *
+ * 返回 `false` 表示这次没处理,输入源不要吞掉该事件(比如不在同步块里时按
+ * Escape,应该让它继续冒泡)。
+ */
+export interface CommandTable extends EditorCommands {
+    insertParagraph(opts?: {
+        shift?: boolean;
+    }): void;
+    backspace(): void;
+    deleteForward(): void;
+    selectAll(): void;
+    /** Tab:列表里改嵌套层级,表格里跳格 */
+    indentOrNextCell(dir: 1 | -1): void;
+    moveCaret(key: ArrowKey, extend: boolean): void;
+    /** 退出同步块内部编辑。不在同步块里时返回 false */
+    exitFragment(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,UAAU,IAAI,IAAI,CAAC;IACnB,YAAY,IAAI,IAAI,CAAC;IACrB,eAAe,IAAI,IAAI,CAAC;IACxB,YAAY,IAAI,IAAI,CAAC;IACrB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;IACnD,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,UAAU,IAAI,IAAI,CAAC;IACnB,aAAa,IAAI,IAAI,CAAC;IACtB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvC,IAAI,CAAC;IACR,WAAW,IAAI,IAAI,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,IAAI,IAAI,CAAC;IACf,SAAS,IAAI,IAAI,CAAC;IAClB,SAAS,IAAI,IAAI,CAAC;IAClB,UAAU,IAAI,IAAI,CAAC;IACnB,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,IAAI,IAAI,CAAC;IAClB,SAAS,IAAI,IAAI,CAAC;IAClB,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;CACd;AAED,yCAAyC;AACzC,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,SAAS,IAAI,IAAI,CAAC;IAClB,aAAa,IAAI,IAAI,CAAC;IACtB,SAAS,IAAI,IAAI,CAAC;IAClB,yBAAyB;IACzB,gBAAgB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,gCAAgC;IAChC,YAAY,IAAI,OAAO,CAAC;CACzB"}

package/dist/types/convert/clipboard.d.ts

@@ -0,0 +1,7 @@
+import { Slice } from '../model/types';
+/** 自定义剪贴板 MIME：跨编辑器粘贴时保全样式与嵌入实体。 */
+export declare const SLICE_MIME = "text/x-mini-editor-slice";
+export declare function serializeSlice(slice: Slice): string;
+export declare function parseSlice(raw: string): Slice | null;
+export declare function sliceFromClipboard(data: DataTransfer | null): Slice | null;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/types/convert/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/convert/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,EAAa,MAAM,gBAAgB,CAAC;AAE/D,oCAAoC;AACpC,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAErD,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAcpD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAG1E"}

package/dist/types/convert/markdown.d.ts

@@ -0,0 +1,30 @@
+import { HeadingLevel, ListKind, TextProps } from '../model/types';
+/** 常用 Markdown 输入的即时识别规则。 */
+export type MarkdownHit = {
+    kind: 'heading';
+    level: HeadingLevel;
+    consume: number;
+} | {
+    kind: 'list';
+    list: ListKind;
+    consume: number;
+} | {
+    kind: 'code-block';
+    consume: number;
+    language: string;
+} | {
+    kind: 'formula';
+    matchStart: number;
+    matchEnd: number;
+    latex: string;
+    displayMode: boolean;
+} | {
+    kind: 'text';
+    style: TextProps;
+    matchStart: number;
+    matchEnd: number;
+    inner: string;
+};
+export declare function matchMarkdown(paraText: string): MarkdownHit | null;
+export declare function shouldTryMarkdown(inserted: string): boolean;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/types/convert/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/convert/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEnE,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAC9F;IACE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAsBN,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2ClE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/types/convert/mdPaste.d.ts

@@ -0,0 +1,8 @@
+import { Slice } from '../model/types';
+/**
+ * 粘贴前的 Markdown 探测：先看标题/列表/链接，再看行内粗斜删除线。
+ */
+export declare function looksLikeMarkdown(text: string): boolean;
+/** 支持的 Markdown 子集：标题/列表/粗斜下划删除线/链接/代码块/公式。 */
+export declare function markdownToSlice(raw: string): Slice;
+//# sourceMappingURL=mdPaste.d.ts.map

package/dist/types/convert/mdPaste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdPaste.d.ts","sourceRoot":"","sources":["../../../src/convert/mdPaste.ts"],"names":[],"mappings":"AACA,OAAO,EAA4E,KAAK,EAAwB,MAAM,gBAAgB,CAAC;AAEvI;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAcvD;AA4CD,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CA4FlD"}

package/dist/types/editor.d.ts

@@ -0,0 +1,469 @@
+import { HostEmbedRenderer } from './embed';
+import { EmbedPlugin } from './embed/types';
+import type { Shortcut } from './commands';
+import { CommandTable } from './commands';
+import { DocLayout } from './layout/types';
+import { DocumentModel } from './model/document';
+import type { ImagePatch, VirtualBlockSpec } from './operations';
+import { EmbedEntity, Selection, Slice, TextProps, VirtualBlockChrome } from './model/types';
+export interface EditorOptions {
+    /** 初始文档。不传则新建一个空文档。 */
+    doc?: DocumentModel;
+    /** 初始绘制后端，默认 `html`。 */
+    paint?: 'html' | 'canvas';
+    /**
+     * 嵌入对象插件集，默认 {@link builtinEmbedPlugins}（图片/视频/代码块/插槽/同步块）。
+     * 公式需从 `medeo-rte/formula` 单独引入后追加。
+     */
+    plugins?: EmbedPlugin[];
+    /**
+     * 内容宽度策略,默认 `'fill'`。
+     * - `'fill'`:撑满宿主容器,并随容器尺寸变化自动重排(编辑器适应容器)。
+     * - `number`:固定像素内容宽,行为与容器尺寸无关(适合需要确定版心的场景)。
+     */
+    width?: 'fill' | number;
+    /**
+     * 内容版心内边距（像素），默认 `{ x: 72, y: 56 }`（纸张/文档形态的版心留白）。
+     * 决定内容行相对绘制表面的起始偏移与四周留白。嵌入式输入框等紧凑形态可传
+     * `{ x: 0, y: 0 }`，把留白完全交给宿主 CSS 控制。
+     */
+    padding?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * 宿主渲染器。提供后即启用 host 型嵌入对象：节点内部 DOM 由宿主用自己的框架
+     * 组件渲染，SDK 只管占位、定位与生命周期。用于把业务卡片（如引用对象、插槽）
+     * 挂进编辑器而不由 SDK 自绘。见 {@link HostEmbedRenderer}。
+     */
+    hostEmbed?: HostEmbedRenderer;
+    /**
+     * 空文档占位文案。由 SDK 画在首行位置，组合输入一开始就关掉（中间态已镜像进模型，
+     * 宿主若只看 `change` 会误判仍为空）。之后可用 {@link Editor.setPlaceholder} 改。
+     */
+    placeholder?: string;
+    /**
+     * 未写 text span 时的默认文字属性。嵌入式输入框可传 14px 对齐业务输入。
+     * `fontFamily` 须具名栈（不要 `system-ui`），会同时用于 pretext 测宽与绘制。
+     * 不传则仍是文档编辑器默认 16px / `#1f2329` / 中文无衬线栈。
+     */
+    textDefaults?: TextProps;
+    /**
+     * 快捷键表。默认 {@link SHORTCUTS}（文档编辑：Enter 插段、Cmd+B 加粗等）。
+     * 嵌入式输入框请传 {@link inputShortcuts}（默认 newline：Enter 换行）。
+     */
+    shortcuts?: Shortcut[];
+    /**
+     * 创建完成后是否把焦点放到 IME。默认 `true`（独立编辑器 / demo）。
+     * 嵌入式输入框（如页面上的 Command Box）应传 `false`，避免抢走页面焦点。
+     */
+    autofocus?: boolean;
+    /**
+     * 光标 / 选区 / 空态占位的外观。不传则与常规编辑器一致：实心光标、扁平选区、无残影。
+     * 彩虹光标 / 残影需显式 `caret: 'rainbow'`。
+     */
+    chrome?: EditorChrome;
+}
+/** 编辑器装饰外观（光标、选区、空态占位）。与正文字号/字体测量分开，避免宿主 CSS 盖绘制层。 */
+export interface EditorChrome {
+    /** 默认 `solid`。演示能力用 `rainbow`。 */
+    caret?: 'rainbow' | 'solid';
+    /** `solid` 时光标颜色，默认 `#09090b`。 */
+    caretColor?: string;
+    /** `solid` 时光标宽度，默认 2。 */
+    caretWidth?: number;
+    /** 是否画光标残影。默认关闭；`rainbow` 时可打开。 */
+    caretTrail?: boolean;
+    /**
+     * 选区高亮色。默认接近浏览器原生选区：`rgba(43, 108, 255, 0.22)`。
+     * 扁平填充，不再用彩虹渐变。`caret: 'rainbow'` 且未指定本项时，demo 仍用渐变选区。
+     */
+    selectionColor?: string;
+    /** 选区圆角，像素。默认 0（和 `::selection` 一样是矩形）。 */
+    selectionRadius?: number;
+    /** 中文输入中间态下划线颜色。默认 `#1f2329`。 */
+    composeUnderlineColor?: string;
+    /** 中文输入中间态下划线粗细，默认 2。 */
+    composeUnderlineWidth?: number;
+    /** 空态占位颜色。 */
+    placeholderColor?: string;
+    /** 空态占位透明度 0–1。现网 Chat 为 0.2。 */
+    placeholderOpacity?: number;
+    /**
+     * 绘制表面底色。默认纸张白（`var(--page)`）。
+     * 嵌入式输入框应传 `transparent`，露出宿主输入框底，不要再铺一层白/灰。
+     */
+    surfaceBackground?: 'paper' | 'transparent';
+}
+/** 插入嵌入对象的落点：文档下标，或起/止/当前光标。 */
+export type EmbedInsertAt = number | 'start' | 'end' | 'cursor';
+/** 编辑器当前状态，供宿主同步工具栏、状态栏等 UI。 */
+export interface EditorState {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    fontSize: number;
+    color: string;
+    heading: 0 | 1 | 2 | 3;
+    align: 'left' | 'center' | 'right';
+    list: 'none' | 'ul' | 'ol';
+    inTable: boolean;
+    canUndo: boolean;
+    canRedo: boolean;
+    paintMode: 'html' | 'canvas';
+    hasLink: boolean;
+    canPromote: boolean;
+    canInsertRef: boolean;
+    canUnlink: boolean;
+    /** 主文档选区 */
+    selection: Selection;
+    /** 主文档长度（spacer 数） */
+    docLength: number;
+    /** 是否正在同步块内部编辑 */
+    inRefEdit: boolean;
+    /** 同步块内部选区，仅 inRefEdit 为真时有意义 */
+    refSelection: Selection;
+    /** 虚拟块作用域栈，栈顶是当前选中/编辑的那一层 */
+    vblockStack: {
+        id: string;
+        mode: 'selected' | 'editing';
+    }[];
+}
+/**
+ * - `change`：文档内容变化
+ * - `selectionchange`：选区或光标移动
+ * - `statechange`：{@link EditorState} 任一字段可能已变，用于同步工具栏
+ * - `layoutchange`：重新排版完成，可从 {@link Editor.getLayout} 取新几何
+ */
+export type EditorEvent = 'change' | 'selectionchange' | 'statechange' | 'layoutchange';
+export declare class Editor {
+    /** 编辑器根节点，已挂载到构造时传入的容器下。 */
+    readonly root: HTMLElement;
+    /** 编辑命令集合，宿主自建工具栏时用。 */
+    readonly commands: CommandTable;
+    /** 构造时传入的宿主容器。'fill' 模式下从它测量可用宽度。 */
+    private parent;
+    /** 内容宽度策略,见 {@link EditorOptions.width}。 */
+    private widthMode;
+    /** 内容版心内边距,见 {@link EditorOptions.padding}。所有主文档排版据此定位。 */
+    private padding;
+    /** 当前内容宽度(单一真相来源),所有主文档排版都读它。 */
+    private contentWidth;
+    /** 'fill' 模式下监听宿主尺寸变化以重排;其它模式为 null。 */
+    private resizeObserver;
+    private page;
+    private pageInner;
+    private handle;
+    private embedFrame;
+    private imeBar;
+    private placeholderEl;
+    private placeholderText;
+    private shortcutTable;
+    private textDefaults;
+    /** 挂载后由 getComputedStyle 解析出的字体栈，专供测宽（canvas 读不懂 var()）。 */
+    private resolvedMeasureFamily;
+    private chrome;
+    private disabled;
+    private paintMode;
+    private listeners;
+    private doc;
+    private sel;
+    private undoStack;
+    private layout;
+    private painter;
+    private ime;
+    private typingStyle;
+    private keepTypingOnNextClick;
+    private caretRaf;
+    private caretTrails;
+    private lastCaretKey;
+    private composeText;
+    /** 组合串镜像插入模型的起点；null 表示当前没有进行中的组合。 */
+    private composeAnchor;
+    /** 当前已镜像插入模型的组合串长度，用于下次幂等替换时删旧。 */
+    private composeLen;
+    private refEdit;
+    private fragSel;
+    private refDragging;
+    private refDragAnchor;
+    private unbindKeyboard;
+    private keysArmed;
+    private dragging;
+    private resizing;
+    private colResizing;
+    private embedEdit;
+    private dragAnchor;
+    private vblockStack;
+    constructor(parent: HTMLElement, options?: EditorOptions);
+    setPaintMode(mode: 'html' | 'canvas'): void;
+    /** 滚动容器。宿主要做小地图、滚动联动时用。 */
+    get scroller(): HTMLElement;
+    /**
+     * 页面元素（内容画布所在的定位上下文）。
+     * 宿主要往内容上叠东西（标尺、网格、水印、角标）时挂到这里。
+     */
+    get pageElement(): HTMLElement;
+    /** 当前绘制后端。 */
+    get paint(): 'html' | 'canvas';
+    /** 更新空态占位文案。传空字符串则不再显示。 */
+    setPlaceholder(text: string): void;
+    /** 更新光标 / 选区等装饰外观，立即重绘 chrome。 */
+    setChrome(patch: Partial<EditorChrome>): void;
+    /**
+     * 更新默认正文字号/颜色/字体。已写进 span 的同色文字会跟着改（给主题切换用），不进撤销。
+     */
+    setTextDefaults(patch: TextProps): void;
+    /** 把文档里等于 from 的文字色改成 to，不发 change、不进历史。 */
+    private recolorMatchingText;
+    private applyTextDefaults;
+    private syncComputedFontForMeasure;
+    private createPainter;
+    private caretIsSolid;
+    private caretTrailEnabled;
+    private applyChrome;
+    /** 当前排版结果（纯几何，只读）。宿主可据此画标尺、小地图、叠层。 */
+    getLayout(): DocLayout;
+    /** 导出整篇内容，结果可 JSON 序列化。 */
+    getContent(): Slice;
+    /** 整篇替换内容，会清空撤销栈。 */
+    setContent(slice: Slice): void;
+    /** 直接拿文档模型。需要做批量操作或自定义命令时用。 */
+    getDocument(): DocumentModel;
+    /**
+     * 在当前选区（或 `at`）插入一份 Slice。模板混排（文案 + 槽 + 胶囊 + 虚拟块）走这条。
+     */
+    insertSlice(slice: Slice, at?: number): void;
+    /** 把指定范围（默认当前选区）包成一层虚拟块。 */
+    insertVirtualBlock(spec: Omit<VirtualBlockSpec, 'start' | 'end'> & {
+        start?: number;
+        end?: number;
+    }): string | null;
+    updateVirtualBlock(id: string, chrome: VirtualBlockChrome): void;
+    removeVirtualBlock(id: string): void;
+    /**
+     * 在指定位置插入宿主渲染块。`at` 省略为当前光标（会先删掉非折叠选区）。
+     * 插入后选中该占位符，便于缩放框/选中态；宿主若要把光标放到块后，自行折叠到 `focus`。
+     */
+    insertHostEmbed(hostType: string, data?: unknown, size?: {
+        width: number;
+        height: number;
+    }, at?: EmbedInsertAt): void;
+    /** 文档里所有嵌入对象（图片占位），按文档下标升序。 */
+    listEmbeds(): {
+        index: number;
+        entity: EmbedEntity;
+    }[];
+    /** 每个段落的分组 id，与块序一致；空串表示无分组。 */
+    listParagraphGroupIds(): string[];
+    /** 给前 `count` 个段落打上分组（省略则全部）。不进撤销栈。 */
+    tagParagraphsWithGroup(groupId: string, count?: number): void;
+    /** 去掉段落分组。传入 id 则只清该组，否则清全部。 */
+    clearParagraphGroupIds(groupId?: string): void;
+    /** 删除指定分组的段落，其余内容保留。会清空撤销栈。 */
+    deleteParagraphsWithGroup(groupId: string): void;
+    /** 当前是否正好选中一颗嵌入对象（含 host）。 */
+    selectedEmbed(): EmbedEntity | null;
+    /** 按谓词删除嵌入对象，从后往前以免下标错位。返回删除数量。 */
+    deleteEmbeds(pred: (entity: EmbedEntity, index: number) => boolean): number;
+    /** 按谓词更新嵌入对象属性。`patchFor` 可按实体合并 data。返回更新数量。
+     *  `history: false` 不进撤销栈（生成中态这类 UI 过程）。 */
+    updateEmbeds(pred: (entity: EmbedEntity, index: number) => boolean, patchFor: ImagePatch | ((entity: EmbedEntity, index: number) => ImagePatch), options?: {
+        history?: boolean;
+    }): number;
+    getSelection(): Selection;
+    /** 屏幕坐标落到文档下标，供拖放落点。 */
+    indexAtClientPoint(clientX: number, clientY: number): number;
+    setSelection(next: Selection): void;
+    /** 当前状态快照，用于同步宿主 UI。 */
+    getState(): EditorState;
+    /** 订阅事件，返回取消订阅函数。 */
+    on(event: EditorEvent, handler: () => void): () => void;
+    focus(): void;
+    /** 输入法组合是否进行中（含候选串已镜像进模型、尚未落定）。 */
+    composing(): boolean;
+    /** 禁用输入与快捷键。宿主 disabled 不能只靠 CSS pointer-events。 */
+    setDisabled(disabled: boolean): void;
+    private emit;
+    private bindSurface;
+    private unbindSurface;
+    private bind;
+    destroy(): void;
+    private onWindowResize;
+    /**
+     * 按当前 width 策略算出内容宽度。
+     * - 固定像素:直接返回。
+     * - 'fill':宿主容器可用宽减去左右版心内边距;容器尚未布局(宽度为 0)时回退默认值,
+     *   避免首帧算出负数或零宽。
+     */
+    private resolveContentWidth;
+    private commit;
+    private targetDoc;
+    private targetSel;
+    private setTargetSel;
+    private syncActiveFragment;
+    private activeRefBox;
+    private refreshRefMetrics;
+    /**
+     * 一次用户操作的事务边界。事务本体在 Edit 层，这里只负责给它当前的选区和
+     * 作用域，再把产出的记录送进撤销栈。
+     *
+     * 同步块内部编辑走的是同一条路，只是作用域换成片段 id —— 发出去的 mutation
+     * 自动包上 `scoped`，进的还是同一个撤销栈。
+     */
+    private runEdit;
+    /** 立即落一次变更，不进撤销栈。拖拽预览这类「过程中」的改动用它。 */
+    private applyNow;
+    /**
+     * 把已经预览生效的改动登记成一步可撤销的编辑。
+     *
+     * 拖拽缩放这类交互会先用 `applyNow` 实时改文档，松手时才落定。这里的做法是
+     * 悄悄退回到起点、再用一次真正的编辑走到终点 —— 两步在同一帧内完成，用户看不
+     * 出来，换来的是一条正常的、能重放能变换的操作记录，而不是一对手写的闭包。
+     */
+    private commitPreview;
+    private deleteSelectionIfNeeded;
+    private clearCellGrid;
+    /**
+     * 处理输入法组合态（拼音/候选的中间态）。
+     *
+     * 组合串镜像插入文档模型、参与真实排版 —— 每次变化都幂等地「删旧串 → 插新串」，
+     * 光标后的内容因此靠正常重排让开，而不是被浮层盖住。整个组合过程用 applyNow
+     * 落地、不进撤销栈；最终文字在 compositionend 后由 onInsertText 走一次正常插入
+     * 落定成一步可撤销的编辑。组合区外观由白块 overlay 擦白，只留系统输入法的候选串。
+     */
+    private handleComposition;
+    insertText(text: string): void;
+    pasteText(text: string): void;
+    pasteClipboard(data: DataTransfer | null): void;
+    insertParagraph(opts?: {
+        shift?: boolean;
+    }): void;
+    private inheritedTypingStyle;
+    private beginFormulaEdit;
+    private beginSlotActivate;
+    backspace(): void;
+    deleteForward(): void;
+    private applyText;
+    private toggleText;
+    private applyPara;
+    private toggleLink;
+    private toggleList;
+    private changeIndent;
+    private insertEmbed;
+    private resolveInsertIndex;
+    private innerContentWidth;
+    private insertCodeBlock;
+    private insertFormula;
+    private insertSlot;
+    private promoteRef;
+    private insertExistingRef;
+    private insertRefAtCaret;
+    private unlinkSelectedRef;
+    private selectedEmbedIndex;
+    private deleteSelectedEmbed;
+    private exitRefEditAtStart;
+    private refInnerLayout;
+    private hitRefIndex;
+    private beginRefEdit;
+    private exitRefEdit;
+    private onRefJump;
+    private onDoubleClick;
+    private applyEmbedPatch;
+    private onEmbedMeasure;
+    private onEmbedChange;
+    private onEmbedCommit;
+    private onEmbedExitEdit;
+    private insertMediaFile;
+    private insertTable;
+    private tableOp;
+    undo(): void;
+    redo(): void;
+    /**
+     * 执行撤销栈交回来的一步。
+     *
+     * 栈给的是一条常规 EditResult：`mutations` 直接应用，选区取 `selectionAfter`。
+     * 选区属于哪个坐标空间由 `meta.scope` 说了算 —— 片段里的编辑，撤销时该动的是
+     * 片段选区。
+     */
+    private applyHistoryStep;
+    private relayout;
+    private paintChrome;
+    /**
+     * 占位只在「看不见任何正文」时出现。组合一开始（哪怕候选串还是空的）就必须关掉：
+     * 中间态走 applyNow，不发 change，宿主叠层会一直以为是空的。
+     */
+    private syncPlaceholder;
+    private decorateHostNodes;
+    private decorateRefNodes;
+    private paintCaretLayer;
+    /** 组合串起点（锚点）的屏幕坐标；主文档与片段内编辑都算对。 */
+    private composeCaret;
+    private refCaretPos;
+    private currentTextStyle;
+    private currentParaTextDefaults;
+    private syncToolbar;
+    private syncStatus;
+    private resetBlink;
+    private scrollCaret;
+    private localPoint;
+    private onDocMouseDown;
+    private onRootMouseDown;
+    private onFocusChange;
+    private onMouseDown;
+    private onMouseMove;
+    private onMouseUp;
+    private onResizeStart;
+    private hitImage;
+    private selectedImage;
+    private updateEmbedChrome;
+    private writeClipboard;
+    private onCopy;
+    private onCut;
+    private isFocused;
+    /** 焦点在公式/槽等嵌入控件内时不画外层光标。 */
+    private isEmbedChromeFocused;
+    /**
+     * 这次按键归不归本编辑器管。
+     *
+     * 「哪个键干什么」在 commands/shortcuts.ts 里，门面只回答这一个问题 —— 焦点在
+     * 别的输入框、编辑器没装备快捷键、焦点在嵌入对象的字段里，都不接。
+     */
+    private acceptsKey;
+    private selectAll;
+    /** Escape：先弹出虚拟块一层，再退出同步块内部编辑。 */
+    private exitFragmentEdit;
+    /** Tab：在列表里改嵌套层级，否则在表格里跳到下一格。 */
+    private indentOrNextCell;
+    private moveTableCell;
+    private expandSel;
+    private applyColResize;
+    private moveCaret;
+    private moveFragmentCaret;
+    private stackTop;
+    private selectedVblock;
+    private selectedRegion;
+    private editingSlot;
+    private editingSlotIn;
+    private selectionCoversSlot;
+    /** 选中槽、整槽选区、或空槽编辑：下一次写入应 fillSlot，不要先 clear 再插。 */
+    private slotToFill;
+    private selectVblock;
+    private popVblock;
+    private enterSelectedVblock;
+    private handleVblockBackspace;
+    private moveAcrossVblock;
+    private outermostStartingAt;
+    private outermostEndingAt;
+    private hitVblockClick;
+    private snapIndexForDrag;
+    private selectionPaintRects;
+    private snapSelIfNeeded;
+    /** 对照常见 Docs 行为：先选中嵌入块，再按同一方向才跳过。 */
+    private moveAcrossEmbed;
+    private setSel;
+    private afterCaretMove;
+    private stepIndex;
+    private verticalMove;
+}
+//# sourceMappingURL=editor.d.ts.map