@oxyhq/bloom 1.4.0 → 1.6.0

package/lib/typescript/module/media-flight/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/module/media-flight/index.web.d.ts

@@ -14,6 +14,6 @@ export { useMediaFlight } from './use-media-flight';
 export { DEFAULT_FLIGHT_CORNER_RADIUS, flightProgress, handOffFlight, hasFlight, releaseFlight, resetMediaFlight, } from './store';
 export { SURFACE_MOUNT_TIMEOUT_MS } from './constants';
 export { loadExpoVideo, warnExpoVideoUnavailable, provideExpoVideo, resetExpoVideoModule, type ExpoVideoLike, type VideoPlayerLike, type VideoSurfaceContentFit, type VideoSurfaceType, type VideoViewLikeProps, } from './expo-video-module';
-export type { MediaFlight, MediaFlightAnchorNode, MediaFlightController, MediaFlightHostProps, MediaFlightOptions, MediaSurfaceContent, MediaSurfaceImage, MediaSurfaceVideo, MeasuredRect, } from './types';
+export type { MediaFlight, MediaFlightAnchorNode, MediaFlightController, MediaFlightHostProps, MediaSurfaceVideoOf, MediaVideoSlot, MediaVideoSlotProps, MediaFlightOptions, MediaSurfaceContent, MediaSurfaceImage, MediaSurfaceVideo, MeasuredRect, } from './types';
 export type { MediaSurfaceProps } from './MediaSurface';
 //# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/module/media-flight/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/index.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/index.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/module/media-flight/store.d.ts

@@ -157,7 +157,10 @@ export declare function flyBack(id: string): void;
  *
  * DO NOT replace this with a direct `unmountVideoView` call. It looks
  * equivalent, it is the half that does not matter, and the fix would disappear
- * silently. `MediaFlight.test.tsx` makes that substitution its control.
+ * silently. `MediaFlight.test.tsx` makes that substitution its control, and
+ * `scripts/probe-expo-video-listener-leak.mjs` measures the upstream defect
+ * this steps around — run it before touching any of this. The day it prints
+ * LEAK GONE, this commit and the tests that pin it can go.
  *
  * The cost is one frame in which the outgoing surface shows its poster instead
  * of video. It is already on its way out and the destination is live by then —

package/lib/typescript/module/media-flight/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/store.ts"],"names":[],"mappings":"AA2BA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAUjC,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,IAAsB,CAAC;AAEhE;;;;;;;;;GASG;AACH,UAAU,YAAY;IACpB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,YAAY,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACjD,uEAAuE;IACvE,WAAW,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,4BAA4B,EAAE,QAAQ,GAAG,SAAS,CAAC;CACxD;AAyDD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAMnE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,IAAI,SAAS,WAAW,EAAE,CAEnD;AAED,wDAAwD;AACxD,wBAAgB,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAInF;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAWtE;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,KAAK,CACnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Df;AAuBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAyBxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CA6B9C;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/store.ts"],"names":[],"mappings":"AA2BA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAUjC,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,IAAsB,CAAC;AAEhE;;;;;;;;;GASG;AACH,UAAU,YAAY;IACpB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,YAAY,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IACjD,uEAAuE;IACvE,WAAW,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,4BAA4B,EAAE,QAAQ,GAAG,SAAS,CAAC;CACxD;AAyDD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAMnE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,IAAI,SAAS,WAAW,EAAE,CAEnD;AAED,wDAAwD;AACxD,wBAAgB,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAInF;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAWtE;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,KAAK,CACnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA4Df;AAuBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQ9C;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAyBxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CA6B9C;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC"}

package/lib/typescript/module/media-flight/types.d.ts

@@ -57,6 +57,18 @@ export interface MediaSurfaceVideo {
 }
 /** What a media surface paints: a still image, or a consumer-owned video. */
 export type MediaSurfaceContent = MediaSurfaceImage | MediaSurfaceVideo;
