@ecsplico/editor 3.6.0 → 4.0.0

package/dist/features/composites/meta-display.js

@@ -1,5 +1,5 @@
 import { findBlockById } from "../../core/schema/block-ids.js";
-import { compositeKind } from "./kinds.js";
+import { blockTypeOf } from "./block-types.js";
 import { citeShort } from "./bibliography.js";
 import { derivationMethodLabel } from "./derived-chrome.js";
 //#region src/features/composites/meta-display.ts
@@ -24,7 +24,7 @@ function formatDate(value) {
 	return Number.isNaN(date.getTime()) ? value : dateFormat.format(date);
 }
 /**
-* The text a field's value stands for in a table cell: `reference` the title of the Baustein it points to (its kind label
+* The text a field's value stands for in a table cell: `reference` the title of the Typed block it points to (its Block type label
 * when untitled, `''` when it is gone or `doc` is unknown), `bibliography` the short citation, `derivation`
 * `method · date` (the method as words when `t` is given, else its stored id); every other type its stored text.
 */
@@ -33,8 +33,8 @@ function fieldDisplay(row, field, doc, kinds, t) {
 	if (field.type === "reference") {
 		if (typeof value !== "string" || !value || !doc) return "";
 		const target = findBlockById(doc, value)?.node;
-		if (target?.type.name !== "composite") return "";
-		return target.child(0).textContent.trim() || compositeKind(kinds, String(target.attrs.kind)).label;
+		if (target?.type.name !== "typedBlock") return "";
+		return target.child(0).textContent.trim() || blockTypeOf(kinds, String(target.attrs.blockType)).label;
 	}
 	if (field.type === "bibliography") {
 		const bib = value;
@@ -73,7 +73,7 @@ const STATUS_OTHER = {
 const statusStyle = (value) => STATUS_STYLE[value] ?? (value ? STATUS_OTHER : STATUS_UNSET);
 /** The row's `status` select field with its current value, `null` for a kind without one; `t` words an unset status. */
 function rowStatus(row, t) {
-	const field = row.fields.find((candidate) => candidate.key === "status" && candidate.type === "select");
+	const field = row.definitions.find((candidate) => candidate.key === "status" && candidate.type === "select");
 	if (!field) return null;
 	const value = metaText(row, field);
 	return {

package/dist/features/composites/meta-display.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-display.js","names":[],"sources":["../../../src/features/composites/meta-display.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\nimport { findBlockById } from '../../core/schema/block-ids'\nimport type { Translate } from '../../i18n'\nimport { type CslItem, citeShort } from './bibliography'\nimport type { Derivation } from './derivation'\nimport { derivationMethodLabel } from './derived-chrome'\nimport { type CompositeKind, type CompositeMetaField, compositeKind } from './kinds'\nimport type { CompositeRow } from './rows'\n\n/**\n * The stored value of a meta field as text (`''` when unset). An array (`multiselect`) reads as its entries joined by\n * `, `: the labels of the matching `options`, else the stored values.\n */\nexport function metaText(row: Pick<CompositeRow, 'meta'>, field: Pick<CompositeMetaField, 'key'> & { options?: CompositeMetaField['options'] }): string {\n  const value = row.meta[field.key]\n  if (Array.isArray(value)) return value.filter((item): item is string => typeof item === 'string').map(item => field.options?.find(option => option.value === item)?.label ?? item).join(', ')\n  return typeof value === 'string' || typeof value === 'number' ? String(value) : ''\n}\n\nconst dateFormat = new Intl.DateTimeFormat('de-DE', { day: '2-digit', month: '2-digit', year: 'numeric' })\n\n/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */\nexport function formatDate(value: string): string {\n  const match = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value)\n  const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value)\n  return Number.isNaN(date.getTime()) ? value : dateFormat.format(date)\n}\n\n/**\n * The text a field's value stands for in a table cell: `reference` the title of the Baustein it points to (its kind label\n * when untitled, `''` when it is gone or `doc` is unknown), `bibliography` the short citation, `derivation`\n * `method · date` (the method as words when `t` is given, else its stored id); every other type its stored text.\n */\nexport function fieldDisplay(row: Pick<CompositeRow, 'meta' | 'title'>, field: Pick<CompositeMetaField, 'key' | 'type' | 'options'>, doc: PMNode | null, kinds: readonly CompositeKind[], t?: Translate): string {\n  const value = row.meta[field.key]\n  if (field.type === 'reference') {\n    if (typeof value !== 'string' || !value || !doc) return ''\n    const target = findBlockById(doc, value)?.node\n    if (target?.type.name !== 'composite') return ''\n    return target.child(0).textContent.trim() || compositeKind(kinds, String(target.attrs.kind)).label\n  }\n  if (field.type === 'bibliography') {\n    const bib = value as Partial<CslItem> | null | undefined\n    return bib && typeof bib === 'object' && typeof bib.type === 'string' ? citeShort(bib, row.title) : ''\n  }\n  if (field.type === 'derivation') {\n    const derivation = value as Partial<Derivation> | null | undefined\n    if (!derivation || typeof derivation !== 'object' || typeof derivation.method !== 'string') return ''\n    return [t ? derivationMethodLabel(t, derivation.method) : derivation.method, derivation.createdAt ? formatDate(derivation.createdAt) : ''].filter(Boolean).join(' · ')\n  }\n  return metaText(row, field)\n}\n\n/** Icon and color class of the known status values; unknown values read as neutral. */\nconst STATUS_STYLE: Record<string, { icon: string, color: string }> = {\n  open: { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' },\n  doing: { icon: 'i-lucide-circle-dot', color: 'text-[var(--sk-info)]' },\n  done: { icon: 'i-lucide-circle-check', color: 'text-[var(--sk-success)]' },\n}\nconst STATUS_UNSET = { icon: 'i-lucide-circle-dashed', color: 'text-[var(--sk-fg-dimmed)]' }\nconst STATUS_OTHER = { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' }\n\nexport const statusStyle = (value: string) => STATUS_STYLE[value] ?? (value ? STATUS_OTHER : STATUS_UNSET)\n\n/** A row's `status` field with its current value. */\nexport interface RowStatus {\n  field: CompositeMetaField\n  value: string\n  label: string\n  icon: string\n  color: string\n}\n\n/** The row's `status` select field with its current value, `null` for a kind without one; `t` words an unset status. */\nexport function rowStatus(row: CompositeRow, t: Translate): RowStatus | null {\n  const field = row.fields.find(candidate => candidate.key === 'status' && candidate.type === 'select')\n  if (!field) return null\n  const value = metaText(row, field)\n  return { field, value, label: field.options?.find(option => option.value === value)?.label ?? (value || t('composites.status.none')), ...statusStyle(value) }\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,SAAS,KAAiC,OAA8F;CACtJ,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,QAAQ,SAAyB,OAAO,SAAS,QAAQ,CAAC,CAAC,KAAI,SAAQ,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,IAAI,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI;CAC5L,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AAClF;AAEA,MAAM,aAAa,IAAI,KAAK,eAAe,SAAS;CAAE,KAAK;CAAW,OAAO;CAAW,MAAM;AAAU,CAAC;;AAGzG,SAAgB,WAAW,OAAuB;CAChD,MAAM,QAAQ,2BAA2B,KAAK,KAAK;CACnD,MAAM,OAAO,QAAQ,IAAI,KAAK,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,IAAI,GAAG,OAAO,MAAM,EAAE,CAAC,IAAI,IAAI,KAAK,KAAK;CACxG,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,QAAQ,WAAW,OAAO,IAAI;AACtE;;;;;;AAOA,SAAgB,aAAa,KAA2C,OAA6D,KAAoB,OAAiC,GAAuB;CAC/M,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,IAAI,MAAM,SAAS,aAAa;EAC9B,IAAI,OAAO,UAAU,YAAY,CAAC,SAAS,CAAC,KAAK,OAAO;EACxD,MAAM,SAAS,cAAc,KAAK,KAAK,CAAC,EAAE;EAC1C,IAAI,QAAQ,KAAK,SAAS,aAAa,OAAO;EAC9C,OAAO,OAAO,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,cAAc,OAAO,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC,CAAC;CAC/F;CACA,IAAI,MAAM,SAAS,gBAAgB;EACjC,MAAM,MAAM;EACZ,OAAO,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,SAAS,WAAW,UAAU,KAAK,IAAI,KAAK,IAAI;CACtG;CACA,IAAI,MAAM,SAAS,cAAc;EAC/B,MAAM,aAAa;EACnB,IAAI,CAAC,cAAc,OAAO,eAAe,YAAY,OAAO,WAAW,WAAW,UAAU,OAAO;EACnG,OAAO,CAAC,IAAI,sBAAsB,GAAG,WAAW,MAAM,IAAI,WAAW,QAAQ,WAAW,YAAY,WAAW,WAAW,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CACvK;CACA,OAAO,SAAS,KAAK,KAAK;AAC5B;;AAGA,MAAM,eAAgE;CACpE,MAAM;EAAE,MAAM;EAAmB,OAAO;CAAyB;CACjE,OAAO;EAAE,MAAM;EAAuB,OAAO;CAAwB;CACrE,MAAM;EAAE,MAAM;EAAyB,OAAO;CAA2B;AAC3E;AACA,MAAM,eAAe;CAAE,MAAM;CAA0B,OAAO;AAA6B;AAC3F,MAAM,eAAe;CAAE,MAAM;CAAmB,OAAO;AAAyB;AAEhF,MAAa,eAAe,UAAkB,aAAa,WAAW,QAAQ,eAAe;;AAY7F,SAAgB,UAAU,KAAmB,GAAgC;CAC3E,MAAM,QAAQ,IAAI,OAAO,MAAK,cAAa,UAAU,QAAQ,YAAY,UAAU,SAAS,QAAQ;CACpG,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,QAAQ,SAAS,KAAK,KAAK;CACjC,OAAO;EAAE;EAAO;EAAO,OAAO,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,UAAU,SAAS,EAAE,wBAAwB;EAAI,GAAG,YAAY,KAAK;CAAE;AAC9J"}
+{"version":3,"file":"meta-display.js","names":[],"sources":["../../../src/features/composites/meta-display.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\nimport { findBlockById } from '../../core/schema/block-ids'\nimport type { Translate } from '../../i18n'\nimport { type CslItem, citeShort } from './bibliography'\nimport type { Derivation } from '../../core/derivation'\nimport { derivationMethodLabel } from './derived-chrome'\nimport { type BlockType, blockTypeOf } from './block-types'\nimport type { PropertyDefinition } from '../../core/properties'\nimport type { BlockProperties } from './properties'\nimport type { CompositeRow } from './rows'\n\n/**\n * The stored value of a meta field as text (`''` when unset). An array (`multiselect`) reads as its entries joined by\n * `, `: the labels of the matching `options`, else the stored values.\n */\nexport function metaText(row: Pick<BlockProperties, 'meta'>, field: Pick<PropertyDefinition, 'key'> & { options?: PropertyDefinition['options'] }): string {\n  const value = row.meta[field.key]\n  if (Array.isArray(value)) return value.filter((item): item is string => typeof item === 'string').map(item => field.options?.find(option => option.value === item)?.label ?? item).join(', ')\n  return typeof value === 'string' || typeof value === 'number' ? String(value) : ''\n}\n\nconst dateFormat = new Intl.DateTimeFormat('de-DE', { day: '2-digit', month: '2-digit', year: 'numeric' })\n\n/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */\nexport function formatDate(value: string): string {\n  const match = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value)\n  const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value)\n  return Number.isNaN(date.getTime()) ? value : dateFormat.format(date)\n}\n\n/**\n * The text a field's value stands for in a table cell: `reference` the title of the Typed block it points to (its Block type label\n * when untitled, `''` when it is gone or `doc` is unknown), `bibliography` the short citation, `derivation`\n * `method · date` (the method as words when `t` is given, else its stored id); every other type its stored text.\n */\nexport function fieldDisplay(row: Pick<CompositeRow, 'meta' | 'title'>, field: Pick<PropertyDefinition, 'key' | 'type' | 'options'>, doc: PMNode | null, kinds: readonly BlockType[], t?: Translate): string {\n  const value = row.meta[field.key]\n  if (field.type === 'reference') {\n    if (typeof value !== 'string' || !value || !doc) return ''\n    const target = findBlockById(doc, value)?.node\n    if (target?.type.name !== 'typedBlock') return ''\n    return target.child(0).textContent.trim() || blockTypeOf(kinds, String(target.attrs.blockType)).label\n  }\n  if (field.type === 'bibliography') {\n    const bib = value as Partial<CslItem> | null | undefined\n    return bib && typeof bib === 'object' && typeof bib.type === 'string' ? citeShort(bib, row.title) : ''\n  }\n  if (field.type === 'derivation') {\n    const derivation = value as Partial<Derivation> | null | undefined\n    if (!derivation || typeof derivation !== 'object' || typeof derivation.method !== 'string') return ''\n    return [t ? derivationMethodLabel(t, derivation.method) : derivation.method, derivation.createdAt ? formatDate(derivation.createdAt) : ''].filter(Boolean).join(' · ')\n  }\n  return metaText(row, field)\n}\n\n/** Icon and color class of the known status values; unknown values read as neutral. */\nconst STATUS_STYLE: Record<string, { icon: string, color: string }> = {\n  open: { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' },\n  doing: { icon: 'i-lucide-circle-dot', color: 'text-[var(--sk-info)]' },\n  done: { icon: 'i-lucide-circle-check', color: 'text-[var(--sk-success)]' },\n}\nconst STATUS_UNSET = { icon: 'i-lucide-circle-dashed', color: 'text-[var(--sk-fg-dimmed)]' }\nconst STATUS_OTHER = { icon: 'i-lucide-circle', color: 'text-[var(--sk-muted)]' }\n\nexport const statusStyle = (value: string) => STATUS_STYLE[value] ?? (value ? STATUS_OTHER : STATUS_UNSET)\n\n/** A row's `status` field with its current value. */\nexport interface RowStatus {\n  field: PropertyDefinition\n  value: string\n  label: string\n  icon: string\n  color: string\n}\n\n/** The row's `status` select field with its current value, `null` for a kind without one; `t` words an unset status. */\nexport function rowStatus(row: CompositeRow, t: Translate): RowStatus | null {\n  const field = row.definitions.find(candidate => candidate.key === 'status' && candidate.type === 'select')\n  if (!field) return null\n  const value = metaText(row, field)\n  return { field, value, label: field.options?.find(option => option.value === value)?.label ?? (value || t('composites.status.none')), ...statusStyle(value) }\n}\n"],"mappings":";;;;;;;;;AAeA,SAAgB,SAAS,KAAoC,OAA8F;CACzJ,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,QAAQ,SAAyB,OAAO,SAAS,QAAQ,CAAC,CAAC,KAAI,SAAQ,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,IAAI,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI;CAC5L,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AAClF;AAEA,MAAM,aAAa,IAAI,KAAK,eAAe,SAAS;CAAE,KAAK;CAAW,OAAO;CAAW,MAAM;AAAU,CAAC;;AAGzG,SAAgB,WAAW,OAAuB;CAChD,MAAM,QAAQ,2BAA2B,KAAK,KAAK;CACnD,MAAM,OAAO,QAAQ,IAAI,KAAK,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,IAAI,GAAG,OAAO,MAAM,EAAE,CAAC,IAAI,IAAI,KAAK,KAAK;CACxG,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,IAAI,QAAQ,WAAW,OAAO,IAAI;AACtE;;;;;;AAOA,SAAgB,aAAa,KAA2C,OAA6D,KAAoB,OAA6B,GAAuB;CAC3M,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,IAAI,MAAM,SAAS,aAAa;EAC9B,IAAI,OAAO,UAAU,YAAY,CAAC,SAAS,CAAC,KAAK,OAAO;EACxD,MAAM,SAAS,cAAc,KAAK,KAAK,CAAC,EAAE;EAC1C,IAAI,QAAQ,KAAK,SAAS,cAAc,OAAO;EAC/C,OAAO,OAAO,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,YAAY,OAAO,OAAO,OAAO,MAAM,SAAS,CAAC,CAAC,CAAC;CAClG;CACA,IAAI,MAAM,SAAS,gBAAgB;EACjC,MAAM,MAAM;EACZ,OAAO,OAAO,OAAO,QAAQ,YAAY,OAAO,IAAI,SAAS,WAAW,UAAU,KAAK,IAAI,KAAK,IAAI;CACtG;CACA,IAAI,MAAM,SAAS,cAAc;EAC/B,MAAM,aAAa;EACnB,IAAI,CAAC,cAAc,OAAO,eAAe,YAAY,OAAO,WAAW,WAAW,UAAU,OAAO;EACnG,OAAO,CAAC,IAAI,sBAAsB,GAAG,WAAW,MAAM,IAAI,WAAW,QAAQ,WAAW,YAAY,WAAW,WAAW,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK;CACvK;CACA,OAAO,SAAS,KAAK,KAAK;AAC5B;;AAGA,MAAM,eAAgE;CACpE,MAAM;EAAE,MAAM;EAAmB,OAAO;CAAyB;CACjE,OAAO;EAAE,MAAM;EAAuB,OAAO;CAAwB;CACrE,MAAM;EAAE,MAAM;EAAyB,OAAO;CAA2B;AAC3E;AACA,MAAM,eAAe;CAAE,MAAM;CAA0B,OAAO;AAA6B;AAC3F,MAAM,eAAe;CAAE,MAAM;CAAmB,OAAO;AAAyB;AAEhF,MAAa,eAAe,UAAkB,aAAa,WAAW,QAAQ,eAAe;;AAY7F,SAAgB,UAAU,KAAmB,GAAgC;CAC3E,MAAM,QAAQ,IAAI,YAAY,MAAK,cAAa,UAAU,QAAQ,YAAY,UAAU,SAAS,QAAQ;CACzG,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,QAAQ,SAAS,KAAK,KAAK;CACjC,OAAO;EAAE;EAAO;EAAO,OAAO,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,UAAU,SAAS,EAAE,wBAAwB;EAAI,GAAG,YAAY,KAAK;CAAE;AAC9J"}

package/dist/features/composites/meta-keys.d.ts

@@ -1,11 +1,11 @@
+import "../../core/capabilities.js";
+import { DERIVATION_KEY } from "../../core/derivation.js";
 //#region src/features/composites/meta-keys.d.ts
-/** Key of the derivation (provenance) in a composite's `meta`. */
-export declare const DERIVATION_KEY = "derivation";
-/** Key of the bibliographic record (`CslItem`) in a composite's `meta`. */
+/** Key of the bibliographic record (`CslItem`) in a block's `meta`. */
 export declare const BIB_KEY = "bib";
-/** Key of the hidden-title flag in a composite's `meta`: `true` while the title is hidden, absent otherwise. */
+/** Key of the hidden-title flag in a block's `meta`: `true` while the title is hidden, absent otherwise. */
 export declare const TITLE_HIDDEN_KEY = "titleHidden";
-/** Key of the colour basket in a composite's `meta`: the id of one of the editor's baskets. */
+/** Key of the colour basket in a block's `meta`: the id of one of the editor's baskets. */
 export declare const BASKET_KEY = "basket";
 //#endregion
 //# sourceMappingURL=meta-keys.d.ts.map

package/dist/features/composites/meta-keys.js

@@ -1,21 +1,21 @@
+import { DERIVATION_KEY } from "../../core/derivation.js";
+import { propertiesOf } from "./block-types.js";
 //#region src/features/composites/meta-keys.ts
-/** Key of the derivation (provenance) in a composite's `meta`. */
-const DERIVATION_KEY = "derivation";
-/** Key of the bibliographic record (`CslItem`) in a composite's `meta`. */
+/** Key of the bibliographic record (`CslItem`) in a block's `meta`. */
 const BIB_KEY = "bib";
-/** Key of the hidden-title flag in a composite's `meta`: `true` while the title is hidden, absent otherwise. */
+/** Key of the hidden-title flag in a block's `meta`: `true` while the title is hidden, absent otherwise. */
 const TITLE_HIDDEN_KEY = "titleHidden";
-/** Key of the colour basket in a composite's `meta`: the id of one of the editor's baskets. */
+/** Key of the colour basket in a block's `meta`: the id of one of the editor's baskets. */
 const BASKET_KEY = "basket";
 /**
-* Whether a composite of `kind` keeps the `meta` entry `key`: the fields the kind declares, plus provenance
+* Whether a block of Block type `kind` keeps the `meta` entry `key`: the fields the kind declares, plus provenance
 * (`derivation`), the bibliographic record (`bib`), the hidden-title flag (`titleHidden`) and the basket (`basket`),
 * which any kind may carry (a kind switch, a conversion and a Markdown round trip must not drop them).
 */
 function keepsMetaKey(kind, key) {
-	return key === "derivation" || key === "bib" || key === "titleHidden" || key === "basket" || kind.fields.some((field) => field.key === key);
+	return key === "derivation" || key === "bib" || key === "titleHidden" || key === "basket" || propertiesOf(kind).some((field) => field.key === key);
 }
-/** `meta` reduced to the entries a composite of `kind` keeps (`keepsMetaKey`). */
+/** `meta` reduced to the entries a block of Block type `kind` keeps (`keepsMetaKey`). */
 function keptMeta(kind, meta) {
 	return Object.fromEntries(Object.entries(meta).filter(([key]) => keepsMetaKey(kind, key)));
 }

package/dist/features/composites/meta-keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta-keys.js","names":[],"sources":["../../../src/features/composites/meta-keys.ts"],"sourcesContent":["// Vue-free and server-importable: the `meta` keys a Baustein of any kind may carry, and which meta keys a kind keeps.\nimport type { CompositeKind } from './kinds'\n\n/** Key of the derivation (provenance) in a composite's `meta`. */\nexport const DERIVATION_KEY = 'derivation'\n\n/** Key of the bibliographic record (`CslItem`) in a composite's `meta`. */\nexport const BIB_KEY = 'bib'\n\n/** Key of the hidden-title flag in a composite's `meta`: `true` while the title is hidden, absent otherwise. */\nexport const TITLE_HIDDEN_KEY = 'titleHidden'\n\n/** Key of the colour basket in a composite's `meta`: the id of one of the editor's baskets. */\nexport const BASKET_KEY = 'basket'\n\n/**\n * Whether a composite of `kind` keeps the `meta` entry `key`: the fields the kind declares, plus provenance\n * (`derivation`), the bibliographic record (`bib`), the hidden-title flag (`titleHidden`) and the basket (`basket`),\n * which any kind may carry (a kind switch, a conversion and a Markdown round trip must not drop them).\n */\nexport function keepsMetaKey(kind: Pick<CompositeKind, 'fields'>, key: string): boolean {\n  return key === DERIVATION_KEY || key === BIB_KEY || key === TITLE_HIDDEN_KEY || key === BASKET_KEY || kind.fields.some(field => field.key === key)\n}\n\n/** `meta` reduced to the entries a composite of `kind` keeps (`keepsMetaKey`). */\nexport function keptMeta(kind: Pick<CompositeKind, 'fields'>, meta: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(meta).filter(([key]) => keepsMetaKey(kind, key)))\n}\n"],"mappings":";;AAIA,MAAa,iBAAiB;;AAG9B,MAAa,UAAU;;AAGvB,MAAa,mBAAmB;;AAGhC,MAAa,aAAa;;;;;;AAO1B,SAAgB,aAAa,MAAqC,KAAsB;CACtF,OAAO,QAAA,gBAA0B,QAAA,SAAmB,QAAA,iBAA4B,QAAA,YAAsB,KAAK,OAAO,MAAK,UAAS,MAAM,QAAQ,GAAG;AACnJ;;AAGA,SAAgB,SAAS,MAAqC,MAAwD;CACpH,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,aAAa,MAAM,GAAG,CAAC,CAAC;AAC3F"}
+{"version":3,"file":"meta-keys.js","names":[],"sources":["../../../src/features/composites/meta-keys.ts"],"sourcesContent":["// Vue-free and server-importable: the `meta` keys a Typed block of any Block type may carry, and which meta keys a Block type keeps.\nimport type { BlockTypeData } from '../../core/capabilities'\nimport { DERIVATION_KEY } from '../../core/derivation'\nimport { propertiesOf } from './block-types'\n\nexport { DERIVATION_KEY }\n\n/** Key of the bibliographic record (`CslItem`) in a block's `meta`. */\nexport const BIB_KEY = 'bib'\n\n/** Key of the hidden-title flag in a block's `meta`: `true` while the title is hidden, absent otherwise. */\nexport const TITLE_HIDDEN_KEY = 'titleHidden'\n\n/** Key of the colour basket in a block's `meta`: the id of one of the editor's baskets. */\nexport const BASKET_KEY = 'basket'\n\n/**\n * Whether a block of Block type `kind` keeps the `meta` entry `key`: the fields the kind declares, plus provenance\n * (`derivation`), the bibliographic record (`bib`), the hidden-title flag (`titleHidden`) and the basket (`basket`),\n * which any kind may carry (a kind switch, a conversion and a Markdown round trip must not drop them).\n */\nexport function keepsMetaKey(kind: BlockTypeData, key: string): boolean {\n  return key === DERIVATION_KEY || key === BIB_KEY || key === TITLE_HIDDEN_KEY || key === BASKET_KEY || propertiesOf(kind).some(field => field.key === key)\n}\n\n/** `meta` reduced to the entries a block of Block type `kind` keeps (`keepsMetaKey`). */\nexport function keptMeta(kind: BlockTypeData, meta: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(meta).filter(([key]) => keepsMetaKey(kind, key)))\n}\n"],"mappings":";;;;AAQA,MAAa,UAAU;;AAGvB,MAAa,mBAAmB;;AAGhC,MAAa,aAAa;;;;;;AAO1B,SAAgB,aAAa,MAAqB,KAAsB;CACtE,OAAO,QAAA,gBAA0B,QAAA,SAAmB,QAAA,iBAA4B,QAAA,YAAsB,aAAa,IAAI,CAAC,CAAC,MAAK,UAAS,MAAM,QAAQ,GAAG;AAC1J;;AAGA,SAAgB,SAAS,MAAqB,MAAwD;CACpG,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,aAAa,MAAM,GAAG,CAAC,CAAC;AAC3F"}

package/dist/features/composites/node-views.d.ts

@@ -1,15 +1,15 @@
-import { CompositeOptions, CompositeStorage } from "./nodes.js";
 import { ReferenceOptions } from "./reference.js";
+import { CompositeOptions, CompositeStorage } from "./nodes.js";
 import { NodeViewRenderer } from "@tiptap/core";
 //#region src/features/composites/node-views.d.ts
 /** The node view renderers a framework binding supplies for the composite block and the reference chip. */
 export interface CompositeNodeViews {
-  composite: NodeViewRenderer;
+  typedBlock: NodeViewRenderer;
   reference: NodeViewRenderer;
 }
 /**
  * The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`
- * shows and edits it, so it needs no node view) and the reference chip. Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
+ * shows and edits it, so it needs no node view) and the reference chip. Configure the Block types with `Composite.configure({ blockTypes: [...defaultBlockTypes(t), myType] })`.
  */
 export declare function compositeNodes(nodeViews: CompositeNodeViews): {
   Composite: import("@tiptap/core").Node<CompositeOptions, CompositeStorage>;

package/dist/features/composites/node-views.js

@@ -3,12 +3,12 @@ import { ReferenceNode } from "./reference.js";
 //#region src/features/composites/node-views.ts
 /**
 * The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`
-* shows and edits it, so it needs no node view) and the reference chip. Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
+* shows and edits it, so it needs no node view) and the reference chip. Configure the Block types with `Composite.configure({ blockTypes: [...defaultBlockTypes(t), myType] })`.
 */
 function compositeNodes(nodeViews) {
 	return {
 		Composite: CompositeNode.extend({ addNodeView() {
-			return nodeViews.composite;
+			return nodeViews.typedBlock;
 		} }),
 		CompositeTags: CompositeTagsNode,
 		Reference: ReferenceNode.extend({ addNodeView() {

package/dist/features/composites/node-views.js.map

@@ -1 +1 @@
-{"version":3,"file":"node-views.js","names":[],"sources":["../../../src/features/composites/node-views.ts"],"sourcesContent":["import type { NodeViewRenderer } from '@tiptap/core'\nimport { CompositeNode, CompositeTagsNode } from './nodes'\nimport { ReferenceNode } from './reference'\n\n/** The node view renderers a framework binding supplies for the composite block and the reference chip. */\nexport interface CompositeNodeViews {\n  composite: NodeViewRenderer\n  reference: NodeViewRenderer\n}\n\n/**\n * The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`\n * shows and edits it, so it needs no node view) and the reference chip. Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.\n */\nexport function compositeNodes(nodeViews: CompositeNodeViews) {\n  return {\n    // Explicit return type: the node views import `compositeKindsOf`, so inference would otherwise be circular.\n    Composite: CompositeNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.composite\n      },\n    }),\n    CompositeTags: CompositeTagsNode,\n    Reference: ReferenceNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.reference\n      },\n    }),\n  }\n}\n"],"mappings":";;;;;;;AAcA,SAAgB,eAAe,WAA+B;CAC5D,OAAO;EAEL,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;EACD,eAAe;EACf,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;CACH;AACF"}
+{"version":3,"file":"node-views.js","names":[],"sources":["../../../src/features/composites/node-views.ts"],"sourcesContent":["import type { NodeViewRenderer } from '@tiptap/core'\nimport { CompositeNode, CompositeTagsNode } from './nodes'\nimport { ReferenceNode } from './reference'\n\n/** The node view renderers a framework binding supplies for the composite block and the reference chip. */\nexport interface CompositeNodeViews {\n  typedBlock: NodeViewRenderer\n  reference: NodeViewRenderer\n}\n\n/**\n * The composite node with the node view of a framework binding, the tags row (data: hidden, `CompositeChrome`\n * shows and edits it, so it needs no node view) and the reference chip. Configure the Block types with `Composite.configure({ blockTypes: [...defaultBlockTypes(t), myType] })`.\n */\nexport function compositeNodes(nodeViews: CompositeNodeViews) {\n  return {\n    // Explicit return type: the node views import `blockTypesOf`, so inference would otherwise be circular.\n    Composite: CompositeNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.typedBlock\n      },\n    }),\n    CompositeTags: CompositeTagsNode,\n    Reference: ReferenceNode.extend({\n      addNodeView(): NodeViewRenderer {\n        return nodeViews.reference\n      },\n    }),\n  }\n}\n"],"mappings":";;;;;;;AAcA,SAAgB,eAAe,WAA+B;CAC5D,OAAO;EAEL,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;EACD,eAAe;EACf,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;CACH;AACF"}

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

@@ -1,24 +1,24 @@
 import { Store } from "../../core/store.js";
 import { HeadingConversionScope } from "../../settings/values.js";
 import "../../settings/index.js";
-import { CompositeKind } from "./kinds.js";
 import { Basket } from "./baskets.js";
+import { BlockType } from "./block-types.js";
 import { Editor, JSONContent, Node } from "@tiptap/core";
 import { EditorState } from "@tiptap/pm/state";
 import { Node as Node$1, ResolvedPos } from "@tiptap/pm/model";
 //#region src/features/composites/nodes.d.ts
-/** Options of the `composite` node: the kinds its `kind` attribute selects from and the baskets its `meta.basket` selects from. */
+/** Options of the `typedBlock` node: the Block types its `blockType` attribute selects from and the baskets its `meta.basket` selects from. */
 export interface CompositeOptions {
-  kinds: readonly CompositeKind[];
+  blockTypes: readonly BlockType[];
   baskets: readonly Basket[];
 }
-/** Storage of the `composite` node: mirrors `options.kinds` and `options.baskets` for code that only has the editor. */
+/** Storage of the `typedBlock` node: mirrors `options.blockTypes` and `options.baskets` for code that only has the editor. */
 export interface CompositeStorage {
-  kinds: readonly CompositeKind[];
+  blockTypes: readonly BlockType[];
   baskets: readonly Basket[];
-  /** Ids of the Bausteine with a hidden title (`meta.titleHidden`) whose title the caret entered; they show it for the rest of the editor session. */
+  /** Ids of the Typed blocks with a hidden title (`meta.titleHidden`) whose title the caret entered; they show it for the rest of the editor session. */
   revealedTitles: Store<ReadonlySet<string>>;
-  /** Ids of the derived Bausteine (those with a `meta.derivation`) the user opened; every other derived Baustein shows collapsed. */
+  /** Ids of the derived Typed blocks (those with a `meta.derivation`) the user opened; every other derived Typed block shows collapsed. */
   expanded: Store<ReadonlySet<string>>;
 }
 declare module '@tiptap/core' {
@@ -41,9 +41,9 @@ declare module '@tiptap/core' {
         recursive: boolean;
         scope: HeadingConversionScope;
       }) => ReturnType;
-      /** Switch the composite at `pos` (default: the caret's innermost composite) to `kind`; `meta` keeps the target kind's fields plus `derivation` and `bib`. */
-      setCompositeKind: (kind: string, pos?: number) => ReturnType;
-      /** Open the derived Baustein with block id `id` if it is collapsed, collapse it if it is open. */
+      /** Switch the composite at `pos` (default: the caret's innermost composite) to the Block type `blockTypeId`; `meta` keeps the new Block type's properties plus `derivation` and `bib`. */
+      changeBlockType: (blockTypeId: string, pos?: number) => ReturnType;
+      /** Open the derived Typed block with block id `id` if it is collapsed, collapse it if it is open. */
       toggleCompositeExpanded: (id: string) => ReturnType;
       /** Put the composite at `pos` (default: the caret's innermost composite) into the basket `basket` (an id of the editor's baskets; false for an unknown id), or take it out with `null`. */
       setCompositeBasket: (basket: string | null, pos?: number) => ReturnType;
@@ -52,16 +52,16 @@ declare module '@tiptap/core' {
     };
   }
   interface Storage {
-    composite: CompositeStorage;
+    typedBlock: CompositeStorage;
   }
 }
 /** Title, description and tags: the fixed children in front of a composite's body. */
 export declare const COMPOSITE_CHROME_COUNT = 3;
 /**
- * Composite kinds `editor` was configured with. An editor without the composite node gets the built-in kinds in the
+ * Block types `editor` was configured with. An editor without the composite node gets the built-in Block types in the
  * language of its surface (the default language without one).
  */
-export declare function compositeKindsOf(editor: Editor): readonly CompositeKind[];
+export declare function blockTypesOf(editor: Editor): readonly BlockType[];
 /** Baskets `editor` was configured with (the built-in ones in the default language for an editor without the composite node). */
 export declare function compositeBasketsOf(editor: Editor): readonly Basket[];
 /** JSON of a fresh composite of `kind` (empty title/description/tags, hidden meta) with `body`. */