@blumintinc/eslint-plugin-blumint 1.20.41 β†’ 1.20.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/README.md +196 -197
  2. package/lib/index.js +1 -1
  3. package/lib/rules/enforce-callback-memo.js +9 -0
  4. package/lib/rules/logical-top-to-bottom-grouping.js +41 -1
  5. package/lib/rules/memo-nested-react-components.js +127 -1
  6. package/lib/utils/ASTHelpers.d.ts +41 -0
  7. package/lib/utils/ASTHelpers.js +146 -0
  8. package/lib/utils/installValidCaseGuard.d.ts +1 -0
  9. package/lib/utils/installValidCaseGuard.js +24 -0
  10. package/lib/utils/validCaseFalsifiability.d.ts +48 -0
  11. package/lib/utils/validCaseFalsifiability.js +118 -0
  12. package/package.json +2 -2
  13. package/release-manifest.json +38 -0
package/README.md CHANGED
@@ -73,209 +73,208 @@ full closed loop is documented in agora's `.claude/skills/eslint-autonomy/SKILL.
73
73
  <!-- begin auto-generated rules list -->
74
74
 
75
75
  πŸ’Ό Configurations enabled in.\
76
- ⚠️ Configurations set to warn in.\
77
76
  🚫 Configurations disabled in.\
78
77
  βœ… Set in the `recommended` configuration.\
