@kungal/editor-vue 0.24.0 → 0.25.1

package/CHANGELOG.md

@@ -1,5 +1,65 @@
 # @kungal/editor-vue
 
+## 0.25.1
+
+### Patch Changes
+
+- 177df55: Fix the cursor jumping to the start when editing the source pane in split mode.
+
+  Typing a character on an empty line (or deleting the first character of a line)
+  in the split-view source editor jumped the caret back to the document start. Cause:
+  a feedback loop — the source (CodeMirror) edit updated the shared `v-model`, the
+  read-only WYSIWYG preview re-rendered and echoed its _re-serialized_ (normalized)
+  markdown back into `v-model`, and CodeMirror then rebuilt its whole state
+  (`setState`) to match, resetting the selection.
+
+  Two fixes:
+
+  - **MilkdownEditor** no longer echoes changes it applied from an external
+    `v-model` update (it only emits genuine user edits), so the preview stops
+    feeding normalized markdown back.
+  - **MarkdownSource** now re-syncs external changes with a content-replacing
+    transaction that preserves (clamps) the selection, instead of a full `setState`
+    rebuild — so the caret and undo history survive.
+
+  Verified in the docs production build (split mode): typing `x y z` on an empty
+  line yields `xyz` in order; deleting the first char of a line keeps the caret on
+  that line; 0 console errors.
+
+  - @kungal/editor-core@0.25.1
+
+## 0.25.0
+
+### Minor Changes
+
+- a103220: Placeholder: default to `'doc'` mode + expose `placeholderMode`.
+
+  The placeholder used to appear on **every empty line** (the cursor's empty
+  block) — that's the Milkdown/Notion `'block'` behavior, which was the default but
+  is surprising for a reply/comment editor. `<KunEditor>` now defaults to `'doc'`:
+  the placeholder shows **only while the whole editor is empty** (the conventional
+  empty-state hint), and the new `placeholderMode` prop opts back into per-line
+  `'block'`:
+
+  ```vue
+  <KunEditor v-model="md" placeholder="写点什么…" />
+  <!-- only when empty -->
+  <KunEditor v-model="md" placeholder="写点什么…" placeholder-mode="block" />
+  <!-- on each empty line -->
+  ```
+
+  (The lower-level `createKunEditorPlugins(..., { placeholderMode })` /
+  `createPlaceholderPlugin` still default to `'block'` for parity with Crepe; the
+  opinion lives in the `<KunEditor>` component.)
+
+  Verified in the docs production build: empty editor shows the placeholder; typing
+  a line then Enter (an empty line in a non-empty doc) does not; `placeholder-mode="block"`
+  brings back the per-line hint. 47 core tests pass (incl. new doc-vs-block cases).
+
+### Patch Changes
+
+- @kungal/editor-core@0.25.0
+
 ## 0.24.0
 
 ### Minor Changes

package/dist/components/KunEditor.vue.d.ts

