// 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) => `
${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(); }