render-math.mjs

Functions

Imports

It imports no other module of this repo. Imported by render.mjs.

Source

1// Imports nothing: a route that only asks whether a stored page has math must not pull a 280 kB renderer into its chunk.
2
3/**
4 * Shared by the math validation and rehype-katex: if they differed, an expression could pass validation and still reach rehype-katex's
5 * error path. strict: "error" because KaTeX otherwise only warns, and the symbol ships as a box. throwOnError is useless: rehype-katex
6 * 7.0.1 catches the throw and re-renders a red error box with the build exiting 0, which is why the validation exists. `trust` is left
7 * at its default (off), so \href{javascript:...} and \url do not become links; render.test.mjs holds that.
8 */
9export const KATEX_OPTIONS = /** @type {const} */ ({
10  output: "htmlAndMathml",
11  strict: "error",
12});
13
14/**
15 * Anchored on the attribute so prose or code blocks about KaTeX do not match.
16 *
17 * @param {string | null | undefined} html
18 */
19export function htmlHasMath(html) {
20  return typeof html === "string" && html.includes('class="katex"');
21}