@atri-editor/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CherishDreams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @atri-editor/core
+
+基于 Tiptap v3 的框架无关富文本编辑器：Web Component、Markdown 双向转换、图片与附件上传管线、可插拔 AI 集成、中英文 i18n 与亮/暗主题。
+
+完整文档见仓库根 README 与 `demos/`（vanilla / vue / react 三个示例）。
+
+## 安装
+
+```bash
+pnpm add @atri-editor/core
+```
+
+## 使用
+
+```typescript
+import { AtriEditor } from '@atri-editor/core';
+import '@atri-editor/core/styles'; // 样式需显式引入
+
+const editor = new AtriEditor({
+  element: '#editor',
+  placeholder: '开始输入...',
+  content: '<p>Hello World!</p>',
+});
+
+editor.getMarkdown(); // HTML ⇄ Markdown 双向
+```
+
+也可以直接用自定义元素（导入包即自动注册）：
+
+```html
+<atri-editor theme="light" placeholder="开始输入..."></atri-editor>
+```
+
+## 说明
+
+- ESM-only（与上游 Tiptap v3 一致），需要现代打包器；Node 端 import 安全，编辑功能只在浏览器生效。
+- `@tiptap/*`、`@floating-ui/dom`、`i18next` 为运行时依赖，由本包的 `dependencies` 声明。
+- 当前版本尚未发布到 npm registry；以 workspace 或 `pnpm pack` 产物形式消费。
+
+## License
+
+MIT

package/dist/AtriEditor.d.ts

