import * as _tanstack_query_core from '@tanstack/query-core';
import { OffsetPageFetcher, OffsetPage } from './pagination.js';
export { ApiPage, DEFAULT_MAX_PAGE_SIZE, DEFAULT_PAGE_SIZE, OffsetPageOptions, OffsetPagination, QueryValue, cleanQuery, createOffsetPagination, fetchOffsetPage, getPageIndex } from './pagination.js';
import { L as ListStrategy, R as ResolvedListMode } from './cardPagination-Bwf3tEeN.js';
export { C as CardPaginationKey, a as CardPaginationLabels, b as CardPaginationState, c as buildCardPaginationLabels, d as createCardPagination } from './cardPagination-Bwf3tEeN.js';
import * as _tanstack_react_query from '@tanstack/react-query';
import { QueryKey, UseQueryOptions, DefinedUseQueryResult, UseQueryResult, UseMutationOptions } from '@tanstack/react-query';
import './paginationLabels-dZLSNxfo.js';
import 'react';

interface UseOffsetInfiniteQueryOptions<T> {
    enabled?: boolean;
    fetchPage: OffsetPageFetcher<T>;
    queryKey: readonly unknown[];
    /**
     * The size of one *server request*, not of a displayed page.
     *
     * Deliberately decoupled: the display page size is measured from the rendered
     * container and moves as the viewport, column count and card height settle.
     * Tying a request to it would put a network round trip behind every
     * measurement correction, and a second skeleton behind each round trip.
     */
    windowSize?: number;
    /** The server's `limit` clamp. Defaults to `DEFAULT_MAX_PAGE_SIZE`. */
    maxLimit?: number;
}
declare const DEFAULT_ROW_WINDOW_SIZE = 50;
/**
 * An accumulating row buffer over `fetchOffsetPage`.
 *
 * Every mode of `useResponsiveOffsetList` reads from one of these — numbered
 * pages are a slice of the buffer rather than a request of their own.
 */
