@oxyhq/services 23.0.2 → 23.0.3

package/lib/module/ui/hooks/useSurfaceHeader.js

@@ -0,0 +1,138 @@
+"use strict";
+
+import { createContext, useContext, useLayoutEffect, useRef } from 'react';
+
+/**
+ * The header content a mounted surface screen contributes at runtime: its
+ * (translated) title/subtitle and optional slot nodes. Back/close affordances
+ * are owned by the surface host (`SurfaceScreen`) — a screen never wires them.
+ *
+ * Alongside the classic slots (`left`/`right`) a screen can declare the rich
+ * design-system fields Bloom's nav header supports: the single trailing
+ * `primaryAction` CTA (Upload / Save), a trailing icon `actions` row, a header
+ * `search` / `segments` in the large-title zone, an `onImage` `tone` over media,
+ * and a wizard `progress` bar.
+ *
+ * Only the NODE fields (`left`/`right`/`titleContent`, and an action's `icon`)
+ * must be referentially stable — a node can only be compared by identity, so an
+ * inline one thrashes the header. The rich OBJECT fields are compared by value
+ * (see {@link surfaceHeaderContentEqual}), so an inline `primaryAction` /
+ * `actions` / `search` / `segments` / `progress` is safe to pass.
+ */
+
+/**
+ * Provided by {@link ../components/SurfaceScreen}. Bridges a screen's runtime
+ * header contribution up to the host, which merges it with the back/close
+ * wiring and drives the Dialog's own nav header. `null` outside a surface (or in
+ * a headerless surface), so {@link useSurfaceHeader} is a safe no-op there.
+ */
+export const SurfaceHeaderContext = /*#__PURE__*/createContext(null);
+function primaryActionEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  // `onPress` is a fresh closure each render — its identity never changes what
+  // the button renders, so compare only the render-affecting scalars.
+  return a.label === b.label && !!a.disabled === !!b.disabled && !!a.loading === !!b.loading;
+}
+function actionsEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b || a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i += 1) {
+    const x = a[i];
+    const y = b[i];
+    if (!x || !y) return false;
+    // `icon` is a node (identity); `onPress` is ignored, like `primaryAction`'s.
+    if (x.accessibilityLabel !== y.accessibilityLabel || !!x.disabled !== !!y.disabled || x.icon !== y.icon) {
+      return false;
+    }
+  }
+  return true;
+}
+function searchEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.value === b.value && a.placeholder === b.placeholder;
+}
+function segmentsEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b || a.value !== b.value || a.items.length !== b.items.length) return false;
+  for (let i = 0; i < a.items.length; i += 1) {
+    const x = a.items[i];
+    const y = b.items[i];
+    if (!x || !y || x.key !== y.key || x.label !== y.label) return false;
+  }
+  return true;
+}
+function progressEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.step === b.step && a.total === b.total;
+}
+
+/**
+ * Value-equality for a surface's header contribution.
+ *
+ * This MIRRORS Bloom's own `configsEqual` (`@oxyhq/bloom/dialog`), which guards
+ * the header store one layer down — deliberately field for field. The two must
+ * not diverge: this comparator is the gate that decides whether the host's
+ * `setContent` fires, so a comparator STRICTER than Bloom's re-introduces the
+ * update loop Bloom's own guard was written to prevent.
+ *
+ * Scalars (`title`/`subtitle`/`largeTitle`/`tone`) compare by value. The rich
+ * object fields (`primaryAction`/`actions`/`search`/`segments`/`progress`)
+ * compare by their render-affecting scalars, so a screen may build them inline:
+ * a fresh object with unchanged contents is NOT a change. Only the node fields
+ * (`titleContent`/`left`/`right`, and an action's `icon`) compare by identity —
+ * there is nothing else to compare a `ReactNode` by — so those, and only those,
+ * carry the memoize-me contract.
+ *
+ * Function-typed affordances compare by PRESENCE, never identity: `onBack`
+ * legitimately gets a fresh closure each render and its identity never changes
+ * what the header renders, so it must not count as a change (that is exactly
+ * what would drive the update loop).
+ */
+function surfaceHeaderContentEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.title === b.title && a.titleContent === b.titleContent && a.subtitle === b.subtitle && a.largeTitle === b.largeTitle && a.left === b.left && a.right === b.right && !!a.onBack === !!b.onBack && a.tone === b.tone && primaryActionEqual(a.primaryAction, b.primaryAction) && actionsEqual(a.actions, b.actions) && searchEqual(a.search, b.search) && segmentsEqual(a.segments, b.segments) && progressEqual(a.progress, b.progress);
+}
+
+/**
+ * Declare the Dialog nav header's content from within a surface screen — its
+ * title/subtitle and any action slot. Merges over nothing (the host owns
+ * back/close), replaces on change, and clears on unmount. Call it unconditionally;
+ * it is a no-op outside a header-mode surface.
+ *
+ * Screens pass an INLINE `content` object (a fresh reference every render), so the
+ * push is guarded by {@link surfaceHeaderContentEqual}: the host's `setContent` is
+ * called only when the VALUE actually changes. Without that guard the setState
+ * would fire every render → the screen re-renders → the effect runs again → an
+ * infinite update loop (React error #185) in any consumer that does not memoize
+ * the object for us (i.e. anything not compiled by the React Compiler).
+ */
+export function useSurfaceHeader(content) {
+  const ctx = useContext(SurfaceHeaderContext);
+  const set = ctx?.setContent;
+  const setRef = useRef(set);
+  setRef.current = set;
+  // The last value pushed to the host; `undefined` until the first push.
+  const lastRef = useRef(undefined);
+
+  // Runs after EVERY commit (no deps array) so the bar/title fill in the same
+  // layout phase — but only pushes on a real value change, never on reference churn.
+  useLayoutEffect(() => {
+    const s = setRef.current;
+    if (!s) return;
+    const next = content ?? null;
+    if (lastRef.current !== undefined && surfaceHeaderContentEqual(lastRef.current, next)) return;
+    lastRef.current = next;
+    s(next);
+  });
+
+  // Clear this surface's contribution when the screen unmounts.
+  useLayoutEffect(() => () => {
+    lastRef.current = undefined;
+    setRef.current?.(null);
+  }, []);
+}
+//# sourceMappingURL=useSurfaceHeader.js.map

