@meowdown/react 0.63.1 → 0.64.1

package/README.md

@@ -27,9 +27,6 @@ export function App() {
 ## Usage
 
 ```tsx
-import '@meowdown/core/style.css'
-import '@meowdown/react/style.css'
-
 import { MeowdownEditor, type EditorHandle } from '@meowdown/react'
 import { useRef, useCallback } from 'react'
 
@@ -50,125 +47,27 @@ export function App() {
 }
 ```
 
-## API
-
-See the full API reference [here](https://npmx.dev/package-docs/@meowdown%2Freact/).
-
-Slash menu host items can include `keywords` to match hidden terms without changing the displayed label.
-
-The caret glides between positions by default; pass `caretGlide={false}` to move it instantly (hosts can also tune the duration via the `--meowdown-caret-glide` CSS variable).
-
-`MarkdownView` folds collapsed (`+`) bullets like the editor; pass `expandCollapsed` to render them expanded at every depth, for views that show slices of a note (e.g. a backlinks panel) where the source's fold state must not hide the content the view exists to show.
-
-Both `MeowdownEditor` and `MarkdownView` resolve CommonMark full, collapsed,
-and shortcut reference links and images. The editor keeps reference definitions
-visible as editable source and preserves them through `getMarkdown()`.
-`MarkdownView` uses the same first-definition-wins resolution but omits
-definition paragraphs from its rendered output. Reference links are read-only
-in the editor's link menu; edit their definition source to change the target.
-
-### 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.
+## Components
 
-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}
-/>
-```
-
-### Find in document
-
-`searchQuery` highlights every match and selects the first one at or after the
-caret; changing it re-anchors from wherever the selection is, so refining a
-query keeps the match the user is looking at. A query that matches nothing
-collapses the previous match selection to a caret, and an empty string (the
-default) clears the highlights and leaves the selection alone. `onSearchChange` reports
-`{ total, active }` for a match counter (`active` is one-based; `0` means the
-selection is not on a match), and `EditorHandle.findNext()` /
-`EditorHandle.findPrevious()` walk the matches and wrap at the document edges.
-The query is applied through `useDeferredValue`, so fast typing may skip
-intermediate values on a slow device.
-
-```tsx
-const [query, setQuery] = useState('')
-const [status, setStatus] = useState({ total: 0, active: 0 })
-
-<input value={query} onChange={(event) => setQuery(event.target.value)} />
-<span>{status.active} / {status.total}</span>
-<MeowdownEditor
-  handleRef={editorRef}
-  searchQuery={query}
-  onSearchChange={setStatus}
-/>
-```
-
-### Wiki-link hover cards
-
-Mount `WikilinkHoverCard` inside `MeowdownEditor` and render host-owned preview
-content from the hovered wiki link's `target`. Returning `null` renders no
-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>
-    {async (hit) => {
-      const note = await readLocalNote(hit.target)
-      return note == null ? null : <LocalNotePreview note={note} />
-    }}
-  </WikilinkHoverCard>
-</MeowdownEditor>
-```
-
-For local-only passive preview content, render Markdown with interaction
-disabled: the tree contains no anchors or focusable controls, and recognized
-tweet and YouTube embeds are omitted before any image resolver runs. Supply a
-resolver that accepts only trusted local image sources.
-
-```tsx
-<MarkdownView markdown={markdown} interactive={false} resolveImageUrl={resolveLocalImageUrl} />
-```
+| Component           | Description                                                                                                                |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `MeowdownEditor`    | The editor. Callbacks and resolvers must be stable; pass them via `useCallback`.                                           |
+| `MarkdownView`      | Read-only Markdown renderer. `interactive={false}` renders passive content for previews.                                   |
+| `WikilinkHoverCard` | Mount inside `MeowdownEditor`; renders host content for the hovered wiki link's `target`. Return `null` to render no card. |
 
-### Mermaid code blocks
+Common `MeowdownEditor` props:
 
-Fenced `mermaid` code blocks render as diagrams in both `MeowdownEditor` and
-`MarkdownView`. The editor shows only the preview while the caret is outside
-the block, then shows source and a live preview while editing it.
+| Prop                                                                                                          | What it does                                                                       |
+| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `mode`                                                                                                        | `'focus'` (default), `'show'`, or `'hide'`: how much Markdown syntax stays in view |
+| `searchQuery` / `onSearchChange`                                                                              | Find in document, with `EditorHandle.findNext()` / `findPrevious()`                |
+| `onWikilinkClick` / `onLinkClick` / `onTagClick` / `onImageClick` / `onFileClick`                             | Click handling for the rendered atoms                                              |
+| `resolveImageUrl` / `resolveWikiEmbed` / `resolveFileLink` / `resolveFileInfo`                                | Resolve and classify local content                                                 |
+| `onFilePaste`                                                                                                 | Persist pasted or dropped files                                                    |
+| `onSlashMenuSearch` / `onTagSearch` / `onWikilinkSearch` / `onSelectionMenuSearch`                            | Search menus for `/`, `#`, `[[`, and selection commands                            |
+| `readOnly` / `placeholder` / `blockHandle` / `caretGlide` / `embedPaste` / `linkPaste` / `bulletAfterHeading` | Behavior toggles                                                                   |
 
-Rendering uses `beautiful-mermaid`, which currently supports Flowchart, State,
-Sequence, Class, ER, and XY Chart diagrams. Unsupported syntax renders an error
-instead of an empty preview. Override `--meowdown-mermaid-bg`,
-`--meowdown-mermaid-fg`, `--meowdown-mermaid-line`,
-`--meowdown-mermaid-accent`, `--meowdown-mermaid-muted`,
-`--meowdown-mermaid-surface`, `--meowdown-mermaid-border`, or
-`--meowdown-mermaid-error` to customize the diagram palette.
+Every prop, callback, and `EditorHandle` method is documented in the [API reference](https://npmx.dev/package-docs/@meowdown%2Freact/).
 
 ## Styling
 

package/dist/index.d.ts

@@ -6,7 +6,9 @@ import { useEditor, useExtension, useKeymap } from "@prosekit/react";
 type TimeFormat = '12' | '24';
 //#endregion
 //#region src/components/types.d.ts
-/** A selection to restore: an exact JSON selection, or a document edge. */
+/**
+ * A selection to restore: an exact JSON selection, or a document edge.
+ */
 type SelectionHint = SelectionJSON$1 | 'start' | 'end';
 /**
  * The current Markdown and selection. Selection positions are in the mounted
@@ -24,7 +26,9 @@ interface EditorHandle {
    * documents; call it on demand (e.g. throttled) instead of on every change.
    */
   getMarkdown: () => string;
-  /** Replaces the whole document as a single undoable edit. */
+  /**
+   * Replaces the whole document as a single undoable edit.
+   */
   setMarkdown: (markdown: string) => void;
   /**
    * Parses `markdown` and inserts it at the current selection as a single
@@ -36,7 +40,9 @@ interface EditorHandle {
    * `onDocChange`: the host cannot know the resulting document.
    */
   insertMarkdown: (markdown: string) => void;
-  /** Returns the current Markdown and selection. */
+  /**
+   * Returns the current Markdown and selection.
+   */
   getState: () => EditorStateSnapshot;
   /**
    * Replaces the document (if `markdown` is given) and restores `selection`:
@@ -51,13 +57,21 @@ interface EditorHandle {
    * this when data consulted by a stable resolver changes out of band.
    */
   refreshMarkdownRendering: () => void;
-  /** Returns the current selection. */
+  /**
+   * Returns the current selection.
+   */
   getSelection: () => SelectionJSON$1;
-  /** Restores a selection with the same hint semantics as `setState`. */
+  /**
+   * Restores a selection with the same hint semantics as `setState`.
+   */
   setSelection: (selection: SelectionHint) => void;
-  /** Focuses the editor. */
+  /**
+   * Focuses the editor.
+   */
   focus: () => void;
-  /** Scrolls the selection into view. */
+  /**
+   * Scrolls the selection into view.
+   */
   scrollIntoView: () => void;
   /**
    * Moves the selection to the first heading matching a decoded `#fragment`
@@ -82,7 +96,9 @@ interface EditorHandle {
    * is how a retry starts.
    */
   startPendingReplacement: (options: StartPendingReplacementOptions) => boolean;
-  /** Appends streamed text to the staged replacement. */
+  /**
+   * Appends streamed text to the staged replacement.
+   */
   appendPendingReplacementText: (text: string) => void;
   /**
    * Applies the staged replacement to the document as a single edit. Pass a
@@ -90,11 +106,17 @@ interface EditorHandle {
    * below" on a replace stage).
    */
   acceptPendingReplacement: (options?: AcceptPendingReplacementOptions) => void;
-  /** Clears the staged replacement without touching the document. */
+  /**
+   * Clears the staged replacement without touching the document.
+   */
   discardPendingReplacement: () => void;
-  /** Selects the next match of the current search query, wrapping at the document end. */
+  /**
+   * Selects the next match of the current search query, wrapping at the document end.
+   */
   findNext: () => void;
-  /** Selects the previous match of the current search query, wrapping at the document start. */
+  /**
+   * Selects the previous match of the current search query, wrapping at the document start.
+   */
   findPrevious: () => void;
   /**
    * Escape hatch: the underlying ProseKit editor, or `undefined` when the
@@ -102,17 +124,29 @@ interface EditorHandle {
    */
   readonly editor: TypedEditor | undefined;
 }
-/** One row of host items in the slash menu. The host ranks the rows; the menu does not re-sort. */
+/**
+ * One row of host items in the slash menu. The host ranks the rows; the menu does not re-sort.
+ */
 interface SlashMenuItem {
-  /** Stable row key; defaults to `label`. */
+  /**
+   * Stable row key; defaults to `label`.
+   */
   id?: string;
-  /** Display text, matched against the typed query like the built-in items. */
+  /**
+   * Display text, matched against the typed query like the built-in items.
+   */
   label: string;
-  /** Extra match terms beyond the label; never displayed. */
+  /**
+   * Extra match terms beyond the label; never displayed.
+   */
   keywords?: string[];
-  /** Secondary text shown beside the label. */
+  /**
+   * Secondary text shown beside the label.
+   */
   detail?: string;
-  /** Runs after the menu closes and the typed `/query` text is removed. */
+  /**
+   * Runs after the menu closes and the typed `/query` text is removed.
+   */
   onSelect: () => void;
 }
 /**
@@ -121,15 +155,25 @@ interface SlashMenuItem {
  * show after the built-in items, either synchronously or as a promise.
  */
 type SlashMenuSearchHandler = (query: string) => SlashMenuItem[] | Promise<SlashMenuItem[]>;
-/** One row in the tag menu. The host ranks the rows; the menu does not re-sort. */
+/**
+ * One row in the tag menu. The host ranks the rows; the menu does not re-sort.
+ */
 interface TagItem {
-  /** Inserted as `#tag `. */
+  /**
+   * Inserted as `#tag `.
+   */
   tag: string;
-  /** Display text; defaults to `#tag`. */
+  /**
+   * Display text; defaults to `#tag`.
+   */
   label?: string;
-  /** Secondary text shown beside the label. */
+  /**
+   * Secondary text shown beside the label.
+   */
   detail?: string;
-  /** Side effect run after the tag is inserted (e.g. create the tag). */
+  /**
+   * Side effect run after the tag is inserted (e.g. create the tag).
+   */
   onSelect?: () => void;
 }
 /**
@@ -138,15 +182,25 @@ interface TagItem {
  * synchronously or as a promise.
  */
 type TagSearchHandler = (query: string) => TagItem[] | Promise<TagItem[]>;
-/** One row in the wikilink menu. The host ranks the rows; the menu does not re-sort. */
+/**
+ * One row in the wikilink menu. The host ranks the rows; the menu does not re-sort.
+ */
 interface WikilinkItem {
-  /** Inserted as `[[target]]`. */
+  /**
+   * Inserted as `[[target]]`.
+   */
   target: string;
-  /** Display text; defaults to `target`. */
+  /**
+   * Display text; defaults to `target`.
+   */
   label?: string;
-  /** Secondary text shown beside the label. */
+  /**
+   * Secondary text shown beside the label.
+   */
   detail?: string;
-  /** Side effect run after the link is inserted (e.g. create the note). */
+  /**
+   * Side effect run after the link is inserted (e.g. create the note).
+   */
   onSelect?: () => void;
 }
 /**
@@ -156,24 +210,42 @@ interface WikilinkItem {
  * a promise.
  */
 type WikilinkSearchHandler = (query: string) => WikilinkItem[] | Promise<WikilinkItem[]>;
-/** The selection the selection menu was opened over. */
+/**
+ * The selection the selection menu was opened over.
+ */
 interface SelectionMenuContext {
-  /** The selected text, with block boundaries as blank lines. */
+  /**
+   * The selected text, with block boundaries as blank lines.
+   */
   selectedText: string;
-  /** Start of the selection. */
+  /**
+   * Start of the selection.
+   */
   from: number;
-  /** End of the selection. */
+  /**
+   * End of the selection.
+   */
   to: number;
 }
-/** One row in the selection menu. The host ranks the rows; the menu does not re-sort. */
+/**
+ * One row in the selection menu. The host ranks the rows; the menu does not re-sort.
+ */
 interface SelectionMenuItem {
-  /** Stable identity for the row. */
+  /**
+   * Stable identity for the row.
+   */
   id: string;
-  /** Display text. */
+  /**
+   * Display text.
+   */
   label: string;
-  /** Secondary text shown beside the label. */
+  /**
+   * Secondary text shown beside the label.
+   */
   detail?: string;
-  /** Runs when the row is picked, with the selection the menu was opened over. */
+  /**
+   * Runs when the row is picked, with the selection the menu was opened over.
+   */
   onSelect: (context: SelectionMenuContext) => void;
 }
 /**
@@ -182,7 +254,9 @@ interface SelectionMenuItem {
  * returns the rows to show, either synchronously or as a promise.
  */
 type SelectionMenuSearchHandler = (query: string, context: SelectionMenuContext) => SelectionMenuItem[] | Promise<SelectionMenuItem[]>;
-/** Reports how a pending replacement ended and its final staged value. */
+/**
+ * Reports how a pending replacement ended and its final staged value.
+ */
 type PendingReplacementResolveHandler = (outcome: PendingReplacementOutcome, pending: PendingReplacement) => void;
 //#endregion
 //#region src/components/editor.d.ts
@@ -331,7 +405,9 @@ interface EditorProps {
    * other file. Return `undefined` to decline. Pass a stable function.
    */
   onFilePaste?: FilePasteOptions['onFilePaste'];
-  /** Called when persisting a pasted/dropped file throws. */
+  /**
+   * Called when persisting a pasted/dropped file throws.
+   */
   onFileSaveError?: FilePasteOptions['onFileSaveError'];
   /**
    * Called when the user clicks a rendered image, with its markdown `src`,
@@ -360,7 +436,9 @@ interface EditorProps {
    * e.g. `->` with `→` and `(c)` with `©`. On by default.
    */
   substitution?: boolean;
-  /** Handles a leading `---` frontmatter block (off by default). */
+  /**
+   * Handles a leading `---` frontmatter block (off by default).
+   */
   frontmatter?: boolean;
   /**
    * Shows the per-block gutter handle: a drag grip for reordering blocks and a
@@ -381,7 +459,9 @@ interface EditorProps {
    * receives the editor state. Pass a stable function.
    */
   placeholder?: PlaceholderOptions['placeholder'];
-  /** Makes the editor read-only. */
+  /**
+   * Makes the editor read-only.
+   */
   readOnly?: boolean;
   /**
    * Enables the browser's native spell checking. Defaults to the browser's
@@ -405,13 +485,21 @@ interface EditorProps {
    * for "15:45". Defaults to '12'.
    */
   timeFormat?: TimeFormat;
-  /** Class on the editable root (the contenteditable). */
+  /**
+   * Class on the editable root (the contenteditable).
+   */
   editorClassName?: string;
-  /** Class on the outer `.meowdown` wrapper div. */
+  /**
+   * Class on the outer `.meowdown` wrapper div.
+   */
   wrapperClassName?: string;
-  /** Imperative handle for the editor. */
+  /**
+   * Imperative handle for the editor.
+   */
   handleRef?: Ref<EditorHandle>;
-  /** Nodes rendered inside the editor's ProseKit context. */
+  /**
+   * Nodes rendered inside the editor's ProseKit context.
+   */
   children?: ReactNode;
 }
 /**
@@ -423,7 +511,9 @@ interface EditorProps {
 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, caretGlide, placeholder, readOnly, spellCheck, searchQuery, onSearchChange, timeFormat, editorClassName, wrapperClassName, handleRef, children }: EditorProps): ReactElement;
 //#endregion
 //#region src/components/markdown-view.d.ts
-/** Payload for {@link TaskClickHandler}. */
+/**
+ * Payload for {@link TaskClickHandler}.
+ */
 interface TaskClickPayload {
   /**
    * Zero-based position of the clicked checkbox among all the checkboxes this
@@ -432,9 +522,13 @@ interface TaskClickPayload {
    * same source.
    */
   index: number;
-  /** The checkbox's rendered state. The view never flips it — see the handler doc. */
+  /**
+   * The checkbox's rendered state. The view never flips it — see the handler doc.
+   */
   checked: boolean;
-  /** The item's list marker as written (`+` renders a circle checkbox, `-`/`*` a square). */
+  /**
+   * The item's list marker as written (`+` renders a circle checkbox, `-`/`*` a square).
+   */
   marker: ListMarker;
   /**
    * First line of the item's own inline content, exactly as it appears in the
@@ -443,7 +537,9 @@ interface TaskClickPayload {
    * mismatch instead of toggling the wrong item.
    */
   text: string;
-  /** The originating click. Read modifier keys or position a popover from it. */
+  /**
+   * The originating click. Read modifier keys or position a popover from it.
+   */
   event: globalThis.MouseEvent;
 }
 /**
@@ -453,11 +549,17 @@ interface TaskClickPayload {
  */
 type TaskClickHandler = (payload: TaskClickPayload) => void;
 interface MarkdownViewProps {
-  /** The Markdown to render. Live: changing it re-renders the content. */
+  /**
+   * The Markdown to render. Live: changing it re-renders the content.
+   */
   markdown: string;
-  /** Mark mode for the read-only view. Defaults to `'hide'`. */
+  /**
+   * Mark mode for the read-only view. Defaults to `'hide'`.
+   */
   markMode?: MarkMode;
-  /** Peel a leading YAML frontmatter block before rendering. Off by default. */
+  /**
+   * Peel a leading YAML frontmatter block before rendering. Off by default.
+   */
   frontmatter?: boolean;
   /**
    * Whether rendered links, images, file pills, and task checkboxes can be activated.
@@ -473,28 +575,46 @@ interface MarkdownViewProps {
    * the view exists to show.
    */
   expandCollapsed?: boolean;
-  /** Map an image `src` to a displayable URL, or `undefined` to skip it. */
+  /**
+   * 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. */
+  /**
+   * Classify `![[target]]` as an image, file, or note; unresolved source stays literal.
+   */
   resolveWikiEmbed?: WikiEmbedResolver;
-  /** Resolve metadata shown on a file pill. */
+  /**
+   * Resolve metadata shown on a file pill.
+   */
   resolveFileInfo?: FileInfoResolver;
-  /** Called when a rendered wikilink is clicked. Pass a stable function. */
+  /**
+   * 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. */
+  /**
+   * 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. */
+  /**
+   * 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. */
+  /**
+   * 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. */
+  /**
+   * Called when a rendered task checkbox is clicked. Pass a stable function.
+   */
   onTaskClick?: TaskClickHandler;
-  /** Extra class on the content root (alongside `ProseMirror meowdown-content`). */
+  /**
+   * Extra class on the content root (alongside `ProseMirror meowdown-content`).
+   */
   className?: string;
 }
 /**
@@ -511,7 +631,9 @@ interface MarkdownViewProps {
 declare function MarkdownView({ markdown, markMode, frontmatter, interactive, expandCollapsed, 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}. */
+/**
+ * Props for {@link WikilinkHoverCard}.
+ */
 interface WikilinkHoverCardProps {
   /**
    * Render the card body from the hovered wiki link. Returning `null` renders
@@ -522,7 +644,9 @@ interface WikilinkHoverCardProps {
    * re-runs it for the current link.
    */
   readonly children: (hit: WikilinkHoverHit) => ReactNode | Promise<ReactNode>;
-  /** Optional class applied to the popup, after the default card surface. */
+  /**
+   * Optional class applied to the popup, after the default card surface.
+   */
   readonly className?: string;
 }
 /**

package/dist/index.js

@@ -487,10 +487,14 @@ function EditorExtensions({ markMode, onDocChange, onWikilinkClick, onLinkClick,
 
 //#endregion
 //#region src/hooks/use-delayed-flag.ts
-/** Delay before the flag opens, in ms. */
+/**
+* Delay before the flag opens, in ms.
+*/
 const OPEN_DELAY$1 = 400;
-/** Grace before the flag closes, in ms. The window lets a pointer travel from
-*  the hovered link onto the popover it anchors. */
+/**
+* Grace before the flag closes, in ms. The window lets a pointer travel from
+*  the hovered link onto the popover it anchors.
+*/
 const CLOSE_DELAY$1 = 300;
 /**
 * Mirrors `value` into a boolean that flips true `openDelay`ms after `value`
@@ -527,14 +531,18 @@ var link_menu_module_default = {
 
 //#endregion
 //#region src/components/link-menu.tsx
-/** Select the link unit so the text-backed commands target it, and keep the
-*  editor focused so its virtual selection stays visible behind the popover. */
+/**
+* Select the link unit so the text-backed commands target it, and keep the
+*  editor focused so its virtual selection stays visible behind the popover.
+*/
 function selectLinkUnit(editor, link) {
 	editor.commands.selectText(link.unit.from, link.unit.to);
 	editor.focus();
 }
-/** A Base UI popover anchored at `anchor`. Base UI dismisses it on an outside
-*  press or Escape, both routed through `onClose`. */
+/**
+* A Base UI popover anchored at `anchor`. Base UI dismisses it on an outside
+*  press or Escape, both routed through `onClose`.
+*/
 function LinkPopover({ anchor, onClose, onPopupHover, children }) {
 	return /* @__PURE__ */ jsx(Popover.Root, {
 		open: true,
@@ -558,7 +566,9 @@ function LinkPopover({ anchor, onClose, onPopupHover, children }) {
 		}) })
 	});
 }
