@kungal/editor-vue 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @kungal/editor-vue
 
+## 0.9.0
+
+### Minor Changes
+
+- 8b86a68: Add an imperative handle to `<KunEditor>` for cursor-level inserts.
+
+  A `<KunEditor>` template ref now exposes `KunEditorExpose`:
+
+  - `insertQuote({ refId, label })` — insert a reference atom
+    (`[label](kungal-reply:refId)`) at the caret (requires `features.quote`)
+  - `insertMention({ userId, name })` — insert an @mention atom at the caret
+  - `focus()` — focus the WYSIWYG editor
+
+  ```ts
+  const editor = ref<InstanceType<typeof KunEditor>>();
+  editor.value?.insertMention({ userId: 1, name: "Alice" });
+  editor.value?.insertQuote({ refId: "101", label: "#1" });
+  ```
+
+  This is what the forum's per-floor 「引用」 needs — a live, cursor-level insert of
+  `@author #floor` (each command inserts with a trailing space), rather than
+  editing the markdown string. Works in either view (the WYSIWYG editor stays
+  mounted in source mode too). Exported type: `KunEditorExpose`.
+
+### Patch Changes
+
+- @kungal/editor-core@0.9.0
+
 ## 0.8.0
 
 ### Minor Changes

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

@@ -1,4 +1,5 @@
 import type { KunEditorAdapters, KunEditorFeatures, KunEditorLocale } from '@kungal/editor-core';
