ardo 3.2.1 → 3.4.0

package/dist/vite/index.js

@@ -1,5 +1,6 @@
 import { defaultMarkdownConfig, resolveConfig } from "../config/index.js";
-import { n as generateApiDocs } from "../generator-DPtRXxM_.js";
+import { n as ARDO_FAVICON_SVG } from "../favicon-Cx-inut3.js";
+import { n as generateApiDocs } from "../generator-CYSyo4Vz.js";
 import path from "node:path";
 import matter from "gray-matter";
 import rehypeStringify from "rehype-stringify";
@@ -10,10 +11,11 @@ import remarkRehype from "remark-rehype";
 import { unified } from "unified";
 import { visit } from "unist-util-visit";
 import { createHighlighter } from "shiki";
-import fs from "node:fs/promises";
+import fs, { readFile } from "node:fs/promises";
 import { vanillaExtractPlugin } from "@vanilla-extract/vite-plugin";
-import fsSync from "node:fs";
+import fsSync, { existsSync } from "node:fs";
 import { execSync } from "node:child_process";
+import { Resvg } from "@resvg/resvg-js";
 import mdx from "@mdx-js/rollup";
 import { reactRouter } from "@react-router/dev/vite";
 import rehypeShiki from "@shikijs/rehype";
@@ -219,7 +221,7 @@ function getCodeNode(node) {
 	return firstChild;
 }
 function isElementNode(node) {
-	return isRecord$5(node) && node.type === "element";
+	return isRecord$6(node) && node.type === "element";
 }
 function getMetaString(codeNode) {
 	const properties = toRecord(codeNode.properties);
@@ -253,12 +255,12 @@ function replaceNodeWithShikiContainer(parent, index, innerHtml) {
 	};
 }
 function hasChildrenArray(value) {
-	return isRecord$5(value) && Array.isArray(value.children);
+	return isRecord$6(value) && Array.isArray(value.children);
 }
 function toRecord(value) {
-	return isRecord$5(value) ? value : {};
+	return isRecord$6(value) ? value : {};
 }
