@kungal/editor-vue 0.28.0 → 0.29.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @kungal/editor-vue
 
+## 0.29.0
+
+### Minor Changes
+
+- 8609e53: Add an `insertImage({ src })` primitive so hosts can build a rich image dialog.
+
+  The editor already had `uploadImage(file)` (adapter-backed, in-document
+  "uploading…" placeholder). The missing piece for a custom image dialog — insert by
+  URL, or re-insert from an upload history — was a way to insert an image from a
+  ready URL. Added:
+
+  - `KunEditorToolbarApi.insertImage({ src, alt?, title? })` — for a dialog dropped
+    into the `#toolbar` slot.
+  - `KunEditorExpose.insertImage(...)` and `KunEditorExpose.uploadImage(file)` — the
+    same two, on the `<KunEditor>` template ref, to drive image insertion from
+    anywhere.
+
+  The dialog UI (KunPopover, drag-drop, "recent" history) stays entirely the host's,
+  matching the headless design and how TipTap/ProseMirror split this
+  (`setImage(url)` command + host-provided upload UI). Drop the built-in image
+  button with `:items` and render your own next to `<KunEditorToolbar>`.
+
+  Verified in a new docs example (`/examples/image-dialog`): a host dialog inserts
+  by URL (`api.insertImage`), uploads one or many picked files via the host's own
+  uploader then inserts each, keeps a "recent" history, and re-inserts on click; the
+  built-in image button is dropped via `:items`; 0 console errors.
+
+### Patch Changes
+
+- @kungal/editor-core@0.29.0
+
 ## 0.28.0
 
 ### Minor Changes

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

