@mandujs/core 0.9.43 → 0.9.45

package/package.json

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

package/src/bundler/css.ts

@@ -176,8 +176,15 @@ export async function startCSSWatch(options: CSSBuildOptions): Promise<CSSWatche
   const inputPath = path.join(rootDir, input);
   const outputPath = path.join(rootDir, output);
 
-  // 출력 디렉토리 생성
-  await fs.mkdir(path.dirname(outputPath), { recursive: true });
+  try {
+    // 출력 디렉토리 생성
+    await fs.mkdir(path.dirname(outputPath), { recursive: true });
+  } catch (error) {
+    const err = new Error(`CSS 출력 디렉토리 생성 실패: ${error instanceof Error ? error.message : error}`);
+    console.error(`❌ ${err.message}`);
+    onError?.(err);
+    throw err;
+  }
 
   // Tailwind CLI 인자 구성
   const args = [
@@ -196,11 +203,23 @@ export async function startCSSWatch(options: CSSBuildOptions): Promise<CSSWatche
   console.log(`   출력: ${output}`);
 
   // Bun subprocess로 Tailwind CLI 실행
-  const proc = spawn(["bunx", ...args], {
-    cwd: rootDir,
-    stdout: "pipe",
-    stderr: "pipe",
-  });
+  let proc;
+  try {
+    proc = spawn(["bunx", ...args], {
+      cwd: rootDir,
+      stdout: "pipe",
+      stderr: "pipe",
+    });
+  } catch (error) {
+    const err = new Error(
+      `Tailwind CLI 실행 실패. @tailwindcss/cli가 설치되어 있는지 확인하세요.\n` +
+      `설치: bun add -d @tailwindcss/cli tailwindcss\n` +
+      `원인: ${error instanceof Error ? error.message : error}`
+    );
+    console.error(`❌ ${err.message}`);
+    onError?.(err);
+    throw err;
+  }
 
   // stdout 모니터링 (빌드 완료 감지)
   (async () => {

package/src/runtime/server.ts

@@ -949,10 +949,20 @@ export function startServer(manifest: RoutesManifest, options: ServerOptions = {
     publicDir = "public",
     cors = false,
     streaming = false,
-    cssPath,
+    cssPath: cssPathOption,
     registry = defaultRegistry,
   } = options;
 
+  // cssPath 처리:
+  // - string: 해당 경로로 <link> 주입
+  // - false: CSS 링크 주입 비활성화
+  // - undefined: false로 처리 (기본적으로 링크 미삽입 - 404 방지)
+  //
+  // dev/build에서 Tailwind 감지 시 명시적으로 cssPath 전달 필요:
+  // - dev.ts: cssPath: hasTailwind ? cssWatcher?.serverPath : false
+  // - 프로덕션: 빌드 후 .mandu/client/globals.css 존재 시 경로 전달
+  const cssPath: string | false = cssPathOption ?? false;
+
   // CORS 옵션 파싱
   const corsOptions: CorsOptions | false = cors === true ? {} : cors;
 

package/src/runtime/ssr.ts

@@ -156,10 +156,12 @@ export function renderToHTML(element: ReactElement, options: SSROptions = {}): s
     cssPath,
   } = options;
 
-  // CSS 링크 태그 생성 (cssPath가 false가 아닌 경우)
-  const cssLinkTag = cssPath === false
-    ? ""
-    : `<link rel="stylesheet" href="${cssPath || "/.mandu/client/globals.css"}${isDev ? `?t=${Date.now()}` : ""}">`;
+  // CSS 링크 태그 생성
+  // - cssPath가 string이면 해당 경로 사용
+  // - cssPath가 false 또는 undefined이면 링크 미삽입 (404 방지)
+  const cssLinkTag = cssPath && cssPath !== false
+    ? `<link rel="stylesheet" href="${cssPath}${isDev ? `?t=${Date.now()}` : ""}">`
+    : "";
 
   let content = renderToString(element);
 

package/src/runtime/streaming-ssr.ts

@@ -373,10 +373,12 @@ function generateHTMLShell(options: StreamingSSROptions): string {
     isDev = false,
   } = options;
 
-  // CSS 링크 태그 생성 (cssPath가 false가 아닌 경우)
-  const cssLinkTag = cssPath === false
-    ? ""
-    : `<link rel="stylesheet" href="${cssPath || "/.mandu/client/globals.css"}${isDev ? `?t=${Date.now()}` : ""}">`;
+  // CSS 링크 태그 생성
+  // - cssPath가 string이면 해당 경로 사용
+  // - cssPath가 false 또는 undefined이면 링크 미삽입 (404 방지)
+  const cssLinkTag = cssPath && cssPath !== false
+    ? `<link rel="stylesheet" href="${cssPath}${isDev ? `?t=${Date.now()}` : ""}">`
+    : "";
 
   // Import map (module scripts 전에 위치해야 함)
   let importMapScript = "";