@ecsplico/editor 3.4.0 → 3.5.1

package/dist/server/handlers/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","names":[],"sources":["../../../src/server/handlers/images.ts"],"sourcesContent":["import { z } from 'zod'\nimport type { ImageStudioGenerateBody } from '../../core/backend-types'\nimport { ASSET_DOCUMENT_ID, MAX_MEDIA_BYTES, mediaKindOf } from '../../features/media/schema'\nimport { HttpError } from '../errors'\nimport { authenticated, type HandlerContext, type HandlerRequest, type HandlerResponse, json, port, readBody } from './context'\n\n// The Bild-Studio's three routes over the `images` port: the host's Prompt-Bausteine, one generation, one reference upload.\n// The host's provider owns the prompt, the model and the storage; these handlers only authenticate, validate and pass through.\n\n/** The Prompt-Bausteine the host manages (`ImageStudioPromptBlock[]`). `501` without an `images` port. */\nexport async function imagePromptBlocksGet(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await authenticated(ctx, request)\n  return json(await port(ctx, 'images').promptBlocks(user))\n}\n\n/** Body schema of `imageGeneratePost`. */\nexport const imageGenerateBodySchema = z.object({\n  description: z.string().max(10_000),\n  instruction: z.string().max(4_000),\n  promptBlockIds: z.array(z.string().min(1).max(200)).max(50),\n  referenceUrls: z.array(z.string().min(1).max(2_048)).max(20),\n}) satisfies z.ZodType<ImageStudioGenerateBody>\n\n/** Generates one image for the body (`ImageStudioGenerateBody`); answers the stored `ImageStudioImage`. `400` for a malformed body, `501` without an `images` port. */\nexport async function imageGeneratePost(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await authenticated(ctx, request)\n  const images = port(ctx, 'images')\n  const body = await readBody(request, imageGenerateBodySchema)\n  return json(await images.generate(body, user))\n}\n\n/**\n * Stores a reference image: multipart fields `documentId` (the document it belongs to, or `scratch`) and `file` (an image);\n * answers the stored `ImageStudioImage`. `400` for a malformed `documentId` or a missing file, `413` for a file over the\n * image limit, `415` for a file that is no image, `501` without an `images` port.\n */\nexport async function imageUploadPost(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const user = await authenticated(ctx, request)\n  const images = port(ctx, 'images')\n  // A body that is no multipart form at all counts as „no file“.\n  const form = await request.readForm?.().catch(() => null)\n  const documentId = form?.get('documentId')\n  if (typeof documentId !== 'string' || !ASSET_DOCUMENT_ID.test(documentId)) throw new HttpError(400, 'Ungültige Dokument-ID')\n  const file = form?.get('file')\n  if (!(file instanceof File)) throw new HttpError(400, 'Keine Datei übermittelt')\n  if (mediaKindOf(file.type) !== 'image') throw new HttpError(415, 'Nur Bilddateien werden akzeptiert')\n  if (file.size > MAX_MEDIA_BYTES.image) throw new HttpError(413, `Datei ist größer als ${MAX_MEDIA_BYTES.image / 1024 / 1024} MB`)\n  return json(await images.upload(documentId, file, user))\n}\n"],"mappings":";;;;;;;AAUA,eAAsB,qBAAqB,KAAqB,SAAmD;CACjH,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,OAAO,KAAK,MAAM,KAAK,KAAK,QAAQ,CAAC,CAAC,aAAa,IAAI,CAAC;AAC1D;;AAGA,MAAa,0BAA0B,EAAE,OAAO;CAC9C,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,GAAM;CAClC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,GAAK;CACjC,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;CAC1D,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAK,CAAC,CAAC,CAAC,IAAI,EAAE;AAC7D,CAAC;;AAGD,eAAsB,kBAAkB,KAAqB,SAAmD;CAC9G,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,MAAM,SAAS,KAAK,KAAK,QAAQ;CACjC,MAAM,OAAO,MAAM,SAAS,SAAS,uBAAuB;CAC5D,OAAO,KAAK,MAAM,OAAO,SAAS,MAAM,IAAI,CAAC;AAC/C;;;;;;AAOA,eAAsB,gBAAgB,KAAqB,SAAmD;CAC5G,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,MAAM,SAAS,KAAK,KAAK,QAAQ;CAEjC,MAAM,OAAO,MAAM,QAAQ,WAAW,CAAC,CAAC,YAAY,IAAI;CACxD,MAAM,aAAa,MAAM,IAAI,YAAY;CACzC,IAAI,OAAO,eAAe,YAAY,CAAC,kBAAkB,KAAK,UAAU,GAAG,MAAM,IAAI,UAAU,KAAK,uBAAuB;CAC3H,MAAM,OAAO,MAAM,IAAI,MAAM;CAC7B,IAAI,EAAE,gBAAgB,OAAO,MAAM,IAAI,UAAU,KAAK,yBAAyB;CAC/E,IAAI,YAAY,KAAK,IAAI,MAAM,SAAS,MAAM,IAAI,UAAU,KAAK,mCAAmC;CACpG,IAAI,KAAK,OAAO,gBAAgB,OAAO,MAAM,IAAI,UAAU,KAAK,wBAAwB,gBAAgB,QAAQ,OAAO,KAAK,IAAI;CAChI,OAAO,KAAK,MAAM,OAAO,OAAO,YAAY,MAAM,IAAI,CAAC;AACzD"}

package/dist/server/handlers/index.d.ts

@@ -3,4 +3,5 @@ import { completeBodySchema } from "../../features/ai/protocol/complete.js";
 import { AiHandlerContext, HandlerContext, HandlerRequest, HandlerResponse, authenticated, empty, enforceRateLimit, eventStream, json, port, readBody, text } from "./context.js";
 import { chatBodySchema, chatPost, completePost, extractBodySchema, extractPost, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost } from "./ai.js";
 import { assetGet, assetPost, capabilitiesGet, listWorkspaceTags, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, themeDelete, themeGet, themePost, themesGet, usersGet } from "./editor.js";
-export { type AiHandlerContext, type HandlerContext, type HandlerRequest, type HandlerResponse, assetGet, assetPost, authenticated, capabilitiesGet, chatBodySchema, chatPost, completeBodySchema, completePost, empty, enforceRateLimit, eventStream, extractBodySchema, extractPost, generateBodySchema, generatePost, json, listWorkspaceTags, modelsGet, port, readBody, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, text, themeDelete, themeGet, themePost, themesGet, transcriptCleanupBodySchema, transcriptCleanupPost, usersGet };
+import { imageGenerateBodySchema, imageGeneratePost, imagePromptBlocksGet, imageUploadPost } from "./images.js";
+export { type AiHandlerContext, type HandlerContext, type HandlerRequest, type HandlerResponse, assetGet, assetPost, authenticated, capabilitiesGet, chatBodySchema, chatPost, completeBodySchema, completePost, empty, enforceRateLimit, eventStream, extractBodySchema, extractPost, generateBodySchema, generatePost, imageGenerateBodySchema, imageGeneratePost, imagePromptBlocksGet, imageUploadPost, json, listWorkspaceTags, modelsGet, port, readBody, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, text, themeDelete, themeGet, themePost, themesGet, transcriptCleanupBodySchema, transcriptCleanupPost, usersGet };

package/dist/server/handlers/index.js