+import type { KunEditorExpose } from '../types';
 type __VLS_Props = {
     /** Bound markdown (v-model). */
     modelValue: string;
@@ -11,7 +12,7 @@ type __VLS_Props = {
     /** Read-only render (no editing). */
     readonly?: boolean;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, KunEditorExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (markdown: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((markdown: string) => any) | undefined;

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":"AA6JA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,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;CACnB,CAAC;AAuMJ,QAAA,MAAM,YAAY;;;;;cA9MH,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;6EA4MpB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}
+{"version":3,"file":"KunEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/KunEditor.vue"],"names":[],"mappings":"AAkKA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAK5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,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;CACnB,CAAC;AAwNJ,QAAA,MAAM,YAAY;;;;;cA/NH,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;6EA8NpB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

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

@@ -1,4 +1,5 @@
 import type { KunEditorAdapters, KunEditorFeatures, KunEditorLocale } from '@kungal/editor-core';
+import type { KunEditorExpose } from '../types';
 type __VLS_Props = {
     modelValue: string;
     adapters: KunEditorAdapters;
@@ -6,7 +7,7 @@ type __VLS_Props = {
     locale: KunEditorLocale;
     readonly: boolean;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, KunEditorExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (markdown: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((markdown: string) => any) | undefined;

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":"AAkIA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAI5B,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;CAClB,CAAC;AA2GF,QAAA,MAAM,YAAY;;;;kFAGhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}
+{"version":3,"file":"MilkdownEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/MilkdownEditor.vue"],"names":[],"mappings":"AAwKA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAG5B,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;CAClB,CAAC;AA6HF,QAAA,MAAM,YAAY;;;;kFAIhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import type { Plugin } from 'vue';
 import KunEditor from './components/KunEditor.vue';
 export { KunEditor };
+export type { KunEditorExpose } from './types';
 export type { KunEditorAdapters, KunEditorFeatures, KunEditorLocale, UploadImage, SearchMentionUsers, StickerSource, Notify, NotifyLevel, MentionUser, StickerItem, StickerPack } from '@kungal/editor-core';
 /** Vue plugin: `app.use(KunEditorPlugin)` to register <KunEditor> globally. */
 export declare const KunEditorPlugin: Plugin;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAA;AACtC,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAElD,OAAO,EAAE,SAAS,EAAE,CAAA;AAGpB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACZ,MAAM,qBAAqB,CAAA;AAE5B,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,MAI7B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAA;AACtC,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAElD,OAAO,EAAE,SAAS,EAAE,CAAA;AAGpB,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG9C,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACZ,MAAM,qBAAqB,CAAA;AAE5B,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,MAI7B,CAAA"}

package/dist/index.js

@@ -3,34 +3,34 @@ import { Milkdown as S, MilkdownProvider as C, useEditor as w, useInstance as T
 import { ProsemirrorAdapterProvider as E, usePluginViewContext as D, usePluginViewFactory as O } from "@prosemirror-adapter/vue";
 import { Editor as k, defaultValueCtx as A, editorViewCtx as j, editorViewOptionsCtx as M, rootCtx as N } from "@milkdown/kit/core";
 import { listenerCtx as P } from "@milkdown/kit/plugin/listener";
-import { SlashProvider as ee, slashFactory as F } from "@milkdown/kit/plugin/slash";
-import { callCommand as I, replaceAll as L } from "@milkdown/kit/utils";
-import { createKunEditorPlugins as R, insertKunSpoilerCommand as te, kunCM as ne, mentionId as re, toggleLatexCommand as ie } from "@kungal/editor-core/preset";
-import { TextSelection as ae } from "@milkdown/kit/prose/state";
-import { createCodeBlockCommand as oe, insertHrCommand as se, insertImageCommand as z, toggleEmphasisCommand as B, toggleInlineCodeCommand as V, toggleStrongCommand as H, wrapInBlockquoteCommand as U, wrapInBulletListCommand as W, wrapInHeadingCommand as G, wrapInOrderedListCommand as K } from "@milkdown/kit/preset/commonmark";
-import { toggleStrikethroughCommand as ce } from "@milkdown/kit/preset/gfm";
-import { EditorState as le } from "@codemirror/state";
+import { SlashProvider as F, slashFactory as I } from "@milkdown/kit/plugin/slash";
+import { callCommand as L, replaceAll as R } from "@milkdown/kit/utils";
+import { createKunEditorPlugins as ee, insertKunSpoilerCommand as te, insertMentionCommand as ne, insertQuoteCommand as re, kunCM as ie, mentionId as ae, toggleLatexCommand as oe } from "@kungal/editor-core/preset";
+import { TextSelection as se } from "@milkdown/kit/prose/state";
+import { createCodeBlockCommand as ce, insertHrCommand as z, insertImageCommand as B, toggleEmphasisCommand as V, toggleInlineCodeCommand as H, toggleStrongCommand as U, wrapInBlockquoteCommand as W, wrapInBulletListCommand as G, wrapInHeadingCommand as K, wrapInOrderedListCommand as le } from "@milkdown/kit/preset/commonmark";
+import { toggleStrikethroughCommand as ue } from "@milkdown/kit/preset/gfm";
+import { EditorState as de } from "@codemirror/state";
 import { EditorView as q } from "@codemirror/view";
-import { markdown as ue } from "@codemirror/lang-markdown";
-import { basicSetup as de } from "codemirror";
+import { markdown as fe } from "@codemirror/lang-markdown";
+import { basicSetup as pe } from "codemirror";
 //#region src/context.ts
-var J = Symbol("kun-editor-context"), fe = [
+var J = Symbol("kun-editor-context"), me = [
 	"data-active",
 	"onMousedown",
 	"onMouseenter"
-], pe = ["src", "alt"], me = {
+], he = ["src", "alt"], ge = {
 	key: 1,
 	class: "kun-mention-dropdown__avatar kun-mention-dropdown__avatar--fallback"
-}, he = { class: "kun-mention-dropdown__name" }, ge = {
+}, _e = { class: "kun-mention-dropdown__name" }, ve = {
 	key: 1,
 	class: "kun-mention-dropdown__hint"
-}, _e = {
+}, ye = {
 	key: 2,
 	class: "kun-mention-dropdown__hint"
-}, ve = {
+}, be = {
 	key: 3,
 	class: "kun-mention-dropdown__hint"
-}, ye = /* @__PURE__ */ s({
+}, xe = /* @__PURE__ */ s({
 	__name: "MentionDropdown",
 	setup(n) {
 		let r = /(?:^|\s)@([^\s@]{0,30})$/, o = c(J), s = o?.adapters.searchMentionUsers, f = t(() => (o?.locale ?? "zh-cn").toLowerCase().startsWith("en")), g = t(() => f.value ? {
@@ -62,7 +62,7 @@ var J = Symbol("kun-editor-context"), fe = [
 			if (!t.empty) return null;
 			let { $from: n } = t, i = n.parent.textBetween(Math.max(0, n.parentOffset - 100), n.parentOffset, void 0, "").match(r);
 			return i ? i[1] ?? "" : null;
-		}, F = (e) => {
+		}, I = (e) => {
 			let t = P(e);
 			if (t === null) return !1;
 			let n = e.state.selection.$from.pos;
@@ -70,17 +70,17 @@ var J = Symbol("kun-editor-context"), fe = [
 				from: n - (t.length + 1),
 				to: n
 			}, t !== w.value && (w.value = t, N(t)), !0;
-		}, I = (e) => {
+		}, L = (e) => {
 			let t = _.value;
 			if (!t || !k) return;
-			let n = t.state.schema.nodes[re];
+			let n = t.state.schema.nodes[ae];
 			if (!n) return;
 			let r = n.create({
 				userId: e.id,
 				name: e.name
 			}), { from: i, to: a } = k, o = t.state.tr.replaceWith(i, a, r), s = i + r.nodeSize;
-			o.insertText(" ", s), o.setSelection(ae.create(o.doc, s + 1)), t.dispatch(o.scrollIntoView()), t.focus(), S.hide();
-		}, L = (e) => {
+			o.insertText(" ", s), o.setSelection(se.create(o.doc, s + 1)), t.dispatch(o.scrollIntoView()), t.focus(), S.hide();
+		}, R = (e) => {
 			if (!C.value || !T.value.length) {
 				C.value && e.key === "Escape" && (e.preventDefault(), S.hide());
 				return;
@@ -96,7 +96,7 @@ var J = Symbol("kun-editor-context"), fe = [
 				case "Enter":
 				case "Tab": {
 					let t = T.value[E.value];
-					t && (e.preventDefault(), e.stopPropagation(), I(t));
+					t && (e.preventDefault(), e.stopPropagation(), L(t));
 					break;
 				}
 				case "Escape":
@@ -105,20 +105,20 @@ var J = Symbol("kun-editor-context"), fe = [
 			}
 		};
 		return u(() => {
-			S = new ee({
+			S = new F({
 				content: b.value,
 				trigger: "@",
-				shouldShow: F,
+				shouldShow: I,
 				debounce: 0
 			}), S.onShow = () => {
 				C.value = !0;
 			}, S.onHide = () => {
 				C.value = !1, M();
-			}, S.update(_.value, y.value), window.addEventListener("keydown", L, !0);
+			}, S.update(_.value, y.value), window.addEventListener("keydown", R, !0);
 		}), v([_, y], () => {
 			S?.update(_.value, y.value);
 		}), l(() => {
-			j && clearTimeout(j), window.removeEventListener("keydown", L, !0), S?.destroy();
+			j && clearTimeout(j), window.removeEventListener("keydown", R, !0), S?.destroy();
 		}), (t, n) => (d(), i("div", {
 			ref_key: "divRef",
 			ref: b,
@@ -129,16 +129,16 @@ var J = Symbol("kun-editor-context"), fe = [
 			type: "button",
 			class: "kun-mention-dropdown__item",
 			"data-active": t === E.value,
-			onMousedown: x((t) => I(e), ["prevent"]),
+			onMousedown: x((t) => L(e), ["prevent"]),
 			onMouseenter: (e) => E.value = t
 		}, [e.avatar ? (d(), i("img", {
 			key: 0,
 			src: e.avatar,
 			alt: e.name,
 			class: "kun-mention-dropdown__avatar"
-		}, null, 8, pe)) : (d(), i("span", me, h(e.name.charAt(0)), 1)), a("span", he, h(e.name), 1)], 40, fe))), 128)) : O.value ? (d(), i("div", ge, h(g.value.searching), 1)) : w.value ? (d(), i("div", _e, h(g.value.empty), 1)) : (d(), i("div", ve, h(g.value.prompt), 1))], 512));
+		}, null, 8, he)) : (d(), i("span", ge, h(e.name.charAt(0)), 1)), a("span", _e, h(e.name), 1)], 40, me))), 128)) : O.value ? (d(), i("div", ve, h(g.value.searching), 1)) : w.value ? (d(), i("div", ye, h(g.value.empty), 1)) : (d(), i("div", be, h(g.value.prompt), 1))], 512));
 	}
