tiptap-vue-pro-core 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 tiptap-vue-pro contributors
+
+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.
+
+---
+
+本项目基于以下开源项目构建,它们各自遵循其原始许可协议:
+- Tiptap (https://tiptap.dev) — MIT License
+- ProseMirror (https://prosemirror.net) — MIT License
+- Element Plus (https://element-plus.org) — MIT License

package/README.md

@@ -0,0 +1,34 @@
+# tiptap-vue-pro-core
+
+UI 无关的 Tiptap v3 + Vue 3 富文本编辑器核心层。
+
+这个包只提供 `useProEditor()`、默认扩展、命令聚合、图片上传辅助和类型契约,不包含现成 UI。想开箱即用请安装对应 adapter:
+
+- Element Plus: `tiptap-vue-pro-element-plus`
+- Naive UI: `tiptap-vue-pro-naive`
+
+## 安装
+
+```bash
+pnpm add tiptap-vue-pro-core @tiptap/core @tiptap/pm @tiptap/vue-3
+```
+
+## 用法
+
+```vue
+<script setup lang="ts">
+import { EditorContent } from '@tiptap/vue-3'
+import { useProEditor } from 'tiptap-vue-pro-core'
+
+const ctx = useProEditor({
+  content: '<p>hello core</p>',
+})
+</script>
+
+<template>
+  <button @click="ctx.commands.bold()">Bold</button>
+  <EditorContent :editor="ctx.editor.value" />
+</template>
+```
+
+完整文档和 Demo: https://github.com/twoer/tiptap-vue-pro

package/dist/extensions/image.d.ts

@@ -0,0 +1,29 @@
+import { Extensions } from '@tiptap/core';
+/**
+ * 自定义 Image 扩展(基于官方 @tiptap/extension-image)。
+ *
+ * 在官方基础上增强两点(对标飞书图片):
+ * 1. 开启 v3 原生 resize —— 通过 configure.resize 配置 ResizableNodeView,
+ *    支持四角拖拽缩放(alwaysPreserveAspectRatio 锁比例,与飞书一致)。
+ * 2. 预留 align / caption 两个 schema 属性 —— 对齐与题注的「数据层」。
+ *    属性定义本身不依赖任何 UI;具体渲染(NodeView 的对齐样式、题注输入框)
+ *    在后续能力里逐步叠加。
+ *
+ * 架构约束:本文件在 core/,严禁引入 UI 库或 .vue。NodeView 一律用原生 DOM
+ * (Tiptap 扩展本身的 addNodeView 用 document.createElement 是框架无关的正常能力,
+ * 不算「依赖具体 UI 库」)。
+ */
+/** 图片对齐方式 */
+export type ImageAlign = 'left' | 'center' | 'right';
+/** 图片尺寸预设(相对编辑器内容区宽度的比例;'original' 清除宽度回归自然尺寸) */
+export type ImageSizePreset = 'small' | 'medium' | 'large' | 'original';
+/**
+ * 扩展后的 Image。
+ *
+ * 链式顺序:extend(改 schema/命令) → configure(设 options)。
+ * extend 必须在 configure 之前,否则 configure 的 options 不会被 extend 后的
+ * 扩展读到。
+ */
+export declare const ImageExtended: import('@tiptap/core').Node<import('@tiptap/extension-image').ImageOptions, any>;
+export type { Extensions };
+//# sourceMappingURL=image.d.ts.map

package/dist/extensions/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/extensions/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9C;;;;;;;;;;;;;GAaG;AAEH,aAAa;AACb,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEpD,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAA;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,kFAsDxB,CAAA;AAGF,YAAY,EAAE,UAAU,EAAE,CAAA"}

package/dist/extensions/imageNodeView.d.ts

@@ -0,0 +1,10 @@
+import { NodeViewProps } from '@tiptap/core';
+import { NodeView as PMNodeView } from '@tiptap/pm/view';
+/**
+ * 创建图片 NodeView。
+ *
+ * @param props Tiptap 注入的 NodeViewProps(node/getPos/HTMLAttributes/editor)
+ * @param extOptions 扩展自身的 options(HTMLAttributes),用于合并到 img 上
+ */
+export declare function createImageNodeView(props: NodeViewProps, extHTMLAttributes: Record<string, unknown>): PMNodeView;
+//# sourceMappingURL=imageNodeView.d.ts.map

package/dist/extensions/imageNodeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageNodeView.d.ts","sourceRoot":"","sources":["../../src/extensions/imageNodeView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAGlG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,UAAU,CAkKZ"}

package/dist/extensions.d.ts

@@ -0,0 +1,30 @@
+import { Extensions } from '@tiptap/core';
+export type { Extensions } from '@tiptap/core';
+/**
+ * 默认扩展包。
+ *
+ * Tiptap v3 的 StarterKit 已经非常完整,自带:
+ *   Document, Paragraph, Text, History(undo/redo),
+ *   Bold, Italic, Strike, Underline, Code,
+ *   Heading(1-6), Blockquote, CodeBlock, HorizontalRule, HardBreak,
+ *   BulletList, OrderedList, ListItem(来自 @tiptap/extension-list),
+ *   Link, Dropcursor, TrailingNode。
+ *
+ * 这里额外补 StarterKit 不含的能力:
+ *   1. Placeholder —— 空内容占位
+ *   2. CharacterCount —— 字数统计
+ *   3. Image —— 图片插入(配合上传)
+ *   4. TableKit —— 表格(Table/Row/Cell/Header 一站式,v3 合并包)
+ *   5. TextStyle + Color —— 文字颜色(Color 依赖 TextStyle 提供的 mark)
+ *   6. Highlight —— 文字背景高亮(multicolor 支持多色)
+ *   7. TaskList + TaskItem —— 任务列表(checkbox),来自 @tiptap/extension-list
+ *      (v3 中 TaskList/TaskItem 都在 extension-list,不是独立的 task-list 包)
+ *   8. Markdown —— 官方 @tiptap/markdown,提供导入/导出 MD 能力。
+ *      无对应 MD 语法的样式(颜色/高亮/对齐)在导出时会被丢弃——这是
+ *      Markdown 格式本身的局限,非本组件能力缺失。
+ *
+ * StarterKit 的 Link 默认新窗口打开、autolink,满足大多数 CMS 场景。
+ * 返回类型用 v3 的 Extensions(同时接受 Extension 和 Node),因为 Image 是 Node。
+ */
+export declare function createDefaultExtensions(placeholder?: string): Extensions;
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAoCxE"}

package/dist/handleImageUpload.d.ts

@@ -0,0 +1,40 @@
+import { Editor } from '@tiptap/core';
+import { UploadImage } from './types';
+/**
+ * 判断是否为图片文件(基于 MIME 类型,不依赖文件名扩展)。
+ */
+export declare function isImageFile(file: File): boolean;
+/**
+ * 同步判断文件列表中是否含图片文件。
+ *
+ * 用途:paste/drop 事件处理器需要在**同步阶段**决定是否 preventDefault,
+ * 否则浏览器会在异步上传完成前执行默认行为(如把图片当链接打开)。
+ * handleImageFiles 是 async 不能用于这个判断,故抽出此同步谓词。
+ */
+export declare function hasImageFiles(files: File[] | FileList | null | undefined): boolean;
+/**
+ * 单张图片上传失败的回调契约。
+ *
+ * 粘贴/拖拽批量上传时,handleImageFiles 默认对单张失败静默跳过(不中断其余)。
+ * adapter 若希望给用户提示,传入此回调;Core 决定「哪张失败了」,adapter 决定
+ * 「用什么 UI 显示」(与 NotifyFn 的职责划分一致)。
+ */
+export type ImageUploadErrorFn = (file: File, error: unknown) => void;
+/**
+ * 批量处理粘贴/拖拽进来的图片:
+ * - 过滤出图片文件
+ * - 逐个调用 uploadImage 拿到 url
+ * - 调用 commands 插入文档
+ *
+ * 返回 true 表示"已消费这些文件"(阻止浏览器默认行为,如打开图片)。
+ *
+ * 设计说明:
+ * - 这里只做"图片上传",非图片文件(如 pdf/doc)交还给浏览器默认行为,
+ *   符合 MVP 范围(文件附件是第二阶段)。
+ * - 上传失败的单张图片跳过,不阻塞其余图片。
+ *   onError 可选:传入则在单张失败时回调(供 adapter 提示用户),不传则静默。
+ *   之前的版本是纯静默(空 catch),粘贴/拖拽失败时用户无感知——这是已知短板,
+ *   现通过 onError 暴露给调用方,保持向后兼容(第 4 参可选)。
+ */
+export declare function handleImageFiles(files: File[] | FileList | null | undefined, upload: UploadImage | undefined, editor: Editor, onError?: ImageUploadErrorFn): Promise<boolean>;
+//# sourceMappingURL=handleImageUpload.d.ts.map

package/dist/handleImageUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleImageUpload.d.ts","sourceRoot":"","sources":["../src/handleImageUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAGT;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;AAErE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,EAC3C,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAuBlB"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { useProEditor } from './useProEditor';
+export { createDefaultExtensions } from './extensions';
+export { ImageExtended } from './extensions/image';
+export type { ImageAlign, ImageSizePreset } from './extensions/image';
+export { handleImageFiles, hasImageFiles, isImageFile, } from './handleImageUpload';
+export type { ImageUploadErrorFn } from './handleImageUpload';
+export { MarkdownExtension, getMarkdown, importMarkdown, } from './markdown';
+export type { ProEditorOptions, ProEditorContext, ProEditorCommands, OutputFormat, UploadImage, NotifyType, NotifyFn, } from './types';
+export type { Editor } from '@tiptap/vue-3';
+export type { Extension, Extensions } from '@tiptap/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,GACT,MAAM,SAAS,CAAA;AAIhB,YAAY,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,647 @@
+import { computed as j, ref as K, watch as F, onBeforeUnmount as it } from "vue";
+import { useEditor as st } from "@tiptap/vue-3";
+import { mergeAttributes as at, ResizableNodeView as ct, isNodeSelection as lt } from "@tiptap/core";
+import { TableMap as ut, CellSelection as _, moveTableColumn as dt, moveTableRow as ft } from "@tiptap/pm/tables";
+import gt from "@tiptap/starter-kit";
+import mt from "@tiptap/extension-character-count";
+import pt from "@tiptap/extension-placeholder";
+import { TableKit as ht } from "@tiptap/extension-table";
+import wt from "@tiptap/extension-image";
+import { TextStyle as vt } from "@tiptap/extension-text-style";
+import { Color as bt } from "@tiptap/extension-color";
+import { Highlight as yt } from "@tiptap/extension-highlight";
+import { TextAlign as Ct } from "@tiptap/extension-text-align";
+import { TaskList as At, TaskItem as kt } from "@tiptap/extension-list";
+import { Markdown as St } from "@tiptap/markdown";
+import { Markdown as Qt } from "@tiptap/markdown";
+function Mt(i, l) {
+  const { node: c, getPos: m, HTMLAttributes: I, editor: p } = i, h = document.createElement("div");
+  h.className = "tvp-img-node";
+  const x = c.attrs.align || "center";
+  x !== "center" && h.setAttribute("data-align", x);
+  const g = document.createElement("img");
+  g.draggable = !1;
+  const P = at(l, I);
+  for (const [s, d] of Object.entries(P))
+    d != null && (s === "width" || s === "height" || s === "align" || s === "caption" || g.setAttribute(s, String(d)));
+  P.src != null && (g.src = String(P.src));
+  const a = new ct({
+    element: g,
+    editor: p,
+    node: c,
+    getPos: m,
+    onResize: (s, d) => {
+      g.style.width = `${s}px`, g.style.height = `${d}px`;
+    },
+    onCommit: (s, d) => {
+      const k = m();
+      k !== void 0 && p.chain().setNodeSelection(k).updateAttributes("image", { width: s, height: d }).run();
+    },
+    onUpdate: (s) => s.type === c.type,
+    options: {
+      directions: ["top-left", "top-right", "bottom-left", "bottom-right"],
+      min: { width: 60, height: 60 },
+      preserveAspectRatio: !0
+    }
+  });
+  a.dom.style.visibility = "hidden", a.dom.style.pointerEvents = "none";
+  const O = () => {
+    a.dom.style.visibility = "", a.dom.style.pointerEvents = "";
+    const s = p.view;
+    s.dispatch(s.state.tr.setMeta("proImageBubbleMenu", "updatePosition"));
+  };
+  g.addEventListener("load", O, { once: !0 }), g.addEventListener("error", O, { once: !0 }), h.appendChild(a.dom);
+  const f = document.createElement("input");
+  f.className = "tvp-img-caption", f.type = "text", f.placeholder = "添加题注";
+  const R = c.attrs.caption || "";
+  f.value = R, R || f.classList.add("tvp-img-caption-empty");
+  const H = () => {
+    f.readOnly = !p.isEditable;
+  };
+  H();
+  const $ = () => H();
+  p.on("update", $);
+  const o = () => {
+    if (!p.isEditable) return;
+    const s = m();
+    if (s === void 0) return;
+    const d = f.value;
+    f.classList.toggle("tvp-img-caption-empty", !d), p.chain().setNodeSelection(s).updateAttributes("image", { caption: d }).run();
+  };
+  f.addEventListener("input", o);
+  const L = (s) => {
+    s.stopPropagation();
+  };
+  return f.addEventListener("keydown", L), h.appendChild(f), {
+    dom: h,
+    contentDOM: void 0,
+    // atom 节点无嵌套可编辑内容
+    update(s) {
+      if (s.type !== c.type) return !1;
+      const d = s.attrs, k = d.align || "center";
+      k !== "center" ? h.setAttribute("data-align", k) : h.removeAttribute("data-align"), H();
+      const S = d.caption || "";
+      S !== f.value && (f.value = S, f.classList.toggle("tvp-img-caption-empty", !S));
+      const T = d.src;
+      return T && T !== g.getAttribute("src") && (g.src = T), d.width != null ? g.style.width = `${d.width}px` : g.style.width = "", d.height != null ? g.style.height = `${d.height}px` : g.style.height = "", a.update(s, [], void 0);
+    },
+    destroy() {
+      p.off("update", $), f.removeEventListener("input", o), f.removeEventListener("keydown", L), a.destroy();
+    },
+    // 题注 input / 手柄的 DOM 变化不应被 ProseMirror 视作文档变更
+    ignoreMutation: () => !0,
+    // 题注 input 内的事件不应被 ProseMirror 编辑视图接管
+    stopEvent(s) {
+      const d = s.target;
+      return !!d && (d === f || f.contains(d));
+    }
+  };
+}
+const Lt = wt.extend({
+  addAttributes() {
+    var i;
+    return {
+      ...(i = this.parent) == null ? void 0 : i.call(this),
+      /**
+       * 对齐:data-align 属性。默认 center(与飞书默认居中一致)。
+       * 渲染层(CSS)根据该属性控制图片在内容区的水平位置。
+       */
+      align: {
+        default: "center",
+        parseHTML: (l) => l.getAttribute("data-align") || "center",
+        renderHTML: (l) => {
+          const c = l.align;
+          return c && c !== "center" ? { "data-align": c } : {};
+        }
+      },
+      /**
+       * 题注:data-caption 属性。空串表示无题注。
+       * 渲染层(NodeView)把它显示为图片下方的可编辑输入框。
+       */
+      caption: {
+        default: "",
+        parseHTML: (l) => l.getAttribute("data-caption") || "",
+        renderHTML: (l) => {
+          const c = l.caption;
+          return c ? { "data-caption": c } : {};
+        }
+      }
+    };
+  },
+  /**
+   * 自定义 NodeView:复用官方 ResizableNodeView(四角手柄) + 追加题注输入框。
+   * 完全原生 DOM 实现(core 无 UI 依赖),逻辑见 imageNodeView.ts。
+   * 仅在客户端(document 存在)且有 resize 配置时启用;否则回退官方默认。
+   */
+  addNodeView() {
+    return ({ node: i, getPos: l, HTMLAttributes: c, editor: m }) => Mt(
+      { node: i, getPos: l, HTMLAttributes: c, editor: m },
+      this.options.HTMLAttributes
+    );
+  }
+}).configure({
+  inline: !1,
+  allowBase64: !1,
+  // 强制走上传,避免 base64 撑大文档
+  resize: {
+    enabled: !0,
+    // v3 的方向键值用连字符格式(见 @tiptap/core 的 ResizableNodeViewDirection)
+    directions: ["top-left", "top-right", "bottom-left", "bottom-right"],
+    minWidth: 60,
+    minHeight: 60,
+    alwaysPreserveAspectRatio: !0
+    // 锁比例,飞书行为
+  }
+});
+function Tt(i) {
+  return [
+    gt.configure({
+      heading: { levels: [1, 2, 3, 4, 5, 6] },
+      link: {
+        openOnClick: !1,
+        autolink: !0,
+        defaultProtocol: "https",
+        HTMLAttributes: {
+          target: "_blank",
+          rel: "noopener noreferrer nofollow"
+        }
+      }
+    }),
+    pt.configure({
+      placeholder: i ?? "请输入内容..."
+    }),
+    mt,
+    Lt,
+    // ImageExtended:在官方基础上开启 resize + 预留 align/caption 属性(对标飞书)
+    ht.configure({
+      table: { resizable: !0 }
+    }),
+    // 文字颜色:Color 依赖 TextStyle,两者成对引入
+    vt,
+    bt,
+    // 背景高亮:multicolor 允许多种颜色共存
+    yt.configure({ multicolor: !0 }),
+    // 文本对齐:作用于段落和标题
+    Ct.configure({ types: ["heading", "paragraph"] }),
+    // 任务列表:TaskList 需要 TaskItem 提供 checkbox 行为
+    At,
+    kt.configure({ nested: !0 }),
+    // Markdown 导入/导出:官方扩展,自动接管 setContent(contentType:'markdown')
+    // 并提供 editor.storage.markdown.manager 用于序列化
+    St
+  ];
+}
+function q(i) {
+  var c;
+  return (c = i.storage.markdown) == null ? void 0 : c.manager;
+}
+function It(i) {
+  const l = q(i);
+  return l ? l.serialize(i.getJSON()) : "";
+}
+function Rt(i, l) {
+  const c = q(i);
+  if (c)
+    try {
+      const m = c.parse(l);
+      i.commands.setContent(m);
+      return;
+    } catch {
+    }
+  i.commands.setContent(l);
+}
+function jt(i) {
+  const {
+    content: l,
+    output: c = "html",
+    extensions: m,
+    placeholder: I,
+    uploadImage: p,
+    editable: h = !0,
+    editorProps: x,
+    notify: g
+  } = i, P = m ?? Tt(I), a = st({
+    extensions: P,
+    content: typeof l == "string" ? l : JSON.stringify(l),
+    editable: h,
+    editorProps: x ?? {},
+    onUpdate: ({ editor: t }) => {
+      R = !0, $(t), H(t);
+    }
+  }), O = j(() => !!a.value), f = K({ characters: 0, words: 0 });
+  let R = !1;
+  function H(t) {
+    var r, u;
+    const n = t.storage.characterCount;
+    n && (f.value = {
+      characters: ((r = n.characters) == null ? void 0 : r.call(n)) ?? 0,
+      words: ((u = n.words) == null ? void 0 : u.call(n)) ?? 0
+    });
+  }
+  F(
+    () => a.value,
+    (t) => {
+      t && H(t);
+    },
+    { immediate: !0 }
+  );
+  function $(t) {
+    const e = c === "html" ? t.getHTML() : t.getJSON();
+    i.content = e;
+  }
+  F(
+    () => i.content,
+    (t) => {
+      if (R) {
+        R = !1;
+        return;
+      }
+      const e = a.value;
+      if (!e) return;
+      const n = c === "json" ? JSON.stringify(t ?? null) : t, r = c === "json" ? JSON.stringify(e.getJSON()) : e.getHTML();
+      n !== r && e.commands.setContent(t ?? "", { emitUpdate: !1 });
+    }
+  );
+  function o() {
+    return a.value;
+  }
+  function L() {
+    var W;
+    const t = a.value;
+    if (!t) return null;
+    const e = t.state.selection, r = ((W = e.$anchorCell) == null ? void 0 : W.pos) ?? e.$from.pos, u = (B) => B.type.name === "tableCell" || B.type.name === "tableHeader";
+    function v(B) {
+      const D = t.state.doc.resolve(B);
+      let V = -1, z = -1;
+      for (let N = D.depth; N > 0; N--) {
+        const rt = D.node(N).type.name;
+        V < 0 && u(D.node(N)) && (V = N), z < 0 && rt === "table" && (z = N);
+      }
+      return { $pos: D, cellDepth: V, tableDepth: z };
+    }
+    let { $pos: w, cellDepth: C, tableDepth: M } = v(r);
+    if (C < 0 && r > 0 && ({ $pos: w, cellDepth: C, tableDepth: M } = v(r - 1)), C < 0 || M < 0) return null;
+    const b = w.node(M), A = w.start(M), y = ut.get(b), E = w.before(C) - A, J = y.findCell(E);
+    return {
+      map: y,
+      tableStart: A,
+      rowCount: y.height,
+      colCount: y.width,
+      row: J.top,
+      col: J.left,
+      // cell 节点的 doc 绝对 pos(moveTableRow 的 pos 参数需要)
+      cellDocPos: A + E
+    };
+  }
+  function s(t) {
+    const e = L();
+    if (!e) return;
+    const n = a.value, r = e.row + t;
+    r < 0 || r >= e.rowCount || ft({ from: e.row, to: r, pos: e.cellDocPos })(
+      n.state,
+      (u) => n.view.dispatch(u)
+    );
+  }
+  function d(t) {
+    const e = L();
+    if (!e) return;
+    const n = a.value, r = e.col + t;
+    r < 0 || r >= e.colCount || dt({ from: e.col, to: r, pos: e.cellDocPos })(
+      n.state,
+      (u) => n.view.dispatch(u)
+    );
+  }
+  function k(t) {
+    const e = L();
+    if (!e) return;
+    const n = a.value, { map: r, tableStart: u, row: v, col: w } = e, C = t === "row" ? r.positionAt(v, 0, n.state.doc.nodeAt(u - 1)) : r.positionAt(0, w, n.state.doc.nodeAt(u - 1)), M = t === "row" ? r.positionAt(v, r.width - 1, n.state.doc.nodeAt(u - 1)) : r.positionAt(r.height - 1, w, n.state.doc.nodeAt(u - 1)), b = n.state.doc.resolve(u + C), A = n.state.doc.resolve(u + M), y = t === "row" ? _.rowSelection(b, A) : _.colSelection(b, A);
+    n.view.dispatch(n.state.tr.setSelection(y));
+  }
+  function S(t) {
+    const e = t.state.selection;
+    return lt(e) && e.node.type.name === "image";
+  }
+  const T = g ?? (() => {
+  }), Q = {
+    undo: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().undo().run();
+    },
+    redo: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().redo().run();
+    },
+    bold: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleBold().run();
+    },
+    italic: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleItalic().run();
+    },
+    strike: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleStrike().run();
+    },
+    toggleHeading: (t) => {
+      const e = o();
+      e && (t === 0 ? e.chain().focus().setParagraph().run() : e.chain().focus().toggleHeading({ level: t }).run());
+    },
+    bulletList: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleBulletList().run();
+    },
+    orderedList: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleOrderedList().run();
+    },
+    blockquote: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleBlockquote().run();
+    },
+    codeBlock: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleCodeBlock().run();
+    },
+    setLink: (t, e) => {
+      const n = o();
+      if (!n) return;
+      const r = e == null ? void 0 : e.range, u = (e == null ? void 0 : e.target) ?? "_blank";
+      if (!t) {
+        const w = n.chain().focus();
+        r && w.setTextSelection(r), w.extendMarkRange("link").unsetLink().scrollIntoView().run();
+        return;
+      }
+      const v = n.chain().focus();
+      r && v.setTextSelection(r), v.extendMarkRange("link").setLink({ href: t, target: u }).scrollIntoView().run();
+    },
+    /**
+     * 在指定位置插入/替换一段带链接的文本。
+     *
+     * 用显式 from/to + insertContentAt,不依赖 .focus() 恢复 DOM selection——
+     * 因为工具栏/弹窗确认时编辑器已失焦,ProseMirror 的 selection 可能已被
+     * 扰乱,chain 内部的 focus 不保证回到正确位置。直接按保存的绝对位置写入
+     * 最稳妥。
+     *
+     * - 光标(空 range)处 → 在该位置插入新文本
+     * - 有 range → 用 text 替换该 range 内容并套链接
+     * text 为空时回退用 href 作显示文字。
+     * 末尾 scrollIntoView,确保插入后视口滚到结果处(尤其光标不在编辑器内时)。
+     */
+    insertLinkText: (t, e, n) => {
+      const r = o();
+      if (!r || !t) return;
+      const u = (n == null ? void 0 : n.target) ?? "_blank", v = (e == null ? void 0 : e.trim()) || t, w = (n == null ? void 0 : n.range) ?? { from: r.state.selection.from, to: r.state.selection.to };
+      r.chain().insertContentAt(w, {
+        type: "text",
+        text: v,
+        marks: [{ type: "link", attrs: { href: t, target: u } }]
+      }).scrollIntoView().run();
+    },
+    /**
+     * 确保编辑器有可用光标位置。
+     *
+     * 场景:用户从未点进编辑器,直接点工具栏按钮插入内容。此时 ProseMirror
+     * 的 selection 停在文档开头,插入到开头用户看不到 → 误以为「没插入」。
+     * 此命令把光标移到文档末尾并聚焦,后续插入自然落在用户可视区。
+     */
+    ensureFocusAtEnd: () => {
+      const t = o();
+      if (!t) return;
+      const e = t.state.doc.content.size;
+      t.chain().focus().setTextSelection(e).scrollIntoView().run();
+    },
+    setImage: (t, e) => {
+      var n;
+      return (n = o()) == null ? void 0 : n.chain().focus().setImage({ src: t, alt: e }).scrollIntoView().run();
+    },
+    uploadAndInsertImage: async (t) => {
+      if (!p) return;
+      const e = o();
+      if (e)
+        try {
+          const n = await p(t);
+          n ? e.chain().focus().setImage({ src: n }).scrollIntoView().run() : T("图片上传失败", "error");
+        } catch {
+          T("图片上传失败", "error");
+        }
+    },
+    /**
+     * 图片对齐/尺寸/题注/删除 —— 仅在当前是图片 NodeSelection 时生效。
+     *
+     * 这些命令不依赖工具条是否打开:NodeSelection 是 ProseMirror 的「整节点选中」
+     * 状态(点击图片即进入),此时 updateAttributes 会作用到该图片节点。
+     * 非图片选中态调用时静默 no-op,避免抛错干扰调用方。
+     */
+    setImageAlign: (t) => {
+      const e = o();
+      e && S(e) && e.chain().focus().updateAttributes("image", { align: t }).run();
+    },
+    setImageSize: (t) => {
+      const e = o();
+      if (!e || !S(e)) return;
+      if (t === "original") {
+        e.chain().focus().updateAttributes("image", { width: null, height: null }).run();
+        return;
+      }
+      const n = t === "small" ? 0.25 : t === "medium" ? 0.5 : 0.75, r = e.view.dom.clientWidth || 0;
+      r <= 0 || e.chain().focus().updateAttributes("image", { width: Math.round(r * n) }).run();
+    },
+    setImageCaption: (t) => {
+      const e = o();
+      !e || !S(e) || e.chain().focus().updateAttributes("image", { caption: t }).run();
+    },
+    removeImage: () => {
+      const t = o();
+      !t || !S(t) || t.chain().focus().deleteSelection().run();
+    },
+    insertTable: (t = 3, e = 3) => {
+      var n;
+      return (n = o()) == null ? void 0 : n.chain().focus().insertTable({ rows: t, cols: e, withHeaderRow: !0 }).scrollIntoView().run();
+    },
+    // ---- 表格结构操作 ----
+    // Tiptap TableKit 全部内置这些命令,这里只做转发。命令作用在当前选区(光标所在单元格),
+    // adapter 的工具栏用 isActive('table') 判定后才显示对应按钮,所以无需在 core 判断场景。
+    addRowBefore: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().addRowBefore().run();
+    },
+    addRowAfter: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().addRowAfter().run();
+    },
+    deleteRow: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().deleteRow().run();
+    },
+    addColumnBefore: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().addColumnBefore().run();
+    },
+    addColumnAfter: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().addColumnAfter().run();
+    },
+    deleteColumn: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().deleteColumn().run();
+    },
+    mergeCells: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().mergeCells().run();
+    },
+    splitCell: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().splitCell().run();
+    },
+    toggleHeaderRow: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleHeaderRow().run();
+    },
+    toggleHeaderColumn: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleHeaderColumn().run();
+    },
+    deleteTable: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().deleteTable().run();
+    },
+    // ---- 行/列移动(飞书式抓手菜单)----
+    // prosemirror-tables 的 moveTableRow/moveTableColumn 接收 {from, to, pos}:
+    //   from/to 是行/列索引,pos 是任意 cell 的 doc 绝对 pos(用于定位表格)。
+    // 这里从当前选区解析行/列号,默认 moveTableRow 会自动选中移动后的行(select:true 默认)。
+    moveRowUp: () => s(-1),
+    moveRowDown: () => s(1),
+    moveColumnLeft: () => d(-1),
+    moveColumnRight: () => d(1),
+    // ---- 选中整行/整列(飞书式抓手点击)----
+    selectRow: () => k("row"),
+    selectColumn: () => k("col"),
+    hr: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().setHorizontalRule().run();
+    },
+    clearNodes: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().clearNodes().run();
+    },
+    setColor: (t) => {
+      var e;
+      return (e = o()) == null ? void 0 : e.chain().focus().setColor(t).run();
+    },
+    toggleHighlight: (t) => {
+      var e;
+      return (e = o()) == null ? void 0 : e.chain().focus().toggleHighlight({ color: t }).run();
+    },
+    align: (t) => {
+      var e;
+      return (e = o()) == null ? void 0 : e.chain().focus().setTextAlign(t).run();
+    },
+    underline: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleUnderline().run();
+    },
+    clearFormat: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().clearNodes().unsetAllMarks().run();
+    },
+    taskList: () => {
+      var t;
+      return (t = o()) == null ? void 0 : t.chain().focus().toggleTaskList().run();
+    }
+  };
+  function X(t, e) {
+    const n = a.value;
+    return n ? typeof t == "string" ? n.isActive(t, e) : n.isActive(t) : !1;
+  }
+  const U = K(0);
+  F(
+    a,
+    (t) => {
+      if (!t) return;
+      const e = () => U.value++;
+      t.on("transaction", e), t.on("selectionUpdate", e);
+    },
+    { immediate: !0 }
+  );
+  const Y = j(() => {
+    U.value;
+    const t = a.value;
+    if (!t) return { inTable: !1, canMerge: !1, canSplit: !1, tablePos: null, rowCount: 0, colCount: 0 };
+    const e = t.isActive("table");
+    if (!e) return { inTable: !1, canMerge: !1, canSplit: !1, tablePos: null, rowCount: 0, colCount: 0 };
+    const n = t.state.selection, r = (A) => {
+      for (let y = A.depth; y > 0; y--) {
+        const E = A.node(y);
+        if (E.type.name === "tableCell" || E.type.name === "tableHeader")
+          return E;
+      }
+      return null;
+    }, u = r(n.$from), v = r(n.$to), w = !!u && !!v && u !== v, C = (u == null ? void 0 : u.attrs) ?? { colspan: 1, rowspan: 1 }, M = (C.colspan ?? 1) > 1 || (C.rowspan ?? 1) > 1, b = L();
+    return {
+      inTable: e,
+      canMerge: w,
+      canSplit: M,
+      tablePos: b ? b.tableStart - 1 : null,
+      // tableStart 是内容区 pos,表格节点 pos = start - 1
+      rowCount: (b == null ? void 0 : b.rowCount) ?? 0,
+      colCount: (b == null ? void 0 : b.colCount) ?? 0
+    };
+  }), Z = () => {
+    var t;
+    return ((t = a.value) == null ? void 0 : t.getHTML()) ?? "";
+  }, tt = () => {
+    var t;
+    return ((t = a.value) == null ? void 0 : t.getJSON()) ?? {};
+  }, et = () => a.value ? It(a.value) : "", nt = (t) => {
+    a.value && Rt(a.value, t);
+  }, ot = (t) => {
+    var e;
+    return (e = a.value) == null ? void 0 : e.setEditable(t);
+  };
+  return it(() => {
+  }), {
+    editor: a,
+    loaded: O,
+    isActive: X,
+    commands: Q,
+    getHTML: Z,
+    getJSON: tt,
+    getMarkdown: et,
+    importMarkdown: nt,
+    wordCount: f,
+    setEditable: ot,
+    tableState: Y,
+    notify: T
+  };
+}
+function G(i) {
+  return i.type.startsWith("image/");
+}
+function Kt(i) {
+  return !i || i.length === 0 ? !1 : Array.from(i).some(G);
+}
+async function _t(i, l, c, m) {
+  if (!i || i.length === 0 || !l) return !1;
+  const I = Array.from(i).filter(G);
+  if (I.length === 0) return !1;
+  for (const p of I)
+    try {
+      const h = await l(p);
+      h ? c.chain().focus().setImage({ src: h }).run() : m && m(p, new Error("upload returned null"));
+    } catch (h) {
+      m == null || m(p, h);
+    }
+  return !0;
+}
+export {
+  Lt as ImageExtended,
+  Qt as MarkdownExtension,
+  Tt as createDefaultExtensions,
+  It as getMarkdown,
+  _t as handleImageFiles,
+  Kt as hasImageFiles,
+  Rt as importMarkdown,
+  G as isImageFile,
+  jt as useProEditor
+};

