@utoo/lint 0.0.9 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 utoo-lint contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -7,7 +7,7 @@ High performance linter for JavaScript and TypeScript written by Zig.
 ## Install
 
 ```bash
-npm install -D @utoo/lint
+pnpm add -D @utoo/lint
 ```
 
 ## CLI
@@ -15,28 +15,30 @@ npm install -D @utoo/lint
 Run the linter with:
 
 ```bash
-npx utoo-lint src
+pnpm exec utoo-lint src
 ```
 
-If no target is provided, `utoo-lint` scans the current directory. It skips
-`.git`, `.zig-cache`, `node_modules`, `vendor`, and `zig-out`.
+If no target is provided, `utoo-lint` uses `files` from `utoo.json` or
+`utoo-lint.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`.
 
 Use a config file:
 
 ```bash
-npx utoo-lint --config=utoo.json src
+pnpm exec utoo-lint --config=utoo.json src
 ```
 
 Run a focused rule set:
 
 ```bash
-npx utoo-lint --rules=no-debugger,no-console src
+pnpm exec utoo-lint --rules=no-debugger,no-console src
 ```
 
 Use machine-readable output:
 
 ```bash
-npx utoo-lint --format=json src
+pnpm exec utoo-lint --format=json src
 ```
 
 ## Configuration
@@ -66,14 +68,14 @@ cp node_modules/@utoo/lint/configs/frontend.json utoo.json
 Convert an existing ESLint config into the native utoo format:
 
 ```bash
-npx utoo-lint migrate eslint --from eslint.config.js --output utoo.json
+pnpm exec utoo-lint migrate eslint --from eslint.config.js --output utoo.json
 ```
 
 The package also provides compatibility bins for common replacement flows:
 
 ```bash
-npx eslint --config utoo.json src
-npx fishlint eslint --disable-setup --config utoo.json --glob src
+pnpm exec eslint --config utoo.json src
+pnpm exec fishlint eslint --disable-setup --config utoo.json --glob src
 ```
 
 ## JavaScript API
@@ -89,6 +91,10 @@ const report = lintFiles(["src"], {
 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")`.
 
 ## Binary Resolution

package/bin/migrate.js

@@ -183,7 +183,6 @@ function migrateEslintConfig(options) {
   const supportedRules = [];
   const unsupportedRules = [];
   const ignoredRules = [];
-  const optionDroppedRules = [];
 
   for (const entry of entries) {
     addPatterns(files, entry.files);
@@ -200,11 +199,8 @@ function migrateEslintConfig(options) {
         unsupportedRules.push(ruleId);
         continue;
       }
-      rules[ruleId] = severityOnly(ruleConfig);
+      rules[ruleId] = migratableRuleConfig(ruleConfig);
       supportedRules.push(ruleId);
-      if (Array.isArray(ruleConfig) && ruleConfig.length > 1) {
-        optionDroppedRules.push(ruleId);
-      }
     }
   }
 
@@ -227,7 +223,7 @@ function migrateEslintConfig(options) {
       supportedRules: uniqueSorted(supportedRules),
       unsupportedRules: uniqueSorted(unsupportedRules),
       ignoredRules: uniqueByRuleId(ignoredRules),
-      optionDroppedRules: uniqueSorted(optionDroppedRules)
+      optionDroppedRules: []
     }
   };
 }
@@ -295,8 +291,8 @@ function addPatterns(target, value) {
   }
 }
 
