@yasainet/eslint 0.0.73 → 0.0.75

package/README.md

@@ -4,161 +4,18 @@ Shared ESLint configuration for Next.js, Node.js and Deno.
 
 ## Entry Points
 
-| Entry                   | Feature Root                   | Entry Points            | Description                   |
-| ----------------------- | ------------------------------ | ----------------------- | ----------------------------- |
-| `@yasainet/eslint/next` | `src/features/`                | -                       | Common rules + Next.js        |
-| `@yasainet/eslint/node` | `scripts/features/`            | `scripts/commands/*.ts` | Common rules (CLI scripts)    |
-| `@yasainet/eslint/deno` | `supabase/functions/features/` | -                       | Common rules (Edge Functions) |
-
-## Directory Structure
-
-```text
-src/
-├── common/   # Shared rules for all environments
-├── next/     # Next.js-specific rules (hooks, components, directives)
-├── node/     # Node.js CLI scripts (scripts/features, scripts/commands)
-└── deno/     # Deno entry point (entry-point boundary, _utils boundary, _lib boundary)
-```
-
-Each entry point enforces a feature-based architecture. **Files do not carry role suffixes — the directory declares the role**:
-
-```text
-{featureRoot}/
-├── {feature}/
-│   ├── entries/        # entry points called from page.tsx / route.ts / hooks (server.ts / admin.ts / client.ts)
-│   ├── services/       # business logic (server.ts ...)
-│   ├── queries/        # data access (one file per upstream lib: <lib-name>.ts)
-│   ├── types/          # type defs (one file per feature: <feature>.ts)
-│   ├── schemas/        # zod schemas (<feature>.ts)
-│   ├── utils/          # pure helpers (<feature>.ts)
-│   └── constants/      # constants (<feature>.ts)
-├── shared/             # Cross-feature shared modules
-{libRoot}/
-├── {single-client-lib}/index.ts   # SDK wrapper entry (e.g., gallery-dl, fxembed, r2)
-├── {single-client-lib}/types.ts   # raw SDK types
-├── {single-client-lib}/<sub>.ts   # internal sub-modules (parser, etc.) — auto-hidden from queries
-├── {multi-client-lib}/<role>.ts   # one role per file (e.g., supabase: admin / server / client / proxy)
-└── {multi-client-lib}/types.ts
-{utilsRoot}/            # top-level pure utilities (cn.ts / logger.ts ...)
-```
-
-### single-client vs multi-client lib
-
-| Detected by                                  | Treated as       | Example                                       |
-| -------------------------------------------- | ---------------- | --------------------------------------------- |
-| `lib/<dir>/index.ts` exists                  | single-client    | `lib/gallery-dl/{index.ts, parser.ts, types.ts}` |
-| `lib/<dir>/index.ts` absent                  | multi-client     | `lib/supabase/{admin.ts, server.ts, client.ts, ...}` |
-
-For single-client libs the prefix mapping registers only the directory name, automatically hiding internal sub-modules (e.g., `parser.ts`) from the queries layer. For multi-client libs every plain `<role>.ts` is registered.
-
-### File naming rules
-
-- **No multi-extension suffixes** (`.lib`, `.service`, `.query`, `.util`, `.type`, `.schema`, `.constant`, `.entry` are forbidden). The directory carries the role.
-- `lib/<dir>/index.ts` for single-client lib entries (avoids `lib/<dir>/<dir>.ts` redundancy).
-- `lib/<dir>/types.ts` and `lib/<dir>/proxy.ts` are excluded from the prefix mapping so queries cannot directly depend on them.
-- `<feature>/{types,schemas,utils,constants}/<feature>.ts` — exactly one file per feature, named after the feature.
-- `<feature>/queries/<lib-name>.ts` — file name must match a registered lib prefix; queries can only import from the matching lib (lib-boundary lint).
+- `@yasainet/eslint/next` — Common rules + Next.js
+  - Feature Root: `src/features/`
+- `@yasainet/eslint/node` — Common rules for CLI scripts
+  - Feature Root: `scripts/features/`
+  - Entry Points: `scripts/commands/*.ts`
+- `@yasainet/eslint/deno` — Common rules for Supabase Edge Functions
+  - Feature Root: `supabase/functions/_features/`
 
 ## Setup
 
