@ecsplico/editor 0.0.0-stage → 2.0.0

package/dist/core/convert.d.ts

@@ -0,0 +1,96 @@
+import { Fragment, Node, Schema } from "@tiptap/pm/model";
+//#region src/core/convert.d.ts
+/** A block type blocks can be converted into. Inert: composite, speaker and custom targets are interpreted by their providers. */
+export type ConvertTarget = {
+  type: 'paragraph';
+} | {
+  type: 'heading';
+  level: 1 | 2 | 3 | 4 | 5 | 6;
+} | {
+  type: 'bulletList';
+} | {
+  type: 'orderedList';
+} | {
+  type: 'blockquote';
+} | {
+  type: 'codeBlock';
+} | {
+  type: 'transcriptSegment';
+} | {
+  type: 'composite';
+  kind: string;
+} |
+/** A host block: `id` is both the target id and the node type name; `attrs` must match for the node to be the current target. */
+{
+  type: 'custom';
+  id: string;
+  attrs?: Record<string, unknown>;
+};
+type CoreTarget = Extract<ConvertTarget, {
+  type: 'paragraph' | 'heading' | 'bulletList' | 'orderedList' | 'blockquote' | 'codeBlock';
+}>;
+/** Ids of the targets of the core provider. */
+export declare const CORE_TARGET_IDS: readonly ["paragraph", "heading1", "heading2", "heading3", "bulletList", "orderedList", "blockquote", "codeBlock"];
+/** `'heading2'`, `'composite:task'`, a custom target's id, else the target's type. */
+export declare function convertTargetId(target: ConvertTarget): string;
+/** The target of a `CORE_TARGET_IDS` entry; null for anything else. */
+export declare function parseCoreTarget(id: string): CoreTarget | null;
+export declare const isCoreTarget: (target: ConvertTarget) => target is CoreTarget;
+/** `node` already is `target` (same heading level, same composite kind, same custom type and attrs). */
+export declare function isCurrentTarget(node: Node, target: ConvertTarget): boolean;
+/** A textblock of the document body (not a block's chrome such as a composite title). */
+export declare const isTextblockNode: (node: Node) => boolean;
+export declare const isListNode: (node: Node) => boolean;
+export declare const isQuoteNode: (node: Node) => boolean;
+/** A host block holding blocks (a callout): an editor block that is no textblock, leaf, block container, list or quote. */
+export declare const isWrapperBlock: (node: Node) => boolean;
+/** Blocks the core engine converts by itself. */
+export declare const isCoreSource: (node: Node) => boolean;
+export declare function childrenOf(node: Node, from?: number): Node[];
+/** Targets offered for `node` in menus: every core target its schema has except its current type; none for other blocks. */
+export declare function coreConversionTargets(node: Node): ConvertTarget[];
+/** A textblock type to retype blocks into; `variant` lists the attributes that tell variants of one type apart (a heading's level). */
+export interface TextblockSpec {
+  type: string;
+  attrs?: Record<string, unknown>;
+  variant?: readonly string[];
+}
+/** The spec of a textblock core target. */
+export declare function textblockSpecOf(target: Extract<CoreTarget, {
+  type: 'paragraph' | 'heading' | 'codeBlock';
+}>): TextblockSpec;
+/** Blocks of a feature (composites) that unwrap into plain blocks when converted into core targets. */
+export interface ForeignBlocks {
+  is: (node: Node) => boolean;
+  /**
+   * `node` as plain blocks. `keepEmptyTitle`: keep an empty first block. `headingLevel`: the node becomes a heading of
+   * that level, so nested foreign blocks become sub-headings.
+   */
+  unwrap: (node: Node, keepEmptyTitle: boolean, headingLevel?: number) => Node[];
+}
+export interface Converter {
+  /** Inline content of a textblock for a block of `type`: plain text for code blocks; elsewhere code lines become hard breaks. */
+  inline: (node: Node, type: string) => Fragment;
+  /** `node` retyped to a textblock; keeps its own id. The node itself when it already is the target. */
+  textblock: (node: Node, to: TextblockSpec) => Node;
+  toTextblocks: (nodes: Node[], to: TextblockSpec) => Node[];
+  /** One list of `type` (`bulletList`, `orderedList`) with an item per textblock; lists contribute their items. */
+  toList: (nodes: Node[], type: string) => Node[];
+  toQuote: (nodes: Node[]) => Node[];
+}
+/** The conversion rules between textblocks, lists and quotes, over `schema`. Foreign blocks unwrap through `foreign`. */
+export declare function createConverter(schema: Schema, foreign?: ForeignBlocks): Converter;
+/**
+ * Finalizes a conversion of `nodes` into `output`: ids (the first output block takes the first input block's id,
+ * blocks carried over keep theirs, new ones get none), then null when nothing changed or a block violates the schema.
+ */
+export declare function finishConversion(nodes: Node[], output: Node[]): Node[] | null;
+/**
+ * Blocks `nodes` (siblings) converted to a core `target`: textblocks retype, lists flatten into one block per item,
+ * quotes unwrap, textblocks wrap into one list item / paragraph each. Null when the target is not a core target, a node
+ * is not a core source, nothing changes or the result does not fit the schema.
+ */
+export declare function convertCoreBlocks(schema: Schema, nodes: Node[], target: ConvertTarget): Node[] | null;
+//#endregion
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/core/convert.js

