@ecsplico/editor 2.1.2 → 3.0.0

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

@@ -1,15 +1,20 @@
+import { CSL_TYPES, CslDate, CslItem, CslName, CslType } from "../../core/backend-types.js";
 import { CompositeAiBrief, compositeAiBrief } from "./ai-brief.js";
-import { CompositeKind, CompositeKindAi, CompositeMetaField, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
-import { CompositeMention, CompositeRow, compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.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 { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeOptions, CompositeStorage, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { REFERENCE_NODE, ReferenceAttrs, ReferenceNode, ReferenceOptions, ReferenceSuggestionPluginKey, referenceMarkdown } from "./reference.js";
 import { CompositeNodeViews, compositeNodes } from "./node-views.js";
 import { CompositeFeatureOptions, CompositesUi, compositeFeatureCore } from "./feature.js";
 import { documentCompositeMarkdown, headingsMarkdown, markdownFileName } from "./markdown-export.js";
 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 { ReferenceTarget, referenceLabel, referenceTarget, referenceTitle } from "./reference-label.js";
+import { referenceSuggestion } from "./reference-suggestion.js";
 import { Structure, StructureStorage, structureOf } from "./structure.js";
 import { STRUCTURE_MODE_KEYS } from "./structure-mode.js";
 import { TREE_ROOT_KEYS } from "./tree-root.js";
@@ -17,6 +22,10 @@ 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 { BIB_KEY, DERIVATION_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, COMPOSITE_CHROME_COUNT, type CompositeAiBrief, type CompositeAnchor, type CompositeAnchorsHandle, CompositeDescriptionNode, type CompositeFeatureOptions, type CompositeFence, type CompositeFrame, type CompositeInspector, type CompositeInspectorSection, type CompositeInspectorState, type CompositeKind, type CompositeKindAi, type CompositeKindCount, type CompositeKindOption, type CompositeMention, type CompositeMetaField, CompositeNode, type CompositeNodeViews, type CompositeOptions, type CompositeRow, type CompositeRowsHandle, type CompositeRowsState, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type CompositesUi, type FenceSegment, LEGACY_COMPOSITE_NODE, type MoveVerdict, type OutlineNode, STRUCTURE_MODE_KEYS, Structure, type StructureStorage, TREE_ROOT_KEYS, blocksFromMarkdown, canMoveBlockInto, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, defaultCompositeKinds, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, migrateLegacyContent, moveBlockInto, moveIntoVerdict, observeCompositeAnchors, setCompositeDescription, setCompositeMetaField, setCompositeTags, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf };
+export { AcceptedChildren, type AcceptedChildrenOptions, BIB_KEY, COMPOSITE_CHROME_COUNT, CSL_TYPES, type CompositeAiBrief, type CompositeAnchor, type CompositeAnchorsHandle, type CompositeBacklink, CompositeDescriptionNode, type CompositeFeatureOptions, type CompositeFence, type CompositeFrame, type CompositeInspector, type CompositeInspectorSection, type CompositeInspectorState, type CompositeKind, type CompositeKindAi, type CompositeKindCount, type CompositeKindOption, type CompositeMention, type CompositeMetaField, CompositeNode, type CompositeNodeViews, type CompositeOptions, type CompositeReference, type CompositeRow, type CompositeRowsHandle, type CompositeRowsState, 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, Structure, type StructureStorage, TREE_ROOT_KEYS, bibOf, bibtexOf, blocksFromMarkdown, bodyMarkdown, canMoveBlockInto, citeFull, citeShort, compositeAiBrief, compositeBacklinks, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, cslOf, cslTypeOptions, defaultCompositeKinds, derivationOf, derivationState, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, migrateLegacyContent, moveBlockInto, moveIntoVerdict, normalizeReferences, observeCompositeAnchors, parseLocator, referenceLabel, referenceMarkdown, referenceSuggestion, referenceTarget, referenceTitle, referencesFromText, renditionsOf, revealSource, seekSource, setCompositeDescription, setCompositeMetaField, setCompositeTags, sourceOf, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf, yearOf };

package/dist/features/composites/index.js

@@ -1,22 +1,31 @@
 import { splitCompositeFences } from "../../core/fences.js";
-import { compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
+import { SOURCE_MEDIA_TYPES, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
+import { BIB_KEY, DERIVATION_KEY } from "./meta-keys.js";
 import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.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, compositeJSON, compositeKindsOf } 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 { normalizeReferences, referencesFromText } from "./reference-text.js";
 import { compositeSchemaExtensions } from "./schema.js";
-import { compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
-import { compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
 import { AcceptedChildren } from "./accepted-children.js";
 import { documentCompositeMarkdown, headingsMarkdown, markdownFileName } from "./markdown-export.js";
 import { compositeNodes } from "./node-views.js";
+import { referenceLabel, referenceTarget, referenceTitle } from "./reference-label.js";
+import { compositeBacklinks, compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
+import { referenceSuggestion } from "./reference-suggestion.js";
+import { SourceReveal, parseLocator, revealSource, seekSource } from "./reveal-source.js";
 import { Structure, structureOf } from "./structure.js";
 import { STRUCTURE_MODE_KEYS } from "./structure-mode.js";
 import { compositeFeatureCore } from "./feature.js";
-import { canMoveBlockInto, compositeOutline, moveBlockInto, moveIntoVerdict } from "./outline.js";
+import { compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
 import { createCompositeRows } from "./rows-model.js";
-import { compositeFieldText, createCompositeInspector } from "./inspector-model.js";
 import { TREE_ROOT_KEYS } from "./tree-root.js";
-export { AcceptedChildren, COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, LEGACY_COMPOSITE_NODE, STRUCTURE_MODE_KEYS, Structure, TREE_ROOT_KEYS, blocksFromMarkdown, canMoveBlockInto, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, defaultCompositeKinds, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, migrateLegacyContent, moveBlockInto, moveIntoVerdict, observeCompositeAnchors, setCompositeDescription, setCompositeMetaField, setCompositeTags, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf };
+import { compositeFieldText, createCompositeInspector } from "./inspector-model.js";
+import { canMoveBlockInto, compositeOutline, moveBlockInto, moveIntoVerdict } from "./outline.js";
+export { AcceptedChildren, BIB_KEY, COMPOSITE_CHROME_COUNT, CSL_TYPES, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, DERIVATION_KEY, LEGACY_COMPOSITE_NODE, REFERENCE_NODE, ReferenceNode, ReferenceSuggestionPluginKey, SOURCE_MEDIA_TYPES, STRUCTURE_MODE_KEYS, SourceReveal, Structure, TREE_ROOT_KEYS, bibOf, bibtexOf, blocksFromMarkdown, bodyMarkdown, canMoveBlockInto, citeFull, citeShort, compositeAiBrief, compositeBacklinks, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFieldText, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeInspector, createCompositeRows, cslOf, cslTypeOptions, defaultCompositeKinds, derivationOf, derivationState, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, kindAccepts, markdownFileName, migrateLegacyContent, moveBlockInto, moveIntoVerdict, normalizeReferences, observeCompositeAnchors, parseLocator, referenceLabel, referenceMarkdown, referenceSuggestion, referenceTarget, referenceTitle, referencesFromText, renditionsOf, revealSource, seekSource, setCompositeDescription, setCompositeMetaField, setCompositeTags, sourceOf, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf, yearOf };

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

@@ -60,7 +60,10 @@ export interface CompositeInspector {
   setSearchTerm: (term: string) => void;
   /** Schedules a tag search for the current term (the picker opened). */
   searchTags: () => void;
-  /** Writes `value` to the meta `field` of the focused Baustein; ignored while the editor is not editable. */
+  /**
+   * Writes the text `value` to the meta `field` of the focused Baustein; 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;
   /** Commits a pending description draft and detaches from the editor. Idempotent; the model is inert afterwards. */
   dispose: () => void;

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

@@ -1,15 +1,19 @@
-import { createStore } from "../../core/store.js";
 import { metadataOf } from "../../core/metadata.js";
+import { createStore } from "../../core/store.js";
 import { METADATA_LIST } from "../../core/metadata-types.js";
+import { normalizeTagName } from "../../core/tag-name.js";
 import { compositeKindsOf } from "./nodes.js";
 import { compositeDescriptionText, compositeOfRow, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
-import { normalizeTagName } from "../../core/tag-name.js";
 import { createCompositeRows } from "./rows-model.js";
 //#region src/features/composites/inspector-model.ts
 /** Pause after the last keystroke in the description before the draft is written to the document. */
 const COMMIT_DELAY_MS = 600;
 /** Pause after the last change of the tag search term before the metadata source is asked. */
 const SEARCH_DELAY_MS = 150;
+/** Fields whose value is not text (a block ID, a CSL item, a provenance record): the inspector hands them to `CompositeFieldEditor` and never writes a string to them. */
+function isStructuredField(field) {
+	return field.type === "reference" || field.type === "bibliography" || field.type === "derivation";
+}
 /** The text of `field` in `row`'s meta as an input shows it: strings and numbers, otherwise empty. */
 function compositeFieldText(row, field) {
 	const value = row?.meta[field.key];
@@ -232,7 +236,7 @@ function createCompositeInspector(editor) {
 		},
 		setField(field, value) {
 			const row = focusedRow();
-			if (editor && isEditable() && row) setCompositeMetaField(editor, row, field.key, value);
+			if (editor && isEditable() && row && !isStructuredField(field)) setCompositeMetaField(editor, row, field.key, value);
 		},
 		dispose() {
 			if (disposed) return;
@@ -250,6 +254,6 @@ function createCompositeInspector(editor) {
 	};
 }
 //#endregion
-export { compositeFieldText, createCompositeInspector };
+export { compositeFieldText, createCompositeInspector, isStructuredField };
 
 //# sourceMappingURL=inspector-model.js.map

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

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

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

@@ -1,15 +1,20 @@
 import { Translate } from "../../i18n/index.js";
 //#region src/features/composites/kinds.d.ts
+/** Media block types a source-holding kind's source may be (`CompositeKind.source`). */
+export declare const SOURCE_MEDIA_TYPES: readonly ["image", "audio", "video", "file"];
 /** One metadata field of a composite kind, stored under `key` in the composite's `meta` attribute. */
 export interface CompositeMetaField {
   key: string;
   label: string;
-  type: 'text' | 'textarea' | 'date' | 'number' | 'select';
+  /** `bibliography`: CSL-JSON item under `meta.bib`; `derivation`: read-only provenance of a derived Baustein; `reference`: block id of another Baustein. */
+  type: 'text' | 'textarea' | 'date' | 'number' | 'select' | 'reference' | 'bibliography' | 'derivation';
   /** Choices of a `select` field. */
   options?: {
     value: string;
     label: string;
   }[];
+  /** `reference`: kind ids the field may point to; absent = any Baustein. */
+  targets?: readonly string[];
 }
 /**
  * What a kind tells the model beyond its fields. `purpose` goes into every AI request's block model (chat, generate
@@ -41,6 +46,8 @@ export interface CompositeKind {
    * Only new moves are checked; documents that already nest against it stay as they are.
    */
   accepts?: readonly string[] | 'all';
+  /** 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. */
+  source?: readonly (typeof SOURCE_MEDIA_TYPES)[number][];
 }
 /**
  * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field

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":"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"}

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"}