@oxyhq/bloom 0.79.1 → 0.80.0

package/lib/module/tabs/expo-router/RouterTabs.js

@@ -0,0 +1,210 @@
+"use strict";
+
+/**
+ * expo-router bindings for the in-screen tab strip.
+ *
+ * This subpath (`@oxyhq/bloom/tabs/expo-router`) is the ONLY place in the tabs
+ * feature allowed to import `expo-router`, which is why it is a separate entry:
+ * the core `@oxyhq/bloom/tabs` stays usable in an app with a different router,
+ * or none, and the optional peer is never pulled into a bundle that does not
+ * ask for it. Same split as `tab-bar` / `tab-bar/expo-router` and
+ * `scroll` / `scroll/expo-router`.
+ *
+ * Everything routing-shaped lives here on purpose: which tab the route means,
+ * what a committed swipe navigates to, and which links to warm. The strip
+ * itself stays presentational and knows only about measured geometry.
+ */
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import { Gesture, GestureDetector } from 'react-native-gesture-handler';
+import { runOnJS } from 'react-native-reanimated';
+import { router, usePathname } from 'expo-router';
+import { Tabs, TabsTrigger } from "../Tabs.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Resolve which item the current route belongs to.
+ *
+ * LONGEST matching prefix, on a segment boundary — not an exact match. All
+ * three properties matter:
+ *
+ * - A prefix is needed because a tab may own a subtree (`/feeds/1/topics` and
+ *   anything under it), and an exact match would drop the underline the moment
+ *   the user goes one level deeper.
+ * - LONGEST is needed because the default tab's href is a prefix of every
+ *   sibling's (`/@ana` vs `/@ana/replies`), so a first-match rule would light
+ *   up the default tab on every tab.
+ * - The segment boundary is what stops `/feeds/12` from matching `/feeds/1`.
+ *
+ * Returns `undefined` when nothing matches, which is a real state — a strip
+ * rendered by a LAYOUT keeps rendering while a child route outside the tab set
+ * is showing — and leaves the underline hidden rather than parked on a lie.
+ */
+function matchActiveValue(items, pathname) {
+  let best;
+  for (const item of items) {
+    // `Href` is a string or an object; only a string form can be compared to a
+    // pathname, and an object form describes params we cannot resolve here.
+    if (typeof item.href !== 'string') continue;
+    // Compare paths only: a query string describes what the tab shows, not
+    // which tab it is, and a trailing slash is the same route either way.
+    const [path = ''] = item.href.split('?');
+    const href = path.replace(/\/$/, '');
+    const isMatch = pathname === href || pathname.startsWith(`${href}/`);
+    if (!isMatch) continue;
+    if (!best || href.length > best.length) {
+      best = {
+        value: item.value,
+        length: href.length
+      };
+    }
+  }
+  return best?.value;
+}
+
+/**
+ * A tab strip whose selection IS the route.
+ *
+ * Render it in the LAYOUT that owns the tabs, above the `<Slot/>` that renders
+ * them — not inside the tab screens themselves. That placement is the whole
+ * point, and it is load-bearing twice over: a strip inside the screens is
+ * unmounted and rebuilt by every navigation, so its underline has nothing to
+ * animate from and the chrome blanks while the incoming route's chunk loads;
+ * and a GESTURE inside the screens would be destroyed by the very navigation it
+ * commits, mid-release.
+ *
+ * ```tsx
+ * // app/(app)/[username]/_layout.tsx
+ * <RouterTabs
+ *   items={[
+ *     { value: 'posts', label: 'Posts', href: `/${username}` },
+ *     { value: 'replies', label: 'Replies', href: `/${username}/replies` },
+ *   ]}
+ * />
+ * <Slot />
+ * ```
+ */
+export function RouterTabs({
+  items,
+  onReselect,
+  swipeEnabled = true,
+  ...tabsProps
+}) {
+  const pathname = usePathname();
+  const activeValue = useMemo(() => matchActiveValue(items, pathname), [items, pathname]);
+  const dragRef = useRef(null);
+  // What releasing right now would commit. A ref rather than state: it is
+  // written on every frame of the drag and read once, and re-rendering the
+  // strip mid-gesture would fight the animation the gesture is driving.
+  const pendingRef = useRef(null);
+  const navigateTo = useCallback(value => {
+    const target = items.find(item => item.value === value);
+    if (!target) return;
+    // PUSH, not replace: a history entry per tab is what makes Back return to
+    // the tab the reader came from instead of leaving the screen entirely.
+    router.push(target.href);
+  }, [items]);
+  const handlePress = useCallback(item => {
+    if (item.value === activeValue) {
+      onReselect?.(item.value);
+      return;
+    }
+    navigateTo(item.value);
+  }, [activeValue, onReselect, navigateTo]);
+  const onDrag = useCallback(translationX => {
+    pendingRef.current = dragRef.current?.drag(translationX) ?? null;
+  }, []);
+
+  // `onEnd` does not fire for every terminated gesture, and `onFinalize` fires
+  // for all of them — including after `onEnd`. Guarding on the ref being
+  // non-null is what makes the second call a no-op instead of a double commit.
+  const releasedRef = useRef(true);
+  const onRelease = useCallback(() => {
+    if (releasedRef.current) return;
+    releasedRef.current = true;
+    const committed = pendingRef.current;
+    pendingRef.current = null;
+    // The underline commits first and instantly: it lives in the layout, it
+    // survives the swap, and it is the honest signal the gesture was accepted.
+    // The content area arrives when its chunk does.
+    dragRef.current?.release(committed);
+    if (committed !== null) navigateTo(committed);
+  }, [navigateTo]);
+  const onBegin = useCallback(() => {
+    releasedRef.current = false;
+  }, []);
+  const panGesture = useMemo(() => Gesture.Pan()
+  // Horizontal intent only. This is a hint to the gesture system and is
+  // NOT what protects vertical scrolling on web — see `touchAction` below.
+  .activeOffsetX([-12, 12]).failOffsetY([-12, 12]).onBegin(() => {
+    runOnJS(onBegin)();
+  }).onUpdate(event => {
+    runOnJS(onDrag)(event.translationX);
+  }).onFinalize(() => {
+    runOnJS(onRelease)();
+  }), [onBegin, onDrag, onRelease]);
+
+  // Warm every OTHER tab's async chunk. That fetch is the ~300ms the content
+  // area would otherwise spend empty after a commit, and a swipe offers no
+  // hover to warm on, so it is done up front rather than on interaction.
+  //
+  // `router.prefetch` — the public imperative API (declared in expo-router's
+  // `global-state/router.d.ts`) — rather than wrapping each trigger in
+  // `<Link prefetch asChild>`. Both reasons are about the WRAPPER, not about
+  // prefetching: `asChild` is Radix's `Slot`, which COMPOSES event handlers, so
+  // the trigger's own `onPress` and the link's navigation would both run — and
+  // the link's push knows nothing about `onReselect`, so re-tapping the active
+  // tab would push a duplicate entry and make Back appear to do nothing. It
+  // also injects an `href` a `Pressable` ignores. The prefetching itself is
+  // identical: `<Link prefetch>` renders `<Prefetch href/>` beside its element
+  // and does nothing else.
+  //
+  // Known trade: a real `<Link>` would render a web anchor, which is what gives
+  // middle-click and open-in-new-tab. A tab strip arguably wants that; getting
+  // both needs the trigger to render an anchor itself, which is a change to the
+  // core rather than to this file.
+  useEffect(() => {
+    for (const item of items) {
+      if (item.value === activeValue || item.disabled) continue;
+      router.prefetch(item.href);
+    }
+  }, [items, activeValue]);
+  const strip =
+  /*#__PURE__*/
+  // `hasSelection` is what stops the underline asserting a tab while a
+  // NON-TAB sibling route is showing — the layout that renders this strip
+  // renders those too (a profile's `/followers` beside its tab routes).
+  _jsx(Tabs, {
+    ...tabsProps,
+    ref: dragRef,
+    hasSelection: activeValue !== undefined,
+    children: items.map(item => /*#__PURE__*/_jsx(TabsTrigger, {
+      value: item.value,
+      label: item.label,
+      icon: item.icon,
+      count: item.count,
+      disabled: item.disabled
+      // Focus, never a press, is what drives the underline — so a deep
+      // link, a browser Back and a back gesture animate exactly like a tap.
+      ,
+      isFocused: item.value === activeValue,
+      onPress: () => handlePress(item)
+    }, item.value))
+  });
+  if (!swipeEnabled) return strip;
+  return (
+    /*#__PURE__*/
+    // `touchAction="pan-y"` is MANDATORY and is the landmine of this file.
+    // RNGH sets the detector's view to `touch-action: none` on web
+    // (`GestureHandlerWebDelegate.js`), which disables browser-native VERTICAL
+    // scrolling on that element. `failOffsetY` above does not protect against
+    // it: that is a JS decision taken after `touch-action` has already told the
+    // browser not to scroll. Removing this prop is silent on native and breaks
+    // scrolling on mobile web.
+    _jsx(GestureDetector, {
+      gesture: panGesture,
+      touchAction: "pan-y",
+      children: strip
+    })
+  );
+}
+RouterTabs.displayName = 'RouterTabs';
+//# sourceMappingURL=RouterTabs.js.map

