ardo 2.5.0 → 2.6.0

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.
Files changed (37) hide show
  1. package/README.md +2 -2
  2. package/dist/{Features-rHF_bj67.d.ts → FileTree-BGMcsIGZ.d.ts} +45 -3
  3. package/dist/Search-MXGJE6PQ.js +9 -0
  4. package/dist/{chunk-NJWWPDO2.js → chunk-6MXVILOZ.js} +2 -2
  5. package/dist/{chunk-5K5L7ZYS.js → chunk-ASEDNN4I.js} +42 -3
  6. package/dist/chunk-ASEDNN4I.js.map +1 -0
  7. package/dist/{chunk-GAYGMYIS.js → chunk-BHHI2BO4.js} +2 -2
  8. package/dist/{chunk-BH7JD5XJ.js → chunk-NBRHGTR2.js} +2 -1
  9. package/dist/chunk-NBRHGTR2.js.map +1 -0
  10. package/dist/chunk-QELSOHIY.js +46 -0
  11. package/dist/chunk-QELSOHIY.js.map +1 -0
  12. package/dist/{chunk-X7MG5VTZ.js → chunk-ZPYFCNRO.js} +69 -9
  13. package/dist/chunk-ZPYFCNRO.js.map +1 -0
  14. package/dist/config/index.d.ts +5 -5
  15. package/dist/config/index.js +1 -1
  16. package/dist/index.d.ts +3 -3
  17. package/dist/index.js +14 -10
  18. package/dist/mdx/provider.js +2 -2
  19. package/dist/runtime/index.d.ts +10 -10
  20. package/dist/runtime/index.js +7 -7
  21. package/dist/{types-DSD5zwMd.d.ts → types-DArVCX06.d.ts} +5 -3
  22. package/dist/ui/icons/folder.svg +1 -0
  23. package/dist/ui/index.d.ts +2 -2
  24. package/dist/ui/index.js +8 -4
  25. package/dist/ui/styles.css +176 -0
  26. package/dist/vite/index.d.ts +2 -2
  27. package/dist/vite/index.js +2 -2
  28. package/package.json +2 -2
  29. package/dist/Search-RJRSEY42.js +0 -9
  30. package/dist/chunk-3O2PF4HA.js +0 -46
  31. package/dist/chunk-3O2PF4HA.js.map +0 -1
  32. package/dist/chunk-5K5L7ZYS.js.map +0 -1
  33. package/dist/chunk-BH7JD5XJ.js.map +0 -1
  34. package/dist/chunk-X7MG5VTZ.js.map +0 -1
  35. /package/dist/{Search-RJRSEY42.js.map → Search-MXGJE6PQ.js.map} +0 -0
  36. /package/dist/{chunk-NJWWPDO2.js.map → chunk-6MXVILOZ.js.map} +0 -0
  37. /package/dist/{chunk-GAYGMYIS.js.map → chunk-BHHI2BO4.js.map} +0 -0
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  Content
3
- } from "./chunk-NJWWPDO2.js";
3
+ } from "./chunk-6MXVILOZ.js";
4
4
  import {
5
5
  ChevronDownIcon,
6
6
  GithubIcon,
@@ -18,7 +18,7 @@ import {
18
18
  usePageData,
19
19
  useTOC,
20
20
  useThemeConfig
21
- } from "./chunk-3O2PF4HA.js";
21
+ } from "./chunk-QELSOHIY.js";
22
22
 
23
23
  // src/ui/Layout.tsx
24
24
  import { jsx, jsxs } from "react/jsx-runtime";
