barua-ui 0.4.2 → 0.5.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, ButtonHTMLAttributes, AnchorHTMLAttributes, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, HTMLAttributes, DialogHTMLAttributes, SVGProps, ElementType, TableHTMLAttributes, ImgHTMLAttributes } from 'react';
+import { ReactNode, ButtonHTMLAttributes, AnchorHTMLAttributes, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, HTMLAttributes, DialogHTMLAttributes, SVGProps, ElementType, TableHTMLAttributes, ImgHTMLAttributes, RefObject } from 'react';
 
 type BaruaTheme = "auto" | "light" | "dark";
 type BaruaAccent = "blue" | "indigo" | "purple" | "pink" | "teal" | "green";
@@ -1184,7 +1184,49 @@ interface ContextMenuTargetProps extends HTMLAttributes<HTMLElement> {
 /** Right-click, or long-press, opens the named menu at the pointer. */
 declare const ContextMenuTarget: react.ForwardRefExoticComponent<ContextMenuTargetProps & react.RefAttributes<HTMLElement>>;
 
+type ScrollGeometry = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    contentWidth: number;
+    contentHeight: number;
+    /** 0 at the start, 1 at the end; 0 when there is nothing to scroll. */
+    progressX: number;
+    progressY: number;
+};
+/**
+ * onScrollGeometryChange. Pass a ref to a scroll container, or nothing for
+ * the page. Reads are coalesced to one per frame.
+ */
+declare function useScrollGeometry(ref?: RefObject<HTMLElement | null>, onChange?: (geometry: ScrollGeometry) => void): ScrollGeometry | null;
+/** onScrollVisibilityChange: true once this much of the element is on screen. */
+declare function useVisible(ref: RefObject<Element | null>, { threshold }?: {
+    threshold?: number;
+}): boolean;
+type SnapPosition = {
+    /** The id of the child in view, or null when it has none. */
+    id: string | null;
+    index: number;
+    /** Scroll to a child by id or index. */
+    to: (target: string | number) => void;
+};
+/** scrollPosition(id:): which snap child a scrolling container is showing. */
+declare function useSnapPosition(ref: RefObject<HTMLElement | null>): SnapPosition;
+type HapticKind = "selection" | "impact" | "success" | "warning" | "error";
+/**
+ * sensoryFeedback. Android vibrates; iPhone Safari has no vibration API but
+ * plays the system haptic when a switch toggles, so one is toggled off
+ * screen. Returns false where nothing could be felt.
+ */
+declare function haptic(kind?: HapticKind): boolean;
+/**
+ * customizationID: state that survives a reload, under a key. Shares its
+ * storage with barua.js's data-b-persist, so the two can hand over.
+ */
+declare function usePersistedState<T>(key: string, initial: T): [T, (value: T | ((prev: T) => T)) => void];
+
 /** Join class names, skipping falsy values. */
 declare function cn(...parts: Array<string | false | null | undefined>): string;
 
