@mandujs/core 0.53.2 → 0.54.0

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

@@ -1,24 +1,24 @@
-import { describe, it, expect } from "bun:test";
-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 "bun:test";
+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/graph.ts

@@ -34,7 +34,7 @@
 
 import { existsSync } from "fs";
 import { relative, resolve, sep, isAbsolute, dirname, extname } from "path";
-
+
 import type {
   GuardConfig,
   LayerDefinition,

package/src/guard/healing.ts

@@ -22,16 +22,16 @@
  * ```
  */
 
-import { readFile, writeFile, mkdir, unlink } from "fs/promises";
-import { existsSync } from "fs";
-import { dirname, join, extname, resolve, normalize } from "path";
-import type {
-  Violation,
-  ViolationType,
-  GuardConfig,
-  GuardPreset,
-} from "./types";
-import { getDocumentationLink } from "./suggestions";
+import { readFile, writeFile, mkdir, unlink } from "fs/promises";
+import { existsSync } from "fs";
+import { dirname, join, extname, resolve, normalize } from "path";
+import type {
+  Violation,
+  ViolationType,
+  GuardConfig,
+  GuardPreset,
+} from "./types";
+import { getDocumentationLink } from "./suggestions";
 import { checkDirectory } from "./watcher";
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -324,13 +324,13 @@ function generateHealingOptions(
 /**
  * 레이어 위반 옵션 생성
  */
-function generateLayerViolationOptions(
-  violation: Violation,
-  _config: GuardConfig,
-  rootDir: string
-): HealingOption[] {
-  const options: HealingOption[] = [];
-  const { filePath, importPath, importStatement, toLayer, allowedLayers } = violation;
+function generateLayerViolationOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  rootDir: string
+): HealingOption[] {
+  const options: HealingOption[] = [];
+  const { filePath, importPath, importStatement, toLayer, allowedLayers } = violation;
 
   const targetModule = extractModuleName(importPath);
 
@@ -406,15 +406,15 @@ function generateLayerViolationOptions(
 /**
  * 순환 의존 옵션 생성
  */
-function generateCircularDependencyOptions(
-  violation: Violation,
-  _config: GuardConfig,
-  _rootDir: string
-): HealingOption[] {
-  const options: HealingOption[] = [];
-  const { fromLayer, toLayer } = violation;
-
-  // 옵션 1: 공통 코드를 shared로 추출
+function generateCircularDependencyOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  _rootDir: string
+): HealingOption[] {
+  const options: HealingOption[] = [];
+  const { fromLayer, toLayer } = violation;
+
+  // 옵션 1: 공통 코드를 shared로 추출
   options.push({
     label: "공통 코드를 shared로 추출",
     explanation: `${fromLayer}와 ${toLayer}가 공유하는 코드를 shared 레이어로 이동하세요.`,
@@ -441,11 +441,11 @@ function generateCircularDependencyOptions(
 /**
  * Cross-slice 옵션 생성
  */
-function generateCrossSliceOptions(
-  violation: Violation,
-  _config: GuardConfig,
-  _rootDir: string
-): HealingOption[] {
+function generateCrossSliceOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  _rootDir: string
+): HealingOption[] {
   const options: HealingOption[] = [];
   const { fromLayer, importPath } = violation;
 
@@ -478,11 +478,11 @@ function generateCrossSliceOptions(
 /**
  * 깊은 중첩 옵션 생성
  */
-function generateDeepNestingOptions(
-  violation: Violation,
-  _config: GuardConfig,
-  _rootDir: string
-): HealingOption[] {
+function generateDeepNestingOptions(
+  violation: Violation,
+  _config: GuardConfig,
+  _rootDir: string
+): HealingOption[] {
   const options: HealingOption[] = [];
   const { filePath, importPath, importStatement } = violation;
 

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",
+  },
+};