@yasainet/eslint 0.0.73 → 0.0.75

package/src/deno/local-plugins/flat-entry-point.mjs

@@ -1,10 +1,9 @@
-/** Ensure Edge Function entry points are directly under supabase/functions/. */
 export const flatEntryPointRule = {
   meta: {
     type: "problem",
     messages: {
       nested:
-        "Edge Function entry points must be directly under supabase/functions/. Nested directories (e.g., commands/{{name}}) are not supported by Supabase CLI.",
+        "Edge Function の entry point は supabase/functions/ 直下に置く。ネストした directory (例 commands/{{name}}) は Supabase CLI 非対応。",
     },
     schema: [],
   },
@@ -18,14 +17,10 @@ export const flatEntryPointRule = {
         const relative = filename.slice(idx + "supabase/functions/".length);
         const segments = relative.split("/").filter(Boolean);
 
-        // _prefix directories are shared code, not entry points
         if (segments[0]?.startsWith("_")) return;
 
-        // Root-level files (deno.json, .env, etc.) are not entry points
         if (segments.length <= 1) return;
 
-        // Valid: <name>/index.ts (exactly 2 segments)
-        // Invalid: <name>/<nested>/index.ts (3+ segments)
         if (segments.length > 2) {
           context.report({
             node,

package/src/deno/local-plugins/index.mjs

@@ -1,6 +1,5 @@
 import { flatEntryPointRule } from "./flat-entry-point.mjs";
 
-/** Deno-specific local plugin (independent from common localPlugin). */
 export const denoLocalPlugin = {
   rules: {
     "flat-entry-point": flatEntryPointRule,

package/src/next/CLAUDE.md

@@ -0,0 +1,14 @@
+# src/next/CLAUDE.md
+
+Next.js 固有 rule の置き場所判断:
+
+- `boundaries/<surface>.mjs` — Next.js 固有の boundary (外界 → features の入口)
+  - 種類: page / route / sitemap / hooks / components / lib
+- `layers/<layer>.mjs` — Next.js 固有の layer
+  - 種類: components / hooks / layouts
+- `directives.mjs` — `"use server"` / `"use client"` 等の directive 制約
+- `imports.mjs` — Next.js 固有の import パターン
+- `tailwindcss.mjs` — Tailwind CSS rule (margin 禁止等)
+- `index.mjs` — Next.js entry。common の rule + 上記 file を合成
+
+Next.js entry 横断の共通 rule は `src/common/` に追加する。

package/src/next/boundaries/components.mjs

@@ -0,0 +1,36 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../../common/_internal/import-patterns.mjs";
+
+const COMPONENTS_BOUNDARY_PATTERNS = [
+  {
+    group: ["**/queries/*", "**/queries"],
+    message:
+      "components は queries を直接 import 不可。entries か hooks 経由で使う。",
+  },
+  {
+    group: ["**/services/*", "**/services"],
+    message:
+      "components は services を直接 import 不可。entries か hooks 経由で使う。",
+  },
+];
+
+export const componentsBoundaryConfigs = [
+  {
+    name: "imports/components-boundary",
+    files: ["src/components/**/*.{ts,tsx}"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            ...COMPONENTS_BOUNDARY_PATTERNS,
+            ...LIB_BOUNDARY_PATTERNS,
+            ...MAPPING_PATTERNS,
+          ],
+        },
+      ],
+    },
+  },
+];

package/src/next/boundaries/hooks.mjs

@@ -0,0 +1,36 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../../common/_internal/import-patterns.mjs";
+
+const HOOKS_BOUNDARY_PATTERNS = [
+  {
+    group: ["**/queries/*", "**/queries"],
+    message:
+      "hooks は queries を直接 import 不可。entries 経由で使う。",
+  },
+  {
+    group: ["**/services/*", "**/services"],
+    message:
+      "hooks は services を直接 import 不可。entries 経由で使う。",
+  },
+];
+
+export const hooksBoundaryConfigs = [
+  {
+    name: "imports/hooks-boundary",
+    files: ["src/features/**/hooks/*.ts"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            ...HOOKS_BOUNDARY_PATTERNS,
+            ...LIB_BOUNDARY_PATTERNS,
+            ...MAPPING_PATTERNS,
+          ],
+        },
+      ],
+    },
+  },
+];

package/src/next/boundaries/lib.mjs

@@ -0,0 +1,23 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../../common/_internal/import-patterns.mjs";
+
+export const libBoundaryConfigs = [
+  {
+    name: "imports/lib-boundary",
+    files: ["src/**/*.{ts,tsx}"],
+    ignores: [
+      "src/lib/**",
+      "src/proxy.ts",
+      "src/app/**/route.ts",
+      "src/features/**",
+    ],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        { patterns: [...LIB_BOUNDARY_PATTERNS, ...MAPPING_PATTERNS] },
+      ],
+    },
+  },
+];

