boltdocs 3.2.2 → 3.3.0

package/dist/{sidebar-CrEdJuHX.d.cts → index-Ci4kfOHF.d.ts}

@@ -1,9 +1,8 @@
 
-import * as React$2 from "react";
-import { ComponentType, ReactNode } from "react";
+import * as _$react from "react";
+import React$1, { ComponentType, ReactNode } from "react";
 import * as _$http from "http";
-import { Plugin } from "vite";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { AliasOptions, Plugin, UserConfig } from "vite";
 
 //#region src/shared/types.d.ts
 /**
@@ -68,7 +67,7 @@ interface RouteMeta {
   /** The raw markdown content of the page */
   _rawContent?: string;
   /** Extracted SEO and Open Graph metadata from frontmatter */
-  seo?: Record<string, any>;
+  seo?: Record<string, unknown>;
   /** The publication date */
   date?: string | Date;
   /** The last updated timestamp or date */
@@ -82,7 +81,7 @@ interface RouteMeta {
   /** Whether the page is hidden from the sidebar */
   sidebarHidden?: boolean;
   /** Raw extensible frontmatter data for custom components and formatters */
-  frontmatter?: Record<string, any>;
+  frontmatter?: Record<string, unknown>;
   /** Optional recursive child routes for deep sidebar hierarchies */
   subRoutes?: RouteMeta[];
   /** Clean URL segments stripped of locale/version prefixes */
@@ -538,15 +537,98 @@ interface PluginServerAPI {
  * Connect-style middleware signature.
  */
 type PluginServerMiddleware = (req: _$http.IncomingMessage, res: _$http.ServerResponse, next: (err?: unknown) => void) => void | Promise<void>;
+/**
+ * Standardized Search Document contract passed to search plugins.
+ */
+interface SearchDocument {
+  id: string;
+  path: string;
+  title: string;
+  content: string;
+  headings: Array<{
+    level: number;
+    text: string;
+    id: string;
+  }>;
+  frontmatter: Record<string, unknown>;
+  locale?: string;
+  version?: string;
+}
+interface PluginHeadEntry {
+  tag: 'script' | 'link' | 'meta' | 'style';
+  attrs?: Record<string, string | boolean>;
+  content?: string;
+}
+/**
+ * Client-side configuration and UI slot injections for plugins.
+ */
+interface PluginClientConfig {
+  /** Dynamic UI slot registrations (mapped to component file paths) */
+  slots?: Record<string, string>;
+  /** Top-level React provider component file paths */
+  providers?: string[];
+  /** MDX component overrides & additions */
+  mdxComponents?: Record<string, string>;
+  /** Head elements to inject into rendered HTML */
+  head?: PluginHeadEntry[];
+}
 /**
  * Plugin lifecycle hooks with full type safety.
  */
 interface PluginLifecycleHooks {
+  /** Build hooks (Astro-style) */
+  'build:before'?: (ctx: PluginContext) => Promise<void> | void;
+  'build:after'?: (ctx: PluginContext) => Promise<void> | void;
+  'build:end'?: (ctx: PluginContext) => Promise<void> | void;
+  'build:generate'?: (ctx: PluginContext, params: {
+    routes: RouteMeta[];
+    outDir: string;
+    siteUrl?: string;
+  }) => void | Promise<void>;
+  /** Dev hooks (Astro-style) */
+  'dev:before'?: (ctx: PluginContext) => Promise<void> | void;
+  'dev:after'?: (ctx: PluginContext) => Promise<void> | void;
+  /** Transform hooks (Astro-style) */
+  'transform:source'?: (ctx: PluginContext, params: TransformSourceParams) => TransformResult<{
+    code: string;
+  }> | Promise<TransformResult<{
+    code: string;
+  }>>;
+  'transform:mdx'?: (ctx: PluginContext, params: TransformSourceParams) => TransformResult<{
+    code: string;
+  }> | Promise<TransformResult<{
+    code: string;
+  }>>;
+  'transform:html'?: (ctx: PluginContext, params: TransformHtmlParams) => TransformResult<{
+    html: string;
+  }> | Promise<TransformResult<{
+    html: string;
+  }>>;
+  /** Dynamic frontmatter transformation hook */
+  'frontmatter:transform'?: (ctx: PluginContext, params: {
+    frontmatter: Record<string, unknown>;
+    filePath: string;
+    rawContent: string;
+  }) => Record<string, unknown> | Promise<Record<string, unknown>> | undefined;
+  /** Fired after routes are crawled, normalized, and resolved */
+  'routes:resolved'?: (ctx: PluginContext, params: {
+    routes: RouteMeta[];
+  }) => RouteMeta[] | Promise<RouteMeta[]> | undefined;
+  /** Agnostic search index hook: core passes SearchDocument[], plugin returns index payload */
+  'search:index'?: (ctx: PluginContext, params: {
+    documents: SearchDocument[];
+    routes: RouteMeta[];
+  }) => unknown | Promise<unknown>;
+  'server:configure'?: (ctx: PluginContext, params: {
+    server: unknown;
+    middleware: PluginServerAPI;
+  }) => void | Promise<void>;
+  /** Legacy alias hooks for backwards compatibility */
   beforeBuild?: (ctx: PluginContext) => Promise<void> | void;
   afterBuild?: (ctx: PluginContext) => Promise<void> | void;
+  buildEnd?: (ctx: PluginContext) => Promise<void> | void;
   beforeDev?: (ctx: PluginContext) => Promise<void> | void;
   afterDev?: (ctx: PluginContext) => Promise<void> | void;
-  buildEnd?: (ctx: PluginContext) => Promise<void> | void;
   transformSource?: (ctx: PluginContext, params: TransformSourceParams) => TransformResult<{
     code: string;
   }> | Promise<TransformResult<{
@@ -568,14 +650,20 @@ interface PluginLifecycleHooks {
  * When `processor` is set to 'satteri', the Sätteri Rust-based compiler is used.
  */
 interface BoltdocsMdxConfig {
-  processor?: 'unified' | 'satteri';
+  processor?: 'satteri';
 }
 /**
  * Defines a Boltdocs plugin.
  *
- * Use the `createPlugin()` helper from the node API for full type safety and
- * access to lifecycle hooks.
- */
+ * Use the `definePlugin()` or `createPlugin()` helper from the node API for full
+ * type safety and access to lifecycle hooks.
+ */
+interface PluginCssConfig {
+  cssFiles?: string[];
+  headStyles?: string[];
+  postcssPlugins?: unknown[];
+  preprocessorOptions?: Record<string, unknown>;
+}
 interface BoltdocsPlugin {
   name: string;
   enforce?: 'pre' | 'post';
@@ -585,11 +673,10 @@ interface BoltdocsPlugin {
   rehypePlugins?: unknown[];
   vitePlugins?: Plugin[];
   components?: Record<string, string>;
-  /** Optional runtime metadata exposed to client via useConfig().plugins[].metadata */
+  client?: PluginClientConfig;
   metadata?: Record<string, unknown>;
-  /** Declarative transform middleware entries. */
+  css?: PluginCssConfig;
   middleware?: PluginTransformMiddleware[];
-  /** Lifecycle hooks with full type safety */
   hooks?: PluginLifecycleHooks;
 }
 /**
@@ -613,6 +700,12 @@ interface BoltdocsVerificationConfig {
 /**
  * Configuration for SEO.
  */
+type JsonLdPrimitive = string | number | boolean | null;
+type JsonLdValue = JsonLdPrimitive | JsonLdObject | JsonLdValue[];
+interface JsonLdObject {
+  [key: string]: JsonLdValue | undefined;
+}
+type StructuredData = JsonLdObject | JsonLdObject[];
 interface BoltdocsSeoConfig {
   metatags?: Record<string, string>;
   indexing?: 'all' | 'public';
@@ -620,6 +713,20 @@ interface BoltdocsSeoConfig {
     background?: string;
   };
   verification?: BoltdocsVerificationConfig;
+  /** Global JSON-LD graph emitted in every page head. */
+  structuredData?: StructuredData;
+}
+interface BoltdocsViewTransitionsConfig {
+  /** Native document transitions are enabled when true. */
+  enabled?: boolean;
+  /** Optional transition types passed to `document.startViewTransition`. */
+  types?: string[];
+}
+interface BoltdocsExperimentalConfig {
+  /** Enables the native View Transition API integration. */
+  viewTransitions?: boolean | BoltdocsViewTransitionsConfig;
+  /** Enables static file-routing under `docs/pages-external/`. */
+  fileRouting?: boolean;
 }
 /**
  * Configuration for Google Analytics 4 (GA4).
@@ -708,6 +815,13 @@ interface BoltdocsIntegrationsConfig {
     custom?: BoltdocsCustomFeedbackConfig;
   };
 }
+/**
+ * Configuration for static site generation.
+ */
+interface BoltdocsSsgConfig {
+  /** Critical CSS strategy; `none` disables critical CSS processing. */
+  criticalCss?: 'zig-critters' | 'beasties' | 'none';
+}
 /**
  * Configuration for drafts visibility control.
  */
@@ -728,6 +842,7 @@ interface BoltdocsConfig {
   i18n?: BoltdocsI18nConfig;
   versions?: BoltdocsVersionsConfig;
   mdx?: BoltdocsMdxConfig;
+  ssg?: BoltdocsSsgConfig;
   plugins?: BoltdocsPlugin[];
   collections?: BoltdocsCollectionsConfig;
   robots?: BoltdocsRobotsConfig;
@@ -736,8 +851,10 @@ interface BoltdocsConfig {
   integrations?: BoltdocsIntegrationsConfig;
   drafts?: BoltdocsDraftsConfig;
   featureFlags?: Record<string, boolean | string>;
+  experimental?: BoltdocsExperimentalConfig;
   directoryMeta?: Record<string, unknown>;
-  vite?: unknown;
+  aliases?: AliasOptions;
+  vite?: UserConfig;
 }
 /**
  * Global namespace for Boltdocs types that can be augmented by generated code.
@@ -756,7 +873,8 @@ declare global {
 }
 type BoltdocsTypes = Boltdocs.Types;
 type BoltdocsRoutePath = keyof Boltdocs.RoutePaths;
-type BoltdocsRoutePathWithFallback = BoltdocsRoutePath extends never ? string : BoltdocsRoutePath;
+type ExternalRouteReference = `/${string}` | `#${string}` | `?${string}` | `site:/${string}` | `site:${string}` | `http://${string}` | `https://${string}` | `//${string}`;
+type BoltdocsRoutePathWithFallback = BoltdocsRoutePath | ExternalRouteReference | string;
 type BoltdocsLocale = Boltdocs.Types extends {
   Locale: infer L;
 } ? L : string;
@@ -771,330 +889,229 @@ type TransformMdxComponents<T> = { [K in keyof T as K extends `Frontmatter_${str
 };
 type BoltdocsMdxComponents = Boltdocs.Types extends {
   MdxComponents: infer M;
-} ? TransformMdxComponents<UnpackMdxComponents<M>> : Omit<Record<string, ComponentType<any>>, 'Frontmatter'> & {
-  Frontmatter: Record<string, ComponentType<any>>;
+} ? TransformMdxComponents<UnpackMdxComponents<M>> : Omit<Record<string, ComponentType<unknown>>, 'Frontmatter'> & {
+  Frontmatter: Record<string, ComponentType<unknown>>;
 };
 //#endregion
-//#region src/client/types.d.ts
-/**
- * Metadata provided by the server for a specific route.
- * Maps closely to the `RouteMeta` type in the Node environment.
- */
-interface ComponentRoute {
-  /** The final URL path */
-  path: string;
-  /** The absolute filesystem path of the source file */
-  componentPath: string;
-  /** The page title */
-  title: string;
-  /** Explicit order in the sidebar */
-  sidebarPosition?: number;
-  /** The relative path from the docs directory */
-  filePath: string;
-  /** The group directory name */
-  group?: string;
-  /** The display title of the group */
-  groupTitle?: string;
-  /** Explicit order of the group in the sidebar */
-  groupPosition?: number;
-  /** Extracted markdown headings for search indexing */
-  headings?: {
-    level: number;
-    text: string;
-    id: string;
-  }[];
-  /** The page summary or description */
-  description?: string;
-  /** The locale this route belongs to, if i18n is configured */
-  locale?: string;
-  /** The version this route belongs to, if versioning is configured */
-  version?: string;
-  /** Optional icon to display (Lucide icon name or raw SVG) */
-  icon?: string;
-  /** The tab this route belongs to, if tabs are configured */
-  tab?: string;
-  /** Optional badge to display next to the sidebar item */
-  badge?: BadgeValue;
-  /** 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[];
-  /** Internal helper map for nesting routes during sidebar construction */
-  _subMap?: Map<string, ComponentRoute>;
-  /** The extracted plain-text content of the page for search indexing */
-  _content?: string;
-  /** The raw markdown content of the page */
-  _rawContent?: string;
-  /** The publication date */
-  date?: string | Date;
-  /** The last updated timestamp or date */
-  lastUpdated?: string | number | Date;
-  /** The collection this route belongs to (from [name] directories) */
-  collection?: string;
-  /** Tags for blog posts */
-  tags?: string[];
-  /** Author identifier for blog posts */
-  author?: string | {
-    name: string;
-    avatar?: string;
-    url?: string;
-    image?: string;
-  };
-  /** Draft flag */
-  draft?: boolean;
-  /** Feature flags required for this page to be visible */
-  featureFlags?: string[];
-  /** Short excerpt for list displays */
-  excerpt?: string;
-  /** Cover image for blog posts */
-  coverImage?: string;
-  /** Optional explicit order (alternative to sidebarPosition) */
-  order?: number;
-  /** Optional explicit label for the sidebar */
-  sidebarLabel?: string;
-  /** Optional category for the page */
-  category?: string;
-  /** Whether the page is hidden from the sidebar */
-  sidebarHidden?: boolean;
-  /**
-   * Optional nested child routes for sidebar hierarchies that mirror the
-   * server-side `RouteMeta.subRoutes` shape. `sidebar.tsx` walks this
-   * field to render the group → subRoutes → items tree.
-   */
-  routes?: ComponentRoute[];
-  /** Raw extensible frontmatter data for custom components and formatters */
-  frontmatter?: Record<string, unknown>;
-  /** Clean URL segments stripped of locale/version prefixes */
-  slugParts?: string[];
-  /** SEO metadata for page headers */
-  seo?: Record<string, unknown>;
-  /** Flag to indicate if this is a fallback redirect route */
-  fallback?: boolean;
+//#region src/client/router/types.d.ts
+interface LoaderFunctionArgs {
+  request: Request;
+  params: Record<string, string>;
 }
-/**
- * Site configuration provided by the server.
- */
-type SiteConfig = BoltdocsConfig;
-/**
- * Tab configuration for the documentation site.
- */
-interface BoltdocsTab {
-  id: string;
-  /** Text to display (can be a string or a map of translations) */
-  text: string | Record<string, string>;
-  icon?: string;
+type LoaderFunction<T = unknown> = (args: LoaderFunctionArgs) => Promise<T> | T;
+type PrefetchFunction$1 = (to: string) => Promise<void>;
+interface RouteMatch {
+  route: RouteRecord;
+  params: Record<string, string>;
+  pathname: string;
+  pathnameBase: string;
+  data?: Record<string, unknown>;
 }
-/**
- * Props for the Sidebar component.
- */
-interface SidebarProps {
-  routes: ComponentRoute[];
-  config: BoltdocsConfig;
+interface LazyRouteResult {
+  Component?: ComponentType<any>;
+  element?: ReactNode;
+  loader?: LoaderFunction;
+  ErrorBoundary?: ComponentType<any>;
 }
-/**
- * Props for the OnThisPage (TOC) component.
- */
-interface OnThisPageProps {
-  headings?: {
-    level: number;
-    text: string;
-    id: string;
-  }[];
-  editLink?: string;
-  communityHelp?: string;
-  filePath?: string;
+/** Structurally compatible with react-router-dom's route objects */
+interface RouteRecord {
+  path?: string;
+  index?: boolean;
+  id?: string;
+  element?: ReactNode;
+  Component?: ComponentType<any>;
+  loader?: LoaderFunction;
+  action?: (...args: any[]) => any;
+  ErrorBoundary?: ComponentType<any>;
+  hasErrorBoundary?: boolean;
+  HydrateFallback?: ComponentType<any>;
+  children?: RouteRecord[];
+  lazy?: () => Promise<LazyRouteResult>;
+  caseSensitive?: boolean;
+  shouldRevalidate?: (...args: any[]) => boolean;
+  getStaticPaths?: () => string[] | Promise<string[]>;
+  entry?: string;
+  /** Locale this route belongs to (used by i18n fallbacks) */
+  locale?: string;
 }
-/**
- * Props for the Tabs component.
- */
-interface TabsProps {
-  tabs: BoltdocsTab[];
-  routes: ComponentRoute[];
+interface RouterOptions {
+  routes: RouteRecord[];
+  basename?: string;
+  future?: Record<string, boolean>;
 }
-/**
- * Props for user-defined layout components (layout.tsx).
- */
-interface LayoutProps {
-  children: React$2.ReactNode;
+interface RouteRendererProps {
+  routes: RouteRecord[];
+  pathname?: string;
+  loaderData?: Record<string, unknown> | null;
+  /** Whether loaderData was explicitly produced for the initial SSR route. */
+  hasLoaderData?: boolean;
+  /** Resolved branch supplied by SSR so lazy MDX routes render without effects. */
+  resolvedBranch?: RouteRecord[];
+  basename?: string;
+  /** Default locale is omitted from external URLs. */
+  defaultLocale?: string;
+  /** Optional route prefetcher used by Link hover/focus interactions. */
+  prefetch?: PrefetchFunction$1;
+  /** Enables native View Transitions for route updates. */
+  viewTransitions?: boolean | {
+    enabled?: boolean;
+    types?: string[];
+  };
 }
-/**
- * Unified type for navbar links.
- */
-interface NavbarLink {
-  label: string | Record<string, string>;
-  href: BoltdocsRoutePathWithFallback;
-  active: boolean;
-  to?: string;
-  items?: NavbarLink[];
+interface CreateRoutesResult {
+  routes: RouteRecord[];
+  RouteRenderer: ComponentType<RouteRendererProps>;
+  matchRouteBranch: (routes: RouteRecord[], pathname: string) => RouteRecord[];
+  matchRouteBranchWithParams: (routes: RouteRecord[], pathname: string, basename?: string) => Array<{
+    route: RouteRecord;
+    params: Record<string, string>;
+  }>;
+  resolveRouteBranch: (branch: RouteRecord[]) => Promise<RouteRecord[]>;
 }
-/**
- * Shape of the data returned by a collection post route loader.
- * Consumed by `BlogPost` via `useLoaderData<CollectionPostLoaderData>()`.
- */
-interface CollectionPostLoaderData {
-  /** Full route metadata for this post (title, date, author, tags, etc.) */
-  route: ComponentRoute;
-  /** The name of the collection this post belongs to (e.g. 'blog') */
-  collection: string;
-  /** Extracted page headings for the Table of Contents */
-  headings: {
-    level: number;
-    text: string;
-    id: string;
-  }[];
+//#endregion
+//#region src/client/router/context.d.ts
+interface LocationState {
+  pathname: string;
+  search: string;
+  hash: string;
 }
-/**
- * Shape of the data returned by a collection listing route loader.
- * Consumed by `BlogList` via `useLoaderData<CollectionListLoaderData>()`.
- */
-interface CollectionListLoaderData {
-  /** Paginated subset of posts to display on this page */
-  posts: Array<{
-    path: string;
-    title: string;
-    date?: string | Date;
-    excerpt?: string;
-    tags?: string[];
-    author?: string;
-    coverImage?: string;
-    filePath: string;
-  }>;
-  /** Total number of pages available */
-  totalPages: number;
-  /** Current page index (1-based) */
-  currentPage: number;
-  /** Collection name used to build pagination URLs (e.g. 'blog' → '/blog/page/2') */
-  collection: string;
+type PrefetchFunction = (to: string) => Promise<void>;
+type NavigateFunction = (to: string, options?: {
+  replace?: boolean;
+  state?: unknown; /** Disable the router transition when an outer transition owns the update. */
+  viewTransition?: boolean;
+}) => void;
+declare const defaultNavigate: NavigateFunction;
+declare const LocationContext: _$react.Context<LocationState>;
+declare const NavigateContext: _$react.Context<NavigateFunction>;
+declare const PrefetchContext: _$react.Context<PrefetchFunction>;
+declare const RouteDataContext: _$react.Context<Record<string, unknown> | null>;
+declare const MatchesContext: _$react.Context<RouteMatch[]>;
+interface LocationProviderProps {
+  pathname?: string;
+  children: React.ReactNode;
+  loaderData?: Record<string, unknown> | null;
+  matches?: RouteMatch[];
+  /** Base path of the application. Only links under this path are handled as SPA navigation. */
+  basename?: string;
+  /** Default locale is omitted from external URLs. */
+  defaultLocale?: string;
+  /** Optional route prefetcher used by Link hover/focus interactions. */
+  prefetch?: PrefetchFunction;
+  /** Enables the native View Transition API for route updates. */
+  viewTransitions?: boolean | {
+    enabled?: boolean;
+    types?: string[];
+  };
 }
+declare const LocationProvider: React.FC<LocationProviderProps>;
 //#endregion
-//#region src/client/components/primitives/types.d.ts
-type ComponentBase = {
-  className?: string;
-  children?: ReactNode;
-};
+//#region src/client/router/hooks.d.ts
+declare function useLocation(): LocationState;
+declare function useNavigate(): NavigateFunction;
+declare function usePrefetch(): (to: string) => Promise<void>;
+declare function useRouteData<T = Record<string, unknown>>(): T;
+/** Alias for useRouteData — parity with react-router-dom's useLoaderData */
+declare function useLoaderData<T = Record<string, unknown>>(): T;
+declare function useMatches(): RouteMatch[];
 //#endregion
-//#region src/client/components/primitives/sidebar.d.ts
-/**
- * Desktop Sidebar Container
- */
-declare function SidebarRoot({
-  children,
-  className
-}: ComponentBase): _$react_jsx_runtime0.JSX.Element;
-/**
- * Mobile Sidebar Modal
- */
-declare function SidebarMobile({
-  children,
-  className
-}: ComponentBase): _$react_jsx_runtime0.JSX.Element;
-/**
- * Shared Header for Sidebar
- */
-declare function SidebarHeader({
-  children,
-  className
-}: ComponentBase): _$react_jsx_runtime0.JSX.Element;
-/**
- * Scrollable Content Wrapper
- */
-declare function SidebarContent({
-  children,
-  className
-}: ComponentBase): _$react_jsx_runtime0.JSX.Element;
-/**
- * Navigation Group
- */
-declare function SidebarGroup({
-  title,
-  icon: Icon,
-  children,
-  className,
-  collapsible,
-  collapsed,
-  active
-}: {
-  title?: string;
-  icon?: React.ElementType;
-  collapsible?: boolean;
-  collapsed?: boolean;
-  active?: boolean;
-} & ComponentBase): _$react_jsx_runtime0.JSX.Element;
-/**
- * Sidebar Link
- */
-interface SidebarLinkProps extends ComponentBase {
-  label: string;
-  href: BoltdocsRoutePathWithFallback;
-  active?: boolean;
-  icon?: React.ElementType;
-  badge?: ComponentRoute['badge'];
-}
-declare function SidebarLink({
-  label,
-  href,
-  active,
-  icon: Icon,
-  badge,
-  className
-}: SidebarLinkProps): _$react_jsx_runtime0.JSX.Element;
-/**
- * Nested SubGroup
- */
-declare function SidebarSubGroup({
-  label,
-  href,
-  active,
-  icon: Icon,
-  badge,
-  isOpen,
-  onToggle,
-  children,
-  className
-}: SidebarLinkProps & {
-  isOpen: boolean;
-  onToggle: () => void;
-  children: ReactNode;
-}): _$react_jsx_runtime0.JSX.Element;
-/**
- * Automated single-route rendering primitive
- */
-interface SidebarItemProps extends ComponentBase {
-  route: ComponentRoute;
-  activePath: string;
-  activeRoute?: ComponentRoute;
-}
-declare function SidebarItem({
-  route,
-  activePath,
-  activeRoute,
-  className
-}: SidebarItemProps): _$react_jsx_runtime0.JSX.Element;
-/**
- * High-level automated routes data rendering primitive
- */
-interface SidebarItemsProps extends ComponentBase {
-  routes: ComponentRoute[];
+//#region src/client/router/outlet.d.ts
+declare const OutletContext: _$react.Context<_$react.ReactNode>;
+declare const Outlet: React.FC;
+//#endregion
+//#region src/client/router/renderer.d.ts
+interface RouteBranchMatch {
+  route: RouteRecord;
+  params: Record<string, string>;
 }
-declare function SidebarItems({
-  routes,
-  className
-}: SidebarItemsProps): _$react_jsx_runtime0.JSX.Element;
-/**
- * Main Sidebar Export
- */
-declare const Sidebar: typeof SidebarRoot & {
-  Root: typeof SidebarRoot;
-  Mobile: typeof SidebarMobile;
-  Header: typeof SidebarHeader;
-  Content: typeof SidebarContent;
-  Group: typeof SidebarGroup;
-  Link: typeof SidebarLink;
-  SubGroup: typeof SidebarSubGroup;
-  Item: typeof SidebarItem;
-  Items: typeof SidebarItems;
+declare function matchRouteBranchWithParams(routes: RouteRecord[], pathname: string, basename?: string): RouteBranchMatch[];
+declare function matchRouteBranch(routes: RouteRecord[], pathname: string, basename?: string): RouteRecord[];
+declare function resolveRouteBranch(branch: RouteRecord[]): Promise<RouteRecord[]>;
+declare const RouteRenderer: React$1.FC<RouteRendererProps>;
+//#endregion
+//#region src/client/router/utils.d.ts
+declare function normalizeBasename(basename?: string): string;
+declare function hasBasename(path: string, basename: string): boolean;
+declare function stripBasename(path: string, basename: string): string;
+declare function addBasename(path: string, basename: string): string;
+//#endregion
+//#region src/client/router/url-contract.d.ts
+type UrlRouteKind = 'doc' | 'external' | 'collection';
+interface UrlContractConfig {
+  base?: string;
+  i18n?: Pick<BoltdocsI18nConfig, 'defaultLocale' | 'locales'>;
+  versions?: Pick<BoltdocsVersionsConfig, 'defaultVersion' | 'prefix' | 'versions'>;
+  collections?: readonly string[] | BoltdocsCollectionsConfig;
+}
+interface UrlRouteHint {
+  path: string;
+  kind?: UrlRouteKind;
+  collection?: string;
+}
+interface ParsedUrl {
+  /** The normalized pathname, without query string or hash. */
+  pathname: string;
+  /** The normalized route content after removing structural prefixes. */
+  routePath: string;
+  /** Query string including `?`, when present. */
+  search: string;
+  /** Hash including `#`, when present. */
+  hash: string;
+  kind: UrlRouteKind;
+  locale?: string;
+  version?: string;
+  collection?: string;
+  /** Whether the input used the explicit `site:` protocol. */
+  siteProtocol: boolean;
+  /** Whether the input pathname contained the configured documentation base. */
+  hadBase: boolean;
+}
+interface BuildUrlOptions {
+  kind: UrlRouteKind;
+  /** Route content, e.g. `/guides/start`, `/about`, or `/my-post`. */
+  path?: string;
+  locale?: string;
+  version?: string;
+  collection?: string;
+  search?: string;
+  hash?: string;
+  /** The input pathname already contained the configured base. */
+  hadBase?: boolean;
+}
+interface ResolveUrlOptions {
+  /** Explicitly choose the route family when the path is ambiguous. */
+  kind?: UrlRouteKind;
+  /** Known route metadata used to classify paths outside `base`. */
+  routes?: readonly UrlRouteHint[];
+  /** Locale/version to apply when building a canonical target. */
+  locale?: string;
+  version?: string;
+}
+declare function normalizeUrlBase(base?: string): string;
+declare function normalizeUrlPath(path: string): string;
+declare function hasUrlBase(pathname: string, base?: string): boolean;
+declare function stripUrlBase(pathname: string, base?: string): string;
+declare function addUrlBase(pathname: string, base?: string): string;
+declare function getConfiguredLocales(config: UrlContractConfig): string[];
+declare function getConfiguredVersions(config: UrlContractConfig): string[];
+declare function getVersionPrefixSegments(config: UrlContractConfig): string[];
+declare function getVersionSegments(version: string | undefined, config: UrlContractConfig): string[];
+declare function isConfiguredLocale(value: string | undefined, config: UrlContractConfig): value is string;
+declare function isConfiguredVersion(value: string | undefined, config: UrlContractConfig): value is string;
+declare function splitUrlReference(to: string): {
+  pathname: string;
+  search: string;
+  hash: string;
+};
+declare function stripSiteProtocol(to: string): {
+  value: string;
+  siteProtocol: boolean;
 };
+/** Returns true for URI schemes such as `mailto:`, `tel:`, or `data:`. */
+declare function hasUriScheme(value: string): boolean;
+declare function classifyUrlPath(pathname: string, config: UrlContractConfig, options?: Pick<ResolveUrlOptions, 'kind' | 'routes'>): UrlRouteKind;
+declare function parseUrlReference(to: string, config: UrlContractConfig, options?: Pick<ResolveUrlOptions, 'kind' | 'routes'>): ParsedUrl;
+declare function buildUrl(options: BuildUrlOptions, config: UrlContractConfig): string;
+declare function resolveUrlReference(to: string, config: UrlContractConfig, options?: ResolveUrlOptions): string;
 //#endregion
-export { BoltdocsRoutePathWithFallback as A, SiteConfig as C, BoltdocsLocale as D, BoltdocsIntegrationsConfig as E, BoltdocsTypes as M, BoltdocsVersion as N, BoltdocsMdxComponents as O, SidebarProps as S, BoltdocsConfig as T, CollectionPostLoaderData as _, SidebarItem as a, NavbarLink as b, SidebarItemsProps as c, SidebarMobile as d, SidebarRoot as f, CollectionListLoaderData as g, BoltdocsTab as h, SidebarHeader as i, BoltdocsSocialLink as j, BoltdocsRoutePath as k, SidebarLink as l, ComponentBase as m, SidebarContent as n, SidebarItemProps as o, SidebarSubGroup as p, SidebarGroup as r, SidebarItems as s, Sidebar as t, SidebarLinkProps as u, ComponentRoute as v, TabsProps as w, OnThisPageProps as x, LayoutProps as y };
+export { LazyRouteResult as $, matchRouteBranch as A, useRouteData as B, stripSiteProtocol as C, normalizeBasename as D, hasBasename as E, useLoaderData as F, MatchesContext as G, LocationProvider as H, useLocation as I, PrefetchContext as J, NavigateContext as K, useMatches as L, resolveRouteBranch as M, Outlet as N, stripBasename as O, OutletContext as P, CreateRoutesResult as Q, useNavigate as R, splitUrlReference as S, addBasename as T, LocationProviderProps as U, LocationContext as V, LocationState as W, RouteDataContext as X, PrefetchFunction as Y, defaultNavigate as Z, isConfiguredVersion as _, StructuredData as _t, UrlRouteHint as a, RouterOptions as at, parseUrlReference as b, buildUrl as c, BoltdocsIntegrationsConfig as ct, getConfiguredVersions as d, BoltdocsRoutePath as dt, LoaderFunction as et, getVersionPrefixSegments as f, BoltdocsRoutePathWithFallback as ft, isConfiguredLocale as g, JsonLdObject as gt, hasUrlBase as h, BoltdocsVersion as ht, UrlContractConfig as i, RouteRendererProps as it, matchRouteBranchWithParams as j, RouteRenderer as k, classifyUrlPath as l, BoltdocsLocale as lt, hasUriScheme as m, BoltdocsTypes as mt, ParsedUrl as n, RouteMatch as nt, UrlRouteKind as o, BadgeValue as ot, getVersionSegments as p, BoltdocsSocialLink as pt, NavigateFunction as q, ResolveUrlOptions as r, RouteRecord as rt, addUrlBase as s, BoltdocsConfig as st, BuildUrlOptions as t, LoaderFunctionArgs as tt, getConfiguredLocales as u, BoltdocsMdxComponents as ut, normalizeUrlBase as v, stripUrlBase as w, resolveUrlReference as x, normalizeUrlPath as y, usePrefetch as z };