@ecsplico/editor 0.0.0-stage → 1.0.0

package/dist/features/media/schema.js

@@ -0,0 +1,194 @@
+import { TEXT_ABILITIES } from "../../core/schema/abilities.js";
+import { ASSET_DOCUMENT_ID, ASSET_NAME, SCRATCH_DOCUMENT_ID, assetRefOf, assetUrl } from "./assets.js";
+import { Node, mergeAttributes } from "@tiptap/core";
+import { Image } from "@tiptap/extension-image";
+//#region src/features/media/schema.ts
+/** The media nodes (image, audio, video, file) of the document schema. */
+const mediaSchemaExtensions = () => [
+	Image,
+	AudioNode,
+	VideoNode,
+	FileNode
+];
+/** Uploadable MIME types → file extension on disk and media kind. `<uuid>.<ext>` asset names derive from this. */
+const MEDIA_TYPES = {
+	"image/png": {
+		ext: "png",
+		kind: "image"
+	},
+	"image/jpeg": {
+		ext: "jpg",
+		kind: "image"
+	},
+	"image/gif": {
+		ext: "gif",
+		kind: "image"
+	},
+	"image/webp": {
+		ext: "webp",
+		kind: "image"
+	},
+	"audio/webm": {
+		ext: "weba",
+		kind: "audio"
+	},
+	"audio/mp4": {
+		ext: "m4a",
+		kind: "audio"
+	},
+	"audio/x-m4a": {
+		ext: "m4a",
+		kind: "audio"
+	},
+	"audio/mpeg": {
+		ext: "mp3",
+		kind: "audio"
+	},
+	"audio/wav": {
+		ext: "wav",
+		kind: "audio"
+	},
+	"audio/x-wav": {
+		ext: "wav",
+		kind: "audio"
+	},
+	"audio/ogg": {
+		ext: "ogg",
+		kind: "audio"
+	},
+	"video/mp4": {
+		ext: "mp4",
+		kind: "video"
+	},
+	"video/webm": {
+		ext: "webm",
+		kind: "video"
+	},
+	"video/quicktime": {
+		ext: "mov",
+		kind: "video"
+	}
+};
+/** Upload size limit per kind. */
+const MAX_MEDIA_BYTES = {
+	image: 5242880,
+	audio: 52428800,
+	video: 209715200,
+	file: 52428800
+};
+/** `type` without parameters, lowercased (`audio/webm;codecs=opus` → `audio/webm`): the key into `MEDIA_TYPES`. */
+const mediaMime = (type) => (type.split(";")[0] ?? "").trim().toLowerCase();
+/** Kind of an uploadable MIME type (parameters such as `;codecs=…` ignored); null when uploads do not accept it. */
+function mediaKindOf(mime) {
+	return MEDIA_TYPES[mediaMime(mime)]?.kind ?? null;
+}
+/** `accept` value of a file input for one kind: its MIME types, comma-joined. */
+function acceptFor(kind) {
+	return Object.keys(MEDIA_TYPES).filter((mime) => MEDIA_TYPES[mime]?.kind === kind).join(",");
+}
+const mediaAttributes = {
+	src: { default: "" },
+	title: {
+		default: "",
+		parseHTML: (el) => el.getAttribute("data-title") ?? "",
+		renderHTML: (attrs) => ({ "data-title": attrs.title })
+	},
+	mimeType: {
+		default: "",
+		parseHTML: (el) => el.getAttribute("data-mime") ?? "",
+		renderHTML: (attrs) => ({ "data-mime": attrs.mimeType })
+	}
+};
+/** Markdown export (AI context, `getMarkdown()`): a link labelled with the kind and, when there is one, the title. */
+function mediaMarkdown(label, title, src) {
+	return `[${title ? `${label}: ${String(title).replace(/[[\]\\]/g, "\\$&")}` : label}](${String(src ?? "")})`;
+}
+const AudioNode = Node.create({
+	name: "audio",
+	group: "block",
+	atom: true,
+	draggable: true,
+	abilities: { revokes: TEXT_ABILITIES },
+	addAttributes: () => mediaAttributes,
+	parseHTML: () => [{ tag: "audio[src]" }],
+	renderHTML: ({ HTMLAttributes }) => ["audio", mergeAttributes(HTMLAttributes, {
+		controls: "true",
+		preload: "metadata"
+	})],
+	renderMarkdown: (node) => mediaMarkdown("Audio", node.attrs?.title || "Aufnahme", node.attrs?.src),
+	addCommands() {
+		return { insertAudio: (attrs) => ({ commands }) => commands.insertContent({
+			type: this.name,
+			attrs
+		}) };
+	}
+});
+const VideoNode = Node.create({
+	name: "video",
+	group: "block",
+	atom: true,
+	draggable: true,
+	abilities: { revokes: TEXT_ABILITIES },
+	addAttributes: () => mediaAttributes,
+	parseHTML: () => [{ tag: "video[src]" }],
+	renderHTML: ({ HTMLAttributes }) => ["video", mergeAttributes(HTMLAttributes, {
+		controls: "true",
+		preload: "metadata"
+	})],
+	renderMarkdown: (node) => mediaMarkdown("Video", node.attrs?.title, node.attrs?.src),
+	addCommands() {
+		return { insertVideo: (attrs) => ({ commands }) => commands.insertContent({
+			type: this.name,
+			attrs
+		}) };
+	}
+});
+/** A generic uploaded file (PDF, office document, …) that has no player: shown as a card with an open button. */
+const FileNode = Node.create({
+	name: "file",
+	group: "block",
+	atom: true,
+	draggable: true,
+	abilities: { revokes: TEXT_ABILITIES },
+	addAttributes: () => ({
+		src: {
+			default: "",
+			parseHTML: (el) => el.getAttribute("href") ?? ""
+		},
+		title: {
+			default: "",
+			parseHTML: (el) => el.getAttribute("download") ?? ""
+		},
+		mimeType: {
+			default: "",
+			parseHTML: (el) => el.getAttribute("data-mime") ?? ""
+		},
+		size: {
+			default: 0,
+			parseHTML: (el) => Number(el.getAttribute("data-size")) || 0
+		}
+	}),
+	parseHTML: () => [{ tag: "a[data-type=\"file\"]" }],
+	renderHTML: ({ node }) => [
+		"a",
+		{
+			"data-type": "file",
+			"href": node.attrs.src,
+			"download": node.attrs.title,
+			"data-mime": node.attrs.mimeType,
+			"data-size": String(node.attrs.size)
+		},
+		node.attrs.title || "Datei"
+	],
+	renderMarkdown: (node) => `[Datei: ${String(node.attrs?.title || "Datei").replace(/[[\]\\]/g, "\\$&")}](${String(node.attrs?.src ?? "")})`,
+	addCommands() {
+		return { insertFile: (attrs) => ({ commands }) => commands.insertContent({
+			type: this.name,
+			attrs
+		}) };
+	}
+});
+//#endregion
+export { ASSET_DOCUMENT_ID, ASSET_NAME, AudioNode, FileNode, MAX_MEDIA_BYTES, MEDIA_TYPES, SCRATCH_DOCUMENT_ID, VideoNode, acceptFor, assetRefOf, assetUrl, mediaKindOf, mediaMime, mediaSchemaExtensions };
+
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,41 @@
+import { FeatureContext, UploadFn } 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<{
+  url: 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;
+/** 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;
+  importFiles: ImportFilesFn;
+}, {
+  upload: UploadFn;
+  importFiles: ImportFilesFn;
+}>;
+declare module '@tiptap/core' {
+  interface Storage {
+    media: {
+      upload: UploadFn;
+      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;
+/** 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. */
+export declare const AUDIO_RECORDER_OPEN = "audioRecorderOpen";
+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
+//# sourceMappingURL=upload.d.ts.map

package/dist/features/media/upload.js

@@ -0,0 +1,106 @@
+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));
+/** Makes the upload and the file import reachable as `editor.storage.media` (drop/paste, toolbar, slash menu, recorder). */
+const Media = Extension.create({
+	name: "media",
+	addOptions() {
+		return {
+			upload: () => Promise.reject(/* @__PURE__ */ new Error("@ecsplico/editor: Media.configure({ upload }) fehlt")),
+			importFiles: () => Promise.reject(/* @__PURE__ */ new Error("@ecsplico/editor: Media.configure({ importFiles }) fehlt"))
+		};
+	},
+	addStorage() {
+		return {
+			upload: this.options.upload,
+			importFiles: this.options.importFiles
+		};
+	}
+});
+/** The node that embeds uploaded `file` from `url`; null for files uploads do not accept. */
+function mediaNodeFor(file, url) {
+	const kind = mediaKindOf(file.type);
+	if (!kind) return null;
+	if (kind === "image") return {
+		type: "image",
+		attrs: {
+			src: url,
+			alt: file.name
+		}
+	};
+	return {
+		type: kind,
+		attrs: {
+			src: url,
+			title: file.name,
+			mimeType: mediaMime(file.type)
+		}
+	};
+}
+/** The file block for an uploaded `file` that has no player or image node (PDF, office documents, …). */
+function fileNodeFor(file, url) {
+	return {
+		type: "file",
+		attrs: {
+			src: url,
+			title: file.name,
+			mimeType: mediaMime(file.type) || "application/octet-stream",
+			size: file.size
+		}
+	};
+}
+/** Human-readable byte count: 1024-based, one decimal (`1536` → `1.5 KB`), units B/KB/MB/GB. */
+function formatBytes(bytes) {
+	const units = [
+		"B",
+		"KB",
+		"MB",
+		"GB"
+	];
+	let value = Math.max(0, bytes);
+	let unit = 0;
+	while (value >= 1024 && unit < units.length - 1) {
+		value /= 1024;
+		unit++;
+	}
+	return unit === 0 ? `${value} B` : `${value.toFixed(1)} ${units[unit]}`;
+}
+/** Transaction meta the recorder modal (AudioRecorderModal) listens for: open it, inserting at the current caret. */
+const AUDIO_RECORDER_OPEN = "audioRecorderOpen";
+function openAudioRecorder(editor) {
+	editor.view.dispatch(editor.state.tr.setMeta(AUDIO_RECORDER_OPEN, true).setMeta("addToHistory", false));
+}
+/** Opens the browser's file picker; resolves the chosen files, `[]` when the picker is cancelled. */
+function pickFiles(accept, multiple = true) {
+	const { promise, resolve } = Promise.withResolvers();
+	const input = document.createElement("input");
+	input.type = "file";
+	input.accept = accept;
+	input.multiple = multiple;
+	input.hidden = true;
+	document.body.append(input);
+	const done = (files) => {
+		input.remove();
+		resolve(files);
+	};
+	input.addEventListener("change", () => done(Array.from(input.files ?? [])), { once: true });
+	input.addEventListener("cancel", () => done([]), { once: true });
+	input.click();
+	return promise;
+}
+//#endregion
+export { AUDIO_RECORDER_OPEN, Media, fileNodeFor, formatBytes, mediaNodeFor, openAudioRecorder, pickFiles, postUpload, uploadOf };
+
+//# sourceMappingURL=upload.js.map

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

