@oxyhq/bloom 0.89.0 → 1.0.0

package/lib/typescript/module/user-hover-card/types.d.ts

@@ -38,6 +38,22 @@ export interface UserHoverCardProps {
      * Bloom does NOT implement follow logic; it only renders the card.
      */
     action?: ReactNode;
+    /**
+     * Trailing content region, rendered after the stats row and spanning the full
+     * inner width — the slot for whatever this app knows about a person that Bloom
+     * does not (a contribution graph, a shared-followers strip, a mutual-friends
+     * line). Bloom adds the vertical rhythm and nothing else: no label, no divider,
+     * no clip.
+     *
+     * It is a SIBLING of the identity area, never a child, so its own pressables
+     * keep their presses instead of feeding {@link UserHoverCardProps.onPressProfile}
+     * — and a screen reader reads it as content, not as part of the identity
+     * button's name.
+     *
+     * The card is 280px wide with `space.lg` padding, so content has ~248px of
+     * inner width; the card does not clip, so anything wider paints outside it.
+     */
+    footer?: ReactNode;
     /** Container style override. */
     style?: StyleProp<ViewStyle>;
     testID?: string;

package/lib/typescript/module/user-hover-card/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/user-hover-card/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/user-hover-card/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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,KAA6E,MAAM,OAAO,CAAC;AAmElG,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AA87BjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AA0K9D,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ZoomableImageGallery.d.ts","sourceRoot":"","sources":["../../../../src/zoomable-image-gallery/ZoomableImageGallery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6E,MAAM,OAAO,CAAC;AAkElG,OAAO,KAAK,EAGV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AA6/BjB,eAAO,MAAM,oBAAoB,8GAA4B,CAAC;AA0K9D,eAAe,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "0.89.0",
+  "version": "1.0.0",
   "packageManager": "bun@1.3.14",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",
@@ -35,7 +35,7 @@
     "./provider": {
       "react-native": {
         "types": "./lib/typescript/module/provider/index.d.ts",
-        "default": "./src/provider/index.tsx"
+        "default": "./src/provider/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/provider/index.d.ts",
@@ -98,6 +98,11 @@
         "types": "./lib/typescript/module/theme/index.d.ts",
         "default": "./src/theme/index.ts"
       },
+      "browser": {
+        "types": "./lib/typescript/module/theme/index.web.d.ts",
+        "import": "./lib/module/theme/index.web.js",
+        "require": "./lib/commonjs/theme/index.web.js"
+      },
       "import": {
         "types": "./lib/typescript/module/theme/index.d.ts",
         "default": "./lib/module/theme/index.js"
@@ -166,7 +171,7 @@
     "./portal": {
       "react-native": {
         "types": "./lib/typescript/module/portal/index.d.ts",
-        "default": "./src/portal/index.tsx"
+        "default": "./src/portal/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/portal/index.web.d.ts",
@@ -185,7 +190,7 @@
     "./connection-status": {
       "react-native": {
         "types": "./lib/typescript/module/connection-status/index.d.ts",
-        "default": "./src/connection-status/index.tsx"
+        "default": "./src/connection-status/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/connection-status/index.web.d.ts",
@@ -204,7 +209,7 @@
     "./overlay": {
       "react-native": {
         "types": "./lib/typescript/module/overlay/index.d.ts",
-        "default": "./src/overlay/index.tsx"
+        "default": "./src/overlay/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/overlay/index.d.ts",
@@ -291,20 +296,6 @@
         "default": "./lib/commonjs/frosted-icon-button/index.js"
       }
     },
-    "./grouped-buttons": {
-      "react-native": {
-        "types": "./lib/typescript/module/grouped-buttons/index.d.ts",
-        "default": "./src/grouped-buttons/index.ts"
-      },
-      "import": {
-        "types": "./lib/typescript/module/grouped-buttons/index.d.ts",
-        "default": "./lib/module/grouped-buttons/index.js"
-      },
-      "require": {
-        "types": "./lib/typescript/commonjs/grouped-buttons/index.d.ts",
-        "default": "./lib/commonjs/grouped-buttons/index.js"
-      }
-    },
     "./divider": {
       "react-native": {
         "types": "./lib/typescript/module/divider/index.d.ts",
@@ -333,18 +324,18 @@
         "default": "./lib/commonjs/radio-indicator/index.js"
       }
     },
-    "./collapsible": {
+    "./radio": {
       "react-native": {
-        "types": "./lib/typescript/module/collapsible/index.d.ts",
-        "default": "./src/collapsible/index.ts"
+        "types": "./lib/typescript/module/radio/index.d.ts",
+        "default": "./src/radio/index.ts"
       },
       "import": {
-        "types": "./lib/typescript/module/collapsible/index.d.ts",
-        "default": "./lib/module/collapsible/index.js"
+        "types": "./lib/typescript/module/radio/index.d.ts",
+        "default": "./lib/module/radio/index.js"
       },
       "require": {
-        "types": "./lib/typescript/commonjs/collapsible/index.d.ts",
-        "default": "./lib/commonjs/collapsible/index.js"
+        "types": "./lib/typescript/commonjs/radio/index.d.ts",
+        "default": "./lib/commonjs/radio/index.js"
       }
     },
     "./error-boundary": {
@@ -446,6 +437,11 @@
         "types": "./lib/typescript/module/prompt-input/index.d.ts",
         "default": "./src/prompt-input/index.ts"
       },
+      "browser": {
+        "types": "./lib/typescript/module/prompt-input/index.web.d.ts",
+        "import": "./lib/module/prompt-input/index.web.js",
+        "require": "./lib/commonjs/prompt-input/index.web.js"
+      },
       "import": {
         "types": "./lib/typescript/module/prompt-input/index.d.ts",
         "default": "./lib/module/prompt-input/index.js"
@@ -458,7 +454,7 @@
     "./toast": {
       "react-native": {
         "types": "./lib/typescript/module/toast/index.d.ts",
-        "default": "./src/toast/index.tsx"
+        "default": "./src/toast/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/toast/index.d.ts",
@@ -514,7 +510,7 @@
     "./typography": {
       "react-native": {
         "types": "./lib/typescript/module/typography/index.d.ts",
-        "default": "./src/typography/index.tsx"
+        "default": "./src/typography/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/typography/index.d.ts",
@@ -528,7 +524,7 @@
     "./skeleton": {
       "react-native": {
         "types": "./lib/typescript/module/skeleton/index.d.ts",
-        "default": "./src/skeleton/index.tsx"
+        "default": "./src/skeleton/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/skeleton/index.d.ts",
@@ -542,7 +538,7 @@
     "./grid": {
       "react-native": {
         "types": "./lib/typescript/module/grid/index.d.ts",
-        "default": "./src/grid/index.tsx"
+        "default": "./src/grid/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/grid/index.d.ts",
@@ -556,7 +552,7 @@
     "./fill": {
       "react-native": {
         "types": "./lib/typescript/module/fill/index.d.ts",
-        "default": "./src/fill/index.tsx"
+        "default": "./src/fill/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/fill/index.d.ts",
@@ -609,20 +605,6 @@
         "default": "./lib/commonjs/pressable-scale/index.js"
       }
     },
-    "./pressable-with-hover": {
-      "react-native": {
-        "types": "./lib/typescript/module/pressable-with-hover/index.d.ts",
-        "default": "./src/pressable-with-hover/index.ts"
-      },
-      "import": {
-        "types": "./lib/typescript/module/pressable-with-hover/index.d.ts",
-        "default": "./lib/module/pressable-with-hover/index.js"
-      },
-      "require": {
-        "types": "./lib/typescript/commonjs/pressable-with-hover/index.d.ts",
-        "default": "./lib/commonjs/pressable-with-hover/index.js"
-      }
-    },
     "./subtle-hover": {
       "react-native": {
         "types": "./lib/typescript/module/subtle-hover/index.d.ts",
@@ -673,7 +655,7 @@
     "./icon-circle": {
       "react-native": {
         "types": "./lib/typescript/module/icon-circle/index.d.ts",
-        "default": "./src/icon-circle/index.tsx"
+        "default": "./src/icon-circle/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/icon-circle/index.d.ts",
@@ -776,7 +758,7 @@
     "./benefit-list": {
       "react-native": {
         "types": "./lib/typescript/module/benefit-list/index.d.ts",
-        "default": "./src/benefit-list/index.tsx"
+        "default": "./src/benefit-list/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/benefit-list/index.d.ts",
@@ -790,7 +772,7 @@
     "./text-field": {
       "react-native": {
         "types": "./lib/typescript/module/text-field/index.d.ts",
-        "default": "./src/text-field/index.tsx"
+        "default": "./src/text-field/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/text-field/index.d.ts",
@@ -804,7 +786,7 @@
     "./segmented-control": {
       "react-native": {
         "types": "./lib/typescript/module/segmented-control/index.d.ts",
-        "default": "./src/segmented-control/index.tsx"
+        "default": "./src/segmented-control/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/segmented-control/index.d.ts",
@@ -818,7 +800,7 @@
     "./search": {
       "react-native": {
         "types": "./lib/typescript/module/search/index.d.ts",
-        "default": "./src/search/index.tsx"
+        "default": "./src/search/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/search/index.d.ts",
@@ -832,7 +814,7 @@
     "./admonition": {
       "react-native": {
         "types": "./lib/typescript/module/admonition/index.d.ts",
-        "default": "./src/admonition/index.tsx"
+        "default": "./src/admonition/index.ts"
       },
       "import": {
         "types": "./lib/typescript/module/admonition/index.d.ts",
@@ -843,29 +825,29 @@
         "default": "./lib/commonjs/admonition/index.js"
       }
     },
-    "./menu": {
+    "./dropdown-menu": {
       "react-native": {
-        "types": "./lib/typescript/module/menu/index.d.ts",
-        "default": "./src/menu/index.tsx"
+        "types": "./lib/typescript/module/dropdown-menu/index.d.ts",
+        "default": "./src/dropdown-menu/index.ts"
       },
       "browser": {
-        "types": "./lib/typescript/module/menu/index.web.d.ts",
-        "import": "./lib/module/menu/index.web.js",
-        "require": "./lib/commonjs/menu/index.web.js"
+        "types": "./lib/typescript/module/dropdown-menu/index.web.d.ts",
+        "import": "./lib/module/dropdown-menu/index.web.js",
+        "require": "./lib/commonjs/dropdown-menu/index.web.js"
       },
       "import": {
-        "types": "./lib/typescript/module/menu/index.d.ts",
-        "default": "./lib/module/menu/index.js"
+        "types": "./lib/typescript/module/dropdown-menu/index.d.ts",
+        "default": "./lib/module/dropdown-menu/index.js"
       },
       "require": {
-        "types": "./lib/typescript/commonjs/menu/index.d.ts",
-        "default": "./lib/commonjs/menu/index.js"
+        "types": "./lib/typescript/commonjs/dropdown-menu/index.d.ts",
+        "default": "./lib/commonjs/dropdown-menu/index.js"
       }
     },
     "./tooltip": {
       "react-native": {
         "types": "./lib/typescript/module/tooltip/index.d.ts",
-        "default": "./src/tooltip/index.tsx"
+        "default": "./src/tooltip/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/tooltip/index.web.d.ts",
@@ -884,7 +866,7 @@
     "./select": {
       "react-native": {
         "types": "./lib/typescript/module/select/index.d.ts",
-        "default": "./src/select/index.tsx"
+        "default": "./src/select/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/select/index.web.d.ts",
@@ -903,7 +885,7 @@
     "./bottom-sheet": {
       "react-native": {
         "types": "./lib/typescript/module/bottom-sheet/index.d.ts",
-        "default": "./src/bottom-sheet/index.tsx"
+        "default": "./src/bottom-sheet/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/bottom-sheet/index.web.d.ts",
@@ -922,7 +904,7 @@
     "./context-menu": {
       "react-native": {
         "types": "./lib/typescript/module/context-menu/index.d.ts",
-        "default": "./src/context-menu/index.tsx"
+        "default": "./src/context-menu/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/context-menu/index.web.d.ts",
@@ -938,10 +920,29 @@
         "default": "./lib/commonjs/context-menu/index.js"
       }
     },
+    "./menubar": {
+      "react-native": {
+        "types": "./lib/typescript/module/menubar/index.d.ts",
+        "default": "./src/menubar/index.ts"
+      },
+      "browser": {
+        "types": "./lib/typescript/module/menubar/index.web.d.ts",
+        "import": "./lib/module/menubar/index.web.js",
+        "require": "./lib/commonjs/menubar/index.web.js"
+      },
+      "import": {
+        "types": "./lib/typescript/module/menubar/index.d.ts",
+        "default": "./lib/module/menubar/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/menubar/index.d.ts",
+        "default": "./lib/commonjs/menubar/index.js"
+      }
+    },
     "./popover": {
       "react-native": {
         "types": "./lib/typescript/module/popover/index.d.ts",
-        "default": "./src/popover/index.tsx"
+        "default": "./src/popover/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/popover/index.web.d.ts",
@@ -957,6 +958,20 @@
         "default": "./lib/commonjs/popover/index.js"
       }
     },
+    "./aspect-ratio": {
+      "react-native": {
+        "types": "./lib/typescript/module/aspect-ratio/index.d.ts",
+        "default": "./src/aspect-ratio/index.ts"
+      },
+      "import": {
+        "types": "./lib/typescript/module/aspect-ratio/index.d.ts",
+        "default": "./lib/module/aspect-ratio/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/aspect-ratio/index.d.ts",
+        "default": "./lib/commonjs/aspect-ratio/index.js"
+      }
+    },
     "./alert-dialog": {
       "react-native": {
         "types": "./lib/typescript/module/alert-dialog/index.d.ts",
@@ -1298,7 +1313,7 @@
     "./content-panel": {
       "react-native": {
         "types": "./lib/typescript/module/content-panel/index.d.ts",
-        "default": "./src/content-panel/index.tsx"
+        "default": "./src/content-panel/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/content-panel/index.web.d.ts",
@@ -1317,7 +1332,7 @@
     "./list": {
       "react-native": {
         "types": "./lib/typescript/module/list/index.d.ts",
-        "default": "./src/list/index.tsx"
+        "default": "./src/list/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/list/index.web.d.ts",
@@ -1369,7 +1384,7 @@
     "./progressive-blur": {
       "react-native": {
         "types": "./lib/typescript/module/progressive-blur/index.d.ts",
-        "default": "./src/progressive-blur/index.tsx"
+        "default": "./src/progressive-blur/index.ts"
       },
       "browser": {
         "types": "./lib/typescript/module/progressive-blur/index.web.d.ts",
@@ -1392,7 +1407,12 @@
   "files": [
     "src",
     "lib",
-    "NOTICE"
+    "!**/__tests__/**",
+    "!**/__fixtures__/**",
+    "!**/__mocks__/**",
+    "!**/*.stories.*",
+    "!**/*.test.*",
+    "!**/*.spec.*"
   ],
   "keywords": [
     "react-native",
@@ -1409,7 +1429,6 @@
     "user-hover-card",
     "loading",
     "divider",
-    "collapsible",
     "error-boundary",
     "prompt-input",
     "icons",
@@ -1484,8 +1503,10 @@
     }
   },
   "devDependencies": {
+    "@react-native-community/netinfo": "^12.0.1",
     "@storybook/addon-docs": "^10",
     "@storybook/react-vite": "^10",
+    "@tailwindcss/vite": "4.3.2",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react-native": "^13.3.3",
@@ -1516,11 +1537,12 @@
     "react-native-worklets": "0.10.0",
     "react-test-renderer": "^19.2.0",
     "release-it": "^19.0.6",
+    "nativewind": "5.0.0-preview.3",
     "storybook": "^10",
+    "tailwindcss": "4.3.2",
     "ts-jest": "^29.4.6",
     "typescript": "~5.9.2",
-    "vite": "^7",
-    "@react-native-community/netinfo": "^12.0.1"
+    "vite": "^7"
   },
   "peerDependencies": {
     "@react-native-community/netinfo": ">=11.1.0",

package/src/accordion/Accordion.tsx

@@ -1,8 +1,25 @@
-import React, { createContext, memo, useCallback, useContext, useEffect, useMemo, useRef } from 'react';
-import { View, Text, Pressable, Animated, type ViewStyle } from 'react-native';
+import React, {
+  createContext,
+  memo,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from 'react';
+import {
+  View,
+  Text,
+  Pressable,
+  Animated,
+  type LayoutChangeEvent,
+  type ViewStyle,
+} from 'react-native';
 
+import { ChevronBottom_Stroke2_Corner0_Rounded as ChevronBottomIcon } from '../icons/Chevron';
 import { useTheme } from '../theme/use-theme';
-import { useInteractionState } from '../hooks/useInteractionState';
+import { useInteractionState } from '../hooks/use-interaction-state';
 import { animation, borderRadius, space } from '../styles/tokens';
 import { SUPPORTS_NATIVE_DRIVER } from '../styles/native-driver';
 import type {
@@ -202,15 +219,7 @@ const AccordionTriggerComponent: React.FC<AccordionTriggerProps> = ({
         )}
       </View>
       <Animated.View style={{ transform: [{ rotate: rotation }] }}>
-        <Text
-          style={{
-            fontSize: 16,
-            color: theme.colors.textSecondary,
-            lineHeight: 18,
-          }}
-        >
-          {'\u25BE'}
-        </Text>
+        <ChevronBottomIcon size="sm" fill={theme.colors.textSecondary} />
       </Animated.View>
     </Pressable>
   );
@@ -224,6 +233,18 @@ const AccordionContentComponent: React.FC<AccordionContentProps> = ({
 }) => {
   const { isExpanded } = useContext(AccordionItemContext);
   const heightAnim = useRef(new Animated.Value(isExpanded ? 1 : 0)).current;
+  // The content's own height, measured. The reveal used to interpolate to a
+  // hardcoded 500 ("reasonable max"), which is not a max at all: `overflow:
+  // hidden` above it meant anything taller was CLIPPED, silently, with no error
+  // and no scrollbar — an accordion holding a form or a paragraph of prose just
+  // lost its bottom. The content still lays out at its natural height inside the
+  // clip, so `onLayout` reports the real one whether the item is open or shut.
+  const [contentHeight, setContentHeight] = useState(0);
+  const handleContentLayout = useCallback((event: LayoutChangeEvent) => {
+    const next = event.nativeEvent.layout.height;
+    // Sub-pixel churn would re-render on every frame of the spring.
+    setContentHeight((prev) => (Math.abs(prev - next) > 0.5 ? next : prev));
+  }, []);
 
   useEffect(() => {
     Animated.spring(heightAnim, {
@@ -240,7 +261,7 @@ const AccordionContentComponent: React.FC<AccordionContentProps> = ({
 
   const maxHeight = heightAnim.interpolate({
     inputRange: [0, 1],
-    outputRange: [0, 500], // reasonable max; content will use its natural height
+    outputRange: [0, contentHeight],
   });
 
   return (
@@ -249,12 +270,19 @@ const AccordionContentComponent: React.FC<AccordionContentProps> = ({
         {
           overflow: 'hidden',
           opacity,
-          maxHeight,
+          // Before the first measurement an OPEN item must not be clipped to
+          // zero, and a SHUT one must not flash open — so the unmeasured frame
+          // takes the answer its state already implies, and every frame after
+          // that is driven by the real height.
+          maxHeight: contentHeight === 0 && isExpanded ? undefined : maxHeight,
         },
         style,
       ]}
     >
-      <View style={{ paddingBottom: space.md, paddingHorizontal: space.xs }}>
+      <View
+        onLayout={handleContentLayout}
+        style={{ paddingBottom: space.md, paddingHorizontal: space.xs }}
+      >
         {children}
       </View>
     </Animated.View>

package/src/activity-heatmap/ActivityHeatmap.tsx

@@ -8,13 +8,29 @@ import type { ActivityHeatmapDay, ActivityHeatmapProps } from './types';
 
 const DAY_MS = 86_400_000;
 const DEFAULT_NUM_DAYS = 364;
-const DEFAULT_LEVELS = [1, 3, 6, 10];
+/**
+ * Ascending thresholds, one per colour step ABOVE the first — see
+ * `DEFAULT_ALPHAS`. A positive count below `3` is the lightest tint; `10` and up
+ * is the strongest. The buckets are 1–2 / 3–5 / 6–9 / 10+.
+ */
+const DEFAULT_LEVELS = [3, 6, 10];
 const DEFAULT_MONTHS = [
   'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
   'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
 ];
-/** Opacity steps (low→high) used to derive the default color scale from primary. */
-const DEFAULT_ALPHAS = [0.16, 0.32, 0.52, 0.75, 1];
+/**
+ * Opacity steps (low→high) used to derive the default color scale from primary.
+ *
+ * FOUR steps for THREE thresholds, and the pairing is the whole point: a level
+ * is the number of thresholds a count meets, so N thresholds address indices
+ * `0..N` and a scale needs `N + 1` entries. Index 0 is "positive, but below the
+ * first threshold" — reachable only while `DEFAULT_LEVELS[0] >= 2`. This list
+ * used to carry a fifth step at 0.16 against thresholds starting at 1, where
+ * every positive count meets the first one, so the faintest tint could never
+ * paint. Keep the two lists in step: add a threshold and a colour together, and
+ * never let the first threshold fall to 1.
+ */
+const DEFAULT_ALPHAS = [0.32, 0.52, 0.75, 1];
 const LABEL_FONT_SIZE = 10;
 const MONTH_ROW_HEIGHT = 16;
 const WEEKDAY_COL_WIDTH = 26;

package/src/activity-heatmap/index.ts

@@ -1,3 +1,3 @@
 export { ActivityHeatmap } from './ActivityHeatmap';
-export { bucketByDay } from './bucketByDay';
+export { bucketByDay } from './bucket-by-day';
 export type { ActivityHeatmapProps, ActivityHeatmapDay } from './types';

package/src/activity-heatmap/types.ts

@@ -26,12 +26,23 @@ export interface ActivityHeatmapProps {
    * Ascending count thresholds partitioning positive counts into color levels.
    * With N thresholds a positive count maps to `colorScale[number of thresholds
    * met]` (clamped to the scale). Count 0 always uses `emptyColor`.
-   * @default [1, 3, 6, 10]
+   *
+   * N thresholds therefore address indices `0..N`, so the scale wants `N + 1`
+   * colors — and index 0 means "positive, but below the first threshold", which
+   * only exists while the first threshold is 2 or more. A first threshold of 1
+   * makes the faintest color unreachable: every positive count meets it.
+   *
+   * The defaults bucket 1–2 / 3–5 / 6–9 / 10+.
+   * @default [3, 6, 10]
    */
   levels?: number[];
   /**
    * Colors low→high. Index 0 is the faintest activity shade, the last index the
-   * strongest. Defaults to five opacity steps of `theme.colors.primary`.
+   * strongest. Defaults to four opacity steps of `theme.colors.primary`.
+   *
+   * Pass `levels.length + 1` of them — see `levels`. A shorter scale clamps the
+   * busiest days into its last color; a longer one leaves its darkest colors
+   * unused.
    */
   colorScale?: string[];
   /**

package/src/admonition/index.ts

@@ -0,0 +1,9 @@
+export {
+  AdmonitionIcon,
+  AdmonitionContent,
+  AdmonitionText,
+  AdmonitionButton,
+  AdmonitionRow,
+  AdmonitionRoot,
+  Admonition,
+} from './Admonition';