@timber-js/app 0.1.0

package/dist/plugins/react-prod.d.ts

@@ -0,0 +1,18 @@
+import type { Plugin } from 'vite';
+/**
+ * Redirect React's CJS development bundles to production bundles.
+ *
+ * React packages use a runtime `process.env.NODE_ENV` check in their CJS
+ * entry points to conditionally require either `*.development.js` or
+ * `*.production.js`. Rollup's CJS plugin resolves both branches statically
+ * before the `define` replacement can eliminate the dead branch, causing
+ * development React code to be included in production builds.
+ *
+ * This plugin intercepts `resolveId` and rewrites any `*.development.js`
+ * import under `react/cjs/`, `react-dom/cjs/`, or `scheduler/cjs/` to
+ * its `*.production.js` counterpart.
+ *
+ * Only active in production builds. Has no effect in dev mode.
+ */
+export declare function timberReactProd(): Plugin;
+//# sourceMappingURL=react-prod.d.ts.map

package/dist/plugins/react-prod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-prod.d.ts","sourceRoot":"","sources":["../../src/plugins/react-prod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAsCxC"}

package/dist/plugins/routing.d.ts

@@ -0,0 +1,13 @@
+/**
+ * timber-routing — Vite sub-plugin for route manifest generation.
+ *
+ * Bridges the route scanner with Vite's module graph. Scans app/ at startup,
+ * watches for file changes in dev, and serves the virtual:timber-route-manifest
+ * module that entry files consume.
+ *
+ * Design docs: 18-build-system.md §"Virtual Modules", 07-routing.md
+ */
+import type { Plugin } from 'vite';
+import type { PluginContext } from '#/index.js';
+export declare function timberRouting(ctx: PluginContext): Plugin;
+//# sourceMappingURL=routing.d.ts.map

package/dist/plugins/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/plugins/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAQlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA2DhD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA2GxD"}

package/dist/plugins/server-action-exports.d.ts

@@ -0,0 +1,26 @@
+import type { Plugin } from 'vite';
+/**
+ * Rewrite 'use server' module exports to bypass RSC plugin AST validation.
+ *
+ * The RSC plugin's client/SSR proxy transform (transformProxyExport) requires
+ * all `export const` initializers to be `async ArrowFunctionExpression`. But
+ * `createActionClient().action()` and `validated()` return async functions via
+ * CallExpressions — valid at runtime but rejected by the static AST check.
+ *
+ * This plugin rewrites non-function-expression exports from:
+ *
+ *   export const foo = someCall();
+ *
+ * to:
+ *
+ *   const foo = someCall();
+ *   export { foo };
+ *
+ * The `export { name }` form bypasses the RSC plugin's validation without
+ * changing runtime semantics. Function expression exports (async arrows,
+ * async function expressions) are left untouched.
+ *
+ * See design/08-forms-and-actions.md §"Middleware for Server Actions"
+ */
+export declare function timberServerActionExports(): Plugin;
+//# sourceMappingURL=server-action-exports.d.ts.map

package/dist/plugins/server-action-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-action-exports.d.ts","sourceRoot":"","sources":["../../src/plugins/server-action-exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAelD"}

package/dist/plugins/server-bundle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * timber-server-bundle — Bundle all dependencies for server environments.
+ *
+ * In production builds, sets `resolve.noExternal: true` for the rsc and ssr
+ * environments. This ensures all npm dependencies are bundled into the output,
+ * which is required for platforms like Cloudflare Workers that don't have
+ * access to node_modules at runtime.
+ *
+ * In dev mode, Vite's default externalization is preserved for fast HMR.
+ *
+ * Design docs: design/11-platform.md, design/25-production-deployments.md
+ */
+import type { Plugin } from 'vite';
+export declare function timberServerBundle(): Plugin[];
+//# sourceMappingURL=server-bundle.d.ts.map

package/dist/plugins/server-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-bundle.d.ts","sourceRoot":"","sources":["../../src/plugins/server-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAiG7C"}

