@ecsplico/editor 2.1.1 → 3.0.0

package/dist/config/index.js

@@ -0,0 +1,95 @@
+import "../i18n/index.js";
+//#region src/config/index.ts
+const DEFAULT_PRESETS = {
+	sonnet: {
+		label: "Claude Sonnet 4.5 (OpenRouter)",
+		endpoint: "https://openrouter.ai/api/v1",
+		model: "anthropic/claude-sonnet-4.5"
+	},
+	flashLite: {
+		label: "Gemini 2.5 Flash Lite (OpenRouter)",
+		endpoint: "https://openrouter.ai/api/v1",
+		model: "google/gemini-2.5-flash-lite"
+	}
+};
+const DEFAULT_SLOTS = {
+	complete: "flashLite",
+	rewrite: "sonnet",
+	generate: "sonnet"
+};
+const DEFAULT_RATE_LIMIT = {
+	max: 30,
+	windowMs: 6e4
+};
+/** Drops `undefined` values so an unset input never overwrites a default. */
+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
+* 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.
+*/
+function defineEditorConfig(input = {}) {
+	const ai = input.ai ?? {};
+	const presets = {};
+	for (const id of /* @__PURE__ */ new Set([...Object.keys(DEFAULT_PRESETS), ...Object.keys(ai.presets ?? {})])) {
+		const preset = {
+			...DEFAULT_PRESETS[id],
+			...defined(ai.presets?.[id])
+		};
+		presets[id] = {
+			...preset,
+			apiKey: preset.apiKey ?? ""
+		};
+	}
+	const transcription = ai.transcription && { ...defined(ai.transcription) };
+	return {
+		locale: input.locale ?? "de",
+		...input.messages && { messages: input.messages },
+		ai: {
+			presets,
+			apiKey: ai.apiKey ?? "",
+			slots: {
+				...DEFAULT_SLOTS,
+				...defined(ai.slots)
+			},
+			rateLimit: {
+				...DEFAULT_RATE_LIMIT,
+				...defined(ai.rateLimit)
+			},
+			...transcription && { transcription: {
+				...transcription,
+				apiKey: transcription.apiKey ?? ""
+			} }
+		},
+		collab: { authenticateUpgrade: input.collab?.authenticateUpgrade ?? false }
+	};
+}
+function publicConfig(config) {
+	return {
+		locale: config.locale,
+		...config.messages && { messages: config.messages },
+		ai: {
+			slots: config.ai.slots,
+			transcription: Boolean(config.ai.transcription)
+		}
+	};
+}
+function serverConfig(config) {
+	const { presets, apiKey, slots, transcription, rateLimit } = config.ai;
+	return {
+		ai: {
+			presets,
+			apiKey,
+			slots,
+			...transcription && { transcription }
+		},
+		rateLimit,
+		collab: config.collab
+	};
+}
+//#endregion
+export { defineEditorConfig, publicConfig, serverConfig };
+
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +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"}

package/dist/core/abilities.js

@@ -17,6 +17,7 @@ const DEFAULT_ABILITY_RULES = {
 		ABILITY.media,
 		ABILITY.record,
 		ABILITY.mention,
+		ABILITY.reference,
 		ABILITY.tag,
 		ABILITY.aiAutocomplete
 	] },

