@docusaurus/plugin-content-docs 0.0.0-4547 → 0.0.0-4551

package/src/sidebars/postProcessor.ts

@@ -0,0 +1,94 @@
+/**
+ * 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 {normalizeUrl} from '@docusaurus/utils';
+import type {
+  SidebarItem,
+  Sidebars,
+  SidebarProcessorParams,
+  ProcessedSidebarItemCategory,
+  ProcessedSidebarItem,
+  ProcessedSidebars,
+  SidebarItemCategoryLink,
+} from './types';
+import {mapValues} from 'lodash';
+
+function normalizeCategoryLink(
+  category: ProcessedSidebarItemCategory,
+  params: SidebarProcessorParams,
+): SidebarItemCategoryLink | undefined {
+  if (category.link?.type === 'generated-index') {
+    // default slug logic can be improved
+    const getDefaultSlug = () =>
+      `/category/${params.categoryLabelSlugger.slug(category.label)}`;
+    const slug = category.link.slug ?? getDefaultSlug();
+    const permalink = normalizeUrl([params.version.versionPath, slug]);
+    return {
+      ...category.link,
+      slug,
+      permalink,
+    };
+  }
+  return category.link;
+}
+
+function postProcessSidebarItem(
+  item: ProcessedSidebarItem,
+  params: SidebarProcessorParams,
+): SidebarItem {
+  if (item.type === 'category') {
+    const category = {
+      ...item,
+      collapsed: item.collapsed ?? params.sidebarOptions.sidebarCollapsed,
+      collapsible: item.collapsible ?? params.sidebarOptions.sidebarCollapsible,
+      link: normalizeCategoryLink(item, params),
+      items: item.items.map((subItem) =>
+        postProcessSidebarItem(subItem, params),
+      ),
+    };
+    // If the current category doesn't have subitems, we render a normal link
+    // instead.
+    if (category.items.length === 0) {
+      if (!category.link) {
+        throw new Error(
+          `Sidebar category ${item.label} has neither any subitem nor a link. This makes this item not able to link to anything.`,
+        );
+      }
+      switch (category.link.type) {
+        case 'doc':
+          return {
+            type: 'doc',
+            label: category.label,
+            id: category.link.id,
+          };
+        case 'generated-index':
+          return {
+            type: 'link',
+            label: category.label,
+            href: category.link.permalink,
+          };
+        default:
+          throw new Error('Unexpected sidebar category link type');
+      }
+    }
+    // A non-collapsible category can't be collapsed!
+    if (category.collapsible === false) {
+      category.collapsed = false;
+    }
+    return category;
+  }
+  return item;
+}
+
+export function postProcessSidebars(
+  sidebars: ProcessedSidebars,
+  params: SidebarProcessorParams,
+): Sidebars {
+  return mapValues(sidebars, (sidebar) =>
+    sidebar.map((item) => postProcessSidebarItem(item, params)),
+  );
+}

package/src/sidebars/processor.ts

@@ -7,41 +7,23 @@
 
 import type {DocMetadataBase, VersionMetadata} from '../types';
 import type {
-  Sidebars,
-  Sidebar,
-  SidebarItem,
   NormalizedSidebarItem,
   NormalizedSidebar,
   NormalizedSidebars,
-  SidebarItemsGeneratorOption,
   SidebarItemsGeneratorDoc,
   SidebarItemsGeneratorVersion,
-  NormalizedSidebarItemCategory,
-  SidebarItemCategory,
   SidebarItemAutogenerated,
+  ProcessedSidebarItem,
+  ProcessedSidebar,
+  ProcessedSidebars,
+  SidebarProcessorParams,
   CategoryMetadataFile,
 } from './types';
-import {transformSidebarItems} from './utils';
 import {DefaultSidebarItemsGenerator} from './generator';
+import {validateSidebars} from './validation';
 import {mapValues, memoize, pick} from 'lodash';
 import combinePromises from 'combine-promises';
-import {normalizeItem} from './normalization';
 import {isCategoryIndex} from '../docs';
-import type {Slugger} from '@docusaurus/utils';
-import type {
-  NumberPrefixParser,
-  SidebarOptions,
-} from '@docusaurus/plugin-content-docs';
-
-export type SidebarProcessorParams = {
-  sidebarItemsGenerator: SidebarItemsGeneratorOption;
-  numberPrefixParser: NumberPrefixParser;
-  docs: DocMetadataBase[];
-  version: VersionMetadata;
-  categoryLabelSlugger: Slugger;
-  sidebarOptions: SidebarOptions;
-  categoriesMetadata: Record<string, CategoryMetadataFile>;
-};
 
 function toSidebarItemsGeneratorDoc(
   doc: DocMetadataBase,
@@ -66,15 +48,15 @@ function toSidebarItemsGeneratorVersion(
 // post-processing checks
 async function processSidebar(
   unprocessedSidebar: NormalizedSidebar,
+  categoriesMetadata: Record<string, CategoryMetadataFile>,
   params: SidebarProcessorParams,
-): Promise<Sidebar> {
+): Promise<ProcessedSidebar> {
   const {
     sidebarItemsGenerator,
     numberPrefixParser,
     docs,
     version,
     sidebarOptions,
-    categoriesMetadata,
   } = params;
 
   // Just a minor lazy transformation optimization
@@ -83,20 +65,9 @@ async function processSidebar(
     version: toSidebarItemsGeneratorVersion(version),
   }));
 
-  async function processCategoryItem(
-    item: NormalizedSidebarItemCategory,
-  ): Promise<SidebarItemCategory> {
-    return {
-      ...item,
-      items: (await Promise.all(item.items.map(processItem))).flat(),
-    };
-  }
-
   async function processAutoGeneratedItem(
     item: SidebarItemAutogenerated,
-  ): Promise<SidebarItem[]> {
-    // TODO the returned type can't be trusted in practice (generator can be
-    // user-provided)
+  ): Promise<ProcessedSidebarItem[]> {
     const generatedItems = await sidebarItemsGenerator({
       item,
       numberPrefixParser,
@@ -106,50 +77,23 @@ async function processSidebar(
       options: sidebarOptions,
       categoriesMetadata,
     });
-    // TODO validate generated items: user can generate bad items
-
-    const generatedItemsNormalized = generatedItems.flatMap((generatedItem) =>
-      normalizeItem(generatedItem, {...params, ...sidebarOptions}),
-    );
-
     // Process again... weird but sidebar item generated might generate some
     // auto-generated items?
-    return processItems(generatedItemsNormalized);
+    // TODO repeatedly process & unwrap autogenerated items until there are no
+    // more autogenerated items, or when loop count (e.g. 10) is reached
+    return processItems(generatedItems);
   }
 
   async function processItem(
     item: NormalizedSidebarItem,
-  ): Promise<SidebarItem[]> {
+  ): Promise<ProcessedSidebarItem[]> {
     if (item.type === 'category') {
-      // If the current category doesn't have subitems, we render a normal doc link instead.
-      if (item.items.length === 0) {
-        if (!item.link) {
-          throw new Error(
-            `Sidebar category ${item.label} has neither any subitem nor a link. This makes this item not able to link to anything.`,
-          );
-        }
-        switch (item.link.type) {
-          case 'doc':
-            return [
-              {
-                type: 'doc',
-                label: item.label,
-                id: item.link.id,
-              },
-            ];
-          case 'generated-index':
-            return [
-              {
-                type: 'link',
-                label: item.label,
-                href: item.link.permalink,
-              },
-            ];
-          default:
-            throw new Error('Unexpected sidebar category link type');
-        }
-      }
-      return [await processCategoryItem(item)];
+      return [
+        {
+          ...item,
+          items: (await Promise.all(item.items.map(processItem))).flat(),
+        },
+      ];
     }
     if (item.type === 'autogenerated') {
       return processAutoGeneratedItem(item);
@@ -159,32 +103,24 @@ async function processSidebar(
 
   async function processItems(
     items: NormalizedSidebarItem[],
-  ): Promise<SidebarItem[]> {
+  ): Promise<ProcessedSidebarItem[]> {
     return (await Promise.all(items.map(processItem))).flat();
   }
 
   const processedSidebar = await processItems(unprocessedSidebar);
-
-  const fixSidebarItemInconsistencies = (item: SidebarItem): SidebarItem => {
-    // A non-collapsible category can't be collapsed!
-    if (item.type === 'category' && !item.collapsible && item.collapsed) {
-      return {
-        ...item,
-        collapsed: false,
-      };
-    }
-    return item;
-  };
-  return transformSidebarItems(processedSidebar, fixSidebarItemInconsistencies);
+  return processedSidebar;
 }
 
 export async function processSidebars(
   unprocessedSidebars: NormalizedSidebars,
+  categoriesMetadata: Record<string, CategoryMetadataFile>,
   params: SidebarProcessorParams,
-): Promise<Sidebars> {
-  return combinePromises(
+): Promise<ProcessedSidebars> {
+  const processedSidebars = await combinePromises(
     mapValues(unprocessedSidebars, (unprocessedSidebar) =>
-      processSidebar(unprocessedSidebar, params),
+      processSidebar(unprocessedSidebar, categoriesMetadata, params),
     ),
   );
+  validateSidebars(processedSidebars);
+  return processedSidebars;
 }

package/src/sidebars/types.ts

@@ -12,6 +12,7 @@ import type {
   SidebarOptions,
   CategoryIndexMatcher,
 } from '@docusaurus/plugin-content-docs';
+import type {Slugger} from '@docusaurus/utils';
 
 // Makes all properties visible when hovering over the type
 type Expand<T extends Record<string, unknown>> = {[P in keyof T]: T[P]};
@@ -82,13 +83,13 @@ export type SidebarItemCategoryLink =
 // The user-given configuration in sidebars.js, before normalization
 export type SidebarItemCategoryConfig = Expand<
   Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
-    items: SidebarItemConfig[];
+    items: SidebarCategoriesShorthand | SidebarItemConfig[];
     link?: SidebarItemCategoryLinkConfig;
   }
 >;
 
 export type SidebarCategoriesShorthand = {
-  [sidebarCategory: string]: SidebarItemConfig[];
+  [sidebarCategory: string]: SidebarCategoriesShorthand | SidebarItemConfig[];
 };
 
 export type SidebarItemConfig =
@@ -107,9 +108,9 @@ export type SidebarsConfig = {
 
 // Normalized but still has 'autogenerated', which will be handled in processing
 export type NormalizedSidebarItemCategory = Expand<
-  SidebarItemCategoryBase & {
+  Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
     items: NormalizedSidebarItem[];
-    link?: SidebarItemCategoryLink;
+    link?: SidebarItemCategoryLinkConfig;
   }
 >;
 
@@ -125,6 +126,22 @@ export type NormalizedSidebars = {
   [sidebarId: string]: NormalizedSidebar;
 };
 
+export type ProcessedSidebarItemCategory = Expand<
+  Optional<SidebarItemCategoryBase, 'collapsed' | 'collapsible'> & {
+    items: ProcessedSidebarItem[];
+    link?: SidebarItemCategoryLinkConfig;
+  }
+>;
+export type ProcessedSidebarItem =
+  | SidebarItemDoc
+  | SidebarItemHtml
+  | SidebarItemLink
+  | ProcessedSidebarItemCategory;
+export type ProcessedSidebar = ProcessedSidebarItem[];
+export type ProcessedSidebars = {
+  [sidebarId: string]: ProcessedSidebar;
+};
+
 export type SidebarItemCategory = Expand<
   SidebarItemCategoryBase & {
     items: SidebarItem[];
@@ -230,9 +247,7 @@ export type SidebarItemsGeneratorArgs = {
 };
 export type SidebarItemsGenerator = (
   generatorArgs: SidebarItemsGeneratorArgs,
-) => // TODO TS issue: the generator can generate un-normalized items!
-Promise<SidebarItem[]>;
-// Promise<SidebarItemConfig[]>;
+) => Promise<NormalizedSidebar>;
 
 // Also inject the default generator to conveniently wrap/enhance/sort the
 // default sidebar gen logic
@@ -242,4 +257,13 @@ export type SidebarItemsGeneratorOptionArgs = {
 } & SidebarItemsGeneratorArgs;
 export type SidebarItemsGeneratorOption = (
   generatorArgs: SidebarItemsGeneratorOptionArgs,
-) => Promise<SidebarItem[]>;
+) => Promise<NormalizedSidebarItem[]>;
+
+export type SidebarProcessorParams = {
+  sidebarItemsGenerator: SidebarItemsGeneratorOption;
+  numberPrefixParser: NumberPrefixParser;
+  docs: DocMetadataBase[];
+  version: VersionMetadata;
+  categoryLabelSlugger: Slugger;
+  sidebarOptions: SidebarOptions;
+};

package/src/sidebars/utils.ts

@@ -303,7 +303,6 @@ Available document ids are:
         label: string;
       }
     | undefined {
-    // eslint-disable-next-line no-restricted-syntax
     for (const item of sidebar) {
       if (item.type === 'doc') {
         return {

package/src/sidebars/validation.ts

@@ -8,7 +8,6 @@
 import {Joi, URISchema} from '@docusaurus/utils-validation';
 import type {
   SidebarItemConfig,
-  SidebarCategoriesShorthand,
   SidebarItemBase,
   SidebarItemAutogenerated,
   SidebarItemDoc,
@@ -16,12 +15,13 @@ import type {
   SidebarItemLink,
   SidebarItemCategoryConfig,
   SidebarItemCategoryLink,
-  SidebarsConfig,
   SidebarItemCategoryLinkDoc,
   SidebarItemCategoryLinkGeneratedIndex,
+  NormalizedSidebars,
+  NormalizedSidebarItem,
+  NormalizedSidebarItemCategory,
   CategoryMetadataFile,
 } from './types';
-import {isCategoriesShorthand} from './utils';
 
 // NOTE: we don't add any default values during validation on purpose!
 // Config types are exposed to users for typechecking and we use the same type
@@ -52,7 +52,7 @@ const sidebarItemDocSchema = sidebarItemBaseSchema.append<SidebarItemDoc>({
 const sidebarItemHtmlSchema = sidebarItemBaseSchema.append<SidebarItemHtml>({
   type: 'html',
   value: Joi.string().required(),
-  defaultStyle: Joi.boolean().default(false),
+  defaultStyle: Joi.boolean(),
 });
 
 const sidebarItemLinkSchema = sidebarItemBaseSchema.append<SidebarItemLink>({
@@ -88,14 +88,13 @@ const sidebarItemCategoryLinkSchema = Joi.object<SidebarItemCategoryLink>()
         }),
       },
       {
-        is: Joi.string().required(),
+        is: Joi.required(),
         then: Joi.forbidden().messages({
           'any.unknown': 'Unknown sidebar category link type "{.type}".',
         }),
       },
     ],
-  })
-  .id('sidebarCategoryLinkSchema');
+  });
 
 const sidebarItemCategorySchema =
   sidebarItemBaseSchema.append<SidebarItemCategoryConfig>({
@@ -103,10 +102,11 @@ const sidebarItemCategorySchema =
     label: Joi.string()
       .required()
       .messages({'any.unknown': '"label" must be a string'}),
-    // TODO: Joi doesn't allow mutual recursion. See https://github.com/sideway/joi/issues/2611
     items: Joi.array()
       .required()
-      .messages({'any.unknown': '"items" must be an array'}), // .items(Joi.link('#sidebarItemSchema')),
+      .messages({'any.unknown': '"items" must be an array'}),
+    // TODO: Joi doesn't allow mutual recursion. See https://github.com/sideway/joi/issues/2611
+    // .items(Joi.link('#sidebarItemSchema')),
     link: sidebarItemCategoryLinkSchema,
     collapsed: Joi.boolean().messages({
       'any.unknown': '"collapsed" must be a boolean',
@@ -116,56 +116,44 @@ const sidebarItemCategorySchema =
     }),
   });
 
-const sidebarItemSchema: Joi.Schema<SidebarItemConfig> = Joi.object()
-  .when('.type', {
-    switch: [
-      {is: 'link', then: sidebarItemLinkSchema},
-      {
-        is: Joi.string().valid('doc', 'ref').required(),
-        then: sidebarItemDocSchema,
-      },
-      {is: 'html', then: sidebarItemHtmlSchema},
-      {is: 'autogenerated', then: sidebarItemAutogeneratedSchema},
-      {is: 'category', then: sidebarItemCategorySchema},
-      {
-        is: Joi.any().required(),
-        then: Joi.forbidden().messages({
-          'any.unknown': 'Unknown sidebar item type "{.type}".',
-        }),
-      },
-    ],
-  })
-  .id('sidebarItemSchema');
+const sidebarItemSchema = Joi.object<SidebarItemConfig>().when('.type', {
+  switch: [
+    {is: 'link', then: sidebarItemLinkSchema},
+    {
+      is: Joi.string().valid('doc', 'ref').required(),
+      then: sidebarItemDocSchema,
+    },
+    {is: 'html', then: sidebarItemHtmlSchema},
+    {is: 'autogenerated', then: sidebarItemAutogeneratedSchema},
+    {is: 'category', then: sidebarItemCategorySchema},
+    {
+      is: Joi.any().required(),
+      then: Joi.forbidden().messages({
+        'any.unknown': 'Unknown sidebar item type "{.type}".',
+      }),
+    },
+  ],
+});
+// .id('sidebarItemSchema');
 
-function validateSidebarItem(item: unknown): asserts item is SidebarItemConfig {
-  if (typeof item === 'string') {
-    return;
-  }
+function validateSidebarItem(
+  item: unknown,
+): asserts item is NormalizedSidebarItem {
   // TODO: remove once with proper Joi support
   // Because we can't use Joi to validate nested items (see above), we do it
   // manually
-  if (isCategoriesShorthand(item as SidebarItemConfig)) {
-    Object.values(item as SidebarCategoriesShorthand).forEach((category) =>
-      category.forEach(validateSidebarItem),
-    );
-  } else {
-    Joi.assert(item, sidebarItemSchema);
+  Joi.assert(item, sidebarItemSchema);
 
-    if ((item as SidebarItemCategoryConfig).type === 'category') {
-      (item as SidebarItemCategoryConfig).items.forEach(validateSidebarItem);
-    }
+  if ((item as NormalizedSidebarItemCategory).type === 'category') {
+    (item as NormalizedSidebarItemCategory).items.forEach(validateSidebarItem);
   }
 }
 
 export function validateSidebars(
-  sidebars: unknown,
-): asserts sidebars is SidebarsConfig {
-  Object.values(sidebars as SidebarsConfig).forEach((sidebar) => {
-    if (Array.isArray(sidebar)) {
-      sidebar.forEach(validateSidebarItem);
-    } else {
-      validateSidebarItem(sidebar);
-    }
+  sidebars: Record<string, unknown>,
+): asserts sidebars is NormalizedSidebars {
+  Object.values(sidebars as NormalizedSidebars).forEach((sidebar) => {
+    sidebar.forEach(validateSidebarItem);
   });
 }
 

package/src/types.ts

@@ -8,15 +8,12 @@
 /// <reference types="@docusaurus/module-type-aliases" />
 
 import type {Sidebars} from './sidebars/types';
-import type {Tag, FrontMatterTag, Slugger} from '@docusaurus/utils';
+import type {Tag, FrontMatterTag} from '@docusaurus/utils';
 import type {
   BrokenMarkdownLink as IBrokenMarkdownLink,
   ContentPaths,
 } from '@docusaurus/utils/lib/markdownLinks';
-import type {
-  VersionBanner,
-  SidebarOptions,
-} from '@docusaurus/plugin-content-docs';
+import type {VersionBanner} from '@docusaurus/plugin-content-docs';
 
 export type DocFile = {
   contentPath: string; // /!\ may be localized
@@ -41,11 +38,6 @@ export type VersionMetadata = ContentPaths & {
   routePriority: number | undefined; // -1 for the latest docs
 };
 
-export type NormalizeSidebarsParams = SidebarOptions & {
-  version: VersionMetadata;
-  categoryLabelSlugger: Slugger;
-};
-
 export type LastUpdateData = {
   lastUpdatedAt?: number;
   formattedLastUpdatedAt?: string;

package/lib/client/globalDataHooks.d.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.
- */
-import type { GlobalPluginData, GlobalVersion, ActivePlugin, ActiveDocContext, DocVersionSuggestions, GetActivePluginOptions } from '@docusaurus/plugin-content-docs/client';
-export declare const useAllDocsData: () => Record<string, GlobalPluginData>;
-export declare const useDocsData: (pluginId: string | undefined) => GlobalPluginData;
-export declare const useActivePlugin: (options?: GetActivePluginOptions) => ActivePlugin | undefined;
-export declare const useActivePluginAndVersion: (options?: GetActivePluginOptions) => {
-    activePlugin: ActivePlugin;
-    activeVersion: GlobalVersion | undefined;
-} | undefined;
-export declare const useVersions: (pluginId: string | undefined) => GlobalVersion[];
-export declare const useLatestVersion: (pluginId: string | undefined) => GlobalVersion;
-export declare const useActiveVersion: (pluginId: string | undefined) => GlobalVersion | undefined;
-export declare const useActiveDocContext: (pluginId: string | undefined) => ActiveDocContext;
-export declare const useDocVersionSuggestions: (pluginId: string | undefined) => DocVersionSuggestions;

