@docsearch/core 4.7.0 → 5.0.0-beta.1

package/dist/esm/index.d.ts

@@ -1,138 +1,71 @@
-import React, { JSX } from 'react';
-
-interface DocSearchModalShortcuts {
-    /**
-     * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.
-     *
-     * @default true
-     */
-    'Ctrl/Cmd+K'?: boolean;
-    /**
-     * Enable/disable the / shortcut to open the DocSearch modal.
-     *
-     * @default true
-     */
-    '/'?: boolean;
-}
-interface SidepanelShortcuts {
-    /**
-     * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.
-     *
-     * @default true
-     */
-    'Ctrl/Cmd+I'?: boolean;
-}
-type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;
-/**
- * Default keyboard shortcuts configuration for DocSearch.
- * These values are used when no keyboardShortcuts prop is provided
- * or when specific shortcuts are not configured.
- */
-declare const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts>;
-/**
- * Merges user-provided keyboard shortcuts with defaults.
- *
- * @param userShortcuts - Optional user configuration.
- * @returns Complete keyboard shortcuts configuration with defaults applied.
- */
-declare function useKeyboardShortcuts(userShortcuts?: KeyboardShortcuts): Required<KeyboardShortcuts>;
-
-type DocSearchTheme = 'dark' | 'light';
-interface UseThemeProps {
-    theme?: DocSearchTheme;
-}
-declare const useTheme: ({ theme }: UseThemeProps) => void;
-
+import { DEFAULT_KEYBOARD_SHORTCUTS, DocSearchModalShortcuts, KeyboardShortcuts, SidepanelShortcuts, useKeyboardShortcuts } from "./useKeyboardShortcuts.js";
+import { DocSearchTheme, UseThemeProps, useTheme } from "./useTheme.js";
+import { UseDocSearchKeyboardEventsProps, useDocSearchKeyboardEvents } from "./useDocSearchKeyboardEvents.js";
+import React, { JSX } from "react";
+//#region src/DocSearch.d.ts
 type DocSearchState = 'modal-askai' | 'modal-search' | 'ready' | 'sidepanel';
 type View = 'modal' | 'sidepanel' | (Record<string, unknown> & string);
 type InitialAskAiMessage = {
-    query: string;
-    messageId?: string;
-    suggestedQuestionId?: string;
+  query: string;
+  messageId?: string;
+  suggestedQuestionId?: string;
 };
 type OnAskAiToggle = (active: boolean, initialMessage?: InitialAskAiMessage) => void;
-/**
- * Imperative handle exposed by the DocSearch provider for programmatic control.
- */
+/** Imperative handle exposed by the DocSearch provider for programmatic control. */
 interface DocSearchRef {
-    /** Opens the search modal. */
-    open: () => void;
-    /** Closes the search modal. */
-    close: () => void;
-    /** Opens Ask AI mode (sidepanel if available, otherwise modal). */
-    openAskAi: (initialMessage?: InitialAskAiMessage) => void;
-    /** Opens the sidepanel directly (no-op if sidepanel view not registered). */
-    openSidepanel: (initialMessage?: InitialAskAiMessage) => void;
-    /** Returns true once the component is mounted and ready. */
-    readonly isReady: boolean;
-    /** Returns true if the modal is currently open. */
-    readonly isOpen: boolean;
-    /** Returns true if the sidepanel is currently open. */
-    readonly isSidepanelOpen: boolean;
-    /** Returns true if sidepanel view is registered (hybrid mode). */
-    readonly isSidepanelSupported: boolean;
+  /** Opens the search modal. */
+  open: () => void;
+  /** Closes the search modal. */
+  close: () => void;
+  /** Opens Ask AI mode (sidepanel if available, otherwise modal). */
+  openAskAi: (initialMessage?: InitialAskAiMessage) => void;
+  /** Opens the sidepanel directly (no-op if sidepanel view not registered). */
+  openSidepanel: (initialMessage?: InitialAskAiMessage) => void;
+  /** Returns true once the component is mounted and ready. */
+  readonly isReady: boolean;
+  /** Returns true if the modal is currently open. */
+  readonly isOpen: boolean;
+  /** Returns true if the sidepanel is currently open. */
+  readonly isSidepanelOpen: boolean;
+  /** Returns true if sidepanel view is registered (hybrid mode). */
+  readonly isSidepanelSupported: boolean;
 }
 interface DocSearchContext {
-    docsearchState: DocSearchState;
-    setDocsearchState: (newState: DocSearchState) => void;
-    searchButtonRef: React.RefObject<HTMLButtonElement | null>;
-    initialQuery: string;
-    keyboardShortcuts: Required<KeyboardShortcuts>;
-    openModal: () => void;
-    closeModal: () => void;
-    isAskAiActive: boolean;
-    isModalActive: boolean;
-    onAskAiToggle: OnAskAiToggle;
-    initialAskAiMessage: InitialAskAiMessage | undefined;
-    clearInitialAskAiMessage: () => void;
-    registerView: (view: View) => void;
-    isHybridModeSupported: boolean;
+  docsearchState: DocSearchState;
+  setDocsearchState: (newState: DocSearchState) => void;
+  searchButtonRef: React.RefObject<HTMLButtonElement | null>;
+  initialQuery: string;
+  keyboardShortcuts: Required<KeyboardShortcuts>;
+  openModal: () => void;
+  closeModal: () => void;
+  isAskAiActive: boolean;
+  isModalActive: boolean;
+  onAskAiToggle: OnAskAiToggle;
+  initialAskAiMessage: InitialAskAiMessage | undefined;
+  registerView: (view: View) => void;
+  isHybridModeSupported: boolean;
 }
-/**
- * Lifecycle callbacks for DocSearch.
- */
+/** Lifecycle callbacks for DocSearch. */
 interface DocSearchCallbacks {
-    /** Called once DocSearch is mounted and ready for interaction. */
-    onReady?: () => void;
-    /** Called when the modal opens. */
-    onOpen?: () => void;
-    /** Called when the modal closes. */
-    onClose?: () => void;
-    /** Called when the sidepanel opens. */
-    onSidepanelOpen?: () => void;
-    /** Called when the sidepanel closes. */
-    onSidepanelClose?: () => void;
+  /** Called once DocSearch is mounted and ready for interaction. */
+  onReady?: () => void;
+  /** Called when the modal opens. */
+  onOpen?: () => void;
+  /** Called when the modal closes. */
+  onClose?: () => void;
+  /** Called when the sidepanel opens. */
+  onSidepanelOpen?: () => void;
+  /** Called when the sidepanel closes. */
+  onSidepanelClose?: () => void;
 }
 interface DocSearchProps extends DocSearchCallbacks {
-    children: Array<JSX.Element | null> | JSX.Element | React.ReactNode | null;
-    theme?: DocSearchTheme;
-    initialQuery?: string;
-    keyboardShortcuts?: KeyboardShortcuts;
+  children: Array<JSX.Element | null> | JSX.Element | React.ReactNode | null;
+  theme?: DocSearchTheme;
+  initialQuery?: string;
+  keyboardShortcuts?: KeyboardShortcuts;
 }
 declare const DocSearch: React.ForwardRefExoticComponent<DocSearchProps & React.RefAttributes<DocSearchRef>>;
 declare function useDocSearch(): DocSearchContext;