package/dist/index.umd.cjs

@@ -0,0 +1 @@
+(function(a,C){typeof exports=="object"&&typeof module<"u"?C(exports,require("vue"),require("@tiptap/vue-3"),require("@tiptap/core"),require("@tiptap/pm/tables"),require("@tiptap/starter-kit"),require("@tiptap/extension-character-count"),require("@tiptap/extension-placeholder"),require("@tiptap/extension-table"),require("@tiptap/extension-image"),require("@tiptap/extension-text-style"),require("@tiptap/extension-color"),require("@tiptap/extension-highlight"),require("@tiptap/extension-text-align"),require("@tiptap/extension-list"),require("@tiptap/markdown")):typeof define=="function"&&define.amd?define(["exports","vue","@tiptap/vue-3","@tiptap/core","@tiptap/pm/tables","@tiptap/starter-kit","@tiptap/extension-character-count","@tiptap/extension-placeholder","@tiptap/extension-table","@tiptap/extension-image","@tiptap/extension-text-style","@tiptap/extension-color","@tiptap/extension-highlight","@tiptap/extension-text-align","@tiptap/extension-list","@tiptap/markdown"],C):(a=typeof globalThis<"u"?globalThis:a||self,C(a.TiptapVueProCore={},a.vue,a.vue3,a.core,a.tables,a.StarterKit,a.CharacterCount,a.Placeholder,a.extensionTable,a.Image,a.extensionTextStyle,a.extensionColor,a.extensionHighlight,a.extensionTextAlign,a.extensionList,a.markdown))})(this,function(a,C,ne,z,q,oe,ie,re,ae,se,ce,le,ue,de,W,K){"use strict";function pe(r,u){const{node:l,getPos:m,HTMLAttributes:H,editor:h}=r,w=document.createElement("div");w.className="tvp-img-node";const D=l.attrs.align||"center";D!=="center"&&w.setAttribute("data-align",D);const g=document.createElement("img");g.draggable=!1;const O=z.mergeAttributes(u,H);for(const[s,p]of Object.entries(O))p!=null&&(s==="width"||s==="height"||s==="align"||s==="caption"||g.setAttribute(s,String(p)));O.src!=null&&(g.src=String(O.src));const c=new z.ResizableNodeView({element:g,editor:h,node:l,getPos:m,onResize:(s,p)=>{g.style.width=`${s}px`,g.style.height=`${p}px`},onCommit:(s,p)=>{const x=m();x!==void 0&&h.chain().setNodeSelection(x).updateAttributes("image",{width:s,height:p}).run()},onUpdate:s=>s.type===l.type,options:{directions:["top-left","top-right","bottom-left","bottom-right"],min:{width:60,height:60},preserveAspectRatio:!0}});c.dom.style.visibility="hidden",c.dom.style.pointerEvents="none";const $=()=>{c.dom.style.visibility="",c.dom.style.pointerEvents="";const s=h.view;s.dispatch(s.state.tr.setMeta("proImageBubbleMenu","updatePosition"))};g.addEventListener("load",$,{once:!0}),g.addEventListener("error",$,{once:!0}),w.appendChild(c.dom);const f=document.createElement("input");f.className="tvp-img-caption",f.type="text",f.placeholder="添加题注";const R=l.attrs.caption||"";f.value=R,R||f.classList.add("tvp-img-caption-empty");const E=()=>{f.readOnly=!h.isEditable};E();const B=()=>E();h.on("update",B);const o=()=>{if(!h.isEditable)return;const s=m();if(s===void 0)return;const p=f.value;f.classList.toggle("tvp-img-caption-empty",!p),h.chain().setNodeSelection(s).updateAttributes("image",{caption:p}).run()};f.addEventListener("input",o);const I=s=>{s.stopPropagation()};return f.addEventListener("keydown",I),w.appendChild(f),{dom:w,contentDOM:void 0,update(s){if(s.type!==l.type)return!1;const p=s.attrs,x=p.align||"center";x!=="center"?w.setAttribute("data-align",x):w.removeAttribute("data-align"),E();const T=p.caption||"";T!==f.value&&(f.value=T,f.classList.toggle("tvp-img-caption-empty",!T));const L=p.src;return L&&L!==g.getAttribute("src")&&(g.src=L),p.width!=null?g.style.width=`${p.width}px`:g.style.width="",p.height!=null?g.style.height=`${p.height}px`:g.style.height="",c.update(s,[],void 0)},destroy(){h.off("update",B),f.removeEventListener("input",o),f.removeEventListener("keydown",I),c.destroy()},ignoreMutation:()=>!0,stopEvent(s){const p=s.target;return!!p&&(p===f||f.contains(p))}}}const _=se.extend({addAttributes(){var r;return{...(r=this.parent)==null?void 0:r.call(this),align:{default:"center",parseHTML:u=>u.getAttribute("data-align")||"center",renderHTML:u=>{const l=u.align;return l&&l!=="center"?{"data-align":l}:{}}},caption:{default:"",parseHTML:u=>u.getAttribute("data-caption")||"",renderHTML:u=>{const l=u.caption;return l?{"data-caption":l}:{}}}}},addNodeView(){return({node:r,getPos:u,HTMLAttributes:l,editor:m})=>pe({node:r,getPos:u,HTMLAttributes:l,editor:m},this.options.HTMLAttributes)}}).configure({inline:!1,allowBase64:!1,resize:{enabled:!0,directions:["top-left","top-right","bottom-left","bottom-right"],minWidth:60,minHeight:60,alwaysPreserveAspectRatio:!0}});function G(r){return[oe.configure({heading:{levels:[1,2,3,4,5,6]},link:{openOnClick:!1,autolink:!0,defaultProtocol:"https",HTMLAttributes:{target:"_blank",rel:"noopener noreferrer nofollow"}}}),re.configure({placeholder:r??"请输入内容..."}),ie,_,ae.TableKit.configure({table:{resizable:!0}}),ce.TextStyle,le.Color,ue.Highlight.configure({multicolor:!0}),de.TextAlign.configure({types:["heading","paragraph"]}),W.TaskList,W.TaskItem.configure({nested:!0}),K.Markdown]}function Q(r){var l;return(l=r.storage.markdown)==null?void 0:l.manager}function X(r){const u=Q(r);return u?u.serialize(r.getJSON()):""}function Y(r,u){const l=Q(r);if(l)try{const m=l.parse(u);r.commands.setContent(m);return}catch{}r.commands.setContent(u)}function fe(r){const{content:u,output:l="html",extensions:m,placeholder:H,uploadImage:h,editable:w=!0,editorProps:D,notify:g}=r,O=m??G(H),c=ne.useEditor({extensions:O,content:typeof u=="string"?u:JSON.stringify(u),editable:w,editorProps:D??{},onUpdate:({editor:e})=>{R=!0,B(e),E(e)}}),$=C.computed(()=>!!c.value),f=C.ref({characters:0,words:0});let R=!1;function E(e){var i,d;const n=e.storage.characterCount;n&&(f.value={characters:((i=n.characters)==null?void 0:i.call(n))??0,words:((d=n.words)==null?void 0:d.call(n))??0})}C.watch(()=>c.value,e=>{e&&E(e)},{immediate:!0});function B(e){const t=l==="html"?e.getHTML():e.getJSON();r.content=t}C.watch(()=>r.content,e=>{if(R){R=!1;return}const t=c.value;if(!t)return;const n=l==="json"?JSON.stringify(e??null):e,i=l==="json"?JSON.stringify(t.getJSON()):t.getHTML();n!==i&&t.commands.setContent(e??"",{emitUpdate:!1})});function o(){return c.value}function I(){var te;const e=c.value;if(!e)return null;const t=e.state.selection,i=((te=t.$anchorCell)==null?void 0:te.pos)??t.$from.pos,d=F=>F.type.name==="tableCell"||F.type.name==="tableHeader";function b(F){const V=e.state.doc.resolve(F);let J=-1,j=-1;for(let N=V.depth;N>0;N--){const Se=V.node(N).type.name;J<0&&d(V.node(N))&&(J=N),j<0&&Se==="table"&&(j=N)}return{$pos:V,cellDepth:J,tableDepth:j}}let{$pos:v,cellDepth:A,tableDepth:M}=b(i);if(A<0&&i>0&&({$pos:v,cellDepth:A,tableDepth:M}=b(i-1)),A<0||M<0)return null;const y=v.node(M),S=v.start(M),k=q.TableMap.get(y),P=v.before(A)-S,ee=k.findCell(P);return{map:k,tableStart:S,rowCount:k.height,colCount:k.width,row:ee.top,col:ee.left,cellDocPos:S+P}}function s(e){const t=I();if(!t)return;const n=c.value,i=t.row+e;i<0||i>=t.rowCount||q.moveTableRow({from:t.row,to:i,pos:t.cellDocPos})(n.state,d=>n.view.dispatch(d))}function p(e){const t=I();if(!t)return;const n=c.value,i=t.col+e;i<0||i>=t.colCount||q.moveTableColumn({from:t.col,to:i,pos:t.cellDocPos})(n.state,d=>n.view.dispatch(d))}function x(e){const t=I();if(!t)return;const n=c.value,{map:i,tableStart:d,row:b,col:v}=t,A=e==="row"?i.positionAt(b,0,n.state.doc.nodeAt(d-1)):i.positionAt(0,v,n.state.doc.nodeAt(d-1)),M=e==="row"?i.positionAt(b,i.width-1,n.state.doc.nodeAt(d-1)):i.positionAt(i.height-1,v,n.state.doc.nodeAt(d-1)),y=n.state.doc.resolve(d+A),S=n.state.doc.resolve(d+M),k=e==="row"?q.CellSelection.rowSelection(y,S):q.CellSelection.colSelection(y,S);n.view.dispatch(n.state.tr.setSelection(k))}function T(e){const t=e.state.selection;return z.isNodeSelection(t)&&t.node.type.name==="image"}const L=g??(()=>{}),he={undo:()=>{var e;return(e=o())==null?void 0:e.chain().focus().undo().run()},redo:()=>{var e;return(e=o())==null?void 0:e.chain().focus().redo().run()},bold:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleBold().run()},italic:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleItalic().run()},strike:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleStrike().run()},toggleHeading:e=>{const t=o();t&&(e===0?t.chain().focus().setParagraph().run():t.chain().focus().toggleHeading({level:e}).run())},bulletList:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleBulletList().run()},orderedList:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleOrderedList().run()},blockquote:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleBlockquote().run()},codeBlock:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleCodeBlock().run()},setLink:(e,t)=>{const n=o();if(!n)return;const i=t==null?void 0:t.range,d=(t==null?void 0:t.target)??"_blank";if(!e){const v=n.chain().focus();i&&v.setTextSelection(i),v.extendMarkRange("link").unsetLink().scrollIntoView().run();return}const b=n.chain().focus();i&&b.setTextSelection(i),b.extendMarkRange("link").setLink({href:e,target:d}).scrollIntoView().run()},insertLinkText:(e,t,n)=>{const i=o();if(!i||!e)return;const d=(n==null?void 0:n.target)??"_blank",b=(t==null?void 0:t.trim())||e,v=(n==null?void 0:n.range)??{from:i.state.selection.from,to:i.state.selection.to};i.chain().insertContentAt(v,{type:"text",text:b,marks:[{type:"link",attrs:{href:e,target:d}}]}).scrollIntoView().run()},ensureFocusAtEnd:()=>{const e=o();if(!e)return;const t=e.state.doc.content.size;e.chain().focus().setTextSelection(t).scrollIntoView().run()},setImage:(e,t)=>{var n;return(n=o())==null?void 0:n.chain().focus().setImage({src:e,alt:t}).scrollIntoView().run()},uploadAndInsertImage:async e=>{if(!h)return;const t=o();if(t)try{const n=await h(e);n?t.chain().focus().setImage({src:n}).scrollIntoView().run():L("图片上传失败","error")}catch{L("图片上传失败","error")}},setImageAlign:e=>{const t=o();t&&T(t)&&t.chain().focus().updateAttributes("image",{align:e}).run()},setImageSize:e=>{const t=o();if(!t||!T(t))return;if(e==="original"){t.chain().focus().updateAttributes("image",{width:null,height:null}).run();return}const n=e==="small"?.25:e==="medium"?.5:.75,i=t.view.dom.clientWidth||0;i<=0||t.chain().focus().updateAttributes("image",{width:Math.round(i*n)}).run()},setImageCaption:e=>{const t=o();!t||!T(t)||t.chain().focus().updateAttributes("image",{caption:e}).run()},removeImage:()=>{const e=o();!e||!T(e)||e.chain().focus().deleteSelection().run()},insertTable:(e=3,t=3)=>{var n;return(n=o())==null?void 0:n.chain().focus().insertTable({rows:e,cols:t,withHeaderRow:!0}).scrollIntoView().run()},addRowBefore:()=>{var e;return(e=o())==null?void 0:e.chain().focus().addRowBefore().run()},addRowAfter:()=>{var e;return(e=o())==null?void 0:e.chain().focus().addRowAfter().run()},deleteRow:()=>{var e;return(e=o())==null?void 0:e.chain().focus().deleteRow().run()},addColumnBefore:()=>{var e;return(e=o())==null?void 0:e.chain().focus().addColumnBefore().run()},addColumnAfter:()=>{var e;return(e=o())==null?void 0:e.chain().focus().addColumnAfter().run()},deleteColumn:()=>{var e;return(e=o())==null?void 0:e.chain().focus().deleteColumn().run()},mergeCells:()=>{var e;return(e=o())==null?void 0:e.chain().focus().mergeCells().run()},splitCell:()=>{var e;return(e=o())==null?void 0:e.chain().focus().splitCell().run()},toggleHeaderRow:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleHeaderRow().run()},toggleHeaderColumn:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleHeaderColumn().run()},deleteTable:()=>{var e;return(e=o())==null?void 0:e.chain().focus().deleteTable().run()},moveRowUp:()=>s(-1),moveRowDown:()=>s(1),moveColumnLeft:()=>p(-1),moveColumnRight:()=>p(1),selectRow:()=>x("row"),selectColumn:()=>x("col"),hr:()=>{var e;return(e=o())==null?void 0:e.chain().focus().setHorizontalRule().run()},clearNodes:()=>{var e;return(e=o())==null?void 0:e.chain().focus().clearNodes().run()},setColor:e=>{var t;return(t=o())==null?void 0:t.chain().focus().setColor(e).run()},toggleHighlight:e=>{var t;return(t=o())==null?void 0:t.chain().focus().toggleHighlight({color:e}).run()},align:e=>{var t;return(t=o())==null?void 0:t.chain().focus().setTextAlign(e).run()},underline:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleUnderline().run()},clearFormat:()=>{var e;return(e=o())==null?void 0:e.chain().focus().clearNodes().unsetAllMarks().run()},taskList:()=>{var e;return(e=o())==null?void 0:e.chain().focus().toggleTaskList().run()}};function we(e,t){const n=c.value;return n?typeof e=="string"?n.isActive(e,t):n.isActive(e):!1}const Z=C.ref(0);C.watch(c,e=>{if(!e)return;const t=()=>Z.value++;e.on("transaction",t),e.on("selectionUpdate",t)},{immediate:!0});const ve=C.computed(()=>{Z.value;const e=c.value;if(!e)return{inTable:!1,canMerge:!1,canSplit:!1,tablePos:null,rowCount:0,colCount:0};const t=e.isActive("table");if(!t)return{inTable:!1,canMerge:!1,canSplit:!1,tablePos:null,rowCount:0,colCount:0};const n=e.state.selection,i=S=>{for(let k=S.depth;k>0;k--){const P=S.node(k);if(P.type.name==="tableCell"||P.type.name==="tableHeader")return P}return null},d=i(n.$from),b=i(n.$to),v=!!d&&!!b&&d!==b,A=(d==null?void 0:d.attrs)??{colspan:1,rowspan:1},M=(A.colspan??1)>1||(A.rowspan??1)>1,y=I();return{inTable:t,canMerge:v,canSplit:M,tablePos:y?y.tableStart-1:null,rowCount:(y==null?void 0:y.rowCount)??0,colCount:(y==null?void 0:y.colCount)??0}}),be=()=>{var e;return((e=c.value)==null?void 0:e.getHTML())??""},ye=()=>{var e;return((e=c.value)==null?void 0:e.getJSON())??{}},Ce=()=>c.value?X(c.value):"",ke=e=>{c.value&&Y(c.value,e)},Ae=e=>{var t;return(t=c.value)==null?void 0:t.setEditable(e)};return C.onBeforeUnmount(()=>{}),{editor:c,loaded:$,isActive:we,commands:he,getHTML:be,getJSON:ye,getMarkdown:Ce,importMarkdown:ke,wordCount:f,setEditable:Ae,tableState:ve,notify:L}}function U(r){return r.type.startsWith("image/")}function ge(r){return!r||r.length===0?!1:Array.from(r).some(U)}async function me(r,u,l,m){if(!r||r.length===0||!u)return!1;const H=Array.from(r).filter(U);if(H.length===0)return!1;for(const h of H)try{const w=await u(h);w?l.chain().focus().setImage({src:w}).run():m&&m(h,new Error("upload returned null"))}catch(w){m==null||m(h,w)}return!0}Object.defineProperty(a,"MarkdownExtension",{enumerable:!0,get:()=>K.Markdown}),a.ImageExtended=_,a.createDefaultExtensions=G,a.getMarkdown=X,a.handleImageFiles=me,a.hasImageFiles=ge,a.importMarkdown=Y,a.isImageFile=U,a.useProEditor=fe,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})});

