@ecsplico/editor 0.0.0-stage → 2.0.0

package/dist/server/node.js

@@ -0,0 +1,54 @@
+import { createServer } from "node:http";
+import nodeAdapter from "crossws/adapters/node";
+//#region src/server/node.ts
+/**
+* Serves `collab` on its own Node HTTP server: every websocket upgrade becomes a collaboration connection, whose user
+* the adapter authenticates from the upgrade request's headers and the client's `token`. For a plain Node script;
+* hosts with a web framework mount `collab.handleConnection` on its websocket support instead.
+*/
+async function listenCollab(collab, { port = 0, host } = {}) {
+	const connections = /* @__PURE__ */ new WeakMap();
+	const websockets = nodeAdapter({ hooks: {
+		open(peer) {
+			connections.set(peer, collab.handleConnection(peer.websocket, peer.request));
+		},
+		message(peer, message) {
+			connections.get(peer)?.handleMessage(message.uint8Array());
+		},
+		close(peer, details) {
+			connections.get(peer)?.handleClose({
+				code: details.code ?? 1e3,
+				reason: details.reason ?? ""
+			});
+		},
+		error(peer, error) {
+			console.error("[collab]", peer.id, error);
+		}
+	} });
+	const http = createServer((_request, response) => {
+		response.writeHead(426, { "Content-Type": "text/plain" }).end("Upgrade Required");
+	});
+	http.on("upgrade", (request, socket, head) => void websockets.handleUpgrade(request, socket, head));
+	await new Promise((resolve, reject) => {
+		http.once("error", reject);
+		http.listen({
+			port,
+			host
+		}, resolve);
+	});
+	const address = http.address();
+	if (!address || typeof address === "string") throw new Error("tiptap-editor: the collab HTTP server has no TCP address");
+	return {
+		port: address.port,
+		url: `ws://${host && host !== "0.0.0.0" ? host : "127.0.0.1"}:${address.port}`,
+		async close() {
+			http.close();
+			await collab.close();
+			websockets.closeAll();
+		}
+	};
+}
+//#endregion
+export { listenCollab };
+
+//# sourceMappingURL=node.js.map

