@docusaurus/theme-common 2.0.0-beta.ff31de0ff → 2.0.0-rc.1

package/lib/contexts/navbarMobileSidebar.js

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { useCallback, useEffect, useState, useMemo, } from 'react';
+import { useNavbarSecondaryMenuContent } from './navbarSecondaryMenu/content';
+import { useWindowSize } from '../hooks/useWindowSize';
+import { useHistoryPopHandler } from '../utils/historyUtils';
+import { useThemeConfig } from '../utils/useThemeConfig';
+import { ReactContextError } from '../utils/reactUtils';
+const Context = React.createContext(undefined);
+function useIsNavbarMobileSidebarDisabled() {
+    const secondaryMenuContent = useNavbarSecondaryMenuContent();
+    const { items } = useThemeConfig().navbar;
+    return items.length === 0 && !secondaryMenuContent.component;
+}
+function useContextValue() {
+    const disabled = useIsNavbarMobileSidebarDisabled();
+    const windowSize = useWindowSize();
+    const shouldRender = !disabled && windowSize === 'mobile';
+    const [shown, setShown] = useState(false);
+    // Close mobile sidebar on navigation pop
+    // Most likely firing when using the Android back button (but not only)
+    useHistoryPopHandler(() => {
+        if (shown) {
+            setShown(false);
+            // Prevent pop navigation; seems desirable enough
+            // See https://github.com/facebook/docusaurus/pull/5462#issuecomment-911699846
+            return false;
+        }
+        return undefined;
+    });
+    const toggle = useCallback(() => {
+        setShown((s) => !s);
+    }, []);
+    useEffect(() => {
+        if (windowSize === 'desktop') {
+            setShown(false);
+        }
+    }, [windowSize]);
+    return useMemo(() => ({ disabled, shouldRender, toggle, shown }), [disabled, shouldRender, toggle, shown]);
+}
+export function NavbarMobileSidebarProvider({ children, }) {
+    const value = useContextValue();
+    return <Context.Provider value={value}>{children}</Context.Provider>;
+}
+export function useNavbarMobileSidebar() {
+    const context = React.useContext(Context);
+    if (context === undefined) {
+        throw new ReactContextError('NavbarMobileSidebarProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=navbarMobileSidebar.js.map

package/lib/contexts/navbarMobileSidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navbarMobileSidebar.js","sourceRoot":"","sources":["../../src/contexts/navbarMobileSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,OAAO,GAER,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,6BAA6B,EAAC,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAC,oBAAoB,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAqBtD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAA2B,SAAS,CAAC,CAAC;AAEzE,SAAS,gCAAgC;IACvC,MAAM,oBAAoB,GAAG,6BAA6B,EAAE,CAAC;IAC7D,MAAM,EAAC,KAAK,EAAC,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,gCAAgC,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,MAAM,YAAY,GAAG,CAAC,QAAQ,IAAI,UAAU,KAAK,QAAQ,CAAC;IAE1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1C,yCAAyC;IACzC,uEAAuE;IACvE,oBAAoB,CAAC,GAAG,EAAE;QACxB,IAAI,KAAK,EAAE;YACT,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,iDAAiD;YACjD,8EAA8E;YAC9E,OAAO,KAAK,CAAC;SACd;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,UAAU,KAAK,SAAS,EAAE;YAC5B,QAAQ,CAAC,KAAK,CAAC,CAAC;SACjB;IACH,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,EAC/C,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,EAC1C,QAAQ,GAGT;IACC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,SAAS,EAAE;QACzB,MAAM,IAAI,iBAAiB,CAAC,6BAA6B,CAAC,CAAC;KAC5D;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/contexts/navbarSecondaryMenu/content.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type ReactNode, type ComponentType } from 'react';
+export declare type NavbarSecondaryMenuComponent<Props> = ComponentType<Props>;
+/** @internal */
+export declare type Content = {
+    component: NavbarSecondaryMenuComponent<object>;
+    props: object;
+} | {
+    component: null;
+    props: null;
+};
+/** @internal */
+export declare function NavbarSecondaryMenuContentProvider({ children, }: {
+    children: ReactNode;
+}): JSX.Element;
+/** @internal */
+export declare function useNavbarSecondaryMenuContent(): Content;
+/**
+ * This component renders nothing by itself, but it fills the placeholder in the
+ * generic secondary menu layout. This reduces coupling between the main layout
+ * and the specific page.
+ *
+ * This kind of feature is often called portal/teleport/gateway/outlet...
+ * Various unmaintained React libs exist. Most up-to-date one:
+ * https://github.com/gregberge/react-teleporter
+ * Not sure any of those is safe regarding concurrent mode.
+ */
+export declare function NavbarSecondaryMenuFiller<P extends object>({ component, props, }: {
+    component: NavbarSecondaryMenuComponent<P>;
+    props: P;
+}): JSX.Element | null;
+//# sourceMappingURL=content.d.ts.map

package/lib/contexts/navbarSecondaryMenu/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/contexts/navbarSecondaryMenu/content.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAIZ,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,OAAO,CAAC;AAUf,oBAAY,4BAA4B,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;AAEvE,gBAAgB;AAChB,oBAAY,OAAO,GACf;IACE,SAAS,EAAE,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAC,CAAC;AASnC,gBAAgB;AAChB,wBAAgB,kCAAkC,CAAC,EACjD,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAMd;AAED,gBAAgB;AAChB,wBAAgB,6BAA6B,IAAI,OAAO,CAMvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EAAE,EAC1D,SAAS,EACT,KAAK,GACN,EAAE;IACD,SAAS,EAAE,4BAA4B,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC;CACV,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAqBrB"}

package/lib/contexts/navbarSecondaryMenu/content.js

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { useState, useContext, useEffect, } from 'react';
+import { ReactContextError, useShallowMemoObject } from '../../utils/reactUtils';
+const Context = React.createContext(null);
+/** @internal */
+export function NavbarSecondaryMenuContentProvider({ children, }) {
+    const value = useState({ component: null, props: null });
+    return (
+    // @ts-expect-error: this context is hard to type
+    <Context.Provider value={value}>{children}</Context.Provider>);
+}
+/** @internal */
+export function useNavbarSecondaryMenuContent() {
+    const value = useContext(Context);
+    if (!value) {
+        throw new ReactContextError('NavbarSecondaryMenuContentProvider');
+    }
+    return value[0];
+}
+/**
+ * This component renders nothing by itself, but it fills the placeholder in the
+ * generic secondary menu layout. This reduces coupling between the main layout
+ * and the specific page.
+ *
+ * This kind of feature is often called portal/teleport/gateway/outlet...
+ * Various unmaintained React libs exist. Most up-to-date one:
+ * https://github.com/gregberge/react-teleporter
+ * Not sure any of those is safe regarding concurrent mode.
+ */
+export function NavbarSecondaryMenuFiller({ component, props, }) {
+    const context = useContext(Context);
+    if (!context) {
+        throw new ReactContextError('NavbarSecondaryMenuContentProvider');
+    }
+    const [, setContent] = context;
+    // To avoid useless context re-renders, props are memoized shallowly
+    const memoizedProps = useShallowMemoObject(props);
+    useEffect(() => {
+        // @ts-expect-error: this context is hard to type
+        setContent({ component, props: memoizedProps });
+    }, [setContent, component, memoizedProps]);
+    useEffect(() => () => setContent({ component: null, props: null }), [setContent]);
+    return null;
+}
+//# sourceMappingURL=content.js.map

package/lib/contexts/navbarSecondaryMenu/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/contexts/navbarSecondaryMenu/content.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,GAGV,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,iBAAiB,EAAE,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAwB/E,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAsB,IAAI,CAAC,CAAC;AAE/D,gBAAgB;AAChB,MAAM,UAAU,kCAAkC,CAAC,EACjD,QAAQ,GAGT;IACC,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC;IACvD,OAAO;IACL,iDAAiD;IACjD,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,6BAA6B;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;KACnE;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CAAmB,EAC1D,SAAS,EACT,KAAK,GAIN;IACC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;KACnE;IACD,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC;IAE/B,oEAAoE;IACpE,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,iDAAiD;QACjD,UAAU,CAAC,EAAC,SAAS,EAAE,KAAK,EAAE,aAAa,EAAC,CAAC,CAAC;IAChD,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAE3C,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,EACtD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/contexts/navbarSecondaryMenu/display.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type ReactNode } from 'react';
+/** @internal */
+export declare function NavbarSecondaryMenuDisplayProvider({ children, }: {
+    children: ReactNode;
+}): JSX.Element;
+/** Wires the logic for rendering the mobile navbar secondary menu. */
+export declare function useNavbarSecondaryMenu(): {
+    /** Whether secondary menu is displayed. */
+    shown: boolean;
+    /**
+     * Hide the secondary menu; fired either when hiding the entire sidebar, or
+     * when going back to the primary menu.
+     */
+    hide: () => void;
+    /** The content returned from the current secondary menu filler. */
+    content: JSX.Element | undefined;
+};
+//# sourceMappingURL=display.d.ts.map

package/lib/contexts/navbarSecondaryMenu/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../src/contexts/navbarSecondaryMenu/display.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AA6Cf,gBAAgB;AAChB,wBAAgB,kCAAkC,CAAC,EACjD,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAGd;AAUD,sEAAsE;AACtE,wBAAgB,sBAAsB,IAAI;IACxC,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mEAAmE;IACnE,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,SAAS,CAAC;CAClC,CAaA"}

package/lib/contexts/navbarSecondaryMenu/display.js

@@ -0,0 +1,62 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { useState, useContext, useEffect, useMemo, useCallback, } from 'react';
+import { ReactContextError, usePrevious } from '../../utils/reactUtils';
+import { useNavbarMobileSidebar } from '../navbarMobileSidebar';
+import { useNavbarSecondaryMenuContent } from './content';
+const Context = React.createContext(null);
+function useContextValue() {
+    const mobileSidebar = useNavbarMobileSidebar();
+    const content = useNavbarSecondaryMenuContent();
+    const [shown, setShown] = useState(false);
+    const hasContent = content.component !== null;
+    const previousHasContent = usePrevious(hasContent);
+    // When content is become available for the first time (set in useEffect)
+    // we set this content to be shown!
+    useEffect(() => {
+        const contentBecameAvailable = hasContent && !previousHasContent;
+        if (contentBecameAvailable) {
+            setShown(true);
+        }
+    }, [hasContent, previousHasContent]);
+    // On sidebar close, secondary menu is set to be shown on next re-opening
+    // (if any secondary menu content available)
+    useEffect(() => {
+        if (!hasContent) {
+            setShown(false);
+            return;
+        }
+        if (!mobileSidebar.shown) {
+            setShown(true);
+        }
+    }, [mobileSidebar.shown, hasContent]);
+    return useMemo(() => [shown, setShown], [shown]);
+}
+/** @internal */
+export function NavbarSecondaryMenuDisplayProvider({ children, }) {
+    const value = useContextValue();
+    return <Context.Provider value={value}>{children}</Context.Provider>;
+}
+function renderElement(content) {
+    if (content.component) {
+        const Comp = content.component;
+        return <Comp {...content.props}/>;
+    }
+    return undefined;
+}
+/** Wires the logic for rendering the mobile navbar secondary menu. */
+export function useNavbarSecondaryMenu() {
+    const value = useContext(Context);
+    if (!value) {
+        throw new ReactContextError('NavbarSecondaryMenuDisplayProvider');
+    }
+    const [shown, setShown] = value;
+    const hide = useCallback(() => setShown(false), [setShown]);
+    const content = useNavbarSecondaryMenuContent();
+    return useMemo(() => ({ shown, hide, content: renderElement(content) }), [hide, content, shown]);
+}
+//# sourceMappingURL=display.js.map

package/lib/contexts/navbarSecondaryMenu/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../src/contexts/navbarSecondaryMenu/display.tsx"],"names":[],"mappings":"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"}

package/lib/contexts/tabGroupChoice.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type ReactNode } from 'react';
+declare type ContextValue = {
+    /** A map from `groupId` to the `value` of the saved choice. */
+    readonly tabGroupChoices: {
+        readonly [groupId: string]: string;
+    };
+    /** Set the new choice value of a group. */
+    readonly setTabGroupChoices: (groupId: string, newChoice: string) => void;
+};
+export declare function TabGroupChoiceProvider({ children, }: {
+    children: ReactNode;
+}): JSX.Element;
+export declare function useTabGroupChoice(): ContextValue;
+export {};
+//# sourceMappingURL=tabGroupChoice.d.ts.map

