@kungal/editor-vue 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @kungal/editor-vue
 
+## 0.14.0
+
+### Minor Changes
+
+- 506813b: Add a `#view-switch` slot and a KunUI view switch — the Preview/Markdown tabs are
+  now a swappable layer too.
+
+  `<KunEditor>` exposes a `#view-switch` scoped slot whose props are
+  `KunEditorViewSwitchApi` (`mode` / `setMode` / `labels`). The hand-rolled tabs
+  are the slot's fallback — omit the slot and nothing changes. This lets a host
+  render a real component (or anything) for the view switch and drive the editor
+  via `setMode`, without reaching into internals.
+
+  `@kungal/editor-nuxt` ships `<KunEditorViewSwitch>` (auto-imported): the tabs as a
+  real `<KunTab variant="underlined">` (keyboard nav, sliding indicator, a11y):
+
+  ```vue
+  <KunEditor v-model="md">
+    <template #view-switch="s"><KunEditorViewSwitch v-bind="s" /></template>
+    <template #toolbar="api"><KunEditorToolbar v-bind="api" /></template>
+  </KunEditor>
+  ```
+
+  Same "headless core + optional KunUI layer" pattern as `#toolbar` /
+  `<KunEditorToolbar>`: `@kungal/editor-vue` stays UI-kit-free (default tabs), the
+  KunUI ecosystem gets native chrome. Exports `KunEditorViewSwitchApi`.
+
+### Patch Changes
+
+- @kungal/editor-core@0.14.0
+
 ## 0.13.0
 
 ### Patch Changes

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

@@ -12,7 +12,15 @@ type __VLS_Props = {
     /** Read-only render (no editing). */
     readonly?: boolean;
 };