package/lib/client/globalDataHooks.js

@@ -1,77 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useDocVersionSuggestions = exports.useActiveDocContext = exports.useActiveVersion = exports.useLatestVersion = exports.useVersions = exports.useActivePluginAndVersion = exports.useActivePlugin = exports.useDocsData = exports.useAllDocsData = void 0;
-const tslib_1 = require("tslib");
-const router_1 = require("@docusaurus/router");
-const useGlobalData_1 = (0, tslib_1.__importStar)(require("@docusaurus/useGlobalData"));
-const docsClientUtils_1 = require("./docsClientUtils");
-// Important to use a constant object to avoid React useEffect executions etc.
-// see https://github.com/facebook/docusaurus/issues/5089
-const StableEmptyObject = {};
-// Not using useAllPluginInstancesData() because in blog-only mode, docs hooks
-// are still used by the theme. We need a fail-safe fallback when the docs
-// plugin is not in use
-const useAllDocsData = () => { var _a; 
-// useAllPluginInstancesData('docusaurus-plugin-content-docs');
-return (_a = (0, useGlobalData_1.default)()['docusaurus-plugin-content-docs']) !== null && _a !== void 0 ? _a : StableEmptyObject; };
-exports.useAllDocsData = useAllDocsData;
-const useDocsData = (pluginId) => (0, useGlobalData_1.usePluginData)('docusaurus-plugin-content-docs', pluginId);
-exports.useDocsData = useDocsData;
-// TODO this feature should be provided by docusaurus core
-const useActivePlugin = (options = {}) => {
-    const data = (0, exports.useAllDocsData)();
-    const { pathname } = (0, router_1.useLocation)();
-    return (0, docsClientUtils_1.getActivePlugin)(data, pathname, options);
-};
-exports.useActivePlugin = useActivePlugin;
-const useActivePluginAndVersion = (options = {}) => {
-    const activePlugin = (0, exports.useActivePlugin)(options);
-    const { pathname } = (0, router_1.useLocation)();
-    if (activePlugin) {
-        const activeVersion = (0, docsClientUtils_1.getActiveVersion)(activePlugin.pluginData, pathname);
-        return {
-            activePlugin,
-            activeVersion,
-        };
-    }
-    return undefined;
-};
-exports.useActivePluginAndVersion = useActivePluginAndVersion;
-// versions are returned ordered (most recent first)
-const useVersions = (pluginId) => {
-    const data = (0, exports.useDocsData)(pluginId);
-    return data.versions;
-};
-exports.useVersions = useVersions;
-const useLatestVersion = (pluginId) => {
-    const data = (0, exports.useDocsData)(pluginId);
-    return (0, docsClientUtils_1.getLatestVersion)(data);
-};
-exports.useLatestVersion = useLatestVersion;
-// Note: return undefined on doc-unrelated pages,
-// because there's no version currently considered as active
-const useActiveVersion = (pluginId) => {
-    const data = (0, exports.useDocsData)(pluginId);
-    const { pathname } = (0, router_1.useLocation)();
-    return (0, docsClientUtils_1.getActiveVersion)(data, pathname);
-};
-exports.useActiveVersion = useActiveVersion;
-const useActiveDocContext = (pluginId) => {
-    const data = (0, exports.useDocsData)(pluginId);
-    const { pathname } = (0, router_1.useLocation)();
-    return (0, docsClientUtils_1.getActiveDocContext)(data, pathname);
-};
-exports.useActiveDocContext = useActiveDocContext;
-// Useful to say "hey, you are not on the latest docs version, please switch"
-const useDocVersionSuggestions = (pluginId) => {
-    const data = (0, exports.useDocsData)(pluginId);
-    const { pathname } = (0, router_1.useLocation)();
-    return (0, docsClientUtils_1.getDocVersionSuggestions)(data, pathname);
-};
-exports.useDocVersionSuggestions = useDocVersionSuggestions;