package/dist/plugins/shims.d.ts

@@ -0,0 +1,18 @@
+/**
+ * timber-shims — Vite sub-plugin for next/* → timber shim resolution.
+ *
+ * Intercepts imports of next/* modules and redirects them to timber.js
+ * shim implementations. This enables Next.js-compatible libraries
+ * (nuqs, next-intl, etc.) to work unmodified.
+ *
+ * Design doc: 18-build-system.md §"Shim Map"
+ */
+import type { Plugin } from 'vite';
+import type { PluginContext } from '#/index.js';
+/**
+ * Create the timber-shims Vite plugin.
+ *
+ * Hooks: resolveId, load
+ */
+export declare function timberShims(_ctx: PluginContext): Plugin;
+//# sourceMappingURL=shims.d.ts.map

package/dist/plugins/shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/plugins/shims.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoEhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAiFvD"}

package/dist/plugins/static-build.d.ts

@@ -0,0 +1,55 @@
+/**
+ * timber-static-build — Vite sub-plugin for static output mode.
+ *
+ * When `output: 'static'` is set in timber.config.ts, this plugin:
+ * 1. Validates that no dynamic APIs (cookies(), headers()) are used
+ * 2. When client JavaScript is disabled, rejects 'use client' and 'use server' directives
+ * 3. Coordinates build-time rendering of all pages
+ *
+ * Design doc: design/15-future-prerendering.md
+ */
+import type { Plugin } from 'vite';
+import type { PluginContext } from '#/index.js';
+export interface StaticValidationError {
+    type: 'dynamic-api' | 'nojs-directive';
+    file: string;
+    message: string;
+    line?: number;
+}
+export interface StaticOptions {
+    clientJavascriptDisabled: boolean;
+}
+/**
+ * Detect usage of dynamic per-request APIs (cookies(), headers())
+ * that cannot work at build time in static mode.
+ *
+ * Returns an array of validation errors.
+ */
+export declare function detectDynamicApis(code: string, fileId: string): StaticValidationError[];
+/**
+ * Detect 'use client' and 'use server' directives using AST-based parsing.
+ * When client JavaScript is disabled, both are hard build errors — no React
+ * runtime or server actions are allowed in the output.
+ *
+ * When client JavaScript is enabled, these are allowed (client components
+ * hydrate, server actions get extracted to API endpoints).
+ */
+export declare function detectDirectives(code: string, fileId: string, options: StaticOptions): StaticValidationError[];
+/**
+ * Run all static mode validations on a source file.
+ *
+ * Combines:
+ * - Dynamic API detection (cookies, headers) — always in static mode
+ * - Directive detection ('use client', 'use server') — only when client JS is disabled
+ */
+export declare function validateStaticMode(code: string, fileId: string, options: StaticOptions): StaticValidationError[];
+/**
+ * Create the timber-static-build Vite plugin.
+ *
+ * Only active when output: 'static' is configured.
+ *
+ * Hooks:
+ * - transform: Validates source files for static mode violations
+ */
+export declare function timberStaticBuild(ctx: PluginContext): Plugin;
+//# sourceMappingURL=static-build.d.ts.map

package/dist/plugins/static-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-build.d.ts","sourceRoot":"","sources":["../../src/plugins/static-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAiBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA2BvF;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,qBAAqB,EAAE,CA8BzB;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,qBAAqB,EAAE,CAOzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA0C5D"}