package/dist/core/abilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"abilities.js","names":[],"sources":["../../src/core/abilities.ts"],"sourcesContent":["import { type AnyExtension, type Editor, Extension, getExtensionField, type InputRule, type KeyboardShortcutCommand } from '@tiptap/core'\nimport { keydownHandler } from '@tiptap/pm/keymap'\nimport type { Node as PMNode, ResolvedPos } from '@tiptap/pm/model'\nimport { NodeSelection, Plugin, PluginKey } from '@tiptap/pm/state'\nimport type { EditorView } from '@tiptap/pm/view'\nimport {\n  ABILITY,\n  type Ability,\n  type AbilityRuleSource,\n  resolveAbilities,\n  ROOT_ABILITIES,\n  TEXT_ABILITIES,\n  TYPE_ABILITIES,\n} from './schema/abilities'\nimport type { AbilitiesOptions } from './extension-points'\n\nexport interface AbilitiesStorage {\n  rules: Map<string, AbilityRuleSource>\n  root: readonly Ability[]\n}\n\ndeclare module '@tiptap/core' {\n  interface Storage {\n    abilities: AbilitiesStorage\n  }\n}\n\n/** Rules for StarterKit/extension nodes that cannot carry `NodeConfig.abilities` themselves. */\nexport const DEFAULT_ABILITY_RULES: Record<string, AbilityRuleSource> = {\n  codeBlock: {\n    revokes: [\n      ABILITY.marks, ABILITY.headings, ABILITY.lists, ABILITY.blockquote, ABILITY.rule, ABILITY.blockContent, ABILITY.composite, ABILITY.transcript,\n      ABILITY.media, ABILITY.record, ABILITY.mention, ABILITY.tag, ABILITY.aiAutocomplete,\n    ],\n  },\n  image: { revokes: TEXT_ABILITIES },\n  horizontalRule: { revokes: TEXT_ABILITIES },\n}\n\n/**\n * Abilities at `pos`: chain = ancestors at depth 1…depth, plus `node` when given (an atom starting at `pos`).\n * A `ResolvedPos` addresses a document other than `editor.state.doc`, e.g. a transaction's doc inside plugin `apply`.\n */\nexport function abilitiesAt(editor: Editor, pos: number | ResolvedPos, node?: PMNode): ReadonlySet<Ability> {\n  const $pos = typeof pos === 'number' ? editor.state.doc.resolve(pos) : pos\n  const chain: PMNode[] = []\n  for (let depth = 1; depth <= $pos.depth; depth++) chain.push($pos.node(depth))\n  if (node) chain.push(node)\n  const { rules, root } = editor.storage.abilities\n  return resolveAbilities(rules, root, chain)\n}\n\n/** Abilities of the selection: the selected node, or what both ends of a range allow. */\nexport function abilitiesAtSelection(editor: Editor): ReadonlySet<Ability> {\n  const { selection } = editor.state\n  if (selection instanceof NodeSelection) return abilitiesAt(editor, selection.from, selection.node)\n  const from = abilitiesAt(editor, selection.$from.pos)\n  if (selection.empty) return from\n  const to = abilitiesAt(editor, selection.$to.pos)\n  return new Set([...from].filter(ability => to.has(ability)))\n}\n\nexport function hasAbility(editor: Editor, ability: Ability): boolean {\n  return abilitiesAtSelection(editor).has(ability)\n}\n\n/** Only modifier shortcuts are gated; plain Enter/Tab/Backspace keep their structural behaviour everywhere. */\nconst GATED_KEY = /(^|-)(Mod|Alt)-/\n/** How much text before the caret input rules get to see (mirrors TipTap's input-rule plugin). */\nconst MAX_MATCH = 500\n\ninterface GatedInputRule {\n  find: InputRule['find']\n  ability: Ability\n}\n\n/** Same `this` the ExtensionManager hands to `addKeyboardShortcuts` / `addInputRules` (core dist, `get plugins()`). */\nfunction extensionContext(ext: AnyExtension, editor: Editor) {\n  return {\n    name: ext.name,\n    options: ext.options,\n    storage: editor.extensionStorage[ext.name as keyof typeof editor.extensionStorage],\n    editor,\n    type: editor.schema.nodes[ext.name] ?? editor.schema.marks[ext.name] ?? null,\n  }\n}\n\nfunction gatedExtensions(editor: Editor): [AnyExtension, Ability][] {\n  return editor.extensionManager.extensions.flatMap((ext): [AnyExtension, Ability][] => {\n    const ability = TYPE_ABILITIES[ext.name]\n    return ability ? [[ext, ability]] : []\n  })\n}\n\nfunction buildKeyBindings(editor: Editor) {\n  const abilitiesByKey = new Map<string, Ability[]>()\n  for (const [ext, ability] of gatedExtensions(editor)) {\n    const addKeyboardShortcuts = getExtensionField<(() => Record<string, KeyboardShortcutCommand>) | undefined>(\n      ext, 'addKeyboardShortcuts', extensionContext(ext, editor),\n    )\n    for (const key of Object.keys(addKeyboardShortcuts?.() ?? {})) {\n      if (!GATED_KEY.test(key)) continue\n      abilitiesByKey.set(key, [...(abilitiesByKey.get(key) ?? []), ability])\n    }\n  }\n  // Returning true swallows the key, so the type's own binding never runs.\n  return Object.fromEntries([...abilitiesByKey].map(([key, abilities]) => [\n    key,\n    () => {\n      const present = abilitiesAtSelection(editor)\n      return abilities.some(ability => !present.has(ability))\n    },\n  ]))\n}\n\nfunction buildInputRules(editor: Editor): GatedInputRule[] {\n  return gatedExtensions(editor).flatMap(([ext, ability]) => {\n    const addInputRules = getExtensionField<(() => InputRule[]) | undefined>(ext, 'addInputRules', extensionContext(ext, editor))\n    return (addInputRules?.() ?? []).map(rule => ({ find: rule.find, ability }))\n  })\n}\n\nfunction matches(find: InputRule['find'], text: string): boolean {\n  if (typeof find === 'function') return find(text) != null\n  find.lastIndex = 0\n  return find.exec(text) !== null\n}\n\n/**\n * Hierarchical abilities (see shared/editor/abilities.ts). Resolution reads `editor.storage.abilities`; the plugin\n * swallows `Mod-`/`Alt-` shortcuts and pre-empts input rules of node/mark types whose ability is missing at the caret.\n * Paste, drop and remote changes are not filtered.\n */\nexport const Abilities = Extension.create<AbilitiesOptions, AbilitiesStorage>({\n  name: 'abilities',\n  // Highest priority: its plugin's handleKeyDown / handleTextInput run before the gated types' keymaps and input rules.\n  priority: 1000,\n\n  addOptions() {\n    return { root: ROOT_ABILITIES, rules: DEFAULT_ABILITY_RULES }\n  },\n\n  addStorage() {\n    return { rules: new Map(), root: this.options.root }\n  },\n\n  onBeforeCreate() {\n    const rules = new Map<string, AbilityRuleSource>()\n    for (const ext of this.editor.extensionManager.extensions) {\n      const rule = getExtensionField<AbilityRuleSource | undefined>(ext, 'abilities')\n      if (rule) rules.set(ext.name, rule)\n    }\n    // Host/default rules replace a node's own rule as a whole.\n    for (const [name, rule] of Object.entries(this.options.rules)) rules.set(name, rule)\n    this.storage.rules = rules\n    this.storage.root = this.options.root\n  },\n\n  addProseMirrorPlugins() {\n    const editor = this.editor\n    // Built lazily on first use, once per plugin: needs the final extension list and schema.\n    let handleKey: ((view: EditorView, event: KeyboardEvent) => boolean) | undefined\n    let inputRules: GatedInputRule[] | undefined\n\n    return [\n      new Plugin({\n        key: new PluginKey('abilities'),\n        props: {\n          handleKeyDown(view, event) {\n            handleKey ??= keydownHandler(buildKeyBindings(editor))\n            return handleKey(view, event)\n          },\n          handleTextInput(view, from, to, text) {\n            inputRules ??= buildInputRules(editor)\n            if (!inputRules.length) return false\n            const $from = view.state.doc.resolve(from)\n            if (!$from.parent.isTextblock) return false\n            const textBefore = $from.parent.textBetween(Math.max(0, $from.parentOffset - MAX_MATCH), $from.parentOffset, undefined, '\\ufffc') + text\n            let present: ReadonlySet<Ability> | undefined\n            for (const rule of inputRules) {\n              present ??= abilitiesAt(editor, from)\n              if (present.has(rule.ability) || !matches(rule.find, textBefore)) continue\n              // Type the character literally; the rule's own plugin never sees this input.\n              view.dispatch(view.state.tr.insertText(text, from, to))\n              return true\n            }\n            return false\n          },\n        },\n      }),\n    ]\n  },\n})\n"],"mappings":";;;;;;AA4BA,MAAa,wBAA2D;CACtE,WAAW,EACT,SAAS;EACP,QAAQ;EAAO,QAAQ;EAAU,QAAQ;EAAO,QAAQ;EAAY,QAAQ;EAAM,QAAQ;EAAc,QAAQ;EAAW,QAAQ;EACnI,QAAQ;EAAO,QAAQ;EAAQ,QAAQ;EAAS,QAAQ;EAAK,QAAQ;CACvE,EACF;CACA,OAAO,EAAE,SAAS,eAAe;CACjC,gBAAgB,EAAE,SAAS,eAAe;AAC5C;;;;;AAMA,SAAgB,YAAY,QAAgB,KAA2B,MAAqC;CAC1G,MAAM,OAAO,OAAO,QAAQ,WAAW,OAAO,MAAM,IAAI,QAAQ,GAAG,IAAI;CACvE,MAAM,QAAkB,CAAC;CACzB,KAAK,IAAI,QAAQ,GAAG,SAAS,KAAK,OAAO,SAAS,MAAM,KAAK,KAAK,KAAK,KAAK,CAAC;CAC7E,IAAI,MAAM,MAAM,KAAK,IAAI;CACzB,MAAM,EAAE,OAAO,SAAS,OAAO,QAAQ;CACvC,OAAO,iBAAiB,OAAO,MAAM,KAAK;AAC5C;;AAGA,SAAgB,qBAAqB,QAAsC;CACzE,MAAM,EAAE,cAAc,OAAO;CAC7B,IAAI,qBAAqB,eAAe,OAAO,YAAY,QAAQ,UAAU,MAAM,UAAU,IAAI;CACjG,MAAM,OAAO,YAAY,QAAQ,UAAU,MAAM,GAAG;CACpD,IAAI,UAAU,OAAO,OAAO;CAC5B,MAAM,KAAK,YAAY,QAAQ,UAAU,IAAI,GAAG;CAChD,OAAO,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,QAAO,YAAW,GAAG,IAAI,OAAO,CAAC,CAAC;AAC7D;AAEA,SAAgB,WAAW,QAAgB,SAA2B;CACpE,OAAO,qBAAqB,MAAM,CAAC,CAAC,IAAI,OAAO;AACjD;;AAGA,MAAM,YAAY;;AAElB,MAAM,YAAY;;AAQlB,SAAS,iBAAiB,KAAmB,QAAgB;CAC3D,OAAO;EACL,MAAM,IAAI;EACV,SAAS,IAAI;EACb,SAAS,OAAO,iBAAiB,IAAI;EACrC;EACA,MAAM,OAAO,OAAO,MAAM,IAAI,SAAS,OAAO,OAAO,MAAM,IAAI,SAAS;CAC1E;AACF;AAEA,SAAS,gBAAgB,QAA2C;CAClE,OAAO,OAAO,iBAAiB,WAAW,SAAS,QAAmC;EACpF,MAAM,UAAU,eAAe,IAAI;EACnC,OAAO,UAAU,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;CACvC,CAAC;AACH;AAEA,SAAS,iBAAiB,QAAgB;CACxC,MAAM,iCAAiB,IAAI,IAAuB;CAClD,KAAK,MAAM,CAAC,KAAK,YAAY,gBAAgB,MAAM,GAAG;EACpD,MAAM,uBAAuB,kBAC3B,KAAK,wBAAwB,iBAAiB,KAAK,MAAM,CAC3D;EACA,KAAK,MAAM,OAAO,OAAO,KAAK,uBAAuB,KAAK,CAAC,CAAC,GAAG;GAC7D,IAAI,CAAC,UAAU,KAAK,GAAG,GAAG;GAC1B,eAAe,IAAI,KAAK,CAAC,GAAI,eAAe,IAAI,GAAG,KAAK,CAAC,GAAI,OAAO,CAAC;EACvE;CACF;CAEA,OAAO,OAAO,YAAY,CAAC,GAAG,cAAc,CAAC,CAAC,KAAK,CAAC,KAAK,eAAe,CACtE,WACM;EACJ,MAAM,UAAU,qBAAqB,MAAM;EAC3C,OAAO,UAAU,MAAK,YAAW,CAAC,QAAQ,IAAI,OAAO,CAAC;CACxD,CACF,CAAC,CAAC;AACJ;AAEA,SAAS,gBAAgB,QAAkC;CACzD,OAAO,gBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,aAAa;EAEzD,QADsB,kBAAmD,KAAK,iBAAiB,iBAAiB,KAAK,MAAM,CACvG,CAAC,GAAG,KAAK,CAAC,EAAA,CAAG,KAAI,UAAS;GAAE,MAAM,KAAK;GAAM;EAAQ,EAAE;CAC7E,CAAC;AACH;AAEA,SAAS,QAAQ,MAAyB,MAAuB;CAC/D,IAAI,OAAO,SAAS,YAAY,OAAO,KAAK,IAAI,KAAK;CACrD,KAAK,YAAY;CACjB,OAAO,KAAK,KAAK,IAAI,MAAM;AAC7B;;;;;;AAOA,MAAa,YAAY,UAAU,OAA2C;CAC5E,MAAM;CAEN,UAAU;CAEV,aAAa;EACX,OAAO;GAAE,MAAM;GAAgB,OAAO;EAAsB;CAC9D;CAEA,aAAa;EACX,OAAO;GAAE,uBAAO,IAAI,IAAI;GAAG,MAAM,KAAK,QAAQ;EAAK;CACrD;CAEA,iBAAiB;EACf,MAAM,wBAAQ,IAAI,IAA+B;EACjD,KAAK,MAAM,OAAO,KAAK,OAAO,iBAAiB,YAAY;GACzD,MAAM,OAAO,kBAAiD,KAAK,WAAW;GAC9E,IAAI,MAAM,MAAM,IAAI,IAAI,MAAM,IAAI;EACpC;EAEA,KAAK,MAAM,CAAC,MAAM,SAAS,OAAO,QAAQ,KAAK,QAAQ,KAAK,GAAG,MAAM,IAAI,MAAM,IAAI;EACnF,KAAK,QAAQ,QAAQ;EACrB,KAAK,QAAQ,OAAO,KAAK,QAAQ;CACnC;CAEA,wBAAwB;EACtB,MAAM,SAAS,KAAK;EAEpB,IAAI;EACJ,IAAI;EAEJ,OAAO,CACL,IAAI,OAAO;GACT,KAAK,IAAI,UAAU,WAAW;GAC9B,OAAO;IACL,cAAc,MAAM,OAAO;KACzB,cAAc,eAAe,iBAAiB,MAAM,CAAC;KACrD,OAAO,UAAU,MAAM,KAAK;IAC9B;IACA,gBAAgB,MAAM,MAAM,IAAI,MAAM;KACpC,eAAe,gBAAgB,MAAM;KACrC,IAAI,CAAC,WAAW,QAAQ,OAAO;KAC/B,MAAM,QAAQ,KAAK,MAAM,IAAI,QAAQ,IAAI;KACzC,IAAI,CAAC,MAAM,OAAO,aAAa,OAAO;KACtC,MAAM,aAAa,MAAM,OAAO,YAAY,KAAK,IAAI,GAAG,MAAM,eAAe,SAAS,GAAG,MAAM,cAAc,KAAA,GAAW,GAAQ,IAAI;KACpI,IAAI;KACJ,KAAK,MAAM,QAAQ,YAAY;MAC7B,YAAY,YAAY,QAAQ,IAAI;MACpC,IAAI,QAAQ,IAAI,KAAK,OAAO,KAAK,CAAC,QAAQ,KAAK,MAAM,UAAU,GAAG;MAElE,KAAK,SAAS,KAAK,MAAM,GAAG,WAAW,MAAM,MAAM,EAAE,CAAC;MACtD,OAAO;KACT;KACA,OAAO;IACT;GACF;EACF,CAAC,CACH;CACF;AACF,CAAC"}
+{"version":3,"file":"abilities.js","names":[],"sources":["../../src/core/abilities.ts"],"sourcesContent":["import { type AnyExtension, type Editor, Extension, getExtensionField, type InputRule, type KeyboardShortcutCommand } from '@tiptap/core'\nimport { keydownHandler } from '@tiptap/pm/keymap'\nimport type { Node as PMNode, ResolvedPos } from '@tiptap/pm/model'\nimport { NodeSelection, Plugin, PluginKey } from '@tiptap/pm/state'\nimport type { EditorView } from '@tiptap/pm/view'\nimport {\n  ABILITY,\n  type Ability,\n  type AbilityRuleSource,\n  resolveAbilities,\n  ROOT_ABILITIES,\n  TEXT_ABILITIES,\n  TYPE_ABILITIES,\n} from './schema/abilities'\nimport type { AbilitiesOptions } from './extension-points'\n\nexport interface AbilitiesStorage {\n  rules: Map<string, AbilityRuleSource>\n  root: readonly Ability[]\n}\n\ndeclare module '@tiptap/core' {\n  interface Storage {\n    abilities: AbilitiesStorage\n  }\n}\n\n/** Rules for StarterKit/extension nodes that cannot carry `NodeConfig.abilities` themselves. */\nexport const DEFAULT_ABILITY_RULES: Record<string, AbilityRuleSource> = {\n  codeBlock: {\n    revokes: [\n      ABILITY.marks, ABILITY.headings, ABILITY.lists, ABILITY.blockquote, ABILITY.rule, ABILITY.blockContent, ABILITY.composite, ABILITY.transcript,\n      ABILITY.media, ABILITY.record, ABILITY.mention, ABILITY.reference, ABILITY.tag, ABILITY.aiAutocomplete,\n    ],\n  },\n  image: { revokes: TEXT_ABILITIES },\n  horizontalRule: { revokes: TEXT_ABILITIES },\n}\n\n/**\n * Abilities at `pos`: chain = ancestors at depth 1…depth, plus `node` when given (an atom starting at `pos`).\n * A `ResolvedPos` addresses a document other than `editor.state.doc`, e.g. a transaction's doc inside plugin `apply`.\n */\nexport function abilitiesAt(editor: Editor, pos: number | ResolvedPos, node?: PMNode): ReadonlySet<Ability> {\n  const $pos = typeof pos === 'number' ? editor.state.doc.resolve(pos) : pos\n  const chain: PMNode[] = []\n  for (let depth = 1; depth <= $pos.depth; depth++) chain.push($pos.node(depth))\n  if (node) chain.push(node)\n  const { rules, root } = editor.storage.abilities\n  return resolveAbilities(rules, root, chain)\n}\n\n/** Abilities of the selection: the selected node, or what both ends of a range allow. */\nexport function abilitiesAtSelection(editor: Editor): ReadonlySet<Ability> {\n  const { selection } = editor.state\n  if (selection instanceof NodeSelection) return abilitiesAt(editor, selection.from, selection.node)\n  const from = abilitiesAt(editor, selection.$from.pos)\n  if (selection.empty) return from\n  const to = abilitiesAt(editor, selection.$to.pos)\n  return new Set([...from].filter(ability => to.has(ability)))\n}\n\nexport function hasAbility(editor: Editor, ability: Ability): boolean {\n  return abilitiesAtSelection(editor).has(ability)\n}\n\n/** Only modifier shortcuts are gated; plain Enter/Tab/Backspace keep their structural behaviour everywhere. */\nconst GATED_KEY = /(^|-)(Mod|Alt)-/\n/** How much text before the caret input rules get to see (mirrors TipTap's input-rule plugin). */\nconst MAX_MATCH = 500\n\ninterface GatedInputRule {\n  find: InputRule['find']\n  ability: Ability\n}\n\n/** Same `this` the ExtensionManager hands to `addKeyboardShortcuts` / `addInputRules` (core dist, `get plugins()`). */\nfunction extensionContext(ext: AnyExtension, editor: Editor) {\n  return {\n    name: ext.name,\n    options: ext.options,\n    storage: editor.extensionStorage[ext.name as keyof typeof editor.extensionStorage],\n    editor,\n    type: editor.schema.nodes[ext.name] ?? editor.schema.marks[ext.name] ?? null,\n  }\n}\n\nfunction gatedExtensions(editor: Editor): [AnyExtension, Ability][] {\n  return editor.extensionManager.extensions.flatMap((ext): [AnyExtension, Ability][] => {\n    const ability = TYPE_ABILITIES[ext.name]\n    return ability ? [[ext, ability]] : []\n  })\n}\n\nfunction buildKeyBindings(editor: Editor) {\n  const abilitiesByKey = new Map<string, Ability[]>()\n  for (const [ext, ability] of gatedExtensions(editor)) {\n    const addKeyboardShortcuts = getExtensionField<(() => Record<string, KeyboardShortcutCommand>) | undefined>(\n      ext, 'addKeyboardShortcuts', extensionContext(ext, editor),\n    )\n    for (const key of Object.keys(addKeyboardShortcuts?.() ?? {})) {\n      if (!GATED_KEY.test(key)) continue\n      abilitiesByKey.set(key, [...(abilitiesByKey.get(key) ?? []), ability])\n    }\n  }\n  // Returning true swallows the key, so the type's own binding never runs.\n  return Object.fromEntries([...abilitiesByKey].map(([key, abilities]) => [\n    key,\n    () => {\n      const present = abilitiesAtSelection(editor)\n      return abilities.some(ability => !present.has(ability))\n    },\n  ]))\n}\n\nfunction buildInputRules(editor: Editor): GatedInputRule[] {\n  return gatedExtensions(editor).flatMap(([ext, ability]) => {\n    const addInputRules = getExtensionField<(() => InputRule[]) | undefined>(ext, 'addInputRules', extensionContext(ext, editor))\n    return (addInputRules?.() ?? []).map(rule => ({ find: rule.find, ability }))\n  })\n}\n\nfunction matches(find: InputRule['find'], text: string): boolean {\n  if (typeof find === 'function') return find(text) != null\n  find.lastIndex = 0\n  return find.exec(text) !== null\n}\n\n/**\n * Hierarchical abilities (see shared/editor/abilities.ts). Resolution reads `editor.storage.abilities`; the plugin\n * swallows `Mod-`/`Alt-` shortcuts and pre-empts input rules of node/mark types whose ability is missing at the caret.\n * Paste, drop and remote changes are not filtered.\n */\nexport const Abilities = Extension.create<AbilitiesOptions, AbilitiesStorage>({\n  name: 'abilities',\n  // Highest priority: its plugin's handleKeyDown / handleTextInput run before the gated types' keymaps and input rules.\n  priority: 1000,\n\n  addOptions() {\n    return { root: ROOT_ABILITIES, rules: DEFAULT_ABILITY_RULES }\n  },\n\n  addStorage() {\n    return { rules: new Map(), root: this.options.root }\n  },\n\n  onBeforeCreate() {\n    const rules = new Map<string, AbilityRuleSource>()\n    for (const ext of this.editor.extensionManager.extensions) {\n      const rule = getExtensionField<AbilityRuleSource | undefined>(ext, 'abilities')\n      if (rule) rules.set(ext.name, rule)\n    }\n    // Host/default rules replace a node's own rule as a whole.\n    for (const [name, rule] of Object.entries(this.options.rules)) rules.set(name, rule)\n    this.storage.rules = rules\n    this.storage.root = this.options.root\n  },\n\n  addProseMirrorPlugins() {\n    const editor = this.editor\n    // Built lazily on first use, once per plugin: needs the final extension list and schema.\n    let handleKey: ((view: EditorView, event: KeyboardEvent) => boolean) | undefined\n    let inputRules: GatedInputRule[] | undefined\n\n    return [\n      new Plugin({\n        key: new PluginKey('abilities'),\n        props: {\n          handleKeyDown(view, event) {\n            handleKey ??= keydownHandler(buildKeyBindings(editor))\n            return handleKey(view, event)\n          },\n          handleTextInput(view, from, to, text) {\n            inputRules ??= buildInputRules(editor)\n            if (!inputRules.length) return false\n            const $from = view.state.doc.resolve(from)\n            if (!$from.parent.isTextblock) return false\n            const textBefore = $from.parent.textBetween(Math.max(0, $from.parentOffset - MAX_MATCH), $from.parentOffset, undefined, '\\ufffc') + text\n            let present: ReadonlySet<Ability> | undefined\n            for (const rule of inputRules) {\n              present ??= abilitiesAt(editor, from)\n              if (present.has(rule.ability) || !matches(rule.find, textBefore)) continue\n              // Type the character literally; the rule's own plugin never sees this input.\n              view.dispatch(view.state.tr.insertText(text, from, to))\n              return true\n            }\n            return false\n          },\n        },\n      }),\n    ]\n  },\n})\n"],"mappings":"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"}

