@kensio/smartass 1.15.0 → 1.17.0

package/README.md

@@ -82,6 +82,7 @@ structure.
 - [assertFalse](src/assert/false/false.assert.ts)
 - [assertIdentical](src/assert/identical/identical.assert.ts)
 - [assertInstanceOf](src/assert/instance-of/instance-of.assert.ts)
+- [assertMapSize](src/assert/map-size/map-size.assert.ts)
 - [assertNonNullable](src/assert/non-nullable/non-nullable.assert.ts)
 - [assertNumberBetween](src/assert/number-between/number-between.assert.ts)
 - [assertNumberToNearest](src/assert/number-to-nearest/number-to-nearest.assert.ts)
@@ -122,6 +123,7 @@ structure.
 - [nonEmptyArray](src/assert/array-not-empty/array-not-empty.match.ts)
 - [bufferEqualTo](src/assert/buffer-equal/buffer-equal.match.ts)
 - [instanceOf](src/assert/instance-of/instance-of.match.ts)
+- [mapOfSize](src/assert/map-size/map-size.match.ts)
 - [nonNullable](src/assert/non-nullable/non-nullable.match.ts)
 - [numberBetween](src/assert/number-between/number-between.match.ts)
 - [numberToNearest](src/assert/number-to-nearest/number-to-nearest.match.ts)

package/dist/assert/array-includes/array-includes.assert.d.ts

@@ -1,9 +1,4 @@
-import { type ArrayIncluding } from "./array-includes.match.js";
-/**
- * Assert that an array includes a specific element, with type narrowing.
- * Note that this is an identity match, so objects in an array only fulfill the
- * assertion by being a reference to the same object, rather than equivalent in
- * value to another object reference.
- */
-export declare function assertArrayIncludes<T, const E extends T>(value: readonly T[], element: E, message?: string): asserts value is ArrayIncluding<T, E>;
+import type { ArrayIncluding } from "./array-includes.type.js";
+export declare function assertArrayIncludes<TArray extends unknown[], const E extends TArray[number]>(value: TArray, element: E, message?: string): asserts value is TArray & ArrayIncluding<TArray[number]>;
+export declare function assertArrayIncludes<const E>(value: unknown, element: E, message?: string): asserts value is ArrayIncluding<E>;
 //# sourceMappingURL=array-includes.assert.d.ts.map

package/dist/assert/array-includes/array-includes.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAIhF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,EACtD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAUvC"}
+{"version":3,"file":"array-includes.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.assert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,wBAAgB,mBAAmB,CACjC,MAAM,SAAS,OAAO,EAAE,EACxB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAE9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5D,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,EACzC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC"}

package/dist/assert/array-includes/array-includes.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes.assert.js","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAmB,EACnB,OAAU,EACV,OAAgB;IAEhB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,mBAAmB,EACxE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"array-includes.assert.js","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAkBlD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,OAAgB,EAChB,OAAgB;IAEhB,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,mBAAmB,EACxE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/array-includes/array-includes.match.d.ts

@@ -1,9 +1,4 @@
-import { type AssertionMatcher } from "../../match/match.js";
-export type ArrayIncluding<T, E extends T> = Omit<readonly [T, ...T[]], "includes"> & {
-    includes(searchElement: E, fromIndex?: number): true;
-    includes(searchElement: T, fromIndex?: number): boolean;
-};
-export type ArrayIncludingMatcher<E> = AssertionMatcher<ArrayIncluding<unknown, E>>;
+import { type ArrayIncludingMatcher } from "./array-includes.type.js";
 /**
  * Matcher for an array including a specific single element.
  */

package/dist/assert/array-includes/array-includes.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,IAAI,CAC/C,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EACpB,UAAU,CACX,GAAG;IACF,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,gBAAgB,CACrD,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAC3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAO5E"}
+{"version":3,"file":"array-includes.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.match.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAY5E"}

package/dist/assert/array-includes/array-includes.match.js

@@ -1,9 +1,15 @@
 import { createMatcher } from "../../match/match.js";
 import { desc, repr } from "../../describe/describe.js";
+import { arrayIncludingMatcher, } from "./array-includes.type.js";
 /**
  * Matcher for an array including a specific single element.
  */
 export function arrayIncluding(element) {
-    return createMatcher((value) => Array.isArray(value) && value.includes(element), () => `array including ${desc(element)}`, () => `[…,${repr(element)},…]`);
+    return {
+        ...createMatcher((value) => Array.isArray(value) && value.includes(element), () => `array including ${desc(element)}`, () => `[…,${repr(element)},…]`),
+        // Runtime marker used only to make the matcher type nominal for type-level
+        // refinement dispatch. It is not part of the user-facing matcher behaviour.
+        [arrayIncludingMatcher]: element,
+    };
 }
 //# sourceMappingURL=array-includes.match.js.map

