@mandujs/cli 0.12.2 → 0.13.0

package/src/util/port.ts

@@ -1,71 +1,71 @@
-import { createServer } from "net";
-
-const DEFAULT_MAX_ATTEMPTS = 10;
-
-function isPortUsable(error: unknown): boolean {
-  if (!error || typeof error !== "object") return false;
-  const code = (error as { code?: string }).code;
-  return code === "EADDRINUSE" || code === "EACCES";
-}
-
-async function isPortAvailable(port: number, hostname?: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = createServer();
-
-    server.once("error", (error) => {
-      if (isPortUsable(error)) {
-        resolve(false);
-      } else {
-        resolve(false);
-      }
-    });
-
-    server.once("listening", () => {
-      server.close(() => resolve(true));
-    });
-
-    try {
-      server.listen(port, hostname);
-      server.unref();
-    } catch {
-      resolve(false);
-    }
-  });
-}
-
-export async function resolveAvailablePort(
-  startPort: number,
-  options: {
-    hostname?: string;
-    offsets?: number[];
-    maxAttempts?: number;
-  } = {}
-): Promise<{ port: number; attempts: number }> {
-  const offsets = options.offsets && options.offsets.length > 0 ? options.offsets : [0];
-  const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
-
-  for (let attempt = 0; attempt < maxAttempts; attempt++) {
-    const candidate = startPort + attempt;
-    if (candidate < 1 || candidate > 65535) {
-      continue;
-    }
-
-    const targets = offsets
-      .map((offset) => candidate + offset)
-      .filter((port) => port >= 1 && port <= 65535);
-
-    if (targets.length !== offsets.length) {
-      continue;
-    }
-
-    const results = await Promise.all(
-      targets.map((port) => isPortAvailable(port, options.hostname))
-    );
-
-    if (results.every(Boolean)) {
-      return { port: candidate, attempts: attempt };
-    }
-  }
-
-  throw new Error(`No available port found starting at ${startPort}`);
-}
+import { createServer } from "net";
+
+const DEFAULT_MAX_ATTEMPTS = 10;
+
+function isPortUsable(error: unknown): boolean {
+  if (!error || typeof error !== "object") return false;
+  const code = (error as { code?: string }).code;
+  return code === "EADDRINUSE" || code === "EACCES";
+}
+
+async function isPortAvailable(port: number, hostname?: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    const server = createServer();
+
+    server.once("error", (error) => {
+      if (isPortUsable(error)) {
+        resolve(false);
+      } else {
+        resolve(false);
+      }
+    });
+
+    server.once("listening", () => {
+      server.close(() => resolve(true));
+    });
+
+    try {
+      server.listen(port, hostname);
+      server.unref();
+    } catch {
+      resolve(false);
+    }
+  });
+}
+
+export async function resolveAvailablePort(
+  startPort: number,
+  options: {
+    hostname?: string;
+    offsets?: number[];
+    maxAttempts?: number;
+  } = {}
+): Promise<{ port: number; attempts: number }> {
+  const offsets = options.offsets && options.offsets.length > 0 ? options.offsets : [0];
+  const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    const candidate = startPort + attempt;
+    if (candidate < 1 || candidate > 65535) {
+      continue;
+    }
+
+    const targets = offsets
+      .map((offset) => candidate + offset)
+      .filter((port) => port >= 1 && port <= 65535);
+
+    if (targets.length !== offsets.length) {
+      continue;
+    }
+
+    const results = await Promise.all(
+      targets.map((port) => isPortAvailable(port, options.hostname))
+    );
+
+    if (results.every(Boolean)) {
+      return { port: candidate, attempts: attempt };
+    }
+  }
+
+  throw new Error(`No available port found starting at ${startPort}`);
+}

package/templates/default/AGENTS.md