-### Next.js + Node.js + Deno
-
-```sh
-npm install -D @yasainet/eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig as nextEslintConfig } from "@yasainet/eslint/next";
-import { eslintConfig as nodeEslintConfig } from "@yasainet/eslint/node";
-import { eslintConfig as denoEslintConfig } from "@yasainet/eslint/deno";
-import { defineConfig, globalIgnores } from "eslint/config";
-import nextVitals from "eslint-config-next/core-web-vitals";
-import nextTs from "eslint-config-next/typescript";
-
-export default defineConfig([
-  ...nextVitals,
-  ...nextTs,
-  // Override default ignores of eslint-config-next.
-  globalIgnores([
-    // Default ignores of eslint-config-next:
-    ".next/**",
-    ".vercel/**",
-    "out/**",
-    "build/**",
-    "next-env.d.ts",
-  ]),
-  ...nextEslintConfig,
-  ...nodeEslintConfig,
-  ...denoEslintConfig,
-]);
-```
-
-### Next.js
-
-```sh
-npm install -D @yasainet/eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig } from "@yasainet/eslint/next";
-import { defineConfig, globalIgnores } from "eslint/config";
-import nextVitals from "eslint-config-next/core-web-vitals";
-import nextTs from "eslint-config-next/typescript";
-
-export default defineConfig([
-  ...nextVitals,
-  ...nextTs,
-  // Override default ignores of eslint-config-next.
-  globalIgnores([
-    // Default ignores of eslint-config-next:
-    ".next/**",
-    ".vercel/**",
-    "out/**",
-    "build/**",
-    "next-env.d.ts",
-  ]),
-  ...eslintConfig,
-]);
-```
-
-### Node.js
-
-```sh
-npm install -D @yasainet/eslint eslint typescript-eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig } from "@yasainet/eslint/node";
-
-export default [...eslintConfig];
-```
-
-### Deno
-
-```sh
-npm install -D @yasainet/eslint eslint typescript-eslint
-```
-
-```js
-// eslint.config.mjs
-import { eslintConfig } from "@yasainet/eslint/deno";
-
-export default [...eslintConfig];
-```
+利用 entry 別の install / config template は [`docs/setup.md`](./docs/setup.md) を参照。
 
 ## Release
 
-Version is derived from the Git tag. CI automatically sets `package.json` version before publishing.
-
-1. Commit and push to `main`
-2. Create and push a tag:
-
-```sh
-git tag v1.0.0
-git push --tags
-```
-
-3. GitHub Actions will automatically publish to npm
+Git tag (`vX.Y.Z`) を push すると GitHub Actions が npm に publish する。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasainet/eslint",
-  "version": "0.0.73",
+  "version": "0.0.75",
   "description": "ESLint",
   "type": "module",
   "exports": {
@@ -17,6 +17,9 @@
       "default": "./src/deno/index.mjs"
     }
   },
+  "bin": {
+    "test-audit": "./src/cli/test-audit.mjs"
+  },
   "files": [
     "src"
   ],
