@siliconoid/xssml-editor 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,863 @@
+import { Plugin, EditorState as EditorState$1, Transaction } from 'prosemirror-state';
+import { NodeSpec, MarkSpec } from 'prosemirror-model';
+import { EditorView as EditorView$1 } from 'prosemirror-view';
+
+declare const HighlightCommands: {
+    highlight: string;
+    clearHighlight: string;
+};
+
+declare const HistoryCommands: {
+    undo: string;
+    redo: string;
+    clear: string;
+};
+
+declare const TextInputCommands: {
+    inputText: string;
+    replaceRange: string;
+};
+
+declare const PptCommands: {
+    insertPptControl: string;
+};
+
+declare const SoundEventCommands: {
+    /** Insert a sound event node */
+    insertSoundEvent: string;
+};
+
+declare const CmdCommands: {
+    insertCommand: string;
+};
+
+declare const DataCommands: {
+    insertData: string;
+};
+
+declare const WaitCommands: {
+    insertWait: string;
+};
+
+declare const BreakCommands: {
+    insertBreak: string;
+};
+
+declare const BreathCommands: {
+    insertBreath: string;
+};
+
+declare const PhonemeCommands: {
+    switchPhonemeMode: string;
+    insertPhoneme: string;
+};
+
+declare enum MarkTagType {
+    Word = "word",
+    Breath = "breath",
+    Break = "break",
+    Phoneme = "phoneme",
+    /** @description XSSML say-as element for text interpretation */
+    SayAs = "say-as",
+    /** @deprecated Use SayAs instead */
+    Number = "say-as",
+    /** @description XSSML sub element for text substitution */
+    Sub = "sub",
+    /** @deprecated Use Sub instead */
+    Alias = "sub",
+    Speaker = "speaker",
+    SpeechRate = "speed",
+    SpeechPitch = "pitch",
+    SpeechVolume = "volume",
+    SpeechLanguage = "lang",
+    Action = "action",
+    Avatar = "avatar",
+    Emotion = "emotion",
+    Command = "command",
+    Data = "data",
+    Wait = "wait",
+    PptControl = "ppt_control",
+    /** @description XSSML soundEvent element for audio effects */
+    SoundEvent = "soundEvent",
+    RangeAnchor = "range_anchor"
+}
+/**
+ * XSSML say-as interpret-as attribute values
+ * Currently supports core number interpretations.
+ * Can be extended to support XSSML 1.1 full spec: ordinal, characters, telephone, date, time, fraction, currency
+ * @see https://www.w3.org/TR/speech-synthesis11/#edef_say-as
+ */
+declare enum SayAsInterpretType {
+    /** Auto-detect interpretation */
+    auto = "auto",
+    /** Speak as cardinal number (e.g., "one hundred twenty-three") */
+    cardinal = "cardinal",
+    /** Speak each digit individually (e.g., "one two three") */
+    digits = "digits"
+}
+declare enum ActionCommands {
+    insertAction = "insertAction",
+    clearAction = "clearAction"
+}
+declare enum SpeechRateCommands {
+    setSpeechRate = "setSpeechRate"
+}
+declare enum SpeechPitchCommands {
+    setSpeechPitch = "setSpeechPitch"
+}
+declare enum SpeechVolumeCommands {
+    setSpeechVolume = "setSpeechVolume"
+}
+declare enum SpeechLanguageCommands {
+    setSpeechLanguage = "setSpeechLanguage"
+}
+
+/**
+ * XSSML say-as command - handles text interpretation hints
+ * @see https://www.w3.org/TR/speech-synthesis11/#edef_say-as
+ */
+
+declare const SayAsCommands: {
+    /** Set say-as interpretation for selected text */
+    setSayAs: string;
+};
+
+declare const WordCommands: {
+    insertWord: string;
+};
+
+interface EditorNodeSpec extends NodeSpec {
+  validate?: (state: EditorState) => {
+    available: boolean;
+    reason?: string;
+  };
+  handleClickOn?: (
+    view: EditorView,
+    pos: number,
+    node: Node,
+    nodePos: number,
+    event: MouseEvent,
+    direct: boolean,
+  ) => boolean | undefined;
+}
+
+interface EditorMarkSpec extends MarkSpec {
+  validate?: (state: EditorState) => {
+    available: boolean;
+    reason?: string;
+  };
+}
+
+interface TextMediaAttrs {
+    src: string;
+    name?: string;
+    mediaType: string;
+    extra?: string | object;
+}
+
+type EventCallback<T> = (data: T) => void;
+/**
+ * 定义事件类型映射接口
+ * 用于指定事件名称和对应的数据类型
+ * 例如: { 'change': string, 'click': MouseEvent }
+ */
+type EmitEvents = Record<string, any>;
+interface IEventEmitter<T extends EmitEvents = EmitEvents> {
+    on<K extends keyof T>(event: K, callback: EventCallback<T[K]>): void;
+    off<K extends keyof T>(event: K, callback: EventCallback<T[K]>): void;
+    emit<K extends keyof T>(event: K, data: T[K]): void;
+    removeAllListeners(event?: keyof T): void;
+}
+declare class EventEmitter<T extends EmitEvents = EmitEvents> implements IEventEmitter {
+    private events;
+    /**
+     * 监听事件
+     * @param event 事件名
+     * @param callback 回调函数，参数类型会自动推断
+     */
+    on<K extends keyof T>(event: K, callback: EventCallback<T[K]>): void;
+    /**
+     * 移除事件监听器
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    off<K extends keyof T>(event: K, callback: EventCallback<T[K]>): void;
+    /**
+     * 触发事件
+     * @param event 事件名
+     * @param data 事件数据，类型会自动匹配
+     */
+    emit<K extends keyof T>(event: K, data: T[K]): void;
+    /**
+     * 移除所有监听器
+     * @param event 可选的事件名
+     */
+    removeAllListeners(event?: keyof T): void;
+}
+
+interface EditorStateChangeEvent {
+    commands: Record<string, {
+        available: boolean;
+        reason?: string;
+    }>;
+}
+interface WordCountEvent {
+    count: number;
+    maxCount?: number;
+    exceeded?: boolean;
+}
+interface FocusEvent {
+    focused: boolean;
+}
+interface ErrorEvent {
+    error: Error;
+    context?: unknown;
+}
+interface ClickedTextMediaAttrs extends TextMediaAttrs {
+    tagId: string;
+}
+/**
+ * 编辑器事件枚举
+ */
+declare enum EditorEvent {
+    /** 状态变更 (命令状态、选区等) */
+    StateChange = "stateChange",
+    /** 字数统计变更 */
+    WordCount = "wordCount",
+    /** 编辑器获得焦点 */
+    Focus = "focus",
+    /** 编辑器失去焦点 */
+    Blur = "blur",
+    /** 发生错误 */
+    Error = "error",
+    /** 选区更新 (用于浮动菜单) */
+    SelectionUpdate = "selectionUpdate",
+    /** 右键菜单 (用于自定义菜单) */
+    ContextMenu = "contextMenu",
+    /** 文本多媒体节点点击 (插件事件) */
+    PluginTextMediaClick = "plugin.textmedia_click"
+}
+/**
+ * 选区更新事件
+ */
+interface SelectionChangeEvent {
+    /** 是否有活跃选区 (非空选区) */
+    isActive: boolean;
+    /** 选区的屏幕位置矩形 */
+    rect: DOMRect | null;
+    /** 开始位置 */
+    from: number;
+    /** 结束位置 */
+    to: number;
+    /** 选区文本内容 (新增) */
+    text: string;
+    /** 选区 JSON 内容 (新增) */
+    content: any;
+    /** 关联的 DOM 节点 (如果有) */
+    target?: HTMLElement;
+}
+/**
+ * 右键菜单事件
+ */
+interface ContextMenuEvent {
+    /** 原生事件 */
+    event: MouseEvent;
+    /** 点击位置 */
+    pos: number;
+    /** 点击位置的坐标 */
+    coords: {
+        left: number;
+        top: number;
+    };
+    /** 当前点击命中的节点及其属性 */
+    node?: {
+        type: string;
+        attrs: Record<string, any>;
+    };
+    /** 触发时刻的选区快照 (新增) */
+    selection: {
+        from: number;
+        to: number;
+        text: string;
+        content: any;
+        /** 点击位置是否在当前选区内 */
+        isClickInside: boolean;
+    };
+}
+type EditorEventMap = {
+    [EditorEvent.StateChange]: EditorStateChangeEvent;
+    [EditorEvent.WordCount]: WordCountEvent;
+    [EditorEvent.Focus]: FocusEvent;
+    [EditorEvent.Blur]: FocusEvent;
+    [EditorEvent.Error]: ErrorEvent;
+    [EditorEvent.SelectionUpdate]: SelectionChangeEvent;
+    [EditorEvent.ContextMenu]: ContextMenuEvent;
+    [EditorEvent.PluginTextMediaClick]: ClickedTextMediaAttrs;
+    [event: string]: unknown;
+};
+
+interface EditorConfig$1 {
+  parent: HTMLDivElement;
+  content?: string;
+  registry?: Registry;
+  maxWordCount?: number;
+  editable?: boolean;
+  /** 浮动菜单配置 (半封装模式) */
+  floatingMenu?: {
+    onRender: (mountPoint: HTMLElement, state: any) => void;
+    shouldShow?: (
+      view: any,
+      state: { isMouseDown: boolean; isContextMenuOpen: boolean },
+    ) => boolean;
+  };
+  /** 右键菜单配置 (半封装模式) */
+  contextMenu?: {
+    onRender: (mountPoint: HTMLElement, state: any) => void;
+  };
+}
+
+declare class EditorStateStore {
+    editable: boolean;
+    constructor();
+    setEditable(editable: boolean): void;
+    getEditable(): boolean;
+}
+
+declare class Registry$1 {
+    private nodes;
+    private marks;
+    private plugins;
+    registerNode(name: string, spec: EditorNodeSpec): void;
+    registerMark(name: string, spec: EditorMarkSpec): void;
+    registerPlugin(name: string, plugin: Plugin | ((...args: any[]) => Plugin)): void;
+    getNodes(): Record<string, EditorNodeSpec>;
+    getMarks(): Record<string, EditorMarkSpec>;
+    getPlugins(editorStateStore?: EditorStateStore): Plugin[];
+    clone(): Registry$1;
+}
+declare const registry: Registry$1;
+
+/**
+ * 编辑器内容 JSON 结构 (ProseMirror Node 格式)
+ */
+interface EditorContent {
+    type: string;
+    attrs?: Record<string, unknown>;
+    content?: (EditorContent | {
+        type: 'text';
+        text: string;
+    })[];
+    marks?: {
+        type: string;
+        attrs?: Record<string, unknown>;
+    }[];
+}
+/**
+ * 编辑器初始化配置项
+ */
+interface EditorConfig {
+    /** 挂载的 DOM 容器 */
+    parent: HTMLElement;
+    /** 初始内容 (JSON 字符串) */
+    content?: string;
+    /** 自定义扩展注册表 */
+    registry?: Registry$1;
+    /** 最大字数限制 (默认: 10000) */
+    maxWordCount?: number;
+    /** 是否初始只读 */
+    editable?: boolean;
+    /** 浮动菜单配置 (半封装模式) */
+    floatingMenu?: {
+        onRender: (mountPoint: HTMLElement, state: any) => void;
+        shouldShow?: (view: any, state: {
+            isMouseDown: boolean;
+            isContextMenuOpen: boolean;
+        }) => boolean;
+    };
+    /** 右键菜单配置 (半封装模式) */
+    contextMenu?: {
+        onRender: (mountPoint: HTMLElement, state: any) => void;
+    };
+}
+/**
+ * 内容读取模式
+ */
+declare enum ContentReadMode {
+    /** 全文 */
+    all = "all",
+    /** 选区 */
+    selection = "selection",
+    /** 从当前光标位置往右（往后） */
+    cursorRight = "cursor_right"
+}
+/**
+ * 命令错误码
+ */
+declare enum CommandErrorCode {
+    /** 成功 */
+    Success = 0,
+    /** 参数缺失 */
+    ParamsMissing = 100000,
+    /** 参数无效 (格式、类型错误) */
+    ParamsInvalid = 100001,
+    /** 选区无效 (需要选区但未选择，或选区跨节点) */
+    SelectionInvalid = 100002,
+    /** 光标无效 (需要光标但未定位，或处于选区状态) */
+    CursorInvalid = 100003,
+    /** 编辑器状态错误 (如只读模式) */
+    StateError = 100004,
+    /** 命令未找到 */
+    CommandNotFound = 100005,
+    /** 内部执行时发生未捕获异常 */
+    ExecutionError = 999999
+}
+/**
+ * 播放片段
+ */
+interface PlaybackSegment {
+    /** 类型 */
+    type: 'text' | 'soundEvent';
+    /** 文本内容 */
+    text: string;
+    /** 在编辑器中的起始位置 */
+    from: number;
+    /** 在编辑器中的结束位置 */
+    to: number;
+    /** 关联的自定义事件 (如音效、动作) */
+    events?: any[];
+    /** 关联的 TTS 标记 (如语速、语调、音量、语种) */
+    marks?: any[];
+}
+/**
+ * 命令执行结果
+ */
+interface CommandResult$1 {
+    /** 是否执行成功 */
+    success: boolean;
+    /** 错误码 (当 success 为 false 时必填) */
+    code?: CommandErrorCode;
+    /** 失败原因 (如果有) */
+    reason?: string;
+}
+/**
+ * 命令可用性状态
+ */
+interface CommandState {
+    /** 当前是否可用 */
+    available: boolean;
+    /** 错误码 (当 available 为 false 时提供) */
+    code?: CommandErrorCode;
+    /** 不可用原因 */
+    reason?: string;
+}
+/**
+ * 选区信息
+ */
+interface SelectionRange {
+    /** 起始位置 */
+    from: number;
+    /** 结束位置 */
+    to: number;
+    /** 选中的纯文本 */
+    text: string;
+}
+/**
+ * MarkEditor 对外暴露的公共接口
+ */
+interface IMarkEditor {
+    /** 是否可编辑 (读写控制) */
+    editable: boolean;
+    /** 当前已输入的有效字符总数 */
+    readonly count: number;
+    /**
+     * 获取当前选区信息
+     */
+    getSelection(): SelectionRange;
+    /**
+     * 获取编辑器纯文本内容
+     * @param options 读取配置
+     */
+    getPlainText(options?: {
+        contentMode?: ContentReadMode;
+    }): string;
+    /**
+     * 获取播放片段列表 (用于音画同步、分句合成)
+     * @param options 读取配置
+     */
+    getPlaybackSegments(options?: {
+        contentMode?: ContentReadMode;
+    }): PlaybackSegment[];
+    /**
+     * 执行编辑器命名命令
+     * @param commandName 命令名称 (建议配合枚举使用)
+     * @param args 命令参数
+     */
+    execute(commandName: string, ...args: unknown[]): CommandResult$1;
+    /**
+     * 设置编辑器内容
+     * @param content 新内容的 JSON 字符串，若为空则清空内容
+     * @param clearHistory 是否清除历史记录 (默认 true)
+     */
+    setContent(content?: string, clearHistory?: boolean): void;
+    /**
+     * 获取编辑器当前内容的 JSON 对象 (会自动过滤辅助字符)
+     */
+    toJSON(): EditorContent;
+    /**
+     * 从 HTML 导入内容 (内置 XSS 过滤与历史版本适配)
+     * @param html HTML 字符串
+     */
+    setContentFromHTML(html: string): void;
+    /**
+     * 从 XSSML 导入内容
+     * @param ssml XSSML 字符串
+     */
+    setContentFromSSML(ssml: string): void;
+    /**
+     * 获取所有注册命令的当前状态
+     */
+    getCurrentState(): Record<string, CommandState>;
+    /**
+     * 检查当前文档内容大小是否代表“空”
+     */
+    isEmptyContentSize(size: number): boolean;
+    /**
+     * 销毁编辑器实例，释放内存与事件
+     */
+    destroy(): void;
+    on<K extends keyof EditorEventMap>(event: K, listener: (payload: EditorEventMap[K]) => void): void;
+    off<K extends keyof EditorEventMap>(event: K, listener: (payload: EditorEventMap[K]) => void): void;
+    once<K extends keyof EditorEventMap>(event: K, listener: (payload: EditorEventMap[K]) => void): void;
+}
+/** 停顿 (Break) 参数 */
+interface BreakAttrs {
+    /** 停顿时间 (毫秒) */
+    value: number;
+    /** 显示文本 */
+    label?: string;
+}
+/** 读法 (SayAs) 参数 */
+interface SayAsAttrs {
+    /** 读法解析类型: digits(读数字), cardinal(读数值), auto(自动) */
+    interpretAs: string;
+}
+/** 音效 (SoundEvent) 参数 */
+interface SoundEventAttrs {
+    /** 音效 ID/路径 */
+    value: string;
+    /** 显示标题 */
+    label: string;
+    /** 音量 (0-100) */
+    volume?: number;
+}
+/** 语速/语调/音量 调节参数 */
+interface ProsodyAttrs {
+    /** 调节值 (通常 0-100，70位标准值) */
+    value: number;
+}
+/** 动作 (Action) 参数 */
+interface ActionAttrs {
+    /** 动作标识值 */
+    value: string;
+    /** 显示标题 */
+    label: string;
+}
+/** 等待 (Wait) 参数 */
+interface WaitAttrs {
+    /** 显示标题 */
+    label: string;
+    /** 等待值 (如秒数) */
+    value: string;
+    /** 等待类型: sleep(时长), video_ended(视频结束), audio_ended(音频结束) */
+    waitType: 'sleep' | 'video_ended' | 'audio_ended';
+    /** 附加上下文 */
+    context?: string;
+}
+
+declare class Editor extends EventEmitter<EditorEventMap> {
+    private view;
+    private config;
+    private registry;
+    private editorStateStore;
+    private commandRegister;
+    get editable(): boolean;
+    set editable(editable: boolean);
+    private wordcount;
+    private stateCollect;
+    maxWordCount: number;
+    private defaultPlugins;
+    isEmptyContentSize: (size: number) => size is 2;
+    getCurrentState(): Record<string, CommandState>;
+    constructor(props: EditorConfig$1);
+    private static mergeConfig;
+    private createView;
+    getSelection(): SelectionRange;
+    private mount;
+    getPlainText(options?: {
+        contentMode?: ContentReadMode;
+    }): string;
+    getPlaybackSegments(options?: {
+        contentMode?: ContentReadMode;
+    }): PlaybackSegment[];
+    execute(commandName: string, ...args: unknown[]): CommandResult$1;
+    setContent(content?: string, clearHistory?: boolean): void;
+    get count(): number;
+    toJSON(): any;
+    setContentFromSSML(ssml: string): void;
+    /**
+     * 通过 HTML 字符串设置编辑器内容
+     * 支持自动适配旧版的区间标记（数字读法等），并内置 XSS 过滤
+     * @param html HTML 字符串
+     */
+    setContentFromHTML(html: string): void;
+    destroy(): void;
+}
+
+interface ContextMenuState {
+    isActive: boolean;
+    event: MouseEvent;
+    pos: number;
+    coords: {
+        left: number;
+        top: number;
+    };
+    node?: {
+        type: string;
+        attrs: any;
+    };
+    selection: {
+        from: number;
+        to: number;
+        text: string;
+        content: any;
+        isClickInside: boolean;
+    };
+    target: HTMLElement;
+}
+interface ContextMenuOptions {
+    onRender?: (mountPoint: HTMLElement, state: ContextMenuState) => void;
+}
+declare class ContextMenuPlugin extends Plugin {
+    constructor(editor: Editor, options: ContextMenuOptions);
+}
+
+interface FloatingMenuState {
+    isActive: boolean;
+    rect: DOMRect | null;
+    from: number;
+    to: number;
+    text: string;
+    content: any;
+    target: HTMLElement;
+    isFlipped: boolean;
+}
+interface FloatingMenuOptions {
+    /**
+     * 允许业务方决定是否显示菜单的谓词函数
+     */
+    shouldShow?: (view: EditorView$1, state: {
+        isMouseDown: boolean;
+        isContextMenuOpen: boolean;
+        isPopoverVisible: boolean;
+    }) => boolean;
+    /**
+     * 渲染回调
+     */
+    onRender?: (mountPoint: HTMLElement, state: FloatingMenuState) => void;
+}
+declare class FloatingMenuPlugin extends Plugin {
+    constructor(editor: Editor, options: FloatingMenuOptions);
+}
+
+declare enum WordmarkCommands {
+    markWord = "markWord",
+    clearWordMark = "clearWordMark"
+}
+
+declare const TextMediaCommands: {
+    setTextMedia: string;
+    resetTextMediaStoredMark: string;
+};
+
+declare const NumberTipCommands: {
+    /** Switch number tagging mode */
+    switchNumberTipMode: string;
+};
+
+/**
+ * XSSML Editor SDK Logger
+ * Unified logging system to replace console.* calls
+ */
+declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
+declare class Logger {
+    private level;
+    private prefix;
+    /**
+     * Set the log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Log error messages
+     */
+    error(message: string, ...args: unknown[]): void;
+    /**
+     * Log warning messages
+     */
+    warn(message: string, ...args: unknown[]): void;
+    /**
+     * Log info messages
+     */
+    info(message: string, ...args: unknown[]): void;
+    /**
+     * Log debug messages
+     */
+    debug(message: string, ...args: unknown[]): void;
+}
+/**
+ * Global logger instance
+ */
+declare const logger: Logger;
+
+interface CommandContext {
+    state: EditorState$1;
+    dispatch: (tr: Transaction) => void;
+    view: EditorView$1;
+    editor?: Editor;
+}
+interface CommandResult {
+    success: boolean;
+    code?: CommandErrorCode;
+    reason?: string;
+}
+declare type CommandDefinitionProps = {
+    name: string;
+    description?: string;
+    execute: (context: CommandContext, ...args: unknown[]) => CommandResult;
+    validate?: (context: CommandContext, ...args: unknown[]) => {
+        available: boolean;
+        reason?: string;
+        code?: CommandErrorCode;
+    };
+};
+declare class CommandDefinition {
+    name: string;
+    description?: string;
+    execute: (context: CommandContext, ...args: unknown[]) => CommandResult;
+    validate?: (context: CommandContext, ...args: unknown[]) => {
+        available: boolean;
+        reason?: string;
+        code?: CommandErrorCode;
+    };
+    constructor(config: CommandDefinitionProps);
+}
+
+declare function registerCommand(command: CommandDefinition): void;
+
+type CustomNodeType = 'number' | 'break' | 'breath' | 'word' | 'phoneme' | 'command' | 'data' | 'wait' | 'ppt_control';
+type NodePosotionType = CustomNodeType | 'text' | 'soundEvent';
+type ContentMark = {
+    type: 'textmedia';
+    attrs: Record<string, unknown>;
+};
+interface ProseMirrorNode {
+    type: string;
+    text?: string;
+    content?: ProseMirrorNode[];
+    attrs?: Record<string, any>;
+    marks?: ContentMark[];
+}
+interface ProseMirrorDoc {
+    type: string;
+    content: ProseMirrorNode[];
+}
+interface NodePosition {
+    type: NodePosotionType;
+    start: number;
+    end: number;
+    text: string;
+    attrs?: Record<string, any>;
+    marks?: ContentMark[];
+}
+interface TextCustomEvent {
+    type: 'command' | 'textmedia' | 'ppt_control';
+    trigger: 'before' | 'after' | 'inner';
+    charOffset: number;
+    attrs?: Record<string, any>;
+    extra?: Record<string, any>;
+    eventLifeType?: 'start' | 'stop';
+}
+interface Sentence {
+    text: string;
+    start: number;
+    end: number;
+    events: TextCustomEvent[];
+    /** 关联的 TTS 标记 (如语速、语调、音量、语种) */
+    marks?: any[];
+    taskType: 'text' | 'soundEvent';
+}
+interface Task {
+    text?: '';
+    taskType: 'wait';
+    data: Record<string, any>;
+}
+interface PreProcess {
+    type: string;
+    value: string;
+}
+interface ParagraphInfo {
+    index: number;
+    preProcess: PreProcess[];
+    sentences: (Sentence | Task)[];
+}
+interface ParagraphizedResult {
+    paragraphs: ParagraphInfo[];
+}
+
+declare const DataPlaceholderReg: RegExp;
+declare class TextExtractor {
+    private currentPosition;
+    private readonly textRegExps;
+    private readonly config;
+    private readonly ATOMIC_NODE_TYPES;
+    private readonly SPLITED_NODE_TYPES;
+    private curParagraphLastRangeEvents;
+    /**
+     * 设置句子分割配置
+     * @param options 配置选项
+     */
+    setConfig(options: Partial<typeof this.config>): void;
+    /**
+     * 提取分句内容
+     * @param doc ProseMirror文档
+     * @param startPos 起始位置 (默认为0)
+     * @returns 分句结果，每句包含文本内容和位置信息
+     * @throws {Error} 当文档格式无效时抛出错误
+     */
+    extractSentences(doc: ProseMirrorDoc, startPos?: number): (Sentence | Task)[];
+    /**
+     * 将位置信息数组分割成句子
+     * @param positions 位置信息数组
+     * @returns 分句结果
+     */
+    private splitIntoSentences;
+    private isAtomicNode;
+    private isSplitedNode;
+    private getNodeSize;
+    private static createNodePosition;
+    private static handleSpecialNode;
+    private extractWithPosition;
+    extractParagraphizedSentences(doc: ProseMirrorDoc): ParagraphizedResult;
+    private static collectPreProcesss;
+}
+
+export { ActionCommands, BreakCommands, BreathCommands, CmdCommands, CommandErrorCode, ContentReadMode, ContextMenuPlugin, DataCommands, DataPlaceholderReg, EditorEvent, FloatingMenuPlugin, HighlightCommands, HistoryCommands, LogLevel, Editor as MarkEditor, MarkTagType, NumberTipCommands, PhonemeCommands, PptCommands, SayAsCommands, SayAsInterpretType, SoundEventCommands, SpeechLanguageCommands, SpeechPitchCommands, SpeechRateCommands, SpeechVolumeCommands, TextExtractor, TextInputCommands, TextMediaCommands, WaitCommands, WordCommands, WordmarkCommands, logger, registerCommand, registry };
+export type { ActionAttrs, BreakAttrs, ClickedTextMediaAttrs, CommandResult$1 as CommandResult, CommandState, ContentMark, ContextMenuEvent, ContextMenuState, CustomNodeType, EditorConfig, EditorContent, EditorEventMap, EditorStateChangeEvent, ErrorEvent, FloatingMenuState, FocusEvent, IMarkEditor, NodePosition, NodePosotionType, ParagraphInfo, ParagraphizedResult, PlaybackSegment, PreProcess, ProseMirrorDoc, ProseMirrorNode, ProsodyAttrs, SayAsAttrs, SelectionChangeEvent, SelectionRange, Sentence, SoundEventAttrs, Task, TextCustomEvent, WaitAttrs, WordCountEvent };