package/lib/module/ui/hooks/useSurfaceHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","useLayoutEffect","useRef","SurfaceHeaderContext","primaryActionEqual","a","b","label","disabled","loading","actionsEqual","length","i","x","y","accessibilityLabel","icon","searchEqual","value","placeholder","segmentsEqual","items","key","progressEqual","step","total","surfaceHeaderContentEqual","title","titleContent","subtitle","largeTitle","left","right","onBack","tone","primaryAction","actions","search","segments","progress","useSurfaceHeader","content","ctx","set","setContent","setRef","current","lastRef","undefined","s","next"],"sourceRoot":"../../../../src","sources":["ui/hooks/useSurfaceHeader.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/hooks/useSwitchableAccounts.js

@@ -0,0 +1,60 @@
+"use strict";
+
+import { useCallback, useMemo, useSyncExternalStore } from 'react';
+import { useOxy } from "../context/OxyContext.js";
+/**
+ * Stable empty snapshot for the no-provider loading state, so `useSyncExternalStore`
+ * always has a getSnapshot that returns a constant reference before mount.
+ */
+const EMPTY_SNAPSHOT = {
+  view: 'accounts',
+  accounts: [],
+  activeAccountId: null,
+  loading: false,
+  error: null,
+  switchingAccountId: null,
+  signIn: {
+    phase: 'idle',
+    authorizeCode: null,
+    qrPayload: null,
+    expiresAt: null,
+    error: null,
+    route: null,
+    routeFailed: false,
+    pushSentAt: null,
+    openedAt: null,
+    progress: 'idle'
+  },
+  commonsAvailability: 'unknown'
+};
+
+/**
+ * Every account the signed-in user can switch into — device sign-ins AND linked
+ * graph accounts (owned orgs + shared-with-you) — as one flat, deduped list with
+ * real per-account name / email / avatar / color.
+ *
+ * This is a thin binding over the shared `AccountDialogController` in
+ * `@oxyhq/core` (the SAME headless source the {@link OxyAccountDialogScreen} renders),
+ * so there is ONE projection (`projectSwitchableAccounts`) and one switch path
+ * (`controller.switchTo`) across the whole SDK — the local duplicate projection
+ * this hook used to own has been removed. Every switch routes through
+ * `useOxy().switchToAccount(accountId)` (or the dialog's row press).
+ */
+export function useSwitchableAccounts() {
+  const {
+    accountDialogController: controller
+  } = useOxy();
+  const subscribe = useCallback(listener => controller ? controller.subscribe(listener) : () => undefined, [controller]);
+  const getSnapshot = useCallback(() => controller ? controller.getSnapshot() : EMPTY_SNAPSHOT, [controller]);
+  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const currentSessionId = useMemo(() => {
+    const active = snapshot.accounts.find(account => account.accountId === snapshot.activeAccountId);
+    return active?.sessionId ?? null;
+  }, [snapshot]);
+  return {
+    accounts: snapshot.accounts,
+    isLoading: snapshot.loading,
+    currentSessionId
+  };
+}
+//# sourceMappingURL=useSwitchableAccounts.js.map

