@ecsplico/editor 2.1.1 → 3.0.0

package/dist/react/simple.d.ts

@@ -1,2 +1,2 @@
-import { SimpleEditor, SimpleEditorProps } from "./SimpleEditor.js";
-export { SimpleEditor, type SimpleEditorProps };
+import { SimpleEditor, SimpleEditorHandle, SimpleEditorProps } from "./SimpleEditor.js";
+export { SimpleEditor, type SimpleEditorHandle, type SimpleEditorProps };

package/dist/react/ui/command.js

@@ -1,4 +1,5 @@
 import { cn } from "./utils.js";
+import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle } from "./dialog.js";
 import { InputGroup, InputGroupAddon } from "./input-group.js";
 import "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -12,6 +13,19 @@ function Command$1({ className, ...props }) {
 		...props
 	});
 }
+function CommandDialog({ title = "Command Palette", description = "Search for a command to run...", children, className, showCloseButton = false, ...props }) {
+	return /* @__PURE__ */ jsxs(Dialog, {
+		...props,
+		children: [/* @__PURE__ */ jsxs(DialogHeader, {
+			className: "sr-only",
+			children: [/* @__PURE__ */ jsx(DialogTitle, { children: title }), /* @__PURE__ */ jsx(DialogDescription, { children: description })]
+		}), /* @__PURE__ */ jsx(DialogContent, {
+			className: cn("top-1/3 translate-y-0 overflow-hidden rounded-xl! p-0", className),
+			showCloseButton,
+			children
+		})]
+	});
+}
 function CommandInput({ className, ...props }) {
 	return /* @__PURE__ */ jsx("div", {
 		"data-slot": "command-input-wrapper",
@@ -33,6 +47,20 @@ function CommandList({ className, ...props }) {
 		...props
 	});
 }
+function CommandEmpty({ className, ...props }) {
+	return /* @__PURE__ */ jsx(Command.Empty, {
+		"data-slot": "command-empty",
+		className: cn("py-6 text-center text-sm", className),
+		...props
+	});
+}
+function CommandGroup({ className, ...props }) {
+	return /* @__PURE__ */ jsx(Command.Group, {
+		"data-slot": "command-group",
+		className: cn("overflow-hidden p-1 text-foreground **:[[cmdk-group-heading]]:px-2 **:[[cmdk-group-heading]]:py-1.5 **:[[cmdk-group-heading]]:text-xs **:[[cmdk-group-heading]]:font-medium **:[[cmdk-group-heading]]:text-muted-foreground", className),
+		...props
+	});
+}
 function CommandItem({ className, children, ...props }) {
 	return /* @__PURE__ */ jsxs(Command.Item, {
 		"data-slot": "command-item",
@@ -41,7 +69,14 @@ function CommandItem({ className, children, ...props }) {
 		children: [children, /* @__PURE__ */ jsx(CheckIcon, { className: "ml-auto opacity-0 group-has-data-[slot=command-shortcut]/command-item:hidden group-data-[checked=true]/command-item:opacity-100" })]
 	});
 }
+function CommandShortcut({ className, ...props }) {
+	return /* @__PURE__ */ jsx("span", {
+		"data-slot": "command-shortcut",
+		className: cn("ml-auto text-xs tracking-widest text-muted-foreground group-data-selected/command-item:text-foreground", className),
+		...props
+	});
+}
 //#endregion
-export { Command$1 as Command, CommandInput, CommandItem, CommandList };
+export { Command$1 as Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandShortcut };
 
 //# sourceMappingURL=command.js.map

package/dist/react/ui/command.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.js","names":["Command","CommandPrimitive"],"sources":["../../../src/react/ui/command.tsx"],"sourcesContent":["import * as React from \"react\"\nimport { Command as CommandPrimitive } from \"cmdk\"\nimport { cn } from \"./utils\"\n\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogHeader,\n  DialogTitle,\n} from \"./dialog\"\nimport {\n  InputGroup,\n  InputGroupAddon,\n} from \"./input-group\"\nimport { SearchIcon, CheckIcon } from \"lucide-react\"\n\nfunction Command({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive>) {\n  return (\n    <CommandPrimitive\n      data-slot=\"command\"\n      className={cn(\n        \"flex size-full flex-col overflow-hidden rounded-xl! bg-popover p-1 text-popover-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CommandDialog({\n  title = \"Command Palette\",\n  description = \"Search for a command to run...\",\n  children,\n  className,\n  showCloseButton = false,\n  ...props\n}: React.ComponentProps<typeof Dialog> & {\n  title?: string\n  description?: string\n  className?: string\n  showCloseButton?: boolean\n}) {\n  return (\n    <Dialog {...props}>\n      <DialogHeader className=\"sr-only\">\n        <DialogTitle>{title}</DialogTitle>\n        <DialogDescription>{description}</DialogDescription>\n      </DialogHeader>\n      <DialogContent\n        className={cn(\n          \"top-1/3 translate-y-0 overflow-hidden rounded-xl! p-0\",\n          className\n        )}\n        showCloseButton={showCloseButton}\n      >\n        {children}\n      </DialogContent>\n    </Dialog>\n  )\n}\n\nfunction CommandInput({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Input>) {\n  return (\n    <div data-slot=\"command-input-wrapper\" className=\"p-1 pb-0\">\n      <InputGroup className=\"h-8! rounded-lg! border-input/30 bg-input/30 shadow-none! *:data-[slot=input-group-addon]:pl-2!\">\n        <CommandPrimitive.Input\n          data-slot=\"command-input\"\n          className={cn(\n            \"w-full text-sm outline-hidden disabled:cursor-not-allowed disabled:opacity-50\",\n            className\n          )}\n          {...props}\n        />\n        <InputGroupAddon>\n          <SearchIcon className=\"size-4 shrink-0 opacity-50\" />\n        </InputGroupAddon>\n      </InputGroup>\n    </div>\n  )\n}\n\nfunction CommandList({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.List>) {\n  return (\n    <CommandPrimitive.List\n      data-slot=\"command-list\"\n      className={cn(\n        \"no-scrollbar max-h-72 scroll-py-1 overflow-x-hidden overflow-y-auto outline-none\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CommandEmpty({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Empty>) {\n  return (\n    <CommandPrimitive.Empty\n      data-slot=\"command-empty\"\n      className={cn(\"py-6 text-center text-sm\", className)}\n      {...props}\n    />\n  )\n}\n\nfunction CommandGroup({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Group>) {\n  return (\n    <CommandPrimitive.Group\n      data-slot=\"command-group\"\n      className={cn(\n        \"overflow-hidden p-1 text-foreground **:[[cmdk-group-heading]]:px-2 **:[[cmdk-group-heading]]:py-1.5 **:[[cmdk-group-heading]]:text-xs **:[[cmdk-group-heading]]:font-medium **:[[cmdk-group-heading]]:text-muted-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CommandSeparator({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Separator>) {\n  return (\n    <CommandPrimitive.Separator\n      data-slot=\"command-separator\"\n      className={cn(\"-mx-1 h-px bg-border\", className)}\n      {...props}\n    />\n  )\n}\n\nfunction CommandItem({\n  className,\n  children,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Item>) {\n  return (\n    <CommandPrimitive.Item\n      data-slot=\"command-item\"\n      className={cn(\n        \"group/command-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none in-data-[slot=dialog-content]:rounded-lg! data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 data-selected:bg-muted data-selected:text-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-selected:*:[svg]:text-foreground\",\n        className\n      )}\n      {...props}\n    >\n      {children}\n      <CheckIcon className=\"ml-auto opacity-0 group-has-data-[slot=command-shortcut]/command-item:hidden group-data-[checked=true]/command-item:opacity-100\" />\n    </CommandPrimitive.Item>\n  )\n}\n\nfunction CommandShortcut({\n  className,\n  ...props\n}: React.ComponentProps<\"span\">) {\n  return (\n    <span\n      data-slot=\"command-shortcut\"\n      className={cn(\n        \"ml-auto text-xs tracking-widest text-muted-foreground group-data-selected/command-item:text-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nexport {\n  Command,\n  CommandDialog,\n  CommandInput,\n  CommandList,\n  CommandEmpty,\n  CommandGroup,\n  CommandItem,\n  CommandShortcut,\n  CommandSeparator,\n}\n"],"mappings":";;;;;;;AAiBA,SAASA,UAAQ,EACf,WACA,GAAG,SAC6C;CAChD,OACE,oBAACC,SAAD;EACE,aAAU;EACV,WAAW,GACT,8FACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;AAkCA,SAAS,aAAa,EACpB,WACA,GAAG,SACmD;CACtD,OACE,oBAAC,OAAD;EAAK,aAAU;EAAwB,WAAU;EAC/C,UAAA,qBAAC,YAAD;GAAY,WAAU;GAAtB,UAAA,CACE,oBAACA,QAAiB,OAAlB;IACE,aAAU;IACV,WAAW,GACT,iFACA,SACF;IACA,GAAI;GACL,CAAA,GACD,oBAAC,iBAAD,EAAA,UACE,oBAAC,YAAD,EAAY,WAAU,6BAA8B,CAAA,EACrC,CAAA,CACP;;CACT,CAAA;AAET;AAEA,SAAS,YAAY,EACnB,WACA,GAAG,SACkD;CACrD,OACE,oBAACA,QAAiB,MAAlB;EACE,aAAU;EACV,WAAW,GACT,oFACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;AA4CA,SAAS,YAAY,EACnB,WACA,UACA,GAAG,SACkD;CACrD,OACE,qBAACA,QAAiB,MAAlB;EACE,aAAU;EACV,WAAW,GACT,gaACA,SACF;EACA,GAAI;EANN,UAAA,CAQG,UACD,oBAAC,WAAD,EAAW,WAAU,kIAAmI,CAAA,CACnI;;AAE3B"}
+{"version":3,"file":"command.js","names":["Command","CommandPrimitive"],"sources":["../../../src/react/ui/command.tsx"],"sourcesContent":["import * as React from \"react\"\nimport { Command as CommandPrimitive } from \"cmdk\"\nimport { cn } from \"./utils\"\n\nimport {\n  Dialog,\n  DialogContent,\n  DialogDescription,\n  DialogHeader,\n  DialogTitle,\n} from \"./dialog\"\nimport {\n  InputGroup,\n  InputGroupAddon,\n} from \"./input-group\"\nimport { SearchIcon, CheckIcon } from \"lucide-react\"\n\nfunction Command({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive>) {\n  return (\n    <CommandPrimitive\n      data-slot=\"command\"\n      className={cn(\n        \"flex size-full flex-col overflow-hidden rounded-xl! bg-popover p-1 text-popover-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CommandDialog({\n  title = \"Command Palette\",\n  description = \"Search for a command to run...\",\n  children,\n  className,\n  showCloseButton = false,\n  ...props\n}: React.ComponentProps<typeof Dialog> & {\n  title?: string\n  description?: string\n  className?: string\n  showCloseButton?: boolean\n}) {\n  return (\n    <Dialog {...props}>\n      <DialogHeader className=\"sr-only\">\n        <DialogTitle>{title}</DialogTitle>\n        <DialogDescription>{description}</DialogDescription>\n      </DialogHeader>\n      <DialogContent\n        className={cn(\n          \"top-1/3 translate-y-0 overflow-hidden rounded-xl! p-0\",\n          className\n        )}\n        showCloseButton={showCloseButton}\n      >\n        {children}\n      </DialogContent>\n    </Dialog>\n  )\n}\n\nfunction CommandInput({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Input>) {\n  return (\n    <div data-slot=\"command-input-wrapper\" className=\"p-1 pb-0\">\n      <InputGroup className=\"h-8! rounded-lg! border-input/30 bg-input/30 shadow-none! *:data-[slot=input-group-addon]:pl-2!\">\n        <CommandPrimitive.Input\n          data-slot=\"command-input\"\n          className={cn(\n            \"w-full text-sm outline-hidden disabled:cursor-not-allowed disabled:opacity-50\",\n            className\n          )}\n          {...props}\n        />\n        <InputGroupAddon>\n          <SearchIcon className=\"size-4 shrink-0 opacity-50\" />\n        </InputGroupAddon>\n      </InputGroup>\n    </div>\n  )\n}\n\nfunction CommandList({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.List>) {\n  return (\n    <CommandPrimitive.List\n      data-slot=\"command-list\"\n      className={cn(\n        \"no-scrollbar max-h-72 scroll-py-1 overflow-x-hidden overflow-y-auto outline-none\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CommandEmpty({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Empty>) {\n  return (\n    <CommandPrimitive.Empty\n      data-slot=\"command-empty\"\n      className={cn(\"py-6 text-center text-sm\", className)}\n      {...props}\n    />\n  )\n}\n\nfunction CommandGroup({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Group>) {\n  return (\n    <CommandPrimitive.Group\n      data-slot=\"command-group\"\n      className={cn(\n        \"overflow-hidden p-1 text-foreground **:[[cmdk-group-heading]]:px-2 **:[[cmdk-group-heading]]:py-1.5 **:[[cmdk-group-heading]]:text-xs **:[[cmdk-group-heading]]:font-medium **:[[cmdk-group-heading]]:text-muted-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nfunction CommandSeparator({\n  className,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Separator>) {\n  return (\n    <CommandPrimitive.Separator\n      data-slot=\"command-separator\"\n      className={cn(\"-mx-1 h-px bg-border\", className)}\n      {...props}\n    />\n  )\n}\n\nfunction CommandItem({\n  className,\n  children,\n  ...props\n}: React.ComponentProps<typeof CommandPrimitive.Item>) {\n  return (\n    <CommandPrimitive.Item\n      data-slot=\"command-item\"\n      className={cn(\n        \"group/command-item relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden select-none in-data-[slot=dialog-content]:rounded-lg! data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 data-selected:bg-muted data-selected:text-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 data-selected:*:[svg]:text-foreground\",\n        className\n      )}\n      {...props}\n    >\n      {children}\n      <CheckIcon className=\"ml-auto opacity-0 group-has-data-[slot=command-shortcut]/command-item:hidden group-data-[checked=true]/command-item:opacity-100\" />\n    </CommandPrimitive.Item>\n  )\n}\n\nfunction CommandShortcut({\n  className,\n  ...props\n}: React.ComponentProps<\"span\">) {\n  return (\n    <span\n      data-slot=\"command-shortcut\"\n      className={cn(\n        \"ml-auto text-xs tracking-widest text-muted-foreground group-data-selected/command-item:text-foreground\",\n        className\n      )}\n      {...props}\n    />\n  )\n}\n\nexport {\n  Command,\n  CommandDialog,\n  CommandInput,\n  CommandList,\n  CommandEmpty,\n  CommandGroup,\n  CommandItem,\n  CommandShortcut,\n  CommandSeparator,\n}\n"],"mappings":";;;;;;;;AAiBA,SAASA,UAAQ,EACf,WACA,GAAG,SAC6C;CAChD,OACE,oBAACC,SAAD;EACE,aAAU;EACV,WAAW,GACT,8FACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;AAEA,SAAS,cAAc,EACrB,QAAQ,mBACR,cAAc,kCACd,UACA,WACA,kBAAkB,OAClB,GAAG,SAMF;CACD,OACE,qBAAC,QAAD;EAAQ,GAAI;EAAZ,UAAA,CACE,qBAAC,cAAD;GAAc,WAAU;GAAxB,UAAA,CACE,oBAAC,aAAD,EAAA,UAAc,MAAmB,CAAA,GACjC,oBAAC,mBAAD,EAAA,UAAoB,YAA+B,CAAA,CACvC;EACd,CAAA,GAAA,oBAAC,eAAD;GACE,WAAW,GACT,yDACA,SACF;GACiB;GAEhB;EACY,CAAA,CACT;;AAEZ;AAEA,SAAS,aAAa,EACpB,WACA,GAAG,SACmD;CACtD,OACE,oBAAC,OAAD;EAAK,aAAU;EAAwB,WAAU;EAC/C,UAAA,qBAAC,YAAD;GAAY,WAAU;GAAtB,UAAA,CACE,oBAACA,QAAiB,OAAlB;IACE,aAAU;IACV,WAAW,GACT,iFACA,SACF;IACA,GAAI;GACL,CAAA,GACD,oBAAC,iBAAD,EAAA,UACE,oBAAC,YAAD,EAAY,WAAU,6BAA8B,CAAA,EACrC,CAAA,CACP;;CACT,CAAA;AAET;AAEA,SAAS,YAAY,EACnB,WACA,GAAG,SACkD;CACrD,OACE,oBAACA,QAAiB,MAAlB;EACE,aAAU;EACV,WAAW,GACT,oFACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;AAEA,SAAS,aAAa,EACpB,WACA,GAAG,SACmD;CACtD,OACE,oBAACA,QAAiB,OAAlB;EACE,aAAU;EACV,WAAW,GAAG,4BAA4B,SAAS;EACnD,GAAI;CACL,CAAA;AAEL;AAEA,SAAS,aAAa,EACpB,WACA,GAAG,SACmD;CACtD,OACE,oBAACA,QAAiB,OAAlB;EACE,aAAU;EACV,WAAW,GACT,+NACA,SACF;EACA,GAAI;CACL,CAAA;AAEL;AAeA,SAAS,YAAY,EACnB,WACA,UACA,GAAG,SACkD;CACrD,OACE,qBAACA,QAAiB,MAAlB;EACE,aAAU;EACV,WAAW,GACT,gaACA,SACF;EACA,GAAI;EANN,UAAA,CAQG,UACD,oBAAC,WAAD,EAAW,WAAU,kIAAmI,CAAA,CACnI;;AAE3B;AAEA,SAAS,gBAAgB,EACvB,WACA,GAAG,SAC4B;CAC/B,OACE,oBAAC,QAAD;EACE,aAAU;EACV,WAAW,GACT,0GACA,SACF;EACA,GAAI;CACL,CAAA;AAEL"}