package/dist/{adapters/routes.js → core/api-routes.js}

@@ -1,4 +1,4 @@
-//#region src/adapters/routes.ts
+//#region src/core/api-routes.ts
 const EDITOR_API = "/api/editor";
 const AI_API = "/api/ai";
 const COLLAB_PATH = "/collab";
@@ -6,11 +6,13 @@ const COLLAB_PATH = "/collab";
 const DOCUMENT_ROUTE = `${EDITOR_API}/documents/:id`;
 /** Route pattern of a document's comments endpoint (`handleCommentsRequest`). */
 const COMMENTS_ROUTE = `${EDITOR_API}/comments/:id`;
+/** Route (`GET`) listing the capabilities the server serves (`serverCapabilities`); the HTTP backend's probe reads it. */
+const CAPABILITIES_ROUTE = `${EDITOR_API}/capabilities`;
 /** The content URL of document `id`. */
 const documentUrl = (id) => DOCUMENT_ROUTE.replace(":id", encodeURIComponent(id));
 /** The comments URL of document `id`. */
 const commentsUrl = (id) => COMMENTS_ROUTE.replace(":id", encodeURIComponent(id));
 //#endregion
-export { AI_API, COLLAB_PATH, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API, commentsUrl, documentUrl };
+export { AI_API, CAPABILITIES_ROUTE, COLLAB_PATH, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API, commentsUrl, documentUrl };
 
