@ecsplico/editor 1.0.0 → 2.1.0

package/dist/features/composites/index.js

@@ -1,20 +1,22 @@
 import { splitCompositeFences } from "../../core/fences.js";
-import { compositeKind, defaultCompositeKinds } from "./kinds.js";
+import { compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
 import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
 import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
 import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.js";
 import { compositeAiBrief } from "./ai-brief.js";
-import { compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
-import { compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
 import { compositeConversions, convertCompositeBlocks } from "./convert.js";
 import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+import { compositeSchemaExtensions } from "./schema.js";
+import { compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
+import { compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
+import { AcceptedChildren } from "./accepted-children.js";
 import { documentCompositeMarkdown, headingsMarkdown, markdownFileName } from "./markdown-export.js";
 import { compositeNodes } from "./node-views.js";
 import { Structure, structureOf } from "./structure.js";
 import { STRUCTURE_MODE_KEYS } from "./structure-mode.js";
 import { compositeFeatureCore } from "./feature.js";
-import { canMoveBlockInto, compositeOutline, moveBlockInto } from "./outline.js";
+import { canMoveBlockInto, compositeOutline, moveBlockInto, moveIntoVerdict } from "./outline.js";
 import { createCompositeRows } from "./rows-model.js";
+import { compositeFieldText, createCompositeInspector } from "./inspector-model.js";
 import { TREE_ROOT_KEYS } from "./tree-root.js";
-import { compositeSchemaExtensions } from "./schema.js";
-export { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, LEGACY_COMPOSITE_NODE, STRUCTURE_MODE_KEYS, Structure, TREE_ROOT_KEYS, blocksFromMarkdown, canMoveBlockInto, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeRows, defaultCompositeKinds, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, markdownFileName, migrateLegacyContent, moveBlockInto, observeCompositeAnchors, setCompositeDescription, setCompositeMetaField, setCompositeTags, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf };
+export { AcceptedChildren, COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, LEGACY_COMPOSITE_NODE, STRUCTURE_MODE_KEYS, Structure, TREE_ROOT_KEYS, blocksFromMarkdown, canMoveBlockInto, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, defaultCompositeKinds, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, migrateLegacyContent, moveBlockInto, moveIntoVerdict, observeCompositeAnchors, setCompositeDescription, setCompositeMetaField, setCompositeTags, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf };

package/dist/features/composites/inspector-model.d.ts

@@ -0,0 +1,97 @@
+import { ReadonlyStore } from "../../core/store.js";
+import { CompositeMetaField } from "./kinds.js";
+import { CompositeRow } from "./rows.js";
+import { CompositeRowsState } from "./rows-model.js";
+import { Editor } from "@tiptap/core";
+//#region src/features/composites/inspector-model.d.ts
+/** Which section of the inspector shows: the document's facts, or the properties of the Baustein under the caret. */
+export type CompositeInspectorSection = 'document' | 'composite';
+/** A kind the Baustein can be switched to, as the kind select lists it. */
+export interface CompositeKindOption {
+  value: string;
+  label: string;
+  icon: string;
+}
+/** Everything the inspector renders (see `createCompositeInspector`): the live rows plus the inspector's own state. */
+export interface CompositeInspectorState extends CompositeRowsState {
+  /** `'composite'` only while the caret last was in the editor and a Baustein is focused, else `'document'`. */
+  section: CompositeInspectorSection;
+  /** Whether the editor accepts edits; follows `setEditable` (see `createCompositeInspector`). */
+  editable: boolean;
+  /** The description text as the user sees it in the focused Baustein's textarea; may be ahead of the document until it is committed. */
+  draft: string;
+  /** The text typed into the tag search. */
+  searchTerm: string;
+  /** Tag names the metadata source suggested for the latest search that was not superseded. */
+  tagItems: string[];
+  /** The kinds the editor was configured with, in configured order; empty without an editor. */
+  kindOptions: CompositeKindOption[];
+  /** How many Bausteine have a description. */
+  summarized: number;
+  /** The focused Baustein has a description. */
+  hasSummary: boolean;
+}
+/** The inspector model of an editor: observable `state`, the actions of the panel, and `dispose()`. */
+export interface CompositeInspector {
+  readonly state: ReadonlyStore<CompositeInspectorState>;
+  /**
+   * Reports whether the host's document-level input (its title field) has the focus. Only the rising edge switches
+   * the section to `'document'`; the section stays there after the input blurs, until the editor takes the focus.
+   */
+  setDocumentFocused: (focused: boolean) => void;
+  /** Switches the focused Baustein to `kind`; ignored when it already has it or no Baustein is focused. */
+  setKind: (kind: string) => void;
+  /**
+   * The user typed `text` into the description. The draft is written to the document 600 ms after the last call and
+   * on `blurDescription`; the Baustein focused at the first call of a pending draft is the one that is written.
+   */
+  inputDescription: (text: string) => void;
+  /**
+   * The description textarea lost focus: writes the pending draft, then shows what the document holds. The draft
+   * shows the normalized text after a write; after a refused write (a peer changed the description since the draft
+   * started) it shows the peer's text.
+   */
+  blurDescription: () => void;
+  /** Replaces the tags of the focused Baustein. */
+  setTags: (tags: readonly string[]) => void;
+  /** Creates the tag `raw` (normalized) on the focused Baustein and registers it with the metadata source; clears the search term. */
+  createTag: (raw: string) => void;
+  /** Sets the tag search term and schedules a search for it. */
+  setSearchTerm: (term: string) => void;
+  /** Schedules a tag search for the current term (the picker opened). */
+  searchTags: () => void;
+  /** Writes `value` to the meta `field` of the focused Baustein; ignored while the editor is not editable. */
+  setField: (field: CompositeMetaField, value: unknown) => void;
+  /** Commits a pending description draft and detaches from the editor. Idempotent; the model is inert afterwards. */
+  dispose: () => void;
+}
+/** The text of `field` in `row`'s meta as an input shows it: strings and numbers, otherwise empty. */
+export declare function compositeFieldText(row: Pick<CompositeRow, 'meta'> | null, field: Pick<CompositeMetaField, 'key'>): string;
+/**
+ * The properties panel of `editor`: which section shows, the focused Baustein's description draft, the tag search
+ * and the writes. Owns its own `createCompositeRows(editor)`, so a focus change and the rows it refers to arrive in
+ * one notification and the draft is committed before it is replaced. Create one model per editor (a framework hook
+ * follows an editor that changes); without an editor the state is empty and every action is ignored.
+ *
+ * Section: the caret is either in the host's input (`setDocumentFocused`) or in the editor. Only the editor's `focus`
+ * event moves it to the editor (not `selectionUpdate`: collaboration sync moves the selection while the host's input
+ * has the focus). A deleted Baustein falls back to the document section.
+ *
+ * `isEditable` is not reactive: `editable` follows it on every editor `transaction`, so whoever calls `setEditable`
+ * must dispatch a transaction afterwards (`EditorSurface` does).
+ *
+ * Description: edits go to a local `draft` so the asynchronous re-read of the document never overwrites the text
+ * (and moves the caret) while it is typed. `base` is the document text the draft started from; the write lands only
+ * while the description still holds it, so a peer's change made meanwhile is never replaced. The draft is committed
+ * 600 ms after typing pauses, on blur, when another Baustein takes the focus (before the draft is replaced), when
+ * the panel leaves the Baustein section, and on `dispose()`. A commit is skipped when the editor is destroyed or not
+ * editable, and refused when a peer changed the description; the draft then reloads the live text. A draft that is
+ * not dirty follows every change of the focused description.
+ *
+ * Tag search: each term change restarts a 150 ms debounce; when it fires, the previous search is aborted and the
+ * source is asked with a fresh `AbortSignal`. Results of aborted searches are dropped, errors of aborted searches
+ * are silent, other errors are logged and keep the old suggestions.
+ */
+export declare function createCompositeInspector(editor: Editor | undefined): CompositeInspector;
+//#endregion
+//# sourceMappingURL=inspector-model.d.ts.map

package/dist/features/composites/inspector-model.js

@@ -0,0 +1,255 @@
+import { createStore } from "../../core/store.js";
+import { metadataOf } from "../../core/metadata.js";
+import { METADATA_LIST } from "../../core/metadata-types.js";
+import { compositeKindsOf } from "./nodes.js";
+import { compositeDescriptionText, compositeOfRow, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
+import { normalizeTagName } from "../../core/tag-name.js";
+import { createCompositeRows } from "./rows-model.js";
+//#region src/features/composites/inspector-model.ts
+/** Pause after the last keystroke in the description before the draft is written to the document. */
+const COMMIT_DELAY_MS = 600;
+/** Pause after the last change of the tag search term before the metadata source is asked. */
+const SEARCH_DELAY_MS = 150;
+/** The text of `field` in `row`'s meta as an input shows it: strings and numbers, otherwise empty. */
+function compositeFieldText(row, field) {
+	const value = row?.meta[field.key];
+	return typeof value === "string" || typeof value === "number" ? String(value) : "";
+}
+function sameState(a, b) {
+	return Object.keys(a).every((key) => Object.is(a[key], b[key]));
+}
+/**
+* The properties panel of `editor`: which section shows, the focused Baustein's description draft, the tag search
+* and the writes. Owns its own `createCompositeRows(editor)`, so a focus change and the rows it refers to arrive in
+* one notification and the draft is committed before it is replaced. Create one model per editor (a framework hook
+* follows an editor that changes); without an editor the state is empty and every action is ignored.
+*
+* Section: the caret is either in the host's input (`setDocumentFocused`) or in the editor. Only the editor's `focus`
+* event moves it to the editor (not `selectionUpdate`: collaboration sync moves the selection while the host's input
+* has the focus). A deleted Baustein falls back to the document section.
+*
+* `isEditable` is not reactive: `editable` follows it on every editor `transaction`, so whoever calls `setEditable`
+* must dispatch a transaction afterwards (`EditorSurface` does).
+*
+* Description: edits go to a local `draft` so the asynchronous re-read of the document never overwrites the text
+* (and moves the caret) while it is typed. `base` is the document text the draft started from; the write lands only
+* while the description still holds it, so a peer's change made meanwhile is never replaced. The draft is committed
+* 600 ms after typing pauses, on blur, when another Baustein takes the focus (before the draft is replaced), when
+* the panel leaves the Baustein section, and on `dispose()`. A commit is skipped when the editor is destroyed or not
+* editable, and refused when a peer changed the description; the draft then reloads the live text. A draft that is
+* not dirty follows every change of the focused description.
+*
+* Tag search: each term change restarts a 150 ms debounce; when it fires, the previous search is aborted and the
+* source is asked with a fresh `AbortSignal`. Results of aborted searches are dropped, errors of aborted searches
+* are silent, other errors are logged and keep the old suggestions.
+*/
+function createCompositeInspector(editor) {
+	const rows = createCompositeRows(editor);
+	const kindOptions = editor && !editor.isDestroyed ? compositeKindsOf(editor).map((kind) => ({
+		value: kind.id,
+		label: kind.label,
+		icon: kind.icon
+	})) : [];
+	const isEditable = () => !!editor && !editor.isDestroyed && editor.isEditable;
+	const focusedRow = () => rows.state.get().focused;
+	let disposed = false;
+	let caretIn = "document";
+	let documentFocused = false;
+	let section = "document";
+	let editable = isEditable();
+	let draft = "";
+	let base = "";
+	let dirty = false;
+	let pendingRow = null;
+	let commitTimer;
+	let focusKey = focusedRow()?.key;
+	let focusDescription = focusedRow()?.description;
+	let searchTerm = "";
+	let tagItems = [];
+	let searchTimer;
+	let pendingSearch;
+	let summarizedRows;
+	let summarized = 0;
+	const store = createStore(snapshot());
+	function snapshot() {
+		const read = rows.state.get();
+		if (read.rows !== summarizedRows) {
+			summarizedRows = read.rows;
+			summarized = read.rows.filter((row) => row.description.trim()).length;
+		}
+		return {
+			...read,
+			section,
+			editable,
+			draft,
+			searchTerm,
+			tagItems,
+			kindOptions,
+			summarized,
+			hasSummary: !!read.focused?.description.trim()
+		};
+	}
+	function publish() {
+		const next = snapshot();
+		if (!sameState(store.get(), next)) store.set(next);
+	}
+	function load() {
+		dirty = false;
+		pendingRow = null;
+		base = focusedRow()?.description ?? "";
+		draft = base;
+	}
+	/** Writes the pending draft; `false` when there was nothing to write or the write was refused. Does not touch `draft`. */
+	function commit() {
+		clearTimeout(commitTimer);
+		if (!dirty || !pendingRow) return false;
+		dirty = false;
+		const row = pendingRow;
+		pendingRow = null;
+		if (!editor || editor.isDestroyed || !editor.isEditable) return false;
+		if (!setCompositeDescription(editor, row, draft, base)) return false;
+		base = compositeDescriptionText(draft);
+		return true;
+	}
+	function refreshSection() {
+		const next = caretIn === "editor" && focusedRow() ? "composite" : "document";
+		if (section === "composite" && next !== "composite") commit();
+		section = next;
+	}
+	function followRows() {
+		const focused = focusedRow();
+		const key = focused?.key;
+		const description = focused?.description;
+		if (key !== focusKey) {
+			focusKey = key;
+			focusDescription = description;
+			commit();
+			load();
+		} else if (description !== focusDescription) {
+			focusDescription = description;
+			if (dirty) {
+				if (description !== base && !commit()) load();
+			} else if (description !== base) load();
+		}
+		refreshSection();
+		publish();
+	}
+	function scheduleSearch() {
+		clearTimeout(searchTimer);
+		searchTimer = setTimeout(async () => {
+			if (!editor || editor.isDestroyed) return;
+			pendingSearch?.abort();
+			const controller = pendingSearch = new AbortController();
+			try {
+				const found = await metadataOf(editor).search(METADATA_LIST.hashtags, {
+					query: searchTerm,
+					editor,
+					signal: controller.signal
+				});
+				if (controller.signal.aborted) return;
+				tagItems = found.map((item) => item.label);
+				publish();
+			} catch (error) {
+				if (!controller.signal.aborted) console.warn("Tag-Vorschläge konnten nicht geladen werden", error);
+			}
+		}, SEARCH_DELAY_MS);
+	}
+	function setSearchTerm(term) {
+		if (disposed || term === searchTerm) return;
+		searchTerm = term;
+		scheduleSearch();
+		publish();
+	}
+	const syncEditable = () => {
+		const next = isEditable();
+		if (next === editable) return;
+		editable = next;
+		publish();
+	};
+	const toEditor = () => {
+		caretIn = "editor";
+		refreshSection();
+		publish();
+	};
+	load();
+	refreshSection();
+	const stopRows = rows.state.subscribe(followRows);
+	if (editor && !editor.isDestroyed) {
+		editor.on("transaction", syncEditable);
+		editor.on("focus", toEditor);
+	}
+	publish();
+	return {
+		state: store,
+		setDocumentFocused(focused) {
+			if (disposed) return;
+			const rising = focused && !documentFocused;
+			documentFocused = focused;
+			if (!rising) return;
+			caretIn = "document";
+			refreshSection();
+			publish();
+		},
+		setKind(kind) {
+			const row = focusedRow();
+			const found = editor && row ? compositeOfRow(editor.state.doc, row) : null;
+			if (!editor || !found || kind === row?.kind) return;
+			editor.commands.setCompositeKind(kind, found.pos);
+		},
+		inputDescription(text) {
+			if (disposed) return;
+			draft = text;
+			dirty = true;
+			pendingRow ??= focusedRow();
+			clearTimeout(commitTimer);
+			commitTimer = setTimeout(commit, COMMIT_DELAY_MS);
+			publish();
+		},
+		blurDescription() {
+			if (disposed) return;
+			if (commit()) draft = base;
+			else load();
+			publish();
+		},
+		setTags(tags) {
+			const row = focusedRow();
+			if (editor && row) setCompositeTags(editor, row, tags);
+		},
+		createTag(raw) {
+			const row = focusedRow();
+			const name = normalizeTagName(raw);
+			setSearchTerm("");
+			if (!editor || !row || !name || row.tags.includes(name)) return;
+			setCompositeTags(editor, row, [...row.tags, name]);
+			if (!tagItems.includes(name)) metadataOf(editor).create(METADATA_LIST.hashtags, {
+				id: name,
+				label: name
+			});
+		},
+		setSearchTerm,
+		searchTags() {
+			if (!disposed) scheduleSearch();
+		},
+		setField(field, value) {
+			const row = focusedRow();
+			if (editor && isEditable() && row) setCompositeMetaField(editor, row, field.key, value);
+		},
+		dispose() {
+			if (disposed) return;
+			commit();
+			disposed = true;
+			clearTimeout(searchTimer);
+			pendingSearch?.abort();
+			stopRows();
+			if (editor && !editor.isDestroyed) {
+				editor.off("transaction", syncEditable);
+				editor.off("focus", toEditor);
+			}
+			rows.dispose();
+		}
+	};
+}
+//#endregion
+export { compositeFieldText, createCompositeInspector };
+
+//# sourceMappingURL=inspector-model.js.map

package/dist/features/composites/inspector-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-model.js","names":[],"sources":["../../../src/features/composites/inspector-model.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { metadataOf } from '../../core/metadata'\nimport { METADATA_LIST } from '../../core/metadata-types'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport { normalizeTagName } from '../../core/tag-name'\nimport type { CompositeMetaField } from './kinds'\nimport { compositeKindsOf } from './nodes'\nimport { compositeDescriptionText, compositeOfRow, type CompositeRow, setCompositeDescription, setCompositeMetaField, setCompositeTags } from './rows'\nimport { type CompositeRowsState, createCompositeRows } from './rows-model'\n\n/** Pause after the last keystroke in the description before the draft is written to the document. */\nconst COMMIT_DELAY_MS = 600\n/** Pause after the last change of the tag search term before the metadata source is asked. */\nconst SEARCH_DELAY_MS = 150\n\n/** Which section of the inspector shows: the document's facts, or the properties of the Baustein under the caret. */\nexport type CompositeInspectorSection = 'document' | 'composite'\n\n/** A kind the Baustein can be switched to, as the kind select lists it. */\nexport interface CompositeKindOption {\n  value: string\n  label: string\n  icon: string\n}\n\n/** Everything the inspector renders (see `createCompositeInspector`): the live rows plus the inspector's own state. */\nexport interface CompositeInspectorState extends CompositeRowsState {\n  /** `'composite'` only while the caret last was in the editor and a Baustein is focused, else `'document'`. */\n  section: CompositeInspectorSection\n  /** Whether the editor accepts edits; follows `setEditable` (see `createCompositeInspector`). */\n  editable: boolean\n  /** The description text as the user sees it in the focused Baustein's textarea; may be ahead of the document until it is committed. */\n  draft: string\n  /** The text typed into the tag search. */\n  searchTerm: string\n  /** Tag names the metadata source suggested for the latest search that was not superseded. */\n  tagItems: string[]\n  /** The kinds the editor was configured with, in configured order; empty without an editor. */\n  kindOptions: CompositeKindOption[]\n  /** How many Bausteine have a description. */\n  summarized: number\n  /** The focused Baustein has a description. */\n  hasSummary: boolean\n}\n\n/** The inspector model of an editor: observable `state`, the actions of the panel, and `dispose()`. */\nexport interface CompositeInspector {\n  readonly state: ReadonlyStore<CompositeInspectorState>\n  /**\n   * Reports whether the host's document-level input (its title field) has the focus. Only the rising edge switches\n   * the section to `'document'`; the section stays there after the input blurs, until the editor takes the focus.\n   */\n  setDocumentFocused: (focused: boolean) => void\n  /** Switches the focused Baustein to `kind`; ignored when it already has it or no Baustein is focused. */\n  setKind: (kind: string) => void\n  /**\n   * The user typed `text` into the description. The draft is written to the document 600 ms after the last call and\n   * on `blurDescription`; the Baustein focused at the first call of a pending draft is the one that is written.\n   */\n  inputDescription: (text: string) => void\n  /**\n   * The description textarea lost focus: writes the pending draft, then shows what the document holds. The draft\n   * shows the normalized text after a write; after a refused write (a peer changed the description since the draft\n   * started) it shows the peer's text.\n   */\n  blurDescription: () => void\n  /** Replaces the tags of the focused Baustein. */\n  setTags: (tags: readonly string[]) => void\n  /** Creates the tag `raw` (normalized) on the focused Baustein and registers it with the metadata source; clears the search term. */\n  createTag: (raw: string) => void\n  /** Sets the tag search term and schedules a search for it. */\n  setSearchTerm: (term: string) => void\n  /** Schedules a tag search for the current term (the picker opened). */\n  searchTags: () => void\n  /** Writes `value` to the meta `field` of the focused Baustein; ignored while the editor is not editable. */\n  setField: (field: CompositeMetaField, value: unknown) => void\n  /** Commits a pending description draft and detaches from the editor. Idempotent; the model is inert afterwards. */\n  dispose: () => void\n}\n\n/** The text of `field` in `row`'s meta as an input shows it: strings and numbers, otherwise empty. */\nexport function compositeFieldText(row: Pick<CompositeRow, 'meta'> | null, field: Pick<CompositeMetaField, 'key'>): string {\n  const value = row?.meta[field.key]\n  return typeof value === 'string' || typeof value === 'number' ? String(value) : ''\n}\n\nfunction sameState(a: CompositeInspectorState, b: CompositeInspectorState): boolean {\n  return (Object.keys(a) as (keyof CompositeInspectorState)[]).every(key => Object.is(a[key], b[key]))\n}\n\n/**\n * The properties panel of `editor`: which section shows, the focused Baustein's description draft, the tag search\n * and the writes. Owns its own `createCompositeRows(editor)`, so a focus change and the rows it refers to arrive in\n * one notification and the draft is committed before it is replaced. Create one model per editor (a framework hook\n * follows an editor that changes); without an editor the state is empty and every action is ignored.\n *\n * Section: the caret is either in the host's input (`setDocumentFocused`) or in the editor. Only the editor's `focus`\n * event moves it to the editor (not `selectionUpdate`: collaboration sync moves the selection while the host's input\n * has the focus). A deleted Baustein falls back to the document section.\n *\n * `isEditable` is not reactive: `editable` follows it on every editor `transaction`, so whoever calls `setEditable`\n * must dispatch a transaction afterwards (`EditorSurface` does).\n *\n * Description: edits go to a local `draft` so the asynchronous re-read of the document never overwrites the text\n * (and moves the caret) while it is typed. `base` is the document text the draft started from; the write lands only\n * while the description still holds it, so a peer's change made meanwhile is never replaced. The draft is committed\n * 600 ms after typing pauses, on blur, when another Baustein takes the focus (before the draft is replaced), when\n * the panel leaves the Baustein section, and on `dispose()`. A commit is skipped when the editor is destroyed or not\n * editable, and refused when a peer changed the description; the draft then reloads the live text. A draft that is\n * not dirty follows every change of the focused description.\n *\n * Tag search: each term change restarts a 150 ms debounce; when it fires, the previous search is aborted and the\n * source is asked with a fresh `AbortSignal`. Results of aborted searches are dropped, errors of aborted searches\n * are silent, other errors are logged and keep the old suggestions.\n */\nexport function createCompositeInspector(editor: Editor | undefined): CompositeInspector {\n  const rows = createCompositeRows(editor)\n  const kindOptions: CompositeKindOption[] = editor && !editor.isDestroyed\n    ? compositeKindsOf(editor).map(kind => ({ value: kind.id, label: kind.label, icon: kind.icon }))\n    : []\n  const isEditable = () => !!editor && !editor.isDestroyed && editor.isEditable\n  const focusedRow = () => rows.state.get().focused\n\n  let disposed = false\n\n  // --- Section ---\n  let caretIn: 'document' | 'editor' = 'document'\n  let documentFocused = false\n  let section: CompositeInspectorSection = 'document'\n  let editable = isEditable()\n\n  // --- Description draft ---\n  let draft = ''\n  let base = ''\n  let dirty = false\n  let pendingRow: CompositeRow | null = null\n  let commitTimer: ReturnType<typeof setTimeout> | undefined\n  // What the focused Baustein looked like at the last rows notification: a change of the key is a switch, a change of the description a peer's (or our own) write.\n  let focusKey = focusedRow()?.key\n  let focusDescription = focusedRow()?.description\n\n  // --- Tag search ---\n  let searchTerm = ''\n  let tagItems: string[] = []\n  let searchTimer: ReturnType<typeof setTimeout> | undefined\n  let pendingSearch: AbortController | undefined\n\n  let summarizedRows: CompositeRowsState['rows'] | undefined\n  let summarized = 0\n  const store = createStore<CompositeInspectorState>(snapshot())\n\n  function snapshot(): CompositeInspectorState {\n    const read = rows.state.get()\n    if (read.rows !== summarizedRows) {\n      summarizedRows = read.rows\n      summarized = read.rows.filter(row => row.description.trim()).length\n    }\n    return {\n      ...read,\n      section,\n      editable,\n      draft,\n      searchTerm,\n      tagItems,\n      kindOptions,\n      summarized,\n      hasSummary: !!read.focused?.description.trim(),\n    }\n  }\n\n  function publish() {\n    const next = snapshot()\n    if (!sameState(store.get(), next)) store.set(next)\n  }\n\n  function load() {\n    dirty = false\n    pendingRow = null\n    base = focusedRow()?.description ?? ''\n    draft = base\n  }\n\n  /** Writes the pending draft; `false` when there was nothing to write or the write was refused. Does not touch `draft`. */\n  function commit(): boolean {\n    clearTimeout(commitTimer)\n    if (!dirty || !pendingRow) return false\n    dirty = false\n    const row = pendingRow\n    pendingRow = null\n    if (!editor || editor.isDestroyed || !editor.isEditable) return false\n    if (!setCompositeDescription(editor, row, draft, base)) return false\n    base = compositeDescriptionText(draft)\n    return true\n  }\n\n  function refreshSection() {\n    const next = caretIn === 'editor' && focusedRow() ? 'composite' : 'document'\n    if (section === 'composite' && next !== 'composite') commit()\n    section = next\n  }\n\n  // A switch commits the draft of the previous Baustein first (`draft` still holds its text), then loads the new one.\n  // A change of the description reaches an untouched draft, also while the textarea has focus. A draft with unsaved\n  // typing keeps it; if a peer changed the description meanwhile, its commit is refused and the peer's text is\n  // loaded instead.\n  function followRows() {\n    const focused = focusedRow()\n    const key = focused?.key\n    const description = focused?.description\n    if (key !== focusKey) {\n      focusKey = key\n      focusDescription = description\n      commit()\n      load()\n    }\n    else if (description !== focusDescription) {\n      focusDescription = description\n      if (dirty) {\n        if (description !== base && !commit()) load()\n      }\n      else if (description !== base) {\n        load()\n      }\n    }\n    refreshSection()\n    publish()\n  }\n\n  function scheduleSearch() {\n    clearTimeout(searchTimer)\n    searchTimer = setTimeout(async () => {\n      if (!editor || editor.isDestroyed) return\n      pendingSearch?.abort()\n      const controller = pendingSearch = new AbortController()\n      try {\n        const found = await metadataOf(editor).search(METADATA_LIST.hashtags, { query: searchTerm, editor, signal: controller.signal })\n        if (controller.signal.aborted) return\n        tagItems = found.map(item => item.label)\n        publish()\n      }\n      catch (error) {\n        if (!controller.signal.aborted) console.warn('Tag-Vorschläge konnten nicht geladen werden', error)\n      }\n    }, SEARCH_DELAY_MS)\n  }\n\n  function setSearchTerm(term: string) {\n    if (disposed || term === searchTerm) return\n    searchTerm = term\n    scheduleSearch()\n    publish()\n  }\n\n  const syncEditable = () => {\n    const next = isEditable()\n    if (next === editable) return\n    editable = next\n    publish()\n  }\n  const toEditor = () => {\n    caretIn = 'editor'\n    refreshSection()\n    publish()\n  }\n\n  load()\n  refreshSection()\n  const stopRows = rows.state.subscribe(followRows)\n  if (editor && !editor.isDestroyed) {\n    editor.on('transaction', syncEditable)\n    // Only `focus`, not `selectionUpdate`: a collaboration sync can move the selection while the host's input has the focus.\n    editor.on('focus', toEditor)\n  }\n  publish()\n\n  return {\n    state: store,\n\n    setDocumentFocused(focused) {\n      if (disposed) return\n      const rising = focused && !documentFocused\n      documentFocused = focused\n      if (!rising) return\n      caretIn = 'document'\n      refreshSection()\n      publish()\n    },\n\n    setKind(kind) {\n      const row = focusedRow()\n      const found = editor && row ? compositeOfRow(editor.state.doc, row) : null\n      if (!editor || !found || kind === row?.kind) return\n      editor.commands.setCompositeKind(kind, found.pos)\n    },\n\n    inputDescription(text) {\n      if (disposed) return\n      draft = text\n      dirty = true\n      pendingRow ??= focusedRow()\n      clearTimeout(commitTimer)\n      commitTimer = setTimeout(commit, COMMIT_DELAY_MS)\n      publish()\n    },\n\n    blurDescription() {\n      if (disposed) return\n      if (commit()) draft = base\n      else load()\n      publish()\n    },\n\n    setTags(tags) {\n      const row = focusedRow()\n      if (editor && row) setCompositeTags(editor, row, tags)\n    },\n\n    // „Neu Tag“ → `neu-tag`. A name that normalizes to an already chosen tag is ignored; only unknown names are reported as created.\n    createTag(raw) {\n      const row = focusedRow()\n      const name = normalizeTagName(raw)\n      setSearchTerm('')\n      if (!editor || !row || !name || row.tags.includes(name)) return\n      setCompositeTags(editor, row, [...row.tags, name])\n      if (!tagItems.includes(name)) metadataOf(editor).create(METADATA_LIST.hashtags, { id: name, label: name })\n    },\n\n    setSearchTerm,\n\n    searchTags() {\n      if (!disposed) scheduleSearch()\n    },\n\n    setField(field, value) {\n      const row = focusedRow()\n      if (editor && isEditable() && row) setCompositeMetaField(editor, row, field.key, value)\n    },\n\n    dispose() {\n      if (disposed) return\n      commit()\n      disposed = true\n      clearTimeout(searchTimer)\n      pendingSearch?.abort()\n      stopRows()\n      if (editor && !editor.isDestroyed) {\n        editor.off('transaction', syncEditable)\n        editor.off('focus', toEditor)\n      }\n      rows.dispose()\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/features/composites/kinds.d.ts

@@ -35,6 +35,12 @@ export interface CompositeKind {
   fields: CompositeMetaField[];
   /** Absent: the kind has no AI brief; „Baustein füllen (KI)“ is not offered for it. */
   ai?: CompositeKindAi;
+  /**
+   * Baustein kinds this kind accepts as nested Bausteine: a list of kind ids, or `'all'`. Absent: `folder` and `document`
+   * accept `'all'`, every other kind accepts none. Non-Baustein content (paragraphs, lists, ...) is always allowed.
+   * Only new moves are checked; documents that already nest against it stay as they are.
+   */
+  accepts?: readonly string[] | 'all';
 }
 /**
  * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field
@@ -45,5 +51,10 @@ export interface CompositeKind {
 export declare function defaultCompositeKinds(t: Translate): readonly CompositeKind[];
 /** Kind `id` from `kinds`; an unknown id gets the `section` kind's presentation (else the first kind's) under its own id and label. */
 export declare function compositeKind(kinds: readonly CompositeKind[], id: string): CompositeKind;
+/**
+ * Whether a Baustein of kind `parentKind` accepts one of kind `childKind` as nested Baustein. The `accepts` of the kind
+ * in `kinds` decides; without one (or for a kind `kinds` does not list) only `folder` and `document` accept all.
+ */
+export declare function kindAccepts(kinds: readonly CompositeKind[], parentKind: string, childKind: string): boolean;
 //#endregion
 //# sourceMappingURL=kinds.d.ts.map

package/dist/features/composites/kinds.js

@@ -20,7 +20,8 @@ function buildDefaultKinds(t) {
 			icon: "i-lucide-layers",
 			titlePlaceholder: t("composites.kind.section.title"),
 			descriptionPlaceholder: t("composites.kind.section.description"),
-			fields: []
+			fields: [],
+			accepts: "all"
 		},
 		{
 			id: "task",
@@ -125,7 +126,21 @@ function compositeKind(kinds, id) {
 		label: id
 	};
 }
+/** Kinds that accept every Baustein kind when their definition sets no `accepts`. */
+const ACCEPTS_ALL_BY_DEFAULT = {
+	folder: true,
+	document: true
+};
+/**
+* Whether a Baustein of kind `parentKind` accepts one of kind `childKind` as nested Baustein. The `accepts` of the kind
+* in `kinds` decides; without one (or for a kind `kinds` does not list) only `folder` and `document` accept all.
+*/
+function kindAccepts(kinds, parentKind, childKind) {
+	const accepts = kinds.find((kind) => kind.id === parentKind)?.accepts;
+	if (accepts === void 0) return Object.hasOwn(ACCEPTS_ALL_BY_DEFAULT, parentKind);
+	return accepts === "all" || accepts.includes(childKind);
+}
 //#endregion
-export { compositeKind, defaultCompositeKinds, fallbackCompositeKinds };
+export { compositeKind, defaultCompositeKinds, fallbackCompositeKinds, kindAccepts };
 
 //# sourceMappingURL=kinds.js.map

package/dist/features/composites/kinds.js.map

@@ -1 +1 @@
-{"version":3,"file":"kinds.js","names":[],"sources":["../../../src/features/composites/kinds.ts"],"sourcesContent":["// Vue-free and server-importable: the kind registry of the composite block family („Bausteine“).\nimport { createTranslator, type Translate } from '../../i18n'\n\n/** One metadata field of a composite kind, stored under `key` in the composite's `meta` attribute. */\nexport interface CompositeMetaField {\n  key: string\n  label: string\n  type: 'text' | 'textarea' | 'date' | 'number' | 'select'\n  /** Choices of a `select` field. */\n  options?: { value: string, label: string }[]\n}\n\n/**\n * What a kind tells the model beyond its fields. `purpose` goes into every AI request's block model (chat, generate\n * tasks); `instructions`, `instructionsField` and `skeleton` are read only by „Baustein füllen (KI)“ (`fillComposite`).\n */\nexport interface CompositeKindAi {\n  /** One or two German sentences: what a Baustein of this kind is for and what its body holds. */\n  purpose: string\n  /** Default instruction for filling the body of a Baustein of this kind (what to write, structure, tone). */\n  instructions?: string\n  /** Key of a `textarea` field of this kind; a Baustein whose value is non-empty replaces `instructions` with it. */\n  instructionsField?: string\n  /** Target text (Vorlage) as Markdown; `{key}` placeholders are replaced by the Baustein's `meta[key]` before it goes to the model, unknown ones stay. */\n  skeleton?: string\n}\n\n/** A composite kind: what its `kind` attribute selects (label, icon, chrome placeholders, meta fields). */\nexport interface CompositeKind {\n  id: string\n  label: string\n  icon: string\n  titlePlaceholder: string\n  descriptionPlaceholder: string\n  fields: CompositeMetaField[]\n  /** Absent: the kind has no AI brief; „Baustein füllen (KI)“ is not offered for it. */\n  ai?: CompositeKindAi\n}\n\n/**\n * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field\n * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own\n * kinds (`compositeFeature({ kinds })`, `Composite.configure({ kinds })`) keep their labels untouched. Ids, field keys and\n * stored values (`open`, `doing`, `done`) do not depend on the language.\n */\nexport function defaultCompositeKinds(t: Translate): readonly CompositeKind[] {\n  let kinds = DEFAULT_KINDS.get(t)\n  if (!kinds) DEFAULT_KINDS.set(t, kinds = buildDefaultKinds(t))\n  return kinds\n}\n\nconst DEFAULT_KINDS = new WeakMap<Translate, readonly CompositeKind[]>()\n\nfunction buildDefaultKinds(t: Translate): readonly CompositeKind[] {\n  return [\n    { id: 'section', label: t('composites.kind.section.label'), icon: 'i-lucide-layers', titlePlaceholder: t('composites.kind.section.title'), descriptionPlaceholder: t('composites.kind.section.description'), fields: [] },\n    { id: 'task', label: t('composites.kind.task.label'), icon: 'i-lucide-square-check', titlePlaceholder: t('composites.kind.task.title'), descriptionPlaceholder: t('composites.kind.task.description'), fields: [\n      { key: 'status', label: t('composites.kind.task.field.status'), type: 'select', options: [\n        { value: 'open', label: t('composites.kind.task.status.open') },\n        { value: 'doing', label: t('composites.kind.task.status.doing') },\n        { value: 'done', label: t('composites.kind.task.status.done') },\n      ] },\n      { key: 'due', label: t('composites.kind.task.field.due'), type: 'date' },\n      { key: 'assignee', label: t('composites.kind.task.field.assignee'), type: 'text' },\n    ] },\n    { id: 'note', label: t('composites.kind.note.label'), icon: 'i-lucide-sticky-note', titlePlaceholder: t('composites.kind.note.title'), descriptionPlaceholder: t('composites.kind.note.description'), fields: [] },\n    { id: 'document', label: t('composites.kind.document.label'), icon: 'i-lucide-file-text', titlePlaceholder: t('composites.kind.document.title'), descriptionPlaceholder: t('composites.kind.document.description'), fields: [\n      { key: 'filename', label: t('composites.kind.document.field.filename'), type: 'text' },\n      { key: 'mimeType', label: t('composites.kind.document.field.mimeType'), type: 'text' },\n      { key: 'size', label: t('composites.kind.document.field.size'), type: 'number' },\n      { key: 'importedAt', label: t('composites.kind.document.field.importedAt'), type: 'date' },\n      { key: 'transcript', label: t('composites.kind.document.field.transcript'), type: 'textarea' },\n    ] },\n    { id: 'folder', label: t('composites.kind.folder.label'), icon: 'i-lucide-folder', titlePlaceholder: t('composites.kind.folder.title'), descriptionPlaceholder: t('composites.kind.folder.description'), fields: [] },\n  ]\n}\n\n/** The built-in kinds in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */\nexport const fallbackCompositeKinds = (): readonly CompositeKind[] => defaultCompositeKinds(DEFAULT_TRANSLATE)\n\nconst DEFAULT_TRANSLATE = createTranslator()\n\n/** Kind `id` from `kinds`; an unknown id gets the `section` kind's presentation (else the first kind's) under its own id and label. */\nexport function compositeKind(kinds: readonly CompositeKind[], id: string): CompositeKind {\n  const known = kinds.find(kind => kind.id === id)\n  if (known) return known\n  const base = kinds.find(kind => kind.id === 'section') ?? kinds[0] ?? fallbackCompositeKinds()[0]!\n  return { ...base, id, label: id }\n}\n"],"mappings":";;;;;;;;AA6CA,SAAgB,sBAAsB,GAAwC;CAC5E,IAAI,QAAQ,cAAc,IAAI,CAAC;CAC/B,IAAI,CAAC,OAAO,cAAc,IAAI,GAAG,QAAQ,kBAAkB,CAAC,CAAC;CAC7D,OAAO;AACT;AAEA,MAAM,gCAAgB,IAAI,QAA6C;AAEvE,SAAS,kBAAkB,GAAwC;CACjE,OAAO;EACL;GAAE,IAAI;GAAW,OAAO,EAAE,+BAA+B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,+BAA+B;GAAG,wBAAwB,EAAE,qCAAqC;GAAG,QAAQ,CAAC;EAAE;EACxN;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAyB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ;IAC7M;KAAE,KAAK;KAAU,OAAO,EAAE,mCAAmC;KAAG,MAAM;KAAU,SAAS;MACvF;OAAE,OAAO;OAAQ,OAAO,EAAE,kCAAkC;MAAE;MAC9D;OAAE,OAAO;OAAS,OAAO,EAAE,mCAAmC;MAAE;MAChE;OAAE,OAAO;OAAQ,OAAO,EAAE,kCAAkC;MAAE;KAChE;IAAE;IACF;KAAE,KAAK;KAAO,OAAO,EAAE,gCAAgC;KAAG,MAAM;IAAO;IACvE;KAAE,KAAK;KAAY,OAAO,EAAE,qCAAqC;KAAG,MAAM;IAAO;GACnF;EAAE;EACF;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAwB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ,CAAC;EAAE;EACjN;GAAE,IAAI;GAAY,OAAO,EAAE,gCAAgC;GAAG,MAAM;GAAsB,kBAAkB,EAAE,gCAAgC;GAAG,wBAAwB,EAAE,sCAAsC;GAAG,QAAQ;IAC1N;KAAE,KAAK;KAAY,OAAO,EAAE,yCAAyC;KAAG,MAAM;IAAO;IACrF;KAAE,KAAK;KAAY,OAAO,EAAE,yCAAyC;KAAG,MAAM;IAAO;IACrF;KAAE,KAAK;KAAQ,OAAO,EAAE,qCAAqC;KAAG,MAAM;IAAS;IAC/E;KAAE,KAAK;KAAc,OAAO,EAAE,2CAA2C;KAAG,MAAM;IAAO;IACzF;KAAE,KAAK;KAAc,OAAO,EAAE,2CAA2C;KAAG,MAAM;IAAW;GAC/F;EAAE;EACF;GAAE,IAAI;GAAU,OAAO,EAAE,8BAA8B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,8BAA8B;GAAG,wBAAwB,EAAE,oCAAoC;GAAG,QAAQ,CAAC;EAAE;CACtN;AACF;;AAGA,MAAa,+BAAyD,sBAAsB,iBAAiB;AAE7G,MAAM,oBAAoB,iBAAiB;;AAG3C,SAAgB,cAAc,OAAiC,IAA2B;CACxF,MAAM,QAAQ,MAAM,MAAK,SAAQ,KAAK,OAAO,EAAE;CAC/C,IAAI,OAAO,OAAO;CAElB,OAAO;EAAE,GADI,MAAM,MAAK,SAAQ,KAAK,OAAO,SAAS,KAAK,MAAM,MAAM,uBAAuB,CAAC,CAAC;EAC7E;EAAI,OAAO;CAAG;AAClC"}
+{"version":3,"file":"kinds.js","names":[],"sources":["../../../src/features/composites/kinds.ts"],"sourcesContent":["// Vue-free and server-importable: the kind registry of the composite block family („Bausteine“).\nimport { createTranslator, type Translate } from '../../i18n'\n\n/** One metadata field of a composite kind, stored under `key` in the composite's `meta` attribute. */\nexport interface CompositeMetaField {\n  key: string\n  label: string\n  type: 'text' | 'textarea' | 'date' | 'number' | 'select'\n  /** Choices of a `select` field. */\n  options?: { value: string, label: string }[]\n}\n\n/**\n * What a kind tells the model beyond its fields. `purpose` goes into every AI request's block model (chat, generate\n * tasks); `instructions`, `instructionsField` and `skeleton` are read only by „Baustein füllen (KI)“ (`fillComposite`).\n */\nexport interface CompositeKindAi {\n  /** One or two German sentences: what a Baustein of this kind is for and what its body holds. */\n  purpose: string\n  /** Default instruction for filling the body of a Baustein of this kind (what to write, structure, tone). */\n  instructions?: string\n  /** Key of a `textarea` field of this kind; a Baustein whose value is non-empty replaces `instructions` with it. */\n  instructionsField?: string\n  /** Target text (Vorlage) as Markdown; `{key}` placeholders are replaced by the Baustein's `meta[key]` before it goes to the model, unknown ones stay. */\n  skeleton?: string\n}\n\n/** A composite kind: what its `kind` attribute selects (label, icon, chrome placeholders, meta fields). */\nexport interface CompositeKind {\n  id: string\n  label: string\n  icon: string\n  titlePlaceholder: string\n  descriptionPlaceholder: string\n  fields: CompositeMetaField[]\n  /** Absent: the kind has no AI brief; „Baustein füllen (KI)“ is not offered for it. */\n  ai?: CompositeKindAi\n  /**\n   * Baustein kinds this kind accepts as nested Bausteine: a list of kind ids, or `'all'`. Absent: `folder` and `document`\n   * accept `'all'`, every other kind accepts none. Non-Baustein content (paragraphs, lists, ...) is always allowed.\n   * Only new moves are checked; documents that already nest against it stay as they are.\n   */\n  accepts?: readonly string[] | 'all'\n}\n\n/**\n * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field\n * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own\n * kinds (`compositeFeature({ kinds })`, `Composite.configure({ kinds })`) keep their labels untouched. Ids, field keys and\n * stored values (`open`, `doing`, `done`) do not depend on the language.\n */\nexport function defaultCompositeKinds(t: Translate): readonly CompositeKind[] {\n  let kinds = DEFAULT_KINDS.get(t)\n  if (!kinds) DEFAULT_KINDS.set(t, kinds = buildDefaultKinds(t))\n  return kinds\n}\n\nconst DEFAULT_KINDS = new WeakMap<Translate, readonly CompositeKind[]>()\n\nfunction buildDefaultKinds(t: Translate): readonly CompositeKind[] {\n  return [\n    { id: 'section', label: t('composites.kind.section.label'), icon: 'i-lucide-layers', titlePlaceholder: t('composites.kind.section.title'), descriptionPlaceholder: t('composites.kind.section.description'), fields: [], accepts: 'all' },\n    { id: 'task', label: t('composites.kind.task.label'), icon: 'i-lucide-square-check', titlePlaceholder: t('composites.kind.task.title'), descriptionPlaceholder: t('composites.kind.task.description'), fields: [\n      { key: 'status', label: t('composites.kind.task.field.status'), type: 'select', options: [\n        { value: 'open', label: t('composites.kind.task.status.open') },\n        { value: 'doing', label: t('composites.kind.task.status.doing') },\n        { value: 'done', label: t('composites.kind.task.status.done') },\n      ] },\n      { key: 'due', label: t('composites.kind.task.field.due'), type: 'date' },\n      { key: 'assignee', label: t('composites.kind.task.field.assignee'), type: 'text' },\n    ] },\n    { id: 'note', label: t('composites.kind.note.label'), icon: 'i-lucide-sticky-note', titlePlaceholder: t('composites.kind.note.title'), descriptionPlaceholder: t('composites.kind.note.description'), fields: [] },\n    { id: 'document', label: t('composites.kind.document.label'), icon: 'i-lucide-file-text', titlePlaceholder: t('composites.kind.document.title'), descriptionPlaceholder: t('composites.kind.document.description'), fields: [\n      { key: 'filename', label: t('composites.kind.document.field.filename'), type: 'text' },\n      { key: 'mimeType', label: t('composites.kind.document.field.mimeType'), type: 'text' },\n      { key: 'size', label: t('composites.kind.document.field.size'), type: 'number' },\n      { key: 'importedAt', label: t('composites.kind.document.field.importedAt'), type: 'date' },\n      { key: 'transcript', label: t('composites.kind.document.field.transcript'), type: 'textarea' },\n    ] },\n    { id: 'folder', label: t('composites.kind.folder.label'), icon: 'i-lucide-folder', titlePlaceholder: t('composites.kind.folder.title'), descriptionPlaceholder: t('composites.kind.folder.description'), fields: [] },\n  ]\n}\n\n/** The built-in kinds in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */\nexport const fallbackCompositeKinds = (): readonly CompositeKind[] => defaultCompositeKinds(DEFAULT_TRANSLATE)\n\nconst DEFAULT_TRANSLATE = createTranslator()\n\n/** Kind `id` from `kinds`; an unknown id gets the `section` kind's presentation (else the first kind's) under its own id and label. */\nexport function compositeKind(kinds: readonly CompositeKind[], id: string): CompositeKind {\n  const known = kinds.find(kind => kind.id === id)\n  if (known) return known\n  const base = kinds.find(kind => kind.id === 'section') ?? kinds[0] ?? fallbackCompositeKinds()[0]!\n  return { ...base, id, label: id }\n}\n\n/** Kinds that accept every Baustein kind when their definition sets no `accepts`. */\nconst ACCEPTS_ALL_BY_DEFAULT: Record<string, true> = { folder: true, document: true }\n\n/**\n * Whether a Baustein of kind `parentKind` accepts one of kind `childKind` as nested Baustein. The `accepts` of the kind\n * in `kinds` decides; without one (or for a kind `kinds` does not list) only `folder` and `document` accept all.\n */\nexport function kindAccepts(kinds: readonly CompositeKind[], parentKind: string, childKind: string): boolean {\n  const accepts = kinds.find(kind => kind.id === parentKind)?.accepts\n  if (accepts === undefined) return Object.hasOwn(ACCEPTS_ALL_BY_DEFAULT, parentKind)\n  return accepts === 'all' || accepts.includes(childKind)\n}\n"],"mappings":";;;;;;;;AAmDA,SAAgB,sBAAsB,GAAwC;CAC5E,IAAI,QAAQ,cAAc,IAAI,CAAC;CAC/B,IAAI,CAAC,OAAO,cAAc,IAAI,GAAG,QAAQ,kBAAkB,CAAC,CAAC;CAC7D,OAAO;AACT;AAEA,MAAM,gCAAgB,IAAI,QAA6C;AAEvE,SAAS,kBAAkB,GAAwC;CACjE,OAAO;EACL;GAAE,IAAI;GAAW,OAAO,EAAE,+BAA+B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,+BAA+B;GAAG,wBAAwB,EAAE,qCAAqC;GAAG,QAAQ,CAAC;GAAG,SAAS;EAAM;EACxO;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAyB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ;IAC7M;KAAE,KAAK;KAAU,OAAO,EAAE,mCAAmC;KAAG,MAAM;KAAU,SAAS;MACvF;OAAE,OAAO;OAAQ,OAAO,EAAE,kCAAkC;MAAE;MAC9D;OAAE,OAAO;OAAS,OAAO,EAAE,mCAAmC;MAAE;MAChE;OAAE,OAAO;OAAQ,OAAO,EAAE,kCAAkC;MAAE;KAChE;IAAE;IACF;KAAE,KAAK;KAAO,OAAO,EAAE,gCAAgC;KAAG,MAAM;IAAO;IACvE;KAAE,KAAK;KAAY,OAAO,EAAE,qCAAqC;KAAG,MAAM;IAAO;GACnF;EAAE;EACF;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAwB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ,CAAC;EAAE;EACjN;GAAE,IAAI;GAAY,OAAO,EAAE,gCAAgC;GAAG,MAAM;GAAsB,kBAAkB,EAAE,gCAAgC;GAAG,wBAAwB,EAAE,sCAAsC;GAAG,QAAQ;IAC1N;KAAE,KAAK;KAAY,OAAO,EAAE,yCAAyC;KAAG,MAAM;IAAO;IACrF;KAAE,KAAK;KAAY,OAAO,EAAE,yCAAyC;KAAG,MAAM;IAAO;IACrF;KAAE,KAAK;KAAQ,OAAO,EAAE,qCAAqC;KAAG,MAAM;IAAS;IAC/E;KAAE,KAAK;KAAc,OAAO,EAAE,2CAA2C;KAAG,MAAM;IAAO;IACzF;KAAE,KAAK;KAAc,OAAO,EAAE,2CAA2C;KAAG,MAAM;IAAW;GAC/F;EAAE;EACF;GAAE,IAAI;GAAU,OAAO,EAAE,8BAA8B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,8BAA8B;GAAG,wBAAwB,EAAE,oCAAoC;GAAG,QAAQ,CAAC;EAAE;CACtN;AACF;;AAGA,MAAa,+BAAyD,sBAAsB,iBAAiB;AAE7G,MAAM,oBAAoB,iBAAiB;;AAG3C,SAAgB,cAAc,OAAiC,IAA2B;CACxF,MAAM,QAAQ,MAAM,MAAK,SAAQ,KAAK,OAAO,EAAE;CAC/C,IAAI,OAAO,OAAO;CAElB,OAAO;EAAE,GADI,MAAM,MAAK,SAAQ,KAAK,OAAO,SAAS,KAAK,MAAM,MAAM,uBAAuB,CAAC,CAAC;EAC7E;EAAI,OAAO;CAAG;AAClC;;AAGA,MAAM,yBAA+C;CAAE,QAAQ;CAAM,UAAU;AAAK;;;;;AAMpF,SAAgB,YAAY,OAAiC,YAAoB,WAA4B;CAC3G,MAAM,UAAU,MAAM,MAAK,SAAQ,KAAK,OAAO,UAAU,CAAC,EAAE;CAC5D,IAAI,YAAY,KAAA,GAAW,OAAO,OAAO,OAAO,wBAAwB,UAAU;CAClF,OAAO,YAAY,SAAS,QAAQ,SAAS,SAAS;AACxD"}

package/dist/features/composites/outline.d.ts

@@ -1,3 +1,4 @@
+import { Translate } from "../../i18n/index.js";
 import { Editor } from "@tiptap/core";
 import { Node as Node$1 } from "@tiptap/pm/model";
 //#region src/features/composites/outline.d.ts
@@ -20,15 +21,27 @@ export interface OutlineNode {
  * take their place in the parent's list.
  */
 export declare function compositeOutline(doc: Node$1, hiddenKinds: ReadonlySet<string>, untitled: string): OutlineNode[];
+/** Whether a block may move into a Baustein; `reason` is a short sentence for the UI (in the language of the `t` it was judged with) when it may not. */
+export type MoveVerdict = {
+  ok: true;
+} | {
+  ok: false;
+  reason: string;
+};
 /**
- * Whether block `id` can move into the composite `targetId` (`null` = the end of the document): both exist, the target
- * is a composite and neither the block itself nor inside it.
+ * Whether block `id` may move into the Baustein `targetId` (`null` = the end of the document), with the reason when
+ * not: a block is missing, the target is no Baustein, the target is the block itself or inside it, or the target's kind
+ * does not accept the block's kind (`CompositeKind.accepts`). A block that is no Baustein may move into any Baustein,
+ * unless it holds Bausteine of a refused kind; Bausteine nested inside a moved Baustein stay with it and are not
+ * checked. Moving a block to the end of the Baustein it already sits in adds no nesting and is never refused for it.
  */
+export declare function moveIntoVerdict(editor: Editor, id: string, targetId: string | null, t: Translate): MoveVerdict;
+/** Whether block `id` can move into the Baustein `targetId` (`null` = the end of the document); see `moveIntoVerdict`. */
 export declare function canMoveBlockInto(editor: Editor, id: string, targetId: string | null): boolean;
 /**
- * Moves block `id` to the end of the body of the composite `targetId` (`null` = the end of the document) in a single
- * transaction, i.e. one undo step. `false` when nothing moved: a block is missing, the target is not a composite, or it
- * is the block itself or lies inside it.
+ * Moves block `id` to the end of the body of the Baustein `targetId` (`null` = the end of the document) in a single
+ * transaction, i.e. one undo step. `false` when nothing moved: `moveIntoVerdict` refuses the move (or the editor
+ * refused the transaction).
  */
 export declare function moveBlockInto(editor: Editor, id: string, targetId: string | null): boolean;
 //#endregion