@oxy.so/bloom 4.18.0 → 4.19.0

package/lib/typescript/module/rating/Rating.d.ts

@@ -2,9 +2,17 @@ import React from 'react';
 import type { RatingProps } from './types';
 /** 5 → "5.0", 4.9 → "4.9", 4.923 → "4.92". */
 export declare function formatRatingValue(value: number | string): string;
+/**
+ * The number a drawn rating value stands for, for the `stars` fill: a number
+ * is itself; a string is read after dropping bidi/format characters, with a
+ * comma or Arabic decimal separator (U+066B) accepted as the decimal point and
+ * Arabic-Indic digits accepted — so "4,5" wrapped in FSI…PDI is 4.5. Otherwise it is
+ * `Number()`'s reading, so anything unreadable is `NaN` (no fill).
+ */
+export declare function parseRatingValue(value: number | string): number;
 /** How much of star `index` (0-based) a rating fills, `0..1`. */
 export declare function starFill(rating: number, index: number): number;
-declare function RatingComponent({ value, count, countStyle, reviewsLabel, newLabel, size, variant, color, starColor, countColor, emptyStarColor, accessibilityLabel, style, testID, }: RatingProps): import("react/jsx-runtime").JSX.Element;
+declare function RatingComponent({ value, count, countStyle, reviewsLabel, newLabel, size, variant, color, starColor, countColor, emptyStarColor, fillValue, accessibilityLabel, style, testID, }: RatingProps): import("react/jsx-runtime").JSX.Element;
 export declare const Rating: React.MemoExoticComponent<typeof RatingComponent>;
 export {};
 //# sourceMappingURL=Rating.d.ts.map

