@ecsplico/editor 1.0.0 → 2.1.0

package/dist/adapters/nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro.js","names":[],"sources":["../../src/adapters/nitro.ts"],"sourcesContent":["import { type AiModels, type AiModelsConfig, type CollabConnection, type CollabServer, type CollabServerOptions, createAiModels, createCollabServer, createRateLimiter, type EditorAdapter, HttpError, type RateLimiterOptions } from '../server'\nimport {\n  type AiHandlerContext,\n  assetGet,\n  assetPost,\n  chatPost,\n  completePost,\n  generatePost,\n  type HandlerContext,\n  type HandlerRequest,\n  type HandlerResponse,\n  modelsGet,\n  settingsGet,\n  settingsPut,\n  tagsGet,\n  themeDelete,\n  themeGet,\n  themePost,\n  themesGet,\n  transcribePost,\n  transcriptCleanupPost,\n  usersGet,\n} from '../server/handlers'\nimport { createError, defineEventHandler, defineWebSocketHandler, getQuery, getRouterParams, type H3Event, readBody, readFormData, type Router, setResponseHeaders, setResponseStatus } from 'h3'\nimport type { DocumentAdmin } from './shared'\nimport type { CommentStore } from './comments/types'\nimport { AI_API, COLLAB_PATH, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API } from './routes'\nimport { commentsGet, type CommentsRouteContext, commentsPost, type DocumentsContext, documentGet, documentPut } from './documents'\n\n// The editor backend on a plain Nitro app (nitropack 2, no Nuxt module): the framework's own routes (settings, users,\n// tags, assets, themes, the optional AI endpoints), the collaboration websocket and this package's document and comments\n// routes, registered in one call from a Nitro plugin. It is the explicit-wiring twin of `@ecsplico/editor/nuxt`, which\n// registers the same routes by scanning files; both end in the same `@ecsplico/editor/server/handlers`.\n\n/** The part of a Nitro app this entry uses; `nitroApp` of a Nitro plugin fits. */\nexport interface NitroHost {\n  router: Pick<Router, 'add' | 'use'>\n  hooks: { hook(name: 'close', listener: () => void | Promise<void>): unknown }\n}\n\nexport interface EditorServerOptions {\n  /** Storage and identity. An adapter that also manages documents (`json`, `drizzle`) lets `PUT /api/editor/documents/:id` create them. */\n  adapter: EditorAdapter & Partial<DocumentAdmin>\n  /**\n   * The collaboration websocket (`/collab/:id`). Extensions, hooks and Hocuspocus configuration of `createCollabServer`;\n   * `{}` takes everything from the adapter. `false` mounts no websocket (documents then only load and save over HTTP).\n   * Needs `experimental: { websocket: true }` in the Nitro config.\n   */\n  collab: Omit<CollabServerOptions, 'adapter'> | false\n  /**\n   * Mounts the AI endpoints (`/api/ai/*`): presets, shared key, transcription, slots of `createAiModels`; `languageModel`\n   * and `listModels` default to the adapter's. Omitted: no AI routes.\n   */\n  ai?: Partial<AiModelsConfig>\n  /** Per-user limit of the AI endpoints; default 30 requests per minute. */\n  rateLimit?: RateLimiterOptions\n  /** Mounts the comments endpoint (`/api/editor/comments/:id`) over this store; omitted: no comments routes. */\n  comments?: { store: CommentStore }\n}\n\nexport interface EditorServer {\n  adapter: EditorServerOptions['adapter']\n  /** The collaboration server, `undefined` with `collab: false`. */\n  collab: CollabServer | undefined\n  /** The AI models, `undefined` without `ai`. */\n  models: AiModels | undefined\n  /** Writes pending collaboration stores and disconnects every client. Nitro's `close` hook calls it. */\n  close(): Promise<void>\n}\n\ntype Method = 'get' | 'post' | 'put' | 'delete'\ntype Handler<C> = (ctx: C, request: HandlerRequest) => Promise<HandlerResponse>\n\nconst API = EDITOR_API\n\n/** The `HandlerRequest` of a Nitro event. `signal` aborts when the client goes away. */\nfunction requestOf(event: H3Event): HandlerRequest {\n  const abort = new AbortController()\n  event.node.res.once('close', () => abort.abort())\n  return {\n    headers: event.headers,\n    params: getRouterParams(event, { decode: true }),\n    query: Object.fromEntries(Object.entries(getQuery(event)).map(([key, value]) => [key, value === undefined ? undefined : String(value)])),\n    readJson: () => readBody(event),\n    readForm: () => readFormData(event),\n    signal: abort.signal,\n  }\n}\n\n/** An event handler that runs `handler` with `ctx` and sends its `HandlerResponse`; an `HttpError` becomes Nitro's error response. */\nfunction routeOf<C>(ctx: C, handler: Handler<C>) {\n  return defineEventHandler(async (event) => {\n    let response: HandlerResponse\n    try {\n      response = await handler(ctx, requestOf(event))\n    }\n    catch (error) {\n      if (!(error instanceof HttpError)) throw error\n      setResponseHeaders(event, error.headers)\n      throw createError({ statusCode: error.statusCode, statusMessage: error.statusMessage, message: error.statusMessage, data: error.data })\n    }\n    setResponseStatus(event, response.status)\n    setResponseHeaders(event, response.headers)\n    // `null` ends the response without a body and keeps the status set above.\n    return response.body\n  })\n}\n\nconst editorRoutes: [Method, string, Handler<HandlerContext>][] = [\n  ['get', `${API}/settings`, settingsGet],\n  ['put', `${API}/settings`, settingsPut],\n  ['get', `${API}/users`, usersGet],\n  ['get', `${API}/tags`, tagsGet],\n  ['post', `${API}/assets/:id`, assetPost],\n  ['get', `${API}/assets/:id/:name`, assetGet],\n  ['get', `${API}/themes`, themesGet],\n  ['post', `${API}/themes`, themePost],\n  ['get', `${API}/themes/:id`, themeGet],\n  ['delete', `${API}/themes/:id`, themeDelete],\n]\n\nconst aiRoutes: [Method, string, Handler<AiHandlerContext>][] = [\n  ['get', `${AI_API}/models`, modelsGet],\n  ['post', `${AI_API}/chat`, chatPost],\n  ['post', `${AI_API}/complete`, completePost],\n  ['post', `${AI_API}/generate`, generatePost],\n  ['post', `${AI_API}/transcribe`, transcribePost],\n  ['post', `${AI_API}/transcript-cleanup`, transcriptCleanupPost],\n]\n\ntype CollabPeer = { _hocuspocus?: CollabConnection }\n\nconst collabRoute = (collab: CollabServer) => defineWebSocketHandler({\n  open(peer) {\n    ;(peer as unknown as CollabPeer)._hocuspocus = collab.handleConnection(peer.websocket as unknown as Parameters<CollabServer['handleConnection']>[0], peer.request as Request)\n  },\n  message(peer, message) {\n    ;(peer as unknown as CollabPeer)._hocuspocus?.handleMessage(message.uint8Array())\n  },\n  close(peer, details) {\n    ;(peer as unknown as CollabPeer)._hocuspocus?.handleClose({ code: details.code ?? 1000, reason: details.reason ?? '' } as CloseEvent)\n  },\n  error(peer, error) {\n    console.error('[collab]', peer.id, error)\n  },\n})\n\n/**\n * Wires the editor backend into `nitroApp` (call it from a Nitro plugin):\n *\n *     /api/editor/{settings,users,tags,assets/…,themes/…}   the editor's own endpoints\n *     /api/editor/documents/:id                              GET/PUT a document's TipTap JSON (what `useEditorDocument` uses)\n *     /api/editor/comments/:id                               GET/POST comments, with `comments`\n *     /api/ai/{models,chat,complete,generate,transcribe,transcript-cleanup}   with `ai`\n *     /collab/:id                                            the collaboration websocket, unless `collab: false`\n *\n * Every route authenticates through `adapter.authenticate`. The collaboration server is closed with Nitro's `close`\n * hook. The paths are the ones `@ecsplico/editor/nuxt` serves, so the editor's client works unchanged.\n */\nexport function installEditorServer(nitroApp: NitroHost, options: EditorServerOptions): EditorServer {\n  const { adapter } = options\n  const collab = options.collab === false ? undefined : createCollabServer({ adapter, ...options.collab })\n  const models = options.ai && createAiModels({\n    presets: {},\n    languageModel: adapter.languageModel && ((ref, user) => adapter.languageModel!(ref, user)),\n    listModels: adapter.listModels && (user => adapter.listModels!(user)),\n    ...options.ai,\n  })\n\n  const context: DocumentsContext = { adapter, ...(collab && { collab }) }\n  for (const [method, path, handler] of editorRoutes) nitroApp.router.add(path, routeOf<HandlerContext>(context, handler), method)\n  nitroApp.router.add(DOCUMENT_ROUTE, routeOf(context, documentGet), 'get')\n  nitroApp.router.add(DOCUMENT_ROUTE, routeOf(context, documentPut), 'put')\n\n  if (options.comments) {\n    const comments: CommentsRouteContext = { ...context, store: options.comments.store }\n    nitroApp.router.add(COMMENTS_ROUTE, routeOf(comments, commentsGet), 'get')\n    nitroApp.router.add(COMMENTS_ROUTE, routeOf(comments, commentsPost), 'post')\n  }\n  if (models) {\n    const ai: AiHandlerContext = { ...context, ai: models, limiter: createRateLimiter(options.rateLimit ?? { max: 30, windowMs: 60_000 }) }\n    for (const [method, path, handler] of aiRoutes) nitroApp.router.add(path, routeOf(ai, handler), method)\n  }\n  // No method: the websocket upgrade resolves its handler by path only.\n  if (collab) nitroApp.router.use(`${COLLAB_PATH}/:id`, collabRoute(collab))\n\n  const server: EditorServer = { adapter, collab, models, close: async () => { await collab?.close() } }\n  nitroApp.hooks.hook('close', () => server.close())\n  return server\n}\n"],"mappings":"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"}

