@geomak/ui 7.7.3 → 7.8.0

package/dist/index.d.cts

@@ -2084,22 +2084,22 @@ interface ListProps {
 declare function List({ items, onItemClick, activeKey, density, className, style, }: ListProps): react_jsx_runtime.JSX.Element;
 
 interface ScalableContainerProps {
-    /** Resting width. Any CSS length / percent. Default `'100%'`. */
+    /**
+     * Resting width. Optional — when omitted, the resting size is left to your
+     * own `className` / parent layout (so the container can sit in a fluid grid
+     * sized by `w-[…]` classes). Only set this if you want an inline width.
+     */
     width?: react__default.CSSProperties['width'];
-    /** Resting height. Any CSS length / percent. Default `'auto'`. */
+    /** Resting height. Optional — see {@link ScalableContainerProps.width}. */
     height?: react__default.CSSProperties['height'];
     /**
-     * Width when expanded. A concrete value (e.g. `900` or `'60rem'`) makes the
-     * container grow even when its resting width is `'100%'` inside a flex/grid
-     * cell. Falls back to {@link ScalableContainerProps.expandedWidth}, then
-     * `'100%'`.
+     * Width when expanded. Default `'100%'`. Use `'100%'` to span the full row
+     * of a flex/grid so the container pushes its neighbours onto the next
+     * row(s); a concrete value (e.g. `900`) grows it to that exact width.
      */
     targetWidth?: react__default.CSSProperties['width'];
-    /**
-     * Height when expanded. A concrete value (e.g. `600`) lets the container
-     * grow taller and push whatever sits below it further down. Falls back to
-     * {@link ScalableContainerProps.expandedHeight}, then `'100%'`.
-     */
+    /** Height when expanded. Default `'100%'`. A concrete value (e.g. `580`)
+     *  grows the container taller and pushes whatever follows further down. */
     targetHeight?: react__default.CSSProperties['height'];
     /** @deprecated Use `targetWidth`. */
     expandedWidth?: react__default.CSSProperties['width'];
@@ -2130,24 +2130,31 @@ interface ScalableContainerProps {
     className?: string;
 }
 /**
- * Container that smoothly grows to a target size on click and collapses back.
- * Reads like an OS window resize — subtle elevation lift, smooth scale, no
- * colour change.
- *
- * Expansion grows the container's OWN box to `targetWidth` × `targetHeight` and
- * makes it `flex-none` while expanded, so it holds that size and simply pushes
- * its neighbours along the flow — they keep their own dimensions and reflow
- * (e.g. wrap onto the next row / move down) rather than being squeezed. Nothing
- * on sibling elements is mutated, so layouts restore exactly on collapse. For
- * neighbours to reflow *below*, give the parent room to wrap (e.g. a
- * `flex flex-wrap` row, or block/auto-rows-grid flow).
+ * Container that grows to a target size on click and collapses back. Reads like
+ * an OS window resize — subtle elevation lift, smooth size transition.
+ *
+ * **Resting size comes from your layout, not from props.** Leave `width`/`height`
+ * unset and size the container with your own `className` (e.g. a fluid grid:
+ * `w-full lg:w-[calc(50%-6px)]`). Only when expanded does the container write an
+ * inline `width`/`height` (= `targetWidth`/`targetHeight`) and go `flex: none`,
+ * so it grows to that size and simply **pushes its neighbours along the flow** —
+ * they keep their own dimensions and reflow (wrap / move down). On collapse the
+ * inline sizing is removed and your className layout takes back over. No sibling
+ * styles are ever touched.
+ *
+ * For neighbours to reflow *below* the expanded one, the parent must be able to
+ * wrap — a `flex flex-wrap` row is the simplest; with `targetWidth="100%"` the
+ * expanded item takes a full row and everything after it moves down.
  *
  * @example
  * ```tsx
- * // In a flex-wrap chart grid — expands to a concrete size and pushes the rest down.
- * <div className="flex flex-wrap gap-2">
- *   <ScalableContainer width="100%" height={240} targetWidth="100%" targetHeight={520}>
- *     <Chart data={metrics} />
+ * <div className="flex flex-wrap gap-3">
+ *   <ScalableContainer
+ *     className="w-full lg:w-[calc(50%-6px)]"   // resting size — your grid
+ *     height={300}                              // resting height
+ *     targetWidth="100%" targetHeight={580}     // expanded size
+ *   >
+ *     <Chart … />
  *   </ScalableContainer>
  *   …
  * </div>
@@ -2637,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: {
@@ -5545,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

@@ -2084,22 +2084,22 @@ interface ListProps {
 declare function List({ items, onItemClick, activeKey, density, className, style, }: ListProps): react_jsx_runtime.JSX.Element;
 
 interface ScalableContainerProps {
-    /** Resting width. Any CSS length / percent. Default `'100%'`. */
+    /**
+     * Resting width. Optional — when omitted, the resting size is left to your
+     * own `className` / parent layout (so the container can sit in a fluid grid
+     * sized by `w-[…]` classes). Only set this if you want an inline width.
+     */
     width?: react__default.CSSProperties['width'];
-    /** Resting height. Any CSS length / percent. Default `'auto'`. */
+    /** Resting height. Optional — see {@link ScalableContainerProps.width}. */
     height?: react__default.CSSProperties['height'];
     /**
-     * Width when expanded. A concrete value (e.g. `900` or `'60rem'`) makes the
-     * container grow even when its resting width is `'100%'` inside a flex/grid
-     * cell. Falls back to {@link ScalableContainerProps.expandedWidth}, then
-     * `'100%'`.
+     * Width when expanded. Default `'100%'`. Use `'100%'` to span the full row
+     * of a flex/grid so the container pushes its neighbours onto the next
+     * row(s); a concrete value (e.g. `900`) grows it to that exact width.
      */
     targetWidth?: react__default.CSSProperties['width'];
-    /**
-     * Height when expanded. A concrete value (e.g. `600`) lets the container
-     * grow taller and push whatever sits below it further down. Falls back to
-     * {@link ScalableContainerProps.expandedHeight}, then `'100%'`.
-     */
+    /** Height when expanded. Default `'100%'`. A concrete value (e.g. `580`)
+     *  grows the container taller and pushes whatever follows further down. */
     targetHeight?: react__default.CSSProperties['height'];
     /** @deprecated Use `targetWidth`. */
     expandedWidth?: react__default.CSSProperties['width'];
@@ -2130,24 +2130,31 @@ interface ScalableContainerProps {
     className?: string;
 }
 /**
- * Container that smoothly grows to a target size on click and collapses back.
- * Reads like an OS window resize — subtle elevation lift, smooth scale, no
- * colour change.
- *
- * Expansion grows the container's OWN box to `targetWidth` × `targetHeight` and
- * makes it `flex-none` while expanded, so it holds that size and simply pushes
- * its neighbours along the flow — they keep their own dimensions and reflow
- * (e.g. wrap onto the next row / move down) rather than being squeezed. Nothing
- * on sibling elements is mutated, so layouts restore exactly on collapse. For
- * neighbours to reflow *below*, give the parent room to wrap (e.g. a
- * `flex flex-wrap` row, or block/auto-rows-grid flow).
+ * Container that grows to a target size on click and collapses back. Reads like
+ * an OS window resize — subtle elevation lift, smooth size transition.
+ *
+ * **Resting size comes from your layout, not from props.** Leave `width`/`height`
+ * unset and size the container with your own `className` (e.g. a fluid grid:
+ * `w-full lg:w-[calc(50%-6px)]`). Only when expanded does the container write an
+ * inline `width`/`height` (= `targetWidth`/`targetHeight`) and go `flex: none`,
+ * so it grows to that size and simply **pushes its neighbours along the flow** —
+ * they keep their own dimensions and reflow (wrap / move down). On collapse the
+ * inline sizing is removed and your className layout takes back over. No sibling
+ * styles are ever touched.
+ *
+ * For neighbours to reflow *below* the expanded one, the parent must be able to
+ * wrap — a `flex flex-wrap` row is the simplest; with `targetWidth="100%"` the
+ * expanded item takes a full row and everything after it moves down.
  *
  * @example
  * ```tsx
- * // In a flex-wrap chart grid — expands to a concrete size and pushes the rest down.
- * <div className="flex flex-wrap gap-2">
- *   <ScalableContainer width="100%" height={240} targetWidth="100%" targetHeight={520}>
- *     <Chart data={metrics} />
+ * <div className="flex flex-wrap gap-3">
+ *   <ScalableContainer
+ *     className="w-full lg:w-[calc(50%-6px)]"   // resting size — your grid
+ *     height={300}                              // resting height
+ *     targetWidth="100%" targetHeight={580}     // expanded size
+ *   >
+ *     <Chart … />
  *   </ScalableContainer>
  *   …
  * </div>
@@ -2637,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: {
@@ -5545,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 };