@momo-kits/foundation 0.168.1-beta.16 → 0.168.1-beta.17

package/Application/BottomTab/DuoTabBar.tsx

@@ -1,17 +1,16 @@
 import { BottomTabBarProps } from '@react-navigation/bottom-tabs';
 import { CommonActions, Route } from '@react-navigation/native';
-import React, { useContext, useEffect, useRef, useState } from 'react';
+import React, { ReactNode, useContext, useMemo, useRef, useState } from 'react';
 import {
   LayoutChangeEvent,
+  StyleProp,
   StyleSheet,
   TouchableOpacity,
   View,
+  ViewStyle,
 } from 'react-native';
-import Animated, {
-  useAnimatedStyle,
-  useSharedValue,
-  withSpring,
-} from 'react-native-reanimated';
+import { GestureDetector } from 'react-native-gesture-handler';
+import Animated from 'react-native-reanimated';
 import { Colors, Radius, Spacing } from '../../Consts';
 import { ApplicationContext, MiniAppContext } from '../../Context';
 import { Icon } from '../../Icon';
@@ -20,6 +19,12 @@ import { Text } from '../../Text';
 import { useDuoBarCompression } from './DuoBarCompression';
 import { FloatingButtonProps } from '../types';
 import { TabBarIcon } from './TabBarIcon';
