@oxyhq/bloom 1.1.0 → 1.2.1

package/lib/commonjs/media-flight/expo-video-module.js

@@ -0,0 +1,180 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.loadExpoVideo = loadExpoVideo;
+exports.provideExpoVideo = provideExpoVideo;
+exports.resetExpoVideoModule = resetExpoVideoModule;
+exports.warnExpoVideoUnavailable = warnExpoVideoUnavailable;
+/**
+ * The optional-peer boundary for `expo-video`.
+ *
+ * Bloom ships no native code and never will, so `expo-video` cannot be a hard
+ * dependency: an app that renders no video must not be made to install a native
+ * module. It is therefore an OPTIONAL peer, and a static `import` contradicts
+ * that — Metro resolves every static import in the eager graph, so an omitted
+ * "optional" peer does not degrade, it aborts the whole bundle with `Unable to
+ * resolve module expo-video`, naming a package the app never mentions.
+ *
+ * The load has to be dynamic in the ONE shape Metro understands: a `require()`
+ * of a STRING LITERAL as a DIRECT STATEMENT of a `try` block, which Metro
+ * collects as an optional dependency (resolving the real module when installed,
+ * writing `null` into the dependency map when it is not, so the failure lands in
+ * the `catch` below at evaluation time instead of at build time). One `if` of
+ * nesting loses that — `isOptionalDependency` returns at the FIRST BlockStatement
+ * it meets — hence the `typeof require` guard sits OUTSIDE the try.
+ *
+ * `require` may also not exist at all (this file backs the `import` condition
+ * too, i.e. an ESM build under Node), hence that guard.
+ *
+ * A missing video module is invisible — a poster where a video should be looks
+ * exactly like a video that has not started — so {@link warnExpoVideoUnavailable}
+ * names the package once, in dev.
+ *
+ * @see connection-status/netinfo.ts — the same boundary for netinfo.
+ * @see hooks/haptics-module.ts — the same boundary for expo-haptics.
+ */
+
+/**
+ * Declared locally rather than taken from the ambient `NodeRequire`, which
+ * returns `any`: `unknown` forces the module handle to be narrowed below instead
+ * of leaking an untyped value into the caller.
+ */
+
+/**
+ * The slice of `expo-video`'s `VideoPlayer` Bloom depends on.
+ *
+ * Hand-written rather than `typeof import('expo-video')` so no expo-video type
+ * reaches Bloom's emitted declarations — a consumer that skips the optional peer
+ * must not inherit a TS7016 from Bloom's own `.d.ts`. The two are kept in step by
+ * the assignability check in `__tests__/MediaFlight.test.tsx`, which is excluded
+ * from the build and so may name the real package.
+ *
+ * Bloom never CALLS any of this. **The consumer creates the player, owns it and
+ * destroys it**; Bloom only hands the object back to a `VideoView`, which is the
+ * whole mechanism that lets a video move between surfaces without restarting
+ * (expo-video's own docs: "when the same player is playing in multiple video
+ * views"). The three members below exist so the type is not `object` — a
+ * structural minimum the real `VideoPlayer` satisfies, and that an arbitrary
+ * object does not.
+ *
+ * `play`/`pause` are declared in METHOD syntax deliberately: `strictFunctionTypes`
+ * exempts method parameters from contravariance, which keeps a real
+ * `VideoPlayer` assignable here across `@types/react` copies.
+ */
+
+/** How a video is scaled inside its box. Mirrors expo-video's `VideoContentFit`. */
+
+/**
+ * Android's rendering surface for a video view.
+ *
+ * `textureView` is what Bloom asks for everywhere, because a `SurfaceView` is
+ * composited by the system OUTSIDE the app's view hierarchy: it ignores the
+ * parent's clip, corner radius and transform, so a video flying between two
+ * rects would paint as an un-rounded rectangle at the wrong place. It also
+ * cannot be changed at runtime (expo-video: "This prop should not be changed at
+ * runtime"), which is why {@link MediaSurfaceProps.surfaceType} is captured on
+ * first render.
+ */
+
+/** The slice of `VideoViewProps` Bloom passes. */
+
+/** The slice of expo-video's module surface Bloom renders. */
+
+/** `undefined` until the first load attempt, then the module or `null`. */
+let videoModule;
+/** Set by {@link provideExpoVideo}; wins over the `require` below. */
+let providedModule;
+/** Why the load failed, quoted verbatim in the dev warning. */
+let unavailableReason = '';
+let hasWarned = false;
+
+/**
+ * Hand Bloom the expo-video module explicitly.
+ *
+ * REQUIRED ON ANY ESM WEB BUNDLER, and measured rather than assumed: in a Vite
+ * bundle `typeof require` is `undefined`, so the optional-peer `require` below
+ * cannot run and video silently degrades to its poster **even when expo-video
+ * is installed**. Metro has a real `require` and is unaffected, which is why
+ * this went unnoticed — the app that uses this is Metro-built.
+ *
+ * There is no bundler-agnostic sync alternative: `import()` is async and this is
+ * called during render, so making it async would mean the surface renders
+ * without video for a frame and then upgrades. Handing the module over is
+ * explicit, synchronous, and costs the consumer one line at startup:
+ *
+ * ```ts
+ * import * as ExpoVideo from 'expo-video';
+ * provideExpoVideo(ExpoVideo);
+ * ```
+ *
+ * Pass `null` to clear it.
+ */
+function provideExpoVideo(module) {
+  providedModule = module;
+  // Drop any cached `require` result so the next load reflects this decision.
+  videoModule = undefined;
+}
+
+/** The expo-video module, or `null` when the optional peer is not installed. */
+function loadExpoVideo() {
+  if (providedModule !== undefined && providedModule !== null) return providedModule;
+  if (videoModule !== undefined) return videoModule;
+  videoModule = null;
+
+  // The `typeof require` guard sits OUTSIDE the try on purpose — see the header.
+  // Nested one `if`/`else` deeper, the require below is no longer a direct
+  // statement of the try block, Metro stops marking it optional, and an app
+  // without expo-video fails to BUILD instead of losing the video surface.
+  if (typeof require === 'undefined') {
+    unavailableReason = 'this bundle has no CommonJS `require`';
+    return videoModule;
+  }
+  try {
+    const loaded = require('expo-video');
+    // `VideoView` is a class component upstream, so `typeof` is `'function'`
+    // either way; a memo/forwardRef build would be an object carrying
+    // `$$typeof`. Both are accepted, nothing else is.
+    const resolved = isComponentBearing(loaded) ? loaded : loaded?.default;
+    if (isComponentBearing(resolved)) {
+      videoModule = {
+        VideoView: resolved.VideoView
+      };
+    } else {
+      unavailableReason = 'the module resolved without a `VideoView` export';
+    }
+  } catch (error) {
+    unavailableReason = error instanceof Error ? error.message : String(error);
+  }
+  return videoModule;
+}
+function isComponentBearing(candidate) {
+  const view = candidate?.VideoView;
+  if (typeof view === 'function') return true;
+  return typeof view === 'object' && view !== null && '$$typeof' in view;
+}
+
+/**
+ * One warning per module lifetime, and none in production — the same mechanism
+ * as `connection-status/netinfo.ts` and `hooks/haptics-module.ts`. Metro and
+ * Vite/Rolldown both fold the `NODE_ENV` check statically, so a production
+ * bundle keeps neither the branch nor the message.
+ */
+function warnExpoVideoUnavailable() {
+  if (process.env.NODE_ENV === 'production' || hasWarned) return;
+  hasWarned = true;
+  // Internal Bloom diagnostic: only the consumer's package.json can fix this,
+  // so it names the package, the install command and what is lost.
+  // eslint-disable-next-line no-console
+  console.warn('[Bloom] A video media surface fell back to its poster: the optional peer ' + '`expo-video` could not be loaded, so no video is rendered and the shared ' + 'media transition carries a still frame instead. Install it ' + '(`npx expo install expo-video`) or pass image content only. ' + `Reason: ${unavailableReason}`);
+}
+
+/** Test seam — drops the cached module handle so a suite can load it again. */
+function resetExpoVideoModule() {
+  videoModule = undefined;
+  providedModule = undefined;
+  unavailableReason = '';
+  hasWarned = false;
+}
+//# sourceMappingURL=expo-video-module.js.map

