rari 0.2.18 → 0.2.19

package/dist/client-dev.d.ts

@@ -1,2 +1,2 @@
-import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-P4vvSVPV.js";
+import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CwQkaktd.js";
 export { type ErrorBoundaryProps, type FileRouteInfo, HttpRuntimeClient, type LayoutProps, Link, type LinkProps, type LoadingProps, Navigate, type NavigationOptions, type NavigationState, Outlet, type PageComponent, type PageProps, RouteComponent as Route, type RouteGenerationOptions, type RouteMatch, type RouteMeta, type RouteParams, type Route as RouteType, type RouterConfig, type RouterContext, RouterProvider, type RouterProviderProps, Routes, type RuntimeClient, type SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter };

package/dist/client.d.ts

@@ -1,2 +1,2 @@
-import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-P4vvSVPV.js";
+import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CwQkaktd.js";
 export { type ErrorBoundaryProps, type FileRouteInfo, HttpRuntimeClient, type LayoutProps, Link, type LinkProps, type LoadingProps, Navigate, type NavigationOptions, type NavigationState, Outlet, type PageComponent, type PageProps, RouteComponent as Route, type RouteGenerationOptions, type RouteMatch, type RouteMeta, type RouteParams, type Route as RouteType, type RouterConfig, type RouterContext, RouterProvider, type RouterProviderProps, Routes, type RuntimeClient, type SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter };

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-P4vvSVPV.js";
-import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-CpxpL2un.js";
-export { ErrorBoundaryProps, FileRouteGenerator, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, RouteComponent as Route, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, Route as RouteType, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };
+import { CacheConfig, ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageCacheConfig, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CwQkaktd.js";
+import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, defineRariOptions, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-Bna18v8X.js";
+export { CacheConfig, ErrorBoundaryProps, FileRouteGenerator, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageCacheConfig, PageComponent, PageProps, RouteComponent as Route, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, Route as RouteType, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, defineRariOptions, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent, Routes, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, router_default, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CcEhh-F7.js";
-import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-BrkE-3ny.js";
-import "./server-build-DaBgiV55.js";
+import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, defineRariOptions, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-DYwz6RKf.js";
+import "./server-build-BM8_GFF5.js";
 
-export { FileRouteGenerator, HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent as Route, router_default as RouterProvider, Routes, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };
+export { FileRouteGenerator, HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent as Route, router_default as RouterProvider, Routes, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, defineRariOptions, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };

package/dist/{runtime-client-P4vvSVPV.d.ts → runtime-client-CwQkaktd.d.ts}

@@ -1,6 +1,18 @@
 import React$1, { ComponentType, ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
+//#region src/router/cache.d.ts
+interface CacheConfig {
+  routes?: Record<string, string>;
+  static?: string;
+  serverComponents?: string;
+}
+interface PageCacheConfig {
+  'cache-control'?: string;
+  'vary'?: string;
+  [key: string]: string | undefined;
+}
+//#endregion
 //#region src/router/types.d.ts
 interface Route {
   path: string;
@@ -18,6 +30,7 @@ interface RouteMeta {
   title?: string;
   description?: string;
   requiresAuth?: boolean;
+  cacheConfig?: PageCacheConfig;
   [key: string]: any;
 }
 interface RouteParams {
@@ -281,4 +294,4 @@ declare function createHttpRuntimeClient(options?: {
   ssl?: boolean;
 }): RuntimeClient;
 //#endregion
-export { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext$1 as RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter };
+export { CacheConfig, ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageCacheConfig, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext$1 as RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter };

package/dist/{server-CpxpL2un.d.ts → server-Bna18v8X.d.ts}

@@ -1,4 +1,4 @@
-import { Route, RouteGenerationOptions } from "./runtime-client-P4vvSVPV.js";
+import { CacheConfig, Route, RouteGenerationOptions } from "./runtime-client-CwQkaktd.js";
 import { Plugin, UserConfig } from "rolldown-vite";
 
 //#region src/router/file-routes.d.ts
@@ -60,10 +60,12 @@ interface RariOptions {
   projectRoot?: string;
   serverBuild?: ServerBuildOptions;
   serverHandler?: boolean;
+  caching?: CacheConfig;
 }
+declare function defineRariOptions(config: RariOptions): RariOptions;
 declare function rari(options?: RariOptions): Plugin[];
 declare function defineRariConfig(config: UserConfig & {
   plugins?: Plugin[];
 }): UserConfig;
 //#endregion
-export { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes };
+export { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, defineRariOptions, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes };

package/dist/{server-BrkE-3ny.js → server-DYwz6RKf.js}

@@ -1,6 +1,6 @@
 import { __commonJS, __require, __toESM } from "./chunk-BLXvPPr8.js";
 import { analyzeFilePath } from "./runtime-client-CcEhh-F7.js";
-import { createServerBuildPlugin } from "./server-build-DaBgiV55.js";
+import { createServerBuildPlugin } from "./server-build-BM8_GFF5.js";
 import fs, { promises } from "node:fs";
 import path from "node:path";
 import process$1 from "node:process";
@@ -5637,6 +5637,40 @@ function scanForClientComponents(srcDir) {
 	scanDirectory(srcDir);
 	return clientComponents;
 }
+function extractCacheConfigFromContent(content) {
+	const ast = acorn.parse(content, {
+		ecmaVersion: 2022,
+		sourceType: "module",
+		allowImportExportEverywhere: true
+	});
+	for (const node of ast.body) if (node.type === "ExportNamedDeclaration" && node.declaration && node.declaration.type === "VariableDeclaration") {
+		for (const declarator of node.declaration.declarations) if (declarator.id && declarator.id.name === "cacheConfig" && declarator.init && declarator.init.type === "ObjectExpression") {
+			const config = {};
+			for (const prop of declarator.init.properties) if (prop.type === "Property" && prop.key && prop.value && prop.value.type === "Literal") {
+				const keyName = prop.key.type === "Literal" ? prop.key.value : prop.key.name;
+				if (keyName === "cache-control" || keyName === "vary") config[keyName] = prop.value.value;
+			}
+			return Object.keys(config).length > 0 ? config : void 0;
+		}
+	}
+	return void 0;
+}
+function matchesPattern(pattern, path$5) {
+	if (pattern === path$5) return true;
+	if (pattern.endsWith("/*")) {
+		const prefix = pattern.slice(0, -2);
+		return path$5.startsWith(prefix);
+	}
+	if (pattern.includes("*")) {
+		const regexPattern = pattern.replace(/\*/g, ".*").replace(/\//g, "\\/");
+		const regex = /* @__PURE__ */ new RegExp(`^${regexPattern}$`);
+		return regex.test(path$5);
+	}
+	return false;
+}
+function defineRariOptions(config) {
+	return config;
+}
 function rari(options = {}) {
 	const componentTypeCache = /* @__PURE__ */ new Map();
 	const serverComponents = /* @__PURE__ */ new Set();
@@ -6028,7 +6062,7 @@ const ${componentName$1} = registerClientReference(
 			const srcDir = path.join(projectRoot, "src");
 			const discoverAndRegisterComponents = async () => {
 				try {
-					const { ServerComponentBuilder, scanDirectory } = await import("./server-build-Cp6_RdeA.js");
+					const { ServerComponentBuilder, scanDirectory } = await import("./server-build-DcbOtG3e.js");
 					const builder = new ServerComponentBuilder(projectRoot, {
 						outDir: "temp",
 						serverDir: "server",
@@ -6045,7 +6079,8 @@ const ${componentName$1} = registerClientReference(
 							headers: { "Content-Type": "application/json" },
 							body: JSON.stringify({
 								component_id: component.id,
-								component_code: component.code
+								component_code: component.code,
+								cache_config: component.cacheConfig
 							})
 						});
 						if (!registerResponse.ok) {
@@ -6162,7 +6197,7 @@ const ${componentName$1} = registerClientReference(
 			};
 			const handleServerComponentHMR = async (filePath) => {
 				try {
-					const { ServerComponentBuilder } = await import("./server-build-Cp6_RdeA.js");
+					const { ServerComponentBuilder } = await import("./server-build-DcbOtG3e.js");
 					const builder = new ServerComponentBuilder(projectRoot, {
 						outDir: "temp",
 						serverDir: "server",
@@ -6179,7 +6214,8 @@ const ${componentName$1} = registerClientReference(
 							headers: { "Content-Type": "application/json" },
 							body: JSON.stringify({
 								component_id: component.id,
-								component_code: component.code
+								component_code: component.code,
+								cache_config: component.cacheConfig
 							})
 						});
 						if (!registerResponse.ok) {
@@ -7507,7 +7543,49 @@ ${registrations.join("\n")}
 		}
 	};
 	const serverBuildPlugin = createServerBuildPlugin(options.serverBuild);
-	return [mainPlugin, serverBuildPlugin];
+	const cacheMiddlewarePlugin = {
+		name: "rari:cache-middleware",
+		configureServer(server) {
+			server.middlewares.use((req, res, next) => {
+				if (req.url?.startsWith("/@fs/")) {
+					res.setHeader("Cache-Control", "no-cache");
+					next();
+					return;
+				}
+				const url = req.url || "";
+				const pathname = url.split("?")[0];
+				if (pathname && !pathname.includes(".") && !pathname.startsWith("/api") && !pathname.startsWith("/rsc")) {
+					if (options.caching?.routes) {
+						for (const [pattern, cacheControl] of Object.entries(options.caching.routes)) if (matchesPattern(pattern, pathname)) {
+							res.setHeader("cache-control", cacheControl);
+							break;
+						}
+					}
+					const pagePath = pathname === "/" ? "/index" : pathname;
+					const pageFilePath = path.join(process$1.cwd(), "src/pages", `${pagePath.slice(1) || "index"}.tsx`);
+					if (fs.existsSync(pageFilePath)) {
+						const pageContent = fs.readFileSync(pageFilePath, "utf-8");
+						const cacheConfig = extractCacheConfigFromContent(pageContent);
+						if (cacheConfig) Object.entries(cacheConfig).forEach(([key, value]) => {
+							if (value) res.setHeader(key, value);
+						});
+					}
+				}
+				next();
+			});
+		},
+		writeBundle() {
+			if (options.caching) {
+				const cacheConfigPath = path.join(process$1.cwd(), "dist", "cache-config.json");
+				fs.writeFileSync(cacheConfigPath, JSON.stringify(options.caching, null, 2));
+			}
+		}
+	};
+	return [
+		mainPlugin,
+		serverBuildPlugin,
+		cacheMiddlewarePlugin
+	];
 }
 function defineRariConfig(config) {
 	return {
@@ -7517,4 +7595,4 @@ function defineRariConfig(config) {
 }
 
 //#endregion
-export { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes };
+export { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, defineRariOptions, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes };

package/dist/{server-build-DaBgiV55.js → server-build-BM8_GFF5.js}

@@ -64,13 +64,33 @@ var ServerComponentBuilder = class {
 		const code = fs.readFileSync(filePath, "utf-8");
 		const dependencies = this.extractDependencies(code);
 		const hasNodeImports = this.hasNodeImports(code);
+		const cacheConfig = this.extractCacheConfig(code);
 		this.serverComponents.set(filePath, {
 			filePath,
 			originalCode: code,
 			dependencies,
-			hasNodeImports
+			hasNodeImports,
+			cacheConfig
 		});
 	}
+	extractCacheConfig(code) {
+		try {
+			const cacheConfigRegex = /export\s+const\s+cacheConfig\s*[:=]\s*(\{[^}]*\})/;
+			const match = code.match(cacheConfigRegex);
+			if (match) {
+				const configStr = match[1];
+				const cacheControlMatch = configStr.match(/'cache-control'\s*:\s*['"]([^'"]+)['"]/);
+				const varyMatch = configStr.match(/'vary'\s*:\s*['"]([^'"]+)['"]/);
+				const config = {};
+				if (cacheControlMatch) config["cache-control"] = cacheControlMatch[1];
+				if (varyMatch) config.vary = varyMatch[1];
+				return Object.keys(config).length > 0 ? config : void 0;
+			}
+		} catch (error) {
+			console.warn(`Failed to extract cache config from component: ${error}`);
+		}
+		return void 0;
+	}
 	extractDependencies(code) {
 		const dependencies = [];
 		const importRegex = /import(?:\s+(?:\w+|\{[^}]*\}|\*\s+as\s+\w+)(?:\s*,\s*(?:\w+|\{[^}]*\}|\*\s+as\s+\w+))*\s+from\s+)?['"]([^'"]+)['"]/g;
@@ -118,7 +138,8 @@ var ServerComponentBuilder = class {
 			const transformedCode = await this.buildComponentCodeOnly(filePath, componentId, component);
 			components.push({
 				id: componentId,
-				code: transformedCode
+				code: transformedCode,
+				cacheConfig: component.cacheConfig
 			});
 		}
 		return components;

package/dist/server-build-DcbOtG3e.js

@@ -0,0 +1,3 @@
+import { ServerComponentBuilder, createServerBuildPlugin, scanDirectory } from "./server-build-BM8_GFF5.js";
+
+export { ServerComponentBuilder, scanDirectory };

package/dist/server.d.ts

@@ -1,3 +1,3 @@
-import { ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-P4vvSVPV.js";
-import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-CpxpL2un.js";
-export { ErrorBoundaryProps, FileRouteGenerator, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageComponent, PageProps, RouteComponent as Route, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, Route as RouteType, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };
+import { CacheConfig, ErrorBoundaryProps, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageCacheConfig, PageComponent, PageProps, Route, RouteComponent, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CwQkaktd.js";
+import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, defineRariOptions, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-Bna18v8X.js";
+export { CacheConfig, ErrorBoundaryProps, FileRouteGenerator, FileRouteInfo, HttpRuntimeClient, LayoutProps, Link, LinkProps, LoadingProps, Navigate, NavigationOptions, NavigationState, Outlet, PageCacheConfig, PageComponent, PageProps, RouteComponent as Route, RouteGenerationOptions, RouteMatch, RouteMeta, RouteParams, Route as RouteType, RouterConfig, RouterContext, RouterProvider, RouterProviderProps, Routes, RuntimeClient, SearchParams, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, defineRariOptions, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };

package/dist/server.js

@@ -1,5 +1,5 @@
 import { HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent, Routes, buildSearchString, buildUrl, createHttpRuntimeClient, extractParamNames, findMatchingRoute, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, normalizePathname, parseSearchParams, parseUrl, router_default, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, withRouter } from "./runtime-client-CcEhh-F7.js";
-import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-BrkE-3ny.js";
-import "./server-build-DaBgiV55.js";
+import { FileRouteGenerator, convertFilePatternToRoutePattern, createRouteManifest, defineRariConfig, defineRariOptions, generateFileRoutes, loadRouteManifest, rari, rariRouter, validateRoutes, watchFileRoutes } from "./server-DYwz6RKf.js";
+import "./server-build-BM8_GFF5.js";
 
-export { FileRouteGenerator, HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent as Route, router_default as RouterProvider, Routes, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };
+export { FileRouteGenerator, HttpRuntimeClient, Link, Navigate, Outlet, RouteComponent as Route, router_default as RouterProvider, Routes, buildSearchString, buildUrl, convertFilePatternToRoutePattern, createHttpRuntimeClient, createRouteManifest, defineRariConfig, defineRariOptions, extractParamNames, findMatchingRoute, generateFileRoutes, getRoutePriority, isDynamicRoute, isPathActive, joinPaths, loadRouteManifest, normalizePathname, parseSearchParams, parseUrl, rari, rariRouter, useNavigation, useParams, usePathname, useRoute, useRouter, useSearchParams, validateRoutes, watchFileRoutes, withRouter };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rari",
   "type": "module",
-  "version": "0.2.18",
+  "version": "0.2.19",
   "description": "Runtime Accelerated Rendering Infrastructure (Rari)",
   "author": "Ryan Skinner",
   "license": "MIT",
@@ -82,11 +82,11 @@
     "rollup-plugin-esbuild": "^6.2.1"
   },
   "optionalDependencies": {
-    "rari-darwin-arm64": "0.2.13",
-    "rari-darwin-x64": "0.2.13",
-    "rari-linux-arm64": "0.2.13",
-    "rari-linux-x64": "0.2.13",
-    "rari-win32-x64": "0.2.13"
+    "rari-darwin-arm64": "0.2.14",
+    "rari-darwin-x64": "0.2.14",
+    "rari-linux-arm64": "0.2.14",
+    "rari-linux-x64": "0.2.14",
+    "rari-win32-x64": "0.2.14"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/src/router/cache.ts

@@ -0,0 +1,54 @@
+export interface CacheConfig {
+  routes?: Record<string, string>
+  static?: string
+  serverComponents?: string
+}
+
+export interface PageCacheConfig {
+  'cache-control'?: string
+  'vary'?: string
+  [key: string]: string | undefined
+}
+
+const cacheConfigs = new Map<string, PageCacheConfig>()
+
+export function registerPageCacheConfig(pagePath: string, config: PageCacheConfig): void {
+  cacheConfigs.set(pagePath, config)
+}
+
+export function getPageCacheConfig(pagePath: string): PageCacheConfig | undefined {
+  return cacheConfigs.get(pagePath)
+}
+
+export function clearPageCacheConfigs(): void {
+  cacheConfigs.clear()
+}
+
+export function getAllPageCacheConfigs(): Map<string, PageCacheConfig> {
+  return new Map(cacheConfigs)
+}
+
+export function extractPageCacheConfig(pageModule: any): PageCacheConfig | undefined {
+  if (pageModule && typeof pageModule === 'object') {
+    return pageModule.cacheConfig
+  }
+  return undefined
+}
+
+export function registerPageCacheConfigFromModule(pagePath: string, pageModule: any): void {
+  const cacheConfig = extractPageCacheConfig(pageModule)
+  if (cacheConfig) {
+    registerPageCacheConfig(pagePath, cacheConfig)
+  }
+}
+
+export function applyCacheHeaders(
+  headers: Record<string, string>,
+  cacheConfig: PageCacheConfig,
+): void {
+  for (const [key, value] of Object.entries(cacheConfig)) {
+    if (value !== undefined) {
+      headers[key.toLowerCase()] = value
+    }
+  }
+}

package/src/router/types.ts

@@ -1,4 +1,5 @@
 import type { ComponentType, ReactNode } from 'react'
+import type { PageCacheConfig } from './cache'
 
 export interface Route {
   path: string
@@ -17,6 +18,7 @@ export interface RouteMeta {
   title?: string
   description?: string
   requiresAuth?: boolean
+  cacheConfig?: PageCacheConfig
   [key: string]: any
 }
 

package/src/server.ts

@@ -49,6 +49,8 @@ export type {
   SearchParams,
 } from './router'
 
+export type { CacheConfig, PageCacheConfig } from './router/cache'
+
 export {
   convertFilePatternToRoutePattern,
   createRouteManifest,
@@ -67,4 +69,4 @@ export { createHttpRuntimeClient, HttpRuntimeClient } from './runtime-client'
 
 export type { RuntimeClient } from './runtime-client'
 
-export { defineRariConfig, rari } from './vite'
+export { defineRariConfig, defineRariOptions, rari } from './vite'

package/src/vite/index.ts

@@ -1,5 +1,6 @@
 import type { Buffer } from 'node:buffer'
 import type { Plugin, UserConfig } from 'rolldown-vite'
+import type { CacheConfig, PageCacheConfig } from '../router/cache'
 import type { ServerBuildOptions } from './server-build'
 import { spawn } from 'node:child_process'
 import fs from 'node:fs'
@@ -12,6 +13,7 @@ interface RariOptions {
   projectRoot?: string
   serverBuild?: ServerBuildOptions
   serverHandler?: boolean
+  caching?: CacheConfig
 }
 
 function scanForClientComponents(srcDir: string): Set<string> {
@@ -50,6 +52,75 @@ function scanForClientComponents(srcDir: string): Set<string> {
   return clientComponents
 }
 
+export type { CacheConfig, PageCacheConfig } from '../router/cache'
+
+function extractCacheConfigFromContent(content: string): PageCacheConfig | undefined {
+  const ast = acorn.parse(content, {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    allowImportExportEverywhere: true,
+  }) as any
+
+  for (const node of ast.body) {
+    if (
+      node.type === 'ExportNamedDeclaration'
+      && node.declaration
+      && node.declaration.type === 'VariableDeclaration'
+    ) {
+      for (const declarator of node.declaration.declarations) {
+        if (
+          declarator.id
+          && declarator.id.name === 'cacheConfig'
+          && declarator.init
+          && declarator.init.type === 'ObjectExpression'
+        ) {
+          const config: PageCacheConfig = {}
+
+          for (const prop of declarator.init.properties) {
+            if (
+              prop.type === 'Property'
+              && prop.key
+              && prop.value
+              && prop.value.type === 'Literal'
+            ) {
+              const keyName = prop.key.type === 'Literal' ? prop.key.value : prop.key.name
+              if (keyName === 'cache-control' || keyName === 'vary') {
+                config[keyName as keyof PageCacheConfig] = prop.value.value as string
+              }
+            }
+          }
+
+          return Object.keys(config).length > 0 ? config : undefined
+        }
+      }
+    }
+  }
+
+  return undefined
+}
+
+function matchesPattern(pattern: string, path: string): boolean {
+  if (pattern === path)
+    return true
+
+  if (pattern.endsWith('/*')) {
+    const prefix = pattern.slice(0, -2)
+    return path.startsWith(prefix)
+  }
+
+  if (pattern.includes('*')) {
+    const regexPattern = pattern.replace(/\*/g, '.*').replace(/\//g, '\\/')
+    const regex = new RegExp(`^${regexPattern}$`)
+    return regex.test(path)
+  }
+
+  return false
+}
+
+export function defineRariOptions(config: RariOptions): RariOptions {
+  return config
+}
+
 export function rari(options: RariOptions = {}): Plugin[] {
   const componentTypeCache = new Map<string, 'client' | 'server' | 'unknown'>()
   const serverComponents = new Set<string>()
@@ -789,6 +860,7 @@ const ${componentName} = registerClientReference(
                   body: JSON.stringify({
                     component_id: component.id,
                     component_code: component.code,
+                    cache_config: component.cacheConfig,
                   }),
                 },
               )
@@ -1008,6 +1080,7 @@ const ${componentName} = registerClientReference(
                   body: JSON.stringify({
                     component_id: component.id,
                     component_code: component.code,
+                    cache_config: component.cacheConfig,
                   }),
                 },
               )
@@ -2405,7 +2478,58 @@ ${registrations.join('\n')}
 
   const serverBuildPlugin = createServerBuildPlugin(options.serverBuild)
 
-  return [mainPlugin, serverBuildPlugin]
+  const cacheMiddlewarePlugin: Plugin = {
+    name: 'rari:cache-middleware',
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        if (req.url?.startsWith('/@fs/')) {
+          res.setHeader('Cache-Control', 'no-cache')
+          next()
+          return
+        }
+
+        const url = req.url || ''
+        const pathname = url.split('?')[0]
+
+        if (pathname && !pathname.includes('.') && !pathname.startsWith('/api') && !pathname.startsWith('/rsc')) {
+          if (options.caching?.routes) {
+            for (const [pattern, cacheControl] of Object.entries(options.caching.routes)) {
+              if (matchesPattern(pattern, pathname)) {
+                res.setHeader('cache-control', cacheControl)
+                break
+              }
+            }
+          }
+
+          const pagePath = pathname === '/' ? '/index' : pathname
+          const pageFilePath = path.join(process.cwd(), 'src/pages', `${pagePath.slice(1) || 'index'}.tsx`)
+
+          if (fs.existsSync(pageFilePath)) {
+            const pageContent = fs.readFileSync(pageFilePath, 'utf-8')
+            const cacheConfig = extractCacheConfigFromContent(pageContent)
+
+            if (cacheConfig) {
+              Object.entries(cacheConfig).forEach(([key, value]) => {
+                if (value) {
+                  res.setHeader(key, value)
+                }
+              })
+            }
+          }
+        }
+
+        next()
+      })
+    },
+    writeBundle() {
+      if (options.caching) {
+        const cacheConfigPath = path.join(process.cwd(), 'dist', 'cache-config.json')
+        fs.writeFileSync(cacheConfigPath, JSON.stringify(options.caching, null, 2))
+      }
+    },
+  }
+
+  return [mainPlugin, serverBuildPlugin, cacheMiddlewarePlugin]
 }
 
 export function defineRariConfig(

package/src/vite/server-build.ts

@@ -1,4 +1,5 @@
 import type { Plugin } from 'rolldown-vite'
+import type { PageCacheConfig } from '../router/cache'
 import fs from 'node:fs'
 import path from 'node:path'
 import process from 'node:process'
@@ -14,6 +15,7 @@ export interface ServerComponentManifest {
       bundlePath: string
       dependencies: string[]
       hasNodeImports: boolean
+      cacheConfig?: PageCacheConfig
     }
   >
   version: string
@@ -35,6 +37,7 @@ export class ServerComponentBuilder {
       originalCode: string
       dependencies: string[]
       hasNodeImports: boolean
+      cacheConfig?: PageCacheConfig
     }
   >()
 
@@ -143,15 +146,45 @@ export class ServerComponentBuilder {
     const code = fs.readFileSync(filePath, 'utf-8')
     const dependencies = this.extractDependencies(code)
     const hasNodeImports = this.hasNodeImports(code)
+    const cacheConfig = this.extractCacheConfig(code)
 
     this.serverComponents.set(filePath, {
       filePath,
       originalCode: code,
       dependencies,
       hasNodeImports,
+      cacheConfig,
     })
   }
 
+  private extractCacheConfig(code: string): PageCacheConfig | undefined {
+    try {
+      const cacheConfigRegex = /export\s+const\s+cacheConfig\s*[:=]\s*(\{[^}]*\})/
+      const match = code.match(cacheConfigRegex)
+
+      if (match) {
+        const configStr = match[1]
+        const cacheControlMatch = configStr.match(/'cache-control'\s*:\s*['"]([^'"]+)['"]/)
+        const varyMatch = configStr.match(/'vary'\s*:\s*['"]([^'"]+)['"]/)
+
+        const config: PageCacheConfig = {}
+        if (cacheControlMatch) {
+          config['cache-control'] = cacheControlMatch[1]
+        }
+        if (varyMatch) {
+          config.vary = varyMatch[1]
+        }
+
+        return Object.keys(config).length > 0 ? config : undefined
+      }
+    }
+    catch (error) {
+      console.warn(`Failed to extract cache config from component: ${error}`)
+    }
+
+    return undefined
+  }
+
   private extractDependencies(code: string): string[] {
     const dependencies: string[] = []
     const importRegex
@@ -223,8 +256,8 @@ export class ServerComponentBuilder {
     )
   }
 
-  async getTransformedComponentsForDevelopment(): Promise<Array<{ id: string, code: string }>> {
-    const components: Array<{ id: string, code: string }> = []
+  async getTransformedComponentsForDevelopment(): Promise<Array<{ id: string, code: string, cacheConfig?: PageCacheConfig }>> {
+    const components: Array<{ id: string, code: string, cacheConfig?: PageCacheConfig }> = []
 
     for (const [filePath, component] of this.serverComponents) {
       const relativePath = path.relative(this.projectRoot, filePath)
@@ -235,6 +268,7 @@ export class ServerComponentBuilder {
       components.push({
         id: componentId,
         code: transformedCode,
+        cacheConfig: component.cacheConfig,
       })
     }
 

package/dist/server-build-Cp6_RdeA.js

@@ -1,3 +0,0 @@
-import { ServerComponentBuilder, createServerBuildPlugin, scanDirectory } from "./server-build-DaBgiV55.js";
-
-export { ServerComponentBuilder, scanDirectory };