@ecsplico/editor 3.5.1 → 4.0.0

package/dist/features/composites/focus.js

@@ -4,19 +4,19 @@ import { Extension } from "@tiptap/core";
 import { Plugin, PluginKey, TextSelection } from "@tiptap/pm/state";
 import { Decoration, DecorationSet } from "@tiptap/pm/view";
 //#region src/features/composites/focus.ts
-/** Class of every node hidden by focus mode (siblings of the focused Baustein and of each ancestor). */
+/** Class of every node hidden by focus mode (siblings of the focused Typed block and of each ancestor). */
 const FOCUS_HIDDEN_CLASS = "sk-focus-hidden";
-/** Class of the focused Baustein. */
+/** Class of the focused Typed block. */
 const FOCUS_TARGET_CLASS = "sk-focus-target";
-/** Class of every ancestor of the focused Baustein. */
+/** Class of every ancestor of the focused Typed block. */
 const FOCUS_ANCESTOR_CLASS = "sk-focus-ancestor";
 const compositeFocusKey = new PluginKey("compositeFocus");
-/** The block id of the focused Baustein in `state`, `null` without focus (or without the extension). */
+/** The block id of the focused Typed block in `state`, `null` without focus (or without the extension). */
 const compositeFocusOf = (state) => compositeFocusKey.getState(state)?.id ?? null;
 /**
-* The decorations of focus mode on Baustein `id` in `doc`: every sibling of the Baustein and of each of its ancestors gets
-* `sk-focus-hidden` (a Baustein's title, description and tags are not siblings in this sense: they stay, so the ancestors
-* keep their titles), the Baustein itself `sk-focus-target`, each ancestor `sk-focus-ancestor`. Empty when `id` is not in `doc`.
+* The decorations of focus mode on Typed block `id` in `doc`: every sibling of the Typed block and of each of its ancestors gets
+* `sk-focus-hidden` (a Typed block's title, description and tags are not siblings in this sense: they stay, so the ancestors
+* keep their titles), the Typed block itself `sk-focus-target`, each ancestor `sk-focus-ancestor`. Empty when `id` is not in `doc`.
 */
 function focusDecorations(doc, id) {
 	const found = findBlockById(doc, id);
@@ -27,7 +27,7 @@ function focusDecorations(doc, id) {
 		const parent = $pos.node(depth);
 		const onPath = $pos.index(depth);
 		const start = $pos.start(depth);
-		const isComposite = parent.type.name === "composite";
+		const isComposite = parent.type.name === "typedBlock";
 		parent.forEach((child, offset, index) => {
 			if (index === onPath || isComposite && index < 3) return;
 			const pos = start + offset;
@@ -42,15 +42,15 @@ const unfocused = {
 	decorations: DecorationSet.empty
 };
 /**
-* Focus mode of Bausteine (client-only, no schema): the `focusComposite` command, the plugin behind it and a reset
-* when the focused Baustein disappears. The hiding itself is CSS on the classes the decorations carry (`composites.css`).
+* Focus mode of Typed blocks (client-only, no schema): the `focusComposite` command, the plugin behind it and a reset
+* when the focused Typed block disappears. The hiding itself is CSS on the classes the decorations carry (`composites.css`).
 */
 const CompositeFocus = Extension.create({
 	name: "compositeFocus",
 	addCommands: () => ({ focusComposite: (id) => ({ state, tr }) => {
 		if (id !== null) {
 			const found = findBlockById(state.doc, id);
-			if (found?.node.type.name !== "composite") return false;
+			if (found?.node.type.name !== "typedBlock") return false;
 			const { from, to } = state.selection;
 			if (from < found.pos || to > found.pos + found.node.nodeSize) tr.setSelection(TextSelection.near(tr.doc.resolve(found.pos + 2)));
 		}

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

@@ -1 +1 @@
-{"version":3,"file":"focus.js","names":[],"sources":["../../../src/features/composites/focus.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { type EditorState, Plugin, PluginKey, TextSelection } from '@tiptap/pm/state'\nimport { Decoration, DecorationSet } from '@tiptap/pm/view'\nimport { findBlockById } from '../../core/schema'\nimport { COMPOSITE_CHROME_COUNT } from './nodes'\n\n/** State of `compositeFocusKey`: the focused Baustein's block id (`null` = no focus) and the decorations that hide the rest. */\nexport interface CompositeFocusState {\n  id: string | null\n  decorations: DecorationSet\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    compositeFocus: {\n      /**\n       * Focus mode: show only the Baustein with block id `id` and the titles of the Bausteine around it (the siblings of it\n       * and of every ancestor are hidden); `null` ends it. False when `id` is not a Baustein of the document. A caret outside\n       * the focused Baustein moves into its title, so no edit lands in hidden content. Resets by itself when the Baustein is gone.\n       */\n      focusComposite: (id: string | null) => ReturnType\n    }\n  }\n}\n\n/** Class of every node hidden by focus mode (siblings of the focused Baustein and of each ancestor). */\nexport const FOCUS_HIDDEN_CLASS = 'sk-focus-hidden'\n/** Class of the focused Baustein. */\nexport const FOCUS_TARGET_CLASS = 'sk-focus-target'\n/** Class of every ancestor of the focused Baustein. */\nexport const FOCUS_ANCESTOR_CLASS = 'sk-focus-ancestor'\n\nexport const compositeFocusKey = new PluginKey<CompositeFocusState>('compositeFocus')\n\n/** The block id of the focused Baustein in `state`, `null` without focus (or without the extension). */\nexport const compositeFocusOf = (state: EditorState): string | null => compositeFocusKey.getState(state)?.id ?? null\n\n/**\n * The decorations of focus mode on Baustein `id` in `doc`: every sibling of the Baustein and of each of its ancestors gets\n * `sk-focus-hidden` (a Baustein's title, description and tags are not siblings in this sense: they stay, so the ancestors\n * keep their titles), the Baustein itself `sk-focus-target`, each ancestor `sk-focus-ancestor`. Empty when `id` is not in `doc`.\n */\nexport function focusDecorations(doc: PMNode, id: string): DecorationSet {\n  const found = findBlockById(doc, id)\n  if (!found) return DecorationSet.empty\n  const $pos = doc.resolve(found.pos)\n  const decorations: Decoration[] = [Decoration.node(found.pos, found.pos + found.node.nodeSize, { class: FOCUS_TARGET_CLASS })]\n  for (let depth = $pos.depth; depth >= 0; depth--) {\n    const parent = $pos.node(depth)\n    const onPath = $pos.index(depth)\n    const start = $pos.start(depth)\n    const isComposite = parent.type.name === 'composite'\n    parent.forEach((child, offset, index) => {\n      if (index === onPath || (isComposite && index < COMPOSITE_CHROME_COUNT)) return\n      const pos = start + offset\n      decorations.push(Decoration.node(pos, pos + child.nodeSize, { class: FOCUS_HIDDEN_CLASS }))\n    })\n    if (depth > 0) decorations.push(Decoration.node($pos.before(depth), $pos.after(depth), { class: FOCUS_ANCESTOR_CLASS }))\n  }\n  return DecorationSet.create(doc, decorations)\n}\n\nconst unfocused: CompositeFocusState = { id: null, decorations: DecorationSet.empty }\n\n/**\n * Focus mode of Bausteine (client-only, no schema): the `focusComposite` command, the plugin behind it and a reset\n * when the focused Baustein disappears. The hiding itself is CSS on the classes the decorations carry (`composites.css`).\n */\nexport const CompositeFocus = Extension.create({\n  name: 'compositeFocus',\n  addCommands: () => ({\n    focusComposite: (id: string | null) => ({ state, tr }) => {\n      if (id !== null) {\n        const found = findBlockById(state.doc, id)\n        if (found?.node.type.name !== 'composite') return false\n        const { from, to } = state.selection\n        // The caret in hidden content would edit what nobody sees: move it into the focused Baustein's title.\n        if (from < found.pos || to > found.pos + found.node.nodeSize) tr.setSelection(TextSelection.near(tr.doc.resolve(found.pos + 2)))\n      }\n      tr.setMeta(compositeFocusKey, { id })\n      return true\n    },\n  }),\n  addProseMirrorPlugins: () => [\n    new Plugin<CompositeFocusState>({\n      key: compositeFocusKey,\n      state: {\n        init: () => unfocused,\n        apply(tr, value) {\n          const meta = tr.getMeta(compositeFocusKey) as { id: string | null } | undefined\n          const id = meta ? meta.id : value.id\n          if (id === null) return value.id === null ? value : unfocused\n          if (!meta && !tr.docChanged) return value\n          return { id, decorations: focusDecorations(tr.doc, id) }\n        },\n      },\n      appendTransaction(transactions, _before, after) {\n        const id = compositeFocusKey.getState(after)?.id\n        if (!id || !transactions.some(tr => tr.docChanged || tr.getMeta(compositeFocusKey))) return null\n        return findBlockById(after.doc, id) ? null : after.tr.setMeta(compositeFocusKey, { id: null }).setMeta('addToHistory', false)\n      },\n      props: {\n        decorations: state => compositeFocusKey.getState(state)?.decorations,\n      },\n    }),\n  ],\n})\n"],"mappings":";;;;;;;AA2BA,MAAa,qBAAqB;;AAElC,MAAa,qBAAqB;;AAElC,MAAa,uBAAuB;AAEpC,MAAa,oBAAoB,IAAI,UAA+B,gBAAgB;;AAGpF,MAAa,oBAAoB,UAAsC,kBAAkB,SAAS,KAAK,CAAC,EAAE,MAAM;;;;;;AAOhH,SAAgB,iBAAiB,KAAa,IAA2B;CACvE,MAAM,QAAQ,cAAc,KAAK,EAAE;CACnC,IAAI,CAAC,OAAO,OAAO,cAAc;CACjC,MAAM,OAAO,IAAI,QAAQ,MAAM,GAAG;CAClC,MAAM,cAA4B,CAAC,WAAW,KAAK,MAAM,KAAK,MAAM,MAAM,MAAM,KAAK,UAAU,EAAE,OAAO,mBAAmB,CAAC,CAAC;CAC7H,KAAK,IAAI,QAAQ,KAAK,OAAO,SAAS,GAAG,SAAS;EAChD,MAAM,SAAS,KAAK,KAAK,KAAK;EAC9B,MAAM,SAAS,KAAK,MAAM,KAAK;EAC/B,MAAM,QAAQ,KAAK,MAAM,KAAK;EAC9B,MAAM,cAAc,OAAO,KAAK,SAAS;EACzC,OAAO,SAAS,OAAO,QAAQ,UAAU;GACvC,IAAI,UAAU,UAAW,eAAe,QAAA,GAAiC;GACzE,MAAM,MAAM,QAAQ;GACpB,YAAY,KAAK,WAAW,KAAK,KAAK,MAAM,MAAM,UAAU,EAAE,OAAO,mBAAmB,CAAC,CAAC;EAC5F,CAAC;EACD,IAAI,QAAQ,GAAG,YAAY,KAAK,WAAW,KAAK,KAAK,OAAO,KAAK,GAAG,KAAK,MAAM,KAAK,GAAG,EAAE,OAAO,qBAAqB,CAAC,CAAC;CACzH;CACA,OAAO,cAAc,OAAO,KAAK,WAAW;AAC9C;AAEA,MAAM,YAAiC;CAAE,IAAI;CAAM,aAAa,cAAc;AAAM;;;;;AAMpF,MAAa,iBAAiB,UAAU,OAAO;CAC7C,MAAM;CACN,oBAAoB,EAClB,iBAAiB,QAAuB,EAAE,OAAO,SAAS;EACxD,IAAI,OAAO,MAAM;GACf,MAAM,QAAQ,cAAc,MAAM,KAAK,EAAE;GACzC,IAAI,OAAO,KAAK,KAAK,SAAS,aAAa,OAAO;GAClD,MAAM,EAAE,MAAM,OAAO,MAAM;GAE3B,IAAI,OAAO,MAAM,OAAO,KAAK,MAAM,MAAM,MAAM,KAAK,UAAU,GAAG,aAAa,cAAc,KAAK,GAAG,IAAI,QAAQ,MAAM,MAAM,CAAC,CAAC,CAAC;EACjI;EACA,GAAG,QAAQ,mBAAmB,EAAE,GAAG,CAAC;EACpC,OAAO;CACT,EACF;CACA,6BAA6B,CAC3B,IAAI,OAA4B;EAC9B,KAAK;EACL,OAAO;GACL,YAAY;GACZ,MAAM,IAAI,OAAO;IACf,MAAM,OAAO,GAAG,QAAQ,iBAAiB;IACzC,MAAM,KAAK,OAAO,KAAK,KAAK,MAAM;IAClC,IAAI,OAAO,MAAM,OAAO,MAAM,OAAO,OAAO,QAAQ;IACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,YAAY,OAAO;IACpC,OAAO;KAAE;KAAI,aAAa,iBAAiB,GAAG,KAAK,EAAE;IAAE;GACzD;EACF;EACA,kBAAkB,cAAc,SAAS,OAAO;GAC9C,MAAM,KAAK,kBAAkB,SAAS,KAAK,CAAC,EAAE;GAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,MAAK,OAAM,GAAG,cAAc,GAAG,QAAQ,iBAAiB,CAAC,GAAG,OAAO;GAC5F,OAAO,cAAc,MAAM,KAAK,EAAE,IAAI,OAAO,MAAM,GAAG,QAAQ,mBAAmB,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,gBAAgB,KAAK;EAC9H;EACA,OAAO,EACL,cAAa,UAAS,kBAAkB,SAAS,KAAK,CAAC,EAAE,YAC3D;CACF,CAAC,CACH;AACF,CAAC"}
+{"version":3,"file":"focus.js","names":[],"sources":["../../../src/features/composites/focus.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { type EditorState, Plugin, PluginKey, TextSelection } from '@tiptap/pm/state'\nimport { Decoration, DecorationSet } from '@tiptap/pm/view'\nimport { findBlockById } from '../../core/schema'\nimport { COMPOSITE_CHROME_COUNT } from './nodes'\n\n/** State of `compositeFocusKey`: the focused Typed block's block id (`null` = no focus) and the decorations that hide the rest. */\nexport interface CompositeFocusState {\n  id: string | null\n  decorations: DecorationSet\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    compositeFocus: {\n      /**\n       * Focus mode: show only the Typed block with block id `id` and the titles of the Typed blocks around it (the siblings of it\n       * and of every ancestor are hidden); `null` ends it. False when `id` is not a Typed block of the document. A caret outside\n       * the focused Typed block moves into its title, so no edit lands in hidden content. Resets by itself when the Typed block is gone.\n       */\n      focusComposite: (id: string | null) => ReturnType\n    }\n  }\n}\n\n/** Class of every node hidden by focus mode (siblings of the focused Typed block and of each ancestor). */\nexport const FOCUS_HIDDEN_CLASS = 'sk-focus-hidden'\n/** Class of the focused Typed block. */\nexport const FOCUS_TARGET_CLASS = 'sk-focus-target'\n/** Class of every ancestor of the focused Typed block. */\nexport const FOCUS_ANCESTOR_CLASS = 'sk-focus-ancestor'\n\nexport const compositeFocusKey = new PluginKey<CompositeFocusState>('compositeFocus')\n\n/** The block id of the focused Typed block in `state`, `null` without focus (or without the extension). */\nexport const compositeFocusOf = (state: EditorState): string | null => compositeFocusKey.getState(state)?.id ?? null\n\n/**\n * The decorations of focus mode on Typed block `id` in `doc`: every sibling of the Typed block and of each of its ancestors gets\n * `sk-focus-hidden` (a Typed block's title, description and tags are not siblings in this sense: they stay, so the ancestors\n * keep their titles), the Typed block itself `sk-focus-target`, each ancestor `sk-focus-ancestor`. Empty when `id` is not in `doc`.\n */\nexport function focusDecorations(doc: PMNode, id: string): DecorationSet {\n  const found = findBlockById(doc, id)\n  if (!found) return DecorationSet.empty\n  const $pos = doc.resolve(found.pos)\n  const decorations: Decoration[] = [Decoration.node(found.pos, found.pos + found.node.nodeSize, { class: FOCUS_TARGET_CLASS })]\n  for (let depth = $pos.depth; depth >= 0; depth--) {\n    const parent = $pos.node(depth)\n    const onPath = $pos.index(depth)\n    const start = $pos.start(depth)\n    const isComposite = parent.type.name === 'typedBlock'\n    parent.forEach((child, offset, index) => {\n      if (index === onPath || (isComposite && index < COMPOSITE_CHROME_COUNT)) return\n      const pos = start + offset\n      decorations.push(Decoration.node(pos, pos + child.nodeSize, { class: FOCUS_HIDDEN_CLASS }))\n    })\n    if (depth > 0) decorations.push(Decoration.node($pos.before(depth), $pos.after(depth), { class: FOCUS_ANCESTOR_CLASS }))\n  }\n  return DecorationSet.create(doc, decorations)\n}\n\nconst unfocused: CompositeFocusState = { id: null, decorations: DecorationSet.empty }\n\n/**\n * Focus mode of Typed blocks (client-only, no schema): the `focusComposite` command, the plugin behind it and a reset\n * when the focused Typed block disappears. The hiding itself is CSS on the classes the decorations carry (`composites.css`).\n */\nexport const CompositeFocus = Extension.create({\n  name: 'compositeFocus',\n  addCommands: () => ({\n    focusComposite: (id: string | null) => ({ state, tr }) => {\n      if (id !== null) {\n        const found = findBlockById(state.doc, id)\n        if (found?.node.type.name !== 'typedBlock') return false\n        const { from, to } = state.selection\n        // The caret in hidden content would edit what nobody sees: move it into the focused Typed block's title.\n        if (from < found.pos || to > found.pos + found.node.nodeSize) tr.setSelection(TextSelection.near(tr.doc.resolve(found.pos + 2)))\n      }\n      tr.setMeta(compositeFocusKey, { id })\n      return true\n    },\n  }),\n  addProseMirrorPlugins: () => [\n    new Plugin<CompositeFocusState>({\n      key: compositeFocusKey,\n      state: {\n        init: () => unfocused,\n        apply(tr, value) {\n          const meta = tr.getMeta(compositeFocusKey) as { id: string | null } | undefined\n          const id = meta ? meta.id : value.id\n          if (id === null) return value.id === null ? value : unfocused\n          if (!meta && !tr.docChanged) return value\n          return { id, decorations: focusDecorations(tr.doc, id) }\n        },\n      },\n      appendTransaction(transactions, _before, after) {\n        const id = compositeFocusKey.getState(after)?.id\n        if (!id || !transactions.some(tr => tr.docChanged || tr.getMeta(compositeFocusKey))) return null\n        return findBlockById(after.doc, id) ? null : after.tr.setMeta(compositeFocusKey, { id: null }).setMeta('addToHistory', false)\n      },\n      props: {\n        decorations: state => compositeFocusKey.getState(state)?.decorations,\n      },\n    }),\n  ],\n})\n"],"mappings":";;;;;;;AA2BA,MAAa,qBAAqB;;AAElC,MAAa,qBAAqB;;AAElC,MAAa,uBAAuB;AAEpC,MAAa,oBAAoB,IAAI,UAA+B,gBAAgB;;AAGpF,MAAa,oBAAoB,UAAsC,kBAAkB,SAAS,KAAK,CAAC,EAAE,MAAM;;;;;;AAOhH,SAAgB,iBAAiB,KAAa,IAA2B;CACvE,MAAM,QAAQ,cAAc,KAAK,EAAE;CACnC,IAAI,CAAC,OAAO,OAAO,cAAc;CACjC,MAAM,OAAO,IAAI,QAAQ,MAAM,GAAG;CAClC,MAAM,cAA4B,CAAC,WAAW,KAAK,MAAM,KAAK,MAAM,MAAM,MAAM,KAAK,UAAU,EAAE,OAAO,mBAAmB,CAAC,CAAC;CAC7H,KAAK,IAAI,QAAQ,KAAK,OAAO,SAAS,GAAG,SAAS;EAChD,MAAM,SAAS,KAAK,KAAK,KAAK;EAC9B,MAAM,SAAS,KAAK,MAAM,KAAK;EAC/B,MAAM,QAAQ,KAAK,MAAM,KAAK;EAC9B,MAAM,cAAc,OAAO,KAAK,SAAS;EACzC,OAAO,SAAS,OAAO,QAAQ,UAAU;GACvC,IAAI,UAAU,UAAW,eAAe,QAAA,GAAiC;GACzE,MAAM,MAAM,QAAQ;GACpB,YAAY,KAAK,WAAW,KAAK,KAAK,MAAM,MAAM,UAAU,EAAE,OAAO,mBAAmB,CAAC,CAAC;EAC5F,CAAC;EACD,IAAI,QAAQ,GAAG,YAAY,KAAK,WAAW,KAAK,KAAK,OAAO,KAAK,GAAG,KAAK,MAAM,KAAK,GAAG,EAAE,OAAO,qBAAqB,CAAC,CAAC;CACzH;CACA,OAAO,cAAc,OAAO,KAAK,WAAW;AAC9C;AAEA,MAAM,YAAiC;CAAE,IAAI;CAAM,aAAa,cAAc;AAAM;;;;;AAMpF,MAAa,iBAAiB,UAAU,OAAO;CAC7C,MAAM;CACN,oBAAoB,EAClB,iBAAiB,QAAuB,EAAE,OAAO,SAAS;EACxD,IAAI,OAAO,MAAM;GACf,MAAM,QAAQ,cAAc,MAAM,KAAK,EAAE;GACzC,IAAI,OAAO,KAAK,KAAK,SAAS,cAAc,OAAO;GACnD,MAAM,EAAE,MAAM,OAAO,MAAM;GAE3B,IAAI,OAAO,MAAM,OAAO,KAAK,MAAM,MAAM,MAAM,KAAK,UAAU,GAAG,aAAa,cAAc,KAAK,GAAG,IAAI,QAAQ,MAAM,MAAM,CAAC,CAAC,CAAC;EACjI;EACA,GAAG,QAAQ,mBAAmB,EAAE,GAAG,CAAC;EACpC,OAAO;CACT,EACF;CACA,6BAA6B,CAC3B,IAAI,OAA4B;EAC9B,KAAK;EACL,OAAO;GACL,YAAY;GACZ,MAAM,IAAI,OAAO;IACf,MAAM,OAAO,GAAG,QAAQ,iBAAiB;IACzC,MAAM,KAAK,OAAO,KAAK,KAAK,MAAM;IAClC,IAAI,OAAO,MAAM,OAAO,MAAM,OAAO,OAAO,QAAQ;IACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,YAAY,OAAO;IACpC,OAAO;KAAE;KAAI,aAAa,iBAAiB,GAAG,KAAK,EAAE;IAAE;GACzD;EACF;EACA,kBAAkB,cAAc,SAAS,OAAO;GAC9C,MAAM,KAAK,kBAAkB,SAAS,KAAK,CAAC,EAAE;GAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,MAAK,OAAM,GAAG,cAAc,GAAG,QAAQ,iBAAiB,CAAC,GAAG,OAAO;GAC5F,OAAO,cAAc,MAAM,KAAK,EAAE,IAAI,OAAO,MAAM,GAAG,QAAQ,mBAAmB,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,gBAAgB,KAAK;EAC9H;EACA,OAAO,EACL,cAAa,UAAS,kBAAkB,SAAS,KAAK,CAAC,EAAE,YAC3D;CACF,CAAC,CACH;AACF,CAAC"}

package/dist/features/composites/heading-composites.d.ts

@@ -1,6 +1,6 @@
 import { StructureMode } from "../../settings/values.js";
 import "../../settings/index.js";
-import { CompositeKind } from "./kinds.js";
+import { BlockType } from "./block-types.js";
 import { Node, Schema } from "@tiptap/pm/model";
 //#region src/features/composites/heading-composites.d.ts
 /**
@@ -19,18 +19,18 @@ export declare function headingGroupRange(parent: Node, index: number): {
  * description italic, the tags as tag chips (`#name` text without a `tag` node), the meta as one `Label: Wert · …` line
  * (labels and option labels from the composite's kind in `kinds`; raw keys and values for an unknown kind).
  */
-export declare function compositeChromeBlocks(schema: Schema, composite: Node, kinds: readonly CompositeKind[]): Node[];
+export declare function compositeChromeBlocks(schema: Schema, composite: Node, kinds: readonly BlockType[]): Node[];
 /**
  * Inverse of `groupHeadingsIntoComposites`: every composite in `blocks` (siblings) becomes a heading of `level` (max 6)
  * with its title, then its chrome (`compositeChromeBlocks`), then its body (dropped when it is one empty paragraph).
  * Recursive: nested composites in bodies become headings of `level + 1` and so on; flat: they stay. `null` when
  * `blocks` holds no composite. Created blocks carry no id; carried-over body blocks keep theirs.
  */
-export declare function flattenCompositesToHeadings(schema: Schema, blocks: readonly Node[], recursive: boolean, level: number, kinds: readonly CompositeKind[]): Node[] | null;
+export declare function flattenCompositesToHeadings(schema: Schema, blocks: readonly Node[], recursive: boolean, level: number, kinds: readonly BlockType[]): Node[] | null;
 /**
- * `blocks` (siblings) in the preferred `structure`: `'composite'` groups headings into `section` composites at every
+ * `blocks` (siblings) in the preferred `structure`: `'structured'` groups headings into `section` composites at every
  * level, `'flat'` turns composites into headings starting at `level`. Unchanged blocks come back as a copy of the array.
  */
-export declare function structureBlocks(schema: Schema, blocks: readonly Node[], structure: StructureMode, level: number, kinds: readonly CompositeKind[]): Node[];
+export declare function structureBlocks(schema: Schema, blocks: readonly Node[], structure: StructureMode, level: number, kinds: readonly BlockType[]): Node[];
 //#endregion
 //# sourceMappingURL=heading-composites.d.ts.map

package/dist/features/composites/heading-composites.js

@@ -1,11 +1,8 @@
-import { compositeKind } from "./kinds.js";
+import { TYPED_BLOCK, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE } from "../../core/schema/persisted-names.js";
+import { blockTypeOf, propertiesOf } from "./block-types.js";
 import { Fragment } from "@tiptap/pm/model";
 //#region src/features/composites/heading-composites.ts
 const HEADING = "heading";
-const COMPOSITE = "composite";
-const TITLE = "compositeTitle";
-const DESCRIPTION = "compositeDescription";
-const TAGS = "compositeTags";
 const PARAGRAPH = "paragraph";
 /** Title, description and tags: the fixed children in front of a composite's body. */
 const CHROME_COUNT = 3;
@@ -20,7 +17,7 @@ function groupHeadingsIntoComposites(schema, blocks, recursive, kind) {
 	let changed = false;
 	let input = [...blocks];
 	if (recursive) input = input.map((block) => {
-		if (block.type.name !== COMPOSITE) return block;
+		if (block.type.name !== "typedBlock") return block;
 		const children = [];
 		block.forEach((child) => children.push(child));
 		const body = groupHeadingsIntoComposites(schema, children.slice(CHROME_COUNT), true, kind);
@@ -45,10 +42,10 @@ function groupHeadingsIntoComposites(schema, blocks, recursive, kind) {
 		let content = body;
 		if (recursive) content = groupHeadingsIntoComposites(schema, content, true, kind) ?? content;
 		if (!content.length) content = [nodes[PARAGRAPH].create()];
-		return nodes[COMPOSITE].create({ kind }, [
-			nodes[TITLE].create(null, heading.content),
-			nodes[DESCRIPTION].create(),
-			nodes[TAGS].create(),
+		return nodes[TYPED_BLOCK].create({ blockType: kind }, [
+			nodes[TYPED_BLOCK_TITLE].create(null, heading.content),
+			nodes[TYPED_BLOCK_DESCRIPTION].create(),
+			nodes[TYPED_BLOCK_TAGS].create(),
 			...content
 		]);
 	});
@@ -91,8 +88,8 @@ function compositeChromeBlocks(schema, composite, kinds) {
 		const chips = names.flatMap((name, index) => [...index ? [schema.text(" ")] : [], n.tag ? n.tag.create({ name }) : schema.text(`#${name}`)]);
 		blocks.push(paragraph.create(null, chips));
 	}
-	const kind = composite.attrs.kind;
-	const fields = kinds.some((known) => known.id === kind) ? compositeKind(kinds, kind).fields : [];
+	const kind = composite.attrs.blockType;
+	const fields = kinds.some((known) => known.id === kind) ? propertiesOf(blockTypeOf(kinds, kind)) : [];
 	const meta = composite.attrs.meta ?? {};
 	const entries = Object.entries(meta).filter(([, value]) => value !== "" && value !== null && value !== void 0).map(([key, value]) => {
 		const field = fields.find((candidate) => candidate.key === key);
@@ -109,10 +106,10 @@ function compositeChromeBlocks(schema, composite, kinds) {
 * `blocks` holds no composite. Created blocks carry no id; carried-over body blocks keep theirs.
 */
 function flattenCompositesToHeadings(schema, blocks, recursive, level, kinds) {
-	if (!blocks.some((block) => block.type.name === COMPOSITE)) return null;
+	if (!blocks.some((block) => block.type.name === "typedBlock")) return null;
 	const heading = schema.nodes[HEADING];
 	return blocks.flatMap((block) => {
-		if (block.type.name !== COMPOSITE) return [block];
+		if (block.type.name !== "typedBlock") return [block];
 		let body = [];
 		block.forEach((child, _offset, index) => {
 			if (index >= CHROME_COUNT) body.push(child);
@@ -127,11 +124,11 @@ function flattenCompositesToHeadings(schema, blocks, recursive, level, kinds) {
 	});
 }
 /**
-* `blocks` (siblings) in the preferred `structure`: `'composite'` groups headings into `section` composites at every
+* `blocks` (siblings) in the preferred `structure`: `'structured'` groups headings into `section` composites at every
 * level, `'flat'` turns composites into headings starting at `level`. Unchanged blocks come back as a copy of the array.
 */
 function structureBlocks(schema, blocks, structure, level, kinds) {
-	if (structure === "composite") return groupHeadingsIntoComposites(schema, blocks, true, "section") ?? [...blocks];
+	if (structure === "structured") return groupHeadingsIntoComposites(schema, blocks, true, "section") ?? [...blocks];
 	return flattenCompositesToHeadings(schema, blocks, true, level, kinds) ?? [...blocks];
 }
 //#endregion

package/dist/features/composites/heading-composites.js.map

@@ -1 +1 @@
-{"version":3,"file":"heading-composites.js","names":[],"sources":["../../../src/features/composites/heading-composites.ts"],"sourcesContent":["import { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport { type CompositeKind, compositeKind } from './kinds'\nimport type { StructureMode } from '../../settings'\n\n// Node names hardcoded (not imported from composite.ts) so composite.ts can import this file without a cycle.\nconst HEADING = 'heading'\nconst COMPOSITE = 'composite'\nconst TITLE = 'compositeTitle'\nconst DESCRIPTION = 'compositeDescription'\nconst TAGS = 'compositeTags'\nconst PARAGRAPH = 'paragraph'\n/** Title, description and tags: the fixed children in front of a composite's body. */\nconst CHROME_COUNT = 3\n\n\nconst isHeading = (node: PMNode) => node.type.name === HEADING\nconst levelOf = (node: PMNode) => node.attrs.level as number\n\n/**\n * `blocks` (siblings) with headings grouped into composites of `kind`. Flat: only headings of the lowest level present\n * become composites; everything before the first such heading is kept. Recursive: bodies, the part before the first\n * heading and the bodies of existing composites are grouped the same way. `null` when nothing changed.\n */\nexport function groupHeadingsIntoComposites(schema: Schema, blocks: readonly PMNode[], recursive: boolean, kind: string): PMNode[] | null {\n  let changed = false\n  let input: PMNode[] = [...blocks]\n  if (recursive) {\n    input = input.map((block) => {\n      if (block.type.name !== COMPOSITE) return block\n      const children: PMNode[] = []\n      block.forEach(child => children.push(child))\n      const body = groupHeadingsIntoComposites(schema, children.slice(CHROME_COUNT), true, kind)\n      if (!body) return block\n      changed = true\n      return block.copy(Fragment.from([...children.slice(0, CHROME_COUNT), ...body]))\n    })\n  }\n\n  let minLevel = Infinity\n  for (const block of input) if (isHeading(block)) minLevel = Math.min(minLevel, levelOf(block))\n  if (minLevel === Infinity) return changed ? input : null\n\n  const { nodes } = schema\n  let preamble: PMNode[] = []\n  const groups: { heading: PMNode, body: PMNode[] }[] = []\n  for (const block of input) {\n    if (isHeading(block) && levelOf(block) <= minLevel) groups.push({ heading: block, body: [] })\n    else if (groups.length) groups[groups.length - 1]!.body.push(block)\n    else preamble.push(block)\n  }\n  if (recursive) preamble = groupHeadingsIntoComposites(schema, preamble, true, kind) ?? preamble\n\n  const composites = groups.map(({ heading, body }) => {\n    let content = body\n    if (recursive) content = groupHeadingsIntoComposites(schema, content, true, kind) ?? content\n    if (!content.length) content = [nodes[PARAGRAPH]!.create()]\n    return nodes[COMPOSITE]!.create({ kind }, [\n      nodes[TITLE]!.create(null, heading.content), nodes[DESCRIPTION]!.create(), nodes[TAGS]!.create(), ...content,\n    ])\n  })\n  return [...preamble, ...composites]\n}\n\n/** Index range `[from, to)` of the heading at `index` in `parent` plus its content: up to the next sibling heading of the same or a higher level. */\nexport function headingGroupRange(parent: PMNode, index: number): { from: number, to: number } {\n  const level = levelOf(parent.child(index))\n  for (let i = index + 1; i < parent.childCount; i++) {\n    const child = parent.child(i)\n    if (isHeading(child) && levelOf(child) <= level) return { from: index, to: i }\n  }\n  return { from: index, to: parent.childCount }\n}\n\n/**\n * Description, tags and meta of `composite` as plain paragraphs, in this order, each only when non-empty: the\n * description italic, the tags as tag chips (`#name` text without a `tag` node), the meta as one `Label: Wert · …` line\n * (labels and option labels from the composite's kind in `kinds`; raw keys and values for an unknown kind).\n */\nexport function compositeChromeBlocks(schema: Schema, composite: PMNode, kinds: readonly CompositeKind[]): PMNode[] {\n  const n = schema.nodes\n  const paragraph = n[PARAGRAPH]!\n  const description = composite.child(1)\n  const tags: unknown = composite.child(2).attrs.tags\n  const blocks: PMNode[] = []\n  if (description.content.size) {\n    const italic = schema.marks.italic\n    const content: PMNode[] = []\n    description.forEach(child => content.push(italic && child.isText ? child.mark(italic.create().addToSet(child.marks)) : child))\n    blocks.push(paragraph.create(null, content))\n  }\n  const names = Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string' && tag !== '') : []\n  if (names.length) {\n    const chips = names.flatMap((name, index) => [\n      ...(index ? [schema.text(' ')] : []),\n      n.tag ? n.tag.create({ name }) : schema.text(`#${name}`),\n    ])\n    blocks.push(paragraph.create(null, chips))\n  }\n  const kind = composite.attrs.kind as string\n  const fields = kinds.some(known => known.id === kind) ? compositeKind(kinds, kind).fields : []\n  const meta = (composite.attrs.meta ?? {}) as Record<string, unknown>\n  const entries = Object.entries(meta)\n    .filter(([, value]) => value !== '' && value !== null && value !== undefined)\n    .map(([key, value]) => {\n      const field = fields.find(candidate => candidate.key === key)\n      const display = field?.options?.find(option => option.value === value)?.label ?? String(value)\n      return `${field?.label ?? key}: ${display}`\n    })\n  if (entries.length) blocks.push(paragraph.create(null, schema.text(entries.join(' · '))))\n  return blocks\n}\n\n/**\n * Inverse of `groupHeadingsIntoComposites`: every composite in `blocks` (siblings) becomes a heading of `level` (max 6)\n * with its title, then its chrome (`compositeChromeBlocks`), then its body (dropped when it is one empty paragraph).\n * Recursive: nested composites in bodies become headings of `level + 1` and so on; flat: they stay. `null` when\n * `blocks` holds no composite. Created blocks carry no id; carried-over body blocks keep theirs.\n */\nexport function flattenCompositesToHeadings(schema: Schema, blocks: readonly PMNode[], recursive: boolean, level: number, kinds: readonly CompositeKind[]): PMNode[] | null {\n  if (!blocks.some(block => block.type.name === COMPOSITE)) return null\n  const heading = schema.nodes[HEADING]!\n  return blocks.flatMap((block) => {\n    if (block.type.name !== COMPOSITE) return [block]\n    let body: PMNode[] = []\n    block.forEach((child, _offset, index) => {\n      if (index >= CHROME_COUNT) body.push(child)\n    })\n    if (body.length === 1 && body[0]!.type.name === PARAGRAPH && !body[0]!.content.size) body = []\n    if (recursive) body = flattenCompositesToHeadings(schema, body, true, level + 1, kinds) ?? body\n    return [heading.create({ level: Math.min(level, 6) }, block.child(0).content), ...compositeChromeBlocks(schema, block, kinds), ...body]\n  })\n}\n\n/**\n * `blocks` (siblings) in the preferred `structure`: `'composite'` groups headings into `section` composites at every\n * level, `'flat'` turns composites into headings starting at `level`. Unchanged blocks come back as a copy of the array.\n */\nexport function structureBlocks(schema: Schema, blocks: readonly PMNode[], structure: StructureMode, level: number, kinds: readonly CompositeKind[]): PMNode[] {\n  if (structure === 'composite') return groupHeadingsIntoComposites(schema, blocks, true, 'section') ?? [...blocks]\n  return flattenCompositesToHeadings(schema, blocks, true, level, kinds) ?? [...blocks]\n}\n"],"mappings":"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"}
+{"version":3,"file":"heading-composites.js","names":[],"sources":["../../../src/features/composites/heading-composites.ts"],"sourcesContent":["import { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport { type BlockType, blockTypeOf, propertiesOf } from './block-types'\nimport { TYPED_BLOCK, TYPED_BLOCK_DESCRIPTION, TYPED_BLOCK_TAGS, TYPED_BLOCK_TITLE } from '../../core/schema/persisted-names'\nimport type { StructureMode } from '../../settings'\n\nconst HEADING = 'heading'\nconst PARAGRAPH = 'paragraph'\n/** Title, description and tags: the fixed children in front of a composite's body. */\nconst CHROME_COUNT = 3\n\nconst isHeading = (node: PMNode) => node.type.name === HEADING\nconst levelOf = (node: PMNode) => node.attrs.level as number\n\n/**\n * `blocks` (siblings) with headings grouped into composites of `kind`. Flat: only headings of the lowest level present\n * become composites; everything before the first such heading is kept. Recursive: bodies, the part before the first\n * heading and the bodies of existing composites are grouped the same way. `null` when nothing changed.\n */\nexport function groupHeadingsIntoComposites(schema: Schema, blocks: readonly PMNode[], recursive: boolean, kind: string): PMNode[] | null {\n  let changed = false\n  let input: PMNode[] = [...blocks]\n  if (recursive) {\n    input = input.map((block) => {\n      if (block.type.name !== TYPED_BLOCK) return block\n      const children: PMNode[] = []\n      block.forEach(child => children.push(child))\n      const body = groupHeadingsIntoComposites(schema, children.slice(CHROME_COUNT), true, kind)\n      if (!body) return block\n      changed = true\n      return block.copy(Fragment.from([...children.slice(0, CHROME_COUNT), ...body]))\n    })\n  }\n\n  let minLevel = Infinity\n  for (const block of input) if (isHeading(block)) minLevel = Math.min(minLevel, levelOf(block))\n  if (minLevel === Infinity) return changed ? input : null\n\n  const { nodes } = schema\n  let preamble: PMNode[] = []\n  const groups: { heading: PMNode, body: PMNode[] }[] = []\n  for (const block of input) {\n    if (isHeading(block) && levelOf(block) <= minLevel) groups.push({ heading: block, body: [] })\n    else if (groups.length) groups[groups.length - 1]!.body.push(block)\n    else preamble.push(block)\n  }\n  if (recursive) preamble = groupHeadingsIntoComposites(schema, preamble, true, kind) ?? preamble\n\n  const composites = groups.map(({ heading, body }) => {\n    let content = body\n    if (recursive) content = groupHeadingsIntoComposites(schema, content, true, kind) ?? content\n    if (!content.length) content = [nodes[PARAGRAPH]!.create()]\n    return nodes[TYPED_BLOCK]!.create({ blockType: kind }, [\n      nodes[TYPED_BLOCK_TITLE]!.create(null, heading.content), nodes[TYPED_BLOCK_DESCRIPTION]!.create(), nodes[TYPED_BLOCK_TAGS]!.create(), ...content,\n    ])\n  })\n  return [...preamble, ...composites]\n}\n\n/** Index range `[from, to)` of the heading at `index` in `parent` plus its content: up to the next sibling heading of the same or a higher level. */\nexport function headingGroupRange(parent: PMNode, index: number): { from: number, to: number } {\n  const level = levelOf(parent.child(index))\n  for (let i = index + 1; i < parent.childCount; i++) {\n    const child = parent.child(i)\n    if (isHeading(child) && levelOf(child) <= level) return { from: index, to: i }\n  }\n  return { from: index, to: parent.childCount }\n}\n\n/**\n * Description, tags and meta of `composite` as plain paragraphs, in this order, each only when non-empty: the\n * description italic, the tags as tag chips (`#name` text without a `tag` node), the meta as one `Label: Wert · …` line\n * (labels and option labels from the composite's kind in `kinds`; raw keys and values for an unknown kind).\n */\nexport function compositeChromeBlocks(schema: Schema, composite: PMNode, kinds: readonly BlockType[]): PMNode[] {\n  const n = schema.nodes\n  const paragraph = n[PARAGRAPH]!\n  const description = composite.child(1)\n  const tags: unknown = composite.child(2).attrs.tags\n  const blocks: PMNode[] = []\n  if (description.content.size) {\n    const italic = schema.marks.italic\n    const content: PMNode[] = []\n    description.forEach(child => content.push(italic && child.isText ? child.mark(italic.create().addToSet(child.marks)) : child))\n    blocks.push(paragraph.create(null, content))\n  }\n  const names = Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string' && tag !== '') : []\n  if (names.length) {\n    const chips = names.flatMap((name, index) => [\n      ...(index ? [schema.text(' ')] : []),\n      n.tag ? n.tag.create({ name }) : schema.text(`#${name}`),\n    ])\n    blocks.push(paragraph.create(null, chips))\n  }\n  const kind = composite.attrs.blockType as string\n  const fields = kinds.some(known => known.id === kind) ? propertiesOf(blockTypeOf(kinds, kind)) : []\n  const meta = (composite.attrs.meta ?? {}) as Record<string, unknown>\n  const entries = Object.entries(meta)\n    .filter(([, value]) => value !== '' && value !== null && value !== undefined)\n    .map(([key, value]) => {\n      const field = fields.find(candidate => candidate.key === key)\n      const display = field?.options?.find(option => option.value === value)?.label ?? String(value)\n      return `${field?.label ?? key}: ${display}`\n    })\n  if (entries.length) blocks.push(paragraph.create(null, schema.text(entries.join(' · '))))\n  return blocks\n}\n\n/**\n * Inverse of `groupHeadingsIntoComposites`: every composite in `blocks` (siblings) becomes a heading of `level` (max 6)\n * with its title, then its chrome (`compositeChromeBlocks`), then its body (dropped when it is one empty paragraph).\n * Recursive: nested composites in bodies become headings of `level + 1` and so on; flat: they stay. `null` when\n * `blocks` holds no composite. Created blocks carry no id; carried-over body blocks keep theirs.\n */\nexport function flattenCompositesToHeadings(schema: Schema, blocks: readonly PMNode[], recursive: boolean, level: number, kinds: readonly BlockType[]): PMNode[] | null {\n  if (!blocks.some(block => block.type.name === TYPED_BLOCK)) return null\n  const heading = schema.nodes[HEADING]!\n  return blocks.flatMap((block) => {\n    if (block.type.name !== TYPED_BLOCK) return [block]\n    let body: PMNode[] = []\n    block.forEach((child, _offset, index) => {\n      if (index >= CHROME_COUNT) body.push(child)\n    })\n    if (body.length === 1 && body[0]!.type.name === PARAGRAPH && !body[0]!.content.size) body = []\n    if (recursive) body = flattenCompositesToHeadings(schema, body, true, level + 1, kinds) ?? body\n    return [heading.create({ level: Math.min(level, 6) }, block.child(0).content), ...compositeChromeBlocks(schema, block, kinds), ...body]\n  })\n}\n\n/**\n * `blocks` (siblings) in the preferred `structure`: `'structured'` groups headings into `section` composites at every\n * level, `'flat'` turns composites into headings starting at `level`. Unchanged blocks come back as a copy of the array.\n */\nexport function structureBlocks(schema: Schema, blocks: readonly PMNode[], structure: StructureMode, level: number, kinds: readonly BlockType[]): PMNode[] {\n  if (structure === 'structured') return groupHeadingsIntoComposites(schema, blocks, true, 'section') ?? [...blocks]\n  return flattenCompositesToHeadings(schema, blocks, true, level, kinds) ?? [...blocks]\n}\n"],"mappings":"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"}

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

@@ -1,11 +1,23 @@
 import { CSL_TYPES, CslDate, CslItem, CslName, CslType } from "../../core/backend-types.js";
-import { CompositeAiBrief, compositeAiBrief } from "./ai-brief.js";
-import { CompositeKind, CompositeKindAi, CompositeMetaField, SOURCE_MEDIA_TYPES, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
-import { CompositeBacklink, CompositeMention, CompositeReference, CompositeRow, compositeBacklinks, compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
-import { CompositeAnchor, CompositeAnchorsHandle, CompositeFrame, compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
 import { BASKET_IDS, Basket, basketById, basketOf, defaultBaskets, titleHiddenOf } from "./baskets.js";
-import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeOptions, CompositeStorage, CompositeTagsNode, CompositeTitleNode, compositeBasketsOf, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { BlockType, BlockTypeAi, SOURCE_MEDIA_TYPES, acceptsChild, acceptsImport, aiBlockTypesOf, blockTypeOf, defaultBlockTypes, isRootBlockType } from "./block-types.js";
+import { CompositeAiBrief, compositeAiBrief } from "./ai-brief.js";
+import { compositeConversions, convertCompositeBlocks } from "./convert.js";
+import { CompositeFence, FenceSegment, splitCompositeFences } from "../../core/fences.js";
+import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
+import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
+import { BASKET_KEY, BIB_KEY, TITLE_HIDDEN_KEY } from "./meta-keys.js";
+import { bibOf, bibtexOf, citeFull, citeShort, cslOf, cslTypeOptions, yearOf } from "./bibliography.js";
+import { bodyMarkdown, sourceOf } from "./source.js";
+import { BlockTypeJsonError, BlockTypeJsonIssue, mergeBlockTypes, parseBlockTypes } from "./block-types-json.js";
+import { migrateLegacyContent } from "./legacy.js";
 import { REFERENCE_NODE, ReferenceAttrs, ReferenceNode, ReferenceOptions, ReferenceSuggestionPluginKey, referenceMarkdown } from "./reference.js";
+import { normalizeReferences, referencesFromText } from "./reference-text.js";
+import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeOptions, CompositeStorage, CompositeTagsNode, CompositeTitleNode, blockTypesOf, compositeBasketsOf, compositeJSON } from "./nodes.js";
+import { compositeSchemaExtensions } from "./schema.js";
+import { BlockProperties, blockPropertiesAt, blockPropertiesOf, carriesProperties, metaWithProperty, propertyHostOf, setBlockProperty } from "./properties.js";
+import { CompositeBacklink, CompositeMention, CompositeReference, CompositeRow, compositeBacklinks, compositeDescriptionText, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeTags } from "./rows.js";
+import { CompositeAnchor, CompositeAnchorsHandle, CompositeFrame, compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
 import { CompositeNodeViews, compositeNodes } from "./node-views.js";
 import { CompositeFeatureOptions, CompositesUi, compositeFeatureCore } from "./feature.js";
 import { CompositeFocus, CompositeFocusState, compositeFocusKey, compositeFocusOf, focusDecorations } from "./focus.js";
@@ -13,8 +25,8 @@ import { documentCompositeMarkdown, headingsMarkdown, markdownFileName } from ".
 import { MoveVerdict, OutlineNode, canMoveBlockInto, compositeOutline, moveBlockInto, moveIntoVerdict } from "./outline.js";
 import { SourceLocator, SourceReveal, parseLocator, revealSource, seekSource } from "./reveal-source.js";
 import { AcceptedChildren, AcceptedChildrenOptions } from "./accepted-children.js";
-import { CompositeKindCount, CompositeRowsHandle, CompositeRowsState, createCompositeRows } from "./rows-model.js";
-import { CompositeInspector, CompositeInspectorSection, CompositeInspectorState, CompositeKindOption, compositeFieldText, createCompositeInspector } from "./inspector-model.js";
+import { BlockTypeCount, CompositeRowsHandle, CompositeRowsState, createCompositeRows } from "./rows-model.js";
+import { BlockTypeOption, CompositeInspector, CompositeInspectorSection, CompositeInspectorState, InspectorDerivation, compositeFieldText, createCompositeInspector } from "./inspector-model.js";
 import { ReferenceTarget, referenceLabel, referenceTarget, referenceTitle } from "./reference-label.js";
 import { referenceSuggestion } from "./reference-suggestion.js";
 import { CompositeMerge, mergeBody } from "./merge.js";
@@ -22,14 +34,4 @@ import { CompositeSplit, CompositeSplitOptions, SplitMode, childKindFor, generat
 import { Structure, StructureStorage, structureOf } from "./structure.js";
 import { STRUCTURE_MODE_KEYS } from "./structure-mode.js";
 import { TREE_ROOT_KEYS } from "./tree-root.js";
-import { compositeConversions, convertCompositeBlocks } from "./convert.js";
-import { CompositeFence, FenceSegment, splitCompositeFences } from "../../core/fences.js";
-import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
-import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
-import { BASKET_KEY, BIB_KEY, DERIVATION_KEY, TITLE_HIDDEN_KEY } from "./meta-keys.js";
-import { bibOf, bibtexOf, citeFull, citeShort, cslOf, cslTypeOptions, yearOf } from "./bibliography.js";
-import { Derivation, DerivationMethod, DerivationSource, bodyMarkdown, derivationOf, derivationState, renditionsOf, sourceOf } from "./derivation.js";
-import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
-import { normalizeReferences, referencesFromText } from "./reference-text.js";
-import { compositeSchemaExtensions } from "./schema.js";
-export { AcceptedChildren, type AcceptedChildrenOptions, BASKET_IDS, BASKET_KEY, BIB_KEY, type Basket, COMPOSITE_CHROME_COUNT, CSL_TYPES, type CompositeAiBrief, type CompositeAnchor, type CompositeAnchorsHandle, type CompositeBacklink, CompositeDescriptionNode, type CompositeFeatureOptions, type CompositeFence, CompositeFocus, type CompositeFocusState, type CompositeFrame, type CompositeInspector, type CompositeInspectorSection, type CompositeInspectorState, type CompositeKind, type CompositeKindAi, type CompositeKindCount, type CompositeKindOption, type CompositeMention, CompositeMerge, type CompositeMetaField, CompositeNode, type CompositeNodeViews, type CompositeOptions, type CompositeReference, type CompositeRow, type CompositeRowsHandle, type CompositeRowsState, CompositeSplit, type CompositeSplitOptions, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type CompositesUi, type CslDate, type CslItem, type CslName, type CslType, DERIVATION_KEY, type Derivation, type DerivationMethod, type DerivationSource, type FenceSegment, LEGACY_COMPOSITE_NODE, type MoveVerdict, type OutlineNode, REFERENCE_NODE, type ReferenceAttrs, ReferenceNode, type ReferenceOptions, ReferenceSuggestionPluginKey, type ReferenceTarget, SOURCE_MEDIA_TYPES, STRUCTURE_MODE_KEYS, type SourceLocator, SourceReveal, type SplitMode, Structure, type StructureStorage, TITLE_HIDDEN_KEY, TREE_ROOT_KEYS, basketById, basketOf, bibOf, bibtexOf, blocksFromMarkdown, bodyMarkdown, canMoveBlockInto, childKindFor, citeFull, citeShort, compositeAiBrief, compositeBacklinks, compositeBasketsOf, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFocusKey, compositeFocusOf, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, cslOf, cslTypeOptions, defaultBaskets, defaultCompositeKinds, derivationOf, derivationState, documentCompositeMarkdown, flattenCompositesToHeadings, focusDecorations, generatedTitle, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, mergeBody, migrateLegacyContent, moveBlockInto, moveIntoVerdict, normalizeReferences, observeCompositeAnchors, parseLocator, referenceLabel, referenceMarkdown, referenceSuggestion, referenceTarget, referenceTitle, referencesFromText, renditionsOf, revealSource, seekSource, setCompositeDescription, setCompositeMetaField, setCompositeTags, sourceOf, splitBodyByLength, splitComposite, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf, titleHiddenOf, yearOf };
+export { AcceptedChildren, type AcceptedChildrenOptions, BASKET_IDS, BASKET_KEY, BIB_KEY, type Basket, type BlockProperties, type BlockType, type BlockTypeAi, type BlockTypeCount, BlockTypeJsonError, type BlockTypeJsonIssue, type BlockTypeOption, COMPOSITE_CHROME_COUNT, CSL_TYPES, type CompositeAiBrief, type CompositeAnchor, type CompositeAnchorsHandle, type CompositeBacklink, CompositeDescriptionNode, type CompositeFeatureOptions, type CompositeFence, CompositeFocus, type CompositeFocusState, type CompositeFrame, type CompositeInspector, type CompositeInspectorSection, type CompositeInspectorState, type CompositeMention, CompositeMerge, CompositeNode, type CompositeNodeViews, type CompositeOptions, type CompositeReference, type CompositeRow, type CompositeRowsHandle, type CompositeRowsState, CompositeSplit, type CompositeSplitOptions, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type CompositesUi, type CslDate, type CslItem, type CslName, type CslType, type FenceSegment, type InspectorDerivation, type MoveVerdict, type OutlineNode, REFERENCE_NODE, type ReferenceAttrs, ReferenceNode, type ReferenceOptions, ReferenceSuggestionPluginKey, type ReferenceTarget, SOURCE_MEDIA_TYPES, STRUCTURE_MODE_KEYS, type SourceLocator, SourceReveal, type SplitMode, Structure, type StructureStorage, TITLE_HIDDEN_KEY, TREE_ROOT_KEYS, acceptsChild, acceptsImport, aiBlockTypesOf, basketById, basketOf, bibOf, bibtexOf, blockPropertiesAt, blockPropertiesOf, blockTypeOf, blockTypesOf, blocksFromMarkdown, bodyMarkdown, canMoveBlockInto, carriesProperties, childKindFor, citeFull, citeShort, compositeAiBrief, compositeBacklinks, compositeBasketsOf, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFocusKey, compositeFocusOf, compositeFromMarkdown, compositeJSON, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, cslOf, cslTypeOptions, defaultBaskets, defaultBlockTypes, documentCompositeMarkdown, flattenCompositesToHeadings, focusDecorations, generatedTitle, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, isRootBlockType, markdownFileName, mergeBlockTypes, mergeBody, metaWithProperty, migrateLegacyContent, moveBlockInto, moveIntoVerdict, normalizeReferences, observeCompositeAnchors, parseBlockTypes, parseLocator, propertyHostOf, referenceLabel, referenceMarkdown, referenceSuggestion, referenceTarget, referenceTitle, referencesFromText, revealSource, seekSource, setBlockProperty, setCompositeDescription, setCompositeTags, sourceOf, splitBodyByLength, splitComposite, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf, titleHiddenOf, yearOf };

package/dist/features/composites/index.js

@@ -1,17 +1,19 @@
 import { splitCompositeFences } from "../../core/fences.js";
-import { SOURCE_MEDIA_TYPES, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
-import { BASKET_KEY, BIB_KEY, DERIVATION_KEY, TITLE_HIDDEN_KEY } from "./meta-keys.js";
+import { SOURCE_MEDIA_TYPES, acceptsChild, acceptsImport, aiBlockTypesOf, blockTypeOf, defaultBlockTypes, isRootBlockType } from "./block-types.js";
+import { BASKET_KEY, BIB_KEY, TITLE_HIDDEN_KEY } from "./meta-keys.js";
 import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
 import { BASKET_IDS, basketById, basketOf, defaultBaskets, titleHiddenOf } from "./baskets.js";
-import { bodyMarkdown, derivationOf, derivationState, renditionsOf, sourceOf } from "./derivation.js";
 import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
-import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, compositeBasketsOf, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, blockTypesOf, compositeBasketsOf, compositeJSON } from "./nodes.js";
 import { REFERENCE_NODE, ReferenceNode, ReferenceSuggestionPluginKey, referenceMarkdown } from "./reference.js";
 import { CSL_TYPES } from "../../core/backend-types.js";
 import { bibOf, bibtexOf, citeFull, citeShort, cslOf, cslTypeOptions, yearOf } from "./bibliography.js";
 import { compositeAiBrief } from "./ai-brief.js";
 import { compositeConversions, convertCompositeBlocks } from "./convert.js";
-import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+import { bodyMarkdown, sourceOf } from "./source.js";
+import { blockPropertiesAt, blockPropertiesOf, carriesProperties, metaWithProperty, propertyHostOf, setBlockProperty } from "./properties.js";
+import { BlockTypeJsonError, mergeBlockTypes, parseBlockTypes } from "./block-types-json.js";
+import { migrateLegacyContent } from "./legacy.js";
 import { normalizeReferences, referencesFromText } from "./reference-text.js";
 import { compositeSchemaExtensions } from "./schema.js";
 import { AcceptedChildren } from "./accepted-children.js";
@@ -20,7 +22,7 @@ import { compositeNodes } from "./node-views.js";
 import { CompositeFocus, compositeFocusKey, compositeFocusOf, focusDecorations } from "./focus.js";
 import { CompositeMerge, mergeBody } from "./merge.js";
 import { referenceLabel, referenceTarget, referenceTitle } from "./reference-label.js";
-import { compositeBacklinks, compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
+import { compositeBacklinks, compositeDescriptionText, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeTags } from "./rows.js";
 import { referenceSuggestion } from "./reference-suggestion.js";
 import { SourceReveal, parseLocator, revealSource, seekSource } from "./reveal-source.js";
 import { CompositeSplit, childKindFor, generatedTitle, splitBodyByLength, splitComposite } from "./split.js";
@@ -32,4 +34,4 @@ import { createCompositeRows } from "./rows-model.js";
 import { TREE_ROOT_KEYS } from "./tree-root.js";
 import { compositeFieldText, createCompositeInspector } from "./inspector-model.js";
 import { canMoveBlockInto, compositeOutline, moveBlockInto, moveIntoVerdict } from "./outline.js";
-export { AcceptedChildren, BASKET_IDS, BASKET_KEY, BIB_KEY, COMPOSITE_CHROME_COUNT, CSL_TYPES, CompositeDescriptionNode, CompositeFocus, CompositeMerge, CompositeNode, CompositeSplit, CompositeTagsNode, CompositeTitleNode, DERIVATION_KEY, LEGACY_COMPOSITE_NODE, REFERENCE_NODE, ReferenceNode, ReferenceSuggestionPluginKey, SOURCE_MEDIA_TYPES, STRUCTURE_MODE_KEYS, SourceReveal, Structure, TITLE_HIDDEN_KEY, TREE_ROOT_KEYS, basketById, basketOf, bibOf, bibtexOf, blocksFromMarkdown, bodyMarkdown, canMoveBlockInto, childKindFor, citeFull, citeShort, compositeAiBrief, compositeBacklinks, compositeBasketsOf, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFocusKey, compositeFocusOf, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, cslOf, cslTypeOptions, defaultBaskets, defaultCompositeKinds, derivationOf, derivationState, documentCompositeMarkdown, flattenCompositesToHeadings, focusDecorations, generatedTitle, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, mergeBody, migrateLegacyContent, moveBlockInto, moveIntoVerdict, normalizeReferences, observeCompositeAnchors, parseLocator, referenceLabel, referenceMarkdown, referenceSuggestion, referenceTarget, referenceTitle, referencesFromText, renditionsOf, revealSource, seekSource, setCompositeDescription, setCompositeMetaField, setCompositeTags, sourceOf, splitBodyByLength, splitComposite, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf, titleHiddenOf, yearOf };
+export { AcceptedChildren, BASKET_IDS, BASKET_KEY, BIB_KEY, BlockTypeJsonError, COMPOSITE_CHROME_COUNT, CSL_TYPES, CompositeDescriptionNode, CompositeFocus, CompositeMerge, CompositeNode, CompositeSplit, CompositeTagsNode, CompositeTitleNode, REFERENCE_NODE, ReferenceNode, ReferenceSuggestionPluginKey, SOURCE_MEDIA_TYPES, STRUCTURE_MODE_KEYS, SourceReveal, Structure, TITLE_HIDDEN_KEY, TREE_ROOT_KEYS, acceptsChild, acceptsImport, aiBlockTypesOf, basketById, basketOf, bibOf, bibtexOf, blockPropertiesAt, blockPropertiesOf, blockTypeOf, blockTypesOf, blocksFromMarkdown, bodyMarkdown, canMoveBlockInto, carriesProperties, childKindFor, citeFull, citeShort, compositeAiBrief, compositeBacklinks, compositeBasketsOf, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFocusKey, compositeFocusOf, compositeFromMarkdown, compositeJSON, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, cslOf, cslTypeOptions, defaultBaskets, defaultBlockTypes, documentCompositeMarkdown, flattenCompositesToHeadings, focusDecorations, generatedTitle, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, isRootBlockType, markdownFileName, mergeBlockTypes, mergeBody, metaWithProperty, migrateLegacyContent, moveBlockInto, moveIntoVerdict, normalizeReferences, observeCompositeAnchors, parseBlockTypes, parseLocator, propertyHostOf, referenceLabel, referenceMarkdown, referenceSuggestion, referenceTarget, referenceTitle, referencesFromText, revealSource, seekSource, setBlockProperty, setCompositeDescription, setCompositeTags, sourceOf, splitBodyByLength, splitComposite, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf, titleHiddenOf, yearOf };

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

@@ -1,35 +1,58 @@
 import { ReadonlyStore } from "../../core/store.js";
-import { CompositeMetaField } from "./kinds.js";
-import { CompositeRow } from "./rows.js";
+import { PropertyDefinition } from "../../core/properties.js";
+import { Derivation } from "../../core/derivation.js";
+import { BlockProperties } from "./properties.js";
 import { CompositeRowsState } from "./rows-model.js";
 import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
 //#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 {
+/** Which section of the inspector shows: the document's facts, or the properties of the Typed block under the caret. */
+export type CompositeInspectorSection = 'document' | 'typedBlock';
+/** A Block type the Typed block can be switched to, as the Block type select lists it. */
+export interface BlockTypeOption {
   value: string;
   label: string;
   icon: string;
 }
+/**
+ * The Derivation of the block the Block properties section shows, for a block whose capabilities include `derived`. `node` is
+ * that block, for the origin display; `sourceMissing` is the source-missing state of its Derivation (the original was deleted).
+ */
+export interface InspectorDerivation {
+  node: Node$1;
+  derivation: Derivation;
+  sourceMissing: boolean;
+}
 /** 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'`. */
+  /** `'typedBlock'` only while the caret last was in the editor and a Typed block 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. */
+  /** The description text as the user sees it in the focused Typed block'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. */
+  kindOptions: BlockTypeOption[];
+  /** How many Typed blocks have a description. */
   summarized: number;
-  /** The focused Baustein has a description. */
+  /** The focused Typed block has a description. */
   hasSummary: boolean;
+  /**
+   * The Block properties section: the properties of the innermost block around the caret that carries property values, with the
+   * Property definitions its Block type declares through the `properties` capability (`definitions`; empty when it has none). Null
+   * outside such a block. The section is shown for any block that has the capability, not for a particular node type.
+   */
+  properties: BlockProperties | null;
+  /**
+   * The Derivation of the block in `properties` when it is a Derived block (its capabilities include `derived`), whatever its Block
+   * type, with the source-missing state. Null for a block that is not Derived, and for one whose Block type lists a `derivation`
+   * Property definition: that definition already shows it among `properties.definitions`, so it never shows twice.
+   */
+  derivation: InspectorDerivation | null;
 }
 /** The inspector model of an editor: observable `state`, the actions of the panel, and `dispose()`. */
 export interface CompositeInspector {
@@ -39,11 +62,11 @@ export interface CompositeInspector {
    * 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. */
+  /** Switches the focused Typed block to `kind`; ignored when it already has it or no Typed block 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.
+   * on `blurDescription`; the Typed block focused at the first call of a pending draft is the one that is written.
    */
   inputDescription: (text: string) => void;
   /**
@@ -52,33 +75,33 @@ export interface CompositeInspector {
    * started) it shows the peer's text.
    */
   blurDescription: () => void;
-  /** Replaces the tags of the focused Baustein. */
+  /** Replaces the tags of the focused Typed block. */
   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. */
+  /** Creates the tag `raw` (normalized) on the focused Typed block 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 the text `value` to the meta `field` of the focused Baustein; ignored while the editor is not editable and
+   * Writes the text `value` to the property `field` of the block in `state.properties`; ignored while the editor is not editable and
    * for structured fields (`isStructuredField`), whose values are not text and have their own editors.
    */
-  setField: (field: CompositeMetaField, value: unknown) => void;
+  setField: (field: PropertyDefinition, 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;
+export declare function compositeFieldText(row: Pick<BlockProperties, 'meta'> | null, field: Pick<PropertyDefinition, 'key'>): string;
 /**
- * The properties panel of `editor`: which section shows, the focused Baustein's description draft, the tag search
+ * The properties panel of `editor`: which section shows, the focused Typed block'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.
+ * has the focus). A deleted Typed block 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).
@@ -86,8 +109,8 @@ export declare function compositeFieldText(row: Pick<CompositeRow, 'meta'> | nul
  * 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
+ * 600 ms after typing pauses, on blur, when another Typed block takes the focus (before the draft is replaced), when
+ * the panel leaves the Typed block 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.
  *