package/dist/markdown.d.ts

@@ -0,0 +1,29 @@
+import { Markdown, MarkdownManager } from '@tiptap/markdown';
+import { Editor } from '@tiptap/vue-3';
+/**
+ * Markdown 导入/导出能力(基于官方 @tiptap/markdown 扩展)。
+ *
+ * 设计说明:
+ * - 扩展会把 MarkdownManager 挂到 editor.storage.markdown.manager,
+ *   并给 editor 实例追加 getMarkdown() 方法。这里统一从 storage 取 manager,
+ *   避免对 editor 实例做 as any(扩展未在 Editor 类型上声明这两个成员)。
+ * - 官方扩展不支持「把无对应 MD 语法的样式降级为内联 HTML」,
+ *   因此颜色/高亮/对齐等富样式在导出时会丢失——这是第一档取舍:
+ *   覆盖标题/粗斜体/列表/任务/引用/代码块/表格/链接/图片等 MD 原生能力。
+ */
+export { Markdown as MarkdownExtension };
+/** 取到编辑器上的 MarkdownManager(未启用扩展时为 undefined) */
+export declare function getMarkdownManager(editor: Editor): MarkdownManager | undefined;
+/** 编辑器当前内容序列化为 Markdown 字符串。未启用扩展时返回空串。 */
+export declare function getMarkdown(editor: Editor): string;
+/**
+ * 把一段 Markdown 写入编辑器(替换全部内容)。
+ *
+ * - 启用了扩展:用 manager.parse 转 JSON 后 setContent,
+ *   解析失败时降级为原文直接塞入(勉强兼容纯文本)。
+ * - 未启用扩展:直接 setContent(md)——此时按 HTML/JSON 默认规则处理。
+ *
+ * 不传 emitUpdate:false,以便新内容通过 onUpdate 流回 v-model。
+ */
+export declare function importMarkdown(editor: Editor, md: string): void;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,CAAA;AAExC,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM9E;AAED,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAY/D"}

