@ecsplico/editor 2.1.2 → 3.1.0

package/dist/react/AdvancedEditor.js

@@ -1,21 +1,23 @@
-import { EditorSurface } from "./EditorSurface.js";
-import { advancedEditor } from "./advanced-preset.js";
-import { forwardRef, useState } from "react";
+import { ComposedSurface } from "./composed-surface.js";
+import { forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/react/AdvancedEditor.tsx
 /**
-* The advanced editor on the React surface: `advancedEditor()` mounted through `EditorSurface`. The feature list is
-* fixed at mount like the kinds it is built from; hosts remount (`key`) to change either. Place `EditorToolbar`
-* (with the same `preset`: build it with `advancedEditor()` and pass it to both) and, with `settingsUi: 'external'`,
-* `EditorSettingsModal`/`EditorSettingsPanel` beside it; `useEditorUi(editor)` reaches the chrome of a ready editor.
-* Collaboration is active only when a `collaboration` session is passed; mount `Toaster` once for notices.
+* The advanced editor on the React surface: `composeEditor({ content: 'rich', interaction: 'full', ai: true })` mounted
+* through `EditorSurface`; every dimension is overridable by its prop, and the backend (default: the editor context's)
+* prunes what it cannot serve. The ref's `preset` is the composed preset (`omitted` lists the dropped features). The
+* composition is fixed at mount like the kinds it is built from; hosts remount (`key`) to change it. Place
+* `EditorToolbar` and, with `settingsUi: 'external'`, `EditorSettingsModal`/`EditorSettingsPanel` beside it and give
+* them the editor from `onReady`; `useEditorUi(editor)` reaches the chrome of a ready editor. Collaboration is active
+* only when a `collaboration` session is passed; mount `Toaster` once for notices.
 */
-const AdvancedEditor = forwardRef(function AdvancedEditor({ compositeKinds, ...surface }, ref) {
-	const [preset] = useState(() => advancedEditor(compositeKinds ? { compositeKinds } : {}));
-	return /* @__PURE__ */ jsx(EditorSurface, {
+const AdvancedEditor = forwardRef(function AdvancedEditor({ content = "rich", interaction = "full", ai = true, ...rest }, ref) {
+	return /* @__PURE__ */ jsx(ComposedSurface, {
 		ref,
-		preset,
-		...surface
+		content,
+		interaction,
+		ai,
+		...rest
 	});
 });
 //#endregion

package/dist/react/AdvancedEditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedEditor.js","names":[],"sources":["../../src/react/AdvancedEditor.tsx"],"sourcesContent":["import { forwardRef, useState } from 'react'\nimport type { CompositeKind } from '../features/composites/kinds'\nimport { advancedEditor } from './advanced-preset'\nimport { EditorSurface, type EditorSurfaceHandle, type EditorSurfaceProps } from './EditorSurface'\n\n/**\n * Props of the advanced editor: the surface's own (collaboration session or standalone `value`/`onChange`, metadata,\n * abilities, extensions, block actions, slash commands, `documentId`/`upload`, `editable`, `settingsUi`, the open\n * state of the sidebar and comments margin, `onReady` and the other callbacks) except the preset, which the advanced\n * editor owns, plus the composite kinds.\n */\nexport interface AdvancedEditorProps extends Omit<EditorSurfaceProps, 'preset'> {\n  /** Composite kinds („Bausteine“) offered in the editor (default: `defaultCompositeKinds(t)`); read once at mount. */\n  compositeKinds?: readonly CompositeKind[]\n}\n\n/**\n * The advanced editor on the React surface: `advancedEditor()` mounted through `EditorSurface`. The feature list is\n * fixed at mount like the kinds it is built from; hosts remount (`key`) to change either. Place `EditorToolbar`\n * (with the same `preset`: build it with `advancedEditor()` and pass it to both) and, with `settingsUi: 'external'`,\n * `EditorSettingsModal`/`EditorSettingsPanel` beside it; `useEditorUi(editor)` reaches the chrome of a ready editor.\n * Collaboration is active only when a `collaboration` session is passed; mount `Toaster` once for notices.\n */\nexport const AdvancedEditor = forwardRef<EditorSurfaceHandle, AdvancedEditorProps>(function AdvancedEditor({ compositeKinds, ...surface }, ref) {\n  const [preset] = useState(() => advancedEditor(compositeKinds ? { compositeKinds } : {}))\n  return <EditorSurface ref={ref} preset={preset} {...surface} />\n})\n"],"mappings":";;;;;;;;;;;;AAuBA,MAAa,iBAAiB,WAAqD,SAAS,eAAe,EAAE,gBAAgB,GAAG,WAAW,KAAK;CAC9I,MAAM,CAAC,UAAU,eAAe,eAAe,iBAAiB,EAAE,eAAe,IAAI,CAAC,CAAC,CAAC;CACxF,OAAO,oBAAC,eAAD;EAAoB;EAAa;EAAQ,GAAI;CAAU,CAAA;AAChE,CAAC"}
+{"version":3,"file":"AdvancedEditor.js","names":[],"sources":["../../src/react/AdvancedEditor.tsx"],"sourcesContent":["import { forwardRef } from 'react'\nimport { ComposedSurface, type ComposedEditorHandle, type ComposedEditorProps } from './composed-surface'\n\nexport type { ComposedEditorHandle as AdvancedEditorHandle }\n\n/**\n * Props of the advanced editor: the surface's own (collaboration session or standalone `value`/`onChange`, metadata,\n * abilities, extensions, block actions, commands, `documentId`, `editable`, `settingsUi`, the open state of the sidebar\n * and comments margin, `onReady` and the other callbacks) except the preset, plus the composition: `content`,\n * `interaction`, `ai`, `add`, `remove`, `backend` and the composite kinds. The defaults are the advanced editor's:\n * `content: 'rich'`, `interaction: 'full'`, `ai: true`.\n */\nexport type AdvancedEditorProps = ComposedEditorProps\n\n/**\n * The advanced editor on the React surface: `composeEditor({ content: 'rich', interaction: 'full', ai: true })` mounted\n * through `EditorSurface`; every dimension is overridable by its prop, and the backend (default: the editor context's)\n * prunes what it cannot serve. The ref's `preset` is the composed preset (`omitted` lists the dropped features). The\n * composition is fixed at mount like the kinds it is built from; hosts remount (`key`) to change it. Place\n * `EditorToolbar` and, with `settingsUi: 'external'`, `EditorSettingsModal`/`EditorSettingsPanel` beside it and give\n * them the editor from `onReady`; `useEditorUi(editor)` reaches the chrome of a ready editor. Collaboration is active\n * only when a `collaboration` session is passed; mount `Toaster` once for notices.\n */\nexport const AdvancedEditor = forwardRef<ComposedEditorHandle, AdvancedEditorProps>(function AdvancedEditor({ content = 'rich', interaction = 'full', ai = true, ...rest }, ref) {\n  return <ComposedSurface ref={ref} content={content} interaction={interaction} ai={ai} {...rest} />\n})\n"],"mappings":";;;;;;;;;;;;;AAuBA,MAAa,iBAAiB,WAAsD,SAAS,eAAe,EAAE,UAAU,QAAQ,cAAc,QAAQ,KAAK,MAAM,GAAG,QAAQ,KAAK;CAC/K,OAAO,oBAAC,iBAAD;EAAsB;EAAc;EAAsB;EAAiB;EAAI,GAAI;CAAO,CAAA;AACnG,CAAC"}

package/dist/react/EditorCommandPalette.d.ts

@@ -0,0 +1,13 @@
+import { Editor } from "@tiptap/core";
+//#region src/react/EditorCommandPalette.d.ts
+/**
+ * „Befehle“ (⌘K): the commands of the surface's editor (features' and host's, `palette !== false`) in a command dialog,
+ * grouped like the toolbar, disabled where `commandState` disables them; a menu command opens its rows as a second
+ * level (Backspace in the empty search goes back). Mounted by `core-ui` as an overlay of the surface; the surface's
+ * `ui.paletteOpen` is its open state.
+ */
+export declare function EditorCommandPalette({ editor }: {
+  editor: Editor;
+}): import("react").JSX.Element;
+//#endregion
+//# sourceMappingURL=EditorCommandPalette.d.ts.map

package/dist/react/EditorCommandPalette.js

@@ -0,0 +1,118 @@
+import { editorEntryOf } from "../core/editor-ui.js";
+import { filterPalette, paletteGroupsOf } from "../core/palette.js";
+import { useEditorI18n } from "./use-editor-i18n.js";
+import { Icon } from "./Icon.js";
+import { useEditorUi } from "./editor-ui.js";
+import { Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandShortcut } from "./ui/command.js";
+import { shortcutLabel } from "./key-labels.js";
+import { useEffect, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/react/EditorCommandPalette.tsx
+function Row({ entry, onPick }) {
+	return /* @__PURE__ */ jsxs(CommandItem, {
+		value: entry.id,
+		disabled: entry.disabled,
+		onSelect: () => onPick(entry),
+		children: [
+			entry.icon && /* @__PURE__ */ jsx(Icon, { name: entry.icon }),
+			/* @__PURE__ */ jsxs("span", {
+				className: "flex min-w-0 flex-col",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "truncate",
+					children: entry.label
+				}), entry.description && /* @__PURE__ */ jsx("span", {
+					className: "truncate text-xs text-muted-foreground",
+					children: entry.description
+				})]
+			}),
+			entry.children ? /* @__PURE__ */ jsx(Icon, {
+				name: "i-lucide-chevron-right",
+				className: "ml-auto"
+			}) : entry.kbds && entry.kbds.length > 0 && /* @__PURE__ */ jsx(CommandShortcut, { children: shortcutLabel(entry.kbds) })
+		]
+	});
+}
+/**
+* „Befehle“ (⌘K): the commands of the surface's editor (features' and host's, `palette !== false`) in a command dialog,
+* grouped like the toolbar, disabled where `commandState` disables them; a menu command opens its rows as a second
+* level (Backspace in the empty search goes back). Mounted by `core-ui` as an overlay of the surface; the surface's
+* `ui.paletteOpen` is its open state.
+*/
+function EditorCommandPalette({ editor }) {
+	const ui = useEditorUi();
+	const { t } = useEditorI18n();
+	const open = ui?.paletteOpen ?? false;
+	const [query, setQuery] = useState("");
+	const [parent, setParent] = useState(null);
+	useEffect(() => {
+		if (!open) {
+			setQuery("");
+			setParent(null);
+		}
+	}, [open]);
+	const groups = useMemo(() => {
+		const entry = open ? editorEntryOf(editor) : void 0;
+		return entry ? paletteGroupsOf(editor, entry) : [];
+	}, [open, editor]);
+	const shown = useMemo(() => filterPalette(parent ? [{
+		id: parent.id,
+		label: parent.label,
+		entries: parent.children ?? []
+	}] : groups, query), [
+		groups,
+		parent,
+		query
+	]);
+	function pick(entry) {
+		if (entry.children) {
+			setParent(entry);
+			setQuery("");
+			return;
+		}
+		if (ui?.paletteOpen) ui.togglePalette();
+		entry.run?.();
+	}
+	return /* @__PURE__ */ jsx(CommandDialog, {
+		open,
+		onOpenChange: (next) => {
+			if (next !== open) ui?.togglePalette();
+		},
+		title: t("palette.title"),
+		description: t("palette.description"),
+		children: /* @__PURE__ */ jsxs(Command, {
+			shouldFilter: false,
+			onKeyDown: (event) => {
+				if (event.key === "Backspace" && !query && parent) {
+					event.preventDefault();
+					setParent(null);
+				}
+			},
+			children: [/* @__PURE__ */ jsx(CommandInput, {
+				value: query,
+				onValueChange: setQuery,
+				placeholder: parent ? parent.label : t("palette.placeholder")
+			}), /* @__PURE__ */ jsxs(CommandList, { children: [
+				/* @__PURE__ */ jsx(CommandEmpty, { children: t("palette.empty") }),
+				parent && /* @__PURE__ */ jsx(CommandGroup, { children: /* @__PURE__ */ jsxs(CommandItem, {
+					value: "palette:back",
+					onSelect: () => {
+						setParent(null);
+						setQuery("");
+					},
+					children: [/* @__PURE__ */ jsx(Icon, { name: "i-lucide-arrow-left" }), t("palette.back")]
+				}) }),
+				shown.map((group) => /* @__PURE__ */ jsx(CommandGroup, {
+					heading: group.label,
+					children: group.entries.map((entry) => /* @__PURE__ */ jsx(Row, {
+						entry,
+						onPick: pick
+					}, entry.id))
+				}, group.id))
+			] })]
+		})
+	});
+}
+//#endregion
+export { EditorCommandPalette };
+
+//# sourceMappingURL=EditorCommandPalette.js.map

package/dist/react/EditorCommandPalette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditorCommandPalette.js","names":[],"sources":["../../src/react/EditorCommandPalette.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { useEffect, useMemo, useState } from 'react'\nimport { editorEntryOf } from '../core/editor-ui'\nimport { filterPalette, type PaletteEntry, type PaletteGroup, paletteGroupsOf } from '../core/palette'\nimport { Icon } from './Icon'\nimport { Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandShortcut } from './ui/command'\nimport { useEditorUi } from './editor-ui'\nimport { shortcutLabel } from './key-labels'\nimport { useEditorI18n } from './use-editor-i18n'\n\nfunction Row({ entry, onPick }: { entry: PaletteEntry, onPick: (entry: PaletteEntry) => void }) {\n  return (\n    <CommandItem value={entry.id} disabled={entry.disabled} onSelect={() => onPick(entry)}>\n      {entry.icon && <Icon name={entry.icon} />}\n      <span className=\"flex min-w-0 flex-col\">\n        <span className=\"truncate\">{entry.label}</span>\n        {entry.description && <span className=\"truncate text-xs text-muted-foreground\">{entry.description}</span>}\n      </span>\n      {entry.children\n        ? <Icon name=\"i-lucide-chevron-right\" className=\"ml-auto\" />\n        : entry.kbds && entry.kbds.length > 0 && <CommandShortcut>{shortcutLabel(entry.kbds)}</CommandShortcut>}\n    </CommandItem>\n  )\n}\n\n/**\n * „Befehle“ (⌘K): the commands of the surface's editor (features' and host's, `palette !== false`) in a command dialog,\n * grouped like the toolbar, disabled where `commandState` disables them; a menu command opens its rows as a second\n * level (Backspace in the empty search goes back). Mounted by `core-ui` as an overlay of the surface; the surface's\n * `ui.paletteOpen` is its open state.\n */\nexport function EditorCommandPalette({ editor }: { editor: Editor }) {\n  const ui = useEditorUi()\n  const { t } = useEditorI18n()\n  const open = ui?.paletteOpen ?? false\n  const [query, setQuery] = useState('')\n  const [parent, setParent] = useState<PaletteEntry | null>(null)\n\n  useEffect(() => {\n    if (!open) {\n      setQuery('')\n      setParent(null)\n    }\n  }, [open])\n\n  // The state of every command is read when the palette opens, not while it is closed.\n  const groups = useMemo<PaletteGroup[]>(() => {\n    const entry = open ? editorEntryOf(editor) : undefined\n    return entry ? paletteGroupsOf(editor, entry) : []\n  }, [open, editor])\n\n  const shown = useMemo(\n    () => filterPalette(parent ? [{ id: parent.id, label: parent.label, entries: parent.children ?? [] }] : groups, query),\n    [groups, parent, query],\n  )\n\n  function pick(entry: PaletteEntry) {\n    if (entry.children) {\n      setParent(entry)\n      setQuery('')\n      return\n    }\n    if (ui?.paletteOpen) ui.togglePalette()\n    entry.run?.()\n  }\n\n  return (\n    <CommandDialog\n      open={open}\n      onOpenChange={(next) => {\n        if (next !== open) ui?.togglePalette()\n      }}\n      title={t('palette.title')}\n      description={t('palette.description')}\n    >\n      <Command\n        shouldFilter={false}\n        onKeyDown={(event) => {\n          if (event.key === 'Backspace' && !query && parent) {\n            event.preventDefault()\n            setParent(null)\n          }\n        }}\n      >\n        <CommandInput value={query} onValueChange={setQuery} placeholder={parent ? parent.label : t('palette.placeholder')} />\n        <CommandList>\n          <CommandEmpty>{t('palette.empty')}</CommandEmpty>\n          {parent && (\n            <CommandGroup>\n              <CommandItem value=\"palette:back\" onSelect={() => { setParent(null); setQuery('') }}>\n                <Icon name=\"i-lucide-arrow-left\" />\n                {t('palette.back')}\n              </CommandItem>\n            </CommandGroup>\n          )}\n          {shown.map(group => (\n            <CommandGroup key={group.id} heading={group.label}>\n              {group.entries.map(entry => <Row key={entry.id} entry={entry} onPick={pick} />)}\n            </CommandGroup>\n          ))}\n        </CommandList>\n      </Command>\n    </CommandDialog>\n  )\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAS,IAAI,EAAE,OAAO,UAA0E;CAC9F,OACE,qBAAC,aAAD;EAAa,OAAO,MAAM;EAAI,UAAU,MAAM;EAAU,gBAAgB,OAAO,KAAK;EAApF,UAAA;GACG,MAAM,QAAQ,oBAAC,MAAD,EAAM,MAAM,MAAM,KAAO,CAAA;GACxC,qBAAC,QAAD;IAAM,WAAU;IAAhB,UAAA,CACE,oBAAC,QAAD;KAAM,WAAU;KAAY,UAAA,MAAM;IAAY,CAAA,GAC7C,MAAM,eAAe,oBAAC,QAAD;KAAM,WAAU;KAA0C,UAAA,MAAM;IAAkB,CAAA,CACpG;;GACL,MAAM,WACH,oBAAC,MAAD;IAAM,MAAK;IAAyB,WAAU;GAAW,CAAA,IACzD,MAAM,QAAQ,MAAM,KAAK,SAAS,KAAK,oBAAC,iBAAD,EAAA,UAAkB,cAAc,MAAM,IAAI,EAAmB,CAAA;EAC7F;;AAEjB;;;;;;;AAQA,SAAgB,qBAAqB,EAAE,UAA8B;CACnE,MAAM,KAAK,YAAY;CACvB,MAAM,EAAE,MAAM,cAAc;CAC5B,MAAM,OAAO,IAAI,eAAe;CAChC,MAAM,CAAC,OAAO,YAAY,SAAS,EAAE;CACrC,MAAM,CAAC,QAAQ,aAAa,SAA8B,IAAI;CAE9D,gBAAgB;EACd,IAAI,CAAC,MAAM;GACT,SAAS,EAAE;GACX,UAAU,IAAI;EAChB;CACF,GAAG,CAAC,IAAI,CAAC;CAGT,MAAM,SAAS,cAA8B;EAC3C,MAAM,QAAQ,OAAO,cAAc,MAAM,IAAI,KAAA;EAC7C,OAAO,QAAQ,gBAAgB,QAAQ,KAAK,IAAI,CAAC;CACnD,GAAG,CAAC,MAAM,MAAM,CAAC;CAEjB,MAAM,QAAQ,cACN,cAAc,SAAS,CAAC;EAAE,IAAI,OAAO;EAAI,OAAO,OAAO;EAAO,SAAS,OAAO,YAAY,CAAC;CAAE,CAAC,IAAI,QAAQ,KAAK,GACrH;EAAC;EAAQ;EAAQ;CAAK,CACxB;CAEA,SAAS,KAAK,OAAqB;EACjC,IAAI,MAAM,UAAU;GAClB,UAAU,KAAK;GACf,SAAS,EAAE;GACX;EACF;EACA,IAAI,IAAI,aAAa,GAAG,cAAc;EACtC,MAAM,MAAM;CACd;CAEA,OACE,oBAAC,eAAD;EACQ;EACN,eAAe,SAAS;GACtB,IAAI,SAAS,MAAM,IAAI,cAAc;EACvC;EACA,OAAO,EAAE,eAAe;EACxB,aAAa,EAAE,qBAAqB;EAEpC,UAAA,qBAAC,SAAD;GACE,cAAc;GACd,YAAY,UAAU;IACpB,IAAI,MAAM,QAAQ,eAAe,CAAC,SAAS,QAAQ;KACjD,MAAM,eAAe;KACrB,UAAU,IAAI;IAChB;GACF;GAPF,UAAA,CASE,oBAAC,cAAD;IAAc,OAAO;IAAO,eAAe;IAAU,aAAa,SAAS,OAAO,QAAQ,EAAE,qBAAqB;GAAI,CAAA,GACrH,qBAAC,aAAD,EAAA,UAAA;IACE,oBAAC,cAAD,EAAA,UAAe,EAAE,eAAe,EAAgB,CAAA;IAC/C,UACC,oBAAC,cAAD,EAAA,UACE,qBAAC,aAAD;KAAa,OAAM;KAAe,gBAAgB;MAAE,UAAU,IAAI;MAAG,SAAS,EAAE;KAAE;KAAlF,UAAA,CACE,oBAAC,MAAD,EAAM,MAAK,sBAAuB,CAAA,GACjC,EAAE,cAAc,CACN;IACD,CAAA,EAAA,CAAA;IAEf,MAAM,KAAI,UACT,oBAAC,cAAD;KAA6B,SAAS,MAAM;KACzC,UAAA,MAAM,QAAQ,KAAI,UAAS,oBAAC,KAAD;MAA2B;MAAO,QAAQ;KAAO,GAAvC,MAAM,EAAiC,CAAC;IAClE,GAFK,MAAM,EAEX,CACf;GACU,EAAA,CAAA,CACN;;CACI,CAAA;AAEnB"}

package/dist/react/EditorSettingsModal.d.ts

@@ -1,9 +1,9 @@
-import { ReactPreset } from "./EditorSurface.js";
+import { Editor } from "@tiptap/core";
 //#region src/react/EditorSettingsModal.d.ts
-/** „Einstellungen“: `EditorSettingsPanel` in a modal. Renders nothing when the preset contributes no settings tab. */
-export declare function EditorSettingsModal({ preset, open, onOpenChange, tab, onTabChange }: {
-  /** The preset whose features contribute the tabs (the surface's `preset`). */
-  preset: ReactPreset;
+/** „Einstellungen“: `EditorSettingsPanel` in a modal. Renders nothing without an editor or when its preset contributes no settings tab. */
+export declare function EditorSettingsModal({ editor, open, onOpenChange, tab, onTabChange }: {
+  /** The editor whose preset (registered by its surface, from its `onReady`) contributes the tabs. */
+  editor?: Editor;
   open: boolean;
   onOpenChange: (open: boolean) => void;
   /** Shown tab id (see `EditorSettingsPanel`). */

package/dist/react/EditorSettingsModal.js

@@ -1,4 +1,5 @@
 import { settingsTabsOf } from "../core/define-editor.js";
+import { editorEntryOf } from "../core/editor-ui.js";
 import { useEditorContext } from "./context.js";
 import { useEditorI18n } from "./use-editor-i18n.js";
 import { EditorSettingsPanel } from "./EditorSettingsPanel.js";
@@ -7,11 +8,13 @@ import { Button } from "./ui/button.js";
 import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from "./ui/dialog.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/EditorSettingsModal.tsx
-/** „Einstellungen“: `EditorSettingsPanel` in a modal. Renders nothing when the preset contributes no settings tab. */
-function EditorSettingsModal({ preset, open, onOpenChange, tab, onTabChange }) {
+/** „Einstellungen“: `EditorSettingsPanel` in a modal. Renders nothing without an editor or when its preset contributes no settings tab. */
+function EditorSettingsModal({ editor, open, onOpenChange, tab, onTabChange }) {
 	const { synced } = useEditorSettings();
 	const { t } = useEditorI18n();
-	if (!settingsTabsOf(preset, useEditorContext()).length) return null;
+	const app = useEditorContext();
+	const preset = editorEntryOf(editor?.isDestroyed ? void 0 : editor)?.preset;
+	if (!preset || !settingsTabsOf(preset, app).length) return null;
 	return /* @__PURE__ */ jsx(Dialog, {
 		open,
 		onOpenChange,
@@ -20,7 +23,7 @@ function EditorSettingsModal({ preset, open, onOpenChange, tab, onTabChange }) {
 			children: [
 				/* @__PURE__ */ jsxs(DialogHeader, { children: [/* @__PURE__ */ jsx(DialogTitle, { children: t("settings.title") }), /* @__PURE__ */ jsx(DialogDescription, { children: t(synced ? "settings.scope.account" : "settings.scope.browser") })] }),
 				/* @__PURE__ */ jsx(EditorSettingsPanel, {
-					preset,
+					...editor && { editor },
 					...tab !== void 0 && { tab },
 					...onTabChange && { onTabChange },
 					contentClassName: "h-[32rem] overflow-y-auto pt-4 pr-2"

package/dist/react/EditorSettingsModal.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditorSettingsModal.js","names":[],"sources":["../../src/react/EditorSettingsModal.tsx"],"sourcesContent":["import { settingsTabsOf } from '../core/define-editor'\nimport { EditorSettingsPanel } from './EditorSettingsPanel'\nimport type { ReactPreset } from './EditorSurface'\nimport { useEditorContext } from './context'\nimport { useEditorSettings } from './settings'\nimport { useEditorI18n } from './use-editor-i18n'\nimport { Button } from './ui/button'\nimport { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from './ui/dialog'\n\n/** „Einstellungen“: `EditorSettingsPanel` in a modal. Renders nothing when the preset contributes no settings tab. */\nexport function EditorSettingsModal({ preset, open, onOpenChange, tab, onTabChange }: {\n  /** The preset whose features contribute the tabs (the surface's `preset`). */\n  preset: ReactPreset\n  open: boolean\n  onOpenChange: (open: boolean) => void\n  /** Shown tab id (see `EditorSettingsPanel`). */\n  tab?: string\n  onTabChange?: (tab: string) => void\n}) {\n  const { synced } = useEditorSettings()\n  const { t } = useEditorI18n()\n  if (!settingsTabsOf(preset, useEditorContext()).length) return null\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent className=\"sm:w-[42rem] sm:max-w-[42rem]\">\n        <DialogHeader>\n          <DialogTitle>{t('settings.title')}</DialogTitle>\n          <DialogDescription>{t(synced ? 'settings.scope.account' : 'settings.scope.browser')}</DialogDescription>\n        </DialogHeader>\n        <EditorSettingsPanel\n          preset={preset}\n          {...(tab !== undefined && { tab })}\n          {...(onTabChange && { onTabChange })}\n          contentClassName=\"h-[32rem] overflow-y-auto pt-4 pr-2\"\n        />\n        <DialogFooter>\n          <Button variant=\"ghost\" onClick={() => onOpenChange(false)}>{t('common.close')}</Button>\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,oBAAoB,EAAE,QAAQ,MAAM,cAAc,KAAK,eAQpE;CACD,MAAM,EAAE,WAAW,kBAAkB;CACrC,MAAM,EAAE,MAAM,cAAc;CAC5B,IAAI,CAAC,eAAe,QAAQ,iBAAiB,CAAC,CAAC,CAAC,QAAQ,OAAO;CAC/D,OACE,oBAAC,QAAD;EAAc;EAAoB;EAChC,UAAA,qBAAC,eAAD;GAAe,WAAU;GAAzB,UAAA;IACE,qBAAC,cAAD,EAAA,UAAA,CACE,oBAAC,aAAD,EAAA,UAAc,EAAE,gBAAgB,EAAe,CAAA,GAC/C,oBAAC,mBAAD,EAAA,UAAoB,EAAE,SAAS,2BAA2B,wBAAwB,EAAqB,CAAA,CAC3F,EAAA,CAAA;IACd,oBAAC,qBAAD;KACU;KACR,GAAK,QAAQ,KAAA,KAAa,EAAE,IAAI;KAChC,GAAK,eAAe,EAAE,YAAY;KAClC,kBAAiB;IAClB,CAAA;IACD,oBAAC,cAAD,EAAA,UACE,oBAAC,QAAD;KAAQ,SAAQ;KAAQ,eAAe,aAAa,KAAK;KAAI,UAAA,EAAE,cAAc;IAAU,CAAA,EAC3E,CAAA;GACD;;CACT,CAAA;AAEZ"}
+{"version":3,"file":"EditorSettingsModal.js","names":[],"sources":["../../src/react/EditorSettingsModal.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { settingsTabsOf } from '../core/define-editor'\nimport { editorEntryOf } from '../core/editor-ui'\nimport { EditorSettingsPanel } from './EditorSettingsPanel'\nimport { useEditorContext } from './context'\nimport { useEditorSettings } from './settings'\nimport { useEditorI18n } from './use-editor-i18n'\nimport { Button } from './ui/button'\nimport { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from './ui/dialog'\n\n/** „Einstellungen“: `EditorSettingsPanel` in a modal. Renders nothing without an editor or when its preset contributes no settings tab. */\nexport function EditorSettingsModal({ editor, open, onOpenChange, tab, onTabChange }: {\n  /** The editor whose preset (registered by its surface, from its `onReady`) contributes the tabs. */\n  editor?: Editor\n  open: boolean\n  onOpenChange: (open: boolean) => void\n  /** Shown tab id (see `EditorSettingsPanel`). */\n  tab?: string\n  onTabChange?: (tab: string) => void\n}) {\n  const { synced } = useEditorSettings()\n  const { t } = useEditorI18n()\n  const app = useEditorContext()\n  const preset = editorEntryOf(editor?.isDestroyed ? undefined : editor)?.preset\n  if (!preset || !settingsTabsOf(preset, app).length) return null\n  return (\n    <Dialog open={open} onOpenChange={onOpenChange}>\n      <DialogContent className=\"sm:w-[42rem] sm:max-w-[42rem]\">\n        <DialogHeader>\n          <DialogTitle>{t('settings.title')}</DialogTitle>\n          <DialogDescription>{t(synced ? 'settings.scope.account' : 'settings.scope.browser')}</DialogDescription>\n        </DialogHeader>\n        <EditorSettingsPanel\n          {...(editor && { editor })}\n          {...(tab !== undefined && { tab })}\n          {...(onTabChange && { onTabChange })}\n          contentClassName=\"h-[32rem] overflow-y-auto pt-4 pr-2\"\n        />\n        <DialogFooter>\n          <Button variant=\"ghost\" onClick={() => onOpenChange(false)}>{t('common.close')}</Button>\n        </DialogFooter>\n      </DialogContent>\n    </Dialog>\n  )\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,oBAAoB,EAAE,QAAQ,MAAM,cAAc,KAAK,eAQpE;CACD,MAAM,EAAE,WAAW,kBAAkB;CACrC,MAAM,EAAE,MAAM,cAAc;CAC5B,MAAM,MAAM,iBAAiB;CAC7B,MAAM,SAAS,cAAc,QAAQ,cAAc,KAAA,IAAY,MAAM,CAAC,EAAE;CACxE,IAAI,CAAC,UAAU,CAAC,eAAe,QAAQ,GAAG,CAAC,CAAC,QAAQ,OAAO;CAC3D,OACE,oBAAC,QAAD;EAAc;EAAoB;EAChC,UAAA,qBAAC,eAAD;GAAe,WAAU;GAAzB,UAAA;IACE,qBAAC,cAAD,EAAA,UAAA,CACE,oBAAC,aAAD,EAAA,UAAc,EAAE,gBAAgB,EAAe,CAAA,GAC/C,oBAAC,mBAAD,EAAA,UAAoB,EAAE,SAAS,2BAA2B,wBAAwB,EAAqB,CAAA,CAC3F,EAAA,CAAA;IACd,oBAAC,qBAAD;KACE,GAAK,UAAU,EAAE,OAAO;KACxB,GAAK,QAAQ,KAAA,KAAa,EAAE,IAAI;KAChC,GAAK,eAAe,EAAE,YAAY;KAClC,kBAAiB;IAClB,CAAA;IACD,oBAAC,cAAD,EAAA,UACE,oBAAC,QAAD;KAAQ,SAAQ;KAAQ,eAAe,aAAa,KAAK;KAAI,UAAA,EAAE,cAAc;IAAU,CAAA,EAC3E,CAAA;GACD;;CACT,CAAA;AAEZ"}

package/dist/react/EditorSettingsPanel.d.ts

@@ -1,13 +1,13 @@
-import { ReactPreset } from "./EditorSurface.js";
+import { Editor } from "@tiptap/core";
 //#region src/react/EditorSettingsPanel.d.ts
 /**
- * The settings of an editor: one tab per settings tab the preset's features contribute. Place it anywhere; it renders
- * nothing when the preset contributes no tab. The values live in the app's shared settings (`useEditorSettings`), so
- * panels of several editors edit the same preferences.
+ * The settings of an editor: one tab per settings tab the features of its preset contribute. Place it anywhere; it
+ * renders nothing without an editor or when the preset contributes no tab. The values live in the app's shared settings
+ * (`useEditorSettings`), so panels of several editors edit the same preferences.
  */
-export declare function EditorSettingsPanel({ preset, tab, onTabChange, contentClassName }: {
-  /** The preset whose features contribute the tabs (the surface's `preset`). */
-  preset: ReactPreset;
+export declare function EditorSettingsPanel({ editor, tab, onTabChange, contentClassName }: {
+  /** The editor whose preset (registered by its surface, from its `onReady`) contributes the tabs. */
+  editor?: Editor;
   /** Shown tab id; a missing or removed id shows the first contributed tab. */
   tab?: string;
   onTabChange?: (tab: string) => void;

package/dist/react/EditorSettingsPanel.js

@@ -1,16 +1,19 @@
 import { settingsTabsOf } from "../core/define-editor.js";
+import { editorEntryOf } from "../core/editor-ui.js";
 import { useEditorContext } from "./context.js";
 import { Icon } from "./Icon.js";
 import { Tabs, TabsList, TabsTrigger } from "./ui/tabs.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/EditorSettingsPanel.tsx
 /**
-* The settings of an editor: one tab per settings tab the preset's features contribute. Place it anywhere; it renders
-* nothing when the preset contributes no tab. The values live in the app's shared settings (`useEditorSettings`), so
-* panels of several editors edit the same preferences.
+* The settings of an editor: one tab per settings tab the features of its preset contribute. Place it anywhere; it
+* renders nothing without an editor or when the preset contributes no tab. The values live in the app's shared settings
+* (`useEditorSettings`), so panels of several editors edit the same preferences.
 */
-function EditorSettingsPanel({ preset, tab, onTabChange, contentClassName = "pt-4" }) {
-	const tabs = settingsTabsOf(preset, useEditorContext());
+function EditorSettingsPanel({ editor, tab, onTabChange, contentClassName = "pt-4" }) {
+	const app = useEditorContext();
+	const preset = editorEntryOf(editor?.isDestroyed ? void 0 : editor)?.preset;
+	const tabs = preset ? settingsTabsOf(preset, app) : [];
 	const active = tabs.find((candidate) => candidate.id === tab) ?? tabs[0];
 	if (!active) return null;
 	const Active = active.component;

package/dist/react/EditorSettingsPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditorSettingsPanel.js","names":[],"sources":["../../src/react/EditorSettingsPanel.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { settingsTabsOf } from '../core/define-editor'\nimport type { ReactPreset } from './EditorSurface'\nimport { useEditorContext } from './context'\nimport { Icon } from './Icon'\nimport { Tabs, TabsList, TabsTrigger } from './ui/tabs'\n\n/**\n * The settings of an editor: one tab per settings tab the preset's features contribute. Place it anywhere; it renders\n * nothing when the preset contributes no tab. The values live in the app's shared settings (`useEditorSettings`), so\n * panels of several editors edit the same preferences.\n */\nexport function EditorSettingsPanel({ preset, tab, onTabChange, contentClassName = 'pt-4' }: {\n  /** The preset whose features contribute the tabs (the surface's `preset`). */\n  preset: ReactPreset\n  /** Shown tab id; a missing or removed id shows the first contributed tab. */\n  tab?: string\n  onTabChange?: (tab: string) => void\n  /** Classes of the tab content area, e.g. a fixed height with scrolling. */\n  contentClassName?: string\n}) {\n  const tabs = settingsTabsOf(preset, useEditorContext())\n  const active = tabs.find(candidate => candidate.id === tab) ?? tabs[0]\n  if (!active) return null\n  // The preset's component type is the toolbar/overlay one; a settings tab receives only its `props`.\n  const Active = active.component as ComponentType<Record<string, unknown>>\n  return (\n    <div className=\"flex w-full flex-col\">\n      <Tabs value={active.id} onValueChange={value => onTabChange?.(value)} className=\"w-full\">\n        <TabsList variant=\"line\">\n          {tabs.map(({ id, label, icon }) => (\n            <TabsTrigger key={id} value={id}>\n              {icon && <Icon name={icon} />}\n              {label}\n            </TabsTrigger>\n          ))}\n        </TabsList>\n      </Tabs>\n      <div className={contentClassName} data-settings-panel-content>\n        <Active key={active.id} {...active.props} />\n      </div>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,oBAAoB,EAAE,QAAQ,KAAK,aAAa,mBAAmB,UAQhF;CACD,MAAM,OAAO,eAAe,QAAQ,iBAAiB,CAAC;CACtD,MAAM,SAAS,KAAK,MAAK,cAAa,UAAU,OAAO,GAAG,KAAK,KAAK;CACpE,IAAI,CAAC,QAAQ,OAAO;CAEpB,MAAM,SAAS,OAAO;CACtB,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACE,oBAAC,MAAD;GAAM,OAAO,OAAO;GAAI,gBAAe,UAAS,cAAc,KAAK;GAAG,WAAU;GAC9E,UAAA,oBAAC,UAAD;IAAU,SAAQ;IACf,UAAA,KAAK,KAAK,EAAE,IAAI,OAAO,WACtB,qBAAC,aAAD;KAAsB,OAAO;KAA7B,UAAA,CACG,QAAQ,oBAAC,MAAD,EAAM,MAAM,KAAO,CAAA,GAC3B,KACU;IAHK,GAAA,EAGL,CACd;GACO,CAAA;EACN,CAAA,GACN,oBAAC,OAAD;GAAK,WAAW;GAAkB,+BAAA;GAChC,UAAA,oBAAC,QAAD,EAAwB,GAAI,OAAO,MAAQ,GAA9B,OAAO,EAAuB;EACxC,CAAA,CACF;;AAET"}
+{"version":3,"file":"EditorSettingsPanel.js","names":[],"sources":["../../src/react/EditorSettingsPanel.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { ComponentType } from 'react'\nimport { settingsTabsOf } from '../core/define-editor'\nimport { editorEntryOf } from '../core/editor-ui'\nimport { useEditorContext } from './context'\nimport { Icon } from './Icon'\nimport { Tabs, TabsList, TabsTrigger } from './ui/tabs'\n\n/**\n * The settings of an editor: one tab per settings tab the features of its preset contribute. Place it anywhere; it\n * renders nothing without an editor or when the preset contributes no tab. The values live in the app's shared settings\n * (`useEditorSettings`), so panels of several editors edit the same preferences.\n */\nexport function EditorSettingsPanel({ editor, tab, onTabChange, contentClassName = 'pt-4' }: {\n  /** The editor whose preset (registered by its surface, from its `onReady`) contributes the tabs. */\n  editor?: Editor\n  /** Shown tab id; a missing or removed id shows the first contributed tab. */\n  tab?: string\n  onTabChange?: (tab: string) => void\n  /** Classes of the tab content area, e.g. a fixed height with scrolling. */\n  contentClassName?: string\n}) {\n  const app = useEditorContext()\n  const preset = editorEntryOf(editor?.isDestroyed ? undefined : editor)?.preset\n  const tabs = preset ? settingsTabsOf(preset, app) : []\n  const active = tabs.find(candidate => candidate.id === tab) ?? tabs[0]\n  if (!active) return null\n  // The preset's component type is the toolbar/overlay one; a settings tab receives only its `props`.\n  const Active = active.component as ComponentType<Record<string, unknown>>\n  return (\n    <div className=\"flex w-full flex-col\">\n      <Tabs value={active.id} onValueChange={value => onTabChange?.(value)} className=\"w-full\">\n        <TabsList variant=\"line\">\n          {tabs.map(({ id, label, icon }) => (\n            <TabsTrigger key={id} value={id}>\n              {icon && <Icon name={icon} />}\n              {label}\n            </TabsTrigger>\n          ))}\n        </TabsList>\n      </Tabs>\n      <div className={contentClassName} data-settings-panel-content>\n        <Active key={active.id} {...active.props} />\n      </div>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,oBAAoB,EAAE,QAAQ,KAAK,aAAa,mBAAmB,UAQhF;CACD,MAAM,MAAM,iBAAiB;CAC7B,MAAM,SAAS,cAAc,QAAQ,cAAc,KAAA,IAAY,MAAM,CAAC,EAAE;CACxE,MAAM,OAAO,SAAS,eAAe,QAAQ,GAAG,IAAI,CAAC;CACrD,MAAM,SAAS,KAAK,MAAK,cAAa,UAAU,OAAO,GAAG,KAAK,KAAK;CACpE,IAAI,CAAC,QAAQ,OAAO;CAEpB,MAAM,SAAS,OAAO;CACtB,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACE,oBAAC,MAAD;GAAM,OAAO,OAAO;GAAI,gBAAe,UAAS,cAAc,KAAK;GAAG,WAAU;GAC9E,UAAA,oBAAC,UAAD;IAAU,SAAQ;IACf,UAAA,KAAK,KAAK,EAAE,IAAI,OAAO,WACtB,qBAAC,aAAD;KAAsB,OAAO;KAA7B,UAAA,CACG,QAAQ,oBAAC,MAAD,EAAM,MAAM,KAAO,CAAA,GAC3B,KACU;IAHK,GAAA,EAGL,CACd;GACO,CAAA;EACN,CAAA,GACN,oBAAC,OAAD;GAAK,WAAW;GAAkB,+BAAA;GAChC,UAAA,oBAAC,QAAD,EAAwB,GAAI,OAAO,MAAQ,GAA9B,OAAO,EAAuB;EACxC,CAAA,CACF;;AAET"}

package/dist/react/EditorSurface.d.ts

@@ -1,6 +1,8 @@
-import { AbilitiesOptions, BlockAction, SlashCommandItem } from "../core/extension-points.js";
+import { CommandDef } from "../core/command-types.js";
+import { AbilitiesOptions, BlockAction } from "../core/extension-points.js";
 import { EditorMetadata, MetadataItem } from "../core/metadata-types.js";
-import { CollaborationSession, EditorFeature, EditorPreset, UploadFn } from "../core/feature.js";
+import { CollaborationSession, EditorFeature, EditorPreset } from "../core/feature.js";
+import "../core/commands.js";
 import { AnyExtension, Editor, JSONContent } from "@tiptap/core";
 import { ComponentType } from "react";
 //#region src/react/EditorSurface.d.ts
@@ -26,12 +28,10 @@ export interface EditorSurfaceProps {
   extensions?: AnyExtension[];
   /** Hover actions shown after the features' own; shown by an installed block-UI feature. */
   blockActions?: BlockAction[];
-  /** Builds the `/` menu from the features' commands; absent = the features' commands. Read once at mount. */
-  slashCommands?: (defaults: SlashCommandItem[]) => SlashCommandItem[];
-  /** Document whose package stores uploads (media feature). Read once at mount. */
+  /** Builds the final commands (and with them the `/` menu) from the features' commands; absent = the features' commands. Read once at mount. */
+  commands?: (defaults: CommandDef[]) => CommandDef[];
+  /** Document whose package stores uploads (`backend.assets`, media feature). Read once at mount. */
   documentId?: string;
-  /** Stores an uploaded file and returns its URL (media feature). Read once at mount. */
-  upload?: UploadFn;
   editable?: boolean;
   /** `internal`: the surface owns its settings UI; `external`: it calls `onSettingsOpen` and the host shows the panel. */
   settingsUi?: 'internal' | 'external';

package/dist/react/EditorSurface.js

@@ -41,17 +41,20 @@ function useOpenState(value, onChange) {
 * check, setup lifecycle); callbacks are read from the surface's latest props.
 */
 function createSurface(props, app, parts) {
-	const { preset, collaboration, value, editable, metadata, documentId, upload, abilities, slashCommands, extensions, blockActions } = props.current;
+	const { preset, collaboration, value, editable, metadata, documentId, abilities, commands, extensions, blockActions } = props.current;
 	const ui = {
 		openSettings: parts.openSettings,
 		toggleSidebar: () => parts.sidebar.set(!parts.sidebar.latest.current.open),
 		toggleComments: () => parts.comments.set(!parts.comments.latest.current.open),
 		get commentsOpen() {
 			return parts.comments.latest.current.open;
+		},
+		togglePalette: () => parts.palette.set(!parts.palette.latest.current.open),
+		get paletteOpen() {
+			return parts.palette.latest.current.open;
 		}
 	};
 	return {
-		preset,
 		ui,
 		session: createSurfaceSession({
 			app,
@@ -65,9 +68,8 @@ function createSurface(props, app, parts) {
 			editable,
 			metadata,
 			documentId,
-			upload,
 			abilities,
-			slashCommands,
+			commands,
 			extensions,
 			blockActions,
 			onChange: (content) => props.current.onChange?.(content),
@@ -85,6 +87,7 @@ const EditorSurface = forwardRef(function EditorSurface(props, ref) {
 	const editorRef = useRef(null);
 	const sidebar = useOpenState(props.sidebarOpen, props.onSidebarOpenChange);
 	const comments = useOpenState(props.commentsOpen, props.onCommentsOpenChange);
+	const palette = useOpenState(void 0, void 0);
 	const [settingsState, setSettingsState] = useState({
 		open: false,
 		tab: void 0
@@ -100,10 +103,11 @@ const EditorSurface = forwardRef(function EditorSurface(props, ref) {
 			tab: tab ?? state.tab
 		}));
 	}, []);
-	const [{ preset, ui, session }] = useState(() => createSurface(latest, app, {
+	const [{ ui, session }] = useState(() => createSurface(latest, app, {
 		editor: editorRef,
 		sidebar,
 		comments,
+		palette,
 		openSettings
 	}));
 	const editor = useEditor({
@@ -150,7 +154,7 @@ const EditorSurface = forwardRef(function EditorSurface(props, ref) {
 			}),
 			session.overlays.map((Overlay, index) => /* @__PURE__ */ jsx(Overlay, { editor }, index)),
 			(props.settingsUi ?? "internal") === "internal" && /* @__PURE__ */ jsx(EditorSettingsModal, {
-				preset,
+				...editor && { editor },
 				open: settingsState.open,
 				onOpenChange: (open) => setSettingsState((state) => ({
 					...state,

package/dist/react/EditorSurface.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditorSurface.js","names":[],"sources":["../../src/react/EditorSurface.tsx"],"sourcesContent":["import type { AnyExtension, Editor, JSONContent } from '@tiptap/core'\nimport { EditorContent, useEditor } from '@tiptap/react'\nimport { type ComponentType, forwardRef, useCallback, useEffect, useImperativeHandle, useRef, useState } from 'react'\nimport type { EditorContext } from '../core/context'\nimport { settingsTabsOf } from '../core/define-editor'\nimport type { EditorUi } from '../core/editor-ui'\nimport type { AbilitiesOptions, BlockAction, SlashCommandItem } from '../core/extension-points'\nimport type { CollaborationSession, EditorFeature, EditorPreset, UploadFn } from '../core/feature'\nimport type { EditorMetadata, MetadataItem } from '../core/metadata-types'\nimport { createSurfaceSession } from '../core/surface-session'\nimport { useEditorContext } from './context'\nimport { EditorSettingsModal } from './EditorSettingsModal'\nimport { EditorUiContext } from './editor-ui'\nimport { reactNotifier } from './notify'\nimport { reactSuggestionRenderer } from './suggestion-renderer'\n\nexport type ReactFeature = EditorFeature<ComponentType<{ editor: Editor }>>\nexport type ReactPreset = EditorPreset<ComponentType<{ editor: Editor }>>\n\nexport interface EditorSurfaceProps {\n  /** The features this editor is made of (`defineEditor(...)`); fixed at mount, remount (`key`) to change it. */\n  preset: ReactPreset\n  /** Collaborative mode: the Y.Doc is the document. Needs a preset with the collaboration feature; fixed at mount. */\n  collaboration?: CollaborationSession\n  /** Standalone mode (without `collaboration`): TipTap JSON, with `onChange`; the editor keeps its own undo history. */\n  value?: JSONContent\n  onChange?: (content: JSONContent) => void\n  /** Host lists (`mentions`, `hashtags`, `speakers`, custom) features' suggestions search. */\n  metadata?: EditorMetadata\n  /** Deep-merged into the `Abilities` defaults; read once at mount. */\n  abilities?: Partial<AbilitiesOptions>\n  /** Added after the features' extensions; read once at mount. */\n  extensions?: AnyExtension[]\n  /** Hover actions shown after the features' own; shown by an installed block-UI feature. */\n  blockActions?: BlockAction[]\n  /** Builds the `/` menu from the features' commands; absent = the features' commands. Read once at mount. */\n  slashCommands?: (defaults: SlashCommandItem[]) => SlashCommandItem[]\n  /** Document whose package stores uploads (media feature). Read once at mount. */\n  documentId?: string\n  /** Stores an uploaded file and returns its URL (media feature). Read once at mount. */\n  upload?: UploadFn\n  editable?: boolean\n  /** `internal`: the surface owns its settings UI; `external`: it calls `onSettingsOpen` and the host shows the panel. */\n  settingsUi?: 'internal' | 'external'\n  /** The editor exists and its chrome is registered (`useEditorUi(editor)`, a host toolbar). */\n  onReady?: (editor: Editor) => void\n  onMetadataCreate?: (list: string, item: MetadataItem) => void\n  /** The JSON handed in (initially or later) does not fit this editor's schema; the last valid document stays. */\n  onContentError?: (error: Error) => void\n  /** `settingsUi: 'external'`: the editor asks the host to open its settings (on `tab` when given). */\n  onSettingsOpen?: (tab?: string) => void\n  /** Whether this editor's AI sidebar is open (`toggleSidebar`): controlled when given. */\n  sidebarOpen?: boolean\n  onSidebarOpenChange?: (open: boolean) => void\n  /**\n   * Whether this editor's comments margin is open (`toggleComments`): controlled when given. The AI sidebar and the\n   * margin exclude each other: whichever opens last closes the other.\n   */\n  commentsOpen?: boolean\n  onCommentsOpenChange?: (open: boolean) => void\n}\n\nexport interface EditorSurfaceHandle {\n  editor: Editor | null\n  openSettings(tab?: string): void\n}\n\n/** A boolean that is the host's (`value` given) or the component's own (`value` undefined); the setter is stable. */\nfunction useOpenState(value: boolean | undefined, onChange: ((open: boolean) => void) | undefined) {\n  const [internal, setInternal] = useState(false)\n  const controlled = value !== undefined\n  const open = value ?? internal\n  const latest = useRef({ open, controlled, onChange })\n  latest.current = { open, controlled, onChange }\n  const set = useCallback((next: boolean) => {\n    const current = latest.current\n    if (next === current.open) return\n    current.open = next\n    if (!current.controlled) setInternal(next)\n    current.onChange?.(next)\n  }, [])\n  return { open, set, latest }\n}\n\n/**\n * Everything fixed at mount: the chrome handle and the framework-free session (preset, context, extensions, content\n * check, setup lifecycle); callbacks are read from the surface's latest props.\n */\nfunction createSurface(props: { current: EditorSurfaceProps }, app: EditorContext, parts: {\n  editor: { current: Editor | null }\n  sidebar: { set: (open: boolean) => void, latest: { current: { open: boolean } } }\n  comments: { set: (open: boolean) => void, latest: { current: { open: boolean } } }\n  openSettings: (tab?: string) => void\n}) {\n  const { preset, collaboration, value, editable, metadata, documentId, upload, abilities, slashCommands, extensions, blockActions } = props.current\n\n  const ui: EditorUi = {\n    openSettings: parts.openSettings,\n    toggleSidebar: () => parts.sidebar.set(!parts.sidebar.latest.current.open),\n    toggleComments: () => parts.comments.set(!parts.comments.latest.current.open),\n    get commentsOpen() {\n      return parts.comments.latest.current.open\n    },\n  }\n\n  // The mode is fixed at mount; hosts switch it by remounting (`key`).\n  const session = createSurfaceSession({\n    app,\n    preset,\n    ui,\n    notify: reactNotifier,\n    suggestionRenderer: reactSuggestionRenderer,\n    getEditor: () => parts.editor.current ?? undefined,\n    collaboration,\n    value,\n    editable,\n    metadata,\n    documentId,\n    upload,\n    abilities,\n    slashCommands,\n    extensions,\n    blockActions,\n    onChange: content => props.current.onChange?.(content),\n    onMetadataCreate: (list, item) => props.current.onMetadataCreate?.(list, item),\n    onContentError: error => props.current.onContentError?.(error),\n    onReady: editor => props.current.onReady?.(editor),\n  })\n  return { preset, ui, session }\n}\n\nexport const EditorSurface = forwardRef<EditorSurfaceHandle, EditorSurfaceProps>(function EditorSurface(props, ref) {\n  const { value, editable = true, metadata } = props\n  const latest = useRef(props)\n  latest.current = props\n\n  const app = useEditorContext()\n  const editorRef = useRef<Editor | null>(null)\n  const sidebar = useOpenState(props.sidebarOpen, props.onSidebarOpenChange)\n  const comments = useOpenState(props.commentsOpen, props.onCommentsOpenChange)\n  // `settingsUi: 'internal'`: the surface's own settings modal (`openSettings` opens it).\n  const [settingsState, setSettingsState] = useState<{ open: boolean, tab: string | undefined }>({ open: false, tab: undefined })\n\n  const openSettings = useCallback((tab?: string) => {\n    // Nothing to open without a contributed tab.\n    if (!settingsTabsOf(latest.current.preset, app).length) return\n    if ((latest.current.settingsUi ?? 'internal') === 'external') {\n      latest.current.onSettingsOpen?.(tab)\n      return\n    }\n    setSettingsState(state => ({ open: true, tab: tab ?? state.tab }))\n  }, [])\n\n  const [{ preset, ui, session }] = useState(() => createSurface(latest, app, { editor: editorRef, sidebar, comments, openSettings }))\n\n  const editor = useEditor({\n    ...session.editorOptions,\n    immediatelyRender: true,\n    shouldRerenderOnTransaction: false,\n  })\n  editorRef.current = editor\n\n  // Per-mount side effects of features (`setup`). Activation and deactivation are paired, so StrictMode's mount,\n  // cleanup, mount leaves exactly one active setup, and unmounting tears it down.\n  useEffect(() => {\n    session.activate()\n    return () => session.deactivate()\n  }, [session])\n\n  // The editor exists from the first render; its chrome is registered before the session announces it through\n  // `onReady`, so a host toolbar that receives it finds the chrome.\n  useEffect(() => session.register(editor), [editor, session])\n\n  // External replacement of the standalone document (the host loaded or reset it); not an edit, so no update event.\n  useEffect(() => session.setValue(value), [value, editor, session])\n\n  useEffect(() => session.setEditable(editable), [editable, editor, session])\n\n  useEffect(() => session.setMetadata(metadata), [metadata, session])\n\n  // The AI sidebar and the comments margin exclude each other: whichever opens last closes the other.\n  useEffect(() => {\n    if (sidebar.open) comments.set(false)\n  }, [sidebar.open, comments.set])\n  useEffect(() => {\n    if (comments.open) sidebar.set(false)\n  }, [comments.open, sidebar.set])\n\n  useImperativeHandle(ref, () => ({ editor, openSettings }), [editor, openSettings])\n\n  return (\n    <EditorUiContext.Provider value={ui}>\n      <div className=\"relative\">\n        <EditorContent editor={editor} className=\"relative\" />\n      </div>\n      {session.overlays.map((Overlay, index) => <Overlay key={index} editor={editor} />)}\n      {(props.settingsUi ?? 'internal') === 'internal' && (\n        <EditorSettingsModal\n          preset={preset}\n          open={settingsState.open}\n          onOpenChange={open => setSettingsState(state => ({ ...state, open }))}\n          {...(settingsState.tab !== undefined && { tab: settingsState.tab })}\n          onTabChange={tab => setSettingsState(state => ({ ...state, tab }))}\n        />\n      )}\n    </EditorUiContext.Provider>\n  )\n})\n"],"mappings":"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"}
+{"version":3,"file":"EditorSurface.js","names":[],"sources":["../../src/react/EditorSurface.tsx"],"sourcesContent":["import type { AnyExtension, Editor, JSONContent } from '@tiptap/core'\nimport { EditorContent, useEditor } from '@tiptap/react'\nimport { type ComponentType, forwardRef, useCallback, useEffect, useImperativeHandle, useRef, useState } from 'react'\nimport type { EditorContext } from '../core/context'\nimport { settingsTabsOf } from '../core/define-editor'\nimport type { EditorUi } from '../core/editor-ui'\nimport type { CommandDef } from '../core/commands'\nimport type { AbilitiesOptions, BlockAction } from '../core/extension-points'\nimport type { CollaborationSession, EditorFeature, EditorPreset } from '../core/feature'\nimport type { EditorMetadata, MetadataItem } from '../core/metadata-types'\nimport { createSurfaceSession } from '../core/surface-session'\nimport { useEditorContext } from './context'\nimport { EditorSettingsModal } from './EditorSettingsModal'\nimport { EditorUiContext } from './editor-ui'\nimport { reactNotifier } from './notify'\nimport { reactSuggestionRenderer } from './suggestion-renderer'\n\nexport type ReactFeature = EditorFeature<ComponentType<{ editor: Editor }>>\nexport type ReactPreset = EditorPreset<ComponentType<{ editor: Editor }>>\n\nexport interface EditorSurfaceProps {\n  /** The features this editor is made of (`defineEditor(...)`); fixed at mount, remount (`key`) to change it. */\n  preset: ReactPreset\n  /** Collaborative mode: the Y.Doc is the document. Needs a preset with the collaboration feature; fixed at mount. */\n  collaboration?: CollaborationSession\n  /** Standalone mode (without `collaboration`): TipTap JSON, with `onChange`; the editor keeps its own undo history. */\n  value?: JSONContent\n  onChange?: (content: JSONContent) => void\n  /** Host lists (`mentions`, `hashtags`, `speakers`, custom) features' suggestions search. */\n  metadata?: EditorMetadata\n  /** Deep-merged into the `Abilities` defaults; read once at mount. */\n  abilities?: Partial<AbilitiesOptions>\n  /** Added after the features' extensions; read once at mount. */\n  extensions?: AnyExtension[]\n  /** Hover actions shown after the features' own; shown by an installed block-UI feature. */\n  blockActions?: BlockAction[]\n  /** Builds the final commands (and with them the `/` menu) from the features' commands; absent = the features' commands. Read once at mount. */\n  commands?: (defaults: CommandDef[]) => CommandDef[]\n  /** Document whose package stores uploads (`backend.assets`, media feature). Read once at mount. */\n  documentId?: string\n  editable?: boolean\n  /** `internal`: the surface owns its settings UI; `external`: it calls `onSettingsOpen` and the host shows the panel. */\n  settingsUi?: 'internal' | 'external'\n  /** The editor exists and its chrome is registered (`useEditorUi(editor)`, a host toolbar). */\n  onReady?: (editor: Editor) => void\n  onMetadataCreate?: (list: string, item: MetadataItem) => void\n  /** The JSON handed in (initially or later) does not fit this editor's schema; the last valid document stays. */\n  onContentError?: (error: Error) => void\n  /** `settingsUi: 'external'`: the editor asks the host to open its settings (on `tab` when given). */\n  onSettingsOpen?: (tab?: string) => void\n  /** Whether this editor's AI sidebar is open (`toggleSidebar`): controlled when given. */\n  sidebarOpen?: boolean\n  onSidebarOpenChange?: (open: boolean) => void\n  /**\n   * Whether this editor's comments margin is open (`toggleComments`): controlled when given. The AI sidebar and the\n   * margin exclude each other: whichever opens last closes the other.\n   */\n  commentsOpen?: boolean\n  onCommentsOpenChange?: (open: boolean) => void\n}\n\nexport interface EditorSurfaceHandle {\n  editor: Editor | null\n  openSettings(tab?: string): void\n}\n\n/** A boolean that is the host's (`value` given) or the component's own (`value` undefined); the setter is stable. */\nfunction useOpenState(value: boolean | undefined, onChange: ((open: boolean) => void) | undefined) {\n  const [internal, setInternal] = useState(false)\n  const controlled = value !== undefined\n  const open = value ?? internal\n  const latest = useRef({ open, controlled, onChange })\n  latest.current = { open, controlled, onChange }\n  const set = useCallback((next: boolean) => {\n    const current = latest.current\n    if (next === current.open) return\n    current.open = next\n    if (!current.controlled) setInternal(next)\n    current.onChange?.(next)\n  }, [])\n  return { open, set, latest }\n}\n\n/**\n * Everything fixed at mount: the chrome handle and the framework-free session (preset, context, extensions, content\n * check, setup lifecycle); callbacks are read from the surface's latest props.\n */\nfunction createSurface(props: { current: EditorSurfaceProps }, app: EditorContext, parts: {\n  editor: { current: Editor | null }\n  sidebar: { set: (open: boolean) => void, latest: { current: { open: boolean } } }\n  comments: { set: (open: boolean) => void, latest: { current: { open: boolean } } }\n  palette: { set: (open: boolean) => void, latest: { current: { open: boolean } } }\n  openSettings: (tab?: string) => void\n}) {\n  const { preset, collaboration, value, editable, metadata, documentId, abilities, commands, extensions, blockActions } = props.current\n\n  const ui: EditorUi = {\n    openSettings: parts.openSettings,\n    toggleSidebar: () => parts.sidebar.set(!parts.sidebar.latest.current.open),\n    toggleComments: () => parts.comments.set(!parts.comments.latest.current.open),\n    get commentsOpen() {\n      return parts.comments.latest.current.open\n    },\n    togglePalette: () => parts.palette.set(!parts.palette.latest.current.open),\n    get paletteOpen() {\n      return parts.palette.latest.current.open\n    },\n  }\n\n  // The mode is fixed at mount; hosts switch it by remounting (`key`).\n  const session = createSurfaceSession({\n    app,\n    preset,\n    ui,\n    notify: reactNotifier,\n    suggestionRenderer: reactSuggestionRenderer,\n    getEditor: () => parts.editor.current ?? undefined,\n    collaboration,\n    value,\n    editable,\n    metadata,\n    documentId,\n    abilities,\n    commands,\n    extensions,\n    blockActions,\n    onChange: content => props.current.onChange?.(content),\n    onMetadataCreate: (list, item) => props.current.onMetadataCreate?.(list, item),\n    onContentError: error => props.current.onContentError?.(error),\n    onReady: editor => props.current.onReady?.(editor),\n  })\n  return { ui, session }\n}\n\nexport const EditorSurface = forwardRef<EditorSurfaceHandle, EditorSurfaceProps>(function EditorSurface(props, ref) {\n  const { value, editable = true, metadata } = props\n  const latest = useRef(props)\n  latest.current = props\n\n  const app = useEditorContext()\n  const editorRef = useRef<Editor | null>(null)\n  const sidebar = useOpenState(props.sidebarOpen, props.onSidebarOpenChange)\n  const comments = useOpenState(props.commentsOpen, props.onCommentsOpenChange)\n  // The ⌘K palette (the `core-ui` overlay, when the preset has one): the surface's own state.\n  const palette = useOpenState(undefined, undefined)\n  // `settingsUi: 'internal'`: the surface's own settings modal (`openSettings` opens it).\n  const [settingsState, setSettingsState] = useState<{ open: boolean, tab: string | undefined }>({ open: false, tab: undefined })\n\n  const openSettings = useCallback((tab?: string) => {\n    // Nothing to open without a contributed tab.\n    if (!settingsTabsOf(latest.current.preset, app).length) return\n    if ((latest.current.settingsUi ?? 'internal') === 'external') {\n      latest.current.onSettingsOpen?.(tab)\n      return\n    }\n    setSettingsState(state => ({ open: true, tab: tab ?? state.tab }))\n  }, [])\n\n  const [{ ui, session }] = useState(() => createSurface(latest, app, { editor: editorRef, sidebar, comments, palette, openSettings }))\n\n  const editor = useEditor({\n    ...session.editorOptions,\n    immediatelyRender: true,\n    shouldRerenderOnTransaction: false,\n  })\n  editorRef.current = editor\n\n  // Per-mount side effects of features (`setup`). Activation and deactivation are paired, so StrictMode's mount,\n  // cleanup, mount leaves exactly one active setup, and unmounting tears it down.\n  useEffect(() => {\n    session.activate()\n    return () => session.deactivate()\n  }, [session])\n\n  // The editor exists from the first render; its chrome is registered before the session announces it through\n  // `onReady`, so a host toolbar that receives it finds the chrome.\n  useEffect(() => session.register(editor), [editor, session])\n\n  // External replacement of the standalone document (the host loaded or reset it); not an edit, so no update event.\n  useEffect(() => session.setValue(value), [value, editor, session])\n\n  useEffect(() => session.setEditable(editable), [editable, editor, session])\n\n  useEffect(() => session.setMetadata(metadata), [metadata, session])\n\n  // The AI sidebar and the comments margin exclude each other: whichever opens last closes the other.\n  useEffect(() => {\n    if (sidebar.open) comments.set(false)\n  }, [sidebar.open, comments.set])\n  useEffect(() => {\n    if (comments.open) sidebar.set(false)\n  }, [comments.open, sidebar.set])\n\n  useImperativeHandle(ref, () => ({ editor, openSettings }), [editor, openSettings])\n\n  return (\n    <EditorUiContext.Provider value={ui}>\n      <div className=\"relative\">\n        <EditorContent editor={editor} className=\"relative\" />\n      </div>\n      {session.overlays.map((Overlay, index) => <Overlay key={index} editor={editor} />)}\n      {(props.settingsUi ?? 'internal') === 'internal' && (\n        <EditorSettingsModal\n          {...(editor && { editor })}\n          open={settingsState.open}\n          onOpenChange={open => setSettingsState(state => ({ ...state, open }))}\n          {...(settingsState.tab !== undefined && { tab: settingsState.tab })}\n          onTabChange={tab => setSettingsState(state => ({ ...state, tab }))}\n        />\n      )}\n    </EditorUiContext.Provider>\n  )\n})\n"],"mappings":";;;;;;;;;;;;AAmEA,SAAS,aAAa,OAA4B,UAAiD;CACjG,MAAM,CAAC,UAAU,eAAe,SAAS,KAAK;CAC9C,MAAM,aAAa,UAAU,KAAA;CAC7B,MAAM,OAAO,SAAS;CACtB,MAAM,SAAS,OAAO;EAAE;EAAM;EAAY;CAAS,CAAC;CACpD,OAAO,UAAU;EAAE;EAAM;EAAY;CAAS;CAQ9C,OAAO;EAAE;EAAM,KAPH,aAAa,SAAkB;GACzC,MAAM,UAAU,OAAO;GACvB,IAAI,SAAS,QAAQ,MAAM;GAC3B,QAAQ,OAAO;GACf,IAAI,CAAC,QAAQ,YAAY,YAAY,IAAI;GACzC,QAAQ,WAAW,IAAI;EACzB,GAAG,CAAC,CACa;EAAG;CAAO;AAC7B;;;;;AAMA,SAAS,cAAc,OAAwC,KAAoB,OAMhF;CACD,MAAM,EAAE,QAAQ,eAAe,OAAO,UAAU,UAAU,YAAY,WAAW,UAAU,YAAY,iBAAiB,MAAM;CAE9H,MAAM,KAAe;EACnB,cAAc,MAAM;EACpB,qBAAqB,MAAM,QAAQ,IAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI;EACzE,sBAAsB,MAAM,SAAS,IAAI,CAAC,MAAM,SAAS,OAAO,QAAQ,IAAI;EAC5E,IAAI,eAAe;GACjB,OAAO,MAAM,SAAS,OAAO,QAAQ;EACvC;EACA,qBAAqB,MAAM,QAAQ,IAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI;EACzE,IAAI,cAAc;GAChB,OAAO,MAAM,QAAQ,OAAO,QAAQ;EACtC;CACF;CAwBA,OAAO;EAAE;EAAI,SArBG,qBAAqB;GACnC;GACA;GACA;GACA,QAAQ;GACR,oBAAoB;GACpB,iBAAiB,MAAM,OAAO,WAAW,KAAA;GACzC;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,WAAU,YAAW,MAAM,QAAQ,WAAW,OAAO;GACrD,mBAAmB,MAAM,SAAS,MAAM,QAAQ,mBAAmB,MAAM,IAAI;GAC7E,iBAAgB,UAAS,MAAM,QAAQ,iBAAiB,KAAK;GAC7D,UAAS,WAAU,MAAM,QAAQ,UAAU,MAAM;EACnD,CACmB;CAAE;AACvB;AAEA,MAAa,gBAAgB,WAAoD,SAAS,cAAc,OAAO,KAAK;CAClH,MAAM,EAAE,OAAO,WAAW,MAAM,aAAa;CAC7C,MAAM,SAAS,OAAO,KAAK;CAC3B,OAAO,UAAU;CAEjB,MAAM,MAAM,iBAAiB;CAC7B,MAAM,YAAY,OAAsB,IAAI;CAC5C,MAAM,UAAU,aAAa,MAAM,aAAa,MAAM,mBAAmB;CACzE,MAAM,WAAW,aAAa,MAAM,cAAc,MAAM,oBAAoB;CAE5E,MAAM,UAAU,aAAa,KAAA,GAAW,KAAA,CAAS;CAEjD,MAAM,CAAC,eAAe,oBAAoB,SAAqD;EAAE,MAAM;EAAO,KAAK,KAAA;CAAU,CAAC;CAE9H,MAAM,eAAe,aAAa,QAAiB;EAEjD,IAAI,CAAC,eAAe,OAAO,QAAQ,QAAQ,GAAG,CAAC,CAAC,QAAQ;EACxD,KAAK,OAAO,QAAQ,cAAc,gBAAgB,YAAY;GAC5D,OAAO,QAAQ,iBAAiB,GAAG;GACnC;EACF;EACA,kBAAiB,WAAU;GAAE,MAAM;GAAM,KAAK,OAAO,MAAM;EAAI,EAAE;CACnE,GAAG,CAAC,CAAC;CAEL,MAAM,CAAC,EAAE,IAAI,aAAa,eAAe,cAAc,QAAQ,KAAK;EAAE,QAAQ;EAAW;EAAS;EAAU;EAAS;CAAa,CAAC,CAAC;CAEpI,MAAM,SAAS,UAAU;EACvB,GAAG,QAAQ;EACX,mBAAmB;EACnB,6BAA6B;CAC/B,CAAC;CACD,UAAU,UAAU;CAIpB,gBAAgB;EACd,QAAQ,SAAS;EACjB,aAAa,QAAQ,WAAW;CAClC,GAAG,CAAC,OAAO,CAAC;CAIZ,gBAAgB,QAAQ,SAAS,MAAM,GAAG,CAAC,QAAQ,OAAO,CAAC;CAG3D,gBAAgB,QAAQ,SAAS,KAAK,GAAG;EAAC;EAAO;EAAQ;CAAO,CAAC;CAEjE,gBAAgB,QAAQ,YAAY,QAAQ,GAAG;EAAC;EAAU;EAAQ;CAAO,CAAC;CAE1E,gBAAgB,QAAQ,YAAY,QAAQ,GAAG,CAAC,UAAU,OAAO,CAAC;CAGlE,gBAAgB;EACd,IAAI,QAAQ,MAAM,SAAS,IAAI,KAAK;CACtC,GAAG,CAAC,QAAQ,MAAM,SAAS,GAAG,CAAC;CAC/B,gBAAgB;EACd,IAAI,SAAS,MAAM,QAAQ,IAAI,KAAK;CACtC,GAAG,CAAC,SAAS,MAAM,QAAQ,GAAG,CAAC;CAE/B,oBAAoB,YAAY;EAAE;EAAQ;CAAa,IAAI,CAAC,QAAQ,YAAY,CAAC;CAEjF,OACE,qBAAC,gBAAgB,UAAjB;EAA0B,OAAO;EAAjC,UAAA;GACE,oBAAC,OAAD;IAAK,WAAU;IACb,UAAA,oBAAC,eAAD;KAAuB;KAAQ,WAAU;IAAY,CAAA;GAClD,CAAA;GACJ,QAAQ,SAAS,KAAK,SAAS,UAAU,oBAAC,SAAD,EAA6B,OAAS,GAAxB,KAAwB,CAAC;IAC/E,MAAM,cAAc,gBAAgB,cACpC,oBAAC,qBAAD;IACE,GAAK,UAAU,EAAE,OAAO;IACxB,MAAM,cAAc;IACpB,eAAc,SAAQ,kBAAiB,WAAU;KAAE,GAAG;KAAO;IAAK,EAAE;IACpE,GAAK,cAAc,QAAQ,KAAA,KAAa,EAAE,KAAK,cAAc,IAAI;IACjE,cAAa,QAAO,kBAAiB,WAAU;KAAE,GAAG;KAAO;IAAI,EAAE;GAClE,CAAA;EAEqB;;AAE9B,CAAC"}

package/dist/react/EditorToolbar.d.ts

@@ -1,15 +1,13 @@
-import { ReactPreset } from "./EditorSurface.js";
 import { Editor } from "@tiptap/core";
 //#region src/react/EditorToolbar.d.ts
 /**
  * The toolbar of an editor, placed anywhere on the page. `editor` is the instance it works on (from the surface's
- * `onReady`); the preset registered for that instance supplies the groups, `preset` renders them (disabled) while
- * there is no editor yet. A destroyed editor counts as none: a host still holds the old instance for the render in
- * which its keyed surface remounts. Never reads a global active editor.
+ * `onReady`); the preset registered for that instance (`editorEntryOf`) supplies the groups. Without an editor (not
+ * mounted yet, or read-only by the host's choice) it renders no groups. A destroyed editor counts as none: a host still
+ * holds the old instance for the render in which its keyed surface remounts. Never reads a global active editor.
  */
-export declare function EditorToolbar({ editor: given, preset }: {
+export declare function EditorToolbar({ editor: given }: {
   editor?: Editor;
-  preset?: ReactPreset;
 }): import("react").JSX.Element;
 //#endregion
 //# sourceMappingURL=EditorToolbar.d.ts.map