@utoo/lint 0.2.9 → 0.3.4

package/README.md

@@ -79,22 +79,35 @@ Without a config file, `utoo-lint` uses its built-in default rules. It supports
 Create `utlint.config.ts`:
 
 ```ts
-import { defineConfig, globalIgnores } from "@utoo/lint/config";
+import { defineConfig } from "@utoo/lint/config";
 import frontend from "@utoo/lint/configs/frontend";
 
-export default defineConfig(
-  globalIgnores(["dist/", "coverage/"]),
-  {
-    ...frontend,
-    files: ["src/**/*.{js,jsx,ts,tsx}"],
-    rules: {
-      ...frontend.rules,
-      "no-console": "warn"
-    }
+export default defineConfig({
+  ...frontend,
+  ignores: [...frontend.ignores, ".next", "storybook-static"],
+  rules: {
+    ...frontend.rules,
+    "no-console": "off",
+    "react/no-forward-ref": "off"
   }
-);
+});
 ```
 
+The frontend preset uses `error` for correctness and safety checks that should
+fail CI, and `warn` for migration or maintainability checks that should remain
+visible without blocking adoption:
+
+| Severity | Added frontend guardrails |
+| --- | --- |
+| `error` | `react-hooks/rules-of-hooks`, `react/jsx-key`, `react/no-children-prop`, `react/no-danger-with-children`, `react/void-dom-elements-no-children`, `no-script-url`, `promise/no-nesting` |
+| `warn` | `react-hooks/exhaustive-deps`, `react/no-array-index-key`, `react/no-unstable-nested-components`, `react/no-forward-ref`, `unused-imports/no-unused-imports`, `@typescript-eslint/no-unused-vars`, `@typescript-eslint/ban-types` |
+
+Override project-specific rules after spreading `frontend.rules`, and append
+framework-generated directories to `frontend.ignores`, as shown above.
+
+The preset intentionally enables no formatter or type-checker integration.
+Keep Prettier (or another formatter) and `tsc` as independent project steps.
+
 The CLI discovers the config and uses its `files` patterns:
 
 ```bash
@@ -235,6 +248,22 @@ Raw reports include active diagnostics, suppressed diagnostics, fixed outputs,
 and an exit code. The compatibility layer also exports `Linter`, `CLIEngine`,
 `RuleTester`, and `SourceCode` APIs.
 
+The Node wrapper captures up to 64 MiB from each native stdout and stderr
+stream by default. Programmatic `run`, `runCli`, and `runFishlint` calls can set
+`maxBuffer` to another positive byte count. Set `UTOO_LINT_MAX_BUFFER` to apply
+the same limit to CLI invocations; output beyond the configured bound reports
+`ENOBUFS` instead of being truncated.
+
+## WebAssembly
+
+For browser playgrounds and in-memory Node ESM usage, install the independent
+`@utoo/lint-wasm` package. It ships a freestanding WebAssembly module rather
+than selecting one of the native platform packages used by `@utoo/lint`.
+
+See the
+[WebAssembly guide](https://github.com/utooland/utoo-lint/blob/main/docs/wasm.md)
+for its API, runtime boundaries, and Web Worker recommendation.
+
 ## Supported platforms
 
 The package installs a platform-specific optional dependency containing the
@@ -254,6 +283,7 @@ development.
 - [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)
+- [WebAssembly](https://github.com/utooland/utoo-lint/blob/main/docs/wasm.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)

package/bin/fishlint.js

@@ -61,6 +61,8 @@ const STYLELINT_VALUE_FLAGS = new Set([
   "-f",
   "-o"
 ]);
+const DEFAULT_NATIVE_MAX_BUFFER = 64 * 1024 * 1024;
+const nativeOutputMaxBuffer = readNativeMaxBuffer();
 
 if (isVersionRequest(values)) {
   printVersion();
@@ -182,7 +184,10 @@ const needsReportOutput =
   ignoredFiltered.diagnostics.length > 0 ||
   usesJsonWithMetadataFormat(nativeValues) ||
   ruleResolution.configuredRules.size > 0;
-const result = spawnSync(binary, needsReportOutput ? withJsonFormat(ruleConfig.args) : ruleConfig.args, { encoding: "utf8" });
+const result = spawnSync(binary, needsReportOutput ? withJsonFormat(ruleConfig.args) : ruleConfig.args, {
+  encoding: "utf8",
+  maxBuffer: nativeOutputMaxBuffer
+});
 
 if (result.error) {
   console.error(`utoo-lint: failed to run native binary: ${result.error.message}`);
@@ -1102,7 +1107,7 @@ function runFlatConfigGroups(binary, translatedArgs, selectedConfig, ruleOverrid
       ...withoutConfigAndTargets(translatedArgs),
       `--config=${runtimeConfig.file}`,
       ...group.files
-    ]), { encoding: "utf8" });
+    ]), { encoding: "utf8", maxBuffer: nativeOutputMaxBuffer });
     cleanupRuleConfig(runtimeConfig);
     if (result.error) {
       return { error: result.error };
@@ -1500,13 +1505,28 @@ function parseJsonReport(stdout) {
 }
 
 function jsonDiagnosticCounts(binary, args) {
-  const result = spawnSync(binary, withJsonFormat(args), { encoding: "utf8" });
+  const result = spawnSync(binary, withJsonFormat(args), {
+    encoding: "utf8",
+    maxBuffer: nativeOutputMaxBuffer
+  });
   if (result.error) {
     return null;
   }
   return diagnosticCounts(result.stdout ?? "");
 }
 
+function readNativeMaxBuffer() {
+  const configured = process.env.UTOO_LINT_MAX_BUFFER;
+  if (configured === undefined || configured === "") {
+    return DEFAULT_NATIVE_MAX_BUFFER;
+  }
+  const value = Number(configured);
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new TypeError("UTOO_LINT_MAX_BUFFER must be a positive integer byte count");
+  }
+  return value;
+}
+
 function withJsonFormat(args) {
   const values = [];
   let foundFormat = false;