bupkis 0.1.2 → 0.3.0

package/dist/esm/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AA0BzD,2BAA2B;AAC3B,QAAA,MAAQ,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4MAAQ,CAAC;AACvB,gCAAgC;AAChC,QAAA,MAAQ,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8YAAQ,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAwB3D,QAAA;AACE;;;;;GAKG;AACH,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACN;;;;;GAKG;AACH,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2hBACN,CAAC;AAER,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC"}

package/dist/esm/bootstrap.js

@@ -1,20 +1,18 @@
 /**
  * Factory function for creating the main assertion functions.
  *
- * This module provides the `bootstrap()` function that creates both synchronous
- * and asynchronous assertion engines. It contains the core implementation
- * previously split between `expect.ts` and `expect-async.ts`.
+ * This module provides the {@link bootstrap} function that creates both
+ * synchronous and asynchronous assertion engines.
  *
  * @packageDocumentation
  */
-import { SyncAssertions } from './assertion/impl/sync.js';
-import { AsyncAssertions } from './assertion/index.js';
+import { AsyncAssertions, SyncAssertions } from './assertion/index.js';
 import { createUse } from './use.js';
 /**
  * Factory function that creates both synchronous and asynchronous assertion
  * engines.
  *
- * @returns Object containing `expect` and `expectAsync` functions
+ * @returns Object containing {@link expect} and {@link expectAsync} functions
  * @internal
  */
 const bootstrap = () => {
@@ -22,9 +20,20 @@ const bootstrap = () => {
     return { expect, expectAsync };
 };
 const api = bootstrap();
-/** {@inheritDoc Expect} */
-const { expect } = api;
-/** {@inheritDoc ExpectAsync} */
-const { expectAsync } = api;
+const { 
+/**
+ * The main synchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ */
+expect, 
+/**
+ * The main asynchronous assertion function which can execute only built-in
+ * assertions.
+ *
+ * @function
+ */
+expectAsync, } = api;
 export { expect, expectAsync };
 //# sourceMappingURL=bootstrap.js.map

package/dist/esm/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,GAGhB,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CACvC,cAAc,EACd,eAAe,CAChB,CAAC,CAAC,GAAG,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;IAE3C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB,2BAA2B;AAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;AACvB,gCAAgC;AAChC,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,GAGhB,EAAE;IACF,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CACvC,cAAc,EACd,eAAe,CAChB,CAAC,CAAC,GAAG,cAAc,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;IAE3C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;AAExB,MAAM;AACJ;;;;;GAKG;AACH,MAAM;AACN;;;;;GAKG;AACH,WAAW,GACZ,GAAG,GAAG,CAAC;AAER,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC"}

package/dist/esm/constant.js

@@ -21,6 +21,12 @@ export const kStringLiteral = Symbol('bupkis:string-literal');
  * @internal
  */
 export const kBupkisAssertionError = Symbol('bupkis-error');
+/**
+ * Symbol used to flag a `FailAssertionError`
+ *
+ * @internal
+ */
+export const kBupkisFailAssertionError = Symbol('bupkis-fail-error');
 /**
  * Symbol used to flag a `NegatedAssertionError`
  *

package/dist/esm/constant.js.map

@@ -1 +1 @@
-{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAE7E;;;;GAIG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAE3E;;;;GAIG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAkB,MAAM,CAC/D,sBAAsB,CACvB,CAAC"}
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAE7E;;;;GAIG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAE9B;;;;GAIG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAkB,MAAM,CAC/D,sBAAsB,CACvB,CAAC"}

package/dist/esm/error.d.ts

@@ -6,15 +6,42 @@
  * @packageDocumentation
  */
 import { AssertionError as NodeAssertionError } from 'node:assert';
-import { kBupkisAssertionError } from './constant.js';
+import { z } from 'zod/v4';
+import { type AssertionParts, type ParsedValues } from './types.js';
 /**
  * _BUPKIS_' s custom `AssertionError` class, which is just a thin wrapper
  * around Node.js' {@link NodeAssertionError AssertionError}.
- *
- * @public
  */
 export declare class AssertionError extends NodeAssertionError {
-    [kBupkisAssertionError]: boolean;
-    static isAssertionError(err: unknown): err is AssertionError;
+    name: string;
+    /**
+     * Translates a {@link z.ZodError} into an {@link AssertionError} with a
+     * human-friendly message.
+     *
+     * @remarks
+     * This does not handle parameterized assertions with more than one parameter
+     * too cleanly; it's unclear how a test runner would display the expected
+     * values. This will probably need a fix in the future.
+     * @param stackStartFn The function to start the stack trace from
+     * @param zodError The original `ZodError`
+     * @param values Values which caused the error
+     * @returns New `AssertionError`
+     */
+    static fromZodError<Parts extends AssertionParts>(zodError: z.ZodError, stackStartFn: (...args: any[]) => any, values: ParsedValues<Parts>): AssertionError;
+    /**
+     * Type guard for an instance of this error.
+     *
+     * @param value Some value
+     * @returns `true` if `value` is an instance of `AssertionError`
+     */
+    static isAssertionError(value: unknown): value is AssertionError;
+}
+/**
+ * Variant of an {@link AssertionError} that is thrown when
+ * {@link bupkis!expect.fail} is called.
+ */
+export declare class FailAssertionError extends AssertionError {
+    name: string;
+    static isFailAssertionError(err: unknown): err is FailAssertionError;
 }
 //# sourceMappingURL=error.d.ts.map

package/dist/esm/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EACL,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAGvB;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,CAAC,qBAAqB,CAAC,UAAQ;IAE/B,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc;CAK7D"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IAM3C,IAAI,SAAoB;IAEjC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,SAAS,cAAc,EAC9C,QAAQ,EAAE,CAAC,CAAC,QAAQ,EACpB,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACrC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAC1B,cAAc;IAmBjB;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc;CAMjE;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IAM3C,IAAI,SAAwB;IAErC,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,kBAAkB;CAMrE"}

