eslint-plugin-barrel-rules 1.0.4 → 1.1.1

package/README.ko.md

@@ -3,7 +3,7 @@
 # **Advanced Barrel Pattern Enforcement for JavaScript/TypeScript Projects**
 
 <div align="center">
-  <img src="https://img.shields.io/badge/version-1.0.4-blue.svg" alt="Version"/>
+  <img src="https://img.shields.io/badge/version-1.1.1-blue.svg" alt="Version"/>
   <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"/>
   <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"/>
 </div>
@@ -23,7 +23,7 @@ NPM: [https://www.npmjs.com/package/eslint-plugin-barrel-rules](https://www.npmj
 **eslint-plugin-barrel-rules**는  
 JavaScript/TypeScript 프로젝트에서 Barrel Pattern(배럴 패턴)을 강제하고, 모듈 경계와 캡슐화를 보장하는 고급 ESLint 플러그인입니다.
 
-지정한 디렉토리(예: `src/domains/*`)의 내부 구현은  
+지정한 디렉토리(예: `src/domains/*`, `src/domains/cart`)의 내부 구현은  
 오직 해당 디렉토리의 **index(배럴) 파일**을 통해서만 접근할 수 있도록 강제합니다.  
 내부 파일을 직접 import하는 것을 차단하여  
 **모듈화, 추상화, 유지보수성, 확장성**을 극대화합니다.
@@ -32,10 +32,12 @@ JavaScript/TypeScript 프로젝트에서 Barrel Pattern(배럴 패턴)을 강제
 
 ## 지원 환경
 
-- ESLint 9 (Flat config, 현재 지원)
-  > ⚠️ ESLint 8 (구 config) 지원도 곧 추가될 예정입니다!
-- Node.js (ES2015+)
-- ES Modules (ESM) 지원
+- ESLint 9
+  > Flat config(eslint.config.js), TypeScript 지원 시 "typescript-eslint" config 사용 필요
+- ESLint 8
+  > Legacy config(.eslintrc.js), TypeScript 지원 시 "@typescript-eslint/parser"를 parser로 지정하고, "@typescript-eslint"를 plugin에 추가해야 함
+- Node.js (ES2015 이상)
+- ES 모듈, CommonJS 모듈 모두 지원
 
 ---
 
@@ -51,6 +53,22 @@ JavaScript/TypeScript 프로젝트에서 Barrel Pattern(배럴 패턴)을 강제
 
 ---
 
+## 규칙(Rules)
+
+1. **enforce-barrel-pattern**  
+   모듈 임포트 시 배럴 패턴(Barrel Pattern)을 강제합니다.  
+   지정한 배럴 파일을 통해서만 임포트가 가능하며, 내부 모듈에 직접 접근하는 것을 방지합니다.
+
+   - **옵션:**
+     - `paths`: 배럴 패턴으로 보호할 디렉토리 경로(`baseDir` 기준 상대경로)
+     - `baseDir` (선택): `paths` 해석 기준이 되는 디렉토리. 기본값은 ESLint 실행 위치입니다.
+
+2. **no-wildcard**  
+   `import * as foo from "module"`, `export * from "./module"`과 같은 와일드카드(네임스페이스) import/export를 금지합니다.  
+   트리쉐이킹 및 코드 명확성을 위해 반드시 개별(named) import/export만 허용합니다.
+
+---
+
 ## 설치
 
 ```bash
@@ -63,39 +81,81 @@ pnpm add -D eslint-plugin-barrel-rules
 
 ---
 
-## 사용법
+## Eslint8 사용법
+
+```js
+file(.eslintrc.js)
+
+module.exports = {
+  ...(any other options)
+  // 타입스크립트를 사용할 경우 "@typescript-eslint/parser", "@typescript-eslint"를 설치하고 설정해 주세요.
+  parser: "@typescript-eslint/parser",
+  plugins: ["@typescript-eslint", "barrel-rules"],
+  rules: {
+    "barrel-rules/enforce-barrel-pattern": [
+      "error",
+      {
+        // 배럴 파일로 보호할 디렉토리의 경로입니다. baseDir을 기준으로 상대 경로로 설정합니다.
+        paths: ["src/typescript/barrel/*", "src/javascript/barrel/*"],
+        // (옵션) 설정하지 않으면 기본값은 ESLint를 실행한 위치(작업 디렉토리)입니다.
+        // 예: `npx eslint .`처럼 실행하면, 실행 시점의 현재 디렉토리가 기본값이 됩니다.
+        baseDir: __dirname,
+      },
+    ],
+    // import * 또는 export * 금지
+    "barrel-rules/no-wildcard": ["error"],
+  },
+};
+```
+
+---
+
+## Eslint9 사용법
 
 ```js
+file(eslintrc.config.js);
+
+import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+import { globalIgnores } from "eslint/config";
+import barrelRules from "eslint-plugin-barrel-rules";
+// ESM에서 __dirname을 사용하기 위한 코드
 import { fileURLToPath } from "url";
 import path from "path";
-import { enforceBarrelPattern } from "eslint-plugin-barrel-rules";
-
-//ESM은 __dirname을 지원하지 않기에 직접 구현합니다.
+// 커스텀 __dirname 생성
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-
-export default [
+// 타입스크립트 사용 시 필요
+export default tseslint.config([
+  globalIgnores(["dist"]),
   {
+    // (다른 옵션들 추가 가능)
+    files: ["**/*.{ts,tsx}"],
+    extends: [js.configs.recommended, tseslint.configs.recommended],
+    languageOptions: {
+      ecmaVersion: 2020,
+    },
+    // barrel-rules 플러그인만 추가하면 됩니다.
     plugins: {
-      "barrel-rules": {
-        rules: {
-          "enforce-barrel-pattern": enforceBarrelPattern,
-        },
-      },
+      "barrel-rules": barrelRules,
     },
+    // barrel-rules에 대한 설정만 추가하면 됩니다.
     rules: {
       "barrel-rules/enforce-barrel-pattern": [
         "error",
         {
-          //Barrel Pattern을 강제할 디렉토리를 정의합니다(baseDir 기준으로 상대경로)
-          paths: ["src/domains/*"],
-          //paths들의 root경로를 지정합니다.
+          // 배럴 파일로 보호할 디렉토리의 경로입니다. baseDir을 기준으로 상대 경로로 설정합니다.
+          paths: ["src/typescript/barrel/*"],
+          // (옵션) 설정하지 않으면 기본값은 ESLint를 실행한 위치(작업 디렉토리)입니다.
+          // 예: `npx eslint .`처럼 실행하면, 실행 시점의 현재 디렉토리가 기본값이 됩니다.
           baseDir: __dirname,
         },
       ],
+      // import * 또는 export * 금지
+      "barrel-rules/no-wildcard": ["error"],
     },
   },
-];
+]);
 ```
 
 ---
@@ -114,16 +174,17 @@ import { Test } from "../domains/foo";
 
 ## 앞으로의 계획
 
-- 더 다양한 모듈 경계/추상화 관련 룰 추가 예정
-
-- **Alias/tsconfig 지원**  
-  TypeScript `paths`, Vite `resolve.alias` 등 다양한 경로 매핑 완벽 지원 예정
-
-- **Commonjs 지원**
+- 더 다양한 모듈 경계/추상화 관련 룰 추가 예정 (~Ing)
+- Alias/tsconfig 지원: TypeScript의 paths, Vite의 resolve.alias, 기타 커스텀 경로 매핑을 완벽하게 지원 (~Ing)
+- **CJS 지원** (OK)
+- **ESLint 8 지원** (OK)
+- **번들 플러그인(플러그인 내 모든 기능 통합)** (OK)
+- **잘못된 경로 설정 검증 기능** (OK)
+- **와일드카드 import/export 제한 규칙** (OK)
 
 ---
 
 ## 문의
 
 질문, 제안, 버그 리포트, 기여 모두 환영합니다!  
-[[📬 send mail]](mailto:lhsung98@naver.com)
+[[📬 send mail lhsung98@naver.com]](mailto:lhsung98@naver.com)

package/README.md

@@ -3,7 +3,7 @@
 # **Advanced Barrel Pattern Enforcement for JavaScript/TypeScript Projects**
 
 <div align="center">
-  <img src="https://img.shields.io/badge/version-1.0.4-blue.svg" alt="Version"/>
+  <img src="https://img.shields.io/badge/version-1.1.1-blue.svg" alt="Version"/>
   <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"/>
   <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"/>
 </div>
@@ -26,7 +26,7 @@ NPM: [https://www.npmjs.com/package/eslint-plugin-barrel-rules](https://www.npmj
 that enforces the Barrel Pattern in JavaScript/TypeScript projects,  
 ensuring strict module boundaries and encapsulation.
 
-You can specify directories (e.g., `src/domains/*`) where  
+You can specify directories (e.g., `src/domains/*`, `src/domains/cart`) where  
 internal implementation details must only be accessed via the directory’s **index (barrel) file**.  
 Direct imports from internal files are blocked, maximizing  
 **modularity, abstraction, maintainability, and scalability**.
@@ -35,10 +35,12 @@ Direct imports from internal files are blocked, maximizing
 
 ## Supports
 
-- ESLint 9 (Flat config, currently supported)
-  > ⚠️ ESLint 8 (legacy config) support is planned for a future release!
+- ESLint 9
+  > Flat config(eslint.config.js), for TypeScript support, use the "typescript-eslint" config
+- ESLint 8
+  > Legacy config(.eslintrc.js), for TypeScript support, set "@typescript-eslint/parser" as the parser and add "@typescript-eslint" as a plugin
 - Node.js (ES2015+)
-- Supports ES Modules (ESM)
+- Supports both ES Modules and CommonJS
 
 ---
 
@@ -54,6 +56,22 @@ Direct imports from internal files are blocked, maximizing
 
 ---
 
+## Rules
+
+1. **enforce-barrel-pattern**  
+   Enforces the barrel pattern for module imports.  
+   Only allows imports from designated barrel files and prevents direct access to internal modules.
+
+   - **Options:**
+     - `paths`: The directories to be protected by the barrel pattern (relative to `baseDir`).
+     - `baseDir` (optional): The base directory for resolving `paths`. Defaults to the ESLint execution directory.
+
+2. **no-wildcard**  
+   Disallows wildcard (namespace) imports such as `import * as foo from "module"`, `export * from "./module"`
+   Forces you to use named imports for better tree-shaking and code clarity.
+
+---
+
 ## Install
 
 ```bash
@@ -66,39 +84,81 @@ pnpm add -D eslint-plugin-barrel-rules
 
 ---
 
-## Usage
+## Eslint8 Usage
+
+```js
+file(.eslintrc.js)
+
+module.exports = {
+  ...(any other options)
+  //if you use typescript, needs "@typescript-eslint/parser", "@typescript-eslint" install and setup plz..
+  parser: "@typescript-eslint/parser",
+  plugins: ["@typescript-eslint", "barrel-rules"],
+  rules: {
+    "barrel-rules/enforce-barrel-pattern": [
+      "error",
+      {
+        // The path to the directory that should be protected by using a barrel file. This path is relative to baseDir.
+        paths: ["src/typescript/barrel/*", "src/javascript/barrel/*"],
+        // Optional config. The default value is the directory where ESLint is executed.
+// For example, if you run `npx eslint .`, the default will be the current working directory at the time of execution.
+        baseDir: __dirname,
+      },
+    ],
+    // Disallow wildcard (namespace) import/export.
+    "barrel-rules/no-wildcard": ["error"],
+  },
+};
+```
+
+---
+
+## Eslint9 Usage
 
 ```js
+file(eslintrc.config.js);
+
+import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+import { globalIgnores } from "eslint/config";
+import barrelRules from "eslint-plugin-barrel-rules";
+//for __dirname in ESM
 import { fileURLToPath } from "url";
 import path from "path";
-import { enforceBarrelPattern } from "eslint-plugin-barrel-rules";
-
-//ESM not support __dirname(custom __dirname)
+//custom __dirname
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-
-export default [
+//typescript-config (if you use typescript, needs it)
+export default tseslint.config([
+  globalIgnores(["dist"]),
   {
+    ...(any other options)
+    files: ["**/*.{ts,tsx}"],
+    extends: [js.configs.recommended, tseslint.configs.recommended],
+    languageOptions: {
+      ecmaVersion: 2020,
+    },
+    //just set barrle-rules plugin
     plugins: {
-      "barrel-rules": {
-        rules: {
-          "enforce-barrel-pattern": enforceBarrelPattern,
-        },
-      },
+      "barrel-rules": barrelRules,
     },
+    //just set your setting for barrel-rules
     rules: {
       "barrel-rules/enforce-barrel-pattern": [
         "error",
         {
-          //Enforced directories
-          paths: ["src/domains/*"],
-          //BaseDir(root path, mutable)
+          // The path to the directory that should be protected by using a barrel file. This path is relative to baseDir.
+          paths: ["src/typescript/barrel/*"],
+          // Optional config. The default value is the directory where ESLint is executed.
+          // For example, if you run `npx eslint .`, the default will be the current working directory at the time of execution.
           baseDir: __dirname,
         },
       ],
+      // Disallow wildcard (namespace) import/export.
+      "barrel-rules/no-wildcard": ["error"],
     },
   },
