@oxyhq/services 22.9.0 → 22.11.0

package/lib/typescript/module/ui/components/ProfileSummaryCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProfileSummaryCard.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ProfileSummaryCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACpC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;IACjD,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACrC;AAuBD,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA4DzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"ProfileSummaryCard.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ProfileSummaryCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACpC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC;IACjD,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACrC;AAWD,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAkDzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/lib/typescript/module/ui/components/RequireOxyAuth.d.ts

@@ -15,7 +15,7 @@
  * neutral loading state so the signed-out wall never flashes before the
  * device-first cold boot concludes (the documented cold-boot race).
  *
- * Styling follows the sibling `OxyAccountDialog`/`OxySignInButton` pattern —
+ * Styling follows the sibling `OxyAccountDialogScreen`/`OxySignInButton` pattern —
  * `useTheme()` + `StyleSheet` (NOT NativeWind), so the gate renders correctly in
  * EVERY consumer, including apps that do not run NativeWind (e.g. the accounts
  * app).

package/lib/typescript/module/ui/components/SurfaceHeaderAction.d.ts

@@ -0,0 +1,16 @@
+import type React from 'react';
+export interface SurfaceHeaderActionProps {
+    /** Button label (e.g. a translated "Save"). */
+    label: string;
+    onPress: () => void;
+    /** Show a spinner instead of the label (also disables the button). */
+    loading?: boolean;
+    disabled?: boolean;
+}
+/**
+ * A filled pill action for a surface's nav-header right slot — the canonical
+ * "Save" affordance. Pass a memoized instance to `useSurfaceHeader({ right })`
+ * so the header does not thrash between renders.
+ */
+export declare const SurfaceHeaderAction: React.FC<SurfaceHeaderActionProps>;
+//# sourceMappingURL=SurfaceHeaderAction.d.ts.map

package/lib/typescript/module/ui/components/SurfaceHeaderAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceHeaderAction.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/SurfaceHeaderAction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAuBlE,CAAC"}

package/lib/typescript/module/ui/components/SurfaceScreen.d.ts

@@ -1,14 +1,13 @@
 import React from 'react';
 import type { SurfaceControls } from '@oxyhq/bloom/surfaces';
 import type { SurfaceNavStack } from '../navigation/surfaceNavStack.js';
-import type { SurfacePresentation } from '../navigation/surfaceRegistry.js';
 export interface SurfaceScreenProps {
     /** This surface's route history (the NAV-WITHIN axis). */
     navStack: SurfaceNavStack;
     /** Bloom's per-surface controls (dismiss / present a child) — the DEPTH axis. */
     surface: SurfaceControls;
-    /** This surface's presentation, so `navigate` knows when to drill in vs. stack. */
-    presentation: SurfacePresentation;
+    /** Whether backdrop / Escape / back may dismiss at the root frame. Defaults to true. */
+    dismissOnBackdrop?: boolean;
 }
 /**
  * Binds one SDK surface to its content: resolves the lazy screen for the current
@@ -19,6 +18,6 @@ export interface SurfaceScreenProps {
  * effect) rather than a captured-controls call, so a dismiss requested before
  * this surface mounted still resolves the Bloom surface exactly once.
  */
-declare function SurfaceScreen({ navStack, surface, presentation }: SurfaceScreenProps): React.JSX.Element | null;
+declare function SurfaceScreen({ navStack, surface, dismissOnBackdrop, }: SurfaceScreenProps): React.JSX.Element | null;
 export default SurfaceScreen;
 //# sourceMappingURL=SurfaceScreen.d.ts.map

package/lib/typescript/module/ui/components/SurfaceScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SurfaceScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/SurfaceScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAI/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAA+B,CAAC;AA2DzE,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,EAAE,eAAe,CAAC;IAC1B,iFAAiF;IACjF,OAAO,EAAE,eAAe,CAAC;IACzB,mFAAmF;IACnF,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,iBAAS,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,kBAAkB,4BA8E7E;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"SurfaceScreen.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/SurfaceScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoE,MAAM,OAAO,CAAC;AASzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAA+B,CAAC;AAgErE,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,EAAE,eAAe,CAAC;IAC1B,iFAAiF;IACjF,OAAO,EAAE,eAAe,CAAC;IACzB,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,iBAAS,aAAa,CAAC,EACrB,QAAQ,EACR,OAAO,EACP,iBAAwB,GACzB,EAAE,kBAAkB,4BA8JpB;AAED,eAAe,aAAa,CAAC"}

