@meowdown/core 0.64.3 → 0.65.1

package/dist/index.d.ts

@@ -810,7 +810,7 @@ declare function defineEditorExtensionImpl(options: EditorExtensionOptions): imp
   Commands: {
     setMarkMode: [mode: MarkMode];
   };
-}>]>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").BaseCommandsExtension, import("@prosekit/core").HistoryExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
+}>]>, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").BaseCommandsExtension, import("@prosekit/core").HistoryExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").PlainExtension, import("@prosekit/core").Extension<{
   Commands: {
     insertMarkdown: [markdown: string];
     insertTrigger: [text: string];
@@ -1055,6 +1055,11 @@ interface FileClickPayload {
    * pill. Read modifier keys or position a popover from it.
    */
   event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
 }
 type FileClickHandler = (payload: FileClickPayload) => void;
 /**
@@ -1140,6 +1145,45 @@ declare function getFileKind(href: string): string;
  */
 declare function defineFileView(options?: FileViewOptions): PlainExtension;
 //#endregion
+//#region src/extensions/image-click.d.ts
+/**
+ * Payload for {@link ImageClickHandler}.
+ */
+interface ImageClickPayload {
+  /**
+   * The resolved source from `![alt](src)` or a claimed `![[target]]`.
+   */
+  src: string;
+  /**
+   * The image alt text.
+   */
+  alt: string;
+  /**
+   * The originating click or touch tap, or the `Enter`/`Mod-Enter` key press
+   * that followed the selected image. Read the target or position a popover
+   * from it; a touch surface delivers the `touchend` instead of a click.
+   */
+  event: MouseEvent | TouchEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
+}
+type ImageClickHandler = (payload: ImageClickPayload) => void;
+/**
+ * Call `onClick` when the user clicks or taps a rendered image preview, with
+ * the image's markdown `src`, `alt`, and the originating event.
+ *
+ * Touch taps are handled from `touchend` rather than the synthetic click:
+ * previews live inside the editor contenteditable, and iOS WebKit's
+ * tap-to-focus is a native gesture default action that only cancelling the
+ * `touchend` can suppress — otherwise a tap briefly focuses the editor and
+ * raises the software keyboard before the handler opens its own surface
+ * (such as a lightbox).
+ */
+declare function defineImageClickHandler(onClick: ImageClickHandler): PlainExtension;
+//#endregion
 //#region src/extensions/link-click.d.ts
 interface LinkClickPayload {
   href: string;
@@ -1147,6 +1191,11 @@ interface LinkClickPayload {
    * The originating click, or the `Enter`/`Mod-Enter` key press that followed the link.
    */
   event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
 }
 type LinkClickHandler = (payload: LinkClickPayload) => void;
 interface LinkCopyPayload {
@@ -1171,6 +1220,11 @@ interface TagClickPayload {
    * Read modifier keys or position a popover from it.
    */
   event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
 }
 type TagClickHandler = (payload: TagClickPayload) => void;
 /**
@@ -1192,6 +1246,11 @@ interface WikilinkClickPayload {
    * The originating click, or the `Enter`/`Mod-Enter` key press that followed the link.
    */
   event: MouseEvent | KeyboardEvent;
+  /**
+   * Whether the platform's mod key (`Command` on Apple, `Ctrl` elsewhere) was held
+   * beyond the gesture that triggered the activation.
+   */
+  mod: boolean;
 }
 type WikilinkClickHandler = (payload: WikilinkClickPayload) => void;
 /**
@@ -1207,49 +1266,24 @@ interface FollowLinkHandlers {
   onTagClick?: TagClickHandler;
   onFileClick?: FileClickHandler;
   onLinkClick?: LinkClickHandler;
+  onImageClick?: ImageClickHandler;
 }
 /**
  * Binds `Mod-Enter` to follow the wikilink, tag, file pill, or Markdown link
- * under the caret, and plain `Enter` to follow a selected atom unit, firing
- * the same handlers a click does. Off a link, `Mod-Enter` falls through so
- * the list keymap keeps cycling checkbox tasks; off a selected unit, `Enter`
- * falls through to the regular split. High priority puts this ahead of every
- * keymap binding.
- */
-declare function defineFollowLinkHandler(handlers: FollowLinkHandlers): PlainExtension;
-//#endregion
-//#region src/extensions/image-click.d.ts
-/**
- * Payload for {@link ImageClickHandler}.
- */
-interface ImageClickPayload {
-  /**
-   * The resolved source from `![alt](src)` or a claimed `![[target]]`.
-   */
-  src: string;
-  /**
-   * The image alt text.
-   */
-  alt: string;
-  /**
-   * The originating click or touch tap. Read the target or position a popover
-   * from it; a touch surface delivers the `touchend` instead of a click.
-   */
-  event: MouseEvent | TouchEvent;
-}
-type ImageClickHandler = (payload: ImageClickPayload) => void;
-/**
- * Call `onClick` when the user clicks or taps a rendered image preview, with
- * the image's markdown `src`, `alt`, and the originating event.
+ * under the caret, and plain `Enter` to follow a selected atom unit (a
+ * wikilink, file pill, or image), firing the same handlers a click does.
+ * "Under the caret" means strictly inside the unit: a caret merely touching
+ * a unit's edge is next to it, not on it.
+ * Off a link, `Mod-Enter` falls through so the list keymap keeps cycling
+ * checkbox tasks; off a selected unit, `Enter` falls through to the regular
+ * split. High priority puts this ahead of every keymap binding.
  *
- * Touch taps are handled from `touchend` rather than the synthetic click:
- * previews live inside the editor contenteditable, and iOS WebKit's
- * tap-to-focus is a native gesture default action that only cancelling the
- * `touchend` can suppress — otherwise a tap briefly focuses the editor and
- * raises the software keyboard before the handler opens its own surface
- * (such as a lightbox).
+ * A selected-unit follow reports `mod: true` when the platform's mod key
+ * (`⌘` on Apple, `Ctrl` elsewhere) was held beyond its plain-`Enter` trigger;
+ * a caret follow always reports `mod: false`, its mod key being the trigger
+ * itself.
  */
-declare function defineImageClickHandler(onClick: ImageClickHandler): PlainExtension;
+declare function defineFollowLinkHandler(handlers: FollowLinkHandlers): PlainExtension;
 //#endregion
 //#region src/extensions/image.d.ts
 type ImageUrlResolver = (src: string) => string | undefined;
@@ -1362,6 +1396,9 @@ type NodeName = (typeof NODE_NAMES)[number];
 declare function isNodeOfType(node: ProseMirrorNode, name: NodeName): boolean;
 //#endregion
 //#region src/extensions/spell-check.d.ts
+/**
+ * @deprecated This will be removed in future versions.
+ */
 declare function defineSpellCheckPlugin(spellCheck: boolean): PlainExtension;
 //#endregion
 //#region src/extensions/substitution.d.ts
@@ -1455,6 +1492,15 @@ declare function getTextblockDisplayText(textblock: ProseMirrorNode): string;
  */
 declare function formatFileSize(bytes: number): string;
 //#endregion
+//#region src/utils/is-mod-event.d.ts
+/**
+ * Whether the platform's mod key is held on `event`: `Command` on Apple, `Ctrl` elsewhere.
+ */
+declare function isModEvent(event: MouseEvent | KeyboardEvent | TouchEvent | {
+  metaKey: boolean;
+  ctrlKey: boolean;
+}): boolean;
+//#endregion
 //#region src/utils/katex-chunk.d.ts
 type KaTeXRender = typeof render;
 //#endregion
@@ -1492,4 +1538,4 @@ declare function getSelectedText(state: EditorState): string;
  */
 declare function getVirtualElementFromRange(view: EditorView, range: PositionRange): VirtualElement;
 //#endregion
-export { type AcceptPendingReplacementOptions, type CheckRoundTripOptions, type CodeBlockAttrs, type CodeBlockFenceStyle, type CodeToken, type DocToMarkdownOptions, EDITOR_KEY_BINDINGS, 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, 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, defineSpellCheckPlugin, 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, isNodeOfType, isSelectionInTableCell, listenForTweetHeight, loadKaTeX, markdownToDoc, matchEmbed, parseWikiEmbed, removeLink, renderMathInto, updateLink, wikiEmbedBasename, withPriority };
+export { type AcceptPendingReplacementOptions, type CheckRoundTripOptions, type CodeBlockAttrs, type CodeBlockFenceStyle, type CodeToken, type DocToMarkdownOptions, EDITOR_KEY_BINDINGS, 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, 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, defineSpellCheckPlugin, 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 };

package/dist/index.js

@@ -2537,7 +2537,7 @@ const emptyBatchSetMarkStep = new BatchSetMarkStep([]);
 //#endregion
 //#region src/extensions/magic-comment.ts
 const MAGIC_COMMENT_RE = /^<!--\s*(\{[^}]*\})\s*-->$/;
-const TRAILING_MAGIC_COMMENT_RE = /<!--\s*\{[^}]*\}\s*-->$/;
+const TRAILING_MAGIC_COMMENT_RE = /(?:<!--\s*\{[^}]*\}\s*-->)+$/;
 /**
 * Read the metadata out of a `<!-- {...} -->` comment, or `undefined` when the
 * text is not a comment carrying at least one recognized field.
@@ -2570,7 +2570,7 @@ function formatMagicComment(magic) {
 	return `<!-- ${JSON.stringify(magic)} -->`;
 }
 /**
-* Drop a trailing magic comment from the source text.
+* Drop the trailing run of magic comments from the source text.
 */
 function stripMagicComment(source) {
 	return source.replace(TRAILING_MAGIC_COMMENT_RE, "");
@@ -2889,12 +2889,11 @@ function walk(nodes, parentMarks, rangeStart, rangeEnd, text, marks, out, option
 	let pos = rangeStart;
 	for (let index = 0; index < nodes.length; index++) {
 		const node = nodes[index];
+		if (node.to <= pos) continue;
 		if (node.from > pos) emit(out, pos, node.from, parentMarks);
-		if (node.type === LEZER_NODE_IDS.Image) {
-			const trailing = takeMagicComment(node, nodes[index + 1], text);
-			walkImage(node, parentMarks, text, marks, out, options, context, trailing);
-			if (trailing) index++;
-			pos = trailing ? trailing.to : node.to;
+		const atomEnd = walkAtomChild(nodes, index, parentMarks, text, marks, out, options, context);
+		if (atomEnd != null) {
+			pos = atomEnd;
 			continue;
 		}
 		walkNode(node, parentMarks, text, marks, out, options, context);
@@ -2905,8 +2904,6 @@ function walk(nodes, parentMarks, rangeStart, rangeEnd, text, marks, out, option
 function walkNode(node, parentMarks, text, marks, out, options, context) {
 	switch (node.type) {
 		case LEZER_NODE_IDS.Link: return walkLink(node, parentMarks, text, marks, out, options, context);
-		case LEZER_NODE_IDS.Wikilink: return walkWikilink(node, parentMarks, text, marks, out);
-		case LEZER_NODE_IDS.WikiEmbed: return walkWikiEmbed(node, parentMarks, text, marks, out, options);
 		case LEZER_NODE_IDS.InlineMath: return walkMath(node, parentMarks, text, marks, out);
 		case LEZER_NODE_IDS.Autolink: return walkAutolink(node, parentMarks, text, marks, out);
 		case LEZER_NODE_IDS.URL: return walkURL(node, parentMarks, text, marks, out);
@@ -2914,6 +2911,31 @@ function walkNode(node, parentMarks, text, marks, out, options, context) {
 	}
 }
 /**
+* Walk `nodes[index]` when it is a source-backed atom (wikilink, wiki embed,
+* or image); returns the source position after everything the atom consumed,
+* or undefined for any other node type. An image also consumes the magic
+* comments chained behind it, so callers must skip children ending at or
+* before the returned position. Shared by `walk` and `walkResolvedLink` so an
+* atom behaves the same at the top level and inside a link label.
+*/
+function walkAtomChild(nodes, index, parentMarks, text, marks, out, options, context) {
+	const node = nodes[index];
+	switch (node.type) {
+		case LEZER_NODE_IDS.Wikilink:
+			walkWikilink(node, parentMarks, text, marks, out);
+			return node.to;
+		case LEZER_NODE_IDS.WikiEmbed:
+			walkWikiEmbed(node, parentMarks, text, marks, out, options);
+			return node.to;
+		case LEZER_NODE_IDS.Image: {
+			const trailing = takeMagicComments(nodes, index, text);
+			walkImage(node, parentMarks, text, marks, out, options, context, trailing);
+			return trailing ? trailing.to : node.to;
+		}
+		default: return;
+	}
+}
+/**
 * A node with no source-backed atom of its own: it contributes its `mdPack` and
 * syntax marks, then recurses into its children.
 */
@@ -3131,25 +3153,17 @@ function walkResolvedLink(node, parts, resolution, parentMarks, text, marks, out
 	});
 	const base = [...parentMarks, pack];
 	let pos = node.from;
-	for (const child of node.children) {
+	for (let index = 0; index < node.children.length; index++) {
+		const child = node.children[index];
+		if (child.to <= pos) continue;
 		if (child.from > pos) {
 			const childMarks = inLabel(pos) ? [...base, linkTextMark] : base;
 			emit(out, pos, child.from, childMarks);
 		}
 		const baseForChild = inLabel(child.from) ? [...base, linkTextMark] : base;
-		if (child.type === LEZER_NODE_IDS.Wikilink) {
-			walkWikilink(child, baseForChild, text, marks, out);
-			pos = child.to;
-			continue;
-		}
-		if (child.type === LEZER_NODE_IDS.WikiEmbed) {
-			walkWikiEmbed(child, baseForChild, text, marks, out, options);
-			pos = child.to;
-			continue;
-		}
-		if (child.type === LEZER_NODE_IDS.Image) {
-			walkImage(child, baseForChild, text, marks, out, options, context);
-			pos = child.to;
+		const atomEnd = walkAtomChild(node.children, index, baseForChild, text, marks, out, options, context);
+		if (atomEnd != null) {
+			pos = atomEnd;
 			continue;
 		}
 		if (isReference && child.type === LEZER_NODE_IDS.LinkLabel) {
@@ -3170,19 +3184,33 @@ function walkResolvedLink(node, parts, resolution, parentMarks, text, marks, out
 	}
 	if (pos < node.to) emit(out, pos, node.to, base);
 }
-function takeMagicComment(image, next, text) {
-	if (!next || next.type !== LEZER_NODE_IDS.Comment || next.from !== image.to) return void 0;
-	const magic = parseMagicComment(text.slice(next.from, next.to));
+/**
+* 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.
+*/
+function takeMagicComments(nodes, index, text) {
+	let magic;
+	let to = nodes[index].to;
+	for (let i = index + 1; i < nodes.length; i++) {
+		const next = nodes[i];
+		if (next.type !== LEZER_NODE_IDS.Comment || next.from !== to) break;
+		const parsed = parseMagicComment(text.slice(next.from, next.to));
+		if (!parsed) break;
+		magic ??= parsed;
+		to = next.to;
+	}
 	if (!magic) return void 0;
 	return {
 		magic,
-		to: next.to
+		to
 	};
 }
 /**
 * Special walker for a direct image `![alt](url)`.
 *
-* A `trailing` magic comment immediately after the image (e.g.
+* A `trailing` run of magic comments immediately after the image (e.g.
 * `<!-- {"width":320} -->`) is folded into the mark range so it round-trips as
 * source while supplying the image's `width`.
 */
@@ -4428,11 +4456,13 @@ function defineMeowdownListSerializer() {
 			return (...args) => {
 				return {
 					...nodesFromSchema(...args),
-					list: (node) => listToDOM({
-						node,
-						nativeList: true,
-						getAttributes: getListClipboardAttributes
-					})
+					list: (node) => {
+						return listToDOM({
+							node,
+							nativeList: true,
+							getAttributes: getListClipboardAttributes
+						});
+					}
 				};
 			};
 		}
@@ -5541,6 +5571,33 @@ function defineSelectDocBoundary() {
 	});
 }
 
+//#endregion
+//#region src/extensions/system-substitution-guard.ts
+const EM_DASH = "—";
+/**
+* Block the macOS "smart dashes" rewrite. With the `spellcheck` attribute on,
+* WebKit rewrites already-typed `--` near the caret into an em dash and
+* delivers the rewrite as a cancelable `beforeinput` with
+* `inputType: 'insertReplacementText'`. That corrupts Markdown such as the
+* `-->` closing an image sizing comment, so cancel any replacement that
+* inserts an em dash; word-level autocorrect passes through.
+*/
+function defineSystemSubstitutionGuard() {
+	const plugin = new Plugin({ props: { handleDOMEvents: { beforeinput: (view, event) => {
+		if (event.inputType !== "insertReplacementText") return false;
+		if (!(event.dataTransfer?.getData("text/plain") || event.data || "").includes(EM_DASH)) return false;
+		event.preventDefault();
+		const { doc, selection } = view.state;
+		requestAnimationFrame(() => {
+			const { state } = view;
+			if (view.isDestroyed || state.doc !== doc || state.selection.eq(selection)) return;
+			view.dispatch(state.tr.setSelection(selection));
+		});
+		return true;
+	} } } });
+	return withPriority$1(definePlugin(plugin), Priority$1.highest);
+}
+
 //#endregion
 //#region src/extensions/view-attributes.ts
 /**
@@ -5555,7 +5612,7 @@ function defineViewAttributes(attributes) {
 //#endregion
 //#region src/extensions/extension.ts
 function defineEditorExtensionImpl(options) {
-	return union(defineMeowdownParagraph(), defineDoc(), defineDocFrontmatterAttr(), defineText(), defineBlockquote(), defineMeowdownList(), defineHeading(), defineTable(), defineCodeBlock$1(), defineMeowdownHorizontalRule(), defineHTMLComment(), defineInlineMarks(), defineViewAttributes({ class: "meowdown-content" }), defineCodeBlockSyntaxHighlight(), defineCrossEditorDrag(), defineEscapeCollapse(), defineMoveBlock(), defineSelectDocBoundary(), defineInlineMarkPlugin(options), defineInlineToggle(), defineLinkCommands(), defineWikilink(), defineMath(), defineMarkMode(options.markMode ?? "focus"), defineClipboard(), defineScrollToSelection(), defineHiddenRunCaret(), defineAtomMarkNavigation({ marks: ATOM_SOURCE_MARK_NAMES.map((name) => ({
+	return union(defineMeowdownParagraph(), defineDoc(), defineDocFrontmatterAttr(), defineText(), defineBlockquote(), defineMeowdownList(), defineHeading(), defineTable(), defineCodeBlock$1(), defineMeowdownHorizontalRule(), defineHTMLComment(), defineInlineMarks(), defineViewAttributes({ class: "meowdown-content" }), defineCodeBlockSyntaxHighlight(), defineCrossEditorDrag(), defineEscapeCollapse(), defineMoveBlock(), defineSelectDocBoundary(), defineInlineMarkPlugin(options), defineInlineToggle(), defineLinkCommands(), defineWikilink(), defineMath(), defineMarkMode(options.markMode ?? "focus"), defineClipboard(), defineScrollToSelection(), defineHiddenRunCaret(), defineSystemSubstitutionGuard(), defineAtomMarkNavigation({ marks: ATOM_SOURCE_MARK_NAMES.map((name) => ({
 		name,
 		modes: [
 			"hide",
@@ -6430,6 +6487,15 @@ function defineExitBoundaryHandler(onExitBoundary) {
 	return withPriority$1(definePlugin(createExitBoundaryPlugin(onExitBoundary)), Priority$1.low);
 }
 
+//#endregion
+//#region src/utils/is-mod-event.ts
+/**
+* Whether the platform's mod key is held on `event`: `Command` on Apple, `Ctrl` elsewhere.
+*/
+function isModEvent(event) {
+	return isApple ? event.metaKey : event.ctrlKey;
+}
+
 //#endregion
 //#region src/extensions/file-click.ts
 const fileClickKey = new PluginKey("meowdown-file-click");
@@ -6438,6 +6504,8 @@ function findFileAt(state, pos) {
 	if (!range) return;
 	const { href, name } = range.mark.attrs;
 	return {
+		from: range.from,
+		to: range.to,
 		href,
 		name
 	};
@@ -6460,7 +6528,8 @@ function defineFileClickHandler(onClick) {
 			onClick({
 				href: hit.href,
 				name: hit.name,
-				event
+				event,
+				mod: isModEvent(event)
 			});
 			return true;
 		} }
@@ -6748,6 +6817,126 @@ function defineFileView(options = {}) {
 	});
 }
 
+//#endregion
+//#region src/extensions/image-click.ts
+const imageClickKey = new PluginKey("meowdown-image-click");
+function getClosestImagePreview(target) {
+	return target instanceof HTMLElement && target.closest(".md-image-view-preview");
+}
+function findImageAt(state, pos) {
+	const range = getMarkRangeAt(state, pos, "mdImage");
+	if (!range) return;
+	const { src, alt } = range.mark.attrs;
+	return {
+		from: range.from,
+		to: range.to,
+		src,
+		alt
+	};
+}
+/**
+* Resolve the image hit for a preview element via its content holder, not the
+* event's document position: an event on the non-editable preview lands on the
+* run boundary, where `getMarkRange` would pick the next adjacent image.
+*/
+function findImageForPreview(view, preview) {
+	const content = preview.closest(".md-image-view")?.querySelector(".md-image-view-content");
+	if (!content) return;
+	return findImageAt(view.state, view.posAtDOM(content, 0));
+}
+/**
+* Fingers wander a little during a tap; past this it is a scroll or a drag.
+*/
+const TAP_MOVE_TOLERANCE = 10;
+function findTouch(touches, identifier) {
+	return Array.from(touches).find((touch) => touch.identifier === identifier);
+}
+function isWithinTapTolerance(pending, touch) {
+	return Math.abs(touch.clientX - pending.clientX) <= TAP_MOVE_TOLERANCE && Math.abs(touch.clientY - pending.clientY) <= TAP_MOVE_TOLERANCE;
+}
+/**
+* Call `onClick` when the user clicks or taps a rendered image preview, with
+* the image's markdown `src`, `alt`, and the originating event.
+*
+* Touch taps are handled from `touchend` rather than the synthetic click:
+* previews live inside the editor contenteditable, and iOS WebKit's
+* tap-to-focus is a native gesture default action that only cancelling the
+* `touchend` can suppress — otherwise a tap briefly focuses the editor and
+* raises the software keyboard before the handler opens its own surface
+* (such as a lightbox).
+*/
+function defineImageClickHandler(onClick) {
+	const pendingTaps = /* @__PURE__ */ new WeakMap();
+	const handleTouchEnd = (view, event) => {
+		const pending = pendingTaps.get(view);
+		pendingTaps.delete(view);
+		if (!pending || event.touches.length > 0) return false;
+		const touch = findTouch(event.changedTouches, pending.identifier);
+		if (!touch || !isWithinTapTolerance(pending, touch)) return false;
+		const preview = getClosestImagePreview(event.target);
+		if (!preview) return false;
+		event.preventDefault();
+		const hit = findImageForPreview(view, preview);
+		if (hit) onClick({
+			src: hit.src,
+			alt: hit.alt,
+			event,
+			mod: isModEvent(event)
+		});
+		return true;
+	};
+	return definePlugin(new Plugin({
+		key: imageClickKey,
+		props: {
+			handleDOMEvents: {
+				pointerdown: (view, event) => {
+					if (getClosestImagePreview(event.target) && event.pointerType !== "mouse") event.preventDefault();
+					return false;
+				},
+				touchstart: (view, event) => {
+					pendingTaps.delete(view);
+					if (event.touches.length !== 1) return false;
+					if (!getClosestImagePreview(event.target)) return false;
+					if (event.target instanceof HTMLElement && event.target.closest(".md-image-resize-handle")) return false;
+					const touch = event.changedTouches[0];
+					if (!touch) return false;
+					pendingTaps.set(view, {
+						identifier: touch.identifier,
+						clientX: touch.clientX,
+						clientY: touch.clientY
+					});
+					return false;
+				},
+				touchmove: (view, event) => {
+					const pending = pendingTaps.get(view);
+					if (!pending) return false;
+					const touch = findTouch(event.changedTouches, pending.identifier);
+					if (touch && !isWithinTapTolerance(pending, touch)) pendingTaps.delete(view);
+					return false;
+				},
+				touchcancel: (view) => {
+					pendingTaps.delete(view);
+					return false;
+				},
+				touchend: handleTouchEnd
+			},
+			handleClick: (view, _pos, event) => {
+				const preview = getClosestImagePreview(event.target);
+				if (!preview) return false;
+				const hit = findImageForPreview(view, preview);
+				if (!hit) return false;
+				onClick({
+					src: hit.src,
+					alt: hit.alt,
+					event,
+					mod: isModEvent(event)
+				});
+				return true;
+			}
+		}
+	}));
+}
+
 //#endregion
 //#region src/extensions/mark-click.ts
 /**
@@ -6801,7 +6990,8 @@ function defineTagClickHandler(onClick) {
 		findPayloadAt: (state, pos) => findTagAt(state, pos)?.tag,
 		onClick: (tag, event) => onClick({
 			tag,
-			event
+			event,
+			mod: isModEvent(event)
 		})
 	});
 }
@@ -6848,7 +7038,8 @@ function defineWikilinkClickHandler(onClick) {
 		findPayloadForElement: (view, element) => findWikilinkForElement(view, element)?.target,
 		onClick: (target, event) => onClick({
 			target,
-			event
+			event,
+			mod: isModEvent(event)
 		})
 	});
 }
@@ -6863,173 +7054,86 @@ function createFollowLinkPlugin(handlers) {
 			if (getIsComposing() || event.key !== "Enter" || event.shiftKey) return false;
 			const { state } = view;
 			const selectedAtom = getSelectedAtomRange(state);
-			if (!(isApple ? event.metaKey : event.ctrlKey) && !selectedAtom) return false;
-			const pos = selectedAtom ? selectedAtom.from + 1 : state.selection.head;
-			const wikilink = handlers.onWikilinkClick && findWikilinkAt(state, pos);
-			if (wikilink) {
-				handlers.onWikilinkClick?.({
-					target: wikilink.target,
-					event
-				});
-				return true;
-			}
-			const tag = handlers.onTagClick && findTagAt(state, pos);
-			if (tag) {
-				handlers.onTagClick?.({
-					tag: tag.tag,
-					event
-				});
-				return true;
-			}
-			const file = handlers.onFileClick && findFileAt(state, pos);
-			if (file) {
-				handlers.onFileClick?.({
-					href: file.href,
-					name: file.name,
-					event
-				});
-				return true;
-			}
-			const link = handlers.onLinkClick && getLinkUnitAt(state, pos);
-			if (link) {
-				handlers.onLinkClick?.({
-					href: link.href,
-					event
-				});
-				return true;
-			}
+			const mod = isModEvent(event);
+			if (!selectedAtom && !mod) return;
+			if (selectedAtom && handlerAtomMarkTrigger(state, event, handlers, mod, selectedAtom)) return true;
+			if (handlerTextMarkTrigger(state, event, handlers, mod)) return true;
 			return false;
 		} }
 	});
 }
-/**
-* Binds `Mod-Enter` to follow the wikilink, tag, file pill, or Markdown link
-* under the caret, and plain `Enter` to follow a selected atom unit, firing
-* the same handlers a click does. Off a link, `Mod-Enter` falls through so
-* the list keymap keeps cycling checkbox tasks; off a selected unit, `Enter`
-* falls through to the regular split. High priority puts this ahead of every
-* keymap binding.
-*/
-function defineFollowLinkHandler(handlers) {
-	return withPriority$1(definePlugin(createFollowLinkPlugin(handlers)), Priority$1.high);
-}
-
-//#endregion
-//#region src/extensions/image-click.ts
-const imageClickKey = new PluginKey("meowdown-image-click");
-function getClosestImagePreview(target) {
-	return target instanceof HTMLElement && target.closest(".md-image-view-preview");
-}
-function findImageAt(state, pos) {
-	const range = getMarkRangeAt(state, pos, "mdImage");
-	if (!range) return;
-	const { src, alt } = range.mark.attrs;
-	return {
-		from: range.from,
-		to: range.to,
-		src,
-		alt
-	};
-}
-/**
-* Resolve the image hit for a preview element via its content holder, not the
-* event's document position: an event on the non-editable preview lands on the
-* run boundary, where `getMarkRange` would pick the next adjacent image.
-*/
-function findImageForPreview(view, preview) {
-	const content = preview.closest(".md-image-view")?.querySelector(".md-image-view-content");
-	if (!content) return;
-	return findImageAt(view.state, view.posAtDOM(content, 0));
-}
-/**
-* Fingers wander a little during a tap; past this it is a scroll or a drag.
-*/
-const TAP_MOVE_TOLERANCE = 10;
-function findTouch(touches, identifier) {
-	return Array.from(touches).find((touch) => touch.identifier === identifier);
+function handlerAtomMarkTrigger(state, event, handlers, mod, selectedAtom) {
+	const pos = selectedAtom.from + 1;
+	const { onWikilinkClick, onFileClick, onImageClick } = handlers;
+	const wikilink = onWikilinkClick && findWikilinkAt(state, pos);
+	if (wikilink) {
+		onWikilinkClick({
+			target: wikilink.target,
+			event,
+			mod
+		});
+		return true;
+	}
+	const file = onFileClick && findFileAt(state, pos);
+	if (file) {
+		onFileClick({
+			href: file.href,
+			name: file.name,
+			event,
+			mod
+		});
+		return true;
+	}
+	const image = onImageClick && findImageAt(state, pos);
+	if (image) {
+		onImageClick({
+			src: image.src,
+			alt: image.alt,
+			event,
+			mod
+		});
+		return true;
+	}
 }
-function isWithinTapTolerance(pending, touch) {
-	return Math.abs(touch.clientX - pending.clientX) <= TAP_MOVE_TOLERANCE && Math.abs(touch.clientY - pending.clientY) <= TAP_MOVE_TOLERANCE;
+function handlerTextMarkTrigger(state, event, handlers, mod) {
+	const pos = state.selection.head;
+	const { onTagClick, onLinkClick } = handlers;
+	const tag = onTagClick && findTagAt(state, pos);
+	if (tag && tag.from < pos && pos < tag.to) {
+		onTagClick({
+			tag: tag.tag,
+			event,
+			mod
+		});
+		return true;
+	}
+	const link = onLinkClick && getLinkUnitAt(state, pos);
+	if (link && link.unit.from < pos && pos < link.unit.to) {
+		onLinkClick({
+			href: link.href,
+			event,
+			mod
+		});
+		return true;
+	}
 }
 /**
-* Call `onClick` when the user clicks or taps a rendered image preview, with
-* the image's markdown `src`, `alt`, and the originating event.
+* Binds `Mod-Enter` to follow the wikilink, tag, file pill, or Markdown link
+* under the caret, and plain `Enter` to follow a selected atom unit (a
+* wikilink, file pill, or image), firing the same handlers a click does.
+* "Under the caret" means strictly inside the unit: a caret merely touching
+* a unit's edge is next to it, not on it.
+* Off a link, `Mod-Enter` falls through so the list keymap keeps cycling
+* checkbox tasks; off a selected unit, `Enter` falls through to the regular
+* split. High priority puts this ahead of every keymap binding.
 *
-* Touch taps are handled from `touchend` rather than the synthetic click:
-* previews live inside the editor contenteditable, and iOS WebKit's
-* tap-to-focus is a native gesture default action that only cancelling the
-* `touchend` can suppress — otherwise a tap briefly focuses the editor and
-* raises the software keyboard before the handler opens its own surface
-* (such as a lightbox).
+* A selected-unit follow reports `mod: true` when the platform's mod key
+* (`⌘` on Apple, `Ctrl` elsewhere) was held beyond its plain-`Enter` trigger;
+* a caret follow always reports `mod: false`, its mod key being the trigger
+* itself.
 */
-function defineImageClickHandler(onClick) {
-	const pendingTaps = /* @__PURE__ */ new WeakMap();
-	const handleTouchEnd = (view, event) => {
-		const pending = pendingTaps.get(view);
-		pendingTaps.delete(view);
-		if (!pending || event.touches.length > 0) return false;
-		const touch = findTouch(event.changedTouches, pending.identifier);
-		if (!touch || !isWithinTapTolerance(pending, touch)) return false;
-		const preview = getClosestImagePreview(event.target);
-		if (!preview) return false;
-		event.preventDefault();
-		const hit = findImageForPreview(view, preview);
-		if (hit) onClick({
-			src: hit.src,
-			alt: hit.alt,
-			event
-		});
-		return true;
-	};
-	return definePlugin(new Plugin({
-		key: imageClickKey,
-		props: {
-			handleDOMEvents: {
-				pointerdown: (view, event) => {
-					if (getClosestImagePreview(event.target) && event.pointerType !== "mouse") event.preventDefault();
-					return false;
-				},
-				touchstart: (view, event) => {
-					pendingTaps.delete(view);
-					if (event.touches.length !== 1) return false;
-					if (!getClosestImagePreview(event.target)) return false;
-					if (event.target instanceof HTMLElement && event.target.closest(".md-image-resize-handle")) return false;
-					const touch = event.changedTouches[0];
-					if (!touch) return false;
-					pendingTaps.set(view, {
-						identifier: touch.identifier,
-						clientX: touch.clientX,
-						clientY: touch.clientY
-					});
-					return false;
-				},
-				touchmove: (view, event) => {
-					const pending = pendingTaps.get(view);
-					if (!pending) return false;
-					const touch = findTouch(event.changedTouches, pending.identifier);
-					if (touch && !isWithinTapTolerance(pending, touch)) pendingTaps.delete(view);
-					return false;
-				},
-				touchcancel: (view) => {
-					pendingTaps.delete(view);
-					return false;
-				},
-				touchend: handleTouchEnd
-			},
-			handleClick: (view, _pos, event) => {
-				const preview = getClosestImagePreview(event.target);
-				if (!preview) return false;
-				const hit = findImageForPreview(view, preview);
-				if (!hit) return false;
-				onClick({
-					src: hit.src,
-					alt: hit.alt,
-					event
-				});
-				return true;
-			}
-		}
-	}));
+function defineFollowLinkHandler(handlers) {
+	return withPriority$1(definePlugin(createFollowLinkPlugin(handlers)), Priority$1.high);
 }
 
 //#endregion
@@ -7359,7 +7463,8 @@ function defineLinkClickHandler(onClick) {
 		findPayloadAt: (state, pos) => getLinkUnitAt(state, pos)?.href,
 		onClick: (href, event) => onClick({
 			href,
-			event
+			event,
+			mod: isModEvent(event)
 		})
 	});
 }
@@ -7582,6 +7687,9 @@ function createSpellCheckPlugin(spellCheck) {
 		}
 	});
 }
+/**
+* @deprecated This will be removed in future versions.
+*/
 function defineSpellCheckPlugin(spellCheck) {
 	return definePlugin(createSpellCheckPlugin(spellCheck));
 }
@@ -8087,4 +8195,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, defineSpellCheckPlugin, 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, 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, defineSpellCheckPlugin, 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/core",
   "type": "module",
-  "version": "0.64.3",
+  "version": "0.65.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -43,7 +43,7 @@
     "remark-stringify": "^11.0.0",
     "unicode-by-name": "^0.2.0",
     "unified": "^11.0.5",
-    "@meowdown/markdown": "^0.64.3"
+    "@meowdown/markdown": "^0.65.1"
   },
   "devDependencies": {
     "@ocavue/tsconfig": "^0.7.1",