@webority-technologies/mobile 0.0.22 → 0.0.23

package/lib/module/components/KeyboardToolbar/KeyboardToolbar.js

@@ -0,0 +1,125 @@
+"use strict";
+
+import React, { useEffect, useState } from 'react';
+import { Keyboard, Platform, Pressable, StyleSheet, View } from 'react-native';
+import { useTheme } from "../../theme/index.js";
+import { useOptionalFormContext } from "../../form/FormContext.js";
+import { Text } from "../Text/index.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const NavButton = ({
+  label,
+  accessibilityLabel,
+  onPress,
+  theme
+}) => /*#__PURE__*/_jsx(Pressable, {
+  onPress: onPress,
+  disabled: !onPress,
+  accessibilityRole: "button",
+  accessibilityLabel: accessibilityLabel,
+  hitSlop: 8,
+  style: {
+    paddingHorizontal: theme.spacing.sm,
+    opacity: onPress ? 1 : 0.4
+  },
+  children: /*#__PURE__*/_jsx(Text, {
+    variant: "h2",
+    color: onPress ? 'link' : 'disabled',
+    children: label
+  })
+});
+
+/**
+ * An accessory bar pinned just above the keyboard — pure RN, no native
+ * dependency. Shows a Done (dismiss) button and optional prev/next chevrons
+ * that, inside a `<Form>`, walk the registered field order. Render it at the
+ * screen root (a `flex: 1` ancestor) so its `bottom: keyboardHeight` offset
+ * lands it on top of the keyboard. Renders nothing while the keyboard is hidden.
+ */
+const KeyboardToolbar = props => {
+  const {
+    doneLabel = 'Done',
+    showNavigation,
+    onDone,
+    onNext,
+    onPrev,
+    leading,
+    style,
+    testID
+  } = props;
+  const theme = useTheme();
+  const form = useOptionalFormContext();
+  const [keyboardHeight, setKeyboardHeight] = useState(0);
+  useEffect(() => {
+    const showEvent = Platform.OS === 'ios' ? 'keyboardWillShow' : 'keyboardDidShow';
+    const hideEvent = Platform.OS === 'ios' ? 'keyboardWillHide' : 'keyboardDidHide';
+    const showSub = Keyboard.addListener(showEvent, e => setKeyboardHeight(e.endCoordinates?.height ?? 0));
+    const hideSub = Keyboard.addListener(hideEvent, () => setKeyboardHeight(0));
+    return () => {
+      showSub.remove();
+      hideSub.remove();
+    };
+  }, []);
+  if (keyboardHeight <= 0) return null;
+  const handleDone = onDone ?? (() => Keyboard.dismiss());
+  const handlePrev = onPrev ?? form?.focusPrev;
+  const handleNext = onNext ?? form?.focusNext;
+  const navEnabled = showNavigation ?? Boolean(handlePrev || handleNext);
+  return /*#__PURE__*/_jsxs(View, {
+    testID: testID,
+    accessibilityRole: "toolbar",
+    style: [styles.bar, {
+      bottom: keyboardHeight,
+      backgroundColor: theme.colors.background.elevated,
+      borderTopColor: theme.colors.border.primary,
+      paddingHorizontal: theme.spacing.md
+    }, style],
+    children: [navEnabled ? /*#__PURE__*/_jsxs(View, {
+      style: styles.nav,
+      children: [/*#__PURE__*/_jsx(NavButton, {
+        label: "\u2039",
+        accessibilityLabel: "Previous field",
+        onPress: handlePrev,
+        theme: theme
+      }), /*#__PURE__*/_jsx(NavButton, {
+        label: "\u203A",
+        accessibilityLabel: "Next field",
+        onPress: handleNext,
+        theme: theme
+      })]
+    }) : /*#__PURE__*/_jsx(View, {}), leading, /*#__PURE__*/_jsx(View, {
+      style: styles.spacer
+    }), /*#__PURE__*/_jsx(Pressable, {
+      onPress: handleDone,
+      accessibilityRole: "button",
+      accessibilityLabel: doneLabel,
+      hitSlop: 8,
+      children: /*#__PURE__*/_jsx(Text, {
+        variant: "body",
+        weight: "semibold",
+        color: "link",
+        children: doneLabel
+      })
+    })]
+  });
+};
+const styles = StyleSheet.create({
+  bar: {
+    position: 'absolute',
+    left: 0,
+    right: 0,
+    height: 44,
+    flexDirection: 'row',
+    alignItems: 'center',
+    borderTopWidth: StyleSheet.hairlineWidth
+  },
+  nav: {
+    flexDirection: 'row',
+    alignItems: 'center'
+  },
+  spacer: {
+    flex: 1
+  }
+});
+export { KeyboardToolbar };
+export default KeyboardToolbar;
+//# sourceMappingURL=KeyboardToolbar.js.map

