import type { Ref } from '@stacksjs/stx';
/**
 * Chainable reactive fetch composable. Pass the expected success body
 * shape as the type argument to get a typed `data.value`.
 *
 * @example
 * ```ts
 * interface Post { id: number, title: string }
 * const { error, data } = await useFetch<Post[]>('/api/posts').get().json()
 * //      data: Ref<Post[] | null>
 * const { data } = await useFetch<Post>('/api/posts').post(JSON.stringify(body)).json()
 * const { error } = await useFetch('/api/posts/1').delete().json()
 * ```
 */
export declare function useFetch<T = unknown>(url: string): FetchBuilder<T>;
/**
 * Result of a terminal `.json()` call. Generic over the success body
 * `T` (stacksjs/stacks#1924) so `data.value` is typed instead of
 * `any`. `error` stays `unknown` — it can be a parsed error body OR a
 * thrown network error, so the caller should narrow before use.
 */
export declare interface UseFetchResult<T = unknown> {
  data: Ref<T | null>
  error: Ref<unknown>
  isFetching: Ref<boolean>
  then: (resolve: (value: { data: Ref<T | null>, error: Ref<unknown> }) => void) => Promise<void>
}
export declare interface FetchBuilder<T = unknown> {
  get: () => FetchBuilder<T>
  post: (body?: string) => FetchBuilder<T>
  patch: (body?: string) => FetchBuilder<T>
  put: (body?: string) => FetchBuilder<T>
  delete: () => FetchBuilder<T>
  json: () => UseFetchResult<T>
}