@oxyhq/bloom 1.0.6 → 1.2.0

package/lib/module/media-flight/store.js

@@ -0,0 +1,439 @@
+"use strict";
+
+/**
+ * The media-flight registry: anchors, live surfaces, and the animation that
+ * moves them.
+ *
+ * ## Why the animation lives HERE and not in the layer
+ *
+ * A flight is started by an imperative call (`flyTo`) from a screen that may be
+ * about to unmount. If the layer drove the animation from an effect keyed on the
+ * flight record, the first frame would be one commit late — and on web, where
+ * the origin route is genuinely gone by the next commit, that frame is the one
+ * the user sees. Driving the shared value at the call site makes the leg start
+ * exactly when the caller says it does and leaves the layer a pure painter.
+ *
+ * The shared values are created with `makeMutable` rather than `useSharedValue`
+ * for the same reason: they belong to a flight, not to a component, and the
+ * component that paints a flight is not the one that starts it.
+ *
+ * ## Why the registry is anchored on `globalThis`
+ *
+ * Same reason as the portal group and the overlay stack: `exports` ships a
+ * `react-native` → `src` condition beside the `lib/module` and `lib/commonjs`
+ * forks, and a bundler can resolve `@oxyhq/bloom/media-flight` through different
+ * conditions from different call sites. Two physical copies of this module would
+ * each keep their own registry, and the `<MediaFlightLayer>` mounted at the app
+ * root would never see the flight a screen started.
+ */
+import { Platform } from 'react-native';
+import { Easing, makeMutable, runOnJS, withSpring, withTiming } from 'react-native-reanimated';
+import { RADIUS } from "../design-tokens/index.js";
+import { SURFACE_MOUNT_TIMEOUT_MS } from "./constants.js";
+import { CLOSE_DURATION_WEB, CLOSE_SPRING, OPEN_DURATION_WEB, OPEN_SPRING } from "../zoomable-media-gallery/constants.js";
+/**
+ * Default corner radius of a flying box — Bloom's `radius-12`, the same value
+ * the media gallery fits its media at, so a flight that lands in the gallery
+ * lands on an identical shape.
+ */
+export const DEFAULT_FLIGHT_CORNER_RADIUS = RADIUS['radius-12'];
+
+/**
+ * Bookkeeping the layer does not RENDER, kept out of the `MediaFlight` record
+ * on purpose.
+ *
+ * The record is replaced on every visual change so its identity tells React the
+ * leg moved; folding these flags into it would churn that identity on events
+ * nobody paints, and folding the record into these would put mutable state back
+ * in a rendered position. They are separate because they answer to different
+ * consumers.
+ */
+
+function emptyRegistry() {
+  return {
+    anchors: new Map(),
+    flights: new Map(),
+    status: new Map(),
+    listeners: new Set(),
+    snapshot: [],
+    progress: makeMutable(0)
+  };
+}
+function statusFor(id) {
+  const reg = registry();
+  let status = reg.status.get(id);
+  if (!status) {
+    status = {
+      mounted: false,
+      settled: false,
+      handedOff: false,
+      mountWaiters: [],
+      mountTimer: null
+    };
+    reg.status.set(id, status);
+  }
+  return status;
+}
+function clearTimers(status) {
+  if (status.mountTimer !== null) clearTimeout(status.mountTimer);
+  status.mountTimer = null;
+}
+function resolveMountWaiters(status) {
+  const waiters = status.mountWaiters;
+  status.mountWaiters = [];
+  if (status.mountTimer !== null) {
+    clearTimeout(status.mountTimer);
+    status.mountTimer = null;
+  }
+  for (const waiter of waiters) waiter();
+}
+function registry() {
+  globalThis.__oxyhq_bloom_media_flight__ ??= emptyRegistry();
+  return globalThis.__oxyhq_bloom_media_flight__;
+}
+function publish(reg) {
+  reg.snapshot = [...reg.flights.values()];
+  for (const listener of reg.listeners) listener();
+}
+
+/** Subscribe to the live-surface set. The layer's `useSyncExternalStore` half. */
+export function subscribeToFlights(listener) {
+  const reg = registry();
+  reg.listeners.add(listener);
+  return () => {
+    reg.listeners.delete(listener);
+  };
+}
+
+/** The live surfaces, oldest first. Stable identity between changes. */
+export function getFlights() {
+  return registry().snapshot;
+}
+
+/** The shared progress value of the most recent leg. */
+export function flightProgress() {
+  return registry().progress;
+}
+
+/**
+ * Register (or clear) the node that anchors `id`.
+ *
+ * A `Map` re-insertion moves the key to the end, which is what makes "the most
+ * recently registered node is the anchor" true even when an origin screen's
+ * callback ref fires again after the destination has registered.
+ */
+export function registerAnchor(id, node) {
+  const reg = registry();
+  reg.anchors.delete(id);
+  if (node !== null) reg.anchors.set(id, node);
+}
+export function measureAnchor(id) {
+  const node = registry().anchors.get(id);
+  if (!node) return Promise.resolve(null);
+  return new Promise(resolve => {
+    node.measureInWindow((x, y, width, height) => {
+      // A zero-area measurement is what a node reports while it is laid out but
+      // not yet on screen. Flying to it would collapse the surface to a point,
+      // so it reads as "no anchor" and the caller skips the transition.
+      resolve(width > 0 && height > 0 ? {
+        x,
+        y,
+        width,
+        height
+      } : null);
+    });
+  });
+}
+
+/** Whether a surface is currently live for `id`. */
+export function hasFlight(id) {
+  return registry().flights.has(id);
+}
+
+/**
+ * Take the surface for `id` live (if it is not already) and move it to `rect`.
+ *
+ * Retargeting mid-flight keeps the SAME `MediaFlight` record — and therefore the
+ * same mounted `VideoView` — which is the whole point. A second record would be
+ * a second surface for one id, and swapping between them is exactly the remount
+ * that restarts playback.
+ *
+ * ## Why it returns a promise, and what the promise means
+ *
+ * It resolves once the layer has COMMITTED a surface for this id — not once
+ * that surface has painted.
+ *
+ * The distinction is the whole ordering contract. expo-video's web player keeps
+ * a `Set` of mounted `<video>` elements and, on each mount, copies
+ * `currentTime`, play state, volume, muted and rate from `[...set][0]`. If the
+ * set is EMPTY when the new element mounts, it returns early and the element
+ * starts at zero — a restart. So the layer's surface has to enter that set while
+ * the origin's is still in it, which means the caller must not tear the origin
+ * down (on web: must not navigate) until this promise resolves.
+ *
+ * That knowledge lives here rather than in the caller, which is the point: a
+ * consumer that has to know the mount order is a consumer that will get it wrong
+ * once and produce an intermittent restart nobody can reproduce locally.
+ *
+ * Painting is deliberately NOT waited on. `MediaSurface` renders the poster
+ * BEHIND the video on both platforms, and neither an unpainted `<video>` (no
+ * `poster` attribute is set) nor an Android `TextureView` with the ExoPlayer
+ * shutter off draws anything opaque — so the still shows through until the first
+ * frame lands, and there is no black box to hide. Waiting for a decode would
+ * trade an invisible problem for a laggy tap.
+ */
+export function flyTo(id, rect, content, options) {
+  const reg = registry();
+  const existing = reg.flights.get(id);
+  if (existing) {
+    // A retarget REPLACES the record rather than mutating it. Identity is what
+    // tells React (and the React Compiler) that the leg changed: a mutated
+    // record has the same identity, so a memoized read of `flight.from` would
+    // keep returning the previous leg's origin forever — the exact
+    // external-mutable-state stale read the compiler is documented to produce.
+    // The shared value is carried over untouched, so the surface resumes rather
+    // than restarting.
+    const next = {
+      ...existing,
+      // The leg that was running is abandoned where it stands: `from` becomes
+      // the rect the surface is CURRENTLY at, so a retarget never snaps.
+      from: interpolateRect(existing.from, existing.to, existing.progress.value),
+      to: rect,
+      content,
+      cornerRadius: options?.cornerRadius ?? existing.cornerRadius,
+      contentFit: options?.contentFit ?? existing.contentFit,
+      // NOT retargetable: `MediaSurface` captures it on first render because
+      // expo-video forbids changing it at runtime, so a new value here would be
+      // silently ignored by the view it is meant to configure.
+      surfaceType: existing.surfaceType,
+      landing: false,
+      generation: existing.generation + 1
+    };
+    reg.flights.set(id, next);
+    const retargeted = statusFor(id);
+    retargeted.settled = false;
+    animate(next, false);
+    publish(reg);
+    return awaitSurfaceMount(id);
+  }
+
+  // Nothing live yet. `from` is the origin rect the caller measured; without one
+  // the surface simply appears at `rect` rather than flying in from a corner.
+  const flight = {
+    id,
+    content,
+    from: options?.from ?? rect,
+    to: rect,
+    cornerRadius: options?.cornerRadius ?? DEFAULT_FLIGHT_CORNER_RADIUS,
+    contentFit: options?.contentFit ?? 'cover',
+    surfaceType: options?.surfaceType ?? 'textureView',
+    progress: makeMutable(0),
+    landing: false,
+    generation: 0
+  };
+  reg.flights.set(id, flight);
+  const status = statusFor(id);
+  status.mounted = false;
+  status.settled = false;
+  status.handedOff = false;
+  animate(flight, false);
+  publish(reg);
+  return awaitSurfaceMount(id);
+}
+
+/**
+ * Resolve once `<MediaFlightLayer>` reports it has committed the surface, or
+ * after {@link SURFACE_MOUNT_TIMEOUT_MS} — which is what happens when no layer
+ * is mounted at all. Degrading to "carry on without a transition" is right;
+ * never resolving would mean an app that forgot one line at its root has a feed
+ * whose videos cannot be opened.
+ */
+function awaitSurfaceMount(id) {
+  const status = statusFor(id);
+  if (status.mounted) return Promise.resolve();
+  return new Promise(resolve => {
+    status.mountWaiters.push(resolve);
+    if (status.mountTimer !== null) return;
+    status.mountTimer = setTimeout(() => {
+      status.mountTimer = null;
+      warnNoLayerMounted();
+      resolveMountWaiters(status);
+    }, SURFACE_MOUNT_TIMEOUT_MS);
+  });
+}
+
+/**
+ * The layer calls this from the surface's mount effect. It is the commit signal
+ * `flyTo` waits on, and the only thing that makes the ordering contract above
+ * true rather than hopeful.
+ */
+export function notifySurfaceMounted(id) {
+  const status = statusFor(id);
+  status.mounted = true;
+  resolveMountWaiters(status);
+}
+
+/** The layer calls this when a leg's animation finishes. */
+export function notifySurfaceSettled(id) {
+  const status = statusFor(id);
+  status.settled = true;
+  if (status.handedOff) releaseFlight(id);
+}
+
+/**
+ * A destination surface reporting that it is LIVE — it has presented a frame of
+ * its own, so the flying copy is now redundant and can go.
+ *
+ * This is the release condition, and it is deliberately not the animation's
+ * clock. Measured against production, a fullscreen video route needs ~1 s from
+ * tap to first presented frame; releasing when a ~300 ms animation ends would
+ * leave ~700 ms with nothing live on screen — the hole the transition exists to
+ * cover, made longer.
+ *
+ * Wire it by giving the destination's `<MediaSurface>` a `flightId`; it calls
+ * this itself on its first frame. A destination that renders something other
+ * than a Bloom surface can call it directly.
+ */
+export function handOffFlight(id) {
+  const reg = registry();
+  if (!reg.flights.has(id)) return;
+  const status = statusFor(id);
+  status.handedOff = true;
+  // Mid-flight the surface is still travelling: releasing now would make it
+  // vanish somewhere between the two rects. `notifySurfaceSettled` picks it up.
+  if (status.settled) releaseFlight(id);
+}
+
+/**
+ * Aim the live surface at its anchor and release it once it lands.
+ *
+ * With no measurable anchor there is nothing to fly to, so the surface is
+ * released immediately — whoever owns the media renders its own copy again at
+ * that point, and holding a flying copy over it would double the video.
+ */
+export function flyBack(id) {
+  const flight = registry().flights.get(id);
+  if (!flight) return;
+  void measureAnchor(id).then(rect => {
+    // Re-read: the flight may have been released or retargeted while the
+    // measurement was outstanding (`measureInWindow` is asynchronous on both
+    // platforms), and landing a stale record would fly the wrong surface.
+    const reg = registry();
+    if (reg.flights.get(id) !== flight) return;
+    if (rect === null) {
+      releaseFlight(id);
+      return;
+    }
+    const landing = {
+      ...flight,
+      from: interpolateRect(flight.from, flight.to, flight.progress.value),
+      to: rect,
+      landing: true,
+      generation: flight.generation + 1
+    };
+    reg.flights.set(id, landing);
+    animate(landing, true);
+    publish(reg);
+  });
+}
+
+/** Drop the surface for `id`. Called when a landing leg settles, and on teardown. */
+export function releaseFlight(id) {
+  const reg = registry();
+  const status = reg.status.get(id);
+  if (status) {
+    // A waiter still parked on `flyTo`'s promise would otherwise hang until its
+    // own timeout, holding a caller that has nothing left to wait for.
+    clearTimers(status);
+    resolveMountWaiters(status);
+    reg.status.delete(id);
+  }
+  if (!reg.flights.delete(id)) return;
+  publish(reg);
+}
+
+/** Test seam — drops every anchor and surface. */
+export function resetMediaFlight() {
+  const existing = globalThis.__oxyhq_bloom_media_flight__;
+  // Timers outlive a registry swap: an unfired mount timeout from the previous
+  // suite would warn — and resolve a waiter nobody is holding — inside the next.
+  if (existing) for (const status of existing.status.values()) clearTimers(status);
+  globalThis.__oxyhq_bloom_media_flight__ = emptyRegistry();
+  hasWarnedNoLayer = false;
+}
+let hasWarnedNoLayer = false;
+
+/**
+ * One warning per module lifetime, and none in production — the same mechanism
+ * as the optional-peer boundaries. A missing `<MediaFlightLayer>` is otherwise
+ * completely silent: every `flyTo` resolves on its timeout and the app simply
+ * never shows a transition, which looks like the feature not being wired rather
+ * than the root not being.
+ */
+function warnNoLayerMounted() {
+  if (process.env.NODE_ENV === 'production' || hasWarnedNoLayer) return;
+  hasWarnedNoLayer = true;
+  // eslint-disable-next-line no-console
+  console.warn('[Bloom] flyTo() timed out waiting for a media surface to mount. Nothing is ' + 'rendering <MediaFlightLayer>, so no media transition will ever run and a ' + 'video opened from a feed will restart. Mount it ONCE at the app root ' + '(app/_layout.tsx), above the router.');
+}
+
+/** Rect at `t` along `from` → `to`, so a retarget resumes rather than snapping. */
+function interpolateRect(from, to, t) {
+  const clamped = t < 0 ? 0 : t > 1 ? 1 : t;
+  return {
+    x: from.x + (to.x - from.x) * clamped,
+    y: from.y + (to.y - from.y) * clamped,
+    width: from.width + (to.width - from.width) * clamped,
+    height: from.height + (to.height - from.height) * clamped
+  };
+}
+
+/**
+ * Run one leg: 0 → 1 on the flight's own value, and on the shared `progress` a
+ * consumer reads.
+ *
+ * Both are driven with the SAME curve rather than one deriving from the other,
+ * because deriving would need a `useAnimatedReaction` — a hook, in a module with
+ * no component to hang it on. Two animations on two shared values cost a few
+ * bytes on the UI thread and keep the driver at the call site.
+ *
+ * The springs and the web timings are the media gallery's, imported rather than
+ * re-tuned: a flight that lands in the gallery and the gallery's own open
+ * transition are the same motion, and two copies of a spring config drift.
+ */
+function animate(flight, landing) {
+  const reg = registry();
+  const id = flight.id;
+  // EVERY leg reports its settlement, because the release condition is now
+  // "settled AND the destination is live" and either can arrive first. A
+  // `finished === false` callback means the leg was interrupted by a retarget,
+  // which owns the surface from then on.
+  //
+  // A LANDING leg is the one case that releases on its own: it has flown back to
+  // its anchor and there is nothing left to cover.
+  const onSettled = finished => {
+    'worklet';
+
+    if (finished === false) return;
+    runOnJS(landing ? releaseFlight : notifySurfaceSettled)(id);
+  };
+  flight.progress.value = 0;
+  reg.progress.value = 0;
+  if (Platform.OS === 'web') {
+    const duration = landing ? CLOSE_DURATION_WEB : OPEN_DURATION_WEB;
+    const easing = landing ? Easing.in(Easing.cubic) : Easing.out(Easing.cubic);
+    flight.progress.value = withTiming(1, {
+      duration,
+      easing
+    }, onSettled);
+    reg.progress.value = withTiming(1, {
+      duration,
+      easing
+    });
+    return;
+  }
+  const spring = landing ? CLOSE_SPRING : OPEN_SPRING;
+  flight.progress.value = withSpring(1, spring, onSettled);
+  reg.progress.value = withSpring(1, spring);
+}
+//# sourceMappingURL=store.js.map

