@longzai-intelligence-oxlint/tsconfig-plugin 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# @longzai-intelligence-oxlint/tsconfig-plugin
+
+## 意图
+
+在静态检查阶段守护 TypeScript 项目引用配置的规范性，避免 tsconfig 引用缺失导致的项目边界混乱。
+
+## 定位
+
+Oxlint 生态的 tsconfig 治理插件，通过 `eslintCompatPlugin` 包装以同时兼容 Oxlint 与 ESLint 运行时。
+
+## 职能
+
+提供 `tsconfig-references` 规则，校验 tsconfig.json 中 references 字段的完整性与规范性。
+
+## 实现情况
+
+当前仅落地项目引用约束一条规则，规则与插件对象均已导出；整体处于聚焦单点的成熟形态，未见其他规则占位。

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/tsconfig-plugin/tsconfig-references":`error`};export{e as recommended};

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+//#region src/rules/tsconfig-references.rule.d.ts
+/**
+ * tsconfig-references 规则定义
+ */
+declare const tsconfigReferencesRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/index.d.ts
+declare const tsconfigPlugin: import("@oxlint/plugins").Plugin;
+//#endregion
+export { tsconfigPlugin as default, tsconfigPlugin, tsconfigReferencesRule };

package/dist/index.js

@@ -0,0 +1 @@
+import{defineRule as e,eslintCompatPlugin as t}from"@oxlint/plugins";import{existsSync as n,readFileSync as r}from"node:fs";import{dirname as i,join as a}from"node:path";const o=[`app.json`,`node.json`,`test.json`],s=[`./tsconfig/app.json`,`./tsconfig/node.json`,`./tsconfig/test.json`];function c(e){let t=e.replace(/\\/g,`/`);return(t.split(`/`).pop()??``)===`tsconfig.json`&&!t.includes(`/tsconfig/`)}function l(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function u(e,t){return n(e)?!0:(t(`缺少 tsconfig/ 目录。请创建 tsconfig/ 目录并配置子配置文件。`),!1)}function d(e,t){for(let r of o)n(a(e,r))||t(`缺少必需的 tsconfig 子配置文件 tsconfig/${r}。`)}function f(e,t){(!(`files`in e)||!Array.isArray(e.files)||e.files.length>0)&&t(`tsconfig.json 的 files 字段应为空数组 []。根配置仅用于引用子配置。`)}function p(e){return l(e)&&`path`in e}function m(e,t){if(!(`references`in e)||!Array.isArray(e.references)){t(`tsconfig.json 必须包含 references 字段。请配置项目引用。`);return}let n=new Set(e.references.map(e=>p(e)?String(e.path):``));for(let e of s)n.has(e)||t(`tsconfig.json 缺少必需的引用 "${e}"。`)}function h(e,t){let n=JSON.parse(e);if(!l(n)){t(`tsconfig.json 内容不是有效的对象。`);return}f(n,t),m(n,t)}function g(e,t){try{let n=r(e,`utf-8`),o=a(i(e),`tsconfig`);if(!u(o,t))return;d(o,t),h(n,t)}catch{}}const _=e({meta:{type:`problem`,docs:{description:`检查 tsconfig.json 是否正确使用 references 配置`}},createOnce(e){return{before(){if(!c(e.filename))return!1},Program(t){g(e.filename,n=>{e.report({node:t,message:n})})}}}}),v=t({meta:{name:`@longzai-intelligence-oxlint/tsconfig-plugin`},rules:{"tsconfig-references":_}});export{v as default,v as tsconfigPlugin,_ as tsconfigReferencesRule};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@longzai-intelligence-oxlint/tsconfig-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"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.0.0"
+  }
+}