@@ -0,0 +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"}

package/dist/features/media/use-audio-recorder.d.ts

@@ -0,0 +1,12 @@
+import { AudioRecorder, AudioRecorderStatus } from "./audio-recorder.js";
+import { Ref } from "vue";
+//#region src/features/media/use-audio-recorder.d.ts
+export interface VueAudioRecorder extends Pick<AudioRecorder, 'start' | 'stop' | 'cancel'> {
+  state: Readonly<Ref<AudioRecorderStatus>>;
+  /** Whole seconds recorded so far. */
+  seconds: Readonly<Ref<number>>;
+}
+/** The audio recorder model (`createAudioRecorder`) as refs; released when the calling scope ends. */
+export declare function useAudioRecorder(): VueAudioRecorder;
+//#endregion
+//# sourceMappingURL=use-audio-recorder.d.ts.map

package/dist/features/media/use-audio-recorder.js

@@ -0,0 +1,21 @@
+import { createAudioRecorder } from "./audio-recorder.js";
+import { useStoreRef } from "../../vue/store-ref.js";
+import { computed, onScopeDispose } from "vue";
+//#region src/features/media/use-audio-recorder.ts
+/** The audio recorder model (`createAudioRecorder`) as refs; released when the calling scope ends. */
+function useAudioRecorder() {
+	const recorder = createAudioRecorder();
+	const snapshot = useStoreRef(recorder.state);
+	onScopeDispose(recorder.dispose);
+	return {
+		state: computed(() => snapshot.value.status),
+		seconds: computed(() => snapshot.value.seconds),
+		start: recorder.start,
+		stop: recorder.stop,
+		cancel: recorder.cancel
+	};
+}
+//#endregion
+export { useAudioRecorder };
+
+//# sourceMappingURL=use-audio-recorder.js.map