package/dist/server/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../../src/server/node.ts"],"sourcesContent":["import { createServer } from 'node:http'\nimport nodeAdapter from 'crossws/adapters/node'\nimport type { CollabConnection, CollabServer } from './collab'\n\nexport interface CollabListenOptions {\n  /** Port to listen on; 0 picks a free one (see `CollabListener.port`). Default 0. */\n  port?: number\n  /** Address to bind. Default: all interfaces. */\n  host?: string\n}\n\nexport interface CollabListener {\n  /** The port the server listens on. */\n  port: number\n  /** `ws://` URL of the server: use it as the `HocuspocusProvider` `url`; the document is the provider's `name`. */\n  url: string\n  /** Closes the collab server (pending stores are written first), the websocket connections and the listening socket. */\n  close(): Promise<void>\n}\n\n/**\n * Serves `collab` on its own Node HTTP server: every websocket upgrade becomes a collaboration connection, whose user\n * the adapter authenticates from the upgrade request's headers and the client's `token`. For a plain Node script;\n * hosts with a web framework mount `collab.handleConnection` on its websocket support instead.\n */\nexport async function listenCollab(collab: CollabServer, { port = 0, host }: CollabListenOptions = {}): Promise<CollabListener> {\n  const connections = new WeakMap<object, CollabConnection>()\n  const websockets = nodeAdapter({\n    hooks: {\n      open(peer) {\n        connections.set(peer, collab.handleConnection(peer.websocket as Parameters<CollabServer['handleConnection']>[0], peer.request))\n      },\n      message(peer, message) {\n        connections.get(peer)?.handleMessage(message.uint8Array())\n      },\n      close(peer, details) {\n        connections.get(peer)?.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  const http = createServer((_request, response) => {\n    response.writeHead(426, { 'Content-Type': 'text/plain' }).end('Upgrade Required')\n  })\n  http.on('upgrade', (request, socket, head) => void websockets.handleUpgrade(request, socket, head))\n  await new Promise<void>((resolve, reject) => {\n    http.once('error', reject)\n    http.listen({ port, host }, resolve)\n  })\n  const address = http.address()\n  if (!address || typeof address === 'string') throw new Error('tiptap-editor: the collab HTTP server has no TCP address')\n  return {\n    port: address.port,\n    url: `ws://${host && host !== '0.0.0.0' ? host : '127.0.0.1'}:${address.port}`,\n    async close() {\n      http.close()\n      await collab.close()\n      websockets.closeAll()\n    },\n  }\n}\n"],"mappings":";;;;;;;;AAyBA,eAAsB,aAAa,QAAsB,EAAE,OAAO,GAAG,SAA8B,CAAC,GAA4B;CAC9H,MAAM,8BAAc,IAAI,QAAkC;CAC1D,MAAM,aAAa,YAAY,EAC7B,OAAO;EACL,KAAK,MAAM;GACT,YAAY,IAAI,MAAM,OAAO,iBAAiB,KAAK,WAA8D,KAAK,OAAO,CAAC;EAChI;EACA,QAAQ,MAAM,SAAS;GACrB,YAAY,IAAI,IAAI,CAAC,EAAE,cAAc,QAAQ,WAAW,CAAC;EAC3D;EACA,MAAM,MAAM,SAAS;GACnB,YAAY,IAAI,IAAI,CAAC,EAAE,YAAY;IAAE,MAAM,QAAQ,QAAQ;IAAM,QAAQ,QAAQ,UAAU;GAAG,CAAe;EAC/G;EACA,MAAM,MAAM,OAAO;GACjB,QAAQ,MAAM,YAAY,KAAK,IAAI,KAAK;EAC1C;CACF,EACF,CAAC;CACD,MAAM,OAAO,cAAc,UAAU,aAAa;EAChD,SAAS,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC,CAAC,CAAC,IAAI,kBAAkB;CAClF,CAAC;CACD,KAAK,GAAG,YAAY,SAAS,QAAQ,SAAS,KAAK,WAAW,cAAc,SAAS,QAAQ,IAAI,CAAC;CAClG,MAAM,IAAI,SAAe,SAAS,WAAW;EAC3C,KAAK,KAAK,SAAS,MAAM;EACzB,KAAK,OAAO;GAAE;GAAM;EAAK,GAAG,OAAO;CACrC,CAAC;CACD,MAAM,UAAU,KAAK,QAAQ;CAC7B,IAAI,CAAC,WAAW,OAAO,YAAY,UAAU,MAAM,IAAI,MAAM,0DAA0D;CACvH,OAAO;EACL,MAAM,QAAQ;EACd,KAAK,QAAQ,QAAQ,SAAS,YAAY,OAAO,YAAY,GAAG,QAAQ;EACxE,MAAM,QAAQ;GACZ,KAAK,MAAM;GACX,MAAM,OAAO,MAAM;GACnB,WAAW,SAAS;EACtB;CACF;AACF"}

package/dist/server/rate-limit.d.ts

@@ -0,0 +1,22 @@
+//#region src/server/rate-limit.d.ts
+export interface RateLimiterOptions {
+  /** Requests allowed per key within `windowMs`. */
+  max: number;
+  /** Length of the sliding window. */
+  windowMs: number;
+  /** Clock in milliseconds, for tests. Default `Date.now`. */
+  now?: () => number;
+}
+export interface RateLimiter {
+  /**
+   * Records one request for `key`. Returns 0 when it is allowed, otherwise the milliseconds until the oldest counted
+   * request leaves the window. Rejected requests are not counted, so hammering does not extend the wait.
+   */
+  hit(key: string): number;
+}
+/** Sliding-log rate limiter keyed by a caller-supplied id, per server process. */
+export declare function createRateLimiter({ max, windowMs, now }: RateLimiterOptions): RateLimiter;
+/** Stable rate-limit key of an adapter user: its `id`, else its `username`, else its serialized form. */
+export declare function userKey(user: object): string;
+//#endregion
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/server/rate-limit.js

@@ -0,0 +1,34 @@
+//#region src/server/rate-limit.ts
+/** Sliding-log rate limiter keyed by a caller-supplied id, per server process. */
+function createRateLimiter({ max, windowMs, now = Date.now }) {
+	/** Request timestamps per key within the current window. */
+	const hits = /* @__PURE__ */ new Map();
+	let lastSweep = 0;
+	return { hit(key) {
+		const at = now();
+		const since = at - windowMs;
+		if (at - lastSweep > windowMs) {
+			lastSweep = at;
+			for (const [k, times] of hits) if (times[times.length - 1] <= since) hits.delete(k);
+		}
+		const times = (hits.get(key) ?? []).filter((t) => t > since);
+		if (times.length >= max) {
+			hits.set(key, times);
+			return times[0] + windowMs - at;
+		}
+		times.push(at);
+		hits.set(key, times);
+		return 0;
+	} };
+}
+/** Stable rate-limit key of an adapter user: its `id`, else its `username`, else its serialized form. */
+function userKey(user) {
+	const { id, username } = user;
+	if (typeof id === "string" || typeof id === "number") return `id:${id}`;
+	if (typeof username === "string") return `name:${username}`;
+	return `json:${JSON.stringify(user)}`;
+}
+//#endregion
+export { createRateLimiter, userKey };
+
+//# sourceMappingURL=rate-limit.js.map

package/dist/server/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","names":[],"sources":["../../src/server/rate-limit.ts"],"sourcesContent":["export interface RateLimiterOptions {\n  /** Requests allowed per key within `windowMs`. */\n  max: number\n  /** Length of the sliding window. */\n  windowMs: number\n  /** Clock in milliseconds, for tests. Default `Date.now`. */\n  now?: () => number\n}\n\nexport interface RateLimiter {\n  /**\n   * Records one request for `key`. Returns 0 when it is allowed, otherwise the milliseconds until the oldest counted\n   * request leaves the window. Rejected requests are not counted, so hammering does not extend the wait.\n   */\n  hit(key: string): number\n}\n\n/** Sliding-log rate limiter keyed by a caller-supplied id, per server process. */\nexport function createRateLimiter({ max, windowMs, now = Date.now }: RateLimiterOptions): RateLimiter {\n  /** Request timestamps per key within the current window. */\n  const hits = new Map<string, number[]>()\n  let lastSweep = 0\n  return {\n    hit(key) {\n      const at = now()\n      const since = at - windowMs\n      if (at - lastSweep > windowMs) {\n        lastSweep = at\n        for (const [k, times] of hits) if (times[times.length - 1]! <= since) hits.delete(k)\n      }\n      const times = (hits.get(key) ?? []).filter(t => t > since)\n      if (times.length >= max) {\n        hits.set(key, times)\n        return times[0]! + windowMs - at\n      }\n      times.push(at)\n      hits.set(key, times)\n      return 0\n    },\n  }\n}\n\n/** Stable rate-limit key of an adapter user: its `id`, else its `username`, else its serialized form. */\nexport function userKey(user: object): string {\n  const { id, username } = user as { id?: unknown, username?: unknown }\n  if (typeof id === 'string' || typeof id === 'number') return `id:${id}`\n  if (typeof username === 'string') return `name:${username}`\n  // Adapter users without id/username: fall back to their serialized form (stable for the same user object shape).\n  return `json:${JSON.stringify(user)}`\n}\n"],"mappings":";;AAkBA,SAAgB,kBAAkB,EAAE,KAAK,UAAU,MAAM,KAAK,OAAwC;;CAEpG,MAAM,uBAAO,IAAI,IAAsB;CACvC,IAAI,YAAY;CAChB,OAAO,EACL,IAAI,KAAK;EACP,MAAM,KAAK,IAAI;EACf,MAAM,QAAQ,KAAK;EACnB,IAAI,KAAK,YAAY,UAAU;GAC7B,YAAY;GACZ,KAAK,MAAM,CAAC,GAAG,UAAU,MAAM,IAAI,MAAM,MAAM,SAAS,MAAO,OAAO,KAAK,OAAO,CAAC;EACrF;EACA,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK,CAAC,EAAA,CAAG,QAAO,MAAK,IAAI,KAAK;EACzD,IAAI,MAAM,UAAU,KAAK;GACvB,KAAK,IAAI,KAAK,KAAK;GACnB,OAAO,MAAM,KAAM,WAAW;EAChC;EACA,MAAM,KAAK,EAAE;EACb,KAAK,IAAI,KAAK,KAAK;EACnB,OAAO;CACT,EACF;AACF;;AAGA,SAAgB,QAAQ,MAAsB;CAC5C,MAAM,EAAE,IAAI,aAAa;CACzB,IAAI,OAAO,OAAO,YAAY,OAAO,OAAO,UAAU,OAAO,MAAM;CACnE,IAAI,OAAO,aAAa,UAAU,OAAO,QAAQ;CAEjD,OAAO,QAAQ,KAAK,UAAU,IAAI;AACpC"}

package/dist/settings/index.d.ts

@@ -0,0 +1,110 @@
+import { AI_LANGUAGES, AUTHOR_COLOR_STYLES, AiLanguage, AuthorColorStyle, COMMENTS_LAYOUTS, CommentsLayout, DRAG_HANDLE_VISIBILITIES, DragHandleVisibility, HEADING_CONVERSION_SCOPES, HeadingConversionScope, KIND_ICON_VISIBILITIES, KindIconVisibility, MODEL_SLOTS, ModelSlot, STRUCTURE_MODES, StructureMode, TREE_ROOTS, TreeRoot } from "./values.js";
+import { z } from "zod";
+//#region src/settings/index.d.ts
+export declare const EDITOR_SETTINGS_VERSION = 1;
+/** Valid theme id: lowercase slug, used as directory name and in `/api/editor/themes/:id`. Defined here so core never imports a feature. */
+export declare const THEME_ID: RegExp;
+/** A user's editor preferences, shared by all editors on the page; persisted per user through the `EditorAdapter`. */
+export interface EditorSettings {
+  version: typeof EDITOR_SETTINGS_VERSION;
+  editing: {
+    /** Blocks „Gliederung umwandeln“ (both directions) converts when nothing is selected. */
+    headingConversionScope: HeadingConversionScope;
+    /** Text is tinted per author (authors feature): each run in the colour of the user who wrote it. */
+    authorColors: boolean;
+    /** `background`: tinted background; `text`: text in the author's colour. */
+    authorColorStyle: AuthorColorStyle;
+    /** `margin`: comment cards in a column beside the text; `inline`: popover at the text plus the toolbar's list (comments feature). */
+    commentsLayout: CommentsLayout;
+  };
+  ai: {
+    /** Ghost-text suggestions while typing (`GhostAutocomplete`). */
+    autocomplete: boolean;
+    /** Model profile id per slot; a missing or unknown id falls back to the server's default preset for the slot. */
+    slots: Partial<Record<ModelSlot, string>>;
+    /** Preselected target language of „Übersetzen“. */
+    translateLanguage: AiLanguage;
+  };
+  blocks: {
+    /** Composite kind id the „Baustein“ shortcuts create (toolbar button, heading conversion). */
+    defaultKind: string;
+    /** Preferred document structure: toolbar block types and the structure of AI-generated blocks. */
+    structure: StructureMode;
+    /** Root of the document drawer while a composite file is loaded: nested in the folders, or the file itself. */
+    treeRoot: TreeRoot;
+    /** Kind icon of composites (their drag handle): always visible, or only on hover, focus or while the details are open. */
+    kindIcon: KindIconVisibility;
+    /** Standard drag handle of blocks without kind icon: on the hovered block, or permanently beside every block. */
+    dragHandle: DragHandleVisibility;
+  };
+  appearance: {
+    /** Id of the Obsidian theme applied to the whole app (themes feature); `null` = the standard Nuxt UI look. */
+    theme: string | null;
+  };
+}
+export declare const EDITOR_SETTINGS_DEFAULTS: EditorSettings;
+/** Complete, valid settings (the body of `PUT /api/editor/settings`). */
+export declare const editorSettingsSchema: z.ZodObject<{
+  version: z.ZodLiteral<1>;
+  editing: z.ZodObject<{
+    headingConversionScope: z.ZodEnum<{
+      container: "container";
+      document: "document";
+      heading: "heading";
+    }>;
+    authorColors: z.ZodBoolean;
+    authorColorStyle: z.ZodEnum<{
+      background: "background";
+      text: "text";
+    }>;
+    commentsLayout: z.ZodEnum<{
+      margin: "margin";
+      inline: "inline";
+    }>;
+  }, z.core.$strip>;
+  ai: z.ZodObject<{
+    autocomplete: z.ZodBoolean;
+    slots: z.ZodRecord<z.ZodEnum<{
+      complete: "complete";
+      rewrite: "rewrite";
+      generate: "generate";
+    }> & z.core.$partial, z.ZodString>;
+    translateLanguage: z.ZodEnum<{
+      Deutsch: "Deutsch";
+      Englisch: "Englisch";
+      Französisch: "Französisch";
+      Spanisch: "Spanisch";
+      Italienisch: "Italienisch";
+    }>;
+  }, z.core.$strip>;
+  blocks: z.ZodObject<{
+    defaultKind: z.ZodString;
+    structure: z.ZodEnum<{
+      flat: "flat";
+      composite: "composite";
+    }>;
+    treeRoot: z.ZodEnum<{
+      file: "file";
+      folders: "folders";
+    }>;
+    kindIcon: z.ZodEnum<{
+      always: "always";
+      hover: "hover";
+    }>;
+    dragHandle: z.ZodEnum<{
+      always: "always";
+      hover: "hover";
+    }>;
+  }, z.core.$strip>;
+  appearance: z.ZodObject<{
+    theme: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Accepts the legacy flat
+ * `{ headingConversionScope }` shape of the per-browser settings before version 1. Always returns fresh objects.
+ */
+export declare function parseEditorSettings(input: unknown): EditorSettings;
+//#endregion
+export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, AiLanguage, AuthorColorStyle, COMMENTS_LAYOUTS, CommentsLayout, DRAG_HANDLE_VISIBILITIES, DragHandleVisibility, HEADING_CONVERSION_SCOPES, HeadingConversionScope, KIND_ICON_VISIBILITIES, KindIconVisibility, MODEL_SLOTS, ModelSlot, STRUCTURE_MODES, StructureMode, TREE_ROOTS, TreeRoot };
+//# sourceMappingURL=index.d.ts.map

package/dist/settings/index.js

@@ -0,0 +1,114 @@
+import { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, STRUCTURE_MODES, TREE_ROOTS } from "./values.js";
+import { z } from "zod";
+//#region src/settings/index.ts
+const EDITOR_SETTINGS_VERSION = 1;
+/** Valid theme id: lowercase slug, used as directory name and in `/api/editor/themes/:id`. Defined here so core never imports a feature. */
+const THEME_ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const EDITOR_SETTINGS_DEFAULTS = {
+	version: 1,
+	editing: {
+		headingConversionScope: "container",
+		authorColors: false,
+		authorColorStyle: "background",
+		commentsLayout: "margin"
+	},
+	ai: {
+		autocomplete: false,
+		slots: {},
+		translateLanguage: "Englisch"
+	},
+	blocks: {
+		defaultKind: "section",
+		structure: "composite",
+		treeRoot: "folders",
+		kindIcon: "always",
+		dragHandle: "hover"
+	},
+	appearance: { theme: null }
+};
+const headingConversionScopeSchema = z.enum(HEADING_CONVERSION_SCOPES);
+const authorColorsSchema = z.boolean();
+const authorColorStyleSchema = z.enum(AUTHOR_COLOR_STYLES);
+const commentsLayoutSchema = z.enum(COMMENTS_LAYOUTS);
+const autocompleteSchema = z.boolean();
+const profileIdSchema = z.string().min(1).max(100);
+const translateLanguageSchema = z.enum(AI_LANGUAGES);
+const defaultKindSchema = z.string().min(1).max(100);
+const structureSchema = z.enum(STRUCTURE_MODES);
+const treeRootSchema = z.enum(TREE_ROOTS);
+const kindIconSchema = z.enum(KIND_ICON_VISIBILITIES);
+const dragHandleSchema = z.enum(DRAG_HANDLE_VISIBILITIES);
+const themeSchema = z.string().regex(THEME_ID).nullable();
+/** Complete, valid settings (the body of `PUT /api/editor/settings`). */
+const editorSettingsSchema = z.object({
+	version: z.literal(1),
+	editing: z.object({
+		headingConversionScope: headingConversionScopeSchema,
+		authorColors: authorColorsSchema,
+		authorColorStyle: authorColorStyleSchema,
+		commentsLayout: commentsLayoutSchema
+	}),
+	ai: z.object({
+		autocomplete: autocompleteSchema,
+		slots: z.partialRecord(z.enum(MODEL_SLOTS), profileIdSchema),
+		translateLanguage: translateLanguageSchema
+	}),
+	blocks: z.object({
+		defaultKind: defaultKindSchema,
+		structure: structureSchema,
+		treeRoot: treeRootSchema,
+		kindIcon: kindIconSchema,
+		dragHandle: dragHandleSchema
+	}),
+	appearance: z.object({ theme: themeSchema })
+});
+function record(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function valid(schema, value, fallback) {
+	const parsed = schema.safeParse(value);
+	return parsed.success ? parsed.data : fallback;
+}
+/**
+* Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Accepts the legacy flat
+* `{ headingConversionScope }` shape of the per-browser settings before version 1. Always returns fresh objects.
+*/
+function parseEditorSettings(input) {
+	const root = record(input);
+	const editing = record(root.editing);
+	const ai = record(root.ai);
+	const slots = record(ai.slots);
+	const blocks = record(root.blocks);
+	const appearance = record(root.appearance);
+	const defaults = EDITOR_SETTINGS_DEFAULTS;
+	const legacyScope = valid(headingConversionScopeSchema, root.headingConversionScope, defaults.editing.headingConversionScope);
+	return {
+		version: 1,
+		editing: {
+			headingConversionScope: valid(headingConversionScopeSchema, editing.headingConversionScope, legacyScope),
+			authorColors: valid(authorColorsSchema, editing.authorColors, defaults.editing.authorColors),
+			authorColorStyle: valid(authorColorStyleSchema, editing.authorColorStyle, defaults.editing.authorColorStyle),
+			commentsLayout: valid(commentsLayoutSchema, editing.commentsLayout, defaults.editing.commentsLayout)
+		},
+		ai: {
+			autocomplete: valid(autocompleteSchema, ai.autocomplete, defaults.ai.autocomplete),
+			slots: Object.fromEntries(MODEL_SLOTS.flatMap((slot) => {
+				const parsed = profileIdSchema.safeParse(slots[slot]);
+				return parsed.success ? [[slot, parsed.data]] : [];
+			})),
+			translateLanguage: valid(translateLanguageSchema, ai.translateLanguage, defaults.ai.translateLanguage)
+		},
+		blocks: {
+			defaultKind: valid(defaultKindSchema, blocks.defaultKind, defaults.blocks.defaultKind),
+			structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),
+			treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),
+			kindIcon: valid(kindIconSchema, blocks.kindIcon, defaults.blocks.kindIcon),
+			dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle)
+		},
+		appearance: { theme: valid(themeSchema, appearance.theme, defaults.appearance.theme) }
+	};
+}
+//#endregion
+export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, EDITOR_SETTINGS_DEFAULTS, EDITOR_SETTINGS_VERSION, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, STRUCTURE_MODES, THEME_ID, TREE_ROOTS, editorSettingsSchema, parseEditorSettings };
+
+//# sourceMappingURL=index.js.map

package/dist/settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/settings/index.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  AI_LANGUAGES,\n  type AiLanguage,\n  AUTHOR_COLOR_STYLES,\n  type AuthorColorStyle,\n  COMMENTS_LAYOUTS,\n  type CommentsLayout,\n  DRAG_HANDLE_VISIBILITIES,\n  type DragHandleVisibility,\n  HEADING_CONVERSION_SCOPES,\n  type HeadingConversionScope,\n  KIND_ICON_VISIBILITIES,\n  type KindIconVisibility,\n  MODEL_SLOTS,\n  type ModelSlot,\n  STRUCTURE_MODES,\n  type StructureMode,\n  TREE_ROOTS,\n  type TreeRoot,\n} from './values'\n\nexport * from './values'\n\nexport const EDITOR_SETTINGS_VERSION = 1\n\n/** Valid theme id: lowercase slug, used as directory name and in `/api/editor/themes/:id`. Defined here so core never imports a feature. */\nexport const THEME_ID = /^[a-z0-9][a-z0-9-]{0,63}$/\n\n/** A user's editor preferences, shared by all editors on the page; persisted per user through the `EditorAdapter`. */\nexport interface EditorSettings {\n  version: typeof EDITOR_SETTINGS_VERSION\n  editing: {\n    /** Blocks „Gliederung umwandeln“ (both directions) converts when nothing is selected. */\n    headingConversionScope: HeadingConversionScope\n    /** Text is tinted per author (authors feature): each run in the colour of the user who wrote it. */\n    authorColors: boolean\n    /** `background`: tinted background; `text`: text in the author's colour. */\n    authorColorStyle: AuthorColorStyle\n    /** `margin`: comment cards in a column beside the text; `inline`: popover at the text plus the toolbar's list (comments feature). */\n    commentsLayout: CommentsLayout\n  }\n  ai: {\n    /** Ghost-text suggestions while typing (`GhostAutocomplete`). */\n    autocomplete: boolean\n    /** Model profile id per slot; a missing or unknown id falls back to the server's default preset for the slot. */\n    slots: Partial<Record<ModelSlot, string>>\n    /** Preselected target language of „Übersetzen“. */\n    translateLanguage: AiLanguage\n  }\n  blocks: {\n    /** Composite kind id the „Baustein“ shortcuts create (toolbar button, heading conversion). */\n    defaultKind: string\n    /** Preferred document structure: toolbar block types and the structure of AI-generated blocks. */\n    structure: StructureMode\n    /** Root of the document drawer while a composite file is loaded: nested in the folders, or the file itself. */\n    treeRoot: TreeRoot\n    /** Kind icon of composites (their drag handle): always visible, or only on hover, focus or while the details are open. */\n    kindIcon: KindIconVisibility\n    /** Standard drag handle of blocks without kind icon: on the hovered block, or permanently beside every block. */\n    dragHandle: DragHandleVisibility\n  }\n  appearance: {\n    /** Id of the Obsidian theme applied to the whole app (themes feature); `null` = the standard Nuxt UI look. */\n    theme: string | null\n  }\n}\n\nexport const EDITOR_SETTINGS_DEFAULTS: EditorSettings = {\n  version: EDITOR_SETTINGS_VERSION,\n  editing: { headingConversionScope: 'container', authorColors: false, authorColorStyle: 'background', commentsLayout: 'margin' },\n  ai: { autocomplete: false, slots: {}, translateLanguage: 'Englisch' },\n  blocks: { defaultKind: 'section', structure: 'composite', treeRoot: 'folders', kindIcon: 'always', dragHandle: 'hover' },\n  appearance: { theme: null },\n}\n\nconst headingConversionScopeSchema = z.enum(HEADING_CONVERSION_SCOPES)\nconst authorColorsSchema = z.boolean()\nconst authorColorStyleSchema = z.enum(AUTHOR_COLOR_STYLES)\nconst commentsLayoutSchema = z.enum(COMMENTS_LAYOUTS)\nconst autocompleteSchema = z.boolean()\nconst profileIdSchema = z.string().min(1).max(100)\nconst translateLanguageSchema = z.enum(AI_LANGUAGES)\nconst defaultKindSchema = z.string().min(1).max(100)\nconst structureSchema = z.enum(STRUCTURE_MODES)\nconst treeRootSchema = z.enum(TREE_ROOTS)\nconst kindIconSchema = z.enum(KIND_ICON_VISIBILITIES)\nconst dragHandleSchema = z.enum(DRAG_HANDLE_VISIBILITIES)\nconst themeSchema = z.string().regex(THEME_ID).nullable()\n\n/** Complete, valid settings (the body of `PUT /api/editor/settings`). */\nexport const editorSettingsSchema = z.object({\n  version: z.literal(EDITOR_SETTINGS_VERSION),\n  editing: z.object({\n    headingConversionScope: headingConversionScopeSchema,\n    authorColors: authorColorsSchema,\n    authorColorStyle: authorColorStyleSchema,\n    commentsLayout: commentsLayoutSchema,\n  }),\n  ai: z.object({\n    autocomplete: autocompleteSchema,\n    slots: z.partialRecord(z.enum(MODEL_SLOTS), profileIdSchema),\n    translateLanguage: translateLanguageSchema,\n  }),\n  blocks: z.object({\n    defaultKind: defaultKindSchema,\n    structure: structureSchema,\n    treeRoot: treeRootSchema,\n    kindIcon: kindIconSchema,\n    dragHandle: dragHandleSchema,\n  }),\n  appearance: z.object({ theme: themeSchema }),\n}) satisfies z.ZodType<EditorSettings>\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}\n}\n\nfunction valid<T>(schema: z.ZodType<T>, value: unknown, fallback: T): T {\n  const parsed = schema.safeParse(value)\n  return parsed.success ? parsed.data : fallback\n}\n\n/**\n * Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Accepts the legacy flat\n * `{ headingConversionScope }` shape of the per-browser settings before version 1. Always returns fresh objects.\n */\nexport function parseEditorSettings(input: unknown): EditorSettings {\n  const root = record(input)\n  const editing = record(root.editing)\n  const ai = record(root.ai)\n  const slots = record(ai.slots)\n  const blocks = record(root.blocks)\n  const appearance = record(root.appearance)\n  const defaults = EDITOR_SETTINGS_DEFAULTS\n  const legacyScope = valid(headingConversionScopeSchema, root.headingConversionScope, defaults.editing.headingConversionScope)\n  return {\n    version: EDITOR_SETTINGS_VERSION,\n    editing: {\n      headingConversionScope: valid(headingConversionScopeSchema, editing.headingConversionScope, legacyScope),\n      authorColors: valid(authorColorsSchema, editing.authorColors, defaults.editing.authorColors),\n      authorColorStyle: valid(authorColorStyleSchema, editing.authorColorStyle, defaults.editing.authorColorStyle),\n      commentsLayout: valid(commentsLayoutSchema, editing.commentsLayout, defaults.editing.commentsLayout),\n    },\n    ai: {\n      autocomplete: valid(autocompleteSchema, ai.autocomplete, defaults.ai.autocomplete),\n      slots: Object.fromEntries(MODEL_SLOTS.flatMap((slot) => {\n        const parsed = profileIdSchema.safeParse(slots[slot])\n        return parsed.success ? [[slot, parsed.data]] : []\n      })),\n      translateLanguage: valid(translateLanguageSchema, ai.translateLanguage, defaults.ai.translateLanguage),\n    },\n    blocks: {\n      defaultKind: valid(defaultKindSchema, blocks.defaultKind, defaults.blocks.defaultKind),\n      structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),\n      treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),\n      kindIcon: valid(kindIconSchema, blocks.kindIcon, defaults.blocks.kindIcon),\n      dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle),\n    },\n    appearance: {\n      theme: valid(themeSchema, appearance.theme, defaults.appearance.theme),\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/settings/values.d.ts

@@ -0,0 +1,35 @@
+//#region src/settings/values.d.ts
+/** Feature slots a model profile can be assigned to. */
+export declare const MODEL_SLOTS: readonly ["complete", "rewrite", "generate"];
+export type ModelSlot = typeof MODEL_SLOTS[number];
+/** Target languages of the `translate` task: the stored ids, also the language name the model is asked for; displayed through the catalogs. */
+export declare const AI_LANGUAGES: readonly ["Deutsch", "Englisch", "Französisch", "Spanisch", "Italienisch"];
+export type AiLanguage = (typeof AI_LANGUAGES)[number];
+export declare const HEADING_CONVERSION_SCOPES: readonly ["container", "document", "heading"];
+/** Blocks converted when nothing is selected: the caret's composite body / document, the whole document, or the caret's heading with its content. */
+export type HeadingConversionScope = (typeof HEADING_CONVERSION_SCOPES)[number];
+/** How a user prefers documents structured: Markdown headings, or nested composites („Bausteine“). */
+export declare const STRUCTURE_MODES: readonly ["flat", "composite"];
+export type StructureMode = (typeof STRUCTURE_MODES)[number];
+/**
+ * What the document drawer's tree is rooted in while a composite file (a document with Bausteine) is loaded:
+ * `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded
+ * file itself the single root, with its Ordner/Dokument composites as the hierarchy below. Without a loaded composite
+ * file the drawer always shows the folders.
+ */
+export declare const TREE_ROOTS: readonly ["folders", "file"];
+export type TreeRoot = (typeof TREE_ROOTS)[number];
+/** When a composite shows its kind icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */
+export declare const KIND_ICON_VISIBILITIES: readonly ["always", "hover"];
+export type KindIconVisibility = (typeof KIND_ICON_VISIBILITIES)[number];
+/** When the standard drag handle of blocks without kind icon shows: on the hovered block, or permanently beside every block. */
+export declare const DRAG_HANDLE_VISIBILITIES: readonly ["hover", "always"];
+export type DragHandleVisibility = (typeof DRAG_HANDLE_VISIBILITIES)[number];
+/** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */
+export declare const AUTHOR_COLOR_STYLES: readonly ["background", "text"];
+export type AuthorColorStyle = (typeof AUTHOR_COLOR_STYLES)[number];
+/** How a user wants comments shown (comments feature): cards in a margin column beside the text, or a popover at the text with a list in the toolbar. */
+export declare const COMMENTS_LAYOUTS: readonly ["margin", "inline"];
+export type CommentsLayout = (typeof COMMENTS_LAYOUTS)[number];
+//#endregion
+//# sourceMappingURL=values.d.ts.map

package/dist/settings/values.js

@@ -0,0 +1,41 @@
+//#region src/settings/values.ts
+/** Feature slots a model profile can be assigned to. */
+const MODEL_SLOTS = [
+	"complete",
+	"rewrite",
+	"generate"
+];
+/** Target languages of the `translate` task: the stored ids, also the language name the model is asked for; displayed through the catalogs. */
+const AI_LANGUAGES = [
+	"Deutsch",
+	"Englisch",
+	"Französisch",
+	"Spanisch",
+	"Italienisch"
+];
+const HEADING_CONVERSION_SCOPES = [
+	"container",
+	"document",
+	"heading"
+];
+/** How a user prefers documents structured: Markdown headings, or nested composites („Bausteine“). */
+const STRUCTURE_MODES = ["flat", "composite"];
+/**
+* What the document drawer's tree is rooted in while a composite file (a document with Bausteine) is loaded:
+* `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded
+* file itself the single root, with its Ordner/Dokument composites as the hierarchy below. Without a loaded composite
+* file the drawer always shows the folders.
+*/
+const TREE_ROOTS = ["folders", "file"];
+/** When a composite shows its kind icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */
+const KIND_ICON_VISIBILITIES = ["always", "hover"];
+/** When the standard drag handle of blocks without kind icon shows: on the hovered block, or permanently beside every block. */
+const DRAG_HANDLE_VISIBILITIES = ["hover", "always"];
+/** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */
+const AUTHOR_COLOR_STYLES = ["background", "text"];
+/** How a user wants comments shown (comments feature): cards in a margin column beside the text, or a popover at the text with a list in the toolbar. */
+const COMMENTS_LAYOUTS = ["margin", "inline"];
+//#endregion
+export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, STRUCTURE_MODES, TREE_ROOTS };
+
+//# sourceMappingURL=values.js.map

