@prudentbird/voxx-core 1.0.0

package/dist/llms.mjs

@@ -0,0 +1,78 @@
+import { absoluteUrl } from "./util.mjs";
+//#region src/llms.ts
+const SECTION_HEADING = {
+	blog: "Posts",
+	docs: "Pages",
+	changelog: "Releases"
+};
+const oneLine = (s) => s.replace(/\s*\n\s*/g, " ").trim();
+const escLinkText = (s) => oneLine(s).replace(/([[\]])/g, "\\$1");
+const escHeading = (s) => oneLine(s);
+/**
+* Returns the default section heading for a content type.
+*
+* @param type - Content type from the Voxx config.
+* @returns Human-readable heading, e.g. `"Posts"`, `"Pages"`, `"Releases"`.
+*/
+function sectionHeading(type) {
+	return SECTION_HEADING[type];
+}
+/**
+* Renders a `llms.txt` file from one or more labeled post sections.
+*
+* @param sections - Ordered list of headings with their associated posts.
+* @param config - Resolved Voxx config (used for site title and description).
+* @returns `llms.txt` Markdown string.
+*/
+function renderLlmsTxtSections(sections, config) {
+	const lines = [`# ${config.site.title}`, ""];
+	if (config.site.description) lines.push(`> ${config.site.description}`, "");
+	for (const section of sections) {
+		lines.push(`## ${section.heading}`, "");
+		for (const p of section.posts) {
+			const link = absoluteUrl(config.site.url, p.url);
+			const summary = p.description ?? p.excerpt;
+			const title = escLinkText(p.title);
+			const safeSummary = summary ? oneLine(summary) : "";
+			lines.push(`- [${title}](${link})${safeSummary ? `: ${safeSummary}` : ""}`);
+		}
+		lines.push("");
+	}
+	return lines.join("\n");
+}
+/**
+* Renders a `llms.txt` index linking all posts with one-line summaries.
+*
+* @param posts - All posts to include.
+* @param config - Resolved Voxx config.
+* @returns `llms.txt` Markdown string.
+*/
+function renderLlmsTxt(posts, config) {
+	return renderLlmsTxtSections([{
+		heading: SECTION_HEADING[config.content.type],
+		posts
+	}], config);
+}
+/**
+* Renders an `llms-full.txt` file containing the complete Markdown content
+* of every post, separated by `---` dividers.
+*
+* @param posts - All posts to include.
+* @param config - Resolved Voxx config.
+* @returns Full-content `llms-full.txt` string.
+*/
+function renderLlmsFull(posts, config) {
+	const out = [`# ${config.site.title}`, ""];
+	if (config.site.description) out.push(config.site.description, "");
+	for (const p of posts) {
+		const link = absoluteUrl(config.site.url, p.url);
+		out.push("---", "", `# ${escHeading(p.title)}`, "", `Source: ${link}`, `Date: ${p.date}`);
+		if (p.tags.length) out.push(`Tags: ${p.tags.join(", ")}`);
+		out.push("", p.content.trim(), "");
+	}
+	return out.join("\n");
+}
+//#endregion
+export { renderLlmsFull, renderLlmsTxt, renderLlmsTxtSections, sectionHeading };
+
+//# sourceMappingURL=llms.mjs.map

package/dist/llms.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.mjs","names":[],"sources":["../src/llms.ts"],"sourcesContent":["import { absoluteUrl } from \"./util\";\nimport type { ContentType, Post, VoxxConfig } from \"./types\";\n\nconst SECTION_HEADING: Record<ContentType, string> = {\n  blog: \"Posts\",\n  docs: \"Pages\",\n  changelog: \"Releases\",\n};\n\nconst oneLine = (s: string) => s.replace(/\\s*\\n\\s*/g, \" \").trim();\nconst escLinkText = (s: string) => oneLine(s).replace(/([[\\]])/g, \"\\\\$1\");\nconst escHeading = (s: string) => oneLine(s);\n\n/** A titled group of posts for use in `renderLlmsTxtSections`. */\nexport interface LlmsSection {\n  heading: string;\n  posts: Post[];\n}\n\n/**\n * Returns the default section heading for a content type.\n *\n * @param type - Content type from the Voxx config.\n * @returns Human-readable heading, e.g. `\"Posts\"`, `\"Pages\"`, `\"Releases\"`.\n */\nexport function sectionHeading(type: ContentType): string {\n  return SECTION_HEADING[type];\n}\n\n/**\n * Renders a `llms.txt` file from one or more labeled post sections.\n *\n * @param sections - Ordered list of headings with their associated posts.\n * @param config - Resolved Voxx config (used for site title and description).\n * @returns `llms.txt` Markdown string.\n */\nexport function renderLlmsTxtSections(\n  sections: LlmsSection[],\n  config: VoxxConfig,\n): string {\n  const lines: string[] = [`# ${config.site.title}`, \"\"];\n  if (config.site.description) lines.push(`> ${config.site.description}`, \"\");\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`, \"\");\n    for (const p of section.posts) {\n      const link = absoluteUrl(config.site.url, p.url);\n      const summary = p.description ?? p.excerpt;\n      const title = escLinkText(p.title);\n      const safeSummary = summary ? oneLine(summary) : \"\";\n      lines.push(\n        `- [${title}](${link})${safeSummary ? `: ${safeSummary}` : \"\"}`,\n      );\n    }\n    lines.push(\"\");\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Renders a `llms.txt` index linking all posts with one-line summaries.\n *\n * @param posts - All posts to include.\n * @param config - Resolved Voxx config.\n * @returns `llms.txt` Markdown string.\n */\nexport function renderLlmsTxt(posts: Post[], config: VoxxConfig): string {\n  return renderLlmsTxtSections(\n    [{ heading: SECTION_HEADING[config.content.type], posts }],\n    config,\n  );\n}\n\n/**\n * Renders an `llms-full.txt` file containing the complete Markdown content\n * of every post, separated by `---` dividers.\n *\n * @param posts - All posts to include.\n * @param config - Resolved Voxx config.\n * @returns Full-content `llms-full.txt` string.\n */\nexport function renderLlmsFull(posts: Post[], config: VoxxConfig): string {\n  const out: string[] = [`# ${config.site.title}`, \"\"];\n  if (config.site.description) out.push(config.site.description, \"\");\n  for (const p of posts) {\n    const link = absoluteUrl(config.site.url, p.url);\n    out.push(\n      \"---\",\n      \"\",\n      `# ${escHeading(p.title)}`,\n      \"\",\n      `Source: ${link}`,\n      `Date: ${p.date}`,\n    );\n    if (p.tags.length) out.push(`Tags: ${p.tags.join(\", \")}`);\n    out.push(\"\", p.content.trim(), \"\");\n  }\n  return out.join(\"\\n\");\n}\n"],"mappings":";;AAGA,MAAM,kBAA+C;CACnD,MAAM;CACN,MAAM;CACN,WAAW;AACb;AAEA,MAAM,WAAW,MAAc,EAAE,QAAQ,aAAa,GAAG,CAAC,CAAC,KAAK;AAChE,MAAM,eAAe,MAAc,QAAQ,CAAC,CAAC,CAAC,QAAQ,YAAY,MAAM;AACxE,MAAM,cAAc,MAAc,QAAQ,CAAC;;;;;;;AAc3C,SAAgB,eAAe,MAA2B;CACxD,OAAO,gBAAgB;AACzB;;;;;;;;AASA,SAAgB,sBACd,UACA,QACQ;CACR,MAAM,QAAkB,CAAC,KAAK,OAAO,KAAK,SAAS,EAAE;CACrD,IAAI,OAAO,KAAK,aAAa,MAAM,KAAK,KAAK,OAAO,KAAK,eAAe,EAAE;CAC1E,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,KAAK,MAAM,QAAQ,WAAW,EAAE;EACtC,KAAK,MAAM,KAAK,QAAQ,OAAO;GAC7B,MAAM,OAAO,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;GAC/C,MAAM,UAAU,EAAE,eAAe,EAAE;GACnC,MAAM,QAAQ,YAAY,EAAE,KAAK;GACjC,MAAM,cAAc,UAAU,QAAQ,OAAO,IAAI;GACjD,MAAM,KACJ,MAAM,MAAM,IAAI,KAAK,GAAG,cAAc,KAAK,gBAAgB,IAC7D;EACF;EACA,MAAM,KAAK,EAAE;CACf;CACA,OAAO,MAAM,KAAK,IAAI;AACxB;;;;;;;;AASA,SAAgB,cAAc,OAAe,QAA4B;CACvE,OAAO,sBACL,CAAC;EAAE,SAAS,gBAAgB,OAAO,QAAQ;EAAO;CAAM,CAAC,GACzD,MACF;AACF;;;;;;;;;AAUA,SAAgB,eAAe,OAAe,QAA4B;CACxE,MAAM,MAAgB,CAAC,KAAK,OAAO,KAAK,SAAS,EAAE;CACnD,IAAI,OAAO,KAAK,aAAa,IAAI,KAAK,OAAO,KAAK,aAAa,EAAE;CACjE,KAAK,MAAM,KAAK,OAAO;EACrB,MAAM,OAAO,YAAY,OAAO,KAAK,KAAK,EAAE,GAAG;EAC/C,IAAI,KACF,OACA,IACA,KAAK,WAAW,EAAE,KAAK,KACvB,IACA,WAAW,QACX,SAAS,EAAE,MACb;EACA,IAAI,EAAE,KAAK,QAAQ,IAAI,KAAK,SAAS,EAAE,KAAK,KAAK,IAAI,GAAG;EACxD,IAAI,KAAK,IAAI,EAAE,QAAQ,KAAK,GAAG,EAAE;CACnC;CACA,OAAO,IAAI,KAAK,IAAI;AACtB"}