package/dist/schema/advanced.d.ts

@@ -2,12 +2,12 @@ import { AnyExtension } from "@tiptap/core";
 //#region src/schema/advanced.d.ts
 /**
  * The Vue-free schema of the advanced editor, free of node views, UI and collaboration runtime: the server builds the
- * same schema with `getSchema(advancedSchemaExtensions())` to convert between TipTap JSON and Yjs. The order is the
- * order of the client's schema-bearing extensions: StarterKit/StrikeX, the generic node flags, the opaque fence, media (image, audio,
- * video, file), transcript, the composite family, mentions/tags, the author and comment marks, the GFM table and task-list
- * nodes (for hosts whose preset adds `tablesFeature()`; the advanced preset itself has none) and last `BlockId`, which
- * adds the `id` attribute to every block type (its ID-assigning plugins only run in an editor). `undoRedo: false`:
- * under collaboration the Collaboration extension provides the (per-user) undo manager.
+ * same schema with `getSchema(advancedSchemaExtensions())` to convert between TipTap JSON and Yjs. Derived with
+ * `schemaExtensionsOf` from the schema-bearing features: StarterKit/StrikeX, the generic node flags, the opaque fence,
+ * media (image, audio, video, file), transcript, the composite family, mentions/tags, the author and comment marks, the
+ * GFM table and task-list nodes (for hosts whose preset adds `tablesFeature()`; the advanced preset itself has none) and
+ * last `BlockId`, which adds the `id` attribute to every block type (its ID-assigning plugins only run in an editor).
+ * `undoRedo: false`: under collaboration the Collaboration extension provides the (per-user) undo manager.
  */
 export declare const advancedSchemaExtensions: () => AnyExtension[];
 //#endregion

