@sarj/eslint-plugin 9.13.0 → 9.13.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sarj-ai
+
+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

@@ -46,7 +46,7 @@ changes only the call; import cleanup remains explicit. Other UUID versions,
 custom-randomness arguments, re-exports, and function references are untouched.
 
 Neither rule is in the general presets. The application profile configures them
-for its Node 22+ runtime contract and supplies catalog entries to the loader
+for its Node 22.13+ runtime contract and supplies catalog entries to the loader
 rule:
 
 ```js

package/dist/index.cjs

@@ -6777,16 +6777,23 @@ function unwrapExpression(node) {
   }
   return node;
 }
-function isObjectFreeze(node) {
+function isObjectFreeze(node, isUnshadowedGlobal) {
   const inner = unwrapExpression(node);
-  return inner.type === import_utils49.AST_NODE_TYPES.CallExpression && inner.callee.type === import_utils49.AST_NODE_TYPES.MemberExpression && !inner.callee.computed && inner.callee.object.type === import_utils49.AST_NODE_TYPES.Identifier && inner.callee.object.name === "Object" && inner.callee.property.type === import_utils49.AST_NODE_TYPES.Identifier && inner.callee.property.name === "freeze";
+  if (inner.type === import_utils49.AST_NODE_TYPES.CallExpression && inner.callee.type === import_utils49.AST_NODE_TYPES.MemberExpression && !inner.callee.computed && inner.callee.object.type === import_utils49.AST_NODE_TYPES.Identifier && inner.callee.object.name === "Object" && isUnshadowedGlobal(inner.callee.object) && inner.callee.property.type === import_utils49.AST_NODE_TYPES.Identifier && inner.callee.property.name === "freeze" && inner.arguments.length === 1) {
+    const argument = inner.arguments[0];
+    return argument !== void 0 && argument.type !== import_utils49.AST_NODE_TYPES.SpreadElement && collectionKind(argument, isUnshadowedGlobal) === "literal";
+  }
+  return false;
 }
-function collectionKind(node) {
+function collectionKind(node, isUnshadowedGlobal) {
   const inner = unwrapExpression(node);
+  if (inner.type === import_utils49.AST_NODE_TYPES.CallExpression && inner.callee.type === import_utils49.AST_NODE_TYPES.MemberExpression && !inner.callee.computed && inner.callee.object.type === import_utils49.AST_NODE_TYPES.Identifier && inner.callee.object.name === "Object" && isUnshadowedGlobal(inner.callee.object) && inner.callee.property.type === import_utils49.AST_NODE_TYPES.Identifier && inner.callee.property.name === "freeze" && inner.arguments.length === 1 && inner.arguments[0] !== void 0 && inner.arguments[0].type !== import_utils49.AST_NODE_TYPES.SpreadElement) {
+    return collectionKind(inner.arguments[0], isUnshadowedGlobal);
+  }
   if (inner.type === import_utils49.AST_NODE_TYPES.ArrayExpression || inner.type === import_utils49.AST_NODE_TYPES.ObjectExpression) {
     return "literal";
   }
-  if (inner.type === import_utils49.AST_NODE_TYPES.NewExpression && inner.callee.type === import_utils49.AST_NODE_TYPES.Identifier && (inner.callee.name === "Set" || inner.callee.name === "Map")) {
+  if (inner.type === import_utils49.AST_NODE_TYPES.NewExpression && inner.callee.type === import_utils49.AST_NODE_TYPES.Identifier && (inner.callee.name === "Set" || inner.callee.name === "Map") && isUnshadowedGlobal(inner.callee)) {
     return inner.callee.name;
   }
   return null;
@@ -6799,7 +6806,7 @@ function isReadonlyType(node, kind) {
     return false;
   }
   if (node.typeName.name === "Readonly") {
-    return true;
+    return kind === "literal";
   }
   return kind === "literal" ? node.typeName.name === "ReadonlyArray" : node.typeName.name === `Readonly${kind}`;
 }
@@ -6846,6 +6853,10 @@ var prefer_immutable_module_constant_default = createRule({
   defaultOptions: [],
   create(context) {
     const sourceCode = context.sourceCode;
+    const isUnshadowedGlobal = (identifier) => {
+      const variable = import_utils49.ASTUtils.findVariable(sourceCode.getScope(identifier), identifier.name);
+      return variable === null || variable.defs.length === 0;
+    };
     if (isTestFile(context.filename) || isGeneratedFile(context.filename, sourceCode.getText())) {
       return {};
     }
@@ -6859,10 +6870,10 @@ var prefer_immutable_module_constant_default = createRule({
         if (container.type !== import_utils49.AST_NODE_TYPES.Program && !(container.type === import_utils49.AST_NODE_TYPES.ExportNamedDeclaration && container.parent.type === import_utils49.AST_NODE_TYPES.Program)) {
           return;
         }
-        if (isAsConst(node.init, (target) => sourceCode.getText(target)) || isObjectFreeze(node.init)) {
+        if (isAsConst(node.init, (target) => sourceCode.getText(target)) || isObjectFreeze(node.init, isUnshadowedGlobal)) {
           return;
         }
-        const kind = collectionKind(node.init);
+        const kind = collectionKind(node.init, isUnshadowedGlobal);
         if (kind === null || declaredReadonlyType(node, kind)) {
           return;
         }
@@ -7239,7 +7250,7 @@ var prefer_module_level_constant_default = createRule({
       }
     ],
     messages: {
-      hoistCollection: "`{{name}}` is a literal-only {{kind}} rebuilt on every call. Hoist it to module scope so it is allocated once and can be reused, exported, and tested.",
+      hoistCollection: "`{{name}}` is a literal-only {{kind}} rebuilt on every call. Hoist it to module scope in immutable form (`as const`, a readonly collection, or `Object.freeze`) so it is allocated once without exposing mutable shared state.",
       hoistRegex: "`{{name}}` is a constant regex recompiled on every call. Hoist it to module scope."
     }
   },
@@ -10631,7 +10642,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "9.13.0"
+  version: "9.13.1"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",

package/dist/index.d.cts

@@ -446,7 +446,7 @@ type FlatPreset = {
 declare const plugin: {
     meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "9.13.0";
+        readonly version: "9.13.1";
     };
     rules: {
         "enforce-file-structure": _typescript_eslint_utils_ts_eslint.RuleModule<"importsFirst" | "useServerDirective", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {

package/dist/index.d.ts

@@ -446,7 +446,7 @@ type FlatPreset = {
 declare const plugin: {
     meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "9.13.0";
+        readonly version: "9.13.1";
     };
     rules: {
         "enforce-file-structure": _typescript_eslint_utils_ts_eslint.RuleModule<"importsFirst" | "useServerDirective", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {

package/dist/index.js

@@ -6709,7 +6709,7 @@ var prefer_input_group_search_default = createRule({
 });
 
 // src/rules/prefer-immutable-module-constant.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES35 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES35, ASTUtils as ASTUtils3 } from "@typescript-eslint/utils";
 var CONSTANT_NAME = /^_?[A-Z][A-Z0-9_]*$/;
 var MUTATING_METHODS = /* @__PURE__ */ new Set([
   "add",
@@ -6738,16 +6738,23 @@ function unwrapExpression(node) {
   }
   return node;
 }
-function isObjectFreeze(node) {
+function isObjectFreeze(node, isUnshadowedGlobal) {
   const inner = unwrapExpression(node);
-  return inner.type === AST_NODE_TYPES35.CallExpression && inner.callee.type === AST_NODE_TYPES35.MemberExpression && !inner.callee.computed && inner.callee.object.type === AST_NODE_TYPES35.Identifier && inner.callee.object.name === "Object" && inner.callee.property.type === AST_NODE_TYPES35.Identifier && inner.callee.property.name === "freeze";
+  if (inner.type === AST_NODE_TYPES35.CallExpression && inner.callee.type === AST_NODE_TYPES35.MemberExpression && !inner.callee.computed && inner.callee.object.type === AST_NODE_TYPES35.Identifier && inner.callee.object.name === "Object" && isUnshadowedGlobal(inner.callee.object) && inner.callee.property.type === AST_NODE_TYPES35.Identifier && inner.callee.property.name === "freeze" && inner.arguments.length === 1) {
+    const argument = inner.arguments[0];
+    return argument !== void 0 && argument.type !== AST_NODE_TYPES35.SpreadElement && collectionKind(argument, isUnshadowedGlobal) === "literal";
+  }
+  return false;
 }
-function collectionKind(node) {
+function collectionKind(node, isUnshadowedGlobal) {
   const inner = unwrapExpression(node);
+  if (inner.type === AST_NODE_TYPES35.CallExpression && inner.callee.type === AST_NODE_TYPES35.MemberExpression && !inner.callee.computed && inner.callee.object.type === AST_NODE_TYPES35.Identifier && inner.callee.object.name === "Object" && isUnshadowedGlobal(inner.callee.object) && inner.callee.property.type === AST_NODE_TYPES35.Identifier && inner.callee.property.name === "freeze" && inner.arguments.length === 1 && inner.arguments[0] !== void 0 && inner.arguments[0].type !== AST_NODE_TYPES35.SpreadElement) {
+    return collectionKind(inner.arguments[0], isUnshadowedGlobal);
+  }
   if (inner.type === AST_NODE_TYPES35.ArrayExpression || inner.type === AST_NODE_TYPES35.ObjectExpression) {
     return "literal";
   }
-  if (inner.type === AST_NODE_TYPES35.NewExpression && inner.callee.type === AST_NODE_TYPES35.Identifier && (inner.callee.name === "Set" || inner.callee.name === "Map")) {
+  if (inner.type === AST_NODE_TYPES35.NewExpression && inner.callee.type === AST_NODE_TYPES35.Identifier && (inner.callee.name === "Set" || inner.callee.name === "Map") && isUnshadowedGlobal(inner.callee)) {
     return inner.callee.name;
   }
   return null;
@@ -6760,7 +6767,7 @@ function isReadonlyType(node, kind) {
     return false;
   }
   if (node.typeName.name === "Readonly") {
-    return true;
+    return kind === "literal";
   }
   return kind === "literal" ? node.typeName.name === "ReadonlyArray" : node.typeName.name === `Readonly${kind}`;
 }
@@ -6807,6 +6814,10 @@ var prefer_immutable_module_constant_default = createRule({
   defaultOptions: [],
   create(context) {
     const sourceCode = context.sourceCode;
+    const isUnshadowedGlobal = (identifier) => {
+      const variable = ASTUtils3.findVariable(sourceCode.getScope(identifier), identifier.name);
+      return variable === null || variable.defs.length === 0;
+    };
     if (isTestFile(context.filename) || isGeneratedFile(context.filename, sourceCode.getText())) {
       return {};
     }
@@ -6820,10 +6831,10 @@ var prefer_immutable_module_constant_default = createRule({
         if (container.type !== AST_NODE_TYPES35.Program && !(container.type === AST_NODE_TYPES35.ExportNamedDeclaration && container.parent.type === AST_NODE_TYPES35.Program)) {
           return;
         }
-        if (isAsConst(node.init, (target) => sourceCode.getText(target)) || isObjectFreeze(node.init)) {
+        if (isAsConst(node.init, (target) => sourceCode.getText(target)) || isObjectFreeze(node.init, isUnshadowedGlobal)) {
           return;
         }
-        const kind = collectionKind(node.init);
+        const kind = collectionKind(node.init, isUnshadowedGlobal);
         if (kind === null || declaredReadonlyType(node, kind)) {
           return;
         }
@@ -7200,7 +7211,7 @@ var prefer_module_level_constant_default = createRule({
       }
     ],
     messages: {
-      hoistCollection: "`{{name}}` is a literal-only {{kind}} rebuilt on every call. Hoist it to module scope so it is allocated once and can be reused, exported, and tested.",
+      hoistCollection: "`{{name}}` is a literal-only {{kind}} rebuilt on every call. Hoist it to module scope in immutable form (`as const`, a readonly collection, or `Object.freeze`) so it is allocated once without exposing mutable shared state.",
       hoistRegex: "`{{name}}` is a constant regex recompiled on every call. Hoist it to module scope."
     }
   },
@@ -7617,7 +7628,7 @@ var prefer_module_level_schema_default = createRule({
 });
 
 // src/rules/prefer-native-random-uuid.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES39, ASTUtils as ASTUtils3 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES39, ASTUtils as ASTUtils4 } from "@typescript-eslint/utils";
 function requireUuid(node) {
   return node?.type === AST_NODE_TYPES39.CallExpression && node.callee.type === AST_NODE_TYPES39.Identifier && node.callee.name === "require" && node.arguments.length === 1 && node.arguments[0]?.type === AST_NODE_TYPES39.Literal && node.arguments[0].value === "uuid";
 }
@@ -7640,7 +7651,7 @@ var prefer_native_random_uuid_default = createRule({
     const directBindings = /* @__PURE__ */ new Set();
     const namespaceBindings = /* @__PURE__ */ new Set();
     function resolve(identifier) {
-      return ASTUtils3.findVariable(context.sourceCode.getScope(identifier), identifier.name);
+      return ASTUtils4.findVariable(context.sourceCode.getScope(identifier), identifier.name);
     }
     function record(identifier, destination) {
       const variable = resolve(identifier);
@@ -9786,7 +9797,7 @@ var require_assert_never_default = createRule({
 });
 
 // src/rules/require-fetch-timeout.ts
-import { AST_NODE_TYPES as AST_NODE_TYPES48, ASTUtils as ASTUtils4 } from "@typescript-eslint/utils";
+import { AST_NODE_TYPES as AST_NODE_TYPES48, ASTUtils as ASTUtils5 } from "@typescript-eslint/utils";
 var GLOBAL_OBJECTS2 = /* @__PURE__ */ new Set([
   "globalThis",
   "window",
@@ -9856,7 +9867,7 @@ var require_fetch_timeout_default = createRule({
     }
     function resolvesToGlobal(identifier) {
       const scope = context.sourceCode.getScope(identifier);
-      const variable = ASTUtils4.findVariable(scope, identifier.name);
+      const variable = ASTUtils5.findVariable(scope, identifier.name);
       return variable === null || variable.defs.length === 0;
     }
     function isGlobalFetchCall2(callee) {
@@ -10595,7 +10606,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "9.13.0"
+  version: "9.13.1"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "9.13.0",
+  "version": "9.13.1",
   "packageManager": "npm@11.19.0",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",
@@ -16,7 +16,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
@@ -79,7 +80,7 @@
     "typescript": ">=5.0.0"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.13.0"
   },
   "allowScripts": {
     "esbuild@0.28.1": true,