package/dist/features/media/use-audio-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-audio-recorder.js","names":[],"sources":["../../../src/features/media/use-audio-recorder.ts"],"sourcesContent":["import { computed, onScopeDispose, type Ref } from 'vue'\nimport { useStoreRef } from '../../vue/store-ref'\nimport { type AudioRecorder, type AudioRecorderStatus, createAudioRecorder } from './audio-recorder'\n\nexport interface VueAudioRecorder extends Pick<AudioRecorder, 'start' | 'stop' | 'cancel'> {\n  state: Readonly<Ref<AudioRecorderStatus>>\n  /** Whole seconds recorded so far. */\n  seconds: Readonly<Ref<number>>\n}\n\n/** The audio recorder model (`createAudioRecorder`) as refs; released when the calling scope ends. */\nexport function useAudioRecorder(): VueAudioRecorder {\n  const recorder = createAudioRecorder()\n  const snapshot = useStoreRef(recorder.state)\n  onScopeDispose(recorder.dispose)\n  return { state: computed(() => snapshot.value.status), seconds: computed(() => snapshot.value.seconds), start: recorder.start, stop: recorder.stop, cancel: recorder.cancel }\n}\n"],"mappings":";;;;;AAWA,SAAgB,mBAAqC;CACnD,MAAM,WAAW,oBAAoB;CACrC,MAAM,WAAW,YAAY,SAAS,KAAK;CAC3C,eAAe,SAAS,OAAO;CAC/B,OAAO;EAAE,OAAO,eAAe,SAAS,MAAM,MAAM;EAAG,SAAS,eAAe,SAAS,MAAM,OAAO;EAAG,OAAO,SAAS;EAAO,MAAM,SAAS;EAAM,QAAQ,SAAS;CAAO;AAC9K"}

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

