@ecsplico/editor 2.1.1 → 3.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/media/schema.ts"],"sourcesContent":["import { type Attributes, type AnyExtension, mergeAttributes, Node } from '@tiptap/core'\nimport { Image } from '@tiptap/extension-image'\nimport { TEXT_ABILITIES } from '../../core/schema'\n\nexport * from './assets'\n\n// Vue-free and server-importable (`@ecsplico/editor/media/schema`): the upload API validates against these types, the\n// schema has the nodes. The client adds the node views in node-views.ts.\n\n/** The media nodes (image, audio, video, file) of the document schema. */\nexport const mediaSchemaExtensions = (): AnyExtension[] => [Image, AudioNode, VideoNode, FileNode]\n\nexport type MediaKind = 'image' | 'audio' | 'video' | 'file'\n\n/** Uploadable MIME types → file extension on disk and media kind. `<uuid>.<ext>` asset names derive from this. */\nexport const MEDIA_TYPES: Readonly<Record<string, { ext: string, kind: MediaKind }>> = {\n  'image/png': { ext: 'png', kind: 'image' },\n  'image/jpeg': { ext: 'jpg', kind: 'image' },\n  'image/gif': { ext: 'gif', kind: 'image' },\n  'image/webp': { ext: 'webp', kind: 'image' },\n  'audio/webm': { ext: 'weba', kind: 'audio' },\n  'audio/mp4': { ext: 'm4a', kind: 'audio' },\n  // What Chrome on macOS reports for `.m4a` files picked from disk.\n  'audio/x-m4a': { ext: 'm4a', kind: 'audio' },\n  'audio/mpeg': { ext: 'mp3', kind: 'audio' },\n  'audio/wav': { ext: 'wav', kind: 'audio' },\n  'audio/x-wav': { ext: 'wav', kind: 'audio' },\n  'audio/ogg': { ext: 'ogg', kind: 'audio' },\n  'video/mp4': { ext: 'mp4', kind: 'video' },\n  'video/webm': { ext: 'webm', kind: 'video' },\n  'video/quicktime': { ext: 'mov', kind: 'video' },\n}\n\n/** Upload size limit per kind. */\nexport const MAX_MEDIA_BYTES: Readonly<Record<MediaKind, number>> = {\n  image: 5 * 1024 * 1024,\n  audio: 50 * 1024 * 1024,\n  video: 200 * 1024 * 1024,\n  // Generic files (PDF, office documents, …): anything the media kinds do not cover.\n  file: 50 * 1024 * 1024,\n}\n\n/** `type` without parameters, lowercased (`audio/webm;codecs=opus` → `audio/webm`): the key into `MEDIA_TYPES`. */\nexport const mediaMime = (type: string): string => (type.split(';')[0] ?? '').trim().toLowerCase()\n\n/** Kind of an uploadable MIME type (parameters such as `;codecs=…` ignored); null when uploads do not accept it. */\nexport function mediaKindOf(mime: string): MediaKind | null {\n  return MEDIA_TYPES[mediaMime(mime)]?.kind ?? null\n}\n\n/** `accept` value of a file input for one kind: its MIME types, comma-joined. */\nexport function acceptFor(kind: MediaKind): string {\n  return Object.keys(MEDIA_TYPES).filter(mime => MEDIA_TYPES[mime]?.kind === kind).join(',')\n}\n\n/** Attributes of an audio/video node; `title` is the editable caption, `mimeType` the uploaded file's base type. */\nexport interface MediaAttrs {\n  src: string\n  title?: string\n  mimeType?: string\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    audio: {\n      /** Inserts an audio block at the selection. */\n      insertAudio: (attrs: MediaAttrs) => ReturnType\n    }\n    video: {\n      /** Inserts a video block at the selection. */\n      insertVideo: (attrs: MediaAttrs) => ReturnType\n    }\n  }\n}\n\nconst mediaAttributes: Attributes = {\n  src: { default: '' },\n  title: {\n    default: '',\n    parseHTML: el => el.getAttribute('data-title') ?? '',\n    renderHTML: attrs => ({ 'data-title': attrs.title }),\n  },\n  mimeType: {\n    default: '',\n    parseHTML: el => el.getAttribute('data-mime') ?? '',\n    renderHTML: attrs => ({ 'data-mime': attrs.mimeType }),\n  },\n}\n\n/** Markdown export (AI context, `getMarkdown()`): a link labelled with the kind and, when there is one, the title. */\nfunction mediaMarkdown(label: string, title: unknown, src: unknown): string {\n  const text = title ? `${label}: ${String(title).replace(/[[\\]\\\\]/g, '\\\\$&')}` : label\n  return `[${text}](${String(src ?? '')})`\n}\n\nexport const AudioNode = Node.create({\n  name: 'audio',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  // A player block holds no text: nothing text-related applies inside it.\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => mediaAttributes,\n  parseHTML: () => [{ tag: 'audio[src]' }],\n  renderHTML: ({ HTMLAttributes }) => ['audio', mergeAttributes(HTMLAttributes, { controls: 'true', preload: 'metadata' })],\n  renderMarkdown: node => mediaMarkdown('Audio', node.attrs?.title || 'Aufnahme', node.attrs?.src),\n  addCommands() {\n    return {\n      insertAudio: attrs => ({ commands }) => commands.insertContent({ type: this.name, attrs }),\n    }\n  },\n})\n\nexport const VideoNode = Node.create({\n  name: 'video',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => mediaAttributes,\n  parseHTML: () => [{ tag: 'video[src]' }],\n  renderHTML: ({ HTMLAttributes }) => ['video', mergeAttributes(HTMLAttributes, { controls: 'true', preload: 'metadata' })],\n  renderMarkdown: node => mediaMarkdown('Video', node.attrs?.title, node.attrs?.src),\n  addCommands() {\n    return {\n      insertVideo: attrs => ({ commands }) => commands.insertContent({ type: this.name, attrs }),\n    }\n  },\n})\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    file: {\n      /** Inserts a file block (download link, PDF preview) at the selection. */\n      insertFile: (attrs: FileAttrs) => ReturnType\n    }\n  }\n}\n\n/** Attributes of a file block; `title` is the editable file name, `size` the byte count. */\nexport interface FileAttrs {\n  src: string\n  title?: string\n  mimeType?: string\n  size?: number\n}\n\n/** A generic uploaded file (PDF, office document, …) that has no player: shown as a card with an open button. */\nexport const FileNode = Node.create({\n  name: 'file',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => ({\n    src: { default: '', parseHTML: el => el.getAttribute('href') ?? '' },\n    title: { default: '', parseHTML: el => el.getAttribute('download') ?? '' },\n    mimeType: { default: '', parseHTML: el => el.getAttribute('data-mime') ?? '' },\n    size: { default: 0, parseHTML: el => Number(el.getAttribute('data-size')) || 0 },\n  }),\n  parseHTML: () => [{ tag: 'a[data-type=\"file\"]' }],\n  renderHTML: ({ node }) => ['a', {\n    'data-type': 'file',\n    'href': node.attrs.src,\n    'download': node.attrs.title,\n    'data-mime': node.attrs.mimeType,\n    'data-size': String(node.attrs.size),\n  }, node.attrs.title || 'Datei'],\n  renderMarkdown: node => `[Datei: ${String(node.attrs?.title || 'Datei').replace(/[[\\]\\\\]/g, '\\\\$&')}](${String(node.attrs?.src ?? '')})`,\n  addCommands() {\n    return {\n      insertFile: attrs => ({ commands }) => commands.insertContent({ type: this.name, attrs }),\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/media/schema.ts"],"sourcesContent":["import { type Attributes, type AnyExtension, type MarkdownToken, type MarkdownTokenizer, mergeAttributes, Node } from '@tiptap/core'\nimport { Image } from '@tiptap/extension-image'\nimport { TEXT_ABILITIES } from '../../core/schema'\n\nexport * from './assets'\n\n// Vue-free and server-importable (`@ecsplico/editor/media/schema`): the upload API validates against these types, the\n// schema has the nodes. The client adds the node views in node-views.ts.\n\n/** SHA-256 (hex) of the uploaded bytes, kept on media blocks so derived content can tell when its source changed; null when unknown (memory backend, older documents). */\nconst hashAttribute: Attributes[string] = {\n  default: null,\n  parseHTML: el => el.getAttribute('data-hash'),\n  renderHTML: attrs => (attrs.hash ? { 'data-hash': attrs.hash } : {}),\n}\n\n/** The media nodes (image, audio, video, file) of the document schema. */\nexport const mediaSchemaExtensions = (): AnyExtension[] => [ImageNode, AudioNode, VideoNode, FileNode]\n\n/**\n * The image node with a `hash` attribute. Markdown: `![alt](src \"title\")`, followed by ` <!-- {\"hash\":\"…\"} -->` when the\n * block has a hash; only that form is claimed by `imageBlockTokenizer` (a block-level token that still yields an `image`\n * token), a plain image keeps the stock inline parse.\n */\nexport const ImageNode = Image.extend({\n  addAttributes() {\n    return { ...this.parent?.(), hash: hashAttribute }\n  },\n  markdownTokenizer: {\n    name: 'imageBlock',\n    level: 'block',\n    start: src => src.search(new RegExp(IMAGE_BLOCK_PATTERN, 'm')),\n    tokenize: (src) => {\n      const match = new RegExp(IMAGE_BLOCK_PATTERN).exec(src)\n      if (!match) return undefined\n      return { type: 'image', raw: match[0], text: match[1] ?? '', href: match[2] ?? '', title: match[3], attrs: parseAttrComment(match[4]) }\n    },\n  },\n  parseMarkdown: (token, helpers) => helpers.createNode('image', {\n    src: token.href,\n    title: token.title,\n    alt: token.text,\n    hash: typeof token.attrs?.hash === 'string' ? token.attrs.hash : null,\n  }),\n  renderMarkdown: (node) => {\n    const { src = '', alt = '', title = '' } = node.attrs ?? {}\n    return `![${alt}](${src}${title ? ` \"${title}\"` : ''})${attrComment({ hash: node.attrs?.hash })}`\n  },\n})\n\n// Markdown form of the text-less media blocks. Audio, video and file are a paragraph of nothing but a link\n// (`[Audio: name](url)`), optionally followed by an HTML comment holding the attributes the link cannot carry\n// (`hash`, `mimeType`, `size`) as JSON, the way composite fences hold their meta. The block-level tokenizers below parse\n// that line back into the node; labels of every UI language are accepted, the export always writes the German one.\nconst ATTR_COMMENT_PATTERN = '(?: <!-- (\\\\{.*?\\\\}) -->)?[ \\\\t]*(?:\\\\n|$)'\nconst IMAGE_BLOCK_PATTERN = `^!\\\\[([^\\\\]\\\\n]*)\\\\]\\\\(([^)\\\\s]*)(?: \"([^\"\\\\n]*)\")?\\\\) <!-- (\\\\{.*?\\\\}) -->[ \\\\t]*(?:\\\\n|$)`\n\n/** ` <!-- {\"hash\":\"…\"} -->` for the attributes that are set (empty string when none); `>` is escaped so the JSON cannot end the comment. */\nfunction attrComment(attrs: Record<string, unknown>): string {\n  const set = Object.fromEntries(Object.entries(attrs).filter(([, value]) => value !== null && value !== undefined && value !== '' && value !== 0))\n  return Object.keys(set).length ? ` <!-- ${JSON.stringify(set).replace(/>/g, '\\\\u003e')} -->` : ''\n}\n\n/** The attributes of an `attrComment`; empty for a missing or malformed one. */\nfunction parseAttrComment(json: string | undefined): Record<string, unknown> {\n  if (!json) return {}\n  try {\n    const value: unknown = JSON.parse(json)\n    return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}\n  }\n  catch {\n    return {}\n  }\n}\n\n/** Block tokenizer for `[<label>: title](src)` lines of one media node; `labels` are the accepted labels (regex alternatives). */\nfunction mediaTokenizer(name: string, labels: string): MarkdownTokenizer {\n  const pattern = `^\\\\[(?:${labels})(?:: ((?:\\\\\\\\.|[^\\\\]\\\\\\\\\\\\n])*))?\\\\]\\\\(([^)\\\\s]*)\\\\)${ATTR_COMMENT_PATTERN}`\n  return {\n    name,\n    level: 'block',\n    start: src => src.search(new RegExp(pattern, 'm')),\n    tokenize: (src) => {\n      const match = new RegExp(pattern).exec(src)\n      if (!match) return undefined\n      return { type: name, raw: match[0], title: (match[1] ?? '').replace(/\\\\(.)/g, '$1'), href: match[2] ?? '', attrs: parseAttrComment(match[3]) }\n    },\n  }\n}\n\nconst stringAttr = (value: unknown): string => typeof value === 'string' ? value : ''\n\nexport type MediaKind = 'image' | 'audio' | 'video' | 'file'\n\n/** Uploadable MIME types → file extension on disk and media kind. `<uuid>.<ext>` asset names derive from this. */\nexport const MEDIA_TYPES: Readonly<Record<string, { ext: string, kind: MediaKind }>> = {\n  'image/png': { ext: 'png', kind: 'image' },\n  'image/jpeg': { ext: 'jpg', kind: 'image' },\n  'image/gif': { ext: 'gif', kind: 'image' },\n  'image/webp': { ext: 'webp', kind: 'image' },\n  'audio/webm': { ext: 'weba', kind: 'audio' },\n  'audio/mp4': { ext: 'm4a', kind: 'audio' },\n  // What Chrome on macOS reports for `.m4a` files picked from disk.\n  'audio/x-m4a': { ext: 'm4a', kind: 'audio' },\n  'audio/mpeg': { ext: 'mp3', kind: 'audio' },\n  'audio/wav': { ext: 'wav', kind: 'audio' },\n  'audio/x-wav': { ext: 'wav', kind: 'audio' },\n  'audio/ogg': { ext: 'ogg', kind: 'audio' },\n  'video/mp4': { ext: 'mp4', kind: 'video' },\n  'video/webm': { ext: 'webm', kind: 'video' },\n  'video/quicktime': { ext: 'mov', kind: 'video' },\n}\n\n/** Upload size limit per kind. */\nexport const MAX_MEDIA_BYTES: Readonly<Record<MediaKind, number>> = {\n  image: 5 * 1024 * 1024,\n  audio: 50 * 1024 * 1024,\n  video: 200 * 1024 * 1024,\n  // Generic files (PDF, office documents, …): anything the media kinds do not cover.\n  file: 50 * 1024 * 1024,\n}\n\n/** `type` without parameters, lowercased (`audio/webm;codecs=opus` → `audio/webm`): the key into `MEDIA_TYPES`. */\nexport const mediaMime = (type: string): string => (type.split(';')[0] ?? '').trim().toLowerCase()\n\n/** Kind of an uploadable MIME type (parameters such as `;codecs=…` ignored); null when uploads do not accept it. */\nexport function mediaKindOf(mime: string): MediaKind | null {\n  return MEDIA_TYPES[mediaMime(mime)]?.kind ?? null\n}\n\n/** `accept` value of a file input for one kind: its MIME types, comma-joined. */\nexport function acceptFor(kind: MediaKind): string {\n  return Object.keys(MEDIA_TYPES).filter(mime => MEDIA_TYPES[mime]?.kind === kind).join(',')\n}\n\n/** Attributes of an audio/video node; `title` is the editable caption, `mimeType` the uploaded file's base type. */\nexport interface MediaAttrs {\n  src: string\n  title?: string\n  mimeType?: string\n  hash?: string | null\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    audio: {\n      /** Inserts an audio block at the selection. */\n      insertAudio: (attrs: MediaAttrs) => ReturnType\n    }\n    video: {\n      /** Inserts a video block at the selection. */\n      insertVideo: (attrs: MediaAttrs) => ReturnType\n    }\n  }\n}\n\nconst mediaAttributes: Attributes = {\n  src: { default: '' },\n  title: {\n    default: '',\n    parseHTML: el => el.getAttribute('data-title') ?? '',\n    renderHTML: attrs => ({ 'data-title': attrs.title }),\n  },\n  mimeType: {\n    default: '',\n    parseHTML: el => el.getAttribute('data-mime') ?? '',\n    renderHTML: attrs => ({ 'data-mime': attrs.mimeType }),\n  },\n  hash: hashAttribute,\n}\n\n/** Markdown export (AI context, `getMarkdown()`, source mode): a link labelled with the kind and, when there is one, the title; `extra` and the hash go into the trailing attribute comment. */\nfunction mediaMarkdown(label: string, attrs: Record<string, unknown> | undefined, extra: Record<string, unknown>): string {\n  const title = attrs?.title\n  const text = title ? `${label}: ${String(title).replace(/[[\\]\\\\]/g, '\\\\$&')}` : label\n  return `[${text}](${String(attrs?.src ?? '')})${attrComment({ ...extra, hash: attrs?.hash })}`\n}\n\n/** Node attributes of an audio/video Markdown token. */\nfunction mediaAttrsOfToken(token: MarkdownToken) {\n  return { src: token.href, title: token.title, mimeType: stringAttr(token.attrs?.mimeType), hash: stringAttr(token.attrs?.hash) || null }\n}\n\nexport const AudioNode = Node.create({\n  name: 'audio',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  // A player block holds no text: nothing text-related applies inside it.\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => mediaAttributes,\n  parseHTML: () => [{ tag: 'audio[src]' }],\n  renderHTML: ({ HTMLAttributes }) => ['audio', mergeAttributes(HTMLAttributes, { controls: 'true', preload: 'metadata' })],\n  markdownTokenizer: mediaTokenizer('audio', 'Audio'),\n  parseMarkdown: (token, helpers) => helpers.createNode('audio', mediaAttrsOfToken(token)),\n  renderMarkdown: node => mediaMarkdown('Audio', node.attrs, { mimeType: node.attrs?.mimeType }),\n  addCommands() {\n    return {\n      insertAudio: attrs => ({ commands }) => commands.insertContent({ type: this.name, attrs }),\n    }\n  },\n})\n\nexport const VideoNode = Node.create({\n  name: 'video',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => mediaAttributes,\n  parseHTML: () => [{ tag: 'video[src]' }],\n  renderHTML: ({ HTMLAttributes }) => ['video', mergeAttributes(HTMLAttributes, { controls: 'true', preload: 'metadata' })],\n  markdownTokenizer: mediaTokenizer('video', 'Video'),\n  parseMarkdown: (token, helpers) => helpers.createNode('video', mediaAttrsOfToken(token)),\n  renderMarkdown: node => mediaMarkdown('Video', node.attrs, { mimeType: node.attrs?.mimeType }),\n  addCommands() {\n    return {\n      insertVideo: attrs => ({ commands }) => commands.insertContent({ type: this.name, attrs }),\n    }\n  },\n})\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    file: {\n      /** Inserts a file block (download link, PDF preview) at the selection. */\n      insertFile: (attrs: FileAttrs) => ReturnType\n    }\n  }\n}\n\n/** Attributes of a file block; `title` is the editable file name, `size` the byte count. */\nexport interface FileAttrs {\n  src: string\n  title?: string\n  mimeType?: string\n  size?: number\n  hash?: string | null\n}\n\n/** A generic uploaded file (PDF, office document, …) that has no player: shown as a card with an open button. */\nexport const FileNode = Node.create({\n  name: 'file',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => ({\n    src: { default: '', parseHTML: el => el.getAttribute('href') ?? '' },\n    title: { default: '', parseHTML: el => el.getAttribute('download') ?? '' },\n    mimeType: { default: '', parseHTML: el => el.getAttribute('data-mime') ?? '' },\n    size: { default: 0, parseHTML: el => Number(el.getAttribute('data-size')) || 0 },\n    hash: hashAttribute,\n  }),\n  parseHTML: () => [{ tag: 'a[data-type=\"file\"]' }],\n  renderHTML: ({ node }) => ['a', {\n    'data-type': 'file',\n    'href': node.attrs.src,\n    'download': node.attrs.title,\n    'data-mime': node.attrs.mimeType,\n    'data-size': String(node.attrs.size),\n    ...(node.attrs.hash ? { 'data-hash': node.attrs.hash } : {}),\n  }, node.attrs.title || 'Datei'],\n  markdownTokenizer: mediaTokenizer('file', 'Datei|File'),\n  parseMarkdown: (token, helpers) => helpers.createNode('file', {\n    src: token.href,\n    title: token.title,\n    mimeType: stringAttr(token.attrs?.mimeType),\n    size: typeof token.attrs?.size === 'number' ? token.attrs.size : 0,\n    hash: stringAttr(token.attrs?.hash) || null,\n  }),\n  renderMarkdown: node => mediaMarkdown('Datei', node.attrs, { mimeType: node.attrs?.mimeType, size: node.attrs?.size }),\n  addCommands() {\n    return {\n      insertFile: attrs => ({ commands }) => commands.insertContent({ type: this.name, attrs }),\n    }\n  },\n})\n"],"mappings":"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"}

