fix: update stream-markdown-parser to version 0.0.30 and enhance math-like detection logic

Author: Simon-He95

package.json

@@ -112,7 +112,7 @@
   },
   "dependencies": {
     "@floating-ui/dom": "^1.7.4",
-    "stream-markdown-parser": "^0.0.29"
+    "stream-markdown-parser": "^0.0.30"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^5.4.1",

packages/markdown-parser/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stream-markdown-parser",
   "type": "module",
-  "version": "0.0.29",
+  "version": "0.0.30",
   "packageManager": "[email protected]",
   "description": "Pure markdown parser and renderer utilities with streaming support - framework agnostic",
   "author": "Simon He",

packages/markdown-parser/src/plugins/isMathLike.ts

@@ -37,6 +37,10 @@ const TEX_SPECIFIC_RE = /\\(?:text|frac|left|right|times)/
 // regex literal on some platforms/linters.
 // eslint-disable-next-line prefer-regex-literals
 const OPS_RE = new RegExp('(?<!\\+)\\+(?!\\+)|[=\\-*/^<>]|\\\\times|\\\\pm|\\\\cdot|\\\\le|\\\\ge|\\\\neq')
+// Hyphenated multi-word (like "Quasi-Streaming") should not be treated
+// as a math operator. But single-letter-variable hyphens (e.g. "x-y") are
+// still math; so only ignore hyphens between multi-letter words.
+const HYPHENATED_MULTIWORD_RE = /\b[A-Z]{2,}-[A-Z]{2,}\b/i
 const FUNC_CALL_RE = /[A-Z]+\s*\([^)]+\)/i
 const WORDS_RE = /\b(?:sin|cos|tan|log|ln|exp|sqrt|frac|sum|lim|int|prod)\b/
 // Heuristic to detect common date/time patterns like 2025/9/30 21:37:24 and
@@ -79,14 +83,16 @@ export function isMathLike(s: string) {
   const superscriptPattern = /(?:^|[^\w\\])(?:[A-Z]|\\[A-Z]+)\^(?:\{[^}]+\}|[A-Z0-9\\])/i
   const superSub = subscriptPattern.test(norm) || superscriptPattern.test(norm)
   // common math operator symbols or named commands
-  const ops = OPS_RE.test(norm)
+  // Ignore operator-like hyphens that are clearly word compound separators
+  // (e.g. "Quasi-Streaming"). Keep hyphens for math like "x-y".
+  const ops = OPS_RE.test(norm) && !HYPHENATED_MULTIWORD_RE.test(norm)
   // function-like patterns: f(x), sin(x)
   const funcCall = FUNC_CALL_RE.test(norm)
   // common math words
   const words = WORDS_RE.test(norm)
-  // 纯单个英文字命，也渲染成数学公式
+  // 纯单个英文字母也渲染成数学公式
   // e.g. (w) (x) (y) (z)
-  // const pureWord = /^\([a-zA-Z]\)$/i.test(stripped)
+  const pureWord = /^\([a-z]\)$/i.test(stripped)
 
-  return texCmd || texCmdWithBraces || texBraceStart || texSpecific || superSub || ops || funcCall || words
+  return texCmd || texCmdWithBraces || texBraceStart || texSpecific || superSub || ops || funcCall || words || pureWord
 }

packages/markdown-parser/src/plugins/math.ts