@@ -91,7 +91,7 @@ function applyTheme(theme) {
91
91
 
92
92
  // src/ui/Header.tsx
93
93
  import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
94
- var LazySearch = lazy(() => import("./Search-RJRSEY42.js").then((m) => ({ default: m.Search })));
94
+ var LazySearch = lazy(() => import("./Search-MXGJE6PQ.js").then((m) => ({ default: m.Search })));
95
95
  function Header({
96
96
  logo,
97
97
  title,
@@ -197,7 +197,6 @@ function SidebarGroup({
197
197
  const { currentPath } = useSidebarContext();
198
198
  const isChildActive = checkChildrenActive(children, currentPath);
199
199
  const textClassName = ["ardo-sidebar-text", isChildActive && "child-active"].filter(Boolean).join(" ");
200
- const linkClassName = ["ardo-sidebar-link", isChildActive && "child-active"].filter(Boolean).join(" ");
201
200
  const hasChildren = Children.count(children) > 0;
202
201
  return /* @__PURE__ */ jsxs4("li", { className: className ?? "ardo-sidebar-item", children: [
203
202
  /* @__PURE__ */ jsxs4("div", { className: "ardo-sidebar-item-header", children: [
@@ -205,7 +204,8 @@ function SidebarGroup({
205
204
  NavLink,
206
205
  {
207
206
  to,
208
- className: ({ isActive }) => [linkClassName, isActive && "active"].filter(Boolean).join(" "),
207
+ end: true,
208
+ className: ({ isActive }) => [textClassName, isActive && "active"].filter(Boolean).join(" "),
209
209
  children: title
210
210
  }
211
211
  ) : /* @__PURE__ */ jsx4(
@@ -323,6 +323,7 @@ function Footer({
323
323
  project,
324
324
  sponsor,
325
325
  buildTime,
326
+ buildHash,
326
327
  ardoLink = true
327
328
  }) {
328
329
  const hasContent = message || copyright || children || project || sponsor || buildTime || ardoLink;
@@ -339,7 +340,7 @@ function Footer({
339
340
  project.version ? ` v${project.version}` : ""
340
341
  ] }) }),
341
342
  project?.name && ardoLink && /* @__PURE__ */ jsx5("span", { className: "ardo-footer-separator", "aria-hidden": "true" }),
342
- ardoLink && /* @__PURE__ */ jsx5("a", { href: "https://ardo.dev", className: "ardo-footer-link", children: "Built with Ardo" }),
343
+ ardoLink && /* @__PURE__ */ jsx5("a", { href: "https://ardo-docs.dev", className: "ardo-footer-link", children: "Built with Ardo" }),
343
344
  (project?.name || ardoLink) && sponsor && /* @__PURE__ */ jsx5("span", { className: "ardo-footer-separator", "aria-hidden": "true" }),
344
345
  sponsor && /* @__PURE__ */ jsxs5("a", { href: sponsor.link, className: "ardo-footer-link", children: [
345
346
  "Sponsored by ",
@@ -356,7 +357,12 @@ function Footer({
356
357
  ),
357
358
  buildTime && /* @__PURE__ */ jsxs5("p", { className: "ardo-footer-build-time", children: [
358
359
  "Built on ",
359
- formatBuildTime(buildTime)
360
+ formatBuildTime(buildTime),
361
+ buildHash && /* @__PURE__ */ jsxs5(Fragment, { children: [
362
+ " (",
363
+ buildHash,
364
+ ")"
365
+ ] })
360
366
  ] })
361
367
  ] }) }) });
362
368
  }
@@ -658,6 +664,58 @@ function Features({ items, title, subtitle, className }) {
658
664
  ] });
659
665
  }
660
666
 
667
+ // src/ui/components/Steps.tsx
668
+ import { jsx as jsx12 } from "react/jsx-runtime";
669
+ function Steps({ children }) {
670
+ return /* @__PURE__ */ jsx12("div", { className: "ardo-steps", children });
671
+ }
672
+
673
+ // src/ui/components/FileTree.tsx
674
+ import {
675
+ Children as Children2,
676
+ isValidElement as isValidElement2,
677
+ cloneElement
678
+ } from "react";
679
+ import { jsx as jsx13 } from "react/jsx-runtime";
680
+ function getTextContent(node) {
681
+ if (typeof node === "string") return node;
682
+ if (typeof node === "number") return String(node);
683
+ if (!isValidElement2(node)) return "";
684
+ const children = node.props.children;
685
+ if (!children) return "";
686
+ return Children2.toArray(children).map(getTextContent).join("");
687
+ }
688
+ function isDirectory(node) {
689
+ const children = node.props.children;
690
+ const childArray = Children2.toArray(children);
691
+ for (const child of childArray) {
692
+ if (isValidElement2(child) && (child.type === "ul" || child.type === "ol")) {
693
+ return true;
694
+ }
695
+ }
696
+ const text = getTextContent(node).trim();
697
+ return text.endsWith("/");
698
+ }
699
+ function processChildren(children) {
700
+ return Children2.map(children, (child) => {
701
+ if (!isValidElement2(child)) return child;
702
+ const props = child.props;
703
+ const el = child;
704
+ if (child.type === "li") {
705
+ const isDir = isDirectory(child);
706
+ const className = [props.className, isDir ? "ardo-filetree-dir" : "ardo-filetree-file"].filter(Boolean).join(" ");
707
+ return cloneElement(el, { className }, processChildren(props.children));
708
+ }
709
+ if (child.type === "ul" || child.type === "ol") {
710
+ return cloneElement(el, {}, processChildren(props.children));
711
+ }
712
+ return child;
713
+ });
714
+ }
715
+ function FileTree({ children }) {
716
+ return /* @__PURE__ */ jsx13("div", { className: "ardo-filetree", children: processChildren(children) });
717
+ }
718
+
661
719
  export {
662
720
  Layout,
663
721
  ThemeToggle,
@@ -677,6 +735,8 @@ export {
677
735
  HomePage,
678
736
  Hero,
679
737
  FeatureCard,
680
- Features
738
+ Features,
739
+ Steps,
740
+ FileTree
681
741
  };
682
- //# sourceMappingURL=chunk-X7MG5VTZ.js.map
742
+ //# sourceMappingURL=chunk-ZPYFCNRO.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/ui/Layout.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 } from \"react\"\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 { useState, lazy, Suspense, type ReactNode } from \"react\"\nimport { Link } from \"react-router\"\nimport {\n GithubIcon,\n TwitterIcon,\n MessageCircleIcon,\n LinkedinIcon,\n YoutubeIcon,\n PackageIcon,\n} from \"./icons\"\nimport { ThemeToggle } from \"./components/ThemeToggle\"\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 CSS classes */\n className?: string\n}\n\n/**\n * Header component with explicit slot props.\n *\n * @example\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 * actions={\n * <SocialLink href=\"https://github.com/...\" icon=\"github\" />\n * }\n * />\n * ```\n */\nexport function Header({\n logo,\n title,\n nav,\n actions,\n search = true,\n themeToggle = true,\n className,\n}: HeaderProps) {\n const [mobileMenuOpen, setMobileMenuOpen] = useState(false)\n\n return (\n <header className={className ?? \"ardo-header\"}>\n <div className=\"ardo-header-container\">\n {/* Left: Mobile menu button + Logo/Title */}\n <div className=\"ardo-header-left\">\n <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 <Link to=\"/\" className=\"ardo-logo-link\">\n {logo && (\n <img\n src={typeof logo === \"string\" ? logo : logo.light}\n alt={title ?? \"Logo\"}\n className=\"ardo-logo\"\n />\n )}\n {title && <span className=\"ardo-site-title\">{title}</span>}\n </Link>\n </div>\n\n {/* Center: Navigation */}\n {nav && <div className=\"ardo-nav\">{nav}</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 {actions}\n </div>\n </div>\n\n {/* Mobile menu */}\n {mobileMenuOpen && (\n <div className=\"ardo-mobile-menu\">\n <nav className=\"ardo-mobile-nav\" onClick={() => setMobileMenuOpen(false)}>\n {nav}\n </nav>\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// 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\"\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 both data-driven and JSX composition patterns.\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\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 {items ? (\n <SidebarItems items={items} depth={0} />\n ) : (\n <ul className=\"ardo-sidebar-list ardo-sidebar-list-0\">{children}</ul>\n )}\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\"\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 * When `children` is provided, all automatic rendering is skipped.\n *\n * @example Structured usage\n * ```tsx\n * <Footer\n * project={config.project}\n * sponsor={{ text: \"Sebastian Software\", link: \"https://sebastian-software.com/oss\" }}\n * buildTime={config.buildTime}\n * message=\"Released under the MIT License.\"\n * copyright=\"Copyright 2026 Sebastian Software GmbH\"\n * />\n * ```\n *\n * @example Simple usage\n * ```tsx\n * <Footer message=\"MIT License\" copyright=\"2026 Sebastian Software\" />\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 hasContent = message || copyright || children || project || sponsor || buildTime || 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 {(project || ardoLink || sponsor) && (\n <p className=\"ardo-footer-primary\">\n {project?.name && (\n <>\n {project.homepage ? (\n <a href={project.homepage} className=\"ardo-footer-link\">\n {project.name}\n {project.version ? ` v${project.version}` : \"\"}\n </a>\n ) : (\n <span>\n {project.name}\n {project.version ? ` v${project.version}` : \"\"}\n </span>\n )}\n </>\n )}\n {project?.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 {(project?.name || ardoLink) && sponsor && (\n <span className=\"ardo-footer-separator\" aria-hidden=\"true\" />\n )}\n {sponsor && (\n <a href={sponsor.link} className=\"ardo-footer-link\">\n Sponsored by {sponsor.text}\n </a>\n )}\n </p>\n )}\n {/* Secondary line: message / copyright */}\n {message && (\n <p className=\"ardo-footer-message\" dangerouslySetInnerHTML={{ __html: message }} />\n )}\n {copyright && (\n <p\n className=\"ardo-footer-copyright\"\n dangerouslySetInnerHTML={{ __html: copyright }}\n />\n )}\n {/* Tertiary line: build timestamp */}\n {buildTime && (\n <p className=\"ardo-footer-build-time\">\n Built on {formatBuildTime(buildTime)}\n {buildHash && <> ({buildHash})</>}\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":["useState","jsx","jsxs","jsx","jsxs","useState","useState","jsx","jsxs","useState","jsx","jsxs","useState","createContext","useContext","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","jsx"]}
@@ -1,10 +1,10 @@
1
- import { b as PressConfig, R as ResolvedConfig, M as MarkdownConfig } from '../types-DSD5zwMd.js';
2
- export { H as HeadConfig, N as NavItem, P as PageData, a as PageFrontmatter, c as ProjectMeta, S as SidebarItem, d as SocialLink, g as SponsorConfig, T as TOCItem, e as ThemeConfig, f as TypeDocConfig } from '../types-DSD5zwMd.js';
1
+ import { A as ArdoConfig, R as ResolvedConfig, M as MarkdownConfig } from '../types-DArVCX06.js';
2
+ export { H as HeadConfig, N as NavItem, P as PageData, a as PageFrontmatter, b as ProjectMeta, S as SidebarItem, c as SocialLink, f as SponsorConfig, T as TOCItem, d as ThemeConfig, e as TypeDocConfig } from '../types-DArVCX06.js';
3
3
  import 'shiki';
4
4
 
5
- declare function defineConfig(config: PressConfig): PressConfig;
5
+ declare function defineConfig(config: ArdoConfig): ArdoConfig;
6
6
  declare const defaultMarkdownConfig: MarkdownConfig;
7
- declare function resolveConfig(config: PressConfig, root: string): ResolvedConfig;
7
+ declare function resolveConfig(config: ArdoConfig, root: string): ResolvedConfig;
8
8
  declare function loadConfig(root: string): Promise<ResolvedConfig>;
9
9
 
10
- export { MarkdownConfig, PressConfig, ResolvedConfig, defaultMarkdownConfig, defineConfig, loadConfig, resolveConfig };
10
+ export { ArdoConfig, MarkdownConfig, ResolvedConfig, defaultMarkdownConfig, defineConfig, loadConfig, resolveConfig };
@@ -3,7 +3,7 @@ import {
3
3
  defineConfig,
4
4
  loadConfig,
5
5
  resolveConfig
6
- } from "../chunk-BH7JD5XJ.js";
6
+ } from "../chunk-NBRHGTR2.js";
7
7
  export {
8
8
  defaultMarkdownConfig,
9
9
  defineConfig,
package/dist/index.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
  export { defineConfig, loadConfig, resolveConfig } from './config/index.js';
2
2
  export { ArdoPluginOptions, ardo as ardoPlugin, generateSidebar, getPageDataForRoute, getSlugFromPath, loadAllDocs, loadDoc, transformMarkdown, transformMarkdownToReact } from './vite/index.js';
3
- export { H as HeadConfig, M as MarkdownConfig, N as NavItem, P as PageData, a as PageFrontmatter, b as PressConfig, c as ProjectMeta, R as ResolvedConfig, S as SidebarItem, d as SocialLink, T as TOCItem, e as ThemeConfig, f as TypeDocConfig } from './types-DSD5zwMd.js';
4
- export { PressProvider, findCurrentSidebarItem, getPrevNextLinks, useConfig, usePageData, usePressContext, 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 Footer, H as Header, q as Hero, r as HeroAction, s as HeroImage, t as HeroProps, u as HomePage, I as Info, v as InfoProps, L as Layout, N as Note, w as NoteProps, S as Search, x as Sidebar, T as TOC, y as Tab, z as TabList, A as TabListProps, B as TabPanel, E as TabPanelProps, G as TabPanels, J as TabPanelsProps, K as TabProps, M as Tabs, O as TabsProps, P as ThemeToggle, Q as Tip, R as TipProps, W as Warning, U as WarningProps } from './Features-rHF_bj67.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-DArVCX06.js';
4
+ 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-BGMcsIGZ.js';
6
6
  export { ApiDocHierarchy, ApiDocItem, ApiDocKind, ApiDocParameter, ApiDocReturn, ApiDocSource, ApiDocTag, ApiDocTypeParameter, ApiHierarchy, ApiItem, ApiKindBadge, ApiParametersTable, ApiReturns, ApiSignature, GeneratedApiDoc, TypeDocGenerator, TypeDocPluginOptions, createTypedocWatcher, generateApiDocs, typedocPlugin } from './typedoc/index.js';
7
7
  import 'vite';
8
8
  import 'shiki';
package/dist/index.js CHANGED
@@ -7,30 +7,32 @@ import {
7
7
  loadDoc,
8
8
  transformMarkdown,
9
9
  transformMarkdownToReact
10
- } from "./chunk-5K5L7ZYS.js";
10
+ } from "./chunk-ASEDNN4I.js";
11
11
  import {
12
12
  defineConfig,
13
13
  loadConfig,
14
14
  resolveConfig
15
- } from "./chunk-BH7JD5XJ.js";
15
+ } from "./chunk-NBRHGTR2.js";
16
16
  import "./chunk-R2QKY6G3.js";
17
17
  import {
18
18
  DocLayout,
19
19
  DocPage,
20
20
  FeatureCard,
21
21
  Features,
22
+ FileTree,
22
23
  Footer,
23
24
  Header,
24
25
  Hero,
25
26
  HomePage,
26
27
  Layout,
27
28
  Sidebar,
29
+ Steps,
28
30
  TOC,
29
31
  ThemeToggle
30
- } from "./chunk-X7MG5VTZ.js";
32
+ } from "./chunk-ZPYFCNRO.js";
31
33
  import {
32
34
  Search
33
- } from "./chunk-GAYGMYIS.js";
35
+ } from "./chunk-BHHI2BO4.js";
34
36
  import {
35
37
  ApiHierarchy,
36
38
  ApiItem,
@@ -61,21 +63,21 @@ import {
61
63
  Tabs,
62
64
  Tip,
63
65
  Warning
64
- } from "./chunk-NJWWPDO2.js";
66
+ } from "./chunk-6MXVILOZ.js";
65
67
  import "./chunk-MJQGGJQZ.js";
66
68
  import {
67
69
  findCurrentSidebarItem,
68
70
  getPrevNextLinks
69
71
  } from "./chunk-FZP2AVJL.js";
70
72
  import {
71
- PressProvider,
73
+ ArdoProvider,
74
+ useArdoContext,
72
75
  useConfig,
73
76
  usePageData,
74
- usePressContext,
75
77
  useSidebar,
76
78
  useTOC,
77
79
  useThemeConfig
78
- } from "./chunk-3O2PF4HA.js";
80
+ } from "./chunk-QELSOHIY.js";
79
81
  export {
80
82
  ApiHierarchy,
81
83
  ApiItem,
@@ -83,6 +85,7 @@ export {
83
85
  ApiParametersTable,
84
86
  ApiReturns,
85
87
  ApiSignature,
88
+ ArdoProvider,
86
89
  CodeBlock,
87
90
  CodeGroup,
88
91
  Container,
@@ -93,6 +96,7 @@ export {
93
96
  DocPage,
94
97
  FeatureCard,
95
98
  Features,
99
+ FileTree,
96
100
  Footer,
97
101
  Header,
98
102
  Hero,
@@ -100,9 +104,9 @@ export {
100
104
  Info,
101
105
  Layout,
102
106
  Note,
103
- PressProvider,
104
107
  Search,
105
108
  Sidebar,
109
+ Steps,
106
110
  TOC,
107
111
  Tab,
108
112
  TabList,
@@ -129,9 +133,9 @@ export {
129
133
  transformMarkdown,
130
134
  transformMarkdownToReact,
131
135
  typedocPlugin,
136
+ useArdoContext,
132
137
  useConfig,
133
138
  usePageData,
134
- usePressContext,
135
139
  useSidebar,
136
140
  useTOC,
137
141
  useThemeConfig
@@ -14,10 +14,10 @@ import {
14
14
  Tabs,
15
15
  Tip,
16
16
  Warning
17
- } from "../chunk-NJWWPDO2.js";
17
+ } from "../chunk-6MXVILOZ.js";
18
18
  import "../chunk-MJQGGJQZ.js";
19
19
  import "../chunk-FZP2AVJL.js";
20
- import "../chunk-3O2PF4HA.js";
20
+ import "../chunk-QELSOHIY.js";
21
21
 
22
22
  // src/mdx/provider.tsx
23
23
  import { Link } from "react-router";
@@ -1,28 +1,28 @@
1
1
  import * as react_jsx_runtime from 'react/jsx-runtime';
2
2
  import * as react from 'react';
3
3
  import { ReactNode } from 'react';
4
- import { b as PressConfig, S as SidebarItem, P as PageData, T as TOCItem, e as ThemeConfig } from '../types-DSD5zwMd.js';
4
+ import { A as ArdoConfig, S as SidebarItem, P as PageData, T as TOCItem, d as ThemeConfig } from '../types-DArVCX06.js';
5
5
  import 'shiki';
6
6
 
7
- interface PressContextValue {
8
- config: PressConfig;
7
+ interface ArdoContextValue {
8
+ config: ArdoConfig;
9
9
  sidebar: SidebarItem[];
10
10
  currentPage?: PageData;
11
11
  }
12
- declare const PressContext: react.Context<PressContextValue | null>;
13
- declare function usePressContext(): PressContextValue;
14
- declare function useConfig(): PressConfig;
12
+ declare const ArdoContext: react.Context<ArdoContextValue | null>;
13
+ declare function useArdoContext(): ArdoContextValue;
14
+ declare function useConfig(): ArdoConfig;
15
15
  declare function useThemeConfig(): ThemeConfig;
16
16
  declare function useSidebar(): SidebarItem[];
17
17
  declare function usePageData(): PageData | undefined;
18
18
  declare function useTOC(): TOCItem[];
19
- interface PressProviderProps {
20
- config: PressConfig;
19
+ interface ArdoProviderProps {
20
+ config: ArdoConfig;
21
21
  sidebar: SidebarItem[];
22
22
  currentPage?: PageData;
23
23
  children: ReactNode;
24
24
  }
25
- declare function PressProvider({ config, sidebar, currentPage, children }: PressProviderProps): react_jsx_runtime.JSX.Element;
25
+ declare function ArdoProvider({ config, sidebar, currentPage, children }: ArdoProviderProps): react_jsx_runtime.JSX.Element;
26
26
 
27
27
  /**
28
28
  * Find the current sidebar item based on the current path.
@@ -38,4 +38,4 @@ declare function getPrevNextLinks(sidebar: SidebarItem[], currentPath: string):
38
38
  next?: SidebarItem;
39
39
  };
40
40
 
41
- export { PressContext, PressProvider, findCurrentSidebarItem, getPrevNextLinks, useConfig, usePageData, usePressContext, useSidebar, useTOC, useThemeConfig };
41
+ export { ArdoContext, ArdoProvider, findCurrentSidebarItem, getPrevNextLinks, useArdoContext, useConfig, usePageData, useSidebar, useTOC, useThemeConfig };
@@ -4,23 +4,23 @@ import {
4
4
  getPrevNextLinks
5
5
  } from "../chunk-FZP2AVJL.js";
6
6
  import {
7
- PressContext,
8
- PressProvider,
7
+ ArdoContext,
8
+ ArdoProvider,
9
+ useArdoContext,
9
10
  useConfig,
10
11
  usePageData,
11
- usePressContext,
12
12
  useSidebar,
13
13
  useTOC,
14
14
  useThemeConfig
15
- } from "../chunk-3O2PF4HA.js";
15
+ } from "../chunk-QELSOHIY.js";
16
16
  export {
17
- PressContext,
18
- PressProvider,
17
+ ArdoContext,
18
+ ArdoProvider,
19
19
  findCurrentSidebarItem,
20
20
  getPrevNextLinks,
21
+ useArdoContext,
21
22
  useConfig,
22
23
  usePageData,
23
- usePressContext,
24
24
  useSidebar,
25
25
  useTOC,
26
26
  useThemeConfig
@@ -141,11 +141,13 @@ interface ProjectMeta {
141
141
  * In JSX-first architecture, only build-time options are needed here.
142
142
  * Runtime UI configuration (header, sidebar, footer) is done in JSX.
143
143
  */
144
- interface PressConfig {
144
+ interface ArdoConfig {
145
145
  /** Site title (used for default meta tags) */
146
146
  title: string;
147
147
  /** Site description (used for default meta tags) */
148
148
  description?: string;
149
+ /** Separator between page title and site title (default: " | ") */
150
+ titleSeparator?: string;
149
151
  /** Base URL path */
150
152
  base?: string;
151
153
  /** Content source directory (default: 'content') */
@@ -231,7 +233,7 @@ interface PageData {
231
233
  filePath: string;
232
234
  relativePath: string;
233
235
  }
234
- interface ResolvedConfig extends Required<Omit<PressConfig, "vite" | "typedoc" | "project">> {
236
+ interface ResolvedConfig extends Required<Omit<ArdoConfig, "vite" | "typedoc" | "project">> {
235
237
  project: ProjectMeta;
236
238
  vite?: Record<string, unknown>;
237
239
  typedoc?: TypeDocConfig;
@@ -239,4 +241,4 @@ interface ResolvedConfig extends Required<Omit<PressConfig, "vite" | "typedoc" |
239
241
  contentDir: string;
240
242
  }
241
243
 
242
- export type { HeadConfig as H, MarkdownConfig as M, NavItem as N, PageData as P, ResolvedConfig as R, SidebarItem as S, TOCItem as T, PageFrontmatter as a, PressConfig as b, ProjectMeta as c, SocialLink as d, ThemeConfig as e, TypeDocConfig as f, SponsorConfig as g };
244
+ export type { ArdoConfig as A, HeadConfig as H, MarkdownConfig as M, NavItem as N, PageData as P, ResolvedConfig as R, SidebarItem as S, TOCItem as T, PageFrontmatter as a, ProjectMeta as b, SocialLink as c, ThemeConfig as d, TypeDocConfig as e, SponsorConfig as f };
@@ -0,0 +1 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/></svg>
@@ -1,8 +1,8 @@
1
- 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, V as DocContent, j as DocLayout, k as DocPage, F as FeatureCard, l as FeatureCardProps, m as FeatureItem, n as Features, o as FeaturesProps, p as Footer, X as FooterCopyrightProps, Y as FooterMessageProps, Z as FooterProps, H as Header, _ as HeaderProps, q as Hero, r as HeroAction, s as HeroImage, t as HeroProps, u as HomePage, I as Info, v as InfoProps, L as Layout, $ as LayoutProps, N as Note, w as NoteProps, S as Search, x as Sidebar, a0 as SidebarGroup, a1 as SidebarGroupProps, a2 as SidebarLink, a3 as SidebarLinkProps, a4 as SidebarProps, a5 as SocialLink, a6 as SocialLinkProps, T as TOC, y as Tab, z as TabList, A as TabListProps, B as TabPanel, E as TabPanelProps, G as TabPanels, J as TabPanelsProps, K as TabProps, M as Tabs, O as TabsProps, P as ThemeToggle, Q as Tip, R as TipProps, W as Warning, U as WarningProps } from '../Features-rHF_bj67.js';
1
+ 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, _ as DocContent, 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, $ as FooterCopyrightProps, a0 as FooterMessageProps, a1 as FooterProps, H as Header, a2 as HeaderProps, s as Hero, t as HeroAction, u as HeroImage, v as HeroProps, w as HomePage, I as Info, x as InfoProps, L as Layout, a3 as LayoutProps, N as Note, y as NoteProps, S as Search, z as Sidebar, a4 as SidebarGroup, a5 as SidebarGroupProps, a6 as SidebarLink, a7 as SidebarLinkProps, a8 as SidebarProps, a9 as SocialLink, aa as SocialLinkProps, 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-BGMcsIGZ.js';
2
2
  import * as react_jsx_runtime from 'react/jsx-runtime';
3
3
  import { ReactNode, ComponentProps, SVGAttributes, ComponentType } from 'react';
4
4
  import { NavLink as NavLink$1 } from 'react-router';
5
- import '../types-DSD5zwMd.js';
5
+ import '../types-DArVCX06.js';
6
6
  import 'shiki';
7
7
 
8
8
  /** Route path type - uses React Router's NavLink 'to' prop type for type-safe routes */