package/lib/typescript/module/rating/Rating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Rating.d.ts","sourceRoot":"","sources":["../../../../src/rating/Rating.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAQpC,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,SAAS,CAAC;AAiCvD,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIhE;AAQD,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D;AA6CD,iBAAS,eAAe,CAAC,EACvB,KAAK,EACL,KAAK,EACL,UAA0B,EAC1B,YAAwB,EACxB,QAAgB,EAChB,IAAe,EACf,OAAmB,EACnB,KAAK,EACL,SAAS,EACT,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,KAAK,EACL,MAAM,GACP,EAAE,WAAW,2CAmDb;AAED,eAAO,MAAM,MAAM,mDAAwB,CAAC"}
+{"version":3,"file":"Rating.d.ts","sourceRoot":"","sources":["../../../../src/rating/Rating.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAQpC,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,SAAS,CAAC;AAkCvD,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIhE;AAkBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAS/D;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D;AAkDD,iBAAS,eAAe,CAAC,EACvB,KAAK,EACL,KAAK,EACL,UAA0B,EAC1B,YAAwB,EACxB,QAAgB,EAChB,IAAe,EACf,OAAmB,EACnB,KAAK,EACL,SAAS,EACT,UAAU,EACV,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,KAAK,EACL,MAAM,GACP,EAAE,WAAW,2CAmDb;AAED,eAAO,MAAM,MAAM,mDAAwB,CAAC"}

package/lib/typescript/module/rating/types.d.ts

@@ -40,6 +40,15 @@ export interface RatingProps {
     countColor?: string;
     /** `stars` variant: the unfilled part of each star. Default the theme's border colour. */
     emptyStarColor?: string;
+    /**
+     * `stars` variant: the number the stars are filled to, clamped to `0..5`,
+     * independent of the drawn `value`. Pass it with a localised `value` string
+     * (`value="4,5"` with `fillValue={4.5}`) so the text follows the locale and
+     * the fill does not depend on parsing it. Without it a string `value` is
+     * parsed (bidi marks dropped, a comma decimal accepted). Ignored by
+     * `compact` and while there is no rating (`value` empty).
+     */
+    fillValue?: number;
     /**
      * Overrides the composed accessible name ("Rated 4.92 out of 5, 128
      * reviews"), which is English — pass a translated sentence here.

package/lib/typescript/module/rating/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/rating/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sFAAsF;IACtF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iFAAiF;IACjF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/rating/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5C,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,SAAS,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,sFAAsF;IACtF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iFAAiF;IACjF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/lib/typescript/module/search/Search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../../../../src/search/Search.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAQ,MAAM,cAAc,CAAC;AAM9D,OAAO,EAA4C,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAYnG,eAAO,MAAM,MAAM;YAPT,mBAAmB,CAAC,OAAO,CAAC;IACpC;;OAEG;kBACW,MAAM,IAAI;6CAyDzB,CAAC"}
+{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../../../../src/search/Search.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAQ,MAAM,cAAc,CAAC;AAQ9D,OAAO,EAA4C,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAYnG,eAAO,MAAM,MAAM;YAPT,mBAAmB,CAAC,OAAO,CAAC;IACpC;;OAEG;kBACW,MAAM,IAAI;6CA6FzB,CAAC"}

package/lib/typescript/module/select/types.d.ts

@@ -33,6 +33,13 @@ export type SelectTriggerProps = {
     /**
      * Utility classes APPENDED to the part's own — never substituted for them, so
      * a single layout class cannot strip the chrome.
+     *
+     * Never pin a HEIGHT here (`h-8`). The value's line box is 20 × the system
+     * font scale, and on native Yoga measures the text at most as tall as the
+     * space left inside the field: a fixed height cuts the glyphs in half on
+     * Android (OxyHQ/Mention#1126 — `h-8` is 28dp there, leaving 15.5dp for a
+     * 20dp line). Size a compact trigger with its padding (`fieldStyle`) so the
+     * text sets the height.
      */
     className?: string;
     /**

package/lib/typescript/module/select/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/select/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/select/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7D,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC;IAC/C;;;;;OAKG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IACpB,oEAAoE;IACpE,UAAU,EAAE,CACV,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,KAC1B,KAAK,CAAC,YAAY,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC"}

package/lib/typescript/module/settings-modal/SettingsModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsModal.d.ts","sourceRoot":"","sources":["../../../../src/settings-modal/SettingsModal.tsx"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,kBAAkB,EAAqC,MAAM,SAAS,CAAC;AAmFrF,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,IAAI,EAAE,cAAc,EACpB,OAAO,EACP,aAAa,EACb,MAAM,EACN,KAAK,EACL,IAAI,EAAE,cAAc,EACpB,WAAW,EACX,YAAY,EACZ,WAA0B,EAC1B,MAAM,EACN,MAAM,GACP,EAAE,kBAAkB,kDAiWpB"}
+{"version":3,"file":"SettingsModal.d.ts","sourceRoot":"","sources":["../../../../src/settings-modal/SettingsModal.tsx"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,kBAAkB,EAAqC,MAAM,SAAS,CAAC;AAmFrF,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,IAAI,EAAE,cAAc,EACpB,OAAO,EACP,aAAa,EACb,MAAM,EACN,KAAK,EACL,IAAI,EAAE,cAAc,EACpB,WAAW,EACX,YAAY,EACZ,WAA0B,EAC1B,MAAM,EACN,MAAM,GACP,EAAE,kBAAkB,kDA4VpB"}

package/lib/typescript/module/teleport/PortalHost.d.ts

@@ -14,7 +14,7 @@ import type { PortalHostProps } from "./types";
  * export default function App() {
  *   return (
  *     <PortalProvider>
- *        <PortalHost style={StyleSheet.absoluteFillObject} name="overlay" />
+ *        <PortalHost style={StyleSheet.absoluteFill} name="overlay" />
  *     </PortalProvider>
  *   );
  * }

package/lib/typescript/module/zoomable-media-gallery/ZoomableMediaGallery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZoomableMediaGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-media-gallery/ZoomableMediaGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6E,MAAM,OAAO,CAAC;AAkElG,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAkkCjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AAgL9D,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ZoomableMediaGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-media-gallery/ZoomableMediaGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6E,MAAM,OAAO,CAAC;AAmElG,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AA0lCjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AA4K9D,eAAe,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/bloom",
-  "version": "4.18.0",
+  "version": "4.19.0",
   "packageManager": "bun@1.3.14",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",

package/src/bottom-sheet/BottomSheet.web.tsx

@@ -32,8 +32,12 @@ function WebShell({ children }: BottomSheetShellProps) {
             {/* `OverlayRoot` owns the portal-root pointer-events opt-in (see
                 `src/overlay`). It used to ride in the style array below as an
                 RN-only box-none value, which never reached the DOM — the whole
-                sheet, backdrop included, was click-through on web. */}
-            <OverlayRoot style={webStyles.rootView}>
+                sheet, backdrop included, was click-through on web. `modal`:
+                the sheet dims and blocks the page, so the app's
+                `OverlayInertBoundary` makes that page inert while it is open.
+                (Native needs no flag — its shell is an RN `Modal`, a separate
+                window the screen reader is already confined to.) */}
+            <OverlayRoot style={webStyles.rootView} modal>
                 <GestureHandlerRootView style={StyleSheet.absoluteFill}>
                     {children}
                 </GestureHandlerRootView>