@@ -0,0 +1,19 @@
+import { VueFeature } from "../../vue/index.js";
+import { ImportFilesFn } from "./upload.js";
+import _default from "./components/AudioRecorderModal.vue.js";
+import { VueAudioRecorder, useAudioRecorder } from "./use-audio-recorder.js";
+import { MaybeRefOrGetter } from "vue";
+import { Editor } from "@tiptap/core";
+//#region src/features/media/vue.d.ts
+/**
+ * `importFiles` with the failures sent to `editor`'s surface notifier, else the app's (see `fileImport`, `useNotifier`),
+ * for your own buttons. Call during component setup: the editor context is injected there.
+ */
+export declare function useFileImport(editor?: MaybeRefOrGetter<Editor | undefined>): {
+  importFiles: ImportFilesFn;
+};
+/** The Vue media feature: Vue node views for audio, video and file blocks and the Nuxt UI recorder modal. */
+export declare function mediaFeature(): VueFeature;
+//#endregion
+export { _default as AudioRecorderModal, type VueAudioRecorder, useAudioRecorder };
+//# sourceMappingURL=vue.d.ts.map

package/dist/features/media/vue.js

@@ -0,0 +1,35 @@
+import { useEditorI18n } from "../../vue/use-editor-i18n.js";
+import { fileImport } from "./file-import.js";
+import { playerOptions } from "./node-views.js";
+import { mediaFeatureCore } from "./feature.js";
+import { useNotifier } from "../../vue/use-notifier.js";
+import { useAudioRecorder } from "./use-audio-recorder.js";
+import _sfc_main from "./components/AudioRecorderModal.js";
+import _sfc_main$1 from "./components/AudioView.js";
+import _sfc_main$2 from "./components/FileView.js";
+import _sfc_main$3 from "./components/VideoView.js";
+import { VueNodeViewRenderer } from "@tiptap/vue-3";
+//#region src/features/media/vue.ts
+/**
+* `importFiles` with the failures sent to `editor`'s surface notifier, else the app's (see `fileImport`, `useNotifier`),
+* for your own buttons. Call during component setup: the editor context is injected there.
+*/
+function useFileImport(editor) {
+	const { t } = useEditorI18n();
+	return fileImport(useNotifier(editor), t);
+}
+/** The Vue media feature: Vue node views for audio, video and file blocks and the Nuxt UI recorder modal. */
+function mediaFeature() {
+	return mediaFeatureCore({
+		recorderModal: _sfc_main,
+		nodeViews: {
+			audio: VueNodeViewRenderer(_sfc_main$1, playerOptions),
+			video: VueNodeViewRenderer(_sfc_main$3, playerOptions),
+			file: VueNodeViewRenderer(_sfc_main$2, playerOptions)
+		}
+	});
+}
+//#endregion
+export { _sfc_main as AudioRecorderModal, mediaFeature, useAudioRecorder, useFileImport };
+
+//# sourceMappingURL=vue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","names":["AudioRecorderModal","AudioView","VideoView","FileView"],"sources":["../../../src/features/media/vue.ts"],"sourcesContent":["import { VueNodeViewRenderer } from '@tiptap/vue-3'\nimport type { Editor } from '@tiptap/core'\nimport type { Component, MaybeRefOrGetter } from 'vue'\nimport type { VueFeature } from '../../vue'\nimport { useEditorI18n } from '../../vue/use-editor-i18n'\nimport { useNotifier } from '../../vue/use-notifier'\nimport AudioRecorderModal from './components/AudioRecorderModal.vue'\nimport AudioView from './components/AudioView.vue'\nimport FileView from './components/FileView.vue'\nimport VideoView from './components/VideoView.vue'\nimport { mediaFeatureCore } from './feature'\nimport { fileImport } from './file-import'\nimport { playerOptions } from './node-views'\nimport type { ImportFilesFn } from './upload'\n\nexport { default as AudioRecorderModal } from './components/AudioRecorderModal.vue'\nexport { useAudioRecorder, type VueAudioRecorder } from './use-audio-recorder'\n\n/**\n * `importFiles` with the failures sent to `editor`'s surface notifier, else the app's (see `fileImport`, `useNotifier`),\n * for your own buttons. Call during component setup: the editor context is injected there.\n */\nexport function useFileImport(editor?: MaybeRefOrGetter<Editor | undefined>): { importFiles: ImportFilesFn } {\n  const { t } = useEditorI18n()\n  return fileImport(useNotifier(editor), t)\n}\n\n/** The Vue media feature: Vue node views for audio, video and file blocks and the Nuxt UI recorder modal. */\nexport function mediaFeature(): VueFeature {\n  return mediaFeatureCore<Component>({\n    recorderModal: AudioRecorderModal,\n    nodeViews: {\n      audio: VueNodeViewRenderer(AudioView, playerOptions),\n      video: VueNodeViewRenderer(VideoView, playerOptions),\n      file: VueNodeViewRenderer(FileView, playerOptions),\n    },\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,SAAgB,cAAc,QAA+E;CAC3G,MAAM,EAAE,MAAM,cAAc;CAC5B,OAAO,WAAW,YAAY,MAAM,GAAG,CAAC;AAC1C;;AAGA,SAAgB,eAA2B;CACzC,OAAO,iBAA4B;EACjC,eAAeA;EACf,WAAW;GACT,OAAO,oBAAoBC,aAAW,aAAa;GACnD,OAAO,oBAAoBC,aAAW,aAAa;GACnD,MAAM,oBAAoBC,aAAU,aAAa;EACnD;CACF,CAAC;AACH"}

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