package/dist/settings/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","names":[],"sources":["../../src/settings/values.ts"],"sourcesContent":["// Inert enum values of the stored settings model. Vue-free and free of feature code: the settings schema imports only\n// this file, features import their values from here. Their presence does not install any feature.\n\n/** Feature slots a model profile can be assigned to. */\nexport const MODEL_SLOTS = ['complete', 'rewrite', 'generate'] as const\nexport type ModelSlot = typeof MODEL_SLOTS[number]\n\n/** Target languages of the `translate` task: the stored ids, also the language name the model is asked for; displayed through the catalogs. */\n// i18n-ignore: stored setting ids, not display text\nexport const AI_LANGUAGES = ['Deutsch', 'Englisch', 'Französisch', 'Spanisch', 'Italienisch'] as const\nexport type AiLanguage = (typeof AI_LANGUAGES)[number]\n\nexport const HEADING_CONVERSION_SCOPES = ['container', 'document', 'heading'] as const\n/** Blocks converted when nothing is selected: the caret's composite body / document, the whole document, or the caret's heading with its content. */\nexport type HeadingConversionScope = (typeof HEADING_CONVERSION_SCOPES)[number]\n\n/** How a user prefers documents structured: Markdown headings, or nested composites („Bausteine“). */\nexport const STRUCTURE_MODES = ['flat', 'composite'] as const\nexport type StructureMode = (typeof STRUCTURE_MODES)[number]\n\n/**\n * What the document drawer's tree is rooted in while a composite file (a document with Bausteine) is loaded:\n * `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded\n * file itself the single root, with its Ordner/Dokument composites as the hierarchy below. Without a loaded composite\n * file the drawer always shows the folders.\n */\nexport const TREE_ROOTS = ['folders', 'file'] as const\nexport type TreeRoot = (typeof TREE_ROOTS)[number]\n\n/** When a composite shows its kind icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */\nexport const KIND_ICON_VISIBILITIES = ['always', 'hover'] as const\nexport type KindIconVisibility = (typeof KIND_ICON_VISIBILITIES)[number]\n\n/** When the standard drag handle of blocks without kind icon shows: on the hovered block, or permanently beside every block. */\nexport const DRAG_HANDLE_VISIBILITIES = ['hover', 'always'] as const\nexport type DragHandleVisibility = (typeof DRAG_HANDLE_VISIBILITIES)[number]\n\n/** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */\nexport const AUTHOR_COLOR_STYLES = ['background', 'text'] as const\nexport type AuthorColorStyle = (typeof AUTHOR_COLOR_STYLES)[number]\n\n/** How a user wants comments shown (comments feature): cards in a margin column beside the text, or a popover at the text with a list in the toolbar. */\nexport const COMMENTS_LAYOUTS = ['margin', 'inline'] as const\nexport type CommentsLayout = (typeof COMMENTS_LAYOUTS)[number]\n"],"mappings":";;AAIA,MAAa,cAAc;CAAC;CAAY;CAAW;AAAU;;AAK7D,MAAa,eAAe;CAAC;CAAW;CAAY;CAAe;CAAY;AAAa;AAG5F,MAAa,4BAA4B;CAAC;CAAa;CAAY;AAAS;;AAK5E,MAAa,kBAAkB,CAAC,QAAQ,WAAW;;;;;;;AASnD,MAAa,aAAa,CAAC,WAAW,MAAM;;AAI5C,MAAa,yBAAyB,CAAC,UAAU,OAAO;;AAIxD,MAAa,2BAA2B,CAAC,SAAS,QAAQ;;AAI1D,MAAa,sBAAsB,CAAC,cAAc,MAAM;;AAIxD,MAAa,mBAAmB,CAAC,UAAU,QAAQ"}