@@ -12,8 +12,14 @@ type __VLS_Props = {
     locale?: KunEditorLocale;
     /** Read-only render (no editing). */
     readonly?: boolean;
-    /** Placeholder text shown while the editor is empty. */
+    /** Placeholder text shown while empty. */
     placeholder?: string;
+    /**
+     * When the placeholder shows: `'doc'` (default) only while the whole editor
+     * is empty (the conventional empty-state hint); `'block'` on any empty block
+     * at the cursor (Notion style — a hint on every new empty line).
+     */
+    placeholderMode?: 'doc' | 'block';
     /**
      * Which view modes to offer in the switch. Default all three. Drop `'split'`
      * (or use just `['wysiwyg']`) for compact editors like a reply/comment box —
@@ -78,6 +84,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, KunEditorEx
     locale: KunEditorLocale;
     readonly: boolean;
     placeholder: string;
+    placeholderMode: "doc" | "block";
     selectionToolbar: boolean | KunSelectionItem[];
     views: ViewMode[];
     scrollSync: boolean;

package/dist/components/KunEditor.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KunEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/KunEditor.vue"],"names":[],"mappings":"AA8VA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AASjE,KAAK,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE9C,KAAK,WAAW,GAAG;IACf,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB;oEACgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAAA;CAChD,CAAC;AA0ZJ,QAAA,IAAI,OAAO;;iBAlWS,QAAQ;;;;;;;;;;;;;CAkWP,EAAE,QAAQ;iEA/c/B,CAjUkC;;;;;;;;;;;;;;;CAgxB8B,CAAE;AAClE,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAQhD,QAAA,MAAM,UAAU;;;;;cA9bD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;iBAEJ,MAAM;sBAgBD,OAAO,GAAG,gBAAgB,EAAE;WAVvC,QAAQ,EAAE;gBAGL,OAAO;6EAkbtB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"KunEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/KunEditor.vue"],"names":[],"mappings":"AAsWA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AASjE,KAAK,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE9C,KAAK,WAAW,GAAG;IACf,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB;oEACgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAAA;CAChD,CAAC;AA8ZJ,QAAA,IAAI,OAAO;;iBArWS,QAAQ;;;;;;;;;;;;;CAqWP,EAAE,QAAQ;iEAzd/B,CAzUkC;;;;;;;;;;;;;;;CAkyB8B,CAAE;AAClE,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAQhD,QAAA,MAAM,UAAU;;;;;cAxcD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;iBAEJ,MAAM;qBAMF,KAAK,GAAG,OAAO;sBAgBd,OAAO,GAAG,gBAAgB,EAAE;WAVvC,QAAQ,EAAE;gBAGL,OAAO;6EAsbtB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/MarkdownSource.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownSource.vue.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownSource.vue"],"names":[],"mappings":"AA2FA,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAC;AA2EF,QAAA,MAAM,YAAY;;;;kFAGhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}
+{"version":3,"file":"MarkdownSource.vue.d.ts","sourceRoot":"","sources":["../../src/components/MarkdownSource.vue"],"names":[],"mappings":"AA2GA,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAC;AA2FF,QAAA,MAAM,YAAY;;;;kFAGhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/components/MilkdownEditor.vue.d.ts

@@ -7,6 +7,7 @@ type __VLS_Props = {
     locale: KunEditorLocale;
     readonly: boolean;
     placeholder: string;
+    placeholderMode: 'doc' | 'block';
     selectionToolbar: boolean;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, KunEditorExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {

package/dist/components/MilkdownEditor.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MilkdownEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/MilkdownEditor.vue"],"names":[],"mappings":"AA4MA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAI5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,OAAO,CAAA;CAC1B,CAAC;AA4JF,QAAA,MAAM,YAAY;;;;kFAIhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}
+{"version":3,"file":"MilkdownEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/MilkdownEditor.vue"],"names":[],"mappings":"AA2NA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAI5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,KAAK,GAAG,OAAO,CAAA;IAChC,gBAAgB,EAAE,OAAO,CAAA;CAC1B,CAAC;AA0KF,QAAA,MAAM,YAAY;;;;kFAIhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/index.js

@@ -10,28 +10,28 @@ import { createKunEditorPlugins as G, insertKunSpoilerCommand as K, insertMentio
 import { TextSelection as ie } from "@milkdown/kit/prose/state";
 import { createCodeBlockCommand as ae, insertHrCommand as oe, insertImageCommand as se, toggleEmphasisCommand as ce, toggleInlineCodeCommand as le, toggleStrongCommand as ue, wrapInBlockquoteCommand as de, wrapInBulletListCommand as fe, wrapInOrderedListCommand as pe } from "@milkdown/kit/preset/commonmark";
 import { toggleStrikethroughCommand as me } from "@milkdown/kit/preset/gfm";
-import { EditorState as he } from "@codemirror/state";
+import { Annotation as he, EditorState as ge } from "@codemirror/state";
 import { EditorView as Y } from "@codemirror/view";
-import { markdown as ge } from "@codemirror/lang-markdown";
-import { basicSetup as _e } from "codemirror";
+import { markdown as _e } from "@codemirror/lang-markdown";
+import { basicSetup as ve } from "codemirror";
 //#region src/context.ts
-var X = Symbol("kun-editor-context"), ve = [
+var X = Symbol("kun-editor-context"), ye = [
 	"data-active",
 	"onMousedown",
 	"onMouseenter"
-], ye = ["src", "alt"], be = {
+], be = ["src", "alt"], xe = {
 	key: 1,
 	class: "kun-mention-dropdown__avatar kun-mention-dropdown__avatar--fallback"
-}, xe = { class: "kun-mention-dropdown__name" }, Se = {
+}, Se = { class: "kun-mention-dropdown__name" }, Ce = {
 	key: 1,
 	class: "kun-mention-dropdown__hint"
-}, Ce = {
+}, we = {
 	key: 2,
 	class: "kun-mention-dropdown__hint"
-}, we = {
+}, Te = {
 	key: 3,
 	class: "kun-mention-dropdown__hint"
-}, Te = /* @__PURE__ */ s({
+}, Ee = /* @__PURE__ */ s({
 	__name: "MentionDropdown",
 	setup(n) {
 		let r = /(?:^|\s)@([^\s@]{0,30})$/, o = l(X), s = o?.adapters.searchMentionUsers, c = t(() => (o?.locale ?? "zh-cn").toLowerCase().startsWith("en")), u = t(() => c.value ? {
@@ -137,7 +137,7 @@ var X = Symbol("kun-editor-context"), ve = [
 			src: e.avatar,
 			alt: e.name,
 			class: "kun-mention-dropdown__avatar"
-		}, null, 8, ye)) : (m(), i("span", be, y(e.name.charAt(0)), 1)), a("span", xe, y(e.name), 1)], 40, ve))), 128)) : D.value ? (m(), i("div", Se, y(u.value.searching), 1)) : C.value ? (m(), i("div", Ce, y(u.value.empty), 1)) : (m(), i("div", we, y(u.value.prompt), 1))], 512));
+		}, null, 8, be)) : (m(), i("span", xe, y(e.name.charAt(0)), 1)), a("span", Se, y(e.name), 1)], 40, ye))), 128)) : D.value ? (m(), i("div", Ce, y(u.value.searching), 1)) : C.value ? (m(), i("div", we, y(u.value.empty), 1)) : (m(), i("div", Te, y(u.value.prompt), 1))], 512));
 	}
 }), Z = (e) => `<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">${e}</svg>`, Q = (e, t = 13) => `<svg viewBox="0 0 24 24" width="18" height="18" aria-hidden="true"><text x="12" y="12" dominant-baseline="central" text-anchor="middle" font-size="${t}" font-weight="700" font-family="ui-sans-serif, system-ui, sans-serif" fill="currentColor">${e}</text></svg>`, $ = {
 	bold: Z("<path d=\"M6 4h8a4 4 0 0 1 0 8H6z\"/><path d=\"M6 12h9a4 4 0 0 1 0 8H6z\"/>"),
@@ -156,15 +156,15 @@ var X = Symbol("kun-editor-context"), ve = [
 	spoiler: Z("<path d=\"M9.9 4.24A9.1 9.1 0 0 1 12 4c7 0 10 8 10 8a13.2 13.2 0 0 1-1.67 2.68\"/><path d=\"M6.6 6.6A13.5 13.5 0 0 0 2 12s3 8 10 8a9.7 9.7 0 0 0 5.4-1.6\"/><line x1=\"2\" y1=\"2\" x2=\"22\" y2=\"22\"/>"),
 	latex: Q("Σ", 15),
 	smile: Z("<circle cx=\"12\" cy=\"12\" r=\"9\"/><path d=\"M8 14s1.5 2 4 2 4-2 4-2\"/><line x1=\"9\" y1=\"9\" x2=\"9.01\" y2=\"9\"/><line x1=\"15\" y1=\"9\" x2=\"15.01\" y2=\"9\"/>")
-}, Ee = {
+}, De = {
 	key: 0,
 	class: "kun-editor__toolbar-divider",
 	"aria-hidden": "true"
-}, De = [
+}, Oe = [
 	"title",
 	"aria-label",
 	"onMousedown"
-], Oe = ["innerHTML"], ke = /* @__PURE__ */ s({
+], ke = ["innerHTML"], Ae = /* @__PURE__ */ s({
 	__name: "SelectionTooltip",
 	setup(n) {
 		let { view: r, prevState: o } = j(), [, s] = k(), c = l(X), u = t(() => (c?.locale ?? "zh-cn").toLowerCase().startsWith("en")), d = g(null), h, v = (e, t) => {
@@ -221,7 +221,7 @@ var X = Symbol("kun-editor-context"), ve = [
 			ref: d,
 			class: "kun-editor__bubble",
 			"data-show": "false"
-		}, [(m(!0), i(e, null, _(b.value, (t, n) => (m(), i(e, { key: n }, [t.divider ? (m(), i("span", Ee)) : (m(), i("button", {
+		}, [(m(!0), i(e, null, _(b.value, (t, n) => (m(), i(e, { key: n }, [t.divider ? (m(), i("span", De)) : (m(), i("button", {
 			key: 1,
 			type: "button",
 			class: "kun-editor__bubble-btn",
@@ -231,9 +231,9 @@ var X = Symbol("kun-editor-context"), ve = [
 		}, [a("span", {
 			class: "kun-editor__icon",
 			innerHTML: t.svg
-		}, null, 8, Oe)], 40, De))], 64))), 128))], 512));
+		}, null, 8, ke)], 40, Oe))], 64))), 128))], 512));
 	}
