@kensio/smartass 1.8.0 → 1.10.0

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

@@ -0,0 +1,104 @@
+import { describe, expect, it } from "vitest";
+import { assertArrayLength } from "./array-length.assert.js";
+import { arrayOfLength } from "./array-length.match.js";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("array-length", () => {
+    describe("assertArrayLength", () => {
+        it("throws when array length does not match", () => {
+            expect(() => {
+                assertArrayLength([1, 2, 3], 2);
+            }).toThrow("Expected array [1,2,3] (len 3) to have length 2, but it had length 3.");
+        });
+        it("does not throw when array length matches", () => {
+            expect(() => {
+                assertArrayLength([1, 2, 3], 3);
+            }).not.toThrow();
+        });
+        it("throws with custom message", () => {
+            expect(() => {
+                assertArrayLength([], 1, "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("works with empty arrays", () => {
+            expect(() => {
+                assertArrayLength([], 0);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayLength([], 1);
+            }).toThrow("Expected array [] (len 0) to have length 1, but it had length 0.");
+        });
+        it("throws on null", () => {
+            expect(() => {
+                assertArrayLength(null, 0);
+            }).toThrow("Expected null not to be null.");
+        });
+        it("throws on undefined", () => {
+            expect(() => {
+                assertArrayLength(undefined, 0);
+            }).toThrow("Expected undefined not to be undefined.");
+        });
+        it("works with different lengths", () => {
+            expect(() => {
+                assertArrayLength([1], 1);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayLength([1, 2], 2);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayLength([1, 2, 3, 4, 5], 5);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayLength([1, 2, 3, 4, 5, 6], 6);
+            }).not.toThrow();
+        });
+    });
+    describe("arrayOfLength", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: ["a", "b", "c"] } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: arrayOfLength(3) },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is an array of 3 strings.
+            const firstFoobar = foo.bar.foobar[0];
+            const secondFoobar = foo.bar.foobar[1];
+            const thirdFoobar = foo.bar.foobar[2];
+            const fourthFoobar = foo.bar.foobar[3];
+            expect(firstFoobar).toBeTypeOf("string");
+            expect(secondFoobar).toBeTypeOf("string");
+            expect(thirdFoobar).toBeTypeOf("string");
+            expect(fourthFoobar).toBeUndefined();
+        });
+        it("matches arrays with the expected length", () => {
+            const matcher = arrayOfLength(3);
+            expect(matcher.matches([1, 2, 3])).toBe(true);
+        });
+        it("does not match arrays with a different length", () => {
+            const matcher = arrayOfLength(3);
+            expect(matcher.matches([1, 2])).toBe(false);
+            expect(matcher.matches([1, 2, 3, 4])).toBe(false);
+        });
+        it("matches empty arrays when expected length is zero", () => {
+            const matcher = arrayOfLength(0);
+            expect(matcher.matches([])).toBe(true);
+            expect(matcher.matches([1])).toBe(false);
+        });
+        it("does not match non-arrays", () => {
+            const matcher = arrayOfLength(1);
+            expect(matcher.matches(1)).toBe(false);
+            expect(matcher.matches("a")).toBe(false);
+            expect(matcher.matches({ 0: "a", length: 1 })).toBe(false);
+            expect(matcher.matches(null)).toBe(false);
+        });
+        it("describes the arrayOfLength matcher", () => {
+            const matcher = arrayOfLength(3);
+            expect(desc(matcher)).toBe("array of length 3");
+            expect(repr(matcher)).toBe("Array(3)");
+        });
+    });
+});
+//# sourceMappingURL=array-length.test.js.map

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

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

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

@@ -1,7 +1,8 @@
 import { type AssertionMatcher } from "../../match/match.js";
 export type ArrayOfMinLength<T, N extends number> = N extends 0 ? readonly T[] : N extends 1 ? readonly [T, ...T[]] : N extends 2 ? readonly [T, T, ...T[]] : N extends 3 ? readonly [T, T, T, ...T[]] : N extends 4 ? readonly [T, T, T, T, ...T[]] : N extends 5 ? readonly [T, T, T, T, T, ...T[]] : readonly [T, T, T, T, T, ...T[]];
