@ecsplico/editor 1.0.0 → 2.1.0

package/dist/react/EditorSurface.js

@@ -1,18 +1,12 @@
-import { presetExtension } from "../core/pipeline.js";
-import { createMetadataRegistry } from "../core/metadata.js";
-import { SuggestionPopup } from "../core/suggestion-popup.js";
-import { contributions, settingsTabsOf } from "../core/define-editor.js";
-import { registerEditor } from "../core/editor-ui.js";
-import { blockActionsOf, createFeatureContext } from "../core/feature-context.js";
+import { settingsTabsOf } from "../core/define-editor.js";
 import { useEditorContext } from "./context.js";
-import { EMPTY_EDITOR_CONTENT } from "../core/schema/index.js";
+import { createSurfaceSession } from "../core/surface-session.js";
 import { EditorSettingsModal } from "./EditorSettingsModal.js";
 import { EditorUiContext } from "./editor-ui.js";
 import { reactNotifier } from "./notify.js";
 import { reactSuggestionRenderer } from "./suggestion-renderer.js";
 import { forwardRef, useCallback, useEffect, useImperativeHandle, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { getSchema } from "@tiptap/core";
 import { EditorContent, useEditor } from "@tiptap/react";
 //#region src/react/EditorSurface.tsx
 /** A boolean that is the host's (`value` given) or the component's own (`value` undefined); the setter is stable. */
@@ -42,10 +36,12 @@ function useOpenState(value, onChange) {
 		latest
 	};
 }
-/** Everything fixed at mount: preset, context, extensions, content check; callbacks are read from the surface's props. */
+/**
+* Everything fixed at mount: the chrome handle and the framework-free session (preset, context, extensions, content
+* check, setup lifecycle); callbacks are read from the surface's latest props.
+*/
 function createSurface(props, app, parts) {
-	const { preset, collaboration } = props.current;
-	if (collaboration && !preset.features.some((feature) => feature.id === "collab")) throw new Error("@ecsplico/editor: `collaboration` needs a preset with the collaboration feature");
+	const { preset, collaboration, value, editable, metadata, documentId, upload, abilities, slashCommands, extensions, blockActions } = props.current;
 	const ui = {
 		openSettings: parts.openSettings,
 		toggleSidebar: () => parts.sidebar.set(!parts.sidebar.latest.current.open),
@@ -54,76 +50,31 @@ function createSurface(props, app, parts) {
 			return parts.comments.latest.current.open;
 		}
 	};
-	const registry = createMetadataRegistry({ onCreate: (list, item) => props.current.onMetadataCreate?.(list, item) });
-	registry.replace({ ...props.current.metadata });
-	const ctx = createFeatureContext({
-		app,
-		preset,
-		ui,
-		metadata: registry,
-		notify: reactNotifier,
-		getEditor: () => parts.editor.current ?? void 0,
-		...props.current.documentId !== void 0 && { documentId: props.current.documentId },
-		...props.current.upload && { upload: props.current.upload },
-		...collaboration && { collaboration },
-		...props.current.abilities && { abilities: props.current.abilities },
-		...props.current.slashCommands && { slashCommands: props.current.slashCommands }
-	});
-	const extensions = [
-		presetExtension(preset),
-		SuggestionPopup.configure({ renderer: reactSuggestionRenderer }),
-		...contributions(preset, "extensions").flatMap((factory) => factory(ctx)),
-		...props.current.extensions ?? []
-	];
-	const schema = getSchema(extensions);
-	const overlays = preset.features.flatMap((feature) => [...feature.overlays ?? []]);
-	const blockActions = blockActionsOf(preset, ctx, props.current.blockActions);
-	/** `json` migrated by the preset and checked against the installed schema: unknown nodes/marks or a broken structure are errors. */
-	const validated = (json) => {
-		try {
-			const migrated = preset.pipeline.migrateContent(json);
-			schema.nodeFromJSON(migrated).check();
-			return { json: migrated };
-		} catch (error) {
-			return { error: error instanceof Error ? error : new Error(String(error)) };
-		}
-	};
-	let lastEmitted;
-	let content;
-	let initialError;
-	if (!collaboration) {
-		const initial = props.current.value ? validated(props.current.value) : { json: EMPTY_EDITOR_CONTENT };
-		if ("error" in initial) initialError = initial.error;
-		content = "json" in initial ? initial.json : EMPTY_EDITOR_CONTENT;
-	}
 	return {
 		preset,
-		collaboration,
 		ui,
-		registry,
-		ctx,
-		extensions,
-		overlays,
-		blockActions,
-		validated,
-		content,
-		initialError,
-		get lastEmitted() {
-			return lastEmitted;
-		},
-		set lastEmitted(json) {
-			lastEmitted = json;
-		},
-		/** What the effects below already applied; they only react to a change. */
-		applied: {
-			value: props.current.value,
-			editable: props.current.editable ?? true,
-			metadata: props.current.metadata
-		},
-		/** Teardowns of the `setup` contributions that are currently active. */
-		teardowns: [],
-		errorReported: false,
-		announced: null
+		session: createSurfaceSession({
+			app,
+			preset,
+			ui,
+			notify: reactNotifier,
+			suggestionRenderer: reactSuggestionRenderer,
+			getEditor: () => parts.editor.current ?? void 0,
+			collaboration,
+			value,
+			editable,
+			metadata,
+			documentId,
+			upload,
+			abilities,
+			slashCommands,
+			extensions,
+			blockActions,
+			onChange: (content) => props.current.onChange?.(content),
+			onMetadataCreate: (list, item) => props.current.onMetadataCreate?.(list, item),
+			onContentError: (error) => props.current.onContentError?.(error),
+			onReady: (editor) => props.current.onReady?.(editor)
+		})
 	};
 }
 const EditorSurface = forwardRef(function EditorSurface(props, ref) {
@@ -149,91 +100,34 @@ const EditorSurface = forwardRef(function EditorSurface(props, ref) {
 			tab: tab ?? state.tab
 		}));
 	}, []);
