@pagesmith/docs 0.1.0 → 0.3.0

package/dist/site-dJ3MiiW3.mjs

@@ -0,0 +1,1756 @@
+import { exec, execFileSync, execSync } from "child_process";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "fs";
+import JSON5 from "json5";
+import { basename, dirname, extname, join, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+import { copyPublicFiles } from "@pagesmith/core/assets";
+import { buildCss } from "@pagesmith/core/css";
+import { processMarkdown } from "@pagesmith/core/markdown";
+import { availableParallelism } from "os";
+import { z } from "zod";
+import { SKIP, visit } from "unist-util-visit";
+import { createHash } from "crypto";
+import { Fragment, h } from "@pagesmith/core/jsx-runtime";
+import { createServer } from "http";
+import { createServer as createServer$1 } from "net";
+import { watch } from "chokidar";
+import { WebSocketServer } from "ws";
+//#region src/config.ts
+function defineDocsConfig(config) {
+	return config;
+}
+function loadDocsConfig(configPath) {
+	const resolvedConfigPath = resolve(configPath ?? join(process.cwd(), "pagesmith.config.json5"));
+	if (!existsSync(resolvedConfigPath)) return {};
+	return JSON5.parse(readFileSync(resolvedConfigPath, "utf-8"));
+}
+/** Prefix a path with a base path, avoiding double slashes. */
+function withBase(basePath, path) {
+	const base = basePath.replace(/\/+$/, "");
+	if (!base) return path;
+	if (path.startsWith(base)) return path;
+	return `${base}${path.startsWith("/") ? "" : "/"}${path}`;
+}
+/** Detect basePath and origin from git remote URL. */
+function detectGitOrigin(rootDir) {
+	try {
+		const remoteUrl = execSync("git remote get-url origin", {
+			cwd: rootDir,
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			encoding: "utf-8"
+		}).trim();
+		let match = remoteUrl.match(/github\.com[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+		if (match) {
+			const [, owner, repo] = match;
+			return {
+				basePath: `/${repo}`,
+				origin: `https://${owner}.github.io`,
+				repoName: repo,
+				editLinkHost: "github"
+			};
+		}
+		match = remoteUrl.match(/gitlab\.com[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+		if (match) {
+			const [, owner, repo] = match;
+			return {
+				basePath: `/${repo}`,
+				origin: `https://${owner}.gitlab.io`,
+				repoName: repo,
+				editLinkHost: "gitlab"
+			};
+		}
+		match = remoteUrl.match(/bitbucket\.org[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
+		if (match) {
+			const [, , repo] = match;
+			return {
+				basePath: `/${repo}`,
+				repoName: repo,
+				editLinkHost: "bitbucket"
+			};
+		}
+	} catch {}
+}
+function readPackageJson(rootDir) {
+	const pkgPath = join(rootDir, "package.json");
+	if (!existsSync(pkgPath)) return void 0;
+	try {
+		return JSON.parse(readFileSync(pkgPath, "utf-8"));
+	} catch {
+		return;
+	}
+}
+function resolveContentDir(rootDir, explicit) {
+	if (explicit) return resolve(rootDir, explicit);
+	const docsDir = resolve(rootDir, "docs");
+	if (existsSync(docsDir)) return docsDir;
+	return resolve(rootDir, "content");
+}
+function resolveDocsConfig(configPath, overrides) {
+	const resolvedConfigPath = resolve(configPath ?? join(process.cwd(), "pagesmith.config.json5"));
+	const rootDir = dirname(resolvedConfigPath);
+	const userConfig = loadDocsConfig(resolvedConfigPath);
+	const packageName = basename(rootDir);
+	const pkg = readPackageJson(rootDir);
+	const pkgDisplayName = pkg?.name?.replace(/^@[^/]+\//, "");
+	const gitInfo = detectGitOrigin(rootDir);
+	const basePath = (overrides?.basePath ?? process.env.BASE_URL ?? userConfig.basePath ?? gitInfo?.basePath ?? "/").replace(/\/+$/, "");
+	const contentDir = resolveContentDir(rootDir, userConfig.contentDir);
+	const publicDir = resolve(rootDir, userConfig.publicDir ?? "public");
+	let resolvedFavicon;
+	let resolvedFaviconFallback = false;
+	if (userConfig.favicon === false) resolvedFavicon = false;
+	else if (typeof userConfig.favicon === "string") resolvedFavicon = resolve(rootDir, userConfig.favicon);
+	else {
+		const svgPath = join(publicDir, "favicon.svg");
+		const icoPath = join(publicDir, "favicon.ico");
+		if (existsSync(svgPath)) {
+			resolvedFavicon = svgPath;
+			if (existsSync(icoPath)) resolvedFaviconFallback = icoPath;
+		} else if (existsSync(icoPath)) resolvedFavicon = icoPath;
+		else resolvedFavicon = join(dirname(fileURLToPath(import.meta.resolve("@pagesmith/core/package.json"))), "assets", "favicon.svg");
+	}
+	const appleTouchIconPath = join(publicDir, "apple-touch-icon.png");
+	const resolvedAppleTouchIcon = existsSync(appleTouchIconPath) ? appleTouchIconPath : false;
+	const assets = /* @__PURE__ */ new Map();
+	if (userConfig.assets) for (const [outputPath, sources] of Object.entries(userConfig.assets)) {
+		const resolved = sources.map((source) => resolve(rootDir, source));
+		assets.set(outputPath, resolved);
+	}
+	let socialImage;
+	if (userConfig.theme?.socialImage) socialImage = userConfig.theme.socialImage;
+	else for (const ext of [
+		"png",
+		"jpg",
+		"jpeg"
+	]) if (existsSync(join(publicDir, `og-image.${ext}`))) {
+		socialImage = `og-image.${ext}`;
+		break;
+	}
+	let editLink;
+	if (userConfig.editLink) {
+		const repo = userConfig.editLink.repo.replace(/\/+$/, "");
+		const branch = userConfig.editLink.branch ?? "main";
+		const label = userConfig.editLink.label ?? "Edit this page";
+		let editPattern;
+		if (repo.includes("gitlab.com") || repo.includes("gitlab.")) editPattern = `${repo}/-/edit/${branch}`;
+		else if (repo.includes("bitbucket.org") || repo.includes("bitbucket.")) editPattern = `${repo}/src/${branch}`;
+		else editPattern = `${repo}/edit/${branch}`;
+		editLink = {
+			repo,
+			branch,
+			label,
+			editPattern
+		};
+	}
+	return {
+		rootDir,
+		contentDir,
+		outDir: overrides?.outDir ?? resolve(rootDir, userConfig.outDir ?? "gh-pages"),
+		publicDir,
+		basePath,
+		homeLink: userConfig.homeLink,
+		name: userConfig.name ?? userConfig.title ?? pkgDisplayName ?? packageName,
+		title: userConfig.title ?? userConfig.name ?? pkgDisplayName ?? packageName,
+		description: userConfig.description ?? pkg?.description ?? "Documentation site powered by @pagesmith/docs",
+		origin: userConfig.origin ?? pkg?.homepage ?? gitInfo?.origin ?? "https://example.com",
+		language: userConfig.language ?? "en",
+		footerLinks: userConfig.footerLinks ?? [],
+		search: {
+			enabled: userConfig.search?.enabled ?? true,
+			showImages: userConfig.search?.showImages ?? false,
+			showSubResults: userConfig.search?.showSubResults ?? true,
+			pagefindFlags: userConfig.search?.pagefindFlags ?? []
+		},
+		sidebar: { collapsible: userConfig.sidebar?.collapsible ?? true },
+		favicon: resolvedFavicon,
+		faviconFallback: resolvedFaviconFallback,
+		appleTouchIcon: resolvedAppleTouchIcon,
+		editLink,
+		lastUpdated: userConfig.lastUpdated ?? false,
+		sitemap: userConfig.sitemap ?? true,
+		socialImage,
+		theme: userConfig.theme,
+		analytics: userConfig.analytics,
+		markdown: userConfig.markdown,
+		homeConfigFile: userConfig.home?.configFile ? resolve(rootDir, userConfig.home.configFile) : resolve(rootDir, contentDir, "home.json5"),
+		packages: userConfig.packages,
+		server: {
+			devPort: userConfig.server?.devPort ?? 3e3,
+			previewPort: userConfig.server?.previewPort ?? 4e3,
+			strictPort: userConfig.server?.strictPort ?? false
+		},
+		assets,
+		_userConfig: userConfig
+	};
+}
+function readJson5File(filePath) {
+	if (!existsSync(filePath)) return void 0;
+	return JSON5.parse(readFileSync(filePath, "utf-8"));
+}
+function toTitleCase(value) {
+	return value.replace(/[-_]/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function getPackageDir() {
+	return resolve(import.meta.dirname, "..");
+}
+function getThemeRoot() {
+	return resolve(getPackageDir(), "theme");
+}
+function getThemeStylesEntry() {
+	return resolve(getThemeRoot(), "styles/main.css");
+}
+function getThemeRuntimeEntry() {
+	return resolve(getThemeRoot(), "runtime/main.ts");
+}
+/**
+* Validate a resolved docs config. Returns issues found.
+* Checks required fields, verifies referenced directories and asset files exist.
+*/
+function validateConfig(config) {
+	const issues = [];
+	const uc = config._userConfig;
+	const hasExplicitName = uc ? !!(uc.name || uc.title) : config.name !== basename(config.rootDir);
+	const hasExplicitTitle = uc ? !!(uc.title || uc.name) : config.title !== basename(config.rootDir);
+	if (!hasExplicitName) issues.push({
+		field: "name",
+		message: "Missing \"name\" in pagesmith.config.json5 — using directory name as fallback.",
+		severity: "warn"
+	});
+	if (!hasExplicitTitle) issues.push({
+		field: "title",
+		message: "Missing \"title\" in pagesmith.config.json5 — using directory name as fallback.",
+		severity: "warn"
+	});
+	if (config.description === "Documentation site powered by @pagesmith/docs") issues.push({
+		field: "description",
+		message: "Missing \"description\" in pagesmith.config.json5 — using default placeholder.",
+		severity: "warn"
+	});
+	if (config.origin === "https://example.com") issues.push({
+		field: "origin",
+		message: "Missing \"origin\" in pagesmith.config.json5 — canonical URLs will use https://example.com. Set this to your production URL.",
+		severity: "warn"
+	});
+	if (!existsSync(config.contentDir)) issues.push({
+		field: "contentDir",
+		message: `Content directory does not exist: ${config.contentDir}`,
+		severity: "error"
+	});
+	if (!existsSync(config.publicDir)) {}
+	for (const [outputPath, sources] of config.assets) for (const sourcePath of sources) if (!existsSync(sourcePath)) issues.push({
+		field: `assets["${outputPath}"]`,
+		message: `Asset source does not exist: ${sourcePath}`,
+		severity: "error"
+	});
+	if (typeof config.favicon === "string" && !existsSync(config.favicon)) issues.push({
+		field: "favicon",
+		message: `Favicon file does not exist: ${config.favicon}`,
+		severity: "warn"
+	});
+	if (config.theme?.layouts) for (const [layoutName, layoutPath] of Object.entries(config.theme.layouts)) {
+		const resolvedLayout = resolve(config.rootDir, layoutPath);
+		if (!existsSync(resolvedLayout)) issues.push({
+			field: `theme.layouts.${layoutName}`,
+			message: `Layout file does not exist: ${resolvedLayout}`,
+			severity: "error"
+		});
+	}
+	return issues;
+}
+/**
+* Log validation issues to console. Returns true if there are any errors (severity: 'error').
+*/
+function reportConfigIssues(issues) {
+	let hasErrors = false;
+	for (const issue of issues) if (issue.severity === "error") {
+		console.error(`\x1b[31m✗ [${issue.field}]\x1b[0m ${issue.message}`);
+		hasErrors = true;
+	} else console.warn(`\x1b[33m⚠ [${issue.field}]\x1b[0m ${issue.message}`);
+	return hasErrors;
+}
+//#endregion
+//#region src/markdown/plugins/rehype-asset-transform.ts
+/**
+* Rehype plugin: transform relative asset references to /assets/ URLs.
+*
+* Converts references like `./image.png` or `./assets/image.png`
+* into site-relative URLs like `/assets/image.png`.
+*
+* Special handling:
+*   - `.inline.svg` files: read from disk and embed as inline SVG (supports currentColor)
+*   - `.invert.` files: add `invert-on-dark` class for CSS dark-mode inversion
+*
+* Handles <img src="...">, <source srcset="...">, and <a href="..."> for asset files.
+*/
+const ASSET_EXTS = /\.(svg|png|jpg|jpeg|gif|webp|avif|ico)$/i;
+function rehypeAssetTransform(options = {}) {
+	return (tree) => {
+		visit(tree, "element", (node, index, parent) => {
+			if (node.tagName === "img") {
+				const src = node.properties?.src;
+				if (typeof src !== "string" || !src.startsWith("./") || !ASSET_EXTS.test(src)) return;
+				if (src.endsWith(".inline.svg") && options.contentDir) {
+					const filePath = join(options.contentDir, src.replace("./", ""));
+					if (existsSync(filePath)) {
+						let svgContent = readFileSync(filePath, "utf-8");
+						svgContent = svgContent.replace(/<\?xml[^?]*\?>\s*/g, "");
+						svgContent = svgContent.replace(/<!DOCTYPE[^>]*>\s*/g, "");
+						const alt = node.properties?.alt || "";
+						svgContent = svgContent.replace("<svg", `<svg role="img" aria-label="${String(alt).replace(/"/g, "&quot;")}" class="inline-svg"`);
+						if (parent && index !== void 0) {
+							parent.children[index] = {
+								type: "raw",
+								value: svgContent
+							};
+							return SKIP;
+						}
+					}
+				}
+				node.properties = node.properties || {};
+				node.properties.src = `/assets/${basename(src)}`;
+				if (basename(src).includes(".invert.")) {
+					const existing = node.properties.className;
+					node.properties.className = existing ? [...Array.isArray(existing) ? existing : [existing], "invert-on-dark"] : ["invert-on-dark"];
+				}
+			}
+			if (node.tagName === "source") {
+				const srcset = node.properties?.srcset;
+				if (typeof srcset === "string" && srcset.startsWith("./") && ASSET_EXTS.test(srcset)) {
+					node.properties = node.properties || {};
+					node.properties.srcset = `/assets/${basename(srcset)}`;
+				}
+			}
+			if (node.tagName === "a") {
+				const href = node.properties?.href;
+				if (typeof href === "string" && href.startsWith("./") && ASSET_EXTS.test(href)) {
+					node.properties = node.properties || {};
+					node.properties.href = `/assets/${basename(href)}`;
+				}
+			}
+		});
+	};
+}
+//#endregion
+//#region src/content.ts
+const DocsFrontmatterSchema = z.object({
+	title: z.string().optional(),
+	description: z.string().optional(),
+	navLabel: z.string().optional(),
+	sidebarLabel: z.string().optional(),
+	order: z.number().optional(),
+	draft: z.boolean().optional(),
+	socialImage: z.string().optional(),
+	hero: z.record(z.string(), z.any()).optional(),
+	features: z.array(z.record(z.string(), z.any())).optional()
+}).passthrough();
+const CONTENT_ASSET_EXTS = new Set([
+	".svg",
+	".png",
+	".jpg",
+	".jpeg",
+	".gif",
+	".webp",
+	".avif",
+	".ico"
+]);
+function toContentSlug(filePath, contentDir) {
+	const ext = extname(filePath);
+	let slug = relative(contentDir, filePath).replace(/\\/g, "/");
+	if (ext) slug = slug.slice(0, -ext.length);
+	if (slug === "README" || slug === "index") return "/";
+	if (slug.endsWith("/README")) slug = slug.slice(0, -7);
+	if (slug.endsWith("/index")) slug = slug.slice(0, -6);
+	return slug;
+}
+function loadRootMeta(contentDir) {
+	return readJson5File(join(contentDir, "meta.json5"));
+}
+function loadSectionMetas(contentDir) {
+	const metas = /* @__PURE__ */ new Map();
+	if (!existsSync(contentDir)) return metas;
+	for (const entry of readdirSync(contentDir, { withFileTypes: true })) {
+		if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
+		const meta = readJson5File(join(contentDir, entry.name, "meta.json5"));
+		if (meta) metas.set(entry.name, meta);
+	}
+	return metas;
+}
+function collectMarkdownFiles(contentDir) {
+	const files = [];
+	function walk(currentDir) {
+		for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
+			if (entry.name.startsWith(".")) continue;
+			const fullPath = join(currentDir, entry.name);
+			if (entry.isDirectory()) {
+				walk(fullPath);
+				continue;
+			}
+			if (entry.name.endsWith(".md")) files.push(fullPath);
+		}
+	}
+	if (existsSync(contentDir)) walk(contentDir);
+	return files.sort();
+}
+function createRelativeLinkTransform(filePath, contentDir, basePath) {
+	return () => (tree) => {
+		const visit = (node) => {
+			if (node?.type === "element" && node.tagName === "a") {
+				const href = node.properties?.href;
+				if (typeof href === "string" && href.includes(".md") && !href.startsWith("http")) {
+					const [rawPath, hash = ""] = href.split("#");
+					const slug = toContentSlug(join(dirname(filePath), rawPath), contentDir);
+					const fullPath = `${basePath}${slug === "/" ? "/" : `/${slug}/`}`;
+					node.properties = node.properties || {};
+					node.properties.href = hash ? `${fullPath}#${hash}` : fullPath;
+				} else if (basePath && typeof href === "string" && href.startsWith("/") && !href.startsWith("//") && !href.startsWith(basePath)) {
+					node.properties = node.properties || {};
+					node.properties.href = `${basePath}${href}`;
+				}
+			}
+			if (Array.isArray(node?.children)) for (const child of node.children) visit(child);
+		};
+		visit(tree);
+	};
+}
+/**
+* Run async tasks with bounded concurrency.
+* Prevents memory blowup when processing thousands of pages.
+*/
+async function mapWithConcurrency(items, concurrency, fn) {
+	const results = Array.from({ length: items.length });
+	let index = 0;
+	async function worker() {
+		while (index < items.length) {
+			const i = index++;
+			results[i] = await fn(items[i]);
+		}
+	}
+	const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+	await Promise.all(workers);
+	return results;
+}
+/**
+* Get the git last-modified date for a file.
+* Returns ISO date string or undefined if git is unavailable or the file isn't tracked.
+*/
+function getGitLastUpdated(filePath) {
+	try {
+		return execFileSync("git", [
+			"log",
+			"-1",
+			"--format=%cI",
+			"--",
+			filePath
+		], {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		}).trim() || void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Generate breadcrumbs from a content slug.
+* Returns array of { label, path } from root to current page.
+*/
+function buildBreadcrumbs(contentSlug, title, basePath) {
+	if (contentSlug === "/") return [];
+	const segments = contentSlug.split("/");
+	const crumbs = [];
+	for (let i = 0; i < segments.length - 1; i++) {
+		const slug = segments.slice(0, i + 1).join("/");
+		crumbs.push({
+			label: toTitleCase(segments[i]),
+			path: `${basePath}/${slug}`
+		});
+	}
+	crumbs.push({
+		label: title,
+		path: ""
+	});
+	return crumbs;
+}
+async function loadDocsPages(config, sectionMetas) {
+	const homeConfig = config.homeConfigFile ? readJson5File(config.homeConfigFile) : void 0;
+	const results = await mapWithConcurrency(collectMarkdownFiles(config.contentDir), Math.max(1, availableParallelism() * 2), async (filePath) => {
+		const result = await processMarkdown(readFileSync(filePath, "utf-8"), {
+			...config.markdown ?? {},
+			shiki: {
+				themes: config.markdown?.shiki?.themes ?? {
+					light: "github-light",
+					dark: "github-dark"
+				},
+				defaultShowLineNumbers: config.markdown?.shiki?.defaultShowLineNumbers,
+				langAlias: config.markdown?.shiki?.langAlias
+			},
+			rehypePlugins: [
+				...config.markdown?.rehypePlugins ?? [],
+				[rehypeAssetTransform, { contentDir: dirname(filePath) }],
+				createRelativeLinkTransform(filePath, config.contentDir, config.basePath)
+			]
+		});
+		const parsedFrontmatter = DocsFrontmatterSchema.parse(result.frontmatter ?? {});
+		const contentSlug = toContentSlug(filePath, config.contentDir);
+		const isHome = contentSlug === "/";
+		const frontmatter = isHome && homeConfig ? {
+			...homeConfig,
+			...parsedFrontmatter
+		} : parsedFrontmatter;
+		if (frontmatter.draft) return null;
+		const routePath = isHome ? "/" : `/${contentSlug}`;
+		const section = isHome ? void 0 : contentSlug.split("/")[0];
+		const title = frontmatter.title ?? (isHome ? config.title : toTitleCase(contentSlug.split("/").at(-1) ?? section ?? "Home"));
+		const sectionMeta = section ? sectionMetas?.get(section) : void 0;
+		const isLanding = section != null && contentSlug === section;
+		let layoutName;
+		if (isHome) layoutName = "home";
+		else if (isLanding && sectionMeta?.layout) layoutName = sectionMeta.layout;
+		else if (!isLanding && sectionMeta?.itemLayout) layoutName = sectionMeta.itemLayout;
+		else layoutName = "page";
+		const lastUpdated = config.lastUpdated ? getGitLastUpdated(filePath) : void 0;
+		return {
+			title,
+			routePath,
+			contentSlug,
+			section,
+			frontmatter,
+			html: result.html,
+			headings: result.headings,
+			sourcePath: filePath,
+			isHome,
+			layoutName,
+			lastUpdated
+		};
+	});
+	const pages = [];
+	for (const result of results) if (result != null) pages.push(result);
+	return pages.sort((left, right) => left.routePath.localeCompare(right.routePath));
+}
+function collectContentAssets(contentDir) {
+	const assets = /* @__PURE__ */ new Map();
+	function walk(currentDir) {
+		if (!existsSync(currentDir)) return;
+		for (const entry of readdirSync(currentDir, { withFileTypes: true })) {
+			if (entry.name.startsWith(".")) continue;
+			const fullPath = join(currentDir, entry.name);
+			if (entry.isDirectory()) {
+				walk(fullPath);
+				continue;
+			}
+			if (!CONTENT_ASSET_EXTS.has(extname(entry.name).toLowerCase())) continue;
+			if (assets.has(entry.name) && assets.get(entry.name) !== fullPath) console.warn(`pagesmith:docs duplicate companion asset basename "${entry.name}" detected; using ${fullPath}`);
+			assets.set(entry.name, fullPath);
+		}
+	}
+	walk(contentDir);
+	return assets;
+}
+//#endregion
+//#region src/navigation.ts
+function getOrder(page) {
+	return typeof page.frontmatter.order === "number" ? page.frontmatter.order : Number.MAX_SAFE_INTEGER;
+}
+function sortPages(pages) {
+	return [...pages].sort((left, right) => {
+		const orderDelta = getOrder(left) - getOrder(right);
+		if (orderDelta !== 0) return orderDelta;
+		return left.routePath.localeCompare(right.routePath);
+	});
+}
+function sortSectionPages(pages, meta) {
+	if (!meta?.orderBy) return sortPages(pages);
+	if (meta.orderBy === "publishedDate") {
+		const getPublishedTime = (value) => {
+			if (!value) return 0;
+			if (value instanceof Date) return value.getTime();
+			if (typeof value === "string" || typeof value === "number") return new Date(value).getTime();
+			return 0;
+		};
+		return [...pages].sort((a, b) => {
+			const dateA = getPublishedTime(a.frontmatter.publishedDate);
+			return getPublishedTime(b.frontmatter.publishedDate) - dateA;
+		});
+	}
+	if (meta.orderBy === "manual" && meta.items) {
+		const order = new Map(meta.items.map((slug, i) => [slug, i]));
+		return [...pages].sort((a, b) => {
+			const slugA = a.contentSlug.split("/").pop() ?? "";
+			const slugB = b.contentSlug.split("/").pop() ?? "";
+			return (order.get(slugA) ?? Number.MAX_SAFE_INTEGER) - (order.get(slugB) ?? Number.MAX_SAFE_INTEGER);
+		});
+	}
+	return sortPages(pages);
+}
+function buildSidebarWithSeries(sectionSlug, sectionPages, meta, basePath) {
+	const sections = [];
+	const pageBySlug = new Map(sectionPages.map((p) => [p.contentSlug.split("/").pop(), p]));
+	const landing = sectionPages.find((p) => p.contentSlug === sectionSlug);
+	for (const series of meta.series) {
+		for (const slug of series.articles) if (!pageBySlug.has(slug)) console.warn(`\x1b[33m⚠ [${sectionSlug}]\x1b[0m Series "${series.displayName}" references article slug "${slug}" which does not match any loaded page.`);
+		const items = series.articles.map((slug) => pageBySlug.get(slug)).filter((p) => p != null).map((page) => ({
+			title: page.frontmatter.sidebarLabel ?? page.title,
+			path: `${basePath}${page.routePath}`
+		}));
+		if (items.length > 0) sections.push({
+			title: series.displayName,
+			slug: series.slug,
+			items
+		});
+	}
+	if (landing && sections.length > 0) sections[0].items.unshift({
+		title: landing.frontmatter.sidebarLabel ?? landing.title,
+		path: `${basePath}${landing.routePath}`
+	});
+	return sections;
+}
+function buildSidebarItems(sectionSlug, sectionPages, basePath, sectionMeta) {
+	const roots = /* @__PURE__ */ new Map();
+	const landingPage = sectionPages.find((page) => page.contentSlug === sectionSlug);
+	for (const page of sortSectionPages(sectionPages.filter((entry) => entry.contentSlug !== sectionSlug), sectionMeta)) {
+		const remainder = page.contentSlug.slice(sectionSlug.length + 1);
+		if (!remainder) continue;
+		const segments = remainder.split("/");
+		let level = roots;
+		let accumulated = sectionSlug;
+		for (const [index, segment] of segments.entries()) {
+			accumulated = `${accumulated}/${segment}`;
+			let node = level.get(segment);
+			if (!node) {
+				node = {
+					key: accumulated,
+					title: toTitleCase(segment),
+					path: `${basePath}${page.routePath}`,
+					order: getOrder(page),
+					children: /* @__PURE__ */ new Map()
+				};
+				level.set(segment, node);
+			}
+			if (index === segments.length - 1) {
+				node.title = page.frontmatter.sidebarLabel ?? page.title;
+				node.path = `${basePath}${page.routePath}`;
+				node.order = getOrder(page);
+			}
+			level = node.children;
+		}
+	}
+	const toItems = (nodes) => Array.from(nodes.values()).sort((left, right) => {
+		const orderDelta = left.order - right.order;
+		if (orderDelta !== 0) return orderDelta;
+		return left.title.localeCompare(right.title);
+	}).map((node) => ({
+		title: node.title,
+		path: node.path,
+		...node.children.size > 0 ? { children: toItems(node.children) } : {}
+	}));
+	const items = toItems(roots);
+	if (!landingPage) return items;
+	return [{
+		title: landingPage.frontmatter.sidebarLabel ?? landingPage.title,
+		path: `${basePath}${landingPage.routePath}`
+	}, ...items];
+}
+/**
+* Find the first content page in a section, respecting meta ordering.
+* Excludes the landing page (README.md) itself — returns the first "child" page.
+*/
+function findFirstSectionPage(sectionSlug, sectionPages, meta) {
+	const nonLanding = sectionPages.filter((p) => p.contentSlug !== sectionSlug);
+	if (nonLanding.length === 0) return void 0;
+	if (meta?.orderBy === "manual" && meta.series && meta.series.length > 0) {
+		const pageBySlug = new Map(nonLanding.map((p) => [p.contentSlug.split("/").pop(), p]));
+		for (const series of meta.series) for (const slug of series.articles) {
+			const page = pageBySlug.get(slug);
+			if (page) return page;
+		}
+	}
+	if (meta?.orderBy === "manual" && meta.items && meta.items.length > 0) {
+		const pageBySlug = new Map(nonLanding.map((p) => [p.contentSlug.split("/").pop(), p]));
+		for (const slug of meta.items) {
+			const page = pageBySlug.get(slug);
+			if (page) return page;
+		}
+	}
+	return sortSectionPages(nonLanding, meta)[0];
+}
+function buildSiteModel(config, pages, rootMeta, sectionMetas) {
+	const pageByPath = new Map(pages.map((page) => [page.routePath, page]));
+	const sidebarBySection = /* @__PURE__ */ new Map();
+	const navItems = [];
+	const pagesBySection = /* @__PURE__ */ new Map();
+	for (const page of pages) {
+		if (!page.section) continue;
+		if (page.frontmatter.draft) continue;
+		if (!pagesBySection.has(page.section)) pagesBySection.set(page.section, []);
+		pagesBySection.get(page.section).push(page);
+	}
+	for (const [sectionSlug, sectionPages] of Array.from(pagesBySection.entries()).sort((a, b) => a[0].localeCompare(b[0]))) {
+		const sectionMeta = sectionMetas?.get(sectionSlug);
+		const landingPage = sectionPages.find((page) => page.contentSlug === sectionSlug);
+		const firstPage = findFirstSectionPage(sectionSlug, sectionPages, sectionMeta);
+		const label = sectionMeta?.displayName ?? config.packages?.[sectionSlug]?.label ?? landingPage?.frontmatter.navLabel ?? landingPage?.title ?? firstPage?.frontmatter.navLabel ?? toTitleCase(sectionSlug);
+		const sectionPath = landingPage?.routePath ?? firstPage?.routePath ?? `/${sectionSlug}`;
+		if (!rootMeta?.headerLinks || rootMeta.headerLinks.length === 0) navItems.push({
+			label,
+			path: `${config.basePath}${sectionPath}`
+		});
+		if (sectionMeta?.series && sectionMeta.series.length > 0) sidebarBySection.set(sectionSlug, buildSidebarWithSeries(sectionSlug, sectionPages, sectionMeta, config.basePath));
+		else sidebarBySection.set(sectionSlug, [{
+			title: label,
+			slug: sectionSlug,
+			collapsed: sectionMeta?.collapsed,
+			items: buildSidebarItems(sectionSlug, sectionPages, config.basePath, sectionMeta)
+		}]);
+	}
+	if (rootMeta?.headerLinks && rootMeta.headerLinks.length > 0) for (const link of rootMeta.headerLinks) {
+		const rawPath = link.path.startsWith("/") ? link.path : `/${link.path}`;
+		const sectionSlug = rawPath.replace(/^\//, "").replace(/\/.*$/, "");
+		const sectionPages = pagesBySection.get(sectionSlug);
+		let resolvedPath = rawPath;
+		if (sectionPages) {
+			const landing = sectionPages.find((p) => p.contentSlug === sectionSlug);
+			if (landing) resolvedPath = landing.routePath;
+			else {
+				const first = findFirstSectionPage(sectionSlug, sectionPages, sectionMetas?.get(sectionSlug));
+				if (first) resolvedPath = first.routePath;
+			}
+		}
+		navItems.push({
+			label: link.label,
+			path: `${config.basePath}${resolvedPath}`
+		});
+	}
+	return {
+		navItems,
+		sidebarBySection,
+		pageByPath,
+		rootMeta,
+		sectionMetas: sectionMetas ?? /* @__PURE__ */ new Map()
+	};
+}
+function flattenSidebarItems(items) {
+	const flattened = [];
+	for (const item of items) {
+		flattened.push(item);
+		if (item.children) flattened.push(...flattenSidebarItems(item.children));
+	}
+	return flattened;
+}
+function getPrevNext(sidebarSections, routePath) {
+	if (!sidebarSections?.length) return {};
+	const flat = flattenSidebarItems(sidebarSections.flatMap((section) => section.items));
+	const index = flat.findIndex((item) => item.path === routePath);
+	if (index < 0) return {};
+	const prev = index > 0 ? flat[index - 1] : void 0;
+	const next = index < flat.length - 1 ? flat[index + 1] : void 0;
+	return {
+		prev: prev ? {
+			title: prev.title,
+			path: prev.path
+		} : void 0,
+		next: next ? {
+			title: next.title,
+			path: next.path
+		} : void 0
+	};
+}
+function getSitePayload(config, model) {
+	const base = config.basePath;
+	const rawFooterLinks = model.rootMeta?.footerLinks ?? config.footerLinks;
+	const footerLinks = base ? rawFooterLinks.map((link) => ({
+		...link,
+		path: link.path.startsWith("/") && !link.path.startsWith("//") && !link.path.startsWith(base) ? `${base}${link.path}` : link.path
+	})) : rawFooterLinks;
+	return {
+		origin: config.origin,
+		basePath: config.basePath,
+		homeLink: config.homeLink,
+		name: config.name,
+		title: config.title,
+		description: config.description,
+		language: config.language,
+		navItems: model.navItems,
+		footerLinks,
+		search: config.search,
+		sidebar: config.sidebar,
+		analytics: config.analytics,
+		theme: config.theme,
+		socialImage: config.socialImage ? config.socialImage.startsWith("http") ? config.socialImage : `${config.basePath}/${config.socialImage.replace(/^\//, "")}` : void 0,
+		favicon: config.favicon !== false ? `${config.basePath}/${basename(config.favicon)}` : false,
+		faviconFallback: config.faviconFallback ? `${config.basePath}/${basename(config.faviconFallback)}` : false,
+		appleTouchIcon: config.appleTouchIcon ? `${config.basePath}/apple-touch-icon.png` : false
+	};
+}
+//#endregion
+//#region theme/components/DocFooter.tsx
+function DocFooter({ prev, next, links, copyright }) {
+	const hasPrevNext = prev || next;
+	const year = (/* @__PURE__ */ new Date()).getFullYear();
+	return /* @__PURE__ */ h("footer", { class: "doc-footer" }, hasPrevNext ? /* @__PURE__ */ h("nav", {
+		class: "doc-footer-nav",
+		"aria-label": "Page navigation"
+	}, prev ? /* @__PURE__ */ h("a", {
+		href: prev.path + "/",
+		class: "doc-footer-link doc-footer-prev"
+	}, /* @__PURE__ */ h("span", { class: "doc-footer-label" }, "Previous"), /* @__PURE__ */ h("span", { class: "doc-footer-title" }, prev.title)) : /* @__PURE__ */ h("span", null), next ? /* @__PURE__ */ h("a", {
+		href: next.path + "/",
+		class: "doc-footer-link doc-footer-next"
+	}, /* @__PURE__ */ h("span", { class: "doc-footer-label" }, "Next"), /* @__PURE__ */ h("span", { class: "doc-footer-title" }, next.title)) : /* @__PURE__ */ h("span", null)) : null, links && links.length > 0 ? /* @__PURE__ */ h("nav", {
+		class: "doc-footer-links",
+		"aria-label": "Footer links"
+	}, links.map((link) => /* @__PURE__ */ h("a", { href: link.path }, link.label))) : null, copyright ? /* @__PURE__ */ h("p", { class: "doc-footer-copyright" }, "© ", copyright.startYear < year ? `${copyright.startYear}–${year}` : `${year}`, " ", copyright.holder) : null);
+}
+//#endregion
+//#region theme/components/DocHeader.tsx
+const hamburgerIcon = "<svg viewBox=\"0 0 20 20\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\"><path d=\"M3 5h14M3 10h14M3 15h14\"/></svg>";
+const searchIcon = "<svg viewBox=\"0 0 20 20\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\"><circle cx=\"8.5\" cy=\"8.5\" r=\"5.5\"/><path d=\"m13 13 4 4\"/></svg>";
+function DocHeader({ siteName, basePath, homeLink, navItems, slug, searchEnabled }) {
+	const homePath = homeLink || (basePath ? `${basePath}/` : "/");
+	const hasNav = navItems && navItems.length > 0;
+	const base = (basePath || "").replace(/\/+$/, "");
+	function isNavActive(itemPath) {
+		const section = (itemPath.startsWith(base) ? itemPath.slice(base.length) : itemPath).replace(/^\//, "").split("/")[0];
+		return slug.startsWith(`${base}/${section}`);
+	}
+	return /* @__PURE__ */ h("header", { class: "doc-header" }, /* @__PURE__ */ h("div", { class: "doc-header-inner" }, /* @__PURE__ */ h("div", { class: "doc-header-left" }, hasNav ? /* @__PURE__ */ h("button", {
+		type: "button",
+		class: "doc-sidebar-toggle",
+		"aria-label": "Toggle navigation",
+		"data-sidebar-toggle": "",
+		innerHTML: hamburgerIcon
+	}) : null, /* @__PURE__ */ h("a", {
+		href: homePath,
+		class: "doc-logo"
+	}, siteName)), hasNav ? /* @__PURE__ */ h("nav", { class: "doc-nav" }, navItems.map((item) => /* @__PURE__ */ h("a", {
+		href: item.path,
+		class: isNavActive(item.path) ? "active" : ""
+	}, item.label))) : null, searchEnabled ? /* @__PURE__ */ h("button", {
+		type: "button",
+		class: "doc-search-trigger",
+		"aria-label": "Search",
+		"data-search-trigger": ""
+	}, /* @__PURE__ */ h("span", {
+		class: "doc-search-icon",
+		innerHTML: searchIcon
+	}), /* @__PURE__ */ h("kbd", { class: "doc-search-shortcut" }, /* @__PURE__ */ h("span", { class: "doc-search-shortcut-key" }, "⌘"), "K")) : null));
+}
+//#endregion
+//#region theme/components/DocSidebar.tsx
+function isSectionActive(items, currentSlug) {
+	for (const item of items) {
+		if (currentSlug === item.path || currentSlug.startsWith(item.path + "/")) return true;
+		if (item.children && isSectionActive(item.children, currentSlug)) return true;
+	}
+	return false;
+}
+function renderItems(items, currentSlug, depth = 0) {
+	return /* @__PURE__ */ h("ul", { class: `doc-sidebar-list ${depth > 0 ? "doc-sidebar-nested" : ""}` }, items.map((item) => {
+		const isActive = currentSlug === item.path;
+		const hasChildren = item.children && item.children.length > 0;
+		const isExpanded = hasChildren && item.children.some((child) => currentSlug === child.path || currentSlug.startsWith(child.path + "/"));
+		return /* @__PURE__ */ h("li", { class: `doc-sidebar-item ${isActive ? "active" : ""} ${isExpanded ? "expanded" : ""}` }, /* @__PURE__ */ h("a", {
+			href: item.path + "/",
+			class: "doc-sidebar-link"
+		}, item.title), hasChildren ? renderItems(item.children, currentSlug, depth + 1) : null);
+	}));
+}
+function DocSidebar({ sections, currentSlug = "/", collapsible = false }) {
+	if (!sections || sections.length === 0) return /* @__PURE__ */ h(Fragment, null);
+	return /* @__PURE__ */ h("aside", { class: "doc-sidebar" }, /* @__PURE__ */ h("nav", {
+		class: "doc-sidebar-nav",
+		"aria-label": "Documentation navigation"
+	}, sections.map((section) => {
+		const sectionActive = isSectionActive(section.items, currentSlug);
+		const isOpen = !section.collapsed || sectionActive;
+		if (collapsible) return /* @__PURE__ */ h("details", {
+			class: "doc-sidebar-section doc-sidebar-collapsible",
+			open: isOpen || void 0
+		}, /* @__PURE__ */ h("summary", { class: "doc-sidebar-heading" }, section.title), renderItems(section.items, currentSlug));
+		return /* @__PURE__ */ h("div", { class: "doc-sidebar-section" }, /* @__PURE__ */ h("p", { class: "doc-sidebar-heading" }, section.title), renderItems(section.items, currentSlug));
+	})));
+}
+//#endregion
+//#region theme/components/Html.tsx
+function buildCsp(gaId) {
+	const scriptSrc = ["'self'", "'unsafe-inline'"];
+	const connectSrc = ["'self'"];
+	if (gaId) {
+		scriptSrc.push("https://www.googletagmanager.com");
+		connectSrc.push("https://www.google-analytics.com", "https://analytics.google.com");
+	}
+	return [
+		"default-src 'self'",
+		`script-src ${scriptSrc.join(" ")}`,
+		"style-src 'self' 'unsafe-inline'",
+		"img-src 'self' data:",
+		"font-src 'self'",
+		`connect-src ${connectSrc.join(" ")}`,
+		"object-src 'none'",
+		"base-uri 'self'",
+		"form-action 'self'"
+	].join("; ");
+}
+function Html({ title, description, url, socialImage, site, children }) {
+	const origin = site.origin.replace(/\/$/, "");
+	const base = site.basePath || "";
+	const canonicalUrl = url ? `${origin}${url}` : void 0;
+	const locale = site.seo?.locale || "en_US";
+	const lightColor = site.theme?.lightColor || "#f8fafc";
+	const darkColor = site.theme?.darkColor || "#020617";
+	const gaId = site.analytics?.googleAnalytics;
+	const ogImage = socialImage ?? site.socialImage;
+	const searchEnabled = site.search?.enabled !== false;
+	const favicon = site.favicon;
+	const faviconFallback = site.faviconFallback;
+	const appleTouchIcon = site.appleTouchIcon;
+	return /* @__PURE__ */ h("html", {
+		lang: site.language || "en",
+		class: "no-js"
+	}, /* @__PURE__ */ h("head", null, /* @__PURE__ */ h("meta", { charset: "utf-8" }), /* @__PURE__ */ h("meta", {
+		name: "viewport",
+		content: "width=device-width, initial-scale=1"
+	}), /* @__PURE__ */ h("meta", {
+		name: "color-scheme",
+		content: "light dark"
+	}), /* @__PURE__ */ h("meta", {
+		"http-equiv": "Content-Security-Policy",
+		content: buildCsp(gaId)
+	}), /* @__PURE__ */ h("meta", {
+		name: "referrer",
+		content: "strict-origin-when-cross-origin"
+	}), /* @__PURE__ */ h("title", null, title), favicon !== false && favicon ? /* @__PURE__ */ h("link", {
+		rel: "icon",
+		href: favicon,
+		type: favicon.endsWith(".svg") ? "image/svg+xml" : "image/x-icon"
+	}) : null, faviconFallback ? /* @__PURE__ */ h("link", {
+		rel: "icon",
+		href: faviconFallback,
+		sizes: "32x32"
+	}) : null, appleTouchIcon ? /* @__PURE__ */ h("link", {
+		rel: "apple-touch-icon",
+		href: appleTouchIcon
+	}) : null, description ? /* @__PURE__ */ h("meta", {
+		name: "description",
+		content: description
+	}) : null, canonicalUrl ? /* @__PURE__ */ h("link", {
+		rel: "canonical",
+		href: canonicalUrl
+	}) : null, /* @__PURE__ */ h("meta", {
+		property: "og:type",
+		content: "website"
+	}), canonicalUrl ? /* @__PURE__ */ h("meta", {
+		property: "og:url",
+		content: canonicalUrl
+	}) : null, /* @__PURE__ */ h("meta", {
+		property: "og:title",
+		content: title
+	}), description ? /* @__PURE__ */ h("meta", {
+		property: "og:description",
+		content: description
+	}) : null, ogImage ? /* @__PURE__ */ h("meta", {
+		property: "og:image",
+		content: ogImage.startsWith("http") ? ogImage : `${origin}${ogImage}`
+	}) : null, /* @__PURE__ */ h("meta", {
+		property: "og:locale",
+		content: locale
+	}), /* @__PURE__ */ h("meta", {
+		property: "og:site_name",
+		content: site.name
+	}), /* @__PURE__ */ h("meta", {
+		name: "theme-color",
+		content: lightColor,
+		media: "(prefers-color-scheme: light)"
+	}), /* @__PURE__ */ h("meta", {
+		name: "theme-color",
+		content: darkColor,
+		media: "(prefers-color-scheme: dark)"
+	}), /* @__PURE__ */ h("link", {
+		rel: "preload",
+		href: `${base}/assets/fonts/open-sans-variable.woff2`,
+		as: "font",
+		type: "font/woff2",
+		crossorigin: ""
+	}), gaId ? /* @__PURE__ */ h("link", {
+		rel: "preconnect",
+		href: "https://www.googletagmanager.com",
+		crossorigin: ""
+	}) : null, /* @__PURE__ */ h("link", {
+		rel: "stylesheet",
+		href: `${base}/assets/style.css`
+	}), searchEnabled ? /* @__PURE__ */ h("link", {
+		rel: "stylesheet",
+		href: `${base}/pagefind/pagefind-ui.css`
+	}) : null, /* @__PURE__ */ h("script", { innerHTML: "document.documentElement.classList.remove('no-js')" }), searchEnabled ? /* @__PURE__ */ h("script", {
+		src: `${base}/pagefind/pagefind-ui.js`,
+		defer: true
+	}) : null, searchEnabled ? /* @__PURE__ */ h("noscript", null, /* @__PURE__ */ h("style", { innerHTML: ".doc-search-trigger{display:none!important}" })) : null, gaId ? /* @__PURE__ */ h(Fragment, null, /* @__PURE__ */ h("script", {
+		async: true,
+		src: `https://www.googletagmanager.com/gtag/js?id=${gaId}`
+	}), /* @__PURE__ */ h("script", { innerHTML: `window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','${gaId}');` })) : null), /* @__PURE__ */ h("body", null, children, searchEnabled ? /* @__PURE__ */ h("dialog", {
+		class: "doc-search-modal",
+		id: "search-modal",
+		"aria-label": "Search documentation",
+		"data-search-show-images": site.search?.showImages ? "true" : "false",
+		"data-search-show-sub-results": site.search?.showSubResults !== false ? "true" : "false"
+	}, /* @__PURE__ */ h("div", { class: "doc-search-modal-inner" }, /* @__PURE__ */ h("div", { class: "doc-search-modal-header" }, /* @__PURE__ */ h("span", { class: "doc-search-modal-title" }, "Search"), /* @__PURE__ */ h("button", {
+		type: "button",
+		class: "doc-search-modal-close",
+		"aria-label": "Close search",
+		"data-search-close": "",
+		innerHTML: "<svg viewBox=\"0 0 20 20\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\"><path d=\"m5 5 10 10M15 5 5 15\"/></svg>"
+	})), /* @__PURE__ */ h("div", {
+		class: "doc-search-modal-body",
+		"data-pagefind-search": ""
+	}))) : null, /* @__PURE__ */ h("script", {
+		src: `${base}/assets/main.js`,
+		defer: true
+	})));
+}
+//#endregion
+//#region theme/layouts/DocHome.tsx
+/**
+* DocHome layout.
+*
+* Documentation landing page with hero, install snippet, features grid,
+* packages grid, code example, and optional markdown content.
+*
+* All sections are optional — omit the frontmatter key and the section
+* is not rendered. Supports both single-package and monorepo projects.
+*/
+function DocHome(props) {
+	const { content, frontmatter, slug, site } = props;
+	const hero = frontmatter.hero ?? (frontmatter.title || frontmatter.tagline || frontmatter.actions ? {
+		name: frontmatter.title || site.name,
+		text: frontmatter.tagline || frontmatter.title,
+		tagline: frontmatter.description,
+		badge: frontmatter.badge,
+		actions: frontmatter.actions
+	} : void 0);
+	const features = frontmatter.features;
+	const install = frontmatter.install;
+	const packages = frontmatter.packages;
+	const codeExample = frontmatter.codeExample;
+	const navItems = site.navItems;
+	const sidebarSections = navItems && navItems.length > 0 ? [{
+		title: "Navigation",
+		items: navItems.map((item) => ({
+			title: item.label,
+			slug: item.path,
+			path: item.path
+		}))
+	}] : void 0;
+	return /* @__PURE__ */ h(Html, {
+		title: hero?.name || frontmatter.title || site.title,
+		description: hero?.tagline || frontmatter.description || site.description,
+		url: slug,
+		socialImage: frontmatter.socialImage ? frontmatter.socialImage.startsWith("http") ? frontmatter.socialImage : `${site.basePath || ""}/${frontmatter.socialImage.replace(/^\//, "")}` : void 0,
+		site
+	}, /* @__PURE__ */ h(DocHeader, {
+		siteName: site.name,
+		basePath: site.basePath,
+		homeLink: site.homeLink,
+		navItems: site.navItems,
+		slug,
+		searchEnabled: site.search?.enabled
+	}), /* @__PURE__ */ h("main", {
+		class: "doc-home",
+		"data-pagefind-body": ""
+	}, /* @__PURE__ */ h(DocSidebar, {
+		sections: sidebarSections,
+		currentSlug: slug
+	}), hero ? /* @__PURE__ */ h("section", { class: "doc-home-section doc-hero" }, hero.badge ? /* @__PURE__ */ h("div", { class: "doc-hero-badge" }, /* @__PURE__ */ h("span", { class: "doc-hero-badge-dot" }), hero.badge) : null, hero.name ? /* @__PURE__ */ h("p", { class: "doc-hero-name" }, hero.name) : null, hero.text ? /* @__PURE__ */ h("h1", { class: "doc-hero-text" }, hero.text) : null, hero.tagline ? /* @__PURE__ */ h("p", { class: "doc-hero-tagline" }, hero.tagline) : null, hero.actions && hero.actions.length > 0 ? /* @__PURE__ */ h("div", { class: "doc-hero-actions" }, hero.actions.map((action) => /* @__PURE__ */ h("a", {
+		href: action.link,
+		class: `doc-hero-action doc-hero-action-${action.theme || "brand"}`
+	}, action.icon ? /* @__PURE__ */ h("span", {
+		class: "doc-hero-action-icon",
+		innerHTML: action.icon
+	}) : null, action.text))) : null) : null, install ? /* @__PURE__ */ h("div", { class: "doc-home-section doc-home-install" }, /* @__PURE__ */ h("div", { class: "doc-install-bar" }, /* @__PURE__ */ h("div", { class: "doc-install-header" }, /* @__PURE__ */ h("span", { class: "doc-install-dot doc-install-dot-r" }), /* @__PURE__ */ h("span", { class: "doc-install-dot doc-install-dot-y" }), /* @__PURE__ */ h("span", { class: "doc-install-dot doc-install-dot-g" }), /* @__PURE__ */ h("span", { class: "doc-install-title" }, "Terminal"), /* @__PURE__ */ h("span", { style: "width:36px" })), /* @__PURE__ */ h("div", { class: "doc-install-body" }, /* @__PURE__ */ h("code", null, /* @__PURE__ */ h("span", { class: "doc-install-prompt" }, "$ "), install), /* @__PURE__ */ h("button", {
+		type: "button",
+		class: "doc-install-copy",
+		"data-copy-text": install,
+		onclick: `navigator.clipboard.writeText(this.dataset.copyText);this.textContent='Copied!';setTimeout(()=>this.textContent='Copy',1500)`
+	}, "Copy")))) : null, features && features.length > 0 ? /* @__PURE__ */ h("section", { class: "doc-home-section" }, /* @__PURE__ */ h("p", { class: "doc-home-section-label" }, "Features"), /* @__PURE__ */ h("div", { class: "doc-features" }, features.map((feature) => /* @__PURE__ */ h("div", { class: "doc-feature-card" }, feature.icon ? /* @__PURE__ */ h("span", {
+		class: "doc-feature-icon",
+		innerHTML: feature.icon
+	}) : null, /* @__PURE__ */ h("h3", { class: "doc-feature-title" }, feature.title), /* @__PURE__ */ h("p", { class: "doc-feature-details" }, feature.details))))) : null, packages && packages.length > 0 ? /* @__PURE__ */ h("section", { class: "doc-home-section" }, /* @__PURE__ */ h("p", { class: "doc-home-section-label" }, "Packages"), /* @__PURE__ */ h("div", { class: "doc-packages" }, packages.map((pkg) => {
+		return /* @__PURE__ */ h(pkg.href ? "a" : "div", {
+			class: "doc-package-card",
+			href: pkg.href || void 0
+		}, /* @__PURE__ */ h("div", { class: "doc-package-name" }, pkg.name), /* @__PURE__ */ h("p", { class: "doc-package-desc" }, pkg.description), pkg.version || pkg.tag ? /* @__PURE__ */ h("div", { class: "doc-package-meta" }, pkg.version ? /* @__PURE__ */ h("span", { class: "doc-package-version" }, pkg.version) : null, pkg.tag ? /* @__PURE__ */ h("span", { class: "doc-package-tag" }, pkg.tag) : null) : null);
+	}))) : null, codeExample ? /* @__PURE__ */ h("section", { class: "doc-home-section" }, /* @__PURE__ */ h("p", { class: "doc-home-section-label" }, codeExample.label || "Quick Start"), /* @__PURE__ */ h("div", { class: "doc-home-code" }, /* @__PURE__ */ h("div", { class: "doc-home-code-header" }, /* @__PURE__ */ h("span", { class: "doc-install-dot doc-install-dot-r" }), /* @__PURE__ */ h("span", { class: "doc-install-dot doc-install-dot-y" }), /* @__PURE__ */ h("span", { class: "doc-install-dot doc-install-dot-g" }), /* @__PURE__ */ h("span", { class: "doc-home-code-title" }, codeExample.title || ""), /* @__PURE__ */ h("span", { style: "width:36px" })), /* @__PURE__ */ h("pre", { innerHTML: codeExample.code }))) : null, content ? /* @__PURE__ */ h("section", { class: "doc-home-content" }, /* @__PURE__ */ h("div", {
+		class: "prose",
+		innerHTML: content
+	})) : null, /* @__PURE__ */ h("div", { class: "doc-home-footer" }, /* @__PURE__ */ h(DocFooter, {
+		links: site.footerLinks,
+		copyright: site.copyright
+	}))));
+}
+//#endregion
+//#region theme/layouts/DocNotFound.tsx
+/**
+* DocNotFound layout.
+*
+* 404 page for documentation sites.
+*/
+function DocNotFound(props) {
+	const { site, slug } = props;
+	const homePath = site.homeLink || (site.basePath ? `${site.basePath}/` : "/");
+	return /* @__PURE__ */ h(Html, {
+		title: `Page Not Found — ${site.title}`,
+		description: "The requested page could not be found.",
+		url: `${slug}/`,
+		site
+	}, /* @__PURE__ */ h(DocHeader, {
+		siteName: site.name,
+		basePath: site.basePath,
+		homeLink: site.homeLink,
+		navItems: site.navItems,
+		slug,
+		searchEnabled: site.search?.enabled
+	}), /* @__PURE__ */ h("main", { class: "doc-not-found" }, /* @__PURE__ */ h("div", { class: "doc-not-found-container" }, /* @__PURE__ */ h("p", { class: "doc-not-found-code" }, "404"), /* @__PURE__ */ h("h1", { class: "doc-not-found-title" }, "Page Not Found"), /* @__PURE__ */ h("p", { class: "doc-not-found-text" }, "The page you are looking for might have been moved or no longer exists."), /* @__PURE__ */ h("div", { class: "doc-not-found-actions" }, /* @__PURE__ */ h("a", {
+		href: homePath,
+		class: "doc-not-found-btn doc-not-found-btn-primary"
+	}, "Go Home")))));
+}
+//#endregion
+//#region theme/components/DocTOC.tsx
+function DocTOC({ headings, title = "On this page" }) {
+	const filtered = headings.filter((h) => h.depth >= 2 && h.depth <= 3);
+	if (filtered.length === 0) return /* @__PURE__ */ h(Fragment, null);
+	return /* @__PURE__ */ h("nav", {
+		class: "doc-toc",
+		"aria-label": "Table of contents"
+	}, /* @__PURE__ */ h("p", { class: "doc-toc-title" }, title), /* @__PURE__ */ h("ul", { class: "doc-toc-list" }, filtered.map((heading) => /* @__PURE__ */ h("li", { class: `doc-toc-item depth-${heading.depth}` }, /* @__PURE__ */ h("a", { href: `#${heading.slug}` }, heading.text)))));
+}
+//#endregion
+//#region theme/layouts/DocPage.tsx
+/**
+* DocPage layout.
+*
+* Standard documentation page with 3-column grid:
+* left sidebar (navigation) | content | right TOC
+*/
+function formatDate(isoDate) {
+	return new Date(isoDate).toLocaleDateString("en-US", {
+		year: "numeric",
+		month: "long",
+		day: "numeric"
+	});
+}
+function DocPage(props) {
+	const { content, frontmatter, headings, slug, site, next, prev, sidebarSections, breadcrumbs, editUrl, editLabel, lastUpdated } = props;
+	const pageTitle = frontmatter.title ? `${frontmatter.title} — ${site.title}` : site.title;
+	const ogImage = frontmatter.socialImage ? frontmatter.socialImage.startsWith("http") ? frontmatter.socialImage : `${site.basePath || ""}/${frontmatter.socialImage.replace(/^\//, "")}` : void 0;
+	const hasPageMeta = editUrl || lastUpdated;
+	return /* @__PURE__ */ h(Html, {
+		title: pageTitle,
+		description: frontmatter.description || site.description,
+		url: `${slug}/`,
+		socialImage: ogImage,
+		site
+	}, /* @__PURE__ */ h(DocHeader, {
+		siteName: site.name,
+		basePath: site.basePath,
+		homeLink: site.homeLink,
+		navItems: site.navItems,
+		slug,
+		searchEnabled: site.search?.enabled
+	}), /* @__PURE__ */ h("div", { class: "doc-layout" }, /* @__PURE__ */ h(DocSidebar, {
+		sections: sidebarSections,
+		currentSlug: slug,
+		collapsible: site.sidebar?.collapsible
+	}), /* @__PURE__ */ h("main", {
+		class: "doc-main",
+		"data-pagefind-body": ""
+	}, breadcrumbs && breadcrumbs.length > 1 ? /* @__PURE__ */ h("nav", {
+		class: "doc-breadcrumbs",
+		"aria-label": "Breadcrumbs"
+	}, breadcrumbs.map((crumb, i) => crumb.path ? /* @__PURE__ */ h(Fragment, null, i > 0 ? /* @__PURE__ */ h("span", {
+		class: "doc-breadcrumb-sep",
+		"aria-hidden": "true"
+	}, "/") : null, /* @__PURE__ */ h("a", { href: `${crumb.path}/` }, crumb.label)) : /* @__PURE__ */ h(Fragment, null, i > 0 ? /* @__PURE__ */ h("span", {
+		class: "doc-breadcrumb-sep",
+		"aria-hidden": "true"
+	}, "/") : null, /* @__PURE__ */ h("span", { "aria-current": "page" }, crumb.label)))) : null, headings.length > 0 ? /* @__PURE__ */ h("details", { class: "doc-toc-mobile" }, /* @__PURE__ */ h("summary", null, "On this page"), /* @__PURE__ */ h(DocTOC, { headings })) : null, /* @__PURE__ */ h("article", null, /* @__PURE__ */ h("div", {
+		class: "prose",
+		innerHTML: content
+	})), hasPageMeta ? /* @__PURE__ */ h("div", { class: "doc-page-meta" }, editUrl ? /* @__PURE__ */ h("a", {
+		href: editUrl,
+		class: "doc-edit-link",
+		target: "_blank",
+		rel: "noopener noreferrer"
+	}, editLabel || "Edit this page") : null, lastUpdated ? /* @__PURE__ */ h("span", { class: "doc-last-updated" }, "Last updated: ", /* @__PURE__ */ h("time", { datetime: lastUpdated }, formatDate(lastUpdated))) : null) : null, /* @__PURE__ */ h(DocFooter, {
+		prev,
+		next,
+		links: site.footerLinks,
+		copyright: site.copyright
+	})), /* @__PURE__ */ h("aside", { class: "doc-aside" }, /* @__PURE__ */ h(DocTOC, { headings }))));
+}
+//#endregion
+//#region src/render.ts
+async function loadUserThemeModule(entryPath, rootDir) {
+	const { build } = await import("rolldown");
+	const { pathToFileURL } = await import("url");
+	const cacheDir = join(rootDir, "node_modules", ".cache", "pagesmith-docs-layouts");
+	mkdirSync(cacheDir, { recursive: true });
+	for (const file of readdirSync(cacheDir)) if (file.endsWith(".mjs")) try {
+		rmSync(join(cacheDir, file));
+	} catch {}
+	const entryContent = readFileSync(entryPath, "utf-8");
+	const contentHash = createHash("md5").update(entryContent).digest("hex").slice(0, 12);
+	const outFile = join(cacheDir, `${basename(entryPath).replace(/[^a-z0-9]+/gi, "-").toLowerCase()}-${contentHash}.mjs`);
+	if (!existsSync(outFile)) await build({
+		input: entryPath,
+		output: {
+			file: outFile,
+			format: "esm"
+		},
+		platform: "node",
+		logLevel: "warn",
+		external: [/^node:/, /^@pagesmith\//],
+		moduleTypes: {
+			".ts": "ts",
+			".tsx": "tsx"
+		}
+	});
+	return import(`${pathToFileURL(outFile).href}?t=${Date.now()}`);
+}
+async function resolveDocsLayout(name, config, fallback) {
+	const overridePath = config.theme?.layouts?.[name];
+	if (!overridePath) {
+		if (fallback) return fallback;
+		throw new Error(`Theme layout "${name}" is referenced in meta.json5 but not registered in theme.layouts config`);
+	}
+	const absolutePath = resolve(config.rootDir, overridePath);
+	const module = await loadUserThemeModule(absolutePath, config.rootDir);
+	const exportNames = {
+		home: [
+			"default",
+			"DocHome",
+			"Home"
+		],
+		page: [
+			"default",
+			"DocPage",
+			"Page"
+		],
+		notFound: [
+			"default",
+			"DocNotFound",
+			"NotFound"
+		]
+	}[name] ?? ["default", name];
+	for (const exportName of exportNames) {
+		const candidate = module[exportName];
+		if (typeof candidate === "function") return candidate;
+	}
+	throw new Error(`Theme layout "${name}" at ${absolutePath} must export a component as default or one of: ${exportNames.join(", ")}`);
+}
+async function resolveDocsLayouts(config, sectionMetas) {
+	const registry = {
+		home: await resolveDocsLayout("home", config, DocHome),
+		page: await resolveDocsLayout("page", config, DocPage),
+		notFound: await resolveDocsLayout("notFound", config, DocNotFound)
+	};
+	if (sectionMetas) {
+		const extraNames = /* @__PURE__ */ new Set();
+		for (const meta of sectionMetas.values()) {
+			if (meta.layout && !registry[meta.layout]) extraNames.add(meta.layout);
+			if (meta.itemLayout && !registry[meta.itemLayout]) extraNames.add(meta.itemLayout);
+		}
+		for (const name of extraNames) registry[name] = await resolveDocsLayout(name, config);
+	}
+	return registry;
+}
+function writeHtml(outDir, routePath, html) {
+	const outputPath = routePath === "/" ? join(outDir, "index.html") : join(outDir, routePath.slice(1), "index.html");
+	mkdirSync(dirname(outputPath), { recursive: true });
+	writeFileSync(outputPath, `<!DOCTYPE html>\n${html}`);
+}
+async function renderDocs(config) {
+	const rootMeta = loadRootMeta(config.contentDir);
+	const sectionMetas = loadSectionMetas(config.contentDir);
+	const pages = await loadDocsPages(config, sectionMetas);
+	const model = buildSiteModel(config, pages, rootMeta, sectionMetas);
+	const site = getSitePayload(config, model);
+	const layouts = await resolveDocsLayouts(config, sectionMetas);
+	const base = config.basePath;
+	const buildEditUrl = config.editLink ? (sourcePath) => {
+		const relPath = relative(config.rootDir, sourcePath);
+		return `${config.editLink.editPattern}/${relPath}`;
+	} : void 0;
+	for (const page of pages) {
+		const urlPath = `${base}${page.routePath}`;
+		if (page.isHome) {
+			const frontmatter = { ...page.frontmatter };
+			if (frontmatter.hero?.actions) frontmatter.hero = {
+				...frontmatter.hero,
+				actions: frontmatter.hero.actions.map((a) => ({
+					...a,
+					link: typeof a.link === "string" && a.link.startsWith("/") ? `${base}${a.link}` : a.link
+				}))
+			};
+			const homeActions = Array.isArray(frontmatter.actions) ? frontmatter.actions : void 0;
+			if (homeActions) frontmatter.actions = homeActions.map((a) => ({
+				...a,
+				link: typeof a.link === "string" && a.link.startsWith("/") ? `${base}${a.link}` : a.link
+			}));
+			const output = (layouts[page.layoutName] ?? layouts.home)({
+				content: page.html,
+				frontmatter,
+				headings: page.headings,
+				slug: urlPath,
+				site
+			});
+			writeHtml(config.outDir, page.routePath, String(output));
+			continue;
+		}
+		const sidebarSections = page.section ? model.sidebarBySection.get(page.section) : void 0;
+		const { prev, next } = getPrevNext(sidebarSections, urlPath);
+		const breadcrumbs = buildBreadcrumbs(page.contentSlug, page.title, base);
+		const editUrl = buildEditUrl ? buildEditUrl(page.sourcePath) : void 0;
+		const output = (layouts[page.layoutName] ?? layouts.page)({
+			content: page.html,
+			frontmatter: page.frontmatter,
+			headings: page.headings,
+			slug: urlPath,
+			site,
+			sidebarSections,
+			prev,
+			next,
+			breadcrumbs,
+			editUrl,
+			editLabel: config.editLink?.label,
+			lastUpdated: page.lastUpdated
+		});
+		writeHtml(config.outDir, page.routePath, String(output));
+	}
+	const notFound = layouts.notFound({
+		content: "",
+		frontmatter: {
+			title: "Page not found",
+			description: "The page you requested could not be found."
+		},
+		headings: [],
+		slug: `${base}/404`,
+		site
+	});
+	const notFoundHtml = `<!DOCTYPE html>\n${String(notFound)}`;
+	writeHtml(config.outDir, "/404", String(notFound));
+	writeFileSync(join(config.outDir, "404.html"), notFoundHtml);
+	return {
+		pages,
+		model
+	};
+}
+//#endregion
+//#region src/build.ts
+async function bundleThemeAssets(config) {
+	const assetsDir = join(config.outDir, "assets");
+	mkdirSync(assetsDir, { recursive: true });
+	const css = buildCss(getThemeStylesEntry(), { minify: true });
+	writeFileSync(join(assetsDir, "style.css"), css);
+	const { build } = await import("rolldown");
+	await build({
+		input: getThemeRuntimeEntry(),
+		output: {
+			dir: assetsDir,
+			entryFileNames: "main.js",
+			format: "esm",
+			minify: true
+		},
+		platform: "browser",
+		logLevel: "warn"
+	});
+	const coreFontsDir = join(dirname(fileURLToPath(import.meta.resolve("@pagesmith/core/package.json"))), "assets", "fonts");
+	const outFontsDir = join(assetsDir, "fonts");
+	mkdirSync(outFontsDir, { recursive: true });
+	for (const file of readdirSync(coreFontsDir)) if (file.endsWith(".woff2")) copyFileSync(join(coreFontsDir, file), join(outFontsDir, file));
+}
+function copyPublicAssets(config) {
+	copyPublicFiles(config.publicDir, config.outDir);
+}
+function copyDirRecursive(srcDir, destDir) {
+	mkdirSync(destDir, { recursive: true });
+	for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
+		const srcPath = join(srcDir, entry.name);
+		const destPath = join(destDir, entry.name);
+		if (entry.isDirectory()) copyDirRecursive(srcPath, destPath);
+		else copyFileSync(srcPath, destPath);
+	}
+}
+function copyMappedAssets(config) {
+	for (const [outputPath, sources] of config.assets) {
+		const destDir = outputPath === "/" ? config.outDir : join(config.outDir, outputPath);
+		mkdirSync(destDir, { recursive: true });
+		for (const sourcePath of sources) {
+			if (!existsSync(sourcePath)) continue;
+			if (statSync(sourcePath).isDirectory()) copyDirRecursive(sourcePath, join(destDir, basename(sourcePath)));
+			else copyFileSync(sourcePath, join(destDir, basename(sourcePath)));
+		}
+	}
+}
+function copyContentAssetsToOutput(outDir, assets) {
+	if (assets.size === 0) return;
+	const assetsDir = join(outDir, "assets");
+	mkdirSync(assetsDir, { recursive: true });
+	for (const [fileName, sourcePath] of assets) copyFileSync(sourcePath, join(assetsDir, fileName));
+}
+async function runPagefind(outDir, extraFlags = []) {
+	const { fileURLToPath } = await import("url");
+	const binaryPath = join(join(fileURLToPath(import.meta.resolve("pagefind")), "..", ".."), "lib", "runner", "bin.cjs");
+	const { execFileSync } = await import("child_process");
+	execFileSync(process.execPath, [
+		binaryPath,
+		"--site",
+		outDir,
+		...extraFlags
+	], { stdio: "inherit" });
+}
+function generateSitemap(pages, config) {
+	const base = `${config.origin}${config.basePath}`;
+	return [
+		"<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
+		"<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">",
+		...pages.filter((p) => !p.frontmatter.draft).map((p) => {
+			return `  <url><loc>${p.isHome ? `${base}/` : `${base}${p.routePath}/`}</loc></url>`;
+		}),
+		"</urlset>"
+	].join("\n");
+}
+const LLMS_FILES = ["llms.txt", "llms-full.txt"];
+function copyLlmsFiles(config) {
+	for (const fileName of LLMS_FILES) {
+		const sourcePath = join(config.rootDir, fileName);
+		const destPath = join(config.outDir, fileName);
+		if (existsSync(sourcePath) && !existsSync(destPath)) copyFileSync(sourcePath, destPath);
+	}
+}
+async function build(options = {}) {
+	const startTime = performance.now();
+	const config = resolveDocsConfig(options.configPath, {
+		outDir: options.outDir,
+		basePath: options.basePath
+	});
+	const issues = validateConfig(config);
+	if (issues.length > 0) {
+		console.log();
+		const hasErrors = reportConfigIssues(issues);
+		console.log();
+		if (hasErrors) throw new Error("Config validation failed — fix the errors above before building.");
+	}
+	if (existsSync(config.outDir)) rmSync(config.outDir, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(config.outDir, { recursive: true });
+	const contentAssets = collectContentAssets(config.contentDir);
+	await bundleThemeAssets(config);
+	const { pages } = await renderDocs(config);
+	copyPublicAssets(config);
+	copyMappedAssets(config);
+	copyContentAssetsToOutput(config.outDir, contentAssets);
+	if (config.favicon) {
+		const faviconDest = join(config.outDir, basename(config.favicon));
+		if (!existsSync(faviconDest)) copyFileSync(config.favicon, faviconDest);
+	}
+	copyLlmsFiles(config);
+	writeFileSync(join(config.outDir, ".nojekyll"), "");
+	if (config.sitemap && config.origin !== "https://example.com") writeFileSync(join(config.outDir, "sitemap.xml"), generateSitemap(pages, config));
+	const robotsPath = join(config.outDir, "robots.txt");
+	if (!existsSync(robotsPath)) writeFileSync(robotsPath, `User-agent: *\nAllow: /${config.sitemap && config.origin !== "https://example.com" ? `\nSitemap: ${config.origin}${config.basePath}/sitemap.xml` : ""}\n`);
+	const duration = ((performance.now() - startTime) / 1e3).toFixed(1);
+	const sectionCount = new Set(pages.map((p) => p.section).filter(Boolean)).size;
+	console.log();
+	console.log(`  Built ${pages.length} pages in ${sectionCount} sections (${duration}s)`);
+	if (config.search.enabled) {
+		console.log();
+		try {
+			await runPagefind(config.outDir, config.search.pagefindFlags);
+		} catch (error) {
+			console.warn(`\x1b[33m⚠ Pagefind indexing failed — search will not be available.\x1b[0m`);
+			console.warn(`  ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+}
+/**
+* Rebuild content only — skips theme bundling and Pagefind indexing.
+* Used by the dev server for fast content-only rebuilds.
+*/
+async function rebuildContent(options = {}) {
+	const config = resolveDocsConfig(options.configPath, {
+		outDir: options.outDir,
+		basePath: options.basePath
+	});
+	const contentAssets = collectContentAssets(config.contentDir);
+	await renderDocs(config);
+	copyPublicAssets(config);
+	copyMappedAssets(config);
+	copyContentAssetsToOutput(config.outDir, contentAssets);
+	if (config.favicon) {
+		const faviconDest = join(config.outDir, basename(config.favicon));
+		if (!existsSync(faviconDest)) copyFileSync(config.favicon, faviconDest);
+	}
+}
+//#endregion
+//#region src/server.ts
+const MIME = {
+	".html": "text/html; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".json": "application/json",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".svg": "image/svg+xml",
+	".webp": "image/webp",
+	".ico": "image/x-icon",
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".xml": "application/xml",
+	".txt": "text/plain; charset=utf-8"
+};
+const WS_CLIENT_SCRIPT = `<script>
+(function() {
+  var ws = new WebSocket('ws://' + location.host + '/__ws');
+  ws.onmessage = function(e) {
+    var msg = JSON.parse(e.data);
+    if (msg.type === 'reload') location.reload();
+  };
+  ws.onclose = function() {
+    setTimeout(function() { location.reload(); }, 1000);
+  };
+})();
+<\/script>`;
+function serveFile(filePath, res, injectReload = false, statusCode = 200) {
+	const ext = extname(filePath);
+	const contentType = MIME[ext] || "application/octet-stream";
+	const body = readFileSync(filePath);
+	if (ext === ".html" && injectReload) {
+		const html = body.toString().replace("</body>", `${WS_CLIENT_SCRIPT}</body>`);
+		res.writeHead(statusCode, { "Content-Type": contentType });
+		res.end(html);
+		return;
+	}
+	res.writeHead(statusCode, { "Content-Type": contentType });
+	res.end(body);
+}
+async function loadSiteModel(config) {
+	const rootMeta = loadRootMeta(config.contentDir);
+	const sectionMetas = loadSectionMetas(config.contentDir);
+	return buildSiteModel(config, await loadDocsPages(config, sectionMetas), rootMeta, sectionMetas);
+}
+function logStartupSummary(config, model, baseUrl) {
+	const pageCount = model.pageByPath.size;
+	const sectionCount = model.sidebarBySection.size;
+	console.log(`  ${pageCount} pages in ${sectionCount} sections`);
+	console.log();
+	for (const [, sections] of model.sidebarBySection) {
+		const itemCount = sections.reduce((sum, s) => sum + s.items.length, 0);
+		const title = sections[0]?.title ?? "(unknown)";
+		const firstPath = sections[0]?.items[0]?.path ?? "";
+		const url = firstPath ? `${baseUrl.replace(/\/$/, "")}${firstPath}/` : baseUrl;
+		console.log(`  ${title} (${itemCount} pages)  ${url}`);
+	}
+	console.log();
+}
+function openBrowser(url) {
+	exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"} ${url}`);
+}
+function isPortAvailable(port) {
+	return new Promise((resolve) => {
+		const server = createServer$1();
+		server.once("error", () => resolve(false));
+		server.once("listening", () => {
+			server.close(() => resolve(true));
+		});
+		server.listen(port);
+	});
+}
+async function findAvailablePort(startPort, strictPort, label) {
+	if (await isPortAvailable(startPort)) return startPort;
+	if (strictPort) throw new Error(`Port ${startPort} is already in use (${label}). Disable strictPort to auto-find an available port.`);
+	const maxAttempts = 20;
+	for (let port = startPort + 1; port < startPort + maxAttempts; port++) if (await isPortAvailable(port)) {
+		console.log(`  Port ${startPort} in use, using ${port}`);
+		return port;
+	}
+	throw new Error(`No available port found in range ${startPort}–${startPort + maxAttempts - 1}`);
+}
+async function startDev(options = {}) {
+	const configPath = resolve(options.configPath ?? join(process.cwd(), "pagesmith.config.json5"));
+	await build({ configPath });
+	const config = resolveDocsConfig(configPath);
+	const port = await findAvailablePort(options.port ?? config.server.devPort, config.server.strictPort, "dev");
+	const themeRoot = getThemeRoot();
+	const watchTargets = [
+		config.contentDir,
+		configPath,
+		themeRoot
+	];
+	if (existsSync(config.publicDir)) watchTargets.push(config.publicDir);
+	let rebuilding = false;
+	let pending = false;
+	const clients = /* @__PURE__ */ new Set();
+	const base = config.basePath.replace(/\/+$/, "");
+	function log(status, method, pathname) {
+		console.log(`  ${status < 300 ? "\x1B[32m" : status < 400 ? "\x1B[36m" : "\x1B[33m"}${status}\x1b[0m ${method} ${pathname}`);
+	}
+	function notifyClients() {
+		const payload = JSON.stringify({ type: "reload" });
+		for (const client of clients) client.send(payload);
+	}
+	/**
+	* Determine rebuild type based on changed file path.
+	* Config/theme changes require full rebuild; content changes only need content rebuild.
+	*/
+	function getChangeType(changedPath) {
+		const resolved = resolve(changedPath);
+		if (resolved === resolve(configPath)) return "full";
+		if (resolved.startsWith(resolve(themeRoot))) return "full";
+		return "content";
+	}
+	async function doRebuild(type) {
+		const start = performance.now();
+		if (type === "full") await build({ configPath });
+		else await rebuildContent({ configPath });
+		const elapsed = Math.round(performance.now() - start);
+		console.log(`  \x1b[36m${type === "full" ? "Full rebuild" : "Content rebuild"} in ${elapsed}ms\x1b[0m`);
+	}
+	const server = createServer((req, res) => {
+		const url = new URL(req.url || "/", `http://localhost:${port}`);
+		const method = req.method || "GET";
+		let pathname = url.pathname;
+		if (base && (pathname === "/" || pathname === "")) {
+			log(302, method, pathname);
+			res.writeHead(302, { Location: `${base}/` });
+			res.end();
+			return;
+		}
+		if (base && pathname.startsWith(base)) pathname = pathname.slice(base.length) || "/";
+		if (pathname.startsWith("/assets/fonts/")) {
+			const fontFile = pathname.replace("/assets/fonts/", "");
+			const fontPath = join(dirname(fileURLToPath(import.meta.resolve("@pagesmith/core/package.json"))), "assets", "fonts", fontFile);
+			if (existsSync(fontPath)) {
+				log(200, method, url.pathname);
+				res.writeHead(200, {
+					"Content-Type": "font/woff2",
+					"Cache-Control": "public, max-age=31536000"
+				});
+				res.end(readFileSync(fontPath));
+				return;
+			}
+		}
+		let filePath = join(config.outDir, pathname);
+		if (existsSync(filePath) && !extname(filePath)) filePath = join(filePath, "index.html");
+		if (!existsSync(filePath)) {
+			const notFoundDir = join(config.outDir, "404", "index.html");
+			const notFoundFile = join(config.outDir, "404.html");
+			const notFoundPath = existsSync(notFoundDir) ? notFoundDir : existsSync(notFoundFile) ? notFoundFile : null;
+			if (notFoundPath) {
+				log(404, method, url.pathname);
+				serveFile(notFoundPath, res, true, 404);
+				return;
+			}
+			log(404, method, url.pathname);
+			res.writeHead(404, { "Content-Type": "text/html; charset=utf-8" });
+			res.end("<h1>404</h1>");
+			return;
+		}
+		log(200, method, url.pathname);
+		serveFile(filePath, res, true);
+	});
+	new WebSocketServer({
+		server,
+		path: "/__ws"
+	}).on("connection", (socket) => {
+		clients.add(socket);
+		socket.on("close", () => clients.delete(socket));
+	});
+	const devUrl = `http://localhost:${port}${base}/`;
+	const model = await loadSiteModel(config);
+	server.listen(port, () => {
+		console.log();
+		console.log(`  Docs dev: ${devUrl}`);
+		console.log();
+		logStartupSummary(config, model, devUrl);
+		if (options.open) openBrowser(devUrl);
+	});
+	watch(watchTargets, { ignoreInitial: true }).on("all", async (_event, changedPath) => {
+		const changeType = getChangeType(changedPath);
+		if (rebuilding) {
+			pending = pending === "full" || changeType === "full" ? "full" : "content";
+			return;
+		}
+		rebuilding = true;
+		try {
+			await doRebuild(changeType);
+			notifyClients();
+		} catch (err) {
+			console.error("Rebuild failed:", err instanceof Error ? err.message : err);
+		} finally {
+			rebuilding = false;
+			if (pending) {
+				const nextType = pending;
+				pending = false;
+				rebuilding = true;
+				try {
+					await doRebuild(nextType);
+					notifyClients();
+				} catch (err) {
+					console.error("Rebuild failed:", err instanceof Error ? err.message : err);
+				} finally {
+					rebuilding = false;
+				}
+			}
+		}
+	});
+}
+async function preview(options = {}) {
+	const config = resolveDocsConfig(options.configPath);
+	const port = await findAvailablePort(options.port ?? config.server.previewPort, config.server.strictPort, "preview");
+	const previewBase = config.basePath.replace(/\/+$/, "");
+	const server = createServer((req, res) => {
+		let pathname = new URL(req.url || "/", `http://localhost:${port}`).pathname;
+		if (previewBase && (pathname === "/" || pathname === "")) {
+			res.writeHead(302, { Location: `${previewBase}/` });
+			res.end();
+			return;
+		}
+		if (previewBase && pathname.startsWith(previewBase)) pathname = pathname.slice(previewBase.length) || "/";
+		let filePath = join(config.outDir, pathname);
+		if (existsSync(filePath) && !extname(filePath)) filePath = join(filePath, "index.html");
+		if (!existsSync(filePath)) {
+			filePath = join(config.outDir, "404", "index.html");
+			if (!existsSync(filePath)) {
+				res.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+				res.end("Not found");
+				return;
+			}
+			serveFile(filePath, res, false, 404);
+			return;
+		}
+		serveFile(filePath, res);
+	});
+	const previewUrl = `http://localhost:${port}${previewBase}/`;
+	const model = await loadSiteModel(config);
+	server.listen(port, () => {
+		console.log();
+		console.log(`  Docs preview: ${previewUrl}`);
+		console.log();
+		logStartupSummary(config, model, previewUrl);
+		if (options.open) openBrowser(previewUrl);
+	});
+}
+//#endregion
+export { defineDocsConfig as a, reportConfigIssues as c, withBase as d, Html as i, resolveDocsConfig as l, startDev as n, detectGitOrigin as o, build as r, loadDocsConfig as s, preview as t, validateConfig as u };
+
+//# sourceMappingURL=site-dJ3MiiW3.mjs.map