@atri-editor/core 0.1.0

package/dist/types/editor.d.ts

@@ -0,0 +1,140 @@
+import type { Editor, Extension } from '@tiptap/core';
+import type { AtriAIConfig } from './ai';
+import type { AtriMarkdownConfig } from './markdown';
+import type { AtriMediaConfig, InsertAttachmentOptions, InsertImageOptions, MediaKind } from './media';
+import type { AtriNodeViewConfig } from './extension';
+/**
+ * 工具栏配置
+ */
+export interface ToolbarConfig {
+    /**
+     * 工具栏项，按顺序渲染；省略时使用默认全集
+     * 字符串为内置项 id，ToolbarItem 可在内置项基础上覆盖图标与文案
+     */
+    items?: (string | ToolbarItem)[];
+    /**
+     * 选中文字或图片 / 附件时在选区旁浮出的工具栏，默认关闭，与固定顶栏共存
+     * 按钮分两组：文字选区是行内格式五项，选中附件是「附件样式 + 删除」、选中图片只有「删除」
+     * 只在创建时生效：BubbleMenu 的挂载元素走扩展选项，而 tiptap v3 没有运行时注册扩展的入口
+     */
+    bubble?: boolean;
+}
+/**
+ * 工具栏项
+ */
+export interface ToolbarItem {
+    /** 内置项标识 */
+    id: string;
+    /** 显示名称（无 icon 时以文字渲染按钮） */
+    label?: string;
+    /** 图标（SVG 字符串，优先于 label 与内置图标） */
+    icon?: string;
+    /** 提示文字，优先于当前语言的内置词条 */
+    tooltip?: string;
+    /** 子菜单（尚未实现，声明后会被忽略） */
+    children?: ToolbarItem[];
+}
+/**
+ * 设置内容选项
+ */
+export interface SetContentOptions {
+    /** 内容格式 */
+    format?: 'html' | 'json' | 'markdown';
+    /** 是否触发变更事件 */
+    emitUpdate?: boolean;
+}
+/**
+ * 编辑器配置
+ */
+export interface AtriEditorOptions {
+    /** 挂载元素 */
+    element: string | HTMLElement;
+    /** 初始内容 */
+    content?: string | object;
+    /** 内容格式 */
+    contentFormat?: 'html' | 'json' | 'markdown';
+    /** 主题 */
+    theme?: 'light' | 'dark' | string;
+    /** 语言 */
+    lang?: string;
+    /** 是否可编辑 */
+    editable?: boolean;
+    /** 占位符 */
+    placeholder?: string;
+    /** 工具栏配置 */
+    toolbar?: ToolbarConfig | false;
+    /** 扩展列表 */
+    extensions?: Extension[];
+    /** NodeView 自定义组件配置 */
+    nodeViews?: AtriNodeViewConfig[];
+    /** AI 配置 */
+    ai?: AtriAIConfig;
+    /** Markdown 配置 */
+    markdown?: AtriMarkdownConfig;
+    /** 媒体（图片 / 附件）配置，false 时不注册图片与附件节点 */
+    media?: AtriMediaConfig | false;
+    /** 创建完成回调 */
+    onCreate?: (editor: IAtriEditor) => void;
+    /** 内容变更回调 */
+    onChange?: (editor: IAtriEditor) => void;
+    /** 聚焦回调 */
+    onFocus?: (editor: IAtriEditor) => void;
+    /** 失焦回调 */
+    onBlur?: (editor: IAtriEditor) => void;
+    /** 销毁回调 */
+    onDestroy?: (editor: IAtriEditor) => void;
+}
+/**
+ * 编辑器接口
+ */
+export interface IAtriEditor {
+    /** Tiptap Editor 实例 */
+    readonly editor: Editor;
+    /** 获取 HTML 内容 */
+    getHTML(): string;
+    /** 获取 JSON 内容 */
+    getJSON(): object;
+    /** 获取 Markdown 内容 */
+    getMarkdown(): string;
+    /** 设置内容 */
+    setContent(content: string | object, options?: SetContentOptions): void;
+    /** 设置 Markdown 内容 */
+    setMarkdown(content: string): void;
+    /** 清空内容 */
+    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;
+    /** 设置占位符 */
+    setPlaceholder(placeholder: string): void;
+    /** 在选区处插入图片 */
+    insertImage(options: InsertImageOptions): void;
+    /** 在选区处插入附件卡片 */
+    insertAttachment(options: InsertAttachmentOptions): void;
+    /** 走上传管线插入本地文件，promise 在这批文件全部落定后 resolve */
+    uploadFiles(files: File[] | FileList, kind?: MediaKind): Promise<void>;
+    /** 重试所有失败的上传 */
+    retryFailedUploads(): Promise<void>;
+    /** 是否有文件还没落到服务端（上传中与失败都算） */
+    hasPendingUploads(): boolean;
+    /** 设置可编辑状态 */
+    setEditable(editable: boolean): void;
+    /** 是否可编辑 */
+    isEditable(): boolean;
+    /** 聚焦 */
+    focus(): void;
+    /** 失焦 */
+    blur(): void;
+    /** 销毁编辑器 */
+    destroy(): void;
+}
+//# sourceMappingURL=editor.d.ts.map

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

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