package/lib/module/ui/hooks/useSwitchableAccounts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useSyncExternalStore","useOxy","EMPTY_SNAPSHOT","view","accounts","activeAccountId","loading","error","switchingAccountId","signIn","phase","authorizeCode","qrPayload","expiresAt","route","routeFailed","pushSentAt","openedAt","progress","commonsAvailability","useSwitchableAccounts","accountDialogController","controller","subscribe","listener","undefined","getSnapshot","snapshot","currentSessionId","active","find","account","accountId","sessionId","isLoading"],"sourceRoot":"../../../../src","sources":["ui/hooks/useSwitchableAccounts.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,OAAO,EAAEC,oBAAoB,QAAQ,OAAO;AAElE,SAASC,MAAM,QAAQ,0BAAuB;AAW9C;AACA;AACA;AACA;AACA,MAAMC,cAAqC,GAAG;EAC1CC,IAAI,EAAE,UAAU;EAChBC,QAAQ,EAAE,EAAE;EACZC,eAAe,EAAE,IAAI;EACrBC,OAAO,EAAE,KAAK;EACdC,KAAK,EAAE,IAAI;EACXC,kBAAkB,EAAE,IAAI;EACxBC,MAAM,EAAE;IACJC,KAAK,EAAE,MAAM;IACbC,aAAa,EAAE,IAAI;IACnBC,SAAS,EAAE,IAAI;IACfC,SAAS,EAAE,IAAI;IACfN,KAAK,EAAE,IAAI;IACXO,KAAK,EAAE,IAAI;IACXC,WAAW,EAAE,KAAK;IAClBC,UAAU,EAAE,IAAI;IAChBC,QAAQ,EAAE,IAAI;IACdC,QAAQ,EAAE;EACd,CAAC;EACDC,mBAAmB,EAAE;AACzB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAgC;EACjE,MAAM;IAAEC,uBAAuB,EAAEC;EAAW,CAAC,GAAGrB,MAAM,CAAC,CAAC;EAExD,MAAMsB,SAAS,GAAGzB,WAAW,CACxB0B,QAAoB,IAAMF,UAAU,GAAGA,UAAU,CAACC,SAAS,CAACC,QAAQ,CAAC,GAAG,MAAMC,SAAU,EACzF,CAACH,UAAU,CACf,CAAC;EACD,MAAMI,WAAW,GAAG5B,WAAW,CAC3B,MAAOwB,UAAU,GAAGA,UAAU,CAACI,WAAW,CAAC,CAAC,GAAGxB,cAAe,EAC9D,CAACoB,UAAU,CACf,CAAC;EACD,MAAMK,QAAQ,GAAG3B,oBAAoB,CAACuB,SAAS,EAAEG,WAAW,EAAEA,WAAW,CAAC;EAE1E,MAAME,gBAAgB,GAAG7B,OAAO,CAAgB,MAAM;IAClD,MAAM8B,MAAM,GAAGF,QAAQ,CAACvB,QAAQ,CAAC0B,IAAI,CAAEC,OAAO,IAAKA,OAAO,CAACC,SAAS,KAAKL,QAAQ,CAACtB,eAAe,CAAC;IAClG,OAAOwB,MAAM,EAAEI,SAAS,IAAI,IAAI;EACpC,CAAC,EAAE,CAACN,QAAQ,CAAC,CAAC;EAEd,OAAO;IACHvB,QAAQ,EAAEuB,QAAQ,CAACvB,QAAQ;IAC3B8B,SAAS,EAAEP,QAAQ,CAACrB,OAAO;IAC3BsB;EACJ,CAAC;AACL","ignoreList":[]}

package/lib/module/ui/index.js

@@ -0,0 +1,49 @@
+"use strict";
+
+/**
+ * @oxyhq/services/ui — public subpath
+ *
+ * Tree-shakeable static re-exports of the most common UI surface. Backend
+ * environments (SSR) should import `@oxyhq/services/ui/server` instead;
+ * client-only callers can use `@oxyhq/services/ui/client` for a slightly
+ * narrower bundle.
+ *
+ * Static `export ... from` only — no runtime `require()`, no platform
+ * conditionals. The previous `if (isFrontend) require(...)` pattern was
+ * removed because it (a) violated the dual CJS/ESM build rule (ESM bundles
+ * cannot contain `require()` per CLAUDE.md) and (b) defeated tree-shaking.
+ */
+
+/// <reference path="../types/react-native-classname.d.ts" />
+/// <reference path="../types/react-native-web-style.d.ts" />
+
+// Components
+export { default as OxyProvider } from "./components/OxyProvider.js";
+export { default as OxySignInButton } from "./components/OxySignInButton.js";
+export { default as OxyAuthPrompt } from "./components/OxyAuthPrompt.js";
+export { LogoIcon } from "./components/logo/LogoIcon.js";
+export { LogoText } from "./components/logo/LogoText.js";
+export { RequireOxyAuth } from "./components/RequireOxyAuth.js";
+export { default as FollowButton } from "./components/FollowButton.js";
+export { default as OxyPayButton } from "./components/OxyPayButton.js";
+export { default as ProfileButton } from "./components/ProfileButton.js";
+
+// Context + hooks
+export { useOxy } from "./context/OxyContext.js";
+export { useAuth } from "./hooks/useAuth.js";
+export { useFollow, useSeedFollowStatuses } from "./hooks/useFollow.js";
+export { useStorage } from "./hooks/useStorage.js";
+// Screens
+export { default as ProfileScreen } from "./screens/ProfileScreen.js";
+export { default as ManageAccountScreen } from "./screens/ManageAccountScreen.js";
+export { default as CreateAccountScreen } from "./screens/CreateAccountScreen.js";
+export { default as AccountMembersScreen } from "./screens/AccountMembersScreen.js";
+export { default as AccountSettingsScreen } from "./screens/AccountSettingsScreen.js";
+
+// Stores
+export { useAuthStore } from "./stores/authStore.js";
+export { useAccountStore } from "./stores/accountStore.js";
+
+// Error handlers (pure functions)
+export { handleAuthError, isInvalidSessionError, isTimeoutOrNetworkError, extractErrorMessage } from "./utils/errorHandlers.js";
+//# sourceMappingURL=index.js.map