package/dist/features/media/upload.d.ts

@@ -1,35 +1,36 @@
-import { FeatureContext, UploadFn } from "../../core/feature.js";
+import { FeatureContext } from "../../core/feature.js";
 import "../../core/index.js";
 import { Editor, Extension, JSONContent } from "@tiptap/core";
 //#region src/features/media/upload.d.ts
-/** `importFiles` of the media feature: imports `files` at `pos` (default: the selection), toasting failures; resolves whether every file was imported. */
-export type ImportFilesFn = (editor: Editor, files: File[] | FileList, pos?: number) => Promise<boolean>;
-/** Default upload: POSTs `file` to the asset endpoint of document `documentId` through the context's HTTP client (size limits per kind, see schema.ts). */
-export declare function postUpload(fetch: FeatureContext['fetch'], documentId: string, file: File): Promise<{
+/** Stores a file and resolves with the URL it is addressed by. */
+type UploadFile = (file: File) => Promise<{
   url: string;
+  sha256?: string;
 }>;
-/** The upload of a surface: the host's `upload` prop, else the asset endpoint of its `documentId` (default: the shared `scratch` owner). */
-export declare const uploadOf: (ctx: FeatureContext) => UploadFn;
+/** `importFiles` of the media feature: imports `files` at `pos` (default: the selection), toasting failures; resolves whether every file was imported. */
+export type ImportFilesFn = (editor: Editor, files: File[] | FileList, pos?: number) => Promise<boolean>;
+/** 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). */
+export declare const uploadOf: (ctx: FeatureContext) => UploadFile;
 /** Makes the upload and the file import reachable as `editor.storage.media` (drop/paste, toolbar, slash menu, recorder). */
 export declare const Media: Extension<{
-  upload: UploadFn;
+  upload: UploadFile;
   importFiles: ImportFilesFn;
 }, {
-  upload: UploadFn;
+  upload: UploadFile;
   importFiles: ImportFilesFn;
 }>;
 declare module '@tiptap/core' {
   interface Storage {
     media: {
-      upload: UploadFn;
+      upload: UploadFile;
       importFiles: ImportFilesFn;
     };
   }
 }
-/** The node that embeds uploaded `file` from `url`; null for files uploads do not accept. */
-export declare function mediaNodeFor(file: File, url: string): JSONContent | null;
-/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …). */
-export declare function fileNodeFor(file: File, url: string): JSONContent;
+/** 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. */
+export declare function mediaNodeFor(file: File, url: string, hash?: string): JSONContent | null;
+/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …); `hash` as in `mediaNodeFor`. */
+export declare function fileNodeFor(file: File, url: string, hash?: string): JSONContent;
 /** Human-readable byte count: 1024-based, one decimal (`1536` → `1.5 KB`), units B/KB/MB/GB. */
 export declare function formatBytes(bytes: number): string;
 /** Transaction meta the recorder modal (AudioRecorderModal) listens for: open it, inserting at the current caret. */