package/dist/adapters/routes.js

@@ -0,0 +1,16 @@
+//#region src/adapters/routes.ts
+const EDITOR_API = "/api/editor";
+const AI_API = "/api/ai";
+const COLLAB_PATH = "/collab";
+/** Route pattern of a document's content (`GET` → TipTap JSON, `PUT` → stores it). */
+const DOCUMENT_ROUTE = `${EDITOR_API}/documents/:id`;
+/** Route pattern of a document's comments endpoint (`handleCommentsRequest`). */
+const COMMENTS_ROUTE = `${EDITOR_API}/comments/:id`;
+/** The content URL of document `id`. */
+const documentUrl = (id) => DOCUMENT_ROUTE.replace(":id", encodeURIComponent(id));
+/** The comments URL of document `id`. */
+const commentsUrl = (id) => COMMENTS_ROUTE.replace(":id", encodeURIComponent(id));
+//#endregion
+export { AI_API, COLLAB_PATH, COMMENTS_ROUTE, DOCUMENT_ROUTE, EDITOR_API, commentsUrl, documentUrl };
+
+//# sourceMappingURL=routes.js.map

package/dist/adapters/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","names":[],"sources":["../../src/adapters/routes.ts"],"sourcesContent":["// The wire paths shared by the Nitro host (`./server/nitro`) and the Vue composable (`./vue`). The editor's own\n// client calls the `/api/editor/*` and `/api/ai/*` paths of `@ecsplico/editor`; the two document paths below are this\n// package's contract between the two entries. Pure strings: this module imports nothing, so neither entry drags the\n// other's framework in.\n\nexport const EDITOR_API = '/api/editor'\nexport const AI_API = '/api/ai'\nexport const COLLAB_PATH = '/collab'\n\n/** Route pattern of a document's content (`GET` → TipTap JSON, `PUT` → stores it). */\nexport const DOCUMENT_ROUTE = `${EDITOR_API}/documents/:id`\n/** Route pattern of a document's comments endpoint (`handleCommentsRequest`). */\nexport const COMMENTS_ROUTE = `${EDITOR_API}/comments/:id`\n\n/** The content URL of document `id`. */\nexport const documentUrl = (id: string) => DOCUMENT_ROUTE.replace(':id', encodeURIComponent(id))\n/** The comments URL of document `id`. */\nexport const commentsUrl = (id: string) => COMMENTS_ROUTE.replace(':id', encodeURIComponent(id))\n"],"mappings":";AAKA,MAAa,aAAa;AAC1B,MAAa,SAAS;AACtB,MAAa,cAAc;;AAG3B,MAAa,iBAAiB,GAAG,WAAW;;AAE5C,MAAa,iBAAiB,GAAG,WAAW;;AAG5C,MAAa,eAAe,OAAe,eAAe,QAAQ,OAAO,mBAAmB,EAAE,CAAC;;AAE/F,MAAa,eAAe,OAAe,eAAe,QAAQ,OAAO,mBAAmB,EAAE,CAAC"}

package/dist/adapters/shared.d.ts

@@ -0,0 +1,37 @@
+import { MentionUser } from "../features/mentions/mention.js";
+import "../features/mentions/schema.js";
+import { EditorAdapter } from "../server/adapter.js";
+import "../server/index.js";
+import { JSONContent } from "@tiptap/core";
+//#region src/adapters/shared.d.ts
+/**
+ * The identity half of every adapter in this package: who the user is, which documents they may open, which host
+ * nodes the collaboration schema needs and who can be `@`-mentioned. Storage is the adapter's own business.
+ */
+export interface AdapterHooks {
+  /**
+   * The user behind a request, `null` = not authenticated (see `EditorAdapter.authenticate`). Default: an anonymous
+   * development user outside `NODE_ENV=production`, `null` (everyone refused) in production, so a deployment never
+   * serves documents to the world by omission.
+   */
+  authenticate?: EditorAdapter['authenticate'];
+  /** Per-document access for the collaboration websocket (see `EditorAdapter.authorize`). Omitted: every authenticated user edits every document. */
+  authorize?: EditorAdapter['authorize'];
+  /** Vue-free TipTap extensions of host-defined nodes and marks for the collaboration schema (see `EditorAdapter.schemaExtensions`). */
+  schemaExtensions?: EditorAdapter['schemaExtensions'];
+  /** Users that can be `@`-mentioned (`GET /api/editor/users`); no credentials. Default: none. */
+  users?: () => MentionUser[] | Promise<MentionUser[]>;
+}
+/** Document management a host needs next to the editor's own storage methods: the adapter contract cannot create documents (`storeContent` only updates). */
+export interface DocumentAdmin {
+  /** Creates the document or replaces its content; the content version changes. */
+  putDocument(id: string, content: JSONContent): Promise<void>;
+  /** 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. */
+  deleteDocument(id: string): Promise<void>;
+  /** Ids of all stored documents. */
+  listDocumentIds(): Promise<string[]>;
+}
+/** An adapter that stores documents itself (`json`, `drizzle`): the full contract including versioning, settings and document management. */
+export type StoredEditorAdapter = EditorAdapter & Required<Pick<EditorAdapter, 'contentVersion' | 'loadSettings' | 'storeSettings'>> & DocumentAdmin;
+//#endregion
+//# sourceMappingURL=shared.d.ts.map

package/dist/adapters/shared.js

@@ -0,0 +1,32 @@
+//#region src/adapters/shared.ts
+const DEV_USER = {
+	id: "dev",
+	username: "dev",
+	color: "#6366f1"
+};
+const authenticateDefault = async () => process.env.NODE_ENV === "production" ? null : { ...DEV_USER };
+/** `hooks` as adapter members; optional hooks are only present when given (the collab server tests for them). */
+function identityPart(hooks) {
+	const { authenticate = authenticateDefault, authorize, schemaExtensions, users } = hooks;
+	return {
+		authenticate: (request) => authenticate(request),
+		listUsers: async () => await users?.() ?? [],
+		...authorize && { authorize: (user, id) => authorize(user, id) },
+		...schemaExtensions && { schemaExtensions: () => schemaExtensions() }
+	};
+}
+/** The key per-user settings are stored under: the user's `id`, else its `username`. */
+function settingsKey(user) {
+	const { id, username } = user;
+	for (const candidate of [id, username]) {
+		if (typeof candidate === "string" && candidate !== "") return candidate;
+		if (typeof candidate === "number") return String(candidate);
+	}
+	throw new TypeError("@ecsplico/editor: the authenticated user has neither an `id` nor a `username`, so its settings have no key");
+}
+/** An independent copy of the bytes (a driver's `Buffer` may view a larger pool), as the plain `Uint8Array` the adapter contract names. */
+const bytesOf = (data) => new Uint8Array(data);
+//#endregion
+export { bytesOf, identityPart, settingsKey };
+
+//# sourceMappingURL=shared.js.map

