import { MockInstance } from "vitest";
//#region src/vitest/mocks/iconv.d.ts
type IconvResolver = (method: string, args: unknown[]) => unknown;
type IconvMethod = "convert" | "convertBuffer" | "decode" | "encode" | "encodings";
interface IconvCall {
  method: IconvMethod;
  args: unknown[];
}
type ConversionResult = string | Uint8Array;
type ConvertMockProcedure = (input: string | Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: string) => ConversionResult;
type ConvertBufferMockProcedure = (input: Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: string) => ConversionResult;
type EncodeMockProcedure = (input: string, encoding: string) => ConversionResult;
type TypedOperationMock<RuntimeProcedure, MockProcedure extends (...args: never[]) => unknown> = RuntimeProcedure & MockInstance<MockProcedure>;
/** Controls how unconfigured Iconv operations are handled. */
export interface MockIconvOptions {
  /** Return an empty type-compatible value or throw when no behavior is configured. */
  onUnhandled?: "fallback" | "error";
}
/**
 * Acquire a disposable mock for `tailor.iconv`. Restored on dispose.
 * @param options - Fallback behavior for unconfigured operations
 * @returns Disposable Iconv mock control object
 * @example
 * ```typescript
 * import { mockIconv } from "@tailor-platform/sdk/vitest";
 *
 * test("mock encoding conversion", () => {
 *   using iconv = mockIconv();
 *   iconv.decode.mockReturnValue("decoded-text");
 *   // …
 * });
 * ```
 */
export declare function mockIconv(options?: MockIconvOptions): {
  /** The `convert` `vi.fn`. */
  convert: TypedOperationMock<(<T extends string>(str: string | Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: T) => T extends "UTF8" | "UTF-8" ? string : Uint8Array), ConvertMockProcedure>;
  /** The `convertBuffer` `vi.fn`. */
  convertBuffer: TypedOperationMock<(<T extends string>(buffer: Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: T) => T extends "UTF8" | "UTF-8" ? string : Uint8Array), ConvertBufferMockProcedure>;
  /** The `decode` `vi.fn`. */
  decode: import("vitest").Mock<(input: Uint8Array | ArrayBuffer, encoding: string) => string>;
  /** The `encode` `vi.fn`. */
  encode: TypedOperationMock<(<T extends string>(str: string, encoding: T) => T extends "UTF8" | "UTF-8" ? string : Uint8Array), EncodeMockProcedure>;
  /** The `encodings` `vi.fn`. */
  encodings: import("vitest").Mock<() => string[]>;
  setResolver(value: IconvResolver): void;
  readonly calls: IconvCall[];
  clear: () => void;
  reset(): void;
} & Disposable;
//#endregion