-
-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, isAskAiActive, onAskAiToggle, onClose, onOpen, keyboardShortcuts, }: UseDocSearchKeyboardEventsProps): void;
-
-export { DEFAULT_KEYBOARD_SHORTCUTS, DocSearch, useDocSearch, useDocSearchKeyboardEvents, useKeyboardShortcuts, useTheme };
-export type { DocSearchCallbacks, DocSearchContext, DocSearchModalShortcuts, DocSearchProps, DocSearchRef, DocSearchState, DocSearchTheme, InitialAskAiMessage, KeyboardShortcuts, OnAskAiToggle, SidepanelShortcuts, UseDocSearchKeyboardEventsProps, UseThemeProps, View };
+//#endregion
+export { DEFAULT_KEYBOARD_SHORTCUTS, DocSearch, DocSearchCallbacks, DocSearchContext, DocSearchModalShortcuts, DocSearchProps, DocSearchRef, DocSearchState, DocSearchTheme, InitialAskAiMessage, KeyboardShortcuts, OnAskAiToggle, SidepanelShortcuts, UseDocSearchKeyboardEventsProps, UseThemeProps, View, useDocSearch, useDocSearchKeyboardEvents, useKeyboardShortcuts, useTheme };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -1 +1,207 @@
-import e,{useEffect as t}from"react";function n(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,r=Array(t);n<t;n++)r[n]=e[n];return r}function r(e,t,n){return(t=function(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var n=e[Symbol.toPrimitive];if(void 0!==n){var r=n.call(e,t);if("object"!=typeof r)return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function a(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach(function(t){r(e,t,n[t])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})}return e}function i(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,a,i,u=[],l=!0,c=!1;try{if(a=(n=n.call(e)).next,0===t);else for(;!(l=(r=a.call(n)).done)&&(u.push(r.value),u.length!==t);l=!0);}catch(e){c=!0,o=e}finally{try{if(!l&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(c)throw o}}return u}}(e,t)||function(e,t){if(e){if("string"==typeof e)return n(e,t);var r={}.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(e):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?n(e,t):void 0}}(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}var u={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};function l(e){return a(a({},u),e)}function c(t){var n=t.isOpen,r=t.isAskAiActive,o=t.onAskAiToggle,a=t.onClose,i=t.onOpen,l=t.keyboardShortcuts,c=void 0===l?u:l;e.useEffect(function(){function e(e){var t;if(n&&"Escape"===e.code&&r)o(!1);else{var u=c["Ctrl/Cmd+K"]&&"k"===(null===(t=e.key)||void 0===t?void 0:t.toLowerCase())&&(e.metaKey||e.ctrlKey),l=c["/"]&&"/"===e.key;("Escape"===e.code&&n||u||!function(e){var t=e.composedPath()[0],n=t.tagName;return t.isContentEditable||"INPUT"===n||"SELECT"===n||"TEXTAREA"===n||"BUTTON"===n}(e)&&l&&!n)&&(e.preventDefault(),n?a():document.body.classList.contains("DocSearch--active")||i())}}return window.addEventListener("keydown",e),function(){window.removeEventListener("keydown",e)}},[n,r,c,i,a,o])}var s=function(e){var n=e.theme;t(function(){if(n){var e=document.documentElement.dataset.theme;if(n!==e)return document.documentElement.dataset.theme=n,function(){void 0===e?delete document.documentElement.dataset.theme:document.documentElement.dataset.theme=e}}},[n])},d=["children","theme","onReady","onOpen","onClose","onSidepanelOpen","onSidepanelClose"],f=e.createContext(void 0);f.displayName="DocSearchContext";var p=e.forwardRef(function(t,n){var r=t.children,o=t.theme,a=t.onReady,u=t.onOpen,p=t.onClose,m=t.onSidepanelOpen,v=t.onSidepanelClose,y=function(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n={};for(var r in e)if({}.hasOwnProperty.call(e,r)){if(-1!==t.indexOf(r))continue;n[r]=e[r]}return n}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r<a.length;r++)n=a[r],-1===t.indexOf(n)&&{}.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}(t,d),h=i(e.useState("ready"),2),b=h[0],S=h[1],O=i(e.useState(y.initialQuery||""),2),w=O[0],g=O[1],k=e.useRef(null),A=l(y.keyboardShortcuts),C=i(e.useState(),2),E=C[0],j=C[1],P=i(e.useState(function(){return new Set}),2),D=P[0],T=P[1],x=function(){var t=i(e.useState(!1),2),n=t[0],r=t[1];return e.useEffect(function(){var e=function(){var e=window.matchMedia("(max-width: 768px)");r(e.matches)};return e(),window.addEventListener("resize",e),function(){window.removeEventListener("resize",e)}},[]),n}(),M=e.useRef("ready"),I=["modal-search","modal-askai"].includes(b),R="modal-askai"===b,L=!x&&D.has("sidepanel"),N="sidepanel"===b;e.useEffect(function(){null==a||a()},[a]),e.useEffect(function(){var e=M.current,t=b;"modal-search"!==t&&"modal-askai"!==t||"modal-search"===e||"modal-askai"===e||null==u||u(),"ready"!==t||"modal-search"!==e&&"modal-askai"!==e||null==p||p(),"sidepanel"===t&&"sidepanel"!==e&&(null==m||m()),"sidepanel"!==t&&"sidepanel"===e&&(null==v||v()),M.current=t},[b,u,p,m,v]);var K=e.useCallback(function(){S("modal-search")},[]),Q=e.useCallback(function(){var e,t;S("ready"),null===(e=k.current)||void 0===e||e.focus(),g(null!==(t=y.initialQuery)&&void 0!==t?t:"")},[S,y.initialQuery]),U=e.useCallback(function(e,t){if(!x&&e&&L)return j(t),void S("sidepanel");S(e?"modal-askai":"modal-search")},[S,x,L]),z=e.useCallback(function(e){D.has("sidepanel")&&(j(e),S("sidepanel"))},[S,D]);e.useCallback(function(e){S("modal-search"),g(e.key)},[S,g]);var B=e.useCallback(function(){j(void 0)},[]),H=e.useCallback(function(e){D.has(e)||T(function(t){var n=new Set(t);return n.add(e),n})},[D]);e.useImperativeHandle(n,function(){return{open:K,close:Q,openAskAi:function(e){return U(!0,e)},openSidepanel:z,get isReady(){return!0},get isOpen(){return I},get isSidepanelOpen(){return N},get isSidepanelSupported(){return L}}},[K,Q,U,z,I,N,L]),s({theme:o}),c({isOpen:I,onOpen:K,onClose:Q,onAskAiToggle:U,isAskAiActive:R,keyboardShortcuts:A});var V=e.useMemo(function(){return{docsearchState:b,setDocsearchState:S,searchButtonRef:k,initialQuery:w,keyboardShortcuts:A,openModal:K,closeModal:Q,isAskAiActive:R,isModalActive:I,onAskAiToggle:U,initialAskAiMessage:E,clearInitialAskAiMessage:B,registerView:H,isHybridModeSupported:L}},[b,k,w,A,K,Q,R,I,U,E,B,H,L]);return e.createElement(f.Provider,{value:V},r)});function m(){var t=e.useContext(f);if(void 0===t)throw new Error("`useDocSearch` must be used within the `DocSearch` provider");return t}p.displayName="DocSearch";export{u as DEFAULT_KEYBOARD_SHORTCUTS,p as DocSearch,m as useDocSearch,c as useDocSearchKeyboardEvents,l as useKeyboardShortcuts,s as useTheme};
+import { n as useKeyboardShortcuts, t as DEFAULT_KEYBOARD_SHORTCUTS } from "./useKeyboardShortcuts-D47pg3fZ.js";
+import { useDocSearchKeyboardEvents } from "./useDocSearchKeyboardEvents.js";
+import { useTheme } from "./useTheme.js";
+import React from "react";
+
+//#region src/useIsMobile.ts
+const useIsMobile = () => {
+	const [isMobile, setIsMobile] = React.useState(false);
+	React.useEffect(() => {
+		const checkForMobile = () => {
+			const isMobileMediaQuery = window.matchMedia("(max-width: 768px)");
+			setIsMobile(isMobileMediaQuery.matches);
+		};
+		checkForMobile();
+		window.addEventListener("resize", checkForMobile);
+		return () => {
+			window.removeEventListener("resize", checkForMobile);
+		};
+	}, []);
+	return isMobile;
+};
+
+//#endregion
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/objectWithoutPropertiesLoose.js
+function _objectWithoutPropertiesLoose(r, e) {
+	if (null == r) return {};
+	var t = {};
+	for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
+		if (e.includes(n)) continue;
+		t[n] = r[n];
+	}
+	return t;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/objectWithoutProperties.js
+function _objectWithoutProperties(e, t) {
+	if (null == e) return {};
+	var o, r, i = _objectWithoutPropertiesLoose(e, t);
+	if (Object.getOwnPropertySymbols) {
+		var s = Object.getOwnPropertySymbols(e);
+		for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]);
+	}
+	return i;
+}
+
+//#endregion
+//#region src/DocSearch.tsx
+const _excluded = [
+	"children",
+	"theme",
+	"onReady",
+	"onOpen",
+	"onClose",
+	"onSidepanelOpen",
+	"onSidepanelClose"
+];
+const Context = React.createContext(void 0);
+Context.displayName = "DocSearchContext";
+function DocSearchInner(_ref, ref) {
+	let { children, theme, onReady, onOpen, onClose, onSidepanelOpen, onSidepanelClose } = _ref, props = _objectWithoutProperties(_ref, _excluded);
+	const [docsearchState, setDocsearchState] = React.useState("ready");
+	const [initialQuery, setInitialQuery] = React.useState(props.initialQuery || "");
+	const searchButtonRef = React.useRef(null);
+	const keyboardShortcuts = useKeyboardShortcuts(props.keyboardShortcuts);
+	const [initialAskAiMessage, setInitialAskAiMessage] = React.useState();
+	const [registeredViews, setRegisteredViews] = React.useState(() => /* @__PURE__ */ new Set());
+	const isMobile = useIsMobile();
+	const prevStateRef = React.useRef("ready");
+	const isModalActive = ["modal-search", "modal-askai"].includes(docsearchState);
+	const isAskAiActive = docsearchState === "modal-askai";
+	const isHybridModeSupported = !isMobile && registeredViews.has("sidepanel");
+	const isSidepanelOpen = docsearchState === "sidepanel";
+	React.useEffect(() => {
+		onReady === null || onReady === void 0 || onReady();
+	}, [onReady]);
+	React.useEffect(() => {
+		const prevState = prevStateRef.current;
+		const currentState = docsearchState;
+		if ((currentState === "modal-search" || currentState === "modal-askai") && prevState !== "modal-search" && prevState !== "modal-askai") onOpen === null || onOpen === void 0 || onOpen();
+		if (currentState === "ready" && (prevState === "modal-search" || prevState === "modal-askai")) onClose === null || onClose === void 0 || onClose();
+		if (currentState === "sidepanel" && prevState !== "sidepanel") onSidepanelOpen === null || onSidepanelOpen === void 0 || onSidepanelOpen();
+		if (currentState !== "sidepanel" && prevState === "sidepanel") onSidepanelClose === null || onSidepanelClose === void 0 || onSidepanelClose();
+		prevStateRef.current = currentState;
+	}, [
+		docsearchState,
+		onOpen,
+		onClose,
+		onSidepanelOpen,
+		onSidepanelClose
+	]);
+	const openModal = React.useCallback(() => {
+		setDocsearchState("modal-search");
+	}, []);
+	const closeModal = React.useCallback(() => {
+		var _searchButtonRef$curr, _props$initialQuery;
+		setDocsearchState("ready");
+		(_searchButtonRef$curr = searchButtonRef.current) === null || _searchButtonRef$curr === void 0 || _searchButtonRef$curr.focus();
+		setInitialQuery((_props$initialQuery = props.initialQuery) !== null && _props$initialQuery !== void 0 ? _props$initialQuery : "");
+	}, [setDocsearchState, props.initialQuery]);
+	const onAskAiToggle = React.useCallback((active, initialMessage) => {
+		if (!isMobile && active && isHybridModeSupported) {
+			setInitialAskAiMessage(initialMessage);
+			setDocsearchState("sidepanel");
+			return;
+		}
+		setDocsearchState(active ? "modal-askai" : "modal-search");
+	}, [
+		setDocsearchState,
+		isMobile,
+		isHybridModeSupported
+	]);
+	const openSidepanel = React.useCallback((initialMessage) => {
+		if (!registeredViews.has("sidepanel")) return;
+		setInitialAskAiMessage(initialMessage);
+		setDocsearchState("sidepanel");
+	}, [setDocsearchState, registeredViews]);
+	const onInput = React.useCallback((event) => {
+		setDocsearchState("modal-search");
+		setInitialQuery(event.key);
+	}, [setDocsearchState, setInitialQuery]);
+	const registerView = React.useCallback((view) => {
+		if (registeredViews.has(view)) return;
+		setRegisteredViews((prev) => {
+			const newViews = new Set(prev);
+			newViews.add(view);
+			return newViews;
+		});
+	}, [registeredViews]);
+	React.useImperativeHandle(ref, () => ({
+		open: openModal,
+		close: closeModal,
+		openAskAi: (initialMessage) => onAskAiToggle(true, initialMessage),
+		openSidepanel,
+		get isReady() {
+			return true;
+		},
+		get isOpen() {
+			return isModalActive;
+		},
+		get isSidepanelOpen() {
+			return isSidepanelOpen;
+		},
+		get isSidepanelSupported() {
+			return isHybridModeSupported;
+		}
+	}), [
+		openModal,
+		closeModal,
+		onAskAiToggle,
+		openSidepanel,
+		isModalActive,
+		isSidepanelOpen,
+		isHybridModeSupported
+	]);
+	useTheme({ theme });
+	useDocSearchKeyboardEvents({
+		isOpen: isModalActive,
+		onOpen: openModal,
+		onClose: closeModal,
+		onAskAiToggle,
+		onInput,
+		isAskAiActive,
+		searchButtonRef,
+		keyboardShortcuts
+	});
+	const value = React.useMemo(() => ({
+		docsearchState,
+		setDocsearchState,
+		searchButtonRef,
+		initialQuery,
+		keyboardShortcuts,
+		openModal,
+		closeModal,
+		isAskAiActive,
+		isModalActive,
+		onAskAiToggle,
+		initialAskAiMessage,
+		registerView,
+		isHybridModeSupported
+	}), [
+		docsearchState,
+		searchButtonRef,
+		initialQuery,
+		keyboardShortcuts,
+		openModal,
+		closeModal,
+		isAskAiActive,
+		isModalActive,
+		onAskAiToggle,
+		initialAskAiMessage,
+		registerView,
+		isHybridModeSupported
+	]);
+	return /* @__PURE__ */ React.createElement(Context.Provider, { value }, children);
+}
+const DocSearch = React.forwardRef(DocSearchInner);
+DocSearch.displayName = "DocSearch";
+function useDocSearch() {
+	const ctx = React.useContext(Context);
+	if (ctx === void 0) throw new Error("`useDocSearch` must be used within the `DocSearch` provider");
+	return ctx;
+}
+
+//#endregion
+export { DEFAULT_KEYBOARD_SHORTCUTS, DocSearch, useDocSearch, useDocSearchKeyboardEvents, useKeyboardShortcuts, useTheme };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/useIsMobile.ts","../../src/DocSearch.tsx"],"sourcesContent":["import React from 'react';\n\nexport const useIsMobile = (): boolean => {\n  const [isMobile, setIsMobile] = React.useState(false);\n\n  React.useEffect(() => {\n    const checkForMobile = (): void => {\n      const isMobileMediaQuery = window.matchMedia('(max-width: 768px)');\n\n      setIsMobile(isMobileMediaQuery.matches);\n    };\n\n    checkForMobile();\n\n    window.addEventListener('resize', checkForMobile);\n\n    return (): void => {\n      window.removeEventListener('resize', checkForMobile);\n    };\n  }, []);\n\n  return isMobile;\n};\n","import type { JSX } from 'react';\nimport React from 'react';\n\nimport { useDocSearchKeyboardEvents } from './useDocSearchKeyboardEvents';\nimport { useIsMobile } from './useIsMobile';\nimport { useKeyboardShortcuts } from './useKeyboardShortcuts';\nimport type { KeyboardShortcuts } from './useKeyboardShortcuts.ts';\nimport type { DocSearchTheme } from './useTheme';\nimport { useTheme } from './useTheme';\n\nexport type DocSearchState =\n  | 'modal-askai'\n  | 'modal-search'\n  | 'ready'\n  | 'sidepanel';\n\nexport type View = 'modal' | 'sidepanel' | (Record<string, unknown> & string);\n\nexport type InitialAskAiMessage = {\n  query: string;\n  messageId?: string;\n  suggestedQuestionId?: string;\n};\n\nexport type OnAskAiToggle = (\n  active: boolean,\n  initialMessage?: InitialAskAiMessage\n) => void;\n\n/** Imperative handle exposed by the DocSearch provider for programmatic control. */\nexport interface DocSearchRef {\n  /** Opens the search modal. */\n  open: () => void;\n  /** Closes the search modal. */\n  close: () => void;\n  /** Opens Ask AI mode (sidepanel if available, otherwise modal). */\n  openAskAi: (initialMessage?: InitialAskAiMessage) => void;\n  /** Opens the sidepanel directly (no-op if sidepanel view not registered). */\n  openSidepanel: (initialMessage?: InitialAskAiMessage) => void;\n  /** Returns true once the component is mounted and ready. */\n  readonly isReady: boolean;\n  /** Returns true if the modal is currently open. */\n  readonly isOpen: boolean;\n  /** Returns true if the sidepanel is currently open. */\n  readonly isSidepanelOpen: boolean;\n  /** Returns true if sidepanel view is registered (hybrid mode). */\n  readonly isSidepanelSupported: boolean;\n}\n\nexport interface DocSearchContext {\n  docsearchState: DocSearchState;\n  setDocsearchState: (newState: DocSearchState) => void;\n  searchButtonRef: React.RefObject<HTMLButtonElement | null>;\n  initialQuery: string;\n  keyboardShortcuts: Required<KeyboardShortcuts>;\n  openModal: () => void;\n  closeModal: () => void;\n  isAskAiActive: boolean;\n  isModalActive: boolean;\n  onAskAiToggle: OnAskAiToggle;\n  initialAskAiMessage: InitialAskAiMessage | undefined;\n  registerView: (view: View) => void;\n  isHybridModeSupported: boolean;\n}\n\n/** Lifecycle callbacks for DocSearch. */\nexport interface DocSearchCallbacks {\n  /** Called once DocSearch is mounted and ready for interaction. */\n  onReady?: () => void;\n  /** Called when the modal opens. */\n  onOpen?: () => void;\n  /** Called when the modal closes. */\n  onClose?: () => void;\n  /** Called when the sidepanel opens. */\n  onSidepanelOpen?: () => void;\n  /** Called when the sidepanel closes. */\n  onSidepanelClose?: () => void;\n}\n\nexport interface DocSearchProps extends DocSearchCallbacks {\n  children: Array<JSX.Element | null> | JSX.Element | React.ReactNode | null;\n  theme?: DocSearchTheme;\n  initialQuery?: string;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nconst Context = React.createContext<DocSearchContext | undefined>(undefined);\nContext.displayName = 'DocSearchContext';\n\nfunction DocSearchInner(\n  {\n    children,\n    theme,\n    onReady,\n    onOpen,\n    onClose,\n    onSidepanelOpen,\n    onSidepanelClose,\n    ...props\n  }: DocSearchProps,\n  ref: React.ForwardedRef<DocSearchRef>\n): JSX.Element {\n  const [docsearchState, setDocsearchState] =\n    React.useState<DocSearchState>('ready');\n  const [initialQuery, setInitialQuery] = React.useState<string>(\n    props.initialQuery || ''\n  );\n  const searchButtonRef = React.useRef<HTMLButtonElement>(null);\n  const keyboardShortcuts = useKeyboardShortcuts(props.keyboardShortcuts);\n  const [initialAskAiMessage, setInitialAskAiMessage] =\n    React.useState<InitialAskAiMessage>();\n  const [registeredViews, setRegisteredViews] = React.useState(\n    () => new Set<View>()\n  );\n  const isMobile = useIsMobile();\n  const prevStateRef = React.useRef<DocSearchState>('ready');\n\n  const isModalActive = ['modal-search', 'modal-askai'].includes(\n    docsearchState\n  );\n  const isAskAiActive = docsearchState === 'modal-askai';\n  const isHybridModeSupported = !isMobile && registeredViews.has('sidepanel');\n  const isSidepanelOpen = docsearchState === 'sidepanel';\n\n  // Call onReady on mount\n  React.useEffect(() => {\n    onReady?.();\n  }, [onReady]);\n\n  // Track state changes for lifecycle callbacks\n  React.useEffect(() => {\n    const prevState = prevStateRef.current;\n    const currentState = docsearchState;\n\n    // Modal opened\n    if (\n      (currentState === 'modal-search' || currentState === 'modal-askai') &&\n      prevState !== 'modal-search' &&\n      prevState !== 'modal-askai'\n    ) {\n      onOpen?.();\n    }\n\n    // Modal closed\n    if (\n      currentState === 'ready' &&\n      (prevState === 'modal-search' || prevState === 'modal-askai')\n    ) {\n      onClose?.();\n    }\n\n    // Sidepanel opened\n    if (currentState === 'sidepanel' && prevState !== 'sidepanel') {\n      onSidepanelOpen?.();\n    }\n\n    // Sidepanel closed\n    if (currentState !== 'sidepanel' && prevState === 'sidepanel') {\n      onSidepanelClose?.();\n    }\n\n    prevStateRef.current = currentState;\n  }, [docsearchState, onOpen, onClose, onSidepanelOpen, onSidepanelClose]);\n\n  const openModal = React.useCallback((): void => {\n    setDocsearchState('modal-search');\n  }, []);\n\n  const closeModal = React.useCallback((): void => {\n    setDocsearchState('ready');\n    // Refocus the Modal trigger on close\n    searchButtonRef.current?.focus();\n    setInitialQuery(props.initialQuery ?? '');\n  }, [setDocsearchState, props.initialQuery]);\n\n  const onAskAiToggle: OnAskAiToggle = React.useCallback(\n    (active, initialMessage) => {\n      // Don't use hybrid mode on mobile\n      if (!isMobile && active && isHybridModeSupported) {\n        setInitialAskAiMessage(initialMessage);\n        setDocsearchState('sidepanel');\n        return;\n      }\n\n      setDocsearchState(active ? 'modal-askai' : 'modal-search');\n    },\n    [setDocsearchState, isMobile, isHybridModeSupported]\n  );\n\n  const openSidepanel = React.useCallback(\n    (initialMessage?: InitialAskAiMessage): void => {\n      // Guard: no-op if sidepanel view hasn't been registered\n      if (!registeredViews.has('sidepanel')) return;\n\n      setInitialAskAiMessage(initialMessage);\n      setDocsearchState('sidepanel');\n    },\n    [setDocsearchState, registeredViews]\n  );\n\n  const onInput = React.useCallback(\n    (event: KeyboardEvent): void => {\n      setDocsearchState('modal-search');\n      setInitialQuery(event.key);\n    },\n    [setDocsearchState, setInitialQuery]\n  );\n\n  const registerView = React.useCallback(\n    (view: View): void => {\n      if (registeredViews.has(view)) return;\n\n      setRegisteredViews((prev) => {\n        const newViews = new Set(prev);\n        newViews.add(view);\n        return newViews;\n      });\n    },\n    [registeredViews]\n  );\n\n  // Expose imperative handle for programmatic control\n  React.useImperativeHandle(\n    ref,\n    () => ({\n      open: openModal,\n      close: closeModal,\n      openAskAi: (initialMessage?: InitialAskAiMessage): void =>\n        onAskAiToggle(true, initialMessage),\n      openSidepanel,\n      get isReady(): boolean {\n        return true;\n      },\n      get isOpen(): boolean {\n        return isModalActive;\n      },\n      get isSidepanelOpen(): boolean {\n        return isSidepanelOpen;\n      },\n      get isSidepanelSupported(): boolean {\n        return isHybridModeSupported;\n      },\n    }),\n    [\n      openModal,\n      closeModal,\n      onAskAiToggle,\n      openSidepanel,\n      isModalActive,\n      isSidepanelOpen,\n      isHybridModeSupported,\n    ]\n  );\n\n  useTheme({ theme });\n\n  useDocSearchKeyboardEvents({\n    isOpen: isModalActive,\n    onOpen: openModal,\n    onClose: closeModal,\n    onAskAiToggle,\n    onInput,\n    isAskAiActive,\n    searchButtonRef,\n    keyboardShortcuts,\n  });\n\n  const value: DocSearchContext = React.useMemo(\n    () => ({\n      docsearchState,\n      setDocsearchState,\n      searchButtonRef,\n      initialQuery,\n      keyboardShortcuts,\n      openModal,\n      closeModal,\n      isAskAiActive,\n      isModalActive,\n      onAskAiToggle,\n      initialAskAiMessage,\n      registerView,\n      isHybridModeSupported,\n    }),\n    [\n      docsearchState,\n      searchButtonRef,\n      initialQuery,\n      keyboardShortcuts,\n      openModal,\n      closeModal,\n      isAskAiActive,\n      isModalActive,\n      onAskAiToggle,\n      initialAskAiMessage,\n      registerView,\n      isHybridModeSupported,\n    ]\n  );\n\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport const DocSearch = React.forwardRef(DocSearchInner);\nDocSearch.displayName = 'DocSearch';\n\nexport function useDocSearch(): DocSearchContext {\n  const ctx = React.useContext(Context);\n\n  if (ctx === undefined) {\n    throw new Error(\n      '`useDocSearch` must be used within the `DocSearch` provider'\n    );\n  }\n\n  return ctx;\n}\n"],"mappings":"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"}

package/dist/esm/useDocSearchKeyboardEvents.d.ts

@@ -1,50 +1,27 @@
-import React from 'react';
-
-interface DocSearchModalShortcuts {
-    /**
-     * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.
-     *
-     * @default true
-     */
-    'Ctrl/Cmd+K'?: boolean;
-    /**
-     * Enable/disable the / shortcut to open the DocSearch modal.
-     *
-     * @default true
-     */
-    '/'?: boolean;
-}
-interface SidepanelShortcuts {
-    /**
-     * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.
-     *
-     * @default true
-     */
-    'Ctrl/Cmd+I'?: boolean;
-}
-type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;
-
+import { KeyboardShortcuts } from "./useKeyboardShortcuts.js";
+import React from "react";
+//#region src/useDocSearchKeyboardEvents.d.ts
 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;
+  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, isAskAiActive, onAskAiToggle, onClose, onOpen, keyboardShortcuts, }: UseDocSearchKeyboardEventsProps): void;
-
-export { useDocSearchKeyboardEvents };
-export type { UseDocSearchKeyboardEventsProps };
+declare function useDocSearchKeyboardEvents({ isOpen, isAskAiActive, onAskAiToggle, onClose, onOpen, keyboardShortcuts }: UseDocSearchKeyboardEventsProps): void;
+//#endregion
+export { UseDocSearchKeyboardEventsProps, useDocSearchKeyboardEvents };
+//# sourceMappingURL=useDocSearchKeyboardEvents.d.ts.map