-//# sourceMappingURL=routes.js.map
+//# sourceMappingURL=api-routes.js.map

package/dist/core/api-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-routes.js","names":[],"sources":["../../src/core/api-routes.ts"],"sourcesContent":["// The wire paths shared by the clients (core's fetch backend, the HTTP adapter, the media asset URLs) and the servers\n// (`serverRoutesOf`, the Nitro host). They live in core because the editor owns the contract and adapters depend on it.\n// Pure strings: this module imports nothing, so no entry drags another's framework in.\n\nexport const EDITOR_API = '/api/editor'\nexport const AI_API = '/api/ai'\nexport const COLLAB_PATH = '/collab'\n\n/** Route pattern of a document's content (`GET` → TipTap JSON, `PUT` → stores it). */\nexport const DOCUMENT_ROUTE = `${EDITOR_API}/documents/:id`\n/** Route pattern of a document's comments endpoint (`handleCommentsRequest`). */\nexport const COMMENTS_ROUTE = `${EDITOR_API}/comments/:id`\n/** Route (`GET`) listing the capabilities the server serves (`serverCapabilities`); the HTTP backend's probe reads it. */\nexport const CAPABILITIES_ROUTE = `${EDITOR_API}/capabilities`\n\n/** The content URL of document `id`. */\nexport const documentUrl = (id: string) => DOCUMENT_ROUTE.replace(':id', encodeURIComponent(id))\n/** The comments URL of document `id`. */\nexport const commentsUrl = (id: string) => COMMENTS_ROUTE.replace(':id', encodeURIComponent(id))\n"],"mappings":";AAIA,MAAa,aAAa;AAC1B,MAAa,SAAS;AACtB,MAAa,cAAc;;AAG3B,MAAa,iBAAiB,GAAG,WAAW;;AAE5C,MAAa,iBAAiB,GAAG,WAAW;;AAE5C,MAAa,qBAAqB,GAAG,WAAW;;AAGhD,MAAa,eAAe,OAAe,eAAe,QAAQ,OAAO,mBAAmB,EAAE,CAAC;;AAE/F,MAAa,eAAe,OAAe,eAAe,QAAQ,OAAO,mBAAmB,EAAE,CAAC"}

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