package/dist/types/events.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 编辑器事件类型
+ */
+export type AtriEventType = 'create' | 'change' | 'focus' | 'blur' | 'destroy' | 'ai:start' | 'ai:complete' | 'ai:error';
+/**
+ * 编辑器事件
+ */
+export interface AtriEvent {
+    type: AtriEventType;
+    editor: unknown;
+    data?: unknown;
+}
+/**
+ * AI 事件
+ */
+export interface AtriAIEvent {
+    type: 'ai:start' | 'ai:complete' | 'ai:error';
+    functionId: string;
+    content?: string;
+    error?: Error;
+}
+/**
+ * 事件监听器
+ */
+export type AtriEventListener = (event: AtriEvent) => void;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,SAAS,GACT,UAAU,GACV,aAAa,GACb,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC"}

package/dist/types/extension.d.ts

@@ -0,0 +1,61 @@
+import type { Extension, NodeViewRenderer } from '@tiptap/core';
+/**
+ * 扩展类别
+ */
+export type ExtensionCategory = 'basic' | 'media' | 'block' | 'enhanced' | 'ai' | 'custom';
+/**
+ * 扩展元数据
+ */
+export interface AtriExtensionMeta {
+    name: string;
+    version: string;
+    description?: string;
+    category: ExtensionCategory;
+}
+/**
+ * Atri 扩展（基于 Tiptap Extension）
+ */
+export interface AtriExtension extends Extension {
+    meta?: AtriExtensionMeta;
+}
+/**
+ * NodeView 属性定义
+ */
+export interface NodeViewAttribute {
+    default?: any;
+    keepOnSplit?: boolean;
+    parseHTML?: (element: HTMLElement) => any;
+    renderHTML?: (attributes: Record<string, any>) => Record<string, any> | null;
+}
+/**
+ * NodeView 配置
+ */
+export interface AtriNodeViewConfig {
+    /** 节点类型名称 */
+    name: string;
+    /** NodeView 渲染器 */
+    nodeView: NodeViewRenderer;
+    /** 节点属性定义 */
+    attributes?: Record<string, NodeViewAttribute>;
+    /** HTML 序列化配置 */
+    renderHTML?: (props: {
+        HTMLAttributes: Record<string, any>;
+        node: any;
+    }) => any;
+    /** HTML 解析配置 */
+    parseHTML?: () => Array<{
+        tag: string;
+        getAttrs?: (el: HTMLElement) => any;
+    }>;
+    /** 是否为内联节点 */
+    inline?: boolean;
+    /** 是否为原子节点（不可编辑内容） */
+    atom?: boolean;
+    /** 节点分组 */
+    group?: string;
+    /** 节点描述 */
+    description?: string;
+    /** 自定义 Markdown 序列化回调 */
+    markdownSerialize?: (node: any) => string;
+}
+//# sourceMappingURL=extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/types/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,GAAG,CAAC;IAC1C,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;CAC9E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC/C,iBAAiB;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,KAAK,GAAG,CAAC;IAChF,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,GAAG,CAAA;KAAE,CAAC,CAAC;IAC9E,cAAc;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC;CAC3C"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './ai';
+export * from './markdown';
+export * from './media';
+export * from './editor';
+export * from './events';
+export * from './extension';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/types/markdown.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Markdown 配置
+ */
+export interface AtriMarkdownConfig {
+    /** 是否启用 Markdown 支持（默认 true） */
+    enabled?: boolean;
+    /**
+     * 列表与代码块的缩进，原样转发给 Tiptap 的 Markdown 扩展，默认 `{ style: 'space', size: 2 }`
+     */
+    indentation?: {
+        style?: 'space' | 'tab';
+        size?: number;
+    };
+    /** marked 配置选项 */
+    markedOptions?: {
+        /** GitHub Flavored Markdown */
+        gfm?: boolean;
+        /** \n 转 <br> */
+        breaks?: boolean;
+        /** 严格模式 */
+        pedantic?: boolean;
+    };
+    /**
+     * 输入时实时转换（Markdown 风格 input rules），默认 true
+     * 作用于所有扩展注册的 input rules，不影响粘贴处理与 Markdown 序列化
+     */
+    shortcuts?: boolean;
+}
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/types/markdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,kBAAkB;IAClB,aAAa,CAAC,EAAE;QACd,+BAA+B;QAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,gBAAgB;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,WAAW;QACX,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/types/media.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 媒体（图片 / 附件）配置
+ */
+/** 上传进度 */
+export interface UploadProgress {
+    /** 0-100 */
+    percent: number;
+    loaded: number;
+    total: number;
+}
+/** 上传结果；name / size / mime 缺省时沿用本地文件的值 */
+export interface UploadResult {
+    url: string;
+    name?: string;
+    size?: number;
+    mime?: string;
+}
+/** 自定义上传时的上下文 */
+export interface UploadContext {
+    onProgress: (progress: UploadProgress) => void;
+    /** 编辑器销毁或用户取消时中止 */
+    signal: AbortSignal;
+}
+/**
+ * 完全接管上传：库不发请求，只负责把结果写回文档
+ * 给了它就忽略 endpoint 分支
+ */
+export type UploadHandler = (file: File, context: UploadContext) => Promise<UploadResult>;
+/**
+ * 内置上传通道（XHR，fetch 拿不到可移植的上传进度）
+ */
+export interface AtriUploadConfig {
+    /** 接收 multipart/form-data 的接口地址 */
+    endpoint: string;
+    /** 文件字段名，默认 `file` */
+    fieldName?: string;
+    /** 附加请求头，如授权令牌 */
+    headers?: Record<string, string>;
+    /** 是否携带 Cookie */
+    withCredentials?: boolean;
+    /** 服务端要求的文件名与本地不同时使用 */
+    requestName?: (file: File) => string;
+    /** 响应体形状千差万别，用它挑出 url；缺省时依次找 url / data.url / location */
+    transformResult?: (body: unknown, file: File) => UploadResult;
+}
+/**
+ * 媒体类型，与同名节点一一对应
+ */
+export type MediaKind = 'image' | 'attachment';
+/** 插入被拒绝的原因 */
+export type MediaRejectReason = 
+/** 超出 maxFileSize */
+'too-large'
+/** 不在 accept 白名单内 */
+ | 'unsupported-type'
+/** 一次投放的文件数超过 maxFiles，多出来的那些每个回调一次 */
+ | 'too-many'
+/** 本地文件需要上传，但没配上传通道也不允许 base64 */
+ | 'no-upload'
+/** 请求发出后失败 */
+ | 'upload-failed';
+/** 插入被拒绝时回调 */
+export interface MediaRejection {
+    file: File;
+    reason: MediaRejectReason;
+    /** upload-failed 时的原始错误 */
+    cause?: unknown;
+}
+/**
+ * 图片节点配置
+ */
+export interface AtriImageConfig {
+    /** 是否作为内联节点插入，默认 false（块级） */
+    inline?: boolean;
+    /**
+     * 是否允许 data URL 形式的 base64 图片，默认 false
+     * 同时也是没有上传通道时的退路开关：关掉它，本地文件将无从插入
+     */
+    allowBase64?: boolean;
+    /**
+     * 上传失败后是否把这张图读成 data URL 内联，默认 false（只有图片有这条退路）
+     *
+     * 内联写进文档的是 data URL，而编辑器重建时按 `getHTML()` 回填——节点不认 data URL
+     * 就等于内容重建一次就没，所以这个开关会连带打开 `allowBase64`
+     *
+     * 内联成功后图片仍标着 error 态，「重试」还能把原文件再传一次换成服务端地址；
+     * 但内容已经安全落进文档，`hasPendingUploads()` 不再把它算作待处理
+     */
+    fallbackToBase64?: boolean;
+    /** 是否显示缩放手柄，默认 true */
+    resize?: boolean;
+    /** 类型白名单，如 `image/*` 或 `.png,.jpg` */
+    accept?: string | string[];
+}
+/**
+ * 附件显示形态：块级卡片 / 行内链接（两个节点类型，切换命令在它们之间换节点）
+ */
+export type AtriAttachmentDisplay = 'card' | 'link';
+/**
+ * 附件节点配置
+ */
+export interface AtriAttachmentConfig {
+    /** 类型白名单，默认不限 */
+    accept?: string | string[];
+    /** 新插入附件的默认形态，默认 'card'；上传中与失败的表达在链接形态下与图片同一套语 */
+    display?: AtriAttachmentDisplay;
+}
+/**
+ * 插入图片的参数
+ */
+export interface InsertImageOptions {
+    src: string;
+    alt?: string;
+    title?: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * 插入附件的参数
+ */
+export interface InsertAttachmentOptions {
+    /** 文件地址 */
+    src: string;
+    /** 展示名，缺省时从 src 推导 */
+    name?: string | null;
+    /** 字节数 */
+    size?: number | null;
+    mime?: string | null;
+    /** 显示形态，缺省走 media.attachment.display 配置 */
+    display?: AtriAttachmentDisplay;
+}
+/**
+ * 媒体配置；传 false 完全不注册图片与附件扩展
+ */
+export interface AtriMediaConfig {
+    /** 上传通道：配置对象走内置 XHR，或直接给一个函数完全接管 */
+    upload?: AtriUploadConfig | UploadHandler;
+    /** 单个文件上限（字节），默认 10MB */
+    maxFileSize?: number;
+    /** 一次投放/选择的文件数上限，默认 10 */
+    maxFiles?: number;
+    /** 校验不通过或上传失败时回调，编辑器不弹任何默认提示 */
+    onError?: (rejection: MediaRejection) => void;
+    /** 图片配置 */
+    image?: AtriImageConfig;
+    /** 附件配置 */
+    attachment?: AtriAttachmentConfig;
+}
+//# sourceMappingURL=media.d.ts.map

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

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

package/dist/utils/dom.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DOM 工具函数
+ */
+/**
+ * 解析元素选择器，返回 HTMLElement
+ */
+export declare function resolveElement(element: string | HTMLElement): HTMLElement;
+/**
+ * 创建带 class 的 div 元素
+ */
+export declare function createContainer(className?: string): HTMLDivElement;
+/**
+ * 检查是否在浏览器环境
+ */
+export declare function isBrowser(): boolean;
+//# sourceMappingURL=dom.d.ts.map

package/dist/utils/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CASzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAMlE;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './dom';
+export * from './selection';
+export * from './markdown';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/utils/markdown.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Markdown 工具函数
+ */
+/**
+ * 简单的 Markdown 转 HTML（用于 AI 响应处理）
+ * 注意：完整的 Markdown 解析由 @tiptap/markdown 处理
+ * 这里仅提供基础的 Markdown 语法转换
+ */
+export declare function simpleMarkdownToHtml(markdown: string): string;
+/**
+ * 简单的 HTML 转 Markdown
+ */
+export declare function simpleHtmlToMarkdown(html: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6C7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8CzD"}

package/dist/utils/selection.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 选区工具函数
+ */
+import type { Editor } from '@tiptap/core';
+/**
+ * 获取选中文本
+ */
+export declare function getSelectedText(editor: Editor): string;
+/**
+ * 获取光标前的文本（当前段落）
+ */
+export declare function getCursorContext(editor: Editor, maxLength?: number): string;
+/**
+ * 获取文档纯文本
+ */
+export declare function getDocumentText(editor: Editor): string;
+//# sourceMappingURL=selection.d.ts.map

package/dist/utils/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/utils/selection.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAShF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@atri-editor/core",
+  "version": "0.1.0",
+  "description": "Core package for Atri Editor",
+  "keywords": [
+    "editor",
+    "rich-text",
+    "tiptap",
+    "web-component",
+    "wysiwyg"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CherishDreams/atri-editor.git"
+  },
+  "files": [
+    "dist",
+    "styles.d.ts"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles": {
+      "types": "./styles.d.ts",
+      "default": "./dist/style.css"
+    }
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && pnpm run build:types && pnpm run build:styles",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:styles": "sass src/styles/index.scss dist/style.css --style=expanded --no-source-map",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@floating-ui/dom": "^1.6.0",
+    "@tiptap/core": "^3.30.4",
+    "@tiptap/extension-bubble-menu": "^3.30.4",
+    "@tiptap/extension-image": "^3.30.4",
+    "@tiptap/extension-text-align": "^3.30.4",
+    "@tiptap/extensions": "^3.30.4",
+    "@tiptap/markdown": "^3.30.4",
+    "@tiptap/pm": "^3.30.4",
+    "@tiptap/starter-kit": "^3.30.4",
+    "i18next": "^23.11.0"
+  },
+  "devDependencies": {
+    "jsdom": "^30.0.1",
+    "sass": "^1.103.1",
+    "typescript": "^7.0.0",
+    "vite": "^5.2.0",
+    "vitest": "^3.2.7"
+  }
+}

package/styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 样式子路径的类型声明：运行时由打包器加载 dist/style.css，
+ * 这里只用于让 `import '@atri-editor/core/styles'` 通过类型检查。
+ */
+declare const styles: string;
+export default styles;