@ecsplico/editor 2.1.2 → 3.1.0

package/dist/features/composites/react/DerivationBadge.js

@@ -0,0 +1,116 @@
+import { derivationOf } from "../derivation.js";
+import { useEditorI18n } from "../../../react/use-editor-i18n.js";
+import { cn } from "../../../react/ui/utils.js";
+import { Icon } from "../../../react/Icon.js";
+import { derivationDetailsOf, derivationMethodLabel } from "../derived-chrome.js";
+import { formatDate } from "../meta-display.js";
+import { useMemo } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/features/composites/react/DerivationBadge.tsx
+const CHIP = "inline-flex h-5 shrink-0 items-center gap-1 rounded-sm px-1.5 text-xs leading-none whitespace-nowrap";
+/**
+* Where a derived Baustein comes from. Compact (the `derivation` field type): the „abgeleitet“ badge with method and
+* date. `detailed` (the details card): also the model, whether the source changed („Quelle geändert“), whether the body
+* was edited since it was generated („bearbeitet“) and a link to the stored raw output. The detailed variant hashes
+* the body, so it belongs only where one Baustein is shown.
+*/
+function DerivationBadge({ editor, node, detailed }) {
+	const { t } = useEditorI18n();
+	const derivation = derivationOf(node);
+	const details = useMemo(() => detailed ? derivationDetailsOf(editor, node) : null, [
+		detailed,
+		editor,
+		node
+	]);
+	if (!derivation) return null;
+	const method = derivationMethodLabel(t, derivation.method);
+	const created = derivation.createdAt ? formatDate(derivation.createdAt) : "";
+	if (!detailed) return /* @__PURE__ */ jsxs("div", {
+		className: "flex min-w-0 items-center gap-1.5 text-xs text-muted-foreground",
+		children: [/* @__PURE__ */ jsx(Icon, {
+			name: "i-lucide-git-branch",
+			className: "size-3.5 shrink-0"
+		}), /* @__PURE__ */ jsx("span", {
+			className: "truncate",
+			children: [
+				t("composites.derivation.badge"),
+				method,
+				created
+			].filter(Boolean).join(" · ")
+		})]
+	});
+	if (!details) return null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col gap-1.5 rounded-md p-2 text-xs ring-1 ring-border",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-wrap items-center gap-1",
+				children: [
+					/* @__PURE__ */ jsxs("span", {
+						className: cn(CHIP, "text-muted-foreground"),
+						children: [/* @__PURE__ */ jsx(Icon, {
+							name: "i-lucide-git-branch",
+							className: "size-3.5"
+						}), t("composites.derivation.badge")]
+					}),
+					details.stale && /* @__PURE__ */ jsxs("span", {
+						className: cn(CHIP, "text-(--sk-warning)"),
+						children: [/* @__PURE__ */ jsx(Icon, {
+							name: "i-lucide-triangle-alert",
+							className: "size-3.5"
+						}), t("composites.derivation.stale")]
+					}),
+					details.edited && /* @__PURE__ */ jsxs("span", {
+						className: cn(CHIP, "text-muted-foreground"),
+						children: [/* @__PURE__ */ jsx(Icon, {
+							name: "i-lucide-pencil",
+							className: "size-3.5"
+						}), t("composites.derivation.edited")]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("dl", {
+				className: "grid grid-cols-[auto_1fr] gap-x-2 gap-y-0.5",
+				children: [
+					/* @__PURE__ */ jsx("dt", {
+						className: "text-muted-foreground",
+						children: t("composites.derivation.method")
+					}),
+					/* @__PURE__ */ jsx("dd", {
+						className: "truncate text-foreground",
+						children: method
+					}),
+					derivation.model && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("dt", {
+						className: "text-muted-foreground",
+						children: t("composites.derivation.model")
+					}), /* @__PURE__ */ jsx("dd", {
+						className: "truncate text-foreground",
+						title: derivation.model,
+						children: derivation.model
+					})] }),
+					created && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("dt", {
+						className: "text-muted-foreground",
+						children: t("composites.derivation.createdAt")
+					}), /* @__PURE__ */ jsx("dd", {
+						className: "text-foreground",
+						children: created
+					})] })
+				]
+			}),
+			details.outputUrl && /* @__PURE__ */ jsxs("a", {
+				href: details.outputUrl,
+				target: "_blank",
+				rel: "noopener",
+				className: "inline-flex w-fit items-center gap-1 text-primary hover:underline",
+				children: [/* @__PURE__ */ jsx(Icon, {
+					name: "i-lucide-external-link",
+					className: "size-3.5"
+				}), t("composites.derivation.openOutput")]
+			})
+		]
+	});
+}
+//#endregion
+export { DerivationBadge };
+
+//# sourceMappingURL=DerivationBadge.js.map