package/lib/module/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["default","OxyProvider","OxySignInButton","OxyAuthPrompt","LogoIcon","LogoText","RequireOxyAuth","FollowButton","OxyPayButton","ProfileButton","useOxy","useAuth","useFollow","useSeedFollowStatuses","useStorage","ProfileScreen","ManageAccountScreen","CreateAccountScreen","AccountMembersScreen","AccountSettingsScreen","useAuthStore","useAccountStore","handleAuthError","isInvalidSessionError","isTimeoutOrNetworkError","extractErrorMessage"],"sourceRoot":"../../../src","sources":["ui/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;;AAEA;AACA,SAASA,OAAO,IAAIC,WAAW,QAAQ,6BAA0B;AACjE,SAASD,OAAO,IAAIE,eAAe,QAAQ,iCAA8B;AACzE,SAASF,OAAO,IAAIG,aAAa,QAAQ,+BAA4B;AAErE,SAASC,QAAQ,QAAQ,+BAA4B;AACrD,SAASC,QAAQ,QAAQ,+BAA4B;AACrD,SAASC,cAAc,QAAQ,gCAA6B;AAE5D,SAASN,OAAO,IAAIO,YAAY,QAAQ,8BAA2B;AACnE,SAASP,OAAO,IAAIQ,YAAY,QAAQ,8BAA2B;AACnE,SAASR,OAAO,IAAIS,aAAa,QAAQ,+BAA4B;;AAErE;AACA,SAASC,MAAM,QAAQ,yBAAsB;AAC7C,SAASC,OAAO,QAAQ,oBAAiB;AACzC,SAASC,SAAS,EAAEC,qBAAqB,QAAQ,sBAAmB;AACpE,SAASC,UAAU,QAAQ,uBAAoB;AAG/C;AACA,SAASd,OAAO,IAAIe,aAAa,QAAQ,4BAAyB;AAClE,SAASf,OAAO,IAAIgB,mBAAmB,QAAQ,kCAA+B;AAC9E,SAAShB,OAAO,IAAIiB,mBAAmB,QAAQ,kCAA+B;AAC9E,SAASjB,OAAO,IAAIkB,oBAAoB,QAAQ,mCAAgC;AAChF,SAASlB,OAAO,IAAImB,qBAAqB,QAAQ,oCAAiC;;AAElF;AACA,SAASC,YAAY,QAAQ,uBAAoB;AACjD,SAASC,eAAe,QAAQ,0BAAuB;;AAEvD;AACA,SACIC,eAAe,EACfC,qBAAqB,EACrBC,uBAAuB,EACvBC,mBAAmB,QAChB,0BAAuB","ignoreList":[]}

package/lib/module/ui/isFrontend.js

@@ -0,0 +1,6 @@
+"use strict";
+
+// Utility to detect if running in a frontend (browser or React Native) environment
+const isFrontend = typeof window !== 'undefined' || typeof navigator !== 'undefined' && navigator.product === 'ReactNative';
+export default isFrontend;
+//# sourceMappingURL=isFrontend.js.map

package/lib/module/ui/isFrontend.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isFrontend","window","navigator","product"],"sourceRoot":"../../../src","sources":["ui/isFrontend.ts"],"mappings":";;AAAA;AACA,MAAMA,UAAU,GAAG,OAAOC,MAAM,KAAK,WAAW,IAC7C,OAAOC,SAAS,KAAK,WAAW,IAAIA,SAAS,CAACC,OAAO,KAAK,aAAc;AAE3E,eAAeH,UAAU","ignoreList":[]}

package/lib/module/ui/navigation/accountDialogManager.js

@@ -0,0 +1,76 @@
+"use strict";
+
+/**
+ * Imperative, outside-React entry points for the unified `OxyAccountDialogScreen`.
+ *
+ * These delegate to the live handles the mounted `OxyProvider` registers via
+ * {@link registerAccountDialogControls}. Under the hood `open`/`close` present
+ * and dismiss the `AccountDialog` surface on the shared Bloom surface stack
+ * (`OxyContext.openAccountDialog` → `presentDetached('AccountDialog', …)`), so
+ * whether the dialog is open is owned by that stack — this module is only the
+ * thin bridge that reaches the provider's controller (which sets the dialog
+ * view) from a non-React call site.
+ */
+
+/**
+ * Live open/close handles registered by the mounted provider. `open` presents
+ * the `AccountDialog` surface (and points its view); `close` dismisses it. Both
+ * are stack operations — this interface never carries visibility state.
+ */
+
+/**
+ * Optional consumer overrides for account-dialog actions. `ProfileButton` (and
+ * similar hosts) register these while mounted so inbox/accounts can route
+ * "Manage" / "Add account" to app-local navigation instead of the SDK default.
+ */
+
+let controls = null;
+let consumerHooks = null;
+const visibilityListeners = new Set();
+export function registerAccountDialogControls(next) {
+  controls = next;
+  return () => {
+    if (controls === next) {
+      controls = null;
+    }
+  };
+}
+
+/** Register app-local manage/add/profile handlers for the account dialog. */
+export function registerAccountDialogConsumerHooks(next) {
+  consumerHooks = next;
+  return () => {
+    if (consumerHooks === next) {
+      consumerHooks = null;
+    }
+  };
+}
+export function getAccountDialogConsumerHooks() {
+  return consumerHooks;
+}
+
+/** Open the account dialog on `view` (default `accounts`). No-op before mount. */
+export function openAccountDialog(view) {
+  controls?.open(view);
+}
+
+/** Close the account dialog. No-op before mount. */
+export function closeAccountDialog() {
+  controls?.close();
+}
+
+/** Report dialog visibility to subscribers (e.g. `OxySignInButton` loading state). */
+export function notifyAccountDialogVisibility(visible) {
+  for (const listener of visibilityListeners) {
+    listener(visible);
+  }
+}
+
+/** Subscribe to account dialog visibility changes. */
+export function subscribeToAccountDialog(listener) {
+  visibilityListeners.add(listener);
+  return () => {
+    visibilityListeners.delete(listener);
+  };
+}
+//# sourceMappingURL=accountDialogManager.js.map

