@smworks-cz/ui-kit 1.3.0 → 1.4.0

package/dist/index.d.mts

@@ -1184,6 +1184,107 @@ interface OTPInputProps {
  */
 declare const OTPInput: React.FC<OTPInputProps>;
 
+interface Country {
+    /** ISO 3166-1 alpha-2 kód. */
+    code: string;
+    /** Název země. */
+    name: string;
+    /** Předvolba. */
+    dialCode: string;
+    /** Vlaječka emoji. */
+    flag: string;
+}
+type PhoneInputSize = 'sm' | 'md' | 'lg';
+interface PhoneInputProps {
+    /** Plná mezinárodní hodnota, např. "+420123456789". */
+    value?: string;
+    /** Callback s plnou mezinárodní hodnotou. */
+    onChange?: (value: string) => void;
+    /** Výchozí kód země. @default 'CZ' */
+    defaultCountry?: string;
+    /** Vlastní seznam zemí. */
+    countries?: Country[];
+    /** Popisek. */
+    label?: string;
+    /** Chybový stav nebo zpráva. */
+    error?: boolean | string;
+    /** Nápovědný text. */
+    helperText?: string;
+    /** Zakáže komponentu. @default false */
+    disabled?: boolean;
+    /** Velikost. @default 'md' */
+    size?: PhoneInputSize;
+    /** Placeholder pro číslo. */
+    placeholder?: string;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Telefonní vstup s výběrem předvolby země.
+ *
+ * Obsahuje rozbalovací seznam zemí s vlajkami a předvolbami.
+ * Hodnota je plné mezinárodní číslo (např. "+420123456789").
+ *
+ * @example
+ * ```tsx
+ * <PhoneInput
+ *   value={phone}
+ *   onChange={setPhone}
+ *   defaultCountry="CZ"
+ *   label="Telefon"
+ * />
+ * ```
+ */
+declare const PhoneInput: React.FC<PhoneInputProps>;
+
+type CropShape = 'rect' | 'circle';
+interface CropArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface ImageCropperProps {
+    /** Zdroj obrázku — URL string nebo File objekt. */
+    src: string | File;
+    /** Callback s oříznutým výsledkem jako Blob. */
+    onCrop: (result: Blob) => void;
+    /** Callback při zrušení. */
+    onCancel?: () => void;
+    /** Poměr stran (šířka/výška). Undefined = volný. */
+    aspectRatio?: number;
+    /** Minimální šířka ořezu v px. @default 50 */
+    minWidth?: number;
+    /** Minimální výška ořezu v px. @default 50 */
+    minHeight?: number;
+    /** Tvar ořezu. @default 'rect' */
+    shape?: CropShape;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Ořezávání obrázku na canvasu.
+ *
+ * Umožňuje přetahování a změnu velikosti ořezové oblasti.
+ * Podporuje obdélníkový a kruhový tvar, poměr stran a minimální rozměry.
+ *
+ * @example
+ * ```tsx
+ * <ImageCropper
+ *   src={file}
+ *   aspectRatio={1}
+ *   shape="circle"
+ *   onCrop={(blob) => uploadAvatar(blob)}
+ *   onCancel={() => setShowCropper(false)}
+ * />
+ * ```
+ */
+declare const ImageCropper: React.FC<ImageCropperProps>;
+
 interface TableColumn {
     /** Klíč odpovídající hodnotě v datovém objektu. */
     key: string;
@@ -1310,6 +1411,89 @@ interface DataGridProps {
  */
 declare const DataGrid: React.FC<DataGridProps>;
 
+interface MobileDataCardColumn {
+    /** Klíč dat v řádkovém objektu. */
+    key: string;
+    /** Zobrazovaný popisek. */
+    header: string;
+    /** Vlastní renderování hodnoty — stejný podpis jako Table/DataGrid. */
+    render?: (value: any, row: any, index: number) => React.ReactNode;
+    /** Skrýt tento sloupec z karty. */
+    hidden?: boolean;
+    /** Zobrazit toto pole jako titulek karty. */
+    primary?: boolean;
+    /** Povolit řazení podle tohoto sloupce. */
+    sortable?: boolean;
+}
+interface MobileDataCardProps {
+    /** Definice sloupců — stejný tvar jako Table/DataGrid. */
+    columns: MobileDataCardColumn[];
+    /** Pole dat. */
+    data: any[];
+    /** Klíč v řádkovém objektu pro titulek karty. Alternativa k `primary` na sloupci. */
+    primaryKey?: string;
+    /** Klíč identifikátoru řádku. @default 'id' */
+    rowKey?: string;
+    /** Povolit výběr karet. @default false */
+    selectable?: boolean;
+    /** Řízené vybrané ID. */
+    selectedIds?: string[];
+    /** Callback při změně výběru. */
+    onSelectionChange?: (ids: string[]) => void;
+    /** Callback při kliknutí na kartu. */
+    onCardClick?: (row: any) => void;
+    /** Callback při řazení. */
+    onSort?: (key: string, direction: 'asc' | 'desc') => void;
+    /** Aktuální klíč řazení. */
+    sortKey?: string;
+    /** Aktuální směr řazení. */
+    sortDirection?: 'asc' | 'desc';
+    /** Zobrazit skeleton karty. @default false */
+    loading?: boolean;
+    /** Počet skeleton karet. @default 3 */
+    skeletonCount?: number;
+    /** Text prázdného stavu. @default 'Žádná data' */
+    emptyText?: string;
+    /** Vlastní obsah prázdného stavu. */
+    emptyContent?: React.ReactNode;
+    /** Mezera mezi kartami v px. @default 12 */
+    gap?: number;
+    /** Vykreslení akčních tlačítek v patičce karty. */
+    cardActions?: (row: any, index: number) => React.ReactNode;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Mobilní zobrazení dat ve formě karet.
+ *
+ * Každý datový řádek se zobrazí jako karta s páry popisek-hodnota.
+ * Kombinuje funkce Table (řazení, custom render) a DataGrid
+ * (výběr, kliknutí na řádek, skeleton).
+ *
+ * @example
+ * ```tsx
+ * <MobileDataCard
+ *   columns={[
+ *     { key: 'name', header: 'Jméno', primary: true },
+ *     { key: 'email', header: 'Email' },
+ *     { key: 'role', header: 'Role' },
+ *   ]}
+ *   data={users}
+ *   selectable
+ *   onCardClick={(row) => openDetail(row)}
+ *   cardActions={(row) => (
+ *     <>
+ *       <Button size="sm" variant="outline" onClick={() => edit(row)}>Upravit</Button>
+ *       <Button size="sm" variant="destructive" onClick={() => del(row)}>Smazat</Button>
+ *     </>
+ *   )}
+ * />
+ * ```
+ */
+declare const MobileDataCard: React.FC<MobileDataCardProps>;
+
 interface CardProps {
     /** Titulek karty. */
     title?: string;
@@ -2278,9 +2462,62 @@ interface StepperProps {
  */
 declare const Stepper: React.FC<StepperProps>;
 
-interface DropdownMenuItem {
-    /** Zobrazovaný popisek položky. */
+interface FormWizardStep {
+    /** Popisek kroku zobrazený ve Stepperu. */
     label: string;
+    /** Volitelný popis kroku. */
+    description?: string;
+    /** Obsah kroku (formulář, komponenta). */
+    content: React.ReactNode;
+    /** Validace před pokračováním. Vrací boolean nebo Promise<boolean>. */
+    validate?: () => boolean | Promise<boolean>;
+}
+interface FormWizardProps {
+    /** Definice kroků. */
+    steps: FormWizardStep[];
+    /** Index aktivního kroku (0-indexed). */
+    activeStep: number;
+    /** Callback při změně kroku. Při posledním kroku volá s `steps.length`. */
+    onStepChange: (step: number) => void;
+    /** Orientace stepperu. @default 'horizontal' */
+    orientation?: 'horizontal' | 'vertical';
+    /** Zobrazit navigační tlačítka (Předchozí/Další). @default true */
+    showNavigation?: boolean;
+    /** Text tlačítka na posledním kroku. @default 'Dokončit' */
+    finishLabel?: string;
+    /** Text tlačítka Další. @default 'Další' */
+    nextLabel?: string;
+    /** Text tlačítka Předchozí. @default 'Předchozí' */
+    prevLabel?: string;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Vícekrokový formulářový průvodce.
+ *
+ * Kombinuje Stepper s obsahem kroků a navigačními tlačítky.
+ * Podporuje synchronní i asynchronní validaci před pokračováním.
+ *
+ * @example
+ * ```tsx
+ * <FormWizard
+ *   steps={[
+ *     { label: 'Kontakt', content: <ContactForm />, validate: () => isValid },
+ *     { label: 'Adresa', content: <AddressForm /> },
+ *     { label: 'Souhrn', content: <Summary /> },
+ *   ]}
+ *   activeStep={step}
+ *   onStepChange={setStep}
+ * />
+ * ```
+ */
+declare const FormWizard: React.FC<FormWizardProps>;
+
+interface DropdownMenuItem {
+    /** Zobrazovaný popisek položky. Může být text nebo ReactNode pro vlastní obsah. */
+    label: React.ReactNode;
     /** Volitelná ikona vykreslená před textem. */
     icon?: React.ReactNode;
     /** Voláno při kliknutí na položku. */
@@ -2291,6 +2528,8 @@ interface DropdownMenuItem {
     danger?: boolean;
     /** Při `true` se místo položky vykreslí oddělovací čára. @default false */
     divider?: boolean;
+    /** Text kategorie — zobrazí se jako malý nadpis sekce (uppercase label). */
+    category?: string;
 }
 interface DropdownMenuProps {
     /** Spouštěcí element (tlačítko apod.). */
@@ -2398,6 +2637,8 @@ interface SpotlightProps {
     onChange: (value: string) => void;
     /** Již filtrované výsledky k zobrazení, seskupené dle `category`. */
     results: SpotlightItem[];
+    /** Zobrazí stav načítání místo výsledků. @default false */
+    loading?: boolean;
     /** Placeholder text pro vyhledávací vstup. @default 'Hledat...' */
     placeholder?: string;
     /** Dodatečná CSS třída pro kartu spotlightu. */
@@ -2823,6 +3064,45 @@ interface AlertProps {
  */
 declare const Alert: React.FC<AlertProps>;
 
+type BannerVariant = 'info' | 'success' | 'warning' | 'error';
+type BannerPosition = 'top' | 'bottom';
+interface BannerProps {
+    /** Vizuální varianta. @default 'info' */
+    variant?: BannerVariant;
+    /** Tučný titulek. */
+    title?: string;
+    /** Obsah banneru. */
+    children?: React.ReactNode;
+    /** Zobrazí zavírací tlačítko. @default false */
+    closable?: boolean;
+    /** Callback při zavření. */
+    onClose?: () => void;
+    /** Vlastní ikona. Pokud není zadána, použije se výchozí dle varianty. */
+    icon?: React.ReactNode;
+    /** Pozice akcentního proužku. @default 'top' */
+    position?: BannerPosition;
+    /** Přilepí banner na pozici. @default false */
+    sticky?: boolean;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Oznámovací banner na celou šířku.
+ *
+ * Plnohodnotný banner pro oznámení, varování nebo chybové hlášky.
+ * Lze přilepit na horní nebo dolní okraj pomocí `sticky`.
+ *
+ * @example
+ * ```tsx
+ * <Banner variant="warning" title="Údržba" sticky>
+ *   Systém bude nedostupný 12. dubna od 22:00.
+ * </Banner>
+ * ```
+ */
+declare const Banner: React.FC<BannerProps>;
+
 type NotificationVariant = 'info' | 'success' | 'warning' | 'error';
 interface NotificationProps {
     /** Vizuální varianta notifikace. @default 'info' */
@@ -3343,4 +3623,4 @@ type Theme = 'light' | 'dark';
  */
 declare const useTheme: () => Theme;
 
-export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, Alert, type AlertProps, type AlertVariant, AppSidebar, type AppSidebarProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonAsAnchorProps, type ButtonAsButtonProps, type ButtonIconPosition, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarEvent, type CalendarProps, Card, type CardProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, type ComboboxSize, type CommandGroup, type CommandItem, CommandMenu, type CommandMenuProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerMaxWidth, type ContainerProps, CopyButton, type CopyButtonProps, DataGrid, type DataGridColumn, type DataGridProps, DataList, type DataListItem, type DataListProps, DatePicker, DatePickerGroup, type DatePickerGroupProps, type DatePickerProps, type DatePickerSize, Divider, type DividerOrientation, type DividerProps, type DragHandleProps, DragList, type DragListItem, type DragListProps, Drawer, type DrawerProps, DropdownMenu, type DropdownMenuItem, type DropdownMenuProps, EmptyState, type EmptyStateProps, FileUpload, type FileUploadProps, Input, InputGroup, type InputGroupProps, type InputProps, type InputSize, Link, type LinkProps, type LinkVariant, Modal, type ModalProps, Navbar, type NavbarProps, Notification, type NotificationProps, type NotificationVariant, NumberInput, type NumberInputProps, type NumberInputSize, type NumberInputVariant, OTPInput, type OTPInputProps, Pagination, type PaginationProps, Popover, type PopoverProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, ProgressCircle, type ProgressCircleProps, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, type RadioSize, Rating, type RatingProps, type RatingSize, SegmentedControl, type SegmentedControlItem, type SegmentedControlProps, type SegmentedControlSize, Select, SelectGroup, type SelectGroupProps, type SelectOption, type SelectProps, Sheet, type SheetProps, SidebarItem, type SidebarItemProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Spinner, type SpinnerProps, type SpinnerSize, Spotlight, type SpotlightItem, type SpotlightProps, Stack, type StackAlign, type StackDirection, type StackJustify, type StackProps, Stat, type StatProps, StatusBadge, type StatusBadgeProps, type StatusBadgeStatus, type StepItem, Stepper, type StepperProps, Switch, type SwitchProps, type SwitchSize, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, TagItem, type TagItemProps, type TagProps, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type Theme, Timeline, type TimelineItem, type TimelineProps, Toast, type ToastContextValue, type ToastOptions, type ToastPosition, type ToastProps, type ToastVariant, ToasterProvider, type ToasterProviderProps, Tooltip, type TooltipProps, Tree, type TreeNode, type TreeProps, type UploadedFile, useTheme, useToast };
+export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, Alert, type AlertProps, type AlertVariant, AppSidebar, type AppSidebarProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, Banner, type BannerPosition, type BannerProps, type BannerVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonAsAnchorProps, type ButtonAsButtonProps, type ButtonIconPosition, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarEvent, type CalendarProps, Card, type CardProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, type ComboboxSize, type CommandGroup, type CommandItem, CommandMenu, type CommandMenuProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerMaxWidth, type ContainerProps, CopyButton, type CopyButtonProps, type Country, type CropArea, type CropShape, DataGrid, type DataGridColumn, type DataGridProps, DataList, type DataListItem, type DataListProps, DatePicker, DatePickerGroup, type DatePickerGroupProps, type DatePickerProps, type DatePickerSize, Divider, type DividerOrientation, type DividerProps, type DragHandleProps, DragList, type DragListItem, type DragListProps, Drawer, type DrawerProps, DropdownMenu, type DropdownMenuItem, type DropdownMenuProps, EmptyState, type EmptyStateProps, FileUpload, type FileUploadProps, FormWizard, type FormWizardProps, type FormWizardStep, ImageCropper, type ImageCropperProps, Input, InputGroup, type InputGroupProps, type InputProps, type InputSize, Link, type LinkProps, type LinkVariant, MobileDataCard, type MobileDataCardColumn, type MobileDataCardProps, Modal, type ModalProps, Navbar, type NavbarProps, Notification, type NotificationProps, type NotificationVariant, NumberInput, type NumberInputProps, type NumberInputSize, type NumberInputVariant, OTPInput, type OTPInputProps, Pagination, type PaginationProps, PhoneInput, type PhoneInputProps, type PhoneInputSize, Popover, type PopoverProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, ProgressCircle, type ProgressCircleProps, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, type RadioSize, Rating, type RatingProps, type RatingSize, SegmentedControl, type SegmentedControlItem, type SegmentedControlProps, type SegmentedControlSize, Select, SelectGroup, type SelectGroupProps, type SelectOption, type SelectProps, Sheet, type SheetProps, SidebarItem, type SidebarItemProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Spinner, type SpinnerProps, type SpinnerSize, Spotlight, type SpotlightItem, type SpotlightProps, Stack, type StackAlign, type StackDirection, type StackJustify, type StackProps, Stat, type StatProps, StatusBadge, type StatusBadgeProps, type StatusBadgeStatus, type StepItem, Stepper, type StepperProps, Switch, type SwitchProps, type SwitchSize, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, TagItem, type TagItemProps, type TagProps, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type Theme, Timeline, type TimelineItem, type TimelineProps, Toast, type ToastContextValue, type ToastOptions, type ToastPosition, type ToastProps, type ToastVariant, ToasterProvider, type ToasterProviderProps, Tooltip, type TooltipProps, Tree, type TreeNode, type TreeProps, type UploadedFile, useTheme, useToast };

package/dist/index.d.ts

@@ -1184,6 +1184,107 @@ interface OTPInputProps {
  */
 declare const OTPInput: React.FC<OTPInputProps>;
 
+interface Country {
+    /** ISO 3166-1 alpha-2 kód. */
+    code: string;
+    /** Název země. */
+    name: string;
+    /** Předvolba. */
+    dialCode: string;
+    /** Vlaječka emoji. */
+    flag: string;
+}
+type PhoneInputSize = 'sm' | 'md' | 'lg';
+interface PhoneInputProps {
+    /** Plná mezinárodní hodnota, např. "+420123456789". */
+    value?: string;
+    /** Callback s plnou mezinárodní hodnotou. */
+    onChange?: (value: string) => void;
+    /** Výchozí kód země. @default 'CZ' */
+    defaultCountry?: string;
+    /** Vlastní seznam zemí. */
+    countries?: Country[];
+    /** Popisek. */
+    label?: string;
+    /** Chybový stav nebo zpráva. */
+    error?: boolean | string;
+    /** Nápovědný text. */
+    helperText?: string;
+    /** Zakáže komponentu. @default false */
+    disabled?: boolean;
+    /** Velikost. @default 'md' */
+    size?: PhoneInputSize;
+    /** Placeholder pro číslo. */
+    placeholder?: string;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Telefonní vstup s výběrem předvolby země.
+ *
+ * Obsahuje rozbalovací seznam zemí s vlajkami a předvolbami.
+ * Hodnota je plné mezinárodní číslo (např. "+420123456789").
+ *
+ * @example
+ * ```tsx
+ * <PhoneInput
+ *   value={phone}
+ *   onChange={setPhone}
+ *   defaultCountry="CZ"
+ *   label="Telefon"
+ * />
+ * ```
+ */
+declare const PhoneInput: React.FC<PhoneInputProps>;
+
+type CropShape = 'rect' | 'circle';
+interface CropArea {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface ImageCropperProps {
+    /** Zdroj obrázku — URL string nebo File objekt. */
+    src: string | File;
+    /** Callback s oříznutým výsledkem jako Blob. */
+    onCrop: (result: Blob) => void;
+    /** Callback při zrušení. */
+    onCancel?: () => void;
+    /** Poměr stran (šířka/výška). Undefined = volný. */
+    aspectRatio?: number;
+    /** Minimální šířka ořezu v px. @default 50 */
+    minWidth?: number;
+    /** Minimální výška ořezu v px. @default 50 */
+    minHeight?: number;
+    /** Tvar ořezu. @default 'rect' */
+    shape?: CropShape;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Ořezávání obrázku na canvasu.
+ *
+ * Umožňuje přetahování a změnu velikosti ořezové oblasti.
+ * Podporuje obdélníkový a kruhový tvar, poměr stran a minimální rozměry.
+ *
+ * @example
+ * ```tsx
+ * <ImageCropper
+ *   src={file}
+ *   aspectRatio={1}
+ *   shape="circle"
+ *   onCrop={(blob) => uploadAvatar(blob)}
+ *   onCancel={() => setShowCropper(false)}
+ * />
+ * ```
+ */
+declare const ImageCropper: React.FC<ImageCropperProps>;
+
 interface TableColumn {
     /** Klíč odpovídající hodnotě v datovém objektu. */
     key: string;
@@ -1310,6 +1411,89 @@ interface DataGridProps {
  */
 declare const DataGrid: React.FC<DataGridProps>;
 
+interface MobileDataCardColumn {
+    /** Klíč dat v řádkovém objektu. */
+    key: string;
+    /** Zobrazovaný popisek. */
+    header: string;
+    /** Vlastní renderování hodnoty — stejný podpis jako Table/DataGrid. */
+    render?: (value: any, row: any, index: number) => React.ReactNode;
+    /** Skrýt tento sloupec z karty. */
+    hidden?: boolean;
+    /** Zobrazit toto pole jako titulek karty. */
+    primary?: boolean;
+    /** Povolit řazení podle tohoto sloupce. */
+    sortable?: boolean;
+}
+interface MobileDataCardProps {
+    /** Definice sloupců — stejný tvar jako Table/DataGrid. */
+    columns: MobileDataCardColumn[];
+    /** Pole dat. */
+    data: any[];
+    /** Klíč v řádkovém objektu pro titulek karty. Alternativa k `primary` na sloupci. */
+    primaryKey?: string;
+    /** Klíč identifikátoru řádku. @default 'id' */
+    rowKey?: string;
+    /** Povolit výběr karet. @default false */
+    selectable?: boolean;
+    /** Řízené vybrané ID. */
+    selectedIds?: string[];
+    /** Callback při změně výběru. */
+    onSelectionChange?: (ids: string[]) => void;
+    /** Callback při kliknutí na kartu. */
+    onCardClick?: (row: any) => void;
+    /** Callback při řazení. */
+    onSort?: (key: string, direction: 'asc' | 'desc') => void;
+    /** Aktuální klíč řazení. */
+    sortKey?: string;
+    /** Aktuální směr řazení. */
+    sortDirection?: 'asc' | 'desc';
+    /** Zobrazit skeleton karty. @default false */
+    loading?: boolean;
+    /** Počet skeleton karet. @default 3 */
+    skeletonCount?: number;
+    /** Text prázdného stavu. @default 'Žádná data' */
+    emptyText?: string;
+    /** Vlastní obsah prázdného stavu. */
+    emptyContent?: React.ReactNode;
+    /** Mezera mezi kartami v px. @default 12 */
+    gap?: number;
+    /** Vykreslení akčních tlačítek v patičce karty. */
+    cardActions?: (row: any, index: number) => React.ReactNode;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Mobilní zobrazení dat ve formě karet.
+ *
+ * Každý datový řádek se zobrazí jako karta s páry popisek-hodnota.
+ * Kombinuje funkce Table (řazení, custom render) a DataGrid
+ * (výběr, kliknutí na řádek, skeleton).
+ *
+ * @example
+ * ```tsx
+ * <MobileDataCard
+ *   columns={[
+ *     { key: 'name', header: 'Jméno', primary: true },
+ *     { key: 'email', header: 'Email' },
+ *     { key: 'role', header: 'Role' },
+ *   ]}
+ *   data={users}
+ *   selectable
+ *   onCardClick={(row) => openDetail(row)}
+ *   cardActions={(row) => (
+ *     <>
+ *       <Button size="sm" variant="outline" onClick={() => edit(row)}>Upravit</Button>
+ *       <Button size="sm" variant="destructive" onClick={() => del(row)}>Smazat</Button>
+ *     </>
+ *   )}
+ * />
+ * ```
+ */
+declare const MobileDataCard: React.FC<MobileDataCardProps>;
+
 interface CardProps {
     /** Titulek karty. */
     title?: string;
@@ -2278,9 +2462,62 @@ interface StepperProps {
  */
 declare const Stepper: React.FC<StepperProps>;
 
-interface DropdownMenuItem {
-    /** Zobrazovaný popisek položky. */
+interface FormWizardStep {
+    /** Popisek kroku zobrazený ve Stepperu. */
     label: string;
+    /** Volitelný popis kroku. */
+    description?: string;
+    /** Obsah kroku (formulář, komponenta). */
+    content: React.ReactNode;
+    /** Validace před pokračováním. Vrací boolean nebo Promise<boolean>. */
+    validate?: () => boolean | Promise<boolean>;
+}
+interface FormWizardProps {
+    /** Definice kroků. */
+    steps: FormWizardStep[];
+    /** Index aktivního kroku (0-indexed). */
+    activeStep: number;
+    /** Callback při změně kroku. Při posledním kroku volá s `steps.length`. */
+    onStepChange: (step: number) => void;
+    /** Orientace stepperu. @default 'horizontal' */
+    orientation?: 'horizontal' | 'vertical';
+    /** Zobrazit navigační tlačítka (Předchozí/Další). @default true */
+    showNavigation?: boolean;
+    /** Text tlačítka na posledním kroku. @default 'Dokončit' */
+    finishLabel?: string;
+    /** Text tlačítka Další. @default 'Další' */
+    nextLabel?: string;
+    /** Text tlačítka Předchozí. @default 'Předchozí' */
+    prevLabel?: string;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Vícekrokový formulářový průvodce.
+ *
+ * Kombinuje Stepper s obsahem kroků a navigačními tlačítky.
+ * Podporuje synchronní i asynchronní validaci před pokračováním.
+ *
+ * @example
+ * ```tsx
+ * <FormWizard
+ *   steps={[
+ *     { label: 'Kontakt', content: <ContactForm />, validate: () => isValid },
+ *     { label: 'Adresa', content: <AddressForm /> },
+ *     { label: 'Souhrn', content: <Summary /> },
+ *   ]}
+ *   activeStep={step}
+ *   onStepChange={setStep}
+ * />
+ * ```
+ */
+declare const FormWizard: React.FC<FormWizardProps>;
+
+interface DropdownMenuItem {
+    /** Zobrazovaný popisek položky. Může být text nebo ReactNode pro vlastní obsah. */
+    label: React.ReactNode;
     /** Volitelná ikona vykreslená před textem. */
     icon?: React.ReactNode;
     /** Voláno při kliknutí na položku. */
@@ -2291,6 +2528,8 @@ interface DropdownMenuItem {
     danger?: boolean;
     /** Při `true` se místo položky vykreslí oddělovací čára. @default false */
     divider?: boolean;
+    /** Text kategorie — zobrazí se jako malý nadpis sekce (uppercase label). */
+    category?: string;
 }
 interface DropdownMenuProps {
     /** Spouštěcí element (tlačítko apod.). */
@@ -2398,6 +2637,8 @@ interface SpotlightProps {
     onChange: (value: string) => void;
     /** Již filtrované výsledky k zobrazení, seskupené dle `category`. */
     results: SpotlightItem[];
+    /** Zobrazí stav načítání místo výsledků. @default false */
+    loading?: boolean;
     /** Placeholder text pro vyhledávací vstup. @default 'Hledat...' */
     placeholder?: string;
     /** Dodatečná CSS třída pro kartu spotlightu. */
@@ -2823,6 +3064,45 @@ interface AlertProps {
  */
 declare const Alert: React.FC<AlertProps>;
 
+type BannerVariant = 'info' | 'success' | 'warning' | 'error';
+type BannerPosition = 'top' | 'bottom';
+interface BannerProps {
+    /** Vizuální varianta. @default 'info' */
+    variant?: BannerVariant;
+    /** Tučný titulek. */
+    title?: string;
+    /** Obsah banneru. */
+    children?: React.ReactNode;
+    /** Zobrazí zavírací tlačítko. @default false */
+    closable?: boolean;
+    /** Callback při zavření. */
+    onClose?: () => void;
+    /** Vlastní ikona. Pokud není zadána, použije se výchozí dle varianty. */
+    icon?: React.ReactNode;
+    /** Pozice akcentního proužku. @default 'top' */
+    position?: BannerPosition;
+    /** Přilepí banner na pozici. @default false */
+    sticky?: boolean;
+    /** Další inline styly. */
+    style?: React.CSSProperties;
+    /** Dodatečná CSS třída. */
+    className?: string;
+}
+/**
+ * Oznámovací banner na celou šířku.
+ *
+ * Plnohodnotný banner pro oznámení, varování nebo chybové hlášky.
+ * Lze přilepit na horní nebo dolní okraj pomocí `sticky`.
+ *
+ * @example
+ * ```tsx
+ * <Banner variant="warning" title="Údržba" sticky>
+ *   Systém bude nedostupný 12. dubna od 22:00.
+ * </Banner>
+ * ```
+ */
+declare const Banner: React.FC<BannerProps>;
+
 type NotificationVariant = 'info' | 'success' | 'warning' | 'error';
 interface NotificationProps {
     /** Vizuální varianta notifikace. @default 'info' */
@@ -3343,4 +3623,4 @@ type Theme = 'light' | 'dark';
  */
 declare const useTheme: () => Theme;
 
-export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, Alert, type AlertProps, type AlertVariant, AppSidebar, type AppSidebarProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonAsAnchorProps, type ButtonAsButtonProps, type ButtonIconPosition, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarEvent, type CalendarProps, Card, type CardProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, type ComboboxSize, type CommandGroup, type CommandItem, CommandMenu, type CommandMenuProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerMaxWidth, type ContainerProps, CopyButton, type CopyButtonProps, DataGrid, type DataGridColumn, type DataGridProps, DataList, type DataListItem, type DataListProps, DatePicker, DatePickerGroup, type DatePickerGroupProps, type DatePickerProps, type DatePickerSize, Divider, type DividerOrientation, type DividerProps, type DragHandleProps, DragList, type DragListItem, type DragListProps, Drawer, type DrawerProps, DropdownMenu, type DropdownMenuItem, type DropdownMenuProps, EmptyState, type EmptyStateProps, FileUpload, type FileUploadProps, Input, InputGroup, type InputGroupProps, type InputProps, type InputSize, Link, type LinkProps, type LinkVariant, Modal, type ModalProps, Navbar, type NavbarProps, Notification, type NotificationProps, type NotificationVariant, NumberInput, type NumberInputProps, type NumberInputSize, type NumberInputVariant, OTPInput, type OTPInputProps, Pagination, type PaginationProps, Popover, type PopoverProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, ProgressCircle, type ProgressCircleProps, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, type RadioSize, Rating, type RatingProps, type RatingSize, SegmentedControl, type SegmentedControlItem, type SegmentedControlProps, type SegmentedControlSize, Select, SelectGroup, type SelectGroupProps, type SelectOption, type SelectProps, Sheet, type SheetProps, SidebarItem, type SidebarItemProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Spinner, type SpinnerProps, type SpinnerSize, Spotlight, type SpotlightItem, type SpotlightProps, Stack, type StackAlign, type StackDirection, type StackJustify, type StackProps, Stat, type StatProps, StatusBadge, type StatusBadgeProps, type StatusBadgeStatus, type StepItem, Stepper, type StepperProps, Switch, type SwitchProps, type SwitchSize, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, TagItem, type TagItemProps, type TagProps, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type Theme, Timeline, type TimelineItem, type TimelineProps, Toast, type ToastContextValue, type ToastOptions, type ToastPosition, type ToastProps, type ToastVariant, ToasterProvider, type ToasterProviderProps, Tooltip, type TooltipProps, Tree, type TreeNode, type TreeProps, type UploadedFile, useTheme, useToast };
+export { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, Alert, type AlertProps, type AlertVariant, AppSidebar, type AppSidebarProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, Banner, type BannerPosition, type BannerProps, type BannerVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonAsAnchorProps, type ButtonAsButtonProps, type ButtonIconPosition, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarEvent, type CalendarProps, Card, type CardProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, type ComboboxSize, type CommandGroup, type CommandItem, CommandMenu, type CommandMenuProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerMaxWidth, type ContainerProps, CopyButton, type CopyButtonProps, type Country, type CropArea, type CropShape, DataGrid, type DataGridColumn, type DataGridProps, DataList, type DataListItem, type DataListProps, DatePicker, DatePickerGroup, type DatePickerGroupProps, type DatePickerProps, type DatePickerSize, Divider, type DividerOrientation, type DividerProps, type DragHandleProps, DragList, type DragListItem, type DragListProps, Drawer, type DrawerProps, DropdownMenu, type DropdownMenuItem, type DropdownMenuProps, EmptyState, type EmptyStateProps, FileUpload, type FileUploadProps, FormWizard, type FormWizardProps, type FormWizardStep, ImageCropper, type ImageCropperProps, Input, InputGroup, type InputGroupProps, type InputProps, type InputSize, Link, type LinkProps, type LinkVariant, MobileDataCard, type MobileDataCardColumn, type MobileDataCardProps, Modal, type ModalProps, Navbar, type NavbarProps, Notification, type NotificationProps, type NotificationVariant, NumberInput, type NumberInputProps, type NumberInputSize, type NumberInputVariant, OTPInput, type OTPInputProps, Pagination, type PaginationProps, PhoneInput, type PhoneInputProps, type PhoneInputSize, Popover, type PopoverProps, ProgressBar, type ProgressBarProps, type ProgressBarSize, ProgressCircle, type ProgressCircleProps, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, type RadioSize, Rating, type RatingProps, type RatingSize, SegmentedControl, type SegmentedControlItem, type SegmentedControlProps, type SegmentedControlSize, Select, SelectGroup, type SelectGroupProps, type SelectOption, type SelectProps, Sheet, type SheetProps, SidebarItem, type SidebarItemProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderSize, Spinner, type SpinnerProps, type SpinnerSize, Spotlight, type SpotlightItem, type SpotlightProps, Stack, type StackAlign, type StackDirection, type StackJustify, type StackProps, Stat, type StatProps, StatusBadge, type StatusBadgeProps, type StatusBadgeStatus, type StepItem, Stepper, type StepperProps, Switch, type SwitchProps, type SwitchSize, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, TagItem, type TagItemProps, type TagProps, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type Theme, Timeline, type TimelineItem, type TimelineProps, Toast, type ToastContextValue, type ToastOptions, type ToastPosition, type ToastProps, type ToastVariant, ToasterProvider, type ToasterProviderProps, Tooltip, type TooltipProps, Tree, type TreeNode, type TreeProps, type UploadedFile, useTheme, useToast };