@oxyhq/bloom 0.67.0 → 0.69.0

package/src/toast/use-single-outlet-guard.ts

@@ -0,0 +1,72 @@
+/**
+ * Bloom-original — the dev-only guard against a SECOND toast outlet.
+ *
+ * Every `Toaster` subscribes to the ONE module-level `toastStore`, which has no
+ * notion of an owning outlet, so N mounted outlets each render the full row set:
+ * a toast appears N times. Nothing in the engine can dedupe that — the outlets
+ * are legitimate, independent subscribers — so the contract is "mount exactly
+ * one" and this is what enforces it.
+ *
+ * WHY A WARNING IS WORTH ITS WEIGHT: the copies are not visually separated, so
+ * the defect does not look like duplication. Two bare outlets take identical
+ * defaults and land pixel-identical; two outlets whose `offset` differs by a
+ * point land 1px apart. Only counting the rendered rows reveals it, which is not
+ * something anyone thinks to do — the reports this guard comes from all read as
+ * "the toast looks wrong", never as "there are two of them". Stacking is on by
+ * default, so a duplicate outlet now doubles the rows INSIDE a stack.
+ *
+ * The counter is decremented on unmount, so a remount, a route change that moves
+ * the outlet, Fast Refresh and React's StrictMode double-invoke (setup, cleanup,
+ * setup) all pass through a count of 1 and stay silent. The latch keeps the
+ * warning to exactly one per module lifetime rather than one per extra outlet,
+ * and — because StrictMode replays the setups — one per app, not two.
+ *
+ * Gated on `process.env.NODE_ENV`, the same mechanism as
+ * `content-panel/nesting-context.ts`: Metro and Vite/Rolldown both fold it
+ * statically, so production keeps the counter, the branch and the message out of
+ * the bundle entirely. Deliberately NOT `__DEV__`, which is a Metro global that a
+ * plain web bundler does not define. It only ever warns — a duplicate outlet
+ * renders a redundant toast, it does not break the app, so it must never throw.
+ */
+import * as React from 'react';
+
+let mountedOutlets = 0;
+let hasWarned = false;
+
+export function useSingleOutletGuard(): void {
+  React.useEffect(() => {
+    if (process.env.NODE_ENV === 'production') {
+      return;
+    }
+
+    mountedOutlets += 1;
+    if (mountedOutlets > 1 && !hasWarned) {
+      hasWarned = true;
+      // Internal Bloom diagnostic: the consumer's tree is the only place this
+      // can be fixed, so it names the usual cause rather than just the symptom.
+      // eslint-disable-next-line no-console
+      console.warn(
+        `[Bloom] Toaster: ${mountedOutlets} toast outlets are mounted, so every ` +
+          'toast renders once per outlet. The copies overlap almost exactly, so ' +
+          'this reads as a rendering glitch rather than as duplicate rows. Mount ' +
+          "exactly one: @oxyhq/services' OxyProvider already renders a " +
+          'ToastOutlet, so an app that uses it must not render its own.',
+      );
+    }
+
+    return () => {
+      mountedOutlets -= 1;
+    };
+  }, []);
+}
+
+/**
+ * Test-only reset: both the counter and the one-shot latch are module state that
+ * outlives a render tree, so without this the first suite to mount two outlets
+ * would latch the warning and leave every later suite asserting against a guard
+ * that can no longer fire — passing whatever the implementation did.
+ */
+export function resetSingleOutletGuardForTests(): void {
+  mountedOutlets = 0;
+  hasWarned = false;
+}

package/lib/commonjs/avatar/svg-module.js

@@ -1,15 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getSvgModule = void 0;
-var _lazyRequire = require("../utils/lazy-require.js");
-/**
- * Lazily loads `react-native-svg`, returning `null` when it is not installed
- * (e.g. a web bundle that does not ship the optional peer). Shared by the
- * squircle avatar image clip in `Avatar.tsx` and the `AvatarRing` so there is a
- * single loader rather than one per call site.
- */
-const getSvgModule = exports.getSvgModule = (0, _lazyRequire.lazyRequire)('react-native-svg');
-//# sourceMappingURL=svg-module.js.map

package/lib/commonjs/avatar/svg-module.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_lazyRequire","require","getSvgModule","exports","lazyRequire"],"sourceRoot":"../../../src","sources":["avatar/svg-module.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAIA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG,IAAAE,wBAAW,EAAgB,kBAAkB,CAAC","ignoreList":[]}

package/lib/commonjs/utils/lazy-require.js

