@kungal/editor-core 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @kungal/editor-core
 
+## 0.28.0
+
+### Minor Changes
+
+- 8d278e5: Make the insert-link URL entry customizable via a `linkPrompt` adapter.
+
+  The headless toolbar and the selection bubble asked for the link URL with the
+  native `window.prompt` (the KunUI toolbar used an inline popover). Hosts can now
+  supply their own UI instead — a modal, an article picker, etc.:
+
+  ```ts
+  const adapters = {
+    // …uploadImage, notify…
+    linkPrompt: async ({ text }) => await openLinkModal(text), // return the URL, or null to cancel
+  };
+  ```
+
+  - **editor-core**: new `LinkPrompt` type + `linkPrompt?` on `KunEditorAdapters`.
+    It receives the selected text (to prefill / search).
+  - **editor-vue**: the default toolbar and the selection bubble use `linkPrompt`
+    when supplied, else fall back to `window.prompt`.
+  - **editor-nuxt**: when `linkPrompt` is set, `<KunEditorToolbar>`'s link button
+    uses it instead of its inline popover — so one override covers every link entry
+    point (toolbar, default toolbar, bubble).
+
+  Verified in the docs production build: with a `linkPrompt` that derives a URL from
+  the selected text, the selection bubble inserts
+  `[…](https://example.com/search?q=…)` with no native dialog, and the KunUI
+  toolbar link becomes a plain button (no popover); 0 console errors.
+
 ## 0.27.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { K as KunEditorAdapters, a as KunEditorFeatures, b as KunEditorLocale, M as MentionUser, N as Notify, c as NotifyLevel, S as SearchMentionUsers, d as StickerItem, e as StickerPack, f as StickerSource, U as UploadImage } from './types-Dq7UxR_g.cjs';