package/dist/styles/ai.css

@@ -0,0 +1,77 @@
+/* AI feature styles: ghost autocomplete, selection highlight, review decorations, previews. Import after `tailwindcss` and the UI kit's stylesheet (`vue/kit/nuxt-ui.css`). */
+/* GhostAutocomplete: local AI suggestion after the caret (widget decoration, never in the document). */
+@layer components {
+  .tiptap .ghost-autocomplete {
+    color: var(--sk-fg-dimmed);
+    pointer-events: none;
+    user-select: none;
+  }
+  .tiptap .ghost-autocomplete::after {
+    content: 'Tab';
+    margin-left: 0.4em;
+    padding: 0 0.3em;
+    border: 1px solid var(--sk-border-accented);
+    border-radius: 0.25rem;
+    font-size: 0.7em;
+    font-style: normal;
+    font-weight: 500;
+    vertical-align: 0.15em;
+  }
+}
+
+/* AiSelectionHighlight: the text an open selection AI menu works on (local inline decoration, never in the document). */
+@layer components {
+  .tiptap .ai-selection-highlight {
+    background: color-mix(in oklab, var(--sk-primary) 22%, transparent);
+    box-decoration-break: clone;
+  }
+}
+
+/* AiReview: pending AI changes (local decorations, never in the document). Deleted text struck red, inserted text as green widgets. */
+@layer components {
+  .tiptap .ai-review-del,
+  .tiptap .ai-review-del-block,
+  .tiptap .ai-review-ins,
+  .tiptap .ai-review-ins-block { cursor: pointer; box-decoration-break: clone; }
+  .tiptap .ai-review-del {
+    color: var(--sk-danger);
+    background: color-mix(in oklab, var(--sk-danger) 12%, transparent);
+    text-decoration: line-through;
+  }
+  /* A whole block proposed for deletion (node decoration). */
+  .tiptap .ai-review-del-block {
+    color: var(--sk-danger);
+    background: color-mix(in oklab, var(--sk-danger) 10%, transparent);
+    text-decoration: line-through;
+    border-radius: var(--sk-radius);
+    box-shadow: -3px 0 0 var(--sk-danger);
+  }
+  .tiptap .ai-review-del-block img { opacity: 0.5; }
+  .tiptap .ai-review-ins {
+    color: var(--sk-success);
+    background: color-mix(in oklab, var(--sk-success) 14%, transparent);
+  }
+  .tiptap .ai-review-ins-block {
+    color: var(--sk-success);
+    background: color-mix(in oklab, var(--sk-success) 10%, transparent);
+    border-left: 3px solid var(--sk-success);
+    border-radius: var(--sk-radius);
+    padding: 0.1em 0.75em;
+    margin: 0.25em 0;
+  }
+  .tiptap .ai-review-del.is-active,
+  .tiptap .ai-review-del-block.is-active,
+  .tiptap .ai-review-ins.is-active,
+  .tiptap .ai-review-ins-block.is-active { outline: 2px solid var(--sk-primary); outline-offset: 1px; }
+}
+
+/* Result preview of the selection AI menu: unlayered, to override the base `.tiptap` editor size. */
+.tiptap.ai-selection-preview { min-height: 0; padding-left: 0; }
+
+/* Answers in the document chat: quote links jump to their block. */
+@layer components {
+  .document-chat-answer a { color: var(--sk-primary); text-decoration: underline; text-underline-offset: 2px; cursor: pointer; }
+}
+
+/* Unlayered like the `.tiptap` base rule above, which it overrides for the compact chat answers. */
+.document-chat-answer .tiptap { min-height: 0; padding-left: 0; }