package/lib/module/ui/navigation/accountDialogManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["controls","consumerHooks","visibilityListeners","Set","registerAccountDialogControls","next","registerAccountDialogConsumerHooks","getAccountDialogConsumerHooks","openAccountDialog","view","open","closeAccountDialog","close","notifyAccountDialogVisibility","visible","listener","subscribeToAccountDialog","add","delete"],"sourceRoot":"../../../../src","sources":["ui/navigation/accountDialogManager.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;;AAOA,IAAIA,QAAsC,GAAG,IAAI;AACjD,IAAIC,aAAgD,GAAG,IAAI;AAC3D,MAAMC,mBAAmB,GAAG,IAAIC,GAAG,CAA6B,CAAC;AAEjE,OAAO,SAASC,6BAA6BA,CAACC,IAA2B,EAAc;EACrFL,QAAQ,GAAGK,IAAI;EACf,OAAO,MAAM;IACX,IAAIL,QAAQ,KAAKK,IAAI,EAAE;MACrBL,QAAQ,GAAG,IAAI;IACjB;EACF,CAAC;AACH;;AAEA;AACA,OAAO,SAASM,kCAAkCA,CAChDD,IAAuC,EAC3B;EACZJ,aAAa,GAAGI,IAAI;EACpB,OAAO,MAAM;IACX,IAAIJ,aAAa,KAAKI,IAAI,EAAE;MAC1BJ,aAAa,GAAG,IAAI;IACtB;EACF,CAAC;AACH;AAEA,OAAO,SAASM,6BAA6BA,CAAA,EAAsC;EACjF,OAAON,aAAa;AACtB;;AAEA;AACA,OAAO,SAASO,iBAAiBA,CAACC,IAAwB,EAAQ;EAChET,QAAQ,EAAEU,IAAI,CAACD,IAAI,CAAC;AACtB;;AAEA;AACA,OAAO,SAASE,kBAAkBA,CAAA,EAAS;EACzCX,QAAQ,EAAEY,KAAK,CAAC,CAAC;AACnB;;AAEA;AACA,OAAO,SAASC,6BAA6BA,CAACC,OAAgB,EAAQ;EACpE,KAAK,MAAMC,QAAQ,IAAIb,mBAAmB,EAAE;IAC1Ca,QAAQ,CAACD,OAAO,CAAC;EACnB;AACF;;AAEA;AACA,OAAO,SAASE,wBAAwBA,CAACD,QAAoC,EAAc;EACzFb,mBAAmB,CAACe,GAAG,CAACF,QAAQ,CAAC;EACjC,OAAO,MAAM;IACXb,mBAAmB,CAACgB,MAAM,CAACH,QAAQ,CAAC;EACtC,CAAC;AACH","ignoreList":[]}

package/lib/module/ui/navigation/bottomSheetManager.js

@@ -0,0 +1,56 @@
+"use strict";
+
+import { isValidRoute } from "./routes.js";
+import { getSurfaceConfig } from "./surfaceRegistry.js";
+import { closeAllRouteSurfaces, presentRoute, topRouteSurface } from "./surfaces.js";
+
+/**
+ * Bottom-sheet manager — the INTERNAL adapter that keeps the historical
+ * `showBottomSheet` / `closeBottomSheet` API working on top of the new Bloom
+ * surface stack (`navigation/surfaces.ts`). The public signatures are unchanged;
+ * this file just re-expresses them as thin calls into the typed surface layer.
+ *
+ * The old single-surface store is gone: `showBottomSheet` now open-or-navigates
+ * the "base" (top-most) route surface, and cross-presentation targets (the
+ * full-bleed image picker) stack a NEW surface on top — Bloom coordinates the
+ * z-order / backdrop / dismiss so nothing clashes.
+ */
+
+/**
+ * Open a bottom-sheet route. By DEFAULT it drills into the top-most active
+ * surface — morphing it in place (every screen morphs). A NEW surface is stacked
+ * on top only when the target route declares `stacks` (reserved for genuine
+ * overlays — none today). Opening with no active surface presents the first one.
+ *
+ * `fullScreen` is accepted for signature compatibility and ignored — a route's
+ * surface is now derived from its registry config, not a per-call flag.
+ */
+export const showBottomSheet = screenOrConfig => {
+  const screen = typeof screenOrConfig === 'string' ? screenOrConfig : screenOrConfig.screen;
+  const props = typeof screenOrConfig === 'string' ? {} : screenOrConfig.props ?? {};
+  if (!isValidRoute(screen)) {
+    if (__DEV__) console.warn(`[BottomSheet] Invalid route: ${screen}`);
+    return;
+  }
+  const top = topRouteSurface();
+  if (top && !getSurfaceConfig(screen, props).stacks) {
+    top.navigate(screen, props);
+  } else {
+    presentRoute(screen, props);
+  }
+};
+
+/** Dismiss the whole bottom-sheet session (every active route surface). */
+export const closeBottomSheet = () => {
+  closeAllRouteSurfaces();
+};
+
+/**
+ * Step back within the top-most surface's route history. Returns `true` when a
+ * frame was popped, `false` when the surface is already at its root frame.
+ */
+export const goBack = () => {
+  const top = topRouteSurface();
+  return top ? top.goBack() : false;
+};
+//# sourceMappingURL=bottomSheetManager.js.map