package/dist/adapters/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/adapters/shared.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { MentionUser } from '../features/mentions/schema'\nimport type { EditorAdapter } from '../server'\n\n/**\n * The identity half of every adapter in this package: who the user is, which documents they may open, which host\n * nodes the collaboration schema needs and who can be `@`-mentioned. Storage is the adapter's own business.\n */\nexport interface AdapterHooks {\n  /**\n   * The user behind a request, `null` = not authenticated (see `EditorAdapter.authenticate`). Default: an anonymous\n   * development user outside `NODE_ENV=production`, `null` (everyone refused) in production, so a deployment never\n   * serves documents to the world by omission.\n   */\n  authenticate?: EditorAdapter['authenticate']\n  /** Per-document access for the collaboration websocket (see `EditorAdapter.authorize`). Omitted: every authenticated user edits every document. */\n  authorize?: EditorAdapter['authorize']\n  /** Vue-free TipTap extensions of host-defined nodes and marks for the collaboration schema (see `EditorAdapter.schemaExtensions`). */\n  schemaExtensions?: EditorAdapter['schemaExtensions']\n  /** Users that can be `@`-mentioned (`GET /api/editor/users`); no credentials. Default: none. */\n  users?: () => MentionUser[] | Promise<MentionUser[]>\n}\n\n/** Document management a host needs next to the editor's own storage methods: the adapter contract cannot create documents (`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/** An adapter that stores documents itself (`json`, `drizzle`): the full contract including versioning, settings and document management. */\nexport type StoredEditorAdapter = EditorAdapter\n  & Required<Pick<EditorAdapter, 'contentVersion' | 'loadSettings' | 'storeSettings'>>\n  & DocumentAdmin\n\nconst DEV_USER = { id: 'dev', username: 'dev', color: '#6366f1' } as const\n\nconst authenticateDefault: EditorAdapter['authenticate'] = async () => process.env.NODE_ENV === 'production' ? null : { ...DEV_USER }\n\n/** The members of `EditorAdapter` that `AdapterHooks` fill in. */\nexport type IdentityPart = Pick<EditorAdapter, 'authenticate' | 'listUsers'> & Partial<Pick<EditorAdapter, 'authorize' | 'schemaExtensions'>>\n\n/** `hooks` as adapter members; optional hooks are only present when given (the collab server tests for them). */\nexport function identityPart(hooks: AdapterHooks): IdentityPart {\n  const { authenticate = authenticateDefault, authorize, schemaExtensions, users } = hooks\n  return {\n    authenticate: request => authenticate(request),\n    listUsers: async () => (await users?.()) ?? [],\n    ...(authorize && { authorize: (user: object, id: string) => authorize(user, id) }),\n    ...(schemaExtensions && { schemaExtensions: () => schemaExtensions() }),\n  }\n}\n\n/** The key per-user settings are stored under: the user's `id`, else its `username`. */\nexport function settingsKey(user: object): string {\n  const { id, username } = user as { id?: unknown, username?: unknown }\n  for (const candidate of [id, username]) {\n    if (typeof candidate === 'string' && candidate !== '') return candidate\n    if (typeof candidate === 'number') return String(candidate)\n  }\n  throw new TypeError('@ecsplico/editor: the authenticated user has neither an `id` nor a `username`, so its settings have no key')\n}\n\n/** An independent copy of the bytes (a driver's `Buffer` may view a larger pool), as the plain `Uint8Array` the adapter contract names. */\nexport const bytesOf = (data: Uint8Array): Uint8Array => new Uint8Array(data)\n"],"mappings":";AAsCA,MAAM,WAAW;CAAE,IAAI;CAAO,UAAU;CAAO,OAAO;AAAU;AAEhE,MAAM,sBAAqD,YAAY,QAAQ,IAAI,aAAa,eAAe,OAAO,EAAE,GAAG,SAAS;;AAMpI,SAAgB,aAAa,OAAmC;CAC9D,MAAM,EAAE,eAAe,qBAAqB,WAAW,kBAAkB,UAAU;CACnF,OAAO;EACL,eAAc,YAAW,aAAa,OAAO;EAC7C,WAAW,YAAa,MAAM,QAAQ,KAAM,CAAC;EAC7C,GAAI,aAAa,EAAE,YAAY,MAAc,OAAe,UAAU,MAAM,EAAE,EAAE;EAChF,GAAI,oBAAoB,EAAE,wBAAwB,iBAAiB,EAAE;CACvE;AACF;;AAGA,SAAgB,YAAY,MAAsB;CAChD,MAAM,EAAE,IAAI,aAAa;CACzB,KAAK,MAAM,aAAa,CAAC,IAAI,QAAQ,GAAG;EACtC,IAAI,OAAO,cAAc,YAAY,cAAc,IAAI,OAAO;EAC9D,IAAI,OAAO,cAAc,UAAU,OAAO,OAAO,SAAS;CAC5D;CACA,MAAM,IAAI,UAAU,4GAA4G;AAClI;;AAGA,MAAa,WAAW,SAAiC,IAAI,WAAW,IAAI"}

package/dist/adapters/vue.d.ts