package/dist/types.d.ts

@@ -0,0 +1,245 @@
+import { Editor } from '@tiptap/vue-3';
+import { Extensions } from '@tiptap/core';
+import { ImageAlign, ImageSizePreset } from './extensions/image';
+import { Ref } from 'vue';
+/**
+ * 扩展数组类型,v3 用 Extensions(同时接受 Extension 和 Node)。
+ */
+export type { Extensions } from '@tiptap/core';
+/**
+ * 编辑器输出格式
+ */
+export type OutputFormat = 'html' | 'json';
+/**
+ * 图片上传函数契约。
+ *
+ * adapter 接收到上传/粘贴/拖拽的 File,交给 Core 调用此函数拿到 url,
+ * 再插入文档。Core 不关心上传到 OSS/COS/本地,只关心返回 url。
+ *
+ * 实现方应负责:
+ * - 上传进度(可选,Core 不强求)
+ * - 失败时抛错或返回 null(返回 null 时 Core 跳过插入,Core 会调 notify
+ *   提示用户;adapter 负责注入具体的提示 UI,见 NotifyFn)
+ */
+export type UploadImage = (file: File) => Promise<string | null>;
+/**
+ * 消息提示类型。
+ */
+export type NotifyType = 'success' | 'error' | 'warning' | 'info';
+/**
+ * 消息提示回调契约。
+ *
+ * 这是 Core 与 UI 库之间的「提示」边界:Core 在需要提示用户的时机
+ * (上传失败、移除链接、导入结果等)调用它;adapter 注入各自的实现
+ * (EP 的 ElMessage、Naive 的 useMessage、或自定义)。
+ *
+ * 设计动机:让两个 adapter 的「提示时机 + 文案」完全对等——文案集中
+ * 在调用处,adapter 只决定「用什么组件显示」。不传时静默(纯 headless)。
+ */
+export type NotifyFn = (message: string, type?: NotifyType) => void;
+/**
+ * useProEditor 的配置项
+ */
+export interface ProEditorOptions {
+    /** v-model 绑定值,字符串(html/json 文本)或对象(json) */
+    content: string | object;
+    /** 输出格式,默认 'html' */
+    output?: OutputFormat;
+    /** 扩展数组。传入则覆盖默认扩展包;不传使用默认包 */
+    extensions?: Extensions;
+    /** placeholder 文案 */
+    placeholder?: string;
+    /** 图片上传函数。不传则图片只能以已有 url 插入,粘贴/拖拽上传失效 */
+    uploadImage?: UploadImage;
+    /** 是否只读 */
+    editable?: boolean;
+    /**
+     * 消息提示回调。adapter 注入各自 UI 库的实现(EP 的 ElMessage / Naive 的
+     * useMessage)。Core 在上传失败等场景调用它;不传则静默。
+     */
+    notify?: NotifyFn;
+    /** 额外编辑器属性,透传给 Editor 构造函数(如 autofocus, editorProps) */
+    editorProps?: Record<string, unknown>;
+}
+/**
+ * useProEditor 返回的结构
+ */
+export interface ProEditorContext {
+    /** Tiptap Editor 实例(loaded 后才有值) */
+    editor: Ref<Editor | undefined>;
+    /** 编辑器是否已挂载 */
+    loaded: Ref<boolean>;
+    /** 命令是否可用。name 可传扩展名,或传 attrs-only 对象(如 { textAlign: 'center' }) */
+    isActive: (name: string | Record<string, unknown>, attrs?: Record<string, unknown>) => boolean;
+    /** 聚合命令,工具栏按钮直接调用 */
+    commands: ProEditorCommands;
+    /** 当前内容字符串(按 output 格式) */
+    getHTML: () => string;
+    getJSON: () => object;
+    /** 当前内容序列化为 Markdown。未启用 Markdown 扩展时返回空串 */
+    getMarkdown: () => string;
+    /** 把一段 Markdown 写入编辑器(替换全部内容);解析失败则降级直接塞入 */
+    importMarkdown: (md: string) => void;
+    /** 字数统计 */
+    wordCount: Ref<{
+        characters: number;
+        words: number;
+    }>;
+    /** 切换只读 */
+    setEditable: (editable: boolean) => void;
+    /**
+     * 表格选区状态(响应式)。驱动表格气泡里「合并/拆分」按钮的可用性,
+     * 避免 ProseMirror splitCell 对未合并单元格静默 return false 导致「点了没反应」。
+     * 光标不在表格内时,几何字段为默认值(inTable=false)。
+     */
+    tableState: Ref<TableState>;
+    /**
+     * 消息提示。adapter 注入的 UI 库实现(EP 的 ElMessage / Naive 的 useMessage),
+     * 供工具栏等组件在「导入成功 / 链接校验失败」等场景统一调用,文案与触发点对齐。
+     */
+    notify: NotifyFn;
+}
+/**
+ * 表格选区状态。用于驱动「合并/拆分」按钮的禁用态,解释 ProseMirror 的隐式约束:
+ * - mergeCells 只在「选中多个单元格」(CellSelection 跨格)时有效
+ * - splitCell 只在「光标在被合并的单元格」(colspan/rowspan > 1)时有效
+ * 把这两个隐式约束显式化,让 UI 能给出禁用反馈而非静默失败。
+ *
+ * 几何字段(tablePos/rowCount/colCount)供 adapter 渲染飞书式覆盖层定位:
+ * core 不读 DOM,只暴露纯数据;adapter 用 editor.view.nodeDOM(tablePos) 拿 table DOM 算 rect。
+ */
+export interface TableState {
+    /** 光标是否在表格内(任意单元格,含单选/多选) */
+    inTable: boolean;
+    /** 是否选中了多个单元格(CellSelection 且 anchor ≠ head)——合并的前提 */
+    canMerge: boolean;
+    /** 光标所在单元格是否被合并过(colspan 或 rowspan > 1)——拆分的前提 */
+    canSplit: boolean;
+    /** 当前表格在文档中的起始 pos(adapter 用 view.nodeDOM(pos) 定位)。不在表格内为 null */
+    tablePos: number | null;
+    /** 表格行数 */
+    rowCount: number;
+    /** 表格列数 */
+    colCount: number;
+}
+/**
+ * 命令契约。每个方法对应工具栏一个按钮。
+ * adapter 的工具栏直接消费这个对象。
+ *
+ * 命名原则:动词在前,和 Tiptap 原生命名对齐,降低心智成本。
+ */
+export interface ProEditorCommands {
+    undo: () => void;
+    redo: () => void;
+    bold: () => void;
+    italic: () => void;
+    strike: () => void;
+    /** 切换标题级别,level 0 表示取消标题(转普通段落) */
+    toggleHeading: (level: 1 | 2 | 3 | 4 | 5 | 6 | 0) => void;
+    bulletList: () => void;
+    orderedList: () => void;
+    blockquote: () => void;
+    codeBlock: () => void;
+    /** 设置/更新链接;href 为空则移除链接 */
+    setLink: (href: string, opts?: {
+        target?: string;
+        range?: {
+            from: number;
+            to: number;
+        };
+    }) => void;
+    /**
+     * 在指定位置插入/替换一段带链接的文本。
+     * 传 range 时按绝对位置写入(绕开弹窗失焦导致的 selection 漂移);
+     * 不传则用当前 selection。text 为空时用 href 作显示文字。
+     */
+    insertLinkText: (href: string, text?: string, opts?: {
+        target?: string;
+        range?: {
+            from: number;
+            to: number;
+        };
+    }) => void;
+    /**
+     * 确保编辑器有可用光标位置。
+     * 用户从未点进编辑器时,把光标移到文档末尾并聚焦,
+     * 供工具栏「插入类」按钮在操作前调用,避免插入到开头看不到。
+     */
+    ensureFocusAtEnd: () => void;
+    /** 插入图片(已有 url) */
+    setImage: (src: string, alt?: string) => void;
+    /** 插入图片(从 File,走 uploadImage) */
+    uploadAndInsertImage: (file: File) => Promise<void>;
+    /**
+     * 设置当前选中图片的对齐方式。
+     * 仅在当前选中节点是 image 时生效(NodeSelection)。
+     */
+    setImageAlign: (align: ImageAlign) => void;
+    /**
+     * 按预设设置当前选中图片的宽度。
+     * small/medium/large 按编辑器内容区宽度的 25%/50%/75%;
+     * original 清除宽度属性,回归自然尺寸。仅 NodeSelection 生效。
+     */
+    setImageSize: (preset: ImageSizePreset) => void;
+    /**
+     * 设置当前选中图片的题注。空串清除题注。仅 NodeSelection 生效。
+     */
+    setImageCaption: (caption: string) => void;
+    /** 删除当前选中图片。仅 NodeSelection 生效。 */
+    removeImage: () => void;
+    insertTable: (rows?: number, cols?: number) => void;
+    /**
+     * 表格结构操作命令(Tiptap TableKit 全部内置,这里只做接线)。
+     *
+     * 设计为「无参 + 当前选区」:命令作用在光标所在单元格上,与 Tiptap 原生命令
+     * 语义一致。adapter 的工具栏在选中表格时才显示这些按钮(用 isActive('table') 判定),
+     * 所以 core 不需要在命令里判断「是否在表格内」——adapter 已保证只在有效场景暴露入口。
+     *
+     * 命名对齐 Tiptap(addRowAfter 等),降低心智成本。
+     */
+    addRowBefore: () => void;
+    addRowAfter: () => void;
+    deleteRow: () => void;
+    addColumnBefore: () => void;
+    addColumnAfter: () => void;
+    deleteColumn: () => void;
+    /** 合并选区内单元格(需选中多个单元格,通常用拖拽或键盘选区) */
+    mergeCells: () => void;
+    /** 拆分已合并的单元格 */
+    splitCell: () => void;
+    /** 切换首行是否为表头(<th>) */
+    toggleHeaderRow: () => void;
+    /** 切换首列是否为表头 */
+    toggleHeaderColumn: () => void;
+    /** 删除整个表格 */
+    deleteTable: () => void;
+    /**
+     * 移动当前行/列(飞书式抓手菜单用)。基于 prosemirror-tables 的 moveTableRow/moveTableColumn。
+     * 已是首行/首列时 moveUp/Left 无效,已是末行/末列时 moveDown/Right 无效(命令静默返回)。
+     * 作用于当前选区所在行/列,与 addRow/deleteRow 同理。
+     */
+    moveRowUp: () => void;
+    moveRowDown: () => void;
+    moveColumnLeft: () => void;
+    moveColumnRight: () => void;
+    /** 选中光标所在整行(CellSelection.rowSelection)——飞书式抓手点击行为 */
+    selectRow: () => void;
+    /** 选中光标所在整列(CellSelection.colSelection) */
+    selectColumn: () => void;
+    hr: () => void;
+    clearNodes: () => void;
+    /** 设置文字颜色;color 为空字符串则清除颜色 */
+    setColor: (color: string) => void;
+    /** 切换背景高亮;color 为空则清除高亮 */
+    toggleHighlight: (color: string) => void;
+    /** 设置文本对齐 */
+    align: (align: 'left' | 'center' | 'right' | 'justify') => void;
+    /** 下划线(StarterKit 自带 underline 扩展) */
+    underline: () => void;
+    /** 清除所有格式(节点类型 + marks) */
+    clearFormat: () => void;
+    /** 任务列表(toggle) */
+    taskList: () => void;
+}
+export type { ImageAlign, ImageSizePreset } from './extensions/image';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/useProEditor.d.ts

