@ecsplico/editor 0.0.0-stage → 1.0.0

package/dist/features/composites/rows-model.js

@@ -0,0 +1,92 @@
+import { createStore } from "../../core/store.js";
+import { compositeKindsOf } from "./nodes.js";
+import { compositeRowAt, compositeRows } from "./rows.js";
+//#region src/features/composites/rows-model.ts
+const EMPTY = {
+	rows: [],
+	tags: [],
+	kinds: [],
+	mentions: [],
+	focused: null
+};
+function tagsOf(rows) {
+	return [...new Set(rows.flatMap((row) => row.tags))].sort((a, b) => a.localeCompare(b, "de"));
+}
+function kindCounts(rows, order) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const entry = counts.get(row.kind);
+		if (entry) entry.count++;
+		else counts.set(row.kind, {
+			id: row.kind,
+			label: row.kindLabel,
+			icon: row.icon,
+			count: 1
+		});
+	}
+	const rank = (id) => {
+		const index = order.indexOf(id);
+		return index < 0 ? order.length : index;
+	};
+	return [...counts.values()].sort((a, b) => rank(a.id) - rank(b.id));
+}
+/**
+* The composites of `editor`'s document as rows, kept current: re-read once per animation frame after a transaction
+* that changed the document (a selection-only change just moves `focused`). A missing or destroyed editor yields empty
+* lists. Create one model per editor (a framework hook follows an editor that changes). Use the `setComposite*` helpers
+* to write.
+*/
+function createCompositeRows(editor) {
+	const store = createStore(EMPTY);
+	if (!editor || editor.isDestroyed) return {
+		state: store,
+		dispose() {}
+	};
+	const kinds = compositeKindsOf(editor);
+	const order = kinds.map((kind) => kind.id);
+	let frame = 0;
+	let lastDoc;
+	let disposed = false;
+	const run = () => {
+		frame = 0;
+		if (disposed || editor.isDestroyed) return;
+		const { doc, selection } = editor.state;
+		const current = store.get();
+		if (doc !== lastDoc) {
+			lastDoc = doc;
+			const read = compositeRows(doc, kinds);
+			store.set({
+				rows: read.rows,
+				tags: tagsOf(read.rows),
+				kinds: kindCounts(read.rows, order),
+				mentions: read.mentions,
+				focused: compositeRowAt(read.rows, selection.head)
+			});
+			return;
+		}
+		const focused = compositeRowAt(current.rows, selection.head);
+		if (focused !== current.focused) store.set({
+			...current,
+			focused
+		});
+	};
+	const schedule = () => {
+		if (!frame) frame = requestAnimationFrame(run);
+	};
+	run();
+	editor.on("transaction", schedule);
+	return {
+		state: store,
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			editor.off("transaction", schedule);
+			if (frame) cancelAnimationFrame(frame);
+			frame = 0;
+		}
+	};
+}
+//#endregion
+export { createCompositeRows };
+
+//# sourceMappingURL=rows-model.js.map