@@ -0,0 +1,7 @@
+//#region src/core/backend-capability.d.ts
+/** Every capability of a backend, in the canonical order; the server's `EditorPorts` use the same names. Its own module so server code imports it without reaching the DOM-using core. */
+export declare const BACKEND_CAPABILITIES: readonly ["documents", "collaboration", "assets", "users", "tags", "settings", "themes", "ai", "comments"];
+/** What a backend can do. */
+export type BackendCapability = typeof BACKEND_CAPABILITIES[number];
+//#endregion
+//# sourceMappingURL=backend-capability.d.ts.map

package/dist/core/backend-capability.js

@@ -0,0 +1,17 @@
+//#region src/core/backend-capability.ts
+/** Every capability of a backend, in the canonical order; the server's `EditorPorts` use the same names. Its own module so server code imports it without reaching the DOM-using core. */
+const BACKEND_CAPABILITIES = [
+	"documents",
+	"collaboration",
+	"assets",
+	"users",
+	"tags",
+	"settings",
+	"themes",
+	"ai",
+	"comments"
+];
+//#endregion
+export { BACKEND_CAPABILITIES };
+
+//# sourceMappingURL=backend-capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend-capability.js","names":[],"sources":["../../src/core/backend-capability.ts"],"sourcesContent":["/** Every capability of a backend, in the canonical order; the server's `EditorPorts` use the same names. Its own module so server code imports it without reaching the DOM-using core. */\nexport const BACKEND_CAPABILITIES = ['documents', 'collaboration', 'assets', 'users', 'tags', 'settings', 'themes', 'ai', 'comments'] as const\n\n/** What a backend can do. */\nexport type BackendCapability = typeof BACKEND_CAPABILITIES[number]\n"],"mappings":";;AACA,MAAa,uBAAuB;CAAC;CAAa;CAAiB;CAAU;CAAS;CAAQ;CAAY;CAAU;CAAM;AAAU"}

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

