@ecsplico/editor 2.1.2 → 3.0.0

package/dist/integrations/composite-ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-ai/index.ts"],"sourcesContent":["import type { BlockAction, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { compositeSourceText, mediaAssetOf, summarizeComposite } from './composite-summary'\nimport { transcribeDocument } from './document-transcribe'\n\nexport { fillComposite } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, mediaAssetOf, summarizeComposite } from './composite-summary'\nexport { transcribeDocument } from './document-transcribe'\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\n  return [\n    {\n      id: 'composite-fill',\n      label: ctx.t('integrations.compositeFill.action'),\n      icon: 'i-lucide-wand-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: 25,\n      isVisible: ({ editor, node }) => node.type.name === 'composite' && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== undefined,\n      run: ({ editor, pos }) => {\n        void fillComposite(editor, pos, ctx.fetch, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-summarize',\n      label: ctx.t('integrations.compositeSummary.action'),\n      icon: 'i-lucide-text-quote',\n      ability: ABILITY.compositeSummarize,\n      order: 30,\n      isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        void summarizeComposite(editor, pos, ctx.fetch, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'document-transcribe',\n      label: ctx.t('integrations.documentTranscribe.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeTranscribe,\n      order: 450,\n      isVisible: ({ node }) => node.attrs.kind === 'document' && !!ctx.ai?.transcription && mediaAssetOf(node) !== null,\n      run: ({ editor, pos }) => {\n        void transcribeDocument(editor, pos, ctx.fetch, ctx.notify, ctx.t)\n      },\n    },\n  ]\n}\n\n/**\n * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of\n * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the\n * body), the „Zusammenfassung erzeugen“ block action (streams a\n * summary of a composite's body or transcript into its description), the „Transkribieren“ action of a `document`\n * composite with an audio/video asset (`POST /api/ai/transcribe`, shown only when the app's public AI configuration\n * enables transcription), and the composite-structure form of AI results: with `composite` structure an AI result that\n * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading\n * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do\n * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's\n * `modelProfiles(ctx.app)`.\n */\nexport function compositeAiFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-ai',\n    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\n    formatAiResult: (editor, markdown, heading) => {\n      if (!heading) return markdown\n      const text = withHeading(heading, markdown)\n      return structureOf(editor) === 'composite' ? compositeFence('section', {}, text) : text\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,SAAS,mBAAmB,KAAoC;CAC9D,OAAO;EACL;GACE,IAAI;GACJ,OAAO,IAAI,EAAE,mCAAmC;GAChD,MAAM;GACN,SAAS,QAAQ;GACjB,OAAO;GACP,YAAY,EAAE,QAAQ,WAAW,KAAK,KAAK,SAAS,eAAe,cAAc,iBAAiB,MAAM,GAAG,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,KAAA;GAC3I,MAAM,EAAE,QAAQ,UAAU;IACxB,cAAmB,QAAQ,KAAK,IAAI,OAAO,cAAc,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,QAAQ,IAAI,CAAC;GAC/F;EACF;EACA;GACE,IAAI;GACJ,OAAO,IAAI,EAAE,sCAAsC;GACnD,MAAM;GACN,SAAS,QAAQ;GACjB,OAAO;GACP,YAAY,EAAE,WAAW,oBAAoB,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS;GACnE,MAAM,EAAE,QAAQ,UAAU;IACxB,mBAAwB,QAAQ,KAAK,IAAI,OAAO,cAAc,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,QAAQ,IAAI,CAAC;GACpG;EACF;EACA;GACE,IAAI;GACJ,OAAO,IAAI,EAAE,wCAAwC;GACrD,MAAM;GACN,SAAS,QAAQ;GACjB,OAAO;GACP,YAAY,EAAE,WAAW,KAAK,MAAM,SAAS,cAAc,CAAC,CAAC,IAAI,IAAI,iBAAiB,aAAa,IAAI,MAAM;GAC7G,MAAM,EAAE,QAAQ,UAAU;IACxB,mBAAwB,QAAQ,KAAK,IAAI,OAAO,IAAI,QAAQ,IAAI,CAAC;GACnE;EACF;CACF;AACF;;;;;;;;;;;;;AAcA,SAAgB,qBAA2C;CACzD,OAAO;EACL,IAAI;EACJ,UAAU;GAAC;GAAc;GAAM;EAAO;EACtC,cAAc;EACd,iBAAiB,QAAQ,UAAU,YAAY;GAC7C,IAAI,CAAC,SAAS,OAAO;GACrB,MAAM,OAAO,YAAY,SAAS,QAAQ;GAC1C,OAAO,YAAY,MAAM,MAAM,cAAc,eAAe,WAAW,CAAC,GAAG,IAAI,IAAI;EACrF;CACF;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-ai/index.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { BlockAction, EditorFeature, FeatureContext } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { modelProfiles, withHeading } from '../../features/ai'\nimport { structureOf } from '../../features/composites'\nimport '../../features/composites/bibliography-command'\nimport { compositeFence, compositeKind, compositeKindsOf } from '../../features/composites/schema'\nimport { fillComposite } from './composite-fill'\nimport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nimport { canFetchBibliography, fetchBibliography } from './bibliography-fetch'\nimport { compositeSourceText, summarizeComposite } from './composite-summary'\nimport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition } from './rendition'\n\nexport { type CompositeBodyResult, fillComposite, generateCompositeBody } from './composite-fill'\nexport { COMPOSITE_BODY_START, compositeSourceText, summarizeComposite } from './composite-summary'\nexport { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition, type RenditionOptions } from './rendition'\nexport { canDeriveAfter, derivableKindsOf, deriveComposite, isDerivableSource } from './derive'\nexport { canFetchBibliography, doiOf, fetchBibliography } from './bibliography-fetch'\n\n/** The editor command `fetchCompositeBibliography` (declared by composites) behind the bibliography editor's „DOI abrufen“ button; absent without the AI capability. */\nfunction bibliographyFetchExtensions(ctx: FeatureContext): AnyExtension[] {\n  const ai = ctx.backend.ai\n  if (!ai) return []\n  return [Extension.create({\n    name: 'compositeBibliographyFetch',\n    addCommands: () => ({\n      fetchCompositeBibliography: (pos: number) => ({ editor }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n        return true\n      },\n    }),\n  })]\n}\n\nfunction compositeAiActions(ctx: FeatureContext): BlockAction[] {\n  const ai = ctx.backend.ai\n  // Without the AI capability there is nothing to run (`composeEditor` omits the integration in that case).\n  if (!ai) return []\n  return [\n    {\n      id: 'composite-fill',\n      label: ctx.t('integrations.compositeFill.action'),\n      icon: 'i-lucide-wand-sparkles',\n      ability: ABILITY.aiGenerate,\n      order: 25,\n      isVisible: ({ editor, node }) => node.type.name === 'composite' && compositeKind(compositeKindsOf(editor), String(node.attrs.kind)).ai !== undefined,\n      run: ({ editor, pos }) => {\n        void fillComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-summarize',\n      label: ctx.t('integrations.compositeSummary.action'),\n      icon: 'i-lucide-text-quote',\n      ability: ABILITY.compositeSummarize,\n      order: 30,\n      isVisible: ({ node }) => compositeSourceText(node).trim().length > 0,\n      run: ({ editor, pos }) => {\n        void summarizeComposite(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'composite-derive',\n      label: ctx.t('integrations.compositeDerive.action'),\n      icon: 'i-lucide-git-branch',\n      ability: ABILITY.compositeDerive,\n      order: 452,\n      isVisible: ({ editor, node }) => isDerivableSource(editor, node),\n      menu: ({ editor, pos }) => derivableKindsOf(editor).map(kind => ({\n        label: kind.label,\n        icon: kind.icon,\n        disabled: !canDeriveAfter(editor, pos, kind.id),\n        onSelect: () => {\n          void deriveComposite(editor, pos, kind.id, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n        },\n      })),\n    },\n    {\n      id: 'bibliography-fetch',\n      label: ctx.t('integrations.bibliographyFetch.action'),\n      icon: 'i-lucide-book-marked',\n      ability: ABILITY.compositeDerive,\n      order: 453,\n      isVisible: ({ editor, node }) => canFetchBibliography(editor, node),\n      run: ({ editor, pos }) => {\n        void fetchBibliography(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t, ctx.documentId)\n      },\n    },\n    {\n      id: 'rendition-create',\n      label: ctx.t('integrations.rendition.action'),\n      icon: 'i-lucide-captions',\n      ability: ABILITY.compositeDerive,\n      order: 450,\n      isVisible: ({ editor, node }) => canCreateRendition(editor, node, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        void createRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n    {\n      id: 'rendition-regenerate',\n      label: ctx.t('integrations.rendition.regenerate'),\n      icon: 'i-lucide-refresh-cw',\n      ability: ABILITY.compositeDerive,\n      order: 451,\n      isVisible: ({ editor, node, pos }) => canRegenerateRendition(editor, node, pos, !!ctx.ai?.transcription),\n      run: ({ editor, pos }) => {\n        regenerateRendition(editor, pos, ai, modelProfiles(ctx.app).modelRef, ctx.notify, ctx.t)\n      },\n    },\n  ]\n}\n\n/**\n * AI on composites (requires `composites`, `ai`, `media`): the „Baustein füllen (KI)“ block action (on composites of\n * kinds with an `ai` configuration: brief + document → task `fill-block`, the result opens the diff review over the\n * body), the „Zusammenfassung erzeugen“ block action (streams a\n * summary of a composite's body into its description), the „Lesefassung erzeugen“ / „Neu erzeugen (ersetzen)“\n * actions of source-holding Bausteine (`ai.extract`: a rendition child with the transcript, full text or description of\n * the source; a recording needs the app's public AI configuration to enable transcription),\n * and the composite-structure form of AI results: with `composite` structure an AI result that\n * has a heading is inserted as a `section` composite fence, otherwise (and in flat structure) the base AI heading\n * is used. It is the preset's single `formatAiResult` contributor. The base AI feature and the composites feature do\n * not know it. Framework-free: notices go through the surface's `ctx.notify`, the model through the app's\n * `modelProfiles(ctx.app)`.\n */\nexport function compositeAiFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-ai',\n    dimension: 'ai',\n    requires: ['composites', 'ai', 'media'],\n    blockActions: compositeAiActions,\n    extensions: bibliographyFetchExtensions,\n    formatAiResult: (editor, markdown, heading) => {\n      if (!heading) return markdown\n      const text = withHeading(heading, markdown)\n      return structureOf(editor) === 'composite' ? compositeFence('section', {}, text) : text\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/integrations/composite-ai/rendition.d.ts

@@ -0,0 +1,45 @@
+import { Translate } from "../../i18n/index.js";
+import { EditorBackend } from "../../core/backend.js";
+import { Notifier } from "../../core/notify.js";
+import { ModelRef } from "../../core/backend-types.js";
+import "../../features/ai/index.js";
+import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/rendition.d.ts
+export interface RenditionOptions {
+  /**
+   * Replace the rendition at this position (a child of the source-holding Baustein) in place instead of adding a new one
+   * after the source: its chrome (title, description, tags) and block id stay, body and derivation are new.
+   */
+  replace?: {
+    pos: number;
+  };
+}
+/**
+ * „Lesefassung erzeugen“: extracts the readable content of the source of the Baustein at `pos` (`ai.extract`, method
+ * `auto`: transcript with timestamps for audio/video, full text or OCR for a PDF, a description for an image) and adds
+ * it as a `rendition` Baustein right after the source block, carrying `meta.derivation` (asset, method, model, hashes,
+ * the stored raw output). Bibliographic data the server found fills an empty `meta.bib` of the Baustein, and the work's
+ * title an empty Baustein title. With `options.replace` the existing rendition is replaced in place (same block id).
+ * The Baustein is anchored through its description when the request starts and found again after it ends, so edits
+ * while it runs do not misplace the result. Notices go through `notify`, in the language of `t`; the progress notice
+ * stays until the request ends.
+ */
+export declare function createRendition(editor: Editor, pos: number, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate, options?: RenditionOptions): Promise<void>;
+/**
+ * Whether „Lesefassung erzeugen“ applies to `node`: a Baustein of a source-holding kind whose source block was
+ * found. A recording needs speech-to-text (`transcription`: the app's public configuration enables it); everything else
+ * is extracted by the server.
+ */
+export declare function canCreateRendition(editor: Editor, node: Node$1, transcription: boolean): boolean;
+/** Whether „Neu erzeugen (ersetzen)“ applies to the Baustein `node` at `pos`: an asset-derived rendition inside a Baustein that still has a source. */
+export declare function canRegenerateRendition(editor: Editor, node: Node$1, pos: number, transcription: boolean): boolean;
+/**
+ * „Neu erzeugen (ersetzen)“: makes the rendition at `pos` again from the source of its Baustein and replaces it in place
+ * (`createRendition` with `replace`; the block id stays, so references keep resolving). A rendition whose body was
+ * edited since it was made is not replaced silently: a warning notice offers „Trotzdem ersetzen“, dismissing the notice
+ * cancels. The rendition is found again by its id when the button is pressed.
+ */
+export declare function regenerateRendition(editor: Editor, pos: number, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): void;
+//#endregion
+//# sourceMappingURL=rendition.d.ts.map

package/dist/integrations/composite-ai/rendition.js

@@ -0,0 +1,314 @@
+import { parseBlocks, structureBlocks } from "../../core/pipeline.js";
+import { blockIdOf, findBlockById, newBlockId } from "../../core/schema/block-ids.js";
+import { captureRange, releaseRanges, resolveRange } from "../../core/doc-anchors.js";
+import { fetchErrorMessage } from "../../core/fetch-error.js";
+import { sha256Hex } from "../../core/hash.js";
+import { compositeKind, kindAccepts } from "../../features/composites/kinds.js";
+import { DERIVATION_KEY } from "../../features/composites/meta-keys.js";
+import { bodyMarkdown, derivationOf, derivationState, sourceOf } from "../../features/composites/derivation.js";
+import { compositeJSON, compositeKindsOf } from "../../features/composites/nodes.js";
+import { bibOf } from "../../features/composites/bibliography.js";
+import { isRateLimited, notifyAiRateLimited } from "../../features/ai/rate-limit.js";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/integrations/composite-ai/rendition.ts
+/** Methods with their own title of a fresh rendition (`integrations.rendition.title.<method>`). */
+const TITLED_METHODS = [
+	"transcription",
+	"pdf-text",
+	"ocr",
+	"description"
+];
+/** What the server's `warnings` codes say; an unknown code is shown as it is. */
+const WARNING_KEYS = {
+	"ocr-unavailable": "integrations.rendition.warning.ocr-unavailable",
+	"crossref-unavailable": "integrations.rendition.warning.crossref-unavailable",
+	"pages-truncated": "integrations.rendition.warning.pages-truncated",
+	"ocr-truncated": "integrations.rendition.warning.ocr-truncated",
+	"bibliography-failed": "integrations.rendition.warning.bibliography-failed"
+};
+/** The `<!-- page N -->` line the server puts at the start of every PDF page after the first (`joinPages`). */
+const PAGE_MARKER = /^<!-- page (\d+) -->[ \t]*$/gm;
+/**
+* `markdown` with every page marker line replaced by an emphasised page label paragraph (`*S. 2*`): parsed as it is, a
+* marker is an HTML comment and would leave an empty paragraph without the page. The stored raw output keeps the markers.
+*/
+function withPageLabels(markdown, t) {
+	return markdown.replace(PAGE_MARKER, (_marker, page) => `*${t("integrations.rendition.page", { n: page })}*`);
+}
+/**
+* The body blocks of a rendition: one `transcriptSegment` per timed segment (speaker empty, `start`/`end` in seconds)
+* when the editor has the transcript feature, else the Markdown parsed and brought into the preferred structure
+* (chapters become nested `section` Bausteine in composite structure; PDF page breaks become page label paragraphs).
+*/
+function renditionBody(editor, response, t) {
+	if (editor.schema.nodes.transcriptSegment && response.segments?.length) {
+		const segments = response.segments.filter((segment) => segment.text.trim()).map((segment) => ({
+			type: "transcriptSegment",
+			attrs: {
+				speaker: "",
+				start: segment.start,
+				end: segment.end
+			},
+			content: [{
+				type: "text",
+				text: segment.text.trim()
+			}]
+		}));
+		if (segments.length) return segments;
+	}
+	return response.markdown.trim() ? structureBlocks(editor, parseBlocks(editor, withPageLabels(response.markdown, t)).blocks) : [];
+}
+/** `node` with `derivation` in its meta, `outputHash` being the hash of the Markdown of its body (what `derivationState` compares later). */
+function sealed(editor, node, derivation) {
+	const outputHash = sha256Hex(bodyMarkdown(editor, node));
+	return node.type.create({
+		...node.attrs,
+		meta: {
+			...node.attrs.meta,
+			[DERIVATION_KEY]: {
+				...derivation,
+				outputHash
+			}
+		}
+	}, node.content, node.marks);
+}
+/**
+* „Lesefassung erzeugen“: extracts the readable content of the source of the Baustein at `pos` (`ai.extract`, method
+* `auto`: transcript with timestamps for audio/video, full text or OCR for a PDF, a description for an image) and adds
+* it as a `rendition` Baustein right after the source block, carrying `meta.derivation` (asset, method, model, hashes,
+* the stored raw output). Bibliographic data the server found fills an empty `meta.bib` of the Baustein, and the work's
+* title an empty Baustein title. With `options.replace` the existing rendition is replaced in place (same block id).
+* The Baustein is anchored through its description when the request starts and found again after it ends, so edits
+* while it runs do not misplace the result. Notices go through `notify`, in the language of `t`; the progress notice
+* stays until the request ends.
+*/
+async function createRendition(editor, pos, ai, modelRef, notify, t, options = {}) {
+	const kinds = compositeKindsOf(editor);
+	const composite = editor.state.doc.nodeAt(pos);
+	const source = composite && sourceOf(composite, kinds);
+	if (composite?.type.name !== "composite" || !source) return;
+	const asset = source.asset;
+	if (!asset) {
+		notify({
+			title: t("integrations.rendition.noSource"),
+			kind: "error"
+		});
+		return;
+	}
+	if (!kindAccepts(kinds, String(composite.attrs.kind), "rendition")) {
+		notify({
+			title: t("integrations.rendition.notAccepted"),
+			kind: "error"
+		});
+		return;
+	}
+	let replaceId = null;
+	if (options.replace) {
+		const target = editor.state.doc.nodeAt(options.replace.pos);
+		replaceId = target && options.replace.pos > pos && options.replace.pos < pos + composite.nodeSize ? blockIdOf(target) : null;
+		if (target?.type.name !== "composite" || !replaceId) return;
+	}
+	const descriptionPos = pos + 1 + composite.child(0).nodeSize;
+	const anchor = captureRange(editor, {
+		from: descriptionPos + 1,
+		to: descriptionPos + 1 + composite.child(1).content.size
+	});
+	const toastId = `rendition-${blockIdOf(composite) ?? asset.name}`;
+	const wantsBibliography = compositeKind(kinds, String(composite.attrs.kind)).fields.some((field) => field.type === "bibliography");
+	const model = modelRef("generate");
+	const controller = new AbortController();
+	const abort = () => controller.abort();
+	editor.on("destroy", abort);
+	notify({
+		id: toastId,
+		title: t("integrations.rendition.running"),
+		kind: "info",
+		icon: "i-lucide-loader-circle",
+		duration: 0
+	});
+	try {
+		const response = await ai.extract({
+			documentId: asset.documentId,
+			name: asset.name,
+			method: "auto",
+			model,
+			bibliography: wantsBibliography
+		}, controller.signal);
+		if (editor.isDestroyed) return;
+		const body = renditionBody(editor, response, t);
+		if (!body.length) {
+			notify({
+				title: t("integrations.rendition.empty.title"),
+				description: t("integrations.rendition.empty.description"),
+				kind: "error"
+			});
+			return;
+		}
+		const range = resolveRange(editor.state, anchor);
+		const $from = range && editor.state.doc.resolve(range.from);
+		const parentPos = $from && $from.parent.type.name === "compositeDescription" ? $from.before($from.depth - 1) : null;
+		const parent = parentPos === null ? null : editor.state.doc.nodeAt(parentPos);
+		const currentSource = parent && sourceOf(parent, kinds);
+		const replaced = replaceId ? findBlockById(editor.state.doc, replaceId) : null;
+		if (parentPos === null || !parent || !currentSource || replaceId !== null && (!replaced || replaced.pos <= parentPos || replaced.pos >= parentPos + parent.nodeSize)) {
+			notify({
+				title: t("integrations.rendition.gone.title"),
+				description: t("integrations.rendition.gone.description"),
+				kind: "error"
+			});
+			return;
+		}
+		const usedModel = response.method === "transcription" ? response.model : response.method === "ocr" || response.method === "description" ? "preset" in model ? model.preset : model.model : void 0;
+		const derivation = {
+			from: { asset: asset.name },
+			method: response.method,
+			...usedModel ? { model: usedModel } : {},
+			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+			inputHash: response.inputHash,
+			outputHash: "",
+			...response.output ? { output: response.output } : {}
+		};
+		const { schema } = editor;
+		const bodyNodes = body.map((block) => schema.nodeFromJSON(block));
+		const id = replaceId ?? newBlockId();
+		let node;
+		if (replaced) {
+			const chrome = Array.from({ length: 3 }, (_, index) => replaced.node.child(index));
+			node = sealed(editor, replaced.node.type.create(replaced.node.attrs, Fragment.from([...chrome, ...bodyNodes])), derivation);
+		} else {
+			const titleKey = TITLED_METHODS.includes(response.method) ? `integrations.rendition.title.${response.method}` : null;
+			const json = compositeJSON("rendition", body);
+			const [title, ...rest] = json.content;
+			const text = titleKey ? t(titleKey) : compositeKind(kinds, "rendition").label;
+			node = sealed(editor, schema.nodeFromJSON({
+				...json,
+				attrs: {
+					...json.attrs,
+					id
+				},
+				content: [{
+					...title,
+					content: [{
+						type: "text",
+						text
+					}]
+				}, ...rest]
+			}), derivation);
+		}
+		const tr = editor.state.tr;
+		if (replaced) tr.replaceWith(replaced.pos, replaced.pos + replaced.node.nodeSize, node);
+		else {
+			let insertPos = parentPos + 1;
+			for (let index = 0; index <= currentSource.index; index++) insertPos += parent.child(index).nodeSize;
+			if (!parent.canReplace(currentSource.index + 1, currentSource.index + 1, Fragment.from(node))) {
+				notify({
+					title: t("integrations.rendition.notAccepted"),
+					kind: "error"
+				});
+				return;
+			}
+			tr.insert(insertPos, node);
+		}
+		const { bib } = response;
+		const workTitle = bib?.title?.trim();
+		if (workTitle && !parent.child(0).textContent.trim()) tr.insert(parentPos + 2, schema.text(workTitle));
+		if (bib && bibOf(parent) === null) {
+			const csl = { ...bib };
+			delete csl.title;
+			tr.setNodeMarkup(parentPos, void 0, {
+				...parent.attrs,
+				meta: {
+					...parent.attrs.meta,
+					bib: csl
+				}
+			});
+		}
+		editor.view.dispatch(tr);
+		editor.commands.revealBlock(id);
+		notify({
+			title: t("integrations.rendition.done"),
+			kind: "success",
+			icon: "i-lucide-captions"
+		});
+		if (response.warnings.length) notify({
+			title: t("integrations.rendition.warnings.title"),
+			description: response.warnings.map((code) => WARNING_KEYS[code] ? t(WARNING_KEYS[code]) : code).join(" "),
+			kind: "info"
+		});
+	} catch (err) {
+		if (controller.signal.aborted || editor.isDestroyed) return;
+		if (isRateLimited(err)) notifyAiRateLimited(notify, t);
+		else notify({
+			title: t("integrations.rendition.failed"),
+			description: fetchErrorMessage(err),
+			kind: "error"
+		});
+	} finally {
+		notify.dismiss?.(toastId);
+		editor.off("destroy", abort);
+		releaseRanges(editor, [anchor]);
+	}
+}
+/**
+* Whether „Lesefassung erzeugen“ applies to `node`: a Baustein of a source-holding kind whose source block was
+* found. A recording needs speech-to-text (`transcription`: the app's public configuration enables it); everything else
+* is extracted by the server.
+*/
+function canCreateRendition(editor, node, transcription) {
+	const source = sourceOf(node, compositeKindsOf(editor));
+	if (!source) return false;
+	return transcription || source.node.type.name !== "audio" && source.node.type.name !== "video";
+}
+/** The source-holding Baustein around the asset-derived rendition at `pos`; null for anything else. */
+function renditionParentOf(editor, pos) {
+	const node = editor.state.doc.nodeAt(pos);
+	const derivation = node && derivationOf(node);
+	if (!derivation || !("asset" in derivation.from)) return null;
+	const $pos = editor.state.doc.resolve(pos);
+	if ($pos.depth === 0 || $pos.parent.type.name !== "composite" || !sourceOf($pos.parent, compositeKindsOf(editor))) return null;
+	return {
+		node: $pos.parent,
+		pos: $pos.before()
+	};
+}
+/** Whether „Neu erzeugen (ersetzen)“ applies to the Baustein `node` at `pos`: an asset-derived rendition inside a Baustein that still has a source. */
+function canRegenerateRendition(editor, node, pos, transcription) {
+	const parent = node.type.name === "composite" ? renditionParentOf(editor, pos) : null;
+	return parent !== null && canCreateRendition(editor, parent.node, transcription);
+}
+/**
+* „Neu erzeugen (ersetzen)“: makes the rendition at `pos` again from the source of its Baustein and replaces it in place
+* (`createRendition` with `replace`; the block id stays, so references keep resolving). A rendition whose body was
+* edited since it was made is not replaced silently: a warning notice offers „Trotzdem ersetzen“, dismissing the notice
+* cancels. The rendition is found again by its id when the button is pressed.
+*/
+function regenerateRendition(editor, pos, ai, modelRef, notify, t) {
+	const node = editor.state.doc.nodeAt(pos);
+	const id = node && blockIdOf(node);
+	const parent = renditionParentOf(editor, pos);
+	if (!node || !id || !parent) return;
+	const replace = () => {
+		const found = findBlockById(editor.state.doc, id);
+		const current = found && renditionParentOf(editor, found.pos);
+		if (found && current) createRendition(editor, current.pos, ai, modelRef, notify, t, { replace: { pos: found.pos } });
+	};
+	const kinds = compositeKindsOf(editor);
+	if (derivationState(parent.node, node, () => sha256Hex(bodyMarkdown(editor, node)), kinds).edited !== true) {
+		replace();
+		return;
+	}
+	notify({
+		id: `rendition-edited-${id}`,
+		title: t("integrations.rendition.editedWarning.title"),
+		description: t("integrations.rendition.editedWarning.description"),
+		kind: "warning",
+		action: {
+			label: t("integrations.rendition.editedWarning.confirm"),
+			onClick: replace
+		}
+	});
+}
+//#endregion
+export { canCreateRendition, canRegenerateRendition, createRendition, regenerateRendition };
+
+//# sourceMappingURL=rendition.js.map

package/dist/integrations/composite-ai/rendition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendition.js","names":[],"sources":["../../../src/integrations/composite-ai/rendition.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { Fragment, type Node as PMNode } from '@tiptap/pm/model'\nimport type { EditorBackend } from '../../core/backend'\nimport type { ExtractResponse } from '../../core/backend-types'\nimport { captureRange, fetchErrorMessage, parseBlocks, releaseRanges, resolveRange, sha256Hex, structureBlocks } from '../../core'\nimport type { MessageKey, Translate } from '../../i18n'\nimport type { Notifier } from '../../core/notify'\nimport { blockIdOf, findBlockById, newBlockId } from '../../core/schema'\nimport { isRateLimited, type ModelRef, notifyAiRateLimited } from '../../features/ai'\nimport {\n  bibOf,\n  bodyMarkdown,\n  COMPOSITE_CHROME_COUNT,\n  compositeJSON,\n  compositeKind,\n  compositeKindsOf,\n  DERIVATION_KEY,\n  derivationOf,\n  derivationState,\n  type Derivation,\n  kindAccepts,\n  sourceOf,\n} from '../../features/composites/schema'\n\nexport interface RenditionOptions {\n  /**\n   * Replace the rendition at this position (a child of the source-holding Baustein) in place instead of adding a new one\n   * after the source: its chrome (title, description, tags) and block id stay, body and derivation are new.\n   */\n  replace?: { pos: number }\n}\n\n/** Methods with their own title of a fresh rendition (`integrations.rendition.title.<method>`). */\nconst TITLED_METHODS: readonly string[] = ['transcription', 'pdf-text', 'ocr', 'description']\n\n/** What the server's `warnings` codes say; an unknown code is shown as it is. */\nconst WARNING_KEYS: Readonly<Record<string, MessageKey>> = {\n  'ocr-unavailable': 'integrations.rendition.warning.ocr-unavailable',\n  'crossref-unavailable': 'integrations.rendition.warning.crossref-unavailable',\n  'pages-truncated': 'integrations.rendition.warning.pages-truncated',\n  'ocr-truncated': 'integrations.rendition.warning.ocr-truncated',\n  'bibliography-failed': 'integrations.rendition.warning.bibliography-failed',\n}\n\n/** The `<!-- page N -->` line the server puts at the start of every PDF page after the first (`joinPages`). */\nconst PAGE_MARKER = /^<!-- page (\\d+) -->[ \\t]*$/gm\n\n/**\n * `markdown` with every page marker line replaced by an emphasised page label paragraph (`*S. 2*`): parsed as it is, a\n * marker is an HTML comment and would leave an empty paragraph without the page. The stored raw output keeps the markers.\n */\nfunction withPageLabels(markdown: string, t: Translate): string {\n  return markdown.replace(PAGE_MARKER, (_marker, page: string) => `*${t('integrations.rendition.page', { n: page })}*`)\n}\n\n/**\n * The body blocks of a rendition: one `transcriptSegment` per timed segment (speaker empty, `start`/`end` in seconds)\n * when the editor has the transcript feature, else the Markdown parsed and brought into the preferred structure\n * (chapters become nested `section` Bausteine in composite structure; PDF page breaks become page label paragraphs).\n */\nfunction renditionBody(editor: Editor, response: ExtractResponse, t: Translate): JSONContent[] {\n  if (editor.schema.nodes.transcriptSegment && response.segments?.length) {\n    const segments = response.segments\n      .filter(segment => segment.text.trim())\n      .map((segment): JSONContent => ({\n        type: 'transcriptSegment',\n        attrs: { speaker: '', start: segment.start, end: segment.end },\n        content: [{ type: 'text', text: segment.text.trim() }],\n      }))\n    if (segments.length) return segments\n  }\n  return response.markdown.trim() ? structureBlocks(editor, parseBlocks(editor, withPageLabels(response.markdown, t)).blocks) : []\n}\n\n/** `node` with `derivation` in its meta, `outputHash` being the hash of the Markdown of its body (what `derivationState` compares later). */\nfunction sealed(editor: Editor, node: PMNode, derivation: Derivation): PMNode {\n  const outputHash = sha256Hex(bodyMarkdown(editor, node))\n  return node.type.create({ ...node.attrs, meta: { ...node.attrs.meta, [DERIVATION_KEY]: { ...derivation, outputHash } } }, node.content, node.marks)\n}\n\n/**\n * „Lesefassung erzeugen“: extracts the readable content of the source of the Baustein at `pos` (`ai.extract`, method\n * `auto`: transcript with timestamps for audio/video, full text or OCR for a PDF, a description for an image) and adds\n * it as a `rendition` Baustein right after the source block, carrying `meta.derivation` (asset, method, model, hashes,\n * the stored raw output). Bibliographic data the server found fills an empty `meta.bib` of the Baustein, and the work's\n * title an empty Baustein title. With `options.replace` the existing rendition is replaced in place (same block id).\n * The Baustein is anchored through its description when the request starts and found again after it ends, so edits\n * while it runs do not misplace the result. Notices go through `notify`, in the language of `t`; the progress notice\n * stays until the request ends.\n */\nexport async function createRendition(editor: Editor, pos: number, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate, options: RenditionOptions = {}): Promise<void> {\n  const kinds = compositeKindsOf(editor)\n  const composite = editor.state.doc.nodeAt(pos)\n  const source = composite && sourceOf(composite, kinds)\n  if (composite?.type.name !== 'composite' || !source) return\n  const asset = source.asset\n  if (!asset) {\n    notify({ title: t('integrations.rendition.noSource'), kind: 'error' })\n    return\n  }\n  if (!kindAccepts(kinds, String(composite.attrs.kind), 'rendition')) {\n    notify({ title: t('integrations.rendition.notAccepted'), kind: 'error' })\n    return\n  }\n\n  let replaceId: string | null = null\n  if (options.replace) {\n    const target = editor.state.doc.nodeAt(options.replace.pos)\n    replaceId = target && options.replace.pos > pos && options.replace.pos < pos + composite.nodeSize ? blockIdOf(target) : null\n    if (target?.type.name !== 'composite' || !replaceId) return\n  }\n\n  const descriptionPos = pos + 1 + composite.child(0).nodeSize\n  const anchor = captureRange(editor, { from: descriptionPos + 1, to: descriptionPos + 1 + composite.child(1).content.size })\n  const toastId = `rendition-${blockIdOf(composite) ?? asset.name}`\n  const wantsBibliography = compositeKind(kinds, String(composite.attrs.kind)).fields.some(field => field.type === 'bibliography')\n  const model = modelRef('generate')\n\n  const controller = new AbortController()\n  const abort = () => controller.abort()\n  editor.on('destroy', abort)\n  notify({ id: toastId, title: t('integrations.rendition.running'), kind: 'info', icon: 'i-lucide-loader-circle', duration: 0 })\n  try {\n    const response = await ai.extract({ documentId: asset.documentId, name: asset.name, method: 'auto', model, bibliography: wantsBibliography }, controller.signal)\n    if (editor.isDestroyed) return\n    const body = renditionBody(editor, response, t)\n    if (!body.length) {\n      notify({ title: t('integrations.rendition.empty.title'), description: t('integrations.rendition.empty.description'), kind: 'error' })\n      return\n    }\n\n    // The Baustein, found again through its anchored description; its source may have changed meanwhile.\n    const range = resolveRange(editor.state, anchor)\n    const $from = range && editor.state.doc.resolve(range.from)\n    const parentPos = $from && $from.parent.type.name === 'compositeDescription' ? $from.before($from.depth - 1) : null\n    const parent = parentPos === null ? null : editor.state.doc.nodeAt(parentPos)\n    const currentSource = parent && sourceOf(parent, kinds)\n    const replaced = replaceId ? findBlockById(editor.state.doc, replaceId) : null\n    if (parentPos === null || !parent || !currentSource || (replaceId !== null && (!replaced || replaced.pos <= parentPos || replaced.pos >= parentPos + parent.nodeSize))) {\n      notify({ title: t('integrations.rendition.gone.title'), description: t('integrations.rendition.gone.description'), kind: 'error' })\n      return\n    }\n\n    // The model that wrote the content: the speech-to-text model for a transcription, the chat model for OCR and an\n    // image description, none for the PDF text layer.\n    const usedModel = response.method === 'transcription' ? response.model : response.method === 'ocr' || response.method === 'description' ? ('preset' in model ? model.preset : model.model) : undefined\n    const derivation: Derivation = {\n      from: { asset: asset.name },\n      method: response.method,\n      ...(usedModel ? { model: usedModel } : {}),\n      createdAt: new Date().toISOString(),\n      inputHash: response.inputHash,\n      outputHash: '',\n      ...(response.output ? { output: response.output } : {}),\n    }\n    const { schema } = editor\n    const bodyNodes = body.map(block => schema.nodeFromJSON(block))\n    const id = replaceId ?? newBlockId()\n    let node: PMNode\n    if (replaced) {\n      const chrome = Array.from({ length: COMPOSITE_CHROME_COUNT }, (_, index) => replaced.node.child(index))\n      node = sealed(editor, replaced.node.type.create(replaced.node.attrs, Fragment.from([...chrome, ...bodyNodes])), derivation)\n    }\n    else {\n      const titleKey = TITLED_METHODS.includes(response.method) ? `integrations.rendition.title.${response.method}` as MessageKey : null\n      const json = compositeJSON('rendition', body)\n      const [title, ...rest] = json.content!\n      const text = titleKey ? t(titleKey) : compositeKind(kinds, 'rendition').label\n      const fresh = schema.nodeFromJSON({ ...json, attrs: { ...json.attrs, id }, content: [{ ...title!, content: [{ type: 'text', text }] }, ...rest] })\n      node = sealed(editor, fresh, derivation)\n    }\n\n    const tr = editor.state.tr\n    if (replaced) tr.replaceWith(replaced.pos, replaced.pos + replaced.node.nodeSize, node)\n    else {\n      let insertPos = parentPos + 1\n      for (let index = 0; index <= currentSource.index; index++) insertPos += parent.child(index).nodeSize\n      if (!parent.canReplace(currentSource.index + 1, currentSource.index + 1, Fragment.from(node))) {\n        notify({ title: t('integrations.rendition.notAccepted'), kind: 'error' })\n        return\n      }\n      tr.insert(insertPos, node)\n    }\n    // Bibliographic data fills only what is empty; the title is never part of `meta.bib`.\n    const { bib } = response\n    const workTitle = bib?.title?.trim()\n    if (workTitle && !parent.child(0).textContent.trim()) tr.insert(parentPos + 2, schema.text(workTitle))\n    if (bib && bibOf(parent) === null) {\n      const csl = { ...bib }\n      delete csl.title\n      tr.setNodeMarkup(parentPos, undefined, { ...parent.attrs, meta: { ...parent.attrs.meta, bib: csl } })\n    }\n    editor.view.dispatch(tr)\n    editor.commands.revealBlock(id)\n    notify({ title: t('integrations.rendition.done'), kind: 'success', icon: 'i-lucide-captions' })\n    if (response.warnings.length) {\n      notify({\n        title: t('integrations.rendition.warnings.title'),\n        description: response.warnings.map(code => (WARNING_KEYS[code] ? t(WARNING_KEYS[code]) : code)).join(' '),\n        kind: 'info',\n      })\n    }\n  }\n  catch (err) {\n    if (controller.signal.aborted || editor.isDestroyed) return\n    if (isRateLimited(err)) notifyAiRateLimited(notify, t)\n    else notify({ title: t('integrations.rendition.failed'), description: fetchErrorMessage(err), kind: 'error' })\n  }\n  finally {\n    notify.dismiss?.(toastId)\n    editor.off('destroy', abort)\n    releaseRanges(editor, [anchor])\n  }\n}\n\n/**\n * Whether „Lesefassung erzeugen“ applies to `node`: a Baustein of a source-holding kind whose source block was\n * found. A recording needs speech-to-text (`transcription`: the app's public configuration enables it); everything else\n * is extracted by the server.\n */\nexport function canCreateRendition(editor: Editor, node: PMNode, transcription: boolean): boolean {\n  const source = sourceOf(node, compositeKindsOf(editor))\n  if (!source) return false\n  return transcription || (source.node.type.name !== 'audio' && source.node.type.name !== 'video')\n}\n\n/** The source-holding Baustein around the asset-derived rendition at `pos`; null for anything else. */\nfunction renditionParentOf(editor: Editor, pos: number): { node: PMNode, pos: number } | null {\n  const node = editor.state.doc.nodeAt(pos)\n  const derivation = node && derivationOf(node)\n  if (!derivation || !('asset' in derivation.from)) return null\n  const $pos = editor.state.doc.resolve(pos)\n  if ($pos.depth === 0 || $pos.parent.type.name !== 'composite' || !sourceOf($pos.parent, compositeKindsOf(editor))) return null\n  return { node: $pos.parent, pos: $pos.before() }\n}\n\n/** Whether „Neu erzeugen (ersetzen)“ applies to the Baustein `node` at `pos`: an asset-derived rendition inside a Baustein that still has a source. */\nexport function canRegenerateRendition(editor: Editor, node: PMNode, pos: number, transcription: boolean): boolean {\n  const parent = node.type.name === 'composite' ? renditionParentOf(editor, pos) : null\n  return parent !== null && canCreateRendition(editor, parent.node, transcription)\n}\n\n/**\n * „Neu erzeugen (ersetzen)“: makes the rendition at `pos` again from the source of its Baustein and replaces it in place\n * (`createRendition` with `replace`; the block id stays, so references keep resolving). A rendition whose body was\n * edited since it was made is not replaced silently: a warning notice offers „Trotzdem ersetzen“, dismissing the notice\n * cancels. The rendition is found again by its id when the button is pressed.\n */\nexport function regenerateRendition(editor: Editor, pos: number, ai: NonNullable<EditorBackend['ai']>, modelRef: (slot: 'generate') => ModelRef, notify: Notifier, t: Translate): void {\n  const node = editor.state.doc.nodeAt(pos)\n  const id = node && blockIdOf(node)\n  const parent = renditionParentOf(editor, pos)\n  if (!node || !id || !parent) return\n\n  const replace = () => {\n    const found = findBlockById(editor.state.doc, id)\n    const current = found && renditionParentOf(editor, found.pos)\n    if (found && current) void createRendition(editor, current.pos, ai, modelRef, notify, t, { replace: { pos: found.pos } })\n  }\n  const kinds = compositeKindsOf(editor)\n  if (derivationState(parent.node, node, () => sha256Hex(bodyMarkdown(editor, node)), kinds).edited !== true) {\n    replace()\n    return\n  }\n  notify({\n    id: `rendition-edited-${id}`,\n    title: t('integrations.rendition.editedWarning.title'),\n    description: t('integrations.rendition.editedWarning.description'),\n    kind: 'warning',\n    action: { label: t('integrations.rendition.editedWarning.confirm'), onClick: replace },\n  })\n}\n"],"mappings":"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"}

package/dist/integrations/composite-media/index.d.ts

@@ -5,11 +5,13 @@ import "../../core/index.js";
  * File import into composites. Needs the `composites` and `media` features; neither imports this one.
  *
  * - **Wrapping:** the `wrapImport` stage puts the blocks of every imported file (parsed text or Markdown, or the
- *   uploaded media or file block; drop, paste, picker and recorder alike) into one `document` composite titled with the
- *   file's name stem and carrying its filename, type, size and import date as meta. Without this feature the blocks are
- *   inserted as they are.
- * - **Action:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them
- *   through `editor.storage.media.importFiles` at the caret.
+ *   uploaded media or file block; drop, paste, picker and recorder alike) into one composite titled with the
+ *   file's name stem and carrying its filename, type, size and import date as meta. The kind follows the MIME type:
+ *   audio and video become a `recording`, images a `figure`, everything else (PDFs, office files, text) a `document`.
+ *   Without this feature the blocks are inserted as they are.
+ * - **Actions:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them
+ *   through `editor.storage.media.importFiles` at the caret; the block action „Quelle ersetzen“ (`source-replace`, on
+ *   composites with a source block) uploads a new file into the existing source block, keeping its id.
  *
  * Install it anywhere after `composites` and `media`; the `/` entry follows the order of the feature list. Framework-free
  * (`EditorFeature<never>`: no component slots), so one instance serves the Vue and the React surface.

package/dist/integrations/composite-media/index.js

@@ -1,6 +1,9 @@
 import { ABILITY } from "../../core/schema/abilities.js";
-import { compositeJSON } from "../../features/composites/nodes.js";
-import { mediaMime } from "../../features/media/schema.js";
+import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
+import { fetchErrorMessage } from "../../core/fetch-error.js";
+import { sourceOf } from "../../features/composites/derivation.js";
+import { compositeJSON, compositeKindsOf } from "../../features/composites/nodes.js";
+import { acceptFor, mediaKindOf, mediaMime } from "../../features/media/schema.js";
 import { pickFiles } from "../../features/media/upload.js";
 import { isTextFile } from "../../features/media/file-import.js";
 //#region src/integrations/composite-media/index.ts
@@ -9,15 +12,21 @@ function stemOf(name) {
 	const dot = name.lastIndexOf(".");
 	return dot > 0 ? name.slice(0, dot) : name;
 }
-/** A `document` composite titled with the stem of `file`'s name, holding its original name, type, size and import date. */
-function documentComposite(file, text, body) {
-	const composite = compositeJSON("document", body);
+/** The kind an imported `file` becomes: audio and video a `recording`, an image a `figure`, anything else (PDFs, office files, text) a `document`. */
+function importKindOf(editor, file, text) {
+	const kind = text ? null : mediaKindOf(file.type);
+	const id = kind === "audio" || kind === "video" ? "recording" : kind === "image" ? "figure" : "document";
+	return compositeKindsOf(editor).some((k) => k.id === id) ? id : "document";
+}
+/** A composite of kind `kind` titled with the stem of `file`'s name, holding its original name, type, size and import date. */
+function documentComposite(kind, file, text, body) {
+	const composite = compositeJSON(kind, body);
 	const [title, ...rest] = composite.content;
 	const stem = stemOf(file.name);
 	return {
 		...composite,
 		attrs: {
-			kind: "document",
+			kind,
 			meta: {
 				filename: file.name,
 				mimeType: mediaMime(file.type) || (text ? "text/markdown" : "application/octet-stream"),
@@ -35,14 +44,75 @@ function documentComposite(file, text, body) {
 	};
 }
 /**
+* Swaps the source file of `composite` in place: picks a file of the source block's media type, uploads it and rewrites
+* `src`, `hash`, `mimeType`, `title` and `size` of the existing source block (those of them its node type has). The
+* block keeps its attributes otherwise, its id included, and so do the composite and every reference to either.
+*/
+async function replaceSource(editor, composite, ctx) {
+	const source = sourceOf(composite, compositeKindsOf(editor));
+	const sourceId = source && blockIdOf(source.node);
+	if (!source || !sourceId) return;
+	const type = source.node.type.name;
+	const [file] = await pickFiles(acceptFor(type), false);
+	if (!file || editor.isDestroyed) return;
+	try {
+		if ((mediaKindOf(file.type) ?? "file") !== type) throw new Error(`${file.type || file.name}: ${type}`);
+		const { url, sha256 } = await editor.storage.media.upload(file);
+		if (editor.isDestroyed) return;
+		const target = findBlockById(editor.state.doc, sourceId);
+		if (!target) {
+			ctx.notify({
+				title: ctx.t("integrations.sourceReplace.gone"),
+				kind: "error"
+			});
+			return;
+		}
+		const next = {
+			src: url,
+			hash: sha256 ?? null,
+			mimeType: mediaMime(file.type) || "application/octet-stream",
+			title: file.name,
+			size: file.size
+		};
+		const attrs = { ...target.node.attrs };
+		for (const [key, value] of Object.entries(next)) if (key in attrs) attrs[key] = value;
+		editor.view.dispatch(editor.state.tr.setNodeMarkup(target.pos, void 0, attrs));
+		ctx.notify({
+			title: ctx.t("integrations.sourceReplace.done"),
+			kind: "success"
+		});
+	} catch (error) {
+		ctx.notify({
+			title: ctx.t("integrations.sourceReplace.failed"),
+			description: fetchErrorMessage(error),
+			kind: "error"
+		});
+	}
+}
+function sourceActions(ctx) {
+	return [{
+		id: "source-replace",
+		label: ctx.t("integrations.sourceReplace.action"),
+		icon: "i-lucide-file-input",
+		ability: ABILITY.media,
+		order: 420,
+		isVisible: ({ editor, node }) => node.type.name === "composite" && sourceOf(node, compositeKindsOf(editor)) !== null,
+		run: ({ editor, node }) => {
+			replaceSource(editor, node, ctx);
+		}
+	}];
+}
+/**
 * File import into composites. Needs the `composites` and `media` features; neither imports this one.
 *
 * - **Wrapping:** the `wrapImport` stage puts the blocks of every imported file (parsed text or Markdown, or the
-*   uploaded media or file block; drop, paste, picker and recorder alike) into one `document` composite titled with the
-*   file's name stem and carrying its filename, type, size and import date as meta. Without this feature the blocks are
-*   inserted as they are.
-* - **Action:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them
-*   through `editor.storage.media.importFiles` at the caret.
+*   uploaded media or file block; drop, paste, picker and recorder alike) into one composite titled with the
+*   file's name stem and carrying its filename, type, size and import date as meta. The kind follows the MIME type:
+*   audio and video become a `recording`, images a `figure`, everything else (PDFs, office files, text) a `document`.
+*   Without this feature the blocks are inserted as they are.
+* - **Actions:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them
+*   through `editor.storage.media.importFiles` at the caret; the block action „Quelle ersetzen“ (`source-replace`, on
+*   composites with a source block) uploads a new file into the existing source block, keeping its id.
 *
 * Install it anywhere after `composites` and `media`; the `/` entry follows the order of the feature list. Framework-free
 * (`EditorFeature<never>`: no component slots), so one instance serves the Vue and the React surface.
@@ -50,10 +120,13 @@ function documentComposite(file, text, body) {
 function compositeMediaFeature() {
 	return {
 		id: "composite-media",
+		dimension: "content",
 		requires: ["composites", "media"],
-		blocks: { wrapImport: (_editor, file, blocks) => [documentComposite(file, isTextFile(file), blocks)] },
-		slashCommands: (ctx) => [{
+		blocks: { wrapImport: (editor, file, blocks) => [documentComposite(importKindOf(editor, file, isTextFile(file)), file, isTextFile(file), blocks)] },
+		blockActions: sourceActions,
+		commands: (ctx) => [{
 			id: "datei",
+			slash: {},
 			label: ctx.t("integrations.compositeMedia.import"),
 			icon: "i-lucide-file-up",
 			ability: ABILITY.composite,