@ecsplico/editor 3.6.0 → 4.0.0

package/dist/integrations/composite-media/index.js

@@ -1,8 +1,9 @@
 import { ABILITY } from "../../core/schema/abilities.js";
 import { blockIdOf, findBlockById } from "../../core/schema/block-ids.js";
 import { fetchErrorMessage } from "../../core/fetch-error.js";
-import { sourceOf } from "../../features/composites/derivation.js";
-import { compositeJSON, compositeKindsOf } from "../../features/composites/nodes.js";
+import { importTypeOf } from "../../features/composites/block-types.js";
+import { blockTypesOf, compositeJSON } from "../../features/composites/nodes.js";
+import { sourceOf } from "../../features/composites/source.js";
 import { acceptFor, mediaKindOf, mediaMime } from "../../features/media/schema.js";
 import { pickFiles } from "../../features/media/upload.js";
 import { isTextFile } from "../../features/media/file-import.js";
@@ -12,13 +13,12 @@ function stemOf(name) {
 	const dot = name.lastIndexOf(".");
 	return dot > 0 ? name.slice(0, dot) : name;
 }
-/** The kind an imported `file` becomes: audio and video a `recording`, an image a `figure`, anything else (PDFs, office files, text) a `document`. */
+/** The Block type an imported `file` becomes: the type whose `import` capability takes the file's media (`importTypeOf`); undefined when no Block type takes it. */
 function importKindOf(editor, file, text) {
-	const kind = text ? null : mediaKindOf(file.type);
-	const id = kind === "audio" || kind === "video" ? "recording" : kind === "image" ? "figure" : "document";
-	return compositeKindsOf(editor).some((k) => k.id === id) ? id : "document";
+	const media = text ? null : mediaKindOf(file.type);
+	return importTypeOf(blockTypesOf(editor), media);
 }
