tiptap-markdown-react 0.7.4 → 0.8.0

package/dist/labels.d.ts

@@ -43,6 +43,11 @@ export interface ToolbarLabels {
     tableAddRowBefore: string;
     tableAddRowAfter: string;
     tableDeleteRow: string;
+    inlineMath: string;
+    blockMath: string;
+    mathPlaceholder: string;
+    mathDone: string;
+    mathCancel: string;
 }
 export declare const defaultToolbarLabels: ToolbarLabels;
 export interface ColorPaletteLabels {

package/dist/math.d.ts

@@ -0,0 +1,23 @@
+export type MathKind = 'inline' | 'block';
+export interface MathClickPayload {
+    kind: MathKind;
+    pos: number;
+    latex: string;
+}
+type MathClickListener = (payload: MathClickPayload) => void;
+/** 编辑器工具栏注册点击公式回调；未注册时点击无操作（预览 / SSR）。 */
+export declare function subscribeMathClick(listener: MathClickListener): () => void;
+/** KaTeX HTML 片段（SSR / 预览弹层）。失败时回退为转义原文。 */
+export declare function renderMathHtml(latex: string, displayMode: boolean): string;
+export declare function renderMathElementHtml(latex: string, displayMode: boolean): string;
+/**
+ * 行内公式：markdown 为 `$$latex$$`（单行、无换行）。
+ * 关掉官方 `$…$` tokenizer 与 `$$` input rule——手打 `$` / `$$` 当字。
+ */
+export declare const reportInlineMath: import('@tiptap/core').Node<import('@tiptap/extension-mathematics').InlineMathOptions, any>;
+/**
+ * 块级公式：markdown 为带换行的 `$$\nlatex\n$$`。
+ * 单行 `$$…$$` 不在这里匹配，交给行内。无 input rule。
+ */
+export declare const reportBlockMath: import('@tiptap/core').Node<import('@tiptap/extension-mathematics').BlockMathOptions, any>;
+export {};

package/dist/math.test.d.ts

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

package/dist/server.js

@@ -1,5 +1,5 @@
-import { g as applyCitationSources, b as baseExtensions, p as pureCodeBlock, f as pureImage, C as CitationRef, d as makeTocGetId, i as extractToc } from "./extractToc-DPWZ7Oby.js";
-import { c, R, h, e, l, a, m } from "./extractToc-DPWZ7Oby.js";
+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-C0E_xYTj.js";
+import { c, R, i, e, l, a, m } from "./extractToc-C0E_xYTj.js";
 import { TableOfContents, generateTocIds } from "@tiptap/extension-table-of-contents";
 import { MarkdownManager } from "@tiptap/markdown";
 import { renderToHTMLString } from "@tiptap/static-renderer";
@@ -30,7 +30,22 @@ function renderReportHtml(markdown, lockedTitlesOrOptions = []) {
   ];
   try {
     const jsonWithIds = generateTocIds(json, extensions);
-    const html = renderToHTMLString({ extensions, content: jsonWithIds });
+    const html = renderToHTMLString({
+      extensions,
+      content: jsonWithIds,
+      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);
+          }
+        }
+      }
+    });
     return { html, toc: extractToc(jsonWithIds, lockedTitles) };
   } catch (e2) {
     console.error(
@@ -46,7 +61,7 @@ export {
   R as ReportContent,
   applyCitationSources,
   baseExtensions,
-  h as blockTextHash,
+  i as blockTextHash,
   e as enrichMarkdownCitations,
   extractToc,
   l as lowlight,

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 { 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({ extensions, content: jsonWithIds });\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":";;;;;AAgDA,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,EAAE,YAAY,SAAS,aAAa;AACpE,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 { 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;"}