@pracht/vite-plugin 0.9.0 → 0.10.0

package/dist/index.d.mts

@@ -136,7 +136,27 @@ interface PrachtLlmsTxtOptions {
    */
   exclude?: string[];
 }
+/**
+ * Optional client-router features, compiled out of the client bundle when
+ * disabled. Every one defaults to `true`. Turn a feature off only when the app
+ * really does not use it: the router silently stops honouring the
+ * corresponding route options and `<Link>` props.
+ */
+interface PrachtClientOptions {
+  /**
+   * JS prefetching of route-state JSON and route/shell chunks, driven by
+   * `route({ prefetch })` and `<Link prefetch>`. Off also drops the separate
+   * prefetch chunk the router loads on every page, and makes the imperative
+   * `prefetch()` export a no-op.
+   */
+  prefetch?: boolean;
+}
 interface PrachtPluginOptions {
+  /**
+   * Switch off client-router features the app does not use, so they are
+   * compiled out of the client bundle. See {@link PrachtClientOptions}.
+   */
+  client?: PrachtClientOptions;
   appFile?: string;
   routesDir?: string;
   shellsDir?: string;
@@ -267,4 +287,4 @@ declare function createPrachtWebmcpModuleSource(options?: PrachtPluginOptions, b
 //#region src/index.d.ts
 declare function pracht(options?: PrachtPluginOptions): Plugin[];
 //#endregion
-export { type EnvLeakReference, type EnvSafetyOptions, type LlmsTxtSection, PRACHT_CAPABILITIES_MODULE_ID, PRACHT_CLIENT_MODULE_ID, PRACHT_ISLANDS_CLIENT_MODULE_ID, PRACHT_SERVER_MODULE_ID, PRACHT_WEBMCP_MODULE_ID, PUBLIC_ENV_PREFIX, type PrachtAdapter, type PrachtLlmsTxtOptions, type PrachtPluginOptions, type RenderMode, VITE_BUILTIN_ENV_VARS, createEnvSafetyPlugin, createPrachtCapabilitiesClientModuleSource, createPrachtClientModuleSource, createPrachtIslandsClientModuleSource, createPrachtRegistryModuleSource, createPrachtServerModuleSource, createPrachtWebmcpModuleSource, extractCapabilities, formatEnvLeakError, pracht, scanCodeForEnvLeaks };
+export { type EnvLeakReference, type EnvSafetyOptions, type LlmsTxtSection, PRACHT_CAPABILITIES_MODULE_ID, PRACHT_CLIENT_MODULE_ID, PRACHT_ISLANDS_CLIENT_MODULE_ID, PRACHT_SERVER_MODULE_ID, PRACHT_WEBMCP_MODULE_ID, PUBLIC_ENV_PREFIX, type PrachtAdapter, type PrachtClientOptions, type PrachtLlmsTxtOptions, type PrachtPluginOptions, type RenderMode, VITE_BUILTIN_ENV_VARS, createEnvSafetyPlugin, createPrachtCapabilitiesClientModuleSource, createPrachtClientModuleSource, createPrachtIslandsClientModuleSource, createPrachtRegistryModuleSource, createPrachtServerModuleSource, createPrachtWebmcpModuleSource, extractCapabilities, formatEnvLeakError, pracht, scanCodeForEnvLeaks };

package/dist/index.mjs

@@ -1351,7 +1351,9 @@ function createDefaultNodeAdapter() {
 }
 //#endregion
 //#region src/plugin-options.ts
+const CLIENT_FEATURE_DEFAULTS = { prefetch: true };
 const DEFAULTS = {
+	client: CLIENT_FEATURE_DEFAULTS,
 	appFile: "/src/routes.ts",
 	middlewareDir: "/src/middleware",
 	routesDir: "/src/routes",
@@ -1377,6 +1379,7 @@ function resolveOptions(options) {
 		...options
 	};
 	if (resolved.llmsTxt === void 0) resolved.llmsTxt = false;
+	resolved.client = resolveClientOptions(options.client);
 	resolved.additionalExtensions = normalizeAdditionalExtensions(resolved.additionalExtensions);
 	if (!new Set([
 		"spa",
@@ -1390,6 +1393,20 @@ function resolveOptions(options) {
 	validateLlmsTxt(resolved.llmsTxt);
 	return resolved;
 }
+function resolveClientOptions(client) {
+	if (client === void 0) return CLIENT_FEATURE_DEFAULTS;
+	if (typeof client !== "object" || client === null) throw new Error("pracht({ client }) expects an options object.");
+	const resolved = { ...CLIENT_FEATURE_DEFAULTS };
+	for (const key of Object.keys(CLIENT_FEATURE_DEFAULTS)) {
+		const value = client[key];
+		if (value === void 0) continue;
+		if (typeof value !== "boolean") throw new Error(`pracht({ client: { ${key} } }) expects a boolean, got ${JSON.stringify(value)}.`);
+		resolved[key] = value;
+	}
+	const unknown = Object.keys(client).filter((key) => !(key in CLIENT_FEATURE_DEFAULTS));
+	if (unknown.length > 0) throw new Error(`pracht({ client }) does not accept ${unknown.map((key) => JSON.stringify(key)).join(", ")}. Known features: ${Object.keys(CLIENT_FEATURE_DEFAULTS).join(", ")}.`);
+	return resolved;
+}
 const LLMS_TXT_SECTIONS = new Set([
 	"pages",
 	"api",
@@ -1592,7 +1609,7 @@ function createPrachtCapabilitiesClientModuleSource(options = {}, buildOptions =
 		"// Generated by @pracht/vite-plugin from the app manifest capability registrations.",
 		"// Contains only http-exposed capability names, endpoints, and effects —",
 		"// capability modules themselves are server-only and never reach the client graph.",
-		"import { createUseCapability, withBase } from \"@pracht/core\";",
+		"import { createUseCapability, ensureCapabilityRevalidation, withBase } from \"@pracht/core\";",
 		"",
 		`const endpoints = Object.assign(Object.create(null), JSON.parse(${JSON.stringify(JSON.stringify(endpoints))}));`,
 		"",
@@ -1653,6 +1670,7 @@ function createPrachtCapabilitiesClientModuleSource(options = {}, buildOptions =
 		"}",
 		"",
 		"export async function callCapability(name, input, opts) {",
+		"  ensureCapabilityRevalidation();",
 		"  const endpoint = endpoints[name];",
 		"  if (!endpoint) {",
 		"    return {",
@@ -2854,6 +2872,7 @@ function pracht(options = {}) {
 			const publicEnvDefine = JSON.stringify(loadEnv(env.mode, envDir, PUBLIC_ENV_PREFIX));
 			const agentSurfaceDefine = env.command === "build" ? String(hasAgentSurface(resolved, configRoot)) : "true";
 			const staticTargetDefine = String(env.command === "build" && resolved.adapter.staticTarget === true);
+			const clientFeatureDefines = { __PRACHT_CLIENT_PREFETCH__: String(resolved.client.prefetch) };
 			return {
 				appType: "custom",
 				envPrefix: ["VITE_", PUBLIC_ENV_PREFIX],
@@ -2861,7 +2880,8 @@ function pracht(options = {}) {
 				define: {
 					__PRACHT_PUBLIC_ENV__: publicEnvDefine,
 					__PRACHT_AGENT_SURFACE__: agentSurfaceDefine,
-					__PRACHT_STATIC_TARGET__: staticTargetDefine
+					__PRACHT_STATIC_TARGET__: staticTargetDefine,
+					...clientFeatureDefines
 				},
 				...isSSRBuild ? {} : { build: { rollupOptions: {
 					...wantsIslandsEntry ? { input: [PRACHT_ISLANDS_CLIENT_MODULE_ID] } : {},
@@ -2885,7 +2905,7 @@ function pracht(options = {}) {
 					} } },
 					build: { rollupOptions: { external: [/^cloudflare:/] } }
 				} : {},
-				...!isEdge && isSSRBuild ? { ssr: { noExternal: [PRACHT_SSR_NO_EXTERNAL] } } : {}
+				...!isEdge && isSSRBuild || env.command === "serve" ? { ssr: { noExternal: [PRACHT_SSR_NO_EXTERNAL] } } : {}
 			};
 		},
 		configResolved(config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pracht/vite-plugin",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Vite plugin for Pracht apps with virtual modules, dev SSR, prerendering, route inspection, and multi-adapter builds.",
   "keywords": [
     "pracht",
@@ -46,10 +46,10 @@
     "@preact/preset-vite": "^2.10.5",
     "@prefresh/vite": "^2.0.0",
     "es-module-lexer": "^1.7.0",
-    "@pracht/adapter-node": "0.4.0",
+    "@pracht/adapter-node": "0.4.1",
     "@pracht/capabilities": "0.2.0",
-    "@pracht/preact-ssr-precompile": "0.1.3",
-    "@pracht/core": "0.14.0"
+    "@pracht/core": "0.15.0",
+    "@pracht/preact-ssr-precompile": "0.1.3"
   },
   "peerDependencies": {
     "vite": "^8.0.0"