@@ -0,0 +1,241 @@
+import "./schema/block-ids.js";
+import { isBlockContainer, isChromeNode, isEditorBlock } from "./schema/node-flags.js";
+import { getText, getTextSerializersFromSchema } from "@tiptap/core";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/core/convert.ts
+/** Ids of the targets of the core provider. */
+const CORE_TARGET_IDS = [
+	"paragraph",
+	"heading1",
+	"heading2",
+	"heading3",
+	"bulletList",
+	"orderedList",
+	"blockquote",
+	"codeBlock"
+];
+const CORE_TARGET_TYPES = {
+	paragraph: true,
+	heading: true,
+	bulletList: true,
+	orderedList: true,
+	blockquote: true,
+	codeBlock: true
+};
+/** `'heading2'`, `'composite:task'`, a custom target's id, else the target's type. */
+function convertTargetId(target) {
+	if (target.type === "heading") return `heading${target.level}`;
+	if (target.type === "composite") return `composite:${target.kind}`;
+	if (target.type === "custom") return target.id;
+	return target.type;
+}
+/** The target of a `CORE_TARGET_IDS` entry; null for anything else. */
+function parseCoreTarget(id) {
+	const known = CORE_TARGET_IDS.find((targetId) => targetId === id);
+	if (!known) return null;
+	if (known === "heading1" || known === "heading2" || known === "heading3") return {
+		type: "heading",
+		level: Number(known.slice(-1))
+	};
+	return { type: known };
+}
+const isCoreTarget = (target) => CORE_TARGET_TYPES[target.type] === true;
+/** `node` already is `target` (same heading level, same composite kind, same custom type and attrs). */
+function isCurrentTarget(node, target) {
+	if (target.type === "custom") return node.type.name === target.id && Object.entries(target.attrs ?? {}).every(([key, value]) => node.attrs[key] === value);
+	if (node.type.name !== target.type) return false;
+	if (target.type === "heading") return node.attrs.level === target.level;
+	if (target.type === "composite") return node.attrs.kind === target.kind;
+	return true;
+}
+const LISTS = {
+	bulletList: true,
+	orderedList: true
+};
+const CODE_BLOCK = "codeBlock";
+/** A textblock of the document body (not a block's chrome such as a composite title). */
+const isTextblockNode = (node) => node.isTextblock && !isChromeNode(node);
+const isListNode = (node) => LISTS[node.type.name] === true;
+const isQuoteNode = (node) => node.type.name === "blockquote";
+/** A host block holding blocks (a callout): an editor block that is no textblock, leaf, block container, list or quote. */
+const isWrapperBlock = (node) => isEditorBlock(node) && !node.isTextblock && !node.isLeaf && !isBlockContainer(node) && !isListNode(node) && !isQuoteNode(node);
+/** Blocks the core engine converts by itself. */
+const isCoreSource = (node) => isTextblockNode(node) || isListNode(node) || isQuoteNode(node);
+function childrenOf(node, from = 0) {
+	const children = [];
+	node.forEach((child, _offset, index) => {
+		if (index >= from) children.push(child);
+	});
+	return children;
+}
+/** Targets offered for `node` in menus: every core target its schema has except its current type; none for other blocks. */
+function coreConversionTargets(node) {
+	if (!isCoreSource(node)) return [];
+	const targets = [
+		{ type: "paragraph" },
+		{
+			type: "heading",
+			level: 1
+		},
+		{
+			type: "heading",
+			level: 2
+		},
+		{
+			type: "heading",
+			level: 3
+		},
+		{ type: "bulletList" },
+		{ type: "orderedList" },
+		{ type: "blockquote" },
+		{ type: "codeBlock" }
+	];
+	const { nodes } = node.type.schema;
+	return targets.filter((target) => nodes[target.type] && !isCurrentTarget(node, target));
+}
+/** The spec of a textblock core target. */
+function textblockSpecOf(target) {
+	return target.type === "heading" ? {
+		type: "heading",
+		attrs: { level: target.level },
+		variant: ["level"]
+	} : { type: target.type };
+}
+/** The conversion rules between textblocks, lists and quotes, over `schema`. Foreign blocks unwrap through `foreign`. */
+function createConverter(schema, foreign) {
+	const n = schema.nodes;
+	const paragraph = n.paragraph;
+	const listItem = n.listItem;
+	const textSerializers = getTextSerializersFromSchema(schema);
+	const paragraphSpec = { type: "paragraph" };
+	function inline(node, type) {
+		if (type === CODE_BLOCK) {
+			const text = getText(node, { textSerializers });
+			return text ? Fragment.from(schema.text(text)) : Fragment.empty;
+		}
+		const hardBreak = n.hardBreak;
+		if (node.type.name !== CODE_BLOCK || !hardBreak) return node.content;
+		const parts = [];
+		node.textContent.split("\n").forEach((line, index) => {
+			if (index) parts.push(hardBreak.create());
+			if (line) parts.push(schema.text(line));
+		});
+		return Fragment.from(parts);
+	}
+	function textblock(node, to) {
+		if (node.type.name === to.type && (to.variant ?? []).every((key) => node.attrs[key] === to.attrs?.[key])) return node;
+		const attrs = {
+			["id"]: node.attrs["id"] ?? null,
+			...to.attrs
+		};
+		return n[to.type].create(attrs, inline(node, to.type));
+	}
+	/** A list as textblocks: one per item from its first paragraph, nested lists depth-first, other item blocks as they are. */
+	function flattenList(list, to) {
+		return childrenOf(list).flatMap((item) => childrenOf(item).flatMap((child, index) => {
+			if (isListNode(child)) return flattenList(child, to);
+			return index === 0 && isTextblockNode(child) ? [textblock(child, to)] : [child];
+		}));
+	}
+	/** Content of a quote or list made from `node`: textblocks as paragraphs, quotes and foreign blocks unwrapped. */
+	function containerBlocks(node) {
+		if (isTextblockNode(node)) return [textblock(node, paragraphSpec)];
+		if (isQuoteNode(node)) return childrenOf(node);
+		if (foreign?.is(node)) return foreign.unwrap(node, false);
+		return [node];
+	}
+	/** List items of `blocks`: one per textblock (as paragraph), the items of lists; other blocks join the item before them. */
+	function listItems(blocks) {
+		const items = [];
+		for (const block of blocks) if (isTextblockNode(block)) items.push(listItem.create(null, textblock(block, paragraphSpec)));
+		else if (isListNode(block)) items.push(...childrenOf(block));
+		else {
+			const last = items.pop();
+			items.push(last ? last.copy(last.content.addToEnd(block)) : listItem.create(null, [paragraph.create(), block]));
+		}
+		return items;
+	}
+	function toTextblocks(nodes, to) {
+		return nodes.flatMap((node) => {
+			if (isTextblockNode(node)) return [textblock(node, to)];
+			if (isListNode(node)) return flattenList(node, to);
+			if (isQuoteNode(node)) return childrenOf(node).map((child) => isTextblockNode(child) ? textblock(child, to) : child);
+			const headingLevel = to.type === "heading" ? Number(to.attrs?.level) : void 0;
+			const [title, ...rest] = foreign.unwrap(node, true, headingLevel);
+			return [textblock(title, to), ...rest];
+		});
+	}
+	return {
+		inline,
+		textblock,
+		toTextblocks,
+		toList: (nodes, type) => [n[type].create(null, listItems(nodes.flatMap(containerBlocks)))],
+		toQuote: (nodes) => [n.blockquote.create(null, nodes.flatMap(containerBlocks))]
+	};
+}
+/** `node` without the id `id` anywhere in it (itself included); the same node when it does not carry it. */
+function withoutId(node, id) {
+	let found = node.attrs["id"] === id;
+	if (!found) node.descendants((child) => {
+		if (child.attrs["id"] === id) found = true;
+		return !found;
+	});
+	if (!found) return node;
+	const attrs = node.attrs["id"] === id ? {
+		...node.attrs,
+		["id"]: null
+	} : node.attrs;
+	return node.type.create(attrs, childrenOf(node).map((child) => withoutId(child, id)), node.marks);
+}
+/** The first block takes `id` (the first input block's) and no other block keeps it; unchanged when there is no id. */
+function withFirstId(blocks, id) {
+	const [head, ...rest] = blocks;
+	if (!head || typeof id !== "string" || !id || !("id" in head.attrs)) return blocks;
+	const own = withoutId(head, id);
+	return [own.type.create({
+		...own.attrs,
+		["id"]: id
+	}, own.content, own.marks), ...rest.map((block) => withoutId(block, id))];
+}
+/**
+* Finalizes a conversion of `nodes` into `output`: ids (the first output block takes the first input block's id,
+* blocks carried over keep theirs, new ones get none), then null when nothing changed or a block violates the schema.
+*/
+function finishConversion(nodes, output) {
+	const result = withFirstId(output, nodes[0]?.attrs["id"]);
+	if (Fragment.from(result).eq(Fragment.from(nodes))) return null;
+	try {
+		for (const block of result) block.check();
+	} catch {
+		return null;
+	}
+	return result;
+}
+/**
+* Blocks `nodes` (siblings) converted to a core `target`: textblocks retype, lists flatten into one block per item,
+* quotes unwrap, textblocks wrap into one list item / paragraph each. Null when the target is not a core target, a node
+* is not a core source, nothing changes or the result does not fit the schema.
+*/
+function convertCoreBlocks(schema, nodes, target) {
+	const first = nodes[0];
+	if (!first || !isCoreTarget(target) || !schema.nodes[target.type]) return null;
+	if (!nodes.every(isCoreSource)) return null;
+	if (nodes.length === 1 && isCurrentTarget(first, target)) return null;
+	const converter = createConverter(schema);
+	let output;
+	switch (target.type) {
+		case "bulletList":
+		case "orderedList":
+			output = converter.toList(nodes, target.type);
+			break;
+		case "blockquote":
+			output = converter.toQuote(nodes);
+			break;
+		default: output = converter.toTextblocks(nodes, textblockSpecOf(target));
+	}
+	return finishConversion(nodes, output);
+}
+//#endregion
+export { CORE_TARGET_IDS, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf };
+
+//# sourceMappingURL=convert.js.map

