@comitor/ui 3.4.0 → 3.6.0

package/dist/editor/suggestion-store.js

@@ -0,0 +1,49 @@
+import { exitSuggestion } from "@tiptap/suggestion";
+class SuggestionStore {
+  constructor(pluginKey, toSelected) {
+    this.pluginKey = pluginKey;
+    this.toSelected = toSelected;
+  }
+  pluginKey;
+  toSelected;
+  snapshot = null;
+  listeners = /* @__PURE__ */ new Set();
+  /**
+   * Bàn phím trong lúc menu mở: ProseMirror nhận phím (con trỏ vẫn ở trình soạn), plugin chuyển cho
+   * hàm này. Menu đăng ký nó khi mount. Trả `true` = đã xử lý, ProseMirror không làm gì thêm.
+   */
+  keyHandler = null;
+  subscribe = (listener) => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  getSnapshot = () => this.snapshot;
+  getServerSnapshot = () => null;
+  set(next) {
+    this.snapshot = next;
+    for (const listener of this.listeners) listener();
+  }
+  fromProps(props) {
+    return {
+      items: props.items,
+      query: props.query,
+      loading: props.loading,
+      clientRect: () => props.clientRect?.() ?? null,
+      select: (item) => props.command(this.toSelected(item)),
+      exit: () => exitSuggestion(props.editor.view, this.pluginKey)
+    };
+  }
+  /** Truyền thẳng vào `render` của `Suggestion` / `Mention.suggestion`. */
+  render = () => ({
+    onStart: (props) => this.set(this.fromProps(props)),
+    onUpdate: (props) => this.set(this.fromProps(props)),
+    onExit: () => this.set(null),
+    onKeyDown: ({ event }) => this.keyHandler?.(event) ?? false
+  });
+}
+export {
+  SuggestionStore
+};
+//# sourceMappingURL=suggestion-store.js.map

package/dist/editor/suggestion-store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/suggestion-store.ts"],"sourcesContent":["/**\n * Cầu nối giữa plugin gợi ý của Tiptap (`@tiptap/suggestion` — vòng đời onStart/onUpdate/onExit,\n * sống trong ProseMirror) và một component React (`SuggestionMenu`).\n *\n * Không dùng `ReactRenderer` + `props.mount()` như ví dụ của Tiptap: cách đó gắn danh sách vào\n * `document.body` ngoài mọi lớp Radix, và trong một `Dialog` (form tạo việc) thì Radix coi cú bấm\n * vào danh sách là bấm RA NGOÀI hộp thoại — hộp thoại đóng ngay giữa lúc chọn khối. Ở đây plugin\n * chỉ ĐẨY trạng thái vào một kho nhỏ; menu là cây React bình thường của trình soạn, mở bằng `Popover`\n * của gói — một lớp Radix lồng đúng thứ bậc, nên Escape đóng menu chứ không đóng hộp thoại.\n */\n\nimport type { PluginKey } from \"@tiptap/pm/state\";\nimport { exitSuggestion, type SuggestionOptions, type SuggestionProps } from \"@tiptap/suggestion\";\n\nexport interface SuggestionSnapshot<Item> {\n  items: Item[];\n  /** Chữ gõ sau ký tự kích hoạt */\n  query: string;\n  /** `true` khi `items()` bất đồng bộ chưa trả về */\n  loading: boolean;\n  /** Khung của đoạn đang gõ (`/que…`) — neo cho menu. `null` khi plugin chưa vẽ xong decoration. */\n  clientRect: () => DOMRect | null;\n  select: (item: Item) => void;\n  /** Thoát hẳn chế độ gợi ý (gỡ decoration) — dùng khi menu bị đóng từ PHÍA MENU (Escape, bấm ra ngoài). */\n  exit: () => void;\n}\n\nexport class SuggestionStore<Item, Selected = Item> {\n  private snapshot: SuggestionSnapshot<Item> | null = null;\n  private readonly listeners = new Set<() => void>();\n\n  /**\n   * Bàn phím trong lúc menu mở: ProseMirror nhận phím (con trỏ vẫn ở trình soạn), plugin chuyển cho\n   * hàm này. Menu đăng ký nó khi mount. Trả `true` = đã xử lý, ProseMirror không làm gì thêm.\n   */\n  keyHandler: ((event: KeyboardEvent) => boolean) | null = null;\n\n  constructor(\n    private readonly pluginKey: PluginKey,\n    private readonly toSelected: (item: Item) => Selected\n  ) {}\n\n  subscribe = (listener: () => void) => {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  };\n\n  getSnapshot = () => this.snapshot;\n\n  getServerSnapshot = () => null;\n\n  private set(next: SuggestionSnapshot<Item> | null) {\n    this.snapshot = next;\n    for (const listener of this.listeners) listener();\n  }\n\n  private fromProps(props: SuggestionProps<Item, Selected>): SuggestionSnapshot<Item> {\n    return {\n      items: props.items,\n      query: props.query,\n      loading: props.loading,\n      clientRect: () => props.clientRect?.() ?? null,\n      select: (item) => props.command(this.toSelected(item)),\n      exit: () => exitSuggestion(props.editor.view, this.pluginKey)\n    };\n  }\n\n  /** Truyền thẳng vào `render` của `Suggestion` / `Mention.suggestion`. */\n  render: NonNullable<SuggestionOptions<Item, Selected>[\"render\"]> = () => ({\n    onStart: (props) => this.set(this.fromProps(props)),\n    onUpdate: (props) => this.set(this.fromProps(props)),\n    onExit: () => this.set(null),\n    onKeyDown: ({ event }) => this.keyHandler?.(event) ?? false\n  });\n}\n"],"mappings":"AAYA,SAAS,sBAAoE;AAetE,MAAM,gBAAuC;AAAA,EAUlD,YACmB,WACA,YACjB;AAFiB;AACA;AAAA,EAChB;AAAA,EAFgB;AAAA,EACA;AAAA,EAXX,WAA4C;AAAA,EACnC,YAAY,oBAAI,IAAgB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMjD,aAAyD;AAAA,EAOzD,YAAY,CAAC,aAAyB;AACpC,SAAK,UAAU,IAAI,QAAQ;AAC3B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AAAA,EAEA,cAAc,MAAM,KAAK;AAAA,EAEzB,oBAAoB,MAAM;AAAA,EAElB,IAAI,MAAuC;AACjD,SAAK,WAAW;AAChB,eAAW,YAAY,KAAK,UAAW,UAAS;AAAA,EAClD;AAAA,EAEQ,UAAU,OAAkE;AAClF,WAAO;AAAA,MACL,OAAO,MAAM;AAAA,MACb,OAAO,MAAM;AAAA,MACb,SAAS,MAAM;AAAA,MACf,YAAY,MAAM,MAAM,aAAa,KAAK;AAAA,MAC1C,QAAQ,CAAC,SAAS,MAAM,QAAQ,KAAK,WAAW,IAAI,CAAC;AAAA,MACrD,MAAM,MAAM,eAAe,MAAM,OAAO,MAAM,KAAK,SAAS;AAAA,IAC9D;AAAA,EACF;AAAA;AAAA,EAGA,SAAmE,OAAO;AAAA,IACxE,SAAS,CAAC,UAAU,KAAK,IAAI,KAAK,UAAU,KAAK,CAAC;AAAA,IAClD,UAAU,CAAC,UAAU,KAAK,IAAI,KAAK,UAAU,KAAK,CAAC;AAAA,IACnD,QAAQ,MAAM,KAAK,IAAI,IAAI;AAAA,IAC3B,WAAW,CAAC,EAAE,MAAM,MAAM,KAAK,aAAa,KAAK,KAAK;AAAA,EACxD;AACF;","names":[]}

