@meowdown/core 0.66.0 → 0.67.0

package/dist/index.d.ts

@@ -267,27 +267,36 @@ type MdPackAttrs = {
   revealInFocus: true;
   revealInHide?: null;
 } | {
-  key: 'link';
+  key: 'link-inline' | 'link-reference';
   data: {
-    form: 'inline' | 'reference';
     href: string;
     title: string;
-  } | {
-    form: 'angle';
+  };
+  slot?: 1 | null;
+  revealInFocus: true;
+  revealInHide?: null;
+} | {
+  key: 'link-angle';
+  data: {
     href: string;
   };
   slot?: 1 | null;
   revealInFocus: true;
   revealInHide?: null;
 } | {
-  key: 'link';
+  key: 'link-bare';
   data: {
-    form: 'bare';
     href: string;
   };
   slot?: 1 | null;
   revealInFocus?: null;
   revealInHide?: null;
+} | {
+  key: 'noLink';
+  data?: null;
+  slot?: 1 | null;
+  revealInFocus: true;
+  revealInHide?: null;
 } | {
   key: 'math';
   data?: null;
@@ -364,15 +373,30 @@ export declare function getLinkUnitAt(state: EditorState, pos: number): LinkUnit
 interface LinkAttrs {
   href?: string;
   title?: string;
+  text?: string;
 }
+/**
+ * Normalize a typed URL with the existing autolink logic, else keep it verbatim.
+ */
+export declare function normalizeHref(raw: string): string;
+/**
+ * Get a link's plain visible text.
+ */
+export declare function getLinkText(state: EditorState, link: LinkUnit): string;
+/**
+ * Whether plain visible link text names the same destination as the link.
+ */
+export declare function isLinkTextForHref(text: string, href: string): boolean;
 interface InsertLinkOptions {
   href?: string;
   title?: string;
+  text?: string;
   wrapText?: boolean;
 }
-export declare function insertLink({ href, title, wrapText }?: InsertLinkOptions): Command;
+export declare function insertLink({ href, title, text, wrapText }?: InsertLinkOptions): Command;
 /**
- * Rewrite the `( ... )` of the link at the caret/selection.
+ * Rewrite a mutable link. Autolinks are promoted to inline Markdown when
+ * their visible text or destination changes.
  */
 export declare function updateLink(attrs: LinkAttrs): Command;
 /**
@@ -390,6 +414,7 @@ interface LinkEditOptions {
   from: number;
   to: number;
   link: LinkUnit | undefined;
+  text: string;
 }
 type LinkEditHandler = (options: LinkEditOptions) => void;
 export declare function defineLinkEditKeymap(onLinkEdit: LinkEditHandler): PlainExtension;
@@ -1364,7 +1389,21 @@ interface MarkHoverHit<Payload> {
 //#endregion
 //#region src/extensions/link-hover.d.ts
 type LinkHoverHandler = (hit: MarkHoverHit<LinkUnit> | undefined) => void;
-export declare function defineLinkHoverHandler(onHoverChange: LinkHoverHandler): PlainExtension;
+interface LinkHoverOptions {
+  /**
+   * Return `false` while the pointer is on the popup the link opened: a
+   * pending leave then re-checks later instead of firing.
+   */
+  canLeave?: () => boolean;
+}
+/**
+ * Track the link under the user's attention: a mouse hover after a short
+ * dwell, or a touch tap immediately, since touch has no hover. Without the
+ * tap entry, the popup's preview and actions would stay unreachable on
+ * phones, where a tap on a link only places the caret and raises the
+ * software keyboard.
+ */
+export declare function defineLinkHoverHandler(onHoverChange: LinkHoverHandler, { canLeave }?: LinkHoverOptions): PlainExtension;
 //#endregion
 //#region src/extensions/link-paste.d.ts
 /**
@@ -1382,6 +1421,22 @@ export declare function defineLinkHoverHandler(onHoverChange: LinkHoverHandler):
  */
 export declare function defineLinkPaste(): PlainExtension;
 //#endregion
+//#region src/extensions/link-preview.d.ts
+/**
+ * Metadata a host application can supply for a web link.
+ */
+interface LinkPreview {
+  readonly title: string;
+  readonly description?: string;
+  readonly iconSrc?: string;
+}
+/**
+ * Resolve display metadata for a link, or return `undefined` when unavailable.
+ * Deliberately signal-free to keep the API simple: callers drop stale results
+ * instead of cancelling in-flight work.
+ */
+type LinkPreviewResolver = (href: string) => LinkPreview | undefined | Promise<LinkPreview | undefined>;
+//#endregion
 //#region src/extensions/mark-names.d.ts
 declare const MARK_NAMES: readonly ["mdWikilink", "mdImage", "mdFile", "mdMath", "mdMark", "mdEm", "mdStrong", "mdCode", "mdLinkText", "mdLinkUri", "mdLinkTitle", "mdDel", "mdHighlight", "mdTag", "mdPack"];
 type MarkName = (typeof MARK_NAMES)[number];
