@ecsplico/editor 2.1.1 → 3.0.0

package/dist/features/composites/kinds.js

@@ -1,5 +1,12 @@
 import { createTranslator } from "../../i18n/index.js";
 //#region src/features/composites/kinds.ts
+/** Media block types a source-holding kind's source may be (`CompositeKind.source`). */
+const SOURCE_MEDIA_TYPES = [
+	"image",
+	"audio",
+	"video",
+	"file"
+];
 /**
 * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field
 * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own
@@ -67,7 +74,8 @@ function buildDefaultKinds(t) {
 			icon: "i-lucide-sticky-note",
 			titlePlaceholder: t("composites.kind.note.title"),
 			descriptionPlaceholder: t("composites.kind.note.description"),
-			fields: []
+			fields: [],
+			ai: { purpose: "Eigene Notiz zu einer Quelle oder einem Thema: Zusammenfassung, Gedanken, offene Fragen." }
 		},
 		{
 			id: "document",
@@ -75,6 +83,7 @@ function buildDefaultKinds(t) {
 			icon: "i-lucide-file-text",
 			titlePlaceholder: t("composites.kind.document.title"),
 			descriptionPlaceholder: t("composites.kind.document.description"),
+			source: [...SOURCE_MEDIA_TYPES],
 			fields: [
 				{
 					key: "filename",
@@ -95,13 +104,118 @@ function buildDefaultKinds(t) {
 					key: "importedAt",
 					label: t("composites.kind.document.field.importedAt"),
 					type: "date"
+				}
+			]
+		},
+		{
+			id: "recording",
+			label: t("composites.kind.recording.label"),
+			icon: "i-lucide-mic",
+			titlePlaceholder: t("composites.kind.recording.title"),
+			descriptionPlaceholder: t("composites.kind.recording.description"),
+			accepts: "all",
+			source: ["audio", "video"],
+			fields: [
+				...importFields(t, "recording"),
+				{
+					key: "recordedAt",
+					label: t("composites.kind.recording.field.recordedAt"),
+					type: "date"
+				},
+				{
+					key: "participants",
+					label: t("composites.kind.recording.field.participants"),
+					type: "text"
 				},
 				{
-					key: "transcript",
-					label: t("composites.kind.document.field.transcript"),
-					type: "textarea"
+					key: "durationSeconds",
+					label: t("composites.kind.recording.field.durationSeconds"),
+					type: "number"
 				}
-			]
+			],
+			ai: { purpose: "Aufnahme (Audio oder Video) als Quelle; der Inhalt hält Lesefassungen wie das Transkript und eigene Notizen." }
+		},
+		{
+			id: "paper",
+			label: t("composites.kind.paper.label"),
+			icon: "i-lucide-scroll-text",
+			titlePlaceholder: t("composites.kind.paper.title"),
+			descriptionPlaceholder: t("composites.kind.paper.description"),
+			accepts: "all",
+			source: ["file"],
+			fields: [
+				...importFields(t, "paper"),
+				{
+					key: "bib",
+					label: t("composites.kind.paper.field.bib"),
+					type: "bibliography"
+				},
+				{
+					key: "doi",
+					label: t("composites.kind.paper.field.doi"),
+					type: "text"
+				}
+			],
+			ai: { purpose: "Wissenschaftliche Arbeit als Quelle (PDF) mit Literaturangabe; der Inhalt hält Volltext, Zusammenfassungen und Notizen." }
+		},
+		{
+			id: "book",
+			label: t("composites.kind.book.label"),
+			icon: "i-lucide-book",
+			titlePlaceholder: t("composites.kind.book.title"),
+			descriptionPlaceholder: t("composites.kind.book.description"),
+			accepts: "all",
+			source: ["file"],
+			fields: [
+				...importFields(t, "book"),
+				{
+					key: "bib",
+					label: t("composites.kind.book.field.bib"),
+					type: "bibliography"
+				},
+				{
+					key: "isbn",
+					label: t("composites.kind.book.field.isbn"),
+					type: "text"
+				}
+			],
+			ai: { purpose: "Buch als Quelle (PDF) mit Literaturangabe; der Inhalt hält den Volltext, gegliedert in Kapitel, und Notizen." }
+		},
+		{
+			id: "figure",
+			label: t("composites.kind.figure.label"),
+			icon: "i-lucide-image",
+			titlePlaceholder: t("composites.kind.figure.title"),
+			descriptionPlaceholder: t("composites.kind.figure.description"),
+			accepts: "all",
+			source: ["image"],
+			fields: [...importFields(t, "figure"), {
+				key: "credit",
+				label: t("composites.kind.figure.field.credit"),
+				type: "text"
+			}],
+			ai: { purpose: "Bild als Quelle; der Inhalt hält die Bildbeschreibung und eigene Notizen." }
+		},
+		{
+			id: "rendition",
+			label: t("composites.kind.rendition.label"),
+			icon: "i-lucide-captions",
+			titlePlaceholder: t("composites.kind.rendition.title"),
+			descriptionPlaceholder: t("composites.kind.rendition.description"),
+			accepts: "all",
+			fields: [{
+				key: "derivation",
+				label: t("composites.kind.rendition.field.derivation"),
+				type: "derivation"
+			}, {
+				key: "language",
+				label: t("composites.kind.rendition.field.language"),
+				type: "text"
+			}],
+			ai: {
+				purpose: "Lesbare Fassung einer Quelle (Transkript, Volltext, Beschreibung, Übersetzung)",
+				instructions: "Übertrage den Inhalt vollständig und gut lesbar; nichts weglassen, nichts hinzuerfinden."
+			}
 		},
 		{
 			id: "folder",
@@ -113,6 +227,31 @@ function buildDefaultKinds(t) {
 		}
 	];
 }
+/** The four fields the import of a file fills in (`wrapImport` of `composite-media`), shared by every source-holding kind. */
+function importFields(t, kind) {
+	return [
+		{
+			key: "filename",
+			label: t(`composites.kind.${kind}.field.filename`),
+			type: "text"
+		},
+		{
+			key: "mimeType",
+			label: t(`composites.kind.${kind}.field.mimeType`),
+			type: "text"
+		},
+		{
+			key: "size",
+			label: t(`composites.kind.${kind}.field.size`),
+			type: "number"
+		},
+		{
+			key: "importedAt",
+			label: t(`composites.kind.${kind}.field.importedAt`),
+			type: "date"
+		}
+	];
+}
 /** The built-in kinds in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */
 const fallbackCompositeKinds = () => defaultCompositeKinds(DEFAULT_TRANSLATE);
 const DEFAULT_TRANSLATE = createTranslator();
@@ -141,6 +280,6 @@ function kindAccepts(kinds, parentKind, childKind) {
 	return accepts === "all" || accepts.includes(childKind);
 }
 //#endregion
