@webority/mobile-ui 0.0.0-stage → 0.0.33

package/lib/typescript/module/components/DatePicker/DatePicker.d.ts

@@ -0,0 +1,63 @@
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/index.js';
+import type { PickerTriggerSize, PickerTriggerVariant } from '../PickerTrigger/index.js';
+export type DatePickerMode = 'modal' | 'inline';
+export type WeekStart = 0 | 1 | 6;
+/**
+ * DatePicker operates in two modes:
+ *
+ * 1. **Controlled-modal mode** — pass `visible` (plus `onChange` / `onClose`)
+ *    and own the open state externally. The component renders only the modal.
+ * 2. **Trigger mode** — omit `visible`. The component renders a built-in
+ *    PickerTrigger field (label / value / placeholder / chevron / clear /
+ *    helper / error / size / variant) and manages its own open state. The
+ *    field opens the modal on press and closes it on confirm/cancel.
+ *
+ * `onChange` / `onClose` are typed optional to support trigger-only usage
+ * where the consumer may not need either callback. In controlled-modal mode
+ * they remain semantically required.
+ */
+export interface DatePickerProps {
+    visible?: boolean;
+    value?: Date | null;
+    onChange?: (date: Date) => void;
+    onClose?: () => void;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: Date[];
+    mode?: DatePickerMode;
+    locale?: string;
+    weekStartsOn?: WeekStart;
+    title?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Outer container style applied to the calendar card. */
+    containerStyle?: StyleProp<ViewStyle>;
+    /** Style override for the header label text wrapper (month/year). */
+    headerLabelStyle?: StyleProp<ViewStyle>;
+    /** Style override for the previous/next navigation buttons. */
+    navButtonStyle?: StyleProp<ViewStyle>;
+    /** Style override for the cancel/confirm footer buttons. */
+    footerButtonStyle?: StyleProp<ViewStyle>;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    testID?: string;
+    label?: string;
+    placeholder?: string;
+    helperText?: string;
+    error?: string;
+    required?: boolean;
+    disabled?: boolean;
+    size?: PickerTriggerSize;
+    variant?: PickerTriggerVariant;
+    clearable?: boolean;
+    onClear?: () => void;
+    formatValue?: (date: Date) => string;
+    triggerStyle?: StyleProp<ViewStyle>;
+}
+declare const DatePicker: React.FC<DatePickerProps>;
+export { DatePicker };
+export default DatePicker;
+//# sourceMappingURL=DatePicker.d.ts.map

package/lib/typescript/module/components/DatePicker/index.d.ts

@@ -0,0 +1,3 @@
+export type { DatePickerMode, DatePickerProps, WeekStart } from './DatePicker.js';
+export { DatePicker, default } from './DatePicker.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/DateRangePicker/DateRangePicker.d.ts

