@comitor/ui 3.4.0 → 3.5.0

package/dist/editor/image-upload.d.ts

@@ -0,0 +1,57 @@
+import { Extension, Editor } from '@tiptap/core';
+
+/**
+ * Ảnh dán / kéo thả / chọn từ menu `/` → tải qua `onImageUpload` của app → chèn vào tài liệu.
+ *
+ * Gói KHÔNG biết kho ảnh ở đâu: bucket của module Comitor là riêng tư, URL hiện được là URL đã ký
+ * — nên đường tải là của app (route của app ký và ghi), gói chỉ trao `File` và nhận lại `src` để
+ * LƯU. Cùng nguyên tắc với `/uploader` (`XHRUpload` về endpoint của app).
+ *
+ * ── ẢNH ĐANG TẢI LÀ DECORATION, KHÔNG PHẢI NODE ────────────────────────────────────────────────
+ * Trong lúc tải, ảnh hiện NGAY bằng `blob:` của chính tệp — nhưng dưới dạng một widget decoration
+ * (khuôn "upload" của ProseMirror), không phải một node trong tài liệu. Node ảnh thật chỉ được chèn
+ * MỘT lần, khi app đã trả `src`.
+ *
+ * Bản đầu chèn một node ảnh TẠM rồi đổi `src` khi xong (giao dịch đổi không vào lịch sử). Nó qua
+ * mọi phép thử lúc gõ, và hỏng ở lịch sử hoàn tác: ⌘Z gỡ ảnh, rồi ⌘⇧Z làm lại ĐÚNG bước chèn node
+ * tạm — `src` là `blob:` đã thu hồi, cờ "đang tải" còn nguyên: một ảnh vỡ kẹt mãi, và vì cờ đó
+ * nên nó cũng không bao giờ vào markdown. Với decoration thì tài liệu không bao giờ chứa thứ gì tạm:
+ * lịch sử chỉ có một bước, "chèn ảnh thật".
+ */
+
+/** Thứ `onImageUpload` trả về: `src` để LƯU, hoặc kèm `alt`/`title`. */
+type MarkdownEditorImageUploadResult = string | {
+    src: string;
+    alt?: string;
+    title?: string;
+};
+interface ImageUploadHandlers {
+    upload?: (file: File) => Promise<MarkdownEditorImageUploadResult>;
+    onError: (error: unknown, file: File) => void;
+    /** Đổi `src` lưu → `src` hiện (`resolveImageSrc`), để tải trước ảnh thật trước khi chèn. */
+    resolveSrc?: (src: string) => string;
+    /** Nhãn trợ năng của ảnh đang tải (`role="img"` của widget). */
+    uploadingLabel: string;
+}
+/** Ảnh đang tải của MỘT trình soạn — `MarkdownEditorHandle.isUploading()` đọc nó. */
+type PendingUploads = Set<string>;
+/** Tệp ảnh trong một lần dán/thả. Tệp khác (PDF, zip…) bỏ qua: trình soạn chỉ nhúng ảnh. */
+declare function imageFilesFrom(data: DataTransfer | null): File[];
+/**
+ * Hiện widget cho từng tệp và tải chúng. Xong tệp nào thì gỡ widget và chèn node ảnh thật vào ĐÚNG
+ * chỗ widget đang đứng (vị trí đã đi theo mọi chỉnh sửa trong lúc chờ), trong CÙNG một giao dịch —
+ * một bước hoàn tác. Không dời con trỏ: người dùng có thể đang gõ ở chỗ khác.
+ */
+declare function insertImageFiles(editor: Editor, files: readonly File[], position: number | undefined, handlers: ImageUploadHandlers, pending: PendingUploads): void;
+/**
+ * Bắt ảnh khi DÁN và khi THẢ, và giữ các widget đang tải. Không có `onImageUpload` thì plugin đứng
+ * ngoài (trả `false`) — dán/thả đi đường mặc định của Tiptap, tức ảnh dạng tệp không được nhận
+ * (không có chỗ nào để lưu nó).
+ *
+ * Kéo thả NỘI BỘ (di chuyển một ảnh đã có trong tài liệu, `moved === true`) thì không đụng tới.
+ */
+declare function createImageUploadExtension(handlers: {
+    readonly current: ImageUploadHandlers;
+}, pending: PendingUploads): Extension;
+
+export { type ImageUploadHandlers, type MarkdownEditorImageUploadResult, type PendingUploads, createImageUploadExtension, imageFilesFrom, insertImageFiles };

package/dist/editor/image-upload.js

