import { type PaginationAtomType } from "../Extended Atoms/paginationAtom";
import { type AtomType } from "./atom";
import { type ListAtomType, type ListItemInput } from "./createListAtom";
import { type ObjectAtomType } from "./createObjectAtom";
export type SortState = {
    key?: string;
    dir: "asc" | "desc";
};
export type PaginationStyle = "page" | "lazy";
export type LoadContext<T extends object = object, K extends string = "id"> = {
    list: ListAtomType<T, K>;
    source: ListAtomType<T, K>;
    search: AtomType<string>;
    searchInput: AtomType<string>;
    filters: ObjectAtomType<unknown>;
    sort: AtomType<SortState | null>;
    page: PaginationAtomType;
    pageSize: AtomType<number>;
    total: AtomType<number>;
    hasMore: AtomType<boolean>;
    loading: AtomType<boolean>;
    error: AtomType<unknown | null>;
    /** AbortSignal for this request — pass to fetch. */
    signal: AbortSignal;
};
export type AdvancedListOptions<T extends object, K extends string = "id"> = {
    keyName?: K;
    searchDelay?: number;
    pageSize?: number;
    paginationStyle?: PaginationStyle;
    initialSearch?: string;
    initialFilters?: Record<string, unknown>;
    initialSort?: SortState | null;
    searchKeys?: Array<keyof T | string>;
    filterFn?: (item: T, filters: Record<string, unknown>, search: string) => boolean;
    sortFn?: (a: T, b: T, sort: SortState) => number;
    load?: (ctx: LoadContext<T, K>) => Promise<T[]> | PromiseLike<T[]>;
    resetPageOnQueryChange?: boolean;
};
export type AdvancedListController<T extends object = object, K extends string = "id"> = {
    list: ListAtomType<T, K>;
    /** Full dataset (static mode). In dynamic mode starts empty / unused for paging. */
    source: ListAtomType<T, K>;
    searchInput: AtomType<string>;
    search: AtomType<string>;
    filters: ObjectAtomType<unknown>;
    sort: AtomType<SortState | null>;
    page: PaginationAtomType;
    pageSize: AtomType<number>;
    total: AtomType<number>;
    hasMore: AtomType<boolean>;
    loading: AtomType<boolean>;
    error: AtomType<unknown | null>;
    /** Re-run pipeline / fetch with current atom values. */
    load: () => Promise<void>;
    reload: () => Promise<void>;
    /** Active request signal (same as `LoadContext.signal` while in flight). */
    getSignal: () => AbortSignal;
    dispose: () => void;
    readonly paginationStyle: PaginationStyle;
    readonly isDynamic: boolean;
};
/**
 * Composite list controller: local search/filter/sort/pagination, or remote
 * `load` with page-replace vs lazy-append.
 *
 * @example
 * // Static
 * const al = advancedList(users, { pageSize: 10, searchKeys: ["name"] });
 * al.searchInput.set("ada");
 * al.page.next();
 *
 * @example
 * // Dynamic
 * const al = advancedList([], {
 *   paginationStyle: "lazy",
 *   load: async ({ page, pageSize, search, signal, total }) => {
 *     const res = await fetch(`/api?q=${search()}&page=${page()}&size=${pageSize()}`, { signal });
 *     const data = await res.json();
 *     total.set(data.total);
 *     return data.items;
 *   },
 * });
 */
export declare function advancedList<T extends object = object, K extends string = "id">(initial?: readonly ListItemInput<T, K>[], options?: AdvancedListOptions<T, K>): AdvancedListController<T, K>;
//# sourceMappingURL=advancedList.d.ts.map