+import {
+  LiquidSelection,
+  useLiquidItem,
+  useLiquidSelection,
+  usePressLift,
+} from './useLiquidSelection';
 
 type Props = BottomTabBarProps & {
   activeTintColor: string;
@@ -40,11 +45,7 @@ const FLOATING_HEIGHT = DuoMetrics.floatingTabBarHeight;
 const FLOATING_PADDING = Spacing.XS;
 // the system bar sizes its pill to the tabs instead of stretching it across the display
 const FLOATING_ITEM_WIDTH = 80;
-// while pressed the selection bubble grows into a lens past the pill's edges, wider and taller (80x54 to about 96x70)
-const LENS_SCALE_X = 1.2;
-const LENS_SCALE_Y = 1.3;
 const FLOATING_BUBBLE_RADIUS = (FLOATING_HEIGHT - 2 * FLOATING_PADDING) / 2;
-const SPRING = { damping: 18, stiffness: 220, mass: 0.8 };
 
 /**
  * distance from the screen bottom to the floating tab bar, overlapping the home
@@ -121,11 +122,7 @@ const TabLabel: React.FC<{
         fontScale: { useOSScaleRate: false, userScaleRate: 1 },
       }}
     >
-      <Text
-        numberOfLines={1}
-        typography={typography}
-        color={color}
-      >
+      <Text numberOfLines={1} typography={typography} color={color}>
         {label}
       </Text>
     </MiniAppContext.Provider>
@@ -162,21 +159,22 @@ const getTabItems = ({
       navigation.emit({ type: 'tabLongPress', target: route.key });
     };
 
-    const icon = options.tabBarIcon && (
-      <TabBarIcon
-        route={route}
-        badge={options.tabBarBadge}
-        badgeStyle={options.tabBarBadgeStyle}
-        activeOpacity={focused ? 1 : 0}
-        inactiveOpacity={focused ? 0 : 1}
-        activeTintColor={activeTintColor}
-        inactiveTintColor={inactiveTintColor}
-        renderIcon={options.tabBarIcon}
-        style={styles.icon}
-      />
-    );
-
-    return { route, focused, label, onPress, onLongPress, icon };
+    const renderIcon = (active: boolean) =>
+      options.tabBarIcon && (
+        <TabBarIcon
+          route={route}
+          badge={options.tabBarBadge}
+          badgeStyle={options.tabBarBadgeStyle}
+          activeOpacity={active ? 1 : 0}
+          inactiveOpacity={active ? 0 : 1}
+          activeTintColor={activeTintColor}
+          inactiveTintColor={inactiveTintColor}
+          renderIcon={options.tabBarIcon}
+          style={styles.icon}
+        />
+      );
+
+    return { route, focused, label, onPress, onLongPress, renderIcon };
   });
 };
 
@@ -192,6 +190,58 @@ const QrIcon: React.FC<{ icon: FloatingButtonProps['icon']; size: number }> = ({
 
 type TabItem = ReturnType<typeof getTabItems>[number];
 
+/**
+ * tab item: a tap is handled here as before, a drag over the bar is handled by the bar's
+ * gesture. The active layer fades in as the lens passes over it
+ */
+const LiquidTabItem: React.FC<{
+  item: TabItem;
+  itemIndex: number;
+  selection: LiquidSelection;
+  onSelect: () => void;
+  renderContent: (active: boolean) => ReactNode;
+  style: StyleProp<ViewStyle>;
+}> = ({ item, itemIndex, selection, onSelect, renderContent, style }) => {
+  const { activeStyle, popStyle } = useLiquidItem(selection, itemIndex);
+  const activeLayerStyle = useMemo(
+    () => [StyleSheet.absoluteFill, styles.itemLayer, activeStyle],
+    [activeStyle],
+  );
+  // like the system tab bar, a held tab is still picked when released
+  const longPressed = useRef(false);
+
+  return (
+    <TouchableOpacity
+      accessibilityRole={'tab'}
+      accessibilityLabel={item.label}
+      accessibilityState={{ selected: item.focused }}
+      activeOpacity={1}
+      onPressIn={() => {
+        longPressed.current = false;
+        selection.pressIn(itemIndex);
+      }}
+      onPressOut={() => {
+        if (selection.pressOut() && longPressed.current) {
+          onSelect();
+        }
+      }}
+      onPress={onSelect}
+      onLongPress={() => {
+        longPressed.current = true;
+        item.onLongPress();
+      }}
+      style={style}
+    >
+      <Animated.View style={popStyle}>
+        <View style={styles.itemLayer}>{renderContent(false)}</View>
+        <Animated.View style={activeLayerStyle}>
+          {renderContent(true)}
+        </Animated.View>
+      </Animated.View>
+    </TouchableOpacity>
+  );
+};
+
 /**
  * column of icon-only tab items with the sliding selection bubble
  */
@@ -200,56 +250,47 @@ const Rail: React.FC<{
   index: number;
   onItemPress?: () => void;
 }> = ({ items, index, onItemPress }) => {
-  const bubbleOffset = useSharedValue(index * RAIL_PITCH);
-  const lens = useSharedValue(0);
-
-  useEffect(() => {
-    bubbleOffset.value = withSpring(index * RAIL_PITCH, SPRING);
-  }, [index, bubbleOffset]);
-
-  const bubbleStyle = useAnimatedStyle(() => ({
-    transform: [
-      { translateY: bubbleOffset.value },
-      { scaleX: 1 + lens.value * (LENS_SCALE_X - 1) },
-      { scaleY: 1 + lens.value * (LENS_SCALE_Y - 1) },
-    ],
-  }));
+  const onSelect = (itemIndex: number) => {
+    items[itemIndex]?.onPress();
+    onItemPress?.();
+  };
+  const selection = useLiquidSelection({
+    count: items.length,
+    pitch: RAIL_PITCH,
+    firstCenter: RAIL_PADDING + ITEM_SIZE / 2,
+    axis: 'y',
+    index,
+    onSelect,
+  });
+  const { barStyle, bubbleStyle } = selection;
+  // stable style arrays: the tab switch re-renders the rail while the lens is still
+  // springing back, a new array would re-attach the animated style mid animation
+  const railStyle = useMemo(() => [styles.rail, barStyle], [barStyle]);
+  const railBubbleStyle = useMemo(
+    () => [styles.railBubble, bubbleStyle],
+    [bubbleStyle],
+  );
 
   return (
-    <View style={styles.rail} accessibilityLabel={'bottom_tab_bar'}>
-      <BarMaterial radius={ITEM_SIZE / 2} />
-      <Animated.View
-        pointerEvents={'none'}
-        style={[styles.railBubble, bubbleStyle]}
-      >
-        <SelectionMaterial radius={RAIL_BUBBLE_WIDTH / 2} />
+    <GestureDetector gesture={selection.gesture}>
+      <Animated.View style={railStyle} accessibilityLabel={'bottom_tab_bar'}>
+        <BarMaterial radius={ITEM_SIZE / 2} />
+        <Animated.View pointerEvents={'none'} style={railBubbleStyle}>
+          <SelectionMaterial radius={RAIL_BUBBLE_WIDTH / 2} />
+        </Animated.View>
+        {items.map((item, itemIndex) => (
+          <LiquidTabItem
+            key={item.route.key}
+            item={item}
+            itemIndex={itemIndex}
+            selection={selection}
+            onSelect={() => onSelect(itemIndex)}
+            renderContent={item.renderIcon}
+            style={styles.railItem}
+          />
+        ))}
       </Animated.View>
-      {items.map((item, itemIndex) => (
-        <TouchableOpacity
-          key={item.route.key}
-          accessibilityRole={'tab'}
-          accessibilityLabel={item.label}
-          accessibilityState={{ selected: item.focused }}
-          activeOpacity={1}
-          onPressIn={() => {
-            bubbleOffset.value = withSpring(itemIndex * RAIL_PITCH, SPRING);
-            lens.value = withSpring(1, SPRING);
-          }}
-          onPressOut={() => {
-            bubbleOffset.value = withSpring(index * RAIL_PITCH, SPRING);
-            lens.value = withSpring(0, SPRING);
-          }}
-          onPress={() => {
-            item.onPress();
-            onItemPress?.();
-          }}
-          onLongPress={item.onLongPress}
-          style={styles.railItem}
-        >
-          {item.icon}
-        </TouchableOpacity>
-      ))}
-    </View>
+    </GestureDetector>
   );
 };
 
@@ -263,6 +304,7 @@ const DuoRailTabBar: React.FC<Props> = props => {
   const { sideBar } = useScreenLayout();
   const { tabBarCompressed, expandTabBar, onTabSelected } =
     useDuoBarCompression();
+  const compactLift = usePressLift();
   const { state, floatingButton } = props;
   const items = getTabItems(props);
   const current = items[state.index];
@@ -303,16 +345,21 @@ const DuoRailTabBar: React.FC<Props> = props => {
 
   return (
     <View pointerEvents={'box-none'} style={columnStyle}>
-      <TouchableOpacity
-        accessibilityRole={'button'}
-        accessibilityLabel={current?.label}
-        accessibilityHint={'bottom_tab_bar'}
-        onPress={expandTabBar}
-        style={styles.railCompact}
-      >
-        <BarMaterial radius={Radius.XL} />
-        {current?.icon}
-      </TouchableOpacity>
+      <Animated.View style={compactLift.style}>
+        <TouchableOpacity
+          accessibilityRole={'button'}
+          accessibilityLabel={current?.label}
+          accessibilityHint={'bottom_tab_bar'}
+          activeOpacity={1}
+          onPressIn={compactLift.onPressIn}
+          onPressOut={compactLift.onPressOut}
+          onPress={expandTabBar}
+          style={styles.railCompact}
+        >
+          <BarMaterial radius={Radius.XL} />
+          {current?.renderIcon(true)}
+        </TouchableOpacity>
+      </Animated.View>
       {qr}
     </View>
   );
@@ -330,24 +377,29 @@ const DuoFloatingTabBar: React.FC<Props> = props => {
   const [rowWidth, setRowWidth] = useState(0);
   const cellWidth = rowWidth / state.routes.length;
 
-  const bubbleOffset = useSharedValue(0);
-  const lens = useSharedValue(0);
-  const measured = useRef(false);
-
-  useEffect(() => {
-    const target = state.index * cellWidth;
-    // snap on first layout so the bubble doesn't slide in from the left edge
-    bubbleOffset.value = measured.current ? withSpring(target, SPRING) : target;
-    measured.current = cellWidth > 0;
-  }, [state.index, cellWidth, bubbleOffset]);
-
-  const bubbleStyle = useAnimatedStyle(() => ({
-    transform: [
-      { translateX: bubbleOffset.value },
-      { scaleX: 1 + lens.value * (LENS_SCALE_X - 1) },
-      { scaleY: 1 + lens.value * (LENS_SCALE_Y - 1) },
+  const selection = useLiquidSelection({
+    count: items.length,
+    pitch: cellWidth,
+    firstCenter: cellWidth / 2,
+    axis: 'x',
+    index: state.index,
+    onSelect: itemIndex => items[itemIndex]?.onPress(),
+  });
+  const { barStyle, bubbleStyle } = selection;
+  const tabCount = state.routes.length;
+  // stable style arrays, see Rail
+  const floatingBarStyle = useMemo(
+    () => [
+      styles.floatingBar,
+      { width: tabCount * FLOATING_ITEM_WIDTH + 2 * FLOATING_PADDING },
+      barStyle,
     ],
-  }));
+    [tabCount, barStyle],
+  );
+  const floatingBubbleStyle = useMemo(
+    () => [styles.floatingBubble, { width: cellWidth }, bubbleStyle],
+    [cellWidth, bubbleStyle],
+  );
 
   const onRowLayout = (e: LayoutChangeEvent) =>
     setRowWidth(e.nativeEvent.layout.width);
@@ -364,57 +416,41 @@ const DuoFloatingTabBar: React.FC<Props> = props => {
         },
       ]}
     >
-      <View
-        style={[
-          styles.floatingBar,
-          {
-            width:
-              state.routes.length * FLOATING_ITEM_WIDTH + 2 * FLOATING_PADDING,
-          },
-        ]}
+      <Animated.View
+        style={floatingBarStyle}
         accessibilityLabel={'bottom_tab_bar'}
       >
         <BarMaterial radius={FLOATING_HEIGHT / 2} />
-        <View style={styles.floatingRow} onLayout={onRowLayout}>
-          {rowWidth > 0 && (
-            <Animated.View
-              pointerEvents={'none'}
-              style={[styles.floatingBubble, { width: cellWidth }, bubbleStyle]}
-            >
-              <SelectionMaterial radius={FLOATING_BUBBLE_RADIUS} />
-            </Animated.View>
-          )}
-          {items.map((item, index) => (
-            <TouchableOpacity
-              key={item.route.key}
-              accessibilityRole={'tab'}
-              accessibilityLabel={item.label}
-              accessibilityState={{ selected: item.focused }}
-              activeOpacity={1}
-              onPressIn={() => {
-                // the lens jumps to the pressed tab, not only the selected one
-                bubbleOffset.value = withSpring(index * cellWidth, SPRING);
-                lens.value = withSpring(1, SPRING);
-              }}
-              onPressOut={() => {
-                // onPress follows synchronously, a tab switch re-targets the bubble
-                bubbleOffset.value = withSpring(state.index * cellWidth, SPRING);
-                lens.value = withSpring(0, SPRING);
-              }}
-              onPress={item.onPress}
-              onLongPress={item.onLongPress}
-              style={styles.floatingItem}
-            >
-              {item.icon}
-              <TabLabel
-                label={item.label}
-                typography={'label_xs_medium'}
-                color={item.focused ? activeTintColor : inactiveTintColor}
+        <GestureDetector gesture={selection.gesture}>
+          <View style={styles.floatingRow} onLayout={onRowLayout}>
+            {rowWidth > 0 && (
+              <Animated.View pointerEvents={'none'} style={floatingBubbleStyle}>
+                <SelectionMaterial radius={FLOATING_BUBBLE_RADIUS} />
+              </Animated.View>
+            )}
+            {items.map((item, index) => (
+              <LiquidTabItem
+                key={item.route.key}
+                item={item}
+                itemIndex={index}
+                selection={selection}
+                onSelect={item.onPress}
+                renderContent={active => (
+                  <>
+                    {item.renderIcon(active)}
+                    <TabLabel
+                      label={item.label}
+                      typography={'label_xs_medium'}
+                      color={active ? activeTintColor : inactiveTintColor}
+                    />
+                  </>
+                )}
+                style={styles.floatingItem}
               />
-            </TouchableOpacity>
-          ))}
-        </View>
-      </View>
+            ))}
+          </View>
+        </GestureDetector>
+      </Animated.View>
       {floatingButton && (
         <TouchableOpacity
           accessibilityRole={'button'}
@@ -518,6 +554,10 @@ const styles = StyleSheet.create({
     flex: 1,
     alignItems: 'center',
     justifyContent: 'center',
+  },
+  itemLayer: {
+    alignItems: 'center',
+    justifyContent: 'center',
     gap: Spacing.XXS,
   },
   // pink fills the whole pinned platter

package/Application/BottomTab/useLiquidSelection.ts

@@ -0,0 +1,374 @@
+import { useCallback, useContext, useEffect, useMemo, useRef } from 'react';
+import { Gesture } from 'react-native-gesture-handler';
+import {
+  clamp,
+  useAnimatedReaction,
+  useAnimatedStyle,
+  useReducedMotion,
+  useSharedValue,
+  withSequence,
+  withSpring,
+  withTiming,
+} from 'react-native-reanimated';
+import { scheduleOnRN } from 'react-native-worklets';
+import { ApplicationContext } from '../../Context';
+
+type Axis = 'x' | 'y';
+
+type Options = {
+  count: number;
+  // distance between two neighbouring tab centers
+  pitch: number;
+  // position of the first tab's center inside the gesture view
+  firstCenter: number;
+  axis: Axis;
+  index: number;
+  onSelect: (index: number) => void;
+};
+
+const SPRING = { damping: 18, stiffness: 220, mass: 0.8 };
+// the lens trails the finger a little while dragged, like the system tab bar
+const DRAG_SPRING = { damping: 24, stiffness: 600, mass: 0.6 };
+const REDUCED_TIMING = { duration: 200 };
+// while pressed the selection bubble grows into a lens past the bar's edges (80x54 to about 96x70)
+const LENS_SCALE_X = 1.2;
+const LENS_SCALE_Y = 1.3;
+// a moving lens stretches along its path and thins across it, eased per frame so the
+// shape follows the speed smoothly
+const STRETCH_PER_POINT = 0.012;
+const MAX_STRETCH = 0.25;
+const STRETCH_EASING = 0.25;
+// once eased below this the lens is round again
+const REST_STRETCH = 0.002;
+// a tap is shorter than the lift: the lens finishes rising, then settles, one smooth pulse
+const TAP_LIFT_DURATION = 120;
+// the bar swells a little under the finger
+const BAR_SWELL = 0.04;
+// the tab the lens lands on pops
+const ICON_POP = 1.15;
+// movement before a press turns into a drag, below it the tab's touchable handles the tap
+const DRAG_SLOP = 10;
+// UIScrollView rubber band constant
+const RUBBER_BAND = 0.55;
+// a cancelled press or a prevented switch: the lens returns to the selected tab after this
+const RESYNC_DELAY = 100;
+
+/**
+ * resistance past the first and last tab, the further the finger goes the less the lens follows
+ */
+const rubberBand = (value: number, max: number, dimension: number) => {
+  'worklet';
+  const band = (overshoot: number) =>
+    (1 - 1 / ((overshoot * RUBBER_BAND) / dimension + 1)) * dimension;
+  if (value < 0) {
+    return -band(-value);
+  }
+  if (value > max) {
+    return max + band(value - max);
+  }
+  return value;
+};
+
+/**
+ * iOS 26 tab bar selection motion, without the glass material:
+ * - press lifts the selection into a lens over the pressed tab and swells the bar, release
+ *   settles it back (the tab's touchable drives this through pressIn / pressOut)
+ * - dragging slides the lens under the finger, stretched by its speed and rubber banded
+ *   past the ends, with a tick on each tab it enters; releasing selects the tab under it.
+ *   The drag cancels the touchable once it activates, so a press is either a tap or a drag
+ */
+const useLiquidSelection = ({
+  count,
+  pitch,
+  firstCenter,
+  axis,
+  index,
+  onSelect,
+}: Options) => {
+  const { navigator } = useContext<any>(ApplicationContext);
+  const reduceMotion = useReducedMotion();
+
+  const offset = useSharedValue(index * pitch);
+  // where the lens is heading, so a re-render doesn't restart a spring already going there
+  const destination = useSharedValue(index * pitch);
+  const selected = useSharedValue(index);
+  const hovered = useSharedValue(index);
+  const lift = useSharedValue(0);
+  const dragging = useSharedValue(false);
+  const stretch = useSharedValue(0);
+  const metrics = useSharedValue({ count, pitch, firstCenter });
+  const measured = useRef(pitch > 0);
+
+  const indexRef = useRef(index);
+  const pitchRef = useRef(pitch);
+  // read through refs so the gesture is never rebuilt mid drag
+  const callbacks = useRef({ onSelect, navigator });
+  indexRef.current = index;
+  pitchRef.current = pitch;
+  callbacks.current = { onSelect, navigator };
+
+  useEffect(() => {
+    metrics.value = { count, pitch, firstCenter };
+  }, [count, pitch, firstCenter, metrics]);
+
+  const move = useCallback(
+    (target: number, velocity: number, config: typeof SPRING) => {
+      'worklet';
+      if (destination.value === target && velocity === 0) {
+        return;
+      }
+      destination.value = target;
+      offset.value = reduceMotion
+        ? withTiming(target, REDUCED_TIMING)
+        : withSpring(target, { ...config, velocity });
+    },
+    [offset, destination, reduceMotion],
+  );
+
+  useEffect(() => {
+    const target = index * pitch;
+    selected.value = index;
+    // snap on first layout so the lens doesn't slide in from the leading edge
+    if (measured.current) {
+      move(target, 0, SPRING);
+    } else {
+      destination.value = target;
+      offset.value = target;
+    }
+    measured.current = pitch > 0;
+  }, [index, pitch, offset, destination, selected, move]);
+
+  useAnimatedReaction(
+    () => offset.value,
+    (current, previous) => {
+      if (previous === null || reduceMotion) {
+        return;
+      }
+      const target = Math.min(
+        Math.abs(current - previous) * STRETCH_PER_POINT,
+        MAX_STRETCH,
+      );
+      // eased both ways: a slow frame (e.g. the spring turning at its overshoot) must not
+      // snap the shape
+      const next = stretch.value + (target - stretch.value) * STRETCH_EASING;
+      stretch.value = next < REST_STRETCH ? 0 : next;
+    },
+    [reduceMotion],
+  );
+
+  /**
+   * returns the lens to the selected tab unless a switch to where it is heading happened
+   */
+  const resync = useCallback(() => {
+    setTimeout(() => {
+      const target = indexRef.current * pitchRef.current;
+      if (!dragging.value && destination.value !== target) {
+        move(target, 0, SPRING);
+      }
+    }, RESYNC_DELAY);
+  }, [destination, dragging, move]);
+
+  const pressIn = (itemIndex: number) => {
+    // the lens heads to the pressed tab, not only the selected one
+    move(itemIndex * pitch, 0, SPRING);
+    if (!reduceMotion) {
+      lift.value = withSpring(1, SPRING);
+    }
+  };
+
+  /**
+   * false when a drag took the press over
+   */
+  const pressOut = () => {
+    // a drag taking over cancels the touchable, the drag owns the lens from there
+    if (dragging.value) {
+      return false;
+    }
+    if (!reduceMotion) {
+      lift.value = withSequence(
+        withTiming(1, { duration: TAP_LIFT_DURATION }),
+        withSpring(0, SPRING),
+      );
+    }
+    // the lens keeps heading to the pressed tab: onPress switches to it, and a cancelled
+    // press brings it back
+    resync();
+    return true;
+  };
+
+  const tick = useCallback(() => {
+    callbacks.current.navigator?.maxApi?.triggerEventVibration?.('light');
+  }, []);
+
+  const select = useCallback(
+    (target: number) => {
+      callbacks.current.onSelect(target);
+      resync();
+    },
+    [resync],
+  );
+
+  const gesture = useMemo(() => {
+    const position = (e: { x: number; y: number }) => {
+      'worklet';
+      return (axis === 'x' ? e.x : e.y) - metrics.value.firstCenter;
+    };
+    const nearest = (value: number) => {
+      'worklet';
+      const { count: tabs, pitch: step } = metrics.value;
+      return step > 0 ? clamp(Math.round(value / step), 0, tabs - 1) : 0;
+    };
+
+    return Gesture.Pan()
+      .minDistance(DRAG_SLOP)
+      .shouldCancelWhenOutside(false)
+      .onStart(e => {
+        dragging.value = true;
+        hovered.value = nearest(position(e));
+        if (!reduceMotion) {
+          lift.value = withSpring(1, SPRING);
+        }
+      })
+      .onUpdate(e => {
+        const { count: tabs, pitch: step } = metrics.value;
+        const value = position(e);
+        const target = nearest(value);
+        if (target !== hovered.value) {
+          hovered.value = target;
+          scheduleOnRN(tick);
+        }
+        const follow = rubberBand(value, (tabs - 1) * step, step);
+        if (reduceMotion) {
+          destination.value = follow;
+          offset.value = follow;
+        } else {
+          move(follow, 0, DRAG_SPRING);
+        }
+      })
+      .onEnd((e, success) => {
+        dragging.value = false;
+        lift.value = reduceMotion ? 0 : withSpring(0, SPRING);
+        const raw = axis === 'x' ? e.velocityX : e.velocityY;
+        const velocity = Number.isFinite(raw) ? raw : 0;
+        if (!success) {
+          move(selected.value * metrics.value.pitch, velocity, SPRING);
+          return;
+        }
+        const target = nearest(position(e));
+        move(target * metrics.value.pitch, velocity, SPRING);
+        scheduleOnRN(select, target);
+      });
+  }, [
+    axis,
+    reduceMotion,
+    offset,
+    destination,
+    selected,
+    hovered,
+    lift,
+    dragging,
+    metrics,
+    move,
+    tick,
+    select,
+  ]);
+
+  const bubbleStyle = useAnimatedStyle(() => {
+    const along = 1 + stretch.value;
+    const across = 1 - stretch.value * 0.5;
+    const lensX = 1 + lift.value * (LENS_SCALE_X - 1);
+    const lensY = 1 + lift.value * (LENS_SCALE_Y - 1);
+    return {
+      transform:
+        axis === 'x'
+          ? [
+              { translateX: offset.value },
+              { scaleX: lensX * along },
+              { scaleY: lensY * across },
+            ]
+          : [
+              { translateY: offset.value },
+              { scaleX: lensX * across },
+              { scaleY: lensY * along },
+            ],
+    };
+  });
+
+  const barStyle = useAnimatedStyle(() => ({
+    transform: [{ scale: 1 + lift.value * BAR_SWELL }],
+  }));
+
+  return {
+    gesture,
+    bubbleStyle,
+    barStyle,
+    pressIn,
+    pressOut,
+    offset,
+    selected,
+    pitch,
+    reduceMotion,
+  };
+};
+
+type LiquidSelection = ReturnType<typeof useLiquidSelection>;
+
+/**
+ * active tint of a tab follows the lens over it, and the tab the lens lands on pops
+ */
+const useLiquidItem = (
+  { offset, selected, pitch, reduceMotion }: LiquidSelection,
+  itemIndex: number,
+) => {
+  const pop = useSharedValue(1);
+
+  useAnimatedReaction(
+    () => selected.value === itemIndex,
+    (isSelected, wasSelected) => {
+      if (isSelected && wasSelected === false && !reduceMotion) {
+        pop.value = withSequence(
+          withTiming(ICON_POP, { duration: 120 }),
+          withSpring(1, SPRING),
+        );
+      }
+    },
+    [itemIndex, reduceMotion],
+  );
+
+  const activeStyle = useAnimatedStyle(() => {
+    if (pitch <= 0) {
+      return { opacity: selected.value === itemIndex ? 1 : 0 };
+    }
+    const distance = Math.abs(offset.value - itemIndex * pitch) / pitch;
+    return { opacity: clamp(1 - distance, 0, 1) };
+  });
+
+  const popStyle = useAnimatedStyle(() => ({
+    transform: [{ scale: pop.value }],
+  }));
+
+  return { activeStyle, popStyle };
+};
+
+/**
+ * lift for a single button, e.g. the compressed rail
+ */
+const usePressLift = () => {
+  const reduceMotion = useReducedMotion();
+  const lift = useSharedValue(0);
+  const style = useAnimatedStyle(() => ({
+    transform: [{ scale: 1 + lift.value * (LENS_SCALE_X - 1) * 0.5 }],
+  }));
+  const onPressIn = () => {
+    if (!reduceMotion) {
+      lift.value = withSpring(1, SPRING);
+    }
+  };
+  const onPressOut = () => {
+    lift.value = withSpring(0, SPRING);
+  };
+  return { style, onPressIn, onPressOut };
+};
+
+export type { LiquidSelection };
+export { useLiquidSelection, useLiquidItem, usePressLift };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@momo-kits/foundation",
-    "version": "0.168.1-beta.16",
+    "version": "0.168.1-beta.17",
     "description": "React Native Component Kits",
     "main": "index.ts",
     "scripts": {},