@ecsplico/editor 3.5.1 → 4.0.0

package/dist/config/index.d.ts

@@ -1,9 +1,9 @@
 import { Locale, Messages } from "../i18n/index.js";
-import { ModelSlot } from "../settings/values.js";
+import { ModelRole } from "../settings/values.js";
 import "../settings/index.js";
 //#region src/config/index.d.ts
-/** Server-defined model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. */
-export interface PresetConfig {
+/** Server-defined Model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. The `preset` field of a model reference names one by id. */
+export interface ModelPresetConfig {
   label: string;
   endpoint: string;
   model: string;
@@ -34,18 +34,18 @@ export interface EditorConfig {
      * the preset id in upper snake case, e.g. `flashLite` → `FLASH_LITE`, or `NUXT_TIPTAP_EDITOR_AI_API_KEY`). Preset ids
      * must be camelCase so the env names map onto them. Presets named like a default (`sonnet`, `flashLite`) override its fields.
      */
-    presets: Record<string, PresetConfig>;
+    presets: Record<string, ModelPresetConfig>;
     /** Shared key of presets without their own. Default `''` (so the env variable has a key to override). */
     apiKey: string;
-    /** Default preset per slot; users may override in settings. The `complete` model must support assistant prefill. */
-    slots: Record<ModelSlot, string>;
+    /** Default preset per model role; users may override in settings (`ai.roles`). The `complete` model must support assistant prefill. */
+    roles: Record<ModelRole, string>;
     /** Per-user limit shared by all AI endpoints: at most `max` requests per sliding `windowMs`. */
     rateLimit: {
       max: number;
       windowMs: number;
     };
     /**
-     * Speech-to-text for audio/video Bausteine: an OpenAI-compatible `<endpoint>/audio/transcriptions` or Deepgram
+     * Speech-to-text for audio/video Typed blocks: an OpenAI-compatible `<endpoint>/audio/transcriptions` or Deepgram
      * (`provider: 'deepgram'`; OpenRouter presets provide neither). Absent = the action and the endpoint are off.
      * The key comes from env only (Nuxt: `NUXT_TIPTAP_EDITOR_AI_TRANSCRIPTION_API_KEY`).
      */
@@ -53,7 +53,7 @@ export interface EditorConfig {
   };
   collab: {
     /**
-     * Authenticate the `/collab/:id` websocket upgrade itself (`Identity.authenticate` with the upgrade request's
+     * Authenticate the `/collab/:id` websocket upgrade itself (`AccessControl.authenticate` with the upgrade request's
      * headers) and refuse it with HTTP 401 for an unknown user. Default `false`: the upgrade always succeeds, the user
      * is authenticated afterwards from the headers or the provider's `token`, and an unauthenticated socket is closed
      * with code 4401. Enable only when every client authenticates by cookie/headers: a client that sends its identity
@@ -67,18 +67,18 @@ type DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]>; }
 /** What a host writes: every key optional, `undefined` (an unset env variable) means the default. */
 export type EditorConfigInput = DeepPartial<EditorConfig>;
 /**
- * Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the slots that use
+ * Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the model roles that use
  * them, 30 AI requests per user and minute, no upgrade authentication. Every preset and the transcription get an empty
  * `apiKey` unless one is given, so an environment variable has a key to override.
  */
 export declare function defineEditorConfig(input?: EditorConfigInput): EditorConfig;
-/** What the browser may see: the language and the default model slots, never a key. */
+/** What the browser may see: the language and the default model roles, never a key. */
 export interface EditorPublicConfig {
   locale: Locale;
   messages?: Partial<Messages>;
-  /** Inert AI configuration: default preset per slot before the models list has answered, and whether transcription is on. */
+  /** Inert AI configuration: default preset per model role before the models list has answered, and whether transcription is on. */
   ai: {
-    slots: Record<ModelSlot, string>;
+    roles: Record<ModelRole, string>;
     transcription: boolean;
   };
 }
@@ -86,9 +86,9 @@ export declare function publicConfig(config: EditorConfig): EditorPublicConfig;
 /** What the server needs, secrets included: the shape `installEditorServer` takes for `ai`, `rateLimit` and `collab`. */
 export interface EditorServerConfig {
   ai: {
-    presets: Record<string, PresetConfig>;
+    presets: Record<string, ModelPresetConfig>;
     apiKey: string;
-    slots: Record<ModelSlot, string>;
+    roles: Record<ModelRole, string>;
     transcription?: TranscriptionConfig;
   };
   rateLimit: {

package/dist/config/index.js

@@ -12,7 +12,7 @@ const DEFAULT_PRESETS = {
 		model: "google/gemini-2.5-flash-lite"
 	}
 };
-const DEFAULT_SLOTS = {
+const DEFAULT_ROLES = {
 	complete: "flashLite",
 	rewrite: "sonnet",
 	generate: "sonnet"
@@ -26,7 +26,7 @@ function defined(value) {
 	return Object.fromEntries(Object.entries(value ?? {}).filter(([, v]) => v !== void 0));
 }
 /**
-* Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the slots that use
+* Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the model roles that use
 * them, 30 AI requests per user and minute, no upgrade authentication. Every preset and the transcription get an empty
 * `apiKey` unless one is given, so an environment variable has a key to override.
 */
@@ -50,9 +50,9 @@ function defineEditorConfig(input = {}) {
 		ai: {
 			presets,
 			apiKey: ai.apiKey ?? "",
-			slots: {
-				...DEFAULT_SLOTS,
-				...defined(ai.slots)
+			roles: {
+				...DEFAULT_ROLES,
+				...defined(ai.roles)
 			},
 			rateLimit: {
 				...DEFAULT_RATE_LIMIT,
@@ -71,18 +71,18 @@ function publicConfig(config) {
 		locale: config.locale,
 		...config.messages && { messages: config.messages },
 		ai: {
-			slots: config.ai.slots,
+			roles: config.ai.roles,
 			transcription: Boolean(config.ai.transcription)
 		}
 	};
 }
 function serverConfig(config) {
-	const { presets, apiKey, slots, transcription, rateLimit } = config.ai;
+	const { presets, apiKey, roles, transcription, rateLimit } = config.ai;
 	return {
 		ai: {
 			presets,
 			apiKey,
-			slots,
+			roles,
 			...transcription && { transcription }
 		},
 		rateLimit,

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/config/index.ts"],"sourcesContent":["import { DEFAULT_LOCALE, type Locale, type Messages } from '../i18n'\nimport type { ModelSlot } from '../settings'\n\n// One configuration of the editor, three views: `defineEditorConfig` applies every default once; `serverConfig` is\n// what the server needs (including the secrets), `publicConfig` what the browser may see. The Nuxt module sets its\n// runtime config from the two views; a plain Nitro host spreads `serverConfig(...)` into `installEditorServer`.\n// Framework-free: imports only the i18n and settings types, so Node, Nuxt build code and the browser can all load it.\n\n/** Server-defined model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. */\nexport interface PresetConfig { label: string, endpoint: string, model: string, apiKey?: string }\n\n/**\n * Speech-to-text endpoint. `provider` `'openai'` (default): any OpenAI-compatible `<endpoint>/audio/transcriptions`\n * (e.g. OpenAI `whisper-1`). `'deepgram'`: Deepgram's pre-recorded `<endpoint>/listen` (endpoint\n * `https://api.deepgram.com/v1`, model e.g. `nova-3`). `language` (e.g. `'de'`) fixes the spoken language; without it\n * OpenAI guesses and Deepgram detects it.\n */\nexport interface TranscriptionConfig { provider?: 'openai' | 'deepgram', endpoint: string, model: string, apiKey?: string, language?: string }\n\nexport interface EditorConfig {\n  /** Language of the editor's strings: `'de'` (default) or `'en'`. Set once per app; a host that switches languages at run time recreates the editor context. */\n  locale: Locale\n  /** Overrides of single messages by key (see `MessageKey`), applied on top of the catalog of `locale`; must be JSON-serialisable. */\n  messages?: Partial<Messages>\n  ai: {\n    /**\n     * Server-defined model presets (any OpenAI-compatible chat completions endpoint), keyed by preset id. The key is\n     * per preset or the shared `apiKey`, both from env only (Nuxt: `NUXT_TIPTAP_EDITOR_AI_PRESETS_<ID>_API_KEY`, `<ID>` =\n     * the preset id in upper snake case, e.g. `flashLite` → `FLASH_LITE`, or `NUXT_TIPTAP_EDITOR_AI_API_KEY`). Preset ids\n     * must be camelCase so the env names map onto them. Presets named like a default (`sonnet`, `flashLite`) override its fields.\n     */\n    presets: Record<string, PresetConfig>\n    /** Shared key of presets without their own. Default `''` (so the env variable has a key to override). */\n    apiKey: string\n    /** Default preset per slot; users may override in settings. The `complete` model must support assistant prefill. */\n    slots: Record<ModelSlot, string>\n    /** Per-user limit shared by all AI endpoints: at most `max` requests per sliding `windowMs`. */\n    rateLimit: { max: number, windowMs: number }\n    /**\n     * Speech-to-text for audio/video Bausteine: an OpenAI-compatible `<endpoint>/audio/transcriptions` or Deepgram\n     * (`provider: 'deepgram'`; OpenRouter presets provide neither). Absent = the action and the endpoint are off.\n     * The key comes from env only (Nuxt: `NUXT_TIPTAP_EDITOR_AI_TRANSCRIPTION_API_KEY`).\n     */\n    transcription?: TranscriptionConfig\n  }\n  collab: {\n    /**\n     * Authenticate the `/collab/:id` websocket upgrade itself (`Identity.authenticate` with the upgrade request's\n     * headers) and refuse it with HTTP 401 for an unknown user. Default `false`: the upgrade always succeeds, the user\n     * is authenticated afterwards from the headers or the provider's `token`, and an unauthenticated socket is closed\n     * with code 4401. Enable only when every client authenticates by cookie/headers: a client that sends its identity\n     * as `collaboration.token` (no cookies) cannot connect then. Nuxt env override:\n     * `NUXT_TIPTAP_EDITOR_COLLAB_AUTHENTICATE_UPGRADE=true`.\n     */\n    authenticateUpgrade: boolean\n  }\n}\n\ntype DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T\n\n/** What a host writes: every key optional, `undefined` (an unset env variable) means the default. */\nexport type EditorConfigInput = DeepPartial<EditorConfig>\n\n// i18n-ignore-start: model product names, the same in every language\nconst DEFAULT_PRESETS: Record<string, PresetConfig> = {\n  sonnet: { label: 'Claude Sonnet 4.5 (OpenRouter)', endpoint: 'https://openrouter.ai/api/v1', model: 'anthropic/claude-sonnet-4.5' },\n  flashLite: { label: 'Gemini 2.5 Flash Lite (OpenRouter)', endpoint: 'https://openrouter.ai/api/v1', model: 'google/gemini-2.5-flash-lite' },\n}\n// i18n-ignore-end\n\nconst DEFAULT_SLOTS: Record<ModelSlot, string> = { complete: 'flashLite', rewrite: 'sonnet', generate: 'sonnet' }\n\nconst DEFAULT_RATE_LIMIT = { max: 30, windowMs: 60_000 }\n\n/** Drops `undefined` values so an unset input never overwrites a default. */\nfunction defined<T extends object>(value: T | undefined): Partial<T> {\n  return Object.fromEntries(Object.entries(value ?? {}).filter(([, v]) => v !== undefined)) as Partial<T>\n}\n\n/**\n * Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the slots that use\n * them, 30 AI requests per user and minute, no upgrade authentication. Every preset and the transcription get an empty\n * `apiKey` unless one is given, so an environment variable has a key to override.\n */\nexport function defineEditorConfig(input: EditorConfigInput = {}): EditorConfig {\n  const ai = input.ai ?? {}\n  const presets: Record<string, PresetConfig> = {}\n  for (const id of new Set([...Object.keys(DEFAULT_PRESETS), ...Object.keys(ai.presets ?? {})])) {\n    const preset = { ...DEFAULT_PRESETS[id], ...defined(ai.presets?.[id]) } as PresetConfig\n    presets[id] = { ...preset, apiKey: preset.apiKey ?? '' }\n  }\n  const transcription = ai.transcription && ({ ...defined(ai.transcription) } as TranscriptionConfig)\n  return {\n    locale: input.locale ?? DEFAULT_LOCALE,\n    ...(input.messages && { messages: input.messages as Partial<Messages> }),\n    ai: {\n      presets,\n      apiKey: ai.apiKey ?? '',\n      slots: { ...DEFAULT_SLOTS, ...defined(ai.slots) },\n      rateLimit: { ...DEFAULT_RATE_LIMIT, ...defined(ai.rateLimit) },\n      ...(transcription && { transcription: { ...transcription, apiKey: transcription.apiKey ?? '' } }),\n    },\n    collab: { authenticateUpgrade: input.collab?.authenticateUpgrade ?? false },\n  }\n}\n\n/** What the browser may see: the language and the default model slots, never a key. */\nexport interface EditorPublicConfig {\n  locale: Locale\n  messages?: Partial<Messages>\n  /** Inert AI configuration: default preset per slot before the models list has answered, and whether transcription is on. */\n  ai: { slots: Record<ModelSlot, string>, transcription: boolean }\n}\n\nexport function publicConfig(config: EditorConfig): EditorPublicConfig {\n  return {\n    locale: config.locale,\n    ...(config.messages && { messages: config.messages }),\n    ai: { slots: config.ai.slots, transcription: Boolean(config.ai.transcription) },\n  }\n}\n\n/** What the server needs, secrets included: the shape `installEditorServer` takes for `ai`, `rateLimit` and `collab`. */\nexport interface EditorServerConfig {\n  ai: { presets: Record<string, PresetConfig>, apiKey: string, slots: Record<ModelSlot, string>, transcription?: TranscriptionConfig }\n  rateLimit: { max: number, windowMs: number }\n  collab: { authenticateUpgrade: boolean }\n}\n\nexport function serverConfig(config: EditorConfig): EditorServerConfig {\n  const { presets, apiKey, slots, transcription, rateLimit } = config.ai\n  return {\n    ai: { presets, apiKey, slots, ...(transcription && { transcription }) },\n    rateLimit,\n    collab: config.collab,\n  }\n}\n"],"mappings":";;AAgEA,MAAM,kBAAgD;CACpD,QAAQ;EAAE,OAAO;EAAkC,UAAU;EAAgC,OAAO;CAA8B;CAClI,WAAW;EAAE,OAAO;EAAsC,UAAU;EAAgC,OAAO;CAA+B;AAC5I;AAGA,MAAM,gBAA2C;CAAE,UAAU;CAAa,SAAS;CAAU,UAAU;AAAS;AAEhH,MAAM,qBAAqB;CAAE,KAAK;CAAI,UAAU;AAAO;;AAGvD,SAAS,QAA0B,OAAkC;CACnE,OAAO,OAAO,YAAY,OAAO,QAAQ,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,MAAM,KAAA,CAAS,CAAC;AAC1F;;;;;;AAOA,SAAgB,mBAAmB,QAA2B,CAAC,GAAiB;CAC9E,MAAM,KAAK,MAAM,MAAM,CAAC;CACxB,MAAM,UAAwC,CAAC;CAC/C,KAAK,MAAM,sBAAM,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,eAAe,GAAG,GAAG,OAAO,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG;EAC7F,MAAM,SAAS;GAAE,GAAG,gBAAgB;GAAK,GAAG,QAAQ,GAAG,UAAU,GAAG;EAAE;EACtE,QAAQ,MAAM;GAAE,GAAG;GAAQ,QAAQ,OAAO,UAAU;EAAG;CACzD;CACA,MAAM,gBAAgB,GAAG,iBAAkB,EAAE,GAAG,QAAQ,GAAG,aAAa,EAAE;CAC1E,OAAO;EACL,QAAQ,MAAM,UAAA;EACd,GAAI,MAAM,YAAY,EAAE,UAAU,MAAM,SAA8B;EACtE,IAAI;GACF;GACA,QAAQ,GAAG,UAAU;GACrB,OAAO;IAAE,GAAG;IAAe,GAAG,QAAQ,GAAG,KAAK;GAAE;GAChD,WAAW;IAAE,GAAG;IAAoB,GAAG,QAAQ,GAAG,SAAS;GAAE;GAC7D,GAAI,iBAAiB,EAAE,eAAe;IAAE,GAAG;IAAe,QAAQ,cAAc,UAAU;GAAG,EAAE;EACjG;EACA,QAAQ,EAAE,qBAAqB,MAAM,QAAQ,uBAAuB,MAAM;CAC5E;AACF;AAUA,SAAgB,aAAa,QAA0C;CACrE,OAAO;EACL,QAAQ,OAAO;EACf,GAAI,OAAO,YAAY,EAAE,UAAU,OAAO,SAAS;EACnD,IAAI;GAAE,OAAO,OAAO,GAAG;GAAO,eAAe,QAAQ,OAAO,GAAG,aAAa;EAAE;CAChF;AACF;AASA,SAAgB,aAAa,QAA0C;CACrE,MAAM,EAAE,SAAS,QAAQ,OAAO,eAAe,cAAc,OAAO;CACpE,OAAO;EACL,IAAI;GAAE;GAAS;GAAQ;GAAO,GAAI,iBAAiB,EAAE,cAAc;EAAG;EACtE;EACA,QAAQ,OAAO;CACjB;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/config/index.ts"],"sourcesContent":["import { DEFAULT_LOCALE, type Locale, type Messages } from '../i18n'\nimport type { ModelRole } from '../settings'\n\n// One configuration of the editor, three views: `defineEditorConfig` applies every default once; `serverConfig` is\n// what the server needs (including the secrets), `publicConfig` what the browser may see. The Nuxt module sets its\n// runtime config from the two views; a plain Nitro host spreads `serverConfig(...)` into `installEditorServer`.\n// Framework-free: imports only the i18n and settings types, so Node, Nuxt build code and the browser can all load it.\n\n/** Server-defined Model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. The `preset` field of a model reference names one by id. */\nexport interface ModelPresetConfig { label: string, endpoint: string, model: string, apiKey?: string }\n\n/**\n * Speech-to-text endpoint. `provider` `'openai'` (default): any OpenAI-compatible `<endpoint>/audio/transcriptions`\n * (e.g. OpenAI `whisper-1`). `'deepgram'`: Deepgram's pre-recorded `<endpoint>/listen` (endpoint\n * `https://api.deepgram.com/v1`, model e.g. `nova-3`). `language` (e.g. `'de'`) fixes the spoken language; without it\n * OpenAI guesses and Deepgram detects it.\n */\nexport interface TranscriptionConfig { provider?: 'openai' | 'deepgram', endpoint: string, model: string, apiKey?: string, language?: string }\n\nexport interface EditorConfig {\n  /** Language of the editor's strings: `'de'` (default) or `'en'`. Set once per app; a host that switches languages at run time recreates the editor context. */\n  locale: Locale\n  /** Overrides of single messages by key (see `MessageKey`), applied on top of the catalog of `locale`; must be JSON-serialisable. */\n  messages?: Partial<Messages>\n  ai: {\n    /**\n     * Server-defined model presets (any OpenAI-compatible chat completions endpoint), keyed by preset id. The key is\n     * per preset or the shared `apiKey`, both from env only (Nuxt: `NUXT_TIPTAP_EDITOR_AI_PRESETS_<ID>_API_KEY`, `<ID>` =\n     * the preset id in upper snake case, e.g. `flashLite` → `FLASH_LITE`, or `NUXT_TIPTAP_EDITOR_AI_API_KEY`). Preset ids\n     * must be camelCase so the env names map onto them. Presets named like a default (`sonnet`, `flashLite`) override its fields.\n     */\n    presets: Record<string, ModelPresetConfig>\n    /** Shared key of presets without their own. Default `''` (so the env variable has a key to override). */\n    apiKey: string\n    /** Default preset per model role; users may override in settings (`ai.roles`). The `complete` model must support assistant prefill. */\n    roles: Record<ModelRole, string>\n    /** Per-user limit shared by all AI endpoints: at most `max` requests per sliding `windowMs`. */\n    rateLimit: { max: number, windowMs: number }\n    /**\n     * Speech-to-text for audio/video Typed blocks: an OpenAI-compatible `<endpoint>/audio/transcriptions` or Deepgram\n     * (`provider: 'deepgram'`; OpenRouter presets provide neither). Absent = the action and the endpoint are off.\n     * The key comes from env only (Nuxt: `NUXT_TIPTAP_EDITOR_AI_TRANSCRIPTION_API_KEY`).\n     */\n    transcription?: TranscriptionConfig\n  }\n  collab: {\n    /**\n     * Authenticate the `/collab/:id` websocket upgrade itself (`AccessControl.authenticate` with the upgrade request's\n     * headers) and refuse it with HTTP 401 for an unknown user. Default `false`: the upgrade always succeeds, the user\n     * is authenticated afterwards from the headers or the provider's `token`, and an unauthenticated socket is closed\n     * with code 4401. Enable only when every client authenticates by cookie/headers: a client that sends its identity\n     * as `collaboration.token` (no cookies) cannot connect then. Nuxt env override:\n     * `NUXT_TIPTAP_EDITOR_COLLAB_AUTHENTICATE_UPGRADE=true`.\n     */\n    authenticateUpgrade: boolean\n  }\n}\n\ntype DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T\n\n/** What a host writes: every key optional, `undefined` (an unset env variable) means the default. */\nexport type EditorConfigInput = DeepPartial<EditorConfig>\n\n// i18n-ignore-start: model product names, the same in every language\nconst DEFAULT_PRESETS: Record<string, ModelPresetConfig> = {\n  sonnet: { label: 'Claude Sonnet 4.5 (OpenRouter)', endpoint: 'https://openrouter.ai/api/v1', model: 'anthropic/claude-sonnet-4.5' },\n  flashLite: { label: 'Gemini 2.5 Flash Lite (OpenRouter)', endpoint: 'https://openrouter.ai/api/v1', model: 'google/gemini-2.5-flash-lite' },\n}\n// i18n-ignore-end\n\nconst DEFAULT_ROLES: Record<ModelRole, string> = { complete: 'flashLite', rewrite: 'sonnet', generate: 'sonnet' }\n\nconst DEFAULT_RATE_LIMIT = { max: 30, windowMs: 60_000 }\n\n/** Drops `undefined` values so an unset input never overwrites a default. */\nfunction defined<T extends object>(value: T | undefined): Partial<T> {\n  return Object.fromEntries(Object.entries(value ?? {}).filter(([, v]) => v !== undefined)) as Partial<T>\n}\n\n/**\n * Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the model roles that use\n * them, 30 AI requests per user and minute, no upgrade authentication. Every preset and the transcription get an empty\n * `apiKey` unless one is given, so an environment variable has a key to override.\n */\nexport function defineEditorConfig(input: EditorConfigInput = {}): EditorConfig {\n  const ai = input.ai ?? {}\n  const presets: Record<string, ModelPresetConfig> = {}\n  for (const id of new Set([...Object.keys(DEFAULT_PRESETS), ...Object.keys(ai.presets ?? {})])) {\n    const preset = { ...DEFAULT_PRESETS[id], ...defined(ai.presets?.[id]) } as ModelPresetConfig\n    presets[id] = { ...preset, apiKey: preset.apiKey ?? '' }\n  }\n  const transcription = ai.transcription && ({ ...defined(ai.transcription) } as TranscriptionConfig)\n  return {\n    locale: input.locale ?? DEFAULT_LOCALE,\n    ...(input.messages && { messages: input.messages as Partial<Messages> }),\n    ai: {\n      presets,\n      apiKey: ai.apiKey ?? '',\n      roles: { ...DEFAULT_ROLES, ...defined(ai.roles) },\n      rateLimit: { ...DEFAULT_RATE_LIMIT, ...defined(ai.rateLimit) },\n      ...(transcription && { transcription: { ...transcription, apiKey: transcription.apiKey ?? '' } }),\n    },\n    collab: { authenticateUpgrade: input.collab?.authenticateUpgrade ?? false },\n  }\n}\n\n/** What the browser may see: the language and the default model roles, never a key. */\nexport interface EditorPublicConfig {\n  locale: Locale\n  messages?: Partial<Messages>\n  /** Inert AI configuration: default preset per model role before the models list has answered, and whether transcription is on. */\n  ai: { roles: Record<ModelRole, string>, transcription: boolean }\n}\n\nexport function publicConfig(config: EditorConfig): EditorPublicConfig {\n  return {\n    locale: config.locale,\n    ...(config.messages && { messages: config.messages }),\n    ai: { roles: config.ai.roles, transcription: Boolean(config.ai.transcription) },\n  }\n}\n\n/** What the server needs, secrets included: the shape `installEditorServer` takes for `ai`, `rateLimit` and `collab`. */\nexport interface EditorServerConfig {\n  ai: { presets: Record<string, ModelPresetConfig>, apiKey: string, roles: Record<ModelRole, string>, transcription?: TranscriptionConfig }\n  rateLimit: { max: number, windowMs: number }\n  collab: { authenticateUpgrade: boolean }\n}\n\nexport function serverConfig(config: EditorConfig): EditorServerConfig {\n  const { presets, apiKey, roles, transcription, rateLimit } = config.ai\n  return {\n    ai: { presets, apiKey, roles, ...(transcription && { transcription }) },\n    rateLimit,\n    collab: config.collab,\n  }\n}\n"],"mappings":";;AAgEA,MAAM,kBAAqD;CACzD,QAAQ;EAAE,OAAO;EAAkC,UAAU;EAAgC,OAAO;CAA8B;CAClI,WAAW;EAAE,OAAO;EAAsC,UAAU;EAAgC,OAAO;CAA+B;AAC5I;AAGA,MAAM,gBAA2C;CAAE,UAAU;CAAa,SAAS;CAAU,UAAU;AAAS;AAEhH,MAAM,qBAAqB;CAAE,KAAK;CAAI,UAAU;AAAO;;AAGvD,SAAS,QAA0B,OAAkC;CACnE,OAAO,OAAO,YAAY,OAAO,QAAQ,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,MAAM,KAAA,CAAS,CAAC;AAC1F;;;;;;AAOA,SAAgB,mBAAmB,QAA2B,CAAC,GAAiB;CAC9E,MAAM,KAAK,MAAM,MAAM,CAAC;CACxB,MAAM,UAA6C,CAAC;CACpD,KAAK,MAAM,sBAAM,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,eAAe,GAAG,GAAG,OAAO,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG;EAC7F,MAAM,SAAS;GAAE,GAAG,gBAAgB;GAAK,GAAG,QAAQ,GAAG,UAAU,GAAG;EAAE;EACtE,QAAQ,MAAM;GAAE,GAAG;GAAQ,QAAQ,OAAO,UAAU;EAAG;CACzD;CACA,MAAM,gBAAgB,GAAG,iBAAkB,EAAE,GAAG,QAAQ,GAAG,aAAa,EAAE;CAC1E,OAAO;EACL,QAAQ,MAAM,UAAA;EACd,GAAI,MAAM,YAAY,EAAE,UAAU,MAAM,SAA8B;EACtE,IAAI;GACF;GACA,QAAQ,GAAG,UAAU;GACrB,OAAO;IAAE,GAAG;IAAe,GAAG,QAAQ,GAAG,KAAK;GAAE;GAChD,WAAW;IAAE,GAAG;IAAoB,GAAG,QAAQ,GAAG,SAAS;GAAE;GAC7D,GAAI,iBAAiB,EAAE,eAAe;IAAE,GAAG;IAAe,QAAQ,cAAc,UAAU;GAAG,EAAE;EACjG;EACA,QAAQ,EAAE,qBAAqB,MAAM,QAAQ,uBAAuB,MAAM;CAC5E;AACF;AAUA,SAAgB,aAAa,QAA0C;CACrE,OAAO;EACL,QAAQ,OAAO;EACf,GAAI,OAAO,YAAY,EAAE,UAAU,OAAO,SAAS;EACnD,IAAI;GAAE,OAAO,OAAO,GAAG;GAAO,eAAe,QAAQ,OAAO,GAAG,aAAa;EAAE;CAChF;AACF;AASA,SAAgB,aAAa,QAA0C;CACrE,MAAM,EAAE,SAAS,QAAQ,OAAO,eAAe,cAAc,OAAO;CACpE,OAAO;EACL,IAAI;GAAE;GAAS;GAAQ;GAAO,GAAI,iBAAiB,EAAE,cAAc;EAAG;EACtE;EACA,QAAQ,OAAO;CACjB;AACF"}

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

@@ -67,7 +67,7 @@ export interface CslDate {
 /** The CSL item types the editor offers (select options, server-side schema). */
 export declare const CSL_TYPES: readonly ["article-journal", "book", "chapter", "paper-conference", "thesis", "report", "webpage", "article", "dataset"];
 export type CslType = typeof CSL_TYPES[number];
-/** A CSL-JSON item without `id` and `title`: the Baustein's block id and title are authoritative for those and never stored in `meta.bib`. */
+/** A CSL-JSON item without `id` and `title`: the Typed block's block id and title are authoritative for those and never stored in `meta.bib`. */
 export interface CslItem {
   type: CslType;
   author?: CslName[];
@@ -249,7 +249,7 @@ export interface ImageStudioImage {
   title: string;
   active: boolean;
 }
-/** A managed Prompt-Baustein (style, brand, …) of the host. */
+/** A managed prompt block (style, brand, …) of the host. */
 export interface ImageStudioPromptBlock {
   id: string;
   label: string;
@@ -261,7 +261,7 @@ export interface ImageStudioGenerateBody {
   description: string;
   /** This turn's instruction; `''` generates from the description alone. */
   instruction: string;
-  /** The active Prompt-Bausteine, by the host's ids. */
+  /** The active prompt blocks, by the host's ids. */
   promptBlockIds: string[];
   /** The URLs of the active references and generations that go into the generation as reference images. */
   referenceUrls: string[];

package/dist/core/backend-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend-types.js","names":[],"sources":["../../src/core/backend-types.ts"],"sourcesContent":["import type { ReadonlyStore } from './store'\nimport type { AuthorIdentity } from './feature'\n\n// The wire and model types that `EditorBackend` (`./backend`) names in its methods. They live in core, not in the\n// features they belong to, so the port does not depend on any feature or integration; each feature's public entry\n// (`@ecsplico/editor/mentions/schema`, `…/themes/schema`, `…/ai/protocol`, `…/comments/schema`, …) exports the names\n// it always had. Types only: DOM-free, importable from server code.\n\n/** A user as offered for `@` mentions (`GET /api/editor/users`); never carries credentials. */\nexport interface MentionUser {\n  id: string\n  username: string\n  color: string\n}\n\n/** Profile as the client sees it; presets never expose their key. */\nexport interface ModelProfile { id: string, label: string, endpoint: string, model: string, source: 'preset' | 'user' }\n\n/** Model an AI request runs on: a server preset by id, or an OpenAI-compatible endpoint with its own key. */\nexport type ModelRef = { preset: string } | { endpoint: string, model: string, apiKey: string }\n\n/** A theme in the shared library; `builtin` themes are seeded by the host and cannot be deleted. */\nexport interface ThemeRecord {\n  id: string\n  name: string\n  version?: string\n  author?: string\n  authorUrl?: string\n  builtin: boolean\n}\n\n/** One transcript segment sent for cleanup. */\nexport interface TranscriptCleanupSegment {\n  /** Block ID of the segment (`blockIdOf`). */\n  id: string\n  speaker: string\n  /** The segment's inline content as Markdown (mentions as `@name`, tags as `#name`). */\n  text: string\n}\n/** Body of the transcript-cleanup route. */\nexport interface TranscriptCleanupRequest { segments: TranscriptCleanupSegment[], model: ModelRef }\n/** Cleaned text (single-line inline Markdown) of the segment with block ID `id`. */\nexport interface TranscriptCleanupResult { id: string, text: string }\n/** `cleaned`: only segments whose text changed. `failed`: segments of chunks whose model answer was unusable (left as they are). */\nexport interface TranscriptCleanupResponse { cleaned: TranscriptCleanupResult[], failed: number }\n\n/** A CSL name: `family`/`given` for a person, `literal` for an institution or an unparsed name. */\nexport interface CslName { family?: string, given?: string, literal?: string }\nexport interface CslDate { 'date-parts': number[][] }\n\n/** The CSL item types the editor offers (select options, server-side schema). */\nexport const CSL_TYPES = ['article-journal', 'book', 'chapter', 'paper-conference', 'thesis', 'report', 'webpage', 'article', 'dataset'] as const\nexport type CslType = typeof CSL_TYPES[number]\n\n/** A CSL-JSON item without `id` and `title`: the Baustein's block id and title are authoritative for those and never stored in `meta.bib`. */\nexport interface CslItem {\n  type: CslType\n  author?: CslName[]\n  editor?: CslName[]\n  issued?: CslDate\n  'container-title'?: string\n  volume?: string\n  issue?: string\n  page?: string\n  publisher?: string\n  'publisher-place'?: string\n  DOI?: string\n  ISBN?: string\n  URL?: string\n  abstract?: string\n  language?: string\n}\n\n/** What `ai.extract` makes of a stored asset; `auto` picks by the asset's MIME type. */\nexport type ExtractMethod = 'auto' | 'transcription' | 'pdf-text' | 'ocr' | 'description' | 'bibliography'\n/** Body of the extract route: the stored asset `documentId`/`name` and what to make of it. */\nexport interface ExtractRequest {\n  documentId: string\n  /** The asset to read; absent only for `bibliography` with a `doi` (the work is looked up by DOI alone). */\n  name?: string\n  method: ExtractMethod\n  /** The model of `ocr`, `description` and model-based bibliography extraction. */\n  model: ModelRef\n  /** Also extract bibliographic data after `pdf-text`/`ocr`. */\n  bibliography?: boolean\n  /** DOI to look up for `bibliography`; absent = found in the first pages' text. */\n  doi?: string\n  /** PDF page cap (default 200). `ocr` reads at most 50 pages whatever this allows (one model call per page; `ocr-truncated` warns). */\n  maxPages?: number\n}\nexport interface ExtractResponse {\n  method: Exclude<ExtractMethod, 'auto'>\n  /** The readable content as Markdown (empty for `bibliography`). */\n  markdown: string\n  /** Transcription only: the timed segments `markdown` was made of. */\n  segments?: { start: number, end: number, text: string }[]\n  /** When bibliographic data was requested or the method is `bibliography`; `title` is the work's title when found (never stored in `meta.bib`). */\n  bib?: CslItem & { title?: string }\n  /** Transcription only: the speech-to-text model that wrote it (`TranscriptionConfig.model`), which the client cannot know. */\n  model?: string\n  /** SHA-256 (hex) of the asset bytes. */\n  inputHash: string\n  /** SHA-256 (hex) of the stored raw output (`markdown` as the asset `output` holds it). The client does not compare it: it hashes the body it writes (its re-serialised Markdown) into `Derivation.outputHash` itself. */\n  outputHash: string\n  /** Asset name (same document) of the stored raw Markdown; `null` for `bibliography`. */\n  output: string | null\n  warnings: string[]\n}\n\n/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */\nexport type CommentAuthor = AuthorIdentity\n\nexport interface CommentReply {\n  id: string\n  author: CommentAuthor\n  text: string\n  /** ISO timestamps; `editedAt` once the author changed the text. */\n  createdAt: string\n  editedAt?: string\n}\n\n/**\n * Where a thread's text starts, as the JSON form of a Yjs relative position (`Y.relativePositionToJSON`): bound to the\n * first commented character, so it keeps pointing at the place after that text was deleted (and moves with the text\n * around it). Stored in the thread's `Y.Map` under `anchor`, so every collaborator resolves the same place.\n */\nexport interface CommentAnchor {\n  type?: { client: number, clock: number }\n  tname?: string\n  item?: { client: number, clock: number }\n  assoc?: number\n}\n\n/**\n * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`\n * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the\n * `comment` mark with the thread's `id`.\n */\nexport interface CommentThread {\n  id: string\n  author: CommentAuthor\n  text: string\n  createdAt: string\n  editedAt?: string\n  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */\n  quote: string\n  /** Resolved threads are kept, without highlight, until reopened. */\n  resolved: boolean\n  /**\n   * Start of the commented text as a Yjs relative position, written when the thread is created (older threads get it\n   * once they are seen with their text still in the document). Tells where an orphaned thread's text was. Absent on threads\n   * not yet seen with a range, and when the position could not be captured.\n   */\n  anchor?: CommentAnchor\n  replies: CommentReply[]\n}\n\n/** A text range in the editor document. */\nexport type DocRange = { from: number, to: number }\n\n/** What a comments UI renders: replaced (a new object) whenever any part of it changes, so a store subscriber re-renders only then. */\nexport interface CommentsSnapshot {\n  /** Comments need a collaborative editor whose `Comments` extension has a user (a host model decides for itself). */\n  available: boolean\n  /**\n   * Whether the user may compose a comment now: the default model says `available` and the editor is editable, a host\n   * model may allow readers of a read-only document to comment.\n   */\n  canComment: boolean\n  user: AuthorIdentity | null\n  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */\n  threads: readonly CommentThread[]\n  /** Current text range per thread id (threads without one are orphans). */\n  ranges: ReadonlyMap<string, DocRange>\n  /**\n   * Where the text of an orphaned open thread was: the document position of the deletion point, resolved from the\n   * thread's stored anchor (so it is the same place for every collaborator and follows edits). Absent for orphans\n   * without a usable anchor (threads from before anchors, or whose block is gone for good).\n   */\n  orphanAt: ReadonlyMap<string, number>\n  active: string | null\n  /** Current range of the draft a new comment is being written for. */\n  draft: DocRange | null\n  /** The draft's text as the new thread will keep it (`quote`). */\n  draftQuote: string\n  /** Unresolved threads in document order, orphans last; resolved ones newest first. */\n  open: readonly CommentThread[]\n  resolved: readonly CommentThread[]\n}\n\n/** The mutations of the comments of one editor; no-ops without collaboration or a user. */\nexport interface CommentsActions {\n  /** Creates a thread on the draft range; its id, or null without a (non-empty) draft or text. */\n  add: (text: string) => string | null\n  reply: (threadId: string, text: string) => void\n  /** Changes the text of the user's own thread (`replyId` null) or reply. */\n  edit: (threadId: string, replyId: string | null, text: string) => void\n  /** Resolves or reopens a thread (anyone may). */\n  setResolved: (threadId: string, resolved: boolean) => void\n  /** Deletes the user's own thread with its marks / the user's own reply. */\n  remove: (threadId: string) => void\n  removeReply: (threadId: string, replyId: string) => void\n  /** Activates a thread (`null`: none); `reveal` selects and scrolls to its text. */\n  activate: (id: string | null, options?: { reveal?: boolean }) => void\n  /** Starts a comment on the current selection (the layout shows the composer while `draft` is set). */\n  startDraft: () => void\n  cancelDraft: () => void\n}\n\n/**\n * The comments of one editor, framework-free: `state` is the observable snapshot, `refresh()` brings it up to date\n * (the framework hook calls it when the editor it watches changes; the model itself listens to that editor's\n * transactions from then on), `dispose()` detaches the editor and Y.Doc listeners and may be followed by `refresh()` again\n * (StrictMode mounts twice).\n */\nexport interface CommentsModel extends CommentsActions {\n  readonly state: ReadonlyStore<CommentsSnapshot>\n  refresh: () => void\n  dispose: () => void\n}\n\n/** A reference or a previous generation of the Bild-Studio (`images.generate` and `images.upload` answer one). `active` = goes into the next generation. */\nexport interface ImageStudioImage {\n  /** Host-opaque. */\n  id: string\n  url: string\n  title: string\n  active: boolean\n}\n\n/** A managed Prompt-Baustein (style, brand, …) of the host. */\nexport interface ImageStudioPromptBlock {\n  id: string\n  label: string\n  text: string\n}\n\n/** Body of the image-generation route (`images.generate`): what the Bild-Studio sends for one chat turn. */\nexport interface ImageStudioGenerateBody {\n  /** The block's description of the image. */\n  description: string\n  /** This turn's instruction; `''` generates from the description alone. */\n  instruction: string\n  /** The active Prompt-Bausteine, by the host's ids. */\n  promptBlockIds: string[]\n  /** The URLs of the active references and generations that go into the generation as reference images. */\n  referenceUrls: string[]\n}\n"],"mappings":";;AAmDA,MAAa,YAAY;CAAC;CAAmB;CAAQ;CAAW;CAAoB;CAAU;CAAU;CAAW;CAAW;AAAS"}
+{"version":3,"file":"backend-types.js","names":[],"sources":["../../src/core/backend-types.ts"],"sourcesContent":["import type { ReadonlyStore } from './store'\nimport type { AuthorIdentity } from './feature'\n\n// The wire and model types that `EditorBackend` (`./backend`) names in its methods. They live in core, not in the\n// features they belong to, so the port does not depend on any feature or integration; each feature's public entry\n// (`@ecsplico/editor/mentions/schema`, `…/themes/schema`, `…/ai/protocol`, `…/comments/schema`, …) exports the names\n// it always had. Types only: DOM-free, importable from server code.\n\n/** A user as offered for `@` mentions (`GET /api/editor/users`); never carries credentials. */\nexport interface MentionUser {\n  id: string\n  username: string\n  color: string\n}\n\n/** Profile as the client sees it; presets never expose their key. */\nexport interface ModelProfile { id: string, label: string, endpoint: string, model: string, source: 'preset' | 'user' }\n\n/** Model an AI request runs on: a server preset by id, or an OpenAI-compatible endpoint with its own key. */\nexport type ModelRef = { preset: string } | { endpoint: string, model: string, apiKey: string }\n\n/** A theme in the shared library; `builtin` themes are seeded by the host and cannot be deleted. */\nexport interface ThemeRecord {\n  id: string\n  name: string\n  version?: string\n  author?: string\n  authorUrl?: string\n  builtin: boolean\n}\n\n/** One transcript segment sent for cleanup. */\nexport interface TranscriptCleanupSegment {\n  /** Block ID of the segment (`blockIdOf`). */\n  id: string\n  speaker: string\n  /** The segment's inline content as Markdown (mentions as `@name`, tags as `#name`). */\n  text: string\n}\n/** Body of the transcript-cleanup route. */\nexport interface TranscriptCleanupRequest { segments: TranscriptCleanupSegment[], model: ModelRef }\n/** Cleaned text (single-line inline Markdown) of the segment with block ID `id`. */\nexport interface TranscriptCleanupResult { id: string, text: string }\n/** `cleaned`: only segments whose text changed. `failed`: segments of chunks whose model answer was unusable (left as they are). */\nexport interface TranscriptCleanupResponse { cleaned: TranscriptCleanupResult[], failed: number }\n\n/** A CSL name: `family`/`given` for a person, `literal` for an institution or an unparsed name. */\nexport interface CslName { family?: string, given?: string, literal?: string }\nexport interface CslDate { 'date-parts': number[][] }\n\n/** The CSL item types the editor offers (select options, server-side schema). */\nexport const CSL_TYPES = ['article-journal', 'book', 'chapter', 'paper-conference', 'thesis', 'report', 'webpage', 'article', 'dataset'] as const\nexport type CslType = typeof CSL_TYPES[number]\n\n/** A CSL-JSON item without `id` and `title`: the Typed block's block id and title are authoritative for those and never stored in `meta.bib`. */\nexport interface CslItem {\n  type: CslType\n  author?: CslName[]\n  editor?: CslName[]\n  issued?: CslDate\n  'container-title'?: string\n  volume?: string\n  issue?: string\n  page?: string\n  publisher?: string\n  'publisher-place'?: string\n  DOI?: string\n  ISBN?: string\n  URL?: string\n  abstract?: string\n  language?: string\n}\n\n/** What `ai.extract` makes of a stored asset; `auto` picks by the asset's MIME type. */\nexport type ExtractMethod = 'auto' | 'transcription' | 'pdf-text' | 'ocr' | 'description' | 'bibliography'\n/** Body of the extract route: the stored asset `documentId`/`name` and what to make of it. */\nexport interface ExtractRequest {\n  documentId: string\n  /** The asset to read; absent only for `bibliography` with a `doi` (the work is looked up by DOI alone). */\n  name?: string\n  method: ExtractMethod\n  /** The model of `ocr`, `description` and model-based bibliography extraction. */\n  model: ModelRef\n  /** Also extract bibliographic data after `pdf-text`/`ocr`. */\n  bibliography?: boolean\n  /** DOI to look up for `bibliography`; absent = found in the first pages' text. */\n  doi?: string\n  /** PDF page cap (default 200). `ocr` reads at most 50 pages whatever this allows (one model call per page; `ocr-truncated` warns). */\n  maxPages?: number\n}\nexport interface ExtractResponse {\n  method: Exclude<ExtractMethod, 'auto'>\n  /** The readable content as Markdown (empty for `bibliography`). */\n  markdown: string\n  /** Transcription only: the timed segments `markdown` was made of. */\n  segments?: { start: number, end: number, text: string }[]\n  /** When bibliographic data was requested or the method is `bibliography`; `title` is the work's title when found (never stored in `meta.bib`). */\n  bib?: CslItem & { title?: string }\n  /** Transcription only: the speech-to-text model that wrote it (`TranscriptionConfig.model`), which the client cannot know. */\n  model?: string\n  /** SHA-256 (hex) of the asset bytes. */\n  inputHash: string\n  /** SHA-256 (hex) of the stored raw output (`markdown` as the asset `output` holds it). The client does not compare it: it hashes the body it writes (its re-serialised Markdown) into `Derivation.outputHash` itself. */\n  outputHash: string\n  /** Asset name (same document) of the stored raw Markdown; `null` for `bibliography`. */\n  output: string | null\n  warnings: string[]\n}\n\n/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */\nexport type CommentAuthor = AuthorIdentity\n\nexport interface CommentReply {\n  id: string\n  author: CommentAuthor\n  text: string\n  /** ISO timestamps; `editedAt` once the author changed the text. */\n  createdAt: string\n  editedAt?: string\n}\n\n/**\n * Where a thread's text starts, as the JSON form of a Yjs relative position (`Y.relativePositionToJSON`): bound to the\n * first commented character, so it keeps pointing at the place after that text was deleted (and moves with the text\n * around it). Stored in the thread's `Y.Map` under `anchor`, so every collaborator resolves the same place.\n */\nexport interface CommentAnchor {\n  type?: { client: number, clock: number }\n  tname?: string\n  item?: { client: number, clock: number }\n  assoc?: number\n}\n\n/**\n * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`\n * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the\n * `comment` mark with the thread's `id`.\n */\nexport interface CommentThread {\n  id: string\n  author: CommentAuthor\n  text: string\n  createdAt: string\n  editedAt?: string\n  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */\n  quote: string\n  /** Resolved threads are kept, without highlight, until reopened. */\n  resolved: boolean\n  /**\n   * Start of the commented text as a Yjs relative position, written when the thread is created (older threads get it\n   * once they are seen with their text still in the document). Tells where an orphaned thread's text was. Absent on threads\n   * not yet seen with a range, and when the position could not be captured.\n   */\n  anchor?: CommentAnchor\n  replies: CommentReply[]\n}\n\n/** A text range in the editor document. */\nexport type DocRange = { from: number, to: number }\n\n/** What a comments UI renders: replaced (a new object) whenever any part of it changes, so a store subscriber re-renders only then. */\nexport interface CommentsSnapshot {\n  /** Comments need a collaborative editor whose `Comments` extension has a user (a host model decides for itself). */\n  available: boolean\n  /**\n   * Whether the user may compose a comment now: the default model says `available` and the editor is editable, a host\n   * model may allow readers of a read-only document to comment.\n   */\n  canComment: boolean\n  user: AuthorIdentity | null\n  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */\n  threads: readonly CommentThread[]\n  /** Current text range per thread id (threads without one are orphans). */\n  ranges: ReadonlyMap<string, DocRange>\n  /**\n   * Where the text of an orphaned open thread was: the document position of the deletion point, resolved from the\n   * thread's stored anchor (so it is the same place for every collaborator and follows edits). Absent for orphans\n   * without a usable anchor (threads from before anchors, or whose block is gone for good).\n   */\n  orphanAt: ReadonlyMap<string, number>\n  active: string | null\n  /** Current range of the draft a new comment is being written for. */\n  draft: DocRange | null\n  /** The draft's text as the new thread will keep it (`quote`). */\n  draftQuote: string\n  /** Unresolved threads in document order, orphans last; resolved ones newest first. */\n  open: readonly CommentThread[]\n  resolved: readonly CommentThread[]\n}\n\n/** The mutations of the comments of one editor; no-ops without collaboration or a user. */\nexport interface CommentsActions {\n  /** Creates a thread on the draft range; its id, or null without a (non-empty) draft or text. */\n  add: (text: string) => string | null\n  reply: (threadId: string, text: string) => void\n  /** Changes the text of the user's own thread (`replyId` null) or reply. */\n  edit: (threadId: string, replyId: string | null, text: string) => void\n  /** Resolves or reopens a thread (anyone may). */\n  setResolved: (threadId: string, resolved: boolean) => void\n  /** Deletes the user's own thread with its marks / the user's own reply. */\n  remove: (threadId: string) => void\n  removeReply: (threadId: string, replyId: string) => void\n  /** Activates a thread (`null`: none); `reveal` selects and scrolls to its text. */\n  activate: (id: string | null, options?: { reveal?: boolean }) => void\n  /** Starts a comment on the current selection (the layout shows the composer while `draft` is set). */\n  startDraft: () => void\n  cancelDraft: () => void\n}\n\n/**\n * The comments of one editor, framework-free: `state` is the observable snapshot, `refresh()` brings it up to date\n * (the framework hook calls it when the editor it watches changes; the model itself listens to that editor's\n * transactions from then on), `dispose()` detaches the editor and Y.Doc listeners and may be followed by `refresh()` again\n * (StrictMode mounts twice).\n */\nexport interface CommentsModel extends CommentsActions {\n  readonly state: ReadonlyStore<CommentsSnapshot>\n  refresh: () => void\n  dispose: () => void\n}\n\n/** A reference or a previous generation of the Bild-Studio (`images.generate` and `images.upload` answer one). `active` = goes into the next generation. */\nexport interface ImageStudioImage {\n  /** Host-opaque. */\n  id: string\n  url: string\n  title: string\n  active: boolean\n}\n\n/** A managed prompt block (style, brand, …) of the host. */\nexport interface ImageStudioPromptBlock {\n  id: string\n  label: string\n  text: string\n}\n\n/** Body of the image-generation route (`images.generate`): what the Bild-Studio sends for one chat turn. */\nexport interface ImageStudioGenerateBody {\n  /** The block's description of the image. */\n  description: string\n  /** This turn's instruction; `''` generates from the description alone. */\n  instruction: string\n  /** The active prompt blocks, by the host's ids. */\n  promptBlockIds: string[]\n  /** The URLs of the active references and generations that go into the generation as reference images. */\n  referenceUrls: string[]\n}\n"],"mappings":";;AAmDA,MAAa,YAAY;CAAC;CAAmB;CAAQ;CAAW;CAAoB;CAAU;CAAU;CAAW;CAAW;AAAS"}

package/dist/core/backend.d.ts

@@ -1,4 +1,4 @@
-import { ModelSlot } from "../settings/values.js";
+import { ModelRole } from "../settings/values.js";
 import { EditorSettings } from "../settings/index.js";
 import { BackendCapability } from "./backend-capability.js";
 import { AuthorIdentity } from "./feature.js";
@@ -85,7 +85,7 @@ export interface EditorBackend {
   ai?: {
     models: () => Promise<{
       presets: ModelProfile[];
-      slots: Record<ModelSlot, string>;
+      roles: Record<ModelRole, string>;
     }>;
     complete: (body: {
       before: string;
@@ -101,9 +101,9 @@ export interface EditorBackend {
     extract: (body: ExtractRequest, signal: AbortSignal) => Promise<ExtractResponse>;
   };
   images?: {
-    /** The Prompt-Bausteine (style, brand, …) the host manages, in the order it lists them. */
+    /** The prompt blocks (style, brand, …) the host manages, in the order it lists them. */
     promptBlocks: () => Promise<ImageStudioPromptBlock[]>;
-    /** Generates one image from the description, the instruction, the active Prompt-Bausteine and the reference images; resolves with the stored image (`active: false`). */
+    /** Generates one image from the description, the instruction, the active prompt blocks and the reference images; resolves with the stored image (`active: false`). */
     generate: (body: ImageStudioGenerateBody, signal?: AbortSignal) => Promise<ImageStudioImage>;
     /** Stores `file` as a reference image for document `documentId`; resolves with the stored image (`active: true`). */
     upload: (documentId: string, file: File) => Promise<ImageStudioImage>;

package/dist/core/backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend.js","names":[],"sources":["../../src/core/backend.ts"],"sourcesContent":["import type { HocuspocusProvider } from '@hocuspocus/provider'\nimport type { Editor, JSONContent } from '@tiptap/core'\nimport type * as Y from 'yjs'\nimport type { EditorSettings, ModelSlot } from '../settings'\nimport type { BackendCapability } from './backend-capability'\nimport type { CommentsModel, ExtractRequest, ExtractResponse, ImageStudioGenerateBody, ImageStudioImage, ImageStudioPromptBlock, MentionUser, ModelProfile, ModelRef, ThemeRecord, TranscriptCleanupRequest, TranscriptCleanupResponse } from './backend-types'\nimport type { AuthorIdentity } from './feature'\n\n// The client side of the data layer: everything the editor and its features ask of the host's backend (documents,\n// uploads, mention lookups, settings, themes, AI, collaboration, comments) is one method of `EditorBackend`. Two\n// adapters implement it: HTTP (`@ecsplico/editor/adapters/http`, the `/api/editor` and `/api/ai` routes the Nuxt module\n// and `installEditorServer` serve) and the host's own. A capability the backend does not offer is `undefined`.\n\n/** What a backend can do; the server's `EditorPorts` use the same names. */\nexport type { BackendCapability }\n\n/** One server-sent event of an AI stream (`delta` `{ text }`, `ops` the proposed edit operations, `done`, `error` `{ message }`). `data` is the parsed JSON payload (`{}` without one). */\nexport interface AiStreamEvent {\n  event: 'delta' | 'ops' | 'done' | 'error'\n  data: unknown\n}\n\n/** The token a collaboration server's `authenticate` receives: a string, or a function (also async) that returns it on each connect. */\nexport type CollaborationToken = string | (() => string) | (() => Promise<string>)\n\n/** A refused or failed backend request; `status` is the HTTP status (or its equivalent) and `message` the server's, when it sent one. */\nexport class BackendError extends Error {\n  constructor(message: string, readonly status: number, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'BackendError'\n  }\n}\n\n/** What a backend needs from the host to give a comments model its anchors and its author. */\nexport interface BackendCommentsOptions {\n  /** Who writes: the author of new comments; `null` while nobody is signed in. */\n  user: () => AuthorIdentity | null\n  /** Whether the user may compose and change comments now. */\n  canComment: () => boolean\n  /** The editor the threads belong to; may return no editor yet or a destroyed one. */\n  getEditor: () => Editor | undefined\n  /** Called with every failed request. */\n  onError?: (error: Error) => void\n}\n\nexport interface EditorBackend {\n  /** Names the backend in error messages (`'http'`, `'memory'`, …). */\n  readonly name: string\n  /**\n   * Settles once the backend knows which capabilities it really has (the HTTP adapter's `probe`, which drops what the\n   * server lacks). `createEditorContext` awaits it before it reports `ready`, so a composition that prunes by capability\n   * (`composeEditor(…, { backend })`) should run after it too. Never rejects; absent: usable at once.\n   */\n  readonly ready?: Promise<void>\n  documents?: {\n    /** The stored content; `null` when the document does not exist (yet). */\n    load: (id: string) => Promise<JSONContent | null>\n    save: (id: string, content: JSONContent) => Promise<void>\n  }\n  collaboration?: {\n    /** Opens the live session of document `id`; `dispose()` closes the provider and the Y.Doc. */\n    connect: (id: string, token?: CollaborationToken) => { ydoc: Y.Doc, provider: HocuspocusProvider, dispose: () => void }\n  }\n  assets?: {\n    /** Stores `file` for document `documentId`; resolves with the URL it is addressed by and, when the backend hashes uploads, the SHA-256 (hex) of its bytes. */\n    upload: (documentId: string, file: File) => Promise<{ url: string, sha256?: string }>\n  }\n  users?: {\n    search: (query: string, signal?: AbortSignal) => Promise<MentionUser[]>\n  }\n  tags?: {\n    search: (query: string, signal?: AbortSignal) => Promise<string[]>\n  }\n  settings?: {\n    /** The account's settings; `null` when it has none stored yet. */\n    load: () => Promise<EditorSettings | null>\n    save: (settings: EditorSettings) => Promise<void>\n  }\n  themes?: {\n    list: () => Promise<ThemeRecord[]>\n    /** The stylesheet of theme `id` (unscoped). */\n    css: (id: string) => Promise<string>\n    /** Adds an Obsidian theme to the shared library: the stylesheet and, optionally, its `manifest.json`; the backend derives name and id. */\n    store: (files: { css: File, manifest?: File }) => Promise<ThemeRecord>\n    /** Deletes an uploaded theme; rejects for builtins and unknown ids. */\n    remove: (id: string) => Promise<boolean>\n  }\n  ai?: {\n    models: () => Promise<{ presets: ModelProfile[], slots: Record<ModelSlot, string> }>\n    complete: (body: { before: string, model: ModelRef }, signal: AbortSignal) => Promise<{ text: string }>\n    /** Streams the SSE events of `generate` or `chat`; throws `BackendError` (with `status`) on a non-2xx answer before the stream starts. */\n    stream: (path: 'generate' | 'chat', body: object, signal: AbortSignal) => AsyncIterable<AiStreamEvent>\n    /** Speaker-segment cleanup of a transcript (one JSON answer, not a stream). */\n    transcriptCleanup: (body: TranscriptCleanupRequest, signal: AbortSignal) => Promise<TranscriptCleanupResponse>\n    /** Turns a stored asset into readable content: transcription (with segment timestamps), PDF text or OCR, an image description, bibliographic data. */\n    extract: (body: ExtractRequest, signal: AbortSignal) => Promise<ExtractResponse>\n  }\n  images?: {\n    /** The Prompt-Bausteine (style, brand, …) the host manages, in the order it lists them. */\n    promptBlocks: () => Promise<ImageStudioPromptBlock[]>\n    /** Generates one image from the description, the instruction, the active Prompt-Bausteine and the reference images; resolves with the stored image (`active: false`). */\n    generate: (body: ImageStudioGenerateBody, signal?: AbortSignal) => Promise<ImageStudioImage>\n    /** Stores `file` as a reference image for document `documentId`; resolves with the stored image (`active: true`). */\n    upload: (documentId: string, file: File) => Promise<ImageStudioImage>\n  }\n  /** The comments model of document `documentId`. */\n  comments?: (documentId: string, options: BackendCommentsOptions) => CommentsModel\n}\n"],"mappings":";;AA0BA,IAAa,eAAb,cAAkC,MAAM;CACA;CAAtC,YAAY,SAAiB,QAAyB,SAAwB;EAC5E,MAAM,SAAS,OAAO;EADc,KAAA,SAAA;EAEpC,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"backend.js","names":[],"sources":["../../src/core/backend.ts"],"sourcesContent":["import type { HocuspocusProvider } from '@hocuspocus/provider'\nimport type { Editor, JSONContent } from '@tiptap/core'\nimport type * as Y from 'yjs'\nimport type { EditorSettings, ModelRole } from '../settings'\nimport type { BackendCapability } from './backend-capability'\nimport type { CommentsModel, ExtractRequest, ExtractResponse, ImageStudioGenerateBody, ImageStudioImage, ImageStudioPromptBlock, MentionUser, ModelProfile, ModelRef, ThemeRecord, TranscriptCleanupRequest, TranscriptCleanupResponse } from './backend-types'\nimport type { AuthorIdentity } from './feature'\n\n// The client side of the data layer: everything the editor and its features ask of the host's backend (documents,\n// uploads, mention lookups, settings, themes, AI, collaboration, comments) is one method of `EditorBackend`. Two\n// adapters implement it: HTTP (`@ecsplico/editor/adapters/http`, the `/api/editor` and `/api/ai` routes the Nuxt module\n// and `installEditorServer` serve) and the host's own. A capability the backend does not offer is `undefined`.\n\n/** What a backend can do; the server's `EditorPorts` use the same names. */\nexport type { BackendCapability }\n\n/** One server-sent event of an AI stream (`delta` `{ text }`, `ops` the proposed edit operations, `done`, `error` `{ message }`). `data` is the parsed JSON payload (`{}` without one). */\nexport interface AiStreamEvent {\n  event: 'delta' | 'ops' | 'done' | 'error'\n  data: unknown\n}\n\n/** The token a collaboration server's `authenticate` receives: a string, or a function (also async) that returns it on each connect. */\nexport type CollaborationToken = string | (() => string) | (() => Promise<string>)\n\n/** A refused or failed backend request; `status` is the HTTP status (or its equivalent) and `message` the server's, when it sent one. */\nexport class BackendError extends Error {\n  constructor(message: string, readonly status: number, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'BackendError'\n  }\n}\n\n/** What a backend needs from the host to give a comments model its anchors and its author. */\nexport interface BackendCommentsOptions {\n  /** Who writes: the author of new comments; `null` while nobody is signed in. */\n  user: () => AuthorIdentity | null\n  /** Whether the user may compose and change comments now. */\n  canComment: () => boolean\n  /** The editor the threads belong to; may return no editor yet or a destroyed one. */\n  getEditor: () => Editor | undefined\n  /** Called with every failed request. */\n  onError?: (error: Error) => void\n}\n\nexport interface EditorBackend {\n  /** Names the backend in error messages (`'http'`, `'memory'`, …). */\n  readonly name: string\n  /**\n   * Settles once the backend knows which capabilities it really has (the HTTP adapter's `probe`, which drops what the\n   * server lacks). `createEditorContext` awaits it before it reports `ready`, so a composition that prunes by capability\n   * (`composeEditor(…, { backend })`) should run after it too. Never rejects; absent: usable at once.\n   */\n  readonly ready?: Promise<void>\n  documents?: {\n    /** The stored content; `null` when the document does not exist (yet). */\n    load: (id: string) => Promise<JSONContent | null>\n    save: (id: string, content: JSONContent) => Promise<void>\n  }\n  collaboration?: {\n    /** Opens the live session of document `id`; `dispose()` closes the provider and the Y.Doc. */\n    connect: (id: string, token?: CollaborationToken) => { ydoc: Y.Doc, provider: HocuspocusProvider, dispose: () => void }\n  }\n  assets?: {\n    /** Stores `file` for document `documentId`; resolves with the URL it is addressed by and, when the backend hashes uploads, the SHA-256 (hex) of its bytes. */\n    upload: (documentId: string, file: File) => Promise<{ url: string, sha256?: string }>\n  }\n  users?: {\n    search: (query: string, signal?: AbortSignal) => Promise<MentionUser[]>\n  }\n  tags?: {\n    search: (query: string, signal?: AbortSignal) => Promise<string[]>\n  }\n  settings?: {\n    /** The account's settings; `null` when it has none stored yet. */\n    load: () => Promise<EditorSettings | null>\n    save: (settings: EditorSettings) => Promise<void>\n  }\n  themes?: {\n    list: () => Promise<ThemeRecord[]>\n    /** The stylesheet of theme `id` (unscoped). */\n    css: (id: string) => Promise<string>\n    /** Adds an Obsidian theme to the shared library: the stylesheet and, optionally, its `manifest.json`; the backend derives name and id. */\n    store: (files: { css: File, manifest?: File }) => Promise<ThemeRecord>\n    /** Deletes an uploaded theme; rejects for builtins and unknown ids. */\n    remove: (id: string) => Promise<boolean>\n  }\n  ai?: {\n    models: () => Promise<{ presets: ModelProfile[], roles: Record<ModelRole, string> }>\n    complete: (body: { before: string, model: ModelRef }, signal: AbortSignal) => Promise<{ text: string }>\n    /** Streams the SSE events of `generate` or `chat`; throws `BackendError` (with `status`) on a non-2xx answer before the stream starts. */\n    stream: (path: 'generate' | 'chat', body: object, signal: AbortSignal) => AsyncIterable<AiStreamEvent>\n    /** Speaker-segment cleanup of a transcript (one JSON answer, not a stream). */\n    transcriptCleanup: (body: TranscriptCleanupRequest, signal: AbortSignal) => Promise<TranscriptCleanupResponse>\n    /** Turns a stored asset into readable content: transcription (with segment timestamps), PDF text or OCR, an image description, bibliographic data. */\n    extract: (body: ExtractRequest, signal: AbortSignal) => Promise<ExtractResponse>\n  }\n  images?: {\n    /** The prompt blocks (style, brand, …) the host manages, in the order it lists them. */\n    promptBlocks: () => Promise<ImageStudioPromptBlock[]>\n    /** Generates one image from the description, the instruction, the active prompt blocks and the reference images; resolves with the stored image (`active: false`). */\n    generate: (body: ImageStudioGenerateBody, signal?: AbortSignal) => Promise<ImageStudioImage>\n    /** Stores `file` as a reference image for document `documentId`; resolves with the stored image (`active: true`). */\n    upload: (documentId: string, file: File) => Promise<ImageStudioImage>\n  }\n  /** The comments model of document `documentId`. */\n  comments?: (documentId: string, options: BackendCommentsOptions) => CommentsModel\n}\n"],"mappings":";;AA0BA,IAAa,eAAb,cAAkC,MAAM;CACA;CAAtC,YAAY,SAAiB,QAAyB,SAAwB;EAC5E,MAAM,SAAS,OAAO;EADc,KAAA,SAAA;EAEpC,KAAK,OAAO;CACd;AACF"}

package/dist/core/block-convert.d.ts

@@ -48,7 +48,7 @@ export declare function blockConversion(providers: readonly ConversionProvider[]
 /**
  * Client-only, no schema: the `convertBlockTo` command over the preset's conversion providers — the „Umwandeln in …“
  * block action and the toolbar's conversion groups. One transaction, so one undo step. The target must pass the same
- * insert guards as creating that node there (`guardsAccept`): a Baustein kind its parent does not accept is refused.
+ * insert guards as creating that node there (`guardsAccept`): a Block type its parent does not accept is refused.
  */
 export declare const BlockConvert: Extension<any, any>;
 /**

package/dist/core/block-convert.js

@@ -1,8 +1,8 @@
 import { TYPE_ABILITIES } from "./schema/abilities.js";
 import { abilitiesAt } from "./abilities.js";
+import { isBlockContainer, isChromeNode } from "./schema/node-flags.js";
 import { conversionsOf } from "./pipeline.js";
 import { guardsAccept } from "./commands.js";
-import { isBlockContainer, isChromeNode } from "./schema/node-flags.js";
 import { convertCoreBlocks, convertTargetId, coreConversionTargets, isCoreTarget, parseCoreTarget } from "./convert.js";
 import { Extension } from "@tiptap/core";
 import { Selection } from "@tiptap/pm/state";
@@ -128,9 +128,9 @@ function createdBy(target) {
 			type: "heading",
 			attrs: { level: target.level }
 		};
-		case "composite": return {
-			type: "composite",
-			attrs: { kind: target.kind }
+		case "typedBlock": return {
+			type: "typedBlock",
+			attrs: { blockType: target.blockType }
 		};
 		case "custom": return {
 			type: target.id,
@@ -142,7 +142,7 @@ function createdBy(target) {
 /**
 * Client-only, no schema: the `convertBlockTo` command over the preset's conversion providers — the „Umwandeln in …“
 * block action and the toolbar's conversion groups. One transaction, so one undo step. The target must pass the same
-* insert guards as creating that node there (`guardsAccept`): a Baustein kind its parent does not accept is refused.
+* insert guards as creating that node there (`guardsAccept`): a Block type its parent does not accept is refused.
 */
 const BlockConvert = Extension.create({
 	name: "blockConvert",

package/dist/core/block-convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"block-convert.js","names":[],"sources":["../../src/core/block-convert.ts"],"sourcesContent":["import { type Editor, Extension } from '@tiptap/core'\nimport { Fragment, type Node as PMNode, type ResolvedPos } from '@tiptap/pm/model'\nimport { type EditorState, Selection } from '@tiptap/pm/state'\nimport { abilitiesAt } from './abilities'\nimport type { Creates, MenuItem } from './command-types'\nimport { guardsAccept } from './commands'\nimport { type ConvertTarget, convertCoreBlocks, convertTargetId, coreConversionTargets, isCoreTarget, parseCoreTarget } from './convert'\nimport type { BlockTarget } from './extension-points'\nimport type { ConversionProvider } from './feature'\nimport type { MessageKey, Translate } from '../i18n'\nimport { conversionsOf } from './pipeline'\nimport { isBlockContainer, isChromeNode } from './schema/node-flags'\nimport { TYPE_ABILITIES } from './schema/abilities'\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    blockConvert: {\n      /**\n       * Convert the block at `pos` (default: the caret's block in the document or another block container; a chrome\n       * node stands for its parent) into `target`. False when the conversion changes nothing or is impossible there.\n       */\n      convertBlockTo: (target: ConvertTarget, pos?: number) => ReturnType\n    }\n  }\n}\n\nconst CORE_LABELS: Record<string, { key: MessageKey, icon: string }> = {\n  paragraph: { key: 'block.paragraph', icon: 'i-lucide-pilcrow' },\n  bulletList: { key: 'block.bulletList', icon: 'i-lucide-list' },\n  orderedList: { key: 'block.orderedList', icon: 'i-lucide-list-ordered' },\n  blockquote: { key: 'block.blockquote', icon: 'i-lucide-text-quote' },\n  codeBlock: { key: 'block.codeBlock', icon: 'i-lucide-square-code' },\n}\n\n/**\n * The standard conversions: paragraphs, headings, lists, quotes and code blocks into each other. Declines every other\n * target, so features that add targets (speaker segments, composites) own them in their own providers.\n */\nexport const coreConversions: ConversionProvider = {\n  targets: (_editor, node) => coreConversionTargets(node),\n  parseTarget: parseCoreTarget,\n  label: (target, t) => {\n    if (target.type === 'heading') return { label: t('block.heading', { level: target.level }), icon: `i-lucide-heading-${target.level}` }\n    const core = isCoreTarget(target) ? CORE_LABELS[target.type] : undefined\n    return core ? { label: t(core.key), icon: core.icon } : null\n  },\n  convert: (state, $start, target) => {\n    const node = $start.nodeAfter\n    if (!node) return null\n    const blocks = convertCoreBlocks(state.schema, [node], target)\n    return blocks ? { from: $start.pos, to: $start.pos + node.nodeSize, blocks } : null\n  },\n}\n\n/** The provider that owns `target`: the first, in feature order, that parses its id. */\nexport function targetOwner(providers: readonly ConversionProvider[], target: ConvertTarget): ConversionProvider | undefined {\n  const id = convertTargetId(target)\n  return providers.find(provider => provider.parseTarget(id) !== null)\n}\n\n/** The target `id` names, by its owner; null when no provider knows it. */\nexport function parseConversionTarget(providers: readonly ConversionProvider[], id: string): ConvertTarget | null {\n  for (const provider of providers) {\n    const target = provider.parseTarget(id)\n    if (target) return target\n  }\n  return null\n}\n\n/** Label (in the language of `t`) and icon of `target`, from its owner. */\nexport function conversionLabel(providers: readonly ConversionProvider[], target: ConvertTarget, t: Translate): { label: string, icon: string } {\n  const label = targetOwner(providers, target)?.label(target, t)\n  if (!label) throw new Error(`@ecsplico/editor: no conversion provider owns the target \"${convertTargetId(target)}\"`)\n  return label\n}\n\n/** The targets offered for `node` per provider, in feature order; a target id offered twice is an error. */\nexport function conversionTargetGroups(providers: readonly ConversionProvider[], editor: Editor, node: PMNode): ConvertTarget[][] {\n  const offered = new Set<string>()\n  return providers.map(provider => provider.targets(editor, node).filter((target) => {\n    const id = convertTargetId(target)\n    if (offered.has(id)) throw new Error(`@ecsplico/editor: the conversion target \"${id}\" is advertised by more than one provider`)\n    offered.add(id)\n    return true\n  }))\n}\n\n/** The `$pos` right in front of the block to convert; a chrome node stands for its parent block. */\nfunction blockStart(state: EditorState, pos: number | undefined): ResolvedPos | null {\n  let $start: ResolvedPos\n  if (pos === undefined) {\n    // The caret's block whose parent is a block container (the document, a composite).\n    const { $head } = state.selection\n    let depth = $head.depth\n    while (depth > 0 && !isBlockContainer($head.node(depth - 1))) depth--\n    if (depth === 0) return null\n    $start = state.doc.resolve($head.before(depth))\n  }\n  else {\n    if (pos < 0 || pos >= state.doc.content.size) return null\n    $start = state.doc.resolve(pos)\n  }\n  const node = $start.nodeAfter\n  if (!node) return null\n  return isChromeNode(node) ? state.doc.resolve($start.before()) : $start\n}\n\n/**\n * The conversion of the block right after `$start` into `target`: the range it replaces and the converted blocks.\n * A provider claiming the source block (`handlesSource`) executes; otherwise the target's owner does. Null when the\n * conversion changes nothing or the result does not fit there (`parent.canReplace`). Shared by `convertBlockTo` and\n * the chat's `convert` op.\n */\nexport function blockConversion(providers: readonly ConversionProvider[], state: EditorState, $start: ResolvedPos, target: ConvertTarget): { from: number, to: number, blocks: PMNode[] } | null {\n  const node = $start.nodeAfter\n  if (!node) return null\n  const provider = providers.find(candidate => candidate.handlesSource?.(node)) ?? targetOwner(providers, target)\n  const conversion = provider?.convert(state, $start, target)\n  if (!conversion) return null\n  const parent = $start.parent\n  const $end = state.doc.resolve(conversion.to)\n  if ($end.parent !== parent || !parent.canReplace($start.index(), $end.index(), Fragment.from(conversion.blocks))) return null\n  return conversion\n}\n\n/** The node a conversion into `target` creates, as the insert guards see it (`Creates`). */\nfunction createdBy(target: ConvertTarget): Creates {\n  switch (target.type) {\n    case 'heading': return { type: 'heading', attrs: { level: target.level } }\n    case 'composite': return { type: 'composite', attrs: { kind: target.kind } }\n    case 'custom': return { type: target.id, ...(target.attrs && { attrs: target.attrs }) }\n    default: return { type: target.type }\n  }\n}\n\n/**\n * Client-only, no schema: the `convertBlockTo` command over the preset's conversion providers — the „Umwandeln in …“\n * block action and the toolbar's conversion groups. One transaction, so one undo step. The target must pass the same\n * insert guards as creating that node there (`guardsAccept`): a Baustein kind its parent does not accept is refused.\n */\nexport const BlockConvert = Extension.create({\n  name: 'blockConvert',\n\n  addCommands() {\n    return {\n      convertBlockTo: (target, pos) => ({ editor, state, tr, dispatch }) => {\n        const $start = blockStart(state, pos)\n        if (!$start) return false\n        const conversion = blockConversion(conversionsOf(editor), state, $start, target)\n        if (!conversion || !guardsAccept(editor, state.doc.resolve($start.start()), createdBy(target))) return false\n        if (dispatch) {\n          tr.replaceWith(conversion.from, conversion.to, conversion.blocks)\n          const $first = tr.doc.resolve(conversion.from)\n          tr.setSelection(Selection.findFrom($first, 1, true) ?? Selection.near($first)).scrollIntoView()\n        }\n        return true\n      },\n    }\n  },\n})\n\n/**\n * „Umwandeln in …“ entries for the block `target`: the targets the providers offer whose type the block's container\n * allows (`TYPE_ABILITIES`), one separated group per provider in feature order; targets the block cannot be converted\n * to right now are disabled. A list item stands for its list.\n */\nexport function convertMenuItems(editor: Editor, target: BlockTarget, t: Translate): MenuItem[] {\n  let { node, pos } = target\n  if (node.type.name === 'listItem') {\n    const $item = editor.state.doc.resolve(pos)\n    node = $item.parent\n    pos = $item.before()\n  }\n  const providers = conversionsOf(editor)\n  const abilities = abilitiesAt(editor, pos)\n  const groups = conversionTargetGroups(providers, editor, node)\n    .map(targets => targets\n      .filter(to => !TYPE_ABILITIES[to.type] || abilities.has(TYPE_ABILITIES[to.type]!))\n      .map((to): MenuItem => ({\n        ...conversionLabel(providers, to, t),\n        disabled: !editor.can().convertBlockTo(to, pos),\n        onSelect: () => editor.chain().focus().convertBlockTo(to, pos).run(),\n      })))\n    .filter(items => items.length > 0)\n  return groups.flatMap((items, index) => index ? [{ type: 'separator' } as const, ...items] : items)\n}\n"],"mappings":"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"}
+{"version":3,"file":"block-convert.js","names":[],"sources":["../../src/core/block-convert.ts"],"sourcesContent":["import { type Editor, Extension } from '@tiptap/core'\nimport { Fragment, type Node as PMNode, type ResolvedPos } from '@tiptap/pm/model'\nimport { type EditorState, Selection } from '@tiptap/pm/state'\nimport { abilitiesAt } from './abilities'\nimport type { Creates, MenuItem } from './command-types'\nimport { guardsAccept } from './commands'\nimport { type ConvertTarget, convertCoreBlocks, convertTargetId, coreConversionTargets, isCoreTarget, parseCoreTarget } from './convert'\nimport type { BlockTarget } from './extension-points'\nimport type { ConversionProvider } from './feature'\nimport type { MessageKey, Translate } from '../i18n'\nimport { conversionsOf } from './pipeline'\nimport { isBlockContainer, isChromeNode } from './schema/node-flags'\nimport { TYPE_ABILITIES } from './schema/abilities'\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    blockConvert: {\n      /**\n       * Convert the block at `pos` (default: the caret's block in the document or another block container; a chrome\n       * node stands for its parent) into `target`. False when the conversion changes nothing or is impossible there.\n       */\n      convertBlockTo: (target: ConvertTarget, pos?: number) => ReturnType\n    }\n  }\n}\n\nconst CORE_LABELS: Record<string, { key: MessageKey, icon: string }> = {\n  paragraph: { key: 'block.paragraph', icon: 'i-lucide-pilcrow' },\n  bulletList: { key: 'block.bulletList', icon: 'i-lucide-list' },\n  orderedList: { key: 'block.orderedList', icon: 'i-lucide-list-ordered' },\n  blockquote: { key: 'block.blockquote', icon: 'i-lucide-text-quote' },\n  codeBlock: { key: 'block.codeBlock', icon: 'i-lucide-square-code' },\n}\n\n/**\n * The standard conversions: paragraphs, headings, lists, quotes and code blocks into each other. Declines every other\n * target, so features that add targets (speaker segments, composites) own them in their own providers.\n */\nexport const coreConversions: ConversionProvider = {\n  targets: (_editor, node) => coreConversionTargets(node),\n  parseTarget: parseCoreTarget,\n  label: (target, t) => {\n    if (target.type === 'heading') return { label: t('block.heading', { level: target.level }), icon: `i-lucide-heading-${target.level}` }\n    const core = isCoreTarget(target) ? CORE_LABELS[target.type] : undefined\n    return core ? { label: t(core.key), icon: core.icon } : null\n  },\n  convert: (state, $start, target) => {\n    const node = $start.nodeAfter\n    if (!node) return null\n    const blocks = convertCoreBlocks(state.schema, [node], target)\n    return blocks ? { from: $start.pos, to: $start.pos + node.nodeSize, blocks } : null\n  },\n}\n\n/** The provider that owns `target`: the first, in feature order, that parses its id. */\nexport function targetOwner(providers: readonly ConversionProvider[], target: ConvertTarget): ConversionProvider | undefined {\n  const id = convertTargetId(target)\n  return providers.find(provider => provider.parseTarget(id) !== null)\n}\n\n/** The target `id` names, by its owner; null when no provider knows it. */\nexport function parseConversionTarget(providers: readonly ConversionProvider[], id: string): ConvertTarget | null {\n  for (const provider of providers) {\n    const target = provider.parseTarget(id)\n    if (target) return target\n  }\n  return null\n}\n\n/** Label (in the language of `t`) and icon of `target`, from its owner. */\nexport function conversionLabel(providers: readonly ConversionProvider[], target: ConvertTarget, t: Translate): { label: string, icon: string } {\n  const label = targetOwner(providers, target)?.label(target, t)\n  if (!label) throw new Error(`@ecsplico/editor: no conversion provider owns the target \"${convertTargetId(target)}\"`)\n  return label\n}\n\n/** The targets offered for `node` per provider, in feature order; a target id offered twice is an error. */\nexport function conversionTargetGroups(providers: readonly ConversionProvider[], editor: Editor, node: PMNode): ConvertTarget[][] {\n  const offered = new Set<string>()\n  return providers.map(provider => provider.targets(editor, node).filter((target) => {\n    const id = convertTargetId(target)\n    if (offered.has(id)) throw new Error(`@ecsplico/editor: the conversion target \"${id}\" is advertised by more than one provider`)\n    offered.add(id)\n    return true\n  }))\n}\n\n/** The `$pos` right in front of the block to convert; a chrome node stands for its parent block. */\nfunction blockStart(state: EditorState, pos: number | undefined): ResolvedPos | null {\n  let $start: ResolvedPos\n  if (pos === undefined) {\n    // The caret's block whose parent is a block container (the document, a composite).\n    const { $head } = state.selection\n    let depth = $head.depth\n    while (depth > 0 && !isBlockContainer($head.node(depth - 1))) depth--\n    if (depth === 0) return null\n    $start = state.doc.resolve($head.before(depth))\n  }\n  else {\n    if (pos < 0 || pos >= state.doc.content.size) return null\n    $start = state.doc.resolve(pos)\n  }\n  const node = $start.nodeAfter\n  if (!node) return null\n  return isChromeNode(node) ? state.doc.resolve($start.before()) : $start\n}\n\n/**\n * The conversion of the block right after `$start` into `target`: the range it replaces and the converted blocks.\n * A provider claiming the source block (`handlesSource`) executes; otherwise the target's owner does. Null when the\n * conversion changes nothing or the result does not fit there (`parent.canReplace`). Shared by `convertBlockTo` and\n * the chat's `convert` op.\n */\nexport function blockConversion(providers: readonly ConversionProvider[], state: EditorState, $start: ResolvedPos, target: ConvertTarget): { from: number, to: number, blocks: PMNode[] } | null {\n  const node = $start.nodeAfter\n  if (!node) return null\n  const provider = providers.find(candidate => candidate.handlesSource?.(node)) ?? targetOwner(providers, target)\n  const conversion = provider?.convert(state, $start, target)\n  if (!conversion) return null\n  const parent = $start.parent\n  const $end = state.doc.resolve(conversion.to)\n  if ($end.parent !== parent || !parent.canReplace($start.index(), $end.index(), Fragment.from(conversion.blocks))) return null\n  return conversion\n}\n\n/** The node a conversion into `target` creates, as the insert guards see it (`Creates`). */\nfunction createdBy(target: ConvertTarget): Creates {\n  switch (target.type) {\n    case 'heading': return { type: 'heading', attrs: { level: target.level } }\n    case 'typedBlock': return { type: 'typedBlock', attrs: { blockType: target.blockType } }\n    case 'custom': return { type: target.id, ...(target.attrs && { attrs: target.attrs }) }\n    default: return { type: target.type }\n  }\n}\n\n/**\n * Client-only, no schema: the `convertBlockTo` command over the preset's conversion providers — the „Umwandeln in …“\n * block action and the toolbar's conversion groups. One transaction, so one undo step. The target must pass the same\n * insert guards as creating that node there (`guardsAccept`): a Block type its parent does not accept is refused.\n */\nexport const BlockConvert = Extension.create({\n  name: 'blockConvert',\n\n  addCommands() {\n    return {\n      convertBlockTo: (target, pos) => ({ editor, state, tr, dispatch }) => {\n        const $start = blockStart(state, pos)\n        if (!$start) return false\n        const conversion = blockConversion(conversionsOf(editor), state, $start, target)\n        if (!conversion || !guardsAccept(editor, state.doc.resolve($start.start()), createdBy(target))) return false\n        if (dispatch) {\n          tr.replaceWith(conversion.from, conversion.to, conversion.blocks)\n          const $first = tr.doc.resolve(conversion.from)\n          tr.setSelection(Selection.findFrom($first, 1, true) ?? Selection.near($first)).scrollIntoView()\n        }\n        return true\n      },\n    }\n  },\n})\n\n/**\n * „Umwandeln in …“ entries for the block `target`: the targets the providers offer whose type the block's container\n * allows (`TYPE_ABILITIES`), one separated group per provider in feature order; targets the block cannot be converted\n * to right now are disabled. A list item stands for its list.\n */\nexport function convertMenuItems(editor: Editor, target: BlockTarget, t: Translate): MenuItem[] {\n  let { node, pos } = target\n  if (node.type.name === 'listItem') {\n    const $item = editor.state.doc.resolve(pos)\n    node = $item.parent\n    pos = $item.before()\n  }\n  const providers = conversionsOf(editor)\n  const abilities = abilitiesAt(editor, pos)\n  const groups = conversionTargetGroups(providers, editor, node)\n    .map(targets => targets\n      .filter(to => !TYPE_ABILITIES[to.type] || abilities.has(TYPE_ABILITIES[to.type]!))\n      .map((to): MenuItem => ({\n        ...conversionLabel(providers, to, t),\n        disabled: !editor.can().convertBlockTo(to, pos),\n        onSelect: () => editor.chain().focus().convertBlockTo(to, pos).run(),\n      })))\n    .filter(items => items.length > 0)\n  return groups.flatMap((items, index) => index ? [{ type: 'separator' } as const, ...items] : items)\n}\n"],"mappings":"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"}

package/dist/core/block-transfer.d.ts

@@ -7,9 +7,9 @@ export interface BlockTransfer {
   /** Document the block lives in; `null` when its editor has none. */
   documentId: string | null;
   blockId: string | null;
-  /** Composite kind id; `null` for every other block. */
-  kind: string | null;
-  /** Composite: its title text; other blocks: the first 80 characters of their text. */
+  /** Block type id of a Typed block; `null` for every other block. */
+  blockType: string | null;
+  /** Typed block: its title text; other blocks: the first 80 characters of their text. */
   title: string;
   json: JSONContent;
   /** The block as Markdown; empty when the editor has no Markdown serializer. */
@@ -19,7 +19,11 @@ export interface BlockTransfer {
 type TransferData = Pick<DataTransfer, 'setData' | 'getData' | 'types'>;
 /** Writes `payload` under `BLOCK_MIME`. */
 export declare function writeBlockTransfer(dataTransfer: Pick<DataTransfer, 'setData'>, payload: BlockTransfer): void;
-/** The block payload of a drag, or `null` when it carries none or one that does not parse or has the wrong shape. */
+/**
+ * The block payload of a drag, or `null` when it carries none or one that does not parse or has the wrong shape. A payload
+ * written before the rename of Typed blocks (Block type id in `kind`, `json` with old node and attribute names) is read
+ * as the current shape: `json` goes through `migratePersistedNames`, the Block type id is taken from `blockType` or `kind`.
+ */
 export declare function readBlockTransfer(dataTransfer: Partial<TransferData>): BlockTransfer | null;
 /**
  * The payload of the block whose own position is `pos`; `null` when `pos` holds no block. The Markdown is empty when

package/dist/core/block-transfer.js

@@ -1,4 +1,6 @@
 import { blockIdOf } from "./schema/block-ids.js";
+import { nodeAtPos } from "./util.js";
+import { TYPED_BLOCK, migratePersistedNames } from "./schema/persisted-names.js";
 import { Extension } from "@tiptap/core";
 //#region src/core/block-transfer.ts
 /** MIME type of the block payload a drag carries next to its plain text; another editor surface or document tree reads it on drop. */
@@ -9,7 +11,12 @@ function writeBlockTransfer(dataTransfer, payload) {
 	dataTransfer.setData(BLOCK_MIME, JSON.stringify(payload));
 }
 const isStringOrNull = (value) => value === null || typeof value === "string";
-/** The block payload of a drag, or `null` when it carries none or one that does not parse or has the wrong shape. */
+const isJSONContent = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && "type" in value && typeof value.type === "string";
+/**
+* The block payload of a drag, or `null` when it carries none or one that does not parse or has the wrong shape. A payload
+* written before the rename of Typed blocks (Block type id in `kind`, `json` with old node and attribute names) is read
+* as the current shape: `json` goes through `migratePersistedNames`, the Block type id is taken from `blockType` or `kind`.
+*/
 function readBlockTransfer(dataTransfer) {
 	if (!dataTransfer.types || !Array.from(dataTransfer.types).includes("application/x-tip-block")) return null;
 	let value;
@@ -19,15 +26,16 @@ function readBlockTransfer(dataTransfer) {
 		return null;
 	}
 	if (typeof value !== "object" || value === null) return null;
-	const { documentId, blockId, kind, title, json, markdown } = value;
-	if (!isStringOrNull(documentId) || !isStringOrNull(blockId) || !isStringOrNull(kind) || typeof title !== "string" || typeof markdown !== "string") return null;
-	if (typeof json !== "object" || json === null || Array.isArray(json) || typeof json.type !== "string") return null;
+	const { documentId, blockId, blockType: current, kind: old, title, json, markdown } = value;
+	const blockType = current === void 0 ? old : current;
+	if (!isStringOrNull(documentId) || !isStringOrNull(blockId) || !isStringOrNull(blockType) || typeof title !== "string" || typeof markdown !== "string") return null;
+	if (!isJSONContent(json)) return null;
 	return {
 		documentId,
 		blockId,
-		kind,
+		blockType,
 		title,
-		json,
+		json: migratePersistedNames(json),
 		markdown
 	};
 }
@@ -36,17 +44,16 @@ function readBlockTransfer(dataTransfer) {
 * `editor.markdown` is unavailable (a headless editor without `DocumentMarkdown`).
 */
 function blockTransferOf(editor, pos) {
-	if (pos < 0 || pos > editor.state.doc.content.size) return null;
-	const node = editor.state.doc.nodeAt(pos);
+	const node = nodeAtPos(editor.state.doc, pos);
 	if (!node || !node.isBlock) return null;
 	const json = node.toJSON();
-	const composite = node.type.name === "composite";
-	const kind = composite ? node.attrs.kind : null;
+	const typedBlock = node.type.name === TYPED_BLOCK;
+	const blockType = typedBlock ? node.attrs.blockType : null;
 	return {
-		documentId: editor.storage.blockTransfer?.documentId ?? null,
+		documentId: documentIdOf(editor),
 		blockId: blockIdOf(node),
-		kind: typeof kind === "string" ? kind : null,
-		title: composite ? node.firstChild?.textContent ?? "" : node.textContent.slice(0, TITLE_LENGTH),
+		blockType: typeof blockType === "string" ? blockType : null,
+		title: typedBlock ? node.firstChild?.textContent ?? "" : node.textContent.slice(0, TITLE_LENGTH),
 		json,
 		markdown: editor.markdown?.serialize({
 			type: "doc",
@@ -54,6 +61,8 @@ function blockTransferOf(editor, pos) {
 		}) ?? ""
 	};
 }
+/** The id of `editor`'s document as the `blockTransfer` storage knows it; null when the editor has none. */
+const documentIdOf = (editor) => editor.storage.blockTransfer?.documentId ?? null;
 /** Carries the editor's document id so `blockTransferOf` can name where a block comes from (`editor.storage.blockTransfer`). */
 const BlockTransferStorage = Extension.create({
 	name: "blockTransfer",
@@ -63,6 +72,6 @@ const BlockTransferStorage = Extension.create({
 	}
 });
 //#endregion
-export { BLOCK_MIME, BlockTransferStorage, blockTransferOf, readBlockTransfer, writeBlockTransfer };
+export { BLOCK_MIME, BlockTransferStorage, blockTransferOf, documentIdOf, readBlockTransfer, writeBlockTransfer };
 
 //# sourceMappingURL=block-transfer.js.map

package/dist/core/block-transfer.js.map

@@ -1 +1 @@
-{"version":3,"file":"block-transfer.js","names":[],"sources":["../../src/core/block-transfer.ts"],"sourcesContent":["import { type Editor, Extension, type JSONContent } from '@tiptap/core'\nimport { blockIdOf } from './schema/block-ids'\n\n/** MIME type of the block payload a drag carries next to its plain text; another editor surface or document tree reads it on drop. */\nexport const BLOCK_MIME = 'application/x-tip-block'\n\nconst TITLE_LENGTH = 80\n\n/** A block as it travels between editor surfaces and document trees. */\nexport interface BlockTransfer {\n  /** Document the block lives in; `null` when its editor has none. */\n  documentId: string | null\n  blockId: string | null\n  /** Composite kind id; `null` for every other block. */\n  kind: string | null\n  /** Composite: its title text; other blocks: the first 80 characters of their text. */\n  title: string\n  json: JSONContent\n  /** The block as Markdown; empty when the editor has no Markdown serializer. */\n  markdown: string\n}\n\n/** The minimal slice of `DataTransfer` the payload needs (a plain object in tests). */\ntype TransferData = Pick<DataTransfer, 'setData' | 'getData' | 'types'>\n\n/** Writes `payload` under `BLOCK_MIME`. */\nexport function writeBlockTransfer(dataTransfer: Pick<DataTransfer, 'setData'>, payload: BlockTransfer): void {\n  dataTransfer.setData(BLOCK_MIME, JSON.stringify(payload))\n}\n\nconst isStringOrNull = (value: unknown): value is string | null => value === null || typeof value === 'string'\n\n/** The block payload of a drag, or `null` when it carries none or one that does not parse or has the wrong shape. */\nexport function readBlockTransfer(dataTransfer: Partial<TransferData>): BlockTransfer | null {\n  if (!dataTransfer.types || !Array.from(dataTransfer.types).includes(BLOCK_MIME)) return null\n  let value: unknown\n  try {\n    value = JSON.parse(dataTransfer.getData?.(BLOCK_MIME) ?? '')\n  }\n  catch {\n    return null\n  }\n  if (typeof value !== 'object' || value === null) return null\n  const { documentId, blockId, kind, title, json, markdown } = value as Record<string, unknown>\n  if (!isStringOrNull(documentId) || !isStringOrNull(blockId) || !isStringOrNull(kind) || typeof title !== 'string' || typeof markdown !== 'string') return null\n  if (typeof json !== 'object' || json === null || Array.isArray(json) || typeof (json as { type?: unknown }).type !== 'string') return null\n  return { documentId, blockId, kind, title, json: json as JSONContent, markdown }\n}\n\n/**\n * The payload of the block whose own position is `pos`; `null` when `pos` holds no block. The Markdown is empty when\n * `editor.markdown` is unavailable (a headless editor without `DocumentMarkdown`).\n */\nexport function blockTransferOf(editor: Editor, pos: number): BlockTransfer | null {\n  // A position outside the document holds no node (`nodeAt` would throw).\n  if (pos < 0 || pos > editor.state.doc.content.size) return null\n  const node = editor.state.doc.nodeAt(pos)\n  if (!node || !node.isBlock) return null\n  const json = node.toJSON() as JSONContent\n  const composite = node.type.name === 'composite'\n  const kind: unknown = composite ? node.attrs.kind : null\n  return {\n    documentId: editor.storage.blockTransfer?.documentId ?? null,\n    blockId: blockIdOf(node),\n    kind: typeof kind === 'string' ? kind : null,\n    title: composite ? (node.firstChild?.textContent ?? '') : node.textContent.slice(0, TITLE_LENGTH),\n    json,\n    markdown: editor.markdown?.serialize({ type: 'doc', content: [json] }) ?? '',\n  }\n}\n\nexport interface BlockTransferStorageData {\n  documentId: string | null\n}\n\ndeclare module '@tiptap/core' {\n  interface Storage {\n    /** Absent in an editor without the `BlockTransferStorage` extension. */\n    blockTransfer?: BlockTransferStorageData\n  }\n}\n\n/** Carries the editor's document id so `blockTransferOf` can name where a block comes from (`editor.storage.blockTransfer`). */\nexport const BlockTransferStorage = Extension.create<{ documentId: string | null }, BlockTransferStorageData>({\n  name: 'blockTransfer',\n  addOptions: () => ({ documentId: null }),\n  addStorage() {\n    return { documentId: this.options.documentId }\n  },\n})\n"],"mappings":";;;;AAIA,MAAa,aAAa;AAE1B,MAAM,eAAe;;AAoBrB,SAAgB,mBAAmB,cAA6C,SAA8B;CAC5G,aAAa,QAAQ,YAAY,KAAK,UAAU,OAAO,CAAC;AAC1D;AAEA,MAAM,kBAAkB,UAA2C,UAAU,QAAQ,OAAO,UAAU;;AAGtG,SAAgB,kBAAkB,cAA2D;CAC3F,IAAI,CAAC,aAAa,SAAS,CAAC,MAAM,KAAK,aAAa,KAAK,CAAC,CAAC,SAAA,yBAAmB,GAAG,OAAO;CACxF,IAAI;CACJ,IAAI;EACF,QAAQ,KAAK,MAAM,aAAa,UAAA,yBAAoB,KAAK,EAAE;CAC7D,QACM;EACJ,OAAO;CACT;CACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,EAAE,YAAY,SAAS,MAAM,OAAO,MAAM,aAAa;CAC7D,IAAI,CAAC,eAAe,UAAU,KAAK,CAAC,eAAe,OAAO,KAAK,CAAC,eAAe,IAAI,KAAK,OAAO,UAAU,YAAY,OAAO,aAAa,UAAU,OAAO;CAC1J,IAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,IAAI,KAAK,OAAQ,KAA4B,SAAS,UAAU,OAAO;CACtI,OAAO;EAAE;EAAY;EAAS;EAAM;EAAa;EAAqB;CAAS;AACjF;;;;;AAMA,SAAgB,gBAAgB,QAAgB,KAAmC;CAEjF,IAAI,MAAM,KAAK,MAAM,OAAO,MAAM,IAAI,QAAQ,MAAM,OAAO;CAC3D,MAAM,OAAO,OAAO,MAAM,IAAI,OAAO,GAAG;CACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,OAAO;CACnC,MAAM,OAAO,KAAK,OAAO;CACzB,MAAM,YAAY,KAAK,KAAK,SAAS;CACrC,MAAM,OAAgB,YAAY,KAAK,MAAM,OAAO;CACpD,OAAO;EACL,YAAY,OAAO,QAAQ,eAAe,cAAc;EACxD,SAAS,UAAU,IAAI;EACvB,MAAM,OAAO,SAAS,WAAW,OAAO;EACxC,OAAO,YAAa,KAAK,YAAY,eAAe,KAAM,KAAK,YAAY,MAAM,GAAG,YAAY;EAChG;EACA,UAAU,OAAO,UAAU,UAAU;GAAE,MAAM;GAAO,SAAS,CAAC,IAAI;EAAE,CAAC,KAAK;CAC5E;AACF;;AAcA,MAAa,uBAAuB,UAAU,OAAgE;CAC5G,MAAM;CACN,mBAAmB,EAAE,YAAY,KAAK;CACtC,aAAa;EACX,OAAO,EAAE,YAAY,KAAK,QAAQ,WAAW;CAC/C;AACF,CAAC"}
+{"version":3,"file":"block-transfer.js","names":[],"sources":["../../src/core/block-transfer.ts"],"sourcesContent":["import { type Editor, Extension, type JSONContent } from '@tiptap/core'\nimport { blockIdOf } from './schema/block-ids'\nimport { migratePersistedNames, TYPED_BLOCK } from './schema/persisted-names'\nimport { nodeAtPos } from './util'\n\n/** MIME type of the block payload a drag carries next to its plain text; another editor surface or document tree reads it on drop. */\nexport const BLOCK_MIME = 'application/x-tip-block'\n\nconst TITLE_LENGTH = 80\n\n/** A block as it travels between editor surfaces and document trees. */\nexport interface BlockTransfer {\n  /** Document the block lives in; `null` when its editor has none. */\n  documentId: string | null\n  blockId: string | null\n  /** Block type id of a Typed block; `null` for every other block. */\n  blockType: string | null\n  /** Typed block: its title text; other blocks: the first 80 characters of their text. */\n  title: string\n  json: JSONContent\n  /** The block as Markdown; empty when the editor has no Markdown serializer. */\n  markdown: string\n}\n\n/** The minimal slice of `DataTransfer` the payload needs (a plain object in tests). */\ntype TransferData = Pick<DataTransfer, 'setData' | 'getData' | 'types'>\n\n/** Writes `payload` under `BLOCK_MIME`. */\nexport function writeBlockTransfer(dataTransfer: Pick<DataTransfer, 'setData'>, payload: BlockTransfer): void {\n  dataTransfer.setData(BLOCK_MIME, JSON.stringify(payload))\n}\n\nconst isStringOrNull = (value: unknown): value is string | null => value === null || typeof value === 'string'\n\nconst isJSONContent = (value: unknown): value is JSONContent => typeof value === 'object' && value !== null && !Array.isArray(value) && 'type' in value && typeof value.type === 'string'\n\n/**\n * The block payload of a drag, or `null` when it carries none or one that does not parse or has the wrong shape. A payload\n * written before the rename of Typed blocks (Block type id in `kind`, `json` with old node and attribute names) is read\n * as the current shape: `json` goes through `migratePersistedNames`, the Block type id is taken from `blockType` or `kind`.\n */\nexport function readBlockTransfer(dataTransfer: Partial<TransferData>): BlockTransfer | null {\n  if (!dataTransfer.types || !Array.from(dataTransfer.types).includes(BLOCK_MIME)) return null\n  let value: unknown\n  try {\n    value = JSON.parse(dataTransfer.getData?.(BLOCK_MIME) ?? '')\n  }\n  catch {\n    return null\n  }\n  if (typeof value !== 'object' || value === null) return null\n  const { documentId, blockId, blockType: current, kind: old, title, json, markdown } = value as Record<string, unknown>\n  const blockType = current === undefined ? old : current\n  if (!isStringOrNull(documentId) || !isStringOrNull(blockId) || !isStringOrNull(blockType) || typeof title !== 'string' || typeof markdown !== 'string') return null\n  if (!isJSONContent(json)) return null\n  return { documentId, blockId, blockType, title, json: migratePersistedNames(json), markdown }\n}\n\n/**\n * The payload of the block whose own position is `pos`; `null` when `pos` holds no block. The Markdown is empty when\n * `editor.markdown` is unavailable (a headless editor without `DocumentMarkdown`).\n */\nexport function blockTransferOf(editor: Editor, pos: number): BlockTransfer | null {\n  const node = nodeAtPos(editor.state.doc, pos)\n  if (!node || !node.isBlock) return null\n  const json = node.toJSON() as JSONContent\n  const typedBlock = node.type.name === TYPED_BLOCK\n  const blockType: unknown = typedBlock ? node.attrs.blockType : null\n  return {\n    documentId: documentIdOf(editor),\n    blockId: blockIdOf(node),\n    blockType: typeof blockType === 'string' ? blockType : null,\n    title: typedBlock ? (node.firstChild?.textContent ?? '') : node.textContent.slice(0, TITLE_LENGTH),\n    json,\n    markdown: editor.markdown?.serialize({ type: 'doc', content: [json] }) ?? '',\n  }\n}\n\nexport interface BlockTransferStorageData {\n  documentId: string | null\n}\n\ndeclare module '@tiptap/core' {\n  interface Storage {\n    /** Absent in an editor without the `BlockTransferStorage` extension. */\n    blockTransfer?: BlockTransferStorageData\n  }\n}\n\n/** The id of `editor`'s document as the `blockTransfer` storage knows it; null when the editor has none. */\nexport const documentIdOf = (editor: Editor): string | null => editor.storage.blockTransfer?.documentId ?? null\n\n/** Carries the editor's document id so `blockTransferOf` can name where a block comes from (`editor.storage.blockTransfer`). */\nexport const BlockTransferStorage = Extension.create<{ documentId: string | null }, BlockTransferStorageData>({\n  name: 'blockTransfer',\n  addOptions: () => ({ documentId: null }),\n  addStorage() {\n    return { documentId: this.options.documentId }\n  },\n})\n"],"mappings":";;;;;;AAMA,MAAa,aAAa;AAE1B,MAAM,eAAe;;AAoBrB,SAAgB,mBAAmB,cAA6C,SAA8B;CAC5G,aAAa,QAAQ,YAAY,KAAK,UAAU,OAAO,CAAC;AAC1D;AAEA,MAAM,kBAAkB,UAA2C,UAAU,QAAQ,OAAO,UAAU;AAEtG,MAAM,iBAAiB,UAAyC,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,KAAK,UAAU,SAAS,OAAO,MAAM,SAAS;;;;;;AAOjL,SAAgB,kBAAkB,cAA2D;CAC3F,IAAI,CAAC,aAAa,SAAS,CAAC,MAAM,KAAK,aAAa,KAAK,CAAC,CAAC,SAAA,yBAAmB,GAAG,OAAO;CACxF,IAAI;CACJ,IAAI;EACF,QAAQ,KAAK,MAAM,aAAa,UAAA,yBAAoB,KAAK,EAAE;CAC7D,QACM;EACJ,OAAO;CACT;CACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,EAAE,YAAY,SAAS,WAAW,SAAS,MAAM,KAAK,OAAO,MAAM,aAAa;CACtF,MAAM,YAAY,YAAY,KAAA,IAAY,MAAM;CAChD,IAAI,CAAC,eAAe,UAAU,KAAK,CAAC,eAAe,OAAO,KAAK,CAAC,eAAe,SAAS,KAAK,OAAO,UAAU,YAAY,OAAO,aAAa,UAAU,OAAO;CAC/J,IAAI,CAAC,cAAc,IAAI,GAAG,OAAO;CACjC,OAAO;EAAE;EAAY;EAAS;EAAW;EAAO,MAAM,sBAAsB,IAAI;EAAG;CAAS;AAC9F;;;;;AAMA,SAAgB,gBAAgB,QAAgB,KAAmC;CACjF,MAAM,OAAO,UAAU,OAAO,MAAM,KAAK,GAAG;CAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,OAAO;CACnC,MAAM,OAAO,KAAK,OAAO;CACzB,MAAM,aAAa,KAAK,KAAK,SAAS;CACtC,MAAM,YAAqB,aAAa,KAAK,MAAM,YAAY;CAC/D,OAAO;EACL,YAAY,aAAa,MAAM;EAC/B,SAAS,UAAU,IAAI;EACvB,WAAW,OAAO,cAAc,WAAW,YAAY;EACvD,OAAO,aAAc,KAAK,YAAY,eAAe,KAAM,KAAK,YAAY,MAAM,GAAG,YAAY;EACjG;EACA,UAAU,OAAO,UAAU,UAAU;GAAE,MAAM;GAAO,SAAS,CAAC,IAAI;EAAE,CAAC,KAAK;CAC5E;AACF;;AAcA,MAAa,gBAAgB,WAAkC,OAAO,QAAQ,eAAe,cAAc;;AAG3G,MAAa,uBAAuB,UAAU,OAAgE;CAC5G,MAAM;CACN,mBAAmB,EAAE,YAAY,KAAK;CACtC,aAAa;EACX,OAAO,EAAE,YAAY,KAAK,QAAQ,WAAW;CAC/C;AACF,CAAC"}