package/dist/editor/toolbar-actions.d.ts

@@ -0,0 +1,44 @@
+import { Editor } from '@tiptap/core';
+import { LucideIcon } from 'lucide-react';
+import { f as EditorFormat } from '../editor-types-BMST7-VR.js';
+import { MarkdownEditorLabels } from './markdown-editor-constants.js';
+
+/**
+ * Hành động của thanh công cụ — MỘT bảng cho cả thanh nổi (`bubble-toolbar.tsx`) lẫn thanh cố định
+ * (`fixed-toolbar.tsx`). Hai bảng riêng là hai nơi để lệch: nút In đậm ở thanh này có phím tắt, ở
+ * thanh kia thì không.
+ *
+ * File thuần (không `"use client"`): dữ liệu — icon là component, `run` là hàm. Chữ hiển thị không
+ * nằm ở đây; `label` là KHOÁ của namespace `markdownEditor`.
+ */
+
+/** Khoá nhãn mang CHUỖI (loại `slashKeywords` và hàm `taskCheckbox`). */
+type TextLabelKey = {
+    [K in keyof MarkdownEditorLabels]: MarkdownEditorLabels[K] extends string ? K : never;
+}[keyof MarkdownEditorLabels];
+interface ToolbarAction {
+    id: string;
+    icon: LucideIcon;
+    label: TextLabelKey;
+    /** Phím tắt cho tooltip — cú pháp của `KeyboardHint` (`mod+b`). Mặc định của Tiptap. */
+    keys?: string;
+    /**
+     * Chỉ có ở những định dạng này. Bỏ trống = có ở cả hai. Gạch chân chỉ ở HTML: markdown không có cú
+     * pháp cho nó (lý do ở `createSchemaExtensions`).
+     */
+    formats?: readonly EditorFormat[];
+    /** Có thì nút là nút BẬT/TẮT (`aria-pressed`); không có thì là nút lệnh. */
+    isActive?: (editor: Editor) => boolean;
+    /** `false` = nút bị khoá (hoàn tác khi chưa có gì để hoàn tác, chèn bảng khi đang ở trong bảng). */
+    canRun?: (editor: Editor) => boolean;
+    run: (editor: Editor) => void;
+}
+declare const HISTORY_ACTIONS: readonly ToolbarAction[];
+declare const MARK_ACTIONS: readonly ToolbarAction[];
+declare const BLOCK_ACTIONS: readonly ToolbarAction[];
+/** Chèn — chỉ thanh cố định có (thanh nổi chỉ hiện khi đã bôi chọn chữ, không phải lúc để chèn khối). */
+declare const INSERT_ACTIONS: readonly ToolbarAction[];
+/** Các hành động có ở `format`. */
+declare function actionsFor(actions: readonly ToolbarAction[], format: EditorFormat): ToolbarAction[];
+
+export { BLOCK_ACTIONS, HISTORY_ACTIONS, INSERT_ACTIONS, MARK_ACTIONS, type TextLabelKey, type ToolbarAction, actionsFor };

package/dist/editor/toolbar-actions.js