-export { Accordion, Account, type AccountProps, AccountSwitcher, ActionSheet, type ActionSheetAction, Alert, AlertDialog, type AlertDialogAction, type AlertProps, AppGrid, AppTile, AreaChart, AsyncImage, type AsyncImageProps, Audio, Auth, AuthCard, type AuthCardProps, Avatar, AvatarGroup, type AvatarProps, Axis, type AxisProps, BackButton, Badge, type BadgeProps, Banner, type BannerProps, Bars, type BarsProps, type BaruaAccent, BaruaProvider, type BaruaProviderProps, type BaruaTheme, Bento, Billboard, BillboardActions, BillboardArt, BillboardBody, BillboardLede, BillboardScrim, BillboardTitle, type BlockProps, BottomNav, BottomNavItem, BottomSheet, Breadcrumbs, BulkActions, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, CalendarDay, type CalendarDayProps, CalendarGrid, CalendarHeader, CalendarMonth, CalendarView, CalendarViewCell, CalendarViewHead, CalendarWeekday, Callout, Card, CardBody, CardEyebrow, CardFooter, CardGrid, CardHeader, type CardProps, CardRail, CardSubtitle, CardTitle, Carousel, CarouselDots, CarouselSlide, CarouselTrack, Chapter, type ChapterProps, Chart, ChartTip, Checkbox, type CheckboxProps, Chip, type ChipProps, CircularProgress, type CircularProgressProps, CodeBlock, type CodeBlockProps, Columns, type ColumnsProps, Combobox, ComboboxEmpty, ComboboxList, ComboboxOption, type ComboboxOptionProps, CommandCenter, CommandCenterLabel, CommandCenterStatus, CommandCenterTile, CommandFooter, CommandGroupLabel, CommandInput, CommandItem, type CommandItemProps, CommandList, CommandPalette, type CommandPaletteProps, Container, type ContainerProps, ContextMenuTarget, type ContextMenuTargetProps, CountUp, type CountUpProps, type Crumb, Dashboard, DataGrid, DatePicker, DescriptionList, type DescriptionListProps, Disclosure, type DisclosureProps, Divider, type DividerProps, Dock, DockItem, DockTray, Donut, type DonutProps, type DonutSlice, DragHandle, Drawer, DrawerBody, DrawerHeader, type DrawerProps, Dropdown, type DropdownProps, Dropzone, type DropzoneProps, EmptyState, ErrorText, Event, type EventProps, Fab, type FabProps, FeatureRow, type FeatureRowProps, Feed, Field, type FieldProps, Fieldset, Figure, type FigureProps, FileBrowser, FileGrid, FileTile, type FileTileProps, FilterBar, FilterChip, type FilterChipProps, FitText, type FitTextProps, Footnote, Footnotes, Form, FormActions, FormRow, FormSection, type FormSectionProps, Gallery, Gantt, GanttBar, GanttRow, Gauge, type GaugeProps, GlassContainer, GlassInteractive, Grid, GridLines, type GridProps, GroupBox, Grow, HStack, Heatmap, Help, Hero, type HeroProps, HoverCard, HoverCardHost, Icon, type IconName, type IconProps, IconTile, type IconTileProps, ImageLens, ImageViewer, ImageViewerBar, Input, InputGroup, type InputGroupProps, type InputProps, Inspector, Kanban, KanbanColumn, type KanbanColumnProps, KanbanList, Kbd, Label, type LabelProps, Labeled, Landing, Legend, type LegendItem, type LegendProps, Lightbox, type LightboxProps, LineChart, LinearGauge, Link, LinkGroup, LiquidToggle, type LiquidToggleProps, List, ListFooter, ListHeader, ListItem, type ListItemProps, type ListProps, Log, MarketingNav, MarketingNavBrand, MarketingNavLinks, MediaPlaceholder, Menu, MenuBar, MenuBarItem, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, Modal, type ModalProps, type NavLinkProps, Notification, Onboarding, OnboardingFeature, type OnboardingFeatureProps, OnboardingHero, Optional, OtpInput, type OtpInputProps, Overline, Pagination, PaginationEllipsis, PaginationItem, type PaginationItemProps, type PaginationProps, PillNav, Popover, type PopoverProps, Poster, PosterFacts, PosterFrame, PosterGrid, PosterInitial, PosterMeta, PosterTitle, Progress, type ProgressProps, PromoBand, type PromoBandProps, Quote, type QuoteProps, RadarChart, Radio, Rail, RailItem, type RailProps, Range, type RangeProps, Resizable, ResizeHandle, Result, type ResultProps, Reveal, type RevealProps, type RevealVariant, SafeArea, ScatterChart, ScrollArea, type ScrollAreaProps, SearchField, SearchResult, type SearchResultProps, SearchResults, Section, Segmented, type SegmentedOption, Select, SelectionCount, Share, Sheet, Sidebar, SidebarGroup, SidebarHeading, SidebarItem, type SidebarItemProps, type SidebarProps, SiteFooter, SiteFooterGroup, SiteFooterGroups, SiteFooterHeading, SiteFooterLegal, Skeleton, SkipLink, Slider, SortControl, Spacer, Span, type SpanProps, Sparkline, type SparklineProps, SpecStrip, Spinner, Split, SplitButton, type SplitButtonProps, Stack, type StackProps, Stage, Stat, StatusBar, StatusBarItem, StatusDot, type Step, StepperInput, type StepperInputProps, Steps, type StepsProps, StoryCard, Swatch, Swatches, Switch, type SwitchProps, SysPage, type SysPageProps, type TabItem, TabPanel, Table, TableNum, type TableProps, TableSortHeader, TableWrap, Tabs, Tag, Task, TaskList, type TaskProps, TaskRow, Text, type TextProps, type TextRole, Textarea, ThemeScript, Thumb, type ThumbProps, Timeline, type TimelineEntry, type TimelineProps, Tip, type ToastOptions, ToastProvider, type ToastVariant, ToggleButton, type ToggleButtonProps, Toolbar, Tooltip, TopNav, TopNavBrand, TopNavLink, TopNavLinks, Tree, TreeItem, type TreeItemProps, Upload, UploadItem, type UploadItemProps, UploadPreview, UploadPreviews, VStack, Video, Wall, Waveform, Web, Workspace, WorkspaceMain, block, buttonClasses, cn, iconNames, useBaruaTheme, useToast };
+export { Accordion, Account, type AccountProps, AccountSwitcher, ActionSheet, type ActionSheetAction, Alert, AlertDialog, type AlertDialogAction, type AlertProps, AppGrid, AppTile, AreaChart, AsyncImage, type AsyncImageProps, Audio, Auth, AuthCard, type AuthCardProps, Avatar, AvatarGroup, type AvatarProps, Axis, type AxisProps, BackButton, Badge, type BadgeProps, Banner, type BannerProps, Bars, type BarsProps, type BaruaAccent, BaruaProvider, type BaruaProviderProps, type BaruaTheme, Bento, Billboard, BillboardActions, BillboardArt, BillboardBody, BillboardLede, BillboardScrim, BillboardTitle, type BlockProps, BottomNav, BottomNavItem, BottomSheet, Breadcrumbs, BulkActions, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, CalendarDay, type CalendarDayProps, CalendarGrid, CalendarHeader, CalendarMonth, CalendarView, CalendarViewCell, CalendarViewHead, CalendarWeekday, Callout, Card, CardBody, CardEyebrow, CardFooter, CardGrid, CardHeader, type CardProps, CardRail, CardSubtitle, CardTitle, Carousel, CarouselDots, CarouselSlide, CarouselTrack, Chapter, type ChapterProps, Chart, ChartTip, Checkbox, type CheckboxProps, Chip, type ChipProps, CircularProgress, type CircularProgressProps, CodeBlock, type CodeBlockProps, Columns, type ColumnsProps, Combobox, ComboboxEmpty, ComboboxList, ComboboxOption, type ComboboxOptionProps, CommandCenter, CommandCenterLabel, CommandCenterStatus, CommandCenterTile, CommandFooter, CommandGroupLabel, CommandInput, CommandItem, type CommandItemProps, CommandList, CommandPalette, type CommandPaletteProps, Container, type ContainerProps, ContextMenuTarget, type ContextMenuTargetProps, CountUp, type CountUpProps, type Crumb, Dashboard, DataGrid, DatePicker, DescriptionList, type DescriptionListProps, Disclosure, type DisclosureProps, Divider, type DividerProps, Dock, DockItem, DockTray, Donut, type DonutProps, type DonutSlice, DragHandle, Drawer, DrawerBody, DrawerHeader, type DrawerProps, Dropdown, type DropdownProps, Dropzone, type DropzoneProps, EmptyState, ErrorText, Event, type EventProps, Fab, type FabProps, FeatureRow, type FeatureRowProps, Feed, Field, type FieldProps, Fieldset, Figure, type FigureProps, FileBrowser, FileGrid, FileTile, type FileTileProps, FilterBar, FilterChip, type FilterChipProps, FitText, type FitTextProps, Footnote, Footnotes, Form, FormActions, FormRow, FormSection, type FormSectionProps, Gallery, Gantt, GanttBar, GanttRow, Gauge, type GaugeProps, GlassContainer, GlassInteractive, Grid, GridLines, type GridProps, GroupBox, Grow, HStack, type HapticKind, Heatmap, Help, Hero, type HeroProps, HoverCard, HoverCardHost, Icon, type IconName, type IconProps, IconTile, type IconTileProps, ImageLens, ImageViewer, ImageViewerBar, Input, InputGroup, type InputGroupProps, type InputProps, Inspector, Kanban, KanbanColumn, type KanbanColumnProps, KanbanList, Kbd, Label, type LabelProps, Labeled, Landing, Legend, type LegendItem, type LegendProps, Lightbox, type LightboxProps, LineChart, LinearGauge, Link, LinkGroup, LiquidToggle, type LiquidToggleProps, List, ListFooter, ListHeader, ListItem, type ListItemProps, type ListProps, Log, MarketingNav, MarketingNavBrand, MarketingNavLinks, MediaPlaceholder, Menu, MenuBar, MenuBarItem, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, Modal, type ModalProps, type NavLinkProps, Notification, Onboarding, OnboardingFeature, type OnboardingFeatureProps, OnboardingHero, Optional, OtpInput, type OtpInputProps, Overline, Pagination, PaginationEllipsis, PaginationItem, type PaginationItemProps, type PaginationProps, PillNav, Popover, type PopoverProps, Poster, PosterFacts, PosterFrame, PosterGrid, PosterInitial, PosterMeta, PosterTitle, Progress, type ProgressProps, PromoBand, type PromoBandProps, Quote, type QuoteProps, RadarChart, Radio, Rail, RailItem, type RailProps, Range, type RangeProps, Resizable, ResizeHandle, Result, type ResultProps, Reveal, type RevealProps, type RevealVariant, SafeArea, ScatterChart, ScrollArea, type ScrollAreaProps, type ScrollGeometry, SearchField, SearchResult, type SearchResultProps, SearchResults, Section, Segmented, type SegmentedOption, Select, SelectionCount, Share, Sheet, Sidebar, SidebarGroup, SidebarHeading, SidebarItem, type SidebarItemProps, type SidebarProps, SiteFooter, SiteFooterGroup, SiteFooterGroups, SiteFooterHeading, SiteFooterLegal, Skeleton, SkipLink, Slider, type SnapPosition, SortControl, Spacer, Span, type SpanProps, Sparkline, type SparklineProps, SpecStrip, Spinner, Split, SplitButton, type SplitButtonProps, Stack, type StackProps, Stage, Stat, StatusBar, StatusBarItem, StatusDot, type Step, StepperInput, type StepperInputProps, Steps, type StepsProps, StoryCard, Swatch, Swatches, Switch, type SwitchProps, SysPage, type SysPageProps, type TabItem, TabPanel, Table, TableNum, type TableProps, TableSortHeader, TableWrap, Tabs, Tag, Task, TaskList, type TaskProps, TaskRow, Text, type TextProps, type TextRole, Textarea, ThemeScript, Thumb, type ThumbProps, Timeline, type TimelineEntry, type TimelineProps, Tip, type ToastOptions, ToastProvider, type ToastVariant, ToggleButton, type ToggleButtonProps, Toolbar, Tooltip, TopNav, TopNavBrand, TopNavLink, TopNavLinks, Tree, TreeItem, type TreeItemProps, Upload, UploadItem, type UploadItemProps, UploadPreview, UploadPreviews, VStack, Video, Wall, Waveform, Web, Workspace, WorkspaceMain, block, buttonClasses, cn, haptic, iconNames, useBaruaTheme, usePersistedState, useScrollGeometry, useSnapPosition, useToast, useVisible };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, ButtonHTMLAttributes, AnchorHTMLAttributes, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, HTMLAttributes, DialogHTMLAttributes, SVGProps, ElementType, TableHTMLAttributes, ImgHTMLAttributes } from 'react';
+import { ReactNode, ButtonHTMLAttributes, AnchorHTMLAttributes, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, HTMLAttributes, DialogHTMLAttributes, SVGProps, ElementType, TableHTMLAttributes, ImgHTMLAttributes, RefObject } from 'react';
 
 type BaruaTheme = "auto" | "light" | "dark";
 type BaruaAccent = "blue" | "indigo" | "purple" | "pink" | "teal" | "green";
