@webority/mobile-ui 0.104.1 → 0.107.0

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

@@ -9,7 +9,7 @@
  *
  * What it deliberately does NOT own:
  *   - Native picking. Camera / gallery / document access lives in app-level
- *     `sources` adapters (`pick(): Promise<PickedFileInput[]>`), so the
+ *     `sources` adapters (`pick(): Promise<PickedFile[]>`), so the
  *     library stays zero-dependency and each app wires the native modules it
  *     already ships. Throwing inside `pick` surfaces as a field error;
  *     returning `[]` is a cancel.
@@ -20,6 +20,7 @@
  *     (compression, EXIF strip, local copy) before it lands in `files` —
  *     plug the app's image pipeline in there.
  */
+import type { PickerSource } from "@webority/mobile-core/pickers";
 import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils/index.js";
@@ -38,7 +39,7 @@ export interface FilePickerFile {
     /** Mime type, e.g. `image/jpeg`. */
     type?: string;
     /** Bytes. */
-    size?: number;
+    bytes?: number;
     /** Display-only upload state — the app sets these, the library renders them. */
     status?: FilePickerFileStatus;
     /** 0–1, rendered while `status === 'uploading'`. */
@@ -48,21 +49,9 @@ export interface FilePickerFile {
     /** Consumer payload — preserved untouched through every operation. */
     meta?: Record<string, unknown>;
 }
-/** What a source's `pick()` resolves with — the library normalizes the rest. */
-export interface PickedFileInput {
-    uri: string;
-    name?: string;
-    type?: string;
-    size?: number;
-    meta?: Record<string, unknown>;
-}
-export interface FilePickerSource {
-    key: string;
-    label: string;
-    description?: string;
+/** Launch native picking through `pick()`: resolve `[]` for user-cancel, throw for real failures. */
+export interface FilePickerSource extends PickerSource {
     icon?: React.ReactNode;
-    /** Launch native picking. Resolve `[]` for user-cancel; throw for real failures. */
-    pick: () => Promise<PickedFileInput[]>;
 }
 /** Everything a custom `renderFile` template needs to paint one file. */
 export interface FilePickerFileState {
@@ -81,18 +70,30 @@ export interface FilePickerTriggerState {
 }
 export interface FilePickerLabels {
     /** Trigger text when no files are attached. Default 'Attach file'. */
-    trigger?: string;
+    trigger: string;
     /** Add-affordance text/tile label once files exist. Default '+'. (card tile) / 'Add more' (list row). */
-    addMore?: string;
+    addMore: string;
     /** Source chooser sheet title. Default 'Add from'. */
-    sheetTitle?: string;
+    sheetTitle: string;
     /** A11y label template for a file's remove button. */
-    removeFile?: (name: string) => string;
+    removeFile: (name: string) => string;
     /** Retry affordance a11y label. Default 'Retry upload'. */
-    retry?: string;
-    errorTooMany?: (maxFiles: number) => string;
-    errorTooLarge?: (name: string, maxSizeMB: number) => string;
-    errorWrongType?: (name: string) => string;
+    retry: string;
+    /** Group a11y label of the whole picker. Default 'Attachments'. */
+    attachments: string;
+    /** Summary of the attached count, read as the trigger's a11y text. */
+    attached: (count: number) => string;
+    /** Status text while a file runs its `process` hook. Default 'Processing…'. */
+    processing: string;
+    /** Status text while a file uploads. */
+    uploading: (percent: number) => string;
+    /** Status text of a finished upload. Default 'Uploaded'. */
+    uploaded: string;
+    /** Status text of a failed file without its own error. Default 'Failed'. */
+    failed: string;
+    errorTooMany: (maxFiles: number) => string;
+    errorTooLarge: (name: string, maxSizeMB: number) => string;
+    errorWrongType: (name: string) => string;
 }
 export interface FilePickerRef {
     /** Open a source by key, or the chooser (sheet when >1 source). */
@@ -132,7 +133,7 @@ export interface FilePickerProps {
     helperText?: string;
     /** External error — wins over internal validation errors (form binding). */
     error?: React.ReactNode;
-    labels?: FilePickerLabels;
+    labels?: Partial<FilePickerLabels>;
     /** Haptics for pick/remove (selection) and rejections (error). Pass false to disable. */
     haptic?: HapticType | false;
     /** Files accepted by a pick (post-validation, post-process). */
@@ -148,6 +149,7 @@ export interface FilePickerProps {
     accessibilityLabel?: string;
     testID?: string;
 }
+export declare const DEFAULT_FILE_PICKER_LABELS: FilePickerLabels;
 export declare const formatFileSize: (bytes?: number) => string;
 export declare const matchesAccept: (type: string | undefined, accept?: ReadonlyArray<string>) => boolean;
 declare const FilePicker: React.ForwardRefExoticComponent<FilePickerProps & React.RefAttributes<FilePickerRef>>;

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

@@ -1,3 +1,3 @@
-export type { FilePickerFile, FilePickerFileState, FilePickerFileStatus, FilePickerLabels, FilePickerProps, FilePickerRef, FilePickerSource, FilePickerTriggerState, FilePickerVariant, PickedFileInput, } from "./FilePicker.js";
-export { default, FilePicker, formatFileSize } from "./FilePicker.js";
+export type { FilePickerFile, FilePickerFileState, FilePickerFileStatus, FilePickerLabels, FilePickerProps, FilePickerRef, FilePickerSource, FilePickerTriggerState, FilePickerVariant, } from "./FilePicker.js";
+export { DEFAULT_FILE_PICKER_LABELS, default, FilePicker, formatFileSize } from "./FilePicker.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,12 +1,17 @@
-import React from "react";
+import type React from "react";
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary.js";
 import type { HapticType } from "../../utils/hapticUtils.js";
-export type FloatingActionButtonSize = "sm" | "md" | "lg";
-export type FloatingActionButtonTone = "primary" | "success" | "warning" | "danger" | "neutral";
+import { type SlotIcon } from "../AppIcon/slotIcon.js";
+export type FloatingActionButtonSize = Extract<Size, "sm" | "md" | "lg">;
+export type FloatingActionButtonTone = Tone;
 export type FloatingActionButtonPosition = "bottomRight" | "bottomLeft" | "bottomCenter";
 export interface FloatingActionButtonProps {
-    /** JSX element for the icon. The FAB sizes it with the size's `icon` token. */
-    icon: React.ReactNode;
+    /**
+     * The icon: an AppIcon name, `{ name, variant }`, a render function that gets the button's
+     * ink and size, or any node drawn as is. A name is drawn in the button's ink at the size's `icon` token.
+     */
+    icon: SlotIcon;
     onPress: () => void;
     /** Text beside the icon; makes the button extended (a pill). */
     label?: string;
@@ -36,21 +41,33 @@ export interface FloatingActionButtonProps {
 declare const FloatingActionButton: React.ForwardRefExoticComponent<FloatingActionButtonProps & React.RefAttributes<RNView>>;
 export interface FloatingActionButtonGroupAction {
     key: string;
-    icon: React.ReactNode;
+    /** Drawn in the action's ink at the group's size; see `FloatingActionButtonProps.icon`. */
+    icon: SlotIcon;
     /** Visible text beside the action. Required: an icon-only menu item is not allowed. */
     label: string;
     onPress: () => void;
     tone?: FloatingActionButtonTone;
     accessibilityLabel: string;
 }
+/** The Group's screen-reader copy. The defaults are English; a consumer passes its own strings. */
+export interface FloatingActionButtonGroupLabels {
+    /** The name of the primary button when the group sets no `accessibilityLabel`. */
+    quickActions: string;
+    expanded: (label: string, count: number) => string;
+    collapsed: (label: string) => string;
+}
+export declare const DEFAULT_FLOATING_ACTION_BUTTON_GROUP_LABELS: FloatingActionButtonGroupLabels;
 export interface FloatingActionButtonGroupProps {
-    primaryIcon: React.ReactNode;
-    primaryActiveIcon?: React.ReactNode;
+    /** Drawn in the primary's ink at the group's size; see `FloatingActionButtonProps.icon`. */
+    primaryIcon: SlotIcon;
+    primaryActiveIcon?: SlotIcon;
     /** 2 to 6 actions, each with a visible label. Only the first 6 are drawn. */
     actions: FloatingActionButtonGroupAction[];
-    open?: boolean;
-    defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
+    expanded?: boolean;
+    defaultExpanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Screen-reader copy, merged over the English defaults. */
+    labels?: Partial<FloatingActionButtonGroupLabels>;
     position?: FloatingActionButtonPosition;
     bottomOffset?: number;
     size?: FloatingActionButtonSize;

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

@@ -1,3 +1,3 @@
-export type { FloatingActionButtonGroupAction, FloatingActionButtonGroupProps, FloatingActionButtonPosition, FloatingActionButtonProps, FloatingActionButtonSize, FloatingActionButtonTone, } from "./FloatingActionButton.js";
-export { default, FloatingActionButton, FloatingActionButtonGroup } from "./FloatingActionButton.js";
+export type { FloatingActionButtonGroupAction, FloatingActionButtonGroupLabels, FloatingActionButtonGroupProps, FloatingActionButtonPosition, FloatingActionButtonProps, FloatingActionButtonSize, FloatingActionButtonTone, } from "./FloatingActionButton.js";
+export { DEFAULT_FLOATING_ACTION_BUTTON_GROUP_LABELS, default, FloatingActionButton, FloatingActionButtonGroup, } from "./FloatingActionButton.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,12 @@
 import type React from "react";
 import type { StyleProp, TextStyle, ViewStyle } from "react-native";
+export interface ForceUpdateDialogLabels {
+    title: string;
+    message: string;
+    update: string;
+    later: string;
+}
+export declare const DEFAULT_FORCE_UPDATE_DIALOG_LABELS: ForceUpdateDialogLabels;
 export interface ForceUpdateDialogProps {
     /** Whether the dialog is visible. */
     visible: boolean;
@@ -12,14 +19,12 @@ export interface ForceUpdateDialogProps {
     mandatory?: boolean;
     /** Optional override of the destination URL (defaults to the platform store). */
     updateUrl?: string | null;
-    /** Custom dialog title. */
+    /** Per-call title override; wins over `labels.title`. */
     title?: string;
-    /** Custom dialog message. */
+    /** Per-call message override; wins over `labels.message`. */
     message?: string;
-    /** Custom label for the primary "Update" action. */
-    updateLabel?: string;
-    /** Custom label for the dismiss action. Hidden when `mandatory`. */
-    laterLabel?: string;
+    /** Copy overrides merged over the defaults. `later` is hidden when `mandatory`. */
+    labels?: Partial<ForceUpdateDialogLabels>;
     /** Forwarded to the underlying Dialog container. */
     containerStyle?: StyleProp<ViewStyle>;
     /** Forwarded to the underlying Dialog title Text. */

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

@@ -1,3 +1,3 @@
-export type { ForceUpdateDialogProps } from "./ForceUpdateDialog.js";
-export { default, ForceUpdateDialog } from "./ForceUpdateDialog.js";
+export type { ForceUpdateDialogLabels, ForceUpdateDialogProps } from "./ForceUpdateDialog.js";
+export { DEFAULT_FORCE_UPDATE_DIALOG_LABELS, default, ForceUpdateDialog } from "./ForceUpdateDialog.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,10 @@
 import React from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
-import type { FieldInputProps } from "../../form/types.js";
 export type FormFieldLayout = "stacked" | "inline";
+export interface FormFieldLabels {
+    labelWithError: (label: string, error: string) => string;
+}
+export declare const DEFAULT_FORM_FIELD_LABELS: FormFieldLabels;
 export interface FormFieldProps {
     /** A string, or a node for a symbol with a subscript. A node label needs an explicit `accessibilityLabel`. */
     label?: React.ReactNode;
@@ -13,8 +16,7 @@ export interface FormFieldProps {
      * When truthy: helperText is hidden, error is shown in the error colour,
      * and the container reports the invalid state to assistive tech (a node
      * error is shown but reaches assistive tech only through its live region).
-     * Ignored when `name` connects to a <Form> with an element child (the child
-     * renders its own error then). A string or a node.
+     * A string or a node.
      */
     error?: React.ReactNode;
     /**
@@ -22,15 +24,7 @@ export interface FormFieldProps {
      * `theme.settings.components.field.requiredMarker` (default `'*'` in `colors.danger`).
      */
     required?: boolean;
-    /**
-     * Connect this field to the surrounding `<Form>` by name. With an element
-     * child (e.g. `<Input/>`) the field's value/onChangeText/onBlur/error are
-     * injected automatically — best for text inputs. For non-text controls
-     * (Select, Switch, DatePicker…) use the render-prop form:
-     * `<FormField name="x">{(f) => <Select value={f.value} onChange={f.onChange} />}</FormField>`.
-     */
-    name?: string;
-    children: React.ReactNode | ((field: FieldInputProps) => React.ReactNode);
+    children: React.ReactNode;
     /** 'stacked' (default): label above input. 'inline': label left, input right. */
     layout?: FormFieldLayout;
     /**
@@ -50,6 +44,8 @@ export interface FormFieldProps {
      */
     inputContainerStyle?: StyleProp<ViewStyle>;
     accessibilityLabel?: string;
+    /** Spoken text pieces; a key left out keeps its English default. */
+    labels?: Partial<FormFieldLabels>;
     testID?: string;
 }
 declare const FormField: React.ForwardRefExoticComponent<FormFieldProps & React.RefAttributes<RNView>>;

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

@@ -1,3 +1,3 @@
-export type { FormFieldLayout, FormFieldProps } from "./FormField.js";
-export { default, FormField } from "./FormField.js";
+export type { FormFieldLabels, FormFieldLayout, FormFieldProps } from "./FormField.js";
+export { DEFAULT_FORM_FIELD_LABELS, default, FormField } from "./FormField.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,8 +1,9 @@
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary.js";
 import type { IconVariant } from "../AppIcon/AppIcon.js";
 import type { SlotIcon } from "../AppIcon/slotIcon.js";
-export type IconBadgeSize = "sm" | "md" | "lg";
-export type IconBadgeTone = "primary" | "secondary" | "success" | "warning" | "danger" | "info" | "neutral";
+export type IconBadgeSize = Extract<Size, "sm" | "md" | "lg">;
+export type IconBadgeTone = Tone;
 export interface IconBadgeProps {
     /**
      * The icon: an AppIcon name (`icon="shield-tick"`), `{ name, variant }`, a

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

@@ -1,16 +1,17 @@
 import type { GestureResponderEvent, View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { FillVariant, Size, Tone } from "../../types/vocabulary.js";
 import type { HapticType } from "../../utils/index.js";
 import type { IconVariant } from "../AppIcon/AppIcon.js";
 import type { SlotIcon } from "../AppIcon/slotIcon.js";
-export type IconButtonTone = "primary" | "secondary" | "success" | "warning" | "danger" | "neutral";
+export type IconButtonTone = Tone;
 /**
  * `glass` is a frosted white fill with a bright rim and dark ink, for a
  * button over a brand gradient or a photo (a back button on a hero). Its
  * colours are the glass colours (`glass-fill`, `glass-border`, `on-glass`), the same in both schemes; the tone is
  * unused unless `active` forces the solid fill.
  */
-export type IconButtonVariant = "solid" | "soft" | "outline" | "ghost" | "glass";
-export type IconButtonSize = "sm" | "md" | "lg";
+export type IconButtonVariant = FillVariant | "glass";
+export type IconButtonSize = Extract<Size, "sm" | "md" | "lg">;
 export type IconButtonShape = "circle" | "rounded";
 export interface IconButtonProps {
     /**

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

@@ -24,8 +24,20 @@ export interface GalleryImage {
     caption?: string;
     alt?: string;
 }
+export interface ImageGalleryLabels {
+    gallery: string;
+    imageOf: (index: number, total: number) => string;
+    openFullscreen: string;
+    closeGallery: string;
+}
+export declare const DEFAULT_IMAGE_GALLERY_LABELS: ImageGalleryLabels;
 export interface ImageGalleryProps {
     images: GalleryImage[];
+    /**
+     * Visible-to-screen-reader copy. Omitted keys keep the English defaults. `imageOf` takes a
+     * 1-based index.
+     */
+    labels?: Partial<ImageGalleryLabels>;
     initialIndex?: number;
     showThumbnails?: boolean;
     showCounter?: boolean;

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

@@ -1,3 +1,3 @@
-export type { GalleryImage, ImageGalleryProps } from "./ImageGallery.js";
-export { default, ImageGallery } from "./ImageGallery.js";
+export type { GalleryImage, ImageGalleryLabels, ImageGalleryProps } from "./ImageGallery.js";
+export { DEFAULT_IMAGE_GALLERY_LABELS, default, ImageGallery } from "./ImageGallery.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -23,9 +23,17 @@
  */
 import type React from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { Size } from "../../types/vocabulary.js";
 import type { HapticType } from "../../utils/index.js";
 import type { SelectOption, SelectValue } from "../OptionSheet/OptionSheet.js";
-export type InlineSelectSize = "sm" | "md" | "lg";
+export type InlineSelectSize = Extract<Size, "sm" | "md" | "lg">;
+export interface InlineSelectLabels {
+    select: string;
+    options: string;
+    noSelection: string;
+    selected: (label: string) => string;
+}
+export declare const DEFAULT_INLINE_SELECT_LABELS: InlineSelectLabels;
 export interface InlineSelectProps<T = SelectOption> {
     /** Same contract as Select's `options` — `SelectOption` shape by default, accessors for anything else. */
     options: ReadonlyArray<T>;
@@ -34,7 +42,7 @@ export interface InlineSelectProps<T = SelectOption> {
     /** Defaults to `(o) => (o as SelectOption).value`. */
     getOptionValue?: (option: T) => SelectValue;
     /** Defaults to `(o) => (o as SelectOption).disabled === true`. */
-    getOptionDisabled?: (option: T) => boolean;
+    isOptionDisabled?: (option: T) => boolean;
     /** Defaults to `(o) => (o as SelectOption).description`. */
     getOptionDescription?: (option: T) => string | undefined;
     /** Defaults to `(o) => (o as SelectOption).icon`. */
@@ -43,6 +51,8 @@ export interface InlineSelectProps<T = SelectOption> {
     onChange: (value: SelectValue) => void;
     /** Trigger text when nothing is selected. Default `'Select'`. */
     placeholder?: string;
+    /** Copy for the trigger and sheet; any key omitted keeps its English default. */
+    labels?: Partial<InlineSelectLabels>;
     /**
      * Label drawn above the trigger, the same `FieldLabel` Select uses, so a bare
      * trigger reads as a field of its own. Also names the trigger for screen

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

@@ -1,3 +1,3 @@
-export type { InlineSelectProps, InlineSelectSize } from "./InlineSelect.js";
-export { default, InlineSelect } from "./InlineSelect.js";
+export type { InlineSelectLabels, InlineSelectProps, InlineSelectSize } from "./InlineSelect.js";
+export { DEFAULT_INLINE_SELECT_LABELS, default, InlineSelect } from "./InlineSelect.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,11 +1,18 @@
 import type React from "react";
 import type { BlurEvent, FocusEvent, StyleProp, TextInputProps, TextStyle, ViewStyle } from "react-native";
 import { TextInput } from "react-native";
+import type { FieldVariant, Size } from "../../types/vocabulary.js";
 import type { SlotIcon, SlotIconState } from "../AppIcon/slotIcon.js";
 import type { ButtonTone, ButtonVariant } from "../Button/index.js";
-export type InputSize = "sm" | "md" | "lg";
-export type InputVariant = "outlined" | "filled" | "underline";
+export type InputSize = Extract<Size, "sm" | "md" | "lg">;
+export type InputVariant = FieldVariant;
 export type InputLabelMode = "float" | "top";
+/** Screen-reader names for the password eye toggle. */
+export interface InputLabels {
+    showPassword: string;
+    hidePassword: string;
+}
+export declare const DEFAULT_INPUT_LABELS: InputLabels;
 /**
  * What kind of field this is. One prop switches the whole behaviour set:
  * - `'input'` (default): single-line text.
@@ -169,6 +176,8 @@ export interface InputProps extends Omit<TextInputProps, "style"> {
     onFocus?: (e: FocusEvent) => void;
     onBlur?: (e: BlurEvent) => void;
     accessibilityLabel?: string;
+    /** Overrides for the password toggle's screen-reader names; merged over DEFAULT_INPUT_LABELS. */
+    labels?: Partial<InputLabels>;
     testID?: string;
 }
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<TextInput>>;

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

@@ -1,3 +1,3 @@
-export type { InputAction, InputKeyboardType, InputProps, InputSize, InputSlotIcon, InputSlotState, InputVariant, } from "./Input.js";
-export { default, Input } from "./Input.js";
+export type { InputAction, InputKeyboardType, InputLabels, InputProps, InputSize, InputSlotIcon, InputSlotState, InputVariant, } from "./Input.js";
+export { DEFAULT_INPUT_LABELS, default, Input } from "./Input.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,19 +1,22 @@
 import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
+export interface KeyboardToolbarLabels {
+    done: string;
+    previous: string;
+    next: string;
+}
+export declare const DEFAULT_KEYBOARD_TOOLBAR_LABELS: KeyboardToolbarLabels;
 export interface KeyboardToolbarProps {
-    /** Label for the dismiss button. Default 'Done'. */
-    doneLabel?: string;
     /** Show the prev/next chevrons. Default true. */
     showNavigation?: boolean;
     /** Override the dismiss action. Default: `KeyboardController.dismiss()`. */
     onDone?: () => void;
-    /**
-     * Override "next field". Default: the surrounding `<Form>`'s `focusNext`,
-     * otherwise the next text input on screen (`KeyboardController.setFocusTo`).
-     */
+    /** Override "next field". Default: the next text input on screen (`KeyboardController.setFocusTo`). */
     onNext?: () => void;
-    /** Override "previous field"; the same defaults as `onNext`, backwards. */
+    /** Override "previous field"; the same default as `onNext`, backwards. */
     onPrev?: () => void;
+    /** Overrides for the Done, previous and next labels. Missing keys keep the English defaults. */
+    labels?: Partial<KeyboardToolbarLabels>;
     /** Custom content rendered between the nav chevrons and the Done button. */
     leading?: React.ReactNode;
     style?: StyleProp<ViewStyle>;
@@ -21,9 +24,8 @@ export interface KeyboardToolbarProps {
 }
 /**
  * An accessory bar that rides on top of the keyboard. Shows a Done (dismiss)
- * button and prev/next chevrons that, inside a `<Form>`, walk the registered
- * field order and otherwise move between the text inputs on screen. Render it
- * at the screen root, after the content; it sits at the bottom edge and
+ * button and prev/next chevrons that move between the text inputs on screen.
+ * Render it at the screen root, after the content; it sits at the bottom edge and
  * react-native-keyboard-controller's `KeyboardStickyView` lifts it with the
  * keyboard frame by frame. Renders nothing while the keyboard is hidden. Needs
  * the app's `KeyboardProvider` at the root.

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

@@ -1,3 +1,3 @@
-export type { KeyboardToolbarProps } from "./KeyboardToolbar.js";
-export { KeyboardToolbar } from "./KeyboardToolbar.js";
+export type { KeyboardToolbarLabels, KeyboardToolbarProps } from "./KeyboardToolbar.js";
+export { DEFAULT_KEYBOARD_TOOLBAR_LABELS, KeyboardToolbar } from "./KeyboardToolbar.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,12 +1,12 @@
 import React from "react";
 import type { GestureResponderEvent, View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary.js";
 import type { HapticType } from "../../utils/hapticUtils.js";
 import type { SlotIcon } from "../AppIcon/slotIcon.js";
 import type { ButtonProps } from "../Button/index.js";
-import type { IconBadgeTone } from "../IconBadge/index.js";
 import type { ContextMenuConfig } from "../Menu/useContextMenu.js";
 import type { SwipeableAction } from "../Swipeable/index.js";
-export type ListItemSize = "sm" | "md" | "lg";
+export type ListItemSize = Extract<Size, "sm" | "md" | "lg">;
 /**
  * Where the `right` slot sits. `side` is beside the text, `below` is under the
  * subtitle and description, and `auto` is `side` until the user's text size is
@@ -56,7 +56,7 @@ export interface ListItemProps {
      */
     icon?: SlotIcon;
     /** Tone of the `icon` circle. Default `'primary'`. */
-    iconTone?: IconBadgeTone;
+    iconTone?: Tone;
     right?: React.ReactNode;
     /**
      * Where the `right` slot is drawn. Default `'auto'`: beside the text, and

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

@@ -7,6 +7,11 @@ export declare const loader: {
     reset: () => void;
 };
 export declare const useLoader: () => typeof loader;
+export interface LoaderOverlayLabels {
+    /** Screen reader name for the overlay when no message was given. */
+    loading: string;
+}
+export declare const DEFAULT_LOADER_OVERLAY_LABELS: LoaderOverlayLabels;
 export interface LoaderOverlayProps {
     /**
      * Replaces the default themed spinner. Lets an app supply a Lottie or brand
@@ -19,6 +24,8 @@ export interface LoaderOverlayProps {
     showDelayMs?: number;
     /** Once visible, stay visible at least this long, so it never flickers. Default 400ms. */
     minVisibleMs?: number;
+    /** Copy the component draws itself; a partial object overrides only the keys given. */
+    labels?: Partial<LoaderOverlayLabels>;
     testID?: string;
 }
 export declare const LoaderOverlay: React.FC<LoaderOverlayProps>;

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

@@ -1,3 +1,3 @@
-export type { LoaderOverlayProps } from "./LoaderOverlay.js";
-export { LoaderOverlay, loader, useLoader } from "./LoaderOverlay.js";
+export type { LoaderOverlayLabels, LoaderOverlayProps } from "./LoaderOverlay.js";
+export { DEFAULT_LOADER_OVERLAY_LABELS, LoaderOverlay, loader, useLoader } from "./LoaderOverlay.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,7 @@
 import React from "react";
 import type { HapticType } from "../../utils/hapticUtils.js";
 import type { PlacementPreference } from "../../utils/placement.js";
-import type { MenuItem, MenuItems, MenuPresentation, MenuUnavailable } from "./menuModel.js";
+import type { MenuItem, MenuItems, MenuLabels, MenuPresentation, MenuUnavailable } from "./menuModel.js";
 export interface MenuProps {
     /** A flat list, or a list of up to three groups split by dividers. */
     items: MenuItems;
@@ -20,17 +20,15 @@ export interface MenuProps {
     presentation?: MenuPresentation;
     /** Default `'disable'`: unavailable items stay visible, dimmed and focusable. */
     unavailable?: MenuUnavailable;
-    /** Controlled open state. */
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
+    /** Controlled visibility. */
+    visible?: boolean;
+    onVisibleChange?: (visible: boolean) => void;
     /** Haptic on choosing an item. Pass false to disable; a HapticType to override. */
     haptic?: HapticType | false;
     /** Accessible name of the menu when there is no `title`. */
     accessibilityLabel?: string;
-    /** Accessible name of the tap-outside area. Default `'Close menu'`. */
-    closeLabel?: string;
-    /** Accessible name of a submenu's Back row. Default `'Back'`. */
-    backLabel?: string;
+    /** Accessible names of the tap-outside area (`close`, default 'Close menu') and of a submenu's Back row (`back`, default 'Back'). */
+    labels?: Partial<MenuLabels>;
     /** On the trigger wrapper; the open menu takes `<testID>-menu` and its scrim `<testID>-scrim`. */
     testID?: string;
 }

package/lib/typescript/module/components/Menu/MenuSurface.d.ts

@@ -2,7 +2,7 @@ import type React from "react";
 import type { LayoutRectangle } from "react-native";
 import type { HapticType } from "../../utils/hapticUtils.js";
 import type { PlacementPreference } from "../../utils/placement.js";
-import type { MenuItem, MenuItems, MenuPresentation, MenuUnavailable } from "./menuModel.js";
+import type { MenuItem, MenuItems, MenuLabels, MenuPresentation, MenuUnavailable } from "./menuModel.js";
 export interface MenuSurfaceProps {
     open: boolean;
     /** The trigger or the long-pressed view, in window coordinates. */
@@ -22,8 +22,7 @@ export interface MenuSurfaceProps {
     restoreFocusTo?: () => unknown;
     haptic?: HapticType | false;
     accessibilityLabel?: string;
-    closeLabel: string;
-    backLabel: string;
+    labels: MenuLabels;
     testID?: string;
 }
 export declare const MenuSurface: React.FC<MenuSurfaceProps>;

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

@@ -1,5 +1,6 @@
 export type { MenuProps } from "./Menu.js";
 export { default, Menu } from "./Menu.js";
-export type { MenuItem, MenuItems, MenuPresentation, MenuUnavailable } from "./menuModel.js";
+export type { MenuItem, MenuItems, MenuLabels, MenuPresentation, MenuUnavailable } from "./menuModel.js";
+export { DEFAULT_MENU_LABELS } from "./menuModel.js";
 export type { ContextMenuConfig } from "./useContextMenu.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/components/Menu/menuModel.d.ts

@@ -43,6 +43,12 @@ export type MenuUnavailable = "hide" | "disable";
  * seven items or any description, and the popover otherwise.
  */
 export type MenuPresentation = "auto" | "popover" | "sheet";
+/** Accessible names: `close` for the tap-outside area, `back` for a submenu's Back row. */
+export interface MenuLabels {
+    close: string;
+    back: string;
+}
+export declare const DEFAULT_MENU_LABELS: MenuLabels;
 export declare const MAX_GROUPS = 3;
 export declare const MAX_TOP_ACTIONS = 3;
 export declare const SHEET_ITEM_THRESHOLD = 7;

package/lib/typescript/module/components/Menu/useContextMenu.d.ts

@@ -2,7 +2,7 @@ import type React from "react";
 import type { AccessibilityActionEvent, AccessibilityActionInfo, PressableProps, View as RNView } from "react-native";
 import type { HapticType } from "../../utils/hapticUtils.js";
 import type { PlacementPreference } from "../../utils/placement.js";
-import type { MenuItem, MenuItems, MenuPresentation, MenuUnavailable } from "./menuModel.js";
+import type { MenuItem, MenuItems, MenuLabels, MenuPresentation, MenuUnavailable } from "./menuModel.js";
 /** The `contextMenu` prop of ListItem and Card. */
 export interface ContextMenuConfig {
     items: MenuItems;
@@ -21,12 +21,10 @@ export interface ContextMenuConfig {
     presentation?: MenuPresentation;
     /** Preferred side of the pressed view. Default `'bottom'`. */
     placement?: PlacementPreference;
-    onOpenChange?: (open: boolean) => void;
+    onVisibleChange?: (visible: boolean) => void;
     accessibilityLabel?: string;
-    /** Accessible name of the tap-outside area. Default `'Close menu'`. */
-    closeLabel?: string;
-    /** Accessible name of a submenu's Back row. Default `'Back'`. */
-    backLabel?: string;
+    /** Accessible names of the tap-outside area (`close`, default 'Close menu') and of a submenu's Back row (`back`, default 'Back'). */
+    labels?: Partial<MenuLabels>;
 }
 export interface UseContextMenuOptions {
     /** The host's `haptic` prop: `longPress` on open, `selection` on an action, unless overridden. */