package/dist/esm/useDocSearchKeyboardEvents.js

@@ -1 +1,42 @@
-import e from"react";var t={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};function o(o){var n=o.isOpen,r=o.isAskAiActive,i=o.onAskAiToggle,a=o.onClose,c=o.onOpen,d=o.keyboardShortcuts,s=void 0===d?t:d;e.useEffect(function(){function e(e){var t;if(n&&"Escape"===e.code&&r)i(!1);else{var o=s["Ctrl/Cmd+K"]&&"k"===(null===(t=e.key)||void 0===t?void 0:t.toLowerCase())&&(e.metaKey||e.ctrlKey),d=s["/"]&&"/"===e.key;("Escape"===e.code&&n||o||!function(e){var t=e.composedPath()[0],o=t.tagName;return t.isContentEditable||"INPUT"===o||"SELECT"===o||"TEXTAREA"===o||"BUTTON"===o}(e)&&d&&!n)&&(e.preventDefault(),n?a():document.body.classList.contains("DocSearch--active")||c())}}return window.addEventListener("keydown",e),function(){window.removeEventListener("keydown",e)}},[n,r,s,c,a,i])}export{o as useDocSearchKeyboardEvents};
+import { t as DEFAULT_KEYBOARD_SHORTCUTS } from "./useKeyboardShortcuts-D47pg3fZ.js";
+import React from "react";
+
+//#region src/useDocSearchKeyboardEvents.ts
+function isEditingContent(event) {
+	const element = event.composedPath()[0];
+	const tagName = element.tagName;
+	return element.isContentEditable || tagName === "INPUT" || tagName === "SELECT" || tagName === "TEXTAREA";
+}
+function useDocSearchKeyboardEvents({ isOpen, isAskAiActive, onAskAiToggle, onClose, onOpen, keyboardShortcuts = DEFAULT_KEYBOARD_SHORTCUTS }) {
+	React.useEffect(() => {
+		function onKeyDown(event) {
+			var _event$key;
+			if (isOpen && event.code === "Escape" && isAskAiActive) {
+				onAskAiToggle(false);
+				return;
+			}
+			const isCmdK = keyboardShortcuts["Ctrl/Cmd+K"] && ((_event$key = event.key) === null || _event$key === void 0 ? void 0 : _event$key.toLowerCase()) === "k" && (event.metaKey || event.ctrlKey);
+			const isSlash = keyboardShortcuts["/"] && event.key === "/";
+			if (event.code === "Escape" && isOpen || isCmdK || !isEditingContent(event) && isSlash && !isOpen) {
+				event.preventDefault();
+				if (isOpen) onClose();
+				else if (!document.body.classList.contains("DocSearch--active")) onOpen();
+			}
+		}
+		window.addEventListener("keydown", onKeyDown);
+		return () => {
+			window.removeEventListener("keydown", onKeyDown);
+		};
+	}, [
+		isOpen,
+		isAskAiActive,
+		keyboardShortcuts,
+		onOpen,
+		onClose,
+		onAskAiToggle
+	]);
+}
+
+//#endregion
+export { useDocSearchKeyboardEvents };
+//# sourceMappingURL=useDocSearchKeyboardEvents.js.map

package/dist/esm/useDocSearchKeyboardEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocSearchKeyboardEvents.js","names":[],"sources":["../../src/useDocSearchKeyboardEvents.ts"],"sourcesContent":["import React from 'react';\n\nimport {\n  DEFAULT_KEYBOARD_SHORTCUTS,\n  type KeyboardShortcuts,\n} from './useKeyboardShortcuts';\n\nexport interface UseDocSearchKeyboardEventsProps {\n  isOpen: boolean;\n  onOpen: () => void;\n  onClose: () => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  onInput?: (event: KeyboardEvent) => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  searchButtonRef?: React.RefObject<HTMLButtonElement | null>;\n  isAskAiActive: boolean;\n  onAskAiToggle: (toggle: boolean) => void;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nfunction isEditingContent(event: KeyboardEvent): boolean {\n  const element = event.composedPath()[0] as HTMLElement;\n  const tagName = element.tagName;\n\n  return (\n    element.isContentEditable ||\n    tagName === 'INPUT' ||\n    tagName === 'SELECT' ||\n    tagName === 'TEXTAREA'\n  );\n}\n\nexport function useDocSearchKeyboardEvents({\n  isOpen,\n  isAskAiActive,\n  onAskAiToggle,\n  onClose,\n  onOpen,\n  keyboardShortcuts = DEFAULT_KEYBOARD_SHORTCUTS,\n}: UseDocSearchKeyboardEventsProps): void {\n  React.useEffect(() => {\n    function onKeyDown(event: KeyboardEvent): void {\n      if (isOpen && event.code === 'Escape' && isAskAiActive) {\n        onAskAiToggle(false);\n        return;\n      }\n\n      const isCmdK =\n        keyboardShortcuts['Ctrl/Cmd+K'] &&\n        event.key?.toLowerCase() === 'k' &&\n        (event.metaKey || event.ctrlKey);\n      const isSlash = keyboardShortcuts['/'] && event.key === '/';\n\n      if (\n        (event.code === 'Escape' && isOpen) ||\n        isCmdK ||\n        (!isEditingContent(event) && isSlash && !isOpen)\n      ) {\n        event.preventDefault();\n\n        if (isOpen) {\n          onClose();\n        } else if (!document.body.classList.contains('DocSearch--active')) {\n          onOpen();\n        }\n      }\n    }\n\n    window.addEventListener('keydown', onKeyDown);\n\n    return (): void => {\n      window.removeEventListener('keydown', onKeyDown);\n    };\n  }, [\n    isOpen,\n    isAskAiActive,\n    keyboardShortcuts,\n    onOpen,\n    onClose,\n    onAskAiToggle,\n  ]);\n}\n"],"mappings":";;;;AA4BA,SAAS,iBAAiB,OAA+B;CACvD,MAAM,UAAU,MAAM,aAAa,CAAC,CAAC;CACrC,MAAM,UAAU,QAAQ;CAExB,OACE,QAAQ,qBACR,YAAY,WACZ,YAAY,YACZ,YAAY;AAEhB;AAEA,SAAgB,2BAA2B,EACzC,QACA,eACA,eACA,SACA,QACA,oBAAoB,8BACoB;CACxC,MAAM,gBAAgB;EACpB,SAAS,UAAU,OAA4B;;GAC7C,IAAI,UAAU,MAAM,SAAS,YAAY,eAAe;IACtD,cAAc,KAAK;IACnB;GACF;GAEA,MAAM,SACJ,kBAAkB,gCAClB,MAAM,6DAAK,YAAY,OAAM,QAC5B,MAAM,WAAW,MAAM;GAC1B,MAAM,UAAU,kBAAkB,QAAQ,MAAM,QAAQ;GAExD,IACG,MAAM,SAAS,YAAY,UAC5B,UACC,CAAC,iBAAiB,KAAK,KAAK,WAAW,CAAC,QACzC;IACA,MAAM,eAAe;IAErB,IAAI,QACF,QAAQ;SACH,IAAI,CAAC,SAAS,KAAK,UAAU,SAAS,mBAAmB,GAC9D,OAAO;GAEX;EACF;EAEA,OAAO,iBAAiB,WAAW,SAAS;EAE5C,aAAmB;GACjB,OAAO,oBAAoB,WAAW,SAAS;EACjD;CACF,GAAG;EACD;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;AACH"}

package/dist/esm/useKeyboardShortcuts-D47pg3fZ.js

@@ -0,0 +1,90 @@
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.139.0/helpers/esm/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r) {
+			return Object.getOwnPropertyDescriptor(e, r).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
+			_defineProperty(e, r, t[r]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
+			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+		});
+	}
+	return e;
+}
+
+//#endregion
+//#region src/useKeyboardShortcuts.ts
+/**
+* Default keyboard shortcuts configuration for DocSearch. These values are used
+* when no keyboardShortcuts prop is provided or when specific shortcuts are not
+* configured.
+*/
+const DEFAULT_KEYBOARD_SHORTCUTS = {
+	"Ctrl/Cmd+K": true,
+	"/": true,
+	"Ctrl/Cmd+I": true
+};
+/**
+* Merges user-provided keyboard shortcuts with defaults.
+*
+* @param userShortcuts - Optional user configuration.
+* @returns Complete keyboard shortcuts configuration with defaults applied.
+*/
+function useKeyboardShortcuts(userShortcuts) {
+	return _objectSpread2(_objectSpread2({}, DEFAULT_KEYBOARD_SHORTCUTS), userShortcuts);
+}
+
+//#endregion
+export { useKeyboardShortcuts as n, DEFAULT_KEYBOARD_SHORTCUTS as t };
+//# sourceMappingURL=useKeyboardShortcuts-D47pg3fZ.js.map

