@seqera/docusaurus-theme-seqera 1.0.13-next.49 → 1.0.14-next.54

package/lib/theme/DocSidebar/Desktop/Content/VersionSwitcher/index.js

@@ -1,13 +1,17 @@
 import React, {useRef, useEffect} from 'react';
 import {
   useVersions,
-  useDocsVersion,
   useDocsPreferredVersion,
   useActiveDocContext,
 } from '@docusaurus/plugin-content-docs/client';
 import {useAllPluginInstancesData} from '@docusaurus/useGlobalData';
 import {useLocation} from '@docusaurus/router';
 import Link from '@docusaurus/Link';
+import {useVersionDropdownConfig} from '../../../../hooks/useVersionDropdownConfig';
+import {
+  getVersionTargetDoc,
+  processVersions,
+} from '../../../../utils/versionHelpers';
 /**
  * Detects which docs plugin is active based on the current pathname
  */
@@ -24,29 +28,21 @@ function useActiveDocsPlugin() {
   }
   return null;
 }
-/**
- * Helper functions to get version documents
- */
-function getVersionMainDoc(version) {
-  return version.docs.find((doc) => doc.id === version.mainDocId);
-}
-function getVersionTargetDoc(version, activeDocContext) {
-  // Try to link to the same doc in another version
-  // When not possible, fallback to the "main doc" of the version
-  return (
-    activeDocContext.alternateDocVersions[version.name] ??
-    getVersionMainDoc(version)
-  );
-}
 const VersionSwitcherInner = ({isOpen, setIsOpen, pluginId}) => {
   const dropdownRef = useRef(null);
   // Always call hooks unconditionally - this component only renders when pluginId exists
   const versions = useVersions(pluginId);
   const {savePreferredVersionName} = useDocsPreferredVersion(pluginId);
-  const currentVersion = useDocsVersion();
   const activeDocContext = useActiveDocContext(pluginId);
-  // Only show version switcher if there is at least 1 version
-  if (!versions || versions.length === 0) return null;
+  const currentVersion = activeDocContext.activeVersion;
+  // Get configuration for this plugin's version dropdown
+  const config = useVersionDropdownConfig(pluginId);
+  // If version dropdown is disabled for this plugin, don't show it
+  if (!config.enabled) return null;
+  // Process versions based on configuration
+  const processedVersions = processVersions(versions, config);
+  // Only show version switcher if there are at least 2 versions after processing
+  if (!processedVersions || processedVersions.length < 2) return null;
   useEffect(() => {
     const handleClickOutside = (event) => {
       if (dropdownRef.current?.contains(event.target)) return;
@@ -61,8 +57,13 @@ const VersionSwitcherInner = ({isOpen, setIsOpen, pluginId}) => {
   function handleSelectVersion(version) {
     savePreferredVersionName(version);
   }
-  const items = versions.filter(
-    (version) => version.label !== currentVersion?.label,
+  // Update currentVersion label if it's the current version and should be shown with custom label
+  const displayCurrentVersion =
+    currentVersion?.name === 'current' && config.showCurrent
+      ? {...currentVersion, label: config.currentLabel}
+      : currentVersion;
+  const items = processedVersions.filter(
+    (version) => version.label !== displayCurrentVersion?.label,
   );
   return (
     <div ref={dropdownRef} className="relative px-4">
@@ -74,8 +75,11 @@ const VersionSwitcherInner = ({isOpen, setIsOpen, pluginId}) => {
           onClick={toggleDropdown}
           className="h-9 w-full flex items-center justify-between px-3 text-sm bg-transparent border-none cursor-pointer relative z-10 text-gray-900 dark:text-white transition-colors hover:bg-gray-100 dark:hover:bg-gray-800">
           <span>
-            {currentVersion ? `v${currentVersion.label}` : 'Version'}{' '}
-            {currentVersion && currentVersion.label === versions[0]?.label
+            {displayCurrentVersion
+              ? `v${displayCurrentVersion.label}`
+              : 'Version'}{' '}
+            {displayCurrentVersion &&
+            displayCurrentVersion.label === processedVersions[0]?.label
               ? '(current)'
               : ''}
           </span>
@@ -103,7 +107,9 @@ const VersionSwitcherInner = ({isOpen, setIsOpen, pluginId}) => {
                     to={targetDoc.path}
                     className="h-9 w-full flex items-center justify-between px-3 text-sm bg-transparent cursor-pointer text-gray-900 dark:text-white transition-colors hover:bg-gray-100 dark:hover:bg-gray-800 no-underline border-t border-gray-200 dark:border-gray-700 first:border-t-0">
                     v{version.label}{' '}
-                    {version.label === versions[0]?.label ? '(current)' : ''}
+                    {version.label === processedVersions[0]?.label
+                      ? '(current)'
+                      : ''}
                   </Link>
                 </div>
               );

package/lib/theme/NavbarItem/DocsVersionDropdownNavbarItem.js

@@ -9,6 +9,8 @@ import {translate} from '@docusaurus/Translate';
 import {useHistorySelector} from '@docusaurus/theme-common';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 import DropdownNavbarItem from '@theme/NavbarItem/DropdownNavbarItem';
+import {useVersionDropdownConfig} from '../hooks/useVersionDropdownConfig';
+import {getVersionTargetDoc, processVersions} from '../utils/versionHelpers';
 function getVersionItems(versions, configs) {
   if (configs) {
     // Collect all the versions we have
@@ -38,17 +40,6 @@ function useVersionItems({docsPluginId, configs}) {
   const versions = useVersions(docsPluginId);
   return getVersionItems(versions, configs);
 }
-function getVersionMainDoc(version) {
-  return version.docs.find((doc) => doc.id === version.mainDocId);
-}
-function getVersionTargetDoc(version, activeDocContext) {
-  // We try to link to the same doc, in another version
-  // When not possible, fallback to the "main doc" of the version
-  return (
-    activeDocContext.alternateDocVersions[version.name] ??
-    getVersionMainDoc(version)
-  );
-}
 // The version item to use for the "dropdown button"
 function useDisplayedVersionItem({docsPluginId, versionItems}) {
   // The order of the candidates matters!
@@ -72,9 +63,15 @@ export default function DocsVersionDropdownNavbarItem({
   const activeDocContext = useActiveDocContext(docsPluginId);
   const {savePreferredVersionName} = useDocsPreferredVersion(docsPluginId);
   const versionItems = useVersionItems({docsPluginId, configs});
+  // Get configuration for this plugin's version dropdown
+  const config = useVersionDropdownConfig(docsPluginId ?? 'default');
+  // If version dropdown is disabled for this plugin, don't show it
+  if (!config.enabled) return null;
+  // Process version items based on configuration
+  const processedVersionItems = processVersions(versionItems, config);
   const displayedVersionItem = useDisplayedVersionItem({
     docsPluginId,
-    versionItems,
+    versionItems: processedVersionItems,
   });
   function versionItemToLink({version, label}) {
     const targetDoc = getVersionTargetDoc(version, activeDocContext);
@@ -86,9 +83,13 @@ export default function DocsVersionDropdownNavbarItem({
       onClick: () => savePreferredVersionName(version.name),
     };
   }
+  // Don't render version dropdown if there's only one version (no versions have been cut yet)
+  if (processedVersionItems.length < 2) {
+    return null;
+  }
   const items = [
     ...dropdownItemsBefore,
-    ...versionItems.map(versionItemToLink),
+    ...processedVersionItems.map(versionItemToLink),
     ...dropdownItemsAfter,
   ];
   // Mobile dropdown is handled a bit differently

package/lib/theme/NavbarItem/DocsVersionNavbarItem.js

@@ -1,8 +1,7 @@
 import React from 'react';
 import {useDocsVersionCandidates} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
-const getVersionMainDoc = (version) =>
-  version.docs.find((doc) => doc.id === version.mainDocId);
+import {getVersionMainDoc} from '../utils/versionHelpers';
 export default function DocsVersionNavbarItem({
   label: staticLabel,
   to: staticTo,

package/lib/theme/hooks/useVersionDropdownConfig.d.ts

@@ -0,0 +1,13 @@
+export interface VersionDropdownConfig {
+    enabled: boolean;
+    showCurrent: boolean;
+    currentLabel: string;
+}
+/**
+ * Hook to get version dropdown configuration for a specific docs plugin
+ * Extracts configuration from theme config and applies consistent defaults
+ *
+ * @param pluginId - The docs plugin ID (e.g., 'default', 'fusion', etc.)
+ * @returns Normalized configuration object with defaults applied
+ */
+export declare function useVersionDropdownConfig(pluginId: string): VersionDropdownConfig;

package/lib/theme/hooks/useVersionDropdownConfig.js

@@ -0,0 +1,20 @@
+import {useThemeConfig} from '@docusaurus/theme-common';
+/**
+ * Hook to get version dropdown configuration for a specific docs plugin
+ * Extracts configuration from theme config and applies consistent defaults
+ *
+ * @param pluginId - The docs plugin ID (e.g., 'default', 'fusion', etc.)
+ * @returns Normalized configuration object with defaults applied
+ */
+export function useVersionDropdownConfig(pluginId) {
+  const themeConfig = useThemeConfig();
+  // Get configuration for this plugin's version dropdown
+  const docsConfig = themeConfig.seqera?.docs;
+  const versionDropdownConfig = docsConfig?.versionDropdown?.[pluginId] || {};
+  // Apply defaults
+  return {
+    enabled: versionDropdownConfig.enabled !== false, // default true
+    showCurrent: versionDropdownConfig.showCurrent === true, // default false
+    currentLabel: versionDropdownConfig.currentLabel || 'Next', // default "Next"
+  };
+}

package/lib/theme/utils/versionHelpers.d.ts

@@ -0,0 +1,35 @@
+import type { GlobalVersion, GlobalDoc, ActiveDocContext } from '@docusaurus/plugin-content-docs/client';
+/**
+ * Gets the main document for a version
+ */
+export declare function getVersionMainDoc(version: GlobalVersion): GlobalDoc;
+/**
+ * Gets the target document for navigation, with fallback to main doc
+ * Tries to link to the same doc in another version, falls back to main doc
+ */
+export declare function getVersionTargetDoc(version: GlobalVersion, activeDocContext: ActiveDocContext): GlobalDoc;
+/**
+ * Type guard to check if an object has a version property (VersionItem structure)
+ */
+type HasVersion = {
+    version: {
+        name: string;
+    };
+    label: string;
+};
+type HasName = {
+    name: string;
+    label?: string;
+};
+/**
+ * Processes versions based on configuration (filters and relabels)
+ * Handles both direct version objects and VersionItem wrappers
+ * @param versions - Array of versions or version items to process
+ * @param config - Configuration with showCurrent and currentLabel
+ * @returns Processed array with filtered and relabeled versions
+ */
+export declare function processVersions<T extends HasVersion | HasName>(versions: T[], config: {
+    showCurrent: boolean;
+    currentLabel: string;
+}): T[];
+export {};

package/lib/theme/utils/versionHelpers.js

@@ -0,0 +1,46 @@
+/**
+ * Gets the main document for a version
+ */
+export function getVersionMainDoc(version) {
+  return version.docs.find((doc) => doc.id === version.mainDocId);
+}
+/**
+ * Gets the target document for navigation, with fallback to main doc
+ * Tries to link to the same doc in another version, falls back to main doc
+ */
+export function getVersionTargetDoc(version, activeDocContext) {
+  return (
+    activeDocContext.alternateDocVersions[version.name] ??
+    getVersionMainDoc(version)
+  );
+}
+function hasVersionProperty(item) {
+  return item.version !== undefined && typeof item.version.name === 'string';
+}
+/**
+ * Processes versions based on configuration (filters and relabels)
+ * Handles both direct version objects and VersionItem wrappers
+ * @param versions - Array of versions or version items to process
+ * @param config - Configuration with showCurrent and currentLabel
+ * @returns Processed array with filtered and relabeled versions
+ */
+export function processVersions(versions, config) {
+  return versions
+    .map((item) => {
+      const versionName = hasVersionProperty(item)
+        ? item.version.name
+        : item.name;
+      if (versionName === 'current' && config.showCurrent) {
+        // Relabel current version with configured label
+        return {...item, label: config.currentLabel};
+      }
+      return item;
+    })
+    .filter((item) => {
+      const versionName = hasVersionProperty(item)
+        ? item.version.name
+        : item.name;
+      // If showCurrent is false, exclude the current/Next version
+      return config.showCurrent || versionName !== 'current';
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seqera/docusaurus-theme-seqera",
-  "version": "1.0.13-next.49",
+  "version": "1.0.14-next.54",
   "description": "Seqera docs theme for Docusaurus",
   "author": "Seqera docs team <education@seqera.io>",
   "license": "Apache-2.0",

package/src/theme/DocSidebar/Desktop/Content/VersionSwitcher/index.tsx

@@ -13,6 +13,8 @@ import type {
 import { useAllPluginInstancesData } from "@docusaurus/useGlobalData";
 import { useLocation } from "@docusaurus/router";
 import Link from "@docusaurus/Link";
+import { useVersionDropdownConfig } from "../../../../hooks/useVersionDropdownConfig";
+import { getVersionTargetDoc, processVersions } from "../../../../utils/versionHelpers";
 
 interface VersionSwitcherProps {
   isOpen: boolean;
@@ -42,24 +44,6 @@ function useActiveDocsPlugin(): string | null {
   return null;
 }
 
-/**
- * Helper functions to get version documents
- */
-function getVersionMainDoc(version: GlobalVersion): GlobalDoc {
-  return version.docs.find((doc) => doc.id === version.mainDocId)!;
-}
-
-function getVersionTargetDoc(
-  version: GlobalVersion,
-  activeDocContext: ActiveDocContext,
-): GlobalDoc {
-  // Try to link to the same doc in another version
-  // When not possible, fallback to the "main doc" of the version
-  return (
-    activeDocContext.alternateDocVersions[version.name] ??
-    getVersionMainDoc(version)
-  );
-}
 
 /**
  * Inner component that handles version switching for a specific plugin
@@ -74,11 +58,20 @@ const VersionSwitcherInner: React.FC<VersionSwitcherInnerProps> = ({ isOpen, set
   // Always call hooks unconditionally - this component only renders when pluginId exists
   const versions = useVersions(pluginId);
   const { savePreferredVersionName } = useDocsPreferredVersion(pluginId);
-  const currentVersion = useDocsVersion();
   const activeDocContext = useActiveDocContext(pluginId);
+  const currentVersion = activeDocContext.activeVersion;
+
+  // Get configuration for this plugin's version dropdown
+  const config = useVersionDropdownConfig(pluginId);
+
+  // If version dropdown is disabled for this plugin, don't show it
+  if (!config.enabled) return null;
 
-  // Only show version switcher if there is at least 1 version
-  if (!versions || versions.length === 0) return null;
+  // Process versions based on configuration
+  const processedVersions = processVersions(versions, config);
+
+  // Only show version switcher if there are at least 2 versions after processing
+  if (!processedVersions || processedVersions.length < 2) return null;
 
   useEffect(() => {
     const handleClickOutside = (event: MouseEvent) => {
@@ -98,8 +91,13 @@ const VersionSwitcherInner: React.FC<VersionSwitcherInnerProps> = ({ isOpen, set
     savePreferredVersionName(version);
   }
 
-  const items = versions.filter(
-    (version) => version.label !== currentVersion?.label,
+  // Update currentVersion label if it's the current version and should be shown with custom label
+  const displayCurrentVersion = currentVersion?.name === 'current' && config.showCurrent
+    ? { ...currentVersion, label: config.currentLabel }
+    : currentVersion;
+
+  const items = processedVersions.filter(
+    (version) => version.label !== displayCurrentVersion?.label,
   );
 
   return (
@@ -110,8 +108,8 @@ const VersionSwitcherInner: React.FC<VersionSwitcherInnerProps> = ({ isOpen, set
           className="h-9 w-full flex items-center justify-between px-3 text-sm bg-transparent border-none cursor-pointer relative z-10 text-gray-900 dark:text-white transition-colors hover:bg-gray-100 dark:hover:bg-gray-800"
         >
           <span>
-            {currentVersion ? `v${currentVersion.label}` : "Version"}{" "}
-            {currentVersion && currentVersion.label === versions[0]?.label
+            {displayCurrentVersion ? `v${displayCurrentVersion.label}` : "Version"}{" "}
+            {displayCurrentVersion && displayCurrentVersion.label === processedVersions[0]?.label
               ? "(current)"
               : ""}
           </span>
@@ -140,7 +138,7 @@ const VersionSwitcherInner: React.FC<VersionSwitcherInnerProps> = ({ isOpen, set
                     className="h-9 w-full flex items-center justify-between px-3 text-sm bg-transparent cursor-pointer text-gray-900 dark:text-white transition-colors hover:bg-gray-100 dark:hover:bg-gray-800 no-underline border-t border-gray-200 dark:border-gray-700 first:border-t-0"
                   >
                     v{version.label}{" "}
-                    {version.label === versions[0]?.label ? "(current)" : ""}
+                    {version.label === processedVersions[0]?.label ? "(current)" : ""}
                   </Link>
                 </div>
               );

package/src/theme/NavbarItem/DocsVersionDropdownNavbarItem.tsx

@@ -19,9 +19,10 @@ import type {
 import type {LinkLikeNavbarItemProps} from '@theme/NavbarItem';
 import type {
   GlobalVersion,
-  GlobalDoc,
   ActiveDocContext,
 } from '@docusaurus/plugin-content-docs/client';
+import { useVersionDropdownConfig } from '../hooks/useVersionDropdownConfig';
+import { getVersionTargetDoc, processVersions } from '../utils/versionHelpers';
 
 type VersionItem = {
   version: GlobalVersion;
@@ -73,22 +74,6 @@ function useVersionItems({
   return getVersionItems(versions, configs);
 }
 
-function getVersionMainDoc(version: GlobalVersion): GlobalDoc {
-  return version.docs.find((doc) => doc.id === version.mainDocId)!;
-}
-
-function getVersionTargetDoc(
-  version: GlobalVersion,
-  activeDocContext: ActiveDocContext,
-): GlobalDoc {
-  // We try to link to the same doc, in another version
-  // When not possible, fallback to the "main doc" of the version
-  return (
-    activeDocContext.alternateDocVersions[version.name] ??
-    getVersionMainDoc(version)
-  );
-}
-
 // The version item to use for the "dropdown button"
 function useDisplayedVersionItem({
   docsPluginId,
@@ -119,9 +104,19 @@ export default function DocsVersionDropdownNavbarItem({
   const activeDocContext = useActiveDocContext(docsPluginId);
   const {savePreferredVersionName} = useDocsPreferredVersion(docsPluginId);
   const versionItems = useVersionItems({docsPluginId, configs});
+
+  // Get configuration for this plugin's version dropdown
+  const config = useVersionDropdownConfig(docsPluginId ?? 'default');
+
+  // If version dropdown is disabled for this plugin, don't show it
+  if (!config.enabled) return null;
+
+  // Process version items based on configuration
+  const processedVersionItems = processVersions(versionItems, config);
+
   const displayedVersionItem = useDisplayedVersionItem({
     docsPluginId,
-    versionItems,
+    versionItems: processedVersionItems,
   });
 
   function versionItemToLink({
@@ -138,9 +133,14 @@ export default function DocsVersionDropdownNavbarItem({
     };
   }
 
+  // Don't render version dropdown if there's only one version (no versions have been cut yet)
+  if (processedVersionItems.length < 2) {
+    return null;
+  }
+
   const items: LinkLikeNavbarItemProps[] = [
     ...dropdownItemsBefore,
-    ...versionItems.map(versionItemToLink),
+    ...processedVersionItems.map(versionItemToLink),
     ...dropdownItemsAfter,
   ];
 

package/src/theme/NavbarItem/DocsVersionNavbarItem.tsx

@@ -4,10 +4,7 @@ import React, {type ReactNode} from 'react';
 import {useDocsVersionCandidates} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 import type {Props} from '@theme/NavbarItem/DocsVersionNavbarItem';
-import type {GlobalVersion} from '@docusaurus/plugin-content-docs/client';
-
-const getVersionMainDoc = (version: GlobalVersion) =>
-  version.docs.find((doc) => doc.id === version.mainDocId)!;
+import { getVersionMainDoc } from '../utils/versionHelpers';
 
 export default function DocsVersionNavbarItem({
   label: staticLabel,

package/src/theme/hooks/useVersionDropdownConfig.ts

@@ -0,0 +1,30 @@
+import { useThemeConfig } from '@docusaurus/theme-common';
+import type { DocsVersionConfig } from '@seqera/docusaurus-theme-seqera';
+
+export interface VersionDropdownConfig {
+  enabled: boolean;
+  showCurrent: boolean;
+  currentLabel: string;
+}
+
+/**
+ * Hook to get version dropdown configuration for a specific docs plugin
+ * Extracts configuration from theme config and applies consistent defaults
+ *
+ * @param pluginId - The docs plugin ID (e.g., 'default', 'fusion', etc.)
+ * @returns Normalized configuration object with defaults applied
+ */
+export function useVersionDropdownConfig(pluginId: string): VersionDropdownConfig {
+  const themeConfig = useThemeConfig();
+
+  // Get configuration for this plugin's version dropdown
+  const docsConfig = (themeConfig as any).seqera?.docs as DocsVersionConfig | undefined;
+  const versionDropdownConfig = docsConfig?.versionDropdown?.[pluginId] || {};
+
+  // Apply defaults
+  return {
+    enabled: versionDropdownConfig.enabled !== false, // default true
+    showCurrent: versionDropdownConfig.showCurrent === true, // default false
+    currentLabel: versionDropdownConfig.currentLabel || 'Next', // default "Next"
+  };
+}

package/src/theme/utils/versionHelpers.ts

@@ -0,0 +1,63 @@
+import type {
+  GlobalVersion,
+  GlobalDoc,
+  ActiveDocContext,
+} from '@docusaurus/plugin-content-docs/client';
+
+/**
+ * Gets the main document for a version
+ */
+export function getVersionMainDoc(version: GlobalVersion): GlobalDoc {
+  return version.docs.find((doc) => doc.id === version.mainDocId)!;
+}
+
+/**
+ * Gets the target document for navigation, with fallback to main doc
+ * Tries to link to the same doc in another version, falls back to main doc
+ */
+export function getVersionTargetDoc(
+  version: GlobalVersion,
+  activeDocContext: ActiveDocContext,
+): GlobalDoc {
+  return (
+    activeDocContext.alternateDocVersions[version.name] ??
+    getVersionMainDoc(version)
+  );
+}
+
+/**
+ * Type guard to check if an object has a version property (VersionItem structure)
+ */
+type HasVersion = { version: { name: string }; label: string };
+type HasName = { name: string; label?: string };
+
+function hasVersionProperty(item: any): item is HasVersion {
+  return item.version !== undefined && typeof item.version.name === 'string';
+}
+
+/**
+ * Processes versions based on configuration (filters and relabels)
+ * Handles both direct version objects and VersionItem wrappers
+ * @param versions - Array of versions or version items to process
+ * @param config - Configuration with showCurrent and currentLabel
+ * @returns Processed array with filtered and relabeled versions
+ */
+export function processVersions<T extends HasVersion | HasName>(
+  versions: T[],
+  config: { showCurrent: boolean; currentLabel: string },
+): T[] {
+  return versions
+    .map((item) => {
+      const versionName = hasVersionProperty(item) ? item.version.name : item.name;
+      if (versionName === 'current' && config.showCurrent) {
+        // Relabel current version with configured label
+        return { ...item, label: config.currentLabel };
+      }
+      return item;
+    })
+    .filter((item) => {
+      const versionName = hasVersionProperty(item) ? item.version.name : item.name;
+      // If showCurrent is false, exclude the current/Next version
+      return config.showCurrent || versionName !== 'current';
+    });
+}

package/src/theme-seqera.d.ts

@@ -40,6 +40,22 @@ declare module '@seqera/docusaurus-theme-seqera' {
       }
     : U;
 
+  export interface DocsVersionDropdownConfig {
+    /** Whether to show the version dropdown (default: true) */
+    enabled?: boolean;
+    /** Whether to include the current/Next version in the dropdown (default: false) */
+    showCurrent?: boolean;
+    /** Label to use for the current version when showCurrent is true (default: "Next") */
+    currentLabel?: string;
+  }
+
+  export interface DocsVersionConfig {
+    /** Configuration for version dropdowns, indexed by plugin ID. Use "default" for the main docs plugin. */
+    versionDropdown?: {
+      [pluginId: string]: DocsVersionDropdownConfig;
+    };
+  }
+
   type OverwriteConfig = {
     seqera: {
       tailwindConfig?: tailwindConfig;
@@ -51,7 +67,7 @@ declare module '@seqera/docusaurus-theme-seqera' {
       footer: {
         socialLinks?: SocialLink[];
       };
-      docs?: {};
+      docs?: DocsVersionConfig;
     };
   };