@meowdown/react 0.77.0 → 0.78.0

package/README.md

@@ -58,16 +58,16 @@ export function App() {
 
 Common `MarkdownEditor` props:
 
-| 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` / `onXPostMediaClick` / `onYouTubeVideoClick` | Click handling for the rendered atoms                                              |
-| `resolveImageUrl` / `resolveWikiEmbed` / `resolveWikilink` / `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                                                                   |
-| `CodeBlockView`                                                                                                                 | Custom React node view component for code blocks                                   |
+| 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` / `onXPostMediaClick` / `onYouTubeVideoClick`                   | Click handling for the rendered atoms                                              |
+| `resolveImageUrl` / `resolveWikiEmbed` / `resolveWikilink` / `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` / `backspaceDeletesEmptyFirstBlock` | Behavior toggles                                                                   |
+| `CodeBlockView`                                                                                                                                   | Custom React node view component for code blocks                                   |
 
 Every prop, callback, and `EditorHandle` method is documented in the [API reference](https://npmx.dev/package-docs/@meowdown%2Freact/).
 

package/dist/index.d.ts

@@ -495,6 +495,12 @@ interface EditorProps {
    * Off by default.
    */
   bulletAfterHeading?: boolean;
+  /**
+   * Pressing Backspace in an empty paragraph that is the document's first
+   * block deletes that paragraph, so the rest of the document moves up one
+   * line. The block after it keeps its type. Off by default.
+   */
+  backspaceDeletesEmptyFirstBlock?: boolean;
   /**
    * Replaces typed character sequences with their typographic equivalents,
    * e.g. `->` with `→` and `(c)` with `©`. On by default.
@@ -577,7 +583,7 @@ interface EditorProps {
  *
  * Callbacks and resolvers should be stable; pass them via `useCallback`.
  */
-export declare function MarkdownEditor({ mode, initialMarkdown, singleParagraph, referenceDefinitions, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, resolveLinkPreview, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onFileClick, onFilePaste, onFileSaveError, onImageClick, onXPostMediaClick, onYouTubeVideoClick, embedPaste, linkPaste, bulletAfterHeading, substitution, frontmatter, blockHandle, caretGlide, placeholder, readOnly, spellCheck, searchQuery, onSearchChange, timeFormat, editorClassName, wrapperClassName, CodeBlockView, handleRef, children }: EditorProps): ReactElement;
+export declare function MarkdownEditor({ mode, initialMarkdown, singleParagraph, referenceDefinitions, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, resolveLinkPreview, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onFileClick, onFilePaste, onFileSaveError, onImageClick, onXPostMediaClick, onYouTubeVideoClick, embedPaste, linkPaste, bulletAfterHeading, backspaceDeletesEmptyFirstBlock, substitution, frontmatter, blockHandle, caretGlide, placeholder, readOnly, spellCheck, searchQuery, onSearchChange, timeFormat, editorClassName, wrapperClassName, CodeBlockView, handleRef, children }: EditorProps): ReactElement;
 //#endregion
 //#region src/components/markdown-view.d.ts
 /**
@@ -625,7 +631,7 @@ interface MarkdownViewProps {
   /**
    * Interpret content as one paragraph, without block syntax.
    */
-  inline?: boolean;
+  singleParagraph?: boolean;
   /**
    * Reference definitions available outside this fragment.
    */
@@ -737,7 +743,7 @@ interface MarkdownViewProps {
  * Callbacks (`onWikilinkClick`, etc.) and resolvers should be stable; pass them via
  * `useCallback` to avoid re-rendering the whole tree.
  */
-export declare function MarkdownView({ markdown, inline, referenceDefinitions: suppliedDefinitions, markMode, frontmatter, interactive, expandCollapsed, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onWikilinkClick, onLinkClick, onImageClick, onXPostMediaClick, onYouTubeVideoClick, onFileClick, onTaskClick, className }: MarkdownViewProps): ReactElement;
+export declare function MarkdownView({ markdown, singleParagraph, referenceDefinitions: suppliedDefinitions, markMode, frontmatter, interactive, expandCollapsed, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onWikilinkClick, onLinkClick, onImageClick, onXPostMediaClick, onYouTubeVideoClick, onFileClick, onTaskClick, className }: MarkdownViewProps): ReactElement;
 //#endregion
 //#region src/hooks/use-lightbox.d.ts
 /**

package/dist/index.js

@@ -1884,7 +1884,7 @@ function findHeadingPosition(doc, fragment) {
 	});
 	return match;
 }
-function ProseKitEditor({ markMode = "focus", initialMarkdown, singleParagraph = false, referenceDefinitions, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, resolveLinkPreview, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onFileClick, onFilePaste, onFileSaveError, onImageClick, onXPostMediaClick, onYouTubeVideoClick, embedPaste, linkPaste, bulletAfterHeading, substitution = true, frontmatter = false, blockHandle = true, placeholder, readOnly, spellCheck, searchQuery = "", onSearchChange, timeFormat, editorClassName, CodeBlockView, ref, children }) {
+function ProseKitEditor({ markMode = "focus", initialMarkdown, singleParagraph = false, referenceDefinitions, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, resolveLinkPreview, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onFileClick, onFilePaste, onFileSaveError, onImageClick, onXPostMediaClick, onYouTubeVideoClick, embedPaste, linkPaste, bulletAfterHeading, backspaceDeletesEmptyFirstBlock, substitution = true, frontmatter = false, blockHandle = true, placeholder, readOnly, spellCheck, searchQuery = "", onSearchChange, timeFormat, editorClassName, CodeBlockView, ref, children }) {
 	const suppressDocChangeRef = useRef(false);
 	const handleDocChange = useMemo(() => {
 		if (!onDocChange) return;
@@ -1917,6 +1917,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, singleParagraph =
 		embedPaste,
 		linkPaste,
 		bulletAfterHeading,
+		backspaceDeletesEmptyFirstBlock,
 		substitution,
 		placeholder,
 		readOnly,
@@ -1947,6 +1948,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, singleParagraph =
 		embedPaste,
 		linkPaste,
 		bulletAfterHeading,
+		backspaceDeletesEmptyFirstBlock,
 		substitution,
 		placeholder,
 		readOnly,
@@ -2157,7 +2159,7 @@ const CARET_GLIDE_OFF = { "--meowdown-caret-glide": "0ms" };
 *
 * Callbacks and resolvers should be stable; pass them via `useCallback`.
 */
-function MarkdownEditor({ mode = "focus", initialMarkdown, singleParagraph, referenceDefinitions, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, resolveLinkPreview, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onFileClick, onFilePaste, onFileSaveError, onImageClick, onXPostMediaClick, onYouTubeVideoClick, embedPaste = true, linkPaste = true, bulletAfterHeading = false, substitution = true, frontmatter = false, blockHandle = true, caretGlide = true, placeholder, readOnly, spellCheck, searchQuery, onSearchChange, timeFormat, editorClassName, wrapperClassName, CodeBlockView, handleRef, children }) {
+function MarkdownEditor({ mode = "focus", initialMarkdown, singleParagraph, referenceDefinitions, onDocChange, onSlashMenuSearch, onTagSearch, onWikilinkSearch, onSelectionMenuSearch, selectionMenuAffordance = true, pendingReplacementActions, onPendingReplacementResolve, onWikilinkClick, onLinkClick, onLinkCopy, resolveLinkPreview, onTagClick, onExitBoundary, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onFileClick, onFilePaste, onFileSaveError, onImageClick, onXPostMediaClick, onYouTubeVideoClick, embedPaste = true, linkPaste = true, bulletAfterHeading = false, backspaceDeletesEmptyFirstBlock = false, substitution = true, frontmatter = false, blockHandle = true, caretGlide = true, placeholder, readOnly, spellCheck, searchQuery, onSearchChange, timeFormat, editorClassName, wrapperClassName, CodeBlockView, handleRef, children }) {
 	const childRef = useRef(null);
 	useImperativeHandle(handleRef, () => {
 		function getMarkdown() {
@@ -2295,6 +2297,7 @@ function MarkdownEditor({ mode = "focus", initialMarkdown, singleParagraph, refe
 			embedPaste,
 			linkPaste,
 			bulletAfterHeading,
+			backspaceDeletesEmptyFirstBlock,
 			substitution,
 			frontmatter,
 			blockHandle,
@@ -2875,7 +2878,7 @@ function renderCodeBlock(node, key) {
 	}, key);
 }
 function renderBlock(node, context, parent, index) {
-	if (!context.inline && isReferenceDefinitionNode(node, parent, index)) return null;
+	if (!context.singleParagraph && isReferenceDefinitionNode(node, parent, index)) return null;
 	const key = context.keyCounter.value++;
 	const typeName = node.type.name;
 	let handleTaskClick;
@@ -2958,9 +2961,9 @@ const MarkdownBlock = memo(function MarkdownBlock({ node, taskBase, context, ref
 * Callbacks (`onWikilinkClick`, etc.) and resolvers should be stable; pass them via
 * `useCallback` to avoid re-rendering the whole tree.
 */
-function MarkdownView({ markdown, inline = false, referenceDefinitions: suppliedDefinitions, markMode = "hide", frontmatter = false, interactive = true, expandCollapsed = false, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onWikilinkClick, onLinkClick, onImageClick, onXPostMediaClick, onYouTubeVideoClick, onFileClick, onTaskClick, className }) {
+function MarkdownView({ markdown, singleParagraph = false, referenceDefinitions: suppliedDefinitions, markMode = "hide", frontmatter = false, interactive = true, expandCollapsed = false, resolveImageUrl, resolveFileLink, resolveWikiEmbed, resolveWikilink, resolveFileInfo, resolveXPost, mediaUrlProtocols, resolveYouTubeVideo, onWikilinkClick, onLinkClick, onImageClick, onXPostMediaClick, onYouTubeVideoClick, onFileClick, onTaskClick, className }) {
 	const context = useMemo(() => ({
-		inline,
+		singleParagraph,
 		interactive,
 		expandCollapsed,
 		resolveImageUrl,
@@ -2977,7 +2980,7 @@ function MarkdownView({ markdown, inline = false, referenceDefinitions: supplied
 		onFileClick: interactive ? onFileClick : void 0,
 		onTaskClick: interactive ? onTaskClick : void 0
 	}), [
-		inline,
+		singleParagraph,
 		interactive,
 		expandCollapsed,
 		resolveImageUrl,
@@ -2995,8 +2998,8 @@ function MarkdownView({ markdown, inline = false, referenceDefinitions: supplied
 		onTaskClick
 	]);
 	const { blocks, referenceDefinitions, definitionsKey } = useMemo(() => {
-		const doc = inline ? paragraphMarkdownToDoc(markdown) : markdownToDoc(markdown, { frontmatter });
-		const localDefinitions = inline ? /* @__PURE__ */ new Map() : collectReferenceDefinitions(doc).definitions;
+		const doc = singleParagraph ? paragraphMarkdownToDoc(markdown) : markdownToDoc(markdown, { frontmatter });
+		const localDefinitions = singleParagraph ? /* @__PURE__ */ new Map() : collectReferenceDefinitions(doc).definitions;
 		const referenceDefinitions = suppliedDefinitions ? new Map([...suppliedDefinitions, ...localDefinitions]) : localDefinitions;
 		return {
 			blocks: splitBlocks(doc),
@@ -3006,7 +3009,7 @@ function MarkdownView({ markdown, inline = false, referenceDefinitions: supplied
 	}, [
 		markdown,
 		frontmatter,
-		inline,
+		singleParagraph,
 		suppliedDefinitions
 	]);
 	const handleXPostMediaClick = interactive ? onXPostMediaClick : void 0;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/react",
   "type": "module",
-  "version": "0.77.0",
+  "version": "0.78.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
   ],
   "dependencies": {
     "@base-ui/react": "^1.8.0",
-    "@meowdown/core": "0.78.4",
+    "@meowdown/core": "0.79.0",
     "@meowdown/embed": "0.3.1",
     "@meowdown/markdown": "0.76.0",
     "@ocavue/utils": "^1.8.0",