@@ -38,4 +39,5 @@ export declare function openAudioRecorder(editor: Editor): void;
 /** Opens the browser's file picker; resolves the chosen files, `[]` when the picker is cancelled. */
 export declare function pickFiles(accept: string, multiple?: boolean): Promise<File[]>;
 //#endregion
+export {};
 //# sourceMappingURL=upload.d.ts.map

package/dist/features/media/upload.js

@@ -2,17 +2,8 @@ import "./assets.js";
 import { mediaKindOf, mediaMime } from "./schema.js";
 import { Extension } from "@tiptap/core";
 //#region src/features/media/upload.ts
-/** Default upload: POSTs `file` to the asset endpoint of document `documentId` through the context's HTTP client (size limits per kind, see schema.ts). */
-async function postUpload(fetch, documentId, file) {
-	const body = new FormData();
-	body.append("file", file);
-	return await fetch(`/api/editor/assets/${documentId}`, {
-		method: "POST",
-		body
-	});
-}
-/** The upload of a surface: the host's `upload` prop, else the asset endpoint of its `documentId` (default: the shared `scratch` owner). */
-const uploadOf = (ctx) => ctx.upload ?? ((file) => postUpload(ctx.fetch, ctx.documentId ?? "scratch", file));
+/** 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). */
+const uploadOf = (ctx) => (file) => ctx.backend.assets ? ctx.backend.assets.upload(ctx.documentId ?? "scratch", file) : Promise.reject(/* @__PURE__ */ new Error(`@ecsplico/editor: backend "${ctx.backend.name}" has no assets capability`));
 /** Makes the upload and the file import reachable as `editor.storage.media` (drop/paste, toolbar, slash menu, recorder). */
 const Media = Extension.create({
 	name: "media",
@@ -29,15 +20,16 @@ const Media = Extension.create({
 		};
 	}
 });
