@docusaurus/theme-common 2.0.0-beta.16 → 2.0.0-beta.19

package/lib/utils/usePrevious.js

@@ -1,16 +0,0 @@
-/**
- * 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 } from 'react';
-import { useIsomorphicLayoutEffect } from './reactUtils';
-export function usePrevious(value) {
-    const ref = useRef();
-    useIsomorphicLayoutEffect(() => {
-        ref.current = value;
-    });
-    return ref.current;
-}
-//# sourceMappingURL=usePrevious.js.map

package/lib/utils/usePrevious.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"usePrevious.js","sourceRoot":"","sources":["../../src/utils/usePrevious.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,MAAM,EAAC,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAC,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,WAAW,CAAI,KAAQ;IACrC,MAAM,GAAG,GAAG,MAAM,EAAK,CAAC;IAExB,yBAAyB,CAAC,GAAG,EAAE;QAC7B,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}

package/lib/utils/useTOCHighlight.d.ts

@@ -1,14 +0,0 @@
-/**
- * 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.
- */
-export declare type TOCHighlightConfig = {
-    linkClassName: string;
-    linkActiveClassName: string;
-    minHeadingLevel: number;
-    maxHeadingLevel: number;
-};
-export default function useTOCHighlight(config: TOCHighlightConfig | undefined): void;
-//# sourceMappingURL=useTOCHighlight.d.ts.map

package/lib/utils/useTOCHighlight.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useTOCHighlight.d.ts","sourceRoot":"","sources":["../../src/utils/useTOCHighlight.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgHH,oBAAY,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,eAAe,CACrC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GACrC,IAAI,CAwDN"}

package/lib/utils/useTOCHighlight.js.map

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

package/src/utils/colorModeUtils.tsx

