@comitor/ui 3.4.0 → 3.6.0

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

@@ -0,0 +1,96 @@
+import { Extension, AnyExtension } from '@tiptap/core';
+import { MentionOptions } from '@tiptap/extension-mention';
+import { Slice } from '@tiptap/pm/model';
+import { f as EditorFormat } from '../editor-types-BMST7-VR.js';
+import './markdown-editor-constants.js';
+
+/**
+ * LƯỢC ĐỒ của hai trình soạn — danh sách extension Tiptap, không React, không DOM.
+ *
+ * Mọi thứ quyết định "tài liệu này lưu xuống thành chuỗi nào, và đọc lên lại thành tài liệu nào"
+ * nằm ở đây, và CHỈ ở đây: trình soạn dùng nó, cổng `test:editor-markdown` dựng `MarkdownManager`
+ * từ chính hàm này trên `dist/` rồi đo vòng tài liệu → markdown → tài liệu. Hai nơi mà dùng hai danh
+ * sách là hai lược đồ, và cổng xanh trên một lược đồ không ai dùng.
+ *
+ * Hai định dạng LƯU, hai lược đồ khác nhau ở đúng những chỗ định dạng ấy biểu diễn được hay không
+ * (`createSchemaExtensions`): markdown (`MarkdownEditor`) hẹp hơn — không gạch chân, ô bảng một đoạn —
+ * vì thứ gì không ghi được thành markdown thì sẽ mất ở lần lưu; HTML (`RichTextEditor`) giữ được cả hai.
+ *
+ * Phần GIAO DIỆN (menu `/`, menu `@`, tải ảnh, phím tắt) gắn vào qua tham số — xem
+ * `MarkdownSchemaOptions`. Gọi không tham số là ra đúng lược đồ, đủ để đọc/ghi.
+ */
+
+/**
+ * Giá trị đổi được SAU KHI trình soạn đã dựng. Extension đọc chúng lúc CẦN (lúc vẽ chữ mờ, lúc vẽ một
+ * lần nhắc tên…), không chép lúc dựng — vì đổi danh sách extension là dựng lại cả trình soạn: mất
+ * lịch sử hoàn tác, mất con trỏ. Component giữ object này trong một ref và ghi đè từng lượt render.
+ */
+interface MarkdownEditorRuntime {
+    placeholder: string;
+    taskCheckbox: (text: string) => string;
+    /** Đổi `src` ĐÃ LƯU thành địa chỉ HIỂN THỊ được (vd URL đã ký). Markdown vẫn giữ `src` gốc. */
+    resolveImageSrc?: (src: string) => string;
+    /** Tên SỐNG của một người theo id. `undefined` thì rơi về tên chụp lúc nhắc. */
+    resolveMentionLabel?: (id: string) => string | undefined;
+}
+interface MarkdownSchemaOptions {
+    /** Định dạng LƯU — quyết định lược đồ. Mặc định `markdown`. */
+    format?: EditorFormat;
+    /** Đọc lười — xem `MarkdownEditorRuntime`. Bỏ trống ở nơi chỉ cần đọc/ghi (cổng, máy chủ). */
+    runtime?: {
+        readonly current: MarkdownEditorRuntime;
+    };
+    /**
+     * Cấu hình gợi ý `@` của `Mention` (danh sách, cách vẽ, `allow`). Bỏ trống = node `mention` vẫn có
+     * trong lược đồ — để tài liệu CÓ nhắc tên vẫn đọc ra đúng ở chế độ chỉ đọc — nhưng gõ `@` không
+     * mở gì.
+     */
+    mentionSuggestion?: Partial<MentionOptions["suggestion"]>;
+}
+/**
+ * Gộp một đoạn dán thành MỘT dòng nội dòng: các khối chữ nối nhau bằng một dấu cách, xuống dòng (cả
+ * `hardBreak` lẫn `\n` trong khối mã) thành dấu cách, khối không phải chữ (ảnh, đường kẻ) bỏ đi.
+ * Nội dung nội dòng sẵn thì để nguyên; `keepTables` (đoạn dán GỐC có bảng) thì đoạn dán mang ô bảng
+ * cũng để nguyên — dán theo ô là việc của `prosemirror-tables`.
+ * Xuất ra cho cổng `test:editor-markdown`; không nằm trong entry.
+ */
+declare function flattenSliceToLine(slice: Slice, keepTables?: boolean): Slice;
+/**
+ * Danh sách extension tạo nên lược đồ của trình soạn, theo định dạng LƯU.
+ *
+ * Markdown (`format: "markdown"`, mặc định) hẹp hơn HTML ở hai chỗ, cả hai vì cùng một lý do — thứ gì
+ * không ghi được thành markdown thì MẤT ở lần lưu, mà người dùng không được báo:
+ *   · `underline` tắt: markdown không có cú pháp gạch chân. `@tiptap/markdown` ghi nó thành
+ *     `++chữ++` — cú pháp riêng, nên email thông báo, tác tử đọc qua MCP và mọi trình xem markdown
+ *     khác in nguyên hai dấu cộng;
+ *   · ô bảng chỉ chứa MỘT đoạn văn (`ComitorTableCell`).
+ * Hai bản vá markdown (`ComitorParagraph`, `Markdown` với `Marked` riêng) cũng chỉ nạp ở định dạng đó.
+ *
+ * HTML (`format: "html"`) giữ cả gạch chân lẫn ô bảng nhiều khối — `<u>`, `<td><ul>…</ul></td>` là HTML
+ * hợp lệ và đọc lên lại đúng.
+ */
+declare function createSchemaExtensions(options?: MarkdownSchemaOptions): AnyExtension[];
+/** Lược đồ của `MarkdownEditor` — tên có từ `3.5.0`, cổng `test:editor-markdown` gọi thẳng nó. */
+declare function createMarkdownSchemaExtensions(options?: Omit<MarkdownSchemaOptions, "format">): AnyExtension[];
+/** Phím tắt riêng của trình soạn — xem `createEditorKeymap`. */
+interface EditorKeymapHandlers {
+    /** ⌘/Ctrl+K — mở ô liên kết. Trả `true` khi đã xử lý. */
+    onLinkShortcut: () => boolean;
+    /** ⌘/Ctrl+Enter ngoài danh sách việc. Trả `false` để phím đi tiếp (xuống dòng cứng của Tiptap). */
+    onSubmitShortcut: () => boolean;
+}
+/**
+ * Phím tắt của RIÊNG gói, ưu tiên cao hơn mặc định của Tiptap.
+ *
+ * ⌘/Ctrl+Enter: trong danh sách việc thì tick/bỏ tick mục đang đứng (như Linear); ngoài đó thì gửi
+ * (`onSubmit`) — đúng phím mà ô bình luận nào cũng dùng. Không có `onSubmit` thì trả phím về cho
+ * Tiptap (bản gốc gán nó cho xuống dòng cứng).
+ *
+ * ⌘/Ctrl+K: ô liên kết. Không đụng bảng lệnh của shell — listener của shell tự bỏ qua phím khi
+ * đích là vùng `contenteditable` (`shell-context.tsx`, nhánh `isTyping`).
+ */
+declare function createEditorKeymap(handlers: {
+    readonly current: EditorKeymapHandlers;
+}, format?: EditorFormat): Extension;
+
+export { type EditorKeymapHandlers, type MarkdownEditorRuntime, type MarkdownSchemaOptions, createEditorKeymap, createMarkdownSchemaExtensions, createSchemaExtensions, flattenSliceToLine };

package/dist/editor/markdown-extensions.js