package/lib/module/tabs/expo-router/RouterTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useMemo","useRef","Gesture","GestureDetector","runOnJS","router","usePathname","Tabs","TabsTrigger","jsx","_jsx","matchActiveValue","items","pathname","best","item","href","path","split","replace","isMatch","startsWith","length","value","RouterTabs","onReselect","swipeEnabled","tabsProps","activeValue","dragRef","pendingRef","navigateTo","target","find","push","handlePress","onDrag","translationX","current","drag","releasedRef","onRelease","committed","release","onBegin","panGesture","Pan","activeOffsetX","failOffsetY","onUpdate","event","onFinalize","disabled","prefetch","strip","ref","hasSelection","undefined","children","map","label","icon","count","isFocused","onPress","gesture","touchAction","displayName"],"sourceRoot":"../../../../src","sources":["tabs/expo-router/RouterTabs.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,WAAW,EAAEC,SAAS,EAAEC,OAAO,EAAEC,MAAM,QAAwB,OAAO;AAC/E,SAASC,OAAO,EAAEC,eAAe,QAAQ,8BAA8B;AACvE,SAASC,OAAO,QAAQ,yBAAyB;AACjD,SAASC,MAAM,EAAEC,WAAW,QAAmB,aAAa;AAE5D,SAASC,IAAI,EAAEC,WAAW,QAAiC,YAAS;AAAC,SAAAC,GAAA,IAAAC,IAAA;AA8CrE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,gBAAgBA,CAACC,KAAsB,EAAEC,QAAgB,EAAsB;EACtF,IAAIC,IAAmD;EACvD,KAAK,MAAMC,IAAI,IAAIH,KAAK,EAAE;IACxB;IACA;IACA,IAAI,OAAOG,IAAI,CAACC,IAAI,KAAK,QAAQ,EAAE;IACnC;IACA;IACA,MAAM,CAACC,IAAI,GAAG,EAAE,CAAC,GAAGF,IAAI,CAACC,IAAI,CAACE,KAAK,CAAC,GAAG,CAAC;IACxC,MAAMF,IAAI,GAAGC,IAAI,CAACE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IACpC,MAAMC,OAAO,GAAGP,QAAQ,KAAKG,IAAI,IAAIH,QAAQ,CAACQ,UAAU,CAAC,GAAGL,IAAI,GAAG,CAAC;IACpE,IAAI,CAACI,OAAO,EAAE;IACd,IAAI,CAACN,IAAI,IAAIE,IAAI,CAACM,MAAM,GAAGR,IAAI,CAACQ,MAAM,EAAE;MACtCR,IAAI,GAAG;QAAES,KAAK,EAAER,IAAI,CAACQ,KAAK;QAAED,MAAM,EAAEN,IAAI,CAACM;MAAO,CAAC;IACnD;EACF;EACA,OAAOR,IAAI,EAAES,KAAK;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAC;EACzBZ,KAAK;EACLa,UAAU;EACVC,YAAY,GAAG,IAAI;EACnB,GAAGC;AACY,CAAC,EAAE;EAClB,MAAMd,QAAQ,GAAGP,WAAW,CAAC,CAAC;EAC9B,MAAMsB,WAAW,GAAG5B,OAAO,CAAC,MAAMW,gBAAgB,CAACC,KAAK,EAAEC,QAAQ,CAAC,EAAE,CAACD,KAAK,EAAEC,QAAQ,CAAC,CAAC;EACvF,MAAMgB,OAAO,GAAG5B,MAAM,CAAqB,IAAI,CAAC;EAChD;EACA;EACA;EACA,MAAM6B,UAAU,GAAG7B,MAAM,CAAgB,IAAI,CAAC;EAE9C,MAAM8B,UAAU,GAAGjC,WAAW,CAC3ByB,KAAa,IAAK;IACjB,MAAMS,MAAM,GAAGpB,KAAK,CAACqB,IAAI,CAAElB,IAAI,IAAKA,IAAI,CAACQ,KAAK,KAAKA,KAAK,CAAC;IACzD,IAAI,CAACS,MAAM,EAAE;IACb;IACA;IACA3B,MAAM,CAAC6B,IAAI,CAACF,MAAM,CAAChB,IAAI,CAAC;EAC1B,CAAC,EACD,CAACJ,KAAK,CACR,CAAC;EAED,MAAMuB,WAAW,GAAGrC,WAAW,CAC5BiB,IAAmB,IAAK;IACvB,IAAIA,IAAI,CAACQ,KAAK,KAAKK,WAAW,EAAE;MAC9BH,UAAU,GAAGV,IAAI,CAACQ,KAAK,CAAC;MACxB;IACF;IACAQ,UAAU,CAAChB,IAAI,CAACQ,KAAK,CAAC;EACxB,CAAC,EACD,CAACK,WAAW,EAAEH,UAAU,EAAEM,UAAU,CACtC,CAAC;EAED,MAAMK,MAAM,GAAGtC,WAAW,CAAEuC,YAAoB,IAAK;IACnDP,UAAU,CAACQ,OAAO,GAAGT,OAAO,CAACS,OAAO,EAAEC,IAAI,CAACF,YAAY,CAAC,IAAI,IAAI;EAClE,CAAC,EAAE,EAAE,CAAC;;EAEN;EACA;EACA;EACA,MAAMG,WAAW,GAAGvC,MAAM,CAAC,IAAI,CAAC;EAChC,MAAMwC,SAAS,GAAG3C,WAAW,CAAC,MAAM;IAClC,IAAI0C,WAAW,CAACF,OAAO,EAAE;IACzBE,WAAW,CAACF,OAAO,GAAG,IAAI;IAC1B,MAAMI,SAAS,GAAGZ,UAAU,CAACQ,OAAO;IACpCR,UAAU,CAACQ,OAAO,GAAG,IAAI;IACzB;IACA;IACA;IACAT,OAAO,CAACS,OAAO,EAAEK,OAAO,CAACD,SAAS,CAAC;IACnC,IAAIA,SAAS,KAAK,IAAI,EAAEX,UAAU,CAACW,SAAS,CAAC;EAC/C,CAAC,EAAE,CAACX,UAAU,CAAC,CAAC;EAEhB,MAAMa,OAAO,GAAG9C,WAAW,CAAC,MAAM;IAChC0C,WAAW,CAACF,OAAO,GAAG,KAAK;EAC7B,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMO,UAAU,GAAG7C,OAAO,CACxB,MACEE,OAAO,CAAC4C,GAAG,CAAC;EACV;EACA;EAAA,CACCC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CACxBC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CACtBJ,OAAO,CAAC,MAAM;IACbxC,OAAO,CAACwC,OAAO,CAAC,CAAC,CAAC;EACpB,CAAC,CAAC,CACDK,QAAQ,CAAEC,KAAK,IAAK;IACnB9C,OAAO,CAACgC,MAAM,CAAC,CAACc,KAAK,CAACb,YAAY,CAAC;EACrC,CAAC,CAAC,CACDc,UAAU,CAAC,MAAM;IAChB/C,OAAO,CAACqC,SAAS,CAAC,CAAC,CAAC;EACtB,CAAC,CAAC,EACN,CAACG,OAAO,EAAER,MAAM,EAAEK,SAAS,CAC7B,CAAC;;EAED;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA1C,SAAS,CAAC,MAAM;IACd,KAAK,MAAMgB,IAAI,IAAIH,KAAK,EAAE;MACxB,IAAIG,IAAI,CAACQ,KAAK,KAAKK,WAAW,IAAIb,IAAI,CAACqC,QAAQ,EAAE;MACjD/C,MAAM,CAACgD,QAAQ,CAACtC,IAAI,CAACC,IAAI,CAAC;IAC5B;EACF,CAAC,EAAE,CAACJ,KAAK,EAAEgB,WAAW,CAAC,CAAC;EAExB,MAAM0B,KAAK;EAAA;EACT;EACA;EACA;EACA5C,IAAA,CAACH,IAAI;IAAA,GAAKoB,SAAS;IAAE4B,GAAG,EAAE1B,OAAQ;IAAC2B,YAAY,EAAE5B,WAAW,KAAK6B,SAAU;IAAAC,QAAA,EACxE9C,KAAK,CAAC+C,GAAG,CAAE5C,IAAI,iBACdL,IAAA,CAACF,WAAW;MAEVe,KAAK,EAAER,IAAI,CAACQ,KAAM;MAClBqC,KAAK,EAAE7C,IAAI,CAAC6C,KAAM;MAClBC,IAAI,EAAE9C,IAAI,CAAC8C,IAAK;MAChBC,KAAK,EAAE/C,IAAI,CAAC+C,KAAM;MAClBV,QAAQ,EAAErC,IAAI,CAACqC;MACf;MACA;MAAA;MACAW,SAAS,EAAEhD,IAAI,CAACQ,KAAK,KAAKK,WAAY;MACtCoC,OAAO,EAAEA,CAAA,KAAM7B,WAAW,CAACpB,IAAI;IAAE,GAT5BA,IAAI,CAACQ,KAUX,CACF;EAAC,CACE,CACP;EAED,IAAI,CAACG,YAAY,EAAE,OAAO4B,KAAK;EAE/B;IAAA;IACE;IACA;IACA;IACA;IACA;IACA;IACA;IACA5C,IAAA,CAACP,eAAe;MAAC8D,OAAO,EAAEpB,UAAW;MAACqB,WAAW,EAAC,OAAO;MAAAR,QAAA,EACtDJ;IAAK,CACS;EAAC;AAEtB;AAEA9B,UAAU,CAAC2C,WAAW,GAAG,YAAY","ignoreList":[]}