@@ -3,4 +3,5 @@ import { generateBodySchema } from "../../features/ai/protocol/generate.js";
 import { authenticated, empty, enforceRateLimit, eventStream, json, port, readBody, text } from "./context.js";
 import { chatBodySchema, chatPost, completePost, extractBodySchema, extractPost, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost } from "./ai.js";
 import { assetGet, assetPost, capabilitiesGet, listWorkspaceTags, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, themeDelete, themeGet, themePost, themesGet, usersGet } from "./editor.js";
-export { assetGet, assetPost, authenticated, capabilitiesGet, chatBodySchema, chatPost, completeBodySchema, completePost, empty, enforceRateLimit, eventStream, extractBodySchema, extractPost, generateBodySchema, generatePost, json, listWorkspaceTags, modelsGet, port, readBody, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, text, themeDelete, themeGet, themePost, themesGet, transcriptCleanupBodySchema, transcriptCleanupPost, usersGet };
+import { imageGenerateBodySchema, imageGeneratePost, imagePromptBlocksGet, imageUploadPost } from "./images.js";
+export { assetGet, assetPost, authenticated, capabilitiesGet, chatBodySchema, chatPost, completeBodySchema, completePost, empty, enforceRateLimit, eventStream, extractBodySchema, extractPost, generateBodySchema, generatePost, imageGenerateBodySchema, imageGeneratePost, imagePromptBlocksGet, imageUploadPost, json, listWorkspaceTags, modelsGet, port, readBody, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, text, themeDelete, themeGet, themePost, themesGet, transcriptCleanupBodySchema, transcriptCleanupPost, usersGet };

package/dist/server/index.d.ts

@@ -3,9 +3,9 @@ import { AuthenticateRequest } from "./auth.js";
 import { ChatMessage } from "../features/ai/protocol/generate.js";
 import { HttpError } from "./errors.js";
 import { AiModels, AiModelsConfig, ChatTurnPart, createAiModels, streamChat, streamChatTurn, upstreamError } from "./ai.js";
-import { AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentStore, EditorPorts, Identity, ModelProvider, PORT_CAPABILITY, SettingsStore, ThemeStore, serverCapabilities } from "./ports.js";
+import { AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentStore, EditorPorts, Identity, ImageProvider, ModelProvider, PORT_CAPABILITY, SettingsStore, ThemeStore, serverCapabilities } from "./ports.js";
 import { COLLAB_FIELD, CollabConnection, CollabServer, CollabServerOptions, WebSocketLike, createCollabServer } from "./collab.js";
 import { decodeCollabState, encodeCollabState, isStateStale } from "./collab-state.js";
 import { RateLimiter, RateLimiterOptions, createRateLimiter, userKey } from "./rate-limit.js";
 import { closeEditorServer, collabContentChanged, collabStats, enforceAiRateLimit, forgetCollabDocument, listAiModels, liveContent, resolveModel, setEditorPorts, useAiModels, useCollabServer, useEditorPorts } from "./host.js";
-export { type AiModels, type AiModelsConfig, type AssetStore, type AuthenticateRequest, COLLAB_FIELD, type ChatMessage, type ChatTurnPart, type CollabConnection, type CollabServer, type CollabServerOptions, type CollabStateStore, type Directory, type DocumentAdmin, type DocumentStore, type EditorPorts, HttpError, type Identity, type ModelProvider, PORT_CAPABILITY, type PresetConfig, type RateLimiter, type RateLimiterOptions, type SettingsStore, type ThemeStore, type TranscriptionConfig, type WebSocketLike, closeEditorServer, collabContentChanged, collabStats, createAiModels, createCollabServer, createRateLimiter, decodeCollabState, encodeCollabState, enforceAiRateLimit, forgetCollabDocument, isStateStale, listAiModels, liveContent, resolveModel, serverCapabilities, setEditorPorts, streamChat, streamChatTurn, upstreamError, useAiModels, useCollabServer, useEditorPorts, userKey };
+export { type AiModels, type AiModelsConfig, type AssetStore, type AuthenticateRequest, COLLAB_FIELD, type ChatMessage, type ChatTurnPart, type CollabConnection, type CollabServer, type CollabServerOptions, type CollabStateStore, type Directory, type DocumentAdmin, type DocumentStore, type EditorPorts, HttpError, type Identity, type ImageProvider, type ModelProvider, PORT_CAPABILITY, type PresetConfig, type RateLimiter, type RateLimiterOptions, type SettingsStore, type ThemeStore, type TranscriptionConfig, type WebSocketLike, closeEditorServer, collabContentChanged, collabStats, createAiModels, createCollabServer, createRateLimiter, decodeCollabState, encodeCollabState, enforceAiRateLimit, forgetCollabDocument, isStateStale, listAiModels, liveContent, resolveModel, serverCapabilities, setEditorPorts, streamChat, streamChatTurn, upstreamError, useAiModels, useCollabServer, useEditorPorts, userKey };

package/dist/server/ports.d.ts

@@ -2,7 +2,7 @@ import { AssetRecord } from "../features/media/assets.js";
 import "../features/media/schema.js";
 import { EditorSettings } from "../settings/index.js";
 import { BackendCapability } from "../core/backend-capability.js";
-import { MentionUser, ModelProfile, ModelRef, ThemeRecord } from "../core/backend-types.js";
+import { ImageStudioGenerateBody, ImageStudioImage, ImageStudioPromptBlock, MentionUser, ModelProfile, ModelRef, ThemeRecord } from "../core/backend-types.js";
 import "../features/mentions/schema.js";
 import { AuthenticateRequest } from "./auth.js";
 import "../features/ai/protocol/index.js";
@@ -122,6 +122,15 @@ export interface ModelProvider {
    */
   listModels?(user: object | null): Promise<ModelProfile[] | null>;
 }