@@ -0,0 +1,245 @@
+import { ReadonlyStore } from "./store.js";
+import { AuthorIdentity } from "./feature.js";
+//#region src/core/backend-types.d.ts
+/** A user as offered for `@` mentions (`GET /api/editor/users`); never carries credentials. */
+export interface MentionUser {
+  id: string;
+  username: string;
+  color: string;
+}
+/** Profile as the client sees it; presets never expose their key. */
+export interface ModelProfile {
+  id: string;
+  label: string;
+  endpoint: string;
+  model: string;
+  source: 'preset' | 'user';
+}
+/** Model an AI request runs on: a server preset by id, or an OpenAI-compatible endpoint with its own key. */
+export type ModelRef = {
+  preset: string;
+} | {
+  endpoint: string;
+  model: string;
+  apiKey: string;
+};
+/** A theme in the shared library; `builtin` themes are seeded by the host and cannot be deleted. */
+export interface ThemeRecord {
+  id: string;
+  name: string;
+  version?: string;
+  author?: string;
+  authorUrl?: string;
+  builtin: boolean;
+}
+/** One transcript segment sent for cleanup. */
+export interface TranscriptCleanupSegment {
+  /** Block ID of the segment (`blockIdOf`). */
+  id: string;
+  speaker: string;
+  /** The segment's inline content as Markdown (mentions as `@name`, tags as `#name`). */
+  text: string;
+}
+/** Body of the transcript-cleanup route. */
+export interface TranscriptCleanupRequest {
+  segments: TranscriptCleanupSegment[];
+  model: ModelRef;
+}
+/** Cleaned text (single-line inline Markdown) of the segment with block ID `id`. */
+export interface TranscriptCleanupResult {
+  id: string;
+  text: string;
+}
+/** `cleaned`: only segments whose text changed. `failed`: segments of chunks whose model answer was unusable (left as they are). */
+export interface TranscriptCleanupResponse {
+  cleaned: TranscriptCleanupResult[];
+  failed: number;
+}
+/** A CSL name: `family`/`given` for a person, `literal` for an institution or an unparsed name. */
+export interface CslName {
+  family?: string;
+  given?: string;
+  literal?: string;
+}
+export interface CslDate {
+  'date-parts': number[][];
+}
+/** 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`. */
+export interface CslItem {
+  type: CslType;
+  author?: CslName[];
+  editor?: CslName[];
+  issued?: CslDate;
+  'container-title'?: string;
+  volume?: string;
+  issue?: string;
+  page?: string;
+  publisher?: string;
+  'publisher-place'?: string;
+  DOI?: string;
+  ISBN?: string;
+  URL?: string;
+  abstract?: string;
+  language?: string;
+}
+/** What `ai.extract` makes of a stored asset; `auto` picks by the asset's MIME type. */
+export type ExtractMethod = 'auto' | 'transcription' | 'pdf-text' | 'ocr' | 'description' | 'bibliography';
+/** Body of the extract route: the stored asset `documentId`/`name` and what to make of it. */
+export interface ExtractRequest {
+  documentId: string;
+  /** The asset to read; absent only for `bibliography` with a `doi` (the work is looked up by DOI alone). */
+  name?: string;
+  method: ExtractMethod;
+  /** The model of `ocr`, `description` and model-based bibliography extraction. */
+  model: ModelRef;
+  /** Also extract bibliographic data after `pdf-text`/`ocr`. */
+  bibliography?: boolean;
+  /** DOI to look up for `bibliography`; absent = found in the first pages' text. */
+  doi?: string;
+  /** PDF page cap (default 200). `ocr` reads at most 50 pages whatever this allows (one model call per page; `ocr-truncated` warns). */
+  maxPages?: number;
+}
+export interface ExtractResponse {
+  method: Exclude<ExtractMethod, 'auto'>;
+  /** The readable content as Markdown (empty for `bibliography`). */
+  markdown: string;
+  /** Transcription only: the timed segments `markdown` was made of. */
+  segments?: {
+    start: number;
+    end: number;
+    text: string;
+  }[];
+  /** When bibliographic data was requested or the method is `bibliography`; `title` is the work's title when found (never stored in `meta.bib`). */
+  bib?: CslItem & {
+    title?: string;
+  };
+  /** Transcription only: the speech-to-text model that wrote it (`TranscriptionConfig.model`), which the client cannot know. */
+  model?: string;
+  /** SHA-256 (hex) of the asset bytes. */
+  inputHash: string;
+  /** 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. */
+  outputHash: string;
+  /** Asset name (same document) of the stored raw Markdown; `null` for `bibliography`. */
+  output: string | null;
+  warnings: string[];
+}
+/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */
+export type CommentAuthor = AuthorIdentity;
+export interface CommentReply {
+  id: string;
+  author: CommentAuthor;
+  text: string;
+  /** ISO timestamps; `editedAt` once the author changed the text. */
+  createdAt: string;
+  editedAt?: string;
+}
+/**
+ * Where a thread's text starts, as the JSON form of a Yjs relative position (`Y.relativePositionToJSON`): bound to the
+ * first commented character, so it keeps pointing at the place after that text was deleted (and moves with the text
+ * around it). Stored in the thread's `Y.Map` under `anchor`, so every collaborator resolves the same place.
+ */
+export interface CommentAnchor {
+  type?: {
+    client: number;
+    clock: number;
+  };
+  tname?: string;
+  item?: {
+    client: number;
+    clock: number;
+  };
+  assoc?: number;
+}
+/**
+ * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`
+ * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the
+ * `comment` mark with the thread's `id`.
+ */
+export interface CommentThread {
+  id: string;
+  author: CommentAuthor;
+  text: string;
+  createdAt: string;
+  editedAt?: string;
+  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */
+  quote: string;
+  /** Resolved threads are kept, without highlight, until reopened. */
+  resolved: boolean;
+  /**
+   * Start of the commented text as a Yjs relative position, written when the thread is created (older threads get it
+   * once they are seen with their text still in the document). Tells where an orphaned thread's text was. Absent on threads
+   * not yet seen with a range, and when the position could not be captured.
+   */
+  anchor?: CommentAnchor;
+  replies: CommentReply[];
+}
+/** A text range in the editor document. */
+export type DocRange = {
+  from: number;
+  to: number;
+};
+/** What a comments UI renders: replaced (a new object) whenever any part of it changes, so a store subscriber re-renders only then. */
+export interface CommentsSnapshot {
+  /** Comments need a collaborative editor whose `Comments` extension has a user (a host model decides for itself). */
+  available: boolean;
+  /**
+   * Whether the user may compose a comment now: the default model says `available` and the editor is editable, a host
+   * model may allow readers of a read-only document to comment.
+   */
+  canComment: boolean;
+  user: AuthorIdentity | null;
+  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */
+  threads: readonly CommentThread[];
+  /** Current text range per thread id (threads without one are orphans). */
+  ranges: ReadonlyMap<string, DocRange>;
+  /**
+   * Where the text of an orphaned open thread was: the document position of the deletion point, resolved from the
+   * thread's stored anchor (so it is the same place for every collaborator and follows edits). Absent for orphans
+   * without a usable anchor (threads from before anchors, or whose block is gone for good).
+   */
+  orphanAt: ReadonlyMap<string, number>;
+  active: string | null;
+  /** Current range of the draft a new comment is being written for. */
+  draft: DocRange | null;
+  /** The draft's text as the new thread will keep it (`quote`). */
+  draftQuote: string;
+  /** Unresolved threads in document order, orphans last; resolved ones newest first. */
+  open: readonly CommentThread[];
+  resolved: readonly CommentThread[];
+}
+/** The mutations of the comments of one editor; no-ops without collaboration or a user. */
+export interface CommentsActions {
+  /** Creates a thread on the draft range; its id, or null without a (non-empty) draft or text. */
+  add: (text: string) => string | null;
+  reply: (threadId: string, text: string) => void;
+  /** Changes the text of the user's own thread (`replyId` null) or reply. */
+  edit: (threadId: string, replyId: string | null, text: string) => void;
+  /** Resolves or reopens a thread (anyone may). */
+  setResolved: (threadId: string, resolved: boolean) => void;
+  /** Deletes the user's own thread with its marks / the user's own reply. */
+  remove: (threadId: string) => void;
+  removeReply: (threadId: string, replyId: string) => void;
+  /** Activates a thread (`null`: none); `reveal` selects and scrolls to its text. */
+  activate: (id: string | null, options?: {
+    reveal?: boolean;
+  }) => void;
+  /** Starts a comment on the current selection (the layout shows the composer while `draft` is set). */
+  startDraft: () => void;
+  cancelDraft: () => void;
+}
+/**
+ * The comments of one editor, framework-free: `state` is the observable snapshot, `refresh()` brings it up to date
+ * (the framework hook calls it when the editor it watches changes; the model itself listens to that editor's
+ * transactions from then on), `dispose()` detaches the editor and Y.Doc listeners and may be followed by `refresh()` again
+ * (StrictMode mounts twice).
+ */
+export interface CommentsModel extends CommentsActions {
+  readonly state: ReadonlyStore<CommentsSnapshot>;
+  refresh: () => void;
+  dispose: () => void;
+}
+//#endregion
+//# sourceMappingURL=backend-types.d.ts.map