package/src/next/boundaries/page.mjs

@@ -0,0 +1,36 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../../common/_internal/import-patterns.mjs";
+
+const PAGE_BOUNDARY_PATTERNS = [
+  {
+    group: ["**/queries/*", "**/queries"],
+    message:
+      "page.tsx は queries を直接 import 不可。entries 経由で使う。",
+  },
+  {
+    group: ["**/services/*", "**/services"],
+    message:
+      "page.tsx は services を直接 import 不可。entries 経由で使う。",
+  },
+];
+
+export const pageBoundaryConfigs = [
+  {
+    name: "imports/page-boundary",
+    files: ["src/app/**/page.tsx"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            ...PAGE_BOUNDARY_PATTERNS,
+            ...LIB_BOUNDARY_PATTERNS,
+            ...MAPPING_PATTERNS,
+          ],
+        },
+      ],
+    },
+  },
+];

package/src/next/boundaries/route.mjs

@@ -0,0 +1,36 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../../common/_internal/import-patterns.mjs";
+
+const ROUTE_BOUNDARY_PATTERNS = [
+  {
+    group: ["**/queries/*", "**/queries"],
+    message:
+      "route.ts は queries を直接 import 不可。entries 経由で使う。",
+  },
+  {
+    group: ["**/services/*", "**/services"],
+    message:
+      "route.ts は services を直接 import 不可。entries 経由で使う。",
+  },
+];
+
+export const routeBoundaryConfigs = [
+  {
+    name: "imports/route-boundary",
+    files: ["src/app/**/route.ts"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            ...ROUTE_BOUNDARY_PATTERNS,
+            ...LIB_BOUNDARY_PATTERNS,
+            ...MAPPING_PATTERNS,
+          ],
+        },
+      ],
+    },
+  },
+];

package/src/next/boundaries/sitemap.mjs

@@ -0,0 +1,36 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../../common/_internal/import-patterns.mjs";
+
+const SITEMAP_BOUNDARY_PATTERNS = [
+  {
+    group: ["**/queries/*", "**/queries"],
+    message:
+      "sitemap.ts は queries を直接 import 不可。entries 経由で使う。",
+  },
+  {
+    group: ["**/services/*", "**/services"],
+    message:
+      "sitemap.ts は services を直接 import 不可。entries 経由で使う。",
+  },
+];
+
+export const sitemapBoundaryConfigs = [
+  {
+    name: "imports/sitemap-boundary",
+    files: ["src/app/sitemap.ts", "src/app/**/sitemap.ts"],
+    rules: {
+      "no-restricted-imports": [
+        "error",
+        {
+          patterns: [
+            ...SITEMAP_BOUNDARY_PATTERNS,
+            ...LIB_BOUNDARY_PATTERNS,
+            ...MAPPING_PATTERNS,
+          ],
+        },
+      ],
+    },
+  },
+];

package/src/next/directives.mjs

@@ -1,4 +1,3 @@
-/** Enforce "use server" / "use client" directives per file convention. */
 export const directivesConfigs = [
   {
     name: "directives/server-entry",
@@ -10,7 +9,7 @@ export const directivesConfigs = [
           selector:
             "Program > :first-child:not(ExpressionStatement[expression.value='use server'])",
           message:
-            'entries/server.ts must start with "use server" directive.',
+            'entries/server.ts は先頭に "use server" directive が必須。',
         },
       ],
     },
@@ -25,7 +24,7 @@ export const directivesConfigs = [
           selector:
             "Program > :first-child:not(ExpressionStatement[expression.value='use server'])",
           message:
-            'entries/admin.ts must start with "use server" directive.',
+            'entries/admin.ts は先頭に "use server" directive が必須。',
         },
       ],
     },
@@ -39,7 +38,7 @@ export const directivesConfigs = [
         {
           selector: "ExpressionStatement[expression.value='use server']",
           message:
-            'entries/client.ts must NOT have "use server" directive. It uses @/lib/supabase/client.',
+            'entries/client.ts は "use server" 禁止。@/lib/supabase/client を使うため。',
         },
       ],
     },