package/dist/core/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","names":[],"sources":["../../src/core/convert.ts"],"sourcesContent":["import { getText, getTextSerializersFromSchema } from '@tiptap/core'\nimport { Fragment, type Node as PMNode, type Schema } from '@tiptap/pm/model'\nimport { BLOCK_ID_ATTR } from './schema/block-ids'\nimport { isBlockContainer, isChromeNode, isEditorBlock } from './schema/node-flags'\n\n// Vue-free and server-importable: the generic block conversion engine behind „Umwandeln in …“ and the toolbar. It\n// converts paragraphs, headings, code blocks, lists and quotes into each other. Features whose blocks take part\n// (composites, speaker segments) own those conversions as `ConversionProvider`s and reuse this engine for the shared\n// parts (see `ForeignBlocks`, `createConverter`, `finishConversion`).\n\n/** A block type blocks can be converted into. Inert: composite, speaker and custom targets are interpreted by their providers. */\nexport type ConvertTarget =\n  | { type: 'paragraph' } | { type: 'heading', level: 1 | 2 | 3 | 4 | 5 | 6 } | { type: 'bulletList' } | { type: 'orderedList' }\n  | { type: 'blockquote' } | { type: 'codeBlock' } | { type: 'transcriptSegment' } | { type: 'composite', kind: string }\n  /** A host block: `id` is both the target id and the node type name; `attrs` must match for the node to be the current target. */\n  | { type: 'custom', id: string, attrs?: Record<string, unknown> }\n\ntype CoreTarget = Extract<ConvertTarget, { type: 'paragraph' | 'heading' | 'bulletList' | 'orderedList' | 'blockquote' | 'codeBlock' }>\n\n/** Ids of the targets of the core provider. */\nexport const CORE_TARGET_IDS = ['paragraph', 'heading1', 'heading2', 'heading3', 'bulletList', 'orderedList', 'blockquote', 'codeBlock'] as const\n\nconst CORE_TARGET_TYPES: Record<string, true> = { paragraph: true, heading: true, bulletList: true, orderedList: true, blockquote: true, codeBlock: true }\n\n/** `'heading2'`, `'composite:task'`, a custom target's id, else the target's type. */\nexport function convertTargetId(target: ConvertTarget): string {\n  if (target.type === 'heading') return `heading${target.level}`\n  if (target.type === 'composite') return `composite:${target.kind}`\n  if (target.type === 'custom') return target.id\n  return target.type\n}\n\n/** The target of a `CORE_TARGET_IDS` entry; null for anything else. */\nexport function parseCoreTarget(id: string): CoreTarget | null {\n  const known = CORE_TARGET_IDS.find(targetId => targetId === id)\n  if (!known) return null\n  if (known === 'heading1' || known === 'heading2' || known === 'heading3') return { type: 'heading', level: Number(known.slice(-1)) as 1 | 2 | 3 }\n  return { type: known }\n}\n\nexport const isCoreTarget = (target: ConvertTarget): target is CoreTarget => CORE_TARGET_TYPES[target.type] === true\n\n/** `node` already is `target` (same heading level, same composite kind, same custom type and attrs). */\nexport function isCurrentTarget(node: PMNode, target: ConvertTarget): boolean {\n  if (target.type === 'custom') return node.type.name === target.id && Object.entries(target.attrs ?? {}).every(([key, value]) => node.attrs[key] === value)\n  if (node.type.name !== target.type) return false\n  if (target.type === 'heading') return node.attrs.level === target.level\n  if (target.type === 'composite') return node.attrs.kind === target.kind\n  return true\n}\n\nconst LISTS: Record<string, true> = { bulletList: true, orderedList: true }\nconst CODE_BLOCK = 'codeBlock'\n\n/** A textblock of the document body (not a block's chrome such as a composite title). */\nexport const isTextblockNode = (node: PMNode) => node.isTextblock && !isChromeNode(node)\nexport const isListNode = (node: PMNode) => LISTS[node.type.name] === true\nexport const isQuoteNode = (node: PMNode) => node.type.name === 'blockquote'\n/** A host block holding blocks (a callout): an editor block that is no textblock, leaf, block container, list or quote. */\nexport const isWrapperBlock = (node: PMNode) =>\n  isEditorBlock(node) && !node.isTextblock && !node.isLeaf && !isBlockContainer(node) && !isListNode(node) && !isQuoteNode(node)\n/** Blocks the core engine converts by itself. */\nexport const isCoreSource = (node: PMNode) => isTextblockNode(node) || isListNode(node) || isQuoteNode(node)\n\nexport function childrenOf(node: PMNode, from = 0): PMNode[] {\n  const children: PMNode[] = []\n  node.forEach((child, _offset, index) => {\n    if (index >= from) children.push(child)\n  })\n  return children\n}\n\n/** Targets offered for `node` in menus: every core target its schema has except its current type; none for other blocks. */\nexport function coreConversionTargets(node: PMNode): ConvertTarget[] {\n  if (!isCoreSource(node)) return []\n  const targets: ConvertTarget[] = [\n    { type: 'paragraph' }, { type: 'heading', level: 1 }, { type: 'heading', level: 2 }, { type: 'heading', level: 3 },\n    { type: 'bulletList' }, { type: 'orderedList' }, { type: 'blockquote' }, { type: 'codeBlock' },\n  ]\n  const { nodes } = node.type.schema\n  return targets.filter(target => nodes[target.type] && !isCurrentTarget(node, target))\n}\n\n/** A textblock type to retype blocks into; `variant` lists the attributes that tell variants of one type apart (a heading's level). */\nexport interface TextblockSpec {\n  type: string\n  attrs?: Record<string, unknown>\n  variant?: readonly string[]\n}\n\n/** The spec of a textblock core target. */\nexport function textblockSpecOf(target: Extract<CoreTarget, { type: 'paragraph' | 'heading' | 'codeBlock' }>): TextblockSpec {\n  return target.type === 'heading' ? { type: 'heading', attrs: { level: target.level }, variant: ['level'] } : { type: target.type }\n}\n\n/** Blocks of a feature (composites) that unwrap into plain blocks when converted into core targets. */\nexport interface ForeignBlocks {\n  is: (node: PMNode) => boolean\n  /**\n   * `node` as plain blocks. `keepEmptyTitle`: keep an empty first block. `headingLevel`: the node becomes a heading of\n   * that level, so nested foreign blocks become sub-headings.\n   */\n  unwrap: (node: PMNode, keepEmptyTitle: boolean, headingLevel?: number) => PMNode[]\n}\n\nexport interface Converter {\n  /** Inline content of a textblock for a block of `type`: plain text for code blocks; elsewhere code lines become hard breaks. */\n  inline: (node: PMNode, type: string) => Fragment\n  /** `node` retyped to a textblock; keeps its own id. The node itself when it already is the target. */\n  textblock: (node: PMNode, to: TextblockSpec) => PMNode\n  toTextblocks: (nodes: PMNode[], to: TextblockSpec) => PMNode[]\n  /** One list of `type` (`bulletList`, `orderedList`) with an item per textblock; lists contribute their items. */\n  toList: (nodes: PMNode[], type: string) => PMNode[]\n  toQuote: (nodes: PMNode[]) => PMNode[]\n}\n\n/** The conversion rules between textblocks, lists and quotes, over `schema`. Foreign blocks unwrap through `foreign`. */\nexport function createConverter(schema: Schema, foreign?: ForeignBlocks): Converter {\n  const n = schema.nodes\n  const paragraph = n.paragraph!\n  const listItem = n.listItem!\n  const textSerializers = getTextSerializersFromSchema(schema)\n  const paragraphSpec: TextblockSpec = { type: 'paragraph' }\n\n  function inline(node: PMNode, type: string): Fragment {\n    if (type === CODE_BLOCK) {\n      const text = getText(node, { textSerializers })\n      return text ? Fragment.from(schema.text(text)) : Fragment.empty\n    }\n    const hardBreak = n.hardBreak\n    if (node.type.name !== CODE_BLOCK || !hardBreak) return node.content\n    const parts: PMNode[] = []\n    node.textContent.split('\\n').forEach((line, index) => {\n      if (index) parts.push(hardBreak.create())\n      if (line) parts.push(schema.text(line))\n    })\n    return Fragment.from(parts)\n  }\n\n  function textblock(node: PMNode, to: TextblockSpec): PMNode {\n    if (node.type.name === to.type && (to.variant ?? []).every(key => node.attrs[key] === to.attrs?.[key])) return node\n    const attrs: Record<string, unknown> = { [BLOCK_ID_ATTR]: node.attrs[BLOCK_ID_ATTR] ?? null, ...to.attrs }\n    return n[to.type]!.create(attrs, inline(node, to.type))\n  }\n\n  /** A list as textblocks: one per item from its first paragraph, nested lists depth-first, other item blocks as they are. */\n  function flattenList(list: PMNode, to: TextblockSpec): PMNode[] {\n    return childrenOf(list).flatMap(item => childrenOf(item).flatMap((child, index) => {\n      if (isListNode(child)) return flattenList(child, to)\n      return index === 0 && isTextblockNode(child) ? [textblock(child, to)] : [child]\n    }))\n  }\n\n  /** Content of a quote or list made from `node`: textblocks as paragraphs, quotes and foreign blocks unwrapped. */\n  function containerBlocks(node: PMNode): PMNode[] {\n    if (isTextblockNode(node)) return [textblock(node, paragraphSpec)]\n    if (isQuoteNode(node)) return childrenOf(node)\n    if (foreign?.is(node)) return foreign.unwrap(node, false)\n    return [node]\n  }\n\n  /** List items of `blocks`: one per textblock (as paragraph), the items of lists; other blocks join the item before them. */\n  function listItems(blocks: PMNode[]): PMNode[] {\n    const items: PMNode[] = []\n    for (const block of blocks) {\n      if (isTextblockNode(block)) items.push(listItem.create(null, textblock(block, paragraphSpec)))\n      else if (isListNode(block)) items.push(...childrenOf(block))\n      else {\n        const last = items.pop()\n        items.push(last ? last.copy(last.content.addToEnd(block)) : listItem.create(null, [paragraph.create(), block]))\n      }\n    }\n    return items\n  }\n\n  function toTextblocks(nodes: PMNode[], to: TextblockSpec): PMNode[] {\n    return nodes.flatMap((node) => {\n      if (isTextblockNode(node)) return [textblock(node, to)]\n      if (isListNode(node)) return flattenList(node, to)\n      if (isQuoteNode(node)) return childrenOf(node).map(child => isTextblockNode(child) ? textblock(child, to) : child)\n      const headingLevel = to.type === 'heading' ? Number(to.attrs?.level) : undefined\n      const [title, ...rest] = foreign!.unwrap(node, true, headingLevel)\n      return [textblock(title!, to), ...rest]\n    })\n  }\n\n  return {\n    inline,\n    textblock,\n    toTextblocks,\n    toList: (nodes, type) => [n[type]!.create(null, listItems(nodes.flatMap(containerBlocks)))],\n    toQuote: nodes => [n.blockquote!.create(null, nodes.flatMap(containerBlocks))],\n  }\n}\n\n/** `node` without the id `id` anywhere in it (itself included); the same node when it does not carry it. */\nfunction withoutId(node: PMNode, id: string): PMNode {\n  let found = node.attrs[BLOCK_ID_ATTR] === id\n  if (!found) {\n    node.descendants((child) => {\n      if (child.attrs[BLOCK_ID_ATTR] === id) found = true\n      return !found\n    })\n  }\n  if (!found) return node\n  const attrs = node.attrs[BLOCK_ID_ATTR] === id ? { ...node.attrs, [BLOCK_ID_ATTR]: null } : node.attrs\n  return node.type.create(attrs, childrenOf(node).map(child => withoutId(child, id)), node.marks)\n}\n\n/** The first block takes `id` (the first input block's) and no other block keeps it; unchanged when there is no id. */\nfunction withFirstId(blocks: PMNode[], id: unknown): PMNode[] {\n  const [head, ...rest] = blocks\n  if (!head || typeof id !== 'string' || !id || !(BLOCK_ID_ATTR in head.attrs)) return blocks\n  const own = withoutId(head, id)\n  return [own.type.create({ ...own.attrs, [BLOCK_ID_ATTR]: id }, own.content, own.marks), ...rest.map(block => withoutId(block, id))]\n}\n\n/**\n * Finalizes a conversion of `nodes` into `output`: ids (the first output block takes the first input block's id,\n * blocks carried over keep theirs, new ones get none), then null when nothing changed or a block violates the schema.\n */\nexport function finishConversion(nodes: PMNode[], output: PMNode[]): PMNode[] | null {\n  const result = withFirstId(output, nodes[0]?.attrs[BLOCK_ID_ATTR])\n  if (Fragment.from(result).eq(Fragment.from(nodes))) return null\n  try {\n    for (const block of result) block.check()\n  }\n  catch {\n    return null\n  }\n  return result\n}\n\n/**\n * Blocks `nodes` (siblings) converted to a core `target`: textblocks retype, lists flatten into one block per item,\n * quotes unwrap, textblocks wrap into one list item / paragraph each. Null when the target is not a core target, a node\n * is not a core source, nothing changes or the result does not fit the schema.\n */\nexport function convertCoreBlocks(schema: Schema, nodes: PMNode[], target: ConvertTarget): PMNode[] | null {\n  const first = nodes[0]\n  if (!first || !isCoreTarget(target) || !schema.nodes[target.type]) return null\n  if (!nodes.every(isCoreSource)) return null\n  if (nodes.length === 1 && isCurrentTarget(first, target)) return null\n  const converter = createConverter(schema)\n  let output: PMNode[]\n  switch (target.type) {\n    case 'bulletList':\n    case 'orderedList':\n      output = converter.toList(nodes, target.type)\n      break\n    case 'blockquote':\n      output = converter.toQuote(nodes)\n      break\n    default:\n      output = converter.toTextblocks(nodes, textblockSpecOf(target))\n  }\n  return finishConversion(nodes, output)\n}\n"],"mappings":";;;;;;AAoBA,MAAa,kBAAkB;CAAC;CAAa;CAAY;CAAY;CAAY;CAAc;CAAe;CAAc;AAAW;AAEvI,MAAM,oBAA0C;CAAE,WAAW;CAAM,SAAS;CAAM,YAAY;CAAM,aAAa;CAAM,YAAY;CAAM,WAAW;AAAK;;AAGzJ,SAAgB,gBAAgB,QAA+B;CAC7D,IAAI,OAAO,SAAS,WAAW,OAAO,UAAU,OAAO;CACvD,IAAI,OAAO,SAAS,aAAa,OAAO,aAAa,OAAO;CAC5D,IAAI,OAAO,SAAS,UAAU,OAAO,OAAO;CAC5C,OAAO,OAAO;AAChB;;AAGA,SAAgB,gBAAgB,IAA+B;CAC7D,MAAM,QAAQ,gBAAgB,MAAK,aAAY,aAAa,EAAE;CAC9D,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,UAAU,cAAc,UAAU,cAAc,UAAU,YAAY,OAAO;EAAE,MAAM;EAAW,OAAO,OAAO,MAAM,MAAM,EAAE,CAAC;CAAe;CAChJ,OAAO,EAAE,MAAM,MAAM;AACvB;AAEA,MAAa,gBAAgB,WAAgD,kBAAkB,OAAO,UAAU;;AAGhH,SAAgB,gBAAgB,MAAc,QAAgC;CAC5E,IAAI,OAAO,SAAS,UAAU,OAAO,KAAK,KAAK,SAAS,OAAO,MAAM,OAAO,QAAQ,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,WAAW,KAAK,MAAM,SAAS,KAAK;CACzJ,IAAI,KAAK,KAAK,SAAS,OAAO,MAAM,OAAO;CAC3C,IAAI,OAAO,SAAS,WAAW,OAAO,KAAK,MAAM,UAAU,OAAO;CAClE,IAAI,OAAO,SAAS,aAAa,OAAO,KAAK,MAAM,SAAS,OAAO;CACnE,OAAO;AACT;AAEA,MAAM,QAA8B;CAAE,YAAY;CAAM,aAAa;AAAK;AAC1E,MAAM,aAAa;;AAGnB,MAAa,mBAAmB,SAAiB,KAAK,eAAe,CAAC,aAAa,IAAI;AACvF,MAAa,cAAc,SAAiB,MAAM,KAAK,KAAK,UAAU;AACtE,MAAa,eAAe,SAAiB,KAAK,KAAK,SAAS;;AAEhE,MAAa,kBAAkB,SAC7B,cAAc,IAAI,KAAK,CAAC,KAAK,eAAe,CAAC,KAAK,UAAU,CAAC,iBAAiB,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,IAAI;;AAE/H,MAAa,gBAAgB,SAAiB,gBAAgB,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI;AAE3G,SAAgB,WAAW,MAAc,OAAO,GAAa;CAC3D,MAAM,WAAqB,CAAC;CAC5B,KAAK,SAAS,OAAO,SAAS,UAAU;EACtC,IAAI,SAAS,MAAM,SAAS,KAAK,KAAK;CACxC,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,sBAAsB,MAA+B;CACnE,IAAI,CAAC,aAAa,IAAI,GAAG,OAAO,CAAC;CACjC,MAAM,UAA2B;EAC/B,EAAE,MAAM,YAAY;EAAG;GAAE,MAAM;GAAW,OAAO;EAAE;EAAG;GAAE,MAAM;GAAW,OAAO;EAAE;EAAG;GAAE,MAAM;GAAW,OAAO;EAAE;EACjH,EAAE,MAAM,aAAa;EAAG,EAAE,MAAM,cAAc;EAAG,EAAE,MAAM,aAAa;EAAG,EAAE,MAAM,YAAY;CAC/F;CACA,MAAM,EAAE,UAAU,KAAK,KAAK;CAC5B,OAAO,QAAQ,QAAO,WAAU,MAAM,OAAO,SAAS,CAAC,gBAAgB,MAAM,MAAM,CAAC;AACtF;;AAUA,SAAgB,gBAAgB,QAA6F;CAC3H,OAAO,OAAO,SAAS,YAAY;EAAE,MAAM;EAAW,OAAO,EAAE,OAAO,OAAO,MAAM;EAAG,SAAS,CAAC,OAAO;CAAE,IAAI,EAAE,MAAM,OAAO,KAAK;AACnI;;AAwBA,SAAgB,gBAAgB,QAAgB,SAAoC;CAClF,MAAM,IAAI,OAAO;CACjB,MAAM,YAAY,EAAE;CACpB,MAAM,WAAW,EAAE;CACnB,MAAM,kBAAkB,6BAA6B,MAAM;CAC3D,MAAM,gBAA+B,EAAE,MAAM,YAAY;CAEzD,SAAS,OAAO,MAAc,MAAwB;EACpD,IAAI,SAAS,YAAY;GACvB,MAAM,OAAO,QAAQ,MAAM,EAAE,gBAAgB,CAAC;GAC9C,OAAO,OAAO,SAAS,KAAK,OAAO,KAAK,IAAI,CAAC,IAAI,SAAS;EAC5D;EACA,MAAM,YAAY,EAAE;EACpB,IAAI,KAAK,KAAK,SAAS,cAAc,CAAC,WAAW,OAAO,KAAK;EAC7D,MAAM,QAAkB,CAAC;EACzB,KAAK,YAAY,MAAM,IAAI,CAAC,CAAC,SAAS,MAAM,UAAU;GACpD,IAAI,OAAO,MAAM,KAAK,UAAU,OAAO,CAAC;GACxC,IAAI,MAAM,MAAM,KAAK,OAAO,KAAK,IAAI,CAAC;EACxC,CAAC;EACD,OAAO,SAAS,KAAK,KAAK;CAC5B;CAEA,SAAS,UAAU,MAAc,IAA2B;EAC1D,IAAI,KAAK,KAAK,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,EAAA,CAAG,OAAM,QAAO,KAAK,MAAM,SAAS,GAAG,QAAQ,IAAI,GAAG,OAAO;EAC/G,MAAM,QAAiC;IAAmB,OAAA,KAAK,MAAA,SAAwB;GAAM,GAAG,GAAG;EAAM;EACzG,OAAO,EAAE,GAAG,KAAK,CAAE,OAAO,OAAO,OAAO,MAAM,GAAG,IAAI,CAAC;CACxD;;CAGA,SAAS,YAAY,MAAc,IAA6B;EAC9D,OAAO,WAAW,IAAI,CAAC,CAAC,SAAQ,SAAQ,WAAW,IAAI,CAAC,CAAC,SAAS,OAAO,UAAU;GACjF,IAAI,WAAW,KAAK,GAAG,OAAO,YAAY,OAAO,EAAE;GACnD,OAAO,UAAU,KAAK,gBAAgB,KAAK,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK;EAChF,CAAC,CAAC;CACJ;;CAGA,SAAS,gBAAgB,MAAwB;EAC/C,IAAI,gBAAgB,IAAI,GAAG,OAAO,CAAC,UAAU,MAAM,aAAa,CAAC;EACjE,IAAI,YAAY,IAAI,GAAG,OAAO,WAAW,IAAI;EAC7C,IAAI,SAAS,GAAG,IAAI,GAAG,OAAO,QAAQ,OAAO,MAAM,KAAK;EACxD,OAAO,CAAC,IAAI;CACd;;CAGA,SAAS,UAAU,QAA4B;EAC7C,MAAM,QAAkB,CAAC;EACzB,KAAK,MAAM,SAAS,QAClB,IAAI,gBAAgB,KAAK,GAAG,MAAM,KAAK,SAAS,OAAO,MAAM,UAAU,OAAO,aAAa,CAAC,CAAC;OACxF,IAAI,WAAW,KAAK,GAAG,MAAM,KAAK,GAAG,WAAW,KAAK,CAAC;OACtD;GACH,MAAM,OAAO,MAAM,IAAI;GACvB,MAAM,KAAK,OAAO,KAAK,KAAK,KAAK,QAAQ,SAAS,KAAK,CAAC,IAAI,SAAS,OAAO,MAAM,CAAC,UAAU,OAAO,GAAG,KAAK,CAAC,CAAC;EAChH;EAEF,OAAO;CACT;CAEA,SAAS,aAAa,OAAiB,IAA6B;EAClE,OAAO,MAAM,SAAS,SAAS;GAC7B,IAAI,gBAAgB,IAAI,GAAG,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC;GACtD,IAAI,WAAW,IAAI,GAAG,OAAO,YAAY,MAAM,EAAE;GACjD,IAAI,YAAY,IAAI,GAAG,OAAO,WAAW,IAAI,CAAC,CAAC,KAAI,UAAS,gBAAgB,KAAK,IAAI,UAAU,OAAO,EAAE,IAAI,KAAK;GACjH,MAAM,eAAe,GAAG,SAAS,YAAY,OAAO,GAAG,OAAO,KAAK,IAAI,KAAA;GACvE,MAAM,CAAC,OAAO,GAAG,QAAQ,QAAS,OAAO,MAAM,MAAM,YAAY;GACjE,OAAO,CAAC,UAAU,OAAQ,EAAE,GAAG,GAAG,IAAI;EACxC,CAAC;CACH;CAEA,OAAO;EACL;EACA;EACA;EACA,SAAS,OAAO,SAAS,CAAC,EAAE,KAAK,CAAE,OAAO,MAAM,UAAU,MAAM,QAAQ,eAAe,CAAC,CAAC,CAAC;EAC1F,UAAS,UAAS,CAAC,EAAE,WAAY,OAAO,MAAM,MAAM,QAAQ,eAAe,CAAC,CAAC;CAC/E;AACF;;AAGA,SAAS,UAAU,MAAc,IAAoB;CACnD,IAAI,QAAQ,KAAK,MAAA,UAAyB;CAC1C,IAAI,CAAC,OACH,KAAK,aAAa,UAAU;EAC1B,IAAI,MAAM,MAAA,UAAyB,IAAI,QAAQ;EAC/C,OAAO,CAAC;CACV,CAAC;CAEH,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,QAAQ,KAAK,MAAA,UAAyB,KAAK;EAAE,GAAG,KAAK;GAAwB,OAAA;CAAK,IAAI,KAAK;CACjG,OAAO,KAAK,KAAK,OAAO,OAAO,WAAW,IAAI,CAAC,CAAC,KAAI,UAAS,UAAU,OAAO,EAAE,CAAC,GAAG,KAAK,KAAK;AAChG;;AAGA,SAAS,YAAY,QAAkB,IAAuB;CAC5D,MAAM,CAAC,MAAM,GAAG,QAAQ;CACxB,IAAI,CAAC,QAAQ,OAAO,OAAO,YAAY,CAAC,MAAM,EAAA,QAAmB,KAAK,QAAQ,OAAO;CACrF,MAAM,MAAM,UAAU,MAAM,EAAE;CAC9B,OAAO,CAAC,IAAI,KAAK,OAAO;EAAE,GAAG,IAAI;GAAwB,OAAA;CAAG,GAAG,IAAI,SAAS,IAAI,KAAK,GAAG,GAAG,KAAK,KAAI,UAAS,UAAU,OAAO,EAAE,CAAC,CAAC;AACpI;;;;;AAMA,SAAgB,iBAAiB,OAAiB,QAAmC;CACnF,MAAM,SAAS,YAAY,QAAQ,MAAM,EAAE,EAAE,MAAA,KAAoB;CACjE,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,GAAG,OAAO;CAC3D,IAAI;EACF,KAAK,MAAM,SAAS,QAAQ,MAAM,MAAM;CAC1C,QACM;EACJ,OAAO;CACT;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,kBAAkB,QAAgB,OAAiB,QAAwC;CACzG,MAAM,QAAQ,MAAM;CACpB,IAAI,CAAC,SAAS,CAAC,aAAa,MAAM,KAAK,CAAC,OAAO,MAAM,OAAO,OAAO,OAAO;CAC1E,IAAI,CAAC,MAAM,MAAM,YAAY,GAAG,OAAO;CACvC,IAAI,MAAM,WAAW,KAAK,gBAAgB,OAAO,MAAM,GAAG,OAAO;CACjE,MAAM,YAAY,gBAAgB,MAAM;CACxC,IAAI;CACJ,QAAQ,OAAO,MAAf;EACE,KAAK;EACL,KAAK;GACH,SAAS,UAAU,OAAO,OAAO,OAAO,IAAI;GAC5C;EACF,KAAK;GACH,SAAS,UAAU,QAAQ,KAAK;GAChC;EACF,SACE,SAAS,UAAU,aAAa,OAAO,gBAAgB,MAAM,CAAC;CAClE;CACA,OAAO,iBAAiB,OAAO,MAAM;AACvC"}