@@ -56,6 +56,11 @@ declare var __VLS_1: {
     run: <T>(key: import("@milkdown/kit/core").CmdKey<T>, payload?: T) => void;
     insertText: (text: string) => void;
     uploadImage: (file: File) => void;
+    insertImage: (payload: {
+        src: string;
+        alt?: string;
+        title?: string;
+    }) => void;
     insertLink: (payload: {
         href: string;
         text?: string;

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":"AAgYA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,MAAM,qBAAqB,CAAA;AAO5B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAUjE,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;AAwbJ,QAAA,IAAI,OAAO;;iBApXS,QAAQ;;;;;;;;;;;;;CAoXP,EAAE,QAAQ;iEAtf/B,CAjWE;;;;;YAiWF,CA7UiC;;;;;;;;;;;;;;CAm0BoD,CAAE;AACvF,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;AAShD,QAAA,MAAM,UAAU;;;;;;;cAneD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;iBAEJ,MAAM;qBAMF,KAAK,GAAG,OAAO;sBAgBd,OAAO,GAAG,gBAAgB,EAAE;WAVvC,QAAQ,EAAE;gBAGL,OAAO;6EAidtB,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":"AAkYA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACX,MAAM,qBAAqB,CAAA;AAO5B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAUjE,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;AA0bJ,QAAA,IAAI,OAAO;;iBAtXS,QAAQ;;;;;;;;;;;;;CAsXP,EAAE,QAAQ;iEAxf/B,CAnWE;;;;;WAmWF,CA5UQ;aA4UR,CA5UwB;;;;YA4UxB,CAxUkD;;;;;;;;;;;;;;CAg0BmC,CAAE;AACvF,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;AAShD,QAAA,MAAM,UAAU;;;;;;;cAreD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;iBAEJ,MAAM;qBAMF,KAAK,GAAG,OAAO;sBAgBd,OAAO,GAAG,gBAAgB,EAAE;WAVvC,QAAQ,EAAE;gBAGL,OAAO;6EAmdtB,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/MilkdownEditor.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MilkdownEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/MilkdownEditor.vue"],"names":[],"mappings":"AA0QA,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;IACzB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB,CAAC;AAiNF,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":"AAwSA,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;IACzB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB,CAAC;AA2OF,QAAA,MAAM,YAAY;;;;kFAIhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

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

@@ -3,6 +3,11 @@ declare var __VLS_1: {
     run: <T>(key: CmdKey<T>, payload?: T) => void;
     insertText: (text: string) => void;
     uploadImage: (file: File) => void;
+    insertImage: (payload: {
+        src: string;
+        alt?: string;
+        title?: string;
+    }) => void;
     insertLink: (payload: {
         href: string;
         text?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"ToolbarHost.vue.d.ts","sourceRoot":"","sources":["../../src/components/ToolbarHost.vue"],"names":[],"mappings":"AA+FA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AA6FhD,QAAA,IAAI,OAAO;oCA9FX,CA1DqB;;;;;YA0DrB,CAvC2C;;;;;;;;;;;;;;CAqIrB,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAG/C,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"ToolbarHost.vue.d.ts","sourceRoot":"","sources":["../../src/components/ToolbarHost.vue"],"names":[],"mappings":"AAyGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAuGhD,QAAA,IAAI,OAAO;oCAxGX,CAvEmB;;;;;WAuEnB,CA9CE;aA8CF,CA9CkB;;;;YA8ClB,CAtCc;;;;;;;;;;;;;;CA8IQ,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAG/C,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/index.js

@@ -2,14 +2,14 @@ import { Fragment as e, computed as t, createBlock as n, createCommentVNode as r
 import { Milkdown as E, MilkdownProvider as D, useEditor as O, useInstance as k } from "@milkdown/vue";
 import { ProsemirrorAdapterProvider as A, usePluginViewContext as j, usePluginViewFactory as M } from "@prosemirror-adapter/vue";
 import { parseHeadings as N, parseHeadings as ee } from "@kungal/editor-core";
-import { Editor as P, defaultValueCtx as F, editorViewCtx as I, editorViewOptionsCtx as L, rootCtx as R } from "@milkdown/kit/core";
-import { listenerCtx as z } from "@milkdown/kit/plugin/listener";
-import { SlashProvider as B, slashFactory as V } from "@milkdown/kit/plugin/slash";
-import { TooltipProvider as H, tooltipFactory as U } from "@milkdown/kit/plugin/tooltip";
-import { callCommand as W, replaceAll as te } from "@milkdown/kit/utils";
-import { TextSelection as G } from "@milkdown/kit/prose/state";
-import { createKunEditorPlugins as K, insertKunSpoilerCommand as q, insertLinkCommand as J, insertMentionCommand as ne, insertQuoteCommand as re, kunCM as ie, mentionId as ae, setHeadingCommand as oe, startImageUpload as se } from "@kungal/editor-core/preset";
-import { createCodeBlockCommand as ce, insertHrCommand as le, insertImageCommand as ue, toggleEmphasisCommand as de, toggleInlineCodeCommand as fe, toggleStrongCommand as pe, wrapInBlockquoteCommand as me, wrapInBulletListCommand as he, wrapInOrderedListCommand as ge } from "@milkdown/kit/preset/commonmark";
+import { Editor as P, defaultValueCtx as F, editorViewCtx as I, editorViewOptionsCtx as te, rootCtx as L } from "@milkdown/kit/core";
+import { listenerCtx as R } from "@milkdown/kit/plugin/listener";
+import { SlashProvider as z, slashFactory as B } from "@milkdown/kit/plugin/slash";
+import { TooltipProvider as V, tooltipFactory as H } from "@milkdown/kit/plugin/tooltip";
+import { callCommand as U, replaceAll as ne } from "@milkdown/kit/utils";
+import { TextSelection as W } from "@milkdown/kit/prose/state";
+import { createCodeBlockCommand as G, insertHrCommand as K, insertImageCommand as q, toggleEmphasisCommand as re, toggleInlineCodeCommand as ie, toggleStrongCommand as ae, wrapInBlockquoteCommand as oe, wrapInBulletListCommand as se, wrapInOrderedListCommand as ce } from "@milkdown/kit/preset/commonmark";
+import { createKunEditorPlugins as le, insertKunSpoilerCommand as ue, insertLinkCommand as J, insertMentionCommand as de, insertQuoteCommand as fe, kunCM as pe, mentionId as me, setHeadingCommand as he, startImageUpload as ge } from "@kungal/editor-core/preset";
 import { toggleStrikethroughCommand as _e } from "@milkdown/kit/preset/gfm";
 import { Annotation as ve, EditorState as ye } from "@codemirror/state";
 import { EditorView as Y } from "@codemirror/view";
@@ -75,13 +75,13 @@ var X = Symbol("kun-editor-context"), Se = [
 		}, F = (e) => {
 			let t = d.value;
 			if (!t || !O) return;
-			let n = t.state.schema.nodes[ae];
+			let n = t.state.schema.nodes[me];
 			if (!n) return;
 			let r = n.create({
 				userId: e.id,
 				name: e.name
 			}), { from: i, to: a } = O, o = t.state.tr.replaceWith(i, a, r), s = i + r.nodeSize;
-			o.insertText(" ", s), o.setSelection(G.create(o.doc, s + 1)), t.dispatch(o.scrollIntoView()), t.focus(), b.hide();
+			o.insertText(" ", s), o.setSelection(W.create(o.doc, s + 1)), t.dispatch(o.scrollIntoView()), t.focus(), b.hide();
 		}, I = (e) => {
 			if (!x.value || !w.value.length) {
 				x.value && e.key === "Escape" && (e.preventDefault(), b.hide());
@@ -107,7 +107,7 @@ var X = Symbol("kun-editor-context"), Se = [
 			}
 		};
 		return p(() => {
-			b = new B({
+			b = new z({
 				content: v.value,
 				trigger: "@",
 				shouldShow: P,
@@ -170,7 +170,7 @@ var X = Symbol("kun-editor-context"), Se = [
 	__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) => {
-			s()?.action(W(e, t));
+			s()?.action(U(e, t));
 		}, y = async () => {
 			let e = r.value, { from: t, to: n } = e?.state.selection ?? {
 				from: 0,
@@ -183,12 +183,12 @@ var X = Symbol("kun-editor-context"), Se = [
 				bold: {
 					svg: $.bold,
 					title: e ? "Bold" : "加粗",
-					run: () => v(pe.key)
+					run: () => v(ae.key)
 				},
 				italic: {
 					svg: $.italic,
 					title: e ? "Italic" : "斜体",
-					run: () => v(de.key)
+					run: () => v(re.key)
 				},
 				strike: {
 					svg: $.strike,
@@ -198,7 +198,7 @@ var X = Symbol("kun-editor-context"), Se = [
 				code: {
 					svg: $.code,
 					title: e ? "Inline code" : "行内代码",
-					run: () => v(fe.key)
+					run: () => v(ie.key)
 				},
 				link: {
 					svg: $.link,
@@ -222,7 +222,7 @@ var X = Symbol("kun-editor-context"), Se = [
 			return n;
 		});
 		return p(() => {
-			h = new H({
+			h = new V({
 				content: d.value,
 				offset: 8
 			}), h.update(r.value, o.value);
@@ -262,15 +262,15 @@ var X = Symbol("kun-editor-context"), Se = [
 	},
 	emits: ["update:modelValue"],
 	setup(e, { expose: t, emit: r }) {
-		let i = e, a = r, o = i.modelValue, s = !1, c = M(), l = V("kunMention"), u = i.features.mention !== !1 && !!i.adapters.searchMentionUsers && !!c, d = U("kunSelectionTooltip"), f = i.selectionToolbar && !!c, p = 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 = P.make().config((t) => {
-				t.set(R, e), t.set(F, i.modelValue), t.get(z).markdownUpdated((e, t, n) => {
+				t.set(L, e), t.set(F, i.modelValue), t.get(R).markdownUpdated((e, t, n) => {
 					!i.active || s || t === n || (o = t, a("update:modelValue", t));
-				}), t.update(L, (e) => ({
+				}), t.update(te, (e) => ({
 					...e,
 					editable: () => !i.readonly
 				})), u && t.set(l.key, { view: c({ component: ke }) }), f && t.set(d.key, { view: c({ component: Ne }) });
-			}).use(K(i.adapters, i.features, {
+			}).use(le(i.adapters, i.features, {
 				locale: i.locale,
 				placeholder: i.placeholder,
 				placeholderMode: i.placeholderMode
@@ -281,7 +281,7 @@ var X = Symbol("kun-editor-context"), Se = [
 			if (e === o) return;
 			o = e;
 			let t = p.get();
-			t && (s = !0, t.action(te(e)), s = !1);
+			t && (s = !0, t.action(ne(e)), s = !1);
 		}), S(() => i.readonly, () => {
 			p.get()?.action((e) => {
 				let t = e.get(I);
@@ -293,10 +293,27 @@ var X = Symbol("kun-editor-context"), Se = [
 		};
 		return t({
 			insertQuote: (e) => {
-				p.get()?.action(W(re.key, e)), h();
+				p.get()?.action(U(fe.key, e)), h();
 			},
 			insertMention: (e) => {
-				p.get()?.action(W(ne.key, e)), h();
+				p.get()?.action(U(de.key, e)), h();
+			},
+			insertImage: (e) => {
+				p.get()?.action(U(q.key, {
+					src: e.src,
+					alt: e.alt ?? "",
+					title: e.title ?? ""
+				})), h();
+			},
+			uploadImage: (e) => {
+				let t = i.adapters.uploadImage, n = p.get();
+				!t || !n || n.action((n) => {
+					ge(n.get(I), e, {
+						uploadImage: t,
+						notify: i.adapters.notify,
+						locale: i.locale
+					});
+				});
 			},
 			focus: h,
 			scrollToHeading: (e) => {
@@ -308,7 +325,7 @@ var X = Symbol("kun-editor-context"), Se = [
 						behavior: "smooth",
 						block: "start"
 					}), n.editable)) {
-						let e = G.near(n.state.doc.resolve(i + 1));
+						let e = W.near(n.state.doc.resolve(i + 1));
 						n.dispatch(n.state.tr.setSelection(e)), n.focus();
 					}
 				});
@@ -365,7 +382,7 @@ var X = Symbol("kun-editor-context"), Se = [
 				n.dispatch(r.tr.insertText(e, r.selection.from));
 			});
 		}, N = (e, t) => {
-			o()?.action(W(ue.key, {
+			o()?.action(U(q.key, {
 				src: e,
 				title: t,
 				alt: t
@@ -434,7 +451,7 @@ var X = Symbol("kun-editor-context"), Se = [
 	__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) => {
-			s()?.action(W(e, t));
+			s()?.action(U(e, t));
 		}, h = async () => {
 			let e = "";
 			s()?.action((t) => {
@@ -476,18 +493,18 @@ var X = Symbol("kun-editor-context"), Se = [
 			}));
 		}), S = (e) => {
 			let t = e.target;
-			p(oe.key, Number(t.value)), t.selectedIndex = 0;
+			p(he.key, Number(t.value)), t.selectedIndex = 0;
 		}, C = t(() => [
 			[
 				{
 					svg: $.bold,
 					title: v.value.bold,
-					run: () => p(pe.key)
+					run: () => p(ae.key)
 				},
 				{
 					svg: $.italic,
 					title: v.value.italic,
-					run: () => p(de.key)
+					run: () => p(re.key)
 				},
 				{
 					svg: $.strike,
@@ -497,7 +514,7 @@ var X = Symbol("kun-editor-context"), Se = [
 				{
 					svg: $.code,
 					title: v.value.code,
-					run: () => p(fe.key)
+					run: () => p(ie.key)
 				},
 				{
 					svg: $.link,
@@ -509,40 +526,40 @@ var X = Symbol("kun-editor-context"), Se = [
 				{
 					svg: $.bulletList,
 					title: v.value.bulletList,
-					run: () => p(he.key)
+					run: () => p(se.key)
 				},
 				{
 					svg: $.orderedList,
 					title: v.value.orderedList,
-					run: () => p(ge.key)
+					run: () => p(ce.key)
 				},
 				{
 					svg: $.quote,
 					title: v.value.quote,
-					run: () => p(me.key)
+					run: () => p(oe.key)
 				},
 				{
 					svg: $.codeBlock,
 					title: v.value.codeBlock,
-					run: () => p(ce.key, "")
+					run: () => p(G.key, "")
 				},
 				{
 					svg: $.hr,
 					title: v.value.hr,
-					run: () => p(le.key)
+					run: () => p(K.key)
 				}
 			],
 			[{
 				svg: $.spoiler,
 				title: v.value.spoiler,
-				run: () => p(q.key)
+				run: () => p(ue.key)
 			}]
 		]), w = g(null), T = () => w.value?.click(), E = (e) => {
 			let t = e.target, n = t.files?.[0];
 			t.value = "";
 			let r = u.value;
 			!n || !r || s()?.action((e) => {
-				se(e.get(I), n, {
+				ge(e.get(I), n, {
 					uploadImage: r,
 					notify: c?.adapters.notify,
 					locale: c?.locale
@@ -606,7 +623,7 @@ var X = Symbol("kun-editor-context"), Se = [
 	__name: "ToolbarHost",
 	setup(e) {
 		let [, t] = k(), n = l(X, void 0), r = (e, n) => {
-			t()?.action(W(e, n));
+			t()?.action(U(e, n));
 		}, i = () => {
 			t()?.action((e) => e.get(I).focus());
 		}, a = {
@@ -620,7 +637,7 @@ var X = Symbol("kun-editor-context"), Se = [
 			uploadImage: (e) => {
 				let r = n?.adapters.uploadImage, i = t();
 				!r || !i || i.action((t) => {
-					se(t.get(I), e, {
+					ge(t.get(I), e, {
 						uploadImage: r,
 						notify: n?.adapters.notify,
 						locale: n?.locale
@@ -630,11 +647,18 @@ var X = Symbol("kun-editor-context"), Se = [
 			insertLink: (e) => {
 				r(J.key, e), i();
 			},
+			insertImage: (e) => {
+				r(q.key, {
+					src: e.src,
+					alt: e.alt ?? "",
+					title: e.title ?? ""
+				}), i();
+			},
 			insertQuote: (e) => {
-				r(re.key, e), i();
+				r(fe.key, e), i();
 			},
 			insertMention: (e) => {
-				r(ne.key, e), i();
+				r(de.key, e), i();
 			},
 			focus: i,
 			get adapters() {
@@ -660,7 +684,7 @@ var X = Symbol("kun-editor-context"), Se = [
 		let r = e, a = n, o = g(null), s = null, c = ve.define(), l = (e) => ye.create({
 			doc: e,
 			extensions: [
-				ie(),
+				pe(),
 				Y.lineWrapping,
 				xe,
 				be(),
@@ -797,7 +821,7 @@ var X = Symbol("kun-editor-context"), Se = [
 		});
 		let I = () => {
 			F.value = !F.value;
-		}, L = t(() => E.locale.toLowerCase().startsWith("en")), R = t(() => L.value ? {
+		}, te = t(() => E.locale.toLowerCase().startsWith("en")), L = t(() => te.value ? {
 			wysiwyg: "Preview",
 			source: "Markdown",
 			split: "Split",
@@ -809,47 +833,49 @@ var X = Symbol("kun-editor-context"), Se = [
 			split: "分栏",
 			swap: "左右互换",
 			scrollSync: "同步滚动"
-		}), z = g(null), B = null, V = null, H = null, U = () => {
-			B?.(), B = null, V = null;
-		}, W = () => {
-			U();
-			let e = z.value;
+		}), R = g(null), z = null, B = null, V = null, H = () => {
+			z?.(), z = null, B = null;
+		}, U = () => {
+			H();
+			let e = R.value;
 			if (!e) return;
 			let t = e.querySelector(".cm-scroller"), n = e.querySelector(".kun-editor__wysiwyg");
 			if (!t || !n) return;
 			let r = (e, t) => () => {
-				if (V && V !== e) return;
-				V = e;
+				if (B && B !== e) return;
+				B = e;
 				let n = e.scrollHeight - e.clientHeight, r = n > 0 ? e.scrollTop / n : 0, i = t.scrollHeight - t.clientHeight;
-				t.scrollTop = r * (i > 0 ? i : 0), H && clearTimeout(H), H = setTimeout(() => {
-					V = null;
+				t.scrollTop = r * (i > 0 ? i : 0), V && clearTimeout(V), V = setTimeout(() => {
+					B = null;
 				}, 120);
 			}, i = r(t, n), a = r(n, t);
-			t.addEventListener("scroll", i, { passive: !0 }), n.addEventListener("scroll", a, { passive: !0 }), B = () => {
+			t.addEventListener("scroll", i, { passive: !0 }), n.addEventListener("scroll", a, { passive: !0 }), z = () => {
 				t.removeEventListener("scroll", i), n.removeEventListener("scroll", a);
 			};
 		};
 		S([j, F], ([e, t]) => {
-			U(), e === "split" && t && u(W);
-		}), f(U);
-		let te = t(() => E.readonly || j.value === "split"), G = (e) => O("update:modelValue", e), K = g(null), q = g(null);
+			H(), e === "split" && t && u(U);
+		}), f(H);
+		let ne = t(() => E.readonly || j.value === "split"), W = (e) => O("update:modelValue", e), G = g(null), K = g(null);
 		return l({
-			insertQuote: (e) => K.value?.insertQuote(e),
-			insertMention: (e) => K.value?.insertMention(e),
-			focus: () => K.value?.focus(),
+			insertQuote: (e) => G.value?.insertQuote(e),
+			insertMention: (e) => G.value?.insertMention(e),
+			insertImage: (e) => G.value?.insertImage(e),
+			uploadImage: (e) => G.value?.uploadImage(e),
+			focus: () => G.value?.focus(),
 			scrollToHeading: (e) => {
-				j.value === "source" || j.value === "split" ? q.value?.scrollToHeading(e) : K.value?.scrollToHeading(e);
+				j.value === "source" || j.value === "split" ? K.value?.scrollToHeading(e) : G.value?.scrollToHeading(e);
 			}
 		}), (t, l) => (m(), i("div", {
 			ref_key: "rootEl",
-			ref: z,
+			ref: R,
 			class: "kun-editor",
 			"data-kun-editor": "",
 			"data-mode": j.value
 		}, [v(t.$slots, "view-switch", {
 			mode: j.value,
 			setMode: M,
-			labels: R.value,
+			labels: L.value,
 			views: s.views,
 			swapped: N.value,
 			swap: P,
@@ -862,20 +888,20 @@ var X = Symbol("kun-editor-context"), Se = [
 			"aria-selected": j.value === e,
 			"data-active": j.value === e,
 			onClick: (t) => M(e)
-		}, y(R.value[e]), 9, ut))), 128)), j.value === "split" ? (m(), i(e, { key: 0 }, [a("button", {
+		}, y(L.value[e]), 9, ut))), 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,
+			title: L.value.swap,
+			"aria-label": L.value.swap,
 			onClick: l[0] ||= (e) => P()
 		}, " ⇄ ", 8, dt), a("button", {
 			type: "button",
 			class: "kun-editor__tab",
 			"data-active": F.value,
-			title: R.value.scrollSync,
+			title: L.value.scrollSync,
 			"aria-pressed": F.value,
 			onClick: l[1] ||= (e) => I()
-		}, y(R.value.scrollSync), 9, ft)], 64)) : r("", !0)])) : r("", !0)]), o(b(D), null, {
+		}, y(L.value.scrollSync), 9, ft)], 64)) : r("", !0)])) : r("", !0)]), o(b(D), null, {
 			default: C(() => [o(b(A), null, {
 				default: C(() => [w(a("div", null, [o(ot, null, {
 					default: C((e) => [v(t.$slots, "toolbar", d(c(e)), () => [o(at)])]),
@@ -886,24 +912,24 @@ var X = Symbol("kun-editor-context"), Se = [
 				}, [j.value === "source" || j.value === "split" ? (m(), n(st, {
 					key: 0,
 					ref_key: "source",
-					ref: q,
+					ref: K,
 					class: "kun-editor__pane",
 					"model-value": s.modelValue,
 					readonly: s.readonly,
-					"onUpdate:modelValue": G
+					"onUpdate:modelValue": W
 				}, null, 8, ["model-value", "readonly"])) : r("", !0), w(a("div", mt, [o(Pe, {
 					ref_key: "inner",
-					ref: K,
+					ref: G,
 					"model-value": s.modelValue,
 					adapters: s.adapters,
 					features: s.features,
 					locale: s.locale,
-					readonly: te.value,
+					readonly: ne.value,
 					placeholder: s.placeholder,
 					"placeholder-mode": s.placeholderMode,
 					active: j.value === "wysiwyg" && !s.readonly,
 					"selection-toolbar": k.value,
-					"onUpdate:modelValue": G
+					"onUpdate:modelValue": W
 				}, null, 8, [
 					"model-value",
 					"adapters",

package/dist/types.d.ts

@@ -13,6 +13,16 @@ export interface KunEditorToolbarApi {
      * removing it + notifying on failure. No-op without an `uploadImage` adapter.
      */
     uploadImage: (file: File) => void;
+    /**
+     * Insert an image node at the cursor from a ready URL — for a host-built image
+     * dialog (paste a URL, or re-insert from an upload history). For the upload path
+     * use `uploadImage`, or call your own upload adapter then this.
+     */
+    insertImage: (payload: {
+        src: string;
+        alt?: string;
+        title?: string;
+    }) => void;
     /**
      * Apply a link to the selection, or (empty selection) insert linked text.
      * `text` defaults to the href. Standard markdown `[text](href)`.
@@ -81,6 +91,17 @@ export interface KunEditorExpose {
         userId: number;
         name: string;
     }): void;
+    /** Insert an image at the cursor from a ready URL (a host-built image dialog). */
+    insertImage(payload: {
+        src: string;
+        alt?: string;
+        title?: string;
+    }): void;
+    /**
+     * Upload an image File via the `uploadImage` adapter (in-document "uploading…"
+     * placeholder, then the image). No-op without the adapter.
+     */
+    uploadImage(file: File): void;
     /** Focus the WYSIWYG editor. */
     focus(): void;
     /**

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/editor-vue",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "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.28.0"
+    "@kungal/editor-core": "0.29.0"
   },
   "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.28.0"
+    "@kungal/editor-core": "0.29.0"
   },
   "scripts": {
     "build": "vite build && vue-tsc -p tsconfig.build.json",