package/lib/module/tabs/expo-router/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+/**
+ * Entry for `@oxyhq/bloom/tabs/expo-router`. The component lives in a sibling
+ * module because this file is the published entry path and must stay stable;
+ * the split also keeps the router binding in one place, which is what the
+ * optional-peer allowlist asserts about.
+ */
+export { RouterTabs } from "./RouterTabs.js";
+//# sourceMappingURL=index.js.map

package/lib/module/tabs/expo-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RouterTabs"],"sourceRoot":"../../../../src","sources":["tabs/expo-router/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,UAAU,QAAQ,iBAAc","ignoreList":[]}

package/lib/typescript/commonjs/scroll/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/index.web.tsx"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AA0DjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CA4J1B"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/index.web.tsx"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AA0DjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CAgM1B"}

package/lib/typescript/commonjs/scroll/scrollable.web.d.ts

@@ -8,17 +8,30 @@ export interface ResolvedScroller {
     getOffset: () => number;
     setOffset: (offset: number) => void;
     /**
-     * Whether the scroll container can currently hold a non-zero offset, i.e.
-     * its content is taller than its viewport (`scrollHeight > clientHeight`).
+     * The largest offset the container can currently hold — `scrollHeight -
+     * clientHeight`, clamped at 0. Answers two questions the save path needs:
+     * whether a 0 read is real (`maxOffset > 0`) and whether an offset is sitting
+     * exactly at the bottom, which is the signature of a browser clamp.
      *
      * React Navigation's web stack collapses a hidden background screen so its
      * content height drops to the viewport height; while collapsed the container
      * cannot be scrolled and its `scrollTop` is forced to 0. The hook uses this
      * to ignore a spurious 0 read coming from a collapsed container rather than
-     * persisting it over a previously-saved good offset. The `'window'` scroller
-     * is never collapsed by the navigator, so it always reports `true`.
+     * persisting it over a previously-saved good offset.
+     *
+     * The DOCUMENT collapses the same way, so the `'window'` sentinel answers the
+     * same question honestly rather than hardcoding `true`. It used to, on the
+     * premise that the navigator never collapses the document — false under a
+     * tabbed navigator, where every tab stays MOUNTED and non-focused ones are
+     * `display: none` (expo-router's `ui/TabSlot`, and react-native-screens' web
+     * `Screen` at `activityState === 0`). Measured in Chrome 150: switching from
+     * a tall tab to a short one drops `documentElement.scrollHeight` from 8040 to
+     * the 800px viewport, forces `scrollY` to 0 and dispatches two `scroll`
+     * events — which the outgoing tab's still-attached listener would otherwise
+     * persist as 0 over its real offset, because blur is emitted from an effect
+     * that has not run yet.
      */
-    canScroll: () => boolean;
+    getMaxOffset: () => number;
 }
 /**
  * Build a {@link ResolvedScroller} for a target. The window sentinel reads and

package/lib/typescript/commonjs/scroll/scrollable.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAyBhF"}
+{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAkChF"}

package/lib/typescript/commonjs/tabs/Tabs.d.ts

@@ -1,6 +1,46 @@
 import React from 'react';
 import type { TabsProps, TabsTriggerProps, TabsContentProps } from './types';
-export declare const Tabs: React.NamedExoticComponent<TabsProps>;
+/**
+ * The imperative surface a horizontal drag gesture drives the underline through.
+ *
+ * It lives here rather than in the gesture's own code because every quantity the
+ * drag needs — where the neighbouring trigger is, how wide it is, whether there
+ * IS a neighbour — is measured layout the strip already holds and nothing
+ * outside it can see. The gesture supplies one number, the finger's delta; the
+ * strip decides what that means.
+ *
+ * Obtained via a `ref` on `Tabs`. The gesture belongs in the LAYOUT beside the
+ * strip, never inside a tab screen — a gesture mounted in a screen is destroyed
+ * by the navigation it commits, mid-release.
+ */
+export interface TabsDragController {
+    /**
+     * Feed the raw horizontal finger delta (`translationX`).
+     *
+     * The underline travels OPPOSITE the finger, because that is where the
+     * incoming tab is: dragging left reveals the NEXT tab, which sits to the
+     * right. Travel is clamped at the neighbour — the underline stops exactly
+     * where it would land, so it never promises more than the release delivers —
+     * and at the first/last tab it rubber-bands instead.
+     *
+     * Returns the value that releasing NOW would commit, or `null` for "no
+     * commit": either the drag has not passed the threshold, or there is no
+     * neighbour in that direction.
+     */
+    drag(translationX: number): string | null;
+    /**
+     * End the drag. Pass the value `drag` last returned to keep the underline
+     * where the finger left it while the caller navigates; pass `null` to spring
+     * it home.
+     *
+     * On a commit the offset is FOLDED into the underline's base position rather
+     * than zeroed, so the focus change that follows springs from where the finger
+     * actually let go. Zeroing first would snap backwards for a frame and then
+     * animate forwards from the wrong place.
+     */
+    release(committed: string | null): void;
+}
+export declare const Tabs: React.NamedExoticComponent<TabsProps & React.RefAttributes<TabsDragController>>;
 export declare const TabsTrigger: React.NamedExoticComponent<TabsTriggerProps>;
 export declare const TabsContent: React.NamedExoticComponent<TabsContentProps>;
 //# sourceMappingURL=Tabs.d.ts.map