@@ -0,0 +1,22 @@
+import { EditorFeature } from "../../core/feature.js";
+import "../../core/index.js";
+import { MentionAttrs, MentionNode, MentionUser } from "./mention.js";
+import { mentionSuggestion } from "./mention-suggestion.js";
+import { mentionsMetadata } from "./metadata-defaults.js";
+import { normalizeMentions } from "./normalize.js";
+import { TAG_NODE, TagAttrs, TagNode, TagOptions, TagSuggestionItem, TagSuggestionPluginKey, collectTagNames, normalizeTagName, tagsFromText } from "./tag.js";
+import { tagSuggestion } from "./tag-suggestion.js";
+import { MentionTarget, mentionUsersIn, mentionsFromText } from "./mention-text.js";
+import "./schema.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.
+ * 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.
+ */
+export declare function mentionsFeature(): EditorFeature<never>;
+//#endregion
+export { type MentionAttrs, MentionNode, type MentionTarget, type MentionUser, TAG_NODE, type TagAttrs, TagNode, type TagOptions, type TagSuggestionItem, TagSuggestionPluginKey, collectTagNames, mentionSuggestion, mentionUsersIn, mentionsFromText, mentionsMetadata, normalizeMentions, normalizeTagName, tagSuggestion, tagsFromText };
+//# sourceMappingURL=index.d.ts.map