@@ -0,0 +1,136 @@
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Decoration, DecorationSet } from "@tiptap/pm/view";
+const UPLOAD_PLUGIN_KEY = new PluginKey("comitorImageUpload");
+function imageFilesFrom(data) {
+  return Array.from(data?.files ?? []).filter((file) => file.type.startsWith("image/"));
+}
+function createUploadId() {
+  return globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+function blockInsertPosition(state, position) {
+  const $pos = state.doc.resolve(Math.max(0, Math.min(position, state.doc.content.size)));
+  for (let depth = $pos.depth; depth > 0; depth--) {
+    if ($pos.node(depth).type.name === "table") return $pos.after(depth);
+  }
+  return $pos.pos;
+}
+function findPlaceholder(state, id) {
+  const found = UPLOAD_PLUGIN_KEY.getState(state)?.find(void 0, void 0, (spec) => spec.id === id);
+  return found?.[0]?.from ?? null;
+}
+function createPreview(src, label) {
+  const wrapper = document.createElement("span");
+  wrapper.setAttribute("data-upload-preview", "");
+  wrapper.setAttribute("role", "img");
+  wrapper.setAttribute("aria-label", label);
+  const image = document.createElement("img");
+  image.src = src;
+  image.alt = "";
+  wrapper.append(image);
+  return wrapper;
+}
+function preload(src) {
+  if (typeof window === "undefined" || typeof window.Image !== "function") return Promise.resolve();
+  const image = new window.Image();
+  image.src = src;
+  return Promise.race([image.decode().catch(() => void 0), new Promise((done) => setTimeout(done, 5e3))]);
+}
+function insertImageFiles(editor, files, position, handlers, pending) {
+  const upload = handlers.upload;
+  if (!upload || !editor.isEditable) return;
+  const at = position ?? editor.state.selection.from;
+  for (const file of files) {
+    const id = createUploadId();
+    const previewSrc = URL.createObjectURL(file);
+    pending.add(id);
+    const meta = { add: { id, pos: at, src: previewSrc } };
+    editor.view.dispatch(editor.state.tr.setMeta(UPLOAD_PLUGIN_KEY, meta));
+    const settle = () => {
+      pending.delete(id);
+      URL.revokeObjectURL(previewSrc);
+    };
+    const removePreview = () => {
+      if (editor.isDestroyed) return;
+      const removal = { remove: { id } };
+      editor.view.dispatch(editor.state.tr.setMeta(UPLOAD_PLUGIN_KEY, removal));
+    };
+    upload(file).then(async (result) => {
+      const attrs = typeof result === "string" ? { src: result } : result;
+      await preload(handlers.resolveSrc?.(attrs.src) ?? attrs.src);
+      if (editor.isDestroyed) return settle();
+      const pos = findPlaceholder(editor.state, id);
+      if (pos === null) {
+        removePreview();
+        return settle();
+      }
+      const removal = { remove: { id } };
+      editor.chain().command(({ tr }) => {
+        tr.setMeta(UPLOAD_PLUGIN_KEY, removal);
+        return true;
+      }).insertContentAt(
+        blockInsertPosition(editor.state, pos),
+        { type: "image", attrs: { src: attrs.src, alt: attrs.alt ?? file.name, title: attrs.title ?? null } },
+        { updateSelection: false }
+      ).run();
+      settle();
+    }).catch((error) => {
+      removePreview();
+      settle();
+      handlers.onError(error, file);
+    });
+  }
+}
+function createImageUploadExtension(handlers, pending) {
+  return Extension.create({
+    name: "comitorImageUpload",
+    addProseMirrorPlugins() {
+      const editor = this.editor;
+      return [
+        new Plugin({
+          key: UPLOAD_PLUGIN_KEY,
+          state: {
+            init: () => DecorationSet.empty,
+            apply(tr, set) {
+              let next = set.map(tr.mapping, tr.doc);
+              const meta = tr.getMeta(UPLOAD_PLUGIN_KEY);
+              if (meta && "add" in meta) {
+                const { id, pos, src } = meta.add;
+                const label = handlers.current.uploadingLabel;
+                const widget = Decoration.widget(pos, () => createPreview(src, label), { id, key: id, side: -1 });
+                next = next.add(tr.doc, [widget]);
+              } else if (meta && "remove" in meta) {
+                next = next.remove(next.find(void 0, void 0, (spec) => spec.id === meta.remove.id));
+              }
+              return next;
+            }
+          },
+          props: {
+            decorations: (state) => UPLOAD_PLUGIN_KEY.getState(state),
+            handlePaste: (view, event) => {
+              if (!handlers.current.upload || !view.editable) return false;
+              const files = imageFilesFrom(event.clipboardData);
+              if (files.length === 0) return false;
+              insertImageFiles(editor, files, void 0, handlers.current, pending);
+              return true;
+            },
+            handleDrop: (view, event, _slice, moved) => {
+              if (moved || !handlers.current.upload || !view.editable) return false;
+              const files = imageFilesFrom(event.dataTransfer);
+              if (files.length === 0) return false;
+              const coordinates = view.posAtCoords({ left: event.clientX, top: event.clientY });
+              insertImageFiles(editor, files, coordinates?.pos, handlers.current, pending);
+              return true;
+            }
+          }
+        })
+      ];
+    }
+  });
+}
+export {
+  createImageUploadExtension,
+  imageFilesFrom,
+  insertImageFiles
+};
+//# sourceMappingURL=image-upload.js.map

package/dist/editor/image-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/image-upload.ts"],"sourcesContent":["/**\n * Ảnh dán / kéo thả / chọn từ menu `/` → tải qua `onImageUpload` của app → chèn vào tài liệu.\n *\n * Gói KHÔNG biết kho ảnh ở đâu: bucket của module Comitor là riêng tư, URL hiện được là URL đã ký\n * — nên đường tải là của app (route của app ký và ghi), gói chỉ trao `File` và nhận lại `src` để\n * LƯU. Cùng nguyên tắc với `/uploader` (`XHRUpload` về endpoint của app).\n *\n * ── ẢNH ĐANG TẢI LÀ DECORATION, KHÔNG PHẢI NODE ────────────────────────────────────────────────\n * Trong lúc tải, ảnh hiện NGAY bằng `blob:` của chính tệp — nhưng dưới dạng một widget decoration\n * (khuôn \"upload\" của ProseMirror), không phải một node trong tài liệu. Node ảnh thật chỉ được chèn\n * MỘT lần, khi app đã trả `src`.\n *\n * Bản đầu chèn một node ảnh TẠM rồi đổi `src` khi xong (giao dịch đổi không vào lịch sử). Nó qua\n * mọi phép thử lúc gõ, và hỏng ở lịch sử hoàn tác: ⌘Z gỡ ảnh, rồi ⌘⇧Z làm lại ĐÚNG bước chèn node\n * tạm — `src` là `blob:` đã thu hồi, cờ \"đang tải\" còn nguyên: một ảnh vỡ kẹt mãi, và vì cờ đó\n * nên nó cũng không bao giờ vào markdown. Với decoration thì tài liệu không bao giờ chứa thứ gì tạm:\n * lịch sử chỉ có một bước, \"chèn ảnh thật\".\n */\n\nimport { type Editor, Extension } from \"@tiptap/core\";\nimport { type EditorState, Plugin, PluginKey } from \"@tiptap/pm/state\";\nimport { Decoration, DecorationSet } from \"@tiptap/pm/view\";\n\n/** Thứ `onImageUpload` trả về: `src` để LƯU, hoặc kèm `alt`/`title`. */\nexport type MarkdownEditorImageUploadResult = string | { src: string; alt?: string; title?: string };\n\nexport interface ImageUploadHandlers {\n  upload?: (file: File) => Promise<MarkdownEditorImageUploadResult>;\n  onError: (error: unknown, file: File) => void;\n  /** Đổi `src` lưu → `src` hiện (`resolveImageSrc`), để tải trước ảnh thật trước khi chèn. */\n  resolveSrc?: (src: string) => string;\n  /** Nhãn trợ năng của ảnh đang tải (`role=\"img\"` của widget). */\n  uploadingLabel: string;\n}\n\n/** Ảnh đang tải của MỘT trình soạn — `MarkdownEditorHandle.isUploading()` đọc nó. */\nexport type PendingUploads = Set<string>;\n\ntype UploadMeta = { add: { id: string; pos: number; src: string } } | { remove: { id: string } };\n\nconst UPLOAD_PLUGIN_KEY = new PluginKey<DecorationSet>(\"comitorImageUpload\");\n\n/** Tệp ảnh trong một lần dán/thả. Tệp khác (PDF, zip…) bỏ qua: trình soạn chỉ nhúng ảnh. */\nexport function imageFilesFrom(data: DataTransfer | null): File[] {\n  return Array.from(data?.files ?? []).filter((file) => file.type.startsWith(\"image/\"));\n}\n\n/**\n * `crypto.randomUUID` chỉ có ở NGỮ CẢNH AN TOÀN — mở trang dev bằng IP mạng LAN qua http thì nó\n * `undefined`, và một `TypeError` giữa lúc dán ảnh là mất luôn tấm ảnh. Id này chỉ cần duy nhất\n * trong một tài liệu đang mở.\n */\nfunction createUploadId(): string {\n  return globalThis.crypto?.randomUUID?.() ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;\n}\n\n/**\n * Vị trí chèn một ảnh (node KHỐI) gần `position` nhất. Trong bảng thì ra SAU bảng: ô bảng chỉ chứa\n * một đoạn văn (`ComitorTableCell`), chèn khối vào đó là một giao dịch không hợp lệ.\n */\nfunction blockInsertPosition(state: EditorState, position: number): number {\n  const $pos = state.doc.resolve(Math.max(0, Math.min(position, state.doc.content.size)));\n  for (let depth = $pos.depth; depth > 0; depth--) {\n    if ($pos.node(depth).type.name === \"table\") return $pos.after(depth);\n  }\n  return $pos.pos;\n}\n\n/** Vị trí HIỆN TẠI của widget đang tải — đã đi theo mọi giao dịch từ lúc dán. `null` = đã bị xoá cùng vùng chữ. */\nfunction findPlaceholder(state: EditorState, id: string): number | null {\n  const found = UPLOAD_PLUGIN_KEY.getState(state)?.find(undefined, undefined, (spec) => spec.id === id);\n  return found?.[0]?.from ?? null;\n}\n\n/**\n * Widget ảnh đang tải. Lớp kiểu nằm ở `markdown-editor-classes.ts` (`[data-upload-preview]`) — DOM\n * này không qua JSX nên không gắn `className` có nghĩa được ở đây ngoài một thuộc tính để nhắm.\n */\nfunction createPreview(src: string, label: string): HTMLElement {\n  const wrapper = document.createElement(\"span\");\n  wrapper.setAttribute(\"data-upload-preview\", \"\");\n  wrapper.setAttribute(\"role\", \"img\");\n  wrapper.setAttribute(\"aria-label\", label);\n  const image = document.createElement(\"img\");\n  image.src = src;\n  image.alt = \"\";\n  wrapper.append(image);\n  return wrapper;\n}\n\n/**\n * Tải trước ảnh thật rồi mới chèn — không thì ảnh nháy TRẮNG giữa lúc widget đã gỡ còn ảnh mạng chưa\n * về. Lỗi tải trước hay quá 5 giây thì vẫn chèn: thà một ảnh vỡ thấy được còn hơn treo mãi ở trạng\n * thái \"đang tải\".\n */\nfunction preload(src: string): Promise<void> {\n  if (typeof window === \"undefined\" || typeof window.Image !== \"function\") return Promise.resolve();\n  const image = new window.Image();\n  image.src = src;\n  return Promise.race([image.decode().catch(() => undefined), new Promise<void>((done) => setTimeout(done, 5000))]);\n}\n\n/**\n * Hiện widget cho từng tệp và tải chúng. Xong tệp nào thì gỡ widget và chèn node ảnh thật vào ĐÚNG\n * chỗ widget đang đứng (vị trí đã đi theo mọi chỉnh sửa trong lúc chờ), trong CÙNG một giao dịch —\n * một bước hoàn tác. Không dời con trỏ: người dùng có thể đang gõ ở chỗ khác.\n */\nexport function insertImageFiles(\n  editor: Editor,\n  files: readonly File[],\n  position: number | undefined,\n  handlers: ImageUploadHandlers,\n  pending: PendingUploads\n): void {\n  const upload = handlers.upload;\n  if (!upload || !editor.isEditable) return;\n\n  const at = position ?? editor.state.selection.from;\n  for (const file of files) {\n    const id = createUploadId();\n    const previewSrc = URL.createObjectURL(file);\n    pending.add(id);\n    const meta: UploadMeta = { add: { id, pos: at, src: previewSrc } };\n    editor.view.dispatch(editor.state.tr.setMeta(UPLOAD_PLUGIN_KEY, meta));\n\n    const settle = () => {\n      pending.delete(id);\n      URL.revokeObjectURL(previewSrc);\n    };\n    const removePreview = () => {\n      if (editor.isDestroyed) return;\n      const removal: UploadMeta = { remove: { id } };\n      editor.view.dispatch(editor.state.tr.setMeta(UPLOAD_PLUGIN_KEY, removal));\n    };\n\n    upload(file)\n      .then(async (result) => {\n        const attrs = typeof result === \"string\" ? { src: result } : result;\n        await preload(handlers.resolveSrc?.(attrs.src) ?? attrs.src);\n        if (editor.isDestroyed) return settle();\n        const pos = findPlaceholder(editor.state, id);\n        if (pos === null) {\n          // Vùng chữ chứa widget đã bị xoá trong lúc chờ: người dùng đã bỏ tấm ảnh này.\n          removePreview();\n          return settle();\n        }\n        const removal: UploadMeta = { remove: { id } };\n        editor\n          .chain()\n          .command(({ tr }) => {\n            tr.setMeta(UPLOAD_PLUGIN_KEY, removal);\n            return true;\n          })\n          .insertContentAt(\n            blockInsertPosition(editor.state, pos),\n            { type: \"image\", attrs: { src: attrs.src, alt: attrs.alt ?? file.name, title: attrs.title ?? null } },\n            { updateSelection: false }\n          )\n          .run();\n        settle();\n      })\n      .catch((error: unknown) => {\n        removePreview();\n        settle();\n        handlers.onError(error, file);\n      });\n  }\n}\n\n/**\n * Bắt ảnh khi DÁN và khi THẢ, và giữ các widget đang tải. Không có `onImageUpload` thì plugin đứng\n * ngoài (trả `false`) — dán/thả đi đường mặc định của Tiptap, tức ảnh dạng tệp không được nhận\n * (không có chỗ nào để lưu nó).\n *\n * Kéo thả NỘI BỘ (di chuyển một ảnh đã có trong tài liệu, `moved === true`) thì không đụng tới.\n */\nexport function createImageUploadExtension(\n  handlers: { readonly current: ImageUploadHandlers },\n  pending: PendingUploads\n): Extension {\n  return Extension.create({\n    name: \"comitorImageUpload\",\n    addProseMirrorPlugins() {\n      const editor = this.editor;\n      return [\n        new Plugin<DecorationSet>({\n          key: UPLOAD_PLUGIN_KEY,\n          state: {\n            init: () => DecorationSet.empty,\n            apply(tr, set) {\n              let next = set.map(tr.mapping, tr.doc);\n              const meta = tr.getMeta(UPLOAD_PLUGIN_KEY) as UploadMeta | undefined;\n              if (meta && \"add\" in meta) {\n                const { id, pos, src } = meta.add;\n                const label = handlers.current.uploadingLabel;\n                // `side: -1`: chữ gõ tiếp ngay tại chỗ dán đi SAU widget — như thể con trỏ đã đứng\n                // sau ảnh. Mặc định (0) đẩy widget sang phải, và câu gõ tiếp nằm trước ảnh.\n                const widget = Decoration.widget(pos, () => createPreview(src, label), { id, key: id, side: -1 });\n                next = next.add(tr.doc, [widget]);\n              } else if (meta && \"remove\" in meta) {\n                next = next.remove(next.find(undefined, undefined, (spec) => spec.id === meta.remove.id));\n              }\n              return next;\n            }\n          },\n          props: {\n            decorations: (state) => UPLOAD_PLUGIN_KEY.getState(state),\n            handlePaste: (view, event) => {\n              if (!handlers.current.upload || !view.editable) return false;\n              const files = imageFilesFrom(event.clipboardData);\n              if (files.length === 0) return false;\n              insertImageFiles(editor, files, undefined, handlers.current, pending);\n              return true;\n            },\n            handleDrop: (view, event, _slice, moved) => {\n              if (moved || !handlers.current.upload || !view.editable) return false;\n              const files = imageFilesFrom(event.dataTransfer);\n              if (files.length === 0) return false;\n              const coordinates = view.posAtCoords({ left: event.clientX, top: event.clientY });\n              insertImageFiles(editor, files, coordinates?.pos, handlers.current, pending);\n              return true;\n            }\n          }\n        })\n      ];\n    }\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/editor/index.d.ts

@@ -0,0 +1,5 @@
+export { MarkdownEditorImageUploadResult } from './image-upload.js';
+export { MarkdownEditor, MarkdownEditorHandle, MarkdownEditorMentionItem, MarkdownEditorMentionSource, MarkdownEditorMentions, MarkdownEditorProps, MarkdownEditorVariant } from './markdown-editor.js';
+export { DEFAULT_MARKDOWN_EDITOR_LABELS, MarkdownEditorBlockId, MarkdownEditorLabels } from './markdown-editor-constants.js';
+import '@tiptap/core';
+import 'react';

package/dist/editor/index.js

@@ -0,0 +1,11 @@
+import {
+  MarkdownEditor
+} from "./markdown-editor.js";
+import {
+  DEFAULT_MARKDOWN_EDITOR_LABELS
+} from "./markdown-editor-constants.js";
+export {
+  DEFAULT_MARKDOWN_EDITOR_LABELS,
+  MarkdownEditor
+};
+//# sourceMappingURL=index.js.map

package/dist/editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/index.ts"],"sourcesContent":["/**\n * Entry `@comitor/ui/editor` — trình soạn văn bản giàu định dạng kiểu Linear, lưu bằng markdown.\n *\n * ── VÌ SAO LÀ MỘT ENTRY RIÊNG ────────────────────────────────────────────────────────────────\n * Cùng lý do `/data-grid` và `/uploader`: trình soạn kéo Tiptap/ProseMirror (~184KB gzip, cộng ~53KB\n * bảng tô màu mã) qua các peer TUỲ CHỌN, mà `tsup` chạy `bundle: false` — để nó ở entry `.` là bắt\n * mọi app cài Tiptap chỉ để dùng `Button`. App không `import` từ đây thì không có một byte nào.\n *\n * ── VÌ SAO TIPTAP LÀ PEER, KHÔNG PHẢI DEPENDENCY ────────────────────────────────────────────\n * Mọi gói `@tiptap/*` ghim `@tiptap/core` + `@tiptap/pm` bằng phiên bản CHÍNH XÁC. App sẽ tự viết\n * extension (vd node `KEY-n` của module Tasks) bằng `@tiptap/core` của nó — nếu gói giữ một bản\n * riêng thì trang có hai bản ProseMirror, và node tạo bằng bản này không lắp được vào tài liệu của\n * bản kia. Cùng loại \"context singleton\" với `next-themes` và `@tanstack/react-table`.\n *\n * Cài ở app — MỌI gói `@tiptap/*` CÙNG một phiên bản:\n * ```bash\n * pnpm add @tiptap/core @tiptap/pm @tiptap/react @tiptap/starter-kit @tiptap/markdown \\\n *   @tiptap/extensions @tiptap/extension-list @tiptap/extension-table @tiptap/extension-image \\\n *   @tiptap/extension-mention @tiptap/suggestion @tiptap/extension-paragraph \\\n *   @tiptap/extension-code-block-lowlight lowlight highlight.js\n * ```\n *\n * Tài liệu: docs/editor.md của repo `comitor-ui`.\n */\n\nexport type { MarkdownEditorImageUploadResult } from \"./image-upload.js\";\nexport {\n  MarkdownEditor,\n  type MarkdownEditorHandle,\n  type MarkdownEditorMentionItem,\n  type MarkdownEditorMentionSource,\n  type MarkdownEditorMentions,\n  type MarkdownEditorProps,\n  type MarkdownEditorVariant\n} from \"./markdown-editor.js\";\nexport {\n  DEFAULT_MARKDOWN_EDITOR_LABELS,\n  type MarkdownEditorBlockId,\n  type MarkdownEditorLabels\n} from \"./markdown-editor-constants.js\";\n"],"mappings":"AA0BA;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,OAGK;","names":[]}

