tiptap-markdown-react 0.3.1 → 0.4.1

package/dist/server.d.ts

@@ -3,7 +3,9 @@
  * 硬依赖（可在 Server Component / ISR 内直接 import）。
  */
 export { baseExtensions, lowlight, pureCodeBlock, pureImage, } from './extensions';
+export { CitationRef } from './CitationRef';
+export { applyCitationSources, enrichMarkdownCitations, type SourceRef, } from './citationUtils';
 export { ReportContent, type ReportContentProps } from './ReportContent';
-export { renderReportHtml, type RenderedReport } from './renderReportHtml';
+export { renderReportHtml, type RenderedReport, type RenderReportHtmlOptions, } from './renderReportHtml';
 export { extractToc, type TocItem } from './toc/extractToc';
 export { makeTocGetId } from './toc/tocSlug';

package/dist/server.js

@@ -1,35 +1,51 @@
-import { b as baseExtensions, p as pureCodeBlock, a as pureImage, m as makeTocGetId, e as extractToc } from "./extractToc-C7e1DuVc.js";
-import { R, l } from "./extractToc-C7e1DuVc.js";
+import { c as applyCitationSources, b as baseExtensions, p as pureCodeBlock, a as pureImage, C as CitationRef, m as makeTocGetId, d as extractToc } from "./extractToc-DW6HOiGt.js";
+import { R, e, l } from "./extractToc-DW6HOiGt.js";
 import { TableOfContents, generateTocIds } from "@tiptap/extension-table-of-contents";
 import { MarkdownManager } from "@tiptap/markdown";
 import { renderToHTMLString } from "@tiptap/static-renderer";
 const sharedManager = new MarkdownManager({
-  extensions: [...baseExtensions, pureCodeBlock, pureImage, TableOfContents]
+  extensions: [
+    ...baseExtensions,
+    pureCodeBlock,
+    pureImage,
+    CitationRef,
+    TableOfContents
+  ]
 });