package/lib/commonjs/media-flight/expo-video-module.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["videoModule","providedModule","unavailableReason","hasWarned","provideExpoVideo","module","undefined","loadExpoVideo","require","loaded","resolved","isComponentBearing","default","VideoView","error","Error","message","String","candidate","view","warnExpoVideoUnavailable","process","env","NODE_ENV","console","warn","resetExpoVideoModule"],"sourceRoot":"../../../src","sources":["media-flight/expo-video-module.ts"],"mappings":";;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAkBA;;AAKA;AACA,IAAIA,WAA6C;AACjD;AACA,IAAIC,cAAgD;AACpD;AACA,IAAIC,iBAAiB,GAAG,EAAE;AAC1B,IAAIC,SAAS,GAAG,KAAK;;AAErB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAACC,MAA4B,EAAQ;EACnEJ,cAAc,GAAGI,MAAM;EACvB;EACAL,WAAW,GAAGM,SAAS;AACzB;;AAEA;AACO,SAASC,aAAaA,CAAA,EAAyB;EACpD,IAAIN,cAAc,KAAKK,SAAS,IAAIL,cAAc,KAAK,IAAI,EAAE,OAAOA,cAAc;EAClF,IAAID,WAAW,KAAKM,SAAS,EAAE,OAAON,WAAW;EACjDA,WAAW,GAAG,IAAI;;EAElB;EACA;EACA;EACA;EACA,IAAI,OAAOQ,OAAO,KAAK,WAAW,EAAE;IAClCN,iBAAiB,GAAG,uCAAuC;IAC3D,OAAOF,WAAW;EACpB;EAEA,IAAI;IACF,MAAMS,MAAM,GAAGD,OAAO,CAAC,YAAY,CAGtB;IACb;IACA;IACA;IACA,MAAME,QAAQ,GAAGC,kBAAkB,CAACF,MAAM,CAAC,GAAGA,MAAM,GAAGA,MAAM,EAAEG,OAAO;IAEtE,IAAID,kBAAkB,CAACD,QAAQ,CAAC,EAAE;MAChCV,WAAW,GAAG;QAAEa,SAAS,EAAEH,QAAQ,CAACG;MAA+C,CAAC;IACtF,CAAC,MAAM;MACLX,iBAAiB,GAAG,kDAAkD;IACxE;EACF,CAAC,CAAC,OAAOY,KAAK,EAAE;IACdZ,iBAAiB,GAAGY,KAAK,YAAYC,KAAK,GAAGD,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC;EAC5E;EAEA,OAAOd,WAAW;AACpB;AAEA,SAASW,kBAAkBA,CACzBO,SAA8E,EACU;EACxF,MAAMC,IAAI,GAAGD,SAAS,EAAEL,SAAS;EACjC,IAAI,OAAOM,IAAI,KAAK,UAAU,EAAE,OAAO,IAAI;EAC3C,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAIA,IAAI,KAAK,IAAI,IAAI,UAAU,IAAIA,IAAI;AACxE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,wBAAwBA,CAAA,EAAS;EAC/C,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIpB,SAAS,EAAE;EACxDA,SAAS,GAAG,IAAI;EAChB;EACA;EACA;EACAqB,OAAO,CAACC,IAAI,CACV,2EAA2E,GACzE,2EAA2E,GAC3E,6DAA6D,GAC7D,8DAA8D,GAC9D,WAAWvB,iBAAiB,EAChC,CAAC;AACH;;AAEA;AACO,SAASwB,oBAAoBA,CAAA,EAAS;EAC3C1B,WAAW,GAAGM,SAAS;EACvBL,cAAc,GAAGK,SAAS;EAC1BJ,iBAAiB,GAAG,EAAE;EACtBC,SAAS,GAAG,KAAK;AACnB","ignoreList":[]}