@@ -439,19 +439,7 @@ export function applyMath(md: MarkdownIt, mathOpts?: MathOptions) {
     let closeDelim = ''
     for (const [open, close] of delimiters) {
       // 这里其实不应该只匹配 startWith的情况因为很可能前面还有 text
-      const m = lineText.indexOf(open)
-      if (m !== -1) {
-        const beforeText = lineText.slice(0, m)
-        if (beforeText) {
-          if (beforeText.endsWith('!')) {
-            // image-node need break
-            return false
-          }
-          const inline = s.push('inline', '', 0)
-          inline.content = beforeText
-          inline.map = [startLine, startLine]
-          inline.children = []
-        }
+      if (lineText.startsWith(open)) {
         if (open.includes('[')) {
           if (lineText.replace('\\', '') === '[') {
             if (startLine + 1 < endLine) {

playground/src/pages/markdown.vue

@@ -3,6 +3,7 @@ import { Icon } from '@iconify/vue'
 import MarkdownRender from 'vue-renderer-markdown'
 import { useRouter } from 'vue-router'
 import { getUseMonaco } from '../../../src/components/CodeBlockNode/monaco'
+import MarkdownCodeBlockNode from '../../../src/components/MarkdownCodeBlockNode'
 import { setCustomComponents } from '../../../src/utils/nodeComponents'
 import KatexWorker from '../../../src/workers/katexRenderer.worker?worker&inline'
 import { setKaTeXWorker } from '../../../src/workers/katexWorkerClient'
@@ -11,7 +12,6 @@ import { setMermaidWorker } from '../../../src/workers/mermaidWorkerClient'
 import ThinkingNode from '../components/ThinkingNode.vue'
 import { streamContent } from '../const/markdown'
 import 'katex/dist/katex.min.css'
-import MarkdownCodeBlockNode from '../../../src/components/MarkdownCodeBlockNode'
 
 // 每隔 10 毫秒输出一部分内容
 const content = ref<string>('')

pnpm-lock.yaml

@@ -54,16 +54,6 @@ exports[`e2e markdown parsing (fixtures) > parses fixture code-diff.md > code-di
 
 exports[`e2e markdown parsing (fixtures) > parses fixture escaped-brackets.md > escaped-brackets.md 1`] = `
 [
-  {
-    "children": undefined,
-    "firstText": "A line with an escaped bracket: ",
-    "type": "text",
-  },
-  {
-    "children": undefined,
-    "firstText": "A line with an escaped bracket: ",
-    "type": "text",
-  },
   {
     "children": [
       "text",
@@ -106,11 +96,6 @@ print('ok')
 
 exports[`e2e markdown parsing (fixtures) > parses fixture footnotes.md > footnotes.md 1`] = `
 [
-  {
-    "children": undefined,
-    "firstText": "This is a sentence with a footnote",
-    "type": "text",
-  },
   {
     "children": [
       "text",
@@ -177,11 +162,6 @@ exports[`e2e markdown parsing (fixtures) > parses fixture image-link.md > image-
     "firstText": "Here is an image: ",
     "type": "paragraph",
   },
-  {
-    "children": undefined,
-    "firstText": "And a link: ",
-    "type": "text",
-  },
   {
     "children": [
       "text",
@@ -214,9 +194,8 @@ exports[`e2e markdown parsing (fixtures) > parses fixture math.md > math.md 1`]
   {
     "children": [
       "text",
-      "math_inline",
     ],
-    "firstText": "A line with parentheses that should not break: ",
+    "firstText": "A line with parentheses that should not break: (not-math)",
     "type": "paragraph",
   },
 ]
@@ -315,23 +294,13 @@ exports[`e2e markdown parsing (fixtures) > parses fixture unclosed-fence.md > un
 
 exports[`e2e markdown parsing (fixtures) > parses fixture unmatched-brackets.md > unmatched-brackets.md 1`] = `
 [
-  {
-    "children": undefined,
-    "firstText": "This line has an opening bracket ",
-    "type": "text",
-  },
   {
     "children": [
       "text",
     ],
     "firstText": "This line has an opening bracket [ without a closing.",
     "type": "paragraph",
   },
-  {
-    "children": undefined,
-    "firstText": "Another line with a link-like ",
-    "type": "text",
-  },
   {
     "children": [
       "text",

test/__snapshots__/e2e.markdown.test.ts.snap

@@ -4,7 +4,7 @@ import { expect, it } from 'vitest'
 it('recognizes \"\\boldsymbol{...}\" as math-like', () => {
   expect(isMathLike('\\boldsymbol{\\beta}')).toBe(true)
   expect(isMathLike('\\(C++\\)')).toBe(false)
-  expect(isMathLike('\\(W\\)')).toBe(false)
+  expect(isMathLike('(W)')).toBe(true)
   expect(isMathLike('\\(f^{(k)}(a)\\)')).toBe(true)
   expect(isMathLike('\\(W^\perp\\)')).toBe(true)
   expect(isMathLike('\\(2025/9/30 21:37:24\\)')).toBe(false)
@@ -13,4 +13,5 @@ it('recognizes \"\\boldsymbol{...}\" as math-like', () => {
   expect(isMathLike('served from vue-markdown-icon.1')).toBe(false)
   expect(isMathLike('get_time')).toBe(false)
   expect(isMathLike('or **matrix of coefficients**')).toBe(false)
+  expect(isMathLike('Quasi-Streaming')).toBe(false)
 })

test/debug/isMathLike.test.ts

@@ -261,13 +261,7 @@ exports[`markdownRender node e2e coverage > renders footnote nodes 1`] = `
 "<div data-v-8dfe8a80="" class="markdown-renderer">
   <div data-v-8dfe8a80="">
     <div data-v-8dfe8a80="" class="node-spacer" style="height: 0px;" aria-hidden="true"></div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="0" data-node-type="text">
-      <div data-v-8dfe8a80="" class="node-content">
-        <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
-        <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true"><span data-v-a84b8095="" data-v-8dfe8a80="" class="whitespace-pre-wrap break-words text-node" index-key="markdown-renderer-0" typewriter="true" is-dark="false">A footnote reference</span></transition-stub>
-      </div>
-    </div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="1" data-node-type="paragraph">
+    <div data-v-8dfe8a80="" class="node-slot" data-node-index="0" data-node-type="paragraph">
       <div data-v-8dfe8a80="" class="node-content">
         <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
         <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true">
@@ -277,7 +271,7 @@ exports[`markdownRender node e2e coverage > renders footnote nodes 1`] = `
         </transition-stub>
       </div>
     </div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="2" data-node-type="footnote">
+    <div data-v-8dfe8a80="" class="node-slot" data-node-index="1" data-node-type="footnote">
       <div data-v-8dfe8a80="" class="node-content">
         <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
         <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true">
@@ -436,17 +430,11 @@ exports[`markdownRender node e2e coverage > renders link node 1`] = `
 "<div data-v-8dfe8a80="" class="markdown-renderer">
   <div data-v-8dfe8a80="">
     <div data-v-8dfe8a80="" class="node-spacer" style="height: 0px;" aria-hidden="true"></div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="0" data-node-type="text">
-      <div data-v-8dfe8a80="" class="node-content">
-        <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
-        <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true"><span data-v-a84b8095="" data-v-8dfe8a80="" class="whitespace-pre-wrap break-words text-node" index-key="markdown-renderer-0" typewriter="true" is-dark="false">Visit </span></transition-stub>
-      </div>
-    </div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="1" data-node-type="paragraph">
+    <div data-v-8dfe8a80="" class="node-slot" data-node-index="0" data-node-type="paragraph">
       <div data-v-8dfe8a80="" class="node-content">
         <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
         <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true">
-          <p data-v-93ee5c2d="" data-v-8dfe8a80="" dir="auto" class="paragraph-node" typewriter="true" is-dark="false"><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node">Visit </span><a data-v-994bfd08="" data-v-93ee5c2d="" class="link-node" href="https://vuejs.org" aria-label="Link: https://vuejs.org" aria-hidden="false" target="_blank" rel="noopener noreferrer" style="--link-color: #0366d6; --underline-height: 2px; --underline-bottom: -3px; --underline-opacity: 0.9; --underline-duration: 0.8s; --underline-timing: linear; --underline-iteration: infinite;"><span data-v-a84b8095="" data-v-994bfd08="" class="whitespace-pre-wrap break-words text-node" index-key="markdown-renderer-1-1-0">Vue</span></a><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node"> now.</span></p>
+          <p data-v-93ee5c2d="" data-v-8dfe8a80="" dir="auto" class="paragraph-node" typewriter="true" is-dark="false"><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node">Visit </span><a data-v-994bfd08="" data-v-93ee5c2d="" class="link-node" href="https://vuejs.org" aria-label="Link: https://vuejs.org" aria-hidden="false" target="_blank" rel="noopener noreferrer" style="--link-color: #0366d6; --underline-height: 2px; --underline-bottom: -3px; --underline-opacity: 0.9; --underline-duration: 0.8s; --underline-timing: linear; --underline-iteration: infinite;"><span data-v-a84b8095="" data-v-994bfd08="" class="whitespace-pre-wrap break-words text-node" index-key="markdown-renderer-0-1-0">Vue</span></a><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node"> now.</span></p>
         </transition-stub>
       </div>
     </div>
@@ -543,17 +531,11 @@ exports[`markdownRender node e2e coverage > renders reference node 1`] = `
 "<div data-v-8dfe8a80="" class="markdown-renderer">
   <div data-v-8dfe8a80="">
     <div data-v-8dfe8a80="" class="node-spacer" style="height: 0px;" aria-hidden="true"></div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="0" data-node-type="text">
-      <div data-v-8dfe8a80="" class="node-content">
-        <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
-        <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true"><span data-v-a84b8095="" data-v-8dfe8a80="" class="whitespace-pre-wrap break-words text-node" index-key="markdown-renderer-0" typewriter="true" is-dark="false">Cite research </span></transition-stub>
-      </div>
-    </div>
-    <div data-v-8dfe8a80="" class="node-slot" data-node-index="1" data-node-type="paragraph">
+    <div data-v-8dfe8a80="" class="node-slot" data-node-index="0" data-node-type="paragraph">
       <div data-v-8dfe8a80="" class="node-content">
         <!-- Skip wrapping code_block nodes in transitions to avoid touching Monaco editor internals -->
         <transition-stub data-v-8dfe8a80="" name="typewriter" appear="true" persisted="false" css="true">
-          <p data-v-93ee5c2d="" data-v-8dfe8a80="" dir="auto" class="paragraph-node" typewriter="true" is-dark="false"><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node">Cite research </span><span data-v-93ee5c2d="" class="reference-node cursor-pointer bg-accent text-xs rounded-md px-1.5 mx-0.5 hover:bg-secondary" role="button" tabindex="0" index-key="markdown-renderer-1-1">1</span><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node"> for details.</span></p>
+          <p data-v-93ee5c2d="" data-v-8dfe8a80="" dir="auto" class="paragraph-node" typewriter="true" is-dark="false"><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node">Cite research </span><span data-v-93ee5c2d="" class="reference-node cursor-pointer bg-accent text-xs rounded-md px-1.5 mx-0.5 hover:bg-secondary" role="button" tabindex="0" index-key="markdown-renderer-0-1">1</span><span data-v-93ee5c2d="" class="whitespace-pre-wrap break-words text-node"> for details.</span></p>
         </transition-stub>
       </div>
     </div>