package/lib/contexts/tabGroupChoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabGroupChoice.d.ts","sourceRoot":"","sources":["../../src/contexts/tabGroupChoice.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAMf,aAAK,YAAY,GAAG;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE;QAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KAAC,CAAC;IAC/D,2CAA2C;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E,CAAC;AA4CF,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAGd;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CAMhD"}

package/lib/contexts/tabGroupChoice.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { useState, useCallback, useEffect, useMemo, useContext, } from 'react';
+import { createStorageSlot, listStorageKeys } from '../utils/storageUtils';
+import { ReactContextError } from '../utils/reactUtils';
+const TAB_CHOICE_PREFIX = 'docusaurus.tab.';
+const Context = React.createContext(undefined);
+function useContextValue() {
+    const [tabGroupChoices, setChoices] = useState({});
+    const setChoiceSyncWithLocalStorage = useCallback((groupId, newChoice) => {
+        createStorageSlot(`${TAB_CHOICE_PREFIX}${groupId}`).set(newChoice);
+    }, []);
+    useEffect(() => {
+        try {
+            const localStorageChoices = {};
+            listStorageKeys().forEach((storageKey) => {
+                if (storageKey.startsWith(TAB_CHOICE_PREFIX)) {
+                    const groupId = storageKey.substring(TAB_CHOICE_PREFIX.length);
+                    localStorageChoices[groupId] = createStorageSlot(storageKey).get();
+                }
+            });
+            setChoices(localStorageChoices);
+        }
+        catch (err) {
+            console.error(err);
+        }
+    }, []);
+    const setTabGroupChoices = useCallback((groupId, newChoice) => {
+        setChoices((oldChoices) => ({ ...oldChoices, [groupId]: newChoice }));
+        setChoiceSyncWithLocalStorage(groupId, newChoice);
+    }, [setChoiceSyncWithLocalStorage]);
+    return useMemo(() => ({ tabGroupChoices, setTabGroupChoices }), [tabGroupChoices, setTabGroupChoices]);
+}
+export function TabGroupChoiceProvider({ children, }) {
+    const value = useContextValue();
+    return <Context.Provider value={value}>{children}</Context.Provider>;
+}
+export function useTabGroupChoice() {
+    const context = useContext(Context);
+    if (context == null) {
+        throw new ReactContextError('TabGroupChoiceProvider');
+    }
+    return context;
+}
+//# sourceMappingURL=tabGroupChoice.js.map

