@webority/mobile-ui 0.104.1 → 0.107.0

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

@@ -6,16 +6,10 @@
  *
  * USAGE:
  *
- * const ref = useRef<BottomSheetRef>(null);
- * <BottomSheet ref={ref} snapPoints={[200, '50%', '90%']}>
+ * const [open, setOpen] = useState(false);
+ * <BottomSheet visible={open} onClose={() => setOpen(false)} snapPoints={[200, '50%', '90%']}>
  *   <YourContent />
  * </BottomSheet>
- *
- * ref.current?.expand();   // open at first snap point (or `index` prop)
- * ref.current?.expand(2);  // open at specific index
- * ref.current?.collapse(); // animate to smallest snap point
- * ref.current?.close();    // dismiss (never asks `confirmDismiss`)
- * ref.current?.requestClose(); // dismiss the way a drag or the scrim would: asks first
  */
 import type React from "react";
 import type { LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent, StyleProp, ViewStyle } from "react-native";
@@ -28,8 +22,12 @@ import { ScrollView } from "react-native";
  */
 export type SnapPoint = number | `${number}%` | "content";
 export type KeyboardBehavior = "none" | "shift";
-export type BottomSheetMode = "modal" | "inline";
 export type BottomSheetPresentation = "sheet" | "dialog" | "auto";