79
78
  πŸ”§ Automatically fixable by the [`--fix` CLI option](https://eslint.org/docs/user-guide/command-line-interface#--fix).\
80
79
  πŸ’‘ Manually fixable by [editor suggestions](https://eslint.org/docs/latest/use/core-concepts#rule-suggestions).\
81
80
  πŸ’­ Requires [type information](https://typescript-eslint.io/linting/typed-linting).
82
81
 
83
- | NameΒ Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β  | Description | πŸ’Ό | ⚠️ | 🚫 | πŸ”§ | πŸ’‘ | πŸ’­ |
84
- | :----------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :- | :- | :- | :- | :- | :- |
85
- | [array-methods-this-context](docs/rules/array-methods-this-context.md) | Prevent misuse of Array methods in OOP | βœ… | | | | | |
86
- | [avoid-utils-directory](docs/rules/avoid-utils-directory.md) | Enforce using util/ instead of utils/ directory | βœ… | | | | | |
87
- | [class-methods-read-top-to-bottom](docs/rules/class-methods-read-top-to-bottom.md) | Enforces a top-to-bottom class layout so callers lead into the helpers they rely on. | βœ… | | | πŸ”§ | | |
88
- | [consistent-callback-naming](docs/rules/consistent-callback-naming.md) | Enforce consistent naming conventions for callback props and functions | βœ… | | | πŸ”§ | | |
89
- | [dynamic-https-errors](docs/rules/dynamic-https-errors.md) | Keep HttpsError messages static and move request-specific details to the third argument so error identifiers remain stable and debugging context is preserved. | βœ… | | | | | |
90
- | [enforce-assert-safe-object-key](docs/rules/enforce-assert-safe-object-key.md) | Enforce the use of assertSafe(id) when accessing object properties with computed keys that involve string interpolation or explicit string conversion. | βœ… | | | πŸ”§ | | |
91
- | [enforce-assert-throws](docs/rules/enforce-assert-throws.md) | Enforce that functions with an assert prefix must throw an error or call process.exit(1), and functions that call assert-prefixed methods should themselves be assert-prefixed | βœ… | | | | | |
92
- | [enforce-boolean-naming-prefixes](docs/rules/enforce-boolean-naming-prefixes.md) | Enforce consistent naming conventions for boolean values by requiring approved prefixes | βœ… | | | | | |
93
- | [enforce-callable-types](docs/rules/enforce-callable-types.md) | Enforce Props and Response type exports in callable functions | βœ… | | | | | |
94
- | [enforce-callback-memo](docs/rules/enforce-callback-memo.md) | Enforce useCallback for inline functions and useMemo for objects/arrays containing functions in JSX props to prevent unnecessary re-renders. This improves React component performance by ensuring stable function references across renders and memoizing complex objects. | βœ… | | | | | |
95
- | [enforce-centralized-mock-firestore](docs/rules/enforce-centralized-mock-firestore.md) | Enforce usage of centralized mockFirestore from predefined location | βœ… | | | πŸ”§ | | |
96
- | [enforce-cloud-function-id-length](docs/rules/enforce-cloud-function-id-length.md) | Ensures .f.ts file paths generate Firebase Cloud Function IDs within the 62-character limit | βœ… | | | | | |
97
- | [enforce-console-error](docs/rules/enforce-console-error.md) | Enforce proper logging for useAlertDialog based on severity. When severity is "error", console.error must be included. When severity is "warning", console.warn must be included. This ensures all user-facing errors and warnings are properly logged to observability systems. | βœ… | | | | | |
98
- | [enforce-css-media-queries](docs/rules/enforce-css-media-queries.md) | Enforce CSS media queries over JS breakpoints | βœ… | | | | | |
99
- | [enforce-date-ttime](docs/rules/enforce-date-ttime.md) | Enforce that any generic type parameter named TTime is explicitly set to Date in frontend code | βœ… | | | πŸ”§ | | |
100
- | [enforce-dynamic-file-naming](docs/rules/enforce-dynamic-file-naming.md) | Enforce .dynamic.ts(x) file naming when @blumintinc/blumint/enforce-dynamic-imports or @blumintinc/blumint/require-dynamic-firebase-imports rule is disabled | | | | | | |
101
- | [enforce-dynamic-firebase-imports](docs/rules/enforce-dynamic-firebase-imports.md) | Require firebaseCloud modules to be loaded via dynamic import so Firebase code stays out of the initial bundle and only loads when needed. | βœ… | | | πŸ”§ | πŸ’‘ | |
102
- | [enforce-dynamic-imports](docs/rules/enforce-dynamic-imports.md) | Enforce dynamic imports for external libraries by default to optimize bundle size, unless explicitly ignored | βœ… | | | | | |
103
- | [enforce-early-destructuring](docs/rules/enforce-early-destructuring.md) | Hoist object destructuring out of React hooks so dependency arrays track the fields in use instead of the entire object. | βœ… | | | πŸ”§ | | |
104
- | [enforce-empty-object-check](docs/rules/enforce-empty-object-check.md) | Ensure object existence checks also guard against empty objects so that empty payloads are treated like missing data. | βœ… | | | πŸ”§ | | |
105
- | [enforce-exported-function-types](docs/rules/enforce-exported-function-types.md) | Enforce exporting types for function props and return values | βœ… | | | | | |
106
- | [enforce-f-extension-for-entry-points](docs/rules/enforce-f-extension-for-entry-points.md) | Enforce .f.ts extension for entry points | βœ… | | | | | |
107
- | [enforce-fieldpath-syntax-in-docsetter](docs/rules/enforce-fieldpath-syntax-in-docsetter.md) | Enforce the use of Firestore FieldPath syntax when passing documentData into DocSetter. Instead of using nested object syntax, developers should use dot notation for deeply nested fields. | βœ… | | | πŸ”§ | | |
108
- | [enforce-firestore-doc-ref-generic](docs/rules/enforce-firestore-doc-ref-generic.md) | Enforce generic argument for Firestore DocumentReference, CollectionReference and CollectionGroup | βœ… | | | | | πŸ’­ |
109
- | [enforce-firestore-facade](docs/rules/enforce-firestore-facade.md) | Enforce usage of Firestore facades instead of direct Firestore methods | βœ… | | | | | |
110
- | [enforce-firestore-path-utils](docs/rules/enforce-firestore-path-utils.md) | Enforce usage of utility functions for Firestore paths to ensure type safety, maintainability, and consistent path construction. This prevents errors from manual string concatenation and makes path changes easier to manage. | βœ… | | | | | |
111
- | [enforce-firestore-rules-get-access](docs/rules/enforce-firestore-rules-get-access.md) | Ensure Firestore security rules use .get() with a default value instead of direct field access comparisons (e.g., resource.data.fieldX.fieldY != null). | βœ… | | | πŸ”§ | | |
112
- | [enforce-firestore-set-merge](docs/rules/enforce-firestore-set-merge.md) | Enforce using set() with { merge: true } instead of update() for Firestore operations to ensure consistent behavior. The update() method fails if the document does not exist, while set() with { merge: true } creates the document if needed and safely merges fields, making it more reliable and predictable. | βœ… | | | πŸ”§ | | |
113
- | [enforce-global-constants](docs/rules/enforce-global-constants.md) | Enforce global static constants for React components/hooks | βœ… | | | πŸ”§ | | |
114
- | [enforce-id-capitalization](docs/rules/enforce-id-capitalization.md) | Enforce the use of "ID" instead of "id" in user-facing text | βœ… | | | πŸ”§ | | |
115
- | [enforce-identifiable-firestore-type](docs/rules/enforce-identifiable-firestore-type.md) | Enforce that Firestore type definitions extend Identifiable and match their folder name | βœ… | | | | | |
116
- | [enforce-is-prefix-validators](docs/rules/enforce-is-prefix-validators.md) | Enforce the `is` (or other allowed predicate) prefix for exported validators in **/validators/**/*.ts files | βœ… | | | | | |
117
- | [enforce-m3-sentence-case](docs/rules/enforce-m3-sentence-case.md) | Enforce Material Design 3 sentence-case capitalisation for user-facing text β€” flag Title Case and ALL CAPS strings in JSX text and configured string props. | βœ… | | | | πŸ’‘ | |
118
- | [enforce-memoize-async](docs/rules/enforce-memoize-async.md) | Enforce @Memoize() decorator on async methods with 0-1 parameters to cache results and prevent redundant API calls or expensive computations. Without memoization, repeated calls trigger redundant requests or expensive computations, increasing latency. @Memoize() caches results by parameter, ensuring subsequent calls with identical inputs return immediately. | βœ… | | | πŸ”§ | | |
119
- | [enforce-memoize-getters](docs/rules/enforce-memoize-getters.md) | Enforce @Memoize() decorator on private class getters to avoid re-instantiation and preserve state across accesses. | βœ… | | | πŸ”§ | | |
120
- | [enforce-microdiff](docs/rules/enforce-microdiff.md) | Enforce using microdiff for object and array comparison operations | βœ… | | | πŸ”§ | | |
121
- | [enforce-mock-firestore](docs/rules/enforce-mock-firestore.md) | Enforce using the standardized mockFirestore utility instead of manual Firestore mocking or third-party mocks. This ensures consistent test behavior across the codebase, reduces boilerplate, and provides type-safe mocking of Firestore operations. | βœ… | | | | | |
122
- | [enforce-mui-rounded-icons](docs/rules/enforce-mui-rounded-icons.md) | Enforce the use of -Rounded variant for MUI icons | βœ… | | | πŸ”§ | | |
123
- | [enforce-object-literal-as-const](docs/rules/enforce-object-literal-as-const.md) | Enforce that object literals returned from functions should be marked with `as const` to ensure type safety and immutability. | βœ… | | | πŸ”§ | | |
124
- | [enforce-positive-naming](docs/rules/enforce-positive-naming.md) | Enforce positive naming for boolean variables and avoid negations | βœ… | | | | | |
125
- | [enforce-props-argument-name](docs/rules/enforce-props-argument-name.md) | Authoritative rule: parameters with types ending in "Props" should be named "props" (or prefixed variants when multiple Props params exist) | βœ… | | | πŸ”§ | | |
126
- | [enforce-props-naming-consistency](docs/rules/enforce-props-naming-consistency.md) | Prefer naming single "Props"-typed parameters as "props"; enforcement defers to enforce-props-argument-name for multi-Props cases | βœ… | | | πŸ”§ | | |
127
- | [enforce-querykey-ts](docs/rules/enforce-querykey-ts.md) | Enforce using centralized router state key constants from queryKeys.ts for useRouterState key parameter | βœ… | | | πŸ”§ | | |
128
- | [enforce-react-type-naming](docs/rules/enforce-react-type-naming.md) | Enforce naming conventions for React types | βœ… | | | πŸ”§ | | |
129
- | [enforce-realtimedb-path-utils](docs/rules/enforce-realtimedb-path-utils.md) | Enforce usage of utility functions for Realtime Database paths | βœ… | | | | | |
130
- | [enforce-render-hits-memoization](docs/rules/enforce-render-hits-memoization.md) | Enforce proper memoization and usage of useRenderHits and renderHits | βœ… | | | | | |
131
- | [enforce-safe-stringify](docs/rules/enforce-safe-stringify.md) | Enforce using safe-stable-stringify instead of JSON.stringify to handle circular references and ensure deterministic output. JSON.stringify can throw errors on circular references and produce inconsistent output for objects with the same properties in different orders. safe-stable-stringify handles these cases safely. | βœ… | | | | πŸ’‘ | |
132
- | [enforce-serializable-params](docs/rules/enforce-serializable-params.md) | Enforce serializable parameters for Firebase callable/HTTPS functions. | βœ… | | | | | |
133
- | [enforce-single-exported-unit-per-file](docs/rules/enforce-single-exported-unit-per-file.md) | Enforce that a .tsx/.jsx file exports at most one React component and any file exports at most one class | βœ… | | | | | |
134
- | [enforce-singular-type-names](docs/rules/enforce-singular-type-names.md) | Enforce TypeScript type names to be singular | βœ… | | | | | |
135
- | [enforce-snapshot-state-narrowing](docs/rules/enforce-snapshot-state-narrowing.md) | Enforce correct narrowing of FirestoreSnapshotState<T> variables. Falsy/truthy checks are semantic bugs because all string states are truthy; raw typeof narrowing to data bypasses the isSnapshotReady abstraction. | βœ… | | | | πŸ’‘ | |
136
- | [enforce-stable-hash-spread-props](docs/rules/enforce-stable-hash-spread-props.md) | Require stableHash wrapping when spread props rest objects are used in React hook dependency arrays to avoid re-renders triggered by new object references on every render. | βœ… | | | πŸ”§ | | |
137
- | [enforce-storage-context](docs/rules/enforce-storage-context.md) | Require storage access to go through the LocalStorage and SessionStorage context providers instead of direct browser APIs | βœ… | | | | | |
138
- | [enforce-timestamp-now](docs/rules/enforce-timestamp-now.md) | Enforce the use of Timestamp.now() for getting the current timestamp in backend code. This rule prevents using alternatives like Timestamp.fromDate(new Date()) or other date creation patterns that could lead to inconsistency. | βœ… | | | πŸ”§ | | |
139
- | [enforce-transform-memoization](docs/rules/enforce-transform-memoization.md) | Enforce memoization of transformValue and transformOnChange in adaptValue | βœ… | | | | | |
140
- | [enforce-types-directory-placement](docs/rules/enforce-types-directory-placement.md) | Enforce that type-only files (containing only type/interface/enum declarations) live under the canonical types directory | βœ… | | | | | |
141
- | [enforce-typescript-markdown-code-blocks](docs/rules/enforce-typescript-markdown-code-blocks.md) | Ensure Markdown fenced code blocks without a language specifier default to typescript for consistent highlighting. | βœ… | | | πŸ”§ | | |
142
- | [enforce-unique-cursor-headers](docs/rules/enforce-unique-cursor-headers.md) | Ensure files have exactly one cursor header containing required tags (e.g., @fileoverview) before any code | βœ… | | | πŸ”§ | | |
143
- | [enforce-verb-noun-naming](docs/rules/enforce-verb-noun-naming.md) | Enforce verb phrases for functions and methods | βœ… | | | | | |
144
- | [ensure-pointer-events-none](docs/rules/ensure-pointer-events-none.md) | Ensure pointer-events: none is added to non-interactive pseudo-elements | βœ… | | | πŸ”§ | | |
145
- | [export-if-in-doubt](docs/rules/export-if-in-doubt.md) | All top-level variable declarations, type definitions, and functions should be exported | βœ… | | | | | |
146
- | [extract-global-constants](docs/rules/extract-global-constants.md) | Extract static constants and functions to the global scope when possible, and enforce type narrowing with as const for numeric literals in loops | βœ… | | | | | |
147
- | [fast-deep-equal-over-microdiff](docs/rules/fast-deep-equal-over-microdiff.md) | Enforce using fast-deep-equal for equality checks instead of microdiff | βœ… | | | πŸ”§ | | |
148
- | [firestore-transaction-reads-before-writes](docs/rules/firestore-transaction-reads-before-writes.md) | Enforce that all Firestore transaction read operations are performed before any write operations | βœ… | | | | | |
149
- | [flatten-push-calls](docs/rules/flatten-push-calls.md) | Consolidate consecutive push calls on the same array into a single push with multiple arguments. | βœ… | | | πŸ”§ | | |
150
- | [generic-starts-with-t](docs/rules/generic-starts-with-t.md) | Enforce TypeScript generic type parameters to start with T so they stand out from runtime values. | βœ… | | | | | |
151
- | [global-const-style](docs/rules/global-const-style.md) | Enforce UPPER_SNAKE_CASE and as const for global static constants | βœ… | | | πŸ”§ | | |
152
- | [jsdoc-above-field](docs/rules/jsdoc-above-field.md) | Require JSDoc blocks to sit above fields instead of trailing inline so IDE hovers surface the documentation. | βœ… | | | πŸ”§ | | |
153
- | [key-only-outermost-element](docs/rules/key-only-outermost-element.md) | Enforce that only the outermost element in list rendering has a key prop | βœ… | | | πŸ”§ | | |
154
- | [logical-top-to-bottom-grouping](docs/rules/logical-top-to-bottom-grouping.md) | Enforce logical top-to-bottom grouping of related statements | βœ… | | | πŸ”§ | | |
155
- | [memo-compare-deeply-complex-props](docs/rules/memo-compare-deeply-complex-props.md) | Suggest compareDeeply for memoized components that receive object/array props to avoid shallow comparison re-renders. | βœ… | | | πŸ”§ | | πŸ’­ |
156
- | [memo-nested-react-components](docs/rules/memo-nested-react-components.md) | Disallow React components defined in render bodies, hooks, or passed as props | βœ… | | | | | |
157
- | [memoize-root-level-hocs](docs/rules/memoize-root-level-hocs.md) | Prevent creating Higher-Order Components at the root level of React components/hooks without wrapping them in useMemo to keep wrapped component identities stable across renders. | βœ… | | | | | |
158
- | [no-always-true-false-conditions](docs/rules/no-always-true-false-conditions.md) | Detect conditions that are always truthy or always falsy | βœ… | | | | | |
159
- | [no-array-length-in-deps](docs/rules/no-array-length-in-deps.md) | Detects array.length entries in React hook dependency arrays because length ignores content changes; auto-fixes by memoizing stableHash(array) with useMemo and depending on the hash instead. | βœ… | | | πŸ”§ | | |
160
- | [no-async-array-filter](docs/rules/no-async-array-filter.md) | Disallow async callbacks in Array.filter(). Async predicates return Promises that are always truthy to the filter, so no element is ever removed. Resolve async checks first (Promise.all + map) or use a synchronous predicate to decide which items to keep. | βœ… | | | | | |
161
- | [no-async-foreach](docs/rules/no-async-foreach.md) | Disallow async callbacks to Array.forEach | βœ… | | | | | |
162
- | [no-circular-references](docs/rules/no-circular-references.md) | Disallow circular references in objects | βœ… | | | | | |
163
- | [no-class-instance-destructuring](docs/rules/no-class-instance-destructuring.md) | Disallow destructuring of class instances to prevent loss of `this` context | βœ… | | | πŸ”§ | | |
164
- | [no-complex-cloud-params](docs/rules/no-complex-cloud-params.md) | Disallow passing complex objects to cloud functions | βœ… | | | | | |
165
- | [no-compositing-layer-props](docs/rules/no-compositing-layer-props.md) | Discourage CSS properties that force GPU compositing layers (e.g., transform, filter, will-change). Extra layers consume GPU memory and split rendering work, which slows scrolling and animation when sprinkled across a page. The rule inspects inline style objects and MUI sx props so layer promotion stays intentional rather than incidental. | βœ… | | | | | |
166
- | [no-conditional-literals-in-jsx](docs/rules/no-conditional-literals-in-jsx.md) | Disallow conditional string literals beside other JSX text to avoid fragmented text nodes, translation issues, and hydration mismatches. | βœ… | | | | | |
167
- | [no-console-error](docs/rules/no-console-error.md) | Disallow console.error so errors flow through structured handling (HttpsError/useErrorAlert on frontend, structured loggers on backend). | βœ… | | | | | |
168
- | [no-curly-brackets-around-commented-properties](docs/rules/no-curly-brackets-around-commented-properties.md) | Disallow curly-brace blocks that only wrap commented-out members inside type declarations | βœ… | | | πŸ”§ | | |
169
- | [no-direct-function-state](docs/rules/no-direct-function-state.md) | Prevent passing a function directly to a useState setter β€” React will invoke it as a functional updater instead of storing it. Wrap in a thunk: setState(() => fn). | βœ… | | | πŸ”§ | | |
170
- | [no-empty-dependency-use-callbacks](docs/rules/no-empty-dependency-use-callbacks.md) | Discourage useCallback([]) or useLatestCallback around static functions. Static callbacks do not need hook machineryβ€”extract them to module-level utilities for clarity and to avoid unnecessary hook overhead. | βœ… | | | πŸ”§ | | |
171
- | [no-entire-object-hook-deps](docs/rules/no-entire-object-hook-deps.md) | Avoid using entire objects in React hook dependency arrays. | βœ… | | | πŸ”§ | | πŸ’­ |
172
- | [no-excessive-parent-chain](docs/rules/no-excessive-parent-chain.md) | Discourage excessive use of the ref.parent property chain in Firestore and RealtimeDB change handlers | | | | | πŸ’‘ | |
173
- | [no-explicit-return-type](docs/rules/no-explicit-return-type.md) | Disallow explicit return type annotations on functions when TypeScript can infer them. This reduces code verbosity and maintenance burden while leveraging TypeScript's powerful type inference. Exceptions are made for type guard functions (using the `is` keyword), recursive functions, overloaded functions, interface methods, and abstract methods where explicit types improve clarity. | βœ… | | | πŸ”§ | | |
174
- | [no-fill-template-mutation](docs/rules/no-fill-template-mutation.md) | Disallow mutating the return value of fillTemplate() via string concatenation, template literals, or string method calls. The filled Algolia filter must be used verbatim so matchesTemplate() can regex-match it; post-fill modification silently breaks realtime hash parity. | βœ… | | | | | |
175
- | [no-filter-without-return](docs/rules/no-filter-without-return.md) | Disallow Array.filter callbacks without an explicit return (if part of a block statement) | βœ… | | | | | |
176
- | [no-firestore-jest-mock](docs/rules/no-firestore-jest-mock.md) | Prevent importing firestore-jest-mock in test files | βœ… | | | πŸ”§ | | |
177
- | [no-firestore-object-arrays](docs/rules/no-firestore-object-arrays.md) | Disallow arrays of object types in Firestore models. Prefer Record maps keyed by id with an index field, or subcollections/arrays of IDs. | βœ… | | | | | |
178
- | [no-handler-suffix](docs/rules/no-handler-suffix.md) | Disallow the generic "handler" suffix in callback names so names explain the action they perform | βœ… | | | | | |
179
- | [no-harness-coupled-disables](docs/rules/no-harness-coupled-disables.md) | Disallow eslint-disable justifications that reference the agent development harness (worktree, cwd, stop-hook, claude) instead of the code’s own semantics. | βœ… | | | | | |
180
- | [no-hungarian](docs/rules/no-hungarian.md) | Disallow Hungarian notation in locally declared variables, types, and classes | βœ… | | | | | |
181
- | [no-inline-component-prop](docs/rules/no-inline-component-prop.md) | Prevent inline function components defined in render from being passed to component-type props like CatalogWrapper to avoid remounts and UI flashes. | βœ… | | | | | |
182
- | [no-jsx-in-hooks](docs/rules/no-jsx-in-hooks.md) | Prevent hooks from returning JSX | βœ… | | | | | |
183
- | [no-jsx-whitespace-literal](docs/rules/no-jsx-whitespace-literal.md) | Disallow the use of {" "} elements in JSX code | βœ… | | | | | |
184
- | [no-margin-properties](docs/rules/no-margin-properties.md) | Prevent margin properties (margin, marginLeft, marginRight, marginTop, marginBottom, mx, my, etc.) in MUI styling because margins fight container-controlled spacing, double gutters, and misaligned breakpoints; keep spacing centralized with padding, gap, or spacing props instead. | βœ… | | | | | |
185
- | [no-memoize-on-static](docs/rules/no-memoize-on-static.md) | Prevent using @Memoize() decorator on static methods | βœ… | | | | | |
186
- | [no-misleading-boolean-prefixes](docs/rules/no-misleading-boolean-prefixes.md) | Reserve boolean-style prefixes (is/has/should) for functions that actually return boolean values to avoid misleading call sites. | βœ… | | | | | |
187
- | [no-misused-switch-case](docs/rules/no-misused-switch-case.md) | Prevent misuse of logical OR (\|\|) in switch case statements, which can lead to confusing and error-prone code. Instead of using OR operators in case expressions, use multiple case statements in sequence to handle multiple values. This improves code readability and follows the standard switch-case pattern. | βœ… | | | | | |
188
- | [no-mixed-firestore-transactions](docs/rules/no-mixed-firestore-transactions.md) | Prevent mixing transactional and non-transactional Firestore operations within a transaction | βœ… | | | | | |
189
- | [no-mock-firebase-admin](docs/rules/no-mock-firebase-admin.md) | Prevent direct mocking of firebaseAdmin; use shared test helpers instead | βœ… | | | | | |
190
- | [no-object-values-on-strings](docs/rules/no-object-values-on-strings.md) | Disallow Object.values() on strings as it treats strings as arrays of characters, which is likely unintended behavior. | βœ… | | | | | |
191
- | [no-overridable-method-calls-in-constructor](docs/rules/no-overridable-method-calls-in-constructor.md) | Disallow calling overridable methods in constructors to prevent unexpected behavior | βœ… | | | | | |
192
- | [no-passthrough-getters](docs/rules/no-passthrough-getters.md) | Avoid getter methods that only re-expose nested properties on constructor-injected objects without adding behavior | βœ… | | | | | |
193
- | [no-portal-inside-tooltip](docs/rules/no-portal-inside-tooltip.md) | Disallow portal-rendering components (Dialog, Drawer, Menu, Popover, Portal, Modal) inside Tooltip wrapper components. React Portals preserve React-tree event bubbling, so a portal nested under a Tooltip leaves the tooltip orphaned over the modal. | βœ… | | | | | |
194
- | [no-redundant-annotation-assertion](docs/rules/no-redundant-annotation-assertion.md) | Disallow combining a type annotation with an identical type assertion on the same value. Keep a single source of truth to avoid redundant type declarations that can drift apart. | βœ… | | | πŸ”§ | | πŸ’­ |
195
- | [no-redundant-boolean-callback-props](docs/rules/no-redundant-boolean-callback-props.md) | Disallow redundant boolean props that duplicate the semantic meaning of optional callback props, violating the Interface Segregation Principle. | βœ… | | | | | |
196
- | [no-redundant-param-types](docs/rules/no-redundant-param-types.md) | Disallow redundant parameter type annotations | βœ… | | | πŸ”§ | | |
197
- | [no-redundant-this-params](docs/rules/no-redundant-this-params.md) | Disallow passing class instance members (this.foo) into class instance methods; access the member from this inside the method instead. | βœ… | | | | | |
198
- | [no-redundant-usecallback-wrapper](docs/rules/no-redundant-usecallback-wrapper.md) | Prevent wrapping already memoized/stable callbacks from hooks/contexts in an extra useCallback() | βœ… | | | πŸ”§ | | |
199
- | [no-render-function-components](docs/rules/no-render-function-components.md) | Disallow declaring a local `render*` function that returns JSX and consuming it as a plain function (direct call or array-iteration callback); author it as a real component rendered with JSX instead | βœ… | | | | | |
200
- | [no-res-error-status-in-onrequest](docs/rules/no-res-error-status-in-onrequest.md) | Forbid sending 4xx/5xx Express responses inside onRequest handlers; throw structured HttpsError instances instead so the wrapper can format, log, and map errors consistently. | βœ… | | | | | |
201
- | [no-restricted-properties-fix](docs/rules/no-restricted-properties-fix.md) | Disallow certain properties on certain objects, with special handling for Object.keys() and Object.values() | | | | | | |
202
- | [no-satisfies-in-frontend-bundle](docs/rules/no-satisfies-in-frontend-bundle.md) | Disallow the `satisfies` operator in files that reach the frontend webpack bundle (Next.js 12 SWC cannot parse it) | βœ… | | | | | |
203
- | [no-separate-loading-state](docs/rules/no-separate-loading-state.md) | Disallow separate loading state variables that track the loading status of other state | βœ… | | | | | |
204
- | [no-single-dismiss-dialog-button](docs/rules/no-single-dismiss-dialog-button.md) | Disallow a single dialog button whose label is a dismiss action (Cancel, Close, Dismiss, Not now, Never mind). Use navigation.onClose for dismissal; the buttons array should only contain affirmative actions. | βœ… | | | | | |
205
- | [no-stablehash-react-nodes](docs/rules/no-stablehash-react-nodes.md) | Prevent passing ReactNodes or render-tree values to stableHash(), which deep-stringifies its argument and can freeze the browser. | βœ… | | | | | |
206
- | [no-stale-state-across-await](docs/rules/no-stale-state-across-await.md) | Prevent stale intermediate state by disallowing useState setter calls both before and after async boundaries (await, .then(), yield) within the same function | βœ… | | | | | |
207
- | [no-static-constants-in-dynamic-files](docs/rules/no-static-constants-in-dynamic-files.md) | Disallow exporting SCREAMING_SNAKE_CASE constants from .dynamic.ts/.dynamic.tsx files; move static constants to non-dynamic modules instead. | βœ… | | | | | |
208
- | [no-try-catch-already-exists-in-transaction](docs/rules/no-try-catch-already-exists-in-transaction.md) | Disallow catching ALREADY_EXISTS errors inside Firestore transaction callbacks | βœ… | | | | | |
209
- | [no-type-assertion-returns](docs/rules/no-type-assertion-returns.md) | Enforce typing variables before returning them, rather than using type assertions or explicit return types | βœ… | | | | | |
210
- | [no-undefined-null-passthrough](docs/rules/no-undefined-null-passthrough.md) | Avoid functions that return undefined or null when their single argument is undefined or null | βœ… | | | | | |
211
- | [no-unmemoized-memo-without-props](docs/rules/no-unmemoized-memo-without-props.md) | Prevent wrapping prop-less Unmemoized components in memo since memo provides no benefit without props and adds unnecessary indirection | βœ… | | | | | |
212
- | [no-unnecessary-destructuring](docs/rules/no-unnecessary-destructuring.md) | Avoid object patterns that only spread an existing object, since they clone the whole value without selecting properties | βœ… | | | πŸ”§ | | |
213
- | [no-unnecessary-destructuring-rename](docs/rules/no-unnecessary-destructuring-rename.md) | Disallow destructuring renames that are only used to assign back to the original property name | βœ… | | | πŸ”§ | | |
214
- | [no-unnecessary-verb-suffix](docs/rules/no-unnecessary-verb-suffix.md) | Prevent unnecessary verb suffixes in function and method names | βœ… | | | πŸ”§ | | |
215
- | [no-unpinned-dependencies](docs/rules/no-unpinned-dependencies.md) | Enforces pinned dependencies | βœ… | | | πŸ”§ | | |
216
- | [no-unsafe-firestore-spread](docs/rules/no-unsafe-firestore-spread.md) | Prevent unsafe object/array spreads in Firestore updates | βœ… | | | | | |
217
- | [no-unused-props](docs/rules/no-unused-props.md) | Detect unused props in React component type definitions | βœ… | | | | | |
218
- | [no-unused-usestate](docs/rules/no-unused-usestate.md) | Disallow unused useState hooks | βœ… | | | πŸ”§ | | |
219
- | [no-useless-fragment](docs/rules/no-useless-fragment.md) | Prevent unnecessary use of React fragments | βœ… | | | πŸ”§ | | |
220
- | [no-useless-usememo-primitives](docs/rules/no-useless-usememo-primitives.md) | Disallow useless useMemo with primitive values. | βœ… | | | πŸ”§ | | |
221
- | [no-usememo-for-pass-by-value](docs/rules/no-usememo-for-pass-by-value.md) | Disallow returning useMemo results from custom hooks when the memoized value is pass-by-value: primitives with value equality (string, number, boolean, null, undefined, bigint) or arrays/tuples composed exclusively of these primitives. Requires type information. | βœ… | | | πŸ”§ | | πŸ’­ |
222
- | [no-uuidv4-base62-as-key](docs/rules/no-uuidv4-base62-as-key.md) | Disallow using uuidv4Base62() to generate keys for elements in a list or loop | βœ… | | | | | |
223
- | [omit-index-html](docs/rules/omit-index-html.md) | Disallow the use of "index.html" in URLs | βœ… | | | πŸ”§ | | |
224
- | [optimize-object-boolean-conditions](docs/rules/optimize-object-boolean-conditions.md) | Detects and suggests optimizations for boolean conditions formed over objects in React hook dependencies. Suggests extracting boolean conditions into separate variables to reduce unnecessary re-computations when objects change frequently but the boolean condition changes less frequently. | βœ… | | | | | |
225
- | [parallelize-async-operations](docs/rules/parallelize-async-operations.md) | Enforce the use of Promise.all() when multiple independent asynchronous operations are awaited sequentially | βœ… | | | πŸ”§ | | |
226
- | [parallelize-loop-awaits](docs/rules/parallelize-loop-awaits.md) | Disallow sequential await expressions inside loops when iterations could be parallelized with Promise.all(items.map(...)) | βœ… | | | | | |
227
- | [prefer-batch-operations](docs/rules/prefer-batch-operations.md) | Enforce using setAll() and overwriteAll() instead of multiple set() or overwrite() calls | βœ… | | | | | |
228
- | [prefer-block-comments-for-declarations](docs/rules/prefer-block-comments-for-declarations.md) | Enforce the use of block comments for declarations | βœ… | | | πŸ”§ | | |
229
- | [prefer-clone-deep](docs/rules/prefer-clone-deep.md) | Prefer using cloneDeep over nested spread copying | βœ… | | | πŸ”§ | | |
230
- | [prefer-destructuring-no-class](docs/rules/prefer-destructuring-no-class.md) | Enforce destructuring when accessing object properties, except for class instances | βœ… | | | πŸ”§ | | |
231
- | [prefer-docsetter-setall](docs/rules/prefer-docsetter-setall.md) | Enforce batching DocSetter and DocSetterTransaction writes by using setAll instead of set inside loops or array callbacks. | βœ… | | | | | |
232
- | [prefer-document-flattening](docs/rules/prefer-document-flattening.md) | Enforce using the shouldFlatten option when setting deeply nested objects in Firestore documents | | | | | πŸ’‘ | |
233
- | [prefer-field-paths-in-transforms](docs/rules/prefer-field-paths-in-transforms.md) | Flatten aggregation updates inside transformEach so diff-based deletes remove only the intended fields instead of wiping sibling data. | βœ… | | | | | |
234
- | [prefer-flat-transform-each-keys](docs/rules/prefer-flat-transform-each-keys.md) | Warn when transformEach in a propagation strategy returns nested object values instead of flat dot-notation keys. | βœ… | | | | | |
235
- | [prefer-fragment-component](docs/rules/prefer-fragment-component.md) | Require the Fragment named import instead of shorthand fragments or React.Fragment to keep fragments explicit and prop-friendly | | | βœ… | πŸ”§ | | |
236
- | [prefer-fragment-shorthand](docs/rules/prefer-fragment-shorthand.md) | Prefer <> shorthand for <React.Fragment> | βœ… | | | πŸ”§ | | |
237
- | [prefer-getter-over-parameterless-method](docs/rules/prefer-getter-over-parameterless-method.md) | Enforce getter syntax for synchronous parameterless methods that return values, improving semantic clarity and avoiding accidental method invocation without parentheses. | βœ… | | | πŸ”§ | | |
238
- | [prefer-global-router-state-key](docs/rules/prefer-global-router-state-key.md) | Enforce using centralized router state key constants from queryKeys.ts for useRouterState key parameter | βœ… | | | πŸ”§ | | |
239
- | [prefer-map-over-conditional-dispatch](docs/rules/prefer-map-over-conditional-dispatch.md) | Prefer a Record<Discriminant, Value> lookup over switch/ternary/if-else dispatch on a literal-union discriminant where every branch returns or assigns a single value. | βœ… | | | πŸ”§ | | πŸ’­ |
240
- | [prefer-next-dynamic](docs/rules/prefer-next-dynamic.md) | Prefer Next.js dynamic() over custom useDynamic() for component imports | βœ… | | | πŸ”§ | | |
241
- | [prefer-nullish-coalescing-boolean-props](docs/rules/prefer-nullish-coalescing-boolean-props.md) | Prefer nullish coalescing over logical OR, but allow logical OR in boolean contexts | βœ… | | | πŸ”§ | | |
242
- | [prefer-params-over-parent-id](docs/rules/prefer-params-over-parent-id.md) | Prefer event.params over ref.parent.id for type-safe Firebase trigger paths. | βœ… | | | πŸ”§ | | |
243
- | [prefer-settings-object](docs/rules/prefer-settings-object.md) | Enforce using a settings object for functions with multiple parameters | βœ… | | | | | |
244
- | [prefer-spread-over-reassembly](docs/rules/prefer-spread-over-reassembly.md) | Prefer spread syntax over destructure-then-reassemble when all destructured fields are forwarded identically to a single target | βœ… | | | πŸ”§ | | |
245
- | [prefer-sx-prop-over-system-props](docs/rules/prefer-sx-prop-over-system-props.md) | Enforce using the MUI `sx` prop instead of deprecated system props (e.g. `mt`, `display`, `flexDirection`) on MUI components. | βœ… | | | πŸ”§ | | |
246
- | [prefer-type-alias-over-typeof-constant](docs/rules/prefer-type-alias-over-typeof-constant.md) | Prefer named type aliases over `typeof` on same-file global constants; ensure types are declared before constants. | βœ… | | | | | |
247
- | [prefer-type-over-interface](docs/rules/prefer-type-over-interface.md) | Prefer using type alias over interface | βœ… | | | πŸ”§ | | |
248
- | [prefer-union-from-const-array](docs/rules/prefer-union-from-const-array.md) | Derive string-literal union types from an `as const` array instead of declaring the union inline, so the runtime value set and the type share a single source of truth | βœ… | | | πŸ”§ | | |
249
- | [prefer-url-tostring-over-tojson](docs/rules/prefer-url-tostring-over-tojson.md) | Enforce the use of toString() over toJSON() on URL objects. | βœ… | | | πŸ”§ | | |
250
- | [prefer-use-base62-id](docs/rules/prefer-use-base62-id.md) | Prefer `useBase62Id()` over `uuidv4Base62()` inside useState/useRef/useMemo for stable component IDs to avoid SSR hydration mismatches | βœ… | | | | | |
251
- | [prefer-use-deep-compare-memo](docs/rules/prefer-use-deep-compare-memo.md) | Enforce using useDeepCompareMemo when dependency array contains non-primitive values (objects, arrays) that are not already memoized. This prevents unnecessary re-renders due to reference changes. | βœ… | | | πŸ”§ | | |
252
- | [prefer-use-theme](docs/rules/prefer-use-theme.md) | Enforce reading MUI theme values via useTheme() or the sx theme callback instead of importing theme constants directly from src/styles/* modules. | βœ… | | | | | |
253
- | [prefer-usecallback-over-usememo-for-functions](docs/rules/prefer-usecallback-over-usememo-for-functions.md) | Enforce using useCallback instead of useMemo for memoizing functions | βœ… | | | πŸ”§ | | |
254
- | [prefer-usememo-over-useeffect-usestate](docs/rules/prefer-usememo-over-useeffect-usestate.md) | Prefer useMemo over useEffect + useState for pure computations to avoid extra render cycles and stale derived state. | βœ… | | | | | |
255
- | [prefer-utility-function-over-private-static](docs/rules/prefer-utility-function-over-private-static.md) | Enforce abstraction of private static methods into utility functions | βœ… | | | | | |
256
- | [prefer-utility-function-own-file](docs/rules/prefer-utility-function-own-file.md) | Enforce that sizable utility functions live in their own file rather than being co-located inside an entry-point or consumer file | βœ… | | | | | |
257
- | [prevent-children-clobber](docs/rules/prevent-children-clobber.md) | Prevent JSX spreads from silently discarding props.children | βœ… | | | | | |
258
- | [react-memoize-literals](docs/rules/react-memoize-literals.md) | Detect object, array, and function literals created in React components or hooks that create new references every render. Prefer memoized values (useMemo/useCallback) or module-level constants to keep referential stability. | βœ… | | | | πŸ’‘ | |
259
- | [react-usememo-should-be-component](docs/rules/react-usememo-should-be-component.md) | Enforce that useMemo hooks explicitly returning JSX should be abstracted into separate React components | βœ… | | | | | |
260
- | [require-dynamic-firebase-imports](docs/rules/require-dynamic-firebase-imports.md) | Enforce dynamic imports for Firebase dependencies | βœ… | | | πŸ”§ | | |
261
- | [require-hooks-default-params](docs/rules/require-hooks-default-params.md) | Enforce React hooks with optional parameters to default to an empty object | βœ… | | | πŸ”§ | | |
262
- | [require-https-error](docs/rules/require-https-error.md) | Enforce using proprietary HttpsError instead of throw new Error or firebase-admin HttpsError in functions/src | βœ… | | | | | |
263
- | [require-https-error-cause](docs/rules/require-https-error-cause.md) | Ensure HttpsError calls inside catch blocks pass the caught error as the fourth "cause" argument to preserve stack traces for monitoring. | βœ… | | | | | |
264
- | [require-image-optimized](docs/rules/require-image-optimized.md) | Enforce using ImageOptimized component instead of next/image or img tags | βœ… | | | πŸ”§ | | |
265
- | [require-memo](docs/rules/require-memo.md) | React components must be memoized | βœ… | | | πŸ”§ | | |
266
- | [require-memoize-jsx-returners](docs/rules/require-memoize-jsx-returners.md) | Require @Memoize() decorator on instance members that return JSX or JSX factories | βœ… | | | πŸ”§ | | |
267
- | [require-migration-script-metadata](docs/rules/require-migration-script-metadata.md) | Enforce JSDoc migration metadata in callable scripts | βœ… | | | | | |
268
- | [require-props-composition](docs/rules/require-props-composition.md) | Require React component Props types to compose (via Pick/Omit) with the props types of non-leaf child components rendered in JSX | βœ… | | | | | |
269
- | [require-server-timestamp-for-firestore-dates](docs/rules/require-server-timestamp-for-firestore-dates.md) | Enforce serverTimestamp() instead of new Date() for Firestore timestamp fields | βœ… | | | | | |
270
- | [semantic-function-prefixes](docs/rules/semantic-function-prefixes.md) | Require semantic function prefixes instead of generic verbs so callers know whether a function fetches data, transforms input, or mutates state | βœ… | | | | | |
271
- | [sync-onwrite-name-func](docs/rules/sync-onwrite-name-func.md) | Ensure that the name field matches the func field in onWrite handlers | βœ… | | | πŸ”§ | | |
272
- | [test-file-location-enforcement](docs/rules/test-file-location-enforcement.md) | Enforce colocating *.test.ts or *.test.tsx files with the code they cover. | βœ… | | | | | |
273
- | [use-custom-link](docs/rules/use-custom-link.md) | Enforce using src/components/Link instead of next/link | βœ… | | | πŸ”§ | | |
274
- | [use-custom-memo](docs/rules/use-custom-memo.md) | Enforce using src/util/memo instead of React memo | βœ… | | | πŸ”§ | | |
275
- | [use-custom-router](docs/rules/use-custom-router.md) | Enforce using src/hooks/routing/useRouter instead of next/router | βœ… | | | πŸ”§ | | |
276
- | [use-latest-callback](docs/rules/use-latest-callback.md) | Enforce using useLatestCallback from use-latest-callback instead of React useCallback | βœ… | | | πŸ”§ | | |
277
- | [vertically-group-related-functions](docs/rules/vertically-group-related-functions.md) | Keep top-level functions grouped vertically so callers, exports, and helpers read top-down. | βœ… | | | πŸ”§ | | |
278
- | [warn-https-error-message-user-friendly](docs/rules/warn-https-error-message-user-friendly.md) | Warn when messageUserFriendly is used in HttpsError or toHttpsError to ensure it is truly a user-caused error. | βœ… | | | | | |
82
+ | NameΒ Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β Β  | Description | πŸ’Ό | 🚫 | πŸ”§ | πŸ’‘ | πŸ’­ |
83
+ | :----------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :- | :- | :- | :- | :- |
84
+ | [array-methods-this-context](docs/rules/array-methods-this-context.md) | Prevent misuse of Array methods in OOP | βœ… | | | | |
85
+ | [avoid-utils-directory](docs/rules/avoid-utils-directory.md) | Enforce using util/ instead of utils/ directory | βœ… | | | | |
86
+ | [class-methods-read-top-to-bottom](docs/rules/class-methods-read-top-to-bottom.md) | Enforces a top-to-bottom class layout so callers lead into the helpers they rely on. | βœ… | | πŸ”§ | | |
87
+ | [consistent-callback-naming](docs/rules/consistent-callback-naming.md) | Enforce consistent naming conventions for callback props and functions | βœ… | | πŸ”§ | | |
88
+ | [dynamic-https-errors](docs/rules/dynamic-https-errors.md) | Keep HttpsError messages static and move request-specific details to the third argument so error identifiers remain stable and debugging context is preserved. | βœ… | | | | |
89
+ | [enforce-assert-safe-object-key](docs/rules/enforce-assert-safe-object-key.md) | Enforce the use of assertSafe(id) when accessing object properties with computed keys that involve string interpolation or explicit string conversion. | βœ… | | πŸ”§ | | |
90
+ | [enforce-assert-throws](docs/rules/enforce-assert-throws.md) | Enforce that functions with an assert prefix must throw an error or call process.exit(1), and functions that call assert-prefixed methods should themselves be assert-prefixed | βœ… | | | | |
91
+ | [enforce-boolean-naming-prefixes](docs/rules/enforce-boolean-naming-prefixes.md) | Enforce consistent naming conventions for boolean values by requiring approved prefixes | βœ… | | | | |
92
+ | [enforce-callable-types](docs/rules/enforce-callable-types.md) | Enforce Props and Response type exports in callable functions | βœ… | | | | |
93
+ | [enforce-callback-memo](docs/rules/enforce-callback-memo.md) | Enforce useCallback for inline functions and useMemo for objects/arrays containing functions in JSX props to prevent unnecessary re-renders. This improves React component performance by ensuring stable function references across renders and memoizing complex objects. | βœ… | | | | |
94
+ | [enforce-centralized-mock-firestore](docs/rules/enforce-centralized-mock-firestore.md) | Enforce usage of centralized mockFirestore from predefined location | βœ… | | πŸ”§ | | |
95
+ | [enforce-cloud-function-id-length](docs/rules/enforce-cloud-function-id-length.md) | Ensures .f.ts file paths generate Firebase Cloud Function IDs within the 62-character limit | βœ… | | | | |
96
+ | [enforce-console-error](docs/rules/enforce-console-error.md) | Enforce proper logging for useAlertDialog based on severity. When severity is "error", console.error must be included. When severity is "warning", console.warn must be included. This ensures all user-facing errors and warnings are properly logged to observability systems. | βœ… | | | | |
97
+ | [enforce-css-media-queries](docs/rules/enforce-css-media-queries.md) | Enforce CSS media queries over JS breakpoints | βœ… | | | | |
98
+ | [enforce-date-ttime](docs/rules/enforce-date-ttime.md) | Enforce that any generic type parameter named TTime is explicitly set to Date in frontend code | βœ… | | πŸ”§ | | |
99
+ | [enforce-dynamic-file-naming](docs/rules/enforce-dynamic-file-naming.md) | Enforce .dynamic.ts(x) file naming when @blumintinc/blumint/enforce-dynamic-imports or @blumintinc/blumint/require-dynamic-firebase-imports rule is disabled | | | | | |
100
+ | [enforce-dynamic-firebase-imports](docs/rules/enforce-dynamic-firebase-imports.md) | Require firebaseCloud modules to be loaded via dynamic import so Firebase code stays out of the initial bundle and only loads when needed. | βœ… | | πŸ”§ | πŸ’‘ | |
101
+ | [enforce-dynamic-imports](docs/rules/enforce-dynamic-imports.md) | Enforce dynamic imports for external libraries by default to optimize bundle size, unless explicitly ignored | βœ… | | | | |
102
+ | [enforce-early-destructuring](docs/rules/enforce-early-destructuring.md) | Hoist object destructuring out of React hooks so dependency arrays track the fields in use instead of the entire object. | βœ… | | πŸ”§ | | |
103
+ | [enforce-empty-object-check](docs/rules/enforce-empty-object-check.md) | Ensure object existence checks also guard against empty objects so that empty payloads are treated like missing data. | βœ… | | πŸ”§ | | |
104
+ | [enforce-exported-function-types](docs/rules/enforce-exported-function-types.md) | Enforce exporting types for function props and return values | βœ… | | | | |
105
+ | [enforce-f-extension-for-entry-points](docs/rules/enforce-f-extension-for-entry-points.md) | Enforce .f.ts extension for entry points | βœ… | | | | |
106
+ | [enforce-fieldpath-syntax-in-docsetter](docs/rules/enforce-fieldpath-syntax-in-docsetter.md) | Enforce the use of Firestore FieldPath syntax when passing documentData into DocSetter. Instead of using nested object syntax, developers should use dot notation for deeply nested fields. | βœ… | | πŸ”§ | | |
107
+ | [enforce-firestore-doc-ref-generic](docs/rules/enforce-firestore-doc-ref-generic.md) | Enforce generic argument for Firestore DocumentReference, CollectionReference and CollectionGroup | βœ… | | | | πŸ’­ |
108
+ | [enforce-firestore-facade](docs/rules/enforce-firestore-facade.md) | Enforce usage of Firestore facades instead of direct Firestore methods | βœ… | | | | |
109
+ | [enforce-firestore-path-utils](docs/rules/enforce-firestore-path-utils.md) | Enforce usage of utility functions for Firestore paths to ensure type safety, maintainability, and consistent path construction. This prevents errors from manual string concatenation and makes path changes easier to manage. | βœ… | | | | |
110
+ | [enforce-firestore-rules-get-access](docs/rules/enforce-firestore-rules-get-access.md) | Ensure Firestore security rules use .get() with a default value instead of direct field access comparisons (e.g., resource.data.fieldX.fieldY != null). | βœ… | | πŸ”§ | | |
111
+ | [enforce-firestore-set-merge](docs/rules/enforce-firestore-set-merge.md) | Enforce using set() with { merge: true } instead of update() for Firestore operations to ensure consistent behavior. The update() method fails if the document does not exist, while set() with { merge: true } creates the document if needed and safely merges fields, making it more reliable and predictable. | βœ… | | πŸ”§ | | |
112
+ | [enforce-global-constants](docs/rules/enforce-global-constants.md) | Enforce global static constants for React components/hooks | βœ… | | πŸ”§ | | |
113
+ | [enforce-id-capitalization](docs/rules/enforce-id-capitalization.md) | Enforce the use of "ID" instead of "id" in user-facing text | βœ… | | πŸ”§ | | |
114
+ | [enforce-identifiable-firestore-type](docs/rules/enforce-identifiable-firestore-type.md) | Enforce that Firestore type definitions extend Identifiable and match their folder name | βœ… | | | | |
115
+ | [enforce-is-prefix-validators](docs/rules/enforce-is-prefix-validators.md) | Enforce the `is` (or other allowed predicate) prefix for exported validators in **/validators/**/*.ts files | βœ… | | | | |
116
+ | [enforce-m3-sentence-case](docs/rules/enforce-m3-sentence-case.md) | Enforce Material Design 3 sentence-case capitalisation for user-facing text β€” flag Title Case and ALL CAPS strings in JSX text and configured string props. | βœ… | | | πŸ’‘ | |
117
+ | [enforce-memoize-async](docs/rules/enforce-memoize-async.md) | Enforce @Memoize() decorator on async methods with 0-1 parameters to cache results and prevent redundant API calls or expensive computations. Without memoization, repeated calls trigger redundant requests or expensive computations, increasing latency. @Memoize() caches results by parameter, ensuring subsequent calls with identical inputs return immediately. | βœ… | | πŸ”§ | | |
118
+ | [enforce-memoize-getters](docs/rules/enforce-memoize-getters.md) | Enforce @Memoize() decorator on private class getters to avoid re-instantiation and preserve state across accesses. | βœ… | | πŸ”§ | | |
119
+ | [enforce-microdiff](docs/rules/enforce-microdiff.md) | Enforce using microdiff for object and array comparison operations | βœ… | | πŸ”§ | | |
120
+ | [enforce-mock-firestore](docs/rules/enforce-mock-firestore.md) | Enforce using the standardized mockFirestore utility instead of manual Firestore mocking or third-party mocks. This ensures consistent test behavior across the codebase, reduces boilerplate, and provides type-safe mocking of Firestore operations. | βœ… | | | | |
121
+ | [enforce-mui-rounded-icons](docs/rules/enforce-mui-rounded-icons.md) | Enforce the use of -Rounded variant for MUI icons | βœ… | | πŸ”§ | | |
122
+ | [enforce-object-literal-as-const](docs/rules/enforce-object-literal-as-const.md) | Enforce that object literals returned from functions should be marked with `as const` to ensure type safety and immutability. | βœ… | | πŸ”§ | | |
123
+ | [enforce-positive-naming](docs/rules/enforce-positive-naming.md) | Enforce positive naming for boolean variables and avoid negations | βœ… | | | | |
124
+ | [enforce-props-argument-name](docs/rules/enforce-props-argument-name.md) | Authoritative rule: parameters with types ending in "Props" should be named "props" (or prefixed variants when multiple Props params exist) | βœ… | | πŸ”§ | | |
125
+ | [enforce-props-naming-consistency](docs/rules/enforce-props-naming-consistency.md) | Prefer naming single "Props"-typed parameters as "props"; enforcement defers to enforce-props-argument-name for multi-Props cases | βœ… | | πŸ”§ | | |
126
+ | [enforce-querykey-ts](docs/rules/enforce-querykey-ts.md) | Enforce using centralized router state key constants from queryKeys.ts for useRouterState key parameter | βœ… | | πŸ”§ | | |
127
+ | [enforce-react-type-naming](docs/rules/enforce-react-type-naming.md) | Enforce naming conventions for React types | βœ… | | πŸ”§ | | |
128
+ | [enforce-realtimedb-path-utils](docs/rules/enforce-realtimedb-path-utils.md) | Enforce usage of utility functions for Realtime Database paths | βœ… | | | | |
129
+ | [enforce-render-hits-memoization](docs/rules/enforce-render-hits-memoization.md) | Enforce proper memoization and usage of useRenderHits and renderHits | βœ… | | | | |
130
+ | [enforce-safe-stringify](docs/rules/enforce-safe-stringify.md) | Enforce using safe-stable-stringify instead of JSON.stringify to handle circular references and ensure deterministic output. JSON.stringify can throw errors on circular references and produce inconsistent output for objects with the same properties in different orders. safe-stable-stringify handles these cases safely. | βœ… | | | πŸ’‘ | |
131
+ | [enforce-serializable-params](docs/rules/enforce-serializable-params.md) | Enforce serializable parameters for Firebase callable/HTTPS functions. | βœ… | | | | |
132
+ | [enforce-single-exported-unit-per-file](docs/rules/enforce-single-exported-unit-per-file.md) | Enforce that a .tsx/.jsx file exports at most one React component and any file exports at most one class | βœ… | | | | |
133
+ | [enforce-singular-type-names](docs/rules/enforce-singular-type-names.md) | Enforce TypeScript type names to be singular | βœ… | | | | |
134
+ | [enforce-snapshot-state-narrowing](docs/rules/enforce-snapshot-state-narrowing.md) | Enforce correct narrowing of FirestoreSnapshotState<T> variables. Falsy/truthy checks are semantic bugs because all string states are truthy; raw typeof narrowing to data bypasses the isSnapshotReady abstraction. | βœ… | | | πŸ’‘ | |
135
+ | [enforce-stable-hash-spread-props](docs/rules/enforce-stable-hash-spread-props.md) | Require stableHash wrapping when spread props rest objects are used in React hook dependency arrays to avoid re-renders triggered by new object references on every render. | βœ… | | πŸ”§ | | |
136
+ | [enforce-storage-context](docs/rules/enforce-storage-context.md) | Require storage access to go through the LocalStorage and SessionStorage context providers instead of direct browser APIs | βœ… | | | | |
137
+ | [enforce-timestamp-now](docs/rules/enforce-timestamp-now.md) | Enforce the use of Timestamp.now() for getting the current timestamp in backend code. This rule prevents using alternatives like Timestamp.fromDate(new Date()) or other date creation patterns that could lead to inconsistency. | βœ… | | πŸ”§ | | |
138
+ | [enforce-transform-memoization](docs/rules/enforce-transform-memoization.md) | Enforce memoization of transformValue and transformOnChange in adaptValue | βœ… | | | | |
139
+ | [enforce-types-directory-placement](docs/rules/enforce-types-directory-placement.md) | Enforce that type-only files (containing only type/interface/enum declarations) live under the canonical types directory | βœ… | | | | |
140
+ | [enforce-typescript-markdown-code-blocks](docs/rules/enforce-typescript-markdown-code-blocks.md) | Ensure Markdown fenced code blocks without a language specifier default to typescript for consistent highlighting. | βœ… | | πŸ”§ | | |
141
+ | [enforce-unique-cursor-headers](docs/rules/enforce-unique-cursor-headers.md) | Ensure files have exactly one cursor header containing required tags (e.g., @fileoverview) before any code | βœ… | | πŸ”§ | | |
142
+ | [enforce-verb-noun-naming](docs/rules/enforce-verb-noun-naming.md) | Enforce verb phrases for functions and methods | βœ… | | | | |
143
+ | [ensure-pointer-events-none](docs/rules/ensure-pointer-events-none.md) | Ensure pointer-events: none is added to non-interactive pseudo-elements | βœ… | | πŸ”§ | | |
144
+ | [export-if-in-doubt](docs/rules/export-if-in-doubt.md) | All top-level variable declarations, type definitions, and functions should be exported | βœ… | | | | |
145
+ | [extract-global-constants](docs/rules/extract-global-constants.md) | Extract static constants and functions to the global scope when possible, and enforce type narrowing with as const for numeric literals in loops | βœ… | | | | |
146
+ | [fast-deep-equal-over-microdiff](docs/rules/fast-deep-equal-over-microdiff.md) | Enforce using fast-deep-equal for equality checks instead of microdiff | βœ… | | πŸ”§ | | |
147
+ | [firestore-transaction-reads-before-writes](docs/rules/firestore-transaction-reads-before-writes.md) | Enforce that all Firestore transaction read operations are performed before any write operations | βœ… | | | | |
148
+ | [flatten-push-calls](docs/rules/flatten-push-calls.md) | Consolidate consecutive push calls on the same array into a single push with multiple arguments. | βœ… | | πŸ”§ | | |
149
+ | [generic-starts-with-t](docs/rules/generic-starts-with-t.md) | Enforce TypeScript generic type parameters to start with T so they stand out from runtime values. | βœ… | | | | |
150
+ | [global-const-style](docs/rules/global-const-style.md) | Enforce UPPER_SNAKE_CASE and as const for global static constants | βœ… | | πŸ”§ | | |
151
+ | [jsdoc-above-field](docs/rules/jsdoc-above-field.md) | Require JSDoc blocks to sit above fields instead of trailing inline so IDE hovers surface the documentation. | βœ… | | πŸ”§ | | |
152
+ | [key-only-outermost-element](docs/rules/key-only-outermost-element.md) | Enforce that only the outermost element in list rendering has a key prop | βœ… | | πŸ”§ | | |
153
+ | [logical-top-to-bottom-grouping](docs/rules/logical-top-to-bottom-grouping.md) | Enforce logical top-to-bottom grouping of related statements | βœ… | | πŸ”§ | | |
154
+ | [memo-compare-deeply-complex-props](docs/rules/memo-compare-deeply-complex-props.md) | Suggest compareDeeply for memoized components that receive object/array props to avoid shallow comparison re-renders. | βœ… | | πŸ”§ | | πŸ’­ |
155
+ | [memo-nested-react-components](docs/rules/memo-nested-react-components.md) | Disallow React components defined in render bodies, hooks, or passed as props | βœ… | | | | |
156
+ | [memoize-root-level-hocs](docs/rules/memoize-root-level-hocs.md) | Prevent creating Higher-Order Components at the root level of React components/hooks without wrapping them in useMemo to keep wrapped component identities stable across renders. | βœ… | | | | |
157
+ | [no-always-true-false-conditions](docs/rules/no-always-true-false-conditions.md) | Detect conditions that are always truthy or always falsy | βœ… | | | | |
158
+ | [no-array-length-in-deps](docs/rules/no-array-length-in-deps.md) | Detects array.length entries in React hook dependency arrays because length ignores content changes; auto-fixes by memoizing stableHash(array) with useMemo and depending on the hash instead. | βœ… | | πŸ”§ | | |
159
+ | [no-async-array-filter](docs/rules/no-async-array-filter.md) | Disallow async callbacks in Array.filter(). Async predicates return Promises that are always truthy to the filter, so no element is ever removed. Resolve async checks first (Promise.all + map) or use a synchronous predicate to decide which items to keep. | βœ… | | | | |
160
+ | [no-async-foreach](docs/rules/no-async-foreach.md) | Disallow async callbacks to Array.forEach | βœ… | | | | |
161
+ | [no-circular-references](docs/rules/no-circular-references.md) | Disallow circular references in objects | βœ… | | | | |
162
+ | [no-class-instance-destructuring](docs/rules/no-class-instance-destructuring.md) | Disallow destructuring of class instances to prevent loss of `this` context | βœ… | | πŸ”§ | | |
163
+ | [no-complex-cloud-params](docs/rules/no-complex-cloud-params.md) | Disallow passing complex objects to cloud functions | βœ… | | | | |
164
+ | [no-compositing-layer-props](docs/rules/no-compositing-layer-props.md) | Discourage CSS properties that force GPU compositing layers (e.g., transform, filter, will-change). Extra layers consume GPU memory and split rendering work, which slows scrolling and animation when sprinkled across a page. The rule inspects inline style objects and MUI sx props so layer promotion stays intentional rather than incidental. | βœ… | | | | |
165
+ | [no-conditional-literals-in-jsx](docs/rules/no-conditional-literals-in-jsx.md) | Disallow conditional string literals beside other JSX text to avoid fragmented text nodes, translation issues, and hydration mismatches. | βœ… | | | | |
166
+ | [no-console-error](docs/rules/no-console-error.md) | Disallow console.error so errors flow through structured handling (HttpsError/useErrorAlert on frontend, structured loggers on backend). | βœ… | | | | |
167
+ | [no-curly-brackets-around-commented-properties](docs/rules/no-curly-brackets-around-commented-properties.md) | Disallow curly-brace blocks that only wrap commented-out members inside type declarations | βœ… | | πŸ”§ | | |
168
+ | [no-direct-function-state](docs/rules/no-direct-function-state.md) | Prevent passing a function directly to a useState setter β€” React will invoke it as a functional updater instead of storing it. Wrap in a thunk: setState(() => fn). | βœ… | | πŸ”§ | | |
169
+ | [no-empty-dependency-use-callbacks](docs/rules/no-empty-dependency-use-callbacks.md) | Discourage useCallback([]) or useLatestCallback around static functions. Static callbacks do not need hook machineryβ€”extract them to module-level utilities for clarity and to avoid unnecessary hook overhead. | βœ… | | πŸ”§ | | |
170
+ | [no-entire-object-hook-deps](docs/rules/no-entire-object-hook-deps.md) | Avoid using entire objects in React hook dependency arrays. | βœ… | | πŸ”§ | | πŸ’­ |
171
+ | [no-excessive-parent-chain](docs/rules/no-excessive-parent-chain.md) | Discourage excessive use of the ref.parent property chain in Firestore and RealtimeDB change handlers | | | | πŸ’‘ | |
172
+ | [no-explicit-return-type](docs/rules/no-explicit-return-type.md) | Disallow explicit return type annotations on functions when TypeScript can infer them. This reduces code verbosity and maintenance burden while leveraging TypeScript's powerful type inference. Exceptions are made for type guard functions (using the `is` keyword), recursive functions, overloaded functions, interface methods, and abstract methods where explicit types improve clarity. | βœ… | | πŸ”§ | | |
173
+ | [no-fill-template-mutation](docs/rules/no-fill-template-mutation.md) | Disallow mutating the return value of fillTemplate() via string concatenation, template literals, or string method calls. The filled Algolia filter must be used verbatim so matchesTemplate() can regex-match it; post-fill modification silently breaks realtime hash parity. | βœ… | | | | |
174
+ | [no-filter-without-return](docs/rules/no-filter-without-return.md) | Disallow Array.filter callbacks without an explicit return (if part of a block statement) | βœ… | | | | |
175
+ | [no-firestore-jest-mock](docs/rules/no-firestore-jest-mock.md) | Prevent importing firestore-jest-mock in test files | βœ… | | πŸ”§ | | |
176
+ | [no-firestore-object-arrays](docs/rules/no-firestore-object-arrays.md) | Disallow arrays of object types in Firestore models. Prefer Record maps keyed by id with an index field, or subcollections/arrays of IDs. | βœ… | | | | |
177
+ | [no-handler-suffix](docs/rules/no-handler-suffix.md) | Disallow the generic "handler" suffix in callback names so names explain the action they perform | βœ… | | | | |
178
+ | [no-harness-coupled-disables](docs/rules/no-harness-coupled-disables.md) | Disallow eslint-disable justifications that reference the agent development harness (worktree, cwd, stop-hook, claude) instead of the code’s own semantics. | βœ… | | | | |
179
+ | [no-hungarian](docs/rules/no-hungarian.md) | Disallow Hungarian notation in locally declared variables, types, and classes | βœ… | | | | |
180
+ | [no-inline-component-prop](docs/rules/no-inline-component-prop.md) | Prevent inline function components defined in render from being passed to component-type props like CatalogWrapper to avoid remounts and UI flashes. | βœ… | | | | |
181
+ | [no-jsx-in-hooks](docs/rules/no-jsx-in-hooks.md) | Prevent hooks from returning JSX | βœ… | | | | |
182
+ | [no-jsx-whitespace-literal](docs/rules/no-jsx-whitespace-literal.md) | Disallow the use of {" "} elements in JSX code | βœ… | | | | |
183
+ | [no-margin-properties](docs/rules/no-margin-properties.md) | Prevent margin properties (margin, marginLeft, marginRight, marginTop, marginBottom, mx, my, etc.) in MUI styling because margins fight container-controlled spacing, double gutters, and misaligned breakpoints; keep spacing centralized with padding, gap, or spacing props instead. | βœ… | | | | |
184
+ | [no-memoize-on-static](docs/rules/no-memoize-on-static.md) | Prevent using @Memoize() decorator on static methods | βœ… | | | | |
185
+ | [no-misleading-boolean-prefixes](docs/rules/no-misleading-boolean-prefixes.md) | Reserve boolean-style prefixes (is/has/should) for functions that actually return boolean values to avoid misleading call sites. | βœ… | | | | |
186
+ | [no-misused-switch-case](docs/rules/no-misused-switch-case.md) | Prevent misuse of logical OR (\|\|) in switch case statements, which can lead to confusing and error-prone code. Instead of using OR operators in case expressions, use multiple case statements in sequence to handle multiple values. This improves code readability and follows the standard switch-case pattern. | βœ… | | | | |
187
+ | [no-mixed-firestore-transactions](docs/rules/no-mixed-firestore-transactions.md) | Prevent mixing transactional and non-transactional Firestore operations within a transaction | βœ… | | | | |
188
+ | [no-mock-firebase-admin](docs/rules/no-mock-firebase-admin.md) | Prevent direct mocking of firebaseAdmin; use shared test helpers instead | βœ… | | | | |
189
+ | [no-object-values-on-strings](docs/rules/no-object-values-on-strings.md) | Disallow Object.values() on strings as it treats strings as arrays of characters, which is likely unintended behavior. | βœ… | | | | |
190
+ | [no-overridable-method-calls-in-constructor](docs/rules/no-overridable-method-calls-in-constructor.md) | Disallow calling overridable methods in constructors to prevent unexpected behavior | βœ… | | | | |
191
+ | [no-passthrough-getters](docs/rules/no-passthrough-getters.md) | Avoid getter methods that only re-expose nested properties on constructor-injected objects without adding behavior | βœ… | | | | |
192
+ | [no-portal-inside-tooltip](docs/rules/no-portal-inside-tooltip.md) | Disallow portal-rendering components (Dialog, Drawer, Menu, Popover, Portal, Modal) inside Tooltip wrapper components. React Portals preserve React-tree event bubbling, so a portal nested under a Tooltip leaves the tooltip orphaned over the modal. | βœ… | | | | |
193
+ | [no-redundant-annotation-assertion](docs/rules/no-redundant-annotation-assertion.md) | Disallow combining a type annotation with an identical type assertion on the same value. Keep a single source of truth to avoid redundant type declarations that can drift apart. | βœ… | | πŸ”§ | | πŸ’­ |
194
+ | [no-redundant-boolean-callback-props](docs/rules/no-redundant-boolean-callback-props.md) | Disallow redundant boolean props that duplicate the semantic meaning of optional callback props, violating the Interface Segregation Principle. | βœ… | | | | |
195
+ | [no-redundant-param-types](docs/rules/no-redundant-param-types.md) | Disallow redundant parameter type annotations | βœ… | | πŸ”§ | | |
196
+ | [no-redundant-this-params](docs/rules/no-redundant-this-params.md) | Disallow passing class instance members (this.foo) into class instance methods; access the member from this inside the method instead. | βœ… | | | | |
197
+ | [no-redundant-usecallback-wrapper](docs/rules/no-redundant-usecallback-wrapper.md) | Prevent wrapping already memoized/stable callbacks from hooks/contexts in an extra useCallback() | βœ… | | πŸ”§ | | |
198
+ | [no-render-function-components](docs/rules/no-render-function-components.md) | Disallow declaring a local `render*` function that returns JSX and consuming it as a plain function (direct call or array-iteration callback); author it as a real component rendered with JSX instead | βœ… | | | | |
199
+ | [no-res-error-status-in-onrequest](docs/rules/no-res-error-status-in-onrequest.md) | Forbid sending 4xx/5xx Express responses inside onRequest handlers; throw structured HttpsError instances instead so the wrapper can format, log, and map errors consistently. | βœ… | | | | |
200
+ | [no-restricted-properties-fix](docs/rules/no-restricted-properties-fix.md) | Disallow certain properties on certain objects, with special handling for Object.keys() and Object.values() | | | | | |
201
+ | [no-satisfies-in-frontend-bundle](docs/rules/no-satisfies-in-frontend-bundle.md) | Disallow the `satisfies` operator in files that reach the frontend webpack bundle (Next.js 12 SWC cannot parse it) | βœ… | | | | |
202
+ | [no-separate-loading-state](docs/rules/no-separate-loading-state.md) | Disallow separate loading state variables that track the loading status of other state | βœ… | | | | |
203
+ | [no-single-dismiss-dialog-button](docs/rules/no-single-dismiss-dialog-button.md) | Disallow a single dialog button whose label is a dismiss action (Cancel, Close, Dismiss, Not now, Never mind). Use navigation.onClose for dismissal; the buttons array should only contain affirmative actions. | βœ… | | | | |
204
+ | [no-stablehash-react-nodes](docs/rules/no-stablehash-react-nodes.md) | Prevent passing ReactNodes or render-tree values to stableHash(), which deep-stringifies its argument and can freeze the browser. | βœ… | | | | |
205
+ | [no-stale-state-across-await](docs/rules/no-stale-state-across-await.md) | Prevent stale intermediate state by disallowing useState setter calls both before and after async boundaries (await, .then(), yield) within the same function | βœ… | | | | |
206
+ | [no-static-constants-in-dynamic-files](docs/rules/no-static-constants-in-dynamic-files.md) | Disallow exporting SCREAMING_SNAKE_CASE constants from .dynamic.ts/.dynamic.tsx files; move static constants to non-dynamic modules instead. | βœ… | | | | |
207
+ | [no-try-catch-already-exists-in-transaction](docs/rules/no-try-catch-already-exists-in-transaction.md) | Disallow catching ALREADY_EXISTS errors inside Firestore transaction callbacks | βœ… | | | | |
208
+ | [no-type-assertion-returns](docs/rules/no-type-assertion-returns.md) | Enforce typing variables before returning them, rather than using type assertions or explicit return types | βœ… | | | | |
209
+ | [no-undefined-null-passthrough](docs/rules/no-undefined-null-passthrough.md) | Avoid functions that return undefined or null when their single argument is undefined or null | βœ… | | | | |
210
+ | [no-unmemoized-memo-without-props](docs/rules/no-unmemoized-memo-without-props.md) | Prevent wrapping prop-less Unmemoized components in memo since memo provides no benefit without props and adds unnecessary indirection | βœ… | | | | |
211
+ | [no-unnecessary-destructuring](docs/rules/no-unnecessary-destructuring.md) | Avoid object patterns that only spread an existing object, since they clone the whole value without selecting properties | βœ… | | πŸ”§ | | |
212
+ | [no-unnecessary-destructuring-rename](docs/rules/no-unnecessary-destructuring-rename.md) | Disallow destructuring renames that are only used to assign back to the original property name | βœ… | | πŸ”§ | | |
213
+ | [no-unnecessary-verb-suffix](docs/rules/no-unnecessary-verb-suffix.md) | Prevent unnecessary verb suffixes in function and method names | βœ… | | πŸ”§ | | |
214
+ | [no-unpinned-dependencies](docs/rules/no-unpinned-dependencies.md) | Enforces pinned dependencies | βœ… | | πŸ”§ | | |
215
+ | [no-unsafe-firestore-spread](docs/rules/no-unsafe-firestore-spread.md) | Prevent unsafe object/array spreads in Firestore updates | βœ… | | | | |
216
+ | [no-unused-props](docs/rules/no-unused-props.md) | Detect unused props in React component type definitions | βœ… | | | | |
217
+ | [no-unused-usestate](docs/rules/no-unused-usestate.md) | Disallow unused useState hooks | βœ… | | πŸ”§ | | |
218
+ | [no-useless-fragment](docs/rules/no-useless-fragment.md) | Prevent unnecessary use of React fragments | βœ… | | πŸ”§ | | |
219
+ | [no-useless-usememo-primitives](docs/rules/no-useless-usememo-primitives.md) | Disallow useless useMemo with primitive values. | βœ… | | πŸ”§ | | |
220
+ | [no-usememo-for-pass-by-value](docs/rules/no-usememo-for-pass-by-value.md) | Disallow returning useMemo results from custom hooks when the memoized value is pass-by-value: primitives with value equality (string, number, boolean, null, undefined, bigint) or arrays/tuples composed exclusively of these primitives. Requires type information. | βœ… | | πŸ”§ | | πŸ’­ |
221
+ | [no-uuidv4-base62-as-key](docs/rules/no-uuidv4-base62-as-key.md) | Disallow using uuidv4Base62() to generate keys for elements in a list or loop | βœ… | | | | |
222
+ | [omit-index-html](docs/rules/omit-index-html.md) | Disallow the use of "index.html" in URLs | βœ… | | πŸ”§ | | |
223
+ | [optimize-object-boolean-conditions](docs/rules/optimize-object-boolean-conditions.md) | Detects and suggests optimizations for boolean conditions formed over objects in React hook dependencies. Suggests extracting boolean conditions into separate variables to reduce unnecessary re-computations when objects change frequently but the boolean condition changes less frequently. | βœ… | | | | |
224
+ | [parallelize-async-operations](docs/rules/parallelize-async-operations.md) | Enforce the use of Promise.all() when multiple independent asynchronous operations are awaited sequentially | βœ… | | πŸ”§ | | |
225
+ | [parallelize-loop-awaits](docs/rules/parallelize-loop-awaits.md) | Disallow sequential await expressions inside loops when iterations could be parallelized with Promise.all(items.map(...)) | βœ… | | | | |
226
+ | [prefer-batch-operations](docs/rules/prefer-batch-operations.md) | Enforce using setAll() and overwriteAll() instead of multiple set() or overwrite() calls | βœ… | | | | |
227
+ | [prefer-block-comments-for-declarations](docs/rules/prefer-block-comments-for-declarations.md) | Enforce the use of block comments for declarations | βœ… | | πŸ”§ | | |
228
+ | [prefer-clone-deep](docs/rules/prefer-clone-deep.md) | Prefer using cloneDeep over nested spread copying | βœ… | | πŸ”§ | | |
229
+ | [prefer-destructuring-no-class](docs/rules/prefer-destructuring-no-class.md) | Enforce destructuring when accessing object properties, except for class instances | βœ… | | πŸ”§ | | |
230
+ | [prefer-docsetter-setall](docs/rules/prefer-docsetter-setall.md) | Enforce batching DocSetter and DocSetterTransaction writes by using setAll instead of set inside loops or array callbacks. | βœ… | | | | |
231
+ | [prefer-document-flattening](docs/rules/prefer-document-flattening.md) | Enforce using the shouldFlatten option when setting deeply nested objects in Firestore documents | | | | πŸ’‘ | |
232
+ | [prefer-field-paths-in-transforms](docs/rules/prefer-field-paths-in-transforms.md) | Flatten aggregation updates inside transformEach so diff-based deletes remove only the intended fields instead of wiping sibling data. | βœ… | | | | |
233
+ | [prefer-flat-transform-each-keys](docs/rules/prefer-flat-transform-each-keys.md) | Warn when transformEach in a propagation strategy returns nested object values instead of flat dot-notation keys. | βœ… | | | | |
234
+ | [prefer-fragment-component](docs/rules/prefer-fragment-component.md) | Require the Fragment named import instead of shorthand fragments or React.Fragment to keep fragments explicit and prop-friendly | | βœ… | πŸ”§ | | |
235
+ | [prefer-fragment-shorthand](docs/rules/prefer-fragment-shorthand.md) | Prefer <> shorthand for <React.Fragment> | βœ… | | πŸ”§ | | |
236
+ | [prefer-getter-over-parameterless-method](docs/rules/prefer-getter-over-parameterless-method.md) | Enforce getter syntax for synchronous parameterless methods that return values, improving semantic clarity and avoiding accidental method invocation without parentheses. | βœ… | | πŸ”§ | | |
237
+ | [prefer-global-router-state-key](docs/rules/prefer-global-router-state-key.md) | Enforce using centralized router state key constants from queryKeys.ts for useRouterState key parameter | βœ… | | πŸ”§ | | |
238
+ | [prefer-map-over-conditional-dispatch](docs/rules/prefer-map-over-conditional-dispatch.md) | Prefer a Record<Discriminant, Value> lookup over switch/ternary/if-else dispatch on a literal-union discriminant where every branch returns or assigns a single value. | βœ… | | πŸ”§ | | πŸ’­ |
239
+ | [prefer-next-dynamic](docs/rules/prefer-next-dynamic.md) | Prefer Next.js dynamic() over custom useDynamic() for component imports | βœ… | | πŸ”§ | | |
240
+ | [prefer-nullish-coalescing-boolean-props](docs/rules/prefer-nullish-coalescing-boolean-props.md) | Prefer nullish coalescing over logical OR, but allow logical OR in boolean contexts | βœ… | | πŸ”§ | | |
241
+ | [prefer-params-over-parent-id](docs/rules/prefer-params-over-parent-id.md) | Prefer event.params over ref.parent.id for type-safe Firebase trigger paths. | βœ… | | πŸ”§ | | |
242
+ | [prefer-settings-object](docs/rules/prefer-settings-object.md) | Enforce using a settings object for functions with multiple parameters | βœ… | | | | |
243
+ | [prefer-spread-over-reassembly](docs/rules/prefer-spread-over-reassembly.md) | Prefer spread syntax over destructure-then-reassemble when all destructured fields are forwarded identically to a single target | βœ… | | πŸ”§ | | |
244
+ | [prefer-sx-prop-over-system-props](docs/rules/prefer-sx-prop-over-system-props.md) | Enforce using the MUI `sx` prop instead of deprecated system props (e.g. `mt`, `display`, `flexDirection`) on MUI components. | βœ… | | πŸ”§ | | |
245
+ | [prefer-type-alias-over-typeof-constant](docs/rules/prefer-type-alias-over-typeof-constant.md) | Prefer named type aliases over `typeof` on same-file global constants; ensure types are declared before constants. | βœ… | | | | |
246
+ | [prefer-type-over-interface](docs/rules/prefer-type-over-interface.md) | Prefer using type alias over interface | βœ… | | πŸ”§ | | |
247
+ | [prefer-union-from-const-array](docs/rules/prefer-union-from-const-array.md) | Derive string-literal union types from an `as const` array instead of declaring the union inline, so the runtime value set and the type share a single source of truth | βœ… | | πŸ”§ | | |
248
+ | [prefer-url-tostring-over-tojson](docs/rules/prefer-url-tostring-over-tojson.md) | Enforce the use of toString() over toJSON() on URL objects. | βœ… | | πŸ”§ | | |
249
+ | [prefer-use-base62-id](docs/rules/prefer-use-base62-id.md) | Prefer `useBase62Id()` over `uuidv4Base62()` inside useState/useRef/useMemo for stable component IDs to avoid SSR hydration mismatches | βœ… | | | | |
250
+ | [prefer-use-deep-compare-memo](docs/rules/prefer-use-deep-compare-memo.md) | Enforce using useDeepCompareMemo when dependency array contains non-primitive values (objects, arrays) that are not already memoized. This prevents unnecessary re-renders due to reference changes. | βœ… | | πŸ”§ | | |
251
+ | [prefer-use-theme](docs/rules/prefer-use-theme.md) | Enforce reading MUI theme values via useTheme() or the sx theme callback instead of importing theme constants directly from src/styles/* modules. | βœ… | | | | |
252
+ | [prefer-usecallback-over-usememo-for-functions](docs/rules/prefer-usecallback-over-usememo-for-functions.md) | Enforce using useCallback instead of useMemo for memoizing functions | βœ… | | πŸ”§ | | |
253
+ | [prefer-usememo-over-useeffect-usestate](docs/rules/prefer-usememo-over-useeffect-usestate.md) | Prefer useMemo over useEffect + useState for pure computations to avoid extra render cycles and stale derived state. | βœ… | | | | |
254
+ | [prefer-utility-function-over-private-static](docs/rules/prefer-utility-function-over-private-static.md) | Enforce abstraction of private static methods into utility functions | βœ… | | | | |
255
+ | [prefer-utility-function-own-file](docs/rules/prefer-utility-function-own-file.md) | Enforce that sizable utility functions live in their own file rather than being co-located inside an entry-point or consumer file | βœ… | | | | |
256
+ | [prevent-children-clobber](docs/rules/prevent-children-clobber.md) | Prevent JSX spreads from silently discarding props.children | βœ… | | | | |
257
+ | [react-memoize-literals](docs/rules/react-memoize-literals.md) | Detect object, array, and function literals created in React components or hooks that create new references every render. Prefer memoized values (useMemo/useCallback) or module-level constants to keep referential stability. | βœ… | | | πŸ’‘ | |
258
+ | [react-usememo-should-be-component](docs/rules/react-usememo-should-be-component.md) | Enforce that useMemo hooks explicitly returning JSX should be abstracted into separate React components | βœ… | | | | |
259
+ | [require-dynamic-firebase-imports](docs/rules/require-dynamic-firebase-imports.md) | Enforce dynamic imports for Firebase dependencies | βœ… | | πŸ”§ | | |
260
+ | [require-hooks-default-params](docs/rules/require-hooks-default-params.md) | Enforce React hooks with optional parameters to default to an empty object | βœ… | | πŸ”§ | | |
261
+ | [require-https-error](docs/rules/require-https-error.md) | Enforce using proprietary HttpsError instead of throw new Error or firebase-admin HttpsError in functions/src | βœ… | | | | |
262
+ | [require-https-error-cause](docs/rules/require-https-error-cause.md) | Ensure HttpsError calls inside catch blocks pass the caught error as the fourth "cause" argument to preserve stack traces for monitoring. | βœ… | | | | |
263
+ | [require-image-optimized](docs/rules/require-image-optimized.md) | Enforce using ImageOptimized component instead of next/image or img tags | βœ… | | πŸ”§ | | |
264
+ | [require-memo](docs/rules/require-memo.md) | React components must be memoized | βœ… | | πŸ”§ | | |
265
+ | [require-memoize-jsx-returners](docs/rules/require-memoize-jsx-returners.md) | Require @Memoize() decorator on instance members that return JSX or JSX factories | βœ… | | πŸ”§ | | |
266
+ | [require-migration-script-metadata](docs/rules/require-migration-script-metadata.md) | Enforce JSDoc migration metadata in callable scripts | βœ… | | | | |
267
+ | [require-props-composition](docs/rules/require-props-composition.md) | Require React component Props types to compose (via Pick/Omit) with the props types of non-leaf child components rendered in JSX | βœ… | | | | |
268
+ | [require-server-timestamp-for-firestore-dates](docs/rules/require-server-timestamp-for-firestore-dates.md) | Enforce serverTimestamp() instead of new Date() for Firestore timestamp fields | βœ… | | | | |
269
+ | [semantic-function-prefixes](docs/rules/semantic-function-prefixes.md) | Require semantic function prefixes instead of generic verbs so callers know whether a function fetches data, transforms input, or mutates state | βœ… | | | | |
270
+ | [sync-onwrite-name-func](docs/rules/sync-onwrite-name-func.md) | Ensure that the name field matches the func field in onWrite handlers | βœ… | | πŸ”§ | | |
271
+ | [test-file-location-enforcement](docs/rules/test-file-location-enforcement.md) | Enforce colocating *.test.ts or *.test.tsx files with the code they cover. | βœ… | | | | |
272
+ | [use-custom-link](docs/rules/use-custom-link.md) | Enforce using src/components/Link instead of next/link | βœ… | | πŸ”§ | | |
273
+ | [use-custom-memo](docs/rules/use-custom-memo.md) | Enforce using src/util/memo instead of React memo | βœ… | | πŸ”§ | | |
274
+ | [use-custom-router](docs/rules/use-custom-router.md) | Enforce using src/hooks/routing/useRouter instead of next/router | βœ… | | πŸ”§ | | |
275
+ | [use-latest-callback](docs/rules/use-latest-callback.md) | Enforce using useLatestCallback from use-latest-callback instead of React useCallback | βœ… | | πŸ”§ | | |
276
+ | [vertically-group-related-functions](docs/rules/vertically-group-related-functions.md) | Keep top-level functions grouped vertically so callers, exports, and helpers read top-down. | βœ… | | πŸ”§ | | |
277
+ | [warn-https-error-message-user-friendly](docs/rules/warn-https-error-message-user-friendly.md) | Warn when messageUserFriendly is used in HttpsError or toHttpsError to ensure it is truly a user-caused error. | βœ… | | | | |
279
278
 
280
279
  <!-- end auto-generated rules list -->
281
280