ardo 3.0.5 → 3.2.0

package/dist/index-DSeJoaxz.d.ts

@@ -0,0 +1,938 @@
+import { d as SponsorConfig, l as SidebarItem, s as ProjectMeta, t as ArdoConfig } from "./types-DVodb4lK.js";
+import { ComponentProps, ComponentType, ReactNode, SVGAttributes } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { Link, NavLink } from "react-router";
+
+//#region src/ui/Footer.d.ts
+interface ArdoFooterProps {
+  /** Footer message (supports HTML string) */
+  message?: string;
+  /** Copyright text (supports HTML string) */
+  copyright?: string;
+  /** Custom content (overrides all automatic rendering) */
+  children?: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+  /** Project metadata — renders linked "name vX.Y.Z" */
+  project?: ProjectMeta;
+  /** Sponsor link — renders "Sponsored by X" */
+  sponsor?: SponsorConfig;
+  /** Build timestamp (ISO string) — renders formatted date */
+  buildTime?: string;
+  /** Git commit hash — rendered next to the build date */
+  buildHash?: string;
+  /** Show "Built with Ardo" link (default: true) */
+  ardoLink?: boolean;
+}
+declare function ArdoFooter({
+  children,
+  className,
+  ardoLink,
+  message,
+  copyright,
+  project,
+  sponsor,
+  buildTime,
+  buildHash
+}: ArdoFooterProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoFooterMessageProps {
+  children: ReactNode;
+  className?: string;
+}
+interface ArdoFooterCopyrightProps {
+  children: ReactNode;
+  className?: string;
+}
+//#endregion
+//#region src/ui/Header.d.ts
+interface ArdoHeaderProps {
+  /** Logo image URL or light/dark variants */
+  logo?: {
+    light: string;
+    dark: string;
+  } | string;
+  /** Site title displayed next to logo */
+  title?: string;
+  /** Navigation content (Nav component or custom) */
+  nav?: ReactNode;
+  /** Actions/right side content (social links, custom buttons) */
+  actions?: ReactNode;
+  /** Show search (default: true) */
+  search?: boolean;
+  /** Placeholder text for the search input */
+  searchPlaceholder?: string;
+  /** Show theme toggle (default: true) */
+  themeToggle?: boolean;
+  /** Additional content rendered in the mobile menu (e.g. sidebar) */
+  mobileMenuContent?: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+}
+declare function ArdoHeader({
+  logo,
+  title,
+  nav,
+  actions,
+  search,
+  searchPlaceholder,
+  themeToggle,
+  mobileMenuContent,
+  className
+}: ArdoHeaderProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoSocialLinkProps {
+  /** URL to link to */
+  href: string;
+  /** Social icon type */
+  icon: "discord" | "github" | "linkedin" | "npm" | "twitter" | "youtube";
+  /** Accessible label */
+  ariaLabel?: string;
+  /** Additional CSS classes */
+  className?: string;
+}
+declare function ArdoSocialLink({
+  href,
+  icon,
+  ariaLabel,
+  className
+}: ArdoSocialLinkProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/Sidebar.d.ts
+/** Route path type - uses React Router's NavLink 'to' prop type for type-safe routes */
+type RoutePath$2 = ComponentProps<typeof NavLink>["to"];
+interface ArdoSidebarProps {
+  /** Sidebar items (for data-driven approach) */
+  items?: SidebarItem[];
+  /** Children for JSX composition (SidebarGroup, SidebarLink) */
+  children?: ReactNode;
+  /** Content rendered above navigation (e.g. search) */
+  header?: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+}
+/**
+ * Sidebar component supporting data-driven, JSX composition, and zero-config patterns.
+ *
+ * When neither `items` nor `children` are provided, automatically renders from
+ * the Ardo sidebar context (`virtual:ardo/sidebar`).
+ *
+ * @example Zero-config (from context)
+ * ```tsx
+ * <Sidebar />
+ * ```
+ *
+ * @example Data-driven (items prop)
+ * ```tsx
+ * <Sidebar items={[
+ *   { text: 'Introduction', link: '/intro' },
+ *   { text: 'Guide', items: [
+ *     { text: 'Getting Started', link: '/guide/getting-started' }
+ *   ]}
+ * ]} />
+ * ```
+ *
+ * @example JSX composition
+ * ```tsx
+ * <Sidebar>
+ *   <SidebarLink to="/intro">Introduction</SidebarLink>
+ *   <SidebarGroup title="Guide">
+ *     <SidebarLink to="/guide/getting-started">Getting Started</SidebarLink>
+ *   </SidebarGroup>
+ * </Sidebar>
+ * ```
+ */
+declare function ArdoSidebar({
+  items,
+  children,
+  header,
+  className
+}: ArdoSidebarProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoSidebarGroupProps {
+  /** Group title */
+  title: string;
+  /** Optional link for the group title */
+  to?: string;
+  /** Initial collapsed state (default: false) */
+  collapsed?: boolean;
+  /** Whether group is collapsible (default: true if has children) */
+  collapsible?: boolean;
+  /** Children (SidebarLink, nested SidebarGroup) */
+  children?: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+}
+/**
+ * Group component for organizing sidebar links.
+ *
+ * @example
+ * ```tsx
+ * <SidebarGroup title="Guide">
+ *   <SidebarLink to="/guide/intro">Introduction</SidebarLink>
+ *   <SidebarLink to="/guide/setup">Setup</SidebarLink>
+ * </SidebarGroup>
+ * ```
+ *
+ * @example With collapsible state
+ * ```tsx
+ * <SidebarGroup title="Advanced" collapsed>
+ *   <SidebarLink to="/advanced/config">Configuration</SidebarLink>
+ * </SidebarGroup>
+ * ```
+ */
+declare function ArdoSidebarGroup({
+  title,
+  to,
+  collapsed: initialCollapsed,
+  collapsible,
+  children,
+  className
+}: ArdoSidebarGroupProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoSidebarLinkProps {
+  /** Internal route path (type-safe with React Router's registered routes) */
+  to: RoutePath$2;
+  /** Link text */
+  children: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+}
+/**
+ * Sidebar navigation link.
+ *
+ * @example
+ * ```tsx
+ * <SidebarLink to="/guide/getting-started">Getting Started</SidebarLink>
+ * ```
+ */
+declare function ArdoSidebarLink({
+  to,
+  children,
+  className
+}: ArdoSidebarLinkProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/ArdoRoot.d.ts
+interface ArdoRootProps {
+  /** Ardo config (from virtual:ardo/config) */
+  config: ArdoConfig;
+  /** Sidebar data (from virtual:ardo/sidebar) */
+  sidebar: SidebarItem[];
+  /** Custom header element (overrides auto-generated header) */
+  header?: ReactNode;
+  /** Custom sidebar element (overrides auto-generated sidebar) */
+  sidebarContent?: ReactNode;
+  /** Custom footer element (overrides auto-generated footer) */
+  footer?: ReactNode;
+  /** Props passed to auto-generated ArdoHeader (ignored when header is provided) */
+  headerProps?: ArdoHeaderProps;
+  /** Props passed to auto-generated ArdoSidebar (ignored when sidebarContent is provided) */
+  sidebarProps?: ArdoSidebarProps;
+  /** Props passed to auto-generated ArdoFooter (ignored when footer is provided) */
+  footerProps?: ArdoFooterProps;
+  /** Edit link configuration (applied site-wide via ArdoSiteConfig) */
+  editLink?: {
+    pattern: string;
+    text?: string;
+  };
+  /** Last updated configuration (applied site-wide via ArdoSiteConfig) */
+  lastUpdated?: {
+    enabled?: boolean;
+    text?: string;
+    formatOptions?: Intl.DateTimeFormatOptions;
+  };
+  /** TOC label (applied site-wide via ArdoSiteConfig) */
+  tocLabel?: string;
+  /** Additional CSS classes for the layout */
+  className?: string;
+  /** Content to render (defaults to <Outlet />) */
+  children?: ReactNode;
+}
+declare function ArdoRoot({
+  config,
+  sidebar,
+  header,
+  sidebarContent,
+  footer,
+  headerProps,
+  sidebarProps,
+  footerProps,
+  editLink,
+  lastUpdated,
+  tocLabel,
+  className,
+  children
+}: ArdoRootProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/BareContent.d.ts
+/**
+ * Wraps imported MDX content to render without the full Content wrapper
+ * (article, header, footer, navigation). Only the content body is rendered.
+ *
+ * ```tsx
+ * import MySnippet from "./snippet.mdx"
+ *
+ * <BareContent>
+ *   <MySnippet />
+ * </BareContent>
+ * ```
+ */
+declare function ArdoBareContent({
+  children
+}: {
+  children: ReactNode;
+}): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/CodeBlock.d.ts
+interface ArdoCodeBlockProps {
+  /** The code to display (as prop or as children string) */
+  code?: string;
+  /** Programming language for syntax highlighting */
+  language?: string;
+  /** Optional title shown above the code */
+  title?: string;
+  /** Show line numbers */
+  lineNumbers?: boolean;
+  /** Line numbers to highlight */
+  highlightLines?: number[];
+  /** Code as children — supports template literals with auto-outdent */
+  children?: React.ReactNode;
+  /** Pre-rendered Shiki HTML (injected by ardo:codeblock-highlight plugin) */
+  __html?: string;
+}
+/**
+ * Syntax-highlighted code block with copy button.
+ *
+ * Code can be provided via the `code` prop or as children:
+ * ```tsx
+ * <CodeBlock language="typescript">{`
+ *   const x = 42
+ * `}</CodeBlock>
+ * ```tsx
+ * When children is a string, leading/trailing blank lines and common
+ * indentation are stripped automatically.
+ */
+declare function ArdoCodeBlock({
+  code: codeProp,
+  language,
+  title,
+  lineNumbers,
+  highlightLines,
+  children,
+  __html
+}: ArdoCodeBlockProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoCodeGroupProps {
+  /** CodeBlock components to display as tabs */
+  children: React.ReactNode;
+  /** Comma-separated tab labels */
+  labels?: string;
+}
+/**
+ * Tabbed group of code blocks.
+ * Labels come from the `labels` prop (set at remark level) or fall back to
+ * data-label / title / language props on children.
+ */
+declare function ArdoCodeGroup({
+  children,
+  labels: labelsStr
+}: ArdoCodeGroupProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/Container.d.ts
+type ArdoContainerType = "danger" | "info" | "note" | "tip" | "warning";
+interface ArdoContainerProps {
+  /** Container type determining the style */
+  type: ArdoContainerType;
+  /** Optional custom title */
+  title?: string;
+  /** Content to display inside the container */
+  children: ReactNode;
+}
+/**
+ * A styled container for callouts, tips, warnings, etc.
+ */
+declare function ArdoContainer({
+  type,
+  title,
+  children
+}: ArdoContainerProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoTipProps {
+  /** Optional custom title */
+  title?: string;
+  /** Content to display */
+  children: ReactNode;
+}
+/**
+ * A tip container for helpful information.
+ */
+declare function ArdoTip({
+  title,
+  children
+}: ArdoTipProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoWarningProps {
+  /** Optional custom title */
+  title?: string;
+  /** Content to display */
+  children: ReactNode;
+}
+/**
+ * A warning container for cautionary information.
+ */
+declare function ArdoWarning({
+  title,
+  children
+}: ArdoWarningProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoDangerProps {
+  /** Optional custom title */
+  title?: string;
+  /** Content to display */
+  children: ReactNode;
+}
+/**
+ * A danger container for critical warnings.
+ */
+declare function ArdoDanger({
+  title,
+  children
+}: ArdoDangerProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoInfoProps {
+  /** Optional custom title */
+  title?: string;
+  /** Content to display */
+  children: ReactNode;
+}
+/**
+ * An info container for informational content.
+ */
+declare function ArdoInfo({
+  title,
+  children
+}: ArdoInfoProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoNoteProps {
+  /** Optional custom title */
+  title?: string;
+  /** Content to display */
+  children: ReactNode;
+}
+/**
+ * A note container for additional information.
+ */
+declare function ArdoNote({
+  title,
+  children
+}: ArdoNoteProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/CopyButton.d.ts
+interface CopyButtonProps {
+  code: string;
+}
+declare function ArdoCopyButton({
+  code
+}: CopyButtonProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/Features.d.ts
+interface ArdoFeaturesProps {
+  /** Feature cards as children */
+  children: ReactNode;
+  /** Section title */
+  title?: string;
+  /** Section subtitle */
+  subtitle?: string;
+  /** Additional CSS class */
+  className?: string;
+}
+interface ArdoFeatureCardProps {
+  /** Feature title */
+  title: string;
+  /** Icon as ReactNode (emoji, Lucide icon component, or any JSX) */
+  icon?: ReactNode;
+  /** Feature description as children */
+  children: ReactNode;
+  /** Optional link */
+  link?: string;
+  /** Link text (defaults to "Learn more") */
+  linkText?: string;
+  /** Additional CSS class */
+  className?: string;
+}
+/**
+ * Individual feature card component.
+ *
+ * @example
+ * ```tsx
+ * import { Zap } from "lucide-react"
+ *
+ * <ArdoFeatureCard title="Fast" icon={<Zap size={28} />}>
+ *   Lightning fast builds with Vite
+ * </ArdoFeatureCard>
+ * ```
+ */
+declare function ArdoFeatureCard({
+  title,
+  icon,
+  children,
+  link,
+  linkText,
+  className
+}: ArdoFeatureCardProps): _$react_jsx_runtime0.JSX.Element;
+/**
+ * Features grid component for displaying multiple feature cards.
+ *
+ * @example
+ * ```tsx
+ * <ArdoFeatures title="Key Features" subtitle="Everything you need">
+ *   <ArdoFeatureCard title="React-First" icon="⚛️">Built on React.</ArdoFeatureCard>
+ *   <ArdoFeatureCard title="Fast" icon="⚡">Powered by Vite.</ArdoFeatureCard>
+ * </ArdoFeatures>
+ * ```
+ */
+declare function ArdoFeatures({
+  children,
+  title,
+  subtitle,
+  className
+}: ArdoFeaturesProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/Hero.d.ts
+/** Internal route path from React Router */
+type RoutePath$1 = ComponentProps<typeof Link>["to"];
+interface ArdoHeroAction {
+  /** Button text */
+  text: string;
+  /** Link destination - internal route path or external URL */
+  link: RoutePath$1;
+  /** Visual theme: "brand" for primary, "alt" for secondary */
+  theme?: "alt" | "brand";
+  /** Optional icon as ReactNode (e.g. Lucide icon component) */
+  icon?: ReactNode;
+}
+interface ArdoHeroImage {
+  /** Image for light mode */
+  light: string;
+  /** Image for dark mode */
+  dark?: string;
+  /** Alt text for the image */
+  alt?: string;
+}
+interface ArdoHeroProps {
+  /** Large title displayed prominently */
+  name?: string;
+  /** Secondary text below the name */
+  text?: string;
+  /** Descriptive tagline */
+  tagline?: string;
+  /** Hero image - can be a string URL or an object with light/dark variants */
+  image?: ArdoHeroImage | string;
+  /** Call-to-action buttons */
+  actions?: ArdoHeroAction[];
+  /** Additional CSS class */
+  className?: string;
+  /** Version string displayed as a pill badge above the name */
+  version?: string;
+}
+declare function ArdoHero({
+  name,
+  text,
+  tagline,
+  image,
+  actions,
+  className,
+  version
+}: ArdoHeroProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/Icon.d.ts
+type IconComponent = ComponentType<{
+  size?: number;
+} & SVGAttributes<SVGSVGElement>>;
+interface ArdoIconProps extends SVGAttributes<SVGSVGElement> {
+  /** Name of the registered icon */
+  name: string;
+  /** Icon size */
+  size?: number;
+}
+/**
+ * Register icons for use with the Icon component.
+ * Only registered icons are included in your bundle.
+ *
+ * @example
+ * ```tsx
+ * // In your app's entry point or layout:
+ * import { registerIcons } from "ardo/ui"
+ * import { Zap, Rocket, Code } from "lucide-react"
+ *
+ * registerIcons({ Zap, Rocket, Code })
+ * ```
+ */
+declare function registerIcons(icons: Record<string, IconComponent>): void;
+/**
+ * Get all registered icon names (useful for documentation).
+ */
+declare function getRegisteredIconNames(): string[];
+/**
+ * Renders a registered icon by name.
+ * Icons must be registered first using `registerIcons()`.
+ *
+ * @example
+ * ```tsx
+ * // First register icons in your app:
+ * import { registerIcons } from "ardo/ui"
+ * import { Zap, Rocket } from "lucide-react"
+ * registerIcons({ Zap, Rocket })
+ *
+ * // Then use in MDX:
+ * <Icon name="Zap" size={24} />
+ * <Icon name="Rocket" className="text-brand" />
+ * ```
+ *
+ * @see https://lucide.dev/icons for available icon names
+ */
+declare function ArdoIcon({
+  name,
+  ...props
+}: ArdoIconProps): ReactNode;
+//#endregion
+//#region src/ui/components/Search.d.ts
+interface ArdoSearchProps {
+  /** Placeholder text for the search input (default: "Search...") */
+  placeholder?: string;
+}
+declare function ArdoSearch({
+  placeholder
+}: ArdoSearchProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/Steps.d.ts
+interface ArdoStepsProps {
+  /** Content to display, typically an ordered list (`<ol>`) */
+  children: ReactNode;
+}
+/**
+ * A wrapper for step-by-step instructions rendered as an ordered list.
+ *
+ * @example
+ * ```tsx
+ * <ArdoSteps>
+ *   <ol>
+ *     <li>Install the package</li>
+ *     <li>Configure your site</li>
+ *     <li>Start writing</li>
+ *   </ol>
+ * </ArdoSteps>
+ * ```
+ */
+declare function ArdoSteps({
+  children
+}: ArdoStepsProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/Tabs.d.ts
+interface ArdoTabsProps {
+  /** Default active tab value */
+  defaultValue?: string;
+  /** Tab components (ArdoTabList and ArdoTabPanels) */
+  children: ReactNode;
+}
+/**
+ * Tabs container component for organizing content into tabbed panels.
+ */
+declare function ArdoTabs({
+  defaultValue,
+  children
+}: ArdoTabsProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoTabListProps {
+  /** Tab buttons */
+  children: ReactNode;
+}
+/**
+ * Container for ArdoTab buttons.
+ */
+declare function ArdoTabList({
+  children
+}: ArdoTabListProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoTabProps {
+  /** Unique value identifying this tab (optional if tab order matches panels) */
+  value?: string;
+  /** Tab button label */
+  children: ReactNode;
+}
+/**
+ * Individual tab button.
+ */
+declare function ArdoTab({
+  value,
+  children
+}: ArdoTabProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoTabPanelProps {
+  /** Value matching the corresponding ArdoTab (optional if panel order matches tabs) */
+  value?: string;
+  /** Panel content */
+  children: ReactNode;
+}
+/**
+ * Content panel for a tab.
+ */
+declare function ArdoTabPanel({
+  value,
+  children
+}: ArdoTabPanelProps): _$react_jsx_runtime0.JSX.Element | null;
+interface ArdoTabPanelsProps {
+  /** ArdoTabPanel components */
+  children: ReactNode;
+}
+/**
+ * Container for ArdoTabPanel components.
+ */
+declare function ArdoTabPanels({
+  children
+}: ArdoTabPanelsProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/components/ThemeToggle.d.ts
+declare function ArdoThemeToggle(): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/Content.d.ts
+interface ContentProps {
+  children: ReactNode;
+  /** Edit link configuration (overrides ArdoSiteConfig) */
+  editLink?: {
+    pattern: string;
+    text?: string;
+  };
+  /** Last updated configuration (overrides ArdoSiteConfig) */
+  lastUpdated?: {
+    enabled?: boolean;
+    text?: string;
+    formatOptions?: Intl.DateTimeFormatOptions;
+  };
+}
+declare function ArdoContent({
+  children,
+  editLink,
+  lastUpdated
+}: ContentProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/DocPage.d.ts
+interface DocPageProps {
+  children: ReactNode;
+  /** Edit link configuration (forwarded to Content) */
+  editLink?: {
+    pattern: string;
+    text?: string;
+  };
+  /** Last updated configuration (forwarded to Content) */
+  lastUpdated?: {
+    enabled?: boolean;
+    text?: string;
+    formatOptions?: Intl.DateTimeFormatOptions;
+  };
+  /** TOC label (forwarded to TOC) */
+  tocLabel?: string;
+}
+/**
+ * Full documentation page with Layout wrapper.
+ * Use this when you don't have a _layout.tsx file.
+ *
+ * @example
+ * ```tsx
+ * <DocPage>
+ *   <Content />
+ * </DocPage>
+ * ```
+ */
+declare function ArdoDocPage({
+  children,
+  editLink,
+  lastUpdated,
+  tocLabel
+}: DocPageProps): _$react_jsx_runtime0.JSX.Element;
+interface DocContentProps {
+  children: ReactNode;
+  /** Edit link configuration (forwarded to Content) */
+  editLink?: {
+    pattern: string;
+    text?: string;
+  };
+  /** Last updated configuration (forwarded to Content) */
+  lastUpdated?: {
+    enabled?: boolean;
+    text?: string;
+    formatOptions?: Intl.DateTimeFormatOptions;
+  };
+  /** TOC label (forwarded to TOC) */
+  tocLabel?: string;
+}
+/**
+ * Documentation content without Layout wrapper.
+ * Use this when you have a _layout.tsx that provides the Layout.
+ *
+ * @example
+ * ```tsx
+ * // In _layout.tsx:
+ * <Layout>
+ *   <Header ... />
+ *   <Sidebar ... />
+ *   <Outlet />
+ *   <Footer ... />
+ * </Layout>
+ *
+ * // In page routes:
+ * <DocContent>
+ *   <MarkdownContent />
+ * </DocContent>
+ * ```
+ */
+declare function ArdoDocContent({
+  children,
+  editLink,
+  lastUpdated,
+  tocLabel
+}: DocContentProps): _$react_jsx_runtime0.JSX.Element;
+interface DocLayoutProps {
+  content: ReactNode;
+}
+/**
+ * @deprecated Use DocPage or DocContent instead
+ */
+declare function ArdoDocLayout({
+  content
+}: DocLayoutProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/HomePage.d.ts
+interface ArdoHomePageProps {
+  /** Props passed to the Header component */
+  headerProps?: ArdoHeaderProps;
+  /** Props passed to the Footer component */
+  footerProps?: ArdoFooterProps;
+  /** Custom header element (overrides auto-generated header) */
+  header?: ReactNode;
+  /** Custom footer element (overrides auto-generated footer) */
+  footer?: ReactNode;
+}
+declare function ArdoHomePage({
+  headerProps,
+  footerProps,
+  header,
+  footer
+}?: ArdoHomePageProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/Layout.d.ts
+interface ArdoRootLayoutProps {
+  children: ReactNode;
+  /** Favicon URL (renders <link rel="icon">) */
+  favicon?: string;
+  /** Language attribute for <html> (default: from config or "en") */
+  lang?: string;
+}
+/**
+ * Default HTML shell for Ardo sites. Replaces the boilerplate `Layout` export
+ * that every root.tsx must define for React Router.
+ *
+ * @example Basic usage
+ * ```tsx
+ * // app/root.tsx
+ * export { RootLayout as Layout } from "ardo/ui"
+ * ```
+ *
+ * @example With favicon
+ * ```tsx
+ * import logo from "./assets/logo.svg"
+ * export const Layout = (props) => <RootLayout favicon={logo} {...props} />
+ * ```
+ */
+declare function ArdoRootLayout({
+  children,
+  favicon,
+  lang
+}: ArdoRootLayoutProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoLayoutProps {
+  /** Header content */
+  header?: ReactNode;
+  /** Sidebar content */
+  sidebar?: ReactNode;
+  /** Footer content */
+  footer?: ReactNode;
+  /** Main content */
+  children: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+}
+/**
+ * Layout component with explicit slot props.
+ *
+ * @example
+ * ```tsx
+ * <Layout
+ *   header={<Header logo="/logo.svg" title="Ardo" nav={...} />}
+ *   sidebar={<Sidebar>...</Sidebar>}
+ *   footer={<Footer message="MIT License" />}
+ * >
+ *   <Outlet />
+ * </Layout>
+ * ```
+ */
+declare function ArdoLayout({
+  header,
+  sidebar,
+  footer,
+  children,
+  className
+}: ArdoLayoutProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/Nav.d.ts
+/** Route path type - uses React Router's NavLink 'to' prop type for type-safe routes */
+type RoutePath = ComponentProps<typeof NavLink>["to"];
+interface ArdoNavProps {
+  children?: ReactNode;
+  className?: string;
+}
+/**
+ * Navigation container component for composing navigation links.
+ *
+ * @example
+ * ```tsx
+ * <Nav>
+ *   <NavLink to="/guide">Guide</NavLink>
+ *   <NavLink to="/api">API</NavLink>
+ *   <NavLink href="https://github.com/...">GitHub</NavLink>
+ * </Nav>
+ * ```
+ */
+declare function ArdoNav({
+  children,
+  className
+}: ArdoNavProps): _$react_jsx_runtime0.JSX.Element;
+interface ArdoNavLinkProps {
+  /** Internal route path (type-safe with React Router's registered routes) */
+  to?: RoutePath;
+  /** External URL (uses anchor tag) */
+  href?: string;
+  /** Link text or children */
+  children: ReactNode;
+  /** Additional CSS classes */
+  className?: string;
+  /** Active state match pattern */
+  activeMatch?: string;
+}
+/**
+ * Navigation link component supporting both internal routes and external URLs.
+ *
+ * @example
+ * ```tsx
+ * // Internal link
+ * <NavLink to="/guide">Guide</NavLink>
+ *
+ * // External link
+ * <NavLink href="https://github.com/...">GitHub</NavLink>
+ * ```
+ */
+declare function ArdoNavLink({
+  to,
+  href,
+  children,
+  className,
+  activeMatch: _activeMatch
+}: ArdoNavLinkProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/ui/TOC.d.ts
+interface ArdoTOCProps {
+  /** Label for the TOC heading (default: "On this page") */
+  label?: string;
+}
+declare function ArdoTOC({
+  label: labelProp
+}?: ArdoTOCProps): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { ArdoTip as $, ArdoSearch as A, ArdoFeatureCardProps as B, ArdoTabPanels as C, ArdoFooterProps as Ct, ArdoTabsProps as D, ArdoTabs as E, ArdoHero as F, ArdoContainerProps as G, ArdoFeaturesProps as H, ArdoHeroAction as I, ArdoDangerProps as J, ArdoContainerType as K, ArdoHeroImage as L, ArdoIconProps as M, getRegisteredIconNames as N, ArdoSteps as O, registerIcons as P, ArdoNoteProps as Q, ArdoHeroProps as R, ArdoTabPanelProps as S, ArdoFooterMessageProps as St, ArdoTabProps as T, ArdoCopyButton as U, ArdoFeatures as V, ArdoContainer as W, ArdoInfoProps as X, ArdoInfo as Y, ArdoNote as Z, ArdoThemeToggle as _, ArdoHeaderProps as _t, ArdoNavLinkProps as a, ArdoCodeGroup as at, ArdoTabListProps as b, ArdoFooter as bt, ArdoLayoutProps as c, ArdoRoot as ct, ArdoHomePage as d, ArdoSidebarGroup as dt, ArdoTipProps as et, ArdoHomePageProps as f, ArdoSidebarGroupProps as ft, ArdoContent as g, ArdoHeader as gt, ArdoDocPage as h, ArdoSidebarProps as ht, ArdoNavLink as i, ArdoCodeBlockProps as it, ArdoIcon as j, ArdoStepsProps as k, ArdoRootLayout as l, ArdoRootProps as lt, ArdoDocLayout as m, ArdoSidebarLinkProps as mt, ArdoTOCProps as n, ArdoWarningProps as nt, ArdoNavProps as o, ArdoCodeGroupProps as ot, ArdoDocContent as p, ArdoSidebarLink as pt, ArdoDanger as q, ArdoNav as r, ArdoCodeBlock as rt, ArdoLayout as s, ArdoBareContent as st, ArdoTOC as t, ArdoWarning as tt, ArdoRootLayoutProps as u, ArdoSidebar as ut, ArdoTab as v, ArdoSocialLink as vt, ArdoTabPanelsProps as w, ArdoTabPanel as x, ArdoFooterCopyrightProps as xt, ArdoTabList as y, ArdoSocialLinkProps as yt, ArdoFeatureCard as z };
+//# sourceMappingURL=index-DSeJoaxz.d.ts.map