package/dist/editor/markdown-editor-classes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Kiểu chữ của vùng soạn — file thuần, không `"use client"`.
+ *
+ * DOM bên trong do ProseMirror dựng (không phải JSX của gói), nên không có `className` nào gắn được
+ * lên từng `<h2>`, `<li>`, `<pre>`: mọi kiểu đi qua biến thể con cháu `[&_h2]:…` đặt trên PHẦN TỬ
+ * GỐC của ProseMirror. Tailwind của app vẫn sinh được chúng vì chuỗi nằm nguyên văn trong `dist/`
+ * (`@source "./dist"` của `styles.css`) — nên KHÔNG dựng chuỗi lớp động ở đây.
+ *
+ * Màu chỉ đi qua token VAI TRÒ, đúng hợp đồng của gói: chữ thường kế thừa `--foreground`, liên kết
+ * `--link-ink`, mã `--muted`, nhắc tên `--info/15` (cùng khối của `Mention`), tô màu cú pháp các bậc
+ * `-ink` — chúng là bậc dành cho CHỮ trên nền trang/muted ở cả hai bảng màu.
+ */
+/** Toàn bộ lớp của phần tử gốc ProseMirror (`.tiptap`). */
+declare const MARKDOWN_EDITOR_CONTENT_CLASS: string;
+
+export { MARKDOWN_EDITOR_CONTENT_CLASS };

