@slash-editor/core 0.0.6 → 0.0.8

package/dist/index.d.mts

@@ -1,7 +1,9 @@
 import { Editor, Extension, Extensions, Mark, Node, Range } from "@tiptap/core";
 import { Node as Node$1, NodeType } from "@tiptap/pm/model";
 import { EditorState, PluginKey } from "@tiptap/pm/state";
+import { DetailsOptions } from "@tiptap/extension-details";
 import { SuggestionProps } from "@tiptap/suggestion";
+import { BlockquoteOptions } from "@tiptap/extension-blockquote";
 import { TableKit, TableKitOptions } from "@tiptap/extension-table";
 import { Doc } from "yjs";
 //#region src/slash-items.d.ts
@@ -22,6 +24,12 @@ interface SlashItem {
   aliases?: string[];
   /** Lower-weight search terms that are never displayed. */
   keywords?: string[];
+  /**
+   * Markdown input-rule shorthand shown as a hint in the menu (`#`, `---`).
+   * Display only — ranking never reads it, and it must mirror a rule the
+   * editor actually registers.
+   */
+  shortcut?: string;
   /** Icon key resolved by the UI layer; the core ships no components. */
   icon?: string;
   /** Hides the item when the current editor cannot run it. */
@@ -913,6 +921,54 @@ declare const Mention: Node<MentionOptions, MentionStorage>;
 /** Configures the mention node. `items` is required — there is no default provider. */
 declare function mention(options: Partial<MentionOptions> & Pick<MentionOptions, "items">): Node<MentionOptions, MentionStorage>;
 //#endregion
+//#region src/placeholder.d.ts
+/**
+ * Slot a placeholder string is looked up under. Slots are resolved from the
+ * empty node *and its parent*: the empty node inside a list item, a task item,
+ * a quote or a callout is a plain `paragraph`, so node type alone cannot tell
+ * those cases apart.
+ */
+type PlaceholderKey = "paragraph" | "heading1" | "heading2" | "heading3" | "listItem" | "taskItem" | "blockquote" | "callout" | "details" | "toggleHeading1" | "toggleHeading2" | "toggleHeading3";
+interface PlaceholderContext {
+  editor: Editor;
+  /** The empty block holding the caret. */
+  node: Node$1;
+  /** Its parent, which distinguishes a bare paragraph from a list/quote child. */
+  parent: Node$1 | null;
+  /** Position directly before `node`. */
+  pos: number;
+}
+interface PlaceholderOptions {
+  /** Per-slot overrides; unset slots keep the default string. */
+  text?: Partial<Record<PlaceholderKey, string>>;
+  /**
+   * Full override. Wins over `text`; returning `null` suppresses the
+   * placeholder for that block.
+   */
+  resolve?: (context: PlaceholderContext) => string | null;
+}
+declare const defaultPlaceholderText: Record<PlaceholderKey, string>;
+/**
+ * Maps an empty block to its placeholder slot, or `null` when it should stay
+ * blank. Code blocks are excluded: their content is literal, and a hint would
+ * read as source.
+ */
+declare function placeholderKeyFor(node: Node$1, parent: Node$1 | null): PlaceholderKey | null;
+declare const placeholderPluginKey: PluginKey<any>;
+/**
+ * Empty-block hints, Notion style: only the block holding the caret shows one.
+ *
+ * Renders `data-placeholder` and no class names — the UI layer styles
+ * `[data-placeholder]::before`, matching how every other core node is styled.
+ *
+ * The decoration is derived from the state it is drawn against rather than
+ * from `editor.state`: during a transaction those are different documents, and
+ * resolving a parent in the stale one mislabels every nested block.
+ */
+declare const Placeholder: Extension<PlaceholderOptions, any>;
+/** Configures empty-block placeholders. */
+declare function placeholder(options?: PlaceholderOptions): Extension<PlaceholderOptions, any>;
+//#endregion
 //#region src/slash-command.d.ts
 interface SlashMenuState {
   open: boolean;
@@ -947,6 +1003,12 @@ interface SlashCommandOptions {
   char: string;
   /** Item registry, or a resolver called with the live editor. */
   items: SlashItem[] | ((editor: Editor) => SlashItem[]);
+  /**
+   * Inline hint rendered next to the trigger character while the query is
+   * still empty, the way Notion prompts after `/`. Set to `""` to drop it.
+   * The UI layer renders it from `data-decoration-content`.
+   */
+  hint: string;
   /**
    * Called when an item's `run` throws. The failing transaction is never
    * applied, so the document keeps the state it had before the item ran.
@@ -976,6 +1038,40 @@ declare function slashCommand(options?: Partial<SlashCommandOptions>): Extension
  */
 declare function table(options?: Partial<TableKitOptions>): import("@tiptap/core").Extension<TableKitOptions, any>;
 //#endregion
+//#region src/toggle.d.ts
+type ToggleOptions = DetailsOptions;
+/** Heading level a toggle renders its title at; `0` is a plain toggle list. */
+type ToggleLevel = 0 | 1 | 2 | 3;
+declare module "@tiptap/core" {
+  interface Commands<ReturnType> {
+    toggle: {
+      /**
+       * Turns the current block into a toggle whose title is that block's
+       * text, or re-levels the toggle already holding the selection.
+       */
+      setToggle: (level?: ToggleLevel) => ReturnType;
+      /** Sets the heading level of the toggle holding the selection. */
+      setToggleLevel: (level: ToggleLevel) => ReturnType;
+    };
+  }
+}
+/** `>` + space: the toggle shorthand. */
+declare const toggleInputRegex: RegExp;
+/** `#`…`###` + space inside a toggle title: the toggle-heading shorthand. */
+declare const toggleHeadingInputRegex: RegExp;
+/**
+ * Tiptap's `Details` with a `level` attribute, the `>` shorthand, and the
+ * toggle-heading shorthands.
+ *
+ * `level` lives on the container rather than the title because the node view
+ * renders the disclosure button as a *sibling* of the summary: with
+ * `data-level` on the wrapper, one selector sizes both, and the marker stays
+ * centred on a title of any size.
+ */
+declare const Toggle: import("@tiptap/core").Node<DetailsOptions, any>;
+/** Configures the toggle (details) node. */
+declare function toggle(options?: Partial<ToggleOptions>): import("@tiptap/core").Node<DetailsOptions, any>;
+//#endregion
 //#region src/video.d.ts
 interface VideoOptions {
   HTMLAttributes: Record<string, unknown>;
@@ -1045,6 +1141,13 @@ interface BlockKitOptions {
    * @default { char: "/", items: defaultSlashItems }
    */
   slash?: Partial<SlashCommandOptions> | false;
+  /**
+   * Empty-block placeholder hints, or `false` to render none. Only the block
+   * holding the caret shows one.
+   *
+   * @default {}
+   */
+  placeholder?: PlaceholderOptions | false;
   /**
    * Stable per-block id configuration, or `false` to opt out. Drag
    * targeting and the future comment/collaboration surfaces depend on it.
@@ -1145,6 +1248,14 @@ interface BlockKitOptions {
    * @default {}
    */
   comment?: Partial<CommentOptions> | false;
+  /**
+   * Toggle (details) node configuration. Options only — the node itself is
+   * unconditional, like blockquote. This is the seam a UI layer uses to
+   * render its own disclosure marker via `renderToggleButton`.
+   *
+   * @default { persist: true }
+   */
+  toggle?: Partial<ToggleOptions>;
 }
 /**
  * The baseline block schema: document, text, paragraph, headings, lists,
@@ -1188,4 +1299,20 @@ declare const Callout: Node<CalloutOptions, any>;
 /** Configures the callout node. */
 declare function callout(options?: Partial<CalloutOptions>): Node<CalloutOptions, any>;
 //#endregion
-export { type AiActionStatus, AiBlock, type AiBlockOptions, type AiBlockStorage, type AiKitOptions, type AiRequest, type AiSlashAction, BLOCK_ID_REMOTE_META, BlockDrag, type BlockDragOptions, type BlockDragState, type BlockDragStorage, BlockId, type BlockIdOptions, type BlockKitOptions, type BlockLocation, type BlockRect, type BlockTarget, BubbleToolbar, type BubbleToolbarItem, type BubbleToolbarOptions, type BubbleToolbarState, type BubbleToolbarStorage, Callout, type CalloutOptions, type CollaborationOptions, type CollaborationProvider, type CollaborationUser, Column, type ColumnOptions, Columns, type ColumnsOptions, Comment, type CommentMessage, type CommentOptions, type CommentState, type CommentStorage, type CommentThread, type CommentThreadStore, type DropMode, type DropTarget, Embed, type EmbedMode, type EmbedOptions, File$1 as File, type FileOptions, type FileStorage, type HeadingLevel, Image, type ImageOptions, type ImageStorage, LinkEditor, type LinkEditorOptions, type LinkEditorState, type LinkEditorStorage, Mention, type MentionItem, type MentionOptions, type MentionState, type MentionStorage, PendingAiRegistry, PendingUploadRegistry, type RetryUploadOptions, type RunAiActionOptions, type RunUploadOptions, type SetEmbedOptions, type SetFileFromFile, type SetFileFromSrc, type SetFileOptions, type SetImageFromFile, type SetImageFromSrc, type SetImageOptions, type SetVideoFromFile, type SetVideoFromSrc, type SetVideoOptions, SlashCommand, type SlashCommandOptions, type SlashCommandStorage, type SlashContext, type SlashItem, type SlashMenuState, type StreamAdapter, type StreamContext, TableKit, type TableKitOptions, type UploadAdapter, type UploadContext, type UploadResult, type UploadStatus, Video, type VideoOptions, type VideoStorage, activeThreadIds, aiBlock, blockDrag, blockDragPluginKey, blockId, blockIdPluginKey, bubbleToolbar, callout, canAppendChild, canOpenLinkEditor, collaboration, column, columns, comment, createAiSlashItems, createBlockKit, defaultAiSlashActions, defaultBubbleToolbarItems, defaultSlashItems, embed, file, filterBubbleToolbarItems, filterSlashItems, findNodeById, image, linkEditor, mention, mentionPluginKey, resolveDropTarget, retryUpload, runUpload, slashCommand, slashCommandPluginKey, table, video };
+//#region src/quote.d.ts
+type QuoteOptions = BlockquoteOptions;
+/** `"` + space at the start of a block, Notion style. */
+declare const quoteInputRegex: RegExp;
+/**
+ * Blockquote with its markdown shorthand moved from `>` to `"`. The node name
+ * stays `blockquote`: only the input rule changes, so stored documents,
+ * clipboard HTML, and `Mod+Shift+B` are untouched.
+ *
+ * `>` belongs to the toggle (see `toggle.ts`), which is what Notion users
+ * reach for it expecting.
+ */
+declare const Quote: import("@tiptap/core").Node<BlockquoteOptions, any>;
+/** Configures the quote (blockquote) node. */
+declare function quote(options?: Partial<QuoteOptions>): import("@tiptap/core").Node<BlockquoteOptions, any>;
+//#endregion
+export { type AiActionStatus, AiBlock, type AiBlockOptions, type AiBlockStorage, type AiKitOptions, type AiRequest, type AiSlashAction, BLOCK_ID_REMOTE_META, BlockDrag, type BlockDragOptions, type BlockDragState, type BlockDragStorage, BlockId, type BlockIdOptions, type BlockKitOptions, type BlockLocation, type BlockRect, type BlockTarget, BubbleToolbar, type BubbleToolbarItem, type BubbleToolbarOptions, type BubbleToolbarState, type BubbleToolbarStorage, Callout, type CalloutOptions, type CollaborationOptions, type CollaborationProvider, type CollaborationUser, Column, type ColumnOptions, Columns, type ColumnsOptions, Comment, type CommentMessage, type CommentOptions, type CommentState, type CommentStorage, type CommentThread, type CommentThreadStore, type DropMode, type DropTarget, Embed, type EmbedMode, type EmbedOptions, File$1 as File, type FileOptions, type FileStorage, type HeadingLevel, Image, type ImageOptions, type ImageStorage, LinkEditor, type LinkEditorOptions, type LinkEditorState, type LinkEditorStorage, Mention, type MentionItem, type MentionOptions, type MentionState, type MentionStorage, PendingAiRegistry, PendingUploadRegistry, Placeholder, type PlaceholderContext, type PlaceholderKey, type PlaceholderOptions, Quote, type QuoteOptions, type RetryUploadOptions, type RunAiActionOptions, type RunUploadOptions, type SetEmbedOptions, type SetFileFromFile, type SetFileFromSrc, type SetFileOptions, type SetImageFromFile, type SetImageFromSrc, type SetImageOptions, type SetVideoFromFile, type SetVideoFromSrc, type SetVideoOptions, SlashCommand, type SlashCommandOptions, type SlashCommandStorage, type SlashContext, type SlashItem, type SlashMenuState, type StreamAdapter, type StreamContext, TableKit, type TableKitOptions, Toggle, type ToggleLevel, type ToggleOptions, type UploadAdapter, type UploadContext, type UploadResult, type UploadStatus, Video, type VideoOptions, type VideoStorage, activeThreadIds, aiBlock, blockDrag, blockDragPluginKey, blockId, blockIdPluginKey, bubbleToolbar, callout, canAppendChild, canOpenLinkEditor, collaboration, column, columns, comment, createAiSlashItems, createBlockKit, defaultAiSlashActions, defaultBubbleToolbarItems, defaultPlaceholderText, defaultSlashItems, embed, file, filterBubbleToolbarItems, filterSlashItems, findNodeById, image, linkEditor, mention, mentionPluginKey, placeholder, placeholderKeyFor, placeholderPluginKey, quote, quoteInputRegex, resolveDropTarget, retryUpload, runUpload, slashCommand, slashCommandPluginKey, table, toggle, toggleHeadingInputRegex, toggleInputRegex, video };

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { Extension, Mark, Node, callOrReturn, combineTransactionSteps, findChildrenInRange, getChangedRanges, getExtensionField, isTextSelection, mergeAttributes, posToDOMRect } from "@tiptap/core";
+import { Extension, InputRule, Mark, Node, callOrReturn, combineTransactionSteps, findChildrenInRange, findParentNode, getChangedRanges, getExtensionField, isTextSelection, mergeAttributes, posToDOMRect, wrappingInputRule } from "@tiptap/core";
 import { Fragment } from "@tiptap/pm/model";
-import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 import { StarterKit } from "@tiptap/starter-kit";
 import { Details, DetailsContent, DetailsSummary } from "@tiptap/extension-details";
@@ -8,6 +8,7 @@ import { TaskItem, TaskList } from "@tiptap/extension-list";
 import { Collaboration } from "@tiptap/extension-collaboration";
 import { CollaborationCaret } from "@tiptap/extension-collaboration-caret";
 import { Suggestion } from "@tiptap/suggestion";
+import { Blockquote } from "@tiptap/extension-blockquote";
 import { TableKit } from "@tiptap/extension-table";
 //#region src/upload.ts
 /**
@@ -293,28 +294,28 @@ const defaultAiSlashActions = [
 		id: "continue-writing",
 		title: "Continue writing",
 		description: "AI extends the text above the cursor",
-		icon: "sparkles",
+		icon: "pencil-sparkles",
 		prompt: "Continue writing the document naturally, matching its tone and style. Write only the continuation, with no preamble."
 	},
 	{
 		id: "summarize",
 		title: "Summarize",
 		description: "AI summarizes the text above the cursor",
-		icon: "sparkles",
+		icon: "broom-sparkles",
 		prompt: "Summarize the following text in a few concise sentences."
 	},
 	{
 		id: "brainstorm-ideas",
 		title: "Brainstorm ideas",
 		description: "AI lists ideas related to the text above the cursor",
-		icon: "sparkles",
+		icon: "brain",
 		prompt: "Brainstorm a short bullet list of ideas related to the following text."
 	},
 	{
 		id: "fix-spelling-grammar",
 		title: "Fix spelling & grammar",
 		description: "AI rewrites the text above the cursor, correcting mistakes",
-		icon: "sparkles",
+		icon: "spell-check",
 		prompt: "Rewrite the following text, correcting spelling and grammar mistakes only, and preserve its meaning and tone."
 	}
 ];
@@ -1904,6 +1905,120 @@ function mention(options) {
 	return Mention.configure(options);
 }
 //#endregion
+//#region src/placeholder.ts
+const defaultPlaceholderText = {
+	paragraph: "Press '/' for commands…",
+	heading1: "Heading 1",
+	heading2: "Heading 2",
+	heading3: "Heading 3",
+	listItem: "List",
+	taskItem: "To-do",
+	blockquote: "Quote",
+	callout: "Callout",
+	details: "Toggle",
+	toggleHeading1: "Toggle heading 1",
+	toggleHeading2: "Toggle heading 2",
+	toggleHeading3: "Toggle heading 3"
+};
+const PARENT_KEYS = {
+	listItem: "listItem",
+	taskItem: "taskItem",
+	blockquote: "blockquote",
+	callout: "callout",
+	detailsContent: "details"
+};
+/**
+* Maps an empty block to its placeholder slot, or `null` when it should stay
+* blank. Code blocks are excluded: their content is literal, and a hint would
+* read as source.
+*/
+function placeholderKeyFor(node, parent) {
+	const name = node.type.name;
+	if (name === "heading") {
+		const { level } = node.attrs;
+		return level === 1 || level === 2 || level === 3 ? `heading${level}` : null;
+	}
+	if (name === "detailsSummary") {
+		const level = parent?.attrs.level;
+		return level === 1 || level === 2 || level === 3 ? `toggleHeading${level}` : "details";
+	}
+	if (name !== "paragraph") return null;
+	return parent ? PARENT_KEYS[parent.type.name] ?? "paragraph" : "paragraph";
+}
+const placeholderPluginKey = new PluginKey("placeholder");
+/**
+* Empty-block hints, Notion style: only the block holding the caret shows one.
+*
+* Renders `data-placeholder` and no class names — the UI layer styles
+* `[data-placeholder]::before`, matching how every other core node is styled.
+*
+* The decoration is derived from the state it is drawn against rather than
+* from `editor.state`: during a transaction those are different documents, and
+* resolving a parent in the stale one mislabels every nested block.
+*/
+const Placeholder = Extension.create({
+	name: "placeholder",
+	addOptions() {
+		return {};
+	},
+	addProseMirrorPlugins() {
+		const { editor } = this;
+		const text = {
+			...defaultPlaceholderText,
+			...this.options.text
+		};
+		const { resolve } = this.options;
+		return [new Plugin({
+			key: placeholderPluginKey,
+			props: { decorations: (state) => {
+				if (!editor.isEditable) return null;
+				const { doc, selection } = state;
+				const $anchor = doc.resolve(selection.anchor);
+				const node = $anchor.parent;
+				if (!node.type.isTextblock || node.content.size > 0) return null;
+				const parent = $anchor.depth > 0 ? $anchor.node($anchor.depth - 1) : null;
+				const pos = $anchor.before($anchor.depth);
+				const context = {
+					editor,
+					node,
+					parent,
+					pos
+				};
+				const key = placeholderKeyFor(node, parent);
+				const value = resolve ? resolve(context) : key && text[key];
+				if (!value) return null;
+				return DecorationSet.create(doc, [Decoration.node(pos, pos + node.nodeSize, { "data-placeholder": value })]);
+			} }
+		})];
+	}
+});
+/** Configures empty-block placeholders. */
+function placeholder(options = {}) {
+	return Placeholder.configure(options);
+}
+//#endregion
+//#region src/quote.ts
+/** `"` + space at the start of a block, Notion style. */
+const quoteInputRegex = /^\s*"\s$/;
+/**
+* Blockquote with its markdown shorthand moved from `>` to `"`. The node name
+* stays `blockquote`: only the input rule changes, so stored documents,
+* clipboard HTML, and `Mod+Shift+B` are untouched.
+*
+* `>` belongs to the toggle (see `toggle.ts`), which is what Notion users
+* reach for it expecting.
+*/
+const Quote = Blockquote.extend({ addInputRules() {
+	return [wrappingInputRule({
+		find: quoteInputRegex,
+		type: this.type
+	})];
+} });
+/** Configures the quote (blockquote) node. */
+function quote(options = {}) {
+	return Quote.configure(options);
+}
+//#endregion
 //#region src/slash-items.ts
 const TITLE_PREFIX = 100;
 const TITLE_WORD_PREFIX = 80;
@@ -1933,6 +2048,7 @@ function filterSlashItems(items, query, editor) {
 	})).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score).map((entry) => entry.item);
 }
 const BASIC = "Basic blocks";
