eslint-plugin-typefest 1.0.9 → 1.2.0

package/docs/rules/prefer-ts-extras-array-find-last-index.md

@@ -1,108 +0,0 @@
-# prefer-ts-extras-array-find-last-index
-
-Prefer [`arrayFindLastIndex`](https://github.com/sindresorhus/ts-extras/blob/main/source/array-find-last-index.ts) from `ts-extras` over `array.findLastIndex(...)`.
-
-`arrayFindLastIndex(...)` improves predicate inference in typed arrays.
-
-## Targeted pattern scope
-
-This rule focuses on direct `array.findLastIndex(predicate)` calls that can be migrated to `arrayFindLastIndex(array, predicate)` with deterministic fixes.
-
-- `array.findLastIndex(predicate)` call sites that can use `arrayFindLastIndex(array, predicate)`.
-
-Alias indirection, wrapper helpers, and non-canonical call shapes are excluded to keep `arrayFindLastIndex(array, predicate)` migrations safe.
-
-## What this rule reports
-
-This rule reports `array.findLastIndex(predicate)` call sites when `arrayFindLastIndex(array, predicate)` is the intended replacement.
-
-- `array.findLastIndex(predicate)` call sites that can use `arrayFindLastIndex(array, predicate)`.
-
-## Why this rule exists
-
-`arrayFindLastIndex` standardizes reverse index lookup and keeps call signatures aligned with other `ts-extras` search helpers.
-
-- Reverse index scans are explicit at the call site.
-- Search code avoids mixed native/helper patterns.
-- Index-based follow-up logic stays uniform across modules.
-
-## ❌ Incorrect
-
-```ts
-const index = monitors.findLastIndex((entry) => entry.id === targetId);
-```
-
-## ✅ Correct
-
-```ts
-const index = arrayFindLastIndex(monitors, (entry) => entry.id === targetId);
-```
-
-## Behavior and migration notes
-
-- Runtime behavior matches native `Array.prototype.findLastIndex`.
-- Search still proceeds from right to left.
-- If no element matches, the result is `-1`.
-
-## Additional examples
-
-### ❌ Incorrect — Additional example
-
-```ts
-const index = logs.findLastIndex((entry) => entry.level === "warn");
-```
-
-### ✅ Correct — Additional example
-
-```ts
-const index = arrayFindLastIndex(logs, (entry) => entry.level === "warn");
-```
-
-### ✅ Correct — Repository-wide usage
-
-```ts
-const retryIndex = arrayFindLastIndex(attempts, (attempt) => !attempt.success);
-```
-
-## ESLint flat config example
-
-```ts
-import typefest from "eslint-plugin-typefest";
-
-export default [
-    {
-        plugins: { typefest },
-        rules: {
-            "typefest/prefer-ts-extras-array-find-last-index": "error",
-        },
-    },
-];
-```
-
-## When not to use it
-
-Disable this rule if your codebase has standardized on native `.findLastIndex()`.
-
-## Package documentation
-
-ts-extras package documentation:
-
-`ts-extras@0.17.x` does not currently expose `arrayFindLastIndex` in its published API, so there is no canonical `source/*.ts` link for this helper yet.
-
-Reference links:
-
-- [`ts-extras` API list (README)](https://github.com/sindresorhus/ts-extras/blob/main/readme.md#api)
-- [`ts-extras` source directory](https://github.com/sindresorhus/ts-extras/tree/main/source)
-
-> **Rule catalog ID:** R005
-
-## Further reading
-
-- [`ts-extras` README](https://github.com/sindresorhus/ts-extras)
-- [`ts-extras` package reference](https://www.npmjs.com/package/ts-extras)
-- [TypeScript Handbook: Narrowing](https://www.typescriptlang.org/docs/handbook/2/narrowing.html)
-
-## Adoption resources
-
-- [Rule adoption checklist](./guides/adoption-checklist.md)
-- [Rollout and fix safety](./guides/rollout-and-fix-safety.md)

package/docs/rules/prefer-ts-extras-array-find-last.md

@@ -1,108 +0,0 @@
-# prefer-ts-extras-array-find-last
-
-Prefer [`arrayFindLast`](https://github.com/sindresorhus/ts-extras/blob/main/source/array-find-last.ts) from `ts-extras` over `array.findLast(...)`.
-
-`arrayFindLast(...)` improves predicate inference and value narrowing in typed arrays.
-
-## Targeted pattern scope
-
-This rule focuses on direct `array.findLast(predicate)` calls that can be migrated to `arrayFindLast(array, predicate)` with deterministic fixes.
-
-- `array.findLast(predicate)` call sites that can use `arrayFindLast(array, predicate)`.
-
-Alias indirection, wrapper helpers, and non-canonical call shapes are excluded to keep `arrayFindLast(array, predicate)` migrations safe.
-
-## What this rule reports
-
-This rule reports `array.findLast(predicate)` call sites when `arrayFindLast(array, predicate)` is the intended replacement.
-
-- `array.findLast(predicate)` call sites that can use `arrayFindLast(array, predicate)`.
-
-## Why this rule exists
-
-`arrayFindLast` makes reverse-direction predicate lookups explicit and keeps them aligned with the `ts-extras` helper style.
-
-- Reverse scans are easier to spot during code review.
-- Call signatures stay consistent with `arrayFind` / `arrayFindLastIndex`.
-- Utility code that depends on "latest match" is easier to audit.
-
-## ❌ Incorrect
-
-```ts
-const monitor = monitors.findLast((entry) => entry.id === targetId);
-```
-
-## ✅ Correct
-
-```ts
-const monitor = arrayFindLast(monitors, (entry) => entry.id === targetId);
-```
-
-## Behavior and migration notes
-
-- Runtime behavior matches native `Array.prototype.findLast`.
-- Search direction remains right-to-left.
-- Result is the matching element, or `undefined` if no match exists.
-
-## Additional examples
-
-### ❌ Incorrect — Additional example
-
-```ts
-const latest = events.findLast((entry) => entry.type === "login");
-```
-
-### ✅ Correct — Additional example
-
-```ts
-const latest = arrayFindLast(events, (entry) => entry.type === "login");
-```
-
-### ✅ Correct — Repository-wide usage
-
-```ts
-const trailingError = arrayFindLast(logs, (entry) => entry.level === "error");
-```
-
-## ESLint flat config example
-
-```ts
-import typefest from "eslint-plugin-typefest";
-
-export default [
-    {
-        plugins: { typefest },
-        rules: {
-            "typefest/prefer-ts-extras-array-find-last": "error",
-        },
-    },
-];
-```
-
-## When not to use it
-
-Disable this rule if your team intentionally uses native `.findLast()` everywhere.
-
-## Package documentation
-
-ts-extras package documentation:
-
-`ts-extras@0.17.x` does not currently expose `arrayFindLast` in its published API, so there is no canonical `source/*.ts` link for this helper yet.
-
-Reference links:
-
-- [`ts-extras` API list (README)](https://github.com/sindresorhus/ts-extras/blob/main/readme.md#api)
-- [`ts-extras` source directory](https://github.com/sindresorhus/ts-extras/tree/main/source)
-
-> **Rule catalog ID:** R004
-
-## Further reading
-
-- [`ts-extras` README](https://github.com/sindresorhus/ts-extras)
-- [`ts-extras` package reference](https://www.npmjs.com/package/ts-extras)
-- [TypeScript Handbook: Narrowing](https://www.typescriptlang.org/docs/handbook/2/narrowing.html)
-
-## Adoption resources
-
-- [Rule adoption checklist](./guides/adoption-checklist.md)
-- [Rollout and fix safety](./guides/rollout-and-fix-safety.md)

package/docs/rules/prefer-ts-extras-array-find.md

@@ -1,108 +0,0 @@
-# prefer-ts-extras-array-find
-
-Prefer [`arrayFind`](https://github.com/sindresorhus/ts-extras/blob/main/source/array-find.ts) from `ts-extras` over `array.find(...)`.
-
-`arrayFind(...)` improves predicate inference and value narrowing in typed arrays.
-
-## Targeted pattern scope
-
-This rule focuses on direct `array.find(predicate)` calls that can be migrated to `arrayFind(array, predicate)` with deterministic fixes.
-
-- `array.find(predicate)` call sites that can use `arrayFind(array, predicate)`.
-
-Alias indirection, wrapper helpers, and non-canonical call shapes are excluded to keep `arrayFind(array, predicate)` migrations safe.
-
-## What this rule reports
-
-This rule reports `array.find(predicate)` call sites when `arrayFind(array, predicate)` is the intended replacement.
-
-- `array.find(predicate)` call sites that can use `arrayFind(array, predicate)`.
-
-## Why this rule exists
-
-`arrayFind` keeps predicate-driven lookup aligned with the other `ts-extras` helper APIs and improves inference in generic code.
-
-- Predicate call sites are standardized across modules.
-- Result types are easier to follow in utility layers.
-- Local type assertions after `find` calls are reduced.
-
-## ❌ Incorrect
-
-```ts
-const monitor = monitors.find((entry) => entry.id === targetId);
-```
-
-## ✅ Correct
-
-```ts
-const monitor = arrayFind(monitors, (entry) => entry.id === targetId);
-```
-
-## Behavior and migration notes
-
-- Runtime behavior matches native `Array.prototype.find`.
-- Search still returns the first matching element.
-- If no element matches, the result is `undefined`.
-
-## Additional examples
-
-### ❌ Incorrect — Additional example
-
-```ts
-const user = users.find((item) => item.id === userId);
-```
-
-### ✅ Correct — Additional example
-
-```ts
-const user = arrayFind(users, (item) => item.id === userId);
-```
-
-### ✅ Correct — Repository-wide usage
-
-```ts
-const firstError = arrayFind(logs, (entry) => entry.level === "error");
-```
-
-## ESLint flat config example
-
-```ts
-import typefest from "eslint-plugin-typefest";
-
-export default [
-    {
-        plugins: { typefest },
-        rules: {
-            "typefest/prefer-ts-extras-array-find": "error",
-        },
-    },
-];
-```
-
-## When not to use it
-
-Disable this rule if your team requires native `.find()` for consistency with existing shared APIs.
-
-## Package documentation
-
-ts-extras package documentation:
-
-`ts-extras@0.17.x` does not currently expose `arrayFind` in its published API, so there is no canonical `source/*.ts` link for this helper yet.
-
-Reference links:
-
-- [`ts-extras` API list (README)](https://github.com/sindresorhus/ts-extras/blob/main/readme.md#api)
-- [`ts-extras` source directory](https://github.com/sindresorhus/ts-extras/tree/main/source)
-
-> **Rule catalog ID:** R003
-
-## Further reading
-
-- [`ts-extras` README](https://github.com/sindresorhus/ts-extras)
-- [`ts-extras` package reference](https://www.npmjs.com/package/ts-extras)
-- [TypeScript Handbook: Narrowing](https://www.typescriptlang.org/docs/handbook/2/narrowing.html)
-
-## Adoption resources
-
-- [Rule adoption checklist](./guides/adoption-checklist.md)
-- [Rollout and fix safety](./guides/rollout-and-fix-safety.md)