refactor(oxlint-rules): migrate custom rules to TypeScript with @oxlint/plugins (#2746)

* refactor(oxlint-rules): migrate custom rules to TypeScript with @oxlint/plugins

Switches the four custom oxlint rules from `.mjs` with eslint-typed JSDoc
to `.ts` with first-party `@oxlint/plugins` types, matching the official
oxlint plugin authoring style and removing the eslint type dependency.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: drop unused eslint dependency and empty gitkeep

`eslint` was only referenced by JSDoc type imports in the old `.mjs`
custom rules; the TypeScript migration dropped those, so the package
is no longer needed at runtime or for type-checking. The `scripts/`
directory now contains `postinstall.sh`, so the placeholder file is
also removed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* cleanup lockfile

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: devmgn

knip.jsonc

@@ -1,8 +1,11 @@
 {
   "$schema": "./node_modules/knip/schema-jsonc.json",
-  "ignore": ["src/**/openapi/**", "src/mocks/**", "tools/**"],
+  "ignore": ["src/**/openapi/**", "src/mocks/**"],
   "ignoreBinaries": ["openapiconfig.json", "actionlint", "zizmor"],
   "ignoreDependencies": ["postcss", "postcss-load-config"],
+  "ignoreIssues": {
+    "tools/oxlint-rules/!(index).ts": ["files"],
+  },
   "tailwind": {
     "entry": ["src/lib/styles/globals.css"],
   },

lefthook.yml

@@ -13,6 +13,7 @@ pre-commit:
       run: pnpm oxlint --fix {staged_files}
       stage_fixed: true
     - name: oxfmt
+      glob: "*"
       run: pnpm oxfmt --write {staged_files}
       stage_fixed: true
     - name: test

oxlint.config.ts

@@ -26,7 +26,7 @@ export default defineConfig({
     "vitest",
   ],
   jsPlugins: [
-    "./tools/oxlint-rules/index.mjs",
+    "./tools/oxlint-rules/index.ts",
     "@tanstack/eslint-plugin-query",
     { name: "react-compiler-rules", specifier: "eslint-plugin-react-hooks" },
   ],
@@ -251,21 +251,6 @@ export default defineConfig({
         "typescript/no-unsafe-type-assertion": "off",
       },
     },
-    {
-      // Scripts — plain .mjs files lack TS type info, so no-unsafe-* rules produce false positives
-      files: ["*.mjs"],
-      rules: {
-        "import/no-anonymous-default-export": "off",
-        "import/no-default-export": "off",
-        "typescript/no-redundant-type-constituents": "off",
-        "typescript/no-unsafe-argument": "off",
-        "typescript/no-unsafe-assignment": "off",
-        "typescript/no-unsafe-call": "off",
-        "typescript/no-unsafe-member-access": "off",
-        "typescript/no-unsafe-return": "off",
-        "typescript/strict-boolean-expressions": "off",
-      },
-    },
     {
       // Next.js special files + config files → allow default export, relax filename
       files: [
@@ -296,5 +281,12 @@ export default defineConfig({
         "import/no-default-export": "off",
       },
     },
+    {
+      // Custom oxlint rule plugin entries — default exports are required by the plugin loader
+      files: ["tools/oxlint-rules/**/*.ts"],
+      rules: {
+        "import/no-default-export": "off",
+      },
+    },
   ],
 });

package.json

@@ -50,6 +50,7 @@
     "@babel/core": "7.29.0",
     "@faker-js/faker": "10.4.0",
     "@next/env": "16.2.4",
+    "@oxlint/plugins": "1.62.0",
     "@rolldown/plugin-babel": "0.2.3",
     "@storybook/addon-a11y": "10.3.5",
     "@storybook/addon-docs": "10.3.5",
@@ -69,7 +70,6 @@
     "@vitest/coverage-v8": "4.1.5",
     "axe-core": "4.11.3",
     "babel-plugin-react-compiler": "1.0.0",
-    "eslint": "10.2.1",
     "eslint-plugin-react-hooks": "7.1.1",
     "eslint-plugin-storybook": "10.3.5",
     "happy-dom": "20.9.0",

pnpm-lock.yaml

@@ -0,0 +1,17 @@
+import type { Plugin } from "@oxlint/plugins";
+import newlineAfterImport from "./newline-after-import.ts";
+import noIndexTsx from "./no-index-tsx.ts";
+import noTopLevelArrow from "./no-top-level-arrow.ts";
+import sortHookDeps from "./sort-hook-deps.ts";
+
+const plugin: Plugin = {
+  meta: { name: "custom-rules" },
+  rules: {
+    "newline-after-import": newlineAfterImport,
+    "no-index-tsx": noIndexTsx,
+    "no-top-level-arrow": noTopLevelArrow,
+    "sort-hook-deps": sortHookDeps,
+  },
+};
+
+export default plugin;