+/** The host's image generation for the Bild-Studio: its managed Prompt-Bausteine, the generator and the storage of uploaded references. Without this port the image routes answer 501. */
+export interface ImageProvider {
+  /** The Prompt-Bausteine the host manages, in the order it lists them (`GET /api/editor/images/prompt-blocks`). `user` is what `authenticate` returned. */
+  promptBlocks(user: object): Promise<ImageStudioPromptBlock[]>;
+  /** Generates one image and stores it (`POST /api/editor/images/generate`); resolves with the stored image (`active: false`). The host builds the prompt from `body`. */
+  generate(body: ImageStudioGenerateBody, user: object): Promise<ImageStudioImage>;
+  /** Stores an uploaded reference image of document `documentId` (`POST /api/editor/images/upload`); resolves with the stored image (`active: true`). */
+  upload(documentId: string, file: File, user: object): Promise<ImageStudioImage>;
+}
 /** Everything the editor's server reads from the host, one port per capability. Only `identity` and `documents` are required. */
 export interface EditorPorts {
   identity: Identity;
@@ -133,6 +142,7 @@ export interface EditorPorts {
   settings?: SettingsStore;
   themes?: ThemeStore;
   models?: ModelProvider;
+  images?: ImageProvider;
   /** Where the comment threads live (`adapters/comments/{json,drizzle}`). */
   comments?: CommentStore;
 }

package/dist/server/ports.js

@@ -8,7 +8,8 @@ const PORT_CAPABILITY = {
 	settings: "settings",
 	themes: "themes",
 	models: "ai",
-	comments: "comments"
+	comments: "comments",
+	images: "images"
 };
 /**
 * The capabilities `ports` serves: those of every present port, plus `tags` (derived from `documents.listContents`).

package/dist/server/ports.js.map

@@ -1 +1 @@
-{"version":3,"file":"ports.js","names":[],"sources":["../../src/server/ports.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { LanguageModel } from 'ai'\nimport type { CommentStore } from '../adapters/comments/types'\nimport type { BackendCapability } from '../core/backend-capability'\nimport type { ModelProfile, ModelRef } from '../features/ai/protocol'\nimport type { AssetRecord } from '../features/media/schema'\nimport type { MentionUser } from '../features/mentions/schema'\nimport type { ThemeRecord } from '../features/themes/schema'\nimport type { EditorSettings } from '../settings'\nimport type { AuthenticateRequest } from './auth'\n\n// The server side of the editor's backend, split by capability: a host (or an adapter) implements the ports it serves\n// and leaves the others out; routes and features that need an absent port answer 501.\n\n/** Who a request or websocket connection belongs to, and which documents that user may open. */\nexport interface Identity {\n  /**\n   * The user behind a request, `null` = not authenticated (HTTP routes answer 401). Collaboration: called in Hocuspocus\n   * `onAuthenticate` with the upgrade request's `headers` and the client's `token` (`undefined` when it sent none, so cookie\n   * hosts keep working and bearer-only hosts read `token`); `null` closes the connection with 4401. With the Nuxt module\n   * option `collab.authenticateUpgrade` it runs once at the upgrade with the `headers` only and `null` refuses the upgrade\n   * with HTTP 401. The value becomes the connection context's `user`.\n   */\n  authenticate(request: AuthenticateRequest): Promise<object | null>\n  /**\n   * Per-document access for the collaboration websocket, called in Hocuspocus `onAuthenticate` (right after `authenticate`) with the user.\n   * `null` rejects the connection; `{ readOnly: true }` lets it sync but applies none of its edits. Omit it to let every\n   * authenticated user edit every document.\n   */\n  authorize?(user: object, id: string): Promise<{ readOnly: boolean } | null>\n}\n\n/** The stored TipTap JSON of the workspace's documents. */\nexport interface DocumentStore {\n  /** TipTap JSON to seed a document's Y.Doc from; `null` = the document does not exist. */\n  loadContent(id: string): Promise<JSONContent | null>\n  /** Mirror of the current Yjs state, called debounced after edits and on shutdown. Must tolerate ids deleted meanwhile. */\n  storeContent(id: string, content: JSONContent): Promise<void>\n  /**\n   * Opaque version of the stored content of a document (mtime, hash, revision), `null` = unknown, no NUL. The collab server\n   * keeps it next to the Yjs state. When it differs from the live version (the content changed behind the editor's back) the\n   * state is discarded on load, removed through `removeState` and the document is re-seeded from `loadContent`. A document\n   * that is open when its version moves is not written back: the next store merges the new `loadContent` into the open\n   * Y.Doc. The version is read right after every `storeContent`, so it must reflect what the editor itself just wrote.\n   * Omit it to never discard state.\n   */\n  contentVersion?(id: string): Promise<string | null>\n  /** Stored TipTap JSON of every document in the workspace, e.g. to collect the `#` tags in use (`GET /api/editor/tags`). */\n  listContents(): Promise<{ id: string, content: JSONContent }[]>\n}\n\n/** Document management a host needs next to the editor's own storage methods: `DocumentStore.storeContent` only updates. */\nexport interface DocumentAdmin {\n  /** Creates the document or replaces its content; the content version changes. */\n  putDocument(id: string, content: JSONContent): Promise<void>\n  /** Removes the content, the Yjs state and the assets of a document; unknown ids are fine. Call `forgetCollabDocument(id)` first when it may be open. */\n  deleteDocument(id: string): Promise<void>\n  /** Ids of all stored documents. */\n  listDocumentIds(): Promise<string[]>\n}\n\n/** Where the collaboration server keeps the Yjs state of open documents. */\nexport interface CollabStateStore {\n  /** The bytes `storeState` stored (opaque to the host: the Yjs update behind a content-version prefix; state stored by earlier releases is a raw update and still loads); `null` = none yet (the Y.Doc is then seeded from `loadContent`). */\n  loadState(id: string): Promise<Uint8Array | null>\n  /** Persists the state bytes unchanged; called on every store and when block IDs were backfilled. Must tolerate ids deleted meanwhile. */\n  storeState(id: string, state: Uint8Array): Promise<void>\n  /** Drops the Yjs state of a deleted document (the next load re-seeds from `loadContent`). */\n  removeState(id: string): Promise<void>\n}\n\n/** The users that can be `@`-mentioned. */\nexport interface Directory {\n  /** All users that can be `@`-mentioned (served by `GET /api/editor/users`); must not include credentials. */\n  listUsers(): Promise<MentionUser[]>\n}\n\n/** Uploaded files. */\nexport interface AssetStore {\n  /** Stores an uploaded file (`GET /api/editor/assets/:id/:name` serves it). `id` is a document id or `SCRATCH_DOCUMENT_ID`; it may name no existing document. */\n  storeAsset(id: string, asset: AssetRecord & { data: Buffer }): Promise<void>\n  /** A stored file with its record; `null` = unknown id or name. */\n  loadAsset(id: string, name: string): Promise<{ record: AssetRecord, data: Buffer } | null>\n}\n\n/** Per-user editor settings. Without this port the client keeps settings in localStorage only. */\nexport interface SettingsStore {\n  /** Per-user editor settings as stored (`null` = none yet), validated by `GET /api/editor/settings`. */\n  loadSettings(user: object): Promise<unknown | null>\n  /** Stores validated settings for the user from `authenticate`. */\n  storeSettings(user: object, settings: EditorSettings): Promise<void>\n}\n\n/** The theme library shared by all users. Without this port the themes feature is uninstalled: its routes answer 501. */\nexport interface ThemeStore {\n  /** All themes (`GET /api/editor/themes`). */\n  listThemes(): Promise<ThemeRecord[]>\n  /** A theme's record and `theme.css` (`GET /api/editor/themes/:id`); `null` = unknown id. */\n  loadTheme(id: string): Promise<{ record: ThemeRecord, css: string } | null>\n  /** Stores an uploaded theme (`POST /api/editor/themes`). */\n  storeTheme(record: Omit<ThemeRecord, 'builtin'>, css: string): Promise<void>\n  /** Deletes an uploaded theme (`DELETE /api/editor/themes/:id`); `false` = not found or builtin. */\n  removeTheme(id: string): Promise<boolean>\n}\n\n/** The host's own language models for the AI endpoints; both members fall through to the runtime-config presets. */\nexport interface ModelProvider {\n  /**\n   * The language model for `ref`, so the AI endpoints use the host's own providers; consulted before the runtime-config\n   * presets for every model reference. `user` is what `authenticate` returned. `null` falls through to the presets\n   * (and answers 400 for a preset that is not configured either).\n   */\n  languageModel?(ref: ModelRef, user: object | null): Promise<LanguageModel | null>\n  /**\n   * The models `GET /api/ai/models` lists for `user`, instead of the runtime-config presets (list them with\n   * `source: 'preset'` and the `id` that `languageModel` receives as `{ preset: id }`). `null` (or omitting the method)\n   * lists the presets.\n   */\n  listModels?(user: object | null): Promise<ModelProfile[] | null>\n}\n\n/** Everything the editor's server reads from the host, one port per capability. Only `identity` and `documents` are required. */\nexport interface EditorPorts {\n  identity: Identity\n  documents: DocumentStore & Partial<DocumentAdmin>\n  /** Required by the collaboration server. */\n  collabState?: CollabStateStore\n  directory?: Directory\n  assets?: AssetStore\n  settings?: SettingsStore\n  themes?: ThemeStore\n  models?: ModelProvider\n  /** Where the comment threads live (`adapters/comments/{json,drizzle}`). */\n  comments?: CommentStore\n}\n\n/** The capability each optional port provides; `identity` is no capability, `tags` derive from `documents` (see `serverCapabilities`). */\nexport const PORT_CAPABILITY: Record<Exclude<keyof EditorPorts, 'identity'>, BackendCapability> = {\n  documents: 'documents',\n  collabState: 'collaboration',\n  directory: 'users',\n  assets: 'assets',\n  settings: 'settings',\n  themes: 'themes',\n  models: 'ai',\n  comments: 'comments',\n}\n\n/**\n * The capabilities `ports` serves: those of every present port, plus `tags` (derived from `documents.listContents`).\n * Two capabilities depend on more than a port: `ai` (the AI routes need configured models) and `collaboration` (the\n * websocket needs the collab server). `served` states what the installed server really mounts and overrides the port-based\n * answer for them; omitted keys follow the ports.\n */\nexport function serverCapabilities(ports: EditorPorts, served: { ai?: boolean, collaboration?: boolean } = {}): BackendCapability[] {\n  const capabilities = new Set<BackendCapability>(\n    (Object.keys(PORT_CAPABILITY) as (keyof typeof PORT_CAPABILITY)[])\n      .filter(port => ports[port] !== undefined)\n      .map(port => PORT_CAPABILITY[port]),\n  )\n  for (const capability of ['ai', 'collaboration'] as const) {\n    if (served[capability] === true) capabilities.add(capability)\n    else if (served[capability] === false) capabilities.delete(capability)\n  }\n  if (ports.documents) capabilities.add('tags')\n  return [...capabilities]\n}\n"],"mappings":";;AAyIA,MAAa,kBAAqF;CAChG,WAAW;CACX,aAAa;CACb,WAAW;CACX,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,UAAU;AACZ;;;;;;;AAQA,SAAgB,mBAAmB,OAAoB,SAAoD,CAAC,GAAwB;CAClI,MAAM,eAAe,IAAI,IACtB,OAAO,KAAK,eAAe,CAAC,CAC1B,QAAO,SAAQ,MAAM,UAAU,KAAA,CAAS,CAAC,CACzC,KAAI,SAAQ,gBAAgB,KAAK,CACtC;CACA,KAAK,MAAM,cAAc,CAAC,MAAM,eAAe,GAC7C,IAAI,OAAO,gBAAgB,MAAM,aAAa,IAAI,UAAU;MACvD,IAAI,OAAO,gBAAgB,OAAO,aAAa,OAAO,UAAU;CAEvE,IAAI,MAAM,WAAW,aAAa,IAAI,MAAM;CAC5C,OAAO,CAAC,GAAG,YAAY;AACzB"}
+{"version":3,"file":"ports.js","names":[],"sources":["../../src/server/ports.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { LanguageModel } from 'ai'\nimport type { CommentStore } from '../adapters/comments/types'\nimport type { BackendCapability } from '../core/backend-capability'\nimport type { ImageStudioGenerateBody, ImageStudioImage, ImageStudioPromptBlock } from '../core/backend-types'\nimport type { ModelProfile, ModelRef } from '../features/ai/protocol'\nimport type { AssetRecord } from '../features/media/schema'\nimport type { MentionUser } from '../features/mentions/schema'\nimport type { ThemeRecord } from '../features/themes/schema'\nimport type { EditorSettings } from '../settings'\nimport type { AuthenticateRequest } from './auth'\n\n// The server side of the editor's backend, split by capability: a host (or an adapter) implements the ports it serves\n// and leaves the others out; routes and features that need an absent port answer 501.\n\n/** Who a request or websocket connection belongs to, and which documents that user may open. */\nexport interface Identity {\n  /**\n   * The user behind a request, `null` = not authenticated (HTTP routes answer 401). Collaboration: called in Hocuspocus\n   * `onAuthenticate` with the upgrade request's `headers` and the client's `token` (`undefined` when it sent none, so cookie\n   * hosts keep working and bearer-only hosts read `token`); `null` closes the connection with 4401. With the Nuxt module\n   * option `collab.authenticateUpgrade` it runs once at the upgrade with the `headers` only and `null` refuses the upgrade\n   * with HTTP 401. The value becomes the connection context's `user`.\n   */\n  authenticate(request: AuthenticateRequest): Promise<object | null>\n  /**\n   * Per-document access for the collaboration websocket, called in Hocuspocus `onAuthenticate` (right after `authenticate`) with the user.\n   * `null` rejects the connection; `{ readOnly: true }` lets it sync but applies none of its edits. Omit it to let every\n   * authenticated user edit every document.\n   */\n  authorize?(user: object, id: string): Promise<{ readOnly: boolean } | null>\n}\n\n/** The stored TipTap JSON of the workspace's documents. */\nexport interface DocumentStore {\n  /** TipTap JSON to seed a document's Y.Doc from; `null` = the document does not exist. */\n  loadContent(id: string): Promise<JSONContent | null>\n  /** Mirror of the current Yjs state, called debounced after edits and on shutdown. Must tolerate ids deleted meanwhile. */\n  storeContent(id: string, content: JSONContent): Promise<void>\n  /**\n   * Opaque version of the stored content of a document (mtime, hash, revision), `null` = unknown, no NUL. The collab server\n   * keeps it next to the Yjs state. When it differs from the live version (the content changed behind the editor's back) the\n   * state is discarded on load, removed through `removeState` and the document is re-seeded from `loadContent`. A document\n   * that is open when its version moves is not written back: the next store merges the new `loadContent` into the open\n   * Y.Doc. The version is read right after every `storeContent`, so it must reflect what the editor itself just wrote.\n   * Omit it to never discard state.\n   */\n  contentVersion?(id: string): Promise<string | null>\n  /** Stored TipTap JSON of every document in the workspace, e.g. to collect the `#` tags in use (`GET /api/editor/tags`). */\n  listContents(): Promise<{ id: string, content: JSONContent }[]>\n}\n\n/** Document management a host needs next to the editor's own storage methods: `DocumentStore.storeContent` only updates. */\nexport interface DocumentAdmin {\n  /** Creates the document or replaces its content; the content version changes. */\n  putDocument(id: string, content: JSONContent): Promise<void>\n  /** Removes the content, the Yjs state and the assets of a document; unknown ids are fine. Call `forgetCollabDocument(id)` first when it may be open. */\n  deleteDocument(id: string): Promise<void>\n  /** Ids of all stored documents. */\n  listDocumentIds(): Promise<string[]>\n}\n\n/** Where the collaboration server keeps the Yjs state of open documents. */\nexport interface CollabStateStore {\n  /** The bytes `storeState` stored (opaque to the host: the Yjs update behind a content-version prefix; state stored by earlier releases is a raw update and still loads); `null` = none yet (the Y.Doc is then seeded from `loadContent`). */\n  loadState(id: string): Promise<Uint8Array | null>\n  /** Persists the state bytes unchanged; called on every store and when block IDs were backfilled. Must tolerate ids deleted meanwhile. */\n  storeState(id: string, state: Uint8Array): Promise<void>\n  /** Drops the Yjs state of a deleted document (the next load re-seeds from `loadContent`). */\n  removeState(id: string): Promise<void>\n}\n\n/** The users that can be `@`-mentioned. */\nexport interface Directory {\n  /** All users that can be `@`-mentioned (served by `GET /api/editor/users`); must not include credentials. */\n  listUsers(): Promise<MentionUser[]>\n}\n\n/** Uploaded files. */\nexport interface AssetStore {\n  /** Stores an uploaded file (`GET /api/editor/assets/:id/:name` serves it). `id` is a document id or `SCRATCH_DOCUMENT_ID`; it may name no existing document. */\n  storeAsset(id: string, asset: AssetRecord & { data: Buffer }): Promise<void>\n  /** A stored file with its record; `null` = unknown id or name. */\n  loadAsset(id: string, name: string): Promise<{ record: AssetRecord, data: Buffer } | null>\n}\n\n/** Per-user editor settings. Without this port the client keeps settings in localStorage only. */\nexport interface SettingsStore {\n  /** Per-user editor settings as stored (`null` = none yet), validated by `GET /api/editor/settings`. */\n  loadSettings(user: object): Promise<unknown | null>\n  /** Stores validated settings for the user from `authenticate`. */\n  storeSettings(user: object, settings: EditorSettings): Promise<void>\n}\n\n/** The theme library shared by all users. Without this port the themes feature is uninstalled: its routes answer 501. */\nexport interface ThemeStore {\n  /** All themes (`GET /api/editor/themes`). */\n  listThemes(): Promise<ThemeRecord[]>\n  /** A theme's record and `theme.css` (`GET /api/editor/themes/:id`); `null` = unknown id. */\n  loadTheme(id: string): Promise<{ record: ThemeRecord, css: string } | null>\n  /** Stores an uploaded theme (`POST /api/editor/themes`). */\n  storeTheme(record: Omit<ThemeRecord, 'builtin'>, css: string): Promise<void>\n  /** Deletes an uploaded theme (`DELETE /api/editor/themes/:id`); `false` = not found or builtin. */\n  removeTheme(id: string): Promise<boolean>\n}\n\n/** The host's own language models for the AI endpoints; both members fall through to the runtime-config presets. */\nexport interface ModelProvider {\n  /**\n   * The language model for `ref`, so the AI endpoints use the host's own providers; consulted before the runtime-config\n   * presets for every model reference. `user` is what `authenticate` returned. `null` falls through to the presets\n   * (and answers 400 for a preset that is not configured either).\n   */\n  languageModel?(ref: ModelRef, user: object | null): Promise<LanguageModel | null>\n  /**\n   * The models `GET /api/ai/models` lists for `user`, instead of the runtime-config presets (list them with\n   * `source: 'preset'` and the `id` that `languageModel` receives as `{ preset: id }`). `null` (or omitting the method)\n   * lists the presets.\n   */\n  listModels?(user: object | null): Promise<ModelProfile[] | null>\n}\n\n/** The host's image generation for the Bild-Studio: its managed Prompt-Bausteine, the generator and the storage of uploaded references. Without this port the image routes answer 501. */\nexport interface ImageProvider {\n  /** The Prompt-Bausteine the host manages, in the order it lists them (`GET /api/editor/images/prompt-blocks`). `user` is what `authenticate` returned. */\n  promptBlocks(user: object): Promise<ImageStudioPromptBlock[]>\n  /** Generates one image and stores it (`POST /api/editor/images/generate`); resolves with the stored image (`active: false`). The host builds the prompt from `body`. */\n  generate(body: ImageStudioGenerateBody, user: object): Promise<ImageStudioImage>\n  /** Stores an uploaded reference image of document `documentId` (`POST /api/editor/images/upload`); resolves with the stored image (`active: true`). */\n  upload(documentId: string, file: File, user: object): Promise<ImageStudioImage>\n}\n\n/** Everything the editor's server reads from the host, one port per capability. Only `identity` and `documents` are required. */\nexport interface EditorPorts {\n  identity: Identity\n  documents: DocumentStore & Partial<DocumentAdmin>\n  /** Required by the collaboration server. */\n  collabState?: CollabStateStore\n  directory?: Directory\n  assets?: AssetStore\n  settings?: SettingsStore\n  themes?: ThemeStore\n  models?: ModelProvider\n  images?: ImageProvider\n  /** Where the comment threads live (`adapters/comments/{json,drizzle}`). */\n  comments?: CommentStore\n}\n\n/** The capability each optional port provides; `identity` is no capability, `tags` derive from `documents` (see `serverCapabilities`). */\nexport const PORT_CAPABILITY: Record<Exclude<keyof EditorPorts, 'identity'>, BackendCapability> = {\n  documents: 'documents',\n  collabState: 'collaboration',\n  directory: 'users',\n  assets: 'assets',\n  settings: 'settings',\n  themes: 'themes',\n  models: 'ai',\n  comments: 'comments',\n  images: 'images',\n}\n\n/**\n * The capabilities `ports` serves: those of every present port, plus `tags` (derived from `documents.listContents`).\n * Two capabilities depend on more than a port: `ai` (the AI routes need configured models) and `collaboration` (the\n * websocket needs the collab server). `served` states what the installed server really mounts and overrides the port-based\n * answer for them; omitted keys follow the ports.\n */\nexport function serverCapabilities(ports: EditorPorts, served: { ai?: boolean, collaboration?: boolean } = {}): BackendCapability[] {\n  const capabilities = new Set<BackendCapability>(\n    (Object.keys(PORT_CAPABILITY) as (keyof typeof PORT_CAPABILITY)[])\n      .filter(port => ports[port] !== undefined)\n      .map(port => PORT_CAPABILITY[port]),\n  )\n  for (const capability of ['ai', 'collaboration'] as const) {\n    if (served[capability] === true) capabilities.add(capability)\n    else if (served[capability] === false) capabilities.delete(capability)\n  }\n  if (ports.documents) capabilities.add('tags')\n  return [...capabilities]\n}\n"],"mappings":";;AAqJA,MAAa,kBAAqF;CAChG,WAAW;CACX,aAAa;CACb,WAAW;CACX,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,QAAQ;AACV;;;;;;;AAQA,SAAgB,mBAAmB,OAAoB,SAAoD,CAAC,GAAwB;CAClI,MAAM,eAAe,IAAI,IACtB,OAAO,KAAK,eAAe,CAAC,CAC1B,QAAO,SAAQ,MAAM,UAAU,KAAA,CAAS,CAAC,CACzC,KAAI,SAAQ,gBAAgB,KAAK,CACtC;CACA,KAAK,MAAM,cAAc,CAAC,MAAM,eAAe,GAC7C,IAAI,OAAO,gBAAgB,MAAM,aAAa,IAAI,UAAU;MACvD,IAAI,OAAO,gBAAgB,OAAO,aAAa,OAAO,UAAU;CAEvE,IAAI,MAAM,WAAW,aAAa,IAAI,MAAM;CAC5C,OAAO,CAAC,GAAG,YAAY;AACzB"}

package/dist/server/routes.js

@@ -1,6 +1,7 @@
 import { AI_API, CAPABILITIES_ROUTE, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API } from "../core/api-routes.js";
 import { chatPost, completePost, extractPost, generatePost, modelsGet, transcriptCleanupPost } from "./handlers/ai.js";
 import { assetGet, assetPost, capabilitiesGet, settingsGet, settingsPut, tagsGet, themeDelete, themeGet, themePost, themesGet, usersGet } from "./handlers/editor.js";
+import { imageGeneratePost, imagePromptBlocksGet, imageUploadPost } from "./handlers/images.js";
 import { commentsGet, commentsPost, documentGet, documentPut } from "../adapters/documents.js";
 //#region src/server/routes.ts
 const ROUTES = [
@@ -46,6 +47,24 @@ const ROUTES = [
 		port: "assets",
 		handler: assetGet
 	},
+	{
+		method: "get",
+		path: `${EDITOR_API}/images/prompt-blocks`,
+		port: "images",
+		handler: imagePromptBlocksGet
+	},
+	{
+		method: "post",
+		path: `${EDITOR_API}/images/generate`,
+		port: "images",
+		handler: imageGeneratePost
+	},
+	{
+		method: "post",
+		path: `${EDITOR_API}/images/upload`,
+		port: "images",
+		handler: imageUploadPost
+	},
 	{
 		method: "get",
 		path: `${EDITOR_API}/themes`,

package/dist/server/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","names":[],"sources":["../../src/server/routes.ts"],"sourcesContent":["import { commentsGet, commentsPost, documentGet, documentPut } from '../adapters/documents'\nimport { AI_API, CAPABILITIES_ROUTE, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API } from '../core/api-routes'\nimport type { RouteHandler } from './h3'\nimport {\n  type AiHandlerContext,\n  assetGet,\n  assetPost,\n  capabilitiesGet,\n  chatPost,\n  completePost,\n  extractPost,\n  generatePost,\n  type HandlerContext,\n  modelsGet,\n  settingsGet,\n  settingsPut,\n  tagsGet,\n  themeDelete,\n  themeGet,\n  themePost,\n  themesGet,\n  transcriptCleanupPost,\n  usersGet,\n} from './handlers'\nimport type { EditorPorts } from './ports'\n\n// The one HTTP route table of the editor backend: what each route needs (a port, or the AI models), and its handler.\n// `serverRoutesOf` keeps the routes the host's ports can serve; `installEditorServer` (`./server/nitro`) mounts them on\n// a Nitro app, the Nuxt module through its server plugin. Paths are the constants of `core/api-routes.ts`.\n\ntype Method = 'get' | 'put' | 'post' | 'delete'\n/** A port other than `identity`, which every route needs and none is gated on. */\ntype RoutePort = Exclude<keyof EditorPorts, 'identity'>\n\nexport type RouteDef =\n  | { method: Method, path: string, port: RoutePort, handler: RouteHandler<HandlerContext> }\n  | { method: Method, path: string, port: 'ai', handler: RouteHandler<AiHandlerContext> }\n\nconst ROUTES: readonly RouteDef[] = [\n  // What the server serves: `documents` is required, so this route is always there.\n  { method: 'get', path: CAPABILITIES_ROUTE, port: 'documents', handler: capabilitiesGet },\n  { method: 'get', path: `${EDITOR_API}/settings`, port: 'settings', handler: settingsGet },\n  { method: 'put', path: `${EDITOR_API}/settings`, port: 'settings', handler: settingsPut },\n  { method: 'get', path: `${EDITOR_API}/users`, port: 'directory', handler: usersGet },\n  // Tags derive from the contents the documents port lists.\n  { method: 'get', path: `${EDITOR_API}/tags`, port: 'documents', handler: tagsGet },\n  { method: 'post', path: `${EDITOR_API}/assets/:id`, port: 'assets', handler: assetPost },\n  { method: 'get', path: `${EDITOR_API}/assets/:id/:name`, port: 'assets', handler: assetGet },\n  { method: 'get', path: `${EDITOR_API}/themes`, port: 'themes', handler: themesGet },\n  { method: 'post', path: `${EDITOR_API}/themes`, port: 'themes', handler: themePost },\n  { method: 'get', path: `${EDITOR_API}/themes/:id`, port: 'themes', handler: themeGet },\n  { method: 'delete', path: `${EDITOR_API}/themes/:id`, port: 'themes', handler: themeDelete },\n  { method: 'get', path: DOCUMENT_ROUTE, port: 'documents', handler: documentGet },\n  { method: 'put', path: DOCUMENT_ROUTE, port: 'documents', handler: documentPut },\n  { method: 'get', path: COMMENTS_ROUTE, port: 'comments', handler: commentsGet },\n  { method: 'post', path: COMMENTS_ROUTE, port: 'comments', handler: commentsPost },\n  { method: 'get', path: `${AI_API}/models`, port: 'ai', handler: modelsGet },\n  { method: 'post', path: `${AI_API}/chat`, port: 'ai', handler: chatPost },\n  { method: 'post', path: `${AI_API}/complete`, port: 'ai', handler: completePost },\n  { method: 'post', path: `${AI_API}/generate`, port: 'ai', handler: generatePost },\n  { method: 'post', path: `${AI_API}/extract`, port: 'ai', handler: extractPost },\n  { method: 'post', path: `${AI_API}/transcript-cleanup`, port: 'ai', handler: transcriptCleanupPost },\n]\n\n/**\n * The routes `ports` can serve. A route is served iff its port is present (`documents` is required, so its routes always\n * are); the AI routes (`port: 'ai'`) iff `options.ai`, the host having configured the AI models.\n */\nexport function serverRoutesOf(ports: EditorPorts, options: { ai: boolean }): RouteDef[] {\n  return ROUTES.filter(route => route.port === 'ai' ? options.ai : ports[route.port] !== undefined)\n}\n"],"mappings":";;;;;AAsCA,MAAM,SAA8B;CAElC;EAAE,QAAQ;EAAO,MAAM;EAAoB,MAAM;EAAa,SAAS;CAAgB;CACvF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAY,MAAM;EAAY,SAAS;CAAY;CACxF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAY,MAAM;EAAY,SAAS;CAAY;CACxF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAS,MAAM;EAAa,SAAS;CAAS;CAEnF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAQ,MAAM;EAAa,SAAS;CAAQ;CACjF;EAAE,QAAQ;EAAQ,MAAM,GAAG,WAAW;EAAc,MAAM;EAAU,SAAS;CAAU;CACvF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAoB,MAAM;EAAU,SAAS;CAAS;CAC3F;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAU,MAAM;EAAU,SAAS;CAAU;CAClF;EAAE,QAAQ;EAAQ,MAAM,GAAG,WAAW;EAAU,MAAM;EAAU,SAAS;CAAU;CACnF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAc,MAAM;EAAU,SAAS;CAAS;CACrF;EAAE,QAAQ;EAAU,MAAM,GAAG,WAAW;EAAc,MAAM;EAAU,SAAS;CAAY;CAC3F;EAAE,QAAQ;EAAO,MAAM;EAAgB,MAAM;EAAa,SAAS;CAAY;CAC/E;EAAE,QAAQ;EAAO,MAAM;EAAgB,MAAM;EAAa,SAAS;CAAY;CAC/E;EAAE,QAAQ;EAAO,MAAM;EAAgB,MAAM;EAAY,SAAS;CAAY;CAC9E;EAAE,QAAQ;EAAQ,MAAM;EAAgB,MAAM;EAAY,SAAS;CAAa;CAChF;EAAE,QAAQ;EAAO,MAAM,GAAG,OAAO;EAAU,MAAM;EAAM,SAAS;CAAU;CAC1E;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAQ,MAAM;EAAM,SAAS;CAAS;CACxE;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAY,MAAM;EAAM,SAAS;CAAa;CAChF;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAY,MAAM;EAAM,SAAS;CAAa;CAChF;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAW,MAAM;EAAM,SAAS;CAAY;CAC9E;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAsB,MAAM;EAAM,SAAS;CAAsB;AACrG;;;;;AAMA,SAAgB,eAAe,OAAoB,SAAsC;CACvF,OAAO,OAAO,QAAO,UAAS,MAAM,SAAS,OAAO,QAAQ,KAAK,MAAM,MAAM,UAAU,KAAA,CAAS;AAClG"}
+{"version":3,"file":"routes.js","names":[],"sources":["../../src/server/routes.ts"],"sourcesContent":["import { commentsGet, commentsPost, documentGet, documentPut } from '../adapters/documents'\nimport { AI_API, CAPABILITIES_ROUTE, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API } from '../core/api-routes'\nimport type { RouteHandler } from './h3'\nimport {\n  type AiHandlerContext,\n  assetGet,\n  assetPost,\n  capabilitiesGet,\n  chatPost,\n  completePost,\n  extractPost,\n  generatePost,\n  type HandlerContext,\n  imageGeneratePost,\n  imagePromptBlocksGet,\n  imageUploadPost,\n  modelsGet,\n  settingsGet,\n  settingsPut,\n  tagsGet,\n  themeDelete,\n  themeGet,\n  themePost,\n  themesGet,\n  transcriptCleanupPost,\n  usersGet,\n} from './handlers'\nimport type { EditorPorts } from './ports'\n\n// The one HTTP route table of the editor backend: what each route needs (a port, or the AI models), and its handler.\n// `serverRoutesOf` keeps the routes the host's ports can serve; `installEditorServer` (`./server/nitro`) mounts them on\n// a Nitro app, the Nuxt module through its server plugin. Paths are the constants of `core/api-routes.ts`.\n\ntype Method = 'get' | 'put' | 'post' | 'delete'\n/** A port other than `identity`, which every route needs and none is gated on. */\ntype RoutePort = Exclude<keyof EditorPorts, 'identity'>\n\nexport type RouteDef =\n  | { method: Method, path: string, port: RoutePort, handler: RouteHandler<HandlerContext> }\n  | { method: Method, path: string, port: 'ai', handler: RouteHandler<AiHandlerContext> }\n\nconst ROUTES: readonly RouteDef[] = [\n  // What the server serves: `documents` is required, so this route is always there.\n  { method: 'get', path: CAPABILITIES_ROUTE, port: 'documents', handler: capabilitiesGet },\n  { method: 'get', path: `${EDITOR_API}/settings`, port: 'settings', handler: settingsGet },\n  { method: 'put', path: `${EDITOR_API}/settings`, port: 'settings', handler: settingsPut },\n  { method: 'get', path: `${EDITOR_API}/users`, port: 'directory', handler: usersGet },\n  // Tags derive from the contents the documents port lists.\n  { method: 'get', path: `${EDITOR_API}/tags`, port: 'documents', handler: tagsGet },\n  { method: 'post', path: `${EDITOR_API}/assets/:id`, port: 'assets', handler: assetPost },\n  { method: 'get', path: `${EDITOR_API}/assets/:id/:name`, port: 'assets', handler: assetGet },\n  { method: 'get', path: `${EDITOR_API}/images/prompt-blocks`, port: 'images', handler: imagePromptBlocksGet },\n  { method: 'post', path: `${EDITOR_API}/images/generate`, port: 'images', handler: imageGeneratePost },\n  { method: 'post', path: `${EDITOR_API}/images/upload`, port: 'images', handler: imageUploadPost },\n  { method: 'get', path: `${EDITOR_API}/themes`, port: 'themes', handler: themesGet },\n  { method: 'post', path: `${EDITOR_API}/themes`, port: 'themes', handler: themePost },\n  { method: 'get', path: `${EDITOR_API}/themes/:id`, port: 'themes', handler: themeGet },\n  { method: 'delete', path: `${EDITOR_API}/themes/:id`, port: 'themes', handler: themeDelete },\n  { method: 'get', path: DOCUMENT_ROUTE, port: 'documents', handler: documentGet },\n  { method: 'put', path: DOCUMENT_ROUTE, port: 'documents', handler: documentPut },\n  { method: 'get', path: COMMENTS_ROUTE, port: 'comments', handler: commentsGet },\n  { method: 'post', path: COMMENTS_ROUTE, port: 'comments', handler: commentsPost },\n  { method: 'get', path: `${AI_API}/models`, port: 'ai', handler: modelsGet },\n  { method: 'post', path: `${AI_API}/chat`, port: 'ai', handler: chatPost },\n  { method: 'post', path: `${AI_API}/complete`, port: 'ai', handler: completePost },\n  { method: 'post', path: `${AI_API}/generate`, port: 'ai', handler: generatePost },\n  { method: 'post', path: `${AI_API}/extract`, port: 'ai', handler: extractPost },\n  { method: 'post', path: `${AI_API}/transcript-cleanup`, port: 'ai', handler: transcriptCleanupPost },\n]\n\n/**\n * The routes `ports` can serve. A route is served iff its port is present (`documents` is required, so its routes always\n * are); the AI routes (`port: 'ai'`) iff `options.ai`, the host having configured the AI models.\n */\nexport function serverRoutesOf(ports: EditorPorts, options: { ai: boolean }): RouteDef[] {\n  return ROUTES.filter(route => route.port === 'ai' ? options.ai : ports[route.port] !== undefined)\n}\n"],"mappings":";;;;;;AAyCA,MAAM,SAA8B;CAElC;EAAE,QAAQ;EAAO,MAAM;EAAoB,MAAM;EAAa,SAAS;CAAgB;CACvF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAY,MAAM;EAAY,SAAS;CAAY;CACxF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAY,MAAM;EAAY,SAAS;CAAY;CACxF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAS,MAAM;EAAa,SAAS;CAAS;CAEnF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAQ,MAAM;EAAa,SAAS;CAAQ;CACjF;EAAE,QAAQ;EAAQ,MAAM,GAAG,WAAW;EAAc,MAAM;EAAU,SAAS;CAAU;CACvF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAoB,MAAM;EAAU,SAAS;CAAS;CAC3F;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAwB,MAAM;EAAU,SAAS;CAAqB;CAC3G;EAAE,QAAQ;EAAQ,MAAM,GAAG,WAAW;EAAmB,MAAM;EAAU,SAAS;CAAkB;CACpG;EAAE,QAAQ;EAAQ,MAAM,GAAG,WAAW;EAAiB,MAAM;EAAU,SAAS;CAAgB;CAChG;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAU,MAAM;EAAU,SAAS;CAAU;CAClF;EAAE,QAAQ;EAAQ,MAAM,GAAG,WAAW;EAAU,MAAM;EAAU,SAAS;CAAU;CACnF;EAAE,QAAQ;EAAO,MAAM,GAAG,WAAW;EAAc,MAAM;EAAU,SAAS;CAAS;CACrF;EAAE,QAAQ;EAAU,MAAM,GAAG,WAAW;EAAc,MAAM;EAAU,SAAS;CAAY;CAC3F;EAAE,QAAQ;EAAO,MAAM;EAAgB,MAAM;EAAa,SAAS;CAAY;CAC/E;EAAE,QAAQ;EAAO,MAAM;EAAgB,MAAM;EAAa,SAAS;CAAY;CAC/E;EAAE,QAAQ;EAAO,MAAM;EAAgB,MAAM;EAAY,SAAS;CAAY;CAC9E;EAAE,QAAQ;EAAQ,MAAM;EAAgB,MAAM;EAAY,SAAS;CAAa;CAChF;EAAE,QAAQ;EAAO,MAAM,GAAG,OAAO;EAAU,MAAM;EAAM,SAAS;CAAU;CAC1E;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAQ,MAAM;EAAM,SAAS;CAAS;CACxE;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAY,MAAM;EAAM,SAAS;CAAa;CAChF;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAY,MAAM;EAAM,SAAS;CAAa;CAChF;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAW,MAAM;EAAM,SAAS;CAAY;CAC9E;EAAE,QAAQ;EAAQ,MAAM,GAAG,OAAO;EAAsB,MAAM;EAAM,SAAS;CAAsB;AACrG;;;;;AAMA,SAAgB,eAAe,OAAoB,SAAsC;CACvF,OAAO,OAAO,QAAO,UAAS,MAAM,SAAS,OAAO,QAAQ,KAAK,MAAM,MAAM,UAAU,KAAA,CAAS;AAClG"}

package/dist/tree/tree-host.js

@@ -1,9 +1,9 @@
 import { findBlockById } from "../core/schema/block-ids.js";
 import { compositeBasketsOf, compositeJSON, compositeKindsOf } from "../features/composites/nodes.js";
+import { revealBlockInEditor } from "../outline/heading-outline.js";
 import { pickFiles } from "../features/media/upload.js";
 import { compositeFocusOf } from "../features/composites/focus.js";
 import { moveBlockInto, moveIntoVerdict } from "../features/composites/outline.js";
-import { revealBlockInEditor } from "../outline/heading-outline.js";
 import { readOutline } from "./tree-items.js";
 //#region src/tree/tree-host.ts
 /** The model's view of `editor`: its Baustein kinds, outline and move verdicts (worded in the language of `t`), read live. Create it once per editor. */

package/dist/tree/tree-items.js

@@ -1,7 +1,7 @@
 import { compositeKind, defaultCompositeKinds, kindAccepts } from "../features/composites/kinds.js";
 import { basketById } from "../features/composites/baskets.js";
-import { compositeOutline } from "../features/composites/outline.js";
 import { headingOutline } from "../outline/heading-outline.js";
+import { compositeOutline } from "../features/composites/outline.js";
 import { folderKey } from "./folder-paths.js";
 //#region src/tree/tree-items.ts
 /** Key of the virtual-mode root item (the open document). */

package/dist/vue/AdvancedEditor.vue.d.ts

@@ -71,21 +71,21 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
   editor: import("vue").ComputedRef<Editor | undefined>;
   preset: ComposedEditor<Component>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  "update:modelValue": (content: JSONContent) => any;
-  ready: (editor: Editor) => any;
-  settingsOpen: (tab?: string | undefined) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
+  ready: (editor: Editor) => any;
+  "update:modelValue": (content: JSONContent) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
+  settingsOpen: (tab?: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
+  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
+  onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;
 }>, {
   content: ContentLevel | readonly FeatureId[];
   ai: boolean;

package/dist/vue/SimpleEditor.vue.d.ts

@@ -41,21 +41,21 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
   editor: import("vue").ComputedRef<Editor | undefined>;
   preset: EditorPreset<Component>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  "update:modelValue": (content: JSONContent) => any;
-  ready: (editor: Editor) => any;
-  settingsOpen: (tab?: string | undefined) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
+  ready: (editor: Editor) => any;
+  "update:modelValue": (content: JSONContent) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
+  settingsOpen: (tab?: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
+  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
+  onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;
 }>, {
   editable: boolean;
   settingsUi: "internal" | "external";

package/dist/vue/components/EditorSurface.vue.d.ts

@@ -43,21 +43,21 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
   settingsOpen: import("vue").Ref<boolean, boolean>;
   settingsTab: import("vue").Ref<string | undefined, string | undefined>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  "update:modelValue": (content: JSONContent) => any;
-  ready: (editor: Editor) => any;
-  settingsOpen: (tab?: string | undefined) => any;
   "update:sidebarOpen": (value: boolean) => any;
   "update:commentsOpen": (value: boolean) => any;
+  ready: (editor: Editor) => any;
+  "update:modelValue": (content: JSONContent) => any;
   metadataCreate: (list: string, item: MetadataItem) => any;
   contentError: (error: Error) => any;
+  settingsOpen: (tab?: string | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
-  onReady?: ((editor: Editor) => any) | undefined;
-  onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;
   "onUpdate:sidebarOpen"?: ((value: boolean) => any) | undefined;
   "onUpdate:commentsOpen"?: ((value: boolean) => any) | undefined;
+  onReady?: ((editor: Editor) => any) | undefined;
+  "onUpdate:modelValue"?: ((content: JSONContent) => any) | undefined;
   onMetadataCreate?: ((list: string, item: MetadataItem) => any) | undefined;
   onContentError?: ((error: Error) => any) | undefined;
+  onSettingsOpen?: ((tab?: string | undefined) => any) | undefined;
 }>, {
   editable: boolean;
   settingsUi: "internal" | "external";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecsplico/editor",
-  "version": "3.4.0",
+  "version": "3.5.1",
   "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",
@@ -174,6 +174,26 @@
       "types": "./dist/features/media/schema.d.ts",
       "import": "./dist/features/media/schema.js"
     },
+    "./image-studio": {
+      "skaile-source": "./src/features/image-studio/index.ts",
+      "types": "./dist/features/image-studio/index.d.ts",
+      "import": "./dist/features/image-studio/index.js"
+    },
+    "./image-studio/vue": {
+      "skaile-source": "./src/features/image-studio/vue.ts",
+      "types": "./dist/features/image-studio/vue.d.ts",
+      "import": "./dist/features/image-studio/vue.js"
+    },
+    "./image-studio/react": {
+      "skaile-source": "./src/features/image-studio/react.ts",
+      "types": "./dist/features/image-studio/react.d.ts",
+      "import": "./dist/features/image-studio/react.js"
+    },
+    "./image-studio/schema": {
+      "skaile-source": "./src/features/image-studio/schema.ts",
+      "types": "./dist/features/image-studio/schema.d.ts",
+      "import": "./dist/features/image-studio/schema.js"
+    },
     "./mentions": {
       "skaile-source": "./src/features/mentions/index.ts",
       "types": "./dist/features/mentions/index.d.ts",