@meowdown/react 0.48.0 → 0.50.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
@@ -374,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, substitution, 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}. */
@@ -414,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.
@@ -422,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`). */
@@ -441,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, defineSubstitution, 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";
@@ -1090,6 +1090,11 @@ function SlashMenu({ timeFormat = "12", onSlashMenuSearch, onFilePaste, onFileSa
 				"data-testid": "slash-menu",
 				children: [
 					!inTableCell && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+						/* @__PURE__ */ jsx(SlashMenuItem, {
+							label: "Text",
+							keywords: ["paragraph", "plain"],
+							onSelect: () => editor.commands.turnIntoText()
+						}),
 						/* @__PURE__ */ jsx(SlashMenuItem, {
 							label: "Heading 1",
 							kbd: "#",
@@ -1545,10 +1550,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, substitution = true, 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, {
@@ -1584,7 +1656,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) {
@@ -1595,6 +1667,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);
@@ -1602,9 +1675,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);
 		}
@@ -1617,6 +1697,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);
 		}
@@ -1642,10 +1729,12 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onSl
 			insertMarkdown,
 			getState,
 			setState,
+			refreshMarkdownRendering,
 			getSelection,
 			setSelection,
 			focus,
 			scrollIntoView,
+			revealHeading,
 			getSelectedText: getSelectedTextFromState,
 			openSelectionMenu: openSelectionMenuFromHandle,
 			startPendingReplacement,
@@ -1729,7 +1818,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, substitution = true, 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() {
@@ -1751,6 +1840,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",
@@ -1767,6 +1859,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() ?? "";
 		}
@@ -1791,10 +1886,12 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 			insertMarkdown,
 			getState,
 			setState,
+			refreshMarkdownRendering,
 			getSelection,
 			setSelection,
 			focus,
 			scrollIntoView,
+			revealHeading,
 			getSelectedText,
 			openSelectionMenu,
 			startPendingReplacement,
@@ -1827,6 +1924,7 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onSlashM
 			onExitBoundary,
 			resolveImageUrl,
 			resolveFileLink,
+			resolveWikiEmbed,
 			resolveFileInfo,
 			onFileClick,
 			onFilePaste,
@@ -2039,6 +2137,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;
@@ -2140,6 +2306,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, {
@@ -2200,7 +2375,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);
@@ -2256,18 +2434,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 }
@@ -2278,9 +2460,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.48.0",
+  "version": "0.50.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "clsx": "^2.1.1",
     "lucide-react": "^1.24.0",
     "react-property": "^2.0.2",
-    "@meowdown/core": "0.48.0"
+    "@meowdown/core": "0.50.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",