@@ -0,0 +1,173 @@
+import {
+  Bold,
+  Code,
+  Heading1,
+  Heading2,
+  Heading3,
+  Italic,
+  List,
+  ListChecks,
+  ListOrdered,
+  Minus,
+  Redo2,
+  SquareCode,
+  Strikethrough,
+  Table,
+  TextQuote,
+  Underline,
+  Undo2
+} from "lucide-react";
+const HISTORY_ACTIONS = [
+  {
+    id: "undo",
+    icon: Undo2,
+    label: "undo",
+    keys: "mod+z",
+    canRun: (editor) => editor.can().undo(),
+    run: (editor) => editor.chain().focus().undo().run()
+  },
+  {
+    id: "redo",
+    icon: Redo2,
+    label: "redo",
+    keys: "mod+shift+z",
+    canRun: (editor) => editor.can().redo(),
+    run: (editor) => editor.chain().focus().redo().run()
+  }
+];
+const MARK_ACTIONS = [
+  {
+    id: "bold",
+    icon: Bold,
+    label: "bold",
+    keys: "mod+b",
+    isActive: (editor) => editor.isActive("bold"),
+    run: (editor) => editor.chain().focus().toggleBold().run()
+  },
+  {
+    id: "italic",
+    icon: Italic,
+    label: "italic",
+    keys: "mod+i",
+    isActive: (editor) => editor.isActive("italic"),
+    run: (editor) => editor.chain().focus().toggleItalic().run()
+  },
+  {
+    id: "underline",
+    icon: Underline,
+    label: "underline",
+    keys: "mod+u",
+    formats: ["html"],
+    isActive: (editor) => editor.isActive("underline"),
+    run: (editor) => editor.chain().focus().toggleUnderline().run()
+  },
+  {
+    id: "strike",
+    icon: Strikethrough,
+    label: "strike",
+    keys: "mod+shift+s",
+    isActive: (editor) => editor.isActive("strike"),
+    run: (editor) => editor.chain().focus().toggleStrike().run()
+  },
+  {
+    id: "code",
+    icon: Code,
+    label: "code",
+    keys: "mod+e",
+    isActive: (editor) => editor.isActive("code"),
+    run: (editor) => editor.chain().focus().toggleCode().run()
+  }
+];
+const BLOCK_ACTIONS = [
+  {
+    id: "heading1",
+    icon: Heading1,
+    label: "heading1",
+    keys: "mod+alt+1",
+    isActive: (editor) => editor.isActive("heading", { level: 1 }),
+    run: (editor) => editor.chain().focus().toggleHeading({ level: 1 }).run()
+  },
+  {
+    id: "heading2",
+    icon: Heading2,
+    label: "heading2",
+    keys: "mod+alt+2",
+    isActive: (editor) => editor.isActive("heading", { level: 2 }),
+    run: (editor) => editor.chain().focus().toggleHeading({ level: 2 }).run()
+  },
+  {
+    id: "heading3",
+    icon: Heading3,
+    label: "heading3",
+    keys: "mod+alt+3",
+    isActive: (editor) => editor.isActive("heading", { level: 3 }),
+    run: (editor) => editor.chain().focus().toggleHeading({ level: 3 }).run()
+  },
+  {
+    id: "bulletList",
+    icon: List,
+    label: "bulletList",
+    keys: "mod+shift+8",
+    isActive: (editor) => editor.isActive("bulletList"),
+    run: (editor) => editor.chain().focus().toggleBulletList().run()
+  },
+  {
+    id: "orderedList",
+    icon: ListOrdered,
+    label: "orderedList",
+    keys: "mod+shift+7",
+    isActive: (editor) => editor.isActive("orderedList"),
+    run: (editor) => editor.chain().focus().toggleOrderedList().run()
+  },
+  {
+    id: "taskList",
+    icon: ListChecks,
+    label: "taskList",
+    keys: "mod+shift+9",
+    isActive: (editor) => editor.isActive("taskList"),
+    run: (editor) => editor.chain().focus().toggleTaskList().run()
+  },
+  {
+    id: "blockquote",
+    icon: TextQuote,
+    label: "blockquote",
+    keys: "mod+shift+b",
+    isActive: (editor) => editor.isActive("blockquote"),
+    run: (editor) => editor.chain().focus().toggleBlockquote().run()
+  },
+  {
+    id: "codeBlock",
+    icon: SquareCode,
+    label: "codeBlock",
+    keys: "mod+alt+c",
+    isActive: (editor) => editor.isActive("codeBlock"),
+    run: (editor) => editor.chain().focus().toggleCodeBlock().run()
+  }
+];
+const INSERT_ACTIONS = [
+  {
+    id: "table",
+    icon: Table,
+    label: "table",
+    // Không lồng bảng trong bảng: GFM không có, và một bảng trong ô bảng hiếm khi là điều người soạn muốn.
+    canRun: (editor) => !editor.isActive("table"),
+    run: (editor) => editor.chain().focus().insertTable({ rows: 3, cols: 3, withHeaderRow: true }).run()
+  },
+  {
+    id: "divider",
+    icon: Minus,
+    label: "divider",
+    run: (editor) => editor.chain().focus().setHorizontalRule().run()
+  }
+];
+function actionsFor(actions, format) {
+  return actions.filter((action) => !action.formats || action.formats.includes(format));
+}
+export {
+  BLOCK_ACTIONS,
+  HISTORY_ACTIONS,
+  INSERT_ACTIONS,
+  MARK_ACTIONS,
+  actionsFor
+};
+//# sourceMappingURL=toolbar-actions.js.map