package/dist/esm/useKeyboardShortcuts-D47pg3fZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcuts-D47pg3fZ.js","names":[],"sources":["../../src/useKeyboardShortcuts.ts"],"sourcesContent":["export interface DocSearchModalShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+K'?: boolean;\n  /**\n   * Enable/disable the / shortcut to open the DocSearch modal.\n   *\n   * @default true\n   */\n  '/'?: boolean;\n}\n\nexport interface SidepanelShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+I'?: boolean;\n}\n\nexport type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;\n\n/**\n * Default keyboard shortcuts configuration for DocSearch. These values are used\n * when no keyboardShortcuts prop is provided or when specific shortcuts are not\n * configured.\n */\nexport const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts> = {\n  'Ctrl/Cmd+K': true,\n  '/': true,\n  'Ctrl/Cmd+I': true,\n} as const;\n\n/**\n * Merges user-provided keyboard shortcuts with defaults.\n *\n * @param userShortcuts - Optional user configuration.\n * @returns Complete keyboard shortcuts configuration with defaults applied.\n */\nexport function useKeyboardShortcuts(\n  userShortcuts?: KeyboardShortcuts\n): Required<KeyboardShortcuts> {\n  return {\n    ...DEFAULT_KEYBOARD_SHORTCUTS,\n    ...userShortcuts,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,6BAA0D;CACrE,cAAc;CACd,KAAK;CACL,cAAc;AAChB;;;;;;;AAQA,SAAgB,qBACd,eAC6B;CAC7B,yCACK,6BACA,aACL;AACF"}

package/dist/esm/useKeyboardShortcuts.d.ts

@@ -1,30 +1,31 @@
+//#region src/useKeyboardShortcuts.d.ts
 interface DocSearchModalShortcuts {
-    /**
-     * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.
-     *
-     * @default true
-     */
-    'Ctrl/Cmd+K'?: boolean;
-    /**
-     * Enable/disable the / shortcut to open the DocSearch modal.
-     *
-     * @default true
-     */
-    '/'?: boolean;
+  /**
+   * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.
+   *
+   * @default true
+   */
+  'Ctrl/Cmd+K'?: boolean;
+  /**
+   * Enable/disable the / shortcut to open the DocSearch modal.
+   *
+   * @default true
+   */
+  '/'?: boolean;
 }
 interface SidepanelShortcuts {
-    /**
-     * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.
-     *
-     * @default true
-     */
-    'Ctrl/Cmd+I'?: boolean;
+  /**
+   * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.
+   *
+   * @default true
+   */
+  'Ctrl/Cmd+I'?: boolean;
 }
 type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;
 /**
- * Default keyboard shortcuts configuration for DocSearch.
- * These values are used when no keyboardShortcuts prop is provided
- * or when specific shortcuts are not configured.
+ * Default keyboard shortcuts configuration for DocSearch. These values are used
+ * when no keyboardShortcuts prop is provided or when specific shortcuts are not
+ * configured.
  */
 declare const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts>;
 /**
@@ -34,6 +35,6 @@ declare const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts>;
  * @returns Complete keyboard shortcuts configuration with defaults applied.
  */
 declare function useKeyboardShortcuts(userShortcuts?: KeyboardShortcuts): Required<KeyboardShortcuts>;
-
-export { DEFAULT_KEYBOARD_SHORTCUTS, useKeyboardShortcuts };
-export type { DocSearchModalShortcuts, KeyboardShortcuts, SidepanelShortcuts };
+//#endregion
+export { DEFAULT_KEYBOARD_SHORTCUTS, DocSearchModalShortcuts, KeyboardShortcuts, SidepanelShortcuts, useKeyboardShortcuts };
+//# sourceMappingURL=useKeyboardShortcuts.d.ts.map

package/dist/esm/useKeyboardShortcuts.js

@@ -1 +1,3 @@
-function r(r,e,t){return(e=function(r){var e=function(r,e){if("object"!=typeof r||!r)return r;var t=r[Symbol.toPrimitive];if(void 0!==t){var n=t.call(r,e);if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===e?String:Number)(r)}(r,"string");return"symbol"==typeof e?e:e+""}(e))in r?Object.defineProperty(r,e,{value:t,enumerable:!0,configurable:!0,writable:!0}):r[e]=t,r}function e(r,e){var t=Object.keys(r);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(r);e&&(n=n.filter(function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})),t.push.apply(t,n)}return t}function t(t){for(var n=1;n<arguments.length;n++){var o=null!=arguments[n]?arguments[n]:{};n%2?e(Object(o),!0).forEach(function(e){r(t,e,o[e])}):Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(o)):e(Object(o)).forEach(function(r){Object.defineProperty(t,r,Object.getOwnPropertyDescriptor(o,r))})}return t}var n={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};function o(r){return t(t({},n),r)}export{n as DEFAULT_KEYBOARD_SHORTCUTS,o as useKeyboardShortcuts};
+import { n as useKeyboardShortcuts, t as DEFAULT_KEYBOARD_SHORTCUTS } from "./useKeyboardShortcuts-D47pg3fZ.js";
+
+export { DEFAULT_KEYBOARD_SHORTCUTS, useKeyboardShortcuts };

package/dist/esm/useTheme.d.ts

@@ -1,8 +1,9 @@
+//#region src/useTheme.d.ts
 type DocSearchTheme = 'dark' | 'light';
 interface UseThemeProps {
-    theme?: DocSearchTheme;
+  theme?: DocSearchTheme;
 }
 declare const useTheme: ({ theme }: UseThemeProps) => void;
-
-export { useTheme };
-export type { DocSearchTheme, UseThemeProps };
+//#endregion
+export { DocSearchTheme, UseThemeProps, useTheme };
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/esm/useTheme.js

@@ -1 +1,19 @@
-import{useEffect as e}from"react";var t=function(t){var m=t.theme;e(function(){if(m){var e=document.documentElement.dataset.theme;if(m!==e)return document.documentElement.dataset.theme=m,function(){void 0===e?delete document.documentElement.dataset.theme:document.documentElement.dataset.theme=e}}},[m])};export{t as useTheme};
+import { useEffect } from "react";
+
+//#region src/useTheme.ts
+const useTheme = ({ theme }) => {
+	useEffect(() => {
+		if (!theme) return;
+		const previousTheme = document.documentElement.dataset.theme;
+		if (theme === previousTheme) return;
+		document.documentElement.dataset.theme = theme;
+		return () => {
+			if (previousTheme === void 0) delete document.documentElement.dataset.theme;
+			else document.documentElement.dataset.theme = previousTheme;
+		};
+	}, [theme]);
+};
+
+//#endregion
+export { useTheme };
+//# sourceMappingURL=useTheme.js.map

package/dist/esm/useTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.js","names":[],"sources":["../../src/useTheme.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nexport type DocSearchTheme = 'dark' | 'light';\n\nexport interface UseThemeProps {\n  theme?: DocSearchTheme;\n}\n\nexport const useTheme = ({ theme }: UseThemeProps): void => {\n  useEffect(() => {\n    if (!theme) {\n      return undefined;\n    }\n\n    const previousTheme = document.documentElement.dataset.theme;\n\n    if (theme === previousTheme) {\n      return undefined;\n    }\n\n    document.documentElement.dataset.theme = theme;\n\n    return (): void => {\n      if (previousTheme === undefined) {\n        delete document.documentElement.dataset.theme;\n      } else {\n        document.documentElement.dataset.theme = previousTheme;\n      }\n    };\n  }, [theme]);\n};\n"],"mappings":";;;AAQA,MAAa,YAAY,EAAE,YAAiC;CAC1D,gBAAgB;EACd,IAAI,CAAC,OACH;EAGF,MAAM,gBAAgB,SAAS,gBAAgB,QAAQ;EAEvD,IAAI,UAAU,eACZ;EAGF,SAAS,gBAAgB,QAAQ,QAAQ;EAEzC,aAAmB;GACjB,IAAI,kBAAkB,QACpB,OAAO,SAAS,gBAAgB,QAAQ;QAExC,SAAS,gBAAgB,QAAQ,QAAQ;EAE7C;CACF,GAAG,CAAC,KAAK,CAAC;AACZ"}

package/dist/umd/index.js

