"""Regression coverage for the browser markdown renderer.""" import json import shutil import subprocess import textwrap from pathlib import Path import pytest _REPO = Path(__file__).resolve().parent.parent _HAS_NODE = shutil.which("node") is not None @pytest.fixture(scope="module") def node_available(): if not _HAS_NODE: pytest.skip("node binary not on PATH") def _run_markdown_case(markdown: str, render_expr: str = "mod.mdToHtml(input)", with_katex: bool = False): script = textwrap.dedent( r""" import fs from 'node:fs'; globalThis.window = { location: { origin: 'http://localhost' }, katex: null }; if (__WITH_KATEX__) { // Minimal stand-in for the CDN katex global: wraps the source so tests // can assert what was (or wasn't) handed to KaTeX. const katexStub = { renderToString(src, opts) { const display = !!(opts && opts.displayMode); return `${src}`; }, }; globalThis.window.katex = katexStub; globalThis.katex = katexStub; } globalThis.document = { readyState: 'loading', addEventListener() {}, createElement(tag) { if (tag !== 'template') throw new Error(`unsupported element: ${tag}`); return { _html: '', content: { querySelectorAll() { return []; } }, set innerHTML(value) { this._html = value; }, get innerHTML() { return this._html; }, }; }, }; globalThis.MutationObserver = class { observe() {} }; let source = fs.readFileSync('./static/js/markdown.js', 'utf8'); source = source.replace( /import uiModule from ['"]\.\/ui\.js['"];/, '' ); source = source.replace( /import \{ splitTableRow \} from ['"]\.\/markdown\/tableRow\.js['"];/, `function splitTableRow(row) { return (row || '').replace(/^\\s*\\|/, '').replace(/\\|\\s*$/, '').split('|').map(c => c.trim()); }` ); // markdown.js imports the emoji-shortcode helpers relatively (issue #345), // which a data: URL module can't resolve. Inline the REAL helpers (minus // their export keywords) so the renderer's shortcode pass behaves exactly // as it does in the browser. const emojiSource = fs.readFileSync('./static/js/emojiShortcodes.js', 'utf8') .replace(/^export default .*$/m, '') .replace(/export const /g, 'const ') .replace(/export function /g, 'function '); source = source.replace( /import \{ replaceEmojiShortcodes, hasEmojiShortcode \} from ['"]\.\/emojiShortcodes\.js['"];/, () => emojiSource ); source = source.replace( /var escapeHtml = uiModule\.esc;/, `var escapeHtml = (value) => String(value ?? '') .replace(/&/g, '&') .replace(//g, '>') .replace(/"/g, '"') .replace(/'/g, ''');` ); const moduleUrl = 'data:text/javascript;base64,' + Buffer.from(source).toString('base64'); const mod = await import(moduleUrl); const input = JSON.parse(process.argv[1]); console.log(JSON.stringify({ html: __RENDER_EXPR__ })); """ ).replace("__RENDER_EXPR__", render_expr).replace( "__WITH_KATEX__", "true" if with_katex else "false" ) result = subprocess.run( ["node", "--input-type=module", "-e", script, json.dumps(markdown)], cwd=_REPO, capture_output=True, timeout=15, text=True, ) if result.returncode != 0: raise AssertionError(f"node failed:\nSTDERR:\n{result.stderr}\nSTDOUT:\n{result.stdout}") return json.loads(result.stdout.splitlines()[-1])["html"] def test_ordered_lists_render_as_one_unwrapped_ol(node_available): html = _run_markdown_case( "Before\n\n" "1. **Check against the home page** — that's the visual reference for how things should feel.\n" "2. **Open DevTools** and inspect the element — check fonts, colors, and spacing against this guide.\n" "3. **Flag it** — note the page, the section, what's wrong, and what CSS rule you suspect.\n" "4. **Small fixes** — if you know the fix (e.g. wrong CSS variable, wrong font), go ahead and change it in the CSS Module file.\n" "5. **Big changes** — Talk it through before making wide changes across many pages.\n\n" "After" ) assert html.count("
    ") == 1 assert html.count("
") == 1 assert html.count("
  • ") == 5 assert "