@pracht/vite-plugin 0.8.0 → 0.9.0

package/dist/pages-router-BQlG21oC.mjs

@@ -1,319 +0,0 @@
-import { readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import { basename, extname, join, relative } from "node:path";
-import { maskCommentsAndStrings } from "@pracht/capabilities/static";
-//#region src/route-loader-hints.ts
-const ROUTE_EXTENSIONS = new Set([
-	".tsx",
-	".ts",
-	".jsx",
-	".js",
-	".md",
-	".mdx"
-]);
-const LOADER_DECLARATION_RE = /export\s+(?:async\s+)?(?:function|const|let|var)\s+loader\b/;
-const EXPORT_BLOCK_RE = /export\s*\{([^}]*)\}\s*(?:from\s*["'][^"']+["'])?/g;
-const EXPORT_ALL_RE = /export\s+\*\s+from\s*["'][^"']+["']/;
-function exportSpecifiersIncludeLoader(specifiers) {
-	return specifiers.split(",").map((specifier) => specifier.trim()).filter(Boolean).some((specifier) => {
-		const match = /^(?:type\s+)?([A-Za-z_$][\w$]*)(?:\s+as\s+([A-Za-z_$][\w$]*))?$/.exec(specifier);
-		if (!match) return false;
-		const [, localName, exportedName] = match;
-		return (exportedName ?? localName) === "loader";
-	});
-}
-function detectLoaderExport(source) {
-	if (LOADER_DECLARATION_RE.test(source)) return true;
-	for (const match of source.matchAll(EXPORT_BLOCK_RE)) if (exportSpecifiersIncludeLoader(match[1])) return true;
-	return EXPORT_ALL_RE.test(source);
-}
-function scanRouteFiles(dir, files) {
-	let entries;
-	try {
-		entries = readdirSync(dir);
-	} catch {
-		return;
-	}
-	for (const entry of entries) {
-		const abs = join(dir, entry);
-		if (statSync(abs).isDirectory()) {
-			scanRouteFiles(abs, files);
-			continue;
-		}
-		if (ROUTE_EXTENSIONS.has(extname(entry))) files.push(abs);
-	}
-}
-function toPosixPath(path) {
-	return path.replace(/\\/g, "/");
-}
-function createRouteLoaderHints(routesDir, options = {}) {
-	const files = [];
-	const hints = {};
-	scanRouteFiles(routesDir, files);
-	for (const file of files) {
-		const hasLoader = detectLoaderExport(readFileSync(file, "utf-8"));
-		const relativeToRoutesDir = toPosixPath(relative(routesDir, file));
-		const routeRootPrefix = options.rootRelativePrefix?.replace(/\/$/, "");
-		const appFileDir = options.appFileDir;
-		const keys = /* @__PURE__ */ new Set();
-		if (appFileDir) {
-			const relativeToAppFile = toPosixPath(relative(appFileDir, file));
-			keys.add(relativeToAppFile.startsWith(".") ? relativeToAppFile : `./${relativeToAppFile}`);
-		}
-		if (routeRootPrefix) keys.add(`${routeRootPrefix}/${relativeToRoutesDir}`);
-		for (const key of keys) hints[key] = hasLoader;
-	}
-	return hints;
-}
-//#endregion
-//#region src/pages-router.ts
-const PAGE_EXTENSIONS = new Set([
-	".tsx",
-	".tsrx",
-	".ts",
-	".jsx",
-	".js",
-	".md",
-	".mdx"
-]);
-const SHELL_EXTENSIONS = new Set([
-	".tsx",
-	".tsrx",
-	".ts",
-	".jsx",
-	".js"
-]);
-function scanPagesDirectory(pagesDir) {
-	const pages = [];
-	scan(pagesDir, pagesDir, pages);
-	const appShell = pages.find((page) => page.routePath === "__shell__");
-	if (appShell?.hasRevalidateExport) throw new Error(`[pracht] Pages app shell ${JSON.stringify(appShell.relativePath)} exports REVALIDATE, but app shells are not ISG routes. Declare the policy on each ISG page instead.`);
-	return sortRoutes(pages);
-}
-function scan(dir, root, pages) {
-	let entries;
-	try {
-		entries = readdirSync(dir);
-	} catch {
-		return;
-	}
-	for (const entry of entries) {
-		const abs = join(dir, entry);
-		if (statSync(abs).isDirectory()) {
-			scan(abs, root, pages);
-			continue;
-		}
-		const ext = extname(entry);
-		if (!PAGE_EXTENSIONS.has(ext)) continue;
-		const name = basename(entry, ext);
-		if (name.startsWith("_") && name !== "_app") continue;
-		const rel = relative(root, abs);
-		const routePath = filePathToRoutePath(rel);
-		const analysisSource = maskMarkdownFences(readFileSync(abs, "utf-8"), rel);
-		const renderMode = extractQuotedPageExport(analysisSource, "RENDER_MODE", rel);
-		const hydrationMode = extractQuotedPageExport(analysisSource, "HYDRATION", rel);
-		const revalidate = extractRevalidateSeconds(analysisSource, rel);
-		const hasLoader = detectLoaderExport(analysisSource);
-		pages.push({
-			absolutePath: abs,
-			relativePath: rel,
-			routePath,
-			isIndex: name === "index",
-			isCatchAll: routePath.split("/").includes("*"),
-			isDynamic: routePath.split("/").some((segment) => segment.startsWith(":")),
-			renderMode,
-			hydrationMode,
-			revalidateSeconds: revalidate.seconds,
-			hasRevalidateExport: revalidate.present,
-			hasLoader
-		});
-	}
-}
-function filePathToRoutePath(relativePath) {
-	let route = relativePath.replace(/\.(tsx?|tsrx|jsx?|mdx?)$/, "");
-	route = route.replace(/\\/g, "/");
-	if (route === "_app" || route.endsWith("/_app")) return "__shell__";
-	if (route === "index") return "/";
-	route = route.replace(/\/index$/, "");
-	route = route.replace(/\[([^\].]+)\]/g, ":$1");
-	route = route.replace(/\[\.\.\.([^\]]+)\]/g, "*");
-	return `/${route}`;
-}
-function sortRoutes(pages) {
-	return [...pages].filter((p) => p.routePath !== "__shell__").sort(comparePagesBySpecificity);
-}
-function comparePagesBySpecificity(left, right) {
-	const leftSegments = splitRoutePath(left.routePath);
-	const rightSegments = splitRoutePath(right.routePath);
-	const length = Math.max(leftSegments.length, rightSegments.length);
-	for (let index = 0; index < length; index += 1) {
-		const leftSegment = leftSegments[index];
-		const rightSegment = rightSegments[index];
-		if (!leftSegment) return -1;
-		if (!rightSegment) return 1;
-		const leftScore = getRouteSegmentSpecificity(leftSegment);
-		const rightScore = getRouteSegmentSpecificity(rightSegment);
-		if (leftScore !== rightScore) return rightScore - leftScore;
-		if (leftScore === 3 && leftSegment !== rightSegment) return leftSegment.localeCompare(rightSegment);
-	}
-	return left.routePath.localeCompare(right.routePath);
-}
-function splitRoutePath(routePath) {
-	return routePath.split("/").filter(Boolean);
-}
-function getRouteSegmentSpecificity(segment) {
-	if (segment === "*") return 1;
-	if (segment.startsWith(":")) return 2;
-	return 3;
-}
-function extractQuotedPageExport(source, name, relativePath) {
-	const declarations = [...maskCommentsAndStrings(source).matchAll(new RegExp(`export\\s+const\\s+${name}\\s*=`, "g"))];
-	if (declarations.length === 0) return void 0;
-	if (declarations.length > 1) throw new Error(`[pracht] Pages route ${JSON.stringify(relativePath)} exports ${name} more than once.`);
-	const declaration = declarations[0];
-	const valueStart = (declaration.index ?? 0) + declaration[0].length;
-	return source.slice(valueStart).trimStart().match(/^["'](\w+)["']/)?.[1];
-}
-const REVALIDATE_RE = /export\s+const\s+REVALIDATE\s*=\s*([^;\n]+)/;
-function extractRevalidateSeconds(source, relativePath) {
-	const matches = [...maskCommentsAndStrings(source).matchAll(new RegExp(REVALIDATE_RE, "g"))];
-	if (matches.length === 0) return { present: false };
-	if (matches.length > 1) throw new Error(`[pracht] Pages route ${JSON.stringify(relativePath)} exports REVALIDATE more than once.`);
-	const expression = matches[0][1].trim().replace(/\s+as\s+const$/, "");
-	if (!/^\d(?:_?\d)*$/.test(expression)) throw new Error(`[pracht] Pages route ${JSON.stringify(relativePath)} must export REVALIDATE as a positive integer literal number of seconds (for example, \`export const REVALIDATE = 60\`).`);
-	const seconds = Number(expression.replaceAll("_", ""));
-	if (!Number.isSafeInteger(seconds) || seconds <= 0) throw new Error(`[pracht] Pages route ${JSON.stringify(relativePath)} must export REVALIDATE as a positive integer literal number of seconds within JavaScript's safe integer range.`);
-	return {
-		present: true,
-		seconds
-	};
-}
-/** Mask Markdown fenced examples while preserving source offsets and top-level MDX exports. */
-function maskMarkdownFences(source, relativePath) {
-	if (!/\.mdx?$/.test(relativePath)) return source;
-	const chars = source.split("");
-	let activeFence = null;
-	for (const line of source.matchAll(/.*(?:\r?\n|$)/g)) {
-		if (line[0] === "") continue;
-		const lineStart = line.index ?? 0;
-		const stripped = stripMarkdownContainerPrefix(line[0].replace(/\r?\n$/, ""));
-		const fenceContent = activeFence && stripped.content.startsWith(" ".repeat(activeFence.continuationIndent)) ? stripped.content.slice(activeFence.continuationIndent) : stripped.content;
-		const opening = activeFence ? null : /^ {0,3}(`{3,}|~{3,})/.exec(fenceContent);
-		const closing = activeFence ? new RegExp(`^ {0,3}\\${activeFence.character}{${activeFence.length},}[ \\t]*$`).test(fenceContent) : false;
-		if (activeFence || opening) for (let offset = 0; offset < line[0].length; offset += 1) {
-			const index = lineStart + offset;
-			if (chars[index] !== "\n" && chars[index] !== "\r") chars[index] = " ";
-		}
-		if (closing) activeFence = null;
-		else if (opening) activeFence = {
-			character: opening[1][0],
-			continuationIndent: stripped.continuationIndent,
-			length: opening[1].length
-		};
-	}
-	return chars.join("");
-}
-function stripMarkdownContainerPrefix(line) {
-	let content = line;
-	let continuationIndent = 0;
-	while (true) {
-		const quote = /^ {0,3}> ?/.exec(content);
-		if (quote) {
-			content = content.slice(quote[0].length);
-			continue;
-		}
-		const list = /^ {0,3}(?:[-+*]|\d{1,9}[.)])[ \t]+/.exec(content);
-		if (!list) return {
-			content,
-			continuationIndent
-		};
-		continuationIndent += list[0].length;
-		content = content.slice(list[0].length);
-	}
-}
-function generatePagesManifestSource(pages, options) {
-	const pagesDir = options.pagesDir;
-	const defaultRender = options.pagesDefaultRender ?? "ssr";
-	const prefix = options.pagesDirPrefix;
-	const useImport = options.useImportSyntax ?? false;
-	const appFile = scanAllFiles(pagesDir).find((f) => basename(f, extname(f)) === "_app" && SHELL_EXTENSIONS.has(extname(f)));
-	const lines = [`import { ${pages.some((page) => page.revalidateSeconds !== void 0) ? "defineApp, group, route, timeRevalidate" : "defineApp, group, route"} } from "@pracht/core/manifest";`, ""];
-	const routeEntries = [];
-	const notFoundPage = pages.find((page) => page.routePath === "/404");
-	if (notFoundPage?.hasRevalidateExport) throw new Error(`[pracht] Pages not-found module ${JSON.stringify(notFoundPage.relativePath)} exports REVALIDATE, but not-found responses are never ISG routes.`);
-	for (const page of pages) {
-		if (page === notFoundPage) continue;
-		const render = page.renderMode ?? defaultRender;
-		if (render === "isg" && page.revalidateSeconds === void 0) throw new Error(`[pracht] Pages route ${JSON.stringify(page.relativePath)} uses render mode "isg" but does not export a revalidation policy. Add \`export const REVALIDATE = 60\` with a positive integer number of seconds, or use another render mode.`);
-		if (render !== "isg" && page.hasRevalidateExport) throw new Error(`[pracht] Pages route ${JSON.stringify(page.relativePath)} exports REVALIDATE but its effective render mode is ${JSON.stringify(render)}. REVALIDATE is only valid with \`RENDER_MODE = "isg"\` (or \`pagesDefaultRender: "isg"\`).`);
-		const filePath = prefix ? `${prefix}/${page.relativePath.replace(/\\/g, "/")}` : `./${page.relativePath.replace(/\\/g, "/")}`;
-		const fileRef = useImport ? `() => import(${JSON.stringify(filePath)})` : JSON.stringify(filePath);
-		const metaParts = [`render: ${JSON.stringify(render)}`, `hasLoader: ${page.hasLoader ? "true" : "false"}`];
-		if (page.hydrationMode) metaParts.push(`hydration: ${JSON.stringify(page.hydrationMode)}`);
-		if (page.revalidateSeconds !== void 0) metaParts.push(`revalidate: timeRevalidate(${page.revalidateSeconds})`);
-		routeEntries.push(`    route(${JSON.stringify(page.routePath)}, ${fileRef}, { ${metaParts.join(", ")} })`);
-	}
-	const notFoundEntry = notFoundPage ? buildNotFoundEntry(notFoundPage, {
-		prefix,
-		useImport,
-		withShell: !!appFile
-	}) : null;
-	if (appFile) {
-		const appPath = prefix ? `${prefix}/_app.${extname(appFile).slice(1)}` : `./${relative(join(pagesDir, ".."), appFile).replace(/\\/g, "/")}`;
-		const shellRef = useImport ? `() => import(${JSON.stringify(appPath)})` : JSON.stringify(appPath);
-		lines.push("const app = defineApp({");
-		lines.push("  shells: {");
-		lines.push(`    pages: ${shellRef},`);
-		lines.push("  },");
-		lines.push("  routes: [");
-		lines.push(`    group({ shell: "pages" }, [`);
-		lines.push(routeEntries.join(",\n"));
-		lines.push("    ]),");
-		lines.push("  ],");
-		if (notFoundEntry) lines.push(notFoundEntry);
-		lines.push("});");
-	} else {
-		lines.push("const app = defineApp({");
-		lines.push("  routes: [");
-		lines.push(routeEntries.join(",\n"));
-		lines.push("  ],");
-		if (notFoundEntry) lines.push(notFoundEntry);
-		lines.push("});");
-	}
-	lines.push("");
-	return lines.join("\n");
-}
-function buildNotFoundEntry(page, options) {
-	const filePath = options.prefix ? `${options.prefix}/${page.relativePath.replace(/\\/g, "/")}` : `./${page.relativePath.replace(/\\/g, "/")}`;
-	const configParts = [`component: ${options.useImport ? `() => import(${JSON.stringify(filePath)})` : JSON.stringify(filePath)}`];
-	if (options.withShell) configParts.push("shell: \"pages\"");
-	if (page.hydrationMode) configParts.push(`hydration: ${JSON.stringify(page.hydrationMode)}`);
-	return `  notFound: { ${configParts.join(", ")} },`;
-}
-function scanAllFiles(dir) {
-	const results = [];
-	let entries;
-	try {
-		entries = readdirSync(dir);
-	} catch {
-		return results;
-	}
-	for (const entry of entries) {
-		const abs = join(dir, entry);
-		if (statSync(abs).isDirectory()) results.push(...scanAllFiles(abs));
-		else results.push(abs);
-	}
-	return results;
-}
-function generateRoutesFile(pagesDir, outputPath, options) {
-	writeFileSync(outputPath, [
-		"// Auto-generated from pages/ directory by @pracht/vite-plugin.",
-		"// Customize this file and remove `pagesDir` from pracht config to use it directly.",
-		"",
-		generatePagesManifestSource(scanPagesDirectory(pagesDir), {
-			...options,
-			useImportSyntax: true
-		}).replace("const app = defineApp(", "export const app = defineApp(")
-	].join("\n"), "utf-8");
-}
-//#endregion
-export { sortRoutes as a, scanPagesDirectory as i, generatePagesManifestSource as n, createRouteLoaderHints as o, generateRoutesFile as r, filePathToRoutePath as t };