package/dist/nav.cjs

@@ -0,0 +1,50 @@
+const require_util = require("./util.cjs");
+//#region src/nav.ts
+/**
+* Builds a sidebar navigation tree from an ordered list of docs posts.
+*
+* Directory segments become category nodes; index files promote their
+* title and URL onto the parent node.
+*
+* @param posts - Posts sorted by `getPostsEffect` (order-prefix aware).
+* @returns Top-level `NavNode` array suitable for a sidebar component.
+*/
+function buildNavTree(posts) {
+	const root = {
+		title: "",
+		children: []
+	};
+	const nodes = /* @__PURE__ */ new Map();
+	const nodeFor = (path) => {
+		if (path.length === 0) return root;
+		const key = path.join("/");
+		let node = nodes.get(key);
+		if (!node) {
+			node = {
+				title: require_util.humanize(path[path.length - 1]),
+				children: []
+			};
+			nodes.set(key, node);
+			nodeFor(path.slice(0, -1)).children.push(node);
+		}
+		return node;
+	};
+	for (const post of posts) {
+		if (post.path.length === 0) {
+			root.children.push({
+				title: post.title,
+				url: post.url,
+				children: []
+			});
+			continue;
+		}
+		const node = nodeFor(post.path);
+		node.title = post.title;
+		node.url = post.url;
+	}
+	return root.children;
+}
+//#endregion
+exports.buildNavTree = buildNavTree;
+
+//# sourceMappingURL=nav.cjs.map

package/dist/nav.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.cjs","names":["humanize"],"sources":["../src/nav.ts"],"sourcesContent":["import type { NavNode, Post } from \"./types\";\nimport { humanize } from \"./util\";\n\n/**\n * Builds a sidebar navigation tree from an ordered list of docs posts.\n *\n * Directory segments become category nodes; index files promote their\n * title and URL onto the parent node.\n *\n * @param posts - Posts sorted by `getPostsEffect` (order-prefix aware).\n * @returns Top-level `NavNode` array suitable for a sidebar component.\n */\nexport function buildNavTree(posts: Post[]): NavNode[] {\n  const root: NavNode = { title: \"\", children: [] };\n  const nodes = new Map<string, NavNode>();\n\n  const nodeFor = (path: string[]): NavNode => {\n    if (path.length === 0) return root;\n    const key = path.join(\"/\");\n    let node = nodes.get(key);\n    if (!node) {\n      node = { title: humanize(path[path.length - 1]!), children: [] };\n      nodes.set(key, node);\n      nodeFor(path.slice(0, -1)).children.push(node);\n    }\n    return node;\n  };\n\n  for (const post of posts) {\n    if (post.path.length === 0) {\n      root.children.push({ title: post.title, url: post.url, children: [] });\n      continue;\n    }\n    const node = nodeFor(post.path);\n    node.title = post.title;\n    node.url = post.url;\n  }\n\n  return root.children;\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,aAAa,OAA0B;CACrD,MAAM,OAAgB;EAAE,OAAO;EAAI,UAAU,CAAC;CAAE;CAChD,MAAM,wBAAQ,IAAI,IAAqB;CAEvC,MAAM,WAAW,SAA4B;EAC3C,IAAI,KAAK,WAAW,GAAG,OAAO;EAC9B,MAAM,MAAM,KAAK,KAAK,GAAG;EACzB,IAAI,OAAO,MAAM,IAAI,GAAG;EACxB,IAAI,CAAC,MAAM;GACT,OAAO;IAAE,OAAOA,aAAAA,SAAS,KAAK,KAAK,SAAS,EAAG;IAAG,UAAU,CAAC;GAAE;GAC/D,MAAM,IAAI,KAAK,IAAI;GACnB,QAAQ,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI;EAC/C;EACA,OAAO;CACT;CAEA,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,KAAK,WAAW,GAAG;GAC1B,KAAK,SAAS,KAAK;IAAE,OAAO,KAAK;IAAO,KAAK,KAAK;IAAK,UAAU,CAAC;GAAE,CAAC;GACrE;EACF;EACA,MAAM,OAAO,QAAQ,KAAK,IAAI;EAC9B,KAAK,QAAQ,KAAK;EAClB,KAAK,MAAM,KAAK;CAClB;CAEA,OAAO,KAAK;AACd"}

package/dist/nav.d.cts

@@ -0,0 +1,16 @@
+import { NavNode, Post } from "./types.cjs";
+
+//#region src/nav.d.ts
+/**
+ * Builds a sidebar navigation tree from an ordered list of docs posts.
+ *
+ * Directory segments become category nodes; index files promote their
+ * title and URL onto the parent node.
+ *
+ * @param posts - Posts sorted by `getPostsEffect` (order-prefix aware).
+ * @returns Top-level `NavNode` array suitable for a sidebar component.
+ */
+declare function buildNavTree(posts: Post[]): NavNode[];
+//#endregion
+export { buildNavTree };
+//# sourceMappingURL=nav.d.cts.map