package/dist/editor/markdown-editor-classes.js

@@ -0,0 +1,117 @@
+const LAYOUT = [
+  "min-w-0 text-base leading-relaxed text-foreground outline-none md:text-sm",
+  "[&>*+*]:mt-3 [&>*:first-child]:mt-0",
+  "[&>h1]:mt-6 [&>h2]:mt-5 [&>h3]:mt-4"
+];
+const HEADINGS = [
+  "[&_h1]:text-xl [&_h1]:leading-snug [&_h1]:font-semibold [&_h1]:tracking-tight",
+  "[&_h2]:text-lg [&_h2]:leading-snug [&_h2]:font-semibold",
+  "[&_h3]:text-base [&_h3]:leading-snug [&_h3]:font-semibold",
+  "[&_h4]:font-semibold [&_h5]:font-semibold [&_h6]:font-semibold"
+];
+const INLINE = [
+  "[&_strong]:font-semibold",
+  // Liên kết: khuôn của `Button variant="link"` / `FieldDescription` — bậc `--link-ink`, gạch dưới.
+  "[&_a]:text-link-ink [&_a]:underline [&_a]:underline-offset-4 [&_a:hover]:text-link-ink-hover",
+  "[&_:not(pre)>code]:rounded-sm [&_:not(pre)>code]:bg-muted [&_:not(pre)>code]:px-1 [&_:not(pre)>code]:py-0.5",
+  "[&_:not(pre)>code]:font-mono [&_:not(pre)>code]:text-[0.875em]",
+  // Nhắc tên: cùng cặp với khối `@Tên` của `Mention` (nền `info/15`, chữ thường) — đã đo ở mention.tsx.
+  "[&_[data-type=mention]]:rounded-sm [&_[data-type=mention]]:bg-info/15 [&_[data-type=mention]]:px-0.5",
+  "[&_[data-type=mention]]:py-px [&_[data-type=mention]]:font-medium [&_[data-type=mention]]:text-foreground"
+];
+const LISTS = [
+  "[&_ul:not([data-type=taskList])]:list-disc [&_ol]:list-decimal",
+  "[&_ul:not([data-type=taskList])]:pl-6 [&_ol]:pl-6 [&_li]:marker:text-muted-foreground",
+  "[&_li+li]:mt-1 [&_li>ul]:mt-1 [&_li>ol]:mt-1 [&_li>p]:my-0",
+  "[&_ul[data-type=taskList]]:list-none [&_ul[data-type=taskList]]:pl-0.5",
+  "[&_[data-type=taskList]>li]:flex [&_[data-type=taskList]>li]:items-start [&_[data-type=taskList]>li]:gap-2",
+  "[&_[data-type=taskList]>li>label]:flex [&_[data-type=taskList]>li>label]:h-[1.625em] [&_[data-type=taskList]>li>label]:items-center",
+  "[&_[data-type=taskList]>li>label]:select-none [&_[data-type=taskList]>li>div]:min-w-0 [&_[data-type=taskList]>li>div]:flex-1",
+  // Soạn được: con trỏ tay trên ô tick. Chỉ đọc: ô không nhận chuột — Tiptap để nó bấm được rồi tự lật
+  // lại (không có `onReadOnlyChecked`), nên một cú bấm "không ăn" là thứ duy nhất người dùng thấy.
+  "[&[contenteditable=true]_[data-type=taskList]>li>label>input]:cursor-pointer",
+  "[&[contenteditable=false]_[data-type=taskList]>li>label]:pointer-events-none",
+  // Mục đã xong: chữ nhạt + gạch — CHỈ đoạn của chính mục, không lan xuống danh sách con chưa xong.
+  "[&_li[data-checked=true]>div>p]:text-muted-foreground [&_li[data-checked=true]>div>p]:line-through"
+];
+const TASK_CHECKBOX = [
+  "[&_[data-type=taskList]>li>label>input]:relative [&_[data-type=taskList]>li>label>input]:m-0 [&_[data-type=taskList]>li>label>input]:grid",
+  "[&_[data-type=taskList]>li>label>input]:size-4 [&_[data-type=taskList]>li>label>input]:shrink-0 [&_[data-type=taskList]>li>label>input]:appearance-none",
+  "[&_[data-type=taskList]>li>label>input]:place-content-center [&_[data-type=taskList]>li>label>input]:rounded-[4px]",
+  "[&_[data-type=taskList]>li>label>input]:border [&_[data-type=taskList]>li>label>input]:border-choice-edge",
+  "[&_[data-type=taskList]>li>label>input]:bg-transparent [&_[data-type=taskList]>li>label>input]:transition-colors",
+  "[&_[data-type=taskList]>li>label>input:checked]:border-control-on [&_[data-type=taskList]>li>label>input:checked]:bg-control-on",
+  "[&_[data-type=taskList]>li>label>input:focus-visible]:outline-2 [&_[data-type=taskList]>li>label>input:focus-visible]:outline-offset-2",
+  "[&_[data-type=taskList]>li>label>input:focus-visible]:outline-ring",
+  // Dấu tick CHỈ tồn tại khi đã tick (`content` chỉ có ở `:checked`) — không ẩn bằng `opacity-0`: một
+  // dấu vô hình vẫn là một nét mà cổng màu phải đo, và đo ra 1,00:1.
+  "[&_[data-type=taskList]>li>label>input:checked]:before:h-2 [&_[data-type=taskList]>li>label>input:checked]:before:w-1",
+  "[&_[data-type=taskList]>li>label>input:checked]:before:-translate-y-px [&_[data-type=taskList]>li>label>input:checked]:before:rotate-45",
+  "[&_[data-type=taskList]>li>label>input:checked]:before:border-r-2 [&_[data-type=taskList]>li>label>input:checked]:before:border-b-2",
+  "[&_[data-type=taskList]>li>label>input:checked]:before:border-control-check",
+  "[&_[data-type=taskList]>li>label>input:checked]:before:content-['']"
+];
+const BLOCKS = [
+  "[&_blockquote]:border-l-2 [&_blockquote]:border-muted-foreground [&_blockquote]:pl-4 [&_blockquote]:text-muted-foreground",
+  "[&_blockquote>*+*]:mt-2",
+  "[&_hr]:my-1 [&_hr]:border-border",
+  // Khối mã XUỐNG DÒNG (`pre-wrap`) thay vì cuộn ngang: trong trình soạn, một thanh cuộn ngang lồng
+  // trong khung cuộn dọc là chỗ con trỏ biến mất khỏi tầm nhìn khi gõ. Đó cũng là CSS Tiptap chèn sẵn
+  // (`.ProseMirror pre`) — bản trước ghi `whitespace-pre` ở đây, và nó thua luật đó mà không ai thấy.
+  "[&_pre]:overflow-x-auto [&_pre]:rounded-md [&_pre]:bg-muted [&_pre]:px-4 [&_pre]:py-3",
+  "[&_pre]:font-mono [&_pre]:text-[0.8125rem] [&_pre]:leading-relaxed [&_pre]:whitespace-pre-wrap",
+  "[&_pre_code]:bg-transparent [&_pre_code]:p-0 [&_pre_code]:text-inherit"
+];
+const SYNTAX = [
+  "[&_.hljs-comment]:text-muted-foreground [&_.hljs-comment]:italic [&_.hljs-quote]:text-muted-foreground",
+  "[&_.hljs-keyword]:text-red-ink [&_.hljs-selector-tag]:text-red-ink [&_.hljs-doctag]:text-red-ink",
+  "[&_.hljs-meta_.hljs-keyword]:text-red-ink [&_.hljs-template-tag]:text-red-ink",
+  "[&_.hljs-string]:text-navy-ink [&_.hljs-regexp]:text-navy-ink [&_.hljs-meta_.hljs-string]:text-navy-ink",
+  "[&_.hljs-number]:text-teal-ink [&_.hljs-literal]:text-teal-ink [&_.hljs-attr]:text-teal-ink",
+  "[&_.hljs-attribute]:text-teal-ink [&_.hljs-variable]:text-teal-ink [&_.hljs-template-variable]:text-teal-ink",
+  "[&_.hljs-selector-attr]:text-teal-ink [&_.hljs-selector-class]:text-teal-ink [&_.hljs-selector-id]:text-teal-ink",
+  "[&_.hljs-title]:text-orange-ink [&_.hljs-section]:text-orange-ink [&_.hljs-name]:text-orange-ink",
+  "[&_.hljs-type]:text-orange-ink [&_.hljs-built_in]:text-orange-ink [&_.hljs-symbol]:text-orange-ink",
+  "[&_.hljs-meta]:text-muted-foreground [&_.hljs-bullet]:text-orange-ink [&_.hljs-link]:underline",
+  "[&_.hljs-addition]:text-success-ink [&_.hljs-deletion]:text-destructive-ink",
+  "[&_.hljs-emphasis]:italic [&_.hljs-strong]:font-semibold"
+];
+const TABLES = [
+  "[&_.tableWrapper]:overflow-x-auto",
+  "[&_table]:w-full [&_table]:border-collapse [&_table]:text-left",
+  "[&_td]:border [&_td]:border-border [&_td]:px-2.5 [&_td]:py-1.5 [&_td]:align-top",
+  "[&_th]:border [&_th]:border-border [&_th]:bg-muted [&_th]:px-2.5 [&_th]:py-1.5 [&_th]:align-top [&_th]:font-medium",
+  "[&_td>p]:my-0 [&_th>p]:my-0 [&_.selectedCell]:bg-accent [&_.selectedCell]:text-accent-foreground"
+];
+const MEDIA = [
+  "[&_img]:h-auto [&_img]:max-w-full [&_img]:rounded-md [&_img]:border [&_img]:border-border",
+  // Ảnh đang tải lên — một widget decoration, không phải node (xem `image-upload.ts`): đứng thành
+  // một khối riêng, mờ và nhấp nháy tới khi ảnh thật được chèn vào chỗ nó.
+  "[&_[data-upload-preview]]:my-2 [&_[data-upload-preview]]:block [&_[data-upload-preview]]:w-fit",
+  "[&_[data-upload-preview]>img]:animate-pulse [&_[data-upload-preview]>img]:opacity-60",
+  // Node được chọn bằng bấm (ảnh, đường kẻ): viền focus của gói, không phải nền.
+  "[&_.ProseMirror-selectednode]:outline-2 [&_.ProseMirror-selectednode]:outline-offset-2 [&_.ProseMirror-selectednode]:outline-ring"
+];
+const AFFORDANCES = [
+  "[&_.is-editor-empty:first-child]:before:pointer-events-none [&_.is-editor-empty:first-child]:before:float-left",
+  "[&_.is-editor-empty:first-child]:before:h-0 [&_.is-editor-empty:first-child]:before:text-muted-foreground",
+  "[&_.is-editor-empty:first-child]:before:content-[attr(data-placeholder)]",
+  "[&_.suggestion]:rounded-sm [&_.suggestion]:bg-muted",
+  "[&_.ProseMirror-gapcursor]:after:border-foreground"
+];
+const MARKDOWN_EDITOR_CONTENT_CLASS = [
+  ...LAYOUT,
+  ...HEADINGS,
+  ...INLINE,
+  ...LISTS,
+  ...TASK_CHECKBOX,
+  ...BLOCKS,
+  ...SYNTAX,
+  ...TABLES,
+  ...MEDIA,
+  ...AFFORDANCES
+].join(" ");
+export {
+  MARKDOWN_EDITOR_CONTENT_CLASS
+};
+//# sourceMappingURL=markdown-editor-classes.js.map

