@mandujs/core 0.18.2 → 0.18.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.18.2",
+  "version": "0.18.5",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",
@@ -44,7 +44,13 @@
   },
   "peerDependencies": {
     "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react-dom": "^19.0.0",
+    "@tailwindcss/cli": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tailwindcss/cli": {
+      "optional": true
+    }
   },
   "dependencies": {
     "chokidar": "^5.0.0",

package/src/bundler/build.ts

@@ -205,11 +205,11 @@ async function loadAndHydrate(element, src) {
     // Dynamic import - 이 시점에 Island 모듈 로드
     const module = await import(src);
     const island = module.default;
+    const data = getServerData(id);
 
     // Mandu Island (preferred)
     if (island && island.__mandu_island === true) {
       const { definition } = island;
-      const data = getServerData(id);
 
       // Island 컴포넌트 (Error Boundary + Loading 지원)
       function IslandComponent() {
@@ -258,11 +258,14 @@ async function loadAndHydrate(element, src) {
 
       console.log('[Mandu] Hydrated:', id);
     }
-    // Plain React component fallback
+    // Plain React component fallback (e.g. "use client" pages)
     else if (typeof island === 'function' || React.isValidElement(island)) {
       console.warn('[Mandu] Plain component hydration:', id);
-      const data = getServerData(id);
-      const root = hydrateRoot(element, React.createElement(island, data));
+
+      const root = typeof island === 'function'
+        ? hydrateRoot(element, React.createElement(island, data))
+        : hydrateRoot(element, island);
+
       hydratedRoots.set(id, root);
 
       // 완료 표시
@@ -390,6 +393,8 @@ import React, {
   Suspense,
   StrictMode,
   Profiler,
+  // Misc
+  version,
   // Types
   Component,
   PureComponent,
@@ -401,15 +406,16 @@ import { jsx, jsxs } from 'react/jsx-runtime';
 import { jsxDEV } from 'react/jsx-dev-runtime';
 
 // React internals (ReactDOM이 내부적으로 접근 필요)
-const __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED = React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
-
-// React 19 client internals (Playwright headless 환경 호환성)
+// React 19+: __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE
+// React <=18: __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED
 const __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE =
   React.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE || {};
+const __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED =
+  React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED || {};
 
-// Null safety for Playwright headless browsers
+// Null safety for Playwright headless browsers (React 19)
 if (__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE.S == null) {
-  __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE.S = function() {};
+  __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE.S = function () {};
 }
 
 // 전역 React 설정 (모든 모듈에서 동일 인스턴스 공유)
@@ -447,20 +453,18 @@ export {
   Suspense,
   StrictMode,
   Profiler,
+  version,
   Component,
   PureComponent,
   Children,
-  __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,
   __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,
+  __SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED,
   // JSX Runtime exports
   jsx,
   jsxs,
   jsxDEV,
 };
 
-// Version export (React 19 compatibility)
-export const version = React.version;
-
 // Default export
 export default React;
 `;
@@ -478,10 +482,6 @@ function generateReactDOMShimSource(): string {
 import ReactDOM, {
   createPortal,
   flushSync,
-  render,
-  unmountComponentAtNode,
-  findDOMNode,
-  hydrate,
   version,
 } from 'react-dom';
 
@@ -489,10 +489,6 @@ import ReactDOM, {
 export {
   createPortal,
   flushSync,
-  render,
-  unmountComponentAtNode,
-  findDOMNode,
-  hydrate,
   version,
 };
 
@@ -849,10 +845,8 @@ async function buildRuntime(
       },
     });
 
-    // 소스 파일 정리
-    await fs.unlink(runtimePath).catch(() => {});
-
     if (!result.success) {
+      // 실패 시 디버깅을 위해 소스 파일을 남겨둠 (_runtime.src.js)
       return {
         success: false,
         outputPath: "",
@@ -860,17 +854,28 @@ async function buildRuntime(
       };
     }
 
+    // 성공 시에만 소스 파일 정리
+    await fs.unlink(runtimePath).catch(() => {});
+
     return {
       success: true,
       outputPath: `/.mandu/client/${outputName}`,
       errors: [],
     };
-  } catch (error) {
-    await fs.unlink(runtimePath).catch(() => {});
+  } catch (error: any) {
+    // 예외 발생 시에도 디버깅을 위해 소스 파일을 남겨둠
+    const extra: string[] = [];
+    if (error?.errors && Array.isArray(error.errors)) {
+      extra.push(...error.errors.map((e: any) => String(e?.message || e)));
+    }
+    if (error?.logs && Array.isArray(error.logs)) {
+      extra.push(...error.logs.map((l: any) => String(l?.message || l)));
+    }
+
     return {
       success: false,
       outputPath: "",
-      errors: [String(error)],
+      errors: [String(error), ...extra].filter(Boolean),
     };
   }
 }
@@ -1200,20 +1205,19 @@ export async function buildClientBundles(
     };
   }
 
-  // 3. Runtime 번들 빌드
-  const runtimeResult = await buildRuntime(outDir, options);
+  // 3-4. Runtime, Router, Vendor 번들 병렬 빌드 (서로 독립적)
+  const [runtimeResult, routerResult, vendorResult] = await Promise.all([
+    buildRuntime(outDir, options),
+    buildRouterRuntime(outDir, options),
+    buildVendorShims(outDir, options),
+  ]);
+
   if (!runtimeResult.success) {
     errors.push(...runtimeResult.errors.map((e) => `[Runtime] ${e}`));
   }
-
-  // 3.5. Client-side Router 런타임 빌드
-  const routerResult = await buildRouterRuntime(outDir, options);
   if (!routerResult.success) {
     errors.push(...routerResult.errors.map((e) => `[Router] ${e}`));
   }
-
-  // 4. Vendor shim 번들 빌드 (React, ReactDOM, ReactDOMClient)
-  const vendorResult = await buildVendorShims(outDir, options);
   if (!vendorResult.success) {
     errors.push(...vendorResult.errors);
   }