@mandujs/core 0.54.7 → 0.54.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.54.7",
+  "version": "0.54.8",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",

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>
-            아직 등록된 Island가 없습니다.<br />
-            Island 컴포넌트를 사용하면 여기에 상태가 표시됩니다.
-          </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>전체:</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: 'Islands', icon: 'ISL', 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/generator/templates.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, test } from "bun:test";
+import type { RouteSpec } from "../spec/schema";
+import { generatePageComponent } from "./templates";
+
+describe("generatePageComponent", () => {
+  test("refuses to emit a placeholder for hydrating routes without a clientModule", () => {
+    const route: RouteSpec = {
+      id: "login",
+      kind: "page",
+      pattern: "/login",
+      module: "app/login/page.tsx",
+      componentModule: "app/login/page.tsx",
+      hydration: {
+        strategy: "full",
+        priority: "immediate",
+        preload: false,
+      },
+    };
+
+    expect(() => generatePageComponent(route)).toThrow("no clientModule");
+  });
+
+  test("still emits placeholders for static routes without hydration", () => {
+    const route: RouteSpec = {
+      id: "about",
+      kind: "page",
+      pattern: "/about",
+      module: "app/about/page.tsx",
+      componentModule: "app/about/page.tsx",
+    };
+
+    expect(generatePageComponent(route)).toContain("About Page");
+  });
+});

package/src/generator/templates.ts

@@ -1,4 +1,4 @@
-import type { RouteSpec } from "../spec/schema";
+import { needsHydration, type RouteSpec } from "../spec/schema";
 import { GENERATED_RELATIVE_PATHS } from "../paths";
 
 export function generateApiHandler(route: RouteSpec): string {
@@ -238,14 +238,21 @@ function computeSlotImportPath(slotModule: string, fromDir: string): string {
   return result;
 }
 
-export function generatePageComponent(route: RouteSpec): string {
-  // Island-First: clientModule이 있으면 Island render를 SSR에서 직접 사용
-  if (route.clientModule) {
-    return generatePageComponentWithIsland(route);
-  }
-
-  // slotModule이 있으면 PageHandler 형식으로 생성 (filling 포함)
-  if (route.slotModule) {
+export function generatePageComponent(route: RouteSpec): string {
+  // Island-First: clientModule이 있으면 Island render를 SSR에서 직접 사용
+  if (route.clientModule) {
+    return generatePageComponentWithIsland(route);
+  }
+
+  if (needsHydration(route)) {
+    throw new Error(
+      `[${route.id}] Route has hydration strategy "${route.hydration?.strategy}" but no clientModule. ` +
+      "Refusing to generate a placeholder page because it would disagree with runtime hydration state.",
+    );
+  }
+
+  // slotModule이 있으면 PageHandler 형식으로 생성 (filling 포함)
+  if (route.slotModule) {
     return generatePageHandlerWithSlot(route);
   }