@timber-js/app 0.2.0-alpha.192 → 0.2.0-alpha.195

package/dist/server/rsc-entry/rsc-payload.d.ts

@@ -7,10 +7,10 @@
  *
  * Design docs: 19-client-navigation.md §"RSC Payload Handling"
  */
-import type { LayoutComponentEntry } from '../route-element-builder.js';
-import type { ManifestSegmentNode } from '../route-matcher.js';
-import type { SlotSkipEntry } from '../slot-resolver.js';
-import type { RenderSignals } from './rsc-stream.js';
+import type { LayoutComponentEntry } from '../route-element-builder.ts';
+import type { ManifestSegmentNode } from '../route-matcher.ts';
+import type { SlotSkipEntry } from '../slot-resolver.ts';
+import type { RenderSignals } from './rsc-stream.ts';
 /**
  * Build an RSC payload Response for a client-side navigation request.
  *

package/dist/server/rsc-entry/rsc-payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rsc-payload.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/rsc-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWrD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,gBAAgB,EAAE,oBAAoB,EAAE,EACxC,eAAe,EAAE,OAAO,EACxB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,YAAY,CAAC,EAAE,aAAa,EAAE,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAyPnB"}
+{"version":3,"file":"rsc-payload.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/rsc-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAWrD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,gBAAgB,EAAE,oBAAoB,EAAE,EACxC,eAAe,EAAE,OAAO,EACxB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,YAAY,CAAC,EAAE,aAAa,EAAE,GAC7B,OAAO,CAAC,QAAQ,CAAC,CA6PnB"}

package/dist/server/rsc-entry/rsc-stream.d.ts

@@ -9,9 +9,9 @@
  * Design docs: 02-rendering-pipeline.md §"Single-Pass Rendering",
  *              13-security.md §"Errors don't leak"
  */
-import type { RscPayloadRoot } from '../../shared/payload-root.js';
-import { DenySignal, RedirectSignal } from '../primitives.js';
-import { type DebugComponentEntry } from './helpers.js';
+import type { RscPayloadRoot } from '../../shared/payload-root.ts';
+import { DenySignal, RedirectSignal } from '../primitives.ts';
+import { type DebugComponentEntry } from './helpers.ts';
 /**
  * Mutable signal state captured during RSC rendering.
  *

package/dist/server/rsc-entry/ssr-bridge.d.ts

@@ -5,6 +5,6 @@
  * Vite module graphs; `NavContext` is the serializable contract that crosses
  * the boundary. See `../ssr-bridge-types.ts` for the contract definition.
  */
-import type { NavContext } from '../ssr-bridge-types.js';
+import type { NavContext } from '../ssr-bridge-types.ts';
 export declare function callSsr(rscStream: ReadableStream<Uint8Array>, navContext: NavContext): Promise<Response>;
 //# sourceMappingURL=ssr-bridge.d.ts.map

package/dist/server/rsc-entry/ssr-renderer.d.ts

@@ -11,13 +11,13 @@
  * Design docs: 02-rendering-pipeline.md §"RSC → SSR → Client Hydration",
  *              05-streaming.md §"deferSuspenseFor and the Hold Window"
  */
-import type { ClientBootstrapConfig } from '../html-injectors.js';
-import type { RouteMatch } from '../pipeline.js';
-import type { LayoutComponentEntry } from '../route-element-builder.js';
-import type { ManifestSegmentNode } from '../route-matcher.js';
-import type { SlotSkipEntry } from '../slot-resolver.js';
-import { type GlobalErrorFile } from './error-renderer.js';
-import type { RenderSignals } from './rsc-stream.js';
+import type { ClientBootstrapConfig } from '../html-injectors.ts';
+import type { RouteMatch } from '../pipeline.ts';
+import type { LayoutComponentEntry } from '../route-element-builder.ts';
+import type { ManifestSegmentNode } from '../route-matcher.ts';
+import type { SlotSkipEntry } from '../slot-resolver.ts';
+import { type GlobalErrorFile } from './error-renderer.ts';
+import type { RenderSignals } from './rsc-stream.ts';
 /**
  * Test-only observable: records how many microtask yields were consumed
  * during the last signal promotion check. Import this in tests to assert

package/dist/server/rsc-entry/wrap-action-dispatch.d.ts

@@ -26,11 +26,11 @@
  * validation runs at the pipeline boundary. Per-action auth/validation
  * belongs in `createActionClient({ middleware })`.
  */
-import type { BodyLimitsConfig } from '../body-limits.js';
-import { type CsrfConfig } from '../csrf.js';
-import type { RouteMatcher } from '../pipeline.js';
-import type { SensitiveFieldsOption } from '../sensitive-fields.js';
-import type { RevalidateRenderer } from '../actions.js';
+import type { BodyLimitsConfig } from '../body-limits.ts';
+import { type CsrfConfig } from '../csrf.ts';
+import type { RouteMatcher } from '../pipeline.ts';
+import type { SensitiveFieldsOption } from '../sensitive-fields.ts';
+import type { RevalidateRenderer } from '../actions.ts';
 /**
  * Build a `RevalidateRenderer` for a specific request.
  *

package/dist/server/sitemap-generator.d.ts

@@ -13,8 +13,8 @@
  *
  * See design/16-metadata.md §"Auto-generated Sitemap"
  */
