@ecsplico/editor 2.1.1 → 3.0.0

package/dist/features/composites/accepted-children.js.map

@@ -1 +1 @@
-{"version":3,"file":"accepted-children.js","names":[],"sources":["../../../src/features/composites/accepted-children.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey, type Transaction } from '@tiptap/pm/state'\nimport { AddMarkStep, AttrStep, RemoveMarkStep, ReplaceStep, type Step } from '@tiptap/pm/transform'\nimport type { Notifier } from '../../core/notify'\nimport { createTranslator, type Translate } from '../../i18n'\nimport { type CompositeKind, compositeKind, kindAccepts } from './kinds'\nimport { compositeKindsOf } from './nodes'\n\n/** One Baustein nested in a Baustein that does not accept its kind (both kind ids). */\nexport interface NestingViolation {\n  parent: string\n  child: string\n}\n\n/** The short sentence for a refused nesting, naming both kinds by label (German: „Notiz nimmt keine Aufgabe auf.“). */\nexport function nestingReason(kinds: readonly CompositeKind[], parent: string, child: string, t: Translate): string {\n  return t('composites.nesting.refused', { parent: compositeKind(kinds, parent).label, child: compositeKind(kinds, child).label })\n}\n\n/**\n * The Bausteine of `node`'s subtree, outermost first: `node` itself when it is a Baustein, otherwise the Bausteine\n * directly inside it (not those nested in another Baustein).\n */\nexport function outermostComposites(node: PMNode): PMNode[] {\n  if (node.type.name === 'composite') return [node]\n  const found: PMNode[] = []\n  node.descendants((child) => {\n    if (child.type.name === 'composite') {\n      found.push(child)\n      return false\n    }\n    return !child.isTextblock\n  })\n  return found\n}\n\n/**\n * Every Baustein in `doc` whose nearest Baustein ancestor (quotes and lists in between do not count) does not accept\n * its kind, in document order. Top-level Bausteine have no parent and never violate.\n */\nexport function nestingViolations(doc: PMNode, kinds: readonly CompositeKind[]): NestingViolation[] {\n  const found: NestingViolation[] = []\n  function walk(node: PMNode, parentKind: string | null) {\n    node.forEach((child) => {\n      if (child.isTextblock || child.isLeaf) return\n      if (child.type.name === 'composite') {\n        const kind = String(child.attrs.kind)\n        if (parentKind !== null && !kindAccepts(kinds, parentKind, kind)) found.push({ parent: parentKind, child: kind })\n        walk(child, kind)\n      }\n      else walk(child, parentKind)\n    })\n  }\n  walk(doc, null)\n  return found\n}\n\n/** A step that cannot change which Baustein sits in which: marks, text typed or deleted inside one textblock, attributes other than `kind`. */\nfunction keepsNesting(step: Step, before: PMNode): boolean {\n  if (step instanceof AddMarkStep || step instanceof RemoveMarkStep) return true\n  if (step instanceof AttrStep) return step.attr !== 'kind'\n  if (step instanceof ReplaceStep) {\n    const { slice } = step\n    if (slice.openStart !== 0 || slice.openEnd !== 0 || !slice.content.content.every(child => child.isInline)) return false\n    const $from = before.resolve(step.from)\n    return $from.parent.isTextblock && $from.sameParent(before.resolve(step.to))\n  }\n  return false\n}\n\n/**\n * Transactions that were not made by this user's edit: collaboration (y-sync marks remote changes and Yjs undo/redo\n * with `isChangeOrigin`) and prosemirror-history's undo/redo. They replay what was allowed, or what others wrote.\n */\nfunction isReplay(tr: Transaction): boolean {\n  const sync = tr.getMeta('y-sync$') as { isChangeOrigin?: boolean } | undefined\n  return sync?.isChangeOrigin === true || tr.getMeta('history$') !== undefined\n}\n\n/** The pair of kinds that occurs more often in `after` than in `before`, if any. */\nfunction addedViolation(before: readonly NestingViolation[], after: readonly NestingViolation[]): NestingViolation | undefined {\n  const counts = new Map<string, number>()\n  const key = (v: NestingViolation) => JSON.stringify([v.parent, v.child])\n  for (const v of before) counts.set(key(v), (counts.get(key(v)) ?? 0) + 1)\n  for (const v of after) {\n    const left = counts.get(key(v)) ?? 0\n    if (left === 0) return v\n    counts.set(key(v), left - 1)\n  }\n  return after[0]\n}\n\nexport interface AcceptedChildrenOptions {\n  /** Shows the notice of a refused edit (default: dropped). The composites feature passes the surface's `ctx.notify`. */\n  notify: Notifier\n  /** The translator of the notice. The composites feature passes the surface's `ctx.t`. */\n  t: Translate\n}\n\n/**\n * Enforces the kinds' accepted children (`CompositeKind.accepts`) for every local edit at one place: a transaction that\n * leaves the document with more Bausteine nested in a Baustein that does not accept them than before is refused — block\n * drag, „In Baustein umwandeln“, paste, AI inserts and review acceptance, `moveBlockInto` — and the user is told why.\n * Existing violations stay: transactions that add none (typing, undoing) pass, and so do collaboration replays, undo/redo\n * and loading a whole document. Client-only, no schema: kinds are read from the editor (`compositeKindsOf`).\n */\nexport const AcceptedChildren = Extension.create<AcceptedChildrenOptions>({\n  name: 'acceptedChildren',\n  addOptions: () => ({ notify: () => {}, t: createTranslator() }),\n  addProseMirrorPlugins() {\n    const { editor } = this\n    const { notify, t } = this.options\n    return [new Plugin({\n      key: new PluginKey('acceptedChildren'),\n      filterTransaction(tr, state) {\n        if (!tr.docChanged || isReplay(tr)) return true\n        // `setContent` loads a whole new document; that is not an edit of the existing one.\n        if (tr.steps.some((step, index) => step instanceof ReplaceStep && step.from === 0 && step.to === tr.docs[index]!.content.size)) return true\n        if (tr.steps.every((step, index) => keepsNesting(step, tr.docs[index]!))) return true\n        const kinds = compositeKindsOf(editor)\n        const before = nestingViolations(state.doc, kinds)\n        const after = nestingViolations(tr.doc, kinds)\n        if (after.length <= before.length) return true\n        const added = addedViolation(before, after)\n        notify({\n          id: 'composites-accepted-children',\n          title: t('composites.nesting.title'),\n          ...(added && { description: nestingReason(kinds, added.parent, added.child, t) }),\n          kind: 'warning',\n          icon: 'i-lucide-ban',\n        })\n        return false\n      },\n    })]\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"accepted-children.js","names":[],"sources":["../../../src/features/composites/accepted-children.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { Plugin, PluginKey, type Transaction } from '@tiptap/pm/state'\nimport { AddMarkStep, AttrStep, RemoveMarkStep, ReplaceStep, type Step } from '@tiptap/pm/transform'\nimport type { InsertGuard } from '../../core/command-types'\nimport type { Notifier } from '../../core/notify'\nimport { createTranslator, type Translate } from '../../i18n'\nimport { type CompositeKind, compositeKind, kindAccepts } from './kinds'\nimport { compositeKindsOf } from './nodes'\n\n/** One Baustein nested in a Baustein that does not accept its kind (both kind ids). */\nexport interface NestingViolation {\n  parent: string\n  child: string\n}\n\n/** The short sentence for a refused nesting, naming both kinds by label (German: „Notiz nimmt keine Aufgabe auf.“). */\nexport function nestingReason(kinds: readonly CompositeKind[], parent: string, child: string, t: Translate): string {\n  return t('composites.nesting.refused', { parent: compositeKind(kinds, parent).label, child: compositeKind(kinds, child).label })\n}\n\n/**\n * The Bausteine of `node`'s subtree, outermost first: `node` itself when it is a Baustein, otherwise the Bausteine\n * directly inside it (not those nested in another Baustein).\n */\nexport function outermostComposites(node: PMNode): PMNode[] {\n  if (node.type.name === 'composite') return [node]\n  const found: PMNode[] = []\n  node.descendants((child) => {\n    if (child.type.name === 'composite') {\n      found.push(child)\n      return false\n    }\n    return !child.isTextblock\n  })\n  return found\n}\n\n/**\n * Every Baustein in `doc` whose nearest Baustein ancestor (quotes and lists in between do not count) does not accept\n * its kind, in document order. Top-level Bausteine have no parent and never violate.\n */\nexport function nestingViolations(doc: PMNode, kinds: readonly CompositeKind[]): NestingViolation[] {\n  const found: NestingViolation[] = []\n  function walk(node: PMNode, parentKind: string | null) {\n    node.forEach((child) => {\n      if (child.isTextblock || child.isLeaf) return\n      if (child.type.name === 'composite') {\n        const kind = String(child.attrs.kind)\n        if (parentKind !== null && !kindAccepts(kinds, parentKind, kind)) found.push({ parent: parentKind, child: kind })\n        walk(child, kind)\n      }\n      else walk(child, parentKind)\n    })\n  }\n  walk(doc, null)\n  return found\n}\n\n/**\n * The insert guard of the composites feature: a Baustein of kind `creates.attrs.kind` may be created only where the\n * nearest Baustein around the insertion point (`$parent` and outward; quotes and lists in between do not count)\n * accepts that kind, or where there is none. Uses `kindAccepts`, the rule `AcceptedChildren` enforces on transactions\n * through `nestingViolations`, so the `/` menu and toolbar offer exactly what an edit would not be refused for.\n */\nexport const compositeInsertGuard: InsertGuard = (editor, $parent, creates) => {\n  const child = creates.attrs?.kind\n  if (creates.type !== 'composite' || typeof child !== 'string') return true\n  for (let depth = $parent.depth; depth >= 0; depth--) {\n    const node = $parent.node(depth)\n    if (node.type.name === 'composite') return kindAccepts(compositeKindsOf(editor), String(node.attrs.kind), child)\n  }\n  return true\n}\n\n/** A step that cannot change which Baustein sits in which: marks, text typed or deleted inside one textblock, attributes other than `kind`. */\nfunction keepsNesting(step: Step, before: PMNode): boolean {\n  if (step instanceof AddMarkStep || step instanceof RemoveMarkStep) return true\n  if (step instanceof AttrStep) return step.attr !== 'kind'\n  if (step instanceof ReplaceStep) {\n    const { slice } = step\n    if (slice.openStart !== 0 || slice.openEnd !== 0 || !slice.content.content.every(child => child.isInline)) return false\n    const $from = before.resolve(step.from)\n    return $from.parent.isTextblock && $from.sameParent(before.resolve(step.to))\n  }\n  return false\n}\n\n/**\n * Transactions that were not made by this user's edit: collaboration (y-sync marks remote changes and Yjs undo/redo\n * with `isChangeOrigin`) and prosemirror-history's undo/redo. They replay what was allowed, or what others wrote.\n */\nfunction isReplay(tr: Transaction): boolean {\n  const sync = tr.getMeta('y-sync$') as { isChangeOrigin?: boolean } | undefined\n  return sync?.isChangeOrigin === true || tr.getMeta('history$') !== undefined\n}\n\n/** The pair of kinds that occurs more often in `after` than in `before`, if any. */\nfunction addedViolation(before: readonly NestingViolation[], after: readonly NestingViolation[]): NestingViolation | undefined {\n  const counts = new Map<string, number>()\n  const key = (v: NestingViolation) => JSON.stringify([v.parent, v.child])\n  for (const v of before) counts.set(key(v), (counts.get(key(v)) ?? 0) + 1)\n  for (const v of after) {\n    const left = counts.get(key(v)) ?? 0\n    if (left === 0) return v\n    counts.set(key(v), left - 1)\n  }\n  return after[0]\n}\n\nexport interface AcceptedChildrenOptions {\n  /** Shows the notice of a refused edit (default: dropped). The composites feature passes the surface's `ctx.notify`. */\n  notify: Notifier\n  /** The translator of the notice. The composites feature passes the surface's `ctx.t`. */\n  t: Translate\n}\n\n/**\n * Enforces the kinds' accepted children (`CompositeKind.accepts`) for every local edit at one place: a transaction that\n * leaves the document with more Bausteine nested in a Baustein that does not accept them than before is refused — block\n * drag, „In Baustein umwandeln“, paste, AI inserts and review acceptance, `moveBlockInto` — and the user is told why.\n * Existing violations stay: transactions that add none (typing, undoing) pass, and so do collaboration replays, undo/redo\n * and loading a whole document. Client-only, no schema: kinds are read from the editor (`compositeKindsOf`).\n */\nexport const AcceptedChildren = Extension.create<AcceptedChildrenOptions>({\n  name: 'acceptedChildren',\n  addOptions: () => ({ notify: () => {}, t: createTranslator() }),\n  addProseMirrorPlugins() {\n    const { editor } = this\n    const { notify, t } = this.options\n    return [new Plugin({\n      key: new PluginKey('acceptedChildren'),\n      filterTransaction(tr, state) {\n        if (!tr.docChanged || isReplay(tr)) return true\n        // `setContent` loads a whole new document; that is not an edit of the existing one.\n        if (tr.steps.some((step, index) => step instanceof ReplaceStep && step.from === 0 && step.to === tr.docs[index]!.content.size)) return true\n        if (tr.steps.every((step, index) => keepsNesting(step, tr.docs[index]!))) return true\n        const kinds = compositeKindsOf(editor)\n        const before = nestingViolations(state.doc, kinds)\n        const after = nestingViolations(tr.doc, kinds)\n        if (after.length <= before.length) return true\n        const added = addedViolation(before, after)\n        notify({\n          id: 'composites-accepted-children',\n          title: t('composites.nesting.title'),\n          ...(added && { description: nestingReason(kinds, added.parent, added.child, t) }),\n          kind: 'warning',\n          icon: 'i-lucide-ban',\n        })\n        return false\n      },\n    })]\n  },\n})\n"],"mappings":"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"}

package/dist/features/composites/ai-brief.js

@@ -1,5 +1,8 @@
+import { findBlockById } from "../../core/schema/block-ids.js";
 import { compositeKind } from "./kinds.js";
+import { derivationOf } from "./derivation.js";
 import { compositeKindsOf } from "./nodes.js";
+import { citeFull } from "./bibliography.js";
 //#region src/features/composites/ai-brief.ts
 const PLACEHOLDER = /\{([\p{L}\p{N}_-]+)\}/gu;
 const isFilled = (value) => typeof value === "string" && value !== "" || typeof value === "number";
@@ -21,6 +24,34 @@ function compositeAiBrief(editor, pos) {
 	const meta = node.attrs.meta ?? {};
 	const fields = kind.fields.flatMap((field) => {
 		const raw = meta[field.key];
+		if (field.type === "bibliography") {
+			const bib = raw;
+			return bib && typeof bib === "object" && typeof bib.type === "string" ? [{
+				key: field.key,
+				label: field.label,
+				value: citeFull({
+					...bib,
+					title: node.child(0).textContent
+				})
+			}] : [];
+		}
+		if (field.type === "reference") {
+			const target = typeof raw === "string" && raw ? findBlockById(editor.state.doc, raw)?.node : void 0;
+			const title = target?.type.name === "composite" ? target.child(0).textContent.trim() : "";
+			return title ? [{
+				key: field.key,
+				label: field.label,
+				value: title
+			}] : [];
+		}
+		if (field.type === "derivation") {
+			const derivation = derivationOf(node);
+			return derivation ? [{
+				key: field.key,
+				label: field.label,
+				value: `${derivation.method} from ${"asset" in derivation.from ? derivation.from.asset : derivation.from.block}`
+			}] : [];
+		}
 		if (!isFilled(raw)) return [];
 		const value = String(raw);
 		return [{

package/dist/features/composites/ai-brief.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-brief.js","names":[],"sources":["../../../src/features/composites/ai-brief.ts"],"sourcesContent":["// Vue-free: what one Baustein tells the model (read by „Baustein füllen (KI)“, see `integrations/composite-ai`).\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 { compositeKind } from './kinds'\nimport { COMPOSITE_CHROME_COUNT, compositeKindsOf } from './nodes'\n\n/** What one Baustein tells the model: kind brief, place in the hierarchy, chrome, field values, resolved instruction and skeleton, body. */\nexport interface CompositeAiBrief {\n  kind: { id: string, label: string, purpose?: string }\n  /** Titles of the enclosing composites, outermost first (empty at document level). */\n  path: string[]\n  title: string\n  description: string\n  tags: string[]\n  /** Declared fields with a non-empty value, `select` values as their option label. */\n  fields: { key: string, label: string, value: string }[]\n  /** `meta[ai.instructionsField]` when non-empty, else `ai.instructions`, else ''. */\n  instructions: string\n  /** `ai.skeleton` with `{key}` replaced by the string value of `meta[key]` (declared fields only); '' without a skeleton. */\n  skeleton: string\n  /** Body blocks as Markdown ('' for a body without text). */\n  body: string\n}\n\nconst PLACEHOLDER = /\\{([\\p{L}\\p{N}_-]+)\\}/gu\n\nconst isFilled = (value: unknown): value is string | number => (typeof value === 'string' && value !== '') || typeof value === 'number'\n\n/** The brief of the composite at `pos`; null unless the node there is a composite whose kind has `ai`. */\nexport function compositeAiBrief(editor: Editor, pos: number): CompositeAiBrief | null {\n  const node = editor.state.doc.nodeAt(pos)\n  if (node?.type.name !== 'composite' || node.childCount < COMPOSITE_CHROME_COUNT) return null\n  const kind = compositeKind(compositeKindsOf(editor), String(node.attrs.kind))\n  const ai = kind.ai\n  if (!ai) return null\n\n  const $pos = editor.state.doc.resolve(pos)\n  const path: string[] = []\n  for (let depth = 1; depth <= $pos.depth; depth++) {\n    const ancestor = $pos.node(depth)\n    if (ancestor.type.name === 'composite') path.push(ancestor.child(0).textContent.trim())\n  }\n\n  const tags: unknown = node.child(2).attrs.tags\n  const body = Array.from({ length: node.childCount - COMPOSITE_CHROME_COUNT }, (_, i) => node.child(COMPOSITE_CHROME_COUNT + i))\n  const meta: Record<string, unknown> = node.attrs.meta ?? {}\n\n  const fields = kind.fields.flatMap((field) => {\n    const raw = meta[field.key]\n    if (!isFilled(raw)) return []\n    const value = String(raw)\n    return [{ key: field.key, label: field.label, value: field.type === 'select' ? (field.options?.find(option => option.value === value)?.label ?? value) : value }]\n  })\n  const keys = new Set(kind.fields.map(field => field.key))\n  const own = ai.instructionsField ? String(meta[ai.instructionsField] ?? '').trim() : ''\n\n  return {\n    kind: { id: kind.id, label: kind.label, ...(ai.purpose && { purpose: ai.purpose }) },\n    path,\n    title: node.child(0).textContent,\n    description: node.child(1).textContent,\n    tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [],\n    fields,\n    instructions: own || ai.instructions?.trim() || '',\n    skeleton: ai.skeleton?.replace(PLACEHOLDER, (match, key: string) => keys.has(key) && isFilled(meta[key]) ? String(meta[key]) : match) ?? '',\n    body: body.some(child => child.textContent.trim())\n      ? editor.markdown!.serialize({ type: 'doc', content: body.map(child => child.toJSON() as JSONContent) }).trim()\n      : '',\n  }\n}\n"],"mappings":";;;AAyBA,MAAM,cAAc;AAEpB,MAAM,YAAY,UAA8C,OAAO,UAAU,YAAY,UAAU,MAAO,OAAO,UAAU;;AAG/H,SAAgB,iBAAiB,QAAgB,KAAsC;CACrF,MAAM,OAAO,OAAO,MAAM,IAAI,OAAO,GAAG;CACxC,IAAI,MAAM,KAAK,SAAS,eAAe,KAAK,aAAA,GAAqC,OAAO;CACxF,MAAM,OAAO,cAAc,iBAAiB,MAAM,GAAG,OAAO,KAAK,MAAM,IAAI,CAAC;CAC5E,MAAM,KAAK,KAAK;CAChB,IAAI,CAAC,IAAI,OAAO;CAEhB,MAAM,OAAO,OAAO,MAAM,IAAI,QAAQ,GAAG;CACzC,MAAM,OAAiB,CAAC;CACxB,KAAK,IAAI,QAAQ,GAAG,SAAS,KAAK,OAAO,SAAS;EAChD,MAAM,WAAW,KAAK,KAAK,KAAK;EAChC,IAAI,SAAS,KAAK,SAAS,aAAa,KAAK,KAAK,SAAS,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC;CACxF;CAEA,MAAM,OAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM;CAC1C,MAAM,OAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,aAAA,EAAoC,IAAI,GAAG,MAAM,KAAK,MAAA,IAA+B,CAAC,CAAC;CAC9H,MAAM,OAAgC,KAAK,MAAM,QAAQ,CAAC;CAE1D,MAAM,SAAS,KAAK,OAAO,SAAS,UAAU;EAC5C,MAAM,MAAM,KAAK,MAAM;EACvB,IAAI,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC;EAC5B,MAAM,QAAQ,OAAO,GAAG;EACxB,OAAO,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,OAAO,MAAM,SAAS,WAAY,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,SAAS,QAAS;EAAM,CAAC;CAClK,CAAC;CACD,MAAM,OAAO,IAAI,IAAI,KAAK,OAAO,KAAI,UAAS,MAAM,GAAG,CAAC;CACxD,MAAM,MAAM,GAAG,oBAAoB,OAAO,KAAK,GAAG,sBAAsB,EAAE,CAAC,CAAC,KAAK,IAAI;CAErF,OAAO;EACL,MAAM;GAAE,IAAI,KAAK;GAAI,OAAO,KAAK;GAAO,GAAI,GAAG,WAAW,EAAE,SAAS,GAAG,QAAQ;EAAG;EACnF;EACA,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC;EACrB,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC;EAC3B,MAAM,MAAM,QAAQ,IAAI,IAAI,KAAK,QAAQ,QAAuB,OAAO,QAAQ,QAAQ,IAAI,CAAC;EAC5F;EACA,cAAc,OAAO,GAAG,cAAc,KAAK,KAAK;EAChD,UAAU,GAAG,UAAU,QAAQ,cAAc,OAAO,QAAgB,KAAK,IAAI,GAAG,KAAK,SAAS,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK;EACzI,MAAM,KAAK,MAAK,UAAS,MAAM,YAAY,KAAK,CAAC,IAC7C,OAAO,SAAU,UAAU;GAAE,MAAM;GAAO,SAAS,KAAK,KAAI,UAAS,MAAM,OAAO,CAAgB;EAAE,CAAC,CAAC,CAAC,KAAK,IAC5G;CACN;AACF"}
+{"version":3,"file":"ai-brief.js","names":[],"sources":["../../../src/features/composites/ai-brief.ts"],"sourcesContent":["// Vue-free: what one Baustein tells the model (read by „Baustein füllen (KI)“, see `integrations/composite-ai`).\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 { findBlockById } from '../../core/schema/block-ids'\nimport { type CslItem, citeFull } from './bibliography'\nimport { derivationOf } from './derivation'\nimport { compositeKind } from './kinds'\nimport { COMPOSITE_CHROME_COUNT, compositeKindsOf } from './nodes'\n\n/** What one Baustein tells the model: kind brief, place in the hierarchy, chrome, field values, resolved instruction and skeleton, body. */\nexport interface CompositeAiBrief {\n  kind: { id: string, label: string, purpose?: string }\n  /** Titles of the enclosing composites, outermost first (empty at document level). */\n  path: string[]\n  title: string\n  description: string\n  tags: string[]\n  /** Declared fields with a non-empty value, `select` values as their option label. */\n  fields: { key: string, label: string, value: string }[]\n  /** `meta[ai.instructionsField]` when non-empty, else `ai.instructions`, else ''. */\n  instructions: string\n  /** `ai.skeleton` with `{key}` replaced by the string value of `meta[key]` (declared fields only); '' without a skeleton. */\n  skeleton: string\n  /** Body blocks as Markdown ('' for a body without text). */\n  body: string\n}\n\nconst PLACEHOLDER = /\\{([\\p{L}\\p{N}_-]+)\\}/gu\n\nconst isFilled = (value: unknown): value is string | number => (typeof value === 'string' && value !== '') || typeof value === 'number'\n\n/** The brief of the composite at `pos`; null unless the node there is a composite whose kind has `ai`. */\nexport function compositeAiBrief(editor: Editor, pos: number): CompositeAiBrief | null {\n  const node = editor.state.doc.nodeAt(pos)\n  if (node?.type.name !== 'composite' || node.childCount < COMPOSITE_CHROME_COUNT) return null\n  const kind = compositeKind(compositeKindsOf(editor), String(node.attrs.kind))\n  const ai = kind.ai\n  if (!ai) return null\n\n  const $pos = editor.state.doc.resolve(pos)\n  const path: string[] = []\n  for (let depth = 1; depth <= $pos.depth; depth++) {\n    const ancestor = $pos.node(depth)\n    if (ancestor.type.name === 'composite') path.push(ancestor.child(0).textContent.trim())\n  }\n\n  const tags: unknown = node.child(2).attrs.tags\n  const body = Array.from({ length: node.childCount - COMPOSITE_CHROME_COUNT }, (_, i) => node.child(COMPOSITE_CHROME_COUNT + i))\n  const meta: Record<string, unknown> = node.attrs.meta ?? {}\n\n  const fields = kind.fields.flatMap((field) => {\n    const raw = meta[field.key]\n    if (field.type === 'bibliography') {\n      const bib = raw as Partial<CslItem> | null | undefined\n      return bib && typeof bib === 'object' && typeof bib.type === 'string' ? [{ key: field.key, label: field.label, value: citeFull({ ...(bib as CslItem), title: node.child(0).textContent }) }] : []\n    }\n    if (field.type === 'reference') {\n      const target = typeof raw === 'string' && raw ? findBlockById(editor.state.doc, raw)?.node : undefined\n      const title = target?.type.name === 'composite' ? target.child(0).textContent.trim() : ''\n      return title ? [{ key: field.key, label: field.label, value: title }] : []\n    }\n    if (field.type === 'derivation') {\n      const derivation = derivationOf(node)\n      return derivation ? [{ key: field.key, label: field.label, value: `${derivation.method} from ${'asset' in derivation.from ? derivation.from.asset : derivation.from.block}` }] : []\n    }\n    if (!isFilled(raw)) return []\n    const value = String(raw)\n    return [{ key: field.key, label: field.label, value: field.type === 'select' ? (field.options?.find(option => option.value === value)?.label ?? value) : value }]\n  })\n  const keys = new Set(kind.fields.map(field => field.key))\n  const own = ai.instructionsField ? String(meta[ai.instructionsField] ?? '').trim() : ''\n\n  return {\n    kind: { id: kind.id, label: kind.label, ...(ai.purpose && { purpose: ai.purpose }) },\n    path,\n    title: node.child(0).textContent,\n    description: node.child(1).textContent,\n    tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [],\n    fields,\n    instructions: own || ai.instructions?.trim() || '',\n    skeleton: ai.skeleton?.replace(PLACEHOLDER, (match, key: string) => keys.has(key) && isFilled(meta[key]) ? String(meta[key]) : match) ?? '',\n    body: body.some(child => child.textContent.trim())\n      ? editor.markdown!.serialize({ type: 'doc', content: body.map(child => child.toJSON() as JSONContent) }).trim()\n      : '',\n  }\n}\n"],"mappings":"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"}

package/dist/features/composites/bibliography-command.d.ts

@@ -0,0 +1,11 @@
+import "@tiptap/core";
+//#region src/features/composites/bibliography-command.d.ts
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    compositeBibliographyFetch: {
+      /** Fetches the bibliographic data of the Baustein at `pos` into its `meta.bib` (`ai.extract`, method `bibliography`). Registered by `composite-ai`. */
+      fetchCompositeBibliography: (pos: number) => ReturnType;
+    };
+  }
+}
+//# sourceMappingURL=bibliography-command.d.ts.map

package/dist/features/composites/bibliography-form.js

@@ -0,0 +1,90 @@
+import { yearOf } from "./bibliography.js";
+//#region src/features/composites/bibliography-form.ts
+/** Keys of the CSL item the form edits; every other stored key is kept as it is. */
+const MANAGED_KEYS = {
+	"type": true,
+	"author": true,
+	"issued": true,
+	"container-title": true,
+	"volume": true,
+	"issue": true,
+	"page": true,
+	"publisher": true,
+	"DOI": true,
+	"ISBN": true,
+	"URL": true,
+	"abstract": true
+};
+/** Never stored in `meta.bib`: the block id and the title belong to the Baustein. */
+const FOREIGN_KEYS = {
+	id: true,
+	title: true
+};
+/** The names of `authors`, one per non-empty line. */
+function parseAuthors(text) {
+	return text.split("\n").map((line) => line.trim()).filter(Boolean).map((line) => {
+		const comma = line.indexOf(",");
+		if (comma < 0) return { literal: line };
+		const family = line.slice(0, comma).trim();
+		const given = line.slice(comma + 1).trim();
+		return family ? {
+			family,
+			...given && { given }
+		} : { literal: line };
+	});
+}
+/** `names` as the text `parseAuthors` reads back: `Family, Given` per line. */
+function authorsText(names) {
+	return (names ?? []).map((name) => name.family ? name.given ? `${name.family}, ${name.given}` : `${name.family},` : name.literal ?? "").filter(Boolean).join("\n");
+}
+/** The form values of `item`; without an item the defaults of an empty form. */
+function bibFormOf(item) {
+	const year = item ? yearOf(item) : null;
+	return {
+		type: item?.type ?? "article-journal",
+		authors: authorsText(item?.author),
+		year: year === null ? "" : String(year),
+		containerTitle: item?.["container-title"] ?? "",
+		volume: item?.volume ?? "",
+		issue: item?.issue ?? "",
+		page: item?.page ?? "",
+		publisher: item?.publisher ?? "",
+		doi: item?.DOI ?? "",
+		isbn: item?.ISBN ?? "",
+		url: item?.URL ?? "",
+		abstract: item?.abstract ?? ""
+	};
+}
+/**
+* The complete CSL item for `form`: no `title` and no empty strings. Keys the form does not edit (`editor`,
+* `publisher-place`, `language`, …) are taken over from `base`; an unchanged year keeps the stored date parts (month, day).
+*/
+function bibItemOf(form, base) {
+	const text = (value) => value.trim() || void 0;
+	const author = parseAuthors(form.authors);
+	const year = Number.parseInt(form.year, 10);
+	const keptDate = base?.issued && yearOf(base) === year ? base.issued : void 0;
+	const fields = {
+		author: author.length ? author : void 0,
+		issued: Number.isFinite(year) ? keptDate ?? { "date-parts": [[year]] } : void 0,
+		"container-title": text(form.containerTitle),
+		volume: text(form.volume),
+		issue: text(form.issue),
+		page: text(form.page),
+		publisher: text(form.publisher),
+		DOI: text(form.doi),
+		ISBN: text(form.isbn),
+		URL: text(form.url),
+		abstract: text(form.abstract)
+	};
+	const kept = Object.entries(base ?? {}).filter(([key, value]) => !MANAGED_KEYS[key] && !FOREIGN_KEYS[key] && value !== "" && value !== void 0 && value !== null);
+	const entries = [...Object.entries(fields).filter(([, value]) => value !== void 0), ...kept];
+	return {
+		type: form.type,
+		...Object.fromEntries(entries)
+	};
+}
+//#endregion
+export { authorsText, bibFormOf, bibItemOf, parseAuthors };
+
+//# sourceMappingURL=bibliography-form.js.map

package/dist/features/composites/bibliography-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bibliography-form.js","names":[],"sources":["../../../src/features/composites/bibliography-form.ts"],"sourcesContent":["// Vue-free: the form model of the bibliography editor (`BibliographyEditor` on Vue and React) — a CSL item as flat strings and back.\nimport { type CslItem, type CslName, type CslType, yearOf } from './bibliography'\n\n/** The CSL item as the editor's inputs hold it: one string per input. */\nexport interface BibForm {\n  type: CslType\n  /** One person per line: `Family, Given`; a line without a comma is an institution or an unparsed name. */\n  authors: string\n  year: string\n  containerTitle: string\n  volume: string\n  issue: string\n  page: string\n  publisher: string\n  doi: string\n  isbn: string\n  url: string\n  abstract: string\n}\n\n/** Keys of the CSL item the form edits; every other stored key is kept as it is. */\nconst MANAGED_KEYS: Record<string, true> = { 'type': true, 'author': true, 'issued': true, 'container-title': true, 'volume': true, 'issue': true, 'page': true, 'publisher': true, 'DOI': true, 'ISBN': true, 'URL': true, 'abstract': true }\n/** Never stored in `meta.bib`: the block id and the title belong to the Baustein. */\nconst FOREIGN_KEYS: Record<string, true> = { id: true, title: true }\n\n/** The names of `authors`, one per non-empty line. */\nexport function parseAuthors(text: string): CslName[] {\n  return text.split('\\n').map(line => line.trim()).filter(Boolean).map((line) => {\n    const comma = line.indexOf(',')\n    if (comma < 0) return { literal: line }\n    const family = line.slice(0, comma).trim()\n    const given = line.slice(comma + 1).trim()\n    return family ? { family, ...(given && { given }) } : { literal: line }\n  })\n}\n\n/** `names` as the text `parseAuthors` reads back: `Family, Given` per line. */\nexport function authorsText(names: readonly CslName[] | undefined): string {\n  return (names ?? []).map(name => name.family ? (name.given ? `${name.family}, ${name.given}` : `${name.family},`) : (name.literal ?? '')).filter(Boolean).join('\\n')\n}\n\n/** The form values of `item`; without an item the defaults of an empty form. */\nexport function bibFormOf(item: CslItem | null | undefined): BibForm {\n  const year = item ? yearOf(item) : null\n  return {\n    type: item?.type ?? 'article-journal',\n    authors: authorsText(item?.author),\n    year: year === null ? '' : String(year),\n    containerTitle: item?.['container-title'] ?? '',\n    volume: item?.volume ?? '',\n    issue: item?.issue ?? '',\n    page: item?.page ?? '',\n    publisher: item?.publisher ?? '',\n    doi: item?.DOI ?? '',\n    isbn: item?.ISBN ?? '',\n    url: item?.URL ?? '',\n    abstract: item?.abstract ?? '',\n  }\n}\n\n/**\n * The complete CSL item for `form`: no `title` and no empty strings. Keys the form does not edit (`editor`,\n * `publisher-place`, `language`, …) are taken over from `base`; an unchanged year keeps the stored date parts (month, day).\n */\nexport function bibItemOf(form: BibForm, base?: CslItem | null): CslItem {\n  const text = (value: string) => value.trim() || undefined\n  const author = parseAuthors(form.authors)\n  const year = Number.parseInt(form.year, 10)\n  const keptDate = base?.issued && yearOf(base) === year ? base.issued : undefined\n  const fields: Record<string, unknown> = {\n    author: author.length ? author : undefined,\n    issued: Number.isFinite(year) ? (keptDate ?? { 'date-parts': [[year]] }) : undefined,\n    'container-title': text(form.containerTitle),\n    volume: text(form.volume),\n    issue: text(form.issue),\n    page: text(form.page),\n    publisher: text(form.publisher),\n    DOI: text(form.doi),\n    ISBN: text(form.isbn),\n    URL: text(form.url),\n    abstract: text(form.abstract),\n  }\n  const kept = Object.entries(base ?? {}).filter(([key, value]) => !MANAGED_KEYS[key] && !FOREIGN_KEYS[key] && value !== '' && value !== undefined && value !== null)\n  const entries = [...Object.entries(fields).filter(([, value]) => value !== undefined), ...kept]\n  return { type: form.type, ...Object.fromEntries(entries) }\n}\n"],"mappings":";;;AAqBA,MAAM,eAAqC;CAAE,QAAQ;CAAM,UAAU;CAAM,UAAU;CAAM,mBAAmB;CAAM,UAAU;CAAM,SAAS;CAAM,QAAQ;CAAM,aAAa;CAAM,OAAO;CAAM,QAAQ;CAAM,OAAO;CAAM,YAAY;AAAK;;AAE7O,MAAM,eAAqC;CAAE,IAAI;CAAM,OAAO;AAAK;;AAGnE,SAAgB,aAAa,MAAyB;CACpD,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,KAAI,SAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,SAAS;EAC7E,MAAM,QAAQ,KAAK,QAAQ,GAAG;EAC9B,IAAI,QAAQ,GAAG,OAAO,EAAE,SAAS,KAAK;EACtC,MAAM,SAAS,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK;EACzC,MAAM,QAAQ,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK;EACzC,OAAO,SAAS;GAAE;GAAQ,GAAI,SAAS,EAAE,MAAM;EAAG,IAAI,EAAE,SAAS,KAAK;CACxE,CAAC;AACH;;AAGA,SAAgB,YAAY,OAA+C;CACzE,QAAQ,SAAS,CAAC,EAAA,CAAG,KAAI,SAAQ,KAAK,SAAU,KAAK,QAAQ,GAAG,KAAK,OAAO,IAAI,KAAK,UAAU,GAAG,KAAK,OAAO,KAAO,KAAK,WAAW,EAAG,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;AACrK;;AAGA,SAAgB,UAAU,MAA2C;CACnE,MAAM,OAAO,OAAO,OAAO,IAAI,IAAI;CACnC,OAAO;EACL,MAAM,MAAM,QAAQ;EACpB,SAAS,YAAY,MAAM,MAAM;EACjC,MAAM,SAAS,OAAO,KAAK,OAAO,IAAI;EACtC,gBAAgB,OAAO,sBAAsB;EAC7C,QAAQ,MAAM,UAAU;EACxB,OAAO,MAAM,SAAS;EACtB,MAAM,MAAM,QAAQ;EACpB,WAAW,MAAM,aAAa;EAC9B,KAAK,MAAM,OAAO;EAClB,MAAM,MAAM,QAAQ;EACpB,KAAK,MAAM,OAAO;EAClB,UAAU,MAAM,YAAY;CAC9B;AACF;;;;;AAMA,SAAgB,UAAU,MAAe,MAAgC;CACvE,MAAM,QAAQ,UAAkB,MAAM,KAAK,KAAK,KAAA;CAChD,MAAM,SAAS,aAAa,KAAK,OAAO;CACxC,MAAM,OAAO,OAAO,SAAS,KAAK,MAAM,EAAE;CAC1C,MAAM,WAAW,MAAM,UAAU,OAAO,IAAI,MAAM,OAAO,KAAK,SAAS,KAAA;CACvE,MAAM,SAAkC;EACtC,QAAQ,OAAO,SAAS,SAAS,KAAA;EACjC,QAAQ,OAAO,SAAS,IAAI,IAAK,YAAY,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,IAAK,KAAA;EAC3E,mBAAmB,KAAK,KAAK,cAAc;EAC3C,QAAQ,KAAK,KAAK,MAAM;EACxB,OAAO,KAAK,KAAK,KAAK;EACtB,MAAM,KAAK,KAAK,IAAI;EACpB,WAAW,KAAK,KAAK,SAAS;EAC9B,KAAK,KAAK,KAAK,GAAG;EAClB,MAAM,KAAK,KAAK,IAAI;EACpB,KAAK,KAAK,KAAK,GAAG;EAClB,UAAU,KAAK,KAAK,QAAQ;CAC9B;CACA,MAAM,OAAO,OAAO,QAAQ,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,WAAW,CAAC,aAAa,QAAQ,CAAC,aAAa,QAAQ,UAAU,MAAM,UAAU,KAAA,KAAa,UAAU,IAAI;CAClK,MAAM,UAAU,CAAC,GAAG,OAAO,QAAQ,MAAM,CAAC,CAAC,QAAQ,GAAG,WAAW,UAAU,KAAA,CAAS,GAAG,GAAG,IAAI;CAC9F,OAAO;EAAE,MAAM,KAAK;EAAM,GAAG,OAAO,YAAY,OAAO;CAAE;AAC3D"}

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

@@ -0,0 +1,33 @@
+import { Translate } from "../../i18n/index.js";
+import { CSL_TYPES, CslDate, CslItem, CslName, CslType } from "../../core/backend-types.js";
+import { BIB_KEY } from "./meta-keys.js";
+import { Node } from "@tiptap/pm/model";
+//#region src/features/composites/bibliography.d.ts
+/** The select options of the CSL types, labelled through `t`. */
+export declare function cslTypeOptions(t: Translate): {
+  value: CslType;
+  label: string;
+}[];
+/** The bibliographic data of the composite `node` (`meta.bib` when an object with a string `type`), else `null`. */
+export declare function bibOf(node: Node): CslItem | null;
+/** The full CSL-JSON item of the composite `node`: its `bib` plus the block id and the title (first child). */
+export declare function cslOf(node: Node): (CslItem & {
+  id: string;
+  title: string;
+}) | null;
+/** The year of the first date part of `issued`, or `null`. */
+export declare function yearOf(csl: Pick<CslItem, 'issued'>): number | null;
+/** "Doe 2024", "Doe & Roe 2024", "Doe et al. 2024"; without authors the first 40 characters of `title`; without a year no year. */
+export declare function citeShort(csl: Pick<CslItem, 'author' | 'issued'>, title: string): string;
+/** An APA-like reference: "Doe, J., Roe, R. (2024). Title. Journal, 12(3), 45–67. https://doi.org/…"; empty parts are left out. */
+export declare function citeFull(csl: CslItem & {
+  title: string;
+}): string;
+/** The item as one BibTeX entry (`@article{doe2024title, … }`), one field per line; empty fields are left out. */
+export declare function bibtexOf(csl: CslItem & {
+  id: string;
+  title: string;
+}): string;
+//#endregion
+export { BIB_KEY, CSL_TYPES, type CslDate, type CslItem, type CslName, type CslType };
+//# sourceMappingURL=bibliography.d.ts.map

package/dist/features/composites/bibliography.js

@@ -0,0 +1,120 @@
+import { blockIdOf } from "../../core/schema/block-ids.js";
+import { BIB_KEY } from "./meta-keys.js";
+import { CSL_TYPES } from "../../core/backend-types.js";
+//#region src/features/composites/bibliography.ts
+/** The select options of the CSL types, labelled through `t`. */
+function cslTypeOptions(t) {
+	return CSL_TYPES.map((value) => ({
+		value,
+		label: t(`composites.bib.type.${value}`)
+	}));
+}
+/** The bibliographic data of the composite `node` (`meta.bib` when an object with a string `type`), else `null`. */
+function bibOf(node) {
+	const bib = node.attrs.meta?.["bib"];
+	if (!bib || typeof bib !== "object" || Array.isArray(bib)) return null;
+	return "type" in bib && typeof bib.type === "string" ? bib : null;
+}
+/** The full CSL-JSON item of the composite `node`: its `bib` plus the block id and the title (first child). */
+function cslOf(node) {
+	const bib = bibOf(node);
+	if (!bib) return null;
+	return {
+		...bib,
+		id: blockIdOf(node) ?? "",
+		title: node.childCount > 0 ? node.child(0).textContent : ""
+	};
+}
+/** The year of the first date part of `issued`, or `null`. */
+function yearOf(csl) {
+	const year = csl.issued?.["date-parts"]?.[0]?.[0];
+	return typeof year === "number" && Number.isFinite(year) ? year : null;
+}
+const familyOf = (name) => (name.family ?? name.literal ?? "").trim();
+const SHORT_TITLE_LENGTH = 40;
+/** "Doe 2024", "Doe & Roe 2024", "Doe et al. 2024"; without authors the first 40 characters of `title`; without a year no year. */
+function citeShort(csl, title) {
+	const families = (csl.author ?? []).map(familyOf).filter(Boolean);
+	const who = families.length === 0 ? title.trim().slice(0, SHORT_TITLE_LENGTH) : families.length === 1 ? families[0] : families.length === 2 ? `${families[0]} & ${families[1]}` : `${families[0]} et al.`;
+	const year = yearOf(csl);
+	return year === null ? who : `${who} ${year}`.trim();
+}
+const initialsOf = (given) => given.split(/[\s-]+/).filter(Boolean).map((word) => `${[...word][0].toUpperCase()}.`).join(" ");
+function apaName(name) {
+	const family = (name.family ?? "").trim();
+	if (!family) return (name.literal ?? "").trim();
+	const initials = initialsOf((name.given ?? "").trim());
+	return initials ? `${family}, ${initials}` : family;
+}
+const withStop = (text) => /[.!?]$/.test(text) ? text : `${text}.`;
+/** An APA-like reference: "Doe, J., Roe, R. (2024). Title. Journal, 12(3), 45–67. https://doi.org/…"; empty parts are left out. */
+function citeFull(csl) {
+	const authors = (csl.author ?? []).map(apaName).filter(Boolean).join(", ");
+	const year = yearOf(csl);
+	const head = [authors, year === null ? "" : `(${year})`].filter(Boolean).join(" ");
+	const volume = [csl.volume, csl.issue ? `(${csl.issue})` : ""].filter(Boolean).join("");
+	const container = [
+		csl["container-title"],
+		volume,
+		csl.page
+	].map((part) => part?.trim()).filter(Boolean).join(", ");
+	const doi = csl.DOI?.trim();
+	const link = doi ? /^https?:\/\//i.test(doi) ? doi : `https://doi.org/${doi}` : csl.URL?.trim();
+	const publisher = [csl["publisher-place"], csl.publisher].map((part) => part?.trim()).filter(Boolean).join(": ");
+	return [
+		head && withStop(head),
+		csl.title.trim() && withStop(csl.title.trim()),
+		container && withStop(container),
+		!container && publisher && withStop(publisher),
+		link
+	].filter(Boolean).join(" ");
+}
+const BIBTEX_ENTRY = {
+	"article-journal": "article",
+	book: "book",
+	chapter: "incollection",
+	"paper-conference": "inproceedings",
+	thesis: "phdthesis",
+	report: "techreport"
+};
+/** Lowercase ASCII letters and digits of `text`: diacritics folded, everything else dropped. */
+const asciiKey = (text) => text.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^a-z0-9]/g, "");
+const bibtexName = (name) => {
+	const family = (name.family ?? "").trim();
+	if (!family) return (name.literal ?? "").trim();
+	const given = (name.given ?? "").trim();
+	return given ? `${family}, ${given}` : family;
+};
+/** The citation key: first author's family name + year + first title word (all lowercase ASCII). */
+function bibtexKey(csl) {
+	const first = csl.author?.[0];
+	const family = first ? asciiKey(familyOf(first)) : "";
+	const year = yearOf(csl);
+	const word = asciiKey(csl.title.trim().split(/\s+/)[0] ?? "");
+	return `${family}${year ?? ""}${word}` || asciiKey(csl.id) || "ref";
+}
+/** The item as one BibTeX entry (`@article{doe2024title, … }`), one field per line; empty fields are left out. */
+function bibtexOf(csl) {
+	const entry = BIBTEX_ENTRY[csl.type] ?? "misc";
+	const container = csl["container-title"]?.trim();
+	const lines = [
+		["title", csl.title.trim()],
+		["author", (csl.author ?? []).map(bibtexName).filter(Boolean).join(" and ")],
+		["year", yearOf(csl)?.toString()],
+		["journal", entry === "article" ? container : void 0],
+		["booktitle", entry === "incollection" || entry === "inproceedings" ? container : void 0],
+		["volume", csl.volume?.trim()],
+		["number", csl.issue?.trim()],
+		["pages", csl.page?.trim().replace(/\s*[-–—]+\s*/g, "--")],
+		[entry === "phdthesis" ? "school" : entry === "techreport" ? "institution" : "publisher", csl.publisher?.trim()],
+		["address", csl["publisher-place"]?.trim()],
+		["doi", csl.DOI?.trim()],
+		["isbn", csl.ISBN?.trim()],
+		["url", csl.URL?.trim()]
+	].filter(([, value]) => value).map(([name, value]) => `  ${name} = {${value}},`);
+	return `@${entry}{${bibtexKey(csl)},\n${lines.join("\n")}\n}\n`;
+}
+//#endregion
+export { BIB_KEY, CSL_TYPES, bibOf, bibtexOf, citeFull, citeShort, cslOf, cslTypeOptions, yearOf };
+
+//# sourceMappingURL=bibliography.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bibliography.js","names":[],"sources":["../../../src/features/composites/bibliography.ts"],"sourcesContent":["// Vue-free and server-importable: bibliographic data of a composite („Baustein“) as CSL-JSON in `meta.bib`, and its citation and BibTeX renderings.\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { blockIdOf } from '../../core/schema/block-ids'\nimport type { MessageKey, Translate } from '../../i18n'\nimport { CSL_TYPES, type CslItem, type CslName, type CslType } from '../../core/backend-types'\nimport { BIB_KEY } from './meta-keys'\n\n// The CSL types live in `core/backend-types.ts` (the `ai.extract` wire type names them); this module is their feature-side entry.\nexport { CSL_TYPES, type CslDate, type CslItem, type CslName, type CslType } from '../../core/backend-types'\n\nexport { BIB_KEY }\n\n/** The select options of the CSL types, labelled through `t`. */\nexport function cslTypeOptions(t: Translate): { value: CslType, label: string }[] {\n  return CSL_TYPES.map(value => ({ value, label: t(`composites.bib.type.${value}` as MessageKey) }))\n}\n\n/** The bibliographic data of the composite `node` (`meta.bib` when an object with a string `type`), else `null`. */\nexport function bibOf(node: PMNode): CslItem | null {\n  const bib: unknown = node.attrs.meta?.[BIB_KEY]\n  if (!bib || typeof bib !== 'object' || Array.isArray(bib)) return null\n  return 'type' in bib && typeof bib.type === 'string' ? bib as CslItem : null\n}\n\n/** The full CSL-JSON item of the composite `node`: its `bib` plus the block id and the title (first child). */\nexport function cslOf(node: PMNode): (CslItem & { id: string, title: string }) | null {\n  const bib = bibOf(node)\n  if (!bib) return null\n  return { ...bib, id: blockIdOf(node) ?? '', title: node.childCount > 0 ? node.child(0).textContent : '' }\n}\n\n/** The year of the first date part of `issued`, or `null`. */\nexport function yearOf(csl: Pick<CslItem, 'issued'>): number | null {\n  const year = csl.issued?.['date-parts']?.[0]?.[0]\n  return typeof year === 'number' && Number.isFinite(year) ? year : null\n}\n\nconst familyOf = (name: CslName): string => (name.family ?? name.literal ?? '').trim()\n\nconst SHORT_TITLE_LENGTH = 40\n\n/** \"Doe 2024\", \"Doe & Roe 2024\", \"Doe et al. 2024\"; without authors the first 40 characters of `title`; without a year no year. */\nexport function citeShort(csl: Pick<CslItem, 'author' | 'issued'>, title: string): string {\n  const families = (csl.author ?? []).map(familyOf).filter(Boolean)\n  const who = families.length === 0\n    ? title.trim().slice(0, SHORT_TITLE_LENGTH)\n    : families.length === 1\n      ? families[0]!\n      : families.length === 2 ? `${families[0]} & ${families[1]}` : `${families[0]} et al.`\n  const year = yearOf(csl)\n  return year === null ? who : `${who} ${year}`.trim()\n}\n\nconst initialsOf = (given: string): string => given.split(/[\\s-]+/).filter(Boolean).map(word => `${[...word][0]!.toUpperCase()}.`).join(' ')\n\nfunction apaName(name: CslName): string {\n  const family = (name.family ?? '').trim()\n  if (!family) return (name.literal ?? '').trim()\n  const initials = initialsOf((name.given ?? '').trim())\n  return initials ? `${family}, ${initials}` : family\n}\n\nconst withStop = (text: string): string => /[.!?]$/.test(text) ? text : `${text}.`\n\n/** An APA-like reference: \"Doe, J., Roe, R. (2024). Title. Journal, 12(3), 45–67. https://doi.org/…\"; empty parts are left out. */\nexport function citeFull(csl: CslItem & { title: string }): string {\n  const authors = (csl.author ?? []).map(apaName).filter(Boolean).join(', ')\n  const year = yearOf(csl)\n  const head = [authors, year === null ? '' : `(${year})`].filter(Boolean).join(' ')\n  const volume = [csl.volume, csl.issue ? `(${csl.issue})` : ''].filter(Boolean).join('')\n  const container = [csl['container-title'], volume, csl.page].map(part => part?.trim()).filter(Boolean).join(', ')\n  const doi = csl.DOI?.trim()\n  const link = doi ? (/^https?:\\/\\//i.test(doi) ? doi : `https://doi.org/${doi}`) : csl.URL?.trim()\n  const publisher = [csl['publisher-place'], csl.publisher].map(part => part?.trim()).filter(Boolean).join(': ')\n  return [\n    head && withStop(head),\n    csl.title.trim() && withStop(csl.title.trim()),\n    container && withStop(container),\n    // A book or report is located by its publisher; a journal article by its container.\n    !container && publisher && withStop(publisher),\n    link,\n  ].filter(Boolean).join(' ')\n}\n\nconst BIBTEX_ENTRY: Partial<Record<CslType, string>> = {\n  'article-journal': 'article',\n  book: 'book',\n  chapter: 'incollection',\n  'paper-conference': 'inproceedings',\n  thesis: 'phdthesis',\n  report: 'techreport',\n}\n\n/** Lowercase ASCII letters and digits of `text`: diacritics folded, everything else dropped. */\nconst asciiKey = (text: string): string => text.normalize('NFD').replace(/\\p{M}/gu, '').toLowerCase().replace(/[^a-z0-9]/g, '')\n\nconst bibtexName = (name: CslName): string => {\n  const family = (name.family ?? '').trim()\n  if (!family) return (name.literal ?? '').trim()\n  const given = (name.given ?? '').trim()\n  return given ? `${family}, ${given}` : family\n}\n\n/** The citation key: first author's family name + year + first title word (all lowercase ASCII). */\nfunction bibtexKey(csl: CslItem & { id: string, title: string }): string {\n  const first = csl.author?.[0]\n  const family = first ? asciiKey(familyOf(first)) : ''\n  const year = yearOf(csl)\n  const word = asciiKey(csl.title.trim().split(/\\s+/)[0] ?? '')\n  return `${family}${year ?? ''}${word}` || asciiKey(csl.id) || 'ref'\n}\n\n/** The item as one BibTeX entry (`@article{doe2024title, … }`), one field per line; empty fields are left out. */\nexport function bibtexOf(csl: CslItem & { id: string, title: string }): string {\n  const entry = BIBTEX_ENTRY[csl.type] ?? 'misc'\n  const container = csl['container-title']?.trim()\n  const fields: [string, string | undefined][] = [\n    ['title', csl.title.trim()],\n    ['author', (csl.author ?? []).map(bibtexName).filter(Boolean).join(' and ')],\n    ['year', yearOf(csl)?.toString()],\n    ['journal', entry === 'article' ? container : undefined],\n    ['booktitle', entry === 'incollection' || entry === 'inproceedings' ? container : undefined],\n    ['volume', csl.volume?.trim()],\n    ['number', csl.issue?.trim()],\n    ['pages', csl.page?.trim().replace(/\\s*[-–—]+\\s*/g, '--')],\n    [entry === 'phdthesis' ? 'school' : entry === 'techreport' ? 'institution' : 'publisher', csl.publisher?.trim()],\n    ['address', csl['publisher-place']?.trim()],\n    ['doi', csl.DOI?.trim()],\n    ['isbn', csl.ISBN?.trim()],\n    ['url', csl.URL?.trim()],\n  ]\n  const lines = fields.filter(([, value]) => value).map(([name, value]) => `  ${name} = {${value}},`)\n  return `@${entry}{${bibtexKey(csl)},\\n${lines.join('\\n')}\\n}\\n`\n}\n"],"mappings":";;;;;AAaA,SAAgB,eAAe,GAAmD;CAChF,OAAO,UAAU,KAAI,WAAU;EAAE;EAAO,OAAO,EAAE,uBAAuB,OAAqB;CAAE,EAAE;AACnG;;AAGA,SAAgB,MAAM,MAA8B;CAClD,MAAM,MAAe,KAAK,MAAM,OAAA;CAChC,IAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG,OAAO;CAClE,OAAO,UAAU,OAAO,OAAO,IAAI,SAAS,WAAW,MAAiB;AAC1E;;AAGA,SAAgB,MAAM,MAAgE;CACpF,MAAM,MAAM,MAAM,IAAI;CACtB,IAAI,CAAC,KAAK,OAAO;CACjB,OAAO;EAAE,GAAG;EAAK,IAAI,UAAU,IAAI,KAAK;EAAI,OAAO,KAAK,aAAa,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc;CAAG;AAC1G;;AAGA,SAAgB,OAAO,KAA6C;CAClE,MAAM,OAAO,IAAI,SAAS,aAAa,GAAG,EAAE,GAAG;CAC/C,OAAO,OAAO,SAAS,YAAY,OAAO,SAAS,IAAI,IAAI,OAAO;AACpE;AAEA,MAAM,YAAY,UAA2B,KAAK,UAAU,KAAK,WAAW,GAAA,CAAI,KAAK;AAErF,MAAM,qBAAqB;;AAG3B,SAAgB,UAAU,KAAyC,OAAuB;CACxF,MAAM,YAAY,IAAI,UAAU,CAAC,EAAA,CAAG,IAAI,QAAQ,CAAC,CAAC,OAAO,OAAO;CAChE,MAAM,MAAM,SAAS,WAAW,IAC5B,MAAM,KAAK,CAAC,CAAC,MAAM,GAAG,kBAAkB,IACxC,SAAS,WAAW,IAClB,SAAS,KACT,SAAS,WAAW,IAAI,GAAG,SAAS,GAAG,KAAK,SAAS,OAAO,GAAG,SAAS,GAAG;CACjF,MAAM,OAAO,OAAO,GAAG;CACvB,OAAO,SAAS,OAAO,MAAM,GAAG,IAAI,GAAG,OAAO,KAAK;AACrD;AAEA,MAAM,cAAc,UAA0B,MAAM,MAAM,QAAQ,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAI,SAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAE,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG;AAE3I,SAAS,QAAQ,MAAuB;CACtC,MAAM,UAAU,KAAK,UAAU,GAAA,CAAI,KAAK;CACxC,IAAI,CAAC,QAAQ,QAAQ,KAAK,WAAW,GAAA,CAAI,KAAK;CAC9C,MAAM,WAAW,YAAY,KAAK,SAAS,GAAA,CAAI,KAAK,CAAC;CACrD,OAAO,WAAW,GAAG,OAAO,IAAI,aAAa;AAC/C;AAEA,MAAM,YAAY,SAAyB,SAAS,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK;;AAGhF,SAAgB,SAAS,KAA0C;CACjE,MAAM,WAAW,IAAI,UAAU,CAAC,EAAA,CAAG,IAAI,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CACzE,MAAM,OAAO,OAAO,GAAG;CACvB,MAAM,OAAO,CAAC,SAAS,SAAS,OAAO,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;CACjF,MAAM,SAAS,CAAC,IAAI,QAAQ,IAAI,QAAQ,IAAI,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,EAAE;CACtF,MAAM,YAAY;EAAC,IAAI;EAAoB;EAAQ,IAAI;CAAI,CAAC,CAAC,KAAI,SAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CAChH,MAAM,MAAM,IAAI,KAAK,KAAK;CAC1B,MAAM,OAAO,MAAO,gBAAgB,KAAK,GAAG,IAAI,MAAM,mBAAmB,QAAS,IAAI,KAAK,KAAK;CAChG,MAAM,YAAY,CAAC,IAAI,oBAAoB,IAAI,SAAS,CAAC,CAAC,KAAI,SAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,IAAI;CAC7G,OAAO;EACL,QAAQ,SAAS,IAAI;EACrB,IAAI,MAAM,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,CAAC;EAC7C,aAAa,SAAS,SAAS;EAE/B,CAAC,aAAa,aAAa,SAAS,SAAS;EAC7C;CACF,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;AAC5B;AAEA,MAAM,eAAiD;CACrD,mBAAmB;CACnB,MAAM;CACN,SAAS;CACT,oBAAoB;CACpB,QAAQ;CACR,QAAQ;AACV;;AAGA,MAAM,YAAY,SAAyB,KAAK,UAAU,KAAK,CAAC,CAAC,QAAQ,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,cAAc,EAAE;AAE9H,MAAM,cAAc,SAA0B;CAC5C,MAAM,UAAU,KAAK,UAAU,GAAA,CAAI,KAAK;CACxC,IAAI,CAAC,QAAQ,QAAQ,KAAK,WAAW,GAAA,CAAI,KAAK;CAC9C,MAAM,SAAS,KAAK,SAAS,GAAA,CAAI,KAAK;CACtC,OAAO,QAAQ,GAAG,OAAO,IAAI,UAAU;AACzC;;AAGA,SAAS,UAAU,KAAsD;CACvE,MAAM,QAAQ,IAAI,SAAS;CAC3B,MAAM,SAAS,QAAQ,SAAS,SAAS,KAAK,CAAC,IAAI;CACnD,MAAM,OAAO,OAAO,GAAG;CACvB,MAAM,OAAO,SAAS,IAAI,MAAM,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE;CAC5D,OAAO,GAAG,SAAS,QAAQ,KAAK,UAAU,SAAS,IAAI,EAAE,KAAK;AAChE;;AAGA,SAAgB,SAAS,KAAsD;CAC7E,MAAM,QAAQ,aAAa,IAAI,SAAS;CACxC,MAAM,YAAY,IAAI,kBAAkB,EAAE,KAAK;CAgB/C,MAAM,QAAQ;EAdZ,CAAC,SAAS,IAAI,MAAM,KAAK,CAAC;EAC1B,CAAC,WAAW,IAAI,UAAU,CAAC,EAAA,CAAG,IAAI,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC;EAC3E,CAAC,QAAQ,OAAO,GAAG,CAAC,EAAE,SAAS,CAAC;EAChC,CAAC,WAAW,UAAU,YAAY,YAAY,KAAA,CAAS;EACvD,CAAC,aAAa,UAAU,kBAAkB,UAAU,kBAAkB,YAAY,KAAA,CAAS;EAC3F,CAAC,UAAU,IAAI,QAAQ,KAAK,CAAC;EAC7B,CAAC,UAAU,IAAI,OAAO,KAAK,CAAC;EAC5B,CAAC,SAAS,IAAI,MAAM,KAAK,CAAC,CAAC,QAAQ,iBAAiB,IAAI,CAAC;EACzD,CAAC,UAAU,cAAc,WAAW,UAAU,eAAe,gBAAgB,aAAa,IAAI,WAAW,KAAK,CAAC;EAC/G,CAAC,WAAW,IAAI,kBAAkB,EAAE,KAAK,CAAC;EAC1C,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC;EACvB,CAAC,QAAQ,IAAI,MAAM,KAAK,CAAC;EACzB,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC;CAEN,CAAC,CAAC,QAAQ,GAAG,WAAW,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,WAAW,KAAK,KAAK,MAAM,MAAM,GAAG;CAClG,OAAO,IAAI,MAAM,GAAG,UAAU,GAAG,EAAE,KAAK,MAAM,KAAK,IAAI,EAAE;AAC3D"}