@kungal/editor-vue 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @kungal/editor-vue
 
+## 0.17.0
+
+### Minor Changes
+
+- 59abbc8: Add a placeholder (empty-state text).
+
+  - **editor-core**: `createPlaceholderPlugin({ text, mode })` — a `$prose` plugin
+    that adds a ProseMirror node DECORATION to the empty block (`.kun-editor__placeholder`
+    class + `data-placeholder` attribute). Same mechanism as Milkdown Crepe's v7
+    placeholder feature — purely visual (a decoration), so it never enters the doc
+    or the markdown output. `mode` `'block'` (default) shows on any empty block,
+    `'doc'` only when the whole document is empty; skipped in readonly / code blocks
+    / lists / tables. `createKunEditorPlugins(..., { placeholder, placeholderMode })`
+    wires it (only when `placeholder` is non-empty). Exported from `/preset`.
+  - **editor-vue**: `<KunEditor placeholder="…">` prop, threaded through.
+  - **Headless**: the core ships only the class + `data-placeholder` hook; render it
+    with `.kun-editor__placeholder::before { content: attr(data-placeholder) }` (added
+    to the reference `kun-editor.css`, muted via a KunUI token).
+
+### Patch Changes
+
+- Updated dependencies [59abbc8]
+  - @kungal/editor-core@0.17.0
+
 ## 0.16.0
 
 ### Patch Changes

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

@@ -11,6 +11,8 @@ type __VLS_Props = {
     locale?: KunEditorLocale;
     /** Read-only render (no editing). */
     readonly?: boolean;
+    /** Placeholder text shown while the editor is empty. */
+    placeholder?: string;
 };
 type ViewMode = 'wysiwyg' | 'source';
 declare var __VLS_1: {
@@ -50,6 +52,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, KunEditorEx
     features: KunEditorFeatures;
     locale: KunEditorLocale;
     readonly: boolean;
+    placeholder: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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":"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"}
+{"version":3,"file":"KunEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/KunEditor.vue"],"names":[],"mappings":"AAsLA,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;IAClB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAC;AAqCJ,KAAK,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AA8MpC,QAAA,IAAI,OAAO;;iBA5MS,QAAQ;;;;;CA4MP,EAAE,QAAQ;iEA/Q/B,CAzKwB;;;;;;;;;;;;;;CAwbwC,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;;;;;cAtQD,iBAAiB;cAEjB,iBAAiB;YAEnB,eAAe;cAEb,OAAO;iBAEJ,MAAM;6EAmQtB,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

@@ -6,6 +6,7 @@ type __VLS_Props = {
     features: KunEditorFeatures;
     locale: KunEditorLocale;
     readonly: boolean;
+    placeholder: string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, KunEditorExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (markdown: string) => any;

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":"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"}
+{"version":3,"file":"MilkdownEditor.vue.d.ts","sourceRoot":"","sources":["../../src/components/MilkdownEditor.vue"],"names":[],"mappings":"AA0KA,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;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAC;AA8HF,QAAA,MAAM,YAAY;;;;kFAIhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/index.js

@@ -145,7 +145,8 @@ var q = Symbol("kun-editor-context"), _e = [
 		adapters: {},
 		features: {},
 		locale: {},
-		readonly: { type: Boolean }
+		readonly: { type: Boolean },
+		placeholder: {}
 	},
 	emits: ["update:modelValue"],
 	setup(e, { expose: t, emit: r }) {
@@ -157,7 +158,10 @@ var q = Symbol("kun-editor-context"), _e = [
 					...e,
 					editable: () => !i.readonly
 				})), l && t.set(c.key, { view: s({ component: we }) });
-			}).use(ne(i.adapters, i.features, { locale: i.locale }));
+			}).use(ne(i.adapters, i.features, {
+				locale: i.locale,
+				placeholder: i.placeholder
+			}));
 			return l && t.use(c), t;
 		});
 		x(() => i.modelValue, (e) => {
@@ -555,7 +559,8 @@ var q = Symbol("kun-editor-context"), _e = [
 		readonly: {
 			type: Boolean,
 			default: !1
-		}
+		},
+		placeholder: { default: "" }
 	},
 	emits: ["update:modelValue"],
 	setup(e, { expose: s, emit: l }) {
@@ -615,13 +620,15 @@ var q = Symbol("kun-editor-context"), _e = [
 						features: e.features,
 						locale: e.locale,
 						readonly: e.readonly,
+						placeholder: e.placeholder,
 						"onUpdate:modelValue": D
 					}, null, 8, [
 						"model-value",
 						"adapters",
 						"features",
 						"locale",
-						"readonly"
+						"readonly",
+						"placeholder"
 					])], 512), [[b, g.value === "wysiwyg"]])]),
 					_: 3
 				})]),

package/package.json

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