import { BaseItem, AutocompleteState, AutocompleteContext, AutocompleteInsightsApi, AutocompleteOptions } from '@algolia/autocomplete-core';
import { InitialAskAiMessage, DocSearchModalShortcuts, DocSearchRef, OnAskAiToggle } from '@docsearch/core';
export { DocSearchRef } from '@docsearch/core';
import { Hit, SearchParamsObject, LiteClient } from 'algoliasearch/lite';
import React, { JSX } from 'react';
import { UIMessage } from '@ai-sdk/react';
import { UIDataTypes } from 'ai';

type ContentType = 'askAI' | 'content' | 'lvl0' | 'lvl1' | 'lvl2' | 'lvl3' | 'lvl4' | 'lvl5' | 'lvl6';
interface DocSearchHitAttributeHighlightResult {
    value: string;
    matchLevel: 'full' | 'none' | 'partial';
    matchedWords: string[];
    fullyHighlighted?: boolean;
}
interface DocSearchHitHighlightResultHierarchy {
    lvl0: DocSearchHitAttributeHighlightResult;
    lvl1: DocSearchHitAttributeHighlightResult;
    lvl2: DocSearchHitAttributeHighlightResult;
    lvl3: DocSearchHitAttributeHighlightResult;
    lvl4: DocSearchHitAttributeHighlightResult;
    lvl5: DocSearchHitAttributeHighlightResult;
    lvl6: DocSearchHitAttributeHighlightResult;
}
interface DocSearchHitHighlightResult {
    content: DocSearchHitAttributeHighlightResult;
    hierarchy: DocSearchHitHighlightResultHierarchy;
    hierarchy_camel: DocSearchHitHighlightResultHierarchy[];
}
interface DocSearchHitAttributeSnippetResult {
    value: string;
    matchLevel: 'full' | 'none' | 'partial';
}
interface DocSearchHitSnippetResult {
    content: DocSearchHitAttributeSnippetResult;
    hierarchy: DocSearchHitHighlightResultHierarchy;
    hierarchy_camel: DocSearchHitHighlightResultHierarchy[];
}
declare type DocSearchHit = {
    objectID: string;
    content: string | null;
    query?: string;
    url: string;
    url_without_anchor: string;
    type: ContentType;
    anchor: string | null;
    hierarchy: {
        lvl0: string;
        lvl1: string;
        lvl2: string | null;
        lvl3: string | null;
        lvl4: string | null;
        lvl5: string | null;
        lvl6: string | null;
    };
    _highlightResult: DocSearchHitHighlightResult;
    _snippetResult: DocSearchHitSnippetResult;
    _rankingInfo?: {
        promoted: boolean;
        nbTypos: number;
        firstMatchedWord: number;
        proximityDistance?: number;
        geoDistance: number;
        geoPrecision?: number;
        nbExactWords: number;
        words: number;
        filters: number;
        userScore: number;
        matchedGeoLocation?: {
            lat: number;
            lng: number;
            distance: number;
        };
    };
    _distinctSeqID?: number;
    __autocomplete_indexName?: string;
    __autocomplete_queryID?: string;
    __autocomplete_algoliaCredentials?: {
        appId: string;
        apiKey: string;
    };
    __autocomplete_id?: number;
};

interface DocSearchContext extends AutocompleteContext {
    algoliaInsightsPlugin?: {
        insights: AutocompleteInsightsApi;
    };
}
interface DocSearchState<TItem extends BaseItem> extends AutocompleteState<TItem> {
    context: DocSearchContext;
}

type DocSearchTheme = 'dark' | 'light';

type InternalDocSearchHit = DocSearchHit & {
    __docsearch_parent: InternalDocSearchHit | null;
};

interface KeyboardShortcuts {
    /**
     * Enable/disable the Ctrl/Cmd+K shortcut to toggle the search modal.
     *
     * @default true
     */
    'Ctrl/Cmd+K'?: boolean;
    /**
     * Enable/disable the / shortcut to open the search modal.
     *
     * @default true
     */
    '/'?: boolean;
}

