@meowdown/react 0.8.1 → 0.10.0

package/README.md

@@ -47,6 +47,9 @@ The Markdown editor component. Renders inside a `div.meowdown` wrapper that fill
 - `resolveImageUrl?: (src: string) => string | undefined`: maps an image `src` to a displayable URL (or `undefined` to skip). Enables inline image rendering: `![alt](src)` stays literal text and the image renders beneath its line. Pass a stable function. Ignored in source mode.
 - `onImagePaste?: (file: File) => string | undefined | Promise<string | undefined>`: persists a pasted or dropped image file and returns its markdown `src` (or `undefined` to decline), synchronously or as a promise. Pass a stable function. Ignored in source mode.
 - `onImageSaveError?: (error: unknown, file: File) => void`: called when `onImagePaste` throws. Defaults to `console.error`. Ignored in source mode.
+- `embedPaste?: boolean`: auto-embeds a pasted tweet or YouTube link as a rich embed; one undo turns the embed back into the raw link. On by default; set `false` to disable. Only takes effect when `resolveImageUrl` is set, since embeds render through the image pipeline. Ignored in source mode.
+- `bulletAfterHeading?: boolean`: pressing Enter at the end of the document's first heading (the title line) starts a fresh empty bullet on the next line instead of a plain paragraph. Off by default. Ignored in source mode.
+- `blockHandle?: boolean`: shows the per-block gutter handle in the rich modes (a drag grip for reordering blocks and a `+` add button, plus the drop indicator). On by default; set `false` to hide the gutter affordance entirely, e.g. when the host does not want block reordering. Ignored in source mode and when `readOnly` is set.
 - `placeholder?: string | ((state) => string)`: placeholder text shown when the whole document is empty. Pass a stable function. Ignored in source mode.
 - `readOnly?: boolean`: makes the editor read-only, in both the rich and source modes.
 - `spellCheck?: boolean`: toggles the browser's native spell checking in the rich modes. Defaults to the browser's behavior. Ignored in source mode.

package/dist/index.d.ts

