@hzblj/kara-components 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @hzblj/kara-components
 
+## 0.25.0
+
+### Minor Changes
+
+- [#80](https://github.com/hzblj/kara-ui/pull/80) [`e9d4c23`](https://github.com/hzblj/kara-ui/commit/e9d4c23328a2e72e0fb124621cc4f491b3f86335) Thanks [@hzblj](https://github.com/hzblj)! - `ScrollEdgeContainer` catches up with Footshop's: it sets the scroll view's top inset natively as soon as the top bar is laid out, so a list no longer starts under its bar for a few frames and then jumps (most visible on a tab rendered before it is first shown); `initialTopBarHeight` / `initialBottomBarHeight` give the first frame its insets; `contentScrollView` lets the iOS 26 tab bar minimise with this scroll view; `topEdgeEffectHidden` drops the top blur. A list remounted by `key` keeps its inset and edge effects, and a bottom bar no longer jumps while the keyboard animates. On iOS a `List` is its screen's content scroll view, so a large title in the header collapses as the list scrolls. Run a prebuild after upgrading.
+
+### Patch Changes
+
+- Updated dependencies [[`e9d4c23`](https://github.com/hzblj/kara-ui/commit/e9d4c23328a2e72e0fb124621cc4f491b3f86335)]:
+  - @hzblj/kara-native@0.25.0
+  - @hzblj/kara-sx@0.25.0
+  - @hzblj/kara-theme@0.25.0
+
 ## 0.24.0
 
 ### Minor Changes

package/lib/module/atoms/list/list.ios.js

@@ -2,6 +2,7 @@
 
 import { Group, List as SwiftUIList } from '@expo/ui/swift-ui';
 import { listRowSeparator, listStyle, refreshable } from '@expo/ui/swift-ui/modifiers';
+import { contentScrollView } from '@hzblj/kara-native/swift-ui';
 import { useMemo } from 'react';
 import { useHostGuard } from "../../hooks/host-context.js";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -18,7 +19,7 @@ export const List = ({
   variant = 'insetGrouped'
 }) => {
   useHostGuard('List');
-  const modifiers = useMemo(() => [listStyle(variant), ...(onRefresh ? [refreshable(onRefresh)] : [])], [onRefresh, variant]);
+  const modifiers = useMemo(() => [listStyle(variant), contentScrollView(), ...(onRefresh ? [refreshable(onRefresh)] : [])], [onRefresh, variant]);
   return /*#__PURE__*/_jsx(SwiftUIList, {
     modifiers: modifiers,
     testID: testID,

package/lib/module/atoms/list/list.ios.js.map

@@ -1 +1 @@
-{"version":3,"names":["Group","List","SwiftUIList","listRowSeparator","listStyle","refreshable","useMemo","useHostGuard","jsx","_jsx","NO_SEPARATORS","children","onRefresh","separators","testID","variant","modifiers"],"sourceRoot":"../../../../src","sources":["atoms/list/list.ios.tsx"],"mappings":";;AAAA,SAAQA,KAAK,EAAEC,IAAI,IAAIC,WAAW,QAAO,mBAAmB;AAC5D,SAAQC,gBAAgB,EAAEC,SAAS,EAAuBC,WAAW,QAAO,6BAA6B;AACzG,SAAQC,OAAO,QAAO,OAAO;AAE7B,SAAQC,YAAY,QAAO,6BAA0B;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAGrD;AACA;AACA;AACA;AACA,MAAMC,aAAa,GAAG,CAACP,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAElD,OAAO,MAAMF,IAAmB,GAAGA,CAAC;EAClCU,QAAQ;EACRC,SAAS;EACTC,UAAU,GAAG,IAAI;EACjBC,MAAM;EACNC,OAAO,GAAG;AACD,CAAC,KAAK;EACfR,YAAY,CAAC,MAAM,CAAC;EAEpB,MAAMS,SAAS,GAAGV,OAAO,CACvB,MAAM,CAACF,SAAS,CAACW,OAAO,CAAC,EAAE,IAAIH,SAAS,GAAG,CAACP,WAAW,CAACO,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAC1E,CAACA,SAAS,EAAEG,OAAO,CACrB,CAAC;EAED,oBACEN,IAAA,CAACP,WAAW;IAACc,SAAS,EAAEA,SAAU;IAACF,MAAM,EAAEA,MAAO;IAAAH,QAAA,EAC/CE,UAAU,GAAGF,QAAQ,gBAAGF,IAAA,CAACT,KAAK;MAACgB,SAAS,EAAEN,aAAc;MAAAC,QAAA,EAAEA;IAAQ,CAAQ;EAAC,CACjE,CAAC;AAElB,CAAC","ignoreList":[]}
+{"version":3,"names":["Group","List","SwiftUIList","listRowSeparator","listStyle","refreshable","contentScrollView","useMemo","useHostGuard","jsx","_jsx","NO_SEPARATORS","children","onRefresh","separators","testID","variant","modifiers"],"sourceRoot":"../../../../src","sources":["atoms/list/list.ios.tsx"],"mappings":";;AAAA,SAAQA,KAAK,EAAEC,IAAI,IAAIC,WAAW,QAAO,mBAAmB;AAC5D,SAAQC,gBAAgB,EAAEC,SAAS,EAAuBC,WAAW,QAAO,6BAA6B;AACzG,SAAQC,iBAAiB,QAAO,6BAA6B;AAC7D,SAAQC,OAAO,QAAO,OAAO;AAE7B,SAAQC,YAAY,QAAO,6BAA0B;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAGrD;AACA;AACA;AACA;AACA,MAAMC,aAAa,GAAG,CAACR,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAElD,OAAO,MAAMF,IAAmB,GAAGA,CAAC;EAClCW,QAAQ;EACRC,SAAS;EACTC,UAAU,GAAG,IAAI;EACjBC,MAAM;EACNC,OAAO,GAAG;AACD,CAAC,KAAK;EACfR,YAAY,CAAC,MAAM,CAAC;EAEpB,MAAMS,SAAS,GAAGV,OAAO,CACvB,MAAM,CAACH,SAAS,CAACY,OAAO,CAAC,EAAEV,iBAAiB,CAAC,CAAC,EAAE,IAAIO,SAAS,GAAG,CAACR,WAAW,CAACQ,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAC/F,CAACA,SAAS,EAAEG,OAAO,CACrB,CAAC;EAED,oBACEN,IAAA,CAACR,WAAW;IAACe,SAAS,EAAEA,SAAU;IAACF,MAAM,EAAEA,MAAO;IAAAH,QAAA,EAC/CE,UAAU,GAAGF,QAAQ,gBAAGF,IAAA,CAACV,KAAK;MAACiB,SAAS,EAAEN,aAAc;MAAAC,QAAA,EAAEA;IAAQ,CAAQ;EAAC,CACjE,CAAC;AAElB,CAAC","ignoreList":[]}

package/lib/module/molecules/scroll-edge-container/scroll-edge-container.android.js

@@ -45,9 +45,13 @@ export const ScrollEdgeContainer = ({
   automaticInsets: _automaticInsets,
   bottomBar,
   children,
+  contentScrollView: _contentScrollView,
   effect: _effect,
+  initialBottomBarHeight: _initialBottomBarHeight,
+  initialTopBarHeight: _initialTopBarHeight,
   testID,
   topBar,
+  topEdgeEffectHidden: _topEdgeEffectHidden,
   ...sx
 }) => {
   const topFilled = useSharedValue(opacity.o0);

package/lib/module/molecules/scroll-edge-container/scroll-edge-container.android.js.map

@@ -1 +1 @@
-{"version":3,"names":["timing","opacity","cloneElement","useCallback","useRef","useAnimatedStyle","useSharedValue","withTiming","Box","jsx","_jsx","jsxs","_jsxs","EDGE_SLOP","FILL","EdgeBar","children","filled","fill","value","bg","bottom","left","pointerEvents","position","right","style","top","ScrollEdgeContainer","automaticInsets","_automaticInsets","bottomBar","effect","_effect","testID","topBar","sx","topFilled","o0","bottomFilled","metrics","content","offset","viewport","state","flex","onContentSizeChange","onLayout","onScroll","scrollEventThrottle","props","update","current","o100","scrollable","width","height","event","nativeEvent","layout","contentOffset","y"],"sourceRoot":"../../../../src","sources":["molecules/scroll-edge-container/scroll-edge-container.android.tsx"],"mappings":";;AAAA,SAAQA,MAAM,QAAO,gBAAgB;AACrC,SAAQC,OAAO,QAAO,mBAAmB;AACzC,SAAQC,YAAY,EAAkBC,WAAW,EAAEC,MAAM,QAAO,OAAO;AAEvE,SAA0BC,gBAAgB,EAAEC,cAAc,EAAEC,UAAU,QAAO,yBAAyB;AAEtG,SAAQC,GAAG,QAAO,0BAAiB;AAAA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAGnC;AACA,MAAMC,SAAS,GAAG,GAAG;AAErB,MAAMC,IAAI,GAAGd,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;AAInC;AACA,MAAMe,OAAO,GAAGA,CAAC;EAACC,QAAQ;EAAEC;AAAW,CAAC,KAAK;EAC3C,MAAMC,IAAI,GAAGb,gBAAgB,CAAC,OAAO;IAACJ,OAAO,EAAEgB,MAAM,CAACE;EAAK,CAAC,CAAC,EAAE,EAAE,CAAC;EAElE,IAAI,CAACH,QAAQ,EAAE;IACb,OAAO,IAAI;EACb;EAEA,oBACEJ,KAAA,CAACJ,GAAG;IAAAQ,QAAA,gBACFN,IAAA,CAACF,GAAG;MACFY,EAAE,EAAC,mBAAmB;MACtBC,MAAM,EAAE,CAAE;MACVC,IAAI,EAAE,CAAE;MACRC,aAAa,EAAC,MAAM;MACpBC,QAAQ,EAAC,UAAU;MACnBC,KAAK,EAAE,CAAE;MACTC,KAAK,EAAER,IAAK;MACZS,GAAG,EAAE;IAAE,CACR,CAAC,EACDX,QAAQ;EAAA,CACN,CAAC;AAEV,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMY,mBAAiD,GAAGA,CAAC;EAChEC,eAAe,EAAEC,gBAAgB;EACjCC,SAAS;EACTf,QAAQ;EACRgB,MAAM,EAAEC,OAAO;EACfC,MAAM;EACNC,MAAM;EACN,GAAGC;AACqB,CAAC,KAAK;EAC9B,MAAMC,SAAS,GAAG/B,cAAc,CAASL,OAAO,CAACqC,EAAE,CAAC;EACpD,MAAMC,YAAY,GAAGjC,cAAc,CAASL,OAAO,CAACqC,EAAE,CAAC;EACvD,MAAME,OAAO,GAAGpC,MAAM,CAAC;IAACqC,OAAO,EAAE,CAAC;IAAEC,MAAM,EAAE,CAAC;IAAEC,QAAQ,EAAE;EAAC,CAAC,CAAC;EAC5D,MAAMC,KAAK,GAAGxC,MAAM,CAAC;IAACiB,MAAM,EAAE,KAAK;IAAEM,GAAG,EAAE;EAAK,CAAC,CAAC;EACjD,MAAM;IAACkB,IAAI;IAAEC,mBAAmB;IAAEC,QAAQ;IAAEC,QAAQ;IAAEC;EAAmB,CAAC,GAAGjC,QAAQ,CAACkC,KAMrF;;EAED;EACA,MAAMC,MAAM,GAAGhD,WAAW,CAAC,MAAM;IAC/B,MAAM;MAACsC,OAAO;MAAEC,MAAM;MAAEC;IAAQ,CAAC,GAAGH,OAAO,CAACY,OAAO;IACnD,MAAMzB,GAAG,GAAGe,MAAM,GAAG7B,SAAS;IAC9B,MAAMQ,MAAM,GAAGsB,QAAQ,GAAG,CAAC,IAAID,MAAM,GAAGC,QAAQ,GAAGF,OAAO,GAAG5B,SAAS;IAEtE,IAAIc,GAAG,KAAKiB,KAAK,CAACQ,OAAO,CAACzB,GAAG,EAAE;MAC7BiB,KAAK,CAACQ,OAAO,CAACzB,GAAG,GAAGA,GAAG;MACvBU,SAAS,CAAClB,KAAK,GAAGZ,UAAU,CAACoB,GAAG,GAAG1B,OAAO,CAACoD,IAAI,GAAGpD,OAAO,CAACqC,EAAE,EAAExB,IAAI,CAAC;IACrE;IAEA,IAAIO,MAAM,KAAKuB,KAAK,CAACQ,OAAO,CAAC/B,MAAM,EAAE;MACnCuB,KAAK,CAACQ,OAAO,CAAC/B,MAAM,GAAGA,MAAM;MAC7BkB,YAAY,CAACpB,KAAK,GAAGZ,UAAU,CAACc,MAAM,GAAGpB,OAAO,CAACoD,IAAI,GAAGpD,OAAO,CAACqC,EAAE,EAAExB,IAAI,CAAC;IAC3E;EACF,CAAC,EAAE,CAACyB,YAAY,EAAEF,SAAS,CAAC,CAAC;;EAE7B;EACA;EACA,MAAMiB,UAAU,gBAAGpD,YAAY,CAACc,QAAQ,EAAE;IACxC6B,IAAI,EAAEA,IAAI,IAAI,CAAC;IACfC,mBAAmB,EAAEA,CAACS,KAAa,EAAEC,MAAc,KAAK;MACtDhB,OAAO,CAACY,OAAO,CAACX,OAAO,GAAGe,MAAM;MAChCL,MAAM,CAAC,CAAC;MACRL,mBAAmB,GAAGS,KAAK,EAAEC,MAAM,CAAC;IACtC,CAAC;IACDT,QAAQ,EAAGU,KAAwB,IAAK;MACtCjB,OAAO,CAACY,OAAO,CAACT,QAAQ,GAAGc,KAAK,CAACC,WAAW,CAACC,MAAM,CAACH,MAAM;MAC1DL,MAAM,CAAC,CAAC;MACRJ,QAAQ,GAAGU,KAAK,CAAC;IACnB,CAAC;IACDT,QAAQ,EAAGS,KAA8C,IAAK;MAC5DjB,OAAO,CAACY,OAAO,CAACV,MAAM,GAAGe,KAAK,CAACC,WAAW,CAACE,aAAa,CAACC,CAAC;MAC1DV,MAAM,CAAC,CAAC;MACRH,QAAQ,GAAGS,KAAK,CAAC;IACnB,CAAC;IACDR,mBAAmB,EAAEA,mBAAmB,IAAI;EAC9C,CAAmC,CAAC;EAEpC,oBACErC,KAAA,CAACJ,GAAG;IAAA,GAAK4B,EAAE;IAAEF,MAAM,EAAEA,MAAO;IAAAlB,QAAA,gBAC1BN,IAAA,CAACK,OAAO;MAACE,MAAM,EAAEoB,SAAU;MAAArB,QAAA,EAAEmB;IAAM,CAAU,CAAC,eAC9CzB,IAAA,CAACF,GAAG;MAACqC,IAAI,EAAE,CAAE;MAAA7B,QAAA,EAAEsC;IAAU,CAAM,CAAC,eAChC5C,IAAA,CAACK,OAAO;MAACE,MAAM,EAAEsB,YAAa;MAAAvB,QAAA,EAAEe;IAAS,CAAU,CAAC;EAAA,CACjD,CAAC;AAEV,CAAC","ignoreList":[]}
+{"version":3,"names":["timing","opacity","cloneElement","useCallback","useRef","useAnimatedStyle","useSharedValue","withTiming","Box","jsx","_jsx","jsxs","_jsxs","EDGE_SLOP","FILL","EdgeBar","children","filled","fill","value","bg","bottom","left","pointerEvents","position","right","style","top","ScrollEdgeContainer","automaticInsets","_automaticInsets","bottomBar","contentScrollView","_contentScrollView","effect","_effect","initialBottomBarHeight","_initialBottomBarHeight","initialTopBarHeight","_initialTopBarHeight","testID","topBar","topEdgeEffectHidden","_topEdgeEffectHidden","sx","topFilled","o0","bottomFilled","metrics","content","offset","viewport","state","flex","onContentSizeChange","onLayout","onScroll","scrollEventThrottle","props","update","current","o100","scrollable","width","height","event","nativeEvent","layout","contentOffset","y"],"sourceRoot":"../../../../src","sources":["molecules/scroll-edge-container/scroll-edge-container.android.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/molecules/scroll-edge-container/scroll-edge-container.ios.js

@@ -11,19 +11,27 @@ export const ScrollEdgeContainer = ({
   automaticInsets,
   bottomBar,
   children,
+  contentScrollView,
   effect,
+  initialBottomBarHeight,
+  initialTopBarHeight,
   testID,
   topBar,
+  topEdgeEffectHidden,
   ...sx
 }) => {
   const style = useSx(sx);
   return /*#__PURE__*/_jsx(NativeScrollEdgeContainer, {
     automaticInsets: automaticInsets,
     bottomBar: bottomBar,
+    contentScrollView: contentScrollView,
     effect: effect,
+    initialBottomBarHeight: initialBottomBarHeight,
+    initialTopBarHeight: initialTopBarHeight,
     style: style,
     testID: testID,
     topBar: topBar,
+    topEdgeEffectHidden: topEdgeEffectHidden,
     children: children
   });
 };

package/lib/module/molecules/scroll-edge-container/scroll-edge-container.ios.js.map

@@ -1 +1 @@
-{"version":3,"names":["ScrollEdgeContainer","NativeScrollEdgeContainer","useSx","jsx","_jsx","automaticInsets","bottomBar","children","effect","testID","topBar","sx","style"],"sourceRoot":"../../../../src","sources":["molecules/scroll-edge-container/scroll-edge-container.ios.tsx"],"mappings":";;AAAA,SAAQA,mBAAmB,IAAIC,yBAAyB,QAAO,6BAA6B;AAC5F,SAAQC,KAAK,QAAO,gBAAgB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAGpC;AACA;AACA;AACA;AACA,OAAO,MAAMJ,mBAAiD,GAAGA,CAAC;EAChEK,eAAe;EACfC,SAAS;EACTC,QAAQ;EACRC,MAAM;EACNC,MAAM;EACNC,MAAM;EACN,GAAGC;AACqB,CAAC,KAAK;EAC9B,MAAMC,KAAK,GAAGV,KAAK,CAACS,EAAE,CAAC;EAEvB,oBACEP,IAAA,CAACH,yBAAyB;IACxBI,eAAe,EAAEA,eAAgB;IACjCC,SAAS,EAAEA,SAAU;IACrBE,MAAM,EAAEA,MAAO;IACfI,KAAK,EAAEA,KAAM;IACbH,MAAM,EAAEA,MAAO;IACfC,MAAM,EAAEA,MAAO;IAAAH,QAAA,EAEdA;EAAQ,CACgB,CAAC;AAEhC,CAAC","ignoreList":[]}
+{"version":3,"names":["ScrollEdgeContainer","NativeScrollEdgeContainer","useSx","jsx","_jsx","automaticInsets","bottomBar","children","contentScrollView","effect","initialBottomBarHeight","initialTopBarHeight","testID","topBar","topEdgeEffectHidden","sx","style"],"sourceRoot":"../../../../src","sources":["molecules/scroll-edge-container/scroll-edge-container.ios.tsx"],"mappings":";;AAAA,SAAQA,mBAAmB,IAAIC,yBAAyB,QAAO,6BAA6B;AAC5F,SAAQC,KAAK,QAAO,gBAAgB;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAGpC;AACA;AACA;AACA;AACA,OAAO,MAAMJ,mBAAiD,GAAGA,CAAC;EAChEK,eAAe;EACfC,SAAS;EACTC,QAAQ;EACRC,iBAAiB;EACjBC,MAAM;EACNC,sBAAsB;EACtBC,mBAAmB;EACnBC,MAAM;EACNC,MAAM;EACNC,mBAAmB;EACnB,GAAGC;AACqB,CAAC,KAAK;EAC9B,MAAMC,KAAK,GAAGd,KAAK,CAACa,EAAE,CAAC;EAEvB,oBACEX,IAAA,CAACH,yBAAyB;IACxBI,eAAe,EAAEA,eAAgB;IACjCC,SAAS,EAAEA,SAAU;IACrBE,iBAAiB,EAAEA,iBAAkB;IACrCC,MAAM,EAAEA,MAAO;IACfC,sBAAsB,EAAEA,sBAAuB;IAC/CC,mBAAmB,EAAEA,mBAAoB;IACzCK,KAAK,EAAEA,KAAM;IACbJ,MAAM,EAAEA,MAAO;IACfC,MAAM,EAAEA,MAAO;IACfC,mBAAmB,EAAEA,mBAAoB;IAAAP,QAAA,EAExCA;EAAQ,CACgB,CAAC;AAEhC,CAAC","ignoreList":[]}

package/lib/typescript/atoms/list/list.types.d.ts

@@ -9,6 +9,8 @@ export type ListVariant = 'insetGrouped' | 'plain';
  *
  * Rows are separated for you (SwiftUI's own separators, a `Divider` between rows on Android), so a `Divider` among
  * the children is one too many: on iOS it becomes an empty row of its own.
+ *
+ * On iOS the list is its screen's content scroll view, so a native-stack large title collapses as it scrolls.
  */
 export type ListProps = {
     /** The rows: native views, one row each. */

package/lib/typescript/molecules/scroll-edge-container/scroll-edge-container.types.d.ts

@@ -21,11 +21,19 @@ export type ScrollEdgeContainerProps = ResponsiveViewSx & {
     bottomBar?: ReactNode;
     /** Exactly one React Native scroll view: `RnScrollView`, `RnFlatList`, `RnSectionList`. */
     children: ReactElement<ScrollEdgeScrollableProps>;
+    /** iOS 26: the tab bar minimises as this scroll view scrolls, not as the screen's first one does. */
+    contentScrollView?: boolean;
     /** iOS 26: how hard the edge cuts. `soft` by default. */
     effect?: ScrollEdgeEffect;
+    /** iOS: the bottom bar's height before it is measured, so the first frame already has the inset. */
+    initialBottomBarHeight?: number;
+    /** iOS: the top bar's height before it is measured, so the first frame's content starts below the bar. */
+    initialTopBarHeight?: number;
     /** Test identifier, forwarded to the container view. */
     testID?: string;
     /** Laid over the scroll view's top edge on iOS; stacked above it on Android, filled once content scrolls under it. */
     topBar?: ReactNode;
+    /** iOS 26: hides the top edge effect, e.g. while a cover image sits under the top bar. */
+    topEdgeEffectHidden?: boolean;
 };
 export type ScrollEdgeContainerComponent = (props: ScrollEdgeContainerProps) => ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hzblj/kara-components",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "The atoms, molecules, organisms and templates of @hzblj/kara-ui — real SwiftUI and Jetpack Compose views through @expo/ui.",
   "author": "Jan Blazej",
   "license": "MIT",
@@ -66,9 +66,9 @@
   "dependencies": {
     "@hzblj/expo-native-icons": "^0.2.0",
     "@hzblj/expo-rich-haptics": "^0.1.0",
-    "@hzblj/kara-native": "^0.24.0",
-    "@hzblj/kara-sx": "^0.24.0",
-    "@hzblj/kara-theme": "^0.24.0",
+    "@hzblj/kara-native": "^0.25.0",
+    "@hzblj/kara-sx": "^0.25.0",
+    "@hzblj/kara-theme": "^0.25.0",
     "sf-symbols-typescript": "^2.2.0"
   },
   "peerDependencies": {

package/src/atoms/list/list.ios.tsx

@@ -1,5 +1,6 @@
 import {Group, List as SwiftUIList} from '@expo/ui/swift-ui'
 import {listRowSeparator, listStyle, type ModifierConfig, refreshable} from '@expo/ui/swift-ui/modifiers'
+import {contentScrollView} from '@hzblj/kara-native/swift-ui'
 import {useMemo} from 'react'
 
 import {useHostGuard} from '../../hooks/host-context'
@@ -21,7 +22,7 @@ export const List: ListComponent = ({
   useHostGuard('List')
 
   const modifiers = useMemo<ModifierConfig[]>(
-    () => [listStyle(variant), ...(onRefresh ? [refreshable(onRefresh)] : [])],
+    () => [listStyle(variant), contentScrollView(), ...(onRefresh ? [refreshable(onRefresh)] : [])],
     [onRefresh, variant]
   )
 

package/src/atoms/list/list.types.ts

@@ -11,6 +11,8 @@ export type ListVariant = 'insetGrouped' | 'plain'
  *
  * Rows are separated for you (SwiftUI's own separators, a `Divider` between rows on Android), so a `Divider` among
  * the children is one too many: on iOS it becomes an empty row of its own.
+ *
+ * On iOS the list is its screen's content scroll view, so a native-stack large title collapses as it scrolls.
  */
 export type ListProps = {
   /** The rows: native views, one row each. */

package/src/molecules/scroll-edge-container/scroll-edge-container.android.tsx

@@ -50,9 +50,13 @@ export const ScrollEdgeContainer: ScrollEdgeContainerComponent = ({
   automaticInsets: _automaticInsets,
   bottomBar,
   children,
+  contentScrollView: _contentScrollView,
   effect: _effect,
+  initialBottomBarHeight: _initialBottomBarHeight,
+  initialTopBarHeight: _initialTopBarHeight,
   testID,
   topBar,
+  topEdgeEffectHidden: _topEdgeEffectHidden,
   ...sx
 }: ScrollEdgeContainerProps) => {
   const topFilled = useSharedValue<number>(opacity.o0)

package/src/molecules/scroll-edge-container/scroll-edge-container.ios.tsx

@@ -10,9 +10,13 @@ export const ScrollEdgeContainer: ScrollEdgeContainerComponent = ({
   automaticInsets,
   bottomBar,
   children,
+  contentScrollView,
   effect,
+  initialBottomBarHeight,
+  initialTopBarHeight,
   testID,
   topBar,
+  topEdgeEffectHidden,
   ...sx
 }: ScrollEdgeContainerProps) => {
   const style = useSx(sx)
@@ -21,10 +25,14 @@ export const ScrollEdgeContainer: ScrollEdgeContainerComponent = ({
     <NativeScrollEdgeContainer
       automaticInsets={automaticInsets}
       bottomBar={bottomBar}
+      contentScrollView={contentScrollView}
       effect={effect}
+      initialBottomBarHeight={initialBottomBarHeight}
+      initialTopBarHeight={initialTopBarHeight}
       style={style}
       testID={testID}
       topBar={topBar}
+      topEdgeEffectHidden={topEdgeEffectHidden}
     >
       {children}
     </NativeScrollEdgeContainer>

package/src/molecules/scroll-edge-container/scroll-edge-container.types.ts

@@ -23,12 +23,20 @@ export type ScrollEdgeContainerProps = ResponsiveViewSx & {
   bottomBar?: ReactNode
   /** Exactly one React Native scroll view: `RnScrollView`, `RnFlatList`, `RnSectionList`. */
   children: ReactElement<ScrollEdgeScrollableProps>
+  /** iOS 26: the tab bar minimises as this scroll view scrolls, not as the screen's first one does. */
+  contentScrollView?: boolean
   /** iOS 26: how hard the edge cuts. `soft` by default. */
   effect?: ScrollEdgeEffect
+  /** iOS: the bottom bar's height before it is measured, so the first frame already has the inset. */
+  initialBottomBarHeight?: number
+  /** iOS: the top bar's height before it is measured, so the first frame's content starts below the bar. */
+  initialTopBarHeight?: number
   /** Test identifier, forwarded to the container view. */
   testID?: string
   /** Laid over the scroll view's top edge on iOS; stacked above it on Android, filled once content scrolls under it. */
   topBar?: ReactNode
+  /** iOS 26: hides the top edge effect, e.g. while a cover image sits under the top bar. */
+  topEdgeEffectHidden?: boolean
 }
 
 export type ScrollEdgeContainerComponent = (props: ScrollEdgeContainerProps) => ReactNode