@webority/mobile-ui 0.106.0 → 0.108.0

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

@@ -1,8 +1,9 @@
 import type { ReactNode } from "react";
 import type { PressableProps, View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
-export type SwitchSize = "sm" | "md" | "lg";
-export type SwitchTone = "primary" | "success" | "warning" | "danger";
+export type SwitchSize = Extract<Size, "sm" | "md" | "lg">;
+export type SwitchTone = Tone;
 /** `inline`: the control, then the text beside it. `row`: the text on the left, the control on the right, the whole row pressable. */
 export type SwitchLayout = "inline" | "row";
 export interface SwitchProps extends Omit<PressableProps, "style" | "children" | "onPress"> {
@@ -17,18 +18,15 @@ export interface SwitchProps extends Omit<PressableProps, "style" | "children" |
      * explicit `accessibilityLabel` (the switch's screen-reader name).
      */
     label?: ReactNode;
-    /** Secondary line under the label. A string or a node; a node description adds nothing to the accessibility hint. */
-    description?: ReactNode;
+    /** Secondary line under the label. */
+    description?: string;
+    /** A hint under the label, description and error. */
+    helperText?: string;
     /**
      * Error line under the label (and description); also outlines the off track in the error colour.
-     * A string or a node; `true` shows the error state without a message.
+     * `true` shows the error state without a message.
      */
-    error?: ReactNode;
-    /**
-     * Lines the label (and the description) may take before truncating with an
-     * ellipsis. Default: no limit, the text wraps in full. `0` also means no limit.
-     */
-    labelLines?: number;
+    error?: string | boolean;
     /**
      * `'inline'` (default): the control with the text beside it. `'row'`: the
      * label and description on the left (taking the free width), the control on

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

@@ -14,13 +14,15 @@
  * is a look, not a semantic change: the roles stay tablist/tab, and a value
  * choice is still SegmentedControl.
  */
+import { type ReactNode } from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
 import { Animated } from "react-native";
 import type { RadiusName } from "../../theme/types";
+import type { Size } from "../../types/vocabulary";
 import type { HapticType } from "../../utils";
 import type { SlotIcon, SlotIconState } from "../AppIcon/slotIcon";
 export type TabsVariant = "underline" | "pills" | "segmented";
-export type TabsSize = "sm" | "md" | "lg";
+export type TabsSize = Extract<Size, "sm" | "md" | "lg">;
 /** A theme radius token or a pixel number. */
 export type TabsRadius = RadiusName | number;
 export type TabsAlign = "left" | "center";
@@ -62,10 +64,10 @@ export interface TabsProps {
      */
     size?: TabsSize;
     scrollable?: boolean;
+    /** One page per tab, swiped horizontally under the bar; the shown page follows `activeKey`, and a swipe calls `onChange` with the new tab's key. */
+    pages?: ReactNode[];
     align?: TabsAlign;
     style?: StyleProp<ViewStyle>;
-    /** Alias of `style`. Applied to the outer container View. Additive — both merge. */
-    containerStyle?: StyleProp<ViewStyle>;
     tabStyle?: StyleProp<ViewStyle>;
     /** Style override applied to each tab label Text. */
     tabLabelStyle?: StyleProp<TextStyle>;

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

@@ -1,4 +1,3 @@
-import type { ReactNode } from "react";
 import type { FocusEvent, TextInput as RNTextInput, StyleProp, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils";
 import type { FieldBaseSize, FieldBaseVariant } from "../FieldBase";
@@ -11,10 +10,10 @@ export interface TagInputProps {
     label?: string;
     helperText?: string;
     /**
-     * A string or a node puts the field in the error state and shows it below in place of the
-     * helper; `true` shows the error state without a message.
+     * A string puts the field in the error state and shows it below in place of the helper; `true`
+     * shows the error state without a message.
      */
-    error?: ReactNode;
+    error?: string | boolean;
     required?: boolean;
     disabled?: boolean;
     size?: FieldBaseSize;

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

@@ -1,20 +1,21 @@
 import type React from "react";
 import type { TextProps as RNTextProps, Text as RNTextRef, StyleProp, TextStyle } from "react-native";
 import type { TextName, Theme, WeightName } from "../../theme/types";
+import type { Tone } from "../../types/vocabulary";
 export type TextVariant = "display" | "h1" | "h2" | "h3" | "title" | "body" | "bodySmall" | "caption" | "label" | "overline";
-export type TextColor = "primary" | "secondary" | "tertiary" | "inverse" | "disabled" | "link" | "textStrong" | "success" | "warning" | "danger" | "info";
+export type TextColor = "primary" | "secondary" | "tertiary" | "inverse" | "disabled" | "link" | "textStrong" | "brand" | Tone;
 export interface TextProps extends Omit<RNTextProps, "style"> {
     /**
      * A built-in variant, or the name of one registered in `theme.settings.textVariants`.
      * An unknown name warns in development and renders as `body`.
      */
     variant?: TextVariant | (string & {});
-    /** Text role token, semantic tone, or a raw colour string. Defaults per variant. */
-    color?: TextColor | (string & {});
+    /** A text role, a tone or brand. A raw colour string is refused: it warns in development and the variant's colour is drawn. */
+    color?: TextColor;
     /** Override the variant's weight. */
     weight?: WeightName;
-    /** Override the variant's size: a text step name or a pixel number. */
-    size?: TextName | number;
+    /** Override the variant's size with a text step name. */
+    size?: TextName;
     align?: TextStyle["textAlign"];
     italic?: boolean;
     underline?: boolean;

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

@@ -9,6 +9,20 @@ export interface TimeValue {
     hour: number;
     minute: number;
 }
+export interface TimePickerLabels {
+    title: string;
+    confirm: string;
+    cancel: string;
+    selected: (summary: string) => string;
+    hour: string;
+    minute: string;
+    period: string;
+    hourItem: (hour: number) => string;
+    minuteItem: (minute: number) => string;
+    cancelHint: string;
+    confirmHint: string;
+}
+export declare const DEFAULT_TIME_PICKER_LABELS: Readonly<TimePickerLabels>;
 /**
  * TimePicker supports two modes:
  *
@@ -28,9 +42,8 @@ export interface TimePickerProps {
     onClose?: () => void;
     format?: TimeFormat;
     minuteStep?: MinuteStep;
-    title?: string;
-    confirmLabel?: string;
-    cancelLabel?: string;
+    /** Chrome copy, merged over DEFAULT_TIME_PICKER_LABELS. */
+    labels?: Partial<TimePickerLabels>;
     testID?: string;
     style?: StyleProp<ViewStyle>;
     /** Outer container style applied to the bottom sheet. */
@@ -42,7 +55,7 @@ export interface TimePickerProps {
     label?: string;
     placeholder?: string;
     helperText?: string;
-    error?: React.ReactNode;
+    error?: string | boolean;
     required?: boolean;
     disabled?: boolean;
     size?: FieldBaseSize;

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

@@ -1,3 +1,3 @@
-export type { MinuteStep, Period, TimeFormat, TimePickerProps, TimeValue } from "./TimePicker";
-export { default, TimePicker } from "./TimePicker";
+export type { MinuteStep, Period, TimeFormat, TimePickerLabels, TimePickerProps, TimeValue } from "./TimePicker";
+export { DEFAULT_TIME_PICKER_LABELS, default, TimePicker } from "./TimePicker";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,7 @@
 import type React from "react";
 import type { StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
-export type ToastVariant = "default" | "success" | "danger" | "warning" | "info";
 export type ToastPosition = "top" | "bottom";
 export interface ToastAction {
     label: string;
@@ -10,7 +10,8 @@ export interface ToastAction {
 export interface ToastOptions {
     message: string;
     description?: string;
-    variant?: ToastVariant;
+    /** Default `neutral`. */
+    tone?: Tone;
     position?: ToastPosition;
     duration?: number;
     action?: ToastAction;
@@ -18,8 +19,6 @@ export interface ToastOptions {
     icon?: React.ReactNode;
     /** Style applied to the toast container (override radius, padding, shadow per-toast). */
     style?: StyleProp<ViewStyle>;
-    /** Alias of `style`. Applied to the toast container (merged additively). */
-    containerStyle?: StyleProp<ViewStyle>;
     /** Style applied to the toast message Text. */
     textStyle?: StyleProp<TextStyle>;
     /** Style applied to the leading icon circle wrapper. */
@@ -44,10 +43,17 @@ export interface ToastOptions {
 export interface ToastItem extends ToastOptions {
     id: string;
 }
+export interface ToastLabels {
+    dismiss: string;
+    undo: string;
+    seconds: (count: number) => string;
+}
+export declare const DEFAULT_TOAST_LABELS: Readonly<ToastLabels>;
 /** What the provider shares with every toast it draws. */
 export interface ToastRuntime {
     /** A screen reader is on (always false on web, where it cannot be detected). */
     screenReaderOn: boolean;
+    labels: ToastLabels;
     /** The time left for a toast that was on screen before it moved to another host. */
     readRemaining: (id: string) => number | undefined;
     /** Stores the time left when a running toast unmounts, so its next host resumes it. */
@@ -56,7 +62,7 @@ export interface ToastRuntime {
 export interface ToastProps {
     toast: ToastItem;
     index: number;
-    onDismiss: (id: string) => void;
+    onClose: (id: string) => void;
     /**
      * When the toast was first shown (ms since epoch). Auto-dismiss counts from
      * here, so a toast that remounts in another host (a modal opened or closed)

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

@@ -1,7 +1,8 @@
 import type React from "react";
+import type { Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
-import type { ToastOptions, ToastPosition, ToastVariant } from "./Toast";
-export interface ToastUndoOptions extends Omit<ToastOptions, "message" | "variant" | "action" | "countdown" | "duration"> {
+import type { ToastLabels, ToastOptions, ToastPosition } from "./Toast";
+export interface ToastUndoOptions extends Omit<ToastOptions, "message" | "tone" | "action" | "countdown" | "duration"> {
     /** Runs when Undo is pressed. The toast closes and `onCommit` never runs. */
     onUndo: () => void;
     /**
@@ -10,8 +11,6 @@ export interface ToastUndoOptions extends Omit<ToastOptions, "message" | "varian
      * 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
@@ -38,15 +37,17 @@ export interface ToastProviderProps {
      */
     defaultDuration?: number;
     /**
-     * Haptic per variant, for a toast whose own `haptic` is left out. A variant
-     * left out of the map keeps its built-in haptic (`notificationError` for
-     * `danger`,`notificationSuccess` for `success`, `notificationWarning` for
-     * `warning`, `selection` otherwise). A variant set to `false` is silent, and
-     * `false` for the whole prop silences every toast.
+     * Haptic per tone, for a toast whose own `haptic` is left out. A tone left out
+     * of the map keeps its built-in haptic (`notificationError` for `danger`,
+     * `notificationSuccess` for `success`, `notificationWarning` for `warning`,
+     * `selection` otherwise). A tone set to `false` is silent, and `false` for the
+     * whole prop silences every toast.
      */
     haptics?: ToastHaptics;
+    /** Replaces the spoken Dismiss action, the Undo button text and the countdown seconds. */
+    labels?: Partial<ToastLabels>;
 }
-export type ToastHaptics = Partial<Record<ToastVariant, HapticType | false>> | false;
+export type ToastHaptics = Partial<Record<Tone, HapticType | false>> | false;
 export declare const ToastProvider: React.FC<ToastProviderProps>;
 /**
  * Renders the provider's toasts inside a react-native Modal. A Modal is its own
@@ -59,10 +60,10 @@ 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;
-    info: (message: string, opts?: Omit<ToastOptions, "message" | "variant">) => string;
+    success: (message: string, opts?: Omit<ToastOptions, "message" | "tone">) => string;
+    error: (message: string, opts?: Omit<ToastOptions, "message" | "tone">) => string;
+    warning: (message: string, opts?: Omit<ToastOptions, "message" | "tone">) => string;
+    info: (message: string, opts?: Omit<ToastOptions, "message" | "tone">) => string;
     hideAll: () => void;
 }
 export declare const toast: ToastGlobal;

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 { ToastAction, ToastItem, ToastLabels, ToastOptions, ToastPosition, ToastProps, } from "./Toast";
+export { DEFAULT_TOAST_LABELS, default, Toast } from "./Toast";
 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/Tooltip.d.ts

@@ -13,6 +13,12 @@ export type TooltipTrigger = "longPress" | "press" | "manual";
  * one action belongs in a BottomSheet.
  */
 export type TooltipVariant = "plain" | "rich";
+export interface TooltipLabels {
+    close: string;
+    longPressHint: string;
+    fallbackName: string;
+}
+export declare const DEFAULT_TOOLTIP_LABELS: Readonly<TooltipLabels>;
 export interface TooltipProps {
     content: string | React.ReactNode;
     children: React.ReactElement;
@@ -42,8 +48,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;
+    /** Replaces the spoken names of the close area, the long-press hint and the fallback. */
+    labels?: Partial<TooltipLabels>;
     testID?: string;
 }
 declare const Tooltip: React.FC<TooltipProps>;

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

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

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

@@ -34,11 +34,13 @@ export interface TourSeenStore {
  */
 export type TourCloseReason = "finished" | "skipped" | "alreadySeen" | "noTargets";
 export interface TourLabels {
-    back?: string;
-    next?: string;
-    skip?: string;
-    done?: string;
+    back: string;
+    next: string;
+    skip: string;
+    done: string;
+    position: (step: number, total: number) => string;
 }
+export declare const DEFAULT_TOUR_LABELS: Readonly<TourLabels>;
 export interface TourProps {
     /** Names the tour in the seen store. */
     tourId: string;
@@ -48,7 +50,7 @@ export interface TourProps {
     onClose: (reason: TourCloseReason) => void;
     /** Consulted before showing and written when the tour finishes or is skipped. */
     seenStore?: TourSeenStore;
-    labels?: TourLabels;
+    labels?: Partial<TourLabels>;
     haptic?: HapticType | false;
     testID?: string;
 }

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

@@ -1,3 +1,3 @@
 export type { TourCloseReason, TourLabels, TourProps, TourSeenStore, TourStep } from "./Tour";
-export { default, Tour } from "./Tour";
+export { DEFAULT_TOUR_LABELS, default, Tour } from "./Tour";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,17 +1,22 @@
 import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
+export interface TypingIndicatorLabels {
+    typing: string;
+}
+export declare const DEFAULT_TYPING_INDICATOR_LABELS: Readonly<TypingIndicatorLabels>;
 export interface TypingIndicatorProps {
-    /** Shown beside the dots and read by screen readers, e.g. "Shannon is typing". */
+    /** Shown beside the dots and read by screen readers, e.g. "Asha is typing". */
     label?: string;
     /** Screen-reader name when there is no visible `label`. Default 'Typing'. */
     accessibilityLabel?: string;
+    labels?: Partial<TypingIndicatorLabels>;
     /** 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
+ * Three pulsing dots, with an optional line such as "Asha 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.

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

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

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

@@ -27,6 +27,8 @@ interface WheelPickerBaseProps {
     haptic?: HapticType | false;
     /** Locks scrolling and screen reader adjustment and dims the wheels. */
     disabled?: boolean;
+    /** Names the wheels, their spoken units and the default list label, in any mode. */
+    labels?: Partial<WheelPickerLabels>;
     testID?: string;
     /** Style of the row that holds the wheels. */
     style?: StyleProp<ViewStyle>;
@@ -49,12 +51,18 @@ export interface WheelPickerListProps extends WheelPickerBaseProps {
     /** Fixed width in points. Default fills the row. */
     width?: number;
 }
-export interface WheelPickerDurationLabels {
-    hours?: string;
-    minutes?: string;
-    hourUnit?: string;
-    minuteUnit?: string;
+export interface WheelPickerLabels {
+    hours: string;
+    minutes: string;
+    hourUnit: string;
+    minuteUnit: string;
+    hourOne: string;
+    hourMany: string;
+    minuteOne: string;
+    minuteMany: string;
+    value: string;
 }
+export declare const DEFAULT_WHEEL_PICKER_LABELS: Readonly<WheelPickerLabels>;
 /** 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";
@@ -69,7 +77,6 @@ export interface WheelPickerDurationProps extends WheelPickerBaseProps {
      * whole number of minutes from 0 to `maxMinutes` in steps of `minuteStep`, or the picker throws.
      */
     presets?: number[];
-    labels?: WheelPickerDurationLabels;
 }
 export type WheelPickerProps = WheelPickerColumnsProps | WheelPickerListProps | WheelPickerDurationProps;
 declare const WheelPicker: React.FC<WheelPickerProps>;

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

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