package/dist/editor/toolbar-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/toolbar-actions.ts"],"sourcesContent":["/**\n * Hành động của thanh công cụ — MỘT bảng cho cả thanh nổi (`bubble-toolbar.tsx`) lẫn thanh cố định\n * (`fixed-toolbar.tsx`). Hai bảng riêng là hai nơi để lệch: nút In đậm ở thanh này có phím tắt, ở\n * thanh kia thì không.\n *\n * File thuần (không `\"use client\"`): dữ liệu — icon là component, `run` là hàm. Chữ hiển thị không\n * nằm ở đây; `label` là KHOÁ của namespace `markdownEditor`.\n */\n\nimport type { Editor } from \"@tiptap/core\";\nimport {\n  Bold,\n  Code,\n  Heading1,\n  Heading2,\n  Heading3,\n  Italic,\n  List,\n  ListChecks,\n  ListOrdered,\n  type LucideIcon,\n  Minus,\n  Redo2,\n  SquareCode,\n  Strikethrough,\n  Table,\n  TextQuote,\n  Underline,\n  Undo2\n} from \"lucide-react\";\nimport type { EditorFormat } from \"./editor-types.js\";\nimport type { MarkdownEditorLabels } from \"./markdown-editor-constants.js\";\n\n/** Khoá nhãn mang CHUỖI (loại `slashKeywords` và hàm `taskCheckbox`). */\nexport type TextLabelKey = {\n  [K in keyof MarkdownEditorLabels]: MarkdownEditorLabels[K] extends string ? K : never;\n}[keyof MarkdownEditorLabels];\n\nexport interface ToolbarAction {\n  id: string;\n  icon: LucideIcon;\n  label: TextLabelKey;\n  /** Phím tắt cho tooltip — cú pháp của `KeyboardHint` (`mod+b`). Mặc định của Tiptap. */\n  keys?: string;\n  /**\n   * Chỉ có ở những định dạng này. Bỏ trống = có ở cả hai. Gạch chân chỉ ở HTML: markdown không có cú\n   * pháp cho nó (lý do ở `createSchemaExtensions`).\n   */\n  formats?: readonly EditorFormat[];\n  /** Có thì nút là nút BẬT/TẮT (`aria-pressed`); không có thì là nút lệnh. */\n  isActive?: (editor: Editor) => boolean;\n  /** `false` = nút bị khoá (hoàn tác khi chưa có gì để hoàn tác, chèn bảng khi đang ở trong bảng). */\n  canRun?: (editor: Editor) => boolean;\n  run: (editor: Editor) => void;\n}\n\nexport const HISTORY_ACTIONS: readonly ToolbarAction[] = [\n  {\n    id: \"undo\",\n    icon: Undo2,\n    label: \"undo\",\n    keys: \"mod+z\",\n    canRun: (editor) => editor.can().undo(),\n    run: (editor) => editor.chain().focus().undo().run()\n  },\n  {\n    id: \"redo\",\n    icon: Redo2,\n    label: \"redo\",\n    keys: \"mod+shift+z\",\n    canRun: (editor) => editor.can().redo(),\n    run: (editor) => editor.chain().focus().redo().run()\n  }\n];\n\nexport const MARK_ACTIONS: readonly ToolbarAction[] = [\n  {\n    id: \"bold\",\n    icon: Bold,\n    label: \"bold\",\n    keys: \"mod+b\",\n    isActive: (editor) => editor.isActive(\"bold\"),\n    run: (editor) => editor.chain().focus().toggleBold().run()\n  },\n  {\n    id: \"italic\",\n    icon: Italic,\n    label: \"italic\",\n    keys: \"mod+i\",\n    isActive: (editor) => editor.isActive(\"italic\"),\n    run: (editor) => editor.chain().focus().toggleItalic().run()\n  },\n  {\n    id: \"underline\",\n    icon: Underline,\n    label: \"underline\",\n    keys: \"mod+u\",\n    formats: [\"html\"],\n    isActive: (editor) => editor.isActive(\"underline\"),\n    run: (editor) => editor.chain().focus().toggleUnderline().run()\n  },\n  {\n    id: \"strike\",\n    icon: Strikethrough,\n    label: \"strike\",\n    keys: \"mod+shift+s\",\n    isActive: (editor) => editor.isActive(\"strike\"),\n    run: (editor) => editor.chain().focus().toggleStrike().run()\n  },\n  {\n    id: \"code\",\n    icon: Code,\n    label: \"code\",\n    keys: \"mod+e\",\n    isActive: (editor) => editor.isActive(\"code\"),\n    run: (editor) => editor.chain().focus().toggleCode().run()\n  }\n];\n\n/*\n * Đổi khối. Thanh nổi ẩn nhóm này ở màn hẹp, và ở trong bảng của trình soạn MARKDOWN (ô bảng GFM chỉ\n * chứa một đoạn văn — xem `ComitorTableCell`); ô bảng HTML chứa được khối nên nhóm vẫn hiện.\n */\nexport const BLOCK_ACTIONS: readonly ToolbarAction[] = [\n  {\n    id: \"heading1\",\n    icon: Heading1,\n    label: \"heading1\",\n    keys: \"mod+alt+1\",\n    isActive: (editor) => editor.isActive(\"heading\", { level: 1 }),\n    run: (editor) => editor.chain().focus().toggleHeading({ level: 1 }).run()\n  },\n  {\n    id: \"heading2\",\n    icon: Heading2,\n    label: \"heading2\",\n    keys: \"mod+alt+2\",\n    isActive: (editor) => editor.isActive(\"heading\", { level: 2 }),\n    run: (editor) => editor.chain().focus().toggleHeading({ level: 2 }).run()\n  },\n  {\n    id: \"heading3\",\n    icon: Heading3,\n    label: \"heading3\",\n    keys: \"mod+alt+3\",\n    isActive: (editor) => editor.isActive(\"heading\", { level: 3 }),\n    run: (editor) => editor.chain().focus().toggleHeading({ level: 3 }).run()\n  },\n  {\n    id: \"bulletList\",\n    icon: List,\n    label: \"bulletList\",\n    keys: \"mod+shift+8\",\n    isActive: (editor) => editor.isActive(\"bulletList\"),\n    run: (editor) => editor.chain().focus().toggleBulletList().run()\n  },\n  {\n    id: \"orderedList\",\n    icon: ListOrdered,\n    label: \"orderedList\",\n    keys: \"mod+shift+7\",\n    isActive: (editor) => editor.isActive(\"orderedList\"),\n    run: (editor) => editor.chain().focus().toggleOrderedList().run()\n  },\n  {\n    id: \"taskList\",\n    icon: ListChecks,\n    label: \"taskList\",\n    keys: \"mod+shift+9\",\n    isActive: (editor) => editor.isActive(\"taskList\"),\n    run: (editor) => editor.chain().focus().toggleTaskList().run()\n  },\n  {\n    id: \"blockquote\",\n    icon: TextQuote,\n    label: \"blockquote\",\n    keys: \"mod+shift+b\",\n    isActive: (editor) => editor.isActive(\"blockquote\"),\n    run: (editor) => editor.chain().focus().toggleBlockquote().run()\n  },\n  {\n    id: \"codeBlock\",\n    icon: SquareCode,\n    label: \"codeBlock\",\n    keys: \"mod+alt+c\",\n    isActive: (editor) => editor.isActive(\"codeBlock\"),\n    run: (editor) => editor.chain().focus().toggleCodeBlock().run()\n  }\n];\n\n/** Chèn — chỉ thanh cố định có (thanh nổi chỉ hiện khi đã bôi chọn chữ, không phải lúc để chèn khối). */\nexport const INSERT_ACTIONS: readonly ToolbarAction[] = [\n  {\n    id: \"table\",\n    icon: Table,\n    label: \"table\",\n    // Không lồng bảng trong bảng: GFM không có, và một bảng trong ô bảng hiếm khi là điều người soạn muốn.\n    canRun: (editor) => !editor.isActive(\"table\"),\n    run: (editor) => editor.chain().focus().insertTable({ rows: 3, cols: 3, withHeaderRow: true }).run()\n  },\n  {\n    id: \"divider\",\n    icon: Minus,\n    label: \"divider\",\n    run: (editor) => editor.chain().focus().setHorizontalRule().run()\n  }\n];\n\n/** Các hành động có ở `format`. */\nexport function actionsFor(actions: readonly ToolbarAction[], format: EditorFormat): ToolbarAction[] {\n  return actions.filter((action) => !action.formats || action.formats.includes(format));\n}\n"],"mappings":"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","names":[]}