package/dist/assert/array-includes/array-includes.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes.match.js","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAcxD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAU,OAAU;IAChD,OAAO,aAAa,CAClB,CAAC,KAAK,EAAuC,EAAE,CAC7C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EACjD,GAAG,EAAE,CAAC,mBAAmB,IAAI,CAAC,OAAO,CAAC,EAAE,EACxC,GAAG,EAAE,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAC/B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"array-includes.match.js","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EACL,qBAAqB,GAGtB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAU,OAAU;IAChD,OAAO;QACL,GAAG,aAAa,CACd,CAAC,KAAK,EAA8B,EAAE,CACpC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EACjD,GAAG,EAAE,CAAC,mBAAmB,IAAI,CAAC,OAAO,CAAC,EAAE,EACxC,GAAG,EAAE,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAC/B;QACD,2EAA2E;QAC3E,4EAA4E;QAC5E,CAAC,qBAAqB,CAAC,EAAE,OAAO;KACjC,CAAC;AACJ,CAAC"}

package/dist/assert/array-includes/array-includes.type.d.ts

@@ -0,0 +1,44 @@
+import type { AssertionMatcher, refinement } from "../../match/match.js";
+/**
+ * Unique symbol to reliably identify the ArrayIncludingMatcher type.
+ *
+ * TypeScript is structurally typed, so matcher types with similar predicates
+ * can otherwise accidentally satisfy each other's conditional branches.
+ */
+export declare const arrayIncludingMatcher: unique symbol;
+type ArrayElement<T> = T extends readonly (infer TElement)[] ? TElement : unknown;
+type MatchingArrayElement<TActualElement, TElement> = [
+    Extract<TActualElement, TElement>
+] extends [never] ? TElement : Extract<TActualElement, TElement>;
+export type ArrayIncluding<T> = [T, ...unknown[]];
+/**
+ * Type produced when an actual value is matched by arrayIncluding().
+ *
+ * The leading tuple element is a type-level witness that the array includes the
+ * required value. It does not claim the value is at runtime index 0. This is a
+ * deliberate tradeoff: TypeScript cannot cleanly express "appears somewhere in
+ * the array", and this witness shape keeps user-facing types readable.
+ *
+ * When the calling scope already knows the actual value is an array, we
+ * preserve its element type for the rest of the tuple. Otherwise, the rest is
+ * unknown[].
+ */
+export type ArrayIncludingMatch<TActual, TElement> = [
+    Extract<NonNullable<TActual>, readonly unknown[]>
+] extends [never] ? [TElement, ...unknown[]] : [
+    MatchingArrayElement<ArrayElement<Extract<NonNullable<TActual>, readonly unknown[]>>, TElement>,
+    ...ArrayElement<Extract<NonNullable<TActual>, readonly unknown[]>>[]
+];
+export type ArrayIncludingMatcher<T = unknown> = AssertionMatcher<ArrayIncluding<T>> & {
+    readonly [arrayIncludingMatcher]: T;
+    /**
+     * Optional type-level hook used by compositional assertions such as
+     * assertObjectMatches().
+     *
+     * This lets the matcher describe how it refines an existing actual type,
+     * rather than only exposing the standalone matches() predicate type.
+     */
+    readonly [refinement]?: <TActual>(actual: TActual) => ArrayIncludingMatch<TActual, T>;
+};
+export {};
+//# sourceMappingURL=array-includes.type.d.ts.map

package/dist/assert/array-includes/array-includes.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-includes.type.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,eAA2C,CAAC;AAE9E,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,QAAQ,CAAC,EAAE,GACxD,QAAQ,GACR,OAAO,CAAC;AAEZ,KAAK,oBAAoB,CAAC,cAAc,EAAE,QAAQ,IAAI;IACpD,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC;CAClC,SAAS,CAAC,KAAK,CAAC,GACb,QAAQ,GACR,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAEtC,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,CAAC,OAAO,EAAE,QAAQ,IAAI;IACnD,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAClD,SAAS,CAAC,KAAK,CAAC,GACb,CAAC,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC,GACxB;IACE,oBAAoB,CAClB,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,EAC/D,QAAQ,CACT;IACD,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,EAAE;CACrE,CAAC;AAEN,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAC/D,cAAc,CAAC,CAAC,CAAC,CAClB,GAAG;IACF,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,OAAO,EAC9B,MAAM,EAAE,OAAO,KACZ,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CACtC,CAAC"}

package/dist/assert/array-includes/array-includes.type.js

@@ -0,0 +1,8 @@
+/**
+ * Unique symbol to reliably identify the ArrayIncludingMatcher type.
+ *
+ * TypeScript is structurally typed, so matcher types with similar predicates
+ * can otherwise accidentally satisfy each other's conditional branches.
+ */
+export const arrayIncludingMatcher = Symbol("smartass.arrayIncludingMatcher");
+//# sourceMappingURL=array-includes.type.js.map