-}), Ae = /* @__PURE__ */ s({
+}), je = /* @__PURE__ */ s({
 	__name: "MilkdownEditor",
 	props: {
 		modelValue: {},
@@ -242,60 +242,65 @@ var X = Symbol("kun-editor-context"), ve = [
 		locale: {},
 		readonly: { type: Boolean },
 		placeholder: {},
+		placeholderMode: {},
 		selectionToolbar: { type: Boolean }
 	},
 	emits: ["update:modelValue"],
 	setup(e, { expose: t, emit: r }) {
-		let i = e, a = r, o = i.modelValue, s = M(), c = B("kunMention"), l = i.features.mention !== !1 && !!i.adapters.searchMentionUsers && !!s, u = H("kunSelectionTooltip"), d = i.selectionToolbar && !!s, f = O((e) => {
+		let i = e, a = r, o = i.modelValue, s = !1, c = M(), l = B("kunMention"), u = i.features.mention !== !1 && !!i.adapters.searchMentionUsers && !!c, d = H("kunSelectionTooltip"), f = i.selectionToolbar && !!c, p = O((e) => {
 			let t = N.make().config((t) => {
 				t.set(L, e), t.set(P, i.modelValue), t.get(R).markdownUpdated((e, t, n) => {
-					t !== n && (o = t, a("update:modelValue", t));
+					s || t === n || (o = t, a("update:modelValue", t));
 				}), t.update(I, (e) => ({
 					...e,
 					editable: () => !i.readonly
-				})), l && t.set(c.key, { view: s({ component: Te }) }), d && t.set(u.key, { view: s({ component: ke }) });
+				})), u && t.set(l.key, { view: c({ component: Ee }) }), f && t.set(d.key, { view: c({ component: Ae }) });
 			}).use(G(i.adapters, i.features, {
 				locale: i.locale,
-				placeholder: i.placeholder
+				placeholder: i.placeholder,
+				placeholderMode: i.placeholderMode
 			}));
-			return l && t.use(c), d && t.use(u), t;
+			return u && t.use(l), f && t.use(d), t;
 		});
 		S(() => i.modelValue, (e) => {
-			e !== o && (o = e, f.get()?.action(W(e)));
+			if (e === o) return;
+			o = e;
+			let t = p.get();
+			t && (s = !0, t.action(W(e)), s = !1);
 		}), S(() => i.readonly, () => {
-			f.get()?.action((e) => {
+			p.get()?.action((e) => {
 				let t = e.get(F);
 				t.dispatch(t.state.tr);
 			});
 		});
-		let p = () => {
-			f.get()?.action((e) => e.get(F).focus());
+		let h = () => {
+			p.get()?.action((e) => e.get(F).focus());
 		};
 		return t({
 			insertQuote: (e) => {
-				f.get()?.action(U(J.key, e)), p();
+				p.get()?.action(U(J.key, e)), h();
 			},
 			insertMention: (e) => {
-				f.get()?.action(U(q.key, e)), p();
+				p.get()?.action(U(q.key, e)), h();
 			},
-			focus: p
+			focus: h
 		}), (e, t) => (m(), n(b(E)));
 	}
-}), je = /* @__PURE__ */ "😀.😃.😄.😁.😆.😅.🤣.😂.🙂.🙃.😉.😊.😇.🥰.😍.🤩.😘.😗.😚.😋.😛.😜.🤪.😝.🤗.🤭.🤔.🤐.😐.😑.😶.😏.😒.🙄.😬.😌.😔.😪.🤤.😴.😷.🤒.🤕.🥵.🥶.🥴.😵.🤯.🤠.🥳.😎.🤓.🧐.😕.😟.🙁.😮.😯.😲.😳.🥺.😦.😧.😨.😰.😥.😢.😭.😱.😖.😣.😞.😓.😩.😫.🥱.😤.😡.😠.🤬.😈.👿.💀.💩.🤡.👻.👽.🤖.😺.😸.👍.👎.👌.🤌.🤏.✌️.🤞.🤟.🤘.👋.🤚.🖐️.✋.👏.🙌.🤝.🙏.💪.👀.👁️.❤️.🧡.💛.💚.💙.💜.🖤.🤍.💔.💕.💞.💓.💗.💖.💘.💝.💯.✨.⭐.🌟.🔥.💥.💫.⚡.☀️.🌈.🎉.🎊.🎁.🏆.🐶.🐱.🐭.🦊.🐻.🐼.🐨.🦄.🐢.🐳.🍎.🍑.🍓.🍉.🍰.🍺.🍵.☕.🍜.🍙.✅.❌.❓.❗.💤.👑.🎮.🎵.📌.🔖".split("."), Me = [
+}), Me = /* @__PURE__ */ "😀.😃.😄.😁.😆.😅.🤣.😂.🙂.🙃.😉.😊.😇.🥰.😍.🤩.😘.😗.😚.😋.😛.😜.🤪.😝.🤗.🤭.🤔.🤐.😐.😑.😶.😏.😒.🙄.😬.😌.😔.😪.🤤.😴.😷.🤒.🤕.🥵.🥶.🥴.😵.🤯.🤠.🥳.😎.🤓.🧐.😕.😟.🙁.😮.😯.😲.😳.🥺.😦.😧.😨.😰.😥.😢.😭.😱.😖.😣.😞.😓.😩.😫.🥱.😤.😡.😠.🤬.😈.👿.💀.💩.🤡.👻.👽.🤖.😺.😸.👍.👎.👌.🤌.🤏.✌️.🤞.🤟.🤘.👋.🤚.🖐️.✋.👏.🙌.🤝.🙏.💪.👀.👁️.❤️.🧡.💛.💚.💙.💜.🖤.🤍.💔.💕.💞.💓.💗.💖.💘.💝.💯.✨.⭐.🌟.🔥.💥.💫.⚡.☀️.🌈.🎉.🎊.🎁.🏆.🐶.🐱.🐭.🦊.🐻.🐼.🐨.🦄.🐢.🐳.🍎.🍑.🍓.🍉.🍰.🍺.🍵.☕.🍜.🍙.✅.❌.❓.❗.💤.👑.🎮.🎵.📌.🔖".split("."), Ne = [
 	"title",
 	"aria-label",
 	"aria-expanded"
-], Ne = ["innerHTML"], Pe = { class: "kun-editor__picker-panel" }, Fe = {
+], Pe = ["innerHTML"], Fe = { class: "kun-editor__picker-panel" }, Ie = {
 	key: 0,
 	class: "kun-editor__picker-tabs",
 	role: "tablist"
-}, Ie = ["data-active"], Le = ["data-active"], Re = { class: "kun-editor__emoji-grid" }, ze = ["onClick"], Be = {
+}, Le = ["data-active"], Re = ["data-active"], ze = { class: "kun-editor__emoji-grid" }, Be = ["onClick"], Ve = {
 	key: 1,
 	class: "kun-editor__sticker-body"
-}, Ve = { class: "kun-editor__pack-name" }, He = { class: "kun-editor__sticker-grid" }, Ue = ["title", "onClick"], We = ["src", "alt"], Ge = {
+}, He = { class: "kun-editor__pack-name" }, Ue = { class: "kun-editor__sticker-grid" }, We = ["title", "onClick"], Ge = ["src", "alt"], Ke = {
 	key: 1,
 	class: "kun-editor__picker-hint"
-}, Ke = /* @__PURE__ */ s({
+}, qe = /* @__PURE__ */ s({
 	__name: "StickerPicker",
 	setup(n) {
 		let [, o] = k(), s = l(X), c = s?.adapters.stickerSource, u = !!c, d = t(() => (s?.locale ?? "zh-cn").toLowerCase().startsWith("en")), h = t(() => d.value ? {
@@ -351,28 +356,28 @@ var X = Symbol("kun-editor-context"), ve = [
 		}, [a("span", {
 			class: "kun-editor__icon",
 			innerHTML: b($).smile
-		}, null, 8, Ne)], 8, Me), w(a("div", Pe, [
-			u ? (m(), i("div", Fe, [a("button", {
+		}, null, 8, Pe)], 8, Ne), w(a("div", Fe, [
+			u ? (m(), i("div", Ie, [a("button", {
 				type: "button",
 				class: "kun-editor__picker-tab",
 				"data-active": C.value === "emoji",
 				onClick: n[0] ||= (e) => C.value = "emoji"
-			}, y(h.value.emoji), 9, Ie), a("button", {
+			}, y(h.value.emoji), 9, Le), a("button", {
 				type: "button",
 				class: "kun-editor__picker-tab",
 				"data-active": C.value === "sticker",
 				onClick: n[1] ||= (e) => C.value = "sticker"
-			}, y(h.value.sticker), 9, Le)])) : r("", !0),
-			w(a("div", Re, [(m(!0), i(e, null, _(b(je), (e, t) => (m(), i("button", {
+			}, y(h.value.sticker), 9, Re)])) : r("", !0),
+			w(a("div", ze, [(m(!0), i(e, null, _(b(Me), (e, t) => (m(), i("button", {
 				key: t,
 				type: "button",
 				class: "kun-editor__emoji",
 				onClick: (t) => M(e)
-			}, y(e), 9, ze))), 128))], 512), [[x, !u || C.value === "emoji"]]),
-			u ? w((m(), i("div", Be, [T.value.length ? (m(!0), i(e, { key: 0 }, _(T.value, (t) => (m(), i("div", {
+			}, y(e), 9, Be))), 128))], 512), [[x, !u || C.value === "emoji"]]),
+			u ? w((m(), i("div", Ve, [T.value.length ? (m(!0), i(e, { key: 0 }, _(T.value, (t) => (m(), i("div", {
 				key: t.name,
 				class: "kun-editor__pack"
-			}, [a("div", Ve, y(t.name), 1), a("div", He, [(m(!0), i(e, null, _(t.stickers, (e, t) => (m(), i("button", {
+			}, [a("div", He, y(t.name), 1), a("div", Ue, [(m(!0), i(e, null, _(t.stickers, (e, t) => (m(), i("button", {
 				key: t,
 				type: "button",
 				class: "kun-editor__sticker",
@@ -382,21 +387,21 @@ var X = Symbol("kun-editor-context"), ve = [
 				src: e.src,
 				alt: e.name,
 				loading: "lazy"
-			}, null, 8, We)], 8, Ue))), 128))])]))), 128)) : (m(), i("div", Ge, y(D.value ? h.value.failed : h.value.empty), 1))], 512)), [[x, C.value === "sticker"]]) : r("", !0)
+			}, null, 8, Ge)], 8, We))), 128))])]))), 128)) : (m(), i("div", Ke, y(D.value ? h.value.failed : h.value.empty), 1))], 512)), [[x, C.value === "sticker"]]) : r("", !0)
 		], 512), [[x, v.value]])], 512));
 	}