package/lib/contexts/tabGroupChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabGroupChoice.js","sourceRoot":"","sources":["../../src/contexts/tabGroupChoice.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,QAAQ,EACR,WAAW,EACX,SAAS,EACT,OAAO,EACP,UAAU,GAEX,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,iBAAiB,EAAE,eAAe,EAAC,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAEtD,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAS5C,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAA2B,SAAS,CAAC,CAAC;AAEzE,SAAS,eAAe;IACtB,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG,QAAQ,CAE3C,EAAE,CAAC,CAAC;IACP,MAAM,6BAA6B,GAAG,WAAW,CAC/C,CAAC,OAAe,EAAE,SAAiB,EAAE,EAAE;QACrC,iBAAiB,CAAC,GAAG,iBAAiB,GAAG,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC,EACD,EAAE,CACH,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI;YACF,MAAM,mBAAmB,GAAgC,EAAE,CAAC;YAC5D,eAAe,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBACvC,IAAI,UAAU,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE;oBAC5C,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;oBAC/D,mBAAmB,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC,GAAG,EAAG,CAAC;iBACrE;YACH,CAAC,CAAC,CAAC;YACH,UAAU,CAAC,mBAAmB,CAAC,CAAC;SACjC;QAAC,OAAO,GAAG,EAAE;YACZ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpB;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,kBAAkB,GAAG,WAAW,CACpC,CAAC,OAAe,EAAE,SAAiB,EAAE,EAAE;QACrC,UAAU,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC;QACpE,6BAA6B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC,EACD,CAAC,6BAA6B,CAAC,CAChC,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAC,eAAe,EAAE,kBAAkB,EAAC,CAAC,EAC7C,CAAC,eAAe,EAAE,kBAAkB,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,QAAQ,GAGT;IACC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,MAAM,IAAI,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;KACvD;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/{utils/useChangeRoute.d.ts → hooks/styles.css}