@@ -1,96 +1,96 @@
-# AI Agent Instructions for Mandu Project
-
-이 프로젝트는 **Mandu Framework**로 구축되었습니다. AI 에이전트가 이 프로젝트를 다룰 때 아래 지침을 따라주세요.
-
-## 패키지 매니저: Bun (필수)
-
-**⚠️ 중요: 이 프로젝트는 Bun만 사용합니다. npm/yarn/pnpm을 사용하지 마세요.**
-
-```bash
-# ✅ 올바른 명령어
-bun install              # 의존성 설치
-bun add <package>        # 패키지 추가
-bun remove <package>     # 패키지 제거
-bun run dev              # 개발 서버 시작
-bun run build            # 프로덕션 빌드
-bun test                 # 테스트 실행
-
-# ❌ 사용 금지
-npm install / yarn install / pnpm install
-```
-
-## 프로젝트 구조
-
-```
-├── app/                  # FS 기반 라우팅 (페이지, API)
-│   ├── page.tsx         # / 라우트
-│   ├── layout.tsx       # 루트 레이아웃
-│   ├── globals.css      # Tailwind CSS (v4)
-│   └── api/             # API 라우트
-├── src/
-│   ├── client/          # 클라이언트 코드 (FSD 구조)
-│   │   ├── shared/      # 공용 UI, 유틸리티
-│   │   ├── entities/    # 엔티티 컴포넌트
-│   │   ├── features/    # 기능 컴포넌트
-│   │   └── widgets/     # 위젯/Island 컴포넌트
-│   ├── server/          # 서버 코드 (Clean Architecture)
-│   │   ├── domain/      # 도메인 모델
-│   │   ├── application/ # 비즈니스 로직
-│   │   └── infra/       # 인프라/DB
-│   └── shared/          # 클라이언트-서버 공유 코드
-│       ├── contracts/   # API 계약 타입
-│       └── types/       # 공용 타입
-└── mandu.config.ts      # Mandu 설정 (선택)
-```
-
-## 주요 규칙
-
-### 1. Island 컴포넌트
-클라이언트 상호작용이 필요한 컴포넌트는 `*.island.tsx`로 명명:
-```tsx
-// src/client/widgets/counter/Counter.island.tsx
-"use client";
-export function CounterIsland() { ... }
-```
-
-### 2. API 라우트
-`app/api/` 폴더에 `route.ts` 파일로 정의:
-```typescript
-// app/api/users/route.ts
-import { Mandu } from "@mandujs/core";
-export default Mandu.filling()
-  .get((ctx) => ctx.ok({ users: [] }))
-  .post(async (ctx) => { ... });
-```
-
-### 3. Tailwind CSS v4
-CSS-first 설정 사용 (`tailwind.config.ts` 없음):
-```css
-/* app/globals.css */
-@import "tailwindcss";
-@theme {
-  --color-primary: hsl(222.2 47.4% 11.2%);
-}
-```
-
-### 4. Import Alias
-`@/` = `src/` 경로:
-```typescript
-import { Button } from "@/client/shared/ui/button";
-```
-
-## 실행 방법
-
-```bash
-bun install     # 최초 설치
-bun run dev     # 개발 서버 (http://localhost:4000)
-bun run build   # 프로덕션 빌드
-bun run guard   # 아키텍처 검증
-```
-
-## 기술 스택
-
-- **Runtime**: Bun 1.x
-- **Framework**: Mandu (React 19 + Bun native)
-- **Styling**: Tailwind CSS v4
-- **Language**: TypeScript 5.x
+# AI Agent Instructions for Mandu Project
+
+이 프로젝트는 **Mandu Framework**로 구축되었습니다. AI 에이전트가 이 프로젝트를 다룰 때 아래 지침을 따라주세요.
+
+## 패키지 매니저: Bun (필수)
+
+**⚠️ 중요: 이 프로젝트는 Bun만 사용합니다. npm/yarn/pnpm을 사용하지 마세요.**
+
+```bash
+# ✅ 올바른 명령어
+bun install              # 의존성 설치
+bun add <package>        # 패키지 추가
+bun remove <package>     # 패키지 제거
+bun run dev              # 개발 서버 시작
+bun run build            # 프로덕션 빌드
+bun test                 # 테스트 실행
+
+# ❌ 사용 금지
+npm install / yarn install / pnpm install
+```
+
+## 프로젝트 구조
+
+```
+├── app/                  # FS 기반 라우팅 (페이지, API)
+│   ├── page.tsx         # / 라우트
+│   ├── layout.tsx       # 루트 레이아웃
+│   ├── globals.css      # Tailwind CSS (v4)
+│   └── api/             # API 라우트
+├── src/
+│   ├── client/          # 클라이언트 코드 (FSD 구조)
+│   │   ├── shared/      # 공용 UI, 유틸리티
+│   │   ├── entities/    # 엔티티 컴포넌트
+│   │   ├── features/    # 기능 컴포넌트
+│   │   └── widgets/     # 위젯/Island 컴포넌트
+│   ├── server/          # 서버 코드 (Clean Architecture)
+│   │   ├── domain/      # 도메인 모델
+│   │   ├── application/ # 비즈니스 로직
+│   │   └── infra/       # 인프라/DB
+│   └── shared/          # 클라이언트-서버 공유 코드
+│       ├── contracts/   # API 계약 타입
+│       └── types/       # 공용 타입
+└── mandu.config.ts      # Mandu 설정 (선택)
+```
+
+## 주요 규칙
+
+### 1. Island 컴포넌트
+클라이언트 상호작용이 필요한 컴포넌트는 `*.island.tsx`로 명명:
+```tsx
+// src/client/widgets/counter/Counter.island.tsx
+"use client";
+export function CounterIsland() { ... }
+```
+
+### 2. API 라우트
+`app/api/` 폴더에 `route.ts` 파일로 정의:
+```typescript
+// app/api/users/route.ts
+import { Mandu } from "@mandujs/core";
+export default Mandu.filling()
+  .get((ctx) => ctx.ok({ users: [] }))
+  .post(async (ctx) => { ... });
+```
+
+### 3. Tailwind CSS v4
+CSS-first 설정 사용 (`tailwind.config.ts` 없음):
+```css
+/* app/globals.css */
+@import "tailwindcss";
+@theme {
+  --color-primary: hsl(222.2 47.4% 11.2%);
+}
+```
+
+### 4. Import Alias
+`@/` = `src/` 경로:
+```typescript
+import { Button } from "@/client/shared/ui/button";
+```
+
+## 실행 방법
+
+```bash
+bun install     # 최초 설치
+bun run dev     # 개발 서버 (http://localhost:4000)
+bun run build   # 프로덕션 빌드
+bun run guard   # 아키텍처 검증
+```
+
+## 기술 스택
+
+- **Runtime**: Bun 1.x
+- **Framework**: Mandu (React 19 + Bun native)
+- **Styling**: Tailwind CSS v4
+- **Language**: TypeScript 5.x

