@huyooo/ai-chat-shared 0.2.14 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/parser.ts","../src/highlighter.ts","../src/markdown.ts","../src/visual.ts"],"sourcesContent":["/**\n * 内容解析器\n * 将 AI 输出的原始文本解析为结构化的内容块\n */\n\nimport type { ContentBlock, TextBlock, CodeBlock } from './types'\n\n/** 生成唯一 ID */\nfunction generateId(): string {\n return Math.random().toString(36).slice(2, 11)\n}\n\n/** 代码块正则:匹配 ```language\\ncode\\n``` 或 ```\\ncode\\n``` */\nconst CODE_BLOCK_REGEX = /```(\\w*)\\n([\\s\\S]*?)```/g\n\n/**\n * 解析原始内容为内容块列表\n * @param raw 原始文本内容\n * @returns 内容块列表\n */\nexport function parseContent(raw: string): ContentBlock[] {\n if (!raw) return []\n\n const blocks: ContentBlock[] = []\n let lastIndex = 0\n\n // 使用正则匹配所有代码块\n let match: RegExpExecArray | null\n const regex = new RegExp(CODE_BLOCK_REGEX.source, 'g')\n\n while ((match = regex.exec(raw)) !== null) {\n // 添加代码块前的文本\n if (match.index > lastIndex) {\n const textContent = raw.slice(lastIndex, match.index)\n if (textContent.trim()) {\n blocks.push(createTextBlock(textContent, undefined, true))\n }\n }\n\n // 添加代码块\n const language = match[1] || undefined\n const code = match[2]\n blocks.push(createCodeBlock(code, language))\n\n lastIndex = match.index + match[0].length\n }\n\n // 添加最后一段文本\n if (lastIndex < raw.length) {\n const textContent = raw.slice(lastIndex)\n if (textContent.trim()) {\n blocks.push(createTextBlock(textContent, undefined, true))\n }\n }\n\n return blocks\n}\n\n/** 创建文本块 */\nfunction createTextBlock(content: string, id?: string, trimContent = true): TextBlock {\n return {\n id: id || generateId(),\n type: 'text',\n content: trimContent ? content.trim() : content,\n }\n}\n\n/** 创建代码块 */\nfunction createCodeBlock(content: string, language?: string, filename?: string, id?: string): CodeBlock {\n return {\n id: id || generateId(),\n type: 'code',\n content,\n language,\n filename,\n }\n}\n\n// ============ 流式解析支持 ============\n\n/** 流式解析状态 */\nexport interface StreamParseState {\n /** 未完成的缓冲区 */\n buffer: string\n /** 已解析的块 */\n blocks: ContentBlock[]\n /** 是否在代码块中 */\n inCodeBlock: boolean\n /** 当前代码块语言 */\n codeLanguage?: string\n /** 当前代码块内容 */\n codeContent: string\n /** 当前代码块 ID(用于稳定 key,避免流式时每次 render 都生成新 id) */\n codeBlockId: string | null\n /** 当前文本块内容(流式追加,避免把一句话拆成很多 text block) */\n textContent: string\n /** 当前文本块 ID(稳定 key) */\n textBlockId: string | null\n}\n\n/** 创建初始流式解析状态 */\nexport function createStreamParseState(): StreamParseState {\n return {\n buffer: '',\n blocks: [],\n inCodeBlock: false,\n codeLanguage: undefined,\n codeContent: '',\n codeBlockId: null,\n textContent: '',\n textBlockId: null,\n }\n}\n\nfunction appendText(state: StreamParseState, text: string): void {\n if (!text) return\n if (state.textBlockId === null) state.textBlockId = generateId()\n state.textContent += text\n}\n\nfunction flushTextBlock(state: StreamParseState): void {\n if (!state.textContent.trim()) return\n state.blocks.push(createTextBlock(state.textContent, state.textBlockId || undefined, false))\n state.textContent = ''\n state.textBlockId = null\n}\n\n/**\n * 流式解析(增量更新)\n * @param chunk 新增的文本块\n * @param state 当前解析状态\n * @returns 更新后的状态\n */\nexport function parseContentStream(chunk: string, state: StreamParseState): StreamParseState {\n const newState: StreamParseState = { ...state, blocks: [...state.blocks] }\n newState.buffer += chunk\n\n // 处理缓冲区\n while (true) {\n if (newState.inCodeBlock) {\n // 在代码块中,查找结束标记\n const endIndex = newState.buffer.indexOf('```')\n if (endIndex !== -1) {\n // 找到结束标记\n newState.codeContent += newState.buffer.slice(0, endIndex)\n newState.blocks.push(\n createCodeBlock(\n newState.codeContent.trim(),\n newState.codeLanguage,\n undefined,\n newState.codeBlockId || undefined\n )\n )\n newState.buffer = newState.buffer.slice(endIndex + 3)\n newState.inCodeBlock = false\n newState.codeLanguage = undefined\n newState.codeContent = ''\n newState.codeBlockId = null\n } else {\n // 没找到结束标记,继续累积\n newState.codeContent += newState.buffer\n newState.buffer = ''\n break\n }\n } else {\n // 不在代码块中,查找开始标记\n const startIndex = newState.buffer.indexOf('```')\n if (startIndex !== -1) {\n // 找到开始标记\n const beforeCode = newState.buffer.slice(0, startIndex)\n appendText(newState, beforeCode)\n flushTextBlock(newState)\n\n // 解析语言标识\n const afterStart = newState.buffer.slice(startIndex + 3)\n const newlineIndex = afterStart.indexOf('\\n')\n if (newlineIndex !== -1) {\n newState.codeLanguage = afterStart.slice(0, newlineIndex).trim() || undefined\n newState.buffer = afterStart.slice(newlineIndex + 1)\n newState.inCodeBlock = true\n newState.codeContent = ''\n newState.codeBlockId = generateId()\n } else {\n // 语言行还没完整,等待更多数据\n break\n }\n } else {\n // 没有代码块标记:追加到“当前文本块”里(不 flush),避免碎片化\n // 同时检查末尾是否可能是不完整的 ```,如果是就保留在 buffer 等待后续补全\n const lastBackticks = newState.buffer.lastIndexOf('`')\n if (lastBackticks !== -1 && newState.buffer.length - lastBackticks < 3) {\n // 可能是不完整的 ```,保留\n const safeText = newState.buffer.slice(0, lastBackticks)\n appendText(newState, safeText)\n newState.buffer = newState.buffer.slice(lastBackticks)\n } else {\n appendText(newState, newState.buffer)\n newState.buffer = ''\n }\n break\n }\n }\n }\n\n return newState\n}\n\n/**\n * 完成流式解析(处理剩余缓冲区)\n * @param state 当前解析状态\n * @returns 最终的内容块列表\n */\nexport function finishStreamParse(state: StreamParseState): ContentBlock[] {\n const blocks = [...state.blocks]\n\n if (state.inCodeBlock) {\n // 未闭合的代码块,作为代码块处理\n blocks.push(\n createCodeBlock(\n (state.codeContent + state.buffer).trim(),\n state.codeLanguage,\n undefined,\n state.codeBlockId || undefined\n )\n )\n } else {\n // 剩余文本 + 累积文本:合并成一个 text block(稳定 id),避免碎片化\n const merged = state.textContent + state.buffer\n if (merged.trim()) {\n blocks.push(createTextBlock(merged, state.textBlockId || undefined, false))\n }\n }\n\n return blocks\n}\n","/**\n * 代码高亮工具\n * 使用 highlight.js 提供代码语法高亮\n */\n\nimport hljs from 'highlight.js'\n\n/** 支持的语言别名映射 */\nconst LANGUAGE_ALIASES: Record<string, string> = {\n js: 'javascript',\n ts: 'typescript',\n tsx: 'typescript',\n jsx: 'javascript',\n py: 'python',\n rb: 'ruby',\n sh: 'bash',\n shell: 'bash',\n yml: 'yaml',\n md: 'markdown',\n}\n\n/**\n * 高亮代码\n * @param code 代码内容\n * @param language 语言标识\n * @returns 高亮后的 HTML\n */\nexport function highlightCode(code: string, language?: string): string {\n if (!language) {\n // 无语言指定,尝试自动检测\n try {\n const result = hljs.highlightAuto(code)\n return result.value\n } catch {\n return escapeHtml(code)\n }\n }\n\n // 处理语言别名\n const normalizedLang = LANGUAGE_ALIASES[language.toLowerCase()] || language.toLowerCase()\n\n try {\n if (hljs.getLanguage(normalizedLang)) {\n return hljs.highlight(code, { language: normalizedLang }).value\n }\n // 语言不支持,返回转义后的原文\n return escapeHtml(code)\n } catch {\n return escapeHtml(code)\n }\n}\n\n/** HTML 转义 */\nfunction escapeHtml(text: string): string {\n return text\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&#039;')\n}\n\n/**\n * 获取语言显示名称\n * @param language 语言标识\n * @returns 显示名称\n */\nexport function getLanguageDisplayName(language?: string): string {\n if (!language) return 'Plain Text'\n \n const normalizedLang = LANGUAGE_ALIASES[language.toLowerCase()] || language.toLowerCase()\n const langDef = hljs.getLanguage(normalizedLang)\n \n if (langDef) {\n // 首字母大写\n return normalizedLang.charAt(0).toUpperCase() + normalizedLang.slice(1)\n }\n \n return language\n}\n","/**\n * Markdown 渲染工具\n * 提供统一的 Markdown 渲染函数,供 React 和 Vue 版本使用\n * 支持 LaTeX 数学公式渲染和 Mermaid 图表\n */\n\nimport { marked, Renderer } from 'marked'\nimport DOMPurify from 'dompurify'\nimport katex from 'katex'\nimport mermaid from 'mermaid'\nimport { highlightCode } from './highlighter'\n\n// Mermaid 初始化标记\nlet mermaidInitialized = false\n\n/**\n * base64url 编码(UTF-8)\n * 不能直接把源码放进 attribute(换行会被规范化),所以使用 base64 传递。\n * 同时避免在某些链路里 '+' 被当成空格的问题,这里使用 base64url(- _,无 padding)。\n */\nfunction encodeBase64Utf8(text: string): string {\n const bytes = new TextEncoder().encode(text)\n let binary = ''\n for (const b of bytes) binary += String.fromCharCode(b)\n const b64 = btoa(binary)\n // base64url: +/ -> -_,去掉末尾 padding =\n return b64.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/g, '')\n}\n\n/**\n * Mermaid 源码编码成可安全放入 attribute 的 base64url(UTF-8)\n * 给前端组件(非 markdown 渲染路径)复用,避免重复实现。\n */\nexport function encodeMermaidCodeToBase64Url(code: string): string {\n return encodeBase64Utf8(code)\n}\n\n/**\n * base64url 解码(UTF-8)\n */\nfunction decodeBase64Utf8(b64: string): string {\n // 兼容:某些情况下 '+' 可能被变成空格\n const normalized = b64.replace(/\\s/g, '+')\n // base64url -> base64\n let base64 = normalized.replace(/-/g, '+').replace(/_/g, '/')\n // 补齐 padding\n const pad = base64.length % 4\n if (pad === 2) base64 += '=='\n else if (pad === 3) base64 += '='\n else if (pad !== 0) {\n // 非法长度,交给 atob 抛错\n }\n\n const binary = atob(base64)\n const bytes = new Uint8Array(binary.length)\n for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)\n return new TextDecoder().decode(bytes)\n}\n\n/**\n * 初始化 Mermaid(仅需调用一次)\n */\nexport function initMermaid(): void {\n if (mermaidInitialized) return\n \n mermaid.initialize({\n startOnLoad: false,\n theme: 'dark',\n securityLevel: 'loose',\n fontFamily: 'inherit',\n flowchart: {\n useMaxWidth: true,\n htmlLabels: true,\n curve: 'basis',\n },\n sequence: {\n useMaxWidth: true,\n },\n gantt: {\n useMaxWidth: true,\n },\n })\n \n mermaidInitialized = true\n}\n\n/**\n * 渲染页面中的 Mermaid 图表\n * 用户点击\"显示图表\"按钮后调用\n * @param container 容器元素(可选,默认为 document)\n */\nexport async function renderMermaidDiagrams(container?: Element): Promise<void> {\n if (!mermaidInitialized) {\n initMermaid()\n }\n \n const root = container || document\n // 只选择未渲染的占位符\n const elements = root.querySelectorAll('.mermaid-placeholder:not(.mermaid-rendered):not(.mermaid-error-container)')\n \n for (const el of elements) {\n const b64 = el.getAttribute('data-mermaid-code-b64')\n if (!b64) continue\n\n let code = ''\n try {\n code = decodeBase64Utf8(b64)\n } catch (e) {\n console.warn('Mermaid 解码失败:', e)\n el.innerHTML = `<div class=\"mermaid-error\">图表解码失败</div>`\n el.classList.remove('mermaid-placeholder')\n el.classList.add('mermaid-error-container')\n continue\n }\n\n // 显示加载中\n el.innerHTML = `<div class=\"mermaid-loading\">渲染中...</div>`\n \n try {\n const id = `mermaid-${Math.random().toString(36).slice(2, 11)}`\n const { svg } = await mermaid.render(id, code)\n el.innerHTML = svg\n el.classList.remove('mermaid-placeholder')\n el.classList.add('mermaid-rendered')\n el.removeAttribute('data-mermaid-code-b64')\n } catch (error) {\n console.warn('Mermaid 渲染失败:', error)\n // 直接显示错误和源码\n el.innerHTML = `<div class=\"mermaid-error\">图表渲染失败</div><pre class=\"mermaid-source\">${code.replace(/</g, '&lt;').replace(/>/g, '&gt;')}</pre>`\n el.classList.remove('mermaid-placeholder')\n el.classList.add('mermaid-error-container')\n }\n }\n}\n\n/**\n * 渲染 LaTeX 公式\n * @param latex LaTeX 字符串\n * @param displayMode 是否为块级公式\n * @returns 渲染后的 HTML\n */\nfunction renderLatex(latex: string, displayMode: boolean): string {\n try {\n return katex.renderToString(latex, {\n displayMode,\n throwOnError: false,\n strict: false,\n trust: true,\n output: 'html',\n })\n } catch (error) {\n // 渲染失败时返回原文\n console.warn('LaTeX 渲染失败:', error)\n return displayMode \n ? `<div class=\"latex-error\">$$${latex}$$</div>`\n : `<span class=\"latex-error\">$${latex}$</span>`\n }\n}\n\n/**\n * 渲染 fenced 的 LaTeX 代码块(```latex / ```katex),用于“先代码、后渲染”的视图切换。\n * 注意:这里只返回 HTML 字符串,容器样式由 `.latex-block` 控制。\n */\nexport function renderLatexBlockToHtml(code: string): string {\n // 滚动条样式与系统对齐:直接复用全局 `.chat-scrollbar`\n return `<div class=\"latex-block chat-scrollbar\">${renderLatex(code.trim(), true)}</div>`\n}\n\n/**\n * 预处理文本中的 LaTeX 公式\n * 将 LaTeX 公式替换为占位符,避免被 markdown 解析器处理\n * @param text 原始文本\n * @returns { processed: 处理后文本, placeholders: 占位符映射 }\n */\nfunction preprocessLatex(text: string): { processed: string; placeholders: Map<string, string> } {\n const placeholders = new Map<string, string>()\n let counter = 0\n \n // 生成唯一占位符(使用 HTML 注释格式,避免被 markdown 解析)\n const createPlaceholder = () => {\n const placeholder = `<!--LATEX:${counter++}-->`\n return placeholder\n }\n\n let processed = text\n\n // 处理块级公式 $$...$$ (优先处理,避免和行内公式冲突)\n processed = processed.replace(/\\$\\$([\\s\\S]*?)\\$\\$/g, (_, latex) => {\n const placeholder = createPlaceholder()\n const rendered = renderLatex(latex.trim(), true)\n placeholders.set(placeholder, `<div class=\"latex-block chat-scrollbar\">${rendered}</div>`)\n return placeholder\n })\n\n // 处理块级公式 \\[...\\]\n processed = processed.replace(/\\\\\\[([\\s\\S]*?)\\\\\\]/g, (_, latex) => {\n const placeholder = createPlaceholder()\n const rendered = renderLatex(latex.trim(), true)\n placeholders.set(placeholder, `<div class=\"latex-block chat-scrollbar\">${rendered}</div>`)\n return placeholder\n })\n\n // 处理行内公式 $...$ (单个 $,不能跨行)\n // 注意:避免匹配 $$ 和转义的 \\$\n processed = processed.replace(/(?<!\\$)\\$(?!\\$)((?:\\\\.|[^$\\n])+?)\\$(?!\\$)/g, (_, latex) => {\n const placeholder = createPlaceholder()\n const rendered = renderLatex(latex.trim(), false)\n placeholders.set(placeholder, `<span class=\"latex-inline\">${rendered}</span>`)\n return placeholder\n })\n\n // 处理行内公式 \\(...\\)\n processed = processed.replace(/\\\\\\(([\\s\\S]*?)\\\\\\)/g, (_, latex) => {\n const placeholder = createPlaceholder()\n const rendered = renderLatex(latex.trim(), false)\n placeholders.set(placeholder, `<span class=\"latex-inline\">${rendered}</span>`)\n return placeholder\n })\n\n return { processed, placeholders }\n}\n\n/**\n * 后处理:将占位符替换回渲染后的 LaTeX\n */\nfunction postprocessLatex(html: string, placeholders: Map<string, string>): string {\n let result = html\n placeholders.forEach((rendered, placeholder) => {\n result = result.replace(placeholder, rendered)\n })\n return result\n}\n\n/**\n * 渲染 Markdown 为 HTML\n * @param markdown Markdown 文本\n * @returns 安全的 HTML 字符串\n */\nexport function renderMarkdown(markdown: string): string {\n if (!markdown) return ''\n\n // 预处理 LaTeX 公式\n const { processed, placeholders } = preprocessLatex(markdown)\n\n // 创建自定义渲染器(继承默认渲染器)\n const renderer = new Renderer()\n\n // 自定义代码块渲染(支持 Mermaid)\n renderer.code = (code: string, language?: string) => {\n const lang = (language || 'plaintext').toLowerCase()\n \n // Mermaid 图表:生成占位符,延迟渲染\n if (lang === 'mermaid') {\n // 注意:HTML attribute 会把换行规范化成空格,直接写入会破坏 mermaid 语法\n // 所以这里用 base64(UTF-8) 存储源码,渲染时再解码\n const b64 = encodeBase64Utf8(code)\n return `<div class=\"mermaid-placeholder\" data-mermaid-code-b64=\"${b64}\"><div class=\"mermaid-loading\">加载图表中...</div></div>`\n }\n \n const highlighted = highlightCode(code, language)\n // 滚动条样式与系统对齐:直接复用全局 `.chat-scrollbar`\n return `<pre class=\"markdown-code-block chat-scrollbar\"><code class=\"language-${lang}\">${highlighted}</code></pre>`\n }\n\n // 自定义表格渲染(添加样式类和滚动容器)\n renderer.table = (header: string, body: string) => {\n // 滚动条样式与系统对齐:直接复用全局 `.chat-scrollbar`\n return `<div class=\"markdown-table-wrapper chat-scrollbar\"><table class=\"markdown-table\"><thead>${header}</thead><tbody>${body}</tbody></table></div>`\n }\n\n // 自定义链接渲染(添加 target=\"_blank\" 和 rel=\"noopener noreferrer\")\n renderer.link = (href: string, title: string | null, text: string) => {\n const titleAttr = title ? ` title=\"${title}\"` : ''\n return `<a href=\"${href}\"${titleAttr} target=\"_blank\" rel=\"noopener noreferrer\" class=\"markdown-link\">${text}</a>`\n }\n\n // 自定义列表项渲染,将 checkbox 替换为文本 [x] 或 [ ]\n renderer.listitem = (text: string, task: boolean, checked: boolean) => {\n if (task) {\n // 任务列表:将 checkbox 替换为文本\n const checkboxText = checked ? '[x]' : '[ ]'\n // 移除 marked 生成的 checkbox input,替换为文本\n const textWithoutCheckbox = text.replace(/<input[^>]*>/g, '').trim()\n return `<li class=\"markdown-task-item\"><span class=\"markdown-task-checkbox\">${checkboxText}</span> ${textWithoutCheckbox}</li>`\n }\n // 普通列表项\n return `<li>${text}</li>`\n }\n\n // 配置 marked(marked 12.x 使用新的配置方式)\n marked.setOptions({\n breaks: true, // 支持换行\n gfm: true, // GitHub Flavored Markdown\n })\n\n // 渲染 Markdown(marked 12.x 返回字符串,不是 Promise)\n let html = marked(processed, { renderer }) as string\n\n // 后处理:将占位符替换回渲染后的 LaTeX\n html = postprocessLatex(html, placeholders)\n\n // 使用 DOMPurify 清理 HTML,防止 XSS\n // 允许 KaTeX 生成的 SVG 和相关元素\n html = DOMPurify.sanitize(html, {\n ALLOWED_TAGS: [\n 'p', 'br', 'strong', 'em', 'u', 's', 'code', 'pre',\n 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',\n 'ul', 'ol', 'li', 'blockquote',\n 'table', 'thead', 'tbody', 'tr', 'th', 'td',\n 'a', 'img', 'hr',\n 'div', 'span',\n // KaTeX 相关标签\n 'math', 'semantics', 'mrow', 'mi', 'mn', 'mo', 'msup', 'msub',\n 'mfrac', 'mroot', 'msqrt', 'mtext', 'mspace', 'mtable', 'mtr', 'mtd',\n 'annotation', 'mover', 'munder', 'munderover', 'menclose', 'mpadded',\n 'svg', 'line', 'path', 'rect', 'circle', 'g', 'use', 'defs', 'symbol',\n ],\n ALLOWED_ATTR: [\n 'href', 'title', 'target', 'rel', 'class',\n 'src', 'alt', 'width', 'height',\n // Mermaid 相关属性\n 'data-mermaid-code-b64',\n // KaTeX 相关属性\n 'style', 'xmlns', 'viewBox', 'preserveAspectRatio',\n 'd', 'x', 'y', 'x1', 'y1', 'x2', 'y2', 'r', 'cx', 'cy',\n 'fill', 'stroke', 'stroke-width', 'transform',\n 'xlink:href', 'aria-hidden', 'focusable', 'role',\n 'mathvariant', 'encoding', 'stretchy', 'fence', 'separator',\n 'lspace', 'rspace', 'minsize', 'maxsize', 'accent', 'accentunder',\n ],\n ADD_ATTR: ['xmlns:xlink'],\n })\n\n return html\n}\n","import { renderMarkdown } from './markdown'\n\nfunction normalizeLanguage(lang?: string): string {\n return (lang || '').trim().toLowerCase()\n}\n\nexport function isMermaidLanguage(lang?: string): boolean {\n return normalizeLanguage(lang) === 'mermaid'\n}\n\nexport function isLatexLanguage(lang?: string): boolean {\n const l = normalizeLanguage(lang)\n return l === 'latex' || l === 'katex' || l === 'tex'\n}\n\nexport function isLatexDocument(code: string): boolean {\n const t = (code || '').trim()\n return /\\\\documentclass\\b|\\\\usepackage\\b|\\\\begin\\{document\\}|\\\\end\\{document\\}/.test(t)\n}\n\nexport function canVisualizeLatex(code: string): boolean {\n const t = (code || '').trim()\n if (!t) return false\n if (isLatexDocument(t)) return false\n return true\n}\n\nexport function hasLatexDelimiters(code: string): boolean {\n const t = (code || '').trim()\n if (!t) return false\n return (\n /\\$\\$[\\s\\S]*\\$\\$/.test(t) ||\n /\\\\\\[[\\s\\S]*\\\\\\]/.test(t) ||\n /\\\\\\([\\s\\S]*\\\\\\)/.test(t) ||\n /(?<!\\$)\\$(?!\\$)[\\s\\S]*?\\$(?!\\$)/.test(t)\n )\n}\n\nexport function shouldShowVisualToggle(lang?: string, code?: string): boolean {\n if (isMermaidLanguage(lang)) return true\n if (isLatexLanguage(lang)) return canVisualizeLatex(code || '')\n return false\n}\n\n/**\n * 将 fenced 的 latex/katex/tex 代码块渲染成 HTML(复用 shared 的 renderMarkdown + latex 预处理)。\n * - 如果是完整 LaTeX 文档:返回提示 + code block(避免 KaTeX 报错)\n * - 如果已经带分隔符:直接渲染(避免二次包裹)\n * - 否则:自动包一层 $$...$$ 作为 display 公式渲染\n */\nexport function renderFencedLatexToHtml(code: string): string {\n const t = (code || '').trim()\n if (!t) return ''\n\n if (!canVisualizeLatex(t)) {\n return renderMarkdown(\n `> 不支持将完整 LaTeX 文档作为公式渲染,请切换到代码视图查看。\\n\\n\\`\\`\\`latex\\n${t}\\n\\`\\`\\``\n )\n }\n\n if (hasLatexDelimiters(t)) {\n return renderMarkdown(t)\n }\n\n return renderMarkdown(`$$\\n${t}\\n$$`)\n}\n\n\n"],"mappings":"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","names":[]}
@@ -1,80 +0,0 @@
1
- /**
2
- * 代码高亮工具
3
- * 使用 highlight.js 提供代码语法高亮
4
- */
5
-
6
- import hljs from 'highlight.js'
7
-
8
- /** 支持的语言别名映射 */
9
- const LANGUAGE_ALIASES: Record<string, string> = {
10
- js: 'javascript',
11
- ts: 'typescript',
12
- tsx: 'typescript',
13
- jsx: 'javascript',
14
- py: 'python',
15
- rb: 'ruby',
16
- sh: 'bash',
17
- shell: 'bash',
18
- yml: 'yaml',
19
- md: 'markdown',
20
- }
21
-
22
- /**
23
- * 高亮代码
24
- * @param code 代码内容
25
- * @param language 语言标识
26
- * @returns 高亮后的 HTML
27
- */
28
- export function highlightCode(code: string, language?: string): string {
29
- if (!language) {
30
- // 无语言指定,尝试自动检测
31
- try {
32
- const result = hljs.highlightAuto(code)
33
- return result.value
34
- } catch {
35
- return escapeHtml(code)
36
- }
37
- }
38
-
39
- // 处理语言别名
40
- const normalizedLang = LANGUAGE_ALIASES[language.toLowerCase()] || language.toLowerCase()
41
-
42
- try {
43
- if (hljs.getLanguage(normalizedLang)) {
44
- return hljs.highlight(code, { language: normalizedLang }).value
45
- }
46
- // 语言不支持,返回转义后的原文
47
- return escapeHtml(code)
48
- } catch {
49
- return escapeHtml(code)
50
- }
51
- }
52
-
53
- /** HTML 转义 */
54
- function escapeHtml(text: string): string {
55
- return text
56
- .replace(/&/g, '&amp;')
57
- .replace(/</g, '&lt;')
58
- .replace(/>/g, '&gt;')
59
- .replace(/"/g, '&quot;')
60
- .replace(/'/g, '&#039;')
61
- }
62
-
63
- /**
64
- * 获取语言显示名称
65
- * @param language 语言标识
66
- * @returns 显示名称
67
- */
68
- export function getLanguageDisplayName(language?: string): string {
69
- if (!language) return 'Plain Text'
70
-
71
- const normalizedLang = LANGUAGE_ALIASES[language.toLowerCase()] || language.toLowerCase()
72
- const langDef = hljs.getLanguage(normalizedLang)
73
-
74
- if (langDef) {
75
- // 首字母大写
76
- return normalizedLang.charAt(0).toUpperCase() + normalizedLang.slice(1)
77
- }
78
-
79
- return language
80
- }
package/src/index.ts DELETED
@@ -1,59 +0,0 @@
1
- /**
2
- * @huyooo/ai-chat-shared
3
- *
4
- * AI Chat 共享模块
5
- * - 内容解析器
6
- * - 代码高亮
7
- * - 共享类型定义
8
- */
9
-
10
- // 类型导出
11
- export type {
12
- // 内容块类型
13
- ContentBlockType,
14
- ContentBlockBase,
15
- TextBlock,
16
- CodeBlock,
17
- ContentBlock,
18
- // 内置数据类型
19
- WeatherData,
20
- WeatherForecastItem,
21
- SearchResultItem,
22
- CodeExecutionResult,
23
- FileOperationResult,
24
- } from './types'
25
-
26
- // 解析器导出
27
- export {
28
- parseContent,
29
- createStreamParseState,
30
- parseContentStream,
31
- finishStreamParse,
32
- } from './parser'
33
- export type { StreamParseState } from './parser'
34
-
35
- // 高亮工具导出
36
- export {
37
- highlightCode,
38
- getLanguageDisplayName,
39
- } from './highlighter'
40
-
41
- // Markdown 渲染工具导出
42
- export {
43
- renderMarkdown,
44
- initMermaid,
45
- renderMermaidDiagrams,
46
- encodeMermaidCodeToBase64Url,
47
- renderLatexBlockToHtml,
48
- } from './markdown'
49
-
50
- // Mermaid / LaTeX 可视化渲染工具
51
- export {
52
- isMermaidLanguage,
53
- isLatexLanguage,
54
- isLatexDocument,
55
- canVisualizeLatex,
56
- hasLatexDelimiters,
57
- shouldShowVisualToggle,
58
- renderFencedLatexToHtml,
59
- } from './visual'
package/src/markdown.ts DELETED
@@ -1,335 +0,0 @@
1
- /**
2
- * Markdown 渲染工具
3
- * 提供统一的 Markdown 渲染函数,供 React 和 Vue 版本使用
4
- * 支持 LaTeX 数学公式渲染和 Mermaid 图表
5
- */
6
-
7
- import { marked, Renderer } from 'marked'
8
- import DOMPurify from 'dompurify'
9
- import katex from 'katex'
10
- import mermaid from 'mermaid'
11
- import { highlightCode } from './highlighter'
12
-
13
- // Mermaid 初始化标记
14
- let mermaidInitialized = false
15
-
16
- /**
17
- * base64url 编码(UTF-8)
18
- * 不能直接把源码放进 attribute(换行会被规范化),所以使用 base64 传递。
19
- * 同时避免在某些链路里 '+' 被当成空格的问题,这里使用 base64url(- _,无 padding)。
20
- */
21
- function encodeBase64Utf8(text: string): string {
22
- const bytes = new TextEncoder().encode(text)
23
- let binary = ''
24
- for (const b of bytes) binary += String.fromCharCode(b)
25
- const b64 = btoa(binary)
26
- // base64url: +/ -> -_,去掉末尾 padding =
27
- return b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '')
28
- }
29
-
30
- /**
31
- * Mermaid 源码编码成可安全放入 attribute 的 base64url(UTF-8)
32
- * 给前端组件(非 markdown 渲染路径)复用,避免重复实现。
33
- */
34
- export function encodeMermaidCodeToBase64Url(code: string): string {
35
- return encodeBase64Utf8(code)
36
- }
37
-
38
- /**
39
- * base64url 解码(UTF-8)
40
- */
41
- function decodeBase64Utf8(b64: string): string {
42
- // 兼容:某些情况下 '+' 可能被变成空格
43
- const normalized = b64.replace(/\s/g, '+')
44
- // base64url -> base64
45
- let base64 = normalized.replace(/-/g, '+').replace(/_/g, '/')
46
- // 补齐 padding
47
- const pad = base64.length % 4
48
- if (pad === 2) base64 += '=='
49
- else if (pad === 3) base64 += '='
50
- else if (pad !== 0) {
51
- // 非法长度,交给 atob 抛错
52
- }
53
-
54
- const binary = atob(base64)
55
- const bytes = new Uint8Array(binary.length)
56
- for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i)
57
- return new TextDecoder().decode(bytes)
58
- }
59
-
60
- /**
61
- * 初始化 Mermaid(仅需调用一次)
62
- */
63
- export function initMermaid(): void {
64
- if (mermaidInitialized) return
65
-
66
- mermaid.initialize({
67
- startOnLoad: false,
68
- theme: 'dark',
69
- securityLevel: 'loose',
70
- fontFamily: 'inherit',
71
- flowchart: {
72
- useMaxWidth: true,
73
- htmlLabels: true,
74
- curve: 'basis',
75
- },
76
- sequence: {
77
- useMaxWidth: true,
78
- },
79
- gantt: {
80
- useMaxWidth: true,
81
- },
82
- })
83
-
84
- mermaidInitialized = true
85
- }
86
-
87
- /**
88
- * 渲染页面中的 Mermaid 图表
89
- * 用户点击"显示图表"按钮后调用
90
- * @param container 容器元素(可选,默认为 document)
91
- */
92
- export async function renderMermaidDiagrams(container?: Element): Promise<void> {
93
- if (!mermaidInitialized) {
94
- initMermaid()
95
- }
96
-
97
- const root = container || document
98
- // 只选择未渲染的占位符
99
- const elements = root.querySelectorAll('.mermaid-placeholder:not(.mermaid-rendered):not(.mermaid-error-container)')
100
-
101
- for (const el of elements) {
102
- const b64 = el.getAttribute('data-mermaid-code-b64')
103
- if (!b64) continue
104
-
105
- let code = ''
106
- try {
107
- code = decodeBase64Utf8(b64)
108
- } catch (e) {
109
- console.warn('Mermaid 解码失败:', e)
110
- el.innerHTML = `<div class="mermaid-error">图表解码失败</div>`
111
- el.classList.remove('mermaid-placeholder')
112
- el.classList.add('mermaid-error-container')
113
- continue
114
- }
115
-
116
- // 显示加载中
117
- el.innerHTML = `<div class="mermaid-loading">渲染中...</div>`
118
-
119
- try {
120
- const id = `mermaid-${Math.random().toString(36).slice(2, 11)}`
121
- const { svg } = await mermaid.render(id, code)
122
- el.innerHTML = svg
123
- el.classList.remove('mermaid-placeholder')
124
- el.classList.add('mermaid-rendered')
125
- el.removeAttribute('data-mermaid-code-b64')
126
- } catch (error) {
127
- console.warn('Mermaid 渲染失败:', error)
128
- // 直接显示错误和源码
129
- el.innerHTML = `<div class="mermaid-error">图表渲染失败</div><pre class="mermaid-source">${code.replace(/</g, '&lt;').replace(/>/g, '&gt;')}</pre>`
130
- el.classList.remove('mermaid-placeholder')
131
- el.classList.add('mermaid-error-container')
132
- }
133
- }
134
- }
135
-
136
- /**
137
- * 渲染 LaTeX 公式
138
- * @param latex LaTeX 字符串
139
- * @param displayMode 是否为块级公式
140
- * @returns 渲染后的 HTML
141
- */
142
- function renderLatex(latex: string, displayMode: boolean): string {
143
- try {
144
- return katex.renderToString(latex, {
145
- displayMode,
146
- throwOnError: false,
147
- strict: false,
148
- trust: true,
149
- output: 'html',
150
- })
151
- } catch (error) {
152
- // 渲染失败时返回原文
153
- console.warn('LaTeX 渲染失败:', error)
154
- return displayMode
155
- ? `<div class="latex-error">$$${latex}$$</div>`
156
- : `<span class="latex-error">$${latex}$</span>`
157
- }
158
- }
159
-
160
- /**
161
- * 渲染 fenced 的 LaTeX 代码块(```latex / ```katex),用于“先代码、后渲染”的视图切换。
162
- * 注意:这里只返回 HTML 字符串,容器样式由 `.latex-block` 控制。
163
- */
164
- export function renderLatexBlockToHtml(code: string): string {
165
- // 滚动条样式与系统对齐:直接复用全局 `.chat-scrollbar`
166
- return `<div class="latex-block chat-scrollbar">${renderLatex(code.trim(), true)}</div>`
167
- }
168
-
169
- /**
170
- * 预处理文本中的 LaTeX 公式
171
- * 将 LaTeX 公式替换为占位符,避免被 markdown 解析器处理
172
- * @param text 原始文本
173
- * @returns { processed: 处理后文本, placeholders: 占位符映射 }
174
- */
175
- function preprocessLatex(text: string): { processed: string; placeholders: Map<string, string> } {
176
- const placeholders = new Map<string, string>()
177
- let counter = 0
178
-
179
- // 生成唯一占位符(使用 HTML 注释格式,避免被 markdown 解析)
180
- const createPlaceholder = () => {
181
- const placeholder = `<!--LATEX:${counter++}-->`
182
- return placeholder
183
- }
184
-
185
- let processed = text
186
-
187
- // 处理块级公式 $$...$$ (优先处理,避免和行内公式冲突)
188
- processed = processed.replace(/\$\$([\s\S]*?)\$\$/g, (_, latex) => {
189
- const placeholder = createPlaceholder()
190
- const rendered = renderLatex(latex.trim(), true)
191
- placeholders.set(placeholder, `<div class="latex-block chat-scrollbar">${rendered}</div>`)
192
- return placeholder
193
- })
194
-
195
- // 处理块级公式 \[...\]
196
- processed = processed.replace(/\\\[([\s\S]*?)\\\]/g, (_, latex) => {
197
- const placeholder = createPlaceholder()
198
- const rendered = renderLatex(latex.trim(), true)
199
- placeholders.set(placeholder, `<div class="latex-block chat-scrollbar">${rendered}</div>`)
200
- return placeholder
201
- })
202
-
203
- // 处理行内公式 $...$ (单个 $,不能跨行)
204
- // 注意:避免匹配 $$ 和转义的 \$
205
- processed = processed.replace(/(?<!\$)\$(?!\$)((?:\\.|[^$\n])+?)\$(?!\$)/g, (_, latex) => {
206
- const placeholder = createPlaceholder()
207
- const rendered = renderLatex(latex.trim(), false)
208
- placeholders.set(placeholder, `<span class="latex-inline">${rendered}</span>`)
209
- return placeholder
210
- })
211
-
212
- // 处理行内公式 \(...\)
213
- processed = processed.replace(/\\\(([\s\S]*?)\\\)/g, (_, latex) => {
214
- const placeholder = createPlaceholder()
215
- const rendered = renderLatex(latex.trim(), false)
216
- placeholders.set(placeholder, `<span class="latex-inline">${rendered}</span>`)
217
- return placeholder
218
- })
219
-
220
- return { processed, placeholders }
221
- }
222
-
223
- /**
224
- * 后处理:将占位符替换回渲染后的 LaTeX
225
- */
226
- function postprocessLatex(html: string, placeholders: Map<string, string>): string {
227
- let result = html
228
- placeholders.forEach((rendered, placeholder) => {
229
- result = result.replace(placeholder, rendered)
230
- })
231
- return result
232
- }
233
-
234
- /**
235
- * 渲染 Markdown 为 HTML
236
- * @param markdown Markdown 文本
237
- * @returns 安全的 HTML 字符串
238
- */
239
- export function renderMarkdown(markdown: string): string {
240
- if (!markdown) return ''
241
-
242
- // 预处理 LaTeX 公式
243
- const { processed, placeholders } = preprocessLatex(markdown)
244
-
245
- // 创建自定义渲染器(继承默认渲染器)
246
- const renderer = new Renderer()
247
-
248
- // 自定义代码块渲染(支持 Mermaid)
249
- renderer.code = (code: string, language?: string) => {
250
- const lang = (language || 'plaintext').toLowerCase()
251
-
252
- // Mermaid 图表:生成占位符,延迟渲染
253
- if (lang === 'mermaid') {
254
- // 注意:HTML attribute 会把换行规范化成空格,直接写入会破坏 mermaid 语法
255
- // 所以这里用 base64(UTF-8) 存储源码,渲染时再解码
256
- const b64 = encodeBase64Utf8(code)
257
- return `<div class="mermaid-placeholder" data-mermaid-code-b64="${b64}"><div class="mermaid-loading">加载图表中...</div></div>`
258
- }
259
-
260
- const highlighted = highlightCode(code, language)
261
- // 滚动条样式与系统对齐:直接复用全局 `.chat-scrollbar`
262
- return `<pre class="markdown-code-block chat-scrollbar"><code class="language-${lang}">${highlighted}</code></pre>`
263
- }
264
-
265
- // 自定义表格渲染(添加样式类和滚动容器)
266
- renderer.table = (header: string, body: string) => {
267
- // 滚动条样式与系统对齐:直接复用全局 `.chat-scrollbar`
268
- return `<div class="markdown-table-wrapper chat-scrollbar"><table class="markdown-table"><thead>${header}</thead><tbody>${body}</tbody></table></div>`
269
- }
270
-
271
- // 自定义链接渲染(添加 target="_blank" 和 rel="noopener noreferrer")
272
- renderer.link = (href: string, title: string | null, text: string) => {
273
- const titleAttr = title ? ` title="${title}"` : ''
274
- return `<a href="${href}"${titleAttr} target="_blank" rel="noopener noreferrer" class="markdown-link">${text}</a>`
275
- }
276
-
277
- // 自定义列表项渲染,将 checkbox 替换为文本 [x] 或 [ ]
278
- renderer.listitem = (text: string, task: boolean, checked: boolean) => {
279
- if (task) {
280
- // 任务列表:将 checkbox 替换为文本
281
- const checkboxText = checked ? '[x]' : '[ ]'
282
- // 移除 marked 生成的 checkbox input,替换为文本
283
- const textWithoutCheckbox = text.replace(/<input[^>]*>/g, '').trim()
284
- return `<li class="markdown-task-item"><span class="markdown-task-checkbox">${checkboxText}</span> ${textWithoutCheckbox}</li>`
285
- }
286
- // 普通列表项
287
- return `<li>${text}</li>`
288
- }
289
-
290
- // 配置 marked(marked 12.x 使用新的配置方式)
291
- marked.setOptions({
292
- breaks: true, // 支持换行
293
- gfm: true, // GitHub Flavored Markdown
294
- })
295
-
296
- // 渲染 Markdown(marked 12.x 返回字符串,不是 Promise)
297
- let html = marked(processed, { renderer }) as string
298
-
299
- // 后处理:将占位符替换回渲染后的 LaTeX
300
- html = postprocessLatex(html, placeholders)
301
-
302
- // 使用 DOMPurify 清理 HTML,防止 XSS
303
- // 允许 KaTeX 生成的 SVG 和相关元素
304
- html = DOMPurify.sanitize(html, {
305
- ALLOWED_TAGS: [
306
- 'p', 'br', 'strong', 'em', 'u', 's', 'code', 'pre',
307
- 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
308
- 'ul', 'ol', 'li', 'blockquote',
309
- 'table', 'thead', 'tbody', 'tr', 'th', 'td',
310
- 'a', 'img', 'hr',
311
- 'div', 'span',
312
- // KaTeX 相关标签
313
- 'math', 'semantics', 'mrow', 'mi', 'mn', 'mo', 'msup', 'msub',
314
- 'mfrac', 'mroot', 'msqrt', 'mtext', 'mspace', 'mtable', 'mtr', 'mtd',
315
- 'annotation', 'mover', 'munder', 'munderover', 'menclose', 'mpadded',
316
- 'svg', 'line', 'path', 'rect', 'circle', 'g', 'use', 'defs', 'symbol',
317
- ],
318
- ALLOWED_ATTR: [
319
- 'href', 'title', 'target', 'rel', 'class',
320
- 'src', 'alt', 'width', 'height',
321
- // Mermaid 相关属性
322
- 'data-mermaid-code-b64',
323
- // KaTeX 相关属性
324
- 'style', 'xmlns', 'viewBox', 'preserveAspectRatio',
325
- 'd', 'x', 'y', 'x1', 'y1', 'x2', 'y2', 'r', 'cx', 'cy',
326
- 'fill', 'stroke', 'stroke-width', 'transform',
327
- 'xlink:href', 'aria-hidden', 'focusable', 'role',
328
- 'mathvariant', 'encoding', 'stretchy', 'fence', 'separator',
329
- 'lspace', 'rspace', 'minsize', 'maxsize', 'accent', 'accentunder',
330
- ],
331
- ADD_ATTR: ['xmlns:xlink'],
332
- })
333
-
334
- return html
335
- }