@olwiba/ui 0.0.28

package/dist/index.d.ts

@@ -0,0 +1,762 @@
+import { ClassValue } from 'clsx';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { ButtonProps as ButtonProps$1, CardProps as CardProps$1, BadgeProps as BadgeProps$1, InputProps as InputProps$1, TextareaProps as TextareaProps$1, CheckboxProps as CheckboxProps$1, SwitchProps as SwitchProps$1 } from '@olwiba/cn';
+export { CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '@olwiba/cn';
+import { LucideIcon } from 'lucide-react';
+
+declare function cn(...inputs: ClassValue[]): string;
+
+type UIMode = 'default' | 'playful' | 'smooth';
+interface OlwibaUIContextValue {
+    isMobile: boolean;
+    mode: UIMode;
+}
+interface OlwibaUIProviderProps {
+    children: React.ReactNode;
+    /**
+     * Override the mobile detection. If omitted, uses useIsMobile() from @olwiba/cn
+     * which detects based on a 768px viewport breakpoint.
+     */
+    isMobile?: boolean;
+    /**
+     * Global component mode. Primitives imported from @olwiba/ui will automatically
+     * apply this mode unless overridden at the component level.
+     *
+     * - `'default'`  — standard square shadcn/Radix appearance
+     * - `'playful'`  — slight rotation + offset drop shadow backdrop
+     * - `'smooth'`   — softer, larger border-radius across all components
+     */
+    mode?: UIMode;
+}
+declare function OlwibaUIProvider({ children, isMobile: isMobileProp, mode }: OlwibaUIProviderProps): react_jsx_runtime.JSX.Element;
+declare function useOlwibaUI(): OlwibaUIContextValue;
+/** Returns just the current UI mode from context. */
+declare function useUIMode(): UIMode;
+
+type ButtonProps = ButtonProps$1;
+declare const Button: React.ForwardRefExoticComponent<ButtonProps$1 & React.RefAttributes<HTMLButtonElement>>;
+
+type CardProps = CardProps$1;
+declare const Card: React.ForwardRefExoticComponent<CardProps$1 & React.RefAttributes<HTMLDivElement>>;
+
+type BadgeProps = BadgeProps$1;
+declare function Badge(props: BadgeProps): react_jsx_runtime.JSX.Element;
+
+type InputProps = InputProps$1;
+declare const Input: React.ForwardRefExoticComponent<Omit<InputProps$1, "ref"> & React.RefAttributes<HTMLInputElement>>;
+
+type TextareaProps = TextareaProps$1;
+declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps$1, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;
+
+type CheckboxProps = CheckboxProps$1;
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps$1 & React.RefAttributes<HTMLButtonElement>>;
+
+type SwitchProps = SwitchProps$1 & {
+    mode?: 'default' | 'playful' | 'smooth';
+};
+declare const Switch: React.ForwardRefExoticComponent<SwitchProps$1 & {
+    mode?: "default" | "playful" | "smooth";
+} & React.RefAttributes<HTMLButtonElement>>;
+
+interface AppNavItem {
+    icon: LucideIcon;
+    label: string;
+    href: string;
+    isActive?: boolean;
+}
+interface AppShellAction {
+    icon?: LucideIcon;
+    label: string;
+    href?: string;
+    onClick?: () => void;
+}
+interface AppShellUser {
+    email: string;
+    name?: string;
+    avatar?: string;
+    /** Displayed as a sub-label (e.g. plan tier). */
+    plan?: string;
+    onSignOut?: () => void;
+    onBilling?: () => void;
+}
+interface AppShellBrand {
+    name: ReactNode;
+    logo?: ReactNode;
+    href?: string;
+}
+/**
+ * Render a navigation link. Override to integrate your router's Link component.
+ * @example renderLink={({ href, children }) => <Link to={href}>{children}</Link>}
+ */
+type AppShellRenderLink = (props: {
+    href: string;
+    children: ReactNode;
+    className?: string;
+}) => ReactNode;
+interface AppShellProps {
+    brand?: AppShellBrand;
+    navItems?: AppNavItem[];
+    /** Primary CTA rendered above nav (e.g. "New project", "Quick create") */
+    action?: AppShellAction;
+    user?: AppShellUser;
+    /** Text shown in the top header bar */
+    pageTitle?: string;
+    /** Override link rendering for SPA navigation. Defaults to a native <a>. */
+    renderLink?: AppShellRenderLink;
+    children?: ReactNode;
+    /**
+     * Sidebar collapse behaviour.
+     * - `"icon"` — collapses to a narrow icon rail (default, recommended for desktop)
+     * - `"offcanvas"` — slides off-screen as a drawer overlay
+     * - `"none"` — always fully visible
+     */
+    collapsible?: 'icon' | 'offcanvas' | 'none';
+    /**
+     * Layout scope.
+     * - `"viewport"` (default) — fills the full browser viewport; use for top-level app shells.
+     * - `"contained"` — fills its parent container; use in docs sandboxes, modals, or embedded previews.
+     */
+    sidebarPosition?: 'viewport' | 'contained';
+    /** Which side the sidebar sits on. @default "left" */
+    side?: 'left' | 'right';
+}
+declare function AppShell({ brand, navItems, action, user, pageTitle, renderLink, collapsible, sidebarPosition, side, children, }?: AppShellProps): react_jsx_runtime.JSX.Element;
+
+interface AuthFormProps {
+    onSubmit?: (e: React.FormEvent<HTMLFormElement>) => void;
+    onSso?: () => void;
+    signUpHref?: string;
+    forgotPasswordHref?: string;
+    brand?: React.ReactNode;
+}
+interface AuthSectionProps extends AuthFormProps {
+    /** Visual layout of the auth screen */
+    layout?: 'centered' | 'split';
+    /** Custom form/card content. Defaults to the built-in sign-in form. */
+    children?: React.ReactNode;
+    /** (split layout only) Custom content for the left decorative panel */
+    panel?: React.ReactNode;
+    className?: string;
+}
+declare function AuthSection({ layout, children, panel, className, ...formProps }: AuthSectionProps): react_jsx_runtime.JSX.Element;
+
+interface EmptyStateProps extends React.HTMLAttributes<HTMLDivElement> {
+    icon?: LucideIcon;
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+}
+declare function EmptyState({ icon: Icon, title, description, action, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+interface ErrorPageProps {
+    statusCode?: string;
+    title?: string;
+    description?: string;
+    action?: {
+        label: string;
+        href: string;
+    };
+    backAction?: {
+        label: string;
+        href?: string;
+        onClick?: () => void;
+    };
+    renderLink?: AppShellRenderLink;
+}
+declare function ErrorPage({ statusCode, title, description, action, backAction, renderLink, }: ErrorPageProps): react_jsx_runtime.JSX.Element;
+
+interface UpgradeComparisonRow {
+    key?: React.Key;
+    label: React.ReactNode;
+    currentValue: React.ReactNode;
+    upgradedValue: React.ReactNode;
+}
+interface UpgradePromptProps {
+    /** Layout variant. `banner` is an inline strip; `comparison` is a full feature-table block. */
+    variant: 'banner' | 'comparison';
+    /** Primary heading shown in both variants. */
+    title: React.ReactNode;
+    /** Supporting copy shown below the title. */
+    description: React.ReactNode;
+    /** Label for the primary upgrade CTA. Include pricing here if relevant. */
+    primaryActionLabel: React.ReactNode;
+    /** Called when the primary upgrade CTA is clicked. */
+    onPrimaryAction: () => void;
+    /** Optional secondary action label, typically for "maybe later" or dismiss behavior. */
+    secondaryActionLabel?: React.ReactNode;
+    /** Called when the optional secondary action is clicked. */
+    onSecondaryAction?: () => void;
+    /** Small eyebrow label shown above the title in the comparison variant. */
+    eyebrow?: React.ReactNode;
+    /** Feature comparison rows for the comparison variant. */
+    rows?: UpgradeComparisonRow[];
+    /** Column header for the current plan. Defaults to "Current". */
+    currentPlanLabel?: React.ReactNode;
+    /** Column header for the upgraded plan. Defaults to "Upgrade". */
+    upgradedPlanLabel?: React.ReactNode;
+    /** Small body text shown below the comparison table, before the action buttons. */
+    footer?: React.ReactNode;
+    /** Optional close icon action for the comparison variant. */
+    onClose?: () => void;
+    /** Accessible label for the comparison close icon. Defaults to "Close". */
+    closeLabel?: string;
+    className?: string;
+}
+declare function UpgradePrompt({ variant, title, description, primaryActionLabel, onPrimaryAction, secondaryActionLabel, onSecondaryAction, eyebrow, rows, currentPlanLabel, upgradedPlanLabel, footer, onClose, closeLabel, className, }: UpgradePromptProps): react_jsx_runtime.JSX.Element;
+
+interface SectionTitleProps {
+    title: string;
+    description?: string;
+    badge?: string;
+    className?: string;
+}
+declare function SectionTitle({ title, description, badge, className }: SectionTitleProps): react_jsx_runtime.JSX.Element;
+
+interface HeroSectionProps {
+    heading: string;
+    badge?: string;
+    description: string;
+    primaryCta: {
+        label: string;
+        href: string;
+    };
+    secondaryCta?: {
+        label: string;
+        href: string;
+    };
+    heroImage: React.ReactNode;
+    avatarUrls?: string[];
+    socialProofText?: string;
+    renderLink?: AppShellRenderLink;
+}
+declare function HeroSection({ heading, badge, description, primaryCta, secondaryCta, heroImage, avatarUrls, socialProofText, renderLink, }: HeroSectionProps): react_jsx_runtime.JSX.Element;
+
+interface FeaturesSectionProps {
+    title?: string;
+    description?: string;
+    badge?: string;
+    features: Array<{
+        icon: LucideIcon;
+        title: string;
+        description: string;
+        href?: string;
+    }>;
+}
+declare function FeaturesSection({ title, description, badge, features, }: FeaturesSectionProps): react_jsx_runtime.JSX.Element;
+
+interface CtaSectionProps {
+    heading: string;
+    description: string;
+    primaryCta: {
+        label: string;
+        href: string;
+    };
+    secondaryCta?: {
+        label: string;
+        href: string;
+    };
+    footnote?: string;
+    renderLink?: AppShellRenderLink;
+}
+declare function CtaSection({ heading, description, primaryCta, secondaryCta, footnote, renderLink, }: CtaSectionProps): react_jsx_runtime.JSX.Element;
+
+interface PricingFeature {
+    label: string;
+    included: boolean;
+}
+interface PricingCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    name: string;
+    price: string;
+    period?: string;
+    description: string;
+    features: PricingFeature[];
+    cta: string;
+    highlighted?: boolean;
+    badge?: string;
+    onSelect?: () => void;
+}
+declare function PricingCard({ name, price, period, description, features, cta, highlighted, badge, onSelect, className, ...props }: PricingCardProps): react_jsx_runtime.JSX.Element;
+
+interface PricingPlan {
+    name: string;
+    monthly: number;
+    annual: number;
+    description: string;
+    cta: string;
+    highlighted?: boolean;
+    features: PricingFeature[];
+}
+interface PricingSectionProps {
+    title?: string;
+    description?: string;
+    badge?: string;
+    plans: PricingPlan[];
+    saveBadge?: string;
+    isAuthenticated?: boolean;
+    renderLink?: AppShellRenderLink;
+    footnote?: string;
+}
+declare function PricingSection({ title, description, badge, plans, saveBadge, isAuthenticated, renderLink, footnote, }: PricingSectionProps): react_jsx_runtime.JSX.Element;
+
+interface TestimonialsSectionProps {
+    title?: string;
+    description?: string;
+    badge?: string;
+    testimonials: Array<{
+        quote: string;
+        name: string;
+        role: string;
+        company?: string;
+        avatar?: string;
+        initials?: string;
+        rating?: number;
+    }>;
+}
+declare function TestimonialsSection({ title, description, badge, testimonials, }: TestimonialsSectionProps): react_jsx_runtime.JSX.Element;
+
+declare function TeamSection(): react_jsx_runtime.JSX.Element;
+
+interface FaqSectionProps {
+    title?: string;
+    description?: string;
+    badge?: string;
+    items: Array<{
+        question: string;
+        answer: string;
+    }>;
+}
+declare function FaqSection({ title, description, badge, items, }: FaqSectionProps): react_jsx_runtime.JSX.Element;
+
+interface StatsSectionProps {
+    title?: string;
+    description?: string;
+    badge?: string;
+    stats: Array<{
+        value: string;
+        label: string;
+        description?: string;
+    }>;
+}
+declare function StatsSection({ title, description, badge, stats, }: StatsSectionProps): react_jsx_runtime.JSX.Element;
+
+declare function NewsletterSection(): react_jsx_runtime.JSX.Element;
+
+declare function ContactSection(): react_jsx_runtime.JSX.Element;
+
+interface NavbarProps {
+    brand: {
+        name: string;
+        logo?: React.ReactNode;
+        href?: string;
+    };
+    navLinks: Array<{
+        label: string;
+        href: string;
+    }>;
+    cta?: {
+        primary?: {
+            label: string;
+            href: string;
+        };
+        secondary?: {
+            label: string;
+            href: string;
+        };
+    };
+    showThemeToggle?: boolean;
+    renderLink?: AppShellRenderLink;
+}
+declare function Navbar({ brand, navLinks, cta, showThemeToggle, renderLink, }: NavbarProps): react_jsx_runtime.JSX.Element;
+
+interface FooterProps {
+    brand: {
+        name: string;
+        logo?: ReactNode;
+        href?: string;
+    };
+    navLinks?: Array<{
+        label: string;
+        href: string;
+    }>;
+    socialLinks?: Array<{
+        label: string;
+        href: string;
+        icon: ReactNode;
+    }>;
+    legal?: string;
+    renderLink?: AppShellRenderLink;
+}
+declare function Footer({ brand, navLinks, socialLinks, legal, renderLink, }: FooterProps): react_jsx_runtime.JSX.Element;
+
+interface LogoStripProps {
+    logos: Array<{
+        src: string;
+        darkSrc?: string;
+        alt: string;
+        href?: string;
+    }>;
+    label?: string;
+    speed?: 'slow' | 'normal' | 'fast';
+}
+declare function LogoStrip({ logos, label, speed, }: LogoStripProps): react_jsx_runtime.JSX.Element;
+
+interface GridUnderlayProps extends React.SVGAttributes<SVGElement> {
+    variant: 'dots' | 'lines' | 'cross';
+    size?: number;
+    className?: string;
+}
+declare const blurClass: {
+    readonly sm: "blur-xl";
+    readonly md: "blur-2xl";
+    readonly lg: "blur-3xl";
+    readonly xl: "blur-[80px]";
+};
+interface GlowUnderlayProps extends React.HTMLAttributes<HTMLDivElement> {
+    size?: number;
+    color?: string;
+    followCursor?: boolean;
+    blur?: keyof typeof blurClass;
+}
+type UnderlayVariant = 'dots' | 'lines' | 'cross' | 'glow';
+type UnderlayProps = ({
+    variant: 'dots' | 'lines' | 'cross';
+} & Omit<GridUnderlayProps, 'variant'>) | ({
+    variant: 'glow';
+} & Omit<GlowUnderlayProps, 'variant'>);
+declare function Underlay(props: UnderlayProps): react_jsx_runtime.JSX.Element;
+
+interface DimOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
+    opacity?: number;
+}
+type ScrimDirection = 'top' | 'bottom' | 'left' | 'right';
+interface ScrimOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
+    direction?: ScrimDirection;
+    color?: string;
+}
+interface LoadingOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
+    label?: string;
+}
+type OverlayVariant = 'dim' | 'scrim' | 'loading';
+type OverlayProps = ({
+    variant: 'dim';
+} & DimOverlayProps) | ({
+    variant: 'scrim';
+} & ScrimOverlayProps) | ({
+    variant: 'loading';
+} & LoadingOverlayProps);
+declare function Overlay(props: OverlayProps): react_jsx_runtime.JSX.Element;
+
+interface FadeInProps extends React.HTMLAttributes<HTMLDivElement> {
+    delay?: number;
+    duration?: number;
+    direction?: 'up' | 'down' | 'left' | 'right' | 'none';
+    once?: boolean;
+    children: React.ReactNode;
+}
+declare function FadeIn({ delay, duration, direction, once, children, className, style, ...props }: FadeInProps): react_jsx_runtime.JSX.Element;
+
+interface StaggerChildrenProps extends React.HTMLAttributes<HTMLDivElement> {
+    stagger?: number;
+    delay?: number;
+    duration?: number;
+    direction?: 'up' | 'down' | 'left' | 'right' | 'none';
+    once?: boolean;
+    children: React.ReactNode;
+}
+declare function StaggerChildren({ stagger, delay, duration, direction, once, children, className, ...props }: StaggerChildrenProps): react_jsx_runtime.JSX.Element;
+
+interface CountUpProps extends React.HTMLAttributes<HTMLSpanElement> {
+    from?: number;
+    to: number;
+    duration?: number;
+    decimals?: number;
+    prefix?: string;
+    suffix?: string;
+    once?: boolean;
+}
+declare function CountUp({ from, to, duration, decimals, prefix, suffix, once, className, ...props }: CountUpProps): react_jsx_runtime.JSX.Element;
+
+interface PageTransitionProps extends React.HTMLAttributes<HTMLDivElement> {
+    variant?: 'fade' | 'slide-up' | 'slide-down';
+    duration?: number;
+    children: React.ReactNode;
+}
+declare function PageTransition({ variant, duration, children, className, style, ...props }: PageTransitionProps): react_jsx_runtime.JSX.Element;
+
+interface SpotlightItem {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: React.ReactNode;
+    onSelect: () => void;
+}
+interface SpotlightGroup {
+    heading: string;
+    items: SpotlightItem[];
+}
+interface SpotlightProps {
+    groups: SpotlightGroup[];
+    placeholder?: string;
+    trigger?: React.ReactNode;
+    triggerClassName?: string;
+    shortcut?: string;
+}
+declare function Spotlight({ groups, placeholder, trigger, triggerClassName, shortcut, }: SpotlightProps): react_jsx_runtime.JSX.Element;
+
+interface DockItem {
+    icon: LucideIcon;
+    label: string;
+    href?: string;
+    onClick?: () => void;
+}
+interface DockProps extends React.HTMLAttributes<HTMLDivElement> {
+    items: DockItem[];
+    iconSize?: number;
+    magnification?: number;
+}
+declare function Dock({ items, iconSize, magnification, className, ...props }: DockProps): react_jsx_runtime.JSX.Element;
+
+interface ContextMenuAction {
+    type: 'item';
+    label: string;
+    shortcut?: string;
+    disabled?: boolean;
+    onSelect?: () => void;
+}
+interface ContextMenuSeparatorDef {
+    type: 'separator';
+}
+interface ContextMenuLabelDef {
+    type: 'label';
+    label: string;
+}
+interface ContextMenuSubDef {
+    type: 'sub';
+    label: string;
+    items: ContextMenuDef[];
+}
+type ContextMenuDef = ContextMenuAction | ContextMenuSeparatorDef | ContextMenuLabelDef | ContextMenuSubDef;
+interface ContextMenuProps {
+    items: ContextMenuDef[];
+    children: React.ReactNode;
+}
+declare function ContextMenu({ items, children }: ContextMenuProps): react_jsx_runtime.JSX.Element;
+
+interface ConfirmOptions {
+    title?: string;
+    description?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+interface UseConfirmReturn {
+    confirm: (options?: ConfirmOptions) => Promise<boolean>;
+    isOpen: boolean;
+    options: ConfirmOptions;
+    handleConfirm: () => void;
+    handleCancel: () => void;
+}
+/**
+ * Headless confirmation hook. Returns state and handlers for building a confirm dialog.
+ *
+ * @example
+ * const { confirm, isOpen, options, handleConfirm, handleCancel } = useConfirm();
+ *
+ * // Trigger confirmation
+ * const ok = await confirm({ title: 'Delete item?', description: 'This cannot be undone.' });
+ *
+ * // Wire up your dialog
+ * <AlertDialog open={isOpen}>
+ *   <AlertDialogContent>
+ *     <AlertDialogTitle>{options.title}</AlertDialogTitle>
+ *     <AlertDialogFooter>
+ *       <AlertDialogCancel onClick={handleCancel} />
+ *       <AlertDialogAction onClick={handleConfirm} />
+ *     </AlertDialogFooter>
+ *   </AlertDialogContent>
+ * </AlertDialog>
+ */
+declare function useConfirm(): UseConfirmReturn;
+
+interface ConfirmDialogProps extends Pick<UseConfirmReturn, 'isOpen' | 'options' | 'handleConfirm' | 'handleCancel'> {
+    destructive?: boolean;
+}
+declare function ConfirmDialog({ isOpen, options, handleConfirm, handleCancel, destructive }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
+
+interface GlassCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    blur?: 'sm' | 'md' | 'lg';
+    children: React.ReactNode;
+}
+declare function GlassCard({ blur, className, children, ...props }: GlassCardProps): react_jsx_runtime.JSX.Element;
+
+interface FeatureCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    icon: LucideIcon;
+    title: string;
+    description: string;
+    href?: string;
+}
+declare function FeatureCard({ icon: Icon, title, description, href, className, ...props }: FeatureCardProps): react_jsx_runtime.JSX.Element;
+
+interface StatCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    value: string;
+    label: string;
+    delta?: string;
+    trend?: 'up' | 'down' | 'neutral';
+    description?: string;
+}
+declare function StatCard({ value, label, delta, trend, description, className, ...props }: StatCardProps): react_jsx_runtime.JSX.Element;
+
+interface TestimonialCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    quote: string;
+    name: string;
+    role: string;
+    company?: string;
+    avatar?: string;
+    initials?: string;
+    rating?: number;
+}
+declare function TestimonialCard({ quote, name, role, company, avatar, initials, rating, className, ...props }: TestimonialCardProps): react_jsx_runtime.JSX.Element;
+
+interface ImageCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    src: string;
+    alt?: string;
+    overlay?: 'none' | 'subtle' | 'strong';
+    aspectRatio?: 'video' | 'square' | 'portrait' | 'auto';
+    children?: React.ReactNode;
+}
+declare function ImageCard({ src, alt, overlay, aspectRatio, children, className, ...props }: ImageCardProps): react_jsx_runtime.JSX.Element;
+
+interface FullPageSpinnerProps {
+    message?: string;
+}
+declare function FullPageSpinner({ message }: FullPageSpinnerProps): react_jsx_runtime.JSX.Element;
+
+interface PageHeaderBreadcrumb {
+    label: string;
+    href?: string;
+}
+interface PageHeaderBackButton {
+    label?: string;
+    href?: string;
+    onClick?: () => void;
+}
+interface PageHeaderProps {
+    title: string;
+    description?: string;
+    breadcrumbs?: PageHeaderBreadcrumb[];
+    backButton?: PageHeaderBackButton;
+    renderLink?: AppShellRenderLink;
+    className?: string;
+    children?: React.ReactNode;
+}
+declare function PageHeader({ title, description, breadcrumbs, backButton, renderLink, className, children, }: PageHeaderProps): react_jsx_runtime.JSX.Element;
+
+interface SuspensedProps {
+    children: React.ReactNode;
+    fallback?: React.ReactNode;
+}
+declare function Suspensed({ children, fallback }: SuspensedProps): react_jsx_runtime.JSX.Element;
+
+declare function ThemeSwitchMinimal(): react_jsx_runtime.JSX.Element;
+
+interface ThemeColorUpdaterProps {
+    colorTheme?: string;
+}
+/**
+ * Applies a data-theme attribute to the document root when a color theme is selected.
+ * Use CSS selectors like `[data-theme="blue"] { --primary: ... }` to apply theme colors.
+ */
+declare function ThemeColorUpdater({ colorTheme }: ThemeColorUpdaterProps): null;
+
+interface VersionBannerProps {
+    version: string;
+    message?: string;
+    className?: string;
+    onDismiss?: () => void;
+}
+declare function VersionBanner({ version, message, className, onDismiss }: VersionBannerProps): react_jsx_runtime.JSX.Element | null;
+
+interface DevBannerProps {
+    environment?: string;
+    className?: string;
+}
+declare function DevBanner({ environment, className }: DevBannerProps): react_jsx_runtime.JSX.Element;
+
+interface Hotkey {
+    key: string;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    handler: () => void;
+    description?: string;
+}
+interface RegisterHotkeysProps {
+    hotkeys: Hotkey[];
+}
+declare function RegisterHotkeys({ hotkeys }: RegisterHotkeysProps): null;
+
+interface RootErrorFallbackProps {
+    error: Error;
+    resetErrorBoundary?: () => void;
+}
+declare function RootErrorFallback({ error, resetErrorBoundary }: RootErrorFallbackProps): react_jsx_runtime.JSX.Element;
+
+declare function useMounted(): boolean;
+
+interface UseControlledOpenReturn {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    setIsOpen: React.Dispatch<React.SetStateAction<boolean>>;
+}
+/**
+ * Simple open/close state hook for modals, drawers, dropdowns, and any toggleable UI.
+ *
+ * @example
+ * const { isOpen, open, close } = useControlledOpen();
+ * return (
+ *   <>
+ *     <Button onClick={open}>Open</Button>
+ *     <Dialog open={isOpen} onOpenChange={setIsOpen}>...</Dialog>
+ *   </>
+ * );
+ */
+declare function useControlledOpen(defaultOpen?: boolean): UseControlledOpenReturn;
+
+/**
+ * Returns true when the page has scrolled past a given Y threshold in pixels.
+ * Useful for showing/hiding sticky headers, back-to-top buttons, etc.
+ *
+ * @example
+ * const scrolledPast = useScrolledPast(100);
+ * return <header className={scrolledPast ? 'shadow-md' : ''}>...</header>;
+ */
+declare function useScrolledPast(threshold: number): boolean;
+
+declare function useCopyToClipboard(): [boolean, (text: string) => void];
+
+declare function useDebounce<T>(value: T, delay: number): T;
+
+declare function useIntersectionObserver(options?: IntersectionObserverInit): [React.RefObject<Element | null>, boolean];
+
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T) => void];
+
+declare function useMediaQuery(query: string): boolean;
+
+interface UsePaginationReturn {
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    offset: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+    goTo: (page: number) => void;
+    next: () => void;
+    prev: () => void;
+}
+declare function usePagination(total: number, pageSize: number): UsePaginationReturn;
+
+export { type AppNavItem, AppShell, type AppShellAction, type AppShellBrand, type AppShellProps, type AppShellRenderLink, type AppShellUser, type AuthFormProps, AuthSection, type AuthSectionProps, Badge, type BadgeProps, Button, type ButtonProps, Card, type CardProps, Checkbox, type CheckboxProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmOptions, ContactSection, ContextMenu, type ContextMenuDef, type ContextMenuProps, CountUp, type CountUpProps, CtaSection, type CtaSectionProps, DevBanner, type DevBannerProps, Dock, type DockItem, type DockProps, EmptyState, type EmptyStateProps, ErrorPage, type ErrorPageProps, FadeIn, type FadeInProps, FaqSection, type FaqSectionProps, FeatureCard, type FeatureCardProps, FeaturesSection, type FeaturesSectionProps, Footer, type FooterProps, FullPageSpinner, GlassCard, type GlassCardProps, HeroSection, type HeroSectionProps, type Hotkey, ImageCard, type ImageCardProps, Input, type InputProps, LogoStrip, type LogoStripProps, Navbar, type NavbarProps, NewsletterSection, OlwibaUIProvider, type OlwibaUIProviderProps, Overlay, type OverlayProps, type OverlayVariant, PageHeader, type PageHeaderBackButton, type PageHeaderBreadcrumb, type PageHeaderProps, PageTransition, type PageTransitionProps, PricingCard, type PricingCardProps, type PricingFeature, type PricingPlan, PricingSection, type PricingSectionProps, RegisterHotkeys, RootErrorFallback, SectionTitle, type SectionTitleProps, Spotlight, type SpotlightGroup, type SpotlightItem, type SpotlightProps, StaggerChildren, type StaggerChildrenProps, StatCard, type StatCardProps, StatsSection, type StatsSectionProps, Suspensed, Switch, type SwitchProps, TeamSection, TestimonialCard, type TestimonialCardProps, TestimonialsSection, type TestimonialsSectionProps, Textarea, type TextareaProps, ThemeColorUpdater, ThemeSwitchMinimal, type UIMode, Underlay, type UnderlayProps, type UnderlayVariant, type UpgradeComparisonRow, UpgradePrompt, type UpgradePromptProps, type UseConfirmReturn, type UseControlledOpenReturn, type UsePaginationReturn, VersionBanner, cn, useConfirm, useControlledOpen, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMediaQuery, useMounted, useOlwibaUI, usePagination, useScrolledPast, useUIMode };