-}), qe = {
+}), Je = {
 	class: "kun-editor__format-toolbar",
 	role: "toolbar"
-}, Je = ["aria-label"], Ye = {
+}, Ye = ["aria-label"], Xe = {
 	value: "",
 	disabled: "",
 	selected: ""
-}, Xe = ["value"], Ze = [
+}, Ze = ["value"], Qe = [
 	"title",
 	"aria-label",
 	"onClick"
-], Qe = ["innerHTML"], $e = ["title", "aria-label"], et = ["innerHTML"], tt = /* @__PURE__ */ s({
+], $e = ["innerHTML"], et = ["title", "aria-label"], tt = ["innerHTML"], nt = /* @__PURE__ */ s({
 	__name: "EditorToolbar",
 	setup(n) {
 		let [, s] = k(), c = l(X), u = t(() => c?.adapters.uploadImage), d = t(() => c?.features.sticker !== !1), f = t(() => (c?.locale ?? "zh-cn").toLowerCase().startsWith("en")), p = (e, t) => {
@@ -501,15 +506,15 @@ var X = Symbol("kun-editor-context"), ve = [
 				});
 			});
 		};
-		return (t, n) => (m(), i("div", qe, [
+		return (t, n) => (m(), i("div", Je, [
 			a("select", {
 				class: "kun-editor__heading-select",
 				"aria-label": h.value.textSize,
 				onChange: x
-			}, [a("option", Ye, y(h.value.textSize), 1), (m(!0), i(e, null, _(v.value, (e) => (m(), i("option", {
+			}, [a("option", Xe, y(h.value.textSize), 1), (m(!0), i(e, null, _(v.value, (e) => (m(), i("option", {
 				key: e.level,
 				value: e.level
-			}, y(e.label), 9, Xe))), 128))], 40, Je),
+			}, y(e.label), 9, Ze))), 128))], 40, Ye),
 			(m(!0), i(e, null, _(S.value, (t, r) => (m(), i(e, { key: r }, [n[0] ||= a("span", {
 				class: "kun-editor__toolbar-divider",
 				"aria-hidden": "true"
@@ -523,7 +528,7 @@ var X = Symbol("kun-editor-context"), ve = [
 			}, [a("span", {
 				class: "kun-editor__icon",
 				innerHTML: e.svg
-			}, null, 8, Qe)], 8, Ze))), 128))], 64))), 128)),
+			}, null, 8, $e)], 8, Qe))), 128))], 64))), 128)),
 			u.value ? (m(), i(e, { key: 0 }, [
 				n[1] ||= a("span", {
 					class: "kun-editor__toolbar-divider",
@@ -538,7 +543,7 @@ var X = Symbol("kun-editor-context"), ve = [
 				}, [a("span", {
 					class: "kun-editor__icon",
 					innerHTML: b($).image
-				}, null, 8, et)], 8, $e),
+				}, null, 8, tt)], 8, et),
 				a("input", {
 					ref_key: "fileInput",
 					ref: C,
@@ -551,10 +556,10 @@ var X = Symbol("kun-editor-context"), ve = [
 			d.value ? (m(), i(e, { key: 1 }, [n[2] ||= a("span", {
 				class: "kun-editor__toolbar-divider",
 				"aria-hidden": "true"
-			}, null, -1), o(Ke)], 64)) : r("", !0)
+			}, null, -1), o(qe)], 64)) : r("", !0)
 		]));
 	}