@@ -4,4 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export declare function useChangeRoute(onRouteChange: () => void): void;
+
+body:not(.navigation-with-keyboard) *:not(input):focus {
+  outline: none;
+}

package/lib/hooks/useBackToTopButton.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/** Wires the logic for the back to top button. */
+export declare function useBackToTopButton({ threshold, }: {
+    /**
+     * The minimum vertical scroll position, above which a scroll-up would not
+     * cause `shown` to become `true`. This is because BTT is only useful if the
+     * user is far down the page.
+     */
+    threshold: number;
+}): {
+    /**
+     * Whether the button should be displayed. We only show if the user has
+     * scrolled up and is on a vertical position greater than `threshold`.
+     */
+    shown: boolean;
+    /**
+     * A (memoized) handle for starting the scroll, which you can directly plug
+     * into the props.
+     */
+    scrollToTop: () => void;
+};
+//# sourceMappingURL=useBackToTopButton.d.ts.map

package/lib/hooks/useBackToTopButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackToTopButton.d.ts","sourceRoot":"","sources":["../../src/hooks/useBackToTopButton.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,GACV,EAAE;IACD;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IACF;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAwCA"}

package/lib/hooks/useBackToTopButton.js

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useRef, useState } from 'react';
+import { useScrollPosition, useSmoothScrollTo } from '../utils/scrollUtils';
+import { useLocationChange } from '../utils/useLocationChange';
+/** Wires the logic for the back to top button. */
+export function useBackToTopButton({ threshold, }) {
+    const [shown, setShown] = useState(false);
+    const isFocusedAnchor = useRef(false);
+    const { startScroll, cancelScroll } = useSmoothScrollTo();
+    useScrollPosition(({ scrollY: scrollTop }, lastPosition) => {
+        const lastScrollTop = lastPosition?.scrollY;
+        // Component is just being mounted. Not really a scroll event from the user.
+        // Ignore it.
+        if (!lastScrollTop) {
+            return;
+        }
+        if (isFocusedAnchor.current) {
+            // This scroll position change is triggered by navigating to an anchor.
+            // Ignore it.
+            isFocusedAnchor.current = false;
+        }
+        else if (scrollTop >= lastScrollTop) {
+            // The user has scrolled down to "fight against" the animation. Cancel any
+            // animation under progress.
+            cancelScroll();
+            setShown(false);
+        }
+        else if (scrollTop < threshold) {
+            // Scrolled to the minimum position; hide the button.
+            setShown(false);
+        }
+        else if (scrollTop + window.innerHeight <
+            document.documentElement.scrollHeight) {
+            setShown(true);
+        }
+    });
+    useLocationChange((locationChangeEvent) => {
+        if (locationChangeEvent.location.hash) {
+            isFocusedAnchor.current = true;
+            setShown(false);
+        }
+    });
+    return { shown, scrollToTop: () => startScroll(0) };
+}
+//# sourceMappingURL=useBackToTopButton.js.map

