@mandujs/core 0.54.12 → 0.54.13

package/src/deploy/inference/context.ts

@@ -78,8 +78,8 @@ export async function buildDeployInferenceContext(
     // still gets the manifest metadata and falls back to defaults.
   }
 
-  const imports = extractImports(source);
-  const dependencyClasses = classifySourceDependencies(source, imports);
+  const imports = extractImports(source);
+  const dependencyClasses = classifySourceDependencies(source, imports);
   // Mandu's manifest patterns use `:param` / `*` (path-pattern style),
   // not bracket-form. Detect both shapes so the heuristic doesn't
   // misclassify dynamic routes as prerenderable. Examples:
@@ -139,82 +139,82 @@ export function extractImports(source: string): string[] {
 }
 
 /** Map import specifiers to coarse dependency classes. */
-export function classifyImports(imports: string[]): ReadonlySet<DependencyClass> {
-  const classes = new Set<DependencyClass>();
-  for (const spec of imports) {
+export function classifyImports(imports: string[]): ReadonlySet<DependencyClass> {
+  const classes = new Set<DependencyClass>();
+  for (const spec of imports) {
     const cls = classifyOne(spec);
     if (cls) classes.add(cls);
   }
   if (classes.size === 0) classes.add("fetch-only");
-  return classes;
-}
-
-/**
- * Classify dependency signals that do not always appear as bare imports.
- *
- * Dogfooding surfaced Mandu API routes importing project-local
- * `src/server/infra/db` helpers and using `db` tagged templates. Those
- * are server-only even when the bare imports look edge-safe.
- */
-export function classifySourceDependencies(
-  source: string,
-  imports: string[] = extractImports(source),
-): ReadonlySet<DependencyClass> {
-  const classes = new Set<DependencyClass>(classifyImports(imports));
-  if (classes.size === 1 && classes.has("fetch-only")) {
-    classes.delete("fetch-only");
-  }
-
-  const allImports = extractAllImportSpecifiers(source);
-  if (allImports.some(isServerInfraImport)) {
-    classes.add("db");
-  }
-
-  if (/\bBun\.SQL\b|\bBun\.sqlite\b/i.test(source)) {
-    classes.add("bun-native");
-  }
-
-  if (
-    /(?:^|[^\w$])db\s*`/.test(source) ||
-    /\bctx\.deps\.db\b/.test(source) ||
-    /\bdb\.(?:query|execute|select|insert|update|delete)\b/.test(source)
-  ) {
-    classes.add("db");
-  }
-
-  if (classes.size === 0) {
-    classes.add("fetch-only");
-  }
-  return classes;
-}
-
-function extractAllImportSpecifiers(source: string): string[] {
-  const out = new Set<string>();
-  const staticImport = /^\s*import\b[^"']*?["']([^"']+)["']/gm;
-  const dynamicImport = /\bimport\(\s*["']([^"']+)["']\s*\)/g;
-  for (const re of [staticImport, dynamicImport]) {
-    let m: RegExpExecArray | null;
-    while ((m = re.exec(source)) !== null) {
-      out.add(m[1]!);
-    }
-  }
-  return [...out].sort();
-}
-
-function isServerInfraImport(specifier: string): boolean {
-  const s = specifier.replace(/\\/g, "/").toLowerCase();
-  return (
-    s === "@/server/infra" ||
-    s.startsWith("@/server/infra/") ||
-    s === "src/server/infra" ||
-    s.startsWith("src/server/infra/") ||
-    s.endsWith("/server/infra") ||
-    s.includes("/server/infra/")
-  );
-}
-
-function classifyOne(spec: string): DependencyClass | null {
-  const s = spec.toLowerCase();
+  return classes;
+}
+
+/**
+ * Classify dependency signals that do not always appear as bare imports.
+ *
+ * Dogfooding surfaced Mandu API routes importing project-local
+ * `src/server/infra/db` helpers and using `db` tagged templates. Those
+ * are server-only even when the bare imports look edge-safe.
+ */
+export function classifySourceDependencies(
+  source: string,
+  imports: string[] = extractImports(source),
+): ReadonlySet<DependencyClass> {
+  const classes = new Set<DependencyClass>(classifyImports(imports));
+  if (classes.size === 1 && classes.has("fetch-only")) {
+    classes.delete("fetch-only");
+  }
+
+  const allImports = extractAllImportSpecifiers(source);
+  if (allImports.some(isServerInfraImport)) {
+    classes.add("db");
+  }
+
+  if (/\bBun\.SQL\b|\bBun\.sqlite\b/i.test(source)) {
+    classes.add("bun-native");
+  }
+
+  if (
+    /(?:^|[^\w$])db\s*`/.test(source) ||
+    /\bctx\.deps\.db\b/.test(source) ||
+    /\bdb\.(?:query|execute|select|insert|update|delete)\b/.test(source)
+  ) {
+    classes.add("db");
+  }
+
+  if (classes.size === 0) {
+    classes.add("fetch-only");
+  }
+  return classes;
+}
+
+function extractAllImportSpecifiers(source: string): string[] {
+  const out = new Set<string>();
+  const staticImport = /^\s*import\b[^"']*?["']([^"']+)["']/gm;
+  const dynamicImport = /\bimport\(\s*["']([^"']+)["']\s*\)/g;
+  for (const re of [staticImport, dynamicImport]) {
+    let m: RegExpExecArray | null;
+    while ((m = re.exec(source)) !== null) {
+      out.add(m[1]!);
+    }
+  }
+  return [...out].sort();
+}
+
+function isServerInfraImport(specifier: string): boolean {
+  const s = specifier.replace(/\\/g, "/").toLowerCase();
+  return (
+    s === "@/server/infra" ||
+    s.startsWith("@/server/infra/") ||
+    s === "src/server/infra" ||
+    s.startsWith("src/server/infra/") ||
+    s.endsWith("/server/infra") ||
+    s.includes("/server/infra/")
+  );
+}
+
+function classifyOne(spec: string): DependencyClass | null {
+  const s = spec.toLowerCase();
   if (
     s === "bun:sqlite" ||
     s === "bun:ffi" ||
@@ -231,14 +231,14 @@ function classifyOne(spec: string): DependencyClass | null {
   if (s === "node:child_process" || s === "child_process" || s === "node:worker_threads" || s === "worker_threads") {
     return "node-child";
   }
-  if (
-    /^(postgres|pg|mysql2?|drizzle-orm(\/.*)?|@prisma\/client|prisma|mongodb|mongoose|@neondatabase\/.+|kysely|sqlite3|better-sqlite3|@planetscale\/.+)$/.test(s)
-  ) {
-    return "db";
-  }
-  if (s === "@mandujs/core/db" || s.startsWith("@mandujs/core/db/")) {
-    return "db";
-  }
+  if (
+    /^(postgres|pg|mysql2?|drizzle-orm(\/.*)?|@prisma\/client|prisma|mongodb|mongoose|@neondatabase\/.+|kysely|sqlite3|better-sqlite3|@planetscale\/.+)$/.test(s)
+  ) {
+    return "db";
+  }
+  if (s === "@mandujs/core/db" || s.startsWith("@mandujs/core/db/")) {
+    return "db";
+  }
   if (/^(@anthropic-ai\/sdk|openai|ai|@ai-sdk\/.+|@google\/generative-ai|cohere-ai)$/.test(s)) {
     return "ai-sdk";
   }

package/src/devtools/client/components/panel/islands-panel.tsx

@@ -183,28 +183,28 @@ export function IslandsPanel({ islands }: IslandsPanelProps): React.ReactElement
     );
   }, [islands]);
 
-  if (islands.length === 0) {
-    return (
-      <div style={styles.container}>
-        <div style={styles.emptyState}>
-          <p>
-            아직 hydration 이벤트가 없습니다.<br />
-            정적 상태는 mandu.runtime.status에서 확인하세요.
-          </p>
-        </div>
-      </div>
-    );
-  }
+  if (islands.length === 0) {
+    return (
+      <div style={styles.container}>
+        <div style={styles.emptyState}>
+          <p>
+            아직 hydration 이벤트가 없습니다.<br />
+            정적 상태는 mandu.runtime.status에서 확인하세요.
+          </p>
+        </div>
+      </div>
+    );
+  }
 
   return (
     <div style={styles.container}>
       {/* Header Stats */}
       <div style={styles.header}>
         <div style={styles.stats}>
-          <div style={styles.stat}>
-            <span>Mounts:</span>
-            <span style={styles.statValue}>{stats.total}</span>
-          </div>
+          <div style={styles.stat}>
+            <span>Mounts:</span>
+            <span style={styles.statValue}>{stats.total}</span>
+          </div>
           <div style={styles.stat}>
             <span>Ready</span>
             <span style={styles.statValue}>{stats.hydrated}</span>

package/src/devtools/client/components/panel/panel-container.tsx

@@ -28,7 +28,7 @@ export interface PanelContainerProps {
 
 export const TABS: TabDefinition[] = [
   { id: 'errors', label: 'Issues', icon: 'ERR', testId: testIds.tabErrors },
-  { id: 'islands', label: 'Client Mounts', icon: 'HYD', testId: testIds.tabIslands },
+  { id: 'islands', label: 'Client Mounts', icon: 'HYD', testId: testIds.tabIslands },
   { id: 'network', label: 'Network', icon: 'NET', testId: testIds.tabNetwork },
   { id: 'guard', label: 'Guard', icon: 'GRD', testId: testIds.tabGuard },
   { id: 'preview', label: 'Changes', icon: 'CHG', testId: testIds.tabPreview },

package/src/error/formatter.ts

@@ -24,11 +24,16 @@ export function formatErrorResponse(error: ManduError, options: FormatOptions =
     code: error.code,
     message: error.message,
     summary: error.summary,
+    cause: error.summary,
     fix: error.fix,
+    filePath: error.fix.file,
+    solution: error.fix.suggestion,
   };
 
   if (error.route) {
     response.route = error.route;
+    response.routeId = error.route.id;
+    response.routePattern = error.route.pattern;
   }
 
   // 개발 모드에서만 디버그 정보 포함
@@ -65,6 +70,7 @@ export function formatErrorForConsole(error: ManduError, options: FormatOptions
   } else {
     lines.push(`  → ${error.summary}`);
   }
+  lines.push(`  Cause: ${error.summary}`);
 
   // 수정 안내
   lines.push("");
@@ -75,11 +81,14 @@ export function formatErrorForConsole(error: ManduError, options: FormatOptions
     lines.push(`  Fix: ${error.fix.file}${error.fix.line ? `:${error.fix.line}` : ""}`);
     lines.push(`       ${error.fix.suggestion}`);
   }
+  lines.push(`  File: ${error.fix.file}${error.fix.line ? `:${error.fix.line}` : ""}`);
+  lines.push(`  Solution: ${error.fix.suggestion}`);
 
   // 라우트 컨텍스트
   if (error.route) {
     lines.push("");
-    lines.push(`  Route: ${error.route.id} (${error.route.pattern})`);
+    lines.push(`  Route ID: ${error.route.id}`);
+    lines.push(`  Route: ${error.route.pattern}`);
   }
 
   // 디버그 정보 (개발 모드)

package/src/experimental/index.ts

@@ -0,0 +1,10 @@
+export * as a11y from "../a11y";
+export * as agent from "../agent";
+export * as brain from "../brain";
+export * as deploy from "../deploy";
+export * as design from "../design";
+export * as desktop from "../desktop";
+export * as devtools from "../devtools";
+export * as diagnose from "../diagnose";
+export * as kitchen from "../kitchen";
+export * as scheduler from "../scheduler";

package/src/filling/context.ts

@@ -628,23 +628,23 @@ export class ManduContext {
     return this.withCookies(new Response(null, { status: 204 }));
   }
 
-  /** 400 Bad Request, or custom 4xx/5xx error with ctx.error(status, message). */
-  error(message: string, details?: unknown): Response;
-  error(status: number, message: string, details?: unknown): Response;
-  error(
-    statusOrMessage: number | string,
-    messageOrDetails?: string | unknown,
-    maybeDetails?: unknown
-  ): Response {
-    if (typeof statusOrMessage === "number") {
-      const status = Number.isInteger(statusOrMessage) && statusOrMessage >= 400 && statusOrMessage <= 599
-        ? statusOrMessage
-        : 400;
-      const message = typeof messageOrDetails === "string" ? messageOrDetails : "Error";
-      return this.json({ status: "error", message, details: maybeDetails }, status);
-    }
-    return this.json({ status: "error", message: statusOrMessage, details: messageOrDetails }, 400);
-  }
+  /** 400 Bad Request, or custom 4xx/5xx error with ctx.error(status, message). */
+  error(message: string, details?: unknown): Response;
+  error(status: number, message: string, details?: unknown): Response;
+  error(
+    statusOrMessage: number | string,
+    messageOrDetails?: string | unknown,
+    maybeDetails?: unknown
+  ): Response {
+    if (typeof statusOrMessage === "number") {
+      const status = Number.isInteger(statusOrMessage) && statusOrMessage >= 400 && statusOrMessage <= 599
+        ? statusOrMessage
+        : 400;
+      const message = typeof messageOrDetails === "string" ? messageOrDetails : "Error";
+      return this.json({ status: "error", message, details: maybeDetails }, status);
+    }
+    return this.json({ status: "error", message: statusOrMessage, details: messageOrDetails }, 400);
+  }
 
   /** 401 Unauthorized */
   unauthorized(message: string = "Unauthorized"): Response {

package/src/filling/filling.ts

@@ -62,9 +62,17 @@ export interface MiddlewarePlugin {
  * `redirect(url)` helper for the common case; throwing a `Response` is
  * also accepted (Remix idiom).
  */
+export type LoaderResult<T = unknown> = T | Response;
+
 export type Loader<T = unknown> = (
   ctx: ManduContext
-) => T | Response | Promise<T | Response>;
+) => LoaderResult<T> | Promise<LoaderResult<T>>;
+
+/**
+ * Page-level SSR data reader. Prefer this name in public docs when the
+ * distinction from mutation actions or schema contracts matters.
+ */
+export type RouteDataLoader<T = unknown> = Loader<T>;
 
 /** Loader 실행 옵션 */
 export interface LoaderOptions<T = unknown> {
@@ -105,6 +113,19 @@ export class LoaderTimeoutError extends Error {
 /** Action handler type — named mutation handler */
 export type ActionHandler = (ctx: ManduContext) => Response | Promise<Response>;
 
+/**
+ * Named mutation/interaction handler. Alias of `ActionHandler`, exported so
+ * docs and generated examples can name the action responsibility directly.
+ */
+export type MutationAction = ActionHandler;
+
+/**
+ * Executable route pipeline: handlers, loader, actions, middleware, cache,
+ * render mode, and deploy intent. This is intentionally separate from the
+ * API schema contract.
+ */
+export type RouteFilling<TLoaderData = unknown> = ManduFilling<TLoaderData>;
+
 interface FillingConfig<TLoaderData = unknown> {
   handlers: Map<HttpMethod, Handler>;
   actions: Map<string, ActionHandler>;

package/src/filling/index.ts

@@ -7,7 +7,21 @@
 export { ManduContext, ValidationError, CookieManager } from "./context";
 export type { CookieOptions } from "./context";
 export { ManduFilling, ManduFillingFactory, LoaderTimeoutError } from "./filling";
-export type { Handler, Guard, ActionHandler, HttpMethod, Loader, LoaderOptions, LoaderCacheOptions, RenderMode, MiddlewarePlugin } from "./filling";
+export type {
+  Handler,
+  Guard,
+  ActionHandler,
+  MutationAction,
+  HttpMethod,
+  Loader,
+  RouteDataLoader,
+  LoaderResult,
+  LoaderOptions,
+  LoaderCacheOptions,
+  RenderMode,
+  MiddlewarePlugin,
+  RouteFilling,
+} from "./filling";
 export { createCookieSessionStorage, Session } from "./session";
 export type { SessionStorage, SessionData, CookieSessionOptions } from "./session";
 export { wrapBunWebSocket } from "./ws";

package/src/generator/generate.ts

@@ -99,25 +99,25 @@ export interface GeneratedMap {
   frameworkPaths: string[];
 }
 
-async function ensureDir(dirPath: string): Promise<void> {
-  try {
-    await fs.mkdir(dirPath, { recursive: true });
-  } catch  {
-    // ignore if exists
-  }
-}
-
-function touchGenerateStamp(rootDir: string): void {
-  const stampDir = path.join(rootDir, ".mandu");
-  if (!fsSync.existsSync(stampDir)) {
-    fsSync.mkdirSync(stampDir, { recursive: true });
-  }
-  fsSync.writeFileSync(path.join(stampDir, "generate.stamp"), Date.now().toString());
-}
-
-async function getExistingFiles(dir: string): Promise<string[]> {
-  try {
-    const files = await fs.readdir(dir);
+async function ensureDir(dirPath: string): Promise<void> {
+  try {
+    await fs.mkdir(dirPath, { recursive: true });
+  } catch  {
+    // ignore if exists
+  }
+}
+
+function touchGenerateStamp(rootDir: string): void {
+  const stampDir = path.join(rootDir, ".mandu");
+  if (!fsSync.existsSync(stampDir)) {
+    fsSync.mkdirSync(stampDir, { recursive: true });
+  }
+  fsSync.writeFileSync(path.join(stampDir, "generate.stamp"), Date.now().toString());
+}
+
+async function getExistingFiles(dir: string): Promise<string[]> {
+  try {
+    const files = await fs.readdir(dir);
     return files.filter((f) => f.endsWith(".route.ts") || f.endsWith(".route.tsx"));
   } catch {
     return [];
@@ -146,10 +146,10 @@ export async function generateRoutes(
     warnings: [],
   };
 
-  // Suppress watcher during generation to avoid false positives
-  const watcher = getWatcher();
-  watcher?.suppress();
-  touchGenerateStamp(rootDir);
+  // Suppress watcher during generation to avoid false positives
+  const watcher = getWatcher();
+  watcher?.suppress();
+  touchGenerateStamp(rootDir);
 
   const generatedPaths = resolveGeneratedPaths(rootDir);
   const serverRoutesDir = generatedPaths.serverRoutesDir;
@@ -363,10 +363,10 @@ export async function generateRoutes(
   const mapPath = path.join(mapDir, "generated.map.json");
   await Bun.write(mapPath, JSON.stringify(generatedMap, null, 2));
 
-  // Cross-process timestamp: watcher skips warnings if generate finished recently
-  touchGenerateStamp(rootDir);
-  // Resume watcher after the stamp is visible.
-  watcher?.resume();
-
-  return result;
-}
+  // Cross-process timestamp: watcher skips warnings if generate finished recently
+  touchGenerateStamp(rootDir);
+  // Resume watcher after the stamp is visible.
+  watcher?.resume();
+
+  return result;
+}

package/src/generator/index.ts

@@ -1,3 +1,3 @@
-export * from "./generate";
-export * from "./templates";
-export * from "./contract-glue";
+export * from "./generate";
+export * from "./templates";
+export * from "./contract-glue";