package/dist/routing/codegen.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Route map codegen.
+ *
+ * Walks the scanned RouteTree and generates a TypeScript declaration file
+ * mapping every route to its params and searchParams shapes.
+ *
+ * This runs at build time and in dev (regenerated on file changes).
+ * No runtime overhead — purely static type generation.
+ */
+import type { RouteTree } from './types.js';
+/** Options for route map generation. */
+export interface CodegenOptions {
+    /** Absolute path to the app/ directory. Required for search-params.ts detection. */
+    appDir?: string;
+    /**
+     * Absolute path to the directory where the .d.ts file will be written.
+     * Used to compute correct relative import paths for search-params.ts files.
+     * Defaults to appDir when not provided (preserves backward compat for tests).
+     */
+    outputDir?: string;
+}
+/**
+ * Generate a TypeScript declaration file string from a scanned route tree.
+ *
+ * The output is a `declare module '@timber/app'` block containing the Routes
+ * interface that maps every route path to its params and searchParams shape.
+ */
+export declare function generateRouteMap(tree: RouteTree, options?: CodegenOptions): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/routing/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/routing/codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAqBzD,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAWtF"}

package/dist/routing/index.d.ts

@@ -0,0 +1,8 @@
+export { scanRoutes, classifySegment } from './scanner.js';
+export { generateRouteMap } from './codegen.js';
+export type { CodegenOptions } from './codegen.js';
+export type { RouteTree, SegmentNode, SegmentType, RouteFile, ScannerConfig, InterceptionMarker, } from './types.js';
+export { DEFAULT_PAGE_EXTENSIONS, INTERCEPTION_MARKERS } from './types.js';
+export { collectInterceptionRewrites } from './interception.js';
+export type { InterceptionRewrite } from './interception.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/routing/index.js

@@ -0,0 +1,2 @@
+import { a as DEFAULT_PAGE_EXTENSIONS, i as scanRoutes, n as generateRouteMap, o as INTERCEPTION_MARKERS, r as classifySegment, t as collectInterceptionRewrites } from "../_chunks/interception-DIaZN1bF.js";
+export { DEFAULT_PAGE_EXTENSIONS, INTERCEPTION_MARKERS, classifySegment, collectInterceptionRewrites, generateRouteMap, scanRoutes };

package/dist/routing/interception.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Intercepting route utilities.
+ *
+ * Computes rewrite rules from the route tree that enable intercepting routes
+ * to conditionally render when navigating via client-side (soft) navigation.
+ *
+ * The mechanism: at build time, each intercepting route directory generates a
+ * conditional rewrite. On soft navigation, the client sends an `X-Timber-URL`
+ * header with the current pathname. The server checks if any rewrite's source
+ * (the intercepted URL) matches the target pathname AND the header matches
+ * the intercepting route's parent URL. If both match, the intercepting route
+ * renders instead of the normal route.
+ *
+ * On hard navigation (no header), no rewrite matches, and the normal route
+ * renders.
+ *
+ * See design/07-routing.md §"Intercepting Routes"
+ */
+import type { SegmentNode } from './types.js';
+/** A conditional rewrite rule generated from an intercepting route. */
+export interface InterceptionRewrite {
+    /**
+     * The URL pattern that this rewrite intercepts (the target of navigation).
+     * E.g., "/photo/[id]" for a (.)photo/[id] interception.
+     */
+    interceptedPattern: string;
+    /**
+     * The URL prefix that the client must be navigating FROM for this rewrite
+     * to apply. Matched against the X-Timber-URL header.
+     * E.g., "/feed" for a (.)photo/[id] inside /feed/@modal/.
+     */
+    interceptingPrefix: string;
+    /**
+     * Segments chain from root → intercepting leaf. Used to build the element
+     * tree when the interception is active.
+     */
+    segmentPath: SegmentNode[];
+}
+/**
+ * Collect all interception rewrite rules from the route tree.
+ *
+ * Walks the tree recursively. For each intercepting segment, computes the
+ * intercepted URL based on the marker and the segment's position.
+ */
+export declare function collectInterceptionRewrites(root: SegmentNode): InterceptionRewrite[];
+//# sourceMappingURL=interception.d.ts.map

package/dist/routing/interception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interception.d.ts","sourceRoot":"","sources":["../../src/routing/interception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,YAAY,CAAC;AAElE,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,mBAAmB,EAAE,CAIpF"}

