@meowdown/react 0.47.0 → 0.49.0

package/README.md

@@ -56,6 +56,40 @@ See the full API reference [here](https://npmx.dev/package-docs/@meowdown%2Freac
 
 Slash menu host items can include `keywords` to match hidden terms without changing the displayed label.
 
+### Wiki embeds
+
+Obsidian-style wiki embeds (`![[path]]`, with optional `|width` or
+`|widthxheight`) stay literal and editable unless the host classifies them.
+`resolveWikiEmbed` is a pure, creation-time resolver: return an image, file, or
+note result to reuse the corresponding Meowdown atom and its existing click
+hook; return `undefined` for missing or ambiguous targets.
+
+```tsx
+<MeowdownEditor
+  initialMarkdown="![[assets/photo.png|320]]"
+  resolveWikiEmbed={({ target }) => (target.endsWith('.png') ? { kind: 'image' } : undefined)}
+  resolveImageUrl={resolveLocalImageUrl}
+  onImageClick={openLightbox}
+/>
+```
+
+Use `EditorHandle.revealHeading('#Section%20name')` to move the selection to a
+matching heading and scroll it into view after following a heading link.
+
+Both `MeowdownEditor` and the read-only `MarkdownView` accept
+`resolveFileLink`. Return `true` to render a standard `[label](path)` Markdown
+link with the same file pill, metadata resolver, and click hook used by wiki
+file embeds; return `false` to keep it as a normal link.
+
+```tsx
+<MarkdownView
+  markdown="[Quarterly report](docs/report.pdf)"
+  resolveFileLink={({ href }) => href.startsWith('docs/')}
+  resolveFileInfo={resolveLocalFileInfo}
+  onFileClick={openLocalFile}
+/>
+```
+
 ### Wiki-link hover cards
 
 Mount `WikilinkHoverCard` inside `MeowdownEditor` and render host-owned preview

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ReactElement, ReactNode, Ref } from "react";
-import { AcceptPendingReplacementOptions, ExitBoundaryHandler, FileClickHandler, FileLinkResolver, FilePasteOptions, FileViewOptions, ImageClickHandler, ImageOptions, LinkClickHandler, LinkCopyHandler, ListMarker, MarkMode, PendingReplacement, PendingReplacementOutcome, PlaceholderOptions, StartPendingReplacementOptions, TagClickHandler, TypedEditor, WikilinkClickHandler, WikilinkHoverHit } from "@meowdown/core";
+import { AcceptPendingReplacementOptions, ExitBoundaryHandler, FileClickHandler, FileInfoResolver, FileLinkResolver, FilePasteOptions, FileViewOptions, ImageClickHandler, ImageOptions, LinkClickHandler, LinkCopyHandler, ListMarker, MarkMode, PendingReplacement, PendingReplacementOutcome, PlaceholderOptions, StartPendingReplacementOptions, TagClickHandler, TypedEditor, WikiEmbedResolver, WikilinkClickHandler, WikilinkHoverHit } from "@meowdown/core";
 import { SelectionJSON, SelectionJSON as SelectionJSON$1 } from "@prosekit/core";
 import { useEditor, useExtension, useKeymap } from "@prosekit/react";
 //#region src/utils/date-format.d.ts