package/dist/features/composites/react/DerivationBadge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DerivationBadge.js","names":[],"sources":["../../../../src/features/composites/react/DerivationBadge.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as ProseMirrorNode } from '@tiptap/pm/model'\nimport { useMemo } from 'react'\nimport { Icon } from '../../../react/Icon'\nimport { cn } from '../../../react/ui/utils'\nimport { useEditorI18n } from '../../../react/use-editor-i18n'\nimport { derivationOf } from '../derivation'\nimport { derivationDetailsOf, derivationMethodLabel } from '../derived-chrome'\nimport { formatDate } from '../meta-display'\n\nconst CHIP = 'inline-flex h-5 shrink-0 items-center gap-1 rounded-sm px-1.5 text-xs leading-none whitespace-nowrap'\n\n/**\n * Where a derived Baustein comes from. Compact (the `derivation` field type): the „abgeleitet“ badge with method and\n * date. `detailed` (the details card): also the model, whether the source changed („Quelle geändert“), whether the body\n * was edited since it was generated („bearbeitet“) and a link to the stored raw output. The detailed variant hashes\n * the body, so it belongs only where one Baustein is shown.\n */\nexport function DerivationBadge({ editor, node, detailed }: { editor: Editor, node: ProseMirrorNode, detailed?: boolean }) {\n  const { t } = useEditorI18n()\n  const derivation = derivationOf(node)\n  const details = useMemo(() => detailed ? derivationDetailsOf(editor, node) : null, [detailed, editor, node])\n  if (!derivation) return null\n  const method = derivationMethodLabel(t, derivation.method)\n  const created = derivation.createdAt ? formatDate(derivation.createdAt) : ''\n\n  if (!detailed) {\n    return (\n      <div className=\"flex min-w-0 items-center gap-1.5 text-xs text-muted-foreground\">\n        <Icon name=\"i-lucide-git-branch\" className=\"size-3.5 shrink-0\" />\n        <span className=\"truncate\">{[t('composites.derivation.badge'), method, created].filter(Boolean).join(' · ')}</span>\n      </div>\n    )\n  }\n  if (!details) return null\n\n  return (\n    <div className=\"flex flex-col gap-1.5 rounded-md p-2 text-xs ring-1 ring-border\">\n      <div className=\"flex flex-wrap items-center gap-1\">\n        <span className={cn(CHIP, 'text-muted-foreground')}>\n          <Icon name=\"i-lucide-git-branch\" className=\"size-3.5\" />{t('composites.derivation.badge')}\n        </span>\n        {details.stale && (\n          <span className={cn(CHIP, 'text-(--sk-warning)')}>\n            <Icon name=\"i-lucide-triangle-alert\" className=\"size-3.5\" />{t('composites.derivation.stale')}\n          </span>\n        )}\n        {details.edited && (\n          <span className={cn(CHIP, 'text-muted-foreground')}>\n            <Icon name=\"i-lucide-pencil\" className=\"size-3.5\" />{t('composites.derivation.edited')}\n          </span>\n        )}\n      </div>\n      <dl className=\"grid grid-cols-[auto_1fr] gap-x-2 gap-y-0.5\">\n        <dt className=\"text-muted-foreground\">{t('composites.derivation.method')}</dt>\n        <dd className=\"truncate text-foreground\">{method}</dd>\n        {derivation.model && (\n          <>\n            <dt className=\"text-muted-foreground\">{t('composites.derivation.model')}</dt>\n            <dd className=\"truncate text-foreground\" title={derivation.model}>{derivation.model}</dd>\n          </>\n        )}\n        {created && (\n          <>\n            <dt className=\"text-muted-foreground\">{t('composites.derivation.createdAt')}</dt>\n            <dd className=\"text-foreground\">{created}</dd>\n          </>\n        )}\n      </dl>\n      {details.outputUrl && (\n        <a href={details.outputUrl} target=\"_blank\" rel=\"noopener\" className=\"inline-flex w-fit items-center gap-1 text-primary hover:underline\">\n          <Icon name=\"i-lucide-external-link\" className=\"size-3.5\" />{t('composites.derivation.openOutput')}\n        </a>\n      )}\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,OAAO;;;;;;;AAQb,SAAgB,gBAAgB,EAAE,QAAQ,MAAM,YAA2E;CACzH,MAAM,EAAE,MAAM,cAAc;CAC5B,MAAM,aAAa,aAAa,IAAI;CACpC,MAAM,UAAU,cAAc,WAAW,oBAAoB,QAAQ,IAAI,IAAI,MAAM;EAAC;EAAU;EAAQ;CAAI,CAAC;CAC3G,IAAI,CAAC,YAAY,OAAO;CACxB,MAAM,SAAS,sBAAsB,GAAG,WAAW,MAAM;CACzD,MAAM,UAAU,WAAW,YAAY,WAAW,WAAW,SAAS,IAAI;CAE1E,IAAI,CAAC,UACH,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACE,oBAAC,MAAD;GAAM,MAAK;GAAsB,WAAU;EAAqB,CAAA,GAChE,oBAAC,QAAD;GAAM,WAAU;GAAY,UAAA;IAAC,EAAE,6BAA6B;IAAG;IAAQ;GAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;EAAQ,CAAA,CAC/G;;CAGT,IAAI,CAAC,SAAS,OAAO;CAErB,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA;GACE,qBAAC,OAAD;IAAK,WAAU;IAAf,UAAA;KACE,qBAAC,QAAD;MAAM,WAAW,GAAG,MAAM,uBAAuB;MAAjD,UAAA,CACE,oBAAC,MAAD;OAAM,MAAK;OAAsB,WAAU;MAAY,CAAA,GAAE,EAAE,6BAA6B,CACpF;;KACL,QAAQ,SACP,qBAAC,QAAD;MAAM,WAAW,GAAG,MAAM,qBAAqB;MAA/C,UAAA,CACE,oBAAC,MAAD;OAAM,MAAK;OAA0B,WAAU;MAAY,CAAA,GAAE,EAAE,6BAA6B,CACxF;;KAEP,QAAQ,UACP,qBAAC,QAAD;MAAM,WAAW,GAAG,MAAM,uBAAuB;MAAjD,UAAA,CACE,oBAAC,MAAD;OAAM,MAAK;OAAkB,WAAU;MAAY,CAAA,GAAE,EAAE,8BAA8B,CACjF;;IAEL;;GACL,qBAAC,MAAD;IAAI,WAAU;IAAd,UAAA;KACE,oBAAC,MAAD;MAAI,WAAU;MAAyB,UAAA,EAAE,8BAA8B;KAAM,CAAA;KAC7E,oBAAC,MAAD;MAAI,WAAU;MAA4B,UAAA;KAAW,CAAA;KACpD,WAAW,SACV,qBAAA,YAAA,EAAA,UAAA,CACE,oBAAC,MAAD;MAAI,WAAU;MAAyB,UAAA,EAAE,6BAA6B;KAAM,CAAA,GAC5E,oBAAC,MAAD;MAAI,WAAU;MAA2B,OAAO,WAAW;MAAQ,UAAA,WAAW;KAAU,CAAA,CACxF,EAAA,CAAA;KAEH,WACC,qBAAA,YAAA,EAAA,UAAA,CACE,oBAAC,MAAD;MAAI,WAAU;MAAyB,UAAA,EAAE,iCAAiC;KAAM,CAAA,GAChF,oBAAC,MAAD;MAAI,WAAU;MAAmB,UAAA;KAAY,CAAA,CAC7C,EAAA,CAAA;IAEF;;GACH,QAAQ,aACP,qBAAC,KAAD;IAAG,MAAM,QAAQ;IAAW,QAAO;IAAS,KAAI;IAAW,WAAU;IAArE,UAAA,CACE,oBAAC,MAAD;KAAM,MAAK;KAAyB,WAAU;IAAY,CAAA,GAAE,EAAE,kCAAkC,CAC/F;;EAEF;;AAET"}

package/dist/features/composites/react/ReferenceFieldSelect.js

@@ -0,0 +1,52 @@
+import { useEditorI18n } from "../../../react/use-editor-i18n.js";
+import { cn } from "../../../react/ui/utils.js";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../../react/ui/select.js";
+import { setCompositeMetaField } from "../rows.js";
+import { metaText } from "../meta-display.js";
+import { useCompositeRows } from "./use-composite-rows.js";
+import { useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/features/composites/react/ReferenceFieldSelect.tsx
+/** Radix Select has no empty-string value: the "no reference" item travels as this sentinel. */
+const NONE = "__none__";
+const SELECT_SIZE = {
+	xs: "data-[size=sm]:h-6 text-xs",
+	sm: "data-[size=sm]:h-7",
+	md: ""
+};
+/** The select of a `reference` field: the other Bausteine of the document (with a block ID, of the field's target kinds) by title. */
+function ReferenceFieldSelect({ editor, row, field, disabled, size = "sm" }) {
+	const { t } = useEditorI18n();
+	const { rows } = useCompositeRows(editor);
+	const stored = metaText(row, field);
+	const options = useMemo(() => rows.filter((candidate) => candidate.id !== null && candidate.id !== row.id && (!field.targets || field.targets.includes(candidate.kind))).map((candidate) => ({
+		label: `${candidate.title.trim() || t("composites.inspector.untitled")} · ${candidate.kindLabel}`,
+		value: candidate.id
+	})), [
+		rows,
+		row.id,
+		field.targets,
+		t
+	]);
+	return /* @__PURE__ */ jsxs(Select, {
+		value: stored,
+		onValueChange: (value) => setCompositeMetaField(editor, row, field.key, value === NONE ? "" : value),
+		disabled,
+		children: [/* @__PURE__ */ jsx(SelectTrigger, {
+			size: "sm",
+			className: cn("w-full", SELECT_SIZE[size]),
+			"aria-label": field.label,
+			children: /* @__PURE__ */ jsx(SelectValue, { placeholder: t("composites.field.choose", { field: field.label }) })
+		}), /* @__PURE__ */ jsxs(SelectContent, { children: [/* @__PURE__ */ jsx(SelectItem, {
+			value: NONE,
+			children: t("composites.field.none")
+		}), options.map((option) => /* @__PURE__ */ jsx(SelectItem, {
+			value: option.value,
+			children: option.label
+		}, option.value))] })]
+	});
+}
+//#endregion
+export { ReferenceFieldSelect };
+
+//# sourceMappingURL=ReferenceFieldSelect.js.map

package/dist/features/composites/react/ReferenceFieldSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceFieldSelect.js","names":[],"sources":["../../../../src/features/composites/react/ReferenceFieldSelect.tsx"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { useMemo } from 'react'\nimport { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '../../../react/ui/select'\nimport { cn } from '../../../react/ui/utils'\nimport { useEditorI18n } from '../../../react/use-editor-i18n'\nimport type { CompositeMetaField } from '../kinds'\nimport { metaText } from '../meta-display'\nimport { type CompositeRow, setCompositeMetaField } from '../rows'\nimport { useCompositeRows } from './use-composite-rows'\n\n/** Radix Select has no empty-string value: the \"no reference\" item travels as this sentinel. */\nconst NONE = '__none__'\n\nconst SELECT_SIZE = {\n  xs: 'data-[size=sm]:h-6 text-xs',\n  sm: 'data-[size=sm]:h-7',\n  md: '',\n}\n\n/** The select of a `reference` field: the other Bausteine of the document (with a block ID, of the field's target kinds) by title. */\nexport function ReferenceFieldSelect({ editor, row, field, disabled, size = 'sm' }: {\n  editor: Editor\n  row: CompositeRow\n  field: CompositeMetaField\n  disabled?: boolean\n  size?: 'xs' | 'sm' | 'md'\n}) {\n  const { t } = useEditorI18n()\n  const { rows } = useCompositeRows(editor)\n  const stored = metaText(row, field)\n  const options = useMemo(() => rows\n    .filter(candidate => candidate.id !== null && candidate.id !== row.id && (!field.targets || field.targets.includes(candidate.kind)))\n    .map(candidate => ({ label: `${candidate.title.trim() || t('composites.inspector.untitled')} · ${candidate.kindLabel}`, value: candidate.id as string })), [rows, row.id, field.targets, t])\n\n  return (\n    <Select value={stored} onValueChange={value => setCompositeMetaField(editor, row, field.key, value === NONE ? '' : value)} disabled={disabled}>\n      <SelectTrigger size=\"sm\" className={cn('w-full', SELECT_SIZE[size])} aria-label={field.label}>\n        <SelectValue placeholder={t('composites.field.choose', { field: field.label })} />\n      </SelectTrigger>\n      <SelectContent>\n        <SelectItem value={NONE}>{t('composites.field.none')}</SelectItem>\n        {options.map(option => (\n          <SelectItem key={option.value} value={option.value}>{option.label}</SelectItem>\n        ))}\n      </SelectContent>\n    </Select>\n  )\n}\n"],"mappings":";;;;;;;;;;AAWA,MAAM,OAAO;AAEb,MAAM,cAAc;CAClB,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;;AAGA,SAAgB,qBAAqB,EAAE,QAAQ,KAAK,OAAO,UAAU,OAAO,QAMzE;CACD,MAAM,EAAE,MAAM,cAAc;CAC5B,MAAM,EAAE,SAAS,iBAAiB,MAAM;CACxC,MAAM,SAAS,SAAS,KAAK,KAAK;CAClC,MAAM,UAAU,cAAc,KAC3B,QAAO,cAAa,UAAU,OAAO,QAAQ,UAAU,OAAO,IAAI,OAAO,CAAC,MAAM,WAAW,MAAM,QAAQ,SAAS,UAAU,IAAI,EAAE,CAAC,CACnI,KAAI,eAAc;EAAE,OAAO,GAAG,UAAU,MAAM,KAAK,KAAK,EAAE,+BAA+B,EAAE,KAAK,UAAU;EAAa,OAAO,UAAU;CAAa,EAAE,GAAG;EAAC;EAAM,IAAI;EAAI,MAAM;EAAS;CAAC,CAAC;CAE7L,OACE,qBAAC,QAAD;EAAQ,OAAO;EAAQ,gBAAe,UAAS,sBAAsB,QAAQ,KAAK,MAAM,KAAK,UAAU,OAAO,KAAK,KAAK;EAAa;EAArI,UAAA,CACE,oBAAC,eAAD;GAAe,MAAK;GAAK,WAAW,GAAG,UAAU,YAAY,KAAK;GAAG,cAAY,MAAM;GACrF,UAAA,oBAAC,aAAD,EAAa,aAAa,EAAE,2BAA2B,EAAE,OAAO,MAAM,MAAM,CAAC,EAAI,CAAA;EACpE,CAAA,GACf,qBAAC,eAAD,EAAA,UAAA,CACE,oBAAC,YAAD;GAAY,OAAO;GAAO,UAAA,EAAE,uBAAuB;EAAc,CAAA,GAChE,QAAQ,KAAI,WACX,oBAAC,YAAD;GAA+B,OAAO,OAAO;GAAQ,UAAA,OAAO;EAAkB,GAA7D,OAAO,KAAsD,CAC/E,CACY,EAAA,CAAA,CACT;;AAEZ"}

package/dist/features/composites/react/ReferenceView.d.ts

@@ -0,0 +1,11 @@
+import { NodeViewProps } from "@tiptap/react";
+//#region src/features/composites/react/ReferenceView.d.ts
+/**
+ * The `reference` chip: the live short citation (or title) of the Baustein it points at, followed by its locator.
+ * A click reveals the target and, with a locator, opens its source there (page of a PDF, time of a recording); a
+ * target that no longer exists shows a greyed „gone“ label. Double click or right click opens a popover to set the
+ * locator („Stelle“) in an editable editor.
+ */
+export declare function ReferenceView({ editor, node, selected, getPos }: NodeViewProps): import("react").JSX.Element;
+//#endregion
+//# sourceMappingURL=ReferenceView.d.ts.map

package/dist/features/composites/react/ReferenceView.js

@@ -0,0 +1,115 @@
+import { useEditorI18n } from "../../../react/use-editor-i18n.js";
+import { cn } from "../../../react/ui/utils.js";
+import { Input } from "../../../react/ui/input.js";
+import { Popover, PopoverAnchor, PopoverContent } from "../../../react/ui/popover.js";
+import { referenceAttrsOf, resolveReference } from "../reference-label.js";
+import { revealSource } from "../reveal-source.js";
+import { useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { NodeViewWrapper } from "@tiptap/react";
+//#region src/features/composites/react/ReferenceView.tsx
+/**
+* The `reference` chip: the live short citation (or title) of the Baustein it points at, followed by its locator.
+* A click reveals the target and, with a locator, opens its source there (page of a PDF, time of a recording); a
+* target that no longer exists shows a greyed „gone“ label. Double click or right click opens a popover to set the
+* locator („Stelle“) in an editable editor.
+*/
+function ReferenceView({ editor, node, selected, getPos }) {
+	const { t } = useEditorI18n();
+	const [resolved, setResolved] = useState(() => resolveReference(editor, referenceAttrsOf(node)));
+	const [open, setOpen] = useState(false);
+	const [draft, setDraft] = useState("");
+	const target = String(node.attrs.target);
+	const locator = typeof node.attrs.locator === "string" ? node.attrs.locator : "";
+	useEffect(() => {
+		let frame = 0;
+		const resolve = () => {
+			if (editor.isDestroyed) return;
+			const next = resolveReference(editor, {
+				target,
+				label: String(node.attrs.label ?? "")
+			});
+			setResolved((current) => next.label === current.label && next.title === current.title && next.gone === current.gone ? current : next);
+		};
+		const schedule = () => {
+			cancelAnimationFrame(frame);
+			frame = requestAnimationFrame(resolve);
+		};
+		resolve();
+		editor.on("update", schedule);
+		return () => {
+			cancelAnimationFrame(frame);
+			editor.off("update", schedule);
+		};
+	}, [
+		editor,
+		target,
+		node.attrs.label
+	]);
+	const label = resolved.gone ? t("composites.reference.gone") : resolved.label;
+	const text = locator && !resolved.gone ? `${label}, ${locator}` : label;
+	function onClick() {
+		if (!editor.commands.revealBlock(target)) return;
+		if (locator) revealSource(editor, target, locator);
+	}
+	function openLocator() {
+		if (!editor.isEditable) return;
+		setDraft(locator);
+		setOpen(true);
+	}
+	function commit() {
+		setOpen(false);
+		const pos = getPos();
+		if (typeof pos !== "number" || draft.trim() === locator) return;
+		editor.commands.setReferenceLocator(pos, draft);
+	}
+	return /* @__PURE__ */ jsx(NodeViewWrapper, {
+		as: "span",
+		className: cn("reference", resolved.gone && "is-gone", selected && "is-selected"),
+		"data-type": "reference",
+		"data-target": target,
+		title: resolved.gone ? void 0 : resolved.title,
+		role: "link",
+		onClick,
+		onDoubleClick: (event) => {
+			event.preventDefault();
+			openLocator();
+		},
+		onContextMenu: (event) => {
+			event.preventDefault();
+			openLocator();
+		},
+		children: /* @__PURE__ */ jsxs(Popover, {
+			open,
+			onOpenChange: (value) => {
+				if (!value) commit();
+			},
+			children: [/* @__PURE__ */ jsx(PopoverAnchor, {
+				asChild: true,
+				children: /* @__PURE__ */ jsx("span", { children: text })
+			}), /* @__PURE__ */ jsx(PopoverContent, {
+				align: "start",
+				side: "bottom",
+				className: "w-56 p-2",
+				onCloseAutoFocus: (event) => event.preventDefault(),
+				children: /* @__PURE__ */ jsx(Input, {
+					value: draft,
+					className: "h-7 w-full text-xs",
+					placeholder: t("composites.reference.locatorPlaceholder"),
+					"aria-label": t("composites.reference.locator"),
+					onChange: (event) => setDraft(event.target.value),
+					onKeyDown: (event) => {
+						if (event.key === "Enter") {
+							event.preventDefault();
+							commit();
+						}
+					}
+				})
+			})]
+		})
+	});
+}
+//#endregion
+export { ReferenceView };
+
+//# sourceMappingURL=ReferenceView.js.map

package/dist/features/composites/react/ReferenceView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferenceView.js","names":[],"sources":["../../../../src/features/composites/react/ReferenceView.tsx"],"sourcesContent":["import { NodeViewWrapper, type NodeViewProps } from '@tiptap/react'\nimport { type MouseEvent, useEffect, useState } from 'react'\nimport { Input } from '../../../react/ui/input'\nimport { Popover, PopoverAnchor, PopoverContent } from '../../../react/ui/popover'\nimport { cn } from '../../../react/ui/utils'\nimport { useEditorI18n } from '../../../react/use-editor-i18n'\nimport { referenceAttrsOf, resolveReference } from '../reference-label'\nimport { revealSource } from '../reveal-source'\n\n/**\n * The `reference` chip: the live short citation (or title) of the Baustein it points at, followed by its locator.\n * A click reveals the target and, with a locator, opens its source there (page of a PDF, time of a recording); a\n * target that no longer exists shows a greyed „gone“ label. Double click or right click opens a popover to set the\n * locator („Stelle“) in an editable editor.\n */\nexport function ReferenceView({ editor, node, selected, getPos }: NodeViewProps) {\n  const { t } = useEditorI18n()\n  const [resolved, setResolved] = useState(() => resolveReference(editor, referenceAttrsOf(node)))\n  const [open, setOpen] = useState(false)\n  const [draft, setDraft] = useState('')\n  const target = String(node.attrs.target)\n  const locator = typeof node.attrs.locator === 'string' ? node.attrs.locator : ''\n\n  // The target's title and bibliography edits change the label: re-resolve after document changes, once per frame.\n  useEffect(() => {\n    let frame = 0\n    const resolve = () => {\n      if (editor.isDestroyed) return\n      const next = resolveReference(editor, { target, label: String(node.attrs.label ?? '') })\n      setResolved(current => (next.label === current.label && next.title === current.title && next.gone === current.gone ? current : next))\n    }\n    const schedule = () => {\n      cancelAnimationFrame(frame)\n      frame = requestAnimationFrame(resolve)\n    }\n    resolve()\n    editor.on('update', schedule)\n    return () => {\n      cancelAnimationFrame(frame)\n      editor.off('update', schedule)\n    }\n  }, [editor, target, node.attrs.label])\n\n  const label = resolved.gone ? t('composites.reference.gone') : resolved.label\n  const text = locator && !resolved.gone ? `${label}, ${locator}` : label\n\n  function onClick() {\n    if (!editor.commands.revealBlock(target)) return\n    if (locator) revealSource(editor, target, locator)\n  }\n\n  function openLocator() {\n    if (!editor.isEditable) return\n    setDraft(locator)\n    setOpen(true)\n  }\n\n  function commit() {\n    setOpen(false)\n    const pos = getPos()\n    if (typeof pos !== 'number' || draft.trim() === locator) return\n    editor.commands.setReferenceLocator(pos, draft)\n  }\n\n  return (\n    <NodeViewWrapper\n      as=\"span\"\n      className={cn('reference', resolved.gone && 'is-gone', selected && 'is-selected')}\n      data-type=\"reference\"\n      data-target={target}\n      title={resolved.gone ? undefined : resolved.title}\n      role=\"link\"\n      onClick={onClick}\n      onDoubleClick={(event: MouseEvent) => {\n        event.preventDefault()\n        openLocator()\n      }}\n      onContextMenu={(event: MouseEvent) => {\n        event.preventDefault()\n        openLocator()\n      }}\n    >\n      <Popover open={open} onOpenChange={(value) => { if (!value) commit() }}>\n        <PopoverAnchor asChild>\n          <span>{text}</span>\n        </PopoverAnchor>\n        <PopoverContent\n          align=\"start\"\n          side=\"bottom\"\n          className=\"w-56 p-2\"\n          onCloseAutoFocus={event => event.preventDefault()}\n        >\n          <Input\n            value={draft}\n            className=\"h-7 w-full text-xs\"\n            placeholder={t('composites.reference.locatorPlaceholder')}\n            aria-label={t('composites.reference.locator')}\n            onChange={event => setDraft(event.target.value)}\n            onKeyDown={(event) => {\n              if (event.key === 'Enter') {\n                event.preventDefault()\n                commit()\n              }\n            }}\n          />\n        </PopoverContent>\n      </Popover>\n    </NodeViewWrapper>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,cAAc,EAAE,QAAQ,MAAM,UAAU,UAAyB;CAC/E,MAAM,EAAE,MAAM,cAAc;CAC5B,MAAM,CAAC,UAAU,eAAe,eAAe,iBAAiB,QAAQ,iBAAiB,IAAI,CAAC,CAAC;CAC/F,MAAM,CAAC,MAAM,WAAW,SAAS,KAAK;CACtC,MAAM,CAAC,OAAO,YAAY,SAAS,EAAE;CACrC,MAAM,SAAS,OAAO,KAAK,MAAM,MAAM;CACvC,MAAM,UAAU,OAAO,KAAK,MAAM,YAAY,WAAW,KAAK,MAAM,UAAU;CAG9E,gBAAgB;EACd,IAAI,QAAQ;EACZ,MAAM,gBAAgB;GACpB,IAAI,OAAO,aAAa;GACxB,MAAM,OAAO,iBAAiB,QAAQ;IAAE;IAAQ,OAAO,OAAO,KAAK,MAAM,SAAS,EAAE;GAAE,CAAC;GACvF,aAAY,YAAY,KAAK,UAAU,QAAQ,SAAS,KAAK,UAAU,QAAQ,SAAS,KAAK,SAAS,QAAQ,OAAO,UAAU,IAAK;EACtI;EACA,MAAM,iBAAiB;GACrB,qBAAqB,KAAK;GAC1B,QAAQ,sBAAsB,OAAO;EACvC;EACA,QAAQ;EACR,OAAO,GAAG,UAAU,QAAQ;EAC5B,aAAa;GACX,qBAAqB,KAAK;GAC1B,OAAO,IAAI,UAAU,QAAQ;EAC/B;CACF,GAAG;EAAC;EAAQ;EAAQ,KAAK,MAAM;CAAK,CAAC;CAErC,MAAM,QAAQ,SAAS,OAAO,EAAE,2BAA2B,IAAI,SAAS;CACxE,MAAM,OAAO,WAAW,CAAC,SAAS,OAAO,GAAG,MAAM,IAAI,YAAY;CAElE,SAAS,UAAU;EACjB,IAAI,CAAC,OAAO,SAAS,YAAY,MAAM,GAAG;EAC1C,IAAI,SAAS,aAAa,QAAQ,QAAQ,OAAO;CACnD;CAEA,SAAS,cAAc;EACrB,IAAI,CAAC,OAAO,YAAY;EACxB,SAAS,OAAO;EAChB,QAAQ,IAAI;CACd;CAEA,SAAS,SAAS;EAChB,QAAQ,KAAK;EACb,MAAM,MAAM,OAAO;EACnB,IAAI,OAAO,QAAQ,YAAY,MAAM,KAAK,MAAM,SAAS;EACzD,OAAO,SAAS,oBAAoB,KAAK,KAAK;CAChD;CAEA,OACE,oBAAC,iBAAD;EACE,IAAG;EACH,WAAW,GAAG,aAAa,SAAS,QAAQ,WAAW,YAAY,aAAa;EAChF,aAAU;EACV,eAAa;EACb,OAAO,SAAS,OAAO,KAAA,IAAY,SAAS;EAC5C,MAAK;EACI;EACT,gBAAgB,UAAsB;GACpC,MAAM,eAAe;GACrB,YAAY;EACd;EACA,gBAAgB,UAAsB;GACpC,MAAM,eAAe;GACrB,YAAY;EACd;EAEA,UAAA,qBAAC,SAAD;GAAe;GAAM,eAAe,UAAU;IAAE,IAAI,CAAC,OAAO,OAAO;GAAE;GAArE,UAAA,CACE,oBAAC,eAAD;IAAe,SAAA;IACb,UAAA,oBAAC,QAAD,EAAA,UAAO,KAAW,CAAA;GACL,CAAA,GACf,oBAAC,gBAAD;IACE,OAAM;IACN,MAAK;IACL,WAAU;IACV,mBAAkB,UAAS,MAAM,eAAe;IAEhD,UAAA,oBAAC,OAAD;KACE,OAAO;KACP,WAAU;KACV,aAAa,EAAE,yCAAyC;KACxD,cAAY,EAAE,8BAA8B;KAC5C,WAAU,UAAS,SAAS,MAAM,OAAO,KAAK;KAC9C,YAAY,UAAU;MACpB,IAAI,MAAM,QAAQ,SAAS;OACzB,MAAM,eAAe;OACrB,OAAO;MACT;KACF;IACD,CAAA;GACa,CAAA,CACT;;CACM,CAAA;AAErB"}

package/dist/features/composites/react/SettingsEditingTab.js

@@ -2,13 +2,13 @@ import { DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILI
 import { useEditorI18n } from "../../../react/use-editor-i18n.js";
 import { Icon } from "../../../react/Icon.js";
 import { useEditorSettings } from "../../../react/settings.js";
-import { STRUCTURE_MODE_KEYS } from "../structure-mode.js";
-import { TREE_ROOT_KEYS } from "../tree-root.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../../react/ui/select.js";
 import { SettingsSection } from "../../../react/SettingsSection.js";
 import { Label } from "../../../react/ui/label.js";
 import { RadioGroup, RadioGroupItem } from "../../../react/ui/radio-group.js";
+import { STRUCTURE_MODE_KEYS } from "../structure-mode.js";
 import { DRAG_HANDLE_KEYS, HEADING_SCOPE_KEYS, KIND_ICON_KEYS, optionItems } from "../editing-settings-keys.js";
+import { TREE_ROOT_KEYS } from "../tree-root.js";
 import { useId } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/features/composites/react/SettingsEditingTab.tsx

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

@@ -10,6 +10,7 @@ import { CompositeSummaryEditor } from "./react/CompositeSummaryEditor.js";
 import { CompositeTable } from "./react/CompositeTable.js";
 import { CompositeTagsEditor } from "./react/CompositeTagsEditor.js";
 import { CompositeView } from "./react/CompositeView.js";
+import { ReferenceView } from "./react/ReferenceView.js";
 import { SettingsEditingTab } from "./react/SettingsEditingTab.js";
 import { useCompositeAnchors } from "./react/use-composite-anchors.js";
 import { useCompositeRows } from "./react/use-composite-rows.js";
@@ -20,5 +21,5 @@ import { useCompositeRows } from "./react/use-composite-rows.js";
  */
 export declare function compositeFeature(options?: CompositeFeatureOptions): ReactFeature;
 //#endregion
-export { CompositeChrome, CompositeDetails, CompositeFieldEditor, CompositeInspector, CompositeStatusMenu, CompositeSummaryEditor, CompositeTable, CompositeTagsEditor, CompositeView, SettingsEditingTab, useCompositeAnchors, useCompositeRows };
+export { CompositeChrome, CompositeDetails, CompositeFieldEditor, CompositeInspector, CompositeStatusMenu, CompositeSummaryEditor, CompositeTable, CompositeTagsEditor, CompositeView, ReferenceView, SettingsEditingTab, useCompositeAnchors, useCompositeRows };
 //# sourceMappingURL=react.d.ts.map

package/dist/features/composites/react.js

@@ -1,12 +1,13 @@
 import { compositeFeatureCore } from "./feature.js";
+import { useCompositeRows } from "./react/use-composite-rows.js";
 import { CompositeFieldEditor } from "./react/CompositeFieldEditor.js";
 import { CompositeSummaryEditor } from "./react/CompositeSummaryEditor.js";
 import { CompositeDetails } from "./react/CompositeDetails.js";
 import { CompositeStatusMenu } from "./react/CompositeStatusMenu.js";
 import { CompositeTagsEditor } from "./react/CompositeTagsEditor.js";
 import { useCompositeAnchors } from "./react/use-composite-anchors.js";
-import { useCompositeRows } from "./react/use-composite-rows.js";
 import { CompositeChrome } from "./react/CompositeChrome.js";
+import { ReferenceView } from "./react/ReferenceView.js";
 import { CompositeView } from "./react/CompositeView.js";
 import { SettingsEditingTab } from "./react/SettingsEditingTab.js";
 import { CompositeInspector } from "./react/CompositeInspector.js";
@@ -21,10 +22,13 @@ function compositeFeature(options = {}) {
 	return compositeFeatureCore({
 		chrome: CompositeChrome,
 		settingsTab: SettingsEditingTab,
-		nodeViews: { composite: ReactNodeViewRenderer(CompositeView) }
+		nodeViews: {
+			composite: ReactNodeViewRenderer(CompositeView),
+			reference: ReactNodeViewRenderer(ReferenceView)
+		}
 	}, options);
 }
 //#endregion
-export { CompositeChrome, CompositeDetails, CompositeFieldEditor, CompositeInspector, CompositeStatusMenu, CompositeSummaryEditor, CompositeTable, CompositeTagsEditor, CompositeView, SettingsEditingTab, compositeFeature, useCompositeAnchors, useCompositeRows };
+export { CompositeChrome, CompositeDetails, CompositeFieldEditor, CompositeInspector, CompositeStatusMenu, CompositeSummaryEditor, CompositeTable, CompositeTagsEditor, CompositeView, ReferenceView, SettingsEditingTab, compositeFeature, useCompositeAnchors, useCompositeRows };
 
 //# sourceMappingURL=react.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"react.js","names":[],"sources":["../../../src/features/composites/react.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { ReactNodeViewRenderer } from '@tiptap/react'\nimport type { ComponentType } from 'react'\nimport type { ReactFeature } from '../../react'\nimport { type CompositeFeatureOptions, compositeFeatureCore } from './feature'\nimport { CompositeChrome } from './react/CompositeChrome'\nimport { CompositeView } from './react/CompositeView'\nimport { SettingsEditingTab } from './react/SettingsEditingTab'\n\nexport { CompositeChrome } from './react/CompositeChrome'\nexport { CompositeDetails } from './react/CompositeDetails'\nexport { CompositeFieldEditor } from './react/CompositeFieldEditor'\nexport { CompositeInspector } from './react/CompositeInspector'\nexport { CompositeStatusMenu } from './react/CompositeStatusMenu'\nexport { CompositeSummaryEditor } from './react/CompositeSummaryEditor'\nexport { CompositeTable } from './react/CompositeTable'\nexport { CompositeTagsEditor } from './react/CompositeTagsEditor'\nexport { CompositeView } from './react/CompositeView'\nexport { SettingsEditingTab } from './react/SettingsEditingTab'\nexport { useCompositeAnchors } from './react/use-composite-anchors'\nexport { useCompositeRows } from './react/use-composite-rows'\n\n/**\n * The React composites feature (shadcn): see `compositeFeatureCore`. The host places `CompositeTable` and\n * `CompositeInspector` beside the editor.\n */\nexport function compositeFeature(options: CompositeFeatureOptions = {}): ReactFeature {\n  return compositeFeatureCore<ComponentType<{ editor: Editor }>>({\n    chrome: CompositeChrome,\n    // A settings tab receives only its descriptor's `props` (`{ kinds }`), not the toolbar's `{ editor }` (see `EditorSettingsPanel`).\n    settingsTab: SettingsEditingTab as unknown as ComponentType<{ editor: Editor }>,\n    nodeViews: { composite: ReactNodeViewRenderer(CompositeView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAiB;CACpF,OAAO,qBAAwD;EAC7D,QAAQ;EAER,aAAa;EACb,WAAW,EAAE,WAAW,sBAAsB,aAAa,EAAE;CAC/D,GAAG,OAAO;AACZ"}
+{"version":3,"file":"react.js","names":[],"sources":["../../../src/features/composites/react.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { ReactNodeViewRenderer } from '@tiptap/react'\nimport type { ComponentType } from 'react'\nimport type { ReactFeature } from '../../react'\nimport { type CompositeFeatureOptions, compositeFeatureCore } from './feature'\nimport { CompositeChrome } from './react/CompositeChrome'\nimport { ReferenceView } from './react/ReferenceView'\nimport { CompositeView } from './react/CompositeView'\nimport { SettingsEditingTab } from './react/SettingsEditingTab'\n\nexport { CompositeChrome } from './react/CompositeChrome'\nexport { CompositeDetails } from './react/CompositeDetails'\nexport { CompositeFieldEditor } from './react/CompositeFieldEditor'\nexport { CompositeInspector } from './react/CompositeInspector'\nexport { CompositeStatusMenu } from './react/CompositeStatusMenu'\nexport { CompositeSummaryEditor } from './react/CompositeSummaryEditor'\nexport { CompositeTable } from './react/CompositeTable'\nexport { CompositeTagsEditor } from './react/CompositeTagsEditor'\nexport { CompositeView } from './react/CompositeView'\nexport { ReferenceView } from './react/ReferenceView'\nexport { SettingsEditingTab } from './react/SettingsEditingTab'\nexport { useCompositeAnchors } from './react/use-composite-anchors'\nexport { useCompositeRows } from './react/use-composite-rows'\n\n/**\n * The React composites feature (shadcn): see `compositeFeatureCore`. The host places `CompositeTable` and\n * `CompositeInspector` beside the editor.\n */\nexport function compositeFeature(options: CompositeFeatureOptions = {}): ReactFeature {\n  return compositeFeatureCore<ComponentType<{ editor: Editor }>>({\n    chrome: CompositeChrome,\n    // A settings tab receives only its descriptor's `props` (`{ kinds }`), not the toolbar's `{ editor }` (see `EditorSettingsPanel`).\n    settingsTab: SettingsEditingTab as unknown as ComponentType<{ editor: Editor }>,\n    nodeViews: { composite: ReactNodeViewRenderer(CompositeView), reference: ReactNodeViewRenderer(ReferenceView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAiB;CACpF,OAAO,qBAAwD;EAC7D,QAAQ;EAER,aAAa;EACb,WAAW;GAAE,WAAW,sBAAsB,aAAa;GAAG,WAAW,sBAAsB,aAAa;EAAE;CAChH,GAAG,OAAO;AACZ"}

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

@@ -0,0 +1,16 @@
+//#region src/features/composites/reference-ai.ts
+/**
+* How the chat and rewrite models learn the `reference` chip: written as Markdown text `[@<Block-ID>]`, which the
+* composites feature's `normalize` stage turns back into a chip. Not a convert target (no conversion provider owns it).
+*/
+const REFERENCE_AI_BLOCK = {
+	id: "reference",
+	label: "Verweis",
+	description: "Inline-Verweis auf einen Baustein dieses Dokuments (Zitat, Quelle), optional mit Fundstelle (Seite oder Zeit).",
+	syntax: "[@<Block-ID>] oder [@<Block-ID>, S. 12]",
+	example: "Das zeigt die Studie [@0f3c9a52-7d1e-4b8a-9c2f-5e6d7a8b9c0d, S. 12]."
+};
+//#endregion
+export { REFERENCE_AI_BLOCK };
+
+//# sourceMappingURL=reference-ai.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference-ai.js","names":[],"sources":["../../../src/features/composites/reference-ai.ts"],"sourcesContent":["// i18n-ignore-file: model-facing block description (German prompt text, not UI)\nimport type { AiBlock } from '../../core/feature'\n\n/**\n * How the chat and rewrite models learn the `reference` chip: written as Markdown text `[@<Block-ID>]`, which the\n * composites feature's `normalize` stage turns back into a chip. Not a convert target (no conversion provider owns it).\n */\nexport const REFERENCE_AI_BLOCK: AiBlock = {\n  id: 'reference',\n  label: 'Verweis',\n  description: 'Inline-Verweis auf einen Baustein dieses Dokuments (Zitat, Quelle), optional mit Fundstelle (Seite oder Zeit).',\n  syntax: '[@<Block-ID>] oder [@<Block-ID>, S. 12]',\n  example: 'Das zeigt die Studie [@0f3c9a52-7d1e-4b8a-9c2f-5e6d7a8b9c0d, S. 12].',\n}\n"],"mappings":";;;;;AAOA,MAAa,qBAA8B;CACzC,IAAI;CACJ,OAAO;CACP,aAAa;CACb,QAAQ;CACR,SAAS;AACX"}

package/dist/features/composites/reference-label.d.ts

@@ -0,0 +1,19 @@
+import { CompositeKind } from "./kinds.js";
+import "./reference.js";
+import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/composites/reference-label.d.ts
+/** What a reference chip shows of its target: the parts of a `CompositeRow`, or of a composite node (`referenceTarget`). */
+export interface ReferenceTarget {
+  meta: Record<string, unknown>;
+  title: string;
+  kindLabel: string;
+}
+/** The Baustein `node` as a reference target. */
+export declare function referenceTarget(node: Node$1, kinds: readonly CompositeKind[]): ReferenceTarget;
+/** The chip text: the short citation ("Doe et al. 2024") when the target has bibliographic data, else its title, else its kind's label. */
+export declare function referenceLabel(target: ReferenceTarget): string;
+/** The chip's tooltip: the full citation, else the title. */
+export declare function referenceTitle(target: ReferenceTarget): string;
+//#endregion
+//# sourceMappingURL=reference-label.d.ts.map

package/dist/features/composites/reference-label.js

@@ -0,0 +1,58 @@
+import { findBlockById } from "../../core/schema/block-ids.js";
+import { compositeKind } from "./kinds.js";
+import "./meta-keys.js";
+import { compositeKindsOf } from "./nodes.js";
+import { citeFull, citeShort } from "./bibliography.js";
+//#region src/features/composites/reference-label.ts
+/** The Baustein `node` as a reference target. */
+function referenceTarget(node, kinds) {
+	return {
+		meta: node.attrs.meta ?? {},
+		title: node.childCount > 0 ? node.child(0).textContent.trim() : "",
+		kindLabel: compositeKind(kinds, String(node.attrs.kind)).label
+	};
+}
+const bibOfTarget = (target) => {
+	const bib = target.meta["bib"];
+	if (!bib || typeof bib !== "object" || Array.isArray(bib)) return null;
+	return "type" in bib && typeof bib.type === "string" ? bib : null;
+};
+/** The chip text: the short citation ("Doe et al. 2024") when the target has bibliographic data, else its title, else its kind's label. */
+function referenceLabel(target) {
+	const bib = bibOfTarget(target);
+	return bib ? citeShort(bib, target.title) : target.title || target.kindLabel;
+}
+/** The chip's tooltip: the full citation, else the title. */
+function referenceTitle(target) {
+	const bib = bibOfTarget(target);
+	return bib ? citeFull({
+		...bib,
+		title: target.title
+	}) : target.title || target.kindLabel;
+}
+/** The attrs of a `reference` node that the label needs, typed (a node's `attrs` is a loose record). */
+function referenceAttrsOf(node) {
+	return {
+		target: String(node.attrs.target ?? ""),
+		label: String(node.attrs.label ?? "")
+	};
+}
+/** What a chip shows now: the live label and tooltip of its target, or (`gone`) the attrs' cached label when the target no longer exists. */
+function resolveReference(editor, attrs) {
+	const found = findBlockById(editor.state.doc, attrs.target);
+	if (found?.node.type.name !== "composite") return {
+		label: attrs.label,
+		title: attrs.label,
+		gone: true
+	};
+	const target = referenceTarget(found.node, compositeKindsOf(editor));
+	return {
+		label: referenceLabel(target),
+		title: referenceTitle(target),
+		gone: false
+	};
+}
+//#endregion
+export { referenceAttrsOf, referenceLabel, referenceTarget, referenceTitle, resolveReference };
+
+//# sourceMappingURL=reference-label.js.map

package/dist/features/composites/reference-label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-label.js","names":[],"sources":["../../../src/features/composites/reference-label.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { findBlockById } from '../../core/schema'\nimport { type CslItem, BIB_KEY, citeFull, citeShort } from './bibliography'\nimport { compositeKind, type CompositeKind } from './kinds'\nimport { compositeKindsOf } from './nodes'\nimport type { ReferenceAttrs } from './reference'\n\n/** What a reference chip shows of its target: the parts of a `CompositeRow`, or of a composite node (`referenceTarget`). */\nexport interface ReferenceTarget {\n  meta: Record<string, unknown>\n  title: string\n  kindLabel: string\n}\n\n/** The Baustein `node` as a reference target. */\nexport function referenceTarget(node: PMNode, kinds: readonly CompositeKind[]): ReferenceTarget {\n  return {\n    meta: (node.attrs.meta ?? {}) as Record<string, unknown>,\n    title: node.childCount > 0 ? node.child(0).textContent.trim() : '',\n    kindLabel: compositeKind(kinds, String(node.attrs.kind)).label,\n  }\n}\n\nconst bibOfTarget = (target: ReferenceTarget): CslItem | null => {\n  const bib = target.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 chip text: the short citation (\"Doe et al. 2024\") when the target has bibliographic data, else its title, else its kind's label. */\nexport function referenceLabel(target: ReferenceTarget): string {\n  const bib = bibOfTarget(target)\n  return bib ? citeShort(bib, target.title) : target.title || target.kindLabel\n}\n\n/** The chip's tooltip: the full citation, else the title. */\nexport function referenceTitle(target: ReferenceTarget): string {\n  const bib = bibOfTarget(target)\n  return bib ? citeFull({ ...bib, title: target.title }) : target.title || target.kindLabel\n}\n\n/** The attrs of a `reference` node that the label needs, typed (a node's `attrs` is a loose record). */\nexport function referenceAttrsOf(node: PMNode): Pick<ReferenceAttrs, 'target' | 'label'> {\n  return { target: String(node.attrs.target ?? ''), label: String(node.attrs.label ?? '') }\n}\n\n/** What a chip shows now: the live label and tooltip of its target, or (`gone`) the attrs' cached label when the target no longer exists. */\nexport function resolveReference(editor: Editor, attrs: Pick<ReferenceAttrs, 'target' | 'label'>): { label: string, title: string, gone: boolean } {\n  const found = findBlockById(editor.state.doc, attrs.target)\n  if (found?.node.type.name !== 'composite') return { label: attrs.label, title: attrs.label, gone: true }\n  const target = referenceTarget(found.node, compositeKindsOf(editor))\n  return { label: referenceLabel(target), title: referenceTitle(target), gone: false }\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,gBAAgB,MAAc,OAAkD;CAC9F,OAAO;EACL,MAAO,KAAK,MAAM,QAAQ,CAAC;EAC3B,OAAO,KAAK,aAAa,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI;EAChE,WAAW,cAAc,OAAO,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC;CAC3D;AACF;AAEA,MAAM,eAAe,WAA4C;CAC/D,MAAM,MAAM,OAAO,KAAA;CACnB,IAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG,OAAO;CAClE,OAAO,UAAU,OAAO,OAAO,IAAI,SAAS,WAAW,MAAiB;AAC1E;;AAGA,SAAgB,eAAe,QAAiC;CAC9D,MAAM,MAAM,YAAY,MAAM;CAC9B,OAAO,MAAM,UAAU,KAAK,OAAO,KAAK,IAAI,OAAO,SAAS,OAAO;AACrE;;AAGA,SAAgB,eAAe,QAAiC;CAC9D,MAAM,MAAM,YAAY,MAAM;CAC9B,OAAO,MAAM,SAAS;EAAE,GAAG;EAAK,OAAO,OAAO;CAAM,CAAC,IAAI,OAAO,SAAS,OAAO;AAClF;;AAGA,SAAgB,iBAAiB,MAAwD;CACvF,OAAO;EAAE,QAAQ,OAAO,KAAK,MAAM,UAAU,EAAE;EAAG,OAAO,OAAO,KAAK,MAAM,SAAS,EAAE;CAAE;AAC1F;;AAGA,SAAgB,iBAAiB,QAAgB,OAAkG;CACjJ,MAAM,QAAQ,cAAc,OAAO,MAAM,KAAK,MAAM,MAAM;CAC1D,IAAI,OAAO,KAAK,KAAK,SAAS,aAAa,OAAO;EAAE,OAAO,MAAM;EAAO,OAAO,MAAM;EAAO,MAAM;CAAK;CACvG,MAAM,SAAS,gBAAgB,MAAM,MAAM,iBAAiB,MAAM,CAAC;CACnE,OAAO;EAAE,OAAO,eAAe,MAAM;EAAG,OAAO,eAAe,MAAM;EAAG,MAAM;CAAM;AACrF"}

package/dist/features/composites/reference-suggestion.d.ts

@@ -0,0 +1,10 @@
+import { Translate } from "../../i18n/index.js";
+import { ReferenceOptions } from "./reference.js";
+//#region src/features/composites/reference-suggestion.d.ts
+/**
+ * `[@` trigger for ReferenceNode: the Bausteine of the document (with a block ID) whose title, kind or chip label (the
+ * short citation) contains the typed query, inserted as a chip that shows the short citation or the title. `t` renders the popup texts in the app's language.
+ */
+export declare const referenceSuggestion: (t: Translate) => NonNullable<ReferenceOptions["suggestion"]>;
+//#endregion
+//# sourceMappingURL=reference-suggestion.d.ts.map

package/dist/features/composites/reference-suggestion.js

@@ -0,0 +1,41 @@
+import { ABILITY } from "../../core/schema/abilities.js";
+import { hasAbility } from "../../core/abilities.js";
+import { createSuggestionRender } from "../../core/suggestion-popup.js";
+import { compositeKindsOf } from "./nodes.js";
+import { referenceLabel } from "./reference-label.js";
+import { compositeRows } from "./rows.js";
+//#region src/features/composites/reference-suggestion.ts
+/** Rows of the popup; more would need scrolling past what a citation picker is for, and the query narrows them anyway. */
+const MAX_ITEMS = 20;
+/**
+* `[@` trigger for ReferenceNode: the Bausteine of the document (with a block ID) whose title, kind or chip label (the
+* short citation) contains the typed query, inserted as a chip that shows the short citation or the title. `t` renders the popup texts in the app's language.
+*/
+const referenceSuggestion = (t) => ({
+	allow: ({ editor }) => hasAbility(editor, ABILITY.reference),
+	items: ({ query, editor }) => {
+		const needle = query.trim().toLowerCase();
+		return compositeRows(editor.state.doc, compositeKindsOf(editor)).rows.filter((row) => row.id !== null).map((row) => ({
+			row,
+			label: referenceLabel(row)
+		})).filter(({ row, label }) => !needle || [
+			label,
+			row.title,
+			row.kindLabel
+		].some((part) => part.toLowerCase().includes(needle))).slice(0, MAX_ITEMS).map(({ row, label }) => ({
+			target: row.id,
+			documentId: null,
+			locator: null,
+			label
+		}));
+	},
+	render: createSuggestionRender({
+		display: (item) => ({ label: item.label }),
+		emptyText: t("composites.reference.empty"),
+		loadingText: t("common.loading")
+	})
+});
+//#endregion
+export { referenceSuggestion };
+
+//# sourceMappingURL=reference-suggestion.js.map

package/dist/features/composites/reference-suggestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-suggestion.js","names":[],"sources":["../../../src/features/composites/reference-suggestion.ts"],"sourcesContent":["import { createSuggestionRender, hasAbility } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport type { Translate } from '../../i18n'\nimport { compositeKindsOf } from './nodes'\nimport type { ReferenceAttrs, ReferenceOptions } from './reference'\nimport { referenceLabel } from './reference-label'\nimport { compositeRows } from './rows'\n\n/** Rows of the popup; more would need scrolling past what a citation picker is for, and the query narrows them anyway. */\nconst MAX_ITEMS = 20\n\n/**\n * `[@` trigger for ReferenceNode: the Bausteine of the document (with a block ID) whose title, kind or chip label (the\n * short citation) contains the typed query, inserted as a chip that shows the short citation or the title. `t` renders the popup texts in the app's language.\n */\nexport const referenceSuggestion = (t: Translate): NonNullable<ReferenceOptions['suggestion']> => ({\n  allow: ({ editor }) => hasAbility(editor, ABILITY.reference),\n  items: ({ query, editor }): ReferenceAttrs[] => {\n    const needle = query.trim().toLowerCase()\n    return compositeRows(editor.state.doc, compositeKindsOf(editor)).rows\n      .filter(row => row.id !== null)\n      .map(row => ({ row, label: referenceLabel(row) }))\n      .filter(({ row, label }) => !needle || [label, row.title, row.kindLabel].some(part => part.toLowerCase().includes(needle)))\n      .slice(0, MAX_ITEMS)\n      .map(({ row, label }): ReferenceAttrs => ({ target: row.id!, documentId: null, locator: null, label }))\n  },\n  render: createSuggestionRender<ReferenceAttrs>({\n    display: item => ({ label: item.label }),\n    emptyText: t('composites.reference.empty'),\n    loadingText: t('common.loading'),\n  }),\n})\n"],"mappings":";;;;;;;;AASA,MAAM,YAAY;;;;;AAMlB,MAAa,uBAAuB,OAA+D;CACjG,QAAQ,EAAE,aAAa,WAAW,QAAQ,QAAQ,SAAS;CAC3D,QAAQ,EAAE,OAAO,aAA+B;EAC9C,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,YAAY;EACxC,OAAO,cAAc,OAAO,MAAM,KAAK,iBAAiB,MAAM,CAAC,CAAC,CAAC,KAC9D,QAAO,QAAO,IAAI,OAAO,IAAI,CAAC,CAC9B,KAAI,SAAQ;GAAE;GAAK,OAAO,eAAe,GAAG;EAAE,EAAE,CAAC,CACjD,QAAQ,EAAE,KAAK,YAAY,CAAC,UAAU;GAAC;GAAO,IAAI;GAAO,IAAI;EAAS,CAAC,CAAC,MAAK,SAAQ,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,CAC1H,MAAM,GAAG,SAAS,CAAC,CACnB,KAAK,EAAE,KAAK,aAA6B;GAAE,QAAQ,IAAI;GAAK,YAAY;GAAM,SAAS;GAAM;EAAM,EAAE;CAC1G;CACA,QAAQ,uBAAuC;EAC7C,UAAS,UAAS,EAAE,OAAO,KAAK,MAAM;EACtC,WAAW,EAAE,4BAA4B;EACzC,aAAa,EAAE,gBAAgB;CACjC,CAAC;AACH"}

package/dist/features/composites/reference-text.d.ts

@@ -0,0 +1,18 @@
+import { JSONContent } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/composites/reference-text.d.ts
+/** Block IDs of every composite in a TipTap JSON tree, added to `into`. */
+export declare function collectCompositeIds(content: JSONContent | null | undefined, into: Set<string>): Set<string>;
+/**
+ * Turns `[@<id>]` / `[@<id>, <locator>]` tokens in text nodes into `reference` nodes (attrs target, locator, empty
+ * `label`: the node view resolves the live label) — for imported and AI-generated Markdown, whose parser keeps the
+ * token as text. Only ids in `ids` (the Bausteine of the document) match; unknown ids and text in code blocks, inline
+ * code or links stay plain. Returns the input unchanged when nothing matched.
+ */
+export declare function referencesFromText(json: JSONContent, ids: ReadonlySet<string>): JSONContent;
+/** Block IDs of the composites of `doc`: the Bausteine a `[@id]` text may point at. */
+export declare function compositeIdsOf(doc: Node$1): Set<string>;
+/** The `normalize` stage: the composites of the document (`current`) and of `blocks` themselves may be referenced by text. */
+export declare function normalizeReferences(blocks: JSONContent[], current: ReadonlySet<string>): JSONContent[];
+//#endregion
+//# sourceMappingURL=reference-text.d.ts.map