@mandujs/core 0.52.0 → 0.53.1

package/src/openapi/openapi.test.ts

@@ -16,9 +16,34 @@ import {
 } from "./generator";
 import type { OpenAPIDocument } from "./generator";
 import type { RoutesManifest } from "../spec/schema";
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+async function linkWorkspaceNodeModules(rootDir: string): Promise<void> {
+  const workspaceNodeModules = path.join(process.cwd(), "node_modules");
+  const fixtureNodeModules = path.join(rootDir, "node_modules");
+
+  try {
+    await fs.access(workspaceNodeModules);
+  } catch {
+    return;
+  }
+
+  try {
+    await fs.symlink(
+      workspaceNodeModules,
+      fixtureNodeModules,
+      process.platform === "win32" ? "junction" : "dir"
+    );
+  } catch (error) {
+    try {
+      await fs.access(fixtureNodeModules);
+    } catch {
+      throw error;
+    }
+  }
+}
 
 describe("zodToOpenAPISchema", () => {
   describe("primitive types", () => {
@@ -321,9 +346,10 @@ describe("Real-world contract conversion", () => {
  * exercise the full build pipeline (generate + write + read) without
  * faking the dynamic import path.
  */
-async function buildFixture(): Promise<{ rootDir: string; manifest: RoutesManifest; cleanup: () => Promise<void> }> {
-  const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-"));
-  const contractPath = "contracts/users.contract.ts";
+async function buildFixture(): Promise<{ rootDir: string; manifest: RoutesManifest; cleanup: () => Promise<void> }> {
+  const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-"));
+  await linkWorkspaceNodeModules(rootDir);
+  const contractPath = "contracts/users.contract.ts";
   const contractAbs = path.join(rootDir, contractPath);
   await fs.mkdir(path.dirname(contractAbs), { recursive: true });
   await fs.writeFile(
@@ -534,8 +560,9 @@ async function buildSharedSchemaFixture(opts: {
   manifest: RoutesManifest;
   cleanup: () => Promise<void>;
 }> {
-  const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-hoist-"));
-  const [nameA, nameB] = opts.contractNames ?? ["users", "admins"];
+  const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-hoist-"));
+  await linkWorkspaceNodeModules(rootDir);
+  const [nameA, nameB] = opts.contractNames ?? ["users", "admins"];
   const bodyB =
     opts.secondBody ??
     `z.object({ name: z.string().min(2), email: z.string().email() })`;
@@ -642,9 +669,10 @@ describe("hoistSharedSchemas", () => {
   });
 
   test("one-off schema stays inline (no hoist, no components.schemas entry for it)", async () => {
-    const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-oneoff-"));
-    try {
-      await fs.mkdir(path.join(rootDir, "contracts"), { recursive: true });
+    const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-oneoff-"));
+    try {
+      await linkWorkspaceNodeModules(rootDir);
+      await fs.mkdir(path.join(rootDir, "contracts"), { recursive: true });
       await fs.writeFile(
         path.join(rootDir, "contracts/solo.contract.ts"),
         `import { z } from "zod";
@@ -816,9 +844,10 @@ export default {
   });
 
   test("enum / primitive schemas are never hoisted", async () => {
-    const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-enum-"));
-    try {
-      await fs.mkdir(path.join(rootDir, "contracts"), { recursive: true });
+    const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), "mandu-openapi-enum-"));
+    try {
+      await linkWorkspaceNodeModules(rootDir);
+      await fs.mkdir(path.join(rootDir, "contracts"), { recursive: true });
       const contractBody = `import { z } from "zod";
 export default {
   name: NAME,

package/src/perf/user-marks.ts

@@ -62,7 +62,7 @@
  */
 
 import { isPerfEnabled } from "./index";
-import { getTracer, getActiveSpan, runWithSpan, type Span } from "../observability/tracing";
+import { getTracer, runWithSpan, type Span } from "../observability/tracing";
 
 // ─── Types ──────────────────────────────────────────────────────────────
 

package/src/plugins/registry.ts

@@ -11,7 +11,6 @@ import type {
   Plugin,
   PluginApi,
   PluginCategory,
-  PluginMeta,
   GuardPresetPlugin,
   BuildPlugin,
   LoggerTransportPlugin,
@@ -22,7 +21,7 @@ import type {
 /**
  * 플러그인 등록 상태
  */
-type PluginState = "pending" | "loaded" | "error" | "unloaded";
+type _PluginState = "pending" | "loaded" | "error" | "unloaded";
 
 /**
  * 등록된 플러그인 정보 (discriminated union by state)

package/src/plugins/types.ts

@@ -7,7 +7,7 @@
  * - 라이프사이클 훅
  */
 
-import type { z, ZodSchema } from "zod";
+import type { ZodSchema } from "zod";
 
 /**
  * 플러그인 카테고리

package/src/resource/ddl/diff.ts

@@ -62,7 +62,6 @@ import type { ParsedResource } from "../parser";
 import type {
   Change,
   DdlDefault,
-  DdlFieldDef,
   DdlIndex,
   DdlResource,
   Snapshot,

package/src/resource/generator.ts

@@ -74,7 +74,7 @@ async function fileExists(filePath: string): Promise<boolean> {
 async function ensureDir(dirPath: string): Promise<void> {
   try {
     await fs.mkdir(dirPath, { recursive: true });
-  } catch (error) {
+  } catch  {
     // Ignore if exists
   }
 }

package/src/resource/generators/contract.ts

@@ -14,7 +14,7 @@ import { getPluralName, getEnabledEndpoints } from "../schema";
 export function generateResourceContract(definition: ResourceDefinition): string {
   const resourceName = definition.name;
   const pascalName = toPascalCase(resourceName);
-  const pluralName = getPluralName(definition);
+  const _pluralName = getPluralName(definition);
   const endpoints = getEnabledEndpoints(definition);
 
   // Generate schema definitions

package/src/resource/schema.ts

@@ -1,3 +1,4 @@
+import type * as __ManduDdlPersistenceTypesTypes0 from "./ddl/persistence-types";
 /**
  * Resource Schema Definition
  * Resource-Centric Architecture의 핵심 스키마 정의
@@ -100,7 +101,7 @@ export interface ResourceOptions {
    * });
    * ```
    */
-  persistence?: import("./ddl/persistence-types").ExtendedResourcePersistence;
+  persistence?: __ManduDdlPersistenceTypesTypes0.ExtendedResourcePersistence;
 }
 
 // ============================================

package/src/router/fs-routes.ts

@@ -451,12 +451,12 @@ export async function watchFSRoutes(
 
   return {
     close() {
-      if (debounceTimer) {
-        clearTimeout(debounceTimer);
-      }
-      routesWatcher.close();
-      specWatcher.close();
-    },
+      if (debounceTimer) {
+        clearTimeout(debounceTimer);
+      }
+      void routesWatcher.close();
+      void specWatcher.close();
+    },
     async rescan() {
       return triggerRescan();
     },

package/src/router/fs-scanner.ts

@@ -228,7 +228,7 @@ export class FSScanner {
    */
   private async createRouteConfigs(
     files: ScannedFile[],
-    rootDir: string
+    _rootDir: string
   ): Promise<{ routes: FSRouteConfig[]; routeErrors: ScanError[] }> {
     const routes: FSRouteConfig[] = [];
     const routeErrors: ScanError[] = [];

package/src/runtime/env.ts

@@ -93,7 +93,7 @@ function parseEnvFile(content: string): Record<string, string> {
 /**
  * 파일이 존재하는지 확인
  */
-async function fileExists(filePath: string): Promise<boolean> {
+async function _fileExists(filePath: string): Promise<boolean> {
   try {
     const file = Bun.file(filePath);
     return await file.exists();

package/src/runtime/image-handler.ts

@@ -1,3 +1,4 @@
+import type * as __ManduFsTypes0 from "fs";
 /**
  * Mandu Image Handler
  * /_mandu/image?url=...&w=...&q=... 엔드포인트
@@ -76,7 +77,7 @@ export async function handleImageRequest(
   // realpath로 symlink를 해석한 후 allowedBaseDir 내부인지 검증
   let resolvedPath: string;
   try {
-    const realFs = require("fs") as typeof import("fs");
+    const realFs = require("fs") as typeof __ManduFsTypes0;
     resolvedPath = realFs.realpathSync(filePath);
     const resolvedBase = realFs.realpathSync(allowedBaseDir);
     if (!resolvedPath.startsWith(resolvedBase + path.sep) && resolvedPath !== resolvedBase) {

package/src/runtime/middleware.ts

@@ -1,3 +1,4 @@
+import type * as __ManduFsTypes0 from "fs";
 /**
  * Mandu Global Middleware
  * 라우트 매칭 전에 실행되는 글로벌 미들웨어 시스템
@@ -227,7 +228,7 @@ export async function loadMiddleware(
 export function loadMiddlewareSync(
   rootDir: string
 ): { fn: MiddlewareFn; config: MiddlewareConfig | null } | null {
-  const fs = require("fs") as typeof import("fs");
+  const fs = require("fs") as typeof __ManduFsTypes0;
   const possiblePaths = [
     `${rootDir}/middleware.ts`,
     `${rootDir}/middleware.js`,

package/src/runtime/server.ts

@@ -1,30 +1,28 @@
-import type { Server, ServerWebSocket } from "bun";
+import type { BunFile, Server, ServerWebSocket } from "bun";
 import type { RoutesManifest, RouteSpec, HydrationConfig, StaticParamSetSchema } from "../spec/schema";
 import type { BundleManifest } from "../bundler/types";
 import type { ManduFilling, RenderMode } from "../filling/filling";
 import { ManduContext, CookieManager } from "../filling/context";
 import { Router } from "./router";
 import { renderSSR, renderStreamingResponse, resolveAsyncElement } from "./ssr";
-import {
-  resolveMetadata,
-  renderMetadata,
-  renderTitle,
-  type Metadata,
+import {
+  resolveMetadata,
+  renderMetadata,
+  renderTitle,
+  type Metadata,
   type MetadataItem,
-  type GenerateMetadata,
-} from "../seo";
-import { type ErrorFallbackProps } from "./boundary";
-import React, { type ReactNode } from "react";
+  type GenerateMetadata,
+} from "../seo";
+import { type ErrorFallbackProps } from "./boundary";
+import React from "react";
 import path from "path";
 import fs from "fs/promises";
 import { PORTS } from "../constants";
 import {
-  type CacheStore,
-  type CacheStoreStats,
-  type CacheLookupResult,
-  type CacheConfig,
-  MemoryCacheStore,
-  lookupCache,
+  type CacheStore,
+  type CacheStoreStats,
+  type CacheConfig,
+  lookupCache,
   createCacheEntry,
   createCachedResponse,
   computeCacheControl,
@@ -53,7 +51,12 @@ import {
 } from "./cors";
 import { validateImportPath } from "./security";
 import { KITCHEN_PREFIX, KitchenHandler, recordRequest } from "../kitchen/kitchen-handler";
-import { eventBus } from "../observability/event-bus";
+import {
+  eventBus,
+  type EventType,
+  type ObservabilityEvent,
+  type ObservabilitySeverity,
+} from "../observability/event-bus";
 import {
   HEAP_ENDPOINT,
   METRICS_ENDPOINT,
@@ -62,11 +65,12 @@ import {
   isObservabilityExposed,
   recordHttpRequest,
 } from "../observability/metrics";
-import {
-  handleOpenAPIRequest,
-  isOpenAPIEndpointEnabled,
-  resolveOpenAPIEndpointSettings,
-} from "./openapi-endpoint";
+import {
+  handleOpenAPIRequest,
+  isOpenAPIEndpointEnabled,
+  resolveOpenAPIEndpointSettings,
+  type OpenAPIEndpointSettings,
+} from "./openapi-endpoint";
 // Phase 18.ψ — user-facing perf marks dashboard append. We include a
 // `perf` block on the `/_mandu/heap` payload when the feature is active
 // so operators see a unified view (heap + caches + perf histogram).
@@ -77,8 +81,7 @@ import { collectPerfSnapshot } from "../perf/user-marks";
 // `startServer()`; `runWithSpan` is used at the absolute TOP of the
 // request handler so every downstream await (middleware, filling
 // loader, SSR render) inherits the active span via AsyncLocalStorage.
-import type {
-  Tracer} from "../observability/tracing";
+import type { Tracer } from "../observability/tracing";
 import {
   createTracerFromConfig,
   runWithSpan,
@@ -99,10 +102,10 @@ import type { Middleware } from "../middleware/define";
 // Phase 18.λ — scheduler wiring (statically imported so `startServer` stays
 // synchronous; the cost of unused code is trivial — `defineCron` is a thin
 // wrapper around `Bun.cron`).
-import { defineCron as schedulerDefineCron } from "../scheduler";
+import { defineCron as schedulerDefineCron, type CronDef, type CronRegistration } from "../scheduler";
 import { setActiveSchedulerRegistration } from "../middleware/scheduler-cron";
 import { createFetchHandler } from "./handler";
-import { wrapBunWebSocket, type WSUpgradeData } from "../filling/ws";
+import { wrapBunWebSocket, type WSHandlers, type WSUpgradeData } from "../filling/ws";
 import { handleImageRequest } from "./image-handler";
 import { extractShellHtml, createPPRResponse } from "./ppr";
 import { isRedirectResponse } from "./redirect";
@@ -110,12 +113,16 @@ import { isNotFoundResponse } from "./not-found";
 import { newId } from "../id";
 // Phase 18.κ — typed RPC dispatch (tRPC-like). See
 // `packages/core/src/contract/rpc.ts` + `docs/architect/typed-rpc.md`.
-import {
-  matchRpcPath,
-  dispatchRpc,
-  registerRpc,
-  clearRpcRegistry,
-} from "../contract/rpc";
+import {
+  matchRpcPath,
+  dispatchRpc,
+  registerRpc,
+  clearRpcRegistry,
+  type RpcDefinition,
+  type RpcProcedureRecord,
+} from "../contract/rpc";
+import type { GuardConfig } from "../guard/types";
+import type { ManduHooks, ManduPlugin } from "../plugins/hooks";
 import { handleMetadataRoute as dispatchMetadataRoute } from "../routes/metadata-routes";
 import {
   DEFAULT_PRERENDER_DIR,
@@ -419,7 +426,7 @@ export interface ServerOptions {
   /**
    * Guard config for Kitchen dev dashboard (dev mode only)
    */
-  guardConfig?: import("../guard/types").GuardConfig | null;
+  guardConfig?: GuardConfig | null;
   /**
    * SSR 캐시 설정 (ISR/SWR 용).
    *
@@ -575,8 +582,8 @@ export interface ServerOptions {
    * `options.middleware` so they run BEFORE user-declared layers. Both
    * fields are optional; omission is a zero-overhead passthrough.
    */
-  plugins?: readonly import("../plugins/hooks").ManduPlugin[];
-  configHooks?: Partial<import("../plugins/hooks").ManduHooks>;
+  plugins?: readonly ManduPlugin[];
+  configHooks?: Partial<ManduHooks>;
   /**
    * Phase 18.κ — tRPC-like typed RPC endpoints.
    *
@@ -589,7 +596,7 @@ export interface ServerOptions {
    * Typically threaded from `ManduConfig.rpc.endpoints`.
    */
   rpc?: {
-    endpoints?: Record<string, import("../contract/rpc").RpcDefinition<import("../contract/rpc").RpcProcedureRecord>>;
+    endpoints?: Record<string, RpcDefinition<RpcProcedureRecord>>;
   };
   /**
    * Phase 18.λ — declarative cron scheduler.
@@ -605,7 +612,7 @@ export interface ServerOptions {
    * Typically threaded from `ManduConfig.scheduler`.
    */
   scheduler?: {
-    jobs?: import("../scheduler").CronDef[];
+    jobs?: CronDef[];
     disabled?: boolean;
   };
   /**
@@ -816,7 +823,7 @@ export interface ServerRegistrySettings {
    * tracing is disabled (the hot path is branch-free). When set, every
    * request opens a root span via `tracer.startSpanFromRequest()`.
    */
-  tracer?: import("../observability/tracing").Tracer;
+  tracer?: Tracer;
   /**
    * Production OpenAPI endpoint — resolved from `ServerOptions.openapi`.
    * `undefined` means the endpoint is disabled (hot path branch-free).
@@ -824,7 +831,7 @@ export interface ServerRegistrySettings {
    * `<basePath>.json` / `<basePath>.yaml` short-circuits before route
    * dispatch to serve the cached spec body.
    */
-  openapi?: import("./openapi-endpoint").OpenAPIEndpointSettings;
+  openapi?: OpenAPIEndpointSettings;
   /**
    * Phase 18 — resolved prerender pass-through state. `undefined`
    * means the feature is disabled for this server instance.
@@ -910,7 +917,7 @@ export class ServerRegistry {
   /** Layout slot 파일 경로 캐시 (모듈 경로 → slot 경로 | null) */
   readonly layoutSlotPaths: Map<string, string | null> = new Map();
   /** WebSocket 핸들러 (라우트 ID → WSHandlers) */
-  readonly wsHandlers: Map<string, import("../filling/ws").WSHandlers> = new Map();
+  readonly wsHandlers: Map<string, WSHandlers> = new Map();
   /**
    * Metadata API 캐시 (#186)
    * - pageMetadata: routeId → page 모듈의 static `metadata` export
@@ -918,10 +925,10 @@ export class ServerRegistry {
    * - layoutMetadata: layout 모듈 경로 → static `metadata` export (null = 시도했지만 없음)
    * - layoutGenerateMetadata: layout 모듈 경로 → `generateMetadata` 함수
    */
-  readonly pageMetadata: Map<string, import("../seo").Metadata> = new Map();
-  readonly pageGenerateMetadata: Map<string, import("../seo").GenerateMetadata> = new Map();
-  readonly layoutMetadata: Map<string, import("../seo").Metadata | null> = new Map();
-  readonly layoutGenerateMetadata: Map<string, import("../seo").GenerateMetadata> = new Map();
+  readonly pageMetadata: Map<string, Metadata> = new Map();
+  readonly pageGenerateMetadata: Map<string, GenerateMetadata> = new Map();
+  readonly layoutMetadata: Map<string, Metadata | null> = new Map();
+  readonly layoutGenerateMetadata: Map<string, GenerateMetadata> = new Map();
   settings: ServerRegistrySettings = {
     isDev: false,
     rootDir: process.cwd(),
@@ -1270,7 +1277,7 @@ export function registerNotFoundHandler(handler: PageHandler): void {
   defaultRegistry.registerNotFoundHandler(handler);
 }
 
-export function registerWSHandler(routeId: string, handlers: import("../filling/ws").WSHandlers): void {
+export function registerWSHandler(routeId: string, handlers: WSHandlers): void {
   defaultRegistry.wsHandlers.set(routeId, handlers);
 }
 
@@ -1356,7 +1363,7 @@ function handleEventsStreamRequest(req: Request): Response {
   const filterSource = url.searchParams.get("source") || undefined;
   const filterTrace = url.searchParams.get("trace") || undefined;
 
-  const matches = (e: import("../observability/event-bus").ObservabilityEvent): boolean => {
+  const matches = (e: ObservabilityEvent): boolean => {
     if (filterType && e.type !== filterType) return false;
     if (filterSeverity && e.severity !== filterSeverity) return false;
     if (filterSource && e.source !== filterSource) return false;
@@ -1437,8 +1444,8 @@ function handleEventsRecentRequest(req: Request): Response {
   const events = eventBus.getRecent(
     count ? Number(count) : undefined,
     {
-      type: type as import("../observability/event-bus").EventType | undefined,
-      severity: severity as import("../observability/event-bus").ObservabilitySeverity | undefined,
+      type: type as EventType | undefined,
+      severity: severity as ObservabilitySeverity | undefined,
     },
   );
   const stats = eventBus.getStats(windowMs);
@@ -1544,7 +1551,7 @@ function evictEtagCacheIfNeeded(): void {
  */
 async function computeStrongEtag(
   filePath: string,
-  file: import("bun").BunFile,
+  file: BunFile,
 ): Promise<string> {
   const size = file.size;
   const mtime = file.lastModified;
@@ -4675,12 +4682,12 @@ export function startServer(manifest: RoutesManifest, options: ServerOptions = {
   }
   // ─── End Phase 18.ζ ────────────────────────────────────────────────────
 
-  // Kitchen dev dashboard (dev mode only)
-  if (isDev) {
-    const kitchen = new KitchenHandler({ rootDir, manifest, guardConfig });
-    kitchen.start();
-    registry.kitchen = kitchen;
-  }
+  // Kitchen dev dashboard (dev mode only)
+  if (isDev) {
+    const kitchen = new KitchenHandler({ rootDir, manifest, guardConfig });
+    void kitchen.start();
+    registry.kitchen = kitchen;
+  }
 
   const router = new Router(manifest.routes);
 
@@ -4862,7 +4869,7 @@ export function startServer(manifest: RoutesManifest, options: ServerOptions = {
   // other boot errors rather than aborting the server. `startServer` is
   // synchronous by contract, so we use the already-imported scheduler
   // module rather than `await import`.
-  let schedulerRegistration: import("../scheduler").CronRegistration | null = null;
+  let schedulerRegistration: CronRegistration | null = null;
   const jobDefs = schedulerOption?.jobs ?? [];
   const schedulerDisabled = schedulerOption?.disabled === true;
   if (jobDefs.length > 0 && !schedulerDisabled) {
@@ -4914,10 +4921,10 @@ export function startServer(manifest: RoutesManifest, options: ServerOptions = {
             console.error("[scheduler] shutdown error:", err);
           });
       }
-      server.stop();
-    },
-  };
-}
+      void server.stop();
+    },
+  };
+}
 
 // Clear registries (useful for testing) - deprecated, use clearDefaultRegistry()
 export function clearRegistry(): void {

package/src/runtime/ssr.ts

@@ -165,7 +165,7 @@ export interface SSROptions {
 
 let projectRenderToString: ((element: ReactElement) => string) | null | undefined;
 
-function loadProjectRenderToString(): ((element: ReactElement) => string) | null {
+function _loadProjectRenderToString(): ((element: ReactElement) => string) | null {
   if (projectRenderToString !== undefined) {
     return projectRenderToString;
   }
@@ -851,7 +851,7 @@ export function renderToHTML(element: ReactElement, options: SSROptions = {}): s
 function generateRouteScript(
   routeId: string,
   pattern: string,
-  serverData?: Record<string, unknown>
+  _serverData?: Record<string, unknown>
 ): string {
   const routeInfo = {
     id: routeId,
@@ -867,7 +867,7 @@ function generateRouteScript(
 /**
  * URL 패턴에서 파라미터 추출 (클라이언트에서 사용)
  */
-function extractParamsFromUrl(pattern: string): Record<string, string> {
+function extractParamsFromUrl(_pattern: string): Record<string, string> {
   // 서버에서는 실제 params를 전달받으므로 빈 객체 반환
   // 실제 params는 serverData나 별도 전달
   return {};

package/src/runtime/streaming-ssr.ts

@@ -80,10 +80,10 @@ export interface StreamingError {
 export interface StreamingMetrics {
   /** Shell ready까지 걸린 시간 (ms) */
   shellReadyTime: number;
-  /** All ready까지 걸린 시간 (ms) */
-  allReadyTime: number;
-  /** Deferred chunk 개수 */
-  deferredChunkCount: number;
+  /** All ready까지 걸린 시간 (ms) */
+  allReadyTime: number;
+  /** Deferred chunk 개수 */
+  deferredChunkCount: number;
   /** 에러 발생 여부 */
   hasError: boolean;
   /** 시작 시간 */
@@ -1001,9 +1001,9 @@ export async function renderToStream(
 
   // 메트릭 수집
   const metrics: StreamingMetrics = {
-    shellReadyTime: 0,
-    allReadyTime: 0,
-    deferredChunkCount: 0,
+    shellReadyTime: 0,
+    allReadyTime: 0,
+    deferredChunkCount: 0,
     hasError: false,
     startTime: Date.now(),
   };
@@ -1379,10 +1379,9 @@ export async function renderWithDeferredData(
   const encoder = new TextEncoder();
   const startTime = Date.now();
 
-  // 준비된 deferred 스크립트를 담을 배열 (mutable)
-  const readyScripts: string[] = [];
-  let deferredChunkCount = 0;
-  let allDeferredSettled = false;
+  // 준비된 deferred 스크립트를 담을 배열 (mutable)
+  const readyScripts: string[] = [];
+  let allDeferredSettled = false;
 
   // 1. Deferred promises 병렬 시작 (막지 않음!)
   const deferredEntries = Object.entries(deferredPromises);
@@ -1396,12 +1395,11 @@ export async function renderWithDeferredData(
             );
             const data = await Promise.race([promise, timeoutPromise]);
 
-            // 스크립트 생성 및 추가
-            const script = generateDeferredDataScript(routeId, key, data);
-            readyScripts.push(script);
-            deferredChunkCount++;
-
-            if (isDev) {
+            // 스크립트 생성 및 추가
+            const script = generateDeferredDataScript(routeId, key, data);
+            readyScripts.push(script);
+
+            if (isDev) {
               console.log(`[Mandu Streaming] Deferred ready: ${key} (${Date.now() - startTime}ms)`);
             }
           } catch (error) {
@@ -1475,22 +1473,22 @@ export async function renderWithDeferredData(
 
         // 최종 메트릭 보고 (injectedCount가 실제 메트릭)
         if (onMetrics && baseMetrics) {
-          onMetrics({
-            ...baseMetrics,
-            deferredChunkCount: injectedCount,
-            allReadyTime: Date.now() - startTime,
-          });
+          onMetrics({
+            ...baseMetrics,
+            deferredChunkCount: injectedCount,
+            allReadyTime: Date.now() - startTime,
+          });
         }
 
         controller.close();
       } catch (error) {
         controller.error(error);
       }
-    },
-    cancel() {
-      reader.cancel();
-    },
-  });
+    },
+    cancel() {
+      void reader.cancel();
+    },
+  });
 
   // Phase 7.2 R1 Agent C (H1): if the base stream produced a CSP
   // nonce during shell emission, forward the matching header on the

package/src/scheduler/validate.ts

@@ -159,7 +159,7 @@ export function validateTimezone(tz: string): void {
   }
   try {
     // `Intl.DateTimeFormat` throws `RangeError` for unknown zones.
-    new Intl.DateTimeFormat("en-US", { timeZone: tz });
+    Intl.DateTimeFormat("en-US", { timeZone: tz });
   } catch {
     throw new Error(
       `[@mandujs/core/scheduler] unknown IANA timezone "${tz}". ` +