package/dist/assert/array-includes/array-includes.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-includes.type.js","sourceRoot":"","sources":["../../../src/assert/array-includes/array-includes.type.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,gCAAgC,CAAC,CAAC"}

package/dist/assert/array-includes-all/array-includes-all.assert.d.ts

@@ -1,8 +1,4 @@
-import { type ArrayIncludingAll } from "./array-includes-all.match.js";
-/**
- * Assert that an array includes all specified elements, with type narrowing.
- * Elements can appear in any order and do not need to be contiguous.
- * Each required element must be present at least once.
- */
-export declare function assertArrayIncludesAll<T, const E extends readonly T[]>(value: readonly T[], elements: E, message?: string): asserts value is ArrayIncludingAll<T, E>;
+import type { ArrayElement, ArrayIncludingAll, ArrayIncludingAllElement } from "./array-includes-all.type.js";
+export declare function assertArrayIncludesAll<TArray extends unknown[], const E extends readonly ArrayElement<TArray>[]>(value: TArray, elements: E, message?: string): asserts value is TArray & ArrayIncludingAll<ArrayElement<TArray>, E["length"]>;
+export declare function assertArrayIncludesAll<const E extends readonly unknown[]>(value: unknown, elements: E, message?: string): asserts value is ArrayIncludingAll<ArrayIncludingAllElement<E>, E["length"]>;
 //# sourceMappingURL=array-includes-all.assert.d.ts.map

