@yasainet/eslint 0.0.29 → 0.0.31

package/README.md

@@ -10,6 +10,34 @@ Shared ESLint configuration for Next.js, Node.js and Deno.
 | `@yasainet/eslint/node` | `scripts/features/`            | Common rules only (WIP) |
 | `@yasainet/eslint/deno` | `supabase/functions/features/` | Common rules only (WIP) |
 
+## Directory Structure
+
+```text
+src/
+├── common/   # Shared rules for all environments
+├── next/     # Next.js-specific rules (hooks, components, directives)
+├── node/     # Node.js entry point (common rules only)
+└── deno/     # Deno entry point (entry-point boundary, _utils boundary, _lib boundary)
+```
+
+Each entry point enforces a feature-based architecture with the following convention in consuming projects:
+
+```text
+{featureRoot}/
+├── {feature}/
+│   ├── actions/        # *.action.ts — entry points (handleXxx)
+│   ├── services/       # *.service.ts — business logic
+│   ├── repositories/   # *.repo.ts — data access
+│   ├── types/          # *.type.ts
+│   ├── schemas/        # *.schema.ts
+│   ├── utils/          # *.util.ts
+│   └── constants/      # *.constant.ts
+├── shared/             # Cross-feature shared modules
+├── ...
+{libRoot}/              # *.lib.ts — library wrappers (e.g., supabase.lib.ts)
+{utilsRoot}/            # *.util.ts — top-level utilities
+```
+
 ## Setup
 
 ### Next.js + Node.js + Deno

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasainet/eslint",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "ESLint",
   "type": "module",
   "exports": {

package/src/common/entry-points.mjs

@@ -0,0 +1,20 @@
+/** Ban `import * as` at entry points. */
+export function createEntryPointConfigs(entryPointFiles, entryPointIgnores = []) {
+  return [
+    {
+      name: "entry-points/no-namespace-import",
+      files: entryPointFiles,
+      ignores: entryPointIgnores,
+      rules: {
+        "no-restricted-syntax": [
+          "error",
+          {
+            selector: "ImportDeclaration:has(ImportNamespaceSpecifier)",
+            message:
+              "Entry points must use named imports instead of `import * as`. This makes dependencies explicit.",
+          },
+        ],
+      },
+    },
+  ];
+}

package/src/common/index.mjs

@@ -2,7 +2,7 @@ import { generatePrefixLibMapping } from "./constants.mjs";
 import { createImportsConfigs } from "./imports.mjs";
 import { createJsdocConfigs } from "./jsdoc.mjs";
 import { createLayersConfigs } from "./layers.mjs";
-import { createLibNamingConfigs, createNamingConfigs } from "./naming.mjs";
+import { createLibNamingConfigs, createNamingConfigs, createUtilsNamingConfigs } from "./naming.mjs";
 import { rulesConfigs } from "./rules.mjs";
 
 /** Build common configs scoped to the given feature root. */
@@ -15,6 +15,7 @@ export function createCommonConfigs(
     ...rulesConfigs,
     ...createNamingConfigs(featureRoot, prefixLibMapping),
     ...createLibNamingConfigs(featureRoot),
+    ...createUtilsNamingConfigs(featureRoot),
     ...createLayersConfigs(featureRoot),
     ...createImportsConfigs(featureRoot, prefixLibMapping, { banAliasImports }),
     ...createJsdocConfigs(featureRoot),

package/src/common/naming.mjs

@@ -21,6 +21,25 @@ export function createLibNamingConfigs(featureRoot) {
   ];
 }
 
+/** Scope utils naming rules to the utils root derived from the given feature root. */
+export function createUtilsNamingConfigs(featureRoot) {
+  const utilsRoot = featureRoot.replace(/features$/, "utils");
+  return [
+    {
+      name: "naming/top-level-utils",
+      files: [`${utilsRoot}/**/*.ts`],
+      ignores: [`${utilsRoot}/**/*.type.ts`],
+      plugins: { "check-file": checkFile },
+      rules: {
+        "check-file/filename-naming-convention": [
+          "error",
+          { "**/*.ts": "*.util" },
+        ],
+      },
+    },
+  ];
+}
+
 /** Scope naming rules to the given feature root. */
 export function createNamingConfigs(featureRoot, prefixLibMapping) {
   const prefixes = Object.keys(prefixLibMapping);

package/src/deno/index.mjs

@@ -1,10 +1,17 @@
+import { createEntryPointConfigs } from "../common/entry-points.mjs";
 import { createCommonConfigs } from "../common/index.mjs";
 import { denoImportsConfigs } from "./imports.mjs";
 
 const FEATURE_ROOT = "supabase/functions/_features";
 
+const denoEntryPointConfigs = createEntryPointConfigs(
+  ["supabase/functions/**/*.ts"],
+  ["supabase/functions/_*/**"],
+);
+
 /** Deno ESLint flat config entry point. */
 export const eslintConfig = [
   ...createCommonConfigs(FEATURE_ROOT, { banAliasImports: true }),
   ...denoImportsConfigs,
+  ...denoEntryPointConfigs,
 ];

package/src/next/index.mjs

@@ -1,3 +1,4 @@
+import { createEntryPointConfigs } from "../common/entry-points.mjs";
 import { createCommonConfigs } from "../common/index.mjs";
 import { libBoundaryConfigs } from "../common/imports.mjs";
 
@@ -5,6 +6,10 @@ import { directivesConfigs } from "./directives.mjs";
 import { importPathStyleConfigs } from "./imports.mjs";
 import { namingConfigs } from "./naming.mjs";
 
+const nextEntryPointConfigs = createEntryPointConfigs(
+  ["src/app/**/*.ts", "src/app/**/*.tsx"],
+);
+
 /** Next.js ESLint flat config entry point. */
 export const eslintConfig = [
   ...createCommonConfigs("src/features"),
@@ -12,4 +17,5 @@ export const eslintConfig = [
   ...namingConfigs,
   ...directivesConfigs,
   ...importPathStyleConfigs,
+  ...nextEntryPointConfigs,
 ];

package/src/node/index.mjs

@@ -1,6 +1,12 @@
+import { createEntryPointConfigs } from "../common/entry-points.mjs";
 import { createCommonConfigs } from "../common/index.mjs";
 
+const nodeEntryPointConfigs = createEntryPointConfigs(
+  ["scripts/commands/*.ts"],
+);
+
 /** Node.js ESLint flat config entry point. */
 export const eslintConfig = [
   ...createCommonConfigs("scripts/features", { banAliasImports: true }),
+  ...nodeEntryPointConfigs,
 ];