ardo 3.3.0 → 3.4.0

package/dist/vite/index.js

@@ -1,6 +1,6 @@
 import { defaultMarkdownConfig, resolveConfig } from "../config/index.js";
 import { n as ARDO_FAVICON_SVG } from "../favicon-Cx-inut3.js";
-import { n as generateApiDocs } from "../generator-DX0PP1xf.js";
+import { n as generateApiDocs } from "../generator-CYSyo4Vz.js";
 import path from "node:path";
 import matter from "gray-matter";
 import rehypeStringify from "rehype-stringify";
@@ -221,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);
@@ -255,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
@@ -287,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";
 }
 /**
@@ -323,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 : "";
 }
@@ -409,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++;
@@ -424,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) => {
@@ -482,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
@@ -516,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
@@ -680,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) {
@@ -1273,6 +1273,51 @@ function extractFrontmatterValue(code, key) {
 	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.
@@ -2307,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;
@@ -2316,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++;
@@ -2331,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);
 	}
@@ -2349,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";
 }
@@ -2506,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] }]
 		],
@@ -2880,6 +2978,29 @@ async function generateSidebar$1(routesDir, options = {}) {
 		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 = [];
@@ -2899,10 +3020,20 @@ async function scanSidebarDirectory(dir, rootDir) {
 }
 async function createDirectoryNode(entry, fullPath, rootDir) {
 	const relativePath = path.relative(rootDir, fullPath);
-	const children = await scanSidebarDirectory(fullPath, rootDir);
-	if (children.length === 0) return null;
 	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;
 	return {
 		text: metadata?.title ?? formatTitle(entry.name),
 		link,
@@ -2944,9 +3075,13 @@ function readFrontmatter(fileContent) {
 		title: typeof parsed.data.title === "string" ? parsed.data.title : 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: typeof parsed.data.sidebar === "boolean" ? parsed.data.sidebar : 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;
@@ -3039,10 +3174,12 @@ function createTypeDocPlugin(typedocConfig, routesDir) {
 //#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}`
 };
 function ardoPlugin(options = {}) {
@@ -3154,6 +3291,10 @@ async function loadVirtualModule(id, state) {
 		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)}`;