@mandujs/cli 0.9.42 → 0.9.43

package/src/util/manifest.ts

@@ -0,0 +1,52 @@
+import path from "path";
+import {
+  generateManifest,
+  loadManifest,
+  type RoutesManifest,
+  type FSScannerConfig,
+} from "@mandujs/core";
+import { isDirectory } from "./fs";
+
+export type ManifestSource = "fs" | "spec";
+
+export interface ResolvedManifest {
+  manifest: RoutesManifest;
+  source: ManifestSource;
+  warnings: string[];
+}
+
+export async function resolveManifest(
+  rootDir: string,
+  options: { fsRoutes?: FSScannerConfig; outputPath?: string } = {}
+): Promise<ResolvedManifest> {
+  const appDir = path.resolve(rootDir, "app");
+  const hasApp = await isDirectory(appDir);
+
+  if (hasApp) {
+    const result = await generateManifest(rootDir, {
+      scanner: options.fsRoutes,
+      outputPath: options.outputPath,
+      skipLegacy: true,
+    });
+    return {
+      manifest: result.manifest,
+      source: "fs",
+      warnings: result.warnings,
+    };
+  }
+
+  const specPath = path.join(rootDir, "spec", "routes.manifest.json");
+  if (await Bun.file(specPath).exists()) {
+    const result = await loadManifest(specPath);
+    if (!result.success) {
+      throw new Error(result.errors?.join(", ") || "Failed to load routes manifest");
+    }
+    return {
+      manifest: result.data!,
+      source: "spec",
+      warnings: [],
+    };
+  }
+
+  throw new Error("No routes found. Create app/ routes or spec/routes.manifest.json");
+}

package/src/util/port.ts

@@ -0,0 +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}`);
+}

package/templates/default/AGENTS.md

@@ -0,0 +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

package/templates/default/app/globals.css

@@ -1,37 +1,49 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
+@import "tailwindcss";
 
-@layer base {
-  :root {
-    --background: 0 0% 100%;
-    --foreground: 222.2 84% 4.9%;
-    --card: 0 0% 100%;
-    --card-foreground: 222.2 84% 4.9%;
-    --popover: 0 0% 100%;
-    --popover-foreground: 222.2 84% 4.9%;
-    --primary: 222.2 47.4% 11.2%;
-    --primary-foreground: 210 40% 98%;
-    --secondary: 210 40% 96.1%;
-    --secondary-foreground: 222.2 47.4% 11.2%;
-    --muted: 210 40% 96.1%;
-    --muted-foreground: 215.4 16.3% 46.9%;
-    --accent: 210 40% 96.1%;
-    --accent-foreground: 222.2 47.4% 11.2%;
-    --destructive: 0 84.2% 60.2%;
-    --destructive-foreground: 210 40% 98%;
-    --border: 214.3 31.8% 91.4%;
-    --input: 214.3 31.8% 91.4%;
-    --ring: 222.2 84% 4.9%;
-    --radius: 0.5rem;
-  }
+/*
+ * 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);
 }
 
-@layer base {
-  * {
-    @apply border-border;
-  }
-  body {
-    @apply bg-background text-foreground;
-  }
+body {
+  background-color: var(--color-background);
+  color: var(--color-foreground);
+  font-family: var(--font-sans);
 }

package/templates/default/package.json

@@ -2,15 +2,19 @@
   "name": "{{PROJECT_NAME}}",
   "version": "0.1.0",
   "type": "module",
-  "scripts": {
-    "dev": "mandu dev",
-    "build": "mandu build",
-    "check": "mandu check",
-    "guard": "mandu guard",
-    "test": "bun test"
-  },
+  "packageManager": "bun@1.2.0",
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "scripts": {
+    "dev": "mandu dev",
+    "build": "mandu build",
+    "check": "mandu check",
+    "guard": "mandu guard",
+    "test": "bun test"
+  },
   "dependencies": {
-    "@mandujs/core": "^0.9.39",
+    "@mandujs/core": "^0.9.42",
     "@radix-ui/react-slot": "^1.1.0",
     "class-variance-authority": "^0.7.0",
     "clsx": "^2.1.1",
@@ -19,12 +23,11 @@
     "tailwind-merge": "^2.5.2"
   },
   "devDependencies": {
-    "@mandujs/cli": "^0.9.21",
+    "@mandujs/cli": "^0.9.42",
+    "@tailwindcss/cli": "^4.1.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
-    "autoprefixer": "^10.4.20",
-    "postcss": "^8.4.47",
-    "tailwindcss": "^3.4.14",
+    "tailwindcss": "^4.1.0",
     "typescript": "^5.0.0"
   }
 }

package/templates/default/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/templates/default/tailwind.config.ts

@@ -1,64 +0,0 @@
-import type { Config } from "tailwindcss";
-
-const config: Config = {
-  content: [
-    "./app/**/*.{ts,tsx,mdx}",
-    "./src/**/*.{ts,tsx,mdx}",
-  ],
-  theme: {
-    extend: {
-      colors: {
-        background: "hsl(var(--background))",
-        foreground: "hsl(var(--foreground))",
-        card: {
-          DEFAULT: "hsl(var(--card))",
-          foreground: "hsl(var(--card-foreground))",
-        },
-        popover: {
-          DEFAULT: "hsl(var(--popover))",
-          foreground: "hsl(var(--popover-foreground))",
-        },
-        primary: {
-          DEFAULT: "hsl(var(--primary))",
-          foreground: "hsl(var(--primary-foreground))",
-        },
-        secondary: {
-          DEFAULT: "hsl(var(--secondary))",
-          foreground: "hsl(var(--secondary-foreground))",
-        },
-        muted: {
-          DEFAULT: "hsl(var(--muted))",
-          foreground: "hsl(var(--muted-foreground))",
-        },
-        accent: {
-          DEFAULT: "hsl(var(--accent))",
-          foreground: "hsl(var(--accent-foreground))",
-        },
-        destructive: {
-          DEFAULT: "hsl(var(--destructive))",
-          foreground: "hsl(var(--destructive-foreground))",
-        },
-        border: "hsl(var(--border))",
-        input: "hsl(var(--input))",
-        ring: "hsl(var(--ring))",
-      },
-      borderRadius: {
-        lg: "var(--radius)",
-        md: "calc(var(--radius) - 2px)",
-        sm: "calc(var(--radius) - 4px)",
-      },
-      fontFamily: {
-        sans: [
-          "-apple-system",
-          "BlinkMacSystemFont",
-          "Segoe UI",
-          "Roboto",
-          "sans-serif",
-        ],
-      },
-    },
-  },
-  plugins: [],
-};
-
-export default config;