@@ -130,6 +130,27 @@ interface EditorProps {
   onImagePaste?: ImageOptions['onImagePaste'];
   /** Called when persisting a pasted/dropped image throws. Ignored in source mode. */
   onImageSaveError?: ImageOptions['onImageSaveError'];
+  /**
+   * Auto-embeds a pasted tweet or YouTube link as a rich embed; one undo turns
+   * the embed back into the raw link. On by default. Ignored in source mode, and
+   * only takes effect when `resolveImageUrl` is set, since embeds render through
+   * the same image pipeline.
+   */
+  embedPaste?: boolean;
+  /**
+   * Pressing Enter at the end of the document's first heading (the title line)
+   * starts a fresh empty bullet on the next line instead of a plain paragraph.
+   * Off by default. Ignored in source mode.
+   */
+  bulletAfterHeading?: boolean;
+  /**
+   * Shows the per-block gutter handle in the rich modes: a drag grip for
+   * reordering blocks and a "+" add button, plus the drop indicator that
+   * visualizes where a dragged block will land. On by default. Set to `false`
+   * to hide the gutter affordance entirely, e.g. when the host does not want
+   * block reordering. Ignored in source mode and when `readOnly` is set.
+   */
+  blockHandle?: boolean;
   /**
    * Placeholder text shown when the whole document is empty. A function
    * receives the editor state. Pass a stable function. Ignored in source mode.
@@ -161,6 +182,9 @@ declare function MeowdownEditor({
   resolveImageUrl,
   onImagePaste,
   onImageSaveError,
+  embedPaste,
+  bulletAfterHeading,
+  blockHandle,
   placeholder,
   readOnly,
   spellCheck,

package/dist/index.js

@@ -7,7 +7,7 @@ import { Compartment, EditorSelection, EditorState } from "@codemirror/state";
 import { EditorView, keymap } from "@codemirror/view";
 import { clamp } from "@ocavue/utils";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { codeBlockLanguages, defineEditorExtension, defineImages, defineMarkMode, definePlaceholder, defineReadonly, defineWikilinkClickHandler, docToMarkdown, markdownToDoc } from "@meowdown/core";
+import { codeBlockLanguages, defineBulletAfterHeading, defineEditorExtension, defineEmbedPaste, defineImages, defineMarkMode, definePlaceholder, defineReadonly, defineWikilinkClickHandler, docToMarkdown, markdownToDoc } from "@meowdown/core";
 import { canUseRegexLookbehind, createEditor, defineDocChangeHandler, union } from "@prosekit/core";
 import { Selection, TextSelection } from "@prosekit/pm/state";
 import { ProseKit, defineReactNodeView, useEditor, useEditor as useEditor$1, useEditorDerivedValue, useExtension } from "@prosekit/react";
@@ -436,7 +436,7 @@ function DropIndicator$1() {
 
 //#endregion
 //#region src/components/editor-extensions.tsx
-function EditorExtensions({ markMode, onDocChange, onWikilinkClick, resolveImageUrl, onImagePaste, onImageSaveError, placeholder, readOnly }) {
+function EditorExtensions({ markMode, onDocChange, onWikilinkClick, resolveImageUrl, onImagePaste, onImageSaveError, embedPaste, bulletAfterHeading, placeholder, readOnly }) {
 	useExtension(useMemo(() => {
 		return defineMarkMode(markMode);
 	}, [markMode]));
@@ -460,6 +460,12 @@ function EditorExtensions({ markMode, onDocChange, onWikilinkClick, resolveImage
 		onImagePaste,
 		onImageSaveError
 	]));
+	useExtension(useMemo(() => {
+		return embedPaste && resolveImageUrl ? defineEmbedPaste() : null;
+	}, [embedPaste, resolveImageUrl]));
+	useExtension(useMemo(() => {
+		return bulletAfterHeading ? defineBulletAfterHeading() : null;
+	}, [bulletAfterHeading]));
 	useExtension(useMemo(() => {
 		return placeholder ? definePlaceholder({
 			placeholder,
@@ -907,10 +913,10 @@ function resolveSelection(doc, selection) {
 		return TextSelection.between(doc.resolve(anchor), doc.resolve(head));
 	}
 }
-function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onTagSearch, onWikilinkSearch, onWikilinkClick, resolveImageUrl, onImagePaste, onImageSaveError, placeholder, readOnly, spellCheck, editorClassName, ref, children }) {
+function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onTagSearch, onWikilinkSearch, onWikilinkClick, resolveImageUrl, onImagePaste, onImageSaveError, embedPaste, bulletAfterHeading, blockHandle = true, placeholder, readOnly, spellCheck, editorClassName, ref, children }) {
 	const [editor] = useState(() => {
 		const editor = createEditor({ extension: union(defineEditorExtension(), defineCodeBlockView()) });
-		if (initialMarkdown) editor.setContent(markdownToDoc(editor, initialMarkdown));
+		if (initialMarkdown) editor.setContent(markdownToDoc(initialMarkdown, editor.nodes));
 		return editor;
 	});
 	const suppressDocChangeRef = useRef(false);
@@ -928,7 +934,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onTa
 			if (markdown == null && !selection) return;
 			const transaction = editor.state.tr;
 			if (markdown != null) {
-				const doc = markdownToDoc(editor, markdown);
+				const doc = markdownToDoc(markdown, editor.nodes);
 				transaction.replaceWith(0, transaction.doc.content.size, doc.content);
 			}
 			if (selection) transaction.setSelection(resolveSelection(transaction.doc, selection)).scrollIntoView();
@@ -985,12 +991,14 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onTa
 				resolveImageUrl,
 				onImagePaste,
 				onImageSaveError,
+				embedPaste,
+				bulletAfterHeading,
 				placeholder,
 				readOnly
 			}),
-			/* @__PURE__ */ jsx(BlockHandle, {}),
+			blockHandle && !readOnly && /* @__PURE__ */ jsx(BlockHandle, {}),
 			!readOnly && /* @__PURE__ */ jsx(TableHandle, {}),
-			/* @__PURE__ */ jsx(DropIndicator$1, {}),
+			blockHandle && !readOnly && /* @__PURE__ */ jsx(DropIndicator$1, {}),
 			/* @__PURE__ */ jsx(SlashMenu, {}),
 			onTagSearch && /* @__PURE__ */ jsx(TagMenu, { onTagSearch }),
 			onWikilinkSearch && /* @__PURE__ */ jsx(WikilinkMenu, { onWikilinkSearch }),
@@ -1001,7 +1009,7 @@ function ProseKitEditor({ markMode = "focus", initialMarkdown, onDocChange, onTa
 
 //#endregion
 //#region src/components/editor.tsx
-function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onTagSearch, onWikilinkSearch, onWikilinkClick, resolveImageUrl, onImagePaste, onImageSaveError, placeholder, readOnly, spellCheck, editorClassName, wrapperClassName, handleRef, children }) {
+function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onTagSearch, onWikilinkSearch, onWikilinkClick, resolveImageUrl, onImagePaste, onImageSaveError, embedPaste = true, bulletAfterHeading = false, blockHandle = true, placeholder, readOnly, spellCheck, editorClassName, wrapperClassName, handleRef, children }) {
 	const childRef = useRef(null);
 	useImperativeHandle(handleRef, () => {
 		function getMarkdown() {
@@ -1069,6 +1077,9 @@ function MeowdownEditor({ mode = "focus", initialMarkdown, onDocChange, onTagSea
 			resolveImageUrl,
 			onImagePaste,
 			onImageSaveError,
+			embedPaste,
+			bulletAfterHeading,
+			blockHandle,
 			placeholder,
 			readOnly,
 			spellCheck,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meowdown/react",
   "type": "module",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -24,11 +24,11 @@
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.43.1",
     "@ocavue/utils": "^1.7.0",
-    "@prosekit/core": "^0.12.3",
+    "@prosekit/core": "^0.13.0-beta.1",
     "@prosekit/pm": "^0.1.18",
-    "@prosekit/react": "^0.8.0-beta.0",
+    "@prosekit/react": "^0.8.0-beta.2",
     "clsx": "^2.1.1",
-    "@meowdown/core": "0.8.1"
+    "@meowdown/core": "0.10.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",