package/dist/styles/authors.css

@@ -0,0 +1,18 @@
+/* Authors feature styles (import after `tailwindcss` and the UI kit's stylesheet (`vue/kit/nuxt-ui.css`)). AuthorMark: who wrote a text run; styled only while the colouring mode is on (the authors feature puts `author-colors` on the editor element). */
+@layer components {
+  .tiptap.author-colors .author {
+    background: color-mix(in oklab, var(--author-color, var(--sk-muted)) 18%, transparent);
+    border-radius: 0.15rem;
+    box-decoration-break: clone;
+    position: relative;
+  }
+  .tiptap.author-colors--text .author { background: none; color: var(--author-color, inherit); }
+  /* Hovering a run names its author (pure CSS, `data-author-name`). */
+  .tiptap.author-colors .author:hover::after {
+    content: attr(data-author-name);
+    position: absolute; left: 0; top: -1.5em; z-index: 1;
+    padding: 0 0.3em; border-radius: 0.25rem; border: 1px solid var(--sk-border);
+    background: var(--sk-bg-elevated); color: var(--sk-fg); font-size: 0.7rem; font-style: normal; font-weight: 500;
+    white-space: nowrap; pointer-events: none;
+  }
+}

package/dist/styles/block-ui.css

@@ -0,0 +1,16 @@
+/* Block range selection of the block-ui feature (NodeRange). Import after `tailwindcss` and the UI kit's stylesheet (`vue/kit/nuxt-ui.css`). */
+@layer components {
+  /* NodeRange: block-range selection (Mod+drag, Shift+↑/↓). The native selection is hidden, blocks get a tint. */
+  .tiptap.ProseMirror-noderangeselection *::selection { background: transparent; }
+  .tiptap.ProseMirror-noderangeselection { caret-color: transparent; }
+  .tiptap .ProseMirror-selectednoderange { position: relative; }
+  .tiptap .ProseMirror-selectednoderange::before {
+    content: '';
+    position: absolute;
+    inset: -0.25rem;
+    z-index: -1;
+    pointer-events: none;
+    border-radius: 0.25rem;
+    background: color-mix(in oklab, var(--sk-primary) 15%, transparent);
+  }
+}