-/** The hover preview: the url plus copy, edit, and remove actions. */
+/**
+* The hover preview: the url plus copy, edit, and remove actions.
+*/
 function LinkInfoContent({ href, onLinkClick, onLinkCopy, onEdit, onRemove }) {
 	return /* @__PURE__ */ jsxs("div", {
 		className: link_menu_module_default.Row,
@@ -605,7 +615,9 @@ function LinkInfoContent({ href, onLinkClick, onLinkCopy, onEdit, onRemove }) {
 		]
 	});
 }
-/** The url and title form, opened by `Mod-k` or the preview's edit button. */
+/**
+* The url and title form, opened by `Mod-k` or the preview's edit button.
+*/
 function LinkEditContent({ link, onSubmit }) {
 	const hrefInputRef = useRef(null);
 	const titleInputRef = useRef(null);
@@ -658,17 +670,19 @@ function LinkMenu({ onLinkClick, onLinkCopy }) {
 	const [overPopup, setOverPopup] = useState(false);
 	const [edit, setEdit] = useState();
 	const hoverOpen = useDelayedFlag(onLink || overPopup);
-	useExtension$1(useMemo(() => {
+	const linkHoverExtension = useMemo(() => {
 		return defineLinkHoverHandler((hit) => {
 			setOnLink(!!hit);
 			if (hit) setHover(hit.payload);
 		});
-	}, []));
-	useExtension$1(useMemo(() => {
+	}, []);
+	useExtension$1(linkHoverExtension);
+	const linkEditExtension = useMemo(() => {
 		return defineLinkEditKeymap((options) => {
 			setEdit(options);
 		});
-	}, []));
+	}, []);
+	useExtension$1(linkEditExtension);
 	const closeHover = useCallback(() => {
 		setOnLink(false);
 		setOverPopup(false);
@@ -771,9 +785,13 @@ var pending_replacement_preview_module_default = {
 * 14rem max-height plus the footer, borders, and the anchor offset.
 */
 const PREVIEW_CLEARANCE = 320;
-/** Minimum gap (px) kept above the anchor line when scrolling to make room. */
+/**
+* Minimum gap (px) kept above the anchor line when scrolling to make room.
+*/
 const SCROLL_TOP_MARGIN = 16;
-/** The nearest ancestor that can scroll vertically, or the page scroller. */
+/**
+* The nearest ancestor that can scroll vertically, or the page scroller.
+*/
 function closestScrollable(element) {
 	for (let node = element.parentElement; node; node = node.parentElement) {
 		const { overflowY } = getComputedStyle(node);
@@ -1002,8 +1020,10 @@ function SelectionMenu({ onSelectionMenuSearch, context, onOpen, onClose, afford
 	});
 	return null;
 }
-/** The menu content. Mounted only while the menu is open, so its filter state
-*  resets naturally on close. */
+/**
+* The menu content. Mounted only while the menu is open, so its filter state
+*  resets naturally on close.
+*/
 function SelectionMenuPopup({ onSelectionMenuSearch, context, onClose }) {
 	const [query, setQuery] = useState("");
 	const [items, setItems] = useState([]);
@@ -1079,11 +1099,15 @@ function SelectionMenuPopup({ onSelectionMenuSearch, context, onClose }) {
 
 //#endregion
 //#region src/utils/date-format.ts
-/** Formats the current wall-clock time for the `/now` slash command. */
+/**
+* Formats the current wall-clock time for the `/now` slash command.
+*/
 function formatNowTime(timeFormat) {
 	return formatTime(/* @__PURE__ */ new Date(), timeFormat);
 }
-/** Formats a given time as `3:45pm` ('12') or `15:45` ('24'). */
+/**
+* Formats a given time as `3:45pm` ('12') or `15:45` ('24').
+*/
 function formatTime(date, timeFormat) {
 	return timeFormat === "12" ? formatTime12(date) : formatTime24(date);
 }
@@ -1689,11 +1713,13 @@ function findHeadingPosition(doc, fragment) {
 }
 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, searchQuery = "", onSearchChange, timeFormat, editorClassName, ref, children }) {
 	const [editor] = useState(() => {
-		const editor = createEditor({ extension: union(defineEditorExtension({
+		const baseExtension = defineEditorExtension({
 			resolveFileLink,
 			resolveWikiEmbed,
 			markMode
-		}), defineCodeBlockView()) });
+		});
+		const extension = union(baseExtension, defineCodeBlockView());
+		const editor = createEditor({ extension });
 		if (initialMarkdown) editor.setContent(markdownToDoc(initialMarkdown, {
 			nodes: editor.nodes,
 			frontmatter
@@ -2082,9 +2108,7 @@ function attributesToProps(attributes = {}, nodeName) {
 				case BOOLEAN:
 					props[propName] = true;
 					break;
-				case OVERLOADED_BOOLEAN:
-					if (attributeValue === "") props[propName] = true;
-					break;
+				case OVERLOADED_BOOLEAN: if (attributeValue === "") props[propName] = true;
 			}
 			continue;
 		}
@@ -2147,7 +2171,8 @@ function outputSpecToReact(spec, content, context) {
 			reactProps.tabIndex = -1;
 		}
 	}
-	return createElement(tag, reactProps, ...rest.map((child) => outputSpecToReact(child, content, context)));
+	const reactChildren = rest.map((child) => outputSpecToReact(child, content, context));
+	return createElement(tag, reactProps, ...reactChildren);
 }
 function WikilinkChip(props) {
 	const { target, display, onWikilinkClick, children } = props;
@@ -2381,7 +2406,9 @@ function MathView(props) {
 		})]
 	});
 }
-/** A `math` code block: the rendered formula alone, the source while KaTeX loads. */
+/**
+* A `math` code block: the rendered formula alone, the source while KaTeX loads.
+*/
 function MathCodeBlock({ code }) {
 	const katex = useKaTeX(true);
 	if (!katex) return /* @__PURE__ */ jsx(CodeBlock, {
@@ -2409,7 +2436,9 @@ function MermaidCodeBlock({ code }) {
 		"data-testid": "code-block-mermaid-preview"
 	});
 }
-/** Wrap inline `children` in one mark, special-casing the view/link marks. */
+/**
+* Wrap inline `children` in one mark, special-casing the view/link marks.
+*/
 function wrapMark(mark, children, context) {
 	switch (mark.type.name) {
 		case "mdWikilink": {
@@ -2515,7 +2544,9 @@ function renderInline(node, context) {
 		marks: Mark.setFrom(marks)
 	})), 0, context);
 }
-/** A collapsed list renders as an expanded one */
+/**
+* A collapsed list renders as an expanded one
+*/
 function expandCollapsedList(node) {
 	const attrs = node.attrs;
 	if (!attrs.collapsed) return node;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/react",
   "type": "module",
-  "version": "0.63.1",
+  "version": "0.64.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -29,9 +29,9 @@
     "beautiful-mermaid": "^1.1.3",
     "clsx": "^2.1.1",
     "github-slugger": "^2.0.0",
-    "lucide-react": "^1.27.0",
+    "lucide-react": "^1.28.0",
     "react-property": "^2.0.2",
-    "@meowdown/core": "0.63.1"
+    "@meowdown/core": "0.64.1"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -48,14 +48,14 @@
   "devDependencies": {
     "@css-modules-kit/codegen": "^1.4.0",
     "@ocavue/tsconfig": "^0.7.1",
-    "@tsdown/css": "^0.22.14",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
+    "@tsdown/css": "^0.23.0-beta.2",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
     "@vitest/browser-playwright": "^4.1.10",
     "dedent": "^1.7.2",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "tsdown": "^0.22.14",
+    "tsdown": "^0.23.0-beta.2",
     "vitest": "^4.1.10",
     "vitest-browser-commands": "^0.2.1",
     "vitest-browser-react": "^2.2.0",