@ecsplico/editor 2.0.0 → 2.1.0

package/dist/vue/components/EditorToolbar.js

@@ -1,13 +1,10 @@
 import { abilitiesAtSelection } from "../../core/abilities.js";
-import { createMetadataRegistry } from "../../core/metadata.js";
 import { mergeToolbarGroups } from "../../core/toolbar.js";
 import { contributions } from "../../core/define-editor.js";
-import { editorEntryOf } from "../../core/editor-ui.js";
+import { borrowedFeatureContext, editorEntryOf } from "../../core/editor-ui.js";
 import { useUiKit } from "../kit/use-ui-kit.js";
 import { useEditorContext } from "../context.js";
 import { useEditorI18n } from "../use-editor-i18n.js";
-import { useEditorUi } from "../use-editor-ui.js";
-import { useNotifier } from "../use-notifier.js";
 import { trackedStore } from "../store-ref.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createVNode, defineComponent, getCurrentInstance, openBlock, renderList, resolveDynamicComponent, toRaw, unref, withCtx, withModifiers } from "vue";
 //#region src/vue/components/EditorToolbar.vue
@@ -34,47 +31,13 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		const { Button: UButton, DropdownMenu: UDropdownMenu, FieldGroup: UFieldGroup, Tooltip: UTooltip } = useUiKit();
 		const appContext = useEditorContext();
 		const { t } = useEditorI18n();
-		const editorUi = useEditorUi(() => props.editor);
 		const instance = getCurrentInstance();
