@blumintinc/eslint-plugin-blumint 1.19.22 → 1.19.24

package/lib/index.js

@@ -222,7 +222,7 @@ function noFrontendImportsFromFunctionsPatterns(pattern) {
 module.exports = {
     meta: {
         name: '@blumintinc/eslint-plugin-blumint',
-        version: '1.19.22',
+        version: '1.19.24',
     },
     parseOptions: {
         ecmaVersion: 2020,

package/lib/rules/enforce-positive-naming.js

@@ -171,7 +171,12 @@ const IN_EXCEPTIONS = [
     'infusion',
     'ingenious',
     'ingenuity',
+    'ingest',
     'ingested',
+    'ingestible',
+    'ingesting',
+    'ingestion',
+    'ingests',
     'ingot',
     'ingrained',
     'ingredient',

package/lib/rules/react-memoize-literals.js

@@ -86,6 +86,21 @@ const ITERATION_METHODS = new Set([
     'flatMap',
     'sort',
 ]);
+/**
+ * Comparison operators whose result is a boolean primitive. A value produced by
+ * one of these can never carry a referential identity, so a call whose result
+ * feeds such a comparison never lets its argument's identity escape.
+ */
+const COMPARISON_OPERATORS = new Set([
+    '===',
+    '!==',
+    '==',
+    '!=',
+    '<',
+    '>',
+    '<=',
+    '>=',
+]);
 const MEMOIZATION_DEPS_TODO_PLACEHOLDER = '__TODO_MEMOIZATION_DEPENDENCIES__';
 const TODO_DEPS_COMMENT = `/* ${MEMOIZATION_DEPS_TODO_PLACEHOLDER} */`;
 const PARENTHESIZED_EXPRESSION_TYPE = utils_1.AST_NODE_TYPES.ParenthesizedExpression ??
@@ -847,6 +862,108 @@ exports.reactMemoizeLiterals = (0, createRule_1.createRule)({
             }
             return usages.every((ref) => isStyleJSXAttributeValue(ref.identifier));
         }
+        /**
+         * True when `expr` — a plain function call's result, or a reference to the
+         * variable holding that result — is consumed only for its primitive value,
+         * never by reference.
+         *
+         * Referential stability of a call's ARGUMENT matters only if the call's
+         * RESULT reaches a memoization boundary (a hook dependency, a memoized
+         * child's prop, an effect capture) where identities are reference-compared.
+         * A result that lands in a boolean-test position — a ternary/if/while/for
+         * test, a `!`, a comparison, or a logical chain that itself ends in such a
+         * position — is coerced to (or already is) a primitive, so the argument's
+         * identity provably never crosses such a boundary regardless of what the
+         * callee returns. Reasoning from how the CALLER consumes the result (not the
+         * callee's body) keeps the analysis purely syntactic and type-free.
+         *
+         * The whitelist is deliberately tight: any position not proven primitive
+         * (JSX attribute value, hook dependency element, argument to another call,
+         * spread, return, object/array member) yields false, so the exemption never
+         * silences a literal whose identity could still escape.
+         */
+        function isPrimitivelyConsumed(expr) {
+            const parent = expr.parent;
+            if (!parent) {
+                return false;
+            }
+            // TS-assertion/parenthesized wrappers are transparent to consumption:
+            // analyze how the wrapped value is ultimately used.
+            if (isExpressionWrapper(parent)) {
+                const wrapper = parent;
+                return wrapper.expression === expr && isPrimitivelyConsumed(parent);
+            }
+            switch (parent.type) {
+                case utils_1.AST_NODE_TYPES.ConditionalExpression:
+                    return parent.test === expr;
+                case utils_1.AST_NODE_TYPES.IfStatement:
+                case utils_1.AST_NODE_TYPES.WhileStatement:
+                case utils_1.AST_NODE_TYPES.DoWhileStatement:
+                case utils_1.AST_NODE_TYPES.ForStatement:
+                    return parent.test === expr;
+                case utils_1.AST_NODE_TYPES.UnaryExpression:
+                    return parent.operator === '!';
+                case utils_1.AST_NODE_TYPES.BinaryExpression:
+                    return COMPARISON_OPERATORS.has(parent.operator);
+                case utils_1.AST_NODE_TYPES.LogicalExpression:
+                    // A logical operand inherits the consumption of the whole expression:
+                    // safe only if that ultimately lands in a primitive position too.
+                    return isPrimitivelyConsumed(parent);
+                case utils_1.AST_NODE_TYPES.VariableDeclarator: {
+                    if (parent.init !== expr ||
+                        parent.id.type !== utils_1.AST_NODE_TYPES.Identifier) {
+                        return false;
+                    }
+                    const variables = ASTHelpers_1.ASTHelpers.getDeclaredVariables(context, parent);
+                    if (variables.length === 0) {
+                        return false;
+                    }
+                    const usages = variables[0].references.filter((ref) => !ref.init);
+                    // No usages (dead code): can't prove the result stays primitive, so
+                    // keep the literal reported (mirrors isStyleVariableInitializer).
+                    if (usages.length === 0) {
+                        return false;
+                    }
+                    return usages.every((ref) => isPrimitivelyConsumed(ref.identifier));
+                }
+                default:
+                    return false;
+            }
+        }
+        /**
+         * True when the literal is a direct argument of a plain function call whose
+         * result is only ever consumed primitively (see isPrimitivelyConsumed). In
+         * that case the literal's identity provably never reaches a memoization
+         * boundary — it is neither a JSX prop, nor a hook dependency, nor captured
+         * by an effect — so re-creating it each render costs nothing and memoizing
+         * it buys nothing. The callee must be a plain Identifier: member calls
+         * (`obj.method({...})`) are excluded because the receiver could retain the
+         * reference, and this keeps the guard to plain, non-hook synchronous calls.
+         */
+        function isPrimitiveConsumedCallArgument(node) {
+            // Walk up through transparent wrappers to the position the literal
+            // effectively occupies as a call argument.
+            let effective = node;
+            let parent = effective.parent;
+            while (parent &&
+                isExpressionWrapper(parent) &&
+                parent
+                    .expression === effective) {
+                effective = parent;
+                parent = effective.parent;
+            }
+            if (!parent || parent.type !== utils_1.AST_NODE_TYPES.CallExpression) {
+                return false;
+            }
+            const isDirectArgument = parent.arguments.some((arg) => arg === effective);
+            if (!isDirectArgument) {
+                return false;
+            }
+            if (parent.callee.type !== utils_1.AST_NODE_TYPES.Identifier) {
+                return false;
+            }
+            return isPrimitivelyConsumed(parent);
+        }
         function reportLiteral(node) {
             const descriptor = getLiteralDescriptor(node);
             if (!descriptor)
@@ -937,6 +1054,14 @@ exports.reactMemoizeLiterals = (0, createRule_1.createRule)({
                 });
                 return;
             }
+            // A literal passed only as an argument to a plain synchronous call whose
+            // result is consumed primitively never carries its identity to a
+            // memoization boundary, so memoizing it is pointless (issue #1329). Placed
+            // last so hook-argument and hook-return handling run first and are
+            // unaffected.
+            if (isPrimitiveConsumedCallArgument(node)) {
+                return;
+            }
             const contextLabel = formatContextLabel(owner);
             // Only emit auto-fix suggestions for simple variable initializers; other
             // contexts (returns, JSX props, nested expressions) risk unsafe rewrites.

package/lib/rules/vertically-group-related-functions.js

@@ -605,9 +605,18 @@ exports.verticallyGroupRelatedFunctions = (0, createRule_1.createRule)({
                 if (misplacedIndex === -1) {
                     return;
                 }
-                const misplacedInfo = functions[misplacedIndex];
-                const targetIndex = expectedNames.indexOf(misplacedInfo.name);
-                const anchorName = targetIndex > 0 ? expectedNames[targetIndex - 1] : null;
+                // Report the function that BELONGS in the first mismatched slot
+                // (expected[i]), not the wrong occupant currently sitting there
+                // (actual[i]). Telling the reader to move expected[i] up to right after
+                // expected[i-1] fills the hole and extends the already-correct prefix
+                // by one, so obeying each emitted instruction verbatim strictly
+                // converges on the fixed point. Naming the displaced occupant instead
+                // sends it off to its own final home without filling this slot — the
+                // prefix stays mismatched and the next pass emits a different
+                // instruction anchored on a different sibling, the non-converging
+                // "anchor chase" on diamond/shared-leaf graphs (#1330).
+                const misplacedInfo = expectedOrderInfos[misplacedIndex];
+                const anchorName = misplacedIndex > 0 ? expectedNames[misplacedIndex - 1] : null;
                 const dependencyReason = misplacedInfo.dependencies.length > 0
                     ? normalizedOptions.dependencyDirection === 'callees-first'
                         ? `it calls ${misplacedInfo.dependencies.join(', ')} and helpers should precede the callers that depend on them when dependencyDirection is "callees-first"`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blumintinc/eslint-plugin-blumint",
-  "version": "1.19.22",
+  "version": "1.19.24",
   "description": "Custom eslint rules for use within BluMint",
   "author": {
     "name": "Brodie McGuire",

package/release-manifest.json

@@ -1,4 +1,40 @@
 [
+  {
+    "version": "1.19.24",
+    "date": "2026-07-22T21:30:58.024Z",
+    "rules": [
+      {
+        "name": "enforce-positive-naming",
+        "changeType": "fix",
+        "issues": [
+          1331
+        ],
+        "summary": "exempt ingest word family from in- prefix heuristic (closes #1331)"
+      },
+      {
+        "name": "vertically-group-related-functions",
+        "changeType": "fix",
+        "issues": [
+          1330
+        ],
+        "summary": "fill the mismatched slot instead of evicting its occupant (closes #1330)"
+      }
+    ]
+  },
+  {
+    "version": "1.19.23",
+    "date": "2026-07-22T15:32:41.825Z",
+    "rules": [
+      {
+        "name": "react-memoize-literals",
+        "changeType": "fix",
+        "issues": [
+          1329
+        ],
+        "summary": "exempt literal args to primitively-consumed plain calls (closes #1329)"
+      }
+    ]
+  },
   {
     "version": "1.19.22",
     "date": "2026-07-22T09:39:07.911Z",