import { type Dispatch, type SetStateAction } from 'react';
import type { FunnelContextValue } from '../components/FunnelContext.js';
import type { FunnelManifestExperiment } from '../config/funnel.manifest.types.js';
import type { FunnelUserAnswers } from '../sdk/userAnswers.js';
import { apiService } from '../services/api.service.js';
import { type FunnelUserAttribution } from './funnel-attribution.js';
import type { FunnelStepMeta, FunnelStepType } from '../steps/types.js';
import { type FunnelStepLifecycleIntent } from './funnel-step-lifecycle.js';
export type FunnelFlowControllerExperiment<StepId extends string> = FunnelManifestExperiment & {
    stepId: StepId;
    variants: readonly (FunnelManifestExperiment['variants'][number] & {
        routeToStepId: StepId;
    })[];
};
type StepComponentRegistry = Record<string, unknown>;
type FunnelFlowAnalyticsAdapter = {
    flush?: () => unknown | Promise<unknown>;
    trackEmailCapturedBrowserDestinations?: (input: {
        eventId: string;
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
    }) => void;
    trackStepStarted?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
        startedAt: string;
        stepContractVersion: number;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
    trackStepCompleted?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
        startedAt: string;
        endedAt: string;
        stepContractVersion: number;
        selected?: Record<string, unknown>;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
    trackStepExited?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
        startedAt: string;
        endedAt: string;
        exitReason: Extract<FunnelStepLifecycleIntent, {
            type: 'exit';
        }>['reason'];
        stepContractVersion: number;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
    trackFunnelStarted?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType?: string;
        stepContractVersion: number;
        occurredAt: string;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
    trackFunnelCompleted?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
        stepContractVersion: number;
        occurredAt: string;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
    trackFirstStepViewed?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
        stepContractVersion: number;
        occurredAt: string;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
    trackFirstStepClicked?: (input: {
        userId?: string;
        environment?: 'test' | 'live';
        stepId: string;
        stepName: string;
        stepType: FunnelStepType;
        stepContractVersion: number;
        occurredAt: string;
        metadata?: Record<string, unknown>;
        featureFlags?: Record<string, string>;
    }) => string | null;
};
export type FunnelFlowApiAdapter = Pick<typeof apiService, 'getOrCreateClientUserId' | 'getBootstrapCandidateUserId' | 'bootstrapSession' | 'pingUserContext' | 'persistCanonicalUserId' | 'updateUser' | 'captureEmail'>;
type UseFunnelFlowControllerInput<StepId extends string> = {
    api?: FunnelFlowApiAdapter;
    analytics?: FunnelFlowAnalyticsAdapter;
    stepContractVersion: number;
    initialStepId?: StepId;
    initialAttributes?: FunnelUserAnswers;
    lockToInitialStep?: boolean;
    defaultStepId: StepId;
    stepSequence: readonly StepId[];
    stepById: Record<string, FunnelStepMeta>;
    stepComponentById: StepComponentRegistry;
    funnelExperiments: readonly FunnelFlowControllerExperiment<StepId>[];
    getPathForStep: (stepId: StepId) => string;
    getStepIdFromPath: (pathname: string) => StepId | null;
    getSequentialNextStepId: (stepId: StepId) => StepId | null;
    getChoiceTargetsForStep: (stepId: StepId) => {
        yes?: StepId;
        no?: StepId;
    } | null;
    isFunnelStepId: (value: string) => value is StepId;
    resolveConfiguredNextStep: (stepId: StepId, context: {
        attributes: Record<string, unknown>;
        ignoreExperiment?: boolean;
        resolveExperimentVariantKey: (experiment: FunnelManifestExperiment) => string | null;
    }) => StepId | null;
    resolveRuntimeInitialStepId: (input: {
        requestedStepId?: string | null;
    }) => StepId;
};
type UseFunnelFlowControllerResult<StepId extends string> = {
    activeStepComponent: unknown;
    activeStepId: StepId;
    activeStepMeta: FunnelStepMeta | undefined;
    buttonText: string;
    buttonVariant: 'muted' | null;
    contextValue: FunnelContextValue;
    editorModeEnabled: boolean;
    editorPanelExpanded: boolean;
    experimentAssignmentForEditor: (experiment: FunnelFlowControllerExperiment<StepId>) => string;
    funnelExperiments: readonly FunnelFlowControllerExperiment<StepId>[];
    handleContinue: () => void;
    postHogReady: boolean;
    renderSuspended: boolean;
    renderedStepId: StepId;
    renderedStepMeta: FunnelStepMeta | undefined;
    runtimeMode: 'test' | 'live';
    setEditorPanelExpanded: Dispatch<SetStateAction<boolean>>;
    setEditorVariantSelection: (experiment: FunnelFlowControllerExperiment<StepId>, variantKey: string) => void;
    showShellContinue: boolean;
};
export declare function resolveFunnelEventAttribution(document: unknown, provisionalAttribution: FunnelUserAttribution | null): FunnelUserAttribution | null;
export declare function buildReadyFunnelAttributionEventMetadata(attributionReady: boolean, attribution: FunnelUserAttribution | null): Record<string, string> | null;
export declare function scheduleAttributionFailOpen(onReady: () => void, timeoutMs: number): () => void;
export declare function takeInitialFunnelAttributionMetadata(tracked: boolean, attributionReady: boolean, attribution: FunnelUserAttribution | null): {
    tracked: boolean;
    metadata: Record<string, string> | null;
};
export declare function computeRenderSuspended(input: {
    activeStepId: string;
    attributionReady?: boolean;
    postHogReady: boolean;
    experiments: ReadonlyArray<{
        stepId: string;
    } & Partial<Pick<FunnelManifestExperiment, 'experimentId' | 'variants'>>>;
    isPreviewRuntime?: boolean;
}): boolean;
export declare function resolveRenderedExperimentStepId(input: {
    activeExperiment: FunnelManifestExperiment | null;
    editorVariantOverrides: Record<string, string>;
    postHogReady: boolean;
    resolveRenderableStepId: (stepId: string | null | undefined) => string | null;
    safeActiveStepId: string;
    featureFlags?: Readonly<Record<string, string | boolean>>;
    search?: string;
}): string;
export declare function useFunnelFlowController<StepId extends string>({ api, analytics, stepContractVersion, initialStepId, initialAttributes, lockToInitialStep, defaultStepId, stepSequence, stepById, stepComponentById, funnelExperiments, getPathForStep, getStepIdFromPath, getSequentialNextStepId, getChoiceTargetsForStep, isFunnelStepId, resolveConfiguredNextStep, resolveRuntimeInitialStepId, }: UseFunnelFlowControllerInput<StepId>): UseFunnelFlowControllerResult<StepId>;
export {};