@utoo/lint 0.2.8 → 0.2.9

package/README.md

@@ -2,252 +2,226 @@
 
 ![utoo-lint logo](assets/utoo-lint-logo.svg)
 
-High performance linter for JavaScript and TypeScript written by Zig.
+[![npm version](https://img.shields.io/npm/v/%40utoo%2Flint?logo=npm)](https://www.npmjs.com/package/@utoo/lint)
+[![Node.js 20+](https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![CI](https://github.com/utooland/utoo-lint/actions/workflows/ci.yml/badge.svg)](https://github.com/utooland/utoo-lint/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/utooland/utoo-lint)](https://github.com/utooland/utoo-lint/blob/main/LICENSE)
 
-## Install
+A high-performance linter for JavaScript and TypeScript, written in Zig and
+powered by [Yuku](https://github.com/yuku-toolchain/yuku).
 
-```bash
-pnpm add -D @utoo/lint
-```
+`@utoo/lint` combines a native lint engine with familiar configuration, CLI,
+and JavaScript APIs.
 
-## CLI
+[Installation](#installation) · [Quick start](#quick-start) ·
+[Rules](https://github.com/utooland/utoo-lint/blob/main/docs/rule-status.md) ·
+[Configuration](https://github.com/utooland/utoo-lint/blob/main/docs/configuration.md) ·
+[GitHub](https://github.com/utooland/utoo-lint)
 
-Run the linter with:
+## Why utoo-lint?
 
-```bash
-pnpm exec utoo-lint src
-```
+- **Native performance** — Zig and Yuku power parsing, semantic analysis, and
+  parallel file linting.
+- **Broad rule coverage** — More than 300 rules cover JavaScript, TypeScript,
+  React, JSX accessibility, and imports.
+- **Familiar configuration** — Use typed `utlint.config.ts` or static
+  `utlint.config.json`, with ESLint-style rule names and severities.
+- **Practical workflows** — Safe autofix, suppression comments, JSON output,
+  and ESM/CommonJS APIs are included.
+- **Portable installation** — Prebuilt binaries are available for macOS,
+  Linux, and Windows on supported architectures.
 
-If no target is provided, `utoo-lint` uses `files` from the selected
-`utlint.config.ts` or `utlint.config.json`. When no config file or `files` entry
-exists, it scans the current directory. It skips `.git`, `.zig-cache`,
-`node_modules`, `vendor`, and `zig-out`.
+## Installation
 
-Use a config file:
+`@utoo/lint` requires Node.js 20 or later.
 
-```bash
-pnpm exec utoo-lint --config=utlint.config.json src
-```
+### utoo
 
-Run a focused rule set:
+[utoo](https://utoo.land/en/docs/utoo) is a fast, npm-compatible package
+manager written in Rust. Install it once if it is not already available:
 
 ```bash
-pnpm exec utoo-lint --rules=no-debugger,no-console src
+npm install -g utoo
 ```
 
-Use machine-readable output:
+Add `@utoo/lint` as a development dependency:
 
 ```bash
-pnpm exec utoo-lint --format=json src
+ut install @utoo/lint -D
 ```
 
-The default terminal output groups diagnostics by file, aligns their location
-and severity, and summarizes errors and warnings separately. Color is detected
-automatically; pass `--color` to force it or `--no-color` to disable it. JSON
-output remains stable for editor and CI integrations.
-
-## Autofix
-
-Apply safe fixes from all enabled rules that support autofix:
+In an existing project, run `ut install` without a package name to install all
+dependencies declared in `package.json`.
 
-```bash
-pnpm exec utoo-lint --fix src
-```
-
-Preview the result without changing files:
+### Other package managers
 
 ```bash
-pnpm exec utoo-lint --fix-dry-run --format=json src
+pnpm add -D @utoo/lint
+npm install --save-dev @utoo/lint
 ```
 
-`--fix` writes fixed source back to disk. `--fix-dry-run` never writes files;
-with JSON output, changed sources are returned in the `outputs` array. Fixes run
-until the source is stable, subject to a safety pass limit. Diagnostics remain
-when a rule or a particular code shape cannot be fixed safely. The current
-[rule status](https://github.com/fireairforce/utoo-lint/blob/main/docs/rule-status.md)
-lists autofix coverage by rule.
+The package selects the native binary for the current platform. No Zig
+toolchain is required.
 
-## Suppression comments
+## Quick start
 
-Suppress a rule for the next line of code with `utlint-ignore`:
+### Run with the default rules
 
-```js
-// utlint-ignore no-debugger: generated breakpoint
-debugger;
+```bash
+utx @utoo/lint src
 ```
 
-Omit the rule ID to suppress all lint rules for the next line of code. Use
-`utlint-ignore-all` before any code for a file-level suppression, or matching
-`utlint-ignore-start` and `utlint-ignore-end` comments for a range. Line and
-block comments are supported. Parse errors remain visible, and fixes from
-suppressed diagnostics are not applied.
+Without a config file, `utoo-lint` uses its built-in default rules. It supports
+`.js`, `.jsx`, `.ts`, `.tsx`, `.mjs`, `.cjs`, `.mts`, and `.cts` files.
 
-Native reports expose suppressed items in `suppressedDiagnostics`; the ESLint
-compatibility API exposes them in `suppressedMessages`.
+### Add a typed config
 
-## Configuration
+Create `utlint.config.ts`:
 
-`utoo-lint` supports two canonical project config formats:
+```ts
+import { defineConfig, globalIgnores } from "@utoo/lint/config";
+import frontend from "@utoo/lint/configs/frontend";
 
-| Config | Use it when | Raw native binary |
-| --- | --- | --- |
-| `utlint.config.ts` | You want typed authoring, imports, or computed values. | No |
-| `utlint.config.json` | You want a static, runtime-independent config. | Yes |
+export default defineConfig(
+  globalIgnores(["dist/", "coverage/"]),
+  {
+    ...frontend,
+    files: ["src/**/*.{js,jsx,ts,tsx}"],
+    rules: {
+      ...frontend.rules,
+      "no-console": "warn"
+    }
+  }
+);
+```
 
-The npm CLI discovers either format automatically. It can also select one
-explicitly:
+The CLI discovers the config and uses its `files` patterns:
 
 ```bash
-pnpm exec utoo-lint --config=utlint.config.ts src
-pnpm exec utoo-lint --config=utlint.config.json src
+utx @utoo/lint
 ```
 
-For a static config readable by both the npm CLI and raw native binary, create
-`utlint.config.json`:
+See the
+[configuration guide](https://github.com/utooland/utoo-lint/blob/main/docs/configuration.md)
+for flat config arrays, global ignores, rule options, and config precedence.
+
+### Add package scripts
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/fireairforce/utoo-lint/main/npm/utoo-lint/schema.json",
-  "files": ["src/**/*.{js,jsx,ts,tsx}"],
-  "ignores": ["dist", "node_modules"],
-  "rules": {
-    "no-console": "off",
-    "no-debugger": "error"
+  "scripts": {
+    "lint": "utoo-lint src",
+    "lint:fix": "utoo-lint --fix src"
   }
 }
 ```
 
-For a typed config executed by the npm/Node CLI, create `utlint.config.ts`:
+With utoo, run these scripts as `ut lint` and `ut lint:fix`.
 
-```ts
-import { defineConfig } from "@utoo/lint/config";
-
-export default defineConfig({
-  files: ["src/**/*.{js,jsx,ts,tsx}"],
-  ignores: ["dist", "node_modules"],
-  rules: {
-    "no-console": "off",
-    "no-debugger": "error"
-  }
-});
-```
+## Common commands
 
-The packaged frontend preset is also available as a typed config import:
+| Task | Command |
+| --- | --- |
+| Lint files | `utx @utoo/lint src` |
+| Apply safe fixes | `utx @utoo/lint --fix src` |
+| Preview fixes as JSON | `utx @utoo/lint --fix-dry-run --format=json src` |
+| Select rules for one run | `utx @utoo/lint --rules=no-debugger,no-unused-vars src` |
+| Use an explicit config | `utx @utoo/lint --config=utlint.config.json src` |
 
-```ts
-import { defineConfig } from "@utoo/lint/config";
-import frontend from "@utoo/lint/configs/frontend";
+Run `utx @utoo/lint --help` for all CLI options.
 
-export default defineConfig({
-  ...frontend,
-  rules: {
-    ...frontend.rules,
-    "no-console": "off",
-  },
-});
-```
+## Configuration
 
-Use `globalIgnores()` as a separate config entry when files or directories
-must be excluded from every entry:
+`utoo-lint` supports two canonical config formats. They are alternative
+representations of one active config and are not merged together.
 
-```ts
-import { defineConfig, globalIgnores } from "@utoo/lint/config";
+| Config | Best for | Raw native binary |
+| --- | --- | --- |
+| `utlint.config.ts` | Typed authoring, imports, presets, and computed values | No |
+| `utlint.config.json` | Static configuration and JSON Schema validation | Yes |
 
-export default defineConfig(
-  globalIgnores(["dist/", ".next/", "**/generated/"]),
-  {
-    files: ["**/*.{js,jsx,ts,tsx}"],
-    rules: {
-      "no-debugger": "error"
-    }
-  }
-);
+Rule severities follow ESLint conventions: `off`, `warn`, `error`, `0`, `1`,
+and `2`. A selected config enables only the rules present in its resolved
+`rules` map.
+
+The npm CLI and JavaScript API load both formats. The raw native binary loads
+JSON only. See the
+[configuration guide](https://github.com/utooland/utoo-lint/blob/main/docs/configuration.md)
+for the complete behavior.
+
+## Autofix
+
+Apply safe fixes in place:
+
+```bash
+utx @utoo/lint --fix src
 ```
 
-`globalIgnores()` returns an ignore-only object containing `ignores` and a
-generated `name`. Only such global entries prune directories during target
-discovery. By contrast, `ignores` beside `files`, `rules`, or another config
-key is entry-scoped: it prevents that entry from applying to matching files,
-but does not exclude them from other entries. With no CLI targets, global
-ignores filter the config's `files` patterns, or the current-directory scan
-when no `files` are configured. Directory patterns such as `dist/` and
-`.next/` are relative to the config; use `**/generated/` to match at any depth.
-This intentionally follows [ESLint flat config ignore semantics](https://eslint.org/docs/latest/use/configure/ignore).
-
-The two canonical names represent one active config and are not implicitly
-merged. For the npm/Node entry point, discovery is nearest-directory-first.
-Within the same directory, `utlint.config.ts` takes precedence over
-`utlint.config.json`; deprecated `utoo.json` and `utoo-lint.json` files are
-checked afterward for temporary backward compatibility. Rule-related CLI
-options such as `--rules`, individual rule toggles, and fishlint's `--rule` are
-applied after the selected config.
-
-Project-config `files` and `ignores` patterns are relative to the selected
-config file's directory. In a flat config array, they select the entries that
-apply to each file; matching entries are combined in order and later rule
-values override earlier values. The npm CLI, JavaScript API, and fishlint
-compatibility command perform this rule resolution per file.
-
-TypeScript config is trusted executable code. Its default export must be a
-JSON-serializable object or flat config array. The npm wrapper executes it and
-materializes the result as JSON before invoking the native binary. The raw
-binary does not execute or discover TypeScript; it searches for
-`utlint.config.json` and then the legacy JSON names. Direct native use therefore
-requires a JSON config. The raw binary applies only its `rules`;
-config-driven `files` and `ignores` filtering and default target selection are
-npm/Node wrapper features. Pass lint targets explicitly when invoking the raw
-binary. As in ESLint, selecting a config disables rules not present in its
-resolved `rules` map. When no config is selected, utoo-lint uses its built-in
-default rules.
-
-Rule severities use ESLint's exit behavior: warnings are reported with exit
-status 0, while errors return exit status 1. Use fishlint's `--max-warnings`
-option when warnings should fail CI.
-
-Start from the packaged frontend template:
+Preview fixes without writing files:
 
 ```bash
-cp node_modules/@utoo/lint/configs/frontend.json utlint.config.json
+utx @utoo/lint --fix-dry-run --format=json src
 ```
 
-## ESLint Migration
+Fixes run until the source is stable, subject to a safety pass limit. The
+[rule status](https://github.com/utooland/utoo-lint/blob/main/docs/rule-status.md)
+documents autofix support for each rule.
 
-Convert an existing ESLint config into the native utoo format:
+## Suppression comments
 
-```bash
-pnpm exec utoo-lint migrate eslint --from eslint.config.js --output utlint.config.json
+Use suppression comments for intentional exceptions without disabling a rule
+in project configuration:
+
+```js
+// utlint-ignore no-debugger: generated breakpoint
+debugger;
 ```
 
-The package also provides compatibility bins for common replacement flows:
+| Directive | Scope |
+| --- | --- |
+| `utlint-ignore [rule]` | The next line of code |
+| `utlint-ignore-all [rule]` | The entire file when placed before any code |
+| `utlint-ignore-start [rule]` | The start of a suppressed range |
+| `utlint-ignore-end [rule]` | The end of a suppressed range |
+
+A directive may target one rule ID. Omitting it creates or closes an all-rules
+suppression. Parse errors are never suppressed, and suppressed fixes are not
+applied.
+
+See the
+[suppression comments guide](https://github.com/utooland/utoo-lint/blob/main/docs/suppressions.md)
+for range examples and API behavior.
+
+## Migrating from ESLint
+
+Convert an existing ESLint config into a native utoo-lint config:
 
 ```bash
-pnpm exec eslint --config utlint.config.json src
-pnpm exec fishlint eslint --disable-setup --config utlint.config.json --glob src
+utx @utoo/lint migrate eslint \
+  --from eslint.config.js \
+  --output utlint.config.json
 ```
 
+The package also exposes `eslint` and `fishlint` compatibility commands for
+incremental replacement workflows. See the
+[migration guide](https://github.com/utooland/utoo-lint/blob/main/docs/eslint-migration.md)
+for supported mappings and known differences.
+
 ## JavaScript API
 
+The package provides ESM and CommonJS entry points:
+
 ```js
 import { lintFiles } from "@utoo/lint";
 
 const report = lintFiles(["src"], {
-  config: "utlint.config.json",
-  rules: ["no-debugger"]
+  config: "utlint.config.ts"
 });
 
 console.log(report.diagnostics);
 ```
 
-Calling `lintFiles()` without patterns follows the same default target behavior
-as the CLI, so migration scripts usually do not need to expand config `files`
-manually.
-
-CommonJS is supported through `require("@utoo/lint")`.
-
-Set `fix: true` to compute fixed output through the JavaScript API. Raw
-`lintFiles()` and `lintText()` reports expose changed sources in `outputs`
-without writing them. The ESLint-compatible API follows the usual two-step
-flow:
+An ESLint-style API is also available:
 
 ```js
 import { ESLint } from "@utoo/lint";
@@ -257,8 +231,33 @@ const results = await eslint.lintFiles(["src"]);
 await ESLint.outputFixes(results);
 ```
 
-## Binary Resolution
+Raw reports include active diagnostics, suppressed diagnostics, fixed outputs,
+and an exit code. The compatibility layer also exports `Linter`, `CLIEngine`,
+`RuleTester`, and `SourceCode` APIs.
+
+## Supported platforms
+
+The package installs a platform-specific optional dependency containing the
+native binary.
+
+| Operating system | Architectures |
+| --- | --- |
+| macOS | arm64, x64 |
+| Linux | arm64, x64 |
+| Windows | x64 |
+
+Set `UTOO_LINT_BIN=/path/to/utoo-lint` to use a custom binary during local
+development.
+
+## Documentation
+
+- [Rule status](https://github.com/utooland/utoo-lint/blob/main/docs/rule-status.md)
+- [Configuration](https://github.com/utooland/utoo-lint/blob/main/docs/configuration.md)
+- [Suppression comments](https://github.com/utooland/utoo-lint/blob/main/docs/suppressions.md)
+- [Migrating from ESLint](https://github.com/utooland/utoo-lint/blob/main/docs/eslint-migration.md)
+- [Benchmarks](https://github.com/utooland/utoo-lint/tree/main/benchmarks)
+- [Security policy](https://github.com/utooland/utoo-lint/blob/main/SECURITY.md)
+
+## License
 
-`@utoo/lint` installs a platform-specific optional dependency containing the
-native `utoo-lint` binary. Set `UTOO_LINT_BIN=/path/to/utoo-lint` to force a
-specific binary during local development.
+[MIT](https://github.com/utooland/utoo-lint/blob/main/LICENSE)

package/bin/migrate.js

@@ -16,7 +16,14 @@ const JAVASCRIPT_CONFIG_EXTENSIONS = new Set([".js", ".mjs", ".cjs"]);
 const IGNORED_RULES = new Map([
   ["prettier/prettier", "formatting is outside utoo-lint"]
 ]);
-const SCHEMA_URL = "https://raw.githubusercontent.com/fireairforce/utoo-lint/main/npm/utoo-lint/schema.json";
+const RULE_ALIASES = new Map([
+  ["@eslint-react/no-array-index-key", "react/no-array-index-key"],
+  ["@eslint-react/dom-no-find-dom-node", "react/no-find-dom-node"],
+  ["@eslint-react/dom-no-render-return-value", "react/no-render-return-value"],
+  ["@eslint-react/dom-no-void-elements-with-children", "react/void-dom-elements-no-children"],
+  ["@eslint-react/rules-of-hooks", "react-hooks/rules-of-hooks"]
+]);
+const SCHEMA_URL = "https://raw.githubusercontent.com/utooland/utoo-lint/main/npm/utoo-lint/schema.json";
 const JAVASCRIPT_CONFIG_LOADER_SCRIPT = `
 import { writeFileSync } from "node:fs";
 import { pathToFileURL } from "node:url";
@@ -178,43 +185,41 @@ function migrateEslintConfig(options) {
   const eslintConfig = loadEslintConfig(sourcePath, options.cwd);
   const supportedRuleIds = new Set(new Linter().getRules().keys());
   const entries = normalizeConfigEntries(eslintConfig);
-  const rules = {};
-  const files = new Set();
-  const ignores = new Set();
+  const migratedEntries = [];
   const supportedRules = [];
   const unsupportedRules = [];
   const ignoredRules = [];
+  const translatedRules = [];
 
   for (const entry of entries) {
-    addPatterns(files, entry.files);
-    addPatterns(ignores, entry.ignores);
-    if (!entry.rules || typeof entry.rules !== "object") {
-      continue;
-    }
-    for (const [ruleId, ruleConfig] of Object.entries(entry.rules)) {
-      if (IGNORED_RULES.has(ruleId)) {
-        ignoredRules.push({ ruleId, reason: IGNORED_RULES.get(ruleId) });
-        continue;
+    const rules = {};
+    if (entry.rules && typeof entry.rules === "object") {
+      for (const [ruleId, ruleConfig] of Object.entries(entry.rules)) {
+        const migratedRuleId = RULE_ALIASES.get(ruleId) ?? ruleId;
+        if (IGNORED_RULES.has(ruleId)) {
+          ignoredRules.push({ ruleId, reason: IGNORED_RULES.get(ruleId) });
+          continue;
+        }
+        if (!supportedRuleIds.has(migratedRuleId)) {
+          if (isRuleDisabled(ruleConfig)) {
+            continue;
+          }
+          unsupportedRules.push(ruleId);
+          continue;
+        }
+        rules[migratedRuleId] = migratableRuleConfig(ruleConfig);
+        supportedRules.push(migratedRuleId);
+        if (migratedRuleId !== ruleId) {
+          translatedRules.push({ sourceRuleId: ruleId, targetRuleId: migratedRuleId });
+        }
       }
-      if (!supportedRuleIds.has(ruleId)) {
-        unsupportedRules.push(ruleId);
-        continue;
-      }
-      rules[ruleId] = migratableRuleConfig(ruleConfig);
-      supportedRules.push(ruleId);
     }
+    migratedEntries.push(migratableConfigEntry(entry, rules));
   }
 
-  const config = {
-    $schema: SCHEMA_URL
-  };
-  if (files.size > 0) {
-    config.files = [...files];
-  }
-  if (ignores.size > 0) {
-    config.ignores = [...ignores];
-  }
-  config.rules = sortObjectByKey(rules);
+  const config = Array.isArray(eslintConfig)
+    ? [{ $schema: SCHEMA_URL }, ...migratedEntries]
+    : { $schema: SCHEMA_URL, ...(migratedEntries[0] ?? { rules: {} }) };
 
   return {
     config,
@@ -224,6 +229,7 @@ function migrateEslintConfig(options) {
       supportedRules: uniqueSorted(supportedRules),
       unsupportedRules: uniqueSorted(unsupportedRules),
       ignoredRules: uniqueByRuleId(ignoredRules),
+      translatedRules: uniqueTranslatedRules(translatedRules),
       optionDroppedRules: []
     }
   };
@@ -282,21 +288,54 @@ function normalizeConfigEntries(config) {
   return [];
 }
 
-function addPatterns(target, value) {
-  if (!value) {
-    return;
+function migratableConfigEntry(entry, rules) {
+  const migrated = {};
+  if (typeof entry.name === "string") {
+    migrated.name = entry.name;
+  }
+  const files = migratablePatterns(entry.files);
+  if (files.length > 0) {
+    migrated.files = files;
+  }
+  const ignores = migratablePatterns(entry.ignores);
+  if (ignores.length > 0) {
+    migrated.ignores = ignores;
   }
+  if (!isGlobalIgnoreEntry(entry)) {
+    migrated.rules = sortObjectByKey(rules);
+  }
+  return migrated;
+}
+
+function migratablePatterns(value) {
+  const patterns = [];
+  collectMigratablePatterns(value, patterns);
+  return [...new Set(patterns)];
+}
+
+function collectMigratablePatterns(value, patterns) {
   for (const pattern of Array.isArray(value) ? value : [value]) {
-    if (typeof pattern === "string") {
-      target.add(pattern);
+    if (Array.isArray(pattern)) {
+      collectMigratablePatterns(pattern, patterns);
+    } else if (typeof pattern === "string") {
+      patterns.push(pattern);
     }
   }
 }
 
+function isGlobalIgnoreEntry(entry) {
+  return Boolean(entry.ignores) && Object.keys(entry).every((key) => key === "name" || key === "ignores");
+}
+
 function migratableRuleConfig(ruleConfig) {
   return Array.isArray(ruleConfig) ? [...ruleConfig] : ruleConfig;
 }
 
+function isRuleDisabled(ruleConfig) {
+  const severity = Array.isArray(ruleConfig) ? ruleConfig[0] : ruleConfig;
+  return severity === "off" || severity === 0 || severity === false;
+}
+
 function sortObjectByKey(object) {
   return Object.fromEntries(Object.entries(object).sort(([left], [right]) => left.localeCompare(right)));
 }
@@ -313,6 +352,14 @@ function uniqueByRuleId(values) {
   return [...result.values()].sort((left, right) => left.ruleId.localeCompare(right.ruleId));
 }
 
+function uniqueTranslatedRules(values) {
+  const result = new Map();
+  for (const value of values) {
+    result.set(value.sourceRuleId, value);
+  }
+  return [...result.values()].sort((left, right) => left.sourceRuleId.localeCompare(right.sourceRuleId));
+}
+
 function writeReport(report, options, stream) {
   if (options.report === "json") {
     stream.write(JSON.stringify(report, null, 2) + "\n");
@@ -324,6 +371,9 @@ function writeReport(report, options, stream) {
     stream.write(`utoo-lint migrate eslint: wrote ${report.output}\n`);
   }
   stream.write(`utoo-lint migrate eslint: migrated ${report.supportedRules.length} supported rule(s)\n`);
+  if (report.translatedRules.length > 0) {
+    stream.write(`utoo-lint migrate eslint: translated ${report.translatedRules.length} rule alias(es): ${report.translatedRules.map((rule) => `${rule.sourceRuleId} -> ${rule.targetRuleId}`).join(", ")}\n`);
+  }
   if (report.ignoredRules.length > 0) {
     stream.write(`utoo-lint migrate eslint: ignored ${report.ignoredRules.length} rule(s): ${report.ignoredRules.map((rule) => rule.ruleId).join(", ")}\n`);
   }

package/configs/frontend.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://raw.githubusercontent.com/fireairforce/utoo-lint/main/npm/utoo-lint/schema.json",
+  "$schema": "https://raw.githubusercontent.com/utooland/utoo-lint/main/npm/utoo-lint/schema.json",
   "rules": {
     "no-debugger": "error",
     "no-alert": "error",

package/index.cjs

@@ -305,6 +305,11 @@ const BUILTIN_RULE_IDS = [
   "import/no-named-as-default-member",
   "import/no-unresolved",
   "import/no-self-import",
+  "promise/no-promise-in-callback",
+  "promise/no-return-in-finally",
+  "promise/no-return-wrap",
+  "promise/param-names",
+  "promise/valid-params",
   "jsx-a11y/alt-text",
   "jsx-a11y/anchor-has-content",
   "jsx-a11y/aria-props",
@@ -318,6 +323,11 @@ const BUILTIN_RULE_IDS = [
   "jsx-a11y/role-has-required-aria-props",
   "jsx-a11y/role-supports-aria-props",
   "jsx-a11y/scope",
+  "promise/always-return",
+  "promise/catch-or-return",
+  "promise/no-callback-in-promise",
+  "promise/no-nesting",
+  "promise/no-new-statics",
   "react/button-has-type",
   "react/default-props-match-prop-types",
   "react/display-name",
@@ -358,7 +368,9 @@ const BUILTIN_RULE_IDS = [
   "react/self-closing-comp",
   "react/style-prop-object",
   "react/void-dom-elements-no-children",
+  "react-hooks/exhaustive-deps",
   "react-hooks/rules-of-hooks",
+  "unused-imports/no-unused-imports",
   "@typescript-eslint/adjacent-overload-signatures",
   "@typescript-eslint/array-type",
   "@typescript-eslint/ban-ts-comment",
@@ -376,6 +388,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-dupe-class-members",
   "@typescript-eslint/no-empty-function",
   "@typescript-eslint/no-empty-interface",
+  "@typescript-eslint/no-empty-object-type",
   "@typescript-eslint/no-duplicate-enum-values",
   "@typescript-eslint/no-extra-semi",
   "@typescript-eslint/no-extra-non-null-assertion",
@@ -391,6 +404,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-shadow",
   "@typescript-eslint/no-this-alias",
   "@typescript-eslint/no-unsafe-declaration-merging",
+  "@typescript-eslint/no-unsafe-function-type",
   "@typescript-eslint/triple-slash-reference",
   "@typescript-eslint/typedef",
   "@typescript-eslint/unified-signatures",
@@ -434,7 +448,11 @@ const NATIVE_ONLY_RULE_IDS = [
   "semantic-errors"
 ];
 const NATIVE_RULE_IDS = [...BUILTIN_RULE_IDS, ...NATIVE_ONLY_RULE_IDS];
-const FIXABLE_BUILTIN_RULE_IDS = new Set(["no-extra-semi", "@typescript-eslint/no-extra-semi"]);
+const FIXABLE_BUILTIN_RULE_IDS = new Set([
+  "no-extra-semi",
+  "@typescript-eslint/no-extra-semi",
+  "unused-imports/no-unused-imports"
+]);
 const BUILTIN_RULES = new Map(BUILTIN_RULE_IDS.map((ruleId) => [ruleId, createBuiltinRule(ruleId)]));
 
 class UtooLint {

package/index.js

@@ -308,6 +308,11 @@ const BUILTIN_RULE_IDS = [
   "import/no-named-as-default-member",
   "import/no-unresolved",
   "import/no-self-import",
+  "promise/no-promise-in-callback",
+  "promise/no-return-in-finally",
+  "promise/no-return-wrap",
+  "promise/param-names",
+  "promise/valid-params",
   "jsx-a11y/alt-text",
   "jsx-a11y/anchor-has-content",
   "jsx-a11y/aria-props",
@@ -321,6 +326,11 @@ const BUILTIN_RULE_IDS = [
   "jsx-a11y/role-has-required-aria-props",
   "jsx-a11y/role-supports-aria-props",
   "jsx-a11y/scope",
+  "promise/always-return",
+  "promise/catch-or-return",
+  "promise/no-callback-in-promise",
+  "promise/no-nesting",
+  "promise/no-new-statics",
   "react/button-has-type",
   "react/default-props-match-prop-types",
   "react/display-name",
@@ -361,7 +371,9 @@ const BUILTIN_RULE_IDS = [
   "react/self-closing-comp",
   "react/style-prop-object",
   "react/void-dom-elements-no-children",
+  "react-hooks/exhaustive-deps",
   "react-hooks/rules-of-hooks",
+  "unused-imports/no-unused-imports",
   "@typescript-eslint/adjacent-overload-signatures",
   "@typescript-eslint/array-type",
   "@typescript-eslint/ban-ts-comment",
@@ -379,6 +391,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-dupe-class-members",
   "@typescript-eslint/no-empty-function",
   "@typescript-eslint/no-empty-interface",
+  "@typescript-eslint/no-empty-object-type",
   "@typescript-eslint/no-duplicate-enum-values",
   "@typescript-eslint/no-extra-semi",
   "@typescript-eslint/no-extra-non-null-assertion",
@@ -394,6 +407,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-shadow",
   "@typescript-eslint/no-this-alias",
   "@typescript-eslint/no-unsafe-declaration-merging",
+  "@typescript-eslint/no-unsafe-function-type",
   "@typescript-eslint/triple-slash-reference",
   "@typescript-eslint/typedef",
   "@typescript-eslint/unified-signatures",
@@ -437,7 +451,11 @@ const NATIVE_ONLY_RULE_IDS = [
   "semantic-errors"
 ];
 const NATIVE_RULE_IDS = [...BUILTIN_RULE_IDS, ...NATIVE_ONLY_RULE_IDS];
-const FIXABLE_BUILTIN_RULE_IDS = new Set(["no-extra-semi", "@typescript-eslint/no-extra-semi"]);
+const FIXABLE_BUILTIN_RULE_IDS = new Set([
+  "no-extra-semi",
+  "@typescript-eslint/no-extra-semi",
+  "unused-imports/no-unused-imports"
+]);
 const BUILTIN_RULES = new Map(BUILTIN_RULE_IDS.map((ruleId) => [ruleId, createBuiltinRule(ruleId)]));
 
 export class UtooLint {

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@utoo/lint",
-  "version": "0.2.8",
-  "description": "Experimental JavaScript and TypeScript linter powered by Yuku",
+  "version": "0.2.9",
+  "description": "High-performance JavaScript and TypeScript linter powered by Yuku",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/fireairforce/utoo-lint.git"
+    "url": "git+https://github.com/utooland/utoo-lint.git"
   },
   "bugs": {
-    "url": "https://github.com/fireairforce/utoo-lint/issues"
+    "url": "https://github.com/utooland/utoo-lint/issues"
   },
-  "homepage": "https://github.com/fireairforce/utoo-lint#readme",
+  "homepage": "https://github.com/utooland/utoo-lint#readme",
   "type": "module",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "types": "./index.d.ts",
   "exports": {
@@ -76,11 +76,11 @@
     "use-at-your-own-risk.js"
   ],
   "optionalDependencies": {
-    "@utoo/lint-darwin-arm64": "0.2.8",
-    "@utoo/lint-darwin-x64": "0.2.8",
-    "@utoo/lint-linux-arm64": "0.2.8",
-    "@utoo/lint-linux-x64": "0.2.8",
-    "@utoo/lint-win32-x64": "0.2.8"
+    "@utoo/lint-darwin-arm64": "0.2.9",
+    "@utoo/lint-darwin-x64": "0.2.9",
+    "@utoo/lint-linux-arm64": "0.2.9",
+    "@utoo/lint-linux-x64": "0.2.9",
+    "@utoo/lint-win32-x64": "0.2.9"
   },
   "dependencies": {
     "jiti": "2.7.0"

package/schema.json

@@ -1,50 +1,63 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema",
-  "$id": "https://raw.githubusercontent.com/fireairforce/utoo-lint/main/npm/utoo-lint/schema.json",
+  "$id": "https://raw.githubusercontent.com/utooland/utoo-lint/main/npm/utoo-lint/schema.json",
   "title": "utoo-lint configuration",
-  "type": "object",
-  "additionalProperties": true,
-  "properties": {
-    "$schema": {
-      "type": "string"
+  "oneOf": [
+    {
+      "$ref": "#/definitions/configObject"
     },
-    "rules": {
-      "description": "ESLint-compatible rule severity map. Unknown rule names are rejected by utoo-lint.",
-      "type": "object",
-      "additionalProperties": {
-        "$ref": "#/definitions/ruleSeverity"
+    {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/configObject"
       }
-    },
-    "files": {
-      "description": "File globs this config entry applies to.",
-      "oneOf": [
-        {
+    }
+  ],
+  "definitions": {
+    "configObject": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "$schema": {
           "type": "string"
         },
-        {
-          "type": "array",
-          "items": {
-            "type": "string"
+        "rules": {
+          "description": "ESLint-compatible rule severity map. Unknown rule names are rejected by utoo-lint.",
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ruleSeverity"
           }
-        }
-      ]
-    },
-    "ignores": {
-      "description": "File globs ignored by this config entry.",
-      "oneOf": [
-        {
-          "type": "string"
         },
-        {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
+        "files": {
+          "description": "File globs this config entry applies to.",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "ignores": {
+          "description": "File globs ignored by this config entry.",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
         }
-      ]
-    }
-  },
-  "definitions": {
+      }
+    },
     "ruleSeverity": {
       "oneOf": [
         {