package/lib/typescript/module/ui/components/fileManagement/FileDetailsModal.d.ts

@@ -1,14 +1,24 @@
 import type React from 'react';
-import { type DialogControlProps } from '@oxyhq/bloom';
+import { type SurfaceControls } from '@oxyhq/bloom/surfaces';
 import type { FileMetadata } from '@oxyhq/core';
 interface FileDetailsModalProps {
-    control: DialogControlProps;
-    file: FileMetadata | null;
+    /** The presenting surface's controls (from `surfaces.present`). */
+    surface: SurfaceControls;
+    file: FileMetadata;
     onDownload: (fileId: string, filename: string) => void;
     onDelete: (fileId: string, filename: string) => void;
     isOwner: boolean;
-    onClose?: () => void;
 }
+/**
+ * File-detail panel — a rich presented surface (NOT a yes/no confirm): a file's
+ * icon + metadata plus download / delete / cancel actions. Each action first
+ * dismisses this surface, then runs its handler, so a follow-up delete confirm
+ * stacks cleanly above whatever remains. Presented via {@link presentFileDetails}.
+ */
 export declare const FileDetailsModal: React.FC<FileDetailsModalProps>;
+/** Options accepted by {@link presentFileDetails} (everything but `surface`). */
+type PresentFileDetailsOptions = Omit<FileDetailsModalProps, 'surface'>;
+/** Present the file-detail panel on the shared surface stack. */
+export declare function presentFileDetails(options: PresentFileDetailsOptions): void;
 export {};
 //# sourceMappingURL=FileDetailsModal.d.ts.map

package/lib/typescript/module/ui/components/fileManagement/FileDetailsModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileDetailsModal.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/fileManagement/FileDetailsModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,UAAU,qBAAqB;IAC3B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAgG5D,CAAC"}
+{"version":3,"file":"FileDetailsModal.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/fileManagement/FileDetailsModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,UAAU,qBAAqB;IAC3B,mEAAmE;IACnE,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA6F5D,CAAC;AAEF,iFAAiF;AACjF,KAAK,yBAAyB,GAAG,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;AAExE,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAI3E"}

package/lib/typescript/module/ui/components/modals/DeleteAccountModal.d.ts

@@ -1,11 +1,26 @@
 import type React from 'react';
-import { type DialogControlProps } from '@oxyhq/bloom';
+import { type SurfaceControls } from '@oxyhq/bloom/surfaces';
 interface DeleteAccountModalProps {
-    control: DialogControlProps;
+    /** The presenting surface's controls (from `surfaces.present`). */
+    surface: SurfaceControls;
     username: string;
     onDelete: (confirmText: string) => Promise<void>;
     t: (key: string, params?: Record<string, string>) => string | undefined;
 }
+/**
+ * Delete-account confirmation — a rich presented surface (NOT a yes/no confirm):
+ * the user must retype their username, then the destructive action runs
+ * `onDelete`. On success the surface is dismissed with `true` (the presenter
+ * then signs out + closes); cancel dismisses with `false`. Presented via
+ * {@link presentDeleteAccount}.
+ */
 declare const DeleteAccountModal: React.FC<DeleteAccountModalProps>;
+/** Options accepted by {@link presentDeleteAccount} (everything but `surface`). */
+type PresentDeleteAccountOptions = Omit<DeleteAccountModalProps, 'surface'>;
+/**
+ * Present the delete-account confirmation on the shared surface stack. Resolves
+ * `true` once the account is deleted, `false` if cancelled/dismissed.
+ */
+export declare function presentDeleteAccount(options: PresentDeleteAccountOptions): Promise<boolean>;
 export default DeleteAccountModal;
 //# sourceMappingURL=DeleteAccountModal.d.ts.map

