@kungal/editor-core 0.25.1 → 0.26.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @kungal/editor-core
 
+## 0.26.0
+
+### Minor Changes
+
+- 945708d: Add an insert-link feature (click to add a URL).
+
+  The `link` mark already existed (so `[text](url)` round-trips and pasted URLs
+  autolink), but there was no click-to-insert UI. Now there is:
+
+  - **editor-core**: `insertLinkCommand` (`{ href, text? }`) — applies the link mark
+    to the selection, or inserts linked text on an empty selection; clears the
+    stored mark afterwards. Re-exported from `@kungal/editor-core/preset`.
+  - **editor-vue**: `KunEditorToolbarApi.insertLink(payload)`; a `link` button in the
+    default toolbar and the selection bubble (both default-on); `'link'` added to
+    `KunToolbarItem` and `KunSelectionItem`. Headless UI prompts for the URL.
+  - **editor-nuxt**: `<KunEditorToolbar>` gains a `link` button — a KunPopover with a
+    KunInput for the URL.
+
+  A link is a **mark** (`[text](url)`), deliberately distinct from the custom-NODE
+  embeds (mention / quote). A future "article card" or custom component would be a
+  node like those (schema + toUrl/fromUrl), not this — a separate mechanism.
+
+  Verified in the docs production build: the KunUI toolbar popover wraps a selection
+  (`[…](https://example.com)`); the selection bubble does too
+  (`[linktext](https://kun.com)`); 4 new core tests (wrap / insert / autolink
+  fallback / blank-href no-op) pass; 0 console errors.
+
+## 0.25.2
+
 ## 0.25.1
 
 ## 0.25.0

package/dist/preset/index.cjs

@@ -196,6 +196,29 @@ var linkCustomKeymap = utils.$useKeymap("linkCustomKeymap", {
   }
 });
 var createStopLinkPlugin = () => [stopLinkCommand, linkCustomKeymap].flat();
+var insertLinkCommand = utils.$command(
+  "InsertKunLink",
+  (ctx) => (payload) => (state, dispatch) => {
+    const href = payload?.href?.trim();
+    if (!href) {
+      return false;
+    }
+    const markType = commonmark.linkSchema.type(ctx);
+    const mark = markType.create({ href });
+    const { from, to, empty } = state.selection;
+    if (empty) {
+      const text = payload?.text?.trim() || href;
+      const tr = state.tr.insertText(text, from);
+      tr.addMark(from, from + text.length, mark);
+      tr.removeStoredMark(markType);
+      dispatch?.(tr.scrollIntoView());
+    } else {
+      dispatch?.(state.tr.addMark(from, to, mark).scrollIntoView());
+    }
+    return true;
+  }
+);
+var createLinkPlugin = () => [insertLinkCommand].flat();
 var setHeadingCommand = utils.$command(
   "SetHeadingKun",
   (ctx) => (level = 0) => level >= 1 && level <= 6 ? commands.setBlockType(commonmark.headingSchema.type(ctx), { level }) : commands.setBlockType(commonmark.paragraphSchema.type(ctx))
@@ -1160,6 +1183,7 @@ var createKunEditorPlugins = (adapters = {}, features = {}, options = {}) => {
     plugins.push(imageUploadPlaceholder);
   }
   plugins.push(createStopLinkPlugin());
+  plugins.push(createLinkPlugin());
   plugins.push(createHeadingPlugin());
   if (options.placeholder) {
     plugins.push(
@@ -1182,6 +1206,7 @@ exports.createCodeBlockPlugins = createCodeBlockPlugins;
 exports.createHeadingPlugin = createHeadingPlugin;
 exports.createKatexPlugins = createKatexPlugins;
 exports.createKunEditorPlugins = createKunEditorPlugins;
+exports.createLinkPlugin = createLinkPlugin;
 exports.createMentionPlugin = createMentionPlugin;
 exports.createPlaceholderPlugin = createPlaceholderPlugin;
 exports.createQuotePlugin = createQuotePlugin;
@@ -1193,6 +1218,7 @@ exports.createUploader = createUploader;
 exports.editIcon = editIcon;
 exports.imageUploadPlaceholder = imageUploadPlaceholder;
 exports.insertKunSpoilerCommand = insertKunSpoilerCommand;
+exports.insertLinkCommand = insertLinkCommand;
 exports.insertMentionCommand = insertMentionCommand;
 exports.insertQuoteCommand = insertQuoteCommand;
 exports.insertSpoilerInputRule = insertSpoilerInputRule;