@azerion/bunosaurus-theme-common 0.0.0-stage → 4.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"colorMode.d.ts","sourceRoot":"","sources":["../../src/contexts/colorMode.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAOf,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAIzC,KAAK,eAAe,GAAG,SAAS,GAAG,IAAI,CAAC;AAyBxC,KAAK,YAAY,GAAG;IAClB,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,CAAC;CAC7D,CAAC;AAqLF,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CAGZ;AAED,wBAAgB,YAAY,IAAI,YAAY,CAS3C"}

package/lib/contexts/colorMode.js

@@ -0,0 +1,163 @@
+/**
+ * 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, useContext, useMemo, } from 'react';
+import useIsBrowser from '@docusaurus/useIsBrowser';
+import { ReactContextError } from '../utils/reactUtils';
+import { createStorageSlot } from '../utils/storageUtils';
+import { useThemeConfig } from '../utils/useThemeConfig';
+function getSystemColorMode() {
+    return window.matchMedia('(prefers-color-scheme: dark)').matches
+        ? 'dark'
+        : 'light';
+}
+function subscribeToMedia(query, listener) {
+    const mql = window.matchMedia(query);
+    mql.addEventListener('change', listener);
+    return () => mql.removeEventListener('change', listener);
+}
+function subscribeToSystemColorModeChange(onChange) {
+    return subscribeToMedia('(prefers-color-scheme: dark)', () => onChange(getSystemColorMode()));
+}
+const Context = React.createContext(undefined);
+const ColorModeStorageKey = 'theme';
+const ColorModeStorage = createStorageSlot(ColorModeStorageKey);
+// We use data-theme-choice="system", not an absent attribute
+// This is easier to handle for users with CSS
+const SystemAttribute = 'system';
+// Ensure to always return a valid colorMode even if input is invalid
+const coerceToColorMode = (colorMode) => colorMode === 'dark' ? 'dark' : 'light';
+const coerceToColorModeChoice = (colorMode) => colorMode === null || colorMode === SystemAttribute
+    ? null
+    : coerceToColorMode(colorMode);
+const ColorModeAttribute = {
+    get: () => {
+        return coerceToColorMode(document.documentElement.getAttribute('data-theme'));
+    },
+    set: (colorMode) => {
+        document.documentElement.setAttribute('data-theme', coerceToColorMode(colorMode));
+    },
+};
+const ColorModeChoiceAttribute = {
+    get: () => {
+        return coerceToColorModeChoice(document.documentElement.getAttribute('data-theme-choice'));
+    },
+    set: (colorMode) => {
+        document.documentElement.setAttribute('data-theme-choice', coerceToColorModeChoice(colorMode) ?? SystemAttribute);
+    },
+};
+const persistColorModeChoice = (newColorMode) => {
+    if (newColorMode === null) {
+        ColorModeStorage.del();
+    }
+    else {
+        ColorModeStorage.set(coerceToColorMode(newColorMode));
+    }
+};
+// The color mode state is initialized in useEffect on purpose
+// to avoid a React hydration mismatch errors
+// The useColorMode() hook value lags behind on purpose
+// This helps users avoid hydration mismatch errors in their code
+// See also https://github.com/facebook/docusaurus/issues/7986
+function useColorModeState() {
+    const { colorMode: { defaultMode }, } = useThemeConfig();
+    const isBrowser = useIsBrowser();
+    // Since the provider may unmount/remount on client navigation, we need to
+    // reinitialize the state with the correct values to avoid visual glitches.
+    // See also https://github.com/facebook/docusaurus/issues/11399#issuecomment-3279181314
+    const [colorMode, setColorModeState] = useState(isBrowser ? ColorModeAttribute.get() : defaultMode);
+    const [colorModeChoice, setColorModeChoiceState] = useState(isBrowser ? ColorModeChoiceAttribute.get() : null);
+    useEffect(() => {
+        setColorModeState(ColorModeAttribute.get());
+        setColorModeChoiceState(ColorModeChoiceAttribute.get());
+    }, []);
+    return {
+        colorMode,
+        setColorModeState,
+        colorModeChoice,
+        setColorModeChoiceState,
+    };
+}
+function useContextValue() {
+    const { colorMode: { defaultMode, disableSwitch, respectPrefersColorScheme }, } = useThemeConfig();
+    const { colorMode, setColorModeState, colorModeChoice, setColorModeChoiceState, } = useColorModeState();
+    useEffect(() => {
+        // A site is deployed without disableSwitch
+        // => User visits the site and has a persisted value
+        // => Site later enabled disableSwitch
+        // => Clear the previously stored value to apply the site's setting
+        if (disableSwitch) {
+            ColorModeStorage.del();
+        }
+    }, [disableSwitch]);
+    const setColorMode = useCallback((newColorModeChoice, options = {}) => {
+        const { persist = true } = options;
+        // Reset to system/default color mode
+        if (newColorModeChoice === null) {
+            // Set the effective color
+            const newColorMode = respectPrefersColorScheme
+                ? getSystemColorMode()
+                : defaultMode;
+            ColorModeAttribute.set(newColorMode);
+            setColorModeState(newColorMode);
+            // Set the chosen color
+            ColorModeChoiceAttribute.set(null);
+            setColorModeChoiceState(null);
+        }
+        // Happy case, when an explicit color is provided
+        else {
+            ColorModeAttribute.set(newColorModeChoice);
+            ColorModeChoiceAttribute.set(newColorModeChoice);
+            setColorModeState(newColorModeChoice);
+            setColorModeChoiceState(newColorModeChoice);
+        }
+        if (persist) {
+            persistColorModeChoice(newColorModeChoice);
+        }
+    }, [
+        setColorModeState,
+        setColorModeChoiceState,
+        respectPrefersColorScheme,
+        defaultMode,
+    ]);
+    // Synchronize theme color/choice mode with browser storage
+    useEffect(() => {
+        return ColorModeStorage.listen((e) => {
+            setColorMode(coerceToColorModeChoice(e.newValue));
+        });
+    }, [setColorMode]);
+    // Synchronize theme color with system color
+    useEffect(() => {
+        if (colorModeChoice !== null || !respectPrefersColorScheme) {
+            return undefined;
+        }
+        return subscribeToSystemColorModeChange((newSystemColorMode) => {
+            // Note: we don't use "setColorMode" on purpose
+            // The system changes should never be considered an explicit theme choice
+            // They only affect the "effective" color, and should never be persisted
+            // Note: this listener also fire when printing, see https://github.com/facebook/docusaurus/pull/6490
+            setColorModeState(newSystemColorMode);
+            ColorModeAttribute.set(newSystemColorMode);
+        });
+    }, [respectPrefersColorScheme, colorModeChoice, setColorModeState]);
+    return useMemo(() => ({
+        colorMode,
+        colorModeChoice,
+        setColorMode,
+    }), [colorMode, colorModeChoice, setColorMode]);
+}
+export function ColorModeProvider({ children, }) {
+    const value = useContextValue();
+    return <Context value={value}>{children}</Context>;
+}
+export function useColorMode() {
+    const context = useContext(Context);
+    if (context == null) {
+        throw new ReactContextError('ColorModeProvider', 'Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.');
+    }
+    return context;
+}
+//# sourceMappingURL=colorMode.js.map

package/lib/contexts/colorMode.js.map

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

package/lib/contexts/navbarMobileSidebar.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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';
+type ContextValue = {
+    /**
+     * Mobile sidebar should be disabled in case it's empty, i.e. no secondary
+     * menu + no navbar items). If disabled, the toggle button should not be
+     * displayed at all.
+     */
+    disabled: boolean;
+    /**
+     * Signals whether the actual sidebar should be displayed (contrary to
+     * `disabled` which is about the toggle button). Sidebar should not visible
+     * until user interaction to avoid SSR rendering.
+     */
+    shouldRender: boolean;
+    /** The displayed state. Can be toggled with the `toggle` callback. */
+    shown: boolean;
+    /** Toggle the `shown` attribute. */
+    toggle: () => void;
+};
+export declare function NavbarMobileSidebarProvider({ children, }: {
+    children: ReactNode;
+}): ReactNode;
+export declare function useNavbarMobileSidebar(): ContextValue;
+export {};
+//# sourceMappingURL=navbarMobileSidebar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navbarMobileSidebar.d.ts","sourceRoot":"","sources":["../../src/contexts/navbarMobileSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAc,EAKZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAOf,KAAK,YAAY,GAAG;IAClB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AA6CF,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CAwBZ;AAED,wBAAgB,sBAAsB,IAAI,YAAY,CAMrD"}

