@mandujs/core 0.54.32 → 0.55.0-beta.1

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/fs-routes-policy.ts

@@ -1,51 +1,51 @@
-import type { FSRoutesGuardConfig } from "./types";
-
-export const DEFAULT_FS_ROUTES_GUARD_POLICY: FSRoutesGuardConfig = {
-  noPageToPage: true,
-  pageCanImport: [
-    "client/pages",
-    "client/widgets",
-    "client/features",
-    "client/entities",
-    "client/shared",
-    "shared/contracts",
-    "shared/types",
-    "shared/utils/client",
-  ],
-  layoutCanImport: [
-    "client/app",
-    "client/widgets",
-    "client/shared",
-    "shared/contracts",
-    "shared/types",
-    "shared/utils/client",
-  ],
-  routeCanImport: [
-    "server/api",
-    "server/application",
-    "server/domain",
-    "server/infra",
-    "server/core",
-    "shared/contracts",
-    "shared/schema",
-    "shared/types",
-    "shared/utils/client",
-    "shared/utils/server",
-    "shared/env",
-  ],
-};
-
-function clonePolicy(policy: FSRoutesGuardConfig): FSRoutesGuardConfig {
-  return {
-    noPageToPage: policy.noPageToPage,
-    pageCanImport: policy.pageCanImport ? [...policy.pageCanImport] : undefined,
-    layoutCanImport: policy.layoutCanImport ? [...policy.layoutCanImport] : undefined,
-    routeCanImport: policy.routeCanImport ? [...policy.routeCanImport] : undefined,
-  };
-}
-
-export function getDefaultFsRoutesGuardPolicy(
-  enabled: boolean
-): FSRoutesGuardConfig | undefined {
-  return enabled ? clonePolicy(DEFAULT_FS_ROUTES_GUARD_POLICY) : undefined;
-}
+import type { FSRoutesGuardConfig } from "./types";
+
+export const DEFAULT_FS_ROUTES_GUARD_POLICY: FSRoutesGuardConfig = {
+  noPageToPage: true,
+  pageCanImport: [
+    "client/pages",
+    "client/widgets",
+    "client/features",
+    "client/entities",
+    "client/shared",
+    "shared/contracts",
+    "shared/types",
+    "shared/utils/client",
+  ],
+  layoutCanImport: [
+    "client/app",
+    "client/widgets",
+    "client/shared",
+    "shared/contracts",
+    "shared/types",
+    "shared/utils/client",
+  ],
+  routeCanImport: [
+    "server/api",
+    "server/application",
+    "server/domain",
+    "server/infra",
+    "server/core",
+    "shared/contracts",
+    "shared/schema",
+    "shared/types",
+    "shared/utils/client",
+    "shared/utils/server",
+    "shared/env",
+  ],
+};
+
+function clonePolicy(policy: FSRoutesGuardConfig): FSRoutesGuardConfig {
+  return {
+    noPageToPage: policy.noPageToPage,
+    pageCanImport: policy.pageCanImport ? [...policy.pageCanImport] : undefined,
+    layoutCanImport: policy.layoutCanImport ? [...policy.layoutCanImport] : undefined,
+    routeCanImport: policy.routeCanImport ? [...policy.routeCanImport] : undefined,
+  };
+}
+
+export function getDefaultFsRoutesGuardPolicy(
+  enabled: boolean
+): FSRoutesGuardConfig | undefined {
+  return enabled ? clonePolicy(DEFAULT_FS_ROUTES_GUARD_POLICY) : undefined;
+}

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/index.ts

@@ -120,17 +120,17 @@ export {
 // Architecture Guard - Watcher
 // ═══════════════════════════════════════════════════════════════════════════
 
-export {
-  createGuardWatcher,
-  checkFile,
-  checkDirectory,
-  clearAnalysisCache,
-} from "./watcher";
-
-export {
-  DEFAULT_FS_ROUTES_GUARD_POLICY,
-  getDefaultFsRoutesGuardPolicy,
-} from "./fs-routes-policy";
+export {
+  createGuardWatcher,
+  checkFile,
+  checkDirectory,
+  clearAnalysisCache,
+} from "./watcher";
+
+export {
+  DEFAULT_FS_ROUTES_GUARD_POLICY,
+  getDefaultFsRoutesGuardPolicy,
+} from "./fs-routes-policy";
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Architecture Guard - Presets

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