+/**
+ * `MediaSurfaceVideo` carrying the consumer's OWN player type.
+ *
+ * Bloom transports that object; it never reads it. Narrowing it to
+ * `VideoPlayerLike` on the way through would be Bloom asserting something about
+ * cargo — and it would land on the consumer, who then has to cast the player
+ * back before handing it to expo-video's `VideoView`. A contract that pushes a
+ * consumer towards `as` ends up as an `as any` in someone's repo.
+ */
+export interface MediaSurfaceVideoOf<P extends VideoPlayerLike> extends MediaSurfaceVideo {
+    player: P;
+}
 /**
  * A media surface currently owned by the flight layer.
  *
@@ -216,7 +228,7 @@ export interface MediaFlightController {
  * INTRINSIC size (300x150) instead of stretching — so a slot that drops this
  * style paints a 300x150 video inside whatever box it was given. Spread it.
  */
-export interface MediaVideoSlotProps {
+export interface MediaVideoSlotProps<P extends VideoPlayerLike = VideoPlayerLike> {
     /**
      * The player Bloom was given — never one Bloom created.
      *
@@ -227,7 +239,7 @@ export interface MediaVideoSlotProps {
      * anything else here — keeping the old player, unmounting instead — brings
      * that defect back. See `releaseFlight`.
      */
-    player: VideoPlayerLike | null;
+    player: P | null;
     /** Fills the box. Spread it — see above. */
     style: StyleProp<ViewStyle>;
     contentFit: 'contain' | 'cover';
@@ -249,7 +261,7 @@ export interface MediaVideoSlotProps {
  * layer, compared by identity — a new function every render republishes every
  * render. Correct either way, wasteful if you skip it.
  */
-export type MediaVideoSlot = (props: MediaVideoSlotProps) => ReactNode;
+export type MediaVideoSlot<P extends VideoPlayerLike = VideoPlayerLike> = (props: MediaVideoSlotProps<P>) => ReactNode;
 /**
  * A place a media surface may live: the feed row it starts in, the fullscreen
  * player it lands in, and every other end of a flight.
@@ -260,11 +272,16 @@ export type MediaVideoSlot = (props: MediaVideoSlotProps) => ReactNode;
  * ever leaving the document. On native a host renders its media inline, which
  * is what it has always done and what the platform makes correct there.
  */
-export interface MediaFlightHostProps {
+export interface MediaFlightHostProps<P extends VideoPlayerLike = VideoPlayerLike> {
     /** The id this host shares with the flight and with the other end. */
     id: string;
-    /** What to paint: a still image, or a consumer-owned expo-video player. */
-    content: MediaSurfaceContent;
+    /**
+     * What to paint: a still image, or a consumer-owned expo-video player.
+     *
+     * The player's own type flows from here into {@link renderVideo}, so a slot
+     * gets back exactly what it put in and hands it to `VideoView` with no cast.
+     */
+    content: MediaSurfaceImage | MediaSurfaceVideoOf<P>;
     /** Style of the host BOX. Give it the radius and `overflow: 'hidden'` you want. */
     style?: StyleProp<ViewStyle>;
     /** How the media fills the box. Defaults to `'cover'`. */
@@ -273,7 +290,7 @@ export interface MediaFlightHostProps {
      * Paint the video yourself, keeping your own `ref` and expo-video props. See
      * {@link MediaVideoSlot}; memoise it.
      */
-    renderVideo?: MediaVideoSlot;
+    renderVideo?: MediaVideoSlot<P>;
     /** Whether the video arm shows expo-video's own controls. Defaults to `false`. */
     nativeControls?: boolean;
     accessibilityLabel?: string;

package/lib/typescript/module/media-flight/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/media-flight/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "packageManager": "bun@1.3.14",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",

package/src/media-flight/MediaFlightHost.tsx

@@ -15,10 +15,27 @@ import { useCallback } from 'react';
 import { StyleSheet, View } from 'react-native';
 
 import { MediaSurface } from './MediaSurface';
+import type { VideoPlayerLike } from './expo-video-module';
 import { registerAnchor } from './store';
-import type { MediaFlightHostProps } from './types';
+import type { MediaFlightHostProps, MediaVideoSlot } from './types';
 
-export function MediaFlightHost({
+/**
+ * Hand a consumer's slot to `MediaSurface`, which is not generic.
+ *
+ * SOUND, and the reason is the invariant this whole family is built on: the
+ * only player Bloom ever passes to a slot is the one it took out of that
+ * slot's own `content`. Bloom transports the object and never substitutes one,
+ * so the value really is a `P` at runtime — the assertion says what the types
+ * cannot follow through a `memo`'d component, and it lives HERE, once, rather
+ * than in every consumer's `renderVideo`.
+ */
+function widenSlot<P extends VideoPlayerLike>(
+  slot: MediaVideoSlot<P> | undefined,
+): MediaVideoSlot | undefined {
+  return slot as MediaVideoSlot | undefined;
+}
+
+export function MediaFlightHost<P extends VideoPlayerLike = VideoPlayerLike>({
   id,
   content,
   style,
@@ -29,7 +46,7 @@ export function MediaFlightHost({
   surfaceType,
   pointerEvents,
   flightId,
-}: MediaFlightHostProps) {
+}: MediaFlightHostProps<P>) {
   // A callback ref rather than an effect: the anchor must be measurable the
   // moment the box is on screen, and a tap can come one frame later.
   const setNode = useCallback(
@@ -42,7 +59,7 @@ export function MediaFlightHost({
       <MediaSurface
         content={content}
         contentFit={contentFit}
-        renderVideo={renderVideo}
+        renderVideo={widenSlot(renderVideo)}
         nativeControls={nativeControls}
         accessibilityLabel={accessibilityLabel}
         surfaceType={surfaceType}

package/src/media-flight/MediaFlightHost.web.tsx

@@ -22,10 +22,18 @@ import {
   releaseMediaNode,
   type MediaNodeRender,
 } from './media-node.web';
+import type { VideoPlayerLike } from './expo-video-module';
 import { handOffFlight, hasFlight, registerAnchor } from './store';
-import type { MediaFlightHostProps } from './types';
+import type { MediaFlightHostProps, MediaVideoSlot } from './types';
 
-export function MediaFlightHost({
+/**
+ * The web host publishes its slot to the layer, which paints every shared node
+ * through one non-generic `MediaSurface`. Widening is sound for the same reason
+ * as the native host's `widenSlot`: the only player Bloom ever hands a slot is
+ * the one it took out of that slot's own `content`. Bloom transports the
+ * object; it never substitutes one.
+ */
+export function MediaFlightHost<P extends VideoPlayerLike = VideoPlayerLike>({
   id,
   content,
   style,
@@ -35,7 +43,7 @@ export function MediaFlightHost({
   accessibilityLabel,
   pointerEvents,
   flightId,
-}: MediaFlightHostProps) {
+}: MediaFlightHostProps<P>) {
   // State rather than a ref, because the claim runs in a layout effect and an
   // effect cannot depend on a ref's mutation. One extra render at mount.
   const [node, setNode] = useState<View | null>(null);
@@ -49,7 +57,15 @@ export function MediaFlightHost({
   );
 
   const render = useMemo<MediaNodeRender>(
-    () => ({ content, contentFit, renderVideo, nativeControls, accessibilityLabel, flightId }),
+    () => ({
+      content,
+      contentFit,
+      // See `widenSlot`: the player a slot gets back is the one it put in.
+      renderVideo: renderVideo as MediaVideoSlot | undefined,
+      nativeControls,
+      accessibilityLabel,
+      flightId,
+    }),
     [content, contentFit, renderVideo, nativeControls, accessibilityLabel, flightId],
   );
   const renderRef = useRef(render);

package/src/media-flight/MediaFlightLayer.web.tsx

@@ -37,6 +37,7 @@ import { StyleSheet, type View } from 'react-native';
 import { createPortal } from 'react-dom';
 import Animated, { interpolate, useAnimatedStyle } from 'react-native-reanimated';
 
+import { SLOT_FILL_TOLERANCE_PX } from './constants';
 import { OverlayRoot } from '../overlay';
 import { Portal } from '../portal/index.web';
 import { MediaSurface, type MediaSurfaceStyle } from './MediaSurface';
@@ -89,6 +90,22 @@ MediaFlightLayer.displayName = 'MediaFlightLayer';
 /** One media element, painted into the wrapper its id owns, and never again. */
 function SharedMediaNode({ node }: { node: MediaNodeView }) {
   const { content, contentFit, renderVideo, nativeControls, accessibilityLabel, flightId } = node.render;
+
+  // DOES THE MEDIA ACTUALLY FILL ITS BOX?
+  //
+  // Bloom hands a `renderVideo` slot a style that sizes a replaced element, and
+  // a slot that forgets to spread it paints a 300x150 `<video>` inside whatever
+  // box it was given — correct in every other respect, wrong on screen, and
+  // reported by nothing. That defect shipped once from Bloom's own view and
+  // cost a day to find; a consumer writing the slot can reproduce it in a line.
+  //
+  // Measured one frame after the commit, because layout has to have happened.
+  useEffect(() => {
+    if (process.env.NODE_ENV === 'production' || renderVideo === undefined) return undefined;
+    const frame = requestAnimationFrame(() => warnIfNotFilling(node.wrapper));
+    return () => cancelAnimationFrame(frame);
+  }, [node.wrapper, renderVideo]);
+
   return createPortal(
     <MediaSurface
       content={content}
@@ -103,6 +120,37 @@ function SharedMediaNode({ node }: { node: MediaNodeView }) {
   );
 }
 
+let hasWarnedAboutFill = false;
+
+/**
+ * One warning per module lifetime, and none in production — same mechanism as
+ * `warnExpoVideoUnavailable`.
+ *
+ * It compares the media element with the WRAPPER, not with a fixed size: the
+ * invariant is "the media fills the box it was given", and a box that happens
+ * to be 300x150 is not a defect.
+ */
+function warnIfNotFilling(wrapper: HTMLElement): void {
+  if (hasWarnedAboutFill || !wrapper.isConnected) return;
+  const media = wrapper.querySelector('video');
+  if (media === null) return;
+  const box = wrapper.getBoundingClientRect();
+  const painted = media.getBoundingClientRect();
+  if (box.width === 0 || box.height === 0) return;
+  const off =
+    Math.abs(painted.width - box.width) > SLOT_FILL_TOLERANCE_PX ||
+    Math.abs(painted.height - box.height) > SLOT_FILL_TOLERANCE_PX;
+  if (!off) return;
+  hasWarnedAboutFill = true;
+  // eslint-disable-next-line no-console
+  console.warn(
+    `[Bloom] A \`renderVideo\` element is ${Math.round(painted.width)}x${Math.round(painted.height)} ` +
+      `inside a ${Math.round(box.width)}x${Math.round(box.height)} box. A DOM \`<video>\` is a ` +
+      'REPLACED element: without an explicit size it paints at its intrinsic 300x150 whatever ' +
+      'its inset says. Spread the `style` Bloom passes the slot.',
+  );
+}
+
 /**
  * One flying surface. See `MediaFlightLayer.tsx` for why the size is animated
  * rather than scaled.

package/src/media-flight/MediaSurface.tsx

@@ -13,7 +13,7 @@
  * platform video surface the way it rounds an image, and the transform lands on
  * a node reanimated is allowed to drive (expo-video's own host is not one).
  */
-import { memo, useCallback, useState, type ComponentProps } from 'react';
+import { memo, useCallback, useEffect, useRef, useState, type ComponentProps } from 'react';
 import {
   Platform,
   StyleSheet,
@@ -25,6 +25,7 @@ import {
 import { Image } from 'expo-image';
 import Animated from 'react-native-reanimated';
 
+import { SLOT_IDENTITY_CHURN_LIMIT } from './constants';
 import { handOffFlight } from './store';
 import type { MediaSurfaceContent, MediaVideoSlot } from './types';
 import {
@@ -115,7 +116,10 @@ export interface MediaSurfaceProps {
    * algorithm pauses WITHOUT firing `pause` (measured in real Chrome, with
    * controls), so the element goes quiet and its later removal fires nothing.
    * Unbinding alone does not help: `unmountVideoView` never clears the handler
-   * it installed. See `releaseFlight`.
+   * it installed. See `releaseFlight`, and
+   * `scripts/probe-expo-video-listener-leak.mjs`, which measures that in real
+   * Chrome against expo-video's real class — including that grafting the
+   * missing `_removeListeners` into it makes the leak go away.
    */
   detached?: boolean;
 }
@@ -145,6 +149,18 @@ export const MediaSurface = memo(function MediaSurface({
   // supports.
   const [mountedSurfaceType] = useState(surfaceType);
 
+  // A slot rebuilt on every render republishes this surface to the layer on
+  // every render, which nothing at runtime reports — the picture is correct and
+  // the app is doing work in proportion to how often its rows re-render. The
+  // counter lives in an effect rather than in render: a render-phase ref write
+  // makes the React Compiler bail on the whole component.
+  const slotChurn = useRef(0);
+  useEffect(() => {
+    if (renderVideo === undefined) return;
+    slotChurn.current += 1;
+    if (slotChurn.current === SLOT_IDENTITY_CHURN_LIMIT) warnSlotNotMemoised();
+  }, [renderVideo]);
+
   // Both arms report the same fact — "there is a picture here now" — because the
   // destination of a flight can be either, and a caller should not have to know
   // which one it wired. expo-video raises `onFirstFrameRender` from `loadeddata`
@@ -225,6 +241,24 @@ export const MediaSurface = memo(function MediaSurface({
 
 MediaSurface.displayName = 'MediaSurface';
 
+let hasWarnedAboutSlotChurn = false;
+
+/**
+ * One warning per module lifetime, and none in production — same mechanism as
+ * `warnExpoVideoUnavailable`.
+ */
+function warnSlotNotMemoised(): void {
+  if (process.env.NODE_ENV === 'production' || hasWarnedAboutSlotChurn) return;
+  hasWarnedAboutSlotChurn = true;
+  // eslint-disable-next-line no-console
+  console.warn(
+    `[Bloom] A \`renderVideo\` slot changed identity ${SLOT_IDENTITY_CHURN_LIMIT} times. ` +
+      'It is part of what a media host publishes to the flight layer and is compared by ' +
+      'identity, so a slot rebuilt on every render republishes the surface on every render. ' +
+      'Wrap it in `useCallback` with the props it actually reads.',
+  );
+}
+
 /**
  * The STILL of a media item — a video's poster, or the image itself — and never
  * a video view.

package/src/media-flight/constants.ts

@@ -30,3 +30,25 @@ export const SURFACE_MOUNT_TIMEOUT_MS = 250;
  * `flyBack(id)` and `releaseFlight(id)` are the escape hatches, and they are
  * the caller's to use.
  */
+
+/**
+ * How many times a video slot may change identity before Bloom says so.
+ *
+ * `renderVideo` is part of what a host publishes to the layer and is compared
+ * by identity, so an unmemoised slot republishes on every render of the row it
+ * lives in — silently, and only under load. Five is well past any legitimate
+ * cause (a mute toggle, a fit change) and far below the churn of a slot rebuilt
+ * per render in a scrolling feed.
+ */
+export const SLOT_IDENTITY_CHURN_LIMIT = 5;
+
+/**
+ * How far a media element may sit from the box it is supposed to fill, in px,
+ * before Bloom says so.
+ *
+ * Two, not zero: subpixel layout and a box mid-animation both land within a
+ * pixel, and the defect this catches is not subtle — a `<video>` that never
+ * received Bloom's sizing style paints at its intrinsic 300x150 inside whatever
+ * box it was given.
+ */
+export const SLOT_FILL_TOLERANCE_PX = 2;

package/src/media-flight/index.ts

@@ -27,6 +27,9 @@ export type {
   MediaFlightAnchorNode,
   MediaFlightController,
   MediaFlightHostProps,
+  MediaSurfaceVideoOf,
+  MediaVideoSlot,
+  MediaVideoSlotProps,
   MediaFlightOptions,
   MediaSurfaceContent,
   MediaSurfaceImage,

package/src/media-flight/index.web.ts

@@ -36,6 +36,9 @@ export type {
   MediaFlightAnchorNode,
   MediaFlightController,
   MediaFlightHostProps,
+  MediaSurfaceVideoOf,
+  MediaVideoSlot,
+  MediaVideoSlotProps,
   MediaFlightOptions,
   MediaSurfaceContent,
   MediaSurfaceImage,

package/src/media-flight/store.ts

@@ -432,7 +432,10 @@ export function flyBack(id: string): void {
  *
  * DO NOT replace this with a direct `unmountVideoView` call. It looks
  * equivalent, it is the half that does not matter, and the fix would disappear
- * silently. `MediaFlight.test.tsx` makes that substitution its control.
+ * silently. `MediaFlight.test.tsx` makes that substitution its control, and
+ * `scripts/probe-expo-video-listener-leak.mjs` measures the upstream defect
+ * this steps around — run it before touching any of this. The day it prints
+ * LEAK GONE, this commit and the tests that pin it can go.
  *
  * The cost is one frame in which the outgoing surface shows its poster instead
  * of video. It is already on its way out and the destination is live by then —

package/src/media-flight/types.ts

@@ -66,6 +66,19 @@ export interface MediaSurfaceVideo {
 /** What a media surface paints: a still image, or a consumer-owned video. */
 export type MediaSurfaceContent = MediaSurfaceImage | MediaSurfaceVideo;
 
+/**
+ * `MediaSurfaceVideo` carrying the consumer's OWN player type.
+ *
+ * Bloom transports that object; it never reads it. Narrowing it to
+ * `VideoPlayerLike` on the way through would be Bloom asserting something about
+ * cargo — and it would land on the consumer, who then has to cast the player
+ * back before handing it to expo-video's `VideoView`. A contract that pushes a
+ * consumer towards `as` ends up as an `as any` in someone's repo.
+ */
+export interface MediaSurfaceVideoOf<P extends VideoPlayerLike> extends MediaSurfaceVideo {
+  player: P;
+}
+
 /**
  * A media surface currently owned by the flight layer.
  *
@@ -233,7 +246,7 @@ export interface MediaFlightController {
  * INTRINSIC size (300x150) instead of stretching — so a slot that drops this
  * style paints a 300x150 video inside whatever box it was given. Spread it.
  */
-export interface MediaVideoSlotProps {
+export interface MediaVideoSlotProps<P extends VideoPlayerLike = VideoPlayerLike> {
   /**
    * The player Bloom was given — never one Bloom created.
    *
@@ -244,7 +257,7 @@ export interface MediaVideoSlotProps {
    * anything else here — keeping the old player, unmounting instead — brings
    * that defect back. See `releaseFlight`.
    */
-  player: VideoPlayerLike | null;
+  player: P | null;
   /** Fills the box. Spread it — see above. */
   style: StyleProp<ViewStyle>;
   contentFit: 'contain' | 'cover';
@@ -267,7 +280,9 @@ export interface MediaVideoSlotProps {
  * layer, compared by identity — a new function every render republishes every
  * render. Correct either way, wasteful if you skip it.
  */
-export type MediaVideoSlot = (props: MediaVideoSlotProps) => ReactNode;
+export type MediaVideoSlot<P extends VideoPlayerLike = VideoPlayerLike> = (
+  props: MediaVideoSlotProps<P>,
+) => ReactNode;
 
 /**
  * A place a media surface may live: the feed row it starts in, the fullscreen
@@ -279,11 +294,16 @@ export type MediaVideoSlot = (props: MediaVideoSlotProps) => ReactNode;
  * ever leaving the document. On native a host renders its media inline, which
  * is what it has always done and what the platform makes correct there.
  */
-export interface MediaFlightHostProps {
+export interface MediaFlightHostProps<P extends VideoPlayerLike = VideoPlayerLike> {
   /** The id this host shares with the flight and with the other end. */
   id: string;
-  /** What to paint: a still image, or a consumer-owned expo-video player. */
-  content: MediaSurfaceContent;
+  /**
+   * What to paint: a still image, or a consumer-owned expo-video player.
+   *
+   * The player's own type flows from here into {@link renderVideo}, so a slot
+   * gets back exactly what it put in and hands it to `VideoView` with no cast.
+   */
+  content: MediaSurfaceImage | MediaSurfaceVideoOf<P>;
   /** Style of the host BOX. Give it the radius and `overflow: 'hidden'` you want. */
   style?: StyleProp<ViewStyle>;
   /** How the media fills the box. Defaults to `'cover'`. */
@@ -292,7 +312,7 @@ export interface MediaFlightHostProps {
    * Paint the video yourself, keeping your own `ref` and expo-video props. See
    * {@link MediaVideoSlot}; memoise it.
    */
-  renderVideo?: MediaVideoSlot;
+  renderVideo?: MediaVideoSlot<P>;
   /** Whether the video arm shows expo-video's own controls. Defaults to `false`. */
   nativeControls?: boolean;
   accessibilityLabel?: string;