@webority/mobile-ui 0.106.0 → 0.107.0

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

@@ -4,7 +4,7 @@
  * webority-ui's AppLogoPicker.
  *
  * Native picking stays in the app, exactly as in FilePicker: `sources` are
- * the same `FilePickerSource` adapters (`pick(): Promise<PickedFileInput[]>`),
+ * the same `FilePickerSource` adapters (`pick(): Promise<PickedFile[]>`),
  * so the library adds no dependency. One source launches straight away;
  * several open the shared OptionSheet. Removing the photo is a row in that
  * same sheet, not a control drawn over the photo, so a removable photo opens
@@ -14,13 +14,15 @@
  * once (optimistic) while the app uploads it and reflects the result back
  * through `value`.
  */
+import type { PickedFile } from "@webority/mobile-core/pickers";
 import type React from "react";
 import type { 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 { IconName, SlotIconRef } from "../AppIcon/index.js";
 import type { AvatarImageProps, AvatarTone } from "../Avatar/index.js";
-import type { FilePickerSource, PickedFileInput } from "../FilePicker/index.js";
-export type ProfilePickerSize = "sm" | "md" | "lg" | number;
+import type { FilePickerSource } from "../FilePicker/index.js";
+export type ProfilePickerSize = Extract<Size, "sm" | "md" | "lg">;
 export type ProfilePickerShape = "circle" | "rounded" | "square";
 /**
  * `stacked`: the photo alone, hint below. `inline`: a profile row, photo on
@@ -28,24 +30,23 @@ export type ProfilePickerShape = "circle" | "rounded" | "square";
  * identity block centred beneath the photo.
  */
 export type ProfilePickerLayout = "stacked" | "inline" | "profile";
-/** Theme colour of the camera badge; the same set StatusBadge and Chip use. */
-export type ProfilePickerTone = "primary" | "success" | "warning" | "danger" | "info" | "neutral";
 /**
  * Look of the camera badge. `solid`: the tone fills it, the icon in the
  * tone's ink. `soft`: a light tint of the tone, the icon in the tone. `outline`:
  * the page colour with a ring and icon in the tone. StatusBadge's three names.
  */
-export type ProfilePickerVariant = "solid" | "soft" | "outline";
+export type ProfilePickerVariant = Extract<FillVariant, "solid" | "soft" | "outline">;
 export interface ProfilePickerLabels {
-    /** A11y label of the photo button. Default 'Change profile photo'. */
-    pick?: string;
-    /** Label of the "Remove photo" row in the sheet. Default 'Remove photo'. */
-    remove?: string;
-    /** Source chooser sheet title. Default 'Change photo'. */
-    sheetTitle?: string;
-    errorTooLarge?: (maxSizeMB: number) => string;
-    errorWrongType?: string;
+    /** A11y label of the photo button. */
+    pick: string;
+    /** Label of the "Remove photo" row in the sheet. */
+    remove: string;
+    /** Source chooser sheet title. */
+    sheetTitle: string;
+    errorTooLarge: (maxSizeMB: number) => string;
+    errorWrongType: string;
 }
+export declare const DEFAULT_PROFILE_PICKER_LABELS: Readonly<ProfilePickerLabels>;
 export interface ProfilePickerProps {
     /** Current photo URL or local URI, or null for none. */
     value?: string | null;
@@ -54,7 +55,7 @@ export interface ProfilePickerProps {
     /** Native picking adapters (same shape as FilePicker's). One launches directly; several open a chooser. */
     sources: ReadonlyArray<FilePickerSource>;
     /** Receives the validated pick. Upload it and pass the resulting URL back as `value`. */
-    onPick?: (file: PickedFileInput) => void;
+    onPick?: (file: PickedFile) => void;
     /**
      * Clears the photo. Removal is a row at the end of the sheet: a just-picked
      * photo always offers it; an existing `value` offers it only when this is
@@ -69,7 +70,7 @@ export interface ProfilePickerProps {
     accept?: ReadonlyArray<string>;
     /** Size cap in MB, enforced when the source reports a size. */
     maxSizeMB?: number;
-    /** A preset (sm 72, md 120, lg 160) or an exact diameter. Default 'md'. */
+    /** A preset: sm 72, md 120, lg 160. Default 'md'. */
     size?: ProfilePickerSize;
     shape?: ProfilePickerShape;
     /** Badge icon at the bottom-right: a name, or `{ name, variant }` for another Iconsax style. Default 'camera'. */
@@ -78,7 +79,7 @@ export interface ProfilePickerProps {
      * Theme colour of the badge. Default `theme.settings.components["profile-picker"].defaultTone`,
      * else 'primary'.
      */
-    tone?: ProfilePickerTone;
+    tone?: Tone;
     /**
      * Look of the badge: `solid` (default), `soft` or `outline`. Default
      * `theme.settings.components["profile-picker"].defaultVariant`, else 'solid'.
@@ -103,12 +104,12 @@ export interface ProfilePickerProps {
     error?: React.ReactNode;
     layout?: ProfilePickerLayout;
     /** Bold primary text beside / beneath the photo (inline and profile layouts). */
-    title?: React.ReactNode;
+    title?: string;
     /** Muted secondary text beside / beneath the photo (inline and profile layouts). */
-    subtitle?: React.ReactNode;
+    subtitle?: string;
     /** Renders the photo, e.g. an authenticated image loader (see Avatar). */
     ImageComponent?: React.ComponentType<AvatarImageProps>;
-    labels?: ProfilePickerLabels;
+    labels?: Partial<ProfilePickerLabels>;
     /** Haptic on an accepted pick and on remove; errors use `notificationError`. Pass false to disable. */
     haptic?: HapticType | false;
     /** Called with the message of a rejected or failed pick. */

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

@@ -1,3 +1,3 @@
-export type { ProfilePickerLabels, ProfilePickerLayout, ProfilePickerProps, ProfilePickerShape, ProfilePickerSize, ProfilePickerTone, ProfilePickerVariant, } from "./ProfilePicker.js";
-export { default, ProfilePicker } from "./ProfilePicker.js";
+export type { ProfilePickerLabels, ProfilePickerLayout, ProfilePickerProps, ProfilePickerShape, ProfilePickerSize, ProfilePickerVariant, } from "./ProfilePicker.js";
+export { DEFAULT_PROFILE_PICKER_LABELS, default, ProfilePicker } from "./ProfilePicker.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,13 +1,17 @@
 import type { ReactNode } from "react";
 import type { View as RNView, StyleProp, ViewStyle } from "react-native";
 import type { GradientDefinition } from "../../theme/types.js";
-export type ProgressBarTone = "primary" | "success" | "warning" | "danger";
+import type { Tone } from "../../types/vocabulary.js";
+export interface ProgressBarLabels {
+    loading: string;
+}
+export declare const DEFAULT_PROGRESS_BAR_LABELS: Readonly<ProgressBarLabels>;
 export interface ProgressBarSegment {
     /** Fraction of the full track (0–1). */
     value: number;
     /** Explicit colour; falls back to `tone`. */
     color?: string;
-    tone?: ProgressBarTone;
+    tone?: Tone;
 }
 export interface ProgressBarProps {
     progress?: number;
@@ -18,7 +22,7 @@ export interface ProgressBarProps {
     indeterminate?: boolean;
     height?: number;
     radius?: number;
-    tone?: ProgressBarTone;
+    tone?: Tone;
     trackColor?: string;
     barColor?: string;
     /** Gradient fill for the determinate bar — a `GradientDefinition` or a theme gradient token name. */
@@ -30,6 +34,7 @@ export interface ProgressBarProps {
     containerStyle?: StyleProp<ViewStyle>;
     barStyle?: StyleProp<ViewStyle>;
     accessibilityLabel?: string;
+    labels?: Partial<ProgressBarLabels>;
     testID?: string;
 }
 declare const ProgressBar: import("react").ForwardRefExoticComponent<ProgressBarProps & import("react").RefAttributes<RNView>>;

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

@@ -1,3 +1,3 @@
-export type { ProgressBarProps, ProgressBarSegment, ProgressBarTone } from "./ProgressBar.js";
-export { default, ProgressBar } from "./ProgressBar.js";
+export type { ProgressBarLabels, ProgressBarProps, ProgressBarSegment } from "./ProgressBar.js";
+export { DEFAULT_PROGRESS_BAR_LABELS, default, ProgressBar } from "./ProgressBar.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/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.js";
 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/module/components/ProgressRing/index.d.ts

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

package/lib/typescript/module/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.js";
 import type { HapticType } from "../../utils/hapticUtils.js";
-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/module/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/module/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.js";
 import type { HapticType } from "../../utils/hapticUtils.js";
-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/module/components/Rating/index.d.ts

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

package/lib/typescript/module/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/index.js";
+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/module/components/Repeater/index.d.ts

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

package/lib/typescript/module/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/index.js";
 import type { MarkdownAction } from "./markdownActions.js";
+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/module/components/RichTextEditor/index.d.ts

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

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

@@ -9,6 +9,8 @@ import type { HapticType } from "../../utils/hapticUtils.js";
  */
 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/module/components/ScannerOverlay/index.d.ts

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

package/lib/typescript/module/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/index.js";
+import type { FlatListProps, NativeScrollEvent, NativeSyntheticEvent, ScrollView, StyleProp, ViewStyle } from "react-native";
+import { FlatList } from "react-native";
+import type { AppBarAction } from "../AppBar/index.js";
+import type { EmptyStateProps } from "../EmptyState/index.js";
 import type { SafeAreaEdge } from "../KeyboardAwareScrollView/KeyboardAwareScrollView.js";
+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/module/components/Screen/index.d.ts

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

package/lib/typescript/module/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.js";
 import type { HapticType } from "../../utils/hapticUtils.js";
 import type { SlotIcon } from "../AppIcon/slotIcon.js";
 import type { SearchScope, SearchSuggestion } from "./SearchPanel.js";
 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/module/components/SearchBar/SearchPanel.d.ts

@@ -1,6 +1,7 @@
 import type React from "react";
 import type { HapticType } from "../../utils/hapticUtils.js";
 import type { SlotIcon } from "../AppIcon/slotIcon.js";
+import type { SearchBarLabels } from "./SearchBar.js";
 /** 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/module/components/SearchBar/index.d.ts

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

package/lib/typescript/module/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/module/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/module/components/SectionHeader/index.d.ts

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

package/lib/typescript/module/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.js";
+import type { Size, Tone } from "../../types/vocabulary.js";
 import type { HapticType } from "../../utils/index.js";
 import type { SlotIcon, SlotIconState } from "../AppIcon/slotIcon.js";
-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;