@docsearch/react 5.0.4 → 5.1.0

package/dist/esm/{DocSearchModal-Cgdi4eHY.js.map → DocSearchModal-CLcbYBea.js.map}

@@ -1 +1 @@
-{"version":3,"file":"DocSearchModal-Cgdi4eHY.js","names":[],"sources":["../../src/components/KeywordSearchBox.tsx","../../src/components/KeywordStartScreen.tsx","../../src/ScreenState.tsx","../../src/DocSearchModal.tsx"],"sourcesContent":["import type {\n  AutocompleteApi,\n  AutocompleteState,\n} from '@algolia/autocomplete-core';\nimport React, { type JSX, type RefObject } from 'react';\n\nimport type { InternalDocSearchHit } from '../types';\n\nimport { SearchBoxForm } from './ui/SearchBoxForm';\n\nexport type KeywordSearchBoxTranslations = Partial<{\n  clearButtonTitle: string;\n  clearButtonAriaLabel: string;\n  closeButtonText: string;\n  closeButtonAriaLabel: string;\n  placeholderText: string;\n  enterKeyHint: string;\n  searchInputLabel: string;\n}>;\n\ninterface KeywordSearchBoxProps extends AutocompleteApi<\n  InternalDocSearchHit,\n  React.FormEvent,\n  React.MouseEvent,\n  React.KeyboardEvent\n> {\n  state: AutocompleteState<InternalDocSearchHit>;\n  autoFocus: boolean;\n  inputRef: RefObject<HTMLInputElement | null>;\n  onClose: () => void;\n  placeholder: string;\n  isFromSelection: boolean;\n  translations?: KeywordSearchBoxTranslations;\n}\n\nexport function KeywordSearchBox({\n  translations = {},\n  ...props\n}: KeywordSearchBoxProps): JSX.Element {\n  const {\n    clearButtonTitle = 'Clear',\n    clearButtonAriaLabel = 'Clear the query',\n    closeButtonText = 'Close',\n    closeButtonAriaLabel = 'Close',\n    searchInputLabel = 'Search',\n  } = translations;\n\n  const actionsBeforeClose = (\n    <>\n      <button\n        className=\"DocSearch-Clear\"\n        type=\"reset\"\n        aria-label={clearButtonAriaLabel}\n        hidden={!props.state.query}\n        tabIndex={props.state.query ? 0 : -1}\n        aria-hidden={!props.state.query ? 'true' : 'false'}\n      >\n        {clearButtonTitle}\n      </button>\n\n      {props.state.query && <div className=\"DocSearch-Divider\" />}\n    </>\n  );\n\n  return (\n    <SearchBoxForm\n      {...props}\n      clearButtonTitle={clearButtonTitle}\n      clearButtonAriaLabel={clearButtonAriaLabel}\n      closeButtonText={closeButtonText}\n      closeButtonAriaLabel={closeButtonAriaLabel}\n      searchInputLabel={searchInputLabel}\n      inputProps={{\n        enterKeyHint: 'search',\n      }}\n      actionsBeforeClose={actionsBeforeClose}\n    />\n  );\n}\n","import React, { type JSX } from 'react';\n\nimport type { ScreenStateProps } from '../ScreenState';\nimport type { InternalDocSearchHit } from '../types';\n\nimport type { StoredSearchesSectionsTranslations } from './ui/StoredSearchesSections';\nimport { StoredSearchesSections } from './ui/StoredSearchesSections';\n\nexport type KeywordStartScreenTranslations = StoredSearchesSectionsTranslations;\n\ntype KeywordStartScreenProps = Omit<\n  ScreenStateProps<InternalDocSearchHit>,\n  'translations'\n> & {\n  hasCollections: boolean;\n  translations?: KeywordStartScreenTranslations;\n};\n\nexport function KeywordStartScreen({\n  translations = {},\n  ...props\n}: KeywordStartScreenProps): JSX.Element | null {\n  return (\n    <div className=\"DocSearch-Dropdown-Container\">\n      <StoredSearchesSections {...props} translations={translations} />\n    </div>\n  );\n}\n","import type {\n  AutocompleteApi,\n  AutocompleteState,\n  BaseItem,\n} from '@algolia/autocomplete-core';\nimport React from 'react';\n\nimport type { KeywordStartScreenTranslations } from './components/KeywordStartScreen';\nimport { KeywordStartScreen } from './components/KeywordStartScreen';\nimport type { DocSearchProps } from './DocSearch';\nimport type { ErrorScreenTranslations } from './ErrorScreen';\nimport { ErrorScreen } from './ErrorScreen';\nimport type { NoResultsScreenTranslations } from './NoResultsScreen';\nimport { NoResultsScreen } from './NoResultsScreen';\nimport type { ResultsScreenTranslations } from './ResultsScreen';\nimport { ResultsScreen } from './ResultsScreen';\nimport type { StoredSearchPlugin } from './stored-searches';\nimport type { InternalDocSearchHit, StoredDocSearchHit } from './types';\nimport { isQueryEmpty } from './utils';\n\nexport type ScreenStateTranslations = Partial<{\n  errorScreen: ErrorScreenTranslations;\n  startScreen: KeywordStartScreenTranslations;\n  noResultsScreen: NoResultsScreenTranslations;\n  resultsScreen: ResultsScreenTranslations;\n}>;\n\nexport interface ScreenStateProps<\n  TItem extends BaseItem,\n> extends AutocompleteApi<\n  TItem,\n  React.FormEvent,\n  React.MouseEvent,\n  React.KeyboardEvent\n> {\n  state: AutocompleteState<TItem>;\n  recentSearches: StoredSearchPlugin<StoredDocSearchHit>;\n  favoriteSearches: StoredSearchPlugin<StoredDocSearchHit>;\n  onItemClick: (\n    item: InternalDocSearchHit,\n    event: KeyboardEvent | MouseEvent\n  ) => void;\n  inputRef: React.MutableRefObject<HTMLInputElement | null>;\n  hitComponent: DocSearchProps['hitComponent'];\n  indexName: string;\n  disableUserPersonalization: boolean;\n  resultsFooterComponent: DocSearchProps['resultsFooterComponent'];\n  translations: ScreenStateTranslations;\n  getMissingResultsUrl?: DocSearchProps['getMissingResultsUrl'];\n  hasCollections: boolean;\n  resultBadgeKey?: string;\n}\n\nexport const ScreenState = React.memo(\n  ({ translations = {}, ...props }: ScreenStateProps<InternalDocSearchHit>) => {\n    if (props.state?.status === 'error') {\n      return <ErrorScreen translations={translations?.errorScreen} />;\n    }\n\n    if (isQueryEmpty(props.state.query)) {\n      return (\n        <KeywordStartScreen\n          {...props}\n          hasCollections={props.hasCollections}\n          translations={translations?.startScreen}\n        />\n      );\n    }\n\n    if (!props.hasCollections) {\n      return (\n        <NoResultsScreen\n          {...props}\n          translations={translations?.noResultsScreen}\n        />\n      );\n    }\n\n    return (\n      <ResultsScreen {...props} translations={translations?.resultsScreen} />\n    );\n  },\n  function areEqual(prevProps, nextProps) {\n    const isLoading =\n      nextProps.state.status === 'loading' ||\n      nextProps.state.status === 'stalled';\n\n    const isWaitingForCollections =\n      nextProps.state.status === 'idle' &&\n      !isQueryEmpty(nextProps.state.query) &&\n      prevProps.state.query !== nextProps.state.query &&\n      prevProps.state.collections === nextProps.state.collections;\n\n    return isLoading || isWaitingForCollections;\n  }\n);\n","import { createAutocomplete } from '@algolia/autocomplete-core';\nimport React, { type JSX } from 'react';\n\nimport type { FacetBarTranslations } from './components/FacetBar';\nimport { FacetBar } from './components/FacetBar';\nimport type { KeywordSearchBoxTranslations } from './components/KeywordSearchBox';\nimport { KeywordSearchBox } from './components/KeywordSearchBox';\nimport { ModalShell } from './components/ui/ModalShell';\nimport type { DocSearchProps } from './DocSearch';\nimport type { FooterTranslations } from './Footer';\nimport { Footer } from './Footer';\nimport { Hit } from './Hit';\nimport { useDocSearchFacets } from './hooks/useDocSearchFacets';\nimport { useSendItemClickEvent } from './hooks/useDocSearchInsights';\nimport { useInitialModalQuery } from './hooks/useInitialModalQuery';\nimport { useModalEnvironment } from './hooks/useModalEnvironment';\nimport { useModalRefs } from './hooks/useModalRefs';\nimport { useRefreshOnInitialQuery } from './hooks/useRefreshOnInitialQuery';\nimport { useSaveRecentSearch } from './hooks/useSaveRecentSearch';\nimport { useStoredDocSearches } from './hooks/useStoredDocSearches';\nimport type { ScreenStateTranslations } from './ScreenState';\nimport { ScreenState } from './ScreenState';\nimport type { DocSearchState, InternalDocSearchHit } from './types';\nimport { useSearchClient } from './useSearchClient';\nimport {\n  identity,\n  isModifierEvent,\n  isQueryEmpty,\n  noop,\n  scrollTo as scrollToUtils,\n} from './utils';\nimport {\n  buildNoQuerySources,\n  buildQuerySources,\n  type BuildQuerySourcesState,\n} from './utils/createDocSearchSources';\nimport { normalizeDocSearchIndexes } from './utils/normalizeDocSearchIndexes';\n\nexport type ModalTranslations = Partial<{\n  searchBox: KeywordSearchBoxTranslations;\n  footer: FooterTranslations;\n  facets: FacetBarTranslations;\n}> &\n  ScreenStateTranslations;\n\nexport type DocSearchModalProps = DocSearchProps & {\n  initialScrollY: number;\n  onClose?: () => void;\n  translations?: ModalTranslations;\n};\n\nexport function DocSearchModal({\n  appId,\n  apiKey,\n  maxResultsPerGroup,\n  theme,\n  onClose = noop,\n  transformItems = identity,\n  hitComponent = Hit,\n  resultsFooterComponent = (): JSX.Element | null => null,\n  navigator,\n  initialScrollY = 0,\n  transformSearchClient = identity,\n  disableUserPersonalization = false,\n  initialQuery: initialQueryFromProp = '',\n  translations = {},\n  getMissingResultsUrl,\n  insights = false,\n  recentSearchesLimit = 7,\n  recentSearchesWithFavoritesLimit = 4,\n  indices,\n  facets,\n  footerAction,\n  ...props\n}: DocSearchModalProps): JSX.Element {\n  const {\n    footer: footerTranslations,\n    searchBox: searchBoxTranslations,\n    facets: facetBarTranslations,\n    ...screenStateTranslations\n  } = translations;\n  const [state, setState] = React.useState<\n    DocSearchState<InternalDocSearchHit>\n  >({\n    query: '',\n    collections: [],\n    completion: null,\n    context: {},\n    isOpen: false,\n    activeItemId: null,\n    status: 'idle',\n  });\n\n  const placeholder =\n    translations?.searchBox?.placeholderText ||\n    props.placeholder ||\n    'Search docs';\n\n  const { containerRef, modalRef, formElementRef, dropdownRef, inputRef } =\n    useModalRefs();\n  const { initialQuery, initialQueryFromSelection } =\n    useInitialModalQuery(initialQueryFromProp);\n\n  const searchClient = useSearchClient(appId, apiKey, transformSearchClient);\n\n  const indexes = React.useMemo(\n    () =>\n      normalizeDocSearchIndexes({\n        indices,\n      }),\n    [indices]\n  );\n  const defaultIndexName = indexes[0].name;\n\n  const autocompleteRef =\n    React.useRef<\n      ReturnType<\n        typeof createAutocomplete<\n          InternalDocSearchHit,\n          React.FormEvent<HTMLFormElement>,\n          React.MouseEvent,\n          React.KeyboardEvent\n        >\n      >\n    >(undefined);\n\n  const {\n    visibleFacets,\n    facetSelections,\n    facetSelectionsRef,\n    handleFacetSelectionChange,\n    clearFacetSelections,\n  } = useDocSearchFacets({\n    facets,\n    indexes,\n    searchClient,\n    onSelectionsChange: () => autocompleteRef.current?.refresh(),\n  });\n\n  const { favoriteSearches, recentSearches } = useStoredDocSearches({\n    defaultIndexName,\n    recentSearchesLimit,\n    recentSearchesWithFavoritesLimit,\n  });\n  const saveRecentSearch = useSaveRecentSearch({\n    favoriteSearches,\n    recentSearches,\n    disableUserPersonalization,\n  });\n  const sendItemClickEvent = useSendItemClickEvent(state);\n\n  if (!autocompleteRef.current) {\n    autocompleteRef.current = createAutocomplete({\n      id: 'docsearch',\n      defaultActiveItemId: 0,\n      openOnFocus: true,\n      initialState: {\n        query: initialQuery,\n        context: {\n          searchSuggestions: [],\n        },\n      },\n      insights: Boolean(insights),\n      navigator,\n      onStateChange(changes) {\n        setState(changes.state);\n      },\n      getSources({ query, state: sourcesState, setContext, setStatus }) {\n        if (isQueryEmpty(query)) {\n          const noQuerySources = buildNoQuerySources({\n            recentSearches,\n            favoriteSearches,\n            saveRecentSearch,\n            onClose,\n            disableUserPersonalization,\n          });\n          return noQuerySources;\n        }\n\n        const querySourcesState: BuildQuerySourcesState = {\n          context: sourcesState.context,\n        };\n\n        const algoliaSourcesPromise = buildQuerySources({\n          query,\n          state: querySourcesState,\n          setContext,\n          setStatus,\n          searchClient,\n          indexes,\n          insights: Boolean(insights),\n          appId,\n          apiKey,\n          maxResultsPerGroup,\n          transformItems,\n          saveRecentSearch,\n          onClose,\n          facetSelections: facetSelectionsRef,\n        });\n\n        return algoliaSourcesPromise;\n      },\n    });\n  }\n\n  const autocomplete = autocompleteRef.current;\n\n  const { getEnvironmentProps, getRootProps, refresh } = autocomplete;\n\n  useModalEnvironment({\n    getEnvironmentProps,\n    containerRef,\n    dropdownRef,\n    formElementRef,\n    inputRef,\n    initialScrollY,\n    modalRef,\n    theme,\n  });\n\n  React.useEffect(() => {\n    if (dropdownRef.current) {\n      scrollToUtils(dropdownRef.current);\n    }\n  }, [state.query, dropdownRef]);\n\n  useRefreshOnInitialQuery({ initialQuery, inputRef, refresh });\n\n  // hide the dropdown on idle and no collections\n  let showDocsearchDropdown = true;\n  const hasCollections = state.collections.some(\n    (collection) => collection.items.length > 0\n  );\n  if (\n    state.status === 'idle' &&\n    hasCollections === false &&\n    isQueryEmpty(state.query)\n  ) {\n    showDocsearchDropdown = false;\n  }\n\n  return (\n    <ModalShell\n      state={state}\n      containerRef={containerRef}\n      modalRef={modalRef}\n      formElementRef={formElementRef}\n      dropdownRef={dropdownRef}\n      getRootProps={getRootProps}\n      showDropdown={showDocsearchDropdown}\n      searchBox={\n        <KeywordSearchBox\n          {...autocomplete}\n          state={state}\n          placeholder={placeholder || 'Search docs'}\n          autoFocus={isQueryEmpty(initialQuery)}\n          inputRef={inputRef}\n          isFromSelection={\n            Boolean(initialQuery) && initialQuery === initialQueryFromSelection\n          }\n          translations={searchBoxTranslations}\n          onClose={onClose}\n        />\n      }\n      filterBar={\n        !isQueryEmpty(state.query) ? (\n          <FacetBar\n            facets={visibleFacets}\n            selections={facetSelections}\n            translations={facetBarTranslations}\n            clearSelections={clearFacetSelections}\n            onSelectionChange={handleFacetSelectionChange}\n          />\n        ) : null\n      }\n      screenState={\n        <ScreenState\n          {...autocomplete}\n          indexName={defaultIndexName}\n          state={state}\n          hitComponent={hitComponent}\n          resultsFooterComponent={resultsFooterComponent}\n          disableUserPersonalization={disableUserPersonalization}\n          recentSearches={recentSearches}\n          favoriteSearches={favoriteSearches}\n          inputRef={inputRef}\n          translations={screenStateTranslations}\n          getMissingResultsUrl={getMissingResultsUrl}\n          hasCollections={hasCollections}\n          resultBadgeKey={props.resultBadgeKey}\n          onItemClick={(item, event) => {\n            sendItemClickEvent(item);\n            saveRecentSearch(item);\n            if (!isModifierEvent(event)) {\n              onClose();\n            }\n          }}\n        />\n      }\n      footer={\n        <Footer translations={footerTranslations} footerAction={footerAction} />\n      }\n      onClose={onClose}\n    />\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"DocSearchModal-CLcbYBea.js","names":[],"sources":["../../src/components/KeywordSearchBox.tsx","../../src/components/KeywordStartScreen.tsx","../../src/ScreenState.tsx","../../src/DocSearchModal.tsx"],"sourcesContent":["import type {\n  AutocompleteApi,\n  AutocompleteState,\n} from '@algolia/autocomplete-core';\nimport React, { type JSX, type RefObject } from 'react';\n\nimport type { InternalDocSearchHit } from '../types';\n\nimport { SearchBoxForm } from './ui/SearchBoxForm';\n\nexport type KeywordSearchBoxTranslations = Partial<{\n  clearButtonTitle: string;\n  clearButtonAriaLabel: string;\n  closeButtonText: string;\n  closeButtonAriaLabel: string;\n  placeholderText: string;\n  enterKeyHint: string;\n  searchInputLabel: string;\n}>;\n\ninterface KeywordSearchBoxProps extends AutocompleteApi<\n  InternalDocSearchHit,\n  React.FormEvent,\n  React.MouseEvent,\n  React.KeyboardEvent\n> {\n  state: AutocompleteState<InternalDocSearchHit>;\n  autoFocus: boolean;\n  inputRef: RefObject<HTMLInputElement | null>;\n  onClose: () => void;\n  placeholder: string;\n  isFromSelection: boolean;\n  translations?: KeywordSearchBoxTranslations;\n}\n\nexport function KeywordSearchBox({\n  translations = {},\n  ...props\n}: KeywordSearchBoxProps): JSX.Element {\n  const {\n    clearButtonTitle = 'Clear',\n    clearButtonAriaLabel = 'Clear the query',\n    closeButtonText = 'Close',\n    closeButtonAriaLabel = 'Close',\n    searchInputLabel = 'Search',\n  } = translations;\n\n  const actionsBeforeClose = (\n    <>\n      <button\n        className=\"DocSearch-Clear\"\n        type=\"reset\"\n        aria-label={clearButtonAriaLabel}\n        hidden={!props.state.query}\n        tabIndex={props.state.query ? 0 : -1}\n        aria-hidden={!props.state.query ? 'true' : 'false'}\n      >\n        {clearButtonTitle}\n      </button>\n\n      {props.state.query && <div className=\"DocSearch-Divider\" />}\n    </>\n  );\n\n  return (\n    <SearchBoxForm\n      {...props}\n      clearButtonTitle={clearButtonTitle}\n      clearButtonAriaLabel={clearButtonAriaLabel}\n      closeButtonText={closeButtonText}\n      closeButtonAriaLabel={closeButtonAriaLabel}\n      searchInputLabel={searchInputLabel}\n      inputProps={{\n        enterKeyHint: 'search',\n      }}\n      actionsBeforeClose={actionsBeforeClose}\n    />\n  );\n}\n","import React, { type JSX } from 'react';\n\nimport type { ScreenStateProps } from '../ScreenState';\nimport type { InternalDocSearchHit } from '../types';\n\nimport type { StoredSearchesSectionsTranslations } from './ui/StoredSearchesSections';\nimport { StoredSearchesSections } from './ui/StoredSearchesSections';\n\nexport type KeywordStartScreenTranslations = StoredSearchesSectionsTranslations;\n\ntype KeywordStartScreenProps = Omit<\n  ScreenStateProps<InternalDocSearchHit>,\n  'translations'\n> & {\n  hasCollections: boolean;\n  translations?: KeywordStartScreenTranslations;\n};\n\nexport function KeywordStartScreen({\n  translations = {},\n  ...props\n}: KeywordStartScreenProps): JSX.Element | null {\n  return (\n    <div className=\"DocSearch-Dropdown-Container\">\n      <StoredSearchesSections {...props} translations={translations} />\n    </div>\n  );\n}\n","import type {\n  AutocompleteApi,\n  AutocompleteState,\n  BaseItem,\n} from '@algolia/autocomplete-core';\nimport React from 'react';\n\nimport type { KeywordStartScreenTranslations } from './components/KeywordStartScreen';\nimport { KeywordStartScreen } from './components/KeywordStartScreen';\nimport type { DocSearchProps } from './DocSearch';\nimport type { ErrorScreenTranslations } from './ErrorScreen';\nimport { ErrorScreen } from './ErrorScreen';\nimport type { NoResultsScreenTranslations } from './NoResultsScreen';\nimport { NoResultsScreen } from './NoResultsScreen';\nimport type { ResultsScreenTranslations } from './ResultsScreen';\nimport { ResultsScreen } from './ResultsScreen';\nimport type { StoredSearchPlugin } from './stored-searches';\nimport type { InternalDocSearchHit, StoredDocSearchHit } from './types';\nimport { isQueryEmpty } from './utils';\n\nexport type ScreenStateTranslations = Partial<{\n  errorScreen: ErrorScreenTranslations;\n  startScreen: KeywordStartScreenTranslations;\n  noResultsScreen: NoResultsScreenTranslations;\n  resultsScreen: ResultsScreenTranslations;\n}>;\n\nexport interface ScreenStateProps<\n  TItem extends BaseItem,\n> extends AutocompleteApi<\n  TItem,\n  React.FormEvent,\n  React.MouseEvent,\n  React.KeyboardEvent\n> {\n  state: AutocompleteState<TItem>;\n  recentSearches: StoredSearchPlugin<StoredDocSearchHit>;\n  favoriteSearches: StoredSearchPlugin<StoredDocSearchHit>;\n  onItemClick: (\n    item: InternalDocSearchHit,\n    event: KeyboardEvent | MouseEvent\n  ) => void;\n  inputRef: React.MutableRefObject<HTMLInputElement | null>;\n  hitComponent: DocSearchProps['hitComponent'];\n  indexName: string;\n  disableUserPersonalization: boolean;\n  resultsFooterComponent: DocSearchProps['resultsFooterComponent'];\n  translations: ScreenStateTranslations;\n  getMissingResultsUrl?: DocSearchProps['getMissingResultsUrl'];\n  hasCollections: boolean;\n  resultBadgeKey?: string;\n}\n\nexport const ScreenState = React.memo(\n  ({ translations = {}, ...props }: ScreenStateProps<InternalDocSearchHit>) => {\n    if (props.state?.status === 'error') {\n      return <ErrorScreen translations={translations?.errorScreen} />;\n    }\n\n    if (isQueryEmpty(props.state.query)) {\n      return (\n        <KeywordStartScreen\n          {...props}\n          hasCollections={props.hasCollections}\n          translations={translations?.startScreen}\n        />\n      );\n    }\n\n    if (!props.hasCollections) {\n      return (\n        <NoResultsScreen\n          {...props}\n          translations={translations?.noResultsScreen}\n        />\n      );\n    }\n\n    return (\n      <ResultsScreen {...props} translations={translations?.resultsScreen} />\n    );\n  },\n  function areEqual(prevProps, nextProps) {\n    const isLoading =\n      nextProps.state.status === 'loading' ||\n      nextProps.state.status === 'stalled';\n\n    const isWaitingForCollections =\n      nextProps.state.status === 'idle' &&\n      !isQueryEmpty(nextProps.state.query) &&\n      prevProps.state.query !== nextProps.state.query &&\n      prevProps.state.collections === nextProps.state.collections;\n\n    return isLoading || isWaitingForCollections;\n  }\n);\n","import { createAutocomplete } from '@algolia/autocomplete-core';\nimport React, { type JSX } from 'react';\n\nimport type { FacetBarTranslations } from './components/FacetBar';\nimport { FacetBar } from './components/FacetBar';\nimport type { KeywordSearchBoxTranslations } from './components/KeywordSearchBox';\nimport { KeywordSearchBox } from './components/KeywordSearchBox';\nimport { ModalShell } from './components/ui/ModalShell';\nimport type { DocSearchProps } from './DocSearch';\nimport type { FooterTranslations } from './Footer';\nimport { Footer } from './Footer';\nimport { Hit } from './Hit';\nimport { useDocSearchFacets } from './hooks/useDocSearchFacets';\nimport { useSendItemClickEvent } from './hooks/useDocSearchInsights';\nimport { useInitialModalQuery } from './hooks/useInitialModalQuery';\nimport { useModalEnvironment } from './hooks/useModalEnvironment';\nimport { useModalRefs } from './hooks/useModalRefs';\nimport { useRefreshOnInitialQuery } from './hooks/useRefreshOnInitialQuery';\nimport { useSaveRecentSearch } from './hooks/useSaveRecentSearch';\nimport { useStoredDocSearches } from './hooks/useStoredDocSearches';\nimport type { ScreenStateTranslations } from './ScreenState';\nimport { ScreenState } from './ScreenState';\nimport type { DocSearchState, InternalDocSearchHit } from './types';\nimport { useSearchClient } from './useSearchClient';\nimport {\n  identity,\n  isModifierEvent,\n  isQueryEmpty,\n  noop,\n  scrollTo as scrollToUtils,\n} from './utils';\nimport {\n  buildNoQuerySources,\n  buildQuerySources,\n  type BuildQuerySourcesState,\n} from './utils/createDocSearchSources';\nimport { normalizeDocSearchIndexes } from './utils/normalizeDocSearchIndexes';\n\nexport type ModalTranslations = Partial<{\n  searchBox: KeywordSearchBoxTranslations;\n  footer: FooterTranslations;\n  facets: FacetBarTranslations;\n}> &\n  ScreenStateTranslations;\n\nexport type DocSearchModalProps = DocSearchProps & {\n  initialScrollY: number;\n  onClose?: () => void;\n  translations?: ModalTranslations;\n};\n\nexport function DocSearchModal({\n  appId,\n  apiKey,\n  maxResultsPerGroup,\n  theme,\n  onClose = noop,\n  transformItems = identity,\n  hitComponent = Hit,\n  resultsFooterComponent = (): JSX.Element | null => null,\n  navigator,\n  initialScrollY = 0,\n  transformSearchClient = identity,\n  disableUserPersonalization = false,\n  initialQuery: initialQueryFromProp = '',\n  translations = {},\n  getMissingResultsUrl,\n  insights = false,\n  recentSearchesLimit = 7,\n  recentSearchesWithFavoritesLimit = 4,\n  indices,\n  facets,\n  footerAction,\n  ...props\n}: DocSearchModalProps): JSX.Element {\n  const {\n    footer: footerTranslations,\n    searchBox: searchBoxTranslations,\n    facets: facetBarTranslations,\n    ...screenStateTranslations\n  } = translations;\n  const [state, setState] = React.useState<\n    DocSearchState<InternalDocSearchHit>\n  >({\n    query: '',\n    collections: [],\n    completion: null,\n    context: {},\n    isOpen: false,\n    activeItemId: null,\n    status: 'idle',\n  });\n\n  const placeholder =\n    translations?.searchBox?.placeholderText ||\n    props.placeholder ||\n    'Search docs';\n\n  const { containerRef, modalRef, formElementRef, dropdownRef, inputRef } =\n    useModalRefs();\n  const { initialQuery, initialQueryFromSelection } =\n    useInitialModalQuery(initialQueryFromProp);\n\n  const searchClient = useSearchClient(appId, apiKey, transformSearchClient);\n\n  const indexes = React.useMemo(\n    () =>\n      normalizeDocSearchIndexes({\n        indices,\n      }),\n    [indices]\n  );\n  const defaultIndexName = indexes[0].name;\n\n  const autocompleteRef =\n    React.useRef<\n      ReturnType<\n        typeof createAutocomplete<\n          InternalDocSearchHit,\n          React.FormEvent<HTMLFormElement>,\n          React.MouseEvent,\n          React.KeyboardEvent\n        >\n      >\n    >(undefined);\n\n  const {\n    visibleFacets,\n    facetSelections,\n    facetSelectionsRef,\n    handleFacetSelectionChange,\n    clearFacetSelections,\n  } = useDocSearchFacets({\n    facets,\n    indexes,\n    searchClient,\n    onSelectionsChange: () => autocompleteRef.current?.refresh(),\n  });\n\n  const { favoriteSearches, recentSearches } = useStoredDocSearches({\n    defaultIndexName,\n    recentSearchesLimit,\n    recentSearchesWithFavoritesLimit,\n  });\n  const saveRecentSearch = useSaveRecentSearch({\n    favoriteSearches,\n    recentSearches,\n    disableUserPersonalization,\n  });\n  const sendItemClickEvent = useSendItemClickEvent(state);\n\n  if (!autocompleteRef.current) {\n    autocompleteRef.current = createAutocomplete({\n      id: 'docsearch',\n      defaultActiveItemId: 0,\n      openOnFocus: true,\n      initialState: {\n        query: initialQuery,\n        context: {\n          searchSuggestions: [],\n        },\n      },\n      insights: Boolean(insights),\n      navigator,\n      onStateChange(changes) {\n        setState(changes.state);\n      },\n      getSources({ query, state: sourcesState, setContext, setStatus }) {\n        if (isQueryEmpty(query)) {\n          const noQuerySources = buildNoQuerySources({\n            recentSearches,\n            favoriteSearches,\n            saveRecentSearch,\n            onClose,\n            disableUserPersonalization,\n          });\n          return noQuerySources;\n        }\n\n        const querySourcesState: BuildQuerySourcesState = {\n          context: sourcesState.context,\n        };\n\n        const algoliaSourcesPromise = buildQuerySources({\n          query,\n          state: querySourcesState,\n          setContext,\n          setStatus,\n          searchClient,\n          indexes,\n          insights: Boolean(insights),\n          appId,\n          apiKey,\n          maxResultsPerGroup,\n          transformItems,\n          saveRecentSearch,\n          onClose,\n          facetSelections: facetSelectionsRef,\n        });\n\n        return algoliaSourcesPromise;\n      },\n    });\n  }\n\n  const autocomplete = autocompleteRef.current;\n\n  const { getEnvironmentProps, getRootProps, refresh } = autocomplete;\n\n  useModalEnvironment({\n    getEnvironmentProps,\n    containerRef,\n    dropdownRef,\n    formElementRef,\n    inputRef,\n    initialScrollY,\n    modalRef,\n    theme,\n  });\n\n  React.useEffect(() => {\n    if (dropdownRef.current) {\n      scrollToUtils(dropdownRef.current);\n    }\n  }, [state.query, dropdownRef]);\n\n  useRefreshOnInitialQuery({ initialQuery, inputRef, refresh });\n\n  // hide the dropdown on idle and no collections\n  let showDocsearchDropdown = true;\n  const hasCollections = state.collections.some(\n    (collection) => collection.items.length > 0\n  );\n  if (\n    state.status === 'idle' &&\n    hasCollections === false &&\n    isQueryEmpty(state.query)\n  ) {\n    showDocsearchDropdown = false;\n  }\n\n  return (\n    <ModalShell\n      state={state}\n      containerRef={containerRef}\n      modalRef={modalRef}\n      formElementRef={formElementRef}\n      dropdownRef={dropdownRef}\n      getRootProps={getRootProps}\n      showDropdown={showDocsearchDropdown}\n      searchBox={\n        <KeywordSearchBox\n          {...autocomplete}\n          state={state}\n          placeholder={placeholder || 'Search docs'}\n          autoFocus={isQueryEmpty(initialQuery)}\n          inputRef={inputRef}\n          isFromSelection={\n            Boolean(initialQuery) && initialQuery === initialQueryFromSelection\n          }\n          translations={searchBoxTranslations}\n          onClose={onClose}\n        />\n      }\n      filterBar={\n        !isQueryEmpty(state.query) ? (\n          <FacetBar\n            facets={visibleFacets}\n            selections={facetSelections}\n            translations={facetBarTranslations}\n            clearSelections={clearFacetSelections}\n            onSelectionChange={handleFacetSelectionChange}\n          />\n        ) : null\n      }\n      screenState={\n        <ScreenState\n          {...autocomplete}\n          indexName={defaultIndexName}\n          state={state}\n          hitComponent={hitComponent}\n          resultsFooterComponent={resultsFooterComponent}\n          disableUserPersonalization={disableUserPersonalization}\n          recentSearches={recentSearches}\n          favoriteSearches={favoriteSearches}\n          inputRef={inputRef}\n          translations={screenStateTranslations}\n          getMissingResultsUrl={getMissingResultsUrl}\n          hasCollections={hasCollections}\n          resultBadgeKey={props.resultBadgeKey}\n          onItemClick={(item, event) => {\n            sendItemClickEvent(item);\n            saveRecentSearch(item);\n            if (!isModifierEvent(event)) {\n              onClose();\n            }\n          }}\n        />\n      }\n      footer={\n        <Footer translations={footerTranslations} footerAction={footerAction} />\n      }\n      onClose={onClose}\n    />\n  );\n}\n"],"mappings":";;;;;;;;qBAoCE;AADF,SAAgB,iBAAiB,MAGM;KAHN,EAC/B,eAAe,CAAC,YACb;CAEH,MAAM,EACJ,mBAAmB,SACnB,uBAAuB,mBACvB,kBAAkB,SAClB,uBAAuB,SACvB,mBAAmB,aACjB;CAEJ,MAAM,qBACJ,0DACE,oCAAC,UAAD;EACE,WAAU;EACV,MAAK;EACL,cAAY;EACZ,QAAQ,CAAC,MAAM,MAAM;EACrB,UAAU,MAAM,MAAM,QAAQ,IAAI;EAClC,eAAa,CAAC,MAAM,MAAM,QAAQ,SAAS;CAGrC,GADL,gBACK,GAEP,MAAM,MAAM,SAAS,oCAAC,OAAD,EAAK,WAAU,oBAAqB,EAC1D;CAGJ,OACE,oCAAC,iDACK;EACc;EACI;EACL;EACK;EACJ;EAClB,YAAY,EACV,cAAc,SAChB;EACoB;EACrB;AAEL;;;;qBC3DE;AADF,SAAgB,mBAAmB,MAGa;KAHb,EACjC,eAAe,CAAC,YACb;CAEH,OACE,oCAAC,OAAD,EAAK,WAAU,+BAEV,GADH,oCAAC,0DAA2B,cAAqB,cAAe,EAC7D;AAET;;;;qBC2BK;AADL,MAAa,cAAc,MAAM,MAC9B,SAA4E;;KAA5E,EAAE,eAAe,CAAC,YAAM;CACvB,qBAAI,MAAM,mEAAO,YAAW,SAC1B,OAAO,oCAAC,aAAD,EAAa,0EAAc,aAAc,YAAc;CAGhE,IAAI,aAAa,MAAM,MAAM,KAAK,GAChC,OACE,oCAAC,sDACK;EACJ,gBAAgB,MAAM;EACtB,0EAAc,aAAc;EAC7B;CAIL,IAAI,CAAC,MAAM,gBACT,OACE,oCAAC,mDACK,cACJ,0EAAc,aAAc,iBAC7B;CAIL,OACE,oCAAC,iDAAkB,cAAO,0EAAc,aAAc,eAAgB;AAE1E,GACA,SAAS,SAAS,WAAW,WAAW;CACtC,MAAM,YACJ,UAAU,MAAM,WAAW,aAC3B,UAAU,MAAM,WAAW;CAE7B,MAAM,0BACJ,UAAU,MAAM,WAAW,UAC3B,CAAC,aAAa,UAAU,MAAM,KAAK,KACnC,UAAU,MAAM,UAAU,UAAU,MAAM,SAC1C,UAAU,MAAM,gBAAgB,UAAU,MAAM;CAElD,OAAO,aAAa;AACtB,CACF;;;;;CC3CE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;;CAIE;CACA;CACA;;AA3BJ,SAAgB,eAAe,MAuBM;;KAvBN,EAC7B,OACA,QACA,oBACA,OACA,UAAU,MACV,iBAAiB,UACjB,eAAe,KACf,+BAAmD,MACnD,WACA,iBAAiB,GACjB,wBAAwB,UACxB,6BAA6B,OAC7B,cAAc,uBAAuB,IACrC,eAAe,CAAC,GAChB,sBACA,WAAW,OACX,sBAAsB,GACtB,mCAAmC,GACnC,SACA,QACA,uBACG;CAEH,MAAM,EACJ,QAAQ,oBACR,WAAW,uBACX,QAAQ,uCACL,mDACD;CACJ,MAAM,CAAC,OAAO,YAAY,MAAM,SAE9B;EACA,OAAO;EACP,aAAa,CAAC;EACd,YAAY;EACZ,SAAS,CAAC;EACV,QAAQ;EACR,cAAc;EACd,QAAQ;CACV,CAAC;CAED,MAAM,4FACJ,aAAc,yFAAW,oBACzB,MAAM,eACN;CAEF,MAAM,EAAE,cAAc,UAAU,gBAAgB,aAAa,aAC3D,aAAa;CACf,MAAM,EAAE,cAAc,8BACpB,qBAAqB,oBAAoB;CAE3C,MAAM,eAAe,gBAAgB,OAAO,QAAQ,qBAAqB;CAEzE,MAAM,UAAU,MAAM,cAElB,0BAA0B,EACxB,QACF,CAAC,GACH,CAAC,OAAO,CACV;CACA,MAAM,mBAAmB,QAAQ,EAAE,CAAC;CAEpC,MAAM,kBACJ,MAAM,OASJ,MAAS;CAEb,MAAM,EACJ,eACA,iBACA,oBACA,4BACA,yBACE,mBAAmB;EACrB;EACA;EACA;EACA,0BAA0B;;mDAAgB,uFAAS,QAAQ;;CAC7D,CAAC;CAED,MAAM,EAAE,kBAAkB,mBAAmB,qBAAqB;EAChE;EACA;EACA;CACF,CAAC;CACD,MAAM,mBAAmB,oBAAoB;EAC3C;EACA;EACA;CACF,CAAC;CACD,MAAM,qBAAqB,sBAAsB,KAAK;CAEtD,IAAI,CAAC,gBAAgB,SACnB,gBAAgB,UAAU,mBAAmB;EAC3C,IAAI;EACJ,qBAAqB;EACrB,aAAa;EACb,cAAc;GACZ,OAAO;GACP,SAAS,EACP,mBAAmB,CAAC,EACtB;EACF;EACA,UAAU,QAAQ,QAAQ;EAC1B;EACA,cAAc,SAAS;GACrB,SAAS,QAAQ,KAAK;EACxB;EACA,WAAW,EAAE,OAAO,OAAO,cAAc,YAAY,aAAa;GAChE,IAAI,aAAa,KAAK,GAQpB,OAPuB,oBAAoB;IACzC;IACA;IACA;IACA;IACA;GACF,CACoB;GAwBtB,OAjB8B,kBAAkB;IAC9C;IACA,OAAO,EALP,SAAS,aAAa,QAKC;IACvB;IACA;IACA;IACA;IACA,UAAU,QAAQ,QAAQ;IAC1B;IACA;IACA;IACA;IACA;IACA;IACA,iBAAiB;GACnB,CAE2B;EAC7B;CACF,CAAC;CAGH,MAAM,eAAe,gBAAgB;CAErC,MAAM,EAAE,qBAAqB,cAAc,YAAY;CAEvD,oBAAoB;EAClB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAED,MAAM,gBAAgB;EACpB,IAAI,YAAY,SACd,SAAc,YAAY,OAAO;CAErC,GAAG,CAAC,MAAM,OAAO,WAAW,CAAC;CAE7B,yBAAyB;EAAE;EAAc;EAAU;CAAQ,CAAC;CAG5D,IAAI,wBAAwB;CAC5B,MAAM,iBAAiB,MAAM,YAAY,MACtC,eAAe,WAAW,MAAM,SAAS,CAC5C;CACA,IACE,MAAM,WAAW,UACjB,mBAAmB,SACnB,aAAa,MAAM,KAAK,GAExB,wBAAwB;CAG1B,OACE,oCAAC,YAAD;EACS;EACO;EACJ;EACM;EACH;EACC;EACd,cAAc;EACd,WACE,oCAAC,oDACK;GACG;GACP,aAAa,eAAe;GAC5B,WAAW,aAAa,YAAY;GAC1B;GACV,iBACE,QAAQ,YAAY,KAAK,iBAAiB;GAE5C,cAAc;GACL;GACV;EAEH,WACE,CAAC,aAAa,MAAM,KAAK,IACvB,oCAAC,UAAD;GACE,QAAQ;GACR,YAAY;GACZ,cAAc;GACd,iBAAiB;GACjB,mBAAmB;EACpB,KACC;EAEN,aACE,oCAAC,+CACK;GACJ,WAAW;GACJ;GACO;GACU;GACI;GACZ;GACE;GACR;GACV,cAAc;GACQ;GACN;GAChB,gBAAgB,MAAM;GACtB,cAAc,MAAM,UAAU;IAC5B,mBAAmB,IAAI;IACvB,iBAAiB,IAAI;IACrB,IAAI,CAAC,gBAAgB,KAAK,GACxB,QAAQ;GAEZ;GACD;EAEH,QACE,oCAAC,QAAD;GAAQ,cAAc;GAAkC;EAAe;EAEhE;CACV;AAEL"}

package/dist/esm/askaiModal.d.ts

@@ -1,2 +1,2 @@
-import { d as DocSearchAskAiModalProps, f as DocSearchAskAiModalTranslations, u as DocSearchAskAiModal } from "./DocSearchAI-DKtAqje2.js";
+import { d as DocSearchAskAiModalProps, f as DocSearchAskAiModalTranslations, u as DocSearchAskAiModal } from "./DocSearchAI-f-C2lV8l.js";
 export { DocSearchAskAiModal, DocSearchAskAiModalProps, DocSearchAskAiModalTranslations };

package/dist/esm/askaiModal.js

@@ -1,3 +1,3 @@
-import { t as DocSearchAskAiModal } from "./DocSearchAskAiModal-BzQZxvTY.js";
+import { t as DocSearchAskAiModal } from "./DocSearchAskAiModal-CZm9AVU0.js";
 
 export { DocSearchAskAiModal };

package/dist/esm/docsearch.d.ts

@@ -1,2 +1,2 @@
-import { a as DocSearchProps, c as DocSearchTranslations, i as DocSearchInner, l as HitComponentProps, n as DocSearchFacet, o as DocSearchRef, r as DocSearchIndex, s as DocSearchTransformClient, t as DocSearch, u as ResultsFooterComponentProps } from "./DocSearch-2gNxdJcC.js";
+import { a as DocSearchProps, c as DocSearchTranslations, i as DocSearchInner, l as HitComponentProps, n as DocSearchFacet, o as DocSearchRef, r as DocSearchIndex, s as DocSearchTransformClient, t as DocSearch, u as ResultsFooterComponentProps } from "./DocSearch-BFLV-F2L.js";
 export { DocSearch, DocSearchFacet, DocSearchIndex, DocSearchInner, DocSearchProps, type DocSearchRef, DocSearchTransformClient, DocSearchTranslations, HitComponentProps, ResultsFooterComponentProps };

package/dist/esm/docsearch.js

@@ -1,7 +1,7 @@
 import { t as _objectSpread2 } from "./objectSpread2-BNmiQYyW.js";
 import { t as DocSearchButton } from "./DocSearchButton-CaxxOzQU.js";
 import { t as _objectWithoutProperties } from "./objectWithoutProperties-phqYxDS0.js";
-import { t as DocSearchModal } from "./DocSearchModal-Cgdi4eHY.js";
+import { t as DocSearchModal } from "./DocSearchModal-CLcbYBea.js";
 import { DocSearch as DocSearch$1, useDocSearch } from "@docsearch/core";
 import React from "react";
 import { createPortal } from "react-dom";

package/dist/esm/docsearchAi.d.ts

@@ -1,3 +1,3 @@
 import { o as ToolCalls } from "./index-BijiN4hK.js";
-import { a as DocSearchAIProps, c as Memory, i as DocSearchAIInner, l as PromptSuggestions, n as AskAiSearchParameters, o as DocSearchAITranslations, r as DocSearchAI, s as DocSearchAskAi, t as AgentStudioSearchParameters } from "./DocSearchAI-DKtAqje2.js";
+import { a as DocSearchAIProps, c as Memory, i as DocSearchAIInner, l as PromptSuggestions, n as AskAiSearchParameters, o as DocSearchAITranslations, r as DocSearchAI, s as DocSearchAskAi, t as AgentStudioSearchParameters } from "./DocSearchAI-f-C2lV8l.js";
 export { AgentStudioSearchParameters, AskAiSearchParameters, DocSearchAI, DocSearchAIInner, DocSearchAIProps, DocSearchAITranslations, DocSearchAskAi, Memory, PromptSuggestions, type ToolCalls };

package/dist/esm/docsearchAi.js

@@ -1,7 +1,7 @@
 import { t as _objectSpread2 } from "./objectSpread2-BNmiQYyW.js";
 import { t as DocSearchButton } from "./DocSearchButton-CaxxOzQU.js";
 import { t as _objectWithoutProperties } from "./objectWithoutProperties-phqYxDS0.js";
-import { t as DocSearchAskAiModal } from "./DocSearchAskAiModal-BzQZxvTY.js";
+import { t as DocSearchAskAiModal } from "./DocSearchAskAiModal-CZm9AVU0.js";
 import { DocSearch, useDocSearch } from "@docsearch/core";
 import React from "react";
 import { createPortal } from "react-dom";

package/dist/esm/index.d.ts

@@ -1,8 +1,8 @@
 import { a as StoredDocSearchHit, c as AskAiFeedbackReason, d as DocSearchHit, i as StoredAskAiState, l as OnAskAiFeedback, n as SuggestedQuestionHit, o as ToolCalls, r as StoredAskAiMessage, s as AskAiFeedbackPayload, t as SuggestedQuestion, u as DocSearchState } from "./index-BijiN4hK.js";
 import { t as DocSearchTheme } from "./DocSearchTheme-DvL4mf0D.js";
-import { a as DocSearchProps, b as InternalDocSearchHit, c as DocSearchTranslations, d as DocSearchModal, f as DocSearchModalProps, i as DocSearchInner, l as HitComponentProps, n as DocSearchFacet, o as DocSearchRef, p as ModalTranslations, r as DocSearchIndex, s as DocSearchTransformClient, t as DocSearch, u as ResultsFooterComponentProps } from "./DocSearch-2gNxdJcC.js";
+import { a as DocSearchProps, b as InternalDocSearchHit, c as DocSearchTranslations, d as DocSearchModal, f as DocSearchModalProps, i as DocSearchInner, l as HitComponentProps, n as DocSearchFacet, o as DocSearchRef, p as ModalTranslations, r as DocSearchIndex, s as DocSearchTransformClient, t as DocSearch, u as ResultsFooterComponentProps } from "./DocSearch-BFLV-F2L.js";
 import { n as useDocSearchKeyboardEvents, r as KeyboardShortcuts, t as UseDocSearchKeyboardEventsProps } from "./useDocSearchKeyboardEvents-B7PKBkuX.js";
 import { n as DocSearchButton, r as DocSearchButtonProps, t as ButtonTranslations } from "./DocSearchButton-DyJd_QGM.js";
-import { a as DocSearchAIProps, c as Memory, d as DocSearchAskAiModalProps, f as DocSearchAskAiModalTranslations, i as DocSearchAIInner, l as PromptSuggestions, n as AskAiSearchParameters, o as DocSearchAITranslations, r as DocSearchAI, s as DocSearchAskAi, t as AgentStudioSearchParameters, u as DocSearchAskAiModal } from "./DocSearchAI-DKtAqje2.js";
+import { a as DocSearchAIProps, c as Memory, d as DocSearchAskAiModalProps, f as DocSearchAskAiModalTranslations, i as DocSearchAIInner, l as PromptSuggestions, n as AskAiSearchParameters, o as DocSearchAITranslations, r as DocSearchAI, s as DocSearchAskAi, t as AgentStudioSearchParameters, u as DocSearchAskAiModal } from "./DocSearchAI-f-C2lV8l.js";
 import { version } from "./version.js";
 export { AgentStudioSearchParameters, AskAiFeedbackPayload, AskAiFeedbackReason, AskAiSearchParameters, ButtonTranslations, DocSearch, DocSearchAI, DocSearchAIInner, DocSearchAIProps, DocSearchAITranslations, DocSearchAskAi, DocSearchAskAiModal, DocSearchAskAiModalProps, DocSearchAskAiModalTranslations, DocSearchButton, DocSearchButtonProps, DocSearchFacet, DocSearchHit, DocSearchIndex, DocSearchInner, DocSearchModal, DocSearchModalProps, DocSearchProps, type DocSearchRef, DocSearchState, DocSearchTheme, DocSearchTransformClient, DocSearchTranslations, HitComponentProps, InternalDocSearchHit, KeyboardShortcuts, Memory, ModalTranslations, OnAskAiFeedback, PromptSuggestions, ResultsFooterComponentProps, StoredAskAiMessage, StoredAskAiState, StoredDocSearchHit, SuggestedQuestion, SuggestedQuestionHit, type ToolCalls, UseDocSearchKeyboardEventsProps, useDocSearchKeyboardEvents, version };

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 import { t as DocSearchButton } from "./DocSearchButton-CaxxOzQU.js";
-import { t as DocSearchAskAiModal } from "./DocSearchAskAiModal-BzQZxvTY.js";
-import { t as DocSearchModal } from "./DocSearchModal-Cgdi4eHY.js";
+import { t as DocSearchAskAiModal } from "./DocSearchAskAiModal-CZm9AVU0.js";
+import { t as DocSearchModal } from "./DocSearchModal-CLcbYBea.js";
 import { version } from "./version.js";
 import { DocSearch, DocSearchInner } from "./docsearch.js";
 import { DocSearchAI, DocSearchAIInner } from "./docsearchAi.js";

package/dist/esm/modal.d.ts

@@ -1,2 +1,2 @@
-import { d as DocSearchModal, f as DocSearchModalProps, p as ModalTranslations } from "./DocSearch-2gNxdJcC.js";
+import { d as DocSearchModal, f as DocSearchModalProps, p as ModalTranslations } from "./DocSearch-BFLV-F2L.js";
 export { DocSearchModal, DocSearchModalProps, ModalTranslations };

package/dist/esm/modal.js

@@ -1,3 +1,3 @@
-import { t as DocSearchModal } from "./DocSearchModal-Cgdi4eHY.js";
+import { t as DocSearchModal } from "./DocSearchModal-CLcbYBea.js";
 
 export { DocSearchModal };

package/dist/esm/{normalizeDocSearchIndexes-CFHzf-sx.js → normalizeDocSearchIndexes-B_bI_ytC.js}

@@ -239,18 +239,58 @@ function getFacetLabel(facet) {
 	if (facet.label) return facet.label;
 	return facet.key.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 }
+/**
+* Extracts the facet key from an Algolia `facetFilters` string entry such as
+* `language:en`. Returns `null` when the entry doesn't have a `key:value`
+* shape.
+*/
+function getFacetFilterKey(facetFilter) {
+	const separatorIndex = facetFilter.indexOf(":");
+	return separatorIndex <= 0 ? null : facetFilter.slice(0, separatorIndex);
+}
+function parseFacetFilter(facetFilter) {
+	const key = getFacetFilterKey(facetFilter);
+	if (key === null) return null;
+	const value = facetFilter.slice(key.length + 1);
+	return value ? {
+		key,
+		value
+	} : null;
+}
+/**
+* Reads the initial facet selections from the configured `facetFilters` of each
+* index. Later indices override earlier ones for the same facet key.
+*
+* - A `key:value` string selects a single value.
+* - A nested OR group whose entries all share the same key (for example
+*   `['docusaurus_tag:default', 'docusaurus_tag:docs-default-current']`)
+*   selects every value in the group.
+* - OR groups that mix facet keys can't map to a single facet and are ignored.
+*/
 function deriveDefaultSelectedFacetsFromIndex(indices) {
 	const defaultFacets = {};
 	for (const index of indices) {
 		var _index$searchParamete;
 		const facetFilters = (_index$searchParamete = index.searchParameters) === null || _index$searchParamete === void 0 ? void 0 : _index$searchParamete.facetFilters;
 		for (const facetFilter of Array.isArray(facetFilters) ? facetFilters : [facetFilters]) {
-			if (typeof facetFilter !== "string") continue;
-			const separatorIndex = facetFilter.indexOf(":");
-			if (separatorIndex <= 0) continue;
-			const key = facetFilter.slice(0, separatorIndex);
-			const value = facetFilter.slice(separatorIndex + 1);
-			if (key && value) defaultFacets[key] = value;
+			if (typeof facetFilter === "string") {
+				const parsed = parseFacetFilter(facetFilter);
+				if (parsed) defaultFacets[parsed.key] = [parsed.value];
+				continue;
+			}
+			if (!Array.isArray(facetFilter) || facetFilter.length === 0) continue;
+			let groupKey = null;
+			const groupValues = [];
+			for (const entry of facetFilter) {
+				const parsed = typeof entry === "string" ? parseFacetFilter(entry) : null;
+				if (!parsed || groupKey !== null && parsed.key !== groupKey) {
+					groupKey = null;
+					break;
+				}
+				groupKey = parsed.key;
+				groupValues.push(parsed.value);
+			}
+			if (groupKey !== null) defaultFacets[groupKey] = groupValues;
 		}
 	}
 	return defaultFacets;
@@ -284,8 +324,10 @@ const _excluded2 = [
 	"collisionBoundary",
 	"container"
 ];
-const _excluded3 = ["className", "children"];
-const _excluded4 = ["className"];
+const _excluded3 = ["className"];
+const _excluded4 = ["className", "children"];
+const _excluded5 = ["className", "children"];
+const _excluded6 = ["className"];
 function Menu$1(_ref) {
 	let props = _extends({}, (_objectDestructuringEmpty(_ref), _ref));
 	return /* @__PURE__ */ React.createElement(Menu.Root, props);
@@ -310,13 +352,19 @@ function MenuPopup(_ref3) {
 	}, /* @__PURE__ */ React.createElement(Menu.Popup, _objectSpread2({ className: "DocSearch-Menu-Popup" }, props))));
 }
 Menu$1.Popup = MenuPopup;
-function MenuRadioGroup(_ref4) {
-	let props = _extends({}, (_objectDestructuringEmpty(_ref4), _ref4));
+function MenuItem(_ref4) {
+	let { className } = _ref4, props = _objectWithoutProperties(_ref4, _excluded3);
+	const cn = `DocSearch-Menu-Item${className ? ` ${className}` : ""}`;
+	return /* @__PURE__ */ React.createElement(Menu.Item, _objectSpread2({ className: cn }, props));
+}
+Menu$1.Item = MenuItem;
+function MenuRadioGroup(_ref5) {
+	let props = _extends({}, (_objectDestructuringEmpty(_ref5), _ref5));
 	return /* @__PURE__ */ React.createElement(Menu.RadioGroup, props);
 }
 Menu$1.RadioGroup = MenuRadioGroup;
-function MenuRadioItem(_ref5) {
-	let { className, children } = _ref5, props = _objectWithoutProperties(_ref5, _excluded3);
+function MenuRadioItem(_ref6) {
+	let { className, children } = _ref6, props = _objectWithoutProperties(_ref6, _excluded4);
 	const cn = `DocSearch-Menu-Item DocSearch-Menu-RadioItem${className ? ` ${className}` : ""}`;
 	return /* @__PURE__ */ React.createElement(Menu.RadioItem, _objectSpread2({
 		className: cn,
@@ -324,8 +372,14 @@ function MenuRadioItem(_ref5) {
 	}, props), /* @__PURE__ */ React.createElement("span", { className: "DocSearch-Menu-RadioItem-Indicator" }, /* @__PURE__ */ React.createElement(Menu.RadioItemIndicator, null, /* @__PURE__ */ React.createElement(CheckIcon, null))), children);
 }
 Menu$1.RadioItem = MenuRadioItem;
-function MenuGroupLabel(_ref6) {
-	let { className } = _ref6, props = _objectWithoutProperties(_ref6, _excluded4);
+function MenuCheckboxItem(_ref7) {
+	let { className, children } = _ref7, props = _objectWithoutProperties(_ref7, _excluded5);
+	const cn = `DocSearch-Menu-Item DocSearch-Menu-CheckboxItem${className ? ` ${className}` : ""}`;
+	return /* @__PURE__ */ React.createElement(Menu.CheckboxItem, _objectSpread2({ className: cn }, props), /* @__PURE__ */ React.createElement("span", { className: "DocSearch-Menu-CheckboxItem-Indicator" }, /* @__PURE__ */ React.createElement(Menu.CheckboxItemIndicator, null, /* @__PURE__ */ React.createElement(CheckIcon, null))), children);
+}
+Menu$1.CheckboxItem = MenuCheckboxItem;
+function MenuGroupLabel(_ref8) {
+	let { className } = _ref8, props = _objectWithoutProperties(_ref8, _excluded6);
 	const cn = `DocSearch-Menu-GroupLabel${className ? ` ${className}` : ""}`;
 	return /* @__PURE__ */ React.createElement(Menu.GroupLabel, _objectSpread2({ className: cn }, props));
 }
@@ -333,34 +387,64 @@ Menu$1.GroupLabel = MenuGroupLabel;
 
 //#endregion
 //#region src/components/FacetBar.tsx
-const FacetMenu = React.memo(function FacetMenu({ facet, selectedValue, defaultValueLabel, onSelectionChange, registerTrigger, menuTriggerSelectedAriaLabel }) {
+const EMPTY_SELECTION$1 = [];
+const FacetValueItem = React.memo(function FacetValueItem({ facetKey, value, checked, onToggle }) {
+	const handleCheckedChange = React.useCallback(() => {
+		onToggle(facetKey, value);
+	}, [
+		facetKey,
+		onToggle,
+		value
+	]);
+	return /* @__PURE__ */ React.createElement(Menu$1.CheckboxItem, {
+		checked,
+		label: value,
+		onCheckedChange: handleCheckedChange
+	}, capitalize(value));
+});
+function toggleValue(value) {
+	return (currentValues) => currentValues.includes(value) ? currentValues.filter((selected) => selected !== value) : [...currentValues, value];
+}
+function removeValue(value) {
+	return (currentValues) => currentValues.filter((selected) => selected !== value);
+}
+const FacetMenu = React.memo(function FacetMenu({ facet, selectedValues, defaultValueLabel, onSelectionChange, registerTrigger, menuTriggerSelectedAriaLabel }) {
 	const label = getFacetLabel(facet);
-	const handleValueChange = React.useCallback((value) => {
-		onSelectionChange(facet.key, value);
+	const hasSelection = selectedValues.length > 0;
+	const selectedSet = React.useMemo(() => new Set(selectedValues), [selectedValues]);
+	const handleToggleValue = React.useCallback((facetKey, value) => {
+		onSelectionChange(facetKey, toggleValue(value));
+	}, [onSelectionChange]);
+	const handleSelectAll = React.useCallback(() => {
+		onSelectionChange(facet.key, EMPTY_SELECTION$1);
 	}, [facet.key, onSelectionChange]);
 	const triggerRef = React.useCallback((el) => {
 		registerTrigger(facet.key, el);
 	}, [facet.key, registerTrigger]);
 	return /* @__PURE__ */ React.createElement(Menu$1, null, /* @__PURE__ */ React.createElement(Menu$1.Trigger, {
 		ref: triggerRef,
-		"data-has-selection": Boolean(selectedValue),
-		"aria-label": selectedValue ? `${label}, ${selectedValue} ${menuTriggerSelectedAriaLabel}` : label
-	}, /* @__PURE__ */ React.createElement("span", null, capitalize(label)), /* @__PURE__ */ React.createElement(ChevronIcon, null)), /* @__PURE__ */ React.createElement(Menu$1.Popup, null, /* @__PURE__ */ React.createElement(Menu$1.RadioGroup, {
-		value: selectedValue,
-		onValueChange: handleValueChange
-	}, /* @__PURE__ */ React.createElement(Menu$1.RadioItem, {
-		value: "",
-		label: `${defaultValueLabel} ${label}`
-	}, defaultValueLabel), facet.values.map((value) => /* @__PURE__ */ React.createElement(Menu$1.RadioItem, {
+		"data-has-selection": hasSelection,
+		"aria-label": hasSelection ? `${label}, ${selectedValues.join(", ")} ${menuTriggerSelectedAriaLabel}` : label
+	}, /* @__PURE__ */ React.createElement("span", null, capitalize(label)), /* @__PURE__ */ React.createElement(ChevronIcon, null)), /* @__PURE__ */ React.createElement(Menu$1.Popup, null, /* @__PURE__ */ React.createElement(Menu$1.Item, {
+		className: "DocSearch-Menu-ResetItem",
+		label: `${defaultValueLabel} ${label}`,
+		onClick: handleSelectAll
+	}, defaultValueLabel), facet.values.map((value) => /* @__PURE__ */ React.createElement(FacetValueItem, {
 		key: value,
+		facetKey: facet.key,
 		value,
-		label: value
-	}, capitalize(value))))));
+		checked: selectedSet.has(value),
+		onToggle: handleToggleValue
+	}))));
 });
 const SelectedFacetChip = React.memo(function SelectedFacetChip({ facetKey, facetLabel, value, dismissAriaLabel, onDismiss }) {
 	const handleDismissFacet = React.useCallback((e) => {
-		onDismiss(facetKey, e);
-	}, [facetKey, onDismiss]);
+		onDismiss(facetKey, value, e);
+	}, [
+		facetKey,
+		onDismiss,
+		value
+	]);
 	return /* @__PURE__ */ React.createElement(Chip, null, capitalize(value), /* @__PURE__ */ React.createElement(Chip.Dismiss, {
 		"aria-label": `${dismissAriaLabel} ${capitalize(value)} (${facetLabel})`,
 		onClick: handleDismissFacet
@@ -370,14 +454,19 @@ const FacetBar = React.memo(function FacetBar({ facets, selections, onSelectionC
 	const { defaultValueLabel = "All", facetMenuTriggerAriaLabel = "selected", clearAllLabel = "Clear all", facetsAriaLabel = "Search filters", selectedFacetsAriaLabel = "Selected search filters", clearFacetAriaLabel = "Clear filter:" } = translations;
 	const visibleFacetKeys = React.useMemo(() => new Set(facets.map((f) => f.key)), [facets]);
 	const selectionsToDisplay = React.useMemo(() => {
-		return Object.entries(selections).filter(([key, value]) => Boolean(value) && visibleFacetKeys.has(key));
+		const entries = [];
+		for (const [key, values] of Object.entries(selections)) {
+			if (!visibleFacetKeys.has(key)) continue;
+			for (const value of values) entries.push([key, value]);
+		}
+		return entries;
 	}, [selections, visibleFacetKeys]);
 	const triggerRefs = React.useRef(/* @__PURE__ */ new Map());
 	const registerTrigger = React.useCallback((facetKey, el) => {
 		if (el) triggerRefs.current.set(facetKey, el);
 		else triggerRefs.current.delete(facetKey);
 	}, []);
-	const handleDismissFacet = React.useCallback((facetKey, ev) => {
+	const handleDismissFacet = React.useCallback((facetKey, value, ev) => {
 		const dismissButton = ev.currentTarget;
 		const selectionBar = dismissButton.closest(".DocSearch-FacetSelectionBar");
 		if (selectionBar) {
@@ -387,7 +476,7 @@ const FacetBar = React.memo(function FacetBar({ facets, selections, onSelectionC
 			const target = (_ref = (_dismissButtons = dismissButtons[index + 1]) !== null && _dismissButtons !== void 0 ? _dismissButtons : dismissButtons[index - 1]) !== null && _ref !== void 0 ? _ref : triggerRefs.current.get(facetKey);
 			target === null || target === void 0 || target.focus();
 		}
-		onSelectionChange(facetKey, "");
+		onSelectionChange(facetKey, removeValue(value));
 	}, [onSelectionChange]);
 	const handleClearAll = React.useCallback(() => {
 		var _triggerRefs$current$;
@@ -402,11 +491,10 @@ const FacetBar = React.memo(function FacetBar({ facets, selections, onSelectionC
 		"aria-label": facetsAriaLabel
 	}, facets.map((facet) => {
 		var _selections$facet$key;
-		const selectedValue = (_selections$facet$key = selections[facet.key]) !== null && _selections$facet$key !== void 0 ? _selections$facet$key : "";
 		return /* @__PURE__ */ React.createElement(FacetMenu, {
 			key: facet.key,
 			facet,
-			selectedValue,
+			selectedValues: (_selections$facet$key = selections[facet.key]) !== null && _selections$facet$key !== void 0 ? _selections$facet$key : EMPTY_SELECTION$1,
 			defaultValueLabel,
 			registerTrigger,
 			menuTriggerSelectedAriaLabel: facetMenuTriggerAriaLabel,
@@ -419,7 +507,7 @@ const FacetBar = React.memo(function FacetBar({ facets, selections, onSelectionC
 	}, selectionsToDisplay.map(([key, value]) => {
 		var _facetLabels$get;
 		return /* @__PURE__ */ React.createElement(SelectedFacetChip, {
-			key,
+			key: `${key}:${value}`,
 			facetKey: key,
 			facetLabel: (_facetLabels$get = facetLabels.get(key)) !== null && _facetLabels$get !== void 0 ? _facetLabels$get : key,
 			value,
@@ -598,6 +686,19 @@ function useFacetValues({ facets, indexes, searchClient }) {
 
 //#endregion
 //#region src/hooks/useDocSearchFacets.ts
+const EMPTY_SELECTION = [];
+/**
+* Compares two selections for a facet. A missing entry and an empty array are
+* both "nothing selected" so clearing an untouched facet doesn't trigger a
+* refresh.
+*/
+function areSelectionsEqual(a, b) {
+	const left = a !== null && a !== void 0 ? a : EMPTY_SELECTION;
+	const right = b !== null && b !== void 0 ? b : EMPTY_SELECTION;
+	if (left === right) return true;
+	if (left.length !== right.length) return false;
+	return left.every((value, index) => value === right[index]);
+}
 function useDocSearchFacets({ facets, indexes, searchClient, onSelectionsChange }) {
 	const normalizedFacets = React.useMemo(() => normalizeFacets(facets), [facets]);
 	const normalizedFacetsRef = React.useRef(normalizedFacets);
@@ -627,16 +728,23 @@ function useDocSearchFacets({ facets, indexes, searchClient, onSelectionsChange
 		visibleFacets,
 		facetSelections,
 		facetSelectionsRef,
-		handleFacetSelectionChange: React.useCallback((facet, value) => {
-			if (facetSelectionsRef.current[facet] === value) return;
-			const next = _objectSpread2({}, facetSelectionsRef.current);
-			next[facet] = value;
-			applySelections(next);
+		handleFacetSelectionChange: React.useCallback((facet, update) => {
+			const existing = facetSelectionsRef.current[facet];
+			const values = typeof update === "function" ? update(existing !== null && existing !== void 0 ? existing : EMPTY_SELECTION) : update;
+			if (areSelectionsEqual(existing, values)) return;
+			applySelections(_objectSpread2(_objectSpread2({}, facetSelectionsRef.current), {}, { [facet]: values }));
 		}, [applySelections]),
 		clearFacetSelections: React.useCallback(() => {
-			if (Object.keys(facetSelectionsRef.current).length === 0) return;
+			const current = facetSelectionsRef.current;
 			const next = {};
-			for (const facet of normalizedFacetsRef.current) if (facetSelectionsRef.current[facet.key]) next[facet.key] = "";
+			let hasSelectedValues = false;
+			for (const facet of normalizedFacetsRef.current) {
+				const values = current[facet.key];
+				if (values === void 0) continue;
+				if (values.length > 0) hasSelectedValues = true;
+				next[facet.key] = EMPTY_SELECTION;
+			}
+			if (!hasSelectedValues) return;
 			applySelections(next);
 		}, [applySelections])
 	};
@@ -1130,21 +1238,31 @@ function ResultsScreen(_ref) {
 
 //#endregion
 //#region src/utils/createDocSearchSources.ts
+function isFacetFilterOverridden(facetFilter, selectedFacets) {
+	if (typeof facetFilter === "string") {
+		const key = getFacetFilterKey(facetFilter);
+		return key !== null && selectedFacets.has(key);
+	}
+	return facetFilter.length > 0 && facetFilter.every((entry) => isFacetFilterOverridden(entry, selectedFacets));
+}
+/**
+* Merges configured `facetFilters` with the user's facet selections.
+*
+* Multiple values selected for the same facet are combined into an OR group
+* (nested array). Different facets are combined with AND (top-level entries),
+* following Algolia `facetFilters` semantics.
+*/
 function createFacetFilters(searchParametersFacetFilters, facetSelections) {
 	const selections = Object.entries(facetSelections);
+	if (selections.length === 0) return searchParametersFacetFilters;
 	const selectedFacets = new Set(selections.map(([facet]) => facet));
 	const dynamicFacetFilters = [];
-	for (const [facet, selection] of selections) if (selection !== "") dynamicFacetFilters.push(`${facet}:${selection}`);
-	if (selectedFacets.size === 0) return searchParametersFacetFilters;
+	for (const [facet, values] of selections) if (values.length === 1) dynamicFacetFilters.push(`${facet}:${values[0]}`);
+	else if (values.length > 1) dynamicFacetFilters.push(values.map((value) => `${facet}:${value}`));
 	let configuredFacetFilters = [];
 	if (searchParametersFacetFilters && Array.isArray(searchParametersFacetFilters)) configuredFacetFilters = searchParametersFacetFilters;
 	else if (searchParametersFacetFilters) configuredFacetFilters = [searchParametersFacetFilters];
-	return [...configuredFacetFilters.filter((facetFilter) => {
-		if (typeof facetFilter !== "string") return true;
-		const separatorIndex = facetFilter.indexOf(":");
-		const facet = facetFilter.slice(0, separatorIndex);
-		return separatorIndex <= 0 || !selectedFacets.has(facet);
-	}), ...dynamicFacetFilters];
+	return [...configuredFacetFilters.filter((facetFilter) => !isFacetFilterOverridden(facetFilter, selectedFacets)), ...dynamicFacetFilters];
 }
 function buildNoQuerySources({ recentSearches, favoriteSearches, saveRecentSearch, onClose, disableUserPersonalization }) {
 	if (disableUserPersonalization) return [];
@@ -1268,4 +1386,4 @@ function normalizeDocSearchIndexes({ indices }) {
 
 //#endregion
 export { noop as C, SOURCE_IDS as D, identity as E, getCollection as O, scrollTo as S, isModifierEvent as T, Hit as _, NoResultsScreen as a, SearchBoxForm as b, Results as c, useRefreshOnInitialQuery as d, useModalRefs as f, useDocSearchFacets as g, useSendItemClickEvent as h, ResultsScreen as i, useStoredDocSearches as l, useInitialModalQuery as m, buildNoQuerySources as n, ErrorScreen as o, useModalEnvironment as p, buildQuerySources as r, StoredSearchesSections as s, normalizeDocSearchIndexes as t, useSaveRecentSearch as u, Footer as v, isQueryEmpty as w, FacetBar as x, ModalShell as y };
-//# sourceMappingURL=normalizeDocSearchIndexes-CFHzf-sx.js.map
+//# sourceMappingURL=normalizeDocSearchIndexes-B_bI_ytC.js.map