@webority/mobile-ui 0.106.0 → 0.107.0

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

@@ -2,14 +2,15 @@ export { PHONE_CHROME_INSETS } from "./canvasKit";
 export * from "./components";
 export type { AppIconName, AppIconProps, AppIconSize, CuratedIconName, IconName, IconsaxShadowedName, IconVariant, SlotIcon, SlotIconRef, SlotIconState, SlotNode, } from "./components/AppIcon";
 export { APP_ICON_SIZES, AppIcon, CURATED_ICON_NAMES, defaultIcons, ICON_NAMES, ICONSAX_SUFFIX, renderSlotIcon, } from "./components/AppIcon";
-export type { FieldArrayApi, FieldInputProps, FieldRules, FieldState, FocusableNode, FormApi, FormCompletion, FormConfig, FormErrors, FormTouched, FormValidateFn, FormValues, HookFieldProps, HookFormFieldProps, SubmitHelpers, UseFormCompletionOptions, ValidateOn, ValidationResult, ValidationRule, ValidationSchema, } from "./form";
-export { deletePath, Form, getPath, HookFormField, isFieldFilled, rules, setPath, useField, useFieldArray, useForm, useFormCompletion, useFormContext, useHookFormField, useOptionalFormContext, } from "./form";
+export type { FormCompletion, HookFieldProps, HookFormFieldProps, UseFormCompletionOptions } from "./form";
+export { deletePath, getPath, HookFormField, isFieldFilled, setPath, useFormCompletion, useHookFormField, } from "./form";
 export type { FieldChain, FieldChainProps, MotionDurationKey, PresenceMotion, PressAnimationPreset, ScrollDirection, UseControllableStateOptions, UsePressAnimationOptions, UsePressAnimationResult, UseRefreshControlLabels, UseRefreshControlOptions, UseRefreshControlResult, UseScrollDirectionOptions, UseScrollDirectionResult, UseToggleResult, } from "./hooks";
 export { FLICK_TOLERANCE, PRESENCE_REDUCE_MOTION, PRESS_ANIMATION_PRESETS, useControllableState, useDebounce, useFieldChain, useFlickGuard, usePresenceMotion, usePressAnimation, useReducedMotion, useRefreshControl, useScrollDirection, useToggle, } from "./hooks";
 export type { NetworkStatusBannerProps } from "./network";
 export { NetworkStatusBanner } from "./network";
-export type { BrandOverrides, ColorMode, ColorName, ColorSchemePreference, ComponentName, ComponentSettings, ComponentSizeTokens, ComponentTokens, DurationName, EaseName, FieldVariant, FontFaces, FontName, FontWeightValue, GradientDefinition, GradientScale, IconRegistry, IconRenderer, LeadingName, LetterSpacingName, PhoneShadow, RadiusName, Resolved, ShadowName, SizeName, SpaceName, Spring, SpringScale, TextName, TextVariantSpec, Theme, ThemeProviderProps, ThemeSettings, TokenSet, WeightName, } from "./theme";
-export { COLOR_NAMES, DURATION_NAMES, darkTheme, EASE_NAMES, FONT_NAMES, LEADING_NAMES, LETTER_SPACING_NAMES, lightTheme, mergeBrand, RADIUS_NAMES, radiusOf, resolveBadgeSize, resolveButtonSize, resolveCheckboxSize, resolveChipSize, resolveEmptyStateSize, resolveFieldSize, resolveFloatingActionButtonSize, resolveListItemSize, resolveOtpInputSize, resolveRadioSize, resolveSegmentedControlSize, resolveSliderSize, resolveSwitchSize, resolveTabsSize, SHADOW_NAMES, SIZE_NAMES, SPACE_NAMES, spaceOf, TEXT_NAMES, ThemeProvider, textOf, useTheme, useThemeMode, WEIGHT_NAMES, } from "./theme";
+export type { BrandOverrides, ColorMode, ColorName, ColorSchemePreference, ComponentName, ComponentSettings, ComponentSizeTokens, ComponentTokens, DurationName, EaseName, FontFaces, FontName, FontWeightValue, GradientDefinition, GradientScale, IconRegistry, IconRenderer, LeadingName, LetterSpacingName, PhoneShadow, RadiusName, Resolved, ShadowName, SizeName, SpaceName, Spring, SpringScale, TextName, TextVariantSpec, Theme, ThemeProviderProps, ThemeSettings, TokenSet, WeightName, } from "./theme";
+export { COLOR_NAMES, DURATION_NAMES, darkTheme, EASE_NAMES, FONT_NAMES, LEADING_NAMES, LETTER_SPACING_NAMES, lightTheme, makeStyles, mergeBrand, RADIUS_NAMES, radiusOf, resolveBadgeSize, resolveButtonSize, resolveCheckboxSize, resolveChipSize, resolveEmptyStateSize, resolveFieldSize, resolveFloatingActionButtonSize, resolveListItemSize, resolveOtpInputSize, resolveRadioSize, resolveSegmentedControlSize, resolveSliderSize, resolveSwitchSize, resolveTabsSize, SHADOW_NAMES, SIZE_NAMES, SPACE_NAMES, spaceOf, TEXT_NAMES, ThemeProvider, textOf, useTheme, useThemeMode, WEIGHT_NAMES, } from "./theme";
+export type { FieldVariant, FillVariant, SelectionMode, Size, Tone, } from "./types/vocabulary";
 export type { AnnounceOptions, BreakpointKey, FeedbackIntent, HapticType, ResponsiveScales, ScreenInfo, SquirclePathParams, } from "./utils";
