fix(docs): allow hyphens in fenced codeblock language (#2437)

The fenced-codeblock language regexes in render.ts and text.ts matched
\w which excludes `-`, so languages like `glimmer-ts`, `vue-html`, and
`objective-c` were truncated: the `-ts` suffix was stripped off the
language and leaked into the top of the code body, breaking Shiki
highlighting.

Swap `\w` for `[\w-]` in the three affected regexes and add a
regression test covering `glimmer-ts`.

Fixes #2437

Author: MukundaKatta

server/utils/docs/render.ts

@@ -191,9 +191,9 @@ async function renderJsDocTags(tags: JsDocTag[], symbolLookup: SymbolLookup): Pr
     : null
   const examplePromises = examples.map(async example => {
     if (!example.doc) return ''
-    const langMatch = example.doc.match(/```(\w+)?/)
+    const langMatch = example.doc.match(/```([\w-]+)?/)
     const lang = langMatch?.[1] || 'typescript'
-    const code = example.doc.replace(/```\w*\n?/g, '').trim()
+    const code = example.doc.replace(/```[\w-]*\n?/g, '').trim()
     return highlightCodeBlock(code, lang)
   })
 

server/utils/docs/text.ts

@@ -106,7 +106,7 @@ export async function renderMarkdown(text: string, symbolLookup: SymbolLookup):
   // - \r\n, \n, or \r line endings
   const codeBlockData: Array<{ lang: string; code: string }> = []
   let result = text.replace(
-    /```[ \t]*(\w*)[ \t]*(?:\r\n|\r|\n)([\s\S]*?)(?:\r\n|\r|\n)?```/g,
+    /```[ \t]*([\w-]*)[ \t]*(?:\r\n|\r|\n)([\s\S]*?)(?:\r\n|\r|\n)?```/g,
     (_, lang, code) => {
       const index = codeBlockData.length
       codeBlockData.push({ lang: lang || 'text', code: code.trim() })

test/unit/server/utils/docs/text.spec.ts

@@ -293,6 +293,17 @@ describe('renderMarkdown', () => {
     expect(result).not.toContain('```')
   })
 
+  it('should handle fenced code blocks with hyphenated language (e.g. glimmer-ts)', async () => {
+    // Regression test for #2437: regex used \w which dropped the `-ts` suffix,
+    // leaving it at the start of the code body and breaking highlighting.
+    const input = '```glimmer-ts\nconst x = 1;\n```'
+    const result = await renderMarkdown(input, emptyLookup)
+    // Code must not leak the truncated language suffix into the body
+    expect(result).not.toContain('-ts')
+    expect(result).toContain('const')
+    expect(result).not.toContain('```')
+  })
+
   it('should escape HTML inside fenced code blocks', async () => {
     const input = '```ts\nconst arr: Array<string> = [];\n```'
     const result = await renderMarkdown(input, emptyLookup)