@mandujs/core 0.2.1 → 0.2.2

package/README.ko.md

@@ -0,0 +1,191 @@
+# @mandujs/core
+
+> **[English](./README.md)** | 한국어
+
+Mandu Framework Core - Spec, Generator, Guard, Runtime
+
+## 설치
+
+```bash
+bun add @mandujs/core
+```
+
+> 일반적으로 `@mandujs/cli`를 통해 사용합니다. 직접 사용은 고급 사용 사례입니다.
+
+## 모듈 구조
+
+```
+@mandujs/core
+├── spec/      # Spec 스키마 및 로딩
+├── generator/ # 코드 생성
+├── guard/     # 아키텍처 검사 및 자동 수정
+├── runtime/   # 서버 및 라우터
+└── report/    # Guard 리포트 생성
+```
+
+## Spec 모듈
+
+라우트 manifest 스키마 정의 및 로딩.
+
+```typescript
+import { loadManifest, RoutesManifest, RouteSpec } from "@mandujs/core";
+
+// manifest 로드 및 검증
+const result = await loadManifest("spec/routes.manifest.json");
+
+if (result.success && result.data) {
+  const manifest: RoutesManifest = result.data;
+  manifest.routes.forEach((route: RouteSpec) => {
+    console.log(route.id, route.pattern, route.kind);
+  });
+}
+```
+
+### Lock 파일
+
+```typescript
+import { writeLock, readLock } from "@mandujs/core";
+
+// lock 파일 쓰기
+const lock = await writeLock("spec/spec.lock.json", manifest);
+console.log(lock.routesHash);
+
+// lock 파일 읽기
+const existing = await readLock("spec/spec.lock.json");
+```
+
+## Generator 모듈
+
+Spec 기반 코드 생성.
+
+```typescript
+import { generateRoutes, GenerateResult } from "@mandujs/core";
+
+const result: GenerateResult = await generateRoutes(manifest, "./");
+
+console.log("생성됨:", result.created);
+console.log("건너뜀:", result.skipped);  // 이미 존재하는 slot 파일
+```
+
+### 템플릿 함수
+
+```typescript
+import {
+  generateApiHandler,
+  generateApiHandlerWithSlot,
+  generateSlotLogic,
+  generatePageComponent
+} from "@mandujs/core";
+
+// API 핸들러 생성
+const code = generateApiHandler(route);
+
+// Slot이 있는 API 핸들러
+const codeWithSlot = generateApiHandlerWithSlot(route);
+
+// Slot 로직 파일
+const slotCode = generateSlotLogic(route);
+```
+
+## Guard 모듈
+
+아키텍처 규칙 검사 및 자동 수정.
+
+```typescript
+import {
+  runGuardCheck,
+  runAutoCorrect,
+  GuardResult,
+  GuardViolation
+} from "@mandujs/core";
+
+// 검사 실행
+const result: GuardResult = await runGuardCheck(manifest, "./");
+
+if (!result.passed) {
+  result.violations.forEach((v: GuardViolation) => {
+    console.log(`${v.rule}: ${v.message}`);
+  });
+
+  // 자동 수정 실행
+  const corrected = await runAutoCorrect(result.violations, manifest, "./");
+  console.log("수정됨:", corrected.steps);
+  console.log("남은 위반:", corrected.remainingViolations);
+}
+```
+
+### Guard 규칙
+
+| 규칙 ID | 설명 | 자동 수정 |
+|---------|------|----------|
+| `SPEC_HASH_MISMATCH` | spec과 lock 해시 불일치 | ✅ |
+| `GENERATED_MANUAL_EDIT` | generated 파일 수동 수정 | ✅ |
+| `HANDLER_NOT_FOUND` | 핸들러 파일 없음 | ❌ |
+| `COMPONENT_NOT_FOUND` | 컴포넌트 파일 없음 | ❌ |
+| `SLOT_NOT_FOUND` | slot 파일 없음 | ✅ |
+
+## Runtime 모듈
+
+서버 시작 및 라우팅.
+
+```typescript
+import {
+  startServer,
+  registerApiHandler,
+  registerPageLoader
+} from "@mandujs/core";
+
+// API 핸들러 등록
+registerApiHandler("getUsers", async (req) => {
+  return { users: [] };
+});
+
+// 페이지 로더 등록
+registerPageLoader("homePage", () => import("./pages/Home"));
+
+// 서버 시작
+const server = startServer(manifest, { port: 3000 });
+
+// 종료
+server.stop();
+```
+
+## Report 모듈
+
+Guard 결과 리포트 생성.
+
+```typescript
+import { buildGuardReport } from "@mandujs/core";
+
+const report = buildGuardReport(guardResult, lockPath);
+console.log(report);  // 포맷된 텍스트 리포트
+```
+
+## 타입
+
+```typescript
+import type {
+  RoutesManifest,
+  RouteSpec,
+  RouteKind,
+  SpecLock,
+  GuardResult,
+  GuardViolation,
+  GenerateResult,
+  AutoCorrectResult,
+} from "@mandujs/core";
+```
+
+## 요구 사항
+
+- Bun >= 1.0.0
+- React >= 18.0.0
+- Zod >= 3.0.0
+
+## 관련 패키지
+
+- [@mandujs/cli](https://www.npmjs.com/package/@mandujs/cli) - CLI 도구
+
+## 라이선스
+
+MIT

package/README.md

@@ -1,34 +1,36 @@
 # @mandujs/core
 
+> English | **[한국어](./README.ko.md)**
+
 Mandu Framework Core - Spec, Generator, Guard, Runtime
 
-## 설치
+## Installation
 
 ```bash
 bun add @mandujs/core
 ```
 
-> 일반적으로 `@mandujs/cli`를 통해 사용합니다. 직접 사용은 고급 사용 사례입니다.
+> Typically used through `@mandujs/cli`. Direct usage is for advanced use cases.
 
-## 모듈 구조
+## Module Structure
 
 ```
 @mandujs/core
-├── spec/      # Spec 스키마 및 로딩
-├── generator/ # 코드 생성
-├── guard/     # 아키텍처 검사 및 자동 수정
-├── runtime/   # 서버 및 라우터
-└── report/    # Guard 리포트 생성
+├── spec/      # Spec schema and loading
+├── generator/ # Code generation
+├── guard/     # Architecture checking and auto-correction
+├── runtime/   # Server and router
+└── report/    # Guard report generation
 ```
 
-## Spec 모듈
+## Spec Module
 
-라우트 manifest 스키마 정의 및 로딩.
+Route manifest schema definition and loading.
 
 ```typescript
 import { loadManifest, RoutesManifest, RouteSpec } from "@mandujs/core";
 
-// manifest 로드 및 검증
+// Load and validate manifest
 const result = await loadManifest("spec/routes.manifest.json");
 
 if (result.success && result.data) {
@@ -39,33 +41,33 @@ if (result.success && result.data) {
 }
 ```
 
-### Lock 파일
+### Lock File
 
 ```typescript
 import { writeLock, readLock } from "@mandujs/core";
 
-// lock 파일 쓰기
+// Write lock file
 const lock = await writeLock("spec/spec.lock.json", manifest);
 console.log(lock.routesHash);
 
-// lock 파일 읽기
+// Read lock file
 const existing = await readLock("spec/spec.lock.json");
 ```
 
-## Generator 모듈
+## Generator Module
 
-Spec 기반 코드 생성.
+Spec-based code generation.
 
 ```typescript
 import { generateRoutes, GenerateResult } from "@mandujs/core";
 
 const result: GenerateResult = await generateRoutes(manifest, "./");
 
-console.log("생성됨:", result.created);
-console.log("건너뜀:", result.skipped);  // 이미 존재하는 slot 파일
+console.log("Created:", result.created);
+console.log("Skipped:", result.skipped);  // Existing slot files
 ```
 
-### 템플릿 함수
+### Template Functions
 
 ```typescript
 import {
@@ -75,19 +77,19 @@ import {
   generatePageComponent
 } from "@mandujs/core";
 
-// API 핸들러 생성
+// Generate API handler
 const code = generateApiHandler(route);
 
-// Slot이 있는 API 핸들러
+// API handler with slot
 const codeWithSlot = generateApiHandlerWithSlot(route);
 
-// Slot 로직 파일
+// Slot logic file
 const slotCode = generateSlotLogic(route);
 ```
 
-## Guard 모듈
+## Guard Module
 
-아키텍처 규칙 검사 및 자동 수정.
+Architecture rule checking and auto-correction.
 
 ```typescript
 import {
@@ -97,7 +99,7 @@ import {
   GuardViolation
 } from "@mandujs/core";
 
-// 검사 실행
+// Run check
 const result: GuardResult = await runGuardCheck(manifest, "./");
 
 if (!result.passed) {
@@ -105,26 +107,26 @@ if (!result.passed) {
     console.log(`${v.rule}: ${v.message}`);
   });
 
-  // 자동 수정 실행
+  // Run auto-correction
   const corrected = await runAutoCorrect(result.violations, manifest, "./");
-  console.log("수정됨:", corrected.steps);
-  console.log("남은 위반:", corrected.remainingViolations);
+  console.log("Fixed:", corrected.steps);
+  console.log("Remaining violations:", corrected.remainingViolations);
 }
 ```
 
-### Guard 규칙
+### Guard Rules
 
-| 규칙 ID | 설명 | 자동 수정 |
-|---------|------|----------|
-| `SPEC_HASH_MISMATCH` | spec과 lock 해시 불일치 | ✅ |
-| `GENERATED_MANUAL_EDIT` | generated 파일 수동 수정 | ✅ |
-| `HANDLER_NOT_FOUND` | 핸들러 파일 없음 | ❌ |
-| `COMPONENT_NOT_FOUND` | 컴포넌트 파일 없음 | ❌ |
-| `SLOT_NOT_FOUND` | slot 파일 없음 | ✅ |
+| Rule ID | Description | Auto-correctable |
+|---------|-------------|------------------|
+| `SPEC_HASH_MISMATCH` | Spec and lock hash mismatch | ✅ |
+| `GENERATED_MANUAL_EDIT` | Manual edit to generated file | ✅ |
+| `HANDLER_NOT_FOUND` | Handler file not found | ❌ |
+| `COMPONENT_NOT_FOUND` | Component file not found | ❌ |
+| `SLOT_NOT_FOUND` | Slot file not found | ✅ |
 
-## Runtime 모듈
+## Runtime Module
 
-서버 시작 및 라우팅.
+Server startup and routing.
 
 ```typescript
 import {
@@ -133,33 +135,33 @@ import {
   registerPageLoader
 } from "@mandujs/core";
 
-// API 핸들러 등록
+// Register API handler
 registerApiHandler("getUsers", async (req) => {
   return { users: [] };
 });
 
-// 페이지 로더 등록
+// Register page loader
 registerPageLoader("homePage", () => import("./pages/Home"));
 
-// 서버 시작
+// Start server
 const server = startServer(manifest, { port: 3000 });
 
-// 종료
+// Stop
 server.stop();
 ```
 
-## Report 모듈
+## Report Module
 
-Guard 결과 리포트 생성.
+Guard result report generation.
 
 ```typescript
 import { buildGuardReport } from "@mandujs/core";
 
 const report = buildGuardReport(guardResult, lockPath);
-console.log(report);  // 포맷된 텍스트 리포트
+console.log(report);  // Formatted text report
 ```
 
-## 타입
+## Types
 
 ```typescript
 import type {
@@ -174,16 +176,16 @@ import type {
 } from "@mandujs/core";
 ```
 
-## 요구 사항
+## Requirements
 
 - Bun >= 1.0.0
 - React >= 18.0.0
 - Zod >= 3.0.0
 
-## 관련 패키지
+## Related Packages
 
-- [@mandujs/cli](https://www.npmjs.com/package/@mandujs/cli) - CLI 도구
+- [@mandujs/cli](https://www.npmjs.com/package/@mandujs/cli) - CLI tool
 
-## 라이선스
+## License
 
 MIT

package/package.json

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