@@ -32,6 +35,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "docs": "node scripts/generate-rules-catalog.mjs"
+  },
   "dependencies": {
     "@stylistic/eslint-plugin": "^5.9.0",
     "eslint-plugin-better-tailwindcss": "^4.1.1",

package/src/cli/test-audit.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+
+// pure layer (schemas / utils) の unit test presence を機械チェックする:
+//
+// - 各 source に 兄弟 *.test.ts が存在するか、`@unit-exempt:` marker を持つことを要求
+// - schemas は定義上 pure。utils は impure 混在のため marker で opt-out できる
+// - ESLint の per-file モデルと噛み合わない「存在強制」を全ツリー一括監査で担う
+
+const REQUIRE_DIRS = new Set(["schemas", "utils"]);
+const EXEMPT_RE = /@unit-exempt:/;
+
+function getFlag(argv, name) {
+  const i = argv.indexOf(name);
+  return i !== -1 && argv[i + 1] ? argv[i + 1] : null;
+}
+
+function* walk(dir) {
+  if (!fs.existsSync(dir)) {
+    return;
+  }
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      yield* walk(full);
+    } else if (entry.isFile()) {
+      yield full;
+    }
+  }
+}
+
+function isTarget(file) {
+  if (!file.endsWith(".ts")) {
+    return false;
+  }
+  if (file.endsWith(".test.ts") || file.endsWith(".d.ts")) {
+    return false;
+  }
+  return REQUIRE_DIRS.has(path.basename(path.dirname(file)));
+}
+
+function isSatisfied(file) {
+  const testFile = file.replace(/\.ts$/, ".test.ts");
+  if (fs.existsSync(testFile)) {
+    return true;
+  }
+  return EXEMPT_RE.test(fs.readFileSync(file, "utf8"));
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log(
+      "test-audit — pure layer (schemas/utils) の unit test presence を検査\n\n" +
+        "Usage: test-audit [--feature-root <path>]\n\n" +
+        "  --feature-root <path>  feature root (default: src/features)\n\n" +
+        "各 schemas/*.ts と utils/*.ts に 兄弟 *.test.ts または\n" +
+        "`// @unit-exempt: <理由>` marker を要求する。",
+    );
+    process.exit(0);
+  }
+
+  const projectRoot = process.cwd();
+  const featureRoot = getFlag(argv, "--feature-root") ?? "src/features";
+  const roots = [path.join(projectRoot, featureRoot)];
+
+  const violations = [];
+  for (const root of roots) {
+    for (const file of walk(root)) {
+      if (isTarget(file) && !isSatisfied(file)) {
+        violations.push(path.relative(projectRoot, file));
+      }
+    }
+  }
+
+  if (violations.length > 0) {
+    console.error(
+      `✗ test-audit: ${violations.length} 件の pure layer に unit test も @unit-exempt marker もありません:\n`,
+    );
+    for (const v of violations.sort()) {
+      console.error(`  ${v}`);
+    }
+    console.error(
+      "\n対応: 兄弟 *.test.ts を追加するか、impure な場合は\n" +
+        "`// @unit-exempt: <理由>` を記載する。",
+    );
+    process.exit(1);
+  }
+
+  console.log(
+    "✓ test-audit: schemas / utils はすべて unit test または @unit-exempt が揃っています。",
+  );
+}
+
+main();

package/src/common/CLAUDE.md

@@ -0,0 +1,17 @@
+# src/common/CLAUDE.md
+
+全 entry で共有する rule の置き場所判断 (target 基準):
+
+- `_internal/` — private 実装詳細 (constants / plugins / selectors / import-patterns)。consumer から見えない
+- `base/` — 全ファイル対象の generic rule (TypeScript syntactic / type-aware)
+- `boundaries/<surface>.mjs` — 外界 → features の入口で enforce する契約
+- `cross-cutting/` — 複数 layer に跨る規約
+  - 例 (naming): feature-name / namespace-import / form-state
+  - 例 (rule): logger / jsdoc / no-any-return / supabase-columns-satisfies
+- `layers/<layer>.mjs` — features 内部の階層単位
+  - 種類: queries / services / entries / utils / constants / schemas / types / lib / top-level-utils
+  - 1 layer の全制約 (naming + syntax + imports + local rules) を 1 file に集約
+- `local-plugins/` — ESLint local plugin の実装本体
+- `index.mjs` — common entry。上記 file を合成して export
+
+新規 rule の glob が単一 layer に閉じるなら `layers/`、跨ぐなら `cross-cutting/`、外界の caller surface なら `boundaries/` に置く。

package/src/common/{constants.mjs → _internal/constants.mjs}

