@mandujs/core 0.12.0 → 0.12.1

package/README.ko.md

@@ -25,11 +25,16 @@ bun add @mandujs/core
 
 ```
 @mandujs/core
-├── spec/      # Spec 스키마 및 로딩
-├── generator/ # 코드 생성
+├── router/    # 파일 시스템 기반 라우팅
 ├── guard/     # 아키텍처 검사 및 자동 수정
-├── runtime/   # 서버 및 라우터
-└── report/    # Guard 리포트 생성
+├── runtime/   # 서버, SSR, 스트리밍
+├── filling/   # 핸들러 체인 API
+├── contract/  # 타입 안전 API 계약
+├── content/   # Content Layer - 빌드 타임 콘텐츠 로딩 🆕
+├── bundler/   # 클라이언트 번들링, HMR
+├── client/    # Island 하이드레이션, 클라이언트 라우터
+├── brain/     # Doctor, Watcher, 아키텍처 분석
+└── change/    # 트랜잭션 & 히스토리
 ```
 
 ## Spec 모듈
@@ -133,6 +138,73 @@ if (!result.passed) {
 | `COMPONENT_NOT_FOUND` | 컴포넌트 파일 없음 | ❌ |
 | `SLOT_NOT_FOUND` | slot 파일 없음 | ✅ |
 
+## Content Layer 🆕
+
+Astro에서 영감받은 빌드 타임 콘텐츠 로딩 시스템.
+
+```typescript
+// content.config.ts
+import { defineContentConfig, glob, file, api } from "@mandujs/core/content";
+import { z } from "zod";
+
+const postSchema = z.object({
+  title: z.string(),
+  date: z.coerce.date(),
+  tags: z.array(z.string()).default([]),
+});
+
+export default defineContentConfig({
+  collections: {
+    // Markdown 파일 (프론트매터 지원)
+    posts: {
+      loader: glob({ pattern: "content/posts/**/*.md" }),
+      schema: postSchema,
+    },
+    // 단일 JSON/YAML 파일
+    settings: {
+      loader: file({ path: "data/settings.json" }),
+    },
+    // 외부 API
+    products: {
+      loader: api({
+        url: "https://api.example.com/products",
+        cacheTTL: 3600,
+      }),
+    },
+  },
+});
+```
+
+### 콘텐츠 조회
+
+```typescript
+import { getCollection, getEntry } from "@mandujs/core/content";
+
+// 전체 컬렉션 조회
+const posts = await getCollection("posts");
+
+// 단일 엔트리 조회
+const post = await getEntry("posts", "hello-world");
+console.log(post?.data.title, post?.body);
+```
+
+### 내장 로더
+
+| 로더 | 설명 | 예시 |
+|------|------|------|
+| `file()` | 단일 파일 (JSON, YAML, TOML) | `file({ path: "data/config.json" })` |
+| `glob()` | 패턴 매칭 (Markdown, JSON) | `glob({ pattern: "content/**/*.md" })` |
+| `api()` | HTTP API (캐싱 지원) | `api({ url: "https://...", cacheTTL: 3600 })` |
+
+### 주요 기능
+
+- **Digest 기반 캐싱**: 변경된 파일만 재파싱
+- **Zod 검증**: 스키마 기반 타입 안전 콘텐츠
+- **프론트매터 지원**: Markdown YAML 프론트매터
+- **Dev 모드 감시**: 콘텐츠 변경 시 자동 리로드
+
+---
+
 ## Contract 모듈
 
 Zod 기반 계약(Contract) 정의 및 타입 안전 클라이언트 생성.
@@ -209,6 +281,11 @@ import type {
   GuardViolation,
   GenerateResult,
   AutoCorrectResult,
+  // Content Layer
+  DataEntry,
+  ContentConfig,
+  CollectionConfig,
+  Loader,
 } from "@mandujs/core";
 ```
 

package/README.md

@@ -81,6 +81,8 @@ const handlers = Mandu.handler(userContract, {
 ├── runtime/         # Server, SSR, streaming
 ├── filling/         # Handler chain API (Mandu.filling())
 ├── contract/        # Type-safe API contracts
+├── content/         # Content Layer - build-time content loading 🆕
+│   └── loaders      # file(), glob(), api() loaders
 ├── bundler/         # Client bundling, HMR
 ├── client/          # Island hydration, client router
 ├── brain/           # Doctor, Watcher, Architecture analyzer
@@ -453,6 +455,78 @@ function Navigation() {
 
 ---
 
+## Content Layer 🆕
+
+Astro-inspired build-time content loading system.
+
+```typescript
+// content.config.ts
+import { defineContentConfig, glob, file, api } from "@mandujs/core/content";
+import { z } from "zod";
+
+const postSchema = z.object({
+  title: z.string(),
+  date: z.coerce.date(),
+  tags: z.array(z.string()).default([]),
+});
+
+export default defineContentConfig({
+  collections: {
+    // Markdown files with frontmatter
+    posts: {
+      loader: glob({ pattern: "content/posts/**/*.md" }),
+      schema: postSchema,
+    },
+    // Single JSON/YAML file
+    settings: {
+      loader: file({ path: "data/settings.json" }),
+    },
+    // External API
+    products: {
+      loader: api({
+        url: "https://api.example.com/products",
+        headers: () => ({ Authorization: `Bearer ${process.env.API_KEY}` }),
+        cacheTTL: 3600,
+      }),
+    },
+  },
+});
+```
+
+### Querying Content
+
+```typescript
+import { getCollection, getEntry } from "@mandujs/core/content";
+
+// Get all entries
+const posts = await getCollection("posts");
+posts.forEach(post => {
+  console.log(post.id, post.data.title);
+});
+
+// Get single entry
+const post = await getEntry("posts", "hello-world");
+console.log(post?.data.title, post?.body);
+```
+
+### Built-in Loaders
+
+| Loader | Description | Example |
+|--------|-------------|---------|
+| `file()` | Single file (JSON, YAML, TOML) | `file({ path: "data/config.json" })` |
+| `glob()` | Pattern matching (Markdown, JSON) | `glob({ pattern: "content/**/*.md" })` |
+| `api()` | HTTP API with caching | `api({ url: "https://...", cacheTTL: 3600 })` |
+
+### Features
+
+- **Digest-based caching**: Only re-parse changed files
+- **Zod validation**: Type-safe content with schema validation
+- **Frontmatter support**: YAML frontmatter in Markdown files
+- **Dev mode watching**: Auto-reload on content changes
+- **Incremental updates**: Efficient builds with change detection
+
+---
+
 ## Brain (AI Assistant)
 
 Doctor and architecture analyzer.
@@ -551,6 +625,13 @@ import type {
 
   // Filling
   ManduContext,
+
+  // Content Layer
+  DataEntry,
+  ContentConfig,
+  CollectionConfig,
+  Loader,
+  LoaderContext,
 } from "@mandujs/core";
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",
@@ -13,12 +13,6 @@
   "files": [
     "src/**/*"
   ],
-  "scripts": {
-    "test": "bun test tests/streaming-ssr && bun test tests/hydration tests/typing src",
-    "test:hydration": "bun test tests/hydration",
-    "test:streaming": "bun test tests/streaming-ssr",
-    "test:watch": "bun test --watch"
-  },
   "devDependencies": {
     "@happy-dom/global-registrator": "^15.0.0"
   },
@@ -35,7 +29,7 @@
     "directory": "packages/core"
   },
   "author": "konamgil",
-  "license": "MIT",
+  "license": "MPL-2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -53,5 +47,11 @@
     "glob": "^13.0.0",
     "minimatch": "^10.1.1",
     "ollama": "^0.6.3"
+  },
+  "scripts": {
+    "test": "bun test tests/streaming-ssr && bun test tests/hydration tests/typing src",
+    "test:hydration": "bun test tests/hydration",
+    "test:streaming": "bun test tests/streaming-ssr",
+    "test:watch": "bun test --watch"
   }
-}
+}