+export type ArrayOfMinLengthMatcher<N extends number> = AssertionMatcher<ArrayOfMinLength<unknown, N>>;
 /**
  * Matcher for an array with at least the expected minimum length.
  */
-export declare function arrayOfMinLength<const N extends number>(minLength: N): AssertionMatcher<ArrayOfMinLength<unknown, N>>;
+export declare function arrayOfMinLength<const N extends number>(minLength: N): ArrayOfMinLengthMatcher<N>;
 //# sourceMappingURL=array-min-length.match.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"array-min-length.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GAC3D,SAAS,CAAC,EAAE,GACZ,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GACpB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GACvB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAC1B,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAC7B,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAChC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAE/C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACrD,SAAS,EAAE,CAAC,GACX,gBAAgB,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAOhD"}
+{"version":3,"file":"array-min-length.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAG5E,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GAC3D,SAAS,CAAC,EAAE,GACZ,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GACpB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GACvB,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAC1B,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAC7B,CAAC,SAAS,CAAC,GACT,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAChC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAE/C,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,MAAM,IAAI,gBAAgB,CACtE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAC7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACrD,SAAS,EAAE,CAAC,GACX,uBAAuB,CAAC,CAAC,CAAC,CAO5B"}

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

@@ -1 +1 @@
-{"version":3,"file":"array-min-length.match.js","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAgBlD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAY;IAEZ,OAAO,aAAa,CAClB,CAAC,KAAK,EAAyC,EAAE,CAC/C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EACnD,GAAG,EAAE,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,WAAW,EACrD,GAAG,EAAE,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,CACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"array-min-length.match.js","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAoBlD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAY;IAEZ,OAAO,aAAa,CAClB,CAAC,KAAK,EAAyC,EAAE,CAC/C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EACnD,GAAG,EAAE,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,WAAW,EACrD,GAAG,EAAE,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,CACpC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=array-min-length.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array-min-length.test.d.ts","sourceRoot":"","sources":["../../../src/assert/array-min-length/array-min-length.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+import { assertArrayMinLength } from "./array-min-length.assert.js";
+import { arrayOfMinLength } from "./array-min-length.match.js";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("array-min-length", () => {
+    describe("assertArrayMinLength", () => {
+        it("throws when array is shorter than minimum length", () => {
+            expect(() => {
+                assertArrayMinLength([1, 2], 3);
+            }).toThrow("Expected array [1,2] (len 2) to have at least 3 elements, but it had 2.");
+        });
+        it("does not throw when array has exactly the minimum length", () => {
+            expect(() => {
+                assertArrayMinLength([1, 2, 3], 3);
+            }).not.toThrow();
+        });
+        it("does not throw when array exceeds the minimum length", () => {
+            expect(() => {
+                assertArrayMinLength([1, 2, 3, 4, 5], 3);
+            }).not.toThrow();
+        });
+        it("throws with custom message", () => {
+            expect(() => {
+                assertArrayMinLength([1], 5, "Custom error message");
+            }).toThrow("Custom error message");
+        });
+        it("works with empty arrays and minimum 0", () => {
+            expect(() => {
+                assertArrayMinLength([], 0);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayMinLength([], 1);
+            }).toThrow("Expected array [] (len 0) to have at least 1 elements, but it had 0.");
+        });
+        it("throws on null", () => {
+            expect(() => {
+                assertArrayMinLength(null, 1);
+            }).toThrow("Expected null not to be null.");
+        });
+        it("throws on undefined", () => {
+            expect(() => {
+                assertArrayMinLength(undefined, 1);
+            }).toThrow("Expected undefined not to be undefined.");
+        });
+        it("works with different minimum lengths", () => {
+            expect(() => {
+                assertArrayMinLength([1], 1);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayMinLength([1, 2], 2);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayMinLength([1, 2, 3, 4, 5], 5);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayMinLength([1, 2, 3, 4, 5, 6], 6);
+            }).not.toThrow();
+            expect(() => {
+                assertArrayMinLength([1, 2, 3, 4, 5, 6], 3);
+            }).not.toThrow();
+        });
+    });
+    describe("arrayOfMinLength", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: ["a", "b", "c"] } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: arrayOfMinLength(2) },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is an array of at least 2 strings.
+            const firstFoobar = foo.bar.foobar[0];
+            const secondFoobar = foo.bar.foobar[1];
+            const thirdFoobar = foo.bar.foobar[2];
+            const fourthFoobar = foo.bar.foobar[3];
+            expect(firstFoobar).toBeTypeOf("string");
+            expect(secondFoobar).toBeTypeOf("string");
+            expect(thirdFoobar).toBeTypeOf("string");
+            expect(fourthFoobar).toBeUndefined();
+        });
+        it("matches arrays with exactly the minimum length", () => {
+            const matcher = arrayOfMinLength(3);
+            expect(matcher.matches([1, 2, 3])).toBe(true);
+        });
+        it("matches arrays longer than the minimum length", () => {
+            const matcher = arrayOfMinLength(3);
+            expect(matcher.matches([1, 2, 3, 4])).toBe(true);
+        });
+        it("does not match arrays shorter than the minimum length", () => {
+            const matcher = arrayOfMinLength(3);
+            expect(matcher.matches([1, 2])).toBe(false);
+        });
+        it("matches any array when minimum length is zero", () => {
+            const matcher = arrayOfMinLength(0);
+            expect(matcher.matches([])).toBe(true);
+            expect(matcher.matches([1, 2, 3])).toBe(true);
+        });
+        it("does not match non-arrays", () => {
+            const matcher = arrayOfMinLength(1);
+            expect(matcher.matches(1)).toBe(false);
+            expect(matcher.matches("a")).toBe(false);
+            expect(matcher.matches({ 0: "a", length: 1 })).toBe(false);
+            expect(matcher.matches(null)).toBe(false);
+        });
+        it("describes the arrayOfMinLength matcher", () => {
+            const matcher = arrayOfMinLength(3);
+            expect(desc(matcher)).toBe("array of at least 3 elements");
+            expect(repr(matcher)).toBe("Array(>=3)");
+        });
+    });
+});
+//# sourceMappingURL=array-min-length.test.js.map

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

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