package/dist/editor/toolbar-button.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+
+interface ToolbarButtonProps {
+    icon: LucideIcon;
+    label: string;
+    keys?: string;
+    pressed?: boolean;
+    disabled?: boolean;
+    onClick: () => void;
+    className?: string;
+}
+declare function ToolbarButton({ icon: Icon, label, keys, pressed, disabled, onClick, className }: ToolbarButtonProps): React.JSX.Element;
+
+export { ToolbarButton, type ToolbarButtonProps };

package/dist/editor/toolbar-button.js

@@ -0,0 +1,47 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { KeyboardHint } from "../components/composite/keyboard-hint.js";
+import { Toggle } from "../components/ui/toggle.js";
+import { Tooltip, TooltipContent, TooltipTrigger } from "../components/ui/tooltip.js";
+import { cn } from "../lib/cn.js";
+const BUTTON_CLASS = "h-7 min-w-7 px-1.5";
+function ToolbarButton({ icon: Icon, label, keys, pressed, disabled, onClick, className }) {
+  const button = pressed === void 0 ? /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      "aria-label": label,
+      disabled,
+      onMouseDown: (event) => event.preventDefault(),
+      onClick,
+      className: cn(
+        "inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors duration-150 ease-out hover:bg-muted hover:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4 [&_svg]:shrink-0",
+        BUTTON_CLASS,
+        className
+      ),
+      children: /* @__PURE__ */ jsx(Icon, { "aria-hidden": "true" })
+    }
+  ) : /* @__PURE__ */ jsx(
+    Toggle,
+    {
+      "aria-label": label,
+      pressed,
+      disabled,
+      onPressedChange: onClick,
+      onMouseDown: (event) => event.preventDefault(),
+      className: cn(BUTTON_CLASS, className),
+      children: /* @__PURE__ */ jsx(Icon, { "aria-hidden": "true" })
+    }
+  );
+  return /* @__PURE__ */ jsxs(Tooltip, { delayDuration: 400, children: [
+    /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: disabled ? /* @__PURE__ */ jsx("span", { className: "inline-flex", children: button }) : button }),
+    /* @__PURE__ */ jsxs(TooltipContent, { side: "top", sideOffset: 6, className: "flex items-center gap-2", children: [
+      label,
+      keys && /* @__PURE__ */ jsx(KeyboardHint, { keys, compact: true })
+    ] })
+  ] });
+}
+export {
+  ToolbarButton
+};
+//# sourceMappingURL=toolbar-button.js.map