package/lib/module/media-flight/store.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","Easing","makeMutable","runOnJS","withSpring","withTiming","RADIUS","SURFACE_MOUNT_TIMEOUT_MS","CLOSE_DURATION_WEB","CLOSE_SPRING","OPEN_DURATION_WEB","OPEN_SPRING","DEFAULT_FLIGHT_CORNER_RADIUS","emptyRegistry","anchors","Map","flights","status","listeners","Set","snapshot","progress","statusFor","id","reg","registry","get","mounted","settled","handedOff","mountWaiters","mountTimer","set","clearTimers","clearTimeout","resolveMountWaiters","waiters","waiter","globalThis","__oxyhq_bloom_media_flight__","publish","values","listener","subscribeToFlights","add","delete","getFlights","flightProgress","registerAnchor","node","measureAnchor","Promise","resolve","measureInWindow","x","y","width","height","hasFlight","has","flyTo","rect","content","options","existing","next","from","interpolateRect","to","value","cornerRadius","contentFit","surfaceType","landing","generation","retargeted","animate","awaitSurfaceMount","flight","push","setTimeout","warnNoLayerMounted","notifySurfaceMounted","notifySurfaceSettled","releaseFlight","handOffFlight","flyBack","then","resetMediaFlight","hasWarnedNoLayer","process","env","NODE_ENV","console","warn","t","clamped","onSettled","finished","OS","duration","easing","in","cubic","out","spring"],"sourceRoot":"../../../src","sources":["media-flight/store.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/media-flight/types.js

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

