feat(docs): document render caps and staticHandler option

- Add maxRenderIterations and maxOutputSize router options
- Add the staticHandler advanced option for custom backends
- Update template-limit responses from 500 to 400

Author: NeaByteLab

docs/getting-started/routes-configuration.md

@@ -8,7 +8,7 @@ Configure the Deserve routes directory to match the project structure.
 
 ## Router Options
 
-The `Router` constructor accepts configuration options. The common ones are `routesDir` for the route folder and `requestTimeoutMs` for a request timeout. Rendering, request limits, worker pools, and a custom error builder are all configurable too. Proxy trust through `trustProxy` and the worker pool live in [Client IP Resolution](/getting-started/server-configuration#client-ip-resolution) and [Worker Pool](/core-concepts/worker-pool).
+The `Router` constructor accepts one options object. The everyday pair is `routesDir` for the route folder and `requestTimeoutMs` for a request deadline. The sections below cover route loading, request size limits, template render limits, and the two advanced hooks `errorResponseBuilder` and `staticHandler`. Two related options live on their own pages, `trustProxy` under [Client IP Resolution](/getting-started/server-configuration#client-ip-resolution) and the `worker` pool under [Worker Pool](/core-concepts/worker-pool).
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -53,7 +53,7 @@ const router = new Router({
 
 ### `maxIterations`
 
-Maximum iterations allowed per <code v-pre>{{#each}}</code> block in DVE templates. The cap prevents event loop starvation from unbounded rendering. The default is `100_000`, and exceeding it makes the engine throw so the server responds with **500 Internal Server Error**.
+Maximum iterations allowed per <code v-pre>{{#each}}</code> block in DVE templates. The cap prevents event loop starvation from one unbounded loop. The default is `100_000`, and exceeding it makes the engine throw so the server responds with **400 Bad Request**.
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -67,6 +67,34 @@ const router = new Router({
 
 For datasets larger than the limit, use [`streamRender`](/rendering/streaming) instead, and see [Performance and Limits](/rendering/performance#iteration-limit) for how the cap behaves. For CPU-intensive rendering, consider offloading to a [worker pool](/core-concepts/worker-pool).
 
+### `maxRenderIterations`
+
+Maximum total <code v-pre>{{#each}}</code> body executions across one render, summed over every loop including nested ones. Where `maxIterations` guards a single loop, this guards the whole page. The default is `1_000_000`, and exceeding it responds with **400 Bad Request**.
+
+```typescript twoslash
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  routesDir: 'routes',
+  viewsDir: './views',
+  maxRenderIterations: 500_000
+})
+```
+
+### `maxOutputSize`
+
+Maximum total output characters produced by one render. The cap stops a small template from expanding into a huge response. The default is `5_000_000`, and exceeding it responds with **400 Bad Request**.
+
+```typescript twoslash
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  routesDir: 'routes',
+  viewsDir: './views',
+  maxOutputSize: 1_000_000
+})
+```
+
 ### `maxUrlLength`
 
 Maximum length of the request URL in characters. A longer URL is rejected with **414 URI Too Long** before any route runs. The default is `8192`:
@@ -123,6 +151,27 @@ const router = new Router({
 })
 ```
 
+### `staticHandler`
+
+Advanced option that replaces how static files are served. It receives the context, the [static options](/static-file/basic#static-file-options) for the matched route, and the URL path, then returns the `Response`. The default implementation already guards path traversal, so override it only for a custom backend such as object storage:
+
+```typescript twoslash
+import type { Context, ServeOptions } from '@neabyte/deserve'
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  routesDir: 'routes',
+  staticHandler: {
+    // Serve files from a custom backend
+    async serve(ctx: Context, options: ServeOptions, urlPath: string) {
+      return ctx.send.text(`requested ${urlPath}`)
+    }
+  }
+})
+```
+
+Register the static route itself with [`router.static()`](/static-file/basic), which this handler then fulfills.
+
 ## Supported File Extensions
 
 Deserve automatically detects and supports these file extensions:

docs/getting-started/server-configuration.md

@@ -84,7 +84,7 @@ Omit `requestTimeoutMs` for no timeout (default).
 
 ## Template Iteration Limit
 
-The `maxIterations` option caps the iterations per <code v-pre>{{#each}}</code> block in DVE templates, which prevents event loop starvation from unbounded rendering. The default is `100_000`:
+The `maxIterations` option caps the iterations per <code v-pre>{{#each}}</code> block in DVE templates, which prevents event loop starvation from one unbounded loop. The default is `100_000`:
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -96,7 +96,7 @@ const router = new Router({
 await router.serve(8000)
 ```
 
-If a template exceeds the limit, the server responds with **500 Internal Server Error**. The full rendering behavior lives in [Performance and Limits](/rendering/performance#iteration-limit). For large datasets, use [`streamRender`](/rendering/streaming) instead. For CPU-intensive rendering, consider offloading to a [worker pool](/core-concepts/worker-pool).
+If a template exceeds the limit, the server responds with **400 Bad Request**. Two companion caps, `maxRenderIterations` for the whole-page loop budget and `maxOutputSize` for total output characters, behave the same way and are listed in [Routes Configuration](/getting-started/routes-configuration#configuration-options). The full rendering behavior lives in [Performance and Limits](/rendering/performance#iteration-limit). For large datasets, use [`streamRender`](/rendering/streaming) instead. For CPU-intensive rendering, consider offloading to a [worker pool](/core-concepts/worker-pool).
 
 ## Client IP Resolution
 

docs/id/getting-started/routes-configuration.md

@@ -8,7 +8,7 @@ Konfigurasi direktori routes Deserve agar cocok dengan struktur proyek.
 
 ## Opsi Router
 
-Konstruktor `Router` menerima opsi konfigurasi. Yang umum adalah `routesDir` untuk folder rute dan `requestTimeoutMs` untuk timeout request. Rendering, batas request, worker pool, dan builder error khusus semuanya bisa dikonfigurasi juga. Kepercayaan proxy lewat `trustProxy` dan worker pool ada di [Resolusi IP Klien](/id/getting-started/server-configuration#resolusi-ip-klien) dan [Worker Pool](/id/core-concepts/worker-pool).
+Konstruktor `Router` menerima satu objek opsi. Pasangan sehari-hari adalah `routesDir` untuk folder rute dan `requestTimeoutMs` untuk tenggat request. Bagian di bawah membahas pemuatan rute, batas ukuran request, batas render template, dan dua kait lanjutan `errorResponseBuilder` serta `staticHandler`. Dua opsi terkait ada di halaman sendiri, `trustProxy` di [Resolusi IP Klien](/id/getting-started/server-configuration#resolusi-ip-klien) dan `worker` pool di [Worker Pool](/id/core-concepts/worker-pool).
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -53,7 +53,7 @@ const router = new Router({
 
 ### `maxIterations`
 
-Iterasi maksimum yang diizinkan per blok <code v-pre>{{#each}}</code> di template DVE. Batas ini mencegah event loop kelaparan akibat rendering tak terbatas. Default-nya `100_000`, dan melampauinya membuat mesin melempar sehingga server membalas dengan **500 Internal Server Error**.
+Iterasi maksimum yang diizinkan per blok <code v-pre>{{#each}}</code> di template DVE. Batas ini mencegah event loop kelaparan akibat satu perulangan tak terbatas. Default-nya `100_000`, dan melampauinya membuat mesin melempar sehingga server membalas dengan **400 Bad Request**.
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -67,6 +67,34 @@ const router = new Router({
 
 Untuk dataset lebih besar dari batas, gunakan [`streamRender`](/id/rendering/streaming), dan lihat [Performa dan Batas](/id/rendering/performance#batas-iterasi) untuk perilaku batasnya. Untuk rendering berat CPU, pertimbangkan mengalihkan ke [worker pool](/id/core-concepts/worker-pool).
 
+### `maxRenderIterations`
+
+Total maksimum eksekusi badan <code v-pre>{{#each}}</code> dalam satu render, dijumlahkan dari setiap perulangan termasuk yang bersarang. Jika `maxIterations` membatasi satu perulangan, opsi ini membatasi seluruh halaman. Default-nya `1_000_000`, dan melampauinya membalas dengan **400 Bad Request**.
+
+```typescript twoslash
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  routesDir: 'routes',
+  viewsDir: './views',
+  maxRenderIterations: 500_000
+})
+```
+
+### `maxOutputSize`
+
+Total maksimum karakter keluaran yang dihasilkan satu render. Batas ini mencegah template kecil membengkak menjadi response besar. Default-nya `5_000_000`, dan melampauinya membalas dengan **400 Bad Request**.
+
+```typescript twoslash
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  routesDir: 'routes',
+  viewsDir: './views',
+  maxOutputSize: 1_000_000
+})
+```
+
 ### `maxUrlLength`
 
 Panjang maksimum URL request dalam karakter. URL lebih panjang ditolak dengan **414 URI Too Long** sebelum rute mana pun berjalan. Default-nya `8192`:
@@ -95,7 +123,7 @@ const router = new Router({
 
 ### `errorResponseBuilder`
 
-Opsi lanjutan yang mengganti cara response error dibangun. Ia menerima context, status code, error, dan handler yang diatur dengan [`router.catch()`](/id/error-handling/object-details), lalu mengembalikan `Response` final. Kebanyakan aplikasi membentuk error lewat `router.catch()` saja, dibahas di [Penanganan Error](/id/error-handling/object-details):
+Opsi lanjutan yang mengganti cara response error dibangun. Opsi ini menerima context, status code, error, dan handler yang diatur dengan [`router.catch()`](/id/error-handling/object-details), lalu mengembalikan `Response` final. Kebanyakan aplikasi membentuk error lewat `router.catch()` saja, dibahas di [Penanganan Error](/id/error-handling/object-details):
 
 ```typescript twoslash
 import type { Context, ErrorMiddleware } from '@neabyte/deserve'
@@ -123,6 +151,27 @@ const router = new Router({
 })
 ```
 
+### `staticHandler`
+
+Opsi lanjutan yang mengganti cara berkas statis dilayani. Opsi ini menerima context, [opsi statis](/id/static-file/basic#opsi-static-file) untuk rute yang cocok, dan path URL, lalu mengembalikan `Response`. Implementasi default sudah menjaga path traversal, jadi ganti hanya untuk backend khusus seperti object storage:
+
+```typescript twoslash
+import type { Context, ServeOptions } from '@neabyte/deserve'
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  routesDir: 'routes',
+  staticHandler: {
+    // Layani berkas dari backend khusus
+    async serve(ctx: Context, options: ServeOptions, urlPath: string) {
+      return ctx.send.text(`requested ${urlPath}`)
+    }
+  }
+})
+```
+
+Daftarkan rute statisnya sendiri dengan [`router.static()`](/id/static-file/basic), yang lalu dipenuhi handler ini.
+
 ## Ekstensi Berkas yang Didukung
 
 Deserve otomatis mendeteksi dan mendukung ekstensi berkas ini:

docs/id/getting-started/server-configuration.md

@@ -84,7 +84,7 @@ Hilangkan `requestTimeoutMs` untuk tanpa timeout (default).
 
 ## Batas Iterasi Template
 
-Opsi `maxIterations` membatasi iterasi per blok <code v-pre>{{#each}}</code> di template DVE, yang mencegah event loop kelaparan akibat rendering tak terbatas. Default-nya `100_000`:
+Opsi `maxIterations` membatasi iterasi per blok <code v-pre>{{#each}}</code> di template DVE, yang mencegah event loop kelaparan akibat satu perulangan tak terbatas. Default-nya `100_000`:
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -96,7 +96,7 @@ const router = new Router({
 await router.serve(8000)
 ```
 
-Jika template melewati batas, server membalas dengan **500 Internal Server Error**. Perilaku rendering lengkap ada di [Performa dan Batas](/id/rendering/performance#batas-iterasi). Untuk dataset besar, gunakan [`streamRender`](/id/rendering/streaming). Untuk rendering berat CPU, pertimbangkan mengalihkan ke [worker pool](/id/core-concepts/worker-pool).
+Jika template melewati batas, server membalas dengan **400 Bad Request**. Dua batas pendamping, `maxRenderIterations` untuk anggaran perulangan seluruh halaman dan `maxOutputSize` untuk total karakter keluaran, berperilaku sama dan tercantum di [Konfigurasi Rute](/id/getting-started/routes-configuration#opsi-konfigurasi). Perilaku rendering lengkap ada di [Performa dan Batas](/id/rendering/performance#batas-iterasi). Untuk dataset besar, gunakan [`streamRender`](/id/rendering/streaming). Untuk rendering berat CPU, pertimbangkan mengalihkan ke [worker pool](/id/core-concepts/worker-pool).
 
 ## Resolusi IP Klien
 
@@ -158,14 +158,14 @@ ac.abort()
 
 ### Penanganan Sinyal Proses
 
-Tanpa `AbortSignal`, router mendengarkan `SIGINT` dan `SIGTERM` sendiri (hanya `SIGINT` di Windows) dan menguras dengan baik pada salah satunya. Tidak perlu perakitan sinyal manual:
+Tanpa `AbortSignal`, router mendengarkan `SIGINT` dan `SIGTERM` sendiri (hanya `SIGINT` di Windows) dan menyelesaikan request berjalan dengan rapi pada salah satunya. Tidak perlu menyiapkan sinyal secara manual:
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
 
 const router = new Router()
 
-// SIGINT dan SIGTERM menguras otomatis
+// SIGINT dan SIGTERM menuntaskan request otomatis
 await router.serve(8000, '127.0.0.1')
 ```
 
@@ -211,10 +211,10 @@ Lihat [Pelaporan Error](/id/middleware/observability/errors) untuk pola lengkapn
 Tujuannya adalah ketersediaan. Satu jalur kode yang cacat atau jahat semestinya tidak bisa membatalkan seluruh proses dan menolak layanan ke setiap rute dan service yang ditampungnya.
 
 - **Penyalahgunaan rantai pasok** - dependensi transitif yang memanggil `process.exit()` atau `Deno.exit()`, baik karena kecelakaan maupun sebagai serangan, tidak bisa lagi membuat server crash. Ini selaras dengan [OWASP A03:2025 Software Supply Chain Failures](https://owasp.org/Top10/2025/A03_2025-Software_Supply_Chain_Failures/) dan [CWE-1395](https://cwe.mitre.org/data/definitions/1395.html).
-- **Denial of service** - memblokir terminasi-diri menghapus saklar mati ketersediaan yang mudah, terkait [CWE-400](https://cwe.mitre.org/data/definitions/400.html) dan [CWE-730](https://cwe.mitre.org/data/definitions/730.html).
-- **Kesalahan tak tertangkap** - menjebak unhandled rejection dan uncaught error menjaga satu request buruk dari mengakhiri proses, terkait [CWE-248](https://cwe.mitre.org/data/definitions/248.html).
+- **Denial of service** - memblokir terminasi-diri menghapus tombol mematikan ketersediaan yang mudah, terkait [CWE-400](https://cwe.mitre.org/data/definitions/400.html) dan [CWE-730](https://cwe.mitre.org/data/definitions/730.html).
+- **Kesalahan tak tertangkap** - menjebak unhandled rejection dan uncaught error mencegah satu request buruk mengakhiri proses, terkait [CWE-248](https://cwe.mitre.org/data/definitions/248.html).
 
-Ini pertahanan upaya-terbaik, bukan sandbox. Ia menyisip ke titik masuk terminasi yang diketahui ketimbang mengisolasi kode tak tepercaya, jadi ia mengurangi blast radius tanpa mengklaim menghentikan setiap penyalahgunaan yang mungkin. Pasangkan dengan flag izin Deno dan tinjauan dependensi untuk jaminan lebih kuat. Pendekatan berlapis terhadap kesalahan dibahas di [Pertahanan Berlapis](/id/error-handling/defense-in-depth).
+Ini pertahanan upaya-terbaik, bukan sandbox. Pertahanan ini menyisip ke titik masuk terminasi yang diketahui ketimbang mengisolasi kode tak tepercaya, jadi ia memperkecil dampak kesalahan tanpa mengklaim menghentikan setiap penyalahgunaan yang mungkin. Pasangkan dengan flag izin Deno dan tinjauan dependensi untuk jaminan lebih kuat. Pendekatan berlapis terhadap kesalahan dibahas di [Pertahanan Berlapis](/id/error-handling/defense-in-depth).
 
 ## Pengujian Konfigurasi
 

docs/id/rendering/performance.md

@@ -4,7 +4,7 @@ description: "Karakteristik performa dan perilaku caching mesin template Deserve
 
 # Performa dan Batas
 
-Mesin DVE meng-cache template terkompilasi dan menjaga rendering dengan dua batas, jadi halaman besar tetap cepat dan template liar gagal dengan jelas alih-alih menggantung server.
+Mesin DVE meng-cache template terkompilasi dan mengawal rendering dengan dua batas, jadi halaman besar tetap cepat dan template yang tak terkendali gagal dengan jelas alih-alih menggantung server.
 
 ## Caching
 
@@ -27,7 +27,7 @@ Cache hanya mencakup kompilasi template, bukan data atau logika backend. Perubah
 
 ## Batas Iterasi
 
-Setiap blok <code v-pre>{{#each}}</code> dibatasi `100_000` iterasi secara default, yang mencegah event loop kelaparan akibat perulangan tak terbatas. Setel dengan `maxIterations`:
+Setiap blok <code v-pre>{{#each}}</code> dibatasi `100_000` iterasi secara default, yang mencegah event loop kelaparan akibat satu perulangan tak terbatas. Setel dengan `maxIterations`:
 
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
@@ -38,8 +38,24 @@ const router = new Router({
 })
 ```
 
-Ketika perulangan melewati batas, mesin melempar dan server membalas **500**. Untuk dataset sangat besar, gunakan [streaming rendering](/id/rendering/streaming). Untuk rendering berat CPU, alihkan ke [worker pool](/id/core-concepts/worker-pool).
+Ketika perulangan melewati batas, mesin melempar dan server membalas **400 Bad Request**. Untuk dataset sangat besar, gunakan [streaming rendering](/id/rendering/streaming). Untuk rendering berat CPU, alihkan ke [worker pool](/id/core-concepts/worker-pool).
+
+## Batas Anggaran Render
+
+Dua batas lain mengawal seluruh render, bukan hanya satu perulangan. `maxRenderIterations` menjumlahkan setiap eksekusi badan <code v-pre>{{#each}}</code> di seluruh halaman, termasuk perulangan bersarang, dan default-nya `1_000_000`. `maxOutputSize` membatasi total karakter yang boleh dihasilkan satu render dan default-nya `5_000_000`:
+
+```typescript twoslash
+import { Router } from '@neabyte/deserve'
+// ---cut---
+const router = new Router({
+  viewsDir: './views',
+  maxRenderIterations: 500_000,
+  maxOutputSize: 2_000_000
+})
+```
+
+Melewati salah satu batas membalas dengan **400 Bad Request**, status yang sama dengan batas per perulangan. Ketiganya diatur di [opsi Router](/id/getting-started/routes-configuration#opsi-konfigurasi).
 
 ## Batas Kedalaman Include
 
-Include template dibatasi 64 tingkat bersarang, jadi rantai include melingkar atau liar melempar error alih-alih berputar selamanya. Menjaga partial tetap dangkal aman jauh di dalam batas ini.
+Include template dibatasi 64 tingkat bersarang, jadi rantai include melingkar atau tak terkendali melempar error alih-alih berputar selamanya. Melewati batas ini membalas dengan **400 Bad Request**. Selama struktur partial tidak terlalu dalam, render tetap jauh di dalam batas ini.