@@ -1538,4 +1593,4 @@ export declare function getSelectedText(state: EditorState): string;
  */
 export declare function getVirtualElementFromRange(view: EditorView, range: PositionRange): VirtualElement;
 //#endregion
-export { type AcceptPendingReplacementOptions, type CheckRoundTripOptions, type CodeBlockAttrs, type CodeBlockFenceStyle, type CodeToken, type DocToMarkdownOptions, type EditorExtension, type EditorExtensionOptions, type EmbedDescriptor, type ExitBoundaryHandler, type ExitBoundaryOptions, type FileClickHandler, type FileClickPayload, type FileInfo, type FileInfoResolver, type FileLinkOptions, type FileLinkPayload, type FileLinkResolver, type FilePasteHandler, type FilePasteOptions, type FileSaveErrorHandler, type FileViewOptions, type FollowLinkHandlers, type ImageClickHandler, type ImageClickPayload, type ImageOptions, type InlineMarkContext, type InlineMarkOptions, type KaTeXRender, type LanguageItem, type LinkAttrs, type LinkClickHandler, type LinkClickPayload, type LinkCopyHandler, type LinkCopyPayload, type LinkEditHandler, type LinkEditOptions, type LinkHoverHandler, type LinkUnit, type ListMarker, type MarkChunk, type MarkMode, type MarkName, type MarkdownToDocOptions, type MdFileAttrs, type MdImageAttrs, type MdLinkTextAttrs, type MdMathAttrs, type MdWikilinkAttrs, type MeowdownCodeBlockAttrs, type MeowdownHTMLCommentAttrs, type MeowdownListAttrs, type MeowdownTableCellAttrs, type NodeName, type ParsedWikiEmbed, type PendingReplacement, type PendingReplacementEvent, type PendingReplacementHandler, type PendingReplacementMode, type PendingReplacementOutcome, type PlaceholderOptions, type PositionRange, Priority, type ReferenceDefinition, type ReferenceDefinitionIndex, type ReferenceDefinitions, type RoundTripFidelity, type SearchStatus, type SearchStatusHandler, type StartPendingReplacementOptions, type TableColumnAlign, type TagClickHandler, type TagClickPayload, type TypedEditor, type TypedMarkBuilders, type VirtualElement, type WikiEmbedOptions, type WikiEmbedResolution, type WikiEmbedResolver, type WikilinkClickHandler, type WikilinkClickPayload, type WikilinkHoverHandler, type WikilinkHoverHit, defineCodeBlockPreviewPlugin, definePlaceholder, defineReadonly, defineSearchStatusHandler, getSearchStatus, isCodeBlockPreviewHiddenDecoration, withPriority };
+export { type AcceptPendingReplacementOptions, type CheckRoundTripOptions, type CodeBlockAttrs, type CodeBlockFenceStyle, type CodeToken, type DocToMarkdownOptions, type EditorExtension, type EditorExtensionOptions, type EmbedDescriptor, type ExitBoundaryHandler, type ExitBoundaryOptions, type FileClickHandler, type FileClickPayload, type FileInfo, type FileInfoResolver, type FileLinkOptions, type FileLinkPayload, type FileLinkResolver, type FilePasteHandler, type FilePasteOptions, type FileSaveErrorHandler, type FileViewOptions, type FollowLinkHandlers, type ImageClickHandler, type ImageClickPayload, type ImageOptions, type InlineMarkContext, type InlineMarkOptions, type KaTeXRender, type LanguageItem, type LinkAttrs, type LinkClickHandler, type LinkClickPayload, type LinkCopyHandler, type LinkCopyPayload, type LinkEditHandler, type LinkEditOptions, type LinkHoverHandler, type LinkHoverOptions, type LinkPreview, type LinkPreviewResolver, type LinkUnit, type ListMarker, type MarkChunk, type MarkMode, type MarkName, type MarkdownToDocOptions, type MdFileAttrs, type MdImageAttrs, type MdLinkTextAttrs, type MdMathAttrs, type MdWikilinkAttrs, type MeowdownCodeBlockAttrs, type MeowdownHTMLCommentAttrs, type MeowdownListAttrs, type MeowdownTableCellAttrs, type NodeName, type ParsedWikiEmbed, type PendingReplacement, type PendingReplacementEvent, type PendingReplacementHandler, type PendingReplacementMode, type PendingReplacementOutcome, type PlaceholderOptions, type PositionRange, Priority, type ReferenceDefinition, type ReferenceDefinitionIndex, type ReferenceDefinitions, type RoundTripFidelity, type SearchStatus, type SearchStatusHandler, type StartPendingReplacementOptions, type TableColumnAlign, type TagClickHandler, type TagClickPayload, type TypedEditor, type TypedMarkBuilders, type VirtualElement, type WikiEmbedOptions, type WikiEmbedResolution, type WikiEmbedResolver, type WikilinkClickHandler, type WikilinkClickPayload, type WikilinkHoverHandler, type WikilinkHoverHit, defineCodeBlockPreviewPlugin, definePlaceholder, defineReadonly, defineSearchStatusHandler, getSearchStatus, isCodeBlockPreviewHiddenDecoration, withPriority };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Priority, Priority as Priority$1, createMarkBuilders, createNodeBuilders, defineBaseCommands, defineBaseKeymap, defineClipboardSerializer, defineCommands, defineHistory, defineKeymap, defineMarkSpec, defineMarkView, defineNodeAttr, defineNodeSpec, definePlugin, getMarkRange, getMarkType, getNodeType, isAllSelection, isApple, isAtBlockStart, isNodeSelection, isTextSelection, setBlockType, toggleNode, union, unsetBlockType, withPriority, withPriority as withPriority$1, withSkipCodeBlock } from "@prosekit/core";
+import { Priority, Priority as Priority$1, createMarkBuilders, createNodeBuilders, defineBaseCommands, defineBaseKeymap, defineClipboardSerializer, defineCommands, defineHistory, defineKeymap, defineMarkSpec, defineMarkView, defineNodeAttr, defineNodeSpec, definePlugin, findMarkRange, getMarkRange, getMarkType, getNodeType, isAllSelection, isApple, isAtBlockStart, isNodeSelection, isTextSelection, setBlockType, toggleNode, union, unsetBlockType, withPriority, withPriority as withPriority$1, withSkipCodeBlock } from "@prosekit/core";
 import { defineCodeBlock, defineCodeBlockHighlight, defineCodeBlockPreviewPlugin, isCodeBlockPreviewHiddenDecoration } from "@prosekit/extensions/code-block";
 import { definePlaceholder } from "@prosekit/extensions/placeholder";
 import { defineReadonly } from "@prosekit/extensions/readonly";