package/dist/routing/scanner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Route discovery scanner.
+ *
+ * Pure function: (appDir, config) → RouteTree
+ *
+ * Scans the app/ directory and builds a segment tree recognizing all
+ * timber.js file conventions. Does NOT handle request matching — this
+ * is discovery only.
+ */
+import type { RouteTree, SegmentType, ScannerConfig, InterceptionMarker } from './types.js';
+/**
+ * Scan the app/ directory and build the route tree.
+ *
+ * @param appDir - Absolute path to the app/ directory
+ * @param config - Scanner configuration
+ * @returns The complete route tree
+ */
+export declare function scanRoutes(appDir: string, config?: ScannerConfig): RouteTree;
+/**
+ * Classify a directory name into its segment type.
+ */
+export declare function classifySegment(dirName: string): {
+    type: SegmentType;
+    paramName?: string;
+    interceptionMarker?: InterceptionMarker;
+    interceptedSegmentName?: string;
+};
+//# sourceMappingURL=scanner.d.ts.map

package/dist/routing/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/routing/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,SAAS,EAET,WAAW,EAEX,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA6CpB;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,SAAS,CAwBhF;AAyBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CA8CA"}

package/dist/routing/status-file-lint.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Lint status files and error.tsx for missing 'use client' directive.
+ *
+ * Status files (error.tsx, 404.tsx, 4xx.tsx, 5xx.tsx, NNN.tsx) and legacy
+ * compat files (not-found.tsx, forbidden.tsx, unauthorized.tsx) are passed
+ * as fallbackComponent to TimberErrorBoundary — a 'use client' component.
+ * RSC forbids passing server component functions as props to client
+ * components, causing a hard-to-debug runtime error.
+ *
+ * This module provides a build/dev-time check that warns when these files
+ * are missing the 'use client' directive.
+ *
+ * See design/10-error-handling.md §"Status-Code Files".
+ */
+import type { RouteTree } from './types.js';
+export interface StatusFileLintWarning {
+    filePath: string;
+    fileType: string;
+}
+/**
+ * Walk the route tree and check all status files and error files for
+ * the 'use client' directive. Returns an array of warnings for files
+ * that are missing it.
+ *
+ * MDX and JSON status files are excluded — MDX files are server components
+ * by design, and JSON files are data, not components.
+ */
+export declare function lintStatusFileDirectives(tree: RouteTree): StatusFileLintWarning[];
+/**
+ * Format warnings into human-readable console output.
+ */
+export declare function formatStatusFileLintWarnings(warnings: StatusFileLintWarning[]): string;
+//# sourceMappingURL=status-file-lint.d.ts.map

package/dist/routing/status-file-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-file-lint.d.ts","sourceRoot":"","sources":["../../src/routing/status-file-lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAMzD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,GAAG,qBAAqB,EAAE,CAIjF;AAoDD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAmBtF"}