package/dist/editor/markdown-editor-classes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/markdown-editor-classes.ts"],"sourcesContent":["/**\n * Kiểu chữ của vùng soạn — file thuần, không `\"use client\"`.\n *\n * DOM bên trong do ProseMirror dựng (không phải JSX của gói), nên không có `className` nào gắn được\n * lên từng `<h2>`, `<li>`, `<pre>`: mọi kiểu đi qua biến thể con cháu `[&_h2]:…` đặt trên PHẦN TỬ\n * GỐC của ProseMirror. Tailwind của app vẫn sinh được chúng vì chuỗi nằm nguyên văn trong `dist/`\n * (`@source \"./dist\"` của `styles.css`) — nên KHÔNG dựng chuỗi lớp động ở đây.\n *\n * Màu chỉ đi qua token VAI TRÒ, đúng hợp đồng của gói: chữ thường kế thừa `--foreground`, liên kết\n * `--link-ink`, mã `--muted`, nhắc tên `--info/15` (cùng khối của `Mention`), tô màu cú pháp các bậc\n * `-ink` — chúng là bậc dành cho CHỮ trên nền trang/muted ở cả hai bảng màu.\n */\n\n/*\n * Bố cục khối: khoảng cách giữa các khối CẤP ĐẦU bằng `> * + *` (không margin hai đầu tài liệu),\n * tiêu đề cách xa hơn phía trên để nhóm với phần nó mở. Cỡ chữ theo `Textarea`: 16px ở màn hẹp —\n * dưới 16px là Safari iOS tự phóng to trang khi chạm vào vùng soạn — 14px từ `md`.\n */\nconst LAYOUT = [\n  \"min-w-0 text-base leading-relaxed text-foreground outline-none md:text-sm\",\n  \"[&>*+*]:mt-3 [&>*:first-child]:mt-0\",\n  \"[&>h1]:mt-6 [&>h2]:mt-5 [&>h3]:mt-4\"\n];\n\nconst HEADINGS = [\n  \"[&_h1]:text-xl [&_h1]:leading-snug [&_h1]:font-semibold [&_h1]:tracking-tight\",\n  \"[&_h2]:text-lg [&_h2]:leading-snug [&_h2]:font-semibold\",\n  \"[&_h3]:text-base [&_h3]:leading-snug [&_h3]:font-semibold\",\n  \"[&_h4]:font-semibold [&_h5]:font-semibold [&_h6]:font-semibold\"\n];\n\nconst INLINE = [\n  \"[&_strong]:font-semibold\",\n  // Liên kết: khuôn của `Button variant=\"link\"` / `FieldDescription` — bậc `--link-ink`, gạch dưới.\n  \"[&_a]:text-link-ink [&_a]:underline [&_a]:underline-offset-4 [&_a:hover]:text-link-ink-hover\",\n  \"[&_:not(pre)>code]:rounded-sm [&_:not(pre)>code]:bg-muted [&_:not(pre)>code]:px-1 [&_:not(pre)>code]:py-0.5\",\n  \"[&_:not(pre)>code]:font-mono [&_:not(pre)>code]:text-[0.875em]\",\n  // Nhắc tên: cùng cặp với khối `@Tên` của `Mention` (nền `info/15`, chữ thường) — đã đo ở mention.tsx.\n  \"[&_[data-type=mention]]:rounded-sm [&_[data-type=mention]]:bg-info/15 [&_[data-type=mention]]:px-0.5\",\n  \"[&_[data-type=mention]]:py-px [&_[data-type=mention]]:font-medium [&_[data-type=mention]]:text-foreground\"\n];\n\n/*\n * Danh sách thường. Danh sách việc (`ul[data-type=taskList]`) bỏ chấm đầu dòng và tự vẽ ô tick: DOM\n * do `TaskItem` dựng là `li[data-checked] > label > input + span(sr-only)` cạnh `div` nội dung.\n * ⚠ `<li>` KHÔNG mang `data-type=\"taskItem\"`: thuộc tính đó chỉ có trong `renderHTML`, còn node view\n * (thứ thật sự vẽ trong trình soạn) không gắn nó — đã đo trên 3.31.4, selector `li[data-type=…]`\n * trượt hết và ô tick nằm một dòng, chữ rơi xuống dòng dưới. Nhắm qua `ul` cha.\n */\nconst LISTS = [\n  \"[&_ul:not([data-type=taskList])]:list-disc [&_ol]:list-decimal\",\n  \"[&_ul:not([data-type=taskList])]:pl-6 [&_ol]:pl-6 [&_li]:marker:text-muted-foreground\",\n  \"[&_li+li]:mt-1 [&_li>ul]:mt-1 [&_li>ol]:mt-1 [&_li>p]:my-0\",\n  \"[&_ul[data-type=taskList]]:list-none [&_ul[data-type=taskList]]:pl-0.5\",\n  \"[&_[data-type=taskList]>li]:flex [&_[data-type=taskList]>li]:items-start [&_[data-type=taskList]>li]:gap-2\",\n  \"[&_[data-type=taskList]>li>label]:flex [&_[data-type=taskList]>li>label]:h-[1.625em] [&_[data-type=taskList]>li>label]:items-center\",\n  \"[&_[data-type=taskList]>li>label]:select-none [&_[data-type=taskList]>li>div]:min-w-0 [&_[data-type=taskList]>li>div]:flex-1\",\n  // Soạn được: con trỏ tay trên ô tick. Chỉ đọc: ô không nhận chuột — Tiptap để nó bấm được rồi tự lật\n  // lại (không có `onReadOnlyChecked`), nên một cú bấm \"không ăn\" là thứ duy nhất người dùng thấy.\n  \"[&[contenteditable=true]_[data-type=taskList]>li>label>input]:cursor-pointer\",\n  \"[&[contenteditable=false]_[data-type=taskList]>li>label]:pointer-events-none\",\n  // Mục đã xong: chữ nhạt + gạch — CHỈ đoạn của chính mục, không lan xuống danh sách con chưa xong.\n  \"[&_li[data-checked=true]>div>p]:text-muted-foreground [&_li[data-checked=true]>div>p]:line-through\"\n];\n\n/*\n * Ô tick vẽ bằng CSS trên chính `<input>` (`appearance-none`), dấu tick là một chữ L xoay 45° vẽ\n * bằng viền của `::before` — không ảnh, không SVG, không mã màu: mọi màu là token của `Checkbox`\n * (`--choice-edge` viền nghỉ, `--control-on` nền khi chọn, `--control-check` dấu tick).\n */\nconst TASK_CHECKBOX = [\n  \"[&_[data-type=taskList]>li>label>input]:relative [&_[data-type=taskList]>li>label>input]:m-0 [&_[data-type=taskList]>li>label>input]:grid\",\n  \"[&_[data-type=taskList]>li>label>input]:size-4 [&_[data-type=taskList]>li>label>input]:shrink-0 [&_[data-type=taskList]>li>label>input]:appearance-none\",\n  \"[&_[data-type=taskList]>li>label>input]:place-content-center [&_[data-type=taskList]>li>label>input]:rounded-[4px]\",\n  \"[&_[data-type=taskList]>li>label>input]:border [&_[data-type=taskList]>li>label>input]:border-choice-edge\",\n  \"[&_[data-type=taskList]>li>label>input]:bg-transparent [&_[data-type=taskList]>li>label>input]:transition-colors\",\n  \"[&_[data-type=taskList]>li>label>input:checked]:border-control-on [&_[data-type=taskList]>li>label>input:checked]:bg-control-on\",\n  \"[&_[data-type=taskList]>li>label>input:focus-visible]:outline-2 [&_[data-type=taskList]>li>label>input:focus-visible]:outline-offset-2\",\n  \"[&_[data-type=taskList]>li>label>input:focus-visible]:outline-ring\",\n  // Dấu tick CHỈ tồn tại khi đã tick (`content` chỉ có ở `:checked`) — không ẩn bằng `opacity-0`: một\n  // dấu vô hình vẫn là một nét mà cổng màu phải đo, và đo ra 1,00:1.\n  \"[&_[data-type=taskList]>li>label>input:checked]:before:h-2 [&_[data-type=taskList]>li>label>input:checked]:before:w-1\",\n  \"[&_[data-type=taskList]>li>label>input:checked]:before:-translate-y-px [&_[data-type=taskList]>li>label>input:checked]:before:rotate-45\",\n  \"[&_[data-type=taskList]>li>label>input:checked]:before:border-r-2 [&_[data-type=taskList]>li>label>input:checked]:before:border-b-2\",\n  \"[&_[data-type=taskList]>li>label>input:checked]:before:border-control-check\",\n  \"[&_[data-type=taskList]>li>label>input:checked]:before:content-['']\"\n];\n\n/*\n * Trích dẫn: vạch trái bằng `--muted-foreground` ĐẶC. `--border` đúng vai trò trang trí nhưng 1,16:1\n * ở light — gần như vô hình, trích dẫn chỉ còn là một đoạn chữ xám thụt vào. Bản `/40` dễ nhìn hơn\n * nhưng 1,71:1 trên `--muted` (light) / 1,87:1 (dark): cổng chặn ở bảng tương phản cao. Bản đặc qua\n * 3:1 ở cả bốn tổ hợp bảng màu × theme (đo bằng `pnpm lint:a11y`).\n */\nconst BLOCKS = [\n  \"[&_blockquote]:border-l-2 [&_blockquote]:border-muted-foreground [&_blockquote]:pl-4 [&_blockquote]:text-muted-foreground\",\n  \"[&_blockquote>*+*]:mt-2\",\n  \"[&_hr]:my-1 [&_hr]:border-border\",\n  // Khối mã XUỐNG DÒNG (`pre-wrap`) thay vì cuộn ngang: trong trình soạn, một thanh cuộn ngang lồng\n  // trong khung cuộn dọc là chỗ con trỏ biến mất khỏi tầm nhìn khi gõ. Đó cũng là CSS Tiptap chèn sẵn\n  // (`.ProseMirror pre`) — bản trước ghi `whitespace-pre` ở đây, và nó thua luật đó mà không ai thấy.\n  \"[&_pre]:overflow-x-auto [&_pre]:rounded-md [&_pre]:bg-muted [&_pre]:px-4 [&_pre]:py-3\",\n  \"[&_pre]:font-mono [&_pre]:text-[0.8125rem] [&_pre]:leading-relaxed [&_pre]:whitespace-pre-wrap\",\n  \"[&_pre_code]:bg-transparent [&_pre_code]:p-0 [&_pre_code]:text-inherit\"\n];\n\n/*\n * Tô màu cú pháp (lớp `hljs-*` do lowlight sinh). Phân vai kiểu bảng màu sáng quen thuộc của các\n * trình xem mã: từ khoá đỏ, chuỗi xanh đậm, hằng/số xanh ngọc, tên hàm cam, chú thích nhạt + nghiêng.\n * Toàn bậc `-ink`, nên đổi sang dark hay bảng tương phản cao là token tự đổi theo.\n */\nconst SYNTAX = [\n  \"[&_.hljs-comment]:text-muted-foreground [&_.hljs-comment]:italic [&_.hljs-quote]:text-muted-foreground\",\n  \"[&_.hljs-keyword]:text-red-ink [&_.hljs-selector-tag]:text-red-ink [&_.hljs-doctag]:text-red-ink\",\n  \"[&_.hljs-meta_.hljs-keyword]:text-red-ink [&_.hljs-template-tag]:text-red-ink\",\n  \"[&_.hljs-string]:text-navy-ink [&_.hljs-regexp]:text-navy-ink [&_.hljs-meta_.hljs-string]:text-navy-ink\",\n  \"[&_.hljs-number]:text-teal-ink [&_.hljs-literal]:text-teal-ink [&_.hljs-attr]:text-teal-ink\",\n  \"[&_.hljs-attribute]:text-teal-ink [&_.hljs-variable]:text-teal-ink [&_.hljs-template-variable]:text-teal-ink\",\n  \"[&_.hljs-selector-attr]:text-teal-ink [&_.hljs-selector-class]:text-teal-ink [&_.hljs-selector-id]:text-teal-ink\",\n  \"[&_.hljs-title]:text-orange-ink [&_.hljs-section]:text-orange-ink [&_.hljs-name]:text-orange-ink\",\n  \"[&_.hljs-type]:text-orange-ink [&_.hljs-built_in]:text-orange-ink [&_.hljs-symbol]:text-orange-ink\",\n  \"[&_.hljs-meta]:text-muted-foreground [&_.hljs-bullet]:text-orange-ink [&_.hljs-link]:underline\",\n  \"[&_.hljs-addition]:text-success-ink [&_.hljs-deletion]:text-destructive-ink\",\n  \"[&_.hljs-emphasis]:italic [&_.hljs-strong]:font-semibold\"\n];\n\n/*\n * Bảng: ô bảng chỉ chứa MỘT đoạn văn (xem `ComitorTableCell`), nên không cần luật cho khối lồng.\n * Cuộn ngang ở `.tableWrapper` (Tiptap bọc sẵn) — bảng rộng không được đẩy cả trang tràn ngang ở 375px.\n */\nconst TABLES = [\n  \"[&_.tableWrapper]:overflow-x-auto\",\n  \"[&_table]:w-full [&_table]:border-collapse [&_table]:text-left\",\n  \"[&_td]:border [&_td]:border-border [&_td]:px-2.5 [&_td]:py-1.5 [&_td]:align-top\",\n  \"[&_th]:border [&_th]:border-border [&_th]:bg-muted [&_th]:px-2.5 [&_th]:py-1.5 [&_th]:align-top [&_th]:font-medium\",\n  \"[&_td>p]:my-0 [&_th>p]:my-0 [&_.selectedCell]:bg-accent [&_.selectedCell]:text-accent-foreground\"\n];\n\nconst MEDIA = [\n  \"[&_img]:h-auto [&_img]:max-w-full [&_img]:rounded-md [&_img]:border [&_img]:border-border\",\n  // Ảnh đang tải lên — một widget decoration, không phải node (xem `image-upload.ts`): đứng thành\n  // một khối riêng, mờ và nhấp nháy tới khi ảnh thật được chèn vào chỗ nó.\n  \"[&_[data-upload-preview]]:my-2 [&_[data-upload-preview]]:block [&_[data-upload-preview]]:w-fit\",\n  \"[&_[data-upload-preview]>img]:animate-pulse [&_[data-upload-preview]>img]:opacity-60\",\n  // Node được chọn bằng bấm (ảnh, đường kẻ): viền focus của gói, không phải nền.\n  \"[&_.ProseMirror-selectednode]:outline-2 [&_.ProseMirror-selectednode]:outline-offset-2 [&_.ProseMirror-selectednode]:outline-ring\"\n];\n\n/*\n * Chữ mờ khi tài liệu rỗng — `Placeholder` gắn `.is-editor-empty` + `data-placeholder` lên đoạn\n * đầu. Đoạn đang gõ dở sau `/` hoặc `@` mang `.suggestion`: tô nền nhẹ để thấy chữ nào đang là lệnh.\n * Con trỏ khe (`gapcursor`, giữa hai khối không gõ được như bảng/ảnh): CSS mặc định Tiptap chèn\n * là viền `black` — vô hình ở dark, nên đổi sang `--foreground`.\n */\nconst AFFORDANCES = [\n  \"[&_.is-editor-empty:first-child]:before:pointer-events-none [&_.is-editor-empty:first-child]:before:float-left\",\n  \"[&_.is-editor-empty:first-child]:before:h-0 [&_.is-editor-empty:first-child]:before:text-muted-foreground\",\n  \"[&_.is-editor-empty:first-child]:before:content-[attr(data-placeholder)]\",\n  \"[&_.suggestion]:rounded-sm [&_.suggestion]:bg-muted\",\n  \"[&_.ProseMirror-gapcursor]:after:border-foreground\"\n];\n\n/** Toàn bộ lớp của phần tử gốc ProseMirror (`.tiptap`). */\nexport const MARKDOWN_EDITOR_CONTENT_CLASS = [\n  ...LAYOUT,\n  ...HEADINGS,\n  ...INLINE,\n  ...LISTS,\n  ...TASK_CHECKBOX,\n  ...BLOCKS,\n  ...SYNTAX,\n  ...TABLES,\n  ...MEDIA,\n  ...AFFORDANCES\n].join(\" \");\n"],"mappings":"AAkBA,MAAM,SAAS;AAAA,EACb;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,WAAW;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,SAAS;AAAA,EACb;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AACF;AASA,MAAM,QAAQ;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA,EAGA;AAAA,EACA;AAAA;AAAA,EAEA;AACF;AAOA,MAAM,gBAAgB;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,MAAM,SAAS;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA,EAIA;AAAA,EACA;AAAA,EACA;AACF;AAOA,MAAM,SAAS;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMA,MAAM,SAAS;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,QAAQ;AAAA,EACZ;AAAA;AAAA;AAAA,EAGA;AAAA,EACA;AAAA;AAAA,EAEA;AACF;AAQA,MAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,gCAAgC;AAAA,EAC3C,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL,EAAE,KAAK,GAAG;","names":[]}

