@ecsplico/editor 2.1.2 → 3.0.0

package/dist/features/media/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","names":[],"sources":["../../../src/features/media/upload.ts"],"sourcesContent":["import { type Editor, Extension, type JSONContent } from '@tiptap/core'\nimport type { FeatureContext, UploadFn } from '../../core'\nimport { SCRATCH_DOCUMENT_ID } from './assets'\nimport { mediaKindOf, mediaMime } from './schema'\n\n/** `importFiles` of the media feature: imports `files` at `pos` (default: the selection), toasting failures; resolves whether every file was imported. */\nexport type ImportFilesFn = (editor: Editor, files: File[] | FileList, pos?: number) => Promise<boolean>\n\n/** Default upload: POSTs `file` to the asset endpoint of document `documentId` through the context's HTTP client (size limits per kind, see schema.ts). */\nexport async function postUpload(fetch: FeatureContext['fetch'], documentId: string, file: File): Promise<{ url: string }> {\n  const body = new FormData()\n  body.append('file', file)\n  return await fetch<{ url: string }>(`/api/editor/assets/${documentId}`, { method: 'POST', body })\n}\n\n/** The upload of a surface: the host's `upload` prop, else the asset endpoint of its `documentId` (default: the shared `scratch` owner). */\nexport const uploadOf = (ctx: FeatureContext): UploadFn =>\n  ctx.upload ?? (file => postUpload(ctx.fetch, ctx.documentId ?? SCRATCH_DOCUMENT_ID, file))\n\n/** Makes the upload and the file import reachable as `editor.storage.media` (drop/paste, toolbar, slash menu, recorder). */\nexport const Media = Extension.create<{ upload: UploadFn, importFiles: ImportFilesFn }, { upload: UploadFn, importFiles: ImportFilesFn }>({\n  name: 'media',\n\n  addOptions() {\n    return {\n      upload: () => Promise.reject(new Error('@ecsplico/editor: Media.configure({ upload }) fehlt')),\n      importFiles: () => Promise.reject(new Error('@ecsplico/editor: Media.configure({ importFiles }) fehlt')),\n    }\n  },\n\n  addStorage() {\n    return { upload: this.options.upload, importFiles: this.options.importFiles }\n  },\n})\n\ndeclare module '@tiptap/core' {\n  interface Storage {\n    media: { upload: UploadFn, importFiles: ImportFilesFn }\n  }\n}\n\n/** The node that embeds uploaded `file` from `url`; null for files uploads do not accept. */\nexport function mediaNodeFor(file: File, url: string): JSONContent | null {\n  const kind = mediaKindOf(file.type)\n  if (!kind) return null\n  if (kind === 'image') return { type: 'image', attrs: { src: url, alt: file.name } }\n  return { type: kind, attrs: { src: url, title: file.name, mimeType: mediaMime(file.type) } }\n}\n\n/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …). */\nexport function fileNodeFor(file: File, url: string): JSONContent {\n  return {\n    type: 'file',\n    attrs: { src: url, title: file.name, mimeType: mediaMime(file.type) || 'application/octet-stream', size: file.size },\n  }\n}\n\n/** Human-readable byte count: 1024-based, one decimal (`1536` → `1.5 KB`), units B/KB/MB/GB. */\nexport function formatBytes(bytes: number): string {\n  const units = ['B', 'KB', 'MB', 'GB']\n  let value = Math.max(0, bytes)\n  let unit = 0\n  while (value >= 1024 && unit < units.length - 1) {\n    value /= 1024\n    unit++\n  }\n  return unit === 0 ? `${value} B` : `${value.toFixed(1)} ${units[unit]}`\n}\n\n/** Transaction meta the recorder modal (AudioRecorderModal) listens for: open it, inserting at the current caret. */\nexport const AUDIO_RECORDER_OPEN = 'audioRecorderOpen'\n\nexport function openAudioRecorder(editor: Editor): void {\n  editor.view.dispatch(editor.state.tr.setMeta(AUDIO_RECORDER_OPEN, true).setMeta('addToHistory', false))\n}\n\n/** Opens the browser's file picker; resolves the chosen files, `[]` when the picker is cancelled. */\nexport function pickFiles(accept: string, multiple = true): Promise<File[]> {\n  const { promise, resolve } = Promise.withResolvers<File[]>()\n  const input = document.createElement('input')\n  input.type = 'file'\n  input.accept = accept\n  input.multiple = multiple\n  input.hidden = true\n  // Attached while open: some Safari versions fire no `change` for detached inputs.\n  document.body.append(input)\n  const done = (files: File[]) => {\n    input.remove()\n    resolve(files)\n  }\n  input.addEventListener('change', () => done(Array.from(input.files ?? [])), { once: true })\n  input.addEventListener('cancel', () => done([]), { once: true })\n  input.click()\n  return promise\n}\n"],"mappings":";;;;;AASA,eAAsB,WAAW,OAAgC,YAAoB,MAAsC;CACzH,MAAM,OAAO,IAAI,SAAS;CAC1B,KAAK,OAAO,QAAQ,IAAI;CACxB,OAAO,MAAM,MAAuB,sBAAsB,cAAc;EAAE,QAAQ;EAAQ;CAAK,CAAC;AAClG;;AAGA,MAAa,YAAY,QACvB,IAAI,YAAW,SAAQ,WAAW,IAAI,OAAO,IAAI,cAAA,WAAmC,IAAI;;AAG1F,MAAa,QAAQ,UAAU,OAA2G;CACxI,MAAM;CAEN,aAAa;EACX,OAAO;GACL,cAAc,QAAQ,uBAAO,IAAI,MAAM,qDAAqD,CAAC;GAC7F,mBAAmB,QAAQ,uBAAO,IAAI,MAAM,0DAA0D,CAAC;EACzG;CACF;CAEA,aAAa;EACX,OAAO;GAAE,QAAQ,KAAK,QAAQ;GAAQ,aAAa,KAAK,QAAQ;EAAY;CAC9E;AACF,CAAC;;AASD,SAAgB,aAAa,MAAY,KAAiC;CACxE,MAAM,OAAO,YAAY,KAAK,IAAI;CAClC,IAAI,CAAC,MAAM,OAAO;CAClB,IAAI,SAAS,SAAS,OAAO;EAAE,MAAM;EAAS,OAAO;GAAE,KAAK;GAAK,KAAK,KAAK;EAAK;CAAE;CAClF,OAAO;EAAE,MAAM;EAAM,OAAO;GAAE,KAAK;GAAK,OAAO,KAAK;GAAM,UAAU,UAAU,KAAK,IAAI;EAAE;CAAE;AAC7F;;AAGA,SAAgB,YAAY,MAAY,KAA0B;CAChE,OAAO;EACL,MAAM;EACN,OAAO;GAAE,KAAK;GAAK,OAAO,KAAK;GAAM,UAAU,UAAU,KAAK,IAAI,KAAK;GAA4B,MAAM,KAAK;EAAK;CACrH;AACF;;AAGA,SAAgB,YAAY,OAAuB;CACjD,MAAM,QAAQ;EAAC;EAAK;EAAM;EAAM;CAAI;CACpC,IAAI,QAAQ,KAAK,IAAI,GAAG,KAAK;CAC7B,IAAI,OAAO;CACX,OAAO,SAAS,QAAQ,OAAO,MAAM,SAAS,GAAG;EAC/C,SAAS;EACT;CACF;CACA,OAAO,SAAS,IAAI,GAAG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,GAAG,MAAM;AAClE;;AAGA,MAAa,sBAAsB;AAEnC,SAAgB,kBAAkB,QAAsB;CACtD,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,QAAQ,qBAAqB,IAAI,CAAC,CAAC,QAAQ,gBAAgB,KAAK,CAAC;AACxG;;AAGA,SAAgB,UAAU,QAAgB,WAAW,MAAuB;CAC1E,MAAM,EAAE,SAAS,YAAY,QAAQ,cAAsB;CAC3D,MAAM,QAAQ,SAAS,cAAc,OAAO;CAC5C,MAAM,OAAO;CACb,MAAM,SAAS;CACf,MAAM,WAAW;CACjB,MAAM,SAAS;CAEf,SAAS,KAAK,OAAO,KAAK;CAC1B,MAAM,QAAQ,UAAkB;EAC9B,MAAM,OAAO;EACb,QAAQ,KAAK;CACf;CACA,MAAM,iBAAiB,gBAAgB,KAAK,MAAM,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;CAC1F,MAAM,iBAAiB,gBAAgB,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;CAC/D,MAAM,MAAM;CACZ,OAAO;AACT"}
+{"version":3,"file":"upload.js","names":[],"sources":["../../../src/features/media/upload.ts"],"sourcesContent":["import { type Editor, Extension, type JSONContent } from '@tiptap/core'\nimport type { FeatureContext } from '../../core'\nimport { SCRATCH_DOCUMENT_ID } from './assets'\nimport { mediaKindOf, mediaMime } from './schema'\n\n/** Stores a file and resolves with the URL it is addressed by. */\ntype UploadFile = (file: File) => Promise<{ url: string, sha256?: string }>\n\n/** `importFiles` of the media feature: imports `files` at `pos` (default: the selection), toasting failures; resolves whether every file was imported. */\nexport type ImportFilesFn = (editor: Editor, files: File[] | FileList, pos?: number) => Promise<boolean>\n\n/** The upload of a surface: the backend's asset store for its `documentId` (default: the shared `scratch` owner; size limits per kind, see schema.ts). */\nexport const uploadOf = (ctx: FeatureContext): UploadFile =>\n  file => ctx.backend.assets\n    ? ctx.backend.assets.upload(ctx.documentId ?? SCRATCH_DOCUMENT_ID, file)\n    : Promise.reject(new Error(`@ecsplico/editor: backend \"${ctx.backend.name}\" has no assets capability`))\n\n/** Makes the upload and the file import reachable as `editor.storage.media` (drop/paste, toolbar, slash menu, recorder). */\nexport const Media = Extension.create<{ upload: UploadFile, importFiles: ImportFilesFn }, { upload: UploadFile, importFiles: ImportFilesFn }>({\n  name: 'media',\n\n  addOptions() {\n    return {\n      upload: () => Promise.reject(new Error('@ecsplico/editor: Media.configure({ upload }) fehlt')),\n      importFiles: () => Promise.reject(new Error('@ecsplico/editor: Media.configure({ importFiles }) fehlt')),\n    }\n  },\n\n  addStorage() {\n    return { upload: this.options.upload, importFiles: this.options.importFiles }\n  },\n})\n\ndeclare module '@tiptap/core' {\n  interface Storage {\n    media: { upload: UploadFile, importFiles: ImportFilesFn }\n  }\n}\n\n/** The node that embeds uploaded `file` from `url`, remembering the upload's `hash` (SHA-256 hex; none when the backend did not report one); null for files uploads do not accept. */\nexport function mediaNodeFor(file: File, url: string, hash?: string): JSONContent | null {\n  const kind = mediaKindOf(file.type)\n  if (!kind) return null\n  if (kind === 'image') return { type: 'image', attrs: { src: url, alt: file.name, hash: hash ?? null } }\n  return { type: kind, attrs: { src: url, title: file.name, mimeType: mediaMime(file.type), hash: hash ?? null } }\n}\n\n/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …); `hash` as in `mediaNodeFor`. */\nexport function fileNodeFor(file: File, url: string, hash?: string): JSONContent {\n  return {\n    type: 'file',\n    attrs: { src: url, title: file.name, mimeType: mediaMime(file.type) || 'application/octet-stream', size: file.size, hash: hash ?? null },\n  }\n}\n\n/** Human-readable byte count: 1024-based, one decimal (`1536` → `1.5 KB`), units B/KB/MB/GB. */\nexport function formatBytes(bytes: number): string {\n  const units = ['B', 'KB', 'MB', 'GB']\n  let value = Math.max(0, bytes)\n  let unit = 0\n  while (value >= 1024 && unit < units.length - 1) {\n    value /= 1024\n    unit++\n  }\n  return unit === 0 ? `${value} B` : `${value.toFixed(1)} ${units[unit]}`\n}\n\n/** Transaction meta the recorder modal (AudioRecorderModal) listens for: open it, inserting at the current caret. */\nexport const AUDIO_RECORDER_OPEN = 'audioRecorderOpen'\n\nexport function openAudioRecorder(editor: Editor): void {\n  editor.view.dispatch(editor.state.tr.setMeta(AUDIO_RECORDER_OPEN, true).setMeta('addToHistory', false))\n}\n\n/** Opens the browser's file picker; resolves the chosen files, `[]` when the picker is cancelled. */\nexport function pickFiles(accept: string, multiple = true): Promise<File[]> {\n  const { promise, resolve } = Promise.withResolvers<File[]>()\n  const input = document.createElement('input')\n  input.type = 'file'\n  input.accept = accept\n  input.multiple = multiple\n  input.hidden = true\n  // Attached while open: some Safari versions fire no `change` for detached inputs.\n  document.body.append(input)\n  const done = (files: File[]) => {\n    input.remove()\n    resolve(files)\n  }\n  input.addEventListener('change', () => done(Array.from(input.files ?? [])), { once: true })\n  input.addEventListener('cancel', () => done([]), { once: true })\n  input.click()\n  return promise\n}\n"],"mappings":";;;;;AAYA,MAAa,YAAY,SACvB,SAAQ,IAAI,QAAQ,SAChB,IAAI,QAAQ,OAAO,OAAO,IAAI,cAAA,WAAmC,IAAI,IACrE,QAAQ,uBAAO,IAAI,MAAM,8BAA8B,IAAI,QAAQ,KAAK,2BAA2B,CAAC;;AAG1G,MAAa,QAAQ,UAAU,OAA+G;CAC5I,MAAM;CAEN,aAAa;EACX,OAAO;GACL,cAAc,QAAQ,uBAAO,IAAI,MAAM,qDAAqD,CAAC;GAC7F,mBAAmB,QAAQ,uBAAO,IAAI,MAAM,0DAA0D,CAAC;EACzG;CACF;CAEA,aAAa;EACX,OAAO;GAAE,QAAQ,KAAK,QAAQ;GAAQ,aAAa,KAAK,QAAQ;EAAY;CAC9E;AACF,CAAC;;AASD,SAAgB,aAAa,MAAY,KAAa,MAAmC;CACvF,MAAM,OAAO,YAAY,KAAK,IAAI;CAClC,IAAI,CAAC,MAAM,OAAO;CAClB,IAAI,SAAS,SAAS,OAAO;EAAE,MAAM;EAAS,OAAO;GAAE,KAAK;GAAK,KAAK,KAAK;GAAM,MAAM,QAAQ;EAAK;CAAE;CACtG,OAAO;EAAE,MAAM;EAAM,OAAO;GAAE,KAAK;GAAK,OAAO,KAAK;GAAM,UAAU,UAAU,KAAK,IAAI;GAAG,MAAM,QAAQ;EAAK;CAAE;AACjH;;AAGA,SAAgB,YAAY,MAAY,KAAa,MAA4B;CAC/E,OAAO;EACL,MAAM;EACN,OAAO;GAAE,KAAK;GAAK,OAAO,KAAK;GAAM,UAAU,UAAU,KAAK,IAAI,KAAK;GAA4B,MAAM,KAAK;GAAM,MAAM,QAAQ;EAAK;CACzI;AACF;;AAGA,SAAgB,YAAY,OAAuB;CACjD,MAAM,QAAQ;EAAC;EAAK;EAAM;EAAM;CAAI;CACpC,IAAI,QAAQ,KAAK,IAAI,GAAG,KAAK;CAC7B,IAAI,OAAO;CACX,OAAO,SAAS,QAAQ,OAAO,MAAM,SAAS,GAAG;EAC/C,SAAS;EACT;CACF;CACA,OAAO,SAAS,IAAI,GAAG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,GAAG,MAAM;AAClE;;AAGA,MAAa,sBAAsB;AAEnC,SAAgB,kBAAkB,QAAsB;CACtD,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,QAAQ,qBAAqB,IAAI,CAAC,CAAC,QAAQ,gBAAgB,KAAK,CAAC;AACxG;;AAGA,SAAgB,UAAU,QAAgB,WAAW,MAAuB;CAC1E,MAAM,EAAE,SAAS,YAAY,QAAQ,cAAsB;CAC3D,MAAM,QAAQ,SAAS,cAAc,OAAO;CAC5C,MAAM,OAAO;CACb,MAAM,SAAS;CACf,MAAM,WAAW;CACjB,MAAM,SAAS;CAEf,SAAS,KAAK,OAAO,KAAK;CAC1B,MAAM,QAAQ,UAAkB;EAC9B,MAAM,OAAO;EACb,QAAQ,KAAK;CACf;CACA,MAAM,iBAAiB,gBAAgB,KAAK,MAAM,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;CAC1F,MAAM,iBAAiB,gBAAgB,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC;CAC/D,MAAM,MAAM;CACZ,OAAO;AACT"}

package/dist/features/mentions/index.d.ts

@@ -1,9 +1,10 @@
 import { EditorFeature } from "../../core/feature.js";
-import "../../core/index.js";
-import { MentionAttrs, MentionNode, MentionUser } from "./mention.js";
+import { MentionUser } from "../../core/backend-types.js";
+import { MentionAttrs, MentionNode } from "./mention.js";
 import { MentionTarget, mentionUsersIn, mentionsFromText } from "./mention-text.js";
 import { TAG_NODE, TagAttrs, TagNode, TagOptions, TagSuggestionItem, TagSuggestionPluginKey, collectTagNames, normalizeTagName, tagsFromText } from "./tag.js";
 import "./schema.js";
+import "../../core/index.js";
 import { mentionSuggestion } from "./mention-suggestion.js";
 import { mentionsMetadata } from "./metadata-defaults.js";
 import { normalizeMentions } from "./normalize.js";
@@ -11,7 +12,7 @@ import { tagSuggestion } from "./tag-suggestion.js";
 //#region src/features/mentions/index.d.ts
 /**
  * `@user` mention chips and `#tag` chips with their suggestion popups. Without a host list, `mentions` and `hashtags`
- * come from `/api/editor/users` and `/api/editor/tags` through the context's HTTP client, and only once a popup is used.
+ * come from the context's backend (`users` and `tags`; the HTTP backend asks `/api/editor/users` and `/api/editor/tags`), and only once a popup is used.
  * Contributes the `normalize` stage: `@name` / `#tag` text of imported or AI-written Markdown becomes chips when it
  * matches a known user or an existing tag. Contributes no components (`EditorFeature<never>`), so it fits a preset of
  * any framework layer.

package/dist/features/mentions/index.js

@@ -2,6 +2,7 @@ import { metadataOf } from "../../core/metadata.js";
 import { MentionNode } from "./mention.js";
 import { TAG_NODE, TagNode, TagSuggestionPluginKey, collectTagNames, normalizeTagName, tagsFromText } from "./tag.js";
 import { mentionUsersIn, mentionsFromText } from "./mention-text.js";
+import { mentionsSchemaExtensions } from "./schema.js";
 import { mentionSuggestion } from "./mention-suggestion.js";
 import { mentionsMetadata } from "./metadata-defaults.js";
 import { normalizeMentions } from "./normalize.js";
@@ -9,7 +10,7 @@ import { tagSuggestion } from "./tag-suggestion.js";
 //#region src/features/mentions/index.ts
 /**
 * `@user` mention chips and `#tag` chips with their suggestion popups. Without a host list, `mentions` and `hashtags`
-* come from `/api/editor/users` and `/api/editor/tags` through the context's HTTP client, and only once a popup is used.
+* come from the context's backend (`users` and `tags`; the HTTP backend asks `/api/editor/users` and `/api/editor/tags`), and only once a popup is used.
 * Contributes the `normalize` stage: `@name` / `#tag` text of imported or AI-written Markdown becomes chips when it
 * matches a known user or an existing tag. Contributes no components (`EditorFeature<never>`), so it fits a preset of
 * any framework layer.
@@ -17,6 +18,8 @@ import { tagSuggestion } from "./tag-suggestion.js";
 function mentionsFeature() {
 	return {
 		id: "mentions",
+		dimension: "content",
+		schemaExtensions: mentionsSchemaExtensions,
 		extensions: (ctx) => [MentionNode.configure({ suggestion: mentionSuggestion(ctx.t) }), TagNode.configure({
 			suggestion: tagSuggestion(ctx.t),
 			onCreate: (editor, name) => metadataOf(editor).create("hashtags", {

package/dist/features/mentions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/features/mentions/index.ts"],"sourcesContent":["import type { EditorFeature } from '../../core'\nimport { metadataOf } from '../../core'\nimport { mentionSuggestion } from './mention-suggestion'\nimport { mentionsMetadata } from './metadata-defaults'\nimport { MentionNode } from './mention'\nimport { normalizeMentions } from './normalize'\nimport { tagSuggestion } from './tag-suggestion'\nimport { TagNode } from './tag'\n\nexport { mentionSuggestion } from './mention-suggestion'\nexport { mentionsMetadata } from './metadata-defaults'\nexport { normalizeMentions } from './normalize'\nexport { tagSuggestion } from './tag-suggestion'\nexport {\n  collectTagNames,\n  type MentionAttrs,\n  MentionNode,\n  type MentionTarget,\n  mentionsFromText,\n  mentionUsersIn,\n  type MentionUser,\n  normalizeTagName,\n  TAG_NODE,\n  TagNode,\n  type TagAttrs,\n  type TagOptions,\n  type TagSuggestionItem,\n  tagsFromText,\n  TagSuggestionPluginKey,\n} from './schema'\n\n/**\n * `@user` mention chips and `#tag` chips with their suggestion popups. Without a host list, `mentions` and `hashtags`\n * come from `/api/editor/users` and `/api/editor/tags` through the context's HTTP client, and only once a popup is used.\n * Contributes the `normalize` stage: `@name` / `#tag` text of imported or AI-written Markdown becomes chips when it\n * matches a known user or an existing tag. Contributes no components (`EditorFeature<never>`), so it fits a preset of\n * any framework layer.\n */\nexport function mentionsFeature(): EditorFeature<never> {\n  return {\n    id: 'mentions',\n    extensions: ctx => [\n      MentionNode.configure({ suggestion: mentionSuggestion(ctx.t) }),\n      TagNode.configure({\n        suggestion: tagSuggestion(ctx.t),\n        onCreate: (editor, name) => metadataOf(editor).create('hashtags', { id: name, label: name }),\n      }),\n    ],\n    metadataDefaults: ctx => mentionsMetadata(ctx),\n    blocks: { normalize: normalizeMentions },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsCA,SAAgB,kBAAwC;CACtD,OAAO;EACL,IAAI;EACJ,aAAY,QAAO,CACjB,YAAY,UAAU,EAAE,YAAY,kBAAkB,IAAI,CAAC,EAAE,CAAC,GAC9D,QAAQ,UAAU;GAChB,YAAY,cAAc,IAAI,CAAC;GAC/B,WAAW,QAAQ,SAAS,WAAW,MAAM,CAAC,CAAC,OAAO,YAAY;IAAE,IAAI;IAAM,OAAO;GAAK,CAAC;EAC7F,CAAC,CACH;EACA,mBAAkB,QAAO,iBAAiB,GAAG;EAC7C,QAAQ,EAAE,WAAW,kBAAkB;CACzC;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/features/mentions/index.ts"],"sourcesContent":["import type { EditorFeature } from '../../core'\nimport { metadataOf } from '../../core'\nimport { mentionSuggestion } from './mention-suggestion'\nimport { mentionsMetadata } from './metadata-defaults'\nimport { MentionNode } from './mention'\nimport { mentionsSchemaExtensions } from './schema'\nimport { normalizeMentions } from './normalize'\nimport { tagSuggestion } from './tag-suggestion'\nimport { TagNode } from './tag'\n\nexport { mentionSuggestion } from './mention-suggestion'\nexport { mentionsMetadata } from './metadata-defaults'\nexport { normalizeMentions } from './normalize'\nexport { tagSuggestion } from './tag-suggestion'\nexport {\n  collectTagNames,\n  type MentionAttrs,\n  MentionNode,\n  type MentionTarget,\n  mentionsFromText,\n  mentionUsersIn,\n  type MentionUser,\n  normalizeTagName,\n  TAG_NODE,\n  TagNode,\n  type TagAttrs,\n  type TagOptions,\n  type TagSuggestionItem,\n  tagsFromText,\n  TagSuggestionPluginKey,\n} from './schema'\n\n/**\n * `@user` mention chips and `#tag` chips with their suggestion popups. Without a host list, `mentions` and `hashtags`\n * come from the context's backend (`users` and `tags`; the HTTP backend asks `/api/editor/users` and `/api/editor/tags`), and only once a popup is used.\n * Contributes the `normalize` stage: `@name` / `#tag` text of imported or AI-written Markdown becomes chips when it\n * matches a known user or an existing tag. Contributes no components (`EditorFeature<never>`), so it fits a preset of\n * any framework layer.\n */\nexport function mentionsFeature(): EditorFeature<never> {\n  return {\n    id: 'mentions',\n    dimension: 'content',\n    schemaExtensions: mentionsSchemaExtensions,\n    extensions: ctx => [\n      MentionNode.configure({ suggestion: mentionSuggestion(ctx.t) }),\n      TagNode.configure({\n        suggestion: tagSuggestion(ctx.t),\n        onCreate: (editor, name) => metadataOf(editor).create('hashtags', { id: name, label: name }),\n      }),\n    ],\n    metadataDefaults: ctx => mentionsMetadata(ctx),\n    blocks: { normalize: normalizeMentions },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAuCA,SAAgB,kBAAwC;CACtD,OAAO;EACL,IAAI;EACJ,WAAW;EACX,kBAAkB;EAClB,aAAY,QAAO,CACjB,YAAY,UAAU,EAAE,YAAY,kBAAkB,IAAI,CAAC,EAAE,CAAC,GAC9D,QAAQ,UAAU;GAChB,YAAY,cAAc,IAAI,CAAC;GAC/B,WAAW,QAAQ,SAAS,WAAW,MAAM,CAAC,CAAC,OAAO,YAAY;IAAE,IAAI;IAAM,OAAO;GAAK,CAAC;EAC7F,CAAC,CACH;EACA,mBAAkB,QAAO,iBAAiB,GAAG;EAC7C,QAAQ,EAAE,WAAW,kBAAkB;CACzC;AACF"}

package/dist/features/mentions/mention-text.d.ts

@@ -1,4 +1,4 @@
-import { MentionUser } from "./mention.js";
+import { MentionUser } from "../../core/backend-types.js";
 import { JSONContent } from "@tiptap/core";
 //#region src/features/mentions/mention-text.d.ts
 /** A user `@username` may resolve to: a registered user, or the attrs of an existing chip (colour possibly unset). */

package/dist/features/mentions/mention-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention-text.js","names":[],"sources":["../../../src/features/mentions/mention-text.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { MentionUser } from './mention'\n\n/** A user `@username` may resolve to: a registered user, or the attrs of an existing chip (colour possibly unset). */\nexport type MentionTarget = Pick<MentionUser, 'id' | 'username'> & { color: string | null }\n\n/**\n * Turns `@username` tokens in text nodes into `mention` nodes (attrs id, label = username, color) — for\n * AI-generated Markdown, whose parser only knows the `[@ …]` shortcode. Matches known users only,\n * case-insensitively; unknown `@foo`, e-mail addresses and text in code blocks, inline code or links stay plain.\n * Returns the input unchanged when nothing matched.\n */\nexport function mentionsFromText(json: JSONContent, users: readonly MentionTarget[]): JSONContent {\n  const byName = new Map(users.filter(u => u.username).map(u => [u.username.toLowerCase(), u]))\n  if (!byName.size) return json\n  const names = [...byName.keys()].sort((a, b) => b.length - a.length).map(n => n.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'))\n  // Not preceded by a word char, `@` or `.` (e-mail), not followed by a word char or `-`; a trailing `.` ends the sentence.\n  const token = new RegExp(`(?<![\\\\p{L}\\\\p{N}_@.])@(${names.join('|')})(?![\\\\p{L}\\\\p{N}_-]|\\\\.[\\\\p{L}\\\\p{N}_])`, 'giu')\n\n  const splitText = (node: JSONContent): JSONContent[] => {\n    const text = node.text ?? ''\n    // Text in inline code or a link stays literal.\n    if (!text.includes('@') || node.marks?.some(m => m.type === 'code' || m.type === 'link')) return [node]\n    const out: JSONContent[] = []\n    let last = 0\n    for (const match of text.matchAll(token)) {\n      const at = match.index ?? 0\n      const user = byName.get(match[1]!.toLowerCase())!\n      if (at > last) out.push({ ...node, text: text.slice(last, at) })\n      out.push({\n        type: 'mention',\n        attrs: { id: user.id, label: user.username, color: user.color },\n        ...(node.marks?.length ? { marks: node.marks } : {}),\n      })\n      last = at + match[0].length\n    }\n    if (!out.length) return [node]\n    if (last < text.length) out.push({ ...node, text: text.slice(last) })\n    return out\n  }\n\n  const walk = (node: JSONContent): JSONContent => {\n    if (!node.content || node.type === 'codeBlock') return node\n    let changed = false\n    const content = node.content.flatMap((child) => {\n      const next = child.type === 'text' ? splitText(child) : [walk(child)]\n      if (next.length !== 1 || next[0] !== child) changed = true\n      return next\n    })\n    return changed ? { ...node, content } : node\n  }\n  return walk(json)\n}\n\n/** Users of the mention chips inside a JSON tree, e.g. the range an AI result replaces (so echoed `@name`s stay chips). */\nexport function mentionUsersIn(json: JSONContent | JSONContent[]): MentionTarget[] {\n  const found = new Map<string, MentionTarget>()\n  const visit = (node: JSONContent) => {\n    if (node.type === 'mention' && node.attrs?.id && node.attrs.label) {\n      found.set(String(node.attrs.id), { id: String(node.attrs.id), username: String(node.attrs.label), color: node.attrs.color ?? null })\n    }\n    node.content?.forEach(visit)\n  }\n  ;(Array.isArray(json) ? json : [json]).forEach(visit)\n  return [...found.values()]\n}\n"],"mappings":";;;;;;;AAYA,SAAgB,iBAAiB,MAAmB,OAA8C;CAChG,MAAM,SAAS,IAAI,IAAI,MAAM,QAAO,MAAK,EAAE,QAAQ,CAAC,CAAC,KAAI,MAAK,CAAC,EAAE,SAAS,YAAY,GAAG,CAAC,CAAC,CAAC;CAC5F,IAAI,CAAC,OAAO,MAAM,OAAO;CACzB,MAAM,QAAQ,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,KAAI,MAAK,EAAE,QAAQ,uBAAuB,MAAM,CAAC;CAEtH,MAAM,QAAQ,IAAI,OAAO,2BAA2B,MAAM,KAAK,GAAG,EAAE,2CAA2C,KAAK;CAEpH,MAAM,aAAa,SAAqC;EACtD,MAAM,OAAO,KAAK,QAAQ;EAE1B,IAAI,CAAC,KAAK,SAAS,GAAG,KAAK,KAAK,OAAO,MAAK,MAAK,EAAE,SAAS,UAAU,EAAE,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI;EACtG,MAAM,MAAqB,CAAC;EAC5B,IAAI,OAAO;EACX,KAAK,MAAM,SAAS,KAAK,SAAS,KAAK,GAAG;GACxC,MAAM,KAAK,MAAM,SAAS;GAC1B,MAAM,OAAO,OAAO,IAAI,MAAM,EAAE,CAAE,YAAY,CAAC;GAC/C,IAAI,KAAK,MAAM,IAAI,KAAK;IAAE,GAAG;IAAM,MAAM,KAAK,MAAM,MAAM,EAAE;GAAE,CAAC;GAC/D,IAAI,KAAK;IACP,MAAM;IACN,OAAO;KAAE,IAAI,KAAK;KAAI,OAAO,KAAK;KAAU,OAAO,KAAK;IAAM;IAC9D,GAAI,KAAK,OAAO,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GACpD,CAAC;GACD,OAAO,KAAK,MAAM,EAAE,CAAC;EACvB;EACA,IAAI,CAAC,IAAI,QAAQ,OAAO,CAAC,IAAI;EAC7B,IAAI,OAAO,KAAK,QAAQ,IAAI,KAAK;GAAE,GAAG;GAAM,MAAM,KAAK,MAAM,IAAI;EAAE,CAAC;EACpE,OAAO;CACT;CAEA,MAAM,QAAQ,SAAmC;EAC/C,IAAI,CAAC,KAAK,WAAW,KAAK,SAAS,aAAa,OAAO;EACvD,IAAI,UAAU;EACd,MAAM,UAAU,KAAK,QAAQ,SAAS,UAAU;GAC9C,MAAM,OAAO,MAAM,SAAS,SAAS,UAAU,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC;GACpE,IAAI,KAAK,WAAW,KAAK,KAAK,OAAO,OAAO,UAAU;GACtD,OAAO;EACT,CAAC;EACD,OAAO,UAAU;GAAE,GAAG;GAAM;EAAQ,IAAI;CAC1C;CACA,OAAO,KAAK,IAAI;AAClB;;AAGA,SAAgB,eAAe,MAAoD;CACjF,MAAM,wBAAQ,IAAI,IAA2B;CAC7C,MAAM,SAAS,SAAsB;EACnC,IAAI,KAAK,SAAS,aAAa,KAAK,OAAO,MAAM,KAAK,MAAM,OAC1D,MAAM,IAAI,OAAO,KAAK,MAAM,EAAE,GAAG;GAAE,IAAI,OAAO,KAAK,MAAM,EAAE;GAAG,UAAU,OAAO,KAAK,MAAM,KAAK;GAAG,OAAO,KAAK,MAAM,SAAS;EAAK,CAAC;EAErI,KAAK,SAAS,QAAQ,KAAK;CAC7B;CACC,CAAC,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI,EAAA,CAAG,QAAQ,KAAK;CACpD,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC;AAC3B"}
+{"version":3,"file":"mention-text.js","names":[],"sources":["../../../src/features/mentions/mention-text.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { MentionUser } from '../../core/backend-types'\n\n/** A user `@username` may resolve to: a registered user, or the attrs of an existing chip (colour possibly unset). */\nexport type MentionTarget = Pick<MentionUser, 'id' | 'username'> & { color: string | null }\n\n/**\n * Turns `@username` tokens in text nodes into `mention` nodes (attrs id, label = username, color) — for\n * AI-generated Markdown, whose parser only knows the `[@ …]` shortcode. Matches known users only,\n * case-insensitively; unknown `@foo`, e-mail addresses and text in code blocks, inline code or links stay plain.\n * Returns the input unchanged when nothing matched.\n */\nexport function mentionsFromText(json: JSONContent, users: readonly MentionTarget[]): JSONContent {\n  const byName = new Map(users.filter(u => u.username).map(u => [u.username.toLowerCase(), u]))\n  if (!byName.size) return json\n  const names = [...byName.keys()].sort((a, b) => b.length - a.length).map(n => n.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'))\n  // Not preceded by a word char, `@` or `.` (e-mail), not followed by a word char or `-`; a trailing `.` ends the sentence.\n  const token = new RegExp(`(?<![\\\\p{L}\\\\p{N}_@.])@(${names.join('|')})(?![\\\\p{L}\\\\p{N}_-]|\\\\.[\\\\p{L}\\\\p{N}_])`, 'giu')\n\n  const splitText = (node: JSONContent): JSONContent[] => {\n    const text = node.text ?? ''\n    // Text in inline code or a link stays literal.\n    if (!text.includes('@') || node.marks?.some(m => m.type === 'code' || m.type === 'link')) return [node]\n    const out: JSONContent[] = []\n    let last = 0\n    for (const match of text.matchAll(token)) {\n      const at = match.index ?? 0\n      const user = byName.get(match[1]!.toLowerCase())!\n      if (at > last) out.push({ ...node, text: text.slice(last, at) })\n      out.push({\n        type: 'mention',\n        attrs: { id: user.id, label: user.username, color: user.color },\n        ...(node.marks?.length ? { marks: node.marks } : {}),\n      })\n      last = at + match[0].length\n    }\n    if (!out.length) return [node]\n    if (last < text.length) out.push({ ...node, text: text.slice(last) })\n    return out\n  }\n\n  const walk = (node: JSONContent): JSONContent => {\n    if (!node.content || node.type === 'codeBlock') return node\n    let changed = false\n    const content = node.content.flatMap((child) => {\n      const next = child.type === 'text' ? splitText(child) : [walk(child)]\n      if (next.length !== 1 || next[0] !== child) changed = true\n      return next\n    })\n    return changed ? { ...node, content } : node\n  }\n  return walk(json)\n}\n\n/** Users of the mention chips inside a JSON tree, e.g. the range an AI result replaces (so echoed `@name`s stay chips). */\nexport function mentionUsersIn(json: JSONContent | JSONContent[]): MentionTarget[] {\n  const found = new Map<string, MentionTarget>()\n  const visit = (node: JSONContent) => {\n    if (node.type === 'mention' && node.attrs?.id && node.attrs.label) {\n      found.set(String(node.attrs.id), { id: String(node.attrs.id), username: String(node.attrs.label), color: node.attrs.color ?? null })\n    }\n    node.content?.forEach(visit)\n  }\n  ;(Array.isArray(json) ? json : [json]).forEach(visit)\n  return [...found.values()]\n}\n"],"mappings":";;;;;;;AAYA,SAAgB,iBAAiB,MAAmB,OAA8C;CAChG,MAAM,SAAS,IAAI,IAAI,MAAM,QAAO,MAAK,EAAE,QAAQ,CAAC,CAAC,KAAI,MAAK,CAAC,EAAE,SAAS,YAAY,GAAG,CAAC,CAAC,CAAC;CAC5F,IAAI,CAAC,OAAO,MAAM,OAAO;CACzB,MAAM,QAAQ,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,KAAI,MAAK,EAAE,QAAQ,uBAAuB,MAAM,CAAC;CAEtH,MAAM,QAAQ,IAAI,OAAO,2BAA2B,MAAM,KAAK,GAAG,EAAE,2CAA2C,KAAK;CAEpH,MAAM,aAAa,SAAqC;EACtD,MAAM,OAAO,KAAK,QAAQ;EAE1B,IAAI,CAAC,KAAK,SAAS,GAAG,KAAK,KAAK,OAAO,MAAK,MAAK,EAAE,SAAS,UAAU,EAAE,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI;EACtG,MAAM,MAAqB,CAAC;EAC5B,IAAI,OAAO;EACX,KAAK,MAAM,SAAS,KAAK,SAAS,KAAK,GAAG;GACxC,MAAM,KAAK,MAAM,SAAS;GAC1B,MAAM,OAAO,OAAO,IAAI,MAAM,EAAE,CAAE,YAAY,CAAC;GAC/C,IAAI,KAAK,MAAM,IAAI,KAAK;IAAE,GAAG;IAAM,MAAM,KAAK,MAAM,MAAM,EAAE;GAAE,CAAC;GAC/D,IAAI,KAAK;IACP,MAAM;IACN,OAAO;KAAE,IAAI,KAAK;KAAI,OAAO,KAAK;KAAU,OAAO,KAAK;IAAM;IAC9D,GAAI,KAAK,OAAO,SAAS,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GACpD,CAAC;GACD,OAAO,KAAK,MAAM,EAAE,CAAC;EACvB;EACA,IAAI,CAAC,IAAI,QAAQ,OAAO,CAAC,IAAI;EAC7B,IAAI,OAAO,KAAK,QAAQ,IAAI,KAAK;GAAE,GAAG;GAAM,MAAM,KAAK,MAAM,IAAI;EAAE,CAAC;EACpE,OAAO;CACT;CAEA,MAAM,QAAQ,SAAmC;EAC/C,IAAI,CAAC,KAAK,WAAW,KAAK,SAAS,aAAa,OAAO;EACvD,IAAI,UAAU;EACd,MAAM,UAAU,KAAK,QAAQ,SAAS,UAAU;GAC9C,MAAM,OAAO,MAAM,SAAS,SAAS,UAAU,KAAK,IAAI,CAAC,KAAK,KAAK,CAAC;GACpE,IAAI,KAAK,WAAW,KAAK,KAAK,OAAO,OAAO,UAAU;GACtD,OAAO;EACT,CAAC;EACD,OAAO,UAAU;GAAE,GAAG;GAAM;EAAQ,IAAI;CAC1C;CACA,OAAO,KAAK,IAAI;AAClB;;AAGA,SAAgB,eAAe,MAAoD;CACjF,MAAM,wBAAQ,IAAI,IAA2B;CAC7C,MAAM,SAAS,SAAsB;EACnC,IAAI,KAAK,SAAS,aAAa,KAAK,OAAO,MAAM,KAAK,MAAM,OAC1D,MAAM,IAAI,OAAO,KAAK,MAAM,EAAE,GAAG;GAAE,IAAI,OAAO,KAAK,MAAM,EAAE;GAAG,UAAU,OAAO,KAAK,MAAM,KAAK;GAAG,OAAO,KAAK,MAAM,SAAS;EAAK,CAAC;EAErI,KAAK,SAAS,QAAQ,KAAK;CAC7B;CACC,CAAC,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI,EAAA,CAAG,QAAQ,KAAK;CACpD,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC;AAC3B"}

package/dist/features/mentions/mention.d.ts

@@ -1,10 +1,4 @@
 //#region src/features/mentions/mention.d.ts
-/** A user as offered for `@` mentions (`GET /api/editor/users`); never carries credentials. */
-export interface MentionUser {
-  id: string;
-  username: string;
-  color: string;
-}
 /** Attributes of a mention chip: `label` is the username, `color` the user's colour, both copied in at insert time. */
 export type MentionAttrs = {
   id: string;

package/dist/features/mentions/mention.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention.js","names":[],"sources":["../../../src/features/mentions/mention.ts"],"sourcesContent":["import { Mention } from '@tiptap/extension-mention'\nimport { HEX_COLOR } from '../../core/schema/hex-color'\n\n/** A user as offered for `@` mentions (`GET /api/editor/users`); never carries credentials. */\nexport interface MentionUser {\n  id: string\n  username: string\n  color: string\n}\n\n/** Attributes of a mention chip: `label` is the username, `color` the user's colour, both copied in at insert time. */\nexport type MentionAttrs = {\n  id: string\n  label: string\n  color: string | null\n}\n\n/**\n * Schema part of the `@username` chip, shared by the client editor and the server (collab schema, Markdown).\n * The client adds the suggestion popup via `.configure({ suggestion })` in the mentions feature.\n */\nexport const MentionNode = Mention.extend({\n  addOptions() {\n    return { ...this.parent!(), HTMLAttributes: { class: 'mention' } }\n  },\n  addAttributes() {\n    return {\n      ...this.parent?.(),\n      color: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-color'),\n        renderHTML: attrs => HEX_COLOR.test(String(attrs.color ?? ''))\n          ? { 'data-color': attrs.color, 'style': `--mention-color: ${attrs.color}` }\n          : {},\n      },\n    }\n  },\n  // Markdown export (editor.getMarkdown(), AI context/selection) shows the chip as plain `@username`.\n  renderMarkdown: node => `@${node.attrs?.label ?? node.attrs?.id ?? ''}`,\n})\n"],"mappings":";;;;;;;AAqBA,MAAa,cAAc,QAAQ,OAAO;CACxC,aAAa;EACX,OAAO;GAAE,GAAG,KAAK,OAAQ;GAAG,gBAAgB,EAAE,OAAO,UAAU;EAAE;CACnE;CACA,gBAAgB;EACd,OAAO;GACL,GAAG,KAAK,SAAS;GACjB,OAAO;IACL,SAAS;IACT,YAAW,OAAM,GAAG,aAAa,YAAY;IAC7C,aAAY,UAAS,UAAU,KAAK,OAAO,MAAM,SAAS,EAAE,CAAC,IACzD;KAAE,cAAc,MAAM;KAAO,SAAS,oBAAoB,MAAM;IAAQ,IACxE,CAAC;GACP;EACF;CACF;CAEA,iBAAgB,SAAQ,IAAI,KAAK,OAAO,SAAS,KAAK,OAAO,MAAM;AACrE,CAAC"}
+{"version":3,"file":"mention.js","names":[],"sources":["../../../src/features/mentions/mention.ts"],"sourcesContent":["import { Mention } from '@tiptap/extension-mention'\nimport { HEX_COLOR } from '../../core/schema/hex-color'\n\n/** Attributes of a mention chip: `label` is the username, `color` the user's colour, both copied in at insert time. */\nexport type MentionAttrs = {\n  id: string\n  label: string\n  color: string | null\n}\n\n/**\n * Schema part of the `@username` chip, shared by the client editor and the server (collab schema, Markdown).\n * The client adds the suggestion popup via `.configure({ suggestion })` in the mentions feature.\n */\nexport const MentionNode = Mention.extend({\n  addOptions() {\n    return { ...this.parent!(), HTMLAttributes: { class: 'mention' } }\n  },\n  addAttributes() {\n    return {\n      ...this.parent?.(),\n      color: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-color'),\n        renderHTML: attrs => HEX_COLOR.test(String(attrs.color ?? ''))\n          ? { 'data-color': attrs.color, 'style': `--mention-color: ${attrs.color}` }\n          : {},\n      },\n    }\n  },\n  // Markdown export (editor.getMarkdown(), AI context/selection) shows the chip as plain `@username`.\n  renderMarkdown: node => `@${node.attrs?.label ?? node.attrs?.id ?? ''}`,\n})\n"],"mappings":";;;;;;;AAcA,MAAa,cAAc,QAAQ,OAAO;CACxC,aAAa;EACX,OAAO;GAAE,GAAG,KAAK,OAAQ;GAAG,gBAAgB,EAAE,OAAO,UAAU;EAAE;CACnE;CACA,gBAAgB;EACd,OAAO;GACL,GAAG,KAAK,SAAS;GACjB,OAAO;IACL,SAAS;IACT,YAAW,OAAM,GAAG,aAAa,YAAY;IAC7C,aAAY,UAAS,UAAU,KAAK,OAAO,MAAM,SAAS,EAAE,CAAC,IACzD;KAAE,cAAc,MAAM;KAAO,SAAS,oBAAoB,MAAM;IAAQ,IACxE,CAAC;GACP;EACF;CACF;CAEA,iBAAgB,SAAQ,IAAI,KAAK,OAAO,SAAS,KAAK,OAAO,MAAM;AACrE,CAAC"}

package/dist/features/mentions/metadata-defaults.d.ts

@@ -2,7 +2,7 @@ import { EditorMetadata } from "../../core/metadata-types.js";
 import { FeatureContext } from "../../core/feature.js";
 import "../../core/index.js";
 //#region src/features/mentions/metadata-defaults.d.ts
-/** Built-in `mentions` and `hashtags` lists when the host supplies none: users and tags from the editor API, through the context's HTTP client. */
-export declare function mentionsMetadata(ctx: Pick<FeatureContext, 'fetch'>): EditorMetadata;
+/** Built-in `mentions` and `hashtags` lists when the host supplies none: users and tags from the context's backend (`users`, `tags`); a backend without the capability offers none. */
+export declare function mentionsMetadata(ctx: Pick<FeatureContext, 'backend'>): EditorMetadata;
 //#endregion
 //# sourceMappingURL=metadata-defaults.d.ts.map

package/dist/features/mentions/metadata-defaults.js

@@ -1,23 +1,17 @@
 import { normalizeTagName } from "./tag.js";
 //#region src/features/mentions/metadata-defaults.ts
-/** Built-in `mentions` and `hashtags` lists when the host supplies none: users and tags from the editor API, through the context's HTTP client. */
+/** Built-in `mentions` and `hashtags` lists when the host supplies none: users and tags from the context's backend (`users`, `tags`); a backend without the capability offers none. */
 function mentionsMetadata(ctx) {
 	return {
 		mentions: async ({ query, signal }) => {
-			return (await ctx.fetch("/api/editor/users", {
-				query: { q: query },
-				signal
-			})).map(({ id, username, color }) => ({
+			return (await ctx.backend.users?.search(query, signal) ?? []).map(({ id, username, color }) => ({
 				id,
 				label: username,
 				color
 			}));
 		},
 		hashtags: async ({ query, signal }) => {
-			return (await ctx.fetch("/api/editor/tags", {
-				query: { q: normalizeTagName(query) },
-				signal
-			})).map((tag) => ({
+			return (await ctx.backend.tags?.search(normalizeTagName(query), signal) ?? []).map((tag) => ({
 				id: tag,
 				label: tag
 			}));

package/dist/features/mentions/metadata-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-defaults.js","names":[],"sources":["../../../src/features/mentions/metadata-defaults.ts"],"sourcesContent":["import type { EditorMetadata, FeatureContext } from '../../core'\nimport { normalizeTagName } from './tag'\n\n/** Built-in `mentions` and `hashtags` lists when the host supplies none: users and tags from the editor API, through the context's HTTP client. */\nexport function mentionsMetadata(ctx: Pick<FeatureContext, 'fetch'>): EditorMetadata {\n  return {\n    mentions: async ({ query, signal }) => {\n      const users = await ctx.fetch<{ id: string, username: string, color: string }[]>('/api/editor/users', { query: { q: query }, signal })\n      return users.map(({ id, username, color }) => ({ id, label: username, color }))\n    },\n    hashtags: async ({ query, signal }) => {\n      const tags = await ctx.fetch<string[]>('/api/editor/tags', { query: { q: normalizeTagName(query) }, signal })\n      return tags.map(tag => ({ id: tag, label: tag }))\n    },\n  }\n}\n"],"mappings":";;;AAIA,SAAgB,iBAAiB,KAAoD;CACnF,OAAO;EACL,UAAU,OAAO,EAAE,OAAO,aAAa;GAErC,QAAO,MADa,IAAI,MAAyD,qBAAqB;IAAE,OAAO,EAAE,GAAG,MAAM;IAAG;GAAO,CAAC,EAAA,CACxH,KAAK,EAAE,IAAI,UAAU,aAAa;IAAE;IAAI,OAAO;IAAU;GAAM,EAAE;EAChF;EACA,UAAU,OAAO,EAAE,OAAO,aAAa;GAErC,QAAO,MADY,IAAI,MAAgB,oBAAoB;IAAE,OAAO,EAAE,GAAG,iBAAiB,KAAK,EAAE;IAAG;GAAO,CAAC,EAAA,CAChG,KAAI,SAAQ;IAAE,IAAI;IAAK,OAAO;GAAI,EAAE;EAClD;CACF;AACF"}
+{"version":3,"file":"metadata-defaults.js","names":[],"sources":["../../../src/features/mentions/metadata-defaults.ts"],"sourcesContent":["import type { EditorMetadata, FeatureContext } from '../../core'\nimport { normalizeTagName } from './tag'\n\n/** Built-in `mentions` and `hashtags` lists when the host supplies none: users and tags from the context's backend (`users`, `tags`); a backend without the capability offers none. */\nexport function mentionsMetadata(ctx: Pick<FeatureContext, 'backend'>): EditorMetadata {\n  return {\n    mentions: async ({ query, signal }) => {\n      const users = await ctx.backend.users?.search(query, signal) ?? []\n      return users.map(({ id, username, color }) => ({ id, label: username, color }))\n    },\n    hashtags: async ({ query, signal }) => {\n      const tags = await ctx.backend.tags?.search(normalizeTagName(query), signal) ?? []\n      return tags.map(tag => ({ id: tag, label: tag }))\n    },\n  }\n}\n"],"mappings":";;;AAIA,SAAgB,iBAAiB,KAAsD;CACrF,OAAO;EACL,UAAU,OAAO,EAAE,OAAO,aAAa;GAErC,QADc,MAAM,IAAI,QAAQ,OAAO,OAAO,OAAO,MAAM,KAAK,CAAC,EAAA,CACpD,KAAK,EAAE,IAAI,UAAU,aAAa;IAAE;IAAI,OAAO;IAAU;GAAM,EAAE;EAChF;EACA,UAAU,OAAO,EAAE,OAAO,aAAa;GAErC,QADa,MAAM,IAAI,QAAQ,MAAM,OAAO,iBAAiB,KAAK,GAAG,MAAM,KAAK,CAAC,EAAA,CACrE,KAAI,SAAQ;IAAE,IAAI;IAAK,OAAO;GAAI,EAAE;EAClD;CACF;AACF"}

package/dist/features/mentions/schema.d.ts

@@ -1,4 +1,5 @@
-import { MentionAttrs, MentionNode, MentionUser } from "./mention.js";
+import { MentionUser } from "../../core/backend-types.js";
+import { MentionAttrs, MentionNode } from "./mention.js";
 import { MentionTarget, mentionUsersIn, mentionsFromText } from "./mention-text.js";
 import { TAG_NODE, TagAttrs, TagNode, TagOptions, TagSuggestionItem, TagSuggestionPluginKey, collectTagNames, normalizeTagName, tagsFromText } from "./tag.js";
 import { AnyExtension } from "@tiptap/core";

package/dist/features/mentions/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/mentions/schema.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport { MentionNode } from './mention'\nimport { TagNode } from './tag'\n\n// Vue-free and server-importable (`@ecsplico/editor/mentions/schema`): the mention and tag nodes, their Markdown\n// forms and the text helpers that turn `@name` / `#tag` back into chips. The suggestion popups live in the feature.\n\nexport { type MentionAttrs, MentionNode, type MentionUser } from './mention'\nexport { type MentionTarget, mentionsFromText, mentionUsersIn } from './mention-text'\nexport { collectTagNames, normalizeTagName, TAG_NODE, TagNode, type TagAttrs, type TagOptions, type TagSuggestionItem, tagsFromText, TagSuggestionPluginKey } from './tag'\n\n/** The mention and tag nodes of the document schema. */\nexport const mentionsSchemaExtensions = (): AnyExtension[] => [MentionNode, TagNode]\n"],"mappings":";;;;;AAYA,MAAa,iCAAiD,CAAC,aAAa,OAAO"}
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/mentions/schema.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport { MentionNode } from './mention'\nimport { TagNode } from './tag'\n\n// Vue-free and server-importable (`@ecsplico/editor/mentions/schema`): the mention and tag nodes, their Markdown\n// forms and the text helpers that turn `@name` / `#tag` back into chips. The suggestion popups live in the feature.\n\nexport type { MentionUser } from '../../core/backend-types'\nexport { type MentionAttrs, MentionNode } from './mention'\nexport { type MentionTarget, mentionsFromText, mentionUsersIn } from './mention-text'\nexport { collectTagNames, normalizeTagName, TAG_NODE, TagNode, type TagAttrs, type TagOptions, type TagSuggestionItem, tagsFromText, TagSuggestionPluginKey } from './tag'\n\n/** The mention and tag nodes of the document schema. */\nexport const mentionsSchemaExtensions = (): AnyExtension[] => [MentionNode, TagNode]\n"],"mappings":";;;;;AAaA,MAAa,iCAAiD,CAAC,aAAa,OAAO"}

package/dist/features/tables/feature.d.ts

@@ -6,7 +6,8 @@ export declare const TABLE_TOOLBAR_GROUP = "table";
 /**
  * GFM tables and task lists: the table and task-list nodes (Markdown round-trips through `@tiptap/markdown`, tables as
  * pipe tables, tasks as `- [ ]`/`- [x]`), the toolbar group `table` (insert 3×3, add row, add column, delete row, delete
- * column, delete table) and the slash entries `table.insert` and `task.insert`. All are offered where the caret has
+ * column, delete table) and the slash entries `table.insert` and `task.insert`: one command each, the table commands
+ * on the toolbar, `insertTable` and `task.insert` also in the `/` menu. All are offered where the caret has
  * `block.content`. Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.
  */
 export declare function tablesFeature(): EditorFeature<never>;

package/dist/features/tables/feature.js

@@ -1,5 +1,5 @@
 import { ABILITY } from "../../core/schema/abilities.js";
-import { commandItem } from "../../core/toolbar.js";
+import { command } from "../../core/commands.js";
 import { tablesSchemaExtensions } from "./schema.js";
 //#region src/features/tables/feature.ts
 /** The toolbar group the tables feature contributes; its position follows the core groups (`blocks` is 40). */
@@ -10,88 +10,108 @@ const INSERT = {
 	cols: 3,
 	withHeaderRow: true
 };
-const toolbar = (ctx) => [{
+const toolbarGroups = [{
 	id: TABLE_TOOLBAR_GROUP,
 	order: 60,
-	items: [
-		{
-			...commandItem({
-				id: "insertTable",
-				order: 10,
-				icon: "i-lucide-table",
-				label: ctx.t("tables.toolbar.insert"),
-				ability: ABILITY.blockContent,
-				command: (c) => c.insertTable(INSERT)
-			}),
-			disabled: (editor) => editor.isActive("table") || !editor.can().insertTable(INSERT)
-		},
-		commandItem({
-			id: "addRow",
-			order: 20,
-			icon: "i-lucide-between-horizontal-end",
-			label: ctx.t("tables.toolbar.addRow"),
-			ability: ABILITY.blockContent,
-			command: (c) => c.addRowAfter()
-		}),
-		commandItem({
-			id: "addColumn",
-			order: 30,
-			icon: "i-lucide-between-vertical-end",
-			label: ctx.t("tables.toolbar.addColumn"),
-			ability: ABILITY.blockContent,
-			command: (c) => c.addColumnAfter()
-		}),
-		commandItem({
-			id: "deleteRow",
-			order: 40,
-			icon: "i-lucide-table-rows-split",
-			label: ctx.t("tables.toolbar.deleteRow"),
-			ability: ABILITY.blockContent,
-			command: (c) => c.deleteRow()
-		}),
-		commandItem({
-			id: "deleteColumn",
-			order: 50,
-			icon: "i-lucide-table-columns-split",
-			label: ctx.t("tables.toolbar.deleteColumn"),
+	labelKey: "palette.group.table"
+}];
+const commands = (ctx) => [
+	{
+		...command({
+			id: "insertTable",
+			toolbar: {
+				group: TABLE_TOOLBAR_GROUP,
+				order: 10
+			},
+			slash: { id: "table.insert" },
+			creates: { type: "table" },
+			icon: "i-lucide-table",
+			label: ctx.t("tables.toolbar.insert"),
 			ability: ABILITY.blockContent,
-			command: (c) => c.deleteColumn()
+			command: (c) => c.insertTable(INSERT)
 		}),
-		commandItem({
-			id: "deleteTable",
-			order: 60,
-			icon: "i-lucide-trash-2",
-			label: ctx.t("tables.toolbar.deleteTable"),
-			ability: ABILITY.blockContent,
-			command: (c) => c.deleteTable()
-		})
-	]
-}];
-const slashCommands = (ctx) => [{
-	id: "table.insert",
-	label: ctx.t("tables.slash.table"),
-	icon: "i-lucide-table",
-	ability: ABILITY.blockContent,
-	run: (editor) => void editor.chain().focus().insertTable(INSERT).run()
-}, {
-	id: "task.insert",
-	label: ctx.t("tables.slash.tasks"),
-	icon: "i-lucide-list-checks",
-	ability: ABILITY.blockContent,
-	run: (editor) => void editor.chain().focus().toggleTaskList().run()
-}];
+		can: (editor) => !editor.isActive("table") && editor.can().insertTable(INSERT)
+	},
+	command({
+		id: "addRow",
+		toolbar: {
+			group: TABLE_TOOLBAR_GROUP,
+			order: 20
+		},
+		icon: "i-lucide-between-horizontal-end",
+		label: ctx.t("tables.toolbar.addRow"),
+		ability: ABILITY.blockContent,
+		command: (c) => c.addRowAfter()
+	}),
+	command({
+		id: "addColumn",
+		toolbar: {
+			group: TABLE_TOOLBAR_GROUP,
+			order: 30
+		},
+		icon: "i-lucide-between-vertical-end",
+		label: ctx.t("tables.toolbar.addColumn"),
+		ability: ABILITY.blockContent,
+		command: (c) => c.addColumnAfter()
+	}),
+	command({
+		id: "deleteRow",
+		toolbar: {
+			group: TABLE_TOOLBAR_GROUP,
+			order: 40
+		},
+		icon: "i-lucide-table-rows-split",
+		label: ctx.t("tables.toolbar.deleteRow"),
+		ability: ABILITY.blockContent,
+		command: (c) => c.deleteRow()
+	}),
+	command({
+		id: "deleteColumn",
+		toolbar: {
+			group: TABLE_TOOLBAR_GROUP,
+			order: 50
+		},
+		icon: "i-lucide-table-columns-split",
+		label: ctx.t("tables.toolbar.deleteColumn"),
+		ability: ABILITY.blockContent,
+		command: (c) => c.deleteColumn()
+	}),
+	command({
+		id: "deleteTable",
+		toolbar: {
+			group: TABLE_TOOLBAR_GROUP,
+			order: 60
+		},
+		icon: "i-lucide-trash-2",
+		label: ctx.t("tables.toolbar.deleteTable"),
+		ability: ABILITY.blockContent,
+		command: (c) => c.deleteTable()
+	}),
+	command({
+		id: "task.insert",
+		slash: { id: "task.insert" },
+		creates: { type: "taskList" },
+		icon: "i-lucide-list-checks",
+		label: ctx.t("tables.slash.tasks"),
+		ability: ABILITY.blockContent,
+		command: (c) => c.toggleTaskList()
+	})
+];
 /**
 * GFM tables and task lists: the table and task-list nodes (Markdown round-trips through `@tiptap/markdown`, tables as
 * pipe tables, tasks as `- [ ]`/`- [x]`), the toolbar group `table` (insert 3×3, add row, add column, delete row, delete
-* column, delete table) and the slash entries `table.insert` and `task.insert`. All are offered where the caret has
+* column, delete table) and the slash entries `table.insert` and `task.insert`: one command each, the table commands
+* on the toolbar, `insertTable` and `task.insert` also in the `/` menu. All are offered where the caret has
 * `block.content`. Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.
 */
 function tablesFeature() {
 	return {
 		id: "tables",
+		dimension: "content",
+		schemaExtensions: tablesSchemaExtensions,
 		extensions: () => tablesSchemaExtensions(),
-		toolbar,
-		slashCommands
+		toolbarGroups,
+		commands
 	};
 }
 //#endregion

package/dist/features/tables/feature.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/tables/feature.ts"],"sourcesContent":["import { commandItem, type EditorFeature, type FeatureContext, type SlashCommandItem, type ToolbarGroup } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { tablesSchemaExtensions } from './schema'\n\n/** The toolbar group the tables feature contributes; its position follows the core groups (`blocks` is 40). */\nexport const TABLE_TOOLBAR_GROUP = 'table'\n\n/** Columns, rows and header row of a table the toolbar and the slash menu insert. */\nconst INSERT = { rows: 3, cols: 3, withHeaderRow: true } as const\n\nconst toolbar = (ctx: FeatureContext): ToolbarGroup<never>[] => [{\n  id: TABLE_TOOLBAR_GROUP,\n  order: 60,\n  items: [\n    {\n      ...commandItem({ id: 'insertTable', order: 10, icon: 'i-lucide-table', label: ctx.t('tables.toolbar.insert'), ability: ABILITY.blockContent, command: c => c.insertTable(INSERT) }),\n      // GFM has no nested tables: inside one the button is off.\n      disabled: editor => editor.isActive('table') || !editor.can().insertTable(INSERT),\n    },\n    commandItem({ id: 'addRow', order: 20, icon: 'i-lucide-between-horizontal-end', label: ctx.t('tables.toolbar.addRow'), ability: ABILITY.blockContent, command: c => c.addRowAfter() }),\n    commandItem({ id: 'addColumn', order: 30, icon: 'i-lucide-between-vertical-end', label: ctx.t('tables.toolbar.addColumn'), ability: ABILITY.blockContent, command: c => c.addColumnAfter() }),\n    commandItem({ id: 'deleteRow', order: 40, icon: 'i-lucide-table-rows-split', label: ctx.t('tables.toolbar.deleteRow'), ability: ABILITY.blockContent, command: c => c.deleteRow() }),\n    commandItem({ id: 'deleteColumn', order: 50, icon: 'i-lucide-table-columns-split', label: ctx.t('tables.toolbar.deleteColumn'), ability: ABILITY.blockContent, command: c => c.deleteColumn() }),\n    commandItem({ id: 'deleteTable', order: 60, icon: 'i-lucide-trash-2', label: ctx.t('tables.toolbar.deleteTable'), ability: ABILITY.blockContent, command: c => c.deleteTable() }),\n  ],\n}]\n\nconst slashCommands = (ctx: FeatureContext): SlashCommandItem[] => [\n  { id: 'table.insert', label: ctx.t('tables.slash.table'), icon: 'i-lucide-table', ability: ABILITY.blockContent, run: editor => void editor.chain().focus().insertTable(INSERT).run() },\n  { id: 'task.insert', label: ctx.t('tables.slash.tasks'), icon: 'i-lucide-list-checks', ability: ABILITY.blockContent, run: editor => void editor.chain().focus().toggleTaskList().run() },\n]\n\n/**\n * GFM tables and task lists: the table and task-list nodes (Markdown round-trips through `@tiptap/markdown`, tables as\n * pipe tables, tasks as `- [ ]`/`- [x]`), the toolbar group `table` (insert 3×3, add row, add column, delete row, delete\n * column, delete table) and the slash entries `table.insert` and `task.insert`. All are offered where the caret has\n * `block.content`. Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.\n */\nexport function tablesFeature(): EditorFeature<never> {\n  return {\n    id: 'tables',\n    extensions: () => tablesSchemaExtensions(),\n    toolbar,\n    slashCommands,\n  }\n}\n"],"mappings":";;;;;AAKA,MAAa,sBAAsB;;AAGnC,MAAM,SAAS;CAAE,MAAM;CAAG,MAAM;CAAG,eAAe;AAAK;AAEvD,MAAM,WAAW,QAA+C,CAAC;CAC/D,IAAI;CACJ,OAAO;CACP,OAAO;EACL;GACE,GAAG,YAAY;IAAE,IAAI;IAAe,OAAO;IAAI,MAAM;IAAkB,OAAO,IAAI,EAAE,uBAAuB;IAAG,SAAS,QAAQ;IAAc,UAAS,MAAK,EAAE,YAAY,MAAM;GAAE,CAAC;GAElL,WAAU,WAAU,OAAO,SAAS,OAAO,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,YAAY,MAAM;EAClF;EACA,YAAY;GAAE,IAAI;GAAU,OAAO;GAAI,MAAM;GAAmC,OAAO,IAAI,EAAE,uBAAuB;GAAG,SAAS,QAAQ;GAAc,UAAS,MAAK,EAAE,YAAY;EAAE,CAAC;EACrL,YAAY;GAAE,IAAI;GAAa,OAAO;GAAI,MAAM;GAAiC,OAAO,IAAI,EAAE,0BAA0B;GAAG,SAAS,QAAQ;GAAc,UAAS,MAAK,EAAE,eAAe;EAAE,CAAC;EAC5L,YAAY;GAAE,IAAI;GAAa,OAAO;GAAI,MAAM;GAA6B,OAAO,IAAI,EAAE,0BAA0B;GAAG,SAAS,QAAQ;GAAc,UAAS,MAAK,EAAE,UAAU;EAAE,CAAC;EACnL,YAAY;GAAE,IAAI;GAAgB,OAAO;GAAI,MAAM;GAAgC,OAAO,IAAI,EAAE,6BAA6B;GAAG,SAAS,QAAQ;GAAc,UAAS,MAAK,EAAE,aAAa;EAAE,CAAC;EAC/L,YAAY;GAAE,IAAI;GAAe,OAAO;GAAI,MAAM;GAAoB,OAAO,IAAI,EAAE,4BAA4B;GAAG,SAAS,QAAQ;GAAc,UAAS,MAAK,EAAE,YAAY;EAAE,CAAC;CAClL;AACF,CAAC;AAED,MAAM,iBAAiB,QAA4C,CACjE;CAAE,IAAI;CAAgB,OAAO,IAAI,EAAE,oBAAoB;CAAG,MAAM;CAAkB,SAAS,QAAQ;CAAc,MAAK,WAAU,KAAK,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,IAAI;AAAE,GACtL;CAAE,IAAI;CAAe,OAAO,IAAI,EAAE,oBAAoB;CAAG,MAAM;CAAwB,SAAS,QAAQ;CAAc,MAAK,WAAU,KAAK,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI;AAAE,CAC1L;;;;;;;AAQA,SAAgB,gBAAsC;CACpD,OAAO;EACL,IAAI;EACJ,kBAAkB,uBAAuB;EACzC;EACA;CACF;AACF"}
+{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/tables/feature.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { type CommandDef, command, type EditorFeature, type FeatureContext, type ToolbarGroupDef } from '../../core'\nimport { ABILITY } from '../../core/schema'\nimport { tablesSchemaExtensions } from './schema'\n\n/** The toolbar group the tables feature contributes; its position follows the core groups (`blocks` is 40). */\nexport const TABLE_TOOLBAR_GROUP = 'table'\n\n/** Columns, rows and header row of a table the toolbar and the slash menu insert. */\nconst INSERT = { rows: 3, cols: 3, withHeaderRow: true } as const\n\nconst toolbarGroups: ToolbarGroupDef[] = [{ id: TABLE_TOOLBAR_GROUP, order: 60, labelKey: 'palette.group.table' }]\n\nconst commands = (ctx: FeatureContext): CommandDef<never>[] => [\n  {\n    ...command({\n      id: 'insertTable',\n      toolbar: { group: TABLE_TOOLBAR_GROUP, order: 10 },\n      slash: { id: 'table.insert' },\n      creates: { type: 'table' },\n      icon: 'i-lucide-table',\n      label: ctx.t('tables.toolbar.insert'),\n      ability: ABILITY.blockContent,\n      command: c => c.insertTable(INSERT),\n    }),\n    // GFM has no nested tables: inside one the command is off.\n    can: (editor: Editor) => !editor.isActive('table') && editor.can().insertTable(INSERT),\n  },\n  command({ id: 'addRow', toolbar: { group: TABLE_TOOLBAR_GROUP, order: 20 }, icon: 'i-lucide-between-horizontal-end', label: ctx.t('tables.toolbar.addRow'), ability: ABILITY.blockContent, command: c => c.addRowAfter() }),\n  command({ id: 'addColumn', toolbar: { group: TABLE_TOOLBAR_GROUP, order: 30 }, icon: 'i-lucide-between-vertical-end', label: ctx.t('tables.toolbar.addColumn'), ability: ABILITY.blockContent, command: c => c.addColumnAfter() }),\n  command({ id: 'deleteRow', toolbar: { group: TABLE_TOOLBAR_GROUP, order: 40 }, icon: 'i-lucide-table-rows-split', label: ctx.t('tables.toolbar.deleteRow'), ability: ABILITY.blockContent, command: c => c.deleteRow() }),\n  command({ id: 'deleteColumn', toolbar: { group: TABLE_TOOLBAR_GROUP, order: 50 }, icon: 'i-lucide-table-columns-split', label: ctx.t('tables.toolbar.deleteColumn'), ability: ABILITY.blockContent, command: c => c.deleteColumn() }),\n  command({ id: 'deleteTable', toolbar: { group: TABLE_TOOLBAR_GROUP, order: 60 }, icon: 'i-lucide-trash-2', label: ctx.t('tables.toolbar.deleteTable'), ability: ABILITY.blockContent, command: c => c.deleteTable() }),\n  command({ id: 'task.insert', slash: { id: 'task.insert' }, creates: { type: 'taskList' }, icon: 'i-lucide-list-checks', label: ctx.t('tables.slash.tasks'), ability: ABILITY.blockContent, command: c => c.toggleTaskList() }),\n]\n\n/**\n * GFM tables and task lists: the table and task-list nodes (Markdown round-trips through `@tiptap/markdown`, tables as\n * pipe tables, tasks as `- [ ]`/`- [x]`), the toolbar group `table` (insert 3×3, add row, add column, delete row, delete\n * column, delete table) and the slash entries `table.insert` and `task.insert`: one command each, the table commands\n * on the toolbar, `insertTable` and `task.insert` also in the `/` menu. All are offered where the caret has\n * `block.content`. Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.\n */\nexport function tablesFeature(): EditorFeature<never> {\n  return {\n    id: 'tables',\n    dimension: 'content',\n    schemaExtensions: tablesSchemaExtensions,\n    extensions: () => tablesSchemaExtensions(),\n    toolbarGroups,\n    commands,\n  }\n}\n"],"mappings":";;;;;AAMA,MAAa,sBAAsB;;AAGnC,MAAM,SAAS;CAAE,MAAM;CAAG,MAAM;CAAG,eAAe;AAAK;AAEvD,MAAM,gBAAmC,CAAC;CAAE,IAAI;CAAqB,OAAO;CAAI,UAAU;AAAsB,CAAC;AAEjH,MAAM,YAAY,QAA6C;CAC7D;EACE,GAAG,QAAQ;GACT,IAAI;GACJ,SAAS;IAAE,OAAO;IAAqB,OAAO;GAAG;GACjD,OAAO,EAAE,IAAI,eAAe;GAC5B,SAAS,EAAE,MAAM,QAAQ;GACzB,MAAM;GACN,OAAO,IAAI,EAAE,uBAAuB;GACpC,SAAS,QAAQ;GACjB,UAAS,MAAK,EAAE,YAAY,MAAM;EACpC,CAAC;EAED,MAAM,WAAmB,CAAC,OAAO,SAAS,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,YAAY,MAAM;CACvF;CACA,QAAQ;EAAE,IAAI;EAAU,SAAS;GAAE,OAAO;GAAqB,OAAO;EAAG;EAAG,MAAM;EAAmC,OAAO,IAAI,EAAE,uBAAuB;EAAG,SAAS,QAAQ;EAAc,UAAS,MAAK,EAAE,YAAY;CAAE,CAAC;CAC1N,QAAQ;EAAE,IAAI;EAAa,SAAS;GAAE,OAAO;GAAqB,OAAO;EAAG;EAAG,MAAM;EAAiC,OAAO,IAAI,EAAE,0BAA0B;EAAG,SAAS,QAAQ;EAAc,UAAS,MAAK,EAAE,eAAe;CAAE,CAAC;CACjO,QAAQ;EAAE,IAAI;EAAa,SAAS;GAAE,OAAO;GAAqB,OAAO;EAAG;EAAG,MAAM;EAA6B,OAAO,IAAI,EAAE,0BAA0B;EAAG,SAAS,QAAQ;EAAc,UAAS,MAAK,EAAE,UAAU;CAAE,CAAC;CACxN,QAAQ;EAAE,IAAI;EAAgB,SAAS;GAAE,OAAO;GAAqB,OAAO;EAAG;EAAG,MAAM;EAAgC,OAAO,IAAI,EAAE,6BAA6B;EAAG,SAAS,QAAQ;EAAc,UAAS,MAAK,EAAE,aAAa;CAAE,CAAC;CACpO,QAAQ;EAAE,IAAI;EAAe,SAAS;GAAE,OAAO;GAAqB,OAAO;EAAG;EAAG,MAAM;EAAoB,OAAO,IAAI,EAAE,4BAA4B;EAAG,SAAS,QAAQ;EAAc,UAAS,MAAK,EAAE,YAAY;CAAE,CAAC;CACrN,QAAQ;EAAE,IAAI;EAAe,OAAO,EAAE,IAAI,cAAc;EAAG,SAAS,EAAE,MAAM,WAAW;EAAG,MAAM;EAAwB,OAAO,IAAI,EAAE,oBAAoB;EAAG,SAAS,QAAQ;EAAc,UAAS,MAAK,EAAE,eAAe;CAAE,CAAC;AAC/N;;;;;;;;AASA,SAAgB,gBAAsC;CACpD,OAAO;EACL,IAAI;EACJ,WAAW;EACX,kBAAkB;EAClB,kBAAkB,uBAAuB;EACzC;EACA;CACF;AACF"}

package/dist/features/themes/components/SettingsAppearanceTab.js

@@ -19,14 +19,14 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 	__name: "SettingsAppearanceTab",
 	setup(__props) {
 		const { settings } = useEditorSettings();
-		const { fetch } = useEditorContext();
+		const { backend } = useEditorContext();
 		const { Badge: UBadge, Button: UButton, FormField: UFormField, Input: UInput, Select: USelect, notifier } = useUiKit();
 		const notify = notifier();
 		const { t } = useEditorI18n();
 		/** USelect has no `null` value: „Standard“ travels as this sentinel (no theme id can contain underscores). */
 		const themes = shallowRef([]);
 		async function loadThemes() {
-			themes.value = await fetch("/api/editor/themes");
+			themes.value = await backend.themes?.list() ?? [];
 		}
 		onMounted(async () => {
 			try {
@@ -59,14 +59,11 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		async function upload() {
 			const css = cssFile.value;
 			if (!css || uploading.value) return;
-			const body = new FormData();
-			body.append("css", css);
-			if (manifestFile.value) body.append("manifest", manifestFile.value);
 			uploading.value = true;
 			try {
-				const record = await fetch("/api/editor/themes", {
-					method: "POST",
-					body
+				const record = await backend.themes.store({
+					css,
+					...manifestFile.value && { manifest: manifestFile.value }
 				});
 				cssFile.value = null;
 				manifestFile.value = null;
@@ -96,7 +93,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			if (removing.value) return;
 			removing.value = record.id;
 			try {
-				await fetch(`/api/editor/themes/${encodeURIComponent(record.id)}`, { method: "DELETE" });
+				await backend.themes.remove(record.id);
 				if (settings.value.appearance.theme === record.id) settings.value.appearance.theme = null;
 				notify({
 					title: t("themes.delete.done", { name: record.name }),

package/dist/features/themes/components/SettingsAppearanceTab.js.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsAppearanceTab.js","names":["_openBlock","_createElementBlock","_createVNode","SettingsSection","_unref","_withCtx","_createElementVNode","_withModifiers","_createBlock","_Fragment","_renderList","_toDisplayString","_createCommentVNode"],"sources":["../../../../src/features/themes/components/SettingsAppearanceTab.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, onMounted, ref, shallowRef } from 'vue'\nimport SettingsSection from '../../../vue/components/SettingsSection.vue'\nimport { fetchErrorMessage } from '../../../core/fetch-error'\nimport { useEditorContext } from '../../../vue/context'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorSettings } from '../../../vue/settings'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\nimport type { ThemeRecord } from '../schema'\n\n/** „Darstellung“: the Obsidian theme of the whole app (`appearance.theme`); „Standard“ is the Nuxt UI look. */\nconst { settings } = useEditorSettings()\nconst { fetch } = useEditorContext()\nconst { Badge: UBadge, Button: UButton, FormField: UFormField, Input: UInput, Select: USelect, notifier } = useUiKit()\nconst notify = notifier()\nconst { t } = useEditorI18n()\n\n/** USelect has no `null` value: „Standard“ travels as this sentinel (no theme id can contain underscores). */\nconst STANDARD = '__standard__'\n\nconst themes = shallowRef<ThemeRecord[]>([])\n\nasync function loadThemes() {\n  themes.value = await fetch<ThemeRecord[]>('/api/editor/themes')\n}\n\nonMounted(async () => {\n  try {\n    await loadThemes()\n  }\n  catch (error) {\n    console.warn('tiptap-editor: Die Themes konnten nicht geladen werden', error)\n  }\n})\n\nconst items = computed(() => [\n  { label: t('themes.standard'), value: STANDARD },\n  ...themes.value.map(({ id, name, author }) => ({ label: author ? `${name} – ${author}` : name, value: id })),\n])\n\nconst theme = computed({\n  get: () => settings.value.appearance.theme ?? STANDARD,\n  set: (value: string) => {\n    settings.value.appearance.theme = value === STANDARD ? null : value\n  },\n})\n\nconst cssFile = shallowRef<File | null>(null)\nconst manifestFile = shallowRef<File | null>(null)\nconst uploading = ref(false)\n/** Bumped after an upload to remount the file inputs (a file input cannot be cleared through its model). */\nconst inputKey = ref(0)\n\nfunction pickedFile(event: Event): File | null {\n  return (event.target as HTMLInputElement).files?.[0] ?? null\n}\n\nasync function upload() {\n  const css = cssFile.value\n  if (!css || uploading.value) return\n  const body = new FormData()\n  body.append('css', css)\n  if (manifestFile.value) body.append('manifest', manifestFile.value)\n  uploading.value = true\n  try {\n    const record = await fetch<ThemeRecord>('/api/editor/themes', { method: 'POST', body })\n    cssFile.value = null\n    manifestFile.value = null\n    inputKey.value++\n    settings.value.appearance.theme = record.id\n    notify({ title: t('themes.upload.done', { name: record.name }), kind: 'success' })\n    try {\n      await loadThemes()\n    }\n    catch (error) {\n      console.warn('tiptap-editor: Die Themes konnten nicht geladen werden', error)\n    }\n  }\n  catch (error) {\n    notify({ title: t('themes.upload.failed'), description: fetchErrorMessage(error), kind: 'error' })\n  }\n  finally {\n    uploading.value = false\n  }\n}\n\nconst removing = ref<string | null>(null)\n\nasync function remove(record: ThemeRecord) {\n  if (removing.value) return\n  removing.value = record.id\n  try {\n    await fetch(`/api/editor/themes/${encodeURIComponent(record.id)}`, { method: 'DELETE' })\n    if (settings.value.appearance.theme === record.id) settings.value.appearance.theme = null\n    notify({ title: t('themes.delete.done', { name: record.name }), kind: 'success' })\n    try {\n      await loadThemes()\n    }\n    catch (error) {\n      console.warn('tiptap-editor: Die Themes konnten nicht geladen werden', error)\n    }\n  }\n  catch (error) {\n    notify({ title: t('themes.delete.failed'), description: fetchErrorMessage(error), kind: 'error' })\n  }\n  finally {\n    removing.value = null\n  }\n}\n</script>\n\n<template>\n  <div class=\"flex flex-col gap-8\">\n    <SettingsSection :title=\"t('themes.title')\">\n      <UFormField\n        orientation=\"horizontal\"\n        class=\"py-3\"\n        :label=\"t('themes.select.label')\"\n        :description=\"t('themes.select.description')\"\n      >\n        <USelect v-model=\"theme\" :items=\"items\" class=\"w-64\" />\n      </UFormField>\n\n      <UFormField\n        orientation=\"horizontal\"\n        class=\"py-3\"\n        :label=\"t('themes.upload.label')\"\n        :description=\"t('themes.upload.description')\"\n      >\n        <form class=\"flex w-64 flex-col gap-2\" @submit.prevent=\"upload\">\n          <UFormField :label=\"t('themes.upload.css')\" required size=\"xs\">\n            <UInput\n              :key=\"`css-${inputKey}`\"\n              type=\"file\"\n              accept=\".css,text/css\"\n              class=\"w-full\"\n              :disabled=\"uploading\"\n              @change=\"cssFile = pickedFile($event)\"\n            />\n          </UFormField>\n          <UFormField :label=\"t('themes.upload.manifest')\" size=\"xs\">\n            <UInput\n              :key=\"`manifest-${inputKey}`\"\n              type=\"file\"\n              accept=\".json,application/json\"\n              class=\"w-full\"\n              :disabled=\"uploading\"\n              @change=\"manifestFile = pickedFile($event)\"\n            />\n          </UFormField>\n          <UButton\n            type=\"submit\"\n            icon=\"i-lucide-upload\"\n            :label=\"t('themes.upload.submit')\"\n            class=\"self-start\"\n            :disabled=\"!cssFile\"\n            :loading=\"uploading\"\n          />\n        </form>\n      </UFormField>\n    </SettingsSection>\n\n    <SettingsSection v-if=\"themes.length\" :title=\"t('themes.library')\">\n      <div v-for=\"record in themes\" :key=\"record.id\" class=\"flex items-center gap-3 py-2\">\n        <div class=\"flex min-w-0 flex-1 flex-col\">\n          <span class=\"truncate text-sm font-medium text-[var(--sk-fg-highlighted)]\">{{ record.name }}</span>\n          <span v-if=\"record.version || record.author\" class=\"truncate text-xs text-[var(--sk-muted)]\">\n            {{ [record.version && t('themes.version', { version: record.version }), record.author && t('themes.byAuthor', { author: record.author })].filter(Boolean).join(' · ') }}\n          </span>\n        </div>\n        <UBadge v-if=\"record.builtin\" color=\"neutral\" variant=\"subtle\" :label=\"t('themes.builtin')\" />\n        <UButton\n          v-else\n          icon=\"i-lucide-trash-2\"\n          variant=\"ghost\"\n          color=\"error\"\n          :aria-label=\"t('themes.delete.label', { name: record.name })\"\n          :loading=\"removing === record.id\"\n          :disabled=\"removing !== null\"\n          @click=\"remove(record)\"\n        />\n      </div>\n    </SettingsSection>\n  </div>\n</template>\n"],"mappings":"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"}
+{"version":3,"file":"SettingsAppearanceTab.js","names":["_openBlock","_createElementBlock","_createVNode","SettingsSection","_unref","_withCtx","_createElementVNode","_withModifiers","_createBlock","_Fragment","_renderList","_toDisplayString","_createCommentVNode"],"sources":["../../../../src/features/themes/components/SettingsAppearanceTab.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { computed, onMounted, ref, shallowRef } from 'vue'\nimport SettingsSection from '../../../vue/components/SettingsSection.vue'\nimport { fetchErrorMessage } from '../../../core/fetch-error'\nimport { useEditorContext } from '../../../vue/context'\nimport { useUiKit } from '../../../vue/kit/use-ui-kit'\nimport { useEditorSettings } from '../../../vue/settings'\nimport { useEditorI18n } from '../../../vue/use-editor-i18n'\nimport type { ThemeRecord } from '../schema'\n\n/** „Darstellung“: the Obsidian theme of the whole app (`appearance.theme`); „Standard“ is the Nuxt UI look. */\nconst { settings } = useEditorSettings()\nconst { backend } = useEditorContext()\nconst { Badge: UBadge, Button: UButton, FormField: UFormField, Input: UInput, Select: USelect, notifier } = useUiKit()\nconst notify = notifier()\nconst { t } = useEditorI18n()\n\n/** USelect has no `null` value: „Standard“ travels as this sentinel (no theme id can contain underscores). */\nconst STANDARD = '__standard__'\n\nconst themes = shallowRef<ThemeRecord[]>([])\n\nasync function loadThemes() {\n  themes.value = await backend.themes?.list() ?? []\n}\n\nonMounted(async () => {\n  try {\n    await loadThemes()\n  }\n  catch (error) {\n    console.warn('tiptap-editor: Die Themes konnten nicht geladen werden', error)\n  }\n})\n\nconst items = computed(() => [\n  { label: t('themes.standard'), value: STANDARD },\n  ...themes.value.map(({ id, name, author }) => ({ label: author ? `${name} – ${author}` : name, value: id })),\n])\n\nconst theme = computed({\n  get: () => settings.value.appearance.theme ?? STANDARD,\n  set: (value: string) => {\n    settings.value.appearance.theme = value === STANDARD ? null : value\n  },\n})\n\nconst cssFile = shallowRef<File | null>(null)\nconst manifestFile = shallowRef<File | null>(null)\nconst uploading = ref(false)\n/** Bumped after an upload to remount the file inputs (a file input cannot be cleared through its model). */\nconst inputKey = ref(0)\n\nfunction pickedFile(event: Event): File | null {\n  return (event.target as HTMLInputElement).files?.[0] ?? null\n}\n\nasync function upload() {\n  const css = cssFile.value\n  if (!css || uploading.value) return\n  uploading.value = true\n  try {\n    // The themes feature needs the `themes` capability, so the tab is only mounted where the backend has it.\n    const record = await backend.themes!.store({ css, ...(manifestFile.value && { manifest: manifestFile.value }) })\n    cssFile.value = null\n    manifestFile.value = null\n    inputKey.value++\n    settings.value.appearance.theme = record.id\n    notify({ title: t('themes.upload.done', { name: record.name }), kind: 'success' })\n    try {\n      await loadThemes()\n    }\n    catch (error) {\n      console.warn('tiptap-editor: Die Themes konnten nicht geladen werden', error)\n    }\n  }\n  catch (error) {\n    notify({ title: t('themes.upload.failed'), description: fetchErrorMessage(error), kind: 'error' })\n  }\n  finally {\n    uploading.value = false\n  }\n}\n\nconst removing = ref<string | null>(null)\n\nasync function remove(record: ThemeRecord) {\n  if (removing.value) return\n  removing.value = record.id\n  try {\n    await backend.themes!.remove(record.id)\n    if (settings.value.appearance.theme === record.id) settings.value.appearance.theme = null\n    notify({ title: t('themes.delete.done', { name: record.name }), kind: 'success' })\n    try {\n      await loadThemes()\n    }\n    catch (error) {\n      console.warn('tiptap-editor: Die Themes konnten nicht geladen werden', error)\n    }\n  }\n  catch (error) {\n    notify({ title: t('themes.delete.failed'), description: fetchErrorMessage(error), kind: 'error' })\n  }\n  finally {\n    removing.value = null\n  }\n}\n</script>\n\n<template>\n  <div class=\"flex flex-col gap-8\">\n    <SettingsSection :title=\"t('themes.title')\">\n      <UFormField\n        orientation=\"horizontal\"\n        class=\"py-3\"\n        :label=\"t('themes.select.label')\"\n        :description=\"t('themes.select.description')\"\n      >\n        <USelect v-model=\"theme\" :items=\"items\" class=\"w-64\" />\n      </UFormField>\n\n      <UFormField\n        orientation=\"horizontal\"\n        class=\"py-3\"\n        :label=\"t('themes.upload.label')\"\n        :description=\"t('themes.upload.description')\"\n      >\n        <form class=\"flex w-64 flex-col gap-2\" @submit.prevent=\"upload\">\n          <UFormField :label=\"t('themes.upload.css')\" required size=\"xs\">\n            <UInput\n              :key=\"`css-${inputKey}`\"\n              type=\"file\"\n              accept=\".css,text/css\"\n              class=\"w-full\"\n              :disabled=\"uploading\"\n              @change=\"cssFile = pickedFile($event)\"\n            />\n          </UFormField>\n          <UFormField :label=\"t('themes.upload.manifest')\" size=\"xs\">\n            <UInput\n              :key=\"`manifest-${inputKey}`\"\n              type=\"file\"\n              accept=\".json,application/json\"\n              class=\"w-full\"\n              :disabled=\"uploading\"\n              @change=\"manifestFile = pickedFile($event)\"\n            />\n          </UFormField>\n          <UButton\n            type=\"submit\"\n            icon=\"i-lucide-upload\"\n            :label=\"t('themes.upload.submit')\"\n            class=\"self-start\"\n            :disabled=\"!cssFile\"\n            :loading=\"uploading\"\n          />\n        </form>\n      </UFormField>\n    </SettingsSection>\n\n    <SettingsSection v-if=\"themes.length\" :title=\"t('themes.library')\">\n      <div v-for=\"record in themes\" :key=\"record.id\" class=\"flex items-center gap-3 py-2\">\n        <div class=\"flex min-w-0 flex-1 flex-col\">\n          <span class=\"truncate text-sm font-medium text-[var(--sk-fg-highlighted)]\">{{ record.name }}</span>\n          <span v-if=\"record.version || record.author\" class=\"truncate text-xs text-[var(--sk-muted)]\">\n            {{ [record.version && t('themes.version', { version: record.version }), record.author && t('themes.byAuthor', { author: record.author })].filter(Boolean).join(' · ') }}\n          </span>\n        </div>\n        <UBadge v-if=\"record.builtin\" color=\"neutral\" variant=\"subtle\" :label=\"t('themes.builtin')\" />\n        <UButton\n          v-else\n          icon=\"i-lucide-trash-2\"\n          variant=\"ghost\"\n          color=\"error\"\n          :aria-label=\"t('themes.delete.label', { name: record.name })\"\n          :loading=\"removing === record.id\"\n          :disabled=\"removing !== null\"\n          @click=\"remove(record)\"\n        />\n      </div>\n    </SettingsSection>\n  </div>\n</template>\n"],"mappings":"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"}

package/dist/features/themes/feature.js

@@ -10,6 +10,8 @@ import { startObsidianTheme } from "./theme-runtime.js";
 function themesFeatureCore(ui) {
 	return {
 		id: "themes",
+		dimension: "interaction",
+		backend: ["themes"],
 		setup: (ctx) => ui.lifetime ? ui.lifetime(ctx, () => startObsidianTheme(ctx)) : startObsidianTheme(ctx),
 		settingsTabs: (ctx) => [{
 			id: "appearance",

package/dist/features/themes/feature.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/themes/feature.ts"],"sourcesContent":["import type { EditorFeature, FeatureContext } from '../../core'\nimport { startObsidianTheme } from './theme-runtime'\n\n/** What a framework binding supplies to the themes feature. */\nexport interface ThemesUi<C> {\n  /** The „Darstellung“ settings tab component of the framework. */\n  settingsTab: C\n  /**\n   * Decides how long the theme runtime lives. Receives the feature context and `start` (starts the shared, reference-counted\n   * runtime and returns its idempotent release); its return value is the feature's `setup` result (the teardown run when\n   * the surface unmounts). Default: `start()` itself, i.e. the runtime lives as long as the surface is mounted.\n   */\n  lifetime?: (ctx: FeatureContext, start: () => () => void) => void | (() => void)\n}\n\n/**\n * Site-wide Obsidian themes: the theme named by the setting `appearance.theme` (`null` = the standard look) is\n * fetched from `GET /api/editor/themes/:id`, scoped to `.obsidian-theme` and injected as one `<style data-tiptap-theme>`\n * in the document head. `<html>` carries `obsidian-theme theme-dark|theme-light` following the app's colour mode\n * (`html.dark`, else the system preference), so the bridge stylesheet `styles/themes.css` maps Obsidian's variables onto\n * every UI token (the whole app) and onto the editor content. Needs an adapter with `listThemes`/`loadTheme`.\n */\nexport function themesFeatureCore<C>(ui: ThemesUi<C>): EditorFeature<C> {\n  return {\n    id: 'themes',\n    setup: ctx => (ui.lifetime ? ui.lifetime(ctx, () => startObsidianTheme(ctx)) : startObsidianTheme(ctx)),\n    settingsTabs: ctx => [{ id: 'appearance', label: ctx.t('themes.tab'), icon: 'i-lucide-palette', component: ui.settingsTab }],\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,kBAAqB,IAAmC;CACtE,OAAO;EACL,IAAI;EACJ,QAAO,QAAQ,GAAG,WAAW,GAAG,SAAS,WAAW,mBAAmB,GAAG,CAAC,IAAI,mBAAmB,GAAG;EACrG,eAAc,QAAO,CAAC;GAAE,IAAI;GAAc,OAAO,IAAI,EAAE,YAAY;GAAG,MAAM;GAAoB,WAAW,GAAG;EAAY,CAAC;CAC7H;AACF"}
+{"version":3,"file":"feature.js","names":[],"sources":["../../../src/features/themes/feature.ts"],"sourcesContent":["import type { EditorFeature, FeatureContext } from '../../core'\nimport { startObsidianTheme } from './theme-runtime'\n\n/** What a framework binding supplies to the themes feature. */\nexport interface ThemesUi<C> {\n  /** The „Darstellung“ settings tab component of the framework. */\n  settingsTab: C\n  /**\n   * Decides how long the theme runtime lives. Receives the feature context and `start` (starts the shared, reference-counted\n   * runtime and returns its idempotent release); its return value is the feature's `setup` result (the teardown run when\n   * the surface unmounts). Default: `start()` itself, i.e. the runtime lives as long as the surface is mounted.\n   */\n  lifetime?: (ctx: FeatureContext, start: () => () => void) => void | (() => void)\n}\n\n/**\n * Site-wide Obsidian themes: the theme named by the setting `appearance.theme` (`null` = the standard look) is\n * fetched from `GET /api/editor/themes/:id`, scoped to `.obsidian-theme` and injected as one `<style data-tiptap-theme>`\n * in the document head. `<html>` carries `obsidian-theme theme-dark|theme-light` following the app's colour mode\n * (`html.dark`, else the system preference), so the bridge stylesheet `styles/themes.css` maps Obsidian's variables onto\n * every UI token (the whole app) and onto the editor content. Needs an adapter with `listThemes`/`loadTheme`.\n */\nexport function themesFeatureCore<C>(ui: ThemesUi<C>): EditorFeature<C> {\n  return {\n    id: 'themes',\n    dimension: 'interaction',\n    backend: ['themes'],\n    setup: ctx => (ui.lifetime ? ui.lifetime(ctx, () => startObsidianTheme(ctx)) : startObsidianTheme(ctx)),\n    settingsTabs: ctx => [{ id: 'appearance', label: ctx.t('themes.tab'), icon: 'i-lucide-palette', component: ui.settingsTab }],\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,kBAAqB,IAAmC;CACtE,OAAO;EACL,IAAI;EACJ,WAAW;EACX,SAAS,CAAC,QAAQ;EAClB,QAAO,QAAQ,GAAG,WAAW,GAAG,SAAS,WAAW,mBAAmB,GAAG,CAAC,IAAI,mBAAmB,GAAG;EACrG,eAAc,QAAO,CAAC;GAAE,IAAI;GAAc,OAAO,IAAI,EAAE,YAAY;GAAG,MAAM;GAAoB,WAAW,GAAG;EAAY,CAAC;CAC7H;AACF"}

package/dist/features/themes/index.d.ts

@@ -1,5 +1,6 @@
 import { THEME_ID } from "../../settings/index.js";
-import { MAX_THEME_BYTES, ThemeManifest, ThemeRecord, themeManifestSchema } from "./schema.js";
+import { ThemeRecord } from "../../core/backend-types.js";
+import { MAX_THEME_BYTES, ThemeManifest, themeManifestSchema } from "./schema.js";
 import { ThemesUi, themesFeatureCore } from "./feature.js";
 import { scopeThemeCss } from "./scope-css.js";
 import { THEME_SCOPE_CLASS, startObsidianTheme } from "./theme-runtime.js";