@@ -0,0 +1,69 @@
+import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/index.js';
+import type { PickerTriggerSize, PickerTriggerVariant } from '../PickerTrigger/index.js';
+export type WeekStart = 0 | 1 | 6;
+export interface DateRange {
+    start: Date | null;
+    end: Date | null;
+}
+/**
+ * DateRangePicker — supports two usage modes:
+ *
+ *   1. Controlled-modal mode (pass `visible` + `onClose`): renders only the
+ *      modal; parent owns open/close state.
+ *   2. Trigger mode (omit `visible`): renders a built-in `PickerTrigger`
+ *      field that opens an internally-managed modal on tap. Confirm fires
+ *      `onChange?.(...)` and closes.
+ */
+export interface DateRangePickerProps {
+    visible?: boolean;
+    value: DateRange;
+    onChange?: (range: {
+        start: Date;
+        end: Date;
+    }) => void;
+    onClose?: () => void;
+    label?: string;
+    placeholder?: string;
+    helperText?: string;
+    error?: string;
+    required?: boolean;
+    disabled?: boolean;
+    size?: PickerTriggerSize;
+    variant?: PickerTriggerVariant;
+    clearable?: boolean;
+    onClear?: () => void;
+    formatValue?: (range: {
+        start: Date;
+        end: Date;
+    }) => string;
+    triggerStyle?: StyleProp<ViewStyle>;
+    minDate?: Date;
+    maxDate?: Date;
+    disabledDates?: Date[];
+    locale?: string;
+    weekStartsOn?: WeekStart;
+    title?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    maxRange?: number;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
+    style?: StyleProp<ViewStyle>;
+    /** Outer container style applied to the calendar card. */
+    containerStyle?: StyleProp<ViewStyle>;
+    /** Style override for the header label (month/year) wrapper. */
+    headerLabelStyle?: StyleProp<ViewStyle>;
+    /** Style override for the previous/next navigation buttons. */
+    navButtonStyle?: StyleProp<ViewStyle>;
+    /** Style override for the cancel/confirm footer buttons. */
+    footerButtonStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const DateRangePicker: import("react").ForwardRefExoticComponent<DateRangePickerProps & import("react").RefAttributes<RNView>>;
+export { DateRangePicker };
+export default DateRangePicker;
+//# sourceMappingURL=DateRangePicker.d.ts.map

package/lib/typescript/module/components/DateRangePicker/index.d.ts

@@ -0,0 +1,3 @@
+export type { DateRange, DateRangePickerProps, WeekStart } from './DateRangePicker.js';
+export { DateRangePicker, default } from './DateRangePicker.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/Descriptions/Descriptions.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export type DescriptionsSize = 'sm' | 'md';
+export interface DescriptionItem {
+    label: string;
+    /** A string renders as text; a node renders as-is. Empty renders as an em-dash. */
+    value?: React.ReactNode;
+    /** Make this row span both columns. Ignored when `columns` is 1. */
+    full?: boolean;
+    key?: string;
+}
+export interface DescriptionsProps {
+    items: ReadonlyArray<DescriptionItem>;
+    /** 1 stacks label above value; 2 puts them side by side. Default 1 — phone widths are narrow. */
+    columns?: 1 | 2;
+    size?: DescriptionsSize;
+    /** Hairlines between rows. */
+    bordered?: boolean;
+    title?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+/**
+ * A labelled key-value list for record detail — the "what are this thing's
+ * fields" view that every detail screen needs and that ListItem (a tappable row
+ * with a title) is the wrong shape for.
+ */
+export declare const Descriptions: React.FC<DescriptionsProps>;
+export default Descriptions;
+//# sourceMappingURL=Descriptions.d.ts.map

package/lib/typescript/module/components/Descriptions/index.d.ts

@@ -0,0 +1,3 @@
+export type { DescriptionItem, DescriptionsProps, DescriptionsSize } from './Descriptions.js';
+export { Descriptions, default } from './Descriptions.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/Dialog/Dialog.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils.js';
+export type DialogVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+export type DialogActionTone = 'primary' | 'neutral' | 'error';
+export interface DialogAction {
+    label: string;
+    onPress: () => void;
+    tone?: DialogActionTone;
+    loading?: boolean;
+}
+export interface DialogProps {
+    visible: boolean;
+    onClose: () => void;
+    title?: string;
+    message?: string | React.ReactNode;
+    icon?: React.ReactNode;
+    variant?: DialogVariant;
+    actions?: DialogAction[];
+    dismissOnAction?: boolean;
+    accessibilityLabel?: string;
+    /** Style applied to the underlying Modal sheet (consumer may override radius, padding, etc.). */
+    contentStyle?: StyleProp<ViewStyle>;
+    /** Style applied to the dialog inner container (above icon/title/message). */
+    containerStyle?: StyleProp<ViewStyle>;
+    /** Style override for the title text. */
+    titleStyle?: StyleProp<TextStyle>;
+    /** Style override for the message text (only applied when message is a string). */
+    messageStyle?: StyleProp<TextStyle>;
+    /** Style override for the icon wrapper view. */
+    iconWrapperStyle?: StyleProp<ViewStyle>;
+    /** Style override for the actions row container. */
+    actionsRowStyle?: StyleProp<ViewStyle>;
+    /** Style override applied to every action button pressable. */
+    actionButtonStyle?: StyleProp<ViewStyle>;
+    /** Style override applied to every action button label text. */
+    actionTextStyle?: StyleProp<TextStyle>;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    testID?: string;
+}
+declare const Dialog: React.FC<DialogProps>;
+export { Dialog };
+export default Dialog;
+//# sourceMappingURL=Dialog.d.ts.map

package/lib/typescript/module/components/Dialog/index.d.ts

@@ -0,0 +1,3 @@
+export type { DialogAction, DialogActionTone, DialogProps, DialogVariant } from './Dialog.js';
+export { Dialog, default } from './Dialog.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/Divider/Divider.d.ts

@@ -0,0 +1,19 @@
+import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
+export type DividerOrientation = 'horizontal' | 'vertical';
+export type DividerSpacing = 'none' | 'sm' | 'md' | 'lg';
+export type DividerLabelPosition = 'start' | 'center' | 'end';
+export interface DividerProps {
+    orientation?: DividerOrientation;
+    thickness?: number;
+    color?: string;
+    spacing?: DividerSpacing;
+    inset?: number;
+    label?: string;
+    labelPosition?: DividerLabelPosition;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const Divider: import("react").ForwardRefExoticComponent<DividerProps & import("react").RefAttributes<RNView>>;
+export { Divider };
+export default Divider;
+//# sourceMappingURL=Divider.d.ts.map

package/lib/typescript/module/components/Divider/index.d.ts

@@ -0,0 +1,3 @@
+export type { DividerLabelPosition, DividerOrientation, DividerProps, DividerSpacing } from './Divider.js';
+export { Divider, default } from './Divider.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/Drawer/Drawer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Drawer — slide-in side drawer (left / right / top / bottom).
+ *
+ * Built on Reanimated 3 + Gesture Handler 2 — gestures and animations run on the
+ * UI thread for buttery 60/120fps motion. Mirrors the BottomSheet ergonomics:
+ * imperative ref API, controlled/uncontrolled visibility, swipe-to-dismiss,
+ * tap-backdrop-to-dismiss, full a11y (modal dialog).
+ *
+ * USAGE:
+ *
+ * const ref = useRef<DrawerRef>(null);
+ * <Drawer ref={ref} side="left" width={300}>
+ *   <YourMenu />
+ * </Drawer>
+ *
+ * ref.current?.open();
+ * ref.current?.close();
+ * ref.current?.toggle();
+ */
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/index.js';
+export type DrawerSide = 'left' | 'right' | 'top' | 'bottom';
+export interface DrawerProps {
+    /** Controlled visibility. Omit to use internal state. */
+    visible?: boolean;
+    /** Initial visibility for uncontrolled usage. */
+    defaultVisible?: boolean;
+    /** Fired whenever the drawer transitions open/closed. */
+    onChange?: (visible: boolean) => void;
+    /** Edge the drawer slides in from. */
+    side?: DrawerSide;
+    /** Drawer dimension along the slide axis (width for left/right, height for top/bottom). */
+    width?: number | `${number}%`;
+    /** Allow drag-to-dismiss in the natural close direction. */
+    enableSwipe?: boolean;
+    /** Allow tapping the backdrop to dismiss. */
+    enableBackdropPress?: boolean;
+    /** Backdrop opacity at fully-open state (0..1). */
+    backdropOpacity?: number;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    containerStyle?: StyleProp<ViewStyle>;
+    children?: React.ReactNode;
+    accessibilityLabel?: string;
+    testID?: string;
+}
+export interface DrawerRef {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+}
+declare const Drawer: React.ForwardRefExoticComponent<DrawerProps & React.RefAttributes<DrawerRef>>;
+export { Drawer };
+export default Drawer;
+//# sourceMappingURL=Drawer.d.ts.map

package/lib/typescript/module/components/Drawer/index.d.ts

@@ -0,0 +1,3 @@
+export type { DrawerProps, DrawerRef, DrawerSide } from './Drawer.js';
+export { Drawer, default } from './Drawer.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/EmptyState/EmptyState.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
+export type EmptyStateSize = 'sm' | 'md' | 'lg';
+export interface EmptyStateAction {
+    label: string;
+    onPress: () => void;
+    accessibilityLabel?: string;
+    accessibilityHint?: string;
+    testID?: string;
+}
+export interface EmptyStateProps {
+    icon?: React.ReactNode;
+    title: string;
+    description?: string;
+    action?: EmptyStateAction;
+    secondaryAction?: EmptyStateAction;
+    size?: EmptyStateSize;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const EmptyState: React.ForwardRefExoticComponent<EmptyStateProps & React.RefAttributes<RNView>>;
+export { EmptyState };
+export default EmptyState;
+//# sourceMappingURL=EmptyState.d.ts.map

package/lib/typescript/module/components/EmptyState/index.d.ts

@@ -0,0 +1,3 @@
+export type { EmptyStateAction, EmptyStateProps, EmptyStateSize } from './EmptyState.js';
+export { default, EmptyState } from './EmptyState.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/ErrorBoundary/ErrorBoundary.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+export interface ErrorBoundaryInfo {
+    componentStack: string;
+}
+export interface ErrorBoundaryProps {
+    children: React.ReactNode;
+    /** Custom fallback. Receives the error and a reset callback. Defaults to a themed EmptyState with a retry action. */
+    fallback?: React.ReactNode | ((error: Error, reset: () => void) => React.ReactNode);
+    /** Called on every caught error, after the error is recorded to the Logger. */
+    onError?: (error: Error, info: ErrorBoundaryInfo) => void;
+    /** Changing any value in this array resets the boundary. Standard escape hatch for route changes. */
+    resetKeys?: unknown[];
+    /** Called when the boundary resets, however it was triggered. */
+    onReset?: () => void;
+    /** Title and message for the default fallback. */
+    title?: string;
+    message?: string;
+    testID?: string;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * Catches render errors in its subtree and shows a themed fallback instead of
+ * a white screen. Mount this once near the navigation root per the fleet
+ * convention, and optionally again around any subtree that should recover
+ * independently (a single failed card should not blank the whole screen).
+ */
+export declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
+    componentDidCatch(error: Error, info: ErrorBoundaryInfo): void;
+    reset: () => void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/lib/typescript/module/components/ErrorBoundary/index.d.ts

@@ -0,0 +1,5 @@
+export type { ErrorBoundaryInfo, ErrorBoundaryProps } from './ErrorBoundary.js';
+export { ErrorBoundary } from './ErrorBoundary.js';
+export { useErrorHandler } from './useErrorHandler.js';
+export { withErrorBoundary } from './withErrorBoundary.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/ErrorBoundary/useErrorHandler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a stable callback for surfacing an error caught outside React's
+ * render/commit cycle (an async callback, a rejected promise, a native event
+ * handler) to the nearest ErrorBoundary. React only catches synchronous
+ * render errors on its own; re-throwing during a state update is the
+ * documented way to route an async error into that same path.
+ */
+export declare const useErrorHandler: () => ((error: unknown) => void);
+//# sourceMappingURL=useErrorHandler.d.ts.map

package/lib/typescript/module/components/ErrorBoundary/withErrorBoundary.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ErrorBoundaryProps } from './ErrorBoundary.js';
+/**
+ * Wraps a component in an `ErrorBoundary`. Prefer this over hand-wrapping a
+ * screen at every call site when the same fallback/reset behaviour applies
+ * everywhere that component is rendered.
+ */
+export declare const withErrorBoundary: <P extends object>(Component: React.ComponentType<P>, boundaryProps?: Omit<ErrorBoundaryProps, "children">) => React.ComponentType<P>;
+//# sourceMappingURL=withErrorBoundary.d.ts.map

package/lib/typescript/module/components/FieldBase/Chevron.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Chevron — the shared dropdown indicator for the field family.
+ *
+ * One glyph for Select, InlineSelect, PickerTrigger and PhoneNumberInput so
+ * the indicator never drifts between trigger components. It is the design
+ * system's line chevron (AppIcon `chevron-down`), reached through the icon
+ * registry so an app can swap it with `theme.icons.chevronDown`; it used to
+ * be a filled triangle drawn with view borders. Pass `open` to get the 180°
+ * rotate-on-open animation; omit it for a static chevron.
+ */
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export interface ChevronProps {
+    color: string;
+    size: number;
+    /** When provided, the chevron animates between 0° (closed) and 180° (open). */
+    open?: boolean;
+    style?: StyleProp<ViewStyle>;
+}
+export declare const Chevron: React.FC<ChevronProps>;
+export default Chevron;
+//# sourceMappingURL=Chevron.d.ts.map