@williamthorsen/toolbelt.arrays 5.0.0 → 6.0.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file.
 
+## 6.0.0 — 2026-08-21
+
+### Features
+
+- 🚨 **Breaking:** Correct the nullish guards' narrowing and rename `isNullable` (#206)
+
+  Fixes an issue where `isNullable` in `@williamthorsen/toolbelt.guards` narrowed both of its branches backwards: A value it confirmed to be null or undefined was typed as non-nullish, so dereferencing it inside the check compiled and then threw. It is now named `isNullish`, after the type it narrows to.
+
+  Separately, `isNonNullable` and `assertIsNonNullable` let an explicit type argument exclude `null` from the false branch while `null` still reached it at runtime. Both now take the value at its own type.
+
+  Migration: `isNullable` no longer exists, and `isNullish` narrows in the opposite direction, so a call site written against the old behavior now fails to compile. On `isNonNullable` and `assertIsNonNullable`, an explicit type argument narrower than the value's own type is now a compile error; inference-driven narrowing is unchanged, as is `filter(isNonNullable)`.
+
+## 5.0.1 — 2026-08-16
+
+### Tests
+
+- Drop expect-type in favor of expectTypeOf (#175)
+
+  Replaces all imports of `expectTypeOf` from `expect-type` with the same import from `vitest`. Previously there had been imports from both libraries. `expect-type` is removed as a dependency.
+
 ## 5.0.0 — 2026-08-15
 
 ### Features

package/README.md

@@ -3,23 +3,17 @@
 Array utilities.
 
 <!-- section:release-notes -->
-## Release notes — v5.0.0 (2026-08-15)
+## Release notes — v6.0.0 (2026-08-21)
 
 ### Features
 
-- 🚨 **Breaking:** Fix unsound narrowing in `getAtIndexOrThrow` and rename it to `getItemAtIndexOrThrow` (#152)
+- 🚨 **Breaking:** Correct the nullish guards' narrowing and rename `isNullable` (#206)
 
-  Fixes an issue where `getAtIndexOrThrow` could falsely treat an `undefined` return value as satisfying a return type that excluded `undefined`. The function now throws a `RangeError` if the array holds no item at the index and a `TypeError` if the index is not a safe integer. `undefined` is a valid return value if the input array's type allows `undefined` elements. The function is renamed `getItemAtIndexOrThrow`.
+  Fixes an issue where `isNullable` in `@williamthorsen/toolbelt.guards` narrowed both of its branches backwards: A value it confirmed to be null or undefined was typed as non-nullish, so dereferencing it inside the check compiled and then threw. It is now named `isNullish`, after the type it narrows to.
 
-  Separately, `findOrThrow` now decides a match by its predicate rather than by the value it found, so an element is not treated as not found merely because it is falsy. Its return type is now `T` rather than `NonNullable<T>`.
+  Separately, `isNonNullable` and `assertIsNonNullable` let an explicit type argument exclude `null` from the false branch while `null` still reached it at runtime. Both now take the value at its own type.
 
-  Migration: Consumers of `@williamthorsen/toolbelt.arrays/candidate` import `getItemAtIndexOrThrow` in place of `getAtIndexOrThrow`.
-
-- 🚨 **Breaking:** Rename `findOrThrow` to `findItemOrThrow` and document it (#153)
-
-  Renames `findOrThrow` to `findItemOrThrow` in `@williamthorsen/toolbelt.arrays` for consistency with repo naming conventions.
-
-  Migration: Consumers import `findItemOrThrow` from `@williamthorsen/toolbelt.arrays/candidate`. The signature and behavior are unchanged.
+  Migration: `isNullable` no longer exists, and `isNullish` narrows in the opposite direction, so a call site written against the old behavior now fails to compile. On `isNonNullable` and `assertIsNonNullable`, an explicit type argument narrower than the value's own type is now a compile error; inference-driven narrowing is unchanged, as is `filter(isNonNullable)`.
 <!-- /section:release-notes -->
 
 ## Installation

package/dist/esm/3-candidate/nullishCompare.js

@@ -1,3 +1,4 @@
+import { isNullish } from '@williamthorsen/toolbelt.guards';
 export function makeNullishCompare(compare, options = {}) {
     return function compareWithNullishHandling(a, b) {
         return nullishCompare(compare, a, b, options);
@@ -15,6 +16,3 @@ export function nullishCompare(compare, a, b, options = {}) {
     }
     return compare(a, b) || 0;
 }
-function isNullish(value) {
-    return value === null || value === undefined;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/toolbelt.arrays",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "Array utilities",
   "keywords": [
     "array",
@@ -44,8 +44,8 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@williamthorsen/toolbelt.numbers": "6.0.1",
-    "@williamthorsen/toolbelt.guards": "3.1.10"
+    "@williamthorsen/toolbelt.guards": "4.0.0",
+    "@williamthorsen/toolbelt.numbers": "7.0.0"
   },
   "engines": {
     "node": ">=24.0.0"