-export { announce, Breakpoints, configureFeedback, feedback, hapticForIntent, isFeedbackEnabled, isScreenSize, isTablet, Responsive, ScreenDimensions, SQUIRCLE_MIN_RADIUS, SQUIRCLE_SMOOTHING, setHapticImplementation, shadowStyle, smoothCorners, squircleApplies, squircleHostRadius, squirclePath, triggerHaptic, useScreenDimensions, warnUnknownProps, } from "./utils";
+export { announce, Breakpoints, configureFeedback, feedback, hapticForIntent, isFeedbackEnabled, isScreenSize, isTablet, SQUIRCLE_MIN_RADIUS, SQUIRCLE_SMOOTHING, setHapticImplementation, shadowStyle, smoothCorners, squircleApplies, squircleHostRadius, squirclePath, triggerHaptic, useScreenDimensions, warnUnknownProps, } from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/navigation/DiscardGuard.d.ts

@@ -0,0 +1,26 @@
+export interface DiscardGuardLabels {
+    title: string;
+    message: string;
+    keep: string;
+    discard: string;
+}
+export declare const DEFAULT_DISCARD_GUARD_LABELS: DiscardGuardLabels;
+export interface DiscardGuardHandle {
+    /** Leaves on purpose (after a save): the guard lifts, then `go` runs. */
+    leave: (go: () => void) => void;
+}
+export interface DiscardGuardProps {
+    /** While true, every way out of the screen is held and the person chooses Keep editing or Discard. */
+    when: boolean;
+    labels?: Partial<DiscardGuardLabels>;
+    testID?: string;
+}
+/**
+ * Asks before a form with unsaved changes is left. While `when` is true, every way out of the screen (the phone's
+ * Back button, the header arrow, a swipe back, Cancel) is held and the person chooses Keep editing or Discard.
+ *
+ * A screen that leaves on purpose, after a save, goes through the ref: `guard.current.leave(() =>
+ * navigation.goBack())`. The form is still changed at that moment, so a plain goBack would be held too.
+ */
+export declare const DiscardGuard: import("react").ForwardRefExoticComponent<DiscardGuardProps & import("react").RefAttributes<DiscardGuardHandle>>;
+//# sourceMappingURL=DiscardGuard.d.ts.map

package/lib/typescript/commonjs/navigation/NavigationScreen.d.ts

@@ -0,0 +1,12 @@
+import type React from "react";
+import { type ScreenProps } from "../components/Screen";
+/**
+ * "pushed" (default): back arrow that runs `onBack` or navigation.goBack(); "tab": large title, no back arrow, top edge only,
+ * and the tab bar's height as bottomInset when theme settings components.screen.tabBarFloats is true; "root": no back arrow.
+ */
+export type NavigationScreenKind = "pushed" | "tab" | "root";
+export interface NavigationScreenProps<ItemT = unknown> extends Omit<ScreenProps<ItemT>, "largeTitle" | "edges" | "bottomInset"> {
+    kind?: NavigationScreenKind;
+}
+export declare function NavigationScreen<ItemT = unknown>({ kind, onBack, ...rest }: NavigationScreenProps<ItemT>): React.ReactElement;
+//# sourceMappingURL=NavigationScreen.d.ts.map

package/lib/typescript/commonjs/navigation/index.d.ts