package/dist/assert/array-not-empty/array-not-empty.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-not-empty.assert.js","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAsB,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAsC,EACtC,OAAgB;IAEhB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAElC,IAAI,CAAC,aAAa,EAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,mDAAmD,EAC9D,KAAK,EACL,CAAC,KAAK,CAAC,CACR,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"array-not-empty.assert.js","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAsB,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAsC,EACtC,OAAgB;IAEhB,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAElC,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,mDAAmD,EAC9D,KAAK,EACL,CAAC,KAAK,CAAC,CACR,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/array-not-empty/array-not-empty.match.d.ts

@@ -1,7 +1,8 @@
 import { type AssertionMatcher } from "../../match/match.js";
 export type NonEmptyArray<T> = readonly [T, ...T[]];
+export type NonEmptyArrayMatcher = AssertionMatcher<NonEmptyArray<unknown>>;
 /**
  * Matcher for a non-empty array.
  */
-export declare function nonEmptyArray<T>(): AssertionMatcher<NonEmptyArray<T>>;
+export declare function nonEmptyArray(): NonEmptyArrayMatcher;
 //# sourceMappingURL=array-not-empty.match.d.ts.map

package/dist/assert/array-not-empty/array-not-empty.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-not-empty.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAEpD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAK,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAOrE"}
+{"version":3,"file":"array-not-empty.match.d.ts","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAE5E;;GAEG;AACH,wBAAgB,aAAa,IAAI,oBAAoB,CAOpD"}

package/dist/assert/array-not-empty/array-not-empty.match.js

@@ -3,6 +3,6 @@ import { createMatcher } from "../../match/match.js";
  * Matcher for a non-empty array.
  */
 export function nonEmptyArray() {
-    return createMatcher((value) => Array.isArray(value) && value.length > 0, () => `non-empty array`, () => `[...]`);
+    return createMatcher((value) => Array.isArray(value) && value.length > 0, () => `non-empty array`, () => `[…]`);
 }
 //# sourceMappingURL=array-not-empty.match.js.map

