` and enqueues those paths
* for prerendering. Doc sites that ship code examples (`
* <Link href="/path" />
`) previously leaked those
* illustrative URLs into the render queue, producing spurious
* `.mandu/static/path/index.html` files.
*
* The engine strips ``, ``, fenced markdown, and inline
* code spans before scanning. It also applies a small default
* denylist of placeholder paths (`/path`, `/example`, `/your-*`,
* etc.). Use this block to extend or replace the denylist for your
* project.
*/
/**
* Phase 18.φ — bundle-size budget. Declaring any field turns on
* framework-level size-ceiling enforcement during `mandu build`.
*
* - `maxRawBytes` : per-island raw-byte cap.
* - `maxGzBytes` : per-island gzip-byte cap.
* - `maxTotalRawBytes` : project-wide raw cap (islands + shared).
* - `maxTotalGzBytes` : project-wide gzip cap.
* - `perIsland` : per-island overrides, additive per axis.
* `{ home: { gz: 50_000 } }` tightens only
* `home`'s gzip and leaves its raw cap at
* the global `maxRawBytes`.
* - `mode` : `'warning'` (default) prints a table and
* continues; `'error'` exits non-zero.
*
* Declaring the empty block `budget: {}` is interpreted as "I know
* about budgets" and auto-applies a 250 KB gzip per-island ceiling
* (matches Next.js `largePageDataBytes` + Astro rules of thumb).
* Omitting the block entirely is the zero-overhead opt-out.
*
* CLI override: `mandu build --no-budget` skips enforcement for a
* single run regardless of config.
*
* @see `docs/architect/bundle-budget.md`
* @see `@mandujs/core/bundler/budget`
*/
budget?: {
maxRawBytes?: number;
maxGzBytes?: number;
maxTotalRawBytes?: number;
maxTotalGzBytes?: number;
perIsland?: Record;
mode?: "error" | "warning";
};
crawl?: {
/**
* Extra pathnames or simple globs (`*`) to exclude when crawling.
* Merged with the built-in default denylist unless
* {@link replaceDefaultExclude} is `true`.
*/
exclude?: string[];
/**
* When `true`, `exclude` replaces the built-in denylist entirely.
* Default `false`.
*/
replaceDefaultExclude?: boolean;
/**
* Issue #219 — file extensions treated as non-HTML assets. When
* a discovered href's pathname ends with one of these, the
* crawler skips it instead of enqueuing it for prerender.
*
* Example: `
` used to make the engine render
* the asset URL as HTML and overwrite the real `.webp` on disk.
* The default set covers common image / font / document /
* media / text-asset extensions.
*
* Entries may be written with or without a leading dot
* (`"webp"` and `".webp"` are equivalent). Matching is
* case-insensitive; query strings and hash fragments are
* stripped before comparison.
*
* Merged with the built-in default set unless
* {@link replaceDefaultAssetExtensions} is `true`.
*/
assetExtensions?: string[];
/**
* When `true`, `assetExtensions` replaces the built-in set
* entirely. Default `false`.
*/
replaceDefaultAssetExtensions?: boolean;
};
};
dev?: {
hmr?: boolean;
watchDirs?: string[];
/** Observability SQLite 영구 저장 (기본: true) */
observability?: boolean;
/**
* Issue #191 — Dev-only `_devtools.js` (~1.15 MB React dev runtime +
* Mandu Kitchen panel) injection override.
*
* - `true` → force inject on every page (SSR-only projects that
* still want the Kitchen panel in dev).
* - `false` → force skip on every page (Kitchen-off dev loop).
* - `undefined` → default. Inject iff the page's bundle manifest
* has at least one island. Pure-SSR pages download
* zero devtools bytes.
*
* Production builds never emit `_devtools.js`, so this flag is
* a no-op in prod regardless of value.
*/
devtools?: boolean;
/**
* Issue #196 — Auto-run `scripts/prebuild-*.ts` before `mandu dev`
* boots, and re-run them when files under `contentDir` change in
* watch mode.
*
* - `true` → always run discovered prebuild scripts, regardless
* of whether `content/` exists (useful for projects
* that ship generators that write outside `content/`).
* - `false` → never auto-run. User stays responsible for the
* chain (`bun scripts/prebuild-*.ts && mandu dev`).
* - `undefined` → default. Auto-enabled iff the project has a
* `content/` directory OR at least one
* `scripts/prebuild-*.ts`. Silent no-op otherwise.
*
* See `@mandujs/core/content/prebuild` for the discovery + execution
* contract.
*/
autoPrebuild?: boolean;
/**
* Issue #196 — Directory whose changes trigger a watch-mode
* prebuild re-run. Defaults to `"content"`. Ignored when
* `autoPrebuild === false`. Relative to project root.
*/
contentDir?: string;
/**
* Issue #203 — Per-script wall-clock timeout for prebuild scripts
* (milliseconds). Default: `120_000` (2 minutes), matching the MCP
* `runCommand()` convention (#136). Override for projects that ship
* slow seed generators (e.g. large docs indexers, image pipelines).
*
* Precedence at runtime, highest first:
* 1. `MANDU_PREBUILD_TIMEOUT_MS` env var — useful for one-off CI
* overrides without committing to the config.
* 2. This field (`dev.prebuildTimeoutMs`).
* 3. Default 120_000 ms.
*
* When the timeout fires, `runPrebuildScripts` throws a
* `PrebuildTimeoutError` whose message names the failing script path,
* the limit, AND the two override paths — so the user does not need
* to re-read this comment to recover.
*/
prebuildTimeoutMs?: number;
/**
* Phase 18.α — Dev-only full-screen error overlay (Next.js / Astro
* style). When `true` (default) Mandu injects a ~10 KB inline
* `