+export interface BottomSheetLabels {
+    close: string;
+    dragHandle: string;
+}
+export declare const DEFAULT_BOTTOM_SHEET_LABELS: Readonly<BottomSheetLabels>;
 export interface BottomSheetProps {
     /**
      * The heights the sheet rests at, in any order (they are sorted ascending).
@@ -37,9 +35,17 @@ export interface BottomSheetProps {
      * content, `['content', '90%']` adds a taller one the handle drags up to.
      * Content taller than the cap is clipped, or scrolls with `scrollable`.
      */
-    snapPoints: SnapPoint[];
-    index?: number;
-    onChange?: (index: number) => void;
+    snapPoints?: SnapPoint[];
+    /** Whether the sheet is open. Set it to false in `onClose`; a sheet closed by the person stays closed until this goes false and true again. */
+    visible: boolean;
+    /**
+     * Called after the person dismisses the sheet (a handle drag, a swipe down, the scrim, Android Back, Escape) and `onBeforeClose` allowed it. The parent sets `visible` to false in it; a sheet closed this way stays closed until `visible` goes false and true again.
+     */
+    onClose: () => void;
+    /** The snap point to open at, and the one to move to when it changes. Omitted, the sheet opens at its first snap point. A drag does not move it: follow the position with `onSnapChange`. */
+    snapIndex?: number;
+    /** Called with the snap index the person dragged the sheet to. Never called for a close: that is `onClose`. */
+    onSnapChange?: (index: number) => void;
     onAnimate?: (from: number, to: number) => void;
     /**
      * Called once after a close has finished: the exit animation is over and
@@ -56,12 +62,12 @@ export interface BottomSheetProps {
      */
     enableBackdropPress?: boolean;
     /**
-     * Asked before the user dismisses the sheet: a handle drag past the close
-     * threshold or a fast swipe down, `requestClose()`, and, while
+     * Asked before the person dismisses the sheet: a handle drag past the close
+     * threshold or a fast swipe down, the context's `requestClose`, and, while
      * `enableBackdropPress` is on, a tap on the scrim, hardware Back (Android)
-     * and Escape (web). Return `true` (or resolve `true`)
-     * to let it close, `false` to keep it open. A refused drag springs back to
-     * the snap point it started from, and `onChange(-1)` does not fire.
+     * and Escape (web). Return `true` (or resolve `true`) to let it close, `false`
+     * to keep it open. A refused drag springs back to the snap point it started
+     * from.
      *
      * Show the question with a `Dialog` or `OptionSheet` rendered inside this
      * sheet's children (a second native modal beside the sheet's own does not
@@ -69,10 +75,14 @@ export interface BottomSheetProps {
      * is pending, further dismissals are ignored, so it must settle. A rejected
      * Promise leaves the sheet open and surfaces as an unhandled rejection.
      *
-     * `ref.close()`, `useBottomSheet().close` and a controlled `index={-1}` are
-     * the app's own decision (a Save button, say) and never ask.
+     * The context's `close` is the app's own decision (a Save button, say) and
+     * never asks.
      */
-    confirmDismiss?: () => boolean | Promise<boolean>;
+    onBeforeClose?: () => boolean | Promise<boolean>;
+    /** Text the sheet speaks for its own controls. Override only what the app's language needs. */
+    labels?: Partial<BottomSheetLabels>;
+    /** A title drawn above `header`, as a heading for screen readers. */
+    title?: string;
     /**
      * Wrap `children` in a vertical ScrollView sized to the space between header
      * and footer. Off by default; a plain View then holds the content. The sheet
@@ -90,14 +100,6 @@ export interface BottomSheetProps {
     onScrollLayout?: (event: LayoutChangeEvent) => void;
     /** Forwarded to the inner ScrollView. Used only with `scrollable`. */
     scrollEventThrottle?: number;
-    /**
-     * @deprecated Backdrop opacity is now controlled by the theme token
-     * `colors.scrim` (alpha baked into the rgba value). Animated
-     * opacity on the backdrop was unreliable under Fabric view-flattening, so
-     * the scrim is now a static plain View. To tune dim level, override
-     * `theme.colors.scrim` in your theme bridge.
-     */
-    backdropOpacity?: number;
     /**
      * How the sheet reacts to the soft keyboard.
      * - `'shift'` (default): the sheet rides up with the keyboard and its body
@@ -108,14 +110,13 @@ export interface BottomSheetProps {
      */
     keyboardBehavior?: KeyboardBehavior;
     /**
-     * How the sheet is mounted in the view tree.
-     * - `'modal'` (default): rendered inside a native `<Modal>` so the backdrop
-     *   covers the entire screen (status bar, headers, tab bars) — the standard
-     *   bottom-sheet UX.
-     * - `'inline'`: rendered as an `absoluteFill` overlay inside the parent
-     *   component. Useful when embedding a sheet within a bounded area.
+     * How the sheet is mounted in the view tree. Off (default): rendered inside a
+     * native `<Modal>` so the backdrop covers the entire screen (status bar,
+     * headers, tab bars), the standard bottom-sheet UX. On: rendered as an
+     * `absoluteFill` overlay inside the parent component, for a sheet embedded
+     * within a bounded area.
      */
-    mode?: BottomSheetMode;
+    inline?: boolean;
     /**
      * How the sheet is drawn.
      * - `'sheet'` (default): full width, anchored to the bottom edge, dragged
@@ -128,8 +129,8 @@ export interface BottomSheetProps {
      */
     presentation?: BottomSheetPresentation;
     /**
-     * Whether a sheet that opens as it mounts (an `index` of 0 or more on the
-     * first render) slides up into place. When false it is drawn at its snap
+     * Whether a sheet that opens as it mounts (`visible` on the first render)
+     * slides up into place. When false it is drawn at its snap
      * point at once, and a re-measured host moves it without a spring, until
      * its first close; later opens slide as usual. Default true.
      */
@@ -158,23 +159,6 @@ export interface BottomSheetProps {
     accessibilityViewIsModal?: boolean;
     testID?: string;
 }
-export interface BottomSheetRef {
-    expand: (index?: number) => void;
-    collapse: () => void;
-    /**
-     * Closes without asking `confirmDismiss`. Resolves once the close has
-     * finished (when `onAfterClose` fires); resolves at once on a sheet that is
-     * not open, and when a reopen overtakes the close or the sheet unmounts.
-     */
-    close: () => Promise<void>;
-    /**
-     * Closes the way a drag or the scrim would: asks `confirmDismiss` first.
-     * Resolves `true` once the sheet has closed (or was not open), `false` when
-     * the dismissal was refused, ignored while another is being decided, or
-     * overtaken by a reopen or unmount.
-     */
-    requestClose: () => Promise<boolean>;
-}
 /**
  * State + actions exposed to anything rendered inside a `<BottomSheet>` —
  * including the `header` and `footer` slots. Read via `useBottomSheet()`.
@@ -189,9 +173,9 @@ export interface BottomSheetRef {
 export interface BottomSheetContextValue {
     snapIndex: number;
     snapPoints: number[];
-    expand: (index?: number) => void;
-    collapse: () => void;
-    close: () => Promise<void>;
+    /** The app's own decision: calls `onClose` without asking `onBeforeClose`. */
+    close: () => void;
+    /** Closes the way a drag or the scrim would: asks `onBeforeClose` first. Resolves `true` when it closed or was not open, `false` when refused. */
     requestClose: () => Promise<boolean>;
 }
 /**
@@ -200,7 +184,7 @@ export interface BottomSheetContextValue {
  * `children`, `header`, or `footer`).
  */
 export declare const useBottomSheet: () => BottomSheetContextValue;