@@ -45,6 +45,12 @@ interface EditorHandle {
    * is mapped through the change.
    */
   setState: (markdown?: string, selection?: SelectionHint) => void;
+  /**
+   * Reparse the current Markdown with the editor's creation-time resolvers,
+   * preserving the selection without adding an undo-history entry. Hosts use
+   * this when data consulted by a stable resolver changes out of band.
+   */
+  refreshMarkdownRendering: () => void;
   /** Returns the current selection. */
   getSelection: () => SelectionJSON$1;
   /** Restores a selection with the same hint semantics as `setState`. */
@@ -53,6 +59,12 @@ interface EditorHandle {
   focus: () => void;
   /** Scrolls the selection into view. */
   scrollIntoView: () => void;
+  /**
+   * Moves the selection to the first heading matching a decoded `#fragment`
+   * (case-insensitive, with whitespace collapsed) and scrolls it into view.
+   * Returns `false` when no heading matches.
+   */
+  revealHeading: (fragment: string) => boolean;
   /**
    * The current selection as Markdown: block structure (list markers,
    * headings) is serialized, and inline syntax is already literal text. A
@@ -288,6 +300,12 @@ interface EditorProps {
    * changes are ignored, like `initialMarkdown`.
    */
   resolveFileLink?: FileLinkResolver;
+  /**
+   * Classifies `![[target]]` as an image, file, or note atom. Return
+   * `undefined` for missing or ambiguous targets to leave the source literal
+   * and editable. Must be pure and is read once when the editor is created.
+   */
+  resolveWikiEmbed?: WikiEmbedResolver;
   /**
    * Resolves the metadata (file size in bytes) shown on a file pill, directly
    * or as a promise; the pill renders immediately and fills the size in when
@@ -333,6 +351,11 @@ interface EditorProps {
    * Off by default.
    */
   bulletAfterHeading?: boolean;
+  /**
+   * Replaces typed character sequences with their typographic equivalents,
+   * e.g. `->` with `→` and `(c)` with `©`. On by default.
+   */
+  substitution?: boolean;
   /** Handles a leading `---` frontmatter block (off by default). */
   frontmatter?: boolean;
   /**
@@ -369,7 +392,7 @@ interface EditorProps {
   /** Nodes rendered inside the editor's ProseKit context. */
   children?: ReactNode;
 }
-declare function MeowdownEditor({ mode, initialMarkdown, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste, linkPaste, bulletAfterHeading, frontmatter, blockHandle, placeholder, readOnly, spellCheck, timeFormat, editorClassName, wrapperClassName, handleRef, children }: EditorProps): import("react").JSX.Element;
+declare function MeowdownEditor({ mode, initialMarkdown, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste, linkPaste, bulletAfterHeading, substitution, frontmatter, blockHandle, placeholder, readOnly, spellCheck, timeFormat, editorClassName, wrapperClassName, handleRef, children }: EditorProps): import("react").JSX.Element;
 //#endregion
 //#region src/components/markdown-view.d.ts
 /** Payload for {@link TaskClickHandler}. */
@@ -409,7 +432,7 @@ interface MarkdownViewProps {
   /** Peel a leading YAML frontmatter block before rendering. Off by default. */
   frontmatter?: boolean;
   /**
-   * Whether rendered links, images, and task checkboxes can be activated.
+   * Whether rendered links, images, file pills, and task checkboxes can be activated.
    * Defaults to `true`. When `false`, callbacks are ignored, the rendered tree
    * contains no anchors or focusable task controls, and recognized tweet and
    * YouTube embeds are omitted before any image resolver runs.
@@ -417,12 +440,23 @@ interface MarkdownViewProps {
   interactive?: boolean;
   /** Map an image `src` to a displayable URL, or `undefined` to skip it. */
   resolveImageUrl?: (src: string) => string | undefined;
+  /**
+   * Claim a `[label](url)` link as a file pill instead of a regular link.
+   * Must be pure; return `false` for links that should render normally.
+   */
+  resolveFileLink?: FileLinkResolver;
+  /** Classify `![[target]]` as an image, file, or note; unresolved source stays literal. */
+  resolveWikiEmbed?: WikiEmbedResolver;
+  /** Resolve metadata shown on a file pill. */
+  resolveFileInfo?: FileInfoResolver;
   /** Called when a rendered wikilink is clicked. Pass a stable function. */
   onWikilinkClick?: WikilinkClickHandler;
   /** Called when a rendered Markdown link is clicked. Pass a stable function. */
   onLinkClick?: LinkClickHandler;
   /** Called when a rendered image is clicked. Pass a stable function. */
   onImageClick?: ImageClickHandler;
+  /** Called when a rendered file pill is clicked. Pass a stable function. */
+  onFileClick?: FileClickHandler;
   /** Called when a rendered task checkbox is clicked. Pass a stable function. */
   onTaskClick?: TaskClickHandler;
   /** Extra class on the content root (alongside `ProseMirror meowdown-content`). */
@@ -436,10 +470,10 @@ interface MarkdownViewProps {
  * and CSS (the root carries `ProseMirror` + `data-mark-mode` so the existing
  * stylesheet applies). Requires a DOM environment.
  *
- * Callbacks (`onWikilinkClick`, etc.) should be stable; pass them via
+ * Callbacks (`onWikilinkClick`, etc.) and resolvers should be stable; pass them via
  * `useCallback` to avoid re-rendering the whole tree.
  */
-declare function MarkdownView({ markdown, markMode, frontmatter, interactive, resolveImageUrl, onWikilinkClick, onLinkClick, onImageClick, onTaskClick, className }: MarkdownViewProps): ReactElement;
+declare function MarkdownView({ markdown, markMode, frontmatter, interactive, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveFileInfo, onWikilinkClick, onLinkClick, onImageClick, onFileClick, onTaskClick, className }: MarkdownViewProps): ReactElement;
 //#endregion
 //#region src/components/wikilink-hover-card.d.ts
 /** Props for {@link WikilinkHoverCard}. */

package/dist/index.js

@@ -1,6 +1,6 @@
 import { clsx } from "clsx/lite";
 import { Fragment, cloneElement, createElement, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
-import { buildFileMarkdown, codeBlockLanguages, defaultResolveImageUrl, defineBulletAfterHeading, defineCodeBlockPreviewPlugin, defineEditorExtension, defineEmbedPaste, defineExitBoundaryHandler, defineFileClickHandler, defineFilePaste, defineFileView, defineFollowLinkHandler, defineImage, defineImageClickHandler, defineLinkClickHandler, defineLinkEditKeymap, defineLinkHoverHandler, defineLinkPaste, definePendingReplacementHandler, definePlaceholder, defineReadonly, defineSpellCheckPlugin, defineTagClickHandler, defineWikilinkClickHandler, defineWikilinkHoverHandler, defineWikilinkTrigger, docToMarkdown, getCodeTokens, getMarkBuilders, getPendingReplacement, getSelectedText, getTableColumnAlign, getVirtualElementFromRange, inlineTextToMarkChunks, isCodeBlockPreviewHiddenDecoration, isSelectionInTableCell, listenForTweetHeight, loadKaTeX, markdownToDoc, matchEmbed, renderMathInto } from "@meowdown/core";
+import { buildFileMarkdown, codeBlockLanguages, defaultResolveImageUrl, defineBulletAfterHeading, defineCodeBlockPreviewPlugin, defineEditorExtension, defineEmbedPaste, defineExitBoundaryHandler, defineFileClickHandler, defineFilePaste, defineFileView, defineFollowLinkHandler, defineImage, defineImageClickHandler, defineLinkClickHandler, defineLinkEditKeymap, defineLinkHoverHandler, defineLinkPaste, definePendingReplacementHandler, definePlaceholder, defineReadonly, defineSpellCheckPlugin, defineSubstitution, defineTagClickHandler, defineWikilinkClickHandler, defineWikilinkHoverHandler, defineWikilinkTrigger, docToMarkdown, formatFileSize, getCodeTokens, getFileKind, getMarkBuilders, getPendingReplacement, getSelectedText, getTableColumnAlign, getVirtualElementFromRange, inlineTextToMarkChunks, isCodeBlockPreviewHiddenDecoration, isSelectionInTableCell, listenForTweetHeight, loadKaTeX, markdownToDoc, matchEmbed, renderMathInto } from "@meowdown/core";
 import { clamp } from "@ocavue/utils";
 import { canUseRegexLookbehind, createEditor, defineDocChangeHandler, defineUpdateHandler, isTextSelection, union } from "@prosekit/core";
 import { Selection, TextSelection } from "@prosekit/pm/state";
@@ -295,7 +295,7 @@ function DropIndicator$1() {
 
 //#endregion
 //#region src/components/editor-extensions.tsx
-function EditorExtensions({ markMode, onDocChange, onWikilinkClick, onLinkClick, onTagClick, onExitBoundary, resolveImageUrl, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste, linkPaste, bulletAfterHeading, placeholder, readOnly, wikilinkEnabled, spellCheck }) {
+function EditorExtensions({ markMode, onDocChange, onWikilinkClick, onLinkClick, onTagClick, onExitBoundary, resolveImageUrl, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste, linkPaste, bulletAfterHeading, substitution, placeholder, readOnly, wikilinkEnabled, spellCheck }) {
 	const editor = useEditor$1();
 	useEffect(() => {
 		editor.commands.setMarkMode(markMode);
@@ -358,6 +358,9 @@ function EditorExtensions({ markMode, onDocChange, onWikilinkClick, onLinkClick,
 	useExtension$1(useMemo(() => {
 		return bulletAfterHeading ? defineBulletAfterHeading() : null;
 	}, [bulletAfterHeading]));
+	useExtension$1(useMemo(() => {
+		return substitution ? defineSubstitution() : null;
+	}, [substitution]));
 	useExtension$1(useMemo(() => {
 		return placeholder ? definePlaceholder({
 			placeholder,
@@ -1542,10 +1545,77 @@ function resolveSelection(doc, selection) {
 		return TextSelection.between(doc.resolve(anchor), doc.resolve(head));
 	}
 }
-function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste, linkPaste, bulletAfterHeading, frontmatter = false, blockHandle = true, placeholder, readOnly, spellCheck, timeFormat, editorClassName, ref, children }) {
+function decodeHeadingFragment(fragment) {
+	const source = fragment.startsWith("#") ? fragment.slice(1) : fragment;
+	try {
+		return decodeURIComponent(source);
+	} catch {
+		return source;
+	}
+}
+function headingLookupKey(value) {
+	return value.normalize("NFKC").trim().replaceAll(/\s+/g, " ").toLowerCase();
+}
+const HEADING_HIDDEN_MARKS = /* @__PURE__ */ new Set([
+	"mdMark",
+	"mdLinkUri",
+	"mdLinkTitle"
+]);
+const HEADING_ATOM_MARKS = /* @__PURE__ */ new Set([
+	"mdWikilink",
+	"mdImage",
+	"mdFile",
+	"mdMath"
+]);
+function headingAtomText(mark) {
+	const attrs = mark.attrs;
+	const stringAttr = (name) => {
+		const value = attrs[name];
+		return typeof value === "string" ? value : "";
+	};
+	if (mark.type.name === "mdWikilink") return stringAttr("display") || stringAttr("target");
+	if (mark.type.name === "mdImage") return stringAttr("alt");
+	if (mark.type.name === "mdFile") return stringAttr("name");
+	if (mark.type.name === "mdMath") return stringAttr("formula");
+	return "";
+}
+/** The heading as its live-preview marks display it, with syntax runs omitted. */
+function headingDisplayText(heading) {
+	let output = "";
+	let previousAtom;
+	heading.forEach((child) => {
+		if (!child.isText || !child.text) return;
+		const atom = child.marks.find((mark) => HEADING_ATOM_MARKS.has(mark.type.name));
+		if (atom) {
+			if (!previousAtom?.eq(atom)) output += headingAtomText(atom);
+			previousAtom = atom;
+			return;
+		}
+		previousAtom = void 0;
+		if (child.marks.some((mark) => HEADING_HIDDEN_MARKS.has(mark.type.name))) return;
+		output += child.text;
+	});
+	return output;
+}
+function findHeadingPosition(doc, fragment) {
+	const target = headingLookupKey(decodeHeadingFragment(fragment));
+	if (!target) return;
+	let match;
+	doc.descendants((node, pos) => {
+		if (match != null) return false;
+		if (node.type.name === "heading" && (headingLookupKey(node.textContent) === target || headingLookupKey(headingDisplayText(node)) === target)) {
+			match = pos + 1;
+			return false;
+		}
+		return true;
+	});
+	return match;
+}
+function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste, linkPaste, bulletAfterHeading, substitution = true, frontmatter = false, blockHandle = true, placeholder, readOnly, spellCheck, timeFormat, editorClassName, ref, children }) {
 	const [editor] = useState(() => {
 		const editor = createEditor({ extension: union(defineEditorExtension({
 			resolveFileLink,
+			resolveWikiEmbed,
 			markMode
 		}), defineCodeBlockView()) });
 		if (initialMarkdown) editor.setContent(markdownToDoc(initialMarkdown, {
@@ -1581,7 +1651,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 		function getState() {
 			return [getMarkdown(), getSelection()];
 		}
-		function setState(markdown, selection) {
+		function replaceState(markdown, selection, addToHistory = true) {
 			if (markdown == null && !selection) return;
 			const transaction = editor.state.tr;
 			if (markdown != null) {
@@ -1592,6 +1662,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 				transaction.replaceWith(0, transaction.doc.content.size, doc.content);
 			}
 			if (selection) transaction.setSelection(resolveSelection(transaction.doc, selection)).scrollIntoView();
+			if (!addToHistory) transaction.setMeta("addToHistory", false);
 			suppressDocChangeRef.current = true;
 			try {
 				editor.view.dispatch(transaction);
@@ -1599,9 +1670,16 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 				suppressDocChangeRef.current = false;
 			}
 		}
+		function setState(markdown, selection) {
+			replaceState(markdown, selection);
+		}
 		function setMarkdown(markdown) {
 			setState(markdown);
 		}
+		function refreshMarkdownRendering() {
+			const [markdown, selection] = getState();
+			replaceState(markdown, selection, false);
+		}
 		function insertMarkdown(markdown) {
 			editor.commands.insertMarkdown(markdown);
 		}
@@ -1614,6 +1692,13 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 		function scrollIntoView() {
 			editor.commands.scrollIntoView();
 		}
+		function revealHeading(fragment) {
+			const position = findHeadingPosition(editor.state.doc, fragment);
+			if (position == null) return false;
+			const selection = TextSelection.near(editor.state.doc.resolve(position));
+			editor.view.dispatch(editor.state.tr.setSelection(selection).scrollIntoView());
+			return true;
+		}
 		function getSelectedTextFromState() {
 			return getSelectedText(editor.state);
 		}
@@ -1639,10 +1724,12 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 			insertMarkdown,
 			getState,
 			setState,
+			refreshMarkdownRendering,
 			getSelection,
 			setSelection,
 			focus,
 			scrollIntoView,
+			revealHeading,
 			getSelectedText: getSelectedTextFromState,
 			openSelectionMenu: openSelectionMenuFromHandle,
 			startPendingReplacement,
@@ -1687,6 +1774,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 				embedPaste,
 				linkPaste,
 				bulletAfterHeading,
+				substitution,
 				placeholder,
 				readOnly,
 				wikilinkEnabled: !!onWikilinkSearch,
@@ -1725,7 +1813,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 
 //#endregion
 //#region src/components/editor.tsx
-function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste = true, linkPaste = true, bulletAfterHeading = false, frontmatter = false, blockHandle = true, placeholder, readOnly, spellCheck, timeFormat, editorClassName, wrapperClassName, handleRef, children }) {
+function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveFileInfo, onFileClick, onFilePaste, onFileSaveError, onImageClick, embedPaste = true, linkPaste = true, bulletAfterHeading = false, substitution = true, frontmatter = false, blockHandle = true, placeholder, readOnly, spellCheck, timeFormat, editorClassName, wrapperClassName, handleRef, children }) {
 	const childRef = useRef(null);
 	useImperativeHandle(handleRef, () => {
 		function getMarkdown() {
@@ -1747,6 +1835,9 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 		function setState(markdown, selection) {
 			childRef.current?.setState(markdown, selection);
 		}
+		function refreshMarkdownRendering() {
+			childRef.current?.refreshMarkdownRendering();
+		}
 		function getSelection() {
 			return childRef.current?.getSelection() ?? {
 				type: "text",
@@ -1763,6 +1854,9 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 		function scrollIntoView() {
 			childRef.current?.scrollIntoView();
 		}
+		function revealHeading(fragment) {
+			return childRef.current?.revealHeading(fragment) ?? false;
+		}
 		function getSelectedText() {
 			return childRef.current?.getSelectedText() ?? "";
 		}
@@ -1787,10 +1881,12 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 			insertMarkdown,
 			getState,
 			setState,
+			refreshMarkdownRendering,
 			getSelection,
 			setSelection,
 			focus,
 			scrollIntoView,
+			revealHeading,
 			getSelectedText,
 			openSelectionMenu,
 			startPendingReplacement,
@@ -1823,6 +1919,7 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 			onExitBoundary,
 			resolveImageUrl,
 			resolveFileLink,
+			resolveWikiEmbed,
 			resolveFileInfo,
 			onFileClick,
 			onFilePaste,
@@ -1831,6 +1928,7 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 			embedPaste,
 			linkPaste,
 			bulletAfterHeading,
+			substitution,
 			frontmatter,
 			blockHandle,
 			placeholder,
@@ -2034,6 +2132,74 @@ function ImageView(props) {
 		})]
 	});
 }
+function FileView(props) {
+	const { href, name, context, children } = props;
+	const resolveFileInfo = context.resolveFileInfo;
+	const [resolvedSize, setResolvedSize] = useState();
+	useEffect(() => {
+		if (!resolveFileInfo) return;
+		let active = true;
+		const load = async () => {
+			try {
+				const info = await resolveFileInfo(href);
+				if (!active || info?.size == null || !Number.isFinite(info.size) || info.size < 0) return;
+				setResolvedSize({
+					href,
+					resolver: resolveFileInfo,
+					text: formatFileSize(info.size)
+				});
+			} catch (error) {
+				console.error("[meowdown] resolveFileInfo failed:", error);
+			}
+		};
+		load();
+		return () => {
+			active = false;
+		};
+	}, [resolveFileInfo, href]);
+	const size = resolvedSize?.href === href && resolvedSize.resolver === resolveFileInfo ? resolvedSize.text : "";
+	const handleClick = context.onFileClick ? (event) => context.onFileClick?.({
+		href,
+		name,
+		event: event.nativeEvent
+	}) : void 0;
+	return /* @__PURE__ */ jsxs("span", {
+		className: "md-file-view md-atom-view",
+		children: [/* @__PURE__ */ jsxs("span", {
+			className: "md-file-view-preview md-atom-view-preview",
+			"data-testid": "file-pill",
+			"data-file-kind": getFileKind(href),
+			contentEditable: false,
+			title: name,
+			onClick: handleClick,
+			children: [
+				/* @__PURE__ */ jsxs("svg", {
+					className: "md-file-view-icon",
+					viewBox: "0 0 24 24",
+					"aria-hidden": "true",
+					fill: "none",
+					stroke: "currentColor",
+					strokeWidth: "2",
+					strokeLinecap: "round",
+					strokeLinejoin: "round",
+					children: [/* @__PURE__ */ jsx("path", { d: "M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z" }), /* @__PURE__ */ jsx("path", { d: "M14 2v4a2 2 0 0 0 2 2h4" })]
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: "md-file-view-name",
+					children: name
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: "md-file-view-size",
+					"data-testid": "file-pill-size",
+					children: size
+				})
+			]
+		}), /* @__PURE__ */ jsx("span", {
+			className: "md-file-view-content md-atom-view-content",
+			children
+		})]
+	});
+}
 function renderTokens(code, tokens) {
 	const out = [];
 	let pos = 0;
@@ -2135,6 +2301,15 @@ function wrapMark(mark, children, context) {
 				children
 			});
 		}
+		case "mdFile": {
+			const attrs = mark.attrs;
+			return /* @__PURE__ */ jsx(FileView, {
+				href: attrs.href,
+				name: attrs.name,
+				context,
+				children
+			});
+		}
 		case "mdMath": {
 			const attrs = mark.attrs;
 			return /* @__PURE__ */ jsx(MathView, {
@@ -2195,7 +2370,10 @@ function renderRuns(runs, depth, context) {
 function renderInline(node, context) {
 	const text = node.textContent;
 	if (!text) return null;
-	return renderRuns(inlineTextToMarkChunks(getMarkBuilders(), text).map(([from, to, marks]) => ({
+	return renderRuns(inlineTextToMarkChunks(getMarkBuilders(), text, {
+		resolveFileLink: context.resolveFileLink,
+		resolveWikiEmbed: context.resolveWikiEmbed
+	}).map(([from, to, marks]) => ({
 		text: text.slice(from, to),
 		marks: Mark.setFrom(marks)
 	})), 0, context);
@@ -2251,18 +2429,22 @@ function renderBlock(node, context) {
 * and CSS (the root carries `ProseMirror` + `data-mark-mode` so the existing
 * stylesheet applies). Requires a DOM environment.
 *
-* Callbacks (`onWikilinkClick`, etc.) should be stable; pass them via
+* Callbacks (`onWikilinkClick`, etc.) and resolvers should be stable; pass them via
 * `useCallback` to avoid re-rendering the whole tree.
 */
-function MarkdownView({ markdown, markMode = "hide", frontmatter = false, interactive = true, resolveImageUrl, onWikilinkClick, onLinkClick, onImageClick, onTaskClick, className }) {
+function MarkdownView({ markdown, markMode = "hide", frontmatter = false, interactive = true, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveFileInfo, onWikilinkClick, onLinkClick, onImageClick, onFileClick, onTaskClick, className }) {
 	const content = useMemo(() => {
 		const doc = markdownToDoc(markdown, { frontmatter });
 		const context = {
 			interactive,
 			resolveImageUrl,
+			resolveFileLink,
+			resolveWikiEmbed,
+			resolveFileInfo,
 			onWikilinkClick: interactive ? onWikilinkClick : void 0,
 			onLinkClick: interactive ? onLinkClick : void 0,
 			onImageClick: interactive ? onImageClick : void 0,
+			onFileClick: interactive ? onFileClick : void 0,
 			onTaskClick: interactive ? onTaskClick : void 0,
 			taskCounter: { value: 0 },
 			keyCounter: { value: 0 }
@@ -2273,9 +2455,13 @@ function MarkdownView({ markdown, markMode = "hide", frontmatter = false, intera
 		frontmatter,
 		interactive,
 		resolveImageUrl,
+		resolveFileLink,
+		resolveWikiEmbed,
+		resolveFileInfo,
 		onWikilinkClick,
 		onLinkClick,
 		onImageClick,
+		onFileClick,
 		onTaskClick
 	]);
 	return /* @__PURE__ */ jsx("div", {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/react",
   "type": "module",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,9 +24,9 @@
     "@prosekit/pm": "^0.1.19-beta.3",
     "@prosekit/react": "^0.8.0-beta.21",
     "clsx": "^2.1.1",
-    "lucide-react": "^1.21.0",
+    "lucide-react": "^1.24.0",
     "react-property": "^2.0.2",
-    "@meowdown/core": "0.47.0"
+    "@meowdown/core": "0.49.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -41,17 +41,17 @@
     }
   },
   "devDependencies": {
-    "@css-modules-kit/codegen": "^1.3.0",
+    "@css-modules-kit/codegen": "^1.4.0",
     "@ocavue/tsconfig": "^0.7.1",
-    "@tsdown/css": "^0.22.3",
+    "@tsdown/css": "^0.22.7",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@vitest/browser-playwright": "^4.1.9",
+    "@vitest/browser-playwright": "^4.1.10",
     "dedent": "^1.7.2",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "tsdown": "^0.22.3",
-    "vitest": "^4.1.9",
+    "tsdown": "^0.22.7",
+    "vitest": "^4.1.10",
     "vitest-browser-commands": "^0.2.1",
     "vitest-browser-react": "^2.2.0",
     "@meowdown/vitest": "0.0.0"