-/** The node that embeds uploaded `file` from `url`; null for files uploads do not accept. */
-function mediaNodeFor(file, url) {
+/** 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. */
+function mediaNodeFor(file, url, hash) {
 	const kind = mediaKindOf(file.type);
 	if (!kind) return null;
 	if (kind === "image") return {
 		type: "image",
 		attrs: {
 			src: url,
-			alt: file.name
+			alt: file.name,
+			hash: hash ?? null
 		}
 	};
 	return {
@@ -45,19 +37,21 @@ function mediaNodeFor(file, url) {
 		attrs: {
 			src: url,
 			title: file.name,
-			mimeType: mediaMime(file.type)
+			mimeType: mediaMime(file.type),
+			hash: hash ?? null
 		}
 	};
 }
-/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …). */
-function fileNodeFor(file, url) {
+/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …); `hash` as in `mediaNodeFor`. */
+function fileNodeFor(file, url, hash) {
 	return {
 		type: "file",
 		attrs: {
 			src: url,
 			title: file.name,
 			mimeType: mediaMime(file.type) || "application/octet-stream",
-			size: file.size
+			size: file.size,
+			hash: hash ?? null
 		}
 	};
 }
@@ -101,6 +95,6 @@ function pickFiles(accept, multiple = true) {
 	return promise;
 }
 //#endregion
-export { AUDIO_RECORDER_OPEN, Media, fileNodeFor, formatBytes, mediaNodeFor, openAudioRecorder, pickFiles, postUpload, uploadOf };
+export { AUDIO_RECORDER_OPEN, Media, fileNodeFor, formatBytes, mediaNodeFor, openAudioRecorder, pickFiles, uploadOf };
 
 //# sourceMappingURL=upload.js.map

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>;