-declare const BottomSheet: React.ForwardRefExoticComponent<BottomSheetProps & React.RefAttributes<BottomSheetRef>>;
+declare const BottomSheet: React.FC<BottomSheetProps>;
 export { BottomSheet };
 export default BottomSheet;
 //# sourceMappingURL=BottomSheet.d.ts.map

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

@@ -1,5 +1,3 @@
-export type { BottomSheetContextValue, BottomSheetPresentation, BottomSheetProps, BottomSheetRef, SnapPoint, } from "./BottomSheet";
-export { BottomSheet, default, useBottomSheet } from "./BottomSheet";
-export type { SheetSwap, SheetSwapOptions } from "./useSheetSwap";
-export { useSheetSwap } from "./useSheetSwap";
+export type { BottomSheetContextValue, BottomSheetLabels, BottomSheetPresentation, BottomSheetProps, SnapPoint, } from "./BottomSheet";
+export { BottomSheet, DEFAULT_BOTTOM_SHEET_LABELS, default, useBottomSheet } from "./BottomSheet";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,7 @@
-import React from "react";
 import type { PressableProps, View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { PressAnimationPreset } from "../../hooks/usePressAnimation";
 import type { GradientDefinition, Theme } from "../../theme/types";
+import type { FillVariant, Size, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
 import type { IconVariant } from "../AppIcon/AppIcon";
 import type { SlotIcon } from "../AppIcon/slotIcon";
@@ -16,17 +16,17 @@ import type { SlotIcon } from "../AppIcon/slotIcon";
  * colours are the `glass-*` tokens, the same in both schemes, and the
  * tone only inks a badged icon.
  */
-export type ButtonVariant = "solid" | "soft" | "outline" | "ghost" | "link" | "glass";
-export type ButtonTone = "primary" | "secondary" | "success" | "warning" | "danger" | "neutral";
-export type ButtonSize = "xs" | "sm" | "md" | "lg" | "xl";
+export type ButtonVariant = FillVariant | "link" | "glass";
+export type ButtonTone = Tone;
+export type ButtonSize = Size;
+/** The text a Button draws for its own states. */
+export interface ButtonLabels {
+    loading: string;
+}
+export declare const DEFAULT_BUTTON_LABELS: Readonly<ButtonLabels>;
 export interface ButtonProps extends Omit<PressableProps, "style" | "children"> {
     /** The label, and the button's accessible name unless `accessibilityLabel` is set. */
-    title?: string;
-    /**
-     * Custom content drawn in place of the label when there is no `title`. Never the label as text:
-     * development builds throw on a text child, which would otherwise draw a blank, unnamed button.
-     */
-    children?: React.ReactNode;
+    label: string;
     variant?: ButtonVariant;
     tone?: ButtonTone;
     size?: ButtonSize;
@@ -80,8 +80,10 @@ export interface ButtonProps extends Omit<PressableProps, "style" | "children">
      */
     pressAnimation?: PressAnimationPreset | false;
     testID?: string;
+    /** Overrides the text the Button draws for its own states; a key left out keeps its default. */
+    labels?: Partial<ButtonLabels>;
 }
-declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<RNView>>;
+declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<RNView>>;
 /**
  * The colour a Button draws its label in, for the given variant, tone and disabled state: the same value
  * the Button itself uses, so a renderer that draws a Button's label (Canvas) never keeps its own copy of the rules.

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

@@ -1,3 +1,3 @@
-export type { ButtonProps, ButtonSize, ButtonTone, ButtonVariant } from "./Button";
+export type { ButtonLabels, ButtonProps, ButtonSize, ButtonTone, ButtonVariant } from "./Button";
 export { Button, buttonLabelInk, default } from "./Button";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,30 +1,36 @@
 /**
  * Calendar: an inline month grid for picking one day or a range, with marked
- * days (holidays, events, pending requests) drawn as dots and read aloud with
- * each day. DateRangePicker renders this same grid inside its sheet.
+ * days drawn as dots in a tone and read aloud with each day. DateRangePicker
+ * renders this same grid inside its sheet.
  */
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { SelectionMode, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils";
-import type { StatusBadgeTone } from "../StatusBadge";
 import type { CalendarWeekStart } from "./calendarDates";
-export type CalendarMode = "single" | "range";
-export type CalendarMarkKind = "holiday" | "event" | "pending";
-export interface CalendarMarkedDate {
-    date: Date;
-    kind: CalendarMarkKind;
-    /** What the day is ("Dussehra", "Casual leave"); read aloud before the kind. */
+export type CalendarSelectionMode = Extract<SelectionMode, "single" | "range">;
+/** A marked day: a dot in its tone, read aloud with the day. */
+export interface CalendarMark {
+    /** The marked day, as an ISO date (`YYYY-MM-DD`). */
+    date: string;
+    tone: Tone;
+    /** What the day is ("Closed", "Casual leave"); read aloud with the day. */
     label?: string;
-    /** Dot colour. Default: `danger` for a holiday, `primary` for an event, `warning` for pending. */
-    tone?: StatusBadgeTone;
 }
 /** A selection. Single mode uses `start` only; a range in progress has no `end` yet. */
 export interface CalendarRange {
     start: Date;
     end?: Date;
 }
+export interface CalendarLabels {
+    previousMonth: string;
+    nextMonth: string;
+    /** Read for a mark that has no label. */
+    marked: string;
+}
+export declare const DEFAULT_CALENDAR_LABELS: Readonly<CalendarLabels>;
 export interface CalendarProps {
     /** `single` picks one day; `range` picks a start, then an end. Default `single`. */
-    mode?: CalendarMode;
+    selectionMode?: CalendarSelectionMode;
     /** The selection; `null` when nothing is picked. */
     value: CalendarRange | null;
     /**
@@ -45,9 +51,8 @@ export interface CalendarProps {
     weekStartsOn?: CalendarWeekStart;
     /** BCP 47 locale for month, weekday and day names. Default `'en-IN'`. */
     locale?: string;
-    markedDates?: CalendarMarkedDate[];
-    /** Range mode: strike holidays inside a complete range and read them as not counted. */
-    strikeMarkedInRange?: boolean;
+    /** Days drawn with a dot in their tone and read aloud with each day. */
+    marks?: CalendarMark[];
     /**
      * Fixed width and height of each day, at least 44. Unset, days share the
      * width equally and stay at least 44 tall.
@@ -57,6 +62,10 @@ export interface CalendarProps {
     haptic?: HapticType | false;
     /** Names the calendar; read with the month heading ("Leave dates, October 2026"). */
     accessibilityLabel?: string;
+    /** When set, the month title is a button. */
+    onTitlePress?: () => void;
+    /** Spoken text overrides: the arrow names and the read for a mark with no label. */
+    labels?: Partial<CalendarLabels>;
     style?: StyleProp<ViewStyle>;
     /** Style override for the month and year heading wrapper. */
     headerLabelStyle?: StyleProp<ViewStyle>;

package/lib/typescript/commonjs/components/Calendar/CalendarDay.d.ts

@@ -16,15 +16,12 @@ export interface CalendarDayProps {
     barLeft: boolean;
     barRight: boolean;
     today: boolean;
-    struck: boolean;
     dots?: readonly CalendarDot[];
-    /** Day number colour for a holiday; ignored on a selected, disabled or neighbouring-month day. */
-    inkColor?: string;
     cellStyle: StyleProp<ViewStyle>;
     styles: CalendarStyles;
     maxFontSizeMultiplier: number;
     onPressDay: (cell: CalendarCell) => void;
 }
 /** One day of the grid; memoised so a tap re-renders only the days whose state changed. */
-export declare const CalendarDay: import("react").MemoExoticComponent<({ cell, accessibilityLabel, disabled, edge, mid, barLeft, barRight, today, struck, dots, inkColor, cellStyle, styles, maxFontSizeMultiplier, onPressDay, }: CalendarDayProps) => import("react").JSX.Element>;
+export declare const CalendarDay: import("react").MemoExoticComponent<({ cell, accessibilityLabel, disabled, edge, mid, barLeft, barRight, today, dots, cellStyle, styles, maxFontSizeMultiplier, onPressDay, }: CalendarDayProps) => import("react").JSX.Element>;
 //# sourceMappingURL=CalendarDay.d.ts.map

package/lib/typescript/commonjs/components/Calendar/calendarStyles.d.ts

@@ -28,8 +28,8 @@ export declare const buildCalendarStyles: (theme: Theme) => {
         opacity: number;
     };
     navText: {
-        fontFamily?: string | undefined | undefined;
         fontWeight?: "normal" | "bold" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900" | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | "ultralight" | "thin" | "light" | "medium" | "regular" | "semibold" | "condensedBold" | "condensed" | "heavy" | "black" | undefined | undefined;
+        fontFamily?: string | undefined | undefined;
         fontSize: number;
         lineHeight: number;
         color: string;
@@ -39,8 +39,8 @@ export declare const buildCalendarStyles: (theme: Theme) => {
         alignItems: "center";
     };
     headerLabel: {
-        fontFamily?: string | undefined | undefined;
         fontWeight?: "normal" | "bold" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900" | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | "ultralight" | "thin" | "light" | "medium" | "regular" | "semibold" | "condensedBold" | "condensed" | "heavy" | "black" | undefined | undefined;
+        fontFamily?: string | undefined | undefined;
         fontSize: number;
         color: string;
     };
@@ -54,8 +54,8 @@ export declare const buildCalendarStyles: (theme: Theme) => {
         paddingVertical: number;
     };
     weekdayText: {
-        fontFamily?: string | undefined | undefined;
         fontWeight?: "normal" | "bold" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900" | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | "ultralight" | "thin" | "light" | "medium" | "regular" | "semibold" | "condensedBold" | "condensed" | "heavy" | "black" | undefined | undefined;
+        fontFamily?: string | undefined | undefined;
         fontSize: number;
         color: string;
         letterSpacing: number;
@@ -101,13 +101,10 @@ export declare const buildCalendarStyles: (theme: Theme) => {
         borderRadius: number;
     };
     dayText: {
-        fontFamily?: string | undefined | undefined;
         fontWeight?: "normal" | "bold" | "100" | "200" | "300" | "400" | "500" | "600" | "700" | "800" | "900" | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | "ultralight" | "thin" | "light" | "medium" | "regular" | "semibold" | "condensedBold" | "condensed" | "heavy" | "black" | undefined | undefined;
+        fontFamily?: string | undefined | undefined;
         fontSize: number;
     };
-    dayStruck: {
-        textDecorationLine: "line-through";
-    };
     dots: {
         position: "absolute";
         bottom: number;

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

@@ -1,4 +1,4 @@
-export type { CalendarMarkedDate, CalendarMarkKind, CalendarMode, CalendarProps, CalendarRange, } from "./Calendar";
-export { Calendar, default } from "./Calendar";
+export type { CalendarLabels, CalendarMark, CalendarProps, CalendarRange, CalendarSelectionMode, } from "./Calendar";
+export { Calendar, DEFAULT_CALENDAR_LABELS, default } from "./Calendar";
 export type { CalendarWeekStart } from "./calendarDates";
 //# sourceMappingURL=index.d.ts.map

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

@@ -3,7 +3,7 @@ import type { GestureResponderEvent, ImageSourcePropType, PressableProps, View a
 import type { GradientDefinition, ShadowName } from "../../theme/types";
 import type { HapticType } from "../../utils/hapticUtils";
 import type { ContextMenuConfig } from "../Menu/useContextMenu";
-export type CardVariant = "elevated" | "outlined" | "filled" | "flat";
+export type CardVariant = "elevated" | "outline" | "filled" | "flat";
 /** A text action in the card header, drawn with a 44 pt hit target. */
 export interface CardTextAction {
     label: string;
@@ -17,6 +17,13 @@ export type CardTitleFont = "sans" | "serif";
 declare const BACKGROUND_TOKENS: readonly ["bg", "bg-subtle", "bg-muted", "surface", "scrim", "surface-inverse"];
 type CardBackgroundToken = (typeof BACKGROUND_TOKENS)[number];
 export type CardBackground = CardBackgroundToken | (string & {});
+export interface CardLabels {
+    remove: string;
+    show: string;
+    hide: string;
+    loading: string;
+}
+export declare const DEFAULT_CARD_LABELS: Readonly<CardLabels>;
 export interface CardProps extends Omit<PressableProps, "style" | "children"> {
     children?: React.ReactNode;
     variant?: CardVariant;
@@ -31,9 +38,9 @@ export interface CardProps extends Omit<PressableProps, "style" | "children"> {
     bg?: CardBackground;
     /** Free-form header slot. When given it replaces the built-in header below. */
     header?: React.ReactNode;
-    /** Built-in header title. A string is drawn as a heading; a node is drawn as is. */
-    title?: React.ReactNode;
-    /** Face of a string title: the sans text face, or the serif display face. Default `'sans'`. A node title ignores it. */
+    /** Built-in header title, drawn as a heading. A custom heading goes in `header`. */
+    title?: string;
+    /** Face of the title: the sans text face, or the serif display face. Default `'sans'`. */
     titleFont?: CardTitleFont;
     /** Subtitle line under the title. */
     lead?: React.ReactNode;
@@ -52,8 +59,8 @@ export interface CardProps extends Omit<PressableProps, "style" | "children"> {
     collapsedSummary?: React.ReactNode;
     /** Draws a trash button in the header. */
     onRemove?: () => void;
-    /** Accessible name of the remove button. Default `'Remove'`. */
-    removeLabel?: string;
+    /** Text for the card's own controls: the remove, show and hide buttons and the loading placeholder. */
+    labels?: Partial<CardLabels>;
     /** Height of the bottom band of the `flat` variant. Default a hairline. */
     separatorHeight?: number;
     footer?: React.ReactNode;

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

@@ -1,3 +1,3 @@
-export type { CardElevation, CardPadding, CardProps, CardRadius, CardTextAction, CardVariant, } from "./Card";
-export { Card, default } from "./Card";
+export type { CardElevation, CardLabels, CardPadding, CardProps, CardRadius, CardTextAction, CardVariant, } from "./Card";
+export { Card, DEFAULT_CARD_LABELS, default } from "./Card";
 //# sourceMappingURL=index.d.ts.map

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

@@ -22,6 +22,12 @@ import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils";
 export type PaginationStyle = "dots" | "bars" | "numbers";
+export interface CarouselLabels {
+    carousel: string;
+    slideOf: (index: number, count: number) => string;
+    goToSlide: (index: number) => string;
+}
+export declare const DEFAULT_CAROUSEL_LABELS: Readonly<CarouselLabels>;
 export interface CarouselProps<T = unknown> {
     data: T[];
     renderItem: (item: T, index: number) => React.ReactNode;
@@ -62,6 +68,7 @@ export interface CarouselProps<T = unknown> {
      * loaded carousel so the layout doesn't shift when data arrives.
      */
     loading?: boolean;
+    labels?: Partial<CarouselLabels>;
 }
 export interface CarouselRef {
     scrollTo: (index: number, animated?: boolean) => void;

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

@@ -1,3 +1,3 @@
-export type { CarouselProps, CarouselRef, PaginationStyle } from "./Carousel";
-export { Carousel, default } from "./Carousel";
+export type { CarouselLabels, CarouselProps, CarouselRef, PaginationStyle } from "./Carousel";
+export { Carousel, DEFAULT_CAROUSEL_LABELS, default } from "./Carousel";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,8 +1,9 @@
 import type React from "react";
 import type { PressableProps, View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
-export type CheckboxSize = "sm" | "md" | "lg";
-export type CheckboxTone = "primary" | "success" | "warning" | "danger";
+export type CheckboxSize = Extract<Size, "sm" | "md" | "lg">;
+export type CheckboxTone = Tone;
 export type CheckboxShape = "circle";
 export interface CheckboxProps extends Omit<PressableProps, "style" | "children" | "onPress"> {
     checked?: boolean;
@@ -15,24 +16,21 @@ export interface CheckboxProps extends Omit<PressableProps, "style" | "children"
      * explicit `accessibilityLabel` (the checkbox's screen-reader name).
      */
     label?: React.ReactNode;
-    /** Secondary line under the label. A string or a node; a node description adds nothing to the accessibility hint. */
-    description?: React.ReactNode;
+    /** A muted hint directly under the label. It is the accessibility hint when set. */
+    helperText?: string;
+    /** Secondary line under the helper text. */
+    description?: string;
     /**
-     * Error line under the label (and description); also draws the box in the error colour. A string
-     * or a node; `true` shows the error state without a message.
+     * Error line under the label, helper text and description; also draws the box in the error colour.
+     * `true` shows the error state without a message.
      */
-    error?: React.ReactNode;
+    error?: string | boolean;
     /**
      * Drawn beside the label, after it (a glossary info button, say). It sits
      * beside the checkbox row, not inside it: it is not part of the checkbox's
      * accessibility name and pressing it does not toggle the box.
      */
     help?: React.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;
     size?: CheckboxSize;
     tone?: CheckboxTone;
     /** circle draws a round box with the tick inside. Omit it for the square box. */

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

@@ -1,17 +1,22 @@
 import type React from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { FillVariant, SelectionMode, Size, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
 import type { IconVariant } from "../AppIcon/AppIcon";
 import type { SlotIcon } from "../AppIcon/slotIcon";
 /**
- * `filled` is a flat neutral pill, `outlined` a ring, `soft` the tone's own
+ * `solid` is a flat neutral pill, `outline` a ring, `soft` the tone's own
  * colour at low opacity behind tone-coloured text (the tint Button and
  * IconButton draw as `soft`).
  */
-export type ChipVariant = "filled" | "outlined" | "soft";
-export type ChipTone = "primary" | "neutral" | "success" | "warning" | "danger" | "info";
-export type ChipSize = "sm" | "md";
-export type ChipSelectionMode = "single" | "multiple" | "radio";
+export type ChipVariant = Extract<FillVariant, "solid" | "outline" | "soft">;
+export type ChipTone = Tone;
+export type ChipSize = Extract<Size, "sm" | "md">;
+export type ChipSelectionMode = Extract<SelectionMode, "single" | "multiple"> | "radio";
+export interface ChipLabels {
+    remove: (label: string) => string;
+}
+export declare const DEFAULT_CHIP_LABELS: Readonly<ChipLabels>;
 export interface ChipProps {
     label: string;
     /**
@@ -33,7 +38,7 @@ export interface ChipProps {
      */
     selectionMode?: ChipSelectionMode;
     onPress?: () => void;
-    onClose?: () => void;
+    onRemove?: () => void;
     /**
      * Icon before the label. An icon name (`leftIcon="star"`) is drawn in the
      * label colour at the size's icon size; `{ name, variant }`, a render
@@ -68,6 +73,7 @@ export interface ChipProps {
     closeButtonStyle?: StyleProp<ViewStyle>;
     /** Style override for the close (×) glyph text. */
     closeIconStyle?: StyleProp<TextStyle>;
+    labels?: Partial<ChipLabels>;
     testID?: string;
 }
 declare const Chip: React.ForwardRefExoticComponent<ChipProps & React.RefAttributes<RNView>> & {

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

@@ -1,3 +1,3 @@
-export type { ChipProps, ChipSelectionMode, ChipSize, ChipTone, ChipVariant } from "./Chip";
-export { Chip, default } from "./Chip";
+export type { ChipLabels, ChipProps, ChipSelectionMode, ChipSize, ChipTone, ChipVariant, } from "./Chip";
+export { Chip, DEFAULT_CHIP_LABELS, default } from "./Chip";
 //# sourceMappingURL=index.d.ts.map

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

@@ -26,10 +26,11 @@
  */
 import type React from "react";
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { SelectionMode, Size } from "../../types/vocabulary";
 import type { HapticType } from "../../utils";
 import type { SlotIcon } from "../AppIcon/slotIcon";
 import type { RadioValue } from "../Radio/Radio";
-export type ChoiceGroupSize = "sm" | "md" | "lg";
+export type ChoiceGroupSize = Extract<Size, "sm" | "md" | "lg">;
 export type ChoiceGroupDirection = "row" | "column";
 export type ChoiceGroupVariant = "card" | "chip";
 /** Which side of the card the radio dot sits on. */
@@ -61,7 +62,7 @@ export interface ChoiceOptionState<T = ChoiceOption> {
     color: string;
 }
 /** `single` picks one option (radio); `multiple` toggles any number (checkbox). */
-export type ChoiceGroupSelectionMode = "single" | "multiple";
+export type ChoiceGroupSelectionMode = Extract<SelectionMode, "single" | "multiple">;
 interface BaseChoiceGroupProps<T = ChoiceOption> {
     /** `ChoiceOption` shape by default; pass `getOption*` accessors for anything else. */
     options: ReadonlyArray<T>;
@@ -70,7 +71,7 @@ interface BaseChoiceGroupProps<T = ChoiceOption> {
     /** Defaults to `(o) => (o as ChoiceOption).value`. */
     getOptionValue?: (option: T) => RadioValue;
     /** Defaults to `(o) => (o as ChoiceOption).disabled === true`. */
-    getOptionDisabled?: (option: T) => boolean;
+    isOptionDisabled?: (option: T) => boolean;
     /** Defaults to `(o) => (o as ChoiceOption).description`. */
     getOptionDescription?: (option: T) => string | undefined;
     /** Defaults to `(o) => (o as ChoiceOption).icon`. */
@@ -105,7 +106,7 @@ interface BaseChoiceGroupProps<T = ChoiceOption> {
     size?: ChoiceGroupSize;
     /**
      * Lines an option label may take in the built-in templates before it ends in
-     * an ellipsis. Default `1`. Screen readers always get the full label.
+     * an ellipsis. Unset means no limit. Screen readers always get the full label.
      */
     labelLines?: number;
     /**
@@ -123,6 +124,12 @@ interface BaseChoiceGroupProps<T = ChoiceOption> {
     min?: number;
     /** Multiple mode only: most options that can be selected. At this count the unselected options are disabled. Default no limit. */
     max?: number;
+    /** A line of text drawn above the options. */
+    description?: string;
+    /** A hint drawn under the options; hidden while `error` is set. */
+    helperText?: string;
+    /** `true` marks the group invalid; a string is drawn under the options in place of `helperText`. */
+    error?: string | boolean;
     testID?: string;
 }
 export interface SingleChoiceGroupProps<T = ChoiceOption> extends BaseChoiceGroupProps<T> {