package/lib/typescript/commonjs/tabs/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAiBf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AA4Q1F,eAAO,MAAM,IAAI,uCAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAUN,MAAM,OAAO,CAAC;AA4Bf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAwD1F;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACzC;AAmbD,eAAO,MAAM,IAAI,iFAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}

package/lib/typescript/commonjs/tabs/expo-router/RouterTabs.d.ts

@@ -0,0 +1,80 @@
+/**
+ * expo-router bindings for the in-screen tab strip.
+ *
+ * This subpath (`@oxyhq/bloom/tabs/expo-router`) is the ONLY place in the tabs
+ * feature allowed to import `expo-router`, which is why it is a separate entry:
+ * the core `@oxyhq/bloom/tabs` stays usable in an app with a different router,
+ * or none, and the optional peer is never pulled into a bundle that does not
+ * ask for it. Same split as `tab-bar` / `tab-bar/expo-router` and
+ * `scroll` / `scroll/expo-router`.
+ *
+ * Everything routing-shaped lives here on purpose: which tab the route means,
+ * what a committed swipe navigates to, and which links to warm. The strip
+ * itself stays presentational and knows only about measured geometry.
+ */
+import { type ReactNode } from 'react';
+import { type Href } from 'expo-router';
+import type { TabsProps } from '../types';
+export interface RouterTabItem {
+    /** Stable id for the tab. Used as a React key and a callback argument. */
+    value: string;
+    /** Tab label text. */
+    label: string;
+    /** The route this tab shows. Must be the tab's EXACT path. */
+    href: Href;
+    /** Icon rendered before the label. */
+    icon?: ReactNode;
+    /** Optional tally beside the label; `0` or omitted renders nothing. */
+    count?: number;
+    disabled?: boolean;
+}
+export type RouterTabsProps = Omit<TabsProps, 'value' | 'onValueChange' | 'hasSelection' | 'children'> & {
+    items: RouterTabItem[];
+    /**
+     * Called instead of navigating when the ALREADY-active tab is pressed.
+     *
+     * Without it a re-tap would push a second history entry for the route the
+     * user is already on, so Back would appear to do nothing. Re-tapping the
+     * active tab conventionally means "refresh" or "scroll to top", and that is
+     * the caller's to define.
+     */
+    onReselect?: (value: string) => void;
+    /**
+     * Enable the horizontal swipe between neighbouring tabs. Defaults to `true`.
+     *
+     * The gesture is INDICATOR-LED: the underline tracks the finger toward the
+     * neighbour and commits on release past a threshold, while the content stays
+     * where it is. That asymmetry is deliberate — the underline has somewhere
+     * real to go and can complete its journey, whereas under a `<Slot/>` there is
+     * no neighbouring screen mounted to bring in, so translating the content
+     * would only open a blank gutter on the trailing edge.
+     */
+    swipeEnabled?: boolean;
+};
+/**
+ * A tab strip whose selection IS the route.
+ *
+ * Render it in the LAYOUT that owns the tabs, above the `<Slot/>` that renders
+ * them — not inside the tab screens themselves. That placement is the whole
+ * point, and it is load-bearing twice over: a strip inside the screens is
+ * unmounted and rebuilt by every navigation, so its underline has nothing to
+ * animate from and the chrome blanks while the incoming route's chunk loads;
+ * and a GESTURE inside the screens would be destroyed by the very navigation it
+ * commits, mid-release.
+ *
+ * ```tsx
+ * // app/(app)/[username]/_layout.tsx
+ * <RouterTabs
+ *   items={[
+ *     { value: 'posts', label: 'Posts', href: `/${username}` },
+ *     { value: 'replies', label: 'Replies', href: `/${username}/replies` },
+ *   ]}
+ * />
+ * <Slot />
+ * ```
+ */
+export declare function RouterTabs({ items, onReselect, swipeEnabled, ...tabsProps }: RouterTabsProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace RouterTabs {
+    var displayName: string;
+}
+//# sourceMappingURL=RouterTabs.d.ts.map

package/lib/typescript/commonjs/tabs/expo-router/RouterTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterTabs.d.ts","sourceRoot":"","sources":["../../../../../src/tabs/expo-router/RouterTabs.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhF,OAAO,EAAuB,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,EAAE,IAAI,CAAC;IACX,sCAAsC;IACtC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,SAAS,EAGT,OAAO,GAAG,eAAe,GAAG,cAAc,GAAG,UAAU,CACxD,GAAG;IACF,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAuCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,UAAU,EACV,YAAmB,EACnB,GAAG,SAAS,EACb,EAAE,eAAe,2CAwIjB;yBA7Ie,UAAU"}

package/lib/typescript/commonjs/tabs/expo-router/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Entry for `@oxyhq/bloom/tabs/expo-router`. The component lives in a sibling
+ * module because this file is the published entry path and must stay stable;
+ * the split also keeps the router binding in one place, which is what the
+ * optional-peer allowlist asserts about.
+ */
+export { RouterTabs } from './RouterTabs';
+export type { RouterTabItem, RouterTabsProps } from './RouterTabs';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/tabs/expo-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tabs/expo-router/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

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

@@ -1,10 +1,38 @@
 import type { StyleProp, ViewStyle, TextStyle } from 'react-native';
 export type TabsVariant = 'underline' | 'filled' | 'outlined';
 export interface TabsProps {
-    /** The currently selected tab value. */
-    value: string;
-    /** Called when a tab is selected. */
-    onValueChange: (value: string) => void;
+    /**
+     * The currently selected tab value — the CONTROLLED path, where the bar owns
+     * the underline and reports presses through {@link TabsProps.onValueChange}.
+     *
+     * OMIT it for the focus-driven path, where each trigger supplies its own
+     * {@link TabsTriggerProps.isFocused} and performs its own navigation. That is
+     * how `@oxyhq/bloom/tabs/expo-router` keeps the underline correct through
+     * deep links, browser Back and back gestures — none of which pass through a
+     * press handler. Providing both would put two writers on one shared value.
+     */
+    value?: string;
+    /** Called when a tab is selected. Controlled path only. */
+    onValueChange?: (value: string) => void;
+    /**
+     * Focus-driven path only: whether ANY trigger is currently focused.
+     *
+     * `false` fades the underline out where it stands. This is not the same as
+     * "the selection moved", and it is not hypothetical: a strip rendered by a
+     * LAYOUT keeps rendering while the layout's other, non-tab children are
+     * showing — a profile's `/followers` sits beside its tab routes under one
+     * layout — and without this the underline stays parked on whichever tab was
+     * last visited, asserting a selection that is not there.
+     *
+     * Fading is the whole response; the underline is deliberately NOT moved,
+     * because there is no position that means "nowhere" and travelling to a
+     * sentinel would drag it across every tab on the way out.
+     *
+     * `RouterTabs` sets it, so an app author never passes it by hand. Defaults to
+     * `true`, which is correct for the controlled path (a `value` naming no
+     * trigger simply leaves the underline where it was, as it always has).
+     */
+    hasSelection?: boolean;
     /** Visual variant for the tab bar. */
     variant?: TabsVariant;
     /**
@@ -26,8 +54,24 @@ export interface TabsTriggerProps {
     label: string;
     /** Icon rendered before the label. */
     icon?: React.ReactNode;
+    /**
+     * Optional tally rendered as a small muted number beside the label. Omitted
+     * (or `0`) renders nothing. The underline tracks the trigger's measured
+     * width, so a count never changes where it sits.
+     */
+    count?: number;
+    /**
+     * Whether the ROUTER considers this tab focused — the focus-driven path.
+     * Supplying it makes this trigger, not the bar, the writer of the shared
+     * underline, and suppresses {@link TabsProps.onValueChange} on press because
+     * navigation is then the caller's job. Leave it `undefined` on the controlled
+     * path.
+     */
+    isFocused?: boolean;
     /** Whether this tab is disabled. */
     disabled?: boolean;
+    /** Extra press handler. Runs on both paths, before any selection is reported. */
+    onPress?: () => void;
     style?: StyleProp<ViewStyle>;
     textStyle?: StyleProp<TextStyle>;
 }

package/lib/typescript/commonjs/tabs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sCAAsC;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}