package/lib/hooks/useBackToTopButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackToTopButton.js","sourceRoot":"","sources":["../../src/hooks/useBackToTopButton.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AACvC,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAC,iBAAiB,EAAC,MAAM,4BAA4B,CAAC;AAE7D,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,EACjC,SAAS,GAQV;IAYC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,EAAC,WAAW,EAAE,YAAY,EAAC,GAAG,iBAAiB,EAAE,CAAC;IAExD,iBAAiB,CAAC,CAAC,EAAC,OAAO,EAAE,SAAS,EAAC,EAAE,YAAY,EAAE,EAAE;QACvD,MAAM,aAAa,GAAG,YAAY,EAAE,OAAO,CAAC;QAC5C,4EAA4E;QAC5E,aAAa;QACb,IAAI,CAAC,aAAa,EAAE;YAClB,OAAO;SACR;QACD,IAAI,eAAe,CAAC,OAAO,EAAE;YAC3B,uEAAuE;YACvE,aAAa;YACb,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;SACjC;aAAM,IAAI,SAAS,IAAI,aAAa,EAAE;YACrC,0EAA0E;YAC1E,4BAA4B;YAC5B,YAAY,EAAE,CAAC;YACf,QAAQ,CAAC,KAAK,CAAC,CAAC;SACjB;aAAM,IAAI,SAAS,GAAG,SAAS,EAAE;YAChC,qDAAqD;YACrD,QAAQ,CAAC,KAAK,CAAC,CAAC;SACjB;aAAM,IACL,SAAS,GAAG,MAAM,CAAC,WAAW;YAC9B,QAAQ,CAAC,eAAe,CAAC,YAAY,EACrC;YACA,QAAQ,CAAC,IAAI,CAAC,CAAC;SAChB;IACH,CAAC,CAAC,CAAC;IAEH,iBAAiB,CAAC,CAAC,mBAAmB,EAAE,EAAE;QACxC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE;YACrC,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC;SACjB;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAC,CAAC;AACpD,CAAC"}