package/dist/editor/markdown-editor-constants.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Nhãn của `MarkdownEditor` — file RIÊNG, không `"use client"`.
+ *
+ * Cùng khuôn `file-upload-constants.ts`: `verify:directives` chặn hằng dữ liệu thuần nằm trong file
+ * `"use client"` (Server Component đọc nó sẽ ra `undefined`, không lỗi, không cảnh báo). File này
+ * KHÔNG được nhập `@tiptap/*`: namespace `markdownEditor` của `src/i18n` nhập KIỂU từ đây, và i18n
+ * là tầng của entry CHÍNH — một import chạy được tới peer tuỳ chọn ở đây là kéo Tiptap vào mọi app.
+ *
+ * Chữ theo `ComitorLocaleProvider` (namespace `markdownEditor`, mặc định tiếng Anh, bảng tiếng Việt
+ * dựng sẵn); override từng khoá qua prop `labels`.
+ */
+/**
+ * Các khối chèn được bằng menu `/`. Cũng là khoá của `slashKeywords` — thêm một khối mà quên từ khoá
+ * là typecheck đỏ, không phải một khối mà gõ tiếng Việt không bao giờ tìm ra.
+ *
+ * Năm khối `table*` cuối chỉ hiện khi con trỏ ĐANG ở trong bảng: chúng là thao tác trên bảng có sẵn,
+ * không phải khối mới — nhưng menu `/` là chỗ duy nhất có trong tay khi con trỏ đứng ở một ô.
+ */
+type MarkdownEditorBlockId = "text" | "heading1" | "heading2" | "heading3" | "bulletList" | "orderedList" | "taskList" | "blockquote" | "codeBlock" | "table" | "divider" | "image" | "tableAddRow" | "tableAddColumn" | "tableDeleteRow" | "tableDeleteColumn" | "tableDelete";
+interface MarkdownEditorLabels {
+    /** Chữ mờ khi tài liệu rỗng — prop `placeholder` thắng */
+    placeholder: string;
+    /**
+     * Tên trợ năng của vùng soạn khi app KHÔNG đặt nhãn nào. Thứ tự: `aria-label` / `aria-labelledby`
+     * của app → `<label for={id}>` tìm được trong trang → khoá này.
+     */
+    editorLabel: string;
+    /** Tên của thanh định dạng nổi (`role="toolbar"`) */
+    toolbar: string;
+    bold: string;
+    italic: string;
+    strike: string;
+    code: string;
+    link: string;
+    text: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    bulletList: string;
+    orderedList: string;
+    taskList: string;
+    blockquote: string;
+    codeBlock: string;
+    table: string;
+    divider: string;
+    image: string;
+    tableAddRow: string;
+    tableAddColumn: string;
+    tableDeleteRow: string;
+    tableDeleteColumn: string;
+    tableDelete: string;
+    /** Tên của danh sách khối (`role="listbox"`) mở bằng `/` */
+    slashMenu: string;
+    /** Khi chữ gõ sau `/` không khớp khối nào */
+    slashEmpty: string;
+    /**
+     * Từ đồng nghĩa để TÌM khối, cách nhau bằng dấu cách. So khớp không dấu, không phân biệt hoa
+     * thường (cùng luật `Combobox`), cộng với tên khối và bí danh máy tiếng Anh (`h1`, `ul`, `todo`…)
+     * luôn có sẵn — nên bảng tiếng Việt chỉ cần những chữ người Việt thật sự gõ ("gạch đầu dòng").
+     */
+    slashKeywords: Record<MarkdownEditorBlockId, string>;
+    /** Nhãn (sr-only) của ô nhập địa chỉ liên kết */
+    linkInput: string;
+    linkPlaceholder: string;
+    linkApply: string;
+    linkEdit: string;
+    linkOpen: string;
+    linkRemove: string;
+    /** Khi địa chỉ không phải `http(s)` / `mailto` / `tel` — gói từ chối `javascript:` và họ hàng */
+    linkInvalid: string;
+    /** Tên của danh sách người (`role="listbox"`) mở bằng `@` */
+    mentionMenu: string;
+    mentionEmpty: string;
+    mentionLoading: string;
+    /** Tên trợ năng của ảnh đang tải lên (widget `role="img"` hiện tới khi app trả `src`) */
+    imageUploading: string;
+    /** Toast mặc định khi `onImageUpload` ném lỗi mà app không truyền `onImageUploadError` */
+    imageUploadFailed: string;
+    /**
+     * Tên trợ năng của ô tick trong danh sách việc. HÀM vì nó chèn nội dung của chính mục đó — trật tự
+     * từ là việc của từng ngôn ngữ. `text` rỗng khi mục chưa có chữ.
+     */
+    taskCheckbox: (text: string) => string;
+}
+/**
+ * Nhãn TIẾNG ANH mặc định của `MarkdownEditor`. Bảng tiếng Việt: `comitorMessagesVi.markdownEditor`.
+ * Component không đọc thẳng hằng này — nó đọc bảng của `ComitorLocaleProvider`; hằng ở đây để app
+ * trải ra khi tự dựng nhãn.
+ */
+declare const DEFAULT_MARKDOWN_EDITOR_LABELS: MarkdownEditorLabels;
+
+export { DEFAULT_MARKDOWN_EDITOR_LABELS, type MarkdownEditorBlockId, type MarkdownEditorLabels };