@@ -0,0 +1,67 @@
+import { AuthorIdentity, CollaborationSession } from "../core/feature.js";
+import "../core/index.js";
+import { CommentsFetch, RestCommentsModel } from "./comments/client.js";
+import { Editor, JSONContent } from "@tiptap/core";
+import { ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from "vue";
+//#region src/adapters/vue.d.ts
+export interface EditorDocumentOptions {
+  /** How requests are sent: `globalThis.fetch`, or a wrapper that adds the base URL and credentials. Used for the content and the comments. */
+  fetch: CommentsFetch;
+  /**
+   * Live collaboration: the collaboration server's websocket URL (`ws://host/collab`; the document id is appended as the
+   * provider's `name`) and the optional token its `EditorAdapter.authenticate` receives. With it the Y.Doc is the document:
+   * the server loads and stores the content, so the composable neither fetches nor saves it (`modelValue` stays
+   * `undefined`, `dirty` stays `false`, `save()` resolves at once).
+   */
+  collaboration?: {
+    url: string;
+    token?: string | (() => string) | (() => Promise<string>);
+  };
+  /** Who writes: labels remote carets and is the author of new comments; `null` or omitted = nobody (no comments). */
+  user?: AuthorIdentity | null | (() => AuthorIdentity | null);
+  /** Whether the user may comment now (a reader of a read-only document may be refused); default `true`. */
+  canComment?: boolean | (() => boolean);
+}
+/** The props and events of the editor surface (`SimpleEditor`, `AdvancedEditor`, `EditorSurface`) that `useEditorDocument` fills. */
+export interface EditorDocumentBinding {
+  /** The document (standalone mode); `undefined` in collaboration mode and until it has loaded. */
+  modelValue: JSONContent | undefined;
+  'onUpdate:modelValue': (content: JSONContent) => void;
+  /** Hands the live editor to the comments model. */
+  onReady: (editor: Editor) => void;
+  collaboration: CollaborationSession | undefined;
+}
+export interface EditorDocument {
+  /** The document's TipTap JSON: the surface's `v-model`. `undefined` until loaded, and always in collaboration mode. */
+  modelValue: Ref<JSONContent | undefined>;
+  /** `true` once the surface can be mounted: the content has loaded (a missing document starts empty), or the collaboration session exists. Mount with `:key` = the id, so a changed id remounts it. */
+  ready: Ref<boolean>;
+  /** Edits since the content was loaded or last saved. */
+  dirty: ComputedRef<boolean>;
+  /** Stores the current content (`PUT`); several calls run one after another and an edit made while one is in flight stays dirty. Rejects with the server's refusal. */
+  save(): Promise<void>;
+  /** Fetches the content again and drops unsaved edits. */
+  reload(): Promise<void>;
+  /** The last load or save error, `null` while all is well. */
+  error: Ref<Error | null>;
+  /** The collaboration session for the surface's `collaboration` prop; `undefined` without the `collaboration` option. */
+  collaboration: ShallowRef<CollaborationSession | undefined>;
+  /** The comments model of this document (`commentsFeature({ model: () => comments.value })`), threads behind the host's comments endpoint. A new one per id. */
+  comments: Readonly<ShallowRef<RestCommentsModel>>;
+  /** The live editor, once the surface reported it. */
+  editor: ShallowRef<Editor | undefined>;
+  /** `v-bind` target for the surface: `<AdvancedEditor v-if="ready" :key="id" v-bind="bind" />`. */
+  bind: ComputedRef<EditorDocumentBinding>;
+  /** Closes the collaboration session and the comments model; runs with the effect scope that called `useEditorDocument`. */
+  dispose(): void;
+}
+/**
+ * Loads document `id` from `GET /api/editor/documents/<id>` (a `404` starts an empty document that the first `save()`
+ * creates), tracks edits, saves with `PUT`, and prepares the collaboration session and comments model for the editor
+ * surface. `id` may be reactive: a change loads the other document and replaces the session and the comments model.
+ * Call it in a component's `setup`; the collaboration session is created synchronously, so the surface mounts in the same tick.
+ */
+export declare function useEditorDocument(id: MaybeRefOrGetter<string>, options: EditorDocumentOptions): EditorDocument;
+//#endregion
+export type { CommentsFetch };
+//# sourceMappingURL=vue.d.ts.map

package/dist/adapters/vue.js

@@ -0,0 +1,187 @@
+import { commentsUrl, documentUrl } from "./routes.js";
+import { createRestCommentsModel } from "./comments/client.js";
+import * as Y from "yjs";
+import { HocuspocusProvider } from "@hocuspocus/provider";
+import { computed, getCurrentScope, onScopeDispose, ref, shallowRef, toValue, watch } from "vue";
+//#region src/adapters/vue.ts
+const EMPTY_DOCUMENT = {
+	type: "doc",
+	content: [{ type: "paragraph" }]
+};
+/**
+* The document as compared for "unsaved changes": without block ids. The editor gives every block of loaded content an
+* id the moment it mounts (stored files have none yet); that is not an edit the user made, so it must not mark a
+* freshly opened document dirty. Saving still writes the ids.
+*/
+const withoutBlockIds = (node) => {
+	const { attrs, content, ...rest } = node;
+	const kept = attrs && Object.fromEntries(Object.entries(attrs).filter(([name]) => name !== "id"));
+	return {
+		...rest,
+		...kept && Object.keys(kept).length > 0 && { attrs: kept },
+		...content && { content: content.map(withoutBlockIds) }
+	};
+};
+const fingerprint = (content) => JSON.stringify(withoutBlockIds(content));
+/** Document ids are percent-encoded into one path segment; the collab provider's `name` is the plain id. */
+function sessionOf(id, { url, token }, user) {
+	const ydoc = new Y.Doc();
+	const provider = new HocuspocusProvider({
+		url: `${url.replace(/\/+$/, "")}/${encodeURIComponent(id)}`,
+		name: id,
+		document: ydoc,
+		...token !== void 0 && { token }
+	});
+	return {
+		session: {
+			ydoc,
+			provider,
+			...user && { user }
+		},
+		close() {
+			provider.destroy();
+			ydoc.destroy();
+		}
+	};
+}
+const errorOf = (cause) => cause instanceof Error ? cause : new Error(String(cause));
+/**
+* Loads document `id` from `GET /api/editor/documents/<id>` (a `404` starts an empty document that the first `save()`
+* creates), tracks edits, saves with `PUT`, and prepares the collaboration session and comments model for the editor
+* surface. `id` may be reactive: a change loads the other document and replaces the session and the comments model.
+* Call it in a component's `setup`; the collaboration session is created synchronously, so the surface mounts in the same tick.
+*/
+function useEditorDocument(id, options) {
+	const userOf = () => toValue(options.user) ?? null;
+	const modelValue = ref();
+	const ready = ref(false);
+	const error = ref(null);
+	const collaboration = shallowRef();
+	const editor = shallowRef();
+	/** Fingerprint (`fingerprint`) of the JSON the server holds (the empty document while it does not exist), `null` before the first load. */
+	const savedJson = ref(null);
+	/** The document does not exist on the server yet: the first save creates it even if nothing was typed. */
+	let missing = false;
+	let closeSession;
+	let generation = 0;
+	let tail = Promise.resolve();
+	const commentsFor = (documentId) => createRestCommentsModel({
+		fetch: options.fetch,
+		documentId,
+		endpoint: commentsUrl(documentId),
+		user: userOf,
+		canComment: () => toValue(options.canComment) ?? true,
+		getEditor: () => editor.value,
+		onError: (cause) => {
+			error.value = cause;
+		}
+	});
+	const comments = shallowRef(commentsFor(toValue(id)));
+	let commentsId = toValue(id);
+	async function load(documentId) {
+		const mine = ++generation;
+		ready.value = false;
+		error.value = null;
+		modelValue.value = void 0;
+		savedJson.value = null;
+		missing = false;
+		editor.value = void 0;
+		closeSession?.();
+		closeSession = void 0;
+		collaboration.value = void 0;
+		if (commentsId !== documentId) {
+			comments.value.dispose();
+			comments.value = commentsFor(documentId);
+			commentsId = documentId;
+		}
+		if (options.collaboration) {
+			const { session, close } = sessionOf(documentId, options.collaboration, userOf());
+			closeSession = close;
+			collaboration.value = session;
+			ready.value = true;
+			return;
+		}
+		try {
+			const response = await options.fetch(documentUrl(documentId));
+			if (mine !== generation) return;
+			if (response.status === 404) {
+				modelValue.value = structuredClone(EMPTY_DOCUMENT);
+				savedJson.value = fingerprint(EMPTY_DOCUMENT);
+				missing = true;
+			} else if (response.ok) {
+				const content = await response.json();
+				if (mine !== generation) return;
+				modelValue.value = content;
+				savedJson.value = fingerprint(content);
+			} else throw new Error(`Loading "${documentId}" failed (${response.status}).`);
+			ready.value = true;
+		} catch (cause) {
+			if (mine === generation) error.value = errorOf(cause);
+		}
+	}
+	const dirty = computed(() => !options.collaboration && modelValue.value !== void 0 && savedJson.value !== null && fingerprint(modelValue.value) !== savedJson.value);
+	function save() {
+		if (options.collaboration) return Promise.resolve();
+		const run = async () => {
+			const documentId = toValue(id);
+			const content = modelValue.value;
+			if (content === void 0 || !ready.value) return;
+			const saved = fingerprint(content);
+			if (saved === savedJson.value && !missing) return;
+			const json = JSON.stringify(content);
+			const response = await options.fetch(documentUrl(documentId), {
+				method: "PUT",
+				headers: { "content-type": "application/json" },
+				body: json
+			});
+			if (!response.ok) {
+				const failure = /* @__PURE__ */ new Error(`Saving "${documentId}" failed (${response.status}).`);
+				error.value = failure;
+				throw failure;
+			}
+			error.value = null;
+			if (documentId === toValue(id)) {
+				savedJson.value = saved;
+				missing = false;
+			}
+		};
+		const result = tail.then(run, run);
+		tail = result.catch(() => {});
+		return result;
+	}
+	function dispose() {
+		generation++;
+		closeSession?.();
+		closeSession = void 0;
+		collaboration.value = void 0;
+		comments.value.dispose();
+	}
+	watch(() => toValue(id), (documentId) => void load(documentId), { immediate: true });
+	if (getCurrentScope()) onScopeDispose(dispose);
+	return {
+		modelValue,
+		ready,
+		dirty,
+		save,
+		reload: () => load(toValue(id)),
+		error,
+		collaboration,
+		comments,
+		editor,
+		bind: computed(() => ({
+			modelValue: modelValue.value,
+			"onUpdate:modelValue": (content) => {
+				modelValue.value = content;
+			},
+			onReady: (instance) => {
+				editor.value = instance;
+			},
+			collaboration: collaboration.value
+		})),
+		dispose
+	};
+}
+//#endregion
+export { useEditorDocument };
+
+//# sourceMappingURL=vue.js.map

package/dist/adapters/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","names":[],"sources":["../../src/adapters/vue.ts"],"sourcesContent":["import { HocuspocusProvider } from '@hocuspocus/provider'\nimport type { Editor, JSONContent } from '@tiptap/core'\nimport type { AuthorIdentity, CollaborationSession } from '../core'\nimport { computed, type ComputedRef, getCurrentScope, type MaybeRefOrGetter, onScopeDispose, ref, type Ref, shallowRef, type ShallowRef, toValue, watch } from 'vue'\nimport * as Y from 'yjs'\nimport { type CommentsFetch, createRestCommentsModel, type RestCommentsModel } from './comments/client'\nimport { commentsUrl, documentUrl } from './routes'\n\n// The Vue side of an editor document: load it from the host's document endpoint, keep track of unsaved edits, save it,\n// and hand the editor surface what it needs (v-model, collaboration session, comments model). The server side is\n// `installEditorServer` (`./server/nitro`); any server that answers the same two routes works.\n\nexport type { CommentsFetch } from './comments/client'\n\nexport interface EditorDocumentOptions {\n  /** How requests are sent: `globalThis.fetch`, or a wrapper that adds the base URL and credentials. Used for the content and the comments. */\n  fetch: CommentsFetch\n  /**\n   * Live collaboration: the collaboration server's websocket URL (`ws://host/collab`; the document id is appended as the\n   * provider's `name`) and the optional token its `EditorAdapter.authenticate` receives. With it the Y.Doc is the document:\n   * the server loads and stores the content, so the composable neither fetches nor saves it (`modelValue` stays\n   * `undefined`, `dirty` stays `false`, `save()` resolves at once).\n   */\n  collaboration?: { url: string, token?: string | (() => string) | (() => Promise<string>) }\n  /** Who writes: labels remote carets and is the author of new comments; `null` or omitted = nobody (no comments). */\n  user?: AuthorIdentity | null | (() => AuthorIdentity | null)\n  /** Whether the user may comment now (a reader of a read-only document may be refused); default `true`. */\n  canComment?: boolean | (() => boolean)\n}\n\n/** The props and events of the editor surface (`SimpleEditor`, `AdvancedEditor`, `EditorSurface`) that `useEditorDocument` fills. */\nexport interface EditorDocumentBinding {\n  /** The document (standalone mode); `undefined` in collaboration mode and until it has loaded. */\n  modelValue: JSONContent | undefined\n  'onUpdate:modelValue': (content: JSONContent) => void\n  /** Hands the live editor to the comments model. */\n  onReady: (editor: Editor) => void\n  collaboration: CollaborationSession | undefined\n}\n\nexport interface EditorDocument {\n  /** The document's TipTap JSON: the surface's `v-model`. `undefined` until loaded, and always in collaboration mode. */\n  modelValue: Ref<JSONContent | undefined>\n  /** `true` once the surface can be mounted: the content has loaded (a missing document starts empty), or the collaboration session exists. Mount with `:key` = the id, so a changed id remounts it. */\n  ready: Ref<boolean>\n  /** Edits since the content was loaded or last saved. */\n  dirty: ComputedRef<boolean>\n  /** Stores the current content (`PUT`); several calls run one after another and an edit made while one is in flight stays dirty. Rejects with the server's refusal. */\n  save(): Promise<void>\n  /** Fetches the content again and drops unsaved edits. */\n  reload(): Promise<void>\n  /** The last load or save error, `null` while all is well. */\n  error: Ref<Error | null>\n  /** The collaboration session for the surface's `collaboration` prop; `undefined` without the `collaboration` option. */\n  collaboration: ShallowRef<CollaborationSession | undefined>\n  /** The comments model of this document (`commentsFeature({ model: () => comments.value })`), threads behind the host's comments endpoint. A new one per id. */\n  comments: Readonly<ShallowRef<RestCommentsModel>>\n  /** The live editor, once the surface reported it. */\n  editor: ShallowRef<Editor | undefined>\n  /** `v-bind` target for the surface: `<AdvancedEditor v-if=\"ready\" :key=\"id\" v-bind=\"bind\" />`. */\n  bind: ComputedRef<EditorDocumentBinding>\n  /** Closes the collaboration session and the comments model; runs with the effect scope that called `useEditorDocument`. */\n  dispose(): void\n}\n\nconst EMPTY_DOCUMENT: JSONContent = { type: 'doc', content: [{ type: 'paragraph' }] }\n\n/**\n * The document as compared for \"unsaved changes\": without block ids. The editor gives every block of loaded content an\n * id the moment it mounts (stored files have none yet); that is not an edit the user made, so it must not mark a\n * freshly opened document dirty. Saving still writes the ids.\n */\nconst withoutBlockIds = (node: JSONContent): JSONContent => {\n  const { attrs, content, ...rest } = node\n  const kept = attrs && Object.fromEntries(Object.entries(attrs).filter(([name]) => name !== 'id'))\n  return {\n    ...rest,\n    ...(kept && Object.keys(kept).length > 0 && { attrs: kept }),\n    ...(content && { content: content.map(withoutBlockIds) }),\n  }\n}\nconst fingerprint = (content: JSONContent): string => JSON.stringify(withoutBlockIds(content))\n\n/** Document ids are percent-encoded into one path segment; the collab provider's `name` is the plain id. */\nfunction sessionOf(id: string, { url, token }: NonNullable<EditorDocumentOptions['collaboration']>, user: AuthorIdentity | null): { session: CollaborationSession, close: () => void } {\n  const ydoc = new Y.Doc()\n  const provider = new HocuspocusProvider({ url: `${url.replace(/\\/+$/, '')}/${encodeURIComponent(id)}`, name: id, document: ydoc, ...(token !== undefined && { token }) })\n  return {\n    session: { ydoc, provider, ...(user && { user }) },\n    close() {\n      provider.destroy()\n      ydoc.destroy()\n    },\n  }\n}\n\nconst errorOf = (cause: unknown) => cause instanceof Error ? cause : new Error(String(cause))\n\n/**\n * Loads document `id` from `GET /api/editor/documents/<id>` (a `404` starts an empty document that the first `save()`\n * creates), tracks edits, saves with `PUT`, and prepares the collaboration session and comments model for the editor\n * surface. `id` may be reactive: a change loads the other document and replaces the session and the comments model.\n * Call it in a component's `setup`; the collaboration session is created synchronously, so the surface mounts in the same tick.\n */\nexport function useEditorDocument(id: MaybeRefOrGetter<string>, options: EditorDocumentOptions): EditorDocument {\n  const userOf = () => toValue(options.user) ?? null\n  const modelValue = ref<JSONContent>()\n  const ready = ref(false)\n  const error = ref<Error | null>(null)\n  const collaboration = shallowRef<CollaborationSession>()\n  const editor = shallowRef<Editor>()\n  /** Fingerprint (`fingerprint`) of the JSON the server holds (the empty document while it does not exist), `null` before the first load. */\n  const savedJson = ref<string | null>(null)\n  /** The document does not exist on the server yet: the first save creates it even if nothing was typed. */\n  let missing = false\n  let closeSession: (() => void) | undefined\n  let generation = 0\n  let tail: Promise<unknown> = Promise.resolve()\n\n  const commentsFor = (documentId: string) => createRestCommentsModel({\n    fetch: options.fetch,\n    documentId,\n    endpoint: commentsUrl(documentId),\n    user: userOf,\n    canComment: () => toValue(options.canComment) ?? true,\n    getEditor: () => editor.value,\n    onError: (cause) => { error.value = cause },\n  })\n  const comments = shallowRef(commentsFor(toValue(id)))\n  let commentsId = toValue(id)\n\n  async function load(documentId: string): Promise<void> {\n    const mine = ++generation\n    ready.value = false\n    error.value = null\n    modelValue.value = undefined\n    savedJson.value = null\n    missing = false\n    editor.value = undefined\n    closeSession?.()\n    closeSession = undefined\n    collaboration.value = undefined\n    if (commentsId !== documentId) {\n      comments.value.dispose()\n      comments.value = commentsFor(documentId)\n      commentsId = documentId\n    }\n\n    if (options.collaboration) {\n      const { session, close } = sessionOf(documentId, options.collaboration, userOf())\n      closeSession = close\n      collaboration.value = session\n      ready.value = true\n      return\n    }\n    try {\n      const response = await options.fetch(documentUrl(documentId))\n      if (mine !== generation) return\n      if (response.status === 404) {\n        modelValue.value = structuredClone(EMPTY_DOCUMENT)\n        savedJson.value = fingerprint(EMPTY_DOCUMENT)\n        missing = true\n      }\n      else if (response.ok) {\n        const content = await response.json() as JSONContent\n        if (mine !== generation) return\n        modelValue.value = content\n        savedJson.value = fingerprint(content)\n      }\n      else {\n        throw new Error(`Loading \"${documentId}\" failed (${response.status}).`)\n      }\n      ready.value = true\n    }\n    catch (cause) {\n      if (mine === generation) error.value = errorOf(cause)\n    }\n  }\n\n  const dirty = computed(() => !options.collaboration && modelValue.value !== undefined && savedJson.value !== null && fingerprint(modelValue.value) !== savedJson.value)\n\n  function save(): Promise<void> {\n    if (options.collaboration) return Promise.resolve()\n    const run = async () => {\n      const documentId = toValue(id)\n      const content = modelValue.value\n      if (content === undefined || !ready.value) return\n      const saved = fingerprint(content)\n      if (saved === savedJson.value && !missing) return\n      const json = JSON.stringify(content)\n      const response = await options.fetch(documentUrl(documentId), { method: 'PUT', headers: { 'content-type': 'application/json' }, body: json })\n      if (!response.ok) {\n        const failure = new Error(`Saving \"${documentId}\" failed (${response.status}).`)\n        error.value = failure\n        throw failure\n      }\n      error.value = null\n      // Only if the document did not change to another id while the request was in flight.\n      if (documentId === toValue(id)) {\n        savedJson.value = saved\n        missing = false\n      }\n    }\n    const result = tail.then(run, run)\n    tail = result.catch(() => {})\n    return result\n  }\n\n  function dispose() {\n    generation++\n    closeSession?.()\n    closeSession = undefined\n    collaboration.value = undefined\n    comments.value.dispose()\n  }\n\n  watch(() => toValue(id), documentId => void load(documentId), { immediate: true })\n  if (getCurrentScope()) onScopeDispose(dispose)\n\n  const bind = computed<EditorDocumentBinding>(() => ({\n    modelValue: modelValue.value,\n    'onUpdate:modelValue': (content) => { modelValue.value = content },\n    onReady: (instance) => { editor.value = instance },\n    collaboration: collaboration.value,\n  }))\n\n  return { modelValue, ready, dirty, save, reload: () => load(toValue(id)), error, collaboration, comments, editor, bind, dispose }\n}\n"],"mappings":"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"}

package/dist/code/CodeSurface.vue.d.ts

@@ -11,16 +11,16 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
   view: import("vue").ShallowRef<EditorView | undefined, EditorView | undefined>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  ready: (view: EditorView) => any;
   "update:modelValue": (text: string) => any;
+  ready: (view: EditorView) => any;
   save: (text: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onReady?: ((view: EditorView) => any) | undefined;
   "onUpdate:modelValue"?: ((text: string) => any) | undefined;
+  onReady?: ((view: EditorView) => any) | undefined;
   onSave?: ((text: string) => any) | undefined;
 }>, {
-  modelValue: string;
   editable: boolean;
+  modelValue: string;
   wordWrap: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/core/doc-anchors.d.ts

@@ -13,6 +13,10 @@ interface AnchorEntry {
   token: unknown | null;
 }
 export declare const docAnchorsKey: PluginKey<ReadonlyMap<string, AnchorEntry>>;
+/**
+ * `add` captures an anchor; `remove` releases anchors. `after` (with `remove`) names collapsed anchors that, in this
+ * transaction, move behind text inserted at their position instead of staying in front of it.
+ */
 export type DocAnchorsMeta = {
   add: {
     id: string;
@@ -22,6 +26,7 @@ export type DocAnchorsMeta = {
   };
 } | {
   remove: readonly string[];
+  after?: readonly string[];
 };
 export interface DocAnchorsOptions {
   /** Position mapping that survives collaborative edits (see the collab feature); without one anchors only map through local transactions. */

package/dist/core/doc-anchors.js

@@ -23,6 +23,7 @@ const DocAnchors = Extension.create({
 				init: () => /* @__PURE__ */ new Map(),
 				apply(tr, value, _oldState, newState) {
 					const meta = tr.getMeta(docAnchorsKey);
+					const after = meta && "remove" in meta ? meta.after : void 0;
 					if (!meta && (!tr.docChanged || !value.size)) return value;
 					let next = value;
 					if (tr.docChanged && value.size) {
@@ -43,11 +44,11 @@ const DocAnchors = Extension.create({
 								mapped.set(id, entry);
 								continue;
 							}
-							const collapsed = entry.from === entry.to;
+							const side = entry.from === entry.to ? after?.includes(id) ? 1 : -1 : null;
 							mapped.set(id, {
 								...entry,
-								from: tr.mapping.map(entry.from, collapsed ? -1 : 1),
-								to: tr.mapping.map(entry.to, -1)
+								from: tr.mapping.map(entry.from, side ?? 1),
+								to: tr.mapping.map(entry.to, side ?? -1)
 							});
 						}
 						next = mapped;

package/dist/core/doc-anchors.js.map

@@ -1 +1 @@
-{"version":3,"file":"doc-anchors.js","names":[],"sources":["../../src/core/doc-anchors.ts"],"sourcesContent":["import { type Editor, Extension } from '@tiptap/core'\nimport { type EditorState, Plugin, PluginKey } from '@tiptap/pm/state'\nimport type { AnchorResolver } from './feature'\nimport { newBlockId } from './schema/block-ids'\n\n/** A document range captured with `captureRange`: survives local and remote (collaborative) edits until released. */\nexport interface DocAnchor { readonly id: string }\n\n/** Current positions (-1 when gone) plus, with an `AnchorResolver`, its token for re-resolving after remote changes. */\ninterface AnchorEntry { from: number, to: number, token: unknown | null }\n\nexport const docAnchorsKey = new PluginKey<ReadonlyMap<string, AnchorEntry>>('docAnchors')\n\nexport type DocAnchorsMeta = { add: { id: string, from: number, to: number, startInside: boolean } } | { remove: readonly string[] }\n\nexport interface DocAnchorsOptions {\n  /** Position mapping that survives collaborative edits (see the collab feature); without one anchors only map through local transactions. */\n  resolver: AnchorResolver | null\n}\n\n/**\n * Edit-surviving ranges for AI flows (selection menu, AI sidebar, reviews, chat ops): anchors map through local\n * transactions and, with an `AnchorResolver`, re-resolve from its tokens on collaboration (y-sync) transactions, which\n * replace the whole document. Client-only: not part of the Vue-free schema.\n */\nexport const DocAnchors = Extension.create<DocAnchorsOptions, { resolver: AnchorResolver | null }>({\n  name: 'docAnchors',\n  priority: 1000,\n\n  addOptions: () => ({ resolver: null }),\n\n  addStorage() {\n    return { resolver: this.options.resolver }\n  },\n\n  addProseMirrorPlugins() {\n    const { resolver } = this.options\n    return [\n      new Plugin<ReadonlyMap<string, AnchorEntry>>({\n        key: docAnchorsKey,\n        state: {\n          init: () => new Map(),\n          apply(tr, value, _oldState, newState) {\n            const meta = tr.getMeta(docAnchorsKey) as DocAnchorsMeta | undefined\n            if (!meta && (!tr.docChanged || !value.size)) return value\n            let next = value\n            if (tr.docChanged && value.size) {\n              const synced = resolver?.isYSync(tr) === true\n              const mapped = new Map<string, AnchorEntry>()\n              for (const [id, entry] of value) {\n                if (synced && resolver && entry.token != null) {\n                  mapped.set(id, { ...entry, ...(resolver.resolve(newState, entry.token) ?? { from: -1, to: -1 }) })\n                  continue\n                }\n                if (entry.from < 0) {\n                  mapped.set(id, entry)\n                  continue\n                }\n                // Like the resolver's positions: text inserted at a boundary stays outside (a collapsed anchor keeps it after itself).\n                const collapsed = entry.from === entry.to\n                mapped.set(id, { ...entry, from: tr.mapping.map(entry.from, collapsed ? -1 : 1), to: tr.mapping.map(entry.to, -1) })\n              }\n              next = mapped\n            }\n            if (meta && 'add' in meta) {\n              const { id, from, to, startInside } = meta.add\n              next = new Map(next).set(id, { from, to, token: resolver?.capture(newState, { from, to }, startInside) ?? null })\n            }\n            else if (meta && meta.remove.some(id => next.has(id))) {\n              const kept = new Map(next)\n              for (const id of meta.remove) kept.delete(id)\n              next = kept\n            }\n            return next\n          },\n        },\n      }),\n    ]\n  },\n})\n\n/**\n * Captures [from, to] of the current document. Both ends stick to the text before them; `startInside` binds a\n * non-empty range's start to its own first character instead, so text inserted right before it stays outside.\n * Release with `releaseRanges` when the flow ends.\n */\nexport function captureRange(editor: Editor, { from, to }: { from: number, to: number }, options: { startInside?: boolean } = {}): DocAnchor {\n  const id = newBlockId()\n  const meta: DocAnchorsMeta = { add: { id, from, to, startInside: options.startInside ?? false } }\n  editor.view.dispatch(editor.state.tr.setMeta(docAnchorsKey, meta).setMeta('addToHistory', false))\n  return { id }\n}\n\n/** Current positions of `anchor`, collapsed (`from === to`) when its content was deleted; null when unknown or gone. */\nexport function resolveRange(state: EditorState, anchor: DocAnchor): { from: number, to: number } | null {\n  const entry = docAnchorsKey.getState(state)?.get(anchor.id)\n  if (!entry || entry.from < 0 || entry.from > entry.to || entry.to > state.doc.content.size) return null\n  return { from: entry.from, to: entry.to }\n}\n\n/** Forgets `anchors` (unknown ones are ignored). */\nexport function releaseRanges(editor: Editor, anchors: readonly DocAnchor[]): void {\n  if (editor.isDestroyed || !anchors.length) return\n  const meta: DocAnchorsMeta = { remove: anchors.map(a => a.id) }\n  editor.view.dispatch(editor.state.tr.setMeta(docAnchorsKey, meta).setMeta('addToHistory', false))\n}\n\ndeclare module '@tiptap/core' {\n  interface Storage { docAnchors: { resolver: AnchorResolver | null } }\n}\n\n/** The anchor resolver `editor` was created with; null without a collaboration-aware feature. */\nexport const anchorResolverOf = (editor: Editor): AnchorResolver | null => editor.storage.docAnchors?.resolver ?? null\n"],"mappings":"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"}
+{"version":3,"file":"doc-anchors.js","names":[],"sources":["../../src/core/doc-anchors.ts"],"sourcesContent":["import { type Editor, Extension } from '@tiptap/core'\nimport { type EditorState, Plugin, PluginKey } from '@tiptap/pm/state'\nimport type { AnchorResolver } from './feature'\nimport { newBlockId } from './schema/block-ids'\n\n/** A document range captured with `captureRange`: survives local and remote (collaborative) edits until released. */\nexport interface DocAnchor { readonly id: string }\n\n/** Current positions (-1 when gone) plus, with an `AnchorResolver`, its token for re-resolving after remote changes. */\ninterface AnchorEntry { from: number, to: number, token: unknown | null }\n\nexport const docAnchorsKey = new PluginKey<ReadonlyMap<string, AnchorEntry>>('docAnchors')\n\n/**\n * `add` captures an anchor; `remove` releases anchors. `after` (with `remove`) names collapsed anchors that, in this\n * transaction, move behind text inserted at their position instead of staying in front of it.\n */\nexport type DocAnchorsMeta = { add: { id: string, from: number, to: number, startInside: boolean } } | { remove: readonly string[], after?: readonly string[] }\n\nexport interface DocAnchorsOptions {\n  /** Position mapping that survives collaborative edits (see the collab feature); without one anchors only map through local transactions. */\n  resolver: AnchorResolver | null\n}\n\n/**\n * Edit-surviving ranges for AI flows (selection menu, AI sidebar, reviews, chat ops): anchors map through local\n * transactions and, with an `AnchorResolver`, re-resolve from its tokens on collaboration (y-sync) transactions, which\n * replace the whole document. Client-only: not part of the Vue-free schema.\n */\nexport const DocAnchors = Extension.create<DocAnchorsOptions, { resolver: AnchorResolver | null }>({\n  name: 'docAnchors',\n  priority: 1000,\n\n  addOptions: () => ({ resolver: null }),\n\n  addStorage() {\n    return { resolver: this.options.resolver }\n  },\n\n  addProseMirrorPlugins() {\n    const { resolver } = this.options\n    return [\n      new Plugin<ReadonlyMap<string, AnchorEntry>>({\n        key: docAnchorsKey,\n        state: {\n          init: () => new Map(),\n          apply(tr, value, _oldState, newState) {\n            const meta = tr.getMeta(docAnchorsKey) as DocAnchorsMeta | undefined\n            const after = meta && 'remove' in meta ? meta.after : undefined\n            if (!meta && (!tr.docChanged || !value.size)) return value\n            let next = value\n            if (tr.docChanged && value.size) {\n              const synced = resolver?.isYSync(tr) === true\n              const mapped = new Map<string, AnchorEntry>()\n              for (const [id, entry] of value) {\n                if (synced && resolver && entry.token != null) {\n                  mapped.set(id, { ...entry, ...(resolver.resolve(newState, entry.token) ?? { from: -1, to: -1 }) })\n                  continue\n                }\n                if (entry.from < 0) {\n                  mapped.set(id, entry)\n                  continue\n                }\n                // Like the resolver's positions: text inserted at a boundary stays outside (a collapsed anchor keeps it after itself,\n                // unless the transaction moves it behind that text).\n                const side = entry.from === entry.to ? (after?.includes(id) ? 1 : -1) : null\n                mapped.set(id, { ...entry, from: tr.mapping.map(entry.from, side ?? 1), to: tr.mapping.map(entry.to, side ?? -1) })\n              }\n              next = mapped\n            }\n            if (meta && 'add' in meta) {\n              const { id, from, to, startInside } = meta.add\n              next = new Map(next).set(id, { from, to, token: resolver?.capture(newState, { from, to }, startInside) ?? null })\n            }\n            else if (meta && meta.remove.some(id => next.has(id))) {\n              const kept = new Map(next)\n              for (const id of meta.remove) kept.delete(id)\n              next = kept\n            }\n            return next\n          },\n        },\n      }),\n    ]\n  },\n})\n\n/**\n * Captures [from, to] of the current document. Both ends stick to the text before them; `startInside` binds a\n * non-empty range's start to its own first character instead, so text inserted right before it stays outside.\n * Release with `releaseRanges` when the flow ends.\n */\nexport function captureRange(editor: Editor, { from, to }: { from: number, to: number }, options: { startInside?: boolean } = {}): DocAnchor {\n  const id = newBlockId()\n  const meta: DocAnchorsMeta = { add: { id, from, to, startInside: options.startInside ?? false } }\n  editor.view.dispatch(editor.state.tr.setMeta(docAnchorsKey, meta).setMeta('addToHistory', false))\n  return { id }\n}\n\n/** Current positions of `anchor`, collapsed (`from === to`) when its content was deleted; null when unknown or gone. */\nexport function resolveRange(state: EditorState, anchor: DocAnchor): { from: number, to: number } | null {\n  const entry = docAnchorsKey.getState(state)?.get(anchor.id)\n  if (!entry || entry.from < 0 || entry.from > entry.to || entry.to > state.doc.content.size) return null\n  return { from: entry.from, to: entry.to }\n}\n\n/** Forgets `anchors` (unknown ones are ignored). */\nexport function releaseRanges(editor: Editor, anchors: readonly DocAnchor[]): void {\n  if (editor.isDestroyed || !anchors.length) return\n  const meta: DocAnchorsMeta = { remove: anchors.map(a => a.id) }\n  editor.view.dispatch(editor.state.tr.setMeta(docAnchorsKey, meta).setMeta('addToHistory', false))\n}\n\ndeclare module '@tiptap/core' {\n  interface Storage { docAnchors: { resolver: AnchorResolver | null } }\n}\n\n/** The anchor resolver `editor` was created with; null without a collaboration-aware feature. */\nexport const anchorResolverOf = (editor: Editor): AnchorResolver | null => editor.storage.docAnchors?.resolver ?? null\n"],"mappings":"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"}

package/dist/core/editor-ui.js

@@ -1,3 +1,4 @@
+import { createMetadataRegistry } from "./metadata.js";
 //#region src/core/editor-ui.ts
 /** Each mounted surface's entry by its Tiptap editor (raw, unproxied instance), for components outside its subtree. */
 const entries = /* @__PURE__ */ new WeakMap();
@@ -32,7 +33,62 @@ function notifierOf(editor, app) {
 	};
 	return notify;
 }
+/**
+* The `FeatureContext` a component placed beside an editor (the toolbar) hands feature factories. App-level members
+* (`app`, `locale`, `t`, `settings`, `fetch`, `ai`) come from the app context; everything per-surface (`metadata`, `ui`, `documentId`,
+* `upload`, `collaboration`, `anchorResolver`, `abilities`, `slashCommands`) is read from the entry registered for
+* `getEditor()` each time it is used, so the context follows the editor while it changes and falls back to inert values
+* (an empty metadata registry, no-op chrome, `commentsOpen: false`) while there is none. `notify` is `notifierOf`.
+*/
+function borrowedFeatureContext(options) {
+	const { app, getEditor } = options;
+	const unwrap = options.unwrap ?? ((editor) => editor);
+	const rawEditor = () => {
+		const editor = getEditor();
+		return editor && unwrap(editor);
+	};
+	const fallbackMetadata = createMetadataRegistry();
+	const entry = () => editorEntryOf(rawEditor());
+	const ui = () => entry()?.ui;
+	return {
+		app,
+		locale: app.locale,
+		t: app.t,
+		settings: options.settings ?? app.settings,
+		notify: notifierOf(rawEditor, app),
+		fetch: app.fetch,
+		ai: app.ai,
+		get metadata() {
+			return entry()?.ctx.metadata ?? fallbackMetadata;
+		},
+		ui: {
+			openSettings: (tab) => ui()?.openSettings(tab),
+			toggleSidebar: () => ui()?.toggleSidebar(),
+			toggleComments: () => ui()?.toggleComments(),
+			get commentsOpen() {
+				return ui()?.commentsOpen ?? false;
+			}
+		},
+		get documentId() {
+			return entry()?.ctx.documentId;
+		},
+		get upload() {
+			return entry()?.ctx.upload;
+		},
+		get collaboration() {
+			return entry()?.ctx.collaboration;
+		},
+		get anchorResolver() {
+			return entry()?.ctx.anchorResolver ?? null;
+		},
+		get abilities() {
+			return entry()?.ctx.abilities ?? {};
+		},
+		slashCommands: () => entry()?.ctx.slashCommands() ?? [],
+		getEditor
+	};
+}
 //#endregion
-export { editorEntryOf, notifierOf, registerEditor };
+export { borrowedFeatureContext, editorEntryOf, notifierOf, registerEditor };
 
 //# sourceMappingURL=editor-ui.js.map

package/dist/core/editor-ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"editor-ui.js","names":[],"sources":["../../src/core/editor-ui.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorContext } from './context'\nimport type { EditorPreset, FeatureContext } from './feature'\nimport type { BlockAction } from './extension-points'\nimport type { Notifier } from './notify'\n\n/** Editor chrome an `EditorSurface` owns, for the components around it. Settings tabs are the ids features contribute. */\nexport interface EditorUi {\n  /** Opens the settings UI, on `tab` when given (else on the tab shown last). */\n  openSettings: (tab?: string) => void\n  /** Opens or closes the editor's AI sidebar (the surface's `sidebarOpen` model, which the host binds). */\n  toggleSidebar: () => void\n  /**\n   * Opens or closes the editor's comments margin (the surface's `commentsOpen` model, which the host binds). Opening it\n   * closes the AI sidebar and vice versa.\n   */\n  toggleComments: () => void\n  /** Whether the comments margin is open (read-only; for toggles' active state). */\n  readonly commentsOpen: boolean\n}\n\n/** What a mounted surface registers for its editor instance: the components beside it read it by `editor`. */\nexport interface EditorEntry {\n  ui: EditorUi\n  preset: EditorPreset\n  ctx: FeatureContext\n  /** Features' block actions followed by the host's, for the overlay that renders them. */\n  blockActions: readonly BlockAction[]\n}\n\n/** Each mounted surface's entry by its Tiptap editor (raw, unproxied instance), for components outside its subtree. */\nconst entries = new WeakMap<Editor, EditorEntry>()\n\n/**\n * Makes `entry` reachable through `editorEntryOf(editor)` (and the framework layers' `useEditorUi(editor)`); returns the\n * unregister function. The surface registers once its editor exists (before emitting `ready`) and unregisters on unmount.\n * Pass the raw editor: framework proxies (e.g. Vue reactive wrappers) are different WeakMap keys.\n */\nexport function registerEditor(editor: Editor, entry: EditorEntry): () => void {\n  entries.set(editor, entry)\n  return () => {\n    if (entries.get(editor) === entry) entries.delete(editor)\n  }\n}\n\n/** The surface entry registered for `editor` (the raw instance); undefined for an unregistered or missing editor. */\nexport function editorEntryOf(editor: Editor | undefined): EditorEntry | undefined {\n  return editor ? entries.get(editor) : undefined\n}\n\n/**\n * The one notifier policy: a notice goes to the surface notifier of `editor` (`createEditor`/`EditorSurface` of the\n * host) while it has one, else to the app context's. Both are resolved when a notice is shown (also `dismiss`), so a\n * request that finishes after an await still reaches the current surface. Pass `editor` (the raw instance) and `app` as\n * getters when they change over the notifier's life.\n */\nexport function notifierOf(editor: Editor | undefined | (() => Editor | undefined), app: Pick<EditorContext, 'notify'> | (() => Pick<EditorContext, 'notify'>)): Notifier {\n  const resolve = (): Notifier => {\n    const instance = typeof editor === 'function' ? editor() : editor\n    return editorEntryOf(instance)?.ctx.notify ?? (typeof app === 'function' ? app() : app).notify\n  }\n  const notify: Notifier = notice => resolve()(notice)\n  notify.dismiss = (id) => { resolve().dismiss?.(id) }\n  return notify\n}\n"],"mappings":";;AA+BA,MAAM,0BAAU,IAAI,QAA6B;;;;;;AAOjD,SAAgB,eAAe,QAAgB,OAAgC;CAC7E,QAAQ,IAAI,QAAQ,KAAK;CACzB,aAAa;EACX,IAAI,QAAQ,IAAI,MAAM,MAAM,OAAO,QAAQ,OAAO,MAAM;CAC1D;AACF;;AAGA,SAAgB,cAAc,QAAqD;CACjF,OAAO,SAAS,QAAQ,IAAI,MAAM,IAAI,KAAA;AACxC;;;;;;;AAQA,SAAgB,WAAW,QAAyD,KAAsF;CACxK,MAAM,gBAA0B;EAE9B,OAAO,cADU,OAAO,WAAW,aAAa,OAAO,IAAI,MAC9B,CAAC,EAAE,IAAI,WAAW,OAAO,QAAQ,aAAa,IAAI,IAAI,IAAA,CAAK;CAC1F;CACA,MAAM,UAAmB,WAAU,QAAQ,CAAC,CAAC,MAAM;CACnD,OAAO,WAAW,OAAO;EAAE,QAAQ,CAAC,CAAC,UAAU,EAAE;CAAE;CACnD,OAAO;AACT"}
+{"version":3,"file":"editor-ui.js","names":[],"sources":["../../src/core/editor-ui.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorContext } from './context'\nimport type { EditorPreset, FeatureContext } from './feature'\nimport type { BlockAction } from './extension-points'\nimport { createMetadataRegistry } from './metadata'\nimport type { Notifier } from './notify'\n\n/** Editor chrome an `EditorSurface` owns, for the components around it. Settings tabs are the ids features contribute. */\nexport interface EditorUi {\n  /** Opens the settings UI, on `tab` when given (else on the tab shown last). */\n  openSettings: (tab?: string) => void\n  /** Opens or closes the editor's AI sidebar (the surface's `sidebarOpen` model, which the host binds). */\n  toggleSidebar: () => void\n  /**\n   * Opens or closes the editor's comments margin (the surface's `commentsOpen` model, which the host binds). Opening it\n   * closes the AI sidebar and vice versa.\n   */\n  toggleComments: () => void\n  /** Whether the comments margin is open (read-only; for toggles' active state). */\n  readonly commentsOpen: boolean\n}\n\n/** What a mounted surface registers for its editor instance: the components beside it read it by `editor`. */\nexport interface EditorEntry {\n  ui: EditorUi\n  preset: EditorPreset\n  ctx: FeatureContext\n  /** Features' block actions followed by the host's, for the overlay that renders them. */\n  blockActions: readonly BlockAction[]\n}\n\n/** Each mounted surface's entry by its Tiptap editor (raw, unproxied instance), for components outside its subtree. */\nconst entries = new WeakMap<Editor, EditorEntry>()\n\n/**\n * Makes `entry` reachable through `editorEntryOf(editor)` (and the framework layers' `useEditorUi(editor)`); returns the\n * unregister function. The surface registers once its editor exists (before emitting `ready`) and unregisters on unmount.\n * Pass the raw editor: framework proxies (e.g. Vue reactive wrappers) are different WeakMap keys.\n */\nexport function registerEditor(editor: Editor, entry: EditorEntry): () => void {\n  entries.set(editor, entry)\n  return () => {\n    if (entries.get(editor) === entry) entries.delete(editor)\n  }\n}\n\n/** The surface entry registered for `editor` (the raw instance); undefined for an unregistered or missing editor. */\nexport function editorEntryOf(editor: Editor | undefined): EditorEntry | undefined {\n  return editor ? entries.get(editor) : undefined\n}\n\n/**\n * The one notifier policy: a notice goes to the surface notifier of `editor` (`createEditor`/`EditorSurface` of the\n * host) while it has one, else to the app context's. Both are resolved when a notice is shown (also `dismiss`), so a\n * request that finishes after an await still reaches the current surface. Pass `editor` (the raw instance) and `app` as\n * getters when they change over the notifier's life.\n */\nexport function notifierOf(editor: Editor | undefined | (() => Editor | undefined), app: Pick<EditorContext, 'notify'> | (() => Pick<EditorContext, 'notify'>)): Notifier {\n  const resolve = (): Notifier => {\n    const instance = typeof editor === 'function' ? editor() : editor\n    return editorEntryOf(instance)?.ctx.notify ?? (typeof app === 'function' ? app() : app).notify\n  }\n  const notify: Notifier = notice => resolve()(notice)\n  notify.dismiss = (id) => { resolve().dismiss?.(id) }\n  return notify\n}\n\nexport interface BorrowedFeatureContextOptions {\n  app: EditorContext\n  /** The editor the borrowing component works on, as its framework layer holds it; `undefined` while there is none. */\n  getEditor: () => Editor | undefined\n  /** Maps the held editor to the raw instance surfaces register (default: identity). Vue passes `toRaw`. */\n  unwrap?: (editor: Editor) => Editor\n  /** The `settings` the context exposes (default: the app's); a framework layer may wrap it so rendering tracks changes. */\n  settings?: FeatureContext['settings']\n}\n\n/**\n * The `FeatureContext` a component placed beside an editor (the toolbar) hands feature factories. App-level members\n * (`app`, `locale`, `t`, `settings`, `fetch`, `ai`) come from the app context; everything per-surface (`metadata`, `ui`, `documentId`,\n * `upload`, `collaboration`, `anchorResolver`, `abilities`, `slashCommands`) is read from the entry registered for\n * `getEditor()` each time it is used, so the context follows the editor while it changes and falls back to inert values\n * (an empty metadata registry, no-op chrome, `commentsOpen: false`) while there is none. `notify` is `notifierOf`.\n */\nexport function borrowedFeatureContext(options: BorrowedFeatureContextOptions): FeatureContext {\n  const { app, getEditor } = options\n  const unwrap = options.unwrap ?? (editor => editor)\n  const rawEditor = () => {\n    const editor = getEditor()\n    return editor && unwrap(editor)\n  }\n  const fallbackMetadata = createMetadataRegistry()\n  const entry = () => editorEntryOf(rawEditor())\n  const ui = () => entry()?.ui\n  return {\n    app,\n    locale: app.locale,\n    t: app.t,\n    settings: options.settings ?? app.settings,\n    notify: notifierOf(rawEditor, app),\n    fetch: app.fetch,\n    ai: app.ai,\n    get metadata() { return entry()?.ctx.metadata ?? fallbackMetadata },\n    ui: {\n      openSettings: tab => ui()?.openSettings(tab),\n      toggleSidebar: () => ui()?.toggleSidebar(),\n      toggleComments: () => ui()?.toggleComments(),\n      get commentsOpen() { return ui()?.commentsOpen ?? false },\n    },\n    get documentId() { return entry()?.ctx.documentId },\n    get upload() { return entry()?.ctx.upload },\n    get collaboration() { return entry()?.ctx.collaboration },\n    get anchorResolver() { return entry()?.ctx.anchorResolver ?? null },\n    get abilities() { return entry()?.ctx.abilities ?? {} },\n    slashCommands: () => entry()?.ctx.slashCommands() ?? [],\n    getEditor,\n  }\n}\n"],"mappings":";;;AAgCA,MAAM,0BAAU,IAAI,QAA6B;;;;;;AAOjD,SAAgB,eAAe,QAAgB,OAAgC;CAC7E,QAAQ,IAAI,QAAQ,KAAK;CACzB,aAAa;EACX,IAAI,QAAQ,IAAI,MAAM,MAAM,OAAO,QAAQ,OAAO,MAAM;CAC1D;AACF;;AAGA,SAAgB,cAAc,QAAqD;CACjF,OAAO,SAAS,QAAQ,IAAI,MAAM,IAAI,KAAA;AACxC;;;;;;;AAQA,SAAgB,WAAW,QAAyD,KAAsF;CACxK,MAAM,gBAA0B;EAE9B,OAAO,cADU,OAAO,WAAW,aAAa,OAAO,IAAI,MAC9B,CAAC,EAAE,IAAI,WAAW,OAAO,QAAQ,aAAa,IAAI,IAAI,IAAA,CAAK;CAC1F;CACA,MAAM,UAAmB,WAAU,QAAQ,CAAC,CAAC,MAAM;CACnD,OAAO,WAAW,OAAO;EAAE,QAAQ,CAAC,CAAC,UAAU,EAAE;CAAE;CACnD,OAAO;AACT;;;;;;;;AAmBA,SAAgB,uBAAuB,SAAwD;CAC7F,MAAM,EAAE,KAAK,cAAc;CAC3B,MAAM,SAAS,QAAQ,YAAW,WAAU;CAC5C,MAAM,kBAAkB;EACtB,MAAM,SAAS,UAAU;EACzB,OAAO,UAAU,OAAO,MAAM;CAChC;CACA,MAAM,mBAAmB,uBAAuB;CAChD,MAAM,cAAc,cAAc,UAAU,CAAC;CAC7C,MAAM,WAAW,MAAM,CAAC,EAAE;CAC1B,OAAO;EACL;EACA,QAAQ,IAAI;EACZ,GAAG,IAAI;EACP,UAAU,QAAQ,YAAY,IAAI;EAClC,QAAQ,WAAW,WAAW,GAAG;EACjC,OAAO,IAAI;EACX,IAAI,IAAI;EACR,IAAI,WAAW;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,YAAY;EAAiB;EAClE,IAAI;GACF,eAAc,QAAO,GAAG,CAAC,EAAE,aAAa,GAAG;GAC3C,qBAAqB,GAAG,CAAC,EAAE,cAAc;GACzC,sBAAsB,GAAG,CAAC,EAAE,eAAe;GAC3C,IAAI,eAAe;IAAE,OAAO,GAAG,CAAC,EAAE,gBAAgB;GAAM;EAC1D;EACA,IAAI,aAAa;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAW;EAClD,IAAI,SAAS;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAO;EAC1C,IAAI,gBAAgB;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAc;EACxD,IAAI,iBAAiB;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,kBAAkB;EAAK;EAClE,IAAI,YAAY;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC;EAAE;EACtD,qBAAqB,MAAM,CAAC,EAAE,IAAI,cAAc,KAAK,CAAC;EACtD;CACF;AACF"}