@oxyhq/bloom 1.8.0 → 1.9.0

package/docs/getting-started.mdx

@@ -67,32 +67,46 @@ export function Hello() {
 ## If you build with Vite (or any ESM web bundler)
 
 Bloom reaches its **optional** peers through a `require()` that Metro marks
-optional. An ESM web bundle has no `require` at all — measured: `typeof require`
-is `undefined` in a Vite bundle — so those loads cannot run and every optional
-peer degrades **even when the package is installed**. Metro is unaffected, which
-is why this only appears off Metro.
+optional. Off Metro that load does not deliver the package **even when it is
+installed** — and the reason depends on your bundler, which is why this defect
+keeps being diagnosed wrongly:
 
-**Check in one line**, in your app's console:
+| bundler | `typeof require` | what happens |
+| --- | --- | --- |
+| Rollup / Vite | `"undefined"` | the guard sees no `require` and degrades |
+| esbuild | `"function"` | a shim that THROWS, so the guard passes and the call fails inside the `try` |
 
-```js
-typeof require   // "undefined" -> the optional peers below are inert for you
-```
+Same symptom, different causes — so `typeof require` is **not** a reliable check
+for whether you are affected. Metro is unaffected.
+
+**What you actually lose on web is the connection toasts**, and only those:
+`ConnectionStatusToasts` calls `loadNetInfo()` with no platform guard, so a web
+app with `@react-native-community/netinfo` installed gets no outage toast.
+
+**The other optional peers are NOT affected on web**, because their callers
+return before the `require` is ever reached:
 
-Today one of them can be handed over explicitly:
+| peer | why web never reaches it |
+| --- | --- |
+| `expo-router` (adaptive colours) | `getAdaptiveColors` returns `null` unless `Platform.OS` is `android`/`ios` (`theme/adaptive-colors.ts:143-145`) |
+| `nativewind` (scoped presets) | both callers `return` on web (`theme/color-scope/style-builder.ts:159, :192`) |
+| `expo-haptics` | `useHaptics` returns on web (`hooks/use-haptics.tsx:47`) |
+
+If scoped NativeWind presets are wrong in your web app, this is not the cause —
+look at the CSS-variable pipeline instead.
+
+Two peers can be handed over explicitly, which works on any bundler:
 
 ```ts
 import * as ExpoVideo from 'expo-video';
+import NetInfo from '@react-native-community/netinfo';
 import { provideExpoVideo } from '@oxyhq/bloom/media-flight';
+import { provideNetInfo } from '@oxyhq/bloom/connection-status';
 
 provideExpoVideo(ExpoVideo);   // otherwise video silently shows only its poster
+provideNetInfo(NetInfo);       // otherwise the outage toast never appears
 ```
 
-The others have no equivalent yet, so on an ESM bundle you currently lose
-scoped NativeWind presets (`BloomColorScope`), adaptive colours, haptics and the
-connection toasts. Most of them say so in the dev console — the warning ends
-`Reason: this bundle has no CommonJS require` — with the exception noted in
-`theme/adaptive-colors.ts`, which degrades silently.
-
 ## Recommended layout
 
 If your app supports both light and dark themes:

package/docs/media-flight.mdx

@@ -583,13 +583,19 @@ flies video without it gets the poster plus a single dev warning naming the
 package.
 
 <Callout variant="warning" title="On Vite (or any ESM web bundler) you must hand expo-video over">
-Bloom loads optional peers through a `require()` that Metro marks optional.
-**An ESM web bundle has no `require` at all** — measured: `typeof require` is
-`undefined` in a Vite bundle — so the load cannot run and video degrades to its
-poster **even when `expo-video` is installed**. Metro has a real `require` and
-is unaffected, which is why this only shows up off Metro.
+Bloom loads optional peers through a `require()` that Metro marks optional. Off
+Metro that load does not deliver the package **even when `expo-video` is
+installed**, and video degrades to its poster.
 
-One line at startup fixes it:
+**Do not test for this with `typeof require`.** The cause depends on the
+bundler and the symptom does not:
+
+| bundler | `typeof require` | what happens |
+| --- | --- | --- |
+| Rollup / Vite | `"undefined"` | the guard sees no `require` and degrades |
+| esbuild | `"function"` | a shim that THROWS, so the guard passes and the call fails inside the `try` |
+
+One line at startup fixes it, on any bundler:
 
 ```ts
 import * as ExpoVideo from 'expo-video';
@@ -598,9 +604,8 @@ import { provideExpoVideo } from '@oxyhq/bloom/media-flight';
 provideExpoVideo(ExpoVideo);
 ```
 
-How to tell whether it applies to you: run `typeof require` in your app's
-console. If it answers `"undefined"`, you need this. The dev console also says
-so directly — the warning ends `Reason: this bundle has no CommonJS require`.
+The dev console says so too, and the `Reason:` it prints is the bundler's own
+message rather than a fixed string.
 </Callout>
 
 ## What a jest run can and cannot see

package/lib/commonjs/connection-status/index.js

@@ -9,5 +9,12 @@ Object.defineProperty(exports, "ConnectionStatusToasts", {
     return _ConnectionStatusToasts.ConnectionStatusToasts;
   }
 });
+Object.defineProperty(exports, "provideNetInfo", {
+  enumerable: true,
+  get: function () {
+    return _netinfo.provideNetInfo;
+  }
+});
+var _netinfo = require("./netinfo.js");
 var _ConnectionStatusToasts = require("./ConnectionStatusToasts");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/connection-status/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_ConnectionStatusToasts","require"],"sourceRoot":"../../../src","sources":["connection-status/index.ts"],"mappings":";;;;;;;;;;;AACA,IAAAA,uBAAA,GAAAC,OAAA","ignoreList":[]}
