@geomak/ui 7.7.4 → 7.8.0

package/dist/index.d.cts

@@ -2644,6 +2644,143 @@ interface VirtualListProps<T> {
  */
 declare function VirtualList<T>({ items, rowHeight, renderItem, height, getKey, overscan, searchable, searchKeys, filter, searchPlaceholder, emptyState, 'aria-label': ariaLabel, className, style, }: VirtualListProps<T>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Shared file-source contract for content components (PdfViewer, Spreadsheet).
+ *
+ * Three independent, equal ways to supply content — no preference baked in:
+ *  1. PROGRAMMATIC  — `ArrayBuffer | Uint8Array` built in-browser (no network)
+ *  2. BACKEND       — `string | URL` fetched/streamed from a server
+ *  3. LOCAL         — `File | Blob` from a file input / drag-drop (no network)
+ */
+type FileSource = string | URL | File | Blob | ArrayBuffer | Uint8Array;
+interface RemoteSourceOptions {
+    /** Forwarded when `source` is a URL (e.g. an auth token). */
+    httpHeaders?: Record<string, string>;
+    /** Send cookies for same-site auth when `source` is a URL. */
+    withCredentials?: boolean;
+}
+
+interface PdfViewerProps {
+    source: FileSource;
+    remote?: RemoteSourceOptions;
+    initialPage?: number;
+    /** Default `'page-width'`. */
+    zoom?: number | 'auto' | 'page-fit' | 'page-width';
+    /** Default `true`. */
+    toolbar?: boolean | {
+        zoom?: boolean;
+        pager?: boolean;
+        download?: boolean;
+        print?: boolean;
+        search?: boolean;
+    };
+    /** Side thumbnail rail. Default `false`. */
+    thumbnails?: boolean;
+    /** Selectable text layer. Default `true`. */
+    textLayer?: boolean;
+    onLoad?: (info: {
+        numPages: number;
+    }) => void;
+    onError?: (err: Error) => void;
+    onPageChange?: (page: number) => void;
+    className?: string;
+    style?: react__default.CSSProperties;
+}
+declare function PdfViewer({ source, remote, initialPage, zoom, toolbar, thumbnails, textLayer, onLoad, onError, onPageChange, className, style, }: PdfViewerProps): react_jsx_runtime.JSX.Element;
+
+type CellValue = string | number | boolean | null;
+interface GridColumn {
+    key: string;
+    label?: react__default.ReactNode;
+    /** Pixel width. Strings are parsed to px (non-numeric → default). Default 140. */
+    width?: number | string;
+    align?: 'left' | 'center' | 'right';
+    /** Per-column override of the grid-wide `editable`. */
+    editable?: boolean;
+}
+interface DataGridProps {
+    columns: GridColumn[];
+    /** Plain row records keyed by column key. */
+    rows: Array<Record<string, CellValue>>;
+    /** Default 34. */
+    rowHeight?: number;
+    /** Default 38. */
+    headerHeight?: number;
+    /** Viewport height. Default 480. */
+    height?: number | string;
+    /** Allow value editing (double-click a cell). Default false. */
+    editable?: boolean;
+    /** Window rows/columns. Default true. Off renders everything (small grids/tests). */
+    virtualize?: boolean;
+    /** Rows/cols rendered beyond the viewport each side. Default 4. */
+    overscan?: number;
+    /** Show the left row-number gutter. Default true. */
+    rowNumbers?: boolean;
+    onCellEdit?: (e: {
+        row: number;
+        column: string;
+        value: string;
+    }) => void;
+    className?: string;
+    style?: react__default.CSSProperties;
+    /** Shown when there are no rows. */
+    emptyState?: react__default.ReactNode;
+}
+/**
+ * Virtualized (both axes) data grid primitive. Renders only the cells inside
+ * the viewport plus an overscan margin, so it stays smooth at tens of thousands
+ * of rows. The header and the row-number gutter are pinned by positioning them
+ * at the live scroll offset (`top: scrollTop` / `left: scrollLeft`) — the same
+ * translate-window technique as {@link VirtualList}, extended to two axes.
+ *
+ * Stateless w.r.t. data: it renders the `rows` it's given and emits
+ * `onCellEdit` on commit. Wrap it with {@link Spreadsheet} for multi-sheet
+ * switching, file parsing and export.
+ */
+declare function DataGrid({ columns, rows, rowHeight, headerHeight, height, editable, virtualize, overscan, rowNumbers, onCellEdit, className, style, emptyState, }: DataGridProps): react_jsx_runtime.JSX.Element;
+
+interface Cell {
+    value: CellValue;
+    /** Reserved for a future formula engine — parsed/stored but not evaluated. */
+    formula?: string;
+}
+interface SheetData {
+    name: string;
+    columns: GridColumn[] | string[];
+    rows: Array<Record<string, Cell | CellValue>>;
+}
+type GridSource = SheetData[] | File | Blob | string | URL;
+interface SpreadsheetProps {
+    source: GridSource;
+    remote?: RemoteSourceOptions;
+    /** Value editing only — no formulas. Default false. */
+    editable?: boolean;
+    onCellEdit?: (e: {
+        sheet: string;
+        row: number;
+        column: string;
+        value: unknown;
+    }) => void;
+    onChange?: (sheets: SheetData[]) => void;
+    /** Export formats offered in the toolbar. Default `['xlsx','csv','pdf']`; `false` hides export. */
+    export?: Array<'xlsx' | 'csv' | 'pdf'> | false;
+    fileName?: string;
+    /** Default true. */
+    virtualize?: boolean;
+    className?: string;
+    style?: react__default.CSSProperties;
+}
+/**
+ * Multi-sheet spreadsheet built on {@link DataGrid}. Accepts data three ways
+ * — in-memory `SheetData[]` (no network), a `File`/`Blob` (no network), or a
+ * URL (the only mode that fetches). `.xlsx` is parsed with SheetJS, loaded
+ * lazily on first use. Value editing emits `onCellEdit` + `onChange`; there is
+ * no formula engine (the `Cell.formula` slot is reserved, not evaluated).
+ * Exports to multi-sheet `.xlsx`, `.csv` (active sheet, BOM-prefixed) or a
+ * paginated table `.pdf` (jsPDF, lazy).
+ */
+declare function Spreadsheet({ source, remote, editable, onCellEdit, onChange, export: exportFormats, fileName, virtualize, className, style, }: SpreadsheetProps): react_jsx_runtime.JSX.Element;
+
 interface ThemeSwitchProps {
     checked: boolean;
     onChange: (e: {
@@ -5552,4 +5689,4 @@ declare function expiryError(value: string, now?: Date): string | undefined;
 /** Validate the CVV against the detected brand's expected length. */
 declare function cvvError(value: string, cardNumber: string): string | undefined;
 
-export { Accordion, type AccordionItemProps, type AccordionProps, AppShell, type AppShellProps, AutoComplete, type AutoCompleteProps, Avatar, type AvatarProps, type AvatarShape, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeSize, type BadgeTone, type BadgeVariant, Banner, type BannerProps, type BannerTone, Blog, type BlogPost, type BlogProps, Box, type BoxBackground, type BoxBorder, type BoxProps, type BoxRadius, type BoxShadow, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type Breakpoint, type BreakpointState, Button, type ButtonProps, CARD_BRANDS, Card, type CardBodyProps, type CardBrand, CardCarousel, type CardCarouselProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, Cart, CartButton, type CartButtonProps, type CartContextValue, type CartItemInput, type CartLineItem, type CartProps, CartProvider, type CartProviderProps, type CartSummaryRow, Catalog, CatalogCarousel, type CatalogCarouselProps, CatalogGrid, type CatalogGridProps, type CatalogProps, type CellEditInfo, Chat, type ChatMessage, type ChatProps, Checkbox, type CheckboxProps, Checkout, type CheckoutProps, type ClassValue, ColorPicker, type ColorPickerProps, type ConsentChoice, ContextMenu, type ContextMenuActionItem, type ContextMenuPosition, type ContextMenuProps, CookieConsent, type CookieConsentProps, CreditCardForm, type CreditCardFormProps, type CreditCardValue, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DeltaDirection, Drawer, type DrawerProps, type DrawerSize, Dropdown, type DropdownItem, type DropdownProps, type EditorArgs, EmptyCart, type EmptyCartProps, type ErrorMap, type ExpandRowOptions, FAB, type FABAction, type FABPosition, type FABProps, type FABSize, type FABTone, FadingBase, type FadingBaseProps, type Feature, FeatureGrid, type FeatureGridProps, Field, type FieldArrayItem, type FieldBindings, FieldHelpIcon, type FieldKind, FieldLabel, type FieldLabelProps, type FieldProps, type FieldRule, type FieldRules, type FieldShellOptions, type FieldSize, type FieldSnapshot, FileInput, type FileInputProps, Flex, type FlexAlign, type FlexDirection, type FlexJustify, type FlexProps, type FlexWrap, Form, FormContext, FormField, type FormFieldProps, type FormProps, FormStore, type FormStoreOptions, type FormValues, Grid, GridCard, type GridCardItem, type GridCardProps, type GridProps, IconButton, type IconButtonProps, Jumbotron, type JumbotronBackground, type JumbotronLayout, type JumbotronProps, type JwtResult, Kbd, type KbdProps, type KbdSize, LeadCapture, type LeadCaptureProps, List, type ListItem, type ListProps, LoadingSpinner, type LoadingSpinnerProps, LogoutTimer, type LogoutTimerProps, MegaMenu, type MegaMenuFeaturedProps, type MegaMenuItemProps, type MegaMenuLinkProps, type MegaMenuPanelProps, type MegaMenuProps, type MegaMenuSectionProps, MenuButton, type MenuButtonItem, type MenuButtonProps, Modal, type ModalProps, type ModalSize, type NotificationPayload, NotificationProvider, NumberInput, type NumberInputProps, OpaqueGridCard, type OpaqueGridCardProps, OtpInput, type OtpInputProps, type PaginationOptions, Parallax, type ParallaxProps, Password, type PasswordProps, type PasswordRule, type PasswordScore, PasswordStrength, type PasswordStrengthProps, type PasswordStrengthResult, PopConfirm, type PopConfirmProps, type PopConfirmTone, Portal, type PortalProps, type PricingPlan, PricingPlans, type PricingPlansProps, RadioGroup, type RadioGroupProps, type RadioOption, RadioTile, type RadioTileOption, type RadioTileProps, Rating, type RatingProps, type RulesMap, ScalableContainer, type ScalableContainerProps, Scheduler, type SchedulerEvent, type SchedulerProps, type SchedulerRange, type SchedulerView, SearchInput, type SearchInputProps, type SearchOptions, SecureLayout, type SecureLayoutProps, SegmentedControl, type SegmentedControlProps, type SegmentedOption, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, SkeletonBox, type SkeletonBoxProps, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonText, type SkeletonTextProps, type Slide, SlideShow, type SlideShowProps, Slider, type SliderMark, type SliderProps, type SliderValue, type SocialLink, type SocialPlatform, Socials, type SocialsProps, type SortDirection, type SortState, type Spacing, Statistic, type StatisticDelta, type StatisticProps, type StatisticSize, Stepper, type StepperActiveStatus, type StepperProps, type StepperStep, Switch, type SwitchInputProps, Table, type TableColumn, type TableProps, Tabs, type TabsAddProps, type TabsListProps, type TabsOrientation, type TabsPanelProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsVariant, TagsInput, type TagsInputProps, DatePicker as Temporal, type TemporalPickerProps, type Testimonial, Testimonials, type TestimonialsProps, TextArea, type TextAreaProps, TextInput, type TextInputProps, type ThemeColors, type ThemeConfig, type ThemeDensity, type ThemeMotion, ThemeProvider, type ThemeProviderProps, type ThemeRadius, type ThemeShadows, ThemeSwitch, type ThemeSwitchProps, type ThemeTypography, TimePicker, type TimePickerProps, Timeline, type TimelineEvent, type TimelineProps, type TimelineStatus, Tooltip, type TooltipProps, TooltipProvider, TopBar, type TopBarProps, Tree, type TreeItemClickPayload, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type TypographyWeight, type UseFieldArrayReturn, type UseFormFieldOptions, type UseFormReturn, type ValidateTrigger, Video, type VideoProps, VirtualList, type VirtualListProps, Wizard, type WizardProps, type WizardStep, cardNumberError, cvvError, cx, defaultPasswordRules, detectBrand, expiryError, fieldShell, formatCardNumber, formatExpiry, isRequired, luhnValid, onlyDigits, patterns, runFieldRules, scorePassword, useBreakpoint, useCart, useFieldArray, useForm, useFormField, useFormStore, useJwt, useLocalStorage, useMediaQuery, useNotification };
+export { Accordion, type AccordionItemProps, type AccordionProps, AppShell, type AppShellProps, AutoComplete, type AutoCompleteProps, Avatar, type AvatarProps, type AvatarShape, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeSize, type BadgeTone, type BadgeVariant, Banner, type BannerProps, type BannerTone, Blog, type BlogPost, type BlogProps, Box, type BoxBackground, type BoxBorder, type BoxProps, type BoxRadius, type BoxShadow, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type Breakpoint, type BreakpointState, Button, type ButtonProps, CARD_BRANDS, Card, type CardBodyProps, type CardBrand, CardCarousel, type CardCarouselProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, Cart, CartButton, type CartButtonProps, type CartContextValue, type CartItemInput, type CartLineItem, type CartProps, CartProvider, type CartProviderProps, type CartSummaryRow, Catalog, CatalogCarousel, type CatalogCarouselProps, CatalogGrid, type CatalogGridProps, type CatalogProps, type Cell, type CellEditInfo, type CellValue, Chat, type ChatMessage, type ChatProps, Checkbox, type CheckboxProps, Checkout, type CheckoutProps, type ClassValue, ColorPicker, type ColorPickerProps, type ConsentChoice, ContextMenu, type ContextMenuActionItem, type ContextMenuPosition, type ContextMenuProps, CookieConsent, type CookieConsentProps, CreditCardForm, type CreditCardFormProps, type CreditCardValue, DataGrid, type DataGridProps, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DeltaDirection, Drawer, type DrawerProps, type DrawerSize, Dropdown, type DropdownItem, type DropdownProps, type EditorArgs, EmptyCart, type EmptyCartProps, type ErrorMap, type ExpandRowOptions, FAB, type FABAction, type FABPosition, type FABProps, type FABSize, type FABTone, FadingBase, type FadingBaseProps, type Feature, FeatureGrid, type FeatureGridProps, Field, type FieldArrayItem, type FieldBindings, FieldHelpIcon, type FieldKind, FieldLabel, type FieldLabelProps, type FieldProps, type FieldRule, type FieldRules, type FieldShellOptions, type FieldSize, type FieldSnapshot, FileInput, type FileInputProps, type FileSource, Flex, type FlexAlign, type FlexDirection, type FlexJustify, type FlexProps, type FlexWrap, Form, FormContext, FormField, type FormFieldProps, type FormProps, FormStore, type FormStoreOptions, type FormValues, Grid, GridCard, type GridCardItem, type GridCardProps, type GridColumn, type GridProps, type GridSource, IconButton, type IconButtonProps, Jumbotron, type JumbotronBackground, type JumbotronLayout, type JumbotronProps, type JwtResult, Kbd, type KbdProps, type KbdSize, LeadCapture, type LeadCaptureProps, List, type ListItem, type ListProps, LoadingSpinner, type LoadingSpinnerProps, LogoutTimer, type LogoutTimerProps, MegaMenu, type MegaMenuFeaturedProps, type MegaMenuItemProps, type MegaMenuLinkProps, type MegaMenuPanelProps, type MegaMenuProps, type MegaMenuSectionProps, MenuButton, type MenuButtonItem, type MenuButtonProps, Modal, type ModalProps, type ModalSize, type NotificationPayload, NotificationProvider, NumberInput, type NumberInputProps, OpaqueGridCard, type OpaqueGridCardProps, OtpInput, type OtpInputProps, type PaginationOptions, Parallax, type ParallaxProps, Password, type PasswordProps, type PasswordRule, type PasswordScore, PasswordStrength, type PasswordStrengthProps, type PasswordStrengthResult, PdfViewer, type PdfViewerProps, PopConfirm, type PopConfirmProps, type PopConfirmTone, Portal, type PortalProps, type PricingPlan, PricingPlans, type PricingPlansProps, RadioGroup, type RadioGroupProps, type RadioOption, RadioTile, type RadioTileOption, type RadioTileProps, Rating, type RatingProps, type RemoteSourceOptions, type RulesMap, ScalableContainer, type ScalableContainerProps, Scheduler, type SchedulerEvent, type SchedulerProps, type SchedulerRange, type SchedulerView, SearchInput, type SearchInputProps, type SearchOptions, SecureLayout, type SecureLayoutProps, SegmentedControl, type SegmentedControlProps, type SegmentedOption, type SheetData, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, SkeletonBox, type SkeletonBoxProps, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonText, type SkeletonTextProps, type Slide, SlideShow, type SlideShowProps, Slider, type SliderMark, type SliderProps, type SliderValue, type SocialLink, type SocialPlatform, Socials, type SocialsProps, type SortDirection, type SortState, type Spacing, Spreadsheet, type SpreadsheetProps, Statistic, type StatisticDelta, type StatisticProps, type StatisticSize, Stepper, type StepperActiveStatus, type StepperProps, type StepperStep, Switch, type SwitchInputProps, Table, type TableColumn, type TableProps, Tabs, type TabsAddProps, type TabsListProps, type TabsOrientation, type TabsPanelProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsVariant, TagsInput, type TagsInputProps, DatePicker as Temporal, type TemporalPickerProps, type Testimonial, Testimonials, type TestimonialsProps, TextArea, type TextAreaProps, TextInput, type TextInputProps, type ThemeColors, type ThemeConfig, type ThemeDensity, type ThemeMotion, ThemeProvider, type ThemeProviderProps, type ThemeRadius, type ThemeShadows, ThemeSwitch, type ThemeSwitchProps, type ThemeTypography, TimePicker, type TimePickerProps, Timeline, type TimelineEvent, type TimelineProps, type TimelineStatus, Tooltip, type TooltipProps, TooltipProvider, TopBar, type TopBarProps, Tree, type TreeItemClickPayload, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type TypographyWeight, type UseFieldArrayReturn, type UseFormFieldOptions, type UseFormReturn, type ValidateTrigger, Video, type VideoProps, VirtualList, type VirtualListProps, Wizard, type WizardProps, type WizardStep, cardNumberError, cvvError, cx, defaultPasswordRules, detectBrand, expiryError, fieldShell, formatCardNumber, formatExpiry, isRequired, luhnValid, onlyDigits, patterns, runFieldRules, scorePassword, useBreakpoint, useCart, useFieldArray, useForm, useFormField, useFormStore, useJwt, useLocalStorage, useMediaQuery, useNotification };

package/dist/index.d.ts

@@ -2644,6 +2644,143 @@ interface VirtualListProps<T> {
  */
 declare function VirtualList<T>({ items, rowHeight, renderItem, height, getKey, overscan, searchable, searchKeys, filter, searchPlaceholder, emptyState, 'aria-label': ariaLabel, className, style, }: VirtualListProps<T>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Shared file-source contract for content components (PdfViewer, Spreadsheet).
+ *
+ * Three independent, equal ways to supply content — no preference baked in:
+ *  1. PROGRAMMATIC  — `ArrayBuffer | Uint8Array` built in-browser (no network)
+ *  2. BACKEND       — `string | URL` fetched/streamed from a server
+ *  3. LOCAL         — `File | Blob` from a file input / drag-drop (no network)
+ */
+type FileSource = string | URL | File | Blob | ArrayBuffer | Uint8Array;
+interface RemoteSourceOptions {
+    /** Forwarded when `source` is a URL (e.g. an auth token). */
+    httpHeaders?: Record<string, string>;
+    /** Send cookies for same-site auth when `source` is a URL. */
+    withCredentials?: boolean;
+}
+
+interface PdfViewerProps {
+    source: FileSource;
+    remote?: RemoteSourceOptions;
+    initialPage?: number;
+    /** Default `'page-width'`. */
+    zoom?: number | 'auto' | 'page-fit' | 'page-width';
+    /** Default `true`. */
+    toolbar?: boolean | {
+        zoom?: boolean;
+        pager?: boolean;
+        download?: boolean;
+        print?: boolean;
+        search?: boolean;
+    };
+    /** Side thumbnail rail. Default `false`. */
+    thumbnails?: boolean;
+    /** Selectable text layer. Default `true`. */
+    textLayer?: boolean;
+    onLoad?: (info: {
+        numPages: number;
+    }) => void;
+    onError?: (err: Error) => void;
+    onPageChange?: (page: number) => void;
+    className?: string;
+    style?: react__default.CSSProperties;
+}
+declare function PdfViewer({ source, remote, initialPage, zoom, toolbar, thumbnails, textLayer, onLoad, onError, onPageChange, className, style, }: PdfViewerProps): react_jsx_runtime.JSX.Element;
+
+type CellValue = string | number | boolean | null;
+interface GridColumn {
+    key: string;
+    label?: react__default.ReactNode;
+    /** Pixel width. Strings are parsed to px (non-numeric → default). Default 140. */
+    width?: number | string;
+    align?: 'left' | 'center' | 'right';
+    /** Per-column override of the grid-wide `editable`. */
+    editable?: boolean;
+}
+interface DataGridProps {
+    columns: GridColumn[];
+    /** Plain row records keyed by column key. */
+    rows: Array<Record<string, CellValue>>;
+    /** Default 34. */
+    rowHeight?: number;
+    /** Default 38. */
+    headerHeight?: number;
+    /** Viewport height. Default 480. */
+    height?: number | string;
+    /** Allow value editing (double-click a cell). Default false. */
+    editable?: boolean;
+    /** Window rows/columns. Default true. Off renders everything (small grids/tests). */
+    virtualize?: boolean;
+    /** Rows/cols rendered beyond the viewport each side. Default 4. */
+    overscan?: number;
+    /** Show the left row-number gutter. Default true. */
+    rowNumbers?: boolean;
+    onCellEdit?: (e: {
+        row: number;
+        column: string;
+        value: string;
+    }) => void;
+    className?: string;
+    style?: react__default.CSSProperties;
+    /** Shown when there are no rows. */
+    emptyState?: react__default.ReactNode;
+}
+/**
+ * Virtualized (both axes) data grid primitive. Renders only the cells inside
+ * the viewport plus an overscan margin, so it stays smooth at tens of thousands
+ * of rows. The header and the row-number gutter are pinned by positioning them
+ * at the live scroll offset (`top: scrollTop` / `left: scrollLeft`) — the same
+ * translate-window technique as {@link VirtualList}, extended to two axes.
+ *
+ * Stateless w.r.t. data: it renders the `rows` it's given and emits
+ * `onCellEdit` on commit. Wrap it with {@link Spreadsheet} for multi-sheet
+ * switching, file parsing and export.
+ */
+declare function DataGrid({ columns, rows, rowHeight, headerHeight, height, editable, virtualize, overscan, rowNumbers, onCellEdit, className, style, emptyState, }: DataGridProps): react_jsx_runtime.JSX.Element;
+
+interface Cell {
+    value: CellValue;
+    /** Reserved for a future formula engine — parsed/stored but not evaluated. */
+    formula?: string;
+}
+interface SheetData {
+    name: string;
+    columns: GridColumn[] | string[];
+    rows: Array<Record<string, Cell | CellValue>>;
+}
+type GridSource = SheetData[] | File | Blob | string | URL;
+interface SpreadsheetProps {
+    source: GridSource;
+    remote?: RemoteSourceOptions;
+    /** Value editing only — no formulas. Default false. */
+    editable?: boolean;
+    onCellEdit?: (e: {
+        sheet: string;
+        row: number;
+        column: string;
+        value: unknown;
+    }) => void;
+    onChange?: (sheets: SheetData[]) => void;
+    /** Export formats offered in the toolbar. Default `['xlsx','csv','pdf']`; `false` hides export. */
+    export?: Array<'xlsx' | 'csv' | 'pdf'> | false;
+    fileName?: string;
+    /** Default true. */
+    virtualize?: boolean;
+    className?: string;
+    style?: react__default.CSSProperties;
+}
+/**
+ * Multi-sheet spreadsheet built on {@link DataGrid}. Accepts data three ways
+ * — in-memory `SheetData[]` (no network), a `File`/`Blob` (no network), or a
+ * URL (the only mode that fetches). `.xlsx` is parsed with SheetJS, loaded
+ * lazily on first use. Value editing emits `onCellEdit` + `onChange`; there is
+ * no formula engine (the `Cell.formula` slot is reserved, not evaluated).
+ * Exports to multi-sheet `.xlsx`, `.csv` (active sheet, BOM-prefixed) or a
+ * paginated table `.pdf` (jsPDF, lazy).
+ */
+declare function Spreadsheet({ source, remote, editable, onCellEdit, onChange, export: exportFormats, fileName, virtualize, className, style, }: SpreadsheetProps): react_jsx_runtime.JSX.Element;
+
 interface ThemeSwitchProps {
     checked: boolean;
     onChange: (e: {
@@ -5552,4 +5689,4 @@ declare function expiryError(value: string, now?: Date): string | undefined;
 /** Validate the CVV against the detected brand's expected length. */
 declare function cvvError(value: string, cardNumber: string): string | undefined;
 
-export { Accordion, type AccordionItemProps, type AccordionProps, AppShell, type AppShellProps, AutoComplete, type AutoCompleteProps, Avatar, type AvatarProps, type AvatarShape, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeSize, type BadgeTone, type BadgeVariant, Banner, type BannerProps, type BannerTone, Blog, type BlogPost, type BlogProps, Box, type BoxBackground, type BoxBorder, type BoxProps, type BoxRadius, type BoxShadow, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type Breakpoint, type BreakpointState, Button, type ButtonProps, CARD_BRANDS, Card, type CardBodyProps, type CardBrand, CardCarousel, type CardCarouselProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, Cart, CartButton, type CartButtonProps, type CartContextValue, type CartItemInput, type CartLineItem, type CartProps, CartProvider, type CartProviderProps, type CartSummaryRow, Catalog, CatalogCarousel, type CatalogCarouselProps, CatalogGrid, type CatalogGridProps, type CatalogProps, type CellEditInfo, Chat, type ChatMessage, type ChatProps, Checkbox, type CheckboxProps, Checkout, type CheckoutProps, type ClassValue, ColorPicker, type ColorPickerProps, type ConsentChoice, ContextMenu, type ContextMenuActionItem, type ContextMenuPosition, type ContextMenuProps, CookieConsent, type CookieConsentProps, CreditCardForm, type CreditCardFormProps, type CreditCardValue, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DeltaDirection, Drawer, type DrawerProps, type DrawerSize, Dropdown, type DropdownItem, type DropdownProps, type EditorArgs, EmptyCart, type EmptyCartProps, type ErrorMap, type ExpandRowOptions, FAB, type FABAction, type FABPosition, type FABProps, type FABSize, type FABTone, FadingBase, type FadingBaseProps, type Feature, FeatureGrid, type FeatureGridProps, Field, type FieldArrayItem, type FieldBindings, FieldHelpIcon, type FieldKind, FieldLabel, type FieldLabelProps, type FieldProps, type FieldRule, type FieldRules, type FieldShellOptions, type FieldSize, type FieldSnapshot, FileInput, type FileInputProps, Flex, type FlexAlign, type FlexDirection, type FlexJustify, type FlexProps, type FlexWrap, Form, FormContext, FormField, type FormFieldProps, type FormProps, FormStore, type FormStoreOptions, type FormValues, Grid, GridCard, type GridCardItem, type GridCardProps, type GridProps, IconButton, type IconButtonProps, Jumbotron, type JumbotronBackground, type JumbotronLayout, type JumbotronProps, type JwtResult, Kbd, type KbdProps, type KbdSize, LeadCapture, type LeadCaptureProps, List, type ListItem, type ListProps, LoadingSpinner, type LoadingSpinnerProps, LogoutTimer, type LogoutTimerProps, MegaMenu, type MegaMenuFeaturedProps, type MegaMenuItemProps, type MegaMenuLinkProps, type MegaMenuPanelProps, type MegaMenuProps, type MegaMenuSectionProps, MenuButton, type MenuButtonItem, type MenuButtonProps, Modal, type ModalProps, type ModalSize, type NotificationPayload, NotificationProvider, NumberInput, type NumberInputProps, OpaqueGridCard, type OpaqueGridCardProps, OtpInput, type OtpInputProps, type PaginationOptions, Parallax, type ParallaxProps, Password, type PasswordProps, type PasswordRule, type PasswordScore, PasswordStrength, type PasswordStrengthProps, type PasswordStrengthResult, PopConfirm, type PopConfirmProps, type PopConfirmTone, Portal, type PortalProps, type PricingPlan, PricingPlans, type PricingPlansProps, RadioGroup, type RadioGroupProps, type RadioOption, RadioTile, type RadioTileOption, type RadioTileProps, Rating, type RatingProps, type RulesMap, ScalableContainer, type ScalableContainerProps, Scheduler, type SchedulerEvent, type SchedulerProps, type SchedulerRange, type SchedulerView, SearchInput, type SearchInputProps, type SearchOptions, SecureLayout, type SecureLayoutProps, SegmentedControl, type SegmentedControlProps, type SegmentedOption, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, SkeletonBox, type SkeletonBoxProps, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonText, type SkeletonTextProps, type Slide, SlideShow, type SlideShowProps, Slider, type SliderMark, type SliderProps, type SliderValue, type SocialLink, type SocialPlatform, Socials, type SocialsProps, type SortDirection, type SortState, type Spacing, Statistic, type StatisticDelta, type StatisticProps, type StatisticSize, Stepper, type StepperActiveStatus, type StepperProps, type StepperStep, Switch, type SwitchInputProps, Table, type TableColumn, type TableProps, Tabs, type TabsAddProps, type TabsListProps, type TabsOrientation, type TabsPanelProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsVariant, TagsInput, type TagsInputProps, DatePicker as Temporal, type TemporalPickerProps, type Testimonial, Testimonials, type TestimonialsProps, TextArea, type TextAreaProps, TextInput, type TextInputProps, type ThemeColors, type ThemeConfig, type ThemeDensity, type ThemeMotion, ThemeProvider, type ThemeProviderProps, type ThemeRadius, type ThemeShadows, ThemeSwitch, type ThemeSwitchProps, type ThemeTypography, TimePicker, type TimePickerProps, Timeline, type TimelineEvent, type TimelineProps, type TimelineStatus, Tooltip, type TooltipProps, TooltipProvider, TopBar, type TopBarProps, Tree, type TreeItemClickPayload, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type TypographyWeight, type UseFieldArrayReturn, type UseFormFieldOptions, type UseFormReturn, type ValidateTrigger, Video, type VideoProps, VirtualList, type VirtualListProps, Wizard, type WizardProps, type WizardStep, cardNumberError, cvvError, cx, defaultPasswordRules, detectBrand, expiryError, fieldShell, formatCardNumber, formatExpiry, isRequired, luhnValid, onlyDigits, patterns, runFieldRules, scorePassword, useBreakpoint, useCart, useFieldArray, useForm, useFormField, useFormStore, useJwt, useLocalStorage, useMediaQuery, useNotification };
+export { Accordion, type AccordionItemProps, type AccordionProps, AppShell, type AppShellProps, AutoComplete, type AutoCompleteProps, Avatar, type AvatarProps, type AvatarShape, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeSize, type BadgeTone, type BadgeVariant, Banner, type BannerProps, type BannerTone, Blog, type BlogPost, type BlogProps, Box, type BoxBackground, type BoxBorder, type BoxProps, type BoxRadius, type BoxShadow, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, type Breakpoint, type BreakpointState, Button, type ButtonProps, CARD_BRANDS, Card, type CardBodyProps, type CardBrand, CardCarousel, type CardCarouselProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, Cart, CartButton, type CartButtonProps, type CartContextValue, type CartItemInput, type CartLineItem, type CartProps, CartProvider, type CartProviderProps, type CartSummaryRow, Catalog, CatalogCarousel, type CatalogCarouselProps, CatalogGrid, type CatalogGridProps, type CatalogProps, type Cell, type CellEditInfo, type CellValue, Chat, type ChatMessage, type ChatProps, Checkbox, type CheckboxProps, Checkout, type CheckoutProps, type ClassValue, ColorPicker, type ColorPickerProps, type ConsentChoice, ContextMenu, type ContextMenuActionItem, type ContextMenuPosition, type ContextMenuProps, CookieConsent, type CookieConsentProps, CreditCardForm, type CreditCardFormProps, type CreditCardValue, DataGrid, type DataGridProps, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, type DeltaDirection, Drawer, type DrawerProps, type DrawerSize, Dropdown, type DropdownItem, type DropdownProps, type EditorArgs, EmptyCart, type EmptyCartProps, type ErrorMap, type ExpandRowOptions, FAB, type FABAction, type FABPosition, type FABProps, type FABSize, type FABTone, FadingBase, type FadingBaseProps, type Feature, FeatureGrid, type FeatureGridProps, Field, type FieldArrayItem, type FieldBindings, FieldHelpIcon, type FieldKind, FieldLabel, type FieldLabelProps, type FieldProps, type FieldRule, type FieldRules, type FieldShellOptions, type FieldSize, type FieldSnapshot, FileInput, type FileInputProps, type FileSource, Flex, type FlexAlign, type FlexDirection, type FlexJustify, type FlexProps, type FlexWrap, Form, FormContext, FormField, type FormFieldProps, type FormProps, FormStore, type FormStoreOptions, type FormValues, Grid, GridCard, type GridCardItem, type GridCardProps, type GridColumn, type GridProps, type GridSource, IconButton, type IconButtonProps, Jumbotron, type JumbotronBackground, type JumbotronLayout, type JumbotronProps, type JwtResult, Kbd, type KbdProps, type KbdSize, LeadCapture, type LeadCaptureProps, List, type ListItem, type ListProps, LoadingSpinner, type LoadingSpinnerProps, LogoutTimer, type LogoutTimerProps, MegaMenu, type MegaMenuFeaturedProps, type MegaMenuItemProps, type MegaMenuLinkProps, type MegaMenuPanelProps, type MegaMenuProps, type MegaMenuSectionProps, MenuButton, type MenuButtonItem, type MenuButtonProps, Modal, type ModalProps, type ModalSize, type NotificationPayload, NotificationProvider, NumberInput, type NumberInputProps, OpaqueGridCard, type OpaqueGridCardProps, OtpInput, type OtpInputProps, type PaginationOptions, Parallax, type ParallaxProps, Password, type PasswordProps, type PasswordRule, type PasswordScore, PasswordStrength, type PasswordStrengthProps, type PasswordStrengthResult, PdfViewer, type PdfViewerProps, PopConfirm, type PopConfirmProps, type PopConfirmTone, Portal, type PortalProps, type PricingPlan, PricingPlans, type PricingPlansProps, RadioGroup, type RadioGroupProps, type RadioOption, RadioTile, type RadioTileOption, type RadioTileProps, Rating, type RatingProps, type RemoteSourceOptions, type RulesMap, ScalableContainer, type ScalableContainerProps, Scheduler, type SchedulerEvent, type SchedulerProps, type SchedulerRange, type SchedulerView, SearchInput, type SearchInputProps, type SearchOptions, SecureLayout, type SecureLayoutProps, SegmentedControl, type SegmentedControlProps, type SegmentedOption, type SheetData, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, SkeletonBox, type SkeletonBoxProps, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonText, type SkeletonTextProps, type Slide, SlideShow, type SlideShowProps, Slider, type SliderMark, type SliderProps, type SliderValue, type SocialLink, type SocialPlatform, Socials, type SocialsProps, type SortDirection, type SortState, type Spacing, Spreadsheet, type SpreadsheetProps, Statistic, type StatisticDelta, type StatisticProps, type StatisticSize, Stepper, type StepperActiveStatus, type StepperProps, type StepperStep, Switch, type SwitchInputProps, Table, type TableColumn, type TableProps, Tabs, type TabsAddProps, type TabsListProps, type TabsOrientation, type TabsPanelProps, type TabsProps, type TabsSize, type TabsTriggerProps, type TabsVariant, TagsInput, type TagsInputProps, DatePicker as Temporal, type TemporalPickerProps, type Testimonial, Testimonials, type TestimonialsProps, TextArea, type TextAreaProps, TextInput, type TextInputProps, type ThemeColors, type ThemeConfig, type ThemeDensity, type ThemeMotion, ThemeProvider, type ThemeProviderProps, type ThemeRadius, type ThemeShadows, ThemeSwitch, type ThemeSwitchProps, type ThemeTypography, TimePicker, type TimePickerProps, Timeline, type TimelineEvent, type TimelineProps, type TimelineStatus, Tooltip, type TooltipProps, TooltipProvider, TopBar, type TopBarProps, Tree, type TreeItemClickPayload, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type TypographyWeight, type UseFieldArrayReturn, type UseFormFieldOptions, type UseFormReturn, type ValidateTrigger, Video, type VideoProps, VirtualList, type VirtualListProps, Wizard, type WizardProps, type WizardStep, cardNumberError, cvvError, cx, defaultPasswordRules, detectBrand, expiryError, fieldShell, formatCardNumber, formatExpiry, isRequired, luhnValid, onlyDigits, patterns, runFieldRules, scorePassword, useBreakpoint, useCart, useFieldArray, useForm, useFormField, useFormStore, useJwt, useLocalStorage, useMediaQuery, useNotification };