@kingsword/lint-config

可复用的 oxlint 配置与 @kingsword/* 规则插件。

要求：oxlint >= 1.50.0

安装

npm i -D oxlint @kingsword/lint-config

推荐用法（CLI 生成）

# 生成 oxlint.config.ts（默认 lib + none + recommended）
npx xlint init lib

# 更严格示例
npx xlint init fullstack --test vitest --level strict

生成后执行：

npx oxlint .

手写配置

import { defineConfig } from "oxlint";
import { oxlint } from "@kingsword/lint-config/config";

export default defineConfig(
  oxlint({
    profile: "lib",
    test: "none",
    level: "recommended",
  }),
);

参数说明

• profile: base | lib | react | backend | fullstack
• test: none | vitest
• level: recommended | strict

oxlint() 无参数时，默认使用最严格推荐档（fullstack-vitest-strict）。

1.50 升级重点

• vitest-strict 默认启用 vitest/prefer-import-in-mock
• vitest-strict 默认启用 no-use-before-define
• vitest-strict 默认启用 no-shadow
• vitest-strict 默认启用 no-unmodified-loop-condition
• vitest-strict 默认启用 unicorn/prefer-module
• vitest-strict 默认启用 node/no-path-concat
• vitest-strict 不默认强制 Vitest globals/import 二选一（减少与不同项目测试风格的冲突）
• base 默认启用 typescript/consistent-type-assertions
• frontend 默认启用 unicorn/relative-url-style
• vitest 默认启用 vitest/prefer-expect-type-of
• oxlint.config.ts 的 extends 需使用“配置对象数组”，不再支持字符串路径

规则文档

• docs/rules.zh-CN.md
• 文档已包含：自研 @kingsword/* 全部规则、内置规则（含 off 项）与 overrides 的完整中文说明

开发验证夹具（Smoke Fixtures）

仓库内用于 lint:* 脚本的最小验证样例位于：test/fixtures/smoke。

• base: test/fixtures/smoke/base/baseCase.ts
• recommended: test/fixtures/smoke/recommended/recommendedCase.ts
• frontend: test/fixtures/smoke/frontend/frontendCase.ts
• backend: test/fixtures/smoke/backend/backendCase.ts
• fullstack: test/fixtures/smoke/fullstack/fullstackCase.ts
• vitest / vitest:strict: test/fixtures/smoke/vitest/vitestCase.ts

说明：

• 这些夹具是“应当通过”的 smoke 用例，保持最小、稳定、可读。
• 规则触发/报错类断言放在 test/plugin.test.js 的场景测试中维护。