@ecsplico/editor 2.1.2 → 3.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"rows.js","names":[],"sources":["../../../src/features/composites/rows.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { blockIdOf, findBlockById } from '../../core/schema'\nimport { type CompositeKind, type CompositeMetaField, compositeKind } from './kinds'\n\n/** One composite („Baustein“) of a document with its metadata, flattened in document order. */\nexport interface CompositeRow {\n  /** Block ID, or `pos:<pos>` for a composite without one yet; unique within the document. */\n  key: string\n  id: string | null\n  /** Position of the composite when the row was read; the write helpers re-resolve it, so a stale value is safe. */\n  pos: number\n  /** Position right after the composite, as of when the row was read. */\n  end: number\n  kind: string\n  kindLabel: string\n  icon: string\n  /** Title text, empty for an untitled composite. */\n  title: string\n  /** Text of the description (summary), empty when there is none. */\n  description: string\n  /**\n   * The description holds text only (marks such as bold, author or comment allowed, no mentions or tags); only then\n   * can `setCompositeDescription` write it without losing inline content.\n   */\n  descriptionTextOnly: boolean\n  tags: string[]\n  meta: Record<string, unknown>\n  /** The meta fields of the composite's kind. */\n  fields: readonly CompositeMetaField[]\n  /** Nesting level among composites, 0 = outermost. */\n  depth: number\n}\n\n/** A distinct `@mention` chip of a document. */\nexport interface CompositeMention {\n  id: string\n  label: string\n  color: string | null\n}\n\nconst COMPOSITE = 'composite'\n\n/** True when `node`'s content is empty or text only (with any marks, but no inline nodes such as mentions or tags). */\nfunction isTextOnly(node: PMNode): boolean {\n  let textOnly = true\n  node.forEach((child) => {\n    if (!child.isText) textOnly = false\n  })\n  return textOnly\n}\n\n/**\n * Reads every composite of `doc` (also inside quotes and lists) as a row, in document order, and the distinct\n * `@mention` chips anywhere in the document. Unknown kinds get the `section` kind's presentation under their own ID.\n */\nexport function compositeRows(doc: PMNode, kinds: readonly CompositeKind[]): { rows: CompositeRow[], mentions: CompositeMention[] } {\n  const rows: CompositeRow[] = []\n  const mentions = new Map<string, CompositeMention>()\n\n  function walk(parent: PMNode, start: number, depth: number) {\n    parent.forEach((node, offset) => {\n      const pos = start + offset\n      if (node.type.name === COMPOSITE) {\n        const kind = compositeKind(kinds, String(node.attrs.kind))\n        const id = blockIdOf(node)\n        const tags: unknown = node.maybeChild(2)?.attrs.tags\n        const description = node.maybeChild(1)\n        rows.push({\n          key: id ?? `pos:${pos}`,\n          id,\n          pos,\n          end: pos + node.nodeSize,\n          kind: kind.id,\n          kindLabel: kind.label,\n          icon: kind.icon,\n          title: node.firstChild?.textContent.trim() ?? '',\n          description: description?.textContent ?? '',\n          descriptionTextOnly: description ? isTextOnly(description) : true,\n          tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [],\n          meta: (node.attrs.meta ?? {}) as Record<string, unknown>,\n          fields: kind.fields,\n          depth,\n        })\n        walk(node, pos + 1, depth + 1)\n      }\n      else if (node.type.name === 'mention') {\n        const mentionId = String(node.attrs.id ?? '')\n        if (mentionId && !mentions.has(mentionId)) {\n          mentions.set(mentionId, {\n            id: mentionId,\n            label: String(node.attrs.label ?? mentionId),\n            color: typeof node.attrs.color === 'string' ? node.attrs.color : null,\n          })\n        }\n      }\n      else if (!node.isLeaf) {\n        walk(node, pos + 1, depth)\n      }\n    })\n  }\n  walk(doc, 0, 0)\n  return { rows, mentions: [...mentions.values()] }\n}\n\n/** The innermost row around document position `pos`, `null` outside of any composite. */\nexport function compositeRowAt(rows: readonly CompositeRow[], pos: number): CompositeRow | null {\n  let found: CompositeRow | null = null\n  // Pre-order: the last match is the innermost composite.\n  for (const row of rows) {\n    if (row.pos <= pos && pos < row.end) found = row\n  }\n  return found\n}\n\n/**\n * The composite `row` stands for in `doc`: by block ID, else (the row has no ID yet) by its position.\n * Positions are re-resolved on every call, so a stale `row.pos` is safe for rows with an ID.\n */\nexport function compositeOfRow(doc: PMNode, row: Pick<CompositeRow, 'id' | 'pos'>): { pos: number, node: PMNode } | null {\n  if (row.id) {\n    const found = findBlockById(doc, row.id)\n    return found?.node.type.name === COMPOSITE ? found : null\n  }\n  const node = doc.nodeAt(row.pos)\n  return node?.type.name === COMPOSITE ? { pos: row.pos, node } : null\n}\n\n/**\n * `meta` with `value` stored under `field.key`: a number field converts a numeric string, an empty value (`''`,\n * `null`, `undefined`, `NaN`) removes the key. Returns a new object; `meta` is not changed.\n */\nexport function compositeMetaWith(meta: Record<string, unknown>, field: Pick<CompositeMetaField, 'key' | 'type'>, value: unknown): Record<string, unknown> {\n  const next = { ...meta }\n  const stored = field.type === 'number' && typeof value === 'string' && value !== '' ? Number(value) : value\n  if (stored === '' || stored === null || stored === undefined || Number.isNaN(stored)) delete next[field.key]\n  else next[field.key] = stored\n  return next\n}\n\n/** Stores `value` under the meta field `key` of the row's composite (see `compositeMetaWith`), in one transaction. */\nexport function setCompositeMetaField(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos' | 'fields'>, key: string, value: unknown): boolean {\n  const field = row.fields.find(candidate => candidate.key === key) ?? { key, type: 'text' as const }\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    if (!found) return false\n    tr.setNodeMarkup(found.pos, undefined, { ...found.node.attrs, meta: compositeMetaWith(found.node.attrs.meta ?? {}, field, value) })\n    return true\n  })\n}\n\n/** Replaces the tags row of the row's composite (empty names are dropped), in one transaction. */\nexport function setCompositeTags(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, tags: readonly string[]): boolean {\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    const title = found?.node.maybeChild(0)\n    const description = found?.node.maybeChild(1)\n    const tagsNode = found?.node.maybeChild(2)\n    if (!found || !title || !description || tagsNode?.type.name !== 'compositeTags') return false\n    const tagsPos = found.pos + 1 + title.nodeSize + description.nodeSize\n    tr.setNodeMarkup(tagsPos, undefined, { ...tagsNode.attrs, tags: tags.filter(tag => tag) })\n    return true\n  })\n}\n\n/** The text `setCompositeDescription` stores for `text`: the description is one line, so line breaks collapse to spaces. */\nexport function compositeDescriptionText(text: string): string {\n  return text.replace(/\\s*\\n\\s*/g, ' ').trim()\n}\n\n/**\n * Sets the text of the row's composite description to `compositeDescriptionText(text)`; an empty text empties it.\n * Only the changed span is replaced, so marks on the unchanged text (bold, author, comment) stay. Refuses (`false`)\n * when the description holds a mention or tag (it would be lost), and, when `expected` is given, when the\n * description no longer holds that text (a peer changed it since the caller read it; writing would drop that change).\n */\nexport function setCompositeDescription(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, text: string, expected?: string): boolean {\n  const value = compositeDescriptionText(text)\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    const title = found?.node.maybeChild(0)\n    const description = found?.node.maybeChild(1)\n    if (!found || !title || !description || description.type.name !== 'compositeDescription') return false\n    if (!isTextOnly(description)) return false\n    const current = description.textContent\n    if (expected !== undefined && current !== expected) return false\n    if (current === value) return true\n    // Text only: every character is one position. Keep the common prefix and suffix, replace what lies between.\n    let prefix = 0\n    const max = Math.min(current.length, value.length)\n    while (prefix < max && current[prefix] === value[prefix]) prefix++\n    let suffix = 0\n    while (suffix < max - prefix && current[current.length - 1 - suffix] === value[value.length - 1 - suffix]) suffix++\n    const start = found.pos + 1 + title.nodeSize + 1\n    // `insertText` with an empty text deletes the range; inserted text takes the marks at its start, as typing does.\n    tr.insertText(value.slice(prefix, value.length - suffix), start + prefix, start + current.length - suffix)\n    return true\n  })\n}\n"],"mappings":"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"}
+{"version":3,"file":"rows.js","names":[],"sources":["../../../src/features/composites/rows.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { blockIdOf, findBlockById } from '../../core/schema'\nimport { type CompositeKind, type CompositeMetaField, compositeKind } from './kinds'\nimport { referenceLabel, referenceTarget } from './reference-label'\n\n/** One composite („Baustein“) of a document with its metadata, flattened in document order. */\nexport interface CompositeRow {\n  /** Block ID, or `pos:<pos>` for a composite without one yet; unique within the document. */\n  key: string\n  id: string | null\n  /** Position of the composite when the row was read; the write helpers re-resolve it, so a stale value is safe. */\n  pos: number\n  /** Position right after the composite, as of when the row was read. */\n  end: number\n  kind: string\n  kindLabel: string\n  icon: string\n  /** Title text, empty for an untitled composite. */\n  title: string\n  /** Text of the description (summary), empty when there is none. */\n  description: string\n  /**\n   * The description holds text only (marks such as bold, author or comment allowed, no mentions or tags); only then\n   * can `setCompositeDescription` write it without losing inline content.\n   */\n  descriptionTextOnly: boolean\n  tags: string[]\n  meta: Record<string, unknown>\n  /** The meta fields of the composite's kind. */\n  fields: readonly CompositeMetaField[]\n  /** Nesting level among composites, 0 = outermost. */\n  depth: number\n}\n\n/** A distinct `@mention` chip of a document. */\nexport interface CompositeMention {\n  id: string\n  label: string\n  color: string | null\n}\n\n/** A reference to a Baustein: a `reference` chip in the text of block `from`, or a `reference` field of the Baustein `from`. */\nexport interface CompositeReference {\n  /** Block ID of the referenced Baustein. */\n  target: string\n  /** Block ID of the nearest block around the chip (the Baustein itself for a field); `null` when that block has no ID yet. */\n  from: string | null\n  /** The chip's locator (`S. 12`, `03:14`); `null` for a field or a chip without one. */\n  locator: string | null\n}\n\nconst COMPOSITE = 'composite'\n\n/** True when `node`'s content is empty or text only (with any marks, but no inline nodes such as mentions or tags). */\nfunction isTextOnly(node: PMNode): boolean {\n  let textOnly = true\n  node.forEach((child) => {\n    if (!child.isText) textOnly = false\n  })\n  return textOnly\n}\n\n/**\n * Reads every composite of `doc` (also inside quotes and lists) as a row, in document order, the distinct\n * `@mention` chips anywhere in the document and every reference (`reference` chips and `reference` fields) in document\n * order. Unknown kinds get the `section` kind's presentation under their own ID.\n */\nexport function compositeRows(doc: PMNode, kinds: readonly CompositeKind[]): { rows: CompositeRow[], mentions: CompositeMention[], references: CompositeReference[] } {\n  const rows: CompositeRow[] = []\n  const mentions = new Map<string, CompositeMention>()\n  const references: CompositeReference[] = []\n\n  function walk(parent: PMNode, start: number, depth: number, block: string | null) {\n    parent.forEach((node, offset) => {\n      const pos = start + offset\n      if (node.type.name === COMPOSITE) {\n        const kind = compositeKind(kinds, String(node.attrs.kind))\n        const id = blockIdOf(node)\n        const tags: unknown = node.maybeChild(2)?.attrs.tags\n        const description = node.maybeChild(1)\n        const row: CompositeRow = {\n          key: id ?? `pos:${pos}`,\n          id,\n          pos,\n          end: pos + node.nodeSize,\n          kind: kind.id,\n          kindLabel: kind.label,\n          icon: kind.icon,\n          title: node.firstChild?.textContent.trim() ?? '',\n          description: description?.textContent ?? '',\n          descriptionTextOnly: description ? isTextOnly(description) : true,\n          tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [],\n          meta: (node.attrs.meta ?? {}) as Record<string, unknown>,\n          fields: kind.fields,\n          depth,\n        }\n        rows.push(row)\n        for (const field of kind.fields) {\n          const value = field.type === 'reference' ? row.meta[field.key] : undefined\n          if (typeof value === 'string' && value) references.push({ target: value, from: id, locator: null })\n        }\n        walk(node, pos + 1, depth + 1, id ?? block)\n      }\n      else if (node.type.name === 'reference') {\n        const target = String(node.attrs.target ?? '')\n        if (target) references.push({ target, from: block, locator: typeof node.attrs.locator === 'string' && node.attrs.locator ? node.attrs.locator : null })\n      }\n      else if (node.type.name === 'mention') {\n        const mentionId = String(node.attrs.id ?? '')\n        if (mentionId && !mentions.has(mentionId)) {\n          mentions.set(mentionId, {\n            id: mentionId,\n            label: String(node.attrs.label ?? mentionId),\n            color: typeof node.attrs.color === 'string' ? node.attrs.color : null,\n          })\n        }\n      }\n      else if (!node.isLeaf) {\n        walk(node, pos + 1, depth, blockIdOf(node) ?? block)\n      }\n    })\n  }\n  walk(doc, 0, 0, null)\n  return { rows, mentions: [...mentions.values()], references }\n}\n\n/** A place that refers to a Baustein: the block holding the chip (or the Baustein with the field) and a short text of it. */\nexport interface CompositeBacklink {\n  from: string\n  locator: string | null\n  excerpt: string\n}\n\nconst EXCERPT_LENGTH = 40\n\n/** The text of `node` as read on screen: inline atoms count as their label (`@name`, `#tag`, a reference chip's short citation + locator), not as nothing. */\nfunction visibleText(doc: PMNode, kinds: readonly CompositeKind[], node: PMNode): string {\n  return node.textBetween(0, node.content.size, ' ', (leaf) => {\n    const attrs = leaf.attrs\n    switch (leaf.type.name) {\n      case 'mention': return `@${String(attrs.label ?? attrs.id ?? '')}`\n      case 'tag': return `#${String(attrs.name ?? '')}`\n      case 'reference': {\n        const target = findBlockById(doc, String(attrs.target ?? ''))\n        const label = target?.node.type.name === COMPOSITE ? referenceLabel(referenceTarget(target.node, kinds)) : String(attrs.label ?? '')\n        return typeof attrs.locator === 'string' && attrs.locator ? `${label}, ${attrs.locator}` : label\n      }\n      default: return ''\n    }\n  })\n}\n\n/** Every reference to the Baustein `target` in document order; references whose enclosing block has no ID (or is gone) are left out, as nothing could reveal them. */\nexport function compositeBacklinks(doc: PMNode, kinds: readonly CompositeKind[], target: string): CompositeBacklink[] {\n  const links: CompositeBacklink[] = []\n  for (const reference of compositeRows(doc, kinds).references) {\n    if (reference.target !== target || !reference.from) continue\n    const found = findBlockById(doc, reference.from)\n    if (!found) continue\n    const source = found.node.type.name === COMPOSITE ? found.node.firstChild : found.node\n    const text = source ? visibleText(doc, kinds, source).trim() : ''\n    links.push({ from: reference.from, locator: reference.locator, excerpt: text.length > EXCERPT_LENGTH ? `${text.slice(0, EXCERPT_LENGTH)}…` : text })\n  }\n  return links\n}\n\n/** The innermost row around document position `pos`, `null` outside of any composite. */\nexport function compositeRowAt(rows: readonly CompositeRow[], pos: number): CompositeRow | null {\n  let found: CompositeRow | null = null\n  // Pre-order: the last match is the innermost composite.\n  for (const row of rows) {\n    if (row.pos <= pos && pos < row.end) found = row\n  }\n  return found\n}\n\n/**\n * The composite `row` stands for in `doc`: by block ID, else (the row has no ID yet) by its position.\n * Positions are re-resolved on every call, so a stale `row.pos` is safe for rows with an ID.\n */\nexport function compositeOfRow(doc: PMNode, row: Pick<CompositeRow, 'id' | 'pos'>): { pos: number, node: PMNode } | null {\n  if (row.id) {\n    const found = findBlockById(doc, row.id)\n    return found?.node.type.name === COMPOSITE ? found : null\n  }\n  const node = doc.nodeAt(row.pos)\n  return node?.type.name === COMPOSITE ? { pos: row.pos, node } : null\n}\n\n/**\n * `meta` with `value` stored under `field.key`: a number field converts a numeric string, an empty value (`''`,\n * `null`, `undefined`, `NaN`) removes the key. Returns a new object; `meta` is not changed.\n */\nexport function compositeMetaWith(meta: Record<string, unknown>, field: Pick<CompositeMetaField, 'key' | 'type'>, value: unknown): Record<string, unknown> {\n  const next = { ...meta }\n  const stored = field.type === 'number' && typeof value === 'string' && value !== '' ? Number(value) : value\n  if (stored === '' || stored === null || stored === undefined || Number.isNaN(stored)) delete next[field.key]\n  else next[field.key] = stored\n  return next\n}\n\n/** Stores `value` under the meta field `key` of the row's composite (see `compositeMetaWith`), in one transaction. */\nexport function setCompositeMetaField(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos' | 'fields'>, key: string, value: unknown): boolean {\n  const field = row.fields.find(candidate => candidate.key === key) ?? { key, type: 'text' as const }\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    if (!found) return false\n    tr.setNodeMarkup(found.pos, undefined, { ...found.node.attrs, meta: compositeMetaWith(found.node.attrs.meta ?? {}, field, value) })\n    return true\n  })\n}\n\n/** Replaces the tags row of the row's composite (empty names are dropped), in one transaction. */\nexport function setCompositeTags(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, tags: readonly string[]): boolean {\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    const title = found?.node.maybeChild(0)\n    const description = found?.node.maybeChild(1)\n    const tagsNode = found?.node.maybeChild(2)\n    if (!found || !title || !description || tagsNode?.type.name !== 'compositeTags') return false\n    const tagsPos = found.pos + 1 + title.nodeSize + description.nodeSize\n    tr.setNodeMarkup(tagsPos, undefined, { ...tagsNode.attrs, tags: tags.filter(tag => tag) })\n    return true\n  })\n}\n\n/** The text `setCompositeDescription` stores for `text`: the description is one line, so line breaks collapse to spaces. */\nexport function compositeDescriptionText(text: string): string {\n  return text.replace(/\\s*\\n\\s*/g, ' ').trim()\n}\n\n/**\n * Sets the text of the row's composite description to `compositeDescriptionText(text)`; an empty text empties it.\n * Only the changed span is replaced, so marks on the unchanged text (bold, author, comment) stay. Refuses (`false`)\n * when the description holds a mention or tag (it would be lost), and, when `expected` is given, when the\n * description no longer holds that text (a peer changed it since the caller read it; writing would drop that change).\n */\nexport function setCompositeDescription(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, text: string, expected?: string): boolean {\n  const value = compositeDescriptionText(text)\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    const title = found?.node.maybeChild(0)\n    const description = found?.node.maybeChild(1)\n    if (!found || !title || !description || description.type.name !== 'compositeDescription') return false\n    if (!isTextOnly(description)) return false\n    const current = description.textContent\n    if (expected !== undefined && current !== expected) return false\n    if (current === value) return true\n    // Text only: every character is one position. Keep the common prefix and suffix, replace what lies between.\n    let prefix = 0\n    const max = Math.min(current.length, value.length)\n    while (prefix < max && current[prefix] === value[prefix]) prefix++\n    let suffix = 0\n    while (suffix < max - prefix && current[current.length - 1 - suffix] === value[value.length - 1 - suffix]) suffix++\n    const start = found.pos + 1 + title.nodeSize + 1\n    // `insertText` with an empty text deletes the range; inserted text takes the marks at its start, as typing does.\n    tr.insertText(value.slice(prefix, value.length - suffix), start + prefix, start + current.length - suffix)\n    return true\n  })\n}\n"],"mappings":"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"}

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