package/dist/schema/advanced.js

@@ -1,42 +1,39 @@
-import { BlockId } from "../core/schema/block-ids.js";
-import { NodeFlags } from "../core/schema/node-flags.js";
-import { OpaqueFence } from "../core/schema/opaque-fence.js";
-import { StrikeX } from "../core/schema/strike.js";
+import { schemaExtensionsOf } from "../core/schema/of-features.js";
+import { coreContentSchemaExtensions } from "../core/schema/index.js";
+import { commentsSchemaExtensions } from "../features/comments/schema.js";
 import { compositeSchemaExtensions } from "../features/composites/schema.js";
 import { authorsSchemaExtensions } from "../features/authors/schema.js";
-import { commentsSchemaExtensions } from "../features/comments/schema.js";
 import { mediaSchemaExtensions } from "../features/media/schema.js";
 import { mentionsSchemaExtensions } from "../features/mentions/schema.js";
 import { tablesSchemaExtensions } from "../features/tables/schema.js";
 import { transcriptSchemaExtensions } from "../features/transcript/schema.js";
-import StarterKit from "@tiptap/starter-kit";
 //#region src/schema/advanced.ts
 /**
-* The Vue-free schema of the advanced editor, free of node views, UI and collaboration runtime: the server builds the
-* same schema with `getSchema(advancedSchemaExtensions())` to convert between TipTap JSON and Yjs. The order is the
-* order of the client's schema-bearing extensions: StarterKit/StrikeX, the generic node flags, the opaque fence, media (image, audio,
-* video, file), transcript, the composite family, mentions/tags, the author and comment marks, the GFM table and task-list
-* nodes (for hosts whose preset adds `tablesFeature()`; the advanced preset itself has none) and last `BlockId`, which
-* adds the `id` attribute to every block type (its ID-assigning plugins only run in an editor). `undoRedo: false`:
-* under collaboration the Collaboration extension provides the (per-user) undo manager.
+* The schema-bearing slice of the rich content features, in schema order: `core-content`, media, transcript, composites,
+* mentions, authors, the comment mark (`comments` is an interaction feature, but stored documents contain its mark), and
+* tables. Each entry is the very `schemaExtensions` function the feature of that id declares; the features themselves
+* are not imported, because they carry node views and UI that a server must never load.
 */
