import { Ref, ComputedRef } from 'vue';
import { ExperimentSummary, ExperimentFilters, ExperimentTypeOption, SelectOption } from '../types';
export interface UseExperimentSelectorOptions {
    experimentType?: string;
    allowedExperimentTypes?: string[] | null;
    apiBaseUrl?: string;
    limit?: number;
    immediate?: boolean;
}
export interface UseExperimentSelectorReturn {
    /** Current page of fetched experiment rows. */
    experiments: Ref<ExperimentSummary[]>;
    /** Total matching experiment count reported by the platform. */
    total: Ref<number>;
    /** Currently selected experiment, or null. */
    selectedExperiment: Ref<ExperimentSummary | null>;
    /** Mutable filters used for the next fetch. */
    filters: ExperimentFilters;
    /** Whether experiment rows are currently loading. */
    isLoading: Ref<boolean>;
    /** Error message from the last failed fetch, or null. */
    error: Ref<string | null>;
    /** Timestamp of the last successful experiment fetch, or null. */
    lastLoadedAt: Ref<Date | null>;
    /** Current zero-based page index. */
    page: Ref<number>;
    /** Whether another page can be loaded. */
    hasMore: ComputedRef<boolean>;
    /** Combined sort key in the form `<field>:<asc|desc>`. */
    sortKey: Ref<string>;
    /** Available experiment type options for filter UI. */
    experimentTypes: Ref<ExperimentTypeOption[]>;
    /** Available project options for filter UI. */
    projects: Ref<SelectOption<string>[]>;
    /** Fetched experiments grouped by project name. */
    groupedByProject: ComputedRef<[string, ExperimentSummary[]][]>;
    /** Fetch the current page with the current filters. */
    fetch: () => Promise<void>;
    /** Fetch and append the next page when available. */
    loadMore: () => Promise<void>;
    /** Clear fetched rows and refetch page zero. */
    reset: () => void;
    /** Select an experiment. */
    select: (experiment: ExperimentSummary) => void;
    /** Clear selection and filters. */
    clear: () => void;
    /** Fetch experiment type and project filter options. */
    fetchFilterOptions: () => Promise<void>;
}
/** Fetches a paginated, filtered experiment list from the platform API for picker and selector UIs. */
export declare function useExperimentSelector(options?: UseExperimentSelectorOptions): UseExperimentSelectorReturn;