@@ -0,0 +1,192 @@
+/**
+ * AtriEditor - 编辑器主类
+ */
+import type { Editor } from '@tiptap/core';
+import type { AtriEditorOptions, IAtriEditor, InsertAttachmentOptions, InsertImageOptions, MediaKind, SetContentOptions, AtriAIConfig, AtriNodeViewConfig } from './types';
+import { ThemeManager } from './core/ThemeManager';
+import { I18nManager } from './core/I18nManager';
+import { ExtensionManager } from './core/ExtensionManager';
+import { AIService } from './ai/AIService';
+export declare class AtriEditor implements IAtriEditor {
+    private coreEditor;
+    private markdownService;
+    private themeManager;
+    private i18nManager;
+    private extensionManager;
+    private toolbarManager;
+    private aiService;
+    private aiMenuManager;
+    private mediaRuntime;
+    private mediaStatus;
+    /** 重建后待恢复的选区，新视图就绪时应用 */
+    private pendingViewState;
+    /**
+     * 浮动工具栏容器：BubbleMenu 显示时把它塞进编辑区、隐藏时直接摘掉，
+     * 所以引用必须握在门面手里，重建编辑器后才能拿同一个元素再挂回去
+     */
+    private bubbleElement;
+    private container;
+    private options;
+    constructor(options: AtriEditorOptions);
+    /** 开了 bubble 才建元素，且故意不插进文档：挂载与定位全归 BubbleMenu 插件管 */
+    private ensureBubbleElement;
+    private onEditorCreated;
+    private initAI;
+    /**
+     * 重新创建编辑器（用于动态注册 NodeView 后更新 schema）
+     * 会整体替换编辑器视图，因此内容与选区都要手动恢复
+     */
+    private recreateEditor;
+    /**
+     * 获取 Tiptap Editor 实例
+     */
+    get editor(): Editor;
+    /**
+     * 获取 HTML 内容
+     */
+    getHTML(): string;
+    /**
+     * 获取 JSON 内容
+     */
+    getJSON(): object;
+    /**
+     * 获取 Markdown 内容
+     */
+    getMarkdown(): string;
+    /**
+     * 设置内容
+     */
+    setContent(content: string | object, options?: SetContentOptions): void;
+    /**
+     * 设置 Markdown 内容
+     */
+    setMarkdown(content: string): void;
+    /**
+     * 整体替换内容后收拢选区：替换前若是全选（Ctrl+A），ProseMirror 会把它映射成
+     * 覆盖整篇新文档的 AllSelection——下一个字或下一次插入就把整篇吞掉，
+     * 而"设置内容"之后用户的预期是安全的光标态，不是"再输入即全删"
+     */
+    private collapseSelectionAfterReplace;
+    /**
+     * 清空内容
+     */
+    clearContent(): void;
+    /**
+     * 是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * Markdown 转 HTML
+     */
+    markdownToHTML(markdown: string): string;
+    /**
+     * HTML 转 Markdown
+     */
+    htmlToMarkdown(html: string): string;
+    /**
+     * Markdown 转 JSON
+     */
+    markdownToJSON(markdown: string): object;
+    /**
+     * 获取选中文本
+     */
+    getSelectedText(): string;
+    /**
+     * 插入内容
+     */
+    insertContent(content: string): void;
+    /**
+     * 在选区处插入图片
+     */
+    insertImage(options: InsertImageOptions): void;
+    /**
+     * 在选区处插入附件（形态由 options.display 或 media.attachment.display 决定）
+     */
+    insertAttachment(options: InsertAttachmentOptions): void;
+    /**
+     * 走上传管线插入本地文件
+     * kind 缺省时按 MIME 分流；promise 在这批文件全部落定（成功或失败）后 resolve
+     */
+    uploadFiles(files: File[] | FileList, kind?: MediaKind): Promise<void>;
+    /**
+     * 是否有文件还没落到服务端（上传中与失败都算）
+     * 此时保存会把本地预览地址写进内容，接入方应据此提示或阻断
+     */
+    hasPendingUploads(): boolean;
+    /**
+     * 重试所有失败的上传，卡片原地回到上传中
+     */
+    retryFailedUploads(): Promise<void>;
+    /**
+     * 设置占位符
+     */
+    setPlaceholder(placeholder: string): void;
+    /**
+     * 设置可编辑状态
+     */
+    setEditable(editable: boolean): void;
+    /**
+     * 是否可编辑
+     */
+    isEditable(): boolean;
+    /**
+     * 聚焦
+     */
+    focus(): void;
+    /**
+     * 失焦
+     */
+    blur(): void;
+    /**
+     * 获取 AI 服务
+     */
+    get ai(): AIService | null;
+    /**
+     * 获取主题管理器
+     */
+    get theme(): ThemeManager;
+    /**
+     * 获取国际化管理器
+     */
+    get i18n(): I18nManager;
+    /**
+     * 获取扩展管理器
+     */
+    get extensions(): ExtensionManager;
+    /**
+     * 设置主题
+     */
+    setTheme(theme: 'light' | 'dark' | string): void;
+    /**
+     * 切换主题
+     */
+    toggleTheme(): void;
+    /**
+     * 切换语言
+     */
+    setLanguage(lang: string): Promise<void>;
+    /**
+     * 更新 AI 配置
+     */
+    updateAIConfig(config: Partial<AtriAIConfig>): void;
+    /**
+     * 注册自定义 NodeView 组件
+     * 注意：编辑器已创建时，每次调用都会重建一次编辑器以更新 schema；
+     * 连续注册多个组件请改用 registerNodeViews，只需重建一次
+     */
+    registerNodeView(config: AtriNodeViewConfig): void;
+    /**
+     * 批量注册 NodeView
+     * 注意：如果编辑器已创建，会重新创建编辑器以更新 schema
+     */
+    registerNodeViews(configs: AtriNodeViewConfig[]): void;
+    /**
+     * 获取所有已注册的 NodeView
+     */
+    getNodeViews(): Map<string, AtriNodeViewConfig>;
+    /**
+     * 销毁编辑器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=AtriEditor.d.ts.map

package/dist/AtriEditor.d.ts.map

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

package/dist/AtriEditorElement.d.ts

@@ -0,0 +1,84 @@
+/**
+ * AtriEditorElement - Web Component 封装
+ */
+import { AtriEditor } from './AtriEditor';
+import type { AtriEditorOptions, InsertAttachmentOptions, InsertImageOptions, MediaKind } from './types';
+/**
+ * SSR / 纯 Node 安全基类：类声明会在模块加载时求值 extends 后的表达式，
+ * 直接 `extends HTMLElement` 会让无 DOM 的环境（Next/Nuxt 服务端、vitest node 池）
+ * import 即抛 "HTMLElement is not defined"。自定义元素只有在浏览器才真正生效，
+ * 这里回退到空基类，注册仍由 registerAtriElement 里的 customElements 守卫把关。
+ */
+declare const AtriEditorBase: typeof HTMLElement;
+/**
+ * 注册 Web Component
+ */
+export declare function registerAtriElement(): void;
+/**
+ * AtriEditor Web Component
+ */
+export declare class AtriEditorElement extends AtriEditorBase {
+    private editor;
+    private _options;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /**
+     * 设置编辑器选项（在 connectedCallback 之前调用）
+     */
+    setOptions(options: Partial<AtriEditorOptions>): void;
+    private initEditor;
+    private destroyEditor;
+    /**
+     * 获取编辑器实例
+     */
+    getEditor(): AtriEditor | null;
+    /**
+     * 获取 HTML 内容
+     */
+    getHTML(): string;
+    /**
+     * 获取 JSON 内容
+     */
+    getJSON(): object | null;
+    /**
+     * 获取 Markdown 内容
+     */
+    getMarkdown(): string;
+    /**
+     * 设置内容
+     */
+    setContent(content: string | object, format?: 'html' | 'json' | 'markdown'): void;
+    /**
+     * 清空内容
+     */
+    clearContent(): void;
+    /**
+     * 在选区处插入图片
+     */
+    insertImage(options: InsertImageOptions): void;
+    /**
+     * 在选区处插入附件卡片
+     */
+    insertAttachment(options: InsertAttachmentOptions): void;
+    /**
+     * 走上传管线插入本地文件
+     */
+    uploadFiles(files: File[] | FileList, kind?: MediaKind): Promise<void>;
+    /**
+     * 重试所有失败的上传
+     */
+    retryFailedUploads(): Promise<void>;
+    /**
+     * 是否有文件还没落到服务端（上传中与失败都算），保存前可据此提示
+     */
+    hasPendingUploads(): boolean;
+    /**
+     * 聚焦
+     */
+    focus(): void;
+}
+export {};
+//# sourceMappingURL=AtriEditorElement.d.ts.map

package/dist/AtriEditorElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AtriEditorElement.d.ts","sourceRoot":"","sources":["../src/AtriEditorElement.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,SAAS,EACV,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,QAAA,MAAM,cAAc,EAAE,OAAO,WACmE,CAAC;AAEjG;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAS1C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAkC;IAElD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,cAEC;IAED,iBAAiB,IAAI,IAAI,CAExB;IAED,oBAAoB,IAAI,IAAI,CAE3B;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAyB7F;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAEpD;IAED,OAAO,CAAC,UAAU;IA2ClB,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,SAAS,IAAI,UAAU,GAAG,IAAI,CAE7B;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED;;OAEG;IACH,WAAW,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAEhF;IAED;;OAEG;IACH,YAAY,IAAI,IAAI,CAEnB;IAED;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAE7C;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAEvD;IAED;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;IAED;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAExC;IAED;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/ai/AICommandMenu.d.ts

@@ -0,0 +1,59 @@
+/**
+ * AICommandMenu - AI 命令菜单（使用 Floating UI）
+ */
+import type { Editor } from '@tiptap/core';
+import type { AtriAIFunction } from '../types';
+export interface AICommandMenuOptions {
+    /** AI 功能列表 */
+    functions: AtriAIFunction[];
+    /** 触发字符（默认 /） */
+    triggerChar?: string;
+    /** 选择回调 */
+    onSelect?: (func: AtriAIFunction) => void;
+}
+/**
+ * AI 命令菜单管理器
+ * 提供 / 触发 AI 命令菜单功能
+ */
+export declare class AICommandMenuManager {
+    private editor;
+    private functions;
+    private menuElement;
+    private isVisible;
+    private selectedIndex;
+    private triggerChar;
+    private onSelect?;
+    private detachKeyListener?;
+    constructor(editor: Editor, functions: AtriAIFunction[], triggerChar?: string, onSelect?: (func: AtriAIFunction) => void);
+    /**
+     * 让键盘导航可达
+     * 监听挂在 document 捕获阶段：ProseMirror 在 view.dom 上已有 keymap，
+     * 若等它先处理，Enter 会被用来拆段而不是选中菜单项
+     */
+    private setupMenuKeyListener;
+    private setupKeyboardListener;
+    private getLastTypedChar;
+    /**
+     * 显示菜单
+     */
+    show(): void;
+    /**
+     * 隐藏菜单
+     */
+    hide(): void;
+    private createMenuElement;
+    private positionMenu;
+    private selectItem;
+    private highlightItem;
+    private updateHighlight;
+    private deleteTriggerChar;
+    /**
+     * 处理键盘事件
+     */
+    handleKeyDown(event: KeyboardEvent): boolean;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=AICommandMenu.d.ts.map

package/dist/ai/AICommandMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AICommandMenu.d.ts","sourceRoot":"","sources":["../../src/ai/AICommandMenu.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,cAAc;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,iBAAiB;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAiC;IAClD,OAAO,CAAC,iBAAiB,CAAC,CAAa;IAEvC,YACE,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,EAAE,EAC3B,WAAW,GAAE,MAAY,EACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,EAQ1C;IAED;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,IAAI,IAAI,IAAI,CAMX;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CAOX;IAED,OAAO,CAAC,iBAAiB;YAwCX,YAAY;IAkC1B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CA6B3C;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAId;CACF"}

package/dist/ai/AIInterceptor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * AIInterceptor - AI 拦截器链执行
+ */
+import type { AIRequestContext, AIResponse, AtriAIInterceptors } from '../types';
+import type { MarkdownService } from '../core/MarkdownService';
+export declare class AIInterceptor {
+    private interceptors;
+    private markdownService;
+    private autoTranslateMarkdown;
+    constructor(interceptors?: AtriAIInterceptors, markdownService?: MarkdownService | null, autoTranslateMarkdown?: boolean);
+    /**
+     * 执行 beforePost 拦截器
+     * @returns 处理后的 context，返回 false 表示取消请求
+     */
+    runBeforePost(context: AIRequestContext): Promise<AIRequestContext | false>;
+    /**
+     * 执行 afterPost 拦截器
+     */
+    runAfterPost(response: AIResponse, context: AIRequestContext): Promise<AIResponse>;
+    /**
+     * 执行 beforeRender 拦截器
+     */
+    runBeforeRender(content: string, context: AIRequestContext): Promise<string>;
+    /**
+     * 执行 autoTranslateMarkdownToHTML
+     * 在 beforeRender 之后执行，自动将 Markdown 转为 HTML
+     */
+    runAutoTranslateMarkdown(content: string, response: AIResponse): Promise<string>;
+    /**
+     * 执行 afterRender 回调
+     */
+    runAfterRender(content: string, context: AIRequestContext): Promise<void>;
+    /**
+     * 完整执行拦截器链
+     * 流程: beforePost -> requestEndpoint -> afterPost -> beforeRender -> autoTranslateMarkdown -> insert -> afterRender
+     */
+    executeChain(context: AIRequestContext, requestEndpoint: (ctx: AIRequestContext) => Promise<AIResponse>, insertCallback: (content: string) => void): Promise<void>;
+}
+//# sourceMappingURL=AIInterceptor.d.ts.map

package/dist/ai/AIInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIInterceptor.d.ts","sourceRoot":"","sources":["../../src/ai/AIInterceptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,qBAAqB,CAAU;IAEvC,YACE,YAAY,GAAE,kBAAuB,EACrC,eAAe,GAAE,eAAe,GAAG,IAAW,EAC9C,qBAAqB,GAAE,OAAc,EAKtC;IAED;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,GAAG,KAAK,CAAC,CAMhF;IAED;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAKvF;IAED;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjF;IAED;;;OAGG;IACG,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBrF;IAED;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;IAED;;;OAGG;IACG,YAAY,CAChB,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,EAC/D,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACxC,OAAO,CAAC,IAAI,CAAC,CAwBf;CACF"}

package/dist/ai/AIService.d.ts

@@ -0,0 +1,42 @@
+/**
+ * AIService - AI 功能调度服务
+ */
+import type { Editor } from '@tiptap/core';
+import type { AtriAIConfig, AtriAIFunction } from '../types';
+import { MarkdownService } from '../core/MarkdownService';
+export declare class AIService {
+    private editor;
+    private config;
+    private interceptor;
+    private markdownService;
+    constructor(editor: Editor, config: AtriAIConfig, markdownService?: MarkdownService | null);
+    /**
+     * 获取所有 AI 功能
+     */
+    getFunctions(): AtriAIFunction[];
+    /**
+     * 根据 ID 获取 AI 功能
+     */
+    getFunction(id: string): AtriAIFunction | undefined;
+    /**
+     * 构建请求上下文
+     */
+    private buildContext;
+    /**
+     * 执行 AI 功能
+     */
+    execute(functionId: string): Promise<void>;
+    /**
+     * 插入内容到编辑器
+     */
+    private insertContent;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<AtriAIConfig>): void;
+    /**
+     * 设置 Markdown 服务
+     */
+    setMarkdownService(service: MarkdownService): void;
+}
+//# sourceMappingURL=AIService.d.ts.map

package/dist/ai/AIService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIService.d.ts","sourceRoot":"","sources":["../../src/ai/AIService.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAoB,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,eAAe,CAAgC;IAEvD,YACE,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,eAAe,GAAE,eAAe,GAAG,IAAW,EAa/C;IAED;;OAEG;IACH,YAAY,IAAI,cAAc,EAAE,CAE/B;IAED;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,OAAO,CAAC,YAAY;IAgCpB;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/C;IAED;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAOhD;IAED;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAOjD;CACF"}

package/dist/ai/index.d.ts

@@ -0,0 +1,5 @@
+export { AIService } from './AIService';
+export { AIInterceptor } from './AIInterceptor';
+export { AICommandMenuManager } from './AICommandMenu';
+export type { AICommandMenuOptions } from './AICommandMenu';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/CoreEditor.d.ts

@@ -0,0 +1,100 @@
+/**
+ * CoreEditor - Tiptap v3 编辑器封装
+ */
+import { Editor, type EditorOptions } from '@tiptap/core';
+import { MediaRuntime } from '../media/MediaRuntime';
+import type { AtriMarkdownConfig, AtriMediaConfig } from '../types';
+export interface CoreEditorConfig {
+    element: HTMLElement;
+    content?: string | object;
+    contentFormat?: 'html' | 'json' | 'markdown';
+    editable?: boolean;
+    placeholder?: string;
+    extensions?: EditorOptions['extensions'];
+    markdown?: AtriMarkdownConfig;
+    /** 媒体（图片 / 附件）配置，false 时不注册任何媒体节点 */
+    media?: AtriMediaConfig | false;
+    /**
+     * 复用外部的上传运行时
+     * AtriEditor 重建编辑器时会把同一个实例传进来，进行中的上传才不会丢
+     */
+    mediaRuntime?: MediaRuntime;
+    /**
+     * 选区浮动工具栏的挂载元素：给了就注册 BubbleMenu，不给就不注册
+     * 元素由门面持有 —— 插件隐藏时会把它从文档里摘掉，显示时再 append 回来
+     */
+    bubbleElement?: HTMLElement | null;
+    onCreate?: () => void;
+    onUpdate?: () => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+    onDestroy?: () => void;
+}
+export declare class CoreEditor {
+    private editor;
+    private config;
+    /** 占位符文本：由 Placeholder 扩展以函数形式每次读取，改值即可生效 */
+    private placeholderText;
+    private mediaRuntime;
+    constructor(config: CoreEditorConfig);
+    private createEditor;
+    /**
+     * 获取上传运行时；media 为 false 时为 null
+     */
+    getMediaRuntime(): MediaRuntime | null;
+    /**
+     * 获取 Tiptap Editor 实例
+     */
+    getEditor(): Editor;
+    /**
+     * 获取 HTML 内容
+     */
+    getHTML(): string;
+    /**
+     * 获取 JSON 内容
+     */
+    getJSON(): object;
+    /**
+     * 设置内容
+     */
+    setContent(content: string | object, emitUpdate?: boolean): void;
+    /**
+     * 清空内容
+     */
+    clearContent(): void;
+    /**
+     * 是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * 设置可编辑状态
+     */
+    setEditable(editable: boolean): void;
+    /**
+     * 是否可编辑
+     */
+    isEditable(): boolean;
+    /**
+     * 聚焦
+     */
+    focus(): void;
+    /**
+     * 失焦
+     */
+    blur(): void;
+    /**
+     * 插入内容
+     */
+    insertContent(content: string): void;
+    /**
+     * 设置占位符
+     * 占位符写在节点装饰上，只在状态重算时重新取值，因此派发一个空事务刷新视图；
+     * 空事务不改动文档，Tiptap 不会据此触发 update
+     */
+    setPlaceholder(placeholder: string): void;
+    /**
+     * 销毁编辑器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=CoreEditor.d.ts.map

package/dist/core/CoreEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreEditor.d.ts","sourceRoot":"","sources":["../../src/core/CoreEditor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAOxE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,qCAAqC;IACrC,KAAK,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAmB;IACjC,6CAA6C;IAC7C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAsB;IAE1C,YAAY,MAAM,EAAE,gBAAgB,EAMnC;IAED,OAAO,CAAC,YAAY;IA2GpB;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI,CAErC;IAED;;OAEG;IACH,SAAS,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,CAUhB;IAED;;OAEG;IACH,OAAO,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,UAAO,GAAG,IAAI,CAE5D;IAED;;OAEG;IACH,YAAY,IAAI,IAAI,CAEnB;IAED;;OAEG;IACH,OAAO,IAAI,OAAO,CAEjB;IAED;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAEnC;IAED;;OAEG;IACH,UAAU,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CAEX;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnC;IAED;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGxC;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAEd;CACF"}

package/dist/core/ExtensionManager.d.ts

@@ -0,0 +1,47 @@
+import type { AnyExtension } from '@tiptap/core';
+import type { AtriExtensionMeta, AtriNodeViewConfig } from '../types';
+export declare class ExtensionManager {
+    private extensions;
+    private nodeViews;
+    /**
+     * 注册扩展
+     */
+    register(extension: AnyExtension, _meta?: AtriExtensionMeta): void;
+    /**
+     * 批量注册扩展
+     */
+    registerAll(extensions: AnyExtension[]): void;
+    /**
+     * 注册自定义 NodeView
+     */
+    registerNodeView(config: AtriNodeViewConfig): void;
+    /**
+     * 批量注册 NodeView
+     */
+    registerNodeViews(configs: AtriNodeViewConfig[]): void;
+    /**
+     * 获取扩展
+     */
+    get(name: string): AnyExtension | undefined;
+    /**
+     * 卸载扩展
+     */
+    unregister(name: string): boolean;
+    /**
+     * 获取所有扩展
+     */
+    getAll(): AnyExtension[];
+    /**
+     * 获取所有已注册的 NodeView
+     */
+    getNodeViews(): Map<string, AtriNodeViewConfig>;
+    /**
+     * 是否已注册
+     */
+    has(name: string): boolean;
+    /**
+     * 清空所有扩展
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ExtensionManager.d.ts.map

package/dist/core/ExtensionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionManager.d.ts","sourceRoot":"","sources":["../../src/core/ExtensionManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEtE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,SAAS,CAA8C;IAE/D;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAMjE;IAED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAE5C;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CA6CjD;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAErD;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1C;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhC;IAED;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE,CAEvB;IAED;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAE9C;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;CACF"}