+export { K as KunEditorAdapters, a as KunEditorFeatures, b as KunEditorLocale, L as LinkPrompt, M as MentionUser, N as Notify, c as NotifyLevel, S as SearchMentionUsers, d as StickerItem, e as StickerPack, f as StickerSource, U as UploadImage } from './types-BazCkMGt.cjs';
 
 interface KunHeading {
     /** Heading level 1–6. */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { K as KunEditorAdapters, a as KunEditorFeatures, b as KunEditorLocale, M as MentionUser, N as Notify, c as NotifyLevel, S as SearchMentionUsers, d as StickerItem, e as StickerPack, f as StickerSource, U as UploadImage } from './types-Dq7UxR_g.js';
+export { K as KunEditorAdapters, a as KunEditorFeatures, b as KunEditorLocale, L as LinkPrompt, M as MentionUser, N as Notify, c as NotifyLevel, S as SearchMentionUsers, d as StickerItem, e as StickerPack, f as StickerSource, U as UploadImage } from './types-BazCkMGt.js';
 
 interface KunHeading {
     /** Heading level 1–6. */

package/dist/preset/index.d.cts

@@ -1,6 +1,6 @@
 import { MilkdownPlugin, Ctx } from '@milkdown/kit/ctx';
 import { KatexOptions } from 'katex';
-import { b as KunEditorLocale, N as Notify, U as UploadImage, K as KunEditorAdapters, a as KunEditorFeatures } from '../types-Dq7UxR_g.cjs';
+import { b as KunEditorLocale, N as Notify, U as UploadImage, K as KunEditorAdapters, a as KunEditorFeatures } from '../types-BazCkMGt.cjs';
 import * as _milkdown_kit_utils from '@milkdown/kit/utils';
 import { Extension } from '@codemirror/state';
 import { Uploader } from '@milkdown/kit/plugin/upload';

package/dist/preset/index.d.ts

@@ -1,6 +1,6 @@
 import { MilkdownPlugin, Ctx } from '@milkdown/kit/ctx';
 import { KatexOptions } from 'katex';
-import { b as KunEditorLocale, N as Notify, U as UploadImage, K as KunEditorAdapters, a as KunEditorFeatures } from '../types-Dq7UxR_g.js';
+import { b as KunEditorLocale, N as Notify, U as UploadImage, K as KunEditorAdapters, a as KunEditorFeatures } from '../types-BazCkMGt.js';
 import * as _milkdown_kit_utils from '@milkdown/kit/utils';
 import { Extension } from '@codemirror/state';
 import { Uploader } from '@milkdown/kit/plugin/upload';

package/dist/{types-Dq7UxR_g.d.cts → types-BazCkMGt.d.cts}

@@ -46,6 +46,17 @@ type NotifyLevel = 'info' | 'success' | 'warn' | 'error';
  * Forum today: `useMessage(code, level)`.
  */
 type Notify = (message: string, level: NotifyLevel) => void;
+/**
+ * Ask the user for a link URL — provide this to show your OWN UI (a modal, an
+ * inline input, an article picker…) instead of the native `window.prompt` the
+ * headless toolbar / selection bubble fall back to. Gets the currently selected
+ * text (to prefill or search). Return the URL, or a falsy value to cancel. When
+ * set, the KunUI `<KunEditorToolbar>` uses it too instead of its inline popover,
+ * so one override covers every link entry point.
+ */
+type LinkPrompt = (context: {
+    text: string;
+}) => string | null | undefined | Promise<string | null | undefined>;
 /**
  * The full policy bundle a host passes when constructing the editor. Every
  * field is optional: omit `uploadImage` for an image-free editor (the galgame
@@ -57,6 +68,11 @@ interface KunEditorAdapters {
     searchMentionUsers?: SearchMentionUsers;
     stickerSource?: StickerSource;
     notify?: Notify;
+    /**
+     * Custom link-URL entry (replaces the native prompt in the headless toolbar /
+     * bubble, and the KunUI toolbar's popover). See {@link LinkPrompt}.
+     */
+    linkPrompt?: LinkPrompt;
     /**
      * How an @mention's user id becomes its markdown link URL. The URL form is a
      * server contract, so it's host policy — default `kungal-user:<id>` (the KUN
@@ -102,4 +118,4 @@ interface KunEditorFeatures {
     sticker?: boolean;
 }
 
-export type { KunEditorAdapters as K, MentionUser as M, Notify as N, SearchMentionUsers as S, UploadImage as U, KunEditorFeatures as a, KunEditorLocale as b, NotifyLevel as c, StickerItem as d, StickerPack as e, StickerSource as f };
+export type { KunEditorAdapters as K, LinkPrompt as L, MentionUser as M, Notify as N, SearchMentionUsers as S, UploadImage as U, KunEditorFeatures as a, KunEditorLocale as b, NotifyLevel as c, StickerItem as d, StickerPack as e, StickerSource as f };

package/dist/{types-Dq7UxR_g.d.ts → types-BazCkMGt.d.ts}

@@ -46,6 +46,17 @@ type NotifyLevel = 'info' | 'success' | 'warn' | 'error';
  * Forum today: `useMessage(code, level)`.
  */
 type Notify = (message: string, level: NotifyLevel) => void;
+/**
+ * Ask the user for a link URL — provide this to show your OWN UI (a modal, an
+ * inline input, an article picker…) instead of the native `window.prompt` the
+ * headless toolbar / selection bubble fall back to. Gets the currently selected
+ * text (to prefill or search). Return the URL, or a falsy value to cancel. When
+ * set, the KunUI `<KunEditorToolbar>` uses it too instead of its inline popover,
+ * so one override covers every link entry point.
+ */
+type LinkPrompt = (context: {
+    text: string;
+}) => string | null | undefined | Promise<string | null | undefined>;
 /**
  * The full policy bundle a host passes when constructing the editor. Every
  * field is optional: omit `uploadImage` for an image-free editor (the galgame
@@ -57,6 +68,11 @@ interface KunEditorAdapters {
     searchMentionUsers?: SearchMentionUsers;
     stickerSource?: StickerSource;
     notify?: Notify;
+    /**
+     * Custom link-URL entry (replaces the native prompt in the headless toolbar /
+     * bubble, and the KunUI toolbar's popover). See {@link LinkPrompt}.
+     */
+    linkPrompt?: LinkPrompt;
     /**
      * How an @mention's user id becomes its markdown link URL. The URL form is a
      * server contract, so it's host policy — default `kungal-user:<id>` (the KUN
@@ -102,4 +118,4 @@ interface KunEditorFeatures {
     sticker?: boolean;
 }
 
-export type { KunEditorAdapters as K, MentionUser as M, Notify as N, SearchMentionUsers as S, UploadImage as U, KunEditorFeatures as a, KunEditorLocale as b, NotifyLevel as c, StickerItem as d, StickerPack as e, StickerSource as f };
+export type { KunEditorAdapters as K, LinkPrompt as L, MentionUser as M, Notify as N, SearchMentionUsers as S, UploadImage as U, KunEditorFeatures as a, KunEditorLocale as b, NotifyLevel as c, StickerItem as d, StickerPack as e, StickerSource as f };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/editor-core",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "KunEditor framework-agnostic core — the Milkdown plugin bundle (spoiler / mention / quote / katex / upload / code-block) plus the adapter contracts. No Vue/React.",
   "type": "module",
   "keywords": [