package/dist/assert/array-not-empty/array-not-empty.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-not-empty.match.js","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI5E;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,aAAa,CAClB,CAAC,KAAK,EAA6B,EAAE,CACnC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAC1C,GAAG,EAAE,CAAC,iBAAiB,EACvB,GAAG,EAAE,CAAC,OAAO,CACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"array-not-empty.match.js","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM5E;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,aAAa,CAClB,CAAC,KAAK,EAAmC,EAAE,CACzC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAC1C,GAAG,EAAE,CAAC,iBAAiB,EACvB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;AACJ,CAAC"}

package/dist/assert/array-not-empty/array-not-empty.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=array-not-empty.test.d.ts.map

package/dist/assert/array-not-empty/array-not-empty.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-not-empty.test.d.ts","sourceRoot":"","sources":["../../../src/assert/array-not-empty/array-not-empty.test.ts"],"names":[],"mappings":""}

package/dist/assert/array-not-empty/array-not-empty.test.js

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { assertArrayNotEmpty } from "./array-not-empty.assert.js";
+import { nonEmptyArray } from "./array-not-empty.match.js";
+import { desc, repr } from "../../describe/describe.js";
+import { assertObjectMatches } from "../object-matches/object-matches.assert.js";
+describe("not-empty", () => {
+    describe("assertArrayNotEmpty", () => {
+        it("throws on empty array", () => {
+            let error;
+            try {
+                assertArrayNotEmpty([]);
+                expect.unreachable();
+            }
+            catch (error_) {
+                error = error_;
+            }
+            expect(error.message).toBe("Expected array not to be empty, but it was empty.");
+            expect(error.actual).toStrictEqual([]);
+            expect(error.expected).toStrictEqual(["..."]);
+        });
+        it("throws on null", () => {
+            expect(() => {
+                assertArrayNotEmpty(null);
+            }).toThrow("Expected null not to be null.");
+        });
+        it("throws on undefined", () => {
+            expect(() => {
+                assertArrayNotEmpty(undefined);
+            }).toThrow("Expected undefined not to be undefined.");
+        });
+    });
+    describe("nonEmptyArray", () => {
+        it("works as composable matcher", () => {
+            function getFoo() {
+                return { bar: { foobar: ["a", "b", "c"] } };
+            }
+            const foo = getFoo();
+            assertObjectMatches(foo, {
+                bar: { foobar: nonEmptyArray() },
+            });
+            // Null-chain operator ? is not required after type narrowing.
+            // TypeScript knows foo.bar.foobar is an array of at least 1 string.
+            const firstFoobar = foo.bar.foobar[0];
+            const secondFoobar = foo.bar.foobar[1];
+            const thirdFoobar = foo.bar.foobar[2];
+            expect(firstFoobar).toBeTypeOf("string");
+            expect(secondFoobar).toBeTypeOf("string");
+            expect(thirdFoobar).toBeTypeOf("string");
+        });
+        it("matches non-empty arrays", () => {
+            const matcher = nonEmptyArray();
+            expect(matcher.matches([1])).toBe(true);
+        });
+        it("matches arrays with multiple elements", () => {
+            const matcher = nonEmptyArray();
+            expect(matcher.matches([1, 2, 3])).toBe(true);
+        });
+        it("does not match empty arrays", () => {
+            const matcher = nonEmptyArray();
+            expect(matcher.matches([])).toBe(false);
+        });
+        it("does not match non-arrays", () => {
+            const matcher = nonEmptyArray();
+            expect(matcher.matches(1)).toBe(false);
+            expect(matcher.matches("a")).toBe(false);
+            expect(matcher.matches({ 0: "a", length: 1 })).toBe(false);
+            expect(matcher.matches(null)).toBe(false);
+        });
+        it("describes the nonEmptyArray matcher", () => {
+            const matcher = nonEmptyArray();
+            expect(desc(matcher)).toBe("non-empty array");
+            expect(repr(matcher)).toBe("[…]");
+        });
+    });
+});
+//# sourceMappingURL=array-not-empty.test.js.map

