@webority/mobile-ui 0.106.0 → 0.107.0

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

@@ -12,7 +12,7 @@
  */
 import type React from "react";
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
-export type ProgressRingTone = "primary" | "success" | "warning" | "danger";
+import type { Tone } from "../../types/vocabulary";
 export interface ProgressRingProps {
     /** Fraction of the ring filled, 0 to 1, clamped. Default `0`. */
     progress?: number;
@@ -21,7 +21,7 @@ export interface ProgressRingProps {
     /** Stroke width of the track and the fill. Default 4. */
     strokeWidth?: number;
     /** Fill colour when no `ringColor` is set. Default `'primary'`. */
-    tone?: ProgressRingTone;
+    tone?: Tone;
     /** Track colour override. Default the surface-disabled colour. */
     trackColor?: string;
     /** Fill colour override; wins over `tone`. */

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

@@ -1,3 +1,3 @@
-export type { ProgressRingProps, ProgressRingTone } from "./ProgressRing";
+export type { ProgressRingProps } from "./ProgressRing";
 export { default, ProgressRing } from "./ProgressRing";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,8 +1,9 @@
 import type { ReactNode } 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 RadioSize = "sm" | "md" | "lg";
-export type RadioTone = "primary" | "success" | "warning" | "danger";
+export type RadioSize = Extract<Size, "sm" | "md" | "lg">;
+export type RadioTone = Tone;
 export type RadioValue = string | number;
 export interface RadioGroupContextValue {
     selectedValue: RadioValue | undefined;
@@ -23,13 +24,15 @@ export interface RadioProps extends Omit<PressableProps, "style" | "children" |
      * explicit `accessibilityLabel` (the radio's screen-reader name).
      */
     label?: ReactNode;
-    /** Secondary line under the label. A string or a node; a node description adds nothing to the accessibility hint. */
-    description?: ReactNode;
+    /** 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 empty ring 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 empty ring in the error colour.
+     * `true` shows the error state without a message.
      */
-    error?: ReactNode;
+    error?: string | boolean;
     size?: RadioSize;
     tone?: RadioTone;
     accessibilityLabel?: string;

package/lib/typescript/commonjs/components/Radio/RadioGroup.d.ts

@@ -8,10 +8,10 @@ export interface RadioGroupProps {
     children: React.ReactNode;
     disabled?: boolean;
     /**
-     * One error line under the group, and every radio's empty ring in the error colour. A string or
-     * a node; `true` shows the error state without a message.
+     * One error line under the group, and every radio's empty ring in the error colour. `true` shows
+     * the error state without a message.
      */
-    error?: React.ReactNode;
+    error?: string | boolean;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     testID?: string;

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

@@ -1,8 +1,13 @@
 import type React from "react";
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
-export type RatingTone = "primary" | "warning";
-export type RatingSize = "sm" | "md" | "lg" | number;
+export type RatingTone = Tone;
+export type RatingSize = Extract<Size, "sm" | "md" | "lg">;
+export interface RatingLabels {
+    value: (value: number, max: number) => string;
+}
+export declare const DEFAULT_RATING_LABELS: Readonly<RatingLabels>;
 export interface RatingProps {
     value: number;
     onChange?: (value: number) => void;
@@ -23,6 +28,7 @@ export interface RatingProps {
      * to override the default.
      */
     haptic?: HapticType | false;
+    labels?: Partial<RatingLabels>;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     containerStyle?: StyleProp<ViewStyle>;

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

@@ -1,3 +1,3 @@
-export type { RatingProps, RatingSize, RatingTone } from "./Rating";
-export { default, Rating } from "./Rating";
+export type { RatingLabels, RatingProps, RatingSize, RatingTone } from "./Rating";
+export { DEFAULT_RATING_LABELS, default, Rating } from "./Rating";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +1,18 @@
 import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils";
+export interface RepeaterLabels {
+    add: string;
+    /** Shown only when the list is empty and this is a non-empty string. */
+    empty: string;
+    /** Per-row heading, e.g. `(i) => \`Line item ${i + 1}\``. Null draws no heading. */
+    row: ((index: number) => string) | null;
+    /** Accessible name of a row's remove button. */
+    removeRow: (name: string) => string;
+    /** Row name used for the remove button when `row` is null. */
+    fallbackRow: (index: number) => string;
+}
+export declare const DEFAULT_REPEATER_LABELS: Readonly<RepeaterLabels>;
 export interface RepeaterRenderArgs<T> {
     item: T;
     index: number;
@@ -17,12 +29,11 @@ export interface RepeaterProps<T> {
     /** Builds a blank row. Called on add — must return a NEW object each time. */
     createRow: () => T;
     renderRow: (args: RepeaterRenderArgs<T>) => React.ReactNode;
-    addLabel?: string;
-    /** Per-row heading, e.g. `(i) => \`Line item ${i + 1}\``. */
-    rowLabel?: (index: number) => string;
+    /** Copy for the add button, the empty text, the per-row heading (`labels.row`) and the remove button. */
+    labels?: Partial<RepeaterLabels>;
     /**
      * Draws your own header above each row's content, in place of the built-in
-     * one (the `rowLabel` heading and the remove button), so a card-style row can
+     * one (the `labels.row` heading and the remove button), so a card-style row can
      * carry a title, a summary and its own remove control. Call `remove()` from
      * it; it does nothing when `canRemove` is false.
      */
@@ -40,7 +51,6 @@ export interface RepeaterProps<T> {
     maxRows?: number;
     /** Remove affordance. Default true. */
     removable?: boolean;
-    emptyText?: string;
     disabled?: boolean;
     haptic?: HapticType | false;
     style?: StyleProp<ViewStyle>;
@@ -52,6 +62,6 @@ export interface RepeaterProps<T> {
  * re-deriving splice/map logic, and keeps the min/max rules in one place where
  * they can't disagree between the add button and the remove button.
  */
-export declare const Repeater: <T>({ value, onChange, createRow, renderRow, addLabel, rowLabel, renderRowHeader, onRemove, minRows, maxRows, removable, emptyText, disabled, haptic, style, testID, }: RepeaterProps<T>) => React.ReactElement;
+export declare const Repeater: <T>({ value, onChange, createRow, renderRow, labels: labelsProp, renderRowHeader, onRemove, minRows, maxRows, removable, disabled, haptic, style, testID, }: RepeaterProps<T>) => React.ReactElement;
 export default Repeater;
 //# sourceMappingURL=Repeater.d.ts.map

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

@@ -1,3 +1,3 @@
-export type { RepeaterProps, RepeaterRenderArgs } from "./Repeater";
-export { default, Repeater } from "./Repeater";
+export type { RepeaterLabels, RepeaterProps, RepeaterRenderArgs } from "./Repeater";
+export { DEFAULT_REPEATER_LABELS, default, Repeater } from "./Repeater";
 //# sourceMappingURL=index.d.ts.map

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

@@ -2,6 +2,8 @@ import type React from "react";
 import type { TextInput as RNTextInput, StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils";
 import type { MarkdownAction } from "./markdownActions";
+export type RichTextEditorLabels = Record<MarkdownAction, string>;
+export declare const DEFAULT_RICH_TEXT_EDITOR_LABELS: Readonly<RichTextEditorLabels>;
 export interface RichTextEditorProps {
     /** The markdown source. Controlled, like any other input. */
     value?: string;
@@ -27,6 +29,8 @@ export interface RichTextEditorProps {
     accessibilityLabel?: string;
     /** Haptic feedback for toolbar presses. Pass false to disable; pass a HapticType to override. */
     haptic?: HapticType | false;
+    /** Spoken and tooltip names of the toolbar actions. Merged over the English defaults. */
+    labels?: Partial<RichTextEditorLabels>;
     /** Style for the outer bordered box. */
     style?: StyleProp<ViewStyle>;
     /** Style for the toolbar row. */

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

@@ -1,5 +1,5 @@
 export type { BlockMarkdownAction, EditorSelection, EditorState, InlineMarkdownAction, MarkdownAction, } from "./markdownActions";
 export { applyMarkdownAction } from "./markdownActions";
-export type { RichTextEditorProps } from "./RichTextEditor";
-export { RichTextEditor } from "./RichTextEditor";
+export type { RichTextEditorLabels, RichTextEditorProps } from "./RichTextEditor";
+export { DEFAULT_RICH_TEXT_EDITOR_LABELS, RichTextEditor } from "./RichTextEditor";
 //# sourceMappingURL=index.d.ts.map

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

@@ -9,6 +9,8 @@ import type { HapticType } from "../../utils/hapticUtils";
  */
 export type ScannerOverlayState = "scanning" | "found" | "invalid" | "noPermission" | "noCamera";
 export interface ScannerOverlayLabels {
+    /** Default 'Point the camera at the code'. The line under the frame while scanning. */
+    hint: string;
     /** Default 'Code found'. Spoken and shown when `state` is `found`. */
     found: string;
     /** Default 'This code cannot be used. Try another.' Shown when `state` is `invalid`. */
@@ -41,8 +43,8 @@ export interface ScannerOverlayProps {
     children?: React.ReactNode;
     /** Default `'scanning'`. */
     state?: ScannerOverlayState;
-    /** The line under the frame while scanning. Default 'Point the camera at the code'. */
-    hint?: string;
+    /** The line under the frame while scanning. Default from `labels.hint`. */
+    helperText?: string;
     /** Replaces any of the default texts. */
     labels?: Partial<ScannerOverlayLabels>;
     /** Whether the torch is on. Default `false`. */
@@ -68,6 +70,7 @@ export interface ScannerOverlayProps {
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
+export declare const DEFAULT_SCANNER_OVERLAY_LABELS: Readonly<ScannerOverlayLabels>;
 declare const ScannerOverlay: React.ForwardRefExoticComponent<ScannerOverlayProps & React.RefAttributes<RNView>>;
 export { ScannerOverlay };
 export default ScannerOverlay;

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

@@ -1,3 +1,3 @@
 export type { ScannerOverlayLabels, ScannerOverlayProps, ScannerOverlayState, } from "./ScannerOverlay";
-export { default, ScannerOverlay } from "./ScannerOverlay";
+export { DEFAULT_SCANNER_OVERLAY_LABELS, default, ScannerOverlay } from "./ScannerOverlay";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,27 @@
+import type { PagedListPaging } from "@webority/mobile-core/query";
 import type React from "react";
-import type { FlatListProps, StyleProp, ViewStyle } from "react-native";
-import type { AppBarRightAction } from "../AppBar";
+import type { FlatListProps, NativeScrollEvent, NativeSyntheticEvent, ScrollView, StyleProp, ViewStyle } from "react-native";
+import { FlatList } from "react-native";
+import type { AppBarAction } from "../AppBar";
+import type { EmptyStateProps } from "../EmptyState";
 import type { SafeAreaEdge } from "../KeyboardAwareScrollView/KeyboardAwareScrollView";
+export interface ScreenListState {
+    /** First load: draws `skeleton` (or a Spinner) instead of the list. */
+    loading: boolean;
+    /** A failed first load: drawn through AsyncBlock's error state with `onRetry`. */
+    error?: unknown;
+    /** Title of the first-load error state; AsyncBlock's default title when unset. */
+    errorTitle?: string;
+    onRetry?: () => void;
+    /** Drawn when the loaded list has no items; nothing is drawn when unset. */
+    empty?: EmptyStateProps;
+    skeleton?: React.ReactNode;
+}
+export interface ScreenListProps<ItemT> extends Omit<FlatListProps<ItemT>, "onScroll" | "refreshControl" | "ListEmptyComponent"> {
+    state?: ScreenListState;
+    /** From usePagedList or pagingFromInfiniteQuery: the screen draws PagedListFooter and calls loadMore on end reached. */
+    paging?: PagedListPaging;
+}
 export interface ScreenProps<ItemT = unknown> {
     title?: string;
     subtitle?: string;
@@ -9,31 +29,34 @@ export interface ScreenProps<ItemT = unknown> {
     largeTitle?: boolean;
     /** Shows the back chevron; runs on press and on Android Back. */
     onBack?: () => void;
-    rightActions?: AppBarRightAction[];
+    rightActions?: AppBarAction[];
     leading?: React.ReactNode;
+    /** Scroll and fixed modes: the content. List mode: overlays (sheets, dialogs) drawn above the list. */
     children?: React.ReactNode;
     onRefresh?: () => unknown;
     refreshing?: boolean;
     /** Pinned under the content, above the keyboard. */
     footer?: React.ReactNode;
-    footerStyle?: StyleProp<ViewStyle>;
     /** Default true; false renders a plain View. */
     scroll?: boolean;
-    /** Virtualised list mode; its scroll drives the title collapse. */
-    list?: Omit<FlatListProps<ItemT>, "onScroll" | "refreshControl">;
-    /** Safe-area edges padded. Default top and bottom; a tab screen passes top only. */
+    list?: ScreenListProps<ItemT>;
+    /** Safe-area edges padded. Default top and bottom. */
     edges?: SafeAreaEdge[];
+    /** Extra space under the content and the footer, for a tab bar drawn over the screen. Default 0. */
+    bottomInset?: number;
     /** Default true. */
     keyboardToolbar?: boolean;
+    scrollRef?: React.Ref<ScrollView | FlatList<ItemT>>;
+    onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
     contentContainerStyle?: StyleProp<ViewStyle>;
-    style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * The page shell: safe area, app bar with a large title that collapses as the
  * content scrolls, a keyboard-aware scroll view (or a virtualised list), pull to
- * refresh, a pinned footer and the keyboard toolbar. The app keeps its own back
- * guard (`usePreventRemove`) and passes `onBack`; the screen never navigates.
+ * refresh, a pinned footer and the keyboard toolbar. The screen never navigates:
+ * it calls `onBack`; `NavigationScreen` from `@webority/mobile-ui/navigation` binds
+ * it to react-navigation and holds the unsaved-changes guard.
  */
 export declare function Screen<ItemT = unknown>(props: ScreenProps<ItemT>): React.ReactElement;
 //# sourceMappingURL=Screen.d.ts.map

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

@@ -1,3 +1,3 @@
-export type { ScreenProps } from "./Screen";
+export type { ScreenListProps, ScreenListState, ScreenProps } from "./Screen";
 export { Screen } from "./Screen";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,12 +1,26 @@
 import type { StyleProp, TextInputProps, TextStyle, ViewStyle } from "react-native";
 import { TextInput } from "react-native";
+import type { FieldVariant, Size } from "../../types/vocabulary";
 import type { HapticType } from "../../utils/hapticUtils";
 import type { SlotIcon } from "../AppIcon/slotIcon";
 import type { SearchScope, SearchSuggestion } from "./SearchPanel";
 export type { SearchScope, SearchSuggestion };
-export type SearchBarSize = "sm" | "md" | "lg";
-export type SearchBarVariant = "filled" | "outlined" | "underline";
 export type SearchBarLabelMode = "top" | "float";
+export interface SearchBarLabels {
+    placeholder: string;
+    recents: string;
+    clearAll: string;
+    clearAllRecents: string;
+    searchAgain: string;
+    removeRecent: (text: string) => string;
+    scope: string;
+    clearSearch: string;
+    searching: (label: string) => string;
+    suggestionCount: (count: number) => string;
+    removed: (text: string) => string;
+    recentsCleared: string;
+}
+export declare const DEFAULT_SEARCH_BAR_LABELS: Readonly<SearchBarLabels>;
 export interface SearchBarProps extends Omit<TextInputProps, "style" | "value" | "onChangeText"> {
     /** Optional label: static above the field (`labelMode="top"`) or floating from inside it. */
     label?: string;
@@ -28,8 +42,8 @@ export interface SearchBarProps extends Omit<TextInputProps, "style" | "value" |
      */
     leftIcon?: SlotIcon;
     debounceMs?: number;
-    size?: SearchBarSize;
-    variant?: SearchBarVariant;
+    size?: Extract<Size, "sm" | "md" | "lg">;
+    variant?: FieldVariant;
     /**
      * Corner radius. Default: the theme's `components["search-bar"].<size>.radius`
      * (the pill). Ignored on `underline`, which is always square.
@@ -48,14 +62,12 @@ export interface SearchBarProps extends Omit<TextInputProps, "style" | "value" |
      * them; `useRecentSearches` does it through mobile-core storage.
      */
     recents?: string[];
-    /** Heading above the recent searches. Default `'Recent searches'`. */
-    recentsTitle?: string;
     /** Most recent searches drawn. Default 8. */
     maxRecents?: number;
     /** A recent search was tapped. The bar blurs the field; the app sets the text and runs the search. */
     onSelectRecent?: (text: string) => void;
     /** Shows a remove button on each recent search. */
-    onRemoveRecent?: (text: string) => void;
+    onRemove?: (text: string) => void;
     /** Shows a "Clear all" button above the recent searches. */
     onClearRecents?: () => void;
     /**
@@ -67,9 +79,11 @@ export interface SearchBarProps extends Omit<TextInputProps, "style" | "value" |
     /** Most suggestions drawn. Default 8. */
     maxSuggestions?: number;
     /** A suggestion was tapped. The bar blurs the field; the app sets the text and runs the search. */
-    onSelectSuggestion?: (suggestion: SearchSuggestion) => void;
+    onSelect?: (suggestion: SearchSuggestion) => void;
     /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
     haptic?: HapticType | false;
+    /** Copy for the bar's labels and announcements. A key left out keeps its English default. */
+    labels?: Partial<SearchBarLabels>;
     style?: StyleProp<ViewStyle>;
     /** Style applied to the search text, after the library's own size, colour and font. */
     inputStyle?: StyleProp<TextStyle>;

package/lib/typescript/commonjs/components/SearchBar/SearchPanel.d.ts

@@ -1,6 +1,7 @@
 import type React from "react";
 import type { HapticType } from "../../utils/hapticUtils";
 import type { SlotIcon } from "../AppIcon/slotIcon";
+import type { SearchBarLabels } from "./SearchBar";
 /** A named filter under the field, such as All, People or Files. */
 export interface SearchScope {
     label: string;
@@ -28,12 +29,13 @@ interface ScopeBarProps {
     scope: string;
     disabled: boolean;
     haptic?: HapticType | false;
+    labels: SearchBarLabels;
     onChange: (value: string) => void;
 }
 export declare const SearchScopeBar: React.FC<ScopeBarProps>;
 interface RecentsProps extends HoldProps {
     recents: string[];
-    title: string;
+    labels: SearchBarLabels;
     onSelect: (text: string) => void;
     onRemove?: (text: string) => void;
     onClear?: () => void;

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

@@ -1,5 +1,5 @@
-export type { SearchBarProps, SearchBarSize, SearchBarVariant } from "./SearchBar";
-export { default, SearchBar } from "./SearchBar";
+export type { SearchBarLabels, SearchBarProps } from "./SearchBar";
+export { DEFAULT_SEARCH_BAR_LABELS, default, SearchBar } from "./SearchBar";
 export type { SearchScope, SearchSuggestion } from "./SearchPanel";
 export type { UseRecentSearchesOptions, UseRecentSearchesResult } from "./useRecentSearches";
 export { useRecentSearches } from "./useRecentSearches";

package/lib/typescript/commonjs/components/SearchBar/useRecentSearches.d.ts

@@ -17,7 +17,7 @@ export interface UseRecentSearchesResult {
  * The device-kept list behind `SearchBar`'s recent searches, saved through
  * mobile-core `Storage` under `storageKey`. Give each search screen its own
  * key. `SearchBar` only draws what it is handed; wire this hook's `recents`,
- * `remove` and `clear` to its `recents`, `onRemoveRecent` and `onClearRecents`,
+ * `remove` and `clear` to its `recents`, `onRemove` and `onClearRecents`,
  * and call `add` when a search is submitted.
  */
 export declare const useRecentSearches: (storageKey: string, options?: UseRecentSearchesOptions) => UseRecentSearchesResult;

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

@@ -1,6 +1,10 @@
 import type React from "react";
 import type { StyleProp, TextStyle } from "react-native";
 export type SectionHeaderVariant = "title" | "caps" | "sub";
+export interface SectionHeaderLabels {
+    required: (heading: string) => string;
+}
+export declare const DEFAULT_SECTION_HEADER_LABELS: Readonly<SectionHeaderLabels>;
 export interface SectionHeaderProps {
     children?: React.ReactNode;
     /** 'title' is the heading, 'caps' the quieter uppercase label, 'sub' a heading inside a card. */
@@ -9,6 +13,7 @@ export interface SectionHeaderProps {
     flush?: boolean;
     /** Draws the required marker after the heading and announces the heading as required. */
     required?: boolean;
+    labels?: Partial<SectionHeaderLabels>;
     style?: StyleProp<TextStyle>;
     testID?: string;
 }

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

@@ -1,3 +1,3 @@
-export type { SectionHeaderProps, SectionHeaderVariant } from "./SectionHeader";
-export { default, SectionHeader } from "./SectionHeader";
+export type { SectionHeaderLabels, SectionHeaderProps, SectionHeaderVariant } from "./SectionHeader";
+export { DEFAULT_SECTION_HEADER_LABELS, default, SectionHeader } from "./SectionHeader";
 //# sourceMappingURL=index.d.ts.map

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

@@ -15,10 +15,11 @@
 import type { ReactNode } from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { RadiusName } from "../../theme/types";
+import type { Size, Tone } from "../../types/vocabulary";
 import type { HapticType } from "../../utils";
 import type { SlotIcon, SlotIconState } from "../AppIcon/slotIcon";
-export type SegmentedControlSize = "sm" | "md" | "lg";
-export type SegmentedControlTone = "primary" | "neutral";
+export type SegmentedControlSize = Extract<Size, "sm" | "md" | "lg">;
+export type SegmentedControlTone = Tone;
 /** The same three looks as `Tabs`; `segmented` is the filled track with a thumb. */
 export type SegmentedControlVariant = "underline" | "pills" | "segmented";
 export type SegmentValue = string | number;

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

@@ -8,18 +8,26 @@
  */
 import type React from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { FieldVariant, Size } from "../../types/vocabulary";
 import type { HapticType } from "../../utils";
 import type { SlotIcon } from "../AppIcon/slotIcon";
 import type { SelectOption, SelectValue } from "../OptionSheet/OptionSheet";
-export type SelectSize = "sm" | "md" | "lg";
-export type SelectVariant = "outlined" | "filled" | "underline";
+export type SelectSize = Extract<Size, "sm" | "md" | "lg">;
 export type { SelectOption, SelectValue };
+export interface SelectLabels {
+    placeholder: string;
+    noSelection: string;
+    selected: (summary: string) => string;
+    fallbackName: string;
+    sheetName: string;
+}
+export declare const DEFAULT_SELECT_LABELS: SelectLabels;
 interface BaseSelectProps<T = SelectOption> {
     /**
      * Options to render. Default shape is `SelectOption` (`{ label, value, ... }`)
      * — for that shape no accessors are needed. To use a different option shape
      * (e.g. `{ id, name }` from a domain model), pass `getOptionLabel` /
-     * `getOptionValue` (and optionally `getOptionDisabled`/`getOptionDescription`/
+     * `getOptionValue` (and optionally `isOptionDisabled`/`getOptionDescription`/
      * `getOptionIcon`) so Select can read it without per-call-site mapping.
      */
     options: ReadonlyArray<T>;
@@ -28,20 +36,22 @@ interface BaseSelectProps<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`. */
     getOptionIcon?: (option: T) => React.ReactNode;
     placeholder?: string;
     /** Called with `true` when the option sheet opens and `false` when it closes. */
-    onOpenChange?: (open: boolean) => void;
+    onVisibleChange?: (visible: boolean) => void;
     searchable?: boolean;
     /**
      * Haptic feedback for interactions. Pass false to disable; pass a HapticType
      * to override the default.
      */
     haptic?: HapticType | false;
+    /** Copy the component shows. Unset keys keep `DEFAULT_SELECT_LABELS`. */
+    labels?: Partial<SelectLabels>;
     /**
      * A string, or a node for a symbol with a subscript. A node label needs an
      * explicit `accessibilityLabel` (the trigger's screen-reader name); the
@@ -76,7 +86,7 @@ interface BaseSelectProps<T = SelectOption> {
     /** Hint under the field, shown while there is no `error`. A string or a node. */
     helperText?: React.ReactNode;
     /**
-     * Fixed text drawn before the value: `'₹'`, `'+91'`. The same prop and look
+     * Fixed text drawn before the value: `'$'`, `'+1'`. The same prop and look
      * as Input's `prefix`, in the placeholder colour. Sits after `leftIcon`. A
      * node (a symbol with a subscript) sits in the same Text with the same gap,
      * so its base and subscript take that size and colour.
@@ -93,9 +103,9 @@ interface BaseSelectProps<T = SelectOption> {
     /**
      * Controls the trigger field's fill + border treatment. Resolution chain:
      * caller prop → `settings.components.select.defaultVariant` → `settings.components.field.defaultVariant`
-     * → 'outlined'.
+     * → 'outline'.
      */
-    variant?: SelectVariant;
+    variant?: FieldVariant;
     /**
      * Slot rendered to the left of the trigger text. Mirrors Input's `leftIcon`:
      * an icon name (`leftIcon="user"`) is drawn in the field palette's icon

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

@@ -1,3 +1,3 @@
-export type { MultiSelectProps, SelectOption, SelectProps, SelectSize, SelectValue, SingleSelectProps } from "./Select";
-export { default, Select } from "./Select";
+export type { MultiSelectProps, SelectLabels, SelectOption, SelectProps, SelectSize, SelectValue, SingleSelectProps } from "./Select";
+export { DEFAULT_SELECT_LABELS, default, Select } from "./Select";
 //# sourceMappingURL=index.d.ts.map

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

@@ -35,6 +35,7 @@ export interface SignaturePadLabels {
     /** Closes the full-screen pad and discards its strokes. */
     close: string;
 }
+export declare const DEFAULT_SIGNATURE_PAD_LABELS: Readonly<SignaturePadLabels>;
 export interface SignaturePadRef {
     /**
      * Writes the signature as a PNG on an opaque ground and answers its uri: a file in the app's
@@ -69,9 +70,9 @@ export interface SignaturePadProps {
     onEmptyChange?: (isEmpty: boolean) => void;
     /** Offers the type-your-name path. Turn it off only where a typed signature is not acceptable. Default `true`. */
     allowTyped?: boolean;
-    /** The signer's name for the line under the pad ("Signed by Priya Raghavan, 11-Oct-2026, 3:42 PM"). */
+    /** The signer's name for the line under the pad ("Signed by Alex Morgan, 11-Oct-2026, 3:42 PM"). */
     signedBy?: string;
-    /** When it was signed, shown in IST. Defaults to the time of the last change made in this session; a kept signature shows no time. */
+    /** When it was signed, shown in the time zone set through `configureFormatters`. Defaults to the time of the last change made in this session; a kept signature shows no time. */
     signedAt?: Date | string | number;
     /** Pad height in dp. Default 180. */
     height?: number;

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

@@ -1,4 +1,4 @@
 export type { SignatureMode, SignaturePadLabels, SignaturePadProps, SignaturePadRef, } from "./SignaturePad";
-export { SignaturePad } from "./SignaturePad";
+export { DEFAULT_SIGNATURE_PAD_LABELS, SignaturePad } from "./SignaturePad";
 export type { SignaturePoint, SignatureStroke } from "./signatureGeometry";
 //# sourceMappingURL=index.d.ts.map

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

@@ -26,6 +26,11 @@ import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
 import type { RadiusName } from "../../theme/types";
 import type { SkeletonColors } from "./SkeletonProvider";
+export interface SkeletonLabels {
+    /** Announced by screen readers while the placeholder shows. */
+    loading: string;
+}
+export declare const DEFAULT_SKELETON_LABELS: Readonly<SkeletonLabels>;
 /** Animation pattern. */
 export type SkeletonVariant = "shimmer" | "pulse" | "none";
 /** Sweep speed for the shimmer band. Ignored for pulse / none. */
@@ -60,6 +65,8 @@ export interface SkeletonProps {
      * prefer `<SkeletonProvider colors={...}>` for app-wide overrides.
      */
     colors?: SkeletonColors;
+    /** Screen-reader copy, merged over the English defaults. */
+    labels?: Partial<SkeletonLabels>;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }

package/lib/typescript/commonjs/components/Skeleton/SkeletonContent.d.ts

@@ -48,7 +48,7 @@
 import type { ComponentType, ReactNode } from "react";
 import React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
-import type { SkeletonSpeed, SkeletonVariant } from "./Skeleton";
+import type { SkeletonLabels, SkeletonSpeed, SkeletonVariant } from "./Skeleton";
 import type { SkeletonColors } from "./SkeletonProvider";
 /**
  * Components that ship their own placeholder shape declare this static. The
@@ -88,6 +88,8 @@ export interface SkeletonContentProps {
      * directly on the placeholder JSX instead.
      */
     colors?: SkeletonColors;
+    /** Screen-reader copy, merged over the English defaults. */
+    labels?: Partial<SkeletonLabels>;
     /**
      * Duration in ms for the load→content cross-fade. Default `300`. Set `0`
      * to disable. Per-instance overrides the provider's `fadeDuration`.

package/lib/typescript/commonjs/components/Skeleton/SkeletonList.d.ts

@@ -1,6 +1,6 @@
 import type { ReactElement, ReactNode } from "react";
 import type { FlatListProps, StyleProp, ViewStyle } from "react-native";
-import type { SkeletonSpeed, SkeletonVariant } from "./Skeleton";
+import type { SkeletonLabels, SkeletonSpeed, SkeletonVariant } from "./Skeleton";
 import type { SkeletonColors } from "./SkeletonProvider";
 export interface SkeletonListProps<ItemT> extends Omit<FlatListProps<ItemT>, "data" | "renderItem"> {
     /** Whether the list is in its initial loading state. */
@@ -22,6 +22,8 @@ export interface SkeletonListProps<ItemT> extends Omit<FlatListProps<ItemT>, "da
     speed?: SkeletonSpeed;
     /** Colour override forwarded to the placeholder skeletons. */
     colors?: SkeletonColors;
+    /** Screen-reader copy for the placeholder state, merged over the English defaults. */
+    labels?: Partial<SkeletonLabels>;
     /** Style applied to the wrapper View around the placeholders. */
     placeholderContainerStyle?: StyleProp<ViewStyle>;
     testID?: string;