@@ -0,0 +1,5 @@
+export type { DiscardGuardHandle, DiscardGuardLabels, DiscardGuardProps } from "./DiscardGuard";
+export { DEFAULT_DISCARD_GUARD_LABELS, DiscardGuard } from "./DiscardGuard";
+export type { NavigationScreenKind, NavigationScreenProps } from "./NavigationScreen";
+export { NavigationScreen } from "./NavigationScreen";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/theme/index.d.ts

@@ -3,6 +3,7 @@ export type { Resolved } from "./componentSizes";
 export { resolveBadgeSize, resolveButtonSize, resolveCheckboxSize, resolveChipSize, resolveEmptyStateSize, resolveFieldSize, resolveFloatingActionButtonSize, resolveListItemSize, resolveOtpInputSize, resolveRadioSize, resolveSegmentedControlSize, resolveSliderSize, resolveSwitchSize, resolveTabsSize, validateComponentTokens, } from "./componentSizes";
 export type { GradientProps } from "./Gradient";
 export { Gradient, gradientAngle, toBackgroundImage } from "./Gradient";
+export { makeStyles } from "./makeStyles";
 export { mergeBrand } from "./merge";
 export { radiusOf, spaceOf, textOf } from "./scale";
 export type { ColorSchemePreference, ThemeProviderProps } from "./ThemeContext";

package/lib/typescript/commonjs/theme/makeStyles.d.ts

@@ -0,0 +1,5 @@
+import { StyleSheet } from "react-native";
+import type { Theme } from "./types";
+/** `const useStyles = makeStyles((theme) => ({ ... }))`, then `const styles = useStyles()`; rebuilt only when the theme changes. */
+export declare function makeStyles<T extends StyleSheet.NamedStyles<T>>(factory: (theme: Theme) => T): () => T;
+//# sourceMappingURL=makeStyles.d.ts.map

package/lib/typescript/commonjs/theme/tokens.generated.d.ts

