@ecsplico/editor 3.6.0 → 4.1.0

package/dist/core/capabilities.d.ts

@@ -0,0 +1,113 @@
+import { ZodType } from "zod";
+import { Editor } from "@tiptap/core";
+import { Node as Node$1 } from "@tiptap/pm/model";
+//#region src/core/capabilities.d.ts
+/** One capability a Block type lists, with the config the capability's `configSchema` validates. Plain JSON. */
+export interface BlockTypeCapability {
+  id: string;
+  config?: unknown;
+}
+/** What the capability registry knows of a Block type: its id and the capabilities it lists. The public `BlockType` extends it with presentation. */
+export interface BlockTypeData {
+  id: string;
+  capabilities: readonly BlockTypeCapability[];
+}
+/** What a capability predicate may read besides the node. */
+export interface CapabilityContext {
+  /** The id of the node's Block type: its persisted `attrs.blockType`; null for a node without one. */
+  blockTypeId: string | null;
+  /** The Block type of `node` among the editor's Block types; null for a node without one, an id no Block type defines, or an editor without Block types. */
+  blockTypeOf: (node: Node$1) => BlockTypeData | null;
+  /** The config the Block type of `node` gives `capability`; undefined when the type does not list it or lists it without config. */
+  configOf: <C = unknown>(node: Node$1, capability: string) => C | undefined;
+}
+/** The config `type` gives capability `id`; undefined when there is no `type` (`ctx.blockTypeOf(node)` found none), it does not list the capability or lists it without config. */
+export declare const blockTypeConfigOf: <C = unknown>(type: BlockTypeData | null | undefined, id: string) => C | undefined;
+/** Whether `type` lists capability `id`: the `appliesTo` of a capability a Block type opts into is `listsCapability(ctx.blockTypeOf(node), id)`. False without a `type`. */
+export declare const listsCapability: (type: BlockTypeData | null | undefined, id: string) => boolean;
+/**
+ * A descriptor a Feature declares through `EditorFeature.blockCapabilities`: whether a block has the capability, where its
+ * data lives and how to read it. It never installs schema, extensions, node views or settings; the Feature that owns the mechanism does.
+ */
+export interface BlockCapability {
+  /** Unique across the preset (`container`, `title` are built in); a `BlockAction.requires` entry and a Block type's `capabilities` name it. */
+  id: string;
+  /**
+   * Whether `node` has the capability. The result is memoised per node type and Block type id (`capabilitiesOf`), so it may
+   * read only the node type (its spec and flags), `ctx.blockTypeId` and the Block type's config (`ctx.configOf`), never other
+   * attributes or the content; a capability that must read node attributes sets `perNode`.
+   */
+  appliesTo: (node: Node$1, ctx: CapabilityContext) => boolean;
+  /**
+   * `appliesTo` reads attributes of the node itself (`derived`: `meta.derivation` is present), so it runs for every node instead of
+   * once per node type and Block type id. Keep such predicates to a constant-time attribute check.
+   */
+  perNode?: boolean;
+  /** Validates the config a Block type gives the capability. Absent: the capability takes no config and a Block type may not give one. */
+  configSchema?: ZodType;
+  /**
+   * The current contents or value of the capability in `node` (the source media child, the basket id, the bibliography
+   * record); null when the block has none. Called only for blocks that have the capability; not memoised.
+   */
+  read?: (node: Node$1, ctx: CapabilityContext) => unknown;
+  /** Where the capability's data lives, so conversion, Markdown and copy can treat it uniformly. Descriptive only. */
+  storage?: {
+    /** Keys of the node's `meta` attribute. */
+    metaKeys?: readonly string[];
+    /** Node type names of the children that hold the data. */
+    childTypes?: readonly string[];
+  };
+}
+/** The structural capabilities every editor has, derived from existing node flags. A Feature may not declare these ids. */
+export declare const BUILT_IN_BLOCK_CAPABILITIES: readonly BlockCapability[];
+/** The merged capabilities of a preset: the declarations, shared by every editor created from it. */
+export interface CapabilityRegistry {
+  /** Built-in capabilities first, then the Features' in feature order. */
+  readonly capabilities: readonly BlockCapability[];
+  has: (id: string) => boolean;
+  get: (id: string) => BlockCapability | undefined;
+}
+export declare function createCapabilityRegistry(capabilities: readonly BlockCapability[]): CapabilityRegistry;
+/** The per-editor answer to "which capabilities does this block have". It depends on the editor's Block types, so it is not shared between editors. */
+export interface CapabilityIndex {
+  readonly registry: CapabilityRegistry;
+  /** Ids of the capabilities `node` has; one predicate run per capability for each node type and Block type id, kept for the index's life. */
+  of: (node: Node$1) => ReadonlySet<string>;
+  /** `read` of capability `id` for `node`; null when the block lacks the capability or it has no value. */
+  read: <Data = unknown>(node: Node$1, id: string) => Data | null;
+  /** The config the Block type of `node` gives capability `id`; undefined when absent. */
+  configOf: <C = unknown>(node: Node$1, id: string) => C | undefined;
+}
+/** Id of the Block type of `node` (its `attrs.blockType`), or null. */
+export declare const blockTypeIdOf: (node: Node$1) => string | null;
+/** `blockTypes` is read at call time, so an editor whose Block types are set after the index exists sees them. */
+export declare function createCapabilityIndex(registry: CapabilityRegistry, blockTypes?: () => readonly BlockTypeData[]): CapabilityIndex;
+/** One problem in the capabilities a Block type lists. `path` is where in the capability's config it is (empty: the capability entry itself). */
+export interface CapabilityIssue {
+  capability: string;
+  path: string;
+  message: string;
+}
+/**
+ * The problems of the capabilities `type` lists, none when it is valid: every capability is declared by a Feature (or built in),
+ * listed once, and its config passes the capability's `configSchema` (a capability without one takes no config). The one rule set
+ * behind `validateBlockTypes` (throws on the first) and `parseBlockTypes` (collects them for the whole file).
+ */
+export declare function capabilityIssues(registry: CapabilityRegistry, type: BlockTypeData): CapabilityIssue[];
+/**
+ * Checks the Block types against the registry: ids are unique and `capabilityIssues` finds nothing in any type. Throws
+ * naming the Block type and capability; `defineEditor` runs it for the Block types of the Features when an editor is created.
+ */
+export declare function validateBlockTypes(registry: CapabilityRegistry, blockTypes: readonly BlockTypeData[]): void;
+/** The capability index of `editor`: its preset's capabilities over its own Block types (the built-in capabilities and no Block types for an editor without a preset). */
+export declare function capabilityIndexOf(editor: Editor): CapabilityIndex;
+/** The capabilities `node` has in `editor`'s preset (memoised per node type and Block type id). */
+export declare const capabilitiesOf: (editor: Editor, node: Node$1) => ReadonlySet<string>;
+/** The contents or value capability `id` reads from `node` (`BlockCapability.read`); null when the block lacks the capability or holds nothing for it. */
+export declare const capabilityDataOf: <Data = unknown>(editor: Editor, node: Node$1, id: string) => Data | null;
+/** The config the Block type of `node` gives capability `id` in `editor`; undefined when the type does not list it or gives no config. */
+export declare const capabilityConfigOf: <C = unknown>(editor: Editor, node: Node$1, id: string) => C | undefined;
+/** The capabilities of the block at `pos` (the position right before it); empty when there is no node there (also outside the document). */
+export declare function capabilitiesAt(editor: Editor, pos: number): ReadonlySet<string>;
+//#endregion
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/core/capabilities.js