+const ADVANCED = "Advanced blocks";
 const MEDIA = "Media";
 const STRUCTURE = "Structure";
 function hasNode(editor, name) {
@@ -1959,6 +2075,7 @@ const defaultSlashItems = [
 		description: "Large section title",
 		aliases: ["h1", "title"],
 		keywords: ["#"],
+		shortcut: "#",
 		icon: "heading-1",
 		when: (editor) => hasNode(editor, "heading"),
 		run: ({ editor, range }) => {
@@ -1972,6 +2089,7 @@ const defaultSlashItems = [
 		description: "Medium section title",
 		aliases: ["h2", "subtitle"],
 		keywords: ["##"],
+		shortcut: "##",
 		icon: "heading-2",
 		when: (editor) => hasNode(editor, "heading"),
 		run: ({ editor, range }) => {
@@ -1985,6 +2103,7 @@ const defaultSlashItems = [
 		description: "Small section title",
 		aliases: ["h3"],
 		keywords: ["###"],
+		shortcut: "###",
 		icon: "heading-3",
 		when: (editor) => hasNode(editor, "heading"),
 		run: ({ editor, range }) => {
@@ -1998,6 +2117,7 @@ const defaultSlashItems = [
 		description: "Unordered list",
 		aliases: ["ul", "bullet"],
 		keywords: ["-", "*"],
+		shortcut: "-",
 		icon: "list",
 		when: (editor) => hasNode(editor, "bulletList"),
 		run: ({ editor, range }) => {
@@ -2011,6 +2131,7 @@ const defaultSlashItems = [
 		description: "Ordered list",
 		aliases: ["ol", "numbered"],
 		keywords: ["1."],
+		shortcut: "1.",
 		icon: "list-ordered",
 		when: (editor) => hasNode(editor, "orderedList"),
 		run: ({ editor, range }) => {
@@ -2028,6 +2149,7 @@ const defaultSlashItems = [
 			"checkbox"
 		],
 		keywords: ["[]", "[ ]"],
+		shortcut: "[]",
 		icon: "list-checks",
 		when: (editor) => hasNode(editor, "taskList"),
 		run: ({ editor, range }) => {
@@ -2040,7 +2162,8 @@ const defaultSlashItems = [
 		group: BASIC,
 		description: "Capture a quotation",
 		aliases: ["quote", "citation"],
-		keywords: [">"],
+		keywords: ["\""],
+		shortcut: "\"",
 		icon: "quote",
 		when: (editor) => hasNode(editor, "blockquote"),
 		run: ({ editor, range }) => {
@@ -2075,6 +2198,7 @@ const defaultSlashItems = [
 			"dropdown"
 		],
 		keywords: ["toggle"],
+		shortcut: ">",
 		icon: "chevron-right",
 		when: (editor) => hasNode(editor, "details"),
 		run: ({ editor, range }) => {
@@ -2088,6 +2212,7 @@ const defaultSlashItems = [
 		description: "Monospaced code",
 		aliases: ["code", "snippet"],
 		keywords: ["```"],
+		shortcut: "```",
 		icon: "code",
 		when: (editor) => hasNode(editor, "codeBlock"),
 		run: ({ editor, range }) => {
@@ -2105,12 +2230,55 @@ const defaultSlashItems = [
 			"rule"
 		],
 		keywords: ["---"],
+		shortcut: "---",
 		icon: "minus",
 		when: (editor) => hasNode(editor, "horizontalRule"),
 		run: ({ editor, range }) => {
 			editor.chain().focus().deleteRange(range).setHorizontalRule().run();
 		}
 	},
+	{
+		id: "toggle-heading-1",
+		title: "Toggle heading 1",
+		group: ADVANCED,
+		description: "Collapsible large title",
+		aliases: ["th1", "toggleheading1"],
+		keywords: ["collapsible", "details"],
+		shortcut: "# >",
+		icon: "heading-1",
+		when: (editor) => hasNode(editor, "details"),
+		run: ({ editor, range }) => {
+			editor.chain().focus().deleteRange(range).setToggle(1).run();
+		}
+	},
+	{
+		id: "toggle-heading-2",
+		title: "Toggle heading 2",
+		group: ADVANCED,
+		description: "Collapsible medium title",
+		aliases: ["th2", "toggleheading2"],
+		keywords: ["collapsible", "details"],
+		shortcut: "## >",
+		icon: "heading-2",
+		when: (editor) => hasNode(editor, "details"),
+		run: ({ editor, range }) => {
+			editor.chain().focus().deleteRange(range).setToggle(2).run();
+		}
+	},
+	{
+		id: "toggle-heading-3",
+		title: "Toggle heading 3",
+		group: ADVANCED,
+		description: "Collapsible small title",
+		aliases: ["th3", "toggleheading3"],
+		keywords: ["collapsible", "details"],
+		shortcut: "### >",
+		icon: "heading-3",
+		when: (editor) => hasNode(editor, "details"),
+		run: ({ editor, range }) => {
+			editor.chain().focus().deleteRange(range).setToggle(3).run();
+		}
+	},
 	{
 		id: "image",
 		title: "Image",
@@ -2222,6 +2390,7 @@ const SlashCommand = Extension.create({
 	addOptions() {
 		return {
 			char: "/",
+			hint: "Type to search",
 			items: defaultSlashItems
 		};
 	},
@@ -2283,6 +2452,7 @@ const SlashCommand = Extension.create({
 		return [Suggestion({
 			editor,
 			char: this.options.char,
+			decorationContent: this.options.hint,
 			pluginKey: slashCommandPluginKey,
 			allowSpaces: false,
 			allow: ({ state, range }) => !state.doc.resolve(range.from).parent.type.spec.code,
@@ -2348,6 +2518,182 @@ function table(options = {}) {
 	});
 }
 //#endregion
+//#region src/toggle.ts
+/** `>` + space: the toggle shorthand. */
+const toggleInputRegex = /^>\s$/;
+/** `#`…`###` + space inside a toggle title: the toggle-heading shorthand. */
+const toggleHeadingInputRegex = /^(#{1,3})\s$/;
+function asToggleLevel(value) {
+	return value === 1 || value === 2 || value === 3 ? value : 0;
+}
+function canReplaceBlockWithToggle($pos, detailsType) {
+	if ($pos.depth === 0 || !$pos.parent.isTextblock) return false;
+	const index = $pos.index($pos.depth - 1);
+	return $pos.node($pos.depth - 1).canReplaceWith(index, index + 1, detailsType);
+}
+/**
+* Replaces the textblock holding `pos` with a toggle: that block's inline
+* content becomes the title, the body starts as one empty paragraph, and the
+* caret lands at the end of the title.
+*
+* Titles are `text*`, so inline nodes a summary cannot hold (a mention chip)
+* degrade to their text rather than failing the whole conversion.
+*/
+function replaceBlockWithToggle(tr, pos, level) {
+	const $pos = tr.doc.resolve(pos);
+	const { schema } = $pos.parent.type;
+	const detailsType = schema.nodes.details;
+	const summaryType = schema.nodes.detailsSummary;
+	const contentType = schema.nodes.detailsContent;
+	const paragraphType = schema.nodes.paragraph;
+	if (!detailsType || !summaryType || !contentType || !paragraphType) return false;
+	if (!canReplaceBlockWithToggle($pos, detailsType)) return false;
+	const inline = $pos.parent.content;
+	const text = inline.textBetween(0, inline.size);
+	const title = summaryType.contentMatch.matchFragment(inline)?.validEnd ? inline : text ? Fragment.from(schema.text(text)) : Fragment.empty;
+	const summary = summaryType.create(null, title);
+	const body = contentType.create(null, paragraphType.create());
+	const from = $pos.before($pos.depth);
+	tr.replaceWith(from, $pos.after($pos.depth), detailsType.create({ level }, [summary, body]));
+	tr.setSelection(TextSelection.create(tr.doc, from + 2 + summary.content.size));
+	return true;
+}
+/**
+* Tiptap's `Details` with a `level` attribute, the `>` shorthand, and the
+* toggle-heading shorthands.
+*
+* `level` lives on the container rather than the title because the node view
+* renders the disclosure button as a *sibling* of the summary: with
+* `data-level` on the wrapper, one selector sizes both, and the marker stays
+* centred on a title of any size.
+*/
+const Toggle = Details.extend({
+	addAttributes() {
+		return {
+			...this.parent?.(),
+			level: {
+				default: 0,
+				parseHTML: (element) => asToggleLevel(Number(element.getAttribute("data-level"))),
+				renderHTML: ({ level }) => level ? { "data-level": String(level) } : {}
+			}
+		};
+	},
+	renderHTML({ HTMLAttributes }) {
+		return [
+			"details",
+			mergeAttributes(this.options.HTMLAttributes, HTMLAttributes),
+			0
+		];
+	},
+	addNodeView() {
+		const parent = this.parent?.();
+		if (!parent) return null;
+		return (props) => {
+			const view = parent(props);
+			const dom = view.dom;
+			const applyLevel = (node) => {
+				const level = asToggleLevel(node.attrs.level);
+				if (level) dom.setAttribute("data-level", String(level));
+				else dom.removeAttribute("data-level");
+			};
+			applyLevel(props.node);
+			if (this.options.persist) dom.addEventListener("click", (event) => {
+				const { editor, getPos } = props;
+				const target = event.target;
+				if (!editor.isEditable || target?.closest("button")?.parentElement !== dom) return;
+				event.stopPropagation();
+				const pos = getPos();
+				const node = typeof pos === "number" ? editor.state.doc.nodeAt(pos) : null;
+				if (!node || node.type !== this.type) return;
+				const { from, to } = editor.state.selection;
+				editor.chain().command(({ tr }) => {
+					tr.setNodeMarkup(pos, void 0, {
+						...node.attrs,
+						open: !node.attrs.open
+					});
+					return true;
+				}).setTextSelection({
+					from,
+					to
+				}).focus(void 0, { scrollIntoView: false }).run();
+			}, true);
+			return {
+				...view,
+				update: (node, decorations, innerDecorations) => {
+					const updated = view.update?.(node, decorations, innerDecorations) ?? true;
+					if (updated) applyLevel(node);
+					return updated;
+				}
+			};
+		};
+	},
+	addCommands() {
+		return {
+			...this.parent?.(),
+			setToggle: (level = 0) => ({ state, tr, dispatch }) => {
+				const detailsType = state.schema.nodes.details;
+				if (!detailsType) return false;
+				const details = findParentNode((node) => node.type === detailsType)(state.selection);
+				if (details) {
+					if (dispatch) tr.setNodeMarkup(details.pos, void 0, {
+						...details.node.attrs,
+						level
+					});
+					return true;
+				}
+				if (!canReplaceBlockWithToggle(state.selection.$from, detailsType)) return false;
+				return dispatch ? replaceBlockWithToggle(tr, state.selection.from, level) : true;
+			},
+			setToggleLevel: (level) => ({ state, tr, dispatch }) => {
+				const detailsType = state.schema.nodes.details;
+				const details = detailsType ? findParentNode((node) => node.type === detailsType)(state.selection) : void 0;
+				if (!details) return false;
+				if (dispatch) tr.setNodeMarkup(details.pos, void 0, {
+					...details.node.attrs,
+					level
+				});
+				return true;
+			}
+		};
+	},
+	addInputRules() {
+		return [
+			...this.parent?.() ?? [],
+			new InputRule({
+				find: toggleInputRegex,
+				handler: ({ state, range }) => {
+					const { tr } = state;
+					const block = tr.doc.resolve(range.from).parent;
+					const name = block.type.name;
+					if (name !== "paragraph" && name !== "heading") return null;
+					const level = name === "heading" ? asToggleLevel(block.attrs.level) : 0;
+					tr.delete(range.from, range.to);
+					return replaceBlockWithToggle(tr, range.from, level) ? void 0 : null;
+				}
+			}),
+			new InputRule({
+				find: toggleHeadingInputRegex,
+				handler: ({ state, range, match }) => {
+					const { tr } = state;
+					const $from = tr.doc.resolve(range.from);
+					if ($from.parent.type.name !== "detailsSummary") return null;
+					const details = $from.node($from.depth - 1);
+					const level = asToggleLevel(match[1]?.length);
+					tr.delete(range.from, range.to);
+					tr.setNodeMarkup($from.before($from.depth - 1), void 0, {
+						...details.attrs,
+						level
+					});
+				}
+			})
+		];
+	}
+});
+/** Configures the toggle (details) node. */
+function toggle(options = {}) {
+	return Toggle.configure(options);
+}
+//#endregion
 //#region src/video.ts
 function initialAttrs(id, options) {
 	if (options && "file" in options) return {
@@ -2467,7 +2813,7 @@ const DEFAULT_HEADING_LEVELS = [
 * the `data-*` attributes rendered by slash-editor nodes.
 */
 function createBlockKit(options = {}) {
-	const { headingLevels = DEFAULT_HEADING_LEVELS, history = true, slash, blockId: blockIdOptions, drag, bubbleToolbar: bubbleToolbarOptions, image: imageOptions, file: fileOptions, video: videoOptions, embed: embedOptions, table: tableOptions, columns: columnsOptions, linkEditor: linkEditorOptions, mention: mentionOptions, ai: aiOptions, collaboration: collaborationOptions, comment: commentOptions, extend = [] } = options;
+	const { headingLevels = DEFAULT_HEADING_LEVELS, history = true, slash, placeholder: placeholderOptions, blockId: blockIdOptions, drag, bubbleToolbar: bubbleToolbarOptions, image: imageOptions, file: fileOptions, video: videoOptions, embed: embedOptions, table: tableOptions, columns: columnsOptions, linkEditor: linkEditorOptions, mention: mentionOptions, ai: aiOptions, collaboration: collaborationOptions, comment: commentOptions, toggle: toggleOptions, extend = [] } = options;
 	const resolvedAi = aiOptions ? {
 		actions: defaultAiSlashActions,
 		node: true,
@@ -2481,12 +2827,17 @@ function createBlockKit(options = {}) {
 			link: {
 				openOnClick: false,
 				enableClickSelection: true
-			}
+			},
+			blockquote: false
 		}),
+		quote(),
 		TaskList,
 		TaskItem.configure({ nested: true }),
 		Callout,
-		Details.configure({ persist: true }),
+		toggle({
+			persist: true,
+			...toggleOptions
+		}),
 		DetailsSummary,
 		DetailsContent,
 		...imageOptions === false ? [] : [image(imageOptions)],
@@ -2501,6 +2852,7 @@ function createBlockKit(options = {}) {
 			...slash,
 			items: slash?.items ?? (() => [...defaultSlashItems, ...resolvedAi ? createAiSlashItems(resolvedAi) : []])()
 		})],
+		...placeholderOptions === false ? [] : [placeholder(placeholderOptions)],
 		...blockIdOptions === false ? [] : [blockId(blockIdOptions)],
 		...drag === false ? [] : [blockDrag(drag)],
 		...bubbleToolbarOptions === false ? [] : [bubbleToolbar(bubbleToolbarOptions)],
@@ -2511,4 +2863,4 @@ function createBlockKit(options = {}) {
 	];
 }
 //#endregion
-export { AiBlock, BLOCK_ID_REMOTE_META, BlockDrag, BlockId, BubbleToolbar, Callout, Column, Columns, Comment, Embed, File, Image, LinkEditor, Mention, PendingAiRegistry, PendingUploadRegistry, SlashCommand, TableKit, Video, activeThreadIds, aiBlock, blockDrag, blockDragPluginKey, blockId, blockIdPluginKey, bubbleToolbar, callout, canAppendChild, canOpenLinkEditor, collaboration, column, columns, comment, createAiSlashItems, createBlockKit, defaultAiSlashActions, defaultBubbleToolbarItems, defaultSlashItems, embed, file, filterBubbleToolbarItems, filterSlashItems, findNodeById, image, linkEditor, mention, mentionPluginKey, resolveDropTarget, retryUpload, runUpload, slashCommand, slashCommandPluginKey, table, video };
+export { AiBlock, BLOCK_ID_REMOTE_META, BlockDrag, BlockId, BubbleToolbar, Callout, Column, Columns, Comment, Embed, File, Image, LinkEditor, Mention, PendingAiRegistry, PendingUploadRegistry, Placeholder, Quote, SlashCommand, TableKit, Toggle, Video, activeThreadIds, aiBlock, blockDrag, blockDragPluginKey, blockId, blockIdPluginKey, bubbleToolbar, callout, canAppendChild, canOpenLinkEditor, collaboration, column, columns, comment, createAiSlashItems, createBlockKit, defaultAiSlashActions, defaultBubbleToolbarItems, defaultPlaceholderText, defaultSlashItems, embed, file, filterBubbleToolbarItems, filterSlashItems, findNodeById, image, linkEditor, mention, mentionPluginKey, placeholder, placeholderKeyFor, placeholderPluginKey, quote, quoteInputRegex, resolveDropTarget, retryUpload, runUpload, slashCommand, slashCommandPluginKey, table, toggle, toggleHeadingInputRegex, toggleInputRegex, video };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slash-editor/core",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Headless block-editor core: ProseMirror/Tiptap extensions, schema, commands.",
   "license": "MIT",
   "repository": {
@@ -24,6 +24,7 @@
     "dev": "vp pack --watch"
   },
   "dependencies": {
+    "@tiptap/extension-blockquote": "^3.31.3",
     "@tiptap/extension-collaboration": "^3.31.3",
     "@tiptap/extension-collaboration-caret": "^3.31.3",
     "@tiptap/extension-details": "^3.31.3",