package/lib/module/components/KeyboardToolbar/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { KeyboardToolbar } from "./KeyboardToolbar.js";
+//# sourceMappingURL=index.js.map

package/lib/module/components/Modal/Modal.js

@@ -39,6 +39,7 @@ const Modal = /*#__PURE__*/forwardRef((props, ref) => {
   const wasVisibleRef = useRef(false);
   const styles = useMemo(() => buildStyles(theme), [theme]);
   useEffect(() => {
+    const running = [];
     if (visible) {
       // Two Fabric quirks force this combination: backdrop View needs
       // `collapsable={false}` (see render) so flattening doesn't drop it,
@@ -46,21 +47,25 @@ const Modal = /*#__PURE__*/forwardRef((props, ref) => {
       // Animated.View that also sets backgroundColor inline renders as 0 on
       // RN 0.85 / Fabric / iOS, leaving the dim layer invisible. Single
       // 240ms tween — JS thread cost is negligible.
-      Animated.timing(backdropAnim, {
+      const backdrop = Animated.timing(backdropAnim, {
         toValue: 1,
         duration,
         useNativeDriver: false
-      }).start();
+      });
+      backdrop.start();
+      running.push(backdrop);
       if (presentation === 'bottom') {
-        Animated.spring(translateYAnim, {
+        const slide = Animated.spring(translateYAnim, {
           toValue: 0,
           damping: theme.motion.spring.gentle.damping,
           stiffness: theme.motion.spring.gentle.stiffness,
           mass: theme.motion.spring.gentle.mass,
           useNativeDriver: true
-        }).start();
+        });
+        slide.start();
+        running.push(slide);
       } else {
-        Animated.parallel([Animated.spring(scaleAnim, {
+        const enter = Animated.parallel([Animated.spring(scaleAnim, {
           toValue: 1,
           damping: theme.motion.spring.gentle.damping,
           stiffness: theme.motion.spring.gentle.stiffness,
@@ -70,7 +75,9 @@ const Modal = /*#__PURE__*/forwardRef((props, ref) => {
           toValue: 1,
           duration,
           useNativeDriver: true
-        })]).start();
+        })]);
+        enter.start();
+        running.push(enter);
       }
     } else {
       // backdropAnim is JS-driven (see note above) — reset directly so a
@@ -80,6 +87,10 @@ const Modal = /*#__PURE__*/forwardRef((props, ref) => {
       setNativeValue(opacityAnim, 0);
       setNativeValue(translateYAnim, screenHeight);
     }
+    // Stop in-flight tweens on unmount / visibility flip so an enter animation
+    // never resolves against a torn-down tree (fixes the jest async leak and
+    // the equivalent post-unmount work in the real app).
+    return () => running.forEach(animation => animation.stop());
   }, [visible, presentation, duration, backdropAnim, scaleAnim, opacityAnim, translateYAnim, screenHeight, theme.motion.spring.gentle.damping, theme.motion.spring.gentle.stiffness, theme.motion.spring.gentle.mass, scaleStartValue]);
 
   // Accessibility focus trap: when the modal opens, push screen-reader focus

package/lib/module/components/NumberInput/NumberInput.js

@@ -2,6 +2,7 @@
 
 import React, { forwardRef, useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Pressable, StyleSheet, Text, TextInput, View } from 'react-native';
+import { useControllableState } from "../../hooks/index.js";
 import { useTheme } from "../../theme/index.js";
 import { triggerHaptic } from "../../utils/index.js";
 import { FieldBase, resolveFieldSize, resolveFieldTextStyle } from "../FieldBase/FieldBase.js";
@@ -43,6 +44,7 @@ const sanitizeTyped = (raw, allowDecimal) => {
 const NumberInput = /*#__PURE__*/forwardRef((props, ref) => {
   const {
     value,
+    defaultValue,
     onChange,
     min = Number.NEGATIVE_INFINITY,
     max = Number.POSITIVE_INFINITY,
@@ -66,6 +68,11 @@ const NumberInput = /*#__PURE__*/forwardRef((props, ref) => {
     textInputProps,
     testID
   } = props;
+  const [current, setCurrent] = useControllableState({
+    value,
+    defaultValue: defaultValue ?? props.min ?? 0,
+    onChange
+  });
   const theme = useTheme();
   const sizeTokens = resolveFieldSize(theme, size);
   const fieldText = resolveFieldTextStyle(theme, {
@@ -76,7 +83,7 @@ const NumberInput = /*#__PURE__*/forwardRef((props, ref) => {
   const longPressInterval = theme.components.numberInput?.longPressIntervalMs ?? DEFAULT_LONG_PRESS_INTERVAL;
   const pressHaptic = theme.components.numberInput?.pressHaptic ?? false;
   const inputRef = useRef(null);
-  const [draft, setDraft] = useState(formatValue(value, allowDecimal, precision));
+  const [draft, setDraft] = useState(formatValue(current, allowDecimal, precision));
   const [editing, setEditing] = useState(false);
   const [focused, setFocused] = useState(false);
   const repeatTimeoutRef = useRef(null);
@@ -94,41 +101,41 @@ const NumberInput = /*#__PURE__*/forwardRef((props, ref) => {
   useEffect(() => clearRepeat, [clearRepeat]);
   useEffect(() => {
     if (!editing) {
-      setDraft(formatValue(value, allowDecimal, precision));
+      setDraft(formatValue(current, allowDecimal, precision));
     }
-  }, [value, allowDecimal, precision, editing]);
-  const atMin = value <= min;
-  const atMax = value >= max;
+  }, [current, allowDecimal, precision, editing]);
+  const atMin = current <= min;
+  const atMax = current >= max;
   const interactive = !disabled;
   const setExternal = useCallback(next => {
     const rounded = roundToPrecision(next, allowDecimal ? precision : 0);
     const clamped = clamp(rounded, min, max);
-    if (clamped !== value) {
-      onChange(clamped);
+    if (clamped !== current) {
+      setCurrent(clamped);
     }
-  }, [allowDecimal, max, min, onChange, precision, value]);
+  }, [allowDecimal, max, min, setCurrent, precision, current]);
   const decrement = useCallback(() => {
     if (!interactive || atMin) return;
     if (pressHaptic) triggerHaptic('impactLight');
-    setExternal(value - step);
-  }, [atMin, interactive, pressHaptic, setExternal, step, value]);
+    setExternal(current - step);
+  }, [atMin, interactive, pressHaptic, setExternal, step, current]);
   const increment = useCallback(() => {
     if (!interactive || atMax) return;
     if (pressHaptic) triggerHaptic('impactLight');
-    setExternal(value + step);
-  }, [atMax, interactive, pressHaptic, setExternal, step, value]);
+    setExternal(current + step);
+  }, [atMax, interactive, pressHaptic, setExternal, step, current]);
   React.useImperativeHandle(ref, () => ({
     focus: () => inputRef.current?.focus(),
     blur: () => inputRef.current?.blur(),
     clear: () => {
       setDraft('');
       if (Number.isFinite(min) && min > 0) {
-        onChange(min);
+        setCurrent(min);
       } else {
-        onChange(0 < min ? min : 0 > max ? max : 0);
+        setCurrent(0 < min ? min : 0 > max ? max : 0);
       }
     }
-  }), [max, min, onChange]);
+  }), [max, min, setCurrent]);
   const startRepeating = useCallback(direction => {
     if (!interactive) return;
     clearRepeat();
@@ -148,27 +155,27 @@ const NumberInput = /*#__PURE__*/forwardRef((props, ref) => {
     const parsed = Number(cleaned);
     if (cleaned !== '' && cleaned !== '-' && cleaned !== '.' && Number.isFinite(parsed)) {
       if (parsed >= min && parsed <= max) {
-        if (parsed !== value) {
-          onChange(roundToPrecision(parsed, allowDecimal ? precision : 0));
+        if (parsed !== current) {
+          setCurrent(roundToPrecision(parsed, allowDecimal ? precision : 0));
         }
       }
     }
-  }, [allowDecimal, max, min, onChange, precision, value]);
+  }, [allowDecimal, max, min, setCurrent, precision, current]);
   const handleBlur = useCallback(() => {
     setEditing(false);
     setFocused(false);
     const parsed = Number(draft);
     if (draft === '' || !Number.isFinite(parsed)) {
-      setDraft(formatValue(value, allowDecimal, precision));
+      setDraft(formatValue(current, allowDecimal, precision));
       return;
     }
     const rounded = roundToPrecision(parsed, allowDecimal ? precision : 0);
     const clamped = clamp(rounded, min, max);
-    if (clamped !== value) {
-      onChange(clamped);
+    if (clamped !== current) {
+      setCurrent(clamped);
     }
     setDraft(formatValue(clamped, allowDecimal, precision));
-  }, [allowDecimal, draft, max, min, onChange, precision, value]);
+  }, [allowDecimal, draft, max, min, setCurrent, precision, current]);
   const handleFocus = useCallback(() => {
     setEditing(true);
     setFocused(true);
@@ -232,7 +239,7 @@ const NumberInput = /*#__PURE__*/forwardRef((props, ref) => {
         accessibilityRole: "adjustable",
         accessibilityLabel: accessibleInputLabel,
         accessibilityValue: {
-          now: Number.isFinite(value) ? value : 0
+          now: Number.isFinite(current) ? current : 0
         },
         accessibilityState: {
           disabled

package/lib/module/components/OTPInput/OTPInput.js

@@ -3,6 +3,7 @@
 import React, { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
 import { Animated, Easing, Pressable, StyleSheet, Text, TextInput, View } from 'react-native';
 import { fontFor, useTheme, createAnimatedValue, setNativeValue } from "../../theme/index.js";
+import { useReducedMotion, useControllableState } from "../../hooks/index.js";
 import { triggerHaptic } from "../../utils/index.js";
 import { FieldBase } from "../FieldBase/FieldBase.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -36,6 +37,7 @@ const sanitizeChar = (input, kind) => {
 const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
   const {
     value,
+    defaultValue,
     onChange,
     onComplete,
     length = 6,
@@ -51,6 +53,11 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
     textStyle,
     testID
   } = props;
+  const [current, setCurrent] = useControllableState({
+    value,
+    defaultValue: defaultValue ?? '',
+    onChange
+  });
   const theme = useTheme();
   const styles = useMemo(() => buildStyles(theme), [theme]);
   const sizeStyles = {
@@ -81,6 +88,7 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
   }, [length]);
   const previousFocusedIndexRef = useRef(-1);
   const shakeOnError = theme.components.otpInput?.shakeOnError ?? false;
+  const reduceMotion = useReducedMotion();
   const errorHaptic = theme.components.otpInput?.errorHaptic ?? false;
   const selectionHaptic = theme.components.otpInput?.selectionHaptic ?? false;
   const hasError = Boolean(error);
@@ -90,11 +98,12 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
   // error is initially true — there's no transition to animate.
   useEffect(() => {
     const isFirstRun = previousErrorRef.current === null;
+    let anim;
     if (!isFirstRun && hasError && !previousErrorRef.current) {
       if (errorHaptic) triggerHaptic('notificationError');
-      if (shakeOnError) {
+      if (shakeOnError && !reduceMotion) {
         setNativeValue(shake, 0);
-        Animated.sequence([Animated.timing(shake, {
+        anim = Animated.sequence([Animated.timing(shake, {
           toValue: 1,
           duration: 75,
           easing: Easing.linear,
@@ -114,10 +123,12 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
           duration: 75,
           easing: Easing.linear,
           useNativeDriver: true
-        })]).start();
+        })]);
+        anim.start();
       }
     }
     previousErrorRef.current = hasError;
+    return () => anim?.stop();
   }, [hasError, shake, shakeOnError, errorHaptic]);
 
   // Animate underline opacity for the focused cell. Skip on first mount
@@ -127,17 +138,21 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
     previousFocusedIndexRef.current = focusedIndex;
     if (previous === focusedIndex) return;
     if (previous === -1 && focusedIndex === -1) return;
+    const anims = [];
     underlines.forEach((anim, idx) => {
       const target = idx === focusedIndex ? 1 : 0;
       // Only animate the cells whose target changed.
       if (idx !== focusedIndex && idx !== previous) return;
-      Animated.timing(anim, {
+      const animation = Animated.timing(anim, {
         toValue: target,
         duration: theme.motion.duration.fast,
         easing: Easing.bezier(...theme.motion.easing.standard),
         useNativeDriver: true
-      }).start();
+      });
+      animation.start();
+      anims.push(animation);
     });
+    return () => anims.forEach(a => a.stop());
   }, [focusedIndex, underlines, theme]);
   const focusCell = useCallback(index => {
     const target = inputsRef.current[index];
@@ -152,10 +167,10 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
       current?.blur();
     },
     clear: () => {
-      onChange('');
+      setCurrent('');
       focusCell(0);
     }
-  }), [focusCell, focusedIndex, onChange]);
+  }), [focusCell, focusedIndex, setCurrent]);
   useEffect(() => {
     if (autoFocus && !disabled) {
       // Defer one frame so the inputs are mounted.
@@ -166,19 +181,19 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
   }, [autoFocus, disabled, focusCell]);
   const cells = useMemo(() => {
     const arr = new Array(length).fill('');
-    for (let i = 0; i < Math.min(value.length, length); i += 1) {
-      arr[i] = value[i] ?? '';
+    for (let i = 0; i < Math.min(current.length, length); i += 1) {
+      arr[i] = current[i] ?? '';
     }
     return arr;
-  }, [value, length]);
+  }, [current, length]);
   const updateValue = useCallback(next => {
     const trimmed = next.slice(0, length);
-    if (trimmed === value) return;
-    onChange(trimmed);
+    if (trimmed === current) return;
+    setCurrent(trimmed);
     if (trimmed.length === length && onComplete) {
       onComplete(trimmed);
     }
-  }, [length, onChange, onComplete, value]);
+  }, [length, setCurrent, onComplete, current]);
   const handleChangeText = useCallback((index, raw) => {
     // Strip the ZWSP placeholder (used so iOS fires onKeyPress/Backspace on otherwise-empty cells).
     const stripped = raw.replace(/\u200B/g, '');
@@ -208,7 +223,7 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
       writeIndex += 1;
     }
     const next = chars.join('').slice(0, length);
-    const previousLength = value.length;
+    const previousLength = current.length;
     updateValue(next);
     if (next.length !== previousLength && selectionHaptic) {
       triggerHaptic('selection');
@@ -221,7 +236,7 @@ const OTPInput = /*#__PURE__*/forwardRef((props, ref) => {
     } else {
       focusCell(nextFocus);
     }
-  }, [cells, focusCell, keyboardType, length, selectionHaptic, updateValue, value]);
+  }, [cells, focusCell, keyboardType, length, selectionHaptic, updateValue, current]);
   const handleKeyPress = useCallback((index, e) => {
     const key = e.nativeEvent.key;
     if (key !== 'Backspace') return;

package/lib/module/components/Radio/Radio.js

@@ -38,7 +38,7 @@ const Radio = /*#__PURE__*/forwardRef((props, ref) => {
   const {
     value,
     selected: selectedProp,
-    onSelect,
+    onChange,
     disabled: disabledProp = false,
     label,
     size = 'md',
@@ -68,13 +68,15 @@ const Radio = /*#__PURE__*/forwardRef((props, ref) => {
   const resolvedHaptic = haptic === undefined ? pressHapticEnabled ? 'selection' : false : haptic;
   const progress = useRef(createAnimatedValue(selected ? 1 : 0)).current;
   useEffect(() => {
-    Animated.spring(progress, {
+    const anim = Animated.spring(progress, {
       toValue: selected ? 1 : 0,
       damping: theme.motion.spring.snappy.damping,
       stiffness: theme.motion.spring.snappy.stiffness,
       mass: theme.motion.spring.snappy.mass,
       useNativeDriver: true
-    }).start();
+    });
+    anim.start();
+    return () => anim.stop();
   }, [selected, progress, theme.motion.spring.snappy]);
   const scale = progress.interpolate({
     inputRange: [0, 1],
@@ -84,9 +86,9 @@ const Radio = /*#__PURE__*/forwardRef((props, ref) => {
     if (disabled) return;
     if (resolvedHaptic !== false) triggerHaptic(resolvedHaptic);
     if (ctx) {
-      ctx.onSelect(value);
+      ctx.onChange(value);
     } else {
-      onSelect?.(value);
+      onChange?.(value);
     }
     rest.onPressOut?.(event);
   };

package/lib/module/components/Radio/RadioGroup.js

@@ -3,9 +3,11 @@
 import React, { useMemo } from 'react';
 import { View } from 'react-native';
 import { RadioGroupContext } from "./Radio.js";
+import { useControllableState } from "../../hooks/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const RadioGroup = ({
   value,
+  defaultValue,
   onChange,
   children,
   disabled = false,
@@ -13,11 +15,16 @@ const RadioGroup = ({
   style,
   testID
 }) => {
+  const [current, setCurrent] = useControllableState({
+    value,
+    defaultValue: defaultValue ?? undefined,
+    onChange: onChange
+  });
   const ctx = useMemo(() => ({
-    selectedValue: value,
-    onSelect: onChange,
+    selectedValue: current,
+    onChange: setCurrent,
     disabled
-  }), [value, onChange, disabled]);
+  }), [current, setCurrent, disabled]);
   return /*#__PURE__*/_jsx(RadioGroupContext.Provider, {
     value: ctx,
     children: /*#__PURE__*/_jsx(View, {

package/lib/module/components/SearchBar/SearchBar.js

@@ -75,12 +75,14 @@ const SearchBar = /*#__PURE__*/forwardRef((props, ref) => {
   }, [debouncedValue, debounceMs, onChangeText]);
   const showCancelButton = showCancel && isFocused;
   useEffect(() => {
-    Animated.timing(cancelAnim, {
+    const anim = Animated.timing(cancelAnim, {
       toValue: showCancelButton ? 1 : 0,
       duration: 200,
       easing: Easing.bezier(...theme.motion.easing.standard),
       useNativeDriver: false
-    }).start();
+    });
+    anim.start();
+    return () => anim.stop();
   }, [showCancelButton, cancelAnim, theme.motion.easing.standard]);
   const handleChangeText = useCallback(text => {
     if (debounceMs !== undefined) {

package/lib/module/components/SegmentedControl/SegmentedControl.js

@@ -12,6 +12,7 @@ import React, { forwardRef, useCallback, useEffect, useMemo, useRef, useState }
 import { Animated, Pressable, StyleSheet, Text, View } from 'react-native';
 import { useTheme, createAnimatedValue } from "../../theme/index.js";
 import { triggerHaptic } from "../../utils/index.js";
+import { useControllableState } from "../../hooks/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const sizeMap = {
   sm: {
@@ -29,7 +30,8 @@ const TRACK_PADDING = 2;
 const SegmentedControl = /*#__PURE__*/forwardRef((props, ref) => {
   const {
     segments,
-    value,
+    value: valueProp,
+    defaultValue,
     onChange,
     size = 'md',
     fullWidth = true,
@@ -44,6 +46,11 @@ const SegmentedControl = /*#__PURE__*/forwardRef((props, ref) => {
     labelStyle,
     testID
   } = props;
+  const [current, setCurrent] = useControllableState({
+    value: valueProp,
+    defaultValue: defaultValue ?? segments[0]?.value,
+    onChange
+  });
   const theme = useTheme();
   const segTheme = theme.components.segmentedControl;
   const styles = useMemo(() => buildStyles(theme), [theme]);
@@ -64,23 +71,26 @@ const SegmentedControl = /*#__PURE__*/forwardRef((props, ref) => {
   // only animate translateX via the native driver.
   const [trackWidth, setTrackWidth] = useState(0);
   const thumbTranslateX = useRef(createAnimatedValue(0)).current;
-  const activeIndex = Math.max(0, segments.findIndex(s => s.value === value));
+  const activeIndex = Math.max(0, segments.findIndex(s => s.value === current));
   const segmentWidth = trackWidth > 0 ? (trackWidth - trackPadding * 2) / Math.max(segments.length, 1) : 0;
   const animateThumb = useCallback((index, segWidth) => {
-    if (segWidth <= 0) return;
+    if (segWidth <= 0) return undefined;
     const targetX = trackPadding + segWidth * index;
     const spring = theme.motion.spring.snappy;
-    Animated.spring(thumbTranslateX, {
+    const anim = Animated.spring(thumbTranslateX, {
       toValue: targetX,
       damping: spring.damping,
       stiffness: spring.stiffness,
       mass: spring.mass,
       useNativeDriver: true
-    }).start();
+    });
+    anim.start();
+    return anim;
   }, [theme.motion.spring.snappy, thumbTranslateX]);
   useEffect(() => {
     if (segmentWidth > 0) {
-      animateThumb(activeIndex, segmentWidth);
+      const anim = animateThumb(activeIndex, segmentWidth);
+      return () => anim?.stop();
     }
   }, [activeIndex, segmentWidth, animateThumb]);
   const handleTrackLayout = useCallback(e => {
@@ -91,10 +101,10 @@ const SegmentedControl = /*#__PURE__*/forwardRef((props, ref) => {
   }, [trackWidth]);
   const handlePress = useCallback(segment => {
     if (disabled) return;
-    if (segment.value === value) return;
+    if (segment.value === current) return;
     if (changeHapticEnabled) triggerHaptic('selection');
-    onChange(segment.value);
-  }, [disabled, onChange, value, changeHapticEnabled]);
+    setCurrent(segment.value);
+  }, [disabled, setCurrent, current, changeHapticEnabled]);
   const thumbBg = tone === 'primary' ? theme.colors.background.elevated : theme.colors.background.elevated;
   const activeTextColor = tone === 'primary' ? theme.colors.text.primary : theme.colors.text.primary;
   return /*#__PURE__*/_jsxs(View, {
@@ -125,7 +135,7 @@ const SegmentedControl = /*#__PURE__*/forwardRef((props, ref) => {
         ...theme.shadows.sm
       }, selectedIndicatorStyle]
     }) : null, segments.map(segment => {
-      const isActive = segment.value === value;
+      const isActive = segment.value === current;
       return /*#__PURE__*/_jsxs(Pressable, {
         onPress: () => handlePress(segment),
         disabled: disabled,