@wular/pnext 0.0.6 → 0.0.7

package/src/config.ts

@@ -3,7 +3,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url'
 import path from 'node:path'
 import { loadEnv } from './env'
 import { findWorkspaceRoot } from './resolve/imports'
-import type { PNextConfig } from './types'
+import { PREFETCH_MODES, type PNextConfig } from './types'
 import { setCacheComponents } from './render/ppr'
 
 export type ResolvedConfig = Required<Pick<PNextConfig, 'outDir' | 'basePath'>> &
@@ -86,6 +86,7 @@ export async function loadConfig(
       ? { compat: { ...(loadedConfig.default?.compat ?? {}), next: true } }
       : {}),
   }
+  validateConfig(config)
   // cacheComponents is a per-app flag on a process-global cell: clear it before
   // the next.config source re-derives it, so a pure-core (or flag-off) app
   // loaded after a cacheComponents app never inherits the previous build's flag.
@@ -128,6 +129,22 @@ export async function loadConfig(
   }
 }
 
+// One row per enum-valued config field; validateConfig checks them all.
+const enumFields: readonly [keyof PNextConfig, readonly unknown[]][] = [
+  ['prefetch', PREFETCH_MODES],
+]
+
+function validateConfig(config: PNextConfig) {
+  for (const [field, allowed] of enumFields) {
+    const value = config[field]
+    if (value === undefined || allowed.includes(value)) continue
+    const list = allowed.map(v => (typeof v === 'string' ? `'${v}'` : String(v))).join(', ')
+    throw new Error(
+      `Invalid pnext config: '${field}' must be one of ${list} (received ${JSON.stringify(value)}).`,
+    )
+  }
+}
+
 /** Dev's private subtree under the out root. Build never touches it. */
 export const devOutSegment = 'dev'
 

package/src/dev/server.ts

@@ -964,10 +964,10 @@ async function handleRoute(
 }
 
 function routeClientCacheKey(config: ResolvedConfig, route: RouteManifestEntry) {
-  const existing = routeCacheKeys.get(route.id)
+  const existing = routeCacheKeys.get(appKey(config.outPath, route.id))
   if (existing) return existing
   const key = devClientCacheKey(config, route, Boolean(config.compat?.next))
-  routeCacheKeys.set(route.id, key)
+  routeCacheKeys.set(appKey(config.outPath, route.id), key)
   return key
 }
 

package/src/render/renderer.ts

@@ -3655,6 +3655,7 @@ async function renderTree(
       renderCollectedHeadScripts(),
       bootstrapScripts,
       compatBuildManifestScript,
+      prefetchModeScript(options.config),
     ]
       .filter(Boolean)
       .join('\n'),
@@ -3791,6 +3792,16 @@ function shouldRenderRuntimeMetadataInBody(options: RenderOptions, runtimeMetada
   )
 }
 
+/**
+ * Inline script exposing the configured default prefetch mode to the client router, which applies it
+ * to links carrying no `data-prefetch` of their own. Emitted only when `prefetch` is configured - an
+ * app that leaves it unset keeps the global undefined and the built-in 'visible' default.
+ */
+function prefetchModeScript(config: ResolvedConfig): string {
+  if (config.prefetch === undefined) return ''
+  return `<script>window.__PNEXT_PREFETCH__=${JSON.stringify(config.prefetch)};</script>`
+}
+
 /**
  * Embeds the render's navigation state (children source path + each slot's
  * resolved source path). The client echoes it on soft-navigation fetches so

package/src/routing/href.ts

@@ -1,4 +1,4 @@
-import type { RouteParamValue } from '../types'
+import type { PrefetchMode, RouteParamValue } from '../types'
 
 export type SearchValue = string | number | boolean | null | undefined
 export type SearchInput = URLSearchParams | Record<string, SearchValue | SearchValue[]>
@@ -19,8 +19,10 @@ export function routeHref(route: string, options: HrefParts = {}) {
 declare global {
   interface Window {
     __PNEXT_TRAILING_SLASH__?: boolean
+    __PNEXT_PREFETCH__?: PrefetchMode
   }
   var __PNEXT_TRAILING_SLASH__: boolean | undefined
+  var __PNEXT_PREFETCH__: PrefetchMode | undefined
 }
 
 // With `trailingSlash: true` the server 308s bare page URLs to their slashed
@@ -44,6 +46,22 @@ export function getTrailingSlashUrls() {
   return isTrailingSlashEnabled()
 }
 
+// The app-wide default prefetch mode (config `prefetch`), for links that set
+// none of their own. Isomorphic like the trailing-slash seam: the server sets it
+// from the resolved config, the client reads the injected window global
+// (renderer's prefetchModeScript).
+export function setDefaultPrefetchMode(mode: PrefetchMode | undefined) {
+  globalThis.__PNEXT_PREFETCH__ = mode
+}
+
+export function getDefaultPrefetchMode(): PrefetchMode {
+  const mode =
+    process.browser || typeof window !== 'undefined'
+      ? window.__PNEXT_PREFETCH__
+      : globalThis.__PNEXT_PREFETCH__
+  return mode === undefined ? 'visible' : mode
+}
+
 // The configured basePath ('' when unset). Set once per process by the server
 // runtime from the resolved config (registerServerRuntime), mirroring the
 // trailing-slash seam. Core render code (metadata) reads it through

package/src/runtime/loader.ts

@@ -41,7 +41,7 @@ import {
 } from '../resolve/dynamic'
 import { cacheRoot } from './module-cache'
 import { readNodeModuleBundle, writeNodeModuleBundle } from '../dev/restart/node-modules'
-import { setBasePathPrefix, setTrailingSlashUrls } from '../routing/href'
+import { setBasePathPrefix, setDefaultPrefetchMode, setTrailingSlashUrls } from '../routing/href'
 import { resolveExternalLoadTarget, resolveImport, workspacePackageRoots } from '../resolve/imports'
 import { escapeRegex } from '../utils/code'
 import { writeFileAtomic } from '../utils/fs'
@@ -169,6 +169,8 @@ export function registerServerRuntime(config: ResolvedConfig, sourceFiles: strin
   // File-convention metadata asset hrefs (og-image, manifest) carry the
   // basePath prefix; core render reads it through the href seam.
   setBasePathPrefix(typeof config.basePath === 'string' ? config.basePath : '')
+  // Server-rendered Links bake the configured default into `data-prefetch`.
+  setDefaultPrefetchMode(config.prefetch)
   if (typeof Bun === 'undefined') return
   const sourceRoots = [...new Set(sourceFiles.map(file => sourceRootForFile(config, file)))].sort()
   const signature = sourceRoots.join('\0')

package/src/runtime/vendor.ts

@@ -422,13 +422,14 @@ async function runVendorDemand(plan: VendorBuildPlan, nested: boolean, ticket: V
  *
  * Every demand pays it before it can even learn it has no siblings, and it is a timer on the one JS thread
  * the concurrent bundlers already saturate with plugin IPC, so the real wait is bounded below by this rather
- * than by it. `PNEXT_VENDOR_GROUP_WINDOW_MS` is the bisect seam.
+ * than by it. `PNEXT_VENDOR_GROUP_WINDOW_MS` is the bisect seam, read per round so
+ * tests can widen it after module load.
  */