-}), nt = /* @__PURE__ */ s({
+}), rt = /* @__PURE__ */ s({
 	__name: "ToolbarHost",
 	setup(e) {
 		let [, t] = k(), n = l(X, void 0), r = (e, n) => {
@@ -598,7 +603,7 @@ var X = Symbol("kun-editor-context"), ve = [
 		};
 		return (e, t) => v(e.$slots, "default", d(c(a)));
 	}
-}), rt = /* @__PURE__ */ s({
+}), it = /* @__PURE__ */ s({
 	__name: "MarkdownSource",
 	props: {
 		modelValue: {},
@@ -606,47 +611,60 @@ var X = Symbol("kun-editor-context"), ve = [
 	},
 	emits: ["update:modelValue"],
 	setup(e, { emit: t }) {
-		let n = e, r = t, a = g(null), o = null, s = (e) => he.create({
+		let n = e, r = t, a = g(null), o = null, s = he.define(), c = (e) => ge.create({
 			doc: e,
 			extensions: [
 				ee(),
 				Y.lineWrapping,
-				_e,
-				ge(),
+				ve,
+				_e(),
 				Y.editable.of(!n.readonly),
 				Y.updateListener.of((e) => {
-					e.docChanged && r("update:modelValue", e.state.doc.toString());
+					e.docChanged && !e.transactions.some((e) => e.annotation(s)) && r("update:modelValue", e.state.doc.toString());
 				})
 			]
 		});
 		return p(() => {
 			a.value && (o = new Y({
-				state: s(n.modelValue),
+				state: c(n.modelValue),
 				parent: a.value
 			}));
 		}), f(() => {
 			o?.destroy(), o = null;
 		}), S(() => n.modelValue, (e) => {
-			o && o.state.doc.toString() !== e && o.setState(s(e));
+			if (!o || o.state.doc.toString() === e) return;
+			let { anchor: t, head: n } = o.state.selection.main, r = e.length;
+			o.dispatch({
+				changes: {
+					from: 0,
+					to: o.state.doc.length,
+					insert: e
+				},
+				selection: {
+					anchor: Math.min(t, r),
+					head: Math.min(n, r)
+				},
+				annotations: s.of(!0)
+			});
 		}), (e, t) => (m(), i("div", {
 			ref_key: "host",
 			ref: a,
 			class: "kun-editor__source"
 		}, null, 512));
 	}
-}), it = ["data-mode"], at = {
+}), at = ["data-mode"], ot = {
 	key: 0,
 	class: "kun-editor__toolbar",
 	role: "tablist"
-}, ot = [
+}, st = [
 	"aria-selected",
 	"data-active",
 	"onClick"
-], st = ["title", "aria-label"], ct = [
+], ct = ["title", "aria-label"], lt = [
 	"data-active",
 	"title",
 	"aria-pressed"
-], lt = ["data-swap"], ut = { class: "kun-editor__wysiwyg kun-editor__pane" }, dt = /* @__PURE__ */ s({
+], ut = ["data-swap"], dt = { class: "kun-editor__wysiwyg kun-editor__pane" }, ft = /* @__PURE__ */ s({
 	__name: "KunEditor",
 	props: {
 		modelValue: {},
@@ -658,6 +676,7 @@ var X = Symbol("kun-editor-context"), ve = [
 			default: !1
 		},
 		placeholder: { default: "" },
+		placeholderMode: { default: "doc" },
 		views: { default: () => [
 			"wysiwyg",
 			"source",
@@ -763,41 +782,41 @@ var X = Symbol("kun-editor-context"), ve = [
 			swap: P,
 			scrollSync: F.value,
 			toggleScrollSync: I
-		}, () => [s.views.length > 1 ? (m(), i("div", at, [(m(!0), i(e, null, _(s.views, (e) => (m(), i("button", {
+		}, () => [s.views.length > 1 ? (m(), i("div", ot, [(m(!0), i(e, null, _(s.views, (e) => (m(), i("button", {
 			key: e,
 			type: "button",
 			class: "kun-editor__tab",
 			"aria-selected": j.value === e,
 			"data-active": j.value === e,
 			onClick: (t) => M(e)
-		}, y(R.value[e]), 9, ot))), 128)), j.value === "split" ? (m(), i(e, { key: 0 }, [a("button", {
+		}, y(R.value[e]), 9, st))), 128)), j.value === "split" ? (m(), i(e, { key: 0 }, [a("button", {
 			type: "button",
 			class: "kun-editor__tab kun-editor__swap",
 			title: R.value.swap,
 			"aria-label": R.value.swap,
 			onClick: l[0] ||= (e) => P()
-		}, " ⇄ ", 8, st), a("button", {
+		}, " ⇄ ", 8, ct), a("button", {
 			type: "button",
 			class: "kun-editor__tab",
 			"data-active": F.value,
 			title: R.value.scrollSync,
 			"aria-pressed": F.value,
 			onClick: l[1] ||= (e) => I()
-		}, y(R.value.scrollSync), 9, ct)], 64)) : r("", !0)])) : r("", !0)]), o(b(D), null, {
+		}, y(R.value.scrollSync), 9, lt)], 64)) : r("", !0)])) : r("", !0)]), o(b(D), null, {
 			default: C(() => [o(b(A), null, {
-				default: C(() => [w(a("div", null, [o(nt, null, {
-					default: C((e) => [v(t.$slots, "toolbar", d(c(e)), () => [o(tt)])]),
+				default: C(() => [w(a("div", null, [o(rt, null, {
+					default: C((e) => [v(t.$slots, "toolbar", d(c(e)), () => [o(nt)])]),
 					_: 3
 				})], 512), [[x, j.value === "wysiwyg" && !s.readonly]]), a("div", {
 					class: "kun-editor__panes",
 					"data-swap": N.value
-				}, [j.value === "source" || j.value === "split" ? (m(), n(rt, {
+				}, [j.value === "source" || j.value === "split" ? (m(), n(it, {
 					key: 0,
 					class: "kun-editor__pane",
 					"model-value": s.modelValue,
 					readonly: s.readonly,
 					"onUpdate:modelValue": K
-				}, null, 8, ["model-value", "readonly"])) : r("", !0), w(a("div", ut, [o(Ae, {
+				}, null, 8, ["model-value", "readonly"])) : r("", !0), w(a("div", dt, [o(je, {
 					ref_key: "inner",
 					ref: q,
 					"model-value": s.modelValue,
@@ -806,6 +825,7 @@ var X = Symbol("kun-editor-context"), ve = [
 					locale: s.locale,
 					readonly: G.value,
 					placeholder: s.placeholder,
+					"placeholder-mode": s.placeholderMode,
 					"selection-toolbar": k.value,
 					"onUpdate:modelValue": K
 				}, null, 8, [
@@ -815,15 +835,16 @@ var X = Symbol("kun-editor-context"), ve = [
 					"locale",
 					"readonly",
 					"placeholder",
+					"placeholder-mode",
 					"selection-toolbar"
-				])], 512), [[x, j.value === "wysiwyg" || j.value === "split"]])], 8, lt)]),
+				])], 512), [[x, j.value === "wysiwyg" || j.value === "split"]])], 8, ut)]),
 				_: 3
 			})]),
 			_: 3
-		})], 8, it));
+		})], 8, at));
 	}
-}), ft = { install(e) {
-	e.component("KunEditor", dt);
+}), pt = { install(e) {
+	e.component("KunEditor", ft);
 } };
 //#endregion
-export { je as EMOJI, dt as KunEditor, ft as KunEditorPlugin };
+export { Me as EMOJI, ft as KunEditor, pt as KunEditorPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/editor-vue",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "description": "KunEditor Vue 3 layer — the headless <KunEditor> component (dual WYSIWYG / markdown-source), toolbar and plugin views. Ships zero CSS and no UI-kit dependency; consumes @kungal/editor-core, and pairs with @kungal/editor-nuxt for optional KunUI chrome.",
   "type": "module",
   "keywords": [
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@prosemirror-adapter/vue": "^0.4.6",
-    "@kungal/editor-core": "0.24.0"
+    "@kungal/editor-core": "0.25.1"
   },
   "peerDependencies": {
     "@codemirror/lang-markdown": "^6.0.0",
@@ -80,7 +80,7 @@
     "vite": "^8.0.16",
     "vue": "^3.5.35",
     "vue-tsc": "^3.3.3",
-    "@kungal/editor-core": "0.24.0"
+    "@kungal/editor-core": "0.25.1"
   },
   "scripts": {
     "build": "vite build && vue-tsc -p tsconfig.build.json",