@@ -1,3 +1,3 @@
-/*! @docsearch/core 4.7.0 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("react")):"function"==typeof define&&define.amd?define(["exports","react"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).DocSearchCore={},e.React)}(this,function(e,t){"use strict";function n(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,r=Array(t);n<t;n++)r[n]=e[n];return r}function r(e,t,n){return(t=function(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var n=e[Symbol.toPrimitive];if(void 0!==n){var r=n.call(e,t);if("object"!=typeof r)return r;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function a(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach(function(t){r(e,t,n[t])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})}return e}function i(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var n=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=n){var r,o,a,i,u=[],c=!0,l=!1;try{if(a=(n=n.call(e)).next,0===t);else for(;!(c=(r=a.call(n)).done)&&(u.push(r.value),u.length!==t);c=!0);}catch(e){l=!0,o=e}finally{try{if(!c&&null!=n.return&&(i=n.return(),Object(i)!==i))return}finally{if(l)throw o}}return u}}(e,t)||function(e,t){if(e){if("string"==typeof e)return n(e,t);var r={}.toString.call(e).slice(8,-1);return"Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r?Array.from(e):"Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r)?n(e,t):void 0}}(e,t)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}var u={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};function c(e){return a(a({},u),e)}function l(e){var n=e.isOpen,r=e.isAskAiActive,o=e.onAskAiToggle,a=e.onClose,i=e.onOpen,c=e.keyboardShortcuts,l=void 0===c?u:c;t.useEffect(function(){function e(e){var t;if(n&&"Escape"===e.code&&r)o(!1);else{var u=l["Ctrl/Cmd+K"]&&"k"===(null===(t=e.key)||void 0===t?void 0:t.toLowerCase())&&(e.metaKey||e.ctrlKey),c=l["/"]&&"/"===e.key;("Escape"===e.code&&n||u||!function(e){var t=e.composedPath()[0],n=t.tagName;return t.isContentEditable||"INPUT"===n||"SELECT"===n||"TEXTAREA"===n||"BUTTON"===n}(e)&&c&&!n)&&(e.preventDefault(),n?a():document.body.classList.contains("DocSearch--active")||i())}}return window.addEventListener("keydown",e),function(){window.removeEventListener("keydown",e)}},[n,r,l,i,a,o])}var s=function(e){var n=e.theme;t.useEffect(function(){if(n){var e=document.documentElement.dataset.theme;if(n!==e)return document.documentElement.dataset.theme=n,function(){void 0===e?delete document.documentElement.dataset.theme:document.documentElement.dataset.theme=e}}},[n])},d=["children","theme","onReady","onOpen","onClose","onSidepanelOpen","onSidepanelClose"],f=t.createContext(void 0);f.displayName="DocSearchContext";var p=t.forwardRef(function(e,n){var r=e.children,o=e.theme,a=e.onReady,u=e.onOpen,p=e.onClose,m=e.onSidepanelOpen,v=e.onSidepanelClose,y=function(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n={};for(var r in e)if({}.hasOwnProperty.call(e,r)){if(-1!==t.indexOf(r))continue;n[r]=e[r]}return n}(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r<a.length;r++)n=a[r],-1===t.indexOf(n)&&{}.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}(e,d),h=i(t.useState("ready"),2),b=h[0],S=h[1],O=i(t.useState(y.initialQuery||""),2),g=O[0],w=O[1],k=t.useRef(null),A=c(y.keyboardShortcuts),E=i(t.useState(),2),C=E[0],j=E[1],D=i(t.useState(function(){return new Set}),2),P=D[0],T=D[1],x=function(){var e=i(t.useState(!1),2),n=e[0],r=e[1];return t.useEffect(function(){var e=function(){var e=window.matchMedia("(max-width: 768px)");r(e.matches)};return e(),window.addEventListener("resize",e),function(){window.removeEventListener("resize",e)}},[]),n}(),R=t.useRef("ready"),M=["modal-search","modal-askai"].includes(b),I="modal-askai"===b,L=!x&&P.has("sidepanel"),K="sidepanel"===b;t.useEffect(function(){null==a||a()},[a]),t.useEffect(function(){var e=R.current,t=b;"modal-search"!==t&&"modal-askai"!==t||"modal-search"===e||"modal-askai"===e||null==u||u(),"ready"!==t||"modal-search"!==e&&"modal-askai"!==e||null==p||p(),"sidepanel"===t&&"sidepanel"!==e&&(null==m||m()),"sidepanel"!==t&&"sidepanel"===e&&(null==v||v()),R.current=t},[b,u,p,m,v]);var N=t.useCallback(function(){S("modal-search")},[]),U=t.useCallback(function(){var e,t;S("ready"),null===(e=k.current)||void 0===e||e.focus(),w(null!==(t=y.initialQuery)&&void 0!==t?t:"")},[S,y.initialQuery]),Q=t.useCallback(function(e,t){if(!x&&e&&L)return j(t),void S("sidepanel");S(e?"modal-askai":"modal-search")},[S,x,L]),B=t.useCallback(function(e){P.has("sidepanel")&&(j(e),S("sidepanel"))},[S,P]);t.useCallback(function(e){S("modal-search"),w(e.key)},[S,w]);var H=t.useCallback(function(){j(void 0)},[]),z=t.useCallback(function(e){P.has(e)||T(function(t){var n=new Set(t);return n.add(e),n})},[P]);t.useImperativeHandle(n,function(){return{open:N,close:U,openAskAi:function(e){return Q(!0,e)},openSidepanel:B,get isReady(){return!0},get isOpen(){return M},get isSidepanelOpen(){return K},get isSidepanelSupported(){return L}}},[N,U,Q,B,M,K,L]),s({theme:o}),l({isOpen:M,onOpen:N,onClose:U,onAskAiToggle:Q,isAskAiActive:I,keyboardShortcuts:A});var _=t.useMemo(function(){return{docsearchState:b,setDocsearchState:S,searchButtonRef:k,initialQuery:g,keyboardShortcuts:A,openModal:N,closeModal:U,isAskAiActive:I,isModalActive:M,onAskAiToggle:Q,initialAskAiMessage:C,clearInitialAskAiMessage:H,registerView:z,isHybridModeSupported:L}},[b,k,g,A,N,U,I,M,Q,C,H,z,L]);return t.createElement(f.Provider,{value:_},r)});p.displayName="DocSearch",e.DEFAULT_KEYBOARD_SHORTCUTS=u,e.DocSearch=p,e.useDocSearch=function(){var e=t.useContext(f);if(void 0===e)throw new Error("`useDocSearch` must be used within the `DocSearch` provider");return e},e.useDocSearchKeyboardEvents=l,e.useKeyboardShortcuts=c,e.useTheme=s});
-//# sourceMappingURL=index.js.map
+/*! @docsearch/core 5.0.0-beta.1 (UNRELEASED cc75f9a) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("react")):typeof define==`function`&&define.amd?define([`exports`,`react`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.DocSearchCore={},e.React))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=Object.create,r=Object.defineProperty,i=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,o=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,c=(e,t,n,o)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=a(t),l=0,u=c.length,d;l<u;l++)d=c[l],!s.call(e,d)&&d!==n&&r(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(o=i(t,d))||o.enumerable});return e};t=((e,t,i)=>(i=e==null?{}:n(o(e)),c(t||!e||!e.__esModule?r(i,`default`,{value:e,enumerable:!0}):i,e)))(t,1);function l(e){"@babel/helpers - typeof";return l=typeof Symbol==`function`&&typeof Symbol.iterator==`symbol`?function(e){return typeof e}:function(e){return e&&typeof Symbol==`function`&&e.constructor===Symbol&&e!==Symbol.prototype?`symbol`:typeof e},l(e)}function u(e,t){if(l(e)!=`object`||!e)return e;var n=e[Symbol.toPrimitive];if(n!==void 0){var r=n.call(e,t||`default`);if(l(r)!=`object`)return r;throw TypeError(`@@toPrimitive must return a primitive value.`)}return(t===`string`?String:Number)(e)}function d(e){var t=u(e,`string`);return l(t)==`symbol`?t:t+``}function f(e,t,n){return(t=d(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function p(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),n.push.apply(n,r)}return n}function m(e){for(var t=1;t<arguments.length;t++){var n=arguments[t]==null?{}:arguments[t];t%2?p(Object(n),!0).forEach(function(t){f(e,t,n[t])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):p(Object(n)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))})}return e}let h={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};function g(e){return m(m({},h),e)}function _(e){let t=e.composedPath()[0],n=t.tagName;return t.isContentEditable||n===`INPUT`||n===`SELECT`||n===`TEXTAREA`}function v({isOpen:e,isAskAiActive:n,onAskAiToggle:r,onClose:i,onOpen:a,keyboardShortcuts:o=h}){t.default.useEffect(()=>{function t(t){var s;if(e&&t.code===`Escape`&&n){r(!1);return}let c=o[`Ctrl/Cmd+K`]&&((s=t.key)==null?void 0:s.toLowerCase())===`k`&&(t.metaKey||t.ctrlKey),l=o[`/`]&&t.key===`/`;(t.code===`Escape`&&e||c||!_(t)&&l&&!e)&&(t.preventDefault(),e?i():document.body.classList.contains(`DocSearch--active`)||a())}return window.addEventListener(`keydown`,t),()=>{window.removeEventListener(`keydown`,t)}},[e,n,o,a,i,r])}let y=()=>{let[e,n]=t.default.useState(!1);return t.default.useEffect(()=>{let e=()=>{let e=window.matchMedia(`(max-width: 768px)`);n(e.matches)};return e(),window.addEventListener(`resize`,e),()=>{window.removeEventListener(`resize`,e)}},[]),e},b=({theme:e})=>{(0,t.useEffect)(()=>{if(!e)return;let t=document.documentElement.dataset.theme;if(e!==t)return document.documentElement.dataset.theme=e,()=>{t===void 0?delete document.documentElement.dataset.theme:document.documentElement.dataset.theme=t}},[e])};function x(e,t){if(e==null)return{};var n={};for(var r in e)if({}.hasOwnProperty.call(e,r)){if(t.includes(r))continue;n[r]=e[r]}return n}function S(e,t){if(e==null)return{};var n,r,i=x(e,t);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(r=0;r<a.length;r++)n=a[r],t.includes(n)||{}.propertyIsEnumerable.call(e,n)&&(i[n]=e[n])}return i}let C=[`children`,`theme`,`onReady`,`onOpen`,`onClose`,`onSidepanelOpen`,`onSidepanelClose`],w=t.default.createContext(void 0);w.displayName=`DocSearchContext`;function T(e,n){let{children:r,theme:i,onReady:a,onOpen:o,onClose:s,onSidepanelOpen:c,onSidepanelClose:l}=e,u=S(e,C),[d,f]=t.default.useState(`ready`),[p,m]=t.default.useState(u.initialQuery||``),h=t.default.useRef(null),_=g(u.keyboardShortcuts),[x,T]=t.default.useState(),[E,D]=t.default.useState(()=>new Set),O=y(),k=t.default.useRef(`ready`),A=[`modal-search`,`modal-askai`].includes(d),j=d===`modal-askai`,M=!O&&E.has(`sidepanel`),N=d===`sidepanel`;t.default.useEffect(()=>{a==null||a()},[a]),t.default.useEffect(()=>{let e=k.current,t=d;(t===`modal-search`||t===`modal-askai`)&&e!==`modal-search`&&e!==`modal-askai`&&(o==null||o()),t===`ready`&&(e===`modal-search`||e===`modal-askai`)&&(s==null||s()),t===`sidepanel`&&e!==`sidepanel`&&(c==null||c()),t!==`sidepanel`&&e===`sidepanel`&&(l==null||l()),k.current=t},[d,o,s,c,l]);let P=t.default.useCallback(()=>{f(`modal-search`)},[]),F=t.default.useCallback(()=>{var e,t;f(`ready`),(e=h.current)==null||e.focus(),m((t=u.initialQuery)==null?``:t)},[f,u.initialQuery]),I=t.default.useCallback((e,t)=>{if(!O&&e&&M){T(t),f(`sidepanel`);return}f(e?`modal-askai`:`modal-search`)},[f,O,M]),L=t.default.useCallback(e=>{E.has(`sidepanel`)&&(T(e),f(`sidepanel`))},[f,E]),R=t.default.useCallback(e=>{f(`modal-search`),m(e.key)},[f,m]),z=t.default.useCallback(e=>{E.has(e)||D(t=>{let n=new Set(t);return n.add(e),n})},[E]);t.default.useImperativeHandle(n,()=>({open:P,close:F,openAskAi:e=>I(!0,e),openSidepanel:L,get isReady(){return!0},get isOpen(){return A},get isSidepanelOpen(){return N},get isSidepanelSupported(){return M}}),[P,F,I,L,A,N,M]),b({theme:i}),v({isOpen:A,onOpen:P,onClose:F,onAskAiToggle:I,onInput:R,isAskAiActive:j,searchButtonRef:h,keyboardShortcuts:_});let B=t.default.useMemo(()=>({docsearchState:d,setDocsearchState:f,searchButtonRef:h,initialQuery:p,keyboardShortcuts:_,openModal:P,closeModal:F,isAskAiActive:j,isModalActive:A,onAskAiToggle:I,initialAskAiMessage:x,registerView:z,isHybridModeSupported:M}),[d,h,p,_,P,F,j,A,I,x,z,M]);return t.default.createElement(w.Provider,{value:B},r)}let E=t.default.forwardRef(T);E.displayName=`DocSearch`;function D(){let e=t.default.useContext(w);if(e===void 0)throw Error("`useDocSearch` must be used within the `DocSearch` provider");return e}e.DEFAULT_KEYBOARD_SHORTCUTS=h,e.DocSearch=E,e.useDocSearch=D,e.useDocSearchKeyboardEvents=v,e.useKeyboardShortcuts=g,e.useTheme=b});
+//# sourceMappingURL=index.js.map

package/dist/umd/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/useKeyboardShortcuts.ts","../../src/useDocSearchKeyboardEvents.ts","../../src/useIsMobile.ts","../../src/useTheme.ts","../../src/DocSearch.tsx"],"sourcesContent":["export interface DocSearchModalShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+K'?: boolean;\n  /**\n   * Enable/disable the / shortcut to open the DocSearch modal.\n   *\n   * @default true\n   */\n  '/'?: boolean;\n}\n\nexport interface SidepanelShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+I'?: boolean;\n}\n\nexport type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;\n\n/**\n * Default keyboard shortcuts configuration for DocSearch.\n * These values are used when no keyboardShortcuts prop is provided\n * or when specific shortcuts are not configured.\n */\nexport const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts> = {\n  'Ctrl/Cmd+K': true,\n  '/': true,\n  'Ctrl/Cmd+I': true,\n} as const;\n\n/**\n * Merges user-provided keyboard shortcuts with defaults.\n *\n * @param userShortcuts - Optional user configuration.\n * @returns Complete keyboard shortcuts configuration with defaults applied.\n */\nexport function useKeyboardShortcuts(userShortcuts?: KeyboardShortcuts): Required<KeyboardShortcuts> {\n  return {\n    ...DEFAULT_KEYBOARD_SHORTCUTS,\n    ...userShortcuts,\n  };\n}\n","import React from 'react';\n\nimport { DEFAULT_KEYBOARD_SHORTCUTS, type KeyboardShortcuts } from './useKeyboardShortcuts';\n\nexport interface UseDocSearchKeyboardEventsProps {\n  isOpen: boolean;\n  onOpen: () => void;\n  onClose: () => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  onInput?: (event: KeyboardEvent) => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  searchButtonRef?: React.RefObject<HTMLButtonElement | null>;\n  isAskAiActive: boolean;\n  onAskAiToggle: (toggle: boolean) => void;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nfunction isEditingContent(event: KeyboardEvent): boolean {\n  const element = event.composedPath()[0] as HTMLElement;\n  const tagName = element.tagName;\n\n  return (\n    element.isContentEditable ||\n    tagName === 'INPUT' ||\n    tagName === 'SELECT' ||\n    tagName === 'TEXTAREA' ||\n    tagName === 'BUTTON'\n  );\n}\n\nexport function useDocSearchKeyboardEvents({\n  isOpen,\n  isAskAiActive,\n  onAskAiToggle,\n  onClose,\n  onOpen,\n  keyboardShortcuts = DEFAULT_KEYBOARD_SHORTCUTS,\n}: UseDocSearchKeyboardEventsProps): void {\n  React.useEffect(() => {\n    function onKeyDown(event: KeyboardEvent): void {\n      if (isOpen && event.code === 'Escape' && isAskAiActive) {\n        onAskAiToggle(false);\n        return;\n      }\n\n      const isCmdK =\n        keyboardShortcuts['Ctrl/Cmd+K'] && event.key?.toLowerCase() === 'k' && (event.metaKey || event.ctrlKey);\n      const isSlash = keyboardShortcuts['/'] && event.key === '/';\n\n      if ((event.code === 'Escape' && isOpen) || isCmdK || (!isEditingContent(event) && isSlash && !isOpen)) {\n        event.preventDefault();\n\n        if (isOpen) {\n          onClose();\n        } else if (!document.body.classList.contains('DocSearch--active')) {\n          onOpen();\n        }\n      }\n    }\n\n    window.addEventListener('keydown', onKeyDown);\n\n    return (): void => {\n      window.removeEventListener('keydown', onKeyDown);\n    };\n  }, [isOpen, isAskAiActive, keyboardShortcuts, onOpen, onClose, onAskAiToggle]);\n}\n","import React from 'react';\n\nexport const useIsMobile = (): boolean => {\n  const [isMobile, setIsMobile] = React.useState(false);\n\n  React.useEffect(() => {\n    const checkForMobile = (): void => {\n      const isMobileMediaQuery = window.matchMedia('(max-width: 768px)');\n\n      setIsMobile(isMobileMediaQuery.matches);\n    };\n\n    checkForMobile();\n\n    window.addEventListener('resize', checkForMobile);\n\n    return (): void => {\n      window.removeEventListener('resize', checkForMobile);\n    };\n  }, []);\n\n  return isMobile;\n};\n","import { useEffect } from 'react';\n\nexport type DocSearchTheme = 'dark' | 'light';\n\nexport interface UseThemeProps {\n  theme?: DocSearchTheme;\n}\n\nexport const useTheme = ({ theme }: UseThemeProps): void => {\n  useEffect(() => {\n    if (!theme) {\n      return undefined;\n    }\n\n    const previousTheme = document.documentElement.dataset.theme;\n\n    if (theme === previousTheme) {\n      return undefined;\n    }\n\n    document.documentElement.dataset.theme = theme;\n\n    return (): void => {\n      if (previousTheme === undefined) {\n        delete document.documentElement.dataset.theme;\n      } else {\n        document.documentElement.dataset.theme = previousTheme;\n      }\n    };\n  }, [theme]);\n};\n","import type { JSX } from 'react';\nimport React from 'react';\n\nimport { useDocSearchKeyboardEvents } from './useDocSearchKeyboardEvents';\nimport { useIsMobile } from './useIsMobile';\nimport { useKeyboardShortcuts } from './useKeyboardShortcuts';\nimport type { KeyboardShortcuts } from './useKeyboardShortcuts.ts';\nimport type { DocSearchTheme } from './useTheme';\nimport { useTheme } from './useTheme';\n\nexport type DocSearchState = 'modal-askai' | 'modal-search' | 'ready' | 'sidepanel';\n\nexport type View = 'modal' | 'sidepanel' | (Record<string, unknown> & string);\n\nexport type InitialAskAiMessage = {\n  query: string;\n  messageId?: string;\n  suggestedQuestionId?: string;\n};\n\nexport type OnAskAiToggle = (active: boolean, initialMessage?: InitialAskAiMessage) => void;\n\n/**\n * Imperative handle exposed by the DocSearch provider for programmatic control.\n */\nexport interface DocSearchRef {\n  /** Opens the search modal. */\n  open: () => void;\n  /** Closes the search modal. */\n  close: () => void;\n  /** Opens Ask AI mode (sidepanel if available, otherwise modal). */\n  openAskAi: (initialMessage?: InitialAskAiMessage) => void;\n  /** Opens the sidepanel directly (no-op if sidepanel view not registered). */\n  openSidepanel: (initialMessage?: InitialAskAiMessage) => void;\n  /** Returns true once the component is mounted and ready. */\n  readonly isReady: boolean;\n  /** Returns true if the modal is currently open. */\n  readonly isOpen: boolean;\n  /** Returns true if the sidepanel is currently open. */\n  readonly isSidepanelOpen: boolean;\n  /** Returns true if sidepanel view is registered (hybrid mode). */\n  readonly isSidepanelSupported: boolean;\n}\n\nexport interface DocSearchContext {\n  docsearchState: DocSearchState;\n  setDocsearchState: (newState: DocSearchState) => void;\n  searchButtonRef: React.RefObject<HTMLButtonElement | null>;\n  initialQuery: string;\n  keyboardShortcuts: Required<KeyboardShortcuts>;\n  openModal: () => void;\n  closeModal: () => void;\n  isAskAiActive: boolean;\n  isModalActive: boolean;\n  onAskAiToggle: OnAskAiToggle;\n  initialAskAiMessage: InitialAskAiMessage | undefined;\n  clearInitialAskAiMessage: () => void;\n  registerView: (view: View) => void;\n  isHybridModeSupported: boolean;\n}\n\n/**\n * Lifecycle callbacks for DocSearch.\n */\nexport interface DocSearchCallbacks {\n  /** Called once DocSearch is mounted and ready for interaction. */\n  onReady?: () => void;\n  /** Called when the modal opens. */\n  onOpen?: () => void;\n  /** Called when the modal closes. */\n  onClose?: () => void;\n  /** Called when the sidepanel opens. */\n  onSidepanelOpen?: () => void;\n  /** Called when the sidepanel closes. */\n  onSidepanelClose?: () => void;\n}\n\nexport interface DocSearchProps extends DocSearchCallbacks {\n  children: Array<JSX.Element | null> | JSX.Element | React.ReactNode | null;\n  theme?: DocSearchTheme;\n  initialQuery?: string;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nconst Context = React.createContext<DocSearchContext | undefined>(undefined);\nContext.displayName = 'DocSearchContext';\n\nfunction DocSearchInner(\n  { children, theme, onReady, onOpen, onClose, onSidepanelOpen, onSidepanelClose, ...props }: DocSearchProps,\n  ref: React.ForwardedRef<DocSearchRef>,\n): JSX.Element {\n  const [docsearchState, setDocsearchState] = React.useState<DocSearchState>('ready');\n  const [initialQuery, setInitialQuery] = React.useState<string>(props.initialQuery || '');\n  const searchButtonRef = React.useRef<HTMLButtonElement>(null);\n  const keyboardShortcuts = useKeyboardShortcuts(props.keyboardShortcuts);\n  const [initialAskAiMessage, setInitialAskAiMessage] = React.useState<InitialAskAiMessage>();\n  const [registeredViews, setRegisteredViews] = React.useState(() => new Set<View>());\n  const isMobile = useIsMobile();\n  const prevStateRef = React.useRef<DocSearchState>('ready');\n\n  const isModalActive = ['modal-search', 'modal-askai'].includes(docsearchState);\n  const isAskAiActive = docsearchState === 'modal-askai';\n  const isHybridModeSupported = !isMobile && registeredViews.has('sidepanel');\n  const isSidepanelOpen = docsearchState === 'sidepanel';\n\n  // Call onReady on mount\n  React.useEffect(() => {\n    onReady?.();\n  }, [onReady]);\n\n  // Track state changes for lifecycle callbacks\n  React.useEffect(() => {\n    const prevState = prevStateRef.current;\n    const currentState = docsearchState;\n\n    // Modal opened\n    if (\n      (currentState === 'modal-search' || currentState === 'modal-askai') &&\n      prevState !== 'modal-search' &&\n      prevState !== 'modal-askai'\n    ) {\n      onOpen?.();\n    }\n\n    // Modal closed\n    if (currentState === 'ready' && (prevState === 'modal-search' || prevState === 'modal-askai')) {\n      onClose?.();\n    }\n\n    // Sidepanel opened\n    if (currentState === 'sidepanel' && prevState !== 'sidepanel') {\n      onSidepanelOpen?.();\n    }\n\n    // Sidepanel closed\n    if (currentState !== 'sidepanel' && prevState === 'sidepanel') {\n      onSidepanelClose?.();\n    }\n\n    prevStateRef.current = currentState;\n  }, [docsearchState, onOpen, onClose, onSidepanelOpen, onSidepanelClose]);\n\n  const openModal = React.useCallback((): void => {\n    setDocsearchState('modal-search');\n  }, []);\n\n  const closeModal = React.useCallback((): void => {\n    setDocsearchState('ready');\n    // Refocus the Modal trigger on close\n    searchButtonRef.current?.focus();\n    setInitialQuery(props.initialQuery ?? '');\n  }, [setDocsearchState, props.initialQuery]);\n\n  const onAskAiToggle: OnAskAiToggle = React.useCallback(\n    (active, initialMessage) => {\n      // Don't use hybrid mode on mobile\n      if (!isMobile && active && isHybridModeSupported) {\n        setInitialAskAiMessage(initialMessage);\n        setDocsearchState('sidepanel');\n        return;\n      }\n\n      setDocsearchState(active ? 'modal-askai' : 'modal-search');\n    },\n    [setDocsearchState, isMobile, isHybridModeSupported],\n  );\n\n  const openSidepanel = React.useCallback(\n    (initialMessage?: InitialAskAiMessage): void => {\n      // Guard: no-op if sidepanel view hasn't been registered\n      if (!registeredViews.has('sidepanel')) return;\n\n      setInitialAskAiMessage(initialMessage);\n      setDocsearchState('sidepanel');\n    },\n    [setDocsearchState, registeredViews],\n  );\n\n  const onInput = React.useCallback(\n    (event: KeyboardEvent): void => {\n      setDocsearchState('modal-search');\n      setInitialQuery(event.key);\n    },\n    [setDocsearchState, setInitialQuery],\n  );\n\n  const clearInitialAskAiMessage = React.useCallback((): void => {\n    setInitialAskAiMessage(undefined);\n  }, []);\n\n  const registerView = React.useCallback(\n    (view: View): void => {\n      if (registeredViews.has(view)) return;\n\n      setRegisteredViews((prev) => {\n        const newViews = new Set(prev);\n        newViews.add(view);\n        return newViews;\n      });\n    },\n    [registeredViews],\n  );\n\n  // Expose imperative handle for programmatic control\n  React.useImperativeHandle(\n    ref,\n    () => ({\n      open: openModal,\n      close: closeModal,\n      openAskAi: (initialMessage?: InitialAskAiMessage): void => onAskAiToggle(true, initialMessage),\n      openSidepanel,\n      get isReady(): boolean {\n        return true;\n      },\n      get isOpen(): boolean {\n        return isModalActive;\n      },\n      get isSidepanelOpen(): boolean {\n        return isSidepanelOpen;\n      },\n      get isSidepanelSupported(): boolean {\n        return isHybridModeSupported;\n      },\n    }),\n    [openModal, closeModal, onAskAiToggle, openSidepanel, isModalActive, isSidepanelOpen, isHybridModeSupported],\n  );\n\n  useTheme({ theme });\n\n  useDocSearchKeyboardEvents({\n    isOpen: isModalActive,\n    onOpen: openModal,\n    onClose: closeModal,\n    onAskAiToggle,\n    onInput,\n    isAskAiActive,\n    searchButtonRef,\n    keyboardShortcuts,\n  });\n\n  const value: DocSearchContext = React.useMemo(\n    () => ({\n      docsearchState,\n      setDocsearchState,\n      searchButtonRef,\n      initialQuery,\n      keyboardShortcuts,\n      openModal,\n      closeModal,\n      isAskAiActive,\n      isModalActive,\n      onAskAiToggle,\n      initialAskAiMessage,\n      clearInitialAskAiMessage,\n      registerView,\n      isHybridModeSupported,\n    }),\n    [\n      docsearchState,\n      searchButtonRef,\n      initialQuery,\n      keyboardShortcuts,\n      openModal,\n      closeModal,\n      isAskAiActive,\n      isModalActive,\n      onAskAiToggle,\n      initialAskAiMessage,\n      clearInitialAskAiMessage,\n      registerView,\n      isHybridModeSupported,\n    ],\n  );\n\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport const DocSearch = React.forwardRef(DocSearchInner);\nDocSearch.displayName = 'DocSearch';\n\nexport function useDocSearch(): DocSearchContext {\n  const ctx = React.useContext(Context);\n\n  if (ctx === undefined) {\n    throw new Error('`useDocSearch` must be used within the `DocSearch` provider');\n  }\n\n  return ctx;\n}\n"],"names":["DEFAULT_KEYBOARD_SHORTCUTS","useKeyboardShortcuts","userShortcuts","_objectSpread","useDocSearchKeyboardEvents","_ref","isOpen","isAskAiActive","onAskAiToggle","onClose","onOpen","_ref$keyboardShortcut","keyboardShortcuts","React","useEffect","onKeyDown","event","_event$key","code","isCmdK","key","toLowerCase","metaKey","ctrlKey","isSlash","element","composedPath","tagName","isContentEditable","isEditingContent","preventDefault","document","body","classList","contains","window","addEventListener","removeEventListener","useTheme","theme","previousTheme","documentElement","dataset","undefined","Context","createContext","displayName","DocSearch","forwardRef","ref","children","onReady","onSidepanelOpen","onSidepanelClose","props","_objectWithoutProperties","_excluded","_React$useState2","_slicedToArray","useState","docsearchState","setDocsearchState","_React$useState4","initialQuery","setInitialQuery","searchButtonRef","useRef","_React$useState6","initialAskAiMessage","setInitialAskAiMessage","_React$useState8","Set","registeredViews","setRegisteredViews","isMobile","setIsMobile","checkForMobile","isMobileMediaQuery","matchMedia","matches","useIsMobile","prevStateRef","isModalActive","includes","isHybridModeSupported","has","isSidepanelOpen","prevState","current","currentState","openModal","useCallback","closeModal","_searchButtonRef$curr","_props$initialQuery","focus","active","initialMessage","openSidepanel","clearInitialAskAiMessage","registerView","view","prev","newViews","add","useImperativeHandle","open","close","openAskAi","isReady","isSidepanelSupported","value","useMemo","createElement","Provider","ctx","useContext","Error"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["React","React"],"sources":["../../src/useKeyboardShortcuts.ts","../../src/useDocSearchKeyboardEvents.ts","../../src/useIsMobile.ts","../../src/useTheme.ts","../../src/DocSearch.tsx"],"sourcesContent":["export interface DocSearchModalShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+K'?: boolean;\n  /**\n   * Enable/disable the / shortcut to open the DocSearch modal.\n   *\n   * @default true\n   */\n  '/'?: boolean;\n}\n\nexport interface SidepanelShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+I'?: boolean;\n}\n\nexport type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;\n\n/**\n * Default keyboard shortcuts configuration for DocSearch. These values are used\n * when no keyboardShortcuts prop is provided or when specific shortcuts are not\n * configured.\n */\nexport const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts> = {\n  'Ctrl/Cmd+K': true,\n  '/': true,\n  'Ctrl/Cmd+I': true,\n} as const;\n\n/**\n * Merges user-provided keyboard shortcuts with defaults.\n *\n * @param userShortcuts - Optional user configuration.\n * @returns Complete keyboard shortcuts configuration with defaults applied.\n */\nexport function useKeyboardShortcuts(\n  userShortcuts?: KeyboardShortcuts\n): Required<KeyboardShortcuts> {\n  return {\n    ...DEFAULT_KEYBOARD_SHORTCUTS,\n    ...userShortcuts,\n  };\n}\n","import React from 'react';\n\nimport {\n  DEFAULT_KEYBOARD_SHORTCUTS,\n  type KeyboardShortcuts,\n} from './useKeyboardShortcuts';\n\nexport interface UseDocSearchKeyboardEventsProps {\n  isOpen: boolean;\n  onOpen: () => void;\n  onClose: () => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  onInput?: (event: KeyboardEvent) => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  searchButtonRef?: React.RefObject<HTMLButtonElement | null>;\n  isAskAiActive: boolean;\n  onAskAiToggle: (toggle: boolean) => void;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nfunction isEditingContent(event: KeyboardEvent): boolean {\n  const element = event.composedPath()[0] as HTMLElement;\n  const tagName = element.tagName;\n\n  return (\n    element.isContentEditable ||\n    tagName === 'INPUT' ||\n    tagName === 'SELECT' ||\n    tagName === 'TEXTAREA'\n  );\n}\n\nexport function useDocSearchKeyboardEvents({\n  isOpen,\n  isAskAiActive,\n  onAskAiToggle,\n  onClose,\n  onOpen,\n  keyboardShortcuts = DEFAULT_KEYBOARD_SHORTCUTS,\n}: UseDocSearchKeyboardEventsProps): void {\n  React.useEffect(() => {\n    function onKeyDown(event: KeyboardEvent): void {\n      if (isOpen && event.code === 'Escape' && isAskAiActive) {\n        onAskAiToggle(false);\n        return;\n      }\n\n      const isCmdK =\n        keyboardShortcuts['Ctrl/Cmd+K'] &&\n        event.key?.toLowerCase() === 'k' &&\n        (event.metaKey || event.ctrlKey);\n      const isSlash = keyboardShortcuts['/'] && event.key === '/';\n\n      if (\n        (event.code === 'Escape' && isOpen) ||\n        isCmdK ||\n        (!isEditingContent(event) && isSlash && !isOpen)\n      ) {\n        event.preventDefault();\n\n        if (isOpen) {\n          onClose();\n        } else if (!document.body.classList.contains('DocSearch--active')) {\n          onOpen();\n        }\n      }\n    }\n\n    window.addEventListener('keydown', onKeyDown);\n\n    return (): void => {\n      window.removeEventListener('keydown', onKeyDown);\n    };\n  }, [\n    isOpen,\n    isAskAiActive,\n    keyboardShortcuts,\n    onOpen,\n    onClose,\n    onAskAiToggle,\n  ]);\n}\n","import React from 'react';\n\nexport const useIsMobile = (): boolean => {\n  const [isMobile, setIsMobile] = React.useState(false);\n\n  React.useEffect(() => {\n    const checkForMobile = (): void => {\n      const isMobileMediaQuery = window.matchMedia('(max-width: 768px)');\n\n      setIsMobile(isMobileMediaQuery.matches);\n    };\n\n    checkForMobile();\n\n    window.addEventListener('resize', checkForMobile);\n\n    return (): void => {\n      window.removeEventListener('resize', checkForMobile);\n    };\n  }, []);\n\n  return isMobile;\n};\n","import { useEffect } from 'react';\n\nexport type DocSearchTheme = 'dark' | 'light';\n\nexport interface UseThemeProps {\n  theme?: DocSearchTheme;\n}\n\nexport const useTheme = ({ theme }: UseThemeProps): void => {\n  useEffect(() => {\n    if (!theme) {\n      return undefined;\n    }\n\n    const previousTheme = document.documentElement.dataset.theme;\n\n    if (theme === previousTheme) {\n      return undefined;\n    }\n\n    document.documentElement.dataset.theme = theme;\n\n    return (): void => {\n      if (previousTheme === undefined) {\n        delete document.documentElement.dataset.theme;\n      } else {\n        document.documentElement.dataset.theme = previousTheme;\n      }\n    };\n  }, [theme]);\n};\n","import type { JSX } from 'react';\nimport React from 'react';\n\nimport { useDocSearchKeyboardEvents } from './useDocSearchKeyboardEvents';\nimport { useIsMobile } from './useIsMobile';\nimport { useKeyboardShortcuts } from './useKeyboardShortcuts';\nimport type { KeyboardShortcuts } from './useKeyboardShortcuts.ts';\nimport type { DocSearchTheme } from './useTheme';\nimport { useTheme } from './useTheme';\n\nexport type DocSearchState =\n  | 'modal-askai'\n  | 'modal-search'\n  | 'ready'\n  | 'sidepanel';\n\nexport type View = 'modal' | 'sidepanel' | (Record<string, unknown> & string);\n\nexport type InitialAskAiMessage = {\n  query: string;\n  messageId?: string;\n  suggestedQuestionId?: string;\n};\n\nexport type OnAskAiToggle = (\n  active: boolean,\n  initialMessage?: InitialAskAiMessage\n) => void;\n\n/** Imperative handle exposed by the DocSearch provider for programmatic control. */\nexport interface DocSearchRef {\n  /** Opens the search modal. */\n  open: () => void;\n  /** Closes the search modal. */\n  close: () => void;\n  /** Opens Ask AI mode (sidepanel if available, otherwise modal). */\n  openAskAi: (initialMessage?: InitialAskAiMessage) => void;\n  /** Opens the sidepanel directly (no-op if sidepanel view not registered). */\n  openSidepanel: (initialMessage?: InitialAskAiMessage) => void;\n  /** Returns true once the component is mounted and ready. */\n  readonly isReady: boolean;\n  /** Returns true if the modal is currently open. */\n  readonly isOpen: boolean;\n  /** Returns true if the sidepanel is currently open. */\n  readonly isSidepanelOpen: boolean;\n  /** Returns true if sidepanel view is registered (hybrid mode). */\n  readonly isSidepanelSupported: boolean;\n}\n\nexport interface DocSearchContext {\n  docsearchState: DocSearchState;\n  setDocsearchState: (newState: DocSearchState) => void;\n  searchButtonRef: React.RefObject<HTMLButtonElement | null>;\n  initialQuery: string;\n  keyboardShortcuts: Required<KeyboardShortcuts>;\n  openModal: () => void;\n  closeModal: () => void;\n  isAskAiActive: boolean;\n  isModalActive: boolean;\n  onAskAiToggle: OnAskAiToggle;\n  initialAskAiMessage: InitialAskAiMessage | undefined;\n  registerView: (view: View) => void;\n  isHybridModeSupported: boolean;\n}\n\n/** Lifecycle callbacks for DocSearch. */\nexport interface DocSearchCallbacks {\n  /** Called once DocSearch is mounted and ready for interaction. */\n  onReady?: () => void;\n  /** Called when the modal opens. */\n  onOpen?: () => void;\n  /** Called when the modal closes. */\n  onClose?: () => void;\n  /** Called when the sidepanel opens. */\n  onSidepanelOpen?: () => void;\n  /** Called when the sidepanel closes. */\n  onSidepanelClose?: () => void;\n}\n\nexport interface DocSearchProps extends DocSearchCallbacks {\n  children: Array<JSX.Element | null> | JSX.Element | React.ReactNode | null;\n  theme?: DocSearchTheme;\n  initialQuery?: string;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nconst Context = React.createContext<DocSearchContext | undefined>(undefined);\nContext.displayName = 'DocSearchContext';\n\nfunction DocSearchInner(\n  {\n    children,\n    theme,\n    onReady,\n    onOpen,\n    onClose,\n    onSidepanelOpen,\n    onSidepanelClose,\n    ...props\n  }: DocSearchProps,\n  ref: React.ForwardedRef<DocSearchRef>\n): JSX.Element {\n  const [docsearchState, setDocsearchState] =\n    React.useState<DocSearchState>('ready');\n  const [initialQuery, setInitialQuery] = React.useState<string>(\n    props.initialQuery || ''\n  );\n  const searchButtonRef = React.useRef<HTMLButtonElement>(null);\n  const keyboardShortcuts = useKeyboardShortcuts(props.keyboardShortcuts);\n  const [initialAskAiMessage, setInitialAskAiMessage] =\n    React.useState<InitialAskAiMessage>();\n  const [registeredViews, setRegisteredViews] = React.useState(\n    () => new Set<View>()\n  );\n  const isMobile = useIsMobile();\n  const prevStateRef = React.useRef<DocSearchState>('ready');\n\n  const isModalActive = ['modal-search', 'modal-askai'].includes(\n    docsearchState\n  );\n  const isAskAiActive = docsearchState === 'modal-askai';\n  const isHybridModeSupported = !isMobile && registeredViews.has('sidepanel');\n  const isSidepanelOpen = docsearchState === 'sidepanel';\n\n  // Call onReady on mount\n  React.useEffect(() => {\n    onReady?.();\n  }, [onReady]);\n\n  // Track state changes for lifecycle callbacks\n  React.useEffect(() => {\n    const prevState = prevStateRef.current;\n    const currentState = docsearchState;\n\n    // Modal opened\n    if (\n      (currentState === 'modal-search' || currentState === 'modal-askai') &&\n      prevState !== 'modal-search' &&\n      prevState !== 'modal-askai'\n    ) {\n      onOpen?.();\n    }\n\n    // Modal closed\n    if (\n      currentState === 'ready' &&\n      (prevState === 'modal-search' || prevState === 'modal-askai')\n    ) {\n      onClose?.();\n    }\n\n    // Sidepanel opened\n    if (currentState === 'sidepanel' && prevState !== 'sidepanel') {\n      onSidepanelOpen?.();\n    }\n\n    // Sidepanel closed\n    if (currentState !== 'sidepanel' && prevState === 'sidepanel') {\n      onSidepanelClose?.();\n    }\n\n    prevStateRef.current = currentState;\n  }, [docsearchState, onOpen, onClose, onSidepanelOpen, onSidepanelClose]);\n\n  const openModal = React.useCallback((): void => {\n    setDocsearchState('modal-search');\n  }, []);\n\n  const closeModal = React.useCallback((): void => {\n    setDocsearchState('ready');\n    // Refocus the Modal trigger on close\n    searchButtonRef.current?.focus();\n    setInitialQuery(props.initialQuery ?? '');\n  }, [setDocsearchState, props.initialQuery]);\n\n  const onAskAiToggle: OnAskAiToggle = React.useCallback(\n    (active, initialMessage) => {\n      // Don't use hybrid mode on mobile\n      if (!isMobile && active && isHybridModeSupported) {\n        setInitialAskAiMessage(initialMessage);\n        setDocsearchState('sidepanel');\n        return;\n      }\n\n      setDocsearchState(active ? 'modal-askai' : 'modal-search');\n    },\n    [setDocsearchState, isMobile, isHybridModeSupported]\n  );\n\n  const openSidepanel = React.useCallback(\n    (initialMessage?: InitialAskAiMessage): void => {\n      // Guard: no-op if sidepanel view hasn't been registered\n      if (!registeredViews.has('sidepanel')) return;\n\n      setInitialAskAiMessage(initialMessage);\n      setDocsearchState('sidepanel');\n    },\n    [setDocsearchState, registeredViews]\n  );\n\n  const onInput = React.useCallback(\n    (event: KeyboardEvent): void => {\n      setDocsearchState('modal-search');\n      setInitialQuery(event.key);\n    },\n    [setDocsearchState, setInitialQuery]\n  );\n\n  const registerView = React.useCallback(\n    (view: View): void => {\n      if (registeredViews.has(view)) return;\n\n      setRegisteredViews((prev) => {\n        const newViews = new Set(prev);\n        newViews.add(view);\n        return newViews;\n      });\n    },\n    [registeredViews]\n  );\n\n  // Expose imperative handle for programmatic control\n  React.useImperativeHandle(\n    ref,\n    () => ({\n      open: openModal,\n      close: closeModal,\n      openAskAi: (initialMessage?: InitialAskAiMessage): void =>\n        onAskAiToggle(true, initialMessage),\n      openSidepanel,\n      get isReady(): boolean {\n        return true;\n      },\n      get isOpen(): boolean {\n        return isModalActive;\n      },\n      get isSidepanelOpen(): boolean {\n        return isSidepanelOpen;\n      },\n      get isSidepanelSupported(): boolean {\n        return isHybridModeSupported;\n      },\n    }),\n    [\n      openModal,\n      closeModal,\n      onAskAiToggle,\n      openSidepanel,\n      isModalActive,\n      isSidepanelOpen,\n      isHybridModeSupported,\n    ]\n  );\n\n  useTheme({ theme });\n\n  useDocSearchKeyboardEvents({\n    isOpen: isModalActive,\n    onOpen: openModal,\n    onClose: closeModal,\n    onAskAiToggle,\n    onInput,\n    isAskAiActive,\n    searchButtonRef,\n    keyboardShortcuts,\n  });\n\n  const value: DocSearchContext = React.useMemo(\n    () => ({\n      docsearchState,\n      setDocsearchState,\n      searchButtonRef,\n      initialQuery,\n      keyboardShortcuts,\n      openModal,\n      closeModal,\n      isAskAiActive,\n      isModalActive,\n      onAskAiToggle,\n      initialAskAiMessage,\n      registerView,\n      isHybridModeSupported,\n    }),\n    [\n      docsearchState,\n      searchButtonRef,\n      initialQuery,\n      keyboardShortcuts,\n      openModal,\n      closeModal,\n      isAskAiActive,\n      isModalActive,\n      onAskAiToggle,\n      initialAskAiMessage,\n      registerView,\n      isHybridModeSupported,\n    ]\n  );\n\n  return <Context.Provider value={value}>{children}</Context.Provider>;\n}\n\nexport const DocSearch = React.forwardRef(DocSearchInner);\nDocSearch.displayName = 'DocSearch';\n\nexport function useDocSearch(): DocSearchContext {\n  const ctx = React.useContext(Context);\n\n  if (ctx === undefined) {\n    throw new Error(\n      '`useDocSearch` must be used within the `DocSearch` provider'\n    );\n  }\n\n  return ctx;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docsearch/core",
   "description": "Core package logic for DocSearch",
-  "version": "4.7.0",
+  "version": "5.0.0-beta.1",
   "license": "MIT",
   "type": "module",
   "homepage": "https://docsearch.algolia.com",
@@ -16,42 +16,32 @@
   },
   "sideEffects": false,
   "files": [
-    "dist/",
-    "index.js",
-    "useTheme.js",
-    "useDocSearchKeyboardEvents.js",
-    "useKeyboardShortcuts.js"
+    "dist/"
   ],
   "exports": {
     ".": "./dist/esm/index.js",
-    "./useTheme": "./dist/esm/useTheme.js",
     "./useDocSearchKeyboardEvents": "./dist/esm/useDocSearchKeyboardEvents.js",
-    "./useKeyboardShortcuts": "./dist/esm/useKeyboardShortcuts.js"
+    "./useKeyboardShortcuts": "./dist/esm/useKeyboardShortcuts.js",
+    "./useTheme": "./dist/esm/useTheme.js"
   },
   "source": "src/index.ts",
-  "types": "dist/esm/index.d.ts",
-  "module": "dist/esm/index.js",
-  "main": "dist/umd/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "main": "./dist/esm/index.js",
+  "module": "./dist/esm/index.js",
   "umd:main": "dist/umd/index.js",
   "unpkg": "dist/umd/index.js",
   "jsdelivr": "dist/umd/index.js",
   "scripts": {
-    "build:clean": "rm -rf ./dist",
-    "build:clean-types": "rm -rf ./dist/esm/types",
-    "build:types": "tsc -p ./tsconfig.declaration.json --outDir ./dist/esm/types",
-    "build:source": "rollup --config --bundleConfigAsCjs",
-    "build:dts": "rollup --config rollup.dts.config.js --bundleConfigAsCjs",
-    "build": "yarn build:clean && yarn build:types && yarn build:source && yarn build:dts && yarn build:clean-types",
-    "on:change": "yarn build",
-    "watch": "nodemon --watch src --ext ts,tsx,js,jsx,json --ignore dist/ --ignore node_modules/ --verbose --delay 250ms --exec \"yarn on:change\""
+    "build": "tsdown",
+    "watch": "tsdown --watch"
   },
   "devDependencies": {
-    "@rollup/plugin-replace": "6.0.2",
     "@testing-library/jest-dom": "6.6.3",
     "@testing-library/react": "16.2.0",
-    "nodemon": "^3.1.0",
-    "rollup-plugin-dts": "^6.2.1",
-    "vitest": "3.0.9"
+    "preact": "11.0.0-beta.0",
+    "tsdown": "0.22.7",
+    "typescript": "5.7.3",
+    "vitest": "3.0.2"
   },
   "peerDependencies": {
     "@types/react": ">= 16.8.0 < 20.0.0",

package/dist/umd/useDocSearchKeyboardEvents.js

@@ -1,3 +0,0 @@
-/*! @docsearch/core 4.7.0 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("react")):"function"==typeof define&&define.amd?define(["exports","react"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).DocSearchCore={},e.React)}(this,function(e,t){"use strict";var o={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};e.useDocSearchKeyboardEvents=function(e){var n=e.isOpen,i=e.isAskAiActive,r=e.onAskAiToggle,c=e.onClose,s=e.onOpen,a=e.keyboardShortcuts,d=void 0===a?o:a;t.useEffect(function(){function e(e){var t;if(n&&"Escape"===e.code&&i)r(!1);else{var o=d["Ctrl/Cmd+K"]&&"k"===(null===(t=e.key)||void 0===t?void 0:t.toLowerCase())&&(e.metaKey||e.ctrlKey),a=d["/"]&&"/"===e.key;("Escape"===e.code&&n||o||!function(e){var t=e.composedPath()[0],o=t.tagName;return t.isContentEditable||"INPUT"===o||"SELECT"===o||"TEXTAREA"===o||"BUTTON"===o}(e)&&a&&!n)&&(e.preventDefault(),n?c():document.body.classList.contains("DocSearch--active")||s())}}return window.addEventListener("keydown",e),function(){window.removeEventListener("keydown",e)}},[n,i,d,s,c,r])}});
-//# sourceMappingURL=useDocSearchKeyboardEvents.js.map

package/dist/umd/useDocSearchKeyboardEvents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useDocSearchKeyboardEvents.js","sources":["../../src/useKeyboardShortcuts.ts","../../src/useDocSearchKeyboardEvents.ts"],"sourcesContent":["export interface DocSearchModalShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+K'?: boolean;\n  /**\n   * Enable/disable the / shortcut to open the DocSearch modal.\n   *\n   * @default true\n   */\n  '/'?: boolean;\n}\n\nexport interface SidepanelShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+I'?: boolean;\n}\n\nexport type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;\n\n/**\n * Default keyboard shortcuts configuration for DocSearch.\n * These values are used when no keyboardShortcuts prop is provided\n * or when specific shortcuts are not configured.\n */\nexport const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts> = {\n  'Ctrl/Cmd+K': true,\n  '/': true,\n  'Ctrl/Cmd+I': true,\n} as const;\n\n/**\n * Merges user-provided keyboard shortcuts with defaults.\n *\n * @param userShortcuts - Optional user configuration.\n * @returns Complete keyboard shortcuts configuration with defaults applied.\n */\nexport function useKeyboardShortcuts(userShortcuts?: KeyboardShortcuts): Required<KeyboardShortcuts> {\n  return {\n    ...DEFAULT_KEYBOARD_SHORTCUTS,\n    ...userShortcuts,\n  };\n}\n","import React from 'react';\n\nimport { DEFAULT_KEYBOARD_SHORTCUTS, type KeyboardShortcuts } from './useKeyboardShortcuts';\n\nexport interface UseDocSearchKeyboardEventsProps {\n  isOpen: boolean;\n  onOpen: () => void;\n  onClose: () => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  onInput?: (event: KeyboardEvent) => void;\n  /**\n   * Deprecated: Still here for backwards compat.\n   *\n   * @deprecated\n   */\n  searchButtonRef?: React.RefObject<HTMLButtonElement | null>;\n  isAskAiActive: boolean;\n  onAskAiToggle: (toggle: boolean) => void;\n  keyboardShortcuts?: KeyboardShortcuts;\n}\n\nfunction isEditingContent(event: KeyboardEvent): boolean {\n  const element = event.composedPath()[0] as HTMLElement;\n  const tagName = element.tagName;\n\n  return (\n    element.isContentEditable ||\n    tagName === 'INPUT' ||\n    tagName === 'SELECT' ||\n    tagName === 'TEXTAREA' ||\n    tagName === 'BUTTON'\n  );\n}\n\nexport function useDocSearchKeyboardEvents({\n  isOpen,\n  isAskAiActive,\n  onAskAiToggle,\n  onClose,\n  onOpen,\n  keyboardShortcuts = DEFAULT_KEYBOARD_SHORTCUTS,\n}: UseDocSearchKeyboardEventsProps): void {\n  React.useEffect(() => {\n    function onKeyDown(event: KeyboardEvent): void {\n      if (isOpen && event.code === 'Escape' && isAskAiActive) {\n        onAskAiToggle(false);\n        return;\n      }\n\n      const isCmdK =\n        keyboardShortcuts['Ctrl/Cmd+K'] && event.key?.toLowerCase() === 'k' && (event.metaKey || event.ctrlKey);\n      const isSlash = keyboardShortcuts['/'] && event.key === '/';\n\n      if ((event.code === 'Escape' && isOpen) || isCmdK || (!isEditingContent(event) && isSlash && !isOpen)) {\n        event.preventDefault();\n\n        if (isOpen) {\n          onClose();\n        } else if (!document.body.classList.contains('DocSearch--active')) {\n          onOpen();\n        }\n      }\n    }\n\n    window.addEventListener('keydown', onKeyDown);\n\n    return (): void => {\n      window.removeEventListener('keydown', onKeyDown);\n    };\n  }, [isOpen, isAskAiActive, keyboardShortcuts, onOpen, onClose, onAskAiToggle]);\n}\n"],"names":["DEFAULT_KEYBOARD_SHORTCUTS","_ref","isOpen","isAskAiActive","onAskAiToggle","onClose","onOpen","_ref$keyboardShortcut","keyboardShortcuts","React","useEffect","onKeyDown","event","_event$key","code","isCmdK","key","toLowerCase","metaKey","ctrlKey","isSlash","element","composedPath","tagName","isContentEditable","isEditingContent","preventDefault","document","body","classList","contains","window","addEventListener","removeEventListener"],"mappings":";uRA+BO,IAAMA,EAA0D,CACrE,cAAc,EACd,KAAK,EACL,cAAc,gCCIT,SAAmCC,GAOA,IANxCC,EAAMD,EAANC,OACAC,EAAaF,EAAbE,cACAC,EAAaH,EAAbG,cACAC,EAAOJ,EAAPI,QACAC,EAAML,EAANK,OAAMC,EAAAN,EACNO,kBAAAA,OAAiB,IAAAD,EAAGP,EAA0BO,EAE9CE,EAAMC,UAAU,WACd,SAASC,EAAUC,GAA4B,IAAAC,EAC7C,GAAIX,GAAyB,WAAfU,EAAME,MAAqBX,EACvCC,GAAc,OADhB,CAKA,IAAMW,EACJP,EAAkB,eAA8C,OAApB,QAATK,EAAAD,EAAMI,WAAG,IAAAH,OAAA,EAATA,EAAWI,iBAA0BL,EAAMM,SAAWN,EAAMO,SAC3FC,EAAUZ,EAAkB,MAAsB,MAAdI,EAAMI,KAE5B,WAAfJ,EAAME,MAAqBZ,GAAWa,IAhCjD,SAA0BH,GACxB,IAAMS,EAAUT,EAAMU,eAAe,GAC/BC,EAAUF,EAAQE,QAExB,OACEF,EAAQG,mBACI,UAAZD,GACY,WAAZA,GACY,aAAZA,GACY,WAAZA,CAEJ,CAqB6DE,CAAiBb,IAAUQ,IAAYlB,KAC5FU,EAAMc,iBAEFxB,EACFG,IACUsB,SAASC,KAAKC,UAAUC,SAAS,sBAC3CxB,IAZJ,CAeF,CAIA,OAFAyB,OAAOC,iBAAiB,UAAWrB,GAE5B,WACLoB,OAAOE,oBAAoB,UAAWtB,EACxC,CACF,EAAG,CAACT,EAAQC,EAAeK,EAAmBF,EAAQD,EAASD,GACjE"}

package/dist/umd/useKeyboardShortcuts.js

@@ -1,3 +0,0 @@
-/*! @docsearch/core 4.7.0 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).DocSearchCore={})}(this,function(e){"use strict";function t(e,t,r){return(t=function(e){var t=function(e,t){if("object"!=typeof e||!e)return e;var r=e[Symbol.toPrimitive];if(void 0!==r){var n=r.call(e,t);if("object"!=typeof n)return n;throw new TypeError("@@toPrimitive must return a primitive value.")}return("string"===t?String:Number)(e)}(e,"string");return"symbol"==typeof t?t:t+""}(t))in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function r(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter(function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable})),r.push.apply(r,n)}return r}function n(e){for(var n=1;n<arguments.length;n++){var o=null!=arguments[n]?arguments[n]:{};n%2?r(Object(o),!0).forEach(function(r){t(e,r,o[r])}):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(o)):r(Object(o)).forEach(function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(o,t))})}return e}var o={"Ctrl/Cmd+K":!0,"/":!0,"Ctrl/Cmd+I":!0};e.DEFAULT_KEYBOARD_SHORTCUTS=o,e.useKeyboardShortcuts=function(e){return n(n({},o),e)}});
-//# sourceMappingURL=useKeyboardShortcuts.js.map

package/dist/umd/useKeyboardShortcuts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useKeyboardShortcuts.js","sources":["../../src/useKeyboardShortcuts.ts"],"sourcesContent":["export interface DocSearchModalShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+K shortcut to toggle the DocSearch modal.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+K'?: boolean;\n  /**\n   * Enable/disable the / shortcut to open the DocSearch modal.\n   *\n   * @default true\n   */\n  '/'?: boolean;\n}\n\nexport interface SidepanelShortcuts {\n  /**\n   * Enable/disable the Ctrl/Cmd+I shortcut to toggle the DocSearch sidepanel.\n   *\n   * @default true\n   */\n  'Ctrl/Cmd+I'?: boolean;\n}\n\nexport type KeyboardShortcuts = DocSearchModalShortcuts & SidepanelShortcuts;\n\n/**\n * Default keyboard shortcuts configuration for DocSearch.\n * These values are used when no keyboardShortcuts prop is provided\n * or when specific shortcuts are not configured.\n */\nexport const DEFAULT_KEYBOARD_SHORTCUTS: Required<KeyboardShortcuts> = {\n  'Ctrl/Cmd+K': true,\n  '/': true,\n  'Ctrl/Cmd+I': true,\n} as const;\n\n/**\n * Merges user-provided keyboard shortcuts with defaults.\n *\n * @param userShortcuts - Optional user configuration.\n * @returns Complete keyboard shortcuts configuration with defaults applied.\n */\nexport function useKeyboardShortcuts(userShortcuts?: KeyboardShortcuts): Required<KeyboardShortcuts> {\n  return {\n    ...DEFAULT_KEYBOARD_SHORTCUTS,\n    ...userShortcuts,\n  };\n}\n"],"names":["DEFAULT_KEYBOARD_SHORTCUTS","userShortcuts","_objectSpread"],"mappings":";+tCA+BO,IAAMA,EAA0D,CACrE,cAAc,EACd,KAAK,EACL,cAAc,yDAST,SAA8BC,GACnC,OAAAC,EAAAA,EAAA,CAAA,EACKF,GACAC,EAEP"}