package/lib/module/ui/navigation/bottomSheetManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isValidRoute","getSurfaceConfig","closeAllRouteSurfaces","presentRoute","topRouteSurface","showBottomSheet","screenOrConfig","screen","props","__DEV__","console","warn","top","stacks","navigate","closeBottomSheet","goBack"],"sourceRoot":"../../../../src","sources":["ui/navigation/bottomSheetManager.ts"],"mappings":";;AACA,SAASA,YAAY,QAAQ,aAAU;AACvC,SAASC,gBAAgB,QAAQ,sBAAmB;AACpD,SAASC,qBAAqB,EAAEC,YAAY,EAAEC,eAAe,QAAQ,eAAY;;AAEjF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAC1BC,cAEgF,IACvE;EACT,MAAMC,MAAM,GAAG,OAAOD,cAAc,KAAK,QAAQ,GAAGA,cAAc,GAAGA,cAAc,CAACC,MAAM;EAC1F,MAAMC,KAAK,GAAG,OAAOF,cAAc,KAAK,QAAQ,GAAG,CAAC,CAAC,GAAGA,cAAc,CAACE,KAAK,IAAI,CAAC,CAAC;EAElF,IAAI,CAACR,YAAY,CAACO,MAAM,CAAC,EAAE;IACzB,IAAIE,OAAO,EAAEC,OAAO,CAACC,IAAI,CAAC,gCAAgCJ,MAAM,EAAE,CAAC;IACnE;EACF;EAEA,MAAMK,GAAG,GAAGR,eAAe,CAAC,CAAC;EAC7B,IAAIQ,GAAG,IAAI,CAACX,gBAAgB,CAACM,MAAM,EAAEC,KAAK,CAAC,CAACK,MAAM,EAAE;IAClDD,GAAG,CAACE,QAAQ,CAACP,MAAM,EAAEC,KAAK,CAAC;EAC7B,CAAC,MAAM;IACLL,YAAY,CAACI,MAAM,EAAEC,KAAK,CAAC;EAC7B;AACF,CAAC;;AAED;AACA,OAAO,MAAMO,gBAAgB,GAAGA,CAAA,KAAY;EAC1Cb,qBAAqB,CAAC,CAAC;AACzB,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,MAAMc,MAAM,GAAGA,CAAA,KAAe;EACnC,MAAMJ,GAAG,GAAGR,eAAe,CAAC,CAAC;EAC7B,OAAOQ,GAAG,GAAGA,GAAG,CAACI,MAAM,CAAC,CAAC,GAAG,KAAK;AACnC,CAAC","ignoreList":[]}

package/lib/module/ui/navigation/routes.js