package/lib/contexts/navbarMobileSidebar.js

@@ -0,0 +1,65 @@
+/**
+ * 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);
+    const toggle = useCallback(() => {
+        setShown((s) => !s);
+    }, []);
+    useEffect(() => {
+        if (windowSize === 'desktop') {
+            setShown(false);
+        }
+    }, [windowSize]);
+    return useMemo(() => ({ disabled, shouldRender, toggle, shown }), [disabled, shouldRender, toggle, shown]);
+}
+// A component hook wrapper enables conditional rendering
+// See reason here: https://github.com/facebook/docusaurus/issues/10988
+function OnHistoryPop({ handler, }) {
+    useHistoryPopHandler(handler);
+    return null;
+}
+export function NavbarMobileSidebarProvider({ children, }) {
+    const value = useContextValue();
+    return (<>
+      {
+        // Close mobile sidebar on navigation pop
+        // Most likely firing when using the Android back button (but not only)
+        // Important: we can only have a single history blocker at a time
+        // That's why this needs to be rendered conditionally
+        // See bug report https://github.com/facebook/docusaurus/issues/10988
+        value.shown && (<OnHistoryPop handler={() => {
+                value.toggle();
+                // Prevent pop navigation; seems desirable enough
+                // See https://github.com/facebook/docusaurus/pull/5462#issuecomment-911699846
+                return false;
+            }}/>)}
+      <Context value={value}>{children}</Context>
+    </>);
+}
+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":"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"}

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 type NavbarSecondaryMenuComponent<Props> = ComponentType<Props>;
+/** @internal */
+export type Content = {
+    component: NavbarSecondaryMenuComponent<object>;
+    props: object;
+} | {
+    component: null;
+    props: null;
+};
+/** @internal */
+export declare function NavbarSecondaryMenuContentProvider({ children, }: {
+    children: ReactNode;
+}): ReactNode;
+/** @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;
+}): ReactNode;
+//# 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,MAAM,MAAM,4BAA4B,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;AAEvE,gBAAgB;AAChB,MAAM,MAAM,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,SAAS,CAMZ;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,SAAS,CAqBZ"}

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 value={value}>{children}</Context>);
+}
+/** @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,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,6BAA6B;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;IACpE,CAAC;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,CAAC;QACb,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;IACpE,CAAC;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;
+}): ReactNode;
+/** 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: ReactNode;
+};
+//# 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,SAAS,CAGZ;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,SAAS,CAAC;CACpB,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 value={value}>{children}</Context>;
+}
+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":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,EACP,WAAW,GAEZ,MAAM,OAAO,CAAC;AACf,OAAO,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAC,sBAAsB,EAAC,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAC,6BAA6B,EAAe,MAAM,WAAW,CAAC;AAOtE,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAsB,IAAI,CAAC,CAAC;AAE/D,SAAS,eAAe;IACtB,MAAM,aAAa,GAAG,sBAAsB,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,6BAA6B,EAAE,CAAC;IAEhD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;IAC9C,MAAM,kBAAkB,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAEnD,yEAAyE;IACzE,mCAAmC;IACnC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,sBAAsB,GAAG,UAAU,IAAI,CAAC,kBAAkB,CAAC;QACjE,IAAI,sBAAsB,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAErC,yEAAyE;IACzE,4CAA4C;IAC5C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAEtC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,kCAAkC,CAAC,EACjD,QAAQ,GAGT;IACC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAG,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB;IAWpC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;IAChC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,6BAA6B,EAAE,CAAC;IAEhD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,EAAC,CAAC,EACtD,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CACvB,CAAC;AACJ,CAAC"}

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,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;YAC5B,uEAAuE;YACvE,aAAa;YACb,eAAe,CAAC,OAAO,GAAG,KAAK,CAAC;QAClC,CAAC;aAAM,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;YACtC,0EAA0E;YAC1E,4BAA4B;YAC5B,YAAY,EAAE,CAAC;YACf,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;YACjC,qDAAqD;YACrD,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;aAAM,IACL,SAAS,GAAG,MAAM,CAAC,WAAW;YAC9B,QAAQ,CAAC,eAAe,CAAC,YAAY,EACrC,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iBAAiB,CAAC,CAAC,mBAAmB,EAAE,EAAE;QACxC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;YAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;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,15 @@
+/**
+ * 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 type WordWrap = {
+    readonly codeBlockRef: RefObject<HTMLPreElement | null>;
+    readonly isEnabled: boolean;
+    readonly isCodeScrollable: boolean;
+    readonly toggle: () => void;
+};
+export declare function useCodeWordWrap(): WordWrap;
+//# 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,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAEF,wBAAgB,eAAe,IAAI,QAAQ,CA6C1C"}