@@ -1184,7 +1184,49 @@ interface ContextMenuTargetProps extends HTMLAttributes<HTMLElement> {
 /** Right-click, or long-press, opens the named menu at the pointer. */
 declare const ContextMenuTarget: react.ForwardRefExoticComponent<ContextMenuTargetProps & react.RefAttributes<HTMLElement>>;
 
+type ScrollGeometry = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    contentWidth: number;
+    contentHeight: number;
+    /** 0 at the start, 1 at the end; 0 when there is nothing to scroll. */
+    progressX: number;
+    progressY: number;
+};
+/**
+ * onScrollGeometryChange. Pass a ref to a scroll container, or nothing for
+ * the page. Reads are coalesced to one per frame.
+ */
+declare function useScrollGeometry(ref?: RefObject<HTMLElement | null>, onChange?: (geometry: ScrollGeometry) => void): ScrollGeometry | null;
+/** onScrollVisibilityChange: true once this much of the element is on screen. */
+declare function useVisible(ref: RefObject<Element | null>, { threshold }?: {
+    threshold?: number;
+}): boolean;
+type SnapPosition = {
+    /** The id of the child in view, or null when it has none. */
+    id: string | null;
+    index: number;
+    /** Scroll to a child by id or index. */
+    to: (target: string | number) => void;
+};
+/** scrollPosition(id:): which snap child a scrolling container is showing. */
+declare function useSnapPosition(ref: RefObject<HTMLElement | null>): SnapPosition;
+type HapticKind = "selection" | "impact" | "success" | "warning" | "error";
+/**
+ * sensoryFeedback. Android vibrates; iPhone Safari has no vibration API but
+ * plays the system haptic when a switch toggles, so one is toggled off
+ * screen. Returns false where nothing could be felt.
+ */
+declare function haptic(kind?: HapticKind): boolean;
+/**
+ * customizationID: state that survives a reload, under a key. Shares its
+ * storage with barua.js's data-b-persist, so the two can hand over.
+ */
+declare function usePersistedState<T>(key: string, initial: T): [T, (value: T | ((prev: T) => T)) => void];
+
 /** Join class names, skipping falsy values. */
 declare function cn(...parts: Array<string | false | null | undefined>): string;
 