@@ -0,0 +1,92 @@
+"use strict";
+
+// Lazy loading: Screens are loaded on-demand to break require cycles
+// This prevents screens (which import OxyContext) from being loaded
+// before OxyContext is fully initialized
+
+// Define all available route names
+
+// Unified account switcher + sign-in surface (OxyAccountDialogScreen body)
+
+// Lazy screen loaders - functions that return screen components on-demand
+// This breaks the require cycle by deferring imports until screens are actually needed
+const screenLoaders = {
+  ManageAccount: () => require('../screens/ManageAccountScreen').default,
+  AccountVerification: () => require('../screens/AccountVerificationScreen').default,
+  PaymentGateway: () => require('../screens/PaymentGatewayScreen').default,
+  Profile: () => require('../screens/ProfileScreen').default,
+  LanguageSelector: () => require('../screens/LanguageSelectorScreen').default,
+  PrivacySettings: () => require('../screens/PrivacySettingsScreen').default,
+  SearchSettings: () => require('../screens/SearchSettingsScreen').default,
+  FileManagement: () => require('../screens/FileManagementScreen').default,
+  HelpSupport: () => require('../screens/HelpSupportScreen').default,
+  FAQ: () => require('../screens/FAQScreen').default,
+  Feedback: () => require('../screens/FeedbackScreen').default,
+  LegalDocuments: () => require('../screens/LegalDocumentsScreen').default,
+  AppInfo: () => require('../screens/AppInfoScreen').default,
+  PremiumSubscription: () => require('../screens/PremiumSubscriptionScreen').default,
+  WelcomeNewUser: () => require('../screens/WelcomeNewUserScreen').default,
+  UserLinks: () => require('../screens/UserLinksScreen').default,
+  HistoryView: () => require('../screens/HistoryViewScreen').default,
+  SavesCollections: () => require('../screens/SavesCollectionsScreen').default,
+  EditProfile: () => require('../screens/EditProfileScreen').default,
+  EditProfileField: () => require('../screens/EditProfileFieldScreen').default,
+  // Informational screens
+  LearnMoreUsernames: () => require('../screens/LearnMoreUsernamesScreen').default,
+  // Oxy Trust screens
+  TrustCenter: () => require('../screens/trust/TrustCenterScreen').default,
+  TrustLeaderboard: () => require('../screens/trust/TrustLeaderboardScreen').default,
+  TrustRewards: () => require('../screens/trust/TrustRewardsScreen').default,
+  TrustRules: () => require('../screens/trust/TrustRulesScreen').default,
+  AboutTrust: () => require('../screens/trust/TrustAboutScreen').default,
+  TrustFAQ: () => require('../screens/trust/TrustFAQScreen').default,
+  // User list screens (followers/following)
+  FollowersList: () => require('../screens/FollowersListScreen').default,
+  FollowingList: () => require('../screens/FollowingListScreen').default,
+  CreateAccount: () => require('../screens/CreateAccountScreen').default,
+  AccountMembers: () => require('../screens/AccountMembersScreen').default,
+  AccountSettings: () => require('../screens/AccountSettingsScreen').default,
+  ChangeAvatar: () => require('../screens/ChangeAvatarScreen').default,
+  AvatarCrop: () => require('../screens/AvatarCropScreen').default,
+  Notifications: () => require('../screens/NotificationsScreen').default,
+  ConnectedApps: () => require('../screens/ConnectedAppsScreen').default,
+  Preferences: () => require('../screens/PreferencesScreen').default,
+  // Unified account switcher + sign-in surface. Its body lives in the
+  // `OxyAccountDialogScreen` component (folded from the standalone dialog); the
+  // surface stack provides the Dialog chrome around it.
+  AccountDialog: () => require('../components/OxyAccountDialogScreen').default
+};
+
+// Cache loaded components to avoid re-requiring
+const screenCache = new Map();
+
+// Helper function to get a screen component by route name (lazy loaded)
+export const getScreenComponent = routeName => {
+  // Return cached component if available
+  if (screenCache.has(routeName)) {
+    return screenCache.get(routeName);
+  }
+
+  // Lazy load the component
+  const loader = screenLoaders[routeName];
+  if (loader) {
+    try {
+      const component = loader();
+      screenCache.set(routeName, component);
+      return component;
+    } catch (error) {
+      if (__DEV__) {
+        console.error(`[Routes] Failed to load screen: ${routeName}`, error);
+      }
+      return undefined;
+    }
+  }
+  return undefined;
+};
+
+// Helper function to check if a route exists
+// Uses the screenLoaders object to check existence without loading the screen
+export const isValidRoute = routeName => {
+  return routeName in screenLoaders;
+};
+//# sourceMappingURL=routes.js.map