@@ -354,13 +354,13 @@ function resolvePosition(state, pos) {
 }
 /**
 * Returns the run of the mark covering `pos`, or `undefined` when none covers
-* it. `attrs` narrows the match to marks whose attributes contain it, which
-* is how a caller picks one level out of a nested stack of the same mark.
+* it. `predicate` narrows the match to marks it accepts, which is how a
+* caller picks one level out of a nested stack of the same mark.
 */
-function getMarkRangeAt(state, pos, markName, attrs) {
+function getMarkRangeAt(state, pos, markName, predicate) {
 	const $pos = resolvePosition(state, pos);
 	if (!$pos) return;
-	return ATOM_MARK_NAMES.includes(markName) ? getAtomUnitRange(state, $pos, markName) : getMarkRange($pos, markName, attrs);
+	return ATOM_MARK_NAMES.includes(markName) ? getAtomUnitRange(state, $pos, markName) : findMarkRange($pos, (mark) => isMarkOfType(mark, markName) && (!predicate || predicate(mark)));
 }
 /**
 * The range of the atom unit touching `$pos`, preferring the child to the
@@ -368,7 +368,7 @@ function getMarkRangeAt(state, pos, markName, attrs) {
 * marks, so eq-based expansion would run across both; the unit boundary comes
 * from the innermost pack instead, which `slot` keeps distinct. A text node
 * without a pack (a document not produced by the inline parser) falls back to
-* the eq-based range. Does not support `attrs` filtering.
+* the eq-based range. Does not support `predicate` filtering.
 */
 function getAtomUnitRange(state, $pos, name) {
 	const parent = $pos.parent;
@@ -2843,10 +2843,12 @@ function parseMagicComment(comment) {
 	if (!isObject(data)) return;
 	const width = toPositiveNumber(data.width);
 	const height = toPositiveNumber(data.height);
-	if (!width && !height) return;
+	const noLink = data.noLink === true ? true : void 0;
+	if (!width && !height && !noLink) return;
 	return {
 		width,
-		height
+		height,
+		noLink
 	};
 }
 function toPositiveNumber(value) {
@@ -3185,6 +3187,14 @@ function walk(nodes, parentMarks, rangeStart, rangeEnd, text, marks, out, option
 			pos = atomEnd;
 			continue;
 		}
+		if (node.type === LEZER_NODE_IDS.URL) {
+			const trailing = takeMagicComments(nodes, index, text);
+			if (trailing?.magic.noLink) {
+				walkUnlinkedURL(node, trailing, parentMarks, marks, out);
+				pos = trailing.to;
+				continue;
+			}
+		}
 		walkNode(node, parentMarks, text, marks, out, options, context);
 		pos = node.to;
 	}
@@ -3251,11 +3261,8 @@ function walkAutolink(node, parentMarks, text, marks, out) {
 	const urlNode = node.children.find((child) => child.type === LEZER_NODE_IDS.URL);
 	const href = urlNode ? getAutolinkHref(text.slice(urlNode.from, urlNode.to)) ?? "" : "";
 	const base = [...parentMarks, createUnitPack(marks, out, parentMarks, node.from, {
-		key: "link",
-		data: {
-			form: "angle",
-			href
-		},
+		key: "link-angle",
+		data: { href },
 		revealInFocus: true
 	})];
 	let pos = node.from;
@@ -3282,15 +3289,26 @@ function walkURL(node, parentMarks, text, marks, out) {
 	emit(out, node.from, node.to, [
 		...parentMarks,
 		createUnitPack(marks, out, parentMarks, node.from, {
-			key: "link",
-			data: {
-				form: "bare",
-				href
-			}
+			key: "link-bare",
+			data: { href }
 		}),
 		marks.mdLinkText.create({ href })
 	]);
 }
+/**
+* A URL followed directly by a `<!-- {"noLink":true} -->` magic comment
+* stays plain text instead of autolinking. The comment rides behind the
+* address as hidden syntax that reveals in focus, so it can be edited or
+* deleted in place.
+*/
+function walkUnlinkedURL(node, trailing, parentMarks, marks, out) {
+	const base = [...parentMarks, createUnitPack(marks, out, parentMarks, node.from, {
+		key: "noLink",
+		revealInFocus: true
+	})];
+	emit(out, node.from, node.to, base);
+	emit(out, node.to, trailing.to, [...base, marks.mdMark.create()]);
+}
 function walkLink(node, parentMarks, text, marks, out, options, context) {
 	const parts = scanLinkParts(node);
 	const resolution = resolveLink(parts, text, context);
@@ -3432,9 +3450,8 @@ function walkResolvedLink(node, parts, resolution, parentMarks, text, marks, out
 	const linkTextMark = marks.mdLinkText.create({ href });
 	const inLabel = (pos) => labelEnd >= 0 && pos < labelEnd;
 	const pack = createUnitPack(marks, out, parentMarks, node.from, {
-		key: "link",
+		key: isReference ? "link-reference" : "link-inline",
 		data: {
-			form: isReference ? "reference" : "inline",
 			href,
 			title
 		},
@@ -3475,9 +3492,9 @@ function walkResolvedLink(node, parts, resolution, parentMarks, text, marks, out
 }
 /**
 * The run of magic comments chained immediately behind `nodes[index]` (an
-* image), or undefined when no magic comment directly abuts it. The first
-* comment's data wins: a rewrite of an unfolded image inserted the fresh
-* comment right at the image's end, so in a stacked run left is newest.
+* image or a URL), or undefined when no magic comment directly abuts it. The
+* first comment's data wins: a rewrite of an unfolded image inserted the
+* fresh comment right at the image's end, so in a stacked run left is newest.
 */
 function takeMagicComments(nodes, index, text) {
 	let magic;
@@ -4496,32 +4513,32 @@ function lastMarkRunIn(state, range, markName) {
 * the `mdLinkUri` run locates the `( )` body.
 */
 function getLinkUnitAt(state, pos) {
-	const unit = getMarkRangeAt(state, pos, "mdPack", { key: "link" });
+	const unit = getMarkRangeAt(state, pos, "mdPack", (mark) => mark.attrs.key.startsWith("link-"));
 	if (!unit) return;
-	const { data } = unit.mark.attrs;
+	const attrs = unit.mark.attrs;
 	const unitRange = {
 		from: unit.from,
 		to: unit.to
 	};
-	switch (data.form) {
-		case "bare": return {
+	switch (attrs.key) {
+		case "link-bare": return {
 			form: "bare",
 			unit: unitRange,
 			text: unitRange,
-			href: data.href,
+			href: attrs.data.href,
 			title: ""
 		};
-		case "angle": return {
+		case "link-angle": return {
 			form: "angle",
 			unit: unitRange,
 			text: {
 				from: unit.from + 1,
 				to: unit.to - 1
 			},
-			href: data.href,
+			href: attrs.data.href,
 			title: ""
 		};
-		case "reference": {
+		case "link-reference": {
 			const linkText = getMarkRangeAt(state, pos, "mdLinkText");
 			return {
 				form: "reference",
@@ -4530,11 +4547,11 @@ function getLinkUnitAt(state, pos) {
 					from: linkText.from + 1,
 					to: linkText.to
 				},
-				href: data.href,
-				title: data.title
+				href: attrs.data.href,
+				title: attrs.data.title
 			};
 		}
-		case "inline": {
+		case "link-inline": {
 			const uri = lastMarkRunIn(state, unitRange, "mdLinkUri");
 			const closeBracket = uri ? uri.from - 2 : unit.to - 3;
 			const destFrom = uri ? uri.from : unit.to - 1;
@@ -4551,8 +4568,8 @@ function getLinkUnitAt(state, pos) {
 					from: destFrom,
 					to: unit.to - 1
 				},
-				href: data.href,
-				title: data.title
+				href: attrs.data.href,
+				title: attrs.data.title
 			};
 		}
 	}
@@ -4574,6 +4591,39 @@ function destText(href, title) {
 	return href + (title ? ` "${title.replaceAll(/(["\\])/g, String.raw`\$1`)}"` : "");
 }
 /**
+* Escape a plain-text label so it cannot pick up inline semantics: the
+* CommonMark delimiters plus meowdown's `==highlight==`, `$math$`, and `#tag`.
+*/
+function linkLabelText(text) {
+	return text.replaceAll(/([&<\\[\]_*`~=$#])/g, String.raw`\$1`);
+}
+/**
+* Get a range's plain visible text, skipping hidden syntax runs.
+*/
+function getVisibleText(state, range) {
+	let text = "";
+	state.doc.nodesBetween(range.from, range.to, (node, pos) => {
+		if (!node.isText || !node.text || hasSyntaxMark(node.marks)) return;
+		const from = Math.max(range.from, pos) - pos;
+		const to = Math.min(range.to, pos + node.nodeSize) - pos;
+		text += node.text.slice(from, to);
+	});
+	return text;
+}
+/**
+* Get a link's plain visible text.
+*/
+function getLinkText(state, link) {
+	return getVisibleText(state, link.text);
+}
+/**
+* Whether plain visible link text names the same destination as the link.
+*/
+function isLinkTextForHref(text, href) {
+	const value = text.trim();
+	return value === href || getAutolinkHref(value) === href;
+}
+/**
 * The range a new link would wrap: the current selection when it is a
 * non-empty text selection inside a single non-code textblock, trimmed of
 * surrounding whitespace. `undefined` when there is nothing to wrap.
@@ -4592,16 +4642,24 @@ function getWrapRange(state) {
 		to: base + to
 	};
 }
-function insertLink({ href, title, wrapText = true } = {}) {
+function insertLink({ href, title, text, wrapText = true } = {}) {
 	return (state, dispatch) => {
 		const range = getWrapRange(state);
 		if (!range) return false;
 		if (dispatch) {
 			const { from, to } = range;
 			const tr = state.tr;
-			const close = `](${destText(normalizeHref(href ?? ""), title ?? "")})`;
-			tr.insertText(close, to).insertText("[", from);
-			const linkTo = to + 1 + close.length;
+			const dest = destText(normalizeHref(href ?? ""), title ?? "");
+			let linkTo;
+			if (text !== void 0 && text !== getVisibleText(state, range)) {
+				const markdown = `[${linkLabelText(text)}](${dest})`;
+				tr.insertText(markdown, from, to);
+				linkTo = from + markdown.length;
+			} else {
+				const close = `](${dest})`;
+				tr.insertText(close, to).insertText("[", from);
+				linkTo = to + 1 + close.length;
+			}
 			tr.setSelection(wrapText ? TextSelection.create(tr.doc, from, linkTo) : TextSelection.create(tr.doc, linkTo));
 			tr.scrollIntoView();
 			dispatch(tr);
@@ -4610,14 +4668,18 @@ function insertLink({ href, title, wrapText = true } = {}) {
 	};
 }
 /**
-* Rewrite the `( ... )` of the link at the caret/selection.
+* Rewrite a mutable link. Autolinks are promoted to inline Markdown when
+* their visible text or destination changes.
 */
 function updateLink(attrs) {
 	return (state, dispatch) => {
 		const link = getLinkUnitAt(state, state.selection.from);
-		if (link?.form !== "inline") return false;
-		const dest = destText(normalizeHref(attrs.href ?? link.href), attrs.title ?? link.title);
-		if (dispatch) dispatch(state.tr.insertText(dest, link.dest.from, link.dest.to).scrollIntoView());
+		if (!link || link.form === "reference") return false;
+		const href = normalizeHref(attrs.href ?? link.href);
+		const title = attrs.title ?? link.title;
+		const text = attrs.text ?? getLinkText(state, link);
+		const replacingUnit = attrs.text !== void 0 || link.form !== "inline";
+		if (dispatch) dispatch((replacingUnit ? state.tr.insertText(`[${linkLabelText(text)}](${destText(href, title)})`, link.unit.from, link.unit.to) : state.tr.insertText(destText(href, title), link.dest.from, link.dest.to)).scrollIntoView());
 		return true;
 	};
 }
@@ -4627,8 +4689,11 @@ function updateLink(attrs) {
 function removeLink() {
 	return (state, dispatch) => {
 		const link = getLinkUnitAt(state, state.selection.from);
-		if (link?.form !== "inline") return false;
-		if (dispatch) dispatch(state.tr.delete(link.label.to, link.unit.to).delete(link.unit.from, link.label.from).scrollIntoView());
+		if (!link || link.form === "reference") return false;
+		if (dispatch) {
+			const text = getLinkText(state, link);
+			dispatch((link.form === "inline" && !getAutolinkHref(text) ? state.tr.delete(link.label.to, link.unit.to).delete(link.unit.from, link.label.from) : state.tr.insertText(text + formatMagicComment({ noLink: true }), link.unit.from, link.unit.to)).scrollIntoView());
+		}
 		return true;
 	};
 }
@@ -4643,7 +4708,7 @@ function openLinkEdit(onLinkEdit) {
 	return (state, dispatch, view) => {
 		const link = getLinkUnitAt(state, state.selection.from);
 		if (link) {
-			if (link.form !== "inline") return false;
+			if (link.form === "reference") return false;
 			if (dispatch && view) {
 				const { unit: { from, to } } = link;
 				dispatch(state.tr.setSelection(TextSelection.create(state.doc, from, to)).scrollIntoView());
@@ -4651,7 +4716,8 @@ function openLinkEdit(onLinkEdit) {
 				onLinkEdit({
 					from,
 					to,
-					link
+					link,
+					text: getLinkText(state, link)
 				});
 			}
 			return true;
@@ -4665,7 +4731,8 @@ function openLinkEdit(onLinkEdit) {
 				onLinkEdit({
 					from,
 					to,
-					link: void 0
+					link: void 0,
+					text: getVisibleText(state, wrapRange)
 				});
 			}
 			return true;
@@ -7986,36 +8053,98 @@ function defineLinkClickHandler(onClick) {
 * after every editor update, so deleting, replacing, or rewriting a hovered
 * mark emits leave even when the pointer itself never moves. Destroying the
 * editor or removing the extension emits leave as well.
+*
+* With `tap`, a touch tap enters too. The browser is the tap recognizer:
+* only a recognized stationary single-finger tap synthesizes the
+* compatibility mouse events and the trailing `click`; scrolls, drags,
+* long-presses, and multi-finger gestures never produce them.
 */
 function defineMarkHoverHandler(config) {
-	let current;
+	const { openDelay, closeDelay, tap } = config;
+	/**
+	* What `onHoverChange` last received, while that is a hit.
+	*/
+	let emitted;
+	let timer;
+	/**
+	* The element of a scheduled enter, `null` for a scheduled leave,
+	* `undefined` when nothing is scheduled.
+	*/
+	let scheduledElement;
+	/**
+	* The type of the pointer that spawned the current event sequence:
+	* compatibility mouse events carry no pointer type of their own.
+	*/
+	let lastPointerType = "";
+	const findClosestMark = (target) => {
+		return isElementLike(target) ? target.closest(config.selector) : null;
+	};
 	const findPayloadForElement = (view, element) => {
 		return config.findPayloadForElement ? config.findPayloadForElement(view, element) : config.findPayloadAt(view.state, view.posAtDOM(element, 0));
 	};
-	const leave = () => {
-		if (!current) return;
-		current = void 0;
-		config.onHoverChange(void 0);
+	const cancel = () => {
+		clearTimeout(timer);
+		scheduledElement = void 0;
 	};
-	const handleOver = (view, event) => {
-		const target = event.target;
-		if (!target || !isElementLike(target)) return;
-		const element = target.closest(config.selector);
-		if (!element || !view.dom.contains(element) || element === current?.element) return;
-		leave();
+	const emit = (hit) => {
+		cancel();
+		if (!hit && !emitted) return;
+		emitted = hit;
+		config.onHoverChange(hit);
+	};
+	const scheduleLeave = () => {
+		cancel();
+		scheduledElement = null;
+		const fire = () => {
+			if (config.canLeave?.() === false) {
+				timer = setTimeout(fire, closeDelay);
+				return;
+			}
+			emit(void 0);
+		};
+		timer = setTimeout(fire, closeDelay);
+	};
+	const enter = (view, element) => {
 		const payload = findPayloadForElement(view, element);
 		if (payload == null) return;
-		current = {
-			payload,
-			element
-		};
-		config.onHoverChange(current);
+		if (emitted) {
+			emit({
+				payload,
+				element
+			});
+			return;
+		}
+		cancel();
+		scheduledElement = element;
+		timer = setTimeout(() => {
+			const fresh = element.isConnected ? findPayloadForElement(view, element) : void 0;
+			if (fresh == null) {
+				cancel();
+				return;
+			}
+			emit({
+				payload: fresh,
+				element
+			});
+		}, openDelay);
+	};
+	const handleOver = (view, event) => {
+		const element = findClosestMark(event.target);
+		if (!element || !view.dom.contains(element)) return;
+		if (element === emitted?.element) {
+			if (scheduledElement === null) cancel();
+			return;
+		}
+		if (element === scheduledElement) return;
+		enter(view, element);
 	};
 	const handleOut = (event) => {
-		if (!current) return;
+		const active = emitted?.element ?? scheduledElement;
+		if (!active) return;
 		const related = event.relatedTarget;
-		if (related instanceof Node && current.element.contains(related)) return;
-		leave();
+		if (related instanceof Node && active.contains(related)) return;
+		if (emitted) scheduleLeave();
+		else cancel();
 	};
 	return definePlugin(new Plugin({
 		key: config.key,
@@ -8027,26 +8156,52 @@ function defineMarkHoverHandler(config) {
 			mouseout: (_view, event) => {
 				handleOut(event);
 				return false;
+			},
+			...tap && {
+				pointerdown: (_view, event) => {
+					lastPointerType = event.pointerType;
+					return false;
+				},
+				mousedown: (_view, event) => {
+					if (lastPointerType !== "touch" || !findClosestMark(event.target)) return false;
+					event.preventDefault();
+					return true;
+				},
+				click: (view, event) => {
+					if (lastPointerType !== "touch") return false;
+					const element = findClosestMark(event.target);
+					if (!element || !view.dom.contains(element)) {
+						emit(void 0);
+						return false;
+					}
+					event.preventDefault();
+					const payload = findPayloadForElement(view, element);
+					if (payload != null) emit({
+						payload,
+						element
+					});
+					return true;
+				}
 			}
 		} },
 		view: () => ({
 			update: (view) => {
-				if (!current) return;
-				if (!current.element.isConnected || !view.dom.contains(current.element)) {
-					leave();
+				if (!emitted) return;
+				if (!emitted.element.isConnected || !view.dom.contains(emitted.element)) {
+					emit(void 0);
 					return;
 				}
-				const payload = findPayloadForElement(view, current.element);
-				if (payload == null || !config.isSamePayload(current.payload, payload)) {
-					leave();
+				const payload = findPayloadForElement(view, emitted.element);
+				if (payload == null || !config.isSamePayload(emitted.payload, payload)) {
+					emit(void 0);
 					return;
 				}
-				current = {
-					...current,
+				emitted = {
+					...emitted,
 					payload
 				};
 			},
-			destroy: leave
+			destroy: () => emit(void 0)
 		})
 	}));
 }
@@ -8054,10 +8209,30 @@ function defineMarkHoverHandler(config) {
 //#endregion
 //#region src/extensions/link-hover.ts
 const linkHoverKey = new PluginKey("meowdown-link-hover");
-function defineLinkHoverHandler(onHoverChange) {
+/**
+* Dwell before a cold hover enters, in ms.
+*/
+const OPEN_DELAY = 300;
+/**
+* Grace before a leave fires, in ms. The window lets a pointer travel from
+* the hovered link onto the popup it anchors.
+*/
+const CLOSE_DELAY = 100;
+/**
+* Track the link under the user's attention: a mouse hover after a short
+* dwell, or a touch tap immediately, since touch has no hover. Without the
+* tap entry, the popup's preview and actions would stay unreachable on
+* phones, where a tap on a link only places the caret and raises the
+* software keyboard.
+*/
+function defineLinkHoverHandler(onHoverChange, { canLeave } = {}) {
 	return defineMarkHoverHandler({
 		key: linkHoverKey,
 		selector: ".md-link",
+		openDelay: OPEN_DELAY,
+		closeDelay: CLOSE_DELAY,
+		tap: true,
+		canLeave,
 		findPayloadAt: (state, pos) => {
 			return getLinkUnitAt(state, pos);
 		},
@@ -8444,6 +8619,9 @@ function defineWikilinkHoverHandler(onHoverChange) {
 	return defineMarkHoverHandler({
 		key: wikilinkHoverKey,
 		selector: ".md-wikilink-view-preview",
+		openDelay: 0,
+		closeDelay: 0,
+		tap: false,
 		findPayloadAt: findWikilinkAt,
 		findPayloadForElement: findWikilinkForElement,
 		isSamePayload: (previous, next) => previous.target === next.target,
@@ -8611,4 +8789,4 @@ function getVirtualElementFromRange(view, range) {
 }
 
 //#endregion
-export { EDITOR_KEY_BINDINGS, Priority, buildFileMarkdown, checkRoundTrip, codeBlockLanguages, collectReferenceDefinitions, defaultResolveImageUrl, defineBulletAfterHeading, defineCodeBlockPreviewPlugin, defineCodeBlockSyntaxHighlight, defineEditorExtension, defineEmbedPaste, defineExitBoundaryHandler, defineFileClickHandler, defineFilePaste, defineFileView, defineFollowLinkHandler, defineHTMLComment, defineImage, defineImageClickHandler, defineLinkClickHandler, defineLinkCommands, defineLinkEditKeymap, defineLinkHoverHandler, defineLinkPaste, defineMath, definePendingReplacementHandler, definePlaceholder, defineReadonly, defineSearchStatusHandler, defineSubstitution, defineTagClickHandler, defineViewAttributes, defineVirtualCaret, defineWikilinkClickHandler, defineWikilinkHoverHandler, defineWikilinkTrigger, docToMarkdown, formatFileSize, formatSizedWikiEmbed, getCodeTokens, getFileKind, getIsComposing, getLinkUnitAt, getMarkBuilders, getPendingReplacement, getSearchStatus, getSelectedText, getTableColumnAlign, getTextblockDisplayText, getVirtualElementFromRange, inlineTextToMarkChunks, inlineTextToMarkChunksWithContext, insertLink, isCodeBlockPreviewHiddenDecoration, isMarkOfType, isModEvent, isNodeOfType, isSelectionInTableCell, listenForTweetHeight, loadKaTeX, markdownToDoc, matchEmbed, parseWikiEmbed, removeLink, renderMathInto, updateLink, wikiEmbedBasename, withPriority };
+export { EDITOR_KEY_BINDINGS, Priority, buildFileMarkdown, checkRoundTrip, codeBlockLanguages, collectReferenceDefinitions, defaultResolveImageUrl, defineBulletAfterHeading, defineCodeBlockPreviewPlugin, defineCodeBlockSyntaxHighlight, defineEditorExtension, defineEmbedPaste, defineExitBoundaryHandler, defineFileClickHandler, defineFilePaste, defineFileView, defineFollowLinkHandler, defineHTMLComment, defineImage, defineImageClickHandler, defineLinkClickHandler, defineLinkCommands, defineLinkEditKeymap, defineLinkHoverHandler, defineLinkPaste, defineMath, definePendingReplacementHandler, definePlaceholder, defineReadonly, defineSearchStatusHandler, defineSubstitution, defineTagClickHandler, defineViewAttributes, defineVirtualCaret, defineWikilinkClickHandler, defineWikilinkHoverHandler, defineWikilinkTrigger, docToMarkdown, formatFileSize, formatSizedWikiEmbed, getCodeTokens, getFileKind, getIsComposing, getLinkText, getLinkUnitAt, getMarkBuilders, getPendingReplacement, getSearchStatus, getSelectedText, getTableColumnAlign, getTextblockDisplayText, getVirtualElementFromRange, inlineTextToMarkChunks, inlineTextToMarkChunksWithContext, insertLink, isCodeBlockPreviewHiddenDecoration, isLinkTextForHref, isMarkOfType, isModEvent, isNodeOfType, isSelectionInTableCell, listenForTweetHeight, loadKaTeX, markdownToDoc, matchEmbed, normalizeHref, parseWikiEmbed, removeLink, renderMathInto, updateLink, wikiEmbedBasename, withPriority };

package/dist/style.css

@@ -155,6 +155,7 @@
     --meowdown-heading: light-dark(oklch(21% .006 286), oklch(98.5% 0 0));
     --meowdown-muted: light-dark(oklch(44.2% .015 286), oklch(71.2% .013 286));
     --meowdown-accent: light-dark(oklch(64.6% .194 41), oklch(75.8% .159 56));
+    --meowdown-accent-contrast: light-dark(oklch(100% 0 0), oklch(21% .006 286));
     --meowdown-caret: var(--meowdown-accent);
     --meowdown-caret-glide: 80ms;
     --meowdown-mark: var(--meowdown-muted);
@@ -189,6 +190,9 @@
     --meowdown-table-header-bg: light-dark(oklch(98.5% 0 0), oklch(27.4% .005 286));
     --meowdown-popover-bg: light-dark(oklch(100% 0 0), oklch(21% .006 286));
     --meowdown-popover-hover-bg: light-dark(oklch(96.7% 0 0), oklch(27.4% .005 286));
+    --meowdown-hover-card-border: var(--meowdown-border);
+    --meowdown-hover-card-radius: .75rem;
+    --meowdown-hover-card-shadow: 0 10px 15px -3px #0000001a, 0 4px 6px -4px #0000001a;
     --meowdown-danger: light-dark(oklch(63.7% .208 25), oklch(71.1% .166 22));
     --meowdown-placeholder: var(--meowdown-muted);
     --meowdown-font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/core",
   "type": "module",
-  "version": "0.66.0",
+  "version": "0.67.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,10 +26,10 @@
     "@floating-ui/dom": "^1.8.0",
     "@lezer/highlight": "^1.2.3",
     "@ocavue/utils": "^1.7.0",
-    "@prosekit/core": "^0.13.0",
-    "@prosekit/extensions": "^0.18.0",
+    "@prosekit/core": "^0.13.1",
+    "@prosekit/extensions": "^0.18.1",
     "@prosekit/pm": "^0.1.19",
-    "@prosekit/web": "^0.9.0",
+    "@prosekit/web": "^0.9.1",
     "hast-util-to-mdast": "^10.1.2",
     "katex": "^0.18.1",
     "mdast-util-to-markdown": "^2.1.2",
@@ -43,20 +43,20 @@
     "remark-stringify": "^11.0.0",
     "unicode-by-name": "^0.2.0",
     "unified": "^11.0.5",
-    "@meowdown/markdown": "^0.66.0"
+    "@meowdown/markdown": "^0.67.0"
   },
   "devDependencies": {
     "@ocavue/tsconfig": "^0.7.1",
     "@tsdown/css": "^0.23.0-beta.2",
     "@types/hast": "^3.0.5",
     "@types/mdast": "^4.0.4",
-    "@vitest/browser-playwright": "^4.1.10",
+    "@vitest/browser-playwright": "^4.1.11",
     "commonmark.json": "^0.31.0",
     "dedent": "^1.7.2",
     "diffable-html-snapshot": "^0.3.0",
     "fast-check": "^4.9.0",
     "tsdown": "^0.23.0-beta.2",
-    "vitest": "^4.1.10",
+    "vitest": "^4.1.11",
     "@meowdown/vitest": "0.0.0"
   },
   "publishConfig": {