package/dist/styles/collab.css

@@ -0,0 +1,26 @@
+/* Remote carets of the collab feature (CollaborationCaret). Import after `tailwindcss` and the UI kit's stylesheet (`vue/kit/nuxt-ui.css`). */
+@layer components {
+  .tiptap .collaboration-carets__caret {
+    border-left: 1px solid;
+    border-right: 1px solid;
+    margin: 0 -1px;
+    pointer-events: none;
+    position: relative;
+    word-break: normal;
+  }
+
+  .tiptap .collaboration-carets__label {
+    border-radius: 3px 3px 3px 0;
+    color: #0d0d0d;
+    font-size: 12px;
+    font-style: normal;
+    font-weight: 600;
+    left: -1px;
+    line-height: normal;
+    padding: 0.1rem 0.3rem;
+    position: absolute;
+    top: -1.4em;
+    user-select: none;
+    white-space: nowrap;
+  }
+}

package/dist/styles/comments.css

@@ -0,0 +1,11 @@
+/* Comments feature styles (import after `tailwindcss` and the UI kit's stylesheet (`vue/kit/nuxt-ui.css`)). Comments: thread highlights are decorations driven by thread state (the `comment` mark only stores the range). */
+@layer components {
+  .tiptap .comment-hl {
+    background: color-mix(in oklab, var(--sk-warning) 22%, transparent);
+    border-bottom: 2px solid color-mix(in oklab, var(--sk-warning) 60%, transparent);
+    box-decoration-break: clone;
+    cursor: pointer;
+  }
+  .tiptap .comment-hl--active,
+  .tiptap .comment-hl--draft { background: color-mix(in oklab, var(--sk-warning) 45%, transparent); }
+}