package/lib/module/ui/navigation/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["screenLoaders","ManageAccount","require","default","AccountVerification","PaymentGateway","Profile","LanguageSelector","PrivacySettings","SearchSettings","FileManagement","HelpSupport","FAQ","Feedback","LegalDocuments","AppInfo","PremiumSubscription","WelcomeNewUser","UserLinks","HistoryView","SavesCollections","EditProfile","EditProfileField","LearnMoreUsernames","TrustCenter","TrustLeaderboard","TrustRewards","TrustRules","AboutTrust","TrustFAQ","FollowersList","FollowingList","CreateAccount","AccountMembers","AccountSettings","ChangeAvatar","AvatarCrop","Notifications","ConnectedApps","Preferences","AccountDialog","screenCache","Map","getScreenComponent","routeName","has","get","loader","component","set","error","__DEV__","console","undefined","isValidRoute"],"sourceRoot":"../../../../src","sources":["ui/navigation/routes.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/navigation/surfaceBackBridge.js

@@ -0,0 +1,63 @@
+"use strict";
+
+import { BackHandler, Platform } from 'react-native';
+
+/**
+ * Per-surface system-back handlers (Android hardware back + web Escape).
+ *
+ * Bloom's `SurfaceHost` dismisses the whole top surface on back/Escape. The SDK
+ * needs the old `BottomSheetRouter` semantics first: pop nav history, step a
+ * wizard back, then dismiss. A single global listener delegates to the topmost
+ * registered handler so stacked surfaces route correctly.
+ */
+
+const handlerStack = [];
+let androidInstalled = false;
+let escapeInstalled = false;
+function invokeTopHandler() {
+  const handler = handlerStack[handlerStack.length - 1];
+  return handler ? handler() : false;
+}
+function installAndroidHandler() {
+  if (androidInstalled || Platform.OS !== 'android') return;
+  androidInstalled = true;
+  BackHandler.addEventListener('hardwareBackPress', () => {
+    if (handlerStack.length === 0) return false;
+    return invokeTopHandler();
+  });
+}
+function installEscapeHandler() {
+  if (escapeInstalled || Platform.OS !== 'web') return;
+  if (typeof window === 'undefined') return;
+  escapeInstalled = true;
+  window.addEventListener('keydown', event => {
+    if (event.key !== 'Escape' || handlerStack.length === 0) return;
+    invokeTopHandler();
+    event.stopImmediatePropagation();
+    event.preventDefault();
+  }, true);
+}
+
+/** Register before Bloom's `SurfaceHost` mounts so Escape capture runs first. */
+installEscapeHandler();
+
+/** Push a handler for one live surface; returns unregister. */
+export function pushSurfaceBackHandler(handler) {
+  handlerStack.push(handler);
+  installAndroidHandler();
+  return () => {
+    const index = handlerStack.lastIndexOf(handler);
+    if (index >= 0) handlerStack.splice(index, 1);
+  };
+}
+
+/** Test-only: invoke the top handler. */
+export function __invokeTopSurfaceBackForTests() {
+  return invokeTopHandler();
+}
+
+/** Test-only reset. */
+export function __resetSurfaceBackBridgeForTests() {
+  handlerStack.length = 0;
+}
+//# sourceMappingURL=surfaceBackBridge.js.map

package/lib/module/ui/navigation/surfaceBackBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BackHandler","Platform","handlerStack","androidInstalled","escapeInstalled","invokeTopHandler","handler","length","installAndroidHandler","OS","addEventListener","installEscapeHandler","window","event","key","stopImmediatePropagation","preventDefault","pushSurfaceBackHandler","push","index","lastIndexOf","splice","__invokeTopSurfaceBackForTests","__resetSurfaceBackBridgeForTests"],"sourceRoot":"../../../../src","sources":["ui/navigation/surfaceBackBridge.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,QAAQ,QAAQ,cAAc;;AAEpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMC,YAAkC,GAAG,EAAE;AAC7C,IAAIC,gBAAgB,GAAG,KAAK;AAC5B,IAAIC,eAAe,GAAG,KAAK;AAE3B,SAASC,gBAAgBA,CAAA,EAAY;EACnC,MAAMC,OAAO,GAAGJ,YAAY,CAACA,YAAY,CAACK,MAAM,GAAG,CAAC,CAAC;EACrD,OAAOD,OAAO,GAAGA,OAAO,CAAC,CAAC,GAAG,KAAK;AACpC;AAEA,SAASE,qBAAqBA,CAAA,EAAS;EACrC,IAAIL,gBAAgB,IAAIF,QAAQ,CAACQ,EAAE,KAAK,SAAS,EAAE;EACnDN,gBAAgB,GAAG,IAAI;EACvBH,WAAW,CAACU,gBAAgB,CAAC,mBAAmB,EAAE,MAAM;IACtD,IAAIR,YAAY,CAACK,MAAM,KAAK,CAAC,EAAE,OAAO,KAAK;IAC3C,OAAOF,gBAAgB,CAAC,CAAC;EAC3B,CAAC,CAAC;AACJ;AAEA,SAASM,oBAAoBA,CAAA,EAAS;EACpC,IAAIP,eAAe,IAAIH,QAAQ,CAACQ,EAAE,KAAK,KAAK,EAAE;EAC9C,IAAI,OAAOG,MAAM,KAAK,WAAW,EAAE;EACnCR,eAAe,GAAG,IAAI;EACtBQ,MAAM,CAACF,gBAAgB,CACrB,SAAS,EACRG,KAAK,IAAK;IACT,IAAIA,KAAK,CAACC,GAAG,KAAK,QAAQ,IAAIZ,YAAY,CAACK,MAAM,KAAK,CAAC,EAAE;IACzDF,gBAAgB,CAAC,CAAC;IAClBQ,KAAK,CAACE,wBAAwB,CAAC,CAAC;IAChCF,KAAK,CAACG,cAAc,CAAC,CAAC;EACxB,CAAC,EACD,IACF,CAAC;AACH;;AAEA;AACAL,oBAAoB,CAAC,CAAC;;AAEtB;AACA,OAAO,SAASM,sBAAsBA,CAACX,OAA2B,EAAc;EAC9EJ,YAAY,CAACgB,IAAI,CAACZ,OAAO,CAAC;EAC1BE,qBAAqB,CAAC,CAAC;EACvB,OAAO,MAAM;IACX,MAAMW,KAAK,GAAGjB,YAAY,CAACkB,WAAW,CAACd,OAAO,CAAC;IAC/C,IAAIa,KAAK,IAAI,CAAC,EAAEjB,YAAY,CAACmB,MAAM,CAACF,KAAK,EAAE,CAAC,CAAC;EAC/C,CAAC;AACH;;AAEA;AACA,OAAO,SAASG,8BAA8BA,CAAA,EAAY;EACxD,OAAOjB,gBAAgB,CAAC,CAAC;AAC3B;;AAEA;AACA,OAAO,SAASkB,gCAAgCA,CAAA,EAAS;EACvDrB,YAAY,CAACK,MAAM,GAAG,CAAC;AACzB","ignoreList":[]}