-const VENDOR_GROUP_WINDOW_MS = (() => {
+function vendorGroupWindowMs() {
   // eslint-disable-next-line turbo/no-undeclared-env-vars
   const override = Number(process.env.PNEXT_VENDOR_GROUP_WINDOW_MS)
   return Number.isFinite(override) && override >= 0 ? override : 5
-})()
+}
 
 /**
  * A group re-parses the package graph once per round, so an unbounded trickle
@@ -515,7 +516,7 @@ function runVendorGroupRound(
 }
 
 async function vendorGroupRound(group: VendorGroupPlan, state: VendorGroupState, nested: boolean) {
-  await new Promise(resolve => setTimeout(resolve, VENDOR_GROUP_WINDOW_MS))
+  await new Promise(resolve => setTimeout(resolve, vendorGroupWindowMs()))
   const members = [...state.pending.values()]
   if (members.length === 0) return
   // A lone subpath with no sibling to share a graph with is the single-bundle

package/src/types.ts

@@ -2,7 +2,8 @@ import type { ComponentChildren } from 'preact'
 
 export type RouteMode = 'static' | 'dynamic'
 
-export type PrefetchMode = false | 'intent' | 'visible' | 'load'
+export const PREFETCH_MODES = ['visible', 'intent', 'load', false] as const
+export type PrefetchMode = (typeof PREFETCH_MODES)[number]
 
 export interface PNextRoutes {
   readonly __pnext_internal_route_brand?: never
@@ -30,6 +31,9 @@ export interface PNextConfig {
   // Link hrefs / client navigation (the raw path is preserved end to end).
   skipTrailingSlashRedirect?: boolean
   htmlLimitedBots?: RegExp
+  // App-wide default prefetch mode for client-router links that set none of
+  // their own. `false` means links never prefetch unless they opt in.
+  prefetch?: PrefetchMode
   // Emit browser sourcemaps from the production client build. Off by default,
   // matching Next: shipping maps publishes your source to every visitor, and
   // generating them costs real build time. Dev never emits them (the

package/reference/overview.md

@@ -1,35 +0,0 @@
-# pnext
-
-pnext is a Preact framework for file-routed applications. It keeps familiar Next-style routing and rendering semantics where they help, and diverges where pnext needs a simpler or smaller model.
-
-It renders on the server by default, passes request data through explicit props, provides strong generated route type safety, and ships client JavaScript only for components that opt into running in the browser.
-
-## Core Model
-
-- Routes live in an `app/` directory.
-- `page.tsx` files define UI routes.
-- `layout.tsx` files export metadata, viewport, and can wrap descendant pages.
-- `route.ts` files define HTTP handlers.
-- `proxy.ts` or `middleware.ts` can run before route matching.
-- `loading.tsx`, `error.tsx`, and `not-found.tsx` define route fallbacks.
-- Pages and layouts are pnext Server Components by default.
-- Server components can be async.
-- Pages without client components emit HTML without pnext client JavaScript.
-- Client Components can be loaded with `dynamic({ load: 'visible' })` and deferred until visible.
-- React compatibility mode supported via `compat.react`.
-- Next compatibility mode supported via `compat.next`.
-- Experimental React Compiler support for React-style Client Components via `compat.reactCompiler`.
-
-## References
-
-- [Config](./config.md)
-- [Routing](./routing.md)
-- [Metadata](./metadata.md)
-- [Navigation](./navigation.md)
-- [Rendering](./rendering.md)
-- [CSS](./css.md)
-- [Environment Variables](./env.md)
-- [Compatibility](./compat.md)
-- [Typegen](./typegen.md)
-- [Dev Server](./dev.md)
-- [Performance](./performance.md)