// A small Markdown renderer for release notes, the README and the docs: headings, paragraphs,
// lists (nested by indentation), fenced code, quotes, rules, tables, 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);
// The label's code spans are already placeholders: put them back for its own pass.
const body = inline(label.replace(/\u0000(\d+)\u0000/g, (_, c) => `\`${codes[c]}\``), site);
return target ? `${body}` : body;
});
return out.replace(/\u0000(\d+)\u0000/g, (_, i) => `${escape(codes[i])}`);
}
// A table: a row of cells, a rule row (`| --- | :-: |`), then body rows, until a line that isn't a row.
const ROW = /^\s*\|.*\|\s*$/;
const RULE = /^\s*\|(\s*:?-+:?\s*\|)+\s*$/;
/** A row's cells: split on `|` outside code spans; `\|` is a literal bar. */
function cells(row) {
const s = row.trim().slice(1, -1);
const out = [""];
let code = false;
for (let i = 0; i < s.length; i++) {
if (s[i] === "\\" && s[i + 1] === "|") out[out.length - 1] += s[++i];
else if (s[i] === "|" && !code) out.push("");
else {
if (s[i] === "`") code = !code;
out[out.length - 1] += s[i];
}
}
return out.map((c) => c.trim());
}
function table(lines, start, site) {
const row = (line, tag) => `
${escape(code.join("\n"))}`);
} else if (/^\s*([-*_])(\s*\1){2,}\s*$/.test(line)) {
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(); }