import { GetItemPropsOptions, UseComboboxProps } from 'downshift';
import { ReactNode } from 'react';
import ConstructorIOClient from '@constructor-io/constructorio-client-javascript';
import { IAutocompleteParameters, SearchSuggestion as SearchSuggestionFromClient, Product as ProductFromClient, Item as ItemBase, AutocompleteRequestType, ConstructorClientOptions, RecommendationsParameters } from '@constructor-io/constructorio-client-javascript/lib/types';
export type { IAutocompleteParameters } from '@constructor-io/constructorio-client-javascript/lib/types';
export type CioClientConfig = {
    /**
     * Your Constructor API key. Either `apiKey` or `cioJsClient` are required
     */
    apiKey?: string;
    /**
     * Optional custom constructor instance. Either `apiKey` or `cioJsClient` are required
     */
    cioJsClient?: ConstructorIOClient;
    /**
     * Pass a `cioClientOptions` object to customize the client's configurations w/o creating a new instance of `ConstructorIOClient`. You can learn more about the possible values [Here](https://constructor-io.github.io/constructorio-client-javascript/ConstructorIO.html)
     */
    cioClientOptions?: ConstructorClientOptions;
    /**
     * @deprecated Use `cioClientOptions` instead.
     */
    cioJsClientOptions?: ConstructorClientOptions;
};
export interface AdvancedParametersBase {
    numTermsWithGroupSuggestions?: number;
    numGroupsSuggestedPerTerm?: number;
    displaySearchSuggestionImages?: boolean;
    displaySearchSuggestionResultCounts?: boolean;
    displayShowAllResultsButton?: boolean;
    debounce?: number;
    translations?: Translations;
    fetchZeroStateOnFocus?: boolean;
}
export type AdvancedParameters = AdvancedParametersBase & Omit<IAutocompleteParameters, 'resultsPerSection'>;
type OptionalItemsComboboxProps<Item> = Partial<UseComboboxProps<Item>> & {
    items?: Item[];
};
export type UseCioAutocompleteOptions = Omit<CioAutocompleteProps, 'children'>;
export type ShopifySettings = {
    searchUrl: string;
};
export type CioAutocompletePropsBase = CioClientConfig & OptionalItemsComboboxProps<Item> & {
    /**
     * Set to `false` to show suggestions only after a user clears their query,
     * but not when they initially select the input
     */
    openOnFocus?: boolean;
    /**
     * Transforms a `SearchSuggestion` into the desired URL string to be used when rendering anchor tags
     * i.e. <a href=getSearchResultsUrl([selected_search_suggestion])>[Search Suggestion]</a>
     */
    getSearchResultsUrl?: (item: SearchSuggestion) => string;
    /**
     * Callback function that runs when the user focuses on the input
     */
    onFocus?: () => void;
    /**
     * Callback function that runs when the user modifies input
     */
    onChange?: (input: string) => void;
    /**
     * Search input placeholder
     */
    placeholder?: string;
    /**
     * Children to be rendered according to the RenderProps pattern
     */
    children?: ReactNode;
    /**
     * Configure the sections rendered, based on the user's input. This can be either Constructor-powered sections,
     * or your own custom sections. Defaults to Products and Search Suggestion sections powered by Constructor
     */
    sections?: UserDefinedSection[];
    /**
     * Configure either Constructor-powered sections or power your own custom sections,
     * to be rendered for [Autocomplete Zero-State](link-tbd)
     */
    zeroStateSections?: UserDefinedSection[];
    /**
     * Configure the parent container's class. Defaults to `cio-autocomplete`
     */
    autocompleteClassName?: string;
    /**
     * See Advanced Parameters
     */
    advancedParameters?: AdvancedParameters;
    /**
     * Search input default value
     */
    defaultInput?: string;
    /**
     * Configuration settings for Shopify integration. Used when `useShopifyDefaults` is enabled.
     *
     * Allows you to customize the search URL and other Shopify-specific behaviors.
     */
    shopifySettings?: ShopifySettings;
};
export type CioAutocompletePropsWithShopifyDefaults = {
    /**
     * Callback function that runs when the user submits a search.
     * Usually used to trigger a redirect.
     * If provided, it will override Shopify defaults even when useShopifyDefaults is true.
     */
    onSubmit?: OnSubmit;
    /**
     * Set to `true` to apply Shopify-specific defaults for `onSubmit` behavior.
     *
     * When enabled, the autocomplete will automatically handle navigation:
     * - **Product selections**: Redirects to the product URL (preserving query parameters)
     * - **Search Suggestions**: Redirects to the search results page with the selected query
     * - **Manual search**: Redirects to the search results page with the entered query
     *
     * **Note**: If you provide a custom `onSubmit` handler, it will override the Shopify defaults.
     */
    useShopifyDefaults: true;
};
export type CioAutocompletePropsWithoutShopifyDefaults = {
    /**
     * Callback function that runs when the user submits a search.
     * Usually used to trigger a redirect.
     */
    onSubmit: OnSubmit;
    /**
     * Set to `true` to apply Shopify-specific defaults for `onSubmit` behavior.
     *
     * When enabled, the autocomplete will automatically handle navigation:
     * - **Product selections**: Redirects to the product URL (preserving query parameters)
     * - **Search Suggestions**: Redirects to the search results page with the selected query
     * - **Manual search**: Redirects to the search results page with the entered query
     *
     * **Note**: If you provide a custom `onSubmit` handler, it will override the Shopify defaults.
     */
    useShopifyDefaults?: false;
};
export type CioAutocompleteProps = CioAutocompletePropsBase & (CioAutocompletePropsWithShopifyDefaults | CioAutocompletePropsWithoutShopifyDefaults);
/**
 * AutocompleteSubmitEvent type is AutocompleteSelectSubmit or AutocompleteSearchSubmit.
 * Use isAutocompleteSearchSubmit or isAutocompleteSelectSubmit type predicates to safely access event properties.
 * @example if (isAutocompleteSelectSubmit(event)) { ... } //`item` and `originalQuery` are available
 * @example if (isAutocompleteSearchSubmit(event)) { ... } //`query` is available
 */