-const advancedSchemaExtensions = () => [
-	StarterKit.configure({
-		strike: false,
-		undoRedo: false
-	}),
-	StrikeX,
-	NodeFlags,
-	OpaqueFence,
-	...mediaSchemaExtensions(),
-	...transcriptSchemaExtensions(),
-	...compositeSchemaExtensions(),
-	...mentionsSchemaExtensions(),
-	...authorsSchemaExtensions(),
-	...commentsSchemaExtensions(),
-	...tablesSchemaExtensions(),
-	BlockId
+const RICH_CONTENT_SCHEMA = [
+	{ schemaExtensions: coreContentSchemaExtensions },
+	{ schemaExtensions: mediaSchemaExtensions },
+	{ schemaExtensions: transcriptSchemaExtensions },
+	{ schemaExtensions: () => compositeSchemaExtensions() },
+	{ schemaExtensions: mentionsSchemaExtensions },
+	{ schemaExtensions: authorsSchemaExtensions },
+	{ schemaExtensions: commentsSchemaExtensions },
+	{ schemaExtensions: tablesSchemaExtensions }
 ];
+/**
+* The Vue-free schema of the advanced editor, free of node views, UI and collaboration runtime: the server builds the
+* same schema with `getSchema(advancedSchemaExtensions())` to convert between TipTap JSON and Yjs. Derived with
+* `schemaExtensionsOf` from the schema-bearing features: StarterKit/StrikeX, the generic node flags, the opaque fence,
+* media (image, audio, video, file), transcript, the composite family, mentions/tags, the author and comment marks, the
+* GFM table and task-list nodes (for hosts whose preset adds `tablesFeature()`; the advanced preset itself has none) and
+* last `BlockId`, which adds the `id` attribute to every block type (its ID-assigning plugins only run in an editor).
+* `undoRedo: false`: under collaboration the Collaboration extension provides the (per-user) undo manager.
+*/
+const advancedSchemaExtensions = () => schemaExtensionsOf(RICH_CONTENT_SCHEMA);
 //#endregion
 export { advancedSchemaExtensions };
 

package/dist/schema/advanced.js.map

@@ -1 +1 @@
-{"version":3,"file":"advanced.js","names":[],"sources":["../../src/schema/advanced.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport StarterKit from '@tiptap/starter-kit'\nimport { BlockId, NodeFlags, OpaqueFence, StrikeX } from '../core/schema'\nimport { authorsSchemaExtensions } from '../features/authors/schema'\nimport { commentsSchemaExtensions } from '../features/comments/schema'\nimport { compositeSchemaExtensions } from '../features/composites/schema'\nimport { mediaSchemaExtensions } from '../features/media/schema'\nimport { mentionsSchemaExtensions } from '../features/mentions/schema'\nimport { tablesSchemaExtensions } from '../features/tables/schema'\nimport { transcriptSchemaExtensions } from '../features/transcript/schema'\n\n/**\n * The Vue-free schema of the advanced editor, free of node views, UI and collaboration runtime: the server builds the\n * same schema with `getSchema(advancedSchemaExtensions())` to convert between TipTap JSON and Yjs. The order is the\n * order of the client's schema-bearing extensions: StarterKit/StrikeX, the generic node flags, the opaque fence, media (image, audio,\n * video, file), transcript, the composite family, mentions/tags, the author and comment marks, the GFM table and task-list\n * nodes (for hosts whose preset adds `tablesFeature()`; the advanced preset itself has none) and last `BlockId`, which\n * adds the `id` attribute to every block type (its ID-assigning plugins only run in an editor). `undoRedo: false`:\n * under collaboration the Collaboration extension provides the (per-user) undo manager.\n */\nexport const advancedSchemaExtensions = (): AnyExtension[] => [\n  StarterKit.configure({ strike: false, undoRedo: false }),\n  StrikeX,\n  NodeFlags,\n  OpaqueFence,\n  ...mediaSchemaExtensions(),\n  ...transcriptSchemaExtensions(),\n  ...compositeSchemaExtensions(),\n  ...mentionsSchemaExtensions(),\n  ...authorsSchemaExtensions(),\n  ...commentsSchemaExtensions(),\n  ...tablesSchemaExtensions(),\n  BlockId,\n]\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,iCAAiD;CAC5D,WAAW,UAAU;EAAE,QAAQ;EAAO,UAAU;CAAM,CAAC;CACvD;CACA;CACA;CACA,GAAG,sBAAsB;CACzB,GAAG,2BAA2B;CAC9B,GAAG,0BAA0B;CAC7B,GAAG,yBAAyB;CAC5B,GAAG,wBAAwB;CAC3B,GAAG,yBAAyB;CAC5B,GAAG,uBAAuB;CAC1B;AACF"}
+{"version":3,"file":"advanced.js","names":[],"sources":["../../src/schema/advanced.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport { coreContentSchemaExtensions, schemaExtensionsOf } from '../core/schema'\nimport { authorsSchemaExtensions } from '../features/authors/schema'\nimport { commentsSchemaExtensions } from '../features/comments/schema'\nimport { compositeSchemaExtensions } from '../features/composites/schema'\nimport { mediaSchemaExtensions } from '../features/media/schema'\nimport { mentionsSchemaExtensions } from '../features/mentions/schema'\nimport { tablesSchemaExtensions } from '../features/tables/schema'\nimport { transcriptSchemaExtensions } from '../features/transcript/schema'\n\n/**\n * The schema-bearing slice of the rich content features, in schema order: `core-content`, media, transcript, composites,\n * mentions, authors, the comment mark (`comments` is an interaction feature, but stored documents contain its mark), and\n * tables. Each entry is the very `schemaExtensions` function the feature of that id declares; the features themselves\n * are not imported, because they carry node views and UI that a server must never load.\n */\nconst RICH_CONTENT_SCHEMA = [\n  { schemaExtensions: coreContentSchemaExtensions },\n  { schemaExtensions: mediaSchemaExtensions },\n  { schemaExtensions: transcriptSchemaExtensions },\n  { schemaExtensions: () => compositeSchemaExtensions() },\n  { schemaExtensions: mentionsSchemaExtensions },\n  { schemaExtensions: authorsSchemaExtensions },\n  { schemaExtensions: commentsSchemaExtensions },\n  { schemaExtensions: tablesSchemaExtensions },\n]\n\n/**\n * The Vue-free schema of the advanced editor, free of node views, UI and collaboration runtime: the server builds the\n * same schema with `getSchema(advancedSchemaExtensions())` to convert between TipTap JSON and Yjs. Derived with\n * `schemaExtensionsOf` from the schema-bearing features: StarterKit/StrikeX, the generic node flags, the opaque fence,\n * media (image, audio, video, file), transcript, the composite family, mentions/tags, the author and comment marks, the\n * GFM table and task-list nodes (for hosts whose preset adds `tablesFeature()`; the advanced preset itself has none) and\n * last `BlockId`, which adds the `id` attribute to every block type (its ID-assigning plugins only run in an editor).\n * `undoRedo: false`: under collaboration the Collaboration extension provides the (per-user) undo manager.\n */\nexport const advancedSchemaExtensions = (): AnyExtension[] => schemaExtensionsOf(RICH_CONTENT_SCHEMA)\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,sBAAsB;CAC1B,EAAE,kBAAkB,4BAA4B;CAChD,EAAE,kBAAkB,sBAAsB;CAC1C,EAAE,kBAAkB,2BAA2B;CAC/C,EAAE,wBAAwB,0BAA0B,EAAE;CACtD,EAAE,kBAAkB,yBAAyB;CAC7C,EAAE,kBAAkB,wBAAwB;CAC5C,EAAE,kBAAkB,yBAAyB;CAC7C,EAAE,kBAAkB,uBAAuB;AAC7C;;;;;;;;;;AAWA,MAAa,iCAAiD,mBAAmB,mBAAmB"}

package/dist/server/ai.d.ts

@@ -1,6 +1,7 @@
 import { ModelSlot } from "../settings/values.js";
 import "../settings/index.js";
-import { ModelProfile, ModelRef } from "../features/ai/protocol/models.js";
+import { PresetConfig, TranscriptionConfig } from "../config/index.js";
+import { ModelProfile, ModelRef } from "../core/backend-types.js";
 import "../features/ai/protocol/index.js";
 import { HttpError } from "./errors.js";
 import { LanguageModel, ModelMessage, ToolChoice, ToolSet } from "ai";
@@ -20,19 +21,6 @@ export type ChatTurnPart = {
   input: unknown;
   invalid: boolean;
 };
-/** Server-defined model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. */
-export interface PresetConfig {
-  label: string;
-  endpoint: string;
-  model: string;
-  apiKey?: string;
-}
-/** Speech-to-text endpoint: any OpenAI-compatible `<endpoint>/audio/transcriptions`. */
-export interface TranscriptionConfig {
-  endpoint: string;
-  model: string;
-  apiKey?: string;
-}
 /** Everything the AI endpoints need, passed explicitly: no runtime config, no globals. */
 export interface AiModelsConfig {
   /** Server-defined model presets, keyed by preset id. */
@@ -44,11 +32,11 @@ export interface AiModelsConfig {
   /** Speech-to-text for audio/video composites; absent = the transcription endpoint answers 501. */
   transcription?: TranscriptionConfig;
   /**
-   * The host's own language model for `ref` (`EditorAdapter.languageModel`), consulted before the presets for every
+   * The host's own language model for `ref` (`ModelProvider.languageModel`), consulted before the presets for every
    * model reference; `user` is what `authenticate` returned. `null` or nothing falls through to the presets.
    */
   languageModel?: (ref: ModelRef, user: object | null) => Promise<LanguageModel | null | undefined>;
-  /** The models listed for `user` instead of the presets (`EditorAdapter.listModels`); `null` or nothing lists the presets. */
+  /** The models listed for `user` instead of the presets (`ModelProvider.listModels`); `null` or nothing lists the presets. */
   listModels?: (user: object | null) => Promise<ModelProfile[] | null | undefined>;
   /** Appended to the error of a preset without key, e.g. the environment variable names that set it. */
   missingKeyHint?: (presetId: string) => string;
@@ -98,4 +86,5 @@ export declare function streamChatTurn(opts: {
   toolChoice?: ToolChoice<ToolSet>;
 }): AsyncGenerator<ChatTurnPart>;
 //#endregion
+export type { PresetConfig, TranscriptionConfig };
 //# sourceMappingURL=ai.d.ts.map

package/dist/server/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","names":[],"sources":["../../src/server/ai.ts"],"sourcesContent":["import { createOpenAICompatible } from '@ai-sdk/openai-compatible'\nimport { APICallError, type LanguageModel, type ModelMessage, streamText, type ToolChoice, type ToolSet } from 'ai'\nimport type { ModelProfile, ModelRef } from '../features/ai/protocol'\nimport type { ModelSlot } from '../settings'\nimport { HttpError } from './errors'\n\nexport interface ChatMessage { role: 'system' | 'user' | 'assistant', content: string }\n\n/** A streamed text delta, or a finished tool call (`invalid`: unparsable input or unknown tool). */\nexport type ChatTurnPart =\n  | { type: 'text', text: string }\n  | { type: 'tool-call', toolCallId: string, toolName: string, input: unknown, invalid: boolean }\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/** Speech-to-text endpoint: any OpenAI-compatible `<endpoint>/audio/transcriptions`. */\nexport interface TranscriptionConfig { endpoint: string, model: string, apiKey?: string }\n\n/** Everything the AI endpoints need, passed explicitly: no runtime config, no globals. */\nexport interface AiModelsConfig {\n  /** Server-defined model presets, keyed by preset id. */\n  presets: Record<string, PresetConfig>\n  /** Shared key of presets without their own. */\n  apiKey?: string\n  /** Default preset per model slot, answered by `GET /api/ai/models`. */\n  slots?: Record<ModelSlot, string>\n  /** Speech-to-text for audio/video composites; absent = the transcription endpoint answers 501. */\n  transcription?: TranscriptionConfig\n  /**\n   * The host's own language model for `ref` (`EditorAdapter.languageModel`), consulted before the presets for every\n   * model reference; `user` is what `authenticate` returned. `null` or nothing falls through to the presets.\n   */\n  languageModel?: (ref: ModelRef, user: object | null) => Promise<LanguageModel | null | undefined>\n  /** The models listed for `user` instead of the presets (`EditorAdapter.listModels`); `null` or nothing lists the presets. */\n  listModels?: (user: object | null) => Promise<ModelProfile[] | null | undefined>\n  /** Appended to the error of a preset without key, e.g. the environment variable names that set it. */\n  missingKeyHint?: (presetId: string) => string\n}\n\nexport interface AiModels {\n  /**\n   * AI SDK language model for `ref` (an OpenAI-compatible chat completions endpoint), for direct `ai` calls. The\n   * host's `languageModel(ref, user)` is asked first (`user`: what `authenticate` returned); a model it returns is\n   * used as is, `null` (or no such hook) falls through to the configured presets. A preset uses its own key or the\n   * shared `apiKey`; a user ref brings its own. Throws `HttpError` 400 for an unknown preset and 500 for a preset\n   * without key, so routes can call it before streaming starts.\n   */\n  resolveModel(ref: ModelRef, user: object | null): Promise<LanguageModel>\n  /**\n   * The configured presets as the client may see them: without their keys. `user` is what the host's `authenticate`\n   * returned; the `listModels` hook supplies the list when it returns one (replacing the presets).\n   */\n  listModels(user: object | null): Promise<ModelProfile[]>\n  readonly slots: Record<ModelSlot, string> | undefined\n  readonly transcription: TranscriptionConfig | undefined\n  streamChat: typeof streamChat\n  streamChatTurn: typeof streamChatTurn\n}\n\n/** The AI model utilities over an explicit configuration. */\nexport function createAiModels(config: AiModelsConfig): AiModels {\n  return {\n    async resolveModel(ref, user) {\n      const hosted = await config.languageModel?.(ref, user)\n      if (hosted) return hosted\n      if (!('preset' in ref)) return createOpenAICompatible({ name: 'tiptap-editor', baseURL: ref.endpoint, apiKey: ref.apiKey }).chatModel(ref.model)\n      const preset = config.presets[ref.preset]\n      if (!preset) throw new HttpError(400, 'Unbekanntes Modell-Preset')\n      const apiKey = preset.apiKey || config.apiKey\n      if (!apiKey) throw new HttpError(500, `API-Key für Preset „${ref.preset}“ fehlt${config.missingKeyHint?.(ref.preset) ?? ''}`)\n      return createOpenAICompatible({ name: 'tiptap-editor', baseURL: preset.endpoint, apiKey }).chatModel(preset.model)\n    },\n    async listModels(user) {\n      const listed = await config.listModels?.(user)\n      if (listed) return listed\n      return Object.entries(config.presets).map(([id, { label, endpoint, model }]) => ({ id, label, endpoint, model, source: 'preset' }))\n    },\n    slots: config.slots,\n    transcription: config.transcription,\n    streamChat,\n    streamChatTurn,\n  }\n}\n\nexport function upstreamError(error: unknown) {\n  let detail: string\n  if (APICallError.isInstance(error)) detail = [error.statusCode, error.responseBody || error.message].filter(Boolean).join(' ')\n  else if (error instanceof Error) detail = error.message\n  else detail = (error as { message?: string } | null)?.message ?? JSON.stringify(error)\n  return new HttpError(502, `KI-Endpunkt: ${detail}`.slice(0, 500))\n}\n\n/**\n * Streams the text deltas of a chat completion (AI SDK `streamText`) on the resolved language model `model` (see\n * `resolveModel`). System messages may appear in `messages`; a trailing assistant message is a prefill the model\n * continues. Upstream failures throw a 502 `HttpError`; aborting `signal` cancels the upstream request and makes the\n * generator throw.\n */\nexport async function* streamChat(opts: { model: LanguageModel, messages: ChatMessage[], signal: AbortSignal }): AsyncGenerator<string> {\n  for await (const part of streamChatTurn(opts)) {\n    if (part.type === 'text') yield part.text\n  }\n}\n\n/**\n * Like `streamChat`, with `tools` the model may call (tools without `execute`: the turn ends with the calls, which are\n * yielded for the caller to handle) and structured `messages` (tool calls and results in the history).\n */\nexport async function* streamChatTurn(opts: {\n  model: LanguageModel\n  messages: ModelMessage[]\n  signal: AbortSignal\n  tools?: ToolSet\n  toolChoice?: ToolChoice<ToolSet>\n}): AsyncGenerator<ChatTurnPart> {\n  const { model } = opts\n  // Also cancels the upstream request when the consumer stops iterating early (break / return).\n  const upstream = new AbortController()\n  const onAbort = () => upstream.abort(opts.signal.reason)\n  if (opts.signal.aborted) onAbort()\n  else opts.signal.addEventListener('abort', onAbort, { once: true })\n  try {\n    const result = streamText({\n      model,\n      messages: opts.messages,\n      tools: opts.tools,\n      toolChoice: opts.toolChoice,\n      allowSystemInMessages: true,\n      abortSignal: upstream.signal,\n      maxRetries: 0,\n      // Errors surface as `error` parts below and are rethrown; the default handler would only log them.\n      onError: () => {},\n    })\n    for await (const part of result.stream) {\n      if (part.type === 'text-delta') {\n        if (part.text) yield { type: 'text', text: part.text }\n      }\n      else if (part.type === 'tool-call') {\n        yield { type: 'tool-call', toolCallId: part.toolCallId, toolName: part.toolName, input: part.input, invalid: part.invalid === true }\n      }\n      else if (part.type === 'error') {\n        if (opts.signal.aborted) break\n        throw upstreamError(part.error)\n      }\n      else if (part.type === 'abort') {\n        break\n      }\n    }\n    opts.signal.throwIfAborted()\n  }\n  finally {\n    opts.signal.removeEventListener('abort', onAbort)\n    upstream.abort()\n  }\n}\n"],"mappings":";;;;;AA6DA,SAAgB,eAAe,QAAkC;CAC/D,OAAO;EACL,MAAM,aAAa,KAAK,MAAM;GAC5B,MAAM,SAAS,MAAM,OAAO,gBAAgB,KAAK,IAAI;GACrD,IAAI,QAAQ,OAAO;GACnB,IAAI,EAAE,YAAY,MAAM,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,IAAI;IAAU,QAAQ,IAAI;GAAO,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK;GAC/I,MAAM,SAAS,OAAO,QAAQ,IAAI;GAClC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,2BAA2B;GACjE,MAAM,SAAS,OAAO,UAAU,OAAO;GACvC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,uBAAuB,IAAI,OAAO,SAAS,OAAO,iBAAiB,IAAI,MAAM,KAAK,IAAI;GAC5H,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,OAAO;IAAU;GAAO,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK;EACnH;EACA,MAAM,WAAW,MAAM;GACrB,MAAM,SAAS,MAAM,OAAO,aAAa,IAAI;GAC7C,IAAI,QAAQ,OAAO;GACnB,OAAO,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,UAAU,cAAc;IAAE;IAAI;IAAO;IAAU;IAAO,QAAQ;GAAS,EAAE;EACpI;EACA,OAAO,OAAO;EACd,eAAe,OAAO;EACtB;EACA;CACF;AACF;AAEA,SAAgB,cAAc,OAAgB;CAC5C,IAAI;CACJ,IAAI,aAAa,WAAW,KAAK,GAAG,SAAS,CAAC,MAAM,YAAY,MAAM,gBAAgB,MAAM,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;MACxH,IAAI,iBAAiB,OAAO,SAAS,MAAM;MAC3C,SAAU,OAAuC,WAAW,KAAK,UAAU,KAAK;CACrF,OAAO,IAAI,UAAU,KAAK,gBAAgB,SAAS,MAAM,GAAG,GAAG,CAAC;AAClE;;;;;;;AAQA,gBAAuB,WAAW,MAAsG;CACtI,WAAW,MAAM,QAAQ,eAAe,IAAI,GAC1C,IAAI,KAAK,SAAS,QAAQ,MAAM,KAAK;AAEzC;;;;;AAMA,gBAAuB,eAAe,MAML;CAC/B,MAAM,EAAE,UAAU;CAElB,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,gBAAgB,SAAS,MAAM,KAAK,OAAO,MAAM;CACvD,IAAI,KAAK,OAAO,SAAS,QAAQ;MAC5B,KAAK,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAClE,IAAI;EACF,MAAM,SAAS,WAAW;GACxB;GACA,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,YAAY,KAAK;GACjB,uBAAuB;GACvB,aAAa,SAAS;GACtB,YAAY;GAEZ,eAAe,CAAC;EAClB,CAAC;EACD,WAAW,MAAM,QAAQ,OAAO,QAC9B,IAAI,KAAK,SAAS,cACZ;OAAA,KAAK,MAAM,MAAM;IAAE,MAAM;IAAQ,MAAM,KAAK;GAAK;EAAA,OAElD,IAAI,KAAK,SAAS,aACrB,MAAM;GAAE,MAAM;GAAa,YAAY,KAAK;GAAY,UAAU,KAAK;GAAU,OAAO,KAAK;GAAO,SAAS,KAAK,YAAY;EAAK;OAEhI,IAAI,KAAK,SAAS,SAAS;GAC9B,IAAI,KAAK,OAAO,SAAS;GACzB,MAAM,cAAc,KAAK,KAAK;EAChC,OACK,IAAI,KAAK,SAAS,SACrB;EAGJ,KAAK,OAAO,eAAe;CAC7B,UACQ;EACN,KAAK,OAAO,oBAAoB,SAAS,OAAO;EAChD,SAAS,MAAM;CACjB;AACF"}
+{"version":3,"file":"ai.js","names":[],"sources":["../../src/server/ai.ts"],"sourcesContent":["import { createOpenAICompatible } from '@ai-sdk/openai-compatible'\nimport { APICallError, type LanguageModel, type ModelMessage, streamText, type ToolChoice, type ToolSet } from 'ai'\nimport type { ModelProfile, ModelRef } from '../features/ai/protocol'\nimport type { ModelSlot } from '../settings'\nimport type { PresetConfig, TranscriptionConfig } from '../config'\nimport { HttpError } from './errors'\n\nexport interface ChatMessage { role: 'system' | 'user' | 'assistant', content: string }\n\n/** A streamed text delta, or a finished tool call (`invalid`: unparsable input or unknown tool). */\nexport type ChatTurnPart =\n  | { type: 'text', text: string }\n  | { type: 'tool-call', toolCallId: string, toolName: string, input: unknown, invalid: boolean }\n\nexport type { PresetConfig, TranscriptionConfig }\n\n/** Everything the AI endpoints need, passed explicitly: no runtime config, no globals. */\nexport interface AiModelsConfig {\n  /** Server-defined model presets, keyed by preset id. */\n  presets: Record<string, PresetConfig>\n  /** Shared key of presets without their own. */\n  apiKey?: string\n  /** Default preset per model slot, answered by `GET /api/ai/models`. */\n  slots?: Record<ModelSlot, string>\n  /** Speech-to-text for audio/video composites; absent = the transcription endpoint answers 501. */\n  transcription?: TranscriptionConfig\n  /**\n   * The host's own language model for `ref` (`ModelProvider.languageModel`), consulted before the presets for every\n   * model reference; `user` is what `authenticate` returned. `null` or nothing falls through to the presets.\n   */\n  languageModel?: (ref: ModelRef, user: object | null) => Promise<LanguageModel | null | undefined>\n  /** The models listed for `user` instead of the presets (`ModelProvider.listModels`); `null` or nothing lists the presets. */\n  listModels?: (user: object | null) => Promise<ModelProfile[] | null | undefined>\n  /** Appended to the error of a preset without key, e.g. the environment variable names that set it. */\n  missingKeyHint?: (presetId: string) => string\n}\n\nexport interface AiModels {\n  /**\n   * AI SDK language model for `ref` (an OpenAI-compatible chat completions endpoint), for direct `ai` calls. The\n   * host's `languageModel(ref, user)` is asked first (`user`: what `authenticate` returned); a model it returns is\n   * used as is, `null` (or no such hook) falls through to the configured presets. A preset uses its own key or the\n   * shared `apiKey`; a user ref brings its own. Throws `HttpError` 400 for an unknown preset and 500 for a preset\n   * without key, so routes can call it before streaming starts.\n   */\n  resolveModel(ref: ModelRef, user: object | null): Promise<LanguageModel>\n  /**\n   * The configured presets as the client may see them: without their keys. `user` is what the host's `authenticate`\n   * returned; the `listModels` hook supplies the list when it returns one (replacing the presets).\n   */\n  listModels(user: object | null): Promise<ModelProfile[]>\n  readonly slots: Record<ModelSlot, string> | undefined\n  readonly transcription: TranscriptionConfig | undefined\n  streamChat: typeof streamChat\n  streamChatTurn: typeof streamChatTurn\n}\n\n/** The AI model utilities over an explicit configuration. */\nexport function createAiModels(config: AiModelsConfig): AiModels {\n  return {\n    async resolveModel(ref, user) {\n      const hosted = await config.languageModel?.(ref, user)\n      if (hosted) return hosted\n      if (!('preset' in ref)) return createOpenAICompatible({ name: 'tiptap-editor', baseURL: ref.endpoint, apiKey: ref.apiKey }).chatModel(ref.model)\n      const preset = config.presets[ref.preset]\n      if (!preset) throw new HttpError(400, 'Unbekanntes Modell-Preset')\n      const apiKey = preset.apiKey || config.apiKey\n      if (!apiKey) throw new HttpError(500, `API-Key für Preset „${ref.preset}“ fehlt${config.missingKeyHint?.(ref.preset) ?? ''}`)\n      return createOpenAICompatible({ name: 'tiptap-editor', baseURL: preset.endpoint, apiKey }).chatModel(preset.model)\n    },\n    async listModels(user) {\n      const listed = await config.listModels?.(user)\n      if (listed) return listed\n      return Object.entries(config.presets).map(([id, { label, endpoint, model }]) => ({ id, label, endpoint, model, source: 'preset' }))\n    },\n    slots: config.slots,\n    transcription: config.transcription,\n    streamChat,\n    streamChatTurn,\n  }\n}\n\nexport function upstreamError(error: unknown) {\n  let detail: string\n  if (APICallError.isInstance(error)) detail = [error.statusCode, error.responseBody || error.message].filter(Boolean).join(' ')\n  else if (error instanceof Error) detail = error.message\n  else detail = (error as { message?: string } | null)?.message ?? JSON.stringify(error)\n  return new HttpError(502, `KI-Endpunkt: ${detail}`.slice(0, 500))\n}\n\n/**\n * Streams the text deltas of a chat completion (AI SDK `streamText`) on the resolved language model `model` (see\n * `resolveModel`). System messages may appear in `messages`; a trailing assistant message is a prefill the model\n * continues. Upstream failures throw a 502 `HttpError`; aborting `signal` cancels the upstream request and makes the\n * generator throw.\n */\nexport async function* streamChat(opts: { model: LanguageModel, messages: ChatMessage[], signal: AbortSignal }): AsyncGenerator<string> {\n  for await (const part of streamChatTurn(opts)) {\n    if (part.type === 'text') yield part.text\n  }\n}\n\n/**\n * Like `streamChat`, with `tools` the model may call (tools without `execute`: the turn ends with the calls, which are\n * yielded for the caller to handle) and structured `messages` (tool calls and results in the history).\n */\nexport async function* streamChatTurn(opts: {\n  model: LanguageModel\n  messages: ModelMessage[]\n  signal: AbortSignal\n  tools?: ToolSet\n  toolChoice?: ToolChoice<ToolSet>\n}): AsyncGenerator<ChatTurnPart> {\n  const { model } = opts\n  // Also cancels the upstream request when the consumer stops iterating early (break / return).\n  const upstream = new AbortController()\n  const onAbort = () => upstream.abort(opts.signal.reason)\n  if (opts.signal.aborted) onAbort()\n  else opts.signal.addEventListener('abort', onAbort, { once: true })\n  try {\n    const result = streamText({\n      model,\n      messages: opts.messages,\n      tools: opts.tools,\n      toolChoice: opts.toolChoice,\n      allowSystemInMessages: true,\n      abortSignal: upstream.signal,\n      maxRetries: 0,\n      // Errors surface as `error` parts below and are rethrown; the default handler would only log them.\n      onError: () => {},\n    })\n    for await (const part of result.stream) {\n      if (part.type === 'text-delta') {\n        if (part.text) yield { type: 'text', text: part.text }\n      }\n      else if (part.type === 'tool-call') {\n        yield { type: 'tool-call', toolCallId: part.toolCallId, toolName: part.toolName, input: part.input, invalid: part.invalid === true }\n      }\n      else if (part.type === 'error') {\n        if (opts.signal.aborted) break\n        throw upstreamError(part.error)\n      }\n      else if (part.type === 'abort') {\n        break\n      }\n    }\n    opts.signal.throwIfAborted()\n  }\n  finally {\n    opts.signal.removeEventListener('abort', onAbort)\n    upstream.abort()\n  }\n}\n"],"mappings":";;;;;AA0DA,SAAgB,eAAe,QAAkC;CAC/D,OAAO;EACL,MAAM,aAAa,KAAK,MAAM;GAC5B,MAAM,SAAS,MAAM,OAAO,gBAAgB,KAAK,IAAI;GACrD,IAAI,QAAQ,OAAO;GACnB,IAAI,EAAE,YAAY,MAAM,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,IAAI;IAAU,QAAQ,IAAI;GAAO,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK;GAC/I,MAAM,SAAS,OAAO,QAAQ,IAAI;GAClC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,2BAA2B;GACjE,MAAM,SAAS,OAAO,UAAU,OAAO;GACvC,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,uBAAuB,IAAI,OAAO,SAAS,OAAO,iBAAiB,IAAI,MAAM,KAAK,IAAI;GAC5H,OAAO,uBAAuB;IAAE,MAAM;IAAiB,SAAS,OAAO;IAAU;GAAO,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK;EACnH;EACA,MAAM,WAAW,MAAM;GACrB,MAAM,SAAS,MAAM,OAAO,aAAa,IAAI;GAC7C,IAAI,QAAQ,OAAO;GACnB,OAAO,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,UAAU,cAAc;IAAE;IAAI;IAAO;IAAU;IAAO,QAAQ;GAAS,EAAE;EACpI;EACA,OAAO,OAAO;EACd,eAAe,OAAO;EACtB;EACA;CACF;AACF;AAEA,SAAgB,cAAc,OAAgB;CAC5C,IAAI;CACJ,IAAI,aAAa,WAAW,KAAK,GAAG,SAAS,CAAC,MAAM,YAAY,MAAM,gBAAgB,MAAM,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;MACxH,IAAI,iBAAiB,OAAO,SAAS,MAAM;MAC3C,SAAU,OAAuC,WAAW,KAAK,UAAU,KAAK;CACrF,OAAO,IAAI,UAAU,KAAK,gBAAgB,SAAS,MAAM,GAAG,GAAG,CAAC;AAClE;;;;;;;AAQA,gBAAuB,WAAW,MAAsG;CACtI,WAAW,MAAM,QAAQ,eAAe,IAAI,GAC1C,IAAI,KAAK,SAAS,QAAQ,MAAM,KAAK;AAEzC;;;;;AAMA,gBAAuB,eAAe,MAML;CAC/B,MAAM,EAAE,UAAU;CAElB,MAAM,WAAW,IAAI,gBAAgB;CACrC,MAAM,gBAAgB,SAAS,MAAM,KAAK,OAAO,MAAM;CACvD,IAAI,KAAK,OAAO,SAAS,QAAQ;MAC5B,KAAK,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAClE,IAAI;EACF,MAAM,SAAS,WAAW;GACxB;GACA,UAAU,KAAK;GACf,OAAO,KAAK;GACZ,YAAY,KAAK;GACjB,uBAAuB;GACvB,aAAa,SAAS;GACtB,YAAY;GAEZ,eAAe,CAAC;EAClB,CAAC;EACD,WAAW,MAAM,QAAQ,OAAO,QAC9B,IAAI,KAAK,SAAS,cACZ;OAAA,KAAK,MAAM,MAAM;IAAE,MAAM;IAAQ,MAAM,KAAK;GAAK;EAAA,OAElD,IAAI,KAAK,SAAS,aACrB,MAAM;GAAE,MAAM;GAAa,YAAY,KAAK;GAAY,UAAU,KAAK;GAAU,OAAO,KAAK;GAAO,SAAS,KAAK,YAAY;EAAK;OAEhI,IAAI,KAAK,SAAS,SAAS;GAC9B,IAAI,KAAK,OAAO,SAAS;GACzB,MAAM,cAAc,KAAK,KAAK;EAChC,OACK,IAAI,KAAK,SAAS,SACrB;EAGJ,KAAK,OAAO,eAAe;CAC7B,UACQ;EACN,KAAK,OAAO,oBAAoB,SAAS,OAAO;EAChD,SAAS,MAAM;CACjB;AACF"}

package/dist/server/auth.d.ts

@@ -0,0 +1,9 @@
+//#region src/server/auth.d.ts
+/** What `Identity.authenticate` gets: the headers of the request (the websocket upgrade for collaboration) and the connection's `token`. */
+export interface AuthenticateRequest {
+  headers: Headers;
+  /** The collaboration client's token (`HocuspocusProvider` `token`, sent right after the socket opened); absent for plain HTTP requests and token-less clients. */
+  token?: string;
+}
+//#endregion
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/collab-state.d.ts

@@ -1,6 +1,6 @@
 //#region src/server/collab-state.d.ts
 export interface CollabState {
-  /** `EditorAdapter.contentVersion` of the content the update was stored with; `null` = none known (also: legacy payload). */
+  /** `DocumentStore.contentVersion` of the content the update was stored with; `null` = none known (also: legacy payload). */
   version: string | null;
   update: Uint8Array;
 }

package/dist/server/collab-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"collab-state.js","names":[],"sources":["../../src/server/collab-state.ts"],"sourcesContent":["// Stored Yjs state payload and the re-seed decision of the collab server. Pure: no Hocuspocus, no adapter, no Yjs.\n//\n// The adapter stores opaque bytes (`loadState`/`storeState` keep their signature); the server prefixes the Yjs update\n// with the content version it was written against:\n//\n//   [0xFF, 0x76]  marker (cannot start a legacy payload: a Yjs update opens with the varuint number of client groups,\n//                 and two continuation bytes would mean 16384 or more clients)\n//   utf8 version  empty = `null`\n//   0x00          terminator, so a version never contains NUL\n//   update bytes  `Y.encodeStateAsUpdate`\n//\n// Payloads without the marker are legacy raw updates and decode as `version: null`.\n\nconst MARKER = [0xFF, 0x76] as const\nconst TERMINATOR = 0\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder()\n\nexport interface CollabState {\n  /** `EditorAdapter.contentVersion` of the content the update was stored with; `null` = none known (also: legacy payload). */\n  version: string | null\n  update: Uint8Array\n}\n\nexport function encodeCollabState({ version, update }: CollabState): Uint8Array {\n  const label = encoder.encode(version ?? '')\n  if (label.includes(TERMINATOR)) throw new Error('tiptap-editor: contentVersion darf kein NUL-Zeichen enthalten')\n  const out = new Uint8Array(MARKER.length + label.length + 1 + update.length)\n  out.set(MARKER, 0)\n  out.set(label, MARKER.length)\n  out[MARKER.length + label.length] = TERMINATOR\n  out.set(update, MARKER.length + label.length + 1)\n  return out\n}\n\nexport function decodeCollabState(payload: Uint8Array): CollabState {\n  if (payload[0] !== MARKER[0] || payload[1] !== MARKER[1]) return { version: null, update: payload }\n  const end = payload.indexOf(TERMINATOR, MARKER.length)\n  // A marker without terminator is no payload this module wrote: treat it as an opaque legacy update.\n  if (end === -1) return { version: null, update: payload }\n  const label = decoder.decode(payload.subarray(MARKER.length, end))\n  return { version: label === '' ? null : label, update: payload.subarray(end + 1) }\n}\n\n/**\n * Whether stored collaborative state is stale against the content behind it. Only hosts that implement\n * `contentVersion` opt in (`live === undefined`: the adapter has no such method, state is never discarded). A legacy\n * payload (`stored: null`) against a known live version counts as stale: it cannot prove it matches the content.\n */\nexport function isStateStale(stored: string | null, live: string | null | undefined): boolean {\n  return live !== undefined && stored !== live\n}\n"],"mappings":";AAaA,MAAM,SAAS,CAAC,KAAM,GAAI;AAC1B,MAAM,aAAa;AAEnB,MAAM,UAAU,IAAI,YAAY;AAChC,MAAM,UAAU,IAAI,YAAY;AAQhC,SAAgB,kBAAkB,EAAE,SAAS,UAAmC;CAC9E,MAAM,QAAQ,QAAQ,OAAO,WAAW,EAAE;CAC1C,IAAI,MAAM,SAAS,UAAU,GAAG,MAAM,IAAI,MAAM,+DAA+D;CAC/G,MAAM,MAAM,IAAI,WAAW,OAAO,SAAS,MAAM,SAAS,IAAI,OAAO,MAAM;CAC3E,IAAI,IAAI,QAAQ,CAAC;CACjB,IAAI,IAAI,OAAO,OAAO,MAAM;CAC5B,IAAI,OAAO,SAAS,MAAM,UAAU;CACpC,IAAI,IAAI,QAAQ,OAAO,SAAS,MAAM,SAAS,CAAC;CAChD,OAAO;AACT;AAEA,SAAgB,kBAAkB,SAAkC;CAClE,IAAI,QAAQ,OAAO,OAAO,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO;EAAE,SAAS;EAAM,QAAQ;CAAQ;CAClG,MAAM,MAAM,QAAQ,QAAQ,YAAY,OAAO,MAAM;CAErD,IAAI,QAAQ,IAAI,OAAO;EAAE,SAAS;EAAM,QAAQ;CAAQ;CACxD,MAAM,QAAQ,QAAQ,OAAO,QAAQ,SAAS,OAAO,QAAQ,GAAG,CAAC;CACjE,OAAO;EAAE,SAAS,UAAU,KAAK,OAAO;EAAO,QAAQ,QAAQ,SAAS,MAAM,CAAC;CAAE;AACnF;;;;;;AAOA,SAAgB,aAAa,QAAuB,MAA0C;CAC5F,OAAO,SAAS,KAAA,KAAa,WAAW;AAC1C"}
+{"version":3,"file":"collab-state.js","names":[],"sources":["../../src/server/collab-state.ts"],"sourcesContent":["// Stored Yjs state payload and the re-seed decision of the collab server. Pure: no Hocuspocus, no adapter, no Yjs.\n//\n// The adapter stores opaque bytes (`loadState`/`storeState` keep their signature); the server prefixes the Yjs update\n// with the content version it was written against:\n//\n//   [0xFF, 0x76]  marker (cannot start a legacy payload: a Yjs update opens with the varuint number of client groups,\n//                 and two continuation bytes would mean 16384 or more clients)\n//   utf8 version  empty = `null`\n//   0x00          terminator, so a version never contains NUL\n//   update bytes  `Y.encodeStateAsUpdate`\n//\n// Payloads without the marker are legacy raw updates and decode as `version: null`.\n\nconst MARKER = [0xFF, 0x76] as const\nconst TERMINATOR = 0\n\nconst encoder = new TextEncoder()\nconst decoder = new TextDecoder()\n\nexport interface CollabState {\n  /** `DocumentStore.contentVersion` of the content the update was stored with; `null` = none known (also: legacy payload). */\n  version: string | null\n  update: Uint8Array\n}\n\nexport function encodeCollabState({ version, update }: CollabState): Uint8Array {\n  const label = encoder.encode(version ?? '')\n  if (label.includes(TERMINATOR)) throw new Error('tiptap-editor: contentVersion darf kein NUL-Zeichen enthalten')\n  const out = new Uint8Array(MARKER.length + label.length + 1 + update.length)\n  out.set(MARKER, 0)\n  out.set(label, MARKER.length)\n  out[MARKER.length + label.length] = TERMINATOR\n  out.set(update, MARKER.length + label.length + 1)\n  return out\n}\n\nexport function decodeCollabState(payload: Uint8Array): CollabState {\n  if (payload[0] !== MARKER[0] || payload[1] !== MARKER[1]) return { version: null, update: payload }\n  const end = payload.indexOf(TERMINATOR, MARKER.length)\n  // A marker without terminator is no payload this module wrote: treat it as an opaque legacy update.\n  if (end === -1) return { version: null, update: payload }\n  const label = decoder.decode(payload.subarray(MARKER.length, end))\n  return { version: label === '' ? null : label, update: payload.subarray(end + 1) }\n}\n\n/**\n * Whether stored collaborative state is stale against the content behind it. Only hosts that implement\n * `contentVersion` opt in (`live === undefined`: the adapter has no such method, state is never discarded). A legacy\n * payload (`stored: null`) against a known live version counts as stale: it cannot prove it matches the content.\n */\nexport function isStateStale(stored: string | null, live: string | null | undefined): boolean {\n  return live !== undefined && stored !== live\n}\n"],"mappings":";AAaA,MAAM,SAAS,CAAC,KAAM,GAAI;AAC1B,MAAM,aAAa;AAEnB,MAAM,UAAU,IAAI,YAAY;AAChC,MAAM,UAAU,IAAI,YAAY;AAQhC,SAAgB,kBAAkB,EAAE,SAAS,UAAmC;CAC9E,MAAM,QAAQ,QAAQ,OAAO,WAAW,EAAE;CAC1C,IAAI,MAAM,SAAS,UAAU,GAAG,MAAM,IAAI,MAAM,+DAA+D;CAC/G,MAAM,MAAM,IAAI,WAAW,OAAO,SAAS,MAAM,SAAS,IAAI,OAAO,MAAM;CAC3E,IAAI,IAAI,QAAQ,CAAC;CACjB,IAAI,IAAI,OAAO,OAAO,MAAM;CAC5B,IAAI,OAAO,SAAS,MAAM,UAAU;CACpC,IAAI,IAAI,QAAQ,OAAO,SAAS,MAAM,SAAS,CAAC;CAChD,OAAO;AACT;AAEA,SAAgB,kBAAkB,SAAkC;CAClE,IAAI,QAAQ,OAAO,OAAO,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO;EAAE,SAAS;EAAM,QAAQ;CAAQ;CAClG,MAAM,MAAM,QAAQ,QAAQ,YAAY,OAAO,MAAM;CAErD,IAAI,QAAQ,IAAI,OAAO;EAAE,SAAS;EAAM,QAAQ;CAAQ;CACxD,MAAM,QAAQ,QAAQ,OAAO,QAAQ,SAAS,OAAO,QAAQ,GAAG,CAAC;CACjE,OAAO;EAAE,SAAS,UAAU,KAAK,OAAO;EAAO,QAAQ,QAAQ,SAAS,MAAM,CAAC;CAAE;AACnF;;;;;;AAOA,SAAgB,aAAa,QAAuB,MAA0C;CAC5F,OAAO,SAAS,KAAA,KAAa,WAAW;AAC1C"}

package/dist/server/collab.d.ts

@@ -1,4 +1,4 @@
-import { EditorAdapter } from "./adapter.js";
+import { DocumentStore, EditorPorts, Identity } from "./ports.js";
 import { AnyExtension, JSONContent } from "@tiptap/core";
 import { Schema } from "@tiptap/pm/model";
 import { Configuration, Hocuspocus, WebSocketLike } from "@hocuspocus/server";
@@ -6,14 +6,14 @@ import { Configuration, Hocuspocus, WebSocketLike } from "@hocuspocus/server";
 /** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */
 export declare const COLLAB_FIELD = "default";
 export interface CollabServerOptions {
-  /** Storage and identity of the editor backend. */
-  adapter: EditorAdapter;
-  /** Extensions of host-defined nodes and marks appended to `advancedSchemaExtensions()`; defaults to `adapter.schemaExtensions`. */
-  schemaExtensions?: () => AnyExtension[];
-  /** Per-document access and content versioning; each defaults to the adapter's method of the same name. */
+  /** Identity, documents and Yjs state of the editor backend; `collabState` is required. */
+  ports: EditorPorts;
+  /** TipTap extensions of the collaboration schema; default `advancedSchemaExtensions()`. Host-defined nodes and marks: `() => [...advancedSchemaExtensions(), HostNode]` (Vue-free node files only, no node views). */
+  schema?: () => AnyExtension[];
+  /** Per-document access and content versioning; each defaults to the port's method of the same name. */
   hooks?: {
-    authorize?: NonNullable<EditorAdapter['authorize']>;
-    contentVersion?: NonNullable<EditorAdapter['contentVersion']>;
+    authorize?: NonNullable<Identity['authorize']>;
+    contentVersion?: NonNullable<DocumentStore['contentVersion']>;
   };
   /** Further Hocuspocus configuration (`debounce`, `timeout`, `quiet`, …); the editor's hooks win over equally named ones. */
   configuration?: Partial<Configuration>;
@@ -25,11 +25,11 @@ export interface CollabConnection {
 }
 export interface CollabServer {
   /**
-   * The Hocuspocus instance of this server. The Yjs state (via the adapter's `loadState`/`storeState`) is the source of
-   * truth for content, the host's JSON content (via the adapter) is a mirror kept up to date on every store.
+   * The Hocuspocus instance of this server. The Yjs state (via the `collabState` port's `loadState`/`storeState`) is the
+   * source of truth for content, the host's JSON content (via the `documents` port) is a mirror kept up to date on every store.
    */
   hocuspocus: Hocuspocus;
-  /** Schema of the collab server: `advancedSchemaExtensions()` plus the host's extensions, built on first use. */
+  /** Schema of the collab server: `options.schema()` (default `advancedSchemaExtensions()`), built on first use. */
   schema(): Schema;
   /**
    * Serves one websocket connection (any transport: crossws, `ws`, Bun, Deno). The user is authenticated in Hocuspocus'
@@ -46,7 +46,7 @@ export interface CollabServer {
   /**
    * The host rewrote the content behind the editor's back (an agent wrote the file): merge it into the open document now,
    * as a diff-update connected clients see as an ordinary edit. Without this the merge waits for the document's next store.
-   * No-op when nobody has the document open or the content version is unchanged; needs the adapter's `contentVersion`.
+   * No-op when nobody has the document open or the content version is unchanged; needs the documents port's `contentVersion`.
    */
   contentChanged(id: string): Promise<void>;
   /** Open collaboration connections and loaded documents of this server. */
@@ -59,7 +59,7 @@ export interface CollabServer {
 }
 /**
  * The editor's collaboration server, independent of any web framework: Hocuspocus with the editor's hooks (seeding from
- * the adapter's JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `adapter`.
+ * the stored JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `options.ports`.
  * `/nuxt` mounts one in Nitro; any Node/Bun/Deno process can serve `handleConnection` on its own websocket transport.
  */
 export declare function createCollabServer(options: CollabServerOptions): CollabServer;

package/dist/server/collab.js

@@ -4,9 +4,9 @@ import { migrateLegacyContent } from "../features/composites/legacy.js";
 import { advancedSchemaExtensions } from "../schema/advanced.js";
 import { decodeCollabState, encodeCollabState, isStateStale } from "./collab-state.js";
 import { getSchema } from "@tiptap/core";
+import * as Y from "yjs";
 import { Hocuspocus } from "@hocuspocus/server";
 import { prosemirrorToYDoc, prosemirrorToYXmlFragment, yDocToProsemirrorJSON, yXmlFragmentToProsemirror } from "@tiptap/y-tiptap";
-import * as Y from "yjs";
 //#region src/server/collab.ts
 /** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */
 const COLLAB_FIELD = "default";
@@ -23,44 +23,58 @@ function contentNode(schema, loaded) {
 	const node = schema.nodeFromJSON(content.type === "doc" && content.content?.length ? content : EMPTY_EDITOR_CONTENT);
 	return assignBlockIds(node) ?? node;
 }
+/** Whether a `document` Baustein of the stored Yjs content still carries the flat `meta.transcript` that `migrateLegacyContent` turns into a `rendition` child. */
+function hasFlatTranscript(fragment) {
+	return !fragment.createTreeWalker((node) => {
+		if (!(node instanceof Y.XmlElement) || node.nodeName !== "composite" || node.getAttribute("kind") !== "document") return false;
+		const meta = node.getAttribute("meta");
+		return typeof meta === "object" && meta !== null && "transcript" in meta && typeof meta.transcript === "string";
+	}).next().done;
+}
 /** Hocuspocus answers a thrown error's `reason` as permission-denied. */
 const denied = (message, reason) => Object.assign(new Error(message), { reason });
+/** The `collabState` port; the collaboration server cannot run without it. */
+function collabStateOf(ports) {
+	if (!ports.collabState) throw new Error("@ecsplico/editor: collaboration needs the collabState port");
+	return ports.collabState;
+}
 /**
 * The editor's collaboration server, independent of any web framework: Hocuspocus with the editor's hooks (seeding from
-* the adapter's JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `adapter`.
+* the stored JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `options.ports`.
 * `/nuxt` mounts one in Nitro; any Node/Bun/Deno process can serve `handleConnection` on its own websocket transport.
 */
 function createCollabServer(options) {
-	const { adapter } = options;
-	const authorize = (user, id) => options.hooks?.authorize ? options.hooks.authorize(user, id) : adapter.authorize?.(user, id);
-	const contentVersion = (id) => options.hooks?.contentVersion ? options.hooks.contentVersion(id) : adapter.contentVersion?.(id);
+	const { identity, documents } = options.ports;
+	const state = collabStateOf(options.ports);
+	const authorize = (user, id) => options.hooks?.authorize ? options.hooks.authorize(user, id) : identity.authorize?.(user, id);
+	const contentVersion = (id) => options.hooks?.contentVersion ? options.hooks.contentVersion(id) : documents.contentVersion?.(id);
 	let schema;
-	const collabSchema = () => schema ??= getSchema([...advancedSchemaExtensions(), ...(options.schemaExtensions ?? adapter.schemaExtensions?.bind(adapter))?.() ?? []]);
+	const collabSchema = () => schema ??= getSchema((options.schema ?? advancedSchemaExtensions)());
 	/** Loaded documents deleted via `forgetDocument`; a store still pending for them must not write their Yjs state back. */
 	const forgotten = /* @__PURE__ */ new Set();
-	/** `contentVersion` the loaded document's content mirror had when it was last read or written; only tracked for adapters with `contentVersion`. */
+	/** `contentVersion` the loaded document's content mirror had when it was last read or written; only tracked for documents ports with `contentVersion`. */
 	const loadedVersions = /* @__PURE__ */ new Map();
 	/** Resolvers of `close()` waiting for the last document to unload. */
 	const idle = [];
 	let closed = false;
 	/** Merges content rewritten behind the editor's back into the open document and stores its state against `version`. */
 	async function mergeRewrite(id, document, version) {
-		const rewritten = await adapter.loadContent(id);
+		const rewritten = await documents.loadContent(id);
 		if (!rewritten) return;
 		prosemirrorToYXmlFragment(contentNode(collabSchema(), rewritten), document.getXmlFragment(COLLAB_FIELD));
 		loadedVersions.set(id, version);
-		await adapter.storeState(id, encodeCollabState({
+		await state.storeState(id, encodeCollabState({
 			version,
 			update: Y.encodeStateAsUpdate(document)
 		}));
 	}
 	/** Stored state of a document, `null` when there is none usable: it was written against another content version and is removed. */
 	async function loadCurrentState(id, liveVersion) {
-		const payload = await adapter.loadState(id);
+		const payload = await state.loadState(id);
 		if (!payload) return null;
 		const { version, update } = decodeCollabState(payload);
 		if (isStateStale(version, liveVersion)) {
-			await adapter.removeState(id);
+			await state.removeState(id);
 			return null;
 		}
 		return update;
@@ -69,7 +83,7 @@ function createCollabServer(options) {
 		...options.configuration,
 		async onAuthenticate({ context, token, requestHeaders, documentName, connectionConfig }) {
 			let user = context.user;
-			if (!user) user = await adapter.authenticate({
+			if (!user) user = await identity.authenticate({
 				headers: requestHeaders,
 				...token && { token }
 			});
@@ -88,7 +102,7 @@ function createCollabServer(options) {
 			const version = await contentVersion(documentName);
 			const stored = await loadCurrentState(documentName, version);
 			if (version !== void 0) loadedVersions.set(documentName, version);
-			const persist = (doc) => adapter.storeState(documentName, encodeCollabState({
+			const persist = (doc) => state.storeState(documentName, encodeCollabState({
 				version: version ?? null,
 				update: Y.encodeStateAsUpdate(doc)
 			}));
@@ -97,7 +111,9 @@ function createCollabServer(options) {
 				Y.applyUpdate(doc, stored);
 				const fragment = doc.getXmlFragment(COLLAB_FIELD);
 				if (!!fragment.createTreeWalker((node) => node instanceof Y.XmlElement && node.nodeName === "section").next().done) {
-					const withIds = assignBlockIds(yXmlFragmentToProsemirror(currentSchema, fragment));
+					const current = yXmlFragmentToProsemirror(currentSchema, fragment);
+					const migrated = hasFlatTranscript(fragment) ? currentSchema.nodeFromJSON(migrateLegacyContent(current.toJSON())) : current;
+					const withIds = assignBlockIds(migrated) ?? (migrated === current ? null : migrated);
 					if (withIds) {
 						prosemirrorToYXmlFragment(withIds, fragment);
 						await persist(doc);
@@ -105,7 +121,7 @@ function createCollabServer(options) {
 					return doc;
 				}
 			}
-			const loaded = await adapter.loadContent(documentName);
+			const loaded = await documents.loadContent(documentName);
 			if (!loaded) throw new Error("Dokument nicht gefunden");
 			const seeded = prosemirrorToYDoc(contentNode(currentSchema, loaded), COLLAB_FIELD);
 			await persist(seeded);
@@ -119,10 +135,10 @@ function createCollabServer(options) {
 				await mergeRewrite(documentName, document, current);
 				return;
 			}
-			await adapter.storeContent(documentName, yDocToProsemirrorJSON(document, COLLAB_FIELD));
+			await documents.storeContent(documentName, yDocToProsemirrorJSON(document, COLLAB_FIELD));
 			const version = await contentVersion(documentName);
 			if (version !== void 0) loadedVersions.set(documentName, version);
-			await adapter.storeState(documentName, encodeCollabState({
+			await state.storeState(documentName, encodeCollabState({
 				version: version ?? null,
 				update: Y.encodeStateAsUpdate(document)
 			}));
@@ -151,7 +167,7 @@ function createCollabServer(options) {
 				doc.broadcastStateless("deleted");
 				hocuspocus.closeConnections(id);
 			}
-			await adapter.removeState(id);
+			await state.removeState(id);
 		},
 		liveContent(id) {
 			const doc = hocuspocus.documents.get(id);