package/lib/hooks/useCodeWordWrap.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { RefObject } from 'react';
+export declare function useCodeWordWrap(): {
+    readonly codeBlockRef: RefObject<HTMLPreElement>;
+    readonly isEnabled: boolean;
+    readonly isCodeScrollable: boolean;
+    readonly toggle: () => void;
+};
+//# sourceMappingURL=useCodeWordWrap.d.ts.map

package/lib/hooks/useCodeWordWrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCodeWordWrap.d.ts","sourceRoot":"","sources":["../../src/hooks/useCodeWordWrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAgDrC,wBAAgB,eAAe,IAAI;IACjC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B,CA6CA"}

package/lib/hooks/useCodeWordWrap.js

@@ -0,0 +1,67 @@
+import { useState, useCallback, useEffect, useRef } from 'react';
+import { useMutationObserver } from './useMutationObserver';
+// Callback fires when the "hidden" attribute of a tabpanel changes
+// See https://github.com/facebook/docusaurus/pull/7485
+function useTabBecameVisibleCallback(codeBlockRef, callback) {
+    const [hiddenTabElement, setHiddenTabElement] = useState();
+    const updateHiddenTabElement = useCallback(() => {
+        // No need to observe non-hidden tabs
+        // + we want to force a re-render when a tab becomes visible
+        setHiddenTabElement(codeBlockRef.current?.closest('[role=tabpanel][hidden]'));
+    }, [codeBlockRef, setHiddenTabElement]);
+    useEffect(() => {
+        updateHiddenTabElement();
+    }, [updateHiddenTabElement]);
+    useMutationObserver(hiddenTabElement, (mutations) => {
+        mutations.forEach((mutation) => {
+            if (mutation.type === 'attributes' &&
+                mutation.attributeName === 'hidden') {
+                callback();
+                updateHiddenTabElement();
+            }
+        });
+    }, {
+        attributes: true,
+        characterData: false,
+        childList: false,
+        subtree: false,
+    });
+}
+export function useCodeWordWrap() {
+    const [isEnabled, setIsEnabled] = useState(false);
+    const [isCodeScrollable, setIsCodeScrollable] = useState(false);
+    const codeBlockRef = useRef(null);
+    const toggle = useCallback(() => {
+        const codeElement = codeBlockRef.current.querySelector('code');
+        if (isEnabled) {
+            codeElement.removeAttribute('style');
+        }
+        else {
+            codeElement.style.whiteSpace = 'pre-wrap';
+            // When code wrap is enabled, we want to avoid a scrollbar in any case
+            // Ensure that very very long words/strings/tokens still wrap
+            codeElement.style.overflowWrap = 'anywhere';
+        }
+        setIsEnabled((value) => !value);
+    }, [codeBlockRef, isEnabled]);
+    const updateCodeIsScrollable = useCallback(() => {
+        const { scrollWidth, clientWidth } = codeBlockRef.current;
+        const isScrollable = scrollWidth > clientWidth ||
+            codeBlockRef.current.querySelector('code').hasAttribute('style');
+        setIsCodeScrollable(isScrollable);
+    }, [codeBlockRef]);
+    useTabBecameVisibleCallback(codeBlockRef, updateCodeIsScrollable);
+    useEffect(() => {
+        updateCodeIsScrollable();
+    }, [isEnabled, updateCodeIsScrollable]);
+    useEffect(() => {
+        window.addEventListener('resize', updateCodeIsScrollable, {
+            passive: true,
+        });
+        return () => {
+            window.removeEventListener('resize', updateCodeIsScrollable);
+        };
+    }, [updateCodeIsScrollable]);
+    return { codeBlockRef, isEnabled, isCodeScrollable, toggle };
+}
+//# sourceMappingURL=useCodeWordWrap.js.map

