@webority/mobile-ui 0.9.1 → 0.10.0

package/lib/typescript/commonjs/components/Toast/ToastProvider.d.ts

@@ -1,8 +1,28 @@
 import type React from 'react';
 import type { HapticType } from '../../utils/hapticUtils';
 import type { ToastOptions, ToastPosition, ToastVariant } from './Toast';
+export interface ToastUndoOptions extends Omit<ToastOptions, 'message' | 'variant' | 'action' | 'countdown' | 'duration'> {
+    /** Runs when Undo is pressed. The toast closes and `onCommit` never runs. */
+    onUndo: () => void;
+    /**
+     * Runs once when the toast ends any other way: it times out, is swiped away,
+     * is hidden, is pushed out by newer toasts, is replaced by a toast with the
+     * same `key`, or the provider unmounts. Do the irreversible part here.
+     */
+    onCommit?: () => void;
+    /** Label of the action button. Default `Undo`. */
+    undoLabel?: string;
+    /**
+     * How long Undo stays, in ms. Default `6000`, never shorter than `6000`; `0`
+     * keeps it until dismissed. With a screen reader on the toast waits to be
+     * dismissed whatever this is, so keep the item recoverable some other way.
+     */
+    duration?: number;
+}
 export interface ToastApi {
     show: (opts: ToastOptions) => string;
+    /** A toast with an Undo action and a countdown bar; see `ToastUndoOptions`. */
+    undo: (message: string, opts: ToastUndoOptions) => string;
     hide: (id: string) => void;
     hideAll: () => void;
 }