package/dist/core/backend-types.js

@@ -0,0 +1,17 @@
+//#region src/core/backend-types.ts
+/** The CSL item types the editor offers (select options, server-side schema). */
+const CSL_TYPES = [
+	"article-journal",
+	"book",
+	"chapter",
+	"paper-conference",
+	"thesis",
+	"report",
+	"webpage",
+	"article",
+	"dataset"
+];
+//#endregion
+export { CSL_TYPES };
+
+//# sourceMappingURL=backend-types.js.map

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

@@ -0,0 +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"],"mappings":";;AAmDA,MAAa,YAAY;CAAC;CAAmB;CAAQ;CAAW;CAAoB;CAAU;CAAU;CAAW;CAAW;AAAS"}

package/dist/core/backend.d.ts

@@ -0,0 +1,108 @@
+import { ModelSlot } from "../settings/values.js";
+import { EditorSettings } from "../settings/index.js";
+import { BackendCapability } from "./backend-capability.js";
+import { AuthorIdentity } from "./feature.js";
+import { CommentsModel, ExtractRequest, ExtractResponse, MentionUser, ModelProfile, ModelRef, ThemeRecord, TranscriptCleanupRequest, TranscriptCleanupResponse } from "./backend-types.js";
+import { Editor, JSONContent } from "@tiptap/core";
+import { HocuspocusProvider } from "@hocuspocus/provider";
+import * as Y from "yjs";
+//#region src/core/backend.d.ts
+/** 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). */
+export interface AiStreamEvent {
+  event: 'delta' | 'ops' | 'done' | 'error';
+  data: unknown;
+}
+/** The token a collaboration server's `authenticate` receives: a string, or a function (also async) that returns it on each connect. */
+export type CollaborationToken = string | (() => string) | (() => Promise<string>);
+/** A refused or failed backend request; `status` is the HTTP status (or its equivalent) and `message` the server's, when it sent one. */
+export declare class BackendError extends Error {
+  readonly status: number;
+  constructor(message: string, status: number, options?: ErrorOptions);
+}
+/** What a backend needs from the host to give a comments model its anchors and its author. */
+export interface BackendCommentsOptions {
+  /** Who writes: the author of new comments; `null` while nobody is signed in. */
+  user: () => AuthorIdentity | null;
+  /** Whether the user may compose and change comments now. */
+  canComment: () => boolean;
+  /** The editor the threads belong to; may return no editor yet or a destroyed one. */
+  getEditor: () => Editor | undefined;
+  /** Called with every failed request. */
+  onError?: (error: Error) => void;
+}
+export interface EditorBackend {
+  /** Names the backend in error messages (`'http'`, `'memory'`, …). */
+  readonly name: string;
+  /**
+   * Settles once the backend knows which capabilities it really has (the HTTP adapter's `probe`, which drops what the
+   * server lacks). `createEditorContext` awaits it before it reports `ready`, so a composition that prunes by capability
+   * (`composeEditor(…, { backend })`) should run after it too. Never rejects; absent: usable at once.
+   */
+  readonly ready?: Promise<void>;
+  documents?: {
+    /** The stored content; `null` when the document does not exist (yet). */
+    load: (id: string) => Promise<JSONContent | null>;
+    save: (id: string, content: JSONContent) => Promise<void>;
+  };
+  collaboration?: {
+    /** Opens the live session of document `id`; `dispose()` closes the provider and the Y.Doc. */
+    connect: (id: string, token?: CollaborationToken) => {
+      ydoc: Y.Doc;
+      provider: HocuspocusProvider;
+      dispose: () => void;
+    };
+  };
+  assets?: {
+    /** 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. */
+    upload: (documentId: string, file: File) => Promise<{
+      url: string;
+      sha256?: string;
+    }>;
+  };
+  users?: {
+    search: (query: string, signal?: AbortSignal) => Promise<MentionUser[]>;
+  };
+  tags?: {
+    search: (query: string, signal?: AbortSignal) => Promise<string[]>;
+  };
+  settings?: {
+    /** The account's settings; `null` when it has none stored yet. */
+    load: () => Promise<EditorSettings | null>;
+    save: (settings: EditorSettings) => Promise<void>;
+  };
+  themes?: {
+    list: () => Promise<ThemeRecord[]>;
+    /** The stylesheet of theme `id` (unscoped). */
+    css: (id: string) => Promise<string>;
+    /** Adds an Obsidian theme to the shared library: the stylesheet and, optionally, its `manifest.json`; the backend derives name and id. */
+    store: (files: {
+      css: File;
+      manifest?: File;
+    }) => Promise<ThemeRecord>;
+    /** Deletes an uploaded theme; rejects for builtins and unknown ids. */
+    remove: (id: string) => Promise<boolean>;
+  };
+  ai?: {
+    models: () => Promise<{
+      presets: ModelProfile[];
+      slots: Record<ModelSlot, string>;
+    }>;
+    complete: (body: {
+      before: string;
+      model: ModelRef;
+    }, signal: AbortSignal) => Promise<{
+      text: string;
+    }>;
+    /** Streams the SSE events of `generate` or `chat`; throws `BackendError` (with `status`) on a non-2xx answer before the stream starts. */
+    stream: (path: 'generate' | 'chat', body: object, signal: AbortSignal) => AsyncIterable<AiStreamEvent>;
+    /** Speaker-segment cleanup of a transcript (one JSON answer, not a stream). */
+    transcriptCleanup: (body: TranscriptCleanupRequest, signal: AbortSignal) => Promise<TranscriptCleanupResponse>;
+    /** Turns a stored asset into readable content: transcription (with segment timestamps), PDF text or OCR, an image description, bibliographic data. */
+    extract: (body: ExtractRequest, signal: AbortSignal) => Promise<ExtractResponse>;
+  };
+  /** The comments model of document `documentId`. */
+  comments?: (documentId: string, options: BackendCommentsOptions) => CommentsModel;
+}
+//#endregion
+export type { BackendCapability };
+//# sourceMappingURL=backend.d.ts.map