package/lib/hooks/useCodeWordWrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCodeWordWrap.js","sourceRoot":"","sources":["../../src/hooks/useCodeWordWrap.ts"],"names":[],"mappings":"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"}

package/lib/hooks/useHideableNavbar.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Wires the imperative logic of a hideable navbar.
+ * @param hideOnScroll If `false`, this hook is basically a no-op.
+ */
+export declare function useHideableNavbar(hideOnScroll: boolean): {
+    /** A ref to the navbar component. Plug this into the actual element. */
+    readonly navbarRef: (node: HTMLElement | null) => void;
+    /** If `false`, the navbar component should not be rendered. */
+    readonly isNavbarVisible: boolean;
+};
+//# sourceMappingURL=useHideableNavbar.d.ts.map

package/lib/hooks/useHideableNavbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHideableNavbar.d.ts","sourceRoot":"","sources":["../../src/hooks/useHideableNavbar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,OAAO,GAAG;IACxD,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,CAsDA"}

package/lib/hooks/useHideableNavbar.js

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useState, useCallback, useRef } from 'react';
+import { useLocationChange } from '../utils/useLocationChange';
+import { useScrollPosition } from '../utils/scrollUtils';
+/**
+ * Wires the imperative logic of a hideable navbar.
+ * @param hideOnScroll If `false`, this hook is basically a no-op.
+ */
+export function useHideableNavbar(hideOnScroll) {
+    const [isNavbarVisible, setIsNavbarVisible] = useState(hideOnScroll);
+    const isFocusedAnchor = useRef(false);
+    const navbarHeight = useRef(0);
+    const navbarRef = useCallback((node) => {
+        if (node !== null) {
+            navbarHeight.current = node.getBoundingClientRect().height;
+        }
+    }, []);
+    useScrollPosition(({ scrollY: scrollTop }, lastPosition) => {
+        if (!hideOnScroll) {
+            return;
+        }
+        // Needed mostly for handling rubber band scrolling.
+        // See https://github.com/facebook/docusaurus/pull/5721
+        if (scrollTop < navbarHeight.current) {
+            setIsNavbarVisible(true);
+            return;
+        }
+        if (isFocusedAnchor.current) {
+            isFocusedAnchor.current = false;
+            return;
+        }
+        const lastScrollTop = lastPosition?.scrollY;
+        const documentHeight = document.documentElement.scrollHeight - navbarHeight.current;
+        const windowHeight = window.innerHeight;
+        if (lastScrollTop && scrollTop >= lastScrollTop) {
+            setIsNavbarVisible(false);
+        }
+        else if (scrollTop + windowHeight < documentHeight) {
+            setIsNavbarVisible(true);
+        }
+    });
+    useLocationChange((locationChangeEvent) => {
+        if (!hideOnScroll) {
+            return;
+        }
+        if (locationChangeEvent.location.hash) {
+            isFocusedAnchor.current = true;
+            setIsNavbarVisible(false);
+            return;
+        }
+        setIsNavbarVisible(true);
+    });
+    return { navbarRef, isNavbarVisible };
+}
+//# sourceMappingURL=useHideableNavbar.js.map

