import { Ref, ComputedRef, InjectionKey } from 'vue';
import { ExperimentSummary, ExperimentStatus } from '../types';
export interface UseAppExperimentOptions {
    /**
     * Called when the shared store adopts an experiment — a modal selection or a
     * resolved deep link. The record always comes from the platform.
     */
    onSelect?: (experiment: ExperimentSummary) => void | Promise<void>;
    onSave?: () => string | null | Promise<string | null>;
    onDetach?: () => void;
    saveDisabled?: Ref<boolean> | ComputedRef<boolean>;
    saveDisabledMessage?: string | Ref<string | undefined> | ComputedRef<string | undefined>;
}
export interface AppExperimentPopoverBinding {
    experimentName?: string;
    experimentCode?: string;
    experimentStatus?: ExperimentStatus;
    /** An experiment is bound but its record has not arrived yet. */
    isResolving: boolean;
    /** Resolution failed; the binding is kept so the user can retry or detach. */
    error?: string;
    showSave: boolean;
    showDetach: boolean;
    saveDisabled: boolean;
    saveDisabledMessage?: string;
    saveLoading: boolean;
    saveSuccessMessage?: string;
}
export interface AppExperimentSelectorModalBinding {
    modelValue: boolean;
    currentExperimentId: number | null;
}
export interface UseAppExperimentReturn {
    experimentName: ComputedRef<string | undefined>;
    experimentCode: ComputedRef<string | undefined>;
    experimentStatus: ComputedRef<ExperimentStatus | undefined>;
    experimentId: ComputedRef<number | null>;
    isResolving: ComputedRef<boolean>;
    error: ComputedRef<string | null>;
    popover: ComputedRef<AppExperimentPopoverBinding>;
    selectorModal: ComputedRef<AppExperimentSelectorModalBinding>;
    openModal: () => void;
    closeModal: () => void;
    handleSave: () => Promise<void>;
    handleDetach: () => void;
}
export interface AppExperimentState {
    experimentName: ComputedRef<string | undefined>;
    experimentCode: ComputedRef<string | undefined>;
    experimentStatus: ComputedRef<ExperimentStatus | undefined>;
    experimentId: ComputedRef<number | null>;
    isResolving: ComputedRef<boolean>;
    error: ComputedRef<string | null>;
    showModal: Ref<boolean>;
    saveLoading: Ref<boolean>;
    saveSuccessMessage: Ref<string | undefined>;
    showSave: Ref<boolean>;
    showDetach: ComputedRef<boolean>;
    closeModal: () => void;
    saveDisabled: ComputedRef<boolean>;
    saveDisabledMessage: ComputedRef<string | undefined>;
    popover: ComputedRef<AppExperimentPopoverBinding>;
    selectorModal: ComputedRef<AppExperimentSelectorModalBinding>;
    openModal: () => void;
    handleSave: () => Promise<void>;
    handleDetach: () => void;
}
export declare const APP_EXPERIMENT_KEY: InjectionKey<AppExperimentState>;
/**
 * Projects the current experiment from the shared store into an AppTopBar app
 * shell, and owns the shell-local concerns the store has no opinion on: the
 * selector modal's open state and the save flow.
 *
 * The composable never writes a selection of its own. `ExperimentSelectorModal`
 * commits to the store and this reads back, so a displayed name can only ever
 * have come from the platform.
 *
 * @example Recommended
 * ```ts
 * const appExperiment = useAppExperiment({
 *   onSelect: experiment => loadExperiment(experiment.id),
 * })
 * ```
 */
export declare function useAppExperiment(options?: UseAppExperimentOptions): UseAppExperimentReturn;