package/dist/features/mentions/index.js

@@ -0,0 +1,34 @@
+import { metadataOf } from "../../core/metadata.js";
+import { mentionSuggestion } from "./mention-suggestion.js";
+import { TAG_NODE, TagNode, TagSuggestionPluginKey, collectTagNames, normalizeTagName, tagsFromText } from "./tag.js";
+import { mentionsMetadata } from "./metadata-defaults.js";
+import { MentionNode } from "./mention.js";
+import { mentionUsersIn, mentionsFromText } from "./mention-text.js";
+import { normalizeMentions } from "./normalize.js";
+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.
+* 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.
+*/
+function mentionsFeature() {
+	return {
+		id: "mentions",
+		extensions: (ctx) => [MentionNode.configure({ suggestion: mentionSuggestion(ctx.t) }), TagNode.configure({
+			suggestion: tagSuggestion(ctx.t),
+			onCreate: (editor, name) => metadataOf(editor).create("hashtags", {
+				id: name,
+				label: name
+			})
+		})],
+		metadataDefaults: (ctx) => mentionsMetadata(ctx),
+		blocks: { normalize: normalizeMentions }
+	};
+}
+//#endregion
+export { MentionNode, TAG_NODE, TagNode, TagSuggestionPluginKey, collectTagNames, mentionSuggestion, mentionUsersIn, mentionsFeature, mentionsFromText, mentionsMetadata, normalizeMentions, normalizeTagName, tagSuggestion, tagsFromText };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,11 @@
+import { Translate } from "../../i18n/index.js";
+import { MentionAttrs } from "./mention.js";
+import { MentionNodeAttrs, MentionOptions } from "@tiptap/extension-mention";
+//#region src/features/mentions/mention-suggestion.d.ts
+/**
+ * `@` trigger for MentionNode: people from the `mentions` metadata list, inserted as a chip with name and colour.
+ * `t` renders the popup texts in the app's language. Items are full chip attrs (incl. `color`); the command side keeps Mention's `MentionNodeAttrs` so it fits `MentionNode.configure()`.
+ */
+export declare const mentionSuggestion: (t: Translate) => MentionOptions<MentionAttrs, MentionNodeAttrs>["suggestion"];
+//#endregion
+//# sourceMappingURL=mention-suggestion.d.ts.map

package/dist/features/mentions/mention-suggestion.js