@@ -53,7 +52,7 @@ export const directivesConfigs = [
         {
           selector:
             "Program > :first-child:not(ExpressionStatement[expression.value='use client'])",
-          message: 'Hooks must start with "use client" directive.',
+          message: 'hooks は先頭に "use client" directive が必須。',
         },
       ],
     },

package/src/next/imports.mjs

@@ -1,6 +1,5 @@
 import { localPlugin } from "../common/local-plugins/index.mjs";
 
-/** Enforce relative paths within same feature, @/ for cross-feature in Next.js. */
 export const importPathStyleConfigs = [
   {
     name: "imports/path-style",

package/src/next/index.mjs

@@ -1,28 +1,24 @@
-import { createEntryPointConfigs } from "../common/entry-points.mjs";
+import { createEntryPointConfigs } from "../common/boundaries/entry-point.mjs";
 import { createCommonConfigs } from "../common/index.mjs";
-import {
-  componentsBoundaryConfigs,
-  hooksBoundaryConfigs,
-  libBoundaryConfigs,
-  pageBoundaryConfigs,
-  routeBoundaryConfigs,
-  sitemapBoundaryConfigs,
-} from "../common/imports.mjs";
 
+import { componentsBoundaryConfigs } from "./boundaries/components.mjs";
+import { hooksBoundaryConfigs } from "./boundaries/hooks.mjs";
+import { libBoundaryConfigs } from "./boundaries/lib.mjs";
+import { pageBoundaryConfigs } from "./boundaries/page.mjs";
+import { routeBoundaryConfigs } from "./boundaries/route.mjs";
+import { sitemapBoundaryConfigs } from "./boundaries/sitemap.mjs";
 import { directivesConfigs } from "./directives.mjs";
 import { importPathStyleConfigs } from "./imports.mjs";
-import { layoutsConfigs } from "./layouts.mjs";
-import { namingConfigs } from "./naming.mjs";
+import { componentsLayerConfigs } from "./layers/components.mjs";
+import { hooksLayerConfigs } from "./layers/hooks.mjs";
+import { layoutsConfigs } from "./layers/layouts.mjs";
 import { tailwindcssConfigs } from "./tailwindcss.mjs";
 
 const nextEntryPointConfigs = createEntryPointConfigs(
   ["src/app/**/*.ts", "src/app/**/*.tsx"],
 );
 
-/** Next.js ESLint flat config entry point. */
 export const eslintConfig = [
-  // shadcn/ui generated components live directly under `src/components/shared/ui/`.
-  // Files in `custom/` are user-authored and remain linted.
   {
     name: "rules/ignore-shadcn-ui",
     ignores: ["src/components/shared/ui/*.{ts,tsx}"],
@@ -34,7 +30,8 @@ export const eslintConfig = [
   ...sitemapBoundaryConfigs,
   ...hooksBoundaryConfigs,
   ...componentsBoundaryConfigs,
-  ...namingConfigs,
+  ...hooksLayerConfigs,
+  ...componentsLayerConfigs,
   ...directivesConfigs,
   ...importPathStyleConfigs,
   ...layoutsConfigs,

package/src/next/layers/components.mjs

@@ -0,0 +1,30 @@
+import { checkFile } from "../../common/_internal/plugins.mjs";
+
+export const componentsLayerConfigs = [
+  {
+    name: "naming/components-tsx-only",
+    files: ["src/components/**/*.ts"],
+    rules: {
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector: "Program",
+          message:
+            "components/ は .tsx のみ。ロジックは src/features/ に置く。",
+        },
+      ],
+    },
+  },
+  {
+    name: "naming/components-pascal-case",
+    files: ["src/components/**/*.tsx"],
+    ignores: ["src/components/shared/ui/**", "src/components/**/index.tsx"],
+    plugins: { "check-file": checkFile },
+    rules: {
+      "check-file/filename-naming-convention": [
+        "error",
+        { "**/*.tsx": "PASCAL_CASE" },
+      ],
+    },
+  },
+];

package/src/next/layers/hooks.mjs

@@ -0,0 +1,31 @@
+import { checkFile } from "../../common/_internal/plugins.mjs";
+
+export const hooksLayerConfigs = [
+  {
+    name: "naming/hooks",
+    files: ["src/features/**/hooks/*.ts"],
+    plugins: { "check-file": checkFile },
+    rules: {
+      "check-file/filename-naming-convention": [
+        "error",
+        { "**/*.ts": "use-+([a-z0-9])*(-+([a-z0-9]))" },
+        { ignoreMiddleExtensions: true },
+      ],
+    },
+  },
+  {
+    name: "naming/hooks-export",
+    files: ["src/features/**/hooks/*.ts"],
+    rules: {
+      "no-restricted-syntax": [
+        "error",
+        {
+          selector:
+            "ExportNamedDeclaration > FunctionDeclaration[id.name!=/^use[A-Z]/]",
+          message:
+            "hooks の export 関数は 'use' で始める (例: useAuth)。",
+        },
+      ],
+    },
+  },
+];

package/src/next/layers/layouts.mjs

@@ -0,0 +1,12 @@
+import { localPlugin } from "../../common/local-plugins/index.mjs";
+
+export const layoutsConfigs = [
+  {
+    name: "layouts/main-structural-only",
+    files: ["src/app/**/layout.tsx"],
+    plugins: { local: localPlugin },
+    rules: {
+      "local/layout-main-structural-only": "error",
+    },
+  },
+];

package/src/next/tailwindcss.mjs

@@ -3,14 +3,6 @@ import { dirname, join, sep } from "node:path";
 
 import betterTailwindcss from "eslint-plugin-better-tailwindcss";
 
-// `eslint-plugin-better-tailwindcss` resolves a relative `entryPoint` against
-// the linter's `cwd`, which under LSP servers (vscode-eslint, Zed) is often
-// the edited file's directory rather than the consumer's project root and
-// breaks resolution. Mirror the `findProjectRoot` pattern from
-// `common/rules.mjs` and `common/constants.mjs`: walk up from this module
-// outside of `node_modules` and locate `src/app/globals.css`, then pass the
-// absolute path so resolution is cwd-independent. Falls back to the relative
-// path when not found, preserving the previous CLI-only behavior.
 const findEntryPoint = (start) => {
   let dir = start;
   while (dir !== dirname(dir)) {
@@ -27,19 +19,6 @@ const findEntryPoint = (start) => {
 
 const entryPoint = findEntryPoint(import.meta.dirname);
 
-/**
- * Tailwind CSS v4 lint rules:
- *
- * - margin is forbidden; spacing is controlled by padding/gap on the parent
- * - `space-x-*` / `space-y-*` are also banned because they apply margin to
- *   children under the hood. Use `flex/grid + gap` instead. Negative variants
- *   (`-space-x-2`) remain allowed for intentional overlap
- * - class order, deprecated classes, conflicts, duplicates, and whitespace
- *   are enforced via `eslint-plugin-better-tailwindcss`
- * - `entryPoint` is auto-resolved to the consuming project's
- *   `src/app/globals.css` via walk-up from this module. Override in the
- *   project's eslint.config.mjs if the file lives elsewhere.
- */
 export const tailwindcssConfigs = [
   {
     name: "tailwindcss/rules",
@@ -63,12 +42,12 @@ export const tailwindcssConfigs = [
             {
               pattern: "^(?!mx-auto$)m[trblxy]?-(?!auto$)[^-\\s]+$",
               message:
-                "Avoid margin; control spacing with padding/gap (exceptions: mx-auto, -mt-*)",
+                "margin を避け、padding/gap で間隔を制御する (例外: mx-auto, -mt-*)",
             },
             {
               pattern: "^space-[xy]-[^-\\s]+$",
               message:
-                "Avoid space-x/space-y (uses margin internally); use flex/grid + gap",
+                "space-x/space-y は避ける (内部で margin を使う)。flex/grid + gap を使う",
             },
           ],
         },

package/src/node/CLAUDE.md

@@ -0,0 +1,7 @@
+# src/node/CLAUDE.md
+
+Node.js entry。現状サブディレクトリ・固有 rule なし。
+
+- `index.mjs` — Node.js entry。`src/common/` の rule を `scripts/features/` に適用するだけ
+
+Node.js 固有の制約が必要になったら、このディレクトリに `boundaries/` 等を作成する。

package/src/node/index.mjs

@@ -1,11 +1,10 @@
-import { createEntryPointConfigs } from "../common/entry-points.mjs";
+import { createEntryPointConfigs } from "../common/boundaries/entry-point.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,