package/dist/nav.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.cts","names":[],"sources":["../src/nav.ts"],"mappings":";;;;;AAYA;;;;;;;iBAAgB,YAAA,CAAa,KAAA,EAAO,IAAA,KAAS,OAAO"}

package/dist/nav.d.mts

@@ -0,0 +1,16 @@
+import { NavNode, Post } from "./types.mjs";
+
+//#region src/nav.d.ts
+/**
+ * Builds a sidebar navigation tree from an ordered list of docs posts.
+ *
+ * Directory segments become category nodes; index files promote their
+ * title and URL onto the parent node.
+ *
+ * @param posts - Posts sorted by `getPostsEffect` (order-prefix aware).
+ * @returns Top-level `NavNode` array suitable for a sidebar component.
+ */
+declare function buildNavTree(posts: Post[]): NavNode[];
+//#endregion
+export { buildNavTree };
+//# sourceMappingURL=nav.d.mts.map

package/dist/nav.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.mts","names":[],"sources":["../src/nav.ts"],"mappings":";;;;;AAYA;;;;;;;iBAAgB,YAAA,CAAa,KAAA,EAAO,IAAA,KAAS,OAAO"}

package/dist/nav.mjs

@@ -0,0 +1,50 @@
+import { humanize } from "./util.mjs";
+//#region src/nav.ts
+/**
+* Builds a sidebar navigation tree from an ordered list of docs posts.
+*
+* Directory segments become category nodes; index files promote their
+* title and URL onto the parent node.
+*
+* @param posts - Posts sorted by `getPostsEffect` (order-prefix aware).
+* @returns Top-level `NavNode` array suitable for a sidebar component.
+*/
+function buildNavTree(posts) {
+	const root = {
+		title: "",
+		children: []
+	};
+	const nodes = /* @__PURE__ */ new Map();
+	const nodeFor = (path) => {
+		if (path.length === 0) return root;
+		const key = path.join("/");
+		let node = nodes.get(key);
+		if (!node) {
+			node = {
+				title: humanize(path[path.length - 1]),
+				children: []
+			};
+			nodes.set(key, node);
+			nodeFor(path.slice(0, -1)).children.push(node);
+		}
+		return node;
+	};
+	for (const post of posts) {
+		if (post.path.length === 0) {
+			root.children.push({
+				title: post.title,
+				url: post.url,
+				children: []
+			});
+			continue;
+		}
+		const node = nodeFor(post.path);
+		node.title = post.title;
+		node.url = post.url;
+	}
+	return root.children;
+}
+//#endregion
+export { buildNavTree };
+
+//# sourceMappingURL=nav.mjs.map

package/dist/nav.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.mjs","names":[],"sources":["../src/nav.ts"],"sourcesContent":["import type { NavNode, Post } from \"./types\";\nimport { humanize } from \"./util\";\n\n/**\n * Builds a sidebar navigation tree from an ordered list of docs posts.\n *\n * Directory segments become category nodes; index files promote their\n * title and URL onto the parent node.\n *\n * @param posts - Posts sorted by `getPostsEffect` (order-prefix aware).\n * @returns Top-level `NavNode` array suitable for a sidebar component.\n */\nexport function buildNavTree(posts: Post[]): NavNode[] {\n  const root: NavNode = { title: \"\", children: [] };\n  const nodes = new Map<string, NavNode>();\n\n  const nodeFor = (path: string[]): NavNode => {\n    if (path.length === 0) return root;\n    const key = path.join(\"/\");\n    let node = nodes.get(key);\n    if (!node) {\n      node = { title: humanize(path[path.length - 1]!), children: [] };\n      nodes.set(key, node);\n      nodeFor(path.slice(0, -1)).children.push(node);\n    }\n    return node;\n  };\n\n  for (const post of posts) {\n    if (post.path.length === 0) {\n      root.children.push({ title: post.title, url: post.url, children: [] });\n      continue;\n    }\n    const node = nodeFor(post.path);\n    node.title = post.title;\n    node.url = post.url;\n  }\n\n  return root.children;\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,aAAa,OAA0B;CACrD,MAAM,OAAgB;EAAE,OAAO;EAAI,UAAU,CAAC;CAAE;CAChD,MAAM,wBAAQ,IAAI,IAAqB;CAEvC,MAAM,WAAW,SAA4B;EAC3C,IAAI,KAAK,WAAW,GAAG,OAAO;EAC9B,MAAM,MAAM,KAAK,KAAK,GAAG;EACzB,IAAI,OAAO,MAAM,IAAI,GAAG;EACxB,IAAI,CAAC,MAAM;GACT,OAAO;IAAE,OAAO,SAAS,KAAK,KAAK,SAAS,EAAG;IAAG,UAAU,CAAC;GAAE;GAC/D,MAAM,IAAI,KAAK,IAAI;GACnB,QAAQ,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI;EAC/C;EACA,OAAO;CACT;CAEA,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,KAAK,WAAW,GAAG;GAC1B,KAAK,SAAS,KAAK;IAAE,OAAO,KAAK;IAAO,KAAK,KAAK;IAAK,UAAU,CAAC;GAAE,CAAC;GACrE;EACF;EACA,MAAM,OAAO,QAAQ,KAAK,IAAI;EAC9B,KAAK,QAAQ,KAAK;EAClB,KAAK,MAAM,KAAK;CAClB;CAEA,OAAO,KAAK;AACd"}

package/dist/render.cjs