interface SearchIndexTool {
    input: {
        query: string;
    };
    output: {
        query?: string;
        hits?: any[];
    };
}
interface AgentStudioSearchTool {
    input: {
        index: string;
        query: string;
        number_of_results: number;
        facet_filters: any | null;
    };
    output: {
        hits?: any[];
        nbHits?: number;
        queryID?: string;
    };
}
interface AlgoliaMCPSearchTool {
    input: {
        query: string;
    };
    output: {
        hits?: any[];
        nbHits?: number;
    };
}
type Tools = {
    [K in `algolia_search_index_${string}`]: AlgoliaMCPSearchTool;
} & {
    searchIndex: SearchIndexTool;
    algolia_search_index: AgentStudioSearchTool;
};
type AIMessage = UIMessage<{
    stopped?: boolean;
}, UIDataTypes, Tools>;

type StoredDocSearchHit = Omit<DocSearchHit, '_highlightResult' | '_snippetResult'>;
type StoredAskAiMessage = AIMessage & {
    /** Optional user feedback on this assistant message. */
    feedback?: 'dislike' | 'like';
};
type StoredAskAiState = StoredDocSearchHit & {
    stopped?: boolean;
    messages?: StoredAskAiMessage[];
};

type SuggestedQuestion = {
    appId: string;
    assistantId: string;
    question: string;
    locale?: string;
    state: 'published';
    source: string;
    order: number;
};
type SuggestedQuestionHit = Hit<SuggestedQuestion>;

