@meowdown/react 0.45.1 → 0.46.1

package/README.md

@@ -60,12 +60,18 @@ Slash menu host items can include `keywords` to match hidden terms without chang
 
 Mount `WikilinkHoverCard` inside `MeowdownEditor` and render host-owned preview
 content from the hovered wiki link's `target`. Returning `null` renders no
-card.
+card. The render function may also return a promise: the card stays closed
+until it resolves, resolving to `null` (or rejecting) renders no card, and a
+result that lands after the pointer moved on is discarded, so a host can look
+up local content without ever flashing an empty card.
 
 ```tsx
 <MeowdownEditor initialMarkdown="See [[Project plan]]">
   <WikilinkHoverCard>
-    {(hit) => <LocalNotePreview key={hit.target} target={hit.target} />}
+    {async (hit) => {
+      const note = await readLocalNote(hit.target)
+      return note == null ? null : <LocalNotePreview note={note} />
+    }}
   </WikilinkHoverCard>
 </MeowdownEditor>
 ```

package/dist/index.d.ts

@@ -446,9 +446,13 @@ declare function MarkdownView({ markdown, markMode, frontmatter, interactive, re
 interface WikilinkHoverCardProps {
   /**
    * Render the card body from the hovered wiki link. Returning `null` renders
-   * no card.
+   * no card. A returned promise keeps the card closed until it resolves;
+   * resolving to `null` or rejecting renders no card, and a result that lands
+   * after the pointer moved on is discarded. The function runs once per
+   * hovered link rather than on every render, and a new function identity
+   * re-runs it for the current link.
    */
-  readonly children: (hit: WikilinkHoverHit) => ReactNode;
+  readonly children: (hit: WikilinkHoverHit) => ReactNode | Promise<ReactNode>;
   /** Optional class applied to the popup, after the default card surface. */
   readonly className?: string;
 }

package/dist/index.js

@@ -2302,7 +2302,7 @@ var wikilink_hover_card_module_default = {
 //#endregion
 //#region src/components/wikilink-hover-card.tsx
 const OPEN_DELAY = 300;
-const CLOSE_DELAY = 200;
+const CLOSE_DELAY = 100;
 /**
 * Show host-rendered content after a 300ms dwell over a rendered wiki link.
 */
@@ -2311,6 +2311,7 @@ function WikilinkHoverCard({ children, className }) {
 	const lastRectRef = useRef(null);
 	const [displayed, setDisplayed] = useState();
 	const [open, setOpen] = useState(false);
+	const [body, setBody] = useState(null);
 	const [hoverExtension] = useState(() => {
 		return defineWikilinkHoverHandler((nextHit) => setHit(nextHit));
 	});
@@ -2323,10 +2324,31 @@ function WikilinkHoverCard({ children, className }) {
 	const anchor = useMemo(() => {
 		return { getBoundingClientRect: getRect };
 	}, [getRect]);
+	useEffect(() => {
+		let stale = false;
+		const resolveBody = async () => {
+			try {
+				const resolved = await (displayed ? children(displayed) : null);
+				if (!stale) setBody(resolved);
+			} catch (error) {
+				if (stale) return;
+				console.error("[meowdown] wikilink hover card body rejected:", error);
+				setBody(null);
+			}
+		};
+		resolveBody();
+		return () => {
+			stale = true;
+		};
+	}, [children, displayed]);
 	const hasDisplayed = !!displayed;
+	const hasBody = body != null;
 	useEffect(() => {
 		if (!hit) {
-			const timer = setTimeout(() => setOpen(false), CLOSE_DELAY);
+			const timer = setTimeout(() => {
+				setOpen(false);
+				if (!hasBody) setDisplayed(void 0);
+			}, hasBody ? CLOSE_DELAY : 0);
 			return () => clearTimeout(timer);
 		}
 		const timer = setTimeout(() => {
@@ -2334,8 +2356,11 @@ function WikilinkHoverCard({ children, className }) {
 			setOpen(true);
 		}, hasDisplayed ? 0 : OPEN_DELAY);
 		return () => clearTimeout(timer);
-	}, [hit, hasDisplayed]);
-	const body = displayed ? children(displayed) : null;
+	}, [
+		hit,
+		hasDisplayed,
+		hasBody
+	]);
 	return /* @__PURE__ */ jsx(PreviewCard.Root, {
 		open: open && body != null,
 		onOpenChange: (nextOpen) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/react",
   "type": "module",
-  "version": "0.45.1",
+  "version": "0.46.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
     "clsx": "^2.1.1",
     "lucide-react": "^1.21.0",
     "react-property": "^2.0.2",
-    "@meowdown/core": "0.45.1"
+    "@meowdown/core": "0.46.1"
   },
   "peerDependencies": {
     "react": "^19.0.0",