package/dist/editor/toolbar-button.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/toolbar-button.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * Nút của thanh công cụ — dùng chung cho thanh nổi và thanh cố định.\n *\n * Nhỏ hơn `Toggle size=\"sm\"` một bậc (28px): mười mấy nút phải nằm gọn trên một dòng ở màn laptop.\n * Mousedown bị chặn để focus Ở LẠI vùng soạn — mất focus là mất vùng chọn mà nút sắp áp định dạng lên.\n * Nút có `pressed` là nút BẬT/TẮT (`Toggle`, `aria-pressed`); không có là nút lệnh.\n */\n\nimport type { LucideIcon } from \"lucide-react\";\nimport { KeyboardHint } from \"../components/composite/keyboard-hint.js\";\nimport { Toggle } from \"../components/ui/toggle.js\";\nimport { Tooltip, TooltipContent, TooltipTrigger } from \"../components/ui/tooltip.js\";\nimport { cn } from \"../lib/cn.js\";\n\nconst BUTTON_CLASS = \"h-7 min-w-7 px-1.5\";\n\nexport interface ToolbarButtonProps {\n  icon: LucideIcon;\n  label: string;\n  keys?: string;\n  pressed?: boolean;\n  disabled?: boolean;\n  onClick: () => void;\n  className?: string;\n}\n\nexport function ToolbarButton({ icon: Icon, label, keys, pressed, disabled, onClick, className }: ToolbarButtonProps) {\n  const button =\n    pressed === undefined ? (\n      <button\n        type=\"button\"\n        aria-label={label}\n        disabled={disabled}\n        onMouseDown={(event) => event.preventDefault()}\n        onClick={onClick}\n        className={cn(\n          \"inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors duration-150 ease-out hover:bg-muted hover:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 [&_svg]:size-4 [&_svg]:shrink-0\",\n          BUTTON_CLASS,\n          className\n        )}\n      >\n        <Icon aria-hidden=\"true\" />\n      </button>\n    ) : (\n      <Toggle\n        aria-label={label}\n        pressed={pressed}\n        disabled={disabled}\n        onPressedChange={onClick}\n        onMouseDown={(event) => event.preventDefault()}\n        className={cn(BUTTON_CLASS, className)}\n      >\n        <Icon aria-hidden=\"true\" />\n      </Toggle>\n    );\n\n  return (\n    <Tooltip delayDuration={400}>\n      {/*\n        Nút đang khoá không phát sự kiện chuột, nên tooltip của nó neo vào một `span` bọc ngoài. Nút\n        bình thường thì CHÍNH nó là trigger — để tooltip cũng hiện khi focus bằng bàn phím.\n      */}\n      <TooltipTrigger asChild>{disabled ? <span className=\"inline-flex\">{button}</span> : button}</TooltipTrigger>\n      <TooltipContent side=\"top\" sideOffset={6} className=\"flex items-center gap-2\">\n        {label}\n        {keys && <KeyboardHint keys={keys} compact />}\n      </TooltipContent>\n    </Tooltip>\n  );\n}\n"],"mappings":";AA2CQ,cAsBF,YAtBE;AAhCR,SAAS,oBAAoB;AAC7B,SAAS,cAAc;AACvB,SAAS,SAAS,gBAAgB,sBAAsB;AACxD,SAAS,UAAU;AAEnB,MAAM,eAAe;AAYd,SAAS,cAAc,EAAE,MAAM,MAAM,OAAO,MAAM,SAAS,UAAU,SAAS,UAAU,GAAuB;AACpH,QAAM,SACJ,YAAY,SACV;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,cAAY;AAAA,MACZ;AAAA,MACA,aAAa,CAAC,UAAU,MAAM,eAAe;AAAA,MAC7C;AAAA,MACA,WAAW;AAAA,QACT;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MAEA,8BAAC,QAAK,eAAY,QAAO;AAAA;AAAA,EAC3B,IAEA;AAAA,IAAC;AAAA;AAAA,MACC,cAAY;AAAA,MACZ;AAAA,MACA;AAAA,MACA,iBAAiB;AAAA,MACjB,aAAa,CAAC,UAAU,MAAM,eAAe;AAAA,MAC7C,WAAW,GAAG,cAAc,SAAS;AAAA,MAErC,8BAAC,QAAK,eAAY,QAAO;AAAA;AAAA,EAC3B;AAGJ,SACE,qBAAC,WAAQ,eAAe,KAKtB;AAAA,wBAAC,kBAAe,SAAO,MAAE,qBAAW,oBAAC,UAAK,WAAU,eAAe,kBAAO,IAAU,QAAO;AAAA,IAC3F,qBAAC,kBAAe,MAAK,OAAM,YAAY,GAAG,WAAU,2BACjD;AAAA;AAAA,MACA,QAAQ,oBAAC,gBAAa,MAAY,SAAO,MAAC;AAAA,OAC7C;AAAA,KACF;AAEJ;","names":[]}

package/dist/editor-types-BMST7-VR.d.ts

