@mandujs/core 0.54.11 → 0.54.13

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";