@timber-js/app 0.2.0-alpha.208 → 0.2.0-alpha.209

package/dist/cache/tag-aware-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag-aware-handler.d.ts","sourceRoot":"","sources":["../../src/cache/tag-aware-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA6B7C,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAW;IAE3B,YAAY,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAIxD;IAED,IAAI,WAAW,IAAI,QAAQ,GAAG,UAAU,GAAG,OAAO,CAEjD;IAED,OAAO,CAAC,OAAO;IAIf,yEAAyE;IACzE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAsBzE;IAEK,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACzD,OAAO,CAAC,IAAI,CAAC,CA+Cf;IAEK,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CpE;YAIa,cAAc;YAWd,cAAc;CAe7B"}
+{"version":3,"file":"tag-aware-handler.d.ts","sourceRoot":"","sources":["../../src/cache/tag-aware-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiD7C,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAW;IAE3B,YAAY,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAIxD;IAED,IAAI,WAAW,IAAI,QAAQ,GAAG,UAAU,GAAG,OAAO,CAEjD;IAED,OAAO,CAAC,OAAO;IAIf,yEAAyE;IACzE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAsBzE;IAEK,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACzD,OAAO,CAAC,IAAI,CAAC,CAgDf;IAEK,UAAU,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CpE;YAIa,cAAc;YAWd,cAAc;CAe7B"}

package/dist/cdn/workers-cache-purge.js

@@ -1,4 +1,4 @@
-import { c as workersCachePurgeAls } from "../_chunks/als-registry-C6kcfprT.js";
+import { u as workersCachePurgeAls } from "../_chunks/als-registry-DaxkVjt5.js";
 //#region src/server/workers-cache-bridge.ts
 /**
 * Per-request Workers Cache purge bridge — ALS bridge for Cloudflare adapter.

package/dist/cli-check.d.ts

@@ -29,6 +29,7 @@
  *
  * Design docs: 11-platform.md §CLI, 09-typescript.md, 28-npm-packaging.md
  */
+import { type ResolveViteConfig } from './cli-context.ts';
 /**
  * Run the compiler to completion.
  *
@@ -43,21 +44,6 @@ export type RunTsgo = (command: string, args: string[], cwd: string) => Promise<
  * output is data we read rather than diagnostics the user reads.
  */
 export type ReadTsgoConfig = (command: string, args: string[], cwd: string) => Promise<string>;
-/**
- * Vite's own `resolveConfig`, narrowed to what this module passes and reads.
- *
- * The seam sits at `resolveConfig` rather than at "give me the plugins" so the
- * *arguments* are the thing under test: which config file, which command, and
- * which mode defaults. Those arguments have been wrong three separate times
- * (TIM-1332 rounds 4-6), and a double that answered "here are the plugins"
- * could not see any of it. The double returns what Vite returns — plugins with
- * an opaque `api` — so the lookup and narrowing under test stay the real ones.
- */
-export type ResolveViteConfig = (inlineConfig: {
-    configFile: string | undefined;
-}, command: 'build', defaultMode: string, defaultNodeEnv: string) => Promise<{
-    plugins: readonly PluginWithApi[];
-}>;
 /** @internal Dependency injection for testing. */
 export interface CheckDeps {
     /**
@@ -104,29 +90,13 @@ export interface RouteInputs {
     appDir: string;
     pageExtensions: string[] | undefined;
 }
-/** The subset of a resolved Vite plugin this module reads. */
-export interface PluginWithApi {
-    name: string;
-    api?: unknown;
-}
 /**
- * Resolve root, appDir and pageExtensions the way `timber build` resolves them.
- *
- * Reading `timber.config.ts` directly is **not** equivalent, which is the whole
- * reason this goes through Vite (TIM-1332, review round 3):
- *
- * - Config passed inline — `timber({ pageExtensions: [...] })` in
- *   `vite.config.ts` — lives only in the plugin's closure. Nothing that
- *   re-reads the config file can see it, so a scan built that way silently uses
- *   default page extensions and writes a route map missing the app's pages.
- *   `examples/next-playground-migration` is exactly this shape.
- * - `root` is Vite's resolved root, not the caller's cwd, and the two differ in
- *   the monorepo layouts TIM-498 describes. `appDir` resolves against it.
- *
- * There is no fallback to a second, hand-rolled resolution. A project whose
- * Vite config does not produce the timber plugin cannot be built either, so a
- * check that quietly proceeded on a guessed tree would report a verdict about
- * an app that does not exist.
+ * Resolve root, appDir and pageExtensions the way `timber build` resolves them
+ * — through Vite, never by re-reading `timber.config.ts` (see `cli-context.ts`).
+ * Inline `timber({ pageExtensions: [...] })` is the case that bites: a scan
+ * that re-read the file would silently use default page extensions and write a
+ * route map missing the app's pages. `examples/next-playground-migration` is
+ * exactly this shape.
  */
 export declare function resolveRouteInputs(options?: RouteOptions, deps?: CheckDeps): Promise<RouteInputs>;
 /**

package/dist/cli-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-check.d.ts","sourceRoot":"","sources":["../src/cli-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/F;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,YAAY,EAAE;IAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAChD,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC,CAAC;AAEpD,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MACV,GACvC,MAAM,CAwBR;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAkCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAwBtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAiCtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmCvD;AAqGD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAiDf"}
+{"version":3,"file":"cli-check.d.ts","sourceRoot":"","sources":["../src/cli-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAQH,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAahF;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE/F,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MACV,GACvC,MAAM,CAwBR;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAGtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAiCtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmCvD;AAqGD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/cli-context.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Resolve timber's configuration the way `timber build` resolves it, for CLI
+ * commands that run outside the build: `timber check` and `timber preview`.
+ *
+ * Reading `timber.config.ts` directly is **not** equivalent, which is the whole
+ * reason this goes through Vite (TIM-1332, review round 3; TIM-1531):
+ *
+ * - Config passed inline — `timber({ pageExtensions, adapter, output })` in
+ *   `vite.config.ts` — lives only in the plugin's closure. Nothing that
+ *   re-reads the config file can see it.
+ * - `root` is Vite's resolved root, not the caller's cwd, and the two differ in
+ *   the monorepo layouts TIM-498 describes.
+ * - The build directory can come from Vite's `build.outDir`, which only a
+ *   resolved Vite config knows.
+ * - `--config` names a Vite config file; only Vite can load it.
+ *
+ * There is no fallback to a second, hand-rolled resolution. A project whose
+ * Vite config does not produce the timber plugin cannot be built either, so a
+ * command that quietly proceeded on a guess would act on an app that does not
+ * exist.
+ *
+ * Design docs: 11-platform.md §CLI
+ */
+import { type PluginContext } from './plugin-context.ts';
+/** The subset of a resolved Vite plugin this module reads. */
+export interface PluginWithApi {
+    name: string;
+    api?: unknown;
+}
+/**
+ * Vite's own `resolveConfig`, narrowed to what this module passes and reads.
+ *
+ * The seam sits at `resolveConfig` rather than at "give me the plugins" so the
+ * *arguments* are the thing under test: which config file, which command, and
+ * which mode defaults. Those arguments have been wrong three separate times
+ * (TIM-1332 rounds 4-6), and a double that answered "here are the plugins"
+ * could not see any of it. The double returns what Vite returns — plugins with
+ * an opaque `api` — so the lookup and narrowing under test stay the real ones.
+ */
+export type ResolveViteConfig = (inlineConfig: {
+    configFile: string | undefined;
+}, command: 'build', defaultMode: string, defaultNodeEnv: string) => Promise<{
+    plugins: readonly PluginWithApi[];
+}>;
+/**
+ * Resolve the project through Vite and return timber's context as
+ * `timber build` would see it.
+ *
+ * @param command The CLI command asking, named in the error message.
+ * @param viteConfigFile `--config`. Undefined means Vite's own discovery, the
+ *   same as `timber build` without the flag.
+ */
+export declare function resolveTimberContext(command: string, viteConfigFile: string | undefined, resolveViteConfig?: ResolveViteConfig): Promise<PluginContext>;
+//# sourceMappingURL=cli-context.d.ts.map

package/dist/cli-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-context.d.ts","sourceRoot":"","sources":["../src/cli-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAK5E,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,YAAY,EAAE;IAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAChD,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC,CAAC;AAkCpD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,iBAAiB,GAAE,iBAA4C,GAC9D,OAAO,CAAC,aAAa,CAAC,CAsBxB"}

package/dist/cli.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import type { CheckDeps } from './cli-check.ts';
+import type { ResolveViteConfig } from './cli-context.ts';
 export type { CheckDeps };
 declare const COMMANDS: readonly ['dev', 'build', 'preview', 'check', 'schema', 'init', 'graph'];
 type Command = (typeof COMMANDS)[number];
@@ -50,6 +51,7 @@ export interface ViteDeps {
     createServer?: typeof import('vite').createServer;
     createBuilder?: typeof import('vite').createBuilder;
     preview?: typeof import('vite').preview;
+    resolveViteConfig?: ResolveViteConfig;
 }
 /**
  * Start the Vite dev server with a supervisor that respawns the process
@@ -72,20 +74,18 @@ export declare function runDev(options: CommandOptions, _deps?: ViteDeps): Promi
  * pipeline — createBuilder/buildApp is required.
  */
 export declare function runBuild(options: CommandOptions, _deps?: ViteDeps): Promise<void>;
-/**
- * Determine whether to use the adapter's preview or Vite's built-in preview.
- * Exported for testing — the actual runPreview function uses this internally.
- */
-export declare function resolvePreviewStrategy(adapter: import('./adapters/types.ts').TimberPlatformAdapter | undefined): 'adapter' | 'vite';
 /**
  * Serve the production build for local testing.
  * If the adapter provides a preview() method, it takes priority.
  * Otherwise falls back to Vite's built-in preview server.
  *
- * Uses the same loadTimberConfigFile loader as dev/build — one loader,
- * one set of module semantics. A config file that exists but fails to
- * load throws (naming the file) instead of silently degrading to plain
- * Vite preview. See TIM-1066.
+ * The project is resolved through Vite, as `timber check` resolves it
+ * (`cli-context.ts`), so the adapter, the output mode, and the build
+ * directory are the ones `timber build` used — including `--config`, inline
+ * `timber({ ... })` options, Vite's `root`, and `build.outDir`, none of which
+ * a re-read of `timber.config.ts` can see (TIM-1531). A config file that
+ * exists but fails to load throws (naming the file) instead of silently
+ * degrading to plain Vite preview (TIM-1066).
  */
 export declare function runPreview(options: CommandOptions, _deps?: ViteDeps): Promise<void>;
 /**

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,QAAA,MAAM,QAAQ,YAAI,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAC1F,KAAK,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,uDAAuD;IACvD,GAAG,EAAE,OAAO,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmEpD;AAID,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,EAAE,cAAc,MAAM,EAAE,YAAY,CAAC;IAClD,aAAa,CAAC,EAAE,cAAc,MAAM,EAAE,aAAa,CAAC;IACpD,OAAO,CAAC,EAAE,cAAc,MAAM,EAAE,OAAO,CAAC;CACzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDrF;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,GACvE,SAAS,GAAG,MAAM,CAKpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBzF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxF;AAID;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C7D;AAID;;;;;;;GAOG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsD7C"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,QAAA,MAAM,QAAQ,YAAI,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAC1F,KAAK,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,uDAAuD;IACvD,GAAG,EAAE,OAAO,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmEpD;AAID,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,EAAE,cAAc,MAAM,EAAE,YAAY,CAAC;IAClD,aAAa,CAAC,EAAE,cAAc,MAAM,EAAE,aAAa,CAAC;IACpD,OAAO,CAAC,EAAE,cAAc,MAAM,EAAE,OAAO,CAAC;IACxC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDrF;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBzF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxF;AAID;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C7D;AAID;;;;;;;GAOG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsD7C"}

package/dist/cli.js

@@ -90,7 +90,7 @@ async function runDev(options, _deps) {
 		return;
 	}
 	const { fork } = await import("node:child_process");
-	const { RESTART_EXIT_CODE } = await import("./_chunks/dev-server-BzBxgYAV.js").then((n) => n.t);
+	const { RESTART_EXIT_CODE } = await import("./_chunks/dev-server-C4WZdB7L.js").then((n) => n.t);
 	while (true) {
 		const result = await new Promise((resolve) => {
 			const child = fork(process.argv[1], process.argv.slice(2), {
@@ -128,32 +128,28 @@ async function runBuild(options, _deps) {
 	await (await (_deps?.createBuilder ?? (await import("vite")).createBuilder)({ configFile: options.config })).buildApp();
 }
 /**
-* Determine whether to use the adapter's preview or Vite's built-in preview.
-* Exported for testing — the actual runPreview function uses this internally.
-*/
-function resolvePreviewStrategy(adapter) {
-	if (adapter && typeof adapter.preview === "function") return "adapter";
-	return "vite";
-}
-/**
 * Serve the production build for local testing.
 * If the adapter provides a preview() method, it takes priority.
 * Otherwise falls back to Vite's built-in preview server.
 *
-* Uses the same loadTimberConfigFile loader as dev/build — one loader,
-* one set of module semantics. A config file that exists but fails to
-* load throws (naming the file) instead of silently degrading to plain
-* Vite preview. See TIM-1066.
+* The project is resolved through Vite, as `timber check` resolves it
+* (`cli-context.ts`), so the adapter, the output mode, and the build
+* directory are the ones `timber build` used — including `--config`, inline
+* `timber({ ... })` options, Vite's `root`, and `build.outDir`, none of which
+* a re-read of `timber.config.ts` can see (TIM-1531). A config file that
+* exists but fails to load throws (naming the file) instead of silently
+* degrading to plain Vite preview (TIM-1066).
 */
 async function runPreview(options, _deps) {
-	const { loadTimberConfigFile, resolveBuildDir } = await import("./_chunks/plugin-context-8idfR3UZ.js").then((n) => n.a);
-	const root = process.cwd();
-	const config = loadTimberConfigFile(root);
-	const adapter = config?.adapter;
-	if (resolvePreviewStrategy(adapter) === "adapter") {
-		const buildDir = resolveBuildDir(root, config?.buildDir);
-		const timberConfig = { output: config?.output ?? "server" };
-		await adapter.preview(timberConfig, buildDir);
+	const { resolveTimberContext } = await import("./_chunks/cli-context-By7k2xVo.js");
+	const { adapterConfig, contextAdapter } = await import("./_chunks/plugin-context-BPBPc3lL.js").then((n) => n.s);
+	const ctx = await resolveTimberContext("preview", options.config, _deps?.resolveViteConfig);
+	const adapter = contextAdapter(ctx);
+	if (typeof adapter?.preview === "function") {
+		await adapter.preview(adapterConfig(ctx), {
+			output: ctx.config.output ?? "server",
+			outputDir: ctx.buildDir
+		});
 		return;
 	}
 	(await (_deps?.preview ?? (await import("vite")).preview)({ configFile: options.config })).printUrls();
@@ -173,7 +169,7 @@ async function runPreview(options, _deps) {
 * `--project` names the tsconfig handed to tsgo.
 */
 async function runCheck(options, _deps) {
-	const { checkRoutes, runTypeCheck } = await import("./_chunks/cli-check-G8o30ldg.js");
+	const { checkRoutes, runTypeCheck } = await import("./_chunks/cli-check-C6Ev6wBO.js");
 	const { root } = await checkRoutes({ viteConfigFile: options.config }, _deps);
 	await runTypeCheck({
 		root,
@@ -189,7 +185,7 @@ async function runCheck(options, _deps) {
 async function runSchema(args) {
 	const subcommand = args[0];
 	if (subcommand !== "sync") throw new Error(`Unknown schema subcommand: ${subcommand ?? "(none)"}. Usage: timber schema sync`);
-	const { runSchemaSync, defaultCodecForSegment } = await import("./_chunks/cli-schema-sync--LZKs8Zn.js").then((n) => n.t);
+	const { runSchemaSync, defaultCodecForSegment } = await import("./_chunks/cli-schema-sync-CbT2AUUI.js").then((n) => n.t);
 	const result = runSchemaSync(process.cwd());
 	if (result.filesystemSegments.length === 0) {
 		console.log("[timber] No dynamic segments found in app/.");
@@ -292,6 +288,6 @@ if (typeof process !== "undefined" && process.argv[1] && (import.meta.url.endsWi
 	process.exit(1);
 });
 //#endregion
-export { parseArgs, resolvePreviewStrategy, runBuild, runCheck, runDev, runInit, runPreview, runSchema };
+export { parseArgs, runBuild, runCheck, runDev, runInit, runPreview, runSchema };
 
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// timber.js CLI\n//\n// Wraps Vite commands with timber-specific behavior.\n// See design/18-build-system.md §\"CLI\".\n//\n// Commands:\n//   timber dev      — Start Vite dev server with HMR\n//   timber build    — Run multi-environment build via createBuilder/buildApp\n//   timber preview  — Serve the production build\n//   timber check    — Validate types + routes without building\n//   timber graph    — Classify a file's module environment(s) (design/47)\n\n// Type-only — the implementation is imported dynamically inside runCheck so the\n// CLI's other commands never load the route scanner.\nimport type { CheckDeps } from './cli-check.ts';\n\nexport type { CheckDeps };\n\nconst COMMANDS = ['dev', 'build', 'preview', 'check', 'schema', 'init', 'graph'] as const;\ntype Command = (typeof COMMANDS)[number];\n\nexport interface ParsedArgs {\n  command: Command;\n  config: string | undefined;\n  /** `--project`: the tsconfig `timber check` passes to tsgo. */\n  project: string | undefined;\n  /** `timber graph` only: emit the machine-readable JSON contract. */\n  json: boolean;\n  /** `timber graph` only: classify the whole project. */\n  all: boolean;\n  /** Positional arguments after the command (`schema sync`, `graph <file>`). */\n  rest: string[];\n}\n\nexport interface CommandOptions {\n  /** Path to a Vite config file. Means the same thing for every command. */\n  config?: string;\n  /** `timber check` only: the tsconfig to type-check. */\n  project?: string;\n}\n\n/**\n * Parse CLI arguments into a structured command + options.\n * Accepts: timber <command> [--config|-c <path>] [--project <path>]\n *\n * `--config` names a **Vite** config file for every command, `check` included\n * (TIM-1332): `check` resolves the project through Vite, so a project that\n * builds with `--config ./custom.vite.config.ts` has to be checkable the same\n * way. `--project` names the tsconfig, spelled as tsgo and tsc spell it, and\n * is meaningful only for `check`.\n *\n * Before TIM-1332 `--config` meant the tsconfig for `check` alone — one flag\n * with two meanings, which the docs had to carry a note to explain and which\n * left custom Vite configs unreachable from `check` entirely.\n *\n * Unknown flags are an error, not silently ignored — `timber dev --port 4000`\n * starting on the default port would contradict fail-loudly. The surface stays\n * deliberately small (design/11-platform.md §CLI); port selection goes through\n * the PORT env var or server.port in vite.config.ts.\n *\n * Each subcommand declares its exact flags (the `check --project` precedent,\n * TIM-1332): `graph` additionally accepts a file positional plus `--json` and\n * `--all`, and those two are rejected everywhere else.\n */\nexport function parseArgs(args: string[]): ParsedArgs {\n  if (args.length === 0) {\n    throw new Error(\n      'No command provided. Usage: timber <dev|build|preview|check|schema|init|graph> [--config <path>]'\n    );\n  }\n\n  const command = args[0];\n  if (!COMMANDS.includes(command as Command)) {\n    throw new Error(`Unknown command: ${command}. Available commands: ${COMMANDS.join(', ')}`);\n  }\n\n  let config: string | undefined;\n  let project: string | undefined;\n  let json = false;\n  let all = false;\n  const rest: string[] = [];\n  for (let i = 1; i < args.length; i++) {\n    const arg = args[i];\n    if (arg === '--config' || arg === '-c') {\n      config = args[++i];\n      if (!config) {\n        throw new Error('--config requires a path argument');\n      }\n    } else if (arg === '--json' || arg === '--all') {\n      if (command !== 'graph') {\n        throw new Error(\n          `${arg} is only valid for \\`timber graph\\` (the module-environment query).`\n        );\n      }\n      if (arg === '--json') json = true;\n      else all = true;\n    } else if (arg === '--project') {\n      if (command !== 'check') {\n        throw new Error(\n          `--project is only valid for \\`timber check\\` (it names the tsconfig to type-check). ` +\n            `To point \\`timber ${command}\\` at a different Vite config, use --config <path>.`\n        );\n      }\n      project = args[++i];\n      if (!project) {\n        throw new Error('--project requires a path argument');\n      }\n    } else if (arg.startsWith('-')) {\n      const portHint =\n        arg === '--port' || arg === '-p'\n          ? ' To change the port, set the PORT environment variable (PORT=4000 timber dev) ' +\n            'or server.port in vite.config.ts.'\n          : '';\n      throw new Error(\n        `Unknown option: ${arg}. The timber CLI accepts --config <path>` +\n          ` (and --project <path> for \\`check\\`).${portHint}`\n      );\n    } else if (command === 'schema' || command === 'init' || command === 'graph') {\n      rest.push(arg);\n    } else {\n      throw new Error(`Unexpected argument: ${arg}. Usage: timber ${command} [--config <path>]`);\n    }\n  }\n\n  if (command === 'graph' && rest.length > 1) {\n    throw new Error(\n      `timber graph takes one file. Usage: timber graph <file> [--json], or timber graph --all --json`\n    );\n  }\n\n  return { command: command as Command, config, project, json, all, rest };\n}\n\n// ─── Command Implementations ─────────────────────────────────────────────────\n\n/** @internal Dependency injection for testing. */\nexport interface ViteDeps {\n  createServer?: typeof import('vite').createServer;\n  createBuilder?: typeof import('vite').createBuilder;\n  preview?: typeof import('vite').preview;\n}\n\n/**\n * Start the Vite dev server with a supervisor that respawns the process\n * when timber.config.ts changes. Node's require cache for ESM modules\n * loaded via require() cannot be evicted, so an in-process restart\n * serves stale config. The supervisor forks a worker; when the worker\n * exits with RESTART_EXIT_CODE (set by timber-dev-server on config file\n * change), the supervisor spawns a fresh worker with a clean cache.\n *\n * The timber plugin binds the port immediately with a holding page\n * (in rootSync's config hook) so browsers see a \"starting...\" page\n * instead of ERR_CONNECTION_REFUSED during initialization.\n *\n * See design/21-dev-server.md, TIM-665, TIM-1444.\n */\nexport async function runDev(options: CommandOptions, _deps?: ViteDeps): Promise<void> {\n  // Worker mode: run the dev server directly (forked by supervisor below)\n  if (process.env.__TIMBER_DEV_WORKER) {\n    const createServer = _deps?.createServer ?? (await import('vite')).createServer;\n    const server = await createServer({\n      configFile: options.config,\n    });\n    await server.listen();\n    server.printUrls();\n    return;\n  }\n\n  // Supervisor mode: fork a worker and respawn on config changes.\n  const { fork } = await import('node:child_process');\n  const { RESTART_EXIT_CODE } = await import('./plugins/dev-server.ts');\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>(\n      (resolve) => {\n        const child = fork(process.argv[1], process.argv.slice(2), {\n          stdio: 'inherit',\n          env: { ...process.env, __TIMBER_DEV_WORKER: '1' },\n        });\n\n        // Forward signals to the child. SIGINT from Ctrl+C is sent to\n        // the entire process group, but a targeted SIGTERM (from a\n        // process manager or test teardown) only reaches the parent.\n        const onSigint = () => child.kill('SIGINT');\n        const onSigterm = () => child.kill('SIGTERM');\n        process.on('SIGINT', onSigint);\n        process.on('SIGTERM', onSigterm);\n\n        child.on('exit', (code, signal) => {\n          process.off('SIGINT', onSigint);\n          process.off('SIGTERM', onSigterm);\n          resolve({ code, signal });\n        });\n      }\n    );\n\n    if (result.code === RESTART_EXIT_CODE) {\n      continue;\n    }\n\n    // Child was killed by a signal (e.g. SIGTERM) — re-raise on ourselves\n    if (result.signal) {\n      process.kill(process.pid, result.signal);\n    }\n\n    if (result.code != null && result.code !== 0) {\n      process.exit(result.code);\n    }\n\n    break;\n  }\n}\n\n/**\n * Run the production build using createBuilder + buildApp.\n * Direct build() calls do NOT trigger the RSC plugin's multi-environment\n * pipeline — createBuilder/buildApp is required.\n */\nexport async function runBuild(options: CommandOptions, _deps?: ViteDeps): Promise<void> {\n  const createBuilder = _deps?.createBuilder ?? (await import('vite')).createBuilder;\n  const builder = await createBuilder({\n    configFile: options.config,\n  });\n  await builder.buildApp();\n}\n\n/**\n * Determine whether to use the adapter's preview or Vite's built-in preview.\n * Exported for testing — the actual runPreview function uses this internally.\n */\nexport function resolvePreviewStrategy(\n  adapter: import('./adapters/types.ts').TimberPlatformAdapter | undefined\n): 'adapter' | 'vite' {\n  if (adapter && typeof adapter.preview === 'function') {\n    return 'adapter';\n  }\n  return 'vite';\n}\n\n/**\n * Serve the production build for local testing.\n * If the adapter provides a preview() method, it takes priority.\n * Otherwise falls back to Vite's built-in preview server.\n *\n * Uses the same loadTimberConfigFile loader as dev/build — one loader,\n * one set of module semantics. A config file that exists but fails to\n * load throws (naming the file) instead of silently degrading to plain\n * Vite preview. See TIM-1066.\n */\nexport async function runPreview(options: CommandOptions, _deps?: ViteDeps): Promise<void> {\n  const { loadTimberConfigFile, resolveBuildDir } = await import('./plugin-context.ts');\n\n  const root = process.cwd();\n  const config = loadTimberConfigFile(root);\n  const adapter = config?.adapter as\n    | import('./adapters/types.ts').TimberPlatformAdapter\n    | undefined;\n\n  if (resolvePreviewStrategy(adapter) === 'adapter') {\n    const buildDir = resolveBuildDir(root, config?.buildDir);\n    const timberConfig = { output: (config?.output ?? 'server') as 'server' | 'static' };\n    await adapter!.preview!(timberConfig, buildDir);\n    return;\n  }\n\n  // Fallback: Vite's built-in preview server\n  const preview = _deps?.preview ?? (await import('vite')).preview;\n  const server = await preview({\n    configFile: options.config,\n  });\n  server.printUrls();\n}\n\n/**\n * Validate routes and types without producing build output.\n *\n * Runs the route pass first — resolve the project through Vite, scan it, fail\n * on proven-fatal convention errors, print warnings, and regenerate the route\n * types — then `tsgo --noEmit`. Codegen has to precede the type pass: the\n * generated `.timber/*.d.ts` files are what type `<Link href>` and\n * `useSegmentParams()`, and a fresh clone has never produced them. See\n * `cli-check.ts` for the full reasoning.\n *\n * `--config` names the **Vite** config, as it does for every other command, so\n * an app that builds with a custom one is checkable the same way.\n * `--project` names the tsconfig handed to tsgo.\n */\nexport async function runCheck(options: CommandOptions, _deps?: CheckDeps): Promise<void> {\n  const { checkRoutes, runTypeCheck } = await import('./cli-check.ts');\n  const { root } = await checkRoutes({ viteConfigFile: options.config }, _deps);\n  // tsgo runs from the root the route pass resolved, not from cwd — that is\n  // where it just wrote the declarations tsgo has to read.\n  await runTypeCheck({ root, config: options.project }, _deps);\n}\n\n// ─── Schema Subcommand ───────────────────────────────────────────────────────\n\n/**\n * `timber schema sync` — scan filesystem for dynamic segments, diff against\n * app/schema.ts, and append missing entries with type-appropriate codec defaults.\n *\n * See design/41-global-params.md §Auto-Scaffolding\n */\nexport async function runSchema(args: string[]): Promise<void> {\n  const subcommand = args[0];\n\n  if (subcommand !== 'sync') {\n    throw new Error(\n      `Unknown schema subcommand: ${subcommand ?? '(none)'}. Usage: timber schema sync`\n    );\n  }\n\n  const { runSchemaSync, defaultCodecForSegment } = await import('./cli-schema-sync.ts');\n  const result = runSchemaSync(process.cwd());\n\n  if (result.filesystemSegments.length === 0) {\n    console.log('[timber] No dynamic segments found in app/.');\n    return;\n  }\n\n  if (result.created) {\n    console.log(`[timber] Created app/schema.ts with ${result.addedSegments.length} segment(s):`);\n    for (const seg of result.addedSegments) {\n      console.log(`  + ${seg}: ${defaultCodecForSegment(seg)}`);\n    }\n    return;\n  }\n\n  if (result.addedSegments.length === 0 && result.removedSegments.length === 0) {\n    console.log('[timber] Schema is up to date — all segments are registered.');\n    return;\n  }\n\n  if (result.addedSegments.length > 0) {\n    console.log(`[timber] Added ${result.addedSegments.length} segment(s) to app/schema.ts:`);\n    for (const seg of result.addedSegments) {\n      console.log(`  + ${seg}: ${defaultCodecForSegment(seg)}`);\n    }\n  }\n\n  if (result.removedSegments.length > 0) {\n    console.log(\n      `[timber] Removed ${result.removedSegments.length} stale segment(s) from app/schema.ts:`\n    );\n    for (const seg of result.removedSegments) {\n      console.log(`  - ${seg}`);\n    }\n  }\n}\n\n// ─── Init Subcommand ─────────────────────────────────────────────────────────\n\n/**\n * `timber init` — write AGENTS.md (and a CLAUDE.md symlink to it) to the\n * project root so AI coding agents can discover timber.js documentation and\n * conventions.\n *\n * The content is read from the installed @timber-js/app package itself, so it\n * stays in sync with the installed version.\n */\nexport async function runInit(): Promise<void> {\n  const { readFileSync, writeFileSync, existsSync, symlinkSync } = await import('node:fs');\n  const { resolve, dirname } = await import('node:path');\n  const { fileURLToPath } = await import('node:url');\n\n  const root = process.cwd();\n  const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');\n\n  const agentSkillPath = resolve(packageRoot, 'agent-skill.md');\n  if (!existsSync(agentSkillPath)) {\n    throw new Error(\n      'agent-skill.md not found in @timber-js/app package. ' +\n        'This may be a development install — try reinstalling.'\n    );\n  }\n\n  const agentSkill = readFileSync(agentSkillPath, 'utf-8');\n\n  const agentsPath = resolve(root, 'AGENTS.md');\n  const claudePath = resolve(root, 'CLAUDE.md');\n\n  const wrote: string[] = [];\n\n  if (existsSync(agentsPath)) {\n    console.log('[timber] AGENTS.md already exists — skipping (delete it first to regenerate)');\n  } else {\n    writeFileSync(agentsPath, agentSkill);\n    wrote.push('AGENTS.md');\n  }\n\n  if (existsSync(claudePath)) {\n    console.log('[timber] CLAUDE.md already exists — skipping (delete it first to regenerate)');\n  } else {\n    try {\n      // Relative target so the link survives the project directory moving.\n      // The 'file' type argument is required for Windows (ignored elsewhere).\n      symlinkSync('AGENTS.md', claudePath, 'file');\n      wrote.push('CLAUDE.md (symlink)');\n    } catch {\n      // Windows without Developer Mode or admin rights can't create symlinks\n      // (EPERM) — fall back to a plain pointer file.\n      writeFileSync(claudePath, 'Read AGENTS.md for project context and conventions.\\n');\n      wrote.push('CLAUDE.md');\n    }\n  }\n\n  if (wrote.length > 0) {\n    console.log(\n      `[timber] Created ${wrote.join(' and ')} — AI agents can now discover timber.js docs.`\n    );\n    console.log('[timber] Full documentation: node_modules/@timber-js/app/docs/');\n  } else {\n    console.log('[timber] Nothing to do — both files already exist.');\n  }\n}\n\n// ─── Main Entry Point ────────────────────────────────────────────────────────\n\nasync function main(): Promise<void> {\n  const parsed = parseArgs(process.argv.slice(2));\n  const options: CommandOptions = { config: parsed.config, project: parsed.project };\n\n  switch (parsed.command) {\n    case 'dev':\n      await runDev(options);\n      break;\n    case 'build':\n      await runBuild(options);\n      break;\n    case 'preview':\n      await runPreview(options);\n      break;\n    case 'check':\n      await runCheck(options);\n      break;\n    case 'schema':\n      await runSchema(parsed.rest);\n      break;\n    case 'init':\n      await runInit();\n      break;\n    case 'graph': {\n      // Lazy import — the graph implementation (and, on a cache miss,\n      // Vite + the crawl child) never loads for the other commands.\n      const { runGraph } = await import('./analyze/graph-command.ts');\n      await runGraph({\n        file: parsed.rest[0],\n        config: parsed.config,\n        json: parsed.json,\n        all: parsed.all,\n      });\n      break;\n    }\n  }\n}\n\n// Run main when executed as a CLI (not imported in tests).\n// The bin shim (bin/timber.mjs) does `import '../dist/cli.js'`, so\n// process.argv[1] points to the shim, not this file. We check both:\n// direct execution AND being imported by the timber bin shim.\nconst isDirectExecution =\n  typeof process !== 'undefined' &&\n  process.argv[1] &&\n  (import.meta.url.endsWith(process.argv[1]) ||\n    process.argv[1].endsWith('bin/timber.mjs') ||\n    process.argv[1].endsWith('bin/timber'));\n\nif (isDirectExecution) {\n  main().catch((err) => {\n    console.error(err.message);\n    process.exit(1);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// timber.js CLI\n//\n// Wraps Vite commands with timber-specific behavior.\n// See design/18-build-system.md §\"CLI\".\n//\n// Commands:\n//   timber dev      — Start Vite dev server with HMR\n//   timber build    — Run multi-environment build via createBuilder/buildApp\n//   timber preview  — Serve the production build\n//   timber check    — Validate types + routes without building\n//   timber graph    — Classify a file's module environment(s) (design/47)\n\n// Type-only — the implementation is imported dynamically inside runCheck so the\n// CLI's other commands never load the route scanner.\nimport type { CheckDeps } from './cli-check.ts';\nimport type { ResolveViteConfig } from './cli-context.ts';\n\nexport type { CheckDeps };\n\nconst COMMANDS = ['dev', 'build', 'preview', 'check', 'schema', 'init', 'graph'] as const;\ntype Command = (typeof COMMANDS)[number];\n\nexport interface ParsedArgs {\n  command: Command;\n  config: string | undefined;\n  /** `--project`: the tsconfig `timber check` passes to tsgo. */\n  project: string | undefined;\n  /** `timber graph` only: emit the machine-readable JSON contract. */\n  json: boolean;\n  /** `timber graph` only: classify the whole project. */\n  all: boolean;\n  /** Positional arguments after the command (`schema sync`, `graph <file>`). */\n  rest: string[];\n}\n\nexport interface CommandOptions {\n  /** Path to a Vite config file. Means the same thing for every command. */\n  config?: string;\n  /** `timber check` only: the tsconfig to type-check. */\n  project?: string;\n}\n\n/**\n * Parse CLI arguments into a structured command + options.\n * Accepts: timber <command> [--config|-c <path>] [--project <path>]\n *\n * `--config` names a **Vite** config file for every command, `check` included\n * (TIM-1332): `check` resolves the project through Vite, so a project that\n * builds with `--config ./custom.vite.config.ts` has to be checkable the same\n * way. `--project` names the tsconfig, spelled as tsgo and tsc spell it, and\n * is meaningful only for `check`.\n *\n * Before TIM-1332 `--config` meant the tsconfig for `check` alone — one flag\n * with two meanings, which the docs had to carry a note to explain and which\n * left custom Vite configs unreachable from `check` entirely.\n *\n * Unknown flags are an error, not silently ignored — `timber dev --port 4000`\n * starting on the default port would contradict fail-loudly. The surface stays\n * deliberately small (design/11-platform.md §CLI); port selection goes through\n * the PORT env var or server.port in vite.config.ts.\n *\n * Each subcommand declares its exact flags (the `check --project` precedent,\n * TIM-1332): `graph` additionally accepts a file positional plus `--json` and\n * `--all`, and those two are rejected everywhere else.\n */\nexport function parseArgs(args: string[]): ParsedArgs {\n  if (args.length === 0) {\n    throw new Error(\n      'No command provided. Usage: timber <dev|build|preview|check|schema|init|graph> [--config <path>]'\n    );\n  }\n\n  const command = args[0];\n  if (!COMMANDS.includes(command as Command)) {\n    throw new Error(`Unknown command: ${command}. Available commands: ${COMMANDS.join(', ')}`);\n  }\n\n  let config: string | undefined;\n  let project: string | undefined;\n  let json = false;\n  let all = false;\n  const rest: string[] = [];\n  for (let i = 1; i < args.length; i++) {\n    const arg = args[i];\n    if (arg === '--config' || arg === '-c') {\n      config = args[++i];\n      if (!config) {\n        throw new Error('--config requires a path argument');\n      }\n    } else if (arg === '--json' || arg === '--all') {\n      if (command !== 'graph') {\n        throw new Error(\n          `${arg} is only valid for \\`timber graph\\` (the module-environment query).`\n        );\n      }\n      if (arg === '--json') json = true;\n      else all = true;\n    } else if (arg === '--project') {\n      if (command !== 'check') {\n        throw new Error(\n          `--project is only valid for \\`timber check\\` (it names the tsconfig to type-check). ` +\n            `To point \\`timber ${command}\\` at a different Vite config, use --config <path>.`\n        );\n      }\n      project = args[++i];\n      if (!project) {\n        throw new Error('--project requires a path argument');\n      }\n    } else if (arg.startsWith('-')) {\n      const portHint =\n        arg === '--port' || arg === '-p'\n          ? ' To change the port, set the PORT environment variable (PORT=4000 timber dev) ' +\n            'or server.port in vite.config.ts.'\n          : '';\n      throw new Error(\n        `Unknown option: ${arg}. The timber CLI accepts --config <path>` +\n          ` (and --project <path> for \\`check\\`).${portHint}`\n      );\n    } else if (command === 'schema' || command === 'init' || command === 'graph') {\n      rest.push(arg);\n    } else {\n      throw new Error(`Unexpected argument: ${arg}. Usage: timber ${command} [--config <path>]`);\n    }\n  }\n\n  if (command === 'graph' && rest.length > 1) {\n    throw new Error(\n      `timber graph takes one file. Usage: timber graph <file> [--json], or timber graph --all --json`\n    );\n  }\n\n  return { command: command as Command, config, project, json, all, rest };\n}\n\n// ─── Command Implementations ─────────────────────────────────────────────────\n\n/** @internal Dependency injection for testing. */\nexport interface ViteDeps {\n  createServer?: typeof import('vite').createServer;\n  createBuilder?: typeof import('vite').createBuilder;\n  preview?: typeof import('vite').preview;\n  resolveViteConfig?: ResolveViteConfig;\n}\n\n/**\n * Start the Vite dev server with a supervisor that respawns the process\n * when timber.config.ts changes. Node's require cache for ESM modules\n * loaded via require() cannot be evicted, so an in-process restart\n * serves stale config. The supervisor forks a worker; when the worker\n * exits with RESTART_EXIT_CODE (set by timber-dev-server on config file\n * change), the supervisor spawns a fresh worker with a clean cache.\n *\n * The timber plugin binds the port immediately with a holding page\n * (in rootSync's config hook) so browsers see a \"starting...\" page\n * instead of ERR_CONNECTION_REFUSED during initialization.\n *\n * See design/21-dev-server.md, TIM-665, TIM-1444.\n */\nexport async function runDev(options: CommandOptions, _deps?: ViteDeps): Promise<void> {\n  // Worker mode: run the dev server directly (forked by supervisor below)\n  if (process.env.__TIMBER_DEV_WORKER) {\n    const createServer = _deps?.createServer ?? (await import('vite')).createServer;\n    const server = await createServer({\n      configFile: options.config,\n    });\n    await server.listen();\n    server.printUrls();\n    return;\n  }\n\n  // Supervisor mode: fork a worker and respawn on config changes.\n  const { fork } = await import('node:child_process');\n  const { RESTART_EXIT_CODE } = await import('./plugins/dev-server.ts');\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const result = await new Promise<{ code: number | null; signal: NodeJS.Signals | null }>(\n      (resolve) => {\n        const child = fork(process.argv[1], process.argv.slice(2), {\n          stdio: 'inherit',\n          env: { ...process.env, __TIMBER_DEV_WORKER: '1' },\n        });\n\n        // Forward signals to the child. SIGINT from Ctrl+C is sent to\n        // the entire process group, but a targeted SIGTERM (from a\n        // process manager or test teardown) only reaches the parent.\n        const onSigint = () => child.kill('SIGINT');\n        const onSigterm = () => child.kill('SIGTERM');\n        process.on('SIGINT', onSigint);\n        process.on('SIGTERM', onSigterm);\n\n        child.on('exit', (code, signal) => {\n          process.off('SIGINT', onSigint);\n          process.off('SIGTERM', onSigterm);\n          resolve({ code, signal });\n        });\n      }\n    );\n\n    if (result.code === RESTART_EXIT_CODE) {\n      continue;\n    }\n\n    // Child was killed by a signal (e.g. SIGTERM) — re-raise on ourselves\n    if (result.signal) {\n      process.kill(process.pid, result.signal);\n    }\n\n    if (result.code != null && result.code !== 0) {\n      process.exit(result.code);\n    }\n\n    break;\n  }\n}\n\n/**\n * Run the production build using createBuilder + buildApp.\n * Direct build() calls do NOT trigger the RSC plugin's multi-environment\n * pipeline — createBuilder/buildApp is required.\n */\nexport async function runBuild(options: CommandOptions, _deps?: ViteDeps): Promise<void> {\n  const createBuilder = _deps?.createBuilder ?? (await import('vite')).createBuilder;\n  const builder = await createBuilder({\n    configFile: options.config,\n  });\n  await builder.buildApp();\n}\n\n/**\n * Serve the production build for local testing.\n * If the adapter provides a preview() method, it takes priority.\n * Otherwise falls back to Vite's built-in preview server.\n *\n * The project is resolved through Vite, as `timber check` resolves it\n * (`cli-context.ts`), so the adapter, the output mode, and the build\n * directory are the ones `timber build` used — including `--config`, inline\n * `timber({ ... })` options, Vite's `root`, and `build.outDir`, none of which\n * a re-read of `timber.config.ts` can see (TIM-1531). A config file that\n * exists but fails to load throws (naming the file) instead of silently\n * degrading to plain Vite preview (TIM-1066).\n */\nexport async function runPreview(options: CommandOptions, _deps?: ViteDeps): Promise<void> {\n  const { resolveTimberContext } = await import('./cli-context.ts');\n  const { adapterConfig, contextAdapter } = await import('./plugin-context.ts');\n\n  const ctx = await resolveTimberContext('preview', options.config, _deps?.resolveViteConfig);\n  const adapter = contextAdapter(ctx);\n\n  if (typeof adapter?.preview === 'function') {\n    await adapter.preview(adapterConfig(ctx), {\n      output: ctx.config.output ?? 'server',\n      outputDir: ctx.buildDir,\n    });\n    return;\n  }\n\n  // Fallback: Vite's built-in preview server\n  const preview = _deps?.preview ?? (await import('vite')).preview;\n  const server = await preview({\n    configFile: options.config,\n  });\n  server.printUrls();\n}\n\n/**\n * Validate routes and types without producing build output.\n *\n * Runs the route pass first — resolve the project through Vite, scan it, fail\n * on proven-fatal convention errors, print warnings, and regenerate the route\n * types — then `tsgo --noEmit`. Codegen has to precede the type pass: the\n * generated `.timber/*.d.ts` files are what type `<Link href>` and\n * `useSegmentParams()`, and a fresh clone has never produced them. See\n * `cli-check.ts` for the full reasoning.\n *\n * `--config` names the **Vite** config, as it does for every other command, so\n * an app that builds with a custom one is checkable the same way.\n * `--project` names the tsconfig handed to tsgo.\n */\nexport async function runCheck(options: CommandOptions, _deps?: CheckDeps): Promise<void> {\n  const { checkRoutes, runTypeCheck } = await import('./cli-check.ts');\n  const { root } = await checkRoutes({ viteConfigFile: options.config }, _deps);\n  // tsgo runs from the root the route pass resolved, not from cwd — that is\n  // where it just wrote the declarations tsgo has to read.\n  await runTypeCheck({ root, config: options.project }, _deps);\n}\n\n// ─── Schema Subcommand ───────────────────────────────────────────────────────\n\n/**\n * `timber schema sync` — scan filesystem for dynamic segments, diff against\n * app/schema.ts, and append missing entries with type-appropriate codec defaults.\n *\n * See design/41-global-params.md §Auto-Scaffolding\n */\nexport async function runSchema(args: string[]): Promise<void> {\n  const subcommand = args[0];\n\n  if (subcommand !== 'sync') {\n    throw new Error(\n      `Unknown schema subcommand: ${subcommand ?? '(none)'}. Usage: timber schema sync`\n    );\n  }\n\n  const { runSchemaSync, defaultCodecForSegment } = await import('./cli-schema-sync.ts');\n  const result = runSchemaSync(process.cwd());\n\n  if (result.filesystemSegments.length === 0) {\n    console.log('[timber] No dynamic segments found in app/.');\n    return;\n  }\n\n  if (result.created) {\n    console.log(`[timber] Created app/schema.ts with ${result.addedSegments.length} segment(s):`);\n    for (const seg of result.addedSegments) {\n      console.log(`  + ${seg}: ${defaultCodecForSegment(seg)}`);\n    }\n    return;\n  }\n\n  if (result.addedSegments.length === 0 && result.removedSegments.length === 0) {\n    console.log('[timber] Schema is up to date — all segments are registered.');\n    return;\n  }\n\n  if (result.addedSegments.length > 0) {\n    console.log(`[timber] Added ${result.addedSegments.length} segment(s) to app/schema.ts:`);\n    for (const seg of result.addedSegments) {\n      console.log(`  + ${seg}: ${defaultCodecForSegment(seg)}`);\n    }\n  }\n\n  if (result.removedSegments.length > 0) {\n    console.log(\n      `[timber] Removed ${result.removedSegments.length} stale segment(s) from app/schema.ts:`\n    );\n    for (const seg of result.removedSegments) {\n      console.log(`  - ${seg}`);\n    }\n  }\n}\n\n// ─── Init Subcommand ─────────────────────────────────────────────────────────\n\n/**\n * `timber init` — write AGENTS.md (and a CLAUDE.md symlink to it) to the\n * project root so AI coding agents can discover timber.js documentation and\n * conventions.\n *\n * The content is read from the installed @timber-js/app package itself, so it\n * stays in sync with the installed version.\n */\nexport async function runInit(): Promise<void> {\n  const { readFileSync, writeFileSync, existsSync, symlinkSync } = await import('node:fs');\n  const { resolve, dirname } = await import('node:path');\n  const { fileURLToPath } = await import('node:url');\n\n  const root = process.cwd();\n  const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');\n\n  const agentSkillPath = resolve(packageRoot, 'agent-skill.md');\n  if (!existsSync(agentSkillPath)) {\n    throw new Error(\n      'agent-skill.md not found in @timber-js/app package. ' +\n        'This may be a development install — try reinstalling.'\n    );\n  }\n\n  const agentSkill = readFileSync(agentSkillPath, 'utf-8');\n\n  const agentsPath = resolve(root, 'AGENTS.md');\n  const claudePath = resolve(root, 'CLAUDE.md');\n\n  const wrote: string[] = [];\n\n  if (existsSync(agentsPath)) {\n    console.log('[timber] AGENTS.md already exists — skipping (delete it first to regenerate)');\n  } else {\n    writeFileSync(agentsPath, agentSkill);\n    wrote.push('AGENTS.md');\n  }\n\n  if (existsSync(claudePath)) {\n    console.log('[timber] CLAUDE.md already exists — skipping (delete it first to regenerate)');\n  } else {\n    try {\n      // Relative target so the link survives the project directory moving.\n      // The 'file' type argument is required for Windows (ignored elsewhere).\n      symlinkSync('AGENTS.md', claudePath, 'file');\n      wrote.push('CLAUDE.md (symlink)');\n    } catch {\n      // Windows without Developer Mode or admin rights can't create symlinks\n      // (EPERM) — fall back to a plain pointer file.\n      writeFileSync(claudePath, 'Read AGENTS.md for project context and conventions.\\n');\n      wrote.push('CLAUDE.md');\n    }\n  }\n\n  if (wrote.length > 0) {\n    console.log(\n      `[timber] Created ${wrote.join(' and ')} — AI agents can now discover timber.js docs.`\n    );\n    console.log('[timber] Full documentation: node_modules/@timber-js/app/docs/');\n  } else {\n    console.log('[timber] Nothing to do — both files already exist.');\n  }\n}\n\n// ─── Main Entry Point ────────────────────────────────────────────────────────\n\nasync function main(): Promise<void> {\n  const parsed = parseArgs(process.argv.slice(2));\n  const options: CommandOptions = { config: parsed.config, project: parsed.project };\n\n  switch (parsed.command) {\n    case 'dev':\n      await runDev(options);\n      break;\n    case 'build':\n      await runBuild(options);\n      break;\n    case 'preview':\n      await runPreview(options);\n      break;\n    case 'check':\n      await runCheck(options);\n      break;\n    case 'schema':\n      await runSchema(parsed.rest);\n      break;\n    case 'init':\n      await runInit();\n      break;\n    case 'graph': {\n      // Lazy import — the graph implementation (and, on a cache miss,\n      // Vite + the crawl child) never loads for the other commands.\n      const { runGraph } = await import('./analyze/graph-command.ts');\n      await runGraph({\n        file: parsed.rest[0],\n        config: parsed.config,\n        json: parsed.json,\n        all: parsed.all,\n      });\n      break;\n    }\n  }\n}\n\n// Run main when executed as a CLI (not imported in tests).\n// The bin shim (bin/timber.mjs) does `import '../dist/cli.js'`, so\n// process.argv[1] points to the shim, not this file. We check both:\n// direct execution AND being imported by the timber bin shim.\nconst isDirectExecution =\n  typeof process !== 'undefined' &&\n  process.argv[1] &&\n  (import.meta.url.endsWith(process.argv[1]) ||\n    process.argv[1].endsWith('bin/timber.mjs') ||\n    process.argv[1].endsWith('bin/timber'));\n\nif (isDirectExecution) {\n  main().catch((err) => {\n    console.error(err.message);\n    process.exit(1);\n  });\n}\n"],"mappings":"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"}

package/dist/client/browser-dev.d.ts

@@ -62,7 +62,7 @@ export declare function setupClientErrorForwarding(hot: HotInterface): void;
  * they are expected during navigation and are handled by the error boundary
  * and router. Exported for tests.
  *
- * See also: isControlFlowSignal() in server/primitives.ts (server-side,
+ * See also: isControlFlowSignal() in server/signal-identity.ts (server-side,
  * handles both instanceof and digest detection).
  */
 export declare function isFrameworkSignalError(error: unknown): boolean;

package/dist/client/browser-entry/action-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-dispatch.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/action-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAwBH,wBAAgB,kBAAkB,IAAI,IAAI,CA8KzC"}
+{"version":3,"file":"action-dispatch.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/action-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH,wBAAgB,kBAAkB,IAAI,IAAI,CAmMzC"}

package/dist/client/browser-entry/hydrate.d.ts

@@ -1,20 +1,20 @@
 /**
- * Hydration — pre-hydration sequence and hydrating the React root.
+ * Hydration — making the server-rendered page current and hydrating the
+ * React root with it.
  *
  * Handles two paths:
  * 1. RSC payload available: hydrate the router's React root with the payload
- * 2. No RSC payload: nothing — the root is created by the first render
- *    (client/react-root.ts)
+ * 2. No RSC payload: nothing to hydrate — the root is created by the first
+ *    render (client/react-root.ts) — but the page is still made current
  *
- * Pre-hydration ordering contract (MUST execute in this order):
- *   1. initRouter()          — creates the global router so useRouter()
- *                              works during render
- *   2. setNavigationState()  — populates pathname/search so usePathname()
- *                              returns correct values during hydration
- *   3. hydrateRoot()         — synchronously executes component render
- *                              functions that depend on steps 1-2
+ * Either way the page becomes current through `RouterInstance.hydrate`, the
+ * same prepare-and-commit every navigation uses, committed before the tree
+ * is handed to React. The one ordering left is that the router exists
+ * before `hydrateRoot()`, so `useRouter()` works during render. Pathname
+ * and search reach the tree as props of its NavigationProvider, from the
+ * router's prepared navState — there is no store to seed first (TIM-1541).
  *
- * Params are not part of this sequence. They arrive on the payload root and
+ * Params are not part of this sequence either. They arrive on the payload root and
  * are published by `PayloadRoot` at the top of the tree, so
  * `useSegmentParams()` is correct during hydration without anything having to
  * run before it (TIM-1294, TIM-1297).
@@ -29,35 +29,25 @@ interface HydrateOptions {
     rscResult: RscStreamResult | null;
     /** The router's React root — the one every navigation renders through. */
     reactRoot: ReactRootHost;
-    /** The router's wrapper chain — see `RouterInitResult.renderTree`. */
-    renderTree: RouterInitResult['renderTree'];
+    /** Makes the page current and builds its tree — see `RouterInitResult.hydrate`. */
+    hydrate: RouterInitResult['hydrate'];
 }
 /**
- * Run the pre-hydration sequence: set navigation state from the address bar.
- * Must be called AFTER initRouter().
- *
- * Params are no longer seeded here. They used to arrive on two inline scripts
- * that had to execute before `hydrateRoot()`, because hydration synchronously
- * renders components that read them. They now ride the payload root, and the
- * provider that publishes them renders before its own descendants — so the
- * ordering the step existed to guarantee is now a property of the tree rather
- * than of the bootstrap sequence (TIM-1294, TIM-1297).
- */
-export declare function runPreHydration(): void;
-/**
- * Hydrate the React tree when an RSC payload is available.
+ * Make the server-rendered page current, and hydrate the React tree with it
+ * when an RSC payload is available.
  *
  * Wraps the payload with the router's chain (NavigationProvider,
  * TimberNuqsAdapter, the slot content cache, ...) and hydrates the router's
  * React root with it, on the document.
  *
- * When no RSC payload is available (JS-only client) there is nothing to
- * hydrate and nothing to do: the root must not be created at bootstrap —
+ * When no RSC payload is available (JS-only client) the page is committed
+ * at once and there is nothing to hydrate: the root must not be created at
+ * bootstrap —
  * `createRoot(document).render()` would take React ownership of the entire
  * document and blank the SSR HTML — so the router's first render, i.e. the
  * first navigation or revalidation, creates it with the tree it renders
  * (`createReactRoot`, TIM-600 / TIM-580).
  */
-export declare function hydrateApp({ rscResult, reactRoot, renderTree }: HydrateOptions): void;
+export declare function hydrateApp({ rscResult, reactRoot, hydrate }: HydrateOptions): void;
 export {};
 //# sourceMappingURL=hydrate.d.ts.map

package/dist/client/browser-entry/hydrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/hydrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAwCzD,UAAU,cAAc;IACtB,qDAAqD;IACrD,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,aAAa,CAAC;IACzB,sEAAsE;IACtE,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAKtC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,cAAc,GAAG,IAAI,CAmCrF"}
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/hydrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAwCzD,UAAU,cAAc;IACtB,qDAAqD;IACrD,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,0EAA0E;IAC1E,SAAS,EAAE,aAAa,CAAC;IACzB,mFAAmF;IACnF,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;CACtC;AAcD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,cAAc,GAAG,IAAI,CAmClF"}

package/dist/client/browser-entry/index.d.ts

@@ -7,8 +7,8 @@
  *   action-dispatch.ts  — server action callServer callback
  *   rsc-stream.ts       — __timber_f chunk handling + ReadableStream
  *   router-init.ts      — createRouter + Navigation API setup
- *   hydrate.ts          — pre-hydration sequence + hydrating the root
- *   post-hydration.ts   — history stack, segment cache, popstate, scroll
+ *   hydrate.ts          — makes the server page current + hydrates the root
+ *   post-hydration.ts   — popstate, scroll
  *   hmr.ts              — dev-only HMR + error forwarding
  *   scroll.ts           — getScrollY helper
  *
@@ -18,11 +18,11 @@
  *   2. createRscPayloadStream()  — decode inlined RSC payload
  *   3. createReactRoot() +       — the root host the router renders through,
  *      createTimberRouter()        then the router + Navigation API
- *   4. runPreHydration()         — set params + navigation state
- *   5. hydrateApp()              — hydrate the root (no-op without a payload)
- *   6. setupPostHydration()      — history stack, popstate, scroll
- *   7. setupHmr()                — dev-only HMR wiring
- *   8. timber-ready signal       — E2E test readiness indicator
+ *   4. hydrateApp()              — make the page current through the router,
+ *                                   hydrate the root (no root without a payload)
+ *   5. setupPostHydration()      — popstate, scroll
+ *   6. setupHmr()                — dev-only HMR wiring
+ *   7. timber-ready signal       — E2E test readiness indicator
  *
  * Design docs: 18-build-system.md §"Entry Files", 19-client-navigation.md
  */

package/dist/client/browser-entry/post-hydration.d.ts

@@ -1,29 +1,26 @@
 /**
- * Post-Hydration Wiring — history stack, segment cache, popstate, scroll.
+ * Post-Hydration Wiring — popstate and scroll.
  *
  * Sets up everything that needs to happen after the React root exists:
- * - Stores initial page in history stack for instant back navigation
  * - Initializes scroll state for the initial entry
- * - Populates segment cache from server-embedded metadata
  * - Registers popstate handler for back/forward navigation
  * - Sets up debounced scroll position saving
  *
+ * The initial page's history entry and segment cache are not written here:
+ * they are the router's, and hydration makes the page current through
+ * `RouterInstance.hydrate` like any other commit (TIM-1541).
+ *
  * See design/19-client-navigation.md §"History Stack"
  */
 import type { RouterInstance } from '#client-internal';
 import type { NavigationApiController } from '../navigation-api.ts';
-import type { ParamsSource } from '../../shared/payload-root.ts';
 interface PostHydrationOptions {
     router: RouterInstance;
     navApiController: NavigationApiController | null;
-    /** Decoded RSC element from initial SSR (null if no RSC payload) */
-    initialElement: unknown;
-    /** The params that payload published, from the same decode. */
-    initialParams: ParamsSource;
 }
 /**
  * Wire up post-hydration event handlers and state.
  */
-export declare function setupPostHydration({ router, navApiController, initialElement, initialParams, }: PostHydrationOptions): void;
+export declare function setupPostHydration({ router, navApiController }: PostHydrationOptions): void;
 export {};
 //# sourceMappingURL=post-hydration.d.ts.map

package/dist/client/browser-entry/post-hydration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-hydration.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/post-hydration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAGjE,UAAU,oBAAoB;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjD,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,aAAa,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,gBAAgB,EAChB,cAAc,EACd,aAAa,GACd,EAAE,oBAAoB,GAAG,IAAI,CAqF7B"}
+{"version":3,"file":"post-hydration.d.ts","sourceRoot":"","sources":["../../../src/client/browser-entry/post-hydration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIpE,UAAU,oBAAoB;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,oBAAoB,GAAG,IAAI,CA4D3F"}