) {
- 'use cache'
- const cookieValue = await cookiePromise
- await cachedDelay([__filename, cookieValue])
- return cookieValue
-}
-
-async function RuntimePrefetchable() {
- await cookies() // Guard from static prerender
-
- const cookieValue = await publicCache(
- cookies().then(c => c.get('testCookie')?.value ?? null)
- )
- return Cookie: {cookieValue}
-}
-
-// Pattern: Pass cookie Promise to public cache
-// This allows public cache while still accessing cookies!
-```
-
----
-
-## 13. What Gets Included in Runtime Prefetch
-
-### Test-Driven Inclusion Rules
-
-**Test Source**: `test/e2e/app-dir/segment-cache/prefetch-runtime/prefetch-runtime.test.ts`
-
-#### Rule 1: Includes All Public Caches
-
-```typescript
-// Always included in runtime prefetch:
-async function PublicCached() {
- 'use cache'
- cacheLife('hours') // Any duration
- return Content
-}
-```
-
-#### Rule 2: Includes Private Caches (if stale >= 30s)
-
-```typescript
-// Test lines 752-829:
-
-// ✅ INCLUDED in runtime prefetch:
-async function IncludedPrivate() {
- 'use cache: private'
- cacheLife('seconds') // stale = 30s (exactly at threshold)
- return Cached
-}
-
-// ❌ EXCLUDED from runtime prefetch:
-async function ExcludedPrivate() {
- 'use cache: private'
- cacheLife({ stale: 20, revalidate: 100, expire: 200 })
- return Not cached
-}
-```
-
-#### Rule 3: Includes params/searchParams/cookies/headers
-
-```typescript
-// Test lines 45-580:
-
-// These are ALL included in runtime prefetch:
-const { id } = await params
-const { q } = await searchParams
-const cookie = (await cookies()).get("name")
-const header = (await headers()).get("user-agent")
-
-// Test assertion:
-// - Prefetch response includes: "Param: 123"
-// - Prefetch response includes: "Search param: 456"
-// - Prefetch response includes: "Cookie: initialValue"
-// - Prefetch response includes: "Header: present"
-```
-
-#### Rule 4: EXCLUDES Uncached IO
-
-```typescript
-// Test lines 45-153:
-
-async function Dynamic() {
- await uncachedIO() // Simulates DB query, external API, etc.
- await connection()
- return Dynamic content
-}
-
-// Test assertion:
-// - Prefetch response: block: 'reject' for "Dynamic content"
-// - Navigation: Dynamic content streams in after
-```
-
----
-
-## 14. Stale Time Thresholds (30s Rule)
-
-### The Magic Numbers from Tests
-
-**Test Source**: `test/e2e/app-dir/segment-cache/prefetch-runtime/prefetch-runtime.test.ts` (lines 831-1030)
-
-```
-RUNTIME_PREFETCH_DYNAMIC_STALE = 30 seconds
-DYNAMIC_EXPIRE = 5 minutes (300 seconds)
-```
-
-### Test Pattern Matrix:
-
-```typescript
-// Pattern 1: Long stale, short expire
-async function Example1() {
- 'use cache'
- cacheLife({
- stale: 60, // >= 30s ✅
- revalidate: 120,
- expire: 180 // < 5min
- })
- return Content
-}
-
-// Static prefetch: ❌ NO (expire < 5min)
-// Runtime prefetch: ✅ YES (stale >= 30s)
-
-// Pattern 2: Short stale, long expire
-async function Example2() {
- 'use cache'
- cacheLife({
- stale: 10, // < 30s ❌
- revalidate: 300,
- expire: 600 // >= 5min
- })
- return Content
-}
-
-// Static prefetch: ✅ YES (expire >= 5min)
-// Runtime prefetch: ❌ NO (stale < 30s)
-
-// Pattern 3: Both long
-async function Example3() {
- 'use cache'
- cacheLife({
- stale: 60, // >= 30s ✅
- revalidate: 300,
- expire: 600 // >= 5min ✅
- })
- return Content
-}
-
-// Static prefetch: ✅ YES
-// Runtime prefetch: ✅ YES
-
-// Pattern 4: cacheLife('seconds') - SPECIAL CASE
-async function Example4() {
- 'use cache'
- cacheLife('seconds')
- // Despite name, stale is set to 30s to meet threshold!
- return Content
-}
-
-// Static prefetch: ❌ NO (expire = 1s < 5min)
-// Runtime prefetch: ✅ YES (stale = 30s exactly)
-```
-
----
diff --git a/src/resources/(cache-components)/06-request-apis.md b/src/resources/(cache-components)/06-request-apis.md
deleted file mode 100644
index 2d12893..0000000
--- a/src/resources/(cache-components)/06-request-apis.md
+++ /dev/null
@@ -1,272 +0,0 @@
-## 18. Async params Semantics
-
-### Test Pattern: generateStaticParams Integration
-
-**Test Source**: `test/e2e/app-dir/cache-components/cache-components.params.test.ts`
-
-```typescript
-// File: app/params/semantics/[lowcard]/[highcard]/layout.tsx
-
-export async function generateStaticParams() {
- return [
- { highcard: 'build' }, // Only 'build' is pre-generated
- ]
-}
-
-export default function HighcardLayout({ children }: { children: React.ReactNode }) {
- return (
- loading highcard children}>
- {children}
-
- {getSentinelValue()}
- )
-}
-
-// File: app/params/semantics/[lowcard]/[highcard]/layout-access/server/page.tsx
-
-export default async function Page({
- params
-}: {
- params: Promise<{ lowcard: string; highcard: string }>
-}) {
- return (
- <>
- lowcard: {(await params).lowcard}
- highcard: {(await params).highcard}
- {getSentinelValue()}
-
- )
-}
-
-// TEST BEHAVIOR:
-
-// Route: /params/semantics/one/build/layout-access/server
-// (highcard='build' is in generateStaticParams)
-// Production:
-// - #layout: 'at buildtime' ✅
-// - #highcard: 'at buildtime' ✅
-// - #page: 'at buildtime' ✅
-// - #param-lowcard: 'one'
-// - #param-highcard: 'build'
-// - #highcard-fallback: NOT SHOWN (no dynamic hole)
-
-// Route: /params/semantics/one/run/layout-access/server
-// (highcard='run' is NOT in generateStaticParams)
-// Production:
-// - #layout: 'at buildtime' ✅ (static shell)
-// - #highcard: 'at buildtime' ✅ (static shell)
-// - #highcard-fallback: 'loading highcard children' ✅ (SHOWN!)
-// - #page: 'at runtime' ✅ (dynamic hole!)
-// - #param-lowcard: 'one'
-// - #param-highcard: 'run'
-```
-
-### Critical Insight from Tests:
-
-**When you await params:**
-
-- If param value in generateStaticParams → Renders at build time
-- If param value NOT in generateStaticParams → Creates dynamic hole (PPR)
-- Suspense boundary shows fallback for dynamic params
-- Static parts (layout) render at build time as shell
-
----
-
-## 19. searchParams Behavior
-
-### Test Pattern: searchParams in Runtime Prefetch
-
-**Test Source**: `test/e2e/app-dir/segment-cache/prefetch-runtime/prefetch-runtime.test.ts` (lines 275-377)
-
-```typescript
-// EXACT TEST PATTERN:
-
-// File: app/in-page/search-params/page.tsx
-
-export const unstable_prefetch = {
- mode: 'runtime',
- samples: [{ searchParams: { searchParam: '123' } }],
-}
-
-export default async function Page({
- searchParams
-}: {
- searchParams: Promise<{ searchParam?: string }>
-}) {
- const { searchParam } = await searchParams
-
- return (
- <>
- Search param: {searchParam}
- Loading...}>
-
-
-
- )
-}
-
-async function Dynamic() {
- await connection()
- return Dynamic content
-}
-
-// TEST BEHAVIOR:
-
-// 1. Link to ?searchParam=123 becomes visible
-// Prefetch includes: "Search param: 123" ✅
-// Prefetch excludes: "Dynamic content" ❌
-
-// 2. Link to ?searchParam=456 becomes visible
-// Prefetch includes: "Search param: 456" ✅ (different sample!)
-// Prefetch excludes: "Dynamic content" ❌
-
-// 3. Navigate to ?searchParam=123
-// Immediate show: "Search param: 123" (from prefetch)
-// Then streams: "Dynamic content"
-
-// 4. Navigate to ?searchParam=456
-// Immediate show: "Search param: 456" (from prefetch)
-// Then streams: "Dynamic content"
-```
-
-### Private Cache with searchParams
-
-**Test Source**: `test/e2e/app-dir/use-cache-private/app/search-params/page.tsx`
-
-```typescript
-export default async function Page({
- searchParams,
-}: {
- searchParams: Promise<{ [key: string]: string }>
-}) {
- 'use cache: private'
-
- const { q } = await searchParams
-
- return (
-
- Query: {q}
-
- )
-}
-
-// TEST BEHAVIOR:
-// - ?q=foo → displays 'foo'
-// - Navigate to ?q=bar → displays 'bar'
-// - Each searchParams value gets its own cache entry
-```
-
----
-
-## 21. connection() Deep Dive
-
-### ⭐ When to Use connection()
-
-**Official Purpose** ([Next.js Docs](https://nextjs.org/docs/app/api-reference/functions/connection)):
-> The `connection()` function allows you to indicate rendering should wait for an incoming user request before continuing.
->
-> It's useful when a component doesn't use Dynamic APIs, but you want it to be dynamically rendered at runtime and not statically rendered at build time. This usually occurs when you access external information that you intentionally want to change the result of a render, such as `Math.random()` or `new Date()`.
-
-**Use connection() to explicitly mark a component as dynamic:**
-
-```typescript
-import { connection } from 'next/server'
-
-export default async function Page() {
- await connection() // ✅ Marks component as dynamic
-
- const currentYear = new Date().getFullYear()
- const random = Math.random()
-
- return {currentYear} - {random}
-}
-```
-
-**Key Points:**
-- `connection()` replaces `unstable_noStore` (stabilized in Next.js 15)
-- Only necessary when dynamic rendering is required and common Dynamic APIs (`headers()`, `cookies()`, `draftMode()`) are NOT used
-- Perfect for `Math.random()`, `Date.now()`, or any time-based/random rendering
-
-### ❌ Anti-Pattern: Empty headers()/cookies() Calls
-
-**WRONG - Do NOT do this:**
-
-```typescript
-import { headers } from 'next/headers'
-
-export default async function Footer() {
- await headers() // ❌ BAD - Using as side effect just to mark dynamic
-
- const currentYear = new Date().getFullYear()
- return
-}
-```
-
-**Why it's bad:**
-- Not semantically correct (you're not using headers)
-- Misleading to other developers
-- Future readers think you need headers data
-
-**RIGHT - Use connection() instead:**
-
-```typescript
-import { connection } from 'next/server'
-
-export default async function Footer() {
- await connection() // ✅ GOOD - Clear intent to mark as dynamic
-
- const currentYear = new Date().getFullYear()
- return
-}
-```
-
-### Test Pattern: Math.random() and Date.now()
-
-**Test Source**: `test/development/app-dir/cache-components-warnings/` (disabled but shows pattern)
-
-```typescript
-// Pattern: Math.random() without connection()
-
-export default async function Page() {
- const random = Math.random() // ⚠️ Warning in dev
- return {random}
-}
-
-// Dev warning:
-// 'Route "/path" used `Math.random()` outside of `"use cache"`
-// and without explicitly calling `await connection()` beforehand.'
-
-// ✅ CORRECT PATTERN:
-
-export default async function Page() {
- await connection()
- const random = Math.random() // ✅ No warning
- return {random}
-}
-```
-
-### Test Pattern: connection() Creates Dynamic Hole
-
-**Test Source**: `test/e2e/app-dir/segment-cache/prefetch-runtime/` (Dynamic components)
-
-```typescript
-async function Dynamic() {
- await connection()
- // Everything after connection() is excluded from prefetch
- return Dynamic content
-}
-
-export default function Page() {
- return (
- Loading...}>
-
-
- )
-}
-
-// Runtime prefetch test assertion:
-// - Prefetch response: block: 'reject' for "Dynamic content"
-// - Navigation: "Dynamic content" streams in
-```
-
----
diff --git a/src/resources/(cache-components)/07-cache-invalidation.md b/src/resources/(cache-components)/07-cache-invalidation.md
deleted file mode 100644
index 1549891..0000000
--- a/src/resources/(cache-components)/07-cache-invalidation.md
+++ /dev/null
@@ -1,110 +0,0 @@
-## 22. updateTag() - Read-Your-Own-Writes
-
-### Test Pattern: Immediate Cache Invalidation
-
-**Test Source**: `test/e2e/app-dir/use-cache/app/(partially-static)/cache-tag/buttons.tsx` + test assertions
-
-```typescript
-"use server"
-
-import { updateTag, revalidateTag } from "next/cache"
-
-export async function revalidateA() {
- revalidateTag("a")
-}
-
-export async function revalidateB() {
- revalidateTag("b")
-}
-
-export async function revalidateC() {
- revalidateTag("c")
-}
-
-// Page uses getCachedWithTag({ tag: 'a' }) and ({ tag: 'b' })
-// Both also use cacheTag(tag, 'c')
-
-// TEST BEHAVIOR (lines 223-315):
-// Initial: valueA = 0.123, valueB = 0.456
-//
-// Call revalidateA():
-// - valueA changes to 0.789
-// - valueB stays 0.456
-//
-// Call revalidateC():
-// - valueA changes (has tag 'c')
-// - valueB changes (has tag 'c')
-//
-// This proves: Tags work as expected for granular invalidation
-```
-
----
-
-## 23. revalidateTag(tag, profile) - New Signature
-
-### Test Pattern: Profile Parameter
-
-**Test Source**: Documentation and recent commits show new signature
-
-```typescript
-'use server'
-
-import { revalidateTag } from 'next/cache'
-
-// ✅ NEW RECOMMENDED PATTERN:
-export async function updateProductList() {
- await db.products.update(...)
- revalidateTag('products', 'max') // Stale-while-revalidate
-}
-
-// ❌ DEPRECATED (but still works):
-export async function oldPattern() {
- revalidateTag('products') // No profile = legacy behavior
-}
-
-// Test from use-cache.test.ts (lines 223-314):
-// - Revalidate specific tags
-// - Cache updates happen async
-// - Stale content served while revalidating (with 'max' profile)
-```
-
----
-
-## 24. refresh() - Client Router Cache
-
-### Test Pattern: In-Place Page Update
-
-**Test Source**: `test/e2e/app-dir/use-cache/app/(partially-static)/form/page.tsx`
-
-```typescript
-import { updateTag, cacheTag } from 'next/cache'
-
-async function refresh() {
- 'use server'
- updateTag('home')
-}
-
-export default async function Page() {
- 'use cache'
- cacheTag('home')
-
- return (
-
- )
-}
-
-// ACTUAL TEST BEHAVIOR:
-// 1. Initial load: timestamp = "2024-01-01T12:00:00.000Z"
-// 2. Click refresh button:
-// - updateTag('home') called (invalidates cache)
-// - Page re-renders with new timestamp
-// 3. New timestamp displayed (cache was invalidated)
-//
-// NOTE: This uses updateTag(), not revalidateTag()
-// refresh() here is the server action name, not the next/cache function
-```
-
----
diff --git a/src/resources/(cache-components)/08-advanced-patterns.md b/src/resources/(cache-components)/08-advanced-patterns.md
deleted file mode 100644
index e01380c..0000000
--- a/src/resources/(cache-components)/08-advanced-patterns.md
+++ /dev/null
@@ -1,156 +0,0 @@
-## 26. cacheLife() Profiles and Custom Config
-
-### Test Pattern: Custom Profile
-
-**Test Source**: `test/e2e/app-dir/use-cache/next.config.js` + test assertions
-
-```typescript
-// next.config.js
-const nextConfig = {
- experimental: {
- cacheComponents: true,
- cacheLife: {
- frequent: {
- stale: 19,
- revalidate: 100,
- expire: 300,
- },
- },
- },
-}
-
-// page.tsx
-'use cache'
-import { cacheLife } from 'next/cache'
-
-export default async function Page() {
- cacheLife('frequent') // Uses custom profile
- return Page
-}
-
-// TEST ASSERTIONS (lines 508-567):
-// - routes['/cache-life'].initialRevalidateSeconds === 100
-// - routes['/cache-life'].initialExpireSeconds === 300
-// - cacheLifeMeta.headers['x-nextjs-stale-time'] === '19'
-// - Cache-Control header: 's-maxage=100, stale-while-revalidate=200'
-// (SWR = expire - revalidate = 300 - 100 = 200)
-```
-
----
-
-## 28. Draft Mode Behavior
-
-### Test Pattern: Draft Mode Bypasses Cache
-
-**Test Source**: `test/e2e/app-dir/use-cache/use-cache.test.ts` (lines 778-928)
-
-```typescript
-async function getCachedValue() {
- 'use cache'
- return Date.now()
-}
-
-export default async function Page() {
- const value = await getCachedValue()
-
- return (
- <>
- {value}
-
-
- )
-}
-
-// TEST BEHAVIOR:
-
-// Draft mode DISABLED:
-// - Load page: value = 123
-// - Refresh: value = 123 (cached!)
-
-// Enable draft mode (via Server Action):
-// - Load page: value = 456 (NEW! cache bypassed)
-// - Refresh: value = 789 (NEW! cache bypassed)
-
-// Disable draft mode:
-// - Load page: value = 123 (original cached value restored!)
-
-// Key insight: Draft mode completely bypasses cache
-```
-
----
-
-## 29. generateStaticParams Integration
-
-### Test Pattern: Cardinality-Based Prerendering
-
-**Test Source**: `test/e2e/app-dir/cache-components/app/params/semantics/[lowcard]/[highcard]/layout.tsx`
-
-```typescript
-// Low cardinality param (few values)
-export async function generateStaticParams() {
- return [{ lowcard: "one" }, { lowcard: "two" }]
-}
-
-// High cardinality param (many values)
-export async function generateStaticParams() {
- return [
- { highcard: "build" },
- // Only one value - others generated on-demand
- ]
-}
-
-// COMBINED ROUTE: /params/semantics/[lowcard]/[highcard]
-
-// URL: /params/semantics/one/build
-// - lowcard='one' in generateStaticParams ✅
-// - highcard='build' in generateStaticParams ✅
-// Result: FULLY PRERENDERED at build time
-
-// URL: /params/semantics/one/run
-// - lowcard='one' in generateStaticParams ✅
-// - highcard='run' NOT in generateStaticParams ❌
-// Result: PARTIAL PRERENDER
-// - Layout (lowcard='one'): buildtime shell
-// - Suspense fallback: SHOWN
-// - Page (highcard='run'): runtime hole
-
-// URL: /params/semantics/three/run
-// - lowcard='three' NOT in generateStaticParams ❌
-// - highcard='run' NOT in generateStaticParams ❌
-// Result: FULLY DYNAMIC (no shell)
-```
-
----
-
-## 30. Math.random() and Date.now() Patterns
-
-### Test Pattern: connection() Guards Random Values
-
-**Test Source**: `test/e2e/app-dir/cache-components/app/random/` fixtures
-
-```typescript
-// ❌ WRONG: Random without connection()
-export default async function Page() {
- const rand = Math.random() // Causes issues in prerender
- return {rand}
-}
-
-// Dev warning:
-// "Route used `Math.random()` outside of `'use cache'`
-// and without explicitly calling `await connection()` beforehand."
-
-// ✅ CORRECT: connection() before random
-export default async function Page() {
- await connection()
- const rand = Math.random() // Safe now
- return {rand}
-}
-
-// ✅ ALSO CORRECT: Random inside 'use cache'
-async function getCachedRandom() {
- 'use cache'
- return Math.random() // Cached, same value per cache key
-}
-```
-
----
diff --git a/src/resources/(cache-components)/09-build-behavior.md b/src/resources/(cache-components)/09-build-behavior.md
deleted file mode 100644
index 0a27694..0000000
--- a/src/resources/(cache-components)/09-build-behavior.md
+++ /dev/null
@@ -1,152 +0,0 @@
-## 31. What Gets Prerendered
-
-### Test Evidence: Prerender Manifest
-
-**Test Source**: `test/e2e/app-dir/use-cache/use-cache.test.ts` (lines 444-506)
-
-```typescript
-// With cacheComponents: true, the prerender-manifest.json includes:
-
-const prerenderedRoutes = [
- "/_not-found",
- "/a123", // generateStaticParams entry
- "/api", // Route handler with 'use cache'
- "/b456", // generateStaticParams entry
- "/cache-fetch", // Page with 'use cache'
- "/cache-life", // Page with 'use cache' + cacheLife
- "/cache-tag", // Page with 'use cache' + cacheTag
- "/form", // Page with 'use cache'
- // ... more routes
-]
-
-// Routes NOT prerendered:
-// - Pages with cookies()/headers() and no 'use cache'
-// - Pages with searchParams and no 'use cache'
-// - Pages with dynamic params not in generateStaticParams
-// - Pages with connection() calls
-```
-
-### Shell Completeness Test
-
-```typescript
-// Test checks if HTML ends with
-
-// COMPLETE SHELL (fully prerendered):
-// .next/server/app/cache-life.html ends with "