@postxl/ui-components 1.5.3 → 1.5.5

package/dist/index.d.ts

@@ -791,6 +791,8 @@ type Cell = {
   prefix?: string | ((row: unknown, value: number | null) => React$36.ReactNode);
   suffix?: string | ((row: unknown, value: number | null) => React$36.ReactNode);
   fallbackValue?: string;
+  /** Optional formatter for display mode. Takes a number and returns a formatted string. */
+  formatter?: (value: number) => string;
 } | ({
   variant: 'select';
   hasSearch?: boolean;
@@ -2270,28 +2272,26 @@ declare function Sidebar({
   side,
   variant,
   collapsible,
-  sidebarId,
   minWidth,
   maxWidth,
   className,
   children,
   ...props
 }: React$13.ComponentProps<'div'> & {
-  side?: 'left' | 'right';
+  side?: SidebarSide;
   variant?: 'sidebar' | 'floating' | 'inset';
   collapsible?: 'offcanvas' | 'icon' | 'none';
-  sidebarId?: string;
   minWidth?: number;
   maxWidth?: number;
 }): react_jsx_runtime171.JSX.Element;
 declare function SidebarTrigger({
   className,
   onClick,
-  sidebarId,
+  side,
   children,
   ...props
 }: React$13.ComponentProps<typeof Button> & {
-  sidebarId?: string;
+  side?: SidebarSide;
 }): react_jsx_runtime171.JSX.Element;
 declare function SidebarRail({
   className,
@@ -2434,20 +2434,19 @@ type SidebarContextProps = {
   maxWidth: number;
 };
 type SidebarRegistryEntry = {
-  side: 'left' | 'right';
   minWidth: number;
   maxWidth: number;
 };
 type SidebarProviderState = {
-  openStates: Record<string, boolean>;
-  mobileStates: Record<string, boolean>;
-  widthStates: Record<string, number | undefined>;
-  sidebarRegistry: Record<string, SidebarRegistryEntry>;
-  setOpen: (id: string, open: boolean) => void;
-  setOpenMobile: (id: string, open: boolean) => void;
-  setWidth: (id: string, width: number) => void;
-  registerSidebar: (id: string, config: SidebarRegistryEntry) => void;
-  unregisterSidebar: (id: string) => void;
+  openStates: Partial<Record<SidebarSide, boolean>>;
+  mobileStates: Partial<Record<SidebarSide, boolean>>;
+  widthStates: Partial<Record<SidebarSide, number | undefined>>;
+  sidebarRegistry: Partial<Record<SidebarSide, SidebarRegistryEntry>>;
+  setOpen: (side: SidebarSide, open: boolean) => void;
+  setOpenMobile: (side: SidebarSide, open: boolean) => void;
+  setWidth: (side: SidebarSide, width: number) => void;
+  registerSidebar: (side: SidebarSide, config: SidebarRegistryEntry) => void;
+  unregisterSidebar: (side: SidebarSide) => void;
   isMobile: boolean;
   defaultOpen: boolean;
   isResizing: boolean;
@@ -2462,27 +2461,27 @@ type SidebarProviderState = {
 declare const SidebarContext: React$12.Context<SidebarProviderState | null>;
 /**
  * Context that identifies which sidebar a component belongs to.
- * Set by `<Sidebar sidebarId="...">`, consumed by `useSidebar()`.
+ * Set by `<Sidebar side="...">`, consumed by `useSidebar()`.
  */
-declare const SidebarIdContext: React$12.Context<string>;
+declare const SidebarSideContext: React$12.Context<SidebarSide | null>;
 /**
  * Returns the state and controls for a specific sidebar.
  *
- * @param sidebarId - Optional explicit sidebar ID. Falls back to the nearest
- *   `SidebarIdContext` (set by the parent `<Sidebar>`), then to `"default"`.
+ * @param side - Optional explicit sidebar side. Falls back to the nearest
+ *   `SidebarSideContext` (set by the parent `<Sidebar>`), then to `"left"`.
  */
-declare function useSidebar(sidebarId?: string): SidebarContextProps;
+declare function useSidebar(side?: SidebarSide): SidebarContextProps;
 /**
- * Returns a list of all registered sidebars with their IDs and sides.
+ * Returns a list of all registered sidebars with their sides.
  */
 declare function useRegisteredSidebars(): {
-  sidebarId: string;
-  side: 'left' | 'right';
+  side: SidebarSide;
 }[];
 declare function SidebarProvider({
   defaultOpen,
   open: openProp,
   onOpenChange: setOpenProp,
+  controlledSide,
   width: widthProp,
   onWidthChange,
   minWidth,
@@ -2499,19 +2498,19 @@ declare function SidebarProvider({
   defaultOpen?: boolean;
   open?: boolean;
   onOpenChange?: (open: boolean) => void;
-  /** Controlled width for the "default" sidebar (backward compat). */
+  /** Which sidebar the controlled `open`/`onOpenChange`/`width`/`onWidthChange` props apply to. Defaults to `'left'`. */
+  controlledSide?: SidebarSide;
   width?: number;
-  /** Called when the "default" sidebar width changes via resize (backward compat). */
   onWidthChange?: (width: number) => void;
   minWidth?: number;
   maxWidth?: number;
   storageKey?: string;
-  defaultOpenSidebars?: Record<string, boolean>;
-  /** Default widths per sidebar ID (in pixels). */
-  defaultWidths?: Record<string, number>;
-  /** Keyboard shortcuts mapping: key character → sidebar ID. Uses Ctrl/Cmd modifier.
-   *  Defaults to `{ b: 'default' }`. Set to `false` to disable all shortcuts. */
-  keyboardShortcuts?: Record<string, string> | false;
+  defaultOpenSidebars?: Partial<Record<SidebarSide, boolean>>;
+  /** Default widths per sidebar side (in pixels). */
+  defaultWidths?: Partial<Record<SidebarSide, number>>;
+  /** Keyboard shortcuts mapping: key character → sidebar side. Uses Ctrl/Cmd modifier.
+   *  Defaults to `{ b: 'left' }`. Set to `false` to disable all shortcuts. */
+  keyboardShortcuts?: Record<string, SidebarSide> | false;
 }): react_jsx_runtime194.JSX.Element;
 
 //#endregion
@@ -2539,9 +2538,12 @@ type SidebarTabsState = {
 };
 declare const SidebarTabsContext: React$11.Context<SidebarTabsState | null>;
 declare function SidebarTabsProvider({
-  children
+  children,
+  storageKey
 }: Readonly<{
   children: React$11.ReactNode;
+  /** localStorage key to persist the active tab per side. */
+  storageKey?: string;
 }>): react_jsx_runtime196.JSX.Element;
 declare function useSidebarTabs(side?: SidebarSide): SidebarTabsState | {
   tabs: SidebarTabDefinition[];
@@ -2572,7 +2574,7 @@ declare function DynamicTabbedSidebar({
   side: SidebarSide;
   orientation?: 'horizontal' | 'vertical';
   collapsible?: 'offcanvas' | 'icon' | 'none';
-} & Omit<React$10.ComponentProps<typeof Sidebar>, 'side' | 'collapsible' | 'sidebarId'>): react_jsx_runtime195.JSX.Element;
+} & Omit<React$10.ComponentProps<typeof Sidebar>, 'side' | 'collapsible'>): react_jsx_runtime195.JSX.Element | null;
 
 //#endregion
 //#region src/skeleton/skeleton.d.ts
@@ -2937,5 +2939,5 @@ declare const TreeView: React$2.ForwardRefExoticComponent<Callbacks & {
 } & React$2.RefAttributes<HTMLDivElement>>;
 
 //#endregion
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, KanbanBoard as Board, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, CarouselProps, Cell, CellHierarchyOption, CellPosition, CellRange, CellSelectOption, CellSelectOptionsMap, CellSelectOptionsUnion, CellVariantProps, Checkbox, CheckboxCell, Collapse, CollapseContent, CollapseTrigger, KanbanColumn as Column, KanbanColumnHandle as ColumnHandle, ColumnMenuRendererFunction, ComboboxDemo, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandInputProps, CommandItem, CommandList, CommandPalette, CommandPaletteDialog, CommandPaletteEmpty, CommandPaletteGroup, CommandPaletteInput, CommandPaletteItem, CommandPaletteList, CommandPaletteSeparator, CommandPaletteShortcut, CommandSeparator, CommandShortcut, CommentCallbacks, CommentCreate, CommentGroup, CommentItem, CommentList, CommentThread, ContentFrame, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuState, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DataGrid, DataGridCell, DataGridCellWrapper, DataGridColumnHeader, DataGridContextMenu, DataGridRow, DataGridSearch, DataGridViewMenu, DataGridViewMenuProps, DateCell, DatePickerDemo, DeferredInput, DeferredInputProps, DeferredNumberInput, DeferredNumberInputProps, DeferredTextarea, DeferredTextareaProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DynamicTabbedSidebar, ExternalToast, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, GanttCell, GanttCellProps, GanttTimeline, GanttTimerangePicker, GanttTimerangePickerProps, HeaderComponents, HierarchyCell, HierarchyItem, HierarchyItemProps, HoverCard, HoverCardContent, HoverCardTrigger, ISODateRange, InfoCard, InfoCardVariant, Input, InputProps, KanbanItem as Item, KanbanItemHandle as ItemHandle, KanbanRoot as Kanban, KanbanBoard, KanbanColumn, KanbanColumnHandle, KanbanItem, KanbanItemHandle, KanbanOverlay, Label, Loader, LongTextCell, MarkValueRenderer, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, Modal, MultiSelectCell, NavigationDirection, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NumberCell, NumberFormatConfig, NumberFormatter, NumberInput, NumberInputProps, KanbanOverlay as Overlay, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ReactNodeCell, ResizableHandle, ResizablePanel, ResizablePanelGroup, KanbanRoot as Root, RowHeightValue, SIDEBAR_KEYBOARD_SHORTCUT, SIDEBAR_KEYBOARD_SHORTCUT_RIGHT, SIDEBAR_MAX_WIDTH, SIDEBAR_MIN_WIDTH, SIDEBAR_WIDTH, SIDEBAR_WIDTH_ICON, SIDEBAR_WIDTH_MOBILE, SavedView, ScrollArea, ScrollBar, SearchState, Select, SelectCell, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectionState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, ShortTextCell, Sidebar, SidebarContent, SidebarContext, SidebarContextProps, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarIdContext, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarSide, SidebarTab, SidebarTabBadge, SidebarTabDefinition, SidebarTabsContext, SidebarTabsProvider, SidebarTrigger, Skeleton, Slicer, SlicerFilterOption, SlicerHierarchyItem, Slider, Spinner, Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperList, StepperNext, StepperPrev, StepperProps, StepperSeparator, StepperTitle, StepperTrigger, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster, ToasterProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TreeBranch, TreeNode, TreeView, TreeViewProps, UpdateCell, UseDataGridProps, badgeVariants, buildLabelMap, buttonVariants, checkboxVariants, cn, commandInputVariants, createSelectColumn, findOptionById, getAllDescendantIds, getAllDescendantValues, getAllIds, getAncestorIds, getCellKey, getCommonPinningStyles, getInitialExpandedIds, getLabelPath, getLineCount, getRowHeightValue, inputVariants, isoToLocalDate, knobVariants, matchesSearch, navigationMenuTriggerStyle, parseCellKey, sliderVariants, testId, toast, toggleVariants, useCallbackRef, useDataGrid, useDebouncedCallback, useIsMobile, useRegisteredSidebars, useSidebar, useSidebarTabs, useStore as useStepper };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, KanbanBoard as Board, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonProps, Calendar, CalendarDayButton, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, CarouselProps, Cell, CellHierarchyOption, CellPosition, CellRange, CellSelectOption, CellSelectOptionsMap, CellSelectOptionsUnion, CellVariantProps, Checkbox, CheckboxCell, Collapse, CollapseContent, CollapseTrigger, KanbanColumn as Column, KanbanColumnHandle as ColumnHandle, ColumnMenuRendererFunction, ComboboxDemo, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandInputProps, CommandItem, CommandList, CommandPalette, CommandPaletteDialog, CommandPaletteEmpty, CommandPaletteGroup, CommandPaletteInput, CommandPaletteItem, CommandPaletteList, CommandPaletteSeparator, CommandPaletteShortcut, CommandSeparator, CommandShortcut, CommentCallbacks, CommentCreate, CommentGroup, CommentItem, CommentList, CommentThread, ContentFrame, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuState, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DataGrid, DataGridCell, DataGridCellWrapper, DataGridColumnHeader, DataGridContextMenu, DataGridRow, DataGridSearch, DataGridViewMenu, DataGridViewMenuProps, DateCell, DatePickerDemo, DeferredInput, DeferredInputProps, DeferredNumberInput, DeferredNumberInputProps, DeferredTextarea, DeferredTextareaProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DynamicTabbedSidebar, ExternalToast, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, GanttCell, GanttCellProps, GanttTimeline, GanttTimerangePicker, GanttTimerangePickerProps, HeaderComponents, HierarchyCell, HierarchyItem, HierarchyItemProps, HoverCard, HoverCardContent, HoverCardTrigger, ISODateRange, InfoCard, InfoCardVariant, Input, InputProps, KanbanItem as Item, KanbanItemHandle as ItemHandle, KanbanRoot as Kanban, KanbanBoard, KanbanColumn, KanbanColumnHandle, KanbanItem, KanbanItemHandle, KanbanOverlay, Label, Loader, LongTextCell, MarkValueRenderer, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, Modal, MultiSelectCell, NavigationDirection, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NumberCell, NumberFormatConfig, NumberFormatter, NumberInput, NumberInputProps, KanbanOverlay as Overlay, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, Progress, RadioGroup, RadioGroupItem, ReactNodeCell, ResizableHandle, ResizablePanel, ResizablePanelGroup, KanbanRoot as Root, RowHeightValue, SIDEBAR_KEYBOARD_SHORTCUT, SIDEBAR_KEYBOARD_SHORTCUT_RIGHT, SIDEBAR_MAX_WIDTH, SIDEBAR_MIN_WIDTH, SIDEBAR_WIDTH, SIDEBAR_WIDTH_ICON, SIDEBAR_WIDTH_MOBILE, SavedView, ScrollArea, ScrollBar, SearchState, Select, SelectCell, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SelectionState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, ShortTextCell, Sidebar, SidebarContent, SidebarContext, SidebarContextProps, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarSide, SidebarSideContext, SidebarTab, SidebarTabBadge, SidebarTabDefinition, SidebarTabsContext, SidebarTabsProvider, SidebarTrigger, Skeleton, Slicer, SlicerFilterOption, SlicerHierarchyItem, Slider, Spinner, Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperList, StepperNext, StepperPrev, StepperProps, StepperSeparator, StepperTitle, StepperTrigger, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster, ToasterProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TreeBranch, TreeNode, TreeView, TreeViewProps, UpdateCell, UseDataGridProps, badgeVariants, buildLabelMap, buttonVariants, checkboxVariants, cn, commandInputVariants, createSelectColumn, findOptionById, getAllDescendantIds, getAllDescendantValues, getAllIds, getAncestorIds, getCellKey, getCommonPinningStyles, getInitialExpandedIds, getLabelPath, getLineCount, getRowHeightValue, inputVariants, isoToLocalDate, knobVariants, matchesSearch, navigationMenuTriggerStyle, parseCellKey, sliderVariants, testId, toast, toggleVariants, useCallbackRef, useDataGrid, useDebouncedCallback, useIsMobile, useRegisteredSidebars, useSidebar, useSidebarTabs, useStore as useStepper };
 //# sourceMappingURL=index.d.ts.map