tiptap-markdown-react 0.8.3 → 0.8.5

package/dist/math.d.ts

@@ -9,6 +9,8 @@ type MathClickListener = (payload: MathClickPayload) => void;
 export declare function subscribeMathClick(listener: MathClickListener): () => void;
 /** KaTeX HTML 片段（SSR / 预览弹层）。失败时回退为转义原文。 */
 export declare function renderMathHtml(latex: string, displayMode: boolean): string;
+/** 把公式画进已有节点（编辑态原地预览，避免再叠一份 overlay）。 */
+export declare function renderMathInto(el: HTMLElement, latex: string, displayMode: boolean): void;
 export declare function renderMathElementHtml(latex: string, displayMode: boolean): string;
 /**
  * 行内公式：markdown 为 `$$latex$$`（单行、无换行）。

package/dist/renderReportHtml.d.ts

@@ -20,11 +20,26 @@ import { TocItem } from './toc/extractToc';
 export interface RenderedReport {
     html: string;
     toc: TocItem[];
+    /**
+     * 管线是否成功。空 markdown 也是 ok。
+     * parse / render 抛错时为 false；调用方可保留上一帧 HTML。
+     */
+    ok: boolean;
 }
 export interface RenderReportHtmlOptions {
     /** 被付费墙锁住的章节标题（TOC 标 locked）。 */
     lockedTitles?: string[];
     /** 脚注来源，按 index 对齐 `[^n]`。 */
     sources?: SourceRef[];
+    /**
+     * 是否注入标题锚点并返回 toc。默认 true（`/p` 阅读页）。
+     * 卡片预览传 false，跳过 generateTocIds。
+     */
+    includeToc?: boolean;
+    /**
+     * 流式半成品：补未闭合代码围栏。默认 false。
+     * 完整落库稿不要开，以免改已发布 HTML。
+     */
+    stabilize?: boolean;
 }
 export declare function renderReportHtml(markdown: string, lockedTitlesOrOptions?: string[] | RenderReportHtmlOptions): RenderedReport;

package/dist/renderReportHtml.options.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server.d.ts

@@ -9,5 +9,6 @@ export { mapCommentAnchors, mergeCommentIntervals, blockTextHash, type CommentSe
 export { applyCitationSources, enrichMarkdownCitations, type SourceRef, } from './citationUtils';
 export { ReportContent, type ReportContentProps } from './ReportContent';
 export { renderReportHtml, type RenderedReport, type RenderReportHtmlOptions, } from './renderReportHtml';
+export { stabilizeMarkdown } from './stabilizeMarkdown';
 export { extractToc, type TocItem } from './toc/extractToc';
 export { makeTocGetId } from './toc/tocSlug';

package/dist/server.js

@@ -1,5 +1,5 @@
-import { h as applyCitationSources, b as baseExtensions, p as pureCodeBlock, f as pureImage, C as CitationRef, d as makeTocGetId, k as renderMathElementHtml, j as extractToc } from "./extractToc-CMvSKha8.js";
-import { c, R, i, e, l, a, m } from "./extractToc-CMvSKha8.js";
+import { k as stabilizeMarkdown, h as applyCitationSources, b as baseExtensions, p as pureCodeBlock, f as pureImage, C as CitationRef, d as makeTocGetId, n as renderMathElementHtml, j as extractToc } from "./extractToc-bgvj5gGC.js";
+import { c, R, i, e, l, a, m } from "./extractToc-bgvj5gGC.js";
 import { TableOfContents, generateTocIds } from "@tiptap/extension-table-of-contents";
 import { MarkdownManager } from "@tiptap/markdown";
 import { renderToHTMLString } from "@tiptap/static-renderer";
@@ -12,15 +12,62 @@ const sharedManager = new MarkdownManager({
     TableOfContents
   ]
 });