@@ -1,37 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.lazyRequire = lazyRequire;
-/**
- * Creates a lazy-loaded module getter that caches the result.
- *
- * Safely handles environments where `require` is not defined (e.g. Vite/browser ESM)
- * and returns `null` when the module is not installed. The result is cached after the
- * first call so subsequent calls are zero-cost.
- *
- * @example
- * ```ts
- * const getSvg = lazyRequire<typeof import('react-native-svg')>('react-native-svg');
- * const svg = getSvg(); // SvgModuleType | null
- * ```
- */
-function lazyRequire(moduleName) {
-  let module = null;
-  let resolved = false;
-  return () => {
-    if (!resolved) {
-      resolved = true;
-      try {
-        if (typeof require !== 'undefined') {
-          module = require(moduleName);
-        }
-      } catch {
-        module = null;
-      }
-    }
-    return module;
-  };
-}
-//# sourceMappingURL=lazy-require.js.map

package/lib/commonjs/utils/lazy-require.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["lazyRequire","moduleName","module","resolved","require"],"sourceRoot":"../../../src","sources":["utils/lazy-require.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,WAAWA,CAAIC,UAAkB,EAAkB;EACjE,IAAIC,MAAgB,GAAG,IAAI;EAC3B,IAAIC,QAAQ,GAAG,KAAK;EAEpB,OAAO,MAAgB;IACrB,IAAI,CAACA,QAAQ,EAAE;MACbA,QAAQ,GAAG,IAAI;MACf,IAAI;QACF,IAAI,OAAOC,OAAO,KAAK,WAAW,EAAE;UAClCF,MAAM,GAAGE,OAAO,CAACH,UAAU,CAAC;QAC9B;MACF,CAAC,CAAC,MAAM;QACNC,MAAM,GAAG,IAAI;MACf;IACF;IACA,OAAOA,MAAM;EACf,CAAC;AACH","ignoreList":[]}

package/lib/module/avatar/svg-module.js

@@ -1,11 +0,0 @@
-"use strict";
-
-import { lazyRequire } from "../utils/lazy-require.js";
-/**
- * Lazily loads `react-native-svg`, returning `null` when it is not installed
- * (e.g. a web bundle that does not ship the optional peer). Shared by the
- * squircle avatar image clip in `Avatar.tsx` and the `AvatarRing` so there is a
- * single loader rather than one per call site.
- */
-export const getSvgModule = lazyRequire('react-native-svg');
-//# sourceMappingURL=svg-module.js.map

package/lib/module/avatar/svg-module.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["lazyRequire","getSvgModule"],"sourceRoot":"../../../src","sources":["avatar/svg-module.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,0BAAuB;AAInD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,GAAGD,WAAW,CAAgB,kBAAkB,CAAC","ignoreList":[]}

package/lib/module/utils/lazy-require.js

@@ -1,33 +0,0 @@
-"use strict";
-
-/**
- * Creates a lazy-loaded module getter that caches the result.
- *
- * Safely handles environments where `require` is not defined (e.g. Vite/browser ESM)
- * and returns `null` when the module is not installed. The result is cached after the
- * first call so subsequent calls are zero-cost.
- *
- * @example
- * ```ts
- * const getSvg = lazyRequire<typeof import('react-native-svg')>('react-native-svg');
- * const svg = getSvg(); // SvgModuleType | null
- * ```
- */
-export function lazyRequire(moduleName) {
-  let module = null;
-  let resolved = false;
-  return () => {
-    if (!resolved) {
-      resolved = true;
-      try {
-        if (typeof require !== 'undefined') {
-          module = require(moduleName);
-        }
-      } catch {
-        module = null;
-      }
-    }
-    return module;
-  };
-}
-//# sourceMappingURL=lazy-require.js.map

package/lib/module/utils/lazy-require.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["lazyRequire","moduleName","module","resolved","require"],"sourceRoot":"../../../src","sources":["utils/lazy-require.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,WAAWA,CAAIC,UAAkB,EAAkB;EACjE,IAAIC,MAAgB,GAAG,IAAI;EAC3B,IAAIC,QAAQ,GAAG,KAAK;EAEpB,OAAO,MAAgB;IACrB,IAAI,CAACA,QAAQ,EAAE;MACbA,QAAQ,GAAG,IAAI;MACf,IAAI;QACF,IAAI,OAAOC,OAAO,KAAK,WAAW,EAAE;UAClCF,MAAM,GAAGE,OAAO,CAACH,UAAU,CAAC;QAC9B;MACF,CAAC,CAAC,MAAM;QACNC,MAAM,GAAG,IAAI;MACf;IACF;IACA,OAAOA,MAAM;EACf,CAAC;AACH","ignoreList":[]}

package/lib/typescript/commonjs/avatar/svg-module.d.ts