package/dist/core/core-feature.d.ts

@@ -0,0 +1,17 @@
+import { BlockAction } from "./extension-points.js";
+import { EditorFeature, FeatureContext } from "./feature.js";
+//#region src/core/core-feature.d.ts
+/** Hover actions every editor with block UI has: „Umwandeln in …“, duplicate, delete (in this order, after features' own). */
+export declare const coreBlockActions: (ctx: FeatureContext) => readonly BlockAction[];
+/**
+ * The base of every editor, and all a simple editor is: StarterKit with StrikeX, block IDs and node flags, the verbatim
+ * `OpaqueFence` for Markdown fences of unknown kinds, Markdown, Placeholder (marks empty textblocks `is-empty`),
+ * BlockFlash (`revealBlock`), local DocAnchors, abilities and metadata infrastructure, the standard conversions, the
+ * `/` menu (without commands of its own: hosts and other features fill it), the undo/redo, formatting and block toolbar
+ * groups, and the duplicate/delete/convert block actions.
+ * StarterKit's undo history is off when a collaboration session brings its own.
+ * Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.
+ */
+export declare function coreFeature(): EditorFeature<never>;
+//#endregion
+//# sourceMappingURL=core-feature.d.ts.map

package/dist/core/core-feature.js

@@ -0,0 +1,100 @@
+import { ABILITY } from "./schema/abilities.js";
+import { Abilities } from "./abilities.js";
+import { BlockId } from "./schema/block-ids.js";
+import { NodeFlags } from "./schema/node-flags.js";
+import { BlockConvert, convertMenuItems, coreConversions } from "./block-convert.js";
+import { BlockFlash } from "./block-flash.js";
+import { DocAnchors } from "./doc-anchors.js";
+import { DocumentMarkdown } from "./document-markdown.js";
+import { Metadata } from "./metadata.js";
+import { OpaqueFence } from "./schema/opaque-fence.js";
+import { StrikeX } from "./schema/strike.js";
+import { SlashCommand } from "./slash.js";
+import { coreToolbarGroups } from "./toolbar-items.js";
+import { Placeholder } from "@tiptap/extensions";
+import StarterKit from "@tiptap/starter-kit";
+//#region src/core/core-feature.ts
+/** Hover actions every editor with block UI has: „Umwandeln in …“, duplicate, delete (in this order, after features' own). */
+const coreBlockActions = (ctx) => [
+	{
+		id: "convert",
+		label: ctx.t("block.convert"),
+		icon: "i-lucide-replace",
+		ability: ABILITY.blockConvert,
+		order: 1e3,
+		menu: ({ editor, node, pos }) => convertMenuItems(editor, {
+			node,
+			pos
+		}, ctx.t)
+	},
+	{
+		id: "duplicate",
+		label: ctx.t("block.duplicate"),
+		icon: "i-lucide-copy",
+		ability: ABILITY.blockDuplicate,
+		order: 1010,
+		run: ({ editor, node, pos }) => editor.chain().insertContentAt(pos + node.nodeSize, node.toJSON()).run()
+	},
+	{
+		id: "delete",
+		label: ctx.t("block.delete"),
+		icon: "i-lucide-trash-2",
+		ability: ABILITY.blockDelete,
+		order: 1020,
+		run: ({ editor, node, pos }) => editor.chain().focus().deleteRange({
+			from: pos,
+			to: pos + node.nodeSize
+		}).run()
+	}
+];
+/**
+* The base of every editor, and all a simple editor is: StarterKit with StrikeX, block IDs and node flags, the verbatim
+* `OpaqueFence` for Markdown fences of unknown kinds, Markdown, Placeholder (marks empty textblocks `is-empty`),
+* BlockFlash (`revealBlock`), local DocAnchors, abilities and metadata infrastructure, the standard conversions, the
+* `/` menu (without commands of its own: hosts and other features fill it), the undo/redo, formatting and block toolbar
+* groups, and the duplicate/delete/convert block actions.
+* StarterKit's undo history is off when a collaboration session brings its own.
+* Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.
+*/
+function coreFeature() {
+	return {
+		id: "core",
+		extensions: (ctx) => [
+			Abilities.configure(ctx.abilities),
+			StarterKit.configure({
+				strike: false,
+				undoRedo: ctx.collaboration ? false : void 0,
+				dropcursor: {
+					color: "var(--sk-primary)",
+					width: 2
+				}
+			}),
+			StrikeX,
+			NodeFlags,
+			OpaqueFence,
+			Placeholder.configure({
+				includeChildren: true,
+				showOnlyCurrent: false,
+				placeholder: ""
+			}),
+			Metadata.configure({ registry: ctx.metadata }),
+			SlashCommand.configure({
+				items: ctx.slashCommands(),
+				emptyText: ctx.t("slash.empty"),
+				loadingText: ctx.t("common.loading")
+			}),
+			BlockId,
+			DocumentMarkdown,
+			BlockFlash,
+			BlockConvert,
+			DocAnchors.configure({ resolver: ctx.anchorResolver })
+		],
+		toolbar: (ctx) => coreToolbarGroups(ctx),
+		blockActions: (ctx) => [...coreBlockActions(ctx)],
+		conversions: [coreConversions]
+	};
+}
+//#endregion
+export { coreBlockActions, coreFeature };
+
+//# sourceMappingURL=core-feature.js.map