@@ -20,22 +20,8 @@ function findProjectRoot() {
 
 const PROJECT_ROOT = findProjectRoot();
 
-/**
- * Files / basenames that should never become a prefix:
- *
- * - `types.ts` / `type.ts`: 型定義のみで lib の役割を持たない (単複どちらの命名でも除外)
- * - `proxy.ts`: middleware adapter (Next.js の proxy.ts と意味が衝突するため queries から呼ばせない)
- */
-const EXCLUDE_LIST = ["types.ts", "type.ts", "proxy.ts"];
+const EXCLUDE_LIST = ["type.ts", "proxy.ts"];
 
-/**
- * Scan lib directory and build prefix-to-lib-relative-path mapping:
- *
- * - single-client lib (`lib/<dir>/index.ts`): prefix = dir 名、entry のみ登録 — 同 dir 内の他ファイル (parser 等 sub-module) は自動除外
- * - multi-client lib (index.ts なし): dir 内の全 `<role>.ts` を登録 (e.g., supabase の admin / server / client)
- * - 多重拡張子 (`.test.ts` 等) を持つファイルは sub-module / 非 lib として除外
- * - types.ts / type.ts / proxy.ts のような lib として queries から呼ばせたくないものは EXCLUDE_LIST で除外
- */
 export function generatePrefixLibMapping(featureRoot) {
   const libRoot = featureRoot.replace(/features$/, "lib");
   const libDir = path.join(PROJECT_ROOT, libRoot);
@@ -61,11 +47,8 @@ export function generatePrefixLibMapping(featureRoot) {
         .map((e) => e.name);
 
       if (plainTsFiles.includes("index.ts")) {
-        // single-client lib: index.ts を entry とみなし、prefix = dir 名で登録
-        // 同 dir 内の他ファイル (parser 等) は sub-module として自動除外
         mapping[entry.name] = `${entry.name}/index`;
       } else {
-        // multi-client lib: 全 role file を登録 (e.g., supabase の admin / server / client)
         for (const fileName of plainTsFiles) {
           const prefix = fileName.replace(/\.ts$/, "");
           mapping[prefix] = `${entry.name}/${prefix}`;
@@ -80,7 +63,6 @@ export function generatePrefixLibMapping(featureRoot) {
   return mapping;
 }
 
-/** Build glob patterns scoped to the given feature root. */
 export const featuresGlob = (featureRoot, subpath) => [
   `${featureRoot}/${subpath}`,
 ];

package/src/common/_internal/import-patterns.mjs

@@ -0,0 +1,16 @@
+export const LIB_BOUNDARY_PATTERNS = [
+  {
+    group: ["@/lib/*", "@/lib/**"],
+    message:
+      "lib/* は queries からのみ import 可。他層は queries 経由で使う。",
+  },
+];
+
+export const MAPPING_PATTERNS = [
+  {
+    group: ["@/utils/mapping.util"],
+    importNames: ["mapSnakeToCamel", "mapCamelToSnake"],
+    message:
+      "mapping 関数は services のみ許可。snake/camel 変換は service 境界で行う。",
+  },
+];

package/src/common/{plugins.mjs → _internal/plugins.mjs}

@@ -3,7 +3,6 @@ import checkFile from "eslint-plugin-check-file";
 import jsdocPlugin from "eslint-plugin-jsdoc";
 import simpleImportSortPlugin from "eslint-plugin-simple-import-sort";
 
-/** Shared plugin instances used across ESLint configs. */
 export const plugins = {
   "@stylistic": stylistic,
   "check-file": checkFile,

package/src/common/_internal/selectors.mjs

@@ -0,0 +1,12 @@
+export const loggerSelector = "CallExpression[callee.object.name='logger']";
+
+export const loggerMessage =
+  "logger は entries 以外で禁止。ログ出力は entries に集約する。";
+
+export const aliasDynamicImportSelector =
+  "ImportExpression[source.type='Literal'][source.value=/^@\\//]";
+
+export const aliasDynamicImportMessage =
+  "features layers で `@/` パスの動的 import は禁止 (prefix-lib / lateral 制約を迂回する):\n" +
+  "- 内部依存は queries/<prefix>.ts か services/<prefix>.ts を作る\n" +
+  "- 外部 npm は cold-start 最適化の遅延 import なら可";

package/src/common/{rules.mjs → base/typescript.mjs}

@@ -3,17 +3,15 @@ import { dirname, join, sep } from "node:path";
 
 import tseslint from "typescript-eslint";
 
-import { simpleImportSortPlugin, stylistic } from "./plugins.mjs";
+import { simpleImportSortPlugin, stylistic } from "../_internal/plugins.mjs";
 
-// When evaluated under LSP servers like vscode-eslint, `process.cwd()` returns
-// the linted file's directory rather than the consumer's project root, so it
-// cannot be used to derive `tsconfigRootDir`. Walk up from this module until a
-// `tsconfig.json` outside of `node_modules` is found. Falls back to
-// `process.cwd()` for CLI parity if no such directory is reachable.
 const findProjectRoot = (start) => {
   let dir = start;
   while (dir !== dirname(dir)) {
-    if (!dir.split(sep).includes("node_modules") && existsSync(join(dir, "tsconfig.json"))) {
+    if (
+      !dir.split(sep).includes("node_modules") &&
+      existsSync(join(dir, "tsconfig.json"))
+    ) {
       return dir;
     }
     dir = dirname(dir);
@@ -31,6 +29,7 @@ const sharedRulesConfig = {
   },
   rules: {
     "no-console": "warn",
+
     "no-irregular-whitespace": [
       "warn",
       {
@@ -40,20 +39,21 @@ const sharedRulesConfig = {
         skipTemplates: false,
       },
     ],
-    "simple-import-sort/imports": "warn",
-    "simple-import-sort/exports": "warn",
-    "@stylistic/quotes": ["warn", "double", { avoidEscape: true }],
-    // Dead code detection: rules with no legitimate use case, so always safe to error.
     "no-unreachable": "error",
-    "no-unreachable-loop": "error",
-    "no-useless-return": "error",
     "no-constant-condition": "error",
     "no-constant-binary-expression": "error",
     "no-dupe-else-if": "error",
     "no-self-assign": "error",
-    "no-self-compare": "error",
     "no-useless-catch": "error",
     "no-fallthrough": "error",
+
+    "no-unreachable-loop": "error",
+    "no-useless-return": "error",
+    "no-self-compare": "error",
+
+    "simple-import-sort/imports": "warn",
+    "simple-import-sort/exports": "warn",
+    "@stylistic/quotes": ["warn", "double", { avoidEscape: true }],
   },
 };
 
@@ -74,18 +74,11 @@ const syntacticTypeScriptRules = {
 };
 
 const typeAwareTypeScriptRules = {
-  // Detect defensive fallbacks on non-nullable values (e.g., `?? ''`
-  // on a non-null column). Promoted to error once consuming projects
-  // (bitcomic.net, getpayme.net) reached 0 warnings.
   "@typescript-eslint/no-unnecessary-condition": "error",
-  // Type-aware async safety: silent await omissions are a leading cause
-  // of race conditions in server actions and background tasks.
   "@typescript-eslint/no-floating-promises": "error",
   "@typescript-eslint/no-misused-promises": "error",
   "@typescript-eslint/await-thenable": "error",
   "@typescript-eslint/require-await": "error",
-  // Type-aware `any` propagation checks: any が境界を越えた瞬間に
-  // 残りのコードで型検査が無効化されるため、検出したら確実に止める。
   "@typescript-eslint/no-unsafe-assignment": "error",
   "@typescript-eslint/no-unsafe-call": "error",
   "@typescript-eslint/no-unsafe-member-access": "error",
@@ -97,21 +90,7 @@ const typeAwareRulesOff = Object.fromEntries(
   Object.keys(typeAwareTypeScriptRules).map((rule) => [rule, "off"]),
 );
 
-/**
- * Build base rule configs:
- *
- * - `typeAware: true` (default) enables `projectService` and type-aware rules
- *   (`no-unnecessary-condition`, `no-floating-promises`, `no-unsafe-*`, etc.)
- *   for the matched `files`
- * - `typeAware: false` disables `projectService` and forces type-aware rules
- *   off for the matched `files`. Use for files outside the project tsconfig
- *   (e.g., Deno files in Supabase Edge Functions)
- *
- * `files` defaults to all TypeScript sources. When combining multiple entries
- * (e.g., next + deno), pass a narrow pattern so the type-aware override only
- * applies to its target files.
- */
-export function createRulesConfigs({
+export function createTypescriptConfigs({
   typeAware = true,
   files = ["**/*.ts", "**/*.tsx"],
 } = {}) {

package/src/common/{entry-points.mjs → boundaries/entry-point.mjs}

@@ -1,4 +1,3 @@
-/** Ban `import * as` at entry points. */
 export function createEntryPointConfigs(entryPointFiles, entryPointIgnores = []) {
   return [
     {
@@ -11,7 +10,7 @@ export function createEntryPointConfigs(entryPointFiles, entryPointIgnores = [])
           {
             selector: "ImportDeclaration:has(ImportNamespaceSpecifier)",
             message:
-              "Entry points must use named imports instead of `import * as`. This makes dependencies explicit.",
+              "entry point は `import * as` 禁止。named import で依存を明示する。",
           },
         ],
       },

package/src/common/cross-cutting/ban-alias.mjs

@@ -0,0 +1,22 @@
+export function createBanAliasConfigs({ featureRoot }) {
+  return [
+    {
+      name: "imports/ban-alias",
+      files: [`${featureRoot}/**/*.ts`],
+      rules: {
+        "no-restricted-imports": [
+          "error",
+          {
+            patterns: [
+              {
+                group: ["@/*", "@/**"],
+                message:
+                  "この環境では alias import (@/) は使えない。相対パスを使う。",
+              },
+            ],
+          },
+        ],
+      },
+    },
+  ];
+}

package/src/common/cross-cutting/feature-default-imports.mjs

@@ -0,0 +1,26 @@
+import {
+  LIB_BOUNDARY_PATTERNS,
+  MAPPING_PATTERNS,
+} from "../_internal/import-patterns.mjs";
+
+export function createFeatureDefaultImportsConfigs({ featureRoot }) {
+  return [
+    {
+      name: "imports/feature-other",
+      files: [`${featureRoot}/**/*.ts`],
+      ignores: [
+        `${featureRoot}/**/services/*.ts`,
+        `${featureRoot}/**/queries/*.ts`,
+        `${featureRoot}/**/entries/*.ts`,
+        `${featureRoot}/**/utils/*.ts`,
+        `${featureRoot}/**/types/*.ts`,
+      ],
+      rules: {
+        "no-restricted-imports": [
+          "error",
+          { patterns: [...LIB_BOUNDARY_PATTERNS, ...MAPPING_PATTERNS] },
+        ],
+      },
+    },
+  ];
+}

package/src/common/cross-cutting/feature-name.mjs

@@ -0,0 +1,15 @@
+import { featuresGlob } from "../_internal/constants.mjs";
+import { localPlugin } from "../local-plugins/index.mjs";
+
+export function createFeatureNameConfigs({ featureRoot }) {
+  return [
+    {
+      name: "naming/feature-name",
+      files: featuresGlob(featureRoot, "**/*.ts"),
+      plugins: { local: localPlugin },
+      rules: {
+        "local/feature-name": ["error", { featureRoot }],
+      },
+    },
+  ];
+}

package/src/common/cross-cutting/features-ts-only.mjs

@@ -0,0 +1,20 @@
+import { featuresGlob } from "../_internal/constants.mjs";
+
+export function createFeaturesTsOnlyConfigs({ featureRoot }) {
+  return [
+    {
+      name: "naming/features-ts-only",
+      files: featuresGlob(featureRoot, "**/*.tsx"),
+      rules: {
+        "no-restricted-syntax": [
+          "error",
+          {
+            selector: "Program",
+            message:
+              "features/ は .ts のみ。component は src/components/ に置く。",
+          },
+        ],
+      },
+    },
+  ];
+}

package/src/common/cross-cutting/form-state.mjs

@@ -0,0 +1,16 @@
+import { featuresGlob } from "../_internal/constants.mjs";
+import { localPlugin } from "../local-plugins/index.mjs";
+
+export function createFormStateConfigs({ featureRoot }) {
+  return [
+    {
+      name: "naming/form-state",
+      files: featuresGlob(featureRoot, "**/*.ts"),
+      plugins: { local: localPlugin },
+      rules: {
+        "local/form-state-naming": "error",
+        "local/form-state-shape": "error",
+      },
+    },
+  ];
+}

package/src/common/{jsdoc.mjs → cross-cutting/jsdoc.mjs}

@@ -1,9 +1,8 @@
 import jsdocPlugin from "eslint-plugin-jsdoc";
 
-import { featuresGlob } from "./constants.mjs";
+import { featuresGlob } from "../_internal/constants.mjs";
 
-/** Scope JSDoc rules to the given feature root. */
-export function createJsdocConfigs(featureRoot) {
+export function createJsdocConfigs({ featureRoot }) {
   return [
     {
       name: "jsdoc",

package/src/common/cross-cutting/logger.mjs

@@ -0,0 +1,21 @@
+import {
+  loggerMessage,
+  loggerSelector,
+} from "../_internal/selectors.mjs";
+
+export function createLoggerConfigs({ featureRoot }) {
+  return [
+    {
+      name: "layers/logger",
+      files: [`${featureRoot}/**/*.ts`],
+      ignores: [`${featureRoot}/**/entries/*.ts`],
+      rules: {
+        "no-console": "error",
+        "no-restricted-syntax": [
+          "error",
+          { selector: loggerSelector, message: loggerMessage },
+        ],
+      },
+    },
+  ];
+}