@@ -0,0 +1,34 @@
+import { ABILITY } from "../../core/schema/abilities.js";
+import { hasAbility } from "../../core/abilities.js";
+import { metadataOf } from "../../core/metadata.js";
+import { createSuggestionRender } from "../../core/suggestion-popup.js";
+//#region src/features/mentions/mention-suggestion.ts
+/**
+* `@` trigger for MentionNode: people from the `mentions` metadata list, inserted as a chip with name and colour.
+* `t` renders the popup texts in the app's language. Items are full chip attrs (incl. `color`); the command side keeps Mention's `MentionNodeAttrs` so it fits `MentionNode.configure()`.
+*/
+const mentionSuggestion = (t) => ({
+	char: "@",
+	allow: ({ editor }) => hasAbility(editor, ABILITY.mention),
+	items: async ({ query, editor, signal }) => (await metadataOf(editor).search("mentions", {
+		query,
+		editor,
+		signal
+	})).map((i) => ({
+		id: i.id,
+		label: i.label,
+		color: i.color ?? null
+	})),
+	render: createSuggestionRender({
+		display: (user) => ({
+			label: `@${user.label}`,
+			color: user.color ?? void 0
+		}),
+		emptyText: t("mentions.mention.empty"),
+		loadingText: t("common.loading")
+	})
+});
+//#endregion
+export { mentionSuggestion };
+
+//# sourceMappingURL=mention-suggestion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mention-suggestion.js","names":[],"sources":["../../../src/features/mentions/mention-suggestion.ts"],"sourcesContent":["import type { MentionNodeAttrs, MentionOptions } from '@tiptap/extension-mention'\nimport { createSuggestionRender, hasAbility, metadataOf } from '../../core'\nimport type { Translate } from '../../i18n'\nimport { ABILITY } from '../../core/schema'\nimport type { MentionAttrs } from './mention'\n\n/**\n * `@` trigger for MentionNode: people from the `mentions` metadata list, inserted as a chip with name and colour.\n * `t` renders the popup texts in the app's language. Items are full chip attrs (incl. `color`); the command side keeps Mention's `MentionNodeAttrs` so it fits `MentionNode.configure()`.\n */\nexport const mentionSuggestion = (t: Translate): MentionOptions<MentionAttrs, MentionNodeAttrs>['suggestion'] => ({\n  char: '@',\n  allow: ({ editor }) => hasAbility(editor, ABILITY.mention),\n  items: async ({ query, editor, signal }) =>\n    (await metadataOf(editor).search('mentions', { query, editor, signal })).map(i => ({ id: i.id, label: i.label, color: i.color ?? null })),\n  render: createSuggestionRender<MentionAttrs, MentionNodeAttrs>({\n    display: user => ({ label: `@${user.label}`, color: user.color ?? undefined }),\n    emptyText: t('mentions.mention.empty'),\n    loadingText: t('common.loading'),\n  }),\n})\n"],"mappings":";;;;;;;;;AAUA,MAAa,qBAAqB,OAAgF;CAChH,MAAM;CACN,QAAQ,EAAE,aAAa,WAAW,QAAQ,QAAQ,OAAO;CACzD,OAAO,OAAO,EAAE,OAAO,QAAQ,cAC5B,MAAM,WAAW,MAAM,CAAC,CAAC,OAAO,YAAY;EAAE;EAAO;EAAQ;CAAO,CAAC,EAAA,CAAG,KAAI,OAAM;EAAE,IAAI,EAAE;EAAI,OAAO,EAAE;EAAO,OAAO,EAAE,SAAS;CAAK,EAAE;CAC1I,QAAQ,uBAAuD;EAC7D,UAAS,UAAS;GAAE,OAAO,IAAI,KAAK;GAAS,OAAO,KAAK,SAAS,KAAA;EAAU;EAC5E,WAAW,EAAE,wBAAwB;EACrC,aAAa,EAAE,gBAAgB;CACjC,CAAC;AACH"}

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

@@ -0,0 +1,18 @@
+import { MentionUser } from "./mention.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). */
+export type MentionTarget = Pick<MentionUser, 'id' | 'username'> & {
+  color: string | null;
+};
+/**
+ * Turns `@username` tokens in text nodes into `mention` nodes (attrs id, label = username, color) — for
+ * AI-generated Markdown, whose parser only knows the `[@ …]` shortcode. Matches known users only,
+ * case-insensitively; unknown `@foo`, e-mail addresses and text in code blocks, inline code or links stay plain.
+ * Returns the input unchanged when nothing matched.
+ */
+export declare function mentionsFromText(json: JSONContent, users: readonly MentionTarget[]): JSONContent;
+/** Users of the mention chips inside a JSON tree, e.g. the range an AI result replaces (so echoed `@name`s stay chips). */
+export declare function mentionUsersIn(json: JSONContent | JSONContent[]): MentionTarget[];
+//#endregion
+//# sourceMappingURL=mention-text.d.ts.map