package/dist/assert/array-includes-all/array-includes-all.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes-all.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAIvC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,EACpE,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAW1C"}
+{"version":3,"file":"array-includes-all.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.assert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,sBAAsB,CACpC,MAAM,SAAS,OAAO,EAAE,EACxB,KAAK,CAAC,CAAC,SAAS,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,EAE/C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,GACxB,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvD,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EACvE,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/assert/array-includes-all/array-includes-all.assert.js

@@ -1,17 +1,39 @@
-import { arrayIncludingAll, } from "./array-includes-all.match.js";
+import { arrayIncludingAll } from "./array-includes-all.match.js";
 import { AssertionError } from "../../assertion-error.js";
 import { desc, repr } from "../../describe/describe.js";
 /**
  * Assert that an array includes all specified elements, with type narrowing.
  * Elements can appear in any order and do not need to be contiguous.
- * Each required element must be present at least once.
+ * Repeated required elements must appear at least that many times.
  */
 export function assertArrayIncludesAll(value, elements, message) {
     const matcher = arrayIncludingAll(elements);
     if (!matcher.matches(value)) {
-        const missing = elements.filter((element) => !value.includes(element));
-        throw new AssertionError(message ??
-            `Expected ${desc(value)} to include all of ${repr(elements)}, but missing ${repr(missing)}.`, value, matcher.represent());
+        throw new AssertionError(message ?? buildArrayIncludesAllMessage(value, elements), value, matcher.represent());
     }
 }
+function buildArrayIncludesAllMessage(value, elements) {
+    if (!Array.isArray(value)) {
+        return `Expected ${desc(value)} to be array including all of ${desc(elements)}.`;
+    }
+    const missing = findMissingElements(value, elements);
+    return `Expected ${desc(value)} to include all of ${repr(elements)}, but missing ${repr(missing)}.`;
+}
+function findMissingElements(value, elements) {
+    const remaining = [...value];
+    const missing = [];
+    for (const element of elements) {
+        const index = remaining.findIndex((candidate) => sameValueZero(candidate, element));
+        if (index === -1) {
+            missing.push(element);
+        }
+        else {
+            remaining.splice(index, 1);
+        }
+    }
+    return missing;
+}
+function sameValueZero(left, right) {
+    return left === right || (Number.isNaN(left) && Number.isNaN(right));
+}
 //# sourceMappingURL=array-includes-all.assert.js.map

package/dist/assert/array-includes-all/array-includes-all.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes-all.assert.js","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAmB,EACnB,QAAW,EACX,OAAgB;IAEhB,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,GAAG,EAC9F,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"array-includes-all.assert.js","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAuBxD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,QAA4B,EAC5B,OAAgB;IAEhB,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,4BAA4B,CAAC,KAAK,EAAE,QAAQ,CAAC,EACxD,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CACnC,KAAc,EACd,QAA4B;IAE5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;IACnF,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAErD,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,sBAAsB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;AACtG,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAyB,EACzB,QAA4B;IAE5B,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAc,EAAE,CAAC;IAE9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAC9C,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAClC,CAAC;QAEF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,IAAa,EAAE,KAAc;IAClD,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/assert/array-includes-all/array-includes-all.match.d.ts

@@ -1,13 +1,8 @@
-import { type AssertionMatcher } from "../../match/match.js";
-export type ArrayIncludingAll<T, E extends readonly T[]> = Omit<readonly [T, ...T[]], "includes"> & {
-    includes(searchElement: E[number], fromIndex?: number): true;
-    includes(searchElement: T, fromIndex?: number): boolean;
-};
-export type ArrayIncludingAllMatcher<E extends readonly unknown[]> = AssertionMatcher<ArrayIncludingAll<unknown, E>>;
+import type { ArrayIncludingAllElement, ArrayIncludingAllMatcher } from "./array-includes-all.type.js";
 /**
  * Matcher for an array including all specified elements.
  * Elements can appear in any order and do not need to be contiguous.
- * Each required element must be present at least once.
+ * Repeated required elements must appear at least that many times.
  */
-export declare function arrayIncludingAll<const E extends readonly unknown[]>(elements: E): ArrayIncludingAllMatcher<E>;
+export declare function arrayIncludingAll<const E extends readonly unknown[]>(elements: E): ArrayIncludingAllMatcher<ArrayIncludingAllElement<E>, E["length"]>;
 //# sourceMappingURL=array-includes-all.match.d.ts.map

package/dist/assert/array-includes-all/array-includes-all.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes-all.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,CAAC,EAAE,IAAI,IAAI,CAC7D,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EACpB,UAAU,CACX,GAAG;IACF,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAC/D,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAClE,QAAQ,EAAE,CAAC,GACV,wBAAwB,CAAC,CAAC,CAAC,CAQ7B"}
+{"version":3,"file":"array-includes-all.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.match.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAClE,QAAQ,EAAE,CAAC,GACV,wBAAwB,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CASpE"}

package/dist/assert/array-includes-all/array-includes-all.match.js

@@ -3,11 +3,24 @@ import { desc, repr } from "../../describe/describe.js";
 /**
  * Matcher for an array including all specified elements.
  * Elements can appear in any order and do not need to be contiguous.
- * Each required element must be present at least once.
+ * Repeated required elements must appear at least that many times.
  */
 export function arrayIncludingAll(elements) {
-    return createMatcher((value) => Array.isArray(value) &&
-        elements.every((element) => value.includes(element)), () => `array including all of ${desc(elements)}`, () => `[…,${reprArrayElements(elements)},…]`);
+    return createMatcher((value) => Array.isArray(value) && includesAll(value, elements), () => `array including all of ${desc(elements)}`, () => `[…,${reprArrayElements(elements)},…]`);
+}
+function includesAll(value, elements) {
+    const remaining = [...value];
+    return elements.every((element) => {
+        const index = remaining.findIndex((candidate) => sameValueZero(candidate, element));
+        if (index === -1) {
+            return false;
+        }
+        remaining.splice(index, 1);
+        return true;
+    });
+}
+function sameValueZero(left, right) {
+    return left === right || (Number.isNaN(left) && Number.isNaN(right));
 }
 function reprArrayElements(values) {
     if (values.length <= 5) {

package/dist/assert/array-includes-all/array-includes-all.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-includes-all.match.js","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAaxD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAW;IAEX,OAAO,aAAa,CAClB,CAAC,KAAK,EAA0C,EAAE,CAChD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EACtD,GAAG,EAAE,CAAC,0BAA0B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAChD,GAAG,EAAE,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAC7C,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA0B;IACnD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1D,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"array-includes-all.match.js","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAOxD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAW;IAEX,OAAO,aAAa,CAClB,CACE,KAAK,EACiE,EAAE,CACxE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,EACtD,GAAG,EAAE,CAAC,0BAA0B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAChD,GAAG,EAAE,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAC7C,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,KAAyB,EACzB,QAA4B;IAE5B,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE7B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAC9C,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAClC,CAAC;QAEF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,IAAa,EAAE,KAAc;IAClD,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA0B;IACnD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1D,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/assert/array-includes-all/array-includes-all.type.d.ts

@@ -0,0 +1,51 @@
+import type { AssertionMatcher, refinement } from "../../match/match.js";
+export type ArrayIncludingAllElement<E extends readonly unknown[]> = E[number] extends never ? unknown : E[number];
+export type ArrayElement<TArray extends readonly unknown[]> = TArray[number];
+type ArrayElementOf<T> = T extends readonly (infer TElement)[] ? TElement : unknown;
+type MatchingArrayElement<TActualElement, TElement> = [
+    Extract<TActualElement, TElement>
+] extends [never] ? TElement : Extract<TActualElement, TElement>;
+type ArrayIncludingAllWitness<TElement, N extends number, TRestElement> = N extends 0 ? TRestElement[] : N extends 1 ? [TElement, ...TRestElement[]] : N extends 2 ? [TElement, TElement, ...TRestElement[]] : N extends 3 ? [TElement, TElement, TElement, ...TRestElement[]] : N extends 4 ? [TElement, TElement, TElement, TElement, ...TRestElement[]] : N extends 5 ? [
+    TElement,
+    TElement,
+    TElement,
+    TElement,
+    TElement,
+    ...TRestElement[]
+] : [
+    TElement,
+    TElement,
+    TElement,
+    TElement,
+    TElement,
+    ...TRestElement[]
+];
+export type ArrayIncludingAll<T, N extends number> = N extends 0 ? T[] : N extends 1 ? [T, ...T[]] : N extends 2 ? [T, T, ...T[]] : N extends 3 ? [T, T, T, ...T[]] : N extends 4 ? [T, T, T, T, ...T[]] : N extends 5 ? [T, T, T, T, T, ...T[]] : [T, T, T, T, T, ...T[]];
+/**
+ * Type produced when an actual value is matched by arrayIncludingAll().
+ *
+ * The leading tuple elements are type-level witnesses that the array includes
+ * the required number of matching values. They do not claim those values are at
+ * those runtime indexes. This keeps user-facing types readable while still
+ * communicating the useful facts: the array has enough elements, and those
+ * witness elements match the requested element type.
+ *
+ * When the calling scope already knows the actual value is an array, we
+ * preserve its element type for the rest of the tuple. Otherwise, the rest is
+ * unknown[].
+ */
+export type ArrayIncludingAllMatch<TActual, TElement, N extends number> = [
+    Extract<NonNullable<TActual>, readonly unknown[]>
+] extends [never] ? ArrayIncludingAllWitness<TElement, N, unknown> : ArrayIncludingAllWitness<MatchingArrayElement<ArrayElementOf<Extract<NonNullable<TActual>, readonly unknown[]>>, TElement>, N, ArrayElementOf<Extract<NonNullable<TActual>, readonly unknown[]>>>;
+export type ArrayIncludingAllMatcher<T = unknown, N extends number = number> = AssertionMatcher<ArrayIncludingAll<T, N>> & {
+    /**
+     * Optional type-level hook used by compositional assertions such as
+     * assertObjectMatches().
+     *
+     * This lets the matcher describe how it refines an existing actual type,
+     * rather than only exposing the standalone matches() predicate type.
+     */
+    readonly [refinement]?: <TActual>(actual: TActual) => ArrayIncludingAllMatch<TActual, T, N>;
+};
+export {};
+//# sourceMappingURL=array-includes-all.type.d.ts.map

package/dist/assert/array-includes-all/array-includes-all.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-includes-all.type.d.ts","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.type.ts"],"names":[],"mappings":"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"}

package/dist/assert/array-includes-all/array-includes-all.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=array-includes-all.type.js.map

package/dist/assert/array-includes-all/array-includes-all.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-includes-all.type.js","sourceRoot":"","sources":["../../../src/assert/array-includes-all/array-includes-all.type.ts"],"names":[],"mappings":""}

package/dist/assert/array-length/array-length.assert.d.ts

@@ -1,10 +1,4 @@
-import { type ArrayOfLength } from "./array-length.match.js";
-/**
- * Assert that an array has exactly the expected length, with type narrowing.
- * The type narrowing indicates:
- *  - An empty array for 0
- *  - An exact number of elements up to 10
- *  - At least 10 elements for >10
- */
-export declare function assertArrayLength<T, const N extends number>(value: readonly T[] | undefined | null, expectedLength: N, message?: string): asserts value is ArrayOfLength<T, N>;
+import type { ArrayOfLength } from "./array-length.type.js";
+export declare function assertArrayLength<TArray extends unknown[], const N extends number>(value: TArray, expectedLength: N, message?: string): asserts value is TArray & ArrayOfLength<TArray[number], N>;
+export declare function assertArrayLength<const N extends number>(value: unknown, expectedLength: N, message?: string): asserts value is ArrayOfLength<unknown, N>;
 //# sourceMappingURL=array-length.assert.d.ts.map

package/dist/assert/array-length/array-length.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-length.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAK5E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,EACzD,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAWtC"}
+{"version":3,"file":"array-length.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.assert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,wBAAgB,iBAAiB,CAC/B,MAAM,SAAS,OAAO,EAAE,EACxB,KAAK,CAAC,CAAC,SAAS,MAAM,EAEtB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACtD,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC"}

package/dist/assert/array-length/array-length.assert.js

@@ -1,5 +1,4 @@
 import { arrayOfLength } from "./array-length.match.js";
-import { assertNonNullable } from "../non-nullable/non-nullable.assert.js";
 import { AssertionError } from "../../assertion-error.js";
 import { desc, repr } from "../../describe/describe.js";
 /**
@@ -10,11 +9,15 @@ import { desc, repr } from "../../describe/describe.js";
  *  - At least 10 elements for >10
  */
 export function assertArrayLength(value, expectedLength, message) {
-    assertNonNullable(value, message);
     const matcher = arrayOfLength(expectedLength);
     if (!matcher.matches(value)) {
-        throw new AssertionError(message ??
-            `Expected ${desc(value)} to have length ${repr(expectedLength)}, but it had length ${repr(value.length)}.`, value, matcher.represent());
+        throw new AssertionError(message ?? buildArrayLengthMessage(value, expectedLength), value, matcher.represent());
     }
 }
+function buildArrayLengthMessage(value, expectedLength) {
+    if (!Array.isArray(value)) {
+        return `Expected ${desc(value)} to be an array of length ${repr(expectedLength)}.`;
+    }
+    return `Expected ${desc(value)} to have length ${repr(expectedLength)}, but it had length ${repr(value.length)}.`;
+}
 //# sourceMappingURL=array-length.assert.js.map

package/dist/assert/array-length/array-length.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-length.assert.js","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAsC,EACtC,cAAiB,EACjB,OAAgB;IAEhB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,cAAc,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAC5G,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"array-length.assert.js","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAkBxD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,cAAsB,EACtB,OAAgB;IAEhB,MAAM,OAAO,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,uBAAuB,CAAC,KAAK,EAAE,cAAc,CAAC,EACzD,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,cAAsB;IAEtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,6BAA6B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;IACrF,CAAC;IAED,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,cAAc,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;AACpH,CAAC"}

package/dist/assert/array-length/array-length.match.d.ts

@@ -1,14 +1,6 @@
-import { type AssertionMatcher, type refinement } from "../../match/match.js";
-export type ArrayOfLength<T, N extends number> = N extends 0 ? readonly [] : N extends 1 ? readonly [T] : N extends 2 ? readonly [T, T] : N extends 3 ? readonly [T, T, T] : N extends 4 ? readonly [T, T, T, T] : N extends 5 ? readonly [T, T, T, T, T] : N extends 6 ? readonly [T, T, T, T, T, T] : N extends 7 ? readonly [T, T, T, T, T, T, T] : N extends 8 ? readonly [T, T, T, T, T, T, T, T] : N extends 9 ? readonly [T, T, T, T, T, T, T, T, T] : N extends 10 ? readonly [T, T, T, T, T, T, T, T, T, T] : readonly [T, T, T, T, T, T, T, T, T, T, ...T[]] & {
-    length: N;
-};
-type ArrayElement<T> = T extends readonly (infer E)[] ? E : unknown;
-export type ArrayOfLengthMatcher<N extends number> = AssertionMatcher<ArrayOfLength<unknown, N>> & {
-    readonly [refinement]?: <TActual>(actual: TActual) => NonNullable<TActual> extends readonly unknown[] ? ArrayOfLength<ArrayElement<NonNullable<TActual>>, N> : ArrayOfLength<unknown, N>;
-};
+import { type ArrayOfLengthMatcher } from "./array-length.type.js";
 /**
  * Matcher for an array with exactly the expected length.
  */
 export declare function arrayOfLength<const N extends number>(expectedLength: N): ArrayOfLengthMatcher<N>;
-export {};
 //# sourceMappingURL=array-length.match.d.ts.map

package/dist/assert/array-length/array-length.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-length.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GACxD,SAAS,EAAE,GACX,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,CAAC,GACZ,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACf,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAClB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACrB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACxB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC3B,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC9B,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACjC,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACpC,CAAC,SAAS,EAAE,GACV,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACvC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG;IAChD,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAE1B,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;AAEpE,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI,gBAAgB,CACnE,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAC1B,GAAG;IACF,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,OAAO,EAC9B,MAAM,EAAE,OAAO,KACZ,WAAW,CAAC,OAAO,CAAC,SAAS,SAAS,OAAO,EAAE,GAChD,aAAa,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GACpD,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAClD,cAAc,EAAE,CAAC,GAChB,oBAAoB,CAAC,CAAC,CAAC,CAOzB"}
+{"version":3,"file":"array-length.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.match.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAClD,cAAc,EAAE,CAAC,GAChB,oBAAoB,CAAC,CAAC,CAAC,CAYzB"}

package/dist/assert/array-length/array-length.match.js

@@ -1,9 +1,15 @@
-import { createMatcher, } from "../../match/match.js";
+import { createMatcher } from "../../match/match.js";
 import { repr } from "../../describe/describe.js";
+import { arrayOfLengthMatcher, } from "./array-length.type.js";
 /**
  * Matcher for an array with exactly the expected length.
  */
 export function arrayOfLength(expectedLength) {
-    return createMatcher((value) => Array.isArray(value) && value.length === expectedLength, () => `array of length ${repr(expectedLength)}`, () => `Array(${repr(expectedLength)})`);
+    return {
+        ...createMatcher((value) => Array.isArray(value) && value.length === expectedLength, () => `array of length ${repr(expectedLength)}`, () => `Array(${repr(expectedLength)})`),
+        // Runtime marker used only to make the matcher type nominal for type-level
+        // refinement dispatch. It is not part of the user-facing matcher behaviour.
+        [arrayOfLengthMatcher]: expectedLength,
+    };
 }
 //# sourceMappingURL=array-length.match.js.map

package/dist/assert/array-length/array-length.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-length.match.js","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAwClD;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,cAAiB;IAEjB,OAAO,aAAa,CAClB,CAAC,KAAK,EAAsC,EAAE,CAC5C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EACzD,GAAG,EAAE,CAAC,mBAAmB,IAAI,CAAC,cAAc,CAAC,EAAE,EAC/C,GAAG,EAAE,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,GAAG,CACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"array-length.match.js","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EACL,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,cAAiB;IAEjB,OAAO;QACL,GAAG,aAAa,CACd,CAAC,KAAK,EAAsC,EAAE,CAC5C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EACzD,GAAG,EAAE,CAAC,mBAAmB,IAAI,CAAC,cAAc,CAAC,EAAE,EAC/C,GAAG,EAAE,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,GAAG,CACvC;QACD,2EAA2E;QAC3E,4EAA4E;QAC5E,CAAC,oBAAoB,CAAC,EAAE,cAAc;KACvC,CAAC;AACJ,CAAC"}

package/dist/assert/array-length/array-length.type.d.ts

@@ -0,0 +1,37 @@
+import type { AssertionMatcher, refinement } from "../../match/match.js";
+/**
+ * Unique symbol to reliably identify the ArrayOfLengthMatcher type.
+ *
+ * TypeScript is structurally typed, so matcher types with similar predicates
+ * can otherwise accidentally satisfy each other's conditional branches.
+ */
+export declare const arrayOfLengthMatcher: unique symbol;
+type ArrayElementOf<T> = T extends readonly (infer TElement)[] ? TElement : unknown;
+type ArrayMatchElement<TActual> = [
+    Extract<NonNullable<TActual>, readonly unknown[]>
+] extends [never] ? unknown : ArrayElementOf<Extract<NonNullable<TActual>, readonly unknown[]>>;
+export type ArrayOfLength<T, N extends number> = N extends 0 ? [] : N extends 1 ? [T] : N extends 2 ? [T, T] : N extends 3 ? [T, T, T] : N extends 4 ? [T, T, T, T] : N extends 5 ? [T, T, T, T, T] : N extends 6 ? [T, T, T, T, T, T] : N extends 7 ? [T, T, T, T, T, T, T] : N extends 8 ? [T, T, T, T, T, T, T, T] : N extends 9 ? [T, T, T, T, T, T, T, T, T] : N extends 10 ? [T, T, T, T, T, T, T, T, T, T] : [T, T, T, T, T, T, T, T, T, T, ...T[]] & {
+    length: N;
+};
+/**
+ * Type produced when an actual value is matched by arrayOfLength().
+ *
+ * The primary goal is to expose clean, readable user-facing types in IDE
+ * tooltips and TypeScript errors. When the calling scope already knows the
+ * actual value is an array, we preserve its element type. Otherwise, we fall
+ * back to unknown elements.
+ */
+export type ArrayOfLengthMatch<TActual, N extends number> = ArrayOfLength<ArrayMatchElement<TActual>, N>;
+export type ArrayOfLengthMatcher<N extends number> = AssertionMatcher<ArrayOfLength<unknown, N>> & {
+    readonly [arrayOfLengthMatcher]: N;
+    /**
+     * Optional type-level hook used by compositional assertions such as
+     * assertObjectMatches().
+     *
+     * This lets the matcher describe how it refines an existing actual type,
+     * rather than only exposing the standalone matches() predicate type.
+     */
+    readonly [refinement]?: <TActual>(actual: TActual) => ArrayOfLengthMatch<TActual, N>;
+};
+export {};
+//# sourceMappingURL=array-length.type.d.ts.map

package/dist/assert/array-length/array-length.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-length.type.d.ts","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,eAA0C,CAAC;AAE5E,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,QAAQ,CAAC,EAAE,GAC1D,QAAQ,GACR,OAAO,CAAC;AAEZ,KAAK,iBAAiB,CAAC,OAAO,IAAI;IAChC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAClD,SAAS,CAAC,KAAK,CAAC,GACb,OAAO,GACP,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GACxD,EAAE,GACF,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,CAAC,GACH,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,CAAC,GACN,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACT,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACZ,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACf,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAClB,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACrB,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACxB,CAAC,SAAS,CAAC,GACT,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC3B,CAAC,SAAS,EAAE,GACV,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC9B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG;IACvC,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC,SAAS,MAAM,IAAI,aAAa,CACvE,iBAAiB,CAAC,OAAO,CAAC,EAC1B,CAAC,CACF,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI,gBAAgB,CACnE,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAC1B,GAAG;IACF,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAEnC;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,OAAO,EAC9B,MAAM,EAAE,OAAO,KACZ,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CACrC,CAAC"}

package/dist/assert/array-length/array-length.type.js

@@ -0,0 +1,8 @@
+/**
+ * Unique symbol to reliably identify the ArrayOfLengthMatcher type.
+ *
+ * TypeScript is structurally typed, so matcher types with similar predicates
+ * can otherwise accidentally satisfy each other's conditional branches.
+ */
+export const arrayOfLengthMatcher = Symbol("smartass.arrayOfLengthMatcher");
+//# sourceMappingURL=array-length.type.js.map

package/dist/assert/array-length/array-length.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-length.type.js","sourceRoot":"","sources":["../../../src/assert/array-length/array-length.type.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC"}

package/dist/assert/array-min-length/array-min-length.assert.d.ts

@@ -1,10 +1,4 @@
-import { type ArrayOfMinLength } from "./array-min-length.match.js";
-/**
- * Assert that an array has at least the expected minimum length, with type narrowing.
- * The type narrowing indicates:
- *  - A non-empty array for 1
- *  - At least N elements up to 5
- *  - At least 5 elements for >5
- */
-export declare function assertArrayMinLength<T, const N extends number>(value: readonly T[] | undefined | null, minLength: N, message?: string): asserts value is ArrayOfMinLength<T, N>;
+import type { ArrayOfMinLength } from "./array-min-length.type.js";
+export declare function assertArrayMinLength<TArray extends unknown[], const N extends number>(value: TArray, minLength: N, message?: string): asserts value is TArray & ArrayOfMinLength<TArray[number], N>;
+export declare function assertArrayMinLength<const N extends number>(value: unknown, minLength: N, message?: string): asserts value is ArrayOfMinLength<unknown, N>;
 //# sourceMappingURL=array-min-length.assert.d.ts.map

package/dist/assert/array-min-length/array-min-length.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-min-length.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,6BAA6B,CAAC;AAKrC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,EAC5D,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,GAAG,IAAI,EACtC,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAWzC"}
+{"version":3,"file":"array-min-length.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.assert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,OAAO,EAAE,EACxB,KAAK,CAAC,CAAC,SAAS,MAAM,EAEtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAEjE,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACzD,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC"}

package/dist/assert/array-min-length/array-min-length.assert.js

@@ -1,5 +1,4 @@
-import { arrayOfMinLength, } from "./array-min-length.match.js";
-import { assertNonNullable } from "../non-nullable/non-nullable.assert.js";
+import { arrayOfMinLength } from "./array-min-length.match.js";
 import { AssertionError } from "../../assertion-error.js";
 import { desc, repr } from "../../describe/describe.js";
 /**
@@ -10,10 +9,15 @@ import { desc, repr } from "../../describe/describe.js";
  *  - At least 5 elements for >5
  */
 export function assertArrayMinLength(value, minLength, message) {
-    assertNonNullable(value, message);
-    if (!arrayOfMinLength(minLength).matches(value)) {
-        throw new AssertionError(message ??
-            `Expected ${desc(value)} to have at least ${repr(minLength)} elements, but it had ${repr(value.length)}.`, value, { minLength });
+    const matcher = arrayOfMinLength(minLength);
+    if (!matcher.matches(value)) {
+        throw new AssertionError(message ?? buildArrayMinLengthMessage(value, minLength), value, matcher.represent());
     }
 }
+function buildArrayMinLengthMessage(value, minLength) {
+    if (!Array.isArray(value)) {
+        return `Expected ${desc(value)} to be an array of at least ${repr(minLength)} elements.`;
+    }
+    return `Expected ${desc(value)} to have at least ${repr(minLength)} elements, but it had ${repr(value.length)}.`;
+}
 //# sourceMappingURL=array-min-length.assert.js.map

package/dist/assert/array-min-length/array-min-length.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-min-length.assert.js","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAsC,EACtC,SAAY,EACZ,OAAgB;IAEhB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAElC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,yBAAyB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAC3G,KAAK,EACL,EAAE,SAAS,EAAE,CACd,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"array-min-length.assert.js","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAkBxD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,SAAiB,EACjB,OAAgB;IAEhB,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE5C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,EACvD,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc,EAAE,SAAiB;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;IAC3F,CAAC;IAED,OAAO,YAAY,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,yBAAyB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;AACnH,CAAC"}