-function renderReportHtml(markdown, lockedTitles = []) {
+function renderReportHtml(markdown, lockedTitlesOrOptions = []) {
   if (!(markdown == null ? void 0 : markdown.trim())) return { html: "", toc: [] };
-  const json = sharedManager.parse(markdown);
+  const options = Array.isArray(lockedTitlesOrOptions) ? { lockedTitles: lockedTitlesOrOptions } : lockedTitlesOrOptions;
+  const lockedTitles = options.lockedTitles ?? [];
+  const sources = options.sources ?? [];
+  const json = applyCitationSources(
+    sharedManager.parse(markdown),
+    sources
+  );
   const extensions = [
     ...baseExtensions,
     pureCodeBlock,
     pureImage,
+    CitationRef,
     TableOfContents.configure({ getId: makeTocGetId() })
   ];
   try {
     const jsonWithIds = generateTocIds(json, extensions);
     const html = renderToHTMLString({ extensions, content: jsonWithIds });
     return { html, toc: extractToc(jsonWithIds, lockedTitles) };
-  } catch (e) {
+  } catch (e2) {
     console.error(
       "[renderReportHtml] Tiptap pipeline failed, falling back to empty content:",
-      e.message
+      e2.message
     );
     return { html: "", toc: [] };
   }
 }
 export {
+  CitationRef,
   R as ReportContent,
+  applyCitationSources,
   baseExtensions,
+  e as enrichMarkdownCitations,
   extractToc,
   l as lowlight,
   makeTocGetId,

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 { MarkdownManager } from '@tiptap/markdown';\nimport { renderToHTMLString } from '@tiptap/static-renderer';\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 * 已知边界：官方包解析内联 HTML 依赖 window.DOMParser，server 端无 window 会把\n * 内联 HTML（如 <u>）转义为字面文本。\n */\nexport interface RenderedReport {\n  html: string;\n  toc: TocItem[];\n}\n\n// [perf] 模块级复用单个 MarkdownManager。每次 `new MarkdownManager` 会让底层 marked\n// 全局累积扩展，parse 逐次变慢。parse 只用 schema、与 TOC 的 getId 无关，可跨调用\n// 安全复用；getId 相关的锚点注入放在 generateTocIds 阶段、用每篇新建的 extensions 处理。\nconst sharedManager = new MarkdownManager({\n  extensions: [...baseExtensions, pureCodeBlock, pureImage, TableOfContents],\n});\n\nexport function renderReportHtml(\n  markdown: string,\n  lockedTitles: string[] = [],\n): RenderedReport {\n  if (!markdown?.trim()) return { html: '', toc: [] };\n\n  const json = sharedManager.parse(markdown);\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    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":[],"mappings":";;;;;AAgCA,MAAM,gBAAgB,IAAI,gBAAgB;AAAA,EACxC,YAAY,CAAC,GAAG,gBAAgB,eAAe,WAAW,eAAe;AAC3E,CAAC;AAEM,SAAS,iBACd,UACA,eAAyB,IACT;AAChB,MAAI,EAAC,qCAAU,QAAQ,QAAO,EAAE,MAAM,IAAI,KAAK,GAAC;AAEhD,QAAM,OAAO,cAAc,MAAM,QAAQ;AAKzC,QAAM,aAAa;AAAA,IACjB,GAAG;AAAA,IACH;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,SAAS,GAAG;AAIV,YAAQ;AAAA,MACN;AAAA,MACC,EAAY;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 { 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;"}

package/dist/style.css

@@ -1,11 +1,11 @@
 /* 规范正文样式（编辑器 / 只读预览 / SSR 阅读三处共用同一个类，保证所见即所得、
    发布后一致）。配色/字体全部走可被消费方覆盖的 CSS 变量（--tmr-*，带默认值）。 */
 
-._editorScroll_fahhq_4 {
+._editorScroll_siipj_4 {
   margin-top: 24px;
 }
 
-._editorContent_fahhq_8 {
+._editorContent_siipj_8 {
   outline: none;
   padding: 0;
   font-family: var(
@@ -28,7 +28,7 @@
 }
 
 /* placeholder：空文档第一段显示占位符 */
-._editorContent_fahhq_8 p.is-editor-empty:first-child::before {
+._editorContent_siipj_8 p.is-editor-empty:first-child::before {
   content: attr(data-placeholder);
   float: left;
   height: 0;
@@ -36,7 +36,7 @@
   pointer-events: none;
 }
 
-._editorContent_fahhq_8 h1 {
+._editorContent_siipj_8 h1 {
   font-family: inherit;
   font-size: 1.55em;
   font-weight: 700;
@@ -44,7 +44,7 @@
   line-height: 1.3;
 }
 
-._editorContent_fahhq_8 h2 {
+._editorContent_siipj_8 h2 {
   font-family: inherit;
   font-size: 1.3em;
   font-weight: 700;
@@ -52,7 +52,7 @@
   line-height: 1.3;
 }
 
-._editorContent_fahhq_8 h3 {
+._editorContent_siipj_8 h3 {
   font-family: inherit;
   font-size: 1.12em;
   font-weight: 600;
@@ -60,21 +60,21 @@
 }
 
 /* h4-h6：延续 h1-h3 尺寸梯度递减；字号差变小后靠字重保持标题感，h6 字色稍弱。 */
-._editorContent_fahhq_8 h4 {
+._editorContent_siipj_8 h4 {
   font-family: inherit;
   font-size: 1.05em;
   font-weight: 600;
   margin: 0.7em 0 0.3em;
 }
 
-._editorContent_fahhq_8 h5 {
+._editorContent_siipj_8 h5 {
   font-family: inherit;
   font-size: 0.95em;
   font-weight: 600;
   margin: 0.7em 0 0.3em;
 }
 
-._editorContent_fahhq_8 h6 {
+._editorContent_siipj_8 h6 {
   font-family: inherit;
   font-size: 0.88em;
   font-weight: 600;
@@ -82,25 +82,25 @@
   color: var(--tmr-muted, #777777);
 }
 
-._editorContent_fahhq_8 p {
+._editorContent_siipj_8 p {
   margin: 0.7em 0;
 }
 
-._editorContent_fahhq_8 ul,
-._editorContent_fahhq_8 ol {
+._editorContent_siipj_8 ul,
+._editorContent_siipj_8 ol {
   padding-left: 1.5em;
   margin: 0.7em 0;
 }
 
-._editorContent_fahhq_8 ul {
+._editorContent_siipj_8 ul {
   list-style: disc;
 }
 
-._editorContent_fahhq_8 ol {
+._editorContent_siipj_8 ol {
   list-style: decimal;
 }
 
-._editorContent_fahhq_8 blockquote {
+._editorContent_siipj_8 blockquote {
   border-left: 3px solid var(--tmr-accent, #ff6719);
   padding-left: 1em;
   margin: 0.9em 0;
@@ -108,13 +108,13 @@
   font-style: italic;
 }
 
-._editorContent_fahhq_8 a {
+._editorContent_siipj_8 a {
   color: var(--tmr-accent, #ff6719);
   text-decoration: underline;
 }
 
 /* 仅行内代码加灰底；代码块内的 <code>（在 pre 内）由 NodeView 自管，排除掉 */
-._editorContent_fahhq_8 code:not(pre code) {
+._editorContent_siipj_8 code:not(pre code) {
   background: var(--tmr-code-bg, #f4f4f4);
   padding: 0.15em 0.4em;
   border-radius: 4px;
@@ -129,13 +129,13 @@
   );
 }
 
-._editorContent_fahhq_8 hr {
+._editorContent_siipj_8 hr {
   border: none;
   border-top: 1px solid var(--tmr-border, #e6e6e6);
   margin: 1.5em 0;
 }
 
-._editorContent_fahhq_8 img {
+._editorContent_siipj_8 img {
   max-width: 100%;
   height: auto;
   border-radius: 6px;
@@ -144,12 +144,12 @@
 }
 
 /* 选中的图片高亮 */
-._editorContent_fahhq_8 img.ProseMirror-selectednode {
+._editorContent_siipj_8 img.ProseMirror-selectednode {
   outline: 2px solid var(--tmr-accent, #ff6719);
 }
 
 /* 表格：细边框、表头浅灰、可拖拽列宽 */
-._editorContent_fahhq_8 table {
+._editorContent_siipj_8 table {
   border-collapse: collapse;
   table-layout: fixed;
   width: 100%;
@@ -158,8 +158,8 @@
   font-size: 0.92em;
 }
 
-._editorContent_fahhq_8 table td,
-._editorContent_fahhq_8 table th {
+._editorContent_siipj_8 table td,
+._editorContent_siipj_8 table th {
   border: 1px solid var(--tmr-border, #e6e6e6);
   padding: 8px 12px;
   vertical-align: top;
@@ -168,13 +168,13 @@
   min-width: 60px;
 }
 
-._editorContent_fahhq_8 table th {
+._editorContent_siipj_8 table th {
   background: var(--tmr-table-header-bg, #f7f7f7);
   font-weight: 600;
 }
 
 /* 选中的单元格高亮 */
-._editorContent_fahhq_8 table .selectedCell::after {
+._editorContent_siipj_8 table .selectedCell::after {
   content: '';
   position: absolute;
   inset: 0;
@@ -183,7 +183,7 @@
 }
 
 /* 列宽拖拽手柄 */
-._editorContent_fahhq_8 table .column-resize-handle {
+._editorContent_siipj_8 table .column-resize-handle {
   position: absolute;
   right: -2px;
   top: 0;
@@ -193,36 +193,91 @@
   cursor: col-resize;
 }
 
-._editorContent_fahhq_8 .tableWrapper {
+._editorContent_siipj_8 .tableWrapper {
   overflow-x: auto;
 }
 
 /* 任务清单 */
-._editorContent_fahhq_8 ul[data-type='taskList'] {
+._editorContent_siipj_8 ul[data-type='taskList'] {
   list-style: none;
   padding-left: 0.2em;
 }
 
-._editorContent_fahhq_8 ul[data-type='taskList'] li {
+._editorContent_siipj_8 ul[data-type='taskList'] li {
   display: flex;
   align-items: flex-start;
   gap: 0.5em;
   margin: 0.3em 0;
 }
 
-._editorContent_fahhq_8 ul[data-type='taskList'] li > label {
+._editorContent_siipj_8 ul[data-type='taskList'] li > label {
   margin-top: 0.35em;
   user-select: none;
 }
 
-._editorContent_fahhq_8 ul[data-type='taskList'] li > div {
+._editorContent_siipj_8 ul[data-type='taskList'] li > div {
   flex: 1;
 }
 
-._editorContent_fahhq_8 ul[data-type='taskList'] input[type='checkbox'] {
+._editorContent_siipj_8 ul[data-type='taskList'] input[type='checkbox'] {
   accent-color: var(--tmr-accent, #ff6719);
   cursor: pointer;
 }
+
+/* 脚注/引文圆标：与正文字垂直居中；配色对齐工具栏 active（浅橙底 + accent 字） */
+._editorContent_siipj_8 span.citation-ref {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+  box-sizing: border-box;
+  min-width: 1.4em;
+  height: 1.4em;
+  padding: 0 0.28em;
+  margin: 0 0.14em;
+  border-radius: 999px;
+  border: 1px solid var(--tmr-citation-border, #ffd4b8);
+  background: var(--tmr-citation-bg, #fff3ec);
+  color: var(--tmr-citation-fg, var(--tmr-accent, #ff6719));
+  font-size: 0.68em;
+  font-weight: 600;
+  font-style: normal;
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    'Segoe UI',
+    Roboto,
+    Helvetica,
+    Arial,
+    sans-serif;
+  letter-spacing: -0.02em;
+  line-height: 1;
+  text-decoration: none;
+  cursor: pointer;
+  user-select: none;
+  transition:
+    background 0.15s ease,
+    color 0.15s ease,
+    border-color 0.15s ease;
+}
+
+._editorContent_siipj_8 span.citation-ref a {
+  color: inherit;
+  text-decoration: none;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+}
+
+._editorContent_siipj_8 span.citation-ref:hover,
+._editorContent_siipj_8 span.citation-ref:focus-within {
+  background: var(--tmr-citation-bg-hover, var(--tmr-accent, #ff6719));
+  border-color: var(--tmr-citation-bg-hover, var(--tmr-accent, #ff6719));
+  color: var(--tmr-citation-fg-hover, #ffffff);
+}
 /* 代码块 NodeView：白底、细边框、顶部 header 放语言选择（Radix 下拉）+ 删除。 */
 ._wrapper_2dv2g_2 {
   position: relative;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiptap-markdown-react",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "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",
@@ -48,6 +48,8 @@
     "build": "vite build",
     "dev": "vite build --watch",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build"
   },
   "publishConfig": {
@@ -88,7 +90,9 @@
     "rollup-preserve-directives": "^1.1.3",
     "typescript": "^5.9.3",
     "vite": "^5.4.21",
-    "vite-plugin-dts": "^4.5.4"
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.2.4",
+    "happy-dom": "^18.0.1"
   },
   "overrides": {
     "@tiptap/core": "3.27.1"

package/dist/extractToc-C7e1DuVc.js

@@ -1,97 +0,0 @@
-import CodeBlockLowlight from "@tiptap/extension-code-block-lowlight";
-import Highlight from "@tiptap/extension-highlight";
-import Image from "@tiptap/extension-image";
-import Subscript from "@tiptap/extension-subscript";
-import Superscript from "@tiptap/extension-superscript";
-import { TableKit } from "@tiptap/extension-table";
-import TaskItem from "@tiptap/extension-task-item";
-import TaskList from "@tiptap/extension-task-list";
-import { TextStyle, Color, FontSize } from "@tiptap/extension-text-style";
-import StarterKit from "@tiptap/starter-kit";
-import { createLowlight, common } from "lowlight";
-import { jsx } from "react/jsx-runtime";
-const lowlight = createLowlight(common);
-const pureCodeBlock = CodeBlockLowlight.configure({ lowlight });
-const pureImage = Image.configure({ inline: false });
-const baseExtensions = [
-  // 禁用 StarterKit 内置 codeBlock，统一改用带 lowlight 的代码块（由调用方注入）
-  StarterKit.configure({ codeBlock: false }),
-  TextStyle,
-  Color.configure({ types: [TextStyle.name] }),
-  // 正文字号：官方 FontSize（v3 起并入 text-style 包），以内联样式挂在 TextStyle
-  // 的 <span> 上（如 style="font-size: 16px"），与 Color 同基座，三端共用。
-  FontSize.configure({ types: [TextStyle.name] }),
-  Highlight.configure({ multicolor: true }),
-  Superscript,
-  Subscript,
-  TableKit.configure({ table: { resizable: true } }),
-  TaskList,
-  TaskItem.configure({ nested: true })
-];
-const editorScroll = "_editorScroll_fahhq_4";
-const editorContent = "_editorContent_fahhq_8";
-const styles = {
-  editorScroll,
-  editorContent
-};
-function baseSlug(text) {
-  return text.toLowerCase().trim().replace(/\s+/g, "-").replace(/[^\w一-龥-]/g, "").replace(/^-+|-+$/g, "") || "section";
-}
-function makeTocGetId() {
-  const seen = /* @__PURE__ */ new Map();
-  return (content) => {
-    const base = baseSlug(content);
-    const n = (seen.get(base) ?? 0) + 1;
-    seen.set(base, n);
-    return n === 1 ? base : `${base}-${n}`;
-  };
-}
-function ReportContent({ html, className, ...rest }) {
-  return /* @__PURE__ */ jsx(
-    "div",
-    {
-      ...rest,
-      className: className ? `${styles.editorContent} ${className}` : styles.editorContent,
-      dangerouslySetInnerHTML: { __html: html }
-    }
-  );
-}
-const MAX_LEVEL = 6;
-function headingText(node) {
-  if (!node.content) return "";
-  return node.content.map((c) => c.type === "text" ? c.text ?? "" : "").join("").trim();
-}
-function extractToc(doc, lockedTitles = []) {
-  const locked = new Set(lockedTitles.map((t) => t.trim()));
-  const items = [];
-  const walk = (node) => {
-    var _a, _b, _c, _d;
-    const level = (_a = node.attrs) == null ? void 0 : _a.level;
-    if (node.type === "heading" && typeof level === "number" && level <= MAX_LEVEL) {
-      const text = headingText(node);
-      const id = ((_b = node.attrs) == null ? void 0 : _b["data-toc-id"]) ?? ((_c = node.attrs) == null ? void 0 : _c.id);
-      if (text && id) {
-        items.push({
-          id,
-          level,
-          text,
-          locked: locked.has(text) || void 0
-        });
-      }
-    }
-    (_d = node.content) == null ? void 0 : _d.forEach(walk);
-  };
-  walk(doc);
-  return items;
-}
-export {
-  ReportContent as R,
-  pureImage as a,
-  baseExtensions as b,
-  extractToc as e,
-  lowlight as l,
-  makeTocGetId as m,
-  pureCodeBlock as p,
-  styles as s
-};
-//# sourceMappingURL=extractToc-C7e1DuVc.js.map

package/dist/extractToc-C7e1DuVc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"extractToc-C7e1DuVc.js","sources":["../src/extensions.ts","../src/toc/tocSlug.ts","../src/ReportContent.tsx","../src/toc/extractToc.ts"],"sourcesContent":["import CodeBlockLowlight from '@tiptap/extension-code-block-lowlight';\nimport Highlight from '@tiptap/extension-highlight';\nimport Image from '@tiptap/extension-image';\nimport Subscript from '@tiptap/extension-subscript';\nimport Superscript from '@tiptap/extension-superscript';\nimport { TableKit } from '@tiptap/extension-table';\nimport TaskItem from '@tiptap/extension-task-item';\nimport TaskList from '@tiptap/extension-task-list';\nimport { Color, FontSize, TextStyle } from '@tiptap/extension-text-style';\n// AnyExtension 从 @tiptap/react 取（它 re-export 自 core），避免新增 @tiptap/core 直接依赖\nimport type { AnyExtension } from '@tiptap/react';\nimport StarterKit from '@tiptap/starter-kit';\nimport { common, createLowlight } from 'lowlight';\n\n/**\n * 编辑器的「内容 schema 级」扩展集——纯节点/标记定义，不含任何 React NodeView\n * 或键盘交互绑定。三处共用：\n *   1. 编辑器（MarkdownWysiwygEditor）：base + 交互增强版 CodeBlock/Image\n *   2. 只读预览（MarkdownPreview）\n *   3. server 端 markdown→HTML 渲染（renderReportHtml）\n *\n * 分层动机：交互增强依赖 @tiptap/react / 浏览器，会污染 server bundle（RSC）。\n * base 保持纯 schema，server import 它只引入节点定义，无 React 代码。\n *\n * 关键边界：CodeBlock 与 Image「会被编辑器增强」，**不放进 base**——否则编辑器\n * 追加增强版会与 base 的纯版同名冲突（Tiptap 报 \"Duplicate extension names\"）。\n * 改为：base 不含这两个节点，由调用方按需注入：\n *   - 编辑器注入「增强版」（React 视图 / 删除快捷键）\n *   - server / 预览注入「纯版」（pureCodeBlock / pureImage）\n */\n\n// lowlight 实例：代码块语法高亮。导出供编辑器增强版与 server 纯版共用同一实例。\nexport const lowlight = createLowlight(common);\n\n/** 纯版代码块（无 React 视图）：server / 预览用，产出带高亮 class 的静态结构。 */\nexport const pureCodeBlock = CodeBlockLowlight.configure({ lowlight });\n\n/**\n * 纯版块级图片（无删除快捷键）：server / 预览用。\n * inline:false（官方默认）——研报里图片均为大图独占一行，块级图片可直接作为 doc\n * 顶层子节点，避免「inline image 裸挂 doc 顶层」被 generateTocIds 严格校验判非法。\n */\nexport const pureImage = Image.configure({ inline: false });\n\n/**\n * 三处共用的纯 schema 扩展——**不含 CodeBlock / Image**（见上方边界说明）。\n * 编辑器：`[...baseExtensions, 增强CodeBlock, 增强Image, Markdown]`\n * server/预览：`[...baseExtensions, pureCodeBlock, pureImage, Markdown]`\n */\nexport const baseExtensions: AnyExtension[] = [\n  // 禁用 StarterKit 内置 codeBlock，统一改用带 lowlight 的代码块（由调用方注入）\n  StarterKit.configure({ codeBlock: false }),\n  TextStyle,\n  Color.configure({ types: [TextStyle.name] }),\n  // 正文字号：官方 FontSize（v3 起并入 text-style 包），以内联样式挂在 TextStyle\n  // 的 <span> 上（如 style=\"font-size: 16px\"），与 Color 同基座，三端共用。\n  FontSize.configure({ types: [TextStyle.name] }),\n  Highlight.configure({ multicolor: true }),\n  Superscript,\n  Subscript,\n  TableKit.configure({ table: { resizable: true } }),\n  TaskList,\n  TaskItem.configure({ nested: true }),\n];\n","/**\n * 目录锚点 id 生成——阅读页（SSR）与编辑页（editor）共用的**单一真源**，\n * 保证「创作预览的锚点 = 发布后阅读页的锚点」。\n *\n * 用 slug 而非官方默认 UUID：slug 跨 SSR / ISR revalidate 稳定（UUID 每次都变、\n * 分享的 #hash 会失效），且 `#introduction` 比 `#d4590f81-…` 可读、对 SEO 友好。\n *\n * slug 会重名（两个「细节」都 slug 成 `xi-jie`），故用闭包计数器去重：\n * 同名追加 -2 / -3（已实测：details / details-2 / details-3，HTML id 全唯一）。\n */\n\n/** 单个标题文本 → 基础 slug（保留中文，去标点，空白转连字符）。 */\nfunction baseSlug(text: string): string {\n  return (\n    text\n      .toLowerCase()\n      .trim()\n      .replace(/\\s+/g, '-')\n      // 保留字母/数字/下划线/中文/连字符，其余剔除\n      .replace(/[^\\w一-龥-]/g, '')\n      .replace(/^-+|-+$/g, '') || 'section'\n  );\n}\n\n/**\n * 造一个带去重的 `getId`。每次生成新实例（闭包各自计数），传给\n * `TableOfContents.configure({ getId })` 或 `generateTocIds` 的扩展配置。\n */\nexport function makeTocGetId(): (content: string) => string {\n  const seen = new Map<string, number>();\n  return (content: string) => {\n    const base = baseSlug(content);\n    const n = (seen.get(base) ?? 0) + 1;\n    seen.set(base, n);\n    return n === 1 ? base : `${base}-${n}`;\n  };\n}\n","import type { HTMLAttributes } from 'react';\nimport styles from './styles/content.module.css';\n\nexport interface ReportContentProps extends HTMLAttributes<HTMLDivElement> {\n  /** `renderReportHtml(...).html` 产出的正文 HTML 字符串。 */\n  html: string;\n}\n\n/**\n * 只读静态正文渲染（RSC / SSR 安全，无 client 代码、无编辑器实例）。\n *\n * 把 `renderReportHtml` 产出的 HTML 注入容器，并套上与编辑器 / 只读预览**同一个\n * 规范正文类**，保证「编辑所见 = 预览所见 = 发布后读者所见」。\n * 用于阅读页首屏直出（SEO 可见），无需 JS 即可显示。\n */\nexport function ReportContent({ html, className, ...rest }: ReportContentProps) {\n  return (\n    <div\n      {...rest}\n      className={\n        className ? `${styles.editorContent} ${className}` : styles.editorContent\n      }\n      dangerouslySetInnerHTML={{ __html: html }}\n    />\n  );\n}\n","/**\n * 最小 Tiptap JSON 节点结构（只取本模块用到的字段）。\n * 不从 `@tiptap/core` 引 `JSONContent`——core 是嵌套依赖、非直接依赖，\n * 直接 import 类型解析不到（与仓库既有做法一致，见 extensions.ts）。\n */\ninterface TocDocNode {\n  type?: string;\n  text?: string;\n  attrs?: Record<string, unknown> | null;\n  content?: TocDocNode[];\n}\n\n/** 目录项。 */\nexport interface TocItem {\n  /** 锚点 id（= heading 的 data-toc-id / id，由 generateTocIds 注入）。 */\n  id: string;\n  /** 标题层级（1-6）。 */\n  level: number;\n  /** 标题纯文本。 */\n  text: string;\n  /** 付费墙锁住的章节（置灰不可点）。 */\n  locked?: boolean;\n}\n\n/** 目录纳入的最大层级（h1-h6，全层级入目录）。 */\nconst MAX_LEVEL = 6;\n\n/** 取 heading 节点的纯文本（拼接其 text 子节点）。 */\nfunction headingText(node: TocDocNode): string {\n  if (!node.content) return '';\n  return node.content\n    .map((c) => (c.type === 'text' ? c.text ?? '' : ''))\n    .join('')\n    .trim();\n}\n\n/**\n * 从已注入锚点 id 的 Tiptap JSON doc 提取 h1-h6 目录。\n *\n * 必须在 `generateTocIds` 之后调用（heading 的 attrs 里才有 `data-toc-id`）。\n * `lockedTitles`：被截断（锁住）章节标题，命中则标 `locked`——\n * 目录列全部章节，锁住项置灰不可点（付费墙钩子）。用 Set 便于去重命中。\n */\nexport function extractToc(\n  doc: TocDocNode,\n  lockedTitles: string[] = [],\n): TocItem[] {\n  const locked = new Set(lockedTitles.map((t) => t.trim()));\n  const items: TocItem[] = [];\n\n  const walk = (node: TocDocNode) => {\n    const level = node.attrs?.level;\n    if (\n      node.type === 'heading' &&\n      typeof level === 'number' &&\n      level <= MAX_LEVEL\n    ) {\n      const text = headingText(node);\n      const id = (node.attrs?.['data-toc-id'] ?? node.attrs?.id) as\n        | string\n        | undefined;\n      // 有文本 + 有锚点 id 才入目录（空标题 / 未注入 id 的跳过）。\n      if (text && id) {\n        items.push({\n          id,\n          level,\n          text,\n          locked: locked.has(text) || undefined,\n        });\n      }\n    }\n    node.content?.forEach(walk);\n  };\n\n  walk(doc);\n  return items;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAgCO,MAAM,WAAW,eAAe,MAAM;AAGtC,MAAM,gBAAgB,kBAAkB,UAAU,EAAE,UAAU;AAO9D,MAAM,YAAY,MAAM,UAAU,EAAE,QAAQ,OAAO;AAOnD,MAAM,iBAAiC;AAAA;AAAA,EAE5C,WAAW,UAAU,EAAE,WAAW,OAAO;AAAA,EACzC;AAAA,EACA,MAAM,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;AAAA;AAAA;AAAA,EAG3C,SAAS,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;AAAA,EAC9C,UAAU,UAAU,EAAE,YAAY,MAAM;AAAA,EACxC;AAAA,EACA;AAAA,EACA,SAAS,UAAU,EAAE,OAAO,EAAE,WAAW,KAAA,GAAQ;AAAA,EACjD;AAAA,EACA,SAAS,UAAU,EAAE,QAAQ,MAAM;AACrC;;;;;;;ACnDA,SAAS,SAAS,MAAsB;AACtC,SACE,KACG,YAAA,EACA,KAAA,EACA,QAAQ,QAAQ,GAAG,EAEnB,QAAQ,cAAc,EAAE,EACxB,QAAQ,YAAY,EAAE,KAAK;AAElC;AAMO,SAAS,eAA4C;AAC1D,QAAM,2BAAW,IAAA;AACjB,SAAO,CAAC,YAAoB;AAC1B,UAAM,OAAO,SAAS,OAAO;AAC7B,UAAM,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK;AAClC,SAAK,IAAI,MAAM,CAAC;AAChB,WAAO,MAAM,IAAI,OAAO,GAAG,IAAI,IAAI,CAAC;AAAA,EACtC;AACF;ACrBO,SAAS,cAAc,EAAE,MAAM,WAAW,GAAG,QAA4B;AAC9E,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACE,GAAG;AAAA,MACJ,WACE,YAAY,GAAG,OAAO,aAAa,IAAI,SAAS,KAAK,OAAO;AAAA,MAE9D,yBAAyB,EAAE,QAAQ,KAAA;AAAA,IAAK;AAAA,EAAA;AAG9C;ACAA,MAAM,YAAY;AAGlB,SAAS,YAAY,MAA0B;AAC7C,MAAI,CAAC,KAAK,QAAS,QAAO;AAC1B,SAAO,KAAK,QACT,IAAI,CAAC,MAAO,EAAE,SAAS,SAAS,EAAE,QAAQ,KAAK,EAAG,EAClD,KAAK,EAAE,EACP,KAAA;AACL;AASO,SAAS,WACd,KACA,eAAyB,IACd;AACX,QAAM,SAAS,IAAI,IAAI,aAAa,IAAI,CAAC,MAAM,EAAE,KAAA,CAAM,CAAC;AACxD,QAAM,QAAmB,CAAA;AAEzB,QAAM,OAAO,CAAC,SAAqB;;AACjC,UAAM,SAAQ,UAAK,UAAL,mBAAY;AAC1B,QACE,KAAK,SAAS,aACd,OAAO,UAAU,YACjB,SAAS,WACT;AACA,YAAM,OAAO,YAAY,IAAI;AAC7B,YAAM,OAAM,UAAK,UAAL,mBAAa,qBAAkB,UAAK,UAAL,mBAAY;AAIvD,UAAI,QAAQ,IAAI;AACd,cAAM,KAAK;AAAA,UACT;AAAA,UACA;AAAA,UACA;AAAA,UACA,QAAQ,OAAO,IAAI,IAAI,KAAK;AAAA,QAAA,CAC7B;AAAA,MACH;AAAA,IACF;AACA,eAAK,YAAL,mBAAc,QAAQ;AAAA,EACxB;AAEA,OAAK,GAAG;AACR,SAAO;AACT;"}