import { renderFunctionPlot } from '@/services/functionPlotService' import DOMPurify from 'dompurify' import { Marked } from 'marked' import { defaultMarkdownPreferences, type MarkdownPreferences } from '@/stores/markdownPreferences' import { createHighlighterCore } from 'shiki/core' import { createOnigurumaEngine } from 'shiki/engine/oniguruma' import { bundledLanguagesInfo } from 'shiki/langs' import githubDark from '@shikijs/themes/github-dark' import githubLight from '@shikijs/themes/github-light' import { renderMermaid, type mermaidThemeVariables } from '@/services/mermaidService' import { appendDiagramControls } from './diagramControls' import katex from 'katex' import 'katex/dist/katex.min.css' import { parseCallout, escapeCalloutTitle } from './callouts' import '@/styles/callouts.css' function mathHtml(source: string, displayMode: boolean) { const result = katex.renderToString(source, {displayMode, throwOnError:false, trust:false, maxExpand:1000, output:'html'}) const label = source.replace(/&/g, '&').replace(/"/g, '"').replace(/${result}` } function createMarkdownParser(preferences: MarkdownPreferences) { const marked = new Marked() marked.use({ renderer: { blockquote(token) { if (!preferences.callouts) return false const callout = parseCallout(token.text) if (!callout) return false const title = escapeCalloutTitle(callout.title) const body = marked.parse(callout.body, { async: false }) as string const attributes = `class="markdown-callout" data-callout="${callout.type}"` return callout.fold ? `
${title}
${body}
` : `` } } }) if (preferences.math) marked.use({extensions:[ {name:'blockMath',level:'block',tokenizer(source) { const match = /^ {0,3}\$\$\s*\n?([\s\S]+?)\n?\$\$[ \t]*(?:\n|$)/.exec(source) if (match) return {type:'blockMath',raw:match[0],text:match[1]!.trim()} return undefined }, renderer(token) { return mathHtml(token.text, true) }}, {name:'inlineMath',level:'inline',start(source) { return source.indexOf('$') },tokenizer(source) { const match = /^\$([^$\n]+?)\$(?!\$)/.exec(source) if (match && !/^\s|\s$/.test(match[1]!)) return {type:'inlineMath',raw:match[0],text:match[1]!} return undefined },renderer(token) { return mathHtml(token.text, false) }}, ]}) marked.setOptions({ gfm: true, breaks: true }) if (!preferences.autoLinks) marked.use({ tokenizer: { url() { return undefined } } }) return marked } // Highlighter 是昂贵的单例;复用初始化 Promise,避免每个代码块重复加载语法与主题。 let highlighter: ReturnType | undefined function getHighlighter() { return highlighter ??= createHighlighterCore({ themes: [githubLight, githubDark], langs: [], engine: createOnigurumaEngine(import('shiki/wasm')), }).catch(error => { highlighter = undefined; throw error }) } const languageAliases = new Map(bundledLanguagesInfo.flatMap(info => [info.id, info.name, ...(info.aliases ?? [])].map(alias => [alias.toLowerCase(), info.id] as const), )) const languageLoads = new Map>() const languageLoaders = new Map(bundledLanguagesInfo.map(info => [info.id, info.import])) async function loadCodeLanguage(requestedLanguage: string) { const shiki = await getHighlighter() const language = languageAliases.get(requestedLanguage.toLowerCase()) if (!language) return { shiki, language: 'text' as const } let loading = languageLoads.get(language) if (!loading) { loading = shiki.loadLanguage(languageLoaders.get(language)!).catch(error => { languageLoads.delete(language) throw error }) languageLoads.set(language, loading) } await loading return { shiki, language } } // Bounded LRU of dual-theme HTML. Large one-off blocks never remain in the cache. const highlightedBlocks = new Map() let highlightedCharacters = 0 const highlightBudget = 1_000_000 export async function highlightCode(source: string, requestedLanguage = 'text'): Promise { const key = JSON.stringify([requestedLanguage.toLowerCase(), source]) const cached = highlightedBlocks.get(key) if (cached !== undefined) { highlightedBlocks.delete(key); highlightedBlocks.set(key, cached) return cached } const { shiki, language } = await loadCodeLanguage(requestedLanguage) const html = shiki.codeToHtml(source, { lang: language, themes: { light: 'github-light', dark: 'github-dark' }, defaultColor: false, }) const cost = key.length + html.length if (cost <= highlightBudget / 4) { // A concurrent caller may already have filled the same entry. const previous = highlightedBlocks.get(key) if (previous !== undefined) { highlightedCharacters -= key.length + previous.length; highlightedBlocks.delete(key) } while (highlightedBlocks.size && (highlightedBlocks.size >= 64 || highlightedCharacters + cost > highlightBudget)) { const oldest = highlightedBlocks.keys().next().value! highlightedCharacters -= oldest.length + highlightedBlocks.get(oldest)!.length highlightedBlocks.delete(oldest) } highlightedBlocks.set(key, html); highlightedCharacters += cost } return html } /** Share the initialized grammar/theme registry with editable code blocks. */ export async function getCodeTokenizer(theme: 'github-light' | 'github-dark', requestedLanguage = 'text') { const { shiki } = await loadCodeLanguage(requestedLanguage) return (source: string, requestedLanguage: string) => { const language = languageAliases.get(requestedLanguage.toLowerCase()) ?? 'text' return shiki.codeToTokens(source, { lang: shiki.getLoadedLanguages().includes(language as never) ? language : 'text', theme, }).tokens } } export async function renderMarkdown(source: string, options?: { themeId?: string; theme?: 'light' | 'dark'; preferences?: MarkdownPreferences; pdf?: { plot: (source: string) => Promise<{svg: string; warnings: string[]}>; mermaidVariables: ReturnType }; citationNumbers?: number[]; citationAliases?: Record }): Promise { const preferences = options?.preferences ?? defaultMarkdownPreferences const marked = createMarkdownParser(preferences) const citations = new Set(options?.citationNumbers ?? []) if (citations.size) marked.use({ extensions: [{ name: 'citation', level: 'inline', start: text => text.indexOf('['), tokenizer(text) { const match = /^\[([1-9]\d*|cit_[A-Za-z0-9_-]+)\](?!\()/.exec(text) const number = match ? options?.citationAliases?.[match[1]!] ?? Number(match[1]) : 0 if (match && citations.has(number)) return { type: 'citation', raw: match[0], number } }, renderer: token => ``, }] }) const html = marked.parse(source, { async: false }) as string const documentNode = new DOMParser().parseFromString(`${html}`, 'text/html') const mermaidBlocks: { pre: Element; source: string; kind: string }[] = [] for (const code of documentNode.querySelectorAll('pre > code')) { const requestedLanguage = [...code.classList].find((name) => name.startsWith('language-'))?.slice(9) || 'text' // Mermaid 与函数图共用静态图表管线;兼容旧的 function_plot 围栏写法。 const diagramKind = requestedLanguage.toLowerCase().split(/\s+/)[0]!.replace('function_plot','function-plot') if (['mermaid', 'function-plot'].includes(diagramKind) && preferences.diagrams) { mermaidBlocks.push({ pre: code.parentElement!, source: code.textContent ?? '', kind: diagramKind }) continue } if (requestedLanguage.toLowerCase() === 'latex' && preferences.math) { code.parentElement?.replaceWith(document.createRange().createContextualFragment(mathHtml(code.textContent ?? '', true))) continue } const highlighted = await highlightCode(code.textContent ?? '', requestedLanguage) const fragment = document.createRange().createContextualFragment(highlighted) // Shiki separates line spans with newlines. Block layout must not render those // separators as additional blank rows; the untouched source remains available for copy. for (const node of [...(fragment.querySelector('code')?.childNodes ?? [])]) { if (node.nodeType === Node.TEXT_NODE && !node.textContent?.trim()) node.remove() } const wrapper = document.createElement('div') wrapper.className = 'markdown-code-block' wrapper.dataset.languageLabel = requestedLanguage appendCodeToolbar(wrapper, requestedLanguage, code.textContent ?? '') wrapper.append(fragment) code.parentElement?.replaceWith(wrapper) } let plotCount = 0, plotNodes = 0 for (const { pre, source, kind } of mermaidBlocks) { try { // 交互预览保持数量和 AST 复杂度预算;PDF 已在隔离渲染链路中按需求解除限制。 if (!options?.pdf && kind === 'function-plot' && ++plotCount > 16) throw new Error('函数图像数量超过 16') const result = kind === 'function-plot' ? (options?.pdf ? await options.pdf.plot(source) : await renderFunctionPlot(source, options?.themeId)) : await renderMermaid(source, { theme: options?.theme, mode: 'static', ...(options?.pdf ? { unlimited:true, themeVariables:options.pdf.mermaidVariables } : {}) }) if (!options?.pdf && 'nodeCount' in result && (plotNodes += Number(result.nodeCount)) > 8000) throw new Error('函数图像累计复杂度超过 8000') const container = document.createElement('div') container.className = 'markdown-mermaid' + (kind === 'function-plot' ? ' markdown-function-plot' : '') container.innerHTML = result.svg appendCodeToolbar(container, kind, source, true) if (result.warnings.length) { const message = document.createElement('p'); message.textContent = result.warnings.join('\n'); message.setAttribute('role', 'status'); container.append(message) } if (!result.warnings.length || (kind === 'function-plot' && result.svg)) appendDiagramControls(container) pre.replaceWith(container) } catch (error) { const fallback = document.createElement('pre') fallback.className = 'mermaid-error' fallback.textContent = `${error instanceof Error ? error.message : '图表渲染失败'}\n${source}` pre.replaceWith(fallback) } } return DOMPurify.sanitize(documentNode.body.innerHTML, { USE_PROFILES: { html: true }, HTML_INTEGRATION_POINTS: { foreignobject: true }, ADD_TAGS: ['svg', 'path', 'rect', 'circle', 'ellipse', 'line', 'polyline', 'polygon', 'text', 'tspan', 'textPath', 'g', 'defs', 'marker', 'style', 'clipPath', 'foreignObject', 'title', 'desc', 'use', 'image', 'linearGradient', 'stop', 'radialGradient'], ADD_ATTR: ['xmlns', 'viewBox', 'd', 'cx', 'cy', 'r', 'rx', 'ry', 'x', 'y', 'width', 'height', 'fill', 'stroke', 'stroke-width', 'stroke-dasharray', 'stroke-linecap', 'stroke-linejoin', 'transform', 'points', 'x1', 'y1', 'x2', 'y2', 'class', 'id', 'style', 'text-anchor', 'dominant-baseline', 'font-size', 'font-family', 'font-weight', 'opacity', 'orient', 'marker-end', 'marker-start', 'marker-mid', 'refX', 'refY', 'viewBox', 'preserveAspectRatio', 'xlink:href', 'href', 'clip-path', 'gradientUnits', 'gradientTransform', 'stop-color', 'stop-opacity', 'offset', 'patternUnits', 'patternTransform', 'target'], }) } function appendCodeToolbar(container: HTMLElement, language: string, source: string, diagram = false) { const header = document.createElement('div') header.className = 'markdown-code-toolbar tools' const label = document.createElement('span'); label.textContent = language header.append(label) for (const action of diagram ? ['source', 'copy'] : ['copy']) { const button = document.createElement('button') button.type = 'button'; button.className = 'button-secondary' button.dataset.codeAction = action button.textContent = action === 'source' ? '查看源码' : '复制' button.setAttribute('aria-label', action === 'source' ? '查看源码' : '复制源码') if (action === 'source') button.setAttribute('aria-pressed', 'false') header.append(button) } const raw = document.createElement('pre') raw.className = 'markdown-code-source'; raw.hidden = true; raw.textContent = source container.prepend(header) container.append(raw) } // 高亮器首次需要代码高亮时才创建;语法保持按语言加载。Worker 可在性能测量后进一步引入。