//#region src/types.d.ts
/**
 * The state of the promise.
 * @template TData The type of the return value.
 * @template TError The type of the error.
 */
type PromiseState<TData, TError extends Error = Error> = {
  data: null | TData | undefined;
  error: null | undefined;
  status: 'pending';
} | {
  data: null | TData | undefined;
  error: TError;
  status: 'error';
} | {
  data: null | undefined;
  error: null | undefined;
  status: 'idle';
} | {
  data: TData;
  error: null | undefined;
  status: 'success';
};
//#endregion
//#region src/index.d.ts
/**
 * A Vue composable for managing async operations with reactive state,
 * cancellation support, and race-condition safety.
 *
 * Designed for UI stability:
 * - Preserves previous data during reloads and errors
 * - Prevents stale responses from overwriting newer ones
 * - Supports request cancellation via AbortController
 * @template TData Resolved value type
 * @template TError Error type (must extend Error)
 * @template TArguments Argument tuple passed to the callback
 * @param callback Async function that receives an AbortSignal as its first argument
 * @returns The resolved value if successful, otherwise undefined.
 * @example
 * const { state, execute } = usePromise(
 *   async (signal, id: string) => fetch(`/api/users/${id}`, { signal }).then(response => response.json())
 * )
 *
 * execute('123')
 */
declare function usePromise<TData = unknown, TError extends Error = Error, TArguments extends Array<any> = []>(callback: (signal: AbortSignal, ...args: TArguments) => Promise<TData>): {
  /** Reactive promise state */
  state: Readonly<import("vue").Ref<{
    readonly data: null | undefined;
    readonly error: null | undefined;
    readonly status: "idle";
  } | {
    readonly data: import("vue").DeepReadonly<TData> | null | undefined;
    readonly error: null | undefined;
    readonly status: "pending";
  } | {
    readonly data: import("vue").DeepReadonly<TData> | null | undefined;
    readonly error: import("vue").DeepReadonly<TError>;
    readonly status: "error";
  } | {
    readonly data: import("vue").DeepReadonly<TData>;
    readonly error: null | undefined;
    readonly status: "success";
  }, {
    readonly data: null | undefined;
    readonly error: null | undefined;
    readonly status: "idle";
  } | {
    readonly data: import("vue").DeepReadonly<TData> | null | undefined;
    readonly error: null | undefined;
    readonly status: "pending";
  } | {
    readonly data: import("vue").DeepReadonly<TData> | null | undefined;
    readonly error: import("vue").DeepReadonly<TError>;
    readonly status: "error";
  } | {
    readonly data: import("vue").DeepReadonly<TData>;
    readonly error: null | undefined;
    readonly status: "success";
  }>>;
  /** Execute the async operation */
  execute: (...args: TArguments) => Promise<TData | undefined>;
  /** Abort any in-flight request */
  abort: () => void;
  /** Reset the promise state */
  reset: () => void;
};
//#endregion
export { type PromiseState, usePromise };