package/lib/module/media-flight/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["media-flight/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/media-flight/use-media-flight.js

@@ -0,0 +1,36 @@
+"use strict";
+
+/**
+ * The consumer-facing handle on the flight layer.
+ *
+ * Every member is a module-level function over a `globalThis`-anchored registry,
+ * so the object is a frozen constant rather than something rebuilt per render:
+ * a caller may hold it in a dependency array, a callback ref or a gesture
+ * closure without any of them going stale, and there is no provider to mount.
+ */
+import { flightProgress, flyBack, flyTo, handOffFlight, measureAnchor, registerAnchor } from "./store.js";
+/**
+ * `flyTo` / `flyBack` / `registerAnchor` / `measureAnchor`, plus the shared
+ * `progress` value of the most recent leg.
+ *
+ * `progress` is resolved through a getter rather than captured at module load,
+ * because `resetMediaFlight()` (the test seam) replaces the registry — a
+ * captured value would keep pointing at the discarded one and every assertion
+ * about progress would read a box nothing writes.
+ */
+const controller = Object.freeze({
+  registerAnchor,
+  measureAnchor,
+  flyTo,
+  flyBack,
+  handOff: handOffFlight,
+  get progress() {
+    return flightProgress();
+  }
+});
+
+/** The media-flight controller. Stable for the life of the bundle. */
+export function useMediaFlight() {
+  return controller;
+}
+//# sourceMappingURL=use-media-flight.js.map

package/lib/module/media-flight/use-media-flight.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["flightProgress","flyBack","flyTo","handOffFlight","measureAnchor","registerAnchor","controller","Object","freeze","handOff","progress","useMediaFlight"],"sourceRoot":"../../../src","sources":["media-flight/use-media-flight.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SACEA,cAAc,EACdC,OAAO,EACPC,KAAK,EACLC,aAAa,EACbC,aAAa,EACbC,cAAc,QACT,YAAS;AAGhB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,UAAiC,GAAGC,MAAM,CAACC,MAAM,CAAC;EACtDH,cAAc;EACdD,aAAa;EACbF,KAAK;EACLD,OAAO;EACPQ,OAAO,EAAEN,aAAa;EACtB,IAAIO,QAAQA,CAAA,EAAG;IACb,OAAOV,cAAc,CAAC,CAAC;EACzB;AACF,CAAC,CAAC;;AAEF;AACA,OAAO,SAASW,cAAcA,CAAA,EAA0B;EACtD,OAAOL,UAAU;AACnB","ignoreList":[]}

package/lib/module/tab-bar/TabBarBase.js

@@ -238,7 +238,7 @@ function TabBarBody({
   // never minimize and the highlight would never move, with no error anywhere.
   // Native (plugin present) auto-tracks and ignores the extra deps, so listing
   // them is correct on both platforms. Same rule as `BottomSheetBase` and
-  // `ZoomableImageGallery`. Do NOT strip these.
+  // `ZoomableMediaGallery`. Do NOT strip these.
   const barStyle = useAnimatedStyle(() => {
     const height = interpolate(progress.value, [0, 1], [EXPANDED_HEIGHT, MINIMIZED_HEIGHT], Extrapolation.CLAMP);
     // Revolut-style: the pill shrinks in both dimensions.