package/lib/hooks/useHideableNavbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHideableNavbar.js","sourceRoot":"","sources":["../../src/hooks/useHideableNavbar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AACpD,OAAO,EAAC,iBAAiB,EAAC,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAqB;IAMrD,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,IAAwB,EAAE,EAAE;QACzD,IAAI,IAAI,KAAK,IAAI,EAAE;YACjB,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC,MAAM,CAAC;SAC5D;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,iBAAiB,CAAC,CAAC,EAAC,OAAO,EAAE,SAAS,EAAC,EAAE,YAAY,EAAE,EAAE;QACvD,IAAI,CAAC,YAAY,EAAE;YACjB,OAAO;SACR;QAED,oDAAoD;QACpD,uDAAuD;QACvD,IAAI,SAAS,GAAG,YAAY,CAAC,OAAO,EAAE;YACpC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO;SACR;QAED,IAAI,eAAe,CAAC,OAAO,EAAE;YAC3B,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;YAChC,OAAO;SACR;QAED,MAAM,aAAa,GAAG,YAAY,EAAE,OAAO,CAAC;QAC5C,MAAM,cAAc,GAClB,QAAQ,CAAC,eAAe,CAAC,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC;QAC/D,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;QAExC,IAAI,aAAa,IAAI,SAAS,IAAI,aAAa,EAAE;YAC/C,kBAAkB,CAAC,KAAK,CAAC,CAAC;SAC3B;aAAM,IAAI,SAAS,GAAG,YAAY,GAAG,cAAc,EAAE;YACpD,kBAAkB,CAAC,IAAI,CAAC,CAAC;SAC1B;IACH,CAAC,CAAC,CAAC;IAEH,iBAAiB,CAAC,CAAC,mBAAmB,EAAE,EAAE;QACxC,IAAI,CAAC,YAAY,EAAE;YACjB,OAAO;SACR;QAED,IAAI,mBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE;YACrC,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO;SACR;QAED,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,CAAC;AACtC,CAAC"}

package/lib/hooks/useKeyboardNavigation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import './styles.css';
+export declare const keyboardFocusedClassName = "navigation-with-keyboard";
+/**
+ * Side-effect that adds the `keyboardFocusedClassName` to the body element when
+ * the keyboard has been pressed, or removes it when the mouse is clicked.
+ *
+ * The presence of this class name signals that the user may be using keyboard
+ * for navigation, and the theme **must** add focus outline when this class name
+ * is present. (And optionally not if it's absent, for design purposes)
+ *
+ * Inspired by https://hackernoon.com/removing-that-ugly-focus-ring-and-keeping-it-too-6c8727fefcd2
+ */
+export declare function useKeyboardNavigation(): void;
+//# sourceMappingURL=useKeyboardNavigation.d.ts.map