@@ -0,0 +1,20 @@
+import { ProEditorOptions, ProEditorContext } from './types';
+/**
+ * tiptap-vue-pro 的核心 composable。
+ *
+ * 职责:
+ * 1. 通过官方 useEditor 创建编辑器实例(必须用 useEditor,不能用 new Editor,
+ *    否则 vue-3 的 Editor 在构造时 reactiveState 初始化会崩)
+ * 2. 实现 v-model 双向绑定(支持 html / json 两种输出)
+ * 3. 聚合命令对象 commands,供工具栏按钮直接调用
+ * 4. 处理图片上传(从 File 到 url 再到文档插入)
+ * 5. 字数统计、只读切换
+ *
+ * 不做的事(故意下推给 adapter):
+ * - 任何 DOM 渲染、UI 组件
+ * - toast / message 提示(上传失败等由 adapter 用各自 UI 库展示)
+ *
+ * 用法:adapter 组件在 setup 里调用此 composable,把返回的 editor 传给 EditorContent。
+ */
+export declare function useProEditor(options: ProEditorOptions): ProEditorContext;
+//# sourceMappingURL=useProEditor.d.ts.map

package/dist/useProEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProEditor.d.ts","sourceRoot":"","sources":["../src/useProEditor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAIjB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAgfxE"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "tiptap-vue-pro-core",
+  "version": "0.1.0",
+  "description": "tiptap-vue-pro 的 UI 无关核心层:封装 Tiptap v3,提供 composable 与类型契约",
+  "author": "twoer",
+  "license": "MIT",
+  "keywords": [
+    "tiptap",
+    "vue",
+    "vue3",
+    "rich-text",
+    "editor",
+    "wysiwyg",
+    "prosemirror",
+    "headless"
+  ],
+  "homepage": "https://github.com/twoer/tiptap-vue-pro#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/twoer/tiptap-vue-pro",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/twoer/tiptap-vue-pro/issues"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.umd.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.umd.cjs"
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@tiptap/core": "^3.0.0",
+    "@tiptap/pm": "^3.0.0",
+    "@tiptap/vue-3": "^3.0.0",
+    "vue": "^3.4.0"
+  },
+  "dependencies": {
+    "@tiptap/core": "3.27.1",
+    "@tiptap/extension-character-count": "3.27.1",
+    "@tiptap/extension-color": "^3.27.1",
+    "@tiptap/extension-highlight": "^3.27.1",
+    "@tiptap/extension-image": "3.27.1",
+    "@tiptap/extension-list": "^3.27.1",
+    "@tiptap/extension-placeholder": "3.27.1",
+    "@tiptap/extension-table": "3.27.1",
+    "@tiptap/extension-text-align": "^3.27.1",
+    "@tiptap/extension-text-style": "^3.27.1",
+    "@tiptap/markdown": "3.27.1",
+    "@tiptap/pm": "3.27.1",
+    "@tiptap/starter-kit": "3.27.1",
+    "@tiptap/vue-3": "3.27.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "@vitejs/plugin-vue": "^5.2.4",
+    "@vue/test-utils": "^2.4.11",
+    "happy-dom": "^20.10.6",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vitest": "^1.6.1",
+    "vue": "^3.5.0",
+    "vue-tsc": "^2.1.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}