@@ -0,0 +1,171 @@
+import { Extension, Editor, AnyExtension } from '@tiptap/core';
+import { MarkdownEditorLabels } from './editor/markdown-editor-constants.js';
+
+/**
+ * Ả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 dạng lưu — ô bảng markdown không nhận ảnh (xem `blockInsertPosition`). Mặc định `markdown`. */
+    format?: EditorFormat;
+}
+/** Ả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;
+
+/**
+ * Kiểu dùng CHUNG cho hai trình soạn của entry — `MarkdownEditor` (lưu markdown) và `RichTextEditor`
+ * (lưu HTML). Chỉ kiểu, không mã chạy.
+ *
+ * Tên `MarkdownEditor…` của các kiểu nhắc tên / biến thể là tên đã publish ở `3.5.0`, trước khi có
+ * trình soạn thứ hai. Giữ nguyên (đổi tên là breaking) — cả hai trình soạn dùng chung chúng.
+ */
+
+/** Định dạng LƯU — thứ `value`/`onChange` mang. Quyết định cả lược đồ (xem `createSchemaExtensions`). */
+type EditorFormat = "markdown" | "html";
+/**
+ * Thanh công cụ:
+ *   · `bubble` — kiểu Linear: không chiếm chỗ, định dạng hiện ngay chỗ bôi chọn;
+ *   · `fixed`  — thanh dính đầu khung soạn, mọi thao tác luôn thấy được: kiểu CMS, cho người soạn
+ *     không thuộc phím tắt hay cú pháp gõ tắt. Ở chế độ này bong bóng chỉ còn phần LIÊN KẾT.
+ */
+type EditorToolbarMode = "bubble" | "fixed";
+/** Một người trong danh sách `@`. */
+interface MarkdownEditorMentionItem {
+    /** Định danh LƯU vào nội dung — với module Comitor là id người dùng của Account */
+    id: string;
+    /** Tên hiển thị lúc chọn — cũng là ảnh chụp tên ghi kèm trong nội dung */
+    label: string;
+    /** Dòng phụ mờ bên phải (email, chức danh) — cũng được dùng để lọc */
+    description?: string;
+    avatarUrl?: string | null;
+}
+/**
+ * Nguồn danh sách `@`:
+ *   · MẢNG — gói tự lọc theo tên/dòng phụ, không dấu (cùng luật `Combobox`), tối đa 50 người;
+ *   · HÀM — app tự tìm (gọi API danh bạ…). `signal` bị huỷ khi người dùng gõ tiếp; gói chờ 150ms
+ *     sau phím cuối mới gọi. (Kiểu nguồn xét LÚC MOUNT — độ trễ là tuỳ chọn dựng của plugin.)
+ */
+type MarkdownEditorMentionSource = readonly MarkdownEditorMentionItem[] | ((query: string, options: {
+    signal: AbortSignal;
+}) => readonly MarkdownEditorMentionItem[] | Promise<readonly MarkdownEditorMentionItem[]>);
+interface MarkdownEditorMentions {
+    items: MarkdownEditorMentionSource;
+    /**
+     * Tên SỐNG theo id, dùng lúc VẼ. Nội dung giữ tên chụp lúc nhắc; người đó đổi tên ở Account thì
+     * hàm này cho tên mới mà không phải sửa nội dung. `undefined` → rơi về tên chụp.
+     */
+    resolveLabel?: (id: string) => string | undefined;
+}
+type MarkdownEditorVariant = "outline" | "ghost";
+/** Phần điều khiển chung của hai handle — mỗi trình soạn thêm cặp đọc/ghi theo định dạng của nó. */
+interface EditorHandleBase {
+    focus: (position?: "start" | "end") => void;
+    /** Xoá trắng — vd sau khi gửi bình luận. Có gọi `onChange("")`. */
+    clear: () => void;
+    isEmpty: () => boolean;
+    /**
+     * Còn ảnh đang tải lên không. Ảnh chưa tải xong KHÔNG có trong giá trị — nút Gửi nên chờ (hoặc
+     * khoá) khi hàm này trả `true`, nếu không nội dung đi mà thiếu ảnh.
+     */
+    isUploading: () => boolean;
+    /** Bản Tiptap bên dưới — lối thoát cho nhu cầu gói chưa phủ. `null` trước lần render đầu ở client. */
+    readonly editor: Editor | null;
+}
+/** Prop CHUNG của hai trình soạn — mọi thứ trừ cặp giá trị (`value`/`defaultValue`/`onChange`) và `ref`. */
+interface EditorBaseProps {
+    /**
+     * ⌘/Ctrl+Enter (ngoài danh sách việc — ở đó phím này tick mục). Cho ô bình luận; không truyền thì
+     * phím giữ nghĩa mặc định.
+     */
+    onSubmit?: () => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+    /** Chữ mờ khi rỗng. Mặc định theo `ComitorLocaleProvider`. */
+    placeholder?: string;
+    /** `false` = chế độ ĐỌC: không con trỏ, không menu, liên kết bấm mở được. Đổi lúc chạy được. */
+    editable?: boolean;
+    autoFocus?: boolean;
+    /**
+     * `outline` (mặc định) — khung như `Textarea`, cho biểu mẫu và ô bình luận.
+     * `ghost` — không khung, không đệm: tài liệu nằm thẳng trên trang, kiểu mô tả việc của Linear.
+     */
+    variant?: MarkdownEditorVariant;
+    /** Bật `@`. Không truyền thì gõ `@` là chữ thường — nhưng nhắc tên CÓ SẴN trong nội dung vẫn hiện đúng. */
+    mentions?: MarkdownEditorMentions;
+    /**
+     * Bật ảnh: dán, kéo thả, mục "Ảnh" của menu `/` (và nút ảnh của thanh cố định). Nhận `File`, trả
+     * `src` để LƯU — khoá trong kho, hoặc một route ổn định của app; KHÔNG trả URL đã ký có hạn (xem
+     * `resolveImageSrc`).
+     */
+    onImageUpload?: (file: File) => Promise<MarkdownEditorImageUploadResult>;
+    /** Lỗi tải ảnh. Mặc định: toast `imageUploadFailed` (cần `Toaster` ở gốc app). */
+    onImageUploadError?: (error: unknown, file: File) => void;
+    /** Đổi `src` ĐÃ LƯU thành địa chỉ HIỂN THỊ (vd URL đã ký) lúc vẽ. Giá trị lưu vẫn giữ `src` gốc. */
+    resolveImageSrc?: (src: string) => string;
+    /**
+     * Extension Tiptap thêm vào (vd node `KEY-n` của module). Chỉ đọc LÚC MOUNT — đổi danh sách là
+     * phải dựng lại trình soạn (mất lịch sử hoàn tác), nên muốn đổi thì đổi `key` của component.
+     * Phải cùng phiên bản `@tiptap/*` với gói.
+     */
+    extensions?: readonly AnyExtension[];
+    labels?: Partial<MarkdownEditorLabels>;
+    /** Có `name` thì kèm một `<input type="hidden">` mang giá trị — để trình soạn nằm trong `<form>` thật. */
+    name?: string;
+    /** Đặt lên vùng soạn. Có `<label for={id}>` trong trang thì gói tự nối nó làm tên trợ năng. */
+    id?: string;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: boolean | "true" | "false";
+    "aria-required"?: boolean | "true" | "false";
+    className?: string;
+    /** Lớp thêm cho vùng soạn (phần tử ProseMirror) — vd `min-h-40`, `max-h-96 overflow-y-auto`. */
+    contentClassName?: string;
+}
+
+export { type EditorHandleBase as E, type ImageUploadHandlers as I, type MarkdownEditorImageUploadResult as M, type PendingUploads as P, type EditorToolbarMode as a, type MarkdownEditorMentionItem as b, type MarkdownEditorMentionSource as c, type MarkdownEditorMentions as d, type MarkdownEditorVariant as e, type EditorFormat as f, type EditorBaseProps as g, createImageUploadExtension as h, imageFilesFrom as i, insertImageFiles as j };