package/lib/commonjs/media-flight/index.js

@@ -0,0 +1,108 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DEFAULT_FLIGHT_CORNER_RADIUS", {
+  enumerable: true,
+  get: function () {
+    return _store.DEFAULT_FLIGHT_CORNER_RADIUS;
+  }
+});
+Object.defineProperty(exports, "EmptyMediaSurface", {
+  enumerable: true,
+  get: function () {
+    return _MediaSurface.EmptyMediaSurface;
+  }
+});
+Object.defineProperty(exports, "MediaFlightLayer", {
+  enumerable: true,
+  get: function () {
+    return _MediaFlightLayer.MediaFlightLayer;
+  }
+});
+Object.defineProperty(exports, "MediaPoster", {
+  enumerable: true,
+  get: function () {
+    return _MediaSurface.MediaPoster;
+  }
+});
+Object.defineProperty(exports, "MediaSurface", {
+  enumerable: true,
+  get: function () {
+    return _MediaSurface.MediaSurface;
+  }
+});
+Object.defineProperty(exports, "SURFACE_MOUNT_TIMEOUT_MS", {
+  enumerable: true,
+  get: function () {
+    return _constants.SURFACE_MOUNT_TIMEOUT_MS;
+  }
+});
+Object.defineProperty(exports, "flightProgress", {
+  enumerable: true,
+  get: function () {
+    return _store.flightProgress;
+  }
+});
+Object.defineProperty(exports, "handOffFlight", {
+  enumerable: true,
+  get: function () {
+    return _store.handOffFlight;
+  }
+});
+Object.defineProperty(exports, "hasFlight", {
+  enumerable: true,
+  get: function () {
+    return _store.hasFlight;
+  }
+});
+Object.defineProperty(exports, "loadExpoVideo", {
+  enumerable: true,
+  get: function () {
+    return _expoVideoModule.loadExpoVideo;
+  }
+});
+Object.defineProperty(exports, "provideExpoVideo", {
+  enumerable: true,
+  get: function () {
+    return _expoVideoModule.provideExpoVideo;
+  }
+});
+Object.defineProperty(exports, "releaseFlight", {
+  enumerable: true,
+  get: function () {
+    return _store.releaseFlight;
+  }
+});
+Object.defineProperty(exports, "resetExpoVideoModule", {
+  enumerable: true,
+  get: function () {
+    return _expoVideoModule.resetExpoVideoModule;
+  }
+});
+Object.defineProperty(exports, "resetMediaFlight", {
+  enumerable: true,
+  get: function () {
+    return _store.resetMediaFlight;
+  }
+});
+Object.defineProperty(exports, "useMediaFlight", {
+  enumerable: true,
+  get: function () {
+    return _useMediaFlight.useMediaFlight;
+  }
+});
+Object.defineProperty(exports, "warnExpoVideoUnavailable", {
+  enumerable: true,
+  get: function () {
+    return _expoVideoModule.warnExpoVideoUnavailable;
+  }
+});
+var _MediaFlightLayer = require("./MediaFlightLayer.js");
+var _MediaSurface = require("./MediaSurface.js");
+var _useMediaFlight = require("./use-media-flight.js");
+var _store = require("./store.js");
+var _constants = require("./constants.js");
+var _expoVideoModule = require("./expo-video-module.js");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/media-flight/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_MediaFlightLayer","require","_MediaSurface","_useMediaFlight","_store","_constants","_expoVideoModule"],"sourceRoot":"../../../src","sources":["media-flight/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,iBAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,eAAA,GAAAF,OAAA;AACA,IAAAG,MAAA,GAAAH,OAAA;AAQA,IAAAI,UAAA,GAAAJ,OAAA;AACA,IAAAK,gBAAA,GAAAL,OAAA","ignoreList":[]}