ardo 3.0.3 → 3.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{FileTree-K0YVFXhg.d.ts → FileTree-qpT1ZVrW.d.ts} +7 -5
- package/dist/{chunk-UWFMFHRD.js → chunk-QKDVSW6Q.js} +57 -9
- package/dist/{chunk-UWFMFHRD.js.map → chunk-QKDVSW6Q.js.map} +1 -1
- package/dist/{chunk-TDBU2FXP.js → chunk-XK7YZAVP.js} +65 -22
- package/dist/chunk-XK7YZAVP.js.map +1 -0
- package/dist/index.d.ts +3 -6
- package/dist/index.js +2 -44
- package/dist/mdx/provider.js +1 -1
- package/dist/typedoc/index.js +259 -10
- package/dist/typedoc/index.js.map +1 -1
- package/dist/ui/index.d.ts +2 -2
- package/dist/ui/index.js +2 -2
- package/dist/ui/styles.css +83 -2
- package/dist/vite/index.d.ts +1 -1
- package/dist/vite/index.js +1314 -16
- package/dist/vite/index.js.map +1 -1
- package/package.json +1 -1
- package/dist/chunk-TDBU2FXP.js.map +0 -1
- package/dist/chunk-TTOK7CO6.js +0 -1341
- package/dist/chunk-TTOK7CO6.js.map +0 -1
- package/dist/chunk-Y46KCHBO.js +0 -274
- package/dist/chunk-Y46KCHBO.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/ui/Layout.tsx","../src/ui/ArdoRoot.tsx","../src/ui/Header.tsx","../src/ui/components/ThemeToggle.tsx","../src/ui/Sidebar.tsx","../src/ui/Footer.tsx","../src/ui/Nav.tsx","../src/ui/TOC.tsx","../src/ui/DocPage.tsx","../src/ui/HomePage.tsx","../src/ui/components/Hero.tsx","../src/ui/components/Features.tsx","../src/ui/components/Steps.tsx","../src/ui/components/FileTree.tsx"],"sourcesContent":["import { type ReactNode, useContext } from \"react\"\nimport { Links, Meta, Scripts, ScrollRestoration } from \"react-router\"\nimport { ArdoContext } from \"../runtime/hooks\"\n\n// =============================================================================\n// RootLayout Component (html/head/body shell)\n// =============================================================================\n\nconst ARDO_FAVICON =\n \"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20style%3D%22stroke-linecap%3Around%3Bstroke-linejoin%3Around%22%20viewBox%3D%220%200%20600%20600%22%3E%3Cdefs%3E%3Csymbol%20id%3D%22a%22%20overflow%3D%22visible%22%3E%3Cpath%20d%3D%22M300%20300%20151%20128l2%20178-41%2094h93c-35%2032-55%2068-63%20107m63-106%2095%2081m-32-96%2028%2088%22%2F%3E%3Cellipse%20cx%3D%22222%22%20cy%3D%22327%22%20fill%3D%22%2300655a%22%20rx%3D%2220%22%20ry%3D%2233%22%2F%3E%3Ccircle%20cx%3D%22227%22%20cy%3D%22324%22%20r%3D%2271%22%2F%3E%3C%2Fsymbol%3E%3C%2Fdefs%3E%3Cg%20fill%3D%22none%22%20stroke%3D%22%2300655a%22%20stroke-width%3D%2216%22%3E%3Cpath%20d%3D%22M155%20318c2-70%2066-126%20145-126s143%2056%20145%20126%22%2F%3E%3Ccircle%20cx%3D%22300%22%20cy%3D%22290%22%20r%3D%22270%22%2F%3E%3Cuse%20href%3D%22%23a%22%2F%3E%3Cuse%20href%3D%22%23a%22%20transform%3D%22matrix%28-1%200%200%201%20600%200%29%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E\"\n\nexport interface RootLayoutProps {\n children: ReactNode\n /** Favicon URL (renders <link rel=\"icon\">) */\n favicon?: string\n /** Language attribute for <html> (default: from config or \"en\") */\n lang?: string\n}\n\n/**\n * Default HTML shell for Ardo sites. Replaces the boilerplate `Layout` export\n * that every root.tsx must define for React Router.\n *\n * @example Basic usage\n * ```tsx\n * // app/root.tsx\n * export { RootLayout as Layout } from \"ardo/ui\"\n * ```\n *\n * @example With favicon\n * ```tsx\n * import logo from \"./assets/logo.svg\"\n * export const Layout = (props) => <RootLayout favicon={logo} {...props} />\n * ```\n */\nexport function RootLayout({ children, favicon, lang }: RootLayoutProps) {\n // Use optional context (RootLayout renders before ArdoProvider is available)\n const context = useContext(ArdoContext)\n const resolvedLang = lang ?? context?.config.lang ?? \"en\"\n\n return (\n <html lang={resolvedLang} suppressHydrationWarning>\n <head>\n <meta charSet=\"utf-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n <link rel=\"icon\" type=\"image/svg+xml\" href={favicon ?? ARDO_FAVICON} />\n <Meta />\n <Links />\n </head>\n <body suppressHydrationWarning>\n {children}\n <ScrollRestoration />\n <Scripts />\n </body>\n </html>\n )\n}\n\n// =============================================================================\n// Layout Component\n// =============================================================================\n\nexport interface LayoutProps {\n /** Header content */\n header?: ReactNode\n /** Sidebar content */\n sidebar?: ReactNode\n /** Footer content */\n footer?: ReactNode\n /** Main content */\n children: ReactNode\n /** Additional CSS classes */\n className?: string\n}\n\n/**\n * Layout component with explicit slot props.\n *\n * @example\n * ```tsx\n * <Layout\n * header={<Header logo=\"/logo.svg\" title=\"Ardo\" nav={...} />}\n * sidebar={<Sidebar>...</Sidebar>}\n * footer={<Footer message=\"MIT License\" />}\n * >\n * <Outlet />\n * </Layout>\n * ```\n */\nexport function Layout({ header, sidebar, footer, children, className }: LayoutProps) {\n return (\n <div className={className ?? \"ardo-layout\"}>\n <a href=\"#main-content\" className=\"ardo-skip-link\">\n Skip to content\n </a>\n {header}\n <div className=\"ardo-layout-container\">\n {sidebar}\n <main id=\"main-content\" className=\"ardo-main\">\n {children}\n </main>\n </div>\n {footer}\n </div>\n )\n}\n","import { cloneElement, isValidElement, type ReactNode } from \"react\"\nimport { Outlet, useLocation } from \"react-router\"\nimport { ArdoProvider } from \"../runtime/hooks\"\nimport type { ArdoConfig, SidebarItem } from \"../config/types\"\nimport { Layout } from \"./Layout\"\nimport { Header, type HeaderProps } from \"./Header\"\nimport { Sidebar, type SidebarProps } from \"./Sidebar\"\nimport { Footer, type FooterProps } from \"./Footer\"\n\n// =============================================================================\n// ArdoRoot Component\n// =============================================================================\n\nexport interface ArdoRootProps {\n /** Ardo config (from virtual:ardo/config) */\n config: ArdoConfig\n /** Sidebar data (from virtual:ardo/sidebar) */\n sidebar: SidebarItem[]\n /** Custom header element (overrides auto-generated header) */\n header?: ReactNode\n /** Custom sidebar element (overrides auto-generated sidebar) */\n sidebarContent?: ReactNode\n /** Custom footer element (overrides auto-generated footer) */\n footer?: ReactNode\n /** Props passed to auto-generated Header (ignored when header is provided) */\n headerProps?: HeaderProps\n /** Props passed to auto-generated Sidebar (ignored when sidebarContent is provided) */\n sidebarProps?: SidebarProps\n /** Props passed to auto-generated Footer (ignored when footer is provided) */\n footerProps?: FooterProps\n /** Additional CSS classes for the layout */\n className?: string\n /** Content to render (defaults to <Outlet />) */\n children?: ReactNode\n}\n\n/**\n * All-in-one root component that combines ArdoProvider, Layout, Header,\n * Sidebar, Footer, and homepage detection into a single component.\n *\n * @example Minimal usage\n * ```tsx\n * import config from \"virtual:ardo/config\"\n * import sidebar from \"virtual:ardo/sidebar\"\n *\n * export default function Root() {\n * return <ArdoRoot config={config} sidebar={sidebar} />\n * }\n * ```\n *\n * @example With custom nav and footer overrides\n * ```tsx\n * export default function Root() {\n * return (\n * <ArdoRoot\n * config={config}\n * sidebar={sidebar}\n * headerProps={{\n * nav: (\n * <Nav>\n * <NavLink to=\"/guide\">Guide</NavLink>\n * <NavLink to=\"/api\">API</NavLink>\n * </Nav>\n * ),\n * }}\n * footerProps={{\n * message: \"Released under the MIT License.\",\n * }}\n * />\n * )\n * }\n * ```\n */\nexport function ArdoRoot({\n config,\n sidebar,\n header,\n sidebarContent,\n footer,\n headerProps,\n sidebarProps,\n footerProps,\n className,\n children,\n}: ArdoRootProps) {\n const location = useLocation()\n const isHomePage = location.pathname === \"/\" || location.pathname === \"\"\n\n const resolvedSidebar = isHomePage ? undefined : (sidebarContent ?? <Sidebar {...sidebarProps} />)\n const inferredMobileMenuContent = isHomePage ? undefined : resolvedSidebar\n const resolvedHeader = header ? (\n enhanceHeaderWithMobileMenuContent(header, inferredMobileMenuContent)\n ) : (\n <Header\n {...headerProps}\n mobileMenuContent={headerProps?.mobileMenuContent ?? inferredMobileMenuContent}\n />\n )\n const resolvedFooter = footer ?? <Footer {...footerProps} />\n const resolvedClassName = className ?? (isHomePage ? \"ardo-layout ardo-home\" : \"ardo-layout\")\n\n return (\n <ArdoProvider config={config} sidebar={sidebar}>\n <Layout\n className={resolvedClassName}\n header={resolvedHeader}\n sidebar={resolvedSidebar}\n footer={resolvedFooter}\n >\n {children ?? <Outlet />}\n </Layout>\n </ArdoProvider>\n )\n}\n\nfunction enhanceHeaderWithMobileMenuContent(\n header: ReactNode,\n mobileMenuContent: ReactNode\n): ReactNode {\n if (!isValidElement<HeaderProps>(header) || header.type !== Header) {\n return header\n }\n\n const existingMobileMenuContent = header.props.mobileMenuContent\n if (existingMobileMenuContent !== undefined) {\n return header\n }\n\n return cloneElement(header, { mobileMenuContent })\n}\n","import { useEffect, useState, lazy, Suspense, type MouseEvent, type ReactNode } from \"react\"\nimport { Link, NavLink as RouterNavLink, useLocation } from \"react-router\"\nimport {\n GithubIcon,\n TwitterIcon,\n MessageCircleIcon,\n LinkedinIcon,\n YoutubeIcon,\n PackageIcon,\n} from \"./icons\"\nimport { ThemeToggle } from \"./components/ThemeToggle\"\nimport { useConfig, useThemeConfig } from \"../runtime/hooks\"\nimport type { NavItem } from \"../config/types\"\n\nconst LazySearch = lazy(() => import(\"./components/Search\").then((m) => ({ default: m.Search })))\n\n// =============================================================================\n// Header Component\n// =============================================================================\n\nexport interface HeaderProps {\n /** Logo image URL or light/dark variants */\n logo?: string | { light: string; dark: string }\n /** Site title displayed next to logo */\n title?: string\n /** Navigation content (Nav component or custom) */\n nav?: ReactNode\n /** Actions/right side content (social links, custom buttons) */\n actions?: ReactNode\n /** Show search (default: true) */\n search?: boolean\n /** Show theme toggle (default: true) */\n themeToggle?: boolean\n /** Additional content rendered in the mobile menu (e.g. sidebar) */\n mobileMenuContent?: ReactNode\n /** Additional CSS classes */\n className?: string\n}\n\n/**\n * Header component with explicit slot props.\n *\n * Automatically pulls `title` from config and `logo`/`siteTitle` from themeConfig.\n * Props serve as overrides.\n *\n * @example Zero-config\n * ```tsx\n * <Header />\n * ```\n *\n * @example With overrides\n * ```tsx\n * <Header\n * logo=\"/logo.svg\"\n * title=\"Ardo\"\n * nav={\n * <Nav>\n * <NavLink to=\"/guide\">Guide</NavLink>\n * <NavLink to=\"/api\">API</NavLink>\n * </Nav>\n * }\n * />\n * ```\n */\nexport function Header({\n logo,\n title,\n nav,\n actions,\n search = true,\n themeToggle = true,\n mobileMenuContent,\n className,\n}: HeaderProps) {\n const location = useLocation()\n const config = useConfig()\n const themeConfig = useThemeConfig()\n const [mobileMenuOpen, setMobileMenuOpen] = useState(false)\n\n const resolvedLogo = logo ?? themeConfig.logo\n const resolvedTitle =\n title ?? (themeConfig.siteTitle !== false ? (themeConfig.siteTitle ?? config.title) : undefined)\n\n // Auto-render nav from themeConfig.nav when no nav prop given\n const resolvedNav =\n nav ?? (themeConfig.nav?.length ? <AutoNav items={themeConfig.nav} /> : undefined)\n\n // Auto-render social links from themeConfig.socialLinks when no actions prop given\n const resolvedActions =\n actions ??\n (themeConfig.socialLinks?.length\n ? themeConfig.socialLinks.map((link, i) => (\n <SocialLink key={i} href={link.link} icon={link.icon} ariaLabel={link.ariaLabel} />\n ))\n : undefined)\n const hasMobileMenu = Boolean(mobileMenuContent)\n\n useEffect(() => {\n setMobileMenuOpen(false)\n }, [location.pathname])\n\n const handleMobileMenuClick = (event: MouseEvent<HTMLElement>) => {\n const target = event.target as HTMLElement\n if (target.closest(\"a\")) {\n setMobileMenuOpen(false)\n }\n }\n const resolvedClassName = [\n className ?? \"ardo-header\",\n resolvedNav && \"ardo-header-with-mobile-top-nav\",\n ]\n .filter(Boolean)\n .join(\" \")\n\n return (\n <header className={resolvedClassName}>\n <div className=\"ardo-header-container\">\n {/* Left: Mobile menu button + Logo/Title */}\n <div className=\"ardo-header-left\">\n {hasMobileMenu && (\n <button\n type=\"button\"\n className=\"ardo-mobile-menu-button\"\n onClick={() => setMobileMenuOpen(!mobileMenuOpen)}\n aria-label=\"Toggle menu\"\n aria-expanded={mobileMenuOpen}\n >\n <span className=\"ardo-hamburger\">\n <span></span>\n <span></span>\n <span></span>\n </span>\n </button>\n )}\n\n <Link to=\"/\" className=\"ardo-logo-link\">\n {resolvedLogo && (\n <img\n src={typeof resolvedLogo === \"string\" ? resolvedLogo : resolvedLogo.light}\n alt={resolvedTitle ?? \"Logo\"}\n className=\"ardo-logo\"\n />\n )}\n {resolvedTitle && <span className=\"ardo-site-title\">{resolvedTitle}</span>}\n </Link>\n </div>\n\n {/* Center: Navigation */}\n {resolvedNav && <div className=\"ardo-desktop-nav\">{resolvedNav}</div>}\n\n {/* Right: Search, Theme Toggle, Actions */}\n <div className=\"ardo-header-right\">\n {search && (\n <Suspense fallback={<span className=\"ardo-search-placeholder\" />}>\n <LazySearch />\n </Suspense>\n )}\n {themeToggle && <ThemeToggle />}\n {resolvedActions}\n </div>\n </div>\n\n {resolvedNav && (\n <div className=\"ardo-mobile-top-nav\">\n <div className=\"ardo-mobile-top-nav-inner\">{resolvedNav}</div>\n </div>\n )}\n\n {/* Mobile menu */}\n {mobileMenuOpen && hasMobileMenu && (\n <div className=\"ardo-mobile-menu\">\n {mobileMenuContent && (\n <div\n className=\"ardo-mobile-menu-content ardo-mobile-menu-section\"\n onClick={handleMobileMenuClick}\n >\n {mobileMenuContent}\n </div>\n )}\n </div>\n )}\n </header>\n )\n}\n\n// =============================================================================\n// SocialLink Component\n// =============================================================================\n\nexport interface SocialLinkProps {\n /** URL to link to */\n href: string\n /** Social icon type */\n icon: \"github\" | \"twitter\" | \"discord\" | \"linkedin\" | \"youtube\" | \"npm\"\n /** Accessible label */\n ariaLabel?: string\n /** Additional CSS classes */\n className?: string\n}\n\n/**\n * Social media link with icon.\n *\n * @example\n * ```tsx\n * <SocialLink href=\"https://github.com/...\" icon=\"github\" />\n * ```\n */\nexport function SocialLink({ href, icon, ariaLabel, className }: SocialLinkProps) {\n return (\n <a\n href={href}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n className={className ?? \"ardo-social-link\"}\n aria-label={ariaLabel ?? icon}\n >\n <SocialIcon icon={icon} />\n </a>\n )\n}\n\n// =============================================================================\n// Auto Nav Component (internal, renders from NavItem[])\n// =============================================================================\n\nfunction AutoNav({ items }: { items: NavItem[] }) {\n return (\n <nav className=\"ardo-nav\">\n {items.map((item, i) => (\n <AutoNavItem key={i} item={item} />\n ))}\n </nav>\n )\n}\n\nfunction AutoNavItem({ item }: { item: NavItem }) {\n if (item.link?.startsWith(\"http\")) {\n return (\n <a href={item.link} className=\"ardo-nav-link\" target=\"_blank\" rel=\"noopener noreferrer\">\n {item.text}\n </a>\n )\n }\n\n if (item.link) {\n return (\n <RouterNavLink\n to={item.link}\n className={({ isActive }: { isActive: boolean }) =>\n [\"ardo-nav-link\", isActive && \"active\"].filter(Boolean).join(\" \")\n }\n >\n {item.text}\n </RouterNavLink>\n )\n }\n\n return <span className=\"ardo-nav-link\">{item.text}</span>\n}\n\n// =============================================================================\n// Social Icon Component (internal)\n// =============================================================================\n\nconst socialIcons = {\n github: GithubIcon,\n twitter: TwitterIcon,\n discord: MessageCircleIcon,\n linkedin: LinkedinIcon,\n youtube: YoutubeIcon,\n npm: PackageIcon,\n} as const\n\nfunction SocialIcon({ icon }: { icon: string }) {\n const IconComponent = socialIcons[icon as keyof typeof socialIcons] ?? GithubIcon\n return <IconComponent size={20} />\n}\n","import { useState, useEffect } from \"react\"\nimport { SunIcon, MoonIcon, MonitorIcon } from \"../icons\"\n\ntype Theme = \"light\" | \"dark\" | \"system\"\n\nexport function ThemeToggle() {\n const [theme, setTheme] = useState<Theme>(\"system\")\n const [mounted, setMounted] = useState(false)\n\n useEffect(() => {\n setMounted(true)\n\n const stored = localStorage.getItem(\"ardo-theme\") as Theme | null\n if (stored) {\n setTheme(stored)\n applyTheme(stored)\n } else {\n applyTheme(\"system\")\n }\n }, [])\n\n const toggleTheme = () => {\n const nextTheme: Theme = theme === \"light\" ? \"dark\" : theme === \"dark\" ? \"system\" : \"light\"\n setTheme(nextTheme)\n localStorage.setItem(\"ardo-theme\", nextTheme)\n applyTheme(nextTheme)\n }\n\n if (!mounted) {\n return (\n <button className=\"ardo-theme-toggle\" aria-label=\"Toggle theme\">\n <span className=\"ardo-theme-icon\">\n <SunIcon size={20} />\n </span>\n </button>\n )\n }\n\n return (\n <button\n className=\"ardo-theme-toggle\"\n onClick={toggleTheme}\n aria-label={`Switch to ${theme === \"light\" ? \"dark\" : theme === \"dark\" ? \"system\" : \"light\"} theme`}\n >\n <span className=\"ardo-theme-icon\">\n {theme === \"light\" && <SunIcon size={20} />}\n {theme === \"dark\" && <MoonIcon size={20} />}\n {theme === \"system\" && <MonitorIcon size={20} />}\n </span>\n </button>\n )\n}\n\nfunction applyTheme(theme: Theme) {\n const root = document.documentElement\n\n if (theme === \"system\") {\n const isDark = window.matchMedia(\"(prefers-color-scheme: dark)\").matches\n root.classList.toggle(\"dark\", isDark)\n root.classList.toggle(\"light\", !isDark)\n } else {\n root.classList.toggle(\"dark\", theme === \"dark\")\n root.classList.toggle(\"light\", theme === \"light\")\n }\n}\n","import {\n useState,\n type ReactNode,\n type ComponentProps,\n Children,\n isValidElement,\n createContext,\n useContext,\n} from \"react\"\nimport { NavLink, useLocation } from \"react-router\"\nimport { ChevronDownIcon } from \"./icons\"\nimport type { SidebarItem as SidebarItemType } from \"../config/types\"\nimport { useSidebar } from \"../runtime/hooks\"\n\n/** Route path type - uses React Router's NavLink 'to' prop type for type-safe routes */\ntype RoutePath = ComponentProps<typeof NavLink>[\"to\"]\n\n// =============================================================================\n// Sidebar Context\n// =============================================================================\n\ninterface SidebarContextValue {\n currentPath: string\n}\n\nconst SidebarContext = createContext<SidebarContextValue>({ currentPath: \"\" })\n\nfunction useSidebarContext() {\n return useContext(SidebarContext)\n}\n\n// =============================================================================\n// Sidebar Component Types\n// =============================================================================\n\nexport interface SidebarProps {\n /** Sidebar items (for data-driven approach) */\n items?: SidebarItemType[]\n /** Children for JSX composition (SidebarGroup, SidebarLink) */\n children?: ReactNode\n /** Additional CSS classes */\n className?: string\n}\n\n// =============================================================================\n// Sidebar Main Component\n// =============================================================================\n\n/**\n * Sidebar component supporting data-driven, JSX composition, and zero-config patterns.\n *\n * When neither `items` nor `children` are provided, automatically renders from\n * the Ardo sidebar context (`virtual:ardo/sidebar`).\n *\n * @example Zero-config (from context)\n * ```tsx\n * <Sidebar />\n * ```\n *\n * @example Data-driven (items prop)\n * ```tsx\n * <Sidebar items={[\n * { text: 'Introduction', link: '/intro' },\n * { text: 'Guide', items: [\n * { text: 'Getting Started', link: '/guide/getting-started' }\n * ]}\n * ]} />\n * ```\n *\n * @example JSX composition\n * ```tsx\n * <Sidebar>\n * <SidebarLink to=\"/intro\">Introduction</SidebarLink>\n * <SidebarGroup title=\"Guide\">\n * <SidebarLink to=\"/guide/getting-started\">Getting Started</SidebarLink>\n * </SidebarGroup>\n * </Sidebar>\n * ```\n */\nexport function Sidebar({ items, children, className }: SidebarProps) {\n const { pathname } = useLocation()\n const contextSidebar = useSidebar()\n const resolvedItems = items ?? (children ? undefined : contextSidebar)\n\n return (\n <SidebarContext.Provider value={{ currentPath: pathname }}>\n <aside className={className ?? \"ardo-sidebar\"}>\n <nav className=\"ardo-sidebar-nav\" aria-label=\"Main navigation\">\n {children ? (\n <ul className=\"ardo-sidebar-list ardo-sidebar-list-0\">{children}</ul>\n ) : resolvedItems?.length ? (\n <SidebarItems items={resolvedItems} depth={0} />\n ) : null}\n </nav>\n </aside>\n </SidebarContext.Provider>\n )\n}\n\n// =============================================================================\n// SidebarGroup Component\n// =============================================================================\n\nexport interface SidebarGroupProps {\n /** Group title */\n title: string\n /** Optional link for the group title */\n to?: string\n /** Initial collapsed state (default: false) */\n collapsed?: boolean\n /** Whether group is collapsible (default: true if has children) */\n collapsible?: boolean\n /** Children (SidebarLink, nested SidebarGroup) */\n children?: ReactNode\n /** Additional CSS classes */\n className?: string\n}\n\n/**\n * Group component for organizing sidebar links.\n *\n * @example\n * ```tsx\n * <SidebarGroup title=\"Guide\">\n * <SidebarLink to=\"/guide/intro\">Introduction</SidebarLink>\n * <SidebarLink to=\"/guide/setup\">Setup</SidebarLink>\n * </SidebarGroup>\n * ```\n *\n * @example With collapsible state\n * ```tsx\n * <SidebarGroup title=\"Advanced\" collapsed>\n * <SidebarLink to=\"/advanced/config\">Configuration</SidebarLink>\n * </SidebarGroup>\n * ```\n */\nexport function SidebarGroup({\n title,\n to,\n collapsed: initialCollapsed = false,\n collapsible = true,\n children,\n className,\n}: SidebarGroupProps) {\n const [collapsed, setCollapsed] = useState(initialCollapsed)\n const { currentPath } = useSidebarContext()\n\n // Check if any child is active\n const isChildActive = checkChildrenActive(children, currentPath)\n\n const textClassName = [\"ardo-sidebar-text\", isChildActive && \"child-active\"]\n .filter(Boolean)\n .join(\" \")\n\n const hasChildren = Children.count(children) > 0\n\n return (\n <li className={className ?? \"ardo-sidebar-item\"}>\n <div className=\"ardo-sidebar-item-header\">\n {to ? (\n <NavLink\n to={to}\n end\n className={({ isActive }) =>\n [textClassName, isActive && \"active\"].filter(Boolean).join(\" \")\n }\n >\n {title}\n </NavLink>\n ) : (\n <span\n className={textClassName}\n onClick={() => collapsible && hasChildren && setCollapsed(!collapsed)}\n style={collapsible && hasChildren ? { cursor: \"pointer\" } : undefined}\n >\n {title}\n </span>\n )}\n\n {collapsible && hasChildren && (\n <button\n className={[\"ardo-sidebar-collapse\", collapsed && \"collapsed\"]\n .filter(Boolean)\n .join(\" \")}\n onClick={() => setCollapsed(!collapsed)}\n aria-label={collapsed ? \"Expand\" : \"Collapse\"}\n >\n <ChevronDownIcon size={16} />\n </button>\n )}\n </div>\n\n {hasChildren && !collapsed && (\n <ul className=\"ardo-sidebar-list ardo-sidebar-list-1\">{children}</ul>\n )}\n </li>\n )\n}\n\n// =============================================================================\n// SidebarLink Component\n// =============================================================================\n\nexport interface SidebarLinkProps {\n /** Internal route path (type-safe with React Router's registered routes) */\n to: RoutePath\n /** Link text */\n children: ReactNode\n /** Additional CSS classes */\n className?: string\n}\n\n/**\n * Sidebar navigation link.\n *\n * @example\n * ```tsx\n * <SidebarLink to=\"/guide/getting-started\">Getting Started</SidebarLink>\n * ```\n */\nexport function SidebarLink({ to, children, className }: SidebarLinkProps) {\n const baseClassName = className ?? \"ardo-sidebar-link\"\n return (\n <li className=\"ardo-sidebar-item\">\n <NavLink\n to={to}\n className={({ isActive }) =>\n [baseClassName, isActive && \"active\"].filter(Boolean).join(\" \")\n }\n >\n {children}\n </NavLink>\n </li>\n )\n}\n\n// =============================================================================\n// Internal: Data-driven sidebar rendering\n// =============================================================================\n\ninterface SidebarItemsProps {\n items: SidebarItemType[]\n depth: number\n}\n\nfunction SidebarItems({ items, depth }: SidebarItemsProps) {\n return (\n <ul className={`ardo-sidebar-list ardo-sidebar-list-${depth}`}>\n {items.map((item, index) => (\n <SidebarItemComponent key={index} item={item} depth={depth} />\n ))}\n </ul>\n )\n}\n\ninterface SidebarItemComponentProps {\n item: SidebarItemType\n depth: number\n}\n\nfunction SidebarItemComponent({ item, depth }: SidebarItemComponentProps) {\n const { currentPath } = useSidebarContext()\n const [collapsed, setCollapsed] = useState(item.collapsed ?? false)\n\n const hasChildren = item.items && item.items.length > 0\n\n const isChildActive =\n hasChildren &&\n item.items!.some(\n (child) =>\n child.link === currentPath ||\n (child.items && child.items.some((grandchild) => grandchild.link === currentPath))\n )\n\n const linkClassName = [\"ardo-sidebar-link\", isChildActive && \"child-active\"]\n .filter(Boolean)\n .join(\" \")\n\n const textClassName = [\"ardo-sidebar-text\", isChildActive && \"child-active\"]\n .filter(Boolean)\n .join(\" \")\n\n return (\n <li className=\"ardo-sidebar-item\">\n <div className=\"ardo-sidebar-item-header\">\n {item.link ? (\n <NavLink\n to={item.link}\n className={({ isActive }) =>\n [linkClassName, isActive && \"active\"].filter(Boolean).join(\" \")\n }\n >\n {item.text}\n </NavLink>\n ) : (\n <span className={textClassName} onClick={() => hasChildren && setCollapsed(!collapsed)}>\n {item.text}\n </span>\n )}\n\n {hasChildren && (\n <button\n className={[\"ardo-sidebar-collapse\", collapsed && \"collapsed\"]\n .filter(Boolean)\n .join(\" \")}\n onClick={() => setCollapsed(!collapsed)}\n aria-label={collapsed ? \"Expand\" : \"Collapse\"}\n >\n <ChevronDownIcon size={16} />\n </button>\n )}\n </div>\n\n {hasChildren && !collapsed && <SidebarItems items={item.items!} depth={depth + 1} />}\n </li>\n )\n}\n\n// =============================================================================\n// Utility Functions\n// =============================================================================\n\nfunction checkChildrenActive(children: ReactNode, currentPath: string): boolean {\n let isActive = false\n\n Children.forEach(children, (child) => {\n if (isActive) return\n\n if (isValidElement(child)) {\n // Check SidebarLink\n if (child.type === SidebarLink && (child.props as SidebarLinkProps).to === currentPath) {\n isActive = true\n return\n }\n\n // Check nested SidebarGroup\n if (child.type === SidebarGroup) {\n const groupProps = child.props as SidebarGroupProps\n if (groupProps.to === currentPath) {\n isActive = true\n return\n }\n if (groupProps.children && checkChildrenActive(groupProps.children, currentPath)) {\n isActive = true\n return\n }\n }\n }\n })\n\n return isActive\n}\n","import { type ReactNode } from \"react\"\nimport type { ProjectMeta, SponsorConfig } from \"../config/types\"\nimport { useConfig, useThemeConfig } from \"../runtime/hooks\"\n\n// =============================================================================\n// Footer Component\n// =============================================================================\n\nexport interface FooterProps {\n /** Footer message (supports HTML string) */\n message?: string\n /** Copyright text (supports HTML string) */\n copyright?: string\n /** Custom content (overrides all automatic rendering) */\n children?: ReactNode\n /** Additional CSS classes */\n className?: string\n /** Project metadata — renders linked \"name vX.Y.Z\" */\n project?: ProjectMeta\n /** Sponsor link — renders \"Sponsored by X\" */\n sponsor?: SponsorConfig\n /** Build timestamp (ISO string) — renders formatted date */\n buildTime?: string\n /** Git commit hash — rendered next to the build date */\n buildHash?: string\n /** Show \"Built with Ardo\" link (default: true) */\n ardoLink?: boolean\n}\n\nfunction formatBuildTime(iso: string): string {\n try {\n const date = new Date(iso)\n return date.toLocaleDateString(\"en-US\", {\n month: \"long\",\n day: \"numeric\",\n year: \"numeric\",\n })\n } catch {\n return iso\n }\n}\n\n/**\n * Footer component with structured layout for project info, sponsor, and build metadata.\n *\n * Automatically pulls data from Ardo context (`config.project`, `config.buildTime`,\n * `config.buildHash`, `themeConfig.footer.*`). Props serve as overrides.\n *\n * When `children` is provided, all automatic rendering is skipped.\n *\n * @example Automatic (zero-config)\n * ```tsx\n * <Footer />\n * ```\n *\n * @example With overrides\n * ```tsx\n * <Footer\n * sponsor={{ text: \"Sebastian Software\", link: \"https://sebastian-software.com/oss\" }}\n * message=\"Released under the MIT License.\"\n * copyright=\"Copyright 2026 Sebastian Software GmbH\"\n * />\n * ```\n *\n * @example Custom content\n * ```tsx\n * <Footer>\n * <CustomFooterContent />\n * </Footer>\n * ```\n */\nexport function Footer({\n message,\n copyright,\n children,\n className,\n project,\n sponsor,\n buildTime,\n buildHash,\n ardoLink = true,\n}: FooterProps) {\n const config = useConfig()\n const themeConfig = useThemeConfig()\n\n const resolvedProject = project ?? config.project\n const resolvedBuildTime = buildTime ?? config.buildTime\n const resolvedBuildHash = buildHash ?? config.buildHash\n const resolvedMessage = message ?? themeConfig.footer?.message\n const resolvedCopyright = copyright ?? themeConfig.footer?.copyright\n const resolvedSponsor = sponsor ?? themeConfig.footer?.sponsor\n\n const hasContent =\n resolvedMessage ||\n resolvedCopyright ||\n children ||\n resolvedProject ||\n resolvedSponsor ||\n resolvedBuildTime ||\n ardoLink\n\n if (!hasContent) {\n return null\n }\n\n return (\n <footer className={className ?? \"ardo-footer\"}>\n <div className=\"ardo-footer-container\">\n {children ?? (\n <>\n {/* Primary line: project · ardo · sponsor */}\n {(resolvedProject || ardoLink || resolvedSponsor) && (\n <p className=\"ardo-footer-primary\">\n {resolvedProject?.name && (\n <>\n {resolvedProject.homepage ? (\n <a href={resolvedProject.homepage} className=\"ardo-footer-link\">\n {resolvedProject.name}\n {resolvedProject.version ? ` v${resolvedProject.version}` : \"\"}\n </a>\n ) : (\n <span>\n {resolvedProject.name}\n {resolvedProject.version ? ` v${resolvedProject.version}` : \"\"}\n </span>\n )}\n </>\n )}\n {resolvedProject?.name && ardoLink && (\n <span className=\"ardo-footer-separator\" aria-hidden=\"true\" />\n )}\n {ardoLink && (\n <a href=\"https://ardo-docs.dev\" className=\"ardo-footer-link\">\n Built with Ardo\n </a>\n )}\n {(resolvedProject?.name || ardoLink) && resolvedSponsor && (\n <span className=\"ardo-footer-separator\" aria-hidden=\"true\" />\n )}\n {resolvedSponsor && (\n <a href={resolvedSponsor.link} className=\"ardo-footer-link\">\n Sponsored by {resolvedSponsor.text}\n </a>\n )}\n </p>\n )}\n {/* Secondary line: message / copyright */}\n {resolvedMessage && (\n <p\n className=\"ardo-footer-message\"\n dangerouslySetInnerHTML={{ __html: resolvedMessage }}\n />\n )}\n {resolvedCopyright && (\n <p\n className=\"ardo-footer-copyright\"\n dangerouslySetInnerHTML={{ __html: resolvedCopyright }}\n />\n )}\n {/* Tertiary line: build timestamp */}\n {resolvedBuildTime && (\n <p className=\"ardo-footer-build-time\">\n Built on {formatBuildTime(resolvedBuildTime)}\n {resolvedBuildHash && <> ({resolvedBuildHash})</>}\n </p>\n )}\n </>\n )}\n </div>\n </footer>\n )\n}\n\n// Type exports for compound pattern (kept for backwards compatibility)\nexport interface FooterMessageProps {\n children: ReactNode\n className?: string\n}\n\nexport interface FooterCopyrightProps {\n children: ReactNode\n className?: string\n}\n","import { type ReactNode, type ComponentProps, useState, createContext, useContext } from \"react\"\nimport { NavLink as RouterNavLink } from \"react-router\"\n\n/** Route path type - uses React Router's NavLink 'to' prop type for type-safe routes */\ntype RoutePath = ComponentProps<typeof RouterNavLink>[\"to\"]\n\n// Nav context for shared state\ninterface NavContextValue {\n mobileMenuOpen: boolean\n setMobileMenuOpen: (open: boolean) => void\n}\n\nconst NavContext = createContext<NavContextValue | null>(null)\n\nfunction useNavContext() {\n return useContext(NavContext)\n}\n\n// =============================================================================\n// Nav Component\n// =============================================================================\n\nexport interface NavProps {\n children?: ReactNode\n className?: string\n}\n\n/**\n * Navigation container component for composing navigation links.\n *\n * @example\n * ```tsx\n * <Nav>\n * <NavLink to=\"/guide\">Guide</NavLink>\n * <NavLink to=\"/api\">API</NavLink>\n * <NavLink href=\"https://github.com/...\">GitHub</NavLink>\n * </Nav>\n * ```\n */\nexport function Nav({ children, className }: NavProps) {\n return <nav className={className ?? \"ardo-nav\"}>{children}</nav>\n}\n\n// =============================================================================\n// NavLink Component\n// =============================================================================\n\nexport interface NavLinkProps {\n /** Internal route path (type-safe with React Router's registered routes) */\n to?: RoutePath\n /** External URL (uses anchor tag) */\n href?: string\n /** Link text or children */\n children: ReactNode\n /** Additional CSS classes */\n className?: string\n /** Active state match pattern */\n activeMatch?: string\n}\n\n/**\n * Navigation link component supporting both internal routes and external URLs.\n *\n * @example\n * ```tsx\n * // Internal link\n * <NavLink to=\"/guide\">Guide</NavLink>\n *\n * // External link\n * <NavLink href=\"https://github.com/...\">GitHub</NavLink>\n * ```\n */\nexport function NavLink({\n to,\n href,\n children,\n className,\n activeMatch: _activeMatch,\n}: NavLinkProps) {\n const navContext = useNavContext()\n const baseClassName = className ?? \"ardo-nav-link\"\n\n // Handle click for mobile menu\n const handleClick = () => {\n navContext?.setMobileMenuOpen(false)\n }\n\n // External link\n if (href) {\n return (\n <a\n href={href}\n className={baseClassName}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n onClick={handleClick}\n >\n {children}\n </a>\n )\n }\n\n // Internal link\n if (to) {\n return (\n <RouterNavLink\n to={to}\n className={({ isActive }: { isActive: boolean }) =>\n [baseClassName, isActive && \"active\"].filter(Boolean).join(\" \")\n }\n onClick={handleClick}\n >\n {children}\n </RouterNavLink>\n )\n }\n\n // Text-only (no link)\n return <span className={baseClassName}>{children}</span>\n}\n\n// =============================================================================\n// NavDropdown Component\n// =============================================================================\n\nexport interface NavDropdownProps {\n /** Dropdown trigger text */\n text: string\n /** Dropdown items */\n children: ReactNode\n /** Additional CSS classes */\n className?: string\n}\n\n/**\n * Dropdown navigation menu for grouping related links.\n *\n * @example\n * ```tsx\n * <NavDropdown text=\"Resources\">\n * <NavLink to=\"/docs\">Documentation</NavLink>\n * <NavLink to=\"/blog\">Blog</NavLink>\n * </NavDropdown>\n * ```\n */\nexport function NavDropdown({ text, children, className }: NavDropdownProps) {\n const [open, setOpen] = useState(false)\n\n return (\n <div\n className={className ?? \"ardo-nav-dropdown\"}\n onMouseEnter={() => setOpen(true)}\n onMouseLeave={() => setOpen(false)}\n >\n <button className=\"ardo-nav-dropdown-button\">\n {text}\n <span className=\"ardo-nav-dropdown-icon\">▼</span>\n </button>\n {open && <div className=\"ardo-nav-dropdown-menu\">{children}</div>}\n </div>\n )\n}\n\n// =============================================================================\n// NavProvider Component\n// =============================================================================\n\nexport interface NavProviderProps {\n children: ReactNode\n}\n\n/**\n * Provider for Nav context (mobile menu state).\n * Used internally by Header component.\n */\nexport function NavProvider({ children }: NavProviderProps) {\n const [mobileMenuOpen, setMobileMenuOpen] = useState(false)\n\n return (\n <NavContext.Provider value={{ mobileMenuOpen, setMobileMenuOpen }}>\n {children}\n </NavContext.Provider>\n )\n}\n\n// Export context hook for external use\nexport { useNavContext }\n","import { useState, useEffect } from \"react\"\nimport { useTOC, useThemeConfig } from \"../runtime/hooks\"\nimport type { TOCItem } from \"../config/types\"\n\nexport function TOC() {\n const toc = useTOC()\n const themeConfig = useThemeConfig()\n const [activeId, setActiveId] = useState<string>(\"\")\n\n const label = themeConfig.outline?.label ?? \"On this page\"\n\n useEffect(() => {\n if (toc.length === 0) return\n\n const headingElements = toc.map((item) => document.getElementById(item.id)).filter(Boolean)\n\n if (headingElements.length === 0) return\n\n const observer = new IntersectionObserver(\n (entries) => {\n for (const entry of entries) {\n if (entry.isIntersecting) {\n setActiveId(entry.target.id)\n break\n }\n }\n },\n {\n rootMargin: \"-80px 0px -80% 0px\",\n threshold: 0,\n }\n )\n\n headingElements.forEach((el) => el && observer.observe(el))\n\n return () => {\n headingElements.forEach((el) => el && observer.unobserve(el))\n }\n }, [toc])\n\n if (toc.length === 0) {\n return null\n }\n\n return (\n <aside className=\"ardo-toc\">\n <div className=\"ardo-toc-container\">\n <h3 className=\"ardo-toc-title\">{label}</h3>\n <nav className=\"ardo-toc-nav\" aria-label=\"Table of contents\">\n <TOCItems items={toc} activeId={activeId} />\n </nav>\n </div>\n </aside>\n )\n}\n\ninterface TOCItemsProps {\n items: TOCItem[]\n activeId: string\n}\n\nfunction TOCItems({ items, activeId }: TOCItemsProps) {\n return (\n <ul className=\"ardo-toc-list\">\n {items.map((item) => (\n <TOCItemComponent key={item.id} item={item} activeId={activeId} />\n ))}\n </ul>\n )\n}\n\ninterface TOCItemComponentProps {\n item: TOCItem\n activeId: string\n}\n\nfunction TOCItemComponent({ item, activeId }: TOCItemComponentProps) {\n const isActive = item.id === activeId\n const hasActiveChild = hasActiveDescendant(item, activeId)\n\n return (\n <li className=\"ardo-toc-item\">\n <a\n href={`#${item.id}`}\n className={[\n `ardo-toc-link ardo-toc-link-${item.level}`,\n isActive && \"active\",\n hasActiveChild && \"child-active\",\n ]\n .filter(Boolean)\n .join(\" \")}\n onClick={(e) => {\n e.preventDefault()\n const element = document.getElementById(item.id)\n if (element) {\n element.scrollIntoView({ behavior: \"smooth\" })\n window.history.pushState(null, \"\", `#${item.id}`)\n }\n }}\n >\n {item.text}\n </a>\n {item.children && item.children.length > 0 && (\n <TOCItems items={item.children} activeId={activeId} />\n )}\n </li>\n )\n}\n\nfunction hasActiveDescendant(item: TOCItem, activeId: string): boolean {\n if (!item.children) return false\n\n for (const child of item.children) {\n if (child.id === activeId) return true\n if (hasActiveDescendant(child, activeId)) return true\n }\n\n return false\n}\n","import { type ReactNode } from \"react\"\nimport { usePageData } from \"../runtime/hooks\"\nimport { Layout } from \"./Layout\"\nimport { Content } from \"./Content\"\nimport { TOC } from \"./TOC\"\n\n// =============================================================================\n// DocPage Component (includes Layout - for backwards compatibility)\n// =============================================================================\n\ninterface DocPageProps {\n children: ReactNode\n}\n\n/**\n * Full documentation page with Layout wrapper.\n * Use this when you don't have a _layout.tsx file.\n *\n * @example\n * ```tsx\n * <DocPage>\n * <Content />\n * </DocPage>\n * ```\n */\nexport function DocPage({ children }: DocPageProps) {\n const pageData = usePageData()\n const showToc =\n pageData?.frontmatter.outline !== false && pageData?.toc && pageData.toc.length > 0\n\n return (\n <Layout>\n <div className=\"ardo-doc-page\">\n <Content>{children}</Content>\n {showToc && <TOC />}\n </div>\n </Layout>\n )\n}\n\n// =============================================================================\n// DocContent Component (without Layout - for use with _layout.tsx)\n// =============================================================================\n\ninterface DocContentProps {\n children: ReactNode\n}\n\n/**\n * Documentation content without Layout wrapper.\n * Use this when you have a _layout.tsx that provides the Layout.\n *\n * @example\n * ```tsx\n * // In _layout.tsx:\n * <Layout>\n * <Header ... />\n * <Sidebar ... />\n * <Outlet />\n * <Footer ... />\n * </Layout>\n *\n * // In page routes:\n * <DocContent>\n * <MarkdownContent />\n * </DocContent>\n * ```\n */\nexport function DocContent({ children }: DocContentProps) {\n const pageData = usePageData()\n const showToc =\n pageData?.frontmatter.outline !== false && pageData?.toc && pageData.toc.length > 0\n\n return (\n <div className=\"ardo-doc-page\">\n <Content>{children}</Content>\n {showToc && <TOC />}\n </div>\n )\n}\n\n// =============================================================================\n// DocLayout Component (legacy alias)\n// =============================================================================\n\ninterface DocLayoutProps {\n content: ReactNode\n}\n\n/**\n * @deprecated Use DocPage or DocContent instead\n */\nexport function DocLayout({ content }: DocLayoutProps) {\n return <DocPage>{content}</DocPage>\n}\n","import { Link } from \"react-router\"\nimport { usePageData, useConfig, useThemeConfig } from \"../runtime/hooks\"\nimport { Header, SocialLink } from \"./Header\"\nimport { Footer } from \"./Footer\"\nimport { Nav, NavLink } from \"./Nav\"\n\nexport function HomePage() {\n const pageData = usePageData()\n const config = useConfig()\n const themeConfig = useThemeConfig()\n\n const hero = pageData?.frontmatter.hero\n const features = pageData?.frontmatter.features\n\n return (\n <div className=\"ardo-home\">\n <Header\n logo={themeConfig.logo}\n title={themeConfig.siteTitle !== false ? config.title : undefined}\n nav={\n themeConfig.nav && themeConfig.nav.length > 0 ? (\n <Nav>\n {themeConfig.nav.map((item, index) => (\n <NavLink key={index} to={item.link}>\n {item.text}\n </NavLink>\n ))}\n </Nav>\n ) : undefined\n }\n actions={themeConfig.socialLinks?.map((link, index) => (\n <SocialLink key={index} href={link.link} icon={link.icon} ariaLabel={link.ariaLabel} />\n ))}\n />\n\n <main className=\"ardo-home-main\">\n {hero && (\n <section className=\"ardo-hero\">\n <div className=\"ardo-hero-container\">\n {hero.image && (\n <div className=\"ardo-hero-image\">\n <img\n src={typeof hero.image === \"string\" ? hero.image : hero.image.light}\n alt={hero.name || config.title}\n />\n </div>\n )}\n\n <div className=\"ardo-hero-content\">\n {hero.name && <h1 className=\"ardo-hero-name\">{hero.name}</h1>}\n {hero.text && <p className=\"ardo-hero-text\">{hero.text}</p>}\n {hero.tagline && <p className=\"ardo-hero-tagline\">{hero.tagline}</p>}\n\n {hero.actions && hero.actions.length > 0 && (\n <div className=\"ardo-hero-actions\">\n {hero.actions.map((action, index) => (\n <Link\n key={index}\n to={action.link}\n className={`ardo-hero-action ardo-hero-action-${action.theme || \"brand\"}`}\n >\n {action.text}\n </Link>\n ))}\n </div>\n )}\n </div>\n </div>\n </section>\n )}\n\n {features && features.length > 0 && (\n <section className=\"ardo-features\">\n <div className=\"ardo-features-container\">\n {features.map((feature, index) => (\n <div key={index} className=\"ardo-feature\">\n {feature.icon && <div className=\"ardo-feature-icon\">{feature.icon}</div>}\n <h3 className=\"ardo-feature-title\">{feature.title}</h3>\n <p className=\"ardo-feature-details\">{feature.details}</p>\n {feature.link && (\n <Link to={feature.link} className=\"ardo-feature-link\">\n {feature.linkText || \"Learn more\"}\n </Link>\n )}\n </div>\n ))}\n </div>\n </section>\n )}\n </main>\n\n <Footer />\n </div>\n )\n}\n","import { type ComponentProps, type ReactNode } from \"react\"\nimport { Link } from \"react-router\"\n\n/** Internal route path from React Router */\ntype RoutePath = ComponentProps<typeof Link>[\"to\"]\n\n/** External URL starting with http:// or https:// */\ntype ExternalUrl = `http://${string}` | `https://${string}`\n\nexport interface HeroAction {\n /** Button text */\n text: string\n /** Link destination - internal route path or external URL */\n link: RoutePath | ExternalUrl\n /** Visual theme: \"brand\" for primary, \"alt\" for secondary */\n theme?: \"brand\" | \"alt\"\n /** Optional icon as ReactNode (e.g. Lucide icon component) */\n icon?: ReactNode\n}\n\nexport interface HeroImage {\n /** Image for light mode */\n light: string\n /** Image for dark mode */\n dark?: string\n /** Alt text for the image */\n alt?: string\n}\n\nexport interface HeroProps {\n /** Large title displayed prominently */\n name?: string\n /** Secondary text below the name */\n text?: string\n /** Descriptive tagline */\n tagline?: string\n /** Hero image - can be a string URL or an object with light/dark variants */\n image?: string | HeroImage\n /** Call-to-action buttons */\n actions?: HeroAction[]\n /** Additional CSS class */\n className?: string\n /** Version string displayed as a pill badge above the name */\n version?: string\n}\n\n/**\n * Hero section component for landing pages.\n *\n * @example\n * ```tsx\n * import { ArrowRight, Github } from \"lucide-react\"\n *\n * <Hero\n * name=\"Ardo\"\n * text=\"React-first Documentation\"\n * tagline=\"Build beautiful documentation sites with React.\"\n * image=\"/logo.svg\"\n * actions={[\n * { text: \"Get Started\", link: \"/guide/getting-started\", theme: \"brand\", icon: <ArrowRight size={16} /> },\n * { text: \"GitHub\", link: \"https://github.com/...\", theme: \"alt\", icon: <Github size={16} /> }\n * ]}\n * />\n * ```\n */\nexport function Hero({ name, text, tagline, image, actions, className, version }: HeroProps) {\n const imageUrl = typeof image === \"string\" ? image : image?.light\n const imageAlt = typeof image === \"string\" ? name : (image?.alt ?? name)\n\n return (\n <section className={className ?? \"ardo-hero\"}>\n <div className=\"ardo-hero-container ardo-hero-animate\">\n {image && (\n <div className=\"ardo-hero-image\">\n <img src={imageUrl} alt={imageAlt} />\n </div>\n )}\n\n <div className=\"ardo-hero-content\">\n {version && <span className=\"ardo-hero-version\">v{version}</span>}\n {name && <h1 className=\"ardo-hero-name\">{name}</h1>}\n {text && <p className=\"ardo-hero-text\">{text}</p>}\n {tagline && <p className=\"ardo-hero-tagline\">{tagline}</p>}\n\n {actions && actions.length > 0 && (\n <div className=\"ardo-hero-actions\">\n {actions.map((action, index) => {\n const link = action.link\n const isExternal =\n typeof link === \"string\" &&\n (link.startsWith(\"http://\") || link.startsWith(\"https://\"))\n const className = `ardo-hero-action ardo-hero-action-${action.theme || \"brand\"}`\n\n const content = (\n <>\n {action.icon}\n {action.text}\n </>\n )\n\n if (isExternal) {\n return (\n <a\n key={index}\n href={link}\n className={className}\n target=\"_blank\"\n rel=\"noopener noreferrer\"\n >\n {content}\n </a>\n )\n }\n\n return (\n <Link key={index} to={link} className={className}>\n {content}\n </Link>\n )\n })}\n </div>\n )}\n </div>\n </div>\n </section>\n )\n}\n","import { Link } from \"react-router\"\nimport type { CSSProperties, ReactNode } from \"react\"\n\nexport interface FeatureItem {\n /** Feature title */\n title: string\n /** Icon as ReactNode (emoji, Lucide icon component, or any JSX) */\n icon?: ReactNode\n /** Feature description */\n details: string\n /** Optional link */\n link?: string\n /** Link text (defaults to \"Learn more\") */\n linkText?: string\n}\n\nexport interface FeaturesProps {\n /** Array of feature items to display */\n items: FeatureItem[]\n /** Section title */\n title?: string\n /** Section subtitle */\n subtitle?: string\n /** Additional CSS class */\n className?: string\n}\n\nexport interface FeatureCardProps extends FeatureItem {\n /** Additional CSS class */\n className?: string\n}\n\n/**\n * Individual feature card component.\n *\n * @example\n * ```tsx\n * import { Zap } from \"lucide-react\"\n *\n * // Using emoji\n * <FeatureCard title=\"Fast\" icon=\"⚡\" details=\"Lightning fast.\" />\n *\n * // Using Lucide icon (tree-shakeable)\n * <FeatureCard title=\"Fast\" icon={<Zap size={28} />} details=\"Lightning fast.\" />\n * ```\n */\nexport function FeatureCard({\n title,\n icon,\n details,\n link,\n linkText,\n className,\n style,\n}: FeatureCardProps & { style?: CSSProperties }) {\n return (\n <div className={className ?? \"ardo-feature\"} style={style}>\n {icon && <div className=\"ardo-feature-icon\">{icon}</div>}\n <h3 className=\"ardo-feature-title\">{title}</h3>\n <p className=\"ardo-feature-details\">{details}</p>\n {link && (\n <Link to={link} className=\"ardo-feature-link\">\n {linkText || \"Learn more\"}\n </Link>\n )}\n </div>\n )\n}\n\n/**\n * Features grid component for displaying multiple feature cards.\n *\n * @example\n * ```tsx\n * <Features\n * title=\"Key Features\"\n * subtitle=\"Everything you need to build great docs\"\n * items={[\n * { title: \"React-First\", icon: \"⚛️\", details: \"Built on React.\" },\n * { title: \"Fast\", icon: \"⚡\", details: \"Powered by Vite.\" },\n * { title: \"Type-Safe\", icon: \"📝\", details: \"Full TypeScript support.\" },\n * ]}\n * />\n * ```\n */\nexport function Features({ items, title, subtitle, className }: FeaturesProps) {\n if (!items || items.length === 0) {\n return null\n }\n\n return (\n <section className={className ?? \"ardo-features\"}>\n {(title || subtitle) && (\n <div className=\"ardo-features-header\">\n {title && <h2 className=\"ardo-features-title\">{title}</h2>}\n {subtitle && <p className=\"ardo-features-subtitle\">{subtitle}</p>}\n </div>\n )}\n <div className=\"ardo-features-container\">\n {items.map((feature, index) => (\n <FeatureCard key={index} {...feature} style={{ animationDelay: `${index * 80}ms` }} />\n ))}\n </div>\n </section>\n )\n}\n","import { type ReactNode } from \"react\"\n\nexport interface StepsProps {\n /** Content to display — expects an ordered list (`<ol>`) from MDX */\n children: ReactNode\n}\n\n/**\n * A wrapper for ordered lists that renders numbered step indicators.\n *\n * @example\n * ```mdx\n * <Steps>\n * 1. Install the package\n * 2. Configure your site\n * 3. Start writing\n * </Steps>\n * ```\n */\nexport function Steps({ children }: StepsProps) {\n return <div className=\"ardo-steps\">{children}</div>\n}\n","import {\n type ReactNode,\n type ReactElement,\n type HTMLAttributes,\n Children,\n isValidElement,\n cloneElement,\n} from \"react\"\n\nexport interface FileTreeProps {\n /** Content to display — expects an unordered list (`<ul>`) from MDX */\n children: ReactNode\n}\n\n/**\n * Extracts text content from nested React nodes.\n */\nfunction getTextContent(node: ReactNode): string {\n if (typeof node === \"string\") return node\n if (typeof node === \"number\") return String(node)\n if (!isValidElement(node)) return \"\"\n const children = (node.props as { children?: ReactNode }).children\n if (!children) return \"\"\n return Children.toArray(children).map(getTextContent).join(\"\")\n}\n\n/**\n * Checks whether a list item represents a directory (text ends with `/`).\n */\nfunction isDirectory(node: ReactElement): boolean {\n const children = (node.props as { children?: ReactNode }).children\n const childArray = Children.toArray(children)\n\n // If the item has a nested <ul>, it's a directory\n for (const child of childArray) {\n if (isValidElement(child) && (child.type === \"ul\" || child.type === \"ol\")) {\n return true\n }\n }\n\n // If text content ends with `/`, it's a directory\n const text = getTextContent(node).trim()\n return text.endsWith(\"/\")\n}\n\n/**\n * Recursively processes `<ul>` / `<li>` children, applying CSS classes\n * for directory vs. file styling.\n */\nfunction processChildren(children: ReactNode): ReactNode {\n return Children.map(children, (child) => {\n if (!isValidElement(child)) return child\n\n const props = child.props as { children?: ReactNode; className?: string }\n\n const el = child as ReactElement<HTMLAttributes<HTMLElement>>\n\n if (child.type === \"li\") {\n const isDir = isDirectory(child)\n const className = [props.className, isDir ? \"ardo-filetree-dir\" : \"ardo-filetree-file\"]\n .filter(Boolean)\n .join(\" \")\n\n return cloneElement(el, { className }, processChildren(props.children))\n }\n\n if (child.type === \"ul\" || child.type === \"ol\") {\n return cloneElement(el, {}, processChildren(props.children))\n }\n\n return child\n })\n}\n\n/**\n * A wrapper for unordered lists that renders a file/folder tree with icons.\n *\n * @example\n * ```mdx\n * <FileTree>\n * - src/\n * - components/\n * - Header.tsx\n * - Footer.tsx\n * - index.ts\n * - package.json\n * - README.md\n * </FileTree>\n * ```\n */\nexport function FileTree({ children }: FileTreeProps) {\n return <div className=\"ardo-filetree\">{processChildren(children)}</div>\n}\n"],"mappings":"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","names":["isValidElement","useLocation","useEffect","useState","jsx","jsxs","jsx","jsxs","useState","useEffect","useState","useContext","useLocation","jsx","jsxs","useContext","useLocation","useState","jsx","jsxs","jsx","useLocation","isValidElement","useState","createContext","useContext","RouterNavLink","jsx","jsxs","NavLink","useState","useEffect","jsx","jsxs","useState","useEffect","jsx","jsxs","Link","jsx","jsxs","NavLink","Link","Link","Fragment","jsx","jsxs","className","Link","jsx","jsxs","jsx","Children","isValidElement","cloneElement","jsx"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,11 +1,8 @@
|
|
|
1
1
|
export { defineConfig, loadConfig, resolveConfig } from './config/index.js';
|
|
2
|
-
export { ArdoPluginOptions, ardo as ardoPlugin, generateSidebar, getPageDataForRoute, getSlugFromPath, loadAllDocs, loadDoc, transformMarkdown, transformMarkdownToReact } from './vite/index.js';
|
|
3
|
-
export { A as ArdoConfig, H as HeadConfig, M as MarkdownConfig, N as NavItem, P as PageData, a as PageFrontmatter, b as ProjectMeta, R as ResolvedConfig, S as SidebarItem, c as SocialLink, T as TOCItem, d as ThemeConfig, e as TypeDocConfig } from './types-CLkHwCch.js';
|
|
4
2
|
export { ArdoProvider, findCurrentSidebarItem, getPrevNextLinks, useArdoContext, useConfig, usePageData, useSidebar, useTOC, useThemeConfig } from './runtime/index.js';
|
|
5
|
-
export { C as CodeBlock, a as CodeBlockProps, b as CodeGroup, c as CodeGroupProps, d as Container, e as ContainerProps, f as ContainerType, g as Content, h as CopyButton, D as Danger, i as DangerProps, j as DocLayout, k as DocPage, F as FeatureCard, l as FeatureCardProps, m as FeatureItem, n as Features, o as FeaturesProps, p as FileTree, q as FileTreeProps, r as Footer, H as Header, s as Hero, t as HeroAction, u as HeroImage, v as HeroProps, w as HomePage, I as Info, x as InfoProps, L as Layout, N as Note, y as NoteProps, S as Search, z as Sidebar, A as Steps, B as StepsProps, T as TOC, E as Tab, G as TabList, J as TabListProps, K as TabPanel, M as TabPanelProps, O as TabPanels, P as TabPanelsProps, Q as TabProps, R as Tabs, U as TabsProps, V as ThemeToggle, W as Tip, X as TipProps, Y as Warning, Z as WarningProps } from './FileTree-
|
|
6
|
-
export {
|
|
7
|
-
import 'vite';
|
|
8
|
-
import 'shiki';
|
|
3
|
+
export { C as CodeBlock, a as CodeBlockProps, b as CodeGroup, c as CodeGroupProps, d as Container, e as ContainerProps, f as ContainerType, g as Content, h as CopyButton, D as Danger, i as DangerProps, j as DocLayout, k as DocPage, F as FeatureCard, l as FeatureCardProps, m as FeatureItem, n as Features, o as FeaturesProps, p as FileTree, q as FileTreeProps, r as Footer, H as Header, s as Hero, t as HeroAction, u as HeroImage, v as HeroProps, w as HomePage, I as Info, x as InfoProps, L as Layout, N as Note, y as NoteProps, S as Search, z as Sidebar, A as Steps, B as StepsProps, T as TOC, E as Tab, G as TabList, J as TabListProps, K as TabPanel, M as TabPanelProps, O as TabPanels, P as TabPanelsProps, Q as TabProps, R as Tabs, U as TabsProps, V as ThemeToggle, W as Tip, X as TipProps, Y as Warning, Z as WarningProps } from './FileTree-qpT1ZVrW.js';
|
|
4
|
+
export { A as ArdoConfig, H as HeadConfig, M as MarkdownConfig, N as NavItem, P as PageData, a as PageFrontmatter, b as ProjectMeta, R as ResolvedConfig, S as SidebarItem, c as SocialLink, T as TOCItem, d as ThemeConfig, e as TypeDocConfig } from './types-CLkHwCch.js';
|
|
9
5
|
import 'react/jsx-runtime';
|
|
10
6
|
import 'react';
|
|
11
7
|
import 'react-router';
|
|
8
|
+
import 'shiki';
|
package/dist/index.js
CHANGED
|
@@ -1,13 +1,3 @@
|
|
|
1
|
-
import {
|
|
2
|
-
ardoPlugin,
|
|
3
|
-
generateSidebar,
|
|
4
|
-
getPageDataForRoute,
|
|
5
|
-
getSlugFromPath,
|
|
6
|
-
loadAllDocs,
|
|
7
|
-
loadDoc,
|
|
8
|
-
transformMarkdown,
|
|
9
|
-
transformMarkdownToReact
|
|
10
|
-
} from "./chunk-TTOK7CO6.js";
|
|
11
1
|
import {
|
|
12
2
|
defineConfig,
|
|
13
3
|
loadConfig,
|
|
@@ -29,24 +19,10 @@ import {
|
|
|
29
19
|
Steps,
|
|
30
20
|
TOC,
|
|
31
21
|
ThemeToggle
|
|
32
|
-
} from "./chunk-
|
|
22
|
+
} from "./chunk-XK7YZAVP.js";
|
|
33
23
|
import {
|
|
34
24
|
Search
|
|
35
25
|
} from "./chunk-BHHI2BO4.js";
|
|
36
|
-
import {
|
|
37
|
-
ApiHierarchy,
|
|
38
|
-
ApiItem,
|
|
39
|
-
ApiKindBadge,
|
|
40
|
-
ApiParametersTable,
|
|
41
|
-
ApiReturns,
|
|
42
|
-
ApiSignature,
|
|
43
|
-
createTypedocWatcher,
|
|
44
|
-
typedocPlugin
|
|
45
|
-
} from "./chunk-Y46KCHBO.js";
|
|
46
|
-
import {
|
|
47
|
-
TypeDocGenerator,
|
|
48
|
-
generateApiDocs
|
|
49
|
-
} from "./chunk-PGHUPTGL.js";
|
|
50
26
|
import {
|
|
51
27
|
CodeBlock,
|
|
52
28
|
CodeGroup,
|
|
@@ -63,7 +39,7 @@ import {
|
|
|
63
39
|
Tabs,
|
|
64
40
|
Tip,
|
|
65
41
|
Warning
|
|
66
|
-
} from "./chunk-
|
|
42
|
+
} from "./chunk-QKDVSW6Q.js";
|
|
67
43
|
import "./chunk-MJQGGJQZ.js";
|
|
68
44
|
import {
|
|
69
45
|
findCurrentSidebarItem,
|
|
@@ -79,12 +55,6 @@ import {
|
|
|
79
55
|
useThemeConfig
|
|
80
56
|
} from "./chunk-QELSOHIY.js";
|
|
81
57
|
export {
|
|
82
|
-
ApiHierarchy,
|
|
83
|
-
ApiItem,
|
|
84
|
-
ApiKindBadge,
|
|
85
|
-
ApiParametersTable,
|
|
86
|
-
ApiReturns,
|
|
87
|
-
ApiSignature,
|
|
88
58
|
ArdoProvider,
|
|
89
59
|
CodeBlock,
|
|
90
60
|
CodeGroup,
|
|
@@ -115,24 +85,12 @@ export {
|
|
|
115
85
|
Tabs,
|
|
116
86
|
ThemeToggle,
|
|
117
87
|
Tip,
|
|
118
|
-
TypeDocGenerator,
|
|
119
88
|
Warning,
|
|
120
|
-
ardoPlugin,
|
|
121
|
-
createTypedocWatcher,
|
|
122
89
|
defineConfig,
|
|
123
90
|
findCurrentSidebarItem,
|
|
124
|
-
generateApiDocs,
|
|
125
|
-
generateSidebar,
|
|
126
|
-
getPageDataForRoute,
|
|
127
91
|
getPrevNextLinks,
|
|
128
|
-
getSlugFromPath,
|
|
129
|
-
loadAllDocs,
|
|
130
92
|
loadConfig,
|
|
131
|
-
loadDoc,
|
|
132
93
|
resolveConfig,
|
|
133
|
-
transformMarkdown,
|
|
134
|
-
transformMarkdownToReact,
|
|
135
|
-
typedocPlugin,
|
|
136
94
|
useArdoContext,
|
|
137
95
|
useConfig,
|
|
138
96
|
usePageData,
|
package/dist/mdx/provider.js
CHANGED
package/dist/typedoc/index.js
CHANGED
|
@@ -1,17 +1,266 @@
|
|
|
1
|
-
import {
|
|
2
|
-
ApiHierarchy,
|
|
3
|
-
ApiItem,
|
|
4
|
-
ApiKindBadge,
|
|
5
|
-
ApiParametersTable,
|
|
6
|
-
ApiReturns,
|
|
7
|
-
ApiSignature,
|
|
8
|
-
createTypedocWatcher,
|
|
9
|
-
typedocPlugin
|
|
10
|
-
} from "../chunk-Y46KCHBO.js";
|
|
11
1
|
import {
|
|
12
2
|
TypeDocGenerator,
|
|
13
3
|
generateApiDocs
|
|
14
4
|
} from "../chunk-PGHUPTGL.js";
|
|
5
|
+
|
|
6
|
+
// src/typedoc/vite-plugin.ts
|
|
7
|
+
import path from "path";
|
|
8
|
+
import fsSync from "fs";
|
|
9
|
+
function typedocPlugin(options = {}) {
|
|
10
|
+
const {
|
|
11
|
+
contentDir = "./content",
|
|
12
|
+
runOnBuild,
|
|
13
|
+
runOnStart = true,
|
|
14
|
+
// TypeDoc config with defaults
|
|
15
|
+
enabled = true,
|
|
16
|
+
entryPoints = ["./src/index.ts"],
|
|
17
|
+
out = "api-reference",
|
|
18
|
+
excludePrivate = true,
|
|
19
|
+
excludeInternal = true,
|
|
20
|
+
...restConfig
|
|
21
|
+
} = options;
|
|
22
|
+
const config = {
|
|
23
|
+
enabled,
|
|
24
|
+
entryPoints,
|
|
25
|
+
out,
|
|
26
|
+
excludePrivate,
|
|
27
|
+
excludeInternal,
|
|
28
|
+
...restConfig
|
|
29
|
+
};
|
|
30
|
+
let isBuilding = false;
|
|
31
|
+
let hasGenerated = false;
|
|
32
|
+
async function generate() {
|
|
33
|
+
if (!config.enabled) return;
|
|
34
|
+
console.log("[ardo] Generating API documentation with TypeDoc...");
|
|
35
|
+
const startTime = Date.now();
|
|
36
|
+
try {
|
|
37
|
+
const docs = await generateApiDocs(config, contentDir);
|
|
38
|
+
const duration = Date.now() - startTime;
|
|
39
|
+
console.log(`[ardo] Generated ${docs.length} API documentation pages in ${duration}ms`);
|
|
40
|
+
hasGenerated = true;
|
|
41
|
+
} catch (error) {
|
|
42
|
+
console.error("[ardo] TypeDoc generation failed:", error);
|
|
43
|
+
throw error;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return {
|
|
47
|
+
name: "ardo:typedoc",
|
|
48
|
+
async buildStart() {
|
|
49
|
+
if (runOnStart && !hasGenerated) {
|
|
50
|
+
await generate();
|
|
51
|
+
}
|
|
52
|
+
},
|
|
53
|
+
async buildEnd() {
|
|
54
|
+
if (isBuilding && runOnBuild !== false) {
|
|
55
|
+
await generate();
|
|
56
|
+
}
|
|
57
|
+
},
|
|
58
|
+
configResolved(config2) {
|
|
59
|
+
isBuilding = config2.command === "build";
|
|
60
|
+
},
|
|
61
|
+
async handleHotUpdate({ file }) {
|
|
62
|
+
if (config.watch && config.entryPoints.some((ep) => file.includes(ep))) {
|
|
63
|
+
await generate();
|
|
64
|
+
return [];
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
function createTypedocWatcher(config, contentDir, onChange) {
|
|
70
|
+
let watcher = null;
|
|
71
|
+
return {
|
|
72
|
+
async start() {
|
|
73
|
+
if (!config.watch || !config.entryPoints.length) return;
|
|
74
|
+
const entryDir = path.dirname(config.entryPoints[0]);
|
|
75
|
+
try {
|
|
76
|
+
watcher = fsSync.watch(entryDir, { recursive: true }, async (event, filename) => {
|
|
77
|
+
if (filename?.endsWith(".ts") || filename?.endsWith(".tsx")) {
|
|
78
|
+
console.log(`[ardo] Source file changed: ${filename}`);
|
|
79
|
+
await generateApiDocs(config, contentDir);
|
|
80
|
+
onChange?.();
|
|
81
|
+
}
|
|
82
|
+
});
|
|
83
|
+
} catch {
|
|
84
|
+
console.warn("[ardo] Could not start TypeDoc watcher");
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
stop() {
|
|
88
|
+
if (watcher) {
|
|
89
|
+
watcher.close();
|
|
90
|
+
watcher = null;
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
};
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// src/typedoc/components/ApiSignature.tsx
|
|
97
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
98
|
+
function ApiSignature({
|
|
99
|
+
name,
|
|
100
|
+
typeParameters,
|
|
101
|
+
parameters,
|
|
102
|
+
returns,
|
|
103
|
+
className = ""
|
|
104
|
+
}) {
|
|
105
|
+
const typeParamsStr = typeParameters?.length ? `<${typeParameters.map((tp) => tp.name).join(", ")}>` : "";
|
|
106
|
+
const paramsStr = parameters?.map((p) => {
|
|
107
|
+
const optional = p.optional ? "?" : "";
|
|
108
|
+
return `${p.name}${optional}: ${p.type}`;
|
|
109
|
+
}).join(", ");
|
|
110
|
+
const returnStr = returns?.type ? `: ${returns.type}` : "";
|
|
111
|
+
return /* @__PURE__ */ jsx("div", { className: `ardo-api-signature ${className}`, children: /* @__PURE__ */ jsx("pre", { className: "ardo-api-signature-code", children: /* @__PURE__ */ jsxs("code", { children: [
|
|
112
|
+
/* @__PURE__ */ jsx("span", { className: "ardo-api-keyword", children: "function" }),
|
|
113
|
+
" ",
|
|
114
|
+
/* @__PURE__ */ jsx("span", { className: "ardo-api-function-name", children: name }),
|
|
115
|
+
typeParamsStr && /* @__PURE__ */ jsx("span", { className: "ardo-api-type-params", children: typeParamsStr }),
|
|
116
|
+
/* @__PURE__ */ jsxs("span", { className: "ardo-api-params", children: [
|
|
117
|
+
"(",
|
|
118
|
+
paramsStr,
|
|
119
|
+
")"
|
|
120
|
+
] }),
|
|
121
|
+
returnStr && /* @__PURE__ */ jsx("span", { className: "ardo-api-return-type", children: returnStr })
|
|
122
|
+
] }) }) });
|
|
123
|
+
}
|
|
124
|
+
function ApiParametersTable({ parameters }) {
|
|
125
|
+
if (!parameters.length) return null;
|
|
126
|
+
return /* @__PURE__ */ jsxs("div", { className: "ardo-api-parameters", children: [
|
|
127
|
+
/* @__PURE__ */ jsx("h4", { className: "ardo-api-section-title", children: "Parameters" }),
|
|
128
|
+
/* @__PURE__ */ jsxs("table", { className: "ardo-api-table", children: [
|
|
129
|
+
/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
|
|
130
|
+
/* @__PURE__ */ jsx("th", { children: "Name" }),
|
|
131
|
+
/* @__PURE__ */ jsx("th", { children: "Type" }),
|
|
132
|
+
/* @__PURE__ */ jsx("th", { children: "Description" })
|
|
133
|
+
] }) }),
|
|
134
|
+
/* @__PURE__ */ jsx("tbody", { children: parameters.map((param) => /* @__PURE__ */ jsxs("tr", { children: [
|
|
135
|
+
/* @__PURE__ */ jsxs("td", { children: [
|
|
136
|
+
/* @__PURE__ */ jsx("code", { children: param.name }),
|
|
137
|
+
param.optional && /* @__PURE__ */ jsx("span", { className: "ardo-api-optional", children: "(optional)" })
|
|
138
|
+
] }),
|
|
139
|
+
/* @__PURE__ */ jsx("td", { children: /* @__PURE__ */ jsx("code", { children: param.type }) }),
|
|
140
|
+
/* @__PURE__ */ jsxs("td", { children: [
|
|
141
|
+
param.description,
|
|
142
|
+
param.defaultValue && /* @__PURE__ */ jsxs("span", { className: "ardo-api-default", children: [
|
|
143
|
+
"Default: ",
|
|
144
|
+
/* @__PURE__ */ jsx("code", { children: param.defaultValue })
|
|
145
|
+
] })
|
|
146
|
+
] })
|
|
147
|
+
] }, param.name)) })
|
|
148
|
+
] })
|
|
149
|
+
] });
|
|
150
|
+
}
|
|
151
|
+
function ApiReturns({ returns }) {
|
|
152
|
+
return /* @__PURE__ */ jsxs("div", { className: "ardo-api-returns", children: [
|
|
153
|
+
/* @__PURE__ */ jsx("h4", { className: "ardo-api-section-title", children: "Returns" }),
|
|
154
|
+
/* @__PURE__ */ jsxs("p", { children: [
|
|
155
|
+
/* @__PURE__ */ jsx("code", { children: returns.type }),
|
|
156
|
+
returns.description && /* @__PURE__ */ jsxs("span", { children: [
|
|
157
|
+
" - ",
|
|
158
|
+
returns.description
|
|
159
|
+
] })
|
|
160
|
+
] })
|
|
161
|
+
] });
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
// src/typedoc/components/ApiItem.tsx
|
|
165
|
+
import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
|
|
166
|
+
function ApiItem({ item, level = 2 }) {
|
|
167
|
+
const HeadingTag = `h${Math.min(level, 6)}`;
|
|
168
|
+
return /* @__PURE__ */ jsxs2("div", { className: `ardo-api-item ardo-api-item-${item.kind}`, id: item.id, children: [
|
|
169
|
+
/* @__PURE__ */ jsxs2(HeadingTag, { className: "ardo-api-item-title", children: [
|
|
170
|
+
/* @__PURE__ */ jsx2(ApiKindBadge, { kind: item.kind }),
|
|
171
|
+
/* @__PURE__ */ jsx2("span", { className: "ardo-api-item-name", children: item.name }),
|
|
172
|
+
/* @__PURE__ */ jsx2("a", { href: `#${item.id}`, className: "ardo-api-anchor", children: "#" })
|
|
173
|
+
] }),
|
|
174
|
+
item.description && /* @__PURE__ */ jsx2("p", { className: "ardo-api-item-description", children: item.description }),
|
|
175
|
+
item.signature && /* @__PURE__ */ jsx2(
|
|
176
|
+
ApiSignature,
|
|
177
|
+
{
|
|
178
|
+
name: item.name,
|
|
179
|
+
typeParameters: item.typeParameters,
|
|
180
|
+
parameters: item.parameters,
|
|
181
|
+
returns: item.returns
|
|
182
|
+
}
|
|
183
|
+
),
|
|
184
|
+
item.parameters && item.parameters.length > 0 && /* @__PURE__ */ jsx2(ApiParametersTable, { parameters: item.parameters }),
|
|
185
|
+
item.returns && /* @__PURE__ */ jsx2(ApiReturns, { returns: item.returns }),
|
|
186
|
+
item.examples && item.examples.length > 0 && /* @__PURE__ */ jsxs2("div", { className: "ardo-api-examples", children: [
|
|
187
|
+
/* @__PURE__ */ jsx2("h4", { className: "ardo-api-section-title", children: "Examples" }),
|
|
188
|
+
item.examples.map((example, i) => /* @__PURE__ */ jsx2("pre", { className: "ardo-api-example", children: /* @__PURE__ */ jsx2("code", { children: example }) }, i))
|
|
189
|
+
] }),
|
|
190
|
+
item.source && /* @__PURE__ */ jsx2("div", { className: "ardo-api-source", children: item.source.url ? /* @__PURE__ */ jsxs2("a", { href: item.source.url, target: "_blank", rel: "noopener noreferrer", children: [
|
|
191
|
+
item.source.file,
|
|
192
|
+
":",
|
|
193
|
+
item.source.line
|
|
194
|
+
] }) : /* @__PURE__ */ jsxs2("span", { children: [
|
|
195
|
+
item.source.file,
|
|
196
|
+
":",
|
|
197
|
+
item.source.line
|
|
198
|
+
] }) }),
|
|
199
|
+
item.children && item.children.length > 0 && /* @__PURE__ */ jsx2("div", { className: "ardo-api-children", children: item.children.map((child) => /* @__PURE__ */ jsx2(ApiItem, { item: child, level: level + 1 }, child.id)) })
|
|
200
|
+
] });
|
|
201
|
+
}
|
|
202
|
+
function ApiKindBadge({ kind }) {
|
|
203
|
+
const kindLabels = {
|
|
204
|
+
module: "Module",
|
|
205
|
+
namespace: "Namespace",
|
|
206
|
+
class: "Class",
|
|
207
|
+
interface: "Interface",
|
|
208
|
+
type: "Type",
|
|
209
|
+
enum: "Enum",
|
|
210
|
+
function: "Function",
|
|
211
|
+
variable: "Variable",
|
|
212
|
+
property: "Property",
|
|
213
|
+
method: "Method",
|
|
214
|
+
accessor: "Accessor",
|
|
215
|
+
constructor: "Constructor",
|
|
216
|
+
parameter: "Parameter",
|
|
217
|
+
typeParameter: "Type Parameter",
|
|
218
|
+
enumMember: "Enum Member"
|
|
219
|
+
};
|
|
220
|
+
const kindColors = {
|
|
221
|
+
class: "ardo-api-badge-class",
|
|
222
|
+
interface: "ardo-api-badge-interface",
|
|
223
|
+
type: "ardo-api-badge-type",
|
|
224
|
+
enum: "ardo-api-badge-enum",
|
|
225
|
+
function: "ardo-api-badge-function",
|
|
226
|
+
method: "ardo-api-badge-method",
|
|
227
|
+
property: "ardo-api-badge-property"
|
|
228
|
+
};
|
|
229
|
+
return /* @__PURE__ */ jsx2("span", { className: `ardo-api-badge ${kindColors[kind] || ""}`, children: kindLabels[kind] });
|
|
230
|
+
}
|
|
231
|
+
function ApiHierarchy({ hierarchy }) {
|
|
232
|
+
if (!hierarchy) return null;
|
|
233
|
+
const {
|
|
234
|
+
extends: extendsTypes,
|
|
235
|
+
implements: implementsTypes,
|
|
236
|
+
extendedBy,
|
|
237
|
+
implementedBy
|
|
238
|
+
} = hierarchy;
|
|
239
|
+
if (!extendsTypes?.length && !implementsTypes?.length && !extendedBy?.length && !implementedBy?.length) {
|
|
240
|
+
return null;
|
|
241
|
+
}
|
|
242
|
+
return /* @__PURE__ */ jsxs2("div", { className: "ardo-api-hierarchy", children: [
|
|
243
|
+
/* @__PURE__ */ jsx2("h4", { className: "ardo-api-section-title", children: "Hierarchy" }),
|
|
244
|
+
/* @__PURE__ */ jsxs2("ul", { className: "ardo-api-hierarchy-list", children: [
|
|
245
|
+
extendsTypes?.map((type) => /* @__PURE__ */ jsxs2("li", { children: [
|
|
246
|
+
/* @__PURE__ */ jsx2("span", { className: "ardo-api-hierarchy-label", children: "extends" }),
|
|
247
|
+
/* @__PURE__ */ jsx2("code", { children: type })
|
|
248
|
+
] }, type)),
|
|
249
|
+
implementsTypes?.map((type) => /* @__PURE__ */ jsxs2("li", { children: [
|
|
250
|
+
/* @__PURE__ */ jsx2("span", { className: "ardo-api-hierarchy-label", children: "implements" }),
|
|
251
|
+
/* @__PURE__ */ jsx2("code", { children: type })
|
|
252
|
+
] }, type)),
|
|
253
|
+
extendedBy?.map((type) => /* @__PURE__ */ jsxs2("li", { children: [
|
|
254
|
+
/* @__PURE__ */ jsx2("span", { className: "ardo-api-hierarchy-label", children: "extended by" }),
|
|
255
|
+
/* @__PURE__ */ jsx2("code", { children: type })
|
|
256
|
+
] }, type)),
|
|
257
|
+
implementedBy?.map((type) => /* @__PURE__ */ jsxs2("li", { children: [
|
|
258
|
+
/* @__PURE__ */ jsx2("span", { className: "ardo-api-hierarchy-label", children: "implemented by" }),
|
|
259
|
+
/* @__PURE__ */ jsx2("code", { children: type })
|
|
260
|
+
] }, type))
|
|
261
|
+
] })
|
|
262
|
+
] });
|
|
263
|
+
}
|
|
15
264
|
export {
|
|
16
265
|
ApiHierarchy,
|
|
17
266
|
ApiItem,
|