@oxyhq/bloom 0.33.0 → 0.34.0

package/lib/module/zoomable-image-gallery/constants.js

@@ -35,4 +35,19 @@ export const SNAP_BACK_SPRING = {
 
 /** Default corner radius for the zoomed images — Bloom's `radius-12` token. */
 export const DEFAULT_CORNER_RADIUS = RADIUS['radius-12'];
+
+/** Minimum pinch-zoom scale of the active image (its un-zoomed size). */
+export const MIN_ZOOM_SCALE = 1;
+/** Maximum pinch-zoom scale of the active image. */
+export const MAX_ZOOM_SCALE = 3;
+/** Below this final pinch scale, the zoom snaps back to 1 (treated as un-zoomed). */
+export const ZOOM_SNAP_THRESHOLD = 1.1;
+/** Scale a double-tap zooms the active image to when it is currently un-zoomed. */
+export const DOUBLE_TAP_ZOOM_SCALE = 2;
+/** Fraction of finger travel applied while panning a zoomed image. */
+export const ZOOM_PAN_DAMPING = 0.8;
+/** Base clamp (px, multiplied by the current zoom) bounding a zoomed image's pan. */
+export const ZOOM_PAN_MAX_BASE = 100;
+/** Edge length (px) of each tile in the `thumbnails` indicator variant. */
+export const THUMBNAIL_STRIP_TILE_SIZE = 52;
 //# sourceMappingURL=constants.js.map

package/lib/module/zoomable-image-gallery/constants.js.map

@@ -1 +1 @@
-{"version":3,"names":["RADIUS","FIT_FRACTION","MAX_DRAG_FRACTION","SCALE_DRAG_FRACTION","MIN_DRAG_SCALE","DISMISS_FRACTION","AXIS_DECISION_OFFSET","OPEN_DURATION_WEB","CLOSE_DURATION_WEB","OPACITY_DURATION","OPEN_SPRING","damping","stiffness","mass","CLOSE_SPRING","SNAP_BACK_SPRING","DEFAULT_CORNER_RADIUS"],"sourceRoot":"../../../src","sources":["zoomable-image-gallery/constants.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,2BAAkB;;AAEzC;AACA,OAAO,MAAMC,YAAY,GAAG,GAAG;AAC/B;AACA,OAAO,MAAMC,iBAAiB,GAAG,GAAG;AACpC;AACA,OAAO,MAAMC,mBAAmB,GAAG,GAAG;AACtC;AACA,OAAO,MAAMC,cAAc,GAAG,GAAG;AACjC;AACA,OAAO,MAAMC,gBAAgB,GAAG,IAAI;AACpC;AACA,OAAO,MAAMC,oBAAoB,GAAG,EAAE;AAEtC,OAAO,MAAMC,iBAAiB,GAAG,GAAG;AACpC,OAAO,MAAMC,kBAAkB,GAAG,GAAG;AACrC,OAAO,MAAMC,gBAAgB,GAAG,GAAG;AAEnC,OAAO,MAAMC,WAAW,GAAG;EAAEC,OAAO,EAAE,EAAE;EAAEC,SAAS,EAAE,GAAG;EAAEC,IAAI,EAAE;AAAI,CAAU;AAC9E,OAAO,MAAMC,YAAY,GAAG;EAAEH,OAAO,EAAE,EAAE;EAAEC,SAAS,EAAE,GAAG;EAAEC,IAAI,EAAE;AAAK,CAAU;AAChF,OAAO,MAAME,gBAAgB,GAAG;EAAEJ,OAAO,EAAE,EAAE;EAAEC,SAAS,EAAE,GAAG;EAAEC,IAAI,EAAE;AAAI,CAAU;;AAEnF;AACA,OAAO,MAAMG,qBAAqB,GAAGhB,MAAM,CAAC,WAAW,CAAC","ignoreList":[]}
+{"version":3,"names":["RADIUS","FIT_FRACTION","MAX_DRAG_FRACTION","SCALE_DRAG_FRACTION","MIN_DRAG_SCALE","DISMISS_FRACTION","AXIS_DECISION_OFFSET","OPEN_DURATION_WEB","CLOSE_DURATION_WEB","OPACITY_DURATION","OPEN_SPRING","damping","stiffness","mass","CLOSE_SPRING","SNAP_BACK_SPRING","DEFAULT_CORNER_RADIUS","MIN_ZOOM_SCALE","MAX_ZOOM_SCALE","ZOOM_SNAP_THRESHOLD","DOUBLE_TAP_ZOOM_SCALE","ZOOM_PAN_DAMPING","ZOOM_PAN_MAX_BASE","THUMBNAIL_STRIP_TILE_SIZE"],"sourceRoot":"../../../src","sources":["zoomable-image-gallery/constants.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,2BAAkB;;AAEzC;AACA,OAAO,MAAMC,YAAY,GAAG,GAAG;AAC/B;AACA,OAAO,MAAMC,iBAAiB,GAAG,GAAG;AACpC;AACA,OAAO,MAAMC,mBAAmB,GAAG,GAAG;AACtC;AACA,OAAO,MAAMC,cAAc,GAAG,GAAG;AACjC;AACA,OAAO,MAAMC,gBAAgB,GAAG,IAAI;AACpC;AACA,OAAO,MAAMC,oBAAoB,GAAG,EAAE;AAEtC,OAAO,MAAMC,iBAAiB,GAAG,GAAG;AACpC,OAAO,MAAMC,kBAAkB,GAAG,GAAG;AACrC,OAAO,MAAMC,gBAAgB,GAAG,GAAG;AAEnC,OAAO,MAAMC,WAAW,GAAG;EAAEC,OAAO,EAAE,EAAE;EAAEC,SAAS,EAAE,GAAG;EAAEC,IAAI,EAAE;AAAI,CAAU;AAC9E,OAAO,MAAMC,YAAY,GAAG;EAAEH,OAAO,EAAE,EAAE;EAAEC,SAAS,EAAE,GAAG;EAAEC,IAAI,EAAE;AAAK,CAAU;AAChF,OAAO,MAAME,gBAAgB,GAAG;EAAEJ,OAAO,EAAE,EAAE;EAAEC,SAAS,EAAE,GAAG;EAAEC,IAAI,EAAE;AAAI,CAAU;;AAEnF;AACA,OAAO,MAAMG,qBAAqB,GAAGhB,MAAM,CAAC,WAAW,CAAC;;AAExD;AACA,OAAO,MAAMiB,cAAc,GAAG,CAAC;AAC/B;AACA,OAAO,MAAMC,cAAc,GAAG,CAAC;AAC/B;AACA,OAAO,MAAMC,mBAAmB,GAAG,GAAG;AACtC;AACA,OAAO,MAAMC,qBAAqB,GAAG,CAAC;AACtC;AACA,OAAO,MAAMC,gBAAgB,GAAG,GAAG;AACnC;AACA,OAAO,MAAMC,iBAAiB,GAAG,GAAG;AACpC;AACA,OAAO,MAAMC,yBAAyB,GAAG,EAAE","ignoreList":[]}

package/lib/module/zoomable-image-gallery/index.js

@@ -1,4 +1,5 @@
 "use strict";
 
 export { ZoomableImageGallery, ZoomableImageGallery as default } from "./ZoomableImageGallery.js";
+export * from "./constants.js";
 //# sourceMappingURL=index.js.map

package/lib/module/zoomable-image-gallery/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ZoomableImageGallery","default"],"sourceRoot":"../../../src","sources":["zoomable-image-gallery/index.ts"],"mappings":";;AAAA,SAASA,oBAAoB,EAAEA,oBAAoB,IAAIC,OAAO,QAAQ,2BAAwB","ignoreList":[]}
+{"version":3,"names":["ZoomableImageGallery","default"],"sourceRoot":"../../../src","sources":["zoomable-image-gallery/index.ts"],"mappings":";;AAAA,SAASA,oBAAoB,EAAEA,oBAAoB,IAAIC,OAAO,QAAQ,2BAAwB;AAQ9F,cAAc,gBAAa","ignoreList":[]}

package/lib/typescript/commonjs/command/Command.d.ts

@@ -12,6 +12,20 @@ type DialogComponent = React.ComponentType<DialogProps>;
  * `SearchInput`, an `Item` results list and `Kbd` shortcut hints. Items group
  * by their `group` field (ungrouped first). On web the list is
  * keyboard-navigable (Up/Down/Enter); on native, tap to select.
+ *
+ * Control mode — IMPERATIVE, not controlled. `Command` keeps its public
+ * *controlled* API (`visible` boolean + `onClose`) but internally bridges it
+ * onto the Dialog's imperative `useDialogControl()` handle, exactly like
+ * `AlertDialog`. This makes `Command` the LAST controlled-`open` `Dialog`
+ * consumer to move onto the imperative path every other surface uses
+ * (`alert()`, `confirm()`, native `Menu`/`Select`/`ContextMenu`, Mention's
+ * dialogs), so there is one code path across the ecosystem. It also guarantees
+ * the palette's exit animation on the dismiss path even for a consumer that
+ * unmounts the palette in response to `onClose` (`{open && <Command …/>}`): the
+ * imperative `close()` runs the exit animation FIRST and fires `onClose` only
+ * once it settles, whereas the controlled `open` path fires `onClose`
+ * synchronously — which, for an unmount-on-close consumer, would tear the
+ * surface down before it could animate out.
  */
 export declare function createCommand(Dialog: DialogComponent): {
     ({ visible, onClose, items, placeholder, emptyText, query: queryProp, onQueryChange, filter, maxListHeight, style, testID, }: CommandProps): import("react/jsx-runtime").JSX.Element;

package/lib/typescript/commonjs/command/Command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../../src/command/Command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAgBtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAqBxD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe;kIAahD,YAAY;;EA2LhB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../../src/command/Command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAgBjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAqBxD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe;kIAahD,YAAY;;EA2NhB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/lib/typescript/commonjs/zoomable-image-gallery/ZoomableImageGallery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZoomableImageGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/ZoomableImageGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAmDtE,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAwhBjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AAsG9D,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ZoomableImageGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/ZoomableImageGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAiEjF,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAy1BjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AAwK9D,eAAe,oBAAoB,CAAC"}

package/lib/typescript/commonjs/zoomable-image-gallery/constants.d.ts

@@ -30,4 +30,18 @@ export declare const SNAP_BACK_SPRING: {
 };
 /** Default corner radius for the zoomed images — Bloom's `radius-12` token. */
 export declare const DEFAULT_CORNER_RADIUS: 12;
+/** Minimum pinch-zoom scale of the active image (its un-zoomed size). */
+export declare const MIN_ZOOM_SCALE = 1;
+/** Maximum pinch-zoom scale of the active image. */
+export declare const MAX_ZOOM_SCALE = 3;
+/** Below this final pinch scale, the zoom snaps back to 1 (treated as un-zoomed). */
+export declare const ZOOM_SNAP_THRESHOLD = 1.1;
+/** Scale a double-tap zooms the active image to when it is currently un-zoomed. */
+export declare const DOUBLE_TAP_ZOOM_SCALE = 2;
+/** Fraction of finger travel applied while panning a zoomed image. */
+export declare const ZOOM_PAN_DAMPING = 0.8;
+/** Base clamp (px, multiplied by the current zoom) bounding a zoomed image's pan. */
+export declare const ZOOM_PAN_MAX_BASE = 100;
+/** Edge length (px) of each tile in the `thumbnails` indicator variant. */
+export declare const THUMBNAIL_STRIP_TILE_SIZE = 52;
 //# sourceMappingURL=constants.d.ts.map

package/lib/typescript/commonjs/zoomable-image-gallery/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/constants.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,uDAAuD;AACvD,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,WAAW;;;;CAAsD,CAAC;AAC/E,eAAO,MAAM,YAAY;;;;CAAuD,CAAC;AACjF,eAAO,MAAM,gBAAgB;;;;CAAsD,CAAC;AAEpF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,IAAsB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/constants.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,uDAAuD;AACvD,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,WAAW;;;;CAAsD,CAAC;AAC/E,eAAO,MAAM,YAAY;;;;CAAuD,CAAC;AACjF,eAAO,MAAM,gBAAgB;;;;CAAsD,CAAC;AAEpF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,IAAsB,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,oDAAoD;AACpD,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,KAAK,CAAC"}

package/lib/typescript/commonjs/zoomable-image-gallery/index.d.ts

@@ -1,3 +1,4 @@
 export { ZoomableImageGallery, ZoomableImageGallery as default } from './ZoomableImageGallery';
 export type { ZoomableImageGalleryHandle, ZoomableImageGalleryProps, GalleryImage, MeasureThumb, MeasuredRect, } from './types';
+export * from './constants';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/zoomable-image-gallery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/F,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/F,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,cAAc,aAAa,CAAC"}

package/lib/typescript/commonjs/zoomable-image-gallery/types.d.ts

@@ -42,5 +42,11 @@ export interface ZoomableImageGalleryProps {
     measureThumb?: MeasureThumb;
     /** Corner radius applied to the zoomed images. Defaults to `DEFAULT_CORNER_RADIUS`. */
     cornerRadius?: number;
+    /**
+     * Bottom page indicator for multi-image galleries. `'dots'` (default) renders the
+     * compact dot row; `'thumbnails'` renders a horizontal strip of tappable image
+     * tiles. The counter pill shows in both. Ignored for single-image galleries.
+     */
+    indicatorVariant?: 'dots' | 'thumbnails';
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/zoomable-image-gallery/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC1C"}

package/lib/typescript/module/command/Command.d.ts

@@ -12,6 +12,20 @@ type DialogComponent = React.ComponentType<DialogProps>;
  * `SearchInput`, an `Item` results list and `Kbd` shortcut hints. Items group
  * by their `group` field (ungrouped first). On web the list is
  * keyboard-navigable (Up/Down/Enter); on native, tap to select.
+ *
+ * Control mode — IMPERATIVE, not controlled. `Command` keeps its public
+ * *controlled* API (`visible` boolean + `onClose`) but internally bridges it
+ * onto the Dialog's imperative `useDialogControl()` handle, exactly like
+ * `AlertDialog`. This makes `Command` the LAST controlled-`open` `Dialog`
+ * consumer to move onto the imperative path every other surface uses
+ * (`alert()`, `confirm()`, native `Menu`/`Select`/`ContextMenu`, Mention's
+ * dialogs), so there is one code path across the ecosystem. It also guarantees
+ * the palette's exit animation on the dismiss path even for a consumer that
+ * unmounts the palette in response to `onClose` (`{open && <Command …/>}`): the
+ * imperative `close()` runs the exit animation FIRST and fires `onClose` only
+ * once it settles, whereas the controlled `open` path fires `onClose`
+ * synchronously — which, for an unmount-on-close consumer, would tear the
+ * surface down before it could animate out.
  */
 export declare function createCommand(Dialog: DialogComponent): {
     ({ visible, onClose, items, placeholder, emptyText, query: queryProp, onQueryChange, filter, maxListHeight, style, testID, }: CommandProps): import("react/jsx-runtime").JSX.Element;

package/lib/typescript/module/command/Command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../../src/command/Command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAgBtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAqBxD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe;kIAahD,YAAY;;EA2LhB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../../src/command/Command.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAgBjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;AAqBxD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe;kIAahD,YAAY;;EA2NhB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/lib/typescript/module/zoomable-image-gallery/ZoomableImageGallery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZoomableImageGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/ZoomableImageGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAmDtE,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAwhBjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AAsG9D,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ZoomableImageGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/ZoomableImageGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAiEjF,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAy1BjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AAwK9D,eAAe,oBAAoB,CAAC"}

package/lib/typescript/module/zoomable-image-gallery/constants.d.ts

@@ -30,4 +30,18 @@ export declare const SNAP_BACK_SPRING: {
 };
 /** Default corner radius for the zoomed images — Bloom's `radius-12` token. */
 export declare const DEFAULT_CORNER_RADIUS: 12;
+/** Minimum pinch-zoom scale of the active image (its un-zoomed size). */
+export declare const MIN_ZOOM_SCALE = 1;
+/** Maximum pinch-zoom scale of the active image. */
+export declare const MAX_ZOOM_SCALE = 3;
+/** Below this final pinch scale, the zoom snaps back to 1 (treated as un-zoomed). */
+export declare const ZOOM_SNAP_THRESHOLD = 1.1;
+/** Scale a double-tap zooms the active image to when it is currently un-zoomed. */
+export declare const DOUBLE_TAP_ZOOM_SCALE = 2;
+/** Fraction of finger travel applied while panning a zoomed image. */
+export declare const ZOOM_PAN_DAMPING = 0.8;
+/** Base clamp (px, multiplied by the current zoom) bounding a zoomed image's pan. */
+export declare const ZOOM_PAN_MAX_BASE = 100;
+/** Edge length (px) of each tile in the `thumbnails` indicator variant. */
+export declare const THUMBNAIL_STRIP_TILE_SIZE = 52;
 //# sourceMappingURL=constants.d.ts.map

package/lib/typescript/module/zoomable-image-gallery/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/constants.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,uDAAuD;AACvD,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,WAAW;;;;CAAsD,CAAC;AAC/E,eAAO,MAAM,YAAY;;;;CAAuD,CAAC;AACjF,eAAO,MAAM,gBAAgB;;;;CAAsD,CAAC;AAEpF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,IAAsB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/constants.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,uDAAuD;AACvD,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,eAAO,MAAM,WAAW;;;;CAAsD,CAAC;AAC/E,eAAO,MAAM,YAAY;;;;CAAuD,CAAC;AACjF,eAAO,MAAM,gBAAgB;;;;CAAsD,CAAC;AAEpF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,IAAsB,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,oDAAoD;AACpD,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,KAAK,CAAC"}

package/lib/typescript/module/zoomable-image-gallery/index.d.ts

@@ -1,3 +1,4 @@
 export { ZoomableImageGallery, ZoomableImageGallery as default } from './ZoomableImageGallery';
 export type { ZoomableImageGalleryHandle, ZoomableImageGalleryProps, GalleryImage, MeasureThumb, MeasuredRect, } from './types';
+export * from './constants';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/zoomable-image-gallery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/F,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC/F,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,cAAc,aAAa,CAAC"}

package/lib/typescript/module/zoomable-image-gallery/types.d.ts

@@ -42,5 +42,11 @@ export interface ZoomableImageGalleryProps {
     measureThumb?: MeasureThumb;
     /** Corner radius applied to the zoomed images. Defaults to `DEFAULT_CORNER_RADIUS`. */
     cornerRadius?: number;
+    /**
+     * Bottom page indicator for multi-image galleries. `'dots'` (default) renders the
+     * compact dot row; `'thumbnails'` renders a horizontal strip of tappable image
+     * tiles. The counter pill shows in both. Ignored for single-image galleries.
+     */
+    indicatorVariant?: 'dots' | 'thumbnails';
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/zoomable-image-gallery/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CAC1C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/src/__tests__/Command.test.tsx

@@ -1,8 +1,10 @@
-import React from 'react';
+import React, { useImperativeHandle } from 'react';
 import { act, fireEvent, render } from '@testing-library/react-native';
 
 import { Command } from '../command';
+import { createCommand } from '../command/Command';
 import type { CommandItem } from '../command';
+import type { DialogProps } from '../dialog';
 import { BloomThemeProvider } from '../theme/BloomThemeProvider';
 
 function renderWithTheme(ui: React.ReactElement) {
@@ -104,4 +106,123 @@ describe('Command (built on Dialog)', () => {
     expect(onSelect).toHaveBeenCalledTimes(1);
     expect(onClose).toHaveBeenCalledTimes(1);
   });
+
+  // The migration off the controlled `open` prop onto the imperative `control`
+  // handle (making `Command` the last controlled-mode `Dialog` consumer to move
+  // over). These pin the fix at the prop boundary between `Command` and the
+  // underlying `Dialog`, using a prop-capturing mock `Dialog` so the assertions
+  // are deterministic and platform-agnostic — mirroring `AlertDialog`'s round.
+  describe('control-mode bridge', () => {
+    function captureDialogProps() {
+      const captured: { props?: DialogProps } = {};
+      const MockDialog = (props: DialogProps) => {
+        captured.props = props;
+        return null;
+      };
+      return { captured, MockDialog };
+    }
+
+    it('drives the underlying Dialog imperatively (control), never the controlled `open` prop', () => {
+      const { captured, MockDialog } = captureDialogProps();
+      const TestCommand = createCommand(MockDialog);
+      renderWithTheme(
+        <TestCommand visible onClose={() => {}} items={makeItems(() => {})} />,
+      );
+      // The whole point of the migration: `Command` must take the Dialog's
+      // imperative/uncontrolled branch (the one that plays the exit animation on
+      // dismiss), so an imperative `control` handle is passed and the controlled
+      // `open` boolean — which fires `onClose` synchronously — is never set.
+      expect(captured.props?.control).toBeDefined();
+      expect(captured.props?.open).toBeUndefined();
+    });
+
+    // A mock Dialog that registers the real imperative contract on `control.ref`
+    // (so `Command`'s `control.open()` / `control.close()` proxy through it) and
+    // fires `onClose` when imperatively closed — modelling the real Dialog,
+    // which invokes `onClose` only AFTER its exit animation settles.
+    function ImperativeMockDialog(props: DialogProps) {
+      const onCloseRef = React.useRef(props.onClose);
+      onCloseRef.current = props.onClose;
+      useImperativeHandle(
+        props.control?.ref,
+        () => ({
+          open: () => {},
+          // The real Dialog fires `onClose` post-exit-animation.
+          close: () => onCloseRef.current?.(),
+        }),
+        [],
+      );
+      return null;
+    }
+
+    it('opens the Dialog imperatively on mount when visible, and closes it when visible flips false', () => {
+      const spies = { open: jest.fn(), close: jest.fn() };
+      const MockDialog = (props: DialogProps) => {
+        useImperativeHandle(props.control?.ref, () => spies, []);
+        return null;
+      };
+      const TestCommand = createCommand(MockDialog);
+      const { rerender } = renderWithTheme(
+        <TestCommand visible onClose={() => {}} items={makeItems(() => {})} />,
+      );
+      expect(spies.open).toHaveBeenCalledTimes(1);
+      expect(spies.close).not.toHaveBeenCalled();
+
+      act(() => {
+        rerender(
+          <BloomThemeProvider mode="light" colorPreset="teal">
+            <TestCommand
+              visible={false}
+              onClose={() => {}}
+              items={makeItems(() => {})}
+            />
+          </BloomThemeProvider>,
+        );
+      });
+      expect(spies.close).toHaveBeenCalledTimes(1);
+    });
+
+    it('forwards a user dismissal (backdrop / Escape) through onClose', () => {
+      const spyRef: { fn?: () => void } = {};
+      const MockDialog = (props: DialogProps) => {
+        spyRef.fn = props.onClose;
+        return null;
+      };
+      const onClose = jest.fn();
+      const TestCommand = createCommand(MockDialog);
+      renderWithTheme(
+        <TestCommand visible onClose={onClose} items={makeItems(() => {})} />,
+      );
+      // The real Dialog fires `onClose` once its exit animation settles after a
+      // backdrop / Escape dismissal. `Command` must forward that to the consumer.
+      act(() => {
+        spyRef.fn?.();
+      });
+      expect(onClose).toHaveBeenCalledTimes(1);
+    });
+
+    it('does not re-enter onClose when the consumer closes it (visible → false)', () => {
+      const onClose = jest.fn();
+      const TestCommand = createCommand(ImperativeMockDialog);
+      const { rerender } = renderWithTheme(
+        <TestCommand visible onClose={onClose} items={makeItems(() => {})} />,
+      );
+      act(() => {
+        rerender(
+          <BloomThemeProvider mode="light" colorPreset="teal">
+            <TestCommand
+              visible={false}
+              onClose={onClose}
+              items={makeItems(() => {})}
+            />
+          </BloomThemeProvider>,
+        );
+      });
+      // A consumer-initiated close flips `visible` to false → `Command`
+      // imperatively `close()`s the Dialog (which fires its post-exit `onClose`).
+      // That programmatic close must NOT re-enter the consumer's `onClose`,
+      // preserving the previous controlled semantics.
+      expect(onClose).not.toHaveBeenCalled();
+    });
+  });
 });

package/src/command/Command.tsx

@@ -1,4 +1,4 @@
-import React, { useCallback, useMemo, useRef, useState } from 'react';
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import {
   Platform,
   ScrollView,
@@ -15,6 +15,7 @@ import { Kbd } from '../kbd';
 import { SearchInput } from '../search-input';
 import { fontSize, space } from '../styles/tokens';
 import type { DialogProps } from '../dialog';
+import { useDialogControl } from '../dialog/context';
 import type { CommandItem, CommandProps } from './types';
 
 type DialogComponent = React.ComponentType<DialogProps>;
@@ -48,6 +49,20 @@ interface FlatEntry {
  * `SearchInput`, an `Item` results list and `Kbd` shortcut hints. Items group
  * by their `group` field (ungrouped first). On web the list is
  * keyboard-navigable (Up/Down/Enter); on native, tap to select.
+ *
+ * Control mode — IMPERATIVE, not controlled. `Command` keeps its public
+ * *controlled* API (`visible` boolean + `onClose`) but internally bridges it
+ * onto the Dialog's imperative `useDialogControl()` handle, exactly like
+ * `AlertDialog`. This makes `Command` the LAST controlled-`open` `Dialog`
+ * consumer to move onto the imperative path every other surface uses
+ * (`alert()`, `confirm()`, native `Menu`/`Select`/`ContextMenu`, Mention's
+ * dialogs), so there is one code path across the ecosystem. It also guarantees
+ * the palette's exit animation on the dismiss path even for a consumer that
+ * unmounts the palette in response to `onClose` (`{open && <Command …/>}`): the
+ * imperative `close()` runs the exit animation FIRST and fires `onClose` only
+ * once it settles, whereas the controlled `open` path fires `onClose`
+ * synchronously — which, for an unmount-on-close consumer, would tear the
+ * surface down before it could animate out.
  */
 export function createCommand(Dialog: DialogComponent) {
   const Command = function Command({
@@ -64,6 +79,7 @@ export function createCommand(Dialog: DialogComponent) {
     testID,
   }: CommandProps) {
     const theme = useTheme();
+    const control = useDialogControl();
     const searchRef = useRef<TextInput>(null);
     const [activeIndex, setActiveIndex] = useState(0);
 
@@ -142,6 +158,37 @@ export function createCommand(Dialog: DialogComponent) {
     [setQuery, onClose],
   );
 
+  // Bridge the public *controlled* `visible` prop onto the Dialog's imperative
+  // open/close (mirrors `AlertDialog`). `control` is referentially stable
+  // (memoised on its id), so this effect only re-runs when `visible` actually
+  // flips. Opening straight from an effect on mount matches bloom's own
+  // `AutoMountedDialog`. When a consumer flips `visible` to `false` (their own
+  // close, or after a select), we imperatively `close()` so the exit animation
+  // still plays.
+  const closingFromPropRef = useRef(false);
+  useEffect(() => {
+    if (visible) {
+      control.open();
+      return;
+    }
+    closingFromPropRef.current = true;
+    control.close();
+  }, [visible, control]);
+
+  // The Dialog fires `onClose` after the exit animation settles (imperative
+  // mode). Forward ONLY user-initiated dismissals (backdrop / Escape) to the
+  // consumer — a consumer-initiated close (they flipped `visible` to `false`,
+  // e.g. `select` already called `onClose`) must not re-enter `onClose`,
+  // preserving the previous controlled semantics where a programmatic close
+  // does not fire `onClose` a second time.
+  const handleClose = useCallback(() => {
+    if (closingFromPropRef.current) {
+      closingFromPropRef.current = false;
+      return;
+    }
+    onClose();
+  }, [onClose]);
+
   // Web keyboard navigation on the search input.
   const webKeyHandler: Record<string, unknown> =
     Platform.OS === 'web'
@@ -172,8 +219,8 @@ export function createCommand(Dialog: DialogComponent) {
 
   return (
     <Dialog
-      open={visible}
-      onClose={onClose}
+      control={control}
+      onClose={handleClose}
       placement="center"
       dismissOnBackdrop
       maxWidth={COMMAND_MAX_WIDTH}