@@ -61,6 +61,7 @@ export interface ButtonSizeTokens {
 }
 export interface EmptyStateSizeTokens {
     icon: number;
+    "illustration-size": number;
     "title-text": TextName;
     "description-text": TextName;
     "padding-y": SpaceName;
@@ -233,6 +234,7 @@ export declare const COMPONENT_KINDS: {
     };
     readonly "empty-state": {
         readonly icon: "px";
+        readonly "illustration-size": "px";
         readonly "title-text": "text";
         readonly "description-text": "text";
         readonly "padding-y": "space";

package/lib/typescript/commonjs/theme/types.d.ts

@@ -1,5 +1,8 @@
 import type React from "react";
 import type { TextStyle } from "react-native";
+import type { ButtonSize, ButtonVariant } from "../components/Button/Button";
+import type { PressAnimationPreset } from "../hooks/usePressAnimation";
+import type { FieldVariant } from "../types/vocabulary";
 import type { ColorName, FontFaces, FontName, LetterSpacingName, RadiusName, TextName, TokenSet, WeightName } from "./tokens.generated";
 export type ColorMode = TokenSet["mode"];
 /**
@@ -92,7 +95,7 @@ export interface TextVariantSpec {
     fontFamily?: "display";
     heading?: boolean;
 }
-export type FieldVariant = "outlined" | "filled" | "underline";
+export type { FieldVariant };
 type ToneValue = "primary" | "success" | "warning" | "danger" | "info" | "neutral";
 export interface ComponentSettings {
     field?: {
@@ -120,7 +123,7 @@ export interface ComponentSettings {
     "profile-picker"?: {
         defaultTone?: ToneValue;
         defaultVariant?: "solid" | "soft" | "outline";
-        defaultAvatarTone?: ToneValue | "secondary";
+        defaultAvatarTone?: ToneValue;
     };
     slider?: {
         thumbPressAnimation?: boolean;
@@ -138,6 +141,16 @@ export interface ComponentSettings {
         enableSwipeDismiss?: boolean;
         defaultDurationMs?: number;
     };
+    /** House defaults for every Button that does not set the prop itself. */
+    button?: {
+        defaultVariant?: ButtonVariant;
+        defaultSize?: ButtonSize;
+        defaultPressAnimation?: PressAnimationPreset;
+    };
+    /** NavigationScreen with kind "tab" adds the tab bar's height under content and footer when the app's tab bar floats over the screens. */
+    screen?: {
+        tabBarFloats?: boolean;
+    };
 }
 export interface ThemeSettings {
     icons?: IconRegistry;

package/lib/typescript/commonjs/types/vocabulary.d.ts

@@ -0,0 +1,10 @@
+/** The one tone set. Every component with a `tone` prop accepts all six. */
+export type Tone = "primary" | "success" | "warning" | "danger" | "info" | "neutral";
+/** The one size scale. A component accepts the contiguous part it draws, typed as Extract<Size, ...>; never a number. */
+export type Size = "xs" | "sm" | "md" | "lg" | "xl";
+/** Fill recipes for tone-coloured controls: solid = filled with the tone colour. */
+export type FillVariant = "solid" | "soft" | "outline" | "ghost";
+/** Field frames: filled = neutral surface fill (not a tone). */
+export type FieldVariant = "outline" | "filled" | "underline";
+export type SelectionMode = "single" | "multiple" | "range";
+//# sourceMappingURL=vocabulary.d.ts.map

package/lib/typescript/commonjs/utils/placement.d.ts

@@ -34,6 +34,8 @@ export declare const PLACEMENT_GAP = 8;
 export declare const PLACEMENT_MARGIN = 8;
 /** Height free above and below the anchor, inside the safe area and the margin. */
 export declare const placementRoom: (anchor: LayoutRectangle, viewport: PlacementViewport, options?: PlacementOptions) => PlacementRoom;
+/** The tallest a surface on `placement` may grow before it must scroll: the room on its side. */
+export declare const placementMaxHeight: (placement: ResolvedPlacement, room: PlacementRoom) => number;
 /**
  * Places a surface of `content` size against `anchor`. `'top'` and `'bottom'`
  * are preferences that flip when the surface does not fit and the other side

package/lib/typescript/commonjs/utils/warnInvalidValue.d.ts

@@ -4,7 +4,7 @@
  * Pass the value the caller supplied, before any defaulting, or the check cannot fail.
  * Nullish is accepted: an omitted prop means the default was wanted.
  */
-export declare function warnInvalidValue(component: string, prop: string, value: unknown, allowed: Iterable<string>): void;
+export declare function warnInvalidValue(component: string, prop: string, value: unknown, allowed: ReadonlyArray<string | number>): void;
 /** Tests only: clears the once-per-value memory so each case starts from a clean state. */
 export declare function resetInvalidValueWarnings(): void;
 //# sourceMappingURL=warnInvalidValue.d.ts.map

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

@@ -1,13 +1,16 @@
+import { type NumberGrouping } from "@webority/mobile-core";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils/index.js";
 import type { SliderSize, SliderTone, SliderVariant } from "../Slider/index.js";
-/**
- * How the big value is scaled for reading.
- *
- * - `indian`: Thousand, Lakh and Crore (`₹ 5 Lakh`, `₹ 1.25 Crore`).
- * - `none`: the whole number with Indian digit grouping (`₹ 5,00,000`).
- */
-export type AmountSliderUnits = "indian" | "none";
+export interface AmountSliderLabels {
+    inputLabel: string;
+    thousand: string;
+    lakh: string;
+    crore: string;
+    million: string;
+    billion: string;
+}
+export declare const DEFAULT_AMOUNT_SLIDER_LABELS: Readonly<AmountSliderLabels>;
 export interface AmountSliderProps {
     value?: number;
     defaultValue?: number;
@@ -20,13 +23,18 @@ export interface AmountSliderProps {
     size?: SliderSize;
     /** The slider's look. Default `'inset'`, the design this component comes from. */
     variant?: SliderVariant;
-    /** Drawn before the big value. Default `'₹'`; pass `''` for a plain number. */
-    prefix?: string;
-    /** Default `'indian'`. */
-    units?: AmountSliderUnits;
     /**
-     * Text of the input box when it is not being edited. Default: INR with
-     * Indian grouping and no decimals (`₹5,00,000`).
+     * Whether the large amount reads in Thousand, Lakh and Crore or in Thousand,
+     * Million and Billion. Default: the grouping of the configured locale.
+     */
+    units?: ScaleUnits;
+    /** ISO 4217 code of the amount; the symbol drawn before it comes from this. */
+    currency: string;
+    /** Unit words and the input box's label. Omitted keys keep the English defaults. */
+    labels?: Partial<AmountSliderLabels>;
+    /**
+     * Text of the input box when it is not being edited. Default: the currency
+     * with no decimals.
      */
     formatInput?: (value: number) => string;
     /**
@@ -36,10 +44,8 @@ export interface AmountSliderProps {
      */
     animationDuration?: number;
     haptic?: HapticType | false;
-    /** Read out for the slider. The input box reads `inputAccessibilityLabel`. */
+    /** Read out for the slider. The input box reads `labels.inputLabel`. */
     accessibilityLabel?: string;
-    /** Default `'Amount'`. */
-    inputAccessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
     headerStyle?: StyleProp<ViewStyle>;
     valueStyle?: StyleProp<TextStyle>;
@@ -52,8 +58,9 @@ interface Scaled {
     amount: number;
     unit: string;
 }
+type ScaleUnits = Exclude<NumberGrouping, "none">;
 /** Splits a value into the number and unit the header shows. */
-export declare const scaleAmount: (value: number, units: AmountSliderUnits) => Scaled;
+export declare const scaleAmount: (value: number, units: ScaleUnits, labels?: AmountSliderLabels) => Scaled;
 declare const AmountSlider: import("react").ForwardRefExoticComponent<AmountSliderProps & import("react").RefAttributes<RNView>>;
 export { AmountSlider };
 export default AmountSlider;

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

@@ -1,3 +1,3 @@
-export type { AmountSliderProps, AmountSliderUnits } from "./AmountSlider.js";
-export { AmountSlider, default } from "./AmountSlider.js";
+export type { AmountSliderLabels, AmountSliderProps } from "./AmountSlider.js";
+export { AmountSlider, DEFAULT_AMOUNT_SLIDER_LABELS, default } from "./AmountSlider.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -5,39 +5,44 @@ import type { HapticType } from "../../utils/hapticUtils.js";
 import type { TextVariant } from "../Text/Text.js";
 export type AppBarVariant = "default" | "large" | "compact";
 export type AppBarTitleAlignment = "left" | "center";
+export interface AppBarLabels {
+    back: string;
+}
+export declare const DEFAULT_APP_BAR_LABELS: Readonly<AppBarLabels>;
 export interface AppBarAction {
-    /** The glyph. Give `icon` or `text`; with neither the button draws nothing. */
+    /** The glyph. Give `icon` or `label`; with neither the button draws nothing. */
     icon?: React.ReactNode;
     /**
      * A text action: a pill-less label in the link colour, at least 44 by 44.
-     * `accessibilityLabel` defaults to this text. Wins over `icon` when both are set.
+     * `accessibilityLabel` defaults to this label. Wins over `icon` when both are set.
      */
-    text?: string;
+    label?: string;
     /** Draws a small unread dot on the button's corner, with no count. */
     dot?: boolean;
+    /** A count or short text drawn on the button's corner; zero draws nothing. */
+    badge?: number | string;
     onPress: () => void;
     accessibilityLabel?: string;
     testID?: string;
 }
-export interface AppBarRightAction extends AppBarAction {
-    badge?: number | string;
-}
 export interface AppBarProps {
     title?: string;
     /** One line, two on the large variant; longer text ends in an ellipsis. */
     subtitle?: string;
     titleAlignment?: AppBarTitleAlignment;
     leftAction?: AppBarAction;
-    rightActions?: AppBarRightAction[];
+    rightActions?: AppBarAction[];
     /** Any node in the left slot, after `leftAction` (a profile avatar button, say). */
     leading?: React.ReactNode;
     /** Any node in the right slot, after `rightActions`. */
     trailing?: React.ReactNode;
     /**
-     * Draws a back arrow as the left action, labelled "Back", and calls this on press.
+     * Draws a back arrow as the left action, labelled by `labels.back`, and calls this on press.
      * Navigation-agnostic: pass `navigation.goBack`. An explicit `leftAction` wins.
      */
     onBack?: () => void;
+    /** Spoken and visible strings the bar draws itself. Override any key; the rest keep their defaults. */
+    labels?: Partial<AppBarLabels>;
     /**
      * The page gutter: the distance from the screen edge to the VISIBLE edge of the outermost
      * glyph. The bar subtracts the empty space inside an action button (the 44 pt button minus

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

@@ -1,3 +1,3 @@
-export type { AppBarAction, AppBarProps, AppBarRightAction, AppBarTitleAlignment, AppBarVariant, } from "./AppBar.js";
-export { AppBar, default } from "./AppBar.js";
+export type { AppBarAction, AppBarLabels, AppBarProps, AppBarTitleAlignment, AppBarVariant, } from "./AppBar.js";
+export { AppBar, DEFAULT_APP_BAR_LABELS, default } from "./AppBar.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -20,6 +20,7 @@
  */
 import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
+import type { Size } from "../../types/vocabulary.js";
 import type { IconName } from "./catalog.g.js";
 import { ICON_NAMES } from "./catalog.g.js";
 import type { CuratedIconName } from "./glyphs.g.js";
@@ -38,7 +39,7 @@ export type IconsaxShadowedName = `${CuratedIconName}${typeof ICONSAX_SUFFIX}`;
 export type AppIconName = IconName | IconsaxShadowedName;
 /** `linear` is the default Iconsax style; the rest come from the lazy modules. */
 export type IconVariant = "linear" | IconVariantName;
-export type AppIconSize = "xs" | "sm" | "md" | "lg" | "xl";
+export type AppIconSize = Size;
 /** Pixel sizes behind the size tokens; a raw number is accepted too. */
 export declare const APP_ICON_SIZES: Record<AppIconSize, number>;
 export interface AppIconProps {

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

@@ -0,0 +1,27 @@
+import type { AppLockFailure } from "@webority/mobile-core/appLock";
+import type React from "react";
+export interface AppLockOverlayLabels {
+    title: string;
+    message: string;
+    unlock: string;
+    lockout: string;
+    notEnrolled: string;
+    failed: string;
+}
+export declare const DEFAULT_APP_LOCK_OVERLAY_LABELS: Readonly<AppLockOverlayLabels>;
+export interface AppLockOverlayProps {
+    visible: boolean;
+    onUnlock: () => void;
+    /** The last unlock failure; "cancelled" shows no message. */
+    failure?: AppLockFailure;
+    secondaryAction?: {
+        label: string;
+        onPress: () => void;
+    };
+    brandMark?: React.ReactNode;
+    labels?: Partial<AppLockOverlayLabels>;
+    testID?: string;
+}
+/** Calls `onUnlock` once each time it becomes visible, and again on every press of the unlock button. */
+export declare function AppLockOverlay({ visible, onUnlock, failure, secondaryAction, brandMark, labels: labelOverrides, testID, }: AppLockOverlayProps): React.ReactElement | null;
+//# sourceMappingURL=AppLockOverlay.d.ts.map

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

@@ -0,0 +1,3 @@
+export type { AppLockOverlayLabels, AppLockOverlayProps } from "./AppLockOverlay.js";
+export { AppLockOverlay, DEFAULT_APP_LOCK_OVERLAY_LABELS } from "./AppLockOverlay.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -2,6 +2,14 @@ import type React from "react";
 import type { StyleProp, ViewStyle } from "react-native";
 /** Which failure the error state describes. */
 export type AsyncBlockErrorVariant = "default" | "offline";
+export interface AsyncBlockLabels {
+    emptyTitle: string;
+    errorTitle: string;
+    offlineTitle: string;
+    offlineHint: string;
+    retry: string;
+}
+export declare const DEFAULT_ASYNC_BLOCK_LABELS: Readonly<AsyncBlockLabels>;
 export interface AsyncBlockProps {
     /** Show the placeholder instead of content. */
     loading?: boolean;
@@ -24,15 +32,16 @@ export interface AsyncBlockProps {
     onRetry?: () => void;
     /** Placeholder shaped like the content. Falls back to a centred Spinner. */
     skeleton?: React.ReactNode;
-    /** Copy for the empty state. */
+    /** Copy for the empty state. Wins over `labels.emptyTitle`. */
     emptyTitle?: string;
     emptyDescription?: string;
     emptyIcon?: React.ReactNode;
-    /** Copy for the error state. The description is `error` when it is a string, else the extracted message. */
+    /** Copy for the error state. The description is `error` when it is a string, else the extracted message. Wins over `labels.errorTitle`. */
     errorTitle?: string;
-    /** Title of the offline error state. */
+    /** Title of the offline error state. Wins over `labels.offlineTitle`. */
     offlineTitle?: string;
-    retryLabel?: string;
+    /** Overrides the built-in copy for the keys given; the title props above win over their matching key. */
+    labels?: Partial<AsyncBlockLabels>;
     /** Rendered as given (no wrapper) once loaded, error-free and non-empty. */
     children?: React.ReactNode;
     /** Style of the loading, error and empty states' wrapper. Content is not wrapped. */

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

@@ -1,3 +1,3 @@
-export type { AsyncBlockErrorVariant, AsyncBlockProps } from "./AsyncBlock.js";
-export { AsyncBlock, default } from "./AsyncBlock.js";
+export type { AsyncBlockErrorVariant, AsyncBlockLabels, AsyncBlockProps } from "./AsyncBlock.js";
+export { AsyncBlock, DEFAULT_ASYNC_BLOCK_LABELS, default } from "./AsyncBlock.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -3,6 +3,12 @@ import { type ImageProps } from "expo-image";
 import type React from "react";
 /** React Native Image's resize modes, still accepted and mapped onto `contentFit`. */
 export type AuthedImageResizeMode = "cover" | "contain" | "stretch" | "repeat" | "center";
+export interface AuthedImageLabels {
+    loading: string;
+    unavailable: string;
+    unavailableNamed: (name: string) => string;
+}
+export declare const DEFAULT_AUTHED_IMAGE_LABELS: Readonly<AuthedImageLabels>;
 /**
  * Renders with expo-image, so every expo-image prop (`contentFit`,
  * `contentPosition`, `transition`, `cachePolicy`, `recyclingKey` and the rest)
@@ -40,6 +46,8 @@ export interface AuthedImageProps extends Omit<ImageProps, "source" | "onError"
     /** Override the key derived from `uri`. */
     cacheKey?: string;
     testID?: string;
+    /** Text for the loading spinner and the failed-image box. Each key overrides its default. */
+    labels?: Partial<AuthedImageLabels>;
 }
 declare const AuthedImage: React.FC<AuthedImageProps>;
 export { AuthedImage };

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

@@ -2,6 +2,11 @@ import React from "react";
 import type { StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { HapticType } from "../../utils/index.js";
 import type { InputSize, InputVariant } from "../Input/index.js";
+export interface AutocompleteLabels {
+    empty: string;
+    searching: string;
+}
+export declare const DEFAULT_AUTOCOMPLETE_LABELS: Readonly<AutocompleteLabels>;
 export interface AutocompleteProps<T = string> {
     /** Candidate options to filter. */
     options: ReadonlyArray<T>;
@@ -22,17 +27,17 @@ export interface AutocompleteProps<T = string> {
     minChars?: number;
     /** Cap the number of suggestions shown. Default 8. */
     maxResults?: number;
-    /** Text shown when nothing matches. Default "No matches". */
-    emptyText?: string;
     /** Show a loading spinner in the dropdown — e.g. while fetching remote results. */
     loading?: boolean;
     /** `'client'` filters `options` locally; `'none'` shows them as-is (for server-side search). Default `'client'`. */
     filterMode?: "client" | "none";
-    /** Text beside the loading spinner. Default "Searching…". */
+    /** Text beside the loading spinner. Default `labels.searching`. */
     loadingText?: string;
+    /** Dropdown copy. Missing keys keep `DEFAULT_AUTOCOMPLETE_LABELS`. */
+    labels?: Partial<AutocompleteLabels>;
     placeholder?: string;
     label?: string;
-    error?: React.ReactNode;
+    error?: string | boolean;
     helperText?: string;
     disabled?: boolean;
     size?: InputSize;

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

@@ -1,3 +1,3 @@
-export type { AutocompleteProps } from "./Autocomplete.js";
-export { Autocomplete } from "./Autocomplete.js";
+export type { AutocompleteLabels, AutocompleteProps } from "./Autocomplete.js";
+export { Autocomplete, DEFAULT_AUTOCOMPLETE_LABELS } from "./Autocomplete.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +1,7 @@
 import type React from "react";
 import type { GestureResponderEvent, ImageSourcePropType, ImageStyle, PressableProps, View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { Theme } from "../../theme/types.js";
+import type { Size, Tone } from "../../types/vocabulary.js";
 import type { HapticType } from "../../utils/hapticUtils.js";
 /**
  * Props passed to a custom {@link AvatarProps.ImageComponent}. The built-in
@@ -18,7 +19,7 @@ export interface AvatarImageProps {
     onError: () => void;
     accessibilityIgnoresInvertColors?: boolean;
 }
-export type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl" | number;
+export type AvatarSize = Size;
 export type AvatarShape = "circle" | "square" | "rounded";
 /**
  * Presence dots (`online`, `offline`, `busy`, `away`) and identity states
@@ -31,15 +32,25 @@ export type AvatarStatusPosition = "topRight" | "bottomRight";
 /**
  * Theme colour of the initials disc: a soft tint of the tone behind initials
  * in the tone, the soft Button's recipe. `neutral` is the quiet grey on
- * primary text; `secondary` is the theme's secondary surface and its ink.
+ * primary text.
  */
-export type AvatarTone = "neutral" | "primary" | "secondary" | "success" | "warning" | "danger" | "info";
+export type AvatarTone = Tone;
 export declare const AVATAR_COLORS: readonly ["avatar-1", "avatar-2", "avatar-3", "avatar-4", "avatar-5", "avatar-6", "avatar-7", "avatar-8"];
 /** The fill and the ink (the tone as text, the `<tone>-text` colour names) of an initials disc in a tone. Shared with ProfilePicker's placeholder. */
 export declare const avatarToneColors: (theme: Theme, tone: AvatarTone) => {
     background: string;
     color: string;
 };
+export interface AvatarLabels {
+    avatar: string;
+    avatarOf: (name: string) => string;
+    verified: string;
+    pendingVerification: string;
+    groupOf: (count: number) => string;
+    moreCount: (count: number) => string;
+    moreAvatars: string;
+}
+export declare const DEFAULT_AVATAR_LABELS: Readonly<AvatarLabels>;
 export interface AvatarProps {
     source?: ImageSourcePropType;
     /**
@@ -99,6 +110,8 @@ export interface AvatarProps {
     hitSlop?: PressableProps["hitSlop"];
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;
+    /** Spoken text in its default English. Override any key to translate it or to change its wording. */
+    labels?: Partial<AvatarLabels>;
     testID?: string;
 }
 declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<RNView>> & {
@@ -114,13 +127,11 @@ export interface AvatarGroupProps {
     overflowVariant?: AvatarGroupOverflowVariant;
     accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
+    /** Spoken text in its default English; passed down to each avatar unless the avatar sets its own. */
+    labels?: Partial<AvatarLabels>;
     testID?: string;
 }
 declare const AvatarGroup: React.FC<AvatarGroupProps>;
-type AvatarComponent = typeof Avatar & {
-    Group: typeof AvatarGroup;
-};
-declare const AvatarWithGroup: AvatarComponent;
 export { Avatar, AvatarGroup };
-export default AvatarWithGroup;
+export default Avatar;
 //# sourceMappingURL=Avatar.d.ts.map

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

@@ -1,3 +1,3 @@
-export type { AvatarGroupOverflowVariant, AvatarGroupProps, AvatarGroupSpacing, AvatarImageProps, AvatarProps, AvatarShape, AvatarSize, AvatarStatus, AvatarStatusPosition, AvatarTone, } from "./Avatar.js";
-export { Avatar, AvatarGroup, avatarToneColors, default } from "./Avatar.js";
+export type { AvatarGroupOverflowVariant, AvatarGroupProps, AvatarGroupSpacing, AvatarImageProps, AvatarLabels, AvatarProps, AvatarShape, AvatarSize, AvatarStatus, AvatarStatusPosition, AvatarTone, } from "./Avatar.js";
+export { Avatar, AvatarGroup, avatarToneColors, DEFAULT_AVATAR_LABELS, default } from "./Avatar.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,9 +1,15 @@
 import type React from "react";
 import type { View as RNView, StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { Size, Tone } from "../../types/vocabulary.js";
 export type BadgeVariant = "standard" | "dot";
-export type BadgeTone = "primary" | "success" | "warning" | "danger" | "neutral" | "info";
-export type BadgeSize = "sm" | "md";
+export type BadgeTone = Tone;
+export type BadgeSize = Extract<Size, "sm" | "md">;
 export type BadgeAnchor = "topRight" | "topLeft" | "bottomRight" | "bottomLeft";
+export interface BadgeLabels {
+    indicator: string;
+    unread: (count: string) => string;
+}
+export declare const DEFAULT_BADGE_LABELS: Readonly<BadgeLabels>;
 export interface BadgeProps {
     value?: number | string;
     max?: number;
@@ -21,6 +27,7 @@ export interface BadgeProps {
     anchor?: BadgeAnchor;
     pulse?: boolean;
     accessibilityLabel?: string;
+    labels?: Partial<BadgeLabels>;
     style?: StyleProp<ViewStyle>;
     badgeStyle?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;

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

@@ -1,3 +1,3 @@
-export type { BadgeAnchor, BadgeProps, BadgeSize, BadgeTone, BadgeVariant } from "./Badge.js";
-export { Badge, default } from "./Badge.js";
+export type { BadgeAnchor, BadgeLabels, BadgeProps, BadgeSize, BadgeTone, BadgeVariant } from "./Badge.js";
+export { Badge, DEFAULT_BADGE_LABELS, default } from "./Badge.js";
 //# sourceMappingURL=index.d.ts.map