@@ -0,0 +1,291 @@
+import { Extension, InputRule, mergeAttributes } from "@tiptap/core";
+import { CodeBlockLowlight } from "@tiptap/extension-code-block-lowlight";
+import { Image } from "@tiptap/extension-image";
+import { TaskItem, TaskList } from "@tiptap/extension-list";
+import { Mention } from "@tiptap/extension-mention";
+import { Paragraph } from "@tiptap/extension-paragraph";
+import { renderTableToMarkdown, Table, TableCell, TableHeader, TableKit } from "@tiptap/extension-table";
+import { Placeholder } from "@tiptap/extensions";
+import { Markdown } from "@tiptap/markdown";
+import { Fragment, Slice } from "@tiptap/pm/model";
+import { Plugin } from "@tiptap/pm/state";
+import { StarterKit } from "@tiptap/starter-kit";
+import { common, createLowlight } from "lowlight";
+import { Marked } from "marked";
+import {
+  codeFence,
+  escapeParagraphMarkdown,
+  imageMarkdown,
+  parseMentionMarkdown,
+  renderMentionMarkdown
+} from "./markdown-syntax.js";
+const DEFAULT_RUNTIME = {
+  placeholder: "",
+  taskCheckbox: (text) => text
+};
+const lowlight = createLowlight(common);
+const ComitorParagraph = Paragraph.extend({
+  renderMarkdown(node, helpers, context) {
+    return escapeParagraphMarkdown(this.parent?.(node, helpers, context) ?? "");
+  }
+});
+const ComitorCodeBlock = CodeBlockLowlight.extend({
+  renderMarkdown(node) {
+    const language = typeof node.attrs?.language === "string" ? node.attrs.language : "";
+    const text = (node.content ?? []).map((child) => child.text ?? "").join("");
+    const fence = codeFence(text);
+    return `${fence}${language}
+${text}
+${fence}`;
+  }
+});
+const ComitorTable = Table.extend({
+  renderMarkdown(node, helpers) {
+    return renderTableToMarkdown(node, helpers).replace(/^\n+|\n+$/g, "");
+  }
+});
+const ComitorTableCell = TableCell.extend({ content: "paragraph" });
+const ComitorTableHeader = TableHeader.extend({ content: "paragraph" });
+const HORIZONTAL_RULE_INPUT = /^(?:---|—-|___\s|\*\*\*\s)$/;
+const MarkdownTableCellGuard = Extension.create({
+  name: "comitorMarkdownTableCellGuard",
+  // Cao hơn StarterKit (100): mỗi extension một plugin luật nhập, xếp theo `priority` — luật dưới đây
+  // phải được hỏi TRƯỚC luật đường kẻ, không thì đường kẻ đã chèn xong.
+  priority: 1e3,
+  addInputRules() {
+    return [
+      new InputRule({
+        find: HORIZONTAL_RULE_INPUT,
+        undoable: false,
+        handler: ({ state, range, match }) => {
+          if (!isInTableCell(state.doc.resolve(range.from))) return null;
+          state.tr.insertText(match[0], range.from, range.to);
+        }
+      })
+    ];
+  },
+  addProseMirrorPlugins() {
+    let pastedTable = false;
+    return [
+      new Plugin({
+        props: {
+          transformPastedHTML: (html) => {
+            pastedTable = /<(?:table|tr|td|th)[\s>/]/i.test(html);
+            return html;
+          },
+          transformPastedText: (text) => {
+            pastedTable = false;
+            return text;
+          },
+          transformPasted: (slice, view) => {
+            const keepTables = pastedTable;
+            pastedTable = false;
+            return isInTableCell(view.state.selection.$from) ? flattenSliceToLine(slice, keepTables) : slice;
+          }
+        },
+        filterTransaction: (tr, state) => {
+          if (!tr.docChanged || tr.getMeta("history$") || !isInTableCell(state.selection.$from)) return true;
+          if (replacesWholeDocument(tr.steps, state.doc.content.size)) return true;
+          return countTables(tr.doc) <= countTables(state.doc);
+        }
+      })
+    ];
+  }
+});
+function flattenSliceToLine(slice, keepTables = false) {
+  const first = slice.content.firstChild;
+  if (!first || first.isInline) return slice;
+  if (keepTables) {
+    let tabular = false;
+    slice.content.descendants((node) => {
+      if (node.type.spec.tableRole) tabular = true;
+      return !tabular;
+    });
+    if (tabular) return slice;
+  }
+  const schema = first.type.schema;
+  const line = [];
+  slice.content.descendants((node) => {
+    if (!node.isTextblock) return true;
+    if (node.content.size === 0) return false;
+    if (line.length > 0) line.push(schema.text(" "));
+    node.content.forEach((child) => {
+      if (child.type.name === "hardBreak") line.push(schema.text(" "));
+      else if (child.isText && child.text?.includes("\n"))
+        line.push(schema.text(child.text.replace(/\s*\n\s*/g, " "), child.marks));
+      else line.push(child);
+    });
+    return false;
+  });
+  return new Slice(Fragment.from(line), 0, 0);
+}
+function countTables(doc) {
+  let count = 0;
+  doc.descendants((node) => {
+    if (node.type.name === "table") count++;
+    return node.type.name !== "table";
+  });
+  return count;
+}
+function replacesWholeDocument(steps, size) {
+  return steps.some((step) => {
+    const { from, to } = step;
+    return from === 0 && to === size;
+  });
+}
+function createMarkedInstance() {
+  return new Marked();
+}
+function createSchemaExtensions(options = {}) {
+  const runtime = options.runtime ?? { current: DEFAULT_RUNTIME };
+  const markdown = (options.format ?? "markdown") === "markdown";
+  return [
+    StarterKit.configure({
+      paragraph: false,
+      codeBlock: false,
+      ...markdown ? { underline: false } : {},
+      link: {
+        // Đang sửa thì bấm vào liên kết là đặt con trỏ, không phải mở tab mới (thanh định dạng có nút
+        // Mở). Chỉ đọc thì Tiptap không chặn cú bấm — thẻ `<a target="_blank">` tự mở như thường.
+        openOnClick: false,
+        autolink: true,
+        linkOnPaste: true,
+        // Gõ/dán `[chữ](https://…)` là thành liên kết — người quen markdown gõ vậy theo phản xạ.
+        markdownLinks: true,
+        defaultProtocol: "https",
+        HTMLAttributes: { target: "_blank", rel: "noopener noreferrer nofollow" }
+      }
+    }),
+    markdown ? ComitorParagraph : Paragraph,
+    ComitorCodeBlock.configure({
+      lowlight,
+      defaultLanguage: null,
+      // Tab trong khối mã là thụt lề — đúng điều người viết mã chờ đợi. Thoát khối: ↓ ở dòng cuối,
+      // hoặc Enter ba lần (mặc định của Tiptap).
+      enableTabIndentation: true,
+      tabSize: 2
+    }),
+    TaskList,
+    TaskItem.configure({
+      nested: true,
+      // Chữ của ĐOẠN ĐẦU, không phải `node.textContent`: mục cha có danh sách con thì `textContent` dính
+      // liền chữ của mọi mục con ("Gửi mã qua emailGiới hạn 5 lần/giờ") — đã gặp.
+      a11y: { checkboxLabel: (node) => runtime.current.taskCheckbox(node.firstChild?.textContent ?? "") }
+    }),
+    ...markdown ? [
+      TableKit.configure({ table: false, tableCell: false, tableHeader: false }),
+      ComitorTable.configure({ resizable: false }),
+      ComitorTableCell,
+      ComitorTableHeader,
+      MarkdownTableCellGuard
+    ] : [TableKit.configure({ table: { resizable: false } })],
+    createImageExtension(runtime),
+    createMentionExtension(runtime, options.mentionSuggestion),
+    Placeholder.configure({ placeholder: () => runtime.current.placeholder }),
+    ...markdown ? [Markdown.configure({ marked: createMarkedInstance(), indentation: { style: "space", size: 2 } })] : []
+  ];
+}
+function createMarkdownSchemaExtensions(options = {}) {
+  return createSchemaExtensions({ ...options, format: "markdown" });
+}
+function createImageExtension(runtime) {
+  return Image.extend({
+    addNodeView() {
+      return ({ node, HTMLAttributes }) => {
+        const image = document.createElement("img");
+        setAttributes(image, mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), ["src"]);
+        const src = typeof node.attrs.src === "string" ? node.attrs.src : "";
+        if (src) image.setAttribute("src", runtime.current.resolveImageSrc?.(src) ?? src);
+        return { dom: image, update: (updated) => sameNode(updated, node) };
+      };
+    },
+    renderMarkdown(node) {
+      return imageMarkdown(String(node.attrs?.src ?? ""), node.attrs?.alt, node.attrs?.title);
+    }
+  }).configure({ allowBase64: false });
+}
+function createMentionExtension(runtime, suggestion) {
+  const storedLabelOf = (attrs) => {
+    const stored = typeof attrs.label === "string" ? attrs.label : "";
+    return stored || (typeof attrs.id === "string" ? attrs.id : "");
+  };
+  const labelOf = (attrs) => runtime.current.resolveMentionLabel?.(typeof attrs.id === "string" ? attrs.id : "") ?? storedLabelOf(attrs);
+  return Mention.extend({
+    markdownTokenName: "mention",
+    markdownTokenizer: {
+      name: "mention",
+      level: "inline",
+      start: (source) => source.indexOf("[@"),
+      tokenize: (source) => {
+        const parsed = parseMentionMarkdown(source);
+        return parsed ? { type: "mention", raw: parsed.raw, id: parsed.id, label: parsed.label } : void 0;
+      }
+    },
+    parseMarkdown: (token, helpers) => helpers.createNode("mention", { id: token.id, label: token.label }),
+    renderMarkdown: (node) => renderMentionMarkdown(String(node.attrs?.id ?? ""), node.attrs?.label),
+    addNodeView() {
+      return ({ node, HTMLAttributes }) => {
+        const dom = document.createElement("span");
+        setAttributes(dom, mergeAttributes({ "data-type": this.name }, this.options.HTMLAttributes, HTMLAttributes));
+        dom.textContent = `@${labelOf(node.attrs)}`;
+        return { dom, update: (updated) => sameNode(updated, node) };
+      };
+    }
+  }).configure({
+    renderText: ({ node }) => `@${labelOf(node.attrs)}`,
+    // `options.HTMLAttributes` ở đây là bản Tiptap đã trộn sẵn (`data-type`, `data-id`, `data-label`).
+    renderHTML: ({ options, node }) => ["span", options.HTMLAttributes, `@${storedLabelOf(node.attrs)}`],
+    suggestion: { char: "@", allow: () => false, ...suggestion }
+  });
+}
+function createEditorKeymap(handlers, format = "markdown") {
+  const swallowInCell = (editor) => format === "markdown" && isInTableCell(editor.state.selection.$from);
+  return Extension.create({
+    name: "comitorEditorKeymap",
+    priority: 1e3,
+    addKeyboardShortcuts() {
+      return {
+        "Mod-k": () => handlers.current.onLinkShortcut(),
+        "Mod-Enter": ({ editor }) => {
+          const toggled = editor.commands.command(({ tr, state }) => {
+            const { $from } = state.selection;
+            for (let depth = $from.depth; depth > 0; depth--) {
+              const node = $from.node(depth);
+              if (node.type.name !== "taskItem") continue;
+              tr.setNodeMarkup($from.before(depth), void 0, { ...node.attrs, checked: !node.attrs.checked });
+              return true;
+            }
+            return false;
+          });
+          if (toggled || handlers.current.onSubmitShortcut()) return true;
+          return swallowInCell(editor);
+        },
+        "Shift-Enter": ({ editor }) => swallowInCell(editor)
+      };
+    }
+  });
+}
+function isInTableCell($pos) {
+  for (let depth = $pos.depth; depth > 0; depth--) {
+    const name = $pos.node(depth).type.name;
+    if (name === "tableCell" || name === "tableHeader") return true;
+  }
+  return false;
+}
+function setAttributes(element, attributes, skip = []) {
+  for (const [key, value] of Object.entries(attributes)) {
+    if (skip.includes(key) || value === null || value === void 0 || value === false) continue;
+    element.setAttribute(key, String(value));
+  }
+}
+function sameNode(updated, current) {
+  if (updated.type !== current.type) return false;
+  return Object.keys(current.attrs).every((key) => updated.attrs[key] === current.attrs[key]);
+}
+export {
+  createEditorKeymap,
+  createMarkdownSchemaExtensions,
+  createSchemaExtensions,
+  flattenSliceToLine
+};
+//# sourceMappingURL=markdown-extensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/markdown-extensions.ts"],"sourcesContent":["/**\n * LƯỢC ĐỒ của hai trình soạn — danh sách extension Tiptap, không React, không DOM.\n *\n * Mọi thứ quyết định \"tài liệu này lưu xuống thành chuỗi nào, và đọc lên lại thành tài liệu nào\"\n * nằm ở đây, và CHỈ ở đây: trình soạn dùng nó, cổng `test:editor-markdown` dựng `MarkdownManager`\n * từ chính hàm này trên `dist/` rồi đo vòng tài liệu → markdown → tài liệu. Hai nơi mà dùng hai danh\n * sách là hai lược đồ, và cổng xanh trên một lược đồ không ai dùng.\n *\n * Hai định dạng LƯU, hai lược đồ khác nhau ở đúng những chỗ định dạng ấy biểu diễn được hay không\n * (`createSchemaExtensions`): markdown (`MarkdownEditor`) hẹp hơn — không gạch chân, ô bảng một đoạn —\n * vì thứ gì không ghi được thành markdown thì sẽ mất ở lần lưu; HTML (`RichTextEditor`) giữ được cả hai.\n *\n * Phần GIAO DIỆN (menu `/`, menu `@`, tải ảnh, phím tắt) gắn vào qua tham số — xem\n * `MarkdownSchemaOptions`. Gọi không tham số là ra đúng lược đồ, đủ để đọc/ghi.\n */\n\nimport { type AnyExtension, Extension, InputRule, type JSONContent, mergeAttributes } from \"@tiptap/core\";\nimport { CodeBlockLowlight } from \"@tiptap/extension-code-block-lowlight\";\nimport { Image } from \"@tiptap/extension-image\";\nimport { TaskItem, TaskList } from \"@tiptap/extension-list\";\nimport { Mention, type MentionOptions } from \"@tiptap/extension-mention\";\nimport { Paragraph } from \"@tiptap/extension-paragraph\";\nimport { renderTableToMarkdown, Table, TableCell, TableHeader, TableKit } from \"@tiptap/extension-table\";\nimport { Placeholder } from \"@tiptap/extensions\";\nimport { Markdown } from \"@tiptap/markdown\";\nimport { Fragment, type Node as ProseMirrorNode, type ResolvedPos, Slice } from \"@tiptap/pm/model\";\nimport { Plugin } from \"@tiptap/pm/state\";\nimport { StarterKit } from \"@tiptap/starter-kit\";\nimport { common, createLowlight } from \"lowlight\";\nimport { Marked, type marked } from \"marked\";\nimport type { EditorFormat } from \"./editor-types.js\";\nimport {\n  codeFence,\n  escapeParagraphMarkdown,\n  imageMarkdown,\n  parseMentionMarkdown,\n  renderMentionMarkdown\n} from \"./markdown-syntax.js\";\n\n/**\n * Giá trị đổi được SAU KHI trình soạn đã dựng. Extension đọc chúng lúc CẦN (lúc vẽ chữ mờ, lúc vẽ một\n * lần nhắc tên…), không chép lúc dựng — vì đổi danh sách extension là dựng lại cả trình soạn: mất\n * lịch sử hoàn tác, mất con trỏ. Component giữ object này trong một ref và ghi đè từng lượt render.\n */\nexport interface MarkdownEditorRuntime {\n  placeholder: string;\n  taskCheckbox: (text: string) => string;\n  /** Đổi `src` ĐÃ LƯU thành địa chỉ HIỂN THỊ được (vd URL đã ký). Markdown vẫn giữ `src` gốc. */\n  resolveImageSrc?: (src: string) => string;\n  /** Tên SỐNG của một người theo id. `undefined` thì rơi về tên chụp lúc nhắc. */\n  resolveMentionLabel?: (id: string) => string | undefined;\n}\n\nconst DEFAULT_RUNTIME: MarkdownEditorRuntime = {\n  placeholder: \"\",\n  taskCheckbox: (text) => text\n};\n\nexport interface MarkdownSchemaOptions {\n  /** Định dạng LƯU — quyết định lược đồ. Mặc định `markdown`. */\n  format?: EditorFormat;\n  /** Đọc lười — xem `MarkdownEditorRuntime`. Bỏ trống ở nơi chỉ cần đọc/ghi (cổng, máy chủ). */\n  runtime?: { readonly current: MarkdownEditorRuntime };\n  /**\n   * Cấu hình gợi ý `@` của `Mention` (danh sách, cách vẽ, `allow`). Bỏ trống = node `mention` vẫn có\n   * trong lược đồ — để tài liệu CÓ nhắc tên vẫn đọc ra đúng ở chế độ chỉ đọc — nhưng gõ `@` không\n   * mở gì.\n   */\n  mentionSuggestion?: Partial<MentionOptions[\"suggestion\"]>;\n}\n\n/*\n * Ngôn ngữ tô màu: bộ `common` của highlight.js (37 ngôn ngữ, ~53KB gzip — đo bằng esbuild trên\n * lowlight 3.3.0). Dựng MỘT lần cho cả module: bảng ngôn ngữ chỉ đọc, chia được giữa các trình soạn.\n */\nconst lowlight = createLowlight(common);\n\n/**\n * Đoạn văn — thêm phép thoát cú pháp khối (ca 1 ở đầu `markdown-syntax.ts`). Mọi hành vi khác giữ\n * nguyên bản gốc, kể cả `&nbsp;` cho đoạn rỗng: đó là cách CỐ Ý của Tiptap để giữ dòng trống người\n * dùng gõ — bỏ nó đi là nội dung \"co\" lại sau mỗi lần lưu.\n */\nconst ComitorParagraph = Paragraph.extend({\n  renderMarkdown(node, helpers, context) {\n    return escapeParagraphMarkdown(this.parent?.(node, helpers, context) ?? \"\");\n  }\n});\n\n/** Khối mã — hàng rào dài hơn mọi dãy backtick bên trong (ca 2 ở đầu `markdown-syntax.ts`). */\nconst ComitorCodeBlock = CodeBlockLowlight.extend({\n  renderMarkdown(node: JSONContent) {\n    const language = typeof node.attrs?.language === \"string\" ? node.attrs.language : \"\";\n    const text = (node.content ?? []).map((child) => child.text ?? \"\").join(\"\");\n    const fence = codeFence(text);\n    return `${fence}${language}\\n${text}\\n${fence}`;\n  }\n});\n\n/** Bảng — bỏ dòng trống bản gốc kẹp hai đầu (xem `trimMarkdown`). */\nconst ComitorTable = Table.extend({\n  renderMarkdown(node, helpers) {\n    return renderTableToMarkdown(node, helpers).replace(/^\\n+|\\n+$/g, \"\");\n  }\n});\n\n/*\n * Ô bảng chứa ĐÚNG MỘT đoạn văn — bản gốc cho `block+` (danh sách, khối mã, nhiều đoạn trong một ô).\n *\n * Ô bảng GFM là một dòng chữ, không chứa khối được. Đã đo trên 3.31.4: ô có hai đoạn ghi thành\n * `dòng 1<br>dòng 2`, ô có danh sách thành `- a<br>- b`, khối mã thành ```` ```<br>code<br>``` ````;\n * mở lại thì `<br>` là CHỮ THƯỜNG, và lần lưu kế tiếp nó thành `&lt;br&gt;` — mỗi lần lưu hỏng thêm\n * một lớp. Thu hẹp lược đồ là cách duy nhất chặn từ gốc: luật nhập (`- `, `# `, ```` ``` ````) và\n * lệnh khối tự thất bại trong ô vì lược đồ không cho, không cần chặn từng chỗ. Xuống dòng cứng trong ô\n * thì `createEditorKeymap` nuốt — `hardBreak` là node NỘI DÒNG nên lược đồ không chặn được nó.\n */\nconst ComitorTableCell = TableCell.extend({ content: \"paragraph\" });\nconst ComitorTableHeader = TableHeader.extend({ content: \"paragraph\" });\n\n/** Mẫu luật nhập của `HorizontalRule` trong StarterKit (3.31.4) — xem `MarkdownTableCellGuard`. */\nconst HORIZONTAL_RULE_INPUT = /^(?:---|—-|___\\s|\\*\\*\\*\\s)$/;\n\n/**\n * Ô bảng MARKDOWN — chặn nốt những đường CHÈN KHỐI mà lược đồ không chặn được.\n *\n * `ComitorTableCell` làm luật nhập BỌC (`- `, `# `, `> `) và lệnh đổi khối tự thất bại trong ô. Nhưng\n * phép THAY của ProseMirror không thất bại: khối không vừa chỗ thì nó TÁCH các node cha cho tới khi\n * vừa — tức tách CẢ BẢNG. Đã đo trên 3.31.4 (harness của `3.6.0`; cả ba có từ `3.5.0`):\n *   · gõ `---` trong ô → bảng gãy làm hai, một đường kẻ ở giữa (luật nhập của `HorizontalRule`);\n *   · dán một danh sách vào ô → bảng gãy làm hai, danh sách ở giữa;\n *   · dán hai dòng chữ vào ô → hai dòng GHI ĐÈ lên ô đang đứng và ô kế bên — chữ cũ của cả hai mất.\n * Ba lớp, từ cụ thể tới chung:\n *   1. dán/thả từ ngoài: mọi khối của đoạn dán gộp thành MỘT dòng (`flattenSliceToLine`) — ô GFM là\n *      một dòng chữ;\n *   2. `---` gõ trong ô ở lại là CHỮ — \"---\" là cách người ta hay ghi \"không có\" trong một ô bảng;\n *   3. lưới cuối: giao dịch nào làm SỐ BẢNG tăng khi con trỏ đang ở trong ô thì bị bỏ. Nó bắt mọi\n *      đường còn lại (luật nhập ảnh `![a](b)`, kéo thả một khối trong tài liệu, `insertContent` của app),\n *      với cái giá là phím hay cú thả vừa rồi không có tác dụng — mất một phím còn hơn gãy một bảng.\n *      Hoàn tác/làm lại và thay CẢ tài liệu (`setContent`, `value` đổi từ ngoài) đi thẳng.\n *\n * Ô bảng của `RichTextEditor` chứa được khối nên không cần lớp nào trong ba.\n */\nconst MarkdownTableCellGuard = Extension.create({\n  name: \"comitorMarkdownTableCellGuard\",\n  // Cao hơn StarterKit (100): mỗi extension một plugin luật nhập, xếp theo `priority` — luật dưới đây\n  // phải được hỏi TRƯỚC luật đường kẻ, không thì đường kẻ đã chèn xong.\n  priority: 1000,\n  addInputRules() {\n    return [\n      new InputRule({\n        find: HORIZONTAL_RULE_INPUT,\n        undoable: false,\n        handler: ({ state, range, match }) => {\n          if (!isInTableCell(state.doc.resolve(range.from))) return null;\n          state.tr.insertText(match[0], range.from, range.to);\n        }\n      })\n    ];\n  },\n  addProseMirrorPlugins() {\n    /*\n     * Đoạn dán có thật là BẢNG không — phải hỏi ở chuỗi GỐC. `normalizeSiblings` của ProseMirror bọc\n     * sẵn các đoạn văn dán vào ô thành Ô BẢNG (để chúng \"vừa\" chỗ) trước khi `transformPasted` thấy\n     * chúng, nên nhìn slice thì \"dán hai dòng chữ\" và \"dán hai ô\" là một — và `prosemirror-tables` dán\n     * cả hai theo kiểu ô, đè lên ô kế bên. Đã đo: đó chính là ca \"hai dòng ghi đè hai ô\" ở trên.\n     */\n    let pastedTable = false;\n    return [\n      new Plugin({\n        props: {\n          transformPastedHTML: (html) => {\n            pastedTable = /<(?:table|tr|td|th)[\\s>/]/i.test(html);\n            return html;\n          },\n          transformPastedText: (text) => {\n            pastedTable = false;\n            return text;\n          },\n          transformPasted: (slice, view) => {\n            const keepTables = pastedTable;\n            pastedTable = false;\n            return isInTableCell(view.state.selection.$from) ? flattenSliceToLine(slice, keepTables) : slice;\n          }\n        },\n        filterTransaction: (tr, state) => {\n          if (!tr.docChanged || tr.getMeta(\"history$\") || !isInTableCell(state.selection.$from)) return true;\n          if (replacesWholeDocument(tr.steps, state.doc.content.size)) return true;\n          return countTables(tr.doc) <= countTables(state.doc);\n        }\n      })\n    ];\n  }\n});\n\n/**\n * Gộp một đoạn dán thành MỘT dòng nội dòng: các khối chữ nối nhau bằng một dấu cách, xuống dòng (cả\n * `hardBreak` lẫn `\\n` trong khối mã) thành dấu cách, khối không phải chữ (ảnh, đường kẻ) bỏ đi.\n * Nội dung nội dòng sẵn thì để nguyên; `keepTables` (đoạn dán GỐC có bảng) thì đoạn dán mang ô bảng\n * cũng để nguyên — dán theo ô là việc của `prosemirror-tables`.\n * Xuất ra cho cổng `test:editor-markdown`; không nằm trong entry.\n */\nexport function flattenSliceToLine(slice: Slice, keepTables = false): Slice {\n  const first = slice.content.firstChild;\n  if (!first || first.isInline) return slice;\n  if (keepTables) {\n    let tabular = false;\n    slice.content.descendants((node) => {\n      if (node.type.spec.tableRole) tabular = true;\n      return !tabular;\n    });\n    if (tabular) return slice;\n  }\n\n  const schema = first.type.schema;\n  const line: ProseMirrorNode[] = [];\n  slice.content.descendants((node) => {\n    if (!node.isTextblock) return true;\n    if (node.content.size === 0) return false;\n    if (line.length > 0) line.push(schema.text(\" \"));\n    node.content.forEach((child) => {\n      if (child.type.name === \"hardBreak\") line.push(schema.text(\" \"));\n      else if (child.isText && child.text?.includes(\"\\n\"))\n        line.push(schema.text(child.text.replace(/\\s*\\n\\s*/g, \" \"), child.marks));\n      else line.push(child);\n    });\n    return false;\n  });\n  return new Slice(Fragment.from(line), 0, 0);\n}\n\nfunction countTables(doc: ProseMirrorNode): number {\n  let count = 0;\n  doc.descendants((node) => {\n    if (node.type.name === \"table\") count++;\n    return node.type.name !== \"table\";\n  });\n  return count;\n}\n\n/** Có bước nào thay TOÀN BỘ tài liệu không — `setContent` làm đúng một bước như vậy. */\nfunction replacesWholeDocument(steps: readonly unknown[], size: number): boolean {\n  return steps.some((step) => {\n    const { from, to } = step as { from?: unknown; to?: unknown };\n    return from === 0 && to === size;\n  });\n}\n\n/**\n * Bảng chữ markdown RIÊNG cho từng trình soạn.\n *\n * ⚠ Không truyền thì `@tiptap/markdown` dùng `marked` TOÀN CỤC, và mỗi lần trình soạn mount nó gọi\n * `marked.use()` đăng ký lại bộ tách từ (bảng, nhắc tên…) — không bao giờ gỡ. Đã đo trên 3.31.4:\n * mỗi `MarkdownManager` thêm 4 bộ tách; sau 200 lần dựng, parse cùng một tài liệu 200 đoạn chậm từ\n * 18,6ms lên 282ms, và còn tăng tiếp. Trong một SPA, 200 lần là một buổi làm việc mở việc này sang\n * việc khác. Một bản `Marked` mỗi trình soạn: 4 bộ tách, 5,7ms, mất cùng trình soạn.\n *\n * Ép kiểu vì option khai `typeof marked` (hàm `marked` toàn cục, gọi được) mà thứ đúng là một bản\n * `Marked`: `MarkdownManager` chỉ dùng `.use`, `.Lexer`, `.defaults`, `.lexer`, `.setOptions` — bản\n * `Marked` có đủ cả năm, chỉ thiếu chữ ký gọi-như-hàm mà không chỗ nào gọi tới.\n */\nfunction createMarkedInstance(): typeof marked {\n  return new Marked() as unknown as typeof marked;\n}\n\n/**\n * Danh sách extension tạo nên lược đồ của trình soạn, theo định dạng LƯU.\n *\n * Markdown (`format: \"markdown\"`, mặc định) hẹp hơn HTML ở hai chỗ, cả hai vì cùng một lý do — thứ gì\n * không ghi được thành markdown thì MẤT ở lần lưu, mà người dùng không được báo:\n *   · `underline` tắt: markdown không có cú pháp gạch chân. `@tiptap/markdown` ghi nó thành\n *     `++chữ++` — cú pháp riêng, nên email thông báo, tác tử đọc qua MCP và mọi trình xem markdown\n *     khác in nguyên hai dấu cộng;\n *   · ô bảng chỉ chứa MỘT đoạn văn (`ComitorTableCell`).\n * Hai bản vá markdown (`ComitorParagraph`, `Markdown` với `Marked` riêng) cũng chỉ nạp ở định dạng đó.\n *\n * HTML (`format: \"html\"`) giữ cả gạch chân lẫn ô bảng nhiều khối — `<u>`, `<td><ul>…</ul></td>` là HTML\n * hợp lệ và đọc lên lại đúng.\n */\nexport function createSchemaExtensions(options: MarkdownSchemaOptions = {}): AnyExtension[] {\n  const runtime = options.runtime ?? { current: DEFAULT_RUNTIME };\n  const markdown = (options.format ?? \"markdown\") === \"markdown\";\n\n  return [\n    StarterKit.configure({\n      paragraph: false,\n      codeBlock: false,\n      ...(markdown ? { underline: false as const } : {}),\n      link: {\n        // Đang sửa thì bấm vào liên kết là đặt con trỏ, không phải mở tab mới (thanh định dạng có nút\n        // Mở). Chỉ đọc thì Tiptap không chặn cú bấm — thẻ `<a target=\"_blank\">` tự mở như thường.\n        openOnClick: false,\n        autolink: true,\n        linkOnPaste: true,\n        // Gõ/dán `[chữ](https://…)` là thành liên kết — người quen markdown gõ vậy theo phản xạ.\n        markdownLinks: true,\n        defaultProtocol: \"https\",\n        HTMLAttributes: { target: \"_blank\", rel: \"noopener noreferrer nofollow\" }\n      }\n    }),\n    markdown ? ComitorParagraph : Paragraph,\n    ComitorCodeBlock.configure({\n      lowlight,\n      defaultLanguage: null,\n      // Tab trong khối mã là thụt lề — đúng điều người viết mã chờ đợi. Thoát khối: ↓ ở dòng cuối,\n      // hoặc Enter ba lần (mặc định của Tiptap).\n      enableTabIndentation: true,\n      tabSize: 2\n    }),\n    TaskList,\n    TaskItem.configure({\n      nested: true,\n      // Chữ của ĐOẠN ĐẦU, không phải `node.textContent`: mục cha có danh sách con thì `textContent` dính\n      // liền chữ của mọi mục con (\"Gửi mã qua emailGiới hạn 5 lần/giờ\") — đã gặp.\n      a11y: { checkboxLabel: (node) => runtime.current.taskCheckbox(node.firstChild?.textContent ?? \"\") }\n    }),\n    ...(markdown\n      ? [\n          TableKit.configure({ table: false, tableCell: false, tableHeader: false }),\n          ComitorTable.configure({ resizable: false }),\n          ComitorTableCell,\n          ComitorTableHeader,\n          MarkdownTableCellGuard\n        ]\n      : [TableKit.configure({ table: { resizable: false } })]),\n    createImageExtension(runtime),\n    createMentionExtension(runtime, options.mentionSuggestion),\n    Placeholder.configure({ placeholder: () => runtime.current.placeholder }),\n    ...(markdown\n      ? [Markdown.configure({ marked: createMarkedInstance(), indentation: { style: \"space\", size: 2 } })]\n      : [])\n  ];\n}\n\n/** Lược đồ của `MarkdownEditor` — tên có từ `3.5.0`, cổng `test:editor-markdown` gọi thẳng nó. */\nexport function createMarkdownSchemaExtensions(options: Omit<MarkdownSchemaOptions, \"format\"> = {}): AnyExtension[] {\n  return createSchemaExtensions({ ...options, format: \"markdown\" });\n}\n\n/**\n * Ảnh — tách địa chỉ LƯU khỏi địa chỉ HIỂN THỊ, và thoát cú pháp khi ghi markdown.\n *\n * Kho ảnh của module Comitor là bucket RIÊNG TƯ: thứ hiện được là URL đã ký, có hạn. Lưu URL đó vào\n * nội dung là lưu một giá trị sẽ chết ngay trong database — nên nội dung giữ `src` app trả về (khoá,\n * hoặc một route ổn định của app), còn `resolveImageSrc` đổi nó thành địa chỉ vẽ được lúc vẽ.\n *\n * ⚠ Đổi địa chỉ ở NODE VIEW, không ở `renderHTML`. `renderHTML` vừa vẽ ảnh trong trình soạn vừa là\n * thứ `editor.getHTML()` dùng để GHI — đổi `src` ở đó (cách của `3.5.0`, khi giá trị còn là markdown)\n * là `RichTextEditor` ghi URL đã ký vào HTML lưu xuống. Node view chỉ là DOM của màn hình; HTML lưu\n * vẫn đi `renderHTML` gốc với `src` gốc.\n *\n * Ảnh ĐANG tải lên không phải node — xem đầu `image-upload.ts`.\n */\nfunction createImageExtension(runtime: { readonly current: MarkdownEditorRuntime }) {\n  return Image.extend({\n    addNodeView() {\n      return ({ node, HTMLAttributes }) => {\n        const image = document.createElement(\"img\");\n        setAttributes(image, mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), [\"src\"]);\n        const src = typeof node.attrs.src === \"string\" ? node.attrs.src : \"\";\n        // `src=\"\"` thì trình duyệt tải lại CHÍNH trang làm ảnh — thiếu địa chỉ thì bỏ hẳn thuộc tính.\n        if (src) image.setAttribute(\"src\", runtime.current.resolveImageSrc?.(src) ?? src);\n        return { dom: image, update: (updated) => sameNode(updated, node) };\n      };\n    },\n    renderMarkdown(node: JSONContent) {\n      return imageMarkdown(String(node.attrs?.src ?? \"\"), node.attrs?.alt, node.attrs?.title);\n    }\n  }).configure({ allowBase64: false });\n}\n\n/**\n * Nhắc tên — định dạng lưu `[@Tên](mention:<id>)` (lý do ở `markdown-syntax.ts`) và tên SỐNG lúc vẽ.\n *\n * Tên sống chỉ đi vào thứ NGƯỜI XEM thấy: node view và `renderText` (chữ khi chép ra ngoài).\n * `renderHTML` — thứ `getHTML()` ghi xuống — giữ TÊN CHỤP lúc nhắc, cùng luật với markdown: nội dung\n * lưu không tự đổi theo danh bạ chỉ vì có người mở và lưu lại.\n */\nfunction createMentionExtension(\n  runtime: { readonly current: MarkdownEditorRuntime },\n  suggestion: MarkdownSchemaOptions[\"mentionSuggestion\"]\n) {\n  const storedLabelOf = (attrs: Record<string, unknown>) => {\n    const stored = typeof attrs.label === \"string\" ? attrs.label : \"\";\n    return stored || (typeof attrs.id === \"string\" ? attrs.id : \"\");\n  };\n  const labelOf = (attrs: Record<string, unknown>) =>\n    runtime.current.resolveMentionLabel?.(typeof attrs.id === \"string\" ? attrs.id : \"\") ?? storedLabelOf(attrs);\n\n  return Mention.extend({\n    markdownTokenName: \"mention\",\n    markdownTokenizer: {\n      name: \"mention\",\n      level: \"inline\",\n      start: (source: string) => source.indexOf(\"[@\"),\n      tokenize: (source: string) => {\n        const parsed = parseMentionMarkdown(source);\n        return parsed ? { type: \"mention\", raw: parsed.raw, id: parsed.id, label: parsed.label } : undefined;\n      }\n    },\n    parseMarkdown: (token, helpers) => helpers.createNode(\"mention\", { id: token.id, label: token.label }),\n    renderMarkdown: (node: JSONContent) =>\n      renderMentionMarkdown(String(node.attrs?.id ?? \"\"), node.attrs?.label as string | null | undefined),\n    addNodeView() {\n      return ({ node, HTMLAttributes }) => {\n        const dom = document.createElement(\"span\");\n        setAttributes(dom, mergeAttributes({ \"data-type\": this.name }, this.options.HTMLAttributes, HTMLAttributes));\n        dom.textContent = `@${labelOf(node.attrs)}`;\n        return { dom, update: (updated) => sameNode(updated, node) };\n      };\n    }\n  }).configure({\n    renderText: ({ node }) => `@${labelOf(node.attrs)}`,\n    // `options.HTMLAttributes` ở đây là bản Tiptap đã trộn sẵn (`data-type`, `data-id`, `data-label`).\n    renderHTML: ({ options, node }) => [\"span\", options.HTMLAttributes, `@${storedLabelOf(node.attrs)}`],\n    suggestion: { char: \"@\", allow: () => false, ...suggestion }\n  });\n}\n\n/** Phím tắt riêng của trình soạn — xem `createEditorKeymap`. */\nexport interface EditorKeymapHandlers {\n  /** ⌘/Ctrl+K — mở ô liên kết. Trả `true` khi đã xử lý. */\n  onLinkShortcut: () => boolean;\n  /** ⌘/Ctrl+Enter ngoài danh sách việc. Trả `false` để phím đi tiếp (xuống dòng cứng của Tiptap). */\n  onSubmitShortcut: () => boolean;\n}\n\n/**\n * Phím tắt của RIÊNG gói, ưu tiên cao hơn mặc định của Tiptap.\n *\n * ⌘/Ctrl+Enter: trong danh sách việc thì tick/bỏ tick mục đang đứng (như Linear); ngoài đó thì gửi\n * (`onSubmit`) — đúng phím mà ô bình luận nào cũng dùng. Không có `onSubmit` thì trả phím về cho\n * Tiptap (bản gốc gán nó cho xuống dòng cứng).\n *\n * ⌘/Ctrl+K: ô liên kết. Không đụng bảng lệnh của shell — listener của shell tự bỏ qua phím khi\n * đích là vùng `contenteditable` (`shell-context.tsx`, nhánh `isTyping`).\n */\nexport function createEditorKeymap(\n  handlers: { readonly current: EditorKeymapHandlers },\n  format: EditorFormat = \"markdown\"\n): Extension {\n  // Chỉ ô bảng MARKDOWN cấm xuống dòng cứng (`ComitorTableCell`); ô bảng HTML chứa được cả khối.\n  const swallowInCell = (editor: { state: { selection: { $from: ResolvedPos } } }) =>\n    format === \"markdown\" && isInTableCell(editor.state.selection.$from);\n  return Extension.create({\n    name: \"comitorEditorKeymap\",\n    priority: 1000,\n    addKeyboardShortcuts() {\n      return {\n        \"Mod-k\": () => handlers.current.onLinkShortcut(),\n        \"Mod-Enter\": ({ editor }) => {\n          const toggled = editor.commands.command(({ tr, state }) => {\n            const { $from } = state.selection;\n            for (let depth = $from.depth; depth > 0; depth--) {\n              const node = $from.node(depth);\n              if (node.type.name !== \"taskItem\") continue;\n              tr.setNodeMarkup($from.before(depth), undefined, { ...node.attrs, checked: !node.attrs.checked });\n              return true;\n            }\n            return false;\n          });\n          if (toggled || handlers.current.onSubmitShortcut()) return true;\n          // Phím đi tiếp tới Tiptap là xuống dòng cứng — trong ô bảng markdown thì nuốt (xem `ComitorTableCell`).\n          return swallowInCell(editor);\n        },\n        \"Shift-Enter\": ({ editor }) => swallowInCell(editor)\n      };\n    }\n  });\n}\n\n/** Con trỏ có đang đứng trong một ô bảng (thường hay tiêu đề) không. */\nfunction isInTableCell($pos: ResolvedPos): boolean {\n  for (let depth = $pos.depth; depth > 0; depth--) {\n    const name = $pos.node(depth).type.name;\n    if (name === \"tableCell\" || name === \"tableHeader\") return true;\n  }\n  return false;\n}\n\n/** Ghi thuộc tính lên phần tử của node view — bỏ giá trị rỗng, như `DOMSerializer` làm với `renderHTML`. */\nfunction setAttributes(element: HTMLElement, attributes: Record<string, unknown>, skip: readonly string[] = []): void {\n  for (const [key, value] of Object.entries(attributes)) {\n    if (skip.includes(key) || value === null || value === undefined || value === false) continue;\n    element.setAttribute(key, String(value));\n  }\n}\n\n/**\n * Node view của nút LÁ (ảnh, nhắc tên): thuộc tính không đổi thì giữ DOM; đổi thì trả `false` để\n * ProseMirror dựng lại — rẻ, và không có trạng thái nào trong DOM đáng giữ.\n */\nfunction sameNode(updated: ProseMirrorNode, current: ProseMirrorNode): boolean {\n  if (updated.type !== current.type) return false;\n  return Object.keys(current.attrs).every((key) => updated.attrs[key] === current.attrs[key]);\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,87 @@
+/**
+ * Phép biến đổi CHUỖI markdown của `MarkdownEditor` — hàm thuần, không nhập Tiptap, không DOM.
+ *
+ * Tách khỏi `markdown-extensions.ts` để cổng `test:editor-markdown` gọi thẳng được từng hàm trên
+ * `dist/`, và để mỗi chỗ vá `@tiptap/markdown` nằm cạnh lý do của nó.
+ *
+ * ── VÌ SAO PHẢI VÁ ───────────────────────────────────────────────────────────────────────────
+ * Markdown là định dạng LƯU của trình soạn (cột mô tả, bình luận, tài liệu; công cụ MCP đọc/ghi
+ * thẳng nó). Nên phép đo đúng không phải "hiện ra có đẹp không" mà là: tài liệu → markdown → tài
+ * liệu có ra ĐÚNG tài liệu ban đầu không. `@tiptap/markdown` 3.31.4 trượt hai ca, cả hai IM LẶNG —
+ * không lỗi, chỉ là lần mở sau nội dung đã khác (đo bằng `MarkdownManager` trên chính bản đó):
+ *
+ *   1. Đoạn văn mở đầu bằng cú pháp KHỐI không được thoát. Đoạn "# không phải tiêu đề" ra
+ *      `# không phải tiêu đề` → mở lại thành TIÊU ĐỀ. Cùng họ: "- …" thành danh sách, "2024. …"
+ *      thành danh sách số bắt đầu từ 2024, dòng toàn `===` biến dòng trên thành tiêu đề, và 4 dấu
+ *      cách đầu đoạn thành khối mã. Bộ thoát nội dòng của nó chỉ lo `\ ` * _ [ ] ~` và thực thể
+ *      HTML. Ca thật dễ gặp nhất: gõ "1. " (luật nhập đổi thành danh sách) rồi ⌘Z để giữ chữ.
+ *   2. Khối mã CHỨA ``` vẫn được bọc bằng ``` — hàng rào bên trong đóng khối sớm, phần còn lại
+ *      thành văn bản thường. Ca thật: tài liệu hướng dẫn viết markdown, đúng thứ đội phần mềm viết.
+ */
+/**
+ * Thoát cú pháp KHỐI ở đầu MỖI dòng của một đoạn văn đã dựng — vá ca 1.
+ *
+ * Mỗi dòng chứ không chỉ dòng đầu: xuống dòng cứng (Shift+Enter) ra `"  \n"`, và dòng sau đó vẫn
+ * mở được một danh sách (danh sách được phép ngắt đoạn văn trong CommonMark).
+ *
+ * Khoảng trắng đầu dòng bị BỎ: markdown vốn bỏ tới 3 dấu cách lúc đọc, còn 4 thì đổi đoạn thành
+ * khối mã — giữ chúng không mua được gì ngoài ca hỏng đó.
+ *
+ * `*` không cần ở đây: bộ thoát nội dòng của `@tiptap/markdown` đã đổi nó thành `\*`. `>` cũng
+ * không: nó ra `>`. Ô bảng đi qua hàm này cũng không sao — `\-` vẫn hiện là `-`.
+ *
+ * @example escapeParagraphMarkdown("# C#")        // "\\# C#"
+ * @example escapeParagraphMarkdown("2024. Mục")   // "2024\\. Mục"
+ */
+declare function escapeParagraphMarkdown(markdown: string): string;
+/**
+ * Hàng rào cho một khối mã — vá ca 2. Luật CommonMark: hàng rào đóng phải dài ít nhất bằng hàng
+ * rào mở, và một dãy backtick NGẮN hơn bên trong không đóng được khối. Nên chọn dài hơn dãy dài
+ * nhất có trong nội dung, tối thiểu 3.
+ *
+ * @example codeFence("a ``` b")  // "````"
+ */
+declare function codeFence(content: string): string;
+/**
+ * Cắt xuống dòng THỪA ở hai đầu chuỗi đã dựng. Bảng ra `"\n| … |\n"` (đã đo), nên một tài liệu mở
+ * đầu bằng bảng có dòng trống ở đầu; còn `TrailingNode` luôn giữ một đoạn rỗng sau khối mã/bảng
+ * cuối, thành `"\n\n"` ở đuôi. Cả hai không đổi nghĩa — chỉ làm hai bản lưu của CÙNG một nội dung
+ * khác nhau, tức một phép so sánh phiên bản báo "có sửa" cho một lần không ai sửa gì.
+ *
+ * Đầu chuỗi chỉ cắt `\n` (dấu cách đầu đoạn đã bị `escapeParagraphMarkdown` bỏ); đuôi cắt mọi
+ * khoảng trắng — kể cả `"  "` của một xuống dòng cứng đứng cuối, thứ không còn nghĩa gì ở đó.
+ */
+declare function trimMarkdown(markdown: string): string;
+/**
+ * Một ảnh markdown — thay bản gốc của `@tiptap/extension-image`, bản ghép thẳng `![${alt}](${src})`
+ * không thoát gì. Hai chỗ hỏng thật với ảnh người dùng tải lên:
+ *   · `alt` mặc định là TÊN TỆP, và tên tệp có `]` lẻ ("bao-gia]v2.png") đóng phần chữ sớm;
+ *   · `src` có dấu cách hay ngoặc tròn (một route app tự đặt) cắt địa chỉ làm đôi.
+ * CommonMark cho bọc địa chỉ trong `<…>` để chứa được cả hai; `<`/`>` bên trong thì mã hoá phần trăm.
+ *
+ * @example imageMarkdown("/files/a b.png", "ảnh]1") // "![ảnh\\]1](</files/a b.png>)"
+ */
+declare function imageMarkdown(src: string, alt?: unknown, title?: unknown): string;
+/** Lược đồ URL của liên kết nhắc tên. Đổi nó là đổi định dạng LƯU — dữ liệu cũ thôi đọc được. */
+declare const MENTION_URL_SCHEME = "mention:";
+/**
+ * Dạng lưu của một lần nhắc tên. Tên rỗng thì dùng id — liên kết không được có chữ rỗng.
+ *
+ * ⚠ `encodeURIComponent` CHỪA `(` và `)` — mà ngoặc tròn chính là thứ đóng phần địa chỉ của liên
+ * kết markdown. Id `user (1)` thì ra `mention:user%20(1)` và cổng `test:editor-markdown` đọc lại thành
+ * một liên kết thường. Mã hoá nốt hai ký tự đó.
+ */
+declare function renderMentionMarkdown(id: string, label?: string | null): string;
+interface ParsedMention {
+    /** Toàn bộ đoạn đã khớp — để bộ tách từ (tokenizer) biết đã ăn bao nhiêu ký tự */
+    raw: string;
+    id: string;
+    label: string;
+}
+/**
+ * Đọc MỘT lần nhắc tên ở ĐẦU chuỗi. Trả `undefined` khi không khớp — kể cả khi phần trăm mã hoá
+ * hỏng (`%E0%A4%A`): khi đó chuỗi được giữ nguyên là chữ thường, thay vì ném lỗi giữa lúc mở tài liệu.
+ */
+declare function parseMentionMarkdown(source: string): ParsedMention | undefined;
+
+export { MENTION_URL_SCHEME, type ParsedMention, codeFence, escapeParagraphMarkdown, imageMarkdown, parseMentionMarkdown, renderMentionMarkdown, trimMarkdown };