-declare var __VLS_20: {
+type ViewMode = 'wysiwyg' | 'source';
+declare var __VLS_1: {
+    mode: ViewMode;
+    setMode: (m: ViewMode) => void;
+    labels: {
+        wysiwyg: string;
+        source: string;
+    };
+}, __VLS_22: {
     run: <T>(key: import("@milkdown/kit/core").CmdKey<T>, payload?: T) => void;
     insertText: (text: string) => void;
     insertQuote: (payload: {
@@ -29,7 +37,9 @@ declare var __VLS_20: {
     locale: KunEditorLocale;
 };
 type __VLS_Slots = {} & {
-    toolbar?: (props: typeof __VLS_20) => any;
+    'view-switch'?: (props: typeof __VLS_1) => any;
+} & {
+    toolbar?: (props: typeof __VLS_22) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, KunEditorExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (markdown: string) => any;

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":"AA2KA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,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;AAsOJ,QAAA,IAAI,QAAQ;iEAhQZ,CA9JwB;;;;;;;;;;;;;;CA8ZqB,CAAE;AAC/C,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAOhD,QAAA,MAAM,UAAU;;;;;cAtPD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;6EAqPpB,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":"AAkLA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,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;AAoCJ,KAAK,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AA2MpC,QAAA,IAAI,OAAO;;iBAzMS,QAAQ;;;;;CAyMP,EAAE,QAAQ;iEAzQ/B,CArKwB;;;;;;;;;;;;;;CA8awC,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;AAOhD,QAAA,MAAM,UAAU;;;;;cAhQD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;6EA+PpB,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/index.d.ts

@@ -3,6 +3,7 @@ import KunEditor from './components/KunEditor.vue';
 export { KunEditor };
 export type { KunEditorExpose } from './types';
 export type { KunEditorToolbarApi } from './types';
+export type { KunEditorViewSwitchApi } from './types';
 export { EMOJI } from './emoji';
 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. */

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,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAG9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAGlD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAG/B,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,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAGlD,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAGrD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAG/B,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

@@ -567,31 +567,37 @@ var q = Symbol("kun-editor-context"), ve = [
 				return d.locale;
 			}
 		});
-		let g = h("wysiwyg"), x = t(() => d.locale.toLowerCase().startsWith("en")), w = t(() => x.value ? {
+		let g = h("wysiwyg"), x = (e) => {
+			g.value = e;
+		}, w = t(() => d.locale.toLowerCase().startsWith("en")), T = t(() => w.value ? {
 			wysiwyg: "Preview",
 			source: "Markdown"
 		} : {
 			wysiwyg: "预览",
 			source: "Markdown"
-		}), T = (e) => f("update:modelValue", e), D = h(null);
+		}), D = (e) => f("update:modelValue", e), O = h(null);
 		return s({
-			insertQuote: (e) => D.value?.insertQuote(e),
-			insertMention: (e) => D.value?.insertMention(e),
-			focus: () => D.value?.focus()
+			insertQuote: (e) => O.value?.insertQuote(e),
+			insertMention: (e) => O.value?.insertMention(e),
+			focus: () => O.value?.focus()
 		}), (t, s) => (p(), i("div", Xe, [
-			a("div", Ze, [a("button", {
+			_(t.$slots, "view-switch", {
+				mode: g.value,
+				setMode: x,
+				labels: T.value
+			}, () => [a("div", Ze, [a("button", {
 				type: "button",
 				class: "kun-editor__tab",
 				"aria-selected": g.value === "wysiwyg",
 				"data-active": g.value === "wysiwyg",
-				onClick: s[0] ||= (e) => g.value = "wysiwyg"
-			}, v(w.value.wysiwyg), 9, Qe), a("button", {
+				onClick: s[0] ||= (e) => x("wysiwyg")
+			}, v(T.value.wysiwyg), 9, Qe), a("button", {
 				type: "button",
 				class: "kun-editor__tab",
 				"aria-selected": g.value === "source",
 				"data-active": g.value === "source",
-				onClick: s[1] ||= (e) => g.value = "source"
-			}, v(w.value.source), 9, $e)]),
+				onClick: s[1] ||= (e) => x("source")
+			}, v(T.value.source), 9, $e)])]),
 			o(y(E), null, {
 				default: S(() => [o(y(k), null, {
 					default: S(() => [C(a("div", null, [o(Je, null, {
@@ -599,13 +605,13 @@ var q = Symbol("kun-editor-context"), ve = [
 						_: 3
 					})], 512), [[b, g.value === "wysiwyg" && !e.readonly]]), C(a("div", et, [o(Ee, {
 						ref_key: "inner",
-						ref: D,
+						ref: O,
 						"model-value": e.modelValue,
 						adapters: e.adapters,
 						features: e.features,
 						locale: e.locale,
 						readonly: e.readonly,
-						"onUpdate:modelValue": T
+						"onUpdate:modelValue": D
 					}, null, 8, [
 						"model-value",
 						"adapters",
@@ -621,7 +627,7 @@ var q = Symbol("kun-editor-context"), ve = [
 				key: 0,
 				"model-value": e.modelValue,
 				readonly: e.readonly,
-				"onUpdate:modelValue": T
+				"onUpdate:modelValue": D
 			}, null, 8, ["model-value", "readonly"])) : r("", !0)
 		]));
 	}

package/dist/types.d.ts

@@ -24,6 +24,17 @@ export interface KunEditorToolbarApi {
     /** UI language, for localized labels. */
     readonly locale: KunEditorLocale;
 }
+export interface KunEditorViewSwitchApi {
+    /** The active view. */
+    mode: 'wysiwyg' | 'source';
+    /** Switch the active view. */
+    setMode: (mode: 'wysiwyg' | 'source') => void;
+    /** Localized labels for the two views (respects the `locale` prop). */
+    labels: {
+        wysiwyg: string;
+        source: string;
+    };
+}
 export interface KunEditorExpose {
     /**
      * Insert a reference atom at the cursor (`[label](kungal-reply:refId)`), then

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;IAC7C,uDAAuD;IACvD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,0EAA0E;IAC1E,WAAW,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAChE,6CAA6C;IAC7C,aAAa,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAClE,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CACjC;AASD,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAM5B,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;IAC7C,uDAAuD;IACvD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,0EAA0E;IAC1E,WAAW,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAChE,6CAA6C;IAC7C,aAAa,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAClE,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CACjC;AAMD,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1B,8BAA8B;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAA;IAC7C,uEAAuE;IACvE,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AASD,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.13.0",
+  "version": "0.14.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.13.0"
+    "@kungal/editor-core": "0.14.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.13.0"
+    "@kungal/editor-core": "0.14.0"
   },
   "scripts": {
     "build": "vite build && vue-tsc -p tsconfig.build.json",