package/dist/umd/useTheme.js

@@ -1,3 +0,0 @@
-/*! @docsearch/core 4.7.0 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("react")):"function"==typeof define&&define.amd?define(["exports","react"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).DocSearchCore={},e.React)}(this,function(e,t){"use strict";e.useTheme=function(e){var n=e.theme;t.useEffect(function(){if(n){var e=document.documentElement.dataset.theme;if(n!==e)return document.documentElement.dataset.theme=n,function(){void 0===e?delete document.documentElement.dataset.theme:document.documentElement.dataset.theme=e}}},[n])}});
-//# sourceMappingURL=useTheme.js.map

package/dist/umd/useTheme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useTheme.js","sources":["../../src/useTheme.ts"],"sourcesContent":["import { useEffect } from 'react';\n\nexport type DocSearchTheme = 'dark' | 'light';\n\nexport interface UseThemeProps {\n  theme?: DocSearchTheme;\n}\n\nexport const useTheme = ({ theme }: UseThemeProps): void => {\n  useEffect(() => {\n    if (!theme) {\n      return undefined;\n    }\n\n    const previousTheme = document.documentElement.dataset.theme;\n\n    if (theme === previousTheme) {\n      return undefined;\n    }\n\n    document.documentElement.dataset.theme = theme;\n\n    return (): void => {\n      if (previousTheme === undefined) {\n        delete document.documentElement.dataset.theme;\n      } else {\n        document.documentElement.dataset.theme = previousTheme;\n      }\n    };\n  }, [theme]);\n};\n"],"names":["_ref","theme","useEffect","previousTheme","document","documentElement","dataset","undefined"],"mappings":";kSAQwB,SAAHA,GAAuC,IAAjCC,EAAKD,EAALC,MACzBC,EAAAA,UAAU,WACR,GAAKD,EAAL,CAIA,IAAME,EAAgBC,SAASC,gBAAgBC,QAAQL,MAEvD,GAAIA,IAAUE,EAMd,OAFAC,SAASC,gBAAgBC,QAAQL,MAAQA,EAElC,gBACiBM,IAAlBJ,SACKC,SAASC,gBAAgBC,QAAQL,MAExCG,SAASC,gBAAgBC,QAAQL,MAAQE,CAE7C,CAhBA,CAiBF,EAAG,CAACF,GACN"}

package/index.js

@@ -1 +0,0 @@
-export { DocSearch, useDocSearch } from './dist/esm/index.js';

package/useDocSearchKeyboardEvents.js

@@ -1 +0,0 @@
-export * from './dist/esm/useDocSearchKeyboardEvents.js';

package/useTheme.js

@@ -1 +0,0 @@
-export * from './dist/esm/useTheme.js';