-export { compositeKind, defaultCompositeKinds, fallbackCompositeKinds, kindAccepts };
+export { SOURCE_MEDIA_TYPES, 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   * 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"}
+{"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/** Media block types a source-holding kind's source may be (`CompositeKind.source`). */\nexport const SOURCE_MEDIA_TYPES = ['image', 'audio', 'video', 'file'] as const\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  /** `bibliography`: CSL-JSON item under `meta.bib`; `derivation`: read-only provenance of a derived Baustein; `reference`: block id of another Baustein. */\n  type: 'text' | 'textarea' | 'date' | 'number' | 'select' | 'reference' | 'bibliography' | 'derivation'\n  /** Choices of a `select` field. */\n  options?: { value: string, label: string }[]\n  /** `reference`: kind ids the field may point to; absent = any Baustein. */\n  targets?: readonly 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  /** Present on source-holding kinds: the media block types the kind's source may be; `sourceOf` returns the first body child of one of these. */\n  source?: readonly (typeof SOURCE_MEDIA_TYPES)[number][]\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    // i18n-ignore: model-facing kind purpose (German prompt text, not UI)\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: [], ai: { purpose: 'Eigene Notiz zu einer Quelle oder einem Thema: Zusammenfassung, Gedanken, offene Fragen.' } },\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'), source: [...SOURCE_MEDIA_TYPES], 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    ] },\n    // i18n-ignore-start: model-facing kind purposes and instructions (German prompt text, not UI)\n    { id: 'recording', label: t('composites.kind.recording.label'), icon: 'i-lucide-mic', titlePlaceholder: t('composites.kind.recording.title'), descriptionPlaceholder: t('composites.kind.recording.description'), accepts: 'all', source: ['audio', 'video'], fields: [\n      ...importFields(t, 'recording'),\n      { key: 'recordedAt', label: t('composites.kind.recording.field.recordedAt'), type: 'date' },\n      { key: 'participants', label: t('composites.kind.recording.field.participants'), type: 'text' },\n      { key: 'durationSeconds', label: t('composites.kind.recording.field.durationSeconds'), type: 'number' },\n    ], ai: { purpose: 'Aufnahme (Audio oder Video) als Quelle; der Inhalt hält Lesefassungen wie das Transkript und eigene Notizen.' } },\n    { id: 'paper', label: t('composites.kind.paper.label'), icon: 'i-lucide-scroll-text', titlePlaceholder: t('composites.kind.paper.title'), descriptionPlaceholder: t('composites.kind.paper.description'), accepts: 'all', source: ['file'], fields: [\n      ...importFields(t, 'paper'),\n      { key: 'bib', label: t('composites.kind.paper.field.bib'), type: 'bibliography' },\n      { key: 'doi', label: t('composites.kind.paper.field.doi'), type: 'text' },\n    ], ai: { purpose: 'Wissenschaftliche Arbeit als Quelle (PDF) mit Literaturangabe; der Inhalt hält Volltext, Zusammenfassungen und Notizen.' } },\n    { id: 'book', label: t('composites.kind.book.label'), icon: 'i-lucide-book', titlePlaceholder: t('composites.kind.book.title'), descriptionPlaceholder: t('composites.kind.book.description'), accepts: 'all', source: ['file'], fields: [\n      ...importFields(t, 'book'),\n      { key: 'bib', label: t('composites.kind.book.field.bib'), type: 'bibliography' },\n      { key: 'isbn', label: t('composites.kind.book.field.isbn'), type: 'text' },\n    ], ai: { purpose: 'Buch als Quelle (PDF) mit Literaturangabe; der Inhalt hält den Volltext, gegliedert in Kapitel, und Notizen.' } },\n    { id: 'figure', label: t('composites.kind.figure.label'), icon: 'i-lucide-image', titlePlaceholder: t('composites.kind.figure.title'), descriptionPlaceholder: t('composites.kind.figure.description'), accepts: 'all', source: ['image'], fields: [\n      ...importFields(t, 'figure'),\n      { key: 'credit', label: t('composites.kind.figure.field.credit'), type: 'text' },\n    ], ai: { purpose: 'Bild als Quelle; der Inhalt hält die Bildbeschreibung und eigene Notizen.' } },\n    { id: 'rendition', label: t('composites.kind.rendition.label'), icon: 'i-lucide-captions', titlePlaceholder: t('composites.kind.rendition.title'), descriptionPlaceholder: t('composites.kind.rendition.description'), accepts: 'all', fields: [\n      { key: 'derivation', label: t('composites.kind.rendition.field.derivation'), type: 'derivation' },\n      { key: 'language', label: t('composites.kind.rendition.field.language'), type: 'text' },\n    ], ai: {\n      purpose: 'Lesbare Fassung einer Quelle (Transkript, Volltext, Beschreibung, Übersetzung)',\n      instructions: 'Übertrage den Inhalt vollständig und gut lesbar; nichts weglassen, nichts hinzuerfinden.',\n    } },\n    // i18n-ignore-end\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 four fields the import of a file fills in (`wrapImport` of `composite-media`), shared by every source-holding kind. */\nfunction importFields(t: Translate, kind: 'recording' | 'paper' | 'book' | 'figure'): CompositeMetaField[] {\n  return [\n    { key: 'filename', label: t(`composites.kind.${kind}.field.filename`), type: 'text' },\n    { key: 'mimeType', label: t(`composites.kind.${kind}.field.mimeType`), type: 'text' },\n    { key: 'size', label: t(`composites.kind.${kind}.field.size`), type: 'number' },\n    { key: 'importedAt', label: t(`composites.kind.${kind}.field.importedAt`), type: 'date' },\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":";;;AAIA,MAAa,qBAAqB;CAAC;CAAS;CAAS;CAAS;AAAM;;;;;;;AAuDpE,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;EAEF;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAwB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ,CAAC;GAAG,IAAI,EAAE,SAAS,2FAA2F;EAAE;EAC9T;GAAE,IAAI;GAAY,OAAO,EAAE,gCAAgC;GAAG,MAAM;GAAsB,kBAAkB,EAAE,gCAAgC;GAAG,wBAAwB,EAAE,sCAAsC;GAAG,QAAQ,CAAC,GAAG,kBAAkB;GAAG,QAAQ;IAC3P;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;GAC3F;EAAE;EAEF;GAAE,IAAI;GAAa,OAAO,EAAE,iCAAiC;GAAG,MAAM;GAAgB,kBAAkB,EAAE,iCAAiC;GAAG,wBAAwB,EAAE,uCAAuC;GAAG,SAAS;GAAO,QAAQ,CAAC,SAAS,OAAO;GAAG,QAAQ;IACpQ,GAAG,aAAa,GAAG,WAAW;IAC9B;KAAE,KAAK;KAAc,OAAO,EAAE,4CAA4C;KAAG,MAAM;IAAO;IAC1F;KAAE,KAAK;KAAgB,OAAO,EAAE,8CAA8C;KAAG,MAAM;IAAO;IAC9F;KAAE,KAAK;KAAmB,OAAO,EAAE,iDAAiD;KAAG,MAAM;IAAS;GACxG;GAAG,IAAI,EAAE,SAAS,+GAA+G;EAAE;EACnI;GAAE,IAAI;GAAS,OAAO,EAAE,6BAA6B;GAAG,MAAM;GAAwB,kBAAkB,EAAE,6BAA6B;GAAG,wBAAwB,EAAE,mCAAmC;GAAG,SAAS;GAAO,QAAQ,CAAC,MAAM;GAAG,QAAQ;IAClP,GAAG,aAAa,GAAG,OAAO;IAC1B;KAAE,KAAK;KAAO,OAAO,EAAE,iCAAiC;KAAG,MAAM;IAAe;IAChF;KAAE,KAAK;KAAO,OAAO,EAAE,iCAAiC;KAAG,MAAM;IAAO;GAC1E;GAAG,IAAI,EAAE,SAAS,0HAA0H;EAAE;EAC9I;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAiB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,SAAS;GAAO,QAAQ,CAAC,MAAM;GAAG,QAAQ;IACvO,GAAG,aAAa,GAAG,MAAM;IACzB;KAAE,KAAK;KAAO,OAAO,EAAE,gCAAgC;KAAG,MAAM;IAAe;IAC/E;KAAE,KAAK;KAAQ,OAAO,EAAE,iCAAiC;KAAG,MAAM;IAAO;GAC3E;GAAG,IAAI,EAAE,SAAS,+GAA+G;EAAE;EACnI;GAAE,IAAI;GAAU,OAAO,EAAE,8BAA8B;GAAG,MAAM;GAAkB,kBAAkB,EAAE,8BAA8B;GAAG,wBAAwB,EAAE,oCAAoC;GAAG,SAAS;GAAO,QAAQ,CAAC,OAAO;GAAG,QAAQ,CACjP,GAAG,aAAa,GAAG,QAAQ,GAC3B;IAAE,KAAK;IAAU,OAAO,EAAE,qCAAqC;IAAG,MAAM;GAAO,CACjF;GAAG,IAAI,EAAE,SAAS,4EAA4E;EAAE;EAChG;GAAE,IAAI;GAAa,OAAO,EAAE,iCAAiC;GAAG,MAAM;GAAqB,kBAAkB,EAAE,iCAAiC;GAAG,wBAAwB,EAAE,uCAAuC;GAAG,SAAS;GAAO,QAAQ,CAC7O;IAAE,KAAK;IAAc,OAAO,EAAE,4CAA4C;IAAG,MAAM;GAAa,GAChG;IAAE,KAAK;IAAY,OAAO,EAAE,0CAA0C;IAAG,MAAM;GAAO,CACxF;GAAG,IAAI;IACL,SAAS;IACT,cAAc;GAChB;EAAE;EAEF;GAAE,IAAI;GAAU,OAAO,EAAE,8BAA8B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,8BAA8B;GAAG,wBAAwB,EAAE,oCAAoC;GAAG,QAAQ,CAAC;EAAE;CACtN;AACF;;AAGA,SAAS,aAAa,GAAc,MAAuE;CACzG,OAAO;EACL;GAAE,KAAK;GAAY,OAAO,EAAE,mBAAmB,KAAK,gBAAgB;GAAG,MAAM;EAAO;EACpF;GAAE,KAAK;GAAY,OAAO,EAAE,mBAAmB,KAAK,gBAAgB;GAAG,MAAM;EAAO;EACpF;GAAE,KAAK;GAAQ,OAAO,EAAE,mBAAmB,KAAK,YAAY;GAAG,MAAM;EAAS;EAC9E;GAAE,KAAK;GAAc,OAAO,EAAE,mBAAmB,KAAK,kBAAkB;GAAG,MAAM;EAAO;CAC1F;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/legacy.d.ts

@@ -2,7 +2,10 @@ import { JSONContent } from "@tiptap/core";
 //#region src/features/composites/legacy.d.ts
 /** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */
 export declare const LEGACY_COMPOSITE_NODE = "section";
-/** `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`); recursive, returns a copy. */
+/**
+ * `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`) and the flat
+ * `meta.transcript` of `document` Bausteine moved into a `rendition` child; recursive, returns a copy.
+ */
 export declare function migrateLegacyContent(json: JSONContent): JSONContent;
 //#endregion
 //# sourceMappingURL=legacy.d.ts.map

package/dist/features/composites/legacy.js

@@ -1,3 +1,6 @@
+import { DERIVATION_KEY } from "./meta-keys.js";
+import { assetRefOf } from "./derivation.js";
+import { compositeJSON } from "./nodes.js";
 //#region src/features/composites/legacy.ts
 const LEGACY_RENAMES = {
 	section: "composite",
@@ -7,7 +10,50 @@ const LEGACY_RENAMES = {
 };
 /** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */
 const LEGACY_COMPOSITE_NODE = "section";
-/** `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`); recursive, returns a copy. */
+/**
+* The Lesefassung a `document` Baustein's former `meta.transcript` (a flat string) becomes: a `rendition` child with
+* one paragraph per blank-line-separated chunk, derived by transcription from the asset of the first audio/video body
+* child. Hashes are unknown (`''`), so neither „Quelle geändert“ nor „bearbeitet“ is shown for it.
+*/
+function transcriptRendition(document, transcript) {
+	const chunks = transcript.split(/\n\s*\n/).map((chunk) => chunk.replace(/\s*\n\s*/g, " ").trim()).filter(Boolean);
+	if (!chunks.length) return null;
+	const media = document.content?.find((child) => child.type === "audio" || child.type === "video");
+	const importedAt = document.attrs?.meta?.importedAt;
+	const derivation = {
+		from: { asset: assetRefOf(String(media?.attrs?.src ?? ""))?.name ?? "" },
+		method: "transcription",
+		createdAt: typeof importedAt === "string" ? importedAt : "",
+		inputHash: "",
+		outputHash: ""
+	};
+	const json = compositeJSON("rendition", chunks.map((text) => ({
+		type: "paragraph",
+		content: [{
+			type: "text",
+			text
+		}]
+	})));
+	const [title, ...rest] = json.content;
+	return {
+		...json,
+		attrs: {
+			...json.attrs,
+			meta: { [DERIVATION_KEY]: derivation }
+		},
+		content: [{
+			...title,
+			content: [{
+				type: "text",
+				text: "Transkript"
+			}]
+		}, ...rest]
+	};
+}
+/**
+* `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`) and the flat
+* `meta.transcript` of `document` Bausteine moved into a `rendition` child; recursive, returns a copy.
+*/
 function migrateLegacyContent(json) {
 	const renamed = json.type ? LEGACY_RENAMES[json.type] : void 0;
 	const result = { ...json };
@@ -17,6 +63,15 @@ function migrateLegacyContent(json) {
 		kind: "section"
 	};
 	if (json.content) result.content = json.content.map(migrateLegacyContent);
+	if (result.type === "composite" && result.attrs?.kind === "document" && typeof result.attrs.meta?.transcript === "string") {
+		const { transcript, ...meta } = result.attrs.meta;
+		result.attrs = {
+			...result.attrs,
+			meta
+		};
+		const rendition = transcriptRendition(result, String(transcript));
+		if (rendition) result.content = [...result.content ?? [], rendition];
+	}
 	return result;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"legacy.js","names":[],"sources":["../../../src/features/composites/legacy.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\n\n// Node names of the former single-purpose block that the composite family replaced (dev data only).\nconst LEGACY_RENAMES: Readonly<Record<string, string>> = {\n  section: 'composite',\n  sectionTitle: 'compositeTitle',\n  sectionSummary: 'compositeDescription',\n  sectionTags: 'compositeTags',\n}\n\n/** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */\nexport const LEGACY_COMPOSITE_NODE = 'section'\n\n/** `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`); recursive, returns a copy. */\nexport function migrateLegacyContent(json: JSONContent): JSONContent {\n  const renamed = json.type ? LEGACY_RENAMES[json.type] : undefined\n  const result: JSONContent = { ...json }\n  if (renamed) result.type = renamed\n  if (json.type === LEGACY_COMPOSITE_NODE) result.attrs = { ...json.attrs, kind: 'section' }\n  if (json.content) result.content = json.content.map(migrateLegacyContent)\n  return result\n}\n"],"mappings":";AAGA,MAAM,iBAAmD;CACvD,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,aAAa;AACf;;AAGA,MAAa,wBAAwB;;AAGrC,SAAgB,qBAAqB,MAAgC;CACnE,MAAM,UAAU,KAAK,OAAO,eAAe,KAAK,QAAQ,KAAA;CACxD,MAAM,SAAsB,EAAE,GAAG,KAAK;CACtC,IAAI,SAAS,OAAO,OAAO;CAC3B,IAAI,KAAK,SAAA,WAAgC,OAAO,QAAQ;EAAE,GAAG,KAAK;EAAO,MAAM;CAAU;CACzF,IAAI,KAAK,SAAS,OAAO,UAAU,KAAK,QAAQ,IAAI,oBAAoB;CACxE,OAAO;AACT"}
+{"version":3,"file":"legacy.js","names":[],"sources":["../../../src/features/composites/legacy.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport { assetRefOf, DERIVATION_KEY, type Derivation } from './derivation'\nimport { compositeJSON } from './nodes'\n\n// Node names of the former single-purpose block that the composite family replaced (dev data only).\nconst LEGACY_RENAMES: Readonly<Record<string, string>> = {\n  section: 'composite',\n  sectionTitle: 'compositeTitle',\n  sectionSummary: 'compositeDescription',\n  sectionTags: 'compositeTags',\n}\n\n/** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */\nexport const LEGACY_COMPOSITE_NODE = 'section'\n\n/**\n * The Lesefassung a `document` Baustein's former `meta.transcript` (a flat string) becomes: a `rendition` child with\n * one paragraph per blank-line-separated chunk, derived by transcription from the asset of the first audio/video body\n * child. Hashes are unknown (`''`), so neither „Quelle geändert“ nor „bearbeitet“ is shown for it.\n */\nfunction transcriptRendition(document: JSONContent, transcript: string): JSONContent | null {\n  const chunks = transcript.split(/\\n\\s*\\n/).map(chunk => chunk.replace(/\\s*\\n\\s*/g, ' ').trim()).filter(Boolean)\n  if (!chunks.length) return null\n  const media = document.content?.find(child => child.type === 'audio' || child.type === 'video')\n  const importedAt: unknown = document.attrs?.meta?.importedAt\n  const derivation: Derivation = {\n    from: { asset: assetRefOf(String(media?.attrs?.src ?? ''))?.name ?? '' },\n    method: 'transcription',\n    createdAt: typeof importedAt === 'string' ? importedAt : '',\n    inputHash: '',\n    outputHash: '',\n  }\n  const json = compositeJSON('rendition', chunks.map(text => ({ type: 'paragraph', content: [{ type: 'text', text }] })))\n  const [title, ...rest] = json.content!\n  return {\n    ...json,\n    attrs: { ...json.attrs, meta: { [DERIVATION_KEY]: derivation } },\n    // i18n-ignore: title of content migrated out of a stored document, not UI text\n    content: [{ ...title!, content: [{ type: 'text', text: 'Transkript' }] }, ...rest],\n  }\n}\n\n/**\n * `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`) and the flat\n * `meta.transcript` of `document` Bausteine moved into a `rendition` child; recursive, returns a copy.\n */\nexport function migrateLegacyContent(json: JSONContent): JSONContent {\n  const renamed = json.type ? LEGACY_RENAMES[json.type] : undefined\n  const result: JSONContent = { ...json }\n  if (renamed) result.type = renamed\n  if (json.type === LEGACY_COMPOSITE_NODE) result.attrs = { ...json.attrs, kind: 'section' }\n  if (json.content) result.content = json.content.map(migrateLegacyContent)\n  if (result.type === 'composite' && result.attrs?.kind === 'document' && typeof result.attrs.meta?.transcript === 'string') {\n    const { transcript, ...meta } = result.attrs.meta as Record<string, unknown>\n    result.attrs = { ...result.attrs, meta }\n    const rendition = transcriptRendition(result, String(transcript))\n    if (rendition) result.content = [...(result.content ?? []), rendition]\n  }\n  return result\n}\n"],"mappings":";;;;AAKA,MAAM,iBAAmD;CACvD,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,aAAa;AACf;;AAGA,MAAa,wBAAwB;;;;;;AAOrC,SAAS,oBAAoB,UAAuB,YAAwC;CAC1F,MAAM,SAAS,WAAW,MAAM,SAAS,CAAC,CAAC,KAAI,UAAS,MAAM,QAAQ,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO;CAC9G,IAAI,CAAC,OAAO,QAAQ,OAAO;CAC3B,MAAM,QAAQ,SAAS,SAAS,MAAK,UAAS,MAAM,SAAS,WAAW,MAAM,SAAS,OAAO;CAC9F,MAAM,aAAsB,SAAS,OAAO,MAAM;CAClD,MAAM,aAAyB;EAC7B,MAAM,EAAE,OAAO,WAAW,OAAO,OAAO,OAAO,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,GAAG;EACvE,QAAQ;EACR,WAAW,OAAO,eAAe,WAAW,aAAa;EACzD,WAAW;EACX,YAAY;CACd;CACA,MAAM,OAAO,cAAc,aAAa,OAAO,KAAI,UAAS;EAAE,MAAM;EAAa,SAAS,CAAC;GAAE,MAAM;GAAQ;EAAK,CAAC;CAAE,EAAE,CAAC;CACtH,MAAM,CAAC,OAAO,GAAG,QAAQ,KAAK;CAC9B,OAAO;EACL,GAAG;EACH,OAAO;GAAE,GAAG,KAAK;GAAO,MAAM,GAAG,iBAAiB,WAAW;EAAE;EAE/D,SAAS,CAAC;GAAE,GAAG;GAAQ,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;GAAa,CAAC;EAAE,GAAG,GAAG,IAAI;CACnF;AACF;;;;;AAMA,SAAgB,qBAAqB,MAAgC;CACnE,MAAM,UAAU,KAAK,OAAO,eAAe,KAAK,QAAQ,KAAA;CACxD,MAAM,SAAsB,EAAE,GAAG,KAAK;CACtC,IAAI,SAAS,OAAO,OAAO;CAC3B,IAAI,KAAK,SAAA,WAAgC,OAAO,QAAQ;EAAE,GAAG,KAAK;EAAO,MAAM;CAAU;CACzF,IAAI,KAAK,SAAS,OAAO,UAAU,KAAK,QAAQ,IAAI,oBAAoB;CACxE,IAAI,OAAO,SAAS,eAAe,OAAO,OAAO,SAAS,cAAc,OAAO,OAAO,MAAM,MAAM,eAAe,UAAU;EACzH,MAAM,EAAE,YAAY,GAAG,SAAS,OAAO,MAAM;EAC7C,OAAO,QAAQ;GAAE,GAAG,OAAO;GAAO;EAAK;EACvC,MAAM,YAAY,oBAAoB,QAAQ,OAAO,UAAU,CAAC;EAChE,IAAI,WAAW,OAAO,UAAU,CAAC,GAAI,OAAO,WAAW,CAAC,GAAI,SAAS;CACvE;CACA,OAAO;AACT"}

package/dist/features/composites/meta-display.js

@@ -1,9 +1,48 @@
+import { findBlockById } from "../../core/schema/block-ids.js";
+import { compositeKind } from "./kinds.js";
+import { citeShort } from "./bibliography.js";
+import { derivationMethodLabel } from "./derived-chrome.js";
 //#region src/features/composites/meta-display.ts
 /** The stored value of a meta field as editable text (`''` when unset). */
 function metaText(row, field) {
 	const value = row.meta[field.key];
 	return typeof value === "string" || typeof value === "number" ? String(value) : "";
 }
+const dateFormat = new Intl.DateTimeFormat("de-DE", {
+	day: "2-digit",
+	month: "2-digit",
+	year: "numeric"
+});
+/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */
+function formatDate(value) {
+	const match = /^(\d{4})-(\d{2})-(\d{2})/.exec(value);
+	const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value);
+	return Number.isNaN(date.getTime()) ? value : dateFormat.format(date);
+}
+/**
+* The text a field's value stands for in a table cell: `reference` the title of the Baustein it points to (its kind label
+* when untitled, `''` when it is gone or `doc` is unknown), `bibliography` the short citation, `derivation`
+* `method · date` (the method as words when `t` is given, else its stored id); every other type its stored text.
+*/
+function fieldDisplay(row, field, doc, kinds, t) {
+	const value = row.meta[field.key];
+	if (field.type === "reference") {
+		if (typeof value !== "string" || !value || !doc) return "";
+		const target = findBlockById(doc, value)?.node;
+		if (target?.type.name !== "composite") return "";
+		return target.child(0).textContent.trim() || compositeKind(kinds, String(target.attrs.kind)).label;
+	}
+	if (field.type === "bibliography") {
+		const bib = value;
+		return bib && typeof bib === "object" && typeof bib.type === "string" ? citeShort(bib, row.title) : "";
+	}
+	if (field.type === "derivation") {
+		const derivation = value;
+		if (!derivation || typeof derivation !== "object" || typeof derivation.method !== "string") return "";
+		return [t ? derivationMethodLabel(t, derivation.method) : derivation.method, derivation.createdAt ? formatDate(derivation.createdAt) : ""].filter(Boolean).join(" · ");
+	}
+	return metaText(row, field);
+}
 /** Icon and color class of the known status values; unknown values read as neutral. */
 const STATUS_STYLE = {
 	open: {
@@ -41,6 +80,6 @@ function rowStatus(row, t) {
 	};
 }
 //#endregion
-export { metaText, rowStatus, statusStyle };
+export { fieldDisplay, formatDate, metaText, rowStatus, statusStyle };
 
 //# sourceMappingURL=meta-display.js.map

package/dist/features/composites/meta-display.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-display.js","names":[],"sources":["../../../src/features/composites/meta-display.ts"],"sourcesContent":["import type { Translate } from '../../i18n'\nimport type { CompositeMetaField } from './kinds'\nimport type { CompositeRow } from './rows'\n\n/** The stored value of a meta field as editable text (`''` when unset). */\nexport function metaText(row: Pick<CompositeRow, 'meta'>, field: Pick<CompositeMetaField, 'key'>): string {\n  const value = row.meta[field.key]\n  return typeof value === 'string' || typeof value === 'number' ? String(value) : ''\n}\n\n/** Icon and color class of the known status values; unknown values read as neutral. */\nconst STATUS_STYLE: Record<string, { icon: string, color: string }> = {\n  open: { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' },\n  doing: { icon: 'i-lucide-circle-dot', color: 'text-[var(--sk-info)]' },\n  done: { icon: 'i-lucide-circle-check', color: 'text-[var(--sk-success)]' },\n}\nconst STATUS_UNSET = { icon: 'i-lucide-circle-dashed', color: 'text-[var(--sk-fg-dimmed)]' }\nconst STATUS_OTHER = { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' }\n\nexport const statusStyle = (value: string) => STATUS_STYLE[value] ?? (value ? STATUS_OTHER : STATUS_UNSET)\n\n/** A row's `status` field with its current value. */\nexport interface RowStatus {\n  field: CompositeMetaField\n  value: string\n  label: string\n  icon: string\n  color: string\n}\n\n/** The row's `status` select field with its current value, `null` for a kind without one; `t` words an unset status. */\nexport function rowStatus(row: CompositeRow, t: Translate): RowStatus | null {\n  const field = row.fields.find(candidate => candidate.key === 'status' && candidate.type === 'select')\n  if (!field) return null\n  const value = metaText(row, field)\n  return { field, value, label: field.options?.find(option => option.value === value)?.label ?? (value || t('composites.status.none')), ...statusStyle(value) }\n}\n"],"mappings":";;AAKA,SAAgB,SAAS,KAAiC,OAAgD;CACxG,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AAClF;;AAGA,MAAM,eAAgE;CACpE,MAAM;EAAE,MAAM;EAAmB,OAAO;CAAyB;CACjE,OAAO;EAAE,MAAM;EAAuB,OAAO;CAAwB;CACrE,MAAM;EAAE,MAAM;EAAyB,OAAO;CAA2B;AAC3E;AACA,MAAM,eAAe;CAAE,MAAM;CAA0B,OAAO;AAA6B;AAC3F,MAAM,eAAe;CAAE,MAAM;CAAmB,OAAO;AAAyB;AAEhF,MAAa,eAAe,UAAkB,aAAa,WAAW,QAAQ,eAAe;;AAY7F,SAAgB,UAAU,KAAmB,GAAgC;CAC3E,MAAM,QAAQ,IAAI,OAAO,MAAK,cAAa,UAAU,QAAQ,YAAY,UAAU,SAAS,QAAQ;CACpG,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,QAAQ,SAAS,KAAK,KAAK;CACjC,OAAO;EAAE;EAAO;EAAO,OAAO,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,UAAU,SAAS,EAAE,wBAAwB;EAAI,GAAG,YAAY,KAAK;CAAE;AAC9J"}
+{"version":3,"file":"meta-display.js","names":[],"sources":["../../../src/features/composites/meta-display.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\nimport { findBlockById } from '../../core/schema/block-ids'\nimport type { Translate } from '../../i18n'\nimport { type CslItem, citeShort } from './bibliography'\nimport type { Derivation } from './derivation'\nimport { derivationMethodLabel } from './derived-chrome'\nimport { type CompositeKind, type CompositeMetaField, compositeKind } from './kinds'\nimport type { CompositeRow } from './rows'\n\n/** The stored value of a meta field as editable text (`''` when unset). */\nexport function metaText(row: Pick<CompositeRow, 'meta'>, field: Pick<CompositeMetaField, 'key'>): string {\n  const value = row.meta[field.key]\n  return typeof value === 'string' || typeof value === 'number' ? String(value) : ''\n}\n\nconst dateFormat = new Intl.DateTimeFormat('de-DE', { day: '2-digit', month: '2-digit', year: 'numeric' })\n\n/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */\nexport function formatDate(value: string): string {\n  const match = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value)\n  const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value)\n  return Number.isNaN(date.getTime()) ? value : dateFormat.format(date)\n}\n\n/**\n * The text a field's value stands for in a table cell: `reference` the title of the Baustein it points to (its kind label\n * when untitled, `''` when it is gone or `doc` is unknown), `bibliography` the short citation, `derivation`\n * `method · date` (the method as words when `t` is given, else its stored id); every other type its stored text.\n */\nexport function fieldDisplay(row: Pick<CompositeRow, 'meta' | 'title'>, field: Pick<CompositeMetaField, 'key' | 'type'>, doc: PMNode | null, kinds: readonly CompositeKind[], t?: Translate): string {\n  const value = row.meta[field.key]\n  if (field.type === 'reference') {\n    if (typeof value !== 'string' || !value || !doc) return ''\n    const target = findBlockById(doc, value)?.node\n    if (target?.type.name !== 'composite') return ''\n    return target.child(0).textContent.trim() || compositeKind(kinds, String(target.attrs.kind)).label\n  }\n  if (field.type === 'bibliography') {\n    const bib = value as Partial<CslItem> | null | undefined\n    return bib && typeof bib === 'object' && typeof bib.type === 'string' ? citeShort(bib, row.title) : ''\n  }\n  if (field.type === 'derivation') {\n    const derivation = value as Partial<Derivation> | null | undefined\n    if (!derivation || typeof derivation !== 'object' || typeof derivation.method !== 'string') return ''\n    return [t ? derivationMethodLabel(t, derivation.method) : derivation.method, derivation.createdAt ? formatDate(derivation.createdAt) : ''].filter(Boolean).join(' · ')\n  }\n  return metaText(row, field)\n}\n\n/** Icon and color class of the known status values; unknown values read as neutral. */\nconst STATUS_STYLE: Record<string, { icon: string, color: string }> = {\n  open: { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' },\n  doing: { icon: 'i-lucide-circle-dot', color: 'text-[var(--sk-info)]' },\n  done: { icon: 'i-lucide-circle-check', color: 'text-[var(--sk-success)]' },\n}\nconst STATUS_UNSET = { icon: 'i-lucide-circle-dashed', color: 'text-[var(--sk-fg-dimmed)]' }\nconst STATUS_OTHER = { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' }\n\nexport const statusStyle = (value: string) => STATUS_STYLE[value] ?? (value ? STATUS_OTHER : STATUS_UNSET)\n\n/** A row's `status` field with its current value. */\nexport interface RowStatus {\n  field: CompositeMetaField\n  value: string\n  label: string\n  icon: string\n  color: string\n}\n\n/** The row's `status` select field with its current value, `null` for a kind without one; `t` words an unset status. */\nexport function rowStatus(row: CompositeRow, t: Translate): RowStatus | null {\n  const field = row.fields.find(candidate => candidate.key === 'status' && candidate.type === 'select')\n  if (!field) return null\n  const value = metaText(row, field)\n  return { field, value, label: field.options?.find(option => option.value === value)?.label ?? (value || t('composites.status.none')), ...statusStyle(value) }\n}\n"],"mappings":";;;;;;AAUA,SAAgB,SAAS,KAAiC,OAAgD;CACxG,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AAClF;AAEA,MAAM,aAAa,IAAI,KAAK,eAAe,SAAS;CAAE,KAAK;CAAW,OAAO;CAAW,MAAM;AAAU,CAAC;;AAGzG,SAAgB,WAAW,OAAuB;CAChD,MAAM,QAAQ,2BAA2B,KAAK,KAAK;CACnD,MAAM,OAAO,QAAQ,IAAI,KAAK,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,IAAI,GAAG,OAAO,MAAM,EAAE,CAAC,IAAI,IAAI,KAAK,KAAK;CACxG,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,QAAQ,WAAW,OAAO,IAAI;AACtE;;;;;;AAOA,SAAgB,aAAa,KAA2C,OAAiD,KAAoB,OAAiC,GAAuB;CACnM,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,IAAI,MAAM,SAAS,aAAa;EAC9B,IAAI,OAAO,UAAU,YAAY,CAAC,SAAS,CAAC,KAAK,OAAO;EACxD,MAAM,SAAS,cAAc,KAAK,KAAK,CAAC,EAAE;EAC1C,IAAI,QAAQ,KAAK,SAAS,aAAa,OAAO;EAC9C,OAAO,OAAO,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,cAAc,OAAO,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC,CAAC;CAC/F;CACA,IAAI,MAAM,SAAS,gBAAgB;EACjC,MAAM,MAAM;EACZ,OAAO,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,SAAS,WAAW,UAAU,KAAK,IAAI,KAAK,IAAI;CACtG;CACA,IAAI,MAAM,SAAS,cAAc;EAC/B,MAAM,aAAa;EACnB,IAAI,CAAC,cAAc,OAAO,eAAe,YAAY,OAAO,WAAW,WAAW,UAAU,OAAO;EACnG,OAAO,CAAC,IAAI,sBAAsB,GAAG,WAAW,MAAM,IAAI,WAAW,QAAQ,WAAW,YAAY,WAAW,WAAW,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CACvK;CACA,OAAO,SAAS,KAAK,KAAK;AAC5B;;AAGA,MAAM,eAAgE;CACpE,MAAM;EAAE,MAAM;EAAmB,OAAO;CAAyB;CACjE,OAAO;EAAE,MAAM;EAAuB,OAAO;CAAwB;CACrE,MAAM;EAAE,MAAM;EAAyB,OAAO;CAA2B;AAC3E;AACA,MAAM,eAAe;CAAE,MAAM;CAA0B,OAAO;AAA6B;AAC3F,MAAM,eAAe;CAAE,MAAM;CAAmB,OAAO;AAAyB;AAEhF,MAAa,eAAe,UAAkB,aAAa,WAAW,QAAQ,eAAe;;AAY7F,SAAgB,UAAU,KAAmB,GAAgC;CAC3E,MAAM,QAAQ,IAAI,OAAO,MAAK,cAAa,UAAU,QAAQ,YAAY,UAAU,SAAS,QAAQ;CACpG,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,QAAQ,SAAS,KAAK,KAAK;CACjC,OAAO;EAAE;EAAO;EAAO,OAAO,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,UAAU,SAAS,EAAE,wBAAwB;EAAI,GAAG,YAAY,KAAK;CAAE;AAC9J"}

package/dist/features/composites/meta-keys.d.ts

@@ -0,0 +1,7 @@
+//#region src/features/composites/meta-keys.d.ts
+/** Key of the derivation (provenance) in a composite's `meta`. */
+export declare const DERIVATION_KEY = "derivation";
+/** Key of the bibliographic record (`CslItem`) in a composite's `meta`. */
+export declare const BIB_KEY = "bib";
+//#endregion
+//# sourceMappingURL=meta-keys.d.ts.map

package/dist/features/composites/meta-keys.js

@@ -0,0 +1,21 @@
+//#region src/features/composites/meta-keys.ts
+/** Key of the derivation (provenance) in a composite's `meta`. */
+const DERIVATION_KEY = "derivation";
+/** Key of the bibliographic record (`CslItem`) in a composite's `meta`. */
+const BIB_KEY = "bib";
+/**
+* Whether a composite of `kind` keeps the `meta` entry `key`: the fields the kind declares, plus provenance
+* (`derivation`) and the bibliographic record (`bib`), which any kind may carry (a kind switch, a conversion and a
+* Markdown round trip must not drop them).
+*/
+function keepsMetaKey(kind, key) {
+	return key === "derivation" || key === "bib" || kind.fields.some((field) => field.key === key);
+}
+/** `meta` reduced to the entries a composite of `kind` keeps (`keepsMetaKey`). */
+function keptMeta(kind, meta) {
+	return Object.fromEntries(Object.entries(meta).filter(([key]) => keepsMetaKey(kind, key)));
+}
+//#endregion
+export { BIB_KEY, DERIVATION_KEY, keepsMetaKey, keptMeta };
+
+//# sourceMappingURL=meta-keys.js.map

package/dist/features/composites/meta-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-keys.js","names":[],"sources":["../../../src/features/composites/meta-keys.ts"],"sourcesContent":["// Vue-free and server-importable: the `meta` keys a Baustein of any kind may carry, and which meta keys a kind keeps.\nimport type { CompositeKind } from './kinds'\n\n/** Key of the derivation (provenance) in a composite's `meta`. */\nexport const DERIVATION_KEY = 'derivation'\n\n/** Key of the bibliographic record (`CslItem`) in a composite's `meta`. */\nexport const BIB_KEY = 'bib'\n\n/**\n * Whether a composite of `kind` keeps the `meta` entry `key`: the fields the kind declares, plus provenance\n * (`derivation`) and the bibliographic record (`bib`), which any kind may carry (a kind switch, a conversion and a\n * Markdown round trip must not drop them).\n */\nexport function keepsMetaKey(kind: Pick<CompositeKind, 'fields'>, key: string): boolean {\n  return key === DERIVATION_KEY || key === BIB_KEY || kind.fields.some(field => field.key === key)\n}\n\n/** `meta` reduced to the entries a composite of `kind` keeps (`keepsMetaKey`). */\nexport function keptMeta(kind: Pick<CompositeKind, 'fields'>, meta: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(meta).filter(([key]) => keepsMetaKey(kind, key)))\n}\n"],"mappings":";;AAIA,MAAa,iBAAiB;;AAG9B,MAAa,UAAU;;;;;;AAOvB,SAAgB,aAAa,MAAqC,KAAsB;CACtF,OAAO,QAAA,gBAA0B,QAAA,SAAmB,KAAK,OAAO,MAAK,UAAS,MAAM,QAAQ,GAAG;AACjG;;AAGA,SAAgB,SAAS,MAAqC,MAAwD;CACpH,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,aAAa,MAAM,GAAG,CAAC,CAAC;AAC3F"}

package/dist/features/composites/node-views.d.ts

@@ -1,17 +1,20 @@
 import { CompositeOptions, CompositeStorage } from "./nodes.js";
+import { ReferenceOptions } from "./reference.js";
 import { NodeViewRenderer } from "@tiptap/core";
 //#region src/features/composites/node-views.d.ts
-/** The node view renderer a framework binding supplies for the composite block. */
+/** The node view renderers a framework binding supplies for the composite block and the reference chip. */
 export interface CompositeNodeViews {
   composite: NodeViewRenderer;
+  reference: NodeViewRenderer;
 }
 /**
- * The composite node with the node view of a framework binding, and the tags row (data: hidden, `CompositeChrome`
- * shows and edits it, so it needs no node view). Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
+ * The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`
+ * shows and edits it, so it needs no node view) and the reference chip. Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
  */
 export declare function compositeNodes(nodeViews: CompositeNodeViews): {
   Composite: import("@tiptap/core").Node<CompositeOptions, CompositeStorage>;
   CompositeTags: import("@tiptap/core").Node<any, any>;
+  Reference: import("@tiptap/core").Node<ReferenceOptions, any>;
 };
 //#endregion
 //# sourceMappingURL=node-views.d.ts.map

package/dist/features/composites/node-views.js

@@ -1,15 +1,19 @@
 import { CompositeNode, CompositeTagsNode } from "./nodes.js";
+import { ReferenceNode } from "./reference.js";
 //#region src/features/composites/node-views.ts
 /**
-* The composite node with the node view of a framework binding, and the tags row (data: hidden, `CompositeChrome`
-* shows and edits it, so it needs no node view). Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
+* The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`
+* shows and edits it, so it needs no node view) and the reference chip. Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
 */
 function compositeNodes(nodeViews) {
 	return {
 		Composite: CompositeNode.extend({ addNodeView() {
 			return nodeViews.composite;
 		} }),
-		CompositeTags: CompositeTagsNode
+		CompositeTags: CompositeTagsNode,
+		Reference: ReferenceNode.extend({ addNodeView() {
+			return nodeViews.reference;
+		} })
 	};
 }
 //#endregion

package/dist/features/composites/node-views.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-views.js","names":[],"sources":["../../../src/features/composites/node-views.ts"],"sourcesContent":["import type { NodeViewRenderer } from '@tiptap/core'\nimport { CompositeNode, CompositeTagsNode } from './nodes'\n\n/** The node view renderer a framework binding supplies for the composite block. */\nexport interface CompositeNodeViews {\n  composite: NodeViewRenderer\n}\n\n/**\n * The composite node with the node view of a framework binding, and the tags row (data: hidden, `CompositeChrome`\n * shows and edits it, so it needs no node view). Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.\n */\nexport function compositeNodes(nodeViews: CompositeNodeViews) {\n  return {\n    // Explicit return type: the node views import `compositeKindsOf`, so inference would otherwise be circular.\n    Composite: CompositeNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.composite\n      },\n    }),\n    CompositeTags: CompositeTagsNode,\n  }\n}\n"],"mappings":";;;;;;AAYA,SAAgB,eAAe,WAA+B;CAC5D,OAAO;EAEL,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;EACD,eAAe;CACjB;AACF"}
+{"version":3,"file":"node-views.js","names":[],"sources":["../../../src/features/composites/node-views.ts"],"sourcesContent":["import type { NodeViewRenderer } from '@tiptap/core'\nimport { CompositeNode, CompositeTagsNode } from './nodes'\nimport { ReferenceNode } from './reference'\n\n/** The node view renderers a framework binding supplies for the composite block and the reference chip. */\nexport interface CompositeNodeViews {\n  composite: NodeViewRenderer\n  reference: NodeViewRenderer\n}\n\n/**\n * The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`\n * shows and edits it, so it needs no node view) and the reference chip. Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.\n */\nexport function compositeNodes(nodeViews: CompositeNodeViews) {\n  return {\n    // Explicit return type: the node views import `compositeKindsOf`, so inference would otherwise be circular.\n    Composite: CompositeNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.composite\n      },\n    }),\n    CompositeTags: CompositeTagsNode,\n    Reference: ReferenceNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.reference\n      },\n    }),\n  }\n}\n"],"mappings":";;;;;;;AAcA,SAAgB,eAAe,WAA+B;CAC5D,OAAO;EAEL,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;EACD,eAAe;EACf,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;CACH;AACF"}

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

@@ -1,3 +1,4 @@
+import { Store } from "../../core/store.js";
 import { HeadingConversionScope } from "../../settings/values.js";
 import "../../settings/index.js";
 import { CompositeKind } from "./kinds.js";
@@ -10,6 +11,8 @@ export interface CompositeOptions {
 /** Storage of the `composite` node: mirrors `options.kinds` for code that only has the editor. */
 export interface CompositeStorage {
   kinds: readonly CompositeKind[];
+  /** Ids of the derived Bausteine (those with a `meta.derivation`) the user opened; every other derived Baustein shows collapsed. */
+  expanded: Store<ReadonlySet<string>>;
 }
 declare module '@tiptap/core' {
   interface Commands<ReturnType> {
@@ -31,8 +34,10 @@ declare module '@tiptap/core' {
         recursive: boolean;
         scope: HeadingConversionScope;
       }) => ReturnType;
-      /** Switch the composite at `pos` (default: the caret's innermost composite) to `kind`; `meta` keeps only the target kind's fields. */
+      /** Switch the composite at `pos` (default: the caret's innermost composite) to `kind`; `meta` keeps the target kind's fields plus `derivation` and `bib`. */
       setCompositeKind: (kind: string, pos?: number) => ReturnType;
+      /** Open the derived Baustein with block id `id` if it is collapsed, collapse it if it is open. */
+      toggleCompositeExpanded: (id: string) => ReturnType;
     };
   }
   interface Storage {

package/dist/features/composites/nodes.js

@@ -1,8 +1,11 @@
 import { ABILITY, TEXT_ABILITIES } from "../../core/schema/abilities.js";
-import { isChromeNode } from "../../core/schema/node-flags.js";
 import { editorEntryOf } from "../../core/editor-ui.js";
+import { isChromeNode } from "../../core/schema/node-flags.js";
+import { createStore } from "../../core/store.js";
 import { compositeKind, defaultCompositeKinds, fallbackCompositeKinds } from "./kinds.js";
-import { compositeFence } from "./fences.js";
+import { keptMeta } from "./meta-keys.js";
+import { compositeFence, withReferencedFenceIds } from "./fences.js";
+import { derivationOf } from "./derivation.js";
 import { flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange } from "./heading-composites.js";
 import { Node, mergeAttributes } from "@tiptap/core";
 import { Selection, TextSelection } from "@tiptap/pm/state";
@@ -193,12 +196,28 @@ const CompositeNode = Node.create({
 		ABILITY.compositeMeta,
 		ABILITY.compositeSummarize,
 		ABILITY.compositeExport,
-		ABILITY.compositeTranscribe
+		ABILITY.compositeDerive
 	] },
 	addOptions: () => ({ kinds: fallbackCompositeKinds() }),
 	addStorage() {
-		return { kinds: this.options.kinds };
+		return {
+			kinds: this.options.kinds,
+			expanded: createStore(/* @__PURE__ */ new Set())
+		};
 	},
+	onSelectionUpdate() {
+		const { expanded } = this.storage;
+		const { $head } = this.editor.state.selection;
+		let open = null;
+		for (let depth = $head.depth; depth > 0; depth--) {
+			const node = $head.node(depth);
+			const id = node.attrs.id;
+			if (node.type.name !== COMPOSITE || typeof id !== "string" || !id || $head.index(depth) < CHROME_COUNT) continue;
+			if (derivationOf(node) && !expanded.get().has(id)) (open ??= new Set(expanded.get())).add(id);
+		}
+		if (open) expanded.set(open);
+	},
+	markdownPrepare: (json, editor) => withReferencedFenceIds(json, compositeKindsOf(editor)),
 	addAttributes: () => ({
 		kind: {
 			default: DEFAULT_KIND,
@@ -228,10 +247,18 @@ const CompositeNode = Node.create({
 		const kind = typeof node.attrs?.kind === "string" && node.attrs.kind ? node.attrs.kind : DEFAULT_KIND;
 		const meta = node.attrs?.meta;
 		const body = (node.content ?? []).map((child, index) => h.renderChild?.(child, index) ?? h.renderChildren([child])).filter(Boolean).join("\n\n");
-		return compositeFence(kind, meta && typeof meta === "object" ? meta : {}, body);
+		const id = node.attrs?.id;
+		return compositeFence(kind, meta && typeof meta === "object" ? meta : {}, body, typeof id === "string" && id ? id : void 0);
 	},
 	addCommands() {
 		return {
+			toggleCompositeExpanded: (id) => () => {
+				const { expanded } = this.storage;
+				const next = new Set(expanded.get());
+				if (!next.delete(id)) next.add(id);
+				expanded.set(next);
+				return true;
+			},
 			insertComposite: (kind = DEFAULT_KIND) => ({ state, tr, dispatch }) => {
 				const { $head } = state.selection;
 				let depth = $head.depth;
@@ -278,8 +305,7 @@ const CompositeNode = Node.create({
 				const found = compositeAt(state, pos);
 				if (!found) return false;
 				if (dispatch) {
-					const keys = new Set(compositeKind(this.options.kinds, kind).fields.map((field) => field.key));
-					const meta = Object.fromEntries(Object.entries(found.node.attrs.meta).filter(([key]) => keys.has(key)));
+					const meta = keptMeta(compositeKind(this.options.kinds, kind), found.node.attrs.meta);
 					tr.setNodeMarkup(found.pos, void 0, {
 						...found.node.attrs,
 						kind,