@kensio/smartass 1.16.0 → 1.17.0

package/dist/assert/uuid/uuid-v4.assert.js

@@ -4,10 +4,10 @@ import { uuidV4 } from "./uuid-v4.match.js";
 /**
  * Assert that a value is a UUID v4 string, with type-narrowing.
  */
-export function assertUuidV4(value, message = `Expected ${desc(value)} to be a UUID v4 string.`) {
+export function assertUuidV4(value, message) {
     const matcher = uuidV4();
     if (!matcher.matches(value)) {
-        throw new AssertionError(message, value, matcher.represent());
+        throw new AssertionError(message ?? `Expected ${desc(value)} to be a UUID v4 string.`, value, matcher.represent());
     }
 }
 //# sourceMappingURL=uuid-v4.assert.js.map

package/dist/assert/uuid/uuid-v4.assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"uuid-v4.assert.js","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,MAAM,EAAe,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,OAAO,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,0BAA0B;IAE3D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}
+{"version":3,"file":"uuid-v4.assert.js","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAa5C;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,OAAgB;IAC3D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,0BAA0B,EAC5D,KAAK,EACL,OAAO,CAAC,SAAS,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/assert/uuid/uuid-v4.match.d.ts

@@ -1,8 +1,6 @@
-import type { UUID } from "node:crypto";
-import { type AssertionMatcher } from "../../match/match.js";
-export type UuidV4 = UUID & `${string}-${string}-4${string}-${"8" | "9" | "a" | "b"}${string}-${string}`;
+import { type UuidV4Matcher } from "./uuid-v4.type.js";
 /**
  * Matcher for a UUID v4 string value.
  */
-export declare function uuidV4(): AssertionMatcher<UuidV4>;
+export declare function uuidV4(): UuidV4Matcher;
 //# sourceMappingURL=uuid-v4.match.d.ts.map

package/dist/assert/uuid/uuid-v4.match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid-v4.match.d.ts","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK5E,MAAM,MAAM,MAAM,GAAG,IAAI,GACvB,GAAG,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE/E;;GAEG;AACH,wBAAgB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAOjD"}
+{"version":3,"file":"uuid-v4.match.d.ts","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.match.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAK3B;;GAEG;AACH,wBAAgB,MAAM,IAAI,aAAa,CAYtC"}

package/dist/assert/uuid/uuid-v4.match.js

@@ -1,9 +1,15 @@
 import { createMatcher } from "../../match/match.js";
+import { uuidV4Matcher, } from "./uuid-v4.type.js";
 const uuidV4Regex = /^[\da-f]{8}-[\da-f]{4}-4[\da-f]{3}-[89ab][\da-f]{3}-[\da-f]{12}$/i;
 /**
  * Matcher for a UUID v4 string value.
  */
 export function uuidV4() {
-    return createMatcher((value) => typeof value === "string" && uuidV4Regex.test(value), () => "UUID v4 string", () => "uuidV4()");
+    return {
+        ...createMatcher((value) => typeof value === "string" && uuidV4Regex.test(value), () => "UUID v4 string", () => "uuidV4()"),
+        // 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.
+        [uuidV4Matcher]: true,
+    };
 }
 //# sourceMappingURL=uuid-v4.match.js.map

package/dist/assert/uuid/uuid-v4.match.js.map

@@ -1 +1 @@
-{"version":3,"file":"uuid-v4.match.js","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.match.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,WAAW,GACf,mEAAmE,CAAC;AAKtE;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,aAAa,CAClB,CAAC,KAAK,EAAmB,EAAE,CACzB,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EACtD,GAAG,EAAE,CAAC,gBAAgB,EACtB,GAAG,EAAE,CAAC,UAAU,CACjB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"uuid-v4.match.js","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAEL,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,GACf,mEAAmE,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO;QACL,GAAG,aAAa,CACd,CAAC,KAAK,EAAmB,EAAE,CACzB,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EACtD,GAAG,EAAE,CAAC,gBAAgB,EACtB,GAAG,EAAE,CAAC,UAAU,CACjB;QACD,2EAA2E;QAC3E,4EAA4E;QAC5E,CAAC,aAAa,CAAC,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC"}

package/dist/assert/uuid/uuid-v4.type.d.ts

@@ -0,0 +1,34 @@
+import type { UUID } from "node:crypto";
+import type { AssertionMatcher, refinement } from "../../match/match.js";
+/**
+ * Unique symbol to reliably identify the UuidV4Matcher type.
+ *
+ * This keeps refinement dispatch nominal. Without this marker, structurally
+ * similar string matchers could accidentally match the wrong conditional branch.
+ */
+export declare const uuidV4Matcher: unique symbol;
+type UuidV4Variant = "8" | "9" | "a" | "A" | "b" | "B";
+export type UuidV4 = UUID & `${string}-${string}-4${string}-${UuidV4Variant}${string}-${string}`;
+/**
+ * Type produced when an actual value is matched by uuidV4().
+ *
+ * If the calling scope already knows UUID v4-compatible string information,
+ * preserve that overlap. Otherwise, fall back to the standalone matcher type:
+ * UuidV4.
+ */
+export type UuidV4Match<TActual> = [
+    Extract<NonNullable<TActual>, UuidV4>
+] extends [never] ? UuidV4 : Extract<NonNullable<TActual>, UuidV4>;
+export type UuidV4Matcher = AssertionMatcher<UuidV4> & {
+    readonly [uuidV4Matcher]: true;
+    /**
+     * 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) => UuidV4Match<TActual>;
+};
+export {};
+//# sourceMappingURL=uuid-v4.type.d.ts.map

package/dist/assert/uuid/uuid-v4.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-v4.type.d.ts","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,eAAmC,CAAC;AAE9D,KAAK,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvD,MAAM,MAAM,MAAM,GAAG,IAAI,GACvB,GAAG,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,aAAa,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,IAAI;IACjC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CACtC,SAAS,CAAC,KAAK,CAAC,GACb,MAAM,GACN,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC,GAAG;IACrD,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAE/B;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,WAAW,CAAC,OAAO,CAAC,CAAC;CAC5E,CAAC"}

package/dist/assert/uuid/uuid-v4.type.js

@@ -0,0 +1,8 @@
+/**
+ * Unique symbol to reliably identify the UuidV4Matcher type.
+ *
+ * This keeps refinement dispatch nominal. Without this marker, structurally
+ * similar string matchers could accidentally match the wrong conditional branch.
+ */
+export const uuidV4Matcher = Symbol("smartass.uuidV4Matcher");
+//# sourceMappingURL=uuid-v4.type.js.map

package/dist/assert/uuid/uuid-v4.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-v4.type.js","sourceRoot":"","sources":["../../../src/assert/uuid/uuid-v4.type.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export * from "./assert/false/false.assert.js";
 export * from "./assert/identical/identical.assert.js";
 export * from "./assert/instance-of/instance-of.assert.js";
 export * from "./assert/instance-of/instance-of.match.js";
+export * from "./assert/map-size/map-size.assert.js";
+export * from "./assert/map-size/map-size.match.js";
 export * from "./assert/non-nullable/non-nullable.assert.js";
 export * from "./assert/non-nullable/non-nullable.match.js";
 export * from "./assert/number-between/number-between.assert.js";
@@ -55,9 +57,10 @@ export * from "./assert/type-object/type-object.assert.js";
 export * from "./assert/type-object/type-object.match.js";
 export * from "./assert/type-string/type-string.assert.js";
 export * from "./assert/type-string/type-string.match.js";
+export * from "./assert/type-symbol/type-symbol.assert.js";
+export * from "./assert/type-symbol/type-symbol.match.js";
 export * from "./assert/type-typed-array/type-typed-array.assert.js";
 export * from "./assert/type-typed-array/type-typed-array.match.js";
-export * from "./assert/typeof/typeof.assert.js";
 export * from "./assert/undefined/undefined.assert.js";
 export * from "./assert/uuid/uuid-v4.assert.js";
 export * from "./assert/uuid/uuid-v4.match.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,kDAAkD,CAAC;AACjE,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,wDAAwD,CAAC;AACvE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,kDAAkD,CAAC;AACjE,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,wDAAwD,CAAC;AACvE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC"}

package/dist/index.js

@@ -15,6 +15,8 @@ export * from "./assert/false/false.assert.js";
 export * from "./assert/identical/identical.assert.js";
 export * from "./assert/instance-of/instance-of.assert.js";
 export * from "./assert/instance-of/instance-of.match.js";
+export * from "./assert/map-size/map-size.assert.js";
+export * from "./assert/map-size/map-size.match.js";
 export * from "./assert/non-nullable/non-nullable.assert.js";
 export * from "./assert/non-nullable/non-nullable.match.js";
 export * from "./assert/number-between/number-between.assert.js";
@@ -55,9 +57,10 @@ export * from "./assert/type-object/type-object.assert.js";
 export * from "./assert/type-object/type-object.match.js";
 export * from "./assert/type-string/type-string.assert.js";
 export * from "./assert/type-string/type-string.match.js";
+export * from "./assert/type-symbol/type-symbol.assert.js";
+export * from "./assert/type-symbol/type-symbol.match.js";
 export * from "./assert/type-typed-array/type-typed-array.assert.js";
 export * from "./assert/type-typed-array/type-typed-array.match.js";
-export * from "./assert/typeof/typeof.assert.js";
 export * from "./assert/undefined/undefined.assert.js";
 export * from "./assert/uuid/uuid-v4.assert.js";
 export * from "./assert/uuid/uuid-v4.match.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,kDAAkD,CAAC;AACjE,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,wDAAwD,CAAC;AACvE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,kDAAkD,CAAC;AACjE,cAAc,iDAAiD,CAAC;AAChE,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,kDAAkD,CAAC;AACjE,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,0DAA0D,CAAC;AACzE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,wDAAwD,CAAC;AACvE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC"}

package/dist/match/match.d.ts

@@ -6,10 +6,46 @@ export interface AssertionMatcher<T> {
     describe(): string;
     represent(): string;
 }
+/**
+ * Matcher refinement architecture
+ * --------------------------------
+ *
+ * Matchers have two related but different type-level jobs:
+ *
+ * 1. Standalone matching:
+ *    matcher.matches(value) narrows unknown values to the matcher's basic
+ *    predicate type.
+ *
+ * 2. Compositional matching:
+ *    assertObjectMatches() applies matchers inside an existing object type, so
+ *    matchers should preserve useful information from the calling scope where
+ *    possible.
+ *
+ * For example, arrayIncluding("beta") should narrow an unknown value to
+ * ["beta", ...unknown[]], but a known string[] property to
+ * ["beta", ...string[]]. The latter is more useful and more readable than an
+ * opaque intersection type.
+ *
+ * Matchers may expose an optional [refinement] hook to describe this
+ * actual-type-aware narrowing. Some matchers also export a semantic *Match type
+ * and have an explicit branch in object-matches.type.ts. That is intentional:
+ * TypeScript cannot always apply generic refinement hooks precisely enough
+ * through conditional inference.
+ *
+ * The main priority is user-facing type readability in IDE tooltips and
+ * compiler errors. Prefer plain TypeScript types such as:
+ *
+ *   ["beta", ...string[]]
+ *   [string, string]
+ *   "draft" | "published"
+ *   `${string}.json`
+ *
+ * over internal helper names or complex intersections where practical.
+ */
 type ApplyRefinement<TRefinement, TActual> = TRefinement extends (actual: TActual) => infer TRefined ? TRefined : never;
 export type RefinedMatch<TMatcher, TActual> = TMatcher extends {
     readonly [refinement]?: infer TRefinement;
-} ? TRefinement extends (actual: TActual) => unknown ? TActual & ApplyRefinement<TRefinement, TActual> : TMatcher extends AssertionMatcher<infer TMatched> ? TActual & TMatched : TActual & InferMatch<TMatcher> : TMatcher extends AssertionMatcher<infer TMatched> ? TActual & TMatched : TActual & InferMatch<TMatcher>;
+} ? ApplyRefinement<TRefinement, TActual> : TMatcher extends AssertionMatcher<infer TMatched> ? TActual & TMatched : TActual & InferMatch<TMatcher>;
 export type InferMatch<T> = T extends AssertionMatcher<infer U> ? U : T extends readonly unknown[] ? T : T extends object ? {
     [K in keyof T]: InferMatch<T[K]>;
 } : T;

package/dist/match/match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/match/match.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,OAAO,eAA6B,CAAC;AAC3C,MAAM,CAAC,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAC;AAE/C,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC;IACpC,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;CACrB;AAED,KAAK,eAAe,CAAC,WAAW,EAAE,OAAO,IAAI,WAAW,SAAS,CAC/D,MAAM,EAAE,OAAO,KACZ,MAAM,QAAQ,GACf,QAAQ,GACR,KAAK,CAAC;AAEV,MAAM,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,IAAI,QAAQ,SAAS;IAC7D,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,WAAW,CAAC;CAC3C,GACG,WAAW,SAAS,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAC9C,OAAO,GAAG,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,GAC/C,QAAQ,SAAS,gBAAgB,CAAC,MAAM,QAAQ,CAAC,GAC/C,OAAO,GAAG,QAAQ,GAClB,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,GAClC,QAAQ,SAAS,gBAAgB,CAAC,MAAM,QAAQ,CAAC,GAC/C,OAAO,GAAG,QAAQ,GAClB,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAErC,MAAM,MAAM,UAAU,CAAC,CAAC,IACtB,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAC/B,CAAC,GACD,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B,CAAC,GACD,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACpC,CAAC,CAAC;AAEZ;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACvC,QAAQ,EAAE,MAAM,MAAM,EACtB,SAAS,EAAE,MAAM,MAAM,GACtB,gBAAgB,CAAC,CAAC,CAAC,CAOrB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAE5E"}
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/match/match.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,OAAO,eAA6B,CAAC;AAC3C,MAAM,CAAC,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAC;AAE/C,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACzB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC;IACpC,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,KAAK,eAAe,CAAC,WAAW,EAAE,OAAO,IAAI,WAAW,SAAS,CAC/D,MAAM,EAAE,OAAO,KACZ,MAAM,QAAQ,GACf,QAAQ,GACR,KAAK,CAAC;AAEV,MAAM,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,IAAI,QAAQ,SAAS;IAC7D,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,WAAW,CAAC;CAC3C,GACG,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,GACrC,QAAQ,SAAS,gBAAgB,CAAC,MAAM,QAAQ,CAAC,GAC/C,OAAO,GAAG,QAAQ,GAClB,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAErC,MAAM,MAAM,UAAU,CAAC,CAAC,IACtB,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAC/B,CAAC,GACD,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B,CAAC,GACD,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACpC,CAAC,CAAC;AAEZ;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EACvC,QAAQ,EAAE,MAAM,MAAM,EACtB,SAAS,EAAE,MAAM,MAAM,GACtB,gBAAgB,CAAC,CAAC,CAAC,CAOrB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAE5E"}

package/dist/match/match.js.map

@@ -1 +1 @@
-{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/match/match.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAqC3C;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAuC,EACvC,QAAsB,EACtB,SAAuB;IAEvB,OAAO;QACL,CAAC,OAAO,CAAC,EAAE,IAAI;QACf,OAAO;QACP,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC"}
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../src/match/match.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAqE3C;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAuC,EACvC,QAAsB,EACtB,SAAuB;IAEvB,OAAO;QACL,CAAC,OAAO,CAAC,EAAE,IAAI;QACf,OAAO;QACP,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC"}

package/package.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/KensioSoftware/smartass"
   },
   "license": "AGPL-3.0",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",