package/dist/esm/error.js

@@ -6,18 +6,71 @@
  * @packageDocumentation
  */
 import { AssertionError as NodeAssertionError } from 'node:assert';
-import { kBupkisAssertionError, kBupkisNegatedAssertionError, } from './constant.js';
+import { z } from 'zod/v4';
+import { kBupkisAssertionError, kBupkisFailAssertionError, kBupkisNegatedAssertionError, } from './constant.js';
 import { isA } from './guards.js';
 /**
  * _BUPKIS_' s custom `AssertionError` class, which is just a thin wrapper
  * around Node.js' {@link NodeAssertionError AssertionError}.
- *
- * @public
  */
 export class AssertionError extends NodeAssertionError {
+    /**
+     * @internal
+     */
     [kBupkisAssertionError] = true;
-    static isAssertionError(err) {
-        return (isA(err, NodeAssertionError) && Object.hasOwn(err, kBupkisAssertionError));
+    name = 'AssertionError';
+    /**
+     * Translates a {@link z.ZodError} into an {@link AssertionError} with a
+     * human-friendly message.
+     *
+     * @remarks
+     * This does not handle parameterized assertions with more than one parameter
+     * too cleanly; it's unclear how a test runner would display the expected
+     * values. This will probably need a fix in the future.
+     * @param stackStartFn The function to start the stack trace from
+     * @param zodError The original `ZodError`
+     * @param values Values which caused the error
+     * @returns New `AssertionError`
+     */
+    static fromZodError(zodError, stackStartFn, values) {
+        const flat = z.flattenError(zodError);
+        let pretty = flat.formErrors.join('; ');
+        for (const [keypath, errors] of Object.entries(flat.fieldErrors)) {
+            pretty += `; ${keypath}: ${errors.join('; ')}`;
+        }
+        const [actual, ...expected] = values;
+        return new AssertionError({
+            actual,
+            expected: expected.length === 1 ? expected[0] : expected,
+            message: `Assertion ${this} failed: ${pretty}`,
+            operator: `${this}`,
+            stackStartFn,
+        });
+    }
+    /**
+     * Type guard for an instance of this error.
+     *
+     * @param value Some value
+     * @returns `true` if `value` is an instance of `AssertionError`
+     */
+    static isAssertionError(value) {
+        return (isA(value, NodeAssertionError) &&
+            Object.hasOwn(value, kBupkisAssertionError));
+    }
+}
+/**
+ * Variant of an {@link AssertionError} that is thrown when
+ * {@link bupkis!expect.fail} is called.
+ */
+export class FailAssertionError extends AssertionError {
+    /**
+     * @internal
+     */
+    [kBupkisFailAssertionError] = true;
+    name = 'FailAssertionError';
+    static isFailAssertionError(err) {
+        return (isA(err, FailAssertionError) &&
+            Object.hasOwn(err, kBupkisFailAssertionError));
     }
 }
 /**
@@ -27,6 +80,7 @@ export class AssertionError extends NodeAssertionError {
  */
 export class NegatedAssertionError extends AssertionError {
     [kBupkisNegatedAssertionError] = true;
+    name = 'NegatedAssertionError';
     static isNegatedAssertionError(err) {
         return (isA(err, AssertionError) &&
             Object.hasOwn(err, kBupkisNegatedAssertionError));

package/dist/esm/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IACpD,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IAE/B,MAAM,CAAC,gBAAgB,CAAC,GAAY;QAClC,OAAO,CACL,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAC1E,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,CAAC,4BAA4B,CAAC,GAAG,IAAI,CAAC;IAEtC,MAAM,CAAC,uBAAuB,CAAC,GAAY;QACzC,OAAO,CACL,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,4BAA4B,CAAC,CACjD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGlC;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IACpD;;OAEG;IACH,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IAEtB,IAAI,GAAG,gBAAgB,CAAC;IAEjC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CACjB,QAAoB,EACpB,YAAqC,EACrC,MAA2B;QAE3B,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,OAAO,KAAM,MAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,CAAC;QAED,MAAM,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,MAA4C,CAAC;QAE3E,OAAO,IAAI,cAAc,CAAC;YACxB,MAAM;YACN,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;YACxD,OAAO,EAAE,aAAa,IAAI,YAAY,MAAM,EAAE;YAC9C,QAAQ,EAAE,GAAG,IAAI,EAAE;YACnB,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAc;QACpC,OAAO,CACL,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAC5C,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD;;OAEG;IACH,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC;IAE1B,IAAI,GAAG,oBAAoB,CAAC;IAErC,MAAM,CAAC,oBAAoB,CAAC,GAAY;QACtC,OAAO,CACL,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC;YAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAC9C,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,CAAC,4BAA4B,CAAC,GAAG,IAAI,CAAC;IAE7B,IAAI,GAAG,uBAAuB,CAAC;IAExC,MAAM,CAAC,uBAAuB,CAAC,GAAY;QACzC,OAAO,CACL,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,4BAA4B,CAAC,CACjD,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/expect.d.ts

@@ -1,9 +1,136 @@
-import { type Expect, type ExpectAsync, type ExpectAsyncFunction, type ExpectAsyncProps, type ExpectFunction, type ExpectSyncProps } from './api.js';
 import { type AnyAsyncAssertions, type AnySyncAssertions } from './assertion/assertion-types.js';
+import { type Expect, type ExpectAsync, type ExpectAsyncFunction, type ExpectAsyncProps, type ExpectFunction, type ExpectSyncProps } from './types.js';
+/**
+ * Creates an asynchronous expect function by extending a parent expectAsync
+ * function with additional assertions.
+ *
+ * This overload combines assertions from an existing parent expectAsync
+ * function with new assertions, creating a unified expectAsync function that
+ * supports both sets of assertions. The resulting function inherits all type
+ * information from both the parent and new assertions, providing complete
+ * TypeScript intellisense and type safety for Promise-based testing scenarios.
+ *
+ * @example
+ *
+ * ```typescript
+ * const baseExpectAsync = createExpectAsyncFunction(basicAsyncAssertions);
+ * const extendedExpectAsync = createExpectAsyncFunction(
+ *   customAsyncAssertions,
+ *   baseExpectAsync,
+ * );
+ *
+ * // Can use both basic and custom async assertions
+ * await extendedExpectAsync(promise, 'to resolve'); // From basic assertions
+ * await extendedExpectAsync(promise, 'to resolve with custom data'); // From custom assertions
+ * ```
+ *
+ * @param assertions - Array of new asynchronous assertion objects to add
+ * @param expect - Parent expectAsync function whose assertions will be
+ *   inherited
+ * @returns ExpectAsync function with combined assertion types from both parent
+ *   and new assertions
+ * @throws {@link AssertionError} When an assertion fails in normal
+ *   (non-negated) mode
+ * @throws {@link NegatedAssertionError} When a negated assertion fails
+ * @throws {Error} When no matching assertion can be found for the provided
+ *   arguments
+ */
 export declare function createExpectAsyncFunction<T extends AnyAsyncAssertions, U extends ExpectAsync<AnyAsyncAssertions>>(assertions: T, expect: U): ExpectAsyncFunction<T & U['assertions']>;
+/**
+ * Creates a new asynchronous expect function with the provided assertions.
+ *
+ * This overload creates a standalone expectAsync function from the provided
+ * assertions without inheriting from any parent function. This is typically
+ * used to create the initial expectAsync function or when you want a clean
+ * slate without any inherited assertions for Promise-based testing.
+ *
+ * @example
+ *
+ * ```typescript
+ * const expectAsync = createExpectAsyncFunction(asyncAssertions);
+ * await expectAsync(promise, 'to resolve');
+ * await expectAsync(rejectedPromise, 'to reject');
+ * await expectAsync(promise, 'to resolve to', expectedValue);
+ * ```
+ *
+ * @param assertions - Array of asynchronous assertion objects that define the
+ *   available assertion phrases and Promise-based logic
+ * @returns An asynchronous expect function that can execute the provided
+ *   assertions using natural language syntax
+ * @throws {@link AssertionError} When an assertion fails in normal
+ *   (non-negated) mode
+ * @throws {@link NegatedAssertionError} When a negated assertion fails
+ * @throws {Error} When no matching assertion can be found for the provided
+ *   arguments
+ */
 export declare function createExpectAsyncFunction<T extends AnyAsyncAssertions>(assertions: T): ExpectAsyncFunction<T>;
-export declare function createExpectSyncFunction<T extends AnySyncAssertions, U extends Expect<AnySyncAssertions>>(assertions: T, expect: U): ExpectFunction<T & U['assertions']>;
-export declare function createExpectSyncFunction<T extends AnySyncAssertions>(assertions: T): ExpectFunction<T>;
+/**
+ * Creates a synchronous expect function by extending a parent expect function
+ * with additional assertions.
+ *
+ * This overload combines assertions from an existing parent expect function
+ * with new assertions, creating a unified expect function that supports both
+ * sets of assertions. The resulting function inherits all type information from
+ * both the parent and new assertions, providing complete TypeScript
+ * intellisense and type safety.
+ *
+ * @example
+ *
+ * ```typescript
+ * const baseExpect = createExpectSyncFunction(basicAssertions);
+ * const extendedExpect = createExpectSyncFunction(
+ *   customAssertions,
+ *   baseExpect,
+ * );
+ *
+ * // Can use both basic and custom assertions
+ * extendedExpect(42, 'to be a number'); // From basic assertions
+ * extendedExpect(obj, 'to have custom prop'); // From custom assertions
+ * ```
+ *
+ * @param assertions - Array of new synchronous assertion objects to add
+ * @param expect - Parent expect function whose assertions will be inherited
+ * @returns Expect function with combined assertion types from both parent and
+ *   new assertions
+ * @throws {@link AssertionError} When an assertion fails in normal
+ *   (non-negated) mode
+ * @throws {@link NegatedAssertionError} When a negated assertion fails
+ * @throws {Error} When no matching assertion can be found for the provided
+ *   arguments
+ */
+export declare function createExpectSyncFunction<Assertions extends AnySyncAssertions, ParentExpect extends Expect<AnySyncAssertions>>(assertions: Assertions, expect: ParentExpect): ExpectFunction<Assertions & ParentExpect['assertions']>;
+/**
+ * Creates a new synchronous expect function with the provided assertions.
+ *
+ * This overload creates a standalone expect function from the provided
+ * assertions without inheriting from any parent function. This is typically
+ * used to create the initial expect function or when you want a clean slate
+ * without any inherited assertions.
+ *
+ * @example
+ *
+ * ```typescript
+ * const expect = createExpectSyncFunction(basicAssertions);
+ * expect(42, 'to be a number');
+ * expect('hello', 'to be a string');
+ * expect([], 'to be empty');
+ * ```
+ *
+ * @param assertions - Array of synchronous assertion objects that define the
+ *   available assertion phrases and logic
+ * @returns A synchronous expect function that can execute the provided
+ *   assertions using natural language syntax
+ * @throws {@link AssertionError} When an assertion fails in normal
+ *   (non-negated) mode
+ * @throws {@link NegatedAssertionError} When a negated assertion fails
+ * @throws {Error} When no matching assertion can be found for the provided
+ *   arguments
+ */
+export declare function createExpectSyncFunction<Assertions extends AnySyncAssertions>(assertions: Assertions): ExpectFunction<Assertions>;
+/**
+ * Used by a {@link UseFn} to create base properties of the {@link Expect} and
+ * {@link ExpectAsync} functions.
+ */
 export declare function createBaseExpect<T extends AnySyncAssertions, U extends AnyAsyncAssertions>(syncAssertions: T, asyncAssertions: U, type: 'sync'): ExpectSyncProps<T, U>;
 export declare function createBaseExpect<T extends AnySyncAssertions, U extends AnyAsyncAssertions>(syncAssertions: T, asyncAssertions: U, type: 'async'): ExpectAsyncProps<U, T>;
 //# sourceMappingURL=expect.d.ts.map

package/dist/esm/expect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EASvB,MAAM,gCAAgC,CAAC;AAQxC,wBAAgB,yBAAyB,CACvC,CAAC,SAAS,kBAAkB,EAC5B,CAAC,SAAS,WAAW,CAAC,kBAAkB,CAAC,EACzC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AACtE,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,kBAAkB,EACpE,UAAU,EAAE,CAAC,GACZ,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAmD1B,wBAAgB,wBAAwB,CACtC,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,MAAM,CAAC,iBAAiB,CAAC,EACnC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAEjE,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,iBAAiB,EAClE,UAAU,EAAE,CAAC,GACZ,cAAc,CAAC,CAAC,CAAC,CAAC;AAgPrB,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,kBAAkB,EAC5B,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9E,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,kBAAkB,EAC5B,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EASvB,MAAM,gCAAgC,CAAC;AAQxC,OAAO,EACL,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EAIrB,MAAM,YAAY,CAAC;AAKpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CACvC,CAAC,SAAS,kBAAkB,EAC5B,CAAC,SAAS,WAAW,CAAC,kBAAkB,CAAC,EACzC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,kBAAkB,EACpE,UAAU,EAAE,CAAC,GACZ,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAkH1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,SAAS,iBAAiB,EACpC,YAAY,SAAS,MAAM,CAAC,iBAAiB,CAAC,EAE9C,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,GACnB,cAAc,CAAC,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,SAAS,iBAAiB,EAC3E,UAAU,EAAE,UAAU,GACrB,cAAc,CAAC,UAAU,CAAC,CAAC;AAsS9B;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,kBAAkB,EAC5B,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9E,wBAAgB,gBAAgB,CAC9B,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,kBAAkB,EAC5B,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/esm/expect.js

@@ -1,10 +1,72 @@
 import Debug from 'debug';
 import { inspect } from 'util';
 import { createAssertion, createAsyncAssertion } from './assertion/create.js';
-import { AssertionError, NegatedAssertionError } from './error.js';
+import { AssertionError, FailAssertionError, NegatedAssertionError, } from './error.js';
 import { isAssertionFailure, isString } from './guards.js';
 import { createUse } from './use.js';
 const debug = Debug('bupkis:expect');
+/**
+ * Implementation function that creates an asynchronous expect function with
+ * optional parent inheritance.
+ *
+ * This is the concrete implementation that handles both overload cases for
+ * Promise-based assertions. It creates an expectAsync function that uses a
+ * two-phase matching algorithm: first seeking exact phrase matches for optimal
+ * performance, then falling back to partial matches if needed. The function
+ * processes negation keywords, combines parent assertions with new ones, and
+ * ensures all operations are properly awaited.
+ *
+ * The matching algorithm prioritizes exact matches to minimize performance
+ * overhead, but provides flexibility through partial matching when exact
+ * phrases don't align. This enables natural language flexibility while
+ * maintaining execution speed for common async assertion patterns.
+ *
+ * @remarks
+ * The function performs async assertion matching in the following order:
+ *
+ * 1. Awaits `Promise.resolve()` to ensure the function is always asynchronous
+ * 2. Processes negation keywords ('not', 'to not') to determine assertion mode
+ * 3. Combines parent assertions (if provided) with new assertions in execution
+ *    order
+ * 4. Attempts to parse arguments against each assertion's expected phrase pattern
+ *    using `parseValuesAsync`
+ * 5. Prioritizes exact phrase matches over partial matches for performance
+ * 6. Executes the first successful match using {@link executeAsync} or throws an
+ *    error if none found
+ *
+ * Performance considerations: The function loops through all available
+ * assertions for each call, but uses early termination when exact matches are
+ * found. For performance-critical code, consider using assertion functions with
+ * fewer total assertions or more specific phrase patterns to reduce matching
+ * overhead.
+ *
+ * All assertion execution is properly awaited to handle Promise-based
+ * validation logic, error handling, and negation scenarios in asynchronous
+ * contexts.
+ * @example
+ *
+ * ```typescript
+ * // Used internally by both public overloads
+ * const expectAsync1 = createExpectAsyncFunction(assertions); // No parent
+ * const expectAsync2 = createExpectAsyncFunction(assertions, parent); // With parent
+ * ```
+ *
+ * @param assertions - Array of asynchronous assertion objects to make available
+ * @param expect - Optional parent expectAsync function to inherit assertions
+ *   from
+ * @returns Asynchronous expect function that processes natural language
+ *   assertions with Promise support
+ * @throws {@link AssertionError} When an assertion fails in normal
+ *   (non-negated) mode
+ * @throws {@link NegatedAssertionError} When a negated assertion fails (e.g.,
+ *   `await expectAsync(promise, 'not to resolve')`)
+ * @throws {Error} When no matching assertion can be found for the provided
+ *   arguments
+ * @internal This is the concrete implementation used by the public overloads
+ * @see {@link createExpectSyncFunction} for creating synchronous expect functions
+ * @see {@link createAsyncAssertion} for creating individual async assertion objects
+ * @see {@link ExpectAsync} for the main expectAsync interface
+ */
 export function createExpectAsyncFunction(assertions, expect) {
     debug('Creating expectAsync function with %d assertions', assertions.length + (expect?.assertions.length ?? 0));
     const expectAsyncFunction = async (...args) => {
@@ -31,6 +93,59 @@ export function createExpectAsyncFunction(assertions, expect) {
     };
     return expectAsyncFunction;
 }
+/**
+ * Implementation function that creates a synchronous expect function with
+ * optional parent inheritance.
+ *
+ * This is the concrete implementation that handles both overload cases. It
+ * creates an expect function that uses a two-phase matching algorithm: first
+ * seeking exact phrase matches for optimal performance, then falling back to
+ * partial matches if needed. The function processes negation keywords and
+ * combines parent assertions with new ones.
+ *
+ * The matching algorithm prioritizes exact matches to minimize performance
+ * overhead, but provides flexibility through partial matching when exact
+ * phrases don't align. This enables natural language flexibility while
+ * maintaining execution speed for common assertion patterns.
+ *
+ * @remarks
+ * The function performs assertion matching in the following order:
+ *
+ * 1. Processes negation keywords ('not', 'to not') to determine assertion mode
+ * 2. Combines parent assertions (if provided) with new assertions in execution
+ *    order
+ * 3. Attempts to parse arguments against each assertion's expected phrase pattern
+ * 4. Prioritizes exact phrase matches over partial matches for performance
+ * 5. Executes the first successful match or throws an error if none found
+ *
+ * Performance considerations: The function loops through all available
+ * assertions for each call, but uses early termination when exact matches are
+ * found. For performance-critical code, consider using assertion functions with
+ * fewer total assertions or more specific phrase patterns to reduce matching
+ * overhead.
+ * @example
+ *
+ * ```typescript
+ * // Used internally by both public overloads
+ * const expect1 = createExpectSyncFunction(assertions); // No parent
+ * const expect2 = createExpectSyncFunction(assertions, parent); // With parent
+ * ```
+ *
+ * @param assertions - Array of synchronous assertion objects to make available
+ * @param expect - Optional parent expect function to inherit assertions from
+ * @returns Synchronous expect function that processes natural language
+ *   assertions
+ * @throws {@link AssertionError} When an assertion fails in normal
+ *   (non-negated) mode
+ * @throws {@link NegatedAssertionError} When a negated assertion fails (e.g.,
+ *   `expect(42, 'not to be a number')`)
+ * @throws {Error} When no matching assertion can be found for the provided
+ *   arguments
+ * @internal This is the concrete implementation used by the public overloads
+ * @see {@link createExpectAsyncFunction} for creating asynchronous expect functions
+ * @see {@link createAssertion} for creating individual assertion objects
+ * @see {@link Expect} for the main expect interface
+ */
 export function createExpectSyncFunction(assertions, expect) {
     debug('Creating expect function with %d assertions', assertions.length + (expect?.assertions.length ?? 0));
     const expectFunction = (...args) => {
@@ -188,7 +303,7 @@ const detectNegation = (phrase) => {
     };
 };
 const fail = (reason) => {
-    throw new AssertionError({ message: reason });
+    throw new FailAssertionError({ message: reason });
 };
 export function createBaseExpect(syncAssertions, asyncAssertions, type) {
     return type === 'sync'

package/dist/esm/expect.js.map

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