-export { Accordion, Account, type AccountProps, AccountSwitcher, ActionSheet, type ActionSheetAction, Alert, AlertDialog, type AlertDialogAction, type AlertProps, AppGrid, AppTile, AreaChart, AsyncImage, type AsyncImageProps, Audio, Auth, AuthCard, type AuthCardProps, Avatar, AvatarGroup, type AvatarProps, Axis, type AxisProps, BackButton, Badge, type BadgeProps, Banner, type BannerProps, Bars, type BarsProps, type BaruaAccent, BaruaProvider, type BaruaProviderProps, type BaruaTheme, Bento, Billboard, BillboardActions, BillboardArt, BillboardBody, BillboardLede, BillboardScrim, BillboardTitle, type BlockProps, BottomNav, BottomNavItem, BottomSheet, Breadcrumbs, BulkActions, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, CalendarDay, type CalendarDayProps, CalendarGrid, CalendarHeader, CalendarMonth, CalendarView, CalendarViewCell, CalendarViewHead, CalendarWeekday, Callout, Card, CardBody, CardEyebrow, CardFooter, CardGrid, CardHeader, type CardProps, CardRail, CardSubtitle, CardTitle, Carousel, CarouselDots, CarouselSlide, CarouselTrack, Chapter, type ChapterProps, Chart, ChartTip, Checkbox, type CheckboxProps, Chip, type ChipProps, CircularProgress, type CircularProgressProps, CodeBlock, type CodeBlockProps, Columns, type ColumnsProps, Combobox, ComboboxEmpty, ComboboxList, ComboboxOption, type ComboboxOptionProps, CommandCenter, CommandCenterLabel, CommandCenterStatus, CommandCenterTile, CommandFooter, CommandGroupLabel, CommandInput, CommandItem, type CommandItemProps, CommandList, CommandPalette, type CommandPaletteProps, Container, type ContainerProps, ContextMenuTarget, type ContextMenuTargetProps, CountUp, type CountUpProps, type Crumb, Dashboard, DataGrid, DatePicker, DescriptionList, type DescriptionListProps, Disclosure, type DisclosureProps, Divider, type DividerProps, Dock, DockItem, DockTray, Donut, type DonutProps, type DonutSlice, DragHandle, Drawer, DrawerBody, DrawerHeader, type DrawerProps, Dropdown, type DropdownProps, Dropzone, type DropzoneProps, EmptyState, ErrorText, Event, type EventProps, Fab, type FabProps, FeatureRow, type FeatureRowProps, Feed, Field, type FieldProps, Fieldset, Figure, type FigureProps, FileBrowser, FileGrid, FileTile, type FileTileProps, FilterBar, FilterChip, type FilterChipProps, FitText, type FitTextProps, Footnote, Footnotes, Form, FormActions, FormRow, FormSection, type FormSectionProps, Gallery, Gantt, GanttBar, GanttRow, Gauge, type GaugeProps, GlassContainer, GlassInteractive, Grid, GridLines, type GridProps, GroupBox, Grow, HStack, Heatmap, Help, Hero, type HeroProps, HoverCard, HoverCardHost, Icon, type IconName, type IconProps, IconTile, type IconTileProps, ImageLens, ImageViewer, ImageViewerBar, Input, InputGroup, type InputGroupProps, type InputProps, Inspector, Kanban, KanbanColumn, type KanbanColumnProps, KanbanList, Kbd, Label, type LabelProps, Labeled, Landing, Legend, type LegendItem, type LegendProps, Lightbox, type LightboxProps, LineChart, LinearGauge, Link, LinkGroup, LiquidToggle, type LiquidToggleProps, List, ListFooter, ListHeader, ListItem, type ListItemProps, type ListProps, Log, MarketingNav, MarketingNavBrand, MarketingNavLinks, MediaPlaceholder, Menu, MenuBar, MenuBarItem, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, Modal, type ModalProps, type NavLinkProps, Notification, Onboarding, OnboardingFeature, type OnboardingFeatureProps, OnboardingHero, Optional, OtpInput, type OtpInputProps, Overline, Pagination, PaginationEllipsis, PaginationItem, type PaginationItemProps, type PaginationProps, PillNav, Popover, type PopoverProps, Poster, PosterFacts, PosterFrame, PosterGrid, PosterInitial, PosterMeta, PosterTitle, Progress, type ProgressProps, PromoBand, type PromoBandProps, Quote, type QuoteProps, RadarChart, Radio, Rail, RailItem, type RailProps, Range, type RangeProps, Resizable, ResizeHandle, Result, type ResultProps, Reveal, type RevealProps, type RevealVariant, SafeArea, ScatterChart, ScrollArea, type ScrollAreaProps, SearchField, SearchResult, type SearchResultProps, SearchResults, Section, Segmented, type SegmentedOption, Select, SelectionCount, Share, Sheet, Sidebar, SidebarGroup, SidebarHeading, SidebarItem, type SidebarItemProps, type SidebarProps, SiteFooter, SiteFooterGroup, SiteFooterGroups, SiteFooterHeading, SiteFooterLegal, Skeleton, SkipLink, Slider, SortControl, Spacer, Span, type SpanProps, Sparkline, type SparklineProps, SpecStrip, Spinner, Split, SplitButton, type SplitButtonProps, Stack, type StackProps, Stage, Stat, StatusBar, StatusBarItem, StatusDot, type Step, StepperInput, type StepperInputProps, Steps, type StepsProps, StoryCard, Swatch, Swatches, Switch, type SwitchProps, SysPage, type SysPageProps, type TabItem, TabPanel, Table, TableNum, type TableProps, TableSortHeader, TableWrap, Tabs, Tag, Task, TaskList, type TaskProps, TaskRow, Text, type TextProps, type TextRole, Textarea, ThemeScript, Thumb, type ThumbProps, Timeline, type TimelineEntry, type TimelineProps, Tip, type ToastOptions, ToastProvider, type ToastVariant, ToggleButton, type ToggleButtonProps, Toolbar, Tooltip, TopNav, TopNavBrand, TopNavLink, TopNavLinks, Tree, TreeItem, type TreeItemProps, Upload, UploadItem, type UploadItemProps, UploadPreview, UploadPreviews, VStack, Video, Wall, Waveform, Web, Workspace, WorkspaceMain, block, buttonClasses, cn, iconNames, useBaruaTheme, useToast };
+export { Accordion, Account, type AccountProps, AccountSwitcher, ActionSheet, type ActionSheetAction, Alert, AlertDialog, type AlertDialogAction, type AlertProps, AppGrid, AppTile, AreaChart, AsyncImage, type AsyncImageProps, Audio, Auth, AuthCard, type AuthCardProps, Avatar, AvatarGroup, type AvatarProps, Axis, type AxisProps, BackButton, Badge, type BadgeProps, Banner, type BannerProps, Bars, type BarsProps, type BaruaAccent, BaruaProvider, type BaruaProviderProps, type BaruaTheme, Bento, Billboard, BillboardActions, BillboardArt, BillboardBody, BillboardLede, BillboardScrim, BillboardTitle, type BlockProps, BottomNav, BottomNavItem, BottomSheet, Breadcrumbs, BulkActions, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, CalendarDay, type CalendarDayProps, CalendarGrid, CalendarHeader, CalendarMonth, CalendarView, CalendarViewCell, CalendarViewHead, CalendarWeekday, Callout, Card, CardBody, CardEyebrow, CardFooter, CardGrid, CardHeader, type CardProps, CardRail, CardSubtitle, CardTitle, Carousel, CarouselDots, CarouselSlide, CarouselTrack, Chapter, type ChapterProps, Chart, ChartTip, Checkbox, type CheckboxProps, Chip, type ChipProps, CircularProgress, type CircularProgressProps, CodeBlock, type CodeBlockProps, Columns, type ColumnsProps, Combobox, ComboboxEmpty, ComboboxList, ComboboxOption, type ComboboxOptionProps, CommandCenter, CommandCenterLabel, CommandCenterStatus, CommandCenterTile, CommandFooter, CommandGroupLabel, CommandInput, CommandItem, type CommandItemProps, CommandList, CommandPalette, type CommandPaletteProps, Container, type ContainerProps, ContextMenuTarget, type ContextMenuTargetProps, CountUp, type CountUpProps, type Crumb, Dashboard, DataGrid, DatePicker, DescriptionList, type DescriptionListProps, Disclosure, type DisclosureProps, Divider, type DividerProps, Dock, DockItem, DockTray, Donut, type DonutProps, type DonutSlice, DragHandle, Drawer, DrawerBody, DrawerHeader, type DrawerProps, Dropdown, type DropdownProps, Dropzone, type DropzoneProps, EmptyState, ErrorText, Event, type EventProps, Fab, type FabProps, FeatureRow, type FeatureRowProps, Feed, Field, type FieldProps, Fieldset, Figure, type FigureProps, FileBrowser, FileGrid, FileTile, type FileTileProps, FilterBar, FilterChip, type FilterChipProps, FitText, type FitTextProps, Footnote, Footnotes, Form, FormActions, FormRow, FormSection, type FormSectionProps, Gallery, Gantt, GanttBar, GanttRow, Gauge, type GaugeProps, GlassContainer, GlassInteractive, Grid, GridLines, type GridProps, GroupBox, Grow, HStack, type HapticKind, Heatmap, Help, Hero, type HeroProps, HoverCard, HoverCardHost, Icon, type IconName, type IconProps, IconTile, type IconTileProps, ImageLens, ImageViewer, ImageViewerBar, Input, InputGroup, type InputGroupProps, type InputProps, Inspector, Kanban, KanbanColumn, type KanbanColumnProps, KanbanList, Kbd, Label, type LabelProps, Labeled, Landing, Legend, type LegendItem, type LegendProps, Lightbox, type LightboxProps, LineChart, LinearGauge, Link, LinkGroup, LiquidToggle, type LiquidToggleProps, List, ListFooter, ListHeader, ListItem, type ListItemProps, type ListProps, Log, MarketingNav, MarketingNavBrand, MarketingNavLinks, MediaPlaceholder, Menu, MenuBar, MenuBarItem, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, Modal, type ModalProps, type NavLinkProps, Notification, Onboarding, OnboardingFeature, type OnboardingFeatureProps, OnboardingHero, Optional, OtpInput, type OtpInputProps, Overline, Pagination, PaginationEllipsis, PaginationItem, type PaginationItemProps, type PaginationProps, PillNav, Popover, type PopoverProps, Poster, PosterFacts, PosterFrame, PosterGrid, PosterInitial, PosterMeta, PosterTitle, Progress, type ProgressProps, PromoBand, type PromoBandProps, Quote, type QuoteProps, RadarChart, Radio, Rail, RailItem, type RailProps, Range, type RangeProps, Resizable, ResizeHandle, Result, type ResultProps, Reveal, type RevealProps, type RevealVariant, SafeArea, ScatterChart, ScrollArea, type ScrollAreaProps, type ScrollGeometry, SearchField, SearchResult, type SearchResultProps, SearchResults, Section, Segmented, type SegmentedOption, Select, SelectionCount, Share, Sheet, Sidebar, SidebarGroup, SidebarHeading, SidebarItem, type SidebarItemProps, type SidebarProps, SiteFooter, SiteFooterGroup, SiteFooterGroups, SiteFooterHeading, SiteFooterLegal, Skeleton, SkipLink, Slider, type SnapPosition, SortControl, Spacer, Span, type SpanProps, Sparkline, type SparklineProps, SpecStrip, Spinner, Split, SplitButton, type SplitButtonProps, Stack, type StackProps, Stage, Stat, StatusBar, StatusBarItem, StatusDot, type Step, StepperInput, type StepperInputProps, Steps, type StepsProps, StoryCard, Swatch, Swatches, Switch, type SwitchProps, SysPage, type SysPageProps, type TabItem, TabPanel, Table, TableNum, type TableProps, TableSortHeader, TableWrap, Tabs, Tag, Task, TaskList, type TaskProps, TaskRow, Text, type TextProps, type TextRole, Textarea, ThemeScript, Thumb, type ThumbProps, Timeline, type TimelineEntry, type TimelineProps, Tip, type ToastOptions, ToastProvider, type ToastVariant, ToggleButton, type ToggleButtonProps, Toolbar, Tooltip, TopNav, TopNavBrand, TopNavLink, TopNavLinks, Tree, TreeItem, type TreeItemProps, Upload, UploadItem, type UploadItemProps, UploadPreview, UploadPreviews, VStack, Video, Wall, Waveform, Web, Workspace, WorkspaceMain, block, buttonClasses, cn, haptic, iconNames, useBaruaTheme, usePersistedState, useScrollGeometry, useSnapPosition, useToast, useVisible };