type DocSearchTranslations = Partial<{
    button: ButtonTranslations;
    modal: ModalTranslations;
}>;
type DocSearchTransformClient = {
    search: LiteClient['search'];
    addAlgoliaAgent: LiteClient['addAlgoliaAgent'];
    transporter: Pick<LiteClient['transporter'], 'algoliaAgent'>;
};
type AskAiSearchParameters = {
    facetFilters?: string[];
    filters?: string;
    attributesToRetrieve?: string[];
    restrictSearchableAttributes?: string[];
    distinct?: boolean | number | string;
};
type AgentStudioSearchParameters = Record<string, Omit<AskAiSearchParameters, 'facetFilters'>>;
type DocSearchAskAi = {
    /**
     * The index name to use for the ask AI feature. Your assistant will search this index for relevant documents.
     * If not provided, the index name will be used.
     */
    indexName?: string;
    /**
     * The API key to use for the ask AI feature. Your assistant will use this API key to search the index.
     * If not provided, the API key will be used.
     */
    apiKey?: string;
    /**
     * The app ID to use for the ask AI feature. Your assistant will use this app ID to search the index.
     * If not provided, the app ID will be used.
     */
    appId?: string;
    /**
     * The assistant ID to use for the ask AI feature.
     */
    assistantId: string;
    /**
     * Enables displaying suggested questions on Ask AI's new conversation screen.
     *
     * @default false
     */
    suggestedQuestions?: boolean;
    useStagingEnv?: boolean;
} & ({
    /**
     * **Experimental:** Whether to use Agent Studio as the chat backend.
     *
     * This is an experimental feature and its API may change without notice in future releases.
     * Use with caution in production environments.
     *
     * @default false
     */
    agentStudio?: never;
    /**
     * The search parameters to use for the ask AI feature.
     *
     * **NOTE**: If using `agentStudio = true`, the `searchParameters` object is
     * keyed by the index name.
     */
    searchParameters?: AskAiSearchParameters;
} | {
    agentStudio: false;
    searchParameters?: AskAiSearchParameters;
} | {
    agentStudio: true;
    /**
     * The search parameters to use for the ask AI feature.
     * Keyed by the index name.
     *
     * @example
     * {
     *   "INDEX_NAME": { distinct: false }
     * }
     */
    searchParameters?: AgentStudioSearchParameters;
});
interface DocSearchIndex {
    name: string;
    searchParameters?: SearchParamsObject;
}
interface DocSearchProps {
    /**
     * Algolia application id used by the search client.
     */
    appId: string;
    /**
     * Public api key with search permissions for the index.
     */
    apiKey: string;
    /**
     * Name of the algolia index to query.
     *
     * @deprecated `indexName` will be removed in a future version. Please use `indices` property going forward.
     */
    indexName?: string;
    /**
     * List of indices and _optional_ searchParameters to be used for search.
     *
     * @see {@link https://docsearch.algolia.com/docs/api#indices}
     */
    indices?: Array<DocSearchIndex | string>;
    /**
     * Configuration or assistant id to enable ask ai mode. Pass a string assistant id or a full config object.
     */
    askAi?: DocSearchAskAi | string;
    /**
     * Intercept Ask AI requests (e.g. Submitting a prompt or selecting a suggested question).
     *
     * Return `true` to prevent the default modal Ask AI flow (no toggle, no sendMessage).
     * Useful to route Ask AI into a different UI (e.g. `@docsearch/sidepanel-js`) without flicker.
     */
    interceptAskAiEvent?: (initialMessage: InitialAskAiMessage) => boolean | void;
    /**
     * Theme overrides applied to the modal and related components.
     */
    theme?: DocSearchTheme;
    /**
     * Placeholder text for the search input.
     */
    placeholder?: string;
    /**
     * Additional algolia search parameters to merge into each query.
     *
     * @deprecated `searchParameters` will be removed in a future version. Please use `indices` property going forward.
     */
    searchParameters?: SearchParamsObject;
    /**
     * Maximum number of hits to display per source/group.
     */
    maxResultsPerGroup?: number;
    /**
     * Hook to post-process hits before rendering.
     */
    transformItems?: (items: DocSearchHit[]) => DocSearchHit[];
    /**
     * Custom component to render an individual hit.
     * Supports template patterns:
     * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
     * - JSX templates: (props) => <div>...</div>
     * - Function-based templates: (props) => string | JSX.Element | Function.
     */
    hitComponent?: (props: {
        hit: InternalDocSearchHit | StoredDocSearchHit;
        children: React.ReactNode;
    }, helpers?: {
        html: (template: TemplateStringsArray, ...values: any[]) => any;
    }) => JSX.Element;
    /**
     * Custom component rendered at the bottom of the results panel.
     * Supports template patterns:
     * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
     * - JSX templates: (props) => <div>...</div>
     * - Function-based templates: (props) => string | JSX.Element | Function.
     */
    resultsFooterComponent?: (props: {
        state: AutocompleteState<InternalDocSearchHit>;
    }, helpers?: {
        html: (template: TemplateStringsArray, ...values: any[]) => any;
    }) => JSX.Element | null;
    /**
     * Hook to wrap or modify the algolia search client.
     */
    transformSearchClient?: (searchClient: DocSearchTransformClient) => DocSearchTransformClient;
    /**
     * Disable storage and usage of recent and favorite searches.
     */
    disableUserPersonalization?: boolean;
    /**
     * Query string to prefill when opening the modal.
     */
    initialQuery?: string;
    /**
     * Custom navigator for controlling link navigation.
     */
    navigator?: AutocompleteOptions<InternalDocSearchHit>['navigator'];
    /**
     * Localized strings for the button and modal ui.
     */
    translations?: DocSearchTranslations;
    /**
     * Builds a url to report missing results for a given query.
     */
    getMissingResultsUrl?: ({ query }: {
        query: string;
    }) => string;
    /**
     * Insights client integration options to send analytics events.
     */
    insights?: AutocompleteOptions<InternalDocSearchHit>['insights'];
    /**
     * The container element where the modal should be portaled to. Defaults to document.body.
     */
    portalContainer?: DocumentFragment | Element;
    /**
     * Limit of how many recent searches should be saved/displayed..
     *
     * @default 7
     */
    recentSearchesLimit?: number;
    /**
     * Limit of how many recent searches should be saved/displayed when there are favorited searches..
     *
     * @default 4
     */
    recentSearchesWithFavoritesLimit?: number;
    /**
     * Configuration for keyboard shortcuts. Allows enabling/disabling specific shortcuts.
     *
     * @default `{ 'Ctrl/Cmd+K': true, '/': true }`
     */
    keyboardShortcuts?: DocSearchModalShortcuts;
}
declare const DocSearch: React.ForwardRefExoticComponent<DocSearchProps & React.RefAttributes<DocSearchRef>>;
declare function DocSearchInner(props: DocSearchProps): JSX.Element;