-/** A composite of kind `kind` titled with the stem of `file`'s name, holding its original name, type, size and import date. */
+/** A Typed block of Block type `kind` titled with the stem of `file`'s name, holding its original name, type, size and import date. */
 function documentComposite(kind, file, text, body) {
 	const composite = compositeJSON(kind, body);
 	const [title, ...rest] = composite.content;
@@ -26,7 +26,7 @@ function documentComposite(kind, file, text, body) {
 	return {
 		...composite,
 		attrs: {
-			kind,
+			blockType: kind,
 			meta: {
 				filename: file.name,
 				mimeType: mediaMime(file.type) || (text ? "text/markdown" : "application/octet-stream"),
@@ -49,7 +49,7 @@ function documentComposite(kind, file, text, body) {
 * block keeps its attributes otherwise, its id included, and so do the composite and every reference to either.
 */
 async function replaceSource(editor, composite, ctx) {
-	const source = sourceOf(composite, compositeKindsOf(editor));
+	const source = sourceOf(composite, blockTypesOf(editor));
 	const sourceId = source && blockIdOf(source.node);
 	if (!source || !sourceId) return;
 	const type = source.node.type.name;
@@ -96,7 +96,8 @@ function sourceActions(ctx) {
 		icon: "i-lucide-file-input",
 		ability: ABILITY.media,
 		order: 420,
-		isVisible: ({ editor, node }) => node.type.name === "composite" && sourceOf(node, compositeKindsOf(editor)) !== null,
+		requires: ["source"],
+		isVisible: ({ editor, node }) => sourceOf(node, blockTypesOf(editor)) !== null,
 		run: ({ editor, node }) => {
 			replaceSource(editor, node, ctx);
 		}
@@ -107,9 +108,10 @@ function sourceActions(ctx) {
 *
 * - **Wrapping:** the `wrapImport` stage puts the blocks of every imported file (parsed text or Markdown, or the
 *   uploaded media or file block; drop, paste, picker and recorder alike) into one composite titled with the
-*   file's name stem and carrying its filename, type, size and import date as meta. The kind follows the MIME type:
-*   audio and video become a `recording`, images a `figure`, everything else (PDFs, office files, text) a `document`.
-*   Without this feature the blocks are inserted as they are.
+*   file's name stem and carrying its filename, type, size and import date as meta. The Block type is the one whose
+*   `import` capability takes the file's media: by default audio and video become a `recording`, images a `figure`, everything
+*   else (PDFs, office files, text) a `document`. Without a Block type that takes the file, or without this feature, the
+*   blocks are inserted as they are.
 * - **Actions:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them
 *   through `editor.storage.media.importFiles` at the caret; the block action „Quelle ersetzen“ (`source-replace`, on
 *   composites with a source block) uploads a new file into the existing source block, keeping its id.
@@ -122,7 +124,11 @@ function compositeMediaFeature() {
 		id: "composite-media",
 		dimension: "content",
 		requires: ["composites", "media"],
-		blocks: { wrapImport: (editor, file, blocks) => [documentComposite(importKindOf(editor, file, isTextFile(file)), file, isTextFile(file), blocks)] },
+		blocks: { wrapImport: (editor, file, blocks) => {
+			const text = isTextFile(file);
+			const kind = importKindOf(editor, file, text);
+			return kind ? [documentComposite(kind, file, text, blocks)] : blocks;
+		} },
 		blockActions: sourceActions,
 		commands: (ctx) => [{
 			id: "datei",

package/dist/integrations/composite-media/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-media/index.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { type BlockAction, type EditorFeature, type FeatureContext, fetchErrorMessage } from '../../core'\nimport { ABILITY, blockIdOf, findBlockById } from '../../core/schema'\nimport { compositeJSON, compositeKindsOf, sourceOf } from '../../features/composites/schema'\nimport { isTextFile, pickFiles } from '../../features/media'\nimport { acceptFor, type MediaKind, mediaKindOf, mediaMime } from '../../features/media/schema'\n\n/** The file name without its last extension; the whole name when nothing else is left (`.env`). */\nfunction stemOf(name: string): string {\n  const dot = name.lastIndexOf('.')\n  return dot > 0 ? name.slice(0, dot) : name\n}\n\n/** The kind an imported `file` becomes: audio and video a `recording`, an image a `figure`, anything else (PDFs, office files, text) a `document`. */\nfunction importKindOf(editor: Editor, file: File, text: boolean): string {\n  const kind = text ? null : mediaKindOf(file.type)\n  const id = kind === 'audio' || kind === 'video' ? 'recording' : kind === 'image' ? 'figure' : 'document'\n  return compositeKindsOf(editor).some(k => k.id === id) ? id : 'document'\n}\n\n/** A composite of kind `kind` titled with the stem of `file`'s name, holding its original name, type, size and import date. */\nfunction documentComposite(kind: string, file: File, text: boolean, body: JSONContent[]): JSONContent {\n  const composite = compositeJSON(kind, body)\n  const [title, ...rest] = composite.content!\n  const stem = stemOf(file.name)\n  return {\n    ...composite,\n    attrs: {\n      kind,\n      meta: {\n        filename: file.name,\n        mimeType: mediaMime(file.type) || (text ? 'text/markdown' : 'application/octet-stream'),\n        size: file.size,\n        importedAt: new Date().toISOString().slice(0, 10),\n      },\n    },\n    content: [stem ? { ...title!, content: [{ type: 'text', text: stem }] } : title!, ...rest],\n  }\n}\n\n/**\n * Swaps the source file of `composite` in place: picks a file of the source block's media type, uploads it and rewrites\n * `src`, `hash`, `mimeType`, `title` and `size` of the existing source block (those of them its node type has). The\n * block keeps its attributes otherwise, its id included, and so do the composite and every reference to either.\n */\nasync function replaceSource(editor: Editor, composite: PMNode, ctx: FeatureContext): Promise<void> {\n  const source = sourceOf(composite, compositeKindsOf(editor))\n  const sourceId = source && blockIdOf(source.node)\n  if (!source || !sourceId) return\n  const type = source.node.type.name\n  const [file] = await pickFiles(acceptFor(type as MediaKind), false)\n  if (!file || editor.isDestroyed) return\n  try {\n    if ((mediaKindOf(file.type) ?? 'file') !== type) throw new Error(`${file.type || file.name}: ${type}`)\n    const { url, sha256 } = await editor.storage.media.upload(file)\n    if (editor.isDestroyed) return\n    // The upload takes a while: the source block is found again by its id.\n    const target = findBlockById(editor.state.doc, sourceId)\n    if (!target) {\n      ctx.notify({ title: ctx.t('integrations.sourceReplace.gone'), kind: 'error' })\n      return\n    }\n    const next: Record<string, unknown> = {\n      src: url,\n      hash: sha256 ?? null,\n      mimeType: mediaMime(file.type) || 'application/octet-stream',\n      title: file.name,\n      size: file.size,\n    }\n    const attrs: Record<string, unknown> = { ...target.node.attrs }\n    for (const [key, value] of Object.entries(next)) if (key in attrs) attrs[key] = value\n    editor.view.dispatch(editor.state.tr.setNodeMarkup(target.pos, undefined, attrs))\n    ctx.notify({ title: ctx.t('integrations.sourceReplace.done'), kind: 'success' })\n  }\n  catch (error) {\n    ctx.notify({ title: ctx.t('integrations.sourceReplace.failed'), description: fetchErrorMessage(error), kind: 'error' })\n  }\n}\n\nfunction sourceActions(ctx: FeatureContext): BlockAction[] {\n  return [{\n    id: 'source-replace',\n    label: ctx.t('integrations.sourceReplace.action'),\n    icon: 'i-lucide-file-input',\n    ability: ABILITY.media,\n    order: 420,\n    isVisible: ({ editor, node }) => node.type.name === 'composite' && sourceOf(node, compositeKindsOf(editor)) !== null,\n    run: ({ editor, node }) => {\n      void replaceSource(editor, node, ctx)\n    },\n  }]\n}\n\n/**\n * File import into composites. Needs the `composites` and `media` features; neither imports this one.\n *\n * - **Wrapping:** the `wrapImport` stage puts the blocks of every imported file (parsed text or Markdown, or the\n *   uploaded media or file block; drop, paste, picker and recorder alike) into one composite titled with the\n *   file's name stem and carrying its filename, type, size and import date as meta. The kind follows the MIME type:\n *   audio and video become a `recording`, images a `figure`, everything else (PDFs, office files, text) a `document`.\n *   Without this feature the blocks are inserted as they are.\n * - **Actions:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them\n *   through `editor.storage.media.importFiles` at the caret; the block action „Quelle ersetzen“ (`source-replace`, on\n *   composites with a source block) uploads a new file into the existing source block, keeping its id.\n *\n * Install it anywhere after `composites` and `media`; the `/` entry follows the order of the feature list. Framework-free\n * (`EditorFeature<never>`: no component slots), so one instance serves the Vue and the React surface.\n */\nexport function compositeMediaFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-media',\n    dimension: 'content',\n    requires: ['composites', 'media'],\n    blocks: { wrapImport: (editor, file, blocks) => [documentComposite(importKindOf(editor, file, isTextFile(file)), file, isTextFile(file), blocks)] },\n    blockActions: sourceActions,\n    commands: ctx => [{\n      id: 'datei',\n      slash: {},\n      label: ctx.t('integrations.compositeMedia.import'),\n      icon: 'i-lucide-file-up',\n      ability: ABILITY.composite,\n      run: (editor) => {\n        const pos = editor.state.selection.from\n        void pickFiles('*/*').then((files) => {\n          if (files.length && !editor.isDestroyed) return editor.storage.media.importFiles(editor, files, pos)\n        })\n      },\n    }],\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/integrations/composite-media/index.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport type { Node as PMNode } from '@tiptap/pm/model'\nimport { type BlockAction, type EditorFeature, type FeatureContext, fetchErrorMessage } from '../../core'\nimport { ABILITY, blockIdOf, findBlockById } from '../../core/schema'\nimport { blockTypesOf, compositeJSON, importTypeOf, sourceOf } from '../../features/composites/schema'\nimport { isTextFile, pickFiles } from '../../features/media'\nimport { acceptFor, type MediaKind, mediaKindOf, mediaMime } from '../../features/media/schema'\n\n/** The file name without its last extension; the whole name when nothing else is left (`.env`). */\nfunction stemOf(name: string): string {\n  const dot = name.lastIndexOf('.')\n  return dot > 0 ? name.slice(0, dot) : name\n}\n\n/** The Block type an imported `file` becomes: the type whose `import` capability takes the file's media (`importTypeOf`); undefined when no Block type takes it. */\nfunction importKindOf(editor: Editor, file: File, text: boolean): string | undefined {\n  const media = text ? null : mediaKindOf(file.type)\n  return importTypeOf(blockTypesOf(editor), media)\n}\n\n/** A Typed block of Block type `kind` titled with the stem of `file`'s name, holding its original name, type, size and import date. */\nfunction documentComposite(kind: string, file: File, text: boolean, body: JSONContent[]): JSONContent {\n  const composite = compositeJSON(kind, body)\n  const [title, ...rest] = composite.content!\n  const stem = stemOf(file.name)\n  return {\n    ...composite,\n    attrs: {\n      blockType: kind,\n      meta: {\n        filename: file.name,\n        mimeType: mediaMime(file.type) || (text ? 'text/markdown' : 'application/octet-stream'),\n        size: file.size,\n        importedAt: new Date().toISOString().slice(0, 10),\n      },\n    },\n    content: [stem ? { ...title!, content: [{ type: 'text', text: stem }] } : title!, ...rest],\n  }\n}\n\n/**\n * Swaps the source file of `composite` in place: picks a file of the source block's media type, uploads it and rewrites\n * `src`, `hash`, `mimeType`, `title` and `size` of the existing source block (those of them its node type has). The\n * block keeps its attributes otherwise, its id included, and so do the composite and every reference to either.\n */\nasync function replaceSource(editor: Editor, composite: PMNode, ctx: FeatureContext): Promise<void> {\n  const source = sourceOf(composite, blockTypesOf(editor))\n  const sourceId = source && blockIdOf(source.node)\n  if (!source || !sourceId) return\n  const type = source.node.type.name\n  const [file] = await pickFiles(acceptFor(type as MediaKind), false)\n  if (!file || editor.isDestroyed) return\n  try {\n    if ((mediaKindOf(file.type) ?? 'file') !== type) throw new Error(`${file.type || file.name}: ${type}`)\n    const { url, sha256 } = await editor.storage.media.upload(file)\n    if (editor.isDestroyed) return\n    // The upload takes a while: the source block is found again by its id.\n    const target = findBlockById(editor.state.doc, sourceId)\n    if (!target) {\n      ctx.notify({ title: ctx.t('integrations.sourceReplace.gone'), kind: 'error' })\n      return\n    }\n    const next: Record<string, unknown> = {\n      src: url,\n      hash: sha256 ?? null,\n      mimeType: mediaMime(file.type) || 'application/octet-stream',\n      title: file.name,\n      size: file.size,\n    }\n    const attrs: Record<string, unknown> = { ...target.node.attrs }\n    for (const [key, value] of Object.entries(next)) if (key in attrs) attrs[key] = value\n    editor.view.dispatch(editor.state.tr.setNodeMarkup(target.pos, undefined, attrs))\n    ctx.notify({ title: ctx.t('integrations.sourceReplace.done'), kind: 'success' })\n  }\n  catch (error) {\n    ctx.notify({ title: ctx.t('integrations.sourceReplace.failed'), description: fetchErrorMessage(error), kind: 'error' })\n  }\n}\n\nfunction sourceActions(ctx: FeatureContext): BlockAction[] {\n  return [{\n    id: 'source-replace',\n    label: ctx.t('integrations.sourceReplace.action'),\n    icon: 'i-lucide-file-input',\n    ability: ABILITY.media,\n    order: 420,\n    requires: ['source'],\n    isVisible: ({ editor, node }) => sourceOf(node, blockTypesOf(editor)) !== null,\n    run: ({ editor, node }) => {\n      void replaceSource(editor, node, ctx)\n    },\n  }]\n}\n\n/**\n * File import into composites. Needs the `composites` and `media` features; neither imports this one.\n *\n * - **Wrapping:** the `wrapImport` stage puts the blocks of every imported file (parsed text or Markdown, or the\n *   uploaded media or file block; drop, paste, picker and recorder alike) into one composite titled with the\n *   file's name stem and carrying its filename, type, size and import date as meta. The Block type is the one whose\n *   `import` capability takes the file's media: by default audio and video become a `recording`, images a `figure`, everything\n *   else (PDFs, office files, text) a `document`. Without a Block type that takes the file, or without this feature, the\n *   blocks are inserted as they are.\n * - **Actions:** the `/` command „Datei importieren“ (`datei`, ability `composite`) picks any files and imports them\n *   through `editor.storage.media.importFiles` at the caret; the block action „Quelle ersetzen“ (`source-replace`, on\n *   composites with a source block) uploads a new file into the existing source block, keeping its id.\n *\n * Install it anywhere after `composites` and `media`; the `/` entry follows the order of the feature list. Framework-free\n * (`EditorFeature<never>`: no component slots), so one instance serves the Vue and the React surface.\n */\nexport function compositeMediaFeature(): EditorFeature<never> {\n  return {\n    id: 'composite-media',\n    dimension: 'content',\n    requires: ['composites', 'media'],\n    blocks: {\n      wrapImport: (editor, file, blocks) => {\n        const text = isTextFile(file)\n        const kind = importKindOf(editor, file, text)\n        return kind ? [documentComposite(kind, file, text, blocks)] : blocks\n      },\n    },\n    blockActions: sourceActions,\n    commands: ctx => [{\n      id: 'datei',\n      slash: {},\n      label: ctx.t('integrations.compositeMedia.import'),\n      icon: 'i-lucide-file-up',\n      ability: ABILITY.composite,\n      run: (editor) => {\n        const pos = editor.state.selection.from\n        void pickFiles('*/*').then((files) => {\n          if (files.length && !editor.isDestroyed) return editor.storage.media.importFiles(editor, files, pos)\n        })\n      },\n    }],\n  }\n}\n"],"mappings":"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"}

package/dist/markdown/document.js

@@ -76,7 +76,7 @@ function markdownToContent(editor, body, options = {}) {
 		diagnostics.push({
 			code: "unknown-fence",
 			severity: "info",
-			message: t("markdown.diagnostic.unknownFence", { kind: String(fence.attrs?.kind) }),
+			message: t("markdown.diagnostic.unknownFence", { kind: String(fence.attrs?.blockType) }),
 			...line && { line }
 		});
 	}

package/dist/markdown/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","names":[],"sources":["../../src/markdown/document.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { splitFences } from '../core/fences'\nimport { parseBlocks, pipelineOf } from '../core/pipeline'\nimport { EMPTY_EDITOR_CONTENT } from '../core/schema'\nimport { editorEntryOf } from '../core/editor-ui'\nimport { createTranslator, type Translate } from '../i18n'\nimport { enforceUrlPolicy, locate, type MarkdownDiagnostic, type MarkdownPolicy } from './policy'\n\n/** A Markdown body as document JSON, with what the parse dropped or could not understand. */\nexport interface MarkdownContent {\n  content: JSONContent\n  diagnostics: MarkdownDiagnostic[]\n}\n\n/** The part of `@tiptap/markdown`'s manager the HTML policy swaps out for the duration of one parse. */\ninterface HtmlParsing {\n  parseHTMLToken: (token: { raw?: string, text?: string }) => unknown\n}\n\n/**\n * Runs `parse` with raw HTML tokens (block and inline, tags and comments) dropped instead of handed to the schema's\n * `parseHTML` rules, and reports each in `diagnostics`.\n */\nfunction withoutRawHtml<T>(editor: Editor, source: string, diagnostics: MarkdownDiagnostic[], t: Translate, parse: () => T): T {\n  const manager = editor.markdown as unknown as HtmlParsing | undefined\n  if (!manager) return parse()\n  const own = Object.hasOwn(manager, 'parseHTMLToken')\n  const original = manager.parseHTMLToken\n  let from = 0\n  manager.parseHTMLToken = (token) => {\n    const html = (token.raw ?? token.text ?? '').trim()\n    if (html) {\n      const { line, next } = locate(source, html, from)\n      from = next\n      diagnostics.push({ code: 'raw-html', severity: 'warning', message: t('markdown.diagnostic.rawHtml', { html: JSON.stringify(html.length > 60 ? `${html.slice(0, 57)}…` : html) }), ...(line && { line }) })\n    }\n    return null\n  }\n  try {\n    return parse()\n  }\n  finally {\n    if (own) manager.parseHTMLToken = original\n    else delete (manager as Partial<HtmlParsing>).parseHTMLToken\n  }\n}\n\nconst opaqueFences = (node: JSONContent): JSONContent[] => [...(node.type === 'opaqueFence' ? [node] : []), ...(node.content ?? []).flatMap(opaqueFences)]\n\n/**\n * `body` (Markdown without frontmatter) as the document JSON of `editor`, plus `diagnostics`: the preset's block\n * pipeline parses it (`parseBlocks`: Markdown tokens, then the features' normalize and segment stages), the blocks\n * become the children of a `doc`, `policy` is enforced and the preset's `migrateContent` stage runs. An empty body is\n * the empty document (one empty paragraph). Nothing is applied to the editor.\n *\n * The diagnostics' `message` is in the language of `options.t`, by default that of the editor's registered surface, else\n * the default locale.\n *\n * Diagnostics: `raw-html` (dropped unless `policy.allowHtml`), `unsafe-url` (links and media with a scheme other than\n * http(s), mailto and tel are dropped; base64 `data:image` URLs are kept only with `policy.allowDataUrls`),\n * `unknown-fence` (a `:::` fence of a kind no feature registered, kept verbatim as an `opaqueFence`), and the fatal\n * `unclosed-fence` and `invalid-fence-meta` (a fence opener that stayed plain text).\n */\nexport function markdownToContent(editor: Editor, body: string, options: { policy?: MarkdownPolicy, t?: Translate } = {}): MarkdownContent {\n  const policy = options.policy ?? {}\n  const t = options.t ?? editorEntryOf(editor)?.ctx.t ?? createTranslator()\n  const diagnostics: MarkdownDiagnostic[] = []\n\n  const { blocks } = policy.allowHtml ? parseBlocks(editor, body) : withoutRawHtml(editor, body, diagnostics, t, () => parseBlocks(editor, body))\n  let content: JSONContent = blocks.length ? { type: 'doc', content: blocks } : EMPTY_EDITOR_CONTENT\n  content = enforceUrlPolicy(content, policy, body, diagnostics, t)\n  if (!content.content?.length) content = EMPTY_EDITOR_CONTENT\n\n  for (const problem of splitFences(body).problems) {\n    diagnostics.push({\n      code: problem.code,\n      severity: 'error',\n      line: problem.line,\n      message: t(problem.code === 'unclosed-fence' ? 'markdown.diagnostic.unclosedFence' : 'markdown.diagnostic.invalidFenceMeta', { kind: problem.kind }),\n    })\n  }\n  let from = 0\n  for (const fence of opaqueFences(content)) {\n    const raw = String(fence.attrs?.raw ?? '')\n    const { line, next } = locate(body, raw, from)\n    from = next\n    diagnostics.push({ code: 'unknown-fence', severity: 'info', message: t('markdown.diagnostic.unknownFence', { kind: String(fence.attrs?.kind) }), ...(line && { line }) })\n  }\n\n  return { content: pipelineOf(editor).migrateContent(content), diagnostics }\n}\n\n/**\n * The document of `editor` as Markdown (`editor.getMarkdown()`: the registered Markdown handlers render every node,\n * tables as pipe tables and task items as `- [ ]`/`- [x]`), without trailing line breaks: Tiptap keeps an empty\n * paragraph after a last block that is not a paragraph, and it is not content. Callers that write files add their own\n * final line break.\n */\nexport function contentToMarkdown(editor: Editor): string {\n  return editor.getMarkdown().replace(/\\n+$/, '')\n}\n"],"mappings":";;;;;;;;;;;AAuBA,SAAS,eAAkB,QAAgB,QAAgB,aAAmC,GAAc,OAAmB;CAC7H,MAAM,UAAU,OAAO;CACvB,IAAI,CAAC,SAAS,OAAO,MAAM;CAC3B,MAAM,MAAM,OAAO,OAAO,SAAS,gBAAgB;CACnD,MAAM,WAAW,QAAQ;CACzB,IAAI,OAAO;CACX,QAAQ,kBAAkB,UAAU;EAClC,MAAM,QAAQ,MAAM,OAAO,MAAM,QAAQ,GAAA,CAAI,KAAK;EAClD,IAAI,MAAM;GACR,MAAM,EAAE,MAAM,SAAS,OAAO,QAAQ,MAAM,IAAI;GAChD,OAAO;GACP,YAAY,KAAK;IAAE,MAAM;IAAY,UAAU;IAAW,SAAS,EAAE,+BAA+B,EAAE,MAAM,KAAK,UAAU,KAAK,SAAS,KAAK,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC;IAAG,GAAI,QAAQ,EAAE,KAAK;GAAG,CAAC;EAC3M;EACA,OAAO;CACT;CACA,IAAI;EACF,OAAO,MAAM;CACf,UACQ;EACN,IAAI,KAAK,QAAQ,iBAAiB;OAC7B,OAAQ,QAAiC;CAChD;AACF;AAEA,MAAM,gBAAgB,SAAqC,CAAC,GAAI,KAAK,SAAS,gBAAgB,CAAC,IAAI,IAAI,CAAC,GAAI,IAAI,KAAK,WAAW,CAAC,EAAA,CAAG,QAAQ,YAAY,CAAC;;;;;;;;;;;;;;;AAgBzJ,SAAgB,kBAAkB,QAAgB,MAAc,UAAsD,CAAC,GAAoB;CACzI,MAAM,SAAS,QAAQ,UAAU,CAAC;CAClC,MAAM,IAAI,QAAQ,KAAK,cAAc,MAAM,CAAC,EAAE,IAAI,KAAK,iBAAiB;CACxE,MAAM,cAAoC,CAAC;CAE3C,MAAM,EAAE,WAAW,OAAO,YAAY,YAAY,QAAQ,IAAI,IAAI,eAAe,QAAQ,MAAM,aAAa,SAAS,YAAY,QAAQ,IAAI,CAAC;CAC9I,IAAI,UAAuB,OAAO,SAAS;EAAE,MAAM;EAAO,SAAS;CAAO,IAAI;CAC9E,UAAU,iBAAiB,SAAS,QAAQ,MAAM,aAAa,CAAC;CAChE,IAAI,CAAC,QAAQ,SAAS,QAAQ,UAAU;CAExC,KAAK,MAAM,WAAW,YAAY,IAAI,CAAC,CAAC,UACtC,YAAY,KAAK;EACf,MAAM,QAAQ;EACd,UAAU;EACV,MAAM,QAAQ;EACd,SAAS,EAAE,QAAQ,SAAS,mBAAmB,sCAAsC,wCAAwC,EAAE,MAAM,QAAQ,KAAK,CAAC;CACrJ,CAAC;CAEH,IAAI,OAAO;CACX,KAAK,MAAM,SAAS,aAAa,OAAO,GAAG;EACzC,MAAM,MAAM,OAAO,MAAM,OAAO,OAAO,EAAE;EACzC,MAAM,EAAE,MAAM,SAAS,OAAO,MAAM,KAAK,IAAI;EAC7C,OAAO;EACP,YAAY,KAAK;GAAE,MAAM;GAAiB,UAAU;GAAQ,SAAS,EAAE,oCAAoC,EAAE,MAAM,OAAO,MAAM,OAAO,IAAI,EAAE,CAAC;GAAG,GAAI,QAAQ,EAAE,KAAK;EAAG,CAAC;CAC1K;CAEA,OAAO;EAAE,SAAS,WAAW,MAAM,CAAC,CAAC,eAAe,OAAO;EAAG;CAAY;AAC5E;;;;;;;AAQA,SAAgB,kBAAkB,QAAwB;CACxD,OAAO,OAAO,YAAY,CAAC,CAAC,QAAQ,QAAQ,EAAE;AAChD"}
+{"version":3,"file":"document.js","names":[],"sources":["../../src/markdown/document.ts"],"sourcesContent":["import type { Editor, JSONContent } from '@tiptap/core'\nimport { splitFences } from '../core/fences'\nimport { parseBlocks, pipelineOf } from '../core/pipeline'\nimport { EMPTY_EDITOR_CONTENT } from '../core/schema'\nimport { editorEntryOf } from '../core/editor-ui'\nimport { createTranslator, type Translate } from '../i18n'\nimport { enforceUrlPolicy, locate, type MarkdownDiagnostic, type MarkdownPolicy } from './policy'\n\n/** A Markdown body as document JSON, with what the parse dropped or could not understand. */\nexport interface MarkdownContent {\n  content: JSONContent\n  diagnostics: MarkdownDiagnostic[]\n}\n\n/** The part of `@tiptap/markdown`'s manager the HTML policy swaps out for the duration of one parse. */\ninterface HtmlParsing {\n  parseHTMLToken: (token: { raw?: string, text?: string }) => unknown\n}\n\n/**\n * Runs `parse` with raw HTML tokens (block and inline, tags and comments) dropped instead of handed to the schema's\n * `parseHTML` rules, and reports each in `diagnostics`.\n */\nfunction withoutRawHtml<T>(editor: Editor, source: string, diagnostics: MarkdownDiagnostic[], t: Translate, parse: () => T): T {\n  const manager = editor.markdown as unknown as HtmlParsing | undefined\n  if (!manager) return parse()\n  const own = Object.hasOwn(manager, 'parseHTMLToken')\n  const original = manager.parseHTMLToken\n  let from = 0\n  manager.parseHTMLToken = (token) => {\n    const html = (token.raw ?? token.text ?? '').trim()\n    if (html) {\n      const { line, next } = locate(source, html, from)\n      from = next\n      diagnostics.push({ code: 'raw-html', severity: 'warning', message: t('markdown.diagnostic.rawHtml', { html: JSON.stringify(html.length > 60 ? `${html.slice(0, 57)}…` : html) }), ...(line && { line }) })\n    }\n    return null\n  }\n  try {\n    return parse()\n  }\n  finally {\n    if (own) manager.parseHTMLToken = original\n    else delete (manager as Partial<HtmlParsing>).parseHTMLToken\n  }\n}\n\nconst opaqueFences = (node: JSONContent): JSONContent[] => [...(node.type === 'opaqueFence' ? [node] : []), ...(node.content ?? []).flatMap(opaqueFences)]\n\n/**\n * `body` (Markdown without frontmatter) as the document JSON of `editor`, plus `diagnostics`: the preset's block\n * pipeline parses it (`parseBlocks`: Markdown tokens, then the features' normalize and segment stages), the blocks\n * become the children of a `doc`, `policy` is enforced and the preset's `migrateContent` stage runs. An empty body is\n * the empty document (one empty paragraph). Nothing is applied to the editor.\n *\n * The diagnostics' `message` is in the language of `options.t`, by default that of the editor's registered surface, else\n * the default locale.\n *\n * Diagnostics: `raw-html` (dropped unless `policy.allowHtml`), `unsafe-url` (links and media with a scheme other than\n * http(s), mailto and tel are dropped; base64 `data:image` URLs are kept only with `policy.allowDataUrls`),\n * `unknown-fence` (a `:::` fence of a kind no feature registered, kept verbatim as an `opaqueFence`), and the fatal\n * `unclosed-fence` and `invalid-fence-meta` (a fence opener that stayed plain text).\n */\nexport function markdownToContent(editor: Editor, body: string, options: { policy?: MarkdownPolicy, t?: Translate } = {}): MarkdownContent {\n  const policy = options.policy ?? {}\n  const t = options.t ?? editorEntryOf(editor)?.ctx.t ?? createTranslator()\n  const diagnostics: MarkdownDiagnostic[] = []\n\n  const { blocks } = policy.allowHtml ? parseBlocks(editor, body) : withoutRawHtml(editor, body, diagnostics, t, () => parseBlocks(editor, body))\n  let content: JSONContent = blocks.length ? { type: 'doc', content: blocks } : EMPTY_EDITOR_CONTENT\n  content = enforceUrlPolicy(content, policy, body, diagnostics, t)\n  if (!content.content?.length) content = EMPTY_EDITOR_CONTENT\n\n  for (const problem of splitFences(body).problems) {\n    diagnostics.push({\n      code: problem.code,\n      severity: 'error',\n      line: problem.line,\n      message: t(problem.code === 'unclosed-fence' ? 'markdown.diagnostic.unclosedFence' : 'markdown.diagnostic.invalidFenceMeta', { kind: problem.kind }),\n    })\n  }\n  let from = 0\n  for (const fence of opaqueFences(content)) {\n    const raw = String(fence.attrs?.raw ?? '')\n    const { line, next } = locate(body, raw, from)\n    from = next\n    diagnostics.push({ code: 'unknown-fence', severity: 'info', message: t('markdown.diagnostic.unknownFence', { kind: String(fence.attrs?.blockType) }), ...(line && { line }) })\n  }\n\n  return { content: pipelineOf(editor).migrateContent(content), diagnostics }\n}\n\n/**\n * The document of `editor` as Markdown (`editor.getMarkdown()`: the registered Markdown handlers render every node,\n * tables as pipe tables and task items as `- [ ]`/`- [x]`), without trailing line breaks: Tiptap keeps an empty\n * paragraph after a last block that is not a paragraph, and it is not content. Callers that write files add their own\n * final line break.\n */\nexport function contentToMarkdown(editor: Editor): string {\n  return editor.getMarkdown().replace(/\\n+$/, '')\n}\n"],"mappings":";;;;;;;;;;;AAuBA,SAAS,eAAkB,QAAgB,QAAgB,aAAmC,GAAc,OAAmB;CAC7H,MAAM,UAAU,OAAO;CACvB,IAAI,CAAC,SAAS,OAAO,MAAM;CAC3B,MAAM,MAAM,OAAO,OAAO,SAAS,gBAAgB;CACnD,MAAM,WAAW,QAAQ;CACzB,IAAI,OAAO;CACX,QAAQ,kBAAkB,UAAU;EAClC,MAAM,QAAQ,MAAM,OAAO,MAAM,QAAQ,GAAA,CAAI,KAAK;EAClD,IAAI,MAAM;GACR,MAAM,EAAE,MAAM,SAAS,OAAO,QAAQ,MAAM,IAAI;GAChD,OAAO;GACP,YAAY,KAAK;IAAE,MAAM;IAAY,UAAU;IAAW,SAAS,EAAE,+BAA+B,EAAE,MAAM,KAAK,UAAU,KAAK,SAAS,KAAK,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC;IAAG,GAAI,QAAQ,EAAE,KAAK;GAAG,CAAC;EAC3M;EACA,OAAO;CACT;CACA,IAAI;EACF,OAAO,MAAM;CACf,UACQ;EACN,IAAI,KAAK,QAAQ,iBAAiB;OAC7B,OAAQ,QAAiC;CAChD;AACF;AAEA,MAAM,gBAAgB,SAAqC,CAAC,GAAI,KAAK,SAAS,gBAAgB,CAAC,IAAI,IAAI,CAAC,GAAI,IAAI,KAAK,WAAW,CAAC,EAAA,CAAG,QAAQ,YAAY,CAAC;;;;;;;;;;;;;;;AAgBzJ,SAAgB,kBAAkB,QAAgB,MAAc,UAAsD,CAAC,GAAoB;CACzI,MAAM,SAAS,QAAQ,UAAU,CAAC;CAClC,MAAM,IAAI,QAAQ,KAAK,cAAc,MAAM,CAAC,EAAE,IAAI,KAAK,iBAAiB;CACxE,MAAM,cAAoC,CAAC;CAE3C,MAAM,EAAE,WAAW,OAAO,YAAY,YAAY,QAAQ,IAAI,IAAI,eAAe,QAAQ,MAAM,aAAa,SAAS,YAAY,QAAQ,IAAI,CAAC;CAC9I,IAAI,UAAuB,OAAO,SAAS;EAAE,MAAM;EAAO,SAAS;CAAO,IAAI;CAC9E,UAAU,iBAAiB,SAAS,QAAQ,MAAM,aAAa,CAAC;CAChE,IAAI,CAAC,QAAQ,SAAS,QAAQ,UAAU;CAExC,KAAK,MAAM,WAAW,YAAY,IAAI,CAAC,CAAC,UACtC,YAAY,KAAK;EACf,MAAM,QAAQ;EACd,UAAU;EACV,MAAM,QAAQ;EACd,SAAS,EAAE,QAAQ,SAAS,mBAAmB,sCAAsC,wCAAwC,EAAE,MAAM,QAAQ,KAAK,CAAC;CACrJ,CAAC;CAEH,IAAI,OAAO;CACX,KAAK,MAAM,SAAS,aAAa,OAAO,GAAG;EACzC,MAAM,MAAM,OAAO,MAAM,OAAO,OAAO,EAAE;EACzC,MAAM,EAAE,MAAM,SAAS,OAAO,MAAM,KAAK,IAAI;EAC7C,OAAO;EACP,YAAY,KAAK;GAAE,MAAM;GAAiB,UAAU;GAAQ,SAAS,EAAE,oCAAoC,EAAE,MAAM,OAAO,MAAM,OAAO,SAAS,EAAE,CAAC;GAAG,GAAI,QAAQ,EAAE,KAAK;EAAG,CAAC;CAC/K;CAEA,OAAO;EAAE,SAAS,WAAW,MAAM,CAAC,CAAC,eAAe,OAAO;EAAG;CAAY;AAC5E;;;;;;;AAQA,SAAgB,kBAAkB,QAAwB;CACxD,OAAO,OAAO,YAAY,CAAC,CAAC,QAAQ,QAAQ,EAAE;AAChD"}

package/dist/nuxt/module.d.ts

@@ -416,6 +416,7 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.derivation.badge"?: string | undefined;
     "composites.derivation.stale"?: string | undefined;
     "composites.derivation.foreign"?: string | undefined;
+    "composites.derivation.sourceMissing"?: string | undefined;
     "composites.derivation.edited"?: string | undefined;
     "composites.derivation.expand"?: string | undefined;
     "composites.derivation.collapse"?: string | undefined;
@@ -443,6 +444,8 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.inspector.mentions"?: string | undefined;
     "composites.inspector.composite"?: string | undefined;
     "composites.inspector.kind"?: string | undefined;
+    "composites.inspector.properties"?: string | undefined;
+    "composites.inspector.derivation"?: string | undefined;
     "composites.inspector.title"?: string | undefined;
     "composites.inspector.titleHelp"?: string | undefined;
     "composites.inspector.untitled"?: string | undefined;
@@ -475,8 +478,8 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.settings.structure.legend"?: string | undefined;
     "composites.settings.structure.flat.label"?: string | undefined;
     "composites.settings.structure.flat.description"?: string | undefined;
-    "composites.settings.structure.composite.label"?: string | undefined;
-    "composites.settings.structure.composite.description"?: string | undefined;
+    "composites.settings.structure.structured.label"?: string | undefined;
+    "composites.settings.structure.structured.description"?: string | undefined;
     "composites.settings.scope.legend"?: string | undefined;
     "composites.settings.scope.container.label"?: string | undefined;
     "composites.settings.scope.container.description"?: string | undefined;
@@ -491,13 +494,13 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.settings.treeRoot.file.label"?: string | undefined;
     "composites.settings.treeRoot.file.description"?: string | undefined;
     "composites.settings.composites.title"?: string | undefined;
-    "composites.settings.defaultKind.label"?: string | undefined;
-    "composites.settings.defaultKind.description"?: string | undefined;
-    "composites.settings.kindIcon.legend"?: string | undefined;
-    "composites.settings.kindIcon.always.label"?: string | undefined;
-    "composites.settings.kindIcon.always.description"?: string | undefined;
-    "composites.settings.kindIcon.hover.label"?: string | undefined;
-    "composites.settings.kindIcon.hover.description"?: string | undefined;
+    "composites.settings.defaultBlockType.label"?: string | undefined;
+    "composites.settings.defaultBlockType.description"?: string | undefined;
+    "composites.settings.blockTypeIcon.legend"?: string | undefined;
+    "composites.settings.blockTypeIcon.always.label"?: string | undefined;
+    "composites.settings.blockTypeIcon.always.description"?: string | undefined;
+    "composites.settings.blockTypeIcon.hover.label"?: string | undefined;
+    "composites.settings.blockTypeIcon.hover.description"?: string | undefined;
     "composites.settings.dragHandle.legend"?: string | undefined;
     "composites.settings.dragHandle.hover.label"?: string | undefined;
     "composites.settings.dragHandle.hover.description"?: string | undefined;
@@ -709,8 +712,8 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "ai.settings.autocomplete.description"?: string | undefined;
     "ai.settings.language.label"?: string | undefined;
     "ai.settings.language.description"?: string | undefined;
-    "ai.settings.slots.title"?: string | undefined;
-    "ai.settings.slots.description"?: string | undefined;
+    "ai.settings.roles.title"?: string | undefined;
+    "ai.settings.roles.description"?: string | undefined;
     "ai.settings.profiles.title"?: string | undefined;
     "ai.settings.profiles.description"?: string | undefined;
     "ai.profiles.server"?: string | undefined;
@@ -775,7 +778,7 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
       } | undefined;
     } | undefined;
     apiKey?: string | undefined;
-    slots?: {
+    roles?: {
       complete?: string | undefined;
       rewrite?: string | undefined;
       generate?: string | undefined;
@@ -1203,6 +1206,7 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.derivation.badge"?: string | undefined;
     "composites.derivation.stale"?: string | undefined;
     "composites.derivation.foreign"?: string | undefined;
+    "composites.derivation.sourceMissing"?: string | undefined;
     "composites.derivation.edited"?: string | undefined;
     "composites.derivation.expand"?: string | undefined;
     "composites.derivation.collapse"?: string | undefined;
@@ -1230,6 +1234,8 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.inspector.mentions"?: string | undefined;
     "composites.inspector.composite"?: string | undefined;
     "composites.inspector.kind"?: string | undefined;
+    "composites.inspector.properties"?: string | undefined;
+    "composites.inspector.derivation"?: string | undefined;
     "composites.inspector.title"?: string | undefined;
     "composites.inspector.titleHelp"?: string | undefined;
     "composites.inspector.untitled"?: string | undefined;
@@ -1262,8 +1268,8 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.settings.structure.legend"?: string | undefined;
     "composites.settings.structure.flat.label"?: string | undefined;
     "composites.settings.structure.flat.description"?: string | undefined;
-    "composites.settings.structure.composite.label"?: string | undefined;
-    "composites.settings.structure.composite.description"?: string | undefined;
+    "composites.settings.structure.structured.label"?: string | undefined;
+    "composites.settings.structure.structured.description"?: string | undefined;
     "composites.settings.scope.legend"?: string | undefined;
     "composites.settings.scope.container.label"?: string | undefined;
     "composites.settings.scope.container.description"?: string | undefined;
@@ -1278,13 +1284,13 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "composites.settings.treeRoot.file.label"?: string | undefined;
     "composites.settings.treeRoot.file.description"?: string | undefined;
     "composites.settings.composites.title"?: string | undefined;
-    "composites.settings.defaultKind.label"?: string | undefined;
-    "composites.settings.defaultKind.description"?: string | undefined;
-    "composites.settings.kindIcon.legend"?: string | undefined;
-    "composites.settings.kindIcon.always.label"?: string | undefined;
-    "composites.settings.kindIcon.always.description"?: string | undefined;
-    "composites.settings.kindIcon.hover.label"?: string | undefined;
-    "composites.settings.kindIcon.hover.description"?: string | undefined;
+    "composites.settings.defaultBlockType.label"?: string | undefined;
+    "composites.settings.defaultBlockType.description"?: string | undefined;
+    "composites.settings.blockTypeIcon.legend"?: string | undefined;
+    "composites.settings.blockTypeIcon.always.label"?: string | undefined;
+    "composites.settings.blockTypeIcon.always.description"?: string | undefined;
+    "composites.settings.blockTypeIcon.hover.label"?: string | undefined;
+    "composites.settings.blockTypeIcon.hover.description"?: string | undefined;
     "composites.settings.dragHandle.legend"?: string | undefined;
     "composites.settings.dragHandle.hover.label"?: string | undefined;
     "composites.settings.dragHandle.hover.description"?: string | undefined;
@@ -1496,8 +1502,8 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
     "ai.settings.autocomplete.description"?: string | undefined;
     "ai.settings.language.label"?: string | undefined;
     "ai.settings.language.description"?: string | undefined;
-    "ai.settings.slots.title"?: string | undefined;
-    "ai.settings.slots.description"?: string | undefined;
+    "ai.settings.roles.title"?: string | undefined;
+    "ai.settings.roles.description"?: string | undefined;
     "ai.settings.profiles.title"?: string | undefined;
     "ai.settings.profiles.description"?: string | undefined;
     "ai.profiles.server"?: string | undefined;
@@ -1562,7 +1568,7 @@ declare const _default: import("@nuxt/schema").NuxtModule<{
       } | undefined;
     } | undefined;
     apiKey?: string | undefined;
-    slots?: {
+    roles?: {
       complete?: string | undefined;
       rewrite?: string | undefined;
       generate?: string | undefined;

package/dist/nuxt/module.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.js","names":[],"sources":["../../src/nuxt/module.ts"],"sourcesContent":["import { addPlugin, addServerScanDir, createResolver, defineNuxtModule } from 'nuxt/kit'\nimport { defineEditorConfig, type EditorConfigInput, publicConfig, serverConfig } from '../config'\n\n/** Module options (`tiptapEditor` in `nuxt.config`): the editor's configuration with every key optional, see `EditorConfig`. */\nexport type ModuleOptions = EditorConfigInput\n\n/**\n * Nuxt/Nitro integration of the editor package: the client context plugin (settings persistence, AI configuration),\n * a server plugin that mounts the editor's routes and the collaboration websocket (`installEditorServer`) and the AI configuration with its server-only secrets. The host\n * plugs in through `setEditorPorts()` (`@ecsplico/editor/server`) in a Nitro plugin (auth, loading and storing\n * document content). Components are imported explicitly from the package entries; nothing is auto-registered.\n */\nexport default defineNuxtModule<ModuleOptions>({\n  meta: { name: 'tiptap-editor', configKey: 'tiptapEditor' },\n  setup(options, nuxt) {\n    const { resolve } = createResolver(import.meta.url)\n    // `resolve('..')` is the package root of the built output (`dist`) or of `src` in this repository's app: both\n    // hold the stylesheets and the unbundled `nuxt/runtime` files, which Nuxt compiles for the client and Nitro for the server.\n    const packageSrc = resolve('..')\n    nuxt.options.build.transpile.push(packageSrc)\n    // The Nuxt UI token map comes first: the feature sheets (and an Obsidian theme, `themes.css`, last) read and may override `--sk-*`.\n    nuxt.options.css.push(resolve('../vue/kit/nuxt-ui.css'))\n    nuxt.options.css.push(\n      resolve('../styles/core.css'),\n      resolve('../styles/media.css'),\n      resolve('../styles/mentions.css'),\n      resolve('../styles/authors.css'),\n      resolve('../styles/comments.css'),\n      resolve('../styles/transcript.css'),\n      resolve('../styles/composites.css'),\n      resolve('../styles/ai.css'),\n      resolve('../styles/collab.css'),\n      resolve('../styles/block-ui.css'),\n      resolve('../styles/themes.css'),\n    )\n    addPlugin({ src: resolve('./runtime/plugins/editor-context-nuxt-ui.client.ts'), mode: 'client' })\n    addServerScanDir(resolve('./runtime/server'))\n    // Tailwind only scans the app layers listed in Nuxt UI's generated `ui.css` (`@source \"<layer>/app/**/*\"`), so the\n    // utility classes used by the package's components would never be generated. Append its source. `@nuxt/ui` must be\n    // registered before this module.\n    nuxt.hook('modules:done', () => {\n      const uiCss = nuxt.options.build.templates.find(t => t.filename === 'ui.css')\n      if (!uiCss?.getContents) throw new Error('tiptap-editor: @nuxt/ui muss vor diesem Modul registriert sein (ui.css-Template fehlt)')\n      const getContents = uiCss.getContents\n      uiCss.getContents = async data => `@source \"${packageSrc}/**/*\";\\n${await getContents(data)}`\n    })\n    nuxt.options.nitro.experimental = { ...nuxt.options.nitro.experimental, websocket: true }\n    // Nitro bundles the package (the runtime files import `h3` and `nitropack/runtime`, which the host's Nitro resolves): never leave it external.\n    nuxt.options.nitro.externals = { ...nuxt.options.nitro.externals, inline: [...(nuxt.options.nitro.externals?.inline ?? []), '@ecsplico/editor', packageSrc] }\n    const config = defineEditorConfig(options)\n    // The server view keeps an empty `apiKey` on the shared key, every preset and the transcription, so their `NUXT_TIPTAP_EDITOR_AI_*` env variables have a key to override.\n    nuxt.options.runtimeConfig.tiptapEditor = {\n      ...serverConfig(config),\n      ...(nuxt.options.runtimeConfig.tiptapEditor as object | undefined),\n    }\n    // Default slot presets for the client before `GET /api/ai/models` has answered; read by the client context plugin.\n    nuxt.options.runtimeConfig.public.tiptapEditor = {\n      ...publicConfig(config),\n      ...(nuxt.options.runtimeConfig.public.tiptapEditor as object | undefined),\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAYA,IAAA,iBAAe,iBAAgC;CAC7C,MAAM;EAAE,MAAM;EAAiB,WAAW;CAAe;CACzD,MAAM,SAAS,MAAM;EACnB,MAAM,EAAE,YAAY,eAAe,YAAY,GAAG;EAGlD,MAAM,aAAa,QAAQ,IAAI;EAC/B,KAAK,QAAQ,MAAM,UAAU,KAAK,UAAU;EAE5C,KAAK,QAAQ,IAAI,KAAK,QAAQ,wBAAwB,CAAC;EACvD,KAAK,QAAQ,IAAI,KACf,QAAQ,oBAAoB,GAC5B,QAAQ,qBAAqB,GAC7B,QAAQ,wBAAwB,GAChC,QAAQ,uBAAuB,GAC/B,QAAQ,wBAAwB,GAChC,QAAQ,0BAA0B,GAClC,QAAQ,0BAA0B,GAClC,QAAQ,kBAAkB,GAC1B,QAAQ,sBAAsB,GAC9B,QAAQ,wBAAwB,GAChC,QAAQ,sBAAsB,CAChC;EACA,UAAU;GAAE,KAAK,QAAQ,oDAAoD;GAAG,MAAM;EAAS,CAAC;EAChG,iBAAiB,QAAQ,kBAAkB,CAAC;EAI5C,KAAK,KAAK,sBAAsB;GAC9B,MAAM,QAAQ,KAAK,QAAQ,MAAM,UAAU,MAAK,MAAK,EAAE,aAAa,QAAQ;GAC5E,IAAI,CAAC,OAAO,aAAa,MAAM,IAAI,MAAM,wFAAwF;GACjI,MAAM,cAAc,MAAM;GAC1B,MAAM,cAAc,OAAM,SAAQ,YAAY,WAAW,WAAW,MAAM,YAAY,IAAI;EAC5F,CAAC;EACD,KAAK,QAAQ,MAAM,eAAe;GAAE,GAAG,KAAK,QAAQ,MAAM;GAAc,WAAW;EAAK;EAExF,KAAK,QAAQ,MAAM,YAAY;GAAE,GAAG,KAAK,QAAQ,MAAM;GAAW,QAAQ;IAAC,GAAI,KAAK,QAAQ,MAAM,WAAW,UAAU,CAAC;IAAI;IAAoB;GAAU;EAAE;EAC5J,MAAM,SAAS,mBAAmB,OAAO;EAEzC,KAAK,QAAQ,cAAc,eAAe;GACxC,GAAG,aAAa,MAAM;GACtB,GAAI,KAAK,QAAQ,cAAc;EACjC;EAEA,KAAK,QAAQ,cAAc,OAAO,eAAe;GAC/C,GAAG,aAAa,MAAM;GACtB,GAAI,KAAK,QAAQ,cAAc,OAAO;EACxC;CACF;AACF,CAAC"}
+{"version":3,"file":"module.js","names":[],"sources":["../../src/nuxt/module.ts"],"sourcesContent":["import { addPlugin, addServerScanDir, createResolver, defineNuxtModule } from 'nuxt/kit'\nimport { defineEditorConfig, type EditorConfigInput, publicConfig, serverConfig } from '../config'\n\n/** Module options (`tiptapEditor` in `nuxt.config`): the editor's configuration with every key optional, see `EditorConfig`. */\nexport type ModuleOptions = EditorConfigInput\n\n/**\n * Nuxt/Nitro integration of the editor package: the client context plugin (settings persistence, AI configuration),\n * a server plugin that mounts the editor's routes and the collaboration websocket (`installEditorServer`) and the AI configuration with its server-only secrets. The host\n * plugs in through `setEditorPorts()` (`@ecsplico/editor/server`) in a Nitro plugin (auth, loading and storing\n * document content). Components are imported explicitly from the package entries; nothing is auto-registered.\n */\nexport default defineNuxtModule<ModuleOptions>({\n  meta: { name: 'tiptap-editor', configKey: 'tiptapEditor' },\n  setup(options, nuxt) {\n    const { resolve } = createResolver(import.meta.url)\n    // `resolve('..')` is the package root of the built output (`dist`) or of `src` in this repository's app: both\n    // hold the stylesheets and the unbundled `nuxt/runtime` files, which Nuxt compiles for the client and Nitro for the server.\n    const packageSrc = resolve('..')\n    nuxt.options.build.transpile.push(packageSrc)\n    // The Nuxt UI token map comes first: the feature sheets (and an Obsidian theme, `themes.css`, last) read and may override `--sk-*`.\n    nuxt.options.css.push(resolve('../vue/kit/nuxt-ui.css'))\n    nuxt.options.css.push(\n      resolve('../styles/core.css'),\n      resolve('../styles/media.css'),\n      resolve('../styles/mentions.css'),\n      resolve('../styles/authors.css'),\n      resolve('../styles/comments.css'),\n      resolve('../styles/transcript.css'),\n      resolve('../styles/composites.css'),\n      resolve('../styles/ai.css'),\n      resolve('../styles/collab.css'),\n      resolve('../styles/block-ui.css'),\n      resolve('../styles/themes.css'),\n    )\n    addPlugin({ src: resolve('./runtime/plugins/editor-context-nuxt-ui.client.ts'), mode: 'client' })\n    addServerScanDir(resolve('./runtime/server'))\n    // Tailwind only scans the app layers listed in Nuxt UI's generated `ui.css` (`@source \"<layer>/app/**/*\"`), so the\n    // utility classes used by the package's components would never be generated. Append its source. `@nuxt/ui` must be\n    // registered before this module.\n    nuxt.hook('modules:done', () => {\n      const uiCss = nuxt.options.build.templates.find(t => t.filename === 'ui.css')\n      if (!uiCss?.getContents) throw new Error('tiptap-editor: @nuxt/ui muss vor diesem Modul registriert sein (ui.css-Template fehlt)')\n      const getContents = uiCss.getContents\n      uiCss.getContents = async data => `@source \"${packageSrc}/**/*\";\\n${await getContents(data)}`\n    })\n    nuxt.options.nitro.experimental = { ...nuxt.options.nitro.experimental, websocket: true }\n    // Nitro bundles the package (the runtime files import `h3` and `nitropack/runtime`, which the host's Nitro resolves): never leave it external.\n    nuxt.options.nitro.externals = { ...nuxt.options.nitro.externals, inline: [...(nuxt.options.nitro.externals?.inline ?? []), '@ecsplico/editor', packageSrc] }\n    const config = defineEditorConfig(options)\n    // The server view keeps an empty `apiKey` on the shared key, every preset and the transcription, so their `NUXT_TIPTAP_EDITOR_AI_*` env variables have a key to override.\n    nuxt.options.runtimeConfig.tiptapEditor = {\n      ...serverConfig(config),\n      ...(nuxt.options.runtimeConfig.tiptapEditor as object | undefined),\n    }\n    // Default role presets for the client before `GET /api/ai/models` has answered; read by the client context plugin.\n    nuxt.options.runtimeConfig.public.tiptapEditor = {\n      ...publicConfig(config),\n      ...(nuxt.options.runtimeConfig.public.tiptapEditor as object | undefined),\n    }\n  },\n})\n"],"mappings":";;;;;;;;;AAYA,IAAA,iBAAe,iBAAgC;CAC7C,MAAM;EAAE,MAAM;EAAiB,WAAW;CAAe;CACzD,MAAM,SAAS,MAAM;EACnB,MAAM,EAAE,YAAY,eAAe,YAAY,GAAG;EAGlD,MAAM,aAAa,QAAQ,IAAI;EAC/B,KAAK,QAAQ,MAAM,UAAU,KAAK,UAAU;EAE5C,KAAK,QAAQ,IAAI,KAAK,QAAQ,wBAAwB,CAAC;EACvD,KAAK,QAAQ,IAAI,KACf,QAAQ,oBAAoB,GAC5B,QAAQ,qBAAqB,GAC7B,QAAQ,wBAAwB,GAChC,QAAQ,uBAAuB,GAC/B,QAAQ,wBAAwB,GAChC,QAAQ,0BAA0B,GAClC,QAAQ,0BAA0B,GAClC,QAAQ,kBAAkB,GAC1B,QAAQ,sBAAsB,GAC9B,QAAQ,wBAAwB,GAChC,QAAQ,sBAAsB,CAChC;EACA,UAAU;GAAE,KAAK,QAAQ,oDAAoD;GAAG,MAAM;EAAS,CAAC;EAChG,iBAAiB,QAAQ,kBAAkB,CAAC;EAI5C,KAAK,KAAK,sBAAsB;GAC9B,MAAM,QAAQ,KAAK,QAAQ,MAAM,UAAU,MAAK,MAAK,EAAE,aAAa,QAAQ;GAC5E,IAAI,CAAC,OAAO,aAAa,MAAM,IAAI,MAAM,wFAAwF;GACjI,MAAM,cAAc,MAAM;GAC1B,MAAM,cAAc,OAAM,SAAQ,YAAY,WAAW,WAAW,MAAM,YAAY,IAAI;EAC5F,CAAC;EACD,KAAK,QAAQ,MAAM,eAAe;GAAE,GAAG,KAAK,QAAQ,MAAM;GAAc,WAAW;EAAK;EAExF,KAAK,QAAQ,MAAM,YAAY;GAAE,GAAG,KAAK,QAAQ,MAAM;GAAW,QAAQ;IAAC,GAAI,KAAK,QAAQ,MAAM,WAAW,UAAU,CAAC;IAAI;IAAoB;GAAU;EAAE;EAC5J,MAAM,SAAS,mBAAmB,OAAO;EAEzC,KAAK,QAAQ,cAAc,eAAe;GACxC,GAAG,aAAa,MAAM;GACtB,GAAI,KAAK,QAAQ,cAAc;EACjC;EAEA,KAAK,QAAQ,cAAc,OAAO,eAAe;GAC/C,GAAG,aAAa,MAAM;GACtB,GAAI,KAAK,QAAQ,cAAc,OAAO;EACxC;CACF;AACF,CAAC"}

package/dist/nuxt/runtime/server/plugins/editor-server.js

@@ -1,4 +1,4 @@
-import { useEditorPorts, useEditorSchema } from "../../../../server/host.js";
+import { useEditorBlockTypes, useEditorPorts, useEditorSchema } from "../../../../server/host.js";
 import { installEditorServer } from "../../../../adapters/nitro.js";
 import { defineNitroPlugin, useRuntimeConfig } from "nitropack/runtime";
 //#region src/nuxt/runtime/server/plugins/editor-server.ts
@@ -18,7 +18,8 @@ var editor_server_default = defineNitroPlugin((nitroApp) => {
 				missingKeyHint: (id) => ` (NUXT_TIPTAP_EDITOR_AI_PRESETS_${id.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase()}_API_KEY oder NUXT_TIPTAP_EDITOR_AI_API_KEY)`
 			},
 			rateLimit,
-			schema: useEditorSchema()
+			schema: useEditorSchema(),
+			blockTypes: useEditorBlockTypes()
 		});
 	}
 });

package/dist/nuxt/runtime/server/plugins/editor-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"editor-server.js","names":[],"sources":["../../../../../src/nuxt/runtime/server/plugins/editor-server.ts"],"sourcesContent":["// Nitro's auto-imports are not applied to files under node_modules (the built package), so every Nitro/h3 helper is imported explicitly.\nimport { defineNitroPlugin, useRuntimeConfig } from 'nitropack/runtime'\nimport { type EditorServer, installEditorServer } from '../../../../adapters/nitro'\nimport type { EditorServerConfig } from '../../../../config'\nimport { useEditorPorts, useEditorSchema } from '../../../../server/host'\n\n// Mounts the editor's routes and the collaboration websocket (`installEditorServer`) over the ports the host registered\n// with `setEditorPorts()`, and takes the AI configuration (presets, keys, slots, transcription), the rate limit and\n// `collab.authenticateUpgrade` from the module's runtime config.\n//\n// The host registers its ports in a Nitro plugin of its own, and Nitro does not order plugins of different layers and\n// modules reliably; the first request is the first moment every plugin has run (the routes it served before this\n// were file-based and read the ports per request, too). A failed install is retried by the next request.\nexport default defineNitroPlugin((nitroApp) => {\n  let server: EditorServer | undefined\n  nitroApp.hooks.hook('request', () => {\n    server ??= install()\n  })\n\n  function install(): EditorServer {\n    // The module's `serverConfig(defineEditorConfig(options))`, with the host's runtime-config and env overrides applied.\n    const { ai, rateLimit, collab } = useRuntimeConfig().tiptapEditor as EditorServerConfig\n    const ports = useEditorPorts()\n    return installEditorServer(nitroApp, {\n      ports,\n      // Without persisted collaboration state the editor runs without the websocket (documents still load and save over HTTP).\n      collab: ports.collabState ? collab : false,\n      // Env names use the preset id in upper snake case (`flashLite` → `FLASH_LITE`), like Nuxt's runtime config mapping.\n      ai: { ...ai, missingKeyHint: id => ` (NUXT_TIPTAP_EDITOR_AI_PRESETS_${id.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase()}_API_KEY oder NUXT_TIPTAP_EDITOR_AI_API_KEY)` },\n      rateLimit,\n      schema: useEditorSchema(),\n    })\n  }\n})\n"],"mappings":";;;;AAaA,IAAA,wBAAe,mBAAmB,aAAa;CAC7C,IAAI;CACJ,SAAS,MAAM,KAAK,iBAAiB;EACnC,WAAW,QAAQ;CACrB,CAAC;CAED,SAAS,UAAwB;EAE/B,MAAM,EAAE,IAAI,WAAW,WAAW,iBAAiB,CAAC,CAAC;EACrD,MAAM,QAAQ,eAAe;EAC7B,OAAO,oBAAoB,UAAU;GACnC;GAEA,QAAQ,MAAM,cAAc,SAAS;GAErC,IAAI;IAAE,GAAG;IAAI,iBAAgB,OAAM,mCAAmC,GAAG,QAAQ,sBAAsB,OAAO,CAAC,CAAC,YAAY,EAAE;GAA8C;GAC5K;GACA,QAAQ,gBAAgB;EAC1B,CAAC;CACH;AACF,CAAC"}
+{"version":3,"file":"editor-server.js","names":[],"sources":["../../../../../src/nuxt/runtime/server/plugins/editor-server.ts"],"sourcesContent":["// Nitro's auto-imports are not applied to files under node_modules (the built package), so every Nitro/h3 helper is imported explicitly.\nimport { defineNitroPlugin, useRuntimeConfig } from 'nitropack/runtime'\nimport { type EditorServer, installEditorServer } from '../../../../adapters/nitro'\nimport type { EditorServerConfig } from '../../../../config'\nimport { useEditorBlockTypes, useEditorPorts, useEditorSchema } from '../../../../server/host'\n\n// Mounts the editor's routes and the collaboration websocket (`installEditorServer`) over the ports the host registered\n// with `setEditorPorts()`, and takes the AI configuration (presets, keys, roles, transcription), the rate limit and\n// `collab.authenticateUpgrade` from the module's runtime config.\n//\n// The host registers its ports in a Nitro plugin of its own, and Nitro does not order plugins of different layers and\n// modules reliably; the first request is the first moment every plugin has run (the routes it served before this\n// were file-based and read the ports per request, too). A failed install is retried by the next request.\nexport default defineNitroPlugin((nitroApp) => {\n  let server: EditorServer | undefined\n  nitroApp.hooks.hook('request', () => {\n    server ??= install()\n  })\n\n  function install(): EditorServer {\n    // The module's `serverConfig(defineEditorConfig(options))`, with the host's runtime-config and env overrides applied.\n    const { ai, rateLimit, collab } = useRuntimeConfig().tiptapEditor as EditorServerConfig\n    const ports = useEditorPorts()\n    return installEditorServer(nitroApp, {\n      ports,\n      // Without persisted collaboration state the editor runs without the websocket (documents still load and save over HTTP).\n      collab: ports.collabState ? collab : false,\n      // Env names use the preset id in upper snake case (`flashLite` → `FLASH_LITE`), like Nuxt's runtime config mapping.\n      ai: { ...ai, missingKeyHint: id => ` (NUXT_TIPTAP_EDITOR_AI_PRESETS_${id.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase()}_API_KEY oder NUXT_TIPTAP_EDITOR_AI_API_KEY)` },\n      rateLimit,\n      schema: useEditorSchema(),\n      blockTypes: useEditorBlockTypes(),\n    })\n  }\n})\n"],"mappings":";;;;AAaA,IAAA,wBAAe,mBAAmB,aAAa;CAC7C,IAAI;CACJ,SAAS,MAAM,KAAK,iBAAiB;EACnC,WAAW,QAAQ;CACrB,CAAC;CAED,SAAS,UAAwB;EAE/B,MAAM,EAAE,IAAI,WAAW,WAAW,iBAAiB,CAAC,CAAC;EACrD,MAAM,QAAQ,eAAe;EAC7B,OAAO,oBAAoB,UAAU;GACnC;GAEA,QAAQ,MAAM,cAAc,SAAS;GAErC,IAAI;IAAE,GAAG;IAAI,iBAAgB,OAAM,mCAAmC,GAAG,QAAQ,sBAAsB,OAAO,CAAC,CAAC,YAAY,EAAE;GAA8C;GAC5K;GACA,QAAQ,gBAAgB;GACxB,YAAY,oBAAoB;EAClC,CAAC;CACH;AACF,CAAC"}

package/dist/presets/compose.d.ts

@@ -1,10 +1,10 @@
 import { EditorBackend } from "../core/backend.js";
 import { BlockUiOptions } from "../core/extension-points.js";
 import { EditorFeature, EditorPreset } from "../core/feature.js";
+import { Basket } from "../features/composites/baskets.js";
+import { BlockType } from "../features/composites/block-types.js";
 import { CoreContentOptions } from "../core/schema/index.js";
 import { CommentsFeatureOptions } from "../features/comments/feature.js";
-import { CompositeKind } from "../features/composites/kinds.js";
-import { Basket } from "../features/composites/baskets.js";
 import { CompositeFeatureOptions } from "../features/composites/feature.js";
 import { BlockTransform } from "../features/transfer/transforms.js";
 import { TransferFeatureOptions } from "../features/transfer/feature.js";
@@ -20,7 +20,7 @@ export type InteractionLevel = 'minimal' | 'full';
  * features are bound too, although `composite-ai` and `transcript-ai` have no components: the layer owns every import of
  * `features/ai`, so a composition without `ai` binds none of them and its bundle holds no AI code. Each binding is a
  * factory, called only for a feature the composition selects (`themes` reads the current Vue app when built, so
- * unselected features are never built). `composites` receives the composition's `compositeKinds` and `compositeBaskets`, `comments` its
+ * unselected features are never built). `composites` receives the composition's `blockTypes` and `compositeBaskets`, `comments` its
  * `comments` options. `core-ui` takes no parameter here: the framework-free `simpleEditor()` has no command palette;
  * a layer that has one (the `SimpleEditor` surfaces) builds `coreUiFeature({ palette })` itself.
  */
@@ -61,9 +61,9 @@ export interface ComposeOptions<C> {
   add?: readonly EditorFeature<C>[];
   /** Features left out (catalog or host); features that require them are omitted as well. */
   remove?: readonly FeatureId[];
-  /** The composite kinds („Bausteine“) offered in the editor (default: the built-in kinds); read once. */
-  compositeKinds?: readonly CompositeKind[];
-  /** The colour baskets a Baustein can be put into (default: the built-in red/orange/yellow/green/blue set); read once. */
+  /** The Block types offered in the editor (default: the built-in Block types); read once. */
+  blockTypes?: readonly BlockType[];
+  /** The colour baskets a Typed block can be put into (default: the built-in red/orange/yellow/green/blue set); read once. */
   compositeBaskets?: readonly Basket[];
   /** Options of the comments feature, e.g. a host `model` (then comments need no `collab`). */
   comments?: CommentsFeatureOptions;

package/dist/presets/compose.js

@@ -1,8 +1,8 @@
 import { defineEditor } from "../core/define-editor.js";
 import { coreContentFeature, coreUiFeature } from "../core/core-feature.js";
 import { CommentMark } from "../features/comments/schema.js";
-import { mentionsFeature } from "../features/mentions/index.js";
 import { copyTransform } from "../features/transfer/transforms.js";
+import { mentionsFeature } from "../features/mentions/index.js";
 import { tablesFeature } from "../features/tables/feature.js";
 import { compositeMediaFeature } from "../integrations/composite-media/index.js";
 //#region src/presets/compose.ts
@@ -39,10 +39,13 @@ const CATALOG = {
 	"composites": {
 		dimension: "content",
 		levels: ["rich"],
-		build: (ui, options) => bound(ui, "composites")({
-			...options.compositeKinds && { kinds: options.compositeKinds },
-			...options.compositeBaskets && { baskets: options.compositeBaskets }
-		})
+		build: (ui, options) => {
+			const { blockTypes } = options;
+			return bound(ui, "composites")({
+				...blockTypes && { blockTypes },
+				...options.compositeBaskets && { baskets: options.compositeBaskets }
+			});
+		}
 	},
 	"mentions": {
 		dimension: "content",

package/dist/presets/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","names":[],"sources":["../../src/presets/compose.ts"],"sourcesContent":["import type { EditorBackend } from '../core/backend'\nimport { coreContentFeature, coreUiFeature } from '../core/core-feature'\nimport { defineEditor } from '../core/define-editor'\nimport type { BlockUiOptions } from '../core/extension-points'\nimport type { Dimension, EditorFeature, EditorPreset } from '../core/feature'\nimport type { CoreContentOptions } from '../core/schema'\nimport type { CommentsFeatureOptions } from '../features/comments/feature'\nimport { CommentMark } from '../features/comments/schema'\nimport type { CompositeFeatureOptions } from '../features/composites/feature'\nimport type { Basket } from '../features/composites/baskets'\nimport type { CompositeKind } from '../features/composites/kinds'\nimport { mentionsFeature } from '../features/mentions'\nimport type { TransferFeatureOptions } from '../features/transfer/feature'\nimport { type BlockTransform, copyTransform } from '../features/transfer/transforms'\nimport { tablesFeature } from '../features/tables'\nimport { compositeMediaFeature } from '../integrations/composite-media'\n\n/** The id of a catalog feature (`CONTENT`, `INTERACTION`, `AI`) or of a host feature passed to `remove`. */\nexport type FeatureId = string\n\n/** How much document model the editor has: `basic` = `core-content`, `rich` = the full content catalog. */\nexport type ContentLevel = 'basic' | 'rich'\n\n/** How much editing UX the editor has: `minimal` = `core-ui`, `full` = every interaction feature. */\nexport type InteractionLevel = 'minimal' | 'full'\n\n/**\n * The features a UI layer binds, keyed by id; the other catalog features are framework-free and built here. The AI\n * features are bound too, although `composite-ai` and `transcript-ai` have no components: the layer owns every import of\n * `features/ai`, so a composition without `ai` binds none of them and its bundle holds no AI code. Each binding is a\n * factory, called only for a feature the composition selects (`themes` reads the current Vue app when built, so\n * unselected features are never built). `composites` receives the composition's `compositeKinds` and `compositeBaskets`, `comments` its\n * `comments` options. `core-ui` takes no parameter here: the framework-free `simpleEditor()` has no command palette;\n * a layer that has one (the `SimpleEditor` surfaces) builds `coreUiFeature({ palette })` itself.\n */\nexport interface UiBindings<C> {\n  'core-ui': () => EditorFeature<C>\n  'media': () => EditorFeature<C>\n  'transcript': () => EditorFeature<C>\n  'composites': (options: CompositeFeatureOptions) => EditorFeature<C>\n  'authors': () => EditorFeature<C>\n  'comments': (options: CommentsFeatureOptions) => EditorFeature<C>\n  'ai': () => EditorFeature<C>\n  'composite-ai': () => EditorFeature<C>\n  'transcript-ai': () => EditorFeature<C>\n  'collab': () => EditorFeature<C>\n  'block-ui': (options: BlockUiOptions) => EditorFeature<C>\n  'themes': () => EditorFeature<C>\n  'transfer': (options: TransferFeatureOptions) => EditorFeature<C>\n  /** The AI transforms of the transfer menu (`summaryTransform`, `bulletsTransform` of `integrations/composite-ai`); called only when `ai` is on and the host passes no `transfer.transforms`. */\n  'transfer-ai': () => readonly BlockTransform[]\n}\n\n/** What `composeEditor` builds the editor from. */\nexport interface ComposeOptions<C> {\n  /** The document model: a level or the content feature ids to install (`core-content` is always installed). */\n  content: ContentLevel | readonly FeatureId[]\n  /** The editing UX: a level or the interaction feature ids (`core-ui` is installed with any non-empty list); `[]` = a viewer without any interaction feature. */\n  interaction: InteractionLevel | readonly FeatureId[]\n  /** Installs `ai` and every integration whose `requires` are met (composite-AI iff composites, transcript-AI iff transcript). */\n  ai: boolean\n  /** The backend the editor runs on: features needing a capability it lacks are omitted. Absent = nothing is pruned by capability. */\n  backend?: EditorBackend\n  /**\n   * The host supplies the collaboration session itself (the surface's `collaboration` prop, e.g. from its own Hocuspocus\n   * provider), so `collab` and `comments` need no `collaboration` capability from the backend. Only a backend that must\n   * open the collaboration (`useEditorDocument(id, { collaboration: true })`) has to offer it. Default `false`.\n   */\n  collaboration?: boolean\n  /** Host features, appended after the catalog in the given order. */\n  add?: readonly EditorFeature<C>[]\n  /** Features left out (catalog or host); features that require them are omitted as well. */\n  remove?: readonly FeatureId[]\n  /** The composite kinds („Bausteine“) offered in the editor (default: the built-in kinds); read once. */\n  compositeKinds?: readonly CompositeKind[]\n  /** The colour baskets a Baustein can be put into (default: the built-in red/orange/yellow/green/blue set); read once. */\n  compositeBaskets?: readonly Basket[]\n  /** Options of the comments feature, e.g. a host `model` (then comments need no `collab`). */\n  comments?: CommentsFeatureOptions\n  /** Optional structures the content base drops (headings or heading levels, lists, blockquote, code block, rule); everything is on by default. Applies to the editor and to the server schema built from the preset's `schemaExtensions`. */\n  coreContent?: CoreContentOptions\n  /** Options of the block UI (`block-ui`, `interaction: 'full'`): which surfaces render block actions (hover bar, selected-block toolbar, both, none); the hover bar by default. */\n  blockUi?: BlockUiOptions\n  /** Options of the transfer feature (`interaction: [..., 'transfer']`; in no level list): the transforms a drop offers (default: the copy, plus the AI transforms when `ai` is on) and the default one. */\n  transfer?: TransferFeatureOptions\n}\n\n/** The composed preset and the features that were selected but dropped, in composition order, with the reason. */\nexport interface ComposedEditor<C> extends EditorPreset<C> {\n  readonly omitted: readonly { id: FeatureId, reason: string }[]\n}\n\nfunction fail(message: string): never {\n  throw new Error(`@ecsplico/editor: composeEditor: ${message}`)\n}\n\n/** The binding `key` of `ui`; a framework binding the composition needs but `ui` lacks fails here, naming it. */\nfunction bound<C, K extends keyof UiBindings<C>>(ui: Partial<UiBindings<C>>, key: K): UiBindings<C>[K] {\n  return ui[key] ?? fail(`no UI binding for feature \"${key}\"`)\n}\n\n/** One row of the catalog: where the feature sits, which level lists hold it, and how it is built from the options. */\ninterface CatalogEntry<C> {\n  dimension: Dimension\n  /** The level lists (`CONTENT`, `INTERACTION`) that include it; none for AI features, which `ai: true` installs. */\n  levels?: readonly (ContentLevel | InteractionLevel)[]\n  /** `ui` is partial on purpose: a host that never selects a feature (a viewer has no `block-ui`) binds only the rest, so the bundle holds no code of the others. */\n  build: (ui: Partial<UiBindings<C>>, options: ComposeOptions<C>) => EditorFeature<C>\n}\n\n/**\n * The catalog: the one table that drives composition. Its key order is the canonical order (content, interaction, AI):\n * the composed feature list, its schema order and its toolbar order follow it, and `CONTENT`, `INTERACTION`, `AI` are\n * derived from it. Adding a catalog feature is one row here, plus, for a UI-bound feature, a key in `UiBindings` and an\n * entry in both binding records (`vue/compose.ts`, `react/compose.ts`; their `satisfies UiBindings` check fails until\n * they hold it). Framework-free features are called directly, UI-bound ones go through `bound`.\n */\n// `any`: the table is module-level and shared by every UI layer; each `build` is typed by `UiBindings<C>` of its caller.\nconst CATALOG: Record<FeatureId, CatalogEntry<any>> = {\n  'core-content': { dimension: 'content', levels: ['basic', 'rich'], build: (_, options) => coreContentFeature(options.coreContent) },\n  'media': { dimension: 'content', levels: ['rich'], build: ui => bound(ui, 'media')() },\n  'transcript': { dimension: 'content', levels: ['rich'], build: ui => bound(ui, 'transcript')() },\n  'composites': { dimension: 'content', levels: ['rich'], build: (ui, options) => bound(ui, 'composites')({ ...(options.compositeKinds && { kinds: options.compositeKinds }), ...(options.compositeBaskets && { baskets: options.compositeBaskets }) }) },\n  'mentions': { dimension: 'content', levels: ['rich'], build: () => mentionsFeature() },\n  'authors': { dimension: 'content', levels: ['rich'], build: ui => bound(ui, 'authors')() },\n  'tables': { dimension: 'content', levels: ['rich'], build: () => tablesFeature() },\n  'composite-media': { dimension: 'content', levels: ['rich'], build: () => compositeMediaFeature() },\n  'core-ui': { dimension: 'interaction', levels: ['minimal', 'full'], build: ui => bound(ui, 'core-ui')() },\n  'collab': { dimension: 'interaction', levels: ['full'], build: ui => bound(ui, 'collab')() },\n  'comments': { dimension: 'interaction', levels: ['full'], build: (ui, options) => bound(ui, 'comments')(options.comments ?? {}) },\n  'block-ui': { dimension: 'interaction', levels: ['full'], build: (ui, options) => bound(ui, 'block-ui')(options.blockUi ?? {}) },\n  'themes': { dimension: 'interaction', levels: ['full'], build: ui => bound(ui, 'themes')() },\n  // In no level list: a host opts in with `interaction: [...INTERACTION.full, 'transfer']`. With `ai` on the menu also offers the AI transforms (bound by the layer, which owns every import of `features/ai`), unless the host passes its own `transfer.transforms`.\n  'transfer': { dimension: 'interaction', build: (ui, options) => bound(ui, 'transfer')({ ...options.transfer, ...(!options.transfer?.transforms && options.ai && { transforms: [copyTransform, ...bound(ui, 'transfer-ai')()] }) }) },\n  'ai': { dimension: 'ai', build: ui => bound(ui, 'ai')() },\n  'composite-ai': { dimension: 'ai', build: ui => bound(ui, 'composite-ai')() },\n  'transcript-ai': { dimension: 'ai', build: ui => bound(ui, 'transcript-ai')() },\n}\n\nconst catalogIds = (include: (entry: CatalogEntry<unknown>) => boolean): readonly FeatureId[] =>\n  Object.entries(CATALOG).filter(([, entry]) => include(entry)).map(([id]) => id)\nconst levelIds = (level: ContentLevel | InteractionLevel) => catalogIds(entry => entry.levels?.includes(level) ?? false)\n\n/** The content features of each level, in canonical (schema) order. */\nexport const CONTENT: Record<ContentLevel, readonly FeatureId[]> = { basic: levelIds('basic'), rich: levelIds('rich') }\n\n/** The interaction features of each level, in canonical order. */\nexport const INTERACTION: Record<InteractionLevel, readonly FeatureId[]> = { minimal: levelIds('minimal'), full: levelIds('full') }\n\n/** The AI features (`ai: true`): the AI feature and the integrations that need it; each is installed when its `requires` are met. */\nexport const AI: readonly FeatureId[] = catalogIds(entry => entry.dimension === 'ai')\n\n/** Canonical feature order: the key order of the catalog (content, interaction, AI). */\nconst CANONICAL: readonly FeatureId[] = Object.keys(CATALOG)\n\n/** Builds the catalog feature `id`; an id outside the catalog or a missing binding fails, naming it. */\nfunction build<C>(id: FeatureId, ui: Partial<UiBindings<C>>, options: ComposeOptions<C>): EditorFeature<C> {\n  const entry = Object.hasOwn(CATALOG, id) ? CATALOG[id] : undefined\n  if (!entry) fail(`unknown catalog feature \"${id}\" (host features go in \\`add\\`)`)\n  return entry.build(ui, options)\n}\n\n/** Why `feature` cannot stay in a composition holding `ids` over `backend`, or `undefined`. A host session satisfies `collaboration`. */\nfunction unmet(feature: Pick<EditorFeature, 'backend' | 'requires'>, ids: ReadonlySet<FeatureId>, options: Pick<ComposeOptions<unknown>, 'backend' | 'collaboration'>): string | undefined {\n  const { backend } = options\n  for (const capability of feature.backend ?? []) {\n    if (capability === 'collaboration' && options.collaboration) continue\n    if (backend && backend[capability] === undefined) return `backend \"${backend.name}\" lacks \"${capability}\"`\n  }\n  for (const required of feature.requires ?? []) {\n    if (!ids.has(required)) return `requires \"${required}\"`\n  }\n  return undefined\n}\n\n/**\n * The comment mark is part of the document model (stored documents carry it), but only the `comments` feature brings it.\n * A composition that keeps `authors` (every rich one) yet has no `comments` (a viewer, a backend without collaboration,\n * `remove`) gets the mark through `authors`, inert there, so such documents still load. The catalog is the one place\n * that may couple the two features; each stays importable on its own.\n */\nfunction withCommentMark<C>(features: readonly EditorFeature<C>[]): EditorFeature<C>[] {\n  if (features.some(feature => feature.id === 'comments')) return [...features]\n  return features.map(feature => feature.id !== 'authors'\n    ? feature\n    : {\n        ...feature,\n        schemaExtensions: () => [...(feature.schemaExtensions?.() ?? []), CommentMark],\n        extensions: ctx => [...(feature.extensions?.(ctx) ?? []), CommentMark],\n      })\n}\n\n/**\n * Composes an editor from three dimensions plus the backend's capabilities, over the UI bindings of a layer.\n *\n * The feature list is `content` + `interaction` (+ the AI features when `ai`) + `add`, minus `remove`. `core-content` is\n * always part of it and `core-ui` of every non-empty interaction list. Features that require a missing feature, or a\n * backend capability `options.backend` lacks, are dropped until the list is stable and reported in `omitted` (so\n * `ai: true` over a backend without `ai` installs no AI and says why). The catalog features keep their canonical order\n * (content, interaction, AI), host features follow in the order given; the result is validated by `defineEditor`.\n * Throws when an id of `content` is not a content feature, an id of `interaction` not an interaction feature, an id\n * names no catalog feature, `remove` names `core-content`, or a selected feature has no binding in `ui`.\n */\nexport function composeEditor<C>(ui: Partial<UiBindings<C>>, options: ComposeOptions<C>): ComposedEditor<C> {\n  if (options.remove?.includes('core-content')) fail('\"core-content\" cannot be removed')\n  const removed = new Set(options.remove ?? [])\n  const catalog = new Map<FeatureId, EditorFeature<C>>()\n  const select = (ids: readonly FeatureId[], dimension: 'content' | 'interaction' | 'ai') => {\n    for (const id of ids) {\n      if (removed.has(id) || catalog.has(id)) continue\n      const feature = build(id, ui, options)\n      if (feature.dimension !== dimension) fail(`\"${id}\" is not ${dimension === 'ai' ? 'an AI' : `a${dimension === 'interaction' ? 'n' : ''} ${dimension}`} feature`)\n      catalog.set(id, feature)\n    }\n  }\n  const content = typeof options.content === 'string' ? CONTENT[options.content] : options.content\n  const interaction = typeof options.interaction === 'string' ? INTERACTION[options.interaction] : options.interaction\n  select(['core-content', ...content], 'content')\n  select(interaction.length ? ['core-ui', ...interaction] : [], 'interaction')\n  select(options.ai ? AI : [], 'ai')\n\n  const ordered = [...catalog.values()].sort((a, b) => CANONICAL.indexOf(a.id) - CANONICAL.indexOf(b.id))\n  const all: EditorFeature<C>[] = [...ordered, ...(options.add ?? []).filter(feature => !removed.has(feature.id))]\n\n  const reasons = new Map<FeatureId, string>()\n  let alive = all\n  for (;;) {\n    const ids = new Set(alive.map(feature => feature.id))\n    const dropped = new Map<FeatureId, string>()\n    for (const feature of alive) {\n      const reason = unmet(feature, ids, options)\n      if (reason) dropped.set(feature.id, reason)\n    }\n    if (!dropped.size) break\n    for (const [id, reason] of dropped) reasons.set(id, reason)\n    alive = alive.filter(feature => !dropped.has(feature.id))\n  }\n\n  const preset = defineEditor({ features: withCommentMark(alive) })\n  const omitted = all.flatMap(feature => reasons.has(feature.id) ? [{ id: feature.id, reason: reasons.get(feature.id)! }] : [])\n  return Object.freeze({ ...preset, omitted: Object.freeze(omitted) })\n}\n\n/**\n * The simple editor: `core-content` and `core-ui` (formatting, headings, lists, quotes, code, undo/redo). No backend, no AI,\n * no collaboration, and no ⌘K command palette (`coreUiFeature()` gets no `palette` component here, the framework-free\n * layer has none; the `SimpleEditor` components and the `composeEditor` of `/vue/advanced` and `/react/advanced` bind it).\n * Component-free (`ComposedEditor<never>`), so both the Vue and the React surface accept it.\n */\nexport const simpleEditor = (): ComposedEditor<never> => composeEditor<never>({ 'core-ui': coreUiFeature }, { content: 'basic', interaction: 'minimal', ai: false })\n"],"mappings":"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"}
+{"version":3,"file":"compose.js","names":[],"sources":["../../src/presets/compose.ts"],"sourcesContent":["import type { EditorBackend } from '../core/backend'\nimport { coreContentFeature, coreUiFeature } from '../core/core-feature'\nimport { defineEditor } from '../core/define-editor'\nimport type { BlockUiOptions } from '../core/extension-points'\nimport type { Dimension, EditorFeature, EditorPreset } from '../core/feature'\nimport type { CoreContentOptions } from '../core/schema'\nimport type { CommentsFeatureOptions } from '../features/comments/feature'\nimport { CommentMark } from '../features/comments/schema'\nimport type { CompositeFeatureOptions } from '../features/composites/feature'\nimport type { Basket } from '../features/composites/baskets'\nimport type { BlockType } from '../features/composites/block-types'\nimport { mentionsFeature } from '../features/mentions'\nimport type { TransferFeatureOptions } from '../features/transfer/feature'\nimport { type BlockTransform, copyTransform } from '../features/transfer/transforms'\nimport { tablesFeature } from '../features/tables'\nimport { compositeMediaFeature } from '../integrations/composite-media'\n\n/** The id of a catalog feature (`CONTENT`, `INTERACTION`, `AI`) or of a host feature passed to `remove`. */\nexport type FeatureId = string\n\n/** How much document model the editor has: `basic` = `core-content`, `rich` = the full content catalog. */\nexport type ContentLevel = 'basic' | 'rich'\n\n/** How much editing UX the editor has: `minimal` = `core-ui`, `full` = every interaction feature. */\nexport type InteractionLevel = 'minimal' | 'full'\n\n/**\n * The features a UI layer binds, keyed by id; the other catalog features are framework-free and built here. The AI\n * features are bound too, although `composite-ai` and `transcript-ai` have no components: the layer owns every import of\n * `features/ai`, so a composition without `ai` binds none of them and its bundle holds no AI code. Each binding is a\n * factory, called only for a feature the composition selects (`themes` reads the current Vue app when built, so\n * unselected features are never built). `composites` receives the composition's `blockTypes` and `compositeBaskets`, `comments` its\n * `comments` options. `core-ui` takes no parameter here: the framework-free `simpleEditor()` has no command palette;\n * a layer that has one (the `SimpleEditor` surfaces) builds `coreUiFeature({ palette })` itself.\n */\nexport interface UiBindings<C> {\n  'core-ui': () => EditorFeature<C>\n  'media': () => EditorFeature<C>\n  'transcript': () => EditorFeature<C>\n  'composites': (options: CompositeFeatureOptions) => EditorFeature<C>\n  'authors': () => EditorFeature<C>\n  'comments': (options: CommentsFeatureOptions) => EditorFeature<C>\n  'ai': () => EditorFeature<C>\n  'composite-ai': () => EditorFeature<C>\n  'transcript-ai': () => EditorFeature<C>\n  'collab': () => EditorFeature<C>\n  'block-ui': (options: BlockUiOptions) => EditorFeature<C>\n  'themes': () => EditorFeature<C>\n  'transfer': (options: TransferFeatureOptions) => EditorFeature<C>\n  /** The AI transforms of the transfer menu (`summaryTransform`, `bulletsTransform` of `integrations/composite-ai`); called only when `ai` is on and the host passes no `transfer.transforms`. */\n  'transfer-ai': () => readonly BlockTransform[]\n}\n\n/** What `composeEditor` builds the editor from. */\nexport interface ComposeOptions<C> {\n  /** The document model: a level or the content feature ids to install (`core-content` is always installed). */\n  content: ContentLevel | readonly FeatureId[]\n  /** The editing UX: a level or the interaction feature ids (`core-ui` is installed with any non-empty list); `[]` = a viewer without any interaction feature. */\n  interaction: InteractionLevel | readonly FeatureId[]\n  /** Installs `ai` and every integration whose `requires` are met (composite-AI iff composites, transcript-AI iff transcript). */\n  ai: boolean\n  /** The backend the editor runs on: features needing a capability it lacks are omitted. Absent = nothing is pruned by capability. */\n  backend?: EditorBackend\n  /**\n   * The host supplies the collaboration session itself (the surface's `collaboration` prop, e.g. from its own Hocuspocus\n   * provider), so `collab` and `comments` need no `collaboration` capability from the backend. Only a backend that must\n   * open the collaboration (`useEditorDocument(id, { collaboration: true })`) has to offer it. Default `false`.\n   */\n  collaboration?: boolean\n  /** Host features, appended after the catalog in the given order. */\n  add?: readonly EditorFeature<C>[]\n  /** Features left out (catalog or host); features that require them are omitted as well. */\n  remove?: readonly FeatureId[]\n  /** The Block types offered in the editor (default: the built-in Block types); read once. */\n  blockTypes?: readonly BlockType[]\n  /** The colour baskets a Typed block can be put into (default: the built-in red/orange/yellow/green/blue set); read once. */\n  compositeBaskets?: readonly Basket[]\n  /** Options of the comments feature, e.g. a host `model` (then comments need no `collab`). */\n  comments?: CommentsFeatureOptions\n  /** Optional structures the content base drops (headings or heading levels, lists, blockquote, code block, rule); everything is on by default. Applies to the editor and to the server schema built from the preset's `schemaExtensions`. */\n  coreContent?: CoreContentOptions\n  /** Options of the block UI (`block-ui`, `interaction: 'full'`): which surfaces render block actions (hover bar, selected-block toolbar, both, none); the hover bar by default. */\n  blockUi?: BlockUiOptions\n  /** Options of the transfer feature (`interaction: [..., 'transfer']`; in no level list): the transforms a drop offers (default: the copy, plus the AI transforms when `ai` is on) and the default one. */\n  transfer?: TransferFeatureOptions\n}\n\n/** The composed preset and the features that were selected but dropped, in composition order, with the reason. */\nexport interface ComposedEditor<C> extends EditorPreset<C> {\n  readonly omitted: readonly { id: FeatureId, reason: string }[]\n}\n\nfunction fail(message: string): never {\n  throw new Error(`@ecsplico/editor: composeEditor: ${message}`)\n}\n\n/** The binding `key` of `ui`; a framework binding the composition needs but `ui` lacks fails here, naming it. */\nfunction bound<C, K extends keyof UiBindings<C>>(ui: Partial<UiBindings<C>>, key: K): UiBindings<C>[K] {\n  return ui[key] ?? fail(`no UI binding for feature \"${key}\"`)\n}\n\n/** One row of the catalog: where the feature sits, which level lists hold it, and how it is built from the options. */\ninterface CatalogEntry<C> {\n  dimension: Dimension\n  /** The level lists (`CONTENT`, `INTERACTION`) that include it; none for AI features, which `ai: true` installs. */\n  levels?: readonly (ContentLevel | InteractionLevel)[]\n  /** `ui` is partial on purpose: a host that never selects a feature (a viewer has no `block-ui`) binds only the rest, so the bundle holds no code of the others. */\n  build: (ui: Partial<UiBindings<C>>, options: ComposeOptions<C>) => EditorFeature<C>\n}\n\n/**\n * The catalog: the one table that drives composition. Its key order is the canonical order (content, interaction, AI):\n * the composed feature list, its schema order and its toolbar order follow it, and `CONTENT`, `INTERACTION`, `AI` are\n * derived from it. Adding a catalog feature is one row here, plus, for a UI-bound feature, a key in `UiBindings` and an\n * entry in both binding records (`vue/compose.ts`, `react/compose.ts`; their `satisfies UiBindings` check fails until\n * they hold it). Framework-free features are called directly, UI-bound ones go through `bound`.\n */\n// `any`: the table is module-level and shared by every UI layer; each `build` is typed by `UiBindings<C>` of its caller.\nconst CATALOG: Record<FeatureId, CatalogEntry<any>> = {\n  'core-content': { dimension: 'content', levels: ['basic', 'rich'], build: (_, options) => coreContentFeature(options.coreContent) },\n  'media': { dimension: 'content', levels: ['rich'], build: ui => bound(ui, 'media')() },\n  'transcript': { dimension: 'content', levels: ['rich'], build: ui => bound(ui, 'transcript')() },\n  'composites': {\n    dimension: 'content',\n    levels: ['rich'],\n    build: (ui, options) => {\n      const { blockTypes } = options\n      return bound(ui, 'composites')({ ...(blockTypes && { blockTypes }), ...(options.compositeBaskets && { baskets: options.compositeBaskets }) })\n    },\n  },\n  'mentions': { dimension: 'content', levels: ['rich'], build: () => mentionsFeature() },\n  'authors': { dimension: 'content', levels: ['rich'], build: ui => bound(ui, 'authors')() },\n  'tables': { dimension: 'content', levels: ['rich'], build: () => tablesFeature() },\n  'composite-media': { dimension: 'content', levels: ['rich'], build: () => compositeMediaFeature() },\n  'core-ui': { dimension: 'interaction', levels: ['minimal', 'full'], build: ui => bound(ui, 'core-ui')() },\n  'collab': { dimension: 'interaction', levels: ['full'], build: ui => bound(ui, 'collab')() },\n  'comments': { dimension: 'interaction', levels: ['full'], build: (ui, options) => bound(ui, 'comments')(options.comments ?? {}) },\n  'block-ui': { dimension: 'interaction', levels: ['full'], build: (ui, options) => bound(ui, 'block-ui')(options.blockUi ?? {}) },\n  'themes': { dimension: 'interaction', levels: ['full'], build: ui => bound(ui, 'themes')() },\n  // In no level list: a host opts in with `interaction: [...INTERACTION.full, 'transfer']`. With `ai` on the menu also offers the AI transforms (bound by the layer, which owns every import of `features/ai`), unless the host passes its own `transfer.transforms`.\n  'transfer': { dimension: 'interaction', build: (ui, options) => bound(ui, 'transfer')({ ...options.transfer, ...(!options.transfer?.transforms && options.ai && { transforms: [copyTransform, ...bound(ui, 'transfer-ai')()] }) }) },\n  'ai': { dimension: 'ai', build: ui => bound(ui, 'ai')() },\n  'composite-ai': { dimension: 'ai', build: ui => bound(ui, 'composite-ai')() },\n  'transcript-ai': { dimension: 'ai', build: ui => bound(ui, 'transcript-ai')() },\n}\n\nconst catalogIds = (include: (entry: CatalogEntry<unknown>) => boolean): readonly FeatureId[] =>\n  Object.entries(CATALOG).filter(([, entry]) => include(entry)).map(([id]) => id)\nconst levelIds = (level: ContentLevel | InteractionLevel) => catalogIds(entry => entry.levels?.includes(level) ?? false)\n\n/** The content features of each level, in canonical (schema) order. */\nexport const CONTENT: Record<ContentLevel, readonly FeatureId[]> = { basic: levelIds('basic'), rich: levelIds('rich') }\n\n/** The interaction features of each level, in canonical order. */\nexport const INTERACTION: Record<InteractionLevel, readonly FeatureId[]> = { minimal: levelIds('minimal'), full: levelIds('full') }\n\n/** The AI features (`ai: true`): the AI feature and the integrations that need it; each is installed when its `requires` are met. */\nexport const AI: readonly FeatureId[] = catalogIds(entry => entry.dimension === 'ai')\n\n/** Canonical feature order: the key order of the catalog (content, interaction, AI). */\nconst CANONICAL: readonly FeatureId[] = Object.keys(CATALOG)\n\n/** Builds the catalog feature `id`; an id outside the catalog or a missing binding fails, naming it. */\nfunction build<C>(id: FeatureId, ui: Partial<UiBindings<C>>, options: ComposeOptions<C>): EditorFeature<C> {\n  const entry = Object.hasOwn(CATALOG, id) ? CATALOG[id] : undefined\n  if (!entry) fail(`unknown catalog feature \"${id}\" (host features go in \\`add\\`)`)\n  return entry.build(ui, options)\n}\n\n/** Why `feature` cannot stay in a composition holding `ids` over `backend`, or `undefined`. A host session satisfies `collaboration`. */\nfunction unmet(feature: Pick<EditorFeature, 'backend' | 'requires'>, ids: ReadonlySet<FeatureId>, options: Pick<ComposeOptions<unknown>, 'backend' | 'collaboration'>): string | undefined {\n  const { backend } = options\n  for (const capability of feature.backend ?? []) {\n    if (capability === 'collaboration' && options.collaboration) continue\n    if (backend && backend[capability] === undefined) return `backend \"${backend.name}\" lacks \"${capability}\"`\n  }\n  for (const required of feature.requires ?? []) {\n    if (!ids.has(required)) return `requires \"${required}\"`\n  }\n  return undefined\n}\n\n/**\n * The comment mark is part of the document model (stored documents carry it), but only the `comments` feature brings it.\n * A composition that keeps `authors` (every rich one) yet has no `comments` (a viewer, a backend without collaboration,\n * `remove`) gets the mark through `authors`, inert there, so such documents still load. The catalog is the one place\n * that may couple the two features; each stays importable on its own.\n */\nfunction withCommentMark<C>(features: readonly EditorFeature<C>[]): EditorFeature<C>[] {\n  if (features.some(feature => feature.id === 'comments')) return [...features]\n  return features.map(feature => feature.id !== 'authors'\n    ? feature\n    : {\n        ...feature,\n        schemaExtensions: () => [...(feature.schemaExtensions?.() ?? []), CommentMark],\n        extensions: ctx => [...(feature.extensions?.(ctx) ?? []), CommentMark],\n      })\n}\n\n/**\n * Composes an editor from three dimensions plus the backend's capabilities, over the UI bindings of a layer.\n *\n * The feature list is `content` + `interaction` (+ the AI features when `ai`) + `add`, minus `remove`. `core-content` is\n * always part of it and `core-ui` of every non-empty interaction list. Features that require a missing feature, or a\n * backend capability `options.backend` lacks, are dropped until the list is stable and reported in `omitted` (so\n * `ai: true` over a backend without `ai` installs no AI and says why). The catalog features keep their canonical order\n * (content, interaction, AI), host features follow in the order given; the result is validated by `defineEditor`.\n * Throws when an id of `content` is not a content feature, an id of `interaction` not an interaction feature, an id\n * names no catalog feature, `remove` names `core-content`, or a selected feature has no binding in `ui`.\n */\nexport function composeEditor<C>(ui: Partial<UiBindings<C>>, options: ComposeOptions<C>): ComposedEditor<C> {\n  if (options.remove?.includes('core-content')) fail('\"core-content\" cannot be removed')\n  const removed = new Set(options.remove ?? [])\n  const catalog = new Map<FeatureId, EditorFeature<C>>()\n  const select = (ids: readonly FeatureId[], dimension: 'content' | 'interaction' | 'ai') => {\n    for (const id of ids) {\n      if (removed.has(id) || catalog.has(id)) continue\n      const feature = build(id, ui, options)\n      if (feature.dimension !== dimension) fail(`\"${id}\" is not ${dimension === 'ai' ? 'an AI' : `a${dimension === 'interaction' ? 'n' : ''} ${dimension}`} feature`)\n      catalog.set(id, feature)\n    }\n  }\n  const content = typeof options.content === 'string' ? CONTENT[options.content] : options.content\n  const interaction = typeof options.interaction === 'string' ? INTERACTION[options.interaction] : options.interaction\n  select(['core-content', ...content], 'content')\n  select(interaction.length ? ['core-ui', ...interaction] : [], 'interaction')\n  select(options.ai ? AI : [], 'ai')\n\n  const ordered = [...catalog.values()].sort((a, b) => CANONICAL.indexOf(a.id) - CANONICAL.indexOf(b.id))\n  const all: EditorFeature<C>[] = [...ordered, ...(options.add ?? []).filter(feature => !removed.has(feature.id))]\n\n  const reasons = new Map<FeatureId, string>()\n  let alive = all\n  for (;;) {\n    const ids = new Set(alive.map(feature => feature.id))\n    const dropped = new Map<FeatureId, string>()\n    for (const feature of alive) {\n      const reason = unmet(feature, ids, options)\n      if (reason) dropped.set(feature.id, reason)\n    }\n    if (!dropped.size) break\n    for (const [id, reason] of dropped) reasons.set(id, reason)\n    alive = alive.filter(feature => !dropped.has(feature.id))\n  }\n\n  const preset = defineEditor({ features: withCommentMark(alive) })\n  const omitted = all.flatMap(feature => reasons.has(feature.id) ? [{ id: feature.id, reason: reasons.get(feature.id)! }] : [])\n  return Object.freeze({ ...preset, omitted: Object.freeze(omitted) })\n}\n\n/**\n * The simple editor: `core-content` and `core-ui` (formatting, headings, lists, quotes, code, undo/redo). No backend, no AI,\n * no collaboration, and no ⌘K command palette (`coreUiFeature()` gets no `palette` component here, the framework-free\n * layer has none; the `SimpleEditor` components and the `composeEditor` of `/vue/advanced` and `/react/advanced` bind it).\n * Component-free (`ComposedEditor<never>`), so both the Vue and the React surface accept it.\n */\nexport const simpleEditor = (): ComposedEditor<never> => composeEditor<never>({ 'core-ui': coreUiFeature }, { content: 'basic', interaction: 'minimal', ai: false })\n"],"mappings":"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"}

package/dist/react/AdvancedEditor.d.ts

@@ -4,7 +4,7 @@ import { ComposedEditorHandle, ComposedEditorProps } from "./composed-surface.js
  * Props of the advanced editor: the surface's own (collaboration session or standalone `value`/`onChange`, metadata,
  * abilities, extensions, block actions, commands, `documentId`, `editable`, `settingsUi`, the open state of the sidebar
  * and comments margin, `onReady` and the other callbacks) except the preset, plus the composition: `content`,
- * `interaction`, `ai`, `add`, `remove`, `backend` and the composite kinds. The defaults are the advanced editor's:
+ * `interaction`, `ai`, `add`, `remove`, `backend` and the Block types. The defaults are the advanced editor's:
  * `content: 'rich'`, `interaction: 'full'`, `ai: true`.
  */
 export type AdvancedEditorProps = ComposedEditorProps;
@@ -12,7 +12,7 @@ export type AdvancedEditorProps = ComposedEditorProps;
  * The advanced editor on the React surface: `composeEditor({ content: 'rich', interaction: 'full', ai: true })` mounted
  * through `EditorSurface`; every dimension is overridable by its prop, and the backend (default: the editor context's)
  * prunes what it cannot serve. The ref's `preset` is the composed preset (`omitted` lists the dropped features). The
- * composition is fixed at mount like the kinds it is built from; hosts remount (`key`) to change it. Place
+ * composition is fixed at mount like the Block types it is built from; hosts remount (`key`) to change it. Place
  * `EditorToolbar` and, with `settingsUi: 'external'`, `EditorSettingsModal`/`EditorSettingsPanel` beside it and give
  * them the editor from `onReady`; `useEditorUi(editor)` reaches the chrome of a ready editor. Collaboration is active
  * only when a `collaboration` session is passed; mount `Toaster` once for notices.

package/dist/react/AdvancedEditor.js

@@ -6,7 +6,7 @@ import { jsx } from "react/jsx-runtime";
 * The advanced editor on the React surface: `composeEditor({ content: 'rich', interaction: 'full', ai: true })` mounted
 * through `EditorSurface`; every dimension is overridable by its prop, and the backend (default: the editor context's)
 * prunes what it cannot serve. The ref's `preset` is the composed preset (`omitted` lists the dropped features). The
-* composition is fixed at mount like the kinds it is built from; hosts remount (`key`) to change it. Place
+* composition is fixed at mount like the Block types it is built from; hosts remount (`key`) to change it. Place
 * `EditorToolbar` and, with `settingsUi: 'external'`, `EditorSettingsModal`/`EditorSettingsPanel` beside it and give
 * them the editor from `onReady`; `useEditorUi(editor)` reaches the chrome of a ready editor. Collaboration is active
 * only when a `collaboration` session is passed; mount `Toaster` once for notices.