import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
import { SelectOption } from '../types';
import { ExtractExperimentSamplesOptions } from './experimentDesignData';
export type ExperimentIdSource = MaybeRefOrGetter<number | string | null | undefined>;
export type ExperimentDesignDataSource = MaybeRefOrGetter<Record<string, unknown> | null | undefined>;
export interface UseExperimentSamplesOptions extends ExtractExperimentSamplesOptions {
    /** Experiment id to load from `/experiments/{id}/data`; defaults to provided AppExperiment context. */
    experimentId?: ExperimentIdSource;
    /** Pre-fetched design_data or full platform design-data response. */
    designData?: ExperimentDesignDataSource;
    /** API base URL override for platform calls. */
    apiBaseUrl?: string;
    /** Auto-load when an experiment id becomes available. Defaults to true. */
    immediate?: boolean;
    /** Enable or disable automatic loading while keeping derived samples reactive. Defaults to true. */
    enabled?: MaybeRefOrGetter<boolean>;
    /** Use `useAppExperiment` provided state when `experimentId` is not set. Defaults to true. */
    syncAppExperiment?: boolean;
}
export interface UseExperimentSamplesReturn {
    /** Experiment id currently used for automatic sample loading. */
    experimentId: ComputedRef<number | undefined>;
    /** Raw `/experiments/{id}/data` response when loaded through the platform API. */
    data: Ref<Record<string, unknown> | null>;
    /** Plugin-defined design_data payload from props or platform response. */
    designData: ComputedRef<Record<string, unknown> | null>;
    /** SampleSelector-compatible string values extracted from design_data. */
    samples: ComputedRef<string[]>;
    /** Select/dropdown-friendly sample options extracted from design_data. */
    sampleOptions: ComputedRef<SelectOption<string>[]>;
    isLoading: Ref<boolean>;
    error: Ref<string | null>;
    lastLoadedAt: Ref<Date | null>;
    /** Fetch samples for a specific experiment id, defaulting to the resolved id. */
    fetch: (experimentId?: number | string | null) => Promise<Record<string, unknown> | null>;
    /** Refetch the current experiment id. */
    refresh: () => Promise<void>;
    /** Clear fetched platform data. */
    clear: () => void;
}
/** Loads experiment design_data and derives samples for SampleSelector-style UIs. */
export declare function useExperimentSamples(options?: UseExperimentSamplesOptions): UseExperimentSamplesReturn;