package/dist/i18n/locale-provider.d.ts

@@ -13,6 +13,7 @@ import './namespaces/route-tabs.js';
 import './namespaces/rating.js';
 import './namespaces/pagination.js';
 import './namespaces/mention.js';
+import '../editor/markdown-editor-constants.js';
 import './namespaces/inline-edit.js';
 import './namespaces/filter-chips.js';
 import '../uploader/file-upload-constants.js';

package/dist/i18n/messages.d.ts

@@ -8,6 +8,7 @@ import { RouteTabsMessages } from './namespaces/route-tabs.js';
 import { RatingMessages } from './namespaces/rating.js';
 import { PaginationMessages } from './namespaces/pagination.js';
 import { MentionMessages } from './namespaces/mention.js';
+import { MarkdownEditorLabels } from '../editor/markdown-editor-constants.js';
 import { InlineEditMessages } from './namespaces/inline-edit.js';
 import { FilterChipsMessages } from './namespaces/filter-chips.js';
 import { FileUploadLabels, ImageUploadFieldLabels } from '../uploader/file-upload-constants.js';
@@ -72,6 +73,7 @@ declare const comitorMessagesEn: {
     inlineEdit: InlineEditMessages;
     kanban: KanbanLabels;
     keyValue: KeyValueLabels;
+    markdownEditor: MarkdownEditorLabels;
     mention: MentionMessages;
     pagination: PaginationMessages;
     phoneInput: PhoneInputLabels;

package/dist/i18n/messages.js

@@ -23,6 +23,7 @@ import { imageUploadFieldEn, imageUploadFieldVi } from "./namespaces/image-uploa
 import { inlineEditEn, inlineEditVi } from "./namespaces/inline-edit.js";
 import { kanbanEn, kanbanVi } from "./namespaces/kanban.js";
 import { keyValueEn, keyValueVi } from "./namespaces/key-value.js";
+import { markdownEditorEn, markdownEditorVi } from "./namespaces/markdown-editor.js";
 import { mentionEn, mentionVi } from "./namespaces/mention.js";
 import { paginationEn, paginationVi } from "./namespaces/pagination.js";
 import { phoneInputEn, phoneInputVi } from "./namespaces/phone-input.js";
@@ -64,6 +65,7 @@ const comitorMessagesEn = {
   inlineEdit: inlineEditEn,
   kanban: kanbanEn,
   keyValue: keyValueEn,
+  markdownEditor: markdownEditorEn,
   mention: mentionEn,
   pagination: paginationEn,
   phoneInput: phoneInputEn,
@@ -106,6 +108,7 @@ const comitorMessagesVi = {
   inlineEdit: inlineEditVi,
   kanban: kanbanVi,
   keyValue: keyValueVi,
+  markdownEditor: markdownEditorVi,
   mention: mentionVi,
   pagination: paginationVi,
   phoneInput: phoneInputVi,