ardo 1.2.2 → 2.0.0

package/dist/ui/index.d.ts

@@ -0,0 +1,116 @@
+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-C_06EvGb.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentProps } from 'react';
+import { NavLink as NavLink$1 } from 'react-router';
+import { LucideProps, LucideIcon } from 'lucide-react';
+import '../types-DchPWkJl.js';
+import 'shiki';
+
+/** Route path type - uses React Router's NavLink 'to' prop type for type-safe routes */
+type RoutePath = ComponentProps<typeof NavLink$1>["to"];
+interface NavProps {
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * Navigation container component for composing navigation links.
+ *
+ * @example
+ * ```tsx
+ * <Nav>
+ *   <NavLink to="/guide">Guide</NavLink>
+ *   <NavLink to="/api">API</NavLink>
+ *   <NavLink href="https://github.com/...">GitHub</NavLink>
+ * </Nav>
+ * ```
+ */
+declare function Nav({ children, className }: NavProps): react_jsx_runtime.JSX.Element;
+interface NavLinkProps {
+    /** Internal route path (type-safe with React Router's registered routes) */
+    to?: RoutePath;
+    /** External URL (uses anchor tag) */
+    href?: string;
+    /** Link text or children */
+    children: ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+    /** Active state match pattern */
+    activeMatch?: string;
+}
+/**
+ * Navigation link component supporting both internal routes and external URLs.
+ *
+ * @example
+ * ```tsx
+ * // Internal link
+ * <NavLink to="/guide">Guide</NavLink>
+ *
+ * // External link
+ * <NavLink href="https://github.com/...">GitHub</NavLink>
+ * ```
+ */
+declare function NavLink({ to, href, children, className, activeMatch: _activeMatch, }: NavLinkProps): react_jsx_runtime.JSX.Element;
+interface NavDropdownProps {
+    /** Dropdown trigger text */
+    text: string;
+    /** Dropdown items */
+    children: ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Dropdown navigation menu for grouping related links.
+ *
+ * @example
+ * ```tsx
+ * <NavDropdown text="Resources">
+ *   <NavLink to="/docs">Documentation</NavLink>
+ *   <NavLink to="/blog">Blog</NavLink>
+ * </NavDropdown>
+ * ```
+ */
+declare function NavDropdown({ text, children, className }: NavDropdownProps): react_jsx_runtime.JSX.Element;
+
+interface IconProps extends Omit<LucideProps, "ref"> {
+    /** Name of the registered icon */
+    name: string;
+}
+/**
+ * Register icons for use with the Icon component.
+ * Only registered icons are included in your bundle.
+ *
+ * @example
+ * ```tsx
+ * // In your app's entry point or layout:
+ * import { registerIcons } from "ardo/ui"
+ * import { Zap, Rocket, Code } from "lucide-react"
+ *
+ * registerIcons({ Zap, Rocket, Code })
+ * ```
+ */
+declare function registerIcons(icons: Record<string, LucideIcon>): void;
+/**
+ * Get all registered icon names (useful for documentation).
+ */
+declare function getRegisteredIconNames(): string[];
+/**
+ * Renders a registered Lucide icon by name.
+ * Icons must be registered first using `registerIcons()`.
+ *
+ * @example
+ * ```tsx
+ * // First register icons in your app:
+ * import { registerIcons } from "ardo/ui"
+ * import { Zap, Rocket } from "lucide-react"
+ * registerIcons({ Zap, Rocket })
+ *
+ * // Then use in MDX:
+ * <Icon name="Zap" size={24} />
+ * <Icon name="Rocket" className="text-brand" />
+ * ```
+ *
+ * @see https://lucide.dev/icons for available icon names
+ */
+declare function Icon({ name, ...props }: IconProps): ReactNode;
+
+export { Icon, type IconProps, Nav, NavDropdown, type NavDropdownProps, NavLink, type NavLinkProps, type NavProps, getRegisteredIconNames, registerIcons };

package/dist/{theme → ui}/index.js

@@ -1,37 +1,45 @@
 import {
-  CodeBlock,
-  CodeGroup,
-  Container,
-  Content,
-  CopyButton,
-  Danger,
   DocContent,
   DocLayout,
   DocPage,
+  FeatureCard,
+  Features,
   Footer,
   Header,
+  Hero,
   HomePage,
-  Info,
   Layout,
   Nav,
   NavDropdown,
   NavLink,
-  Note,
   Search,
   Sidebar,
   SidebarGroup,
   SidebarLink,
   SocialLink,
   TOC,
+  ThemeToggle
+} from "../chunk-ZXPAEM3M.js";
+import {
+  CodeBlock,
+  CodeGroup,
+  Container,
+  Content,
+  CopyButton,
+  Danger,
+  Icon,
+  Info,
+  Note,
   Tab,
   TabList,
   TabPanel,
   TabPanels,
   Tabs,
-  ThemeToggle,
   Tip,
-  Warning
-} from "../chunk-2JBVPO6S.js";
+  Warning,
+  getRegisteredIconNames,
+  registerIcons
+} from "../chunk-UWAVET45.js";
 import "../chunk-EOV2OUTW.js";
 export {
   CodeBlock,
@@ -43,9 +51,13 @@ export {
   DocContent,
   DocLayout,
   DocPage,
+  FeatureCard,
+  Features,
   Footer,
   Header,
+  Hero,
   HomePage,
+  Icon,
   Info,
   Layout,
   Nav,
@@ -65,6 +77,8 @@ export {
   Tabs,
   ThemeToggle,
   Tip,
-  Warning
+  Warning,
+  getRegisteredIconNames,
+  registerIcons
 };
 //# sourceMappingURL=index.js.map