export type AutocompleteSubmitEvent = AutocompleteSelectSubmit | AutocompleteSearchSubmit;
export type AutocompleteSelectSubmit = {
    item: Item;
    originalQuery: string;
};
export type AutocompleteSearchSubmit = {
    query: string;
};
/**
 * Checks if the provided event is an AutocompleteSelectSubmit event.
 * @param event The event to check.
 * @returns True if the event is an AutocompleteSelectSubmit event, false otherwise.
 * @example if (isAutocompleteSelectSubmit(event)) { ... } // `query` is available
 */
export declare const isAutocompleteSelectSubmit: (event: AutocompleteSubmitEvent) => event is AutocompleteSelectSubmit;
/**
 * Checks if the given event is an AutocompleteSearchSubmit event.
 * @param event The event to check.
 * @returns True if the event is an AutocompleteSearchSubmit event, false otherwise.
 * @example if (isAutocompleteSearchSubmit(event)) { ... } // `item` and `originalQuery` are available
 */
export declare const isAutocompleteSearchSubmit: (event: AutocompleteSubmitEvent) => event is AutocompleteSearchSubmit;
export type OnSubmit = (event: AutocompleteSubmitEvent, shopifySettings?: ShopifySettings) => unknown;
export type DownshiftGetItemPropsOptions = GetItemPropsOptions<Item>;
export type DownshiftGetItemProps = (options: GetItemPropsOptions<Item>) => object;
export type ItemPropsOptions = DownshiftGetItemPropsOptions & {
    sectionName: string;
    indexOffset?: number;
};
export type GetItemProps = (options: ItemPropsOptions) => object;
export type Item = Product | SearchSuggestion | InGroupSuggestion | ItemBase;
export type GetAutocompleteResultsOptions = {
    [sectionIdentifier: string]: {
        numResults: number;
    };
};
export type SectionsData = {
    [key: string]: Item[];
};
/** CIO API Response Data */
export type AutocompleteResultSections = {
    sectionsData: SectionsData;
    request: Partial<AutocompleteRequestType>;
    totalNumResultsPerSection: Record<string, number>;
};
type SectionType = 'autocomplete' | 'recommendations' | 'custom';
export type SectionConfiguration = {
    type?: SectionType;
    displayName?: string;
    numResults?: number;
    displaySearchTermHighlights?: boolean;
    displayNoResultsMessage?: boolean;
    ref?: React.RefObject<HTMLElement>;
    renderItem?: (props: {
        item: Item;
        query: string;
        getItemProps: (item: Item) => any;
    }) => ReactNode;
};
export interface AutocompleteSectionConfiguration extends SectionConfiguration {
    type?: 'autocomplete';
    indexSectionName: string;
    /** @deprecated use indexSectionName field instead */
    identifier?: string;
}
export type RecommendationsSectionConfiguration = SectionConfiguration & {
    type: 'recommendations';
    indexSectionName?: string;
    podId: string;
    /** @deprecated use podId field instead */
    identifier?: string;
} & Omit<RecommendationsParameters, 'section' | 'numResults'>;
export interface CustomSectionConfiguration extends SectionConfiguration {
    type: 'custom';
    displayName: string;
}
export interface AutocompleteSection extends AutocompleteSectionConfiguration {
    data: Item[];
}
export interface RecommendationsSection extends RecommendationsSectionConfiguration {
    data: Item[];
}
export interface CustomSection extends CustomSectionConfiguration {
    data: Item[];
}
export type Section = AutocompleteSection | RecommendationsSection | CustomSection;
export type UserDefinedSection = AutocompleteSectionConfiguration | RecommendationsSectionConfiguration | CustomSection;
export type Product = ProductFromClient & {
    section: 'Products';
};
export type SearchSuggestion = SearchSuggestionFromClient & {
    section: 'Search Suggestions';
};
export type InGroupSuggestion = SearchSuggestion & {
    groupId: string;
    groupName: string;
};
export type HTMLPropsWithCioDataAttributes<T = any> = React.DetailedHTMLProps<React.HTMLAttributes<T>, T> & {
    [key: `data-cnstrc-${string}`]: any;
};
export type Translations = {
    in?: string;
    'show all results'?: string;
};
export interface PodData {
    podId: string;
    displayName: string;
    request: Partial<AutocompleteRequestType>;
    resultId?: string;
    numResults?: number;
}