package/dist/features/composites/rows-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows-model.js","names":[],"sources":["../../../src/features/composites/rows-model.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { createStore, type ReadonlyStore } from '../../core/store'\nimport { compositeKindsOf } from './nodes'\nimport { type CompositeMention, type CompositeRow, compositeRowAt, compositeRows } from './rows'\n\n/** A kind in use in the document, with how many composites have it. */\nexport interface CompositeKindCount {\n  id: string\n  label: string\n  icon: string\n  count: number\n}\n\n/** The live metadata read model of an editor's document (see `createCompositeRows`). */\nexport interface CompositeRowsState {\n  /** Every composite in document order. */\n  rows: readonly CompositeRow[]\n  /** Distinct tags of all composites, sorted (German collation). */\n  tags: readonly string[]\n  /** Kinds in use with their counts: configured kinds in their configured order, then unknown ones in order of appearance. */\n  kinds: readonly CompositeKindCount[]\n  /** Distinct `@mention` chips of the document. */\n  mentions: readonly CompositeMention[]\n  /** The innermost composite around the selection head, `null` outside of any. */\n  focused: CompositeRow | null\n}\n\n/** The composites of an editor's document as an observable state; `dispose()` detaches the editor listener (idempotent). */\nexport interface CompositeRowsHandle {\n  readonly state: ReadonlyStore<CompositeRowsState>\n  dispose: () => void\n}\n\nconst EMPTY: CompositeRowsState = { rows: [], tags: [], kinds: [], mentions: [], focused: null }\n\nfunction tagsOf(rows: readonly CompositeRow[]): string[] {\n  return [...new Set(rows.flatMap(row => row.tags))].sort((a, b) => a.localeCompare(b, 'de'))\n}\n\nfunction kindCounts(rows: readonly CompositeRow[], order: readonly string[]): CompositeKindCount[] {\n  const counts = new Map<string, CompositeKindCount>()\n  for (const row of rows) {\n    const entry = counts.get(row.kind)\n    if (entry) entry.count++\n    else counts.set(row.kind, { id: row.kind, label: row.kindLabel, icon: row.icon, count: 1 })\n  }\n  const rank = (id: string) => {\n    const index = order.indexOf(id)\n    return index < 0 ? order.length : index\n  }\n  // Array.sort is stable: unknown kinds (equal rank) keep their order of appearance.\n  return [...counts.values()].sort((a, b) => rank(a.id) - rank(b.id))\n}\n\n/**\n * The composites of `editor`'s document as rows, kept current: re-read once per animation frame after a transaction\n * that changed the document (a selection-only change just moves `focused`). A missing or destroyed editor yields empty\n * lists. Create one model per editor (a framework hook follows an editor that changes). Use the `setComposite*` helpers\n * to write.\n */\nexport function createCompositeRows(editor: Editor | undefined): CompositeRowsHandle {\n  const store = createStore<CompositeRowsState>(EMPTY)\n  if (!editor || editor.isDestroyed) return { state: store, dispose() {} }\n\n  const kinds = compositeKindsOf(editor)\n  const order = kinds.map(kind => kind.id)\n  let frame = 0\n  let lastDoc: PMNode | undefined\n  let disposed = false\n\n  const run = () => {\n    frame = 0\n    if (disposed || editor.isDestroyed) return\n    const { doc, selection } = editor.state\n    const current = store.get()\n    if (doc !== lastDoc) {\n      lastDoc = doc\n      const read = compositeRows(doc, kinds)\n      store.set({\n        rows: read.rows,\n        tags: tagsOf(read.rows),\n        kinds: kindCounts(read.rows, order),\n        mentions: read.mentions,\n        focused: compositeRowAt(read.rows, selection.head),\n      })\n      return\n    }\n    const focused = compositeRowAt(current.rows, selection.head)\n    if (focused !== current.focused) store.set({ ...current, focused })\n  }\n  const schedule = () => {\n    if (!frame) frame = requestAnimationFrame(run)\n  }\n\n  run()\n  editor.on('transaction', schedule)\n\n  return {\n    state: store,\n    dispose() {\n      if (disposed) return\n      disposed = true\n      editor.off('transaction', schedule)\n      if (frame) cancelAnimationFrame(frame)\n      frame = 0\n    },\n  }\n}\n"],"mappings":";;;;AAkCA,MAAM,QAA4B;CAAE,MAAM,CAAC;CAAG,MAAM,CAAC;CAAG,OAAO,CAAC;CAAG,UAAU,CAAC;CAAG,SAAS;AAAK;AAE/F,SAAS,OAAO,MAAyC;CACvD,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,SAAQ,QAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;AAC5F;AAEA,SAAS,WAAW,MAA+B,OAAgD;CACjG,MAAM,yBAAS,IAAI,IAAgC;CACnD,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,OAAO,IAAI,IAAI,IAAI;EACjC,IAAI,OAAO,MAAM;OACZ,OAAO,IAAI,IAAI,MAAM;GAAE,IAAI,IAAI;GAAM,OAAO,IAAI;GAAW,MAAM,IAAI;GAAM,OAAO;EAAE,CAAC;CAC5F;CACA,MAAM,QAAQ,OAAe;EAC3B,MAAM,QAAQ,MAAM,QAAQ,EAAE;EAC9B,OAAO,QAAQ,IAAI,MAAM,SAAS;CACpC;CAEA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,KAAK,EAAE,EAAE,IAAI,KAAK,EAAE,EAAE,CAAC;AACpE;;;;;;;AAQA,SAAgB,oBAAoB,QAAiD;CACnF,MAAM,QAAQ,YAAgC,KAAK;CACnD,IAAI,CAAC,UAAU,OAAO,aAAa,OAAO;EAAE,OAAO;EAAO,UAAU,CAAC;CAAE;CAEvE,MAAM,QAAQ,iBAAiB,MAAM;CACrC,MAAM,QAAQ,MAAM,KAAI,SAAQ,KAAK,EAAE;CACvC,IAAI,QAAQ;CACZ,IAAI;CACJ,IAAI,WAAW;CAEf,MAAM,YAAY;EAChB,QAAQ;EACR,IAAI,YAAY,OAAO,aAAa;EACpC,MAAM,EAAE,KAAK,cAAc,OAAO;EAClC,MAAM,UAAU,MAAM,IAAI;EAC1B,IAAI,QAAQ,SAAS;GACnB,UAAU;GACV,MAAM,OAAO,cAAc,KAAK,KAAK;GACrC,MAAM,IAAI;IACR,MAAM,KAAK;IACX,MAAM,OAAO,KAAK,IAAI;IACtB,OAAO,WAAW,KAAK,MAAM,KAAK;IAClC,UAAU,KAAK;IACf,SAAS,eAAe,KAAK,MAAM,UAAU,IAAI;GACnD,CAAC;GACD;EACF;EACA,MAAM,UAAU,eAAe,QAAQ,MAAM,UAAU,IAAI;EAC3D,IAAI,YAAY,QAAQ,SAAS,MAAM,IAAI;GAAE,GAAG;GAAS;EAAQ,CAAC;CACpE;CACA,MAAM,iBAAiB;EACrB,IAAI,CAAC,OAAO,QAAQ,sBAAsB,GAAG;CAC/C;CAEA,IAAI;CACJ,OAAO,GAAG,eAAe,QAAQ;CAEjC,OAAO;EACL,OAAO;EACP,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,OAAO,IAAI,eAAe,QAAQ;GAClC,IAAI,OAAO,qBAAqB,KAAK;GACrC,QAAQ;EACV;CACF;AACF"}

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

@@ -0,0 +1,76 @@
+import { CompositeKind, CompositeMetaField } from "./kinds.js";
+import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/features/composites/rows.d.ts
+/** One composite („Baustein“) of a document with its metadata, flattened in document order. */
+export interface CompositeRow {
+  /** Block ID, or `pos:<pos>` for a composite without one yet; unique within the document. */
+  key: string;
+  id: string | null;
+  /** Position of the composite when the row was read; the write helpers re-resolve it, so a stale value is safe. */
+  pos: number;
+  /** Position right after the composite, as of when the row was read. */
+  end: number;
+  kind: string;
+  kindLabel: string;
+  icon: string;
+  /** Title text, empty for an untitled composite. */
+  title: string;
+  /** Text of the description (summary), empty when there is none. */
+  description: string;
+  /**
+   * The description holds text only (marks such as bold, author or comment allowed, no mentions or tags); only then
+   * can `setCompositeDescription` write it without losing inline content.
+   */
+  descriptionTextOnly: boolean;
+  tags: string[];
+  meta: Record<string, unknown>;
+  /** The meta fields of the composite's kind. */
+  fields: readonly CompositeMetaField[];
+  /** Nesting level among composites, 0 = outermost. */
+  depth: number;
+}
+/** A distinct `@mention` chip of a document. */
+export interface CompositeMention {
+  id: string;
+  label: string;
+  color: string | null;
+}
+/**
+ * Reads every composite of `doc` (also inside quotes and lists) as a row, in document order, and the distinct
+ * `@mention` chips anywhere in the document. Unknown kinds get the `section` kind's presentation under their own ID.
+ */
+export declare function compositeRows(doc: Node$1, kinds: readonly CompositeKind[]): {
+  rows: CompositeRow[];
+  mentions: CompositeMention[];
+};
+/** The innermost row around document position `pos`, `null` outside of any composite. */
+export declare function compositeRowAt(rows: readonly CompositeRow[], pos: number): CompositeRow | null;
+/**
+ * The composite `row` stands for in `doc`: by block ID, else (the row has no ID yet) by its position.
+ * Positions are re-resolved on every call, so a stale `row.pos` is safe for rows with an ID.
+ */
+export declare function compositeOfRow(doc: Node$1, row: Pick<CompositeRow, 'id' | 'pos'>): {
+  pos: number;
+  node: Node$1;
+} | null;
+/**
+ * `meta` with `value` stored under `field.key`: a number field converts a numeric string, an empty value (`''`,
+ * `null`, `undefined`, `NaN`) removes the key. Returns a new object; `meta` is not changed.
+ */
+export declare function compositeMetaWith(meta: Record<string, unknown>, field: Pick<CompositeMetaField, 'key' | 'type'>, value: unknown): Record<string, unknown>;
+/** Stores `value` under the meta field `key` of the row's composite (see `compositeMetaWith`), in one transaction. */
+export declare function setCompositeMetaField(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos' | 'fields'>, key: string, value: unknown): boolean;
+/** Replaces the tags row of the row's composite (empty names are dropped), in one transaction. */
+export declare function setCompositeTags(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, tags: readonly string[]): boolean;
+/** The text `setCompositeDescription` stores for `text`: the description is one line, so line breaks collapse to spaces. */
+export declare function compositeDescriptionText(text: string): string;
+/**
+ * Sets the text of the row's composite description to `compositeDescriptionText(text)`; an empty text empties it.
+ * Only the changed span is replaced, so marks on the unchanged text (bold, author, comment) stay. Refuses (`false`)
+ * when the description holds a mention or tag (it would be lost), and, when `expected` is given, when the
+ * description no longer holds that text (a peer changed it since the caller read it; writing would drop that change).
+ */
+export declare function setCompositeDescription(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, text: string, expected?: string): boolean;
+//#endregion
+//# sourceMappingURL=rows.d.ts.map

package/dist/features/composites/rows.js

@@ -0,0 +1,159 @@
+import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
+import { compositeKind } from "./kinds.js";
+//#region src/features/composites/rows.ts
+const COMPOSITE = "composite";
+/** True when `node`'s content is empty or text only (with any marks, but no inline nodes such as mentions or tags). */
+function isTextOnly(node) {
+	let textOnly = true;
+	node.forEach((child) => {
+		if (!child.isText) textOnly = false;
+	});
+	return textOnly;
+}
+/**
+* Reads every composite of `doc` (also inside quotes and lists) as a row, in document order, and the distinct
+* `@mention` chips anywhere in the document. Unknown kinds get the `section` kind's presentation under their own ID.
+*/
+function compositeRows(doc, kinds) {
+	const rows = [];
+	const mentions = /* @__PURE__ */ new Map();
+	function walk(parent, start, depth) {
+		parent.forEach((node, offset) => {
+			const pos = start + offset;
+			if (node.type.name === COMPOSITE) {
+				const kind = compositeKind(kinds, String(node.attrs.kind));
+				const id = blockIdOf(node);
+				const tags = node.maybeChild(2)?.attrs.tags;
+				const description = node.maybeChild(1);
+				rows.push({
+					key: id ?? `pos:${pos}`,
+					id,
+					pos,
+					end: pos + node.nodeSize,
+					kind: kind.id,
+					kindLabel: kind.label,
+					icon: kind.icon,
+					title: node.firstChild?.textContent.trim() ?? "",
+					description: description?.textContent ?? "",
+					descriptionTextOnly: description ? isTextOnly(description) : true,
+					tags: Array.isArray(tags) ? tags.filter((tag) => typeof tag === "string") : [],
+					meta: node.attrs.meta ?? {},
+					fields: kind.fields,
+					depth
+				});
+				walk(node, pos + 1, depth + 1);
+			} else if (node.type.name === "mention") {
+				const mentionId = String(node.attrs.id ?? "");
+				if (mentionId && !mentions.has(mentionId)) mentions.set(mentionId, {
+					id: mentionId,
+					label: String(node.attrs.label ?? mentionId),
+					color: typeof node.attrs.color === "string" ? node.attrs.color : null
+				});
+			} else if (!node.isLeaf) walk(node, pos + 1, depth);
+		});
+	}
+	walk(doc, 0, 0);
+	return {
+		rows,
+		mentions: [...mentions.values()]
+	};
+}
+/** The innermost row around document position `pos`, `null` outside of any composite. */
+function compositeRowAt(rows, pos) {
+	let found = null;
+	for (const row of rows) if (row.pos <= pos && pos < row.end) found = row;
+	return found;
+}
+/**
+* The composite `row` stands for in `doc`: by block ID, else (the row has no ID yet) by its position.
+* Positions are re-resolved on every call, so a stale `row.pos` is safe for rows with an ID.
+*/
+function compositeOfRow(doc, row) {
+	if (row.id) {
+		const found = findBlockById(doc, row.id);
+		return found?.node.type.name === COMPOSITE ? found : null;
+	}
+	const node = doc.nodeAt(row.pos);
+	return node?.type.name === COMPOSITE ? {
+		pos: row.pos,
+		node
+	} : null;
+}
+/**
+* `meta` with `value` stored under `field.key`: a number field converts a numeric string, an empty value (`''`,
+* `null`, `undefined`, `NaN`) removes the key. Returns a new object; `meta` is not changed.
+*/
+function compositeMetaWith(meta, field, value) {
+	const next = { ...meta };
+	const stored = field.type === "number" && typeof value === "string" && value !== "" ? Number(value) : value;
+	if (stored === "" || stored === null || stored === void 0 || Number.isNaN(stored)) delete next[field.key];
+	else next[field.key] = stored;
+	return next;
+}
+/** Stores `value` under the meta field `key` of the row's composite (see `compositeMetaWith`), in one transaction. */
+function setCompositeMetaField(editor, row, key, value) {
+	const field = row.fields.find((candidate) => candidate.key === key) ?? {
+		key,
+		type: "text"
+	};
+	return editor.commands.command(({ tr }) => {
+		const found = compositeOfRow(tr.doc, row);
+		if (!found) return false;
+		tr.setNodeMarkup(found.pos, void 0, {
+			...found.node.attrs,
+			meta: compositeMetaWith(found.node.attrs.meta ?? {}, field, value)
+		});
+		return true;
+	});
+}
+/** Replaces the tags row of the row's composite (empty names are dropped), in one transaction. */
+function setCompositeTags(editor, row, tags) {
+	return editor.commands.command(({ tr }) => {
+		const found = compositeOfRow(tr.doc, row);
+		const title = found?.node.maybeChild(0);
+		const description = found?.node.maybeChild(1);
+		const tagsNode = found?.node.maybeChild(2);
+		if (!found || !title || !description || tagsNode?.type.name !== "compositeTags") return false;
+		const tagsPos = found.pos + 1 + title.nodeSize + description.nodeSize;
+		tr.setNodeMarkup(tagsPos, void 0, {
+			...tagsNode.attrs,
+			tags: tags.filter((tag) => tag)
+		});
+		return true;
+	});
+}
+/** The text `setCompositeDescription` stores for `text`: the description is one line, so line breaks collapse to spaces. */
+function compositeDescriptionText(text) {
+	return text.replace(/\s*\n\s*/g, " ").trim();
+}
+/**
+* Sets the text of the row's composite description to `compositeDescriptionText(text)`; an empty text empties it.
+* Only the changed span is replaced, so marks on the unchanged text (bold, author, comment) stay. Refuses (`false`)
+* when the description holds a mention or tag (it would be lost), and, when `expected` is given, when the
+* description no longer holds that text (a peer changed it since the caller read it; writing would drop that change).
+*/
+function setCompositeDescription(editor, row, text, expected) {
+	const value = compositeDescriptionText(text);
+	return editor.commands.command(({ tr }) => {
+		const found = compositeOfRow(tr.doc, row);
+		const title = found?.node.maybeChild(0);
+		const description = found?.node.maybeChild(1);
+		if (!found || !title || !description || description.type.name !== "compositeDescription") return false;
+		if (!isTextOnly(description)) return false;
+		const current = description.textContent;
+		if (expected !== void 0 && current !== expected) return false;
+		if (current === value) return true;
+		let prefix = 0;
+		const max = Math.min(current.length, value.length);
+		while (prefix < max && current[prefix] === value[prefix]) prefix++;
+		let suffix = 0;
+		while (suffix < max - prefix && current[current.length - 1 - suffix] === value[value.length - 1 - suffix]) suffix++;
+		const start = found.pos + 1 + title.nodeSize + 1;
+		tr.insertText(value.slice(prefix, value.length - suffix), start + prefix, start + current.length - suffix);
+		return true;
+	});
+}
+//#endregion
+export { compositeDescriptionText, compositeMetaWith, compositeOfRow, compositeRowAt, compositeRows, setCompositeDescription, setCompositeMetaField, setCompositeTags };
+
+//# sourceMappingURL=rows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","names":[],"sources":["../../../src/features/composites/rows.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { blockIdOf, findBlockById } from '../../core/schema'\nimport { type CompositeKind, type CompositeMetaField, compositeKind } from './kinds'\n\n/** One composite („Baustein“) of a document with its metadata, flattened in document order. */\nexport interface CompositeRow {\n  /** Block ID, or `pos:<pos>` for a composite without one yet; unique within the document. */\n  key: string\n  id: string | null\n  /** Position of the composite when the row was read; the write helpers re-resolve it, so a stale value is safe. */\n  pos: number\n  /** Position right after the composite, as of when the row was read. */\n  end: number\n  kind: string\n  kindLabel: string\n  icon: string\n  /** Title text, empty for an untitled composite. */\n  title: string\n  /** Text of the description (summary), empty when there is none. */\n  description: string\n  /**\n   * The description holds text only (marks such as bold, author or comment allowed, no mentions or tags); only then\n   * can `setCompositeDescription` write it without losing inline content.\n   */\n  descriptionTextOnly: boolean\n  tags: string[]\n  meta: Record<string, unknown>\n  /** The meta fields of the composite's kind. */\n  fields: readonly CompositeMetaField[]\n  /** Nesting level among composites, 0 = outermost. */\n  depth: number\n}\n\n/** A distinct `@mention` chip of a document. */\nexport interface CompositeMention {\n  id: string\n  label: string\n  color: string | null\n}\n\nconst COMPOSITE = 'composite'\n\n/** True when `node`'s content is empty or text only (with any marks, but no inline nodes such as mentions or tags). */\nfunction isTextOnly(node: PMNode): boolean {\n  let textOnly = true\n  node.forEach((child) => {\n    if (!child.isText) textOnly = false\n  })\n  return textOnly\n}\n\n/**\n * Reads every composite of `doc` (also inside quotes and lists) as a row, in document order, and the distinct\n * `@mention` chips anywhere in the document. Unknown kinds get the `section` kind's presentation under their own ID.\n */\nexport function compositeRows(doc: PMNode, kinds: readonly CompositeKind[]): { rows: CompositeRow[], mentions: CompositeMention[] } {\n  const rows: CompositeRow[] = []\n  const mentions = new Map<string, CompositeMention>()\n\n  function walk(parent: PMNode, start: number, depth: number) {\n    parent.forEach((node, offset) => {\n      const pos = start + offset\n      if (node.type.name === COMPOSITE) {\n        const kind = compositeKind(kinds, String(node.attrs.kind))\n        const id = blockIdOf(node)\n        const tags: unknown = node.maybeChild(2)?.attrs.tags\n        const description = node.maybeChild(1)\n        rows.push({\n          key: id ?? `pos:${pos}`,\n          id,\n          pos,\n          end: pos + node.nodeSize,\n          kind: kind.id,\n          kindLabel: kind.label,\n          icon: kind.icon,\n          title: node.firstChild?.textContent.trim() ?? '',\n          description: description?.textContent ?? '',\n          descriptionTextOnly: description ? isTextOnly(description) : true,\n          tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [],\n          meta: (node.attrs.meta ?? {}) as Record<string, unknown>,\n          fields: kind.fields,\n          depth,\n        })\n        walk(node, pos + 1, depth + 1)\n      }\n      else if (node.type.name === 'mention') {\n        const mentionId = String(node.attrs.id ?? '')\n        if (mentionId && !mentions.has(mentionId)) {\n          mentions.set(mentionId, {\n            id: mentionId,\n            label: String(node.attrs.label ?? mentionId),\n            color: typeof node.attrs.color === 'string' ? node.attrs.color : null,\n          })\n        }\n      }\n      else if (!node.isLeaf) {\n        walk(node, pos + 1, depth)\n      }\n    })\n  }\n  walk(doc, 0, 0)\n  return { rows, mentions: [...mentions.values()] }\n}\n\n/** The innermost row around document position `pos`, `null` outside of any composite. */\nexport function compositeRowAt(rows: readonly CompositeRow[], pos: number): CompositeRow | null {\n  let found: CompositeRow | null = null\n  // Pre-order: the last match is the innermost composite.\n  for (const row of rows) {\n    if (row.pos <= pos && pos < row.end) found = row\n  }\n  return found\n}\n\n/**\n * The composite `row` stands for in `doc`: by block ID, else (the row has no ID yet) by its position.\n * Positions are re-resolved on every call, so a stale `row.pos` is safe for rows with an ID.\n */\nexport function compositeOfRow(doc: PMNode, row: Pick<CompositeRow, 'id' | 'pos'>): { pos: number, node: PMNode } | null {\n  if (row.id) {\n    const found = findBlockById(doc, row.id)\n    return found?.node.type.name === COMPOSITE ? found : null\n  }\n  const node = doc.nodeAt(row.pos)\n  return node?.type.name === COMPOSITE ? { pos: row.pos, node } : null\n}\n\n/**\n * `meta` with `value` stored under `field.key`: a number field converts a numeric string, an empty value (`''`,\n * `null`, `undefined`, `NaN`) removes the key. Returns a new object; `meta` is not changed.\n */\nexport function compositeMetaWith(meta: Record<string, unknown>, field: Pick<CompositeMetaField, 'key' | 'type'>, value: unknown): Record<string, unknown> {\n  const next = { ...meta }\n  const stored = field.type === 'number' && typeof value === 'string' && value !== '' ? Number(value) : value\n  if (stored === '' || stored === null || stored === undefined || Number.isNaN(stored)) delete next[field.key]\n  else next[field.key] = stored\n  return next\n}\n\n/** Stores `value` under the meta field `key` of the row's composite (see `compositeMetaWith`), in one transaction. */\nexport function setCompositeMetaField(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos' | 'fields'>, key: string, value: unknown): boolean {\n  const field = row.fields.find(candidate => candidate.key === key) ?? { key, type: 'text' as const }\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    if (!found) return false\n    tr.setNodeMarkup(found.pos, undefined, { ...found.node.attrs, meta: compositeMetaWith(found.node.attrs.meta ?? {}, field, value) })\n    return true\n  })\n}\n\n/** Replaces the tags row of the row's composite (empty names are dropped), in one transaction. */\nexport function setCompositeTags(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, tags: readonly string[]): boolean {\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    const title = found?.node.maybeChild(0)\n    const description = found?.node.maybeChild(1)\n    const tagsNode = found?.node.maybeChild(2)\n    if (!found || !title || !description || tagsNode?.type.name !== 'compositeTags') return false\n    const tagsPos = found.pos + 1 + title.nodeSize + description.nodeSize\n    tr.setNodeMarkup(tagsPos, undefined, { ...tagsNode.attrs, tags: tags.filter(tag => tag) })\n    return true\n  })\n}\n\n/** The text `setCompositeDescription` stores for `text`: the description is one line, so line breaks collapse to spaces. */\nexport function compositeDescriptionText(text: string): string {\n  return text.replace(/\\s*\\n\\s*/g, ' ').trim()\n}\n\n/**\n * Sets the text of the row's composite description to `compositeDescriptionText(text)`; an empty text empties it.\n * Only the changed span is replaced, so marks on the unchanged text (bold, author, comment) stay. Refuses (`false`)\n * when the description holds a mention or tag (it would be lost), and, when `expected` is given, when the\n * description no longer holds that text (a peer changed it since the caller read it; writing would drop that change).\n */\nexport function setCompositeDescription(editor: Editor, row: Pick<CompositeRow, 'id' | 'pos'>, text: string, expected?: string): boolean {\n  const value = compositeDescriptionText(text)\n  return editor.commands.command(({ tr }) => {\n    const found = compositeOfRow(tr.doc, row)\n    const title = found?.node.maybeChild(0)\n    const description = found?.node.maybeChild(1)\n    if (!found || !title || !description || description.type.name !== 'compositeDescription') return false\n    if (!isTextOnly(description)) return false\n    const current = description.textContent\n    if (expected !== undefined && current !== expected) return false\n    if (current === value) return true\n    // Text only: every character is one position. Keep the common prefix and suffix, replace what lies between.\n    let prefix = 0\n    const max = Math.min(current.length, value.length)\n    while (prefix < max && current[prefix] === value[prefix]) prefix++\n    let suffix = 0\n    while (suffix < max - prefix && current[current.length - 1 - suffix] === value[value.length - 1 - suffix]) suffix++\n    const start = found.pos + 1 + title.nodeSize + 1\n    // `insertText` with an empty text deletes the range; inserted text takes the marks at its start, as typing does.\n    tr.insertText(value.slice(prefix, value.length - suffix), start + prefix, start + current.length - suffix)\n    return true\n  })\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,21 @@
+import { CompositeAiBrief, compositeAiBrief } from "./ai-brief.js";
+import { CompositeKind, CompositeKindAi, CompositeMetaField, compositeKind, defaultCompositeKinds } from "./kinds.js";
+import { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeOptions, CompositeStorage, CompositeTagsNode, CompositeTitleNode, compositeJSON, compositeKindsOf } from "./nodes.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 { AnyExtension } from "@tiptap/core";
+//#region src/features/composites/schema.d.ts
+/**
+ * The schema-bearing composite family (composite, title, description, tags) without node views, to append to
+ * `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`
+ * is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.
+ */
+export declare function compositeSchemaExtensions(options?: {
+  kinds?: readonly CompositeKind[];
+}): AnyExtension[];
+//#endregion
+export { COMPOSITE_CHROME_COUNT, type CompositeAiBrief, CompositeDescriptionNode, type CompositeFence, type CompositeKind, type CompositeKindAi, type CompositeMetaField, CompositeNode, type CompositeOptions, type CompositeStorage, CompositeTagsNode, CompositeTitleNode, type FenceSegment, LEGACY_COMPOSITE_NODE, blocksFromMarkdown, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, convertCompositeBlocks, defaultCompositeKinds, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, migrateLegacyContent, splitCompositeFences, structureBlocks };
+//# sourceMappingURL=schema.d.ts.map

package/dist/features/composites/schema.js

@@ -0,0 +1,26 @@
+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 { compositeConversions, convertCompositeBlocks } from "./convert.js";
+import { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from "./legacy.js";
+//#region src/features/composites/schema.ts
+/**
+* The schema-bearing composite family (composite, title, description, tags) without node views, to append to
+* `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`
+* is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.
+*/
+function compositeSchemaExtensions(options = {}) {
+	return [
+		CompositeNode.configure(options.kinds ? { kinds: options.kinds } : {}),
+		CompositeTitleNode,
+		CompositeDescriptionNode,
+		CompositeTagsNode
+	];
+}
+//#endregion
+export { COMPOSITE_CHROME_COUNT, CompositeDescriptionNode, CompositeNode, CompositeTagsNode, CompositeTitleNode, LEGACY_COMPOSITE_NODE, blocksFromMarkdown, compositeAiBrief, compositeChromeBlocks, compositeConversions, compositeFence, compositeFromMarkdown, compositeJSON, compositeKind, compositeKindsOf, compositeSchemaExtensions, convertCompositeBlocks, defaultCompositeKinds, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, migrateLegacyContent, splitCompositeFences, structureBlocks };
+
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/composites/schema.ts"],"sourcesContent":["// Vue-free entry of the composite feature (`@ecsplico/editor/composites/schema`): the node family, kinds, Markdown\n// fences, legacy migration, heading↔composite transforms and conversions. Servers build their schema from it; it never\n// imports node views, components or the feature factory.\nimport type { AnyExtension } from '@tiptap/core'\nimport { type CompositeKind } from './kinds'\nimport { CompositeNode, CompositeDescriptionNode, CompositeTagsNode, CompositeTitleNode } from './nodes'\n\nexport { type CompositeAiBrief, compositeAiBrief } from './ai-brief'\nexport { compositeConversions, convertCompositeBlocks } from './convert'\nexport { blocksFromMarkdown, type CompositeFence, compositeFence, compositeFromMarkdown, type FenceSegment, splitCompositeFences } from './fences'\nexport { compositeChromeBlocks, flattenCompositesToHeadings, groupHeadingsIntoComposites, headingGroupRange, structureBlocks } from './heading-composites'\nexport { type CompositeKind, type CompositeKindAi, type CompositeMetaField, compositeKind, defaultCompositeKinds } from './kinds'\nexport { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from './legacy'\nexport {\n  COMPOSITE_CHROME_COUNT,\n  compositeJSON,\n  compositeKindsOf,\n  CompositeDescriptionNode,\n  CompositeNode,\n  type CompositeOptions,\n  type CompositeStorage,\n  CompositeTagsNode,\n  CompositeTitleNode,\n} from './nodes'\n\n/**\n * The schema-bearing composite family (composite, title, description, tags) without node views, to append to\n * `coreSchemaExtensions()`: `getSchema([...coreSchemaExtensions(), ...compositeSchemaExtensions({ kinds })])`. `kinds`\n * is the host's kind list (default: the built-in kinds in German, `defaultCompositeKinds`); it is storage, not schema.\n */\nexport function compositeSchemaExtensions(options: { kinds?: readonly CompositeKind[] } = {}): AnyExtension[] {\n  return [CompositeNode.configure(options.kinds ? { kinds: options.kinds } : {}), CompositeTitleNode, CompositeDescriptionNode, CompositeTagsNode]\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,SAAgB,0BAA0B,UAAgD,CAAC,GAAmB;CAC5G,OAAO;EAAC,cAAc,UAAU,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC,CAAC;EAAG;EAAoB;EAA0B;CAAiB;AACjJ"}

package/dist/features/composites/structure-mode.d.ts

@@ -0,0 +1,11 @@
+import { MessageKey } from "../../i18n/index.js";
+import { StructureMode } from "../../settings/values.js";
+import "../../settings/index.js";
+//#region src/features/composites/structure-mode.d.ts
+/** Message keys of the labels of the settings radio and the toolbar's „Gliederung“ dropdown; resolve them with `t`. */
+export declare const STRUCTURE_MODE_KEYS: Record<StructureMode, {
+  labelKey: MessageKey;
+  descriptionKey: MessageKey;
+}>;
+//#endregion
+//# sourceMappingURL=structure-mode.d.ts.map

package/dist/features/composites/structure-mode.js

@@ -0,0 +1,16 @@
+//#region src/features/composites/structure-mode.ts
+/** Message keys of the labels of the settings radio and the toolbar's „Gliederung“ dropdown; resolve them with `t`. */
+const STRUCTURE_MODE_KEYS = {
+	flat: {
+		labelKey: "composites.settings.structure.flat.label",
+		descriptionKey: "composites.settings.structure.flat.description"
+	},
+	composite: {
+		labelKey: "composites.settings.structure.composite.label",
+		descriptionKey: "composites.settings.structure.composite.description"
+	}
+};
+//#endregion
+export { STRUCTURE_MODE_KEYS };
+
+//# sourceMappingURL=structure-mode.js.map

package/dist/features/composites/structure-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-mode.js","names":[],"sources":["../../../src/features/composites/structure-mode.ts"],"sourcesContent":["import type { MessageKey } from '../../i18n'\nimport type { StructureMode } from '../../settings'\n\n/** Message keys of the labels of the settings radio and the toolbar's „Gliederung“ dropdown; resolve them with `t`. */\nexport const STRUCTURE_MODE_KEYS: Record<StructureMode, { labelKey: MessageKey, descriptionKey: MessageKey }> = {\n  flat: { labelKey: 'composites.settings.structure.flat.label', descriptionKey: 'composites.settings.structure.flat.description' },\n  composite: { labelKey: 'composites.settings.structure.composite.label', descriptionKey: 'composites.settings.structure.composite.description' },\n}\n"],"mappings":";;AAIA,MAAa,sBAAmG;CAC9G,MAAM;EAAE,UAAU;EAA4C,gBAAgB;CAAiD;CAC/H,WAAW;EAAE,UAAU;EAAiD,gBAAgB;CAAsD;AAChJ"}

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

@@ -0,0 +1,19 @@
+import { StructureMode } from "../../settings/values.js";
+import "../../settings/index.js";
+import { Editor, Extension } from "@tiptap/core";
+//#region src/features/composites/structure.d.ts
+/** `mode` is read on every use, so a changed setting applies without recreating the editor. */
+export interface StructureStorage {
+  mode: () => StructureMode;
+}
+declare module '@tiptap/core' {
+  interface Storage {
+    structure: StructureStorage;
+  }
+}
+/** Client-only, no schema: the user's preferred structure (settings `blocks.structure`) for the AI apply paths; the composites feature configures it from `useEditorSettings`. */
+export declare const Structure: Extension<StructureStorage, StructureStorage>;
+/** The structure `editor` prefers for new content (the default when it has no `Structure` extension). */
+export declare function structureOf(editor: Editor): StructureMode;
+//#endregion
+//# sourceMappingURL=structure.d.ts.map

package/dist/features/composites/structure.js

@@ -0,0 +1,19 @@
+import { EDITOR_SETTINGS_DEFAULTS } from "../../settings/index.js";
+import { Extension } from "@tiptap/core";
+//#region src/features/composites/structure.ts
+/** Client-only, no schema: the user's preferred structure (settings `blocks.structure`) for the AI apply paths; the composites feature configures it from `useEditorSettings`. */
+const Structure = Extension.create({
+	name: "structure",
+	addOptions: () => ({ mode: () => EDITOR_SETTINGS_DEFAULTS.blocks.structure }),
+	addStorage() {
+		return { mode: this.options.mode };
+	}
+});
+/** The structure `editor` prefers for new content (the default when it has no `Structure` extension). */
+function structureOf(editor) {
+	return editor.storage.structure?.mode() ?? EDITOR_SETTINGS_DEFAULTS.blocks.structure;
+}
+//#endregion
+export { Structure, structureOf };
+
+//# sourceMappingURL=structure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","names":[],"sources":["../../../src/features/composites/structure.ts"],"sourcesContent":["import { type Editor, Extension } from '@tiptap/core'\nimport { EDITOR_SETTINGS_DEFAULTS, type StructureMode } from '../../settings'\n\n/** `mode` is read on every use, so a changed setting applies without recreating the editor. */\nexport interface StructureStorage { mode: () => StructureMode }\n\ndeclare module '@tiptap/core' {\n  interface Storage { structure: StructureStorage }\n}\n\n/** Client-only, no schema: the user's preferred structure (settings `blocks.structure`) for the AI apply paths; the composites feature configures it from `useEditorSettings`. */\nexport const Structure = Extension.create<StructureStorage, StructureStorage>({\n  name: 'structure',\n  addOptions: () => ({ mode: () => EDITOR_SETTINGS_DEFAULTS.blocks.structure }),\n  addStorage() {\n    return { mode: this.options.mode }\n  },\n})\n\n/** The structure `editor` prefers for new content (the default when it has no `Structure` extension). */\nexport function structureOf(editor: Editor): StructureMode {\n  return editor.storage.structure?.mode() ?? EDITOR_SETTINGS_DEFAULTS.blocks.structure\n}\n"],"mappings":";;;;AAWA,MAAa,YAAY,UAAU,OAA2C;CAC5E,MAAM;CACN,mBAAmB,EAAE,YAAY,yBAAyB,OAAO,UAAU;CAC3E,aAAa;EACX,OAAO,EAAE,MAAM,KAAK,QAAQ,KAAK;CACnC;AACF,CAAC;;AAGD,SAAgB,YAAY,QAA+B;CACzD,OAAO,OAAO,QAAQ,WAAW,KAAK,KAAK,yBAAyB,OAAO;AAC7E"}

package/dist/features/composites/table-model.js

@@ -0,0 +1,117 @@
+//#region src/features/composites/table-model.ts
+/** Id prefix of the columns derived from meta fields. */
+const FIELD_PREFIX = "meta:";
+/** The "no filter" value of a field's select filter. */
+const FILTER_ALL = "__all__";
+const isEmpty = (value) => value === void 0 || value === null || value === "";
+const finiteNumber = (value) => {
+	if (isEmpty(value)) return null;
+	const number = Number(value);
+	return Number.isFinite(number) ? number : null;
+};
+const numberFormat = new Intl.NumberFormat("de-DE");
+const dateFormat = new Intl.DateTimeFormat("de-DE", {
+	day: "2-digit",
+	month: "2-digit",
+	year: "numeric"
+});
+/** German, numeric-aware ordering of two sort keys' text. */
+const collator = new Intl.Collator("de", { numeric: true });
+/** The field of `row`'s kind with key `key`. */
+const fieldOf = (row, key) => row.fields.find((field) => field.key === key);
+/** `2026-05-01` → `01.05.2026`; parsed by hand because `new Date('2026-05-01')` is UTC and can show the previous day. */
+function formatDate(value) {
+	const match = /^(\d{4})-(\d{2})-(\d{2})/.exec(value);
+	const date = match ? new Date(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : new Date(value);
+	return Number.isNaN(date.getTime()) ? value : dateFormat.format(date);
+}
+/** The cell text of `row`'s field `key`; empty when the value is unset or the row's kind does not have the field. */
+function fieldText(row, key) {
+	const field = fieldOf(row, key);
+	const value = row.meta[key];
+	if (!field || isEmpty(value)) return "";
+	if (field.type === "select") return field.options?.find((option) => option.value === value)?.label ?? String(value);
+	if (field.type === "date") return formatDate(String(value));
+	if (field.type === "number") {
+		const number = finiteNumber(value);
+		return number === null ? String(value) : numberFormat.format(number);
+	}
+	return String(value);
+}
+/** The sort key of `row`'s field `key`: numbers as numbers, selects by their label, everything else as text. */
+function fieldSort(row, key) {
+	const field = fieldOf(row, key);
+	const value = row.meta[key];
+	if (!field || isEmpty(value)) return null;
+	if (field.type === "number") return finiteNumber(value) ?? String(value);
+	if (field.type === "select") return fieldText(row, key);
+	return String(value);
+}
+/**
+* One column per field key in use, in kind order; the first kind that has the key decides label and type.
+* `textarea` fields (long text such as a transcript) get no column: a table cell can only show a truncated fragment.
+*/
+function fieldColumnsOf(rows, kinds) {
+	const firstRowOfKind = /* @__PURE__ */ new Map();
+	for (const row of rows) if (!firstRowOfKind.has(row.kind)) firstRowOfKind.set(row.kind, row);
+	const seen = /* @__PURE__ */ new Map();
+	for (const kind of kinds) for (const field of firstRowOfKind.get(kind.id)?.fields ?? []) {
+		if (field.type === "textarea" || seen.has(field.key)) continue;
+		seen.set(field.key, {
+			id: `${FIELD_PREFIX}${field.key}`,
+			label: field.label,
+			align: field.type === "number" ? "end" : void 0,
+			sort: (row) => fieldSort(row, field.key),
+			field
+		});
+	}
+	return [...seen.values()];
+}
+/** All columns: title and kind, then the field columns, then tags and summary. */
+function columnSpecsOf(fieldColumns, t) {
+	return [
+		{
+			id: "title",
+			label: t("composites.table.column.composite"),
+			sort: (row) => row.title.trim() || null
+		},
+		{
+			id: "kind",
+			label: t("composites.table.column.kind"),
+			sort: (row) => row.kindLabel
+		},
+		...fieldColumns,
+		{
+			id: "tags",
+			label: t("composites.table.column.tags"),
+			sort: (row) => row.tags.join(", ") || null
+		},
+		{
+			id: "summary",
+			label: t("composites.table.column.summary"),
+			sort: (row) => row.description.trim() ? 1 : 0
+		}
+	];
+}
+/** `rows` ordered by `sort`, descending when `desc`; empty values last whatever the direction. */
+function sortRows(rows, sort, desc) {
+	const factor = desc ? -1 : 1;
+	return [...rows].sort((a, b) => {
+		const x = sort(a);
+		const y = sort(b);
+		if (x === null || y === null) return x === y ? 0 : x === null ? 1 : -1;
+		if (typeof x === "number" && typeof y === "number") return (x - y) * factor;
+		return collator.compare(String(x), String(y)) * factor;
+	});
+}
+/** `list` with `value` added, or removed when present. Pure: returns the new list, the caller assigns it. */
+function toggled(list, value) {
+	return list.includes(value) ? list.filter((item) => item !== value) : [...list, value];
+}
+const hasText = (value) => value.trim() !== "";
+/** Long text fields show a truncated fragment in a cell, with the full text as its title. */
+const isLongText = (field) => field.type === "text" || field.type === "textarea";
+//#endregion
+export { FIELD_PREFIX, FILTER_ALL, collator, columnSpecsOf, fieldColumnsOf, fieldOf, fieldSort, fieldText, hasText, isLongText, sortRows, toggled };
+
+//# sourceMappingURL=table-model.js.map