package/dist/routing/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Route tree types for timber.js file-system routing.
+ *
+ * The route tree is built by scanning the app/ directory and recognizing
+ * file conventions (page.*, layout.*, middleware.ts, access.ts, route.ts, etc.).
+ */
+/** Segment type classification */
+export type SegmentType = 'static' | 'dynamic' | 'catch-all' | 'optional-catch-all' | 'group' | 'slot' | 'intercepting' | 'private';
+/**
+ * Intercepting route marker — indicates how many levels up to resolve the
+ * intercepted route from the intercepting route's location.
+ *
+ * See design/07-routing.md §"Intercepting Routes"
+ */
+export type InterceptionMarker = '(.)' | '(..)' | '(...)' | '(..)(..)';
+/** All recognized interception markers, ordered longest-first for parsing. */
+export declare const INTERCEPTION_MARKERS: InterceptionMarker[];
+/** A single file discovered in a route segment */
+export interface RouteFile {
+    /** Absolute path to the file */
+    filePath: string;
+    /** File extension without leading dot (e.g. "tsx", "ts", "mdx") */
+    extension: string;
+}
+/** A node in the segment tree */
+export interface SegmentNode {
+    /** The raw directory name (e.g. "dashboard", "[id]", "(auth)", "@sidebar") */
+    segmentName: string;
+    /** Classified segment type */
+    segmentType: SegmentType;
+    /** The dynamic param name, if dynamic (e.g. "id" for "[id]", "slug" for "[...slug]") */
+    paramName?: string;
+    /** The URL path prefix at this segment level (e.g. "/dashboard") */
+    urlPath: string;
+    /** For intercepting segments: the marker used, e.g. "(.)". */
+    interceptionMarker?: InterceptionMarker;
+    /**
+     * For intercepting segments: the segment name after stripping the marker.
+     * E.g., for "(.)photo" this is "photo".
+     */
+    interceptedSegmentName?: string;
+    page?: RouteFile;
+    layout?: RouteFile;
+    middleware?: RouteFile;
+    access?: RouteFile;
+    route?: RouteFile;
+    error?: RouteFile;
+    default?: RouteFile;
+    /** Status-code files: 4xx.tsx, 5xx.tsx, {status}.tsx (component format) */
+    statusFiles?: Map<string, RouteFile>;
+    /** JSON status-code files: 4xx.json, 5xx.json, {status}.json */
+    jsonStatusFiles?: Map<string, RouteFile>;
+    /** denied.tsx — slot-only denial rendering */
+    denied?: RouteFile;
+    /** Legacy compat: not-found.tsx (maps to 404), forbidden.tsx (403), unauthorized.tsx (401) */
+    legacyStatusFiles?: Map<string, RouteFile>;
+    /** prerender.ts — signals build-time pre-rendering for this segment's shell */
+    prerender?: RouteFile;
+    /** search-params.ts — typed search params definition for this route */
+    searchParams?: RouteFile;
+    /** Metadata route files (sitemap.ts, robots.ts, icon.tsx, etc.) keyed by base name */
+    metadataRoutes?: Map<string, RouteFile>;
+    children: SegmentNode[];
+    /** Parallel route slots (keyed by slot name without @) */
+    slots: Map<string, SegmentNode>;
+}
+/** The full route tree output from the scanner */
+export interface RouteTree {
+    /** The root segment node (representing app/) */
+    root: SegmentNode;
+    /** All discovered proxy.ts files (should be at most one, in app/) */
+    proxy?: RouteFile;
+}
+/** Configuration passed to the scanner */
+export interface ScannerConfig {
+    /** Recognized page/layout extensions (without dots). Default: ['tsx', 'ts', 'jsx', 'js'] */
+    pageExtensions?: string[];
+}
+/** Default page extensions */
+export declare const DEFAULT_PAGE_EXTENSIONS: string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/routing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kCAAkC;AAClC,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,oBAAoB,GACpB,OAAO,GACP,MAAM,GACN,cAAc,GACd,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EAAyC,CAAC;AAE/F,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAGhC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrC,gEAAgE;IAChE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,+EAA+E;IAC/E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uEAAuE;IACvE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,sFAAsF;IACtF,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAGxC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,0DAA0D;IAC1D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACjC;AAED,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,IAAI,EAAE,WAAW,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,4FAA4F;IAC5F,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,8BAA8B;AAC9B,eAAO,MAAM,uBAAuB,UAA6B,CAAC"}

