@kensio/smartass 1.5.0 → 1.7.0

package/dist/assert/number-between/number-between.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-between.assert.js","sourceRoot":"","sources":["../../../src/assert/number-between/number-between.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,GAAoB,EACpB,GAAoB,EACpB,OAAO,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,aAAa;IAE1F,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAElC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC/B,MAAM,IAAI,cAAc,CACtB,OAAO,EACP,KAAK,EACL,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"number-between.assert.js","sourceRoot":"","sources":["../../../src/assert/number-between/number-between.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,GAAoB,EACpB,GAAoB,EACpB,OAAO,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,aAAa;IAE1F,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,cAAc,CACtB,OAAO,EACP,KAAK,EACL,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/number-between/number-between.match.d.ts

@@ -0,0 +1,6 @@
+import { type AssertionMatcher } from "../../match/match.js";
+/**
+ * Matcher for a numeric value between min and max inclusive.
+ */
+export declare function numberBetween(min: number | bigint, max: number | bigint): AssertionMatcher<number | bigint>;
+//# sourceMappingURL=number-between.match.d.ts.map

package/dist/assert/number-between/number-between.match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-between.match.d.ts","sourceRoot":"","sources":["../../../src/assert/number-between/number-between.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAG5E;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,GAAG,MAAM,GACnB,gBAAgB,CAAC,MAAM,GAAG,MAAM,CAAC,CAWnC"}

package/dist/assert/number-between/number-between.match.js

@@ -0,0 +1,14 @@
+import { createMatcher } from "../../match/match.js";
+import { desc, repr } from "../../describe/describe.js";
+/**
+ * Matcher for a numeric value between min and max inclusive.
+ */
+export function numberBetween(min, max) {
+    return createMatcher((value) => {
+        if (typeof value !== "number" && typeof value !== "bigint") {
+            return false;
+        }
+        return value >= min && value <= max;
+    }, () => `number between ${desc(min)} and ${desc(max)} inclusive`, () => `${repr(min)}<>${repr(max)}`);
+}
+//# sourceMappingURL=number-between.match.js.map

package/dist/assert/number-between/number-between.match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-between.match.js","sourceRoot":"","sources":["../../../src/assert/number-between/number-between.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAoB,EACpB,GAAoB;IAEpB,OAAO,aAAa,CAClB,CAAC,KAAK,EAA4B,EAAE;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;IACtC,CAAC,EACD,GAAG,EAAE,CAAC,kBAAkB,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,YAAY,EAC9D,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CACnC,CAAC;AACJ,CAAC"}

package/dist/assert/number-to-nearest/number-to-nearest.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-to-nearest.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/number-to-nearest/number-to-nearest.assert.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,CAkBzB"}
+{"version":3,"file":"number-to-nearest.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/number-to-nearest/number-to-nearest.assert.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,MAAM,CAYzB"}

package/dist/assert/number-to-nearest/number-to-nearest.assert.js

@@ -1,20 +1,16 @@
 import { AssertionError } from "../../assertion-error.js";
 import { repr } from "../../describe/describe.js";
 import { assertTypeNumber } from "../type-number/type-number.assert.js";
+import { numberToNearest } from "./number-to-nearest.match.js";
 /**
  * Assert that a numeric value, when rounded to the nearest given increment,
  * equals the expected value.
  */
 export function assertNumberToNearest(value, toNearest, expected, message) {
     assertTypeNumber(value);
-    const rawRounded = Math.round(value / toNearest) * toNearest;
-    // Determine decimal places in toNearest to avoid floating point errors
-    const parts = toNearest.toString().split(".");
-    const decimalPlaces = parts[1]?.length ?? 0;
-    const rounded = Number(rawRounded.toFixed(decimalPlaces));
-    if (rounded !== expected) {
-        throw new AssertionError(message ??
-            `Expected to equal ${repr(expected)} to nearest ${repr(toNearest)}, got ${repr(value)} rounding to ${repr(rounded)}.`, value, `${repr(expected)} (to nearest ${repr(toNearest)})`);
+    const matcher = numberToNearest(toNearest, expected);
+    if (!matcher.matches(value)) {
+        throw new AssertionError(message ?? `Expected ${repr(value)} to ${matcher.describe()}.`, value, matcher.represent());
     }
 }
 //# sourceMappingURL=number-to-nearest.assert.js.map

package/dist/assert/number-to-nearest/number-to-nearest.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-to-nearest.assert.js","sourceRoot":"","sources":["../../../src/assert/number-to-nearest/number-to-nearest.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,SAAiB,EACjB,QAAgB,EAChB,OAAgB;IAEhB,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAExB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAE7D,uEAAuE;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAE1D,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,qBAAqB,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,GAAG,EACvH,KAAK,EACL,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,GAAG,CACpD,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"number-to-nearest.assert.js","sourceRoot":"","sources":["../../../src/assert/number-to-nearest/number-to-nearest.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,SAAiB,EACjB,QAAgB,EAChB,OAAgB;IAEhB,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAExB,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAErD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,QAAQ,EAAE,GAAG,EAC9D,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/number-to-nearest/number-to-nearest.match.d.ts

@@ -0,0 +1,7 @@
+import { type AssertionMatcher } from "../../match/match.js";
+/**
+ * Matcher for a number that, when rounded to the nearest given increment,
+ * equals the expected value.
+ */
+export declare function numberToNearest(toNearest: number, expected: number): AssertionMatcher<number>;
+//# sourceMappingURL=number-to-nearest.match.d.ts.map

package/dist/assert/number-to-nearest/number-to-nearest.match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-nearest.match.d.ts","sourceRoot":"","sources":["../../../src/assert/number-to-nearest/number-to-nearest.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,MAAM,CAAC,CAQ1B"}

package/dist/assert/number-to-nearest/number-to-nearest.match.js

@@ -0,0 +1,18 @@
+import { repr } from "../../describe/describe.js";
+import { createMatcher } from "../../match/match.js";
+/**
+ * Matcher for a number that, when rounded to the nearest given increment,
+ * equals the expected value.
+ */
+export function numberToNearest(toNearest, expected) {
+    return createMatcher((value) => typeof value === "number" &&
+        roundToNearest(value, toNearest) === expected, () => `equal ${repr(expected)} to nearest ${repr(toNearest)}`, () => `≈₍${repr(toNearest)}₎${repr(expected)}`);
+}
+function roundToNearest(value, toNearest) {
+    const rawRounded = Math.round(value / toNearest) * toNearest;
+    // Determine decimal places in toNearest to avoid floating point errors
+    const parts = toNearest.toString().split(".");
+    const decimalPlaces = parts[1]?.length ?? 0;
+    return Number(rawRounded.toFixed(decimalPlaces));
+}
+//# sourceMappingURL=number-to-nearest.match.js.map

package/dist/assert/number-to-nearest/number-to-nearest.match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-nearest.match.js","sourceRoot":"","sources":["../../../src/assert/number-to-nearest/number-to-nearest.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,QAAgB;IAEhB,OAAO,aAAa,CAClB,CAAC,KAAK,EAAmB,EAAE,CACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,QAAQ,EAC/C,GAAG,EAAE,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,EAAE,EAC7D,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAC/C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,SAAiB;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAE7D,uEAAuE;IACvE,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAE5C,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/assert/object-has-property/object-has-property.assert.d.ts

@@ -0,0 +1,7 @@
+import { type ObjectWithProperty } from "./object-has-property.match.js";
+/**
+ * Assert that an object has a certain named property.
+ * The property only has to exist on the object, but could be undefined.
+ */
+export declare function assertObjectHasProperty<T extends object, K extends PropertyKey>(value: T, key: K, message?: string): asserts value is T & ObjectWithProperty<K>;
+//# sourceMappingURL=object-has-property.assert.d.ts.map

package/dist/assert/object-has-property/object-has-property.assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-has-property.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.assert.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,WAAW,EAErB,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,CAAC,EACN,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAU5C"}

package/dist/assert/object-has-property/object-has-property.assert.js

@@ -0,0 +1,14 @@
+import { AssertionError } from "../../assertion-error.js";
+import { desc } from "../../describe/describe.js";
+import { objectWithProperty, } from "./object-has-property.match.js";
+/**
+ * Assert that an object has a certain named property.
+ * The property only has to exist on the object, but could be undefined.
+ */
+export function assertObjectHasProperty(value, key, message) {
+    const matcher = objectWithProperty(key);
+    if (!matcher.matches(value)) {
+        throw new AssertionError(message ?? `Expected ${desc(value)} to be ${matcher.describe()}.`, value, matcher.represent());
+    }
+}
+//# sourceMappingURL=object-has-property.assert.js.map

package/dist/assert/object-has-property/object-has-property.assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-has-property.assert.js","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EACL,kBAAkB,GAEnB,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAIrC,KAAQ,EACR,GAAM,EACN,OAAgB;IAEhB,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,GAAG,EACjE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/object-has-property/object-has-property.match.d.ts

@@ -0,0 +1,8 @@
+import { type AssertionMatcher } from "../../match/match.js";
+export type ObjectWithProperty<K extends PropertyKey> = object & Record<K, unknown>;
+/**
+ * Matcher for an object with a certain named property.
+ * The property only has to exist on the object, but could be undefined.
+ */
+export declare function objectWithProperty<K extends PropertyKey>(key: K): AssertionMatcher<ObjectWithProperty<K>>;
+//# sourceMappingURL=object-has-property.match.d.ts.map

package/dist/assert/object-has-property/object-has-property.match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-has-property.match.d.ts","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,WAAW,IAAI,MAAM,GAC5D,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAErB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACtD,GAAG,EAAE,CAAC,GACL,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAOzC"}

package/dist/assert/object-has-property/object-has-property.match.js

@@ -0,0 +1,10 @@
+import { desc, repr } from "../../describe/describe.js";
+import { createMatcher } from "../../match/match.js";
+/**
+ * Matcher for an object with a certain named property.
+ * The property only has to exist on the object, but could be undefined.
+ */
+export function objectWithProperty(key) {
+    return createMatcher((value) => typeof value === "object" && value !== null && key in value, () => `object with property ${desc(key)}`, () => `{${repr(key)}}`);
+}
+//# sourceMappingURL=object-has-property.match.js.map

package/dist/assert/object-has-property/object-has-property.match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-has-property.match.js","sourceRoot":"","sources":["../../../src/assert/object-has-property/object-has-property.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK5E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAM;IAEN,OAAO,aAAa,CAClB,CAAC,KAAK,EAAkC,EAAE,CACxC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,EAC7D,GAAG,EAAE,CAAC,wBAAwB,IAAI,CAAC,GAAG,CAAC,EAAE,EACzC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CACvB,CAAC;AACJ,CAAC"}

package/dist/assert/object-matches/object-matches.assert.d.ts

@@ -1,6 +1,7 @@
+import type { AssertionMatcher } from "../../match/match.js";
 type FunctionLike = (...arguments_: never[]) => unknown;
 type ObjectMatchLeaf = FunctionLike | Date | RegExp | Map<unknown, unknown> | Set<unknown> | WeakMap<object, unknown> | WeakSet<object> | Promise<unknown>;
-type DeepObjectMatch<T> = T extends ObjectMatchLeaf ? T : T extends readonly unknown[] ? {
+type DeepObjectMatch<T> = T extends AssertionMatcher<infer TMatched> ? TMatched : T extends ObjectMatchLeaf ? T : T extends readonly unknown[] ? {
     readonly [K in keyof T]: DeepObjectMatch<T[K]>;
 } : T extends object ? {
     [K in keyof T]: DeepObjectMatch<T[K]>;
@@ -9,9 +10,11 @@ type DeepObjectMatch<T> = T extends ObjectMatchLeaf ? T : T extends readonly unk
  * Assert that an object matches a partial deep object structure, with
  * type-narrowing.
  *
- * Plain objects are matched partially and recursively. Arrays are matched by
- * length and by recursively matching each element in order. Primitive values and
- * non-plain objects are compared using Object.is.
+ * Plain objects are matched partially and recursively.
+ * Arrays are matched by length and by recursively matching each element in
+ * order.
+ * Matcher values are evaluated with their matcher predicate.
+ * Primitive values and non-plain objects are compared using Object.is.
  */
 export declare function assertObjectMatches<TActual, const TExpected extends Record<PropertyKey, unknown>>(actual: TActual, expected: TExpected, message?: string): asserts actual is TActual & DeepObjectMatch<TExpected>;
 export {};

package/dist/assert/object-matches/object-matches.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-matches.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/object-matches/object-matches.assert.ts"],"names":[],"mappings":"AAIA,KAAK,YAAY,GAAG,CAAC,GAAG,UAAU,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAExD,KAAK,eAAe,GAChB,YAAY,GACZ,IAAI,GACJ,MAAM,GACN,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GACrB,GAAG,CAAC,OAAO,CAAC,GACZ,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GACxB,OAAO,CAAC,MAAM,CAAC,GACf,OAAO,CAAC,OAAO,CAAC,CAAC;AAErB,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,eAAe,GAC/C,CAAC,GACD,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAClD,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACzC,CAAC,CAAC;AAEV;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EACP,KAAK,CAAC,SAAS,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAEpD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,IAAI,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAcxD"}
+{"version":3,"file":"object-matches.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/object-matches/object-matches.assert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,KAAK,YAAY,GAAG,CAAC,GAAG,UAAU,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAExD,KAAK,eAAe,GAChB,YAAY,GACZ,IAAI,GACJ,MAAM,GACN,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,GACrB,GAAG,CAAC,OAAO,CAAC,GACZ,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GACxB,OAAO,CAAC,MAAM,CAAC,GACf,OAAO,CAAC,OAAO,CAAC,CAAC;AAErB,KAAK,eAAe,CAAC,CAAC,IACpB,CAAC,SAAS,gBAAgB,CAAC,MAAM,QAAQ,CAAC,GACtC,QAAQ,GACR,CAAC,SAAS,eAAe,GACvB,CAAC,GACD,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAClD,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACzC,CAAC,CAAC;AAEd;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EACP,KAAK,CAAC,SAAS,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAEpD,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,IAAI,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAcxD"}

package/dist/assert/object-matches/object-matches.assert.js

@@ -5,9 +5,11 @@ import { findObjectComparisonMismatch } from "../../compare/object-comparison.js
  * Assert that an object matches a partial deep object structure, with
  * type-narrowing.
  *
- * Plain objects are matched partially and recursively. Arrays are matched by
- * length and by recursively matching each element in order. Primitive values and
- * non-plain objects are compared using Object.is.
+ * Plain objects are matched partially and recursively.
+ * Arrays are matched by length and by recursively matching each element in
+ * order.
+ * Matcher values are evaluated with their matcher predicate.
+ * Primitive values and non-plain objects are compared using Object.is.
  */
 export function assertObjectMatches(actual, expected, message) {
     const mismatch = findObjectComparisonMismatch(actual, expected, {

package/dist/assert/object-matches/object-matches.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"object-matches.assert.js","sourceRoot":"","sources":["../../../src/assert/object-matches/object-matches.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAsBlF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAIjC,MAAe,EACf,QAAmB,EACnB,OAAgB;IAEhB,MAAM,QAAQ,GAAG,4BAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC9D,eAAe,EAAE,KAAK;QACtB,sBAAsB,EAAE,KAAK;KAC9B,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,iBAAiB,QAAQ,CAAC,IAAI,cAAc,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EACzJ,MAAM,EACN,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"object-matches.assert.js","sourceRoot":"","sources":["../../../src/assert/object-matches/object-matches.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AA0BlF;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAIjC,MAAe,EACf,QAAmB,EACnB,OAAgB;IAEhB,MAAM,QAAQ,GAAG,4BAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC9D,eAAe,EAAE,KAAK;QACtB,sBAAsB,EAAE,KAAK;KAC9B,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,iBAAiB,QAAQ,CAAC,IAAI,cAAc,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EACzJ,MAAM,EACN,QAAQ,CACT,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/one-of/one-of.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"one-of.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/one-of/one-of.assert.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,QAAQ,SAAS,SAAS,OAAO,EAAE,EACnE,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,QAAQ,EACjB,OAAO,SAA2D,GACjE,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,CAInC"}
+{"version":3,"file":"one-of.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/one-of/one-of.assert.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,QAAQ,SAAS,SAAS,OAAO,EAAE,EACnE,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,CASnC"}

package/dist/assert/one-of/one-of.assert.js

@@ -1,11 +1,13 @@
 import { AssertionError } from "../../assertion-error.js";
-import { desc, repr } from "../../describe/describe.js";
+import { desc } from "../../describe/describe.js";
+import { oneOf } from "./one-of.match.js";
 /**
  * Assert that a value is one of a set of expected values, with type-narrowing.
  */
-export function assertOneOf(value, allowed, message = `Expected ${desc(value)} to be one of ${repr(allowed)}.`) {
-    if (!allowed.includes(value)) {
-        throw new AssertionError(message, value, `one of ${desc(allowed)}`);
+export function assertOneOf(value, allowed, message) {
+    const matcher = oneOf(allowed);
+    if (!matcher.matches(value)) {
+        throw new AssertionError(message ?? `Expected ${desc(value)} to be ${matcher.describe()}.`, value, matcher.represent());
     }
 }
 //# sourceMappingURL=one-of.assert.js.map

package/dist/assert/one-of/one-of.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"one-of.assert.js","sourceRoot":"","sources":["../../../src/assert/one-of/one-of.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAAiB,EACjB,OAAO,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,OAAO,CAAC,GAAG;IAElE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC"}
+{"version":3,"file":"one-of.assert.js","sourceRoot":"","sources":["../../../src/assert/one-of/one-of.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAAiB,EACjB,OAAgB;IAEhB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,QAAQ,EAAE,GAAG,EACjE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/one-of/one-of.match.d.ts

@@ -0,0 +1,6 @@
+import { type AssertionMatcher } from "../../match/match.js";
+/**
+ * Matcher for a value that is one of a set of expected values.
+ */
+export declare function oneOf<const TAllowed extends readonly unknown[]>(allowed: TAllowed): AssertionMatcher<TAllowed[number]>;
+//# sourceMappingURL=one-of.match.d.ts.map

package/dist/assert/one-of/one-of.match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-of.match.d.ts","sourceRoot":"","sources":["../../../src/assert/one-of/one-of.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,CAAC,QAAQ,SAAS,SAAS,OAAO,EAAE,EAC7D,OAAO,EAAE,QAAQ,GAChB,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAMpC"}

package/dist/assert/one-of/one-of.match.js

@@ -0,0 +1,9 @@
+import { repr } from "../../describe/describe.js";
+import { createMatcher } from "../../match/match.js";
+/**
+ * Matcher for a value that is one of a set of expected values.
+ */
+export function oneOf(allowed) {
+    return createMatcher((value) => allowed.includes(value), () => `one of ${repr(allowed)}`, () => allowed.map((i) => repr(i)).join("|"));
+}
+//# sourceMappingURL=one-of.match.js.map

package/dist/assert/one-of/one-of.match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-of.match.js","sourceRoot":"","sources":["../../../src/assert/one-of/one-of.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,OAAiB;IAEjB,OAAO,aAAa,CAClB,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAc,CAAC,EACtE,GAAG,EAAE,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,EAAE,EAC/B,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/assert/string-ends-with/string-ends-with.assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-ends-with.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/string-ends-with/string-ends-with.assert.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACzD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CASlC"}
+{"version":3,"file":"string-ends-with.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/string-ends-with/string-ends-with.assert.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACzD,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAUlC"}

package/dist/assert/string-ends-with/string-ends-with.assert.js

@@ -1,12 +1,14 @@
 import { AssertionError } from "../../assertion-error.js";
 import { desc, repr } from "../../describe/describe.js";
+import { stringEndingWith } from "./string-ends-with.match.js";
 /**
  * Assert that a string ends with a given suffix, with type narrowing.
  */
 export function assertStringEndsWith(value, suffix, message) {
-    if (!value.endsWith(suffix)) {
+    const matcher = stringEndingWith(suffix);
+    if (!matcher.matches(value)) {
         throw new AssertionError(message ??
-            `Expected ${desc(value)} to end with ${repr(suffix)}, but it did not.`, value, `string ending with ${repr(suffix)}`);
+            `Expected ${desc(value)} to end with ${repr(suffix)}, but it did not.`, value, matcher.represent());
     }
 }
 //# sourceMappingURL=string-ends-with.assert.js.map

package/dist/assert/string-ends-with/string-ends-with.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"string-ends-with.assert.js","sourceRoot":"","sources":["../../../src/assert/string-ends-with/string-ends-with.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,MAAS,EACT,OAAgB;IAEhB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EACxE,KAAK,EACL,sBAAsB,IAAI,CAAC,MAAM,CAAC,EAAE,CACrC,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"string-ends-with.assert.js","sourceRoot":"","sources":["../../../src/assert/string-ends-with/string-ends-with.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,MAAS,EACT,OAAgB;IAEhB,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EACxE,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/string-ends-with/string-ends-with.match.d.ts

@@ -0,0 +1,6 @@
+import { type AssertionMatcher } from "../../match/match.js";
+/**
+ * Matcher for a string that ends with a given suffix.
+ */
+export declare function stringEndingWith<const T extends string>(suffix: T): AssertionMatcher<`${string}${T}`>;
+//# sourceMappingURL=string-ends-with.match.d.ts.map

package/dist/assert/string-ends-with/string-ends-with.match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-ends-with.match.d.ts","sourceRoot":"","sources":["../../../src/assert/string-ends-with/string-ends-with.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACrD,MAAM,EAAE,CAAC,GACR,gBAAgB,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,CAOnC"}

package/dist/assert/string-ends-with/string-ends-with.match.js

@@ -0,0 +1,9 @@
+import { repr } from "../../describe/describe.js";
+import { createMatcher } from "../../match/match.js";
+/**
+ * Matcher for a string that ends with a given suffix.
+ */
+export function stringEndingWith(suffix) {
+    return createMatcher((value) => typeof value === "string" && value.endsWith(suffix), () => `string ending with ${repr(suffix)}`, () => `"*${suffix}"`);
+}
+//# sourceMappingURL=string-ends-with.match.js.map

package/dist/assert/string-ends-with/string-ends-with.match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-ends-with.match.js","sourceRoot":"","sources":["../../../src/assert/string-ends-with/string-ends-with.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAS;IAET,OAAO,aAAa,CAClB,CAAC,KAAK,EAA4B,EAAE,CAClC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EACrD,GAAG,EAAE,CAAC,sBAAsB,IAAI,CAAC,MAAM,CAAC,EAAE,EAC1C,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,CACrB,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"string-includes.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/string-includes/string-includes.assert.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACzD,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,CAS3C"}
+{"version":3,"file":"string-includes.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/string-includes/string-includes.assert.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACzD,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,CAW3C"}

package/dist/assert/string-includes/string-includes.assert.js

@@ -1,12 +1,14 @@
 import { AssertionError } from "../../assertion-error.js";
 import { desc, repr } from "../../describe/describe.js";
+import { stringIncluding } from "./string-includes.match.js";
 /**
  * Assert that a string includes a given substring, with type narrowing.
  */
 export function assertStringIncludes(value, substring, message) {
-    if (!value.includes(substring)) {
+    const matcher = stringIncluding(substring);
+    if (!matcher.matches(value)) {
         throw new AssertionError(message ??
-            `Expected ${desc(value)} to include ${repr(substring)}, but it did not.`, value, `... ${substring} ...`);
+            `Expected ${desc(value)} to include ${repr(substring)}, but it did not.`, value, matcher.represent());
     }
 }
 //# sourceMappingURL=string-includes.assert.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"string-includes.assert.js","sourceRoot":"","sources":["../../../src/assert/string-includes/string-includes.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,SAAY,EACZ,OAAgB;IAEhB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,cAAc,CACtB,OAAO;YACL,YAAY,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAC1E,KAAK,EACL,OAAO,SAAS,MAAM,CACvB,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"string-includes.assert.js","sourceRoot":"","sources":["../../../src/assert/string-includes/string-includes.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,SAAY,EACZ,OAAgB;IAEhB,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAE3C,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,SAAS,CAAC,mBAAmB,EAC1E,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,6 @@
+import { type AssertionMatcher } from "../../match/match.js";
+/**
+ * Matcher for a string that includes a given substring.
+ */
+export declare function stringIncluding<const T extends string>(substring: T): AssertionMatcher<`${string}${T}${string}`>;
+//# sourceMappingURL=string-includes.match.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-includes.match.d.ts","sourceRoot":"","sources":["../../../src/assert/string-includes/string-includes.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACpD,SAAS,EAAE,CAAC,GACX,gBAAgB,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,CAO5C"}

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

@@ -0,0 +1,9 @@
+import { repr } from "../../describe/describe.js";
+import { createMatcher } from "../../match/match.js";
+/**
+ * Matcher for a string that includes a given substring.
+ */
+export function stringIncluding(substring) {
+    return createMatcher((value) => typeof value === "string" && value.includes(substring), () => `string including ${repr(substring)}`, () => `"…${substring}…"`);
+}
+//# sourceMappingURL=string-includes.match.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-includes.match.js","sourceRoot":"","sources":["../../../src/assert/string-includes/string-includes.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAyB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAY;IAEZ,OAAO,aAAa,CAClB,CAAC,KAAK,EAAqC,EAAE,CAC3C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EACxD,GAAG,EAAE,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,EAAE,EAC3C,GAAG,EAAE,CAAC,KAAK,SAAS,IAAI,CACzB,CAAC;AACJ,CAAC"}

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

@@ -1,3 +1,4 @@
+import { type StringOfLength } from "./string-length.match.js";
 /**
  * Assert that a string has exactly the expected length, with type narrowing.
  *
@@ -11,94 +12,4 @@
  * not Unicode grapheme clusters.
  */
 export declare function assertStringLength<const N extends number>(value: string, expectedLength: N, message?: string): asserts value is StringOfLength<N>;
-type StringOfLength<N extends number> = N extends 0 ? "" : N extends 1 ? string & {
-    length: 1;
-    0: string;
-} : N extends 2 ? string & {
-    length: 2;
-    0: string;
-    1: string;
-} : N extends 3 ? string & {
-    length: 3;
-    0: string;
-    1: string;
-    2: string;
-} : N extends 4 ? string & {
-    length: 4;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-} : N extends 5 ? string & {
-    length: 5;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-} : N extends 6 ? string & {
-    length: 6;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-    5: string;
-} : N extends 7 ? string & {
-    length: 7;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-    5: string;
-    6: string;
-} : N extends 8 ? string & {
-    length: 8;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-    5: string;
-    6: string;
-    7: string;
-} : N extends 9 ? string & {
-    length: 9;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-    5: string;
-    6: string;
-    7: string;
-    8: string;
-} : N extends 10 ? string & {
-    length: 10;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-    5: string;
-    6: string;
-    7: string;
-    8: string;
-    9: string;
-} : string & {
-    length: N;
-    0: string;
-    1: string;
-    2: string;
-    3: string;
-    4: string;
-    5: string;
-    6: string;
-    7: string;
-    8: string;
-    9: string;
-    10: string;
-};
-export {};
 //# sourceMappingURL=string-length.assert.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"string-length.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/string-length/string-length.assert.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"string-length.assert.d.ts","sourceRoot":"","sources":["../../../src/assert/string-length/string-length.assert.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EACvD,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,CAUpC"}

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

@@ -1,5 +1,6 @@
 import { AssertionError } from "../../assertion-error.js";
 import { desc, repr } from "../../describe/describe.js";
+import { stringOfLength } from "./string-length.match.js";
 /**
  * Assert that a string has exactly the expected length, with type narrowing.
  *
@@ -13,9 +14,10 @@ import { desc, repr } from "../../describe/describe.js";
  * not Unicode grapheme clusters.
  */
 export function assertStringLength(value, expectedLength, message) {
-    if (value.length !== expectedLength) {
+    const matcher = stringOfLength(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, { length: expectedLength });
+            `Expected ${desc(value)} to have length ${repr(expectedLength)}, but it had length ${repr(value.length)}.`, value, matcher.represent());
     }
 }
 //# sourceMappingURL=string-length.assert.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"string-length.assert.js","sourceRoot":"","sources":["../../../src/assert/string-length/string-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,cAAiB,EACjB,OAAgB;IAEhB,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QACpC,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,EAAE,MAAM,EAAE,cAAc,EAAE,CAC3B,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"string-length.assert.js","sourceRoot":"","sources":["../../../src/assert/string-length/string-length.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAuB,MAAM,0BAA0B,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,cAAiB,EACjB,OAAgB;IAEhB,MAAM,OAAO,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAC/C,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"}