@ecsplico/editor 2.1.2 → 3.0.0

package/dist/features/composites/convert.js

@@ -1,5 +1,6 @@
 import { CORE_TARGET_IDS, childrenOf, createConverter, finishConversion, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, parseCoreTarget, textblockSpecOf } from "../../core/convert.js";
 import { compositeKind, defaultCompositeKinds, fallbackCompositeKinds } from "./kinds.js";
+import { keptMeta } from "./meta-keys.js";
 import { compositeChromeBlocks, flattenCompositesToHeadings, headingGroupRange } from "./heading-composites.js";
 import "./nodes.js";
 import { Fragment } from "@tiptap/pm/model";
@@ -40,8 +41,7 @@ function convertCompositeBlocks(schema, nodes, target, kinds) {
 	});
 	function toComposite(head, rest, kind) {
 		if (isComposite(head)) {
-			const keys = new Set(compositeKind(kinds, kind).fields.map((field) => field.key));
-			const meta = Object.fromEntries(Object.entries(head.attrs.meta).filter(([key]) => keys.has(key)));
+			const meta = keptMeta(compositeKind(kinds, kind), head.attrs.meta);
 			return head.type.create({
 				...head.attrs,
 				kind,

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

@@ -1 +1 @@
-{"version":3,"file":"convert.js","names":[],"sources":["../../../src/features/composites/convert.ts"],"sourcesContent":["import { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport {\n  CORE_TARGET_IDS,\n  childrenOf,\n  type ConvertTarget,\n  createConverter,\n  finishConversion,\n  isCoreTarget,\n  isCurrentTarget,\n  isListNode,\n  isQuoteNode,\n  isTextblockNode,\n  parseCoreTarget,\n  textblockSpecOf,\n} from '../../core/convert'\nimport type { ConversionProvider } from '../../core/feature'\nimport { compositeChromeBlocks, flattenCompositesToHeadings, headingGroupRange } from './heading-composites'\nimport { type CompositeKind, compositeKind, defaultCompositeKinds, fallbackCompositeKinds } from './kinds'\nimport { COMPOSITE_CHROME_COUNT } from './nodes'\n\n// Vue-free and server-importable: the composite family's block conversions — wrapping blocks into a composite,\n// switching its kind and unwrapping it into plain blocks — as `ConversionProvider`s of the composite feature.\n\nconst COMPOSITE = 'composite'\nconst TITLE = 'compositeTitle'\nconst COMPOSITE_PREFIX = 'composite:'\n\nconst isComposite = (node: PMNode) => node.type.name === COMPOSITE\n\n/** The conversion targets of the core provider, offered for composites (they unwrap into them). */\nconst UNWRAP_TARGETS: readonly ConvertTarget[] = CORE_TARGET_IDS.flatMap(id => parseCoreTarget(id) ?? [])\n\n/**\n * Blocks `nodes` (siblings) converted to `target`. A composite takes the first block as title and the rest as body;\n * composites unwrap into the core targets (title first, description as italic paragraph, tags as a paragraph of tag\n * chips, meta as a `Label: Wert` line); into a heading, nested composites become sub-headings. Null when nothing\n * changes, the target is not a composite or core target or a node is not a textblock, list, quote or composite.\n * Never looks outside `nodes`: a heading's group is the caller's business.\n */\nexport function convertCompositeBlocks(schema: Schema, nodes: PMNode[], target: ConvertTarget, kinds: readonly CompositeKind[]): PMNode[] | null {\n  const first = nodes[0]\n  if (!first || !schema.nodes[target.type]) return null\n  if (!nodes.every(node => isTextblockNode(node) || isListNode(node) || isQuoteNode(node) || isComposite(node))) return null\n  if (nodes.length === 1 && isCurrentTarget(first, target)) return null\n  const n = schema.nodes\n  const paragraph = n.paragraph!\n\n  /** A composite as plain blocks: title paragraph (an empty one only with `keepEmptyTitle`), description, tags, meta, body. */\n  function unwrapComposite(composite: PMNode, keepEmptyTitle: boolean, headingLevel?: number): PMNode[] {\n    const title = composite.child(0)\n    const blocks: PMNode[] = []\n    if (keepEmptyTitle || title.content.size) blocks.push(paragraph.create(null, title.content))\n    blocks.push(...compositeChromeBlocks(schema, composite, kinds))\n    let body = childrenOf(composite, COMPOSITE_CHROME_COUNT)\n    if (headingLevel !== undefined) body = flattenCompositesToHeadings(schema, body, true, headingLevel + 1, kinds) ?? body\n    return [...blocks, ...body]\n  }\n\n  const converter = createConverter(schema, { is: isComposite, unwrap: unwrapComposite })\n\n  function toComposite(head: PMNode, rest: PMNode[], kind: string): PMNode {\n    if (isComposite(head)) {\n      // Another kind: the same node; `meta` keeps only the fields of the new kind. Further blocks join its body.\n      const keys = new Set(compositeKind(kinds, kind).fields.map(field => field.key))\n      const meta = Object.fromEntries(Object.entries(head.attrs.meta as Record<string, unknown>).filter(([key]) => keys.has(key)))\n      return head.type.create({ ...head.attrs, kind, meta }, [...childrenOf(head), ...rest])\n    }\n    let title = Fragment.empty\n    let body: PMNode[] = []\n    if (isTextblockNode(head)) title = converter.inline(head, TITLE)\n    else if (isQuoteNode(head)) body = childrenOf(head)\n    else {\n      // List: the first item's paragraph is the title, its other blocks and the remaining items (same list type) the body.\n      const [item, ...more] = childrenOf(head)\n      const [itemHead, ...itemRest] = item ? childrenOf(item) : []\n      if (itemHead && isTextblockNode(itemHead)) title = converter.inline(itemHead, TITLE)\n      else if (itemHead) itemRest.unshift(itemHead)\n      body = [...itemRest, ...(more.length ? [head.type.create(null, more)] : [])]\n    }\n    body = [...body, ...rest]\n    if (!body.length) body = [paragraph.create()]\n    return n[COMPOSITE]!.create({ kind }, [n[TITLE]!.create(null, title), n.compositeDescription!.create(), n.compositeTags!.create(), ...body])\n  }\n\n  let output: PMNode[]\n  if (target.type === 'composite') output = [toComposite(first, nodes.slice(1), target.kind)]\n  else if (!isCoreTarget(target)) return null\n  else if (target.type === 'bulletList' || target.type === 'orderedList') output = converter.toList(nodes, target.type)\n  else if (target.type === 'blockquote') output = converter.toQuote(nodes)\n  else output = converter.toTextblocks(nodes, textblockSpecOf(target))\n  return finishConversion(nodes, output)\n}\n\n/**\n * The conversion of the block right after `$start` into `target`: the range it replaces (a heading becoming a composite\n * takes its group along, which turns into the composite's body) and the converted blocks.\n */\nfunction convertAt(kinds: readonly CompositeKind[]): ConversionProvider['convert'] {\n  return (state, $start, target) => {\n    const parent = $start.parent\n    const from = $start.index()\n    const to = target.type === 'composite' && parent.child(from).type.name === 'heading' ? headingGroupRange(parent, from).to : from + 1\n    const nodes: PMNode[] = []\n    for (let index = from; index < to; index++) nodes.push(parent.child(index))\n    const blocks = convertCompositeBlocks(state.schema, nodes, target, kinds)\n    return blocks ? { from: $start.pos, to: nodes.reduce((end, node) => end + node.nodeSize, $start.pos), blocks } : null\n  }\n}\n\n/**\n * The composite feature's providers, in menu order. The first claims composites as source blocks (`handlesSource`): it\n * offers the core targets for them and executes every conversion of a composite, including kind changes. The second\n * owns the `composite:<kind>` targets: blocks and kind switches. `kinds` are the host's configured kinds; without them the\n * built-in kinds apply, and their labels (the menu entries) follow the language of the `t` the menu renders with. What\n * a conversion writes into the document (the `Label: Wert` line of a composite's meta) uses the built-in kinds in the\n * default language, since `convert` runs without a translator.\n */\nexport function compositeConversions(kinds?: readonly CompositeKind[]): readonly ConversionProvider[] {\n  const structure = kinds ?? fallbackCompositeKinds()\n  const convert = convertAt(structure)\n  const unwrap: ConversionProvider = {\n    handlesSource: isComposite,\n    targets: (_editor, node) => isComposite(node) ? UNWRAP_TARGETS.filter(target => node.type.schema.nodes[target.type]) : [],\n    parseTarget: () => null,\n    label: () => null,\n    convert,\n  }\n  const wrap: ConversionProvider = {\n    targets: (_editor, node) => {\n      if (!(isTextblockNode(node) || isListNode(node) || isQuoteNode(node) || isComposite(node)) || !node.type.schema.nodes[COMPOSITE]) return []\n      return structure.map((kind): ConvertTarget => ({ type: 'composite', kind: kind.id })).filter(target => !isCurrentTarget(node, target))\n    },\n    parseTarget: (id) => {\n      if (!id.startsWith(COMPOSITE_PREFIX)) return null\n      const kind = id.slice(COMPOSITE_PREFIX.length)\n      return structure.some(known => known.id === kind) ? { type: 'composite', kind } : null\n    },\n    label: (target, t) => {\n      if (target.type !== 'composite') return null\n      const kind = compositeKind(kinds ?? defaultCompositeKinds(t), target.kind)\n      return { label: t('composites.convert.kind', { kind: kind.label }), icon: kind.icon }\n    },\n    convert,\n  }\n  return [unwrap, wrap]\n}\n"],"mappings":"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"}
+{"version":3,"file":"convert.js","names":[],"sources":["../../../src/features/composites/convert.ts"],"sourcesContent":["import { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport {\n  CORE_TARGET_IDS,\n  childrenOf,\n  type ConvertTarget,\n  createConverter,\n  finishConversion,\n  isCoreTarget,\n  isCurrentTarget,\n  isListNode,\n  isQuoteNode,\n  isTextblockNode,\n  parseCoreTarget,\n  textblockSpecOf,\n} from '../../core/convert'\nimport type { ConversionProvider } from '../../core/feature'\nimport { compositeChromeBlocks, flattenCompositesToHeadings, headingGroupRange } from './heading-composites'\nimport { type CompositeKind, compositeKind, defaultCompositeKinds, fallbackCompositeKinds } from './kinds'\nimport { keptMeta } from './meta-keys'\nimport { COMPOSITE_CHROME_COUNT } from './nodes'\n\n// Vue-free and server-importable: the composite family's block conversions — wrapping blocks into a composite,\n// switching its kind and unwrapping it into plain blocks — as `ConversionProvider`s of the composite feature.\n\nconst COMPOSITE = 'composite'\nconst TITLE = 'compositeTitle'\nconst COMPOSITE_PREFIX = 'composite:'\n\nconst isComposite = (node: PMNode) => node.type.name === COMPOSITE\n\n/** The conversion targets of the core provider, offered for composites (they unwrap into them). */\nconst UNWRAP_TARGETS: readonly ConvertTarget[] = CORE_TARGET_IDS.flatMap(id => parseCoreTarget(id) ?? [])\n\n/**\n * Blocks `nodes` (siblings) converted to `target`. A composite takes the first block as title and the rest as body;\n * composites unwrap into the core targets (title first, description as italic paragraph, tags as a paragraph of tag\n * chips, meta as a `Label: Wert` line); into a heading, nested composites become sub-headings. Null when nothing\n * changes, the target is not a composite or core target or a node is not a textblock, list, quote or composite.\n * Never looks outside `nodes`: a heading's group is the caller's business.\n */\nexport function convertCompositeBlocks(schema: Schema, nodes: PMNode[], target: ConvertTarget, kinds: readonly CompositeKind[]): PMNode[] | null {\n  const first = nodes[0]\n  if (!first || !schema.nodes[target.type]) return null\n  if (!nodes.every(node => isTextblockNode(node) || isListNode(node) || isQuoteNode(node) || isComposite(node))) return null\n  if (nodes.length === 1 && isCurrentTarget(first, target)) return null\n  const n = schema.nodes\n  const paragraph = n.paragraph!\n\n  /** A composite as plain blocks: title paragraph (an empty one only with `keepEmptyTitle`), description, tags, meta, body. */\n  function unwrapComposite(composite: PMNode, keepEmptyTitle: boolean, headingLevel?: number): PMNode[] {\n    const title = composite.child(0)\n    const blocks: PMNode[] = []\n    if (keepEmptyTitle || title.content.size) blocks.push(paragraph.create(null, title.content))\n    blocks.push(...compositeChromeBlocks(schema, composite, kinds))\n    let body = childrenOf(composite, COMPOSITE_CHROME_COUNT)\n    if (headingLevel !== undefined) body = flattenCompositesToHeadings(schema, body, true, headingLevel + 1, kinds) ?? body\n    return [...blocks, ...body]\n  }\n\n  const converter = createConverter(schema, { is: isComposite, unwrap: unwrapComposite })\n\n  function toComposite(head: PMNode, rest: PMNode[], kind: string): PMNode {\n    if (isComposite(head)) {\n      // Another kind: the same node; `meta` keeps the fields of the new kind plus `derivation` and `bib`. Further blocks join its body.\n      const meta = keptMeta(compositeKind(kinds, kind), head.attrs.meta as Record<string, unknown>)\n      return head.type.create({ ...head.attrs, kind, meta }, [...childrenOf(head), ...rest])\n    }\n    let title = Fragment.empty\n    let body: PMNode[] = []\n    if (isTextblockNode(head)) title = converter.inline(head, TITLE)\n    else if (isQuoteNode(head)) body = childrenOf(head)\n    else {\n      // List: the first item's paragraph is the title, its other blocks and the remaining items (same list type) the body.\n      const [item, ...more] = childrenOf(head)\n      const [itemHead, ...itemRest] = item ? childrenOf(item) : []\n      if (itemHead && isTextblockNode(itemHead)) title = converter.inline(itemHead, TITLE)\n      else if (itemHead) itemRest.unshift(itemHead)\n      body = [...itemRest, ...(more.length ? [head.type.create(null, more)] : [])]\n    }\n    body = [...body, ...rest]\n    if (!body.length) body = [paragraph.create()]\n    return n[COMPOSITE]!.create({ kind }, [n[TITLE]!.create(null, title), n.compositeDescription!.create(), n.compositeTags!.create(), ...body])\n  }\n\n  let output: PMNode[]\n  if (target.type === 'composite') output = [toComposite(first, nodes.slice(1), target.kind)]\n  else if (!isCoreTarget(target)) return null\n  else if (target.type === 'bulletList' || target.type === 'orderedList') output = converter.toList(nodes, target.type)\n  else if (target.type === 'blockquote') output = converter.toQuote(nodes)\n  else output = converter.toTextblocks(nodes, textblockSpecOf(target))\n  return finishConversion(nodes, output)\n}\n\n/**\n * The conversion of the block right after `$start` into `target`: the range it replaces (a heading becoming a composite\n * takes its group along, which turns into the composite's body) and the converted blocks.\n */\nfunction convertAt(kinds: readonly CompositeKind[]): ConversionProvider['convert'] {\n  return (state, $start, target) => {\n    const parent = $start.parent\n    const from = $start.index()\n    const to = target.type === 'composite' && parent.child(from).type.name === 'heading' ? headingGroupRange(parent, from).to : from + 1\n    const nodes: PMNode[] = []\n    for (let index = from; index < to; index++) nodes.push(parent.child(index))\n    const blocks = convertCompositeBlocks(state.schema, nodes, target, kinds)\n    return blocks ? { from: $start.pos, to: nodes.reduce((end, node) => end + node.nodeSize, $start.pos), blocks } : null\n  }\n}\n\n/**\n * The composite feature's providers, in menu order. The first claims composites as source blocks (`handlesSource`): it\n * offers the core targets for them and executes every conversion of a composite, including kind changes. The second\n * owns the `composite:<kind>` targets: blocks and kind switches. `kinds` are the host's configured kinds; without them the\n * built-in kinds apply, and their labels (the menu entries) follow the language of the `t` the menu renders with. What\n * a conversion writes into the document (the `Label: Wert` line of a composite's meta) uses the built-in kinds in the\n * default language, since `convert` runs without a translator.\n */\nexport function compositeConversions(kinds?: readonly CompositeKind[]): readonly ConversionProvider[] {\n  const structure = kinds ?? fallbackCompositeKinds()\n  const convert = convertAt(structure)\n  const unwrap: ConversionProvider = {\n    handlesSource: isComposite,\n    targets: (_editor, node) => isComposite(node) ? UNWRAP_TARGETS.filter(target => node.type.schema.nodes[target.type]) : [],\n    parseTarget: () => null,\n    label: () => null,\n    convert,\n  }\n  const wrap: ConversionProvider = {\n    targets: (_editor, node) => {\n      if (!(isTextblockNode(node) || isListNode(node) || isQuoteNode(node) || isComposite(node)) || !node.type.schema.nodes[COMPOSITE]) return []\n      return structure.map((kind): ConvertTarget => ({ type: 'composite', kind: kind.id })).filter(target => !isCurrentTarget(node, target))\n    },\n    parseTarget: (id) => {\n      if (!id.startsWith(COMPOSITE_PREFIX)) return null\n      const kind = id.slice(COMPOSITE_PREFIX.length)\n      return structure.some(known => known.id === kind) ? { type: 'composite', kind } : null\n    },\n    label: (target, t) => {\n      if (target.type !== 'composite') return null\n      const kind = compositeKind(kinds ?? defaultCompositeKinds(t), target.kind)\n      return { label: t('composites.convert.kind', { kind: kind.label }), icon: kind.icon }\n    },\n    convert,\n  }\n  return [unwrap, wrap]\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,61 @@
+import { CompositeKind } from "./kinds.js";
+import { DERIVATION_KEY } from "./meta-keys.js";
+import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/composites/derivation.d.ts
+/** How a derived Baustein was made; `ai:<kindId>` for a block derived from another block by the model. */
+export type DerivationMethod = 'transcription' | 'pdf-text' | 'ocr' | 'description' | 'bibliography' | (string & {});
+/** What a derived Baustein was made from: an uploaded asset (by asset name) or another block (by block id). */
+export type DerivationSource = {
+  asset: string;
+} | {
+  block: string;
+};
+/** `meta.derivation` of a derived Baustein. */
+export interface Derivation {
+  from: DerivationSource;
+  method: DerivationMethod;
+  model?: string;
+  /** ISO timestamp. */
+  createdAt: string;
+  /** SHA-256 hex of the asset bytes / of the source block's Markdown; `''` when unknown. */
+  inputHash: string;
+  /** SHA-256 hex of the produced body's Markdown; `''` when unknown. */
+  outputHash: string;
+  /** Asset name of the stored raw output (text/markdown). */
+  output?: string;
+}
+/** The derivation of a composite (`meta.derivation` with a `from` object and a `method`); null when it has none. */
+export declare function derivationOf(node: Node$1): Derivation | null;
+/** The media block a source-holding kind keeps its original in: first body child of a type in `kind.source`. */
+export declare function sourceOf(composite: Node$1, kinds: readonly CompositeKind[]): {
+  node: Node$1;
+  index: number;
+  asset: {
+    documentId: string;
+    name: string;
+  } | null;
+  hash: string | null;
+} | null;
+/** The body children of `composite` that are derived Bausteine, with their child index. */
+export declare function renditionsOf(composite: Node$1): {
+  node: Node$1;
+  index: number;
+  derivation: Derivation;
+}[];
+/**
+ * Whether `derived` (a Baustein with a derivation, a child of `composite`) is out of date or was edited since it was made.
+ * `stale`: for an asset source, the block `sourceOf(composite, kinds)` finds has a `hash` that differs from `inputHash`; null
+ * when either is unknown. A block source is null here: callers with the document compare the hash of the source block's
+ * Markdown. `edited`: the body's
+ * hash (computed lazily, it serialises the whole body) differs from `outputHash`; null when `outputHash` is unknown.
+ */
+export declare function derivationState(composite: Node$1, derived: Node$1, bodyHash: () => string, kinds: readonly CompositeKind[]): {
+  stale: boolean | null;
+  edited: boolean | null;
+};
+/** Markdown of the body of `composite` (everything after title, description and tags). */
+export declare function bodyMarkdown(editor: Editor, composite: Node$1): string;
+//#endregion
+export { DERIVATION_KEY };
+//# sourceMappingURL=derivation.d.ts.map

package/dist/features/composites/derivation.js

@@ -0,0 +1,98 @@
+import { EDITOR_API } from "../../core/api-routes.js";
+import { compositeKind } from "./kinds.js";
+import { DERIVATION_KEY } from "./meta-keys.js";
+import "./nodes.js";
+//#region src/features/composites/derivation.ts
+/** The derivation of a composite (`meta.derivation` with a `from` object and a `method`); null when it has none. */
+function derivationOf(node) {
+	const meta = node.attrs.meta;
+	const value = meta && typeof meta === "object" ? meta[DERIVATION_KEY] : void 0;
+	if (!value || typeof value !== "object") return null;
+	const { from, method } = value;
+	if (!from || typeof from !== "object" || typeof method !== "string") return null;
+	return value;
+}
+const ASSET_URL_PREFIX = `${EDITOR_API}/assets/`;
+const ASSET_NAME = /^[0-9a-f-]{36}\.[a-z0-9]{1,8}$/;
+const ASSET_DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/;
+/** The stored asset behind an `/api/editor/assets/<documentId>/<name>` URL; null for any other `src`. */
+function assetRefOf(src) {
+	if (!src.startsWith(ASSET_URL_PREFIX)) return null;
+	const [documentId, name, ...rest] = src.slice(ASSET_URL_PREFIX.length).split("/");
+	if (rest.length || !documentId || !name || !ASSET_DOCUMENT_ID.test(documentId) || !ASSET_NAME.test(name)) return null;
+	return {
+		documentId,
+		name
+	};
+}
+/** The media block a source-holding kind keeps its original in: first body child of a type in `kind.source`. */
+function sourceOf(composite, kinds) {
+	if (composite.type.name !== "composite") return null;
+	const types = compositeKind(kinds, String(composite.attrs.kind)).source;
+	if (!types) return null;
+	for (let index = 3; index < composite.childCount; index++) {
+		const node = composite.child(index);
+		if (!types.includes(node.type.name)) continue;
+		const hash = node.attrs.hash;
+		return {
+			node,
+			index,
+			asset: assetRefOf(String(node.attrs.src ?? "")),
+			hash: typeof hash === "string" && hash ? hash : null
+		};
+	}
+	return null;
+}
+/** The body children of `composite` that are derived Bausteine, with their child index. */
+function renditionsOf(composite) {
+	const found = [];
+	composite.forEach((node, _offset, index) => {
+		if (index < 3 || node.type.name !== "composite") return;
+		const derivation = derivationOf(node);
+		if (derivation) found.push({
+			node,
+			index,
+			derivation
+		});
+	});
+	return found;
+}
+/**
+* Whether `derived` (a Baustein with a derivation, a child of `composite`) is out of date or was edited since it was made.
+* `stale`: for an asset source, the block `sourceOf(composite, kinds)` finds has a `hash` that differs from `inputHash`; null
+* when either is unknown. A block source is null here: callers with the document compare the hash of the source block's
+* Markdown. `edited`: the body's
+* hash (computed lazily, it serialises the whole body) differs from `outputHash`; null when `outputHash` is unknown.
+*/
+function derivationState(composite, derived, bodyHash, kinds) {
+	const derivation = derivationOf(derived);
+	if (!derivation) return {
+		stale: null,
+		edited: null
+	};
+	let stale = null;
+	if ("asset" in derivation.from) {
+		const hash = sourceOf(composite, kinds)?.hash;
+		stale = hash && derivation.inputHash ? hash !== derivation.inputHash : null;
+	}
+	const edited = derivation.outputHash ? bodyHash() !== derivation.outputHash : null;
+	return {
+		stale,
+		edited
+	};
+}
+/** Markdown of the body of `composite` (everything after title, description and tags). */
+function bodyMarkdown(editor, composite) {
+	const content = [];
+	composite.forEach((child, _offset, index) => {
+		if (index >= 3) content.push(child.toJSON());
+	});
+	return editor.markdown.serialize({
+		type: "doc",
+		content
+	});
+}
+//#endregion
+export { DERIVATION_KEY, assetRefOf, bodyMarkdown, derivationOf, derivationState, renditionsOf, sourceOf };
+
+//# sourceMappingURL=derivation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"derivation.js","names":[],"sources":["../../../src/features/composites/derivation.ts"],"sourcesContent":["// Vue-free and server-importable: where a Baustein's content comes from. A source-holding Baustein (`recording`, `paper`,\n// `book`, `figure`, `document`) carries its original as an `image|audio|video|file` block in the body; a derived\n// Baustein (transcript, full text, description, AI result) records in `meta.derivation` what it was made from.\nimport type { Editor, JSONContent } from '@tiptap/core'\n// Types only: brings in the `editor.markdown` augmentation of `@tiptap/markdown` for contexts that do not otherwise load it.\nimport type {} from '@tiptap/markdown'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { EDITOR_API } from '../../core/api-routes'\nimport { type CompositeKind, compositeKind } from './kinds'\nimport { COMPOSITE_CHROME_COUNT } from './nodes'\nimport { DERIVATION_KEY } from './meta-keys'\n\n/** How a derived Baustein was made; `ai:<kindId>` for a block derived from another block by the model. */\nexport type DerivationMethod = 'transcription' | 'pdf-text' | 'ocr' | 'description' | 'bibliography' | (string & {})\n\n/** What a derived Baustein was made from: an uploaded asset (by asset name) or another block (by block id). */\nexport type DerivationSource = { asset: string } | { block: string }\n\n/** `meta.derivation` of a derived Baustein. */\nexport interface Derivation {\n  from: DerivationSource\n  method: DerivationMethod\n  model?: string\n  /** ISO timestamp. */\n  createdAt: string\n  /** SHA-256 hex of the asset bytes / of the source block's Markdown; `''` when unknown. */\n  inputHash: string\n  /** SHA-256 hex of the produced body's Markdown; `''` when unknown. */\n  outputHash: string\n  /** Asset name of the stored raw output (text/markdown). */\n  output?: string\n}\n\nexport { DERIVATION_KEY }\n\n/** The derivation of a composite (`meta.derivation` with a `from` object and a `method`); null when it has none. */\nexport function derivationOf(node: PMNode): Derivation | null {\n  const meta: unknown = node.attrs.meta\n  const value = meta && typeof meta === 'object' ? (meta as Record<string, unknown>)[DERIVATION_KEY] : undefined\n  if (!value || typeof value !== 'object') return null\n  const { from, method } = value as Record<string, unknown>\n  if (!from || typeof from !== 'object' || typeof method !== 'string') return null\n  return value as Derivation\n}\n\nconst ASSET_URL_PREFIX = `${EDITOR_API}/assets/`\n// Same patterns as `features/media/assets.ts`; copied because composites must not import media.\nconst ASSET_NAME = /^[0-9a-f-]{36}\\.[a-z0-9]{1,8}$/\nconst ASSET_DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/\n\n/** The stored asset behind an `/api/editor/assets/<documentId>/<name>` URL; null for any other `src`. */\nexport function assetRefOf(src: string): { documentId: string, name: string } | null {\n  if (!src.startsWith(ASSET_URL_PREFIX)) return null\n  const [documentId, name, ...rest] = src.slice(ASSET_URL_PREFIX.length).split('/')\n  if (rest.length || !documentId || !name || !ASSET_DOCUMENT_ID.test(documentId) || !ASSET_NAME.test(name)) return null\n  return { documentId, name }\n}\n\n/** The media block a source-holding kind keeps its original in: first body child of a type in `kind.source`. */\nexport function sourceOf(\n  composite: PMNode,\n  kinds: readonly CompositeKind[],\n): { node: PMNode, index: number, asset: { documentId: string, name: string } | null, hash: string | null } | null {\n  if (composite.type.name !== 'composite') return null\n  const types = compositeKind(kinds, String(composite.attrs.kind)).source\n  if (!types) return null\n  for (let index = COMPOSITE_CHROME_COUNT; index < composite.childCount; index++) {\n    const node = composite.child(index)\n    if (!(types as readonly string[]).includes(node.type.name)) continue\n    const hash: unknown = node.attrs.hash\n    return { node, index, asset: assetRefOf(String(node.attrs.src ?? '')), hash: typeof hash === 'string' && hash ? hash : null }\n  }\n  return null\n}\n\n/** The body children of `composite` that are derived Bausteine, with their child index. */\nexport function renditionsOf(composite: PMNode): { node: PMNode, index: number, derivation: Derivation }[] {\n  const found: { node: PMNode, index: number, derivation: Derivation }[] = []\n  composite.forEach((node, _offset, index) => {\n    if (index < COMPOSITE_CHROME_COUNT || node.type.name !== 'composite') return\n    const derivation = derivationOf(node)\n    if (derivation) found.push({ node, index, derivation })\n  })\n  return found\n}\n\n/**\n * Whether `derived` (a Baustein with a derivation, a child of `composite`) is out of date or was edited since it was made.\n * `stale`: for an asset source, the block `sourceOf(composite, kinds)` finds has a `hash` that differs from `inputHash`; null\n * when either is unknown. A block source is null here: callers with the document compare the hash of the source block's\n * Markdown. `edited`: the body's\n * hash (computed lazily, it serialises the whole body) differs from `outputHash`; null when `outputHash` is unknown.\n */\nexport function derivationState(\n  composite: PMNode,\n  derived: PMNode,\n  bodyHash: () => string,\n  kinds: readonly CompositeKind[],\n): { stale: boolean | null, edited: boolean | null } {\n  const derivation = derivationOf(derived)\n  if (!derivation) return { stale: null, edited: null }\n  let stale: boolean | null = null\n  if ('asset' in derivation.from) {\n    const hash = sourceOf(composite, kinds)?.hash\n    stale = hash && derivation.inputHash ? hash !== derivation.inputHash : null\n  }\n  const edited = derivation.outputHash ? bodyHash() !== derivation.outputHash : null\n  return { stale, edited }\n}\n\n/** Markdown of the body of `composite` (everything after title, description and tags). */\nexport function bodyMarkdown(editor: Editor, composite: PMNode): string {\n  const content: JSONContent[] = []\n  composite.forEach((child, _offset, index) => {\n    if (index >= COMPOSITE_CHROME_COUNT) content.push(child.toJSON() as JSONContent)\n  })\n  return editor.markdown!.serialize({ type: 'doc', content })\n}\n"],"mappings":";;;;;;AAoCA,SAAgB,aAAa,MAAiC;CAC5D,MAAM,OAAgB,KAAK,MAAM;CACjC,MAAM,QAAQ,QAAQ,OAAO,SAAS,WAAY,KAAiC,kBAAkB,KAAA;CACrG,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU,OAAO;CAChD,MAAM,EAAE,MAAM,WAAW;CACzB,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,OAAO,WAAW,UAAU,OAAO;CAC5E,OAAO;AACT;AAEA,MAAM,mBAAmB,GAAG,WAAW;AAEvC,MAAM,aAAa;AACnB,MAAM,oBAAoB;;AAG1B,SAAgB,WAAW,KAA0D;CACnF,IAAI,CAAC,IAAI,WAAW,gBAAgB,GAAG,OAAO;CAC9C,MAAM,CAAC,YAAY,MAAM,GAAG,QAAQ,IAAI,MAAM,iBAAiB,MAAM,CAAC,CAAC,MAAM,GAAG;CAChF,IAAI,KAAK,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,kBAAkB,KAAK,UAAU,KAAK,CAAC,WAAW,KAAK,IAAI,GAAG,OAAO;CACjH,OAAO;EAAE;EAAY;CAAK;AAC5B;;AAGA,SAAgB,SACd,WACA,OACiH;CACjH,IAAI,UAAU,KAAK,SAAS,aAAa,OAAO;CAChD,MAAM,QAAQ,cAAc,OAAO,OAAO,UAAU,MAAM,IAAI,CAAC,CAAC,CAAC;CACjE,IAAI,CAAC,OAAO,OAAO;CACnB,KAAK,IAAI,QAAA,GAAgC,QAAQ,UAAU,YAAY,SAAS;EAC9E,MAAM,OAAO,UAAU,MAAM,KAAK;EAClC,IAAI,CAAE,MAA4B,SAAS,KAAK,KAAK,IAAI,GAAG;EAC5D,MAAM,OAAgB,KAAK,MAAM;EACjC,OAAO;GAAE;GAAM;GAAO,OAAO,WAAW,OAAO,KAAK,MAAM,OAAO,EAAE,CAAC;GAAG,MAAM,OAAO,SAAS,YAAY,OAAO,OAAO;EAAK;CAC9H;CACA,OAAO;AACT;;AAGA,SAAgB,aAAa,WAA8E;CACzG,MAAM,QAAmE,CAAC;CAC1E,UAAU,SAAS,MAAM,SAAS,UAAU;EAC1C,IAAI,QAAA,KAAkC,KAAK,KAAK,SAAS,aAAa;EACtE,MAAM,aAAa,aAAa,IAAI;EACpC,IAAI,YAAY,MAAM,KAAK;GAAE;GAAM;GAAO;EAAW,CAAC;CACxD,CAAC;CACD,OAAO;AACT;;;;;;;;AASA,SAAgB,gBACd,WACA,SACA,UACA,OACmD;CACnD,MAAM,aAAa,aAAa,OAAO;CACvC,IAAI,CAAC,YAAY,OAAO;EAAE,OAAO;EAAM,QAAQ;CAAK;CACpD,IAAI,QAAwB;CAC5B,IAAI,WAAW,WAAW,MAAM;EAC9B,MAAM,OAAO,SAAS,WAAW,KAAK,CAAC,EAAE;EACzC,QAAQ,QAAQ,WAAW,YAAY,SAAS,WAAW,YAAY;CACzE;CACA,MAAM,SAAS,WAAW,aAAa,SAAS,MAAM,WAAW,aAAa;CAC9E,OAAO;EAAE;EAAO;CAAO;AACzB;;AAGA,SAAgB,aAAa,QAAgB,WAA2B;CACtE,MAAM,UAAyB,CAAC;CAChC,UAAU,SAAS,OAAO,SAAS,UAAU;EAC3C,IAAI,SAAA,GAAiC,QAAQ,KAAK,MAAM,OAAO,CAAgB;CACjF,CAAC;CACD,OAAO,OAAO,SAAU,UAAU;EAAE,MAAM;EAAO;CAAQ,CAAC;AAC5D"}

package/dist/features/composites/derived-chrome.js

@@ -0,0 +1,69 @@
+import { findBlockById } from "../../core/schema/block-ids.js";
+import { EDITOR_API } from "../../core/api-routes.js";
+import { sha256Hex } from "../../core/hash.js";
+import { bodyMarkdown, derivationOf, derivationState, sourceOf } from "./derivation.js";
+import { compositeKindsOf } from "./nodes.js";
+import { compositeOfRow } from "./rows.js";
+//#region src/features/composites/derived-chrome.ts
+/**
+* The chrome state of the row's Baustein when it is derived (null when it is not): `stale` when its asset source has
+* changed since it was made, i.e. the enclosing Baustein's source block hash differs from the stored `inputHash`.
+* Cheap on purpose (no body hashing): the chrome runs it for every row on every refresh. „bearbeitet“ and the staleness
+* of a block-derived Baustein hash Markdown, so only the details card computes them (`derivationDetailsOf`).
+*/
+function derivedChromeOf(editor, row) {
+	const { doc } = editor.state;
+	const at = doc.nodeAt(row.pos);
+	const found = at?.type.name === "composite" && (at.attrs.id ?? null) === row.id ? {
+		pos: row.pos,
+		node: at
+	} : compositeOfRow(doc, row);
+	if (!found || !derivationOf(found.node)) return null;
+	const parent = doc.resolve(found.pos).parent;
+	return { stale: parent.type.name === "composite" && derivationState(parent, found.node, () => "", compositeKindsOf(editor)).stale === true };
+}
+/**
+* Details of the derived Baustein `node` of `editor`'s document (null when it is not derived). Serialises and hashes
+* the body (and for a block source the source block), so call it for one Baustein at a time, not for every row.
+*/
+function derivationDetailsOf(editor, node) {
+	const derivation = derivationOf(node);
+	if (!derivation) return null;
+	const { doc } = editor.state;
+	const kinds = compositeKindsOf(editor);
+	const id = node.attrs.id;
+	const found = typeof id === "string" && id ? findBlockById(doc, id) : null;
+	const parent = found ? doc.resolve(found.pos).parent : null;
+	const holder = parent?.type.name === "composite" ? parent : null;
+	let bodyHash;
+	const state = derivationState(holder ?? node, node, () => bodyHash ??= sha256Hex(bodyMarkdown(editor, node)), kinds);
+	let stale = state.stale;
+	if ("block" in derivation.from) {
+		const source = findBlockById(doc, derivation.from.block);
+		stale = source && derivation.inputHash ? sha256Hex(bodyMarkdown(editor, source.node)) !== derivation.inputHash : null;
+	}
+	const documentId = holder ? sourceOf(holder, kinds)?.asset?.documentId : void 0;
+	const outputUrl = derivation.output && documentId ? `${EDITOR_API}/assets/${documentId}/${derivation.output}` : null;
+	return {
+		derivation,
+		stale,
+		edited: state.edited,
+		outputUrl
+	};
+}
+const KNOWN_METHODS = [
+	"transcription",
+	"pdf-text",
+	"ocr",
+	"description",
+	"bibliography"
+];
+/** The words for a derivation method: the known ones translated, `ai:<kind>` as „KI-Ableitung“, anything else as stored. */
+function derivationMethodLabel(t, method) {
+	if (method.startsWith("ai:")) return t("composites.derivation.method.ai");
+	return KNOWN_METHODS.includes(method) ? t(`composites.derivation.method.${method}`) : method;
+}
+//#endregion
+export { derivationDetailsOf, derivationMethodLabel, derivedChromeOf };
+
+//# sourceMappingURL=derived-chrome.js.map

package/dist/features/composites/derived-chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-chrome.js","names":[],"sources":["../../../src/features/composites/derived-chrome.ts"],"sourcesContent":["// Vue-free: what the composite chrome and the details card show for a derived Baustein (one with a `meta.derivation`).\nimport type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { EDITOR_API } from '../../core/api-routes'\nimport { sha256Hex } from '../../core/hash'\nimport { findBlockById } from '../../core/schema/block-ids'\nimport type { MessageKey, Translate } from '../../i18n'\nimport { type Derivation, bodyMarkdown, derivationOf, derivationState, sourceOf } from './derivation'\nimport { compositeKindsOf } from './nodes'\nimport { type CompositeRow, compositeOfRow } from './rows'\n\n/**\n * The chrome state of the row's Baustein when it is derived (null when it is not): `stale` when its asset source has\n * changed since it was made, i.e. the enclosing Baustein's source block hash differs from the stored `inputHash`.\n * Cheap on purpose (no body hashing): the chrome runs it for every row on every refresh. „bearbeitet“ and the staleness\n * of a block-derived Baustein hash Markdown, so only the details card computes them (`derivationDetailsOf`).\n */\nexport function derivedChromeOf(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>): { stale: boolean } | null {\n  const { doc } = editor.state\n  // The row's position may be stale for a moment after an edit; take it only when it still holds the same Baustein.\n  const at = doc.nodeAt(row.pos)\n  const found = at?.type.name === 'composite' && (at.attrs.id ?? null) === row.id ? { pos: row.pos, node: at } : compositeOfRow(doc, row)\n  if (!found || !derivationOf(found.node)) return null\n  const parent = doc.resolve(found.pos).parent\n  const stale = parent.type.name === 'composite' && derivationState(parent, found.node, () => '', compositeKindsOf(editor)).stale === true\n  return { stale }\n}\n\n/** Everything the details card shows about the derivation of `node`; `stale`/`edited` are null when they cannot be told. */\nexport interface DerivationDetails {\n  derivation: Derivation\n  /** The source changed since `node` was made: asset hash for an asset source, Markdown hash of the source block for a block source. */\n  stale: boolean | null\n  /** The body differs from what was generated. */\n  edited: boolean | null\n  /** URL of the stored raw output, when there is one and its document is known. */\n  outputUrl: string | null\n}\n\n/**\n * Details of the derived Baustein `node` of `editor`'s document (null when it is not derived). Serialises and hashes\n * the body (and for a block source the source block), so call it for one Baustein at a time, not for every row.\n */\nexport function derivationDetailsOf(editor: Editor, node: PMNode): DerivationDetails | null {\n  const derivation = derivationOf(node)\n  if (!derivation) return null\n  const { doc } = editor.state\n  const kinds = compositeKindsOf(editor)\n  const id: unknown = node.attrs.id\n  const found = typeof id === 'string' && id ? findBlockById(doc, id) : null\n  const parent = found ? doc.resolve(found.pos).parent : null\n  const holder = parent?.type.name === 'composite' ? parent : null\n\n  let bodyHash: string | undefined\n  const state = derivationState(holder ?? node, node, () => (bodyHash ??= sha256Hex(bodyMarkdown(editor, node))), kinds)\n  let stale = state.stale\n  if ('block' in derivation.from) {\n    const source = findBlockById(doc, derivation.from.block)\n    stale = source && derivation.inputHash ? sha256Hex(bodyMarkdown(editor, source.node)) !== derivation.inputHash : null\n  }\n\n  const documentId = holder ? sourceOf(holder, kinds)?.asset?.documentId : undefined\n  const outputUrl = derivation.output && documentId ? `${EDITOR_API}/assets/${documentId}/${derivation.output}` : null\n  return { derivation, stale, edited: state.edited, outputUrl }\n}\n\nconst KNOWN_METHODS: readonly string[] = ['transcription', 'pdf-text', 'ocr', 'description', 'bibliography']\n\n/** The words for a derivation method: the known ones translated, `ai:<kind>` as „KI-Ableitung“, anything else as stored. */\nexport function derivationMethodLabel(t: Translate, method: string): string {\n  if (method.startsWith('ai:')) return t('composites.derivation.method.ai')\n  return KNOWN_METHODS.includes(method) ? t(`composites.derivation.method.${method}` as MessageKey) : method\n}\n"],"mappings":";;;;;;;;;;;;;AAiBA,SAAgB,gBAAgB,QAAgB,KAAkE;CAChH,MAAM,EAAE,QAAQ,OAAO;CAEvB,MAAM,KAAK,IAAI,OAAO,IAAI,GAAG;CAC7B,MAAM,QAAQ,IAAI,KAAK,SAAS,gBAAgB,GAAG,MAAM,MAAM,UAAU,IAAI,KAAK;EAAE,KAAK,IAAI;EAAK,MAAM;CAAG,IAAI,eAAe,KAAK,GAAG;CACtI,IAAI,CAAC,SAAS,CAAC,aAAa,MAAM,IAAI,GAAG,OAAO;CAChD,MAAM,SAAS,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC;CAEtC,OAAO,EAAE,OADK,OAAO,KAAK,SAAS,eAAe,gBAAgB,QAAQ,MAAM,YAAY,IAAI,iBAAiB,MAAM,CAAC,CAAC,CAAC,UAAU,KACrH;AACjB;;;;;AAiBA,SAAgB,oBAAoB,QAAgB,MAAwC;CAC1F,MAAM,aAAa,aAAa,IAAI;CACpC,IAAI,CAAC,YAAY,OAAO;CACxB,MAAM,EAAE,QAAQ,OAAO;CACvB,MAAM,QAAQ,iBAAiB,MAAM;CACrC,MAAM,KAAc,KAAK,MAAM;CAC/B,MAAM,QAAQ,OAAO,OAAO,YAAY,KAAK,cAAc,KAAK,EAAE,IAAI;CACtE,MAAM,SAAS,QAAQ,IAAI,QAAQ,MAAM,GAAG,CAAC,CAAC,SAAS;CACvD,MAAM,SAAS,QAAQ,KAAK,SAAS,cAAc,SAAS;CAE5D,IAAI;CACJ,MAAM,QAAQ,gBAAgB,UAAU,MAAM,YAAa,aAAa,UAAU,aAAa,QAAQ,IAAI,CAAC,GAAI,KAAK;CACrH,IAAI,QAAQ,MAAM;CAClB,IAAI,WAAW,WAAW,MAAM;EAC9B,MAAM,SAAS,cAAc,KAAK,WAAW,KAAK,KAAK;EACvD,QAAQ,UAAU,WAAW,YAAY,UAAU,aAAa,QAAQ,OAAO,IAAI,CAAC,MAAM,WAAW,YAAY;CACnH;CAEA,MAAM,aAAa,SAAS,SAAS,QAAQ,KAAK,CAAC,EAAE,OAAO,aAAa,KAAA;CACzE,MAAM,YAAY,WAAW,UAAU,aAAa,GAAG,WAAW,UAAU,WAAW,GAAG,WAAW,WAAW;CAChH,OAAO;EAAE;EAAY;EAAO,QAAQ,MAAM;EAAQ;CAAU;AAC9D;AAEA,MAAM,gBAAmC;CAAC;CAAiB;CAAY;CAAO;CAAe;AAAc;;AAG3G,SAAgB,sBAAsB,GAAc,QAAwB;CAC1E,IAAI,OAAO,WAAW,KAAK,GAAG,OAAO,EAAE,iCAAiC;CACxE,OAAO,cAAc,SAAS,MAAM,IAAI,EAAE,gCAAgC,QAAsB,IAAI;AACtG"}