@ecsplico/editor 3.6.0 → 4.1.0

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

@@ -1,4 +1,4 @@
-import { DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, STRUCTURE_MODES, TREE_ROOTS } from "../../../settings/values.js";
+import { BLOCK_TYPE_ICON_VISIBILITIES, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, STRUCTURE_MODES, TREE_ROOTS } from "../../../settings/values.js";
 import { SPLIT_TARGET_CHARS_MAX, clampSplitTargetChars } from "../../../settings/index.js";
 import { useEditorI18n } from "../../../react/use-editor-i18n.js";
 import { Icon } from "../../../react/Icon.js";
@@ -9,7 +9,7 @@ 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 { BLOCK_TYPE_ICON_KEYS, DRAG_HANDLE_KEYS, HEADING_SCOPE_KEYS, optionItems } from "../editing-settings-keys.js";
 import { TREE_ROOT_KEYS } from "../tree-root.js";
 import { useEffect, useId, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -56,10 +56,10 @@ function RadioOption({ item }) {
 		})]
 	});
 }
-/** „Bearbeiten“: Gliederung (structure mode, conversion scope), Bausteine defaults and the visibility of the block handles. */
-function SettingsEditingTab({ kinds }) {
+/** „Bearbeiten“: Gliederung (structure mode, conversion scope), Typed blocks defaults and the visibility of the block handles. */
+function SettingsEditingTab({ blockTypes }) {
 	const { settings, update } = useEditorSettings();
-	const kindLabelId = useId();
+	const blockTypeLabelId = useId();
 	const splitTargetId = useId();
 	const [splitTarget, setSplitTarget] = useState(String(settings.blocks.splitTargetChars));
 	useEffect(() => {
@@ -76,7 +76,7 @@ function SettingsEditingTab({ kinds }) {
 	const structureItems = optionItems(STRUCTURE_MODES, STRUCTURE_MODE_KEYS, t);
 	const scopeItems = optionItems(HEADING_CONVERSION_SCOPES, HEADING_SCOPE_KEYS, t);
 	const treeRootItems = optionItems(TREE_ROOTS, TREE_ROOT_KEYS, t);
-	const kindIconItems = optionItems(KIND_ICON_VISIBILITIES, KIND_ICON_KEYS, t);
+	const blockTypeIconItems = optionItems(BLOCK_TYPE_ICON_VISIBILITIES, BLOCK_TYPE_ICON_KEYS, t);
 	const dragHandleItems = optionItems(DRAG_HANDLE_VISIBILITIES, DRAG_HANDLE_KEYS, t);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "flex flex-col gap-8",
@@ -118,26 +118,26 @@ function SettingsEditingTab({ kinds }) {
 						children: [/* @__PURE__ */ jsxs("div", {
 							className: "min-w-0 flex-1",
 							children: [/* @__PURE__ */ jsx(Label, {
-								id: kindLabelId,
+								id: blockTypeLabelId,
 								className: "text-sm font-medium text-foreground",
-								children: t("composites.settings.defaultKind.label")
+								children: t("composites.settings.defaultBlockType.label")
 							}), /* @__PURE__ */ jsx("p", {
 								className: "text-sm text-muted-foreground",
-								children: t("composites.settings.defaultKind.description")
+								children: t("composites.settings.defaultBlockType.description")
 							})]
 						}), /* @__PURE__ */ jsxs(Select, {
-							value: settings.blocks.defaultKind,
+							value: settings.blocks.defaultBlockType,
 							onValueChange: (value) => update((draft) => {
-								draft.blocks.defaultKind = value;
+								draft.blocks.defaultBlockType = value;
 							}),
 							children: [/* @__PURE__ */ jsx(SelectTrigger, {
-								"aria-labelledby": kindLabelId,
+								"aria-labelledby": blockTypeLabelId,
 								className: "w-64",
 								children: /* @__PURE__ */ jsx(SelectValue, {})
-							}), /* @__PURE__ */ jsx(SelectContent, { children: kinds.map((kind) => /* @__PURE__ */ jsxs(SelectItem, {
-								value: kind.id,
-								children: [/* @__PURE__ */ jsx(Icon, { name: kind.icon }), kind.label]
-							}, kind.id)) })]
+							}), /* @__PURE__ */ jsx(SelectContent, { children: blockTypes.map((blockType) => /* @__PURE__ */ jsxs(SelectItem, {
+								value: blockType.id,
+								children: [/* @__PURE__ */ jsx(Icon, { name: blockType.icon }), blockType.label]
+							}, blockType.id)) })]
 						})]
 					}),
 					/* @__PURE__ */ jsxs("div", {
@@ -162,11 +162,11 @@ function SettingsEditingTab({ kinds }) {
 						})]
 					}),
 					/* @__PURE__ */ jsx(RadioField, {
-						legend: t("composites.settings.kindIcon.legend"),
-						items: kindIconItems,
-						value: settings.blocks.kindIcon,
+						legend: t("composites.settings.blockTypeIcon.legend"),
+						items: blockTypeIconItems,
+						value: settings.blocks.blockTypeIcon,
 						onChange: (value) => update((draft) => {
-							draft.blocks.kindIcon = value;
+							draft.blocks.blockTypeIcon = value;
 						})
 					}),
 					/* @__PURE__ */ jsx(RadioField, {

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

@@ -1 +1 @@
-{"version":3,"file":"SettingsEditingTab.js","names":[],"sources":["../../../../src/features/composites/react/SettingsEditingTab.tsx"],"sourcesContent":["import { useEffect, useId, useState } from 'react'\nimport { Icon } from '../../../react/Icon'\nimport { useEditorSettings } from '../../../react/settings'\nimport { SettingsSection } from '../../../react/SettingsSection'\nimport { Input } from '../../../react/ui/input'\nimport { Label } from '../../../react/ui/label'\nimport { RadioGroup, RadioGroupItem } from '../../../react/ui/radio-group'\nimport { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '../../../react/ui/select'\nimport { clampSplitTargetChars, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, SPLIT_TARGET_CHARS_MAX, SPLIT_TARGET_CHARS_MIN, STRUCTURE_MODES, TREE_ROOTS } from '../../../settings'\nimport { useEditorI18n } from '../../../react/use-editor-i18n'\nimport { DRAG_HANDLE_KEYS, HEADING_SCOPE_KEYS, KIND_ICON_KEYS, optionItems } from '../editing-settings-keys'\nimport type { CompositeKind } from '../kinds'\nimport { STRUCTURE_MODE_KEYS } from '../structure-mode'\nimport { TREE_ROOT_KEYS } from '../tree-root'\n\n/** A group of radio options under a legend (the counterpart of Nuxt UI's `URadioGroup`), the options one above the other. */\nfunction RadioField<T extends string>({ legend, items, value, onChange }: {\n  legend: string\n  items: readonly { label: string, description: string, value: T }[]\n  value: T\n  onChange: (value: T) => void\n}) {\n  const legendId = useId()\n  return (\n    <div className=\"py-3\">\n      <p id={legendId} className=\"mb-2 text-sm font-medium text-foreground\">{legend}</p>\n      <RadioGroup\n        aria-labelledby={legendId}\n        className=\"flex flex-col gap-2\"\n        value={value}\n        onValueChange={(next) => {\n          const item = items.find(candidate => candidate.value === next)\n          if (item) onChange(item.value)\n        }}\n      >\n        {items.map(item => <RadioOption key={item.value} item={item} />)}\n      </RadioGroup>\n    </div>\n  )\n}\n\nfunction RadioOption({ item }: { item: { label: string, description: string, value: string } }) {\n  const id = useId()\n  return (\n    <div className=\"flex items-start gap-2\">\n      <RadioGroupItem id={id} value={item.value} className=\"mt-0.5\" />\n      <Label htmlFor={id} className=\"flex-col items-start gap-0.5\">\n        <span className=\"text-sm font-medium text-foreground\">{item.label}</span>\n        <span className=\"text-sm font-normal text-muted-foreground\">{item.description}</span>\n      </Label>\n    </div>\n  )\n}\n\n/** „Bearbeiten“: Gliederung (structure mode, conversion scope), Bausteine defaults and the visibility of the block handles. */\nexport function SettingsEditingTab({ kinds }: { kinds: readonly CompositeKind[] }) {\n  const { settings, update } = useEditorSettings()\n  const kindLabelId = useId()\n  const splitTargetId = useId()\n  // The target size is edited as text and written back clamped to its range when the field is left, so a half-typed number never reaches the settings.\n  const [splitTarget, setSplitTarget] = useState(String(settings.blocks.splitTargetChars))\n  useEffect(() => { setSplitTarget(String(settings.blocks.splitTargetChars)) }, [settings.blocks.splitTargetChars])\n  const commitSplitTarget = () => {\n    const next = clampSplitTargetChars(splitTarget, settings.blocks.splitTargetChars)\n    update((draft) => { draft.blocks.splitTargetChars = next })\n    setSplitTarget(String(next))\n  }\n  const { t } = useEditorI18n()\n  const structureItems = optionItems(STRUCTURE_MODES, STRUCTURE_MODE_KEYS, t)\n  const scopeItems = optionItems(HEADING_CONVERSION_SCOPES, HEADING_SCOPE_KEYS, t)\n  const treeRootItems = optionItems(TREE_ROOTS, TREE_ROOT_KEYS, t)\n  const kindIconItems = optionItems(KIND_ICON_VISIBILITIES, KIND_ICON_KEYS, t)\n  const dragHandleItems = optionItems(DRAG_HANDLE_VISIBILITIES, DRAG_HANDLE_KEYS, t)\n\n  return (\n    <div className=\"flex flex-col gap-8\">\n      <SettingsSection title={t('composites.settings.structure.title')}>\n        <RadioField\n          legend={t('composites.settings.structure.legend')}\n          items={structureItems}\n          value={settings.blocks.structure}\n          onChange={value => update((draft) => { draft.blocks.structure = value })}\n        />\n        <RadioField\n          legend={t('composites.settings.scope.legend')}\n          items={scopeItems}\n          value={settings.editing.headingConversionScope}\n          onChange={value => update((draft) => { draft.editing.headingConversionScope = value })}\n        />\n      </SettingsSection>\n\n      <SettingsSection title={t('composites.settings.sidebar.title')}>\n        <RadioField\n          legend={t('composites.settings.treeRoot.legend')}\n          items={treeRootItems}\n          value={settings.blocks.treeRoot}\n          onChange={value => update((draft) => { draft.blocks.treeRoot = value })}\n        />\n      </SettingsSection>\n\n      <SettingsSection title={t('composites.settings.composites.title')}>\n        <div className=\"flex items-start justify-between gap-4 py-3\">\n          <div className=\"min-w-0 flex-1\">\n            <Label id={kindLabelId} className=\"text-sm font-medium text-foreground\">{t('composites.settings.defaultKind.label')}</Label>\n            <p className=\"text-sm text-muted-foreground\">{t('composites.settings.defaultKind.description')}</p>\n          </div>\n          <Select value={settings.blocks.defaultKind} onValueChange={value => update((draft) => { draft.blocks.defaultKind = value })}>\n            <SelectTrigger aria-labelledby={kindLabelId} className=\"w-64\">\n              <SelectValue />\n            </SelectTrigger>\n            <SelectContent>\n              {kinds.map(kind => (\n                <SelectItem key={kind.id} value={kind.id}>\n                  <Icon name={kind.icon} />\n                  {kind.label}\n                </SelectItem>\n              ))}\n            </SelectContent>\n          </Select>\n        </div>\n        <div className=\"flex items-start justify-between gap-4 py-3\">\n          <Label htmlFor={splitTargetId} className=\"min-w-0 flex-1 text-sm font-medium text-foreground\">{t('settings.editing.splitTargetChars')}</Label>\n          <Input\n            id={splitTargetId}\n            type=\"number\"\n            min={SPLIT_TARGET_CHARS_MIN}\n            max={SPLIT_TARGET_CHARS_MAX}\n            step={100}\n            className=\"w-32\"\n            value={splitTarget}\n            onChange={event => setSplitTarget(event.target.value)}\n            onBlur={commitSplitTarget}\n            onKeyDown={(event) => {\n              if (event.key === 'Enter') commitSplitTarget()\n            }}\n          />\n        </div>\n        <RadioField\n          legend={t('composites.settings.kindIcon.legend')}\n          items={kindIconItems}\n          value={settings.blocks.kindIcon}\n          onChange={value => update((draft) => { draft.blocks.kindIcon = value })}\n        />\n        <RadioField\n          legend={t('composites.settings.dragHandle.legend')}\n          items={dragHandleItems}\n          value={settings.blocks.dragHandle}\n          onChange={value => update((draft) => { draft.blocks.dragHandle = value })}\n        />\n      </SettingsSection>\n    </div>\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"SettingsEditingTab.js","names":[],"sources":["../../../../src/features/composites/react/SettingsEditingTab.tsx"],"sourcesContent":["import { useEffect, useId, useState } from 'react'\nimport { Icon } from '../../../react/Icon'\nimport { useEditorSettings } from '../../../react/settings'\nimport { SettingsSection } from '../../../react/SettingsSection'\nimport { Input } from '../../../react/ui/input'\nimport { Label } from '../../../react/ui/label'\nimport { RadioGroup, RadioGroupItem } from '../../../react/ui/radio-group'\nimport { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '../../../react/ui/select'\nimport { BLOCK_TYPE_ICON_VISIBILITIES, clampSplitTargetChars, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, SPLIT_TARGET_CHARS_MAX, SPLIT_TARGET_CHARS_MIN, STRUCTURE_MODES, TREE_ROOTS } from '../../../settings'\nimport { useEditorI18n } from '../../../react/use-editor-i18n'\nimport { BLOCK_TYPE_ICON_KEYS, DRAG_HANDLE_KEYS, HEADING_SCOPE_KEYS, optionItems } from '../editing-settings-keys'\nimport type { BlockType } from '../block-types'\nimport { STRUCTURE_MODE_KEYS } from '../structure-mode'\nimport { TREE_ROOT_KEYS } from '../tree-root'\n\n/** A group of radio options under a legend (the counterpart of Nuxt UI's `URadioGroup`), the options one above the other. */\nfunction RadioField<T extends string>({ legend, items, value, onChange }: {\n  legend: string\n  items: readonly { label: string, description: string, value: T }[]\n  value: T\n  onChange: (value: T) => void\n}) {\n  const legendId = useId()\n  return (\n    <div className=\"py-3\">\n      <p id={legendId} className=\"mb-2 text-sm font-medium text-foreground\">{legend}</p>\n      <RadioGroup\n        aria-labelledby={legendId}\n        className=\"flex flex-col gap-2\"\n        value={value}\n        onValueChange={(next) => {\n          const item = items.find(candidate => candidate.value === next)\n          if (item) onChange(item.value)\n        }}\n      >\n        {items.map(item => <RadioOption key={item.value} item={item} />)}\n      </RadioGroup>\n    </div>\n  )\n}\n\nfunction RadioOption({ item }: { item: { label: string, description: string, value: string } }) {\n  const id = useId()\n  return (\n    <div className=\"flex items-start gap-2\">\n      <RadioGroupItem id={id} value={item.value} className=\"mt-0.5\" />\n      <Label htmlFor={id} className=\"flex-col items-start gap-0.5\">\n        <span className=\"text-sm font-medium text-foreground\">{item.label}</span>\n        <span className=\"text-sm font-normal text-muted-foreground\">{item.description}</span>\n      </Label>\n    </div>\n  )\n}\n\n/** „Bearbeiten“: Gliederung (structure mode, conversion scope), Typed blocks defaults and the visibility of the block handles. */\nexport function SettingsEditingTab({ blockTypes }: { blockTypes: readonly BlockType[] }) {\n  const { settings, update } = useEditorSettings()\n  const blockTypeLabelId = useId()\n  const splitTargetId = useId()\n  // The target size is edited as text and written back clamped to its range when the field is left, so a half-typed number never reaches the settings.\n  const [splitTarget, setSplitTarget] = useState(String(settings.blocks.splitTargetChars))\n  useEffect(() => { setSplitTarget(String(settings.blocks.splitTargetChars)) }, [settings.blocks.splitTargetChars])\n  const commitSplitTarget = () => {\n    const next = clampSplitTargetChars(splitTarget, settings.blocks.splitTargetChars)\n    update((draft) => { draft.blocks.splitTargetChars = next })\n    setSplitTarget(String(next))\n  }\n  const { t } = useEditorI18n()\n  const structureItems = optionItems(STRUCTURE_MODES, STRUCTURE_MODE_KEYS, t)\n  const scopeItems = optionItems(HEADING_CONVERSION_SCOPES, HEADING_SCOPE_KEYS, t)\n  const treeRootItems = optionItems(TREE_ROOTS, TREE_ROOT_KEYS, t)\n  const blockTypeIconItems = optionItems(BLOCK_TYPE_ICON_VISIBILITIES, BLOCK_TYPE_ICON_KEYS, t)\n  const dragHandleItems = optionItems(DRAG_HANDLE_VISIBILITIES, DRAG_HANDLE_KEYS, t)\n\n  return (\n    <div className=\"flex flex-col gap-8\">\n      <SettingsSection title={t('composites.settings.structure.title')}>\n        <RadioField\n          legend={t('composites.settings.structure.legend')}\n          items={structureItems}\n          value={settings.blocks.structure}\n          onChange={value => update((draft) => { draft.blocks.structure = value })}\n        />\n        <RadioField\n          legend={t('composites.settings.scope.legend')}\n          items={scopeItems}\n          value={settings.editing.headingConversionScope}\n          onChange={value => update((draft) => { draft.editing.headingConversionScope = value })}\n        />\n      </SettingsSection>\n\n      <SettingsSection title={t('composites.settings.sidebar.title')}>\n        <RadioField\n          legend={t('composites.settings.treeRoot.legend')}\n          items={treeRootItems}\n          value={settings.blocks.treeRoot}\n          onChange={value => update((draft) => { draft.blocks.treeRoot = value })}\n        />\n      </SettingsSection>\n\n      <SettingsSection title={t('composites.settings.composites.title')}>\n        <div className=\"flex items-start justify-between gap-4 py-3\">\n          <div className=\"min-w-0 flex-1\">\n            <Label id={blockTypeLabelId} className=\"text-sm font-medium text-foreground\">{t('composites.settings.defaultBlockType.label')}</Label>\n            <p className=\"text-sm text-muted-foreground\">{t('composites.settings.defaultBlockType.description')}</p>\n          </div>\n          <Select value={settings.blocks.defaultBlockType} onValueChange={value => update((draft) => { draft.blocks.defaultBlockType = value })}>\n            <SelectTrigger aria-labelledby={blockTypeLabelId} className=\"w-64\">\n              <SelectValue />\n            </SelectTrigger>\n            <SelectContent>\n              {blockTypes.map(blockType => (\n                <SelectItem key={blockType.id} value={blockType.id}>\n                  <Icon name={blockType.icon} />\n                  {blockType.label}\n                </SelectItem>\n              ))}\n            </SelectContent>\n          </Select>\n        </div>\n        <div className=\"flex items-start justify-between gap-4 py-3\">\n          <Label htmlFor={splitTargetId} className=\"min-w-0 flex-1 text-sm font-medium text-foreground\">{t('settings.editing.splitTargetChars')}</Label>\n          <Input\n            id={splitTargetId}\n            type=\"number\"\n            min={SPLIT_TARGET_CHARS_MIN}\n            max={SPLIT_TARGET_CHARS_MAX}\n            step={100}\n            className=\"w-32\"\n            value={splitTarget}\n            onChange={event => setSplitTarget(event.target.value)}\n            onBlur={commitSplitTarget}\n            onKeyDown={(event) => {\n              if (event.key === 'Enter') commitSplitTarget()\n            }}\n          />\n        </div>\n        <RadioField\n          legend={t('composites.settings.blockTypeIcon.legend')}\n          items={blockTypeIconItems}\n          value={settings.blocks.blockTypeIcon}\n          onChange={value => update((draft) => { draft.blocks.blockTypeIcon = value })}\n        />\n        <RadioField\n          legend={t('composites.settings.dragHandle.legend')}\n          items={dragHandleItems}\n          value={settings.blocks.dragHandle}\n          onChange={value => update((draft) => { draft.blocks.dragHandle = value })}\n        />\n      </SettingsSection>\n    </div>\n  )\n}\n"],"mappings":"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"}

package/dist/features/composites/react.js

@@ -25,7 +25,7 @@ function compositeFeature(options = {}) {
 		focusChip: FocusChip,
 		settingsTab: SettingsEditingTab,
 		nodeViews: {
-			composite: ReactNodeViewRenderer(CompositeView),
+			typedBlock: ReactNodeViewRenderer(CompositeView),
 			reference: ReactNodeViewRenderer(ReferenceView)
 		}
 	}, options);

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 { ReferenceView } from './react/ReferenceView'\nimport { CompositeView } from './react/CompositeView'\nimport { FocusChip } from './react/FocusChip'\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 { FocusChip } from './react/FocusChip'\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    focusChip: FocusChip,\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":";;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAiB;CACpF,OAAO,qBAAwD;EAC7D,QAAQ;EACR,WAAW;EAEX,aAAa;EACb,WAAW;GAAE,WAAW,sBAAsB,aAAa;GAAG,WAAW,sBAAsB,aAAa;EAAE;CAChH,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 { FocusChip } from './react/FocusChip'\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 { FocusChip } from './react/FocusChip'\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    focusChip: FocusChip,\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: { typedBlock: ReactNodeViewRenderer(CompositeView), reference: ReactNodeViewRenderer(ReferenceView) },\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,iBAAiB,UAAmC,CAAC,GAAiB;CACpF,OAAO,qBAAwD;EAC7D,QAAQ;EACR,WAAW;EAEX,aAAa;EACb,WAAW;GAAE,YAAY,sBAAsB,aAAa;GAAG,WAAW,sBAAsB,aAAa;EAAE;CACjH,GAAG,OAAO;AACZ"}

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

@@ -6,7 +6,7 @@
 const REFERENCE_AI_BLOCK = {
 	id: "reference",
 	label: "Verweis",
-	description: "Inline-Verweis auf einen Baustein dieses Dokuments (Zitat, Quelle), optional mit Fundstelle (Seite oder Zeit).",
+	description: "Inline-Verweis auf einen Typed block 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]."
 };

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

@@ -1 +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"}
+{"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 Typed block 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

@@ -1,4 +1,4 @@
-import { CompositeKind } from "./kinds.js";
+import { BlockType } from "./block-types.js";
 import "./reference.js";
 import { Editor } from "@tiptap/core";
 import { Node as Node$1 } from "@tiptap/pm/model";
@@ -9,8 +9,8 @@ export interface ReferenceTarget {
   title: string;
   kindLabel: string;
 }
-/** The Baustein `node` as a reference target. */
-export declare function referenceTarget(node: Node$1, kinds: readonly CompositeKind[]): ReferenceTarget;
+/** The Typed block `node` as a reference target. */
+export declare function referenceTarget(node: Node$1, kinds: readonly BlockType[]): 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. */

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

@@ -1,15 +1,15 @@
 import { findBlockById } from "../../core/schema/block-ids.js";
-import { compositeKind } from "./kinds.js";
+import { blockTypeOf } from "./block-types.js";
 import "./meta-keys.js";
-import { compositeKindsOf } from "./nodes.js";
+import { blockTypesOf } from "./nodes.js";
 import { citeFull, citeShort } from "./bibliography.js";
 //#region src/features/composites/reference-label.ts
-/** The Baustein `node` as a reference target. */
+/** The Typed block `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
+		kindLabel: blockTypeOf(kinds, String(node.attrs.blockType)).label
 	};
 }
 const bibOfTarget = (target) => {
@@ -40,12 +40,12 @@ function referenceAttrsOf(node) {
 /** 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 {
+	if (found?.node.type.name !== "typedBlock") return {
 		label: attrs.label,
 		title: attrs.label,
 		gone: true
 	};
-	const target = referenceTarget(found.node, compositeKindsOf(editor));
+	const target = referenceTarget(found.node, blockTypesOf(editor));
 	return {
 		label: referenceLabel(target),
 		title: referenceTitle(target),

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

@@ -1 +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"}
+{"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 { type BlockType, blockTypeOf } from './block-types'\nimport { blockTypesOf } 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 Typed block `node` as a reference target. */\nexport function referenceTarget(node: PMNode, kinds: readonly BlockType[]): ReferenceTarget {\n  return {\n    meta: (node.attrs.meta ?? {}) as Record<string, unknown>,\n    title: node.childCount > 0 ? node.child(0).textContent.trim() : '',\n    kindLabel: blockTypeOf(kinds, String(node.attrs.blockType)).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 !== 'typedBlock') return { label: attrs.label, title: attrs.label, gone: true }\n  const target = referenceTarget(found.node, blockTypesOf(editor))\n  return { label: referenceLabel(target), title: referenceTitle(target), gone: false }\n}\n"],"mappings":";;;;;;;AAgBA,SAAgB,gBAAgB,MAAc,OAA8C;CAC1F,OAAO;EACL,MAAO,KAAK,MAAM,QAAQ,CAAC;EAC3B,OAAO,KAAK,aAAa,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI;EAChE,WAAW,YAAY,OAAO,OAAO,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC;CAC9D;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,cAAc,OAAO;EAAE,OAAO,MAAM;EAAO,OAAO,MAAM;EAAO,MAAM;CAAK;CACxG,MAAM,SAAS,gBAAgB,MAAM,MAAM,aAAa,MAAM,CAAC;CAC/D,OAAO;EAAE,OAAO,eAAe,MAAM;EAAG,OAAO,eAAe,MAAM;EAAG,MAAM;CAAM;AACrF"}

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

@@ -2,7 +2,7 @@ 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
+ * `[@` trigger for ReferenceNode: the Typed blocks of the document (with a block ID) whose title, Block type 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"]>;

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

@@ -1,21 +1,21 @@
 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 { blockTypesOf } 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
+* `[@` trigger for ReferenceNode: the Typed blocks of the document (with a block ID) whose title, Block type 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) => ({
+		return compositeRows(editor.state.doc, blockTypesOf(editor)).rows.filter((row) => row.id !== null).map((row) => ({
 			row,
 			label: referenceLabel(row)
 		})).filter(({ row, label }) => !needle || [

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

@@ -1 +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"}
+{"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 { blockTypesOf } 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 Typed blocks of the document (with a block ID) whose title, Block type 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, blockTypesOf(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,aAAa,MAAM,CAAC,CAAC,CAAC,KAC1D,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

@@ -6,11 +6,11 @@ export declare function collectCompositeIds(content: JSONContent | null | undefi
 /**
  * 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
+ * token as text. Only ids in `ids` (the Typed blocks 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. */
+/** Block IDs of the composites of `doc`: the Typed blocks 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[];

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

@@ -6,14 +6,14 @@ const TOKEN = new RegExp(REFERENCE_TOKEN_SOURCE, "g");
 /** Block IDs of every composite in a TipTap JSON tree, added to `into`. */
 function collectCompositeIds(content, into) {
 	if (!content) return into;
-	if (content.type === "composite" && typeof content.attrs?.id === "string" && content.attrs.id) into.add(content.attrs.id);
+	if (content.type === "typedBlock" && typeof content.attrs?.id === "string" && content.attrs.id) into.add(content.attrs.id);
 	for (const child of content.content ?? []) collectCompositeIds(child, into);
 	return into;
 }
 /**
 * 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
+* token as text. Only ids in `ids` (the Typed blocks of the document) match; unknown ids and text in code blocks, inline
 * code or links stay plain. Returns the input unchanged when nothing matched.
 */
 function referencesFromText(json, ids) {
@@ -65,11 +65,11 @@ function referencesFromText(json, ids) {
 	};
 	return walk(json);
 }
-/** Block IDs of the composites of `doc`: the Bausteine a `[@id]` text may point at. */
+/** Block IDs of the composites of `doc`: the Typed blocks a `[@id]` text may point at. */
 function compositeIdsOf(doc) {
 	const ids = /* @__PURE__ */ new Set();
 	doc.descendants((node) => {
-		if (node.type.name !== "composite") return;
+		if (node.type.name !== "typedBlock") return;
 		const id = blockIdOf(node);
 		if (id) ids.add(id);
 	});

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

@@ -1 +1 @@
-{"version":3,"file":"reference-text.js","names":[],"sources":["../../../src/features/composites/reference-text.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { blockIdOf } from '../../core/schema'\nimport { REFERENCE_TOKEN_SOURCE } from './reference'\n\n/** `[@<block id>]` or `[@<block id>, <locator>]`; a `]` inside the locator is written `\\]`. */\nconst TOKEN = new RegExp(REFERENCE_TOKEN_SOURCE, 'g')\n\n/** Block IDs of every composite in a TipTap JSON tree, added to `into`. */\nexport function collectCompositeIds(content: JSONContent | null | undefined, into: Set<string>): Set<string> {\n  if (!content) return into\n  if (content.type === 'composite' && typeof content.attrs?.id === 'string' && content.attrs.id) into.add(content.attrs.id)\n  for (const child of content.content ?? []) collectCompositeIds(child, into)\n  return into\n}\n\n/**\n * Turns `[@<id>]` / `[@<id>, <locator>]` tokens in text nodes into `reference` nodes (attrs target, locator, empty\n * `label`: the node view resolves the live label) — for imported and AI-generated Markdown, whose parser keeps the\n * token as text. Only ids in `ids` (the Bausteine of the document) match; unknown ids and text in code blocks, inline\n * code or links stay plain. Returns the input unchanged when nothing matched.\n */\nexport function referencesFromText(json: JSONContent, ids: ReadonlySet<string>): JSONContent {\n  if (!ids.size) return json\n\n  const splitText = (node: JSONContent): JSONContent[] => {\n    const text = node.text ?? ''\n    if (!text.includes('[@') || node.marks?.some(m => m.type === 'code' || m.type === 'link')) return [node]\n    const out: JSONContent[] = []\n    let last = 0\n    for (const match of text.matchAll(TOKEN)) {\n      const target = match[1]!\n      if (!ids.has(target)) continue\n      const at = match.index ?? 0\n      if (at > last) out.push({ ...node, text: text.slice(last, at) })\n      out.push({\n        type: 'reference',\n        attrs: { target, documentId: null, locator: match[2]?.replace(/\\\\\\]/g, ']').trim() || null, label: '' },\n        ...(node.marks?.length ? { marks: node.marks } : {}),\n      })\n      last = at + match[0].length\n    }\n    if (!out.length) return [node]\n    if (last < text.length) out.push({ ...node, text: text.slice(last) })\n    return out\n  }\n\n  const walk = (node: JSONContent): JSONContent => {\n    if (!node.content || node.type === 'codeBlock') return node\n    let changed = false\n    const content = node.content.flatMap((child) => {\n      const next = child.type === 'text' ? splitText(child) : [walk(child)]\n      if (next.length !== 1 || next[0] !== child) changed = true\n      return next\n    })\n    return changed ? { ...node, content } : node\n  }\n  return walk(json)\n}\n\n/** Block IDs of the composites of `doc`: the Bausteine a `[@id]` text may point at. */\nexport function compositeIdsOf(doc: PMNode): Set<string> {\n  const ids = new Set<string>()\n  doc.descendants((node) => {\n    if (node.type.name !== 'composite') return\n    const id = blockIdOf(node)\n    if (id) ids.add(id)\n  })\n  return ids\n}\n\n/** The `normalize` stage: the composites of the document (`current`) and of `blocks` themselves may be referenced by text. */\nexport function normalizeReferences(blocks: JSONContent[], current: ReadonlySet<string>): JSONContent[] {\n  const doc: JSONContent = { type: 'doc', content: blocks }\n  return referencesFromText(doc, collectCompositeIds(doc, new Set(current))).content ?? []\n}\n"],"mappings":";;;;AAMA,MAAM,QAAQ,IAAI,OAAO,wBAAwB,GAAG;;AAGpD,SAAgB,oBAAoB,SAAyC,MAAgC;CAC3G,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,SAAS,eAAe,OAAO,QAAQ,OAAO,OAAO,YAAY,QAAQ,MAAM,IAAI,KAAK,IAAI,QAAQ,MAAM,EAAE;CACxH,KAAK,MAAM,SAAS,QAAQ,WAAW,CAAC,GAAG,oBAAoB,OAAO,IAAI;CAC1E,OAAO;AACT;;;;;;;AAQA,SAAgB,mBAAmB,MAAmB,KAAuC;CAC3F,IAAI,CAAC,IAAI,MAAM,OAAO;CAEtB,MAAM,aAAa,SAAqC;EACtD,MAAM,OAAO,KAAK,QAAQ;EAC1B,IAAI,CAAC,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,MAAK,MAAK,EAAE,SAAS,UAAU,EAAE,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI;EACvG,MAAM,MAAqB,CAAC;EAC5B,IAAI,OAAO;EACX,KAAK,MAAM,SAAS,KAAK,SAAS,KAAK,GAAG;GACxC,MAAM,SAAS,MAAM;GACrB,IAAI,CAAC,IAAI,IAAI,MAAM,GAAG;GACtB,MAAM,KAAK,MAAM,SAAS;GAC1B,IAAI,KAAK,MAAM,IAAI,KAAK;IAAE,GAAG;IAAM,MAAM,KAAK,MAAM,MAAM,EAAE;GAAE,CAAC;GAC/D,IAAI,KAAK;IACP,MAAM;IACN,OAAO;KAAE;KAAQ,YAAY;KAAM,SAAS,MAAM,EAAE,EAAE,QAAQ,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK;KAAM,OAAO;IAAG;IACtG,GAAI,KAAK,OAAO,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GACpD,CAAC;GACD,OAAO,KAAK,MAAM,EAAE,CAAC;EACvB;EACA,IAAI,CAAC,IAAI,QAAQ,OAAO,CAAC,IAAI;EAC7B,IAAI,OAAO,KAAK,QAAQ,IAAI,KAAK;GAAE,GAAG;GAAM,MAAM,KAAK,MAAM,IAAI;EAAE,CAAC;EACpE,OAAO;CACT;CAEA,MAAM,QAAQ,SAAmC;EAC/C,IAAI,CAAC,KAAK,WAAW,KAAK,SAAS,aAAa,OAAO;EACvD,IAAI,UAAU;EACd,MAAM,UAAU,KAAK,QAAQ,SAAS,UAAU;GAC9C,MAAM,OAAO,MAAM,SAAS,SAAS,UAAU,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC;GACpE,IAAI,KAAK,WAAW,KAAK,KAAK,OAAO,OAAO,UAAU;GACtD,OAAO;EACT,CAAC;EACD,OAAO,UAAU;GAAE,GAAG;GAAM;EAAQ,IAAI;CAC1C;CACA,OAAO,KAAK,IAAI;AAClB;;AAGA,SAAgB,eAAe,KAA0B;CACvD,MAAM,sBAAM,IAAI,IAAY;CAC5B,IAAI,aAAa,SAAS;EACxB,IAAI,KAAK,KAAK,SAAS,aAAa;EACpC,MAAM,KAAK,UAAU,IAAI;EACzB,IAAI,IAAI,IAAI,IAAI,EAAE;CACpB,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,oBAAoB,QAAuB,SAA6C;CACtG,MAAM,MAAmB;EAAE,MAAM;EAAO,SAAS;CAAO;CACxD,OAAO,mBAAmB,KAAK,oBAAoB,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AACzF"}
+{"version":3,"file":"reference-text.js","names":[],"sources":["../../../src/features/composites/reference-text.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { blockIdOf } from '../../core/schema'\nimport { REFERENCE_TOKEN_SOURCE } from './reference'\n\n/** `[@<block id>]` or `[@<block id>, <locator>]`; a `]` inside the locator is written `\\]`. */\nconst TOKEN = new RegExp(REFERENCE_TOKEN_SOURCE, 'g')\n\n/** Block IDs of every composite in a TipTap JSON tree, added to `into`. */\nexport function collectCompositeIds(content: JSONContent | null | undefined, into: Set<string>): Set<string> {\n  if (!content) return into\n  if (content.type === 'typedBlock' && typeof content.attrs?.id === 'string' && content.attrs.id) into.add(content.attrs.id)\n  for (const child of content.content ?? []) collectCompositeIds(child, into)\n  return into\n}\n\n/**\n * Turns `[@<id>]` / `[@<id>, <locator>]` tokens in text nodes into `reference` nodes (attrs target, locator, empty\n * `label`: the node view resolves the live label) — for imported and AI-generated Markdown, whose parser keeps the\n * token as text. Only ids in `ids` (the Typed blocks of the document) match; unknown ids and text in code blocks, inline\n * code or links stay plain. Returns the input unchanged when nothing matched.\n */\nexport function referencesFromText(json: JSONContent, ids: ReadonlySet<string>): JSONContent {\n  if (!ids.size) return json\n\n  const splitText = (node: JSONContent): JSONContent[] => {\n    const text = node.text ?? ''\n    if (!text.includes('[@') || node.marks?.some(m => m.type === 'code' || m.type === 'link')) return [node]\n    const out: JSONContent[] = []\n    let last = 0\n    for (const match of text.matchAll(TOKEN)) {\n      const target = match[1]!\n      if (!ids.has(target)) continue\n      const at = match.index ?? 0\n      if (at > last) out.push({ ...node, text: text.slice(last, at) })\n      out.push({\n        type: 'reference',\n        attrs: { target, documentId: null, locator: match[2]?.replace(/\\\\\\]/g, ']').trim() || null, label: '' },\n        ...(node.marks?.length ? { marks: node.marks } : {}),\n      })\n      last = at + match[0].length\n    }\n    if (!out.length) return [node]\n    if (last < text.length) out.push({ ...node, text: text.slice(last) })\n    return out\n  }\n\n  const walk = (node: JSONContent): JSONContent => {\n    if (!node.content || node.type === 'codeBlock') return node\n    let changed = false\n    const content = node.content.flatMap((child) => {\n      const next = child.type === 'text' ? splitText(child) : [walk(child)]\n      if (next.length !== 1 || next[0] !== child) changed = true\n      return next\n    })\n    return changed ? { ...node, content } : node\n  }\n  return walk(json)\n}\n\n/** Block IDs of the composites of `doc`: the Typed blocks a `[@id]` text may point at. */\nexport function compositeIdsOf(doc: PMNode): Set<string> {\n  const ids = new Set<string>()\n  doc.descendants((node) => {\n    if (node.type.name !== 'typedBlock') return\n    const id = blockIdOf(node)\n    if (id) ids.add(id)\n  })\n  return ids\n}\n\n/** The `normalize` stage: the composites of the document (`current`) and of `blocks` themselves may be referenced by text. */\nexport function normalizeReferences(blocks: JSONContent[], current: ReadonlySet<string>): JSONContent[] {\n  const doc: JSONContent = { type: 'doc', content: blocks }\n  return referencesFromText(doc, collectCompositeIds(doc, new Set(current))).content ?? []\n}\n"],"mappings":";;;;AAMA,MAAM,QAAQ,IAAI,OAAO,wBAAwB,GAAG;;AAGpD,SAAgB,oBAAoB,SAAyC,MAAgC;CAC3G,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,QAAQ,SAAS,gBAAgB,OAAO,QAAQ,OAAO,OAAO,YAAY,QAAQ,MAAM,IAAI,KAAK,IAAI,QAAQ,MAAM,EAAE;CACzH,KAAK,MAAM,SAAS,QAAQ,WAAW,CAAC,GAAG,oBAAoB,OAAO,IAAI;CAC1E,OAAO;AACT;;;;;;;AAQA,SAAgB,mBAAmB,MAAmB,KAAuC;CAC3F,IAAI,CAAC,IAAI,MAAM,OAAO;CAEtB,MAAM,aAAa,SAAqC;EACtD,MAAM,OAAO,KAAK,QAAQ;EAC1B,IAAI,CAAC,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,MAAK,MAAK,EAAE,SAAS,UAAU,EAAE,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI;EACvG,MAAM,MAAqB,CAAC;EAC5B,IAAI,OAAO;EACX,KAAK,MAAM,SAAS,KAAK,SAAS,KAAK,GAAG;GACxC,MAAM,SAAS,MAAM;GACrB,IAAI,CAAC,IAAI,IAAI,MAAM,GAAG;GACtB,MAAM,KAAK,MAAM,SAAS;GAC1B,IAAI,KAAK,MAAM,IAAI,KAAK;IAAE,GAAG;IAAM,MAAM,KAAK,MAAM,MAAM,EAAE;GAAE,CAAC;GAC/D,IAAI,KAAK;IACP,MAAM;IACN,OAAO;KAAE;KAAQ,YAAY;KAAM,SAAS,MAAM,EAAE,EAAE,QAAQ,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK;KAAM,OAAO;IAAG;IACtG,GAAI,KAAK,OAAO,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GACpD,CAAC;GACD,OAAO,KAAK,MAAM,EAAE,CAAC;EACvB;EACA,IAAI,CAAC,IAAI,QAAQ,OAAO,CAAC,IAAI;EAC7B,IAAI,OAAO,KAAK,QAAQ,IAAI,KAAK;GAAE,GAAG;GAAM,MAAM,KAAK,MAAM,IAAI;EAAE,CAAC;EACpE,OAAO;CACT;CAEA,MAAM,QAAQ,SAAmC;EAC/C,IAAI,CAAC,KAAK,WAAW,KAAK,SAAS,aAAa,OAAO;EACvD,IAAI,UAAU;EACd,MAAM,UAAU,KAAK,QAAQ,SAAS,UAAU;GAC9C,MAAM,OAAO,MAAM,SAAS,SAAS,UAAU,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC;GACpE,IAAI,KAAK,WAAW,KAAK,KAAK,OAAO,OAAO,UAAU;GACtD,OAAO;EACT,CAAC;EACD,OAAO,UAAU;GAAE,GAAG;GAAM;EAAQ,IAAI;CAC1C;CACA,OAAO,KAAK,IAAI;AAClB;;AAGA,SAAgB,eAAe,KAA0B;CACvD,MAAM,sBAAM,IAAI,IAAY;CAC5B,IAAI,aAAa,SAAS;EACxB,IAAI,KAAK,KAAK,SAAS,cAAc;EACrC,MAAM,KAAK,UAAU,IAAI;EACzB,IAAI,IAAI,IAAI,IAAI,EAAE;CACpB,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,oBAAoB,QAAuB,SAA6C;CACtG,MAAM,MAAmB;EAAE,MAAM;EAAO,SAAS;CAAO;CACxD,OAAO,mBAAmB,KAAK,oBAAoB,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AACzF"}

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

@@ -3,14 +3,14 @@ import { PluginKey } from "@tiptap/pm/state";
 import { SuggestionOptions } from "@tiptap/suggestion";
 //#region src/features/composites/reference.d.ts
 /**
- * Attributes of a reference chip. `target` is the block ID of the referenced Baustein; `label` caches its display text
+ * Attributes of a reference chip. `target` is the block ID of the referenced Typed block; `label` caches its display text
  * for the cases the target cannot be resolved (the node view shows the live label and only falls back to this one).
  */
 export interface ReferenceAttrs {
   target: string;
   /** Document of the target; `null` = this document (cross-document references are not resolved yet). */
   documentId: string | null;
-  /** Position inside the target's source: `S. 12` (PDF page), `03:14` (recording time); `null` = the whole Baustein. */
+  /** Position inside the target's source: `S. 12` (PDF page), `03:14` (recording time); `null` = the whole Typed block. */
   locator: string | null;
   label: string;
 }
@@ -35,7 +35,7 @@ export interface ReferenceOptions {
 /** Own key, so the `[@` popup runs next to the `@` mention and `#` tag popups. */
 export declare const ReferenceSuggestionPluginKey: PluginKey<any>;
 /**
- * Inline chip pointing at a Baustein of the document (a paper, a recording, a note): shared by the client editor and
+ * Inline chip pointing at a Typed block of the document (a paper, a recording, a note): shared by the client editor and
  * the server (collab schema, Markdown). Markdown form `[@<block id>, <locator>]`; text of that form becomes chips again
  * through `referencesFromText` (the composites feature's `normalize` stage). The client adds the node view and the popup.
  */

package/dist/features/composites/reference.js

@@ -13,7 +13,7 @@ const REFERENCE_TOKEN_SOURCE = String.raw`\[@([0-9a-f-]{36})(?:,\s*((?:\\\]|[^\]
 /** Own key, so the `[@` popup runs next to the `@` mention and `#` tag popups. */
 const ReferenceSuggestionPluginKey = new PluginKey("referenceSuggestion");
 /**
-* Inline chip pointing at a Baustein of the document (a paper, a recording, a note): shared by the client editor and
+* Inline chip pointing at a Typed block of the document (a paper, a recording, a note): shared by the client editor and
 * the server (collab schema, Markdown). Markdown form `[@<block id>, <locator>]`; text of that form becomes chips again
 * through `referencesFromText` (the composites feature's `normalize` stage). The client adds the node view and the popup.
 */

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

@@ -1 +1 @@
-{"version":3,"file":"reference.js","names":[],"sources":["../../../src/features/composites/reference.ts"],"sourcesContent":["import { Extension, mergeAttributes, Node } from '@tiptap/core'\nimport { PluginKey } from '@tiptap/pm/state'\nimport { Suggestion, type SuggestionOptions } from '@tiptap/suggestion'\n\n/**\n * Attributes of a reference chip. `target` is the block ID of the referenced Baustein; `label` caches its display text\n * for the cases the target cannot be resolved (the node view shows the live label and only falls back to this one).\n */\nexport interface ReferenceAttrs {\n  target: string\n  /** Document of the target; `null` = this document (cross-document references are not resolved yet). */\n  documentId: string | null\n  /** Position inside the target's source: `S. 12` (PDF page), `03:14` (recording time); `null` = the whole Baustein. */\n  locator: string | null\n  label: string\n}\n\nexport const REFERENCE_NODE = 'reference'\n\n/** Trigger of the popup. Two characters: `[@` is the Markdown form, so typing it by hand and picking from the list agree. */\nexport const REFERENCE_TRIGGER = '[@'\n\n/** `[@<target>]` / `[@<target>, <locator>]`, the chip's Markdown form; `]` in a locator is escaped as `\\]`. */\nexport function referenceMarkdown(attrs: Pick<ReferenceAttrs, 'target' | 'locator'>): string {\n  const locator = attrs.locator?.trim()\n  return locator ? `[@${attrs.target}, ${locator.replace(/\\]/g, '\\\\]')}]` : `[@${attrs.target}]`\n}\n\n/** Pattern of the chip's Markdown form (capture 1: block id, capture 2: locator with `\\]` still escaped); compile with `new RegExp(..., 'g')`. */\nexport const REFERENCE_TOKEN_SOURCE = String.raw`\\[@([0-9a-f-]{36})(?:,\\s*((?:\\\\\\]|[^\\]])+))?\\]`\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    reference: {\n      /** Inserts a reference chip (followed by a space) at the selection. */\n      insertReference: (attrs: Partial<ReferenceAttrs> & Pick<ReferenceAttrs, 'target'>) => ReturnType\n      /** Sets the locator of the reference chip at `pos`; an empty text clears it. */\n      setReferenceLocator: (pos: number, locator: string) => ReturnType\n    }\n  }\n}\n\nexport interface ReferenceOptions {\n  HTMLAttributes: Record<string, unknown>\n  /** `[@` popup (client only, see reference-suggestion.ts); `null` = schema only (server, Markdown). */\n  suggestion: Omit<SuggestionOptions<ReferenceAttrs, ReferenceAttrs>, 'editor'> | null\n}\n\n/** Own key, so the `[@` popup runs next to the `@` mention and `#` tag popups. */\nexport const ReferenceSuggestionPluginKey = new PluginKey('referenceSuggestion')\n\n/**\n * Inline chip pointing at a Baustein of the document (a paper, a recording, a note): shared by the client editor and\n * the server (collab schema, Markdown). Markdown form `[@<block id>, <locator>]`; text of that form becomes chips again\n * through `referencesFromText` (the composites feature's `normalize` stage). The client adds the node view and the popup.\n */\nexport const ReferenceNode = Node.create<ReferenceOptions>({\n  name: REFERENCE_NODE,\n  group: 'inline',\n  inline: true,\n  atom: true,\n  selectable: true,\n  // Just below Mention (100): TipTap's Markdown manager registers the tokenizers in priority order and marked tries the\n  // last registered first, so `markdownTokenizer` below sees `[@<id>]` before Mention's `[@ ...]` shortcode does.\n  priority: 99,\n\n  // Claims `[@<block id>, <locator>]` as plain text, so Mention's tokenizer (which takes every `[@...]`) leaves it alone;\n  // the composites feature's `normalize` stage turns it into a chip when the id belongs to a Baustein of the document.\n  markdownTokenizer: {\n    name: 'referenceToken',\n    level: 'inline',\n    start: src => src.search(/\\[@[0-9a-f-]{36}/),\n    tokenize: (src) => {\n      const match = new RegExp(`^${REFERENCE_TOKEN_SOURCE}`).exec(src)\n      return match ? { type: 'text', raw: match[0], text: match[0] } : undefined\n    },\n  },\n\n  addOptions() {\n    return { HTMLAttributes: { class: 'reference' }, suggestion: null }\n  },\n\n  addAttributes() {\n    return {\n      target: {\n        default: '',\n        parseHTML: el => el.getAttribute('data-target') ?? '',\n        renderHTML: attrs => ({ 'data-target': attrs.target }),\n      },\n      documentId: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-document'),\n        renderHTML: attrs => attrs.documentId ? { 'data-document': attrs.documentId } : {},\n      },\n      locator: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-locator'),\n        renderHTML: attrs => attrs.locator ? { 'data-locator': attrs.locator } : {},\n      },\n      label: {\n        default: '',\n        parseHTML: el => el.getAttribute('data-label') ?? el.textContent ?? '',\n        renderHTML: attrs => ({ 'data-label': attrs.label }),\n      },\n    }\n  },\n\n  parseHTML() {\n    return [{ tag: `span[data-type=\"${this.name}\"]` }]\n  },\n\n  renderHTML({ node, HTMLAttributes }) {\n    return ['span', mergeAttributes({ 'data-type': this.name }, this.options.HTMLAttributes, HTMLAttributes), String(node.attrs.label ?? '')]\n  },\n\n  renderText: ({ node }) => referenceMarkdown(node.attrs as ReferenceAttrs),\n\n  // Markdown export (editor.getMarkdown(), AI context/selection) writes the chip as `[@<id>, <locator>]`.\n  renderMarkdown: node => referenceMarkdown({ target: String(node.attrs?.target ?? ''), locator: typeof node.attrs?.locator === 'string' ? node.attrs.locator : null }),\n\n  addCommands() {\n    return {\n      insertReference: attrs => ({ commands }) =>\n        commands.insertContent([{ type: this.name, attrs }, { type: 'text', text: ' ' }]),\n      setReferenceLocator: (pos, locator) => ({ tr, dispatch }) => {\n        const node = tr.doc.nodeAt(pos)\n        if (node?.type.name !== this.name) return false\n        if (dispatch) tr.setNodeMarkup(pos, undefined, { ...node.attrs, locator: locator.trim() || null })\n        return true\n      },\n    }\n  },\n\n  // The popup lives in a companion extension (see `ReferenceSuggestion`): it must rank above TipTap's core keymap\n  // (100) to see Enter first, which this node cannot (its priority orders the Markdown tokenizer).\n  addExtensions() {\n    const { suggestion } = this.options\n    return suggestion ? [ReferenceSuggestion.configure({ suggestion })] : []\n  },\n})\n\n/**\n * The `[@` popup of ReferenceNode. Priority 101 (like TagNode), above core's Keymap (100): extension priority orders\n * the ProseMirror plugins' `handleKeyDown`, and with a lower one Enter would split the paragraph instead of picking.\n */\nexport const ReferenceSuggestion = Extension.create<{ suggestion: NonNullable<ReferenceOptions['suggestion']> | null }>({\n  name: 'referenceSuggestion',\n  priority: 101,\n\n  addOptions() {\n    return { suggestion: null }\n  },\n\n  addProseMirrorPlugins() {\n    const { suggestion } = this.options\n    if (!suggestion) return []\n    const { allow, ...rest } = suggestion\n    return [Suggestion<ReferenceAttrs, ReferenceAttrs>({\n      pluginKey: ReferenceSuggestionPluginKey,\n      char: REFERENCE_TRIGGER,\n      allowSpaces: true,\n      allow: p => allow?.(p) ?? true,\n      command: ({ editor, range, props }) => {\n        // Reuse a following space instead of doubling it (as Mention does).\n        const nodeAfter = editor.view.state.selection.$to.nodeAfter\n        if (nodeAfter?.text?.startsWith(' ')) range.to += 1\n        editor.chain().focus()\n          .insertContentAt(range, [{ type: REFERENCE_NODE, attrs: props }, { type: 'text', text: ' ' }])\n          .run()\n        editor.view.dom.ownerDocument.defaultView?.getSelection()?.collapseToEnd()\n      },\n      ...rest,\n      editor: this.editor,\n    })]\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"reference.js","names":[],"sources":["../../../src/features/composites/reference.ts"],"sourcesContent":["import { Extension, mergeAttributes, Node } from '@tiptap/core'\nimport { PluginKey } from '@tiptap/pm/state'\nimport { Suggestion, type SuggestionOptions } from '@tiptap/suggestion'\n\n/**\n * Attributes of a reference chip. `target` is the block ID of the referenced Typed block; `label` caches its display text\n * for the cases the target cannot be resolved (the node view shows the live label and only falls back to this one).\n */\nexport interface ReferenceAttrs {\n  target: string\n  /** Document of the target; `null` = this document (cross-document references are not resolved yet). */\n  documentId: string | null\n  /** Position inside the target's source: `S. 12` (PDF page), `03:14` (recording time); `null` = the whole Typed block. */\n  locator: string | null\n  label: string\n}\n\nexport const REFERENCE_NODE = 'reference'\n\n/** Trigger of the popup. Two characters: `[@` is the Markdown form, so typing it by hand and picking from the list agree. */\nexport const REFERENCE_TRIGGER = '[@'\n\n/** `[@<target>]` / `[@<target>, <locator>]`, the chip's Markdown form; `]` in a locator is escaped as `\\]`. */\nexport function referenceMarkdown(attrs: Pick<ReferenceAttrs, 'target' | 'locator'>): string {\n  const locator = attrs.locator?.trim()\n  return locator ? `[@${attrs.target}, ${locator.replace(/\\]/g, '\\\\]')}]` : `[@${attrs.target}]`\n}\n\n/** Pattern of the chip's Markdown form (capture 1: block id, capture 2: locator with `\\]` still escaped); compile with `new RegExp(..., 'g')`. */\nexport const REFERENCE_TOKEN_SOURCE = String.raw`\\[@([0-9a-f-]{36})(?:,\\s*((?:\\\\\\]|[^\\]])+))?\\]`\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    reference: {\n      /** Inserts a reference chip (followed by a space) at the selection. */\n      insertReference: (attrs: Partial<ReferenceAttrs> & Pick<ReferenceAttrs, 'target'>) => ReturnType\n      /** Sets the locator of the reference chip at `pos`; an empty text clears it. */\n      setReferenceLocator: (pos: number, locator: string) => ReturnType\n    }\n  }\n}\n\nexport interface ReferenceOptions {\n  HTMLAttributes: Record<string, unknown>\n  /** `[@` popup (client only, see reference-suggestion.ts); `null` = schema only (server, Markdown). */\n  suggestion: Omit<SuggestionOptions<ReferenceAttrs, ReferenceAttrs>, 'editor'> | null\n}\n\n/** Own key, so the `[@` popup runs next to the `@` mention and `#` tag popups. */\nexport const ReferenceSuggestionPluginKey = new PluginKey('referenceSuggestion')\n\n/**\n * Inline chip pointing at a Typed block of the document (a paper, a recording, a note): shared by the client editor and\n * the server (collab schema, Markdown). Markdown form `[@<block id>, <locator>]`; text of that form becomes chips again\n * through `referencesFromText` (the composites feature's `normalize` stage). The client adds the node view and the popup.\n */\nexport const ReferenceNode = Node.create<ReferenceOptions>({\n  name: REFERENCE_NODE,\n  group: 'inline',\n  inline: true,\n  atom: true,\n  selectable: true,\n  // Just below Mention (100): TipTap's Markdown manager registers the tokenizers in priority order and marked tries the\n  // last registered first, so `markdownTokenizer` below sees `[@<id>]` before Mention's `[@ ...]` shortcode does.\n  priority: 99,\n\n  // Claims `[@<block id>, <locator>]` as plain text, so Mention's tokenizer (which takes every `[@...]`) leaves it alone;\n  // the composites feature's `normalize` stage turns it into a chip when the id belongs to a Typed block of the document.\n  markdownTokenizer: {\n    name: 'referenceToken',\n    level: 'inline',\n    start: src => src.search(/\\[@[0-9a-f-]{36}/),\n    tokenize: (src) => {\n      const match = new RegExp(`^${REFERENCE_TOKEN_SOURCE}`).exec(src)\n      return match ? { type: 'text', raw: match[0], text: match[0] } : undefined\n    },\n  },\n\n  addOptions() {\n    return { HTMLAttributes: { class: 'reference' }, suggestion: null }\n  },\n\n  addAttributes() {\n    return {\n      target: {\n        default: '',\n        parseHTML: el => el.getAttribute('data-target') ?? '',\n        renderHTML: attrs => ({ 'data-target': attrs.target }),\n      },\n      documentId: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-document'),\n        renderHTML: attrs => attrs.documentId ? { 'data-document': attrs.documentId } : {},\n      },\n      locator: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-locator'),\n        renderHTML: attrs => attrs.locator ? { 'data-locator': attrs.locator } : {},\n      },\n      label: {\n        default: '',\n        parseHTML: el => el.getAttribute('data-label') ?? el.textContent ?? '',\n        renderHTML: attrs => ({ 'data-label': attrs.label }),\n      },\n    }\n  },\n\n  parseHTML() {\n    return [{ tag: `span[data-type=\"${this.name}\"]` }]\n  },\n\n  renderHTML({ node, HTMLAttributes }) {\n    return ['span', mergeAttributes({ 'data-type': this.name }, this.options.HTMLAttributes, HTMLAttributes), String(node.attrs.label ?? '')]\n  },\n\n  renderText: ({ node }) => referenceMarkdown(node.attrs as ReferenceAttrs),\n\n  // Markdown export (editor.getMarkdown(), AI context/selection) writes the chip as `[@<id>, <locator>]`.\n  renderMarkdown: node => referenceMarkdown({ target: String(node.attrs?.target ?? ''), locator: typeof node.attrs?.locator === 'string' ? node.attrs.locator : null }),\n\n  addCommands() {\n    return {\n      insertReference: attrs => ({ commands }) =>\n        commands.insertContent([{ type: this.name, attrs }, { type: 'text', text: ' ' }]),\n      setReferenceLocator: (pos, locator) => ({ tr, dispatch }) => {\n        const node = tr.doc.nodeAt(pos)\n        if (node?.type.name !== this.name) return false\n        if (dispatch) tr.setNodeMarkup(pos, undefined, { ...node.attrs, locator: locator.trim() || null })\n        return true\n      },\n    }\n  },\n\n  // The popup lives in a companion extension (see `ReferenceSuggestion`): it must rank above TipTap's core keymap\n  // (100) to see Enter first, which this node cannot (its priority orders the Markdown tokenizer).\n  addExtensions() {\n    const { suggestion } = this.options\n    return suggestion ? [ReferenceSuggestion.configure({ suggestion })] : []\n  },\n})\n\n/**\n * The `[@` popup of ReferenceNode. Priority 101 (like TagNode), above core's Keymap (100): extension priority orders\n * the ProseMirror plugins' `handleKeyDown`, and with a lower one Enter would split the paragraph instead of picking.\n */\nexport const ReferenceSuggestion = Extension.create<{ suggestion: NonNullable<ReferenceOptions['suggestion']> | null }>({\n  name: 'referenceSuggestion',\n  priority: 101,\n\n  addOptions() {\n    return { suggestion: null }\n  },\n\n  addProseMirrorPlugins() {\n    const { suggestion } = this.options\n    if (!suggestion) return []\n    const { allow, ...rest } = suggestion\n    return [Suggestion<ReferenceAttrs, ReferenceAttrs>({\n      pluginKey: ReferenceSuggestionPluginKey,\n      char: REFERENCE_TRIGGER,\n      allowSpaces: true,\n      allow: p => allow?.(p) ?? true,\n      command: ({ editor, range, props }) => {\n        // Reuse a following space instead of doubling it (as Mention does).\n        const nodeAfter = editor.view.state.selection.$to.nodeAfter\n        if (nodeAfter?.text?.startsWith(' ')) range.to += 1\n        editor.chain().focus()\n          .insertContentAt(range, [{ type: REFERENCE_NODE, attrs: props }, { type: 'text', text: ' ' }])\n          .run()\n        editor.view.dom.ownerDocument.defaultView?.getSelection()?.collapseToEnd()\n      },\n      ...rest,\n      editor: this.editor,\n    })]\n  },\n})\n"],"mappings":"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"}

package/dist/features/composites/reveal-source.d.ts

@@ -3,7 +3,7 @@ import { Editor, Extension } from "@tiptap/core";
 declare module '@tiptap/core' {
   interface Commands<ReturnType> {
     sourceReveal: {
-      /** Seek and play the media of the source-holding Baustein enclosing `pos` to `seconds`; silent when there is none. */
+      /** Seek and play the media of the source-holding Typed block enclosing `pos` to `seconds`; silent when there is none. */
       seekSource: (pos: number, seconds: number) => ReturnType;
     };
   }
@@ -17,12 +17,12 @@ export type SourceLocator = {
 /** Parses a reference locator; null for anything that is not a time or a page number. */
 export declare function parseLocator(locator: string | null | undefined): SourceLocator | null;
 /**
- * Seeks and plays the audio/video of the nearest source-holding Baustein around `pos` (a transcript segment inside a
+ * Seeks and plays the audio/video of the nearest source-holding Typed block around `pos` (a transcript segment inside a
  * rendition reaches the recording that way). Silent when there is no source or no media element.
  */
 export declare function seekSource(editor: Editor, pos: number, seconds: number): void;
 /**
- * Shows the source of Baustein `targetId` at `locator`: a `mm:ss` time seeks the media, a page number opens a PDF source
+ * Shows the source of Typed block `targetId` at `locator`: a `mm:ss` time seeks the media, a page number opens a PDF source
  * at that page; then the source block flashes. Silent when the target or its source is gone.
  */
 export declare function revealSource(editor: Editor, targetId: string, locator: string | null): void;

package/dist/features/composites/reveal-source.js

@@ -1,6 +1,6 @@
 import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
-import { sourceOf } from "./derivation.js";
-import { compositeKindsOf } from "./nodes.js";
+import { blockTypesOf } from "./nodes.js";
+import { sourceOf } from "./source.js";
 import { Extension } from "@tiptap/core";
 //#region src/features/composites/reveal-source.ts
 /** DOM event the PDF file view listens for; `detail` is the 1-based page to open the viewer at. */
@@ -19,7 +19,7 @@ function parseLocator(locator) {
 }
 /** The source block of the composite `composite` at `pos` with its document position, or null. */
 function sourceAt(editor, composite, pos) {
-	const source = sourceOf(composite, compositeKindsOf(editor));
+	const source = sourceOf(composite, blockTypesOf(editor));
 	if (!source) return null;
 	let sourcePos = pos + 1;
 	for (let i = 0; i < source.index; i++) sourcePos += composite.child(i).nodeSize;
@@ -44,7 +44,7 @@ function playAt(editor, sourcePos, seconds) {
 	return true;
 }
 /**
-* Seeks and plays the audio/video of the nearest source-holding Baustein around `pos` (a transcript segment inside a
+* Seeks and plays the audio/video of the nearest source-holding Typed block around `pos` (a transcript segment inside a
 * rendition reaches the recording that way). Silent when there is no source or no media element.
 */
 function seekSource(editor, pos, seconds) {
@@ -52,7 +52,7 @@ function seekSource(editor, pos, seconds) {
 	const $pos = editor.state.doc.resolve(pos);
 	for (let depth = $pos.depth; depth >= 0; depth--) {
 		const composite = $pos.node(depth);
-		if (composite.type.name !== "composite") continue;
+		if (composite.type.name !== "typedBlock") continue;
 		const source = sourceAt(editor, composite, $pos.before(depth));
 		if (!source) continue;
 		playAt(editor, source.pos, seconds);
@@ -60,7 +60,7 @@ function seekSource(editor, pos, seconds) {
 	}
 }
 /**
-* Shows the source of Baustein `targetId` at `locator`: a `mm:ss` time seeks the media, a page number opens a PDF source
+* Shows the source of Typed block `targetId` at `locator`: a `mm:ss` time seeks the media, a page number opens a PDF source
 * at that page; then the source block flashes. Silent when the target or its source is gone.
 */
 function revealSource(editor, targetId, locator) {