-import type { SegmentNode } from '../routing/types.js';
-import type { CoercedParams } from '../shared/param-value.js';
+import type { SegmentNode } from '../routing/types.ts';
+import type { CoercedParams } from '../shared/param-value.ts';
 /** Configuration for sitemap generation from timber.config.ts. */
 export interface SitemapConfig {
     /** Must be explicitly true to enable auto-generation. */

package/dist/server/sitemap-handler.d.ts

@@ -9,7 +9,7 @@
  *
  * See design/16-metadata.md §"Auto-generated Sitemap"
  */
-import type { SegmentNode } from '../routing/types.js';
+import type { SegmentNode } from '../routing/types.ts';
 /**
  * Create the auto-sitemap request handler for the pipeline.
  *

package/dist/server/skippable-prefix.d.ts

@@ -6,9 +6,9 @@
  * segment's layout still be skipped, given what its slots would render?" — with
  * no dependency on element construction.
  */
-import type { ManifestSegmentNode } from './route-matcher.js';
-import type { RouteMatch } from './pipeline.js';
-import { type ClientStateTree } from './state-tree-diff.js';
+import type { ManifestSegmentNode } from './route-matcher.ts';
+import type { RouteMatch } from './pipeline.ts';
+import { type ClientStateTree } from './state-tree-diff.ts';
 /**
  * Truncate the skippable prefix when a skippable layout has slots whose
  * content changed between the departing and destination URLs (TIM-1232).

package/dist/server/slot-interception.d.ts

@@ -14,8 +14,8 @@
  *
  * See design/07-routing.md §"Intercepting Routes"
  */
-import type { ManifestSegmentNode } from './route-matcher.js';
-import type { SlotMatchResult } from './slot-resolver.js';
+import type { ManifestSegmentNode } from './route-matcher.ts';
+import type { SlotMatchResult } from './slot-resolver.ts';
 /**
  * Find a matching intercepting route in a slot's children for the target pathname.
  *

package/dist/server/slot-resolver.d.ts

@@ -15,9 +15,9 @@
  *
  * See design/02-rendering-pipeline.md §"Parallel Slots"
  */
-import type { InterceptionContext, RouteMatch } from './pipeline.js';
-import type { ManifestSegmentNode } from './route-matcher.js';
-import { type ClientStateTree } from './state-tree-diff.js';
+import type { InterceptionContext, RouteMatch } from './pipeline.ts';
+import type { ManifestSegmentNode } from './route-matcher.ts';
+import { type ClientStateTree } from './state-tree-diff.ts';
 type CreateElementFn = (...args: unknown[]) => React.ReactElement;
 /**
  * Resolve the element for a parallel slot.
@@ -74,10 +74,6 @@ export interface SlotMatchResult {
  * pathname at the same point and already used `indexOf(owner)`. Two derivations
  * of one index is how they came apart; this is the shared one.
  *
- * The `urlPath` search survives only as a fallback for a `slotNode` that is not
- * attached to any segment in the chain. Production never does that —
- * `resolveSlotProps` iterates `segment.slots` — but unit tests construct a slot
- * node standalone, and for those the old behaviour is still the right answer.
  */
 export declare function findSlotOwnerIndex(slotNode: ManifestSegmentNode, segments: ManifestSegmentNode[]): number;
 export interface SlotSkipEntry {

package/dist/server/slot-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slot-resolver.d.ts","sourceRoot":"","sources":["../../src/server/slot-resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"slot-resolver.d.ts","sourceRoot":"","sources":["../../src/server/slot-resolver.ts"],"names":[],"mappings":"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"}

package/dist/server/ssr-bridge-types.d.ts

@@ -28,8 +28,8 @@
  * See `design/02-rendering-pipeline.md` §"RSC → SSR → Client Hydration"
  * and `CLAUDE.md` §"RSC and SSR Are Separate Vite Environments".
  */
-import type { CoercedParams } from '../shared/param-value.js';
-import type { SlotParamsRecord } from '../shared/slot-params.js';
+import type { CoercedParams } from '../shared/param-value.ts';
+import type { SlotParamsRecord } from '../shared/slot-params.ts';
 /**
  * Navigation context passed from the RSC environment to SSR.
  *

package/dist/server/ssr-entry.d.ts

@@ -11,7 +11,7 @@
  *
  * Design docs: 18-build-system.md §"Entry Files", 02-rendering-pipeline.md
  */
-import type { NavContext } from './ssr-bridge-types.js';
+import type { NavContext } from './ssr-bridge-types.ts';
 /**
  * Handle SSR: decode an RSC stream and render it to hydration-ready HTML.
  *

package/dist/server/static-generator.d.ts

@@ -18,7 +18,7 @@
  *
  * Design docs: design/11-platform.md §"static output mode"
  */
-import type { ManifestRoot, ManifestSegmentNode } from './route-matcher.js';
+import type { ManifestRoot, ManifestSegmentNode } from './route-matcher.ts';
 /** A single rendered static page ready for the caller to write to disk. */
 export interface StaticPageEntry {
     /** The URL path (e.g., "/about", "/blog/first-post"). */

package/dist/server/static-not-found.d.ts

@@ -11,7 +11,7 @@
  * it can be exercised directly: every branch is a different diagnosis handed
  * to a developer, and a wrong one sends them to the wrong file.
  */
-import type { ManifestSegmentNode } from './route-matcher.js';
+import type { ManifestSegmentNode } from './route-matcher.ts';
 /**
  * The probe path. `_timber/` is the framework's reserved prefix and
  * `__not_found` is a private segment (double underscore), so user routes —

package/dist/server/status-code-resolver.d.ts

@@ -30,7 +30,7 @@
  *   Per-segment (leaf → root): {status}.tsx → 5xx.tsx → error.tsx
  *   Then framework default (returns null)
  */
-import type { SegmentNode } from '../routing/types.js';
+import type { SegmentNode } from '../routing/types.ts';
 /** How the status-code file was matched. */
 export type StatusFileKind = 'exact' | 'category' | 'error';
 /** Response format family for status-code resolution. */

package/dist/server/tracing.d.ts

@@ -7,8 +7,8 @@
  *
  * See design/17-logging.md §"trace_id is Always Set"
  */
-import { type TraceStore } from './als-registry.js';
-export type { TraceStore } from './als-registry.js';
+import { type TraceStore } from './als-registry.ts';
+export type { TraceStore } from './als-registry.ts';
 /**
  * Returns the current request's trace ID — always a 32-char lowercase hex string.
  *
@@ -59,7 +59,7 @@ export declare function getTraceStore(): TraceStore | undefined;
  * Idempotent across module re-evaluations (HMR) — only the first call
  * registers. Only called in dev mode — zero overhead in production.
  */
-export declare function initDevTracing(config: import('../dev-tools/logger.js').DevLoggerConfig): Promise<void>;
+export declare function initDevTracing(config: import('../dev-tools/logger.ts').DevLoggerConfig): Promise<void>;
 /**
  * A native platform span. Mirrors the subset of the Cloudflare Workers
  * `Span` API that timber uses. See design/17-logging.md §"Cloudflare Native

package/dist/server/tree-builder.d.ts

@@ -10,8 +10,8 @@
  * See design/02-rendering-pipeline.md §"Element Tree Construction"
  */
 import type { ReactNode } from 'react';
-import type { RouteFile, SegmentNode } from '../routing/types.js';
-import type { LoadedComponent } from './utils/element-type.js';
+import type { RouteFile, SegmentNode } from '../routing/types.ts';
+import type { LoadedComponent } from './utils/element-type.ts';
 /** A loaded module for a route file convention. */
 export interface LoadedModule {
     /** The default export (component, access function, etc.) */
@@ -88,7 +88,7 @@ export interface AccessGateProps {
      * Omitted for skipped segments — a deny there must hard-navigate to
      * avoid rendering the deny page inside cached layout chrome (TIM-1074).
      */
-    denyPages?: import('./deny-boundary.js').DenyPageEntry[];
+    denyPages?: import('./deny-boundary.ts').DenyPageEntry[];
     /**
      * When true, this gate wraps a skipped segment. On deny, the gate
      * records the deny in ALS and rethrows so the response path can

package/dist/server/tree-match.d.ts

@@ -14,7 +14,7 @@
  *
  * See design/07-routing.md §"Request Lifecycle" and TIM-940.
  */
-import type { SegmentNode } from '../routing/types.js';
+import type { SegmentNode } from '../routing/types.ts';
 /** Result of matching URL parts against a segment tree. */
 export interface TreeMatchResult<TFile> {
     /** Matched segment chain from root to leaf, inclusive. */

package/dist/server/types.d.ts

@@ -1,5 +1,5 @@
-import type { CoercedParams } from '../shared/param-value.js';
-import type { EarlyHint } from './early-hints.js';
+import type { CoercedParams } from '../shared/param-value.ts';
+import type { EarlyHint } from './early-hints.ts';
 /**
  * A value that is safe to pass through `JSON.stringify` without data loss.
  *

package/dist/server/utils/mdx-file.d.ts

@@ -8,6 +8,8 @@
  *
  * See design/10-error-handling.md §"Status-Code File Variants".
  */
+/** MDX/markdown extensions (dotted) — the canonical list, also used by plugins/mdx.ts. */
+export declare const MDX_EXTENSIONS: Set<string>;
 /**
  * Check if a file path ends with an MDX/markdown extension.
  */

package/dist/server/utils/mdx-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdx-file.d.ts","sourceRoot":"","sources":["../../../src/server/utils/mdx-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIvD"}
+{"version":3,"file":"mdx-file.d.ts","sourceRoot":"","sources":["../../../src/server/utils/mdx-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0FAA0F;AAC1F,eAAO,MAAM,cAAc,aAA2B,CAAC;AAEvD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIvD"}

package/dist/server/workers-cache-bridge.d.ts

@@ -8,7 +8,7 @@
  *
  * Design doc: design/06-caching.md, design/25-production-deployments.md
  */
-import type { WorkersCachePurgeCtx } from './als-registry.js';
+import type { WorkersCachePurgeCtx } from './als-registry.ts';
 /**
  * Run a function with Workers Cache purge context available.
  *

package/dist/shared/als-slots.d.ts

@@ -30,7 +30,7 @@
  * See design/23-search-params.md §"defineSearchParams — The Factory" and
  * design/41-global-params.md.
  */
-import type { CoercedParams } from './param-value.js';
+import type { CoercedParams } from './param-value.ts';
 /** @internal Called from `server/request-context.ts` at module init. */
 export declare const _setGetSearchParamsFn: (fn: () => URLSearchParams) => void;
 /** @internal Read by `search-params/define.ts` inside `.get()`. */

package/dist/shared/payload-root.d.ts

@@ -31,8 +31,8 @@
  * through `server/publish-params.ts` and the client reads them through the
  * helpers here — producer and consumer do not each describe the payload.
  */
-import type { CoercedParams } from './param-value.js';
-import type { SlotParamsRecord } from './slot-params.js';
+import type { CoercedParams } from './param-value.ts';
+import type { SlotParamsRecord } from './slot-params.ts';
 /** The params published beside a tree. */
 export interface PublishedParams {
     /** The main route's coerced params. */

package/dist/shared/rsc-media-type.d.ts

@@ -37,4 +37,16 @@ export declare const RSC_CONTENT_TYPE = "text/x-component";
  * to move the adapter's generated `isRsc` in the same commit — see above.
  */
 export declare function isRscRequest(req: Request): boolean;
+/**
+ * Does this Content-Type header value designate an RSC Flight payload?
+ *
+ * Case-insensitive exact media-type match per RFC 9110 §8.3.1 — media types
+ * are case-insensitive. Parameters (`;charset=utf-8`) are stripped before
+ * comparison.
+ *
+ * Contrast with `isRscRequest`, which uses substring containment because
+ * `Accept` is a list of types. A `Content-Type` header names exactly one
+ * type, so substring would over-match (e.g. `text/x-component-v2`).
+ */
+export declare function isRscContentType(contentType: string | null): boolean;
 //# sourceMappingURL=rsc-media-type.d.ts.map

package/dist/shared/rsc-media-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rsc-media-type.d.ts","sourceRoot":"","sources":["../../src/shared/rsc-media-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAElD"}
+{"version":3,"file":"rsc-media-type.d.ts","sourceRoot":"","sources":["../../src/shared/rsc-media-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGpE"}

package/dist/shared/slot-params.d.ts

@@ -17,7 +17,7 @@
  *
  * See design/41-global-params.md §"Params in a parallel slot".
  */
-import type { CoercedParams } from './param-value.js';
+import type { CoercedParams } from './param-value.ts';
 /** Slot tree path → that slot's own coerced params. */
 export type SlotParamsRecord = Record<string, CoercedParams>;
 /**

package/dist/shims/font-google.d.ts

@@ -16,7 +16,7 @@
  *
  * Design doc: 24-fonts.md, "Next.js Font Compatibility"
  */
-import type { GoogleFontConfig, FontResult } from '../fonts/types.js';
+import type { GoogleFontConfig, FontResult } from '../fonts/types.ts';
 export type { GoogleFontConfig, FontResult };
 /**
  * Generic font loader — accepts any font name, returns a stub FontResult.

package/dist/shims/font-google.js.map

@@ -1 +1 @@
-{"version":3,"file":"font-google.js","names":[],"sources":["../../src/shims/font-google.ts"],"sourcesContent":["/**\n * Fallback shim for `next/font/google` → `@timber/fonts/google`.\n *\n * At build time, the timber-fonts plugin's transform hook replaces font\n * function calls with static FontResult objects containing real class names\n * and font stacks. This file serves two purposes:\n *\n * 1. **TypeScript resolution** — provides types for IDEs and `tsc` outside\n *    of Vite's module graph (where the virtual module handles it).\n * 2. **Runtime fallback** — returns empty className/fontFamily values when\n *    the plugin hasn't processed a call (e.g. in tests or non-Vite environments).\n *\n * The shim resolution path (`next/font/google` → `\\0@timber/fonts/google`)\n * is unchanged — this file is NOT on that resolution path. It exists as a\n * physical module for direct imports and type re-exports.\n *\n * Design doc: 24-fonts.md, \"Next.js Font Compatibility\"\n */\n\nimport type { GoogleFontConfig, FontResult } from '../fonts/types.js';\n\nexport type { GoogleFontConfig, FontResult };\n\n/**\n * Create a stub FontResult with empty values.\n *\n * The timber-fonts plugin replaces these calls at build time with real\n * class names and font stacks. This stub ensures code that imports\n * font functions outside of the build pipeline (tests, type-checking)\n * gets a valid FontResult shape without runtime errors.\n */\nfunction createStubFontResult(config?: GoogleFontConfig): FontResult {\n  return {\n    className: '',\n    style: { fontFamily: '' },\n    variable: config?.variable,\n  };\n}\n\n/**\n * Generic font loader — accepts any font name, returns a stub FontResult.\n *\n * Named exports like `Inter`, `Roboto`, etc. are generated dynamically\n * by the virtual module at build time. This function provides a catch-all\n * for non-Vite contexts.\n */\nexport function createFont(_family: string, config?: GoogleFontConfig): FontResult {\n  return createStubFontResult(config);\n}\n\n// Common Google Font exports for TypeScript autocomplete.\n// These are stubs — the virtual module and transform hook provide real values.\nexport const Inter = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Roboto = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Open_Sans = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Lato = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Montserrat = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Poppins = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Geist = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Geist_Mono = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const JetBrains_Mono = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Source_Code_Pro = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Playfair_Display = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Merriweather = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\n"],"mappings":";;;;;;;;;AA+BA,SAAS,qBAAqB,QAAuC;CACnE,OAAO;EACL,WAAW;EACX,OAAO,EAAE,YAAY,GAAG;EACxB,UAAU,QAAQ;CACpB;AACF;;;;;;;;AASA,SAAgB,WAAW,SAAiB,QAAuC;CACjF,OAAO,qBAAqB,MAAM;AACpC;AAIA,IAAa,SAAS,WAA0C,qBAAqB,MAAM;AAC3F,IAAa,UAAU,WAA0C,qBAAqB,MAAM;AAC5F,IAAa,aAAa,WAA0C,qBAAqB,MAAM;AAC/F,IAAa,QAAQ,WAA0C,qBAAqB,MAAM;AAC1F,IAAa,cAAc,WAA0C,qBAAqB,MAAM;AAChG,IAAa,WAAW,WAA0C,qBAAqB,MAAM;AAC7F,IAAa,SAAS,WAA0C,qBAAqB,MAAM;AAC3F,IAAa,cAAc,WAA0C,qBAAqB,MAAM;AAChG,IAAa,kBAAkB,WAC7B,qBAAqB,MAAM;AAC7B,IAAa,mBAAmB,WAC9B,qBAAqB,MAAM;AAC7B,IAAa,oBAAoB,WAC/B,qBAAqB,MAAM;AAC7B,IAAa,gBAAgB,WAA0C,qBAAqB,MAAM"}
+{"version":3,"file":"font-google.js","names":[],"sources":["../../src/shims/font-google.ts"],"sourcesContent":["/**\n * Fallback shim for `next/font/google` → `@timber/fonts/google`.\n *\n * At build time, the timber-fonts plugin's transform hook replaces font\n * function calls with static FontResult objects containing real class names\n * and font stacks. This file serves two purposes:\n *\n * 1. **TypeScript resolution** — provides types for IDEs and `tsc` outside\n *    of Vite's module graph (where the virtual module handles it).\n * 2. **Runtime fallback** — returns empty className/fontFamily values when\n *    the plugin hasn't processed a call (e.g. in tests or non-Vite environments).\n *\n * The shim resolution path (`next/font/google` → `\\0@timber/fonts/google`)\n * is unchanged — this file is NOT on that resolution path. It exists as a\n * physical module for direct imports and type re-exports.\n *\n * Design doc: 24-fonts.md, \"Next.js Font Compatibility\"\n */\n\nimport type { GoogleFontConfig, FontResult } from '../fonts/types.ts';\n\nexport type { GoogleFontConfig, FontResult };\n\n/**\n * Create a stub FontResult with empty values.\n *\n * The timber-fonts plugin replaces these calls at build time with real\n * class names and font stacks. This stub ensures code that imports\n * font functions outside of the build pipeline (tests, type-checking)\n * gets a valid FontResult shape without runtime errors.\n */\nfunction createStubFontResult(config?: GoogleFontConfig): FontResult {\n  return {\n    className: '',\n    style: { fontFamily: '' },\n    variable: config?.variable,\n  };\n}\n\n/**\n * Generic font loader — accepts any font name, returns a stub FontResult.\n *\n * Named exports like `Inter`, `Roboto`, etc. are generated dynamically\n * by the virtual module at build time. This function provides a catch-all\n * for non-Vite contexts.\n */\nexport function createFont(_family: string, config?: GoogleFontConfig): FontResult {\n  return createStubFontResult(config);\n}\n\n// Common Google Font exports for TypeScript autocomplete.\n// These are stubs — the virtual module and transform hook provide real values.\nexport const Inter = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Roboto = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Open_Sans = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Lato = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Montserrat = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Poppins = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Geist = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Geist_Mono = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const JetBrains_Mono = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Source_Code_Pro = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Playfair_Display = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Merriweather = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\n"],"mappings":";;;;;;;;;AA+BA,SAAS,qBAAqB,QAAuC;CACnE,OAAO;EACL,WAAW;EACX,OAAO,EAAE,YAAY,GAAG;EACxB,UAAU,QAAQ;CACpB;AACF;;;;;;;;AASA,SAAgB,WAAW,SAAiB,QAAuC;CACjF,OAAO,qBAAqB,MAAM;AACpC;AAIA,IAAa,SAAS,WAA0C,qBAAqB,MAAM;AAC3F,IAAa,UAAU,WAA0C,qBAAqB,MAAM;AAC5F,IAAa,aAAa,WAA0C,qBAAqB,MAAM;AAC/F,IAAa,QAAQ,WAA0C,qBAAqB,MAAM;AAC1F,IAAa,cAAc,WAA0C,qBAAqB,MAAM;AAChG,IAAa,WAAW,WAA0C,qBAAqB,MAAM;AAC7F,IAAa,SAAS,WAA0C,qBAAqB,MAAM;AAC3F,IAAa,cAAc,WAA0C,qBAAqB,MAAM;AAChG,IAAa,kBAAkB,WAC7B,qBAAqB,MAAM;AAC7B,IAAa,mBAAmB,WAC9B,qBAAqB,MAAM;AAC7B,IAAa,oBAAoB,WAC/B,qBAAqB,MAAM;AAC7B,IAAa,gBAAgB,WAA0C,qBAAqB,MAAM"}

package/dist/shims/font-local.d.ts

@@ -12,7 +12,7 @@
  *
  * Design doc: 24-fonts.md, "Next.js Font Compatibility"
  */
-import type { LocalFontConfig, FontResult } from '../fonts/types.js';
+import type { LocalFontConfig, FontResult } from '../fonts/types.ts';
 export type { LocalFontConfig, FontResult };
 /**
  * Create a local font.

package/dist/shims/font-local.js.map

@@ -1 +1 @@
-{"version":3,"file":"font-local.js","names":[],"sources":["../../src/shims/font-local.ts"],"sourcesContent":["/**\n * Fallback shim for `next/font/local` → `@timber/fonts/local`.\n *\n * At build time, the timber-fonts plugin's transform hook replaces\n * `localFont()` calls with static FontResult objects containing real\n * class names and font stacks. This file serves two purposes:\n *\n * 1. **TypeScript resolution** — provides types for IDEs and `tsc` outside\n *    of Vite's module graph (where the virtual module handles it).\n * 2. **Runtime fallback** — returns empty className/fontFamily values when\n *    the plugin hasn't processed a call (e.g. in tests or non-Vite environments).\n *\n * Design doc: 24-fonts.md, \"Next.js Font Compatibility\"\n */\n\nimport type { LocalFontConfig, FontResult } from '../fonts/types.js';\n\nexport type { LocalFontConfig, FontResult };\n\n/**\n * Create a local font.\n *\n * The timber-fonts plugin replaces these calls at build time with real\n * class names and font stacks. This stub ensures code that imports\n * `localFont` outside of the build pipeline (tests, type-checking)\n * gets a valid FontResult shape without runtime errors.\n */\nexport default function localFont(config?: LocalFontConfig): FontResult {\n  return {\n    className: '',\n    style: { fontFamily: '' },\n    variable: config?.variable,\n  };\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAwB,UAAU,QAAsC;CACtE,OAAO;EACL,WAAW;EACX,OAAO,EAAE,YAAY,GAAG;EACxB,UAAU,QAAQ;CACpB;AACF"}
+{"version":3,"file":"font-local.js","names":[],"sources":["../../src/shims/font-local.ts"],"sourcesContent":["/**\n * Fallback shim for `next/font/local` → `@timber/fonts/local`.\n *\n * At build time, the timber-fonts plugin's transform hook replaces\n * `localFont()` calls with static FontResult objects containing real\n * class names and font stacks. This file serves two purposes:\n *\n * 1. **TypeScript resolution** — provides types for IDEs and `tsc` outside\n *    of Vite's module graph (where the virtual module handles it).\n * 2. **Runtime fallback** — returns empty className/fontFamily values when\n *    the plugin hasn't processed a call (e.g. in tests or non-Vite environments).\n *\n * Design doc: 24-fonts.md, \"Next.js Font Compatibility\"\n */\n\nimport type { LocalFontConfig, FontResult } from '../fonts/types.ts';\n\nexport type { LocalFontConfig, FontResult };\n\n/**\n * Create a local font.\n *\n * The timber-fonts plugin replaces these calls at build time with real\n * class names and font stacks. This stub ensures code that imports\n * `localFont` outside of the build pipeline (tests, type-checking)\n * gets a valid FontResult shape without runtime errors.\n */\nexport default function localFont(config?: LocalFontConfig): FontResult {\n  return {\n    className: '',\n    style: { fontFamily: '' },\n    variable: config?.variable,\n  };\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAwB,UAAU,QAAsC;CACtE,OAAO;EACL,WAAW;EACX,OAAO,EAAE,YAAY,GAAG;EACxB,UAAU,QAAQ;CACpB;AACF"}

package/dist/shims/navigation-client.d.ts

@@ -22,11 +22,11 @@
  *
  * See design/14-ecosystem.md §"next/navigation" for the full shim audit.
  */
-import type { RedirectTypeValue } from '../shared/redirect-type.js';
-export { useSegmentParams, useSegmentParams as useParams } from '../client/use-segment-params.js';
-export { useSearchParams } from '../client/use-search-params.js';
+import type { RedirectTypeValue } from '../shared/redirect-type.ts';
+export { useSegmentParams, useSegmentParams as useParams } from '../client/use-segment-params.ts';
+export { useSearchParams } from '../client/use-search-params.ts';
 export { usePathname, useRouter, useSelectedLayoutSegment, useSelectedLayoutSegments, } from '@timber-js/app/client';
-export { RedirectType } from '../shared/redirect-type.js';
+export { RedirectType } from '../shared/redirect-type.ts';
 /**
  * Client-render redirect. Throws a redirect-digest error that the nearest
  * TimberErrorBoundary converts into an SPA navigation (replace semantics).

package/dist/shims/navigation.d.ts

@@ -8,8 +8,8 @@
  *
  * Server functions import from @timber-js/app/server for ALS singleton consistency.
  */
-export { useSegmentParams, useSegmentParams as useParams } from '../client/use-segment-params.js';
-export { useSearchParams } from '../client/use-search-params.js';
+export { useSegmentParams, useSegmentParams as useParams } from '../client/use-segment-params.ts';
+export { useSearchParams } from '../client/use-search-params.ts';
 export { usePathname, useRouter, useSelectedLayoutSegment, useSelectedLayoutSegments, } from '@timber-js/app/client';
 export { redirect, redirectExternal, RedirectType } from '@timber-js/app/server';
 //# sourceMappingURL=navigation.d.ts.map

package/docs/api/34-api-config.mdx

@@ -252,17 +252,20 @@ Disable encryption in dev mode for easier debugging of bound args. Has no effect
 ### `reactCompiler`
 
 - **Type:** `boolean | { compilationMode?: string; target?: string }`
-- **Default:** `false`
+- **Default:** `true`
+
+Enable the React Compiler for automatic memoization of components and hooks at build time. Uses `@vitejs/plugin-react`'s native OXC-based compiler path — JSX and compilation run in a single Rust pass with no Babel overhead.
 
-Enable the React Compiler (`babel-plugin-react-compiler`) for automatic memoization of components and hooks at build time.
+Enabled by default. Set to `false` to disable. Enabling the compiler disables React Fast Refresh — HMR still works but component state is not preserved across edits.
 
 ```ts
-reactCompiler: true                                     // enable with defaults
+reactCompiler: true                                     // enable with defaults (the default)
 reactCompiler: { compilationMode: 'annotation' }        // only compile 'use memo' files
 reactCompiler: { target: '18' }                         // target React 18
+reactCompiler: false                                    // disable
 ```
 
-Requires `babel-plugin-react-compiler` as a peer dependency.
+`oxc-transform-react` is included automatically as a dependency of `@timber-js/app`.
 
 ### `sitemap`
 

package/docs/api/36-cli.mdx

@@ -1,12 +1,12 @@
 ---
 title: 'CLI'
-description: 'timber dev, build, preview, check, and init commands.'
+description: 'timber dev, build, preview, check, graph, and init commands.'
 slug: 'cli'
 ---
 
 # CLI
 
-timber.js provides four commands. All are thin wrappers around Vite with timber-specific behavior.
+timber.js provides a small set of commands. All are thin wrappers around Vite with timber-specific behavior.
 
 ```tsx
 timber < command > [--config<path>][--project<path>];
@@ -118,6 +118,24 @@ If it is missing, `timber check` fails with that instruction. It never passes by
 
 Useful in CI pipelines and pre-commit hooks to catch type and routing errors without a full build.
 
+### `timber graph`
+
+Classify a file's module environment(s) — server, client boundary, client-internal, shared, server action, or unreferenced.
+
+```bash
+timber graph app/dashboard/nav.tsx          # human-readable answer
+timber graph app/dashboard/nav.tsx --json   # machine contract for tools and agents
+timber graph --all --json                   # classify the whole project
+```
+
+A file is not intrinsically "client" or "server" — its environment is a property of the import graph. `timber graph` answers from timber's **development module graphs** — the same Vite resolution pipeline `timber dev` runs (aliases, tsconfig paths, `react-server` export conditions), evaluated under serve/development mode. For most apps that is also what production builds; a config that branches on `command` or `mode` is classified as its dev variant. The output includes the environments the file is instantiated in, the import chain(s) that put it there (with the `'use client'` boundary marked), and report-only warnings when a file imports something exclusive to the other side (`node:*` from client-reachable code, `client-only` from server code).
+
+The first query after a clone or a file change runs a full-project crawl — typically ~2.5&nbsp;s, up to ~10&nbsp;s on plugin-heavy apps. Every subsequent query is a cache hit (milliseconds) until the project changes; the cache lives at `.timber/graph-cache.json` and invalidates automatically on any source, config, or lockfile change.
+
+`--json` is the stable machine contract: `{ version, source, cached, target, kind, pending, subtreeUnknown, envs, boundary, chains, poisonings }`. `--all` requires `--json`.
+
+> **Note:** unlike every other command, `timber graph` discovers the Vite config by walking **up from the target file**, not from the directory you run it in — so in a monorepo, the file's own app answers. `--config` overrides as usual.
+
 ### `timber init`
 
 Write `AGENTS.md` and `CLAUDE.md` to the project root for AI coding agent discovery.
@@ -136,10 +154,12 @@ The generated `AGENTS.md` includes project structure, key imports, common patter
 | ----------------- | ----- | --------------------------------------------------------------------------------------------------------- |
 | `--config <path>`  | `-c`  | Path to a custom Vite config file. Means the same thing for every command, `check` included. |
 | `--project <path>` |       | `timber check` only — the `tsconfig.json` to type-check.                                     |
+| `--json`           |       | `timber graph` only — emit the machine-readable JSON contract.                               |
+| `--all`            |       | `timber graph` only — classify the whole project (requires `--json`).                        |
 
 > **Note:** `timber check` resolves your app through Vite, so `--config` names the Vite config there too, exactly as it does for `dev` and `build`. The tsconfig has its own flag, `--project`, spelled the way `tsc` and `tsgo` spell it. `check` needs a Vite config that lists the timber plugin and fails with an actionable message if it cannot find one.
 
-Those are the only flags. Any other produces an error rather than being silently ignored, with a hint at the supported alternative (e.g. `--port` points you to the `PORT` env var or `server.port` in `vite.config.ts`). Passing `--project` to a command with no type pass is an error too, pointing you at `--config`.
+Those are the only flags. Any other produces an error rather than being silently ignored, with a hint at the supported alternative (e.g. `--port` points you to the `PORT` env var or `server.port` in `vite.config.ts`). Passing `--project` to a command with no type pass — or `--json`/`--all` to anything but `graph` — is an error too, pointing you at the right command.
 
 ## Package Manager Scripts
 

package/docs/learn/11-error-handling.mdx

@@ -85,6 +85,17 @@ export default function NotFound({ status }: { status: number }) {
 
 timber hands these components to its error boundary — a client component — as a prop, so a server component there cannot cross the RSC boundary. It is not a degraded error page: every page under that segment fails to render. The build catches it and names the file, so you will not discover it as a serialization error on a page you did not touch. MDX status files (`404.mdx`) are the exception — they are server components, rendered ahead of time.
 
+**MDX status files** work best as static content. Exact-code files (`404.mdx`, `503.mdx`) receive consistent props on all rendering paths — `{ status }` from the error-renderer and boundary paths, and `{ status, dangerouslyPassData }` from deny paths. Wildcard files (`4xx.mdx`, `5xx.mdx`, `error.mdx`) receive props only on the deny and error-renderer paths — on the error boundary path, they are pre-rendered before the error occurs and receive empty props. Use exact-code MDX files if you need to reference `props.status`.
+
+**JSON status files** (`401.json`, `4xx.json`) return the file contents verbatim — no React rendering, no layout wrapping. `dangerouslyPassData` from `deny()` is silently dropped. They are useful for API routes that need a structured JSON error body:
+
+```
+app/api/
+  401.json       # {"error": "unauthorized"}
+  4xx.json       # Catch-all for API errors
+  route.ts
+```
+
 If nothing in the chain matches, timber renders a built-in status page: a plain document with the status code and its reason phrase, and nothing else — no request URL, no error message. It is what a static build writes to `404.html` when your app has no not-found page, so a static deploy always ships one. Add a root `app/404.tsx` (or `4xx.tsx` / `error.tsx`) to replace it.
 
 ## `error.tsx`

package/docs/learn/13-configuration.mdx

@@ -147,7 +147,7 @@ Server actions still work — HTML forms submit natively via POST without JavaSc
 | `appDir`            | `string`                    | auto-detected                | Override app directory location          |
 | `mdx`               | `object`                    | —                            | MDX remark/rehype plugins                |
 | `actionEncryption`  | `object`                    | —                            | Server action bound args encryption      |
-| `reactCompiler`     | `boolean \| object`         | `false`                      | React Compiler auto-memoization          |
+| `reactCompiler`     | `boolean \| object`         | `true`                       | React Compiler auto-memoization          |
 | `sitemap`           | `object`                    | —                            | Auto-generated sitemap.xml               |
 | `clientSegmentCache`| `boolean`                   | `false`                      | Opt-in client segment cache for partial nav |
 | `topLoader`         | `object`                    | enabled                      | Navigation progress bar                  |

package/docs/more/01-advanced-routing.mdx

@@ -170,6 +170,7 @@ app/feed/(.)photo/[id]/page.tsx          ✓ layout swap (feed/layout.tsx requir
 app/(browse)/(...)photo/[id]/page.tsx    ✓ layout swap, scoped to (browse)
 app/feed/@modal/(x)/(.)photo/page.tsx    ✗ build error — not a direct slot child
 app/feed/(.)a/(.)b/page.tsx              ✗ build error — nested interception
+app/feed/@modal/(.)photo/[id]/route.ts   ✗ build error — route handler in interception
 ```
 
 Outside a slot, the directory holding the marker must have a `layout.tsx`. That is the directory the swap is scoped to, and the browser reports which directories it has mounted from its layouts — a scope it cannot report would let the swap fire once and then quietly stop. In practice you already have one, since rendering inside that layout is the point.