@@ -0,0 +1,152 @@
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_errors = require("./errors.cjs");
+let effect = require("effect");
+let unified = require("unified");
+let remark_parse = require("remark-parse");
+remark_parse = require_runtime.__toESM(remark_parse, 1);
+let remark_gfm = require("remark-gfm");
+remark_gfm = require_runtime.__toESM(remark_gfm, 1);
+let remark_rehype = require("remark-rehype");
+remark_rehype = require_runtime.__toESM(remark_rehype, 1);
+let rehype_raw = require("rehype-raw");
+rehype_raw = require_runtime.__toESM(rehype_raw, 1);
+let rehype_slug = require("rehype-slug");
+rehype_slug = require_runtime.__toESM(rehype_slug, 1);
+let rehype_autolink_headings = require("rehype-autolink-headings");
+rehype_autolink_headings = require_runtime.__toESM(rehype_autolink_headings, 1);
+let rehype_stringify = require("rehype-stringify");
+rehype_stringify = require_runtime.__toESM(rehype_stringify, 1);
+let _shikijs_rehype_core = require("@shikijs/rehype/core");
+_shikijs_rehype_core = require_runtime.__toESM(_shikijs_rehype_core, 1);
+let shiki = require("shiki");
+let unist_util_visit = require("unist-util-visit");
+let hast_util_to_string = require("hast-util-to-string");
+//#region src/render.ts
+function rehypeCollectToc() {
+	return (tree, file) => {
+		const toc = [];
+		(0, unist_util_visit.visit)(tree, "element", (node) => {
+			if (node.tagName !== "h2" && node.tagName !== "h3") return;
+			const id = node.properties?.["id"];
+			if (typeof id !== "string") return;
+			toc.push({
+				id,
+				text: (0, hast_util_to_string.toString)(node),
+				depth: node.tagName === "h2" ? 2 : 3
+			});
+		});
+		file.data["toc"] = toc;
+	};
+}
+const EXTERNAL_RE = /^https?:\/\//i;
+const ABSOLUTE_RE = /^(?:[a-z][a-z0-9+.-]*:|\/|#|\?)/i;
+const ASSET_PROPS = ["src", "poster"];
+function resolveRelativePath(base, rel) {
+	const segments = [...base.split("/"), ...rel.split("/")].filter((s) => s !== "" && s !== ".");
+	const out = [];
+	for (const segment of segments) if (segment === "..") out.pop();
+	else out.push(segment);
+	return `/${out.join("/")}`;
+}
+function rehypeExternalLinks() {
+	return (tree) => {
+		(0, unist_util_visit.visit)(tree, "element", (node) => {
+			if (node.tagName !== "a") return;
+			const href = node.properties?.["href"];
+			if (typeof href !== "string" || !EXTERNAL_RE.test(href)) return;
+			node.properties["target"] = "_blank";
+			node.properties["rel"] = "noreferrer";
+		});
+	};
+}
+function rehypeResolveAssets(base) {
+	return (tree) => {
+		(0, unist_util_visit.visit)(tree, "element", (node) => {
+			for (const prop of ASSET_PROPS) {
+				const value = node.properties?.[prop];
+				if (typeof value !== "string" || value === "") continue;
+				if (ABSOLUTE_RE.test(value)) continue;
+				node.properties[prop] = resolveRelativePath(base, value);
+			}
+		});
+	};
+}
+function shikiOptions(codeTheme) {
+	const parts = codeTheme.split(/[,\s]+/).filter(Boolean);
+	if (parts.length >= 2) return {
+		themes: {
+			light: parts[0],
+			dark: parts[1]
+		},
+		defaultColor: false
+	};
+	return { theme: parts[0] ?? "github-dark" };
+}
+const BASE_LANGS = [
+	"ts",
+	"tsx",
+	"js",
+	"jsx",
+	"json",
+	"bash",
+	"css",
+	"html",
+	"md",
+	"python",
+	"go",
+	"rust"
+];
+const highlighters = /* @__PURE__ */ new Map();
+function getHighlighter(codeTheme) {
+	let cached = highlighters.get(codeTheme);
+	if (!cached) {
+		const opts = shikiOptions(codeTheme);
+		cached = (0, shiki.createHighlighter)({
+			themes: "themes" in opts ? [opts.themes.light, opts.themes.dark] : [opts.theme],
+			langs: BASE_LANGS
+		});
+		highlighters.set(codeTheme, cached);
+	}
+	return cached;
+}
+const FENCE_LANG_RE = /^[ \t]*(?:`{3,}|~{3,})[ \t]*([A-Za-z0-9_+-]+)/gm;
+async function ensureLanguages(highlighter, markdown) {
+	const loaded = new Set(highlighter.getLoadedLanguages());
+	const wanted = /* @__PURE__ */ new Set();
+	for (const match of markdown.matchAll(FENCE_LANG_RE)) {
+		const lang = match[1].toLowerCase();
+		if (!loaded.has(lang) && lang in shiki.bundledLanguages) wanted.add(lang);
+	}
+	for (const lang of wanted) try {
+		await highlighter.loadLanguage(lang);
+	} catch {}
+}
+/**
+* Converts Markdown to HTML with syntax highlighting, heading slugs,
+* autolinked headings, and a collected table of contents.
+*
+* @param markdown - Raw Markdown source.
+* @param config - Voxx config (used for `theme.codeTheme`).
+* @param opts - Optional `assetBase` for resolving relative image paths.
+*/
+const renderMarkdownEffect = (markdown, config, opts = {}) => effect.Effect.tryPromise({
+	try: async () => {
+		const highlighter = await getHighlighter(config.theme.codeTheme);
+		await ensureLanguages(highlighter, markdown);
+		const processor = (0, unified.unified)().use(remark_parse.default).use(remark_gfm.default).use(remark_rehype.default, { allowDangerousHtml: true }).use(rehype_raw.default).use(rehype_slug.default).use(rehype_autolink_headings.default, { behavior: "wrap" }).use(rehypeExternalLinks).use(_shikijs_rehype_core.default, highlighter, shikiOptions(config.theme.codeTheme));
+		if (opts.assetBase) processor.use(rehypeResolveAssets, opts.assetBase);
+		const file = await processor.use(rehypeCollectToc).use(rehype_stringify.default).process(markdown);
+		return {
+			html: String(file),
+			toc: file.data["toc"] ?? []
+		};
+	},
+	catch: (cause) => new require_errors.RenderError({
+		message: `Failed to render markdown: ${String(cause)}`,
+		cause
+	})
+});
+//#endregion
+exports.renderMarkdownEffect = renderMarkdownEffect;
+
+//# sourceMappingURL=render.cjs.map

package/dist/render.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.cjs","names":["bundledLanguages","Effect","remarkParse","remarkGfm","remarkRehype","rehypeRaw","rehypeSlug","rehypeAutolinkHeadings","rehypeShikiFromHighlighter","rehypeStringify","RenderError"],"sources":["../src/render.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport { unified } from \"unified\";\nimport remarkParse from \"remark-parse\";\nimport remarkGfm from \"remark-gfm\";\nimport remarkRehype from \"remark-rehype\";\nimport rehypeRaw from \"rehype-raw\";\nimport rehypeSlug from \"rehype-slug\";\nimport rehypeAutolinkHeadings from \"rehype-autolink-headings\";\nimport rehypeStringify from \"rehype-stringify\";\nimport rehypeShikiFromHighlighter from \"@shikijs/rehype/core\";\nimport {\n  createHighlighter,\n  bundledLanguages,\n  type BundledLanguage,\n  type Highlighter,\n} from \"shiki\";\nimport { visit } from \"unist-util-visit\";\nimport { toString } from \"hast-util-to-string\";\nimport type { Root } from \"hast\";\nimport { RenderError } from \"./errors\";\nimport type { TocItem, VoxxConfig } from \"./types\";\n\n/** Result returned by the Markdown renderer. */\nexport interface RenderResult {\n  /** Rendered HTML string. */\n  html: string;\n  /** Extracted `h2`/`h3` headings for the table of contents. */\n  toc: TocItem[];\n}\n\n/** Options passed to the Markdown renderer. */\nexport interface RenderOptions {\n  /** URL prefix used to resolve relative `src` and `poster` attributes. */\n  assetBase?: string;\n}\n\nfunction rehypeCollectToc() {\n  return (tree: Root, file: { data: Record<string, unknown> }) => {\n    const toc: TocItem[] = [];\n    visit(tree, \"element\", (node) => {\n      if (node.tagName !== \"h2\" && node.tagName !== \"h3\") return;\n      const id = node.properties?.[\"id\"];\n      if (typeof id !== \"string\") return;\n      toc.push({\n        id,\n        text: toString(node),\n        depth: node.tagName === \"h2\" ? 2 : 3,\n      });\n    });\n    file.data[\"toc\"] = toc;\n  };\n}\n\nconst EXTERNAL_RE = /^https?:\\/\\//i;\nconst ABSOLUTE_RE = /^(?:[a-z][a-z0-9+.-]*:|\\/|#|\\?)/i;\nconst ASSET_PROPS = [\"src\", \"poster\"] as const;\n\nfunction resolveRelativePath(base: string, rel: string): string {\n  const segments = [...base.split(\"/\"), ...rel.split(\"/\")].filter(\n    (s) => s !== \"\" && s !== \".\",\n  );\n  const out: string[] = [];\n  for (const segment of segments) {\n    if (segment === \"..\") out.pop();\n    else out.push(segment);\n  }\n  return `/${out.join(\"/\")}`;\n}\n\nfunction rehypeExternalLinks() {\n  return (tree: Root) => {\n    visit(tree, \"element\", (node) => {\n      if (node.tagName !== \"a\") return;\n      const href = node.properties?.[\"href\"];\n      if (typeof href !== \"string\" || !EXTERNAL_RE.test(href)) return;\n      node.properties[\"target\"] = \"_blank\";\n      node.properties[\"rel\"] = \"noreferrer\";\n    });\n  };\n}\n\nfunction rehypeResolveAssets(base: string) {\n  return (tree: Root) => {\n    visit(tree, \"element\", (node) => {\n      for (const prop of ASSET_PROPS) {\n        const value = node.properties?.[prop];\n        if (typeof value !== \"string\" || value === \"\") continue;\n        if (ABSOLUTE_RE.test(value)) continue;\n        node.properties[prop] = resolveRelativePath(base, value);\n      }\n    });\n  };\n}\n\ntype ShikiOptions =\n  | { themes: { light: string; dark: string }; defaultColor: false }\n  | { theme: string };\n\nfunction shikiOptions(codeTheme: string): ShikiOptions {\n  const parts = codeTheme.split(/[,\\s]+/).filter(Boolean);\n  if (parts.length >= 2) {\n    return {\n      themes: { light: parts[0]!, dark: parts[1]! },\n      defaultColor: false as const,\n    };\n  }\n  return { theme: parts[0] ?? \"github-dark\" };\n}\n\nconst BASE_LANGS: BundledLanguage[] = [\n  \"ts\",\n  \"tsx\",\n  \"js\",\n  \"jsx\",\n  \"json\",\n  \"bash\",\n  \"css\",\n  \"html\",\n  \"md\",\n  \"python\",\n  \"go\",\n  \"rust\",\n];\n\nconst highlighters = new Map<string, Promise<Highlighter>>();\n\nfunction getHighlighter(codeTheme: string): Promise<Highlighter> {\n  let cached = highlighters.get(codeTheme);\n  if (!cached) {\n    const opts = shikiOptions(codeTheme);\n    const themes =\n      \"themes\" in opts\n        ? [opts.themes.light, opts.themes.dark]\n        : [(opts as { theme: string }).theme];\n    cached = createHighlighter({ themes, langs: BASE_LANGS });\n    highlighters.set(codeTheme, cached);\n  }\n  return cached;\n}\n\nconst FENCE_LANG_RE = /^[ \\t]*(?:`{3,}|~{3,})[ \\t]*([A-Za-z0-9_+-]+)/gm;\n\nasync function ensureLanguages(\n  highlighter: Highlighter,\n  markdown: string,\n): Promise<void> {\n  const loaded = new Set(highlighter.getLoadedLanguages());\n  const wanted = new Set<BundledLanguage>();\n  for (const match of markdown.matchAll(FENCE_LANG_RE)) {\n    const lang = match[1]!.toLowerCase();\n    if (!loaded.has(lang) && lang in bundledLanguages) {\n      wanted.add(lang as BundledLanguage);\n    }\n  }\n  for (const lang of wanted) {\n    try {\n      await highlighter.loadLanguage(lang);\n    } catch {}\n  }\n}\n\n/**\n * Converts Markdown to HTML with syntax highlighting, heading slugs,\n * autolinked headings, and a collected table of contents.\n *\n * @param markdown - Raw Markdown source.\n * @param config - Voxx config (used for `theme.codeTheme`).\n * @param opts - Optional `assetBase` for resolving relative image paths.\n */\nexport const renderMarkdownEffect = (\n  markdown: string,\n  config: VoxxConfig,\n  opts: RenderOptions = {},\n) =>\n  Effect.tryPromise({\n    try: async (): Promise<RenderResult> => {\n      const highlighter = await getHighlighter(config.theme.codeTheme);\n      await ensureLanguages(highlighter, markdown);\n      const processor = unified()\n        .use(remarkParse)\n        .use(remarkGfm)\n        .use(remarkRehype, { allowDangerousHtml: true })\n        .use(rehypeRaw)\n        .use(rehypeSlug)\n        .use(rehypeAutolinkHeadings, { behavior: \"wrap\" })\n        .use(rehypeExternalLinks)\n        .use(\n          rehypeShikiFromHighlighter,\n          highlighter,\n          shikiOptions(config.theme.codeTheme),\n        );\n      if (opts.assetBase) processor.use(rehypeResolveAssets, opts.assetBase);\n      const file = await processor\n        .use(rehypeCollectToc)\n        .use(rehypeStringify)\n        .process(markdown);\n      return {\n        html: String(file),\n        toc: (file.data[\"toc\"] as TocItem[] | undefined) ?? [],\n      };\n    },\n    catch: (cause) =>\n      new RenderError({\n        message: `Failed to render markdown: ${String(cause)}`,\n        cause,\n      }),\n  });\n"],"mappings":"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"}

package/dist/render.d.cts

@@ -0,0 +1,29 @@
+import { RenderError } from "./errors.cjs";
+import { TocItem, VoxxConfig } from "./types.cjs";
+import { Effect } from "effect";
+
+//#region src/render.d.ts
+/** Result returned by the Markdown renderer. */
+interface RenderResult {
+  /** Rendered HTML string. */
+  html: string;
+  /** Extracted `h2`/`h3` headings for the table of contents. */
+  toc: TocItem[];
+}
+/** Options passed to the Markdown renderer. */
+interface RenderOptions {
+  /** URL prefix used to resolve relative `src` and `poster` attributes. */
+  assetBase?: string;
+}
+/**
+ * Converts Markdown to HTML with syntax highlighting, heading slugs,
+ * autolinked headings, and a collected table of contents.
+ *
+ * @param markdown - Raw Markdown source.
+ * @param config - Voxx config (used for `theme.codeTheme`).
+ * @param opts - Optional `assetBase` for resolving relative image paths.
+ */
+declare const renderMarkdownEffect: (markdown: string, config: VoxxConfig, opts?: RenderOptions) => Effect.Effect<RenderResult, RenderError, never>;
+//#endregion
+export { RenderResult, renderMarkdownEffect };
+//# sourceMappingURL=render.d.cts.map

package/dist/render.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.cts","names":[],"sources":["../src/render.ts"],"mappings":";;;;;;UAuBiB,YAAA;EAAA;EAEf,IAAA;;EAEA,GAAA,EAAK,OAAO;AAAA;;UAIG,aAAA;EAJH;EAMZ,SAAS;AAAA;;;;AAAA;AAwIX;;;;cAAa,oBAAA,GACX,QAAA,UACA,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,aAAA,KAAkB,MAAA,CAAA,MAAA,CAAA,YAAA,EAAA,WAAA"}

package/dist/render.d.mts

@@ -0,0 +1,29 @@
+import { RenderError } from "./errors.mjs";
+import { TocItem, VoxxConfig } from "./types.mjs";
+import { Effect } from "effect";
+
+//#region src/render.d.ts
+/** Result returned by the Markdown renderer. */
+interface RenderResult {
+  /** Rendered HTML string. */
+  html: string;
+  /** Extracted `h2`/`h3` headings for the table of contents. */
+  toc: TocItem[];
+}
+/** Options passed to the Markdown renderer. */
+interface RenderOptions {
+  /** URL prefix used to resolve relative `src` and `poster` attributes. */
+  assetBase?: string;
+}
+/**
+ * Converts Markdown to HTML with syntax highlighting, heading slugs,
+ * autolinked headings, and a collected table of contents.
+ *
+ * @param markdown - Raw Markdown source.
+ * @param config - Voxx config (used for `theme.codeTheme`).
+ * @param opts - Optional `assetBase` for resolving relative image paths.
+ */
+declare const renderMarkdownEffect: (markdown: string, config: VoxxConfig, opts?: RenderOptions) => Effect.Effect<RenderResult, RenderError, never>;
+//#endregion
+export { RenderResult, renderMarkdownEffect };
+//# sourceMappingURL=render.d.mts.map

package/dist/render.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.mts","names":[],"sources":["../src/render.ts"],"mappings":";;;;;;UAuBiB,YAAA;EAAA;EAEf,IAAA;;EAEA,GAAA,EAAK,OAAO;AAAA;;UAIG,aAAA;EAJH;EAMZ,SAAS;AAAA;;;;AAAA;AAwIX;;;;cAAa,oBAAA,GACX,QAAA,UACA,MAAA,EAAQ,UAAA,EACR,IAAA,GAAM,aAAA,KAAkB,MAAA,CAAA,MAAA,CAAA,YAAA,EAAA,WAAA"}

package/dist/render.mjs

@@ -0,0 +1,143 @@
+import { RenderError } from "./errors.mjs";
+import { Effect } from "effect";
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import remarkRehype from "remark-rehype";
+import rehypeRaw from "rehype-raw";
+import rehypeSlug from "rehype-slug";
+import rehypeAutolinkHeadings from "rehype-autolink-headings";
+import rehypeStringify from "rehype-stringify";
+import rehypeShikiFromHighlighter from "@shikijs/rehype/core";
+import { bundledLanguages, createHighlighter } from "shiki";
+import { visit } from "unist-util-visit";
+import { toString } from "hast-util-to-string";
+//#region src/render.ts
+function rehypeCollectToc() {
+	return (tree, file) => {
+		const toc = [];
+		visit(tree, "element", (node) => {
+			if (node.tagName !== "h2" && node.tagName !== "h3") return;
+			const id = node.properties?.["id"];
+			if (typeof id !== "string") return;
+			toc.push({
+				id,
+				text: toString(node),
+				depth: node.tagName === "h2" ? 2 : 3
+			});
+		});
+		file.data["toc"] = toc;
+	};
+}
+const EXTERNAL_RE = /^https?:\/\//i;
+const ABSOLUTE_RE = /^(?:[a-z][a-z0-9+.-]*:|\/|#|\?)/i;
+const ASSET_PROPS = ["src", "poster"];
+function resolveRelativePath(base, rel) {
+	const segments = [...base.split("/"), ...rel.split("/")].filter((s) => s !== "" && s !== ".");
+	const out = [];
+	for (const segment of segments) if (segment === "..") out.pop();
+	else out.push(segment);
+	return `/${out.join("/")}`;
+}
+function rehypeExternalLinks() {
+	return (tree) => {
+		visit(tree, "element", (node) => {
+			if (node.tagName !== "a") return;
+			const href = node.properties?.["href"];
+			if (typeof href !== "string" || !EXTERNAL_RE.test(href)) return;
+			node.properties["target"] = "_blank";
+			node.properties["rel"] = "noreferrer";
+		});
+	};
+}
+function rehypeResolveAssets(base) {
+	return (tree) => {
+		visit(tree, "element", (node) => {
+			for (const prop of ASSET_PROPS) {
+				const value = node.properties?.[prop];
+				if (typeof value !== "string" || value === "") continue;
+				if (ABSOLUTE_RE.test(value)) continue;
+				node.properties[prop] = resolveRelativePath(base, value);
+			}
+		});
+	};
+}
+function shikiOptions(codeTheme) {
+	const parts = codeTheme.split(/[,\s]+/).filter(Boolean);
+	if (parts.length >= 2) return {
+		themes: {
+			light: parts[0],
+			dark: parts[1]
+		},
+		defaultColor: false
+	};
+	return { theme: parts[0] ?? "github-dark" };
+}
+const BASE_LANGS = [
+	"ts",
+	"tsx",
+	"js",
+	"jsx",
+	"json",
+	"bash",
+	"css",
+	"html",
+	"md",
+	"python",
+	"go",
+	"rust"
+];
+const highlighters = /* @__PURE__ */ new Map();
+function getHighlighter(codeTheme) {
+	let cached = highlighters.get(codeTheme);
+	if (!cached) {
+		const opts = shikiOptions(codeTheme);
+		cached = createHighlighter({
+			themes: "themes" in opts ? [opts.themes.light, opts.themes.dark] : [opts.theme],
+			langs: BASE_LANGS
+		});
+		highlighters.set(codeTheme, cached);
+	}
+	return cached;
+}
+const FENCE_LANG_RE = /^[ \t]*(?:`{3,}|~{3,})[ \t]*([A-Za-z0-9_+-]+)/gm;
+async function ensureLanguages(highlighter, markdown) {
+	const loaded = new Set(highlighter.getLoadedLanguages());
+	const wanted = /* @__PURE__ */ new Set();
+	for (const match of markdown.matchAll(FENCE_LANG_RE)) {
+		const lang = match[1].toLowerCase();
+		if (!loaded.has(lang) && lang in bundledLanguages) wanted.add(lang);
+	}
+	for (const lang of wanted) try {
+		await highlighter.loadLanguage(lang);
+	} catch {}
+}
+/**
+* Converts Markdown to HTML with syntax highlighting, heading slugs,
+* autolinked headings, and a collected table of contents.
+*
+* @param markdown - Raw Markdown source.
+* @param config - Voxx config (used for `theme.codeTheme`).
+* @param opts - Optional `assetBase` for resolving relative image paths.
+*/
+const renderMarkdownEffect = (markdown, config, opts = {}) => Effect.tryPromise({
+	try: async () => {
+		const highlighter = await getHighlighter(config.theme.codeTheme);
+		await ensureLanguages(highlighter, markdown);
+		const processor = unified().use(remarkParse).use(remarkGfm).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeRaw).use(rehypeSlug).use(rehypeAutolinkHeadings, { behavior: "wrap" }).use(rehypeExternalLinks).use(rehypeShikiFromHighlighter, highlighter, shikiOptions(config.theme.codeTheme));
+		if (opts.assetBase) processor.use(rehypeResolveAssets, opts.assetBase);
+		const file = await processor.use(rehypeCollectToc).use(rehypeStringify).process(markdown);
+		return {
+			html: String(file),
+			toc: file.data["toc"] ?? []
+		};
+	},
+	catch: (cause) => new RenderError({
+		message: `Failed to render markdown: ${String(cause)}`,
+		cause
+	})
+});
+//#endregion
+export { renderMarkdownEffect };
+
+//# sourceMappingURL=render.mjs.map

package/dist/render.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.mjs","names":[],"sources":["../src/render.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport { unified } from \"unified\";\nimport remarkParse from \"remark-parse\";\nimport remarkGfm from \"remark-gfm\";\nimport remarkRehype from \"remark-rehype\";\nimport rehypeRaw from \"rehype-raw\";\nimport rehypeSlug from \"rehype-slug\";\nimport rehypeAutolinkHeadings from \"rehype-autolink-headings\";\nimport rehypeStringify from \"rehype-stringify\";\nimport rehypeShikiFromHighlighter from \"@shikijs/rehype/core\";\nimport {\n  createHighlighter,\n  bundledLanguages,\n  type BundledLanguage,\n  type Highlighter,\n} from \"shiki\";\nimport { visit } from \"unist-util-visit\";\nimport { toString } from \"hast-util-to-string\";\nimport type { Root } from \"hast\";\nimport { RenderError } from \"./errors\";\nimport type { TocItem, VoxxConfig } from \"./types\";\n\n/** Result returned by the Markdown renderer. */\nexport interface RenderResult {\n  /** Rendered HTML string. */\n  html: string;\n  /** Extracted `h2`/`h3` headings for the table of contents. */\n  toc: TocItem[];\n}\n\n/** Options passed to the Markdown renderer. */\nexport interface RenderOptions {\n  /** URL prefix used to resolve relative `src` and `poster` attributes. */\n  assetBase?: string;\n}\n\nfunction rehypeCollectToc() {\n  return (tree: Root, file: { data: Record<string, unknown> }) => {\n    const toc: TocItem[] = [];\n    visit(tree, \"element\", (node) => {\n      if (node.tagName !== \"h2\" && node.tagName !== \"h3\") return;\n      const id = node.properties?.[\"id\"];\n      if (typeof id !== \"string\") return;\n      toc.push({\n        id,\n        text: toString(node),\n        depth: node.tagName === \"h2\" ? 2 : 3,\n      });\n    });\n    file.data[\"toc\"] = toc;\n  };\n}\n\nconst EXTERNAL_RE = /^https?:\\/\\//i;\nconst ABSOLUTE_RE = /^(?:[a-z][a-z0-9+.-]*:|\\/|#|\\?)/i;\nconst ASSET_PROPS = [\"src\", \"poster\"] as const;\n\nfunction resolveRelativePath(base: string, rel: string): string {\n  const segments = [...base.split(\"/\"), ...rel.split(\"/\")].filter(\n    (s) => s !== \"\" && s !== \".\",\n  );\n  const out: string[] = [];\n  for (const segment of segments) {\n    if (segment === \"..\") out.pop();\n    else out.push(segment);\n  }\n  return `/${out.join(\"/\")}`;\n}\n\nfunction rehypeExternalLinks() {\n  return (tree: Root) => {\n    visit(tree, \"element\", (node) => {\n      if (node.tagName !== \"a\") return;\n      const href = node.properties?.[\"href\"];\n      if (typeof href !== \"string\" || !EXTERNAL_RE.test(href)) return;\n      node.properties[\"target\"] = \"_blank\";\n      node.properties[\"rel\"] = \"noreferrer\";\n    });\n  };\n}\n\nfunction rehypeResolveAssets(base: string) {\n  return (tree: Root) => {\n    visit(tree, \"element\", (node) => {\n      for (const prop of ASSET_PROPS) {\n        const value = node.properties?.[prop];\n        if (typeof value !== \"string\" || value === \"\") continue;\n        if (ABSOLUTE_RE.test(value)) continue;\n        node.properties[prop] = resolveRelativePath(base, value);\n      }\n    });\n  };\n}\n\ntype ShikiOptions =\n  | { themes: { light: string; dark: string }; defaultColor: false }\n  | { theme: string };\n\nfunction shikiOptions(codeTheme: string): ShikiOptions {\n  const parts = codeTheme.split(/[,\\s]+/).filter(Boolean);\n  if (parts.length >= 2) {\n    return {\n      themes: { light: parts[0]!, dark: parts[1]! },\n      defaultColor: false as const,\n    };\n  }\n  return { theme: parts[0] ?? \"github-dark\" };\n}\n\nconst BASE_LANGS: BundledLanguage[] = [\n  \"ts\",\n  \"tsx\",\n  \"js\",\n  \"jsx\",\n  \"json\",\n  \"bash\",\n  \"css\",\n  \"html\",\n  \"md\",\n  \"python\",\n  \"go\",\n  \"rust\",\n];\n\nconst highlighters = new Map<string, Promise<Highlighter>>();\n\nfunction getHighlighter(codeTheme: string): Promise<Highlighter> {\n  let cached = highlighters.get(codeTheme);\n  if (!cached) {\n    const opts = shikiOptions(codeTheme);\n    const themes =\n      \"themes\" in opts\n        ? [opts.themes.light, opts.themes.dark]\n        : [(opts as { theme: string }).theme];\n    cached = createHighlighter({ themes, langs: BASE_LANGS });\n    highlighters.set(codeTheme, cached);\n  }\n  return cached;\n}\n\nconst FENCE_LANG_RE = /^[ \\t]*(?:`{3,}|~{3,})[ \\t]*([A-Za-z0-9_+-]+)/gm;\n\nasync function ensureLanguages(\n  highlighter: Highlighter,\n  markdown: string,\n): Promise<void> {\n  const loaded = new Set(highlighter.getLoadedLanguages());\n  const wanted = new Set<BundledLanguage>();\n  for (const match of markdown.matchAll(FENCE_LANG_RE)) {\n    const lang = match[1]!.toLowerCase();\n    if (!loaded.has(lang) && lang in bundledLanguages) {\n      wanted.add(lang as BundledLanguage);\n    }\n  }\n  for (const lang of wanted) {\n    try {\n      await highlighter.loadLanguage(lang);\n    } catch {}\n  }\n}\n\n/**\n * Converts Markdown to HTML with syntax highlighting, heading slugs,\n * autolinked headings, and a collected table of contents.\n *\n * @param markdown - Raw Markdown source.\n * @param config - Voxx config (used for `theme.codeTheme`).\n * @param opts - Optional `assetBase` for resolving relative image paths.\n */\nexport const renderMarkdownEffect = (\n  markdown: string,\n  config: VoxxConfig,\n  opts: RenderOptions = {},\n) =>\n  Effect.tryPromise({\n    try: async (): Promise<RenderResult> => {\n      const highlighter = await getHighlighter(config.theme.codeTheme);\n      await ensureLanguages(highlighter, markdown);\n      const processor = unified()\n        .use(remarkParse)\n        .use(remarkGfm)\n        .use(remarkRehype, { allowDangerousHtml: true })\n        .use(rehypeRaw)\n        .use(rehypeSlug)\n        .use(rehypeAutolinkHeadings, { behavior: \"wrap\" })\n        .use(rehypeExternalLinks)\n        .use(\n          rehypeShikiFromHighlighter,\n          highlighter,\n          shikiOptions(config.theme.codeTheme),\n        );\n      if (opts.assetBase) processor.use(rehypeResolveAssets, opts.assetBase);\n      const file = await processor\n        .use(rehypeCollectToc)\n        .use(rehypeStringify)\n        .process(markdown);\n      return {\n        html: String(file),\n        toc: (file.data[\"toc\"] as TocItem[] | undefined) ?? [],\n      };\n    },\n    catch: (cause) =>\n      new RenderError({\n        message: `Failed to render markdown: ${String(cause)}`,\n        cause,\n      }),\n  });\n"],"mappings":";;;;;;;;;;;;;;;AAoCA,SAAS,mBAAmB;CAC1B,QAAQ,MAAY,SAA4C;EAC9D,MAAM,MAAiB,CAAC;EACxB,MAAM,MAAM,YAAY,SAAS;GAC/B,IAAI,KAAK,YAAY,QAAQ,KAAK,YAAY,MAAM;GACpD,MAAM,KAAK,KAAK,aAAa;GAC7B,IAAI,OAAO,OAAO,UAAU;GAC5B,IAAI,KAAK;IACP;IACA,MAAM,SAAS,IAAI;IACnB,OAAO,KAAK,YAAY,OAAO,IAAI;GACrC,CAAC;EACH,CAAC;EACD,KAAK,KAAK,SAAS;CACrB;AACF;AAEA,MAAM,cAAc;AACpB,MAAM,cAAc;AACpB,MAAM,cAAc,CAAC,OAAO,QAAQ;AAEpC,SAAS,oBAAoB,MAAc,KAAqB;CAC9D,MAAM,WAAW,CAAC,GAAG,KAAK,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,QACtD,MAAM,MAAM,MAAM,MAAM,GAC3B;CACA,MAAM,MAAgB,CAAC;CACvB,KAAK,MAAM,WAAW,UACpB,IAAI,YAAY,MAAM,IAAI,IAAI;MACzB,IAAI,KAAK,OAAO;CAEvB,OAAO,IAAI,IAAI,KAAK,GAAG;AACzB;AAEA,SAAS,sBAAsB;CAC7B,QAAQ,SAAe;EACrB,MAAM,MAAM,YAAY,SAAS;GAC/B,IAAI,KAAK,YAAY,KAAK;GAC1B,MAAM,OAAO,KAAK,aAAa;GAC/B,IAAI,OAAO,SAAS,YAAY,CAAC,YAAY,KAAK,IAAI,GAAG;GACzD,KAAK,WAAW,YAAY;GAC5B,KAAK,WAAW,SAAS;EAC3B,CAAC;CACH;AACF;AAEA,SAAS,oBAAoB,MAAc;CACzC,QAAQ,SAAe;EACrB,MAAM,MAAM,YAAY,SAAS;GAC/B,KAAK,MAAM,QAAQ,aAAa;IAC9B,MAAM,QAAQ,KAAK,aAAa;IAChC,IAAI,OAAO,UAAU,YAAY,UAAU,IAAI;IAC/C,IAAI,YAAY,KAAK,KAAK,GAAG;IAC7B,KAAK,WAAW,QAAQ,oBAAoB,MAAM,KAAK;GACzD;EACF,CAAC;CACH;AACF;AAMA,SAAS,aAAa,WAAiC;CACrD,MAAM,QAAQ,UAAU,MAAM,QAAQ,CAAC,CAAC,OAAO,OAAO;CACtD,IAAI,MAAM,UAAU,GAClB,OAAO;EACL,QAAQ;GAAE,OAAO,MAAM;GAAK,MAAM,MAAM;EAAI;EAC5C,cAAc;CAChB;CAEF,OAAO,EAAE,OAAO,MAAM,MAAM,cAAc;AAC5C;AAEA,MAAM,aAAgC;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,+BAAe,IAAI,IAAkC;AAE3D,SAAS,eAAe,WAAyC;CAC/D,IAAI,SAAS,aAAa,IAAI,SAAS;CACvC,IAAI,CAAC,QAAQ;EACX,MAAM,OAAO,aAAa,SAAS;EAKnC,SAAS,kBAAkB;GAAE,QAH3B,YAAY,OACR,CAAC,KAAK,OAAO,OAAO,KAAK,OAAO,IAAI,IACpC,CAAE,KAA2B,KAAK;GACH,OAAO;EAAW,CAAC;EACxD,aAAa,IAAI,WAAW,MAAM;CACpC;CACA,OAAO;AACT;AAEA,MAAM,gBAAgB;AAEtB,eAAe,gBACb,aACA,UACe;CACf,MAAM,SAAS,IAAI,IAAI,YAAY,mBAAmB,CAAC;CACvD,MAAM,yBAAS,IAAI,IAAqB;CACxC,KAAK,MAAM,SAAS,SAAS,SAAS,aAAa,GAAG;EACpD,MAAM,OAAO,MAAM,EAAE,CAAE,YAAY;EACnC,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,QAAQ,kBAC/B,OAAO,IAAI,IAAuB;CAEtC;CACA,KAAK,MAAM,QAAQ,QACjB,IAAI;EACF,MAAM,YAAY,aAAa,IAAI;CACrC,QAAQ,CAAC;AAEb;;;;;;;;;AAUA,MAAa,wBACX,UACA,QACA,OAAsB,CAAC,MAEvB,OAAO,WAAW;CAChB,KAAK,YAAmC;EACtC,MAAM,cAAc,MAAM,eAAe,OAAO,MAAM,SAAS;EAC/D,MAAM,gBAAgB,aAAa,QAAQ;EAC3C,MAAM,YAAY,QAAQ,CAAC,CACxB,IAAI,WAAW,CAAC,CAChB,IAAI,SAAS,CAAC,CACd,IAAI,cAAc,EAAE,oBAAoB,KAAK,CAAC,CAAC,CAC/C,IAAI,SAAS,CAAC,CACd,IAAI,UAAU,CAAC,CACf,IAAI,wBAAwB,EAAE,UAAU,OAAO,CAAC,CAAC,CACjD,IAAI,mBAAmB,CAAC,CACxB,IACC,4BACA,aACA,aAAa,OAAO,MAAM,SAAS,CACrC;EACF,IAAI,KAAK,WAAW,UAAU,IAAI,qBAAqB,KAAK,SAAS;EACrE,MAAM,OAAO,MAAM,UAChB,IAAI,gBAAgB,CAAC,CACrB,IAAI,eAAe,CAAC,CACpB,QAAQ,QAAQ;EACnB,OAAO;GACL,MAAM,OAAO,IAAI;GACjB,KAAM,KAAK,KAAK,UAAoC,CAAC;EACvD;CACF;CACA,QAAQ,UACN,IAAI,YAAY;EACd,SAAS,8BAA8B,OAAO,KAAK;EACnD;CACF,CAAC;AACL,CAAC"}