eslint-plugin-etc-misc 1.1.2 → 1.1.4

package/dist/rules/no-vulnerable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-vulnerable.d.ts","sourceRoot":"","sources":["../../src/rules/no-vulnerable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAK/D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,KAAK,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC;AAEnD,KAAK,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;AAEhD,KAAK,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;AAEtC,KAAK,UAAU,GAAG,QAAQ,CACtB,iBAAiB,GAAG;IAChB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAChE,CACJ,CAAC;AAqFF;;GAEG;AACH,QAAA,MAAM,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAkK5D,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"no-vulnerable.d.ts","sourceRoot":"","sources":["../../src/rules/no-vulnerable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAS/D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,KAAK,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC;AAEnD,KAAK,UAAU,GAAG,cAAc,GAAG,YAAY,CAAC;AAEhD,KAAK,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;AAUtC,KAAK,UAAU,GAAG,QAAQ,CACtB,iBAAiB,GAAG;IAChB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAChE,CACJ,CAAC;AA4RF;;GAEG;AACH,QAAA,MAAM,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAyL5D,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/dist/rules/no-vulnerable.js

@@ -1,6 +1,123 @@
+import { statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { basename, dirname, join } from "node:path";
 import { checkSync } from "recheck";
 import { arrayFirst, isDefined, keyIn, setHas } from "ts-extras";
 import { ruleCreator } from "../_internal/rule-creator.js";
+const requireFromWorkingDirectory = createRequire(join(process.cwd(), "package.json"));
+const isUnknownRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isModuleNotFoundError = (error) => {
+    if (!isUnknownRecord(error)) {
+        return false;
+    }
+    return keyIn(error, "code") && error["code"] === "MODULE_NOT_FOUND";
+};
+const createRequireFromPluginPackage = () => {
+    try {
+        return createRequire(requireFromWorkingDirectory.resolve("eslint-plugin-etc-misc/package.json"));
+    }
+    catch (error) {
+        if (isModuleNotFoundError(error)) {
+            return requireFromWorkingDirectory;
+        }
+        throw error;
+    }
+};
+const requireFromPluginPackage = createRequireFromPluginPackage();
+const isExistingFile = (filePath) => {
+    try {
+        return statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const shouldOverrideRuntimePath = (currentPath) => !isDefined(currentPath) ||
+    !isExistingFile(currentPath) ||
+    basename(currentPath).toLowerCase() === "package.json";
+const resolvePackageSiblingFile = (packageJsonSpecifier, siblingFileName) => {
+    try {
+        const packageJsonPath = requireFromPluginPackage.resolve(packageJsonSpecifier);
+        return join(dirname(packageJsonPath), siblingFileName);
+    }
+    catch (error) {
+        if (isModuleNotFoundError(error)) {
+            return null;
+        }
+        throw error;
+    }
+};
+const resolveRecheckJarPath = () => resolvePackageSiblingFile("recheck-jar/package.json", "recheck.jar");
+const resolveRecheckWindowsBinaryPath = () => {
+    if (process.platform !== "win32" || process.arch !== "x64") {
+        return null;
+    }
+    return resolvePackageSiblingFile("recheck-windows-x64/package.json", "recheck.exe");
+};
+const recheckJarPath = process.platform === "win32" ? resolveRecheckJarPath() : null;
+const recheckWindowsBinaryPath = process.platform === "win32" ? resolveRecheckWindowsBinaryPath() : null;
+/* eslint-disable n/no-process-env -- recheck exposes backend runtime paths only through environment variables, so the rule temporarily normalizes them while invoking the analyzer. */
+const deleteRecheckEnvironmentValue = (key) => {
+    if (key === "RECHECK_BIN") {
+        delete process.env["RECHECK_BIN"];
+        return;
+    }
+    delete process.env["RECHECK_JAR"];
+};
+const getRecheckEnvironmentValue = (key) => key === "RECHECK_BIN"
+    ? process.env["RECHECK_BIN"]
+    : process.env["RECHECK_JAR"];
+const setRecheckEnvironmentValue = (key, value) => {
+    if (key === "RECHECK_BIN") {
+        process.env["RECHECK_BIN"] = value;
+        return;
+    }
+    process.env["RECHECK_JAR"] = value;
+};
+const getRecheckEnvironmentOverrides = () => {
+    if (process.platform !== "win32") {
+        return {};
+    }
+    const overrides = {};
+    if (recheckJarPath !== null &&
+        isExistingFile(recheckJarPath) &&
+        shouldOverrideRuntimePath(getRecheckEnvironmentValue("RECHECK_JAR"))) {
+        overrides.RECHECK_JAR = recheckJarPath;
+    }
+    if (recheckWindowsBinaryPath !== null &&
+        isExistingFile(recheckWindowsBinaryPath) &&
+        shouldOverrideRuntimePath(getRecheckEnvironmentValue("RECHECK_BIN"))) {
+        overrides.RECHECK_BIN = recheckWindowsBinaryPath;
+    }
+    return overrides;
+};
+const restoreEnvironmentValue = (key, value) => {
+    if (!isDefined(value)) {
+        deleteRecheckEnvironmentValue(key);
+        return;
+    }
+    setRecheckEnvironmentValue(key, value);
+};
+const withRecheckEnvironmentOverrides = (callback) => {
+    const overrides = getRecheckEnvironmentOverrides();
+    const previousBin = getRecheckEnvironmentValue("RECHECK_BIN");
+    const previousJar = getRecheckEnvironmentValue("RECHECK_JAR");
+    if (isDefined(overrides.RECHECK_BIN)) {
+        setRecheckEnvironmentValue("RECHECK_BIN", overrides.RECHECK_BIN);
+    }
+    if (isDefined(overrides.RECHECK_JAR)) {
+        setRecheckEnvironmentValue("RECHECK_JAR", overrides.RECHECK_JAR);
+    }
+    try {
+        return callback();
+    }
+    finally {
+        restoreEnvironmentValue("RECHECK_BIN", previousBin);
+        restoreEnvironmentValue("RECHECK_JAR", previousJar);
+    }
+};
+const runRecheck = (source, flags, parameters) => withRecheckEnvironmentOverrides(() => checkSync(source, flags, parameters));
+/* eslint-enable n/no-process-env -- Re-enable after the recheck environment wrapper helpers. */
 const getStaticStringValue = (node) => {
     if (node.type === "Literal" && typeof node.value === "string") {
         return node.value;
@@ -52,6 +169,15 @@ const getDiagnosticsErrorMessage = (error) => {
     }
     return "No additional details provided.";
 };
+const getThrownErrorMessage = (error) => {
+    if (error instanceof Error && error.message.length > 0) {
+        return error.message;
+    }
+    if (typeof error === "string" && error.length > 0) {
+        return error;
+    }
+    return "No additional details provided.";
+};
 /**
  * Detect ReDoS-vulnerable regular expressions using `recheck`.
  */
@@ -61,7 +187,28 @@ const rule = ruleCreator({
         const { ignoreErrors = true, permittableComplexities = [], ...recheckParameters } = options;
         const allowedComplexities = new Set(permittableComplexities);
         const reportDiagnostics = (node, source, flags) => {
-            const diagnostics = checkSync(source, flags, recheckParameters);
+            const diagnostics = (() => {
+                try {
+                    return runRecheck(source, flags, recheckParameters);
+                }
+                catch (error) {
+                    if (ignoreErrors) {
+                        return null;
+                    }
+                    context.report({
+                        data: {
+                            kind: "unexpected",
+                            message: getThrownErrorMessage(error),
+                        },
+                        messageId: "checkerError",
+                        node,
+                    });
+                    return null;
+                }
+            })();
+            if (diagnostics === null) {
+                return;
+            }
             if (diagnostics.status === "safe") {
                 return;
             }

package/dist/rules/no-vulnerable.js.map

@@ -1 +1 @@
-{"version":3,"file":"no-vulnerable.js","sourceRoot":"","sources":["../../src/rules/no-vulnerable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"no-vulnerable.js","sourceRoot":"","sources":["../../src/rules/no-vulnerable.ts"],"names":[],"mappings":"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"}

package/docs/AGENTS.md

@@ -0,0 +1,186 @@
+---
+name: "Codex-Instructions-ESLint-Docs"
+description: "Instructions for writing perfect ESLint rule documentation."
+applyTo: "docs/**"
+---
+
+<instructions>
+  <goal>
+
+## Your Goal for ESLint Rule Documentation
+
+- Your goal is to make every ESLint rule documentation file (`docs/rules/<rule-id>.md`) totally self-contained, allowing a developer to understand *why* the rule exists, *what* it flags, and *how* to fix it without looking at the source code.
+- For adjacent docs in `docs/rules/` such as guides, preset pages, `overview.md`, or `getting-started.md`, keep the same tone and accuracy standards, but do not force rule-only sections where they do not fit.
+- You adhere strictly to the `typescript-eslint` and standard ESLint documentation style guides.
+
+  </goal>
+
+  <structure>
+
+## Documentation Structure
+
+Rule documentation files in `docs/rules/<rule-id>.md` should follow this structure closely:
+
+1.  **Title:** The bare rule ID as the H1 header (e.g., `# prefer-type-fest-arrayable`).
+2.  **Description:** A short, one-sentence description of what the rule does.
+3.  **Meta Badges (Optional):** Badges for `Recommended`, `Fixable`, or `Type Checked` only if the repository’s current docs pattern uses them.
+4.  **Rule Details:** An explanation of the problem the rule solves. Why is this pattern bad?
+5.  **Examples:**
+    - Use `❌ Incorrect` and `✅ Correct` headers.
+    - **Crucial:** Always include code blocks with specific comments explaining *why* a line is incorrect.
+    - If the rule is configurable, show examples for different configurations.
+6.  **Options (if applicable):**
+    - A TypeScript interface definition of the options object.
+    - Default values clearly marked.
+    - Examples for each option.
+7.  **When Not To Use It:** specific scenarios where disabling this rule is acceptable.
+8.  **Further Reading:** Links to MDN, TypeScript docs, or relevant specs.
+
+  </structure>
+
+  <style>
+
+## Style & Tone
+
+- **Voice:** Professional, objective, and helpful. Avoid slang.
+- **Clarity:** Use active voice. "This rule reports..." instead of "This rule is used to report...".
+- **Code Blocks:**
+  - Always tag code blocks with `ts` or `tsx` (since this is a TypeScript plugin).
+  - Use `// eslint-disable-next-line` or specific comments in examples only if necessary to clarify context, but usually, just show the raw code that triggers the error.
+- **Configuration:**
+  - Assume **Flat Config** (`eslint.config.mjs`) for all configuration examples.
+  - Do not use legacy `.eslintrc` JSON snippets.
+
+  </style>
+
+  <guidelines>
+
+## Writing Guidelines
+
+- **The "Why":** Never just say "Don't do X." Explain the consequence.
+  - *Bad:* "Don't use `any`."
+  - *Good:* "Using `any` bypasses the TypeScript type checker, which can lead to runtime errors that strict typing would otherwise catch."
+- **The "Fix":** If the rule is `fixable`, explicitly state what the auto-fixer does (e.g., "The auto-fixer will replace `var` with `let`.").
+- **Type Information:** If the rule requires type information (`parserServices`), add a specific note at the top of the docs:
+  > ⚠️ This rule requires type information to run. It will not work without `projectService` (or equivalent typed parser setup) configured.
+- **Preset awareness:** Repository presets such as `etc-misc.configs["recommended-type-checked"]`, `etc-misc.configs.strict`, and `etc-misc.configs.all` already wire the typed parser setup for you; do not imply that users must always configure it manually.
+- **Consistency:** Ensure the examples actually trigger the rule. Do not use hypothetical examples that strictly wouldn't fail the specific AST selector of the rule.
+
+  </guidelines>
+
+  <examples>
+
+## Example Doc
+
+```markdown
+# prefer-ts-extras-array-find-last-index
+
+Prefer [`arrayFindLastIndex`](https://github.com/sindresorhus/ts-extras/blob/main/source/array-find-last-index.ts) from `ts-extras` over `array.findLastIndex(...)`.
+
+`arrayFindLastIndex(...)` improves predicate inference in typed arrays.
+
+## Targeted pattern scope
+
+This rule focuses on direct `array.findLastIndex(predicate)` calls that can be migrated to `arrayFindLastIndex(array, predicate)` with deterministic fixes.
+
+- `array.findLastIndex(predicate)` call sites that can use `arrayFindLastIndex(array, predicate)`.
+
+Alias indirection, wrapper helpers, and non-canonical call shapes are excluded to keep `arrayFindLastIndex(array, predicate)` migrations safe.
+
+## What this rule reports
+
+This rule reports `array.findLastIndex(predicate)` call sites when `arrayFindLastIndex(array, predicate)` is the intended replacement.
+
+- `array.findLastIndex(predicate)` call sites that can use `arrayFindLastIndex(array, predicate)`.
+
+## Why this rule exists
+
+`arrayFindLastIndex` standardizes reverse index lookup and keeps call signatures aligned with other `ts-extras` search helpers.
+
+- Reverse index scans are explicit at the call site.
+- Search code avoids mixed native/helper patterns.
+- Index-based follow-up logic stays uniform across modules.
+
+## ❌ Incorrect
+
+```ts
+const index = monitors.findLastIndex((entry) => entry.id === targetId);
+```
+
+## ✅ Correct
+
+```ts
+const index = arrayFindLastIndex(monitors, (entry) => entry.id === targetId);
+```
+
+## Behavior and migration notes
+
+- Runtime behavior matches native `Array.prototype.findLastIndex`.
+- Search still proceeds from right to left.
+- If no element matches, the result is `-1`.
+
+## Additional examples
+
+### ❌ Incorrect — Additional example
+
+```ts
+const index = logs.findLastIndex((entry) => entry.level === "warn");
+```
+
+### ✅ Correct — Additional example
+
+```ts
+const index = arrayFindLastIndex(logs, (entry) => entry.level === "warn");
+```
+
+### ✅ Correct — Repository-wide usage
+
+```ts
+const retryIndex = arrayFindLastIndex(attempts, (attempt) => !attempt.success);
+```
+
+## ESLint flat config example
+
+```ts
+import etc-misc from "eslint-plugin-etc-misc";
+
+export default [
+    {
+        plugins: { etc-misc },
+        rules: {
+            "etc-misc/prefer-ts-extras-array-find-last-index": "error",
+        },
+    },
+];
+```
+
+## When not to use it
+
+Disable this rule if your codebase has standardized on native `.findLastIndex()`.
+
+## Package documentation
+
+ts-extras package documentation:
+
+`ts-extras@0.17.x` does not currently expose `arrayFindLastIndex` in its published API, so there is no canonical `source/*.ts` link for this helper yet.
+
+Reference links:
+
+- [`ts-extras` API list (README)](https://github.com/sindresorhus/ts-extras/blob/main/readme.md#api)
+- [`ts-extras` source directory](https://github.com/sindresorhus/ts-extras/tree/main/source)
+
+> **Rule catalog ID:** R005
+
+## Further reading
+
+- [`ts-extras` README](https://github.com/sindresorhus/ts-extras)
+- [`ts-extras` package reference](https://www.npmjs.com/package/ts-extras)
+- [TypeScript Handbook: Narrowing](https://www.typescriptlang.org/docs/handbook/2/narrowing.html)
+
+## Adoption resources
+
+- [Rule adoption checklist](https://nick2bad4u.github.io/eslint-plugin-etc-misc/docs/rules/guides/adoption-checklist)
+- [Rollout and fix safety](https://nick2bad4u.github.io/eslint-plugin-etc-misc/docs/rules/guides/rollout-and-fix-safety)
+
+  </examples>
+</instructions>

package/docs/docusaurus/AGENTS.md

@@ -0,0 +1,27 @@
+---
+name: "Docusaurus-Typedoc-Folder-Guidelines"
+description: "Guidance for the Docusaurus + TypeDoc documentation app under docs/docusaurus/."
+applyTo: "docs/docusaurus/**"
+---
+
+# Docusaurus + TypeDoc (docs/docusaurus/) Guidelines
+
+- Treat `docs/docusaurus/` as a self-contained Docusaurus website project that serves as the documentation hub for the repository.
+  - Docusaurus configuration, theme, and pages live here.
+  - TypeDoc integration is configured via `docs/docusaurus/typedoc.config.json` and related TS configs (for example `tsconfig.typedoc.json`).
+  - TypeDoc generates to `docs/docusaurus/site-docs/developer/api`, while hand-authored documents and pages live in tracked locations such as `docs/docusaurus/src/pages`, `docs/docusaurus/site-docs/developer`, and `docs/rules`. Docusaurus connects the root docs to the site via configuration.
+- Website and build setup:
+  - From the repository root, prefer the `docs:*` npm scripts (for example `npm run docs:start`, `npm run docs:build`, `npm run docs:api`) or the workspace scripts via `npm run --workspace docs/docusaurus <script>`.
+  - There are no root-level `docusaurus:*` scripts in this repo; use the `docs:*` root scripts unless you are intentionally running inside the docs workspace.
+  - Do not hand-edit generated TypeDoc output under `docs/docusaurus`; adjust source code or TypeDoc config instead.
+  - `docs/docusaurus/site-docs/developer/api/**` is generated by TypeDoc, cleaned on rebuild, and gitignored. Never place manual Markdown there.
+  - When you need a hand-authored explainer for generated API content, create it in a tracked docs location such as `docs/docusaurus/site-docs/developer/**`, then link to the generated API page with a normal Markdown link.
+  - If a Docusaurus build fails because a `developer/api/...` sidebar id no longer exists, regenerate the API docs with `npm run docs:api`, inspect the current generated ids, and update `docs/docusaurus/sidebars.ts`. Do not create placeholder docs under the generated API folder to satisfy stale sidebar entries.
+- ESLint Config Inspector integration:
+  - The ESLint configuration inspector is built from the repository root via `npm run build:eslint-inspector`, which writes to `docs/docusaurus/static/eslint-inspector` with base path `/eslint-plugin-sdl-2/eslint-inspector/`.
+  - For local inspection, use `npm run build:eslint-inspector:local`.
+  - Do not modify the generated files in `static/eslint-inspector` by hand
+- Configuration alignment:
+  - Keep Docusaurus `docusaurus.config.ts` and TypeScript configs (`tsconfig.typedoc.json`, etc.) in sync with root TS/Vite settings and path aliases.
+- Content:
+  - Keep examples and snippets up to date with current code.

package/docs/docusaurus/sidebars.rules.ts

@@ -174,7 +174,7 @@ const createRuleItems = (ruleDocIds: readonly string[]): SidebarDocItem[] =>
                 return ruleDocId;
             }
 
-            return `${entry.catalogId} · ${entry.ruleName}`;
+            return entry.ruleName;
         })(),
         type: "doc",
     }));

package/docs/rules/no-expression-empty-lines.md

@@ -23,7 +23,9 @@ formatting noise.
 ## ❌ Incorrect
 
 ```ts
-someCall(1);
+someCall(
+
+    1);
 ```
 
 ## ✅ Correct

package/docs/rules/no-function-declare-after-return.md

@@ -2,6 +2,12 @@
 
 Disallow function declarations that appear after a `return` statement in the same block scope.
 
+## Why this rule is included here
+
+This rule was integrated into `eslint-plugin-etc-misc` to avoid requiring a separate single-rule plugin dependency.
+
+Original plugin source: [`eslint-plugin-no-function-declare-after-return`](https://github.com/bhumijgupta/eslint-plugin-no-function-declare-after-return).
+
 ## Rule details
 
 JavaScript hoists `function` declarations to the top of their enclosing scope,

package/docs/rules/no-use-extend-native.md

@@ -2,6 +2,12 @@
 
 Disallow usage of non-native members on built-in JavaScript objects.
 
+## Why this rule is included here
+
+This rule was integrated into `eslint-plugin-etc-misc` to avoid requiring a separate single-rule plugin dependency.
+
+Original plugin source: [`eslint-plugin-no-use-extend-native`](https://github.com/dustinspecker/eslint-plugin-no-use-extend-native).
+
 ## Rule details
 
 This rule helps prevent implicit reliance on monkey-patched native prototypes (for example from legacy libraries that add methods like `String.prototype.green`).

package/docs/rules/no-vulnerable.md

@@ -2,6 +2,12 @@
 
 Disallow regular expressions that are potentially vulnerable to ReDoS (Regular Expression Denial of Service).
 
+## Why this rule is included here
+
+This rule was integrated into `eslint-plugin-etc-misc` to avoid requiring a separate single-rule plugin dependency.
+
+Original plugin source: [`eslint-plugin-redos-detector`](https://github.com/tjenkinson/eslint-plugin-redos-detector).
+
 ## Rule details
 
 This rule analyzes regular expression literals and statically-resolvable `RegExp(...)` constructor calls using [`recheck`](https://www.npmjs.com/package/recheck).
@@ -70,6 +76,12 @@ type Options = [
 When `true` (default), analysis failures from `recheck` are ignored.
 When `false`, analysis failures are reported.
 
+Analyzer failures include invalid regular expression syntax and backend startup
+errors from the `recheck` runtime. On Windows, this rule normalizes the
+temporary `RECHECK_JAR` and `RECHECK_BIN` values while invoking `recheck` so an
+upstream path-separator bug cannot make Java execute `package.json` instead of
+`recheck.jar`.
+
 ### `permittableComplexities`
 
 Allows selected vulnerable complexity classes to pass.

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://www.schemastore.org/package.json",
     "name": "eslint-plugin-etc-misc",
-    "version": "1.1.2",
+    "version": "1.1.4",
     "private": false,
     "description": "ESLint Plugin combining eslint-plugin-etc and eslint-plugin-misc!",
     "keywords": [