package/dist/assert/array-not-empty/array-not-empty.test.js.map

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

package/dist/assert/buffer-equal/buffer-equal.assert.d.ts

@@ -1,4 +1,4 @@
-import type { TypedArray } from "../type-typed-array/type-typed-array.assert.js";
+import type { TypedArray } from "../type-typed-array/type-typed-array.match.js";
 /**
  * Assert that two buffers (TypedArrays) are equal, comparing element by element.
  * Supports all TypedArray types: Uint8Array, Int8Array, Uint16Array, Int16Array,

package/dist/assert/buffer-equal/buffer-equal.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-equal.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.assert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AAGjF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EACpD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,IAAI,CAAC,CAQrB"}
+{"version":3,"file":"buffer-equal.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.assert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,UAAU,EACpD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,IAAI,CAAC,CAQrB"}

package/dist/assert/buffer-equal/buffer-equal.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-equal.assert.js","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAe,EACf,QAAW,EACX,OAAgB;IAEhB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,GAAG,EACjE,MAAM,EACN,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"buffer-equal.assert.js","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAe,EACf,QAAW,EACX,OAAgB;IAEhB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,GAAG,EACjE,MAAM,EACN,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/buffer-equal/buffer-equal.match.d.ts

@@ -1,5 +1,5 @@
 import { type AssertionMatcher } from "../../match/match.js";
-import { type TypedArray } from "../type-typed-array/type-typed-array.assert.js";
+import type { TypedArray } from "../type-typed-array/type-typed-array.match.js";
 /**
  * Matcher for a TypedArray equal to an expected TypedArray, comparing byte by byte.
  */

package/dist/assert/buffer-equal/buffer-equal.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-equal.match.d.ts","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,gDAAgD,CAAC;AAExD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,EAChD,QAAQ,EAAE,CAAC,GACV,gBAAgB,CAAC,CAAC,CAAC,CAyBrB"}
+{"version":3,"file":"buffer-equal.match.d.ts","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAEhF;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,EAChD,QAAQ,EAAE,CAAC,GACV,gBAAgB,CAAC,CAAC,CAAC,CAyBrB"}

package/dist/assert/buffer-equal/buffer-equal.match.js

@@ -1,6 +1,6 @@
 import { desc, repr } from "../../describe/describe.js";
 import { createMatcher } from "../../match/match.js";
-import { assertTypeTypedArray, } from "../type-typed-array/type-typed-array.assert.js";
+import { assertTypeTypedArray } from "../type-typed-array/type-typed-array.assert.js";
 /**
  * Matcher for a TypedArray equal to an expected TypedArray, comparing byte by byte.
  */

package/dist/assert/buffer-equal/buffer-equal.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"buffer-equal.match.js","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EACL,oBAAoB,GAErB,MAAM,gDAAgD,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAW;IAEX,OAAO,aAAa,CAClB,CAAC,KAAK,EAAc,EAAE;QACpB,IAAI,CAAC;YACH,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC9B,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,CACjB,CAAC;QACF,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAChC,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,UAAU,CACpB,CAAC;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,EACD,GAAG,EAAE,CAAC,mBAAmB,IAAI,CAAC,QAAQ,CAAC,EAAE,EACzC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CACrB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"buffer-equal.match.js","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAGtF;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAW;IAEX,OAAO,aAAa,CAClB,CAAC,KAAK,EAAc,EAAE;QACpB,IAAI,CAAC;YACH,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAC9B,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,CACjB,CAAC;QACF,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAChC,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,UAAU,EACnB,QAAQ,CAAC,UAAU,CACpB,CAAC;QAEF,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,EACD,GAAG,EAAE,CAAC,mBAAmB,IAAI,CAAC,QAAQ,CAAC,EAAE,EACzC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CACrB,CAAC;AACJ,CAAC"}

package/dist/assert/buffer-equal/buffer-equal.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buffer-equal.test.d.ts.map

package/dist/assert/buffer-equal/buffer-equal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer-equal.test.d.ts","sourceRoot":"","sources":["../../../src/assert/buffer-equal/buffer-equal.test.ts"],"names":[],"mappings":""}