-];
+]);
 ```
 
 ---
@@ -117,16 +177,21 @@ import { Test } from "../domains/foo";
 
 ## Future Work
 
-- More rules for module boundaries and abstraction
+- More rules for module boundaries and abstraction (~Ing)
 
 - **Alias/tsconfig Support**  
-  Fully supports TypeScript `paths`, Vite `resolve.alias`, and other custom path mappings
+  Fully supports TypeScript `paths`, Vite `resolve.alias`, and other custom path mappings (~Ing)
 
-- **CJS Support**
+- **CJS Support** (OK)
+- **Eslint8 Support** (OK)
+- **Bundle Plugin(capsure any features in plugin)**
+  (OK)
+- **Wrong Path Setup Validator** (OK)
+- **Wildcard Import/Export Protection Rule** (OK)
 
 ---
 
 ## Contact
 
 Questions, suggestions, bug reports, and contributions are welcome!  
-[[📬 send mail]](mailto:lhsung98@naver.com)
+[[📬 send mail lhsung98@naver.com]](mailto:lhsung98@naver.com)

package/dist/index.cjs

@@ -30,7 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  enforceBarrelPattern: () => enforceBarrelPattern
+  default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -52,6 +52,7 @@ var enforceBarrelPattern = {
           paths: { type: "array", items: { type: "string" } },
           baseDir: { type: "string" }
         },
+        required: ["paths"],
         additionalProperties: false
       }
     ],
@@ -131,7 +132,49 @@ var enforceBarrelPattern = {
     };
   }
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  enforceBarrelPattern
-});
+
+// src/rules/no-wildcard.ts
+var import_utils2 = require("@typescript-eslint/utils");
+var noWildcard = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Wildcard (namespace) import is not allowed."
+    },
+    schema: [],
+    messages: {
+      NoWildcardImport: "Wildcard import (`import * as ... from ...`) is not allowed. Please use named imports instead.",
+      NoExportAll: "Export all (`export * from ...`) is not allowed. Please use named exports instead."
+    }
+  },
+  defaultOptions: [],
+  create(context) {
+    return {
+      ImportDeclaration(node) {
+        const hasNamespaceImport = node.specifiers.some(
+          (specifier) => specifier.type === "ImportNamespaceSpecifier"
+        );
+        if (hasNamespaceImport) {
+          context.report({
+            node,
+            messageId: "NoWildcardImport"
+          });
+        }
+      },
+      ExportAllDeclaration(node) {
+        context.report({
+          node,
+          messageId: "NoExportAll"
+        });
+      }
+    };
+  }
+};
+
+// src/index.ts
+var rules = {
+  "enforce-barrel-pattern": enforceBarrelPattern,
+  "no-wildcard": noWildcard
+};
+var index_default = { rules };
+module.exports = { rules };

package/dist/index.d.cts

@@ -1,10 +1,13 @@
-import { RuleModule } from '@typescript-eslint/utils/ts-eslint';
+import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts-eslint';
 
-type Option = {
-    paths: string[];
-    baseDir: string;
+declare const _default: {
+    rules: {
+        "enforce-barrel-pattern": _typescript_eslint_utils_ts_eslint.RuleModule<"DirectImportDisallowed", {
+            paths: string[];
+            baseDir: string;
+        }[], unknown, _typescript_eslint_utils_ts_eslint.RuleListener>;
+        "no-wildcard": _typescript_eslint_utils_ts_eslint.RuleModule<"NoWildcardImport" | "NoExportAll", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener>;
+    };
 };
-type MessageIds = "DirectImportDisallowed";
-declare const enforceBarrelPattern: RuleModule<MessageIds, Option[]>;
 
-export { enforceBarrelPattern };
+export { _default as default };

package/dist/index.d.ts

@@ -1,10 +1,13 @@
-import { RuleModule } from '@typescript-eslint/utils/ts-eslint';
+import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts-eslint';
 
-type Option = {
-    paths: string[];
-    baseDir: string;
+declare const _default: {
+    rules: {
+        "enforce-barrel-pattern": _typescript_eslint_utils_ts_eslint.RuleModule<"DirectImportDisallowed", {
+            paths: string[];
+            baseDir: string;
+        }[], unknown, _typescript_eslint_utils_ts_eslint.RuleListener>;
+        "no-wildcard": _typescript_eslint_utils_ts_eslint.RuleModule<"NoWildcardImport" | "NoExportAll", [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener>;
+    };
 };
-type MessageIds = "DirectImportDisallowed";
-declare const enforceBarrelPattern: RuleModule<MessageIds, Option[]>;
 
-export { enforceBarrelPattern };
+export { _default as default };

package/dist/index.js

@@ -16,6 +16,7 @@ var enforceBarrelPattern = {
           paths: { type: "array", items: { type: "string" } },
           baseDir: { type: "string" }
         },
+        required: ["paths"],
         additionalProperties: false
       }
     ],
@@ -95,6 +96,52 @@ var enforceBarrelPattern = {
     };
   }
 };
+
+// src/rules/no-wildcard.ts
+import "@typescript-eslint/utils";
+var noWildcard = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Wildcard (namespace) import is not allowed."
+    },
+    schema: [],
+    messages: {
+      NoWildcardImport: "Wildcard import (`import * as ... from ...`) is not allowed. Please use named imports instead.",
+      NoExportAll: "Export all (`export * from ...`) is not allowed. Please use named exports instead."
+    }
+  },
+  defaultOptions: [],
+  create(context) {
+    return {
+      ImportDeclaration(node) {
+        const hasNamespaceImport = node.specifiers.some(
+          (specifier) => specifier.type === "ImportNamespaceSpecifier"
+        );
+        if (hasNamespaceImport) {
+          context.report({
+            node,
+            messageId: "NoWildcardImport"
+          });
+        }
+      },
+      ExportAllDeclaration(node) {
+        context.report({
+          node,
+          messageId: "NoExportAll"
+        });
+      }
+    };
+  }
+};
+
+// src/index.ts
+var rules = {
+  "enforce-barrel-pattern": enforceBarrelPattern,
+  "no-wildcard": noWildcard
+};
+var index_default = { rules };
+module.exports = { rules };
 export {
-  enforceBarrelPattern
+  index_default as default
 };

package/package.json

@@ -23,7 +23,7 @@
     "encapsulation directory",
     "enforce barrel pattern"
   ],
-  "version": "1.0.4",
+  "version": "1.1.1",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",