@mteditor/vue2 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MtEditor 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.

package/README.md

@@ -1,3 +1,184 @@
-# Temporary Holding Version
+# @mteditor/vue2
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> MtEditor 的 Vue 2.7 适配层 —— **薄壳，不含任何编辑逻辑**。
+
+## 状态
+
+**M3-d 已落地**。组件、类型、单测与可跑通示例均在本包内；
+可跑通的最小示例见 [`../../examples/vue2/`](../../examples/vue2/)。
+
+## 用法
+
+```vue
+<template>
+  <mt-editor v-model="doc" :options="options" @change="onChange" @error="onError" />
+</template>
+
+<script>
+import { MtEditor } from '@mteditor/vue2'
+import '@mteditor/theme-default/index.css'
+
+export default {
+  components: { MtEditor },
+  data() {
+    return { doc: null, options: { placeholder: '请输入…', theme: 'light' } }
+  },
+  methods: {
+    onChange(payload) {
+      /* v-model 已经写了 doc，这里只是额外关心一次事件 */
+    },
+    onError(payload) {
+      console.error(payload.code, payload.message)
+    },
+  },
+}
+</script>
+```
+
+按 **Options API** 书写，用 `Vue.extend`（不是 `defineComponent`，理由见下），
+只写 Options API 的老项目里接入方式与手写组件没有任何区别。
+
+## `v-model` 双兼容
+
+Vue 2 的 `v-model` 编译产物是 `props.value` + `on.input`；Vue 2.7 起也支持
+`modelValue` + `update:modelValue`。本组件**两个 prop 都收、两个事件都发**：
+
+| 宿主写法 | 走哪条 |
+|---|---|
+| `<mt-editor v-model="doc" />` | `value` 进 / `input` 出 |
+| `<mt-editor :modelValue="doc" @update:modelValue="doc = $event" />` | `modelValue` 进 / `update:modelValue` 出 |
+
+两者同时给出时 `modelValue` 优先。**`input` 与 `update:modelValue` 总是同时派发** ——
+换一种写法不会「少一半事件」，宿主也不必猜自己在走哪条协议。
+
+`null` 与 `undefined` 都算「没给」：`data() { return { doc: null } }` 是 Vue 2 里最常见的
+「还没加载」写法，此时会回落到 `options.content`，且**不会**把 `null` 写进编辑器。
+
+## Props
+
+| Prop | 类型 | 说明 |
+|---|---|---|
+| `value` | `MtDocument \| null \| undefined` | 文档（真相源）。Vue 2 的 `v-model` 默认走这里 |
+| `modelValue` | `MtDocument \| null \| undefined` | 文档（真相源）。Vue 2.7 的 `v-model` 新写法走这里 |
+| `options` | `MtAdapterOptions` | 其余内核选项 |
+
+`MtAdapterOptions = Omit<MtEditorOptions, 'element' | 'onChange' | 'onReady' | 'onError'>`。
+被摘掉的四个由组件自己接管；**`content` 保留**，语义收窄为「初始内容，挂载时读取一次」，
+受控值一旦给出就优先于它。
+
+**运行时可变**的选项只有三个：`theme` / `locale` / `readonly`
+（内核分别为它们提供了 `setTheme` / `setLocale` / `setReadonly`）。
+其余（`platform` / `ui` / `placeholder` / `plugins` / `historyDepth` /
+`changeDebounce` / `selectionThrottle`）**挂载时读取一次**，要换档请用 `:key` 重挂载。
+
+## 事件
+
+内核事件名**原样**沿用（§7.5），不改名也不合并。
+
+| 事件 | 载荷 | 来源 |
+|---|---|---|
+| `input` | `MtDocument` | Vue 2 的 `v-model` 协议 |
+| `update:modelValue` | `MtDocument` | Vue 2.7 的 `v-model` 协议 |
+| `change` | `MtChangePayload`（150ms 防抖） | 内核 |
+| `ready` | `{ instance }` | 内核 |
+| `focus` / `blur` | `{ instance }` | 内核 |
+| `selectionChange` | `MtSelectionInfo`（100ms 节流，leading + trailing） | 内核 |
+| `error` | `MtErrorPayload` | 内核 |
+| `destroy` | `{ instance }` | 内核 |
+
+`ready` 在内核的**构造函数里**就派发了，因此组件把它当**构造选项**（`onReady`）传入，
+而不是事后 `on('ready')` 订阅 —— 后者永远收不到。
+也正因如此，`onReady` 是**唯一**能直接拿到「刚建好的实例」的时机。
+
+## 通过模板 ref 拿到内核实例
+
+```vue
+<mt-editor ref="ed" v-model="doc" />
+```
+
+```ts
+const handle = this.$refs.ed as unknown as MtEditorVue2Handle
+handle.editor?.command('focus')
+```
+
+适配层**只暴露 `editor` 一个字段**，不把内核方法再转发一遍 ——
+否则内核每加一个方法就要改五个适配包，且「适配层的方法」会与内核文档分叉。
+卸载后该字段为 `null`。
+
+## 边界（AGENTS.md §8.1）
+
+允许做：
+
+1. 挂载 / 卸载底层实例；
+2. `props` → `MtEditorOptions` 映射；
+3. `options` 变更时**增量更新**（不重建实例）；
+4. 内核事件 → 宿主事件透传；
+5. `v-model` 双向绑定（两条协议）。
+
+**不允许做**：任何编辑逻辑、任何依赖 Vue 2 生态辅助包（`vuelidate` / `vuex` 等）。
+
+两条具体的禁止（ADR-0028 决策 4）：
+
+- **不在这里做回声抑制**。「灌回来的是同一份内容就不该碰视图」这条判据写在**内核**
+  （`MtEngine.setDocument()` 的结构等价短路）。适配层再判一次等于两处判据，
+  且六个适配端会各判各的。
+- **不为了「同步内容」而重建实例**。重建会丢选区、撤销栈与 IME composition 状态。
+
+## 两处 Vue 2 特有的实现要点
+
+### 用 `Vue.extend`，不用 `defineComponent`
+
+Vue 2.7 也导出了 `defineComponent`，但它在 Vue 2 里**运行时只是原样返回 options 对象**，
+类型上却假装自己是构造器。用 `Vue.extend` 得到的是真正的构造器：既能被 `new`，
+也能直接交给 `h()` 或 `components:` —— 后者正是宿主要做的事。
+它还换来了 `ThisType`，让 `mounted` / `watch` / `render` 里的 `this` 全部有类型。
+
+### 内核实例必须 `markRaw`
+
+Vue 2 的 `observe()` 用 `Object.prototype.toString` 判断「是不是普通对象」，
+**类实例会被判成普通对象**而遭深度遍历 —— 那会把整个编辑器（含 ProseMirror 视图）
+塞满 getter/setter。因此写进 `data` 前必须 `markRaw(editor)`。
+
+事件退订函数则**不放进 `data`**（数组的 `push` 被 Vue 2 改写后会触发重渲染），
+改用一个模块级 `WeakMap` 挂在实例上，卸载时随实例一起回收。
+
+## 依赖
+
+| 类型 | 内容 |
+|---|---|
+| `dependencies` | `@mteditor/core` |
+| `peerDependencies` | `vue: >=2.7.0 <3.0.0`（Vue 2.7 是末版，且内置 Composition API） |
+| devDependencies | 含 `vue-template-compiler@^2.7.16` —— `@vue/test-utils@1` 的必需 peer，见下 |
+
+### 为什么需要 `vue-template-compiler`
+
+`@vue/test-utils@1`（Vue 2 专用，Vue 3 用的是 `@2`）在入口就
+`import { compileToFunctions } from 'vue-template-compiler'`，
+而 Vue 2.7 已把该包废弃（改用 `vue/compiler-sfc`）。
+缺了它，单测会在**收集阶段**就报 `Failed to resolve import "vue-template-compiler"`。
+
+它是**测试期依赖**，不进任何产物。这一处就地声明记在 ADR-0028 决策 7。
+
+## 测试
+
+```bash
+pnpm --filter @mteditor/vue2 test        # 单测（happy-dom + @vue/test-utils@1）
+pnpm --filter @mteditor/vue2 typecheck
+```
+
+12 条单测覆盖四组：挂载与卸载、`v-model` 双兼容（两条协议各一条用例 + 同时派发 +
+`null` 的「没给」语义）、回灌短路、选项映射。
+
+端到端在 [`../../tests/e2e/adapters.spec.ts`](../../tests/e2e/adapters.spec.ts)：
+真实浏览器里挂载 → 输入 → 读回**宿主侧的绑定值**。
+适配包不设覆盖率阈值（ADR-0019 只覆盖 `document` / `core` / `renderer-web`），
+但示例必须纳入 E2E（§8.3，ADR-0028 决策 6）。
+
+## 交付要求
+
+每个适配包必须在 `examples/vue2/` 下提供**可跑通的最小示例** + 完整 README
+（安装、引入、props 表、事件表、常见坑）。**没有示例视为未完成，不允许发版**（§8.3）。
+
+## 许可
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,125 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var Vue = require('vue');
+var core = require('@mteditor/core');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Vue__default = /*#__PURE__*/_interopDefault(Vue);
+
+// src/component.ts
+var applyRuntimeOptions = (instance, options) => {
+  if (options.theme !== void 0) instance.setTheme(options.theme);
+  if (options.locale !== void 0) instance.setLocale(options.locale);
+  if (options.readonly !== void 0) instance.setReadonly(options.readonly);
+};
+var teardown = /* @__PURE__ */ new WeakMap();
+var hostFrom = (refs) => {
+  const ref = refs["host"];
+  return ref instanceof HTMLElement ? ref : null;
+};
+var MtEditor = Vue__default.default.extend({
+  name: "MtEditor",
+  props: {
+    /**
+     * 文档（真相源）。Vue 2 的 `v-model` 默认走这里。
+     *
+     * 类型里带上 `null`：Vue 2 的宿主习惯写 `data() { return { doc: null } }`，
+     * 且在 `null` 上做 `=== null` 判空是必需的分支（`undefined` 覆盖不到它）。
+     */
+    value: { type: Object, default: void 0 },
+    /** 文档（真相源）。Vue 2.7 的 `v-model` 新写法走这里 */
+    modelValue: { type: Object, default: void 0 },
+    /** 其余内核选项 */
+    options: { type: Object, default: () => ({}) }
+  },
+  data() {
+    return {
+      /**
+       * 内核实例。
+       *
+       * **必须 `markRaw`**：Vue 2 的 `observe()` 用 `Object.prototype.toString` 判
+       * 「是不是普通对象」，类实例会被判成普通对象而遭深度遍历 ——
+       * 那会把整个编辑器（含 ProseMirror 视图）塞满 getter/setter。
+       */
+      editor: null
+    };
+  },
+  computed: {
+    /**
+     * 实际生效的受控值。
+     *
+     * 两条 `v-model` 协议共用一个入口：`modelValue` 优先于 `value`，
+     * 而 `null` / `undefined` 都算「没给」（Vue 2 的宿主习惯用 `null` 表示「还没加载」）。
+     * 有了它，下面只需要**一个** watcher，「两个 prop 谁说了算」也就只有一处答案。
+     */
+    boundValue() {
+      return this.modelValue !== void 0 && this.modelValue !== null ? this.modelValue : this.value;
+    }
+  },
+  watch: {
+    // 「编辑器 → 宿主」由 onChange 完成；这里只做「宿主 → 编辑器」。
+    // 内核的结构等价短路保证回灌同一个文档时不会重置光标（ADR-0028 决策 2）。
+    boundValue(next) {
+      if (next === null || next === void 0 || this.editor === null) return;
+      this.editor.setJSON(next);
+    },
+    // 选项变化：只同步能在运行时就地改的那几个（结构性选项挂载时读取一次）
+    options: {
+      deep: true,
+      handler(next) {
+        if (this.editor === null) return;
+        applyRuntimeOptions(this.editor, next);
+      }
+    }
+  },
+  mounted() {
+    const element = hostFrom(this.$refs);
+    if (element === null) return;
+    const { content: initialContent, ...restOptions } = this.options;
+    const editor = new core.MtEditor({
+      ...restOptions,
+      element,
+      content: this.boundValue ?? initialContent,
+      onChange: (payload) => {
+        this.$emit("input", payload.json);
+        this.$emit("update:modelValue", payload.json);
+        this.$emit("change", payload);
+      },
+      // `ready` 在构造期就已派发，因此它走构造选项；其余事件走总线订阅
+      onReady: (payload) => this.$emit("ready", payload),
+      onError: (payload) => this.$emit("error", payload)
+    });
+    teardown.set(this, [
+      editor.on("focus", (payload) => this.$emit("focus", payload)),
+      editor.on("blur", (payload) => this.$emit("blur", payload)),
+      editor.on("selectionChange", (payload) => this.$emit("selectionChange", payload)),
+      editor.on("destroy", (payload) => this.$emit("destroy", payload))
+    ]);
+    this.editor = Vue.markRaw(editor);
+  },
+  // Vue 2 的生命周期名（Vue 3 里叫 `beforeUnmount`）
+  beforeDestroy() {
+    const editor = this.editor;
+    this.editor = null;
+    if (editor === null) return;
+    editor.destroy();
+    for (const off of teardown.get(this) ?? []) off();
+    teardown.delete(this);
+  },
+  render(h) {
+    return h("div", {
+      ref: "host",
+      staticClass: "mt-editor-host",
+      attrs: { "data-mt-adapter": "vue2" }
+    });
+  }
+});
+var component_default = MtEditor;
+
+exports.MtEditor = MtEditor;
+exports.default = component_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/component.ts"],"names":["Vue","MtCoreEditor","markRaw"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Vue 2.7 适配组件（AGENTS.md §8.2）。\n *\n * 它是**薄壳**（§8.1）：只做挂载 / 卸载、props → 选项映射、增量更新、事件透传与双向绑定。\n * 任何编辑逻辑都写在 `@mteditor/core`，写在这里视为违规。\n *\n * ## 为什么用 `Vue.extend` 而不是 `defineComponent`\n *\n * Vue 2.7 也导出了 `defineComponent`，但它在 Vue 2 里**运行时只是原样返回 options 对象**，\n * 类型上却假装自己是构造器。用 `Vue.extend` 得到的是真正的构造器：既能被 `new`，\n * 也能直接丢给 `h()` / `components:` —— 后者正是宿主要做的事。\n *\n * ## `v-model` 双兼容\n *\n * Vue 2 的 `v-model` 编译产物是 `props.value` + `on.input`；Vue 2.7 起也支持\n * `modelValue` + `update:modelValue`。本组件**两个 prop 都收、两个事件都发**：\n *\n * | 宿主写法 | 走哪条 |\n * |---|---|\n * | `<mt-editor v-model=\"doc\" />` | `value` 进 / `input` 出 |\n * | `<mt-editor :modelValue=\"doc\" @update:modelValue=\"doc = $event\" />` | `modelValue` 进 / `update:modelValue` 出 |\n *\n * 两者同时给出时 `modelValue` 优先（见 `boundValue` 计算属性）。\n *\n * ## 两条关键设计（ADR-0028 决策 4）\n *\n * 1. **这里不做回声抑制**。宿主把编辑器刚给出的文档灌回来是 `v-model` 的必然结果，\n *    而「灌回来的是同一份内容就不该碰视图」这条判据写在**内核**\n *    （`MtEngine.setDocument()` 的结构等价短路）。适配层再判一次等于两处判据，\n *    且 6 个适配端会各判各的。\n * 2. **结构性选项挂载时读取一次**。内核没有「运行时换档」的能力\n *    （`platform` / `ui` / `placeholder` / `historyDepth` 等都没有 setter），\n *    因此本组件不假装支持它。要换档请用 Vue 重挂载机制（`:key`）。\n */\n\nimport Vue, { markRaw } from 'vue'\n\nimport { MtEditor as MtCoreEditor } from '@mteditor/core'\nimport type { MtAdapterOptions, MtChangePayload, MtDocument, MtErrorPayload } from '@mteditor/core'\n\n/**\n * 能就地同步的选项子集。类型取自 `MtAdapterOptions`，不另立一份定义\n * （三者的 setter 分别是 `setTheme` / `setLocale` / `setReadonly`）。\n */\ntype MtRuntimeOptions = Pick<MtAdapterOptions, 'theme' | 'locale' | 'readonly'>\n\n/**\n * 把可在**运行时**就地同步的选项写进已存在的内核实例。\n *\n * 白名单是刻意的：内核将来新增运行时 setter 时，需要**显式**加进这里才会生效 ——\n * 比「默认尝试同步」安全，因为后者会让 `ui` 之类的结构性选项被半途写入而非完整重建。\n *\n * @param instance 内核实例\n * @param options 只含「能就地改」的三项\n */\nconst applyRuntimeOptions = (instance: MtCoreEditor, options: MtRuntimeOptions): void => {\n  if (options.theme !== undefined) instance.setTheme(options.theme)\n  if (options.locale !== undefined) instance.setLocale(options.locale)\n  if (options.readonly !== undefined) instance.setReadonly(options.readonly)\n}\n\n/**\n * 每个组件实例的事件退订函数。\n *\n * 不放进 `data`：Vue 2 会把 `data` **深度 observe**，数组的 `push` 会被改写成\n * 触发重渲染的版本；而这些函数与渲染无关。用 `WeakMap` 挂在实例上，\n * 卸载后随实例一起被回收。\n */\nconst teardown = new WeakMap<object, (() => void)[]>()\n\n/**\n * 从 `$refs` 里取挂载容器。\n *\n * `$refs` 的值可能是组件实例、DOM 元素或它们的数组，因此必须走类型守卫。\n *\n * @param refs 组件实例的 `$refs`\n * @returns 命中且确为 HTMLElement 时返回它，否则 `null`\n */\nconst hostFrom = (refs: unknown): HTMLElement | null => {\n  const ref = (refs as Record<string, unknown>)['host']\n  return ref instanceof HTMLElement ? ref : null\n}\n\n/** `<MtEditor>` —— Vue 2.7 的 MtEditor 组件 */\nexport const MtEditor = Vue.extend({\n  name: 'MtEditor',\n\n  props: {\n    /**\n     * 文档（真相源）。Vue 2 的 `v-model` 默认走这里。\n     *\n     * 类型里带上 `null`：Vue 2 的宿主习惯写 `data() { return { doc: null } }`，\n     * 且在 `null` 上做 `=== null` 判空是必需的分支（`undefined` 覆盖不到它）。\n     */\n    value: { type: Object as () => MtDocument | null | undefined, default: undefined },\n    /** 文档（真相源）。Vue 2.7 的 `v-model` 新写法走这里 */\n    modelValue: { type: Object as () => MtDocument | null | undefined, default: undefined },\n    /** 其余内核选项 */\n    options: { type: Object as () => MtAdapterOptions, default: (): MtAdapterOptions => ({}) },\n  },\n\n  data() {\n    return {\n      /**\n       * 内核实例。\n       *\n       * **必须 `markRaw`**：Vue 2 的 `observe()` 用 `Object.prototype.toString` 判\n       * 「是不是普通对象」，类实例会被判成普通对象而遭深度遍历 ——\n       * 那会把整个编辑器（含 ProseMirror 视图）塞满 getter/setter。\n       */\n      editor: null as MtCoreEditor | null,\n    }\n  },\n\n  computed: {\n    /**\n     * 实际生效的受控值。\n     *\n     * 两条 `v-model` 协议共用一个入口：`modelValue` 优先于 `value`，\n     * 而 `null` / `undefined` 都算「没给」（Vue 2 的宿主习惯用 `null` 表示「还没加载」）。\n     * 有了它，下面只需要**一个** watcher，「两个 prop 谁说了算」也就只有一处答案。\n     */\n    boundValue(): MtDocument | null | undefined {\n      return this.modelValue !== undefined && this.modelValue !== null\n        ? this.modelValue\n        : this.value\n    },\n  },\n\n  watch: {\n    // 「编辑器 → 宿主」由 onChange 完成；这里只做「宿主 → 编辑器」。\n    // 内核的结构等价短路保证回灌同一个文档时不会重置光标（ADR-0028 决策 2）。\n    boundValue(next: MtDocument | null | undefined) {\n      if (next === null || next === undefined || this.editor === null) return\n      this.editor.setJSON(next)\n    },\n\n    // 选项变化：只同步能在运行时就地改的那几个（结构性选项挂载时读取一次）\n    options: {\n      deep: true,\n      handler(next: MtAdapterOptions) {\n        if (this.editor === null) return\n        applyRuntimeOptions(this.editor, next)\n      },\n    },\n  },\n\n  mounted() {\n    const element = hostFrom(this.$refs)\n    if (element === null) return\n\n    // `options.content` 语义是「初始内容」；受控值一旦给出就优先于它。\n    // 必须先摘出来再展开，否则 `...options` 会把 `content` 覆盖回旧值。\n    const { content: initialContent, ...restOptions } = this.options\n\n    const editor = new MtCoreEditor({\n      ...restOptions,\n      element,\n      content: this.boundValue ?? initialContent,\n      onChange: (payload: MtChangePayload) => {\n        // 两条 v-model 协议同时派发，宿主用哪种写法都能收到\n        this.$emit('input', payload.json)\n        this.$emit('update:modelValue', payload.json)\n        this.$emit('change', payload)\n      },\n      // `ready` 在构造期就已派发，因此它走构造选项；其余事件走总线订阅\n      onReady: (payload) => this.$emit('ready', payload),\n      onError: (payload: MtErrorPayload) => this.$emit('error', payload),\n    })\n\n    teardown.set(this, [\n      editor.on('focus', (payload) => this.$emit('focus', payload)),\n      editor.on('blur', (payload) => this.$emit('blur', payload)),\n      editor.on('selectionChange', (payload) => this.$emit('selectionChange', payload)),\n      editor.on('destroy', (payload) => this.$emit('destroy', payload)),\n    ])\n\n    this.editor = markRaw(editor)\n  },\n\n  // Vue 2 的生命周期名（Vue 3 里叫 `beforeUnmount`）\n  beforeDestroy() {\n    const editor = this.editor\n    this.editor = null\n    if (editor === null) return\n    // 先销毁再退订：`destroy` 事件本身要透给宿主\n    editor.destroy()\n    for (const off of teardown.get(this) ?? []) off()\n    teardown.delete(this)\n  },\n\n  render(h) {\n    // 无子节点：内核自己往这个 div 里建 DOM，Vue 因此不会去碰它。\n    // 用 `ref: 'host'` 字符串引用（Vue 2 的写法），由 `hostFrom()` 取回。\n    return h('div', {\n      ref: 'host',\n      staticClass: 'mt-editor-host',\n      attrs: { 'data-mt-adapter': 'vue2' },\n    })\n  },\n})\n\n/**\n * `<MtEditor>` 的 props，**由组件定义推断而来**。\n *\n * Vue 2 的 props 与 data 都直接挂在实例上，因此这里从实例类型上摘出 props 对应的三个字段。\n * 刻意不在 `types.ts` 里手写一份 interface：手写的那份会与运行时的 props 定义漂移。\n */\nexport type MtEditorVue2Props = Pick<\n  InstanceType<typeof MtEditor>,\n  'value' | 'modelValue' | 'options'\n>\n\nexport default MtEditor\n"]}

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+import * as vue_types_vue from 'vue/types/vue';
+import * as Vue from 'vue';
+import Vue__default from 'vue';
+import { MtEditor as MtEditor$1, MtDocument, MtAdapterOptions, MtChangePayload, MtSelectionInfo, MtErrorPayload } from '@mteditor/core';
+export { MtAdapterOptions, MtChangePayload, MtDocument, MtEditor as MtEditorInstance, MtErrorPayload, MtSelectionInfo, MtThemeName } from '@mteditor/core';
+
+/** `<MtEditor>` —— Vue 2.7 的 MtEditor 组件 */
+declare const MtEditor: vue_types_vue.ExtendedVue<Vue__default<Record<string, any>, Record<string, any>, never, never, (event: string, ...args: any[]) => Vue__default>, {
+    /**
+     * 内核实例。
+     *
+     * **必须 `markRaw`**：Vue 2 的 `observe()` 用 `Object.prototype.toString` 判
+     * 「是不是普通对象」，类实例会被判成普通对象而遭深度遍历 ——
+     * 那会把整个编辑器（含 ProseMirror 视图）塞满 getter/setter。
+     */
+    editor: MtEditor$1 | null;
+}, unknown, {
+    boundValue: MtDocument | null | undefined;
+}, {
+    value: MtDocument | null | undefined;
+    modelValue: MtDocument | null | undefined;
+    options: MtAdapterOptions;
+}, {}, Vue.ComponentOptionsMixin, Vue.ComponentOptionsMixin>;
+/**
+ * `<MtEditor>` 的 props，**由组件定义推断而来**。
+ *
+ * Vue 2 的 props 与 data 都直接挂在实例上，因此这里从实例类型上摘出 props 对应的三个字段。
+ * 刻意不在 `types.ts` 里手写一份 interface：手写的那份会与运行时的 props 定义漂移。
+ */
+type MtEditorVue2Props = Pick<InstanceType<typeof MtEditor>, 'value' | 'modelValue' | 'options'>;
+
+/**
+ * `@mteditor/vue2` 的公开类型面。
+ *
+ * 这些类型是**给宿主写模板与处理函数用的**，不是内部实现类型。
+ * 它们只是 `@mteditor/core` 的再导出与组合 —— 适配层不得自己另立一套文档模型类型，
+ * 否则「适配层的类型」与「内核的类型」会漂移成两份（ADR-0028 决策 3）。
+ */
+
+/**
+ * `<MtEditor>` 派发的事件与载荷。
+ *
+ * 事件名**原样**沿用内核的 §7.5 命名（`change` / `ready` / `focus` / `blur` /
+ * `selectionChange` / `error` / `destroy`），不改名也不合并 ——
+ * 改名会让「内核文档里的事件名」与「框架里的用法」变成两套说法（ADR-0028 决策 4）。
+ *
+ * 另外两条是 Vue 2 的 `v-model` 协议，**不是**内核事件：
+ *
+ * - `input`：Vue 2 的默认 `v-model` 事件（`<MtEditor v-model="doc" />`）；
+ * - `update:modelValue`：Vue 2.7 起可用的新写法（`<MtEditor :modelValue="doc"
+ *   @update:modelValue="doc = $event" />`）。
+ *
+ * 两者**总是同时派发**，因此两种写法都能用，且不会「换一种写法就少一半事件」。
+ */
+interface MtEditorVue2Events {
+    /** `v-model` 协议：Vue 2 默认写法 */
+    input: MtDocument;
+    /** `v-model` 协议：Vue 2.7 新写法 */
+    'update:modelValue': MtDocument;
+    change: MtChangePayload;
+    ready: {
+        instance: MtEditor$1;
+    };
+    focus: {
+        instance: MtEditor$1;
+    };
+    blur: {
+        instance: MtEditor$1;
+    };
+    selectionChange: MtSelectionInfo;
+    error: MtErrorPayload;
+    destroy: {
+        instance: MtEditor$1;
+    };
+}
+/**
+ * 通过模板 `ref` 拿到的组件实例上，本适配层承诺可用的**唯一**字段。
+ *
+ * 只暴露 `editor`：适配层是薄壳，不该把内核的方法再转发一遍 ——
+ * 那样每加一个内核方法就要改 5 个适配包，且「适配层的方法」会与内核文档分叉。
+ *
+ * @example
+ * ```vue
+ * <mt-editor ref="ed" v-model="doc" />
+ * ```
+ * ```ts
+ * const handle = this.$refs.ed as unknown as MtEditorVue2Handle
+ * handle.editor?.command('focus')
+ * ```
+ */
+interface MtEditorVue2Handle {
+    /** 底层内核实例；未挂载（或已销毁）时为 `null` */
+    readonly editor: MtEditor$1 | null;
+}
+
+export { MtEditor, type MtEditorVue2Events, type MtEditorVue2Handle, type MtEditorVue2Props, MtEditor as default };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import * as vue_types_vue from 'vue/types/vue';
+import * as Vue from 'vue';
+import Vue__default from 'vue';
+import { MtEditor as MtEditor$1, MtDocument, MtAdapterOptions, MtChangePayload, MtSelectionInfo, MtErrorPayload } from '@mteditor/core';
+export { MtAdapterOptions, MtChangePayload, MtDocument, MtEditor as MtEditorInstance, MtErrorPayload, MtSelectionInfo, MtThemeName } from '@mteditor/core';
+
+/** `<MtEditor>` —— Vue 2.7 的 MtEditor 组件 */
+declare const MtEditor: vue_types_vue.ExtendedVue<Vue__default<Record<string, any>, Record<string, any>, never, never, (event: string, ...args: any[]) => Vue__default>, {
+    /**
+     * 内核实例。
+     *
+     * **必须 `markRaw`**：Vue 2 的 `observe()` 用 `Object.prototype.toString` 判
+     * 「是不是普通对象」，类实例会被判成普通对象而遭深度遍历 ——
+     * 那会把整个编辑器（含 ProseMirror 视图）塞满 getter/setter。
+     */
+    editor: MtEditor$1 | null;
+}, unknown, {
+    boundValue: MtDocument | null | undefined;
+}, {
+    value: MtDocument | null | undefined;
+    modelValue: MtDocument | null | undefined;
+    options: MtAdapterOptions;
+}, {}, Vue.ComponentOptionsMixin, Vue.ComponentOptionsMixin>;
+/**
+ * `<MtEditor>` 的 props，**由组件定义推断而来**。
+ *
+ * Vue 2 的 props 与 data 都直接挂在实例上，因此这里从实例类型上摘出 props 对应的三个字段。
+ * 刻意不在 `types.ts` 里手写一份 interface：手写的那份会与运行时的 props 定义漂移。
+ */
+type MtEditorVue2Props = Pick<InstanceType<typeof MtEditor>, 'value' | 'modelValue' | 'options'>;
+
+/**
+ * `@mteditor/vue2` 的公开类型面。
+ *
+ * 这些类型是**给宿主写模板与处理函数用的**，不是内部实现类型。
+ * 它们只是 `@mteditor/core` 的再导出与组合 —— 适配层不得自己另立一套文档模型类型，
+ * 否则「适配层的类型」与「内核的类型」会漂移成两份（ADR-0028 决策 3）。
+ */
+
+/**
+ * `<MtEditor>` 派发的事件与载荷。
+ *
+ * 事件名**原样**沿用内核的 §7.5 命名（`change` / `ready` / `focus` / `blur` /
+ * `selectionChange` / `error` / `destroy`），不改名也不合并 ——
+ * 改名会让「内核文档里的事件名」与「框架里的用法」变成两套说法（ADR-0028 决策 4）。
+ *
+ * 另外两条是 Vue 2 的 `v-model` 协议，**不是**内核事件：
+ *
+ * - `input`：Vue 2 的默认 `v-model` 事件（`<MtEditor v-model="doc" />`）；
+ * - `update:modelValue`：Vue 2.7 起可用的新写法（`<MtEditor :modelValue="doc"
+ *   @update:modelValue="doc = $event" />`）。
+ *
+ * 两者**总是同时派发**，因此两种写法都能用，且不会「换一种写法就少一半事件」。
+ */
+interface MtEditorVue2Events {
+    /** `v-model` 协议：Vue 2 默认写法 */
+    input: MtDocument;
+    /** `v-model` 协议：Vue 2.7 新写法 */
+    'update:modelValue': MtDocument;
+    change: MtChangePayload;
+    ready: {
+        instance: MtEditor$1;
+    };
+    focus: {
+        instance: MtEditor$1;
+    };
+    blur: {
+        instance: MtEditor$1;
+    };
+    selectionChange: MtSelectionInfo;
+    error: MtErrorPayload;
+    destroy: {
+        instance: MtEditor$1;
+    };
+}
+/**
+ * 通过模板 `ref` 拿到的组件实例上，本适配层承诺可用的**唯一**字段。
+ *
+ * 只暴露 `editor`：适配层是薄壳，不该把内核的方法再转发一遍 ——
+ * 那样每加一个内核方法就要改 5 个适配包，且「适配层的方法」会与内核文档分叉。
+ *
+ * @example
+ * ```vue
+ * <mt-editor ref="ed" v-model="doc" />
+ * ```
+ * ```ts
+ * const handle = this.$refs.ed as unknown as MtEditorVue2Handle
+ * handle.editor?.command('focus')
+ * ```
+ */
+interface MtEditorVue2Handle {
+    /** 底层内核实例；未挂载（或已销毁）时为 `null` */
+    readonly editor: MtEditor$1 | null;
+}
+
+export { MtEditor, type MtEditorVue2Events, type MtEditorVue2Handle, type MtEditorVue2Props, MtEditor as default };