-}), be = /* @__PURE__ */ s({
+}), Se = /* @__PURE__ */ s({
 	__name: "MilkdownEditor",
 	props: {
 		modelValue: {},
@@ -148,20 +148,32 @@ var J = Symbol("kun-editor-context"), fe = [
 		readonly: { type: Boolean }
 	},
 	emits: ["update:modelValue"],
-	setup(e, { emit: t }) {
-		let r = e, i = t, a = r.modelValue, o = O(), s = F("kunMention"), c = r.features.mention !== !1 && !!r.adapters.searchMentionUsers && !!o, l = w((e) => {
+	setup(e, { expose: t, emit: r }) {
+		let i = e, a = r, o = i.modelValue, s = O(), c = I("kunMention"), l = i.features.mention !== !1 && !!i.adapters.searchMentionUsers && !!s, u = w((e) => {
 			let t = k.make().config((t) => {
-				t.set(N, e), t.set(A, r.modelValue), t.get(P).markdownUpdated((e, t, n) => {
-					t !== n && (a = t, i("update:modelValue", t));
+				t.set(N, e), t.set(A, i.modelValue), t.get(P).markdownUpdated((e, t, n) => {
+					t !== n && (o = t, a("update:modelValue", t));
 				}), t.update(M, (e) => ({
 					...e,
-					editable: () => !r.readonly
-				})), c && t.set(s.key, { view: o({ component: ye }) });
-			}).use(R(r.adapters, r.features, { locale: r.locale }));
-			return c && t.use(s), t;
+					editable: () => !i.readonly
+				})), l && t.set(c.key, { view: s({ component: xe }) });
+			}).use(ee(i.adapters, i.features, { locale: i.locale }));
+			return l && t.use(c), t;
 		});
-		return v(() => r.modelValue, (e) => {
-			e !== a && (a = e, l.get()?.action(L(e)));
+		v(() => i.modelValue, (e) => {
+			e !== o && (o = e, u.get()?.action(R(e)));
+		});
+		let f = () => {
+			u.get()?.action((e) => e.get(j).focus());
+		};
+		return t({
+			insertQuote: (e) => {
+				u.get()?.action(L(re.key, e)), f();
+			},
+			insertMention: (e) => {
+				u.get()?.action(L(ne.key, e)), f();
+			},
+			focus: f
 		}), (e, t) => (d(), n(g(S)));
 	}
 }), Y = (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>`, X = (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>`, Z = {
@@ -181,21 +193,21 @@ var J = Symbol("kun-editor-context"), fe = [
 	spoiler: Y("<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: X("Σ", 15),
 	smile: Y("<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\"/>")
-}, xe = /* @__PURE__ */ "😀.😃.😄.😁.😆.😅.🤣.😂.🙂.🙃.😉.😊.😇.🥰.😍.🤩.😘.😗.😚.😋.😛.😜.🤪.😝.🤗.🤭.🤔.🤐.😐.😑.😶.😏.😒.🙄.😬.😌.😔.😪.🤤.😴.😷.🤒.🤕.🥵.🥶.🥴.😵.🤯.🤠.🥳.😎.🤓.🧐.😕.😟.🙁.😮.😯.😲.😳.🥺.😦.😧.😨.😰.😥.😢.😭.😱.😖.😣.😞.😓.😩.😫.🥱.😤.😡.😠.🤬.😈.👿.💀.💩.🤡.👻.👽.🤖.😺.😸.👍.👎.👌.🤌.🤏.✌️.🤞.🤟.🤘.👋.🤚.🖐️.✋.👏.🙌.🤝.🙏.💪.👀.👁️.❤️.🧡.💛.💚.💙.💜.🖤.🤍.💔.💕.💞.💓.💗.💖.💘.💝.💯.✨.⭐.🌟.🔥.💥.💫.⚡.☀️.🌈.🎉.🎊.🎁.🏆.🐶.🐱.🐭.🦊.🐻.🐼.🐨.🦄.🐢.🐳.🍎.🍑.🍓.🍉.🍰.🍺.🍵.☕.🍜.🍙.✅.❌.❓.❗.💤.👑.🎮.🎵.📌.🔖".split("."), Se = [
+}, Ce = /* @__PURE__ */ "😀.😃.😄.😁.😆.😅.🤣.😂.🙂.🙃.😉.😊.😇.🥰.😍.🤩.😘.😗.😚.😋.😛.😜.🤪.😝.🤗.🤭.🤔.🤐.😐.😑.😶.😏.😒.🙄.😬.😌.😔.😪.🤤.😴.😷.🤒.🤕.🥵.🥶.🥴.😵.🤯.🤠.🥳.😎.🤓.🧐.😕.😟.🙁.😮.😯.😲.😳.🥺.😦.😧.😨.😰.😥.😢.😭.😱.😖.😣.😞.😓.😩.😫.🥱.😤.😡.😠.🤬.😈.👿.💀.💩.🤡.👻.👽.🤖.😺.😸.👍.👎.👌.🤌.🤏.✌️.🤞.🤟.🤘.👋.🤚.🖐️.✋.👏.🙌.🤝.🙏.💪.👀.👁️.❤️.🧡.💛.💚.💙.💜.🖤.🤍.💔.💕.💞.💓.💗.💖.💘.💝.💯.✨.⭐.🌟.🔥.💥.💫.⚡.☀️.🌈.🎉.🎊.🎁.🏆.🐶.🐱.🐭.🦊.🐻.🐼.🐨.🦄.🐢.🐳.🍎.🍑.🍓.🍉.🍰.🍺.🍵.☕.🍜.🍙.✅.❌.❓.❗.💤.👑.🎮.🎵.📌.🔖".split("."), we = [
 	"title",
 	"aria-label",
 	"aria-expanded"
-], Ce = ["innerHTML"], we = { class: "kun-editor__picker-panel" }, Te = {
+], Te = ["innerHTML"], Ee = { class: "kun-editor__picker-panel" }, De = {
 	key: 0,
 	class: "kun-editor__picker-tabs",
 	role: "tablist"
-}, Ee = ["data-active"], De = ["data-active"], Oe = { class: "kun-editor__emoji-grid" }, ke = ["onClick"], Ae = {
+}, Oe = ["data-active"], ke = ["data-active"], Ae = { class: "kun-editor__emoji-grid" }, je = ["onClick"], Me = {
 	key: 1,
 	class: "kun-editor__sticker-body"
-}, je = { class: "kun-editor__pack-name" }, Me = { class: "kun-editor__sticker-grid" }, Ne = ["title", "onClick"], Pe = ["src", "alt"], Fe = {
+}, Ne = { class: "kun-editor__pack-name" }, Pe = { class: "kun-editor__sticker-grid" }, Fe = ["title", "onClick"], Ie = ["src", "alt"], Le = {
 	key: 1,
 	class: "kun-editor__picker-hint"
-}, Ie = /* @__PURE__ */ s({
+}, Re = /* @__PURE__ */ s({
 	__name: "StickerPicker",
 	setup(n) {
 		let [, o] = T(), s = c(J), f = s?.adapters.stickerSource, v = !!f, y = t(() => (s?.locale ?? "zh-cn").toLowerCase().startsWith("en")), x = t(() => y.value ? {
@@ -231,7 +243,7 @@ var J = Symbol("kun-editor-context"), fe = [
 				n.dispatch(r.tr.insertText(e, r.selection.from));
 			});
 		}, P = (e, t) => {
-			o()?.action(I(z.key, {
+			o()?.action(L(B.key, {
 				src: e,
 				title: t,
 				alt: t
@@ -251,28 +263,28 @@ var J = Symbol("kun-editor-context"), fe = [
 		}, [a("span", {
 			class: "kun-editor__icon",
 			innerHTML: g(Z).smile
-		}, null, 8, Ce)], 8, Se), b(a("div", we, [
-			v ? (d(), i("div", Te, [a("button", {
+		}, null, 8, Te)], 8, we), b(a("div", Ee, [
+			v ? (d(), i("div", De, [a("button", {
 				type: "button",
 				class: "kun-editor__picker-tab",
 				"data-active": w.value === "emoji",
 				onClick: n[0] ||= (e) => w.value = "emoji"
-			}, h(x.value.emoji), 9, Ee), a("button", {
+			}, h(x.value.emoji), 9, Oe), a("button", {
 				type: "button",
 				class: "kun-editor__picker-tab",
 				"data-active": w.value === "sticker",
 				onClick: n[1] ||= (e) => w.value = "sticker"
-			}, h(x.value.sticker), 9, De)])) : r("", !0),
-			b(a("div", Oe, [(d(!0), i(e, null, m(g(xe), (e, t) => (d(), i("button", {
+			}, h(x.value.sticker), 9, ke)])) : r("", !0),
+			b(a("div", Ae, [(d(!0), i(e, null, m(g(Ce), (e, t) => (d(), i("button", {
 				key: t,
 				type: "button",
 				class: "kun-editor__emoji",
 				onClick: (t) => N(e)
-			}, h(e), 9, ke))), 128))], 512), [[_, !v || w.value === "emoji"]]),
-			v ? b((d(), i("div", Ae, [E.value.length ? (d(!0), i(e, { key: 0 }, m(E.value, (t) => (d(), i("div", {
+			}, h(e), 9, je))), 128))], 512), [[_, !v || w.value === "emoji"]]),
+			v ? b((d(), i("div", Me, [E.value.length ? (d(!0), i(e, { key: 0 }, m(E.value, (t) => (d(), i("div", {
 				key: t.name,
 				class: "kun-editor__pack"
-			}, [a("div", je, h(t.name), 1), a("div", Me, [(d(!0), i(e, null, m(t.stickers, (e, t) => (d(), i("button", {
+			}, [a("div", Ne, h(t.name), 1), a("div", Pe, [(d(!0), i(e, null, m(t.stickers, (e, t) => (d(), i("button", {
 				key: t,
 				type: "button",
 				class: "kun-editor__sticker",
@@ -282,25 +294,25 @@ var J = Symbol("kun-editor-context"), fe = [
 				src: e.src,
 				alt: e.name,
 				loading: "lazy"
-			}, null, 8, Pe)], 8, Ne))), 128))])]))), 128)) : (d(), i("div", Fe, h(O.value ? x.value.failed : x.value.empty), 1))], 512)), [[_, w.value === "sticker"]]) : r("", !0)
+			}, null, 8, Ie)], 8, Fe))), 128))])]))), 128)) : (d(), i("div", Le, h(O.value ? x.value.failed : x.value.empty), 1))], 512)), [[_, w.value === "sticker"]]) : r("", !0)
 		], 512), [[_, S.value]])], 512));
 	}
-}), Le = {
+}), ze = {
 	class: "kun-editor__format-toolbar",
 	role: "toolbar"
-}, Re = {
+}, Be = {
 	key: 0,
 	class: "kun-editor__toolbar-divider",
 	"aria-hidden": "true"
-}, ze = [
+}, Ve = [
 	"title",
 	"aria-label",
 	"onClick"
-], Be = ["innerHTML"], Ve = ["title", "aria-label"], He = ["innerHTML"], Q = /* @__PURE__ */ s({
+], He = ["innerHTML"], Q = ["title", "aria-label"], Ue = ["innerHTML"], We = /* @__PURE__ */ s({
 	__name: "EditorToolbar",
 	setup(n) {
 		let [, s] = T(), l = c(J), u = t(() => l?.adapters.uploadImage), f = () => l?.adapters.notify, h = t(() => l?.features.sticker !== !1), _ = t(() => (l?.locale ?? "zh-cn").toLowerCase().startsWith("en")), v = (e, t) => {
-			s()?.action(I(e, t));
+			s()?.action(L(e, t));
 		}, y = t(() => {
 			let e = _.value;
 			return {
@@ -325,66 +337,66 @@ var J = Symbol("kun-editor-context"), fe = [
 				{
 					svg: Z.bold,
 					title: y.value.bold,
-					run: () => v(H.key)
+					run: () => v(U.key)
 				},
 				{
 					svg: Z.italic,
 					title: y.value.italic,
-					run: () => v(B.key)
+					run: () => v(V.key)
 				},
 				{
 					svg: Z.strike,
 					title: y.value.strike,
-					run: () => v(ce.key)
+					run: () => v(ue.key)
 				},
 				{
 					svg: Z.code,
 					title: y.value.code,
-					run: () => v(V.key)
+					run: () => v(H.key)
 				}
 			],
 			[
 				{
 					svg: Z.h1,
 					title: y.value.h1,
-					run: () => v(G.key, 1)
+					run: () => v(K.key, 1)
 				},
 				{
 					svg: Z.h2,
 					title: y.value.h2,
-					run: () => v(G.key, 2)
+					run: () => v(K.key, 2)
 				},
 				{
 					svg: Z.h3,
 					title: y.value.h3,
-					run: () => v(G.key, 3)
+					run: () => v(K.key, 3)
 				}
 			],
 			[
 				{
 					svg: Z.bulletList,
 					title: y.value.bulletList,
-					run: () => v(W.key)
+					run: () => v(G.key)
 				},
 				{
 					svg: Z.orderedList,
 					title: y.value.orderedList,
-					run: () => v(K.key)
+					run: () => v(le.key)
 				},
 				{
 					svg: Z.quote,
 					title: y.value.quote,
-					run: () => v(U.key)
+					run: () => v(W.key)
 				},
 				{
 					svg: Z.codeBlock,
 					title: y.value.codeBlock,
-					run: () => v(oe.key, "")
+					run: () => v(ce.key, "")
 				},
 				{
 					svg: Z.hr,
 					title: y.value.hr,
-					run: () => v(se.key)
+					run: () => v(z.key)
 				}
 			],
 			[{
@@ -394,7 +406,7 @@ var J = Symbol("kun-editor-context"), fe = [
 			}, {
 				svg: Z.latex,
 				title: y.value.latex,
-				run: () => v(ie.key)
+				run: () => v(oe.key)
 			}]
 		]), x = p(null), S = () => x.value?.click(), C = async (e) => {
 			let t = e.target, n = t.files?.[0];
@@ -402,7 +414,7 @@ var J = Symbol("kun-editor-context"), fe = [
 			let r = u.value;
 			if (!(!n || !r)) try {
 				let e = await r(n);
-				v(z.key, {
+				v(B.key, {
 					src: e,
 					title: n.name,
 					alt: n.name
@@ -411,8 +423,8 @@ var J = Symbol("kun-editor-context"), fe = [
 				f()?.(_.value ? "Image upload failed" : "图片上传失败", "error");
 			}
 		};
-		return (t, n) => (d(), i("div", Le, [
-			(d(!0), i(e, null, m(b.value, (t, n) => (d(), i(e, { key: n }, [n > 0 ? (d(), i("span", Re)) : r("", !0), (d(!0), i(e, null, m(t, (e, t) => (d(), i("button", {
+		return (t, n) => (d(), i("div", ze, [
+			(d(!0), i(e, null, m(b.value, (t, n) => (d(), i(e, { key: n }, [n > 0 ? (d(), i("span", Be)) : r("", !0), (d(!0), i(e, null, m(t, (e, t) => (d(), i("button", {
 				key: t,
 				type: "button",
 				class: "kun-editor__tool",
@@ -422,7 +434,7 @@ var J = Symbol("kun-editor-context"), fe = [
 			}, [a("span", {
 				class: "kun-editor__icon",
 				innerHTML: e.svg
-			}, null, 8, Be)], 8, ze))), 128))], 64))), 128)),
+			}, null, 8, He)], 8, Ve))), 128))], 64))), 128)),
 			u.value ? (d(), i(e, { key: 0 }, [
 				n[0] ||= a("span", {
 					class: "kun-editor__toolbar-divider",
@@ -437,7 +449,7 @@ var J = Symbol("kun-editor-context"), fe = [
 				}, [a("span", {
 					class: "kun-editor__icon",
 					innerHTML: g(Z).image
-				}, null, 8, He)], 8, Ve),
+				}, null, 8, Ue)], 8, Q),
 				a("input", {
 					ref_key: "fileInput",
 					ref: x,
@@ -450,10 +462,10 @@ var J = Symbol("kun-editor-context"), fe = [
 			h.value ? (d(), i(e, { key: 1 }, [n[1] ||= a("span", {
 				class: "kun-editor__toolbar-divider",
 				"aria-hidden": "true"
-			}, null, -1), o(Ie)], 64)) : r("", !0)
+			}, null, -1), o(Re)], 64)) : r("", !0)
 		]));
 	}
-}), Ue = /* @__PURE__ */ s({
+}), Ge = /* @__PURE__ */ s({
 	__name: "MarkdownSource",
 	props: {
 		modelValue: {},
@@ -461,13 +473,13 @@ var J = Symbol("kun-editor-context"), fe = [
 	},
 	emits: ["update:modelValue"],
 	setup(e, { emit: t }) {
-		let n = e, r = t, a = p(null), o = null, s = (e) => le.create({
+		let n = e, r = t, a = p(null), o = null, s = (e) => de.create({
 			doc: e,
 			extensions: [
-				ne(),
+				ie(),
 				q.lineWrapping,
-				de,
-				ue(),
+				pe,
+				fe(),
 				q.editable.of(!n.readonly),
 				q.updateListener.of((e) => {
 					e.docChanged && r("update:modelValue", e.state.doc.toString());
@@ -489,13 +501,13 @@ var J = Symbol("kun-editor-context"), fe = [
 			class: "kun-editor__source"
 		}, null, 512));
 	}
-}), We = {
+}), Ke = {
 	class: "kun-editor",
 	"data-kun-editor": ""
-}, Ge = {
+}, qe = {
 	class: "kun-editor__toolbar",
 	role: "tablist"
-}, Ke = ["aria-selected", "data-active"], qe = ["aria-selected", "data-active"], Je = { class: "kun-editor__wysiwyg" }, $ = /* @__PURE__ */ s({
+}, Je = ["aria-selected", "data-active"], Ye = ["aria-selected", "data-active"], Xe = { class: "kun-editor__wysiwyg" }, $ = /* @__PURE__ */ s({
 	__name: "KunEditor",
 	props: {
 		modelValue: {},
@@ -508,70 +520,76 @@ var J = Symbol("kun-editor-context"), fe = [
 		}
 	},
 	emits: ["update:modelValue"],
-	setup(e, { emit: s }) {
-		let c = e, l = s;
+	setup(e, { expose: s, emit: c }) {
+		let l = e, u = c;
 		f(J, {
 			get adapters() {
-				return c.adapters;
+				return l.adapters;
 			},
 			get features() {
-				return c.features;
+				return l.features;
 			},
 			get locale() {
-				return c.locale;
+				return l.locale;
 			}
 		});
-		let u = p("wysiwyg"), m = t(() => c.locale.toLowerCase().startsWith("en")), v = t(() => m.value ? {
+		let m = p("wysiwyg"), v = t(() => l.locale.toLowerCase().startsWith("en")), x = t(() => v.value ? {
 			wysiwyg: "Preview",
 			source: "Markdown"
 		} : {
 			wysiwyg: "预览",
 			source: "Markdown"
-		}), x = (e) => l("update:modelValue", e);
-		return (t, s) => (d(), i("div", We, [
-			a("div", Ge, [a("button", {
+		}), S = (e) => u("update:modelValue", e), w = p(null);
+		return s({
+			insertQuote: (e) => w.value?.insertQuote(e),
+			insertMention: (e) => w.value?.insertMention(e),
+			focus: () => w.value?.focus()
+		}), (t, s) => (d(), i("div", Ke, [
+			a("div", qe, [a("button", {
 				type: "button",
 				class: "kun-editor__tab",
-				"aria-selected": u.value === "wysiwyg",
-				"data-active": u.value === "wysiwyg",
-				onClick: s[0] ||= (e) => u.value = "wysiwyg"
-			}, h(v.value.wysiwyg), 9, Ke), a("button", {
+				"aria-selected": m.value === "wysiwyg",
+				"data-active": m.value === "wysiwyg",
+				onClick: s[0] ||= (e) => m.value = "wysiwyg"
+			}, h(x.value.wysiwyg), 9, Je), a("button", {
 				type: "button",
 				class: "kun-editor__tab",
-				"aria-selected": u.value === "source",
-				"data-active": u.value === "source",
-				onClick: s[1] ||= (e) => u.value = "source"
-			}, h(v.value.source), 9, qe)]),
+				"aria-selected": m.value === "source",
+				"data-active": m.value === "source",
+				onClick: s[1] ||= (e) => m.value = "source"
+			}, h(x.value.source), 9, Ye)]),
 			o(g(C), null, {
 				default: y(() => [o(g(E), null, {
-					default: y(() => [b(o(Q, null, null, 512), [[_, u.value === "wysiwyg" && !e.readonly]]), b(a("div", Je, [o(be, {
+					default: y(() => [b(o(We, null, null, 512), [[_, m.value === "wysiwyg" && !e.readonly]]), b(a("div", Xe, [o(Se, {
+						ref_key: "inner",
+						ref: w,
 						"model-value": e.modelValue,
 						adapters: e.adapters,
 						features: e.features,
 						locale: e.locale,
 						readonly: e.readonly,
-						"onUpdate:modelValue": x
+						"onUpdate:modelValue": S
 					}, null, 8, [
 						"model-value",
 						"adapters",
 						"features",
 						"locale",
 						"readonly"
-					])], 512), [[_, u.value === "wysiwyg"]])]),
+					])], 512), [[_, m.value === "wysiwyg"]])]),
 					_: 1
 				})]),
 				_: 1
 			}),
-			u.value === "source" ? (d(), n(Ue, {
+			m.value === "source" ? (d(), n(Ge, {
 				key: 0,
 				"model-value": e.modelValue,
 				readonly: e.readonly,
-				"onUpdate:modelValue": x
+				"onUpdate:modelValue": S
 			}, null, 8, ["model-value", "readonly"])) : r("", !0)
 		]));
 	}
-}), Ye = { install(e) {
+}), Ze = { install(e) {
 	e.component("KunEditor", $);
 } };
 //#endregion
-export { $ as KunEditor, Ye as KunEditorPlugin };
+export { $ as KunEditor, Ze as KunEditorPlugin };

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+export interface KunEditorExpose {
+    /**
+     * Insert a reference atom at the cursor (`[label](kungal-reply:refId)`), then
+     * focus. Requires the `quote` feature to be enabled.
+     */
+    insertQuote(payload: {
+        refId: string;
+        label: string;
+    }): void;
+    /**
+     * Insert an @mention atom at the cursor (`[@name](kungal-user:id)`), then
+     * focus. Requires the `mention` feature (on by default).
+     */
+    insertMention(payload: {
+        userId: number;
+        name: string;
+    }): void;
+    /** Focus the WYSIWYG editor. */
+    focus(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5D;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC9D,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAAA;CACd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/editor-vue",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "KunEditor Vue 3 layer — the <KunEditor> component (dual WYSIWYG / markdown-source), toolbar and plugin views. Consumes @kungal/editor-core; pairs with @kungal/ui-vue.",
   "type": "module",
   "keywords": [
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@prosemirror-adapter/vue": "^0.4.6",
-    "@kungal/editor-core": "0.8.0"
+    "@kungal/editor-core": "0.9.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.8.0"
+    "@kungal/editor-core": "0.9.0"
   },
   "scripts": {
     "build": "vite build && vue-tsc -p tsconfig.build.json",