package/src/chat-list/parts.tsx

@@ -64,7 +64,7 @@ export function RowLink({
   };
   const interactive = Boolean(onPress || href || onLongPress);
   const style: WebCssStyle = {
-    ...StyleSheet.absoluteFillObject,
+    ...StyleSheet.absoluteFill,
     borderRadius: CHAT_ROW_RADIUS,
     '--bloom-chat-ring': paint.ring,
   };

package/src/chat-screen/ChatBackground.tsx

@@ -44,9 +44,9 @@ function PatternLayer({
     <View
       pointerEvents="none"
       testID="chat-background-pattern"
-      style={StyleSheet.absoluteFillObject}
+      style={StyleSheet.absoluteFill}
     >
-      <Svg style={StyleSheet.absoluteFillObject} width="100%" height="100%">
+      <Svg style={StyleSheet.absoluteFill} width="100%" height="100%">
         <Defs>
           <Pattern
             id={id}
@@ -83,9 +83,9 @@ function GradientLayer({ colors }: { colors: string[] }) {
     <View
       pointerEvents="none"
       testID="chat-background-gradient"
-      style={StyleSheet.absoluteFillObject}
+      style={StyleSheet.absoluteFill}
     >
-      <Svg style={StyleSheet.absoluteFillObject} width="100%" height="100%">
+      <Svg style={StyleSheet.absoluteFill} width="100%" height="100%">
         <Defs>
           <LinearGradient id={id} x1="0" y1="0" x2="0.35" y2="1">
             {colors.map((color, i) => (
@@ -159,13 +159,13 @@ function ChatBackgroundComponent({
             accessibilityElementsHidden
             importantForAccessibility="no-hide-descendants"
             testID="chat-background-image"
-            style={StyleSheet.absoluteFillObject}
+            style={StyleSheet.absoluteFill}
           />
           <View
             pointerEvents="none"
             testID="chat-background-dim"
             style={[
-              StyleSheet.absoluteFillObject,
+              StyleSheet.absoluteFill,
               { backgroundColor: paint.imageDim, opacity: dim },
             ]}
           />

package/src/dialog/Dialog.tsx

@@ -546,7 +546,15 @@ function SideSheet({
   return (
     // `OverlayRoot` takes this drawer's place in the open-order overlay stack.
     // It mounts here, past the `mounted` guard, so the rank tracks OPENING.
-    <OverlayRoot style={[sideStyles.root, containerStyle]} className={containerClassName}>
+    // `onRequestClose`: the drawer is not an RN `Modal`, so Android back would
+    // otherwise pass straight to the screen behind it. A drawer that refuses
+    // backdrop dismissal still swallows the press, and stays open.
+    <OverlayRoot
+      style={[sideStyles.root, containerStyle]}
+      className={containerClassName}
+      onRequestClose={handleBackdropPress}
+      modal
+    >
       <Backdrop
         testID={testID ? `${testID}-backdrop` : DIALOG_SHEET_BACKDROP_TESTID}
         accessibilityLabel={label ? `Dismiss ${label}` : 'Dismiss dialog'}

package/src/dialog/Dialog.web.tsx

@@ -144,7 +144,8 @@ function useDialogCss(): void {
  * Accessibility: the panel has `role="dialog"` and the `title`/`description`
  * props (when provided) become the `aria-labelledby` / `aria-describedby`
  * targets. Pressing the backdrop dismisses. Pressing `Escape` dismisses.
- * Focus is locked inside the dialog while it's open.
+ * While it is open the page behind is `inert` — provided the app wraps its
+ * content in `OverlayInertBoundary` (`OverlayRoot modal` below registers it).
  *
  * Web motion never uses reanimated `exiting` (which throws `removeChild` on
  * concurrent React unmounts): the centered card uses CSS keyframes and the
@@ -354,8 +355,10 @@ function CenterOrSideDialog({
                 overlay stack. It mounts here, inside the `isOpen` guard, which
                 is what makes the rank track OPENING rather than mounting — the
                 dialog is declared once at the app root and stays mounted for
-                the app's lifetime. */}
-            <OverlayRoot>
+                the app's lifetime. `modal` makes the app's
+                `OverlayInertBoundary` take the page out of the tab order and
+                the accessibility tree while it is open. */}
+            <OverlayRoot modal>
               {/* The press target IS the full-viewport box, so it uses
                   `Backdrop` (which opts back in from the Portal root's
                   `pointer-events: none` via the `pointerEvents` PROP — the style
@@ -746,7 +749,7 @@ function SheetSurface({
   );
 
   return (
-    <OverlayRoot style={[sheetStyles.root, containerStyle]} className={containerClassName}>
+    <OverlayRoot style={[sheetStyles.root, containerStyle]} className={containerClassName} modal>
       <Backdrop
         testID={testID ? `${testID}-backdrop` : DIALOG_SHEET_BACKDROP_TESTID}
         accessibilityLabel={label ? `Dismiss ${label}` : 'Dismiss dialog'}

package/src/index.ts

@@ -106,6 +106,7 @@ export {
   Backdrop,
   useOverlayLayer,
   useOverlayLayerContext,
+  useModalOverlayActive,
   layerForRank,
   BACKDROP_BLUR_INTENSITY,
   BACKDROP_DIM_OPACITY,

package/src/index.web.ts

@@ -111,6 +111,7 @@ export {
   Backdrop,
   useOverlayLayer,
   useOverlayLayerContext,
+  useModalOverlayActive,
   layerForRank,
   BACKDROP_BLUR_INTENSITY,
   BACKDROP_DIM_OPACITY,

package/src/location-puck/LocationPuck.tsx

@@ -81,7 +81,7 @@ const PULSE_SCALE = 0.18;
 
 /** One full-size layer that centres whatever it holds on the box's centre. */
 const layerStyle: ViewStyle = {
-  ...StyleSheet.absoluteFillObject,
+  ...StyleSheet.absoluteFill,
   alignItems: 'center',
   justifyContent: 'center',
 };

package/src/mail-list/parts.tsx

@@ -77,7 +77,7 @@ export function MailRowLink({
   };
   const interactive = Boolean(onPress || href || onLongPress);
   const style: WebCssStyle = {
-    ...StyleSheet.absoluteFillObject,
+    ...StyleSheet.absoluteFill,
     borderRadius: MAIL_ROW_RADIUS,
     '--bloom-mail-ring': paint.accent,
   };

package/src/media-card/parts.tsx

@@ -287,7 +287,7 @@ export function CardLink({ name, onPress, href, onLongPress, selected = false, r
     if (!IS_WEB && href) void Linking.openURL(href).catch(() => undefined);
   };
   const style: WebCssStyle = {
-    ...StyleSheet.absoluteFillObject,
+    ...StyleSheet.absoluteFill,
     borderRadius: radius,
     '--bloom-media-card-ring': paint.ring,
   };

package/src/overlay/Overlay.tsx

@@ -57,6 +57,8 @@ import { WEB_POSITION_FIXED } from '../styles/web-view-style';
 import { StyledView } from '../styles/styled-primitives';
 import { SurfaceLevelProvider } from '../styles/surface-levels';
 import { layerForRank, type OverlayLayer } from './stack';
+import { useHardwareBack } from './use-hardware-back';
+import { useModalOverlayRegistration } from './use-modal-overlay-active';
 import { useOverlayLayer } from './use-overlay-layer';
 import type { OverlayRootProps, BackdropProps } from './types';
 
@@ -109,32 +111,43 @@ export const BACKDROP_DIM_OPACITY = 0.28;
  * every Bloom surface already puts it. Descendants that need to order
  * themselves within the surface read `useOverlayLayerContext()`.
  */
-export function OverlayRoot({ children, className, style, testID, zIndex }: OverlayRootProps) {
+export function OverlayRoot({
+  children,
+  className,
+  style,
+  testID,
+  zIndex,
+  onRequestClose,
+  modal = false,
+}: OverlayRootProps) {
+  // On the root rather than in each surface: every portaled surface mounts one
+  // inside its open guard, so this is the one place that cannot be forgotten.
+  // The gallery once forgot it and Android back finished the whole activity.
+  useHardwareBack(onRequestClose);
   // Split into two components rather than branching on the hook: a pinned root
   // must not CONSUME a rank either. The toast host is pinned and mounts for the
   // whole life of the app, so holding a rank would keep the live set permanently
   // non-empty — the counter would never reset and depths would climb for the
   // rest of the session.
   return zIndex === undefined ? (
-    <StackedOverlayRoot className={className} style={style} testID={testID}>
+    <StackedOverlayRoot className={className} style={style} testID={testID} modal={modal}>
       {children}
     </StackedOverlayRoot>
   ) : (
-    <PinnedOverlayRoot zIndex={zIndex} className={className} style={style} testID={testID}>
+    <PinnedOverlayRoot zIndex={zIndex} className={className} style={style} testID={testID} modal={modal}>
       {children}
     </PinnedOverlayRoot>
   );
 }
 
-function StackedOverlayRoot({
-  children,
-  className,
-  style,
-  testID,
-}: Omit<OverlayRootProps, 'zIndex'>) {
+type OverlayRootViewProps = Pick<OverlayRootProps, 'children' | 'className' | 'style' | 'testID'> & {
+  modal: boolean;
+};
+
+function StackedOverlayRoot({ children, className, style, testID, modal }: OverlayRootViewProps) {
   const layer = useOverlayLayer();
   return (
-    <OverlayRootView layer={layer} className={className} style={style} testID={testID}>
+    <OverlayRootView layer={layer} className={className} style={style} testID={testID} modal={modal}>
       {children}
     </OverlayRootView>
   );
@@ -146,7 +159,8 @@ function PinnedOverlayRoot({
   style,
   testID,
   zIndex,
-}: OverlayRootProps & { zIndex: number }) {
+  modal,
+}: OverlayRootViewProps & { zIndex: number }) {
   // Outside the stack, so descendants must not read stack depths from it
   // either — every slot is the pinned depth.
   const layer = useMemo(
@@ -154,7 +168,7 @@ function PinnedOverlayRoot({
     [zIndex],
   );
   return (
-    <OverlayRootView layer={layer} className={className} style={style} testID={testID}>
+    <OverlayRootView layer={layer} className={className} style={style} testID={testID} modal={modal}>
       {children}
     </OverlayRootView>
   );
@@ -166,14 +180,22 @@ function OverlayRootView({
   style,
   testID,
   layer,
-}: Omit<OverlayRootProps, 'zIndex'> & { layer: OverlayLayer }) {
+  modal,
+}: OverlayRootViewProps & { layer: OverlayLayer }) {
+  // Android cannot confine TalkBack from this side of the outlet — the app's
+  // `OverlayInertBoundary` hides the content once it hears a modal is open.
+  useModalOverlayRegistration(modal);
   return (
     <OverlayLayerContext.Provider value={layer}>
       {/* `pointerEvents` stays a PROP: react-native-web resolves the RN-only
           `box-none` from the prop path only, and as a style entry it is silently
-          dropped — which makes the whole portaled surface click-through. */}
+          dropped — which makes the whole portaled surface click-through.
+          `accessibilityViewIsModal` sits HERE, not on the panel: iOS hides only
+          the modal view's SIBLINGS, and at the native outlet this root is the
+          sibling of the app content, where the panel is not. */}
       <StyledView
         pointerEvents="box-none"
+        accessibilityViewIsModal={modal && Platform.OS !== 'web' ? true : undefined}
         className={className}
         style={[styles.root, { zIndex: layer.root }, style]}
         testID={testID}

package/src/overlay/OverlayInertBoundary.tsx

@@ -0,0 +1,72 @@
+/**
+ * `OverlayInertBoundary` — the app content's half of a modal overlay.
+ *
+ * A modal Bloom surface renders at the portal outlet, which is the app
+ * content's SIBLING. It can mark itself modal (`accessibilityViewIsModal`, which
+ * iOS honours by hiding the siblings), but it cannot hide the app on Android:
+ * TalkBack only skips a subtree whose OWN root says
+ * `importantForAccessibility="no-hide-descendants"`, and that root belongs to
+ * the app. Without it, TalkBack walked from the settings modal straight into
+ * the Home feed behind it (OxyHQ/Mention#1126).
+ *
+ * The app wraps its content — everything that is NOT the `PortalOutlet` — in
+ * this boundary. While any modal overlay is open (`./modal-registry.ts`) it
+ * takes that content out of the accessibility tree:
+ *
+ *   - Android: `importantForAccessibility="no-hide-descendants"`.
+ *   - iOS: `accessibilityElementsHidden`, alongside the surface's own
+ *     `accessibilityViewIsModal` (either alone is enough; both costs nothing).
+ *   - Web: `inert`, which removes the subtree from the tab order AND the
+ *     accessibility tree, plus `aria-hidden` for engines that lag on `inert`.
+ *     The web portal root is a child of `document.body`, never of the app
+ *     root, so the surface itself is untouched. Web dialogs set no focus trap
+ *     of their own, so nothing is applied twice.
+ *
+ * Layout: on web the boundary is `display: contents`, so it generates no box
+ * and a document-scrolling page lays out exactly as without it. On native it is
+ * a `flex: 1` view — the content it wraps already fills the root there — and it
+ * is never collapsed, because flattening a layout-only view would drop the
+ * accessibility prop the moment it is needed.
+ */
+import { Platform, StyleSheet, View } from 'react-native';
+
+import type { OverlayInertBoundaryProps } from './types';
+import { useModalOverlayActive } from './use-modal-overlay-active';
+
+export function OverlayInertBoundary({ children, style, testID }: OverlayInertBoundaryProps) {
+  const active = useModalOverlayActive();
+
+  if (Platform.OS === 'web') {
+    return (
+      <View
+        testID={testID}
+        style={[styles.web, style]}
+        aria-hidden={active ? true : undefined}
+        {...(active ? { inert: true } : null)}
+      >
+        {children}
+      </View>
+    );
+  }
+
+  return (
+    <View
+      testID={testID}
+      collapsable={false}
+      style={[styles.native, style]}
+      importantForAccessibility={active ? 'no-hide-descendants' : 'auto'}
+      accessibilityElementsHidden={active}
+    >
+      {children}
+    </View>
+  );
+}
+
+OverlayInertBoundary.displayName = 'OverlayInertBoundary';
+
+const styles = StyleSheet.create({
+  native: { flex: 1 },
+  // No box of its own on web: the wrapped content lays out against the
+  // boundary's parent, flex tree or document scroll alike.
+  web: { display: 'contents' },
+});

package/src/overlay/index.ts

@@ -7,6 +7,8 @@ export {
   type OverlayLayer,
 } from './stack';
 export { useOverlayLayer } from './use-overlay-layer';
+export { useModalOverlayActive } from './use-modal-overlay-active';
+export { OverlayInertBoundary } from './OverlayInertBoundary';
 export {
   useOverlayLayerContext,
   BACKDROP_BLUR_INTENSITY,
@@ -14,4 +16,4 @@ export {
   OverlayRoot,
   Backdrop,
 } from './Overlay';
-export type { OverlayRootProps, BackdropProps } from './types';
+export type { OverlayRootProps, BackdropProps, OverlayInertBoundaryProps } from './types';

package/src/overlay/modal-registry.ts

@@ -0,0 +1,101 @@
+/**
+ * Which MODAL overlays are open right now, as a subscribable store.
+ *
+ * ## Why this exists
+ *
+ * A modal surface has to keep a screen reader inside it. iOS can do that from
+ * the overlay's side: `accessibilityViewIsModal` on the `OverlayRoot` hides its
+ * siblings, and at the native portal outlet the app content IS a sibling.
+ * Android has no equivalent. TalkBack keeps walking into the app behind the
+ * open surface (OxyHQ/Mention#1126: the Home feed stayed reachable under the
+ * settings modal), and the only switch that stops it —
+ * `importantForAccessibility="no-hide-descendants"` — has to sit ON the app
+ * content. A portaled surface cannot reach that view: the outlet renders it as
+ * the content's sibling, not its ancestor.
+ *
+ * So the knowledge travels the other way. Every `OverlayRoot` with `modal`
+ * registers here while it is mounted, and `OverlayInertBoundary` — which the
+ * app wraps around its own content — subscribes and hides what it wraps while
+ * anything modal is open.
+ *
+ * Non-modal overlays (menus, popovers, tooltips, toasts, the shell drawers)
+ * never register: the content under an anchored menu must stay reachable.
+ *
+ * Tokens rather than a counter so StrictMode's mount/unmount/remount and an
+ * unmatched release can never drift the count: a token is either in the set or
+ * not.
+ */
+
+interface ModalRegistry {
+  live: Set<object>;
+  listeners: Set<() => void>;
+}
+
+declare global {
+  // eslint-disable-next-line no-var
+  var __oxy_so_bloom_modal_overlays__: ModalRegistry | undefined;
+}
+
+/**
+ * `globalThis`-anchored for the same reason as `./stack.ts`: the surfaces that
+ * register (`./dialog`, `./settings-modal`, …) and the boundary the app mounts
+ * (`./portal`) are imported through different subpaths, and a bundler can
+ * resolve those through different export conditions. Two physical copies of
+ * this module would each keep their own set, and the boundary would never hear
+ * about the surfaces.
+ */
+function registry(): ModalRegistry {
+  globalThis.__oxy_so_bloom_modal_overlays__ ??= { live: new Set(), listeners: new Set() };
+  return globalThis.__oxy_so_bloom_modal_overlays__;
+}
+
+function notify(reg: ModalRegistry): void {
+  for (const listener of Array.from(reg.listeners)) listener();
+}
+
+/**
+ * Mark a modal overlay as open. Returns its release. Called from an effect in
+ * `OverlayRoot`, which React balances even under StrictMode.
+ */
+export function registerModalOverlay(token: object): () => void {
+  const reg = registry();
+  const wasActive = reg.live.size > 0;
+  reg.live.add(token);
+  if (!wasActive) notify(reg);
+  return () => {
+    const current = registry();
+    if (!current.live.delete(token)) return;
+    if (current.live.size === 0) notify(current);
+  };
+}
+
+/** Whether any modal overlay is open. */
+export function hasActiveModalOverlays(): boolean {
+  return registry().live.size > 0;
+}
+
+/** How many modal overlays are open. Exported for tests. */
+export function activeModalOverlayCount(): number {
+  return registry().live.size;
+}
+
+/**
+ * Subscribe to changes in `hasActiveModalOverlays()`. Listeners fire only when
+ * the answer flips — a second modal opening over a first changes nothing for
+ * the content underneath.
+ */
+export function subscribeModalOverlays(listener: () => void): () => void {
+  const reg = registry();
+  reg.listeners.add(listener);
+  return () => {
+    registry().listeners.delete(listener);
+  };
+}
+
+/** Test seam — drops all open modals, notifying current subscribers. */
+export function resetModalOverlays(): void {
+  const reg = registry();
+  const wasActive = reg.live.size > 0;
+  reg.live.clear();
+  if (wasActive) notify(reg);
+}

package/src/overlay/types.ts

@@ -23,6 +23,43 @@ export interface OverlayRootProps {
    * `./stack.ts` exists to remove.
    */
   zIndex?: number;
+  /**
+   * Android hardware back while this surface is open. A portaled surface is not
+   * an RN `Modal`, so nothing else consumes the press: without this the app's
+   * own back handling runs and, at the root of a stack, finishes the activity —
+   * the surface "closes" by closing the whole app. Called and consumed while the
+   * root is mounted; later-opened surfaces register later, and `BackHandler`
+   * runs the newest listener first, so the top surface closes first. A blocking
+   * surface still passes a handler (a no-op) so the press is swallowed rather
+   * than falling through to the screen underneath.
+   */
+  onRequestClose?: () => void;
+  /**
+   * The surface is modal: a screen reader must not wander into the app behind
+   * it. Two effects:
+   *
+   *  - Native: sets `accessibilityViewIsModal` on this root, which is the app
+   *    content's sibling at the portal outlet (iOS confines VoiceOver to it).
+   *  - Every platform: registers the surface as an open modal while mounted
+   *    (`./modal-registry.ts`), so the app's `OverlayInertBoundary` hides the
+   *    content behind it — the only way to confine TalkBack on Android, and
+   *    what makes the content `inert` on web.
+   *
+   * Dialogs, sheets, the settings modal and the media viewer set it; anchored
+   * surfaces (menus, popovers, tooltips), toasts and the shell drawers do not.
+   */
+  modal?: boolean;
+}
+
+export interface OverlayInertBoundaryProps {
+  /** The app's own content — everything EXCEPT the `PortalOutlet`. */
+  children?: ReactNode;
+  /**
+   * Native only (web renders no box). Defaults to `flex: 1`; override when the
+   * boundary's parent is not a column that the content should fill.
+   */
+  style?: StyleProp<ViewStyle>;
+  testID?: string;
 }
 
 export interface BackdropProps {