@@ -1,156 +0,0 @@
-/**
- * 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';
-import React, {
-  useState,
-  useCallback,
-  useEffect,
-  useContext,
-  useMemo,
-} from 'react';
-
-import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
-import {createStorageSlot} from './storageUtils';
-import {useThemeConfig} from './useThemeConfig';
-
-type ColorModeContextValue = {
-  readonly isDarkTheme: boolean;
-  readonly setLightTheme: () => void;
-  readonly setDarkTheme: () => void;
-};
-
-const ThemeStorageKey = 'theme';
-const ThemeStorage = createStorageSlot(ThemeStorageKey);
-
-const themes = {
-  light: 'light',
-  dark: 'dark',
-} as const;
-
-type Themes = typeof themes[keyof typeof themes];
-
-// Ensure to always return a valid theme even if input is invalid
-const coerceToTheme = (theme?: string | null): Themes =>
-  theme === themes.dark ? themes.dark : themes.light;
-
-const getInitialTheme = (defaultMode: Themes | undefined): Themes => {
-  if (!ExecutionEnvironment.canUseDOM) {
-    return coerceToTheme(defaultMode);
-  }
-  return coerceToTheme(document.documentElement.getAttribute('data-theme'));
-};
-
-const storeTheme = (newTheme: Themes) => {
-  ThemeStorage.set(coerceToTheme(newTheme));
-};
-
-function useColorModeContextValue(): ColorModeContextValue {
-  const {
-    colorMode: {defaultMode, disableSwitch, respectPrefersColorScheme},
-  } = useThemeConfig();
-  const [theme, setTheme] = useState(getInitialTheme(defaultMode));
-
-  const setLightTheme = useCallback(() => {
-    setTheme(themes.light);
-    storeTheme(themes.light);
-  }, []);
-  const setDarkTheme = useCallback(() => {
-    setTheme(themes.dark);
-    storeTheme(themes.dark);
-  }, []);
-
-  useEffect(() => {
-    document.documentElement.setAttribute('data-theme', coerceToTheme(theme));
-  }, [theme]);
-
-  useEffect(() => {
-    if (disableSwitch) {
-      return undefined;
-    }
-    const onChange = (e: StorageEvent) => {
-      if (e.key !== ThemeStorageKey) {
-        return;
-      }
-      try {
-        const storedTheme = ThemeStorage.get();
-        if (storedTheme !== null) {
-          setTheme(coerceToTheme(storedTheme));
-        }
-      } catch (err) {
-        console.error(err);
-      }
-    };
-    window.addEventListener('storage', onChange);
-    return () => {
-      window.removeEventListener('storage', onChange);
-    };
-  }, [disableSwitch, setTheme]);
-
-  // PCS is coerced to light mode when printing, which causes the color mode to
-  // be reset to dark when exiting print mode, disregarding user settings. When
-  // the listener fires only because of a print/screen switch, we don't change
-  // color mode. See https://github.com/facebook/docusaurus/pull/6490
-  const previousMediaIsPrint = React.useRef(false);
-
-  useEffect(() => {
-    if (disableSwitch && !respectPrefersColorScheme) {
-      return undefined;
-    }
-    const mql = window.matchMedia('(prefers-color-scheme: dark)');
-    const onChange = ({matches}: MediaQueryListEvent) => {
-      if (window.matchMedia('print').matches || previousMediaIsPrint.current) {
-        previousMediaIsPrint.current = window.matchMedia('print').matches;
-        return;
-      }
-      setTheme(matches ? themes.dark : themes.light);
-    };
-    mql.addListener(onChange);
-    return () => {
-      mql.removeListener(onChange);
-    };
-  }, [disableSwitch, respectPrefersColorScheme]);
-
-  return {
-    isDarkTheme: theme === themes.dark,
-    setLightTheme,
-    setDarkTheme,
-  };
-}
-
-const ColorModeContext = React.createContext<ColorModeContextValue | undefined>(
-  undefined,
-);
-
-export function ColorModeProvider({
-  children,
-}: {
-  children: ReactNode;
-}): JSX.Element {
-  const {isDarkTheme, setLightTheme, setDarkTheme} = useColorModeContextValue();
-  const contextValue = useMemo(
-    () => ({isDarkTheme, setLightTheme, setDarkTheme}),
-    [isDarkTheme, setLightTheme, setDarkTheme],
-  );
-  return (
-    <ColorModeContext.Provider value={contextValue}>
-      {children}
-    </ColorModeContext.Provider>
-  );
-}
-
-export function useColorMode(): ColorModeContextValue {
-  const context = useContext<ColorModeContextValue | undefined>(
-    ColorModeContext,
-  );
-  if (context == null) {
-    throw new Error(
-      '"useColorMode()" is used outside of "Layout" component. Please see https://docusaurus.io/docs/api/themes/configuration#use-color-mode.',
-    );
-  }
-  return context;
-}

package/src/utils/docSidebarItemsExpandedState.tsx

@@ -1,41 +0,0 @@
-/**
- * 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, {type ReactNode, useMemo, useState, useContext} from 'react';
-
-const EmptyContext: unique symbol = Symbol('EmptyContext');
-const Context = React.createContext<
-  DocSidebarItemsExpandedState | typeof EmptyContext
->(EmptyContext);
-type DocSidebarItemsExpandedState = {
-  expandedItem: number | null;
-  setExpandedItem: (a: number | null) => void;
-};
-
-export function DocSidebarItemsExpandedStateProvider({
-  children,
-}: {
-  children: ReactNode;
-}): JSX.Element {
-  const [expandedItem, setExpandedItem] = useState<number | null>(null);
-  const contextValue = useMemo(
-    () => ({expandedItem, setExpandedItem}),
-    [expandedItem],
-  );
-
-  return <Context.Provider value={contextValue}>{children}</Context.Provider>;
-}
-
-export function useDocSidebarItemsExpandedState(): DocSidebarItemsExpandedState {
-  const contextValue = useContext(Context);
-  if (contextValue === EmptyContext) {
-    throw new Error(
-      'This hook requires usage of <DocSidebarItemsExpandedStateProvider>',
-    );
-  }
-  return contextValue;
-}

package/src/utils/docsPreferredVersion/DocsPreferredVersionProvider.tsx

@@ -1,167 +0,0 @@
-/**
- * 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, {
-  createContext,
-  type ReactNode,
-  useContext,
-  useEffect,
-  useMemo,
-  useState,
-} from 'react';
-import {useThemeConfig, type DocsVersionPersistence} from '../useThemeConfig';
-import {isDocsPluginEnabled} from '../docsUtils';
-
-import {
-  useAllDocsData,
-  type GlobalPluginData,
-} from '@docusaurus/plugin-content-docs/client';
-
-import DocsPreferredVersionStorage from './DocsPreferredVersionStorage';
-
-type DocsPreferredVersionName = string | null;
-
-// State for a single docs plugin instance
-type DocsPreferredVersionPluginState = {
-  preferredVersionName: DocsPreferredVersionName;
-};
-
-// We need to store in state/storage globally
-// one preferred version per docs plugin instance
-// pluginId => pluginState
-type DocsPreferredVersionState = Record<
-  string,
-  DocsPreferredVersionPluginState
->;
-
-// Initial state is always null as we can't read local storage from node SSR
-function getInitialState(pluginIds: string[]): DocsPreferredVersionState {
-  const initialState: DocsPreferredVersionState = {};
-  pluginIds.forEach((pluginId) => {
-    initialState[pluginId] = {
-      preferredVersionName: null,
-    };
-  });
-  return initialState;
-}
-
-// Read storage for all docs plugins
-// Assign to each doc plugin a preferred version (if found)
-function readStorageState({
-  pluginIds,
-  versionPersistence,
-  allDocsData,
-}: {
-  pluginIds: string[];
-  versionPersistence: DocsVersionPersistence;
-  allDocsData: Record<string, GlobalPluginData>;
-}): DocsPreferredVersionState {
-  // The storage value we read might be stale,
-  // and belong to a version that does not exist in the site anymore
-  // In such case, we remove the storage value to avoid downstream errors
-  function restorePluginState(
-    pluginId: string,
-  ): DocsPreferredVersionPluginState {
-    const preferredVersionNameUnsafe = DocsPreferredVersionStorage.read(
-      pluginId,
-      versionPersistence,
-    );
-    const pluginData = allDocsData[pluginId];
-    const versionExists = pluginData.versions.some(
-      (version) => version.name === preferredVersionNameUnsafe,
-    );
-    if (versionExists) {
-      return {preferredVersionName: preferredVersionNameUnsafe};
-    }
-    DocsPreferredVersionStorage.clear(pluginId, versionPersistence);
-    return {preferredVersionName: null};
-  }
-
-  const initialState: DocsPreferredVersionState = {};
-  pluginIds.forEach((pluginId) => {
-    initialState[pluginId] = restorePluginState(pluginId);
-  });
-  return initialState;
-}
-
-function useVersionPersistence(): DocsVersionPersistence {
-  return useThemeConfig().docs.versionPersistence;
-}
-
-// Value that  will be accessible through context: [state,api]
-function useContextValue() {
-  const allDocsData = useAllDocsData();
-  const versionPersistence = useVersionPersistence();
-  const pluginIds = useMemo(() => Object.keys(allDocsData), [allDocsData]);
-
-  // Initial state is empty, as  we can't read browser storage in node/SSR
-  const [state, setState] = useState(() => getInitialState(pluginIds));
-
-  // On mount, we set the state read from browser storage
-  useEffect(() => {
-    setState(readStorageState({allDocsData, versionPersistence, pluginIds}));
-  }, [allDocsData, versionPersistence, pluginIds]);
-
-  // The API that we expose to consumer hooks (memo for constant object)
-  const api = useMemo(() => {
-    function savePreferredVersion(pluginId: string, versionName: string) {
-      DocsPreferredVersionStorage.save(
-        pluginId,
-        versionPersistence,
-        versionName,
-      );
-      setState((s) => ({
-        ...s,
-        [pluginId]: {preferredVersionName: versionName},
-      }));
-    }
-
-    return {
-      savePreferredVersion,
-    };
-  }, [versionPersistence]);
-
-  return [state, api] as const;
-}
-
-type DocsPreferredVersionContextValue = ReturnType<typeof useContextValue>;
-
-const Context = createContext<DocsPreferredVersionContextValue | null>(null);
-
-export function DocsPreferredVersionContextProvider({
-  children,
-}: {
-  children: JSX.Element;
-}): JSX.Element {
-  if (isDocsPluginEnabled) {
-    return (
-      <DocsPreferredVersionContextProviderUnsafe>
-        {children}
-      </DocsPreferredVersionContextProviderUnsafe>
-    );
-  }
-  return children;
-}
-
-function DocsPreferredVersionContextProviderUnsafe({
-  children,
-}: {
-  children: ReactNode;
-}): JSX.Element {
-  const contextValue = useContextValue();
-  return <Context.Provider value={contextValue}>{children}</Context.Provider>;
-}
-
-export function useDocsPreferredVersionContext(): DocsPreferredVersionContextValue {
-  const value = useContext(Context);
-  if (!value) {
-    throw new Error(
-      'Can\'t find docs preferred context, maybe you forgot to use the "DocsPreferredVersionContextProvider"?',
-    );
-  }
-  return value;
-}

package/src/utils/docsPreferredVersion/DocsPreferredVersionStorage.ts

@@ -1,33 +0,0 @@
-/**
- * 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 {createStorageSlot} from '../storageUtils';
-import type {DocsVersionPersistence} from '../useThemeConfig';
-
-const storageKey = (pluginId: string) => `docs-preferred-version-${pluginId}`;
-
-const DocsPreferredVersionStorage = {
-  save: (
-    pluginId: string,
-    persistence: DocsVersionPersistence,
-    versionName: string,
-  ): void => {
-    createStorageSlot(storageKey(pluginId), {persistence}).set(versionName);
-  },
-
-  read: (
-    pluginId: string,
-    persistence: DocsVersionPersistence,
-  ): string | null =>
-    createStorageSlot(storageKey(pluginId), {persistence}).get(),
-
-  clear: (pluginId: string, persistence: DocsVersionPersistence): void => {
-    createStorageSlot(storageKey(pluginId), {persistence}).del();
-  },
-};
-
-export default DocsPreferredVersionStorage;

package/src/utils/docsPreferredVersion/useDocsPreferredVersion.ts

@@ -1,70 +0,0 @@
-/**
- * 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 {useCallback} from 'react';
-import {useDocsPreferredVersionContext} from './DocsPreferredVersionProvider';
-import {
-  useAllDocsData,
-  useDocsData,
-  type GlobalVersion,
-} from '@docusaurus/plugin-content-docs/client';
-
-import {DEFAULT_PLUGIN_ID} from '@docusaurus/constants';
-
-// Note, the preferredVersion attribute will always be null before mount
-export function useDocsPreferredVersion(
-  pluginId: string | undefined = DEFAULT_PLUGIN_ID,
-): {
-  preferredVersion: GlobalVersion | null | undefined;
-  savePreferredVersionName: (versionName: string) => void;
-} {
-  const docsData = useDocsData(pluginId);
-  const [state, api] = useDocsPreferredVersionContext();
-
-  const {preferredVersionName} = state[pluginId];
-
-  const preferredVersion = preferredVersionName
-    ? docsData.versions.find((version) => version.name === preferredVersionName)
-    : null;
-
-  const savePreferredVersionName = useCallback(
-    (versionName: string) => {
-      api.savePreferredVersion(pluginId, versionName);
-    },
-    [api, pluginId],
-  );
-
-  return {preferredVersion, savePreferredVersionName} as const;
-}
-
-export function useDocsPreferredVersionByPluginId(): Record<
-  string,
-  GlobalVersion | null | undefined
-> {
-  const allDocsData = useAllDocsData();
-  const [state] = useDocsPreferredVersionContext();
-
-  function getPluginIdPreferredVersion(pluginId: string) {
-    const docsData = allDocsData[pluginId];
-    const {preferredVersionName} = state[pluginId];
-
-    return preferredVersionName
-      ? docsData.versions.find(
-          (version) => version.name === preferredVersionName,
-        )
-      : null;
-  }
-
-  const pluginIds = Object.keys(allDocsData);
-
-  const result: Record<string, GlobalVersion | null | undefined> = {};
-  pluginIds.forEach((pluginId) => {
-    result[pluginId] = getPluginIdPreferredVersion(pluginId);
-  });
-
-  return result;
-}

package/src/utils/mobileSecondaryMenu.tsx

@@ -1,115 +0,0 @@
-/**
- * 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,
-  type ReactNode,
-  useContext,
-  createContext,
-  useEffect,
-  type ComponentType,
-  useMemo,
-} from 'react';
-
-/*
-The idea behind all this is that a specific component must be able to fill a
-placeholder in the generic layout. The doc page should be able to fill the
-secondary menu of the main mobile navbar. This permits to reduce coupling
-between the main layout and the specific page.
-
-This kind of feature is often called portal/teleport/gateway... 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.
- */
-
-type ExtraProps = {
-  toggleSidebar: () => void;
-};
-
-export type MobileSecondaryMenuComponent<Props> = ComponentType<
-  Props & ExtraProps
->;
-
-type State = {
-  component: MobileSecondaryMenuComponent<unknown>;
-  props: unknown;
-} | null;
-
-function useContextValue() {
-  return useState<State>(null);
-}
-
-type ContextValue = ReturnType<typeof useContextValue>;
-
-const Context = createContext<ContextValue | null>(null);
-
-export function MobileSecondaryMenuProvider({
-  children,
-}: {
-  children: ReactNode;
-}): JSX.Element {
-  return (
-    <Context.Provider value={useContextValue()}>{children}</Context.Provider>
-  );
-}
-
-function useMobileSecondaryMenuContext(): ContextValue {
-  const value = useContext(Context);
-  if (value === null) {
-    throw new Error(
-      'MobileSecondaryMenuProvider was not used correctly, context value is null',
-    );
-  }
-  return value;
-}
-
-export function useMobileSecondaryMenuRenderer(): (
-  extraProps: ExtraProps,
-) => ReactNode | undefined {
-  const [state] = useMobileSecondaryMenuContext();
-  if (state) {
-    const Comp = state.component;
-    return function render(extraProps) {
-      return <Comp {...state.props} {...extraProps} />;
-    };
-  }
-  return () => undefined;
-}
-
-function useShallowMemoizedObject<O extends Record<string, unknown>>(obj: O) {
-  return useMemo(
-    () => obj,
-    // Is this safe?
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [...Object.keys(obj), ...Object.values(obj)],
-  );
-}
-
-// Fill the secondary menu placeholder with some real content
-export function MobileSecondaryMenuFiller<
-  Props extends Record<string, unknown>,
->({
-  component,
-  props,
-}: {
-  component: MobileSecondaryMenuComponent<Props & ExtraProps>;
-  props: Props;
-}): JSX.Element | null {
-  const [, setState] = useMobileSecondaryMenuContext();
-
-  // To avoid useless context re-renders, props are memoized shallowly
-  const memoizedProps = useShallowMemoizedObject(props);
-
-  useEffect(() => {
-    // @ts-expect-error: context is not 100% type-safe but it's ok
-    setState({component, props: memoizedProps});
-  }, [setState, component, memoizedProps]);
-
-  useEffect(() => () => setState(null), [setState]);
-
-  return null;
-}

package/src/utils/pathUtils.ts

@@ -1,19 +0,0 @@
-/**
- * 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.
- */
-
-// Compare the 2 paths, case insensitive and ignoring trailing slash
-export const isSamePath = (
-  path1: string | undefined,
-  path2: string | undefined,
-): boolean => {
-  const normalize = (pathname: string | undefined) =>
-    (!pathname || pathname?.endsWith('/')
-      ? pathname
-      : `${pathname}/`
-    )?.toLowerCase();
-  return normalize(path1) === normalize(path2);
-};