declare function useOffsetInfiniteQuery<T>({ enabled, fetchPage, queryKey, windowSize, maxLimit, }: UseOffsetInfiniteQueryOptions<T>): {
    rows: T[];
    hasNextPage: boolean;
    total: number;
    data: _tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>;
    error: Error;
    isError: true;
    isPending: false;
    isLoading: false;
    isLoadingError: false;
    isRefetchError: true;
    isSuccess: false;
    isPlaceholderData: false;
    status: "error";
    fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchPreviousPage: (options?: _tanstack_query_core.FetchPreviousPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    hasPreviousPage: boolean;
    isFetchNextPageError: boolean;
    isFetchingNextPage: boolean;
    isFetchPreviousPageError: boolean;
    isFetchingPreviousPage: boolean;
    dataUpdatedAt: number;
    errorUpdatedAt: number;
    failureCount: number;
    failureReason: Error;
    errorUpdateCount: number;
    isFetched: boolean;
    isFetchedAfterMount: boolean;
    isFetching: boolean;
    isInitialLoading: boolean;
    isPaused: boolean;
    isRefetching: boolean;
    isStale: boolean;
    isEnabled: boolean;
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchStatus: _tanstack_query_core.FetchStatus;
    promise: Promise<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>>;
} | {
    rows: T[];
    hasNextPage: boolean;
    total: number;
    data: _tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>;
    error: null;
    isError: false;
    isPending: false;
    isLoading: false;
    isLoadingError: false;
    isRefetchError: false;
    isFetchNextPageError: false;
    isFetchPreviousPageError: false;
    isSuccess: true;
    isPlaceholderData: false;
    status: "success";
    fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchPreviousPage: (options?: _tanstack_query_core.FetchPreviousPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    hasPreviousPage: boolean;
    isFetchingNextPage: boolean;
    isFetchingPreviousPage: boolean;
    dataUpdatedAt: number;
    errorUpdatedAt: number;
    failureCount: number;
    failureReason: Error;
    errorUpdateCount: number;
    isFetched: boolean;
    isFetchedAfterMount: boolean;
    isFetching: boolean;
    isInitialLoading: boolean;
    isPaused: boolean;
    isRefetching: boolean;
    isStale: boolean;
    isEnabled: boolean;
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchStatus: _tanstack_query_core.FetchStatus;
    promise: Promise<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>>;
} | {
    rows: T[];
    hasNextPage: boolean;
    total: number;
    data: undefined;
    error: Error;
    isError: true;
    isPending: false;
    isLoading: false;
    isLoadingError: true;
    isRefetchError: false;
    isFetchNextPageError: false;
    isFetchPreviousPageError: false;
    isSuccess: false;
    isPlaceholderData: false;
    status: "error";
    fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchPreviousPage: (options?: _tanstack_query_core.FetchPreviousPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    hasPreviousPage: boolean;
    isFetchingNextPage: boolean;
    isFetchingPreviousPage: boolean;
    dataUpdatedAt: number;
    errorUpdatedAt: number;
    failureCount: number;
    failureReason: Error;
    errorUpdateCount: number;
    isFetched: boolean;
    isFetchedAfterMount: boolean;
    isFetching: boolean;
    isInitialLoading: boolean;
    isPaused: boolean;
    isRefetching: boolean;
    isStale: boolean;
    isEnabled: boolean;
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchStatus: _tanstack_query_core.FetchStatus;
    promise: Promise<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>>;
} | {
    rows: T[];
    hasNextPage: boolean;
    total: number;
    data: undefined;
    error: null;
    isError: false;
    isPending: true;
    isLoading: true;
    isLoadingError: false;
    isRefetchError: false;
    isFetchNextPageError: false;
    isFetchPreviousPageError: false;
    isSuccess: false;
    isPlaceholderData: false;
    status: "pending";
    fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchPreviousPage: (options?: _tanstack_query_core.FetchPreviousPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    hasPreviousPage: boolean;
    isFetchingNextPage: boolean;
    isFetchingPreviousPage: boolean;
    dataUpdatedAt: number;
    errorUpdatedAt: number;
    failureCount: number;
    failureReason: Error;
    errorUpdateCount: number;
    isFetched: boolean;
    isFetchedAfterMount: boolean;
    isFetching: boolean;
    isInitialLoading: boolean;
    isPaused: boolean;
    isRefetching: boolean;
    isStale: boolean;
    isEnabled: boolean;
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchStatus: _tanstack_query_core.FetchStatus;
    promise: Promise<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>>;
} | {
    rows: T[];
    hasNextPage: boolean;
    total: number;
    data: undefined;
    error: null;
    isError: false;
    isPending: true;
    isLoadingError: false;
    isRefetchError: false;
    isFetchNextPageError: false;
    isFetchPreviousPageError: false;
    isSuccess: false;
    isPlaceholderData: false;
    status: "pending";
    fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchPreviousPage: (options?: _tanstack_query_core.FetchPreviousPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    hasPreviousPage: boolean;
    isFetchingNextPage: boolean;
    isFetchingPreviousPage: boolean;
    dataUpdatedAt: number;
    errorUpdatedAt: number;
    failureCount: number;
    failureReason: Error;
    errorUpdateCount: number;
    isFetched: boolean;
    isFetchedAfterMount: boolean;
    isFetching: boolean;
    isLoading: boolean;
    isInitialLoading: boolean;
    isPaused: boolean;
    isRefetching: boolean;
    isStale: boolean;
    isEnabled: boolean;
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchStatus: _tanstack_query_core.FetchStatus;
    promise: Promise<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>>;
} | {
    rows: T[];
    hasNextPage: boolean;
    total: number;
    data: _tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>;
    isError: false;
    error: null;
    isPending: false;
    isLoading: false;
    isLoadingError: false;
    isRefetchError: false;
    isSuccess: true;
    isPlaceholderData: true;
    isFetchNextPageError: false;
    isFetchPreviousPageError: false;
    status: "success";
    fetchNextPage: (options?: _tanstack_query_core.FetchNextPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchPreviousPage: (options?: _tanstack_query_core.FetchPreviousPageOptions) => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    hasPreviousPage: boolean;
    isFetchingNextPage: boolean;
    isFetchingPreviousPage: boolean;
    dataUpdatedAt: number;
    errorUpdatedAt: number;
    failureCount: number;
    failureReason: Error;
    errorUpdateCount: number;
    isFetched: boolean;
    isFetchedAfterMount: boolean;
    isFetching: boolean;
    isInitialLoading: boolean;
    isPaused: boolean;
    isRefetching: boolean;
    isStale: boolean;
    isEnabled: boolean;
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    fetchStatus: _tanstack_query_core.FetchStatus;
    promise: Promise<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>>;
};

interface PaginationState {
    pageIndex: number;
    pageSize: number;
}
type PaginationUpdater = PaginationState | ((current: PaginationState) => PaginationState);
interface UseResponsiveOffsetListOptions<T> {
    enabled?: boolean;
    fetchPage: OffsetPageFetcher<T>;
    pageSize?: number;
    queryKey: readonly unknown[];
    /** Defaults to `"paged"`. See `ListStrategy`. */
    strategy?: ListStrategy;
    /** The server's `limit` clamp. Defaults to `DEFAULT_MAX_PAGE_SIZE`. */
    maxLimit?: number;
    /** Below this width the list continues on scroll. Defaults to `lg`. */
    cardBreakpoint?: number;
}
/**
 * One offset-paginated list, in whichever presentation the viewport calls for.
 *
 * Feeds `NTable` directly: the return value carries `pagination`,
 * `onPaginationChange` and `pageCount` for the page controls, and the fields
 * `createCardPagination` reads for scroll continuation.
 */
declare function useResponsiveOffsetList<T>({ enabled, fetchPage, pageSize, queryKey, strategy, maxLimit, cardBreakpoint, }: UseResponsiveOffsetListOptions<T>): {
    cardViewport: boolean;
    mode: ResolvedListMode;
    data: T[];
    /** Rows matching the current filters on the server, or `null` if unknown. */
    total: number;
    error: Error;
    hasNextPage: boolean;
    loading: boolean;
    loadingMore: boolean;
    loadMoreError: Error;
    onLoadMore: () => Promise<_tanstack_query_core.InfiniteQueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
    onPaginationChange: (updater: PaginationUpdater) => void;
    pageCount: number;
    pagination: {
        pageIndex: number;
        pageSize: number;
    };
    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<_tanstack_query_core.InfiniteData<OffsetPage<T>, unknown>, Error>>;
};

type EntityQueryOptions<TQueryFnData, TError = Error, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey> = UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>;
/**
 * A typed `useQuery` pass-through that keeps Najm feature hooks consistent.
 * Callers retain the complete TanStack option surface, including `select`.
 */
declare function useEntityQuery<TQueryFnData, TError = Error, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(options: EntityQueryOptions<TQueryFnData, TError, TData, TQueryKey> & {
    initialData: TQueryFnData | (() => TQueryFnData);
}): DefinedUseQueryResult<TData, TError>;
declare function useEntityQuery<TQueryFnData, TError = Error, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(options: EntityQueryOptions<TQueryFnData, TError, TData, TQueryKey>): UseQueryResult<TData, TError>;

type SuccessMessage<TData, TVariables> = string | ((data: TData, variables: TVariables) => string | undefined);
type ErrorMessage<TError> = string | ((error: TError) => string | undefined);
/**
 * Normalizes an error the application did not resolve itself. `fallback` is the
 * caller's `errorMessage` string when it gave one.
 */
type EntityCommandErrorResolver<TError = Error> = (error: TError, fallback?: string) => string;
interface EntityCommandOptions<TData, TVariables = void, TError = Error, TOnMutateResult = unknown> extends Omit<UseMutationOptions<TData, TError, TVariables, TOnMutateResult>, "mutationFn" | "onError" | "onSuccess"> {
    mutationFn: (variables: TVariables) => Promise<TData>;
    invalidate?: readonly QueryKey[];
    successMessage?: SuccessMessage<TData, TVariables>;
    errorMessage?: ErrorMessage<TError>;
    getErrorMessage?: EntityCommandErrorResolver<TError>;
    onSuccess?: UseMutationOptions<TData, TError, TVariables, TOnMutateResult>["onSuccess"];
    onError?: UseMutationOptions<TData, TError, TVariables, TOnMutateResult>["onError"];
}
/** Reads the common Fetch/Najm/Axios error shapes without owning app policy. */
declare function getEntityCommandErrorMessage(error: unknown, fallback?: string): string;
declare function useEntityCommand<TData, TVariables = void, TError = Error, TOnMutateResult = unknown>({ errorMessage, getErrorMessage, invalidate, mutationFn, onError, onSuccess, successMessage, ...options }: EntityCommandOptions<TData, TVariables, TError, TOnMutateResult>): _tanstack_react_query.UseMutationResult<TData, TError, TVariables, TOnMutateResult>;

export { DEFAULT_ROW_WINDOW_SIZE, type EntityCommandErrorResolver, type EntityCommandOptions, type EntityQueryOptions, ListStrategy, OffsetPage, OffsetPageFetcher, ResolvedListMode, type UseOffsetInfiniteQueryOptions, type UseResponsiveOffsetListOptions, getEntityCommandErrorMessage, useEntityCommand, useEntityQuery, useOffsetInfiniteQuery, useResponsiveOffsetList };