boltdocs 2.5.6 → 2.6.1

package/dist/client/index.d.ts

@@ -1,110 +1,37 @@
 
-import * as _$vite from "vite";
-import { Plugin } from "vite";
-import * as _$react from "react";
-import React$1, { Component, ComponentPropsWithoutRef, ErrorInfo, ImgHTMLAttributes, ReactNode, RefObject } from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import * as _$react_router_dom0 from "react-router-dom";
 import { LinkProps as LinkProps$1 } from "react-router-dom";
-import * as _$class_variance_authority_types0 from "class-variance-authority/types";
+import * as _$react from "react";
+import { Component, ComponentPropsWithoutRef, ErrorInfo, ImgHTMLAttributes, ReactNode, RefObject } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import * as RAC from "react-aria-components";
 import { LinkProps as LinkProps$2 } from "react-aria-components";
-import { VariantProps } from "class-variance-authority";
 import { ClassValue } from "clsx";
+import { VariantProps } from "class-variance-authority";
+import { Plugin } from "vite";
+import { RouteRecord } from "@bdocs/ssg";
+import * as _$class_variance_authority_types0 from "class-variance-authority/types";
 
-//#region src/node/plugins/plugin-types.d.ts
-/**
- * Permissions that a plugin can request to access specific Boltdocs capabilities.
- */
-type PluginPermission = 'fs:read' | 'fs:write' | 'vite:config' | 'mdx:remark' | 'mdx:rehype' | 'components' | 'hooks:build' | 'hooks:dev';
-/**
- * Shared context injected into every plugin lifecycle hook.
- */
-interface PluginContext {
-  /** The full, resolved Boltdocs configuration (Readonly) */
-  readonly config: BoltdocsConfig;
-  /** A plugin-specific logger */
-  readonly logger: PluginLogger;
-  /** A shared store for dependency injection and state sharing between plugins */
-  readonly store: PluginStore;
-  /** Metadata about the current plugin */
-  readonly meta: PluginMeta;
-}
-/**
- * Simple logger interface for plugins.
- */
-interface PluginLogger {
-  info(message: string): void;
-  warn(message: string): void;
-  error(message: string | Error): void;
-  debug(message: string): void;
-}
-/**
- * A shared key-value store that allows plugins to share state and configuration.
- */
-interface PluginStore {
-  /** Get a value from the store. Keys are namespaced by plugin internally. */
-  get<T = unknown>(pluginName: string, key: string): T | undefined;
-  /** Set a value in the store. */
-  set(pluginName: string, key: string, value: unknown): void;
-  /** Check if a key exists in the store. */
-  has(pluginName: string, key: string): boolean;
-}
-/**
- * Metadata for a plugin, used for identification and compatibility checks.
- */
-interface PluginMeta {
-  /** Unique identifier for the plugin */
-  name: string;
-  /** Version of the plugin itself (semver) */
-  version?: string;
-  /** Minimum required version of Boltdocs (semver range) */
-  boltdocsVersion?: string;
-}
-/**
- * Lifecycle hooks that a plugin can implement to hook into the build and dev processes.
- */
-interface PluginLifecycleHooks {
-  /** Called before the build process starts */
-  beforeBuild?: (ctx: PluginContext) => Promise<void> | void;
-  /** Called after the build process finishes successfully */
-  afterBuild?: (ctx: PluginContext) => Promise<void> | void;
-  /** Called before the dev server starts */
-  beforeDev?: (ctx: PluginContext) => Promise<void> | void;
-  /** Called after the dev server is ready (configureServer) */
-  afterDev?: (ctx: PluginContext) => Promise<void> | void;
-  /** Called when the final Boltdocs config is resolved */
-  configResolved?: (ctx: PluginContext, config: BoltdocsConfig) => void;
-  /** Called when the build is closing */
-  buildEnd?: (ctx: PluginContext) => Promise<void> | void;
-}
-//#endregion
-//#region src/node/config.d.ts
+//#region src/shared/types.d.ts
 /**
  * Represents a single social link in the configuration.
  */
 interface BoltdocsSocialLink {
-  /** Identifier for the icon (e.g., 'github') */
   icon: 'discord' | 'x' | 'github' | 'bluesky' | string;
-  /** The URL the social link points to */
   link: string;
 }
 /**
  * Configuration for the site footer.
  */
 interface BoltdocsFooterConfig {
-  /** Text to display in the footer (HTML is supported) */
   text?: string;
 }
 /**
- * Theme-specific configuration options governing the appearance and navigation of the site.
+ * Theme-specific configuration options.
  */
 interface BoltdocsThemeConfig {
-  /** The global title of the documentation site (can be translated) */
   title?: string | Record<string, string>;
-  /** The global description of the site (can be translated) */
   description?: string | Record<string, string>;
-  /** URL path to the site logo or an object for light/dark versions */
   logo?: string | {
     dark: string;
     light: string;
@@ -112,188 +39,137 @@ interface BoltdocsThemeConfig {
     width?: number;
     height?: number;
   };
-  /** Items to display in the top navigation bar */
   navbar?: Array<{
-    /** Text to display (can be a string or a map of translations) */label: string | Record<string, string>; /** URL path or external link */
+    label: string | Record<string, string>;
     href: string;
   }>;
-  /** Items to display in the sidebar, organized optionally by group URLs */
   sidebar?: Record<string, Array<{
     text: string;
     link: string;
   }>>;
-  /** Social links to display in the navigation bar */
+  sidebarGroups?: Record<string, {
+    title?: string;
+    icon?: string;
+  }>;
   socialLinks?: BoltdocsSocialLink[];
-  /** Site footer configuration */
   footer?: BoltdocsFooterConfig;
-  /** Whether to show breadcrumbs navigation (default: true) */
   breadcrumbs?: boolean;
-  /** URL template for 'Edit this page'. Use :path as a placeholder. */
   editLink?: string;
-  /** URL for the 'Community help' link. */
   communityHelp?: string;
-  /** The current version of the project (e.g., 'v2.8.9'). Displayed in the Navbar. */
   version?: string;
-  /** The GitHub repository in the format 'owner/repo' to fetch and display star count. */
   githubRepo?: string;
-  /**
-   * URL path to the site favicon.
-   * If not specified, the logo will be used if available.
-   */
   favicon?: string;
-  /**
-   * The Open Graph image URL to display when the site is shared on social media.
-   */
-  ogImage?: string;
-  /** Whether to show the 'Powered by LiteDocs' badge in the sidebar (default: true) */
   poweredBy?: boolean;
-  /**
-   * Top-level tabs for organizing documentation groups.
-   * Tab discovery uses the (tab-id) directory syntax.
-   */
   tabs?: Array<{
-    id: string; /** Text to display (can be a string or a map of translations) */
+    id: string;
     text: string | Record<string, string>;
     icon?: string;
   }>;
-  /**
-   * The syntax highlighting theme for code blocks.
-   * Supports any Shiki theme name (e.g., 'github-dark', 'one-dark-pro', 'aurora-x').
-   * Can also be an object for multiple themes (e.g., { light: 'github-light', dark: 'github-dark' }).
-   * Default: { light: 'github-light', dark: 'one-dark-pro' }
-   */
-  codeTheme?: string | {
-    light: string;
-    dark: string;
+  codeTheme?: ShikiTheme | {
+    light: ShikiTheme;
+    dark: ShikiTheme;
   };
-  /**
-   * Configuration for the 'Copy Markdown' button.
-   * Can be a boolean or an object with text and icon.
-   * Default: true
-   */
   copyMarkdown?: boolean | {
     text?: string;
     icon?: string;
   };
 }
+/**
+ * List of supported syntax highlighting themes.
+ */
+type ShikiTheme = 'github-dark' | 'github-light' | 'tokyo-night' | 'dracula' | 'nord' | 'one-dark-pro' | 'one-light';
 /**
  * Configuration for the robots.txt file.
  */
 type BoltdocsRobotsConfig = string | {
-  /** User-agent rules */rules?: Array<{
-    userAgent: string; /** Paths allowed to be crawled */
-    allow?: string | string[]; /** Paths disallowed to be crawled */
+  rules?: Array<{
+    userAgent: string;
+    allow?: string | string[];
     disallow?: string | string[];
-  }>; /** Sitemaps to include in the robots.txt */
+  }>;
   sitemaps?: string[];
 };
 /**
  * Configuration for a specific locale.
  */
 interface BoltdocsLocaleConfig {
-  /** The display name of the locale */
   label?: string;
-  /** The text direction (ltr or rtl) */
   direction?: 'ltr' | 'rtl';
-  /** The HTML lang attribute value (e.g., 'en-US') */
   htmlLang?: string;
-  /** The calendar system to use (e.g., 'gregory') */
   calendar?: string;
 }
 /**
  * Configuration for internationalization (i18n).
  */
 interface BoltdocsI18nConfig {
-  /** The default locale (e.g., 'en') */
   defaultLocale: string;
-  /** Available locales and their basic display names (e.g., { en: 'English', es: 'Español' }) */
   locales: Record<string, string>;
-  /** Detailed configuration for each locale */
   localeConfigs?: Record<string, BoltdocsLocaleConfig>;
 }
 /**
  * Configuration for a specific documentation version.
  */
 interface BoltdocsVersionConfig {
-  /** The display name of the version (e.g., 'v2.0') */
   label: string;
-  /** The URL path prefix for the version (e.g., '2.0') */
   path: string;
 }
 /**
  * Configuration for documentation versioning.
  */
 interface BoltdocsVersionsConfig {
-  /** The default version path (e.g., 'v2') */
   defaultVersion: string;
-  /**
-   * Optional prefix for all version paths (e.g., 'v').
-   * If set to 'v', version '1.1' will be available at '/docs/v1.1'.
-   */
   prefix?: string;
-  /** Available versions configurations */
   versions: BoltdocsVersionConfig[];
 }
 /**
- * Defines a Boltdocs plugin that can extend the build process and client-side functionality.
+ * Defines a Boltdocs plugin.
  */
 interface BoltdocsPlugin {
-  /** A unique name for the plugin */
   name: string;
-  /** Whether to run this plugin before or after default ones (optional) */
   enforce?: 'pre' | 'post';
-  /** Version of the plugin (optional) */
   version?: string;
-  /** Minimum compatible Boltdocs version (optional, semver range) */
   boltdocsVersion?: string;
-  /** List of permissions this plugin requires to operate */
-  permissions?: PluginPermission[];
-  /** Optional remark plugins to add to the MDX pipeline */
+  permissions?: string[];
   remarkPlugins?: unknown[];
-  /** Optional rehype plugins to add to the MDX pipeline */
   rehypePlugins?: unknown[];
-  /** Optional Vite plugins to inject into the build process */
   vitePlugins?: Plugin[];
-  /** Optional custom React components to register in MDX. Map of Name -> Module Path. */
   components?: Record<string, string>;
-  /** Implementation of lifecycle hooks */
-  hooks?: PluginLifecycleHooks;
+  hooks?: Record<string, any>;
 }
 /**
  * Configuration for security-related settings.
  */
 interface BoltdocsSecurityConfig {
-  /** Map of standard security headers to override or supplement defaults */
   headers?: Record<string, string>;
-  /** Whether to enable Content Security Policy (CSP) generation (default: false) */
   enableCSP?: boolean;
-  /** Additional custom headers to inject into responses */
   customHeaders?: Record<string, string>;
 }
+/**
+ * Configuration for SEO.
+ */
+interface BoltdocsSeoConfig {
+  metatags?: Record<string, string>;
+  indexing?: 'all' | 'public';
+  thumbnails?: {
+    background?: string;
+  };
+}
 /**
  * The root configuration object for Boltdocs.
  */
-interface BoltdocsConfig {
-  /** The base URL of the site, used for generating the sitemap */
+interface BoltdocsConfig$1 {
   siteUrl?: string;
-  /** The root directory containing markdown documentation files (default: 'docs') */
   docsDir?: string;
-  /** Path to a custom HomePage component */
+  base?: string;
   homePage?: string;
-  /** Configuration pertaining to the UI and appearance */
   theme?: BoltdocsThemeConfig;
-  /** Configuration for internationalization */
   i18n?: BoltdocsI18nConfig;
-  /** Configuration for documentation versioning */
   versions?: BoltdocsVersionsConfig;
-  /** Custom plugins for extending functionality */
   plugins?: BoltdocsPlugin[];
-  /** Configuration for the robots.txt file */
   robots?: BoltdocsRobotsConfig;
-  /** Security-related settings and headers */
   security?: BoltdocsSecurityConfig;
-  /** Low-level Vite configuration overrides */
-  vite?: _$vite.InlineConfig;
+  seo?: BoltdocsSeoConfig;
+  vite?: any;
 }
 //#endregion
 //#region src/client/types.d.ts
@@ -341,49 +217,15 @@ interface ComponentRoute {
   };
   /** Optional icon for the route's group */
   groupIcon?: string;
+  /** The sub-route group this route belongs to (from folders starting with _) */
+  subRouteGroup?: string;
+  /** The nested sub-routes if this route acts as the parent of a subRouteGroup */
+  subRoutes?: ComponentRoute[];
   /** The extracted plain-text content of the page for search indexing */
   _content?: string;
   /** The raw markdown content of the page */
   _rawContent?: string;
 }
-/**
- * Site configuration provided by the server.
- */
-type SiteConfig = BoltdocsConfig;
-/**
- * Configuration options for initializing the Boltdocs client app.
- */
-interface CreateBoltdocsAppOptions {
-  /** CSS selector for the DOM element where the app should mount (e.g. '#root') */
-  target: string;
-  /** Initial routes generated by the Vite plugin (`virtual:boltdocs-routes`) */
-  routes: ComponentRoute[];
-  /** The name of the documentation directory (e.g. 'docs') */
-  docsDirName: string;
-  /** Site configuration (`virtual:boltdocs-config`) */
-  config: SiteConfig;
-  /** Dynamic import mapping from `import.meta.glob` for the documentation pages */
-  modules: Record<string, () => Promise<{
-    default: React$1.ComponentType<any>;
-  }>>;
-  /** The `import.meta.hot` instance necessary for fast refresh/HMR updates */
-  hot?: {
-    accept: (cb?: (mod: any) => void) => void;
-    dispose: (cb: (data: any) => void) => void;
-    on: (event: string, cb: (data: any) => void) => void;
-    data: any;
-  };
-  /** Optional custom React component to render when visiting the root path ('/') */
-  homePage?: React$1.ComponentType;
-  /** Custom external pages mapped by their route path */
-  externalPages?: Record<string, React$1.ComponentType>;
-  /** Optional custom layout for external pages */
-  externalLayout?: React$1.ComponentType<{
-    children: React$1.ReactNode;
-  }>;
-  /** Optional custom MDX components provided by plugins */
-  components?: Record<string, React$1.ComponentType>;
-}
 /**
  * Tab configuration for the documentation site.
  */
@@ -410,7 +252,7 @@ interface OnThisPageProps {
  * Props for user-defined layout components (layout.tsx).
  */
 interface LayoutProps {
-  children: React$1.ReactNode;
+  children: React.ReactNode;
 }
 /**
  * Unified type for navbar links.
@@ -424,41 +266,58 @@ interface NavbarLink {
   to?: string;
 }
 //#endregion
-//#region src/client/app/index.d.ts
+//#region src/client/ssg/create-routes.d.ts
+interface CreateRoutesOptions {
+  routesData: ComponentRoute[];
+  config: BoltdocsConfig$1;
+  mdxModules: Record<string, {
+    default?: React.ComponentType;
+  }>;
+  Layout: React.ComponentType<{
+    children: React.ReactNode;
+  }>;
+  homePage?: React.ComponentType;
+  externalPages?: Record<string, React.ComponentType>;
+  externalLayout?: React.ComponentType<{
+    children: React.ReactNode;
+  }>;
+  components?: Record<string, React.ComponentType>;
+}
+declare function createRoutes(options: CreateRoutesOptions): RouteRecord[];
+//#endregion
+//#region src/client/ssg/mdx-page.d.ts
 /**
- * Creates and mounts the Boltdocs documentation app.
- *
- * Usage:
- * ```tsx
- * import { createBoltdocsApp } from 'boltdocs/client'
- * import routes from 'virtual:boltdocs-routes'
- * import config from 'virtual:boltdocs-config'
- * import 'boltdocs/style.css'
- * import HomePage from './HomePage'
- *
- * createBoltdocsApp({
- *   target: '#root',
- *   routes,
- *   config,
- *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
- *   hot: import.meta.hot,
- *   homePage: HomePage,
- * })
- * ```
+ * Renders an MDX page by consuming pre-loaded module data.
+ * Uses DocPage to ensure consistent layout and metadata application.
  */
-declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
+declare function MdxPage({
+  MDXComponent: propMDX,
+  mdxComponents: propComponents
+}: any): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+//#region src/client/ssg/boltdocs-shell.d.ts
+declare function BoltdocsShell({
+  config,
+  routes,
+  components
+}: {
+  config: BoltdocsConfig$1;
+  routes: ComponentRoute[];
+  components?: Record<string, React.ComponentType>;
+}): _$react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/client/app/config-context.d.ts
 /**
  * Hook to access the Boltdocs configuration.
  */
-declare function useConfig(): BoltdocsConfig;
+declare function useConfig(): BoltdocsConfig$1;
 //#endregion
 //#region src/client/app/theme-context.d.ts
 type Theme = 'light' | 'dark' | 'system';
+type ResolvedTheme = 'light' | 'dark';
 interface ThemeContextType {
   theme: Theme;
-  resolvedTheme: 'light' | 'dark';
+  resolvedTheme: ResolvedTheme;
   setTheme: (theme: Theme) => void;
 }
 declare function useTheme(): ThemeContextType;
@@ -487,12 +346,11 @@ declare function useRoutes(): {
     label: string;
     isCurrent: boolean;
   }[];
-  config: BoltdocsConfig;
+  config: BoltdocsConfig$1;
 };
 //#endregion
 //#region src/client/app/mdx-components-context.d.ts
-type MdxComponentsType = Record<string, React.ComponentType<any>>;
-declare function useMdxComponents(): MdxComponentsType;
+declare function useMdxComponents(): any;
 //#endregion
 //#region src/client/hooks/use-navbar.d.ts
 declare function useNavbar(): {
@@ -506,22 +364,22 @@ declare function useNavbar(): {
   };
   github: string | null;
   social: BoltdocsSocialLink[];
-  config: BoltdocsConfig;
-  theme: "dark" | "light" | "system";
+  config: BoltdocsConfig$1;
+  theme: Theme;
 };
 //#endregion
 //#region src/client/hooks/use-sidebar.d.ts
 declare function useSidebar(routes: ComponentRoute[]): {
   groups: {
+    routes: ComponentRoute[];
     slug: string;
     title: string;
-    routes: ComponentRoute[];
     icon?: string;
   }[];
   ungrouped: ComponentRoute[];
   activeRoute: ComponentRoute | undefined;
   activePath: string;
-  config: BoltdocsConfig;
+  config: BoltdocsConfig$1;
 };
 //#endregion
 //#region src/client/hooks/use-search.d.ts
@@ -639,9 +497,9 @@ declare const useLocation: () => _$react_router_dom0.Location<any>;
  * Props shared by all layout slot components.
  */
 interface SlotProps {
-  children?: React$1.ReactNode;
+  children?: React.ReactNode;
   className?: string;
-  style?: React$1.CSSProperties;
+  style?: React.CSSProperties;
 }
 /**
  * Horizontal flex container for sidebar + content + toc.
@@ -683,7 +541,7 @@ declare function ContentFooter({
   className,
   style
 }: SlotProps): _$react_jsx_runtime0.JSX.Element;
-interface DocsLayoutComponent extends React$1.FC<SlotProps> {
+interface DocsLayoutComponent extends React.FC<SlotProps> {
   Body: typeof Body;
   Content: typeof Content;
   ContentMdx: typeof ContentMdx;
@@ -692,19 +550,6 @@ interface DocsLayoutComponent extends React$1.FC<SlotProps> {
 }
 declare const DocsLayout: DocsLayoutComponent;
 //#endregion
-//#region src/client/components/default-layout.d.ts
-interface LayoutProps$1 {
-  children: React.ReactNode;
-}
-/**
- * The built-in default layout for Boltdocs.
- * Users who create their own `layout.tsx` can import the same building blocks
- * and rearrange, wrap, or replace any section.
- */
-declare function DefaultLayout({
-  children
-}: LayoutProps$1): _$react_jsx_runtime0.JSX.Element;
-//#endregion
 //#region src/client/components/ui-base/navbar.d.ts
 declare function Navbar(): _$react_jsx_runtime0.JSX.Element;
 //#endregion
@@ -714,7 +559,7 @@ declare function Sidebar$1({
   config
 }: {
   routes: ComponentRoute[];
-  config: BoltdocsConfig;
+  config: BoltdocsConfig$1;
 }): _$react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/client/components/ui-base/on-this-page.d.ts
@@ -733,13 +578,14 @@ interface HeadProps {
     path: string;
     title: string;
     description?: string;
+    seo?: Record<string, any>;
   }>;
 }
 declare function Head({
   siteTitle,
   siteDescription,
   routes
-}: HeadProps): null;
+}: HeadProps): _$react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/client/components/ui-base/breadcrumbs.d.ts
 declare function Breadcrumbs(): _$react_jsx_runtime0.JSX.Element | null;