+function htmlFromJson(json) {
+  const extensions = [
+    ...baseExtensions,
+    pureCodeBlock,
+    pureImage,
+    CitationRef,
+    TableOfContents.configure({ getId: makeTocGetId() })
+  ];
+  return renderToHTMLString({
+    extensions,
+    content: json,
+    options: {
+      nodeMapping: {
+        inlineMath: ({ node }) => {
+          var _a;
+          return renderMathElementHtml(String(((_a = node.attrs) == null ? void 0 : _a.latex) ?? ""), false);
+        },
+        blockMath: ({ node }) => {
+          var _a;
+          return renderMathElementHtml(String(((_a = node.attrs) == null ? void 0 : _a.latex) ?? ""), true);
+        }
+      }
+    }
+  });
+}
 function renderReportHtml(markdown, lockedTitlesOrOptions = []) {
-  if (!(markdown == null ? void 0 : markdown.trim())) return { html: "", toc: [] };
+  if (!(markdown == null ? void 0 : markdown.trim())) return { html: "", toc: [], ok: true };
   const options = Array.isArray(lockedTitlesOrOptions) ? { lockedTitles: lockedTitlesOrOptions } : lockedTitlesOrOptions;
   const lockedTitles = options.lockedTitles ?? [];
   const sources = options.sources ?? [];
-  const json = applyCitationSources(
-    sharedManager.parse(markdown),
-    sources
-  );
+  const includeToc = options.includeToc !== false;
+  const input = options.stabilize ? stabilizeMarkdown(markdown) : markdown;
+  let json;
+  try {
+    json = applyCitationSources(
+      sharedManager.parse(input),
+      sources
+    );
+  } catch (e2) {
+    console.error(
+      "[renderReportHtml] markdown parse failed:",
+      e2.message
+    );
+    return { html: "", toc: [], ok: false };
+  }
+  if (!includeToc) {
+    try {
+      return { html: htmlFromJson(json), toc: [], ok: true };
+    } catch (e2) {
+      console.error(
+        "[renderReportHtml] render failed (no toc):",
+        e2.message
+      );
+      return { html: "", toc: [], ok: false };
+    }
+  }
   const extensions = [
     ...baseExtensions,
     pureCodeBlock,
@@ -46,13 +93,21 @@ function renderReportHtml(markdown, lockedTitlesOrOptions = []) {
         }
       }
     });