@@ -0,0 +1,155 @@
+import { isBlockContainer } from "./schema/node-flags.js";
+import { fail as fail$1, nodeAtPos, pathText } from "./util.js";
+import { z } from "zod";
+//#region src/core/capabilities.ts
+const fail = (message) => fail$1(message, "blockTypes");
+/** The config `type` gives capability `id`; undefined when there is no `type` (`ctx.blockTypeOf(node)` found none), it does not list the capability or lists it without config. */
+const blockTypeConfigOf = (type, id) => type?.capabilities.find((entry) => entry.id === id)?.config;
+/** Whether `type` lists capability `id`: the `appliesTo` of a capability a Block type opts into is `listsCapability(ctx.blockTypeOf(node), id)`. False without a `type`. */
+const listsCapability = (type, id) => type?.capabilities.some((entry) => entry.id === id) ?? false;
+/** The structural capabilities every editor has, derived from existing node flags. A Feature may not declare these ids. */
+const BUILT_IN_BLOCK_CAPABILITIES = [{
+	id: "container",
+	appliesTo: (node) => isBlockContainer(node),
+	configSchema: z.strictObject({
+		accepts: z.union([z.literal("all"), z.array(z.string())]).optional(),
+		nestedAfterContent: z.boolean().optional(),
+		root: z.boolean().optional()
+	})
+}, {
+	id: "title",
+	appliesTo: (node) => node.type.contentMatch.defaultType?.spec.editorChrome === true
+}];
+function createCapabilityRegistry(capabilities) {
+	const byId = new Map(capabilities.map((capability) => [capability.id, capability]));
+	return {
+		capabilities,
+		has: (id) => byId.has(id),
+		get: (id) => byId.get(id)
+	};
+}
+/** Id of the Block type of `node` (its `attrs.blockType`), or null. */
+const blockTypeIdOf = (node) => typeof node.attrs.blockType === "string" ? node.attrs.blockType : null;
+/** `blockTypes` is read at call time, so an editor whose Block types are set after the index exists sees them. */
+function createCapabilityIndex(registry, blockTypes = () => []) {
+	const memo = /* @__PURE__ */ new WeakMap();
+	const perNode = registry.capabilities.filter((capability) => capability.perNode);
+	const contextOf = (node) => {
+		const blockTypeId = blockTypeIdOf(node);
+		const blockTypeOf = (target) => {
+			const id = blockTypeIdOf(target);
+			return id === null ? null : blockTypes().find((type) => type.id === id) ?? null;
+		};
+		return {
+			blockTypeId,
+			blockTypeOf,
+			configOf: (target, capability) => blockTypeConfigOf(blockTypeOf(target), capability)
+		};
+	};
+	const of = (node) => {
+		let byBlockType = memo.get(node.type);
+		if (!byBlockType) memo.set(node.type, byBlockType = /* @__PURE__ */ new Map());
+		const blockTypeId = blockTypeIdOf(node);
+		let found = byBlockType.get(blockTypeId);
+		if (!found) {
+			const ctx = contextOf(node);
+			byBlockType.set(blockTypeId, found = new Set(registry.capabilities.filter((capability) => !capability.perNode && capability.appliesTo(node, ctx)).map((capability) => capability.id)));
+		}
+		if (!perNode.length) return found;
+		const ctx = contextOf(node);
+		const extra = perNode.filter((capability) => capability.appliesTo(node, ctx));
+		return extra.length ? /* @__PURE__ */ new Set([...found, ...extra.map((capability) => capability.id)]) : found;
+	};
+	return {
+		registry,
+		of,
+		read: (node, id) => {
+			if (!of(node).has(id)) return null;
+			return registry.get(id)?.read?.(node, contextOf(node)) ?? null;
+		},
+		configOf: (node, id) => contextOf(node).configOf(node, id)
+	};
+}
+/**
+* The problems of the capabilities `type` lists, none when it is valid: every capability is declared by a Feature (or built in),
+* listed once, and its config passes the capability's `configSchema` (a capability without one takes no config). The one rule set
+* behind `validateBlockTypes` (throws on the first) and `parseBlockTypes` (collects them for the whole file).
+*/
+function capabilityIssues(registry, type) {
+	const issues = [];
+	const listed = /* @__PURE__ */ new Set();
+	for (const { id, config } of type.capabilities) {
+		const capability = registry.get(id);
+		if (!capability) {
+			issues.push({
+				capability: id,
+				path: "",
+				message: `unknown capability; no feature declares it (known: ${registry.capabilities.map((known) => known.id).join(", ")})`
+			});
+			continue;
+		}
+		if (listed.has(id)) {
+			issues.push({
+				capability: id,
+				path: "",
+				message: "listed twice"
+			});
+			continue;
+		}
+		listed.add(id);
+		if (!capability.configSchema) {
+			if (config !== void 0) issues.push({
+				capability: id,
+				path: "",
+				message: "the capability takes no config"
+			});
+			continue;
+		}
+		const checked = capability.configSchema.safeParse(config ?? {});
+		if (!checked.success) for (const issue of checked.error.issues) issues.push({
+			capability: id,
+			path: pathText(issue.path),
+			message: issue.message
+		});
+	}
+	return issues;
+}
+/**
+* Checks the Block types against the registry: ids are unique and `capabilityIssues` finds nothing in any type. Throws
+* naming the Block type and capability; `defineEditor` runs it for the Block types of the Features when an editor is created.
+*/
+function validateBlockTypes(registry, blockTypes) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const type of blockTypes) {
+		if (seen.has(type.id)) fail(`the Block type "${type.id}" is defined twice`);
+		seen.add(type.id);
+		const [issue] = capabilityIssues(registry, type);
+		if (issue) fail(`the Block type "${type.id}", capability "${issue.capability}"${issue.path ? `, config ${issue.path}` : ""}: ${issue.message}`);
+	}
+}
+const BUILT_IN_REGISTRY = createCapabilityRegistry(BUILT_IN_BLOCK_CAPABILITIES);
+const INDEXES = /* @__PURE__ */ new WeakMap();
+/** The capability index of `editor`: its preset's capabilities over its own Block types (the built-in capabilities and no Block types for an editor without a preset). */
+function capabilityIndexOf(editor) {
+	let index = INDEXES.get(editor);
+	if (!index) {
+		const preset = editor.storage.editorPreset;
+		INDEXES.set(editor, index = createCapabilityIndex(preset?.capabilities ?? BUILT_IN_REGISTRY, () => preset?.blockTypes?.(editor) ?? []));
+	}
+	return index;
+}
+/** The capabilities `node` has in `editor`'s preset (memoised per node type and Block type id). */
+const capabilitiesOf = (editor, node) => capabilityIndexOf(editor).of(node);
+/** The contents or value capability `id` reads from `node` (`BlockCapability.read`); null when the block lacks the capability or holds nothing for it. */
+const capabilityDataOf = (editor, node, id) => capabilityIndexOf(editor).read(node, id);
+/** The config the Block type of `node` gives capability `id` in `editor`; undefined when the type does not list it or gives no config. */
+const capabilityConfigOf = (editor, node, id) => capabilityIndexOf(editor).configOf(node, id);
+/** The capabilities of the block at `pos` (the position right before it); empty when there is no node there (also outside the document). */
+function capabilitiesAt(editor, pos) {
+	const node = nodeAtPos(editor.state.doc, pos);
+	return node ? capabilitiesOf(editor, node) : /* @__PURE__ */ new Set();
+}
+//#endregion
+export { BUILT_IN_BLOCK_CAPABILITIES, blockTypeConfigOf, blockTypeIdOf, capabilitiesAt, capabilitiesOf, capabilityConfigOf, capabilityDataOf, capabilityIndexOf, capabilityIssues, createCapabilityIndex, createCapabilityRegistry, listsCapability, validateBlockTypes };
+
+//# sourceMappingURL=capabilities.js.map