+{"version":3,"names":["_netinfo","require","_ConnectionStatusToasts"],"sourceRoot":"../../../src","sources":["connection-status/index.ts"],"mappings":";;;;;;;;;;;;;;;;;AAGA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,uBAAA,GAAAD,OAAA","ignoreList":[]}

package/lib/commonjs/connection-status/index.web.js

@@ -9,5 +9,12 @@ Object.defineProperty(exports, "ConnectionStatusToasts", {
     return _ConnectionStatusToastsWeb.ConnectionStatusToasts;
   }
 });
+Object.defineProperty(exports, "provideNetInfo", {
+  enumerable: true,
+  get: function () {
+    return _netinfo.provideNetInfo;
+  }
+});
+var _netinfo = require("./netinfo.js");
 var _ConnectionStatusToastsWeb = require("./ConnectionStatusToasts.web.js");
 //# sourceMappingURL=index.web.js.map

package/lib/commonjs/connection-status/index.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["_ConnectionStatusToastsWeb","require"],"sourceRoot":"../../../src","sources":["connection-status/index.web.ts"],"mappings":";;;;;;;;;;;AACA,IAAAA,0BAAA,GAAAC,OAAA","ignoreList":[]}
+{"version":3,"names":["_netinfo","require","_ConnectionStatusToastsWeb"],"sourceRoot":"../../../src","sources":["connection-status/index.web.ts"],"mappings":";;;;;;;;;;;;;;;;;AAGA,IAAAA,QAAA,GAAAC,OAAA;AACA,IAAAC,0BAAA,GAAAD,OAAA","ignoreList":[]}

package/lib/commonjs/connection-status/netinfo.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.loadNetInfo = loadNetInfo;
+exports.provideNetInfo = provideNetInfo;
 exports.warnNetInfoUnavailable = warnNetInfoUnavailable;
 /**
  * The optional-peer boundary for `@react-native-community/netinfo`.
@@ -68,12 +69,45 @@ exports.warnNetInfoUnavailable = warnNetInfoUnavailable;
 
 /** `undefined` until the first load attempt, then the module or `null`. */
 let netInfoModule;
+/** Handed in by a consumer, which is the only thing that works in an ESM bundle. */
+let providedModule = null;
 /** Why the load failed, quoted verbatim in the dev warning. */
 let unavailableReason = '';
 let hasWarned = false;
 