package/templates/default/app/api/health/route.ts

@@ -1,13 +1,13 @@
-/**
- * Health Check API
- *
- * GET /api/health
- */
-
-export function GET() {
-  return Response.json({
-    status: "ok",
-    timestamp: new Date().toISOString(),
-    framework: "Mandu",
-  });
-}
+/**
+ * Health Check API
+ *
+ * GET /api/health
+ */
+
+export function GET() {
+  return Response.json({
+    status: "ok",
+    timestamp: new Date().toISOString(),
+    framework: "Mandu",
+  });
+}

package/templates/default/app/globals.css

@@ -1,49 +1,49 @@
-@import "tailwindcss";
-
-/*
- * Tailwind CSS v4 - CSS-first Configuration
- * https://tailwindcss.com/docs/v4
- */
-
-@theme {
-  /* Colors - shadcn/ui compatible */
-  --color-background: hsl(0 0% 100%);
-  --color-foreground: hsl(222.2 84% 4.9%);
-  --color-card: hsl(0 0% 100%);
-  --color-card-foreground: hsl(222.2 84% 4.9%);
-  --color-popover: hsl(0 0% 100%);
-  --color-popover-foreground: hsl(222.2 84% 4.9%);
-  --color-primary: hsl(222.2 47.4% 11.2%);
-  --color-primary-foreground: hsl(210 40% 98%);
-  --color-secondary: hsl(210 40% 96.1%);
-  --color-secondary-foreground: hsl(222.2 47.4% 11.2%);
-  --color-muted: hsl(210 40% 96.1%);
-  --color-muted-foreground: hsl(215.4 16.3% 46.9%);
-  --color-accent: hsl(210 40% 96.1%);
-  --color-accent-foreground: hsl(222.2 47.4% 11.2%);
-  --color-destructive: hsl(0 84.2% 60.2%);
-  --color-destructive-foreground: hsl(210 40% 98%);
-  --color-border: hsl(214.3 31.8% 91.4%);
-  --color-input: hsl(214.3 31.8% 91.4%);
-  --color-ring: hsl(222.2 84% 4.9%);
-
-  /* Radius */
-  --radius-sm: 0.25rem;
-  --radius-md: 0.5rem;
-  --radius-lg: 0.75rem;
-  --radius-xl: 1rem;
-
-  /* Fonts */
-  --font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
-}
-
-/* Base styles */
-* {
-  border-color: var(--color-border);
-}
-
-body {
-  background-color: var(--color-background);
-  color: var(--color-foreground);
-  font-family: var(--font-sans);
-}
+@import "tailwindcss";
+
+/*
+ * Tailwind CSS v4 - CSS-first Configuration
+ * https://tailwindcss.com/docs/v4
+ */
+
+@theme {
+  /* Colors - shadcn/ui compatible */
+  --color-background: hsl(0 0% 100%);
+  --color-foreground: hsl(222.2 84% 4.9%);
+  --color-card: hsl(0 0% 100%);
+  --color-card-foreground: hsl(222.2 84% 4.9%);
+  --color-popover: hsl(0 0% 100%);
+  --color-popover-foreground: hsl(222.2 84% 4.9%);
+  --color-primary: hsl(222.2 47.4% 11.2%);
+  --color-primary-foreground: hsl(210 40% 98%);
+  --color-secondary: hsl(210 40% 96.1%);
+  --color-secondary-foreground: hsl(222.2 47.4% 11.2%);
+  --color-muted: hsl(210 40% 96.1%);
+  --color-muted-foreground: hsl(215.4 16.3% 46.9%);
+  --color-accent: hsl(210 40% 96.1%);
+  --color-accent-foreground: hsl(222.2 47.4% 11.2%);
+  --color-destructive: hsl(0 84.2% 60.2%);
+  --color-destructive-foreground: hsl(210 40% 98%);
+  --color-border: hsl(214.3 31.8% 91.4%);
+  --color-input: hsl(214.3 31.8% 91.4%);
+  --color-ring: hsl(222.2 84% 4.9%);
+
+  /* Radius */
+  --radius-sm: 0.25rem;
+  --radius-md: 0.5rem;
+  --radius-lg: 0.75rem;
+  --radius-xl: 1rem;
+
+  /* Fonts */
+  --font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
+}
+
+/* Base styles */
+* {
+  border-color: var(--color-border);
+}
+
+body {
+  background-color: var(--color-background);
+  color: var(--color-foreground);
+  font-family: var(--font-sans);
+}