-		const fallbackMetadata = createMetadataRegistry();
-		const entry = () => editorEntryOf(props.editor ? toRaw(props.editor) : void 0);
-		const ctx = {
+		const ctx = borrowedFeatureContext({
 			app: appContext,
-			locale: appContext.locale,
-			t: appContext.t,
-			notify: useNotifier(() => props.editor),
-			settings: trackedStore(appContext.settings),
-			fetch: appContext.fetch,
-			ai: appContext.ai,
-			get metadata() {
-				return entry()?.ctx.metadata ?? fallbackMetadata;
-			},
-			ui: {
-				openSettings: (tab) => editorUi.value?.openSettings(tab),
-				toggleSidebar: () => editorUi.value?.toggleSidebar(),
-				toggleComments: () => editorUi.value?.toggleComments(),
-				get commentsOpen() {
-					return editorUi.value?.commentsOpen ?? false;
-				}
-			},
-			get documentId() {
-				return entry()?.ctx.documentId;
-			},
-			get upload() {
-				return entry()?.ctx.upload;
-			},
-			get collaboration() {
-				return entry()?.ctx.collaboration;
-			},
-			get anchorResolver() {
-				return entry()?.ctx.anchorResolver ?? null;
-			},
-			get abilities() {
-				return entry()?.ctx.abilities ?? {};
-			},
-			slashCommands: () => entry()?.ctx.slashCommands() ?? [],
-			getEditor: () => props.editor
-		};
+			getEditor: () => props.editor,
+			unwrap: toRaw,
+			settings: trackedStore(appContext.settings)
+		});
 		const built = /* @__PURE__ */ new WeakMap();
 		function groupsOf(preset) {
 			if (!preset) return [];
@@ -88,7 +51,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		groupsOf(props.preset);
 		const visibleGroups = computed(() => {
 			const editor = props.editor;
-			return groupsOf(entry()?.preset ?? props.preset).filter((group) => !editor || !group.visible || group.visible(editor)).map((group) => ({
+			return groupsOf(editorEntryOf(editor && toRaw(editor))?.preset ?? props.preset).filter((group) => !editor || !group.visible || group.visible(editor)).map((group) => ({
 				group,
 				items: group.items.filter((item) => !editor || !item.visible || item.visible(editor))
 			})).filter(({ items }) => items.length > 0);

package/dist/vue/components/EditorToolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditorToolbar.js","names":["_openBlock","_createElementBlock","_unref","_Fragment","_renderList","_createCommentVNode","_createVNode","_withCtx","_createBlock","_resolveDynamicComponent","_withModifiers"],"sources":["../../../src/vue/components/EditorToolbar.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { useUiKit } from '../kit/use-ui-kit'\nimport type { Editor } from '@tiptap/core'\nimport { type Component, computed, getCurrentInstance, toRaw } from 'vue'\nimport { abilitiesAtSelection } from '../../core/abilities'\nimport { contributions } from '../../core/define-editor'\nimport { editorEntryOf } from '../../core/editor-ui'\nimport { useEditorContext } from '../context'\nimport { useEditorI18n } from '../use-editor-i18n'\nimport { useEditorUi } from '../use-editor-ui'\nimport { useNotifier } from '../use-notifier'\nimport { trackedStore } from '../store-ref'\nimport type { EditorPreset, FeatureContext } from '../../core/feature'\nimport { createMetadataRegistry } from '../../core/metadata'\nimport type { Ability } from '../../core/schema/abilities'\nimport { mergeToolbarGroups, type MenuItem, type ToolbarGroup, type ToolbarItem } from '../../core/toolbar'\n\n/**\n * The toolbar of an editor, placed anywhere on the page. `editor` is the instance it works on (from the surface's\n * `ready` event); the preset registered for that instance supplies the groups, `preset` renders them (disabled) while\n * there is no editor yet. Never reads a global active editor.\n */\nconst props = defineProps<{ editor?: Editor, preset?: EditorPreset }>()\n\nconst { Button: UButton, DropdownMenu: UDropdownMenu, FieldGroup: UFieldGroup, Tooltip: UTooltip } = useUiKit()\n\nconst appContext = useEditorContext()\nconst { t } = useEditorI18n()\nconst editorUi = useEditorUi(() => props.editor)\nconst instance = getCurrentInstance()\nconst fallbackMetadata = createMetadataRegistry()\n\nconst entry = () => editorEntryOf(props.editor ? toRaw(props.editor) : undefined)\n\n// The context toolbar factories see: settings and fetch of the app, everything per-surface delegates to the editor's\n// registered context while there is one.\nconst ctx: FeatureContext = {\n  app: appContext,\n  locale: appContext.locale,\n  t: appContext.t,\n  notify: useNotifier(() => props.editor),\n  // Tracked: `active`/`visible`/`menu` read the settings during render, which must re-run when they change.\n  settings: trackedStore(appContext.settings),\n  fetch: appContext.fetch,\n  ai: appContext.ai,\n  get metadata() { return entry()?.ctx.metadata ?? fallbackMetadata },\n  ui: {\n    openSettings: tab => editorUi.value?.openSettings(tab),\n    toggleSidebar: () => editorUi.value?.toggleSidebar(),\n    toggleComments: () => editorUi.value?.toggleComments(),\n    get commentsOpen() { return editorUi.value?.commentsOpen ?? false },\n  },\n  get documentId() { return entry()?.ctx.documentId },\n  get upload() { return entry()?.ctx.upload },\n  get collaboration() { return entry()?.ctx.collaboration },\n  get anchorResolver() { return entry()?.ctx.anchorResolver ?? null },\n  get abilities() { return entry()?.ctx.abilities ?? {} },\n  slashCommands: () => entry()?.ctx.slashCommands() ?? [],\n  getEditor: () => props.editor,\n}\n\n// Factories run during setup (they may use composables that inject); a later preset is built within the app context.\nconst built = new WeakMap<EditorPreset, ToolbarGroup[]>()\nfunction groupsOf(preset: EditorPreset | undefined): ToolbarGroup[] {\n  if (!preset) return []\n  const cached = built.get(preset)\n  if (cached) return cached\n  const build = () => mergeToolbarGroups(contributions(preset, 'toolbar').flatMap(factory => factory(ctx)))\n  const groups = instance ? instance.appContext.app.runWithContext(build) : build()\n  built.set(preset, groups)\n  return groups\n}\ngroupsOf(props.preset)\n\nconst visibleGroups = computed(() => {\n  const editor = props.editor\n  const groups = groupsOf(entry()?.preset ?? props.preset)\n  return groups\n    .filter(group => !editor || !group.visible || group.visible(editor))\n    .map(group => ({ group, items: group.items.filter(item => !editor || !item.visible || item.visible(editor)) }))\n    .filter(({ items }) => items.length > 0)\n})\n\n// `active`, `can()` and the abilities read the vue-3 Editor's reactive `state`, so these re-evaluate on every transaction.\nconst abilities = computed(() => props.editor ? abilitiesAtSelection(props.editor) : new Set<Ability>())\nfunction active(item: ToolbarItem): boolean {\n  return !!props.editor && !!item.active?.(props.editor)\n}\nfunction disabled(item: ToolbarItem): boolean {\n  const editor = props.editor\n  if (!editor) return true\n  if (item.disabled?.(editor)) return true\n  return !active(item) && !!item.ability && !abilities.value.has(item.ability)\n}\nfunction run(item: ToolbarItem) {\n  if (props.editor) item.run?.(props.editor)\n}\nfunction menuOf(item: ToolbarItem): MenuItem[] {\n  return props.editor && item.menu ? item.menu(props.editor) : []\n}\n/** Descriptors are framework-agnostic (`component: unknown`); in this Vue toolbar they are Vue components. */\nfunction componentOf(item: ToolbarItem): Component | undefined {\n  return item.component as Component | undefined\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap items-center gap-1.5\" role=\"toolbar\" :aria-label=\"t('toolbar.label')\">\n    <template v-for=\"({ group, items }, gi) in visibleGroups\" :key=\"group.id\">\n      <span v-if=\"gi > 0\" role=\"separator\" aria-orientation=\"vertical\" class=\"mx-2 h-6 w-[2px] shrink-0 bg-[var(--sk-border-accented)]\" />\n      <UFieldGroup size=\"sm\">\n        <template v-for=\"item in items\" :key=\"item.id\">\n          <component :is=\"componentOf(item)\" v-if=\"componentOf(item)\" :editor=\"props.editor\" />\n          <UDropdownMenu v-else-if=\"item.menu\" :items=\"menuOf(item)\">\n            <UTooltip :text=\"item.label\" :kbds=\"item.kbds\">\n              <UButton\n                :key=\"item.icon\"\n                color=\"neutral\"\n                variant=\"ghost\"\n                :icon=\"item.icon\"\n                :aria-label=\"item.label\"\n                :disabled=\"disabled(item)\"\n                @mousedown.prevent\n              />\n            </UTooltip>\n          </UDropdownMenu>\n          <UTooltip v-else :text=\"item.label\" :kbds=\"item.kbds\">\n            <UButton\n              :key=\"item.icon\"\n              color=\"neutral\"\n              variant=\"ghost\"\n              active-color=\"primary\"\n              active-variant=\"soft\"\n              :icon=\"item.icon\"\n              :aria-label=\"item.label\"\n              :active=\"active(item)\"\n              :aria-pressed=\"item.active ? active(item) : undefined\"\n              :disabled=\"disabled(item)\"\n              @mousedown.prevent\n              @click=\"run(item)\"\n            />\n          </UTooltip>\n        </template>\n      </UFieldGroup>\n    </template>\n  </div>\n</template>\n"],"mappings":"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"}
+{"version":3,"file":"EditorToolbar.js","names":["_openBlock","_createElementBlock","_unref","_Fragment","_renderList","_createCommentVNode","_createVNode","_withCtx","_createBlock","_resolveDynamicComponent","_withModifiers"],"sources":["../../../src/vue/components/EditorToolbar.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { useUiKit } from '../kit/use-ui-kit'\nimport type { Editor } from '@tiptap/core'\nimport { type Component, computed, getCurrentInstance, toRaw } from 'vue'\nimport { abilitiesAtSelection } from '../../core/abilities'\nimport { contributions } from '../../core/define-editor'\nimport { borrowedFeatureContext, editorEntryOf } from '../../core/editor-ui'\nimport { useEditorContext } from '../context'\nimport { useEditorI18n } from '../use-editor-i18n'\nimport { trackedStore } from '../store-ref'\nimport type { EditorPreset } from '../../core/feature'\nimport type { Ability } from '../../core/schema/abilities'\nimport { mergeToolbarGroups, type MenuItem, type ToolbarGroup, type ToolbarItem } from '../../core/toolbar'\n\n/**\n * The toolbar of an editor, placed anywhere on the page. `editor` is the instance it works on (from the surface's\n * `ready` event); the preset registered for that instance supplies the groups, `preset` renders them (disabled) while\n * there is no editor yet. Never reads a global active editor.\n */\nconst props = defineProps<{ editor?: Editor, preset?: EditorPreset }>()\n\nconst { Button: UButton, DropdownMenu: UDropdownMenu, FieldGroup: UFieldGroup, Tooltip: UTooltip } = useUiKit()\n\nconst appContext = useEditorContext()\nconst { t } = useEditorI18n()\nconst instance = getCurrentInstance()\n\n// The context toolbar factories see: settings and fetch of the app, everything per-surface delegates to the editor's\n// registered context while there is one.\nconst ctx = borrowedFeatureContext({\n  app: appContext,\n  getEditor: () => props.editor,\n  unwrap: toRaw,\n  // Tracked: `active`/`visible`/`menu` read the settings during render, which must re-run when they change.\n  settings: trackedStore(appContext.settings),\n})\n\n// Factories run during setup (they may use composables that inject); a later preset is built within the app context.\nconst built = new WeakMap<EditorPreset, ToolbarGroup[]>()\nfunction groupsOf(preset: EditorPreset | undefined): ToolbarGroup[] {\n  if (!preset) return []\n  const cached = built.get(preset)\n  if (cached) return cached\n  const build = () => mergeToolbarGroups(contributions(preset, 'toolbar').flatMap(factory => factory(ctx)))\n  const groups = instance ? instance.appContext.app.runWithContext(build) : build()\n  built.set(preset, groups)\n  return groups\n}\ngroupsOf(props.preset)\n\nconst visibleGroups = computed(() => {\n  const editor = props.editor\n  const groups = groupsOf(editorEntryOf(editor && toRaw(editor))?.preset ?? props.preset)\n  return groups\n    .filter(group => !editor || !group.visible || group.visible(editor))\n    .map(group => ({ group, items: group.items.filter(item => !editor || !item.visible || item.visible(editor)) }))\n    .filter(({ items }) => items.length > 0)\n})\n\n// `active`, `can()` and the abilities read the vue-3 Editor's reactive `state`, so these re-evaluate on every transaction.\nconst abilities = computed(() => props.editor ? abilitiesAtSelection(props.editor) : new Set<Ability>())\nfunction active(item: ToolbarItem): boolean {\n  return !!props.editor && !!item.active?.(props.editor)\n}\nfunction disabled(item: ToolbarItem): boolean {\n  const editor = props.editor\n  if (!editor) return true\n  if (item.disabled?.(editor)) return true\n  return !active(item) && !!item.ability && !abilities.value.has(item.ability)\n}\nfunction run(item: ToolbarItem) {\n  if (props.editor) item.run?.(props.editor)\n}\nfunction menuOf(item: ToolbarItem): MenuItem[] {\n  return props.editor && item.menu ? item.menu(props.editor) : []\n}\n/** Descriptors are framework-agnostic (`component: unknown`); in this Vue toolbar they are Vue components. */\nfunction componentOf(item: ToolbarItem): Component | undefined {\n  return item.component as Component | undefined\n}\n</script>\n\n<template>\n  <div class=\"flex flex-wrap items-center gap-1.5\" role=\"toolbar\" :aria-label=\"t('toolbar.label')\">\n    <template v-for=\"({ group, items }, gi) in visibleGroups\" :key=\"group.id\">\n      <span v-if=\"gi > 0\" role=\"separator\" aria-orientation=\"vertical\" class=\"mx-2 h-6 w-[2px] shrink-0 bg-[var(--sk-border-accented)]\" />\n      <UFieldGroup size=\"sm\">\n        <template v-for=\"item in items\" :key=\"item.id\">\n          <component :is=\"componentOf(item)\" v-if=\"componentOf(item)\" :editor=\"props.editor\" />\n          <UDropdownMenu v-else-if=\"item.menu\" :items=\"menuOf(item)\">\n            <UTooltip :text=\"item.label\" :kbds=\"item.kbds\">\n              <UButton\n                :key=\"item.icon\"\n                color=\"neutral\"\n                variant=\"ghost\"\n                :icon=\"item.icon\"\n                :aria-label=\"item.label\"\n                :disabled=\"disabled(item)\"\n                @mousedown.prevent\n              />\n            </UTooltip>\n          </UDropdownMenu>\n          <UTooltip v-else :text=\"item.label\" :kbds=\"item.kbds\">\n            <UButton\n              :key=\"item.icon\"\n              color=\"neutral\"\n              variant=\"ghost\"\n              active-color=\"primary\"\n              active-variant=\"soft\"\n              :icon=\"item.icon\"\n              :aria-label=\"item.label\"\n              :active=\"active(item)\"\n              :aria-pressed=\"item.active ? active(item) : undefined\"\n              :disabled=\"disabled(item)\"\n              @mousedown.prevent\n              @click=\"run(item)\"\n            />\n          </UTooltip>\n        </template>\n      </UFieldGroup>\n    </template>\n  </div>\n</template>\n"],"mappings":"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"}

package/dist/vue/context.d.ts

@@ -17,7 +17,7 @@ export interface VueEditorOptions extends EditorContextOptions {
  * and timer stop with the app. App-level notices (`options.notify`, default: queued until the first `EditorSurface`
  * mounts and hands over the kit's `notifier()`) show as the kit's toasts.
  */
-export declare function createEditor({ kit, ...options }: VueEditorOptions): Plugin;
+export declare function createEditor({ kit, ...options }?: VueEditorOptions): Plugin;
 /** The app's editor context; throws a descriptive error when `createEditor()` was not installed. */
 export declare function useEditorContext(): EditorContext;
 //#endregion

package/dist/vue/context.js

@@ -15,7 +15,7 @@ const EDITOR_CONTEXT = Symbol("tiptap-editor:context");
 * and timer stop with the app. App-level notices (`options.notify`, default: queued until the first `EditorSurface`
 * mounts and hands over the kit's `notifier()`) show as the kit's toasts.
 */
-function createEditor({ kit = nuxtUiKit(), ...options }) {
+function createEditor({ kit = nuxtUiKit(), ...options } = {}) {
 	return { install(app) {
 		const ctx = createEditorContext({
 			notify: createQueuedNotifier(),

package/dist/vue/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/vue/context.ts"],"sourcesContent":["import { type InjectionKey, inject, type Plugin } from 'vue'\nimport { createEditorContext, type EditorContext, type EditorContextOptions } from '../core/context'\nimport { createQueuedNotifier } from './notify'\nimport { createSettingsBridge } from './settings'\nimport { nuxtUiKit } from './kit/nuxt-ui'\nimport { VUE_UI_KIT } from './kit/use-ui-kit'\nimport type { VueUiKit } from './kit/types'\n\nexport const EDITOR_CONTEXT: InjectionKey<EditorContext> = Symbol('tiptap-editor:context')\n\n/** What `createEditor` takes: the framework-free context options plus the UI kit that renders the chrome. */\nexport interface VueEditorOptions extends EditorContextOptions {\n  /** The widgets the chrome components render. Default: `nuxtUiKit()` (`/vue/kit/nuxt-ui`), which needs `@nuxt/ui` set up in the host; pass your own `VueUiKit` to render the chrome with another library. */\n  kit?: VueUiKit\n}\n\n/**\n * The editor context of a Vue app: the settings shared by all editors of the app, the HTTP client and the UI kit\n * (`useUiKit()`). Install with `app.use(createEditor())`. The settings are read from localStorage right away (client only) and every change is\n * written back. With `settings.remote`, `GET /api/editor/settings` (on the first `useEditorSettings()`) answers: `200`\n * replaces them with the user's account settings (`synced`), `204` (the host's adapter keeps no settings), `401` or a\n * network error keep the local ones; once synced every change is also sent to the server (`PUT`, debounced). Watcher\n * and timer stop with the app. App-level notices (`options.notify`, default: queued until the first `EditorSurface`\n * mounts and hands over the kit's `notifier()`) show as the kit's toasts.\n */\nexport function createEditor({ kit = nuxtUiKit(), ...options }: VueEditorOptions): Plugin {\n  return {\n    install(app) {\n      const ctx = createEditorContext({ notify: createQueuedNotifier(), ...options })\n      app.provide(VUE_UI_KIT, kit)\n      app.provide(EDITOR_CONTEXT, ctx)\n      const bridge = createSettingsBridge(ctx)\n      app.onUnmount(() => {\n        bridge.dispose()\n        ctx.dispose()\n      })\n    },\n  }\n}\n\n/** The app's editor context; throws a descriptive error when `createEditor()` was not installed. */\nexport function useEditorContext(): EditorContext {\n  const context = inject(EDITOR_CONTEXT, null)\n  if (!context) throw new Error('@ecsplico/editor: no editor context; install it with app.use(createEditor())')\n  return context\n}\n"],"mappings":";;;;;;;AAQA,MAAa,iBAA8C,OAAO,uBAAuB;;;;;;;;;;AAiBzF,SAAgB,aAAa,EAAE,MAAM,UAAU,GAAG,GAAG,WAAqC;CACxF,OAAO,EACL,QAAQ,KAAK;EACX,MAAM,MAAM,oBAAoB;GAAE,QAAQ,qBAAqB;GAAG,GAAG;EAAQ,CAAC;EAC9E,IAAI,QAAQ,YAAY,GAAG;EAC3B,IAAI,QAAQ,gBAAgB,GAAG;EAC/B,MAAM,SAAS,qBAAqB,GAAG;EACvC,IAAI,gBAAgB;GAClB,OAAO,QAAQ;GACf,IAAI,QAAQ;EACd,CAAC;CACH,EACF;AACF;;AAGA,SAAgB,mBAAkC;CAChD,MAAM,UAAU,OAAO,gBAAgB,IAAI;CAC3C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,8EAA8E;CAC5G,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/vue/context.ts"],"sourcesContent":["import { type InjectionKey, inject, type Plugin } from 'vue'\nimport { createEditorContext, type EditorContext, type EditorContextOptions } from '../core/context'\nimport { createQueuedNotifier } from './notify'\nimport { createSettingsBridge } from './settings'\nimport { nuxtUiKit } from './kit/nuxt-ui'\nimport { VUE_UI_KIT } from './kit/use-ui-kit'\nimport type { VueUiKit } from './kit/types'\n\nexport const EDITOR_CONTEXT: InjectionKey<EditorContext> = Symbol('tiptap-editor:context')\n\n/** What `createEditor` takes: the framework-free context options plus the UI kit that renders the chrome. */\nexport interface VueEditorOptions extends EditorContextOptions {\n  /** The widgets the chrome components render. Default: `nuxtUiKit()` (`/vue/kit/nuxt-ui`), which needs `@nuxt/ui` set up in the host; pass your own `VueUiKit` to render the chrome with another library. */\n  kit?: VueUiKit\n}\n\n/**\n * The editor context of a Vue app: the settings shared by all editors of the app, the HTTP client and the UI kit\n * (`useUiKit()`). Install with `app.use(createEditor())`. The settings are read from localStorage right away (client only) and every change is\n * written back. With `settings.remote`, `GET /api/editor/settings` (on the first `useEditorSettings()`) answers: `200`\n * replaces them with the user's account settings (`synced`), `204` (the host's adapter keeps no settings), `401` or a\n * network error keep the local ones; once synced every change is also sent to the server (`PUT`, debounced). Watcher\n * and timer stop with the app. App-level notices (`options.notify`, default: queued until the first `EditorSurface`\n * mounts and hands over the kit's `notifier()`) show as the kit's toasts.\n */\nexport function createEditor({ kit = nuxtUiKit(), ...options }: VueEditorOptions = {}): Plugin {\n  return {\n    install(app) {\n      const ctx = createEditorContext({ notify: createQueuedNotifier(), ...options })\n      app.provide(VUE_UI_KIT, kit)\n      app.provide(EDITOR_CONTEXT, ctx)\n      const bridge = createSettingsBridge(ctx)\n      app.onUnmount(() => {\n        bridge.dispose()\n        ctx.dispose()\n      })\n    },\n  }\n}\n\n/** The app's editor context; throws a descriptive error when `createEditor()` was not installed. */\nexport function useEditorContext(): EditorContext {\n  const context = inject(EDITOR_CONTEXT, null)\n  if (!context) throw new Error('@ecsplico/editor: no editor context; install it with app.use(createEditor())')\n  return context\n}\n"],"mappings":";;;;;;;AAQA,MAAa,iBAA8C,OAAO,uBAAuB;;;;;;;;;;AAiBzF,SAAgB,aAAa,EAAE,MAAM,UAAU,GAAG,GAAG,YAA8B,CAAC,GAAW;CAC7F,OAAO,EACL,QAAQ,KAAK;EACX,MAAM,MAAM,oBAAoB;GAAE,QAAQ,qBAAqB;GAAG,GAAG;EAAQ,CAAC;EAC9E,IAAI,QAAQ,YAAY,GAAG;EAC3B,IAAI,QAAQ,gBAAgB,GAAG;EAC/B,MAAM,SAAS,qBAAqB,GAAG;EACvC,IAAI,gBAAgB;GAClB,OAAO,QAAQ;GACf,IAAI,QAAQ;EACd,CAAC;CACH,EACF;AACF;;AAGA,SAAgB,mBAAkC;CAChD,MAAM,UAAU,OAAO,gBAAgB,IAAI;CAC3C,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,8EAA8E;CAC5G,OAAO;AACT"}

package/dist/vue/use-editor-ui.d.ts

@@ -1,6 +1,6 @@
 import { EditorUi } from "../core/editor-ui.js";
-import { ComputedRef, InjectionKey, MaybeRefOrGetter } from "vue";
 import { Editor } from "@tiptap/core";
+import { ComputedRef, InjectionKey, MaybeRefOrGetter } from "vue";
 //#region src/vue/use-editor-ui.d.ts
 /** Provided by `EditorSurface` to its subtree (e.g. `AiSelectionMenu` → `ModelQuickSwitch`). */
 export declare const EDITOR_UI: InjectionKey<EditorUi>;

package/dist/vue/use-notifier.d.ts

@@ -1,6 +1,6 @@
 import { Notifier } from "../core/notify.js";
-import { MaybeRefOrGetter } from "vue";
 import { Editor } from "@tiptap/core";
+import { MaybeRefOrGetter } from "vue";
 //#region src/vue/use-notifier.d.ts
 /**
  * The notifier of `editor`'s surface (its toasts), else the app context's (see `notifierOf`): what `createEditor({ notify })`

package/docs/integration.md

@@ -17,6 +17,7 @@ How a host composes the editor from features, where settings and view state live
 11. [Settings persistence and app lifetime](#11-settings-persistence-and-app-lifetime)
 12. [Migrating from `#tiptap-editor`](#12-migrating-from-tiptap-editor)
 13. [Dependency rules and bundle proof](#13-dependency-rules-and-bundle-proof)
+14. [Storage adapters, comment stores, Nitro host, `useEditorDocument`](#14-storage-adapters-comment-stores-nitro-host-useeditordocument)
 
 ## 1. Feature composition and entries
 
@@ -328,7 +329,7 @@ Two optional features build on the session's `user`; the advanced editor contain
 - `authorsFeature()` marks every text run the user inserts with an `author` mark (`{ id, name, color }`; one author per run, remote changes and Yjs undo/redo keep the original author's mark). Without `collaboration.user` it attributes nothing, so standalone editors write unmarked text. Colouring is a per-user preference (`editing.authorColors`, `editing.authorColorStyle`).
 - `commentsFeature()` (requires `collab`) stores comment threads in the Y.Doc, in a `Y.Map` named `comments`; the commented range is a `comment` mark. Threads therefore sync live and persist with the document, but they are **not** part of the JSON/Markdown adapter content. Without a Y.Doc and a `collaboration.user` the UI says „Kommentare gibt es nur in gemeinsam bearbeiteten Dokumenten.“ and nothing can be written.
 - Both marks are in `advancedSchemaExtensions()`, so the server's Yjs↔JSON conversion keeps them. They have no Markdown form: Markdown export, imports and the AI context ignore them (`DocumentMarkdown`).
-- Surface contract: `v-model:comments-open` (Vue `EditorSurface`/`AdvancedEditor`) or `commentsOpen`/`onCommentsOpenChange` (React) is the open state of the margin column, which the host renders with `CommentsMargin` inside the editor's scroll container; `useEditorUi().toggleComments()` and `Mod-Shift-m` toggle it, and it excludes the AI sidebar.
+- Surface contract: `v-model:comments-open` (Vue `EditorSurface`/`AdvancedEditor`) or `commentsOpen`/`onCommentsOpenChange` (React) is the open state of the margin column, which the host renders with `CommentsMargin` inside the editor's scroll container; `useEditorUi().toggleComments()` and `Mod-Shift-m` toggle it, and it excludes the AI sidebar. The column lays its cards out with the framework-free `layoutMargin` / `createMarginController` of `@ecsplico/editor/comments`: the active thread sits exactly at its text's line, the others are one-line cards out of its way, resolved threads sit behind „Erledigt (n)“, and a thread whose text was deleted stays greyed out at the deletion point („Text gelöscht“) until undo re-attaches it ([usage guide](./usage.md#authors-and-comments)).
 
 ### Positions that survive concurrent edits
 
@@ -390,7 +391,7 @@ PORT=3200 node .output/server/index.mjs
 
 ## 10. The file browser and `DocumentStore`
 
-`DocumentTree` (`@ecsplico/editor/tree/vue` or `@ecsplico/editor/tree/react`) is the file drawer: a „Dokumente“ root with folders and documents, create/rename/move/delete, drag and drop, kind filters per item, and the open document's outline (headings of a simple document, or the composites tree in the preferred structure) listed under it. It knows nothing about routing, HTTP or toasts of the host: the host passes a `DocumentStore`. The store contract, the types and the view-state model live in the framework-free `@ecsplico/editor/tree`; the two components are thin renderings of the same model. The tree's own messages (delete with undo) are notices: Vue needs `<UApp>`, React needs `EditorContextProvider` and a mounted `Toaster`.
+`DocumentTree` (`@ecsplico/editor/tree/vue` or `@ecsplico/editor/tree/react`) is the file drawer: a „Dokumente“ root with folders and documents, create/rename/move/delete, drag and drop, kind filters per item, a title filter („Titel filtern“), and the open document's outline (headings of a simple document, or the composites tree in the preferred structure) listed under it. It knows nothing about routing, HTTP or toasts of the host: the host passes a `DocumentStore`. The store contract, the types and the view-state model live in the framework-free `@ecsplico/editor/tree`; the two components render one internal tree model (rows, drag and drop, title filter, rename and create; not exported). The tree's own messages (delete with undo) are notices: Vue needs `<UApp>`, React needs `EditorContextProvider` and a mounted `Toaster`.
 
 ```vue
 <script setup lang="ts">
@@ -464,7 +465,7 @@ Semantics every implementation must keep:
 ### Filters, virtual root, outline
 
 - Filters hide kinds below a tree item (per item key); they persist in `localStorage` under `tip-tree:node-filters`. The view state is a framework-free model: `createTreeView()` builds one (`nodeFilters`, `expanded`, `expand`, `setKindHidden`, `clearFilter`, `clearAllFilters`, `followFolderMove`), `treeView(context)` returns the one of an `EditorContext`'s app, and `useTreeView()` (`/tree/vue`: `nodeFilters` and `expanded` as refs; `/tree/react`: as plain values that re-render the component) reads it, so several trees of one app share it (see [§11](#11-settings-persistence-and-app-lifetime)).
-- The settings value `blocks.treeRoot` is `'folders'` (default: folders with their documents, the open document is an entry among them) or `'file'`. With `'file'`, an open document in composite structure (`blocks.structure === 'composite'`) is the *virtual root* of the tree: its composites are the nested items and dragging one moves the block (`moveBlockInto`). With no open document or the headings structure the tree shows the folders instead. Switching it in the settings panel re-roots the tree immediately.
+- The settings value `blocks.treeRoot` is `'folders'` (default: folders with their documents, the open document is an entry among them) or `'file'`. With `'file'`, an open document in composite structure (`blocks.structure === 'composite'`) is the *virtual root* of the tree: its composites are the nested items and dragging one moves the block (`moveBlockInto`) unless the target Baustein's kind does not accept it (`CompositeKind.accepts`): the drop is then refused, outlined red with the reason of `moveIntoVerdict` under the row. With no open document or the headings structure the tree shows the folders instead. Switching it in the settings panel re-roots the tree immediately.
 - The outline of the open document is read from `editor` (composites in composite structure, headings otherwise) and refreshed, debounced, on `update`. `DocumentTree` re-subscribes when the `editor` prop changes and removes its listener when the editor changes or the tree unmounts, so switching documents never leaves a stale listener on the previous editor.
 
 ### Not in the library
@@ -493,7 +494,7 @@ The former Nuxt module `modules/tiptap-editor` (alias `#tiptap-editor`, auto-imp
 | `AiSidebar`, `AiReviewBar`, `AiSelectionMenu`, `ModelQuickSwitch`, `useAiAssistant`, `useDocumentChat`, `useModelProfiles` | `@ecsplico/editor/ai/vue` (`/ai/react` on React; the framework-free models `modelProfiles`, `createAiAssistant`, `createDocumentChat` in `@ecsplico/editor/ai`) |
 | `useFileImport`, `AudioRecorderModal`, `useAudioRecorder`, `pickFiles` | `@ecsplico/editor/media/vue` (`/media/react` on React); `pickFiles` and the framework-free models in `@ecsplico/editor/media` |
 | `createTranscriptCleanup`, `hasTranscriptSegments` | `@ecsplico/editor/integrations/transcript-ai` |
-| `defaultCompositeKinds(t)`, `CompositeKind`, `headingsMarkdown`, `compositeOutline`, `moveBlockInto`, `compositeJSON`, markdown fence helpers, `CompositeTable`, `CompositeInspector`, `useCompositeRows`, `setComposite*` writers | `@ecsplico/editor/composites` (framework-free), `/composites/vue` or `/composites/react` for the components and `useCompositeRows` (schema subset: `/composites/schema`) |
+| `defaultCompositeKinds(t)`, `CompositeKind`, `kindAccepts`, `AcceptedChildren`, `headingsMarkdown`, `compositeOutline`, `moveBlockInto`, `moveIntoVerdict`, `compositeJSON`, markdown fence helpers, `CompositeTable`, `CompositeInspector`, `useCompositeRows`, `setComposite*` writers | `@ecsplico/editor/composites` (framework-free), `/composites/vue` or `/composites/react` for the components and `useCompositeRows` (schema subset: `/composites/schema`) |
 | `headingOutline`, `revealBlockInEditor` (framework-free), `EditorOutline` (`/outline/vue`, `/outline/react`) | `@ecsplico/editor/outline` |
 | `EMPTY_EDITOR_CONTENT`, `ABILITY`, `Ability`, `findBlockById`, block ID helpers | `@ecsplico/editor/core/schema` |
 | `fetchErrorMessage`, `downloadText`, abilities helpers (`abilitiesAtSelection`, `hasAbility`) | `@ecsplico/editor/core` |
@@ -535,3 +536,95 @@ bun run check:editor-composition
 ```
 
 `check:editor-entries` collects the module IDs of every emitted chunk (including dynamic ones) and fails on a forbidden module, on a source module outside the fixture's allow-list, or on a missing required module. To check your own composition, add `packages/editor/checks/fixtures/<name>/` (an `index.html` plus `main.ts`/`main.tsx` that mounts the surface with its toolbar, so unused factories cannot be tree-shaken away) and one `FIXTURES` entry with `forbid`, `require` and `allowSource` patterns (and `plugins: 'react'` for a React fixture) in `packages/editor/checks/entries.ts`. Fixtures exist for `simple`, each feature (Vue, `-react` and `headless-` variants), each integration, `tree`, `tree-react`, `headless-tree`, `advanced`, `advanced-react`, the headless core (`core-headless`), the React simple editor (`react-simple`) and the Node schema.
+
+## 14. Storage adapters, comment stores, Nitro host, `useEditorDocument`
+
+Ready-made implementations of the `EditorAdapter` contract (§3), comment stores, a Nuxt-free Nitro host and a Vue composable ship inside this package as subpath entries (formerly the separate package `@ecsplico/editor-adapters`; from 2.1.0 `@ecsplico/editor` is the only dependency). A host picks where documents live without touching the editor. All adapters satisfy the same contract test (`test/adapters/adapter-contract.test.ts`).
+
+```sh
+bun add @ecsplico/editor   # plus drizzle-orm only for the two drizzle entries
+```
+
+| Entry | Adapter | Storage | Needs |
+|---|---|---|---|
+| `@ecsplico/editor/adapters/json` | `createJsonAdapter({ dir, users? })` | files under `dir` | nothing |
+| `@ecsplico/editor/adapters/drizzle` | `createDrizzleAdapter({ db, tables: editorTables() })` | SQLite via drizzle (`bun:sqlite`, better-sqlite3, libsql, D1) | `drizzle-orm` |
+| `@ecsplico/editor/adapters/forge` | `createForgeAdapter({ content, state, schema, authenticate, … })` | the host's Markdown files; state, assets and settings go to a `state` adapter | nothing |
+| `@ecsplico/editor/anchors` | `captureAnchor`, `capturePoint`, `resolveAnchor`, `mapAnchor` | pure functions over ProseMirror documents | `@tiptap/pm` |
+| `@ecsplico/editor/comments/json` | `createJsonCommentStore({ file })` | one JSON file (forge's `concept-discussions.json` layout) | nothing |
+| `@ecsplico/editor/comments/drizzle` | `createDrizzleCommentStore({ db, tables: commentTables() })` | SQLite via drizzle | `drizzle-orm` |
+| `@ecsplico/editor/comments/server` | `handleCommentsRequest(store, { method, documentId, body })` | the REST handler a host routes its comments endpoint to | nothing |
+| `@ecsplico/editor/comments/client` | `createRestCommentsModel({ fetch, documentId, user, canComment, getEditor })` | the editor's `CommentsModel` over that endpoint (framework-free) | nothing |
+| `@ecsplico/editor/server/nitro` | `installEditorServer(nitroApp, { adapter, collab, ai?, comments? })` | mounts the editor's routes, the collaboration websocket and optional AI and comments routes on a Nitro app | `h3` |
+| `@ecsplico/editor/adapters/vue` | `useEditorDocument(id, { fetch, collaboration?, user? })` | the document a Vue editor surface binds to: `modelValue`, `dirty`, `save()`, `collaboration`, `comments` | `vue`, `yjs`, `@hocuspocus/provider` |
+| `@ecsplico/editor/adapters` | types only | | |
+
+Peers: `drizzle-orm` (`^0.45.0`, optional) is needed by `./adapters/drizzle` and `./comments/drizzle` only; `h3` (optional) by `./server/nitro`; `vue` (optional), `yjs`, `@hocuspocus/provider` by `./adapters/vue`. `bun run check:editor-entries` builds all eleven adapter entries through its fixtures (`adapters-node`: `./adapters`, `./adapters/json`, `./adapters/forge`, `./anchors`, `./comments/server`, `./comments/json`; `adapters-drizzle`: both drizzle entries; `adapters-nitro`: `./server/nitro`; `adapters-vue`: `./adapters/vue`; `headless-comments-client`: `./comments/client`) and proves on the bundles that Vue is only reachable from `./adapters/vue`, Nitro only from `./server/nitro`, drizzle only from the two drizzle entries, and that no adapter entry reaches React. Entries named `./adapters/react`, `./server/nest` and `./adapters/prisma` are reserved for a later platform adoption and are not exported; the check fails if one of them appears in `exports` before it is designed.
+
+### The tier rule
+
+Three tiers, one direction of dependency:
+
+1. **The editor** (`@ecsplico/editor`, everything except `adapters/`) and the `EditorAdapter` contract (`@ecsplico/editor/server`). It knows no storage and no host.
+2. **Adapters** (`src/adapters/`, the entries above): implementations of that contract and the wiring around it. They depend on the editor; they import no application code, and no entry imports another UI or server framework than the one it is named for.
+3. **Hosts**: an app (Nuxt, a bare Nitro server, Vite, a Fastify or tRPC server) that supplies identity (`authenticate`), a store and its own chrome. A host calls these entries; it never reaches into `dist/` internals or table names.
+
+### Adapter matrix
+
+| | `json` | `drizzle` | `forge` |
+|---|---|---|---|
+| Documents | `<id>.json` | `editor_documents` | the host's Markdown files |
+| Collaboration state | `<id>.ystate` | `editor_states` | the `state` adapter you pass in |
+| Settings, assets | files under `settings/`, `assets/` | `editor_settings`, `editor_assets` | the `state` adapter |
+| Creates documents (`PUT /api/editor/documents/:id`) | yes | yes | no (the host owns its files) |
+| Default identity | anonymous dev user outside production | same | none: the host supplies `authenticate` |
+| Comment store | `comments/json` | `comments/drizzle` | `comments/json` or `comments/drizzle` |
+| Nodes | one process | SQLite writers of the driver | one process |
+
+All three pass the adapter contract test; both comment stores pass `test/adapters/comment-store.test.ts`. The JSON and forge adapters and the JSON comment store are single-node: no cross-process locking.
+
+### Nitro host and composable
+
+```ts
+// server/plugins/editor.ts (bare Nitro, no Nuxt)
+import { createJsonAdapter } from '@ecsplico/editor/adapters/json'
+import { createJsonCommentStore } from '@ecsplico/editor/comments/json'
+import { installEditorServer } from '@ecsplico/editor/server/nitro'
+import { defineNitroPlugin } from 'nitropack/runtime'
+
+export default defineNitroPlugin((nitroApp) => {
+  installEditorServer(nitroApp, {
+    adapter: createJsonAdapter({ dir: '.data/documents' }),
+    collab: {},                                                   // `false`: no websocket, documents still load and save over HTTP
+    comments: { store: createJsonCommentStore({ file: '.data/comments.json' }) }, // optional
+    // ai: { presets: { … } },                                    // optional: mounts /api/ai/*
+  })
+})
+```
+
+`installEditorServer` is the explicit-wiring twin of the Nuxt module (§2) for hosts without Nuxt; set `experimental: { websocket: true }` in the Nitro config for the collaboration websocket. It mounts, all behind `adapter.authenticate`: the editor's client endpoints (`/api/editor/{settings,users,tags,assets/…,themes/…}`), `GET`/`PUT /api/editor/documents/:id` (a document's TipTap JSON; `PUT` needs an adapter that manages documents), `GET`/`POST /api/editor/comments/:id` (`handleCommentsRequest` over `comments.store`), `/api/ai/*` with `ai`, and `/collab/:id` (the Hocuspocus websocket) unless `collab: false`. The returned object (`adapter`, `collab`, `models`, `close()`) is for tests and shutdown; Nitro's `close` hook already calls it.
+
+```vue
+<script setup lang="ts">
+import { useEditorDocument } from '@ecsplico/editor/adapters/vue'
+import { commentsFeature } from '@ecsplico/editor/comments/vue'
+import { coreFeature, defineEditor } from '@ecsplico/editor/core'
+import { EditorSurface } from '@ecsplico/editor/vue'
+import { ref } from 'vue'
+
+const id = ref('welcome')
+const doc = useEditorDocument(id, { fetch: (url, init) => fetch(url, init), user: { id: 'u1', name: 'Anna', color: '#e11d48' } })
+const preset = defineEditor({ features: [coreFeature(), commentsFeature({ model: () => doc.comments.value })] })
+</script>
+
+<template>
+  <button :disabled="!doc.dirty.value" @click="doc.save()">Save</button>
+  <EditorSurface v-if="doc.ready.value" :key="id" :preset="preset" v-bind="doc.bind.value" />
+</template>
+```
+
+`useEditorDocument(id, options)` loads `GET /api/editor/documents/:id` (a missing document starts empty and is created by the first `save()`) and returns `modelValue`, `ready`, `dirty`, `save()`, `reload()`, `error`, `collaboration`, `comments` (the REST comments model of `/api/editor/comments/:id`), `editor` and `bind` (the surface's props and events). `dirty` ignores the block ids the editor assigns when it mounts content; they are saved with the next edit. With `collaboration: { url, token? }` the Y.Doc is the document: the server loads and stores the content, nothing is fetched or saved by the composable, and `modelValue` stays `undefined`. Mount the surface with `:key="id"` and `v-if="doc.ready.value"`.
+
+Every adapter takes the same hooks: `authenticate({ headers, token })` (the user behind a request or collaboration socket, `null` refuses; default: an anonymous development user outside `NODE_ENV=production`, nobody in production; the forge adapter has no default), `authorize(user, documentId)` (per-document access for collaboration, `{ readOnly } | null`; omitted = every authenticated user edits every document), `schemaExtensions()` (Vue-free TipTap extensions of host-defined nodes for the collaboration schema) and `users()` (who can be `@`-mentioned).
+
+The runnable app is [`examples/vue-nitro-json`](../../../examples/vue-nitro-json): `bun run proto:vue-nitro-json` serves it on port 3046, documents land in `examples/vue-nitro-json/.data/documents/<id>.json`, comments in `examples/vue-nitro-json/.data/comments.json`.

package/docs/llms.md

@@ -35,6 +35,12 @@ Every entry is an explicit subpath of `package.json#exports`; a path that is not
 | ProseMirror schema for a server, validator or migration | `simpleSchemaExtensions` from `.../schema/simple`; `advancedSchemaExtensions` from `.../schema/advanced`; per-feature `.../<name>/schema`; base `coreSchemaExtensions`, `ROOT_ABILITIES`, `BlockId` helpers from `.../core/schema` | framework-free, Node-safe |
 | Nitro side: register the adapter, forget a deleted document | `setEditorAdapter`, `EditorAdapter`, `forgetCollabDocument`, `liveContent`, `collabStats` from `.../server` | Nitro only |
 | Server without Nitro: collab server, AI models, rate limiter, route handlers, websocket listener | `createCollabServer`, `createAiModels`, `createRateLimiter` from `.../server`; `chatPost`, `usersGet`, … and their body schemas from `.../server/handlers`; `listenCollab` from `.../server/node` | any Node process |
+| Store documents as JSON files | `createJsonAdapter({ dir, authenticate?, authorize?, users?, schemaExtensions? })` from `@ecsplico/editor/adapters/json` | Node |
+| Store documents in SQLite via drizzle (optional peer `drizzle-orm`) | `bootstrapEditorTables(db)`, `createDrizzleAdapter({ db, tables: editorTables() })` from `@ecsplico/editor/adapters/drizzle` | Node |
+| Edit a host's Markdown files | `createForgeAdapter({ content, state, schema, authenticate, … })` from `@ecsplico/editor/adapters/forge` | Node |
+| Mount the editor backend on Nitro (no Nuxt module) | `installEditorServer(nitroApp, { adapter, collab: {} \| false, ai?, rateLimit?, comments?: { store } })` from `@ecsplico/editor/server/nitro`, called from one Nitro plugin; needs `experimental: { websocket: true }` for `collab`; peer `h3` | Nitro only |
+| Bind a Vue editor surface to a document | `useEditorDocument(id, { fetch, collaboration?, user?, canComment? })` → `{ modelValue, ready, dirty, save, reload, error, collaboration, comments, editor, bind, dispose }` from `@ecsplico/editor/adapters/vue` | browser (Vue) |
+| Comment threads that survive edits | `captureAnchor`/`resolveAnchor`/`mapAnchor` from `.../anchors`; `createJsonCommentStore({ file })` from `.../comments/json`; `createDrizzleCommentStore({ db, tables: commentTables() })` from `.../comments/drizzle`; `handleCommentsRequest(store, { method, documentId, body })` from `.../comments/server`; `createRestCommentsModel({ fetch, documentId, user, canComment, getEditor })` from `.../comments/client` | `anchors`, `comments/client`: browser (no UI framework); the others: Node |
 | Nuxt module (config key `tiptapEditor`) | `@ecsplico/editor/nuxt` in `modules` | build |
 | CSS | `.../styles/core.css` (required) plus `/media.css`, `/mentions.css`, `/tables.css`, `/authors.css`, `/comments.css`, `/transcript.css`, `/composites.css`, `/ai.css`, `/collab.css`, `/block-ui.css`, `/themes.css` for the features you use | browser |
 
@@ -152,7 +158,7 @@ Advanced list in schema order: `core`, `media`, `transcript`, `composites`, `men
 | `authorsFeature()` (`/authors/vue`, `/authors/react`) | none | none (author comes from the collaboration session `user`) |
 | `collabFeature()` (`/collab/vue`, `/collab/react`) | none | `/collab/:id` websocket; active only when `collaboration` is passed to the surface |
 | `commentsFeature({ model? })` (`/comments/vue`, `/comments/react`) | `collab`, none with `model` | comments live in the Y.Doc, or in the host's `CommentsModel` (`model: getEditor => CommentsModel`) |
-| `compositeFeature({ kinds? })` (`/composites/vue`, `/composites/react`) | none | none (also mounts the composite overlay: status/tag chips on each title line and, on the kind icon, a popover with the type dropdown (warns before `setCompositeKind`, naming the field values that would be lost), the kind's fields and the summary; also read-only: type as text, fields disabled) |
+| `compositeFeature({ kinds? })` (`/composites/vue`, `/composites/react`) | none | none (also mounts the composite overlay: status/tag chips on each title line and, on the kind icon, a popover with the type dropdown (warns before `setCompositeKind`, naming the field values that would be lost), the kind's fields and the summary; also read-only: type as text, fields disabled; enforces the kinds' accepted children, `CompositeKind.accepts`: an edit that nests a Baustein into one that does not accept its kind is refused with the notice `composites.nesting.title` („Verschachtelung nicht möglich“)) |
 | `aiFeature()` (`/ai/vue`, `/ai/react`; framework-free `aiFeatureCore` in `/ai`) | none | `/api/ai/{models,generate,chat,complete}` |
 | `blockUiFeature()` (`/block-ui/vue`, `/block-ui/react`) | none | none (drag handle, hover actions) |
 | `themesFeature()` (`/themes/vue`, `/themes/react`) | none | adapter `listThemes`/`loadTheme` |
@@ -342,6 +348,7 @@ Complete worked example with node, node view, conversions and AI description: [e
 - **Settings keys.** Only keys of `EditorSettings` persist; unknown ones are dropped on read and write.
 - **Design tokens.** `@ecsplico/editor/styles/tokens.css` declares the shared `--sk-*` variables (`--sk-bg`, `--sk-fg`, `--sk-muted`, `--sk-border`, `--sk-primary`, `--sk-primary-fg`, `--sk-success`, `--sk-warning`, `--sk-danger`, `--sk-radius`, `--sk-font`) under `:where(:root)` (dark values under `:where(.dark)`). Later UI work in this package reads `--sk-*`; map them once in the host.
 - **Module order.** `@nuxt/ui` before `@ecsplico/editor/nuxt` in `modules`.
+- **Adapters tier.** Entries under `adapters/`, `anchors`, `comments/{server,json,drizzle,client}` and `server/nitro` supply storage and wiring; they import no application code. Vue is reachable only from `./adapters/vue`, Nitro (`h3`) only from `./server/nitro`, `drizzle-orm` only from the two drizzle entries, React from none; `./adapters` is types only. `./adapters/react`, `./server/nest` and `./adapters/prisma` are reserved and not exported. The Nitro host and `useEditorDocument` speak one wire contract: `GET`/`PUT /api/editor/documents/:id` (TipTap JSON, 404 = missing, `PUT` 204 and only for adapters that manage documents), `GET`/`POST /api/editor/comments/:id` (`handleCommentsRequest`, which trusts its caller), `/collab/:id` (Hocuspocus; `collaboration.url` is `ws://host/collab`). Every route authenticates through `adapter.authenticate({ headers, token })`; `null` answers 401; the default outside production is an anonymous dev user, in production nobody. The JSON and forge adapters and the JSON comment store are single-node. Mount the surface with `:key="id"` and `v-if="doc.ready.value"`, bind with `v-bind="doc.bind.value"`. Runnable reference: `examples/vue-nitro-json` (`bun run proto:vue-nitro-json`, port 3046).
 
 ## Verify
 
@@ -353,6 +360,7 @@ bun run typecheck:editor                      # vue-tsc --noEmit -p packages/edi
 bun run build:editor                          # tsdown: packages/editor/dist (ESM + .d.ts per export)
 bun run check:editor-entries                  # builds the editor, then one production build per fixture + module-graph isolation, then the schema snapshot
 bun run check:editor-composition              # defineEditor rejects missing `requires`; accepted compositions; one formatAiResult
+bun run test:editor                           # bun test: inspector model, AI selection flow, surface session on a mounted editor (happy-dom)
 bun run typecheck                             # nuxt typecheck of the demo app
 bun run --cwd examples/vue-simple typecheck   # plain Vue consumer
 bun run --cwd examples/react-simple typecheck # plain React consumer

package/docs/usage.md

@@ -565,6 +565,7 @@ On React the same list comes from `/authors/react`, `/collab/react` and `/commen
 - Select text and choose „Kommentar“ in the selection bubble; others reply, anyone resolves or reopens a thread („Erledigt“ threads lose their highlight), authors edit or delete their own comments. A thread whose text was deleted stays as orphan („Textstelle gelöscht“). Threads live in the Y.Doc map `comments` (`createCommentsModel(getEditor)` is the framework-free model; `useComments(editor)` is the thin Vue hook, returning the `CommentsStore`, and the React binding has the same hook), the range is the `comment` mark (the schema mark is always registered, so stored marks round-trip even without the feature's UI).
 - `editing.commentsLayout` (`'margin'` default, `'inline'`) is a per-user setting in the „Kommentare“ settings tab:
   - `margin` („Randspalte“): cards beside the commented text. The host places `CommentsMargin` (props `editor`, `container`, `open`) inside the editor's scroll container (`relative flex`, editor wrapper `min-w-0 flex-1`) and binds `v-model:comments-open` on the surface (React: `commentsOpen`/`onCommentsOpenChange`). The toolbar's „Kommentare“ button and `Mod-Shift-m` toggle it; opening it closes the AI sidebar and vice versa.
+  - Layout „Aktiver Faden“: the active thread (or the draft composer) is pinned exactly to the top of its text's line and shows in full; every other open thread is a one-line card (author, excerpt, reply count) that moves up or down out of its way, as close to its own line as its neighbours allow, never overlapping. Without an active thread the cards stack top-down at their lines. A click on a card activates it and reveals its text. Resolved threads are hidden behind the „Erledigt (n)“ toggle at the bottom of the column. A thread whose text was deleted stays as a greyed-out card at the deletion point, labelled „Text gelöscht“ (its position comes from the thread's anchor, a Yjs relative position kept in the Y.Map; a thread without one goes to the end); undoing the deletion attaches it to its text again. The rule is framework-free and testable on its own: `layoutMargin(entries, activeId, { gap, minTop })` maps measured cards (`MarginEntry`: id, line top or `null`, height) to tops, `marginCards(...)` builds the cards in document order, and `createMarginController(source)` does the measuring (`coordsAtPos`, card heights, one layout per animation frame); both `CommentsMargin` components only render it (all from `@ecsplico/editor/comments`).
   - `inline`: `CommentsPopover` (mounted by the feature as an overlay) opens at the commented text; the toolbar's `CommentsListMenu` lists all threads with the open count. Esc closes the popover.
 - Without collaboration the toolbar button is disabled with an explanation. Switching the layout closes any open thread or draft.
 
@@ -692,6 +693,8 @@ On React the feature is `compositeFeature()` from `@ecsplico/editor/composites/r
 
 Kinds are data. `compositeFeature({ kinds })` replaces the built-in `defaultCompositeKinds(ctx.t)` (section, task, ...; labelled in the context's language); a kind has `id`, `label`, `icon`, `titlePlaceholder`, `descriptionPlaceholder` and `fields` (`text`, `textarea`, `date`, `number`, `select`). `compositeKindsOf(editor)` returns the editor's own list and an unknown `kind` id falls back to the `section` presentation under its own label.
 
+**Accepted children.** `CompositeKind.accepts?: readonly string[] | 'all'` names the Baustein kinds a kind accepts as nested Bausteine: a list of kind ids, or `'all'`. Without `accepts`, `folder` and `document` accept `'all'` and every other kind accepts none; the built-in `section` sets `'all'`, `task` and `note` accept no Baustein. Paragraphs, lists and other non-Baustein content are always allowed, and top-level Bausteine have no parent. `kindAccepts(kinds, parentKind, childKind)` answers the question for a kinds list (a parent kind the list does not know accepts nothing, `folder` and `document` aside). The rule is enforced in the editor by the `AcceptedChildren` extension, which `compositeFeature()` registers: every local edit that leaves the document with more Bausteine nested in a Baustein that does not accept their kind than before is refused — block drag, „In Baustein umwandeln“, the kind switch of the details popover, paste, AI inserts and review acceptance, `moveBlockInto` — and the user gets the notice „Verschachtelung nicht möglich“ with „<Kind> nimmt keine <Kind> auf.“ (kind labels, e.g. „Notiz nimmt keine Aufgabe auf.“). Only *new* violations are refused: a document that already nests against the rule stays as it is and can still be edited, and collaboration replays, undo/redo and loading a whole document are never blocked. The document tree applies the same rule to drops ([File browser](#file-browser)).
+
 ### Chips and details popover
 
 The feature mounts one overlay (`CompositeChrome`) beside the editor, so every composite looks the same in every host:
@@ -746,7 +749,7 @@ It also exports the pure helpers: `defaultCompositeKinds`, `compositeKind`, `com
 
 ### Outline and Markdown export helpers
 
-- `compositeOutline(doc, hiddenKinds)` reads the document as a tree of composites (`OutlineNode`: key, id, position, kind, title, summary flag, children); composites of a hidden kind drop out and their descendants move up. `canMoveBlockInto(editor, id, targetId)` and `moveBlockInto(editor, id, targetId)` move a block to the end of a composite's body (or the document with `null`) in one transaction.
+- `compositeOutline(doc, hiddenKinds)` reads the document as a tree of composites (`OutlineNode`: key, id, position, kind, title, summary flag, children); composites of a hidden kind drop out and their descendants move up. `moveIntoVerdict(editor, id, targetId, t)` says whether block `id` may move into the composite `targetId` (`null` = the end of the document): a `MoveVerdict`, `{ ok: true }` or `{ ok: false, reason }` with a short sentence in the language of `t` (the editor's translator) (the block or the target no longer exists, the target is no Baustein, a block into itself or into a Baustein it contains, or the target's kind does not accept the block's kind, see *Accepted children*). A block that is no Baustein may move into any Baustein unless it holds Bausteine of a refused kind; moving a block to the end of the Baustein it already sits in is never refused. `canMoveBlockInto(editor, id, targetId)` is `moveIntoVerdict(...).ok`. `moveBlockInto(editor, id, targetId)` moves the block to the end of a composite's body (or the document with `null`) in one transaction and returns whether the document changed (`false`: refused by the verdict or by the editor).
 - `headingsMarkdown(editor, blocks, level)` exports blocks as Markdown with every composite turned into a heading (the outermost at `level`) followed by its description, tags and body; `documentCompositeMarkdown(editor, node)` does the same for one composite as a document, `markdownFileName(node)` names the file and `downloadText(filename, text)` offers it as a download.
 
 The heading-only outline of a plain editor stays `@ecsplico/editor/outline` (`headingOutline`, `revealBlockInEditor`); its component is `EditorOutline` from `/outline/vue` or `/outline/react`.
@@ -944,16 +947,16 @@ The model proposes edits through the `edit_document` tool. The server checks the
 
 | Type | Fields | Effect |
 |---|---|---|
-| `add` | `afterId: string \| null`, `markdown` | Insert block(s) after `afterId` (in the document or its composite body). `null` = document start, not allowed with a selection scope. |
+| `add` | `afterId: string \| null` (required), `markdown` | Insert block(s) after `afterId` (in the document or its composite body). `afterId` must be present: an explicit `null` is the document start (not allowed with a selection scope, where `afterId` must be a selected block); a forgotten key is rejected, it never becomes the start. Several `add`s after the same block are fine and keep the order of the answer. |
 | `update` | `id`, `markdown` | Replace block `id`. A single paragraph, or one block of the same type and attributes, is diffed within the block. On a composite, a `::: kind` fence (exactly one composite) replaces the whole composite; unfenced markdown replaces only its body. |
 | `delete` | `id` | Remove the block (or the smallest list item, list or quote that would be invalid without it). |
 | `convert` | `id`, `to` | Change the block type, keeping the content. `to` is one of the request's `targets`: the targets the installed conversion providers advertise (`paragraph`, `heading1`–`heading3`, `bulletList`, `orderedList`, `blockquote`, `codeBlock`, plus `transcriptSegment` and `composite:<kind>` with those features). |
 
-Validation problems (`AgentOpProblemReason`): `unknown` (the id isn't in the document), `scope` (the id is outside the selection), `field` (a field is missing or invalid, e.g. empty `markdown` or more than `AGENT_LIMITS.markdown` = 8000 characters), `duplicate` (the same block is updated, converted or deleted twice), `limit` (more than `AGENT_LIMITS.ops` = 50 operations), `target` (`to` isn't among the request's `targets`). On problems the model is asked to retry, up to `AGENT_LIMITS.retries` = 2 times. Whatever is still invalid after that, or left out of a corrected list, is reported in `dropped`.
+Validation problems (`AgentOpProblemReason`): `unknown` (the id isn't in the document), `scope` (the id is outside the selection, or an `add` at the document start with a selection scope), `field` (a field is missing or invalid, e.g. empty `markdown`, more than `AGENT_LIMITS.markdown` = 8000 characters, or an `add` without its `afterId` key), `duplicate` (the same block is updated, converted or deleted twice), `limit` (more than `AGENT_LIMITS.ops` = 50 operations), `target` (`to` isn't among the request's `targets`), `inside` (an operation on a block *inside* a block that another operation of the same list replaces (`update`) or deletes: the operation on the outer block wins; to change the inner block too, put the change into the outer `markdown`). Which blocks lie inside which is read from the indentation of the document text (`readBlockLines`). On problems the model is asked to retry (the retry text lists each problem and says that for `inside` the outer operation applies), up to `AGENT_LIMITS.retries` = 2 times. Whatever is still invalid after that, or left out of a corrected list, is reported in `dropped`.
 
-**Review flow.** The client re-checks each operation against the scope the request was sent with and shows valid ones as in-document review changes the user accepts or rejects. An operation that can't be shown gets an outcome instead: `blocked`, `missing`, `unchanged`, `overlap` or `empty`. Every operation's outcome (`accepted`, `rejected`, `partial`, `invalid`, `pending`, …) is sent back as `feedback` with the next user message.
+**Review flow.** The client re-checks each operation against the scope the request was sent with and shows valid ones as in-document review changes the user accepts or rejects. An operation that can't be shown gets an outcome instead: `blocked` (outside the scope), `stale` (its block was deleted in the browser while the model was answering; „Block gelöscht“ in the chat), `missing`, `unchanged`, `overlap` or `empty` (`AGENT_OP_OUTCOMES`). Every operation's outcome (`accepted`, `rejected`, `partial`, `invalid`, `pending`, …) is sent back as `feedback` with the next user message; the model reads it as „Entscheidungen zu deinen letzten Vorschlägen: op1 (update Block X) nicht angezeigt: Block wurde inzwischen gelöscht; …“ (`agentFeedbackText`).
 
-**Document text** (`documentChatText(editor)`): one line per block, `[<id>] <markdown on one line>`. List and quote markers form the prefix (`- `, `1. `, `> `). A composite is a header line `[<id>] ::: kind {meta} | Title | Description | Tags: #a #b` (meta only when non-empty, empty parts omitted), followed by its body lines indented by two spaces and a closing line `  :::` without an id. The text is truncated at `CHAT_LIMITS.document` = 120000 characters.
+**Document text** (`documentChatText(editor)`): one line per block, `[<id>] <markdown on one line>`. List and quote markers form the prefix (`- `, `1. `, `> `). A composite is a header line `[<id>] ::: kind {meta} | Title | Description | Tags: #a #b` (meta only when non-empty, empty parts omitted), followed by its body lines indented by two spaces and a closing line `  :::` without an id. A code block keeps its own lines: the first carries the id, the others start at the left edge. The text is truncated at `CHAT_LIMITS.document` = 120000 characters (the notice is `TRUNCATED_LINE`). The format has one owner, `block-lines` of `@ecsplico/editor/ai/protocol`: the writer helpers (`blockLine`, `compositeLineHeader`, …), `readBlockLines(text)` (the ids and which blocks lie inside which; lines inside fenced code are code, never block ids, so a code line like `[ghost] text` does not become one), `stripBlockLineEcho` / `stripListMarkerEcho` (remove a `[<id>] ` or list/quote marker prefix the model echoes into its Markdown) and the prompt texts (`BLOCK_LINE_INTRO`, `BLOCK_LINE_IDS_HINT`, …). The browser writes the text and the server reads it with the same module.
 
 ### Composite Markdown fence format
 
@@ -1033,6 +1036,8 @@ export function Drawer({ store, editor }: { store: DocumentStore, editor: Editor
 - `editor` is the open page's editor (`undefined` when no document is open); take it from your page through a shared composable, as `useActiveEditor()` does in the Nuxt app.
 - `v-model:selectedFolder` (React: `selectedFolder` / `onSelectedFolderChange`, uncontrolled when omitted) is where new documents, new folders and your own import actions go. Bind the same state in your import button (the Nuxt app binds it in the layout and passes it to `AppDocumentTree`). The Vue `document-actions` slot is `documentActions` on React.
 - Place `DocumentTree` anywhere (a sidebar, a drawer); several can coexist, sharing one filter state per app (`useTreeView()` from `/tree/vue` returns the refs `nodeFilters` and `expanded`, from `/tree/react` the plain values, both with the framework-free `model`).
+- **Title filter.** The field „Titel filtern“ above the tree (clear button, `Esc` clears too) filters by title, case-insensitive substring, over folders, documents and the outline entries: only matching rows and their parents stay, the matching part is highlighted, and „Keine Treffer“ shows when nothing matches. While the filter is set the parents of matches are shown open without touching the stored open state; clearing the filter restores the rows that were open before (a row opened or closed by hand meanwhile counts only until then). The title filter belongs to one tree; the kind filters are the shared per-app state.
+- **Refused drops.** While a drag hovers a row, the tree asks whether that drop is allowed (`dropVerdict`, with a reason in the editor's language). An allowed target gets a primary outline and takes the drop; a refused one is outlined red, shows the reason under the row („Notiz nimmt keine Aufgabe auf.“, „Ein Ordner lässt sich nicht in sich selbst oder einen seiner Unterordner verschieben.“, …) and the browser shows „not allowed“. Moving a Baustein is judged by the open document's editor (`moveIntoVerdict`, so the kinds' accepted children apply); documents and folders follow the folder rules of the `DocumentStore` contract. Both components render one framework-free model (`createTreeModel`, internal, not exported from `./tree`); the props of `DocumentTree` are unchanged.
 - The outline entries under the open document follow the settings: composites in the preferred structure (a *virtual root* when `blocks.treeRoot` is `'file'`), headings otherwise.
 
 The full `DocumentStore` contract (loading states, mutation refresh, delete with undo, folder rules, name validation, who reports failures) and the runnable implementation are in the [integration guide](./integration.md#10-the-file-browser-and-documentstore); the host implementation is [`app/composables/useDocumentStore.ts`](../../../app/composables/useDocumentStore.ts).

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@ecsplico/editor",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "type": "module",
   "description": "Vue and React editor library on TipTap v3 (Vue: Nuxt UI; React: shadcn/ui): framework-free features with Vue and React bindings, simple and advanced presets, tree-shakeable entries. Built ESM with type declarations.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/skaile-ai/editor.git",
+    "url": "git+https://github.com/skaile-ai/skaile-editor.git",
     "directory": "packages/editor"
   },
-  "homepage": "https://github.com/skaile-ai/editor/tree/main/packages/editor#readme",
-  "bugs": "https://github.com/skaile-ai/editor/issues",
+  "homepage": "https://github.com/skaile-ai/skaile-editor/tree/main/packages/editor#readme",
+  "bugs": "https://github.com/skaile-ai/skaile-editor/issues",
   "files": [
     "dist",
     "docs",
@@ -295,6 +295,56 @@
       "types": "./dist/features/comments/schema.d.ts",
       "import": "./dist/features/comments/schema.js"
     },
+    "./adapters": {
+      "skaile-source": "./src/adapters/index.ts",
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js"
+    },
+    "./adapters/json": {
+      "skaile-source": "./src/adapters/json.ts",
+      "types": "./dist/adapters/json.d.ts",
+      "import": "./dist/adapters/json.js"
+    },
+    "./adapters/drizzle": {
+      "skaile-source": "./src/adapters/drizzle.ts",
+      "types": "./dist/adapters/drizzle.d.ts",
+      "import": "./dist/adapters/drizzle.js"
+    },
+    "./adapters/forge": {
+      "skaile-source": "./src/adapters/forge.ts",
+      "types": "./dist/adapters/forge.d.ts",
+      "import": "./dist/adapters/forge.js"
+    },
+    "./adapters/vue": {
+      "skaile-source": "./src/adapters/vue.ts",
+      "types": "./dist/adapters/vue.d.ts",
+      "import": "./dist/adapters/vue.js"
+    },
+    "./anchors": {
+      "skaile-source": "./src/adapters/anchors.ts",
+      "types": "./dist/adapters/anchors.d.ts",
+      "import": "./dist/adapters/anchors.js"
+    },
+    "./comments/server": {
+      "skaile-source": "./src/adapters/comments/server.ts",
+      "types": "./dist/adapters/comments/server.d.ts",
+      "import": "./dist/adapters/comments/server.js"
+    },
+    "./comments/json": {
+      "skaile-source": "./src/adapters/comments/json.ts",
+      "types": "./dist/adapters/comments/json.d.ts",
+      "import": "./dist/adapters/comments/json.js"
+    },
+    "./comments/drizzle": {
+      "skaile-source": "./src/adapters/comments/drizzle.ts",
+      "types": "./dist/adapters/comments/drizzle.d.ts",
+      "import": "./dist/adapters/comments/drizzle.js"
+    },
+    "./comments/client": {
+      "skaile-source": "./src/adapters/comments/client.ts",
+      "types": "./dist/adapters/comments/client.d.ts",
+      "import": "./dist/adapters/comments/client.js"
+    },
     "./transcript": {
       "skaile-source": "./src/features/transcript/index.ts",
       "types": "./dist/features/transcript/index.d.ts",
@@ -420,6 +470,11 @@
       "types": "./dist/server/node.d.ts",
       "import": "./dist/server/node.js"
     },
+    "./server/nitro": {
+      "skaile-source": "./src/adapters/nitro.ts",
+      "types": "./dist/adapters/nitro.d.ts",
+      "import": "./dist/adapters/nitro.js"
+    },
     "./nuxt": {
       "skaile-source": "./src/nuxt/module.ts",
       "types": "./dist/nuxt/module.d.ts",
@@ -497,6 +552,7 @@
     "@tiptap/pm": "^3.31.3",
     "@tiptap/react": "^3.31.3",
     "@tiptap/vue-3": "^3.31.3",
+    "drizzle-orm": "^0.45.0",
     "h3": "^1.15.0",
     "nitropack": "^2.13.0",
     "nuxt": "^4.5.2",
@@ -554,8 +610,10 @@
     "@tiptap/react": "3.31.3",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
+    "@types/ws": "^8.18.2",
     "@vitejs/plugin-react": "^6.1.2",
     "@vitejs/plugin-vue": "^6.0.9",
+    "drizzle-orm": "^0.45.4",
     "h3": "^1.15.11",
     "nitropack": "^2.13.4",
     "react": "^19.3.0",
@@ -563,7 +621,8 @@
     "tailwindcss": "^4.3.3",
     "tsdown": "^0.23.1",
     "unplugin-vue": "^8.0.0",
-    "vite": "^8.3.1"
+    "vite": "^8.3.1",
+    "ws": "^8.18.3"
   },
   "peerDependenciesMeta": {
     "@iconify/react": {
@@ -581,6 +640,9 @@
     "@tiptap/vue-3": {
       "optional": true
     },
+    "drizzle-orm": {
+      "optional": true
+    },
     "h3": {
       "optional": true
     },