@goast/kotlin 0.4.7-beta2 → 0.4.8

package/script/deps/jsr.io/@std/testing/1.0.6/mock.d.ts

@@ -0,0 +1,674 @@
+/**
+ * An error related to spying on a function or instance method.
+ *
+ * @example Usage
+ * ```ts
+ * import { MockError, spy } from "@std/testing/mock";
+ * import { assertThrows } from "@std/assert";
+ *
+ * assertThrows(() => {
+ *   spy({} as any, "no-such-method");
+ * }, MockError);
+ * ```
+ */
+export declare class MockError extends Error {
+    /**
+     * Construct MockError
+     *
+     * @param message The error message.
+     */
+    constructor(message: string);
+}
+/** Call information recorded by a spy. */
+export interface SpyCall<Self = any, Args extends unknown[] = any[], Return = any> {
+    /** Arguments passed to a function when called. */
+    args: Args;
+    /** The value that was returned by a function. */
+    returned?: Return;
+    /** The error value that was thrown by a function. */
+    error?: Error;
+    /** The instance that a method was called on. */
+    self?: Self;
+}
+/** A function or instance method wrapper that records all calls made to it. */
+export interface Spy<Self = any, Args extends unknown[] = any[], Return = any> {
+    (this: Self, ...args: Args): Return;
+    /** The function that is being spied on. */
+    original: (this: Self, ...args: Args) => Return;
+    /** Information about calls made to the function or instance method. */
+    calls: SpyCall<Self, Args, Return>[];
+    /** Whether or not the original instance method has been restored. */
+    restored: boolean;
+    /** If spying on an instance method, this restores the original instance method. */
+    restore(): void;
+}
+/** An instance method wrapper that records all calls made to it. */
+export interface MethodSpy<Self = any, Args extends unknown[] = any[], Return = any> extends Spy<Self, Args, Return>, Disposable {
+}
+/**
+ * Creates a session that tracks all mocks created before it's restored.
+ * If a callback is provided, it restores all mocks created within it.
+ *
+ * @example Usage
+ * ```ts
+ * import { mockSession, restore, stub } from "@std/testing/mock";
+ * import { assertEquals, assertNotEquals } from "@std/assert";
+ *
+ * const setTimeout = globalThis.setTimeout;
+ * const id = mockSession();
+ *
+ * stub(globalThis, "setTimeout");
+ *
+ * assertNotEquals(globalThis.setTimeout, setTimeout);
+ *
+ * restore(id);
+ *
+ * assertEquals(globalThis.setTimeout, setTimeout);
+ * ```
+ *
+ * @returns The id of the created session.
+ */
+export declare function mockSession(): number;
+/**
+ * Creates a session that tracks all mocks created before it's restored.
+ * If a callback is provided, it restores all mocks created within it.
+ *
+ * @example Usage
+ * ```ts
+ * import { mockSession, restore, stub } from "@std/testing/mock";
+ * import { assertEquals, assertNotEquals } from "@std/assert";
+ *
+ * const setTimeout = globalThis.setTimeout;
+ * const session = mockSession(() => {
+ *   stub(globalThis, "setTimeout");
+ *   assertNotEquals(globalThis.setTimeout, setTimeout);
+ * });
+ *
+ * session();
+ *
+ * assertEquals(globalThis.setTimeout, setTimeout); // stub is restored
+ * ```
+ *
+ * @typeParam Self The self type of the function.
+ * @typeParam Args The arguments type of the function.
+ * @typeParam Return The return type of the function.
+ * @param func The function to be used for the created session.
+ * @returns The function to execute the session.
+ */
+export declare function mockSession<Self, Args extends unknown[], Return>(func: (this: Self, ...args: Args) => Return): (this: Self, ...args: Args) => Return;
+/**
+ * Creates an async session that tracks all mocks created before the promise resolves.
+ *
+ * @example Usage
+ * ```ts
+ * import { mockSessionAsync, restore, stub } from "@std/testing/mock";
+ * import { assertEquals, assertNotEquals } from "@std/assert";
+ *
+ * const setTimeout = globalThis.setTimeout;
+ * const session = mockSessionAsync(async () => {
+ *   stub(globalThis, "setTimeout");
+ *   assertNotEquals(globalThis.setTimeout, setTimeout);
+ * });
+ *
+ * await session();
+ *
+ * assertEquals(globalThis.setTimeout, setTimeout); // stub is restored
+ * ```
+ * @typeParam Self The self type of the function.
+ * @typeParam Args The arguments type of the function.
+ * @typeParam Return The return type of the function.
+ * @param func The function.
+ * @returns The return value of the function.
+ */
+export declare function mockSessionAsync<Self, Args extends unknown[], Return>(func: (this: Self, ...args: Args) => Promise<Return>): (this: Self, ...args: Args) => Promise<Return>;
+/**
+ * Restores all mocks registered in the current session that have not already been restored.
+ * If an id is provided, it will restore all mocks registered in the session associed with that id that have not already been restored.
+ *
+ * @example Usage
+ * ```ts
+ * import { mockSession, restore, stub } from "@std/testing/mock";
+ * import { assertEquals, assertNotEquals } from "@std/assert";
+ *
+ * const setTimeout = globalThis.setTimeout;
+ *
+ * stub(globalThis, "setTimeout");
+ *
+ * assertNotEquals(globalThis.setTimeout, setTimeout);
+ *
+ * restore();
+ *
+ * assertEquals(globalThis.setTimeout, setTimeout);
+ * ```
+ *
+ * @param id The id of the session to restore. If not provided, all mocks registered in the current session are restored.
+ */
+export declare function restore(id?: number): void;
+/** A constructor wrapper that records all calls made to it. */
+export interface ConstructorSpy<Self = any, Args extends unknown[] = any[]> {
+    /** Construct an instance. */
+    new (...args: Args): Self;
+    /** The function that is being spied on. */
+    original: new (...args: Args) => Self;
+    /** Information about calls made to the function or instance method. */
+    calls: SpyCall<Self, Args, Self>[];
+    /** Whether or not the original instance method has been restored. */
+    restored: boolean;
+    /** If spying on an instance method, this restores the original instance method. */
+    restore(): void;
+}
+/**
+ * Utility for extracting the arguments type from a property
+ *
+ * @internal
+ */
+export type GetParametersFromProp<Self, Prop extends keyof Self> = Self[Prop] extends (...args: infer Args) => unknown ? Args : unknown[];
+/**
+ * Utility for extracting the return type from a property
+ *
+ * @internal
+ */
+export type GetReturnFromProp<Self, Prop extends keyof Self> = Self[Prop] extends (...args: any[]) => infer Return ? Return : unknown;
+/** SpyLink object type. */
+export type SpyLike<Self = any, Args extends unknown[] = any[], Return = any> = Spy<Self, Args, Return> | ConstructorSpy<Self, Args>;
+/** Creates a spy function.
+ *
+ * @example Usage
+ * ```ts
+ * import {
+ *   assertSpyCall,
+ *   assertSpyCalls,
+ *   spy,
+ * } from "@std/testing/mock";
+ *
+ * const func = spy();
+ *
+ * func();
+ * func(1);
+ * func(2, 3);
+ *
+ * assertSpyCalls(func, 3);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCall(func, 0, { args: [] });
+ * assertSpyCall(func, 1, { args: [1] });
+ * assertSpyCall(func, 2, { args: [2, 3] });
+ * ```
+ *
+ * @typeParam Self The self type of the function.
+ * @typeParam Args The arguments type of the function.
+ * @typeParam Return The return type of the function.
+ * @returns The spy function.
+ */
+export declare function spy<Self = any, Args extends unknown[] = any[], Return = undefined>(): Spy<Self, Args, Return>;
+/**
+ * Create a spy function with the given implementation.
+ *
+ * @example Usage
+ * ```ts
+ * import {
+ *   assertSpyCall,
+ *   assertSpyCalls,
+ *   spy,
+ * } from "@std/testing/mock";
+ *
+ * const func = spy((a: number, b: number) => a + b);
+ *
+ * func(3, 4);
+ * func(5, 6);
+ *
+ * assertSpyCalls(func, 2);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCall(func, 0, { args: [3, 4], returned: 7 });
+ * assertSpyCall(func, 1, { args: [5, 6], returned: 11 });
+ * ```
+ *
+ * @typeParam Self The self type of the function to wrap
+ * @typeParam Args The arguments type of the function to wrap
+ * @typeParam Return The return type of the function to wrap
+ * @param func The function to wrap
+ * @returns The wrapped function.
+ */
+export declare function spy<Self, Args extends unknown[], Return>(func: (this: Self, ...args: Args) => Return): Spy<Self, Args, Return>;
+/**
+ * Create a spy constructor.
+ *
+ * @example Usage
+ * ```ts
+ * import {
+ *   assertSpyCall,
+ *   assertSpyCalls,
+ *   spy,
+ * } from "@std/testing/mock";
+ *
+ * class Foo {
+ *   constructor(value: string) {}
+ * };
+ *
+ * const Constructor = spy(Foo);
+ *
+ * new Constructor("foo");
+ * new Constructor("bar");
+ *
+ * assertSpyCalls(Constructor, 2);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCall(Constructor, 0, { args: ["foo"] });
+ * assertSpyCall(Constructor, 1, { args: ["bar"] });
+ * ```
+ *
+ * @typeParam Self The type of the instance of the class.
+ * @typeParam Args The arguments type of the constructor
+ * @param constructor The constructor to spy.
+ * @returns The wrapped constructor.
+ */
+export declare function spy<Self, Args extends unknown[]>(constructor: new (...args: Args) => Self): ConstructorSpy<Self, Args>;
+/**
+ * Wraps a instance method with a Spy.
+ *
+ * @example Usage
+ * ```ts
+ * import {
+ *   assertSpyCall,
+ *   assertSpyCalls,
+ *   spy,
+ * } from "@std/testing/mock";
+ *
+ * const obj = {
+ *   method(a: number, b: number): number {
+ *     return a + b;
+ *   },
+ * };
+ *
+ * const methodSpy = spy(obj, "method");
+ *
+ * obj.method(1, 2);
+ * obj.method(3, 4);
+ *
+ * assertSpyCalls(methodSpy, 2);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCall(methodSpy, 0, { args: [1, 2], returned: 3 });
+ * assertSpyCall(methodSpy, 1, { args: [3, 4], returned: 7 });
+ * ```
+ *
+ * @typeParam Self The type of the instance to spy the method of.
+ * @typeParam Prop The property to spy.
+ * @param self The instance to spy.
+ * @param property The property of the method to spy.
+ * @returns The spy function.
+ */
+export declare function spy<Self, Prop extends keyof Self>(self: Self, property: Prop): MethodSpy<Self, GetParametersFromProp<Self, Prop>, GetReturnFromProp<Self, Prop>>;
+/** An instance method replacement that records all calls made to it. */
+export interface Stub<Self = any, Args extends unknown[] = any[], Return = any> extends MethodSpy<Self, Args, Return> {
+    /** The function that is used instead of the original. */
+    fake: (this: Self, ...args: Args) => Return;
+}
+/**
+ * Replaces an instance method with a Stub with empty implementation.
+ *
+ * @example Usage
+ * ```ts
+ * import { stub, assertSpyCalls } from "@std/testing/mock";
+ *
+ * const obj = {
+ *   method() {
+ *     // some inconventient feature for testing
+ *   },
+ * };
+ *
+ * const methodStub = stub(obj, "method");
+ *
+ * for (const _ of Array(5)) {
+ *   obj.method();
+ * }
+ *
+ * assertSpyCalls(methodStub, 5);
+ * ```
+
+ *
+ * @typeParam Self The self type of the instance to replace a method of.
+ * @typeParam Prop The property of the instance to replace.
+ * @param self The instance to replace a method of.
+ * @param property The property of the instance to replace.
+ * @returns The stub function which replaced the original.
+ */
+export declare function stub<Self, Prop extends keyof Self>(self: Self, property: Prop): Stub<Self, GetParametersFromProp<Self, Prop>, GetReturnFromProp<Self, Prop>>;
+/**
+ * Replaces an instance method with a Stub with the given implementation.
+ *
+ * @example Usage
+ * ```ts
+ * import { stub } from "@std/testing/mock";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const obj = {
+ *   method(): number {
+ *     return Math.random();
+ *   },
+ * };
+ *
+ * const methodStub = stub(obj, "method", () => 0.5);
+ *
+ * assertEquals(obj.method(), 0.5);
+ * ```
+ *
+ * @typeParam Self The self type of the instance to replace a method of.
+ * @typeParam Prop The property of the instance to replace.
+ * @param self The instance to replace a method of.
+ * @param property The property of the instance to replace.
+ * @param func The fake implementation of the function.
+ * @returns The stub function which replaced the original.
+ */
+export declare function stub<Self, Prop extends keyof Self>(self: Self, property: Prop, func: (this: Self, ...args: GetParametersFromProp<Self, Prop>) => GetReturnFromProp<Self, Prop>): Stub<Self, GetParametersFromProp<Self, Prop>, GetReturnFromProp<Self, Prop>>;
+/**
+ * Asserts that a spy is called as much as expected and no more.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCalls, spy } from "@std/testing/mock";
+ *
+ * const func = spy();
+ *
+ * func();
+ * func();
+ *
+ * assertSpyCalls(func, 2);
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @param spy The spy to check
+ * @param expectedCalls The number of the expected calls.
+ */
+export declare function assertSpyCalls<Self, Args extends unknown[], Return>(spy: SpyLike<Self, Args, Return>, expectedCalls: number): void;
+/** Call information recorded by a spy. */
+export interface ExpectedSpyCall<Self = any, Args extends unknown[] = any[], Return = any> {
+    /** Arguments passed to a function when called. */
+    args?: [...Args, ...unknown[]];
+    /** The instance that a method was called on. */
+    self?: Self;
+    /**
+     * The value that was returned by a function.
+     * If you expect a promise to reject, expect error instead.
+     */
+    returned?: Return;
+    /** The expected thrown error. */
+    error?: {
+        /** The class for the error that was thrown by a function. */
+        Class?: new (...args: any[]) => Error;
+        /** Part of the message for the error that was thrown by a function. */
+        msgIncludes?: string;
+    };
+}
+/**
+ * Asserts that a spy is called as expected.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCall, spy } from "@std/testing/mock";
+ *
+ * const func = spy((a: number, b: number) => a + b);
+ *
+ * func(3, 4);
+ * func(5, 6);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCall(func, 0, { args: [3, 4], returned: 7 });
+ * assertSpyCall(func, 1, { args: [5, 6], returned: 11 });
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @param spy The spy to check
+ * @param callIndex The index of the call to check
+ * @param expected The expected spy call.
+ */
+export declare function assertSpyCall<Self, Args extends unknown[], Return>(spy: SpyLike<Self, Args, Return>, callIndex: number, expected?: ExpectedSpyCall<Self, Args, Return>): void;
+/**
+ * Asserts that an async spy is called as expected.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCallAsync, spy } from "@std/testing/mock";
+ *
+ * const func = spy((a: number, b: number) => new Promise((resolve) => {
+ *   setTimeout(() => resolve(a + b), 100)
+ * }));
+ *
+ * await func(3, 4);
+ * await func(5, 6);
+ *
+ * // asserts each call made to the spy function.
+ * await assertSpyCallAsync(func, 0, { args: [3, 4], returned: 7 });
+ * await assertSpyCallAsync(func, 1, { args: [5, 6], returned: 11 });
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @param spy The spy to check
+ * @param callIndex The index of the call to check
+ * @param expected The expected spy call.
+ */
+export declare function assertSpyCallAsync<Self, Args extends unknown[], Return>(spy: SpyLike<Self, Args, Promise<Return>>, callIndex: number, expected?: ExpectedSpyCall<Self, Args, Promise<Return> | Return>): Promise<void>;
+/**
+ * Asserts that a spy is called with a specific arg as expected.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCallArg, spy } from "@std/testing/mock";
+ *
+ * const func = spy((a: number, b: number) => a + b);
+ *
+ * func(3, 4);
+ * func(5, 6);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCallArg(func, 0, 0, 3);
+ * assertSpyCallArg(func, 0, 1, 4);
+ * assertSpyCallArg(func, 1, 0, 5);
+ * assertSpyCallArg(func, 1, 1, 6);
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @typeParam ExpectedArg The expected type of the argument for the spy to be called.
+ * @param spy The spy to check.
+ * @param callIndex The index of the call to check.
+ * @param argIndex The index of the arguments to check.
+ * @param expected The expected argument.
+ * @returns The actual argument.
+ */
+export declare function assertSpyCallArg<Self, Args extends unknown[], Return, ExpectedArg>(spy: SpyLike<Self, Args, Return>, callIndex: number, argIndex: number, expected: ExpectedArg): ExpectedArg;
+/**
+ * Asserts that an spy is called with a specific range of args as expected.
+ * If a start and end index is not provided, the expected will be compared against all args.
+ * If a start is provided without an end index, the expected will be compared against all args from the start index to the end.
+ * The end index is not included in the range of args that are compared.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCallArgs, spy } from "@std/testing/mock";
+ *
+ * const func = spy((a: number, b: number) => a + b);
+ *
+ * func(3, 4);
+ * func(5, 6);
+ *
+ * // asserts each call made to the spy function.
+ * assertSpyCallArgs(func, 0, [3, 4]);
+ * assertSpyCallArgs(func, 1, [5, 6]);
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @typeParam ExpectedArgs The expected type of the arguments for the spy to be called.
+ * @param spy The spy to check.
+ * @param callIndex The index of the call to check.
+ * @param expected The expected arguments.
+ * @returns The actual arguments.
+ */
+export declare function assertSpyCallArgs<Self, Args extends unknown[], Return, ExpectedArgs extends unknown[]>(spy: SpyLike<Self, Args, Return>, callIndex: number, expected: ExpectedArgs): ExpectedArgs;
+/**
+ * Asserts that an spy is called with a specific range of args as expected.
+ * If a start and end index is not provided, the expected will be compared against all args.
+ * If a start is provided without an end index, the expected will be compared against all args from the start index to the end.
+ * The end index is not included in the range of args that are compared.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCallArgs, spy } from "@std/testing/mock";
+ *
+ * const func = spy((...args) => {});
+ *
+ * func(0, 1, 2, 3, 4, 5);
+ *
+ * assertSpyCallArgs(func, 0, 3, [3, 4, 5]);
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @typeParam ExpectedArgs The expected type of the arguments for the spy to be called.
+ * @param spy The spy to check.
+ * @param callIndex The index of the call to check.
+ * @param argsStart The start index of the arguments to check. If not specified, it checks the arguments from the beignning.
+ * @param expected The expected arguments.
+ * @returns The actual arguments.
+ */
+export declare function assertSpyCallArgs<Self, Args extends unknown[], Return, ExpectedArgs extends unknown[]>(spy: SpyLike<Self, Args, Return>, callIndex: number, argsStart: number, expected: ExpectedArgs): ExpectedArgs;
+/**
+ * Asserts that an spy is called with a specific range of args as expected.
+ * If a start and end index is not provided, the expected will be compared against all args.
+ * If a start is provided without an end index, the expected will be compared against all args from the start index to the end.
+ * The end index is not included in the range of args that are compared.
+ *
+ * @example Usage
+ * ```ts
+ * import { assertSpyCallArgs, spy } from "@std/testing/mock";
+ *
+ * const func = spy((...args) => {});
+ *
+ * func(0, 1, 2, 3, 4, 5);
+ *
+ * assertSpyCallArgs(func, 0, 3, 4, [3]);
+ * ```
+ *
+ * @typeParam Self The self type of the spy function.
+ * @typeParam Args The arguments type of the spy function.
+ * @typeParam Return The return type of the spy function.
+ * @typeParam ExpectedArgs The expected type of the arguments for the spy to be called.
+ * @param spy The spy to check
+ * @param callIndex The index of the call to check
+ * @param argsStart The start index of the arguments to check. If not specified, it checks the arguments from the beignning.
+ * @param argsEnd The end index of the arguments to check. If not specified, it checks the arguments until the end.
+ * @param expected The expected arguments.
+ * @returns The actual arguments
+ */
+export declare function assertSpyCallArgs<Self, Args extends unknown[], Return, ExpectedArgs extends unknown[]>(spy: SpyLike<Self, Args, Return>, callIndex: number, argsStart: number, argsEnd: number, expected: ExpectedArgs): ExpectedArgs;
+/**
+ * Creates a function that returns the instance the method was called on.
+ *
+ * @example Usage
+ * ```ts
+ * import { returnsThis } from "@std/testing/mock";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const func = returnsThis();
+ * const obj = { func };
+ * assertEquals(obj.func(), obj);
+ * ```
+ *
+ * @typeParam Self The self type of the returned function.
+ * @typeParam Args The arguments type of the returned function.
+ * @returns A function that returns the instance the method was called on.
+ */
+export declare function returnsThis<Self = any, Args extends unknown[] = any[]>(): (this: Self, ...args: Args) => Self;
+/**
+ * Creates a function that returns one of its arguments.
+ *
+ * @example Usage
+ * ```ts
+ * import { returnsArg } from "@std/testing/mock";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const func = returnsArg(1);
+ * assertEquals(func(1, 2, 3), 2);
+ * ```
+ *
+ * @typeParam Arg The type of returned argument.
+ * @typeParam Self The self type of the returned function.
+ * @param idx The index of the arguments to use.
+ * @returns A function that returns one of its arguments.
+ */
+export declare function returnsArg<Arg, Self = any>(idx: number): (this: Self, ...args: Arg[]) => Arg | undefined;
+/**
+ * Creates a function that returns its arguments or a subset of them. If end is specified, it will return arguments up to but not including the end.
+ *
+ * @example Usage
+ * ```ts
+ * import { returnsArgs } from "@std/testing/mock";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const func = returnsArgs();
+ * assertEquals(func(1, 2, 3), [1, 2, 3]);
+ * ```
+ *
+ * @typeParam Args The arguments type of the returned function
+ * @typeParam Self The self type of the returned function
+ * @param start The start index of the arguments to return. Default is 0.
+ * @param end The end index of the arguments to return.
+ * @returns A function that returns its arguments or a subset of them.
+ */
+export declare function returnsArgs<Args extends unknown[], Self = any>(start?: number, end?: number): (this: Self, ...args: Args) => Args;
+/**
+ * Creates a function that returns the iterable values. Any iterable values that are errors will be thrown.
+ *
+ * @example Usage
+ * ```ts
+ * import { returnsNext } from "@std/testing/mock";
+ * import { assertEquals, assertThrows } from "@std/assert";
+ *
+ * const func = returnsNext([1, 2, new Error("foo"), 3]);
+ * assertEquals(func(), 1);
+ * assertEquals(func(), 2);
+ * assertThrows(() => func(), Error, "foo");
+ * assertEquals(func(), 3);
+ * ```
+ *
+ * @typeParam Return The type of each item of the iterable
+ * @typeParam Self The self type of the returned function
+ * @typeParam Args The arguments type of the returned function
+ * @param values The iterable values
+ * @return A function that returns the iterable values
+ */
+export declare function returnsNext<Return, Self = any, Args extends unknown[] = any[]>(values: Iterable<Return | Error>): (this: Self, ...args: Args) => Return;
+/**
+ * Creates a function that resolves the awaited iterable values. Any awaited iterable values that are errors will be thrown.
+ *
+ * @example Usage
+ * ```ts
+ * import { resolvesNext } from "@std/testing/mock";
+ * import { assertEquals, assertRejects } from "@std/assert";
+ *
+ * const func = resolvesNext([1, 2, new Error("foo"), 3]);
+ * assertEquals(await func(), 1);
+ * assertEquals(await func(), 2);
+ * assertRejects(() => func(), Error, "foo");
+ * assertEquals(await func(), 3);
+ * ```
+ *
+ * @typeParam Return The type of each item of the iterable
+ * @typeParam Self The self type of the returned function
+ * @typeParam Args The type of arguments of the returned function
+ * @param iterable The iterable to use
+ * @returns A function that resolves the awaited iterable values
+ */
+export declare function resolvesNext<Return, Self = any, Args extends unknown[] = any[]>(iterable: Iterable<Return | Error | Promise<Return | Error>> | AsyncIterable<Return | Error | Promise<Return | Error>>): (this: Self, ...args: Args) => Promise<Return>;
+//# sourceMappingURL=mock.d.ts.map

package/script/deps/jsr.io/@std/testing/1.0.6/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/testing/1.0.6/mock.ts"],"names":[],"mappings":"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"}