@wular/pnext 0.0.6 → 0.0.8

package/src/render/static-slots-revive.ts

@@ -0,0 +1,65 @@
+import type { h, VNode } from 'preact'
+
+// Client half of the static-slot protocol, split out of ./static-slots so it stays PREACT-FREE:
+// entries import it eagerly, and a visible-dynamic entry must not pull preact into its static graph
+// (preact declares no `sideEffects: false`, so even an unused binding keeps the chunk import alive).
+// `createElement` is therefore threaded in from the island mount, where preact is lazily imported.
+
+export const ISLAND_STATIC_SLOT_ATTRIBUTE = 'data-pnext-static-slot'
+export const ISLAND_STATIC_SLOT_MARKER = '$$pnext_slot'
+
+type Props = Record<string, unknown>
+
+/** Cheap gate on the raw props attribute so islands with no element props skip the revive walk. */
+export function hasIslandStaticSlots(raw: string) {
+  return raw.includes(ISLAND_STATIC_SLOT_MARKER)
+}
+
+/**
+ * Client mount: swap each `$$pnext_slot` marker for a `pnext-static-slot` host holding the matching
+ * server-rendered DOM, converted to vnodes by the entry's DOM walker (so nested islands inside the
+ * adopted subtree become real island vnodes and hydrate on their own). The content is static server
+ * markup - it never re-renders, same as element children.
+ */
+export async function reviveIslandStaticSlots(
+  props: Props,
+  root: ParentNode,
+  toChildren: (node: ParentNode) => unknown,
+  createElement: typeof h,
+): Promise<Props> {
+  return (await reviveSlots(props, root, toChildren, createElement, new Set())) as Props
+}
+
+async function reviveSlots(
+  value: unknown,
+  root: ParentNode,
+  toChildren: (node: ParentNode) => unknown,
+  createElement: typeof h,
+  seen: Set<object>,
+): Promise<unknown> {
+  if (value === null || typeof value !== 'object' || seen.has(value)) return value
+  const marker = (value as Props)[ISLAND_STATIC_SLOT_MARKER]
+  if (typeof marker === 'string') {
+    const node = root.querySelector(`[${ISLAND_STATIC_SLOT_ATTRIBUTE}="${cssEscape(marker)}"]`)
+    // No server markup for this slot (the island never rendered the prop, or it was skipped for
+    // SSR): nothing to adopt, so the prop arrives null rather than as an empty host.
+    if (!node) return null
+    return createElement(
+      'pnext-static-slot',
+      { [ISLAND_STATIC_SLOT_ATTRIBUTE]: marker, style: { display: 'contents' } },
+      (await toChildren(node)) as VNode,
+    )
+  }
+  const proto = Object.getPrototypeOf(value) as object | null
+  if (!Array.isArray(value) && proto !== Object.prototype && proto !== null) return value
+  seen.add(value)
+  const target = value as Props
+  for (const key of Object.keys(target)) {
+    target[key] = await reviveSlots(target[key], root, toChildren, createElement, seen)
+  }
+  return value
+}
+
+function cssEscape(value: string) {
+  return value.replace(/["\\]/g, '\\$&')
+}

package/src/render/static-slots.ts

@@ -1,8 +1,9 @@
 import { h, type VNode } from 'preact'
 import { isElementLike } from '../utils/serialize'
+import { ISLAND_STATIC_SLOT_ATTRIBUTE, ISLAND_STATIC_SLOT_MARKER } from './static-slots-revive'
 
-export const ISLAND_STATIC_SLOT_ATTRIBUTE = 'data-pnext-static-slot'
-export const ISLAND_STATIC_SLOT_MARKER = '$$pnext_slot'
+// The client half lives in ./static-slots-revive (preact-free); re-exported so importers keep one entry point.
+export * from './static-slots-revive'
 
 type Props = Record<string, unknown>
 
@@ -52,55 +53,3 @@ function mapSlots(
   if (Array.isArray(value)) return mapped.map(([, item]) => item)
   return Object.fromEntries(mapped)
 }
-
-/** Cheap gate on the raw props attribute so islands with no element props skip the revive walk. */
-export function hasIslandStaticSlots(raw: string) {
-  return raw.includes(ISLAND_STATIC_SLOT_MARKER)
-}
-
-/**
- * Client mount: swap each `$$pnext_slot` marker for a `pnext-static-slot` host holding the matching
- * server-rendered DOM, converted to vnodes by the entry's DOM walker (so nested islands inside the
- * adopted subtree become real island vnodes and hydrate on their own). The content is static server
- * markup - it never re-renders, same as element children.
- */
-export async function reviveIslandStaticSlots(
-  props: Props,
-  root: ParentNode,
-  toChildren: (node: ParentNode) => unknown,
-): Promise<Props> {
-  return (await reviveSlots(props, root, toChildren, new Set())) as Props
-}
-
-async function reviveSlots(
-  value: unknown,
-  root: ParentNode,
-  toChildren: (node: ParentNode) => unknown,
-  seen: Set<object>,
-): Promise<unknown> {
-  if (value === null || typeof value !== 'object' || seen.has(value)) return value
-  const marker = (value as Props)[ISLAND_STATIC_SLOT_MARKER]
-  if (typeof marker === 'string') {
-    const node = root.querySelector(`[${ISLAND_STATIC_SLOT_ATTRIBUTE}="${cssEscape(marker)}"]`)
-    // No server markup for this slot (the island never rendered the prop, or it was skipped for
-    // SSR): nothing to adopt, so the prop arrives null rather than as an empty host.
-    if (!node) return null
-    return h(
-      'pnext-static-slot',
-      { [ISLAND_STATIC_SLOT_ATTRIBUTE]: marker, style: { display: 'contents' } },
-      (await toChildren(node)) as VNode,
-    )
-  }
-  const proto = Object.getPrototypeOf(value) as object | null
-  if (!Array.isArray(value) && proto !== Object.prototype && proto !== null) return value
-  seen.add(value)
-  const target = value as Props
-  for (const key of Object.keys(target)) {
-    target[key] = await reviveSlots(target[key], root, toChildren, seen)
-  }
-  return value
-}
-
-function cssEscape(value: string) {
-  return value.replace(/["\\]/g, '\\$&')
-}

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)