package/lib/typescript/module/scroll/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/index.web.tsx"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AA0DjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CA4J1B"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/index.web.tsx"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,SAAS,CAAC;AA0DjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CAgM1B"}

package/lib/typescript/module/scroll/scrollable.web.d.ts

@@ -8,17 +8,30 @@ export interface ResolvedScroller {
     getOffset: () => number;
     setOffset: (offset: number) => void;
     /**
-     * Whether the scroll container can currently hold a non-zero offset, i.e.
-     * its content is taller than its viewport (`scrollHeight > clientHeight`).
+     * The largest offset the container can currently hold — `scrollHeight -
+     * clientHeight`, clamped at 0. Answers two questions the save path needs:
+     * whether a 0 read is real (`maxOffset > 0`) and whether an offset is sitting
+     * exactly at the bottom, which is the signature of a browser clamp.
      *
      * React Navigation's web stack collapses a hidden background screen so its
      * content height drops to the viewport height; while collapsed the container
      * cannot be scrolled and its `scrollTop` is forced to 0. The hook uses this
      * to ignore a spurious 0 read coming from a collapsed container rather than
-     * persisting it over a previously-saved good offset. The `'window'` scroller
-     * is never collapsed by the navigator, so it always reports `true`.
+     * persisting it over a previously-saved good offset.
+     *
+     * The DOCUMENT collapses the same way, so the `'window'` sentinel answers the
+     * same question honestly rather than hardcoding `true`. It used to, on the
+     * premise that the navigator never collapses the document — false under a
+     * tabbed navigator, where every tab stays MOUNTED and non-focused ones are
+     * `display: none` (expo-router's `ui/TabSlot`, and react-native-screens' web
+     * `Screen` at `activityState === 0`). Measured in Chrome 150: switching from
+     * a tall tab to a short one drops `documentElement.scrollHeight` from 8040 to
+     * the 800px viewport, forces `scrollY` to 0 and dispatches two `scroll`
+     * events — which the outgoing tab's still-attached listener would otherwise
+     * persist as 0 over its real offset, because blur is emitted from an effect
+     * that has not run yet.
      */
-    canScroll: () => boolean;
+    getMaxOffset: () => number;
 }
 /**
  * Build a {@link ResolvedScroller} for a target. The window sentinel reads and

package/lib/typescript/module/scroll/scrollable.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAyBhF"}
+{"version":3,"file":"scrollable.web.d.ts","sourceRoot":"","sources":["../../../../src/scroll/scrollable.web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAuCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,gBAAgB,CAkChF"}

package/lib/typescript/module/tabs/Tabs.d.ts

@@ -1,6 +1,46 @@
 import React from 'react';
 import type { TabsProps, TabsTriggerProps, TabsContentProps } from './types';
-export declare const Tabs: React.NamedExoticComponent<TabsProps>;
+/**
+ * The imperative surface a horizontal drag gesture drives the underline through.
+ *
+ * It lives here rather than in the gesture's own code because every quantity the
+ * drag needs — where the neighbouring trigger is, how wide it is, whether there
+ * IS a neighbour — is measured layout the strip already holds and nothing
+ * outside it can see. The gesture supplies one number, the finger's delta; the
+ * strip decides what that means.
+ *
+ * Obtained via a `ref` on `Tabs`. The gesture belongs in the LAYOUT beside the
+ * strip, never inside a tab screen — a gesture mounted in a screen is destroyed
+ * by the navigation it commits, mid-release.
+ */
+export interface TabsDragController {
+    /**
+     * Feed the raw horizontal finger delta (`translationX`).
+     *
+     * The underline travels OPPOSITE the finger, because that is where the
+     * incoming tab is: dragging left reveals the NEXT tab, which sits to the
+     * right. Travel is clamped at the neighbour — the underline stops exactly
+     * where it would land, so it never promises more than the release delivers —
+     * and at the first/last tab it rubber-bands instead.
+     *
+     * Returns the value that releasing NOW would commit, or `null` for "no
+     * commit": either the drag has not passed the threshold, or there is no
+     * neighbour in that direction.
+     */
+    drag(translationX: number): string | null;
+    /**
+     * End the drag. Pass the value `drag` last returned to keep the underline
+     * where the finger left it while the caller navigates; pass `null` to spring
+     * it home.
+     *
+     * On a commit the offset is FOLDED into the underline's base position rather
+     * than zeroed, so the focus change that follows springs from where the finger
+     * actually let go. Zeroing first would snap backwards for a frame and then
+     * animate forwards from the wrong place.
+     */
+    release(committed: string | null): void;
+}
+export declare const Tabs: React.NamedExoticComponent<TabsProps & React.RefAttributes<TabsDragController>>;
 export declare const TabsTrigger: React.NamedExoticComponent<TabsTriggerProps>;
 export declare const TabsContent: React.NamedExoticComponent<TabsContentProps>;
 //# sourceMappingURL=Tabs.d.ts.map

package/lib/typescript/module/tabs/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAiBf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AA4Q1F,eAAO,MAAM,IAAI,uCAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../../src/tabs/Tabs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAUN,MAAM,OAAO,CAAC;AA4Bf,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAwD1F;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACzC;AAmbD,eAAO,MAAM,IAAI,iFAAyB,CAAC;AAG3C,eAAO,MAAM,WAAW,8CAAqB,CAAC;AAG9C,eAAO,MAAM,WAAW,8CAA0B,CAAC"}