@timber-js/app 0.2.0-alpha.159 → 0.2.0-alpha.160

package/dist/server/prebuilt/payload-source.d.ts

@@ -30,6 +30,8 @@ export interface PrebuiltManifestEntry {
 export interface PrebuiltManifest {
     [componentId: string]: {
         entries: Record<string, PrebuiltManifestEntry>;
+        /** When true, the component does not read segment params — the cache key uses `{}`. */
+        paramIndependent?: boolean;
     };
 }
 export interface PrebuiltPayloadSource {
@@ -60,6 +62,7 @@ export declare function ensureManifestLoaded(): Promise<void>;
  * Look up a manifest entry (metadata only, no payload read).
  * Used by the overlay to check seed existence and freshness.
  */
+export declare function isParamIndependent(componentId: string): Promise<boolean>;
 export declare function getManifestEntry(componentId: string, cacheKey: string): Promise<PrebuiltManifestEntry | null>;
 /**
  * Look up a cached payload: manifest entry → payload bytes.

package/dist/server/prebuilt/payload-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload-source.d.ts","sourceRoot":"","sources":["../../../src/server/prebuilt/payload-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,WAAW,EAAE,MAAM,GAAG;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;KAChD,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,YAAY,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACjD,yEAAyE;IACzE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACvD;AAsED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAIjF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAKvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmB5B"}
+{"version":3,"file":"payload-source.d.ts","sourceRoot":"","sources":["../../../src/server/prebuilt/payload-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,WAAW,EAAE,MAAM,GAAG;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAC/C,uFAAuF;QACvF,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,YAAY,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACjD,yEAAyE;IACzE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACvD;AAsED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAIjF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK9E;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAKvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmB5B"}

package/dist/server/prebuilt/synthetic-store.d.ts

@@ -54,6 +54,8 @@ export interface BuildTimeStoreHandle {
      * render ⇒ the entry must fail as a hard build error.
      */
     violations: BuildTimeContextError[];
+    /** Whether the component read `segmentParams` during the render. */
+    segmentParamsRead: boolean;
 }
 /**
  * Create the synthetic per-combo store. `segmentParams` must already be

package/dist/server/prebuilt/synthetic-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synthetic-store.d.ts","sourceRoot":"","sources":["../../../src/server/prebuilt/synthetic-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAW7C;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAC/C,oBAAoB,CA2BtB"}
+{"version":3,"file":"synthetic-store.d.ts","sourceRoot":"","sources":["../../../src/server/prebuilt/synthetic-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAW7C;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;;;OAIG;IACH,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,oEAAoE;IACpE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAC/C,oBAAoB,CAsCtB"}

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

@@ -54,6 +54,8 @@ export interface CapturedEntry {
     bytes: Uint8Array;
     /** Resolved tags from callsite options — static or function-form, evaluated at capture time. */
     tags?: string[];
+    /** Component does not read segment params — cache key uses `{}`. */
+    paramIndependent?: boolean;
 }
 /** A per-entry problem — either a skip (build continues) or a hard error. */
 export interface CaptureIssue {
@@ -92,6 +94,14 @@ export interface CaptureOptions {
      * failure, not a per-entry data problem.
      */
     onEntry: (entry: CapturedEntry) => Promise<void>;
+    /**
+     * Component ID → built chunk file name (or URL) for declaring modules
+     * behind dynamic imports. The capture pass imports these to trigger
+     * cache.component() registration before rendering.
+     */
+    lazyChunks?: Record<string, string>;
+    /** @internal Override chunk loader for testing. */
+    _loadChunk?: (chunkFile: string) => Promise<void>;
     /**
      * Per-entry ceiling on render + drain. A component that hangs (stalled
      * fetch, unbounded recursion the cycle guard can't see) fails its entry

package/dist/server/prebuilt-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prebuilt-builder.d.ts","sourceRoot":"","sources":["../../src/server/prebuilt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAsBH,OAAO,KAAK,EAAgB,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAO1F,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mEAAmE;IACnE,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D;;;;OAIG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAmSD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAgNzB"}
+{"version":3,"file":"prebuilt-builder.d.ts","sourceRoot":"","sources":["../../src/server/prebuilt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAsBH,OAAO,KAAK,EAAgB,YAAY,EAAuB,MAAM,oBAAoB,CAAC;AAO1F,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mEAAmE;IACnE,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D;;;;OAIG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mDAAmD;IACnD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAmTD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CA8OzB"}

package/dist/server/prebuilt-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prebuilt-runtime.d.ts","sourceRoot":"","sources":["../../src/server/prebuilt-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAiCH;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGlE;AAID;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IACjE,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,2DAA2D;AAE3D,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;AAY/C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,wBAAwB,CAAC;CACnC;AA8ED,UAAU,YAAY;IACpB,wBAAwB,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,sBAAsB,EAAE,CACtB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;KAAE,KAC/C,cAAc,CAAC,UAAU,CAAC,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAEvD;AAmCD,eAAO,MAAM,mBAAmB,aAAoB,CAAC;AAoXrD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAClD,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,CAAC,EACZ,OAAO,GAAE,wBAA6B,GACrC,CAAC,CAyCH;AAED,qDAAqD;AACrD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEpF;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EACrD,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,EACZ,QAAQ,CAAC,EAAE,wBAAwB,GAClC,CAAC,CAYH"}
+{"version":3,"file":"prebuilt-runtime.d.ts","sourceRoot":"","sources":["../../src/server/prebuilt-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAkCH;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGlE;AAID;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;IACjE,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,2DAA2D;AAE3D,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;AAY/C,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,wBAAwB,CAAC;CACnC;AA8ED,UAAU,YAAY;IACpB,wBAAwB,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,sBAAsB,EAAE,CACtB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;KAAE,KAC/C,cAAc,CAAC,UAAU,CAAC,CAAC;CACjC;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAEvD;AAmCD,eAAO,MAAM,mBAAmB,aAAoB,CAAC;AAqXrD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,eAAe,EAClD,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,CAAC,EACZ,OAAO,GAAE,wBAA6B,GACrC,CAAC,CAyCH;AAED,qDAAqD;AACrD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEpF;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EACrD,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,EACZ,QAAQ,CAAC,EAAE,wBAAwB,GAClC,CAAC,CAYH"}

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

@@ -13,6 +13,7 @@ import type { PipelineConfig } from '../pipeline.js';
 export declare function setDevSourceMapHandler(handler: (error: Error) => void): void;
 export { runWithEarlyHintsSender } from '../early-hints-sender.js';
 export { runWithWaitUntil } from '../waituntil-bridge.js';
+export { runWithWorkersCachePurge } from '../workers-cache-bridge.js';
 /**
  * Post-build flight capture entry point (TIM-1119). The capture pass must
  * run inside the built RSC bundle — the prebuilt component registry, the

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/index.ts"],"names":[],"mappings":"AAuBA,OAAO,uCAAuC,CAAC;AAuB/C,OAAO,KAAK,EAAuB,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAuCtF;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAE5E;AAgbD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAInE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,wBAAwB,EAAE,cAAc,GACvD,OAAO,CAAC,OAAO,wBAAwB,EAAE,cAAc,CAAC,CAE1D;AAED,QAAA,MAAiB,QAAQ,qCAGxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAkB,CAAC;AAE9C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/index.ts"],"names":[],"mappings":"AAuBA,OAAO,uCAAuC,CAAC;AAuB/C,OAAO,KAAK,EAAuB,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAuCtF;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAE5E;AAsbD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAInE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,wBAAwB,EAAE,cAAc,GACvD,OAAO,CAAC,OAAO,wBAAwB,EAAE,cAAc,CAAC,CAE1D;AAED,QAAA,MAAiB,QAAQ,qCAGxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAkB,CAAC;AAE9C,eAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Per-request Workers Cache purge bridge — ALS bridge for Cloudflare adapter.
+ *
+ * The generated _worker.js wraps each request with `runWithWorkersCachePurge`,
+ * binding `ctx.cache` from the Cloudflare ExecutionContext. The
+ * `WorkersCachePurge` CDN purge handler reads from this ALS to call
+ * `ctx.cache.purge({ tags })` without needing an API token.
+ *
+ * Design doc: design/06-caching.md, design/25-production-deployments.md
+ */
+import type { WorkersCachePurgeCtx } from './als-registry.js';
+/**
+ * Run a function with Workers Cache purge context available.
+ *
+ * Called by the generated Cloudflare _worker.js entry to bind
+ * `ctx.cache` for the request duration.
+ */
+export declare function runWithWorkersCachePurge<T>(ctx: WorkersCachePurgeCtx, fn: () => T): T;
+/**
+ * Get the current request's Workers Cache context, if available.
+ *
+ * Returns undefined outside a Cloudflare Workers request context
+ * or on platforms without Workers Cache support.
+ */
+export declare function getWorkersCachePurgeCtx(): WorkersCachePurgeCtx | undefined;
+//# sourceMappingURL=workers-cache-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workers-cache-bridge.d.ts","sourceRoot":"","sources":["../../src/server/workers-cache-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAE1E"}

package/docs/learn/09-caching.mdx

@@ -130,3 +130,7 @@ export default {
 ```
 
 Implement the `CacheHandler` interface for Redis, Cloudflare KV, or any other backend. See the [Cache API Reference](/docs/api-cache).
+
+import SlowStaticComponent from '@/ui/SlowStaticComponent';
+
+<SlowStaticComponent />

package/docs/learn/14-deploying.mdx

@@ -203,7 +203,7 @@ timber.js provides typed helpers for CDN caching headers and tag-based purging.
 ### Header Helpers
 
 ```ts title="app/proxy.ts"
-import { cacheControl, surrogateKey } from '@timber-js/app/cdn';
+import { cacheControl, cacheTag } from '@timber-js/app/cdn';
 
 export default async function proxy(ctx) {
   if (ctx.pathname.startsWith('/products/')) {
@@ -212,19 +212,25 @@ export default async function proxy(ctx) {
       maxAge: 600,
       staleWhileRevalidate: 60,
     }));
-    ctx.headers.set('Surrogate-Key', surrogateKey(['products']));
+    // Use cacheTag for Cloudflare Workers Cache (all plans)
+    ctx.headers.set('Cache-Tag', cacheTag(['products']));
+    // Or surrogateKey for Fastly/Akamai/Varnish
+    // ctx.headers.set('Surrogate-Key', surrogateKey(['products']));
   }
 }
 ```
 
 ### Purge on `revalidateTag`
 
-Configure a CDN purge handler so `revalidateTag()` also purges the CDN:
+When using the Cloudflare adapter, CDN purge is **automatic** — no configuration needed. The adapter auto-wires `WorkersCachePurge`, which uses `ctx.cache.purge({ tags })` from the Workers runtime. Available on all Cloudflare plans with no API token required. Just set `Cache-Tag` headers on your responses using `cacheTag()`.
+
+For non-Workers Cloudflare zones (Enterprise), or other CDNs, configure a purge handler manually:
 
 ```ts title="timber.config.ts"
 import { CloudflarePurge } from '@timber-js/app/cdn/cloudflare';
 
 export default {
+  // Only needed for non-Workers Cloudflare zones (Enterprise)
   cdnPurge: new CloudflarePurge({
     zoneId: process.env.CF_ZONE_ID!,
     apiToken: process.env.CF_API_TOKEN!,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timber-js/app",
-  "version": "0.2.0-alpha.159",
+  "version": "0.2.0-alpha.160",
   "description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
   "keywords": [
     "cloudflare-workers",
@@ -92,6 +92,10 @@
       "types": "./dist/cdn/cloudflare-purge.d.ts",
       "import": "./dist/cdn/cloudflare-purge.js"
     },
+    "./cdn/cloudflare-workers": {
+      "types": "./dist/cdn/workers-cache-purge.d.ts",
+      "import": "./dist/cdn/workers-cache-purge.js"
+    },
     "./cdn/fastly": {
       "types": "./dist/cdn/fastly-purge.d.ts",
       "import": "./dist/cdn/fastly-purge.js"

package/src/adapters/cloudflare.ts

@@ -285,6 +285,12 @@ export function cloudflare(options: CloudflareAdapterOptions = {}): TimberPlatfo
         generatePrebuiltSourceModule(prebuiltData)
       );
 
+      // Write the runtime init module — sets process.env.TIMBER_RUNTIME
+      // BEFORE the RSC entry evaluates (ESM import order). Without this,
+      // createRequestHandler's auto-wire for WorkersCachePurge would not
+      // detect the Cloudflare runtime (TIM-1170).
+      await writeFile(join(outDir, '_timber-runtime-init.js'), generateRuntimeInitModule());
+
       // Generate the Workers entry point
       const hasManifestInit = !!config.manifestInit;
       const workerEntry = generateWorkerEntry(outDir, outDir, hasManifestInit, hasWorkerHandlers);
@@ -342,16 +348,16 @@ export function generateWorkerEntry(
 // Do not edit — this file is regenerated on each build.
 
 import { AsyncLocalStorage } from 'node:async_hooks'
-// Side-effect import: sets globalThis.__TIMBER_PREBUILT_SOURCE__ before the
-// RSC handler evaluates. Must be a static import (not body code) so ESM
-// evaluation order guarantees it runs before ./rsc/index.js.
+// Side-effect imports: evaluated IN ORDER before the _worker.js body runs.
+// _timber-runtime-init.js sets TIMBER_RUNTIME before createRequestHandler()
+// runs (during the RSC entry's top-level await) so the auto-wire for
+// WorkersCachePurge can detect the Cloudflare runtime (TIM-1170).
+// _timber-prebuilt-source.js sets globalThis.__TIMBER_PREBUILT_SOURCE__
+// for cache.component payloads.
+import './_timber-runtime-init.js'
 import './_timber-prebuilt-source.js'
-${manifestImport}import handler, { runWithWaitUntil } from '${rscEntryRelative}'
+${manifestImport}import handler, { runWithWaitUntil, runWithWorkersCachePurge } from '${rscEntryRelative}'
 ${handlersImport}
-// Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
-// See design/25-production-deployments.md §"TIMBER_RUNTIME".
-globalThis.process ??= { env: {} }
-process.env.TIMBER_RUNTIME = 'cloudflare'
 
 // Bind Cloudflare env to ALS so getCloudflareBindings() works at runtime.
 // Uses the same Symbol.for key as getCloudflareBindings() reads from.
@@ -406,8 +412,16 @@ ${handlersSpread}  async fetch(request, env, ctx) {
       if (cached) return cached
     }
 
-    const response = await bindingsAls.run(env, () =>
+    // Bridge ctx.cache into the per-request ALS so WorkersCachePurge can
+    // call ctx.cache.purge({ tags }) during cache.invalidate/revalidateTag.
+    // Workers Cache is available on all Cloudflare plans — no API token needed.
+    const workersCacheCtx = ctx.cache && typeof ctx.cache.purge === 'function' ? ctx.cache : null
+    const runHandler = () =>
       runWithWaitUntil((promise) => ctx.waitUntil(promise), () => handler(request))
+    const response = await bindingsAls.run(env, () =>
+      workersCacheCtx
+        ? runWithWorkersCachePurge(workersCacheCtx, runHandler)
+        : runHandler()
     )
 
     // Cache public responses at the edge. A response is edge-cacheable if
@@ -525,6 +539,23 @@ globalThis.__TIMBER_PREBUILT_SOURCE__ = {
 `;
 }
 
+/**
+ * Generate the runtime init module that sets TIMBER_RUNTIME before the
+ * RSC entry evaluates. Imported as a side-effect module in _worker.js.
+ *
+ * @internal Exported for testing.
+ */
+export function generateRuntimeInitModule(): string {
+  return `// Generated by @timber-js/app/adapters/cloudflare
+// Sets TIMBER_RUNTIME before the RSC handler evaluates (TIM-1170).
+// Must be a separate module imported before rsc/index.js so that ESM
+// evaluation order guarantees the env var is set when
+// createRequestHandler() runs its auto-wire logic.
+globalThis.process ??= { env: {} }
+process.env.TIMBER_RUNTIME = 'cloudflare'
+`;
+}
+
 /** Wrangler binding sections generated from `CloudflareBindings`. */
 export interface WranglerBindingsConfig {
   kv_namespaces?: Array<{ binding: string; id: string }>;

package/src/cdn/headers.ts

@@ -125,3 +125,29 @@ export function surrogateKey(tags: string[]): string {
   }
   return [...new Set(tags)].join(' ');
 }
+
+/**
+ * Build a `Cache-Tag` header value — comma-separated tags for Cloudflare
+ * Workers Cache tag-based purging. Available on ALL Cloudflare plans.
+ *
+ * Tags are deduplicated. Tags must not contain commas (the delimiter).
+ * Maximum tag length is 1024 characters per Cloudflare's limits.
+ *
+ * Use this instead of `surrogateKey()` when using Cloudflare Workers Cache
+ * (ctx.cache.purge). Workers Cache reads `Cache-Tag`, not `Surrogate-Key`.
+ *
+ * ```ts
+ * ctx.headers.set('Cache-Tag', cacheTag(['products', `product:${id}`]));
+ * ```
+ */
+export function cacheTag(tags: string[]): string {
+  for (const tag of tags) {
+    if (tag.includes(',')) {
+      throw new Error(`cacheTag: tag "${tag}" must not contain commas`);
+    }
+    if (tag.length > 1024) {
+      throw new Error(`cacheTag: tag "${tag}" exceeds 1024-character limit`);
+    }
+  }
+  return [...new Set(tags)].join(',');
+}

package/src/cdn/index.ts

@@ -3,14 +3,15 @@
 // Header utilities and purge handler for CDN caching. Developer-elected,
 // never automatic. See design/25-production-deployments.md §Layer 2.
 
-export { cacheControl, surrogateKey, surrogateControl, cdnCacheControl } from './headers';
+export { cacheControl, surrogateKey, surrogateControl, cdnCacheControl, cacheTag } from './headers';
 export type { CacheControlOptions, SurrogateControlOptions } from './headers';
 
 export { setCdnPurgeHandler, getCdnPurgeHandler } from './purge-store';
 export type { CdnPurgeHandler } from './purge-store';
 
 // Platform-specific purge handlers are at their own entry points:
-//   @timber-js/app/cdn/cloudflare → CloudflarePurge
-//   @timber-js/app/cdn/fastly     → FastlyPurge
+//   @timber-js/app/cdn/cloudflare         → CloudflarePurge (REST API, Enterprise)
+//   @timber-js/app/cdn/cloudflare-workers → WorkersCachePurge (ctx.cache, all plans)
+//   @timber-js/app/cdn/fastly             → FastlyPurge
 // Same pattern as @timber-js/app/cache/stores/* — keeps platform
 // dependencies out of the main CDN import.

package/src/cdn/workers-cache-purge.ts

@@ -0,0 +1,30 @@
+/**
+ * Cloudflare Workers Cache purge handler — purges by cache tag via
+ * ctx.cache.purge() on the ExecutionContext.
+ *
+ * Available on ALL Cloudflare plans (no Enterprise requirement).
+ * No API token needed — uses the Workers runtime's built-in cache API.
+ *
+ * Auto-wired by the Cloudflare adapter when no user-configured CDN
+ * purge handler is set. Uses the Workers Cache ALS bridge to access
+ * ctx.cache from within the request context.
+ */
+
+import type { CdnPurgeHandler } from './purge-store';
+import { getWorkersCachePurgeCtx } from '../server/workers-cache-bridge.js';
+
+export class WorkersCachePurge implements CdnPurgeHandler {
+  async purgeTags(tags: string[]): Promise<void> {
+    if (tags.length === 0) return;
+
+    const ctx = getWorkersCachePurgeCtx();
+    if (!ctx) {
+      throw new Error(
+        'WorkersCachePurge: no Workers Cache context available. ' +
+          'This handler can only be used within a Cloudflare Workers request context.'
+      );
+    }
+
+    await ctx.purge({ tags });
+  }
+}

package/src/plugin-context.ts

@@ -137,6 +137,14 @@ export interface PluginContext {
    * the generated `cache.component(...)` call was picked up.
    */
   prerenderSugarPages?: Set<string>;
+  /**
+   * Component ID → built chunk file name for prebuilt-declaring modules
+   * that are only reachable via dynamic imports (import.meta.glob, lazy
+   * routes). The capture pass imports these chunks to trigger
+   * cache.component() registration before rendering. Populated during
+   * RSC generateBundle alongside routePrebuiltComponents.
+   */
+  prebuiltLazyChunks?: Map<string, string>;
   /** Post-build prebuilt capture summary (populated by timber-prebuilt, consumed by build-report). */
   captureSummary?: CaptureSummary;
 }

package/src/plugins/prebuilt-capture.ts

@@ -83,6 +83,7 @@ export function createPrebuiltArtifactWriter(prebuiltDir: string): PrebuiltArtif
       await writeFileAtomic(path, entry.bytes);
 
       manifest[entry.componentId] ??= { entries: {} };
+      if (entry.paramIndependent) manifest[entry.componentId].paramIndependent = true;
       manifest[entry.componentId].entries[entry.cacheKey] = {
         params: entry.params,
         file: relativeFile,
@@ -186,6 +187,7 @@ export async function runPrebuiltCapture(ctx: PluginContext): Promise<CaptureSum
     callSiteProps: ctx.prebuiltCallSiteProps
       ? Object.fromEntries(ctx.prebuiltCallSiteProps)
       : undefined,
+    lazyChunks: ctx.prebuiltLazyChunks ? Object.fromEntries(ctx.prebuiltLazyChunks) : undefined,
     onEntry: (entry) => writer.write(entry),
   });
 

package/src/plugins/prebuilt.ts

@@ -582,7 +582,13 @@ export function timberPrebuilt(ctx: PluginContext): Plugin {
      * SHARED components work — a component imported by several routes is
      * captured under every importing route's param combos.
      */
-    generateBundle() {
+    generateBundle(
+      _options?: unknown,
+      bundle?: Record<
+        string,
+        { type: string; modules?: Record<string, unknown>; fileName?: string }
+      >
+    ) {
       if (ctx.dev) return;
       if (this?.environment?.name !== 'rsc') return;
       // Recompute attribution from scratch every build — a stale map from
@@ -605,6 +611,27 @@ export function timberPrebuilt(ctx: PluginContext): Plugin {
       }
       if (routeComponents.size > 0) {
         ctx.routePrebuiltComponents = routeComponents;
+
+        // Build a map of componentId → chunk fileName for declaring
+        // modules that aren't route files themselves (behind dynamic
+        // imports like import.meta.glob). The capture pass imports these
+        // chunks to trigger cache.component() registration.
+        if (bundle) {
+          const routeFileSet = new Set(routeComponents.keys());
+          const lazyChunks = new Map<string, string>();
+          for (const [moduleId, componentIds] of moduleComponents) {
+            if (routeFileSet.has(moduleId)) continue;
+            for (const [, chunk] of Object.entries(bundle)) {
+              if (chunk.type !== 'chunk' || !chunk.modules) continue;
+              if (moduleId in chunk.modules) {
+                for (const id of componentIds) lazyChunks.set(id, chunk.fileName!);
+                break;
+              }
+            }
+          }
+          if (lazyChunks.size > 0) ctx.prebuiltLazyChunks = lazyChunks;
+        }
+
         // Cross-module call-site prop detection (TIM-1142): walk the
         // module graph from each route file and scan ALL reachable modules
         // for JSX usages of prebuilt components — not just the route files

package/src/plugins/shims.ts

@@ -64,6 +64,7 @@ export const SUBPATH_SRC_MAP: Record<string, string> = {
 
   'cdn': 'cdn/index.ts',
   'cdn/cloudflare': 'cdn/cloudflare-purge.ts',
+  'cdn/cloudflare-workers': 'cdn/workers-cache-purge.ts',
   'cdn/fastly': 'cdn/fastly-purge.ts',
 
   'adapters/cloudflare': 'adapters/cloudflare.ts',

package/src/server/als-registry.ts

@@ -219,3 +219,17 @@ export type WaitUntilFn = (promise: Promise<unknown>) => void;
 
 /** @internal — import via waituntil-bridge.ts public API */
 export const waitUntilAls = getOrCreateAls<WaitUntilFn>(Symbol.for('timber:wait-until-als'));
+
+// ─── Workers Cache Purge Bridge ─────────────────────────────────────────
+// Used by: workers-cache-bridge.ts (runWithWorkersCachePurge())
+// Design doc: design/06-caching.md, design/25-production-deployments.md
+
+/** Workers Cache purge function from Cloudflare ExecutionContext.cache. */
+export interface WorkersCachePurgeCtx {
+  purge(opts: { tags: string[] }): Promise<void>;
+}
+
+/** @internal — import via workers-cache-bridge.ts public API */
+export const workersCachePurgeAls = getOrCreateAls<WorkersCachePurgeCtx>(
+  Symbol.for('timber:workers-cache-purge-als')
+);

package/src/server/prebuilt/payload-source.ts

@@ -34,6 +34,8 @@ export interface PrebuiltManifestEntry {
 export interface PrebuiltManifest {
   [componentId: string]: {
     entries: Record<string, PrebuiltManifestEntry>;
+    /** When true, the component does not read segment params — the cache key uses `{}`. */
+    paramIndependent?: boolean;
   };
 }
 
@@ -147,6 +149,13 @@ export async function ensureManifestLoaded(): Promise<void> {
  * Look up a manifest entry (metadata only, no payload read).
  * Used by the overlay to check seed existence and freshness.
  */
+export async function isParamIndependent(componentId: string): Promise<boolean> {
+  if (source === null) return false;
+  manifestPromise ??= loadManifestWithTimeout(source);
+  const manifest = await manifestPromise;
+  return manifest?.[componentId]?.paramIndependent === true;
+}
+
 export async function getManifestEntry(
   componentId: string,
   cacheKey: string

package/src/server/prebuilt/synthetic-store.ts

@@ -68,6 +68,8 @@ export interface BuildTimeStoreHandle {
    * render ⇒ the entry must fail as a hard build error.
    */
   violations: BuildTimeContextError[];
+  /** Whether the component read `segmentParams` during the render. */
+  segmentParamsRead: boolean;
 }
 
 /**
@@ -80,6 +82,11 @@ export function createBuildTimeStore(
   segmentParams: Record<string, string | string[]>
 ): BuildTimeStoreHandle {
   const violations: BuildTimeContextError[] = [];
+  const handle: BuildTimeStoreHandle = {
+    store: null!,
+    violations,
+    segmentParamsRead: false,
+  };
   const store: RequestContextStore = {
     headers: new Headers(),
     originalHeaders: new Headers(),
@@ -100,9 +107,15 @@ export function createBuildTimeStore(
     headers: { get: () => violate('headers()') },
     parsedCookies: { get: () => violate('cookies()') },
     searchParams: { get: () => violate('searchParams') },
-    // Reached by cookie mutators (set/delete/clear) via assertMutable —
-    // its only reader — before any other store field.
     mutableContext: { get: () => violate('cookies()') },
+    segmentParams: {
+      get: () => {
+        handle.segmentParamsRead = true;
+        return segmentParams;
+      },
+      enumerable: true,
+    },
   });
-  return { store, violations };
+  handle.store = store;
+  return handle;
 }