+/**
+ * Hand Bloom the netinfo module, from a consumer that has it.
+ *
+ * THIS IS NOT A TEST HOOK. It is the only mechanism that works in an ESM
+ * bundle: the consumer, who knows it has the peer and which entry of it its own
+ * bundler resolved, hands the module in.
+ *
+ * The `require` below cannot be relied on off Metro, and the reason is worth
+ * knowing because the symptom is identical while the cause is not:
+ *
+ *   - Rollup / Vite ESM output: `require` is undefined, the guard catches it,
+ *     and the boundary degrades.
+ *   - esbuild ESM output: `require` EXISTS as a shim that throws
+ *     (`Dynamic require of "…" is not supported`), so the guard PASSES and the
+ *     call throws inside the try. Measured with the peer installed on disk:
+ *     `platform=node` and `platform=browser` both degraded.
+ *
+ * So a fix aimed at the `typeof require` check would have changed nothing under
+ * esbuild. And there is no synchronous, bundler-agnostic alternative: `import()`
+ * is asynchronous AND resolved at build time, so an absent package fails the
+ * BUILD — which is what this boundary exists to prevent.
+ *
+ * Metro is unaffected either way and needs no binding.
+ */
+function provideNetInfo(module) {
+  providedModule = module;
+  netInfoModule = undefined;
+  hasWarned = false;
+}
+
 /** The netinfo module, or `null` when the optional peer is not installed. */
 function loadNetInfo() {
+  if (providedModule !== null) return providedModule;
   if (netInfoModule !== undefined) return netInfoModule;
   netInfoModule = null;
 

package/lib/commonjs/connection-status/netinfo.js.map

@@ -1 +1 @@
-{"version":3,"names":["netInfoModule","unavailableReason","hasWarned","loadNetInfo","undefined","require","loaded","resolved","addEventListener","default","error","Error","message","String","warnNetInfoUnavailable","process","env","NODE_ENV","console","warn"],"sourceRoot":"../../../src","sources":["connection-status/netinfo.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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAGA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA,IAAIA,aAA6C;AACjD;AACA,IAAIC,iBAAiB,GAAG,EAAE;AAC1B,IAAIC,SAAS,GAAG,KAAK;;AAErB;AACO,SAASC,WAAWA,CAAA,EAAuB;EAChD,IAAIH,aAAa,KAAKI,SAAS,EAAE,OAAOJ,aAAa;EACrDA,aAAa,GAAG,IAAI;;EAEpB;EACA;EACA;EACA;EACA,IAAI,OAAOK,OAAO,KAAK,WAAW,EAAE;IAClCJ,iBAAiB,GAAG,uCAAuC;IAC3D,OAAOD,aAAa;EACtB;EAEA,IAAI;IACF;IACA;IACA;IACA,MAAMM,MAAM,GAAGD,OAAO,CAAC,iCAAiC,CAG3C;IACb,MAAME,QAAQ,GAAG,OAAOD,MAAM,EAAEE,gBAAgB,KAAK,UAAU,GAAGF,MAAM,GAAGA,MAAM,EAAEG,OAAO;IAE1F,IAAI,OAAOF,QAAQ,EAAEC,gBAAgB,KAAK,UAAU,EAAE;MACpDR,aAAa,GAAGO,QAAuB;IACzC,CAAC,MAAM;MACLN,iBAAiB,GAAG,0DAA0D;IAChF;EACF,CAAC,CAAC,OAAOS,KAAK,EAAE;IACdT,iBAAiB,GAAGS,KAAK,YAAYC,KAAK,GAAGD,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC;EAC5E;EAEA,OAAOV,aAAa;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASc,sBAAsBA,CAAA,EAAS;EAC7C,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIf,SAAS,EAAE;EACxDA,SAAS,GAAG,IAAI;EAChB;EACA;EACA;EACAgB,OAAO,CAACC,IAAI,CACV,6DAA6D,GAC3D,+EAA+E,GAC/E,8EAA8E,GAC9E,6EAA6E,GAC7E,oDAAoDlB,iBAAiB,EACzE,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["netInfoModule","providedModule","unavailableReason","hasWarned","provideNetInfo","module","undefined","loadNetInfo","require","loaded","resolved","addEventListener","default","error","Error","message","String","warnNetInfoUnavailable","process","env","NODE_ENV","console","warn"],"sourceRoot":"../../../src","sources":["connection-status/netinfo.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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAGA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA,IAAIA,aAA6C;AACjD;AACA,IAAIC,cAAkC,GAAG,IAAI;AAC7C;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;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAACC,MAA0B,EAAQ;EAC/DJ,cAAc,GAAGI,MAAM;EACvBL,aAAa,GAAGM,SAAS;EACzBH,SAAS,GAAG,KAAK;AACnB;;AAEA;AACO,SAASI,WAAWA,CAAA,EAAuB;EAChD,IAAIN,cAAc,KAAK,IAAI,EAAE,OAAOA,cAAc;EAClD,IAAID,aAAa,KAAKM,SAAS,EAAE,OAAON,aAAa;EACrDA,aAAa,GAAG,IAAI;;EAEpB;EACA;EACA;EACA;EACA,IAAI,OAAOQ,OAAO,KAAK,WAAW,EAAE;IAClCN,iBAAiB,GAAG,uCAAuC;IAC3D,OAAOF,aAAa;EACtB;EAEA,IAAI;IACF;IACA;IACA;IACA,MAAMS,MAAM,GAAGD,OAAO,CAAC,iCAAiC,CAG3C;IACb,MAAME,QAAQ,GAAG,OAAOD,MAAM,EAAEE,gBAAgB,KAAK,UAAU,GAAGF,MAAM,GAAGA,MAAM,EAAEG,OAAO;IAE1F,IAAI,OAAOF,QAAQ,EAAEC,gBAAgB,KAAK,UAAU,EAAE;MACpDX,aAAa,GAAGU,QAAuB;IACzC,CAAC,MAAM;MACLR,iBAAiB,GAAG,0DAA0D;IAChF;EACF,CAAC,CAAC,OAAOW,KAAK,EAAE;IACdX,iBAAiB,GAAGW,KAAK,YAAYC,KAAK,GAAGD,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC;EAC5E;EAEA,OAAOb,aAAa;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASiB,sBAAsBA,CAAA,EAAS;EAC7C,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIjB,SAAS,EAAE;EACxDA,SAAS,GAAG,IAAI;EAChB;EACA;EACA;EACAkB,OAAO,CAACC,IAAI,CACV,6DAA6D,GAC3D,+EAA+E,GAC/E,8EAA8E,GAC9E,6EAA6E,GAC7E,oDAAoDpB,iBAAiB,EACzE,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/theme/adaptive-colors.js

@@ -41,9 +41,30 @@ var _reactNative = require("react-native");
  */
 
 const c = v => v;
+let hasWarned = false;
+
+/**
+ * SAY SO. This boundary degraded in complete silence, which is the worst of the
+ * six: an app simply gets the preset palette instead of the platform's, and
+ * nothing anywhere says the platform read failed.
+ *
+ * It is only reachable on Android and iOS — `getAdaptiveColors` returns `null`
+ * on web before touching `require` — so an ESM bundle never gets here. That is
+ * an argument for warning, not against it: a failure that cannot happen in the
+ * environment you test in is exactly the one that goes unnoticed when it does.
+ */
+function warnAdaptiveColorsUnavailable(reason) {
+  if (process.env.NODE_ENV === 'production' || hasWarned) return;
+  hasWarned = true;
+  // eslint-disable-next-line no-console
+  console.warn('[Bloom] The adaptive palette fell back to the preset one: `expo-router`’s ' + '`Color` proxy could not be read, so platform colours (Material You, iOS ' + 'dynamic) are not in use. Install the optional peer ' + '(`npx expo install expo-router`) if you want them. ' + `Reason: ${reason}`);
+}
 function getAndroidColors() {
   try {
-    if (typeof require === 'undefined') return null;
+    if (typeof require === 'undefined') {
+      warnAdaptiveColorsUnavailable('this bundle has no CommonJS `require`');
+      return null;
+    }
     const {
       Color
     } = require('expo-router');
@@ -83,13 +104,17 @@ function getAndroidColors() {
       shadow: 'rgba(0, 0, 0, 0.2)',
       overlay: 'rgba(0, 0, 0, 0.5)'
     };
-  } catch {
+  } catch (error) {
+    warnAdaptiveColorsUnavailable(error instanceof Error ? error.message : String(error));
     return null;
   }
 }
 function getIOSColors() {
   try {
-    if (typeof require === 'undefined') return null;
+    if (typeof require === 'undefined') {
+      warnAdaptiveColorsUnavailable('this bundle has no CommonJS `require`');
+      return null;
+    }
     const {
       Color
     } = require('expo-router');
@@ -129,7 +154,8 @@ function getIOSColors() {
       shadow: 'rgba(0, 0, 0, 0.15)',
       overlay: 'rgba(0, 0, 0, 0.5)'
     };
-  } catch {
+  } catch (error) {
+    warnAdaptiveColorsUnavailable(error instanceof Error ? error.message : String(error));
     return null;
   }
 }

package/lib/commonjs/theme/adaptive-colors.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","c","v","getAndroidColors","Color","d","android","dynamic","background","surface","backgroundSecondary","surfaceContainerLow","backgroundTertiary","surfaceContainer","text","onSurface","textSecondary","onSurfaceVariant","textTertiary","outline","border","outlineVariant","borderLight","primary","primaryForeground","onPrimary","primaryLight","primaryContainer","primaryDark","onPrimaryContainer","secondary","secondaryForeground","onSecondary","tertiary","tertiaryForeground","onTertiary","tint","icon","iconActive","success","error","warning","info","primarySubtle","primarySubtleForeground","negative","negativeForeground","negativeSubtle","errorContainer","negativeSubtleForeground","onErrorContainer","contrast50","card","shadow","overlay","getIOSColors","i","ios","systemBackground","secondarySystemBackground","tertiarySystemBackground","label","secondaryLabel","tertiaryLabel","separator","opaqueSeparator","systemBlue","systemGray6","systemPurple","systemTeal","systemGreen","systemRed","systemOrange","getAdaptiveColors","Platform","OS"],"sourceRoot":"../../../src","sources":["theme/adaptive-colors.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","c","v","hasWarned","warnAdaptiveColorsUnavailable","reason","process","env","NODE_ENV","console","warn","getAndroidColors","Color","d","android","dynamic","background","surface","backgroundSecondary","surfaceContainerLow","backgroundTertiary","surfaceContainer","text","onSurface","textSecondary","onSurfaceVariant","textTertiary","outline","border","outlineVariant","borderLight","primary","primaryForeground","onPrimary","primaryLight","primaryContainer","primaryDark","onPrimaryContainer","secondary","secondaryForeground","onSecondary","tertiary","tertiaryForeground","onTertiary","tint","icon","iconActive","success","error","warning","info","primarySubtle","primarySubtleForeground","negative","negativeForeground","negativeSubtle","errorContainer","negativeSubtleForeground","onErrorContainer","contrast50","card","shadow","overlay","Error","message","String","getIOSColors","i","ios","systemBackground","secondarySystemBackground","tertiarySystemBackground","label","secondaryLabel","tertiaryLabel","separator","opaqueSeparator","systemBlue","systemGray6","systemPurple","systemTeal","systemGreen","systemRed","systemOrange","getAdaptiveColors","Platform","OS"],"sourceRoot":"../../../src","sources":["theme/adaptive-colors.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/connection-status/index.js

@@ -1,4 +1,7 @@
 "use strict";
 
+// The hatch a consumer needs off Metro, where the optional `require` does not
+// deliver the peer even when it is installed. See `netinfo.ts`.
+export { provideNetInfo } from "./netinfo.js";
 export { ConnectionStatusToasts } from './ConnectionStatusToasts';
 //# sourceMappingURL=index.js.map

package/lib/module/connection-status/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ConnectionStatusToasts"],"sourceRoot":"../../../src","sources":["connection-status/index.ts"],"mappings":";;AACA,SACEA,sBAAsB,QACjB,0BAA0B","ignoreList":[]}
+{"version":3,"names":["provideNetInfo","ConnectionStatusToasts"],"sourceRoot":"../../../src","sources":["connection-status/index.ts"],"mappings":";;AACA;AACA;AACA,SAASA,cAAc,QAA0B,cAAW;AAC5D,SACEC,sBAAsB,QACjB,0BAA0B","ignoreList":[]}

package/lib/module/connection-status/index.web.js

@@ -1,4 +1,7 @@
 "use strict";
 
+// The hatch a consumer needs off Metro, where the optional `require` does not
+// deliver the peer even when it is installed. See `netinfo.ts`.
+export { provideNetInfo } from "./netinfo.js";
 export { ConnectionStatusToasts } from "./ConnectionStatusToasts.web.js";
 //# sourceMappingURL=index.web.js.map

package/lib/module/connection-status/index.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["ConnectionStatusToasts"],"sourceRoot":"../../../src","sources":["connection-status/index.web.ts"],"mappings":";;AACA,SACEA,sBAAsB,QACjB,iCAA8B","ignoreList":[]}
+{"version":3,"names":["provideNetInfo","ConnectionStatusToasts"],"sourceRoot":"../../../src","sources":["connection-status/index.web.ts"],"mappings":";;AACA;AACA;AACA,SAASA,cAAc,QAA0B,cAAW;AAC5D,SACEC,sBAAsB,QACjB,iCAA8B","ignoreList":[]}

package/lib/module/connection-status/netinfo.js

@@ -63,12 +63,45 @@
 
 /** `undefined` until the first load attempt, then the module or `null`. */
 let netInfoModule;
+/** Handed in by a consumer, which is the only thing that works in an ESM bundle. */
+let providedModule = null;
 /** Why the load failed, quoted verbatim in the dev warning. */
 let unavailableReason = '';
 let hasWarned = false;
 
+/**
+ * Hand Bloom the netinfo module, from a consumer that has it.
+ *
+ * THIS IS NOT A TEST HOOK. It is the only mechanism that works in an ESM
+ * bundle: the consumer, who knows it has the peer and which entry of it its own
+ * bundler resolved, hands the module in.
+ *
+ * The `require` below cannot be relied on off Metro, and the reason is worth
+ * knowing because the symptom is identical while the cause is not:
+ *
+ *   - Rollup / Vite ESM output: `require` is undefined, the guard catches it,
+ *     and the boundary degrades.
+ *   - esbuild ESM output: `require` EXISTS as a shim that throws
+ *     (`Dynamic require of "…" is not supported`), so the guard PASSES and the
+ *     call throws inside the try. Measured with the peer installed on disk:
+ *     `platform=node` and `platform=browser` both degraded.
+ *
+ * So a fix aimed at the `typeof require` check would have changed nothing under
+ * esbuild. And there is no synchronous, bundler-agnostic alternative: `import()`
+ * is asynchronous AND resolved at build time, so an absent package fails the
+ * BUILD — which is what this boundary exists to prevent.
+ *
+ * Metro is unaffected either way and needs no binding.
+ */
+export function provideNetInfo(module) {
+  providedModule = module;
+  netInfoModule = undefined;
+  hasWarned = false;
+}
+
 /** The netinfo module, or `null` when the optional peer is not installed. */
 export function loadNetInfo() {
+  if (providedModule !== null) return providedModule;
   if (netInfoModule !== undefined) return netInfoModule;
   netInfoModule = null;
 

package/lib/module/connection-status/netinfo.js.map

@@ -1 +1 @@
-{"version":3,"names":["netInfoModule","unavailableReason","hasWarned","loadNetInfo","undefined","require","loaded","resolved","addEventListener","default","error","Error","message","String","warnNetInfoUnavailable","process","env","NODE_ENV","console","warn"],"sourceRoot":"../../../src","sources":["connection-status/netinfo.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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAGA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA,IAAIA,aAA6C;AACjD;AACA,IAAIC,iBAAiB,GAAG,EAAE;AAC1B,IAAIC,SAAS,GAAG,KAAK;;AAErB;AACA,OAAO,SAASC,WAAWA,CAAA,EAAuB;EAChD,IAAIH,aAAa,KAAKI,SAAS,EAAE,OAAOJ,aAAa;EACrDA,aAAa,GAAG,IAAI;;EAEpB;EACA;EACA;EACA;EACA,IAAI,OAAOK,OAAO,KAAK,WAAW,EAAE;IAClCJ,iBAAiB,GAAG,uCAAuC;IAC3D,OAAOD,aAAa;EACtB;EAEA,IAAI;IACF;IACA;IACA;IACA,MAAMM,MAAM,GAAGD,OAAO,CAAC,iCAAiC,CAG3C;IACb,MAAME,QAAQ,GAAG,OAAOD,MAAM,EAAEE,gBAAgB,KAAK,UAAU,GAAGF,MAAM,GAAGA,MAAM,EAAEG,OAAO;IAE1F,IAAI,OAAOF,QAAQ,EAAEC,gBAAgB,KAAK,UAAU,EAAE;MACpDR,aAAa,GAAGO,QAAuB;IACzC,CAAC,MAAM;MACLN,iBAAiB,GAAG,0DAA0D;IAChF;EACF,CAAC,CAAC,OAAOS,KAAK,EAAE;IACdT,iBAAiB,GAAGS,KAAK,YAAYC,KAAK,GAAGD,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC;EAC5E;EAEA,OAAOV,aAAa;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASc,sBAAsBA,CAAA,EAAS;EAC7C,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIf,SAAS,EAAE;EACxDA,SAAS,GAAG,IAAI;EAChB;EACA;EACA;EACAgB,OAAO,CAACC,IAAI,CACV,6DAA6D,GAC3D,+EAA+E,GAC/E,8EAA8E,GAC9E,6EAA6E,GAC7E,oDAAoDlB,iBAAiB,EACzE,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["netInfoModule","providedModule","unavailableReason","hasWarned","provideNetInfo","module","undefined","loadNetInfo","require","loaded","resolved","addEventListener","default","error","Error","message","String","warnNetInfoUnavailable","process","env","NODE_ENV","console","warn"],"sourceRoot":"../../../src","sources":["connection-status/netinfo.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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAGA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA,IAAIA,aAA6C;AACjD;AACA,IAAIC,cAAkC,GAAG,IAAI;AAC7C;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;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,MAA0B,EAAQ;EAC/DJ,cAAc,GAAGI,MAAM;EACvBL,aAAa,GAAGM,SAAS;EACzBH,SAAS,GAAG,KAAK;AACnB;;AAEA;AACA,OAAO,SAASI,WAAWA,CAAA,EAAuB;EAChD,IAAIN,cAAc,KAAK,IAAI,EAAE,OAAOA,cAAc;EAClD,IAAID,aAAa,KAAKM,SAAS,EAAE,OAAON,aAAa;EACrDA,aAAa,GAAG,IAAI;;EAEpB;EACA;EACA;EACA;EACA,IAAI,OAAOQ,OAAO,KAAK,WAAW,EAAE;IAClCN,iBAAiB,GAAG,uCAAuC;IAC3D,OAAOF,aAAa;EACtB;EAEA,IAAI;IACF;IACA;IACA;IACA,MAAMS,MAAM,GAAGD,OAAO,CAAC,iCAAiC,CAG3C;IACb,MAAME,QAAQ,GAAG,OAAOD,MAAM,EAAEE,gBAAgB,KAAK,UAAU,GAAGF,MAAM,GAAGA,MAAM,EAAEG,OAAO;IAE1F,IAAI,OAAOF,QAAQ,EAAEC,gBAAgB,KAAK,UAAU,EAAE;MACpDX,aAAa,GAAGU,QAAuB;IACzC,CAAC,MAAM;MACLR,iBAAiB,GAAG,0DAA0D;IAChF;EACF,CAAC,CAAC,OAAOW,KAAK,EAAE;IACdX,iBAAiB,GAAGW,KAAK,YAAYC,KAAK,GAAGD,KAAK,CAACE,OAAO,GAAGC,MAAM,CAACH,KAAK,CAAC;EAC5E;EAEA,OAAOb,aAAa;AACtB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASiB,sBAAsBA,CAAA,EAAS;EAC7C,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIjB,SAAS,EAAE;EACxDA,SAAS,GAAG,IAAI;EAChB;EACA;EACA;EACAkB,OAAO,CAACC,IAAI,CACV,6DAA6D,GAC3D,+EAA+E,GAC/E,8EAA8E,GAC9E,6EAA6E,GAC7E,oDAAoDpB,iBAAiB,EACzE,CAAC;AACH","ignoreList":[]}

package/lib/module/theme/adaptive-colors.js

@@ -38,9 +38,30 @@ import { Platform } from 'react-native';
  */
 
 const c = v => v;
+let hasWarned = false;
+
+/**
+ * SAY SO. This boundary degraded in complete silence, which is the worst of the
+ * six: an app simply gets the preset palette instead of the platform's, and
+ * nothing anywhere says the platform read failed.
+ *
+ * It is only reachable on Android and iOS — `getAdaptiveColors` returns `null`
+ * on web before touching `require` — so an ESM bundle never gets here. That is
+ * an argument for warning, not against it: a failure that cannot happen in the
+ * environment you test in is exactly the one that goes unnoticed when it does.
+ */
+function warnAdaptiveColorsUnavailable(reason) {
+  if (process.env.NODE_ENV === 'production' || hasWarned) return;
+  hasWarned = true;
+  // eslint-disable-next-line no-console
+  console.warn('[Bloom] The adaptive palette fell back to the preset one: `expo-router`’s ' + '`Color` proxy could not be read, so platform colours (Material You, iOS ' + 'dynamic) are not in use. Install the optional peer ' + '(`npx expo install expo-router`) if you want them. ' + `Reason: ${reason}`);
+}
 function getAndroidColors() {
   try {
-    if (typeof require === 'undefined') return null;
+    if (typeof require === 'undefined') {
+      warnAdaptiveColorsUnavailable('this bundle has no CommonJS `require`');
+      return null;
+    }
     const {
       Color
     } = require('expo-router');
@@ -80,13 +101,17 @@ function getAndroidColors() {
       shadow: 'rgba(0, 0, 0, 0.2)',
       overlay: 'rgba(0, 0, 0, 0.5)'
     };
-  } catch {
+  } catch (error) {
+    warnAdaptiveColorsUnavailable(error instanceof Error ? error.message : String(error));
     return null;
   }
 }
 function getIOSColors() {
   try {
-    if (typeof require === 'undefined') return null;
+    if (typeof require === 'undefined') {
+      warnAdaptiveColorsUnavailable('this bundle has no CommonJS `require`');
+      return null;
+    }
     const {
       Color
     } = require('expo-router');
@@ -126,7 +151,8 @@ function getIOSColors() {
       shadow: 'rgba(0, 0, 0, 0.15)',
       overlay: 'rgba(0, 0, 0, 0.5)'
     };
-  } catch {
+  } catch (error) {
+    warnAdaptiveColorsUnavailable(error instanceof Error ? error.message : String(error));
     return null;
   }
 }

package/lib/module/theme/adaptive-colors.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","c","v","getAndroidColors","require","Color","d","android","dynamic","background","surface","backgroundSecondary","surfaceContainerLow","backgroundTertiary","surfaceContainer","text","onSurface","textSecondary","onSurfaceVariant","textTertiary","outline","border","outlineVariant","borderLight","primary","primaryForeground","onPrimary","primaryLight","primaryContainer","primaryDark","onPrimaryContainer","secondary","secondaryForeground","onSecondary","tertiary","tertiaryForeground","onTertiary","tint","icon","iconActive","success","error","warning","info","primarySubtle","primarySubtleForeground","negative","negativeForeground","negativeSubtle","errorContainer","negativeSubtleForeground","onErrorContainer","contrast50","card","shadow","overlay","getIOSColors","i","ios","systemBackground","secondarySystemBackground","tertiarySystemBackground","label","secondaryLabel","tertiaryLabel","separator","opaqueSeparator","systemBlue","systemGray6","systemPurple","systemTeal","systemGreen","systemRed","systemOrange","getAdaptiveColors","OS"],"sourceRoot":"../../../src","sources":["theme/adaptive-colors.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Platform","c","v","hasWarned","warnAdaptiveColorsUnavailable","reason","process","env","NODE_ENV","console","warn","getAndroidColors","require","Color","d","android","dynamic","background","surface","backgroundSecondary","surfaceContainerLow","backgroundTertiary","surfaceContainer","text","onSurface","textSecondary","onSurfaceVariant","textTertiary","outline","border","outlineVariant","borderLight","primary","primaryForeground","onPrimary","primaryLight","primaryContainer","primaryDark","onPrimaryContainer","secondary","secondaryForeground","onSecondary","tertiary","tertiaryForeground","onTertiary","tint","icon","iconActive","success","error","warning","info","primarySubtle","primarySubtleForeground","negative","negativeForeground","negativeSubtle","errorContainer","negativeSubtleForeground","onErrorContainer","contrast50","card","shadow","overlay","Error","message","String","getIOSColors","i","ios","systemBackground","secondarySystemBackground","tertiarySystemBackground","label","secondaryLabel","tertiaryLabel","separator","opaqueSeparator","systemBlue","systemGray6","systemPurple","systemTeal","systemGreen","systemRed","systemOrange","getAdaptiveColors","OS"],"sourceRoot":"../../../src","sources":["theme/adaptive-colors.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/connection-status/index.d.ts

@@ -1,3 +1,4 @@
 export type { ConnectionStatusToastsProps } from './shared';
+export { provideNetInfo, type NetInfoLike } from './netinfo';
 export { ConnectionStatusToasts, } from './ConnectionStatusToasts';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/connection-status/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

package/lib/typescript/commonjs/connection-status/index.web.d.ts

@@ -1,3 +1,4 @@
 export type { ConnectionStatusToastsProps } from './shared';
+export { provideNetInfo, type NetInfoLike } from './netinfo';
 export { ConnectionStatusToasts, } from './ConnectionStatusToasts.web';
 //# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/commonjs/connection-status/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.web.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,sBAAsB,GACvB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.web.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,sBAAsB,GACvB,MAAM,8BAA8B,CAAC"}

package/lib/typescript/commonjs/connection-status/netinfo.d.ts

@@ -57,6 +57,31 @@ export interface NetInfoStateLike {
 export interface NetInfoLike {
     addEventListener: (listener: (state: NetInfoStateLike) => void) => () => void;
 }
+/**
+ * Hand Bloom the netinfo module, from a consumer that has it.
+ *
+ * THIS IS NOT A TEST HOOK. It is the only mechanism that works in an ESM
+ * bundle: the consumer, who knows it has the peer and which entry of it its own
+ * bundler resolved, hands the module in.
+ *
+ * The `require` below cannot be relied on off Metro, and the reason is worth
+ * knowing because the symptom is identical while the cause is not:
+ *
+ *   - Rollup / Vite ESM output: `require` is undefined, the guard catches it,
+ *     and the boundary degrades.
+ *   - esbuild ESM output: `require` EXISTS as a shim that throws
+ *     (`Dynamic require of "…" is not supported`), so the guard PASSES and the
+ *     call throws inside the try. Measured with the peer installed on disk:
+ *     `platform=node` and `platform=browser` both degraded.
+ *
+ * So a fix aimed at the `typeof require` check would have changed nothing under
+ * esbuild. And there is no synchronous, bundler-agnostic alternative: `import()`
+ * is asynchronous AND resolved at build time, so an absent package fails the
+ * BUILD — which is what this boundary exists to prevent.
+ *
+ * Metro is unaffected either way and needs no binding.
+ */
+export declare function provideNetInfo(module: NetInfoLike | null): void;
 /** The netinfo module, or `null` when the optional peer is not installed. */
 export declare function loadNetInfo(): NetInfoLike | null;
 /**

package/lib/typescript/commonjs/connection-status/netinfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"netinfo.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/netinfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AASH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAQD,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAiChD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAa7C"}
+{"version":3,"file":"netinfo.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/netinfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AASH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAI/D;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAkChD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAa7C"}

package/lib/typescript/commonjs/theme/adaptive-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-colors.d.ts","sourceRoot":"","sources":["../../../../src/theme/adaptive-colors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,WAAW,EACT,eAAe,GACf,yBAAyB,GACzB,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,yBAAyB,GACzB,YAAY,GACZ,sBAAsB,CACzB,CAAC;AA8FF,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAIzD"}
+{"version":3,"file":"adaptive-colors.d.ts","sourceRoot":"","sources":["../../../../src/theme/adaptive-colors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,WAAW,EACT,eAAe,GACf,yBAAyB,GACzB,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,yBAAyB,GACzB,YAAY,GACZ,sBAAsB,CACzB,CAAC;AA+HF,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAIzD"}

package/lib/typescript/module/connection-status/index.d.ts

@@ -1,3 +1,4 @@
 export type { ConnectionStatusToastsProps } from './shared';
+export { provideNetInfo, type NetInfoLike } from './netinfo';
 export { ConnectionStatusToasts, } from './ConnectionStatusToasts';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/connection-status/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}

package/lib/typescript/module/connection-status/index.web.d.ts

@@ -1,3 +1,4 @@
 export type { ConnectionStatusToastsProps } from './shared';
+export { provideNetInfo, type NetInfoLike } from './netinfo';
 export { ConnectionStatusToasts, } from './ConnectionStatusToasts.web';
 //# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/module/connection-status/index.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.web.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,sBAAsB,GACvB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/index.web.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,sBAAsB,GACvB,MAAM,8BAA8B,CAAC"}

package/lib/typescript/module/connection-status/netinfo.d.ts

@@ -57,6 +57,31 @@ export interface NetInfoStateLike {
 export interface NetInfoLike {
     addEventListener: (listener: (state: NetInfoStateLike) => void) => () => void;
 }
+/**
+ * Hand Bloom the netinfo module, from a consumer that has it.
+ *
+ * THIS IS NOT A TEST HOOK. It is the only mechanism that works in an ESM
+ * bundle: the consumer, who knows it has the peer and which entry of it its own
+ * bundler resolved, hands the module in.
+ *
+ * The `require` below cannot be relied on off Metro, and the reason is worth
+ * knowing because the symptom is identical while the cause is not:
+ *
+ *   - Rollup / Vite ESM output: `require` is undefined, the guard catches it,
+ *     and the boundary degrades.
+ *   - esbuild ESM output: `require` EXISTS as a shim that throws
+ *     (`Dynamic require of "…" is not supported`), so the guard PASSES and the
+ *     call throws inside the try. Measured with the peer installed on disk:
+ *     `platform=node` and `platform=browser` both degraded.
+ *
+ * So a fix aimed at the `typeof require` check would have changed nothing under
+ * esbuild. And there is no synchronous, bundler-agnostic alternative: `import()`
+ * is asynchronous AND resolved at build time, so an absent package fails the
+ * BUILD — which is what this boundary exists to prevent.
+ *
+ * Metro is unaffected either way and needs no binding.
+ */
+export declare function provideNetInfo(module: NetInfoLike | null): void;
 /** The netinfo module, or `null` when the optional peer is not installed. */
 export declare function loadNetInfo(): NetInfoLike | null;
 /**

package/lib/typescript/module/connection-status/netinfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"netinfo.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/netinfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AASH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAQD,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAiChD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAa7C"}
+{"version":3,"file":"netinfo.d.ts","sourceRoot":"","sources":["../../../../src/connection-status/netinfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AASH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CAC/E;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAI/D;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAkChD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAa7C"}

package/lib/typescript/module/theme/adaptive-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-colors.d.ts","sourceRoot":"","sources":["../../../../src/theme/adaptive-colors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,WAAW,EACT,eAAe,GACf,yBAAyB,GACzB,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,yBAAyB,GACzB,YAAY,GACZ,sBAAsB,CACzB,CAAC;AA8FF,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAIzD"}
+{"version":3,"file":"adaptive-colors.d.ts","sourceRoot":"","sources":["../../../../src/theme/adaptive-colors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,WAAW,EACT,eAAe,GACf,yBAAyB,GACzB,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,yBAAyB,GACzB,YAAY,GACZ,sBAAsB,CACzB,CAAC;AA+HF,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAIzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "1.8.0",
+  "version": "1.9.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/connection-status/index.ts

@@ -1,4 +1,7 @@
 export type { ConnectionStatusToastsProps } from './shared';
+// The hatch a consumer needs off Metro, where the optional `require` does not
+// deliver the peer even when it is installed. See `netinfo.ts`.
+export { provideNetInfo, type NetInfoLike } from './netinfo';
 export {
   ConnectionStatusToasts,
 } from './ConnectionStatusToasts';

package/src/connection-status/index.web.ts

@@ -1,4 +1,7 @@
 export type { ConnectionStatusToastsProps } from './shared';
+// The hatch a consumer needs off Metro, where the optional `require` does not
+// deliver the peer even when it is installed. See `netinfo.ts`.
+export { provideNetInfo, type NetInfoLike } from './netinfo';
 export {
   ConnectionStatusToasts,
 } from './ConnectionStatusToasts.web';

package/src/connection-status/netinfo.ts

@@ -69,12 +69,45 @@ export interface NetInfoLike {
 
 /** `undefined` until the first load attempt, then the module or `null`. */
 let netInfoModule: NetInfoLike | null | undefined;
+/** Handed in by a consumer, which is the only thing that works in an ESM bundle. */
+let providedModule: NetInfoLike | null = null;
 /** Why the load failed, quoted verbatim in the dev warning. */
 let unavailableReason = '';
 let hasWarned = false;
 
+/**
+ * Hand Bloom the netinfo module, from a consumer that has it.
+ *
+ * THIS IS NOT A TEST HOOK. It is the only mechanism that works in an ESM
+ * bundle: the consumer, who knows it has the peer and which entry of it its own
+ * bundler resolved, hands the module in.
+ *
+ * The `require` below cannot be relied on off Metro, and the reason is worth
+ * knowing because the symptom is identical while the cause is not:
+ *
+ *   - Rollup / Vite ESM output: `require` is undefined, the guard catches it,
+ *     and the boundary degrades.
+ *   - esbuild ESM output: `require` EXISTS as a shim that throws
+ *     (`Dynamic require of "…" is not supported`), so the guard PASSES and the
+ *     call throws inside the try. Measured with the peer installed on disk:
+ *     `platform=node` and `platform=browser` both degraded.
+ *
+ * So a fix aimed at the `typeof require` check would have changed nothing under
+ * esbuild. And there is no synchronous, bundler-agnostic alternative: `import()`
+ * is asynchronous AND resolved at build time, so an absent package fails the
+ * BUILD — which is what this boundary exists to prevent.
+ *
+ * Metro is unaffected either way and needs no binding.
+ */
+export function provideNetInfo(module: NetInfoLike | null): void {
+  providedModule = module;
+  netInfoModule = undefined;
+  hasWarned = false;
+}
+
 /** The netinfo module, or `null` when the optional peer is not installed. */
 export function loadNetInfo(): NetInfoLike | null {
+  if (providedModule !== null) return providedModule;
   if (netInfoModule !== undefined) return netInfoModule;
   netInfoModule = null;
 

package/src/theme/adaptive-colors.ts

@@ -49,9 +49,37 @@ export type AdaptiveColors = Omit<
 
 const c = (v: unknown): string => v as string;
 
+let hasWarned = false;
+
+/**
+ * SAY SO. This boundary degraded in complete silence, which is the worst of the
+ * six: an app simply gets the preset palette instead of the platform's, and
+ * nothing anywhere says the platform read failed.
+ *
+ * It is only reachable on Android and iOS — `getAdaptiveColors` returns `null`
+ * on web before touching `require` — so an ESM bundle never gets here. That is
+ * an argument for warning, not against it: a failure that cannot happen in the
+ * environment you test in is exactly the one that goes unnoticed when it does.
+ */
+function warnAdaptiveColorsUnavailable(reason: string): void {
+  if (process.env.NODE_ENV === 'production' || hasWarned) return;
+  hasWarned = true;
+  // eslint-disable-next-line no-console
+  console.warn(
+    '[Bloom] The adaptive palette fell back to the preset one: `expo-router`’s ' +
+      '`Color` proxy could not be read, so platform colours (Material You, iOS ' +
+      'dynamic) are not in use. Install the optional peer ' +
+      '(`npx expo install expo-router`) if you want them. ' +
+      `Reason: ${reason}`,
+  );
+}
+
 function getAndroidColors(): AdaptiveColors | null {
   try {
-    if (typeof require === 'undefined') return null;
+    if (typeof require === 'undefined') {
+      warnAdaptiveColorsUnavailable('this bundle has no CommonJS `require`');
+      return null;
+    }
     const { Color } = require('expo-router');
     const d = Color.android.dynamic;
     return {
@@ -89,14 +117,18 @@ function getAndroidColors(): AdaptiveColors | null {
       shadow: 'rgba(0, 0, 0, 0.2)',
       overlay: 'rgba(0, 0, 0, 0.5)',
     };
-  } catch {
+  } catch (error) {
+    warnAdaptiveColorsUnavailable(error instanceof Error ? error.message : String(error));
     return null;
   }
 }
 
 function getIOSColors(): AdaptiveColors | null {
   try {
-    if (typeof require === 'undefined') return null;
+    if (typeof require === 'undefined') {
+      warnAdaptiveColorsUnavailable('this bundle has no CommonJS `require`');
+      return null;
+    }
     const { Color } = require('expo-router');
     const i = Color.ios;
     return {
@@ -134,7 +166,8 @@ function getIOSColors(): AdaptiveColors | null {
       shadow: 'rgba(0, 0, 0, 0.15)',
       overlay: 'rgba(0, 0, 0, 0.5)',
     };
-  } catch {
+  } catch (error) {
+    warnAdaptiveColorsUnavailable(error instanceof Error ? error.message : String(error));
     return null;
   }
 }