@ecsplico/editor 0.0.0-stage → 1.0.0

package/dist/features/composites/heading-composites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-composites.js","names":[],"sources":["../../../src/features/composites/heading-composites.ts"],"sourcesContent":["import { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport { type CompositeKind, compositeKind } from './kinds'\nimport type { StructureMode } from '../../settings'\n\n// Node names hardcoded (not imported from composite.ts) so composite.ts can import this file without a cycle.\nconst HEADING = 'heading'\nconst COMPOSITE = 'composite'\nconst TITLE = 'compositeTitle'\nconst DESCRIPTION = 'compositeDescription'\nconst TAGS = 'compositeTags'\nconst PARAGRAPH = 'paragraph'\n/** Title, description and tags: the fixed children in front of a composite's body. */\nconst CHROME_COUNT = 3\n\n\nconst isHeading = (node: PMNode) => node.type.name === HEADING\nconst levelOf = (node: PMNode) => node.attrs.level as number\n\n/**\n * `blocks` (siblings) with headings grouped into composites of `kind`. Flat: only headings of the lowest level present\n * become composites; everything before the first such heading is kept. Recursive: bodies, the part before the first\n * heading and the bodies of existing composites are grouped the same way. `null` when nothing changed.\n */\nexport function groupHeadingsIntoComposites(schema: Schema, blocks: readonly PMNode[], recursive: boolean, kind: string): PMNode[] | null {\n  let changed = false\n  let input: PMNode[] = [...blocks]\n  if (recursive) {\n    input = input.map((block) => {\n      if (block.type.name !== COMPOSITE) return block\n      const children: PMNode[] = []\n      block.forEach(child => children.push(child))\n      const body = groupHeadingsIntoComposites(schema, children.slice(CHROME_COUNT), true, kind)\n      if (!body) return block\n      changed = true\n      return block.copy(Fragment.from([...children.slice(0, CHROME_COUNT), ...body]))\n    })\n  }\n\n  let minLevel = Infinity\n  for (const block of input) if (isHeading(block)) minLevel = Math.min(minLevel, levelOf(block))\n  if (minLevel === Infinity) return changed ? input : null\n\n  const { nodes } = schema\n  let preamble: PMNode[] = []\n  const groups: { heading: PMNode, body: PMNode[] }[] = []\n  for (const block of input) {\n    if (isHeading(block) && levelOf(block) <= minLevel) groups.push({ heading: block, body: [] })\n    else if (groups.length) groups[groups.length - 1]!.body.push(block)\n    else preamble.push(block)\n  }\n  if (recursive) preamble = groupHeadingsIntoComposites(schema, preamble, true, kind) ?? preamble\n\n  const composites = groups.map(({ heading, body }) => {\n    let content = body\n    if (recursive) content = groupHeadingsIntoComposites(schema, content, true, kind) ?? content\n    if (!content.length) content = [nodes[PARAGRAPH]!.create()]\n    return nodes[COMPOSITE]!.create({ kind }, [\n      nodes[TITLE]!.create(null, heading.content), nodes[DESCRIPTION]!.create(), nodes[TAGS]!.create(), ...content,\n    ])\n  })\n  return [...preamble, ...composites]\n}\n\n/** Index range `[from, to)` of the heading at `index` in `parent` plus its content: up to the next sibling heading of the same or a higher level. */\nexport function headingGroupRange(parent: PMNode, index: number): { from: number, to: number } {\n  const level = levelOf(parent.child(index))\n  for (let i = index + 1; i < parent.childCount; i++) {\n    const child = parent.child(i)\n    if (isHeading(child) && levelOf(child) <= level) return { from: index, to: i }\n  }\n  return { from: index, to: parent.childCount }\n}\n\n/**\n * Description, tags and meta of `composite` as plain paragraphs, in this order, each only when non-empty: the\n * description italic, the tags as tag chips (`#name` text without a `tag` node), the meta as one `Label: Wert · …` line\n * (labels and option labels from the composite's kind in `kinds`; raw keys and values for an unknown kind).\n */\nexport function compositeChromeBlocks(schema: Schema, composite: PMNode, kinds: readonly CompositeKind[]): PMNode[] {\n  const n = schema.nodes\n  const paragraph = n[PARAGRAPH]!\n  const description = composite.child(1)\n  const tags: unknown = composite.child(2).attrs.tags\n  const blocks: PMNode[] = []\n  if (description.content.size) {\n    const italic = schema.marks.italic\n    const content: PMNode[] = []\n    description.forEach(child => content.push(italic && child.isText ? child.mark(italic.create().addToSet(child.marks)) : child))\n    blocks.push(paragraph.create(null, content))\n  }\n  const names = Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string' && tag !== '') : []\n  if (names.length) {\n    const chips = names.flatMap((name, index) => [\n      ...(index ? [schema.text(' ')] : []),\n      n.tag ? n.tag.create({ name }) : schema.text(`#${name}`),\n    ])\n    blocks.push(paragraph.create(null, chips))\n  }\n  const kind = composite.attrs.kind as string\n  const fields = kinds.some(known => known.id === kind) ? compositeKind(kinds, kind).fields : []\n  const meta = (composite.attrs.meta ?? {}) as Record<string, unknown>\n  const entries = Object.entries(meta)\n    .filter(([, value]) => value !== '' && value !== null && value !== undefined)\n    .map(([key, value]) => {\n      const field = fields.find(candidate => candidate.key === key)\n      const display = field?.options?.find(option => option.value === value)?.label ?? String(value)\n      return `${field?.label ?? key}: ${display}`\n    })\n  if (entries.length) blocks.push(paragraph.create(null, schema.text(entries.join(' · '))))\n  return blocks\n}\n\n/**\n * Inverse of `groupHeadingsIntoComposites`: every composite in `blocks` (siblings) becomes a heading of `level` (max 6)\n * with its title, then its chrome (`compositeChromeBlocks`), then its body (dropped when it is one empty paragraph).\n * Recursive: nested composites in bodies become headings of `level + 1` and so on; flat: they stay. `null` when\n * `blocks` holds no composite. Created blocks carry no id; carried-over body blocks keep theirs.\n */\nexport function flattenCompositesToHeadings(schema: Schema, blocks: readonly PMNode[], recursive: boolean, level: number, kinds: readonly CompositeKind[]): PMNode[] | null {\n  if (!blocks.some(block => block.type.name === COMPOSITE)) return null\n  const heading = schema.nodes[HEADING]!\n  return blocks.flatMap((block) => {\n    if (block.type.name !== COMPOSITE) return [block]\n    let body: PMNode[] = []\n    block.forEach((child, _offset, index) => {\n      if (index >= CHROME_COUNT) body.push(child)\n    })\n    if (body.length === 1 && body[0]!.type.name === PARAGRAPH && !body[0]!.content.size) body = []\n    if (recursive) body = flattenCompositesToHeadings(schema, body, true, level + 1, kinds) ?? body\n    return [heading.create({ level: Math.min(level, 6) }, block.child(0).content), ...compositeChromeBlocks(schema, block, kinds), ...body]\n  })\n}\n\n/**\n * `blocks` (siblings) in the preferred `structure`: `'composite'` groups headings into `section` composites at every\n * level, `'flat'` turns composites into headings starting at `level`. Unchanged blocks come back as a copy of the array.\n */\nexport function structureBlocks(schema: Schema, blocks: readonly PMNode[], structure: StructureMode, level: number, kinds: readonly CompositeKind[]): PMNode[] {\n  if (structure === 'composite') return groupHeadingsIntoComposites(schema, blocks, true, 'section') ?? [...blocks]\n  return flattenCompositesToHeadings(schema, blocks, true, level, kinds) ?? [...blocks]\n}\n"],"mappings":";;;AAKA,MAAM,UAAU;AAChB,MAAM,YAAY;AAClB,MAAM,QAAQ;AACd,MAAM,cAAc;AACpB,MAAM,OAAO;AACb,MAAM,YAAY;;AAElB,MAAM,eAAe;AAGrB,MAAM,aAAa,SAAiB,KAAK,KAAK,SAAS;AACvD,MAAM,WAAW,SAAiB,KAAK,MAAM;;;;;;AAO7C,SAAgB,4BAA4B,QAAgB,QAA2B,WAAoB,MAA+B;CACxI,IAAI,UAAU;CACd,IAAI,QAAkB,CAAC,GAAG,MAAM;CAChC,IAAI,WACF,QAAQ,MAAM,KAAK,UAAU;EAC3B,IAAI,MAAM,KAAK,SAAS,WAAW,OAAO;EAC1C,MAAM,WAAqB,CAAC;EAC5B,MAAM,SAAQ,UAAS,SAAS,KAAK,KAAK,CAAC;EAC3C,MAAM,OAAO,4BAA4B,QAAQ,SAAS,MAAM,YAAY,GAAG,MAAM,IAAI;EACzF,IAAI,CAAC,MAAM,OAAO;EAClB,UAAU;EACV,OAAO,MAAM,KAAK,SAAS,KAAK,CAAC,GAAG,SAAS,MAAM,GAAG,YAAY,GAAG,GAAG,IAAI,CAAC,CAAC;CAChF,CAAC;CAGH,IAAI,WAAW;CACf,KAAK,MAAM,SAAS,OAAO,IAAI,UAAU,KAAK,GAAG,WAAW,KAAK,IAAI,UAAU,QAAQ,KAAK,CAAC;CAC7F,IAAI,aAAa,UAAU,OAAO,UAAU,QAAQ;CAEpD,MAAM,EAAE,UAAU;CAClB,IAAI,WAAqB,CAAC;CAC1B,MAAM,SAAgD,CAAC;CACvD,KAAK,MAAM,SAAS,OAClB,IAAI,UAAU,KAAK,KAAK,QAAQ,KAAK,KAAK,UAAU,OAAO,KAAK;EAAE,SAAS;EAAO,MAAM,CAAC;CAAE,CAAC;MACvF,IAAI,OAAO,QAAQ,OAAO,OAAO,SAAS,EAAE,CAAE,KAAK,KAAK,KAAK;MAC7D,SAAS,KAAK,KAAK;CAE1B,IAAI,WAAW,WAAW,4BAA4B,QAAQ,UAAU,MAAM,IAAI,KAAK;CAEvF,MAAM,aAAa,OAAO,KAAK,EAAE,SAAS,WAAW;EACnD,IAAI,UAAU;EACd,IAAI,WAAW,UAAU,4BAA4B,QAAQ,SAAS,MAAM,IAAI,KAAK;EACrF,IAAI,CAAC,QAAQ,QAAQ,UAAU,CAAC,MAAM,UAAU,CAAE,OAAO,CAAC;EAC1D,OAAO,MAAM,UAAU,CAAE,OAAO,EAAE,KAAK,GAAG;GACxC,MAAM,MAAM,CAAE,OAAO,MAAM,QAAQ,OAAO;GAAG,MAAM,YAAY,CAAE,OAAO;GAAG,MAAM,KAAK,CAAE,OAAO;GAAG,GAAG;EACvG,CAAC;CACH,CAAC;CACD,OAAO,CAAC,GAAG,UAAU,GAAG,UAAU;AACpC;;AAGA,SAAgB,kBAAkB,QAAgB,OAA6C;CAC7F,MAAM,QAAQ,QAAQ,OAAO,MAAM,KAAK,CAAC;CACzC,KAAK,IAAI,IAAI,QAAQ,GAAG,IAAI,OAAO,YAAY,KAAK;EAClD,MAAM,QAAQ,OAAO,MAAM,CAAC;EAC5B,IAAI,UAAU,KAAK,KAAK,QAAQ,KAAK,KAAK,OAAO,OAAO;GAAE,MAAM;GAAO,IAAI;EAAE;CAC/E;CACA,OAAO;EAAE,MAAM;EAAO,IAAI,OAAO;CAAW;AAC9C;;;;;;AAOA,SAAgB,sBAAsB,QAAgB,WAAmB,OAA2C;CAClH,MAAM,IAAI,OAAO;CACjB,MAAM,YAAY,EAAE;CACpB,MAAM,cAAc,UAAU,MAAM,CAAC;CACrC,MAAM,OAAgB,UAAU,MAAM,CAAC,CAAC,CAAC,MAAM;CAC/C,MAAM,SAAmB,CAAC;CAC1B,IAAI,YAAY,QAAQ,MAAM;EAC5B,MAAM,SAAS,OAAO,MAAM;EAC5B,MAAM,UAAoB,CAAC;EAC3B,YAAY,SAAQ,UAAS,QAAQ,KAAK,UAAU,MAAM,SAAS,MAAM,KAAK,OAAO,OAAO,CAAC,CAAC,SAAS,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC;EAC7H,OAAO,KAAK,UAAU,OAAO,MAAM,OAAO,CAAC;CAC7C;CACA,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,QAAQ,QAAuB,OAAO,QAAQ,YAAY,QAAQ,EAAE,IAAI,CAAC;CAClH,IAAI,MAAM,QAAQ;EAChB,MAAM,QAAQ,MAAM,SAAS,MAAM,UAAU,CAC3C,GAAI,QAAQ,CAAC,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,GAClC,EAAE,MAAM,EAAE,IAAI,OAAO,EAAE,KAAK,CAAC,IAAI,OAAO,KAAK,IAAI,MAAM,CACzD,CAAC;EACD,OAAO,KAAK,UAAU,OAAO,MAAM,KAAK,CAAC;CAC3C;CACA,MAAM,OAAO,UAAU,MAAM;CAC7B,MAAM,SAAS,MAAM,MAAK,UAAS,MAAM,OAAO,IAAI,IAAI,cAAc,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC;CAC7F,MAAM,OAAQ,UAAU,MAAM,QAAQ,CAAC;CACvC,MAAM,UAAU,OAAO,QAAQ,IAAI,CAAC,CACjC,QAAQ,GAAG,WAAW,UAAU,MAAM,UAAU,QAAQ,UAAU,KAAA,CAAS,CAAC,CAC5E,KAAK,CAAC,KAAK,WAAW;EACrB,MAAM,QAAQ,OAAO,MAAK,cAAa,UAAU,QAAQ,GAAG;EAC5D,MAAM,UAAU,OAAO,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,SAAS,OAAO,KAAK;EAC7F,OAAO,GAAG,OAAO,SAAS,IAAI,IAAI;CACpC,CAAC;CACH,IAAI,QAAQ,QAAQ,OAAO,KAAK,UAAU,OAAO,MAAM,OAAO,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC;CACxF,OAAO;AACT;;;;;;;AAQA,SAAgB,4BAA4B,QAAgB,QAA2B,WAAoB,OAAe,OAAkD;CAC1K,IAAI,CAAC,OAAO,MAAK,UAAS,MAAM,KAAK,SAAS,SAAS,GAAG,OAAO;CACjE,MAAM,UAAU,OAAO,MAAM;CAC7B,OAAO,OAAO,SAAS,UAAU;EAC/B,IAAI,MAAM,KAAK,SAAS,WAAW,OAAO,CAAC,KAAK;EAChD,IAAI,OAAiB,CAAC;EACtB,MAAM,SAAS,OAAO,SAAS,UAAU;GACvC,IAAI,SAAS,cAAc,KAAK,KAAK,KAAK;EAC5C,CAAC;EACD,IAAI,KAAK,WAAW,KAAK,KAAK,EAAE,CAAE,KAAK,SAAS,aAAa,CAAC,KAAK,EAAE,CAAE,QAAQ,MAAM,OAAO,CAAC;EAC7F,IAAI,WAAW,OAAO,4BAA4B,QAAQ,MAAM,MAAM,QAAQ,GAAG,KAAK,KAAK;EAC3F,OAAO;GAAC,QAAQ,OAAO,EAAE,OAAO,KAAK,IAAI,OAAO,CAAC,EAAE,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,OAAO;GAAG,GAAG,sBAAsB,QAAQ,OAAO,KAAK;GAAG,GAAG;EAAI;CACxI,CAAC;AACH;;;;;AAMA,SAAgB,gBAAgB,QAAgB,QAA2B,WAA0B,OAAe,OAA2C;CAC7J,IAAI,cAAc,aAAa,OAAO,4BAA4B,QAAQ,QAAQ,MAAM,SAAS,KAAK,CAAC,GAAG,MAAM;CAChH,OAAO,4BAA4B,QAAQ,QAAQ,MAAM,OAAO,KAAK,KAAK,CAAC,GAAG,MAAM;AACtF"}

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

@@ -0,0 +1,20 @@
+import { CompositeAiBrief, compositeAiBrief } from "./ai-brief.js";
+import { CompositeKind, CompositeKindAi, CompositeMetaField, compositeKind, defaultCompositeKinds } from "./kinds.js";
+import { CompositeMention, CompositeRow, compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
+import { CompositeAnchor, CompositeAnchorsHandle, CompositeFrame, compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
+import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeOptions, CompositeStorage, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { CompositeNodeViews, compositeNodes } from "./node-views.js";
+import { CompositeFeatureOptions, CompositesUi, compositeFeatureCore } from "./feature.js";
+import { documentCompositeMarkdown, headingsMarkdown, markdownFileName } from "./markdown-export.js";
+import { OutlineNode, canMoveBlockInto, compositeOutline, moveBlockInto } from "./outline.js";
+import { CompositeKindCount, CompositeRowsHandle, CompositeRowsState, createCompositeRows } from "./rows-model.js";
+import { Structure, StructureStorage, structureOf } from "./structure.js";
+import { STRUCTURE_MODE_KEYS } from "./structure-mode.js";
+import { TREE_ROOT_KEYS } from "./tree-root.js";
+import { compositeConversions, convertCompositeBlocks } from "./convert.js";
+import { CompositeFence, FenceSegment, splitCompositeFences } from "../../core/fences.js";
+import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
+import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
+import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+import { compositeSchemaExtensions } from "./schema.js";
+export { COMPOSITE_CHROME_COUNT, type CompositeAiBrief, type CompositeAnchor, type CompositeAnchorsHandle, CompositeDescriptionNode, type CompositeFeatureOptions, type CompositeFence, type CompositeFrame, type CompositeKind, type CompositeKindAi, type CompositeKindCount, type CompositeMention, type CompositeMetaField, CompositeNode, type CompositeNodeViews, type CompositeOptions, type CompositeRow, type CompositeRowsHandle, type CompositeRowsState, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type CompositesUi, type FenceSegment, LEGACY_COMPOSITE_NODE, type OutlineNode, STRUCTURE_MODE_KEYS, Structure, type StructureStorage, TREE_ROOT_KEYS, blocksFromMarkdown, canMoveBlockInto, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeRows, defaultCompositeKinds, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, markdownFileName, migrateLegacyContent, moveBlockInto, observeCompositeAnchors, setCompositeDescription, setCompositeMetaField, setCompositeTags, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf };

package/dist/features/composites/index.js

@@ -0,0 +1,20 @@
+import { splitCompositeFences } from "../../core/fences.js";
+import { compositeKind, defaultCompositeKinds } from "./kinds.js";
+import { blocksFromMarkdown, compositeFence, compositeFromMarkdown } from "./fences.js";
+import { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from "./heading-composites.js";
+import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.js";
+import { compositeAiBrief } from "./ai-brief.js";
+import { compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags } from "./rows.js";
+import { compositeSectionOf, observeCompositeAnchors } from "./anchors.js";
+import { compositeConversions, convertCompositeBlocks } from "./convert.js";
+import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+import { documentCompositeMarkdown, headingsMarkdown, markdownFileName } from "./markdown-export.js";
+import { compositeNodes } from "./node-views.js";
+import { Structure, structureOf } from "./structure.js";
+import { STRUCTURE_MODE_KEYS } from "./structure-mode.js";
+import { compositeFeatureCore } from "./feature.js";
+import { canMoveBlockInto, compositeOutline, moveBlockInto } from "./outline.js";
+import { createCompositeRows } from "./rows-model.js";
+import { TREE_ROOT_KEYS } from "./tree-root.js";
+import { compositeSchemaExtensions } from "./schema.js";
+export { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, LEGACY_COMPOSITE_NODE, STRUCTURE_MODE_KEYS, Structure, TREE_ROOT_KEYS, blocksFromMarkdown, canMoveBlockInto, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeDescriptionText, compositeFeatureCore, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeMetaWith, compositeNodes, compositeOfRow, compositeOutline, compositeRowAt, compositeRows, compositeSchemaExtensions, compositeSectionOf, convertCompositeBlocks, createCompositeRows, defaultCompositeKinds, documentCompositeMarkdown, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, headingsMarkdown, markdownFileName, migrateLegacyContent, moveBlockInto, observeCompositeAnchors, setCompositeDescription, setCompositeMetaField, setCompositeTags, splitCompositeFences, structureBlocks as structureCompositeBlocks, structureOf };

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

@@ -0,0 +1,49 @@
+import { Translate } from "../../i18n/index.js";
+//#region src/features/composites/kinds.d.ts
+/** One metadata field of a composite kind, stored under `key` in the composite's `meta` attribute. */
+export interface CompositeMetaField {
+  key: string;
+  label: string;
+  type: 'text' | 'textarea' | 'date' | 'number' | 'select';
+  /** Choices of a `select` field. */
+  options?: {
+    value: string;
+    label: string;
+  }[];
+}
+/**
+ * What a kind tells the model beyond its fields. `purpose` goes into every AI request's block model (chat, generate
+ * tasks); `instructions`, `instructionsField` and `skeleton` are read only by „Baustein füllen (KI)“ (`fillComposite`).
+ */
+export interface CompositeKindAi {
+  /** One or two German sentences: what a Baustein of this kind is for and what its body holds. */
+  purpose: string;
+  /** Default instruction for filling the body of a Baustein of this kind (what to write, structure, tone). */
+  instructions?: string;
+  /** Key of a `textarea` field of this kind; a Baustein whose value is non-empty replaces `instructions` with it. */
+  instructionsField?: string;
+  /** Target text (Vorlage) as Markdown; `{key}` placeholders are replaced by the Baustein's `meta[key]` before it goes to the model, unknown ones stay. */
+  skeleton?: string;
+}
+/** A composite kind: what its `kind` attribute selects (label, icon, chrome placeholders, meta fields). */
+export interface CompositeKind {
+  id: string;
+  label: string;
+  icon: string;
+  titlePlaceholder: string;
+  descriptionPlaceholder: string;
+  fields: CompositeMetaField[];
+  /** Absent: the kind has no AI brief; „Baustein füllen (KI)“ is not offered for it. */
+  ai?: CompositeKindAi;
+}
+/**
+ * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field
+ * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own
+ * kinds (`compositeFeature({ kinds })`, `Composite.configure({ kinds })`) keep their labels untouched. Ids, field keys and
+ * stored values (`open`, `doing`, `done`) do not depend on the language.
+ */
+export declare function defaultCompositeKinds(t: Translate): readonly CompositeKind[];
+/** Kind `id` from `kinds`; an unknown id gets the `section` kind's presentation (else the first kind's) under its own id and label. */
+export declare function compositeKind(kinds: readonly CompositeKind[], id: string): CompositeKind;
+//#endregion
+//# sourceMappingURL=kinds.d.ts.map

package/dist/features/composites/kinds.js

@@ -0,0 +1,131 @@
+import { createTranslator } from "../../i18n/index.js";
+//#region src/features/composites/kinds.ts
+/**
+* The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field
+* labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own
+* kinds (`compositeFeature({ kinds })`, `Composite.configure({ kinds })`) keep their labels untouched. Ids, field keys and
+* stored values (`open`, `doing`, `done`) do not depend on the language.
+*/
+function defaultCompositeKinds(t) {
+	let kinds = DEFAULT_KINDS.get(t);
+	if (!kinds) DEFAULT_KINDS.set(t, kinds = buildDefaultKinds(t));
+	return kinds;
+}
+const DEFAULT_KINDS = /* @__PURE__ */ new WeakMap();
+function buildDefaultKinds(t) {
+	return [
+		{
+			id: "section",
+			label: t("composites.kind.section.label"),
+			icon: "i-lucide-layers",
+			titlePlaceholder: t("composites.kind.section.title"),
+			descriptionPlaceholder: t("composites.kind.section.description"),
+			fields: []
+		},
+		{
+			id: "task",
+			label: t("composites.kind.task.label"),
+			icon: "i-lucide-square-check",
+			titlePlaceholder: t("composites.kind.task.title"),
+			descriptionPlaceholder: t("composites.kind.task.description"),
+			fields: [
+				{
+					key: "status",
+					label: t("composites.kind.task.field.status"),
+					type: "select",
+					options: [
+						{
+							value: "open",
+							label: t("composites.kind.task.status.open")
+						},
+						{
+							value: "doing",
+							label: t("composites.kind.task.status.doing")
+						},
+						{
+							value: "done",
+							label: t("composites.kind.task.status.done")
+						}
+					]
+				},
+				{
+					key: "due",
+					label: t("composites.kind.task.field.due"),
+					type: "date"
+				},
+				{
+					key: "assignee",
+					label: t("composites.kind.task.field.assignee"),
+					type: "text"
+				}
+			]
+		},
+		{
+			id: "note",
+			label: t("composites.kind.note.label"),
+			icon: "i-lucide-sticky-note",
+			titlePlaceholder: t("composites.kind.note.title"),
+			descriptionPlaceholder: t("composites.kind.note.description"),
+			fields: []
+		},
+		{
+			id: "document",
+			label: t("composites.kind.document.label"),
+			icon: "i-lucide-file-text",
+			titlePlaceholder: t("composites.kind.document.title"),
+			descriptionPlaceholder: t("composites.kind.document.description"),
+			fields: [
+				{
+					key: "filename",
+					label: t("composites.kind.document.field.filename"),
+					type: "text"
+				},
+				{
+					key: "mimeType",
+					label: t("composites.kind.document.field.mimeType"),
+					type: "text"
+				},
+				{
+					key: "size",
+					label: t("composites.kind.document.field.size"),
+					type: "number"
+				},
+				{
+					key: "importedAt",
+					label: t("composites.kind.document.field.importedAt"),
+					type: "date"
+				},
+				{
+					key: "transcript",
+					label: t("composites.kind.document.field.transcript"),
+					type: "textarea"
+				}
+			]
+		},
+		{
+			id: "folder",
+			label: t("composites.kind.folder.label"),
+			icon: "i-lucide-folder",
+			titlePlaceholder: t("composites.kind.folder.title"),
+			descriptionPlaceholder: t("composites.kind.folder.description"),
+			fields: []
+		}
+	];
+}
+/** The built-in kinds in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */
+const fallbackCompositeKinds = () => defaultCompositeKinds(DEFAULT_TRANSLATE);
+const DEFAULT_TRANSLATE = createTranslator();
+/** Kind `id` from `kinds`; an unknown id gets the `section` kind's presentation (else the first kind's) under its own id and label. */
+function compositeKind(kinds, id) {
+	const known = kinds.find((kind) => kind.id === id);
+	if (known) return known;
+	return {
+		...kinds.find((kind) => kind.id === "section") ?? kinds[0] ?? fallbackCompositeKinds()[0],
+		id,
+		label: id
+	};
+}
+//#endregion
+export { compositeKind, defaultCompositeKinds, fallbackCompositeKinds };
+
+//# sourceMappingURL=kinds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.js","names":[],"sources":["../../../src/features/composites/kinds.ts"],"sourcesContent":["// Vue-free and server-importable: the kind registry of the composite block family („Bausteine“).\nimport { createTranslator, type Translate } from '../../i18n'\n\n/** One metadata field of a composite kind, stored under `key` in the composite's `meta` attribute. */\nexport interface CompositeMetaField {\n  key: string\n  label: string\n  type: 'text' | 'textarea' | 'date' | 'number' | 'select'\n  /** Choices of a `select` field. */\n  options?: { value: string, label: string }[]\n}\n\n/**\n * What a kind tells the model beyond its fields. `purpose` goes into every AI request's block model (chat, generate\n * tasks); `instructions`, `instructionsField` and `skeleton` are read only by „Baustein füllen (KI)“ (`fillComposite`).\n */\nexport interface CompositeKindAi {\n  /** One or two German sentences: what a Baustein of this kind is for and what its body holds. */\n  purpose: string\n  /** Default instruction for filling the body of a Baustein of this kind (what to write, structure, tone). */\n  instructions?: string\n  /** Key of a `textarea` field of this kind; a Baustein whose value is non-empty replaces `instructions` with it. */\n  instructionsField?: string\n  /** Target text (Vorlage) as Markdown; `{key}` placeholders are replaced by the Baustein's `meta[key]` before it goes to the model, unknown ones stay. */\n  skeleton?: string\n}\n\n/** A composite kind: what its `kind` attribute selects (label, icon, chrome placeholders, meta fields). */\nexport interface CompositeKind {\n  id: string\n  label: string\n  icon: string\n  titlePlaceholder: string\n  descriptionPlaceholder: string\n  fields: CompositeMetaField[]\n  /** Absent: the kind has no AI brief; „Baustein füllen (KI)“ is not offered for it. */\n  ai?: CompositeKindAi\n}\n\n/**\n * The built-in kinds in the language of `t`. The default set is produced from the translator (labels, placeholders, field\n * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own\n * kinds (`compositeFeature({ kinds })`, `Composite.configure({ kinds })`) keep their labels untouched. Ids, field keys and\n * stored values (`open`, `doing`, `done`) do not depend on the language.\n */\nexport function defaultCompositeKinds(t: Translate): readonly CompositeKind[] {\n  let kinds = DEFAULT_KINDS.get(t)\n  if (!kinds) DEFAULT_KINDS.set(t, kinds = buildDefaultKinds(t))\n  return kinds\n}\n\nconst DEFAULT_KINDS = new WeakMap<Translate, readonly CompositeKind[]>()\n\nfunction buildDefaultKinds(t: Translate): readonly CompositeKind[] {\n  return [\n    { id: 'section', label: t('composites.kind.section.label'), icon: 'i-lucide-layers', titlePlaceholder: t('composites.kind.section.title'), descriptionPlaceholder: t('composites.kind.section.description'), fields: [] },\n    { id: 'task', label: t('composites.kind.task.label'), icon: 'i-lucide-square-check', titlePlaceholder: t('composites.kind.task.title'), descriptionPlaceholder: t('composites.kind.task.description'), fields: [\n      { key: 'status', label: t('composites.kind.task.field.status'), type: 'select', options: [\n        { value: 'open', label: t('composites.kind.task.status.open') },\n        { value: 'doing', label: t('composites.kind.task.status.doing') },\n        { value: 'done', label: t('composites.kind.task.status.done') },\n      ] },\n      { key: 'due', label: t('composites.kind.task.field.due'), type: 'date' },\n      { key: 'assignee', label: t('composites.kind.task.field.assignee'), type: 'text' },\n    ] },\n    { id: 'note', label: t('composites.kind.note.label'), icon: 'i-lucide-sticky-note', titlePlaceholder: t('composites.kind.note.title'), descriptionPlaceholder: t('composites.kind.note.description'), fields: [] },\n    { id: 'document', label: t('composites.kind.document.label'), icon: 'i-lucide-file-text', titlePlaceholder: t('composites.kind.document.title'), descriptionPlaceholder: t('composites.kind.document.description'), fields: [\n      { key: 'filename', label: t('composites.kind.document.field.filename'), type: 'text' },\n      { key: 'mimeType', label: t('composites.kind.document.field.mimeType'), type: 'text' },\n      { key: 'size', label: t('composites.kind.document.field.size'), type: 'number' },\n      { key: 'importedAt', label: t('composites.kind.document.field.importedAt'), type: 'date' },\n      { key: 'transcript', label: t('composites.kind.document.field.transcript'), type: 'textarea' },\n    ] },\n    { id: 'folder', label: t('composites.kind.folder.label'), icon: 'i-lucide-folder', titlePlaceholder: t('composites.kind.folder.title'), descriptionPlaceholder: t('composites.kind.folder.description'), fields: [] },\n  ]\n}\n\n/** The built-in kinds in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */\nexport const fallbackCompositeKinds = (): readonly CompositeKind[] => defaultCompositeKinds(DEFAULT_TRANSLATE)\n\nconst DEFAULT_TRANSLATE = createTranslator()\n\n/** Kind `id` from `kinds`; an unknown id gets the `section` kind's presentation (else the first kind's) under its own id and label. */\nexport function compositeKind(kinds: readonly CompositeKind[], id: string): CompositeKind {\n  const known = kinds.find(kind => kind.id === id)\n  if (known) return known\n  const base = kinds.find(kind => kind.id === 'section') ?? kinds[0] ?? fallbackCompositeKinds()[0]!\n  return { ...base, id, label: id }\n}\n"],"mappings":";;;;;;;;AA6CA,SAAgB,sBAAsB,GAAwC;CAC5E,IAAI,QAAQ,cAAc,IAAI,CAAC;CAC/B,IAAI,CAAC,OAAO,cAAc,IAAI,GAAG,QAAQ,kBAAkB,CAAC,CAAC;CAC7D,OAAO;AACT;AAEA,MAAM,gCAAgB,IAAI,QAA6C;AAEvE,SAAS,kBAAkB,GAAwC;CACjE,OAAO;EACL;GAAE,IAAI;GAAW,OAAO,EAAE,+BAA+B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,+BAA+B;GAAG,wBAAwB,EAAE,qCAAqC;GAAG,QAAQ,CAAC;EAAE;EACxN;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAyB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ;IAC7M;KAAE,KAAK;KAAU,OAAO,EAAE,mCAAmC;KAAG,MAAM;KAAU,SAAS;MACvF;OAAE,OAAO;OAAQ,OAAO,EAAE,kCAAkC;MAAE;MAC9D;OAAE,OAAO;OAAS,OAAO,EAAE,mCAAmC;MAAE;MAChE;OAAE,OAAO;OAAQ,OAAO,EAAE,kCAAkC;MAAE;KAChE;IAAE;IACF;KAAE,KAAK;KAAO,OAAO,EAAE,gCAAgC;KAAG,MAAM;IAAO;IACvE;KAAE,KAAK;KAAY,OAAO,EAAE,qCAAqC;KAAG,MAAM;IAAO;GACnF;EAAE;EACF;GAAE,IAAI;GAAQ,OAAO,EAAE,4BAA4B;GAAG,MAAM;GAAwB,kBAAkB,EAAE,4BAA4B;GAAG,wBAAwB,EAAE,kCAAkC;GAAG,QAAQ,CAAC;EAAE;EACjN;GAAE,IAAI;GAAY,OAAO,EAAE,gCAAgC;GAAG,MAAM;GAAsB,kBAAkB,EAAE,gCAAgC;GAAG,wBAAwB,EAAE,sCAAsC;GAAG,QAAQ;IAC1N;KAAE,KAAK;KAAY,OAAO,EAAE,yCAAyC;KAAG,MAAM;IAAO;IACrF;KAAE,KAAK;KAAY,OAAO,EAAE,yCAAyC;KAAG,MAAM;IAAO;IACrF;KAAE,KAAK;KAAQ,OAAO,EAAE,qCAAqC;KAAG,MAAM;IAAS;IAC/E;KAAE,KAAK;KAAc,OAAO,EAAE,2CAA2C;KAAG,MAAM;IAAO;IACzF;KAAE,KAAK;KAAc,OAAO,EAAE,2CAA2C;KAAG,MAAM;IAAW;GAC/F;EAAE;EACF;GAAE,IAAI;GAAU,OAAO,EAAE,8BAA8B;GAAG,MAAM;GAAmB,kBAAkB,EAAE,8BAA8B;GAAG,wBAAwB,EAAE,oCAAoC;GAAG,QAAQ,CAAC;EAAE;CACtN;AACF;;AAGA,MAAa,+BAAyD,sBAAsB,iBAAiB;AAE7G,MAAM,oBAAoB,iBAAiB;;AAG3C,SAAgB,cAAc,OAAiC,IAA2B;CACxF,MAAM,QAAQ,MAAM,MAAK,SAAQ,KAAK,OAAO,EAAE;CAC/C,IAAI,OAAO,OAAO;CAElB,OAAO;EAAE,GADI,MAAM,MAAK,SAAQ,KAAK,OAAO,SAAS,KAAK,MAAM,MAAM,uBAAuB,CAAC,CAAC;EAC7E;EAAI,OAAO;CAAG;AAClC"}

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

@@ -0,0 +1,8 @@
+import { JSONContent } from "@tiptap/core";
+//#region src/features/composites/legacy.d.ts
+/** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */
+export declare const LEGACY_COMPOSITE_NODE = "section";
+/** `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`); recursive, returns a copy. */
+export declare function migrateLegacyContent(json: JSONContent): JSONContent;
+//#endregion
+//# sourceMappingURL=legacy.d.ts.map

package/dist/features/composites/legacy.js

@@ -0,0 +1,25 @@
+//#region src/features/composites/legacy.ts
+const LEGACY_RENAMES = {
+	section: "composite",
+	sectionTitle: "compositeTitle",
+	sectionSummary: "compositeDescription",
+	sectionTags: "compositeTags"
+};
+/** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */
+const LEGACY_COMPOSITE_NODE = "section";
+/** `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`); recursive, returns a copy. */
+function migrateLegacyContent(json) {
+	const renamed = json.type ? LEGACY_RENAMES[json.type] : void 0;
+	const result = { ...json };
+	if (renamed) result.type = renamed;
+	if (json.type === "section") result.attrs = {
+		...json.attrs,
+		kind: "section"
+	};
+	if (json.content) result.content = json.content.map(migrateLegacyContent);
+	return result;
+}
+//#endregion
+export { LEGACY_COMPOSITE_NODE, migrateLegacyContent };
+
+//# sourceMappingURL=legacy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","names":[],"sources":["../../../src/features/composites/legacy.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\n\n// Node names of the former single-purpose block that the composite family replaced (dev data only).\nconst LEGACY_RENAMES: Readonly<Record<string, string>> = {\n  section: 'composite',\n  sectionTitle: 'compositeTitle',\n  sectionSummary: 'compositeDescription',\n  sectionTags: 'compositeTags',\n}\n\n/** Legacy node name of the composite block; stored Yjs docs containing it are reseeded from migrated JSON. */\nexport const LEGACY_COMPOSITE_NODE = 'section'\n\n/** `json` with legacy node types renamed to the composite family (a legacy block becomes kind `section`); recursive, returns a copy. */\nexport function migrateLegacyContent(json: JSONContent): JSONContent {\n  const renamed = json.type ? LEGACY_RENAMES[json.type] : undefined\n  const result: JSONContent = { ...json }\n  if (renamed) result.type = renamed\n  if (json.type === LEGACY_COMPOSITE_NODE) result.attrs = { ...json.attrs, kind: 'section' }\n  if (json.content) result.content = json.content.map(migrateLegacyContent)\n  return result\n}\n"],"mappings":";AAGA,MAAM,iBAAmD;CACvD,SAAS;CACT,cAAc;CACd,gBAAgB;CAChB,aAAa;AACf;;AAGA,MAAa,wBAAwB;;AAGrC,SAAgB,qBAAqB,MAAgC;CACnE,MAAM,UAAU,KAAK,OAAO,eAAe,KAAK,QAAQ,KAAA;CACxD,MAAM,SAAsB,EAAE,GAAG,KAAK;CACtC,IAAI,SAAS,OAAO,OAAO;CAC3B,IAAI,KAAK,SAAA,WAAgC,OAAO,QAAQ;EAAE,GAAG,KAAK;EAAO,MAAM;CAAU;CACzF,IAAI,KAAK,SAAS,OAAO,UAAU,KAAK,QAAQ,IAAI,oBAAoB;CACxE,OAAO;AACT"}

package/dist/features/composites/markdown-export.d.ts

@@ -0,0 +1,17 @@
+import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/composites/markdown-export.d.ts
+/**
+ * `blocks` as Markdown with every composite turned into a heading, the outermost at `level` (nested ones deeper), then
+ * its description, tags and meta line, then its body.
+ */
+export declare function headingsMarkdown(editor: Editor, blocks: readonly Node$1[], level: number): string;
+/**
+ * A composite as a Markdown document: its title as `#` heading, description and tags (no meta line: the original file
+ * name, type and size describe the import, not the content), then the body with nested composites as `##`, `###`, ….
+ */
+export declare function documentCompositeMarkdown(editor: Editor, node: Node$1): string;
+/** Download name for `node`'s Markdown: the imported file's name with its extension replaced by `.md`, else the title. */
+export declare function markdownFileName(node: Node$1): string;
+//#endregion
+//# sourceMappingURL=markdown-export.d.ts.map

package/dist/features/composites/markdown-export.js

@@ -0,0 +1,49 @@
+import { compositeChromeBlocks, flattenCompositesToHeadings } from "./heading-composites.js";
+import { compositeKindsOf } from "./nodes.js";
+//#region src/features/composites/markdown-export.ts
+/**
+* `blocks` as Markdown with every composite turned into a heading, the outermost at `level` (nested ones deeper), then
+* its description, tags and meta line, then its body.
+*/
+function headingsMarkdown(editor, blocks, level) {
+	const nodes = flattenCompositesToHeadings(editor.schema, blocks, true, level, compositeKindsOf(editor)) ?? [...blocks];
+	return editor.markdown.serialize({
+		type: "doc",
+		content: nodes.map((node) => node.toJSON())
+	});
+}
+/**
+* A composite as a Markdown document: its title as `#` heading, description and tags (no meta line: the original file
+* name, type and size describe the import, not the content), then the body with nested composites as `##`, `###`, ….
+*/
+function documentCompositeMarkdown(editor, node) {
+	const { schema } = editor;
+	const title = node.child(0);
+	const heading = title.content.size ? [schema.nodes.heading.create({ level: 1 }, title.content)] : [];
+	const withoutMeta = node.type.create({
+		...node.attrs,
+		meta: {}
+	}, node.content);
+	const chrome = compositeChromeBlocks(schema, withoutMeta, compositeKindsOf(editor));
+	let body = [];
+	node.forEach((child, _offset, index) => {
+		if (index >= 3) body.push(child);
+	});
+	if (body.length === 1 && body[0].type.name === "paragraph" && !body[0].content.size) body = [];
+	return headingsMarkdown(editor, [
+		...heading,
+		...chrome,
+		...body
+	], 2);
+}
+/** Download name for `node`'s Markdown: the imported file's name with its extension replaced by `.md`, else the title. */
+function markdownFileName(node) {
+	const meta = node.attrs.meta ?? {};
+	const filename = typeof meta.filename === "string" ? meta.filename.trim() : "";
+	const dot = filename.lastIndexOf(".");
+	return `${filename ? dot > 0 ? filename.slice(0, dot) : filename : node.child(0).textContent.trim() || "dokument"}.md`.replace(/[\\/:*?"<>|]+/g, "-");
+}
+//#endregion
+export { documentCompositeMarkdown, headingsMarkdown, markdownFileName };
+
+//# sourceMappingURL=markdown-export.js.map

package/dist/features/composites/markdown-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-export.js","names":[],"sources":["../../../src/features/composites/markdown-export.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { compositeChromeBlocks, flattenCompositesToHeadings } from './heading-composites'\nimport { COMPOSITE_CHROME_COUNT, compositeKindsOf } from './nodes'\n\n/**\n * `blocks` as Markdown with every composite turned into a heading, the outermost at `level` (nested ones deeper), then\n * its description, tags and meta line, then its body.\n */\nexport function headingsMarkdown(editor: Editor, blocks: readonly PMNode[], level: number): string {\n  const nodes = flattenCompositesToHeadings(editor.schema, blocks, true, level, compositeKindsOf(editor)) ?? [...blocks]\n  return editor.markdown!.serialize({ type: 'doc', content: nodes.map(node => node.toJSON()) })\n}\n\n/**\n * A composite as a Markdown document: its title as `#` heading, description and tags (no meta line: the original file\n * name, type and size describe the import, not the content), then the body with nested composites as `##`, `###`, ….\n */\nexport function documentCompositeMarkdown(editor: Editor, node: PMNode): string {\n  const { schema } = editor\n  const title = node.child(0)\n  const heading = title.content.size ? [schema.nodes.heading!.create({ level: 1 }, title.content)] : []\n  const withoutMeta = node.type.create({ ...node.attrs, meta: {} }, node.content)\n  const chrome = compositeChromeBlocks(schema, withoutMeta, compositeKindsOf(editor))\n  let body: PMNode[] = []\n  node.forEach((child, _offset, index) => {\n    if (index >= COMPOSITE_CHROME_COUNT) body.push(child)\n  })\n  if (body.length === 1 && body[0]!.type.name === 'paragraph' && !body[0]!.content.size) body = []\n  return headingsMarkdown(editor, [...heading, ...chrome, ...body], 2)\n}\n\n/** Download name for `node`'s Markdown: the imported file's name with its extension replaced by `.md`, else the title. */\nexport function markdownFileName(node: PMNode): string {\n  const meta = (node.attrs.meta ?? {}) as Record<string, unknown>\n  const filename = typeof meta.filename === 'string' ? meta.filename.trim() : ''\n  const dot = filename.lastIndexOf('.')\n  const stem = filename ? (dot > 0 ? filename.slice(0, dot) : filename) : node.child(0).textContent.trim() || 'dokument'\n  return `${stem}.md`.replace(/[\\\\/:*?\"<>|]+/g, '-')\n}\n"],"mappings":";;;;;;;AASA,SAAgB,iBAAiB,QAAgB,QAA2B,OAAuB;CACjG,MAAM,QAAQ,4BAA4B,OAAO,QAAQ,QAAQ,MAAM,OAAO,iBAAiB,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM;CACrH,OAAO,OAAO,SAAU,UAAU;EAAE,MAAM;EAAO,SAAS,MAAM,KAAI,SAAQ,KAAK,OAAO,CAAC;CAAE,CAAC;AAC9F;;;;;AAMA,SAAgB,0BAA0B,QAAgB,MAAsB;CAC9E,MAAM,EAAE,WAAW;CACnB,MAAM,QAAQ,KAAK,MAAM,CAAC;CAC1B,MAAM,UAAU,MAAM,QAAQ,OAAO,CAAC,OAAO,MAAM,QAAS,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;CACpG,MAAM,cAAc,KAAK,KAAK,OAAO;EAAE,GAAG,KAAK;EAAO,MAAM,CAAC;CAAE,GAAG,KAAK,OAAO;CAC9E,MAAM,SAAS,sBAAsB,QAAQ,aAAa,iBAAiB,MAAM,CAAC;CAClF,IAAI,OAAiB,CAAC;CACtB,KAAK,SAAS,OAAO,SAAS,UAAU;EACtC,IAAI,SAAA,GAAiC,KAAK,KAAK,KAAK;CACtD,CAAC;CACD,IAAI,KAAK,WAAW,KAAK,KAAK,EAAE,CAAE,KAAK,SAAS,eAAe,CAAC,KAAK,EAAE,CAAE,QAAQ,MAAM,OAAO,CAAC;CAC/F,OAAO,iBAAiB,QAAQ;EAAC,GAAG;EAAS,GAAG;EAAQ,GAAG;CAAI,GAAG,CAAC;AACrE;;AAGA,SAAgB,iBAAiB,MAAsB;CACrD,MAAM,OAAQ,KAAK,MAAM,QAAQ,CAAC;CAClC,MAAM,WAAW,OAAO,KAAK,aAAa,WAAW,KAAK,SAAS,KAAK,IAAI;CAC5E,MAAM,MAAM,SAAS,YAAY,GAAG;CAEpC,OAAO,GADM,WAAY,MAAM,IAAI,SAAS,MAAM,GAAG,GAAG,IAAI,WAAY,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,KAAK,WAC7F,KAAK,QAAQ,kBAAkB,GAAG;AACnD"}

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

@@ -0,0 +1,46 @@
+//#region src/features/composites/meta-display.ts
+/** The stored value of a meta field as editable text (`''` when unset). */
+function metaText(row, field) {
+	const value = row.meta[field.key];
+	return typeof value === "string" || typeof value === "number" ? String(value) : "";
+}
+/** Icon and color class of the known status values; unknown values read as neutral. */
+const STATUS_STYLE = {
+	open: {
+		icon: "i-lucide-circle",
+		color: "text-[var(--sk-muted)]"
+	},
+	doing: {
+		icon: "i-lucide-circle-dot",
+		color: "text-[var(--sk-info)]"
+	},
+	done: {
+		icon: "i-lucide-circle-check",
+		color: "text-[var(--sk-success)]"
+	}
+};
+const STATUS_UNSET = {
+	icon: "i-lucide-circle-dashed",
+	color: "text-[var(--sk-fg-dimmed)]"
+};
+const STATUS_OTHER = {
+	icon: "i-lucide-circle",
+	color: "text-[var(--sk-muted)]"
+};
+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");
+	if (!field) return null;
+	const value = metaText(row, field);
+	return {
+		field,
+		value,
+		label: field.options?.find((option) => option.value === value)?.label ?? (value || t("composites.status.none")),
+		...statusStyle(value)
+	};
+}
+//#endregion
+export { metaText, rowStatus, statusStyle };
+
+//# sourceMappingURL=meta-display.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-display.js","names":[],"sources":["../../../src/features/composites/meta-display.ts"],"sourcesContent":["import type { Translate } from '../../i18n'\nimport type { CompositeMetaField } from './kinds'\nimport type { CompositeRow } from './rows'\n\n/** The stored value of a meta field as editable text (`''` when unset). */\nexport function metaText(row: Pick<CompositeRow, 'meta'>, field: Pick<CompositeMetaField, 'key'>): string {\n  const value = row.meta[field.key]\n  return typeof value === 'string' || typeof value === 'number' ? String(value) : ''\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":";;AAKA,SAAgB,SAAS,KAAiC,OAAgD;CACxG,MAAM,QAAQ,IAAI,KAAK,MAAM;CAC7B,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AAClF;;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"}

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

@@ -0,0 +1,17 @@
+import { CompositeOptions, CompositeStorage } from "./nodes.js";
+import { NodeViewRenderer } from "@tiptap/core";
+//#region src/features/composites/node-views.d.ts
+/** The node view renderer a framework binding supplies for the composite block. */
+export interface CompositeNodeViews {
+  composite: NodeViewRenderer;
+}
+/**
+ * The composite node with the node view of a framework binding, and the tags row (data: hidden, `CompositeChrome`
+ * shows and edits it, so it needs no node view). Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
+ */
+export declare function compositeNodes(nodeViews: CompositeNodeViews): {
+  Composite: import("@tiptap/core").Node<CompositeOptions, CompositeStorage>;
+  CompositeTags: import("@tiptap/core").Node<any, any>;
+};
+//#endregion
+//# sourceMappingURL=node-views.d.ts.map

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

@@ -0,0 +1,18 @@
+import { CompositeNode, CompositeTagsNode } from "./nodes.js";
+//#region src/features/composites/node-views.ts
+/**
+* The composite node with the node view of a framework binding, and the tags row (data: hidden, `CompositeChrome`
+* shows and edits it, so it needs no node view). Configure the kinds with `Composite.configure({ kinds: [...defaultCompositeKinds(t), myKind] })`.
+*/
+function compositeNodes(nodeViews) {
+	return {
+		Composite: CompositeNode.extend({ addNodeView() {
+			return nodeViews.composite;
+		} }),
+		CompositeTags: CompositeTagsNode
+	};
+}
+//#endregion
+export { compositeNodes };
+
+//# sourceMappingURL=node-views.js.map

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

@@ -0,0 +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'\n\n/** The node view renderer a framework binding supplies for the composite block. */\nexport interface CompositeNodeViews {\n  composite: NodeViewRenderer\n}\n\n/**\n * The composite node with the node view of a framework binding, and the tags row (data: hidden, `CompositeChrome`\n * shows and edits it, so it needs no node view). 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  }\n}\n"],"mappings":";;;;;;AAYA,SAAgB,eAAe,WAA+B;CAC5D,OAAO;EAEL,WAAW,cAAc,OAAO,EAC9B,cAAgC;GAC9B,OAAO,UAAU;EACnB,EACF,CAAC;EACD,eAAe;CACjB;AACF"}

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

@@ -0,0 +1,56 @@
+import { HeadingConversionScope } from "../../settings/values.js";
+import "../../settings/index.js";
+import { CompositeKind } from "./kinds.js";
+import { Editor, JSONContent, Node } from "@tiptap/core";
+//#region src/features/composites/nodes.d.ts
+/** Options of the `composite` node: the kinds its `kind` attribute selects from. */
+export interface CompositeOptions {
+  kinds: readonly CompositeKind[];
+}
+/** Storage of the `composite` node: mirrors `options.kinds` for code that only has the editor. */
+export interface CompositeStorage {
+  kinds: readonly CompositeKind[];
+}
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    composite: {
+      /** Insert an empty composite of `kind` after the caret's block (replacing an empty paragraph; at the body start from the composite chrome), caret in its title. */
+      insertComposite: (kind?: string) => ReturnType;
+      /** Wrap the selected blocks into a new composite of `kind`, caret in its title. */
+      wrapInComposite: (kind?: string) => ReturnType;
+      /** Leave the caret's innermost composite: new paragraph right after it (a trailing empty body paragraph is moved there). */
+      exitComposite: () => ReturnType;
+      /** Group headings in the selected blocks (or, without a selection, in `scope`) into composites of `kind`; `recursive` nests every heading level. False when the range holds no heading. */
+      convertHeadingsToComposites: (options: {
+        recursive: boolean;
+        scope: HeadingConversionScope;
+        kind?: string;
+      }) => ReturnType;
+      /** Turn composites among the selected blocks (or, without a selection, in `scope`) into headings of their nesting level, with description, tags and meta as text lines; `recursive` flattens every level. False when the range holds no composite. */
+      convertCompositesToHeadings: (options: {
+        recursive: boolean;
+        scope: HeadingConversionScope;
+      }) => ReturnType;
+      /** Switch the composite at `pos` (default: the caret's innermost composite) to `kind`; `meta` keeps only the target kind's fields. */
+      setCompositeKind: (kind: string, pos?: number) => ReturnType;
+    };
+  }
+  interface Storage {
+    composite: 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
+ * language of its surface (the default language without one).
+ */
+export declare function compositeKindsOf(editor: Editor): readonly CompositeKind[];
+/** JSON of a fresh composite of `kind` (empty title/description/tags, hidden meta) with `body`. */
+export declare function compositeJSON(kind: string, body?: JSONContent[]): JSONContent;
+export declare const CompositeNode: Node<CompositeOptions, CompositeStorage>;
+export declare const CompositeTitleNode: Node<any, any>;
+export declare const CompositeDescriptionNode: Node<any, any>;
+export declare const CompositeTagsNode: Node<any, any>;
+//#endregion
+//# sourceMappingURL=nodes.d.ts.map