package/lib/typescript/module/ui/components/modals/DeleteAccountModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeleteAccountModal.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/modals/DeleteAccountModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAG/D,UAAU,uBAAuB;IAC7B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CAC3E;AAED,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA6FzD,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"DeleteAccountModal.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/modals/DeleteAccountModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEvE,UAAU,uBAAuB;IAC7B,mEAAmE;IACnE,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;CAC3E;AAED;;;;;;GAMG;AACH,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA4FzD,CAAC;AAEF,mFAAmF;AACnF,KAAK,2BAA2B,GAAG,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;AAE5E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3F;AAED,eAAe,kBAAkB,CAAC"}

package/lib/typescript/module/ui/components/oxyAuthChooserStyles.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shared styles for `OxyAuthChooser`'s views. Extracted from `OxyAccountDialog`
+ * Shared styles for `OxyAuthChooser`'s views. Extracted from `OxyAccountDialogScreen`
  * so both the Dialog-wrapped host and any bare host (e.g. a future
  * auth.oxy.so hub page) render identically without duplicating a StyleSheet.
  */
@@ -37,29 +37,91 @@ export declare const authChooserStyles: {
         fontSize: number;
         marginTop: number;
     };
-    addRow: {
-        flexDirection: "row";
+    /**
+     * Animated-collapse container for the account switch list — the outer clip and
+     * the inner measuring wrapper. Style-based (NOT NativeWind): the container
+     * carries the animated `height`/`opacity` off a reanimated style, and the
+     * measuring wrapper must stay className-free so its `onLayout` fires on RN-Web.
+     */
+    collapse: {
+        overflow: "hidden";
+    };
+    collapseMeasure: {
+        width: "100%";
+    };
+    /**
+     * The HERO block that opens the account menu: the current account's large
+     * avatar, a greeting, and the "Manage your Oxy account" pill — centred and
+     * deliberately chrome-free (no card, no grouped-section surface) so the
+     * grouped cards below read as the menu proper. The account's email sits above
+     * it in the Dialog's own nav bar, not here.
+     */
+    hero: {
         alignItems: "center";
+        paddingTop: number;
+        paddingBottom: number;
         gap: number;
+    };
+    /**
+     * The current account's accent ring in the switch list, drawn OUTSIDE its
+     * avatar as an overlay so it adds no width to the row — every avatar in the
+     * list keeps the same footprint and the same content line. The 3px offset is
+     * the ring's 2px stroke plus a 1px gap.
+     */
+    currentAvatarRing: {
+        position: "absolute";
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
+        borderWidth: number;
+        borderRadius: number;
+    };
+    /**
+     * The hero avatar's pressable wrapper — the "change your photo" entry point.
+     * `relative` so the accent ring + camera badge (both absolutely positioned)
+     * anchor to the avatar box.
+     */
+    heroAvatarPressable: {
+        position: "relative";
+    };
+    /** The hero avatar's accent ring — an overlay, like the row-level one. */
+    heroAvatarRing: {
+        position: "absolute";
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
         borderWidth: number;
-        borderStyle: "dashed";
         borderRadius: number;
-        paddingVertical: number;
-        paddingHorizontal: number;
-        marginTop: number;
     };
-    addBadge: {
+    /** Greeting + address stacked tight, centred (the hero's own 12px gap sits
+     *  between this block and the avatar / manage pill, not between these lines). */
+    heroNameBlock: {
+        alignItems: "center";
+        gap: number;
+    };
+    heroGreeting: {
+        fontSize: number;
+        fontWeight: "600";
+        textAlign: "center";
+    };
+    /** The account address (`username@oxy.so` / `@handle`) under the greeting. */
+    heroAddress: {
+        fontSize: number;
+        textAlign: "center";
+    };
+    /**
+     * The switch row's disclosure affordance — a filled circle around the chevron,
+     * right-aligned to the same 12px row inset every other trailing element uses.
+     */
+    chevronCircle: {
         width: number;
         height: number;
         borderRadius: number;
-        borderWidth: number;
         alignItems: "center";
         justifyContent: "center";
     };
-    footerLinks: {
-        alignItems: "center";
-        marginTop: number;
-    };
     footerLink: {
         alignSelf: "center";
         paddingVertical: number;

package/lib/typescript/module/ui/components/oxyAuthChooserStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oxyAuthChooserStyles.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/oxyAuthChooserStyles.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0H5B,CAAC"}
+{"version":3,"file":"oxyAuthChooserStyles.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/oxyAuthChooserStyles.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkC5B;;;;;OAKG;;;;;;;IAOH;;;;;;OAMG;;;;;;;IAOH;;;;;OAKG;;;;;;;;;;IAUH;;;;OAIG;;;;IAIH,0EAA0E;;;;;;;;;;IAU1E;qFACiF;;;;;;;;;;IAUjF,8EAA8E;;;;;IAK9E;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEH,CAAC"}

package/lib/typescript/module/ui/components/photogrid/JustifiedPhotoGrid.d.ts

@@ -1,15 +1,17 @@
 import React from 'react';
 import type { FileMetadata } from '@oxyhq/core';
+/** Fixed photos-per-row for the justified grid (Apple Photos-style trio). */
+export declare const PHOTOS_PER_ROW = 3;
+/** Chunk a photo list into fixed-length rows (last row may be short). */
+export declare function chunkPhotos(photos: FileMetadata[], perRow: number): FileMetadata[][];
 export interface JustifiedPhotoGridProps {
     photos: FileMetadata[];
-    photoDimensions: {
-        [key: string]: {
-            width: number;
-            height: number;
-        };
-    };
-    loadPhotoDimensions: (photos: FileMetadata[]) => Promise<void>;
-    createJustifiedRows: (photos: FileMetadata[], containerWidth: number) => FileMetadata[][];
+    /**
+     * Resolve a private-safe thumbnail URL for a photo (or `undefined` while the
+     * URL is still resolving). The grid measures each photo's intrinsic size from
+     * this URL and re-measures automatically once a pending URL resolves.
+     */
+    getThumbUrl: (photo: FileMetadata) => string | undefined;
     renderJustifiedPhotoItem: (photo: FileMetadata, width: number, height: number, isLast: boolean) => React.ReactElement;
     textColor: string;
     /**

package/lib/typescript/module/ui/components/photogrid/JustifiedPhotoGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JustifiedPhotoGrid.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/photogrid/JustifiedPhotoGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,eAAe,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACtE,mBAAmB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,mBAAmB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,cAAc,EAAE,MAAM,KAAK,YAAY,EAAE,EAAE,CAAC;IAC1F,wBAAwB,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,YAAY,CAAC;IACtH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;;AA0ID,wBAA8C"}
+{"version":3,"file":"JustifiedPhotoGrid.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/photogrid/JustifiedPhotoGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA4ChD,6EAA6E;AAC7E,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,EAAE,CAMpF;AAED,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB;;;;OAIG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD,wBAAwB,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,YAAY,CAAC;IACtH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;;AA0JD,wBAA8C"}

package/lib/typescript/module/ui/components/surfaces/ActionSheetSurface.d.ts

@@ -0,0 +1,38 @@
+import type React from 'react';
+import { type SurfaceControls } from '@oxyhq/bloom/surfaces';
+/**
+ * A single choice in an {@link ActionSheetSurface} — a labelled button that
+ * resolves the surface with `value` when pressed.
+ */
+export interface ActionSheetOption<T extends string> {
+    label: string;
+    value: T;
+    /** Render as a destructive (negative) button. */
+    destructive?: boolean;
+}
+export interface ActionSheetSurfaceProps<T extends string> {
+    /** The presenting surface's controls (from `surfaces.present`). */
+    surface: SurfaceControls;
+    /** Headline. */
+    title: string;
+    /** Optional supporting copy. */
+    message?: string;
+    /** The choices; each dismisses the surface with its `value`. */
+    options: ActionSheetOption<T>[];
+    /** Cancel button label — dismisses with `undefined`. */
+    cancelLabel: string;
+}
+/**
+ * A multi-choice action sheet rendered as a shared-stack surface — the
+ * many-option counterpart to Bloom's two-way `surfaces.confirm`. Each option
+ * button resolves the surface's `present()` promise with that option's `value`;
+ * cancel / backdrop / Escape resolve `undefined`. Presented via
+ * {@link presentActionSheet}.
+ */
+export declare function ActionSheetSurface<T extends string>({ surface, title, message, options, cancelLabel, }: ActionSheetSurfaceProps<T>): React.ReactElement;
+/**
+ * Present an {@link ActionSheetSurface} on the shared stack and resolve with the
+ * chosen option `value`, or `undefined` if cancelled/dismissed.
+ */
+export declare function presentActionSheet<T extends string>(options: Omit<ActionSheetSurfaceProps<T>, 'surface'>): Promise<T | undefined>;
+//# sourceMappingURL=ActionSheetSurface.d.ts.map

package/lib/typescript/module/ui/components/surfaces/ActionSheetSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionSheetSurface.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/components/surfaces/ActionSheetSurface.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM;IACrD,mEAAmE;IACnE,OAAO,EAAE,eAAe,CAAC;IACzB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACvB;AAKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,EACjD,OAAO,EACP,KAAK,EACL,OAAO,EACP,OAAO,EACP,WAAW,GACd,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAuCjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GACrD,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAIxB"}

package/lib/typescript/module/ui/context/OxyContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4D/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,sBAAmB,CAAC;AAY3B,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AAIlF,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAo/BzD,CAAC;AAEF,eAAO,MAAM,kBAAkB,mCAAc,CAAC;AAmE9C,eAAO,MAAM,MAAM,QAAO,eAMzB,CAAC"}
+{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAiE/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,sBAAmB,CAAC;AAY3B,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AAIlF,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAqiCzD,CAAC;AAEF,eAAO,MAAM,kBAAkB,mCAAc,CAAC;AAmE9C,eAAO,MAAM,MAAM,QAAO,eAMzB,CAAC"}

package/lib/typescript/module/ui/hooks/queries/queryKeys.d.ts

@@ -68,6 +68,10 @@ export declare const queryKeys: {
         readonly all: readonly ["storage"];
         readonly usage: (accountScope?: string) => readonly ["storage", "usage", string | undefined];
     };
+    readonly files: {
+        readonly all: readonly ["files"];
+        readonly list: (ownerId?: string) => readonly ["files", "list", string];
+    };
     readonly connectedApps: {
         readonly all: readonly ["connectedApps"];
         readonly list: () => readonly ["connectedApps", "list"];
@@ -125,4 +129,9 @@ export declare const invalidatePaymentsQueries: (queryClient: QueryClient) => vo
  * Helper to invalidate the user's connected-apps list
  */
 export declare const invalidateConnectedAppsQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate the user's file library (all owners). Pass an ownerId via
+ * `queryKeys.files.list(ownerId)` for a scoped invalidation instead.
+ */
+export declare const invalidateFileQueries: (queryClient: QueryClient) => void;
 //# sourceMappingURL=queryKeys.d.ts.map

package/lib/typescript/module/ui/hooks/queries/queryKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,SAAS;;;;oCAKC,MAAM,EAAE;;qCAEP,MAAM;uCACJ,MAAM,GAAG,IAAI;;;;;;iCAWnB,MAAM,EAAE;;kCAEP,MAAM;QACvB,yFAAyF;2CAC/D,MAAM,YAAY,MAAM;QAElD;;;;;WAKG;wCACoB,MAAM,YAAY,MAAM;sCAQ1B,MAAM;;;;;iCAOX,MAAM;;qCAEF,MAAM;;oCAEP,MAAM;;;;;uCAOH,MAAM;;oCAET,MAAM;;;;qCAML,MAAM;;;;oCAMP,MAAM,WAAW,MAAM,cAAc,MAAM;iCAE9C,MAAM;mCAEJ,MAAM,cAAc,MAAM;;;;iCAO5B,MAAM;;;;wCAMC,MAAM;;;;;;;;kCAYZ,MAAM;;;;yCAMC,MAAM;oCAEX,MAAM;mCAEP,MAAM;8CAEK,MAAM,WAAW,MAAM,WAAW,MAAM;;CAU/D,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,WAAW,KAAG,IAEhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,aAAa,WAAW,KAAG,IAElE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,IAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,aAAa,WAAW,KAAG,IAEvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,IAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,WAAW,KAAG,IAEzE,CAAC"}
+{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,SAAS;;;;oCAKC,MAAM,EAAE;;qCAEP,MAAM;uCACJ,MAAM,GAAG,IAAI;;;;;;iCAWnB,MAAM,EAAE;;kCAEP,MAAM;QACvB,yFAAyF;2CAC/D,MAAM,YAAY,MAAM;QAElD;;;;;WAKG;wCACoB,MAAM,YAAY,MAAM;sCAQ1B,MAAM;;;;;iCAOX,MAAM;;qCAEF,MAAM;;oCAEP,MAAM;;;;;uCAOH,MAAM;;oCAET,MAAM;;;;qCAML,MAAM;;;;oCAMP,MAAM,WAAW,MAAM,cAAc,MAAM;iCAE9C,MAAM;mCAEJ,MAAM,cAAc,MAAM;;;;iCAO5B,MAAM;;;;wCAMC,MAAM;;;;kCAOZ,MAAM;;;;;;;;kCAYN,MAAM;;;;yCAMC,MAAM;oCAEX,MAAM;mCAEP,MAAM;8CAEK,MAAM,WAAW,MAAM,WAAW,MAAM;;CAU/D,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,WAAW,KAAG,IAEhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,aAAa,WAAW,KAAG,IAElE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,IAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,aAAa,WAAW,KAAG,IAEvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,IAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,WAAW,KAAG,IAEzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,WAAW,KAAG,IAEhE,CAAC"}

package/lib/typescript/module/ui/hooks/queries/useFileQueries.d.ts

@@ -0,0 +1,50 @@
+/**
+ * User file-library queries + cache helpers.
+ *
+ * The file list is owned by React Query (`useInfiniteQuery`), NOT a zustand
+ * store: server pages live in the query cache, and every optimistic mutation
+ * (upload / delete / visibility) edits that cache via the pure `*InCache`
+ * helpers below. The `queryFn` is side-effect-free — it only fetches and maps a
+ * page. This is what lets the file manager stay effect-free while preserving
+ * infinite scroll, pull-to-refresh, and optimistic upload reconciliation.
+ */
+import { type InfiniteData, type QueryClient } from '@tanstack/react-query';
+import type { FileMetadata } from '@oxyhq/core';
+/** Files fetched per page. */
+export declare const FILES_PAGE_SIZE = 40;
+/** Raw file record as returned by `oxyServices.listUserFiles` / `assetUpload`. */
+export interface RawUserFile {
+    id: string;
+    originalName?: string;
+    sha256?: string;
+    mime?: string;
+    size?: number;
+    createdAt?: string;
+    metadata?: Record<string, unknown>;
+    variants?: unknown[];
+}
+/** One page of the infinite file list. */
+export interface UserFilesPage {
+    files: FileMetadata[];
+    total: number;
+    hasMore: boolean;
+    nextOffset: number;
+}
+export type UserFilesInfinite = InfiniteData<UserFilesPage>;
+/** Normalize a raw API file record into the client `FileMetadata` shape. */
+export declare function mapRawFileToMetadata(raw: RawUserFile): FileMetadata;
+/**
+ * Infinite-paginated list of the owner's files. Fires on mount and whenever
+ * `ownerId` changes (a new key); `staleTime: 0` reloads on every open. The
+ * rendered list is `data.pages.flatMap(p => p.files)`.
+ */
+export declare const useUserFilesInfinite: (ownerId?: string) => import("@tanstack/react-query").UseInfiniteQueryResult<InfiniteData<UserFilesPage, unknown>, Error>;
+/** Prepend an (optimistic) file to the first page. */
+export declare function prependFileToCache(queryClient: QueryClient, ownerId: string | undefined, file: FileMetadata): void;
+/** Remove a file (by id) from every page. */
+export declare function removeFileFromCache(queryClient: QueryClient, ownerId: string | undefined, fileId: string): void;
+/** Swap an optimistic file (by id) for its persisted counterpart. */
+export declare function replaceFileInCache(queryClient: QueryClient, ownerId: string | undefined, oldId: string, newFile: FileMetadata): void;
+/** Shallow-merge a metadata patch into a cached file (e.g. visibility change). */
+export declare function patchFileMetadataInCache(queryClient: QueryClient, ownerId: string | undefined, fileId: string, metadataPatch: Record<string, unknown>): void;
+//# sourceMappingURL=useFileQueries.d.ts.map

package/lib/typescript/module/ui/hooks/queries/useFileQueries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileQueries.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/useFileQueries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEH,KAAK,YAAY,EACjB,KAAK,WAAW,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,8BAA8B;AAC9B,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,kFAAkF;AAClF,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAE5D,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAWnE;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,wGAsBpD,CAAC;AAiBF,sDAAsD;AACtD,wBAAgB,kBAAkB,CAC9B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,YAAY,GACnB,IAAI,CAUN;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,MAAM,GACf,IAAI,CAIN;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAC9B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACtB,IAAI,CAIN;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CACpC,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,IAAI,CAYN"}

package/lib/typescript/module/ui/hooks/useAvatarPicker.d.ts

@@ -1,33 +1,34 @@
 /**
  * Avatar Picker Hook
  *
- * Extracts avatar selection logic from OxyContext for better modularity.
+ * The ONE write path for a user's profile picture. It owns no UI: the whole
+ * choose-and-crop experience is a single surface.
  *
- * Flow:
- *   1. Open the FileManagement bottom sheet in select mode for image files.
- *   2. After the user picks an image, route to the AvatarCrop screen so they
- *      can square-crop + zoom before the avatar is set.
- *   3. The cropped JPEG is uploaded as a NEW file via `oxyServices.assetUpload`
- *      and that file becomes the user's avatar.
+ * Flow (typed promise over the shared surface stack — no callback props):
+ *   1. `openWithinOrPresent('ChangeAvatar')` opens the source list (device gallery,
+ *      camera, existing Oxy files, remove) — MORPHING into the caller's surface
+ *      when one is open, else presenting cold. Whichever source the user picks, it
+ *      navigates WITHIN to the crop editor — so there is exactly one cropper and
+ *      one entry into it.
+ *   2. The surface resolves with the cropped JPEG, with `{ removed: true }` when
+ *      the user removed their photo, or `undefined` when they cancelled.
+ *   3. A crop is uploaded as a NEW file via `oxyServices.assetUpload` and set as
+ *      the avatar; a removal clears the avatar field.
  *
- * `expo-image-manipulator` is required for the crop step (declared as an
- * optional peer in the consuming app) — see AvatarCropScreen.
+ * `expo-image-manipulator` is required for the crop step and `expo-image-picker`
+ * for the device/camera sources (both declared as optional peers in the
+ * consuming app) — see AvatarCropScreen / ChangeAvatarScreen.
  */
 import type { OxyServices } from '@oxyhq/core';
 import type { QueryClient } from '@tanstack/react-query';
-import type { RouteName } from '../navigation/routes.js';
 interface UseAvatarPickerOptions {
     oxyServices: OxyServices;
     currentLanguage: string | null | undefined;
     activeSessionId: string | null;
     queryClient: QueryClient;
-    showBottomSheet: (config: {
-        screen: RouteName;
-        props?: Record<string, unknown>;
-    }) => void;
 }
-export declare function useAvatarPicker({ oxyServices, currentLanguage, activeSessionId, queryClient, showBottomSheet, }: UseAvatarPickerOptions): {
-    openAvatarPicker: () => void;
+export declare function useAvatarPicker({ oxyServices, currentLanguage, activeSessionId, queryClient, }: UseAvatarPickerOptions): {
+    openAvatarPicker: () => Promise<void>;
 };
 export {};
 //# sourceMappingURL=useAvatarPicker.d.ts.map

package/lib/typescript/module/ui/hooks/useAvatarPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAvatarPicker.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useAvatarPicker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAsB,CAAC;AAItD,UAAU,sBAAsB;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CAC3F;AAkBD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,eAAe,EACf,eAAe,EACf,WAAW,EACX,eAAe,GAChB,EAAE,sBAAsB;;EA8GxB"}
+{"version":3,"file":"useAvatarPicker.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useAvatarPicker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMzD,UAAU,sBAAsB;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAkBD,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,eAAe,EACf,eAAe,EACf,WAAW,GACZ,EAAE,sBAAsB;;EA8ExB"}

package/lib/typescript/module/ui/hooks/useReduceMotion.d.ts

@@ -0,0 +1,14 @@
+/**
+ * useReduceMotion
+ *
+ * Reactive boolean reflecting the OS "reduce motion" accessibility preference.
+ * Wraps `AccessibilityInfo` as an external store via `useSyncExternalStore` — the
+ * effect-free, React-Compiler-safe way to read an external mutable source. The
+ * initial value is read asynchronously once (the platform API is a Promise) and
+ * cached module-side; subsequent changes arrive via the `reduceMotionChanged`
+ * event. Mirrors the `useOnlineStatus` pattern.
+ *
+ * Consumers use it to pin entrance/stagger animations off under reduce-motion.
+ */
+export declare function useReduceMotion(): boolean;
+//# sourceMappingURL=useReduceMotion.d.ts.map

package/lib/typescript/module/ui/hooks/useReduceMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReduceMotion.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useReduceMotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4CH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/lib/typescript/module/ui/hooks/useSurfaceHeader.d.ts

@@ -0,0 +1,31 @@
+import type { DialogHeaderConfig } from '@oxyhq/bloom/dialog';
+/**
+ * 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.
+ *
+ * A `right` slot is the canonical place for a screen-state action (e.g. a Save
+ * button whose disabled/loading state reflects the form). Slot nodes MUST be
+ * referentially stable (memoize them with `useMemo`) so the header does not
+ * thrash.
+ */
+export type SurfaceHeaderContent = Pick<DialogHeaderConfig, 'title' | 'titleContent' | 'subtitle' | 'largeTitle' | 'left' | 'right' | 'onBack'>;
+interface SurfaceHeaderContextValue {
+    setContent: (content: SurfaceHeaderContent | null) => void;
+}
+/**
+ * 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 declare const SurfaceHeaderContext: import("react").Context<SurfaceHeaderContextValue | null>;
+/**
+ * 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.
+ */
+export declare function useSurfaceHeader(content: SurfaceHeaderContent | null | undefined): void;
+export {};
+//# sourceMappingURL=useSurfaceHeader.d.ts.map

package/lib/typescript/module/ui/hooks/useSurfaceHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceHeader.d.ts","sourceRoot":"","sources":["../../../../../src/ui/hooks/useSurfaceHeader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,kBAAkB,EAClB,OAAO,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CACnF,CAAC;AAEF,UAAU,yBAAyB;IACjC,UAAU,EAAE,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,2DAAwD,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAoBvF"}

package/lib/typescript/module/ui/hooks/useSwitchableAccounts.d.ts

@@ -13,7 +13,7 @@ export interface UseSwitchableAccountsResult {
  * 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 OxyAccountDialog} renders),
+ * `@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

package/lib/typescript/module/ui/navigation/accountDialogManager.d.ts

@@ -1,13 +1,38 @@
 /**
- * Imperative controls for the unified {@link OxyAccountDialog}.
+ * 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.
  */
 import type { AccountDialogView } from '@oxyhq/core';
-/** Live open/close handles registered by the mounted provider. */
+/**
+ * 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.
+ */
 export interface AccountDialogControls {
     open: (view?: AccountDialogView) => void;
     close: () => void;
 }
+/**
+ * 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.
+ */
+export interface AccountDialogConsumerHooks {
+    onNavigateManage?: () => void;
+    onAddAccount?: () => void;
+    onNavigateProfile?: () => void;
+}
 export declare function registerAccountDialogControls(next: AccountDialogControls): () => void;
+/** Register app-local manage/add/profile handlers for the account dialog. */
+export declare function registerAccountDialogConsumerHooks(next: AccountDialogConsumerHooks | null): () => void;
+export declare function getAccountDialogConsumerHooks(): AccountDialogConsumerHooks | null;
 /** Open the account dialog on `view` (default `accounts`). No-op before mount. */
 export declare function openAccountDialog(view?: AccountDialogView): void;
 /** Close the account dialog. No-op before mount. */

package/lib/typescript/module/ui/navigation/accountDialogManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accountDialogManager.d.ts","sourceRoot":"","sources":["../../../../../src/ui/navigation/accountDialogManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAKD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAOrF;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAEhE;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,sFAAsF;AACtF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAIpE;AAED,sDAAsD;AACtD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAKzF"}
+{"version":3,"file":"accountDialogManager.d.ts","sourceRoot":"","sources":["../../../../../src/ui/navigation/accountDialogManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAMD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAOrF;AAED,6EAA6E;AAC7E,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,0BAA0B,GAAG,IAAI,GACtC,MAAM,IAAI,CAOZ;AAED,wBAAgB,6BAA6B,IAAI,0BAA0B,GAAG,IAAI,CAEjF;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAEhE;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,sFAAsF;AACtF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAIpE;AAED,sDAAsD;AACtD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAKzF"}