package/dist/core/core-feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-feature.js","names":[],"sources":["../../src/core/core-feature.ts"],"sourcesContent":["import { Placeholder } from '@tiptap/extensions'\nimport StarterKit from '@tiptap/starter-kit'\nimport { Abilities } from './abilities'\nimport { BlockConvert, coreConversions, convertMenuItems } from './block-convert'\nimport { BlockFlash } from './block-flash'\nimport { DocAnchors } from './doc-anchors'\nimport { DocumentMarkdown } from './document-markdown'\nimport type { BlockAction } from './extension-points'\nimport type { EditorFeature, FeatureContext } from './feature'\nimport { Metadata } from './metadata'\nimport { ABILITY } from './schema/abilities'\nimport { BlockId } from './schema/block-ids'\nimport { NodeFlags } from './schema/node-flags'\nimport { OpaqueFence } from './schema/opaque-fence'\nimport { StrikeX } from './schema/strike'\nimport { SlashCommand } from './slash'\nimport { coreToolbarGroups } from './toolbar-items'\n\n/** Hover actions every editor with block UI has: „Umwandeln in …“, duplicate, delete (in this order, after features' own). */\nexport const coreBlockActions = (ctx: FeatureContext): readonly BlockAction[] => [\n  {\n    id: 'convert',\n    label: ctx.t('block.convert'),\n    icon: 'i-lucide-replace',\n    ability: ABILITY.blockConvert,\n    order: 1000,\n    menu: ({ editor, node, pos }) => convertMenuItems(editor, { node, pos }, ctx.t),\n  },\n  {\n    id: 'duplicate',\n    label: ctx.t('block.duplicate'),\n    icon: 'i-lucide-copy',\n    ability: ABILITY.blockDuplicate,\n    order: 1010,\n    // BlockId's dedupe plugin gives the copy (and every block nested in it) fresh ids.\n    run: ({ editor, node, pos }) => editor.chain().insertContentAt(pos + node.nodeSize, node.toJSON()).run(),\n  },\n  {\n    id: 'delete',\n    label: ctx.t('block.delete'),\n    icon: 'i-lucide-trash-2',\n    ability: ABILITY.blockDelete,\n    order: 1020,\n    run: ({ editor, node, pos }) => editor.chain().focus().deleteRange({ from: pos, to: pos + node.nodeSize }).run(),\n  },\n]\n\n/**\n * The base of every editor, and all a simple editor is: StarterKit with StrikeX, block IDs and node flags, the verbatim\n * `OpaqueFence` for Markdown fences of unknown kinds, Markdown, Placeholder (marks empty textblocks `is-empty`),\n * BlockFlash (`revealBlock`), local DocAnchors, abilities and metadata infrastructure, the standard conversions, the\n * `/` menu (without commands of its own: hosts and other features fill it), the undo/redo, formatting and block toolbar\n * groups, and the duplicate/delete/convert block actions.\n * StarterKit's undo history is off when a collaboration session brings its own.\n * Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.\n */\nexport function coreFeature(): EditorFeature<never> {\n  return {\n    id: 'core',\n    extensions: ctx => [\n      Abilities.configure(ctx.abilities),\n      StarterKit.configure({ strike: false, undoRedo: ctx.collaboration ? false : undefined, dropcursor: { color: 'var(--sk-primary)', width: 2 } }),\n      StrikeX,\n      NodeFlags,\n      OpaqueFence,\n      Placeholder.configure({ includeChildren: true, showOnlyCurrent: false, placeholder: '' }),\n      Metadata.configure({ registry: ctx.metadata }),\n      SlashCommand.configure({ items: ctx.slashCommands(), emptyText: ctx.t('slash.empty'), loadingText: ctx.t('common.loading') }),\n      BlockId,\n      DocumentMarkdown,\n      BlockFlash,\n      BlockConvert,\n      DocAnchors.configure({ resolver: ctx.anchorResolver }),\n    ],\n    toolbar: ctx => coreToolbarGroups(ctx),\n    blockActions: ctx => [...coreBlockActions(ctx)],\n    conversions: [coreConversions],\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,MAAa,oBAAoB,QAAgD;CAC/E;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,eAAe;EAC5B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EACP,OAAO,EAAE,QAAQ,MAAM,UAAU,iBAAiB,QAAQ;GAAE;GAAM;EAAI,GAAG,IAAI,CAAC;CAChF;CACA;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,iBAAiB;EAC9B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EAEP,MAAM,EAAE,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,gBAAgB,MAAM,KAAK,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI;CACzG;CACA;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,cAAc;EAC3B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EACP,MAAM,EAAE,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;GAAE,MAAM;GAAK,IAAI,MAAM,KAAK;EAAS,CAAC,CAAC,CAAC,IAAI;CACjH;AACF;;;;;;;;;;AAWA,SAAgB,cAAoC;CAClD,OAAO;EACL,IAAI;EACJ,aAAY,QAAO;GACjB,UAAU,UAAU,IAAI,SAAS;GACjC,WAAW,UAAU;IAAE,QAAQ;IAAO,UAAU,IAAI,gBAAgB,QAAQ,KAAA;IAAW,YAAY;KAAE,OAAO;KAAqB,OAAO;IAAE;GAAE,CAAC;GAC7I;GACA;GACA;GACA,YAAY,UAAU;IAAE,iBAAiB;IAAM,iBAAiB;IAAO,aAAa;GAAG,CAAC;GACxF,SAAS,UAAU,EAAE,UAAU,IAAI,SAAS,CAAC;GAC7C,aAAa,UAAU;IAAE,OAAO,IAAI,cAAc;IAAG,WAAW,IAAI,EAAE,aAAa;IAAG,aAAa,IAAI,EAAE,gBAAgB;GAAE,CAAC;GAC5H;GACA;GACA;GACA;GACA,WAAW,UAAU,EAAE,UAAU,IAAI,eAAe,CAAC;EACvD;EACA,UAAS,QAAO,kBAAkB,GAAG;EACrC,eAAc,QAAO,CAAC,GAAG,iBAAiB,GAAG,CAAC;EAC9C,aAAa,CAAC,eAAe;CAC/B;AACF"}

package/dist/core/define-editor.d.ts

@@ -0,0 +1,23 @@
+import { EditorContext } from "./context.js";
+import { EditorFeature, EditorPreset, SettingsTab } from "./feature.js";
+//#region src/core/define-editor.d.ts
+/**
+ * Validates `features` and resolves their pipeline and conversion providers. Keeps the given order; neither
+ * deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed
+ * and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
+ * `formatAiResult`) contributed twice. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
+ * concatenated in feature order, `structure` from one feature only); their conflicts surface when the merged `aiContext` reads the editor.
+ * `aiBlockData` contributions are additive too: they run in parallel per block and their data concatenate in feature order.
+ */
+export declare function defineEditor<C = unknown>(config: {
+  features: readonly EditorFeature<C>[];
+}): EditorPreset<C>;
+/**
+ * The settings tabs the features of `preset` contribute for the app context `ctx` (labels in its language), in feature
+ * order; none means there is no settings UI. Throws when two features contribute the same tab id.
+ */
+export declare function settingsTabsOf<C = unknown>(preset: EditorPreset<C>, ctx: EditorContext): readonly SettingsTab<C>[];
+/** Features of `preset` that fill the contribution `key`, in order. */
+export declare function contributions<C, K extends keyof EditorFeature<C>>(preset: EditorPreset<C>, key: K): NonNullable<EditorFeature<C>[K]>[];
+//#endregion
+//# sourceMappingURL=define-editor.d.ts.map

package/dist/core/define-editor.js

@@ -0,0 +1,110 @@
+import { DEFAULT_BLOCK_PIPELINE } from "./pipeline.js";
+import { SINGLETON_PIPELINE_HOOKS } from "./feature.js";
+//#region src/core/define-editor.ts
+const FEATURE_SINGLETONS = ["anchorResolver", "formatAiResult"];
+function fail(message) {
+	throw new Error(`@ecsplico/editor: defineEditor: ${message}`);
+}
+/**
+* Validates `features` and resolves their pipeline and conversion providers. Keeps the given order; neither
+* deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed
+* and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
+* `formatAiResult`) contributed twice. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
+* concatenated in feature order, `structure` from one feature only); their conflicts surface when the merged `aiContext` reads the editor.
+* `aiBlockData` contributions are additive too: they run in parallel per block and their data concatenate in feature order.
+*/
+function defineEditor(config) {
+	const features = Object.freeze([...config.features]);
+	const ids = /* @__PURE__ */ new Set();
+	for (const feature of features) {
+		if (ids.has(feature.id)) fail(`duplicate feature id "${feature.id}"`);
+		ids.add(feature.id);
+	}
+	for (const feature of features) for (const required of feature.requires ?? []) if (!ids.has(required)) fail(`feature "${feature.id}" requires "${required}", which is not installed`);
+	const owners = /* @__PURE__ */ new Map();
+	const claim = (hook, feature) => {
+		const owner = owners.get(hook);
+		if (owner) fail(`features "${owner}" and "${feature.id}" both contribute the singleton hook "${hook}"`);
+		owners.set(hook, feature.id);
+	};
+	const pipeline = { ...DEFAULT_BLOCK_PIPELINE };
+	const normalizers = [];
+	for (const feature of features) {
+		for (const hook of FEATURE_SINGLETONS) if (feature[hook]) claim(hook, feature);
+		const blocks = feature.blocks;
+		if (!blocks) continue;
+		if (blocks.normalize) normalizers.push(blocks.normalize);
+		for (const hook of SINGLETON_PIPELINE_HOOKS) {
+			const fn = blocks[hook];
+			if (!fn) continue;
+			claim(hook, feature);
+			Object.assign(pipeline, { [hook]: fn });
+		}
+	}
+	if (normalizers.length) pipeline.normalize = (editor, blocks) => normalizers.reduce((current, normalize) => normalize(editor, current), blocks);
+	const conversions = features.flatMap((feature) => [...feature.conversions ?? []]);
+	const contexts = features.flatMap((feature) => feature.aiContext ? [{
+		id: feature.id,
+		read: feature.aiContext
+	}] : []);
+	const aiContext = contexts.length ? (editor) => {
+		const merged = {
+			kinds: [],
+			blocks: []
+		};
+		const blockIds = /* @__PURE__ */ new Set();
+		for (const { id, read } of contexts) {
+			const context = read(editor);
+			merged.kinds.push(...context.kinds ?? []);
+			for (const block of context.blocks ?? []) {
+				if (blockIds.has(block.id)) fail(`the AI block "${block.id}" is described by more than one feature`);
+				blockIds.add(block.id);
+				merged.blocks.push(block);
+			}
+			if (context.structure === void 0) continue;
+			if (merged.owner) fail(`features "${merged.owner}" and "${id}" both set aiContext.structure`);
+			merged.owner = id;
+			merged.structure = context.structure;
+		}
+		return {
+			kinds: merged.kinds,
+			blocks: merged.blocks,
+			...merged.structure && { structure: merged.structure }
+		};
+	} : void 0;
+	const dataProviders = features.flatMap((feature) => feature.aiBlockData ? [feature.aiBlockData] : []);
+	const aiBlockData = dataProviders.length ? async (request) => (await Promise.all(dataProviders.map((provide) => provide(request)))).flat() : void 0;
+	const formatAiResult = features.find((feature) => feature.formatAiResult)?.formatAiResult;
+	return Object.freeze({
+		features,
+		pipeline: Object.freeze(pipeline),
+		conversions: Object.freeze(conversions),
+		...aiContext && { aiContext },
+		...aiBlockData && { aiBlockData },
+		...formatAiResult && { formatAiResult }
+	});
+}
+/**
+* The settings tabs the features of `preset` contribute for the app context `ctx` (labels in its language), in feature
+* order; none means there is no settings UI. Throws when two features contribute the same tab id.
+*/
+function settingsTabsOf(preset, ctx) {
+	const owners = /* @__PURE__ */ new Map();
+	return preset.features.flatMap((feature) => {
+		const tabs = feature.settingsTabs?.(ctx) ?? [];
+		for (const tab of tabs) {
+			const owner = owners.get(tab.id);
+			if (owner) fail(`features "${owner}" and "${feature.id}" both contribute the settings tab "${tab.id}"`);
+			owners.set(tab.id, feature.id);
+		}
+		return tabs;
+	});
+}
+/** Features of `preset` that fill the contribution `key`, in order. */
+function contributions(preset, key) {
+	return preset.features.flatMap((feature) => feature[key] ? [feature[key]] : []);
+}
+//#endregion
+export { contributions, defineEditor, settingsTabsOf };
+
+//# sourceMappingURL=define-editor.js.map