@mandujs/core 0.12.1 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",
@@ -13,6 +13,12 @@
   "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"
   },
@@ -47,11 +53,5 @@
     "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"
   }
-}
+}

package/src/brain/architecture/analyzer.ts

@@ -46,22 +46,24 @@ export const DEFAULT_ARCHITECTURE_CONFIG: ArchitectureConfig = {
       description: "자동 생성 파일. 직접 수정 금지",
       readonly: true,
     },
-    "apps/server/": {
-      pattern: "apps/server/**",
-      description: "백엔드 로직",
+    ".mandu/generated/server/": {
+      pattern: ".mandu/generated/server/**",
+      description: "서버 생성 파일",
       allowedFiles: ["*.ts"],
+      readonly: true,
     },
-    "apps/web/": {
-      pattern: "apps/web/**",
-      description: "프론트엔드 컴포넌트",
+    ".mandu/generated/web/": {
+      pattern: ".mandu/generated/web/**",
+      description: "웹 생성 파일",
       allowedFiles: ["*.ts", "*.tsx"],
+      readonly: true,
     },
   },
   imports: [
     {
-      source: "apps/web/**",
+      source: ".mandu/generated/web/**",
       forbid: ["fs", "child_process", "path", "crypto"],
-      reason: "프론트엔드에서 Node.js 내장 모듈 사용 금지",
+      reason: "프론트엔드 생성 파일에서 Node.js 내장 모듈 사용 금지",
     },
     {
       source: "**/generated/**",
@@ -87,7 +89,7 @@ export const DEFAULT_ARCHITECTURE_CONFIG: ArchitectureConfig = {
     },
     {
       name: "app",
-      folders: ["apps/**"],
+      folders: ["app/**", "src/**"],
       canDependOn: ["spec", "generated"],
     },
   ],
@@ -173,9 +175,9 @@ export class ArchitectureAnalyzer {
   /**
    * 파일 위치 검증
    */
-  async checkLocation(request: CheckLocationRequest): Promise<CheckLocationResult> {
-    const violations: ArchitectureViolation[] = [];
-    const normalizedPath = this.toRelativePath(request.path);
+  async checkLocation(request: CheckLocationRequest): Promise<CheckLocationResult> {
+    const violations: ArchitectureViolation[] = [];
+    const normalizedPath = this.toRelativePath(request.path);
 
     // 1. readonly 폴더 검사
     for (const [key, rule] of Object.entries(this.config.folders || {})) {
@@ -288,14 +290,14 @@ export class ArchitectureAnalyzer {
   /**
    * Import 검증
    */
-  async checkImports(request: CheckImportRequest): Promise<CheckImportResult> {
+  async checkImports(request: CheckImportRequest): Promise<CheckImportResult> {
     const violations: Array<{
       import: string;
       reason: string;
       suggestion?: string;
     }> = [];
 
-    const normalizedSource = this.toRelativePath(request.sourceFile);
+    const normalizedSource = this.toRelativePath(request.sourceFile);
 
     for (const importPath of request.imports) {
       for (const rule of this.config.imports || []) {
@@ -368,7 +370,7 @@ export class ArchitectureAnalyzer {
   /**
    * 코드에서 import 문 추출
    */
-  private extractImports(content: string): string[] {
+  private extractImports(content: string): string[] {
     const imports: string[] = [];
 
     // ES6 import
@@ -385,15 +387,15 @@ export class ArchitectureAnalyzer {
     }
 
     return imports;
-  }
-
-  private toRelativePath(filePath: string): string {
-    const normalized = filePath.replace(/\\/g, "/");
-    if (path.isAbsolute(normalized)) {
-      return path.relative(this.rootDir, normalized).replace(/\\/g, "/");
-    }
-    return normalized;
-  }
+  }
+
+  private toRelativePath(filePath: string): string {
+    const normalized = filePath.replace(/\\/g, "/");
+    if (path.isAbsolute(normalized)) {
+      return path.relative(this.rootDir, normalized).replace(/\\/g, "/");
+    }
+    return normalized;
+  }
 
   /**
    * 폴더 스캔
@@ -449,7 +451,7 @@ export class ArchitectureAnalyzer {
    */
   private getImportSuggestion(importPath: string, sourceFile: string): string {
     if (importPath === "fs") {
-      if (sourceFile.includes("apps/web")) {
+      if (sourceFile.includes(".mandu/generated/web") || sourceFile.includes("client")) {
         return "프론트엔드에서는 fetch API를 사용하세요";
       }
       return "Bun.file() 또는 Bun.write()를 사용하세요";
@@ -513,7 +515,7 @@ ${JSON.stringify(this.config.folders, null, 2)}
       ]);
 
       // 응답에서 경로 추출 시도
-      const pathMatch = result.content.match(/(?:spec\/|apps\/|packages\/)[^\s,)]+/);
+      const pathMatch = result.content.match(/(?:spec\/|\.mandu\/|app\/|src\/|packages\/)[^\s,)]+/);
 
       return {
         suggestion: result.content,

package/src/brain/doctor/analyzer.ts

@@ -140,7 +140,7 @@ export function generateTemplatePatches(
     switch (violation.ruleId) {
       case GUARD_RULES.SPEC_HASH_MISMATCH?.id:
         patches.push({
-          file: "spec/spec.lock.json",
+          file: ".mandu/spec.lock.json",
           description: "Spec lock 파일 갱신",
           type: "command",
           command: "bunx mandu spec-upsert",

package/src/bundler/build.ts

@@ -3,18 +3,18 @@
  * Bun.build 기반 클라이언트 번들 빌드
  */
 
-import type { RoutesManifest, RouteSpec } from "../spec/schema";
-import { needsHydration, getRouteHydration } from "../spec/schema";
-import type {
-  BundleResult,
-  BundleOutput,
-  BundleManifest,
-  BundleStats,
-  BundlerOptions,
-} from "./types";
-import { HYDRATION } from "../constants";
-import path from "path";
-import fs from "fs/promises";
+import type { RoutesManifest, RouteSpec } from "../spec/schema";
+import { needsHydration, getRouteHydration } from "../spec/schema";
+import type {
+  BundleResult,
+  BundleOutput,
+  BundleManifest,
+  BundleStats,
+  BundlerOptions,
+} from "./types";
+import { HYDRATION } from "../constants";
+import path from "path";
+import fs from "fs/promises";
 
 /**
  * 빈 매니페스트 생성
@@ -282,7 +282,7 @@ function hydrateIslands() {
   for (const el of islands) {
     const id = el.getAttribute('data-mandu-island');
     const src = el.getAttribute('data-mandu-src');
-    const priority = el.getAttribute('data-mandu-priority') || '${HYDRATION.DEFAULT_PRIORITY}';
+    const priority = el.getAttribute('data-mandu-priority') || '${HYDRATION.DEFAULT_PRIORITY}';
 
     if (!id || !src) {
       console.warn('[Mandu] Island missing id or src:', el);
@@ -855,21 +855,21 @@ interface VendorBuildResult {
  * Vendor shim 번들 빌드
  * React, ReactDOM, ReactDOMClient를 각각의 shim으로 빌드
  */
-async function buildVendorShims(
-  outDir: string,
-  options: BundlerOptions
-): Promise<VendorBuildResult> {
-  const errors: string[] = [];
-  type VendorShimKey = "react" | "reactDom" | "reactDomClient" | "jsxRuntime" | "jsxDevRuntime";
-  const results: Record<VendorShimKey, string> = {
-    react: "",
-    reactDom: "",
-    reactDomClient: "",
-    jsxRuntime: "",
-    jsxDevRuntime: "",
-  };
-
-  const shims: Array<{ name: string; source: string; key: VendorShimKey }> = [
+async function buildVendorShims(
+  outDir: string,
+  options: BundlerOptions
+): Promise<VendorBuildResult> {
+  const errors: string[] = [];
+  type VendorShimKey = "react" | "reactDom" | "reactDomClient" | "jsxRuntime" | "jsxDevRuntime";
+  const results: Record<VendorShimKey, string> = {
+    react: "",
+    reactDom: "",
+    reactDomClient: "",
+    jsxRuntime: "",
+    jsxDevRuntime: "",
+  };
+
+  const shims: Array<{ name: string; source: string; key: VendorShimKey }> = [
     { name: "_react", source: generateReactShimSource(), key: "react" },
     { name: "_react-dom", source: generateReactDOMShimSource(), key: "reactDom" },
     { name: "_react-dom-client", source: generateReactDOMClientShimSource(), key: "reactDomClient" },
@@ -877,68 +877,68 @@ async function buildVendorShims(
     { name: "_jsx-dev-runtime", source: generateJsxDevRuntimeShimSource(), key: "jsxDevRuntime" },
   ];
 
-  const buildShim = async (
-    shim: { name: string; source: string; key: VendorShimKey }
-  ): Promise<{ key: VendorShimKey; outputPath?: string; error?: string }> => {
-    const srcPath = path.join(outDir, `${shim.name}.src.js`);
-    const outputName = `${shim.name}.js`;
-
-    try {
-      await Bun.write(srcPath, shim.source);
-
-      // _react.js는 external 없이 React 전체를 번들링
-      // _react-dom*, jsx-runtime은 react를 external로 처리하여 동일한 React 인스턴스 공유
-      let shimExternal: string[] = [];
-      if (shim.name === "_react-dom" || shim.name === "_react-dom-client") {
-        shimExternal = ["react"];
-      } else if (shim.name === "_jsx-runtime" || shim.name === "_jsx-dev-runtime") {
-        shimExternal = ["react"];
-      }
-
-      const result = await Bun.build({
-        entrypoints: [srcPath],
-        outdir: outDir,
-        naming: outputName,
-        minify: options.minify ?? process.env.NODE_ENV === "production",
-        sourcemap: options.sourcemap ? "external" : "none",
-        target: "browser",
-        external: shimExternal,
-        define: {
-          "process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV || "development"),
-          ...options.define,
-        },
-      });
-
-      await fs.unlink(srcPath).catch(() => {});
-
-      if (!result.success) {
-        return {
-          key: shim.key,
-          error: `[${shim.name}] ${result.logs.map((l) => l.message).join(", ")}`,
-        };
-      }
-
-      return {
-        key: shim.key,
-        outputPath: `/.mandu/client/${outputName}`,
-      };
-    } catch (error) {
-      await fs.unlink(srcPath).catch(() => {});
-      return {
-        key: shim.key,
-        error: `[${shim.name}] ${String(error)}`,
-      };
-    }
-  };
-
-  const buildResults = await Promise.all(shims.map((shim) => buildShim(shim)));
-  for (const result of buildResults) {
-    if (result.error) {
-      errors.push(result.error);
-    } else if (result.outputPath) {
-      results[result.key] = result.outputPath;
-    }
-  }
+  const buildShim = async (
+    shim: { name: string; source: string; key: VendorShimKey }
+  ): Promise<{ key: VendorShimKey; outputPath?: string; error?: string }> => {
+    const srcPath = path.join(outDir, `${shim.name}.src.js`);
+    const outputName = `${shim.name}.js`;
+
+    try {
+      await Bun.write(srcPath, shim.source);
+
+      // _react.js는 external 없이 React 전체를 번들링
+      // _react-dom*, jsx-runtime은 react를 external로 처리하여 동일한 React 인스턴스 공유
+      let shimExternal: string[] = [];
+      if (shim.name === "_react-dom" || shim.name === "_react-dom-client") {
+        shimExternal = ["react"];
+      } else if (shim.name === "_jsx-runtime" || shim.name === "_jsx-dev-runtime") {
+        shimExternal = ["react"];
+      }
+
+      const result = await Bun.build({
+        entrypoints: [srcPath],
+        outdir: outDir,
+        naming: outputName,
+        minify: options.minify ?? process.env.NODE_ENV === "production",
+        sourcemap: options.sourcemap ? "external" : "none",
+        target: "browser",
+        external: shimExternal,
+        define: {
+          "process.env.NODE_ENV": JSON.stringify(process.env.NODE_ENV || "development"),
+          ...options.define,
+        },
+      });
+
+      await fs.unlink(srcPath).catch(() => {});
+
+      if (!result.success) {
+        return {
+          key: shim.key,
+          error: `[${shim.name}] ${result.logs.map((l) => l.message).join(", ")}`,
+        };
+      }
+
+      return {
+        key: shim.key,
+        outputPath: `/.mandu/client/${outputName}`,
+      };
+    } catch (error) {
+      await fs.unlink(srcPath).catch(() => {});
+      return {
+        key: shim.key,
+        error: `[${shim.name}] ${String(error)}`,
+      };
+    }
+  };
+
+  const buildResults = await Promise.all(shims.map((shim) => buildShim(shim)));
+  for (const result of buildResults) {
+    if (result.error) {
+      errors.push(result.error);
+    } else if (result.outputPath) {
+      results[result.key] = result.outputPath;
+    }
+  }
 
   return {
     success: errors.length === 0,
@@ -1052,7 +1052,7 @@ function createBundleManifest(
     bundles[output.routeId] = {
       js: output.outputPath,
       dependencies: ["_runtime", "_react"],
-      priority: hydration?.priority || HYDRATION.DEFAULT_PRIORITY,
+      priority: hydration?.priority || HYDRATION.DEFAULT_PRIORITY,
     };
   }