eslint-plugin-no-mistakes 0.54.1 → 0.55.0

package/README.md

@@ -1,7 +1,9 @@
 # eslint-plugin-no-mistakes
 
 ESLint and Oxlint rules that keep TS/JS, React, Next.js, and Playwright code
-static enough for `no-mistakes` analyzers and AI agents.
+static enough for `no-mistakes` analyzers. They exist so agents cannot hide
+callers, fetches, or selectors behind aliases and dynamic values. See
+[why no-mistakes exists](../../docs/why.md).
 
 ```sh
 npm install --save-dev eslint-plugin-no-mistakes

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "eslint-plugin-no-mistakes",
-  "version": "0.54.1",
-  "description": "ESLint and Oxlint rules for deterministic no-mistakes code analysis",
+  "version": "0.55.0",
+  "description": "ESLint and Oxlint rules that keep code static enough for no-mistakes analyzers and coding agents",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/index.js

@@ -39,6 +39,7 @@ const rules = {
   "server-require-nullable-fetch-wrapper": require("./rules/server-require-nullable-fetch-wrapper"),
   "test-no-error-message-matching": require("./rules/test-no-error-message-matching"),
   "test-no-shared-state": require("./rules/test-no-shared-state"),
+  "ts-no-const-aliases": require("./rules/ts-no-const-aliases"),
   "ts-no-export-renaming": require("./rules/ts-no-export-renaming"),
   "ts-no-function-aliases": require("./rules/ts-no-function-aliases"),
   "ts-preserve-null-option-defaults": require("./rules/ts-preserve-null-option-defaults"),
@@ -68,6 +69,7 @@ plugin.configs.recommended = {
     "no-mistakes/playwright-no-empty": "error",
     "no-mistakes/playwright-unique": "error",
     "no-mistakes/react-no-nullish-react-node": "error",
+    "no-mistakes/ts-no-const-aliases": "error",
     "no-mistakes/ts-no-export-renaming": "error",
     "no-mistakes/ts-no-function-aliases": "error",
   },

package/src/rules/ts-no-const-aliases.js

@@ -0,0 +1,47 @@
+"use strict";
+
+const { rule } = require("../helpers");
+
+const TRANSPARENT_EXPRESSION_TYPES = new Set([
+  "ChainExpression",
+  "TSAsExpression",
+  "TSInstantiationExpression",
+  "TSNonNullExpression",
+  "TSSatisfiesExpression",
+  "TSTypeAssertion",
+]);
+
+function unwrapExpression(expression) {
+  let current = expression;
+  while (TRANSPARENT_EXPRESSION_TYPES.has(current.type)) {
+    current = current.expression;
+  }
+  return current;
+}
+
+module.exports = rule(
+  {
+    type: "problem",
+    docs: {
+      description: "disallow const aliases for differently named values",
+      recommended: true,
+    },
+    schema: [],
+    messages: {
+      alias:
+        "Do not create a differently named const alias. Use the original name directly so readers and tooling can trace symbols without indirection.",
+    },
+  },
+  (context) => ({
+    VariableDeclaration(node) {
+      if (node.kind !== "const") return;
+      for (const declarator of node.declarations) {
+        if (declarator.id.type !== "Identifier" || !declarator.init) continue;
+        const initializer = unwrapExpression(declarator.init);
+        if (initializer.type === "Identifier" && declarator.id.name !== initializer.name) {
+          context.report({ node: declarator, messageId: "alias" });
+        }
+      }
+    },
+  }),
+);