-    return { html, toc: extractToc(jsonWithIds, lockedTitles) };
+    return { html, toc: extractToc(jsonWithIds, lockedTitles), ok: true };
   } catch (e2) {
     console.error(
-      "[renderReportHtml] Tiptap pipeline failed, falling back to empty content:",
+      "[renderReportHtml] TOC pipeline failed, rendering without heading ids:",
       e2.message
     );
-    return { html: "", toc: [] };
+    try {
+      return { html: htmlFromJson(json), toc: [], ok: true };
+    } catch (e22) {
+      console.error(
+        "[renderReportHtml] Tiptap pipeline failed:",
+        e22.message
+      );
+      return { html: "", toc: [], ok: false };
+    }
   }
 }
 export {
@@ -70,6 +125,7 @@ export {
   m as mergeCommentIntervals,
   pureCodeBlock,
   pureImage,
-  renderReportHtml
+  renderReportHtml,
+  stabilizeMarkdown
 };
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sources":["../src/renderReportHtml.ts"],"sourcesContent":["import {\n  generateTocIds,\n  TableOfContents,\n} from '@tiptap/extension-table-of-contents';\nimport type { JSONContent } from '@tiptap/core';\nimport { MarkdownManager } from '@tiptap/markdown';\nimport { renderToHTMLString } from '@tiptap/static-renderer';\nimport {\n  applyCitationSources,\n  type SourceRef,\n} from './citationUtils';\nimport { CitationRef } from './CitationRef';\nimport { baseExtensions, pureCodeBlock, pureImage } from './extensions';\nimport { renderMathElementHtml } from './math';\nimport { extractToc, type TocItem } from './toc/extractToc';\nimport { makeTocGetId } from './toc/tocSlug';\n\n/**\n * server 端把 markdown 渲成 HTML 字符串 + 目录（纯函数，无 editor / 无 window）。\n *\n * 走官方管线 `MarkdownManager.parse → generateTocIds → renderToHTMLString`，可在\n * Server Component / ISR 里直接跑，正文 HTML + 锚点 id 进静态产物，兑现 SEO / 首屏。\n *\n * 扩展集与编辑器同源（base + 纯版 CodeBlock/Image）+ TableOfContents。TOC 扩展在 v3\n * 会扩展 Heading schema 使 id 渲染进 HTML；`generateTocIds` 是官方纯函数（无 editor /\n * 无 window，专为「renderToHTMLString 前在 server 注入锚点」设计）。\n * 锚点用 slug + 去重（makeTocGetId），跨 SSR / ISR 稳定、可分享。\n *\n * `[^n]` 由 CitationRef tokenizer 解析；`sources` 经 {@link applyCitationSources}\n * 补 url/title（不依赖 DOMParser，避免 server 内联 HTML 失效）。\n *\n * 已知边界：官方包解析内联 HTML 依赖 window.DOMParser，server 端无 window 会把\n * 内联 HTML（如 <u>）转义为字面文本。\n */\nexport interface RenderedReport {\n  html: string;\n  toc: TocItem[];\n}\n\nexport interface RenderReportHtmlOptions {\n  /** 被付费墙锁住的章节标题（TOC 标 locked）。 */\n  lockedTitles?: string[];\n  /** 脚注来源，按 index 对齐 `[^n]`。 */\n  sources?: SourceRef[];\n}\n\n// [perf] 模块级复用单个 MarkdownManager。每次 `new MarkdownManager` 会让底层 marked\n// 全局累积扩展，parse 逐次变慢。parse 只用 schema、与 TOC 的 getId 无关，可跨调用\n// 安全复用；getId 相关的锚点注入放在 generateTocIds 阶段、用每篇新建的 extensions 处理。\nconst sharedManager = new MarkdownManager({\n  extensions: [\n    ...baseExtensions,\n    pureCodeBlock,\n    pureImage,\n    CitationRef,\n    TableOfContents,\n  ],\n});\n\nexport function renderReportHtml(\n  markdown: string,\n  lockedTitlesOrOptions: string[] | RenderReportHtmlOptions = [],\n): RenderedReport {\n  if (!markdown?.trim()) return { html: '', toc: [] };\n\n  const options: RenderReportHtmlOptions = Array.isArray(lockedTitlesOrOptions)\n    ? { lockedTitles: lockedTitlesOrOptions }\n    : lockedTitlesOrOptions;\n  const lockedTitles = options.lockedTitles ?? [];\n  const sources = options.sources ?? [];\n\n  const json = applyCitationSources(\n    sharedManager.parse(markdown) as JSONContent,\n    sources,\n  );\n\n  // getId 是有状态去重闭包，每篇必须重置，否则锚点 id 跨调用串号。这份 extensions\n  // 只喂 generateTocIds / renderToHTMLString——schema 与 sharedManager 一致（仅 getId\n  // 配置不同，不影响 schema），故对 sharedManager.parse 出的 json 兼容。\n  const extensions = [\n    ...baseExtensions,\n    pureCodeBlock,\n    pureImage,\n    CitationRef,\n    TableOfContents.configure({ getId: makeTocGetId() }),\n  ];\n  try {\n    // 给 heading 注入 id / data-toc-id（server 端，renderToHTMLString 前）。\n    const jsonWithIds = generateTocIds(json, extensions);\n    const html = renderToHTMLString({\n      extensions,\n      content: jsonWithIds,\n      options: {\n        nodeMapping: {\n          inlineMath: ({ node }) =>\n            renderMathElementHtml(String(node.attrs?.latex ?? ''), false),\n          blockMath: ({ node }) =>\n            renderMathElementHtml(String(node.attrs?.latex ?? ''), true),\n        },\n      },\n    });\n    return { html, toc: extractToc(jsonWithIds, lockedTitles) };\n  } catch (e) {\n    // 某些 markdown 经 parse 产出的 JSON 可能在 heading 内嵌套 block 级子节点，\n    // 导致 generateTocIds 的 setNodeMarkup 校验失败。单篇异常不应拖垮整个构建，\n    // 降级返回空内容。\n    console.error(\n      '[renderReportHtml] Tiptap pipeline failed, falling back to empty content:',\n      (e as Error).message,\n    );\n    return { html: '', toc: [] };\n  }\n}\n"],"names":["e"],"mappings":";;;;;AAiDA,MAAM,gBAAgB,IAAI,gBAAgB;AAAA,EACxC,YAAY;AAAA,IACV,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ,CAAC;AAEM,SAAS,iBACd,UACA,wBAA4D,IAC5C;AAChB,MAAI,EAAC,qCAAU,QAAQ,QAAO,EAAE,MAAM,IAAI,KAAK,GAAC;AAEhD,QAAM,UAAmC,MAAM,QAAQ,qBAAqB,IACxE,EAAE,cAAc,0BAChB;AACJ,QAAM,eAAe,QAAQ,gBAAgB,CAAA;AAC7C,QAAM,UAAU,QAAQ,WAAW,CAAA;AAEnC,QAAM,OAAO;AAAA,IACX,cAAc,MAAM,QAAQ;AAAA,IAC5B;AAAA,EAAA;AAMF,QAAM,aAAa;AAAA,IACjB,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB,UAAU,EAAE,OAAO,aAAA,GAAgB;AAAA,EAAA;AAErD,MAAI;AAEF,UAAM,cAAc,eAAe,MAAM,UAAU;AACnD,UAAM,OAAO,mBAAmB;AAAA,MAC9B;AAAA,MACA,SAAS;AAAA,MACT,SAAS;AAAA,QACP,aAAa;AAAA,UACX,YAAY,CAAC,EAAE,KAAA,MAAK;;AAClB,yCAAsB,SAAO,UAAK,UAAL,mBAAY,UAAS,EAAE,GAAG,KAAK;AAAA;AAAA,UAC9D,WAAW,CAAC,EAAE,KAAA,MAAK;;AACjB,yCAAsB,SAAO,UAAK,UAAL,mBAAY,UAAS,EAAE,GAAG,IAAI;AAAA;AAAA,QAAA;AAAA,MAC/D;AAAA,IACF,CACD;AACD,WAAO,EAAE,MAAM,KAAK,WAAW,aAAa,YAAY,EAAA;AAAA,EAC1D,SAASA,IAAG;AAIV,YAAQ;AAAA,MACN;AAAA,MACCA,GAAY;AAAA,IAAA;AAEf,WAAO,EAAE,MAAM,IAAI,KAAK,CAAA,EAAC;AAAA,EAC3B;AACF;"}
+{"version":3,"file":"server.js","sources":["../src/renderReportHtml.ts"],"sourcesContent":["import {\n  generateTocIds,\n  TableOfContents,\n} from '@tiptap/extension-table-of-contents';\nimport type { JSONContent } from '@tiptap/core';\nimport { MarkdownManager } from '@tiptap/markdown';\nimport { renderToHTMLString } from '@tiptap/static-renderer';\nimport {\n  applyCitationSources,\n  type SourceRef,\n} from './citationUtils';\nimport { CitationRef } from './CitationRef';\nimport { baseExtensions, pureCodeBlock, pureImage } from './extensions';\nimport { renderMathElementHtml } from './math';\nimport { stabilizeMarkdown } from './stabilizeMarkdown';\nimport { extractToc, type TocItem } from './toc/extractToc';\nimport { makeTocGetId } from './toc/tocSlug';\n\n/**\n * server 端把 markdown 渲成 HTML 字符串 + 目录（纯函数，无 editor / 无 window）。\n *\n * 走官方管线 `MarkdownManager.parse → generateTocIds → renderToHTMLString`，可在\n * Server Component / ISR 里直接跑，正文 HTML + 锚点 id 进静态产物，兑现 SEO / 首屏。\n *\n * 扩展集与编辑器同源（base + 纯版 CodeBlock/Image）+ TableOfContents。TOC 扩展在 v3\n * 会扩展 Heading schema 使 id 渲染进 HTML；`generateTocIds` 是官方纯函数（无 editor /\n * 无 window，专为「renderToHTMLString 前在 server 注入锚点」设计）。\n * 锚点用 slug + 去重（makeTocGetId），跨 SSR / ISR 稳定、可分享。\n *\n * `[^n]` 由 CitationRef tokenizer 解析；`sources` 经 {@link applyCitationSources}\n * 补 url/title（不依赖 DOMParser，避免 server 内联 HTML 失效）。\n *\n * 已知边界：官方包解析内联 HTML 依赖 window.DOMParser，server 端无 window 会把\n * 内联 HTML（如 <u>）转义为字面文本。\n */\nexport interface RenderedReport {\n  html: string;\n  toc: TocItem[];\n  /**\n   * 管线是否成功。空 markdown 也是 ok。\n   * parse / render 抛错时为 false；调用方可保留上一帧 HTML。\n   */\n  ok: boolean;\n}\n\nexport interface RenderReportHtmlOptions {\n  /** 被付费墙锁住的章节标题（TOC 标 locked）。 */\n  lockedTitles?: string[];\n  /** 脚注来源，按 index 对齐 `[^n]`。 */\n  sources?: SourceRef[];\n  /**\n   * 是否注入标题锚点并返回 toc。默认 true（`/p` 阅读页）。\n   * 卡片预览传 false，跳过 generateTocIds。\n   */\n  includeToc?: boolean;\n  /**\n   * 流式半成品：补未闭合代码围栏。默认 false。\n   * 完整落库稿不要开，以免改已发布 HTML。\n   */\n  stabilize?: boolean;\n}\n\n// [perf] 模块级复用单个 MarkdownManager。每次 `new MarkdownManager` 会让底层 marked\n// 全局累积扩展，parse 逐次变慢。parse 只用 schema、与 TOC 的 getId 无关，可跨调用\n// 安全复用；getId 相关的锚点注入放在 generateTocIds 阶段、用每篇新建的 extensions 处理。\nconst sharedManager = new MarkdownManager({\n  extensions: [\n    ...baseExtensions,\n    pureCodeBlock,\n    pureImage,\n    CitationRef,\n    TableOfContents,\n  ],\n});\n\nfunction htmlFromJson(json: JSONContent): string {\n  const extensions = [\n    ...baseExtensions,\n    pureCodeBlock,\n    pureImage,\n    CitationRef,\n    TableOfContents.configure({ getId: makeTocGetId() }),\n  ];\n  return renderToHTMLString({\n    extensions,\n    content: json,\n    options: {\n      nodeMapping: {\n        inlineMath: ({ node }) =>\n          renderMathElementHtml(String(node.attrs?.latex ?? ''), false),\n        blockMath: ({ node }) =>\n          renderMathElementHtml(String(node.attrs?.latex ?? ''), true),\n      },\n    },\n  });\n}\n\nexport function renderReportHtml(\n  markdown: string,\n  lockedTitlesOrOptions: string[] | RenderReportHtmlOptions = [],\n): RenderedReport {\n  if (!markdown?.trim()) return { html: '', toc: [], ok: true };\n\n  const options: RenderReportHtmlOptions = Array.isArray(lockedTitlesOrOptions)\n    ? { lockedTitles: lockedTitlesOrOptions }\n    : lockedTitlesOrOptions;\n  const lockedTitles = options.lockedTitles ?? [];\n  const sources = options.sources ?? [];\n  const includeToc = options.includeToc !== false;\n  const input = options.stabilize ? stabilizeMarkdown(markdown) : markdown;\n\n  let json: JSONContent;\n  try {\n    json = applyCitationSources(\n      sharedManager.parse(input) as JSONContent,\n      sources,\n    );\n  } catch (e) {\n    console.error(\n      '[renderReportHtml] markdown parse failed:',\n      (e as Error).message,\n    );\n    return { html: '', toc: [], ok: false };\n  }\n\n  if (!includeToc) {\n    try {\n      return { html: htmlFromJson(json), toc: [], ok: true };\n    } catch (e) {\n      console.error(\n        '[renderReportHtml] render failed (no toc):',\n        (e as Error).message,\n      );\n      return { html: '', toc: [], ok: false };\n    }\n  }\n\n  // getId 是有状态去重闭包，每篇必须重置，否则锚点 id 跨调用串号。这份 extensions\n  // 只喂 generateTocIds / renderToHTMLString——schema 与 sharedManager 一致（仅 getId\n  // 配置不同，不影响 schema），故对 sharedManager.parse 出的 json 兼容。\n  const extensions = [\n    ...baseExtensions,\n    pureCodeBlock,\n    pureImage,\n    CitationRef,\n    TableOfContents.configure({ getId: makeTocGetId() }),\n  ];\n  try {\n    const jsonWithIds = generateTocIds(json, extensions);\n    const html = renderToHTMLString({\n      extensions,\n      content: jsonWithIds,\n      options: {\n        nodeMapping: {\n          inlineMath: ({ node }) =>\n            renderMathElementHtml(String(node.attrs?.latex ?? ''), false),\n          blockMath: ({ node }) =>\n            renderMathElementHtml(String(node.attrs?.latex ?? ''), true),\n        },\n      },\n    });\n    return { html, toc: extractToc(jsonWithIds, lockedTitles), ok: true };\n  } catch (e) {\n    // 某些 markdown 经 parse 产出的 JSON 可能在 heading 内嵌套 block 级子节点，\n    // 导致 generateTocIds 的 setNodeMarkup 校验失败。降级为无 TOC 仍产出正文。\n    console.error(\n      '[renderReportHtml] TOC pipeline failed, rendering without heading ids:',\n      (e as Error).message,\n    );\n    try {\n      return { html: htmlFromJson(json), toc: [], ok: true };\n    } catch (e2) {\n      console.error(\n        '[renderReportHtml] Tiptap pipeline failed:',\n        (e2 as Error).message,\n      );\n      return { html: '', toc: [], ok: false };\n    }\n  }\n}\n"],"names":["e","e2"],"mappings":"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"}

package/dist/stabilizeMarkdown.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 给流式半成品 markdown 补闭合围栏，避免未结束的 ``` 把后文吞进 code。
+ * 完整稿不要调用（ISR / 已落库卡）。
+ */
+export declare function stabilizeMarkdown(markdown: string): string;

package/dist/stabilizeMarkdown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/style.css

@@ -328,9 +328,10 @@
   color: #c0392b;
 }
 
-/* 编辑中：占位仍在，视觉交给浮层预览，避免正文公式与预览叠两份 */
+/* 编辑中：原文留在文档里，只加高亮；输入盒在下方，避免第二份 KaTeX 字号/行盒对不齐 */
 .tiptap-mathematics-render.tmr-math-editing {
-  visibility: hidden;
+  background: #fff3ec;
+  border-radius: 4px;
 }
 /* 代码块 NodeView：白底、细边框、顶部 header 放语言选择（Radix 下拉）+ 删除。 */
 ._wrapper_5i2vi_2 {
@@ -532,7 +533,7 @@
   color: #22863a;
 }
 /* 顶部操作栏：横跨宽度、内容居中、细线灰图标。配色映射到可覆盖的 --tmr-* 变量。 */
-._toolbar_w3tos_2 {
+._toolbar_16b09_2 {
   --sb-accent: var(--tmr-accent, #ff6719);
   --sb-text: var(--tmr-text, #363737);
   --sb-muted: var(--tmr-toolbar-muted, #6b6b6b);
@@ -545,7 +546,7 @@
   z-index: 8;
 }
 
-._inner_w3tos_15 {
+._inner_16b09_15 {
   display: flex;
   align-items: center;
   justify-content: safe center;
@@ -557,7 +558,7 @@
   overflow-x: auto;
 }
 
-._btn_w3tos_27 {
+._btn_16b09_27 {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -575,28 +576,28 @@
   transition: background 0.15s, color 0.15s;
 }
 
-._btn_w3tos_27:hover:not(:disabled) {
+._btn_16b09_27:hover:not(:disabled) {
   background: #f3f3f3;
   color: var(--sb-text);
 }
 
-._btnActive_w3tos_50 {
+._btnActive_16b09_50 {
   color: var(--sb-accent);
   background: #fff3ec;
 }
 
-._btnActive_w3tos_50:hover {
+._btnActive_16b09_50:hover {
   color: var(--sb-accent);
   background: #ffe8da;
 }
 
-._btn_w3tos_27:disabled {
+._btn_16b09_27:disabled {
   opacity: 0.3;
   cursor: not-allowed;
 }
 
 /* 表内浮动工具条（BubbleMenu portal 到 body，拿不到 .toolbar 变量，故写死配色） */
-._tableBubble_w3tos_66 {
+._tableBubble_16b09_66 {
   display: flex;
   align-items: center;
   gap: 2px;
@@ -608,7 +609,7 @@
 }
 
 /* 文字型图标（引用等） */
-._txtIcon_w3tos_78 {
+._txtIcon_16b09_78 {
   font-family: 'SF Pro Display', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
   font-size: 16px;
   font-weight: 600;
@@ -616,7 +617,7 @@
 }
 
 /* 文字颜色 / 高亮图标：字母 + 底部当前色条 */
-._colorIcon_w3tos_86 {
+._colorIcon_16b09_86 {
   display: inline-flex;
   flex-direction: column;
   align-items: center;
@@ -624,20 +625,20 @@
   line-height: 1;
 }
 
-._colorIconGlyph_w3tos_94 {
+._colorIconGlyph_16b09_94 {
   font-family: 'SF Pro Display', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
   font-size: 15px;
   font-weight: 600;
 }
 
-._colorIconBar_w3tos_100 {
+._colorIconBar_16b09_100 {
   width: 16px;
   height: 3px;
   border-radius: 1.5px;
 }
 
 /* A▾ 上标/下标下拉触发器 */
-._scriptTrigger_w3tos_107 {
+._scriptTrigger_16b09_107 {
   display: inline-flex;
   align-items: center;
   gap: 3px;
@@ -652,12 +653,12 @@
   transition: background 0.15s, color 0.15s;
 }
 
-._scriptTrigger_w3tos_107:hover {
+._scriptTrigger_16b09_107:hover {
   background: #f3f3f3;
   color: var(--sb-text);
 }
 
-._scriptTriggerGlyph_w3tos_127 {
+._scriptTriggerGlyph_16b09_127 {
   font-family: 'SF Pro Display', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
   font-size: 16px;
   font-weight: 600;
@@ -665,7 +666,7 @@
   text-underline-offset: 2px;
 }
 
-._divider_w3tos_135 {
+._divider_16b09_135 {
   width: 1px;
   height: 20px;
   margin: 0 8px;
@@ -674,7 +675,7 @@
 }
 
 /* ── Style / Size / More 下拉触发器 ── */
-._styleTrigger_w3tos_144 {
+._styleTrigger_16b09_144 {
   display: inline-flex;
   align-items: center;
   justify-content: space-between;
@@ -694,16 +695,16 @@
   transition: background 0.15s;
 }
 
-._styleTrigger_w3tos_144:hover:not(:disabled) {
+._styleTrigger_16b09_144:hover:not(:disabled) {
   background: #f3f3f3;
 }
 
-._styleTrigger_w3tos_144:disabled {
+._styleTrigger_16b09_144:disabled {
   opacity: 0.3;
   cursor: not-allowed;
 }
 
-._styleTriggerLabel_w3tos_173 {
+._styleTriggerLabel_16b09_173 {
   flex: 1;
   text-align: left;
   overflow: hidden;
@@ -711,19 +712,19 @@
   text-overflow: ellipsis;
 }
 
-._styleTriggerCaret_w3tos_181 {
+._styleTriggerCaret_16b09_181 {
   color: var(--sb-muted);
   flex: none;
 }
 
 /* 下拉项：图标 + 文字 */
-._styleItem_w3tos_187 {
+._styleItem_16b09_187 {
   display: inline-flex;
   align-items: center;
   gap: 12px;
 }
 
-._styleIcon_w3tos_193 {
+._styleIcon_16b09_193 {
   display: inline-flex;
   justify-content: center;
   align-items: center;
@@ -733,19 +734,19 @@
 }
 
 /* 上标 / 下标图标 */
-._scriptGlyph_w3tos_203 {
+._scriptGlyph_16b09_203 {
   display: inline-block;
   text-align: center;
   font-family: 'SF Pro Display', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
 }
 
-._scriptGlyph_w3tos_203 sup,
-._scriptGlyph_w3tos_203 sub {
+._scriptGlyph_16b09_203 sup,
+._scriptGlyph_16b09_203 sub {
   font-size: 0.7em;
 }
 
 /* ── Radix 下拉菜单面板（替代 antd .ant-dropdown-menu） ── */
-._menu_w3tos_215 {
+._menu_16b09_215 {
   min-width: 200px;
   padding: 6px;
   background: #fff;
@@ -756,7 +757,7 @@
   z-index: 1000;
 }
 
-._menuItem_w3tos_226 {
+._menuItem_16b09_226 {
   display: flex;
   align-items: center;
   width: 100%;
@@ -772,52 +773,52 @@
   outline: none;
 }
 
-._menuItem_w3tos_226:hover:not(:disabled) {
+._menuItem_16b09_226:hover:not(:disabled) {
   background: #f3f3f3;
 }
 
-._menuItem_w3tos_226:disabled {
+._menuItem_16b09_226:disabled {
   opacity: 0.35;
   cursor: not-allowed;
 }
 
 /* 选中态：品牌色高亮 */
-._menuItemSelected_w3tos_252 {
+._menuItemSelected_16b09_252 {
   background: #fff3ec;
   color: var(--sb-accent);
 }
 
-._menuItemSelected_w3tos_252 ._styleIcon_w3tos_193 {
+._menuItemSelected_16b09_252 ._styleIcon_16b09_193 {
   color: var(--sb-accent);
 }
 
-._menuItemSelected_w3tos_252:hover:not(:disabled) {
+._menuItemSelected_16b09_252:hover:not(:disabled) {
   background: #ffe8da;
 }
 
 /* Radix Popover 内容（承载 ColorPalette），面板自带阴影，这里只兜底 z-index */
-._popoverContent_w3tos_266 {
+._popoverContent_16b09_266 {
   z-index: 1000;
 }
 
-._mathLayer_w3tos_270 {
+._mathLayer_16b09_270 {
   position: absolute;
   z-index: 6;
 }
 
-._mathStack_w3tos_275 {
+._mathStack_16b09_275 {
   display: flex;
   flex-direction: column;
   align-items: flex-start;
   gap: 8px;
 }
 
-._mathStackBlock_w3tos_282 {
+._mathStackBlock_16b09_282 {
   align-items: stretch;
   width: 100%;
 }
 
-._mathHint_w3tos_287 {
+._mathHint_16b09_287 {
   display: inline-flex;
   align-items: center;
   gap: 6px;
@@ -829,19 +830,19 @@
   line-height: 1.4;
 }
 
-._mathHintBlock_w3tos_299 {
+._mathHintBlock_16b09_299 {
   width: 100%;
   padding: 10px 14px;
   border-radius: 8px;
 }
 
-._mathHintIcon_w3tos_305 {
+._mathHintIcon_16b09_305 {
   font-family: ui-serif, Georgia, 'Times New Roman', serif;
   font-size: 12px;
   opacity: 0.85;
 }
 
-._mathPreviewInline_w3tos_311 {
+._mathPreviewInline_16b09_311 {
   display: inline-flex;
   max-width: min(440px, calc(100vw - 24px));
   padding: 4px 10px;
@@ -849,25 +850,9 @@
   border-radius: 6px;
   background: #fff3ec;
   color: var(--tmr-text, #363737);
-  /* KaTeX 1.21em 相对此字号；默认对齐 .editorContent，标题内公式由节点 computed size 覆盖 */
-  font-family: var(
-    --tmr-body-font,
-    Spectral,
-    serif,
-    system-ui,
-    -apple-system,
-    BlinkMacSystemFont,
-    'Segoe UI',
-    Roboto,
-    Helvetica,
-    Arial,
-    sans-serif
-  );
-  font-size: var(--tmr-font-size, 19px);
-  line-height: 1;
 }
 
-._mathPreviewBlock_w3tos_337 {
+._mathPreviewBlock_16b09_321 {
   width: 100%;
   min-height: 48px;
   padding: 14px 16px;
@@ -876,28 +861,13 @@
   background: var(--tmr-code-bg, #f4f4f4);
   text-align: center;
   color: var(--tmr-text, #363737);
-  font-family: var(
-    --tmr-body-font,
-    Spectral,
-    serif,
-    system-ui,
-    -apple-system,
-    BlinkMacSystemFont,
-    'Segoe UI',
-    Roboto,
-    Helvetica,
-    Arial,
-    sans-serif
-  );
-  font-size: var(--tmr-font-size, 19px);
-  line-height: 1;
 }
 
-._mathPreviewBlock_w3tos_337 .katex-display {
+._mathPreviewBlock_16b09_321 .katex-display {
   margin: 0;
 }
 
-._mathField_w3tos_367 {
+._mathField_16b09_336 {
   display: flex;
   align-items: center;
   gap: 8px;
@@ -909,14 +879,14 @@
   box-shadow: 0 4px 16px rgb(0 0 0 / 12%);
 }
 
-._mathFieldBlock_w3tos_379 {
+._mathFieldBlock_16b09_348 {
   align-items: flex-start;
   width: 100%;
   border-radius: 12px;
   padding: 10px 10px 10px 14px;
 }
 
-._mathInput_w3tos_386 {
+._mathInput_16b09_355 {
   flex: 1;
   min-width: 0;
   margin: 0;
@@ -930,11 +900,11 @@
   resize: none;
 }
 
-._mathInput_w3tos_386:focus {
+._mathInput_16b09_355:focus {
   outline: none;
 }
 
-._mathDone_w3tos_404 {
+._mathDone_16b09_373 {
   display: inline-flex;
   align-items: center;
   gap: 4px;
@@ -950,16 +920,16 @@
   cursor: pointer;
 }
 
-._mathDone_w3tos_404:hover:not(:disabled) {
+._mathDone_16b09_373:hover:not(:disabled) {
   filter: brightness(0.95);
 }
 
-._mathDone_w3tos_404:disabled {
+._mathDone_16b09_373:disabled {
   opacity: 0.35;
   cursor: not-allowed;
 }
 
-._mathDoneKbd_w3tos_429 {
+._mathDoneKbd_16b09_398 {
   font-size: 11px;
   font-weight: 500;
   opacity: 0.85;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiptap-markdown-react",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "A batteries-included, self-styled Markdown WYSIWYG editor and reader suite built on Tiptap v3. Markdown in/out, SSR/static rendering, table of contents, themeable via CSS variables, zero Ant Design.",
   "type": "module",
   "license": "MIT",