@@ -1,15 +1,21 @@
+import { CSL_TYPES, CslDate, CslItem, CslName, CslType } from "../../core/backend-types.js";
 import { CompositeAiBrief, compositeAiBrief } from "./ai-brief.js";
-import { CompositeKind, CompositeKindAi, CompositeMetaField, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
+import { CompositeKind, CompositeKindAi, CompositeMetaField, SOURCE_MEDIA_TYPES, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
 import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeOptions, CompositeStorage, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { REFERENCE_NODE, ReferenceAttrs, ReferenceNode, ReferenceOptions, ReferenceSuggestionPluginKey, referenceMarkdown } from "./reference.js";
 import { compositeConversions, convertCompositeBlocks } from "./convert.js";
 import { CompositeFence, FenceSegment, splitCompositeFences } from "../../core/fences.js";
 import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
 import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
+import { BIB_KEY, DERIVATION_KEY } from "./meta-keys.js";
+import { bibOf, bibtexOf, citeFull, citeShort, cslOf, cslTypeOptions, yearOf } from "./bibliography.js";
+import { Derivation, DerivationMethod, DerivationSource, bodyMarkdown, derivationOf, derivationState, renditionsOf, sourceOf } from "./derivation.js";
 import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+import { collectCompositeIds, compositeIdsOf, normalizeReferences, referencesFromText } from "./reference-text.js";
 import { AnyExtension } from "@tiptap/core";
 //#region src/features/composites/schema.d.ts
 /**
- * The schema-bearing composite family (composite, title, description, tags) without node views, to append to
+ * The schema-bearing composite family (composite, title, description, tags, and the inline `reference` chip) without node views, to append to
  * `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`
  * is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.
  */
@@ -17,5 +23,5 @@ export declare function compositeSchemaExtensions(options?: {
   kinds?: readonly CompositeKind[];
 }): AnyExtension[];
 //#endregion
-export { COMPOSITE_CHROME_COUNT, type CompositeAiBrief, CompositeDescriptionNode, type CompositeFence, type CompositeKind, type CompositeKindAi, type CompositeMetaField, CompositeNode, type CompositeOptions, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type FenceSegment, LEGACY_COMPOSITE_NODE, blocksFromMarkdown, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, convertCompositeBlocks, defaultCompositeKinds, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, kindAccepts, migrateLegacyContent, splitCompositeFences, structureBlocks };
+export { BIB_KEY, COMPOSITE_CHROME_COUNT, CSL_TYPES, type CompositeAiBrief, CompositeDescriptionNode, type CompositeFence, type CompositeKind, type CompositeKindAi, type CompositeMetaField, CompositeNode, type CompositeOptions, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type CslDate, type CslItem, type CslName, type CslType, DERIVATION_KEY, type Derivation, type DerivationMethod, type DerivationSource, type FenceSegment, LEGACY_COMPOSITE_NODE, REFERENCE_NODE, type ReferenceAttrs, ReferenceNode, type ReferenceOptions, ReferenceSuggestionPluginKey, SOURCE_MEDIA_TYPES, bibOf, bibtexOf, blocksFromMarkdown, bodyMarkdown, citeFull, citeShort, collectCompositeIds, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeFence, compositeFromMarkdown, compositeIdsOf, compositeJSON, compositeKind, compositeKindsOf, convertCompositeBlocks, cslOf, cslTypeOptions, defaultCompositeKinds, derivationOf, derivationState, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, kindAccepts, migrateLegacyContent, normalizeReferences, referenceMarkdown, referencesFromText, renditionsOf, sourceOf, splitCompositeFences, structureBlocks, yearOf };
 //# sourceMappingURL=schema.d.ts.map

package/dist/features/composites/schema.js

@@ -1,14 +1,20 @@
 import { splitCompositeFences } from "../../core/fences.js";
-import { compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
+import { SOURCE_MEDIA_TYPES, compositeKind, defaultCompositeKinds, kindAccepts } from "./kinds.js";
+import { BIB_KEY, DERIVATION_KEY } from "./meta-keys.js";
 import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
+import { bodyMarkdown, derivationOf, derivationState, renditionsOf, sourceOf } from "./derivation.js";
 import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
 import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { REFERENCE_NODE, ReferenceNode, ReferenceSuggestionPluginKey, referenceMarkdown } from "./reference.js";
+import { CSL_TYPES } from "../../core/backend-types.js";
+import { bibOf, bibtexOf, citeFull, citeShort, cslOf, cslTypeOptions, yearOf } from "./bibliography.js";
 import { compositeAiBrief } from "./ai-brief.js";
 import { compositeConversions, convertCompositeBlocks } from "./convert.js";
 import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+import { collectCompositeIds, compositeIdsOf, normalizeReferences, referencesFromText } from "./reference-text.js";
 //#region src/features/composites/schema.ts
 /**
-* The schema-bearing composite family (composite, title, description, tags) without node views, to append to
+* The schema-bearing composite family (composite, title, description, tags, and the inline `reference` chip) without node views, to append to
 * `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`
 * is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.
 */
@@ -17,10 +23,11 @@ function compositeSchemaExtensions(options = {}) {
 		CompositeNode.configure(options.kinds ? { kinds: options.kinds } : {}),
 		CompositeTitleNode,
 		CompositeDescriptionNode,
-		CompositeTagsNode
+		CompositeTagsNode,
+		ReferenceNode
 	];
 }
 //#endregion
-export { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, LEGACY_COMPOSITE_NODE, blocksFromMarkdown, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeSchemaExtensions, convertCompositeBlocks, defaultCompositeKinds, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, kindAccepts, migrateLegacyContent, splitCompositeFences, structureBlocks };
+export { BIB_KEY, COMPOSITE_CHROME_COUNT, CSL_TYPES, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, DERIVATION_KEY, LEGACY_COMPOSITE_NODE, REFERENCE_NODE, ReferenceNode, ReferenceSuggestionPluginKey, SOURCE_MEDIA_TYPES, bibOf, bibtexOf, blocksFromMarkdown, bodyMarkdown, citeFull, citeShort, collectCompositeIds, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeFence, compositeFromMarkdown, compositeIdsOf, compositeJSON, compositeKind, compositeKindsOf, compositeSchemaExtensions, convertCompositeBlocks, cslOf, cslTypeOptions, defaultCompositeKinds, derivationOf, derivationState, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, kindAccepts, migrateLegacyContent, normalizeReferences, referenceMarkdown, referencesFromText, renditionsOf, sourceOf, splitCompositeFences, structureBlocks, yearOf };
 
 //# sourceMappingURL=schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/composites/schema.ts"],"sourcesContent":["// Vue-free entry of the composite feature (`@ecsplico/editor/composites/schema`): the node family, kinds, Markdown\n// fences, legacy migration, heading↔composite transforms and conversions. Servers build their schema from it; it never\n// imports node views, components or the feature factory.\nimport type { AnyExtension } from '@tiptap/core'\nimport { type CompositeKind } from './kinds'\nimport { CompositeNode, CompositeDescriptionNode, CompositeTagsNode, CompositeTitleNode } from './nodes'\n\nexport { type CompositeAiBrief, compositeAiBrief } from './ai-brief'\nexport { compositeConversions, convertCompositeBlocks } from './convert'\nexport { blocksFromMarkdown, type CompositeFence, compositeFence, compositeFromMarkdown, type FenceSegment, splitCompositeFences } from './fences'\nexport { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from './heading-composites'\nexport { type CompositeKind, type CompositeKindAi, type CompositeMetaField, compositeKind, defaultCompositeKinds, kindAccepts } from './kinds'\nexport { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from './legacy'\nexport {\n  COMPOSITE_CHROME_COUNT,\n  compositeJSON,\n  compositeKindsOf,\n  CompositeDescriptionNode,\n  CompositeNode,\n  type CompositeOptions,\n  type CompositeStorage,\n  CompositeTagsNode,\n  CompositeTitleNode,\n} from './nodes'\n\n/**\n * The schema-bearing composite family (composite, title, description, tags) without node views, to append to\n * `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`\n * is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.\n */\nexport function compositeSchemaExtensions(options: { kinds?: readonly CompositeKind[] } = {}): AnyExtension[] {\n  return [CompositeNode.configure(options.kinds ? { kinds: options.kinds } : {}), CompositeTitleNode, CompositeDescriptionNode, CompositeTagsNode]\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,SAAgB,0BAA0B,UAAgD,CAAC,GAAmB;CAC5G,OAAO;EAAC,cAAc,UAAU,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC,CAAC;EAAG;EAAoB;EAA0B;CAAiB;AACjJ"}
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/composites/schema.ts"],"sourcesContent":["// Vue-free entry of the composite feature (`@ecsplico/editor/composites/schema`): the node family, kinds, Markdown\n// fences, legacy migration, heading↔composite transforms and conversions. Servers build their schema from it; it never\n// imports node views, components or the feature factory.\nimport type { AnyExtension } from '@tiptap/core'\nimport { type CompositeKind } from './kinds'\nimport { CompositeNode, CompositeDescriptionNode, CompositeTagsNode, CompositeTitleNode } from './nodes'\nimport { ReferenceNode } from './reference'\n\nexport { type CompositeAiBrief, compositeAiBrief } from './ai-brief'\nexport { compositeConversions, convertCompositeBlocks } from './convert'\nexport { blocksFromMarkdown, type CompositeFence, compositeFence, compositeFromMarkdown, type FenceSegment, splitCompositeFences } from './fences'\nexport { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from './heading-composites'\nexport { BIB_KEY, bibOf, bibtexOf, citeFull, citeShort, type CslDate, type CslItem, type CslName, type CslType, CSL_TYPES, cslOf, cslTypeOptions, yearOf } from './bibliography'\nexport { bodyMarkdown, DERIVATION_KEY, type Derivation, derivationOf, derivationState, type DerivationMethod, type DerivationSource, renditionsOf, sourceOf } from './derivation'\nexport { type CompositeKind, type CompositeKindAi, type CompositeMetaField, compositeKind, defaultCompositeKinds, kindAccepts, SOURCE_MEDIA_TYPES } from './kinds'\nexport { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from './legacy'\nexport { REFERENCE_NODE, type ReferenceAttrs, referenceMarkdown, ReferenceNode, type ReferenceOptions, ReferenceSuggestionPluginKey } from './reference'\nexport { compositeIdsOf, collectCompositeIds, normalizeReferences, referencesFromText } from './reference-text'\nexport {\n  COMPOSITE_CHROME_COUNT,\n  compositeJSON,\n  compositeKindsOf,\n  CompositeDescriptionNode,\n  CompositeNode,\n  type CompositeOptions,\n  type CompositeStorage,\n  CompositeTagsNode,\n  CompositeTitleNode,\n} from './nodes'\n\n/**\n * The schema-bearing composite family (composite, title, description, tags, and the inline `reference` chip) without node views, to append to\n * `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`\n * is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.\n */\nexport function compositeSchemaExtensions(options: { kinds?: readonly CompositeKind[] } = {}): AnyExtension[] {\n  return [CompositeNode.configure(options.kinds ? { kinds: options.kinds } : {}), CompositeTitleNode, CompositeDescriptionNode, CompositeTagsNode, ReferenceNode]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,0BAA0B,UAAgD,CAAC,GAAmB;CAC5G,OAAO;EAAC,cAAc,UAAU,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC,CAAC;EAAG;EAAoB;EAA0B;EAAmB;CAAa;AAChK"}

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

@@ -1,3 +1,4 @@
+import { fieldDisplay, formatDate } from "./meta-display.js";
 //#region src/features/composites/table-model.ts
 /** Id prefix of the columns derived from meta fields. */
 const FIELD_PREFIX = "meta:";
@@ -10,23 +11,12 @@ const finiteNumber = (value) => {
 	return Number.isFinite(number) ? number : null;
 };
 const numberFormat = new Intl.NumberFormat("de-DE");
-const dateFormat = new Intl.DateTimeFormat("de-DE", {
-	day: "2-digit",
-	month: "2-digit",
-	year: "numeric"
-});
 /** German, numeric-aware ordering of two sort keys' text. */
 const collator = new Intl.Collator("de", { numeric: true });
 /** The field of `row`'s kind with key `key`. */
 const fieldOf = (row, key) => row.fields.find((field) => field.key === key);
-/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */
-function formatDate(value) {
-	const match = /^(\d{4})-(\d{2})-(\d{2})/.exec(value);
-	const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value);
-	return Number.isNaN(date.getTime()) ? value : dateFormat.format(date);
-}
-/** The cell text of `row`'s field `key`; empty when the value is unset or the row's kind does not have the field. */
-function fieldText(row, key) {
+/** The cell text of `row`'s field `key`; empty when the value is unset or the row's kind does not have the field. Without `context`, `reference` fields read empty. */
+function fieldText(row, key, context) {
 	const field = fieldOf(row, key);
 	const value = row.meta[key];
 	if (!field || isEmpty(value)) return "";
@@ -36,22 +26,23 @@ function fieldText(row, key) {
 		const number = finiteNumber(value);
 		return number === null ? String(value) : numberFormat.format(number);
 	}
-	return String(value);
+	return fieldDisplay(row, field, context?.doc ?? null, context?.kinds ?? [], context?.t);
 }
-/** The sort key of `row`'s field `key`: numbers as numbers, selects by their label, everything else as text. */
-function fieldSort(row, key) {
+/** The sort key of `row`'s field `key`: numbers as numbers, selects, references, citations and provenance by their cell text, everything else as text. */
+function fieldSort(row, key, context) {
 	const field = fieldOf(row, key);
 	const value = row.meta[key];
 	if (!field || isEmpty(value)) return null;
 	if (field.type === "number") return finiteNumber(value) ?? String(value);
-	if (field.type === "select") return fieldText(row, key);
+	if (field.type === "select" || field.type === "reference" || field.type === "bibliography" || field.type === "derivation") return fieldText(row, key, context) || null;
 	return String(value);
 }
 /**
 * One column per field key in use, in kind order; the first kind that has the key decides label and type.
 * `textarea` fields (long text such as a transcript) get no column: a table cell can only show a truncated fragment.
+* `context` resolves `reference` cells and sort keys.
 */
-function fieldColumnsOf(rows, kinds) {
+function fieldColumnsOf(rows, kinds, context) {
 	const firstRowOfKind = /* @__PURE__ */ new Map();
 	for (const row of rows) if (!firstRowOfKind.has(row.kind)) firstRowOfKind.set(row.kind, row);
 	const seen = /* @__PURE__ */ new Map();
@@ -61,7 +52,7 @@ function fieldColumnsOf(rows, kinds) {
 			id: `${FIELD_PREFIX}${field.key}`,
 			label: field.label,
 			align: field.type === "number" ? "end" : void 0,
-			sort: (row) => fieldSort(row, field.key),
+			sort: (row) => fieldSort(row, field.key, context),
 			field
 		});
 	}
@@ -109,8 +100,8 @@ function toggled(list, value) {
 	return list.includes(value) ? list.filter((item) => item !== value) : [...list, value];
 }
 const hasText = (value) => value.trim() !== "";
-/** Long text fields show a truncated fragment in a cell, with the full text as its title. */
-const isLongText = (field) => field.type === "text" || field.type === "textarea";
+/** Long text fields (and the citation or provenance summaries) show a truncated fragment in a cell, with the full text as its title. */
+const isLongText = (field) => field.type === "text" || field.type === "textarea" || field.type === "reference" || field.type === "bibliography" || field.type === "derivation";
 //#endregion
 export { FIELD_PREFIX, FILTER_ALL, collator, columnSpecsOf, fieldColumnsOf, fieldOf, fieldSort, fieldText, hasText, isLongText, sortRows, toggled };
 

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

@@ -1 +1 @@
-{"version":3,"file":"table-model.js","names":[],"sources":["../../../src/features/composites/table-model.ts"],"sourcesContent":["import type { Translate } from '../../i18n'\nimport type { CompositeMetaField } from './kinds'\nimport type { CompositeRow } from './rows'\n\n// The framework-free part of the Bausteine table (`CompositeTable` on Vue and React): column specs, cell text and sort\n// keys. Columns beyond the fixed ones derive from the meta fields of the kinds present in the document.\n\n/** A sort key; `null` is an empty value, which sorts last in either direction. */\nexport type SortValue = string | number | null\n\nexport interface ColumnSpec {\n  id: string\n  label: string\n  /** Number columns read better flush right, next to their tabular numerals. */\n  align?: 'end'\n  sort: (row: CompositeRow) => SortValue\n}\n\nexport interface FieldColumn extends ColumnSpec {\n  field: CompositeMetaField\n}\n\n/** Id prefix of the columns derived from meta fields. */\nexport const FIELD_PREFIX = 'meta:'\n\n/** The \"no filter\" value of a field's select filter. */\nexport const FILTER_ALL = '__all__'\n\nconst isEmpty = (value: unknown): boolean => value === undefined || value === null || value === ''\nconst finiteNumber = (value: unknown): number | null => {\n  if (isEmpty(value)) return null\n  const number = Number(value)\n  return Number.isFinite(number) ? number : null\n}\nconst numberFormat = new Intl.NumberFormat('de-DE')\nconst dateFormat = new Intl.DateTimeFormat('de-DE', { day: '2-digit', month: '2-digit', year: 'numeric' })\n\n/** German, numeric-aware ordering of two sort keys' text. */\nexport const collator = new Intl.Collator('de', { numeric: true })\n\n/** The field of `row`'s kind with key `key`. */\nexport const fieldOf = (row: CompositeRow, key: string): CompositeMetaField | undefined => row.fields.find(field => field.key === key)\n\n/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */\nfunction formatDate(value: string): string {\n  const match = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value)\n  const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value)\n  return Number.isNaN(date.getTime()) ? value : dateFormat.format(date)\n}\n\n/** The cell text of `row`'s field `key`; empty when the value is unset or the row's kind does not have the field. */\nexport function fieldText(row: CompositeRow, key: string): string {\n  const field = fieldOf(row, key)\n  const value = row.meta[key]\n  if (!field || isEmpty(value)) return ''\n  if (field.type === 'select') return field.options?.find(option => option.value === value)?.label ?? String(value)\n  if (field.type === 'date') return formatDate(String(value))\n  if (field.type === 'number') {\n    const number = finiteNumber(value)\n    return number === null ? String(value) : numberFormat.format(number)\n  }\n  return String(value)\n}\n\n/** The sort key of `row`'s field `key`: numbers as numbers, selects by their label, everything else as text. */\nexport function fieldSort(row: CompositeRow, key: string): SortValue {\n  const field = fieldOf(row, key)\n  const value = row.meta[key]\n  if (!field || isEmpty(value)) return null\n  if (field.type === 'number') return finiteNumber(value) ?? String(value)\n  // ISO dates order correctly as plain strings; select values are ordered by what the user reads.\n  if (field.type === 'select') return fieldText(row, key)\n  return String(value)\n}\n\n/**\n * One column per field key in use, in kind order; the first kind that has the key decides label and type.\n * `textarea` fields (long text such as a transcript) get no column: a table cell can only show a truncated fragment.\n */\nexport function fieldColumnsOf(rows: readonly CompositeRow[], kinds: readonly { id: string }[]): FieldColumn[] {\n  const firstRowOfKind = new Map<string, CompositeRow>()\n  for (const row of rows) if (!firstRowOfKind.has(row.kind)) firstRowOfKind.set(row.kind, row)\n  const seen = new Map<string, FieldColumn>()\n  for (const kind of kinds) {\n    for (const field of firstRowOfKind.get(kind.id)?.fields ?? []) {\n      if (field.type === 'textarea' || seen.has(field.key)) continue\n      seen.set(field.key, {\n        id: `${FIELD_PREFIX}${field.key}`,\n        label: field.label,\n        align: field.type === 'number' ? 'end' : undefined,\n        sort: row => fieldSort(row, field.key),\n        field,\n      })\n    }\n  }\n  return [...seen.values()]\n}\n\n/** All columns: title and kind, then the field columns, then tags and summary. */\nexport function columnSpecsOf(fieldColumns: readonly FieldColumn[], t: Translate): ColumnSpec[] {\n  return [\n    { id: 'title', label: t('composites.table.column.composite'), sort: row => row.title.trim() || null },\n    { id: 'kind', label: t('composites.table.column.kind'), sort: row => row.kindLabel },\n    ...fieldColumns,\n    { id: 'tags', label: t('composites.table.column.tags'), sort: row => row.tags.join(', ') || null },\n    // Never empty: absence is a value here, so descending puts the summarized Bausteine first.\n    { id: 'summary', label: t('composites.table.column.summary'), sort: row => (row.description.trim() ? 1 : 0) },\n  ]\n}\n\n/** `rows` ordered by `sort`, descending when `desc`; empty values last whatever the direction. */\nexport function sortRows(rows: readonly CompositeRow[], sort: ColumnSpec['sort'], desc: boolean): CompositeRow[] {\n  const factor = desc ? -1 : 1\n  return [...rows].sort((a, b) => {\n    const x = sort(a)\n    const y = sort(b)\n    if (x === null || y === null) return x === y ? 0 : x === null ? 1 : -1\n    if (typeof x === 'number' && typeof y === 'number') return (x - y) * factor\n    return collator.compare(String(x), String(y)) * factor\n  })\n}\n\n/** `list` with `value` added, or removed when present. Pure: returns the new list, the caller assigns it. */\nexport function toggled(list: readonly string[], value: string): string[] {\n  return list.includes(value) ? list.filter(item => item !== value) : [...list, value]\n}\n\nexport const hasText = (value: string) => value.trim() !== ''\n\n/** Long text fields show a truncated fragment in a cell, with the full text as its title. */\nexport const isLongText = (field: CompositeMetaField) => field.type === 'text' || field.type === 'textarea'\n"],"mappings":";;AAuBA,MAAa,eAAe;;AAG5B,MAAa,aAAa;AAE1B,MAAM,WAAW,UAA4B,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU;AAChG,MAAM,gBAAgB,UAAkC;CACtD,IAAI,QAAQ,KAAK,GAAG,OAAO;CAC3B,MAAM,SAAS,OAAO,KAAK;CAC3B,OAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAC5C;AACA,MAAM,eAAe,IAAI,KAAK,aAAa,OAAO;AAClD,MAAM,aAAa,IAAI,KAAK,eAAe,SAAS;CAAE,KAAK;CAAW,OAAO;CAAW,MAAM;AAAU,CAAC;;AAGzG,MAAa,WAAW,IAAI,KAAK,SAAS,MAAM,EAAE,SAAS,KAAK,CAAC;;AAGjE,MAAa,WAAW,KAAmB,QAAgD,IAAI,OAAO,MAAK,UAAS,MAAM,QAAQ,GAAG;;AAGrI,SAAS,WAAW,OAAuB;CACzC,MAAM,QAAQ,2BAA2B,KAAK,KAAK;CACnD,MAAM,OAAO,QAAQ,IAAI,KAAK,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,IAAI,GAAG,OAAO,MAAM,EAAE,CAAC,IAAI,IAAI,KAAK,KAAK;CACxG,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,QAAQ,WAAW,OAAO,IAAI;AACtE;;AAGA,SAAgB,UAAU,KAAmB,KAAqB;CAChE,MAAM,QAAQ,QAAQ,KAAK,GAAG;CAC9B,MAAM,QAAQ,IAAI,KAAK;CACvB,IAAI,CAAC,SAAS,QAAQ,KAAK,GAAG,OAAO;CACrC,IAAI,MAAM,SAAS,UAAU,OAAO,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,SAAS,OAAO,KAAK;CAChH,IAAI,MAAM,SAAS,QAAQ,OAAO,WAAW,OAAO,KAAK,CAAC;CAC1D,IAAI,MAAM,SAAS,UAAU;EAC3B,MAAM,SAAS,aAAa,KAAK;EACjC,OAAO,WAAW,OAAO,OAAO,KAAK,IAAI,aAAa,OAAO,MAAM;CACrE;CACA,OAAO,OAAO,KAAK;AACrB;;AAGA,SAAgB,UAAU,KAAmB,KAAwB;CACnE,MAAM,QAAQ,QAAQ,KAAK,GAAG;CAC9B,MAAM,QAAQ,IAAI,KAAK;CACvB,IAAI,CAAC,SAAS,QAAQ,KAAK,GAAG,OAAO;CACrC,IAAI,MAAM,SAAS,UAAU,OAAO,aAAa,KAAK,KAAK,OAAO,KAAK;CAEvE,IAAI,MAAM,SAAS,UAAU,OAAO,UAAU,KAAK,GAAG;CACtD,OAAO,OAAO,KAAK;AACrB;;;;;AAMA,SAAgB,eAAe,MAA+B,OAAiD;CAC7G,MAAM,iCAAiB,IAAI,IAA0B;CACrD,KAAK,MAAM,OAAO,MAAM,IAAI,CAAC,eAAe,IAAI,IAAI,IAAI,GAAG,eAAe,IAAI,IAAI,MAAM,GAAG;CAC3F,MAAM,uBAAO,IAAI,IAAyB;CAC1C,KAAK,MAAM,QAAQ,OACjB,KAAK,MAAM,SAAS,eAAe,IAAI,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,GAAG;EAC7D,IAAI,MAAM,SAAS,cAAc,KAAK,IAAI,MAAM,GAAG,GAAG;EACtD,KAAK,IAAI,MAAM,KAAK;GAClB,IAAI,GAAG,eAAe,MAAM;GAC5B,OAAO,MAAM;GACb,OAAO,MAAM,SAAS,WAAW,QAAQ,KAAA;GACzC,OAAM,QAAO,UAAU,KAAK,MAAM,GAAG;GACrC;EACF,CAAC;CACH;CAEF,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC;AAC1B;;AAGA,SAAgB,cAAc,cAAsC,GAA4B;CAC9F,OAAO;EACL;GAAE,IAAI;GAAS,OAAO,EAAE,mCAAmC;GAAG,OAAM,QAAO,IAAI,MAAM,KAAK,KAAK;EAAK;EACpG;GAAE,IAAI;GAAQ,OAAO,EAAE,8BAA8B;GAAG,OAAM,QAAO,IAAI;EAAU;EACnF,GAAG;EACH;GAAE,IAAI;GAAQ,OAAO,EAAE,8BAA8B;GAAG,OAAM,QAAO,IAAI,KAAK,KAAK,IAAI,KAAK;EAAK;EAEjG;GAAE,IAAI;GAAW,OAAO,EAAE,iCAAiC;GAAG,OAAM,QAAQ,IAAI,YAAY,KAAK,IAAI,IAAI;EAAG;CAC9G;AACF;;AAGA,SAAgB,SAAS,MAA+B,MAA0B,MAA+B;CAC/G,MAAM,SAAS,OAAO,KAAK;CAC3B,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;EAC9B,MAAM,IAAI,KAAK,CAAC;EAChB,MAAM,IAAI,KAAK,CAAC;EAChB,IAAI,MAAM,QAAQ,MAAM,MAAM,OAAO,MAAM,IAAI,IAAI,MAAM,OAAO,IAAI;EACpE,IAAI,OAAO,MAAM,YAAY,OAAO,MAAM,UAAU,QAAQ,IAAI,KAAK;EACrE,OAAO,SAAS,QAAQ,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI;CAClD,CAAC;AACH;;AAGA,SAAgB,QAAQ,MAAyB,OAAyB;CACxE,OAAO,KAAK,SAAS,KAAK,IAAI,KAAK,QAAO,SAAQ,SAAS,KAAK,IAAI,CAAC,GAAG,MAAM,KAAK;AACrF;AAEA,MAAa,WAAW,UAAkB,MAAM,KAAK,MAAM;;AAG3D,MAAa,cAAc,UAA8B,MAAM,SAAS,UAAU,MAAM,SAAS"}
+{"version":3,"file":"table-model.js","names":[],"sources":["../../../src/features/composites/table-model.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\nimport type { Translate } from '../../i18n'\nimport type { CompositeKind, CompositeMetaField } from './kinds'\nimport { fieldDisplay, formatDate } from './meta-display'\nimport type { CompositeRow } from './rows'\n\n// The framework-free part of the Bausteine table (`CompositeTable` on Vue and React): column specs, cell text and sort\n// keys. Columns beyond the fixed ones derive from the meta fields of the kinds present in the document.\n\n/** A sort key; `null` is an empty value, which sorts last in either direction. */\nexport type SortValue = string | number | null\n\nexport interface ColumnSpec {\n  id: string\n  label: string\n  /** Number columns read better flush right, next to their tabular numerals. */\n  align?: 'end'\n  sort: (row: CompositeRow) => SortValue\n}\n\nexport interface FieldColumn extends ColumnSpec {\n  field: CompositeMetaField\n}\n\n/** Id prefix of the columns derived from meta fields. */\nexport const FIELD_PREFIX = 'meta:'\n\n/** The \"no filter\" value of a field's select filter. */\nexport const FILTER_ALL = '__all__'\n\nconst isEmpty = (value: unknown): boolean => value === undefined || value === null || value === ''\nconst finiteNumber = (value: unknown): number | null => {\n  if (isEmpty(value)) return null\n  const number = Number(value)\n  return Number.isFinite(number) ? number : null\n}\nconst numberFormat = new Intl.NumberFormat('de-DE')\n\n/** What a cell needs beyond its row to resolve `reference` fields and word `derivation` methods: the document, its kinds and the translator. */\nexport interface FieldContext {\n  doc: PMNode\n  kinds: readonly CompositeKind[]\n  t: Translate\n}\n\n/** German, numeric-aware ordering of two sort keys' text. */\nexport const collator = new Intl.Collator('de', { numeric: true })\n\n/** The field of `row`'s kind with key `key`. */\nexport const fieldOf = (row: CompositeRow, key: string): CompositeMetaField | undefined => row.fields.find(field => field.key === key)\n\n/** The cell text of `row`'s field `key`; empty when the value is unset or the row's kind does not have the field. Without `context`, `reference` fields read empty. */\nexport function fieldText(row: CompositeRow, key: string, context?: FieldContext): string {\n  const field = fieldOf(row, key)\n  const value = row.meta[key]\n  if (!field || isEmpty(value)) return ''\n  if (field.type === 'select') return field.options?.find(option => option.value === value)?.label ?? String(value)\n  if (field.type === 'date') return formatDate(String(value))\n  if (field.type === 'number') {\n    const number = finiteNumber(value)\n    return number === null ? String(value) : numberFormat.format(number)\n  }\n  return fieldDisplay(row, field, context?.doc ?? null, context?.kinds ?? [], context?.t)\n}\n\n/** The sort key of `row`'s field `key`: numbers as numbers, selects, references, citations and provenance by their cell text, everything else as text. */\nexport function fieldSort(row: CompositeRow, key: string, context?: FieldContext): SortValue {\n  const field = fieldOf(row, key)\n  const value = row.meta[key]\n  if (!field || isEmpty(value)) return null\n  if (field.type === 'number') return finiteNumber(value) ?? String(value)\n  // ISO dates order correctly as plain strings; select values are ordered by what the user reads.\n  if (field.type === 'select' || field.type === 'reference' || field.type === 'bibliography' || field.type === 'derivation') return fieldText(row, key, context) || null\n  return String(value)\n}\n\n/**\n * One column per field key in use, in kind order; the first kind that has the key decides label and type.\n * `textarea` fields (long text such as a transcript) get no column: a table cell can only show a truncated fragment.\n * `context` resolves `reference` cells and sort keys.\n */\nexport function fieldColumnsOf(rows: readonly CompositeRow[], kinds: readonly { id: string }[], context?: FieldContext): FieldColumn[] {\n  const firstRowOfKind = new Map<string, CompositeRow>()\n  for (const row of rows) if (!firstRowOfKind.has(row.kind)) firstRowOfKind.set(row.kind, row)\n  const seen = new Map<string, FieldColumn>()\n  for (const kind of kinds) {\n    for (const field of firstRowOfKind.get(kind.id)?.fields ?? []) {\n      if (field.type === 'textarea' || seen.has(field.key)) continue\n      seen.set(field.key, {\n        id: `${FIELD_PREFIX}${field.key}`,\n        label: field.label,\n        align: field.type === 'number' ? 'end' : undefined,\n        sort: row => fieldSort(row, field.key, context),\n        field,\n      })\n    }\n  }\n  return [...seen.values()]\n}\n\n/** All columns: title and kind, then the field columns, then tags and summary. */\nexport function columnSpecsOf(fieldColumns: readonly FieldColumn[], t: Translate): ColumnSpec[] {\n  return [\n    { id: 'title', label: t('composites.table.column.composite'), sort: row => row.title.trim() || null },\n    { id: 'kind', label: t('composites.table.column.kind'), sort: row => row.kindLabel },\n    ...fieldColumns,\n    { id: 'tags', label: t('composites.table.column.tags'), sort: row => row.tags.join(', ') || null },\n    // Never empty: absence is a value here, so descending puts the summarized Bausteine first.\n    { id: 'summary', label: t('composites.table.column.summary'), sort: row => (row.description.trim() ? 1 : 0) },\n  ]\n}\n\n/** `rows` ordered by `sort`, descending when `desc`; empty values last whatever the direction. */\nexport function sortRows(rows: readonly CompositeRow[], sort: ColumnSpec['sort'], desc: boolean): CompositeRow[] {\n  const factor = desc ? -1 : 1\n  return [...rows].sort((a, b) => {\n    const x = sort(a)\n    const y = sort(b)\n    if (x === null || y === null) return x === y ? 0 : x === null ? 1 : -1\n    if (typeof x === 'number' && typeof y === 'number') return (x - y) * factor\n    return collator.compare(String(x), String(y)) * factor\n  })\n}\n\n/** `list` with `value` added, or removed when present. Pure: returns the new list, the caller assigns it. */\nexport function toggled(list: readonly string[], value: string): string[] {\n  return list.includes(value) ? list.filter(item => item !== value) : [...list, value]\n}\n\nexport const hasText = (value: string) => value.trim() !== ''\n\n/** Long text fields (and the citation or provenance summaries) show a truncated fragment in a cell, with the full text as its title. */\nexport const isLongText = (field: CompositeMetaField) => field.type === 'text' || field.type === 'textarea' || field.type === 'reference' || field.type === 'bibliography' || field.type === 'derivation'\n"],"mappings":"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"}

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

@@ -9,7 +9,8 @@ import _default$5 from "./components/CompositeSummaryEditor.vue.js";
 import _default$6 from "./components/CompositeTable.vue.js";
 import _default$7 from "./components/CompositeTagsEditor.vue.js";
 import _default$8 from "./components/CompositeView.vue.js";
-import _default$9 from "./components/SettingsEditingTab.vue.js";
+import _default$9 from "./components/ReferenceView.vue.js";
+import _default$10 from "./components/SettingsEditingTab.vue.js";
 import { useCompositeAnchors } from "./use-composite-anchors.js";
 import { CompositeRowsModel, useCompositeRows } from "./use-composite-rows.js";
 //#region src/features/composites/vue.d.ts
@@ -19,5 +20,5 @@ import { CompositeRowsModel, useCompositeRows } from "./use-composite-rows.js";
  */
 export declare function compositeFeature(options?: CompositeFeatureOptions): VueFeature;
 //#endregion
-export { _default as CompositeChrome, _default$1 as CompositeDetails, _default$2 as CompositeFieldEditor, _default$3 as CompositeInspector, type CompositeRowsModel, _default$4 as CompositeStatusMenu, _default$5 as CompositeSummaryEditor, _default$6 as CompositeTable, _default$7 as CompositeTagsEditor, _default$8 as CompositeView, _default$9 as SettingsEditingTab, useCompositeAnchors, useCompositeRows };
+export { _default as CompositeChrome, _default$1 as CompositeDetails, _default$2 as CompositeFieldEditor, _default$3 as CompositeInspector, type CompositeRowsModel, _default$4 as CompositeStatusMenu, _default$5 as CompositeSummaryEditor, _default$6 as CompositeTable, _default$7 as CompositeTagsEditor, _default$8 as CompositeView, _default$9 as ReferenceView, _default$10 as SettingsEditingTab, useCompositeAnchors, useCompositeRows };
 //# sourceMappingURL=vue.d.ts.map

package/dist/features/composites/vue.js

@@ -8,7 +8,8 @@ import _sfc_main$4 from "./components/CompositeStatusMenu.js";
 import _sfc_main$7 from "./components/CompositeTagsEditor.js";
 import _sfc_main from "./components/CompositeChrome.js";
 import _sfc_main$8 from "./components/CompositeView.js";
-import _sfc_main$9 from "./components/SettingsEditingTab.js";
+import _sfc_main$9 from "./components/ReferenceView.js";
+import _sfc_main$10 from "./components/SettingsEditingTab.js";
 import _sfc_main$3 from "./components/CompositeInspector.js";
 import _sfc_main$6 from "./components/CompositeTable.js";
 import { VueNodeViewRenderer } from "@tiptap/vue-3";
@@ -20,11 +21,14 @@ import { VueNodeViewRenderer } from "@tiptap/vue-3";
 function compositeFeature(options = {}) {
 	return compositeFeatureCore({
 		chrome: _sfc_main,
-		settingsTab: _sfc_main$9,
-		nodeViews: { composite: VueNodeViewRenderer(_sfc_main$8) }
+		settingsTab: _sfc_main$10,
+		nodeViews: {
+			composite: VueNodeViewRenderer(_sfc_main$8),
+			reference: VueNodeViewRenderer(_sfc_main$9)
+		}
 	}, options);
 }
 //#endregion
-export { _sfc_main as CompositeChrome, _sfc_main$1 as CompositeDetails, _sfc_main$2 as CompositeFieldEditor, _sfc_main$3 as CompositeInspector, _sfc_main$4 as CompositeStatusMenu, _sfc_main$5 as CompositeSummaryEditor, _sfc_main$6 as CompositeTable, _sfc_main$7 as CompositeTagsEditor, _sfc_main$8 as CompositeView, _sfc_main$9 as SettingsEditingTab, compositeFeature, useCompositeAnchors, useCompositeRows };
+export { _sfc_main as CompositeChrome, _sfc_main$1 as CompositeDetails, _sfc_main$2 as CompositeFieldEditor, _sfc_main$3 as CompositeInspector, _sfc_main$4 as CompositeStatusMenu, _sfc_main$5 as CompositeSummaryEditor, _sfc_main$6 as CompositeTable, _sfc_main$7 as CompositeTagsEditor, _sfc_main$8 as CompositeView, _sfc_main$9 as ReferenceView, _sfc_main$10 as SettingsEditingTab, compositeFeature, useCompositeAnchors, useCompositeRows };
 
 //# sourceMappingURL=vue.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"vue.js","names":["CompositeChrome","SettingsEditingTab","CompositeView"],"sources":["../../../src/features/composites/vue.ts"],"sourcesContent":["import { VueNodeViewRenderer } from '@tiptap/vue-3'\nimport type { Component } from 'vue'\nimport type { VueFeature } from '../../vue'\nimport CompositeChrome from './components/CompositeChrome.vue'\nimport CompositeView from './components/CompositeView.vue'\nimport SettingsEditingTab from './components/SettingsEditingTab.vue'\nimport { type CompositeFeatureOptions, compositeFeatureCore } from './feature'\n\nexport { default as CompositeChrome } from './components/CompositeChrome.vue'\nexport { default as CompositeDetails } from './components/CompositeDetails.vue'\nexport { default as CompositeFieldEditor } from './components/CompositeFieldEditor.vue'\nexport { default as CompositeInspector } from './components/CompositeInspector.vue'\nexport { default as CompositeStatusMenu } from './components/CompositeStatusMenu.vue'\nexport { default as CompositeSummaryEditor } from './components/CompositeSummaryEditor.vue'\nexport { default as CompositeTable } from './components/CompositeTable.vue'\nexport { default as CompositeTagsEditor } from './components/CompositeTagsEditor.vue'\nexport { default as CompositeView } from './components/CompositeView.vue'\nexport { default as SettingsEditingTab } from './components/SettingsEditingTab.vue'\nexport { useCompositeAnchors } from './use-composite-anchors'\nexport { type CompositeRowsModel, useCompositeRows } from './use-composite-rows'\n\n/**\n * The Vue composites feature (Nuxt UI): see `compositeFeatureCore`. The host places `CompositeTable` and\n * `CompositeInspector` beside the editor.\n */\nexport function compositeFeature(options: CompositeFeatureOptions = {}): VueFeature {\n  return compositeFeatureCore<Component>({\n    chrome: CompositeChrome,\n    settingsTab: SettingsEditingTab,\n    nodeViews: { composite: VueNodeViewRenderer(CompositeView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,iBAAiB,UAAmC,CAAC,GAAe;CAClF,OAAO,qBAAgC;EACrC,QAAQA;EACR,aAAaC;EACb,WAAW,EAAE,WAAW,oBAAoBC,WAAa,EAAE;CAC7D,GAAG,OAAO;AACZ"}
+{"version":3,"file":"vue.js","names":["CompositeChrome","SettingsEditingTab","CompositeView","ReferenceView"],"sources":["../../../src/features/composites/vue.ts"],"sourcesContent":["import { VueNodeViewRenderer } from '@tiptap/vue-3'\nimport type { Component } from 'vue'\nimport type { VueFeature } from '../../vue'\nimport CompositeChrome from './components/CompositeChrome.vue'\nimport CompositeView from './components/CompositeView.vue'\nimport ReferenceView from './components/ReferenceView.vue'\nimport SettingsEditingTab from './components/SettingsEditingTab.vue'\nimport { type CompositeFeatureOptions, compositeFeatureCore } from './feature'\n\nexport { default as CompositeChrome } from './components/CompositeChrome.vue'\nexport { default as CompositeDetails } from './components/CompositeDetails.vue'\nexport { default as CompositeFieldEditor } from './components/CompositeFieldEditor.vue'\nexport { default as CompositeInspector } from './components/CompositeInspector.vue'\nexport { default as CompositeStatusMenu } from './components/CompositeStatusMenu.vue'\nexport { default as CompositeSummaryEditor } from './components/CompositeSummaryEditor.vue'\nexport { default as CompositeTable } from './components/CompositeTable.vue'\nexport { default as CompositeTagsEditor } from './components/CompositeTagsEditor.vue'\nexport { default as CompositeView } from './components/CompositeView.vue'\nexport { default as ReferenceView } from './components/ReferenceView.vue'\nexport { default as SettingsEditingTab } from './components/SettingsEditingTab.vue'\nexport { useCompositeAnchors } from './use-composite-anchors'\nexport { type CompositeRowsModel, useCompositeRows } from './use-composite-rows'\n\n/**\n * The Vue composites feature (Nuxt UI): see `compositeFeatureCore`. The host places `CompositeTable` and\n * `CompositeInspector` beside the editor.\n */\nexport function compositeFeature(options: CompositeFeatureOptions = {}): VueFeature {\n  return compositeFeatureCore<Component>({\n    chrome: CompositeChrome,\n    settingsTab: SettingsEditingTab,\n    nodeViews: { composite: VueNodeViewRenderer(CompositeView), reference: VueNodeViewRenderer(ReferenceView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAe;CAClF,OAAO,qBAAgC;EACrC,QAAQA;EACR,aAAaC;EACb,WAAW;GAAE,WAAW,oBAAoBC,WAAa;GAAG,WAAW,oBAAoBC,WAAa;EAAE;CAC5G,GAAG,OAAO;AACZ"}

package/dist/features/media/assets.d.ts

@@ -6,6 +6,8 @@ export interface AssetRecord {
   filename: string;
   mimeType: string;
   size: number;
+  /** SHA-256 (hex) of the stored bytes; absent on records written before hashes were kept. */
+  sha256?: string;
   createdAt: string;
 }
 /** `assets.json` of a document package. */

package/dist/features/media/assets.js

@@ -1,3 +1,4 @@
+import { EDITOR_API } from "../../core/api-routes.js";
 //#region src/features/media/assets.ts
 /** `<uuid>.<ext>`: the random name an upload is stored under. */
 const ASSET_NAME = /^[0-9a-f-]{36}\.[a-z0-9]{1,8}$/;
@@ -5,7 +6,7 @@ const ASSET_NAME = /^[0-9a-f-]{36}\.[a-z0-9]{1,8}$/;
 const ASSET_DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/;
 /** Owner of uploads made by editors that are not bound to a stored document (e.g. the playground). */
 const SCRATCH_DOCUMENT_ID = "scratch";
-const ASSET_URL_PREFIX = "/api/editor/assets/";
+const ASSET_URL_PREFIX = `${EDITOR_API}/assets/`;
 /** URL of asset `name` of document `documentId`. */
 function assetUrl(documentId, name) {
 	return `${ASSET_URL_PREFIX}${documentId}/${name}`;
@@ -13,7 +14,7 @@ function assetUrl(documentId, name) {
 /** Parses an asset URL (as embedded in `src` attributes); null for anything else. */
 function assetRefOf(src) {
 	if (!src.startsWith(ASSET_URL_PREFIX)) return null;
-	const [documentId, name, ...rest] = src.slice(19).split("/");
+	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,

package/dist/features/media/assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"assets.js","names":[],"sources":["../../../src/features/media/assets.ts"],"sourcesContent":["// Vue-free and server-importable: the asset endpoints, the host store and the client all agree on these shapes.\n// Every uploaded file belongs to one document (a package directory in the host's store) and is addressed by\n// `/api/editor/assets/<documentId>/<name>`.\n\n/** One stored file of a document; `name` is the file name inside the package's `assets/` directory. */\nexport interface AssetRecord {\n  name: string\n  /** Original file name as uploaded (shown in downloads). */\n  filename: string\n  mimeType: string\n  size: number\n  createdAt: string\n}\n\n/** `assets.json` of a document package. */\nexport interface AssetManifest {\n  version: 1\n  assets: Record<string, AssetRecord>\n}\n\n/** `<uuid>.<ext>`: the random name an upload is stored under. */\nexport const ASSET_NAME = /^[0-9a-f-]{36}\\.[a-z0-9]{1,8}$/\n\n/** Document ids the asset endpoints accept (host document uuids, or `SCRATCH_DOCUMENT_ID`). */\nexport const ASSET_DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/\n\n/** Owner of uploads made by editors that are not bound to a stored document (e.g. the playground). */\nexport const SCRATCH_DOCUMENT_ID = 'scratch'\n\nconst ASSET_URL_PREFIX = '/api/editor/assets/'\n\n/** URL of asset `name` of document `documentId`. */\nexport function assetUrl(documentId: string, name: string): string {\n  return `${ASSET_URL_PREFIX}${documentId}/${name}`\n}\n\n/** Parses an asset URL (as embedded in `src` attributes); null for anything else. */\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"],"mappings":";;AAqBA,MAAa,aAAa;;AAG1B,MAAa,oBAAoB;;AAGjC,MAAa,sBAAsB;AAEnC,MAAM,mBAAmB;;AAGzB,SAAgB,SAAS,YAAoB,MAAsB;CACjE,OAAO,GAAG,mBAAmB,WAAW,GAAG;AAC7C;;AAGA,SAAgB,WAAW,KAA0D;CACnF,IAAI,CAAC,IAAI,WAAW,gBAAgB,GAAG,OAAO;CAC9C,MAAM,CAAC,YAAY,MAAM,GAAG,QAAQ,IAAI,MAAM,EAAuB,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"}
+{"version":3,"file":"assets.js","names":[],"sources":["../../../src/features/media/assets.ts"],"sourcesContent":["import { EDITOR_API } from '../../core/api-routes'\n\n// Vue-free and server-importable: the asset endpoints, the host store and the client all agree on these shapes.\n// Every uploaded file belongs to one document (a package directory in the host's store) and is addressed by\n// `/api/editor/assets/<documentId>/<name>`.\n\n/** One stored file of a document; `name` is the file name inside the package's `assets/` directory. */\nexport interface AssetRecord {\n  name: string\n  /** Original file name as uploaded (shown in downloads). */\n  filename: string\n  mimeType: string\n  size: number\n  /** SHA-256 (hex) of the stored bytes; absent on records written before hashes were kept. */\n  sha256?: string\n  createdAt: string\n}\n\n/** `assets.json` of a document package. */\nexport interface AssetManifest {\n  version: 1\n  assets: Record<string, AssetRecord>\n}\n\n/** `<uuid>.<ext>`: the random name an upload is stored under. */\nexport const ASSET_NAME = /^[0-9a-f-]{36}\\.[a-z0-9]{1,8}$/\n\n/** Document ids the asset endpoints accept (host document uuids, or `SCRATCH_DOCUMENT_ID`). */\nexport const ASSET_DOCUMENT_ID = /^[A-Za-z0-9_-]{1,64}$/\n\n/** Owner of uploads made by editors that are not bound to a stored document (e.g. the playground). */\nexport const SCRATCH_DOCUMENT_ID = 'scratch'\n\nconst ASSET_URL_PREFIX = `${EDITOR_API}/assets/`\n\n/** URL of asset `name` of document `documentId`. */\nexport function assetUrl(documentId: string, name: string): string {\n  return `${ASSET_URL_PREFIX}${documentId}/${name}`\n}\n\n/** Parses an asset URL (as embedded in `src` attributes); null for anything else. */\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"],"mappings":";;;AAyBA,MAAa,aAAa;;AAG1B,MAAa,oBAAoB;;AAGjC,MAAa,sBAAsB;AAEnC,MAAM,mBAAmB,GAAG,WAAW;;AAGvC,SAAgB,SAAS,YAAoB,MAAsB;CACjE,OAAO,GAAG,mBAAmB,WAAW,GAAG;AAC7C;;AAGA,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"}

package/dist/features/media/components/FileView.js

@@ -1,7 +1,7 @@
 import { useUiKit } from "../../../vue/kit/use-ui-kit.js";
 import { useEditorI18n } from "../../../vue/use-editor-i18n.js";
 import { formatBytes } from "../upload.js";
-import { createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, openBlock, toDisplayString, unref, withCtx } from "vue";
+import { createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, openBlock, ref, toDisplayString, unref, withCtx } from "vue";
 import { NodeViewWrapper, nodeViewProps } from "@tiptap/vue-3";
 //#region src/features/media/components/FileView.vue
 const _hoisted_1 = {
@@ -25,11 +25,20 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 	setup(__props) {
 		const { Button: UButton, Icon: UIcon } = useUiKit();
 		const { t } = useEditorI18n();
+		const reveal = ref(null);
+		function onRevealPage(event) {
+			const detail = event.detail;
+			if (typeof detail === "number" && detail > 0) reveal.value = {
+				page: detail,
+				n: (reveal.value?.n ?? 0) + 1
+			};
+		}
 		return (_ctx, _cache) => {
 			return openBlock(), createBlock(unref(NodeViewWrapper), {
 				as: "figure",
 				class: normalizeClass(["media-block flex flex-col gap-1", { "is-selected": _ctx.selected }]),
-				"data-id": _ctx.node.attrs.id || void 0
+				"data-id": _ctx.node.attrs.id || void 0,
+				onSkRevealPage: onRevealPage
 			}, {
 				default: withCtx(() => [createElementVNode("div", _hoisted_1, [
 					createVNode(unref(UIcon), {
@@ -56,8 +65,8 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 						variant: "soft"
 					}, null, 8, ["href", "label"])
 				]), _ctx.node.attrs.mimeType === "application/pdf" && _ctx.node.attrs.src ? (openBlock(), createElementBlock("object", {
-					key: 0,
-					data: _ctx.node.attrs.src,
+					key: reveal.value?.n ?? 0,
+					data: reveal.value ? `${_ctx.node.attrs.src}#page=${reveal.value.page}` : _ctx.node.attrs.src,
 					type: "application/pdf",
 					contenteditable: "false",
 					class: "mt-2 h-[480px] w-full rounded-md border border-[var(--sk-border)]"

package/dist/features/media/components/FileView.js.map

@@ -1 +1 @@
-{"version":3,"file":"FileView.js","names":["selected","node","editor","updateAttributes","_openBlock","_createBlock","_unref","_normalizeClass","_withCtx","_createElementVNode","_createVNode","_createElementBlock","_toDisplayString","_createCommentVNode"],"sources":["../../../../src/features/media/components/FileView.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { NodeViewWrapper, nodeViewProps } from '@tiptap/vue-3'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\nimport { formatBytes } from '../upload'\n\ndefineProps(nodeViewProps)\n\nconst { Button: UButton, Icon: UIcon } = useUiKit()\nconst { t } = useEditorI18n()\n</script>\n\n<template>\n  <NodeViewWrapper\n    as=\"figure\"\n    :class=\"['media-block flex flex-col gap-1', { 'is-selected': selected }]\"\n    :data-id=\"node.attrs.id || undefined\"\n  >\n    <div class=\"flex items-center gap-2\" contenteditable=\"false\">\n      <UIcon\n        :name=\"node.attrs.mimeType === 'application/pdf' ? 'i-lucide-file-text' : 'i-lucide-file'\"\n        class=\"size-5 shrink-0 text-[var(--sk-muted)]\"\n      />\n      <input\n        :value=\"node.attrs.title\"\n        :placeholder=\"t('media.view.fileName')\"\n        :aria-label=\"t('media.view.fileName')\"\n        autocomplete=\"off\"\n        :readonly=\"!editor.isEditable\"\n        class=\"min-w-0 flex-1 rounded bg-transparent px-1 text-sm text-[var(--sk-muted)] outline-none placeholder:text-[var(--sk-fg-dimmed)] focus:bg-[color-mix(in_oklab,var(--sk-bg-accented)_50%,transparent)] focus:text-[var(--sk-fg-highlighted)]\"\n        @input=\"updateAttributes({ title: ($event.target as HTMLInputElement).value })\"\n      >\n      <span v-if=\"node.attrs.size\" class=\"shrink-0 text-xs text-[var(--sk-fg-dimmed)]\">{{ formatBytes(node.attrs.size) }}</span>\n      <UButton\n        :href=\"node.attrs.src\"\n        target=\"_blank\"\n        :label=\"t('media.view.open')\"\n        icon=\"i-lucide-external-link\"\n        size=\"xs\"\n        color=\"neutral\"\n        variant=\"soft\"\n      />\n    </div>\n    <object\n      v-if=\"node.attrs.mimeType === 'application/pdf' && node.attrs.src\"\n      :data=\"node.attrs.src\"\n      type=\"application/pdf\"\n      contenteditable=\"false\"\n      class=\"mt-2 h-[480px] w-full rounded-md border border-[var(--sk-border)]\"\n    />\n  </NodeViewWrapper>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;EAQA,MAAM,EAAE,QAAQ,SAAS,MAAM,UAAU,SAAS;EAClD,MAAM,EAAE,MAAM,cAAc;;GAI1B,OAAAI,UAAA,GAAAC,YAqCkBC,MAAA,eAAA,GAAA;IApChB,IAAG;IACF,OAAKC,eAAA,CAAA,mCAAA,EAAA,eAAuDP,KAAAA,SAAQ,CAAA,CAAA;IACpE,WAASC,KAAAA,KAAK,MAAM,MAAM,KAAA;;IAE3B,SAAAO,cAwBM,CAxBNC,mBAwBM,OAxBN,YAwBM;KAvBJC,YAGEJ,MAAA,KAAA,GAAA;MAFC,MAAML,KAAAA,KAAK,MAAM,aAAQ,oBAAA,uBAAA;MAC1B,OAAM;;KAERQ,mBAQC,SAAA;MAPE,OAAOR,KAAAA,KAAK,MAAM;MAClB,aAAaK,MAAA,CAAA,CAAC,CAAA,qBAAA;MACd,cAAYA,MAAA,CAAA,CAAC,CAAA,qBAAA;MACd,cAAa;MACZ,UAAQ,CAAGJ,KAAAA,OAAO;MACnB,OAAM;MACL,SAAK,OAAA,OAAA,OAAA,MAAA,WAAEC,KAAAA,iBAAgB,EAAA,OAAW,OAAO,OAA4B,MAAK,CAAA;;KAEjEF,KAAAA,KAAK,MAAM,QAAvBG,UAAA,GAAAO,mBAA0H,QAA1H,YAA0HC,gBAAtCN,MAAA,WAAA,CAAW,CAACL,KAAAA,KAAK,MAAM,IAAI,CAAA,GAAA,CAAA,KAAAY,mBAAA,QAAA,IAAA;KAC/GH,YAQEJ,MAAA,OAAA,GAAA;MAPC,MAAML,KAAAA,KAAK,MAAM;MAClB,QAAO;MACN,OAAOK,MAAA,CAAA,CAAC,CAAA,iBAAA;MACT,MAAK;MACL,MAAK;MACL,OAAM;MACN,SAAQ;;IAIJL,CAAAA,GAAAA,KAAAA,KAAK,MAAM,aAAQ,qBAA0BA,KAAAA,KAAK,MAAM,OADhEG,UAAA,GAAAO,mBAME,UAAA;;KAJC,MAAMV,KAAAA,KAAK,MAAM;KAClB,MAAK;KACL,iBAAgB;KAChB,OAAM"}
+{"version":3,"file":"FileView.js","names":["selected","node","editor","updateAttributes","_openBlock","_createBlock","_unref","_normalizeClass","_withCtx","_createElementVNode","_createVNode","_createElementBlock","_toDisplayString","_createCommentVNode"],"sources":["../../../../src/features/media/components/FileView.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { NodeViewWrapper, nodeViewProps } from '@tiptap/vue-3'\nimport { ref } from 'vue'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\nimport { formatBytes } from '../upload'\n\ndefineProps(nodeViewProps)\n\nconst { Button: UButton, Icon: UIcon } = useUiKit()\nconst { t } = useEditorI18n()\n\n// Page the PDF viewer was asked to open at (`revealSource`, locator „S. 3“). `n` counts the requests: the viewer is\n// remounted on every one, so asking for the same page again jumps back after the user scrolled away.\nconst reveal = ref<{ page: number, n: number } | null>(null)\nfunction onRevealPage(event: Event) {\n  const detail = (event as CustomEvent<unknown>).detail\n  if (typeof detail === 'number' && detail > 0) reveal.value = { page: detail, n: (reveal.value?.n ?? 0) + 1 }\n}\n</script>\n\n<template>\n  <NodeViewWrapper\n    as=\"figure\"\n    :class=\"['media-block flex flex-col gap-1', { 'is-selected': selected }]\"\n    :data-id=\"node.attrs.id || undefined\"\n    @sk-reveal-page=\"onRevealPage\"\n  >\n    <div class=\"flex items-center gap-2\" contenteditable=\"false\">\n      <UIcon\n        :name=\"node.attrs.mimeType === 'application/pdf' ? 'i-lucide-file-text' : 'i-lucide-file'\"\n        class=\"size-5 shrink-0 text-[var(--sk-muted)]\"\n      />\n      <input\n        :value=\"node.attrs.title\"\n        :placeholder=\"t('media.view.fileName')\"\n        :aria-label=\"t('media.view.fileName')\"\n        autocomplete=\"off\"\n        :readonly=\"!editor.isEditable\"\n        class=\"min-w-0 flex-1 rounded bg-transparent px-1 text-sm text-[var(--sk-muted)] outline-none placeholder:text-[var(--sk-fg-dimmed)] focus:bg-[color-mix(in_oklab,var(--sk-bg-accented)_50%,transparent)] focus:text-[var(--sk-fg-highlighted)]\"\n        @input=\"updateAttributes({ title: ($event.target as HTMLInputElement).value })\"\n      >\n      <span v-if=\"node.attrs.size\" class=\"shrink-0 text-xs text-[var(--sk-fg-dimmed)]\">{{ formatBytes(node.attrs.size) }}</span>\n      <UButton\n        :href=\"node.attrs.src\"\n        target=\"_blank\"\n        :label=\"t('media.view.open')\"\n        icon=\"i-lucide-external-link\"\n        size=\"xs\"\n        color=\"neutral\"\n        variant=\"soft\"\n      />\n    </div>\n    <object\n      v-if=\"node.attrs.mimeType === 'application/pdf' && node.attrs.src\"\n      :key=\"reveal?.n ?? 0\"\n      :data=\"reveal ? `${node.attrs.src}#page=${reveal.page}` : node.attrs.src\"\n      type=\"application/pdf\"\n      contenteditable=\"false\"\n      class=\"mt-2 h-[480px] w-full rounded-md border border-[var(--sk-border)]\"\n    />\n  </NodeViewWrapper>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;EASA,MAAM,EAAE,QAAQ,SAAS,MAAM,UAAU,SAAS;EAClD,MAAM,EAAE,MAAM,cAAc;EAI5B,MAAM,SAAS,IAAwC,IAAI;EAC3D,SAAS,aAAa,OAAc;GAClC,MAAM,SAAU,MAA+B;GAC/C,IAAI,OAAO,WAAW,YAAY,SAAS,GAAG,OAAO,QAAQ;IAAE,MAAM;IAAQ,IAAI,OAAO,OAAO,KAAK,KAAK;GAAE;EAC7G;;GAIE,OAAAI,UAAA,GAAAC,YAuCkBC,MAAA,eAAA,GAAA;IAtChB,IAAG;IACF,OAAKC,eAAA,CAAA,mCAAA,EAAA,eAAuDP,KAAAA,SAAQ,CAAA,CAAA;IACpE,WAASC,KAAAA,KAAK,MAAM,MAAM,KAAA;IAC1B,gBAAgB;;IAEjB,SAAAO,cAwBM,CAxBNC,mBAwBM,OAxBN,YAwBM;KAvBJC,YAGEJ,MAAA,KAAA,GAAA;MAFC,MAAML,KAAAA,KAAK,MAAM,aAAQ,oBAAA,uBAAA;MAC1B,OAAM;;KAERQ,mBAQC,SAAA;MAPE,OAAOR,KAAAA,KAAK,MAAM;MAClB,aAAaK,MAAA,CAAA,CAAC,CAAA,qBAAA;MACd,cAAYA,MAAA,CAAA,CAAC,CAAA,qBAAA;MACd,cAAa;MACZ,UAAQ,CAAGJ,KAAAA,OAAO;MACnB,OAAM;MACL,SAAK,OAAA,OAAA,OAAA,MAAA,WAAEC,KAAAA,iBAAgB,EAAA,OAAW,OAAO,OAA4B,MAAK,CAAA;;KAEjEF,KAAAA,KAAK,MAAM,QAAvBG,UAAA,GAAAO,mBAA0H,QAA1H,YAA0HC,gBAAtCN,MAAA,WAAA,CAAW,CAACL,KAAAA,KAAK,MAAM,IAAI,CAAA,GAAA,CAAA,KAAAY,mBAAA,QAAA,IAAA;KAC/GH,YAQEJ,MAAA,OAAA,GAAA;MAPC,MAAML,KAAAA,KAAK,MAAM;MAClB,QAAO;MACN,OAAOK,MAAA,CAAA,CAAC,CAAA,iBAAA;MACT,MAAK;MACL,MAAK;MACL,OAAM;MACN,SAAQ;;IAIJL,CAAAA,GAAAA,KAAAA,KAAK,MAAM,aAAQ,qBAA0BA,KAAAA,KAAK,MAAM,OADhEG,UAAA,GAAAO,mBAOE,UAAA;KALC,KAAK,OAAA,OAAQ,KAAC;KACd,MAAM,OAAA,QAAM,GAAMV,KAAAA,KAAK,MAAM,IAAG,QAAS,OAAA,MAAO,SAASA,KAAAA,KAAK,MAAM;KACrE,MAAK;KACL,iBAAgB;KAChB,OAAM"}

package/dist/features/media/feature.d.ts

@@ -10,12 +10,12 @@ export interface MediaUi<C> {
   nodeViews: MediaNodeViews;
 }
 /**
- * Image, audio, video and file blocks with their views, upload (the surface's `upload` prop, else the document's asset
- * endpoint), drop/paste of files, the audio recorder, and the toolbar and `/` entries that open the file picker or
+ * Image, audio, video and file blocks with their views, upload (`backend.assets`, filed under the surface's `documentId`),
+ * drop/paste of files, the audio recorder, and the toolbar and `/` entries that open the file picker or
  * recorder. Files import through the pipeline: text and Markdown files are parsed into blocks, everything else is
  * uploaded; the `wrapImport` stage (identity by default) may wrap the blocks, which are then inserted as they are.
  * Import problems reach the user through the surface's notice seam (`ctx.notify`).
- * Needs a backend (or an `upload` function) only when a file is uploaded.
+ * Needs a backend with the `assets` capability.
  */
 export declare function mediaFeatureCore<C>(ui: MediaUi<C>): EditorFeature<C>;
 //#endregion

package/dist/features/media/feature.js

@@ -1,9 +1,8 @@
 import { ABILITY } from "../../core/schema/abilities.js";
-import { acceptFor } from "./schema.js";
+import { ImageNode, acceptFor, mediaSchemaExtensions } from "./schema.js";
 import { Media, openAudioRecorder, pickFiles, uploadOf } from "./upload.js";
 import { fileImport } from "./file-import.js";
 import { mediaBlocks } from "./node-views.js";
-import { Image } from "@tiptap/extension-image";
 import { FileHandler } from "@tiptap/extension-file-handler";
 //#region src/features/media/feature.ts
 const PICKERS = [
@@ -27,21 +26,24 @@ const PICKERS = [
 	}
 ];
 /**
-* Image, audio, video and file blocks with their views, upload (the surface's `upload` prop, else the document's asset
-* endpoint), drop/paste of files, the audio recorder, and the toolbar and `/` entries that open the file picker or
+* Image, audio, video and file blocks with their views, upload (`backend.assets`, filed under the surface's `documentId`),
+* drop/paste of files, the audio recorder, and the toolbar and `/` entries that open the file picker or
 * recorder. Files import through the pipeline: text and Markdown files are parsed into blocks, everything else is
 * uploaded; the `wrapImport` stage (identity by default) may wrap the blocks, which are then inserted as they are.
 * Import problems reach the user through the surface's notice seam (`ctx.notify`).
-* Needs a backend (or an `upload` function) only when a file is uploaded.
+* Needs a backend with the `assets` capability.
 */
 function mediaFeatureCore(ui) {
 	const { AudioBlock, VideoBlock, FileBlock } = mediaBlocks(ui.nodeViews);
 	return {
 		id: "media",
+		dimension: "content",
+		backend: ["assets"],
+		schemaExtensions: mediaSchemaExtensions,
 		extensions: (ctx) => {
 			const { importFiles } = fileImport(ctx.notify, ctx.t);
 			return [
-				Image,
+				ImageNode,
 				AudioBlock,
 				VideoBlock,
 				FileBlock,
@@ -56,35 +58,26 @@ function mediaFeatureCore(ui) {
 				})
 			];
 		},
-		toolbar: (ctx) => [{
-			id: "inserts",
-			order: 50,
-			items: [...PICKERS.map((picker, index) => ({
-				id: picker.id,
-				order: 20 + index * 10,
-				icon: picker.icon,
-				label: ctx.t(picker.labelKey),
-				ability: ABILITY.media,
-				run: (editor) => void pickAndImport(editor, acceptFor(picker.kind))
-			})), {
-				id: "aufnahme",
-				order: 50,
-				icon: "i-lucide-mic",
-				label: ctx.t("media.toolbar.record"),
-				ability: ABILITY.record,
-				run: openAudioRecorder
-			}]
-		}],
-		slashCommands: (ctx) => [...PICKERS.map((picker) => ({
+		commands: (ctx) => [...PICKERS.map((picker, index) => ({
 			id: picker.id,
-			label: ctx.t(picker.labelKey),
+			toolbar: {
+				group: "inserts",
+				order: 20 + index * 10
+			},
+			slash: {},
 			icon: picker.icon,
+			label: ctx.t(picker.labelKey),
 			ability: ABILITY.media,
 			run: (editor) => void pickAndImport(editor, acceptFor(picker.kind), editor.state.selection.from)
 		})), {
 			id: "aufnahme",
-			label: ctx.t("media.slash.record"),
+			toolbar: {
+				group: "inserts",
+				order: 50
+			},
+			slash: {},
 			icon: "i-lucide-mic",
+			label: ctx.t("media.slash.record"),
 			ability: ABILITY.record,
 			run: openAudioRecorder
 		}],