simstudioai · waleedlatif1 · Jul 6, 2026 · Jul 6, 2026 · Jul 6, 2026 · Jul 6, 2026
diff --git a/...rkspaceId]/files/components/file-viewer/rich-markdown-editor/raw-markdown-snippet.test.ts b/...rkspaceId]/files/components/file-viewer/rich-markdown-editor/raw-markdown-snippet.test.ts
@@ -6,12 +6,17 @@
  * and reach a fixpoint on a second pass (see `serializeMarkdownDocument` in `./markdown-parse.ts`).
  */
 import { describe, expect, it } from 'vitest'
-import { serializeMarkdownDocument } from './markdown-parse'
+import { parseMarkdownToDoc, serializeMarkdownDocument } from './markdown-parse'
 
 function roundTrip(input: string): string {
   return serializeMarkdownDocument(input).trim()
 }
 
+/** Top-level node type names of the parsed doc, for structural (not just string) assertions. */
+function topLevelTypes(input: string): (string | undefined)[] {
+  return (parseMarkdownToDoc(input).content ?? []).map((n) => n.type)
+}
+
 describe('raw markdown snippet nodes', () => {
   it('preserves a standalone HTML comment', () => {
     const input = '<!-- a note -->\n\ntext'
@@ -96,3 +101,158 @@ describe('raw markdown snippet nodes', () => {
     expect(roundTrip(input)).toBe(input)
   })
 })
+
+describe('raw HTML block: does not fragment across blank lines', () => {
+  it('a <details><summary> block with a blank-line-separated body is ONE node, not three', () => {
+    const input =
+      '<details>\n<summary>Click to expand</summary>\n\nThis is inside a details/summary block.\n\n</details>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+    expect(roundTrip(roundTrip(input))).toBe(roundTrip(input))
+  })
+
+  it('a <div> with multiple blank-line-separated paragraphs inside is ONE node', () => {
+    const input = '<div>\n\nfirst paragraph\n\nsecond paragraph\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('nested same-tag block HTML balances depth across blank lines', () => {
+    const input = '<div>\nouter\n\n<div>\n\ninner\n\n</div>\n\nstill outer\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+    expect(roundTrip(roundTrip(input))).toBe(roundTrip(input))
+  })
+
+  it('a paragraph starting with a non-block-list inline tag is NOT captured as a raw block', () => {
+    // `em`/`a` aren't in the CommonMark block-HTML tag whitelist — they can legitimately start an
+    // ordinary paragraph, and must keep parsing as real marks, not freeze as raw source.
+    expect(topLevelTypes('<em>hi</em> there, this is a normal paragraph')).toEqual(['paragraph'])
+    expect(roundTrip('<em>hi</em> there')).toBe('*hi* there')
+  })
+
+  it('a stray inline-only tag alone on its own line is left to the stock (non-whitelisted) path', () => {
+    // `<span>` isn't in the block whitelist, so the new block tokenizer must not claim it — it falls
+    // through to marked's own (stricter) block-HTML detection, unaffected by this change.
+    const input = '<span>\n\nnot a block-html tag\n\n</span>'
+    expect(() => roundTrip(input)).not.toThrow()
+  })
+
+  it('an unterminated block tag falls back gracefully (no crash, no infinite loop)', () => {
+    const input = '<details>\n<summary>never closed</summary>\n\nbody'
+    expect(() => roundTrip(input)).not.toThrow()
+  })
+
+  it('a block comment spanning blank lines still round-trips via the new shared tokenizer path', () => {
+    const input = '<!--\n\nmulti-line comment\n\n-->\n\ntext after'
+    expect(topLevelTypes(input)[0]).toBe('rawHtmlBlock')
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('a table and code block adjacent to a fragmenting-prone details block still coexist correctly', () => {
+    const input =
+      '<details>\n<summary>s</summary>\n\nbody\n\n</details>\n\n| a   | b   |\n| --- | --- |\n| 1   | 2   |\n\n```js\nconst x = 1\n```'
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('preserves an indented (up to 3 spaces) block-HTML opening line', () => {
+    // `roundTrip`'s `.trim()` would strip the very leading indent this test verifies, so check the
+    // parsed node's own text (and the untrimmed serialization) instead of the trimmed helper.
+    for (const indent of [' ', '  ', '   ']) {
+      const input = `${indent}<details>\n<summary>x</summary>\n\nbody\n\n</details>`
+      const doc = parseMarkdownToDoc(input)
+      expect(doc.content?.map((n) => n.type)).toEqual(['rawHtmlBlock'])
+      expect(doc.content?.[0].content?.[0].text).toBe(input)
+      expect(serializeMarkdownDocument(input)).toBe(`${input}\n`)
+    }
+  })
+
+  it('preserves a quoted attribute value containing a literal >', () => {
+    const input = '<div data-example="a > b">\n\ncontent\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+    expect(roundTrip(roundTrip(input))).toBe(roundTrip(input))
+  })
+
+  it('a quoted attribute containing a nested same-tag mention does not confuse the balance scan', () => {
+    // Without attribute-aware matching, `<div>` inside the quoted value below would be miscounted as
+    // a real nested open tag, throwing off the depth count entirely.
+    const input = '<div title="a <div> b">\n\ncontent\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('does not mistake a tag name mentioned inside an inline code span for a real closing tag', () => {
+    const input = '<details>\n<summary>x</summary>\n\nSee `</details>` in the docs.\n\n</details>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('does not mistake a tag name mentioned inside a fenced code block for a real closing tag', () => {
+    const input = '<div>\n\nExample:\n\n```html\n<div>example</div>\n```\n\nmore body\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('does not mistake a tag name mentioned inside an HTML comment for a real closing tag', () => {
+    const input = '<div>\n\n<!-- see </div> below for the closing tag -->\n\nmore body\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('a bare (unescaped, un-fenced) tag-name mention never crashes and always converges to a stable save', () => {
+    // Known, inherent limitation of regex-based (non-DOM) tag matching, shared by any HTML-block
+    // scanner (and by real HTML parsers given the same ambiguous input) — a bare mention outside
+    // code can still be misread as the real closer. The bar this file holds itself to is: never
+    // crash, never lose text, and always settle to a fixpoint after one save (isRoundTripSafe's own
+    // documented tolerance for single-pass normalization) — not a perfect, DOM-aware parse.
+    const input =
+      '<details>\n<summary>x</summary>\n\nSee the literal text </details> in docs.\n\nmore body\n\n</details>'
+    expect(() => roundTrip(input)).not.toThrow()
+    const once = roundTrip(input)
+    const twice = roundTrip(once)
+    expect(once).toBe(twice)
+    // No word from the original is dropped, even though the structure/whitespace may be reflowed.
+    for (const word of ['See', 'the', 'literal', 'text', 'in', 'docs', 'more', 'body']) {
+      expect(once).toContain(word)
+    }
+  })
+
+  it('does not mistake a tag name mentioned inside a blockquoted fenced code block for a real closing tag', () => {
+    const input =
+      '<div>\n\n> Example:\n>\n> ```html\n> <div>example</div>\n> ```\n\nmore body\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('does not mistake a tag name mentioned inside an indented (no blockquote) fenced code block for a real closing tag', () => {
+    const input =
+      '<div>\n\nExample:\n\n   ```html\n   <div>example</div>\n   ```\n\nmore body\n\n</div>'
+    expect(topLevelTypes(input)).toEqual(['rawHtmlBlock'])
+    expect(roundTrip(input)).toBe(input)
+  })
+
+  it('treats a void block tag (no closing tag exists) as complete right after the open tag', () => {
+    // `link`/`meta`/`base`/`hr` are in the CommonMark block-HTML whitelist but are void elements —
+    // scanning for a `</meta>` that will never legitimately appear would risk grabbing unrelated
+    // later content (or a stray same-name mention) into the block.
+    for (const input of [
+      '<link rel="stylesheet" href="x.css">\n\nafter',
+      '<meta charset="utf-8">\n\nafter',
+      '<hr>\n\nafter',
+    ]) {
+      const doc = parseMarkdownToDoc(input)
+      expect(doc.content?.[0].type).toBe('rawHtmlBlock')
+      expect(roundTrip(input)).toContain('after')
+    }
+  })
+
+  it('a void block tag does not swallow a later, unrelated mention of its own tag name', () => {
+    const input = '<meta charset="utf-8">\n\nSee the `<meta>` tag in docs.\n\nmore body'
+    const doc = parseMarkdownToDoc(input)
+    // The <meta> is its own complete block; the later mention (in code) stays in a separate paragraph.
+    expect(doc.content?.[0].type).toBe('rawHtmlBlock')
+    expect(doc.content?.[0].content?.[0].text).toBe('<meta charset="utf-8">')
+    expect(roundTrip(input)).toContain('more body')
+  })
+})