-function isRecord$5(value) {
+function isRecord$6(value) {
 	return value != null && typeof value === "object";
 }
 //#endregion
@@ -285,9 +287,9 @@ function ensureNodeData(node) {
 	return node.data;
 }
 function ensureRecord(value) {
-	return isRecord$4(value) ? value : {};
+	return isRecord$5(value) ? value : {};
 }
-function isRecord$4(value) {
+function isRecord$5(value) {
 	return value != null && typeof value === "object";
 }
 /**
@@ -321,7 +323,7 @@ function ardoLineTransformer(options = {}) {
 	};
 }
 function getMetaRaw(meta) {
-	if (!isRecord$4(meta)) return "";
+	if (!isRecord$5(meta)) return "";
 	const raw = meta.__raw;
 	return typeof raw === "string" ? raw : "";
 }
@@ -407,7 +409,7 @@ function remarkExtractToc(options) {
 		let headingIndex = 0;
 		visit(tree, "heading", (node) => {
 			if (node.depth < minLevel || node.depth > maxLevel) return;
-			const text = getHeadingText$1(node);
+			const text = getHeadingText$2(node);
 			const slug = slugify$1(text);
 			const id = slug === "" ? `heading-${headingIndex}` : slug;
 			headingIndex++;
@@ -422,10 +424,10 @@ function remarkExtractToc(options) {
 		tocExtraction.toc = buildTocTree(headings);
 	};
 }
-function getHeadingText$1(node) {
+function getHeadingText$2(node) {
 	const textParts = [];
 	function extractText(child) {
-		if (!isRecord$3(child)) return;
+		if (!isRecord$4(child)) return;
 		if (child.type === "text") textParts.push(typeof child.value === "string" ? child.value : "");
 		else if (child.type === "inlineCode") textParts.push(typeof child.value === "string" ? child.value : "");
 		else if (Array.isArray(child.children)) child.children.forEach((nestedChild) => {
@@ -480,10 +482,10 @@ function buildTocTree(headings) {
 function ensureHProperties$1(node) {
 	const data = node.data ?? {};
 	node.data = data;
-	if (!isRecord$3(data.hProperties)) data.hProperties = {};
+	if (!isRecord$4(data.hProperties)) data.hProperties = {};
 	return data.hProperties;
 }
-function isRecord$3(value) {
+function isRecord$4(value) {
 	return value != null && typeof value === "object";
 }
 //#endregion
@@ -514,9 +516,9 @@ async function transformMarkdownToReact(content, config) {
 	return transformMarkdown(content, config);
 }
 function readPageFrontmatter(data) {
-	return isRecord$2(data) ? data : {};
+	return isRecord$3(data) ? data : {};
 }
-function isRecord$2(value) {
+function isRecord$3(value) {
 	return value != null && typeof value === "object";
 }
 //#endregion
@@ -641,7 +643,7 @@ function isMarkdownPage(entryName) {
 async function createDirectorySidebarItem(fullPath, relativePath, rootDir) {
 	const children = await scanDirectoryForSidebar(fullPath, rootDir);
 	if (children.length === 0) return null;
-	const metadata = await readDirectoryIndexMetadata(fullPath, relativePath);
+	const metadata = await readDirectoryIndexMetadata$1(fullPath, relativePath);
 	const title = metadata.title ?? formatTitle$2(path.basename(fullPath));
 	return {
 		collapsed: false,
@@ -651,7 +653,7 @@ async function createDirectorySidebarItem(fullPath, relativePath, rootDir) {
 		text: title
 	};
 }
-async function readDirectoryIndexMetadata(fullPath, relativePath) {
+async function readDirectoryIndexMetadata$1(fullPath, relativePath) {
 	const frontmatter = await readFrontmatter$1(path.join(fullPath, "index.md"));
 	return {
 		link: frontmatter == null ? void 0 : normalizePath(relativePath),
@@ -678,14 +680,14 @@ async function readFrontmatter$1(filePath) {
 	}
 }
 function toSidebarFrontmatter(data) {
-	if (!isRecord$1(data)) return {};
+	if (!isRecord$2(data)) return {};
 	return {
 		order: typeof data.order === "number" ? data.order : void 0,
 		sidebar: typeof data.sidebar === "boolean" ? data.sidebar : void 0,
 		title: typeof data.title === "string" ? data.title : void 0
 	};
 }
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return value != null && typeof value === "object";
 }
 function sortSidebarItems(items) {
@@ -1094,6 +1096,228 @@ function trimSlashes(value) {
 	return trimmed;
 }
 //#endregion
+//#region src/vite/icons.ts
+const ICON_FILES = new Set([
+	"favicon.ico",
+	"icon.svg",
+	"apple-touch-icon.png"
+]);
+function createIconsPlugin(options) {
+	if (options === false) return [];
+	let config;
+	let assetsPromise;
+	const getAssets = async () => {
+		assetsPromise ??= createIconAssets(config.root, options);
+		return assetsPromise;
+	};
+	return [{
+		name: "ardo:icons",
+		configResolved(resolvedConfig) {
+			config = resolvedConfig;
+		},
+		configureServer(server) {
+			server.middlewares.use((request, response, next) => {
+				serveIconRequest({
+					config,
+					getAssets,
+					response,
+					url: request.url
+				}).then((served) => {
+					if (!served) next();
+				}).catch((error) => {
+					if (error instanceof Error) next(error);
+					else next(new Error(String(error)));
+				});
+			});
+		},
+		async generateBundle() {
+			if (config.build.ssr !== false) return;
+			const assets = await getAssets();
+			for (const asset of assets) {
+				if (hasPublicAsset(config, asset.fileName)) continue;
+				this.emitFile({
+					type: "asset",
+					fileName: asset.fileName,
+					source: asset.source
+				});
+			}
+		}
+	}];
+}
+async function serveIconRequest(input) {
+	const { config, getAssets, response, url } = input;
+	const fileName = getIconRequestFileName(url);
+	if (fileName == null || hasPublicAsset(config, fileName)) return false;
+	const asset = (await getAssets()).find((candidate) => candidate.fileName === fileName);
+	if (asset == null) return false;
+	response.statusCode = 200;
+	response.setHeader("Content-Type", asset.contentType);
+	response.setHeader("Cache-Control", "no-cache");
+	response.end(asset.source);
+	return true;
+}
+async function createIconAssets(root, options) {
+	const svg = await resolveIconSvg(root, options?.source);
+	const faviconPng = renderPng(svg, 32);
+	const appleTouchIcon = renderPng(svg, 180);
+	return [
+		{
+			fileName: "favicon.ico",
+			contentType: "image/x-icon",
+			source: createIco(faviconPng, 32)
+		},
+		{
+			fileName: "icon.svg",
+			contentType: "image/svg+xml",
+			source: svg
+		},
+		{
+			fileName: "apple-touch-icon.png",
+			contentType: "image/png",
+			source: appleTouchIcon
+		}
+	];
+}
+async function resolveIconSvg(root, source) {
+	if (source == null) return ARDO_FAVICON_SVG;
+	const trimmedSource = source.trim();
+	if (trimmedSource.startsWith("<svg")) return trimmedSource;
+	return readFile(path.resolve(root, source), "utf8");
+}
+function renderPng(svg, size) {
+	return new Resvg(svg, { fitTo: {
+		mode: "width",
+		value: size
+	} }).render().asPng();
+}
+function createIco(png, size) {
+	const imageOffset = 22;
+	const ico = new Uint8Array(imageOffset + png.length);
+	const view = new DataView(ico.buffer);
+	writeIcoHeader(view);
+	writeIcoDirectory({
+		ico,
+		imageOffset,
+		pngLength: png.length,
+		size,
+		view
+	});
+	ico.set(png, imageOffset);
+	return ico;
+}
+function writeIcoHeader(view) {
+	view.setUint16(0, 0, true);
+	view.setUint16(2, 1, true);
+	view.setUint16(4, 1, true);
+}
+function writeIcoDirectory(input) {
+	const { ico, imageOffset, pngLength, size, view } = input;
+	ico[6] = size >= 256 ? 0 : size;
+	ico[7] = size >= 256 ? 0 : size;
+	ico[8] = 0;
+	ico[9] = 0;
+	view.setUint16(10, 1, true);
+	view.setUint16(12, 32, true);
+	view.setUint32(14, pngLength, true);
+	view.setUint32(18, imageOffset, true);
+}
+function getIconRequestFileName(url) {
+	if (url == null) return;
+	const [pathname] = url.split("?", 1);
+	const fileName = pathname.startsWith("/") ? pathname.slice(1) : pathname;
+	return ICON_FILES.has(fileName) ? fileName : void 0;
+}
+function hasPublicAsset(config, fileName) {
+	return existsSync(path.join(config.publicDir, fileName));
+}
+//#endregion
+//#region src/vite/markdown-meta.ts
+function transformMarkdownMeta(code, id, state) {
+	if (!shouldInjectMeta(code, id, state)) return;
+	const pageTitle = extractFrontmatterValue(code, "title");
+	if (pageTitle == null || pageTitle === "") return;
+	return {
+		code: `${code}\nexport const meta = () => [${buildMetaEntries({
+			pageTitle,
+			siteTitle: state.resolvedConfig?.title ?? "Ardo",
+			titleSeparator: state.resolvedConfig?.titleSeparator ?? " | ",
+			description: extractFrontmatterValue(code, "description")
+		}).join(", ")}];\n`,
+		map: null
+	};
+}
+function shouldInjectMeta(code, id, state) {
+	return isMarkdownFile(id) && id.startsWith(state.routesDir) && !hasMetaExport(code);
+}
+function buildMetaEntries(input) {
+	const fullTitle = `${input.pageTitle}${input.titleSeparator}${input.siteTitle}`;
+	const entries = [`{ title: ${JSON.stringify(fullTitle)} }`];
+	if (input.description != null && input.description !== "") entries.push(`{ name: "description", content: ${JSON.stringify(input.description)} }`);
+	return entries;
+}
+function isMarkdownFile(id) {
+	return id.endsWith(".md") || id.endsWith(".mdx");
+}
+function hasMetaExport(code) {
+	return code.includes("export const meta") || code.includes("export function meta");
+}
+function extractFrontmatterValue(code, key) {
+	const frontmatterStart = code.indexOf("export const frontmatter");
+	if (frontmatterStart === -1) return;
+	const valuePrefix = `${key}: "`;
+	const valueStart = code.indexOf(valuePrefix, frontmatterStart);
+	if (valueStart === -1) return;
+	const startIndex = valueStart + valuePrefix.length;
+	const endIndex = code.indexOf("\"", startIndex);
+	if (endIndex === -1) return;
+	return code.slice(startIndex, endIndex);
+}
+//#endregion
+//#region src/markdown/remark-callouts.ts
+const TYPE_MAP = {
+	NOTE: "Note",
+	TIP: "Tip",
+	IMPORTANT: "Info",
+	WARNING: "Warning",
+	CAUTION: "Danger"
+};
+const ALERT_REGEX = /^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\][ \t]*\r?\n?/i;
+function remarkCallouts() {
+	return function(tree) {
+		visit(tree, "blockquote", (node, index, parent) => {
+			if (parent == null || index == null) return;
+			const componentName = extractCalloutType(node);
+			if (componentName == null) return;
+			const replacement = {
+				type: "mdxJsxFlowElement",
+				name: componentName,
+				attributes: [],
+				children: node.children
+			};
+			parent.children[index] = replacement;
+		});
+	};
+}
+function extractCalloutType(node) {
+	const firstChild = node.children[0];
+	if (firstChild?.type !== "paragraph") return void 0;
+	const firstParaChild = firstChild.children[0];
+	if (firstParaChild?.type !== "text") return void 0;
+	const match = ALERT_REGEX.exec(firstParaChild.value);
+	if (match === null) return void 0;
+	const calloutName = TYPE_MAP[match[1].toUpperCase()];
+	firstParaChild.value = firstParaChild.value.slice(match[0].length);
+	if (firstParaChild.value === "") {
+		firstChild.children.shift();
+		stripLeadingBreak(firstChild.children);
+	}
+	if (firstChild.children.length === 0) node.children.shift();
+	return calloutName;
+}
+function stripLeadingBreak(children) {
+	if (children[0]?.type === "break") children.shift();
+}
+//#endregion
 //#region ../../node_modules/.pnpm/estree-util-value-to-estree@3.5.0/node_modules/estree-util-value-to-estree/dist/estree-util-value-to-estree.js
 /**
 * Create an ESTree identifier node for a given name.
@@ -2128,6 +2352,23 @@ function define(ast, file, variables, options) {
 	}
 }
 //#endregion
+//#region src/markdown/remark-mdx-handle.ts
+function remarkMdxHandle() {
+	return function(tree, file) {
+		const yamlNode = tree.children.find((node) => node.type === "yaml");
+		if (yamlNode === void 0) return;
+		const layout = extractLayoutValue(yamlNode.value);
+		if (layout === void 0) return;
+		define(tree, file, { handle: valueToEstree({ layout }) });
+	};
+}
+function extractLayoutValue(yaml) {
+	const match = /^layout:[ \t]+(\S.*)$/m.exec(yaml);
+	if (match === null) return void 0;
+	const raw = match[1].trim().replaceAll(/^["']|["']$/g, "");
+	if (raw === "bare" || raw === "default") return raw;
+}
+//#endregion
 //#region src/markdown/remark-mdx-toc.ts
 function remarkMdxToc(options = {}) {
 	const { name = "toc", levels = [2, 3] } = options;
@@ -2137,7 +2378,7 @@ function remarkMdxToc(options = {}) {
 		let headingIndex = 0;
 		visit(tree, "heading", (node) => {
 			if (node.depth < minLevel || node.depth > maxLevel) return;
-			const text = getHeadingText(node);
+			const text = getHeadingText$1(node);
 			const slug = slugify(text);
 			const id = slug === "" ? `heading-${String(headingIndex)}` : slug;
 			headingIndex++;
@@ -2152,10 +2393,10 @@ function remarkMdxToc(options = {}) {
 		define(tree, file, { [name]: valueToEstree(items) });
 	};
 }
-function getHeadingText(node) {
+function getHeadingText$1(node) {
 	const parts = [];
 	function extract(child) {
-		if (!isRecord(child)) return;
+		if (!isRecord$1(child)) return;
 		if (child.type === "text" || child.type === "inlineCode") parts.push(typeof child.value === "string" ? child.value : "");
 		else if (Array.isArray(child.children)) for (const nested of child.children) extract(nested);
 	}
@@ -2170,9 +2411,42 @@ function slugify(text) {
 function ensureHProperties(node) {
 	const data = node.data ?? {};
 	node.data = data;
-	if (!isRecord(data.hProperties)) data.hProperties = {};
+	if (!isRecord$1(data.hProperties)) data.hProperties = {};
 	return data.hProperties;
 }
+function isRecord$1(value) {
+	return value != null && typeof value === "object";
+}
+//#endregion
+//#region src/markdown/remark-strip-frontmatter-h1.ts
+function remarkStripFrontmatterH1() {
+	return function(tree) {
+		const yamlNode = tree.children.find((node) => node.type === "yaml");
+		if (yamlNode === void 0) return;
+		const title = extractYamlTitle(yamlNode.value);
+		if (title === "") return;
+		const firstH1Index = tree.children.findIndex((node) => node.type === "heading" && node.depth === 1);
+		if (firstH1Index === -1) return;
+		const h1Node = tree.children[firstH1Index];
+		if (h1Node.type !== "heading") return;
+		if (getHeadingText(h1Node).trim() === title) tree.children.splice(firstH1Index, 1);
+	};
+}
+function extractYamlTitle(yaml) {
+	const match = /^title:[ \t]+(\S.*)$/m.exec(yaml);
+	if (match === null) return "";
+	return match[1].trim().replaceAll(/^["']|["']$/g, "");
+}
+function getHeadingText(node) {
+	const parts = [];
+	function extract(child) {
+		if (!isRecord(child)) return;
+		if (child.type === "text" || child.type === "inlineCode") parts.push(typeof child.value === "string" ? child.value : "");
+		else if (Array.isArray(child.children)) for (const nested of child.children) extract(nested);
+	}
+	for (const child of node.children) extract(child);
+	return parts.join("");
+}
 function isRecord(value) {
 	return value != null && typeof value === "object";
 }
@@ -2327,8 +2601,11 @@ function createMdxPlugin(markdownConfig) {
 		include: /\.(md|mdx)$/,
 		remarkPlugins: [
 			remarkFrontmatter,
+			remarkStripFrontmatterH1,
 			[remarkMdxFrontmatter, { name: "frontmatter" }],
+			remarkMdxHandle,
 			remarkGfm,
+			remarkCallouts,
 			remarkCodeMeta,
 			[remarkMdxToc, { levels: markdownConfig?.toc?.level ?? [2, 3] }]
 		],
@@ -2692,13 +2969,38 @@ function formatTitle$1(name) {
 }
 //#endregion
 //#region src/vite/sidebar-index.ts
-async function generateSidebar$1(routesDir) {
+async function generateSidebar$1(routesDir, options = {}) {
 	try {
-		return (await scanSidebarDirectory(routesDir, routesDir)).map((node) => stripOrderFromNode(node));
+		const nodes = await scanSidebarDirectory(routesDir, routesDir);
+		sortNodesBySectionOrder(nodes, options.sectionOrder);
+		return nodes.map((node) => stripOrderFromNode(node));
 	} catch {
 		return [];
 	}
 }
+/**
+* Build one sidebar tree per top-level routes folder.
+*
+* The flat `generateSidebar` returns a single nested array — fine for sites
+* where everything lives in one column. For context-driven sites (Guide vs.
+* API vs. …) each top-level folder gets its own subtree, keyed by folder
+* name (`guide`, `api-reference`, …). Top-level files like `home.tsx` are
+* skipped — they belong to a bare layout, not a sidebar context.
+*/
+async function generateContextSidebars(routesDir) {
+	try {
+		const entries = await fs.readdir(routesDir, { withFileTypes: true });
+		const sidebars = {};
+		for (const entry of entries) {
+			if (!entry.isDirectory()) continue;
+			const nodes = await scanSidebarDirectory(path.join(routesDir, entry.name), routesDir);
+			if (nodes.length > 0) sidebars[entry.name] = nodes.map((node) => stripOrderFromNode(node));
+		}
+		return sidebars;
+	} catch {
+		return {};
+	}
+}
 async function scanSidebarDirectory(dir, rootDir) {
 	const entries = await fs.readdir(dir, { withFileTypes: true });
 	const nodes = [];
@@ -2718,32 +3020,68 @@ async function scanSidebarDirectory(dir, rootDir) {
 }
 async function createDirectoryNode(entry, fullPath, rootDir) {
 	const relativePath = path.relative(rootDir, fullPath);
+	const metadata = await readDirectoryIndexMetadata(fullPath);
+	if (metadata?.sidebar === false) return null;
+	const link = metadata == null ? void 0 : `/${relativePath.replaceAll("\\", "/")}`;
+	if (metadata?.sidebar === "leaf") {
+		if (link === void 0) return null;
+		return {
+			text: metadata.title ?? formatTitle(entry.name),
+			link,
+			order: metadata.order,
+			sectionId: entry.name
+		};
+	}
 	const children = await scanSidebarDirectory(fullPath, rootDir);
 	if (children.length === 0) return null;
-	const link = await fileExists(path.join(fullPath, "index.mdx")) ? `/${relativePath.replaceAll("\\", "/")}` : void 0;
 	return {
-		text: formatTitle(entry.name),
+		text: metadata?.title ?? formatTitle(entry.name),
 		link,
-		items: children
+		items: children,
+		collapsed: metadata?.collapsed,
+		order: metadata?.order,
+		sectionId: entry.name
 	};
 }
 async function createMarkdownNode(entry, fullPath, relativePath) {
 	if (!isSidebarMarkdownFile(entry.name)) return null;
 	const extension = entry.name.endsWith(".mdx") ? ".mdx" : ".md";
 	const frontmatter = readFrontmatter(await fs.readFile(fullPath, "utf8"));
+	if (frontmatter.sidebar === false) return null;
 	return {
 		text: frontmatter.title ?? formatTitle(entry.name.replace(extension, "")),
 		link: `/${relativePath.replace(extension, "").replaceAll("\\", "/")}`,
-		order: frontmatter.order
+		order: frontmatter.order,
+		sectionId: entry.name.replace(extension, "")
 	};
 }
+async function readDirectoryIndexMetadata(fullPath) {
+	for (const indexFileName of ["index.mdx", "index.md"]) {
+		const metadata = await readFrontmatterFile(path.join(fullPath, indexFileName));
+		if (metadata != null) return metadata;
+	}
+	return null;
+}
+async function readFrontmatterFile(filePath) {
+	try {
+		return readFrontmatter(await fs.readFile(filePath, "utf8"));
+	} catch {
+		return null;
+	}
+}
 function readFrontmatter(fileContent) {
 	const parsed = matter(fileContent);
 	return {
 		title: typeof parsed.data.title === "string" ? parsed.data.title : void 0,
-		order: typeof parsed.data.order === "number" ? parsed.data.order : void 0
+		order: typeof parsed.data.order === "number" ? parsed.data.order : void 0,
+		collapsed: typeof parsed.data.collapsed === "boolean" ? parsed.data.collapsed : void 0,
+		sidebar: parseSidebarValue(parsed.data.sidebar)
 	};
 }
+function parseSidebarValue(raw) {
+	if (typeof raw === "boolean") return raw;
+	if (raw === "leaf") return "leaf";
+}
 function sortNodes(nodes) {
 	nodes.sort((leftNode, rightNode) => {
 		if (leftNode.order != null && rightNode.order != null) return leftNode.order - rightNode.order;
@@ -2752,6 +3090,23 @@ function sortNodes(nodes) {
 		return leftNode.text.localeCompare(rightNode.text);
 	});
 }
+function sortNodesBySectionOrder(nodes, sectionOrder) {
+	if (sectionOrder == null || sectionOrder.length === 0) return;
+	const sectionOrderMap = /* @__PURE__ */ new Map();
+	for (const [index, section] of sectionOrder.entries()) {
+		const normalizedSection = normalizeSectionId(section);
+		if (normalizedSection !== "" && !sectionOrderMap.has(normalizedSection)) sectionOrderMap.set(normalizedSection, index);
+	}
+	if (sectionOrderMap.size === 0) return;
+	nodes.sort((leftNode, rightNode) => {
+		const leftIndex = sectionOrderMap.get(leftNode.sectionId);
+		const rightIndex = sectionOrderMap.get(rightNode.sectionId);
+		if (leftIndex != null && rightIndex != null) return leftIndex - rightIndex;
+		if (leftIndex != null) return -1;
+		if (rightIndex != null) return 1;
+		return 0;
+	});
+}
 function isSidebarMarkdownFile(fileName) {
 	return (fileName.endsWith(".mdx") || fileName.endsWith(".md")) && !(fileName === "index.mdx" || fileName === "index.md");
 }
@@ -2762,36 +3117,80 @@ function stripOrderFromNode(node) {
 	return {
 		text: node.text,
 		link: node.link,
+		collapsed: node.collapsed,
 		items: node.items?.map((item) => stripOrderFromNode(item))
 	};
 }
-async function fileExists(filePath) {
-	try {
-		await fs.access(filePath);
-		return true;
-	} catch {
-		return false;
-	}
+function normalizeSectionId(section) {
+	const normalizedSection = section.replaceAll("\\", "/");
+	let startIndex = 0;
+	let endIndex = normalizedSection.length;
+	while (startIndex < endIndex && normalizedSection[startIndex] === "/") startIndex += 1;
+	while (endIndex > startIndex && normalizedSection[endIndex - 1] === "/") endIndex -= 1;
+	return normalizedSection.slice(startIndex, endIndex);
+}
+//#endregion
+//#region src/vite/typedoc-plugin.ts
+let typedocGenerated = false;
+function resolveTypedocConfig(typedoc) {
+	if (typedoc == null) return;
+	const packageRoot = findPackageRoot(process.cwd());
+	const defaultEntryPoint = packageRoot != null ? `${packageRoot}/src/index.ts` : "./src/index.ts";
+	const defaultTsconfig = packageRoot != null ? `${packageRoot}/tsconfig.json` : "./tsconfig.json";
+	const defaults = {
+		enabled: true,
+		entryPoints: [defaultEntryPoint],
+		tsconfig: defaultTsconfig,
+		out: "api-reference",
+		excludePrivate: true,
+		excludeInternal: true
+	};
+	return typedoc === true ? defaults : {
+		...defaults,
+		...typedoc
+	};
+}
+function createTypeDocPlugin(typedocConfig, routesDir) {
+	return {
+		name: "ardo:typedoc",
+		async buildStart() {
+			if (!typedocConfig.enabled || typedocGenerated) return;
+			typedocGenerated = true;
+			console.log("[ardo] Generating API documentation with TypeDoc...");
+			const startTime = Date.now();
+			try {
+				const docs = await generateApiDocs(typedocConfig, routesDir);
+				const duration = Date.now() - startTime;
+				console.log(`[ardo] Generated ${docs.length} API documentation pages in ${duration}ms`);
+			} catch (error) {
+				console.warn("[ardo] TypeDoc generation failed. API documentation will not be available.");
+				console.warn("[ardo] Check your typedoc.entryPoints configuration.");
+				if (error instanceof Error) console.warn(`[ardo] Error: ${error.message}`);
+			}
+		}
+	};
 }
 //#endregion
 //#region src/vite/plugin.ts
 const VIRTUAL_MODULE_ID = "virtual:ardo/config";
 const VIRTUAL_SIDEBAR_ID = "virtual:ardo/sidebar";
+const VIRTUAL_SIDEBARS_ID = "virtual:ardo/sidebars";
 const VIRTUAL_SEARCH_ID = "virtual:ardo/search-index";
 const RESOLVED_IDS = {
 	[VIRTUAL_MODULE_ID]: `\0${VIRTUAL_MODULE_ID}`,
 	[VIRTUAL_SIDEBAR_ID]: `\0${VIRTUAL_SIDEBAR_ID}`,
+	[VIRTUAL_SIDEBARS_ID]: `\0${VIRTUAL_SIDEBARS_ID}`,
 	[VIRTUAL_SEARCH_ID]: `\0${VIRTUAL_SEARCH_ID}`
 };
-let typedocGenerated = false;
 function ardoPlugin(options = {}) {
-	const { routes, typedoc, githubPages = true, routesDir: routesDirOption, ...pressConfig } = options;
+	const { icons = {}, routes, typedoc, githubPages = true, routesDir: routesDirOption, ...pressConfig } = options;
 	const state = { routesDir: resolveRoutesDir(process.cwd(), routesDirOption) };
 	const plugins = [createMainPlugin(state, {
 		githubPages,
 		pressConfig,
 		routesDirOption
 	})];
+	plugins.push(...createIconsPlugin(icons));
 	addRoutesPlugin(plugins, routes, routesDirOption);
 	addTypeDocPlugin(plugins, typedoc, state);
 	plugins.push(ardoCodeBlockPlugin(pressConfig.markdown));
@@ -2811,7 +3210,7 @@ function addRoutesPlugin(plugins, routes, routesDirOption) {
 }
 function addTypeDocPlugin(plugins, typedoc, state) {
 	const typedocConfig = resolveTypedocConfig(typedoc);
-	if (typedocConfig != null) plugins.unshift(createTypeDocPlugin(typedocConfig, state));
+	if (typedocConfig != null) plugins.unshift(createTypeDocPlugin(typedocConfig, state.routesDir));
 }
 function createMainPlugin(state, options) {
 	return {
@@ -2889,92 +3288,18 @@ async function loadVirtualModule(id, state) {
 		return `export default ${JSON.stringify(clientConfig)}`;
 	}
 	if (id === RESOLVED_IDS[VIRTUAL_SIDEBAR_ID]) {
-		const sidebar = await generateSidebar$1(state.routesDir);
+		const sidebar = await generateSidebar$1(state.routesDir, state.resolvedConfig.sidebar);
 		return `export default ${JSON.stringify(sidebar)}`;
 	}
+	if (id === RESOLVED_IDS[VIRTUAL_SIDEBARS_ID]) {
+		const sidebars = await generateContextSidebars(state.routesDir);
+		return `export default ${JSON.stringify(sidebars)}`;
+	}
 	if (id === RESOLVED_IDS[VIRTUAL_SEARCH_ID]) {
 		const searchIndex = await generateSearchIndex(state.routesDir);
 		return `export default ${JSON.stringify(searchIndex)}`;
 	}
 }
-function transformMarkdownMeta(code, id, state) {
-	if (!shouldInjectMeta(code, id, state)) return;
-	const pageTitle = extractFrontmatterValue(code, "title");
-	if (pageTitle == null || pageTitle === "") return;
-	return {
-		code: `${code}\nexport const meta = () => [${buildMetaEntries({
-			pageTitle,
-			siteTitle: state.resolvedConfig?.title ?? "Ardo",
-			titleSeparator: state.resolvedConfig?.titleSeparator ?? " | ",
-			description: extractFrontmatterValue(code, "description")
-		}).join(", ")}];\n`,
-		map: null
-	};
-}
-function shouldInjectMeta(code, id, state) {
-	return isMarkdownFile(id) && id.startsWith(state.routesDir) && !hasMetaExport(code);
-}
-function buildMetaEntries(input) {
-	const fullTitle = `${input.pageTitle}${input.titleSeparator}${input.siteTitle}`;
-	const entries = [`{ title: ${JSON.stringify(fullTitle)} }`];
-	if (input.description != null && input.description !== "") entries.push(`{ name: "description", content: ${JSON.stringify(input.description)} }`);
-	return entries;
-}
-function isMarkdownFile(id) {
-	return id.endsWith(".md") || id.endsWith(".mdx");
-}
-function hasMetaExport(code) {
-	return code.includes("export const meta") || code.includes("export function meta");
-}
-function extractFrontmatterValue(code, key) {
-	const frontmatterStart = code.indexOf("export const frontmatter");
-	if (frontmatterStart === -1) return;
-	const valuePrefix = `${key}: "`;
-	const valueStart = code.indexOf(valuePrefix, frontmatterStart);
-	if (valueStart === -1) return;
-	const startIndex = valueStart + valuePrefix.length;
-	const endIndex = code.indexOf("\"", startIndex);
-	if (endIndex === -1) return;
-	return code.slice(startIndex, endIndex);
-}
-function resolveTypedocConfig(typedoc) {
-	if (typedoc == null) return;
-	const packageRoot = findPackageRoot(process.cwd());
-	const defaultEntryPoint = packageRoot != null ? `${packageRoot}/src/index.ts` : "./src/index.ts";
-	const defaultTsconfig = packageRoot != null ? `${packageRoot}/tsconfig.json` : "./tsconfig.json";
-	const defaults = {
-		enabled: true,
-		entryPoints: [defaultEntryPoint],
-		tsconfig: defaultTsconfig,
-		out: "api-reference",
-		excludePrivate: true,
-		excludeInternal: true
-	};
-	return typedoc === true ? defaults : {
-		...defaults,
-		...typedoc
-	};
-}
-function createTypeDocPlugin(typedocConfig, state) {
-	return {
-		name: "ardo:typedoc",
-		async buildStart() {
-			if (!typedocConfig.enabled || typedocGenerated) return;
-			typedocGenerated = true;
-			console.log("[ardo] Generating API documentation with TypeDoc...");
-			const startTime = Date.now();
-			try {
-				const docs = await generateApiDocs(typedocConfig, state.routesDir);
-				const duration = Date.now() - startTime;
-				console.log(`[ardo] Generated ${docs.length} API documentation pages in ${duration}ms`);
-			} catch (error) {
-				console.warn("[ardo] TypeDoc generation failed. API documentation will not be available.");
-				console.warn("[ardo] Check your typedoc.entryPoints configuration.");
-				if (error instanceof Error) console.warn(`[ardo] Error: ${error.message}`);
-			}
-		}
-	};
-}
 function resolveRoutesDir(root, routesDirOption) {
 	return routesDirOption ?? path.join(root, "app", "routes");
 }