@meowdown/core 0.74.1 → 0.74.2

package/dist/index.d.ts

@@ -1482,6 +1482,12 @@ interface LinkHoverOptions {
  * software keyboard.
  */
 export declare function defineLinkHoverHandler(onHoverChange: LinkHoverHandler, { canLeave }?: LinkHoverOptions): PlainExtension;
+/**
+ * Tell the link hover handler that the user dismissed the UI it opened. The
+ * link under the pointer stays silent until the pointer leaves it, so a
+ * pending hover cannot reopen the UI.
+ */
+export declare function dismissLinkHover(state: EditorState): void;
 //#endregion
 //#region src/extensions/link-paste.d.ts
 /**

package/dist/index.js

@@ -84,20 +84,86 @@ function getIsComposing() {
 }
 
 //#endregion
-//#region src/utils/transaction.ts
+//#region src/utils/input-modality.ts
+const KEYBOARD_MODALITY_KEYS = /* @__PURE__ */ new Set([
+	"ArrowLeft",
+	"ArrowRight",
+	"ArrowUp",
+	"ArrowDown",
+	"Home",
+	"End",
+	"PageUp",
+	"PageDown"
+]);
+let lastIsTouchInput = false;
+let lastIsPointerSelection = false;
+const listeners = /* @__PURE__ */ new Set();
+function setIsTouchInput(isTouchInput) {
+	if (isTouchInput === lastIsTouchInput) return;
+	lastIsTouchInput = isTouchInput;
+	for (const listener of listeners) listener();
+}
+function handlePointerDown(event) {
+	const target = event.target;
+	lastIsPointerSelection = target instanceof Element && !!target.closest(".ProseMirror");
+	const pointerType = event.pointerType;
+	if (pointerType === "mouse") setIsTouchInput(false);
+	else if (pointerType === "touch" || pointerType === "pen") setIsTouchInput(true);
+}
+function handleKeyDown(event) {
+	if (getIsComposing() || event.isComposing) return;
+	lastIsPointerSelection = false;
+	if (KEYBOARD_MODALITY_KEYS.has(event.key) || event.metaKey || event.ctrlKey) setIsTouchInput(false);
+}
+if (typeof window !== "undefined") {
+	window.addEventListener("pointerdown", handlePointerDown, {
+		capture: true,
+		passive: true
+	});
+	window.addEventListener("keydown", handleKeyDown, {
+		capture: true,
+		passive: true
+	});
+}
 /**
-* Whether the given transaction is selection transactions directly caused by mouse or touch input.
+* Whether the user last drove the selection with a finger (or pen) on the
+* screen, as opposed to precise input (hardware keyboard navigation).
 *
-* See https://code.haverbeke.berlin/prosemirror/prosemirror-view/src/tag/1.42.2/src/input.ts#L191
+* Starts as `false` and follows the events; a touch device flips it on the
+* first tap, which necessarily precedes any caret. Only navigation keys and
+* modifier combos flip it back: letter keys are ignored because a software
+* keyboard sends them too, and the software keyboard's own caret gestures (a
+* spacebar long-press drag) reach the page as bare `selectionchange` events
+* with no key or touch events at all, so staying on the previous value is the
+* correct reading for them.
+*/
+function getIsTouchInput() {
+	return lastIsTouchInput;
+}
+/**
+* Whether the next selection change in an editor comes from a pointer: the
+* last `pointerdown` landed inside an editor and no key was pressed since.
 */
-function isPointerSelectionTransaction(tr) {
-	return !!tr.getMeta("pointer");
+function getIsPointerSelection() {
+	return lastIsPointerSelection;
 }
 /**
+* Calls `listener` whenever {@link getIsTouchInput} may report a new value.
+*/
+function onIsTouchInputChange(listener) {
+	listeners.add(listener);
+	return () => {
+		listeners.delete(listener);
+	};
+}
+
+//#endregion
+//#region src/utils/transaction.ts
+/**
 * Whether any of the given transactions are selection transactions directly caused by mouse or touch input.
 */
 function hasPointerSelectionTransaction(transactions) {
-	return transactions.some(isPointerSelectionTransaction);
+	return getIsPointerSelection() && transactions.some((tr) => tr.selectionSet && !tr.docChanged);
 }
 
 //#endregion
@@ -512,9 +578,8 @@ function createCaretSnapPlugin(marks) {
 			if (markNames.length === 0) return null;
 			const selection = newState.selection;
 			if (!isTextSelection(selection)) return null;
-			const isPointer = hasPointerSelectionTransaction(transactions);
 			if (!selection.empty) {
-				if (!isPointer) return null;
+				if (!hasPointerSelectionTransaction(transactions)) return null;
 				const from = getMarkRangeStrictlyAround(newState, selection.from, markNames)?.from ?? selection.from;
 				const to = getMarkRangeStrictlyAround(newState, selection.to, markNames)?.to ?? selection.to;
 				if (from === selection.from && to === selection.to) return null;
@@ -524,6 +589,7 @@ function createCaretSnapPlugin(marks) {
 			}
 			const range = getMarkRangeStrictlyAround(newState, selection.head, markNames);
 			if (!range) return null;
+			const isPointer = hasPointerSelectionTransaction(transactions);
 			const head = getUnitEdge(range, oldState.selection.head, selection.head, isPointer);
 			return newState.tr.setSelection(TextSelection.create(newState.doc, head));
 		}
@@ -614,6 +680,9 @@ function handleMouseDown(view, event) {
 	const { doc } = view.state;
 	const lastBlock = doc.lastChild;
 	if (!lastBlock || acceptsCaretAtEnd(lastBlock)) return false;
+	let bottom = lastBlock;
+	while (bottom && !bottom.isTextblock && !isNodeOfType(bottom, "table")) bottom = bottom.lastChild;
+	if (bottom && bottom.content.size === 0 && acceptsCaretAtEnd(bottom)) return false;
 	const lastBlockDOM = view.nodeDOM(doc.content.size - lastBlock.nodeSize);
 	if (!(lastBlockDOM instanceof HTMLElement)) return false;
 	if (event.clientY <= lastBlockDOM.getBoundingClientRect().bottom) return false;
@@ -628,7 +697,8 @@ function handleMouseDown(view, event) {
 }
 /**
 * A press below the last block appends an empty paragraph and puts the caret
-* in it, when that block would otherwise keep the caret inside itself.
+* in it, when that block would otherwise keep the caret inside itself and
+* does not end in an empty line.
 */
 function defineClickBelow() {
 	return definePlugin(new Plugin({
@@ -3469,8 +3539,8 @@ function createSnapPlugin() {
 			if (getMarkMode(newState) !== "hide") return null;
 			const selection = newState.selection;
 			if (!isTextSelection(selection)) return null;
-			const isPointer = hasPointerSelectionTransaction(transactions);
 			if (selection.empty) {
+				const isPointer = hasPointerSelectionTransaction(transactions);
 				const next = getRestPosition(newState, oldState.selection.head, selection.head, isPointer);
 				if (next === selection.head) return null;
 				return newState.tr.setSelection(TextSelection.create(newState.doc, next));
@@ -8478,32 +8548,29 @@ const EDITOR_KEY_BINDINGS = {
 
 //#endregion
 //#region src/extensions/mark-hover.ts
+const IDLE = { kind: "idle" };
+function getHit(phase) {
+	return phase.kind === "active" || phase.kind === "leaving" ? phase.hit : void 0;
+}
 /**
-* Delegate hover tracking for a rendered mark to the editor root.
-*
-* Movement within a mark is de-duplicated. The active hit is also revalidated
-* 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.
+* The tracked element the pointer is on, if any.
 */
-function defineMarkHoverHandler(config) {
-	const { openDelay, closeDelay, tap } = config;
+function getPointerElement(phase) {
+	switch (phase.kind) {
+		case "pending":
+		case "dismissed": return phase.element;
+		case "active": return phase.hit.element;
+		default: return;
+	}
+}
+function createHoverTracker(config) {
+	const { openDelay, closeDelay } = config;
+	let phase = IDLE;
 	/**
-	* What `onHoverChange` last received, while that is a hit.
+	* Runs exactly while the phase is `pending` or `leaving`.
 	*/
-	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.
 	*/
@@ -8514,127 +8581,201 @@ function defineMarkHoverHandler(config) {
 	const findPayloadForElement = (view, element) => {
 		return config.findPayloadForElement ? config.findPayloadForElement(view, element) : config.findPayloadAt(view.state, view.posAtDOM(element, 0));
 	};
-	const cancel = () => {
+	/**
+	* The only transition. It restarts the timer the next phase needs and
+	* reports a change of the hit element.
+	*/
+	const go = (next) => {
 		clearTimeout(timer);
-		scheduledElement = void 0;
+		const previousHit = getHit(phase);
+		phase = next;
+		if (next.kind === "pending") timer = setTimeout(finishOpen, openDelay);
+		if (next.kind === "leaving") timer = setTimeout(finishLeave, closeDelay);
+		const hit = getHit(next);
+		if (hit?.element !== previousHit?.element) config.onHoverChange(hit);
 	};
-	const emit = (hit) => {
-		cancel();
-		if (!hit && !emitted) return;
-		emitted = hit;
-		config.onHoverChange(hit);
+	const finishOpen = () => {
+		if (phase.kind !== "pending") return;
+		const { element, view } = phase;
+		const payload = element.isConnected ? findPayloadForElement(view, element) : void 0;
+		go(payload == null ? IDLE : {
+			kind: "active",
+			hit: {
+				payload,
+				element
+			}
+		});
+	};
+	const finishLeave = () => {
+		if (phase.kind !== "leaving") return;
+		go(config.canLeave?.() === false ? phase : IDLE);
+	};
+	const startPending = (view, element) => {
+		if (findPayloadForElement(view, element) == null) return;
+		go({
+			kind: "pending",
+			element,
+			view
+		});
 	};
-	const scheduleLeave = () => {
-		cancel();
-		scheduledElement = null;
-		const fire = () => {
-			if (config.canLeave?.() === false) {
-				timer = setTimeout(fire, closeDelay);
+	const handleOver = (view, event) => {
+		const element = findClosestMark(event.target);
+		if (!element || !view.dom.contains(element)) return;
+		switch (phase.kind) {
+			case "idle": return startPending(view, element);
+			case "pending":
+			case "dismissed":
+				if (element !== phase.element) startPending(view, element);
+				return;
+			case "active":
+			case "leaving": {
+				if (element === phase.hit.element) return go({
+					kind: "active",
+					hit: phase.hit
+				});
+				const payload = findPayloadForElement(view, element);
+				if (payload != null) go({
+					kind: "active",
+					hit: {
+						payload,
+						element
+					}
+				});
 				return;
 			}
-			emit(void 0);
-		};
-		timer = setTimeout(fire, closeDelay);
+		}
 	};
-	const enter = (view, element) => {
+	const handleOut = (event) => {
+		const element = getPointerElement(phase);
+		if (!element) return;
+		const related = event.relatedTarget;
+		if (related instanceof Node && element.contains(related)) return;
+		go(phase.kind === "active" ? {
+			kind: "leaving",
+			hit: phase.hit
+		} : IDLE);
+	};
+	const handlePointerDown = (event) => {
+		lastPointerType = event.pointerType;
+	};
+	const handleMouseDown = (event) => {
+		if (lastPointerType !== "touch" || !findClosestMark(event.target)) return false;
+		event.preventDefault();
+		return true;
+	};
+	const handleClick = (view, event) => {
+		if (lastPointerType !== "touch") return false;
+		const element = findClosestMark(event.target);
+		if (!element || !view.dom.contains(element)) {
+			go(IDLE);
+			return false;
+		}
+		event.preventDefault();
 		const payload = findPayloadForElement(view, element);
-		if (payload == null) return;
-		if (emitted) {
-			emit({
+		if (payload != null) go({
+			kind: "active",
+			hit: {
 				payload,
 				element
-			});
+			}
+		});
+		return true;
+	};
+	const update = (view) => {
+		if (phase.kind === "dismissed") {
+			if (!view.dom.contains(phase.element)) go(IDLE);
 			return;
 		}
-		cancel();
-		scheduledElement = element;
-		timer = setTimeout(() => {
-			const fresh = element.isConnected ? findPayloadForElement(view, element) : void 0;
-			if (fresh == null) {
-				cancel();
-				return;
-			}
-			emit({
-				payload: fresh,
+		if (phase.kind !== "active" && phase.kind !== "leaving") return;
+		const { element } = phase.hit;
+		if (!element.isConnected || !view.dom.contains(element)) return go(IDLE);
+		const payload = findPayloadForElement(view, element);
+		if (payload == null || !config.isSamePayload(phase.hit.payload, payload)) return go(IDLE);
+		phase = {
+			kind: phase.kind,
+			hit: {
+				payload,
 				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;
+	const dismiss = () => {
+		switch (phase.kind) {
+			case "pending": return go({
+				kind: "dismissed",
+				element: phase.element
+			});
+			case "active": return go({
+				kind: "dismissed",
+				element: phase.hit.element
+			});
+			case "leaving": return go(IDLE);
 		}
-		if (element === scheduledElement) return;
-		enter(view, element);
 	};
-	const handleOut = (event) => {
-		const active = emitted?.element ?? scheduledElement;
-		if (!active) return;
-		const related = event.relatedTarget;
-		if (related instanceof Node && active.contains(related)) return;
-		if (emitted) scheduleLeave();
-		else cancel();
+	return {
+		handleOver,
+		handleOut,
+		handlePointerDown,
+		handleMouseDown,
+		handleClick,
+		update,
+		dismiss,
+		destroy: () => go(IDLE)
 	};
+}
+/**
+* Delegate hover tracking for a rendered mark to the editor root.
+*
+* Movement within a mark is de-duplicated. The active hit is also revalidated
+* 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.
+*
+* The tracker lives in the plugin state, so `key.getState(state)?.dismiss()`
+* reaches the one tracking that editor.
+*/
+function defineMarkHoverHandler(config) {
+	const { key } = config;
 	return definePlugin(new Plugin({
-		key: config.key,
+		key,
+		state: {
+			init: () => createHoverTracker(config),
+			apply: (_tr, tracker) => tracker
+		},
 		props: { handleDOMEvents: {
 			mouseover: (view, event) => {
-				handleOver(view, event);
+				key.getState(view.state)?.handleOver(view, event);
 				return false;
 			},
-			mouseout: (_view, event) => {
-				handleOut(event);
+			mouseout: (view, event) => {
+				key.getState(view.state)?.handleOut(event);
 				return false;
 			},
-			...tap && {
-				pointerdown: (_view, event) => {
-					lastPointerType = event.pointerType;
+			...config.tap && {
+				pointerdown: (view, event) => {
+					key.getState(view.state)?.handlePointerDown(event);
 					return false;
 				},
-				mousedown: (_view, event) => {
-					if (lastPointerType !== "touch" || !findClosestMark(event.target)) return false;
-					event.preventDefault();
-					return true;
+				mousedown: (view, event) => {
+					return key.getState(view.state)?.handleMouseDown(event) ?? false;
 				},
 				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;
+					return key.getState(view.state)?.handleClick(view, event) ?? false;
 				}
 			}
 		} },
-		view: () => ({
-			update: (view) => {
-				if (!emitted) return;
-				if (!emitted.element.isConnected || !view.dom.contains(emitted.element)) {
-					emit(void 0);
-					return;
-				}
-				const payload = findPayloadForElement(view, emitted.element);
-				if (payload == null || !config.isSamePayload(emitted.payload, payload)) {
-					emit(void 0);
-					return;
-				}
-				emitted = {
-					...emitted,
-					payload
-				};
-			},
-			destroy: () => emit(void 0)
-		})
+		view: (view) => {
+			const tracker = key.getState(view.state);
+			return {
+				update: (view) => tracker?.update(view),
+				destroy: () => tracker?.destroy()
+			};
+		}
 	}));
 }
 
@@ -8674,6 +8815,14 @@ function defineLinkHoverHandler(onHoverChange, { canLeave } = {}) {
 		onHoverChange
 	});
 }
+/**
+* Tell the link hover handler that the user dismissed the UI it opened. The
+* link under the pointer stays silent until the pointer leaves it, so a
+* pending hover cannot reopen the UI.
+*/
+function dismissLinkHover(state) {
+	linkHoverKey.getState(state)?.dismiss();
+}
 
 //#endregion
 //#region src/utils/force-reflow.ts
@@ -8681,69 +8830,6 @@ function forceReflow(element) {
 	element.offsetWidth;
 }
 
-//#endregion
-//#region src/utils/input-modality.ts
-const KEYBOARD_MODALITY_KEYS = /* @__PURE__ */ new Set([
-	"ArrowLeft",
-	"ArrowRight",
-	"ArrowUp",
-	"ArrowDown",
-	"Home",
-	"End",
-	"PageUp",
-	"PageDown"
-]);
-let lastIsTouchInput = false;
-const listeners = /* @__PURE__ */ new Set();
-function setIsTouchInput(isTouchInput) {
-	if (isTouchInput === lastIsTouchInput) return;
-	lastIsTouchInput = isTouchInput;
-	for (const listener of listeners) listener();
-}
-function handlePointerDown(event) {
-	const pointerType = event.pointerType;
-	if (pointerType === "mouse") setIsTouchInput(false);
-	else if (pointerType === "touch" || pointerType === "pen") setIsTouchInput(true);
-}
-function handleKeyDown(event) {
-	if (getIsComposing() || event.isComposing) return;
-	if (KEYBOARD_MODALITY_KEYS.has(event.key) || event.metaKey || event.ctrlKey) setIsTouchInput(false);
-}
-if (typeof window !== "undefined") {
-	window.addEventListener("pointerdown", handlePointerDown, {
-		capture: true,
-		passive: true
-	});
-	window.addEventListener("keydown", handleKeyDown, {
-		capture: true,
-		passive: true
-	});
-}
-/**
-* Whether the user last drove the selection with a finger (or pen) on the
-* screen, as opposed to precise input (hardware keyboard navigation).
-*
-* Starts as `false` and follows the events; a touch device flips it on the
-* first tap, which necessarily precedes any caret. Only navigation keys and
-* modifier combos flip it back: letter keys are ignored because a software
-* keyboard sends them too, and the software keyboard's own caret gestures (a
-* spacebar long-press drag) reach the page as bare `selectionchange` events
-* with no key or touch events at all, so staying on the previous value is the
-* correct reading for them.
-*/
-function getIsTouchInput() {
-	return lastIsTouchInput;
-}
-/**
-* Calls `listener` whenever {@link getIsTouchInput} may report a new value.
-*/
-function onIsTouchInputChange(listener) {
-	listeners.add(listener);
-	return () => {
-		listeners.delete(listener);
-	};
-}
-
 //#endregion
 //#region src/extensions/virtual-caret.ts
 const key = new PluginKey("meowdown-virtual-caret");
@@ -9041,4 +9127,4 @@ function getVirtualElementFromRange(view, range) {
 }
 
 //#endregion
-export { EDITOR_KEY_BINDINGS, Priority, buildFileMarkdown, checkRoundTrip, codeBlockLanguages, collectReferenceDefinitions, defaultResolveImageUrl, defaultResolveXPost, defaultResolveYouTubeVideo, 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, defineXPostMediaClickHandler, defineYouTubeVideoClickHandler, docToMarkdown, formatFileSize, formatSizedWikiEmbed, getCodeTokens, getEditorConfig, getFileKind, getIsComposing, getLinkText, getLinkUnitAt, getMarkBuilders, getPendingReplacement, getSearchStatus, getSelectedText, getTableColumnAlign, getTextblockDisplayText, getVirtualElementFromRange, inlineTextToMarkChunks, inlineTextToMarkChunksWithContext, insertLink, isCodeBlockPreviewHiddenDecoration, isLinkTextForHref, isMarkOfType, isModEvent, isNodeOfType, isReferenceDefinitionNode, isSelectionInTableCell, loadKaTeX, markdownToDoc, normalizeHref, parsePostEmbedSnapshot, parseWikiEmbed, removeLink, renderMathInto, updateEditorConfig, updateLink, wikiEmbedBasename, withPriority };
+export { EDITOR_KEY_BINDINGS, Priority, buildFileMarkdown, checkRoundTrip, codeBlockLanguages, collectReferenceDefinitions, defaultResolveImageUrl, defaultResolveXPost, defaultResolveYouTubeVideo, 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, defineXPostMediaClickHandler, defineYouTubeVideoClickHandler, dismissLinkHover, docToMarkdown, formatFileSize, formatSizedWikiEmbed, getCodeTokens, getEditorConfig, getFileKind, getIsComposing, getLinkText, getLinkUnitAt, getMarkBuilders, getPendingReplacement, getSearchStatus, getSelectedText, getTableColumnAlign, getTextblockDisplayText, getVirtualElementFromRange, inlineTextToMarkChunks, inlineTextToMarkChunksWithContext, insertLink, isCodeBlockPreviewHiddenDecoration, isLinkTextForHref, isMarkOfType, isModEvent, isNodeOfType, isReferenceDefinitionNode, isSelectionInTableCell, loadKaTeX, markdownToDoc, normalizeHref, parsePostEmbedSnapshot, parseWikiEmbed, removeLink, renderMathInto, updateEditorConfig, updateLink, wikiEmbedBasename, withPriority };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/core",
   "type": "module",
-  "version": "0.74.1",
+  "version": "0.74.2",
   "license": "MIT",
   "repository": {
     "type": "git",