//#region src/runtime/iconv.d.ts
/**
 * Character encoding conversion utilities.
 *
 * Thin typed wrapper around the platform-provided `tailor.iconv` runtime API.
 * At runtime this delegates to `globalThis.tailor.iconv`, which is provided by
 * the Tailor Platform Function runtime. Use `mockIconv` from
 * `@tailor-platform/sdk/vitest` to mock these calls in unit tests.
 * @example
 * import { iconv } from "@tailor-platform/sdk/runtime";
 *
 * const utf8 = iconv.convert(sjisBuffer, "Shift_JIS", "UTF-8"); // string
 * const sjis = iconv.convert("こんにちは", "UTF-8", "Shift_JIS"); // Uint8Array
 *
 * const conv = new iconv.Iconv("Shift_JIS", "UTF-8");
 * const out = conv.convert(sjisBuffer);
 */
/** Instance methods exposed by `tailor.iconv.Iconv`. */
export interface IconvInstance {
  convert(input: string | Uint8Array | ArrayBuffer): string | Uint8Array;
}
/** Constructor shape for `tailor.iconv.Iconv`. */
export interface IconvConstructor {
  new (fromEncoding: string, toEncoding: string): IconvInstance;
}
/**
 * Platform API surface for `tailor.iconv`. Describes the shape the platform
 * runtime injects on `globalThis.tailor.iconv` so the wrapper and ambient
 * globals stay in sync.
 */
export interface TailorIconvAPI {
  /**
   * Convert a string or buffer between encodings.
   * @param str - Input data to convert
   * @param fromEncoding - Source encoding name
   * @param toEncoding - Target encoding name
   * @returns `string` when `toEncoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
   */
  convert<T extends string>(str: string | Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: T): T extends "UTF8" | "UTF-8" ? string : Uint8Array;
  /**
   * Convert a buffer between encodings.
   * @param buffer - Input bytes to convert
   * @param fromEncoding - Source encoding name
   * @param toEncoding - Target encoding name
   * @returns `string` when `toEncoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
   */
  convertBuffer<T extends string>(buffer: Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: T): T extends "UTF8" | "UTF-8" ? string : Uint8Array;
  /**
   * Decode a buffer to a UTF-8 string using the given source encoding.
   * @param buffer - Input bytes
   * @param encoding - Source encoding name
   * @returns Decoded UTF-8 string
   */
  decode(buffer: Uint8Array | ArrayBuffer, encoding: string): string;
  /**
   * Encode a UTF-8 string into the given target encoding.
   * @param str - Input string
   * @param encoding - Target encoding name
   * @returns `string` when `encoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
   */
  encode<T extends string>(str: string, encoding: T): T extends "UTF8" | "UTF-8" ? string : Uint8Array;
  /**
   * Returns the list of supported encoding names.
   * @returns Array of encoding names supported by the platform iconv runtime
   */
  encodings(): string[];
  /** Constructor for the stateful converter. */
  Iconv: IconvConstructor;
}
/** Runtime API for `tailor.iconv`. */
export declare const iconv: TailorIconvAPI;
//#endregion