type ButtonTranslations = Partial<{
    buttonText: string;
    buttonAriaLabel: string;
}>;
type DocSearchButtonProps = React.ComponentProps<'button'> & {
    theme?: DocSearchTheme;
    translations?: ButtonTranslations;
    keyboardShortcuts?: DocSearchModalShortcuts;
};
declare const DocSearchButton: React.ForwardRefExoticComponent<Omit<DocSearchButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

type FooterTranslations = Partial<{
    selectText: string;
    submitQuestionText: string;
    selectKeyAriaLabel: string;
    navigateText: string;
    navigateUpKeyAriaLabel: string;
    navigateDownKeyAriaLabel: string;
    closeText: string;
    backToSearchText: string;
    closeKeyAriaLabel: string;
    poweredByText: string;
}>;

type NewConversationTranslations = Partial<{
    newConversationTitle: string;
    newConversationDescription: string;
}>;

type AskAiScreenTranslations = Partial<{
    disclaimerText: string;
    relatedSourcesText: string;
    thinkingText: string;
    copyButtonText: string;
    copyButtonCopiedText: string;
    copyButtonTitle: string;
    likeButtonTitle: string;
    dislikeButtonTitle: string;
    thanksForFeedbackText: string;
    preToolCallText: string;
    duringToolCallText: string;
    afterToolCallText: string;
    /**
     * Build the full jsx element for the aggregated search block.
     * If provided, completely overrides the default english renderer.
     */
    aggregatedToolCallNode?: (queries: string[], onSearchQueryClick: (query: string) => void) => React.ReactNode;
    /**
     * Generate the list connective parts only (backwards compatibility).
     * Receives full list of queries and should return translation parts for before/after/separators.
     * Example: (qs) => ({ before: 'searched for ', separator: ', ', lastSeparator: ' and ', after: '' }).
     */
    aggregatedToolCallText?: (queries: string[]) => {
        before?: string;
        separator?: string;
        lastSeparator?: string;
        after?: string;
    };
    /**
     * Message that's shown when user has stopped the streaming of a message.
     */
    stoppedStreamingText: string;
    /**
     * Error title shown if there is an error while chatting.
     */
    errorTitleText: string;
    /**
     * Message shown when thread depth limit is exceeded (AI-217 error).
     */
    threadDepthExceededMessage: string;
    /**
     * Button text for starting a new conversation after thread depth error.
     */
    startNewConversationButtonText: string;
}>;

type ErrorScreenTranslations = Partial<{
    titleText: string;
    helpText: string;
}>;

type NoResultsScreenTranslations = Partial<{
    noResultsText: string;
    suggestedQueryText: string;
    reportMissingResultsText: string;
    reportMissingResultsLinkText: string;
}>;

type ResultsScreenTranslations = Partial<{
    askAiPlaceholder: string;
    noResultsAskAiPlaceholder: string;
}>;

type StartScreenTranslations = Partial<{
    recentSearchesTitle: string;
    noRecentSearchesText: string;
    saveRecentSearchButtonTitle: string;
    removeRecentSearchButtonTitle: string;
    favoriteSearchesTitle: string;
    removeFavoriteSearchButtonTitle: string;
    recentConversationsTitle: string;
    removeRecentConversationButtonTitle: string;
}>;

