@longzai-intelligence-oxlint/react-plugin 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# @longzai-intelligence-oxlint/react-plugin
+
+## 意图
+
+在静态检查阶段守护 React 项目中的 Hook 命名约定，避免错误的 Hook 命名导致 Hooks 规则误判。
+
+## 定位
+
+Oxlint 生态的 React 专属规则插件，通过 `eslintCompatPlugin` 包装以同时兼容 Oxlint 与 ESLint 运行时。
+
+## 职能
+
+提供 `no-incorrect-hook-naming` 规则，校验以 `use` 前缀命名的函数是否符合 Hook 语义约束。
+
+## 实现情况
+
+当前仅落地 Hook 命名一条规则，规则与插件对象均已导出；其余 React 专属规则尚未纳入，整体处于聚焦单点的成熟形态。

package/dist/configs/recommended.d.ts

@@ -0,0 +1,5 @@
+import { OxlintRules } from "@longzai-intelligence-oxlint/core";
+//#region src/configs/recommended.config.d.ts
+declare const recommended: OxlintRules;
+//#endregion
+export { recommended };

package/dist/configs/recommended.js

@@ -0,0 +1 @@
+const e={"@longzai-intelligence-oxlint/react-plugin/no-incorrect-hook-naming":`error`};export{e as recommended};

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+//#region src/rules/no-incorrect-hook-naming/no-incorrect-hook-naming.rule.d.ts
+/**
+ * no-incorrect-hook-naming 规则定义
+ */
+declare const noIncorrectHookNamingRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/index.d.ts
+/**
+ * React 插件
+ *
+ * 提供 React 相关的 Oxlint 规则，
+ * 通过 eslintCompatPlugin 包装以同时支持 Oxlint 和 ESLint 运行时
+ */
+declare const reactPlugin: import("@oxlint/plugins").Plugin;
+//#endregion
+export { reactPlugin as default, reactPlugin, noIncorrectHookNamingRule };

package/dist/index.js

@@ -0,0 +1 @@
+import{defineRule as e,eslintCompatPlugin as t}from"@oxlint/plugins";const n=/\/hooks\//,r=/^use-[a-z][-a-z0-9]*(?:\.hook)?\.tsx?$/,i=/\.hook\.tsx?$/,a=/^use[A-Za-z-]*\.types\.ts$/;function o(e){return`${e.replace(/\.tsx?$/,``).replace(/\.hook$/,``).split(`-`).map((e,t)=>t===0?e:e.charAt(0).toUpperCase()+e.slice(1)).join(``)}${e.endsWith(`.tsx`)?`.tsx`:`.ts`}`}const s=e({meta:{type:`problem`,docs:{description:`检测 hooks/ 目录下不规范的 hook 文件命名`}},createOnce(e){return{before(){let t=e.filename.replace(/\\/g,`/`);if(!n.test(t))return!1},Program(t){let s=e.filename.replace(/\\/g,`/`);if(!n.test(s))return;let c=s.split(`/`).pop()??``;if(r.test(c)){let n=o(c);e.report({node:t,message:`Hook 文件命名违规: ${c} 使用了 kebab-case。应使用 camelCase，如 ${n}`});return}if(i.test(c)){let n=c.replace(/\.hook(\.tsx?)$/,`$1`);e.report({node:t,message:`Hook 文件命名违规: ${c} 使用了 .hook 后缀。应移除 .hook 后缀，如 ${n}`});return}if(a.test(c)){e.report({node:t,message:`Hook 文件命名违规: ${c}。类型文件不应以 use 开头`});return}}}}}),c=t({meta:{name:`@longzai-intelligence-oxlint/react-plugin`},rules:{"no-incorrect-hook-naming":s}});export{c as default,c as reactPlugin,s as noIncorrectHookNamingRule};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@longzai-intelligence-oxlint/react-plugin",
+  "version": "0.1.0",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./configs/recommended": {
+      "types": "./dist/configs/recommended.d.ts",
+      "import": "./dist/configs/recommended.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production lzi-builder",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "lzi-builder --watch",
+    "clean": "rimraf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "tsgo --noEmit -p tsconfig/app.json",
+    "typecheck:node": "tsgo --noEmit -p tsconfig/node.json",
+    "typecheck:test": "tsgo --noEmit -p tsconfig/test.json"
+  },
+  "dependencies": {
+    "@longzai-intelligence-oxlint/core": "0.1.0",
+    "@oxlint/plugins": "^1.74.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.10",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.0.0"
+  }
+}