package/dist/editor/markdown-editor-constants.js

@@ -0,0 +1,6 @@
+import { markdownEditorEn } from "../i18n/namespaces/markdown-editor.js";
+const DEFAULT_MARKDOWN_EDITOR_LABELS = { ...markdownEditorEn };
+export {
+  DEFAULT_MARKDOWN_EDITOR_LABELS
+};
+//# sourceMappingURL=markdown-editor-constants.js.map

package/dist/editor/markdown-editor-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/markdown-editor-constants.ts"],"sourcesContent":["/**\n * Nhãn của `MarkdownEditor` — file RIÊNG, không `\"use client\"`.\n *\n * Cùng khuôn `file-upload-constants.ts`: `verify:directives` chặn hằng dữ liệu thuần nằm trong file\n * `\"use client\"` (Server Component đọc nó sẽ ra `undefined`, không lỗi, không cảnh báo). File này\n * KHÔNG được nhập `@tiptap/*`: namespace `markdownEditor` của `src/i18n` nhập KIỂU từ đây, và i18n\n * là tầng của entry CHÍNH — một import chạy được tới peer tuỳ chọn ở đây là kéo Tiptap vào mọi app.\n *\n * Chữ theo `ComitorLocaleProvider` (namespace `markdownEditor`, mặc định tiếng Anh, bảng tiếng Việt\n * dựng sẵn); override từng khoá qua prop `labels`.\n */\n\nimport { markdownEditorEn } from \"../i18n/namespaces/markdown-editor.js\";\n\n/**\n * Các khối chèn được bằng menu `/`. Cũng là khoá của `slashKeywords` — thêm một khối mà quên từ khoá\n * là typecheck đỏ, không phải một khối mà gõ tiếng Việt không bao giờ tìm ra.\n *\n * Năm khối `table*` cuối chỉ hiện khi con trỏ ĐANG ở trong bảng: chúng là thao tác trên bảng có sẵn,\n * không phải khối mới — nhưng menu `/` là chỗ duy nhất có trong tay khi con trỏ đứng ở một ô.\n */\nexport type MarkdownEditorBlockId =\n  | \"text\"\n  | \"heading1\"\n  | \"heading2\"\n  | \"heading3\"\n  | \"bulletList\"\n  | \"orderedList\"\n  | \"taskList\"\n  | \"blockquote\"\n  | \"codeBlock\"\n  | \"table\"\n  | \"divider\"\n  | \"image\"\n  | \"tableAddRow\"\n  | \"tableAddColumn\"\n  | \"tableDeleteRow\"\n  | \"tableDeleteColumn\"\n  | \"tableDelete\";\n\nexport interface MarkdownEditorLabels {\n  /** Chữ mờ khi tài liệu rỗng — prop `placeholder` thắng */\n  placeholder: string;\n  /**\n   * Tên trợ năng của vùng soạn khi app KHÔNG đặt nhãn nào. Thứ tự: `aria-label` / `aria-labelledby`\n   * của app → `<label for={id}>` tìm được trong trang → khoá này.\n   */\n  editorLabel: string;\n\n  /** Tên của thanh định dạng nổi (`role=\"toolbar\"`) */\n  toolbar: string;\n  bold: string;\n  italic: string;\n  strike: string;\n  code: string;\n  link: string;\n\n  /*\n   * Tên khối — dùng CHUNG cho nút của thanh định dạng và mục của menu `/`: cùng một thao tác thì\n   * cùng một tên ở mọi chỗ, nên không có cặp khoá \"toolbarHeading1\" / \"slashHeading1\" để lệch nhau.\n   */\n  text: string;\n  heading1: string;\n  heading2: string;\n  heading3: string;\n  bulletList: string;\n  orderedList: string;\n  taskList: string;\n  blockquote: string;\n  codeBlock: string;\n  table: string;\n  divider: string;\n  image: string;\n  tableAddRow: string;\n  tableAddColumn: string;\n  tableDeleteRow: string;\n  tableDeleteColumn: string;\n  tableDelete: string;\n\n  /** Tên của danh sách khối (`role=\"listbox\"`) mở bằng `/` */\n  slashMenu: string;\n  /** Khi chữ gõ sau `/` không khớp khối nào */\n  slashEmpty: string;\n  /**\n   * Từ đồng nghĩa để TÌM khối, cách nhau bằng dấu cách. So khớp không dấu, không phân biệt hoa\n   * thường (cùng luật `Combobox`), cộng với tên khối và bí danh máy tiếng Anh (`h1`, `ul`, `todo`…)\n   * luôn có sẵn — nên bảng tiếng Việt chỉ cần những chữ người Việt thật sự gõ (\"gạch đầu dòng\").\n   */\n  slashKeywords: Record<MarkdownEditorBlockId, string>;\n\n  /** Nhãn (sr-only) của ô nhập địa chỉ liên kết */\n  linkInput: string;\n  linkPlaceholder: string;\n  linkApply: string;\n  linkEdit: string;\n  linkOpen: string;\n  linkRemove: string;\n  /** Khi địa chỉ không phải `http(s)` / `mailto` / `tel` — gói từ chối `javascript:` và họ hàng */\n  linkInvalid: string;\n\n  /** Tên của danh sách người (`role=\"listbox\"`) mở bằng `@` */\n  mentionMenu: string;\n  mentionEmpty: string;\n  mentionLoading: string;\n\n  /** Tên trợ năng của ảnh đang tải lên (widget `role=\"img\"` hiện tới khi app trả `src`) */\n  imageUploading: string;\n  /** Toast mặc định khi `onImageUpload` ném lỗi mà app không truyền `onImageUploadError` */\n  imageUploadFailed: string;\n\n  /**\n   * Tên trợ năng của ô tick trong danh sách việc. HÀM vì nó chèn nội dung của chính mục đó — trật tự\n   * từ là việc của từng ngôn ngữ. `text` rỗng khi mục chưa có chữ.\n   */\n  taskCheckbox: (text: string) => string;\n}\n\n/**\n * Nhãn TIẾNG ANH mặc định của `MarkdownEditor`. Bảng tiếng Việt: `comitorMessagesVi.markdownEditor`.\n * Component không đọc thẳng hằng này — nó đọc bảng của `ComitorLocaleProvider`; hằng ở đây để app\n * trải ra khi tự dựng nhãn.\n */\nexport const DEFAULT_MARKDOWN_EDITOR_LABELS: MarkdownEditorLabels = { ...markdownEditorEn };\n"],"mappings":"AAYA,SAAS,wBAAwB;AA8G1B,MAAM,iCAAuD,EAAE,GAAG,iBAAiB;","names":[]}