package/dist/search-params/analyze.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Static analyzability checker for search-params.ts files.
+ *
+ * Validates that a search-params.ts file's default export is statically
+ * analyzable — a createSearchParams() call or a chain of .extend()/.pick()
+ * calls on a SearchParamsDefinition.
+ *
+ * Non-analyzable files produce a hard build error with a diagnostic.
+ *
+ * Design doc: design/09-typescript.md §"Static Analyzability"
+ */
+/** Result of analyzing a search-params.ts file. */
+export interface AnalyzeResult {
+    /** Whether the file is statically analyzable. */
+    valid: boolean;
+    /** Error details when valid is false. */
+    error?: AnalyzeError;
+}
+/** Diagnostic error for non-analyzable search-params.ts. */
+export interface AnalyzeError {
+    /** Absolute file path. */
+    filePath: string;
+    /** Description of the non-analyzable expression. */
+    expression: string;
+    /** Suggested fix. */
+    suggestion: string;
+}
+/**
+ * Patterns that indicate a valid default export:
+ *
+ * 1. `export default createSearchParams(...)`
+ * 2. `export default someVar.extend(...)`
+ * 3. `export default someVar.pick(...)`
+ * 4. `export default someVar.extend(...).extend(...)`  (chained)
+ * 5. `export default someVar.extend(...).pick(...)`    (chained)
+ * 6. `export default createSearchParams(...).extend(...)`
+ *
+ * Invalid patterns:
+ * - `export default someFunction(...)` (arbitrary factory)
+ * - `export default condition ? a : b` (runtime conditional)
+ * - `export default variable` (opaque reference without call)
+ */
+/**
+ * Analyze a search-params.ts file source for static analyzability.
+ *
+ * @param source - The file content as a string
+ * @param filePath - Absolute path to the file (for diagnostics)
+ */
+export declare function analyzeSearchParams(source: string, filePath: string): AnalyzeResult;
+/**
+ * Format an AnalyzeError into a human-readable build error message.
+ */
+export declare function formatAnalyzeError(error: AnalyzeError): string;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/search-params/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/search-params/analyze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAmCnF;AA0ED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAa9D"}

package/dist/search-params/codecs.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Built-in codecs and the fromSchema bridge for Standard Schema-compatible
+ * validation libraries (Zod, Valibot, ArkType).
+ *
+ * Design doc: design/09-typescript.md §"The SearchParamCodec Protocol"
+ */
+import type { SearchParamCodec } from './create.js';
+interface StandardSchemaV1<Output = unknown> {
+    '~standard': {
+        validate(value: unknown): StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>;
+    };
+}
+type StandardSchemaResult<Output> = {
+    value: Output;
+    issues?: undefined;
+} | {
+    value?: undefined;
+    issues: ReadonlyArray<{
+        message: string;
+    }>;
+};
+/**
+ * Bridge a Standard Schema-compatible schema (Zod, Valibot, ArkType) to a
+ * SearchParamCodec.
+ *
+ * Parse: coerces the raw URL string through the schema. On validation failure,
+ * parses `undefined` to get the schema's default value (the schema should have
+ * a `.default()` call). If that also fails, returns `undefined`.
+ *
+ * Serialize: uses `String()` for primitives, `null` for null/undefined.
+ *
+ * ```ts
+ * import { fromSchema } from '@timber/app/search-params'
+ * import { z } from 'zod/v4'
+ *
+ * const pageCodec = fromSchema(z.coerce.number().int().min(1).default(1))
+ * ```
+ */
+export declare function fromSchema<T>(schema: StandardSchemaV1<T>): SearchParamCodec<T>;
+/**
+ * Bridge a Standard Schema for array values. Handles both single strings
+ * and repeated query keys (`?tag=a&tag=b`).
+ *
+ * ```ts
+ * import { fromArraySchema } from '@timber/app/search-params'
+ * import { z } from 'zod/v4'
+ *
+ * const tagsCodec = fromArraySchema(z.array(z.string()).default([]))
+ * ```
+ */
+export declare function fromArraySchema<T>(schema: StandardSchemaV1<T>): SearchParamCodec<T>;
+export {};
+//# sourceMappingURL=codecs.d.ts.map

package/dist/search-params/codecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../../src/search-params/codecs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,UAAU,gBAAgB,CAAC,MAAM,GAAG,OAAO;IACzC,WAAW,EAAE;QACX,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;KAChG,CAAC;CACH;AAED,KAAK,oBAAoB,CAAC,MAAM,IAC5B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AA6BtE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CA6B9E;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAmCnF"}