@cascivo/react 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -465,6 +465,52 @@ declare function AccordionItem({
 }: AccordionItemProps): import("react").JSX.Element;
 declare function AccordionTrigger(props: HTMLAttributes<HTMLButtonElement>): import("react").JSX.Element;
 declare function AccordionContent(props: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
+interface ActionSheetAction {
+  label: ReactNode;
+  onSelect: () => void;
+  /** Render in the destructive (danger) style. */
+  destructive?: boolean;
+  disabled?: boolean;
+}
+interface ActionSheetProps {
+  /** Controlled open state. */
+  open?: boolean;
+  /** Initial open state for uncontrolled use. */
+  defaultOpen?: boolean;
+  /** Called whenever the open state should change (selection, cancel, Escape, outside press). */
+  onOpenChange?: (open: boolean) => void;
+  /** The choices presented, top to bottom. */
+  actions: ActionSheetAction[];
+  /** Optional heading shown above the actions; also labels the menu. */
+  title?: ReactNode;
+  /** Optional supporting message under the title. */
+  description?: ReactNode;
+  /** Show the separate Cancel button. Default true. */
+  showCancel?: boolean;
+  labels?: {
+    cancel?: string;
+    label?: string;
+  };
+  className?: string;
+}
+/**
+ * Bottom-rising sheet of discrete actions (iOS action-sheet pattern). Renders a
+ * role="menu" of menuitems with vertical roving focus (Arrow keys, Home/End, wraps);
+ * Escape and outside press dismiss it, and a separate Cancel button gives an explicit
+ * non-destructive exit. Body scroll is not locked — the sheet is transient. Reuses the
+ * overlay primitives and CSS-only slide; no animation library.
+ */
+declare function ActionSheet({
+  open,
+  defaultOpen,
+  onOpenChange,
+  actions,
+  title,
+  description,
+  showCancel,
+  labels,
+  className
+}: ActionSheetProps): import("react").JSX.Element;
 interface KbdProps extends HTMLAttributes<HTMLElement> {
   size?: 'sm' | 'md';
 }
@@ -567,11 +613,25 @@ declare function Header({
   className,
   ...props
 }: HeaderProps): import("react").JSX.Element;
-interface SideNavSubItem {
+type SideNavTone = 'default' | 'danger' | 'warning' | 'success';
+/** A selectable/navigable sub-item (link when `href` is set, action when `onSelect` is set). */
+interface SideNavLinkSubItem {
   label: string;
-  href: string;
+  href?: string;
+  icon?: ReactNode;
   active?: boolean;
+  /** Shows a trailing checkmark; use for picker-style "current selection" rows. */
+  selected?: boolean;
+  /** Runs an action instead of navigating. When set without `href`, renders a `<button>`. */
+  onSelect?: () => void;
+  disabled?: boolean;
 }
+type SideNavSubItem = SideNavLinkSubItem | {
+  type: 'separator';
+} | {
+  type: 'label';
+  label: string;
+};
 interface SideNavItem {
   label: string;
   href?: string;
@@ -579,6 +639,19 @@ interface SideNavItem {
   active?: boolean;
   items?: SideNavSubItem[];
   onClick?: (e: MouseEvent<HTMLAnchorElement>) => void;
+  /** Non-interactive and visually dimmed. */
+  disabled?: boolean;
+  /** Recolors the item; `'default'` is the standard subtle color. */
+  tone?: SideNavTone;
+  /** Rendered right-aligned after the label (e.g. a Kbd hint, badge, count); hidden on the rail. */
+  trailing?: ReactNode;
+  /**
+   * Escape hatch: render arbitrary content inside the item's shell so it inherits
+   * alignment and the collapse context. When set, the item's own fields are ignored.
+   */
+  render?: (ctx: {
+    collapsed: boolean;
+  }) => ReactNode;
 }
 interface SideNavGroup {
   label?: string;
@@ -595,6 +668,8 @@ interface SideNavProps {
   expandLabel?: string;
   expandOnHover?: boolean;
   showCollapseToggle?: boolean;
+  /** Content rendered above the items, inside the item padding context. */
+  header?: ReactNode;
   footer?: ReactNode;
   className?: string;
 }
@@ -609,6 +684,7 @@ declare function SideNav({
   expandLabel,
   expandOnHover,
   showCollapseToggle,
+  header,
   footer,
   className
 }: SideNavProps): import("react").JSX.Element;
@@ -721,6 +797,50 @@ declare function EmptyState({
   className,
   ...props
 }: EmptyStateProps): import("react").JSX.Element;
+interface FabAction {
+  /** Accessible name and visible label for the speed-dial item. */
+  label: string;
+  icon: ReactNode;
+  onSelect: () => void;
+  disabled?: boolean;
+}
+interface FabProps {
+  /** The main button icon. */
+  children: ReactNode;
+  /** Accessible name for the main button (it is icon-only). */
+  label: string;
+  /** Called on press when there is no speed-dial. Ignored when `actions` is set. */
+  onClick?: () => void;
+  /** Speed-dial actions revealed above the button when opened. */
+  actions?: FabAction[];
+  /** Screen corner to anchor to. */
+  position?: 'bottom-end' | 'bottom-start';
+  /** Controlled speed-dial open state. */
+  open?: boolean;
+  /** Initial speed-dial open state for uncontrolled use. */
+  defaultOpen?: boolean;
+  /** Called whenever the speed-dial open state should change. */
+  onOpenChange?: (open: boolean) => void;
+  className?: string;
+}
+/**
+ * Floating action button anchored to a screen corner. On its own it is a single
+ * fixed button; given `actions` it becomes a speed-dial whose main button toggles a
+ * role="menu" of secondary actions (vertical roving focus, Escape / outside press to
+ * collapse, focus returns to the button). Fixed position honours the safe-area insets;
+ * CSS-only motion, no animation library.
+ */
+declare function Fab({
+  children,
+  label,
+  onClick,
+  actions,
+  position,
+  open,
+  defaultOpen,
+  onOpenChange,
+  className
+}: FabProps): import("react").JSX.Element;
 interface OverflowMenuItem {
   label: string;
   value: string;
@@ -1261,6 +1381,56 @@ declare function Sheet({
   children,
   side
 }: SheetProps): import("react").JSX.Element;
+interface BottomSheetProps {
+  /** Controlled open state. */
+  open?: boolean;
+  /** Initial open state for uncontrolled use. */
+  defaultOpen?: boolean;
+  /** Called whenever the open state should change (drag-dismiss, Escape, outside press). */
+  onOpenChange?: (open: boolean) => void;
+  /**
+   * Detent heights as fractions of the viewport (0–1), ascending. The sheet snaps
+   * between these; dragging below the lowest dismisses it. Defaults to half + near-full.
+   */
+  snapPoints?: number[];
+  /** Controlled active detent index into `snapPoints`. */
+  activeSnap?: number;
+  /** Initial active detent index for uncontrolled use. Defaults to the lowest detent. */
+  defaultSnap?: number;
+  /** Called when the active detent changes via drag. */
+  onSnapChange?: (index: number) => void;
+  /** Accessible title shown in the header and used to label the dialog. */
+  title?: ReactNode;
+  /** Optional supporting description shown under the title. */
+  description?: ReactNode;
+  children?: ReactNode;
+  labels?: {
+    close?: string;
+    handle?: string;
+  };
+  className?: string;
+}
+/**
+ * Mobile bottom sheet with drag-to-resize detents. The panel is sized to its tallest
+ * detent and translated down to reveal only the active one; dragging the grab handle
+ * moves it and, on release, snaps to the nearest detent (projected by fling velocity)
+ * or dismisses past the lowest. Body scroll is locked, focus is trapped, and Escape /
+ * outside press dismiss it. CSS translate only — no animation library.
+ */
+declare function BottomSheet({
+  open,
+  defaultOpen,
+  onOpenChange,
+  snapPoints,
+  activeSnap,
+  defaultSnap,
+  onSnapChange,
+  title,
+  description,
+  children,
+  labels,
+  className
+}: BottomSheetProps): import("react").JSX.Element;
 interface ContextMenuProps {
   children: ReactNode;
 }
@@ -1820,6 +1990,35 @@ declare function Prose({
   children,
   ...props
 }: ProseProps): import("react").JSX.Element;
+interface PullToRefreshProps {
+  /** Invoked when the pull passes the threshold; the spinner shows until it settles. */
+  onRefresh: () => Promise<unknown> | unknown;
+  children: ReactNode;
+  /** Pull distance (px) required to trigger a refresh. Default 64. */
+  threshold?: number;
+  disabled?: boolean;
+  labels?: {
+    pull?: string;
+    release?: string;
+    refreshing?: string;
+  };
+  className?: string;
+}
+/**
+ * Wraps a vertically scrollable region and triggers `onRefresh` when the user pulls
+ * down past a threshold while scrolled to the top. The gesture is damped (rubber-band),
+ * shows a spinner while the returned promise settles, then springs back. Pointer logic
+ * runs in `useSignalEffect`; CSS translate only, no animation library. Pull is only armed
+ * at scrollTop 0, so normal scrolling is untouched.
+ */
+declare function PullToRefresh({
+  onRefresh,
+  children,
+  threshold,
+  disabled,
+  labels,
+  className
+}: PullToRefreshProps): import("react").JSX.Element;
 /**
  * Minimal QR Code encoder (byte mode, versions 1–40, EC levels L/M/Q/H).
  *
@@ -2831,4 +3030,34 @@ declare function Swap({
   className,
   ...aria
 }: SwapProps): import("react").JSX.Element;
-export { Accordion, AccordionContent, AccordionItem, AccordionItemProps, AccordionProps, AccordionTrigger, Alert, AlertDialog, AlertDialogLabels, AlertDialogProps, AlertProps, AppShell, AppShellProps, AspectRatio, AspectRatioProps, Avatar, AvatarGroup, AvatarGroupLabels, AvatarGroupProps, AvatarProps, Badge, BadgeProps, Blockquote, BlockquoteProps, Breadcrumb, BreadcrumbItem, BreadcrumbProps, Button, ButtonGroup, ButtonGroupProps, ButtonProps, Calendar, CalendarLabels, CalendarProps, Card, CardContent, CardContentProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, Carousel, CarouselLabels, CarouselProps, ChatBubble, ChatBubbleProps, ChatBubbleSide, Checkbox, CheckboxCard, CheckboxCardProps, CheckboxProps, Code, type CodeLang, CodeProps, CodeSnippet, CodeSnippetProps, Collapsible, CollapsibleProps, ColorPicker, ColorPickerLabels, ColorPickerProps, Column, Combobox, ComboboxLabels, ComboboxOption, ComboboxProps, CommandGroup, CommandItem, CommandMenu, CommandMenuProps, CommandPage, Comparison, ComparisonProps, ContainedList, ContainedListItem, ContainedListItemProps, ContainedListProps, ContextMenu, ContextMenuItem, ContextMenuItemProps, ContextMenuProps, CopyButton, CopyButtonProps, DataList, DataListItem, DataListProps, DataTable, DataTableLabels, DataTableProps, DatePicker, DatePickerLabels, DatePickerProps, DateRange, DateRangePicker, DateRangePickerLabels, DateRangePickerProps, DateRangePreset, Dock, DockItem, DockProps, Drawer, DrawerProps, Dropdown, DropdownItem, DropdownProps, Editable, EditableProps, EmptyState, EmptyStateProps, ErrorBoundary, Field, FieldProps, FileUploader, FileUploaderLabels, FileUploaderProps, Filter, FilterOption, FilterProps, FilterVariant, FocusScope, Form, FormConfig, FormProps, FormStore, Header, HeaderLabels, HeaderLink, HeaderPanel, HeaderPanelLabels, HeaderPanelProps, HeaderProps, Heading, HeadingLevel, HeadingProps, HeadingSize, HoverCard, HoverCardContent, HoverCardContentProps, HoverCardProps, HoverCardTrigger, HoverCardTriggerProps, IconButton, IconButtonProps, Image, ImageProps, Indicator, IndicatorPlacement, IndicatorProps, InlineLoading, InlineLoadingProps, InlineLoadingStatus, Input, InputGroup, InputGroupAddon, type InputGroupAddonProps, type InputGroupProps, InputProps, Item, ItemActions, ItemActionsProps, ItemContent, ItemContentProps, ItemDescription, ItemDescriptionProps, ItemMedia, ItemMediaProps, ItemProps, ItemTitle, ItemTitleProps, Join, JoinOrientation, JoinProps, Kbd, KbdProps, Label, LabelProps, Link, LinkProps, List, ListItem, ListItemProps, ListProps, Menu, MenuButton, MenuButtonItem, MenuButtonProps, MenuItem, MenuItemProps, MenuProps, MenuSeparator, MenuTrigger, MenuTriggerProps, Menubar, MenubarItem, MenubarMenu, MenubarProps, Modal, ModalProps, MultiSelect, MultiSelectLabels, MultiSelectOption, MultiSelectProps, NativeSelect, NativeSelectOption, NativeSelectProps, NavigationMenu, NavigationMenuItem, NavigationMenuProps, Notification, NotificationProps, NotificationVariant, NumberInput, NumberInputProps, OtpInput, OtpInputProps, OverflowMenu, OverflowMenuItem, OverflowMenuProps, Pagination, PaginationLabels, PaginationProps, PasswordInput, PasswordInputLabels, PasswordInputProps, Popover, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, PopoverTriggerProps, Portal, Progress, ProgressBar, ProgressBarProps, ProgressCircle, ProgressCircleProps, ProgressIndicator, ProgressIndicatorProps, ProgressProps, ProgressSize, ProgressStep, ProgressVariant, Prose, ProseProps, QrCode, QrCodeProps, RadialProgress, RadialProgressProps, RadialProgressSize, RadialProgressVariant, Radio, RadioCard, RadioCardGroup, RadioCardGroupProps, RadioCardProps, RadioGroup, RadioGroupProps, RadioProps, RatingGroup, RatingGroupLabels, RatingGroupProps, RelativeTime, RelativeTimeProps, Resizable, ResizableProps, ScrollArea, ScrollAreaProps, Search, SearchProps, SegmentedControl, SegmentedControlOption, SegmentedControlProps, Select, SelectOption, SelectProps, Separator, SeparatorProps, Sheet, SheetProps, ShellHeader, ShellHeaderAction, ShellHeaderBrand, ShellHeaderLabels, ShellHeaderNavItem, ShellHeaderNavLink, ShellHeaderNavMenu, ShellHeaderNavMenuItem, ShellHeaderProps, SideNav, SideNavGroup, SideNavItem, SideNavProps, SideNavSubItem, Skeleton, SkeletonProps, SkipNavLink, SkipNavLinkProps, SkipNavTarget, SkipNavTargetProps, Slider, SliderProps, SortDirection, SortState, Spinner, SpinnerProps, Stack, StackProps, type StandardSchemaV1, Stat, StatProps, Status, StatusProps, Step, StepState, Steps, StepsProps, StructuredList, StructuredListItem, StructuredListProps, SuspenseBoundary, Swap, SwapMode, SwapProps, Switcher, SwitcherEntry, SwitcherLink, SwitcherProps, Tabs, TabsContent, TabsContentProps, TabsList, TabsProps, TabsTrigger, TabsTriggerProps, Tag$1 as Tag, TagProps, TagsInput, TagsInputProps, Text, TextProps, Textarea, TextareaProps, Tile, TileProps, TimePicker, TimePickerProps, Timeline, TimelineItem, TimelineProps, ToastOptions, ToastProvider, ToastVariant, Toc, TocItem, TocProps, Toggle, ToggleGroup, ToggleGroupItem, ToggleGroupProps, ToggleProps, Toggletip, ToggletipPlacement, ToggletipProps, Tooltip, TooltipProps, TreeNode, TreeView, TreeViewProps, UploaderFile, type UsePopoverOptions, type UsePopoverReturn, type UseTocFromRegionOptions, User, UserProps, VisuallyHidden, VisuallyHiddenProps, createForm, dismissAllToasts, fuzzyScore, treeViewMessages, useForm, usePopover, useToast, useTocFromRegion };
+interface SwipeAction {
+  /** Accessible name and visible label. */
+  label: string;
+  icon?: ReactNode;
+  onSelect: () => void;
+  /** Render in the destructive (danger) style. */
+  destructive?: boolean;
+}
+interface SwipeItemProps {
+  /** The row content. */
+  children: ReactNode;
+  /** Actions revealed by dragging the row toward its end edge (shown on the start edge). */
+  leadingActions?: SwipeAction[];
+  /** Actions revealed by dragging the row toward its start edge (shown on the end edge). */
+  trailingActions?: SwipeAction[];
+  className?: string;
+}
+/**
+ * A list row whose leading/trailing actions are revealed by a horizontal drag, snapping
+ * open or closed on release (projected by fling velocity). The action buttons are always
+ * in the DOM and the a11y tree — never gesture-only — and focusing one (keyboard) reveals
+ * its side, so the row is fully operable without a pointer. Escape closes it. The drag is
+ * physical-axis (tuned for LTR); CSS translate only, no animation library.
+ */
+declare function SwipeItem({
+  children,
+  leadingActions,
+  trailingActions,
+  className
+}: SwipeItemProps): import("react").JSX.Element;
+export { Accordion, AccordionContent, AccordionItem, AccordionItemProps, AccordionProps, AccordionTrigger, ActionSheet, ActionSheetAction, ActionSheetProps, Alert, AlertDialog, AlertDialogLabels, AlertDialogProps, AlertProps, AppShell, AppShellProps, AspectRatio, AspectRatioProps, Avatar, AvatarGroup, AvatarGroupLabels, AvatarGroupProps, AvatarProps, Badge, BadgeProps, Blockquote, BlockquoteProps, BottomSheet, BottomSheetProps, Breadcrumb, BreadcrumbItem, BreadcrumbProps, Button, ButtonGroup, ButtonGroupProps, ButtonProps, Calendar, CalendarLabels, CalendarProps, Card, CardContent, CardContentProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, Carousel, CarouselLabels, CarouselProps, ChatBubble, ChatBubbleProps, ChatBubbleSide, Checkbox, CheckboxCard, CheckboxCardProps, CheckboxProps, Code, type CodeLang, CodeProps, CodeSnippet, CodeSnippetProps, Collapsible, CollapsibleProps, ColorPicker, ColorPickerLabels, ColorPickerProps, Column, Combobox, ComboboxLabels, ComboboxOption, ComboboxProps, CommandGroup, CommandItem, CommandMenu, CommandMenuProps, CommandPage, Comparison, ComparisonProps, ContainedList, ContainedListItem, ContainedListItemProps, ContainedListProps, ContextMenu, ContextMenuItem, ContextMenuItemProps, ContextMenuProps, CopyButton, CopyButtonProps, DataList, DataListItem, DataListProps, DataTable, DataTableLabels, DataTableProps, DatePicker, DatePickerLabels, DatePickerProps, DateRange, DateRangePicker, DateRangePickerLabels, DateRangePickerProps, DateRangePreset, Dock, DockItem, DockProps, Drawer, DrawerProps, Dropdown, DropdownItem, DropdownProps, Editable, EditableProps, EmptyState, EmptyStateProps, ErrorBoundary, Fab, FabAction, FabProps, Field, FieldProps, FileUploader, FileUploaderLabels, FileUploaderProps, Filter, FilterOption, FilterProps, FilterVariant, FocusScope, Form, FormConfig, FormProps, FormStore, Header, HeaderLabels, HeaderLink, HeaderPanel, HeaderPanelLabels, HeaderPanelProps, HeaderProps, Heading, HeadingLevel, HeadingProps, HeadingSize, HoverCard, HoverCardContent, HoverCardContentProps, HoverCardProps, HoverCardTrigger, HoverCardTriggerProps, IconButton, IconButtonProps, Image, ImageProps, Indicator, IndicatorPlacement, IndicatorProps, InlineLoading, InlineLoadingProps, InlineLoadingStatus, Input, InputGroup, InputGroupAddon, type InputGroupAddonProps, type InputGroupProps, InputProps, Item, ItemActions, ItemActionsProps, ItemContent, ItemContentProps, ItemDescription, ItemDescriptionProps, ItemMedia, ItemMediaProps, ItemProps, ItemTitle, ItemTitleProps, Join, JoinOrientation, JoinProps, Kbd, KbdProps, Label, LabelProps, Link, LinkProps, List, ListItem, ListItemProps, ListProps, Menu, MenuButton, MenuButtonItem, MenuButtonProps, MenuItem, MenuItemProps, MenuProps, MenuSeparator, MenuTrigger, MenuTriggerProps, Menubar, MenubarItem, MenubarMenu, MenubarProps, Modal, ModalProps, MultiSelect, MultiSelectLabels, MultiSelectOption, MultiSelectProps, NativeSelect, NativeSelectOption, NativeSelectProps, NavigationMenu, NavigationMenuItem, NavigationMenuProps, Notification, NotificationProps, NotificationVariant, NumberInput, NumberInputProps, OtpInput, OtpInputProps, OverflowMenu, OverflowMenuItem, OverflowMenuProps, Pagination, PaginationLabels, PaginationProps, PasswordInput, PasswordInputLabels, PasswordInputProps, Popover, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, PopoverTriggerProps, Portal, Progress, ProgressBar, ProgressBarProps, ProgressCircle, ProgressCircleProps, ProgressIndicator, ProgressIndicatorProps, ProgressProps, ProgressSize, ProgressStep, ProgressVariant, Prose, ProseProps, PullToRefresh, PullToRefreshProps, QrCode, QrCodeProps, RadialProgress, RadialProgressProps, RadialProgressSize, RadialProgressVariant, Radio, RadioCard, RadioCardGroup, RadioCardGroupProps, RadioCardProps, RadioGroup, RadioGroupProps, RadioProps, RatingGroup, RatingGroupLabels, RatingGroupProps, RelativeTime, RelativeTimeProps, Resizable, ResizableProps, ScrollArea, ScrollAreaProps, Search, SearchProps, SegmentedControl, SegmentedControlOption, SegmentedControlProps, Select, SelectOption, SelectProps, Separator, SeparatorProps, Sheet, SheetProps, ShellHeader, ShellHeaderAction, ShellHeaderBrand, ShellHeaderLabels, ShellHeaderNavItem, ShellHeaderNavLink, ShellHeaderNavMenu, ShellHeaderNavMenuItem, ShellHeaderProps, SideNav, SideNavGroup, SideNavItem, SideNavLinkSubItem, SideNavProps, SideNavSubItem, SideNavTone, Skeleton, SkeletonProps, SkipNavLink, SkipNavLinkProps, SkipNavTarget, SkipNavTargetProps, Slider, SliderProps, SortDirection, SortState, Spinner, SpinnerProps, Stack, StackProps, type StandardSchemaV1, Stat, StatProps, Status, StatusProps, Step, StepState, Steps, StepsProps, StructuredList, StructuredListItem, StructuredListProps, SuspenseBoundary, Swap, SwapMode, SwapProps, SwipeAction, SwipeItem, SwipeItemProps, Switcher, SwitcherEntry, SwitcherLink, SwitcherProps, Tabs, TabsContent, TabsContentProps, TabsList, TabsProps, TabsTrigger, TabsTriggerProps, Tag$1 as Tag, TagProps, TagsInput, TagsInputProps, Text, TextProps, Textarea, TextareaProps, Tile, TileProps, TimePicker, TimePickerProps, Timeline, TimelineItem, TimelineProps, ToastOptions, ToastProvider, ToastVariant, Toc, TocItem, TocProps, Toggle, ToggleGroup, ToggleGroupItem, ToggleGroupProps, ToggleProps, Toggletip, ToggletipPlacement, ToggletipProps, Tooltip, TooltipProps, TreeNode, TreeView, TreeViewProps, UploaderFile, type UsePopoverOptions, type UsePopoverReturn, type UseTocFromRegionOptions, User, UserProps, VisuallyHidden, VisuallyHiddenProps, createForm, dismissAllToasts, fuzzyScore, treeViewMessages, useForm, usePopover, useToast, useTocFromRegion };