@longzai-intelligence-oxlint/typescript-eslint-plugin 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# @longzai-intelligence-oxlint/typescript-eslint-plugin
+
+## 意图
+
+在 Oxlint 运行时复刻 typescript-eslint 生态的关键规则，弥补 Oxlint 原生规则覆盖不足的部分。
+
+## 定位
+
+Oxlint 生态的 typescript-eslint 规则实现插件，对标 ESLint 生态 typescript-eslint 插件，通过 `eslintCompatPlugin` 包装以同时兼容 Oxlint 与 ESLint 运行时。
+
+## 职能
+
+提供 `consistent-type-assertions` 规则，约束类型断言风格的一致性；使用 `defineRule` + `createOnce` 实现以获得最佳性能；同时导出断言风格类型与选项类型供外部复用。
+
+## 实现情况
+
+当前仅落地类型断言一致性一条规则，规则、类型与插件对象均已导出；整体处于聚焦单点的成熟形态，其余 typescript-eslint 规则尚未纳入。

package/dist/configs/recommended.d.ts

@@ -0,0 +1,10 @@
+import { OxlintRules } from "@longzai-intelligence-oxlint/core";
+//#region src/configs/recommended.config.d.ts
+/**
+ * 推荐规则配置
+ *
+ * 包含 typescript-eslint 插件的推荐规则配置。
+ */
+declare const recommended: OxlintRules;
+//#endregion
+export { recommended };

package/dist/configs/recommended.js

@@ -0,0 +1 @@
+const e={"@longzai-intelligence-oxlint/typescript-eslint-plugin/consistent-type-assertions":`error`};export{e as recommended};

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import { Rule } from "@oxlint/plugins";
+//#region src/rules/consistent-type-assertions/types.d.ts
+/**
+ * consistent-type-assertions 规则类型定义
+ *
+ * 定义规则所需的配置选项和辅助类型。
+ */
+/**
+ * 断言风格选项
+ *
+ * - never: 禁止所有类型断言
+ * - as: 只允许 as 断言
+ * - angle-bracket: 只允许尖括号断言
+ */
+type AssertionStyle = 'never' | 'as' | 'angle-bracket';
+/**
+ * 规则配置选项
+ */
+type ConsistentTypeAssertionsOptions = {
+  /**
+   * 允许的断言风格
+   */
+  assertionStyle: AssertionStyle;
+  /**
+   * 是否允许对象字面量类型的 as const 断言
+   */
+  objectLiteralTypeAssertions?: boolean;
+};
+//#endregion
+//#region src/rules/consistent-type-assertions/index.d.ts
+/**
+ * consistent-type-assertions 规则定义
+ */
+declare const consistentTypeAssertionsRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/index.d.ts
+/**
+ * typescript-eslint 规则集合
+ */
+declare const typescriptEslintRules: Record<string, Rule>;
+/**
+ * typescript-eslint 插件
+ */
+declare const typescriptEslintPlugin: import("@oxlint/plugins").Plugin;
+//#endregion
+export { type AssertionStyle, type ConsistentTypeAssertionsOptions, consistentTypeAssertionsRule, typescriptEslintPlugin as default, typescriptEslintPlugin, typescriptEslintRules };

package/dist/index.js

@@ -0,0 +1 @@
+import{defineRule as e,eslintCompatPlugin as t}from"@oxlint/plugins";function n(e){return typeof e==`object`&&!!e&&`typeAnnotation`in e&&e.typeAnnotation!==null&&typeof e.typeAnnotation==`object`}function r(e){return typeof e==`object`&&!!e}function i(e){return typeof e==`object`&&!!e}function a(e){if(!r(e)||!(`type`in e)||e.type!==`TSTypeReference`||!(`typeName`in e)||e.typeName===null||typeof e.typeName!=`object`)return!1;let t=e.typeName;return i(t)?`name`in t&&t.name===`const`:!1}function o(e){return!r(e)||!(`type`in e)?!1:e.type===`TSTypeLiteral`}function s(e,t,r){if(!n(e))return;let i=e.typeAnnotation;if(r.assertionStyle===`never`){if(a(i))return;t.report({node:e,message:`禁止使用 as 类型断言，请使用类型守卫或 Zod 进行类型验证`});return}if(r.assertionStyle===`angle-bracket`){if(a(i)||r.objectLiteralTypeAssertions&&o(i))return;t.report({node:e,message:`应使用尖括号断言而非 as 断言`});return}}function c(e,t,r){if(r.assertionStyle===`never`){t.report({node:e,message:`禁止使用尖括号类型断言，请使用类型守卫或 Zod 进行类型验证`});return}if(r.assertionStyle===`as`){if(n(e)&&r.objectLiteralTypeAssertions&&o(e.typeAnnotation))return;t.report({node:e,message:`应使用 as 断言而非尖括号断言`});return}}function l(e,t,n){n.assertionStyle===`never`&&t.report({node:e,message:`禁止使用非空断言 (!)，请使用类型守卫或 Zod 进行类型验证`})}function u(e){return e===`never`||e===`as`||e===`angle-bracket`}function d(e){return typeof e==`object`&&!!e}function f(e){return!d(e)||!(`assertionStyle`in e)?!1:u(e.assertionStyle)}function p(e){let t={assertionStyle:`never`,objectLiteralTypeAssertions:!1};if(!Array.isArray(e)||e.length===0)return t;let n=e[0];return f(n)?{assertionStyle:n.assertionStyle,objectLiteralTypeAssertions:n.objectLiteralTypeAssertions??!1}:t}const m=e({meta:{type:`suggestion`,docs:{description:`禁止使用类型断言，强制使用类型守卫或 Zod 进行类型验证`}},createOnce(e){let t=p(e.options);return{TSAsExpression(n){s(n,e,t)},TSTypeAssertion(n){c(n,e,t)},TSNonNullExpression(n){l(n,e,t)}}}}),h={"consistent-type-assertions":m},g=t({meta:{name:`@longzai-intelligence-oxlint/typescript-eslint-plugin`},rules:h});export{m as consistentTypeAssertionsRule,g as default,g as typescriptEslintPlugin,h as typescriptEslintRules};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@longzai-intelligence-oxlint/typescript-eslint-plugin",
+  "version": "0.1.0",
+  "description": "Oxlint TypeScript ESLint 兼容插件，提供 typescript-eslint 规则的 Oxlint 实现",
+  "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"
+  }
+}