@@ -38,6 +58,7 @@ export declare const ToastHost: React.FC;
 export declare const useToast: () => ToastApi;
 interface ToastGlobal {
     show: (opts: ToastOptions) => string;
+    undo: (message: string, opts: ToastUndoOptions) => string;
     success: (message: string, opts?: Omit<ToastOptions, 'message' | 'variant'>) => string;
     error: (message: string, opts?: Omit<ToastOptions, 'message' | 'variant'>) => string;
     warning: (message: string, opts?: Omit<ToastOptions, 'message' | 'variant'>) => string;

package/lib/typescript/commonjs/components/Toast/index.d.ts

@@ -1,5 +1,5 @@
 export type { ToastAction, ToastItem, ToastOptions, ToastPosition, ToastProps, ToastVariant } from './Toast';
 export { default, Toast } from './Toast';
-export type { ToastApi, ToastHaptics, ToastProviderProps } from './ToastProvider';
+export type { ToastApi, ToastHaptics, ToastProviderProps, ToastUndoOptions } from './ToastProvider';
 export { ToastHost, ToastProvider, toast, useToast } from './ToastProvider';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/Tooltip/RichTooltipBody.d.ts

@@ -0,0 +1,27 @@
+import type React from 'react';
+import type { Text as RNText, View as RNView, StyleProp, TextStyle } from 'react-native';
+/** The one text button of a rich tooltip. */
+export interface TooltipAction {
+    label: string;
+    onPress: () => void;
+    accessibilityLabel?: string;
+}
+interface RichTooltipBodyProps {
+    title?: string;
+    content: string | React.ReactNode;
+    action?: TooltipAction;
+    onAction: () => void;
+    /** Takes screen reader focus on open: the title, or the text when there is none. */
+    focusRef: React.Ref<RNText>;
+    /** Takes keyboard focus on open on the web. */
+    actionRef: React.Ref<RNView>;
+    messageStyle?: StyleProp<TextStyle>;
+}
+/**
+ * The card of `variant="rich"`: a light surface with a title, the content and
+ * one action. Not a child of the close area, so every part is reachable by a
+ * screen reader on its own.
+ */
+export declare const RichTooltipBody: React.FC<RichTooltipBodyProps>;
+export {};
+//# sourceMappingURL=RichTooltipBody.d.ts.map

package/lib/typescript/commonjs/components/Tooltip/Tooltip.d.ts

@@ -1,11 +1,33 @@
 import React from 'react';
 import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { TooltipAction } from './RichTooltipBody';
+export type { TooltipAction } from './RichTooltipBody';
 export type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right' | 'auto';
 export type TooltipTrigger = 'longPress' | 'press' | 'manual';
+/**
+ * `plain` is a short dark hint. `rich` is a light card with a `title`, the
+ * `content` and one `action`, the Material rich tooltip: it opens on press by
+ * default, stays until a tap outside, Back, Escape or its action, moves
+ * screen reader focus into itself and back to the trigger on close, and sits
+ * only above or below its trigger. Anything with inputs, a list or more than
+ * one action belongs in a BottomSheet.
+ */
+export type TooltipVariant = 'plain' | 'rich';
 export interface TooltipProps {
     content: string | React.ReactNode;
     children: React.ReactElement;
+    /** Default `'plain'`. */
+    variant?: TooltipVariant;
+    /** Rich only: one line over the content. */
+    title?: string;
+    /** Rich only: one text button. It runs after the tooltip has closed. */
+    action?: TooltipAction;
+    /** `left` and `right` read as `auto` on a rich tooltip. */
     placement?: TooltipPlacement;
+    /**
+     * Default `'longPress'`, or `'press'` for a rich tooltip. A long press is
+     * never attached to a child with its own `contextMenu`: the menu wins.
+     */
     trigger?: TooltipTrigger;
     visible?: boolean;
     onVisibleChange?: (visible: boolean) => void;
@@ -20,6 +42,8 @@ export interface TooltipProps {
     arrowStyle?: StyleProp<ViewStyle>;
     /** Style override applied to the message Text (only when `content` is a string). */
     messageStyle?: StyleProp<TextStyle>;
+    /** Accessible name of the tap-outside area. Default `'Close tooltip'`. */
+    closeLabel?: string;
     testID?: string;
 }
 declare const Tooltip: React.FC<TooltipProps>;

package/lib/typescript/commonjs/components/Tooltip/index.d.ts

@@ -1,3 +1,3 @@
-export type { TooltipPlacement, TooltipProps, TooltipTrigger } from './Tooltip';
+export type { TooltipAction, TooltipPlacement, TooltipProps, TooltipTrigger, TooltipVariant } from './Tooltip';
 export { default, Tooltip } from './Tooltip';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/Tooltip/tooltipPosition.d.ts

@@ -0,0 +1,35 @@
+import type { LayoutRectangle } from 'react-native';
+import type { PlacementViewport } from '../../utils/placement';
+export type TooltipSide = 'top' | 'bottom' | 'left' | 'right';
+export interface TooltipPosition {
+    top: number;
+    left: number;
+    placement: TooltipSide;
+    /** Distance of the arrow tip along the edge that faces the trigger. */
+    arrowOffset: number;
+}
+export interface TooltipLayout {
+    /** The trigger in window coordinates; null until measured. */
+    anchor: LayoutRectangle | null;
+    /** The bubble's measured size; zeros until its first layout. */
+    size: {
+        width: number;
+        height: number;
+    };
+    placement: TooltipSide | 'auto';
+    /** A rich tooltip only goes above or below its trigger. */
+    rich: boolean;
+    viewport: PlacementViewport;
+    maxWidth: number;
+    gap: number;
+    /** Least distance from each safe edge. */
+    padding: number;
+    arrowCornerPadding: number;
+}
+/**
+ * Where a tooltip bubble sits. Above and below go through the shared
+ * placement engine (the one Menu uses), so both flip and clamp alike; left
+ * and right stay a tooltip's own.
+ */
+export declare const resolveTooltipPosition: (layout: TooltipLayout) => TooltipPosition;
+//# sourceMappingURL=tooltipPosition.d.ts.map

package/lib/typescript/commonjs/components/TypingIndicator/TypingIndicator.d.ts

@@ -0,0 +1,21 @@
+import type React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export interface TypingIndicatorProps {
+    /** Shown beside the dots and read by screen readers, e.g. "Shannon is typing". */
+    label?: string;
+    /** Screen-reader name when there is no visible `label`. Default 'Typing'. */
+    accessibilityLabel?: string;
+    /** Draw the dots inside a `theirs` bubble. Default true. */
+    bubble?: boolean;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+/**
+ * Three pulsing dots, with an optional line such as "Shannon is typing", for
+ * the bottom of a `MessageList` (its `typing` slot). The pulse runs on the UI
+ * thread and stops under Reduce Motion. It is not announced: a person hears
+ * the reply when it arrives.
+ */
+export declare const TypingIndicator: React.FC<TypingIndicatorProps>;
+export default TypingIndicator;
+//# sourceMappingURL=TypingIndicator.d.ts.map

package/lib/typescript/commonjs/components/TypingIndicator/index.d.ts

@@ -0,0 +1,3 @@
+export type { TypingIndicatorProps } from './TypingIndicator';
+export { default, TypingIndicator } from './TypingIndicator';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/WheelPicker/Wheel.d.ts

@@ -0,0 +1,34 @@
+import type React from 'react';
+import type { Theme } from '../../theme/types';
+import type { HapticType } from '../../utils/hapticUtils';
+export interface WheelItem {
+    value: string | number;
+    /** Text drawn in the row. */
+    label: string;
+    /** What a screen reader says for this value, such as "2 hours". Defaults to `label`. */
+    accessibilityLabel?: string;
+}
+export declare const WHEEL_VISIBLE_ITEMS = 5;
+export declare const WHEEL_CENTER_OFFSET: number;
+interface WheelProps {
+    label: string;
+    items: ReadonlyArray<WheelItem>;
+    selectedIndex: number;
+    onIndexChange: (index: number) => void;
+    itemHeight: number;
+    width?: number;
+    theme: Theme;
+    haptic?: HapticType | false;
+    disabled?: boolean;
+    reducedMotion: boolean;
+    testID?: string;
+}
+/**
+ * One scrolling column. It commits `onIndexChange` once the column rests on an
+ * item (momentum end on native, a short idle on web, where the browser has no
+ * snap-to-interval or momentum events), when a screen reader adjusts it, or
+ * when a key moves it. The caller owns `selectedIndex`.
+ */
+export declare const Wheel: React.FC<WheelProps>;
+export {};
+//# sourceMappingURL=Wheel.d.ts.map

package/lib/typescript/commonjs/components/WheelPicker/WheelPicker.d.ts

@@ -0,0 +1,73 @@
+import type React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
+import type { WheelItem } from './Wheel';
+export type { WheelItem } from './Wheel';
+export type WheelDurationStep = 1 | 5 | 15 | 30;
+export interface WheelPickerColumn {
+    /** Passed back to `onChange` in columns mode. */
+    key: string;
+    /** Names the column for a screen reader, such as "Hour". */
+    label: string;
+    items: ReadonlyArray<WheelItem>;
+    /** The selected item's `value`. A value that is not in `items` shows the first item. */
+    value: string | number;
+    /** Fixed width in points. Default 64 in columns mode; the list mode column fills the row. */
+    width?: number;
+    /** Text drawn after the column, such as ":" between hours and minutes. */
+    separator?: string;
+    /** Small unit label drawn beside the selected row, such as "min". */
+    unit?: string;
+    /** Empty space after the column (and its unit or separator), in points. */
+    gapAfter?: number;
+    testID?: string;
+}
+interface WheelPickerBaseProps {
+    /** Tick at each detent. `false` is silent; a `HapticType` replaces the default `denseTick`. */
+    haptic?: HapticType | false;
+    /** Locks scrolling and screen reader adjustment and dims the wheels. */
+    disabled?: boolean;
+    testID?: string;
+    /** Style of the row that holds the wheels. */
+    style?: StyleProp<ViewStyle>;
+}
+/** Several wheels side by side, each with its own items. */
+export interface WheelPickerColumnsProps extends WheelPickerBaseProps {
+    mode?: 'columns';
+    columns: ReadonlyArray<WheelPickerColumn>;
+    /** Fired with the column's `key` and the picked item's `value` once a wheel rests. */
+    onChange?: (key: string, value: string | number) => void;
+}
+/** One wheel over a short list of choices. */
+export interface WheelPickerListProps extends WheelPickerBaseProps {
+    mode: 'list';
+    items: ReadonlyArray<WheelItem | string | number>;
+    value?: string | number | null;
+    onChange?: (value: string | number) => void;
+    /** Names the wheel for a screen reader. Default "Value". */
+    label?: string;
+    /** Fixed width in points. Default fills the row. */
+    width?: number;
+}
+export interface WheelPickerDurationLabels {
+    hours?: string;
+    minutes?: string;
+    hourUnit?: string;
+    minuteUnit?: string;
+}
+/** Hours and minutes, up to 23 h 59 min, with the value as a whole number of minutes. */
+export interface WheelPickerDurationProps extends WheelPickerBaseProps {
+    mode: 'duration';
+    /** Duration in minutes. Clamped to `maxMinutes` and rounded to `minuteStep`. */
+    value: number;
+    onChange?: (minutes: number) => void;
+    minuteStep?: WheelDurationStep;
+    /** Upper bound in minutes. Default and ceiling 1439 (23 h 59 min). */
+    maxMinutes?: number;
+    labels?: WheelPickerDurationLabels;
+}
+export type WheelPickerProps = WheelPickerColumnsProps | WheelPickerListProps | WheelPickerDurationProps;
+declare const WheelPicker: React.FC<WheelPickerProps>;
+export { WheelPicker };
+export default WheelPicker;
+//# sourceMappingURL=WheelPicker.d.ts.map

package/lib/typescript/commonjs/components/WheelPicker/index.d.ts

@@ -0,0 +1,3 @@
+export type { WheelDurationStep, WheelItem, WheelPickerColumn, WheelPickerColumnsProps, WheelPickerDurationLabels, WheelPickerDurationProps, WheelPickerListProps, WheelPickerProps } from './WheelPicker';
+export { default, WheelPicker } from './WheelPicker';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/components/index.d.ts

@@ -18,10 +18,12 @@ export type { BadgeAnchor, BadgeProps, BadgeTone, BadgeVariant } from './Badge';
 export { Badge } from './Badge';
 export type { BannerAction, BannerActionSize, BannerActionTone, BannerActionVariant, BannerProps, BannerRole, BannerVariant } from './Banner';
 export { Banner } from './Banner';
-export type { BottomNavigationCenterAction, BottomNavigationElevation, BottomNavigationIndicatorPosition, BottomNavigationIndicatorRadius, BottomNavigationProps, BottomNavigationRadius, BottomNavigationVariant, TabBadge, TabConfig, TabIcon, TabIconProps } from './BottomNavigation';
+export type { BarChartDatum, BarChartProps, BarChartTone } from './BarChart';
+export { BarChart } from './BarChart';
+export type { BottomNavigationAccessoryState, BottomNavigationCenterAction, BottomNavigationElevation, BottomNavigationIndicatorPosition, BottomNavigationIndicatorRadius, BottomNavigationProps, BottomNavigationRadius, BottomNavigationVariant, TabBadge, TabConfig, TabIcon, TabIconProps } from './BottomNavigation';
 export { BottomNavigation } from './BottomNavigation';
-export type { BottomSheetContextValue, BottomSheetPresentation, BottomSheetProps, BottomSheetRef } from './BottomSheet';
-export { BottomSheet, useBottomSheet } from './BottomSheet';
+export type { BottomSheetContextValue, BottomSheetPresentation, BottomSheetProps, BottomSheetRef, SheetSwap, SheetSwapOptions } from './BottomSheet';
+export { BottomSheet, useBottomSheet, useSheetSwap } from './BottomSheet';
 export type { BoxProps, RowProps, SpacerProps, StackProps } from './Box';
 export { Box, Row, Spacer, Stack } from './Box';
 export type { ButtonProps, ButtonSize, ButtonTone, ButtonVariant } from './Button';
@@ -38,12 +40,16 @@ export type { ChipProps, ChipSelectionMode, ChipSize, ChipTone, ChipVariant } fr
 export { Chip } from './Chip';
 export type { ChoiceGroupDirection, ChoiceGroupIndicatorPosition, ChoiceGroupProps, ChoiceGroupSelectionMode, ChoiceGroupSize, ChoiceGroupVariant, ChoiceOption, ChoiceOptionState } from './ChoiceGroup';
 export { ChoiceGroup } from './ChoiceGroup';
+export type { ComposerProps } from './Composer';
+export { Composer } from './Composer';
 export type { ConfettiHandle, ConfettiOrigin, ConfettiPhysics, ConfettiPreset, ConfettiProps, ConfettiShape, ConfettiSpeed } from './Confetti';
 export { Confetti } from './Confetti';
 export type { DatePickerMode, DatePickerProps } from './DatePicker';
 export { DatePicker } from './DatePicker';
 export type { DateRange, DateRangePickerProps } from './DateRangePicker';
 export { DateRangePicker } from './DateRangePicker';
+export type { DateSeparatorLabels, DateSeparatorProps } from './DateSeparator';
+export { DateSeparator, DEFAULT_DATE_SEPARATOR_LABELS, dayLabel } from './DateSeparator';
 export type { DecimalInputProps, DecimalRules } from './DecimalInput';
 export { cleanDecimalText, DecimalInput, parseDecimalText } from './DecimalInput';
 export type { DescriptionItem, DescriptionsProps, DescriptionsSize, DescriptionsVariant } from './Descriptions';
@@ -88,16 +94,26 @@ export type { LoaderOverlayProps } from './LoaderOverlay';
 export { LoaderOverlay, loader, useLoader } from './LoaderOverlay';
 export type { MarkdownProps } from './Markdown';
 export { Markdown } from './Markdown';
+export type { ContextMenuConfig, MenuItem, MenuItems, MenuPresentation, MenuProps, MenuUnavailable } from './Menu';
+export { Menu } from './Menu';
+export type { MessageAction, MessageBubbleLabels, MessageBubbleProps, MessageGroupPosition, MessageReply, MessageSide, MessageStatus } from './MessageBubble';
+export { DEFAULT_MESSAGE_BUBBLE_LABELS, MessageBubble } from './MessageBubble';
+export type { MessageListLabels, MessageListProps, MessageRenderInfo } from './MessageList';
+export { DEFAULT_MESSAGE_LIST_LABELS, MessageList } from './MessageList';
 export type { ModalPresentation, ModalProps } from './Modal';
 export { MODAL_DISMISS_GRACE_MS, Modal } from './Modal';
 export type { NotationProps, NotationRun, NotationTextRun } from './Notation';
 export { Notation, parseNotation, sym } from './Notation';
 export type { NumberInputProps, NumberInputRef, NumberInputSize, NumberInputVariant } from './NumberInput';
 export { NumberInput } from './NumberInput';
+export type { OnboardingPage, OnboardingPagerLabels, OnboardingPagerProps } from './OnboardingPager';
+export { OnboardingPager } from './OnboardingPager';
 export type { OptionSheetProps, OptionSheetRowState, OptionSheetSection } from './OptionSheet';
 export { OptionSheet } from './OptionSheet';
 export type { OTPInputProps, OTPInputRef, OTPInputSize } from './OTPInput';
 export { OTPInput } from './OTPInput';
+export type { PaymentResultProps, PaymentResultStatus } from './PaymentResult';
+export { PaymentResult } from './PaymentResult';
 export type { CallingCode, PhoneNumberInfo, PhoneNumberInputLabelMode, PhoneNumberInputProps, PhoneNumberInputRef, PhoneNumberValidation, PhoneNumberValue } from './PhoneNumberInput';
 export { ALL_CALLING_CODES, DEFAULT_CALLING_CODES, formatE164, PhoneNumberInput, parseE164 } from './PhoneNumberInput';
 export type { PickerTriggerProps, PickerTriggerSize, PickerTriggerVariant } from './PickerTrigger';
@@ -118,14 +134,18 @@ export type { RepeaterProps, RepeaterRenderArgs } from './Repeater';
 export { Repeater } from './Repeater';
 export type { BlockMarkdownAction, EditorSelection, EditorState, InlineMarkdownAction, MarkdownAction, RichTextEditorProps } from './RichTextEditor';
 export { applyMarkdownAction, RichTextEditor } from './RichTextEditor';
-export type { SearchBarProps, SearchBarSize, SearchBarVariant } from './SearchBar';
-export { SearchBar } from './SearchBar';
+export type { ScannerOverlayLabels, ScannerOverlayProps, ScannerOverlayState } from './ScannerOverlay';
+export { ScannerOverlay } from './ScannerOverlay';
+export type { SearchBarProps, SearchBarSize, SearchBarVariant, SearchScope, SearchSuggestion, UseRecentSearchesOptions, UseRecentSearchesResult } from './SearchBar';
+export { SearchBar, useRecentSearches } from './SearchBar';
 export type { SectionHeaderProps, SectionHeaderVariant } from './SectionHeader';
 export { SectionHeader } from './SectionHeader';
 export type { SegmentedControlProps, SegmentedControlRadius, SegmentedControlSize, SegmentedControlTone, SegmentedControlVariant, SegmentIcon, SegmentIconState, SegmentItem, SegmentValue } from './SegmentedControl';
 export { SegmentedControl } from './SegmentedControl';
 export type { SelectOption, SelectProps, SelectSize, SelectValue } from './Select';
 export { Select } from './Select';
+export type { SignatureMode, SignaturePadLabels, SignaturePadProps, SignaturePadRef, SignaturePoint, SignatureStroke } from './SignaturePad';
+export { SignaturePad } from './SignaturePad';
 export type { SkeletonCircleProps, SkeletonClockProviderProps, SkeletonClockValue, SkeletonColors, SkeletonContentProps, SkeletonListProps, SkeletonProps, SkeletonProviderDefaults, SkeletonProviderProps, SkeletonRadius, SkeletonShape, SkeletonSkipProps, SkeletonSpeed, SkeletonStaticOf, SkeletonTextProps, SkeletonVariant, SkeletonWidth } from './Skeleton';
 export { Skeleton, SkeletonCircle, SkeletonClockProvider, SkeletonContent, SkeletonList, SkeletonProvider, SkeletonSkip, SkeletonText, useReduceMotion, useSkeletonClock, useSkeletonDefaults } from './Skeleton';
 export type { SliderProps, SliderSize, SliderTone, SliderVariant } from './Slider';
@@ -134,9 +154,11 @@ export type { SliderFieldProps } from './SliderField';
 export { SliderField } from './SliderField';
 export type { SlideToConfirmProps, SlideToConfirmSize, SlideToConfirmTone } from './SlideToConfirm';
 export { SlideToConfirm } from './SlideToConfirm';
+export type { SparklineProps, SparklineTone } from './Sparkline';
+export { Sparkline } from './Sparkline';
 export type { SpinnerProps, SpinnerSize, SpinnerVariant } from './Spinner';
 export { Spinner } from './Spinner';
-export type { StatTileProps } from './StatTile';
+export type { StatTileProps, StatTileTrend } from './StatTile';
 export { StatTile } from './StatTile';
 export type { StatusBadgeProps, StatusBadgeSize, StatusBadgeTone, StatusBadgeVariant } from './StatusBadge';
 export { StatusBadge } from './StatusBadge';
@@ -156,12 +178,16 @@ export type { TimelineItem, TimelineOrientation, TimelineProps, TimelineStatus,
 export { Timeline } from './Timeline';
 export type { MinuteStep, Period, TimeFormat, TimePickerProps, TimeValue } from './TimePicker';
 export { TimePicker } from './TimePicker';
-export type { ToastApi, ToastHaptics, ToastOptions, ToastPosition, ToastProps, ToastProviderProps, ToastVariant } from './Toast';
+export type { ToastApi, ToastHaptics, ToastOptions, ToastPosition, ToastProps, ToastProviderProps, ToastUndoOptions, ToastVariant } from './Toast';
 export { Toast, ToastHost, ToastProvider, toast, useToast } from './Toast';
-export type { TooltipPlacement, TooltipProps, TooltipTrigger } from './Tooltip';
+export type { TooltipAction, TooltipPlacement, TooltipProps, TooltipTrigger, TooltipVariant } from './Tooltip';
 export { Tooltip } from './Tooltip';
 export type { TourCloseReason, TourLabels, TourProps, TourSeenStore, TourStep } from './Tour';
 export { Tour } from './Tour';
+export type { TypingIndicatorProps } from './TypingIndicator';
+export { TypingIndicator } from './TypingIndicator';
+export type { WheelDurationStep, WheelItem, WheelPickerColumn, WheelPickerColumnsProps, WheelPickerDurationLabels, WheelPickerDurationProps, WheelPickerListProps, WheelPickerProps } from './WheelPicker';
+export { WheelPicker } from './WheelPicker';
 export type { ZoomableImageProps } from './ZoomableImage';
 export { ZoomableImage } from './ZoomableImage';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/hooks/index.d.ts

@@ -7,6 +7,10 @@ export { FLICK_TOLERANCE, useFlickGuard } from './useFlickGuard';
 export type { PressAnimationPreset, UsePressAnimationOptions, UsePressAnimationResult } from './usePressAnimation';
 export { PRESS_ANIMATION_PRESETS, usePressAnimation } from './usePressAnimation';
 export { useReducedMotion } from './useReducedMotion';
+export type { UseRefreshControlLabels, UseRefreshControlOptions, UseRefreshControlResult } from './useRefreshControl';
+export { useRefreshControl } from './useRefreshControl';
+export type { ScrollDirection, UseScrollDirectionOptions, UseScrollDirectionResult } from './useScrollDirection';
+export { useScrollDirection } from './useScrollDirection';
 export type { UseToggleResult } from './useToggle';
 export { useToggle } from './useToggle';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/hooks/useRefreshControl.d.ts

@@ -0,0 +1,75 @@
+import type React from 'react';
+import type { AccessibilityActionEvent, RefreshControlProps } from 'react-native';
+import type { HapticType } from '../utils/hapticUtils';
+export type UseRefreshControlLabels = {
+    /** Name of the refresh accessibility action. Default `'Refresh'`. */
+    refresh?: string;
+    /** Spoken when a button or accessibility-action refresh starts. Default `'Refreshing'`. */
+    refreshing?: string;
+    /** Spoken when that refresh ends. Default `'Updated'`. */
+    refreshed?: string;
+};
+export type UseRefreshControlOptions = {
+    /**
+     * Reloads the data. Return the promise (an RTK Query `refetch` already does)
+     * and the spinner stays until it settles. A rejection is logged and ends the
+     * spinner; show the user a curated message from the call itself.
+     */
+    onRefresh: () => unknown;
+    /**
+     * The screen's own loading flag, when the data is already tracked elsewhere.
+     * The spinner shows while this is true or a refresh started here is running.
+     */
+    refreshing?: boolean;
+    /**
+     * Haptic when a pull starts the refresh. Default: `'gestureStart'` on Android
+     * and none on iOS or web (no iOS haptic until a device check shows whether the
+     * system already taps). `false` turns it off; a type fires on every native
+     * platform.
+     */
+    haptic?: HapticType | false;
+    /**
+     * iOS only: the line under the spinner, for what changed ("Updated 2 minutes
+     * ago"). Never use it to explain how to refresh.
+     */
+    title?: string;
+    /** A refresh started here keeps the spinner at least this long. Default 400. */
+    minVisibleMs?: number;
+    labels?: UseRefreshControlLabels;
+};
+export type UseRefreshControlResult = {
+    /** Pass as `refreshControl` to a FlatList, SectionList, ScrollView or KeyboardAwareScrollView. */
+    refreshControl: React.ReactElement<RefreshControlProps>;
+    /** True while the spinner shows. Give an AppBar action or IconButton this as `loading`. */
+    refreshing: boolean;
+    /**
+     * Starts a refresh without a pull: the single-pointer path for an AppBar
+     * action or a button. Ignored while one is running. Fires no haptic (the
+     * button gives its own) and announces the start and the end. Never rejects.
+     */
+    refresh: () => Promise<void>;
+    /** Spread on a focusable element so a screen reader offers Refresh in its actions menu. */
+    accessibilityProps: {
+        accessibilityActions: {
+            name: 'refresh';
+            label: string;
+        }[];
+        onAccessibilityAction: (event: AccessibilityActionEvent) => void;
+    };
+};
+/**
+ * Themed pull to refresh plus the way to refresh without pulling.
+ *
+ * React Native's RefreshControl reports only that a refresh started, never that
+ * the pull crossed the trigger, so the haptic fires at that start. Web draws no
+ * pull at all, and a swipe is not available to everyone: pair the control with
+ * an AppBar action that calls `refresh()` so a person on any platform, or with a
+ * screen reader or keyboard, can reload.
+ *
+ *   const { refreshControl, refresh, refreshing } = useRefreshControl({ onRefresh: refetch });
+ *   <FlatList refreshControl={refreshControl} ... />
+ *   <AppBar rightActions={[{ icon: <AppIcon name="refresh" />, onPress: refresh,
+ *     accessibilityLabel: 'Refresh' }]} />
+ */
+export declare const useRefreshControl: (options: UseRefreshControlOptions) => UseRefreshControlResult;
+//# sourceMappingURL=useRefreshControl.d.ts.map

package/lib/typescript/commonjs/hooks/useScrollDirection.d.ts

@@ -0,0 +1,21 @@
+import type { NativeScrollEvent, NativeSyntheticEvent } from 'react-native';
+export type ScrollDirection = 'up' | 'down' | 'idle';
+export type UseScrollDirectionOptions = {
+    /** Points of travel in one direction before the direction flips. Default 8. */
+    threshold?: number;
+};
+export type UseScrollDirectionResult = {
+    direction: ScrollDirection;
+    onScroll: (e: NativeSyntheticEvent<NativeScrollEvent>) => void;
+};
+/**
+ * Direction of the user's scroll, for bars that hide on scroll down and return
+ * on scroll up. `'idle'` until the list has moved past the top; it returns to
+ * `'idle'` when the offset reaches the top. Rubber-band overscroll at either
+ * end is clamped away, so a bounce never reads as a reversal. State changes
+ * only when the direction changes, not on every scroll event.
+ *
+ * Pass `onScroll` to a ScrollView or FlatList with `scrollEventThrottle={16}`.
+ */
+export declare const useScrollDirection: (options?: UseScrollDirectionOptions) => UseScrollDirectionResult;
+//# sourceMappingURL=useScrollDirection.d.ts.map

package/lib/typescript/commonjs/index.d.ts

@@ -3,14 +3,14 @@ export type { AppIconName, AppIconProps, AppIconSize, CuratedIconName, IconName,
 export { APP_ICON_SIZES, AppIcon, CURATED_ICON_NAMES, defaultIcons, ICON_NAMES, ICONSAX_SUFFIX, renderSlotIcon } from './components/AppIcon';
 export type { FieldArrayApi, FieldInputProps, FieldRules, FieldState, FocusableNode, FormApi, FormCompletion, FormConfig, FormErrors, FormTouched, FormValidateFn, FormValues, HookFieldProps, HookFormFieldProps, SubmitHelpers, UseFormCompletionOptions, ValidateOn, ValidationResult, ValidationRule, ValidationSchema } from './form';
 export { deletePath, Form, getPath, HookFormField, isFieldFilled, rules, setPath, useField, useFieldArray, useForm, useFormCompletion, useFormContext, useHookFormField, useOptionalFormContext } from './form';
-export type { PressAnimationPreset, UseControllableStateOptions, UsePressAnimationOptions, UsePressAnimationResult, UseToggleResult } from './hooks';
-export { FLICK_TOLERANCE, PRESS_ANIMATION_PRESETS, useControllableState, useDebounce, useFlickGuard, usePressAnimation, useReducedMotion, useToggle } from './hooks';
+export type { PressAnimationPreset, ScrollDirection, UseControllableStateOptions, UsePressAnimationOptions, UsePressAnimationResult, UseRefreshControlLabels, UseRefreshControlOptions, UseRefreshControlResult, UseScrollDirectionOptions, UseScrollDirectionResult, UseToggleResult } from './hooks';
+export { FLICK_TOLERANCE, PRESS_ANIMATION_PRESETS, useControllableState, useDebounce, useFlickGuard, usePressAnimation, useReducedMotion, useRefreshControl, useScrollDirection, useToggle } from './hooks';
 export type { InitUIOptions } from './initUI';
 export { initUI } from './initUI';
 export type { NetworkStatusBannerProps } from './network';
 export { NetworkStatusBanner } from './network';
 export type { ColorMode, ColorPalette, ColorSchemePreference, DeepPartial, IconRegistry, IconRenderer, MotionScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, TextVariantSpec, Theme, ThemeOverrides, ThemeProviderProps, TypographyScale } from './theme';
 export { darkTheme, getColorMode, getTheme, lightTheme, mergeTheme, resetTheme, setColorMode, setTheme, subscribeTheme, ThemeProvider, useTheme, useThemeMode } from './theme';
-export type { BreakpointKey, FeedbackIntent, HapticType, ResponsiveScales, ScreenInfo, SpacingToken, SquirclePathParams } from './utils';
-export { Breakpoints, configureFeedback, feedback, hapticForIntent, isFeedbackEnabled, isScreenSize, isTablet, Margin, Padding, Responsive, ScreenDimensions, Spacing, SQUIRCLE_MIN_RADIUS, SQUIRCLE_SMOOTHING, setHapticImplementation, shadowStyle, smoothCorners, squircleApplies, squircleHostRadius, squirclePath, triggerHaptic, useScreenDimensions, warnUnknownProps } from './utils';
+export type { AnnounceOptions, BreakpointKey, FeedbackIntent, HapticType, ResponsiveScales, ScreenInfo, SpacingToken, SquirclePathParams } from './utils';
+export { announce, Breakpoints, configureFeedback, feedback, hapticForIntent, isFeedbackEnabled, isScreenSize, isTablet, Margin, Padding, Responsive, ScreenDimensions, Spacing, SQUIRCLE_MIN_RADIUS, SQUIRCLE_SMOOTHING, setHapticImplementation, shadowStyle, smoothCorners, squircleApplies, squircleHostRadius, squirclePath, triggerHaptic, useScreenDimensions, warnUnknownProps } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/utils/announce.d.ts

@@ -0,0 +1,14 @@
+export type AnnounceOptions = {
+    /** Polite (default) waits for current speech; `false` interrupts. Use `false` only for errors. */
+    polite?: boolean;
+};
+/**
+ * Speaks `message` through the screen reader without moving focus.
+ *
+ * iOS: queued behind current speech when polite, high priority and interrupting
+ * when not. Android: React Native exposes one announcement path with no
+ * priority, so polite and assertive both go through it. Web: a hidden
+ * `aria-live` region, `polite` or `assertive` (role `alert`).
+ */
+export declare const announce: (message: string, options?: AnnounceOptions) => void;
+//# sourceMappingURL=announce.d.ts.map

package/lib/typescript/commonjs/utils/hapticUtils.d.ts

@@ -1,4 +1,4 @@
-export type HapticType = 'selection' | 'impactLight' | 'impactMedium' | 'impactHeavy' | 'notificationSuccess' | 'notificationWarning' | 'notificationError';
+export type HapticType = 'selection' | 'impactLight' | 'impactMedium' | 'impactHeavy' | 'notificationSuccess' | 'notificationWarning' | 'notificationError' | 'longPress' | 'tick' | 'denseTick' | 'confirm' | 'reject' | 'gestureStart';
 export declare const triggerHaptic: (type?: HapticType) => void;
 /**
  * Replace the haptic backend. Intended for TESTS and for the showcase; an app

package/lib/typescript/commonjs/utils/index.d.ts

@@ -1,3 +1,5 @@
+export type { AnnounceOptions } from './announce';
+export { announce } from './announce';
 export { blendOf, tintOf } from './color';
 export { smoothCorners } from './corners';
 export type { FeedbackIntent } from './feedback';

package/lib/typescript/commonjs/utils/placement.d.ts

@@ -0,0 +1,55 @@
+import type { LayoutRectangle } from 'react-native';
+import type { EdgeInsets } from 'react-native-safe-area-context';
+/**
+ * The anchored-surface engine: where a menu, a context menu or a tooltip sits
+ * against the view that opened it. Pure geometry in window coordinates (what
+ * `measureInWindow` reports), so it runs the same on iOS, Android and web.
+ */
+export type PlacementPreference = 'top' | 'bottom' | 'auto';
+export type ResolvedPlacement = 'top' | 'bottom';
+export type PlacementAlign = 'center' | 'start' | 'end';
+export interface PlacementViewport {
+    width: number;
+    height: number;
+    insets: EdgeInsets;
+}
+export interface PlacementOptions {
+    /** Space between the anchor and the surface. Default 8. */
+    gap?: number;
+    /** Least distance from each safe edge of the viewport. Default 8. */
+    margin?: number;
+    /** Horizontal alignment against the anchor, in left-to-right terms. Default `'center'`. */
+    align?: PlacementAlign;
+}
+export interface PlacementResult {
+    x: number;
+    y: number;
+    placement: ResolvedPlacement;
+}
+export interface PlacementRoom {
+    above: number;
+    below: number;
+}
+export declare const PLACEMENT_GAP = 8;
+export declare const PLACEMENT_MARGIN = 8;
+/** Height free above and below the anchor, inside the safe area and the margin. */
+export declare const placementRoom: (anchor: LayoutRectangle, viewport: PlacementViewport, options?: PlacementOptions) => PlacementRoom;
+/**
+ * Places a surface of `content` size against `anchor`. `'top'` and `'bottom'`
+ * are preferences that flip when the surface does not fit and the other side
+ * has more room; `'auto'` takes the side with more room. The surface never
+ * covers a visible anchor: when it is taller than the room on its side the
+ * caller caps its height to `placementRoom(...)` and lets it scroll. The
+ * horizontal position is clamped inside the safe area.
+ */
+export declare const computePlacement: (anchor: LayoutRectangle, content: {
+    width: number;
+    height: number;
+}, viewport: PlacementViewport, preferred: PlacementPreference, options?: PlacementOptions) => PlacementResult;
+/**
+ * Where along a surface's edge an arrow sits so it points at the anchor's
+ * centre, kept `cornerPadding` away from the surface's corners.
+ */
+export declare const arrowOffset: (anchorCenter: number, surfaceStart: number, surfaceLength: number, cornerPadding: number) => number;
+export declare const claimAnchoredSurface: (close: () => void) => (() => void);
+//# sourceMappingURL=placement.d.ts.map