package/dist/index.js

@@ -2312,6 +2312,194 @@ var ContextMenuTarget = forwardRef17(
     return /* @__PURE__ */ jsx21(Component, { ref, "data-b-contextmenu": menu, ...rest, children });
   }
 );
+
+// src/scroll.tsx
+import { useCallback as useCallback2, useEffect as useEffect5, useState as useState3 } from "react";
+function readGeometry(el) {
+  const page = !el || el === document.documentElement || el === document.body;
+  const box = page ? document.documentElement : el;
+  const x = page ? window.scrollX : el.scrollLeft;
+  const y = page ? window.scrollY : el.scrollTop;
+  const width = box.clientWidth, height = box.clientHeight;
+  const contentWidth = box.scrollWidth, contentHeight = box.scrollHeight;
+  return {
+    x,
+    y,
+    width,
+    height,
+    contentWidth,
+    contentHeight,
+    progressX: contentWidth > width ? Math.min(1, x / (contentWidth - width)) : 0,
+    progressY: contentHeight > height ? Math.min(1, y / (contentHeight - height)) : 0
+  };
+}
+function useScrollGeometry(ref, onChange) {
+  const [geometry, setGeometry] = useState3(null);
+  useEffect5(() => {
+    const el = ref?.current ?? null;
+    const page = !el || el === document.documentElement || el === document.body;
+    const target = page ? window : el;
+    let queued = false;
+    const flush = () => {
+      queued = false;
+      const g = readGeometry(el);
+      setGeometry(g);
+      onChange?.(g);
+    };
+    const on = () => {
+      if (!queued) {
+        queued = true;
+        requestAnimationFrame(flush);
+      }
+    };
+    target.addEventListener("scroll", on, { passive: true });
+    const ro = !page && "ResizeObserver" in window ? new ResizeObserver(on) : null;
+    if (ro && el) ro.observe(el);
+    else window.addEventListener("resize", on);
+    flush();
+    return () => {
+      target.removeEventListener("scroll", on);
+      if (ro) ro.disconnect();
+      else window.removeEventListener("resize", on);
+    };
+  }, [ref?.current]);
+  return geometry;
+}
+function useVisible(ref, { threshold = 0.5 } = {}) {
+  const [visible, setVisible] = useState3(false);
+  useEffect5(() => {
+    const el = ref.current;
+    if (!el) return;
+    if (!("IntersectionObserver" in window)) {
+      setVisible(true);
+      return;
+    }
+    const io = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          setVisible(threshold === 0 ? entry.isIntersecting : entry.intersectionRatio >= threshold);
+        }
+      },
+      { threshold: threshold === 0 ? [0] : [0, threshold] }
+    );
+    io.observe(el);
+    return () => io.disconnect();
+  }, [ref.current, threshold]);
+  return visible;
+}
+function useSnapPosition(ref) {
+  const [current, setCurrent] = useState3({ id: null, index: -1 });
+  const items = useCallback2(() => ref.current ? Array.from(ref.current.children).filter((c) => !c.hidden) : [], [ref]);
+  useEffect5(() => {
+    const box = ref.current;
+    if (!box) return;
+    const announce = (el) => {
+      if (!el) return;
+      const list = items();
+      const index = list.indexOf(el);
+      if (index >= 0) setCurrent({ id: el.id || null, index });
+    };
+    const nearest = () => {
+      const list = items();
+      const horizontal = box.scrollWidth > box.clientWidth;
+      const origin = box.getBoundingClientRect();
+      let best = null, distance = Infinity;
+      for (const c of list) {
+        const r = c.getBoundingClientRect();
+        const d = Math.abs(horizontal ? r.left - origin.left : r.top - origin.top);
+        if (d < distance) {
+          distance = d;
+          best = c;
+        }
+      }
+      return best;
+    };
+    let timer;
+    const native = "onscrollsnapchange" in box;
+    const onSnap = (e) => {
+      const ev = e;
+      announce(ev.snapTargetInline || ev.snapTargetBlock);
+    };
+    const settle = () => {
+      clearTimeout(timer);
+      timer = setTimeout(() => announce(nearest()), 90);
+    };
+    if (native) box.addEventListener("scrollsnapchange", onSnap);
+    else box.addEventListener("onscrollend" in box ? "scrollend" : "scroll", settle, { passive: true });
+    announce(nearest());
+    return () => {
+      box.removeEventListener("scrollsnapchange", onSnap);
+      box.removeEventListener("scrollend", settle);
+      box.removeEventListener("scroll", settle);
+      clearTimeout(timer);
+    };
+  }, [ref.current]);
+  const to = useCallback2(
+    (target) => {
+      const list = items();
+      const el = typeof target === "number" ? list[target] : list.find((c) => c.id === target);
+      el?.scrollIntoView({ behavior: "smooth", block: "nearest", inline: "start" });
+    },
+    [items]
+  );
+  return { ...current, to };
+}
+var HAPTICS = {
+  selection: [8],
+  impact: [16],
+  success: [10, 30, 20],
+  warning: [25, 40, 25],
+  error: [40, 30, 40, 30, 60]
+};
+function haptic(kind = "selection") {
+  if (typeof navigator === "undefined") return false;
+  if (typeof navigator.vibrate === "function") {
+    navigator.vibrate(HAPTICS[kind]);
+    return true;
+  }
+  if (/iphone|ipad|ipod/i.test(navigator.userAgent)) {
+    let sw = document.getElementById("b-haptic-switch");
+    if (!sw) {
+      sw = document.createElement("input");
+      sw.type = "checkbox";
+      sw.id = "b-haptic-switch";
+      sw.tabIndex = -1;
+      sw.setAttribute("switch", "");
+      sw.setAttribute("aria-hidden", "true");
+      sw.style.cssText = "position:fixed;inset:auto auto 0 0;width:1px;height:1px;opacity:0;pointer-events:none";
+      document.body.appendChild(sw);
+    }
+    sw.click();
+    return true;
+  }
+  return false;
+}
+var PERSIST = "barua-persist:";
+function usePersistedState(key, initial) {
+  const [value, setValue] = useState3(() => {
+    if (typeof window === "undefined") return initial;
+    try {
+      const raw = localStorage.getItem(PERSIST + key);
+      return raw === null ? initial : JSON.parse(raw);
+    } catch {
+      return initial;
+    }
+  });
+  const set = useCallback2(
+    (next) => {
+      setValue((prev) => {
+        const resolved = typeof next === "function" ? next(prev) : next;
+        try {
+          localStorage.setItem(PERSIST + key, JSON.stringify(resolved));
+        } catch {
+        }
+        return resolved;
+      });
+    },
+    [key]
+  );
+  return [value, set];
+}
 export {
   Accordion,
   Account,
@@ -2606,8 +2794,13 @@ export {
   block,
   buttonClasses,
   cn,
+  haptic,
   iconNames,
   useBaruaTheme,
-  useToast
+  usePersistedState,
+  useScrollGeometry,
+  useSnapPosition,
+  useToast,
+  useVisible
 };
 //# sourceMappingURL=index.js.map