type ScreenStateTranslations = Partial<{
    errorScreen: ErrorScreenTranslations;
    startScreen: StartScreenTranslations;
    noResultsScreen: NoResultsScreenTranslations;
    resultsScreen: ResultsScreenTranslations;
    askAiScreen: AskAiScreenTranslations;
    newConversation: NewConversationTranslations;
}>;

type SearchBoxTranslations = Partial<{
    clearButtonTitle: string;
    clearButtonAriaLabel: string;
    closeButtonText: string;
    closeButtonAriaLabel: string;
    placeholderText: string;
    placeholderTextAskAi: string;
    placeholderTextAskAiStreaming: string;
    enterKeyHint: string;
    enterKeyHintAskAi: string;
    searchInputLabel: string;
    backToKeywordSearchButtonText: string;
    backToKeywordSearchButtonAriaLabel: string;
    newConversationPlaceholder: string;
    conversationHistoryTitle: string;
    startNewConversationText: string;
    viewConversationHistoryText: string;
    threadDepthErrorPlaceholder: string;
}>;

type ModalTranslations = Partial<{
    searchBox: SearchBoxTranslations;
    newConversation: NewConversationTranslations;
    footer: FooterTranslations;
}> & ScreenStateTranslations;
type DocSearchModalProps = DocSearchProps & {
    initialScrollY: number;
    onAskAiToggle: OnAskAiToggle;
    interceptAskAiEvent?: (initialMessage: InitialAskAiMessage) => boolean | void;
    onClose?: () => void;
    isAskAiActive?: boolean;
    translations?: ModalTranslations;
    isHybridModeSupported?: boolean;
};
declare function DocSearchModal({ appId, apiKey, askAi, maxResultsPerGroup, theme, onClose, transformItems, hitComponent, resultsFooterComponent, navigator, initialScrollY, transformSearchClient, disableUserPersonalization, initialQuery: initialQueryFromProp, translations, getMissingResultsUrl, insights, onAskAiToggle, interceptAskAiEvent, isAskAiActive, recentSearchesLimit, recentSearchesWithFavoritesLimit, indices, indexName, searchParameters, isHybridModeSupported, ...props }: DocSearchModalProps): JSX.Element;

interface UseDocSearchKeyboardEventsProps {
    isOpen: boolean;
    onOpen: () => void;
    onClose: () => void;
    /**
     * Deprecated: Still here for backwards compat.
     *
     * @deprecated
     */
    onInput?: (event: KeyboardEvent) => void;
    /**
     * Deprecated: Still here for backwards compat.
     *
     * @deprecated
     */
    searchButtonRef?: React.RefObject<HTMLButtonElement | null>;
    isAskAiActive: boolean;
    onAskAiToggle: (toggle: boolean) => void;
    keyboardShortcuts?: KeyboardShortcuts;
}
declare function useDocSearchKeyboardEvents({ isOpen, onOpen, onClose, isAskAiActive, onAskAiToggle, keyboardShortcuts, }: UseDocSearchKeyboardEventsProps): void;

declare const version = "4.6.2";

export { DocSearch, DocSearchButton, DocSearchInner, DocSearchModal, useDocSearchKeyboardEvents, version };
export type { AgentStudioSearchParameters, AskAiSearchParameters, ButtonTranslations, DocSearchAskAi, DocSearchButtonProps, DocSearchHit, DocSearchIndex, DocSearchModalProps, DocSearchProps, DocSearchState, DocSearchTheme, DocSearchTransformClient, DocSearchTranslations, InternalDocSearchHit, KeyboardShortcuts, ModalTranslations, StoredAskAiMessage, StoredAskAiState, StoredDocSearchHit, SuggestedQuestion, SuggestedQuestionHit, UseDocSearchKeyboardEventsProps };