-function severityOnly(ruleConfig) {
-  return Array.isArray(ruleConfig) ? ruleConfig[0] : ruleConfig;
+function migratableRuleConfig(ruleConfig) {
+  return Array.isArray(ruleConfig) ? [...ruleConfig] : ruleConfig;
 }
 
 function sortObjectByKey(object) {
@@ -326,9 +322,6 @@ 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.optionDroppedRules.length > 0) {
-    stream.write(`utoo-lint migrate eslint: dropped options for ${report.optionDroppedRules.length} rule(s): ${report.optionDroppedRules.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/bin/utoo-lint.js

@@ -1,23 +1,20 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
 
-import { resolveBinary } from "../lib/binary.js";
+import { runCli } from "../index.js";
 
 if (process.argv[2] === "migrate") {
   const { runMigrate } = await import("./migrate.js");
   process.exit(await runMigrate(process.argv.slice(3)));
 }
 
-let binary;
+let result;
 try {
-  binary = resolveBinary();
+  result = runCli(process.argv.slice(2), { stdio: "inherit" });
 } catch (error) {
   console.error(error.message);
   process.exit(1);
 }
 
-const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
-
 if (result.error) {
   console.error(`utoo-lint: failed to run native binary: ${result.error.message}`);
   process.exit(1);

package/index.cjs

@@ -83,9 +83,13 @@ process.stdout.write(json);
 const BUILTIN_RULE_IDS = [
   "accessor-pairs",
   "array-callback-return",
+  "arrow-body-style",
   "block-scoped-var",
+  "camelcase",
   "capitalized-comments",
+  "complexity",
   "consistent-return",
+  "consistent-this",
   "constructor-super",
   "curly",
   "default-case",
@@ -97,11 +101,23 @@ const BUILTIN_RULE_IDS = [
   "for-direction",
   "func-name-matching",
   "func-names",
+  "func-style",
   "getter-return",
   "grouped-accessor-pairs",
   "guard-for-in",
+  "id-denylist",
+  "id-length",
+  "id-match",
+  "init-declarations",
   "linebreak-style",
   "logical-assignment-operators",
+  "max-classes-per-file",
+  "max-depth",
+  "max-lines",
+  "max-lines-per-function",
+  "max-nested-callbacks",
+  "max-params",
+  "max-statements",
   "new-cap",
   "new-parens",
   "no-alert",
@@ -119,6 +135,7 @@ const BUILTIN_RULE_IDS = [
   "no-cond-assign",
   "no-console",
   "no-const-assign",
+  "no-constant-binary-expression",
   "no-constant-condition",
   "no-constructor-return",
   "no-continue",
@@ -155,6 +172,7 @@ const BUILTIN_RULE_IDS = [
   "no-global-is-finite",
   "no-global-is-nan",
   "no-implicit-coercion",
+  "no-implicit-globals",
   "no-implied-eval",
   "no-import-assign",
   "no-inline-comments",
@@ -196,6 +214,13 @@ const BUILTIN_RULE_IDS = [
   "no-promise-executor-return",
   "no-proto",
   "no-prototype-builtins",
+  "no-redeclare",
+  "no-restricted-exports",
+  "no-restricted-globals",
+  "no-restricted-imports",
+  "no-restricted-modules",
+  "no-restricted-properties",
+  "no-restricted-syntax",
   "no-regex-spaces",
   "no-return-assign",
   "no-return-await",
@@ -204,6 +229,7 @@ const BUILTIN_RULE_IDS = [
   "no-self-compare",
   "no-sequences",
   "no-setter-return",
+  "no-shadow",
   "no-shadow-restricted-names",
   "no-sparse-arrays",
   "no-tabs",
@@ -214,15 +240,21 @@ const BUILTIN_RULE_IDS = [
   "no-trailing-spaces",
   "no-undef",
   "no-undef-init",
+  "no-unassigned-vars",
   "no-underscore-dangle",
   "no-undefined",
   "no-unneeded-ternary",
   "no-unreachable",
+  "no-unreachable-loop",
   "no-unsafe-finally",
   "no-unsafe-negation",
+  "no-unsafe-optional-chaining",
   "no-unused-expressions",
   "no-unused-labels",
+  "no-unused-private-class-members",
   "no-unused-vars",
+  "no-use-before-define",
+  "no-useless-backreference",
   "no-useless-call",
   "no-useless-catch",
   "no-useless-computed-key",
@@ -238,13 +270,16 @@ const BUILTIN_RULE_IDS = [
   "object-shorthand",
   "one-var",
   "operator-assignment",
+  "prefer-arrow-callback",
   "prefer-const",
   "prefer-destructuring",
   "prefer-exponentiation-operator",
+  "prefer-named-capture-group",
   "prefer-numeric-literals",
   "prefer-object-has-own",
   "prefer-object-spread",
   "prefer-promise-reject-errors",
+  "preserve-caught-error",
   "prefer-regex-literals",
   "prefer-rest-params",
   "prefer-spread",
@@ -252,8 +287,13 @@ const BUILTIN_RULE_IDS = [
   "radix",
   "require-await",
   "require-atomic-updates",
+  "require-unicode-regexp",
   "require-yield",
+  "sort-imports",
+  "sort-keys",
+  "sort-vars",
   "spaced-comment",
+  "strict",
   "symbol-description",
   "unicode-bom",
   "use-isnan",
@@ -261,6 +301,7 @@ const BUILTIN_RULE_IDS = [
   "vars-on-top",
   "wrap-iife",
   "yoda",
+  "eslint-comments/no-restricted-disable",
   "import/default",
   "import/export",
   "import/first",
@@ -274,22 +315,59 @@ const BUILTIN_RULE_IDS = [
   "import/no-named-as-default-member",
   "import/no-unresolved",
   "import/no-self-import",
+  "jsx-a11y/alt-text",
+  "jsx-a11y/anchor-has-content",
   "jsx-a11y/aria-props",
+  "jsx-a11y/aria-proptypes",
+  "jsx-a11y/aria-role",
+  "jsx-a11y/aria-unsupported-elements",
   "jsx-a11y/iframe-has-title",
   "jsx-a11y/img-redundant-alt",
   "jsx-a11y/no-access-key",
+  "jsx-a11y/no-distracting-elements",
+  "jsx-a11y/role-has-required-aria-props",
+  "jsx-a11y/role-supports-aria-props",
+  "jsx-a11y/scope",
+  "react/button-has-type",
+  "react/default-props-match-prop-types",
+  "react/display-name",
+  "react/forbid-prop-types",
   "react/jsx-boolean-value",
+  "react/jsx-filename-extension",
+  "react/jsx-key",
+  "react/jsx-no-bind",
   "react/jsx-no-comment-textnodes",
   "react/jsx-no-duplicate-props",
+  "react/jsx-no-undef",
+  "react/jsx-uses-react",
+  "react/jsx-uses-vars",
   "react/jsx-no-target-blank",
   "react/jsx-pascal-case",
+  "react/no-access-state-in-setstate",
+  "react/no-array-index-key",
+  "react/no-children-prop",
   "react/no-danger",
+  "react/no-danger-with-children",
+  "react/no-deprecated",
   "react/no-find-dom-node",
   "react/no-is-mounted",
+  "react/no-multi-comp",
+  "react/no-redundant-should-component-update",
   "react/no-render-return-value",
+  "react/no-string-refs",
+  "react/no-this-in-sfc",
+  "react/no-typos",
   "react/no-unescaped-entities",
+  "react/no-unknown-property",
   "react/no-unused-prop-types",
+  "react/no-unused-state",
+  "react/no-will-update-set-state",
+  "react/prefer-es6-class",
   "react/prop-types",
+  "react/require-render-return",
+  "react/self-closing-comp",
+  "react/style-prop-object",
+  "react/void-dom-elements-no-children",
   "react-hooks/rules-of-hooks",
   "@typescript-eslint/adjacent-overload-signatures",
   "@typescript-eslint/array-type",
@@ -313,6 +391,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-extra-non-null-assertion",
   "@typescript-eslint/no-inferrable-types",
   "@typescript-eslint/no-invalid-void-type",
+  "@typescript-eslint/no-loop-func",
   "@typescript-eslint/no-loss-of-precision",
   "@typescript-eslint/no-misused-new",
   "@typescript-eslint/no-namespace",
@@ -386,7 +465,7 @@ class UtooLint {
     this.options = { ...options };
   }
 
-  async lintFiles(patterns = ["."], options = {}) {
+  async lintFiles(patterns, options = {}) {
     const mergedOptions = mergeLintOptions(this.options, options);
     const customRuleConfig = [mergedOptions.baseConfig, mergedOptions.overrideConfig].filter(Boolean);
     const customRuleFilterMap = customRuleMapForConfig(customRuleConfig, new Map());
@@ -591,6 +670,152 @@ function run(args = [], options = {}) {
   });
 }
 
+const UTOO_LINT_CLI_VALUE_FLAGS = new Set(["--config", "-c", "--format", "-f", "--rules", "--threads"]);
+
+function parseUtooLintCliArgs(args = []) {
+  const values = normalizeStringArray(args, "args");
+  const passthroughArgs = [];
+  const targets = [];
+  const options = {};
+  let help = false;
+  let versionFlag = false;
+
+  for (let index = 0; index < values.length; index += 1) {
+    const arg = values[index];
+    if (arg === "--") {
+      targets.push(...values.slice(index + 1));
+      break;
+    }
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+      passthroughArgs.push(arg);
+      continue;
+    }
+    if (arg === "--version" || arg === "-v") {
+      versionFlag = true;
+      continue;
+    }
+    if (UTOO_LINT_CLI_VALUE_FLAGS.has(arg)) {
+      const value = values[index + 1];
+      if (!value) {
+        throw new Error(`utoo-lint: ${arg} requires a value`);
+      }
+      appendCliOption(passthroughArgs, options, arg, value);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--config=")) {
+      appendCliOption(passthroughArgs, options, "--config", arg.slice("--config=".length));
+      continue;
+    }
+    if (arg.startsWith("--format=")) {
+      appendCliOption(passthroughArgs, options, "--format", arg.slice("--format=".length));
+      continue;
+    }
+    if (arg.startsWith("--rules=")) {
+      appendCliOption(passthroughArgs, options, "--rules", arg.slice("--rules=".length));
+      continue;
+    }
+    if (arg.startsWith("--threads=")) {
+      appendCliOption(passthroughArgs, options, "--threads", arg.slice("--threads=".length));
+      continue;
+    }
+    if (arg === "--no-config") {
+      options.noConfig = true;
+      delete options.config;
+      continue;
+    }
+    if (arg === "--json") {
+      passthroughArgs.push(arg);
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      passthroughArgs.push(arg);
+      continue;
+    }
+    targets.push(arg);
+  }
+
+  return { help, options, passthroughArgs, targets, version: versionFlag };
+}
+
+function appendCliOption(passthroughArgs, options, flag, value) {
+  if (value == null || value === "") {
+    throw new Error(`utoo-lint: ${flag} requires a value`);
+  }
+  switch (flag) {
+    case "--config":
+    case "-c":
+      options.config = value;
+      delete options.noConfig;
+      return;
+    case "--format":
+    case "-f":
+      options.format = value;
+      return;
+    case "--rules":
+      options.rules = value;
+      return;
+    case "--threads":
+      options.threads = value;
+      return;
+    default:
+      passthroughArgs.push(`${flag}=${value}`);
+  }
+}
+
+function completedRunResult(status, stdout, stderr, options = {}) {
+  const inherited = options.stdio === "inherit";
+  if (inherited) {
+    if (stdout) {
+      process.stdout.write(stdout);
+    }
+    if (stderr) {
+      process.stderr.write(stderr);
+    }
+  }
+  return {
+    status,
+    signal: null,
+    error: undefined,
+    stdout: inherited ? null : stdout,
+    stderr: inherited ? null : stderr,
+    output: [null, inherited ? null : stdout, inherited ? null : stderr],
+    pid: 0
+  };
+}
+
+function runCli(args = [], options = {}) {
+  const parsed = parseUtooLintCliArgs(args);
+  if (parsed.version) {
+    return completedRunResult(0, `v${version}\n`, "", options);
+  }
+  if (parsed.help) {
+    return run(parsed.passthroughArgs, options);
+  }
+
+  const cliOptions = {
+    ...options,
+    ...parsed.options
+  };
+  const targets = parsed.targets.length > 0 ? parsed.targets : defaultLintTargets(cliOptions);
+  const ignoredDiagnostics = ignoredLintPathDiagnostics(targets, cliOptions);
+  const lintPaths = filteredLintPaths(targets, cliOptions);
+  if (lintPaths.length === 0) {
+    return completedRunResult(ignoredDiagnostics.length > 0 ? 1 : 0, "", "", options);
+  }
+
+  return withTemporaryConfig(cliOptions, (resolvedOptions) => {
+    const cliArgs = buildRunCliArgs(lintPaths, resolvedOptions, parsed.passthroughArgs);
+    return run(cliArgs, {
+      ...resolvedOptions,
+      stdio: options.stdio,
+      encoding: options.encoding,
+      input: options.input
+    });
+  });
+}
+
 function runFishlint(args = [], options = {}) {
   const cliArgs = normalizeStringArray(args, "args");
   const env = options.env ? { ...process.env, ...options.env } : { ...process.env };
@@ -803,14 +1028,15 @@ function booleanFlagValue(arg) {
   return true;
 }
 
-function lintFiles(paths = ["."], options = {}) {
-  return withTemporaryConfig(options, (resolvedOptions) => {
-    const ignoredDiagnostics = ignoredLintPathDiagnostics(paths, resolvedOptions);
-    const lintPaths = filteredLintPaths(paths, resolvedOptions);
-    if (lintPaths.length === 0) {
-      return { files: 0, filePaths: [], diagnostics: ignoredDiagnostics, exitCode: ignoredDiagnostics.length > 0 ? 1 : 0 };
-    }
+function lintFiles(paths, options = {}) {
+  const targets = lintTargetsForInput(paths, options);
+  const ignoredDiagnostics = ignoredLintPathDiagnostics(targets, options);
+  const lintPaths = filteredLintPaths(targets, options);
+  if (lintPaths.length === 0) {
+    return { files: 0, filePaths: [], diagnostics: ignoredDiagnostics, exitCode: ignoredDiagnostics.length > 0 ? 1 : 0 };
+  }
 
+  return withTemporaryConfig(options, (resolvedOptions) => {
     const cliArgs = buildLintArgs(lintPaths, resolvedOptions);
     const result = run(cliArgs, { ...resolvedOptions, stdio: undefined, encoding: "utf8" });
 
@@ -902,6 +1128,21 @@ function lintText(code, options = {}) {
 }
 
 function buildLintArgs(paths, options) {
+  return buildNativeLintArgs(paths, {
+    ...options,
+    format: "json",
+    extraArgs: options.extraArgs
+  });
+}
+
+function buildRunCliArgs(paths, options, passthroughArgs) {
+  return buildNativeLintArgs(paths, {
+    ...options,
+    extraArgs: passthroughArgs
+  });
+}
+
+function buildNativeLintArgs(paths, options) {
   const cliArgs = [];
 
   if (options.config) {
@@ -920,7 +1161,9 @@ function buildLintArgs(paths, options) {
     cliArgs.push(`--threads=${options.threads}`);
   }
 
-  cliArgs.push("--format=json");
+  if (options.format) {
+    cliArgs.push(`--format=${options.format}`);
+  }
 
   if (options.extraArgs) {
     cliArgs.push(...normalizeStringArray(options.extraArgs, "extraArgs"));
@@ -1127,6 +1370,37 @@ function configDataFromFileConfig(options, filePath) {
   return configDataFromConfig(config, filePath, options.cwd);
 }
 
+function lintTargetsForInput(paths, options = {}) {
+  if (paths == null) {
+    return defaultLintTargets(options);
+  }
+  return normalizeStringArray(Array.isArray(paths) ? paths : [paths], "paths");
+}
+
+function defaultLintTargets(options = {}) {
+  if (options.noConfig) {
+    return ["."];
+  }
+
+  const configPath = configPathForOptions(options);
+  if (!configPath) {
+    return ["."];
+  }
+
+  const targets = filePatternsFromConfig(readConfig(configPath, options.cwd));
+  return targets.length > 0 ? targets : ["."];
+}
+
+function filePatternsFromConfig(config) {
+  if (!config) {
+    return [];
+  }
+  if (Array.isArray(config)) {
+    return config.flatMap((entry) => filePatternsFromConfig(entry));
+  }
+  return normalizeConfigPatterns(config.files);
+}
+
 function configAppliesToFile(config, filePath, cwd) {
   if (!filePath) {
     return true;
@@ -1151,6 +1425,9 @@ function normalizeConfigPatterns(patterns) {
     if (typeof value === "string") {
       return [value];
     }
+    if (Array.isArray(value)) {
+      return normalizeConfigPatterns(value);
+    }
     return [];
   });
 }
@@ -3662,6 +3939,9 @@ function matchesIgnorePattern(target, pattern) {
 }
 
 function matchesConfigFilePattern(target, pattern) {
+  if (!hasGlobSyntax(pattern)) {
+    return target === pattern || target.startsWith(`${pattern}/`) || target.endsWith(`/${pattern}`);
+  }
   const expression = new RegExp(`^${globPatternRegExpSource(pattern)}$`);
   return expression.test(target);
 }
@@ -4028,6 +4308,7 @@ module.exports = {
   platformPackageName,
   resolveBinary,
   run,
+  runCli,
   runFishlint,
   translateFishlintArgs,
   version

package/index.d.ts

@@ -82,6 +82,7 @@ export interface LintOptions {
   env?: Record<string, string | undefined>;
   threads?: number;
   rules?: string[] | string;
+  format?: "text" | "json" | string;
   config?: string;
   configFile?: string;
   noConfig?: boolean;
@@ -309,6 +310,7 @@ export function loadESLint(options?: { useFlatConfig?: boolean; cwd?: string }):
 export function lintFiles(patterns?: string | string[], options?: LintOptions): LintReport;
 export function lintText(code: string, options?: TextLintOptions): LintReport;
 export function run(args?: string[], options?: LintOptions): unknown;
+export function runCli(args?: string[], options?: LintOptions): unknown;
 export function runFishlint(args?: string[], options?: LintOptions): unknown;
 export function translateFishlintArgs(args?: string[], options?: { command?: string; warn?: (message: string) => void }): string[];
 export function resolveBinary(options?: { env?: Record<string, string | undefined>; platform?: string; arch?: string }): string;

package/index.js

@@ -86,9 +86,13 @@ process.stdout.write(json);
 const BUILTIN_RULE_IDS = [
   "accessor-pairs",
   "array-callback-return",
+  "arrow-body-style",
   "block-scoped-var",
+  "camelcase",
   "capitalized-comments",
+  "complexity",
   "consistent-return",
+  "consistent-this",
   "constructor-super",
   "curly",
   "default-case",
@@ -100,11 +104,23 @@ const BUILTIN_RULE_IDS = [
   "for-direction",
   "func-name-matching",
   "func-names",
+  "func-style",
   "getter-return",
   "grouped-accessor-pairs",
   "guard-for-in",
+  "id-denylist",
+  "id-length",
+  "id-match",
+  "init-declarations",
   "linebreak-style",
   "logical-assignment-operators",
+  "max-classes-per-file",
+  "max-depth",
+  "max-lines",
+  "max-lines-per-function",
+  "max-nested-callbacks",
+  "max-params",
+  "max-statements",
   "new-cap",
   "new-parens",
   "no-alert",
@@ -122,6 +138,7 @@ const BUILTIN_RULE_IDS = [
   "no-cond-assign",
   "no-console",
   "no-const-assign",
+  "no-constant-binary-expression",
   "no-constant-condition",
   "no-constructor-return",
   "no-continue",
@@ -158,6 +175,7 @@ const BUILTIN_RULE_IDS = [
   "no-global-is-finite",
   "no-global-is-nan",
   "no-implicit-coercion",
+  "no-implicit-globals",
   "no-implied-eval",
   "no-import-assign",
   "no-inline-comments",
@@ -199,6 +217,13 @@ const BUILTIN_RULE_IDS = [
   "no-promise-executor-return",
   "no-proto",
   "no-prototype-builtins",
+  "no-redeclare",
+  "no-restricted-exports",
+  "no-restricted-globals",
+  "no-restricted-imports",
+  "no-restricted-modules",
+  "no-restricted-properties",
+  "no-restricted-syntax",
   "no-regex-spaces",
   "no-return-assign",
   "no-return-await",
@@ -207,6 +232,7 @@ const BUILTIN_RULE_IDS = [
   "no-self-compare",
   "no-sequences",
   "no-setter-return",
+  "no-shadow",
   "no-shadow-restricted-names",
   "no-sparse-arrays",
   "no-tabs",
@@ -217,15 +243,21 @@ const BUILTIN_RULE_IDS = [
   "no-trailing-spaces",
   "no-undef",
   "no-undef-init",
+  "no-unassigned-vars",
   "no-underscore-dangle",
   "no-undefined",
   "no-unneeded-ternary",
   "no-unreachable",
+  "no-unreachable-loop",
   "no-unsafe-finally",
   "no-unsafe-negation",
+  "no-unsafe-optional-chaining",
   "no-unused-expressions",
   "no-unused-labels",
+  "no-unused-private-class-members",
   "no-unused-vars",
+  "no-use-before-define",
+  "no-useless-backreference",
   "no-useless-call",
   "no-useless-catch",
   "no-useless-computed-key",
@@ -241,13 +273,16 @@ const BUILTIN_RULE_IDS = [
   "object-shorthand",
   "one-var",
   "operator-assignment",
+  "prefer-arrow-callback",
   "prefer-const",
   "prefer-destructuring",
   "prefer-exponentiation-operator",
+  "prefer-named-capture-group",
   "prefer-numeric-literals",
   "prefer-object-has-own",
   "prefer-object-spread",
   "prefer-promise-reject-errors",
+  "preserve-caught-error",
   "prefer-regex-literals",
   "prefer-rest-params",
   "prefer-spread",
@@ -255,8 +290,13 @@ const BUILTIN_RULE_IDS = [
   "radix",
   "require-await",
   "require-atomic-updates",
+  "require-unicode-regexp",
   "require-yield",
+  "sort-imports",
+  "sort-keys",
+  "sort-vars",
   "spaced-comment",
+  "strict",
   "symbol-description",
   "unicode-bom",
   "use-isnan",
@@ -264,6 +304,7 @@ const BUILTIN_RULE_IDS = [
   "vars-on-top",
   "wrap-iife",
   "yoda",
+  "eslint-comments/no-restricted-disable",
   "import/default",
   "import/export",
   "import/first",
@@ -277,22 +318,59 @@ const BUILTIN_RULE_IDS = [
   "import/no-named-as-default-member",
   "import/no-unresolved",
   "import/no-self-import",
+  "jsx-a11y/alt-text",
+  "jsx-a11y/anchor-has-content",
   "jsx-a11y/aria-props",
+  "jsx-a11y/aria-proptypes",
+  "jsx-a11y/aria-role",
+  "jsx-a11y/aria-unsupported-elements",
   "jsx-a11y/iframe-has-title",
   "jsx-a11y/img-redundant-alt",
   "jsx-a11y/no-access-key",
+  "jsx-a11y/no-distracting-elements",
+  "jsx-a11y/role-has-required-aria-props",
+  "jsx-a11y/role-supports-aria-props",
+  "jsx-a11y/scope",
+  "react/button-has-type",
+  "react/default-props-match-prop-types",
+  "react/display-name",
+  "react/forbid-prop-types",
   "react/jsx-boolean-value",
+  "react/jsx-filename-extension",
+  "react/jsx-key",
+  "react/jsx-no-bind",
   "react/jsx-no-comment-textnodes",
   "react/jsx-no-duplicate-props",
+  "react/jsx-no-undef",
+  "react/jsx-uses-react",
+  "react/jsx-uses-vars",
   "react/jsx-no-target-blank",
   "react/jsx-pascal-case",
+  "react/no-access-state-in-setstate",
+  "react/no-array-index-key",
+  "react/no-children-prop",
   "react/no-danger",
+  "react/no-danger-with-children",
+  "react/no-deprecated",
   "react/no-find-dom-node",
   "react/no-is-mounted",
+  "react/no-multi-comp",
+  "react/no-redundant-should-component-update",
   "react/no-render-return-value",
+  "react/no-string-refs",
+  "react/no-this-in-sfc",
+  "react/no-typos",
   "react/no-unescaped-entities",
+  "react/no-unknown-property",
   "react/no-unused-prop-types",
+  "react/no-unused-state",
+  "react/no-will-update-set-state",
+  "react/prefer-es6-class",
   "react/prop-types",
+  "react/require-render-return",
+  "react/self-closing-comp",
+  "react/style-prop-object",
+  "react/void-dom-elements-no-children",
   "react-hooks/rules-of-hooks",
   "@typescript-eslint/adjacent-overload-signatures",
   "@typescript-eslint/array-type",
@@ -316,6 +394,7 @@ const BUILTIN_RULE_IDS = [
   "@typescript-eslint/no-extra-non-null-assertion",
   "@typescript-eslint/no-inferrable-types",
   "@typescript-eslint/no-invalid-void-type",
+  "@typescript-eslint/no-loop-func",
   "@typescript-eslint/no-loss-of-precision",
   "@typescript-eslint/no-misused-new",
   "@typescript-eslint/no-namespace",
@@ -389,7 +468,7 @@ export class UtooLint {
     this.options = { ...options };
   }
 
-  async lintFiles(patterns = ["."], options = {}) {
+  async lintFiles(patterns, options = {}) {
     const mergedOptions = mergeLintOptions(this.options, options);
     const customRuleConfig = [mergedOptions.baseConfig, mergedOptions.overrideConfig].filter(Boolean);
     const customRuleFilterMap = customRuleMapForConfig(customRuleConfig, new Map());
@@ -2424,6 +2503,152 @@ export function run(args = [], options = {}) {
   });
 }
 
+const UTOO_LINT_CLI_VALUE_FLAGS = new Set(["--config", "-c", "--format", "-f", "--rules", "--threads"]);
+
+function parseUtooLintCliArgs(args = []) {
+  const values = normalizeStringArray(args, "args");
+  const passthroughArgs = [];
+  const targets = [];
+  const options = {};
+  let help = false;
+  let versionFlag = false;
+
+  for (let index = 0; index < values.length; index += 1) {
+    const arg = values[index];
+    if (arg === "--") {
+      targets.push(...values.slice(index + 1));
+      break;
+    }
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+      passthroughArgs.push(arg);
+      continue;
+    }
+    if (arg === "--version" || arg === "-v") {
+      versionFlag = true;
+      continue;
+    }
+    if (UTOO_LINT_CLI_VALUE_FLAGS.has(arg)) {
+      const value = values[index + 1];
+      if (!value) {
+        throw new Error(`utoo-lint: ${arg} requires a value`);
+      }
+      appendCliOption(passthroughArgs, options, arg, value);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--config=")) {
+      appendCliOption(passthroughArgs, options, "--config", arg.slice("--config=".length));
+      continue;
+    }
+    if (arg.startsWith("--format=")) {
+      appendCliOption(passthroughArgs, options, "--format", arg.slice("--format=".length));
+      continue;
+    }
+    if (arg.startsWith("--rules=")) {
+      appendCliOption(passthroughArgs, options, "--rules", arg.slice("--rules=".length));
+      continue;
+    }
+    if (arg.startsWith("--threads=")) {
+      appendCliOption(passthroughArgs, options, "--threads", arg.slice("--threads=".length));
+      continue;
+    }
+    if (arg === "--no-config") {
+      options.noConfig = true;
+      delete options.config;
+      continue;
+    }
+    if (arg === "--json") {
+      passthroughArgs.push(arg);
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      passthroughArgs.push(arg);
+      continue;
+    }
+    targets.push(arg);
+  }
+
+  return { help, options, passthroughArgs, targets, version: versionFlag };
+}
+
+function appendCliOption(passthroughArgs, options, flag, value) {
+  if (value == null || value === "") {
+    throw new Error(`utoo-lint: ${flag} requires a value`);
+  }
+  switch (flag) {
+    case "--config":
+    case "-c":
+      options.config = value;
+      delete options.noConfig;
+      return;
+    case "--format":
+    case "-f":
+      options.format = value;
+      return;
+    case "--rules":
+      options.rules = value;
+      return;
+    case "--threads":
+      options.threads = value;
+      return;
+    default:
+      passthroughArgs.push(`${flag}=${value}`);
+  }
+}
+
+function completedRunResult(status, stdout, stderr, options = {}) {
+  const inherited = options.stdio === "inherit";
+  if (inherited) {
+    if (stdout) {
+      process.stdout.write(stdout);
+    }
+    if (stderr) {
+      process.stderr.write(stderr);
+    }
+  }
+  return {
+    status,
+    signal: null,
+    error: undefined,
+    stdout: inherited ? null : stdout,
+    stderr: inherited ? null : stderr,
+    output: [null, inherited ? null : stdout, inherited ? null : stderr],
+    pid: 0
+  };
+}
+
+export function runCli(args = [], options = {}) {
+  const parsed = parseUtooLintCliArgs(args);
+  if (parsed.version) {
+    return completedRunResult(0, `v${version}\n`, "", options);
+  }
+  if (parsed.help) {
+    return run(parsed.passthroughArgs, options);
+  }
+
+  const cliOptions = {
+    ...options,
+    ...parsed.options
+  };
+  const targets = parsed.targets.length > 0 ? parsed.targets : defaultLintTargets(cliOptions);
+  const ignoredDiagnostics = ignoredLintPathDiagnostics(targets, cliOptions);
+  const lintPaths = filteredLintPaths(targets, cliOptions);
+  if (lintPaths.length === 0) {
+    return completedRunResult(ignoredDiagnostics.length > 0 ? 1 : 0, "", "", options);
+  }
+
+  return withTemporaryConfig(cliOptions, (resolvedOptions) => {
+    const cliArgs = buildRunCliArgs(lintPaths, resolvedOptions, parsed.passthroughArgs);
+    return run(cliArgs, {
+      ...resolvedOptions,
+      stdio: options.stdio,
+      encoding: options.encoding,
+      input: options.input
+    });
+  });
+}
+
 export function runFishlint(args = [], options = {}) {
   const cliArgs = normalizeStringArray(args, "args");
   const env = options.env ? { ...process.env, ...options.env } : { ...process.env };
@@ -2636,14 +2861,15 @@ function booleanFlagValue(arg) {
   return true;
 }
 
-export function lintFiles(paths = ["."], options = {}) {
-  return withTemporaryConfig(options, (resolvedOptions) => {
-    const ignoredDiagnostics = ignoredLintPathDiagnostics(paths, resolvedOptions);
-    const lintPaths = filteredLintPaths(paths, resolvedOptions);
-    if (lintPaths.length === 0) {
-      return { files: 0, filePaths: [], diagnostics: ignoredDiagnostics, exitCode: ignoredDiagnostics.length > 0 ? 1 : 0 };
-    }
+export function lintFiles(paths, options = {}) {
+  const targets = lintTargetsForInput(paths, options);
+  const ignoredDiagnostics = ignoredLintPathDiagnostics(targets, options);
+  const lintPaths = filteredLintPaths(targets, options);
+  if (lintPaths.length === 0) {
+    return { files: 0, filePaths: [], diagnostics: ignoredDiagnostics, exitCode: ignoredDiagnostics.length > 0 ? 1 : 0 };
+  }
 
+  return withTemporaryConfig(options, (resolvedOptions) => {
     const cliArgs = buildLintArgs(lintPaths, resolvedOptions);
     const result = run(cliArgs, { ...resolvedOptions, stdio: undefined, encoding: "utf8" });
 
@@ -2735,6 +2961,21 @@ export function lintText(code, options = {}) {
 }
 
 function buildLintArgs(paths, options) {
+  return buildNativeLintArgs(paths, {
+    ...options,
+    format: "json",
+    extraArgs: options.extraArgs
+  });
+}
+
+function buildRunCliArgs(paths, options, passthroughArgs) {
+  return buildNativeLintArgs(paths, {
+    ...options,
+    extraArgs: passthroughArgs
+  });
+}
+
+function buildNativeLintArgs(paths, options) {
   const cliArgs = [];
 
   if (options.config) {
@@ -2753,7 +2994,9 @@ function buildLintArgs(paths, options) {
     cliArgs.push(`--threads=${options.threads}`);
   }
 
-  cliArgs.push("--format=json");
+  if (options.format) {
+    cliArgs.push(`--format=${options.format}`);
+  }
 
   if (options.extraArgs) {
     cliArgs.push(...normalizeStringArray(options.extraArgs, "extraArgs"));
@@ -2960,6 +3203,37 @@ function configDataFromFileConfig(options, filePath) {
   return configDataFromConfig(config, filePath, options.cwd);
 }
 
+function lintTargetsForInput(paths, options = {}) {
+  if (paths == null) {
+    return defaultLintTargets(options);
+  }
+  return normalizeStringArray(Array.isArray(paths) ? paths : [paths], "paths");
+}
+
+function defaultLintTargets(options = {}) {
+  if (options.noConfig) {
+    return ["."];
+  }
+
+  const configPath = configPathForOptions(options);
+  if (!configPath) {
+    return ["."];
+  }
+
+  const targets = filePatternsFromConfig(readConfig(configPath, options.cwd));
+  return targets.length > 0 ? targets : ["."];
+}
+
+function filePatternsFromConfig(config) {
+  if (!config) {
+    return [];
+  }
+  if (Array.isArray(config)) {
+    return config.flatMap((entry) => filePatternsFromConfig(entry));
+  }
+  return normalizeConfigPatterns(config.files);
+}
+
 function configAppliesToFile(config, filePath, cwd) {
   if (!filePath) {
     return true;
@@ -2984,6 +3258,9 @@ function normalizeConfigPatterns(patterns) {
     if (typeof value === "string") {
       return [value];
     }
+    if (Array.isArray(value)) {
+      return normalizeConfigPatterns(value);
+    }
     return [];
   });
 }
@@ -3665,6 +3942,9 @@ function matchesIgnorePattern(target, pattern) {
 }
 
 function matchesConfigFilePattern(target, pattern) {
+  if (!hasGlobSyntax(pattern)) {
+    return target === pattern || target.startsWith(`${pattern}/`) || target.endsWith(`/${pattern}`);
+  }
   const expression = new RegExp(`^${globPatternRegExpSource(pattern)}$`);
   return expression.test(target);
 }

package/lib/binary.cjs

@@ -1,4 +1,4 @@
-const { existsSync } = require("node:fs");
+const { chmodSync, existsSync, statSync } = require("node:fs");
 const { join } = require("node:path");
 
 const here = __dirname;
@@ -26,7 +26,7 @@ function resolveBinary(options = {}) {
 
   if (env.UTOO_LINT_BIN) {
     if (existsSync(env.UTOO_LINT_BIN)) {
-      return env.UTOO_LINT_BIN;
+      return ensureExecutable(env.UTOO_LINT_BIN, platform);
     }
     throw new Error(`utoo-lint: UTOO_LINT_BIN does not exist: ${env.UTOO_LINT_BIN}`);
   }
@@ -47,7 +47,7 @@ function resolveBinary(options = {}) {
     try {
       const resolved = candidate();
       if (existsSync(resolved)) {
-        return resolved;
+        return ensureExecutable(resolved, platform);
       }
     } catch {}
   }
@@ -58,6 +58,21 @@ function resolveBinary(options = {}) {
   );
 }
 
+function ensureExecutable(path, platform) {
+  if (platform === "win32") {
+    return path;
+  }
+  try {
+    const mode = statSync(path).mode;
+    if ((mode & 0o111) === 0) {
+      chmodSync(path, mode | 0o755);
+    }
+  } catch {
+    // Let spawn surface the actual filesystem error if chmod is not permitted.
+  }
+  return path;
+}
+
 module.exports = {
   platformPackageName,
   resolveBinary

package/lib/binary.js

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
@@ -29,7 +29,7 @@ export function resolveBinary(options = {}) {
 
   if (env.UTOO_LINT_BIN) {
     if (existsSync(env.UTOO_LINT_BIN)) {
-      return env.UTOO_LINT_BIN;
+      return ensureExecutable(env.UTOO_LINT_BIN, platform);
     }
     throw new Error(`utoo-lint: UTOO_LINT_BIN does not exist: ${env.UTOO_LINT_BIN}`);
   }
@@ -50,7 +50,7 @@ export function resolveBinary(options = {}) {
     try {
       const resolved = candidate();
       if (existsSync(resolved)) {
-        return resolved;
+        return ensureExecutable(resolved, platform);
       }
     } catch {}
   }
@@ -60,3 +60,18 @@ export function resolveBinary(options = {}) {
       "Run `./scripts/package-npm.sh` from the repository root, or install the matching optional dependency."
   );
 }
+
+function ensureExecutable(path, platform) {
+  if (platform === "win32") {
+    return path;
+  }
+  try {
+    const mode = statSync(path).mode;
+    if ((mode & 0o111) === 0) {
+      chmodSync(path, mode | 0o755);
+    }
+  } catch {
+    // Let spawn surface the actual filesystem error if chmod is not permitted.
+  }
+  return path;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utoo/lint",
-  "version": "0.0.9",
+  "version": "0.1.3",
   "description": "Experimental JavaScript and TypeScript linter powered by Yuku",
   "license": "MIT",
   "repository": {
@@ -70,14 +70,14 @@
     "use-at-your-own-risk.js"
   ],
   "optionalDependencies": {
-    "@utoo/lint-darwin-arm64": "0.0.9",
-    "@utoo/lint-darwin-x64": "0.0.9",
-    "@utoo/lint-linux-arm64": "0.0.9",
-    "@utoo/lint-linux-x64": "0.0.9",
-    "@utoo/lint-win32-x64": "0.0.9"
+    "@utoo/lint-darwin-arm64": "0.1.3",
+    "@utoo/lint-darwin-x64": "0.1.3",
+    "@utoo/lint-linux-arm64": "0.1.3",
+    "@utoo/lint-linux-x64": "0.1.3",
+    "@utoo/lint-win32-x64": "0.1.3"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}