@mandujs/core 0.13.0 → 0.13.1

package/src/guard/contract-guard.ts

@@ -199,15 +199,15 @@ export async function checkContractSlotConsistency(
 /**
  * Run all contract-related guard checks
  */
-export async function runContractGuardCheck(
-  manifest: RoutesManifest,
-  rootDir: string
-): Promise<ContractViolation[]> {
-  const violations: ContractViolation[] = [];
-
-  // Check missing contracts (warning level)
-  const missingContracts = await checkMissingContract(manifest, rootDir);
-  violations.push(...missingContracts);
+export async function runContractGuardCheck(
+  manifest: RoutesManifest,
+  rootDir: string
+): Promise<ContractViolation[]> {
+  const violations: ContractViolation[] = [];
+
+  // Check missing contracts (warning level)
+  const missingContracts = await checkMissingContract(manifest, rootDir);
+  violations.push(...missingContracts);
 
   // Check contract file exists
   const notFoundContracts = await checkContractFileExists(manifest, rootDir);

package/src/guard/file-type.test.ts

@@ -1,24 +1,24 @@
-import { describe, it, expect } from "vitest";
-import { validateFileAnalysis } from "./validator";
-import { fsdPreset } from "./presets/fsd";
-import type { FileAnalysis, GuardConfig } from "./types";
-
-describe("TypeScript-only rule", () => {
-  const layers = fsdPreset.layers;
-  const config: GuardConfig = {
-    preset: "fsd",
-    severity: { fileType: "error" },
-  };
-
-  it("should flag .jsx files", () => {
-    const analysis: FileAnalysis = {
-      filePath: "src/pages/home.jsx",
-      layer: "pages",
-      imports: [],
-      analyzedAt: Date.now(),
-    };
-
-    const violations = validateFileAnalysis(analysis, layers, config);
-    expect(violations.some((v) => v.type === "file-type")).toBe(true);
-  });
-});
+import { describe, it, expect } from "vitest";
+import { validateFileAnalysis } from "./validator";
+import { fsdPreset } from "./presets/fsd";
+import type { FileAnalysis, GuardConfig } from "./types";
+
+describe("TypeScript-only rule", () => {
+  const layers = fsdPreset.layers;
+  const config: GuardConfig = {
+    preset: "fsd",
+    severity: { fileType: "error" },
+  };
+
+  it("should flag .jsx files", () => {
+    const analysis: FileAnalysis = {
+      filePath: "src/pages/home.jsx",
+      layer: "pages",
+      imports: [],
+      analyzedAt: Date.now(),
+    };
+
+    const violations = validateFileAnalysis(analysis, layers, config);
+    expect(violations.some((v) => v.type === "file-type")).toBe(true);
+  });
+});

package/src/guard/presets/atomic.ts

@@ -1,70 +1,70 @@
-/**
- * Atomic Design Preset
- *
- * UI 컴포넌트 아키텍처
- *
- * @see https://bradfrost.com/blog/post/atomic-web-design/
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * Atomic Design 레이어 계층 구조 (복잡 → 단순)
- */
-export const ATOMIC_HIERARCHY = [
-  "pages",
-  "templates",
-  "organisms",
-  "molecules",
-  "atoms",
-] as const;
-
-/**
- * Atomic Design 프리셋 정의
- */
-export const atomicPreset: PresetDefinition = {
-  name: "atomic",
-  description: "Atomic Design - UI 컴포넌트 아키텍처",
-
-  hierarchy: [...ATOMIC_HIERARCHY],
-
-  layers: [
-    {
-      name: "pages",
-      pattern: "src/components/pages/**",
-      canImport: ["templates", "organisms", "molecules", "atoms"],
-      description: "페이지 컴포넌트 (특정 콘텐츠가 있는 템플릿)",
-    },
-    {
-      name: "templates",
-      pattern: "src/components/templates/**",
-      canImport: ["organisms", "molecules", "atoms"],
-      description: "페이지 템플릿 (레이아웃 구조)",
-    },
-    {
-      name: "organisms",
-      pattern: "src/components/organisms/**",
-      canImport: ["molecules", "atoms"],
-      description: "복잡한 UI 블록 (Header, Footer, Form)",
-    },
-    {
-      name: "molecules",
-      pattern: "src/components/molecules/**",
-      canImport: ["atoms"],
-      description: "조합된 컴포넌트 (SearchInput, Card)",
-    },
-    {
-      name: "atoms",
-      pattern: "src/components/atoms/**",
-      canImport: [],
-      description: "기본 요소 (Button, Input, Text)",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "warn",
-    crossSliceDependency: "info",
-    deepNesting: "info",
-  },
-};
+/**
+ * Atomic Design Preset
+ *
+ * UI 컴포넌트 아키텍처
+ *
+ * @see https://bradfrost.com/blog/post/atomic-web-design/
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * Atomic Design 레이어 계층 구조 (복잡 → 단순)
+ */
+export const ATOMIC_HIERARCHY = [
+  "pages",
+  "templates",
+  "organisms",
+  "molecules",
+  "atoms",
+] as const;
+
+/**
+ * Atomic Design 프리셋 정의
+ */
+export const atomicPreset: PresetDefinition = {
+  name: "atomic",
+  description: "Atomic Design - UI 컴포넌트 아키텍처",
+
+  hierarchy: [...ATOMIC_HIERARCHY],
+
+  layers: [
+    {
+      name: "pages",
+      pattern: "src/components/pages/**",
+      canImport: ["templates", "organisms", "molecules", "atoms"],
+      description: "페이지 컴포넌트 (특정 콘텐츠가 있는 템플릿)",
+    },
+    {
+      name: "templates",
+      pattern: "src/components/templates/**",
+      canImport: ["organisms", "molecules", "atoms"],
+      description: "페이지 템플릿 (레이아웃 구조)",
+    },
+    {
+      name: "organisms",
+      pattern: "src/components/organisms/**",
+      canImport: ["molecules", "atoms"],
+      description: "복잡한 UI 블록 (Header, Footer, Form)",
+    },
+    {
+      name: "molecules",
+      pattern: "src/components/molecules/**",
+      canImport: ["atoms"],
+      description: "조합된 컴포넌트 (SearchInput, Card)",
+    },
+    {
+      name: "atoms",
+      pattern: "src/components/atoms/**",
+      canImport: [],
+      description: "기본 요소 (Button, Input, Text)",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "warn",
+    crossSliceDependency: "info",
+    deepNesting: "info",
+  },
+};

package/src/guard/presets/clean.ts

@@ -1,77 +1,77 @@
-/**
- * Clean Architecture Preset
- *
- * 백엔드 권장 아키텍처
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * Clean Architecture 레이어 계층 구조
- *
- * 의존성: 외부 → 내부 (domain이 핵심)
- */
-export const CLEAN_HIERARCHY = [
-  "api",
-  "infra",
-  "application",
-  "domain",
-  "core",
-  "shared",
-] as const;
-
-/**
- * Clean Architecture 프리셋 정의
- */
-export const cleanPreset: PresetDefinition = {
-  name: "clean",
-  description: "Clean Architecture - 백엔드 권장 아키텍처",
-
-  hierarchy: [...CLEAN_HIERARCHY],
-
-  layers: [
-    {
-      name: "api",
-      pattern: "src/**/api/**",
-      canImport: ["application", "core", "shared"],
-      description: "Controllers, Routes, DTOs",
-    },
-    {
-      name: "infra",
-      pattern: "src/**/infra/**",
-      canImport: ["application", "domain", "core", "shared"],
-      description: "Repositories 구현, 외부 API 클라이언트",
-    },
-    {
-      name: "application",
-      pattern: "src/**/application/**",
-      canImport: ["domain", "core", "shared"],
-      description: "Use Cases, Application Services",
-    },
-    {
-      name: "domain",
-      pattern: "src/**/domain/**",
-      canImport: ["shared"],
-      description: "Entities, Value Objects, Domain Services",
-    },
-    {
-      name: "core",
-      pattern: "src/core/**",
-      canImport: ["shared"],
-      description: "공통 핵심 (auth, config, errors)",
-    },
-    {
-      name: "shared",
-      pattern: "src/shared/**",
-      canImport: [],
-      description: "공유 유틸리티, 타입",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "error",
-    crossSliceDependency: "warn",
-    deepNesting: "info",
-  },
-};
+/**
+ * Clean Architecture Preset
+ *
+ * 백엔드 권장 아키텍처
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * Clean Architecture 레이어 계층 구조
+ *
+ * 의존성: 외부 → 내부 (domain이 핵심)
+ */
+export const CLEAN_HIERARCHY = [
+  "api",
+  "infra",
+  "application",
+  "domain",
+  "core",
+  "shared",
+] as const;
+
+/**
+ * Clean Architecture 프리셋 정의
+ */
+export const cleanPreset: PresetDefinition = {
+  name: "clean",
+  description: "Clean Architecture - 백엔드 권장 아키텍처",
+
+  hierarchy: [...CLEAN_HIERARCHY],
+
+  layers: [
+    {
+      name: "api",
+      pattern: "src/**/api/**",
+      canImport: ["application", "core", "shared"],
+      description: "Controllers, Routes, DTOs",
+    },
+    {
+      name: "infra",
+      pattern: "src/**/infra/**",
+      canImport: ["application", "domain", "core", "shared"],
+      description: "Repositories 구현, 외부 API 클라이언트",
+    },
+    {
+      name: "application",
+      pattern: "src/**/application/**",
+      canImport: ["domain", "core", "shared"],
+      description: "Use Cases, Application Services",
+    },
+    {
+      name: "domain",
+      pattern: "src/**/domain/**",
+      canImport: ["shared"],
+      description: "Entities, Value Objects, Domain Services",
+    },
+    {
+      name: "core",
+      pattern: "src/core/**",
+      canImport: ["shared"],
+      description: "공통 핵심 (auth, config, errors)",
+    },
+    {
+      name: "shared",
+      pattern: "src/shared/**",
+      canImport: [],
+      description: "공유 유틸리티, 타입",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "error",
+    crossSliceDependency: "warn",
+    deepNesting: "info",
+  },
+};

package/src/guard/presets/fsd.ts

@@ -1,79 +1,79 @@
-/**
- * FSD (Feature-Sliced Design) Preset
- *
- * 프론트엔드 권장 아키텍처
- *
- * @see https://feature-sliced.design/
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * FSD 레이어 계층 구조 (상위 → 하위)
- *
- * app → pages → widgets → features → entities → shared
- */
-export const FSD_HIERARCHY = [
-  "app",
-  "pages",
-  "widgets",
-  "features",
-  "entities",
-  "shared",
-] as const;
-
-/**
- * FSD 프리셋 정의
- */
-export const fsdPreset: PresetDefinition = {
-  name: "fsd",
-  description: "Feature-Sliced Design - 프론트엔드 권장 아키텍처",
-
-  hierarchy: [...FSD_HIERARCHY],
-
-  layers: [
-    {
-      name: "app",
-      pattern: "src/app/**",
-      canImport: ["pages", "widgets", "features", "entities", "shared"],
-      description: "앱 진입점, 프로바이더, 글로벌 스타일",
-    },
-    {
-      name: "pages",
-      pattern: "src/pages/**",
-      canImport: ["widgets", "features", "entities", "shared"],
-      description: "페이지 컴포넌트, 라우팅",
-    },
-    {
-      name: "widgets",
-      pattern: "src/widgets/**",
-      canImport: ["features", "entities", "shared"],
-      description: "독립적인 UI 블록 (Header, Sidebar 등)",
-    },
-    {
-      name: "features",
-      pattern: "src/features/**",
-      canImport: ["entities", "shared"],
-      description: "비즈니스 기능 (로그인, 결제 등)",
-    },
-    {
-      name: "entities",
-      pattern: "src/entities/**",
-      canImport: ["shared"],
-      description: "비즈니스 엔티티 (User, Product 등)",
-    },
-    {
-      name: "shared",
-      pattern: "src/shared/**",
-      canImport: [],
-      description: "공유 유틸, UI 컴포넌트, 라이브러리",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "warn",
-    crossSliceDependency: "warn",
-    deepNesting: "info",
-  },
-};
+/**
+ * FSD (Feature-Sliced Design) Preset
+ *
+ * 프론트엔드 권장 아키텍처
+ *
+ * @see https://feature-sliced.design/
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * FSD 레이어 계층 구조 (상위 → 하위)
+ *
+ * app → pages → widgets → features → entities → shared
+ */
+export const FSD_HIERARCHY = [
+  "app",
+  "pages",
+  "widgets",
+  "features",
+  "entities",
+  "shared",
+] as const;
+
+/**
+ * FSD 프리셋 정의
+ */
+export const fsdPreset: PresetDefinition = {
+  name: "fsd",
+  description: "Feature-Sliced Design - 프론트엔드 권장 아키텍처",
+
+  hierarchy: [...FSD_HIERARCHY],
+
+  layers: [
+    {
+      name: "app",
+      pattern: "src/app/**",
+      canImport: ["pages", "widgets", "features", "entities", "shared"],
+      description: "앱 진입점, 프로바이더, 글로벌 스타일",
+    },
+    {
+      name: "pages",
+      pattern: "src/pages/**",
+      canImport: ["widgets", "features", "entities", "shared"],
+      description: "페이지 컴포넌트, 라우팅",
+    },
+    {
+      name: "widgets",
+      pattern: "src/widgets/**",
+      canImport: ["features", "entities", "shared"],
+      description: "독립적인 UI 블록 (Header, Sidebar 등)",
+    },
+    {
+      name: "features",
+      pattern: "src/features/**",
+      canImport: ["entities", "shared"],
+      description: "비즈니스 기능 (로그인, 결제 등)",
+    },
+    {
+      name: "entities",
+      pattern: "src/entities/**",
+      canImport: ["shared"],
+      description: "비즈니스 엔티티 (User, Product 등)",
+    },
+    {
+      name: "shared",
+      pattern: "src/shared/**",
+      canImport: [],
+      description: "공유 유틸, UI 컴포넌트, 라이브러리",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "warn",
+    crossSliceDependency: "warn",
+    deepNesting: "info",
+  },
+};

package/src/guard/presets/hexagonal.ts

@@ -1,68 +1,68 @@
-/**
- * Hexagonal Architecture Preset
- *
- * 포트와 어댑터 패턴
- */
-
-import type { PresetDefinition } from "../types";
-
-/**
- * Hexagonal Architecture 레이어 계층 구조
- */
-export const HEXAGONAL_HIERARCHY = [
-  "adapters/in",
-  "adapters/out",
-  "application",
-  "ports",
-  "domain",
-] as const;
-
-/**
- * Hexagonal Architecture 프리셋 정의
- */
-export const hexagonalPreset: PresetDefinition = {
-  name: "hexagonal",
-  description: "Hexagonal Architecture - 포트와 어댑터 패턴",
-
-  hierarchy: [...HEXAGONAL_HIERARCHY],
-
-  layers: [
-    {
-      name: "adapters/in",
-      pattern: "src/adapters/in/**",
-      canImport: ["application", "ports"],
-      description: "Driving Adapters (Controllers, CLI, GraphQL)",
-    },
-    {
-      name: "adapters/out",
-      pattern: "src/adapters/out/**",
-      canImport: ["application", "ports"],
-      description: "Driven Adapters (Repositories, External APIs)",
-    },
-    {
-      name: "application",
-      pattern: "src/application/**",
-      canImport: ["domain", "ports"],
-      description: "Use Cases, Application Services",
-    },
-    {
-      name: "ports",
-      pattern: "src/ports/**",
-      canImport: ["domain"],
-      description: "Port Interfaces (입출력 계약)",
-    },
-    {
-      name: "domain",
-      pattern: "src/domain/**",
-      canImport: [],
-      description: "Pure Business Logic (외부 의존 없음)",
-    },
-  ],
-
-  defaultSeverity: {
-    layerViolation: "error",
-    circularDependency: "error",
-    crossSliceDependency: "warn",
-    deepNesting: "info",
-  },
-};
+/**
+ * Hexagonal Architecture Preset
+ *
+ * 포트와 어댑터 패턴
+ */
+
+import type { PresetDefinition } from "../types";
+
+/**
+ * Hexagonal Architecture 레이어 계층 구조
+ */
+export const HEXAGONAL_HIERARCHY = [
+  "adapters/in",
+  "adapters/out",
+  "application",
+  "ports",
+  "domain",
+] as const;
+
+/**
+ * Hexagonal Architecture 프리셋 정의
+ */
+export const hexagonalPreset: PresetDefinition = {
+  name: "hexagonal",
+  description: "Hexagonal Architecture - 포트와 어댑터 패턴",
+
+  hierarchy: [...HEXAGONAL_HIERARCHY],
+
+  layers: [
+    {
+      name: "adapters/in",
+      pattern: "src/adapters/in/**",
+      canImport: ["application", "ports"],
+      description: "Driving Adapters (Controllers, CLI, GraphQL)",
+    },
+    {
+      name: "adapters/out",
+      pattern: "src/adapters/out/**",
+      canImport: ["application", "ports"],
+      description: "Driven Adapters (Repositories, External APIs)",
+    },
+    {
+      name: "application",
+      pattern: "src/application/**",
+      canImport: ["domain", "ports"],
+      description: "Use Cases, Application Services",
+    },
+    {
+      name: "ports",
+      pattern: "src/ports/**",
+      canImport: ["domain"],
+      description: "Port Interfaces (입출력 계약)",
+    },
+    {
+      name: "domain",
+      pattern: "src/domain/**",
+      canImport: [],
+      description: "Pure Business Logic (외부 의존 없음)",
+    },
+  ],
+
+  defaultSeverity: {
+    layerViolation: "error",
+    circularDependency: "error",
+    crossSliceDependency: "warn",
+    deepNesting: "info",
+  },
+};