package/dist/index.js

@@ -0,0 +1,116 @@
+import Vue, { markRaw } from 'vue';
+import { MtEditor as MtEditor$1 } from '@mteditor/core';
+
+// src/component.ts
+var applyRuntimeOptions = (instance, options) => {
+  if (options.theme !== void 0) instance.setTheme(options.theme);
+  if (options.locale !== void 0) instance.setLocale(options.locale);
+  if (options.readonly !== void 0) instance.setReadonly(options.readonly);
+};
+var teardown = /* @__PURE__ */ new WeakMap();
+var hostFrom = (refs) => {
+  const ref = refs["host"];
+  return ref instanceof HTMLElement ? ref : null;
+};
+var MtEditor = Vue.extend({
+  name: "MtEditor",
+  props: {
+    /**
+     * 文档（真相源）。Vue 2 的 `v-model` 默认走这里。
+     *
+     * 类型里带上 `null`：Vue 2 的宿主习惯写 `data() { return { doc: null } }`，
+     * 且在 `null` 上做 `=== null` 判空是必需的分支（`undefined` 覆盖不到它）。
+     */
+    value: { type: Object, default: void 0 },
+    /** 文档（真相源）。Vue 2.7 的 `v-model` 新写法走这里 */
+    modelValue: { type: Object, default: void 0 },
+    /** 其余内核选项 */
+    options: { type: Object, default: () => ({}) }
+  },
+  data() {
+    return {
+      /**
+       * 内核实例。
+       *
+       * **必须 `markRaw`**：Vue 2 的 `observe()` 用 `Object.prototype.toString` 判
+       * 「是不是普通对象」，类实例会被判成普通对象而遭深度遍历 ——
+       * 那会把整个编辑器（含 ProseMirror 视图）塞满 getter/setter。
+       */
+      editor: null
+    };
+  },
+  computed: {
+    /**
+     * 实际生效的受控值。
+     *
+     * 两条 `v-model` 协议共用一个入口：`modelValue` 优先于 `value`，
+     * 而 `null` / `undefined` 都算「没给」（Vue 2 的宿主习惯用 `null` 表示「还没加载」）。
+     * 有了它，下面只需要**一个** watcher，「两个 prop 谁说了算」也就只有一处答案。
+     */
+    boundValue() {
+      return this.modelValue !== void 0 && this.modelValue !== null ? this.modelValue : this.value;
+    }
+  },
+  watch: {
+    // 「编辑器 → 宿主」由 onChange 完成；这里只做「宿主 → 编辑器」。
+    // 内核的结构等价短路保证回灌同一个文档时不会重置光标（ADR-0028 决策 2）。
+    boundValue(next) {
+      if (next === null || next === void 0 || this.editor === null) return;
+      this.editor.setJSON(next);
+    },
+    // 选项变化：只同步能在运行时就地改的那几个（结构性选项挂载时读取一次）
+    options: {
+      deep: true,
+      handler(next) {
+        if (this.editor === null) return;
+        applyRuntimeOptions(this.editor, next);
+      }
+    }
+  },
+  mounted() {
+    const element = hostFrom(this.$refs);
+    if (element === null) return;
+    const { content: initialContent, ...restOptions } = this.options;
+    const editor = new MtEditor$1({
+      ...restOptions,
+      element,
+      content: this.boundValue ?? initialContent,
+      onChange: (payload) => {
+        this.$emit("input", payload.json);
+        this.$emit("update:modelValue", payload.json);
+        this.$emit("change", payload);
+      },
+      // `ready` 在构造期就已派发，因此它走构造选项；其余事件走总线订阅
+      onReady: (payload) => this.$emit("ready", payload),
+      onError: (payload) => this.$emit("error", payload)
+    });
+    teardown.set(this, [
+      editor.on("focus", (payload) => this.$emit("focus", payload)),
+      editor.on("blur", (payload) => this.$emit("blur", payload)),
+      editor.on("selectionChange", (payload) => this.$emit("selectionChange", payload)),
+      editor.on("destroy", (payload) => this.$emit("destroy", payload))
+    ]);
+    this.editor = markRaw(editor);
+  },
+  // Vue 2 的生命周期名（Vue 3 里叫 `beforeUnmount`）
+  beforeDestroy() {
+    const editor = this.editor;
+    this.editor = null;
+    if (editor === null) return;
+    editor.destroy();
+    for (const off of teardown.get(this) ?? []) off();
+    teardown.delete(this);
+  },
+  render(h) {
+    return h("div", {
+      ref: "host",
+      staticClass: "mt-editor-host",
+      attrs: { "data-mt-adapter": "vue2" }
+    });
+  }
+});
+var component_default = MtEditor;
+
+export { MtEditor, component_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/component.ts"],"names":["MtCoreEditor"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Vue 2.7 适配组件（AGENTS.md §8.2）。\n *\n * 它是**薄壳**（§8.1）：只做挂载 / 卸载、props → 选项映射、增量更新、事件透传与双向绑定。\n * 任何编辑逻辑都写在 `@mteditor/core`，写在这里视为违规。\n *\n * ## 为什么用 `Vue.extend` 而不是 `defineComponent`\n *\n * Vue 2.7 也导出了 `defineComponent`，但它在 Vue 2 里**运行时只是原样返回 options 对象**，\n * 类型上却假装自己是构造器。用 `Vue.extend` 得到的是真正的构造器：既能被 `new`，\n * 也能直接丢给 `h()` / `components:` —— 后者正是宿主要做的事。\n *\n * ## `v-model` 双兼容\n *\n * Vue 2 的 `v-model` 编译产物是 `props.value` + `on.input`；Vue 2.7 起也支持\n * `modelValue` + `update:modelValue`。本组件**两个 prop 都收、两个事件都发**：\n *\n * | 宿主写法 | 走哪条 |\n * |---|---|\n * | `<mt-editor v-model=\"doc\" />` | `value` 进 / `input` 出 |\n * | `<mt-editor :modelValue=\"doc\" @update:modelValue=\"doc = $event\" />` | `modelValue` 进 / `update:modelValue` 出 |\n *\n * 两者同时给出时 `modelValue` 优先（见 `boundValue` 计算属性）。\n *\n * ## 两条关键设计（ADR-0028 决策 4）\n *\n * 1. **这里不做回声抑制**。宿主把编辑器刚给出的文档灌回来是 `v-model` 的必然结果，\n *    而「灌回来的是同一份内容就不该碰视图」这条判据写在**内核**\n *    （`MtEngine.setDocument()` 的结构等价短路）。适配层再判一次等于两处判据，\n *    且 6 个适配端会各判各的。\n * 2. **结构性选项挂载时读取一次**。内核没有「运行时换档」的能力\n *    （`platform` / `ui` / `placeholder` / `historyDepth` 等都没有 setter），\n *    因此本组件不假装支持它。要换档请用 Vue 重挂载机制（`:key`）。\n */\n\nimport Vue, { markRaw } from 'vue'\n\nimport { MtEditor as MtCoreEditor } from '@mteditor/core'\nimport type { MtAdapterOptions, MtChangePayload, MtDocument, MtErrorPayload } from '@mteditor/core'\n\n/**\n * 能就地同步的选项子集。类型取自 `MtAdapterOptions`，不另立一份定义\n * （三者的 setter 分别是 `setTheme` / `setLocale` / `setReadonly`）。\n */\ntype MtRuntimeOptions = Pick<MtAdapterOptions, 'theme' | 'locale' | 'readonly'>\n\n/**\n * 把可在**运行时**就地同步的选项写进已存在的内核实例。\n *\n * 白名单是刻意的：内核将来新增运行时 setter 时，需要**显式**加进这里才会生效 ——\n * 比「默认尝试同步」安全，因为后者会让 `ui` 之类的结构性选项被半途写入而非完整重建。\n *\n * @param instance 内核实例\n * @param options 只含「能就地改」的三项\n */\nconst applyRuntimeOptions = (instance: MtCoreEditor, options: MtRuntimeOptions): void => {\n  if (options.theme !== undefined) instance.setTheme(options.theme)\n  if (options.locale !== undefined) instance.setLocale(options.locale)\n  if (options.readonly !== undefined) instance.setReadonly(options.readonly)\n}\n\n/**\n * 每个组件实例的事件退订函数。\n *\n * 不放进 `data`：Vue 2 会把 `data` **深度 observe**，数组的 `push` 会被改写成\n * 触发重渲染的版本；而这些函数与渲染无关。用 `WeakMap` 挂在实例上，\n * 卸载后随实例一起被回收。\n */\nconst teardown = new WeakMap<object, (() => void)[]>()\n\n/**\n * 从 `$refs` 里取挂载容器。\n *\n * `$refs` 的值可能是组件实例、DOM 元素或它们的数组，因此必须走类型守卫。\n *\n * @param refs 组件实例的 `$refs`\n * @returns 命中且确为 HTMLElement 时返回它，否则 `null`\n */\nconst hostFrom = (refs: unknown): HTMLElement | null => {\n  const ref = (refs as Record<string, unknown>)['host']\n  return ref instanceof HTMLElement ? ref : null\n}\n\n/** `<MtEditor>` —— Vue 2.7 的 MtEditor 组件 */\nexport const MtEditor = Vue.extend({\n  name: 'MtEditor',\n\n  props: {\n    /**\n     * 文档（真相源）。Vue 2 的 `v-model` 默认走这里。\n     *\n     * 类型里带上 `null`：Vue 2 的宿主习惯写 `data() { return { doc: null } }`，\n     * 且在 `null` 上做 `=== null` 判空是必需的分支（`undefined` 覆盖不到它）。\n     */\n    value: { type: Object as () => MtDocument | null | undefined, default: undefined },\n    /** 文档（真相源）。Vue 2.7 的 `v-model` 新写法走这里 */\n    modelValue: { type: Object as () => MtDocument | null | undefined, default: undefined },\n    /** 其余内核选项 */\n    options: { type: Object as () => MtAdapterOptions, default: (): MtAdapterOptions => ({}) },\n  },\n\n  data() {\n    return {\n      /**\n       * 内核实例。\n       *\n       * **必须 `markRaw`**：Vue 2 的 `observe()` 用 `Object.prototype.toString` 判\n       * 「是不是普通对象」，类实例会被判成普通对象而遭深度遍历 ——\n       * 那会把整个编辑器（含 ProseMirror 视图）塞满 getter/setter。\n       */\n      editor: null as MtCoreEditor | null,\n    }\n  },\n\n  computed: {\n    /**\n     * 实际生效的受控值。\n     *\n     * 两条 `v-model` 协议共用一个入口：`modelValue` 优先于 `value`，\n     * 而 `null` / `undefined` 都算「没给」（Vue 2 的宿主习惯用 `null` 表示「还没加载」）。\n     * 有了它，下面只需要**一个** watcher，「两个 prop 谁说了算」也就只有一处答案。\n     */\n    boundValue(): MtDocument | null | undefined {\n      return this.modelValue !== undefined && this.modelValue !== null\n        ? this.modelValue\n        : this.value\n    },\n  },\n\n  watch: {\n    // 「编辑器 → 宿主」由 onChange 完成；这里只做「宿主 → 编辑器」。\n    // 内核的结构等价短路保证回灌同一个文档时不会重置光标（ADR-0028 决策 2）。\n    boundValue(next: MtDocument | null | undefined) {\n      if (next === null || next === undefined || this.editor === null) return\n      this.editor.setJSON(next)\n    },\n\n    // 选项变化：只同步能在运行时就地改的那几个（结构性选项挂载时读取一次）\n    options: {\n      deep: true,\n      handler(next: MtAdapterOptions) {\n        if (this.editor === null) return\n        applyRuntimeOptions(this.editor, next)\n      },\n    },\n  },\n\n  mounted() {\n    const element = hostFrom(this.$refs)\n    if (element === null) return\n\n    // `options.content` 语义是「初始内容」；受控值一旦给出就优先于它。\n    // 必须先摘出来再展开，否则 `...options` 会把 `content` 覆盖回旧值。\n    const { content: initialContent, ...restOptions } = this.options\n\n    const editor = new MtCoreEditor({\n      ...restOptions,\n      element,\n      content: this.boundValue ?? initialContent,\n      onChange: (payload: MtChangePayload) => {\n        // 两条 v-model 协议同时派发，宿主用哪种写法都能收到\n        this.$emit('input', payload.json)\n        this.$emit('update:modelValue', payload.json)\n        this.$emit('change', payload)\n      },\n      // `ready` 在构造期就已派发，因此它走构造选项；其余事件走总线订阅\n      onReady: (payload) => this.$emit('ready', payload),\n      onError: (payload: MtErrorPayload) => this.$emit('error', payload),\n    })\n\n    teardown.set(this, [\n      editor.on('focus', (payload) => this.$emit('focus', payload)),\n      editor.on('blur', (payload) => this.$emit('blur', payload)),\n      editor.on('selectionChange', (payload) => this.$emit('selectionChange', payload)),\n      editor.on('destroy', (payload) => this.$emit('destroy', payload)),\n    ])\n\n    this.editor = markRaw(editor)\n  },\n\n  // Vue 2 的生命周期名（Vue 3 里叫 `beforeUnmount`）\n  beforeDestroy() {\n    const editor = this.editor\n    this.editor = null\n    if (editor === null) return\n    // 先销毁再退订：`destroy` 事件本身要透给宿主\n    editor.destroy()\n    for (const off of teardown.get(this) ?? []) off()\n    teardown.delete(this)\n  },\n\n  render(h) {\n    // 无子节点：内核自己往这个 div 里建 DOM，Vue 因此不会去碰它。\n    // 用 `ref: 'host'` 字符串引用（Vue 2 的写法），由 `hostFrom()` 取回。\n    return h('div', {\n      ref: 'host',\n      staticClass: 'mt-editor-host',\n      attrs: { 'data-mt-adapter': 'vue2' },\n    })\n  },\n})\n\n/**\n * `<MtEditor>` 的 props，**由组件定义推断而来**。\n *\n * Vue 2 的 props 与 data 都直接挂在实例上，因此这里从实例类型上摘出 props 对应的三个字段。\n * 刻意不在 `types.ts` 里手写一份 interface：手写的那份会与运行时的 props 定义漂移。\n */\nexport type MtEditorVue2Props = Pick<\n  InstanceType<typeof MtEditor>,\n  'value' | 'modelValue' | 'options'\n>\n\nexport default MtEditor\n"]}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@mteditor/vue2",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "MtEditor 的 Vue 2.7 适配层：Options API 薄壳，兼容 value/input 形式的 v-model",
+  "keywords": [
+    "mteditor",
+    "vue2",
+    "editor",
+    "rich-text"
+  ],
+  "license": "MIT",
+  "homepage": "https://gitee.com/meilitao/editor",
+  "bugs": {
+    "url": "https://gitee.com/meilitao/editor/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/meilitao/editor.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mteditor/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "vue": ">=2.7.0 <3.0.0"
+  },
+  "devDependencies": {
+    "@vue/test-utils": "^1.3.6",
+    "happy-dom": "^15.11.7",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "vue": "^2.7.16",
+    "vue-template-compiler": "^2.7.16"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "clean": "rimraf dist .turbo"
+  }
 }