@webority/mobile-ui 0.0.39 → 0.2.0

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

@@ -2,10 +2,30 @@ import React from 'react';
 import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
 import type { HapticType } from '../../utils/hapticUtils.js';
 export type BannerVariant = 'info' | 'success' | 'warning' | 'error' | 'neutral';
+/**
+ * How assistive tech treats the banner. `'alert'` announces it as it appears
+ * (an error, a lost connection); `'summary'` and `'none'` are for a calm
+ * callout that is part of the page and should be read in order, not announced.
+ */
+export type BannerRole = 'alert' | 'summary' | 'none';
+export type BannerActionVariant = 'solid' | 'outline' | 'ghost';
+export type BannerActionSize = 'sm' | 'md';
+export type BannerActionTone = 'primary' | 'neutral' | 'danger';
 export interface BannerAction {
     label: string;
     onPress: () => void;
-    tone?: 'primary' | 'neutral';
+    /**
+     * `primary` takes the banner's colour, `neutral` the secondary text colour,
+     * `danger` the error colour whatever the banner variant. Default `primary`.
+     */
+    tone?: BannerActionTone;
+    /**
+     * `ghost`: text only, a tint on press. `outline`: a bordered button in the
+     * banner's colour. `solid`: filled with the banner's colour. Default `ghost`.
+     */
+    variant?: BannerActionVariant;
+    /** `md` is a taller button with a 44 pt touch target. Default `sm`. */
+    size?: BannerActionSize;
 }
 export interface BannerProps {
     title?: string;
@@ -25,6 +45,13 @@ export interface BannerProps {
      * when data arrives. Use this while the data driving the component is being fetched.
      */
     loading?: boolean;
+    /** Default `'alert'`. See {@link BannerRole}. */
+    accessibilityRole?: BannerRole;
+    /**
+     * Replaces what the banner is announced as. Leave unset to let a screen
+     * reader read the title, the message and each button in turn: a label on
+     * the container makes TalkBack read the label alone and skip the rest.
+     */
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     /** Alias for `style` — applied to the outer animated container. */

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

@@ -1,3 +1,3 @@
-export type { BannerAction, BannerProps, BannerVariant } from './Banner.js';
+export type { BannerAction, BannerActionSize, BannerActionTone, BannerActionVariant, BannerProps, BannerRole, BannerVariant } from './Banner.js';
 export { Banner, default } from './Banner.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -17,15 +17,36 @@
  * ref.current?.close();    // dismiss
  */
 import React from 'react';
-import type { StyleProp, ViewStyle } from 'react-native';
-export type SnapPoint = number | `${number}%`;
+import type { LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent, StyleProp, ViewStyle } from 'react-native';
+import { ScrollView } from 'react-native';
+/**
+ * A snap point: a height in dp, a percentage of the host height, or
+ * `'content'`, the measured height of the sheet's own content (handle,
+ * header, children, footer and bottom safe-area inset), capped at the host
+ * height less the top safe-area inset.
+ */
+export type SnapPoint = number | `${number}%` | 'content';
 export type KeyboardBehavior = 'none' | 'shift';
 export type BottomSheetMode = 'modal' | 'inline';
+export type BottomSheetPresentation = 'sheet' | 'dialog' | 'auto';
 export interface BottomSheetProps {
+    /**
+     * The heights the sheet rests at, in any order (they are sorted ascending).
+     * `'content'` hugs the content: `['content']` is one detent as tall as the
+     * 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;
     onAnimate?: (from: number, to: number) => void;
+    /**
+     * Called once after a close has finished: the exit animation is over and
+     * the host is gone (on iOS, once the native Modal's window has been
+     * dismissed). Present anything native (an image picker, the share sheet)
+     * from here; presented earlier, iOS attaches it to the closing window.
+     */
+    onAfterClose?: () => void;
     enablePanDownToClose?: boolean;
     enableBackdropPress?: boolean;
     /**
@@ -35,6 +56,16 @@ export interface BottomSheetProps {
      * moves or closes the sheet, whichever value this has.
      */
     scrollable?: boolean;
+    /** Ref to the inner ScrollView. Used only with `scrollable`. */
+    scrollRef?: React.Ref<ScrollView>;
+    /** Forwarded to the inner ScrollView. Used only with `scrollable`. */
+    onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+    /** Forwarded to the inner ScrollView. Used only with `scrollable`. */
+    onContentSizeChange?: (width: number, height: number) => void;
+    /** Forwarded to the inner ScrollView's `onLayout`. Used only with `scrollable`. */
+    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.background.overlay` (alpha baked into the rgba value). Animated
@@ -61,6 +92,17 @@ export interface BottomSheetProps {
      *   component. Useful when embedding a sheet within a bounded area.
      */
     mode?: BottomSheetMode;
+    /**
+     * How the sheet is drawn.
+     * - `'sheet'` (default): full width, anchored to the bottom edge, dragged
+     *   by its handle between the snap points.
+     * - `'dialog'`: centred, at most 560 wide, rounded on every corner, with no
+     *   drag handle. It is as tall as the current snap point, and moves up to
+     *   stay clear of the keyboard.
+     * - `'auto'`: `'dialog'` on a tablet (the window's shorter side is 600 or
+     *   more), `'sheet'` on a phone.
+     */
+    presentation?: BottomSheetPresentation;
     handleIndicatorStyle?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;
     /**

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

@@ -1,3 +1,3 @@
-export type { BottomSheetContextValue, BottomSheetProps, BottomSheetRef, SnapPoint } from './BottomSheet.js';
+export type { BottomSheetContextValue, BottomSheetPresentation, BottomSheetProps, BottomSheetRef, SnapPoint } from './BottomSheet.js';
 export { BottomSheet, default, useBottomSheet } from './BottomSheet.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -3,6 +3,7 @@ import type { PressableProps, View as RNView, StyleProp, TextStyle, ViewStyle }
 import type { PressAnimationPreset } from '../../hooks/usePressAnimation.js';
 import type { GradientDefinition } from '../../theme/types.js';
 import type { HapticType } from '../../utils/hapticUtils.js';
+import type { IconVariant } from '../AppIcon/AppIcon.js';
 import type { SlotIcon } from '../AppIcon/slotIcon.js';
 /**
  * Visual weight, heaviest first: `solid` fills with the tone, `soft` tints
@@ -19,7 +20,12 @@ export type ButtonVariant = 'solid' | 'soft' | 'outline' | 'ghost' | 'link' | 'g
 export type ButtonTone = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral';
 export type ButtonSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 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;
     variant?: ButtonVariant;
     tone?: ButtonTone;
@@ -40,6 +46,11 @@ export interface ButtonProps extends Omit<PressableProps, 'style' | 'children'>
     leftIcon?: SlotIcon;
     /** Icon after the title; same contract as `leftIcon`. */
     rightIcon?: SlotIcon;
+    /**
+     * Iconsax style for `leftIcon` and `rightIcon` given as a name. A
+     * `{ name, variant }` icon keeps its own variant. Default `'linear'`.
+     */
+    iconVariant?: IconVariant;
     /**
      * Draws `leftIcon` inside its own opaque disc, sitting at the pill's left
      * edge, so the icon reads as a badge rather than a glyph in the label. The

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

@@ -2,7 +2,13 @@ import React from 'react';
 import type { GestureResponderEvent, ImageSourcePropType, PressableProps, View as RNView, StyleProp, ViewStyle } from 'react-native';
 import type { ColorPalette, GradientDefinition } from '../../theme/types.js';
 import type { HapticType } from '../../utils/hapticUtils.js';
-export type CardVariant = 'elevated' | 'outlined' | 'filled';
+export type CardVariant = 'elevated' | 'outlined' | 'filled' | 'flat';
+/** A text action in the card header, drawn with a 44 pt hit target. */
+export interface CardTextAction {
+    label: string;
+    onPress: () => void;
+    accessibilityLabel?: string;
+}
 export type CardElevation = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
 export type CardRadius = 'sm' | 'md' | 'lg' | 'xl' | '2xl';
 export type CardPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
@@ -20,7 +26,31 @@ export interface CardProps extends Omit<PressableProps, 'style' | 'children'> {
      * surface colour; `style` / `containerStyle` still win over it.
      */
     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;
+    /** Subtitle line under the title. */
+    lead?: React.ReactNode;
+    /** Header action: a node is drawn as is; `{ label, onPress }` draws a text action. */
+    action?: React.ReactNode | CardTextAction;
+    /** Extra nodes drawn in the header row after the action. */
+    headerActions?: React.ReactNode;
+    /** Draws a chevron button in the header that folds the body and footer away. */
+    collapsible?: boolean;
+    /** Controlled folded state. */
+    collapsed?: boolean;
+    /** Initial folded state when `collapsed` is not given. */
+    defaultCollapsed?: boolean;
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** Shown under the title while the card is folded. */
+    collapsedSummary?: React.ReactNode;
+    /** Draws a trash button in the header. */
+    onRemove?: () => void;
+    /** Accessible name of the remove button. Default `'Remove'`. */
+    removeLabel?: string;
+    /** Height of the bottom band of the `flat` variant. Default a hairline. */
+    separatorHeight?: number;
     footer?: React.ReactNode;
     imageSource?: ImageSourcePropType;
     imageHeight?: number;

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

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

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

@@ -1,3 +1,4 @@
+import type React from 'react';
 import type { PressableProps, View as RNView, StyleProp, TextStyle, ViewStyle } from 'react-native';
 import type { HapticType } from '../../utils/hapticUtils.js';
 export type CheckboxSize = 'sm' | 'md' | 'lg';
@@ -8,7 +9,26 @@ export interface CheckboxProps extends Omit<PressableProps, 'style' | 'children'
     onChange?: (checked: boolean) => void;
     indeterminate?: boolean;
     disabled?: boolean;
-    label?: string;
+    /**
+     * A string, or a node for a symbol with a subscript. A node label needs an
+     * 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;
+    /** Error line under the label (and description); also draws the box in the error colour. A string or a node. */
+    error?: React.ReactNode;
+    /**
+     * 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;
     accessibilityLabel?: string;
@@ -16,8 +36,6 @@ export interface CheckboxProps extends Omit<PressableProps, 'style' | 'children'
     haptic?: HapticType | false;
     style?: StyleProp<ViewStyle>;
     boxStyle?: StyleProp<ViewStyle>;
-    /** Style override for the check glyph (✓) inside the box. */
-    checkIconStyle?: StyleProp<TextStyle>;
     /** Style override for the indeterminate bar inside the box. */
     indeterminateBarStyle?: StyleProp<ViewStyle>;
     /** Style override for the outer row container. */
@@ -26,7 +44,7 @@ export interface CheckboxProps extends Omit<PressableProps, 'style' | 'children'
     labelStyle?: StyleProp<TextStyle>;
     testID?: string;
 }
-declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<RNView>>;
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<RNView>>;
 export { Checkbox };
 export default Checkbox;
 //# sourceMappingURL=Checkbox.d.ts.map

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

@@ -1,13 +1,26 @@
 import React from 'react';
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from 'react-native';
 import type { HapticType } from '../../utils/hapticUtils.js';
+import type { IconVariant } from '../AppIcon/AppIcon.js';
 import type { SlotIcon } from '../AppIcon/slotIcon.js';
-export type ChipVariant = 'filled' | 'outlined';
+/**
+ * `filled` is a flat neutral pill, `outlined` 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' | 'error' | 'info';
 export type ChipSize = 'sm' | 'md';
+export type ChipSelectionMode = 'single' | 'multiple';
 export interface ChipProps {
     label: string;
     selected?: boolean;
+    /**
+     * How a pressable chip announces itself. `'single'` (default) is a button
+     * with a selected state; `'multiple'` is a checkbox whose checked state
+     * follows `selected`, for chips that toggle independently.
+     */
+    selectionMode?: ChipSelectionMode;
     onPress?: () => void;
     onClose?: () => void;
     /**
@@ -16,6 +29,11 @@ export interface ChipProps {
      * function or any node also work.
      */
     leftIcon?: SlotIcon;
+    /**
+     * Iconsax style for `leftIcon` given as a name. A `{ name, variant }` icon
+     * keeps its own variant. Default `'linear'`.
+     */
+    iconVariant?: IconVariant;
     variant?: ChipVariant;
     tone?: ChipTone;
     size?: ChipSize;

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

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

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

@@ -1,5 +1,5 @@
 /**
- * ChoiceGroup — headless single-choice group with templated options.
+ * ChoiceGroup — headless choice group (one option, or `selectionMode="multiple"` for many) with templated options.
  *
  * The component owns the BEHAVIOUR: selection state (controlled or
  * uncontrolled), per-option press handling, haptics, radio/radiogroup a11y,
@@ -60,7 +60,9 @@ export interface ChoiceOptionState<T = ChoiceOption> {
     /** Resolved option colour: `getOptionColor` → option `color` → `colors.primary`. */
     color: string;
 }
-export interface ChoiceGroupProps<T = ChoiceOption> {
+/** `single` picks one option (radio); `multiple` toggles any number (checkbox). */
+export type ChoiceGroupSelectionMode = 'single' | 'multiple';
+interface BaseChoiceGroupProps<T = ChoiceOption> {
     /** `ChoiceOption` shape by default; pass `getOption*` accessors for anything else. */
     options: ReadonlyArray<T>;
     /** Defaults to `(o) => (o as ChoiceOption).label`. */
@@ -75,11 +77,6 @@ export interface ChoiceGroupProps<T = ChoiceOption> {
     getOptionIcon?: (option: T) => SlotIcon | undefined;
     /** Defaults to `(o) => (o as ChoiceOption).color`. */
     getOptionColor?: (option: T) => string | undefined;
-    /** Controlled selected value. */
-    value?: RadioValue;
-    /** Uncontrolled initial value. */
-    defaultValue?: RadioValue;
-    onChange?: (value: RadioValue) => void;
     /**
      * Custom option template. The library still owns press handling, haptics
      * and a11y — the template only paints. Selected-state styling is the
@@ -112,8 +109,35 @@ export interface ChoiceGroupProps<T = ChoiceOption> {
     style?: StyleProp<ViewStyle>;
     /** Style for each option's pressable wrapper (both templates). */
     optionStyle?: StyleProp<ViewStyle>;
+    /** Multiple mode only: fewest options that stay selected. Pressing a selected option at this count does nothing. Default none. */
+    min?: number;
+    /** Multiple mode only: most options that can be selected. At this count the unselected options are disabled. Default no limit. */
+    max?: number;
     testID?: string;
 }
+interface SingleChoiceGroupProps<T = ChoiceOption> extends BaseChoiceGroupProps<T> {
+    selectionMode?: 'single';
+    /** Controlled selected value. */
+    value?: RadioValue;
+    /** Uncontrolled initial value. */
+    defaultValue?: RadioValue;
+    onChange?: (value: RadioValue) => void;
+}
+interface MultipleChoiceGroupProps<T = ChoiceOption> extends BaseChoiceGroupProps<T> {
+    /**
+     * `'multiple'`: pressing an option toggles it. Options are exposed as
+     * checkboxes (the group has no radiogroup role), and `value`,
+     * `defaultValue` and `onChange` carry arrays of values.
+     */
+    selectionMode: 'multiple';
+    /** Controlled selected values. */
+    value?: RadioValue[];
+    /** Uncontrolled initial values. Default none. */
+    defaultValue?: RadioValue[];
+    /** Fired with the new list, in the order the values were chosen. */
+    onChange?: (values: RadioValue[]) => void;
+}
+export type ChoiceGroupProps<T = ChoiceOption> = SingleChoiceGroupProps<T> | MultipleChoiceGroupProps<T>;
 declare const ChoiceGroup: React.ForwardRefExoticComponent<ChoiceGroupProps<unknown> & React.RefAttributes<RNView>>;
 export { ChoiceGroup };
 export default ChoiceGroup;

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

@@ -1,3 +1,3 @@
-export type { ChoiceGroupDirection, ChoiceGroupIndicatorPosition, ChoiceGroupProps, ChoiceGroupSize, ChoiceGroupVariant, ChoiceOption, ChoiceOptionState } from './ChoiceGroup.js';
+export type { ChoiceGroupDirection, ChoiceGroupIndicatorPosition, ChoiceGroupProps, ChoiceGroupSelectionMode, ChoiceGroupSize, ChoiceGroupVariant, ChoiceOption, ChoiceOptionState } from './ChoiceGroup.js';
 export { ChoiceGroup, default } from './ChoiceGroup.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,56 @@
+import type { TextInput } from 'react-native';
+import type { InputProps } from '../Input/index.js';
+export interface DecimalRules {
+    /** Digits only: no point, no minus. */
+    whole?: boolean;
+    /** Allow one leading minus. */
+    signed?: boolean;
+    /** Most fraction digits kept after the point. */
+    decimals?: number;
+    /** Keep only digits and `. e E + -`, so `1e-5` can be typed. */
+    allowExponent?: boolean;
+}
+/**
+ * What a figure typed or pasted into the field is cleaned to. In exponent mode only the characters
+ * `0-9 . e E + -` survive. Otherwise: digits and at most one point (the first), an optional leading
+ * minus when `signed`, and `decimals` fraction digits at most.
+ */
+export declare function cleanDecimalText(text: string | null | undefined, { whole, signed, decimals, allowExponent }?: DecimalRules): string;
+/** What a half-typed figure reads as: nothing yet. A lone minus or point is on its way to a number. */
+export declare function parseDecimalText(text: string): number | '';
+export interface DecimalInputProps extends Omit<InputProps, 'value' | 'onChange' | 'onChangeText' | 'keyboardType'> {
+    /** The quantity's symbol, drawn in the prefix box before the value. Passed to Input as `prefix`. */
+    symbol?: InputProps['prefix'];
+    /** The figure. Text in the default mode, a number (or `''`) in `numeric` mode. */
+    value?: string | number | null;
+    /**
+     * Text mode (default): the cleaned text. `numeric`: a number, or `''` while the field is cleared
+     * or half-typed (`'12.'`, a lone `'-'`).
+     */
+    onChange?: (value: string | number) => void;
+    /** A keystroke or paste that would pass this is refused; a figure already past it can still be edited down. */
+    max?: number;
+    /** Lower bound, refused the same way as `max`. */
+    min?: number;
+    /** Digits only. Number-pad keyboard. */
+    whole?: boolean;
+    /** Allow a leading minus. Numeric keyboard. */
+    signed?: boolean;
+    /** Most fraction digits kept. */
+    decimals?: number;
+    /** Allow exponent notation such as `1e-5`. */
+    allowExponent?: boolean;
+    /**
+     * Hand `onChange` a number. The field keeps the typed text itself, so `'12.'` and `'-'` survive
+     * the keystroke, and follows `value` when it changes from elsewhere.
+     */
+    numeric?: boolean;
+}
+/**
+ * A figure typed on a number keyboard, over Input. Every Input prop passes through; the value may be
+ * empty or half-typed, which NumberInput's stepper cannot be.
+ */
+declare const DecimalInput: import("react").ForwardRefExoticComponent<DecimalInputProps & import("react").RefAttributes<TextInput>>;
+export { DecimalInput };
+export default DecimalInput;
+//# sourceMappingURL=DecimalInput.d.ts.map

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

@@ -0,0 +1,3 @@
+export type { DecimalInputProps, DecimalRules } from './DecimalInput.js';
+export { cleanDecimalText, DecimalInput, default, parseDecimalText } from './DecimalInput.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -1,13 +1,21 @@
 import React from 'react';
 import type { StyleProp, ViewStyle } from 'react-native';
+import type { TextColor } from '../Text/Text.js';
 export type DescriptionsSize = 'sm' | 'md';
+export type DescriptionsVariant = 'list' | 'summary';
 export interface DescriptionItem {
-    label: string;
-    /** A string renders as text; a node renders as-is. Empty renders as an em-dash. */
+    /** A string renders as text; a node (a symbol with a subscript, say) renders as-is. */
+    label: React.ReactNode;
+    /** A string renders as text; a node renders as-is. Empty renders as a plain hyphen, "-". */
     value?: React.ReactNode;
     /** Make this row span both columns. Ignored when `columns` is 1. */
     full?: boolean;
+    /** React key. Defaults to the label and index for a string label, and to the index for a node label. */
     key?: string;
+    /** Draw a string value in the semibold weight. */
+    strong?: boolean;
+    /** Colour of a string value: a text role, a semantic tone or a raw colour. Empty values stay muted. */
+    tone?: TextColor;
 }
 export interface DescriptionsProps {
     items: ReadonlyArray<DescriptionItem>;
@@ -17,6 +25,11 @@ export interface DescriptionsProps {
     /** Hairlines between rows. */
     bordered?: boolean;
     title?: string;
+    /**
+     * 'list' (default) is the record-detail layout. 'summary' is a compact analysis table: one line per
+     * row, label left, value right-aligned, a hairline rule under every row.
+     */
+    variant?: DescriptionsVariant;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }

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

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

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

@@ -8,12 +8,16 @@ export interface DialogAction {
     onPress: () => void;
     tone?: DialogActionTone;
     loading?: boolean;
+    /** Dims the action and blocks its press (a confirm waiting on a typed phrase, say). */
+    disabled?: boolean;
 }
 export interface DialogProps {
     visible: boolean;
     onClose: () => void;
     title?: string;
-    message?: string | React.ReactNode;
+    message?: string;
+    /** Custom content (a short form, a summary) drawn after the message and before the actions. */
+    children?: React.ReactNode;
     icon?: React.ReactNode;
     variant?: DialogVariant;
     actions?: DialogAction[];
@@ -25,7 +29,7 @@ export interface DialogProps {
     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). */
+    /** Style override for the message text. */
     messageStyle?: StyleProp<TextStyle>;
     /** Style override for the icon wrapper view. */
     iconWrapperStyle?: StyleProp<ViewStyle>;

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

@@ -15,6 +15,12 @@ export interface EmptyStateProps {
     action?: EmptyStateAction;
     secondaryAction?: EmptyStateAction;
     size?: EmptyStateSize;
+    /**
+     * Grows to fill the space it is given and centres its content, so it sits in
+     * the middle of an empty list: pass it as `ListEmptyComponent` and give the
+     * FlatList `contentContainerStyle={{ flexGrow: 1 }}`.
+     */
+    fill?: boolean;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }

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

@@ -0,0 +1,24 @@
+/**
+ * The text beside a choice control (Checkbox, Switch, Radio): the label, an
+ * optional description under it, and an optional error line under that. One
+ * piece so the three controls space and colour these lines identically.
+ */
+import type React from 'react';
+import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+export interface ChoiceTextProps {
+    /** A string, or a node (a symbol with a subscript). */
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    error?: React.ReactNode;
+    disabled?: boolean;
+    /** Lines the label may take. */
+    labelLines?: number;
+    /** Lines the description may take; unset means no limit. */
+    descriptionLines?: number;
+    style?: StyleProp<ViewStyle>;
+    labelStyle?: StyleProp<TextStyle>;
+}
+/** True when the control has a second line, so it aligns to the label's first line. */
+export declare const hasChoiceDetail: (description?: React.ReactNode, error?: React.ReactNode) => boolean;
+export declare const ChoiceText: React.FC<ChoiceTextProps>;
+//# sourceMappingURL=ChoiceText.d.ts.map

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

@@ -209,26 +209,46 @@ export declare const FieldErrorGlyph: React.FC<{
     size: number;
     color: string;
 }>;
+/**
+ * Whether a label / hint / error / prefix slot has anything to draw. Text
+ * slots across the field family take a string or a node (a symbol with a
+ * subscript), so "is it set" is not a truthiness test on a string any more:
+ * `null`, `undefined`, `false` and `''` draw nothing, everything else does.
+ */
+export declare const hasFieldText: (value: React.ReactNode) => boolean;
+/**
+ * The plain-text form of a label slot, for an accessibility name or a sheet
+ * title: the string itself, or `undefined` for a node (the caller then passes
+ * an explicit `accessibilityLabel`).
+ */
+export declare const fieldTextAsString: (value: React.ReactNode) => string | undefined;
 /**
  * The static label above a field, per the design spec: `field.label` ink,
  * the size ladder's `labelFontSize`, semibold, `labelGap` below. It stays on
  * that ink through focus and error (the ring and the message row carry the
- * error). Shared by Select, PickerTrigger, NumberInput; Input renders the
- * same styling inline because it also owns the floating-label variant.
+ * error). Shared by Input, Select, PickerTrigger, NumberInput. The label may
+ * be a string or a node, and `help` (a glossary button, say) is drawn right
+ * after it, centred on the label's line, as a sibling of the label text so it
+ * is neither part of the label's accessibility text nor able to shrink it.
  */
 export declare const FieldLabel: React.FC<{
     children: React.ReactNode;
     size?: FieldBaseSize;
     required?: boolean;
+    /** Drawn beside the label, after the required marker. */
+    help?: React.ReactNode;
+    /** Label ink; defaults to `colors.field.label`. */
+    color?: string;
     style?: StyleProp<TextStyle>;
 }>;
 /**
  * The helper / error line under a field: `messageFontSize`, `messageGap`
  * from the box, `field.message` red with the circled-exclamation glyph when
- * `error`, `text.secondary` otherwise. Renders nothing without text.
+ * `error`, `text.secondary` otherwise. The text may be a string or a node.
+ * Renders nothing without text.
  */
 export declare const FieldMessage: React.FC<{
-    text?: string;
+    text?: React.ReactNode;
     error?: boolean;
     size?: FieldBaseSize;
     style?: StyleProp<TextStyle>;

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

@@ -1,5 +1,5 @@
 export type { FieldBaseProps, FieldBaseSize, FieldBaseVariant, FieldTextStyle, FieldTextStyleResolverOptions } from './FieldBase.js';
-export { default, FieldBase, FieldErrorGlyph, FieldLabel, FieldMessage, RequiredMark, RequiredPlaceholder, resolveFieldSize, resolveFieldTextStyle } from './FieldBase.js';
+export { default, FieldBase, FieldErrorGlyph, FieldLabel, FieldMessage, fieldTextAsString, hasFieldText, RequiredMark, RequiredPlaceholder, resolveFieldSize, resolveFieldTextStyle } from './FieldBase.js';
 export type { UseFloatingLabelOptions, UseFloatingLabelResult } from './useFloatingLabel.js';
 export { FLOATED_LABEL_SCALE, useFloatingLabel } from './useFloatingLabel.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -13,13 +13,15 @@
  * wrapper that also holds FieldBase (position relative, overflow visible)
  * and passes `topNotch` through.
  */
+import type React from 'react';
 import type { StyleProp, TextStyle } from 'react-native';
 import type { ResolvedFieldSizeTokens } from '../../theme/types.js';
 import type { FieldBaseProps, FieldBaseVariant } from './FieldBase.js';
 /** The floated label's scale; the outlined notch is sized from it. */
 export declare const FLOATED_LABEL_SCALE = 0.85;
 export interface UseFloatingLabelOptions {
-    label?: string;
+    /** A string or a node; a node needs the field's explicit `accessibilityLabel`. */
+    label?: React.ReactNode;
     /** Render at all (label present and the consumer's labelMode is 'float'). */
     enabled: boolean;
     /** Whether the label is up on the border right now (focused or holding a value). */