package/dist/core/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","names":["failWith"],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { Node as PMNode, NodeType } from '@tiptap/pm/model'\nimport { z, type ZodType } from 'zod'\nimport { isBlockContainer } from './schema/node-flags'\nimport { fail as failWith, nodeAtPos, pathText } from './util'\n// The `editorPreset` storage augmentation of `Storage`, read by `capabilityIndexOf`.\nimport type {} from './pipeline'\n\n// Framework-free and server-importable. A block capability describes what a block is (\"has a container body\", \"has\n// a title row\", \"may keep a source\"); an ability (`./schema/abilities`) says what the user may do. Capabilities describe,\n// abilities permit. A capability is type-level: \"this Block type supports X\". What a block actually holds (its source\n// child, its basket, its bibliography record) is Block contents or a Block property, read through `read`, never `appliesTo`.\n\nconst fail = (message: string): never => failWith(message, 'blockTypes')\n\n/** One capability a Block type lists, with the config the capability's `configSchema` validates. Plain JSON. */\nexport interface BlockTypeCapability {\n  id: string\n  config?: unknown\n}\n\n/** What the capability registry knows of a Block type: its id and the capabilities it lists. The public `BlockType` extends it with presentation. */\nexport interface BlockTypeData {\n  id: string\n  capabilities: readonly BlockTypeCapability[]\n}\n\n/** What a capability predicate may read besides the node. */\nexport interface CapabilityContext {\n  /** The id of the node's Block type: its persisted `attrs.blockType`; null for a node without one. */\n  blockTypeId: string | null\n  /** The Block type of `node` among the editor's Block types; null for a node without one, an id no Block type defines, or an editor without Block types. */\n  blockTypeOf: (node: PMNode) => BlockTypeData | null\n  /** The config the Block type of `node` gives `capability`; undefined when the type does not list it or lists it without config. */\n  configOf: <C = unknown>(node: PMNode, capability: string) => C | undefined\n}\n\n/** The config `type` gives capability `id`; undefined when there is no `type` (`ctx.blockTypeOf(node)` found none), it does not list the capability or lists it without config. */\nexport const blockTypeConfigOf = <C = unknown>(type: BlockTypeData | null | undefined, id: string): C | undefined =>\n  type?.capabilities.find(entry => entry.id === id)?.config as C | undefined\n\n/** Whether `type` lists capability `id`: the `appliesTo` of a capability a Block type opts into is `listsCapability(ctx.blockTypeOf(node), id)`. False without a `type`. */\nexport const listsCapability = (type: BlockTypeData | null | undefined, id: string): boolean =>\n  type?.capabilities.some(entry => entry.id === id) ?? false\n\n/**\n * A descriptor a Feature declares through `EditorFeature.blockCapabilities`: whether a block has the capability, where its\n * data lives and how to read it. It never installs schema, extensions, node views or settings; the Feature that owns the mechanism does.\n */\nexport interface BlockCapability {\n  /** Unique across the preset (`container`, `title` are built in); a `BlockAction.requires` entry and a Block type's `capabilities` name it. */\n  id: string\n  /**\n   * Whether `node` has the capability. The result is memoised per node type and Block type id (`capabilitiesOf`), so it may\n   * read only the node type (its spec and flags), `ctx.blockTypeId` and the Block type's config (`ctx.configOf`), never other\n   * attributes or the content; a capability that must read node attributes sets `perNode`.\n   */\n  appliesTo: (node: PMNode, ctx: CapabilityContext) => boolean\n  /**\n   * `appliesTo` reads attributes of the node itself (`derived`: `meta.derivation` is present), so it runs for every node instead of\n   * once per node type and Block type id. Keep such predicates to a constant-time attribute check.\n   */\n  perNode?: boolean\n  /** Validates the config a Block type gives the capability. Absent: the capability takes no config and a Block type may not give one. */\n  configSchema?: ZodType\n  /**\n   * The current contents or value of the capability in `node` (the source media child, the basket id, the bibliography\n   * record); null when the block has none. Called only for blocks that have the capability; not memoised.\n   */\n  read?: (node: PMNode, ctx: CapabilityContext) => unknown\n  /** Where the capability's data lives, so conversion, Markdown and copy can treat it uniformly. Descriptive only. */\n  storage?: {\n    /** Keys of the node's `meta` attribute. */\n    metaKeys?: readonly string[]\n    /** Node type names of the children that hold the data. */\n    childTypes?: readonly string[]\n  }\n}\n\n/** The structural capabilities every editor has, derived from existing node flags. A Feature may not declare these ids. */\nexport const BUILT_IN_BLOCK_CAPABILITIES: readonly BlockCapability[] = [\n  // `editorBlockContainer`: the node holds Blocks of its own (`doc`, a Typed block). Config `accepts`: the Block types it accepts as\n  // nested Typed blocks; `nestedAfterContent`: nested Typed blocks follow the own content, also after a merge; `root`: the Block type\n  // stands for the file of a document tree (the store's document rows), so the tree takes it as the root's kind.\n  {\n    id: 'container',\n    appliesTo: node => isBlockContainer(node),\n    configSchema: z.strictObject({ accepts: z.union([z.literal('all'), z.array(z.string())]).optional(), nestedAfterContent: z.boolean().optional(), root: z.boolean().optional() }),\n  },\n  // The node type's content starts with chrome (`editorChrome`): the title row of a Typed block. Read from the type, not\n  // the content, so the memo per node type stays correct.\n  { id: 'title', appliesTo: node => node.type.contentMatch.defaultType?.spec.editorChrome === true },\n]\n\n/** The merged capabilities of a preset: the declarations, shared by every editor created from it. */\nexport interface CapabilityRegistry {\n  /** Built-in capabilities first, then the Features' in feature order. */\n  readonly capabilities: readonly BlockCapability[]\n  has: (id: string) => boolean\n  get: (id: string) => BlockCapability | undefined\n}\n\nexport function createCapabilityRegistry(capabilities: readonly BlockCapability[]): CapabilityRegistry {\n  const byId = new Map(capabilities.map(capability => [capability.id, capability]))\n  return { capabilities, has: id => byId.has(id), get: id => byId.get(id) }\n}\n\n/** The per-editor answer to \"which capabilities does this block have\". It depends on the editor's Block types, so it is not shared between editors. */\nexport interface CapabilityIndex {\n  readonly registry: CapabilityRegistry\n  /** Ids of the capabilities `node` has; one predicate run per capability for each node type and Block type id, kept for the index's life. */\n  of: (node: PMNode) => ReadonlySet<string>\n  /** `read` of capability `id` for `node`; null when the block lacks the capability or it has no value. */\n  read: <Data = unknown>(node: PMNode, id: string) => Data | null\n  /** The config the Block type of `node` gives capability `id`; undefined when absent. */\n  configOf: <C = unknown>(node: PMNode, id: string) => C | undefined\n}\n\n/** Id of the Block type of `node` (its `attrs.blockType`), or null. */\nexport const blockTypeIdOf = (node: PMNode): string | null => typeof node.attrs.blockType === 'string' ? node.attrs.blockType : null\n\n/** `blockTypes` is read at call time, so an editor whose Block types are set after the index exists sees them. */\nexport function createCapabilityIndex(registry: CapabilityRegistry, blockTypes: () => readonly BlockTypeData[] = () => []): CapabilityIndex {\n  const memo = new WeakMap<NodeType, Map<string | null, ReadonlySet<string>>>()\n  const perNode = registry.capabilities.filter(capability => capability.perNode)\n  const contextOf = (node: PMNode): CapabilityContext => {\n    const blockTypeId = blockTypeIdOf(node)\n    const blockTypeOf = (target: PMNode): BlockTypeData | null => {\n      const id = blockTypeIdOf(target)\n      return id === null ? null : blockTypes().find(type => type.id === id) ?? null\n    }\n    return {\n      blockTypeId,\n      blockTypeOf,\n      configOf: <C>(target: PMNode, capability: string) => blockTypeConfigOf<C>(blockTypeOf(target), capability),\n    }\n  }\n  const of = (node: PMNode): ReadonlySet<string> => {\n    let byBlockType = memo.get(node.type)\n    if (!byBlockType) memo.set(node.type, byBlockType = new Map())\n    const blockTypeId = blockTypeIdOf(node)\n    let found = byBlockType.get(blockTypeId)\n    if (!found) {\n      const ctx = contextOf(node)\n      byBlockType.set(blockTypeId, found = new Set(registry.capabilities.filter(capability => !capability.perNode && capability.appliesTo(node, ctx)).map(capability => capability.id)))\n    }\n    if (!perNode.length) return found\n    const ctx = contextOf(node)\n    const extra = perNode.filter(capability => capability.appliesTo(node, ctx))\n    return extra.length ? new Set([...found, ...extra.map(capability => capability.id)]) : found\n  }\n  return {\n    registry,\n    of,\n    read: <Data>(node: PMNode, id: string) => {\n      if (!of(node).has(id)) return null\n      return (registry.get(id)?.read?.(node, contextOf(node)) ?? null) as Data | null\n    },\n    configOf: <C>(node: PMNode, id: string) => contextOf(node).configOf<C>(node, id),\n  }\n}\n\n/** One problem in the capabilities a Block type lists. `path` is where in the capability's config it is (empty: the capability entry itself). */\nexport interface CapabilityIssue {\n  capability: string\n  path: string\n  message: string\n}\n\n// i18n-ignore-start: developer-facing errors of a Block type list\n/**\n * The problems of the capabilities `type` lists, none when it is valid: every capability is declared by a Feature (or built in),\n * listed once, and its config passes the capability's `configSchema` (a capability without one takes no config). The one rule set\n * behind `validateBlockTypes` (throws on the first) and `parseBlockTypes` (collects them for the whole file).\n */\nexport function capabilityIssues(registry: CapabilityRegistry, type: BlockTypeData): CapabilityIssue[] {\n  const issues: CapabilityIssue[] = []\n  const listed = new Set<string>()\n  for (const { id, config } of type.capabilities) {\n    const capability = registry.get(id)\n    if (!capability) {\n      issues.push({ capability: id, path: '', message: `unknown capability; no feature declares it (known: ${registry.capabilities.map(known => known.id).join(', ')})` })\n      continue\n    }\n    if (listed.has(id)) {\n      issues.push({ capability: id, path: '', message: 'listed twice' })\n      continue\n    }\n    listed.add(id)\n    if (!capability.configSchema) {\n      if (config !== undefined) issues.push({ capability: id, path: '', message: 'the capability takes no config' })\n      continue\n    }\n    const checked = capability.configSchema.safeParse(config ?? {})\n    if (!checked.success) for (const issue of checked.error.issues) issues.push({ capability: id, path: pathText(issue.path), message: issue.message })\n  }\n  return issues\n}\n\n/**\n * Checks the Block types against the registry: ids are unique and `capabilityIssues` finds nothing in any type. Throws\n * naming the Block type and capability; `defineEditor` runs it for the Block types of the Features when an editor is created.\n */\nexport function validateBlockTypes(registry: CapabilityRegistry, blockTypes: readonly BlockTypeData[]): void {\n  const seen = new Set<string>()\n  for (const type of blockTypes) {\n    if (seen.has(type.id)) fail(`the Block type \"${type.id}\" is defined twice`)\n    seen.add(type.id)\n    const [issue] = capabilityIssues(registry, type)\n    if (issue) fail(`the Block type \"${type.id}\", capability \"${issue.capability}\"${issue.path ? `, config ${issue.path}` : ''}: ${issue.message}`)\n  }\n}\n// i18n-ignore-end\n\nconst BUILT_IN_REGISTRY = createCapabilityRegistry(BUILT_IN_BLOCK_CAPABILITIES)\nconst INDEXES = new WeakMap<Editor, CapabilityIndex>()\n\n/** The capability index of `editor`: its preset's capabilities over its own Block types (the built-in capabilities and no Block types for an editor without a preset). */\nexport function capabilityIndexOf(editor: Editor): CapabilityIndex {\n  let index = INDEXES.get(editor)\n  if (!index) {\n    const preset = editor.storage.editorPreset\n    INDEXES.set(editor, index = createCapabilityIndex(preset?.capabilities ?? BUILT_IN_REGISTRY, () => preset?.blockTypes?.(editor) ?? []))\n  }\n  return index\n}\n\n/** The capabilities `node` has in `editor`'s preset (memoised per node type and Block type id). */\nexport const capabilitiesOf = (editor: Editor, node: PMNode): ReadonlySet<string> => capabilityIndexOf(editor).of(node)\n\n/** The contents or value capability `id` reads from `node` (`BlockCapability.read`); null when the block lacks the capability or holds nothing for it. */\nexport const capabilityDataOf = <Data = unknown>(editor: Editor, node: PMNode, id: string): Data | null => capabilityIndexOf(editor).read<Data>(node, id)\n\n/** The config the Block type of `node` gives capability `id` in `editor`; undefined when the type does not list it or gives no config. */\nexport const capabilityConfigOf = <C = unknown>(editor: Editor, node: PMNode, id: string): C | undefined => capabilityIndexOf(editor).configOf<C>(node, id)\n\n/** The capabilities of the block at `pos` (the position right before it); empty when there is no node there (also outside the document). */\nexport function capabilitiesAt(editor: Editor, pos: number): ReadonlySet<string> {\n  const node = nodeAtPos(editor.state.doc, pos)\n  return node ? capabilitiesOf(editor, node) : new Set()\n}\n"],"mappings":"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"}

