@meowdown/react 0.64.0 → 0.64.1

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);
@@ -773,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);
@@ -1004,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([]);
@@ -1081,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);
 }
@@ -2384,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, {
@@ -2412,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": {
@@ -2518,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.64.0",
+  "version": "0.64.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
     "github-slugger": "^2.0.0",
     "lucide-react": "^1.28.0",
     "react-property": "^2.0.2",
-    "@meowdown/core": "0.64.0"
+    "@meowdown/core": "0.64.1"
   },
   "peerDependencies": {
     "react": "^19.0.0",