package/dist/editor/markdown-syntax.js

@@ -0,0 +1,58 @@
+const ATX_HEADING = /^#{1,6}(?:[ \t]|$)/;
+const BULLET_MARKER = /^[-+](?:[ \t]|$)/;
+const ORDERED_MARKER = /^(\d{1,9})([.)])(?=[ \t]|$)/;
+const SETEXT_UNDERLINE = /^(?:=+|-+)[ \t]*$/;
+function escapeParagraphMarkdown(markdown) {
+  return markdown.split("\n").map((line) => {
+    const text = line.replace(/^[ \t]+/, "");
+    if (ATX_HEADING.test(text) || BULLET_MARKER.test(text) || SETEXT_UNDERLINE.test(text)) return `\\${text}`;
+    const ordered = ORDERED_MARKER.exec(text);
+    if (ordered?.[1]) return `${ordered[1]}\\${text.slice(ordered[1].length)}`;
+    return text;
+  }).join("\n");
+}
+function codeFence(content) {
+  let longest = 0;
+  for (const run of content.match(/`+/g) ?? []) longest = Math.max(longest, run.length);
+  return "`".repeat(Math.max(3, longest + 1));
+}
+function trimMarkdown(markdown) {
+  return markdown.replace(/^\n+/, "").replace(/\s+$/, "");
+}
+function imageMarkdown(src, alt, title) {
+  const text = typeof alt === "string" ? alt.replace(/[\\[\]]/g, "\\$&") : "";
+  const destination = /[\s()<>]/.test(src) ? `<${src.replace(/</g, "%3C").replace(/>/g, "%3E")}>` : src;
+  const escapedTitle = typeof title === "string" ? title.replace(/[\x22\\]/g, "\\$&") : "";
+  const caption = escapedTitle ? ` "${escapedTitle}"` : "";
+  return `![${text}](${destination}${caption})`;
+}
+const MENTION_URL_SCHEME = "mention:";
+const MENTION_LINK = /^\[@((?:\\.|[^\\\]\n])*)\]\(mention:([^()\s]+)\)/;
+function escapeMentionLabel(label) {
+  return label.replace(/[\\[\]]/g, "\\$&");
+}
+function renderMentionMarkdown(id, label) {
+  const encodedId = encodeURIComponent(id).replace(/\(/g, "%28").replace(/\)/g, "%29");
+  return `[@${escapeMentionLabel(label || id)}](${MENTION_URL_SCHEME}${encodedId})`;
+}
+function parseMentionMarkdown(source) {
+  const match = MENTION_LINK.exec(source);
+  if (!match?.[2]) return void 0;
+  try {
+    const id = decodeURIComponent(match[2]);
+    const label = (match[1] ?? "").replace(/\\(.)/g, "$1");
+    return { raw: match[0], id, label: label || id };
+  } catch {
+    return void 0;
+  }
+}
+export {
+  MENTION_URL_SCHEME,
+  codeFence,
+  escapeParagraphMarkdown,
+  imageMarkdown,
+  parseMentionMarkdown,
+  renderMentionMarkdown,
+  trimMarkdown
+};
+//# sourceMappingURL=markdown-syntax.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor/markdown-syntax.ts"],"sourcesContent":["/**\n * Phép biến đổi CHUỖI markdown của `MarkdownEditor` — hàm thuần, không nhập Tiptap, không DOM.\n *\n * Tách khỏi `markdown-extensions.ts` để cổng `test:editor-markdown` gọi thẳng được từng hàm trên\n * `dist/`, và để mỗi chỗ vá `@tiptap/markdown` nằm cạnh lý do của nó.\n *\n * ── VÌ SAO PHẢI VÁ ───────────────────────────────────────────────────────────────────────────\n * Markdown là định dạng LƯU của trình soạn (cột mô tả, bình luận, tài liệu; công cụ MCP đọc/ghi\n * thẳng nó). Nên phép đo đúng không phải \"hiện ra có đẹp không\" mà là: tài liệu → markdown → tài\n * liệu có ra ĐÚNG tài liệu ban đầu không. `@tiptap/markdown` 3.31.4 trượt hai ca, cả hai IM LẶNG —\n * không lỗi, chỉ là lần mở sau nội dung đã khác (đo bằng `MarkdownManager` trên chính bản đó):\n *\n *   1. Đoạn văn mở đầu bằng cú pháp KHỐI không được thoát. Đoạn \"# không phải tiêu đề\" ra\n *      `# không phải tiêu đề` → mở lại thành TIÊU ĐỀ. Cùng họ: \"- …\" thành danh sách, \"2024. …\"\n *      thành danh sách số bắt đầu từ 2024, dòng toàn `===` biến dòng trên thành tiêu đề, và 4 dấu\n *      cách đầu đoạn thành khối mã. Bộ thoát nội dòng của nó chỉ lo `\\ ` * _ [ ] ~` và thực thể\n *      HTML. Ca thật dễ gặp nhất: gõ \"1. \" (luật nhập đổi thành danh sách) rồi ⌘Z để giữ chữ.\n *   2. Khối mã CHỨA ``` vẫn được bọc bằng ``` — hàng rào bên trong đóng khối sớm, phần còn lại\n *      thành văn bản thường. Ca thật: tài liệu hướng dẫn viết markdown, đúng thứ đội phần mềm viết.\n */\n\n/** Cú pháp khối mở đầu một dòng — xem ca 1 ở đầu file. */\nconst ATX_HEADING = /^#{1,6}(?:[ \\t]|$)/;\nconst BULLET_MARKER = /^[-+](?:[ \\t]|$)/;\nconst ORDERED_MARKER = /^(\\d{1,9})([.)])(?=[ \\t]|$)/;\nconst SETEXT_UNDERLINE = /^(?:=+|-+)[ \\t]*$/;\n\n/**\n * Thoát cú pháp KHỐI ở đầu MỖI dòng của một đoạn văn đã dựng — vá ca 1.\n *\n * Mỗi dòng chứ không chỉ dòng đầu: xuống dòng cứng (Shift+Enter) ra `\"  \\n\"`, và dòng sau đó vẫn\n * mở được một danh sách (danh sách được phép ngắt đoạn văn trong CommonMark).\n *\n * Khoảng trắng đầu dòng bị BỎ: markdown vốn bỏ tới 3 dấu cách lúc đọc, còn 4 thì đổi đoạn thành\n * khối mã — giữ chúng không mua được gì ngoài ca hỏng đó.\n *\n * `*` không cần ở đây: bộ thoát nội dòng của `@tiptap/markdown` đã đổi nó thành `\\*`. `>` cũng\n * không: nó ra `&gt;`. Ô bảng đi qua hàm này cũng không sao — `\\-` vẫn hiện là `-`.\n *\n * @example escapeParagraphMarkdown(\"# C#\")        // \"\\\\# C#\"\n * @example escapeParagraphMarkdown(\"2024. Mục\")   // \"2024\\\\. Mục\"\n */\nexport function escapeParagraphMarkdown(markdown: string): string {\n  return markdown\n    .split(\"\\n\")\n    .map((line) => {\n      const text = line.replace(/^[ \\t]+/, \"\");\n      if (ATX_HEADING.test(text) || BULLET_MARKER.test(text) || SETEXT_UNDERLINE.test(text)) return `\\\\${text}`;\n      const ordered = ORDERED_MARKER.exec(text);\n      if (ordered?.[1]) return `${ordered[1]}\\\\${text.slice(ordered[1].length)}`;\n      return text;\n    })\n    .join(\"\\n\");\n}\n\n/**\n * Hàng rào cho một khối mã — vá ca 2. Luật CommonMark: hàng rào đóng phải dài ít nhất bằng hàng\n * rào mở, và một dãy backtick NGẮN hơn bên trong không đóng được khối. Nên chọn dài hơn dãy dài\n * nhất có trong nội dung, tối thiểu 3.\n *\n * @example codeFence(\"a ``` b\")  // \"````\"\n */\nexport function codeFence(content: string): string {\n  let longest = 0;\n  for (const run of content.match(/`+/g) ?? []) longest = Math.max(longest, run.length);\n  return \"`\".repeat(Math.max(3, longest + 1));\n}\n\n/**\n * Cắt xuống dòng THỪA ở hai đầu chuỗi đã dựng. Bảng ra `\"\\n| … |\\n\"` (đã đo), nên một tài liệu mở\n * đầu bằng bảng có dòng trống ở đầu; còn `TrailingNode` luôn giữ một đoạn rỗng sau khối mã/bảng\n * cuối, thành `\"\\n\\n\"` ở đuôi. Cả hai không đổi nghĩa — chỉ làm hai bản lưu của CÙNG một nội dung\n * khác nhau, tức một phép so sánh phiên bản báo \"có sửa\" cho một lần không ai sửa gì.\n *\n * Đầu chuỗi chỉ cắt `\\n` (dấu cách đầu đoạn đã bị `escapeParagraphMarkdown` bỏ); đuôi cắt mọi\n * khoảng trắng — kể cả `\"  \"` của một xuống dòng cứng đứng cuối, thứ không còn nghĩa gì ở đó.\n */\nexport function trimMarkdown(markdown: string): string {\n  return markdown.replace(/^\\n+/, \"\").replace(/\\s+$/, \"\");\n}\n\n/**\n * Một ảnh markdown — thay bản gốc của `@tiptap/extension-image`, bản ghép thẳng `![${alt}](${src})`\n * không thoát gì. Hai chỗ hỏng thật với ảnh người dùng tải lên:\n *   · `alt` mặc định là TÊN TỆP, và tên tệp có `]` lẻ (\"bao-gia]v2.png\") đóng phần chữ sớm;\n *   · `src` có dấu cách hay ngoặc tròn (một route app tự đặt) cắt địa chỉ làm đôi.\n * CommonMark cho bọc địa chỉ trong `<…>` để chứa được cả hai; `<`/`>` bên trong thì mã hoá phần trăm.\n *\n * @example imageMarkdown(\"/files/a b.png\", \"ảnh]1\") // \"![ảnh\\\\]1](</files/a b.png>)\"\n */\nexport function imageMarkdown(src: string, alt?: unknown, title?: unknown): string {\n  const text = typeof alt === \"string\" ? alt.replace(/[\\\\[\\]]/g, \"\\\\$&\") : \"\";\n  const destination = /[\\s()<>]/.test(src) ? `<${src.replace(/</g, \"%3C\").replace(/>/g, \"%3E\")}>` : src;\n  // `\\x22` là dấu nháy kép. Viết thẳng ký tự đó trong regex literal thì bộ quét của `test:i18n` (không\n  // hiểu regex) tưởng là mở một chuỗi, và báo nửa sau của file là chữ hiển thị tiếng Việt — đã gặp.\n  const escapedTitle = typeof title === \"string\" ? title.replace(/[\\x22\\\\]/g, \"\\\\$&\") : \"\";\n  const caption = escapedTitle ? ` \"${escapedTitle}\"` : \"\";\n  return `![${text}](${destination}${caption})`;\n}\n\n/*\n * ── NHẮC TÊN (`@`) ───────────────────────────────────────────────────────────────────────────\n * Dạng lưu là một LIÊN KẾT markdown thường: `[@Tên hiển thị](mention:<id>)`.\n *\n * Không dùng dạng mặc định của Tiptap (`[@ id=\"…\" label=\"…\"]`): đó là cú pháp riêng, nên mọi chỗ\n * đọc markdown mà không có Tiptap — email thông báo, tác tử đọc qua MCP, trình xem markdown bất kỳ —\n * in nguyên chuỗi ngoặc vuông ra cho người đọc. Dạng liên kết thì rơi về đúng chữ \"@Tên\": trình xem\n * nào bỏ lược đồ lạ thì còn chữ, trình nào giữ thì còn cả liên kết.\n *\n * Tên trong đó chỉ là ẢNH CHỤP lúc nhắc. Thứ có thẩm quyền là `id` — tên sống thì app tra lại khi\n * hiển thị (`mentions.resolveLabel`), cùng lý do một module Comitor không giữ cột tên người.\n */\n\n/** Lược đồ URL của liên kết nhắc tên. Đổi nó là đổi định dạng LƯU — dữ liệu cũ thôi đọc được. */\nexport const MENTION_URL_SCHEME = \"mention:\";\n\n/*\n * Tên: mọi ký tự trừ `]` và `\\` trần (chúng đi kèm dấu thoát), không xuống dòng. Id: không dấu\n * cách, không ngoặc tròn — `renderMentionMarkdown` đã mã hoá phần trăm mọi ký tự đặc biệt.\n */\nconst MENTION_LINK = /^\\[@((?:\\\\.|[^\\\\\\]\\n])*)\\]\\(mention:([^()\\s]+)\\)/;\n\n/** Thoát `\\`, `[`, `]` trong tên — ba ký tự duy nhất phá được cấu trúc `[@…](…)`. */\nfunction escapeMentionLabel(label: string): string {\n  return label.replace(/[\\\\[\\]]/g, \"\\\\$&\");\n}\n\n/**\n * Dạng lưu của một lần nhắc tên. Tên rỗng thì dùng id — liên kết không được có chữ rỗng.\n *\n * ⚠ `encodeURIComponent` CHỪA `(` và `)` — mà ngoặc tròn chính là thứ đóng phần địa chỉ của liên\n * kết markdown. Id `user (1)` thì ra `mention:user%20(1)` và cổng `test:editor-markdown` đọc lại thành\n * một liên kết thường. Mã hoá nốt hai ký tự đó.\n */\nexport function renderMentionMarkdown(id: string, label?: string | null): string {\n  const encodedId = encodeURIComponent(id).replace(/\\(/g, \"%28\").replace(/\\)/g, \"%29\");\n  return `[@${escapeMentionLabel(label || id)}](${MENTION_URL_SCHEME}${encodedId})`;\n}\n\nexport interface ParsedMention {\n  /** Toàn bộ đoạn đã khớp — để bộ tách từ (tokenizer) biết đã ăn bao nhiêu ký tự */\n  raw: string;\n  id: string;\n  label: string;\n}\n\n/**\n * Đọc MỘT lần nhắc tên ở ĐẦU chuỗi. Trả `undefined` khi không khớp — kể cả khi phần trăm mã hoá\n * hỏng (`%E0%A4%A`): khi đó chuỗi được giữ nguyên là chữ thường, thay vì ném lỗi giữa lúc mở tài liệu.\n */\nexport function parseMentionMarkdown(source: string): ParsedMention | undefined {\n  const match = MENTION_LINK.exec(source);\n  if (!match?.[2]) return undefined;\n  try {\n    const id = decodeURIComponent(match[2]);\n    const label = (match[1] ?? \"\").replace(/\\\\(.)/g, \"$1\");\n    return { raw: match[0], id, label: label || id };\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"AAsBA,MAAM,cAAc;AACpB,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AACvB,MAAM,mBAAmB;AAiBlB,SAAS,wBAAwB,UAA0B;AAChE,SAAO,SACJ,MAAM,IAAI,EACV,IAAI,CAAC,SAAS;AACb,UAAM,OAAO,KAAK,QAAQ,WAAW,EAAE;AACvC,QAAI,YAAY,KAAK,IAAI,KAAK,cAAc,KAAK,IAAI,KAAK,iBAAiB,KAAK,IAAI,EAAG,QAAO,KAAK,IAAI;AACvG,UAAM,UAAU,eAAe,KAAK,IAAI;AACxC,QAAI,UAAU,CAAC,EAAG,QAAO,GAAG,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM,QAAQ,CAAC,EAAE,MAAM,CAAC;AACxE,WAAO;AAAA,EACT,CAAC,EACA,KAAK,IAAI;AACd;AASO,SAAS,UAAU,SAAyB;AACjD,MAAI,UAAU;AACd,aAAW,OAAO,QAAQ,MAAM,KAAK,KAAK,CAAC,EAAG,WAAU,KAAK,IAAI,SAAS,IAAI,MAAM;AACpF,SAAO,IAAI,OAAO,KAAK,IAAI,GAAG,UAAU,CAAC,CAAC;AAC5C;AAWO,SAAS,aAAa,UAA0B;AACrD,SAAO,SAAS,QAAQ,QAAQ,EAAE,EAAE,QAAQ,QAAQ,EAAE;AACxD;AAWO,SAAS,cAAc,KAAa,KAAe,OAAyB;AACjF,QAAM,OAAO,OAAO,QAAQ,WAAW,IAAI,QAAQ,YAAY,MAAM,IAAI;AACzE,QAAM,cAAc,WAAW,KAAK,GAAG,IAAI,IAAI,IAAI,QAAQ,MAAM,KAAK,EAAE,QAAQ,MAAM,KAAK,CAAC,MAAM;AAGlG,QAAM,eAAe,OAAO,UAAU,WAAW,MAAM,QAAQ,aAAa,MAAM,IAAI;AACtF,QAAM,UAAU,eAAe,KAAK,YAAY,MAAM;AACtD,SAAO,KAAK,IAAI,KAAK,WAAW,GAAG,OAAO;AAC5C;AAgBO,MAAM,qBAAqB;AAMlC,MAAM,eAAe;AAGrB,SAAS,mBAAmB,OAAuB;AACjD,SAAO,MAAM,QAAQ,YAAY,MAAM;AACzC;AASO,SAAS,sBAAsB,IAAY,OAA+B;AAC/E,QAAM,YAAY,mBAAmB,EAAE,EAAE,QAAQ,OAAO,KAAK,EAAE,QAAQ,OAAO,KAAK;AACnF,SAAO,KAAK,mBAAmB,SAAS,EAAE,CAAC,KAAK,kBAAkB,GAAG,SAAS;AAChF;AAaO,SAAS,qBAAqB,QAA2C;AAC9E,QAAM,QAAQ,aAAa,KAAK,MAAM;AACtC,MAAI,CAAC,QAAQ,CAAC,EAAG,QAAO;AACxB,MAAI;AACF,UAAM,KAAK,mBAAmB,MAAM,CAAC,CAAC;AACtC,UAAM,SAAS,MAAM,CAAC,KAAK,IAAI,QAAQ,UAAU,IAAI;AACrD,WAAO,EAAE,KAAK,MAAM,CAAC,GAAG,IAAI,OAAO,SAAS,GAAG;AAAA,EACjD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}