package/templates/default/app/layout.tsx

@@ -1,27 +1,27 @@
-/**
- * Root Layout
- *
- * 모든 페이지의 공통 레이아웃
- * globals.css를 여기서 임포트
- */
-
-import "./globals.css";
-
-interface RootLayoutProps {
-  children: React.ReactNode;
-}
-
-export default function RootLayout({ children }: RootLayoutProps) {
-  return (
-    <html lang="ko">
-      <head>
-        <meta charSet="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>{{PROJECT_NAME}}</title>
-      </head>
-      <body className="min-h-screen bg-background font-sans antialiased">
-        {children}
-      </body>
-    </html>
-  );
-}
+/**
+ * Root Layout
+ *
+ * 모든 페이지의 공통 레이아웃
+ * globals.css를 여기서 임포트
+ */
+
+import "./globals.css";
+
+interface RootLayoutProps {
+  children: React.ReactNode;
+}
+
+export default function RootLayout({ children }: RootLayoutProps) {
+  return (
+    <html lang="ko">
+      <head>
+        <meta charSet="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>{{PROJECT_NAME}}</title>
+      </head>
+      <body className="min-h-screen bg-background font-sans antialiased">
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/default/app/page.tsx

@@ -1,38 +1,38 @@
-/**
- * Home Page
- *
- * Edit this file and see changes at http://localhost:3000
- */
-
-import { Button } from "@/client/shared/ui/button";
-import { Card, CardHeader, CardTitle, CardDescription, CardContent } from "@/client/shared/ui/card";
-
-export default function HomePage() {
-  return (
-    <main className="flex min-h-screen flex-col items-center justify-center bg-gradient-to-br from-indigo-500 to-purple-600 p-8">
-      <Card className="w-full max-w-md">
-        <CardHeader className="text-center">
-          <CardTitle className="text-4xl">🥟 Mandu</CardTitle>
-          <CardDescription>
-            Welcome to your new Mandu project!
-          </CardDescription>
-        </CardHeader>
-        <CardContent className="flex flex-col gap-4">
-          <p className="text-center text-muted-foreground">
-            Edit <code className="rounded bg-muted px-1.5 py-0.5 text-sm">app/page.tsx</code> to get started.
-          </p>
-          <div className="flex justify-center gap-2">
-            <Button asChild variant="default">
-              <a href="/api/health">API Health →</a>
-            </Button>
-            <Button asChild variant="outline">
-              <a href="https://mandujs.dev/docs" target="_blank" rel="noopener noreferrer">
-                Documentation
-              </a>
-            </Button>
-          </div>
-        </CardContent>
-      </Card>
-    </main>
-  );
-}
+/**
+ * Home Page
+ *
+ * Edit this file and see changes at http://localhost:3000
+ */
+
+import { Button } from "@/client/shared/ui/button";
+import { Card, CardHeader, CardTitle, CardDescription, CardContent } from "@/client/shared/ui/card";
+
+export default function HomePage() {
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center bg-gradient-to-br from-indigo-500 to-purple-600 p-8">
+      <Card className="w-full max-w-md">
+        <CardHeader className="text-center">
+          <CardTitle className="text-4xl">🥟 Mandu</CardTitle>
+          <CardDescription>
+            Welcome to your new Mandu project!
+          </CardDescription>
+        </CardHeader>
+        <CardContent className="flex flex-col gap-4">
+          <p className="text-center text-muted-foreground">
+            Edit <code className="rounded bg-muted px-1.5 py-0.5 text-sm">app/page.tsx</code> to get started.
+          </p>
+          <div className="flex justify-center gap-2">
+            <Button asChild variant="default">
+              <a href="/api/health">API Health →</a>
+            </Button>
+            <Button asChild variant="outline">
+              <a href="https://mandujs.dev/docs" target="_blank" rel="noopener noreferrer">
+                Documentation
+              </a>
+            </Button>
+          </div>
+        </CardContent>
+      </Card>
+    </main>
+  );
+}

package/templates/default/package.json

@@ -9,6 +9,7 @@
   "scripts": {
     "dev": "mandu dev",
     "build": "mandu build",
+    "start": "mandu start",
     "check": "mandu check",
     "guard": "mandu guard",
     "test": "bun test"

package/templates/default/src/client/shared/lib/utils.ts

@@ -1,16 +1,16 @@
-import { type ClassValue, clsx } from "clsx";
-import { twMerge } from "tailwind-merge";
-
-/**
- * cn - Tailwind CSS 클래스 병합 유틸리티
- *
- * clsx로 조건부 클래스를 결합하고
- * tailwind-merge로 충돌하는 클래스를 스마트하게 병합
- *
- * @example
- * cn("px-4 py-2", isActive && "bg-primary", className)
- * cn("text-sm", "text-lg") // → "text-lg" (충돌 해결)
- */
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * cn - Tailwind CSS 클래스 병합 유틸리티
+ *
+ * clsx로 조건부 클래스를 결합하고
+ * tailwind-merge로 충돌하는 클래스를 스마트하게 병합
+ *
+ * @example
+ * cn("px-4 py-2", isActive && "bg-primary", className)
+ * cn("text-sm", "text-lg") // → "text-lg" (충돌 해결)
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}