package/dist/core/command-types.d.ts

@@ -78,7 +78,7 @@ export interface PlacedToolbarGroup<C = unknown> extends ToolbarGroupDef {
 }
 /**
  * Checks whether `creates` may be inserted into the ancestor that `canCreateAt` found: `$parent.parent` is the node
- * that would receive it. Features contribute guards (`EditorFeature.insertGuards`), e.g. the accepted children of a Baustein.
+ * that would receive it. Features contribute guards (`EditorFeature.insertGuards`), e.g. the accepted children of a Typed block.
  */
 export type InsertGuard = (editor: Editor, $parent: ResolvedPos, creates: Creates) => boolean;
 /**

package/dist/core/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/core/context.ts"],"sourcesContent":["import type { EditorPublicConfig } from '../config'\nimport { createTranslator, DEFAULT_LOCALE, type Locale, type Messages, type Translate } from '../i18n'\nimport { type EditorSettings, parseEditorSettings } from '../settings'\nimport { BackendError, type EditorBackend } from './backend'\nimport { createFetchBackend } from './http-backend'\nimport { type Notifier, silentNotifier } from './notify'\nimport { createStore, type ReadonlyStore, type Store } from './store'\n\nconst STORAGE_KEY = 'tiptap-editor:settings'\n/** Pause after the last change before the settings are sent to the server (ms). */\nconst PUT_DEBOUNCE = 500\n\n/** Inert public AI configuration (set by the Nuxt client plugin); only the AI feature reads it. Defined with the public config view. */\nexport type EditorAiConfig = EditorPublicConfig['ai']\n\nexport interface EditorContextOptions {\n  /**\n   * Where documents, uploads, mention lookups, settings, themes and AI come from (default: the HTTP routes of the Nuxt\n   * module over the platform `fetch`, `createFetchBackend`). A backend that offers `settings` keeps the settings per\n   * account (`backend.settings`); without it they stay in this browser.\n   */\n  backend?: EditorBackend\n  ai?: EditorAiConfig\n  /** Shows app-level notices (e.g. model profiles); default: dropped (`silentNotifier`). */\n  notify?: Notifier\n  /** Language of every string the editor renders (toolbar, slash menu, settings, AI, notices); default `'de'`. Fixed for the life of the context. */\n  locale?: Locale\n  /** Overrides of single messages by key (`{ 'toolbar.bold': 'Strong' }`); the rest comes from the catalog of `locale`. */\n  messages?: Partial<Messages>\n}\n\n/** What `createEditorContext` returns: shared by all editors of an app. One per app: there is no process-global state. */\nexport interface EditorContext {\n  settings: Store<EditorSettings>\n  /** True once the stored settings are usable: immediately in local mode, after the server answered in remote mode. */\n  ready: ReadonlyStore<boolean>\n  /** True once the account's settings from the server are in effect (always false in local mode). */\n  synced: ReadonlyStore<boolean>\n  /**\n   * Starts the account-settings load of remote mode (idempotent, no-op in local mode). The framework layers'\n   * settings hooks call it, so the server is asked only once an editor-side component needs the settings (not on a\n   * login page).\n   */\n  load: () => void\n  backend: EditorBackend\n  ai: EditorAiConfig | undefined\n  /** Notices of app-level models; surfaces hand features their own `FeatureContext.notify`. */\n  notify: Notifier\n  /** The language of the editor's strings (`options.locale`, default `'de'`). */\n  locale: Locale\n  /** Renders a message of the catalog (with the host's `messages` applied): `t('toolbar.bold')`, `t('ai.run', { task })`. */\n  t: Translate\n  /** Stops the persistence (store subscription and pending server write); call when the app goes away. */\n  dispose: () => void\n}\n\nfunction readLocal(): EditorSettings {\n  try {\n    // Also migrates the flat `{ headingConversionScope }` of the per-browser settings before version 1.\n    return parseEditorSettings(JSON.parse(localStorage.getItem(STORAGE_KEY) ?? 'null'))\n  }\n  catch {\n    // Unreadable or corrupt (or no) storage: the defaults.\n    return parseEditorSettings(null)\n  }\n}\n\nfunction writeLocal(settings: EditorSettings) {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(settings))\n  }\n  catch {\n    // Storage unavailable (e.g. privacy mode): the settings last for this session only.\n  }\n}\n\n/**\n * The editor context of an app: the settings shared by all editors of the app, and the backend. Framework-free;\n * the Vue layer installs it with `app.use(createEditor())`, the React layer provides it through\n * `EditorContextProvider`. The settings are read from localStorage right away (client only) and every change is\n * written back. With a backend that offers `settings`, `backend.settings.load()` (on `load()`, which\n * the settings hooks call) answers: the user's account settings replace them (`synced`), `null` (the account has none\n * yet) makes the account take this browser's, a refusal (`401`, `501`) or a network error keeps the local ones; once\n * synced every change is also sent to the backend (`save`, debounced). Subscription and timer stop with `dispose()`.\n */\nexport function createEditorContext(options: EditorContextOptions = {}): EditorContext {\n  const backend = options.backend ?? createFetchBackend()\n  // `let`: a probing backend (`backend.ready`) may drop `settings` before the first load.\n  let remoteStore = backend.settings\n  const remoteMode = remoteStore !== undefined\n  const settings = createStore<EditorSettings>(parseEditorSettings(null))\n  const ready = createStore(!remoteMode && backend.ready === undefined)\n  const synced = createStore(false)\n  let loading = false\n  let loadRemote = () => {}\n  const load = () => {\n    if (loading) return\n    loading = true\n    loadRemote()\n  }\n  let dispose = () => {}\n  const locale = options.locale ?? DEFAULT_LOCALE\n  const t = createTranslator(locale, options.messages)\n  const context: EditorContext = { settings, ready, synced, load, backend, ai: options.ai, notify: options.notify ?? silentNotifier, locale, t, dispose: () => dispose() }\n  // Local mode: ready once the backend knows its capabilities (remote mode: after the settings load, which waits for it).\n  if (!remoteMode) void backend.ready?.then(() => ready.set(true))\n  // No browser storage (server render): defaults, nothing to persist.\n  if (!('window' in globalThis)) return context\n\n  settings.set(readLocal())\n  writeLocal(settings.get())\n\n  /** JSON of the settings the server holds, so values that came from it are not sent back. */\n  let remote = ''\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let active = true\n  function push(value: EditorSettings) {\n    clearTimeout(timer)\n    timer = setTimeout(() => {\n      const json = JSON.stringify(value)\n      if (json === remote) return\n      remoteStore?.save(value)\n        .then(() => { remote = json })\n        .catch((error: unknown) => {\n          // 501/404: the host serves no settings (no `settings` port, so no route); nothing to report.\n          if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) {\n            console.warn(`tiptap-editor: ${t('settings.saveFailed')}`, error)\n          }\n        })\n    }, PUT_DEBOUNCE)\n  }\n\n  const unsubscribe = settings.subscribe((value) => {\n    writeLocal(value)\n    if (synced.get()) push(value)\n  })\n  dispose = () => {\n    active = false\n    clearTimeout(timer)\n    unsubscribe()\n  }\n\n  if (!remoteStore) return context\n  loadRemote = () => Promise.resolve(backend.ready)\n    .then(() => {\n      remoteStore = backend.settings\n      return remoteStore?.load()\n    })\n    .then((stored) => {\n      // The probe dropped `settings` (the server keeps none): the account has no settings, the local ones stay.\n      if (!active || !remoteStore) return\n      synced.set(true)\n      if (stored) {\n        settings.set(parseEditorSettings(stored))\n        remote = JSON.stringify(settings.get())\n      }\n      // The account has no settings yet: it takes this browser's.\n      else push(settings.get())\n    })\n    .catch((error: unknown) => {\n      // 501/404: the host serves no settings; the local ones stay and there is nothing to report.\n      if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) {\n        console.warn(`tiptap-editor: ${t('settings.loadFailed')}`, error)\n      }\n    })\n    .finally(() => { ready.set(true) })\n  return context\n}\n"],"mappings":";;;;;;;AAQA,MAAM,cAAc;;AAEpB,MAAM,eAAe;AA8CrB,SAAS,YAA4B;CACnC,IAAI;EAEF,OAAO,oBAAoB,KAAK,MAAM,aAAa,QAAQ,WAAW,KAAK,MAAM,CAAC;CACpF,QACM;EAEJ,OAAO,oBAAoB,IAAI;CACjC;AACF;AAEA,SAAS,WAAW,UAA0B;CAC5C,IAAI;EACF,aAAa,QAAQ,aAAa,KAAK,UAAU,QAAQ,CAAC;CAC5D,QACM,CAEN;AACF;;;;;;;;;;AAWA,SAAgB,oBAAoB,UAAgC,CAAC,GAAkB;CACrF,MAAM,UAAU,QAAQ,WAAW,mBAAmB;CAEtD,IAAI,cAAc,QAAQ;CAC1B,MAAM,aAAa,gBAAgB,KAAA;CACnC,MAAM,WAAW,YAA4B,oBAAoB,IAAI,CAAC;CACtE,MAAM,QAAQ,YAAY,CAAC,cAAc,QAAQ,UAAU,KAAA,CAAS;CACpE,MAAM,SAAS,YAAY,KAAK;CAChC,IAAI,UAAU;CACd,IAAI,mBAAmB,CAAC;CACxB,MAAM,aAAa;EACjB,IAAI,SAAS;EACb,UAAU;EACV,WAAW;CACb;CACA,IAAI,gBAAgB,CAAC;CACrB,MAAM,SAAS,QAAQ,UAAA;CACvB,MAAM,IAAI,iBAAiB,QAAQ,QAAQ,QAAQ;CACnD,MAAM,UAAyB;EAAE;EAAU;EAAO;EAAQ;EAAM;EAAS,IAAI,QAAQ;EAAI,QAAQ,QAAQ,UAAU;EAAgB;EAAQ;EAAG,eAAe,QAAQ;CAAE;CAEvK,IAAI,CAAC,YAAY,QAAa,OAAO,WAAW,MAAM,IAAI,IAAI,CAAC;CAE/D,IAAI,EAAE,YAAY,aAAa,OAAO;CAEtC,SAAS,IAAI,UAAU,CAAC;CACxB,WAAW,SAAS,IAAI,CAAC;;CAGzB,IAAI,SAAS;CACb,IAAI;CACJ,IAAI,SAAS;CACb,SAAS,KAAK,OAAuB;EACnC,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,MAAM,OAAO,KAAK,UAAU,KAAK;GACjC,IAAI,SAAS,QAAQ;GACrB,aAAa,KAAK,KAAK,CAAC,CACrB,WAAW;IAAE,SAAS;GAAK,CAAC,CAAC,CAC7B,OAAO,UAAmB;IAEzB,IAAI,EAAE,iBAAiB,iBAAiB,MAAM,WAAW,OAAO,MAAM,WAAW,OAC/E,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;GAEpE,CAAC;EACL,GAAG,YAAY;CACjB;CAEA,MAAM,cAAc,SAAS,WAAW,UAAU;EAChD,WAAW,KAAK;EAChB,IAAI,OAAO,IAAI,GAAG,KAAK,KAAK;CAC9B,CAAC;CACD,gBAAgB;EACd,SAAS;EACT,aAAa,KAAK;EAClB,YAAY;CACd;CAEA,IAAI,CAAC,aAAa,OAAO;CACzB,mBAAmB,QAAQ,QAAQ,QAAQ,KAAK,CAAC,CAC9C,WAAW;EACV,cAAc,QAAQ;EACtB,OAAO,aAAa,KAAK;CAC3B,CAAC,CAAC,CACD,MAAM,WAAW;EAEhB,IAAI,CAAC,UAAU,CAAC,aAAa;EAC7B,OAAO,IAAI,IAAI;EACf,IAAI,QAAQ;GACV,SAAS,IAAI,oBAAoB,MAAM,CAAC;GACxC,SAAS,KAAK,UAAU,SAAS,IAAI,CAAC;EACxC,OAEK,KAAK,SAAS,IAAI,CAAC;CAC1B,CAAC,CAAC,CACD,OAAO,UAAmB;EAEzB,IAAI,EAAE,iBAAiB,iBAAiB,MAAM,WAAW,OAAO,MAAM,WAAW,OAC/E,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;CAEpE,CAAC,CAAC,CACD,cAAc;EAAE,MAAM,IAAI,IAAI;CAAE,CAAC;CACpC,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/core/context.ts"],"sourcesContent":["import type { EditorPublicConfig } from '../config'\nimport { createTranslator, DEFAULT_LOCALE, type Locale, type Messages, type Translate } from '../i18n'\nimport { type EditorSettings, parseEditorSettings } from '../settings'\nimport { BackendError, type EditorBackend } from './backend'\nimport { createFetchBackend } from './http-backend'\nimport { type Notifier, silentNotifier } from './notify'\nimport { createStore, type ReadonlyStore, type Store } from './store'\n\nconst STORAGE_KEY = 'tiptap-editor:settings'\n/** Pause after the last change before the settings are sent to the server (ms). */\nconst PUT_DEBOUNCE = 500\n\n/** Inert public AI configuration (set by the Nuxt client plugin); only the AI feature reads it. Defined with the public config view. */\nexport type EditorAiConfig = EditorPublicConfig['ai']\n\nexport interface EditorContextOptions {\n  /**\n   * Where documents, uploads, mention lookups, settings, themes and AI come from (default: the HTTP routes of the Nuxt\n   * module over the platform `fetch`, `createFetchBackend`). A backend that offers `settings` keeps the settings per\n   * account (`backend.settings`); without it they stay in this browser.\n   */\n  backend?: EditorBackend\n  ai?: EditorAiConfig\n  /** Shows app-level notices (e.g. model profiles); default: dropped (`silentNotifier`). */\n  notify?: Notifier\n  /** Language of every string the editor renders (toolbar, slash menu, settings, AI, notices); default `'de'`. Fixed for the life of the context. */\n  locale?: Locale\n  /** Overrides of single messages by key (`{ 'toolbar.bold': 'Strong' }`); the rest comes from the catalog of `locale`. */\n  messages?: Partial<Messages>\n}\n\n/** What `createEditorContext` returns: shared by all editors of an app. One per app: there is no process-global state. */\nexport interface EditorContext {\n  settings: Store<EditorSettings>\n  /** True once the stored settings are usable: immediately in local mode, after the server answered in remote mode. */\n  ready: ReadonlyStore<boolean>\n  /** True once the account's settings from the server are in effect (always false in local mode). */\n  synced: ReadonlyStore<boolean>\n  /**\n   * Starts the account-settings load of remote mode (idempotent, no-op in local mode). The framework layers'\n   * settings hooks call it, so the server is asked only once an editor-side component needs the settings (not on a\n   * login page).\n   */\n  load: () => void\n  backend: EditorBackend\n  ai: EditorAiConfig | undefined\n  /** Notices of app-level models; surfaces hand features their own `FeatureContext.notify`. */\n  notify: Notifier\n  /** The language of the editor's strings (`options.locale`, default `'de'`). */\n  locale: Locale\n  /** Renders a message of the catalog (with the host's `messages` applied): `t('toolbar.bold')`, `t('ai.run', { task })`. */\n  t: Translate\n  /** Stops the persistence (store subscription and pending server write); call when the app goes away. */\n  dispose: () => void\n}\n\nfunction readLocal(): EditorSettings {\n  try {\n    // Also migrates the flat `{ headingConversionScope }` of the per-browser settings before version 1 and the key\n    // names before version 2; `createEditorContext` writes the result back right away, so an older record is rewritten once.\n    return parseEditorSettings(JSON.parse(localStorage.getItem(STORAGE_KEY) ?? 'null'))\n  }\n  catch {\n    // Unreadable or corrupt (or no) storage: the defaults.\n    return parseEditorSettings(null)\n  }\n}\n\nfunction writeLocal(settings: EditorSettings) {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(settings))\n  }\n  catch {\n    // Storage unavailable (e.g. privacy mode): the settings last for this session only.\n  }\n}\n\n/**\n * The editor context of an app: the settings shared by all editors of the app, and the backend. Framework-free;\n * the Vue layer installs it with `app.use(createEditor())`, the React layer provides it through\n * `EditorContextProvider`. The settings are read from localStorage right away (client only) and every change is\n * written back. With a backend that offers `settings`, `backend.settings.load()` (on `load()`, which\n * the settings hooks call) answers: the user's account settings replace them (`synced`), `null` (the account has none\n * yet) makes the account take this browser's, a refusal (`401`, `501`) or a network error keeps the local ones; once\n * synced every change is also sent to the backend (`save`, debounced). Subscription and timer stop with `dispose()`.\n */\nexport function createEditorContext(options: EditorContextOptions = {}): EditorContext {\n  const backend = options.backend ?? createFetchBackend()\n  // `let`: a probing backend (`backend.ready`) may drop `settings` before the first load.\n  let remoteStore = backend.settings\n  const remoteMode = remoteStore !== undefined\n  const settings = createStore<EditorSettings>(parseEditorSettings(null))\n  const ready = createStore(!remoteMode && backend.ready === undefined)\n  const synced = createStore(false)\n  let loading = false\n  let loadRemote = () => {}\n  const load = () => {\n    if (loading) return\n    loading = true\n    loadRemote()\n  }\n  let dispose = () => {}\n  const locale = options.locale ?? DEFAULT_LOCALE\n  const t = createTranslator(locale, options.messages)\n  const context: EditorContext = { settings, ready, synced, load, backend, ai: options.ai, notify: options.notify ?? silentNotifier, locale, t, dispose: () => dispose() }\n  // Local mode: ready once the backend knows its capabilities (remote mode: after the settings load, which waits for it).\n  if (!remoteMode) void backend.ready?.then(() => ready.set(true))\n  // No browser storage (server render): defaults, nothing to persist.\n  if (!('window' in globalThis)) return context\n\n  settings.set(readLocal())\n  writeLocal(settings.get())\n\n  /** JSON of the settings the server holds, so values that came from it are not sent back. */\n  let remote = ''\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let active = true\n  function push(value: EditorSettings) {\n    clearTimeout(timer)\n    timer = setTimeout(() => {\n      const json = JSON.stringify(value)\n      if (json === remote) return\n      remoteStore?.save(value)\n        .then(() => { remote = json })\n        .catch((error: unknown) => {\n          // 501/404: the host serves no settings (no `settings` port, so no route); nothing to report.\n          if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) {\n            console.warn(`tiptap-editor: ${t('settings.saveFailed')}`, error)\n          }\n        })\n    }, PUT_DEBOUNCE)\n  }\n\n  const unsubscribe = settings.subscribe((value) => {\n    writeLocal(value)\n    if (synced.get()) push(value)\n  })\n  dispose = () => {\n    active = false\n    clearTimeout(timer)\n    unsubscribe()\n  }\n\n  if (!remoteStore) return context\n  loadRemote = () => Promise.resolve(backend.ready)\n    .then(() => {\n      remoteStore = backend.settings\n      return remoteStore?.load()\n    })\n    .then((stored) => {\n      // The probe dropped `settings` (the server keeps none): the account has no settings, the local ones stay.\n      if (!active || !remoteStore) return\n      synced.set(true)\n      if (stored) {\n        settings.set(parseEditorSettings(stored))\n        remote = JSON.stringify(settings.get())\n      }\n      // The account has no settings yet: it takes this browser's.\n      else push(settings.get())\n    })\n    .catch((error: unknown) => {\n      // 501/404: the host serves no settings; the local ones stay and there is nothing to report.\n      if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) {\n        console.warn(`tiptap-editor: ${t('settings.loadFailed')}`, error)\n      }\n    })\n    .finally(() => { ready.set(true) })\n  return context\n}\n"],"mappings":";;;;;;;AAQA,MAAM,cAAc;;AAEpB,MAAM,eAAe;AA8CrB,SAAS,YAA4B;CACnC,IAAI;EAGF,OAAO,oBAAoB,KAAK,MAAM,aAAa,QAAQ,WAAW,KAAK,MAAM,CAAC;CACpF,QACM;EAEJ,OAAO,oBAAoB,IAAI;CACjC;AACF;AAEA,SAAS,WAAW,UAA0B;CAC5C,IAAI;EACF,aAAa,QAAQ,aAAa,KAAK,UAAU,QAAQ,CAAC;CAC5D,QACM,CAEN;AACF;;;;;;;;;;AAWA,SAAgB,oBAAoB,UAAgC,CAAC,GAAkB;CACrF,MAAM,UAAU,QAAQ,WAAW,mBAAmB;CAEtD,IAAI,cAAc,QAAQ;CAC1B,MAAM,aAAa,gBAAgB,KAAA;CACnC,MAAM,WAAW,YAA4B,oBAAoB,IAAI,CAAC;CACtE,MAAM,QAAQ,YAAY,CAAC,cAAc,QAAQ,UAAU,KAAA,CAAS;CACpE,MAAM,SAAS,YAAY,KAAK;CAChC,IAAI,UAAU;CACd,IAAI,mBAAmB,CAAC;CACxB,MAAM,aAAa;EACjB,IAAI,SAAS;EACb,UAAU;EACV,WAAW;CACb;CACA,IAAI,gBAAgB,CAAC;CACrB,MAAM,SAAS,QAAQ,UAAA;CACvB,MAAM,IAAI,iBAAiB,QAAQ,QAAQ,QAAQ;CACnD,MAAM,UAAyB;EAAE;EAAU;EAAO;EAAQ;EAAM;EAAS,IAAI,QAAQ;EAAI,QAAQ,QAAQ,UAAU;EAAgB;EAAQ;EAAG,eAAe,QAAQ;CAAE;CAEvK,IAAI,CAAC,YAAY,QAAa,OAAO,WAAW,MAAM,IAAI,IAAI,CAAC;CAE/D,IAAI,EAAE,YAAY,aAAa,OAAO;CAEtC,SAAS,IAAI,UAAU,CAAC;CACxB,WAAW,SAAS,IAAI,CAAC;;CAGzB,IAAI,SAAS;CACb,IAAI;CACJ,IAAI,SAAS;CACb,SAAS,KAAK,OAAuB;EACnC,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,MAAM,OAAO,KAAK,UAAU,KAAK;GACjC,IAAI,SAAS,QAAQ;GACrB,aAAa,KAAK,KAAK,CAAC,CACrB,WAAW;IAAE,SAAS;GAAK,CAAC,CAAC,CAC7B,OAAO,UAAmB;IAEzB,IAAI,EAAE,iBAAiB,iBAAiB,MAAM,WAAW,OAAO,MAAM,WAAW,OAC/E,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;GAEpE,CAAC;EACL,GAAG,YAAY;CACjB;CAEA,MAAM,cAAc,SAAS,WAAW,UAAU;EAChD,WAAW,KAAK;EAChB,IAAI,OAAO,IAAI,GAAG,KAAK,KAAK;CAC9B,CAAC;CACD,gBAAgB;EACd,SAAS;EACT,aAAa,KAAK;EAClB,YAAY;CACd;CAEA,IAAI,CAAC,aAAa,OAAO;CACzB,mBAAmB,QAAQ,QAAQ,QAAQ,KAAK,CAAC,CAC9C,WAAW;EACV,cAAc,QAAQ;EACtB,OAAO,aAAa,KAAK;CAC3B,CAAC,CAAC,CACD,MAAM,WAAW;EAEhB,IAAI,CAAC,UAAU,CAAC,aAAa;EAC7B,OAAO,IAAI,IAAI;EACf,IAAI,QAAQ;GACV,SAAS,IAAI,oBAAoB,MAAM,CAAC;GACxC,SAAS,KAAK,UAAU,SAAS,IAAI,CAAC;EACxC,OAEK,KAAK,SAAS,IAAI,CAAC;CAC1B,CAAC,CAAC,CACD,OAAO,UAAmB;EAEzB,IAAI,EAAE,iBAAiB,iBAAiB,MAAM,WAAW,OAAO,MAAM,WAAW,OAC/E,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;CAEpE,CAAC,CAAC,CACD,cAAc;EAAE,MAAM,IAAI,IAAI;CAAE,CAAC;CACpC,OAAO;AACT"}

package/dist/core/convert.d.ts

@@ -17,8 +17,8 @@ export type ConvertTarget = {
 } | {
   type: 'transcriptSegment';
 } | {
-  type: 'composite';
-  kind: string;
+  type: 'typedBlock';
+  blockType: 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. */
 {
@@ -31,14 +31,14 @@ type CoreTarget = Extract<ConvertTarget, {
 }>;
 /** 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. */
+/** `'heading2'`, `'typedBlock: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). */
+/** `node` already is `target` (same heading level, same Block type, 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). */
+/** A textblock of the document body (not a block's chrome such as a Typed block's title). */
 export declare const isTextblockNode: (node: Node) => boolean;
 export declare const isListNode: (node: Node) => boolean;
 export declare const isQuoteNode: (node: Node) => boolean;

package/dist/core/convert.js

@@ -22,10 +22,10 @@ const CORE_TARGET_TYPES = {
 	blockquote: true,
 	codeBlock: true
 };
-/** `'heading2'`, `'composite:task'`, a custom target's id, else the target's type. */
+/** `'heading2'`, `'typedBlock: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 === "typedBlock") return `typedBlock:${target.blockType}`;
 	if (target.type === "custom") return target.id;
 	return target.type;
 }
@@ -40,12 +40,12 @@ function parseCoreTarget(id) {
 	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). */
+/** `node` already is `target` (same heading level, same Block type, 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;
+	if (target.type === "typedBlock") return node.attrs.blockType === target.blockType;
 	return true;
 }
 const LISTS = {
@@ -53,7 +53,7 @@ const LISTS = {
 	orderedList: true
 };
 const CODE_BLOCK = "codeBlock";
-/** A textblock of the document body (not a block's chrome such as a composite title). */
+/** A textblock of the document body (not a block's chrome such as a Typed block's title). */
 const isTextblockNode = (node) => node.isTextblock && !isChromeNode(node);
 const isListNode = (node) => LISTS[node.type.name] === true;
 const isQuoteNode = (node) => node.type.name === "blockquote";

package/dist/core/convert.js.map

@@ -1 +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":"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"}
+{"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: 'typedBlock', blockType: 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'`, `'typedBlock: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 === 'typedBlock') return `typedBlock:${target.blockType}`\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 Block type, 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 === 'typedBlock') return node.attrs.blockType === target.blockType\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 Typed block's 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":"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"}

package/dist/core/core-feature.js

@@ -1,8 +1,8 @@
 import { ABILITY } from "./schema/abilities.js";
 import { Abilities } from "./abilities.js";
-import { Metadata } from "./metadata.js";
 import { BlockId } from "./schema/block-ids.js";
 import { NodeFlags } from "./schema/node-flags.js";
+import { Metadata } from "./metadata.js";
 import { BlockConvert, convertMenuItems, coreConversions } from "./block-convert.js";
 import { BlockTransferStorage } from "./block-transfer.js";
 import { BlockFlash } from "./block-flash.js";

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

@@ -4,9 +4,9 @@ import { EditorFeature, EditorPreset, SettingsTab } from "./feature.js";
 /**
  * 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,
- * a toolbar group declared by two features (`toolbarGroups`) and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
+ * a toolbar group declared by two features (`toolbarGroups`), a block capability declared twice or with a built-in id (`blockCapabilities`), a derive method declared twice, with neither `run` nor `menu` or requiring an undeclared capability (`deriveMethods`) and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
  * `formatAiResult`) contributed twice. A command naming a toolbar group no feature declares needs the feature context
- * to build the commands: `toolbarOf` throws it. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
+ * to build the commands: `toolbarOf` throws it. `normalize` hooks chain left to right. `aiContext` contributions merge (`blockTypes` 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.
  */