@@ -802,6 +648,7 @@ interface CodeBlockProps {
   lang?: string;
   highlightedHtml?: string;
   'data-lang'?: string;
+  'data-title'?: string;
   plain?: boolean;
   [key: string]: any;
 }
@@ -905,7 +752,7 @@ declare function Badge({
 //#endregion
 //#region src/client/components/mdx/card.d.ts
 declare const cardsVariants: (props?: ({
-  cols?: 2 | 1 | 3 | 4 | null | undefined;
+  cols?: 1 | 2 | 3 | 4 | null | undefined;
 } & _$class_variance_authority_types0.ClassProp) | undefined) => string;
 type CardsVariants = VariantProps<typeof cardsVariants>;
 interface CardsProps extends React.HTMLAttributes<HTMLDivElement>, CardsVariants {}
@@ -957,7 +804,7 @@ declare const Caution: (props: Omit<AdmonitionProps, "type">) => _$react_jsx_run
 //#region src/client/components/mdx/list.d.ts
 declare const listVariants: (props?: ({
   variant?: "number" | "default" | "checked" | "arrow" | "bubble" | null | undefined;
-  cols?: 2 | 1 | 3 | 4 | null | undefined;
+  cols?: 1 | 2 | 3 | 4 | null | undefined;
   isGrid?: boolean | null | undefined;
   dense?: boolean | null | undefined;
 } & _$class_variance_authority_types0.ClassProp) | undefined) => string;
@@ -1035,7 +882,7 @@ interface LinkProps$3 extends LinkProps$2 {
  * It uses the global navigation configuration from BoltdocsRouterProvider
  * to handle seamless client-side transitions.
  */
-declare const Link$1: React$1.ForwardRefExoticComponent<LinkProps$3 & React$1.RefAttributes<HTMLAnchorElement>>;
+declare const Link$1: _$react.ForwardRefExoticComponent<LinkProps$3 & _$react.RefAttributes<HTMLAnchorElement>>;
 /**
  * Props for the NavLink component, extending standard Link props.
  */
@@ -1048,9 +895,9 @@ interface NavLinkProps extends Omit<LinkProps$3, 'className' | 'children'> {
   /**
    * Provides access to the active state for conditional children rendering.
    */
-  children?: React$1.ReactNode | ((props: {
+  children?: React.ReactNode | ((props: {
     isActive: boolean;
-  }) => React$1.ReactNode);
+  }) => React.ReactNode);
   /**
    * Provides access to the active state for conditional styling.
    */
@@ -1064,7 +911,7 @@ interface NavLinkProps extends Omit<LinkProps$3, 'className' | 'children'> {
  * It combines the Link primitive with path matching logic to determine
  * if the link is currently active based on the browser's location.
  */
-declare const NavLink: React$1.ForwardRefExoticComponent<NavLinkProps & React$1.RefAttributes<HTMLAnchorElement>>;
+declare const NavLink: _$react.ForwardRefExoticComponent<NavLinkProps & _$react.RefAttributes<HTMLAnchorElement>>;
 //#endregion
 //#region src/client/components/mdx/link.d.ts
 type LinkProps = LinkProps$3 & {
@@ -1355,7 +1202,7 @@ interface ScrollProviderProps {
   children?: ReactNode;
 }
 interface OnThisPageContentProps extends ComponentBase {
-  ref?: React$1.Ref<HTMLDivElement>;
+  ref?: React.Ref<HTMLDivElement>;
   scrollRef?: RefObject<HTMLElement | null>;
 }
 interface OnThisPageItemProps extends ComponentBase {
@@ -1364,10 +1211,10 @@ interface OnThisPageItemProps extends ComponentBase {
 interface OnThisPageLinkProps extends ComponentBase {
   href?: string;
   active?: boolean;
-  onClick?: (event: React$1.MouseEvent<HTMLAnchorElement>) => void;
+  onClick?: (event: React.MouseEvent<HTMLAnchorElement>) => void;
 }
 interface OnThisPageIndicatorProps extends ComponentBase {
-  style?: React$1.CSSProperties;
+  style?: React.CSSProperties;
 }
 declare function useItems(): TOCItemInfo[];
 declare function useActiveAnchor(): string | undefined;
@@ -1497,8 +1344,11 @@ declare const Tabs: {
 interface SidebarGroupProps extends ComponentBase {
   title?: string;
   icon?: React.ElementType;
+}
+interface SidebarSubGroupProps extends SidebarLinkProps {
   isOpen?: boolean;
   onToggle?: () => void;
+  children?: React.ReactNode;
 }
 interface SidebarLinkProps extends ComponentBase {
   label: string;
@@ -1517,10 +1367,19 @@ declare const Sidebar: {
     children,
     title,
     icon: Icon,
-    isOpen,
-    onToggle,
     className
   }: SidebarGroupProps) => _$react_jsx_runtime0.JSX.Element;
+  SubGroup: ({
+    label,
+    href,
+    active,
+    icon: Icon,
+    badge,
+    className,
+    isOpen,
+    onToggle,
+    children
+  }: SidebarSubGroupProps) => _$react_jsx_runtime0.JSX.Element;
   GroupItem: ({
     children,
     className
@@ -1675,4 +1534,15 @@ declare function Skeleton({
 //#region src/client/utils/cn.d.ts
 declare function cn(...inputs: ClassValue[]): string;
 //#endregion
-export { Admonition, type AdmonitionProps, AnchorProvider, Badge, type BadgeProps, type BoltdocsConfig, type BoltdocsThemeConfig, Breadcrumbs, Button, ButtonGroup, type ButtonProps, Card, type CardProps, Cards, type CardsProps, Caution, CodeBlock, ComponentPreview, type ComponentPreviewProps, ComponentProps, type ComponentPropsProps, type ComponentRoute, CopyMarkdown, type CreateBoltdocsAppOptions, Danger, DefaultLayout, DocsLayout, ErrorBoundary, Field, type FieldProps, FileTree, type FileTreeProps, Head, Image, type ImageProps, Important, InfoBox, type LayoutProps, Link, type LinkProps, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, PageNav, Breadcrumbs$1 as PrimitiveBreadcrumbs, Button$1 as PrimitiveButton, Link$1 as PrimitiveLink, Menu as PrimitiveMenu, NavLink as PrimitiveNavLink, Navbar$1 as PrimitiveNavbar, NavigationMenu as PrimitiveNavigationMenu, OnThisPage$1 as PrimitiveOnThisPage, PageNav$1 as PrimitivePageNav, Popover as PrimitivePopover, Sidebar as PrimitiveSidebar, Skeleton as PrimitiveSkeleton, Tabs as PrimitiveTabs, Tooltip as PrimitiveTooltip, ScrollProvider, SearchDialog as SearchDialogPrimitive, Sidebar$1 as Sidebar, Tab, type TabProps, Table, type TableProps, Tabs$1 as Tabs, type TabsProps, Tip, Video, Warning, cn, createBoltdocsApp, useActiveAnchor, useActiveAnchors, useBreadcrumbs, useConfig, useI18n, useItems, useLocalizedTo, useLocation, useMdxComponents, useNavbar, useOnThisPage, usePageNav, useRoutes, useSearch, useSidebar, useTabs, useTheme, useVersion };
+//#region src/client/utils/i18n.d.ts
+/**
+ * Retrieves the correct translation from a value that can be either
+ * a simple string or a map of locale-specific strings.
+ *
+ * @param value - The text to translate
+ * @param locale - The current active locale (e.g., 'en', 'es')
+ * @returns The translated string
+ */
+declare function getTranslated(value: string | Record<string, string> | undefined, locale?: string): string;
+//#endregion
+export { Admonition, type AdmonitionProps, AnchorProvider, Badge, type BadgeProps, BoltdocsShell, Breadcrumbs, Button, ButtonGroup, type ButtonProps, Card, type CardProps, Cards, type CardsProps, Caution, CodeBlock, ComponentPreview, type ComponentPreviewProps, ComponentProps, type ComponentPropsProps, type ComponentRoute, CopyMarkdown, Danger, DocsLayout, ErrorBoundary, Field, type FieldProps, FileTree, type FileTreeProps, Head, Image, type ImageProps, Important, InfoBox, type LayoutProps, Link, type LinkProps, List, type ListProps, Loading, MdxPage, Navbar, NotFound, Note, OnThisPage, PageNav, Breadcrumbs$1 as PrimitiveBreadcrumbs, Button$1 as PrimitiveButton, Link$1 as PrimitiveLink, Menu as PrimitiveMenu, NavLink as PrimitiveNavLink, Navbar$1 as PrimitiveNavbar, NavigationMenu as PrimitiveNavigationMenu, OnThisPage$1 as PrimitiveOnThisPage, PageNav$1 as PrimitivePageNav, Popover as PrimitivePopover, Sidebar as PrimitiveSidebar, Skeleton as PrimitiveSkeleton, Tabs as PrimitiveTabs, Tooltip as PrimitiveTooltip, ScrollProvider, SearchDialog as SearchDialogPrimitive, Sidebar$1 as Sidebar, Tab, type TabProps, Table, type TableProps, Tabs$1 as Tabs, type TabsProps, Tip, Video, Warning, cn, createRoutes, getTranslated, useActiveAnchor, useActiveAnchors, useBreadcrumbs, useConfig, useI18n, useItems, useLocalizedTo, useLocation, useMdxComponents, useNavbar, useOnThisPage, usePageNav, useRoutes, useSearch, useSidebar, useTabs, useTheme, useVersion };