@djangocfg/ui-nextjs 2.1.103 → 2.1.104

package/dist/index.d.mts

@@ -1,1044 +0,0 @@
-import * as _djangocfg_ui_core_components from '@djangocfg/ui-core/components';
-import { ButtonProps, TooltipContent, Separator } from '@djangocfg/ui-core/components';
-export * from '@djangocfg/ui-core/components';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React from 'react';
-import React__default, { RefObject, ReactNode } from 'react';
-import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
-import * as class_variance_authority_types from 'class-variance-authority/types';
-import { VariantProps } from 'class-variance-authority';
-export * from '@djangocfg/ui-core/hooks';
-import { Keys, HotkeyCallback, Options } from 'react-hotkeys-hook';
-export { HotkeyCallback, HotkeysProvider, Keys, isHotkeyPressed, useHotkeysContext } from 'react-hotkeys-hook';
-import { ThemeProviderProps as ThemeProviderProps$1 } from 'next-themes';
-
-declare const Breadcrumb: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & {
-    separator?: React.ReactNode;
-} & React.RefAttributes<HTMLElement>>;
-declare const BreadcrumbList: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.OlHTMLAttributes<HTMLOListElement>, HTMLOListElement>, "ref"> & React.RefAttributes<HTMLOListElement>>;
-declare const BreadcrumbItem$1: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & {
-    key?: React.Key;
-} & React.RefAttributes<HTMLLIElement>>;
-declare const BreadcrumbLink: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref"> & {
-    asChild?: boolean;
-    href?: string;
-} & React.RefAttributes<HTMLAnchorElement>>;
-declare const BreadcrumbPage: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
-declare const BreadcrumbSeparator: {
-    ({ children, className, ...props }: React.ComponentProps<"li"> & {
-        key?: React.Key;
-    }): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const BreadcrumbEllipsis: {
-    ({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
-interface BreadcrumbItem {
-    /** Display text for the breadcrumb */
-    label: string;
-    /** URL to navigate to. If not provided, item will be rendered as current page */
-    href?: string;
-    /** Whether this item is the current page (will be rendered as BreadcrumbPage) */
-    isCurrentPage?: boolean;
-    /** Optional icon to display before the label */
-    icon?: React__default.ReactNode;
-}
-interface BreadcrumbNavigationProps {
-    /** Array of breadcrumb items */
-    items: BreadcrumbItem[];
-    /** Custom separator between items */
-    separator?: React__default.ReactNode;
-    /** Maximum number of items to show before collapsing with ellipsis */
-    maxItems?: number;
-    /** Custom className for the breadcrumb container */
-    className?: string;
-    /** Whether to use Next.js Link component for navigation */
-    useNextLink?: boolean;
-}
-declare const BreadcrumbNavigation: React__default.FC<BreadcrumbNavigationProps>;
-
-declare const DropdownMenu: React.FC<DropdownMenuPrimitive.DropdownMenuProps>;
-declare const DropdownMenuTrigger: React.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuTriggerProps & React.RefAttributes<HTMLButtonElement>>;
-declare const DropdownMenuGroup: React.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuGroupProps & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuSub: React.FC<DropdownMenuPrimitive.DropdownMenuSubProps>;
-declare const DropdownMenuRadioGroup: React.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuSubTrigger: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSubTriggerProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-    inset?: boolean;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuSubContent: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSubContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuContent: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuItem: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-    inset?: boolean;
-    href?: string;
-    key?: React.Key;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-    key?: React.Key;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuRadioItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-    key?: React.Key;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuLabel: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
-    inset?: boolean;
-} & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuShortcut: {
-    ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
-declare const Pagination: {
-    ({ className, ...props }: React.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const PaginationContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
-declare const PaginationItem: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLLIElement> & React.LiHTMLAttributes<HTMLLIElement> & {
-    key?: React.Key;
-}, "ref"> & React.RefAttributes<HTMLLIElement>>;
-type PaginationLinkProps = {
-    isActive?: boolean;
-    href?: string;
-} & Pick<ButtonProps, "size"> & React.ComponentProps<"a">;
-declare const PaginationLink: {
-    ({ className, isActive, size, href, children, ...props }: PaginationLinkProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const PaginationPrevious: {
-    ({ className, ...props }: React.ComponentProps<typeof PaginationLink>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const PaginationNext: {
-    ({ className, ...props }: React.ComponentProps<typeof PaginationLink>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const PaginationEllipsis: {
-    ({ className, ...props }: React.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
-interface SSRPaginationProps {
-    currentPage: number;
-    totalPages: number;
-    totalItems: number;
-    itemsPerPage: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-    className?: string;
-    showInfo?: boolean;
-    maxVisiblePages?: number;
-    baseUrl?: string;
-    pathname?: string;
-    preserveQuery?: boolean;
-}
-declare const SSRPagination: React__default.FC<SSRPaginationProps>;
-
-/**
- * DRF Static Pagination Component
- *
- * Universal pagination component that works with Django REST Framework pagination format.
- * Manages page state internally and provides callbacks for page changes.
- *
- * DRF Pagination Response Format:
- * {
- *   "count": 150,           // Total number of items
- *   "page": 1,              // Current page number
- *   "pages": 15,            // Total number of pages
- *   "page_size": 10,        // Items per page
- *   "has_next": true,       // Whether there's a next page
- *   "has_previous": false,  // Whether there's a previous page
- *   "next_page": 2,         // Next page number (or null)
- *   "previous_page": null,  // Previous page number (or null)
- *   "results": [...]        // Array of items
- * }
- *
- * Usage with SWR:
- * ```tsx
- * import { StaticPagination, useDRFPagination } from '@djangocfg/ui-nextjs';
- *
- * function MyComponent() {
- *   const pagination = useDRFPagination();
- *   const { data, isLoading } = useMyAPI(pagination.params);
- *
- *   return (
- *     <div>
- *       {data?.results?.map(item => <Item key={item.id} {...item} />)}
- *       <StaticPagination data={data} onPageChange={pagination.setPage} />
- *     </div>
- *   );
- * }
- * ```
- */
-
-/**
- * DRF Pagination Response type
- */
-interface DRFPaginatedResponse<T = any> {
-    count: number;
-    page: number;
-    pages: number;
-    page_size: number;
-    has_next: boolean;
-    has_previous: boolean;
-    next_page?: number | null;
-    previous_page?: number | null;
-    results: T[];
-}
-interface StaticPaginationProps {
-    /** The DRF paginated response data */
-    data?: DRFPaginatedResponse | null;
-    /** Callback when page changes */
-    onPageChange: (page: number) => void;
-    /** Additional CSS class */
-    className?: string;
-    /** Show pagination info (default: true) */
-    showInfo?: boolean;
-    /** Maximum visible page numbers (default: 7) */
-    maxVisiblePages?: number;
-}
-declare const StaticPagination: React__default.FC<StaticPaginationProps>;
-/**
- * Hook to manage DRF pagination state
- *
- * Manages page and page_size state and provides methods to change them.
- * Works seamlessly with SWR hooks that accept params.
- *
- * Usage:
- * ```tsx
- * import { useDRFPagination } from '@djangocfg/ui-nextjs';
- * import { useMyPaginatedAPI } from './api/hooks';
- *
- * function MyComponent() {
- *   const pagination = useDRFPagination();
- *   const { data, isLoading } = useMyPaginatedAPI(pagination.params);
- *
- *   return (
- *     <div>
- *       {data?.results?.map(item => <Item key={item.id} {...item} />)}
- *       <StaticPagination data={data} onPageChange={pagination.setPage} />
- *     </div>
- *   );
- * }
- * ```
- */
-declare function useDRFPagination(initialPage?: number, initialPageSize?: number): {
-    page: number;
-    pageSize: number;
-    setPage: React__default.Dispatch<React__default.SetStateAction<number>>;
-    setPageSize: (newPageSize: number) => void;
-    params: {
-        page: number;
-        page_size: number;
-    };
-    reset: () => void;
-};
-/**
- * Hook to extract pagination info from DRF response
- *
- * Useful when you need pagination metadata in your component logic.
- *
- * Usage:
- * ```tsx
- * const paginationInfo = useDRFPaginationInfo(data);
- * if (paginationInfo) {
- *   console.log(`Page ${paginationInfo.currentPage} of ${paginationInfo.totalPages}`);
- * }
- * ```
- */
-declare function useDRFPaginationInfo(data?: DRFPaginatedResponse | null): {
-    totalItems: number;
-    currentPage: number;
-    totalPages: number;
-    itemsPerPage: number;
-    hasNext: boolean;
-    hasPrevious: boolean;
-    nextPage: number;
-    previousPage: number;
-    results: any[];
-    resultsCount: number;
-};
-
-type SidebarContextProps = {
-    state: "expanded" | "collapsed";
-    open: boolean;
-    setOpen: (open: boolean) => void;
-    openMobile: boolean;
-    setOpenMobile: (open: boolean) => void;
-    isMobile: boolean;
-    toggleSidebar: () => void;
-};
-declare function useSidebar(): SidebarContextProps;
-declare const SidebarProvider: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
-    defaultOpen?: boolean;
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const Sidebar: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
-    side?: "left" | "right";
-    variant?: "sidebar" | "floating" | "inset";
-    collapsible?: "offcanvas" | "icon" | "none";
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarTrigger: React.ForwardRefExoticComponent<Omit<_djangocfg_ui_core_components.ButtonProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-declare const SidebarRail: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-declare const SidebarInset: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarInput: React.ForwardRefExoticComponent<Omit<Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
-declare const SidebarHeader: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarSeparator: React.ForwardRefExoticComponent<React.ComponentProps<typeof Separator> & React.RefAttributes<React.ElementRef<typeof Separator>>>;
-declare const SidebarContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarGroup: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarGroupLabel: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarGroupAction: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-declare const SidebarGroupContent: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarMenu: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
-declare const SidebarMenuItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
-declare const SidebarMenuButton: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-    isActive?: boolean;
-    tooltip?: string | React.ComponentProps<typeof TooltipContent>;
-    href?: string;
-} & VariantProps<(props?: {
-    variant?: "default" | "outline";
-    size?: "default" | "sm" | "lg";
-} & class_variance_authority_types.ClassProp) => string>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-declare const SidebarMenuAction: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & {
-    asChild?: boolean;
-    showOnHover?: boolean;
-}, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-declare const SidebarMenuBadge: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarMenuSkeleton: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLDivElement> & React.HTMLAttributes<HTMLDivElement> & {
-    showIcon?: boolean;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SidebarMenuSub: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "ref"> & React.RefAttributes<HTMLUListElement>>;
-declare const SidebarMenuSubItem: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
-declare const SidebarMenuSubButton: React.ForwardRefExoticComponent<Omit<React.ClassAttributes<HTMLAnchorElement> & React.AnchorHTMLAttributes<HTMLAnchorElement> & {
-    asChild?: boolean;
-    size?: "sm" | "md";
-    isActive?: boolean;
-    href?: string;
-}, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
-
-type ResolvedTheme = 'light' | 'dark';
-/**
- * Hook to detect the current resolved theme (light or dark)
- *
- * Standalone hook - doesn't require ThemeProvider.
- * Detects theme from:
- * 1. 'dark' class on html element
- * 2. System preference (prefers-color-scheme)
- *
- * For full theme control (setTheme, toggleTheme), use useThemeContext instead.
- *
- * @example
- * ```tsx
- * const theme = useResolvedTheme(); // 'light' | 'dark'
- * ```
- */
-declare const useResolvedTheme: () => ResolvedTheme;
-
-/**
- * useQueryParams Hook
- *
- * Safe hook to access URL query parameters without requiring Suspense boundary.
- * Works on client-side only, returns empty URLSearchParams during SSR/prerendering.
- *
- * @example
- * ```tsx
- * const params = useQueryParams();
- * const flow = params.get('flow');
- * const hasFlow = params.has('flow');
- * const allTags = params.getAll('tags');
- * ```
- */
-/**
- * Hook to safely access URL query parameters without useSearchParams()
- *
- * This hook reads query parameters directly from window.location.search,
- * avoiding the need for Suspense boundaries that useSearchParams() requires.
- *
- * Automatically updates when URL changes (navigation, back/forward, etc.)
- * Uses pathname from Next.js to detect route changes and polls for query param changes.
- *
- * Returns a URLSearchParams object with get(), getAll(), has(), etc.
- *
- * @returns URLSearchParams object (empty during SSR)
- */
-declare function useQueryParams(): URLSearchParams;
-
-/**
- * Universal Router Hook with BasePath Support
- *
- * Wrapper around Next.js useRouter that automatically handles basePath
- * for static builds served via iframe or subdirectory
- *
- * IMPORTANT: In Next.js 15 App Router, router.push() does NOT automatically
- * handle basePath (unlike Pages Router). This is a breaking change in App Router.
- *
- * This hook ensures basePath is always included when navigating, especially
- * important for static exports served via iframe where basePath is critical.
- *
- * @see https://nextjs.org/docs/app/building-your-application/upgrading/app-router-migration
- */
-/**
- * Router with basePath support
- *
- * Automatically adds basePath to all navigation methods when basePath is configured.
- * In Next.js 15 App Router, router.push() doesn't handle basePath automatically,
- * so this hook uses window.location to ensure basePath is always included.
- *
- * @example
- * ```tsx
- * const router = useCfgRouter();
- *
- * // With basePath='/cfg/admin':
- * router.push('/dashboard');     // Client-side navigation to '/cfg/admin/dashboard'
- * router.replace('/auth');       // Client-side replace with '/cfg/admin/auth'
- * router.hardPush('/dashboard'); // Full page reload to '/cfg/admin/dashboard'
- * router.hardReplace('/auth');   // Full page replace with '/cfg/admin/auth'
- * ```
- */
-declare function useCfgRouter(): {
-    push: (href: string, options?: {
-        scroll?: boolean;
-    }) => void;
-    replace: (href: string, options?: {
-        scroll?: boolean;
-    }) => void;
-    hardPush: (href: string) => void;
-    hardReplace: (href: string) => void;
-    prefetch: (href: string) => void;
-    back: () => void;
-    forward: () => void;
-    refresh: () => void;
-};
-
-/**
- * Options for the useHotkey hook
- */
-interface UseHotkeyOptions extends Omit<Options, 'enabled'> {
-    /** Whether the hotkey is enabled (default: true) */
-    enabled?: boolean;
-    /** Scope for the hotkey - useful for context-specific shortcuts */
-    scope?: string;
-    /** Only trigger when focus is within a specific element */
-    scopes?: string[];
-    /** Prevent default browser behavior */
-    preventDefault?: boolean;
-    /** Enable in input fields and textareas */
-    enableOnFormTags?: boolean | readonly ('input' | 'textarea' | 'select')[];
-    /** Enable when contentEditable element is focused */
-    enableOnContentEditable?: boolean;
-    /** Split key for multiple hotkey combinations (default: ',') */
-    splitKey?: string;
-    /** Key up/down events */
-    keyup?: boolean;
-    keydown?: boolean;
-    /** Description for the hotkey (useful for help dialogs) */
-    description?: string;
-}
-/**
- * Simple wrapper hook for react-hotkeys-hook
- *
- * @example
- * // Single key
- * useHotkey('escape', () => closeModal());
- *
- * @example
- * // Key combination
- * useHotkey('ctrl+s', (e) => {
- *   e.preventDefault();
- *   saveDocument();
- * });
- *
- * @example
- * // Multiple keys (any of them will trigger)
- * useHotkey(['ArrowLeft', '['], () => goToPrevious());
- * useHotkey(['ArrowRight', ']'], () => goToNext());
- *
- * @example
- * // With options
- * useHotkey('/', () => focusSearch(), {
- *   preventDefault: true,
- *   enableOnFormTags: false,
- *   description: 'Focus search input'
- * });
- *
- * @example
- * // Scoped hotkeys
- * useHotkey('delete', () => deleteItem(), { scopes: ['list-view'] });
- *
- * @param keys - Hotkey or array of hotkeys (e.g., 'ctrl+s', 'ArrowLeft', ['[', 'ArrowLeft'])
- * @param callback - Function to call when hotkey is pressed
- * @param options - Configuration options
- * @returns Ref to attach to element for scoped hotkeys
- */
-declare function useHotkey<T extends HTMLElement = HTMLElement>(keys: Keys, callback: HotkeyCallback, options?: UseHotkeyOptions): RefObject<T | null>;
-
-/**
- * Device detection hook wrapper for react-device-detect
- *
- * Provides a convenient interface to access device information including:
- * - Device type (mobile, tablet, desktop, etc.)
- * - Browser information (name, version, etc.)
- * - OS information (name, version, etc.)
- * - Orientation (portrait/landscape)
- *
- * @param userAgent - Optional user agent string (useful for SSR)
- * @returns Device detection object with all available information
- *
- * @example
- * ```tsx
- * const device = useDeviceDetect();
- *
- * if (device.isMobile) {
- *   return <MobileView />;
- * }
- *
- * return <DesktopView />;
- * ```
- */
-declare function useDeviceDetect(userAgent?: string): {
-    isMobile: boolean;
-    isTablet: boolean;
-    isDesktop: boolean;
-    isBrowser: boolean;
-    isMobileOnly: boolean;
-    isSmartTV: boolean;
-    isConsole: boolean;
-    isWearable: boolean;
-    isEmbedded: boolean;
-    isAndroid: boolean;
-    isIOS: boolean;
-    isWindows: boolean;
-    isMacOs: boolean;
-    isWinPhone: boolean;
-    isChrome: boolean;
-    isFirefox: boolean;
-    isSafari: boolean;
-    isOpera: boolean;
-    isIE: boolean;
-    isEdge: boolean;
-    isEdgeChromium: boolean;
-    isLegacyEdge: boolean;
-    isChromium: boolean;
-    isMobileSafari: boolean;
-    isYandex: boolean;
-    isMIUI: boolean;
-    isSamsungBrowser: boolean;
-    isElectron: boolean;
-    isIOS13: boolean;
-    isIPad13: boolean;
-    isIPhone13: boolean;
-    isIPod13: boolean;
-    deviceType: string;
-    osName: string;
-    osVersion: string;
-    browserName: string;
-    browserVersion: string;
-    fullBrowserVersion: string;
-    mobileVendor: string;
-    mobileModel: string;
-    engineName: string;
-    engineVersion: string;
-    getUA: string;
-    isPortrait: boolean;
-    isLandscape: boolean;
-    orientation: "portrait" | "landscape";
-    selectors: {
-        isMobile: boolean;
-        isTablet: boolean;
-        isDesktop: boolean;
-        isBrowser: boolean;
-        isMobileOnly: boolean;
-        isSmartTV: boolean;
-        isConsole: boolean;
-        isWearable: boolean;
-        isEmbedded: boolean;
-        isAndroid: boolean;
-        isIOS: boolean;
-        isWindows: boolean;
-        isMacOs: boolean;
-        isWinPhone: boolean;
-        isChrome: boolean;
-        isFirefox: boolean;
-        isSafari: boolean;
-        isOpera: boolean;
-        isIE: boolean;
-        isEdge: boolean;
-        isEdgeChromium: boolean;
-        isLegacyEdge: boolean;
-        isChromium: boolean;
-        isMobileSafari: boolean;
-        isYandex: boolean;
-        isMIUI: boolean;
-        isSamsungBrowser: boolean;
-        isElectron: boolean;
-        osVersion: string;
-        osName: string;
-        fullBrowserVersion: string;
-        browserVersion: string;
-        browserName: string;
-        mobileVendor: string;
-        mobileModel: string;
-        engineName: string;
-        engineVersion: string;
-        getUA: string;
-        deviceType: string;
-        isIOS13: boolean;
-        isIPad13: boolean;
-        isIPhone13: boolean;
-        isIPod13: boolean;
-    };
-    deviceData: {
-        deviceType: string;
-        osName: string;
-        osVersion: string;
-        browserName: string;
-        browserVersion: string;
-        fullBrowserVersion: string;
-        mobileVendor: string;
-        mobileModel: string;
-        engineName: string;
-        engineVersion: string;
-        getUA: string;
-    };
-};
-type DeviceDetectResult = ReturnType<typeof useDeviceDetect>;
-
-/**
- * Advanced browser detection hook
- *
- * Detects modern browsers including Chromium-based browsers that may
- * incorrectly report as Safari (Arc, Brave, Vivaldi, Comet, etc.)
- */
-interface BrowserInfo {
-    isChrome: boolean;
-    isChromium: boolean;
-    isSafari: boolean;
-    isFirefox: boolean;
-    isEdge: boolean;
-    isOpera: boolean;
-    isBrave: boolean;
-    isArc: boolean;
-    isVivaldi: boolean;
-    isYandex: boolean;
-    isSamsungBrowser: boolean;
-    isUCBrowser: boolean;
-    isComet: boolean;
-    isOperaMini: boolean;
-    isIE: boolean;
-    isFacebookInApp: boolean;
-    isInstagramInApp: boolean;
-    isTikTokInApp: boolean;
-    isSnapchatInApp: boolean;
-    isWeChatInApp: boolean;
-    isThreadsInApp: boolean;
-    isLinkedInInApp: boolean;
-    isTwitterInApp: boolean;
-    isInAppBrowser: boolean;
-    isWebView: boolean;
-    browserName: string;
-    isWebKit: boolean;
-    isBlink: boolean;
-    isGecko: boolean;
-    /**
-     * Whether the browser supports Web Push Notifications.
-     * Returns false for browsers known to NOT support push:
-     * - Opera Mini (no service worker support)
-     * - Internet Explorer (deprecated, no Push API)
-     * - UC Browser (unreliable push support)
-     * - In-App browsers (Facebook, Instagram, TikTok, Snapchat, etc.)
-     * - Generic WebViews (except Twitter/LinkedIn on Android which use Chrome WebView)
-     *
-     * Note: Comet (Perplexity) is Chromium-based and DOES support push notifications.
-     * Note: This is a browser-level check. For full push support,
-     * also check 'serviceWorker' in navigator && 'PushManager' in window
-     */
-    supportsPushNotifications: boolean;
-    isIOSBrowser: boolean;
-    userAgent: string;
-}
-/**
- * Detect browser with improved accuracy for Chromium-based browsers
- *
- * @example
- * ```tsx
- * const browser = useBrowserDetect();
- *
- * if (browser.isSafari && !browser.isChromium) {
- *   // Real Safari
- * }
- *
- * if (browser.isChromium) {
- *   // Any Chromium-based browser (Chrome, Edge, Brave, Arc, etc.)
- * }
- * ```
- */
-declare function useBrowserDetect(): BrowserInfo;
-
-type ArticleType = 'security' | 'release' | 'announcement' | 'feature';
-interface ArticleCardProps {
-    title: string;
-    description?: string;
-    date: string;
-    type: ArticleType;
-    href: string;
-    author?: string;
-    tags?: string[];
-    featured?: boolean;
-    className?: string;
-}
-declare const ArticleCard: React__default.FC<ArticleCardProps>;
-
-interface Article {
-    title: string;
-    description?: string;
-    date: string;
-    type: ArticleType;
-    href: string;
-    author?: string;
-    tags?: string[];
-    featured?: boolean;
-}
-interface ArticleListProps {
-    articles: Article[];
-    title?: string;
-    description?: string;
-    showFeatured?: boolean;
-    columns?: 1 | 2 | 3;
-    className?: string;
-}
-declare const ArticleList: React__default.FC<ArticleListProps>;
-
-interface CTAButton {
-    label: string;
-    href?: string;
-    onClick?: () => void;
-    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
-    size?: 'default' | 'sm' | 'lg' | 'icon';
-}
-interface CTASectionProps {
-    title: string;
-    subtitle?: string;
-    primaryCTA?: CTAButton;
-    secondaryCTA?: CTAButton;
-    background?: 'default' | 'muted' | 'primary' | 'gradient';
-    className?: string;
-    children?: React__default.ReactNode;
-}
-declare const CTASection: React__default.FC<CTASectionProps>;
-
-interface Feature {
-    icon?: React__default.ReactNode;
-    title: string;
-    description: string;
-    gradient?: string;
-}
-interface FeatureSectionProps {
-    title?: string;
-    subtitle?: string;
-    features: Feature[];
-    columns?: 1 | 2 | 3 | 4 | 6;
-    className?: string;
-    background?: 'dark' | 'card' | 'gradient' | 'none';
-    /** Compact variant: smaller icons, no cards, minimal spacing */
-    variant?: 'default' | 'compact';
-}
-declare const FeatureSection: React__default.FC<FeatureSectionProps>;
-
-interface HeroProps {
-    title: string;
-    subtitle?: string;
-    description?: string;
-    primaryAction?: {
-        label: string;
-        href: string;
-        variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
-    };
-    secondaryAction?: {
-        label: string;
-        href: string;
-        variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
-    };
-    background?: 'gradient' | 'solid' | 'image' | 'dark';
-    className?: string;
-    children?: React__default.ReactNode;
-}
-declare const Hero: React__default.FC<HeroProps>;
-
-interface NewsletterSectionProps {
-    title?: string;
-    description?: string;
-    placeholder?: string;
-    buttonText?: string;
-    disclaimer?: string;
-    background?: 'default' | 'muted' | 'primary' | 'gradient';
-    className?: string;
-    onSubmit?: (email: string) => void;
-}
-/**
- * NewsletterSection - Email subscription block
- * Fully responsive and theme-aware (light/dark mode)
- * Follows Tailwind CSS v4 canons - no custom utilities
- */
-declare const NewsletterSection: React__default.FC<NewsletterSectionProps>;
-
-interface SplitHeroBadge {
-    icon?: ReactNode;
-    text: string;
-}
-interface SplitHeroAction {
-    label: string;
-    href?: string;
-    onClick?: () => void;
-    icon?: ReactNode;
-    variant?: 'default' | 'outline' | 'ghost' | 'secondary';
-}
-interface SplitHeroFeature {
-    icon?: ReactNode;
-    text: string;
-}
-/** Image media type */
-interface SplitHeroMediaImage {
-    type: 'image';
-    src: string;
-    alt?: string;
-}
-/** Video media type - uses VideoPlayer */
-interface SplitHeroMediaVideo {
-    type: 'video';
-    url: string;
-    title?: string;
-    poster?: string;
-    autoplay?: boolean;
-    muted?: boolean;
-}
-/** Custom component media type */
-interface SplitHeroMediaCustom {
-    type: 'custom';
-    content: ReactNode;
-}
-type SplitHeroMedia$1 = SplitHeroMediaImage | SplitHeroMediaVideo | SplitHeroMediaCustom;
-interface SplitHeroProps {
-    /** Badge above title */
-    badge?: SplitHeroBadge;
-    /** Main title */
-    title: string;
-    /** Gradient part of title (optional) */
-    titleGradient?: string;
-    /** Subtitle text */
-    subtitle?: string;
-    /** Feature list */
-    features?: SplitHeroFeature[];
-    /** Primary CTA button */
-    primaryAction?: SplitHeroAction;
-    /** Secondary CTA button */
-    secondaryAction?: SplitHeroAction;
-    /** Media content - image, video, or custom component */
-    media?: SplitHeroMedia$1;
-    /** Layout direction */
-    layout?: 'text-left' | 'text-right';
-    /** Mobile stack order */
-    mobileOrder?: 'media-first' | 'text-first';
-    /** Content vertical alignment */
-    align?: 'top' | 'center' | 'bottom';
-    /** Container max width */
-    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
-    /** Background style */
-    background?: 'none' | 'muted' | 'gradient';
-    /** Custom className */
-    className?: string;
-}
-
-declare const SplitHero: React__default.FC<SplitHeroProps>;
-
-interface SplitHeroContentProps {
-    badge?: SplitHeroBadge;
-    title: string;
-    titleGradient?: string;
-    subtitle?: string;
-    features?: SplitHeroFeature[];
-    primaryAction?: SplitHeroAction;
-    secondaryAction?: SplitHeroAction;
-    align?: 'top' | 'center' | 'bottom';
-    className?: string;
-}
-declare const SplitHeroContent: React__default.FC<SplitHeroContentProps>;
-
-interface SplitHeroMediaProps {
-    media: SplitHeroMedia$1;
-    className?: string;
-}
-declare const SplitHeroMedia: React__default.FC<SplitHeroMediaProps>;
-
-interface Stat {
-    number: string;
-    label: string;
-    description?: string;
-    icon?: React__default.ReactNode;
-}
-interface StatsSectionProps {
-    title: string;
-    subtitle?: string;
-    stats: Stat[];
-    columns?: 2 | 3 | 4;
-    className?: string;
-    background?: 'dark' | 'card' | 'gradient';
-}
-declare const StatsSection: React__default.FC<StatsSectionProps>;
-
-type BackgroundVariant = 'aurora-borealis' | 'mesh-gradient' | 'floating-orbs' | 'geometric-flow' | 'liquid-gradient' | 'spotlight' | 'none' | 'gradient-mesh' | 'dot-matrix' | 'grid-lines' | 'aurora' | 'particles' | 'waves';
-interface AnimatedBackgroundProps {
-    variant?: BackgroundVariant;
-    className?: string;
-    intensity?: 'subtle' | 'medium' | 'strong';
-    /** Color scheme - 'vibrant' uses multiple colors, 'monochrome' uses primary only */
-    colorScheme?: 'vibrant' | 'monochrome' | 'cool' | 'warm';
-}
-declare const AnimatedBackground: React__default.FC<AnimatedBackgroundProps>;
-
-type MouseFollowerVariant = 'glow' | 'spotlight' | 'gradient-blob' | 'ring' | 'trail';
-interface MouseFollowerProps {
-    /** Visual style of the follower */
-    variant?: MouseFollowerVariant;
-    /** Size of the effect in pixels */
-    size?: number;
-    /** Color - can be CSS color or 'primary' to use theme */
-    color?: string;
-    /** Smoothness of following (0.05 = very smooth, 0.3 = snappy) */
-    smoothness?: number;
-    /** Opacity of the effect (0-1) */
-    opacity?: number;
-    /** Blur amount for glow effects */
-    blur?: 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
-    /** Additional className for the container */
-    className?: string;
-    /** Whether to show on mobile (touch devices) */
-    showOnMobile?: boolean;
-    /** Disable the effect */
-    disabled?: boolean;
-}
-declare const MouseFollower: React__default.FC<MouseFollowerProps>;
-
-interface HeroFeature {
-    icon: React__default.ReactNode;
-    text: string;
-}
-interface StatItem {
-    number: string;
-    label: string;
-    icon?: React__default.ReactNode;
-}
-interface SuperHeroProps {
-    badge?: {
-        icon?: React__default.ReactNode;
-        text: string;
-    };
-    title: string;
-    titleGradient?: string;
-    subtitle: string;
-    features?: HeroFeature[];
-    primaryAction?: {
-        label: string;
-        href?: string;
-        onClick?: () => void;
-    };
-    secondaryAction?: {
-        label: string;
-        href?: string;
-        onClick?: () => void;
-        icon?: React__default.ReactNode;
-    };
-    stats?: StatItem[];
-    floatingElements?: React__default.ReactNode;
-    backgroundVariant?: BackgroundVariant;
-    backgroundIntensity?: 'subtle' | 'medium' | 'strong';
-    showBackgroundSwitcher?: boolean;
-    /** Single command (for backwards compatibility) */
-    codeCommand?: string;
-    /** Array of commands to display with copy buttons */
-    codeCommands?: string[];
-    className?: string;
-}
-declare const SuperHero: React__default.FC<SuperHeroProps>;
-
-interface Testimonial {
-    content: string;
-    author: {
-        name: string;
-        title?: string;
-        company?: string;
-        avatar?: string;
-    };
-    rating?: number;
-}
-interface TestimonialSectionProps {
-    title?: string;
-    subtitle?: string;
-    testimonials: Testimonial[];
-    columns?: 1 | 2 | 3;
-    className?: string;
-    background?: 'dark' | 'card' | 'gradient';
-}
-declare const TestimonialSection: React__default.FC<TestimonialSectionProps>;
-
-type Theme = 'light' | 'dark' | 'system';
-type ThemeProviderProps = ThemeProviderProps$1;
-/**
- * ThemeProvider wraps next-themes with sensible defaults
- */
-declare function ThemeProvider({ children, attribute, defaultTheme, enableSystem, disableTransitionOnChange, ...props }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Hook to access theme context
- * Returns theme, setTheme, resolvedTheme, systemTheme, and themes
- */
-declare function useThemeContext(): {
-    theme: Theme | undefined;
-    setTheme: React.Dispatch<React.SetStateAction<string>>;
-    resolvedTheme: "light" | "dark" | undefined;
-    systemTheme: "light" | "dark" | undefined;
-    themes: string[];
-    toggleTheme: () => void;
-};
-
-/**
- * ThemeToggle - Theme switcher component
- *
- * Switches between light and dark themes.
- * Must be used within ThemeProvider.
- *
- * @example
- * ```tsx
- * import { ThemeToggle } from '@djangocfg/ui-nextjs';
- *
- * // Default
- * <ThemeToggle />
- *
- * // Compact (for mobile/tight spaces)
- * <ThemeToggle size="compact" />
- *
- * // Custom className
- * <ThemeToggle className="ml-auto" />
- * ```
- */
-interface ThemeToggleProps {
-    /** Custom className */
-    className?: string;
-    /** Size variant (auto-detects mobile if not specified) */
-    size?: 'default' | 'compact' | 'auto';
-}
-declare function ThemeToggle({ className, size }: ThemeToggleProps): react_jsx_runtime.JSX.Element;
-
-interface ForceThemeProps {
-    theme: 'light' | 'dark';
-    children: ReactNode;
-    className?: string;
-}
-declare function ForceTheme({ theme, children, className }: ForceThemeProps): react_jsx_runtime.JSX.Element;
-
-export { AnimatedBackground, type Article, ArticleCard, ArticleList, type ArticleType, type BackgroundVariant, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem$1 as BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbNavigation, type BreadcrumbItem as BreadcrumbNavigationItem, type BreadcrumbNavigationProps, BreadcrumbPage, BreadcrumbSeparator, type BrowserInfo, CTASection, type DRFPaginatedResponse, type DeviceDetectResult, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, FeatureSection, ForceTheme, Hero, MouseFollower, type MouseFollowerVariant, NewsletterSection, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type ResolvedTheme, SSRPagination, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, SplitHero, type SplitHeroAction, type SplitHeroBadge, SplitHeroContent, type SplitHeroFeature, SplitHeroMedia, type SplitHeroMediaCustom, type SplitHeroMediaImage, type SplitHeroMedia$1 as SplitHeroMediaType, type SplitHeroMediaVideo, type SplitHeroProps, StaticPagination, StatsSection, SuperHero, TestimonialSection, type Theme, ThemeProvider, type ThemeProviderProps, ThemeToggle, type UseHotkeyOptions, useBrowserDetect, useCfgRouter, useDRFPagination, useDRFPaginationInfo, useDeviceDetect, useHotkey, useQueryParams, useResolvedTheme, useSidebar, useThemeContext };