-	const [surface] = useState(() => createSurface(latest, app, {
+	const [{ preset, ui, session }] = useState(() => createSurface(latest, app, {
 		editor: editorRef,
 		sidebar,
 		comments,
 		openSettings
 	}));
-	const { preset, collaboration } = surface;
 	const editor = useEditor({
-		extensions: surface.extensions,
-		...!collaboration && {
-			content: surface.content,
-			onUpdate: ({ editor: instance }) => {
-				const json = instance.getJSON();
-				surface.lastEmitted = json;
-				latest.current.onChange?.(json);
-			}
-		},
-		editable,
+		...session.editorOptions,
 		immediatelyRender: true,
-		shouldRerenderOnTransaction: false,
-		editorProps: { attributes: { class: "tiptap" } }
+		shouldRerenderOnTransaction: false
 	});
 	editorRef.current = editor;
 	useEffect(() => {
-		for (const run of contributions(preset, "setup")) {
-			const teardown = run(surface.ctx);
-			if (teardown) surface.teardowns.push(teardown);
-		}
-		return () => {
-			for (const teardown of surface.teardowns.splice(0)) teardown();
-		};
-	}, [surface, preset]);
-	useEffect(() => {
-		if (surface.initialError && !surface.errorReported) {
-			surface.errorReported = true;
-			latest.current.onContentError?.(surface.initialError);
-		}
-		const unregister = registerEditor(editor, {
-			ui: surface.ui,
-			preset,
-			ctx: surface.ctx,
-			blockActions: surface.blockActions
-		});
-		if (surface.announced !== editor) {
-			surface.announced = editor;
-			latest.current.onReady?.(editor);
-		}
-		return unregister;
-	}, [
-		editor,
-		surface,
-		preset
-	]);
-	useEffect(() => {
-		if (value === surface.applied.value) return;
-		surface.applied.value = value;
-		if (collaboration || !value || editor.isDestroyed || value === surface.lastEmitted) return;
-		const checked = surface.validated(value);
-		if ("error" in checked) {
-			latest.current.onContentError?.(checked.error);
-			return;
-		}
-		editor.commands.setContent(checked.json, { emitUpdate: false });
-	}, [
+		session.activate();
+		return () => session.deactivate();
+	}, [session]);
+	useEffect(() => session.register(editor), [editor, session]);
+	useEffect(() => session.setValue(value), [
 		value,
 		editor,
-		surface,
-		collaboration
+		session
 	]);
-	useEffect(() => {
-		if (editable === surface.applied.editable) return;
-		surface.applied.editable = editable;
-		if (editor.isDestroyed) return;
-		editor.setEditable(editable, false);
-		editor.view.dispatch(editor.state.tr.setMeta("addToHistory", false));
-	}, [
+	useEffect(() => session.setEditable(editable), [
 		editable,
 		editor,
-		surface
+		session
 	]);
-	useEffect(() => {
-		if (metadata === surface.applied.metadata) return;
-		surface.applied.metadata = metadata;
-		surface.registry.replace({ ...metadata });
-	}, [metadata, surface]);
+	useEffect(() => session.setMetadata(metadata), [metadata, session]);
 	useEffect(() => {
 		if (sidebar.open) comments.set(false);
 	}, [sidebar.open, comments.set]);
@@ -245,7 +139,7 @@ const EditorSurface = forwardRef(function EditorSurface(props, ref) {
 		openSettings
 	}), [editor, openSettings]);
 	return /* @__PURE__ */ jsxs(EditorUiContext.Provider, {
-		value: surface.ui,
+		value: ui,
 		children: [
 			/* @__PURE__ */ jsx("div", {
 				className: "relative",
@@ -254,7 +148,7 @@ const EditorSurface = forwardRef(function EditorSurface(props, ref) {
 					className: "relative"
 				})
 			}),
-			surface.overlays.map((Overlay, index) => /* @__PURE__ */ jsx(Overlay, { editor }, index)),
+			session.overlays.map((Overlay, index) => /* @__PURE__ */ jsx(Overlay, { editor }, index)),
 			(props.settingsUi ?? "internal") === "internal" && /* @__PURE__ */ jsx(EditorSettingsModal, {
 				preset,
 				open: settingsState.open,

package/dist/react/EditorSurface.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditorSurface.js","names":[],"sources":["../../src/react/EditorSurface.tsx"],"sourcesContent":["import { type AnyExtension, type Editor, getSchema, type 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 { contributions, settingsTabsOf } from '../core/define-editor'\nimport { type EditorUi, registerEditor } from '../core/editor-ui'\nimport type { AbilitiesOptions, BlockAction, SlashCommandItem } from '../core/extension-points'\nimport type { CollaborationSession, EditorFeature, EditorPreset, UploadFn } from '../core/feature'\nimport { blockActionsOf, createFeatureContext } from '../core/feature-context'\nimport { createMetadataRegistry } from '../core/metadata'\nimport type { EditorMetadata, MetadataItem } from '../core/metadata-types'\nimport { presetExtension } from '../core/pipeline'\nimport { EMPTY_EDITOR_CONTENT } from '../core/schema'\nimport { SuggestionPopup } from '../core/suggestion-popup'\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/** Everything fixed at mount: preset, context, extensions, content check; callbacks are read from the surface's props. */\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 } = props.current\n  // The mode is fixed at mount; hosts switch it by remounting (`key`).\n  if (collaboration && !preset.features.some(feature => feature.id === 'collab')) {\n    throw new Error('@ecsplico/editor: `collaboration` needs a preset with the collaboration feature')\n  }\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  const registry = createMetadataRegistry({ onCreate: (list, item) => props.current.onMetadataCreate?.(list, item) })\n  registry.replace({ ...props.current.metadata })\n\n  const ctx = createFeatureContext({\n    app,\n    preset,\n    ui,\n    metadata: registry,\n    notify: reactNotifier,\n    getEditor: () => parts.editor.current ?? undefined,\n    ...(props.current.documentId !== undefined && { documentId: props.current.documentId }),\n    ...(props.current.upload && { upload: props.current.upload }),\n    ...(collaboration && { collaboration }),\n    ...(props.current.abilities && { abilities: props.current.abilities }),\n    ...(props.current.slashCommands && { slashCommands: props.current.slashCommands }),\n  })\n\n  const extensions: AnyExtension[] = [\n    presetExtension(preset),\n    SuggestionPopup.configure({ renderer: reactSuggestionRenderer }),\n    ...contributions(preset, 'extensions').flatMap(factory => factory(ctx)),\n    ...(props.current.extensions ?? []),\n  ]\n  const schema = getSchema(extensions)\n  const overlays = preset.features.flatMap(feature => [...(feature.overlays ?? [])])\n  const blockActions = blockActionsOf(preset, ctx, props.current.blockActions)\n\n  /** `json` migrated by the preset and checked against the installed schema: unknown nodes/marks or a broken structure are errors. */\n  const validated = (json: JSONContent): { json: JSONContent } | { error: Error } => {\n    try {\n      const migrated = preset.pipeline.migrateContent(json)\n      schema.nodeFromJSON(migrated).check()\n      return { json: migrated }\n    }\n    catch (error) {\n      return { error: error instanceof Error ? error : new Error(String(error)) }\n    }\n  }\n\n  // Standalone: the JSON last sent through `onChange`; the host handing it back is not an external change.\n  let lastEmitted: JSONContent | undefined\n  let content: JSONContent | undefined\n  let initialError: Error | undefined\n  if (!collaboration) {\n    const initial = props.current.value ? validated(props.current.value) : { json: EMPTY_EDITOR_CONTENT }\n    if ('error' in initial) initialError = initial.error\n    content = 'json' in initial ? initial.json : EMPTY_EDITOR_CONTENT\n  }\n\n  return {\n    preset,\n    collaboration,\n    ui,\n    registry,\n    ctx,\n    extensions,\n    overlays,\n    blockActions,\n    validated,\n    content,\n    initialError,\n    get lastEmitted() {\n      return lastEmitted\n    },\n    set lastEmitted(json: JSONContent | undefined) {\n      lastEmitted = json\n    },\n    /** What the effects below already applied; they only react to a change. */\n    applied: {\n      value: props.current.value,\n      editable: props.current.editable ?? true,\n      metadata: props.current.metadata,\n    },\n    /** Teardowns of the `setup` contributions that are currently active. */\n    teardowns: [] as (() => void)[],\n    errorReported: false,\n    announced: null as Editor | null,\n  }\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 [surface] = useState(() => createSurface(latest, app, { editor: editorRef, sidebar, comments, openSettings }))\n  const { preset, collaboration } = surface\n\n  const editor = useEditor({\n    extensions: surface.extensions,\n    ...(!collaboration && {\n      content: surface.content,\n      onUpdate: ({ editor: instance }: { editor: Editor }) => {\n        const json = instance.getJSON()\n        surface.lastEmitted = json\n        latest.current.onChange?.(json)\n      },\n    }),\n    editable,\n    immediatelyRender: true,\n    shouldRerenderOnTransaction: false,\n    editorProps: { attributes: { class: 'tiptap' } },\n  })\n  editorRef.current = editor\n\n  // Per-mount side effects of features (`setup`). Run and teardown are paired, so StrictMode's mount, cleanup, mount\n  // leaves exactly one active setup, and unmounting tears it down.\n  useEffect(() => {\n    for (const run of contributions(preset, 'setup')) {\n      const teardown = run(surface.ctx)\n      if (teardown) surface.teardowns.push(teardown)\n    }\n    return () => {\n      for (const teardown of surface.teardowns.splice(0)) teardown()\n    }\n  }, [surface, preset])\n\n  // The editor exists from the first render; announce it once its chrome is registered first, so a host toolbar that\n  // receives it through `onReady` finds the chrome.\n  useEffect(() => {\n    if (surface.initialError && !surface.errorReported) {\n      surface.errorReported = true\n      latest.current.onContentError?.(surface.initialError)\n    }\n    const unregister = registerEditor(editor, { ui: surface.ui, preset, ctx: surface.ctx, blockActions: surface.blockActions })\n    if (surface.announced !== editor) {\n      surface.announced = editor\n      latest.current.onReady?.(editor)\n    }\n    return unregister\n  }, [editor, surface, preset])\n\n  // External replacement of the standalone document (the host loaded or reset it); not an edit, so no update event.\n  useEffect(() => {\n    if (value === surface.applied.value) return\n    surface.applied.value = value\n    if (collaboration || !value || editor.isDestroyed || value === surface.lastEmitted) return\n    const checked = surface.validated(value)\n    if ('error' in checked) {\n      latest.current.onContentError?.(checked.error)\n      return\n    }\n    editor.commands.setContent(checked.json, { emitUpdate: false })\n  }, [value, editor, surface, collaboration])\n\n  // `setEditable(…, false)` changes the flag without any event; an empty, history-less transaction lets components that\n  // follow `isEditable` on `transaction` (block UI, the composite inspector) notice. It has no steps, so nothing syncs.\n  useEffect(() => {\n    if (editable === surface.applied.editable) return\n    surface.applied.editable = editable\n    if (editor.isDestroyed) return\n    editor.setEditable(editable, false)\n    editor.view.dispatch(editor.state.tr.setMeta('addToHistory', false))\n  }, [editable, editor, surface])\n\n  useEffect(() => {\n    if (metadata === surface.applied.metadata) return\n    surface.applied.metadata = metadata\n    surface.registry.replace({ ...metadata })\n  }, [metadata, surface])\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={surface.ui}>\n      <div className=\"relative\">\n        <EditorContent editor={editor} className=\"relative\" />\n      </div>\n      {surface.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":";;;;;;;;;;;;;;;;;;AAwEA,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;;AAGA,SAAS,cAAc,OAAwC,KAAoB,OAKhF;CACD,MAAM,EAAE,QAAQ,kBAAkB,MAAM;CAExC,IAAI,iBAAiB,CAAC,OAAO,SAAS,MAAK,YAAW,QAAQ,OAAO,QAAQ,GAC3E,MAAM,IAAI,MAAM,iFAAiF;CAGnG,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;CACF;CAEA,MAAM,WAAW,uBAAuB,EAAE,WAAW,MAAM,SAAS,MAAM,QAAQ,mBAAmB,MAAM,IAAI,EAAE,CAAC;CAClH,SAAS,QAAQ,EAAE,GAAG,MAAM,QAAQ,SAAS,CAAC;CAE9C,MAAM,MAAM,qBAAqB;EAC/B;EACA;EACA;EACA,UAAU;EACV,QAAQ;EACR,iBAAiB,MAAM,OAAO,WAAW,KAAA;EACzC,GAAI,MAAM,QAAQ,eAAe,KAAA,KAAa,EAAE,YAAY,MAAM,QAAQ,WAAW;EACrF,GAAI,MAAM,QAAQ,UAAU,EAAE,QAAQ,MAAM,QAAQ,OAAO;EAC3D,GAAI,iBAAiB,EAAE,cAAc;EACrC,GAAI,MAAM,QAAQ,aAAa,EAAE,WAAW,MAAM,QAAQ,UAAU;EACpE,GAAI,MAAM,QAAQ,iBAAiB,EAAE,eAAe,MAAM,QAAQ,cAAc;CAClF,CAAC;CAED,MAAM,aAA6B;EACjC,gBAAgB,MAAM;EACtB,gBAAgB,UAAU,EAAE,UAAU,wBAAwB,CAAC;EAC/D,GAAG,cAAc,QAAQ,YAAY,CAAC,CAAC,SAAQ,YAAW,QAAQ,GAAG,CAAC;EACtE,GAAI,MAAM,QAAQ,cAAc,CAAC;CACnC;CACA,MAAM,SAAS,UAAU,UAAU;CACnC,MAAM,WAAW,OAAO,SAAS,SAAQ,YAAW,CAAC,GAAI,QAAQ,YAAY,CAAC,CAAE,CAAC;CACjF,MAAM,eAAe,eAAe,QAAQ,KAAK,MAAM,QAAQ,YAAY;;CAG3E,MAAM,aAAa,SAAgE;EACjF,IAAI;GACF,MAAM,WAAW,OAAO,SAAS,eAAe,IAAI;GACpD,OAAO,aAAa,QAAQ,CAAC,CAAC,MAAM;GACpC,OAAO,EAAE,MAAM,SAAS;EAC1B,SACO,OAAO;GACZ,OAAO,EAAE,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,EAAE;EAC5E;CACF;CAGA,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI,CAAC,eAAe;EAClB,MAAM,UAAU,MAAM,QAAQ,QAAQ,UAAU,MAAM,QAAQ,KAAK,IAAI,EAAE,MAAM,qBAAqB;EACpG,IAAI,WAAW,SAAS,eAAe,QAAQ;EAC/C,UAAU,UAAU,UAAU,QAAQ,OAAO;CAC/C;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,IAAI,cAAc;GAChB,OAAO;EACT;EACA,IAAI,YAAY,MAA+B;GAC7C,cAAc;EAChB;;EAEA,SAAS;GACP,OAAO,MAAM,QAAQ;GACrB,UAAU,MAAM,QAAQ,YAAY;GACpC,UAAU,MAAM,QAAQ;EAC1B;;EAEA,WAAW,CAAC;EACZ,eAAe;EACf,WAAW;CACb;AACF;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,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,WAAW,eAAe,cAAc,QAAQ,KAAK;EAAE,QAAQ;EAAW;EAAS;EAAU;CAAa,CAAC,CAAC;CACnH,MAAM,EAAE,QAAQ,kBAAkB;CAElC,MAAM,SAAS,UAAU;EACvB,YAAY,QAAQ;EACpB,GAAI,CAAC,iBAAiB;GACpB,SAAS,QAAQ;GACjB,WAAW,EAAE,QAAQ,eAAmC;IACtD,MAAM,OAAO,SAAS,QAAQ;IAC9B,QAAQ,cAAc;IACtB,OAAO,QAAQ,WAAW,IAAI;GAChC;EACF;EACA;EACA,mBAAmB;EACnB,6BAA6B;EAC7B,aAAa,EAAE,YAAY,EAAE,OAAO,SAAS,EAAE;CACjD,CAAC;CACD,UAAU,UAAU;CAIpB,gBAAgB;EACd,KAAK,MAAM,OAAO,cAAc,QAAQ,OAAO,GAAG;GAChD,MAAM,WAAW,IAAI,QAAQ,GAAG;GAChC,IAAI,UAAU,QAAQ,UAAU,KAAK,QAAQ;EAC/C;EACA,aAAa;GACX,KAAK,MAAM,YAAY,QAAQ,UAAU,OAAO,CAAC,GAAG,SAAS;EAC/D;CACF,GAAG,CAAC,SAAS,MAAM,CAAC;CAIpB,gBAAgB;EACd,IAAI,QAAQ,gBAAgB,CAAC,QAAQ,eAAe;GAClD,QAAQ,gBAAgB;GACxB,OAAO,QAAQ,iBAAiB,QAAQ,YAAY;EACtD;EACA,MAAM,aAAa,eAAe,QAAQ;GAAE,IAAI,QAAQ;GAAI;GAAQ,KAAK,QAAQ;GAAK,cAAc,QAAQ;EAAa,CAAC;EAC1H,IAAI,QAAQ,cAAc,QAAQ;GAChC,QAAQ,YAAY;GACpB,OAAO,QAAQ,UAAU,MAAM;EACjC;EACA,OAAO;CACT,GAAG;EAAC;EAAQ;EAAS;CAAM,CAAC;CAG5B,gBAAgB;EACd,IAAI,UAAU,QAAQ,QAAQ,OAAO;EACrC,QAAQ,QAAQ,QAAQ;EACxB,IAAI,iBAAiB,CAAC,SAAS,OAAO,eAAe,UAAU,QAAQ,aAAa;EACpF,MAAM,UAAU,QAAQ,UAAU,KAAK;EACvC,IAAI,WAAW,SAAS;GACtB,OAAO,QAAQ,iBAAiB,QAAQ,KAAK;GAC7C;EACF;EACA,OAAO,SAAS,WAAW,QAAQ,MAAM,EAAE,YAAY,MAAM,CAAC;CAChE,GAAG;EAAC;EAAO;EAAQ;EAAS;CAAa,CAAC;CAI1C,gBAAgB;EACd,IAAI,aAAa,QAAQ,QAAQ,UAAU;EAC3C,QAAQ,QAAQ,WAAW;EAC3B,IAAI,OAAO,aAAa;EACxB,OAAO,YAAY,UAAU,KAAK;EAClC,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,QAAQ,gBAAgB,KAAK,CAAC;CACrE,GAAG;EAAC;EAAU;EAAQ;CAAO,CAAC;CAE9B,gBAAgB;EACd,IAAI,aAAa,QAAQ,QAAQ,UAAU;EAC3C,QAAQ,QAAQ,WAAW;EAC3B,QAAQ,SAAS,QAAQ,EAAE,GAAG,SAAS,CAAC;CAC1C,GAAG,CAAC,UAAU,OAAO,CAAC;CAGtB,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,QAAQ;EAAzC,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;IACU;IACR,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"}
+{"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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"}

package/dist/react/EditorToolbar.js

@@ -1,8 +1,7 @@
 import { abilitiesAtSelection } from "../core/abilities.js";
-import { createMetadataRegistry } from "../core/metadata.js";
 import { mergeToolbarGroups } from "../core/toolbar.js";
 import { contributions } from "../core/define-editor.js";
-import { editorEntryOf, notifierOf } from "../core/editor-ui.js";
+import { borrowedFeatureContext, editorEntryOf } from "../core/editor-ui.js";
 import { useEditorContext } from "./context.js";
 import { useEditorI18n } from "./use-editor-i18n.js";
 import { cn } from "./ui/utils.js";
@@ -48,48 +47,12 @@ function EditorToolbar({ editor: given, preset }) {
 	const { t } = useEditorI18n();
 	const [state] = useState(() => {
 		const ref = { current: editor };
-		const fallbackMetadata = createMetadataRegistry();
-		const entry = () => editorEntryOf(ref.current);
-		const ui = () => entry()?.ui;
 		return {
 			ref,
-			ctx: {
+			ctx: borrowedFeatureContext({
 				app,
-				locale: app.locale,
-				t: app.t,
-				settings: app.settings,
-				notify: notifierOf(() => ref.current, app),
-				fetch: app.fetch,
-				ai: app.ai,
-				get metadata() {
-					return entry()?.ctx.metadata ?? fallbackMetadata;
-				},
-				ui: {
-					openSettings: (tab) => ui()?.openSettings(tab),
-					toggleSidebar: () => ui()?.toggleSidebar(),
-					toggleComments: () => ui()?.toggleComments(),
-					get commentsOpen() {
-						return ui()?.commentsOpen ?? false;
-					}
-				},
-				get documentId() {
-					return entry()?.ctx.documentId;
-				},
-				get upload() {
-					return entry()?.ctx.upload;
-				},
-				get collaboration() {
-					return entry()?.ctx.collaboration;
-				},
-				get anchorResolver() {
-					return entry()?.ctx.anchorResolver ?? null;
-				},
-				get abilities() {
-					return entry()?.ctx.abilities ?? {};
-				},
-				slashCommands: () => entry()?.ctx.slashCommands() ?? [],
 				getEditor: () => ref.current
-			}
+			})
 		};
 	});
 	state.ref.current = editor;

package/dist/react/EditorToolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditorToolbar.js","names":[],"sources":["../../src/react/EditorToolbar.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { useEditorState } from '@tiptap/react'\nimport { type ComponentType, type ReactNode, useState } from 'react'\nimport { abilitiesAtSelection } from '../core/abilities'\nimport { contributions } from '../core/define-editor'\nimport { editorEntryOf, notifierOf } from '../core/editor-ui'\nimport type { FeatureContext } from '../core/feature'\nimport { createMetadataRegistry } from '../core/metadata'\nimport type { Ability } from '../core/schema/abilities'\nimport { mergeToolbarGroups, type MenuItem, type ToolbarGroup, type ToolbarItem } from '../core/toolbar'\nimport { useEditorContext } from './context'\nimport type { ReactPreset } from './EditorSurface'\nimport { Icon } from './Icon'\nimport { Button } from './ui/button'\nimport {\n  DropdownMenu,\n  DropdownMenuContent,\n  DropdownMenuItem,\n  DropdownMenuLabel,\n  DropdownMenuSeparator,\n  DropdownMenuTrigger,\n} from './ui/dropdown-menu'\nimport { Separator } from './ui/separator'\nimport { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from './ui/tooltip'\nimport { useEditorI18n } from './use-editor-i18n'\nimport { useStore } from './use-store'\nimport { cn } from './ui/utils'\n\ntype ItemComponent = ComponentType<{ editor: Editor }>\ntype Item = ToolbarItem<ItemComponent>\ntype Group = ToolbarGroup<ItemComponent>\n\nconst NO_ABILITIES: ReadonlySet<Ability> = new Set()\n\n// Factories are plain functions here (React features must not call hooks in them): built once per preset, app-wide,\n// keyed by the toolbar's `ctx` so each toolbar's items delegate to its own editor.\nconst built = new WeakMap<FeatureContext, WeakMap<ReactPreset, Group[]>>()\nfunction groupsOf(ctx: FeatureContext, preset: ReactPreset | undefined): Group[] {\n  if (!preset) return []\n  let byPreset = built.get(ctx)\n  if (!byPreset) built.set(ctx, byPreset = new WeakMap())\n  const cached = byPreset.get(preset)\n  if (cached) return cached\n  const groups = mergeToolbarGroups(contributions(preset, 'toolbar').flatMap(factory => factory(ctx)))\n  byPreset.set(preset, groups)\n  return groups\n}\n\nconst isMac = typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(navigator.platform)\nconst KEY_LABELS: Record<string, string> = {\n  meta: isMac ? '⌘' : 'Ctrl',\n  ctrl: 'Ctrl',\n  // i18n-ignore: keyboard key name, shown as on the keycap\n  alt: isMac ? '⌥' : 'Alt',\n  shift: '⇧',\n  enter: '↵',\n}\n\n/**\n * The toolbar of an editor, placed anywhere on the page. `editor` is the instance it works on (from the surface's\n * `onReady`); the preset registered for that instance supplies the groups, `preset` renders them (disabled) while\n * there is no editor yet. A destroyed editor counts as none: a host still holds the old instance for the render in\n * which its keyed surface remounts. Never reads a global active editor.\n */\nexport function EditorToolbar({ editor: given, preset }: { editor?: Editor, preset?: ReactPreset }) {\n  const editor = given?.isDestroyed ? undefined : given\n  const app = useEditorContext()\n  const { t } = useEditorI18n()\n\n  // The context toolbar factories see: settings and fetch of the app, everything per-surface delegates to the editor's\n  // registered context while there is one. Built once; `ref` keeps it pointing at the current editor.\n  const [state] = useState(() => {\n    const ref: { current: Editor | undefined } = { current: editor }\n    const fallbackMetadata = createMetadataRegistry()\n    const entry = () => editorEntryOf(ref.current)\n    const ui = () => entry()?.ui\n    const ctx: FeatureContext = {\n      app,\n      locale: app.locale,\n      t: app.t,\n      settings: app.settings,\n      notify: notifierOf(() => ref.current, app),\n      fetch: app.fetch,\n      ai: app.ai,\n      get metadata() { return entry()?.ctx.metadata ?? fallbackMetadata },\n      ui: {\n        openSettings: tab => ui()?.openSettings(tab),\n        toggleSidebar: () => ui()?.toggleSidebar(),\n        toggleComments: () => ui()?.toggleComments(),\n        get commentsOpen() { return ui()?.commentsOpen ?? false },\n      },\n      get documentId() { return entry()?.ctx.documentId },\n      get upload() { return entry()?.ctx.upload },\n      get collaboration() { return entry()?.ctx.collaboration },\n      get anchorResolver() { return entry()?.ctx.anchorResolver ?? null },\n      get abilities() { return entry()?.ctx.abilities ?? {} },\n      slashCommands: () => entry()?.ctx.slashCommands() ?? [],\n      getEditor: () => ref.current,\n    }\n    return { ref, ctx }\n  })\n  state.ref.current = editor\n\n  // `active`/`visible`/`menu` may read the settings: re-render when they change.\n  useStore(app.settings)\n  // `active`, `can()` and the abilities read the editor state: re-render on every transaction.\n  const abilities = useEditorState({\n    editor: editor ?? null,\n    selector: ({ editor: current }) => current && !current.isDestroyed ? abilitiesAtSelection(current) : NO_ABILITIES,\n    equalityFn: () => false,\n  }) ?? NO_ABILITIES\n\n  const groups = groupsOf(state.ctx, (editorEntryOf(editor)?.preset as ReactPreset | undefined) ?? preset)\n    .filter(group => !editor || !group.visible || group.visible(editor))\n    .map(group => ({ group, items: group.items.filter(item => !editor || !item.visible || item.visible(editor)) }))\n    .filter(({ items }) => items.length > 0)\n\n  const active = (item: Item) => !!editor && !!item.active?.(editor)\n  const disabled = (item: Item) => {\n    if (!editor) return true\n    if (item.disabled?.(editor)) return true\n    return !active(item) && !!item.ability && !abilities.has(item.ability)\n  }\n\n  return (\n    <TooltipProvider>\n      <div className=\"flex flex-wrap items-center gap-1.5\" role=\"toolbar\" aria-label={t('toolbar.label')}>\n        {groups.map(({ group, items }, index) => (\n          <div key={group.id} className=\"contents\">\n            {index > 0 && <Separator orientation=\"vertical\" className=\"mx-2 h-6 data-[orientation=vertical]:h-6\" />}\n            <div className=\"flex items-center gap-0.5\">\n              {items.map(item => item.component\n                ? <item.component key={item.id} editor={editor!} />\n                : <ToolbarButton\n                    key={item.id}\n                    item={item}\n                    editor={editor}\n                    active={active(item)}\n                    disabled={disabled(item)}\n                  />)}\n            </div>\n          </div>\n        ))}\n      </div>\n    </TooltipProvider>\n  )\n}\n\nfunction ToolbarButton({ item, editor, active, disabled }: { item: Item, editor: Editor | undefined, active: boolean, disabled: boolean }) {\n  const button = (\n    <Button\n      variant=\"ghost\"\n      size=\"icon-sm\"\n      aria-label={item.label}\n      aria-pressed={item.active ? active : undefined}\n      data-state={item.active ? (active ? 'on' : 'off') : undefined}\n      disabled={disabled}\n      className={cn(active && 'bg-primary/10 text-primary hover:bg-primary/15 hover:text-primary')}\n      onMouseDown={event => event.preventDefault()}\n      onClick={item.run && editor ? () => item.run!(editor) : undefined}\n    >\n      <Icon name={item.icon} />\n    </Button>\n  )\n  const tooltip = (trigger: ReactNode) => (\n    <Tooltip>\n      <TooltipTrigger asChild>{trigger}</TooltipTrigger>\n      <TooltipContent>\n        {item.label}\n        {item.kbds && item.kbds.length > 0 && (\n          <kbd data-slot=\"kbd\" className=\"rounded-sm bg-background/20 px-1 font-sans\">{item.kbds.map(key => KEY_LABELS[key] ?? key.toUpperCase()).join('+')}</kbd>\n        )}\n      </TooltipContent>\n    </Tooltip>\n  )\n  if (!item.menu) return tooltip(button)\n  return (\n    <DropdownMenu>\n      {tooltip(<DropdownMenuTrigger asChild>{button}</DropdownMenuTrigger>)}\n      <DropdownMenuContent align=\"start\">\n        {editor && item.menu(editor).map((entry, index) => <MenuRow key={index} entry={entry} />)}\n      </DropdownMenuContent>\n    </DropdownMenu>\n  )\n}\n\nfunction MenuRow({ entry }: { entry: MenuItem }) {\n  if (entry.type === 'label') return <DropdownMenuLabel>{entry.label}</DropdownMenuLabel>\n  if (entry.type === 'separator') return <DropdownMenuSeparator />\n  return (\n    <DropdownMenuItem disabled={entry.disabled} onSelect={() => entry.onSelect?.()}>\n      {entry.icon && <Icon name={entry.icon} />}\n      <span>{entry.label}</span>\n      {entry.description && <span className=\"ml-auto text-xs text-muted-foreground\">{entry.description}</span>}\n    </DropdownMenuItem>\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"EditorToolbar.js","names":[],"sources":["../../src/react/EditorToolbar.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { useEditorState } from '@tiptap/react'\nimport { type ComponentType, type ReactNode, useState } from 'react'\nimport { abilitiesAtSelection } from '../core/abilities'\nimport { contributions } from '../core/define-editor'\nimport { borrowedFeatureContext, editorEntryOf } from '../core/editor-ui'\nimport type { FeatureContext } from '../core/feature'\nimport type { Ability } from '../core/schema/abilities'\nimport { mergeToolbarGroups, type MenuItem, type ToolbarGroup, type ToolbarItem } from '../core/toolbar'\nimport { useEditorContext } from './context'\nimport type { ReactPreset } from './EditorSurface'\nimport { Icon } from './Icon'\nimport { Button } from './ui/button'\nimport {\n  DropdownMenu,\n  DropdownMenuContent,\n  DropdownMenuItem,\n  DropdownMenuLabel,\n  DropdownMenuSeparator,\n  DropdownMenuTrigger,\n} from './ui/dropdown-menu'\nimport { Separator } from './ui/separator'\nimport { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from './ui/tooltip'\nimport { useEditorI18n } from './use-editor-i18n'\nimport { useStore } from './use-store'\nimport { cn } from './ui/utils'\n\ntype ItemComponent = ComponentType<{ editor: Editor }>\ntype Item = ToolbarItem<ItemComponent>\ntype Group = ToolbarGroup<ItemComponent>\n\nconst NO_ABILITIES: ReadonlySet<Ability> = new Set()\n\n// Factories are plain functions here (React features must not call hooks in them): built once per preset, app-wide,\n// keyed by the toolbar's `ctx` so each toolbar's items delegate to its own editor.\nconst built = new WeakMap<FeatureContext, WeakMap<ReactPreset, Group[]>>()\nfunction groupsOf(ctx: FeatureContext, preset: ReactPreset | undefined): Group[] {\n  if (!preset) return []\n  let byPreset = built.get(ctx)\n  if (!byPreset) built.set(ctx, byPreset = new WeakMap())\n  const cached = byPreset.get(preset)\n  if (cached) return cached\n  const groups = mergeToolbarGroups(contributions(preset, 'toolbar').flatMap(factory => factory(ctx)))\n  byPreset.set(preset, groups)\n  return groups\n}\n\nconst isMac = typeof navigator !== 'undefined' && /Mac|iPhone|iPad/.test(navigator.platform)\nconst KEY_LABELS: Record<string, string> = {\n  meta: isMac ? '⌘' : 'Ctrl',\n  ctrl: 'Ctrl',\n  // i18n-ignore: keyboard key name, shown as on the keycap\n  alt: isMac ? '⌥' : 'Alt',\n  shift: '⇧',\n  enter: '↵',\n}\n\n/**\n * The toolbar of an editor, placed anywhere on the page. `editor` is the instance it works on (from the surface's\n * `onReady`); the preset registered for that instance supplies the groups, `preset` renders them (disabled) while\n * there is no editor yet. A destroyed editor counts as none: a host still holds the old instance for the render in\n * which its keyed surface remounts. Never reads a global active editor.\n */\nexport function EditorToolbar({ editor: given, preset }: { editor?: Editor, preset?: ReactPreset }) {\n  const editor = given?.isDestroyed ? undefined : given\n  const app = useEditorContext()\n  const { t } = useEditorI18n()\n\n  // The context toolbar factories see: settings and fetch of the app, everything per-surface delegates to the editor's\n  // registered context while there is one. Built once; `ref` keeps it pointing at the current editor.\n  const [state] = useState(() => {\n    const ref: { current: Editor | undefined } = { current: editor }\n    return { ref, ctx: borrowedFeatureContext({ app, getEditor: () => ref.current }) }\n  })\n  state.ref.current = editor\n\n  // `active`/`visible`/`menu` may read the settings: re-render when they change.\n  useStore(app.settings)\n  // `active`, `can()` and the abilities read the editor state: re-render on every transaction.\n  const abilities = useEditorState({\n    editor: editor ?? null,\n    selector: ({ editor: current }) => current && !current.isDestroyed ? abilitiesAtSelection(current) : NO_ABILITIES,\n    equalityFn: () => false,\n  }) ?? NO_ABILITIES\n\n  const groups = groupsOf(state.ctx, (editorEntryOf(editor)?.preset as ReactPreset | undefined) ?? preset)\n    .filter(group => !editor || !group.visible || group.visible(editor))\n    .map(group => ({ group, items: group.items.filter(item => !editor || !item.visible || item.visible(editor)) }))\n    .filter(({ items }) => items.length > 0)\n\n  const active = (item: Item) => !!editor && !!item.active?.(editor)\n  const disabled = (item: Item) => {\n    if (!editor) return true\n    if (item.disabled?.(editor)) return true\n    return !active(item) && !!item.ability && !abilities.has(item.ability)\n  }\n\n  return (\n    <TooltipProvider>\n      <div className=\"flex flex-wrap items-center gap-1.5\" role=\"toolbar\" aria-label={t('toolbar.label')}>\n        {groups.map(({ group, items }, index) => (\n          <div key={group.id} className=\"contents\">\n            {index > 0 && <Separator orientation=\"vertical\" className=\"mx-2 h-6 data-[orientation=vertical]:h-6\" />}\n            <div className=\"flex items-center gap-0.5\">\n              {items.map(item => item.component\n                ? <item.component key={item.id} editor={editor!} />\n                : <ToolbarButton\n                    key={item.id}\n                    item={item}\n                    editor={editor}\n                    active={active(item)}\n                    disabled={disabled(item)}\n                  />)}\n            </div>\n          </div>\n        ))}\n      </div>\n    </TooltipProvider>\n  )\n}\n\nfunction ToolbarButton({ item, editor, active, disabled }: { item: Item, editor: Editor | undefined, active: boolean, disabled: boolean }) {\n  const button = (\n    <Button\n      variant=\"ghost\"\n      size=\"icon-sm\"\n      aria-label={item.label}\n      aria-pressed={item.active ? active : undefined}\n      data-state={item.active ? (active ? 'on' : 'off') : undefined}\n      disabled={disabled}\n      className={cn(active && 'bg-primary/10 text-primary hover:bg-primary/15 hover:text-primary')}\n      onMouseDown={event => event.preventDefault()}\n      onClick={item.run && editor ? () => item.run!(editor) : undefined}\n    >\n      <Icon name={item.icon} />\n    </Button>\n  )\n  const tooltip = (trigger: ReactNode) => (\n    <Tooltip>\n      <TooltipTrigger asChild>{trigger}</TooltipTrigger>\n      <TooltipContent>\n        {item.label}\n        {item.kbds && item.kbds.length > 0 && (\n          <kbd data-slot=\"kbd\" className=\"rounded-sm bg-background/20 px-1 font-sans\">{item.kbds.map(key => KEY_LABELS[key] ?? key.toUpperCase()).join('+')}</kbd>\n        )}\n      </TooltipContent>\n    </Tooltip>\n  )\n  if (!item.menu) return tooltip(button)\n  return (\n    <DropdownMenu>\n      {tooltip(<DropdownMenuTrigger asChild>{button}</DropdownMenuTrigger>)}\n      <DropdownMenuContent align=\"start\">\n        {editor && item.menu(editor).map((entry, index) => <MenuRow key={index} entry={entry} />)}\n      </DropdownMenuContent>\n    </DropdownMenu>\n  )\n}\n\nfunction MenuRow({ entry }: { entry: MenuItem }) {\n  if (entry.type === 'label') return <DropdownMenuLabel>{entry.label}</DropdownMenuLabel>\n  if (entry.type === 'separator') return <DropdownMenuSeparator />\n  return (\n    <DropdownMenuItem disabled={entry.disabled} onSelect={() => entry.onSelect?.()}>\n      {entry.icon && <Icon name={entry.icon} />}\n      <span>{entry.label}</span>\n      {entry.description && <span className=\"ml-auto text-xs text-muted-foreground\">{entry.description}</span>}\n    </DropdownMenuItem>\n  )\n}\n"],"mappings":"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"}

package/dist/react/styles/ui-vars.css

@@ -1,5 +1,5 @@
 /* The React surface's token map: the `--sk-*` variables the feature stylesheets (`styles/*.css`) read resolve to the
-   shadcn/ui theme tokens (the counterpart of `vue/kit/nuxt-ui.css` and `vue/kit/primevue.css`). */
+   shadcn/ui theme tokens (the counterpart of `vue/kit/nuxt-ui.css`). */
 :root,
 .dark {
   --sk-bg: var(--background);
@@ -12,7 +12,7 @@
   --sk-border-accented: var(--border);
   --sk-primary: var(--primary);
   --sk-primary-fg: var(--primary-foreground);
-  --sk-success: oklch(0.72 0.19 150);
+  --sk-success: var(--color-success, oklch(0.72 0.19 150));
   --sk-danger: var(--destructive);
   --sk-radius: var(--radius);
   --sk-bg-elevated: var(--card);

package/dist/schema/advanced.js

@@ -2,11 +2,11 @@ import { BlockId } from "../core/schema/block-ids.js";
 import { NodeFlags } from "../core/schema/node-flags.js";
 import { OpaqueFence } from "../core/schema/opaque-fence.js";
 import { StrikeX } from "../core/schema/strike.js";
-import { mentionsSchemaExtensions } from "../features/mentions/schema.js";
 import { compositeSchemaExtensions } from "../features/composites/schema.js";
-import { mediaSchemaExtensions } from "../features/media/schema.js";
 import { authorsSchemaExtensions } from "../features/authors/schema.js";
 import { commentsSchemaExtensions } from "../features/comments/schema.js";
+import { mediaSchemaExtensions } from "../features/media/schema.js";
+import { mentionsSchemaExtensions } from "../features/mentions/schema.js";
 import { tablesSchemaExtensions } from "../features/tables/schema.js";
 import { transcriptSchemaExtensions } from "../features/transcript/schema.js";
 import StarterKit from "@tiptap/starter-kit";

package/dist/server/adapter.d.ts

@@ -1,10 +1,10 @@
 import { EditorSettings } from "../settings/index.js";
-import { ModelProfile, ModelRef } from "../features/ai/protocol/models.js";
-import "../features/ai/protocol/index.js";
 import { AssetRecord } from "../features/media/assets.js";
 import "../features/media/schema.js";
 import { MentionUser } from "../features/mentions/mention.js";
 import "../features/mentions/schema.js";
+import { ModelProfile, ModelRef } from "../features/ai/protocol/models.js";
+import "../features/ai/protocol/index.js";
 import { ThemeRecord } from "../features/themes/schema.js";
 import { AnyExtension, JSONContent } from "@tiptap/core";
 import { LanguageModel } from "ai";

package/dist/server/collab.js

@@ -4,9 +4,9 @@ import { migrateLegacyContent } from "../features/composites/legacy.js";
 import { advancedSchemaExtensions } from "../schema/advanced.js";
 import { decodeCollabState, encodeCollabState, isStateStale } from "./collab-state.js";
 import { getSchema } from "@tiptap/core";
+import { Hocuspocus } from "@hocuspocus/server";
 import { prosemirrorToYDoc, prosemirrorToYXmlFragment, yDocToProsemirrorJSON, yXmlFragmentToProsemirror } from "@tiptap/y-tiptap";
 import * as Y from "yjs";
-import { Hocuspocus } from "@hocuspocus/server";
 //#region src/server/collab.ts
 /** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */
 const COLLAB_FIELD = "default";

package/dist/server/handlers/ai.d.ts

@@ -22,6 +22,7 @@ export declare const chatBodySchema: z.ZodObject<{
         pending: "pending";
         unchanged: "unchanged";
         missing: "missing";
+        stale: "stale";
         overlap: "overlap";
         empty: "empty";
         blocked: "blocked";
@@ -97,7 +98,8 @@ export declare const chatBodySchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Document chat: answers the last message of `messages` about `document`, or proposes edit operations through the
- * `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, or converting into a type not in
+ * `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, an `add` without `afterId`, an
+ * operation inside a block that another operation replaces or deletes, or converting into a type not in
  * `targets`, make the model retry (at most `AGENT_LIMITS.retries` times); what is still invalid then, or left out by a
  * corrected list, is dropped. The system prompt describes the editor's block model from `kinds`, `blocks` and `targets`. SSE like
  * `/api/ai/generate`: `delta` (text), `ops` (`{ ops: AgentOp[], dropped: AgentOpProblem[], retries: number }`, once,
@@ -120,8 +122,8 @@ export declare function completePost(ctx: AiHandlerContext, request: HandlerRequ
 /** Body schema of `generatePost`. */
 export declare const generateBodySchema: z.ZodObject<{
   task: z.ZodEnum<{
-    generate: "generate";
     custom: "custom";
+    generate: "generate";
     continue: "continue";
     reformulate: "reformulate";
     "transcript-summary": "transcript-summary";

package/dist/server/handlers/ai.js

@@ -1,14 +1,15 @@
 import { AI_LANGUAGES, STRUCTURE_MODES } from "../../settings/values.js";
-import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_TYPES, AGENT_TOOL, agentOpTarget, agentRetryMessage, agentUnreadableProblem, checkAgentOps, documentBlockIds } from "../../features/ai/protocol/agent-ops.js";
+import { HttpError } from "../errors.js";
+import { ASSET_DOCUMENT_ID, ASSET_NAME } from "../../features/media/assets.js";
+import { authenticated, enforceRateLimit, eventStream, json, readBody } from "./context.js";
+import { readBlockLines } from "../../features/ai/protocol/block-lines.js";
+import { AGENT_LIMITS, AGENT_OP_OUTCOMES, AGENT_OP_TYPES, AGENT_TOOL, agentOpTarget, agentRetryMessage, agentUnreadableProblem, checkAgentOps } from "../../features/ai/protocol/agent-ops.js";
 import { CHAT_LIMITS, documentChatMessages } from "../../features/ai/protocol/chat.js";
 import { AI_COMPLETE_LIMITS, cleanCompletion, completeMessages, completionReady } from "../../features/ai/protocol/complete.js";
 import { modelRefSchema } from "../../features/ai/protocol/models.js";
 import { AI_LIMITS, AI_TASKS, AI_TASK_IDS } from "../../features/ai/protocol/tasks.js";
 import { AI_ID_PATTERN, aiBlockInputSchema, aiBlockSchema } from "../../features/ai/protocol/schemas.js";
-import { ASSET_DOCUMENT_ID, ASSET_NAME } from "../../features/media/assets.js";
 import { TRANSCRIPT_CLEANUP_LIMITS, parseTranscriptCleanup, transcriptCleanupChunks, transcriptCleanupMessages, transcriptCleanupRequestSchema } from "../../integrations/transcript-ai/protocol.js";
-import { HttpError } from "../errors.js";
-import { authenticated, enforceRateLimit, eventStream, json, readBody } from "./context.js";
 import { z } from "zod";
 import { jsonSchema, tool } from "ai";
 //#region src/server/handlers/ai.ts
@@ -117,7 +118,7 @@ const agentTools = { [AGENT_TOOL]: tool({
 					},
 					afterId: {
 						type: ["string", "null"],
-						description: "add: ID des Blocks, nach dem eingefügt wird; null = Dokumentanfang."
+						description: "add (Pflicht): ID des Blocks, nach dem eingefügt wird; für den Dokumentanfang ausdrücklich null."
 					},
 					markdown: {
 						type: "string",
@@ -136,7 +137,8 @@ const agentTools = { [AGENT_TOOL]: tool({
 }) };
 /**
 * Document chat: answers the last message of `messages` about `document`, or proposes edit operations through the
-* `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, or converting into a type not in
+* `edit_document` tool. Operations pointing to IDs that are unknown or outside `scope`, an `add` without `afterId`, an
+* operation inside a block that another operation replaces or deletes, or converting into a type not in
 * `targets`, make the model retry (at most `AGENT_LIMITS.retries` times); what is still invalid then, or left out by a
 * corrected list, is dropped. The system prompt describes the editor's block model from `kinds`, `blocks` and `targets`. SSE like
 * `/api/ai/generate`: `delta` (text), `ops` (`{ ops: AgentOp[], dropped: AgentOpProblem[], retries: number }`, once,
@@ -147,11 +149,11 @@ async function chatPost(ctx, request) {
 	const { messages, document, scope, nextOp, model, kinds, blocks, targets, structure } = await readBody(request, chatBodySchema);
 	const languageModel = await ctx.ai.resolveModel(model, user);
 	if (!messages.at(-1).content.trim()) throw new HttpError(400, "Nachricht fehlt");
-	const known = documentBlockIds(document);
-	const allowed = scope ? new Set(scope.filter((id) => known.has(id))) : null;
+	const lines = readBlockLines(document);
+	const allowed = scope ? new Set(scope.filter((id) => lines.ids.has(id))) : null;
 	if (allowed && !allowed.size) throw new HttpError(400, "Die Auswahl enthält keine Blöcke des Dokuments");
 	const context = {
-		known: (id) => known.has(id),
+		lines,
 		allowed,
 		targets: new Set(targets)
 	};