@mandujs/cli 0.15.1 → 0.15.2

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/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));
+}

package/templates/default/src/client/shared/ui/button.tsx

@@ -1,57 +1,57 @@
-"use client";
-
-import * as React from "react";
-import { Slot } from "@radix-ui/react-slot";
-import { cva, type VariantProps } from "class-variance-authority";
-import { cn } from "@/client/shared/lib/utils";
-
-const buttonVariants = cva(
-  "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
-  {
-    variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground hover:bg-primary/90",
-        destructive:
-          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
-        outline:
-          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
-        secondary:
-          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        ghost: "hover:bg-accent hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-10 px-4 py-2",
-        sm: "h-9 rounded-md px-3",
-        lg: "h-11 rounded-md px-8",
-        icon: "h-10 w-10",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-      size: "default",
-    },
-  }
-);
-
-export interface ButtonProps
-  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {
-  asChild?: boolean;
-}
-
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button";
-    return (
-      <Comp
-        className={cn(buttonVariants({ variant, size, className }))}
-        ref={ref}
-        {...props}
-      />
-    );
-  }
-);
-Button.displayName = "Button";
-
-export { Button, buttonVariants };
+"use client";
+
+import * as React from "react";
+import { Slot } from "@radix-ui/react-slot";
+import { cva, type VariantProps } from "class-variance-authority";
+import { cn } from "@/client/shared/lib/utils";
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-10 px-4 py-2",
+        sm: "h-9 rounded-md px-3",
+        lg: "h-11 rounded-md px-8",
+        icon: "h-10 w-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+);
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean;
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button";
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    );
+  }
+);
+Button.displayName = "Button";
+
+export { Button, buttonVariants };

package/templates/default/src/client/shared/ui/card.tsx

@@ -29,7 +29,7 @@ const CardHeader = React.forwardRef<
 CardHeader.displayName = "CardHeader";
 
 const CardTitle = React.forwardRef<
-  HTMLParagraphElement,
+  HTMLHeadingElement,
   React.HTMLAttributes<HTMLHeadingElement>
 >(({ className, ...props }, ref) => (
   <h3

package/templates/default/src/client/shared/ui/index.ts

@@ -1,21 +1,21 @@
-/**
- * UI Components
- *
- * shadcn/ui 스타일의 컴포넌트 라이브러리
- * Radix UI primitives + Tailwind CSS + cva 기반
- */
-
-export { Button, buttonVariants } from "./button";
-export type { ButtonProps } from "./button";
-
-export {
-  Card,
-  CardHeader,
-  CardFooter,
-  CardTitle,
-  CardDescription,
-  CardContent,
-} from "./card";
-
-export { Input } from "./input";
-export type { InputProps } from "./input";
+/**
+ * UI Components
+ *
+ * shadcn/ui 스타일의 컴포넌트 라이브러리
+ * Radix UI primitives + Tailwind CSS + cva 기반
+ */
+
+export { Button, buttonVariants } from "./button";
+export type { ButtonProps } from "./button";
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardDescription,
+  CardContent,
+} from "./card";
+
+export { Input } from "./input";
+export type { InputProps } from "./input";