@@ -1,8 +0,0 @@
-/**
- * Lazily loads `react-native-svg`, returning `null` when it is not installed
- * (e.g. a web bundle that does not ship the optional peer). Shared by the
- * squircle avatar image clip in `Avatar.tsx` and the `AvatarRing` so there is a
- * single loader rather than one per call site.
- */
-export declare const getSvgModule: () => typeof import("react-native-svg") | null;
-//# sourceMappingURL=svg-module.d.ts.map

package/lib/typescript/commonjs/avatar/svg-module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"svg-module.d.ts","sourceRoot":"","sources":["../../../../src/avatar/svg-module.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,gDAAiD,CAAC"}

package/lib/typescript/commonjs/utils/lazy-require.d.ts

@@ -1,15 +0,0 @@
-/**
- * Creates a lazy-loaded module getter that caches the result.
- *
- * Safely handles environments where `require` is not defined (e.g. Vite/browser ESM)
- * and returns `null` when the module is not installed. The result is cached after the
- * first call so subsequent calls are zero-cost.
- *
- * @example
- * ```ts
- * const getSvg = lazyRequire<typeof import('react-native-svg')>('react-native-svg');
- * const svg = getSvg(); // SvgModuleType | null
- * ```
- */
-export declare function lazyRequire<T>(moduleName: string): () => T | null;
-//# sourceMappingURL=lazy-require.d.ts.map

package/lib/typescript/commonjs/utils/lazy-require.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy-require.d.ts","sourceRoot":"","sources":["../../../../src/utils/lazy-require.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAiBjE"}

package/lib/typescript/module/avatar/svg-module.d.ts

@@ -1,8 +0,0 @@
-/**
- * Lazily loads `react-native-svg`, returning `null` when it is not installed
- * (e.g. a web bundle that does not ship the optional peer). Shared by the
- * squircle avatar image clip in `Avatar.tsx` and the `AvatarRing` so there is a
- * single loader rather than one per call site.
- */
-export declare const getSvgModule: () => typeof import("react-native-svg") | null;
-//# sourceMappingURL=svg-module.d.ts.map

package/lib/typescript/module/avatar/svg-module.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"svg-module.d.ts","sourceRoot":"","sources":["../../../../src/avatar/svg-module.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,gDAAiD,CAAC"}

package/lib/typescript/module/utils/lazy-require.d.ts

@@ -1,15 +0,0 @@
-/**
- * Creates a lazy-loaded module getter that caches the result.
- *
- * Safely handles environments where `require` is not defined (e.g. Vite/browser ESM)
- * and returns `null` when the module is not installed. The result is cached after the
- * first call so subsequent calls are zero-cost.
- *
- * @example
- * ```ts
- * const getSvg = lazyRequire<typeof import('react-native-svg')>('react-native-svg');
- * const svg = getSvg(); // SvgModuleType | null
- * ```
- */
-export declare function lazyRequire<T>(moduleName: string): () => T | null;
-//# sourceMappingURL=lazy-require.d.ts.map

package/lib/typescript/module/utils/lazy-require.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lazy-require.d.ts","sourceRoot":"","sources":["../../../../src/utils/lazy-require.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI,CAiBjE"}

package/src/avatar/svg-module.ts

@@ -1,11 +0,0 @@
-import { lazyRequire } from '../utils/lazy-require';
-
-type SvgModuleType = typeof import('react-native-svg');
-
-/**
- * Lazily loads `react-native-svg`, returning `null` when it is not installed
- * (e.g. a web bundle that does not ship the optional peer). Shared by the
- * squircle avatar image clip in `Avatar.tsx` and the `AvatarRing` so there is a
- * single loader rather than one per call site.
- */
-export const getSvgModule = lazyRequire<SvgModuleType>('react-native-svg');

package/src/utils/lazy-require.ts

@@ -1,31 +0,0 @@
-/**
- * Creates a lazy-loaded module getter that caches the result.
- *
- * Safely handles environments where `require` is not defined (e.g. Vite/browser ESM)
- * and returns `null` when the module is not installed. The result is cached after the
- * first call so subsequent calls are zero-cost.
- *
- * @example
- * ```ts
- * const getSvg = lazyRequire<typeof import('react-native-svg')>('react-native-svg');
- * const svg = getSvg(); // SvgModuleType | null
- * ```
- */
-export function lazyRequire<T>(moduleName: string): () => T | null {
-  let module: T | null = null;
-  let resolved = false;
-
-  return (): T | null => {
-    if (!resolved) {
-      resolved = true;
-      try {
-        if (typeof require !== 'undefined') {
-          module = require(moduleName);
-        }
-      } catch {
-        module = null;
-      }
-    }
-    return module;
-  };
-}