// A small Markdown renderer for release notes and the README: headings, paragraphs, // lists (nested by indentation), fenced code, quotes, rules, and inline code, bold, // italic and links. Everything is escaped first, so its output never carries raw HTML. // Shared by build.mjs (Node) and main.js (browser). const REPO_BLOB = "https://github.com/ludovic111/horizon/blob/main/"; export function escape(text) { return text.replace(/[&<>"']/g, (c) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[c]); } function href(url, site) { url = url.trim(); if (/^(https?:|mailto:)/i.test(url)) return url; // The docs pages (`site`) link each other and their own headings; the README's anchors have no target here. if (site && (/^\/(?!\/)/.test(url) || url.startsWith("#"))) return url; if (url.startsWith("#")) return null; if (/^[a-z]+:/i.test(url)) return null; // javascript: and the like return REPO_BLOB + url.replace(/^\.?\//, ""); } export function inline(text, site = false) { const codes = []; let out = text.replace(/`([^`]+)`/g, (_, code) => { codes.push(code); return `\u0000${codes.length - 1}\u0000`; }); const links = []; out = out.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_, label, url) => { links.push([label, url]); return `\u0001${links.length - 1}\u0001`; }); out = escape(out) .replace(/\*\*([^*]+)\*\*/g, "$1") .replace(/(^|[^\w*])\*([^*\s][^*]*)\*/g, "$1$2") .replace(/(^|[^\w])_([^_\s][^_]*)_(?!\w)/g, "$1$2") .replace(/<(https?:\/\/[^\s&]+)>/g, (_, u) => `${u}`); out = out.replace(/\u0001(\d+)\u0001/g, (_, i) => { const [label, url] = links[i]; const target = href(url, site); const body = inline(label, site); return target ? `${body}` : body; }); return out.replace(/\u0000(\d+)\u0000/g, (_, i) => `${escape(codes[i])}`); } const indentOf = (line) => line.match(/^ */)[0].length; const ITEM = /^(\s*)([-*+]|\d+[.)])\s+(.*)$/; function list(lines, start, site) { // Collects the items at this list's indentation; deeper lines belong to the item above. const base = indentOf(lines[start]); const ordered = /\d/.test(lines[start].match(ITEM)[2]); const items = []; let i = start; while (i < lines.length) { const line = lines[i]; if (!line.trim()) { const next = lines.slice(i + 1).find((l) => l.trim()); if (next && ITEM.test(next) && indentOf(next) >= base) { i++; continue; } break; } const m = line.match(ITEM); if (m && indentOf(line) === base) { items.push({ text: [m[3]], children: [] }); } else if (m && indentOf(line) > base) { const [html, end] = list(lines, i, site); items[items.length - 1].children.push(html); i = end; continue; } else if (indentOf(line) > base && items.length) { items[items.length - 1].text.push(line.trim()); } else { break; } i++; } const tag = ordered ? "ol" : "ul"; const body = items.map((it) => `
  • ${inline(it.text.join(" "), site)}${it.children.join("")}
  • `).join(""); return [`<${tag}>${body}`, i]; } const slug = (text) => text .toLowerCase() .replace(/`/g, "") .replace(/[^a-z0-9]+/g, "-") .replace(/^-|-$/g, ""); /** * Renders Markdown; `shift` moves headings down (a `#` becomes `h{1 + shift}`). * `site` is for the docs pages: links to the site's own pages and anchors stay as they are, `##` and `###` * headings get an id (and are pushed onto `headings`, for a table of contents), and a line holding only * `![caption](/media/…)` becomes a figure. */ export function markdown(source, { shift = 0, site = false, headings = null } = {}) { const lines = source.replace(/\r\n?/g, "\n").split("\n"); const out = []; let i = 0; while (i < lines.length) { const line = lines[i]; if (!line.trim() || /^\s*<\/?[a-z][^>]*>\s*$/i.test(line)) { i++; // blank lines and lone HTML tags (the README's layout tables) are skipped continue; } let m; if ((m = line.match(/^(#{1,6})\s+(.*?)\s*#*$/))) { const level = Math.min(6, m[1].length + shift); let id = ""; if (site && (m[1].length === 2 || m[1].length === 3)) { const base = slug(m[2]); id = base; for (let n = 2; headings && headings.some((h) => h.id === id); n++) id = `${base}-${n}`; headings?.push({ level: m[1].length, text: m[2].replace(/`/g, ""), id }); } out.push(`${inline(m[2], site)}`); i++; } else if (site && (m = line.match(/^!\[([^\]]*)\]\((\/media\/[\w./-]+)\)\s*$/))) { out.push(`
    ${escape(m[1])}
    ${inline(m[1], true)}
    `); i++; } else if ((m = line.match(/^\s*(```|~~~)/))) { const fence = m[1]; const code = []; i++; while (i < lines.length && !lines[i].trim().startsWith(fence)) code.push(lines[i++]); i++; out.push(`
    ${escape(code.join("\n"))}
    `); } else if (/^\s*([-*_])(\s*\1){2,}\s*$/.test(line)) { out.push("
    "); i++; } else if (ITEM.test(line)) { const [html, end] = list(lines, i, site); out.push(html); i = end; } else if (line.startsWith(">")) { const quote = []; while (i < lines.length && lines[i].startsWith(">")) quote.push(lines[i++].replace(/^>\s?/, "")); out.push(`
    ${markdown(quote.join("\n"), { shift, site })}
    `); } else { const para = []; while ( i < lines.length && lines[i].trim() && !/^(#{1,6}\s|>|\s*```|\s*~~~)/.test(lines[i]) && !ITEM.test(lines[i]) ) { para.push(lines[i++].trim()); } out.push(`

    ${inline(para.join(" "), site)}

    `); } } return out.join("\n"); } /** The body of the section titled `title` (any heading level), up to the next heading at its level or above. */ export function section(source, title) { const lines = source.replace(/\r\n?/g, "\n").split("\n"); const level = (l) => (l.match(/^(#{1,6})\s/) || [, ""])[1].length; const start = lines.findIndex((l) => level(l) > 0 && l.replace(/^#+/, "").trim() === title); if (start < 0) return null; const depth = level(lines[start]); const end = lines.findIndex((l, i) => i > start && level(l) > 0 && level(l) <= depth); return lines .slice(start + 1, end < 0 ? undefined : end) .join("\n") .trim(); }