react-native-terra-ui 0.7.2 → 0.8.0

package/lib/module/components/screen/ScreenScrollView.js

@@ -1,169 +1,118 @@
 "use strict";
 
 import { View } from "react-native-unistyles/components/native/View";
-import { Children } from "react";
-import Animated, { useAnimatedScrollHandler, useComposedEventHandler } from "react-native-reanimated";
+import { Children, forwardRef } from "react";
+import Animated from "react-native-reanimated";
 import { StyleSheet } from "react-native-unistyles";
-import { scheduleOnRN } from "react-native-worklets";
-import { resolveScreenMargin } from "../../theme/screen-margin.js";
+import { resolveScreenPadding } from "../../theme/screen-padding.js";
 import { PortalHost } from "../portal/index.js";
-import { BottomSafeArea } from "./parts/BottomSafeArea.js";
+import { useScreenRef } from "./hooks/use-screen-ref.js";
+import { useScreenScrollHandler } from "./hooks/use-screen-scroll-handler.js";
 import { renderScreenPlaceholder } from "./parts/ScreenPlaceholder.js";
 import { SCREEN_HEADER_PORTAL_HOST, useScreen } from "./ScreenContext.js";
-import { hasXMargin, hasYMargin } from "./utils.js";
+import { hasHorizontalPadding, hasVerticalPadding } from "./utils.js";
+
+/** Native ScrollView props plus Screen layout, placeholders, and worklet support. */
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * Scrollable content container for a `Screen`. Binds the screen's shared scroll
- * ref, mirrors offset into `scrollY`, hosts the portal target at the top (where
- * header content is injected), and applies token-driven content padding.
+ * Scrollable content with a header portal and shared scroll tracking.
+ * Must be inside Screen. The ref exposes native ScrollView methods.
  *
- * For simple side effects (analytics, infinite-scroll triggers), pass a plain
- * `onScroll` callback. For scroll-driven animation, pass your own
- * `useAnimatedScrollHandler` via `scrollHandler` instead — it runs on the UI
- * thread alongside the screen's own handler, with no JS-thread round trip.
+ * `contentContainerStyle` styles the native container, including header content.
+ * Use `contentStyle` for the inner content only. `onScroll` receives nativeEvent
+ * data on JS, without SyntheticEvent methods; `scrollHandler` runs on the UI thread.
  *
  * @example
  * ```tsx
- * <Screen.ScrollView>
- *   <Text>Scrollable content</Text>
- * </Screen.ScrollView>
- * ```
- *
- * @example Loading placeholder instead of a per-screen spinner branch
- * ```tsx
- * const { data, loading } = useQuery();
- *
- * <Screen.ScrollView loading={loading}>
- *   <Text>{data?.title}</Text>
- * </Screen.ScrollView>
- * ```
- *
- * @example Empty placeholder when there is nothing to render
- * ```tsx
- * <Screen.ScrollView EmptyComponent={<EmptyState icon="status.info" title="Nothing yet" fill />}>
- *   {items.map((item) => <Row key={item.id} item={item} />)}
- * </Screen.ScrollView>
- * ```
- *
- * @example Simple JS-side scroll callback
- * ```tsx
- * <Screen.ScrollView onScroll={(e) => console.log(e.nativeEvent.contentOffset.y)}>
- *   <Text>Scrollable content</Text>
- * </Screen.ScrollView>
- * ```
- *
- * @example Custom scroll-driven animation
- * ```tsx
- * const headerOpacity = useSharedValue(1);
- * const scrollHandler = useAnimatedScrollHandler({
- *   onScroll: (event) => {
- *     headerOpacity.value = interpolate(event.contentOffset.y, [0, 100], [1, 0]);
- *     // Need a JS-side side effect too? Call scheduleOnRN(fn, ...args) here.
- *   },
- * });
- *
- * <Screen.ScrollView scrollHandler={scrollHandler}>
- *   <Text>Scrollable content</Text>
- * </Screen.ScrollView>
+ * <Screen safeArea="auto" contentPadding="x">
+ *   <Screen.ScrollView isLoading={isLoading} emptyContent={<Text>Nothing yet</Text>}>
+ *     {items.map(item => <Row key={item.id} item={item} />)}
+ *   </Screen.ScrollView>
+ * </Screen>
  * ```
  */
-export function ScreenScrollView({
+export const ScreenScrollView = /*#__PURE__*/forwardRef(function ScreenScrollView({
   children,
   style,
   contentContainerStyle,
+  contentStyle,
   scrollHandler: externalScrollHandler,
-  onScroll: onScrollProp,
+  onScroll,
   horizontal = false,
+  isLoading,
   loading = false,
+  loadingContent,
   LoadingComponent,
+  emptyContent,
   EmptyComponent,
+  contentPadding,
   margins,
+  extraBottomPadding = 0,
+  isEmpty,
   ...rest
-}) {
+}, ref) {
   const {
     scrollRef,
-    scrollHandler: screenScrollHandler,
-    margins: screenMargins,
+    scrollHandler,
+    contentPadding: screenPadding,
     hasHeader,
     background
   } = useScreen();
-  const resolvedMargins = margins ?? screenMargins;
-  // `toArray` drops the nullish/boolean children a conditional render leaves
-  // behind, so `{items.map(...)}` over an empty array counts as empty.
+  const resolvedPadding = contentPadding ?? margins ?? screenPadding;
+  const mergedRef = useScreenRef(scrollRef, ref);
   const placeholder = renderScreenPlaceholder({
-    loading,
-    LoadingComponent,
-    EmptyComponent,
-    isEmpty: Children.toArray(children).length === 0
-  });
-  const jsScrollHandler = useAnimatedScrollHandler({
-    onScroll: event => {
-      if (onScrollProp) {
-        scheduleOnRN(onScrollProp, {
-          nativeEvent: event
-        });
-      }
-    }
+    isLoading: isLoading ?? loading,
+    loadingContent: loadingContent !== undefined ? loadingContent : LoadingComponent ?? undefined,
+    emptyContent: emptyContent !== undefined ? emptyContent : EmptyComponent,
+    isEmpty: isEmpty ?? Children.toArray(children).length === 0
   });
-  const handlers = [screenScrollHandler, ...(externalScrollHandler ? [externalScrollHandler] : []), ...(onScrollProp ? [jsScrollHandler] : [])];
-  const composedHandler = useComposedEventHandler(handlers);
+  const composedScrollHandler = useScreenScrollHandler(scrollHandler, onScroll, externalScrollHandler);
   return /*#__PURE__*/_jsxs(Animated.ScrollView, {
-    ref: scrollRef,
+    ref: mergedRef,
     style: [{
       backgroundColor: background
     }, style],
     horizontal: horizontal,
-    contentInsetAdjustmentBehavior: hasHeader ? "never" : undefined,
+    contentInsetAdjustmentBehavior: "never",
+    automaticallyAdjustContentInsets: false,
+    automaticallyAdjustsScrollIndicatorInsets: false,
     showsVerticalScrollIndicator: false,
     scrollEventThrottle: 16,
-    contentContainerStyle: styles.scrollContent(hasHeader, resolvedMargins)
-    // snapToOffsets={headerSnapOffsets}
-    ,
+    contentContainerStyle: [styles.scrollContent(hasHeader, resolvedPadding, extraBottomPadding), contentContainerStyle],
     ...rest,
-    onScroll: composedHandler,
+    onScroll: composedScrollHandler,
     children: [/*#__PURE__*/_jsx(View, {
+      style: styles.headerWrapper(resolvedPadding),
       children: /*#__PURE__*/_jsx(PortalHost, {
         name: SCREEN_HEADER_PORTAL_HOST
       })
     }), /*#__PURE__*/_jsx(View, {
-      style: [styles.content(horizontal, resolvedMargins), contentContainerStyle],
+      style: [styles.content(horizontal), contentStyle],
       children: placeholder ?? children
-    }), horizontal ? null : /*#__PURE__*/_jsx(BottomSafeArea, {})]
+    })]
   });
-}
-const styles = StyleSheet.create((theme, rt) => ({
-  // `resolveScreenMargin` is called *inside* each dynamic function, not
-  // hoisted above `return` — the Babel plugin only attributes a runtime
-  // dependency (here, breakpoint) to a style key when the `rt` read it
-  // derives from sits inside that key's own value. Hoisting it to the
-  // factory's top level silently drops the dependency, so the margin would
-  // freeze at whatever breakpoint was active on mount and never update on
-  // rotation.
-  scrollContent: (hasHeader, margins) => {
+});
+const styles = StyleSheet.create((theme, runtime) => ({
+  scrollContent: (hasHeader, padding, extraBottomPadding) => {
     const {
-      y: marginY
-    } = resolveScreenMargin(theme, rt.breakpoint);
+      x,
+      y
+    } = resolveScreenPadding(theme, runtime.breakpoint);
     return {
       flexGrow: 1,
-      // The header inset and the safe area are structural — they apply
-      // whether or not margins are on; the y margin stacks on top of them.
-      paddingTop: (hasHeader ? theme.layout.header.height + rt.insets.top : 0) + (hasYMargin(margins) ? marginY : 0),
-      // The safe area is `BottomSafeArea`'s job; counting it here as well
-      // would leave a gap the height of the gesture bar.
-      paddingBottom: hasYMargin(margins) ? marginY : 0,
-      uni__dependencies: [0, 3, 9]
-    };
-  },
-  content: (horizontal, margins) => {
-    const {
-      x: marginX
-    } = resolveScreenMargin(theme, rt.breakpoint);
-    return {
-      flexGrow: 1,
-      paddingHorizontal: hasXMargin(margins) ? marginX : 0,
-      flexDirection: horizontal ? "row" : "column",
+      paddingTop: (hasHeader ? theme.layout.header.height : 0) + (hasVerticalPadding(padding) ? y : 0),
+      paddingHorizontal: hasHorizontalPadding(padding) ? x : 0,
+      paddingBottom: (hasVerticalPadding(padding) ? y : 0) + extraBottomPadding,
       uni__dependencies: [0, 3]
     };
-  }
+  },
+  headerWrapper: padding => ({
+    marginHorizontal: hasHorizontalPadding(padding) ? -resolveScreenPadding(theme, runtime.breakpoint).x : 0,
+    uni__dependencies: [0, 3]
+  }),
+  content: horizontal => ({
+    flexGrow: 1,
+    flexDirection: horizontal ? "row" : "column"
+  })
 }));
 //# sourceMappingURL=ScreenScrollView.js.map

package/lib/module/components/screen/ScreenScrollView.js.map

@@ -1 +1 @@
-{"version":3,"names":["Children","Animated","useAnimatedScrollHandler","useComposedEventHandler","StyleSheet","scheduleOnRN","resolveScreenMargin","PortalHost","BottomSafeArea","renderScreenPlaceholder","SCREEN_HEADER_PORTAL_HOST","useScreen","hasXMargin","hasYMargin","jsx","_jsx","jsxs","_jsxs","ScreenScrollView","children","style","contentContainerStyle","scrollHandler","externalScrollHandler","onScroll","onScrollProp","horizontal","loading","LoadingComponent","EmptyComponent","margins","rest","scrollRef","screenScrollHandler","screenMargins","hasHeader","background","resolvedMargins","placeholder","isEmpty","toArray","length","jsScrollHandler","event","nativeEvent","handlers","composedHandler","ScrollView","ref","backgroundColor","contentInsetAdjustmentBehavior","undefined","showsVerticalScrollIndicator","scrollEventThrottle","styles","scrollContent","View","name","content","create","theme","rt","y","marginY","breakpoint","flexGrow","paddingTop","layout","header","height","insets","top","paddingBottom","uni__dependencies","x","marginX","paddingHorizontal","flexDirection"],"sourceRoot":"../../../../src","sources":["components/screen/ScreenScrollView.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Children","forwardRef","Animated","StyleSheet","resolveScreenPadding","PortalHost","useScreenRef","useScreenScrollHandler","renderScreenPlaceholder","SCREEN_HEADER_PORTAL_HOST","useScreen","hasHorizontalPadding","hasVerticalPadding","jsx","_jsx","jsxs","_jsxs","ScreenScrollView","children","style","contentContainerStyle","contentStyle","scrollHandler","externalScrollHandler","onScroll","horizontal","isLoading","loading","loadingContent","LoadingComponent","emptyContent","EmptyComponent","contentPadding","margins","extraBottomPadding","isEmpty","rest","ref","scrollRef","screenPadding","hasHeader","background","resolvedPadding","mergedRef","placeholder","undefined","toArray","length","composedScrollHandler","ScrollView","backgroundColor","contentInsetAdjustmentBehavior","automaticallyAdjustContentInsets","automaticallyAdjustsScrollIndicatorInsets","showsVerticalScrollIndicator","scrollEventThrottle","styles","scrollContent","View","headerWrapper","name","content","create","theme","runtime","padding","x","y","breakpoint","flexGrow","paddingTop","layout","header","height","paddingHorizontal","paddingBottom","uni__dependencies","marginHorizontal","flexDirection"],"sourceRoot":"../../../../src","sources":["components/screen/ScreenScrollView.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/screen/hooks/use-screen-ref.js

@@ -0,0 +1,18 @@
+"use strict";
+
+import { useCallback } from "react";
+/** Bind the animated ref and the caller's native ref to the same instance. */
+export function useScreenRef(screenRef, ref) {
+  return useCallback(instance => {
+    if (typeof screenRef === "function") screenRef(instance);else if (screenRef) screenRef.current = instance;
+    if (typeof ref === "function") {
+      const cleanup = ref(instance);
+      if (cleanup) return () => {
+        if (typeof screenRef === "function") screenRef(null);else if (screenRef) screenRef.current = null;
+        cleanup();
+      };
+    } else if (ref) ref.current = instance;
+    return undefined;
+  }, [screenRef, ref]);
+}
+//# sourceMappingURL=use-screen-ref.js.map

package/lib/module/components/screen/hooks/use-screen-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useScreenRef","screenRef","ref","instance","current","cleanup","undefined"],"sourceRoot":"../../../../../src","sources":["components/screen/hooks/use-screen-ref.ts"],"mappings":";;AAAA,SAAmBA,WAAW,QAAQ,OAAO;AAI7C;AACA,OAAO,SAASC,YAAYA,CAAIC,SAAsC,EAAEC,GAAuB,EAAE;EAC/F,OAAOH,WAAW,CACfI,QAAkB,IAAK;IACtB,IAAI,OAAOF,SAAS,KAAK,UAAU,EAAEA,SAAS,CAACE,QAAiB,CAAC,CAAC,KAC7D,IAAIF,SAAS,EAAGA,SAAS,CAA0BG,OAAO,GAAGD,QAAQ;IAC1E,IAAI,OAAOD,GAAG,KAAK,UAAU,EAAE;MAC7B,MAAMG,OAAO,GAAGH,GAAG,CAACC,QAAQ,CAAC;MAC7B,IAAIE,OAAO,EACT,OAAO,MAAM;QACX,IAAI,OAAOJ,SAAS,KAAK,UAAU,EAAEA,SAAS,CAAC,IAAI,CAAC,CAAC,KAChD,IAAIA,SAAS,EAAGA,SAAS,CAA0BG,OAAO,GAAG,IAAI;QACtEC,OAAO,CAAC,CAAC;MACX,CAAC;IACL,CAAC,MAAM,IAAIH,GAAG,EAAEA,GAAG,CAACE,OAAO,GAAGD,QAAQ;IACtC,OAAOG,SAAS;EAClB,CAAC,EACD,CAACL,SAAS,EAAEC,GAAG,CACjB,CAAC;AACH","ignoreList":[]}

package/lib/module/components/screen/hooks/use-screen-scroll-handler.js

@@ -0,0 +1,19 @@
+"use strict";
+
+import { useAnimatedScrollHandler, useComposedEventHandler } from "react-native-reanimated";
+import { scheduleOnRN } from "react-native-worklets";
+
+/** Keeps scroll tracking on the UI thread and schedules optional JS callbacks on RN. */
+export function useScreenScrollHandler(screenScrollHandler, onScroll, externalScrollHandler) {
+  const jsScrollHandler = useAnimatedScrollHandler({
+    onScroll: event => {
+      if (onScroll) {
+        scheduleOnRN(onScroll, {
+          nativeEvent: event
+        });
+      }
+    }
+  });
+  return useComposedEventHandler([screenScrollHandler, externalScrollHandler ?? null, onScroll ? jsScrollHandler : null]);
+}
+//# sourceMappingURL=use-screen-scroll-handler.js.map

package/lib/module/components/screen/hooks/use-screen-scroll-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useAnimatedScrollHandler","useComposedEventHandler","scheduleOnRN","useScreenScrollHandler","screenScrollHandler","onScroll","externalScrollHandler","jsScrollHandler","event","nativeEvent"],"sourceRoot":"../../../../../src","sources":["components/screen/hooks/use-screen-scroll-handler.ts"],"mappings":";;AAEA,SAEEA,wBAAwB,EACxBC,uBAAuB,QAClB,yBAAyB;AAChC,SAASC,YAAY,QAAQ,uBAAuB;;AAEpD;AACA,OAAO,SAASC,sBAAsBA,CACpCC,mBAAoE,EACpEC,QAAsC,EACtCC,qBAAuE,EACvE;EACA,MAAMC,eAAe,GAAGP,wBAAwB,CAAC;IAC/CK,QAAQ,EAAGG,KAAK,IAAK;MACnB,IAAIH,QAAQ,EAAE;QACZH,YAAY,CAACG,QAAQ,EAAE;UACrBI,WAAW,EAAED;QACf,CAAuD,CAAC;MAC1D;IACF;EACF,CAAC,CAAC;EAEF,OAAOP,uBAAuB,CAAC,CAC7BG,mBAAmB,EACnBE,qBAAqB,IAAI,IAAI,EAC7BD,QAAQ,GAAGE,eAAe,GAAG,IAAI,CAClC,CAAC;AACJ","ignoreList":[]}

package/lib/module/components/screen/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Screen","useScreen","ScreenFlatList","ScreenList","ScreenScrollView"],"sourceRoot":"../../../../src","sources":["components/screen/index.ts"],"mappings":";;AACA,SAASA,MAAM;AAEf,SAASC,SAAS;AAElB,SAASC,cAAc;AAEvB,SAASC,UAAU;AAEnB,SAASC,gBAAgB","ignoreList":[]}
+{"version":3,"names":["Screen","useScreen","ScreenFlatList","ScreenList","ScreenScrollView"],"sourceRoot":"../../../../src","sources":["components/screen/index.ts"],"mappings":";;AACA,SAASA,MAAM;AAEf,SAASC,SAAS;AAElB,SAASC,cAAc;AAQvB,SAASC,UAAU;AAEnB,SAASC,gBAAgB","ignoreList":[]}

package/lib/module/components/screen/parts/ScreenFrame.js

@@ -0,0 +1,47 @@
+"use strict";
+
+import { View } from "react-native-unistyles/components/native/View";
+import { useCallback, useContext, useState } from "react";
+import Animated from "react-native-reanimated";
+import { StyleSheet } from "react-native-unistyles";
+import { ScreenHeaderAppearanceContext } from "./ScreenHeaderAppearance.js";
+import { ScreenSafeArea } from "./ScreenSafeArea";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+export function ScreenFrame({
+  children,
+  edges
+}) {
+  const appearance = useContext(ScreenHeaderAppearanceContext);
+  const [topInset, setTopInset] = useState(0);
+  const onLayout = useCallback(event => {
+    // This is the actual native padding, including navigator and orientation changes.
+    setTopInset(event.nativeEvent.layout.y);
+  }, []);
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(ScreenSafeArea, {
+      edges: edges,
+      children: /*#__PURE__*/_jsx(View, {
+        style: styles.content,
+        onLayout: onLayout,
+        children: children
+      })
+    }), edges.top && appearance?.background !== undefined && /*#__PURE__*/_jsx(Animated.View, {
+      pointerEvents: "none",
+      style: [styles.topSafeArea(topInset, appearance.background.color), appearance.background.animatedStyle]
+    })]
+  });
+}
+const styles = StyleSheet.create(() => ({
+  content: {
+    flex: 1
+  },
+  topSafeArea: (height, backgroundColor) => ({
+    position: "absolute",
+    top: 0,
+    left: 0,
+    right: 0,
+    height,
+    backgroundColor
+  })
+}));
+//# sourceMappingURL=ScreenFrame.js.map

package/lib/module/components/screen/parts/ScreenFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useContext","useState","Animated","StyleSheet","ScreenHeaderAppearanceContext","ScreenSafeArea","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","ScreenFrame","children","edges","appearance","topInset","setTopInset","onLayout","event","nativeEvent","layout","y","View","style","styles","content","top","background","undefined","pointerEvents","topSafeArea","color","animatedStyle","create","flex","height","backgroundColor","position","left","right"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenFrame.tsx"],"mappings":";;;AAAA,SAAiCA,WAAW,EAAEC,UAAU,EAAEC,QAAQ,QAAQ,OAAO;AAGjF,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,UAAU,QAAQ,wBAAwB;AAGnD,SAASC,6BAA6B;AACtC,SAASC,cAAc;AAA2B,SAAAC,GAAA,IAAAC,IAAA,EAAAC,QAAA,IAAAC,SAAA,EAAAC,IAAA,IAAAC,KAAA;AAElD,OAAO,SAASC,WAAWA,CAAC;EAAEC,QAAQ;EAAEC;AAAyD,CAAC,EAAE;EAClG,MAAMC,UAAU,GAAGf,UAAU,CAACI,6BAA6B,CAAC;EAC5D,MAAM,CAACY,QAAQ,EAAEC,WAAW,CAAC,GAAGhB,QAAQ,CAAC,CAAC,CAAC;EAC3C,MAAMiB,QAAQ,GAAGnB,WAAW,CAAEoB,KAAwB,IAAK;IACzD;IACAF,WAAW,CAACE,KAAK,CAACC,WAAW,CAACC,MAAM,CAACC,CAAC,CAAC;EACzC,CAAC,EAAE,EAAE,CAAC;EAEN,oBACEX,KAAA,CAAAF,SAAA;IAAAI,QAAA,gBACEN,IAAA,CAACF,cAAc;MAACS,KAAK,EAAEA,KAAM;MAAAD,QAAA,eAC3BN,IAAA,CAACgB,IAAI;QAACC,KAAK,EAAEC,MAAM,CAACC,OAAQ;QAACR,QAAQ,EAAEA,QAAS;QAAAL,QAAA,EAC7CA;MAAQ,CACL;IAAC,CACO,CAAC,EAChBC,KAAK,CAACa,GAAG,IAAIZ,UAAU,EAAEa,UAAU,KAAKC,SAAS,iBAChDtB,IAAA,CAACL,QAAQ,CAACqB,IAAI;MACZO,aAAa,EAAC,MAAM;MACpBN,KAAK,EAAE,CACLC,MAAM,CAACM,WAAW,CAACf,QAAQ,EAAED,UAAU,CAACa,UAAU,CAACI,KAAK,CAAC,EACzDjB,UAAU,CAACa,UAAU,CAACK,aAAa;IACnC,CACH,CACF;EAAA,CACD,CAAC;AAEP;AAEA,MAAMR,MAAM,GAAGtB,UAAU,CAAC+B,MAAM,CAAC,OAAO;EACtCR,OAAO,EAAE;IAAES,IAAI,EAAE;EAAE,CAAC;EACpBJ,WAAW,EAAEA,CAACK,MAAc,EAAEC,eAAuB,MAAM;IACzDC,QAAQ,EAAE,UAAU;IACpBX,GAAG,EAAE,CAAC;IACNY,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRJ,MAAM;IACNC;EACF,CAAC;AACH,CAAC,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/screen/parts/ScreenHeaderAppearance.js

@@ -0,0 +1,43 @@
+"use strict";
+
+import { createContext, useContext, useLayoutEffect, useMemo, useState } from "react";
+import { jsx as _jsx } from "react/jsx-runtime";
+export const ScreenHeaderAppearanceContext = /*#__PURE__*/createContext(null);
+const HeaderSlotContext = /*#__PURE__*/createContext(undefined);
+export function ScreenHeaderAppearanceProvider({
+  children
+}) {
+  const [background, setBackground] = useState();
+  const value = useMemo(() => ({
+    background,
+    setBackground
+  }), [background]);
+  return /*#__PURE__*/_jsx(ScreenHeaderAppearanceContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+
+/** Only the designated header slot controls the screen's top safe-area color. */
+export function ScreenHeaderAppearanceSlot({
+  children
+}) {
+  const appearance = useContext(ScreenHeaderAppearanceContext);
+  return /*#__PURE__*/_jsx(HeaderSlotContext.Provider, {
+    value: appearance?.setBackground,
+    children: children
+  });
+}
+
+/** Share the overlay's animated style so safe-area fading stays on the UI thread. */
+export function useHeaderBackground(color, animatedStyle) {
+  const setBackground = useContext(HeaderSlotContext);
+  useLayoutEffect(() => {
+    setBackground?.({
+      color,
+      animatedStyle
+    });
+    return () => setBackground?.(undefined);
+  }, [color, animatedStyle, setBackground]);
+}
+//# sourceMappingURL=ScreenHeaderAppearance.js.map

package/lib/module/components/screen/parts/ScreenHeaderAppearance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","useLayoutEffect","useMemo","useState","jsx","_jsx","ScreenHeaderAppearanceContext","HeaderSlotContext","undefined","ScreenHeaderAppearanceProvider","children","background","setBackground","value","Provider","ScreenHeaderAppearanceSlot","appearance","useHeaderBackground","color","animatedStyle"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenHeaderAppearance.tsx"],"mappings":";;AAAA,SACEA,aAAa,EAIbC,UAAU,EACVC,eAAe,EACfC,OAAO,EACPC,QAAQ,QACH,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAgBf,OAAO,MAAMC,6BAA6B,gBAAGP,aAAa,CAA0B,IAAI,CAAC;AACzF,MAAMQ,iBAAiB,gBAAGR,aAAa,CAAgDS,SAAS,CAAC;AAEjG,OAAO,SAASC,8BAA8BA,CAAC;EAAEC;AAA4B,CAAC,EAAE;EAC9E,MAAM,CAACC,UAAU,EAAEC,aAAa,CAAC,GAAGT,QAAQ,CAAmB,CAAC;EAChE,MAAMU,KAAK,GAAGX,OAAO,CAAC,OAAO;IAAES,UAAU;IAAEC;EAAc,CAAC,CAAC,EAAE,CAACD,UAAU,CAAC,CAAC;EAC1E,oBACEN,IAAA,CAACC,6BAA6B,CAACQ,QAAQ;IAACD,KAAK,EAAEA,KAAM;IAAAH,QAAA,EAAEA;EAAQ,CAAyC,CAAC;AAE7G;;AAEA;AACA,OAAO,SAASK,0BAA0BA,CAAC;EAAEL;AAA4B,CAAC,EAAE;EAC1E,MAAMM,UAAU,GAAGhB,UAAU,CAACM,6BAA6B,CAAC;EAC5D,oBACED,IAAA,CAACE,iBAAiB,CAACO,QAAQ;IAACD,KAAK,EAAEG,UAAU,EAAEJ,aAAc;IAAAF,QAAA,EAAEA;EAAQ,CAA6B,CAAC;AAEzG;;AAEA;AACA,OAAO,SAASO,mBAAmBA,CAACC,KAAa,EAAEC,aAAkC,EAAE;EACrF,MAAMP,aAAa,GAAGZ,UAAU,CAACO,iBAAiB,CAAC;EACnDN,eAAe,CAAC,MAAM;IACpBW,aAAa,GAAG;MAAEM,KAAK;MAAEC;IAAc,CAAC,CAAC;IACzC,OAAO,MAAMP,aAAa,GAAGJ,SAAS,CAAC;EACzC,CAAC,EAAE,CAACU,KAAK,EAAEC,aAAa,EAAEP,aAAa,CAAC,CAAC;AAC3C","ignoreList":[]}

package/lib/module/components/screen/parts/ScreenPlaceholder.js

@@ -5,9 +5,8 @@ import { StyleSheet } from "react-native-unistyles";
 import { Spinner } from "../../spinner/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * Centres a loading/empty placeholder in whatever space the content leaves.
- * Grows so the placeholder sits in the middle of the content area rather than
- * hugging the top, which needs the content container to grow as well.
+ * Centres a placeholder in the available space. The parent must also grow
+ * to fill the viewport.
  */
 export function ScreenPlaceholder({
   children
@@ -18,24 +17,23 @@ export function ScreenPlaceholder({
   });
 }
 /**
- * The placeholder a scroll container should show instead of its content, or
- * `null` to render the content. Loading wins over empty: while data is in
- * flight there is nothing to be empty about yet.
+ * Resolves the loading or empty placeholder, or null to keep the content.
+ * Loading takes precedence over the empty state.
  */
 export function renderScreenPlaceholder({
-  loading,
-  LoadingComponent,
-  EmptyComponent,
+  isLoading,
+  loadingContent,
+  emptyContent,
   isEmpty
 }) {
-  if (loading) {
+  if (isLoading) {
     return /*#__PURE__*/_jsx(ScreenPlaceholder, {
-      children: LoadingComponent ?? /*#__PURE__*/_jsx(Spinner, {})
+      children: loadingContent === undefined ? /*#__PURE__*/_jsx(Spinner, {}) : loadingContent
     });
   }
-  if (isEmpty && EmptyComponent) {
+  if (isEmpty && emptyContent !== undefined) {
     return /*#__PURE__*/_jsx(ScreenPlaceholder, {
-      children: EmptyComponent
+      children: emptyContent
     });
   }
   return null;

package/lib/module/components/screen/parts/ScreenPlaceholder.js.map

@@ -1 +1 @@
-{"version":3,"names":["StyleSheet","Spinner","jsx","_jsx","ScreenPlaceholder","children","View","style","styles","placeholder","renderScreenPlaceholder","loading","LoadingComponent","EmptyComponent","isEmpty","create","flexGrow","alignItems","justifyContent"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenPlaceholder.tsx"],"mappings":";;;AAGA,SAASA,UAAU,QAAQ,wBAAwB;AAEnD,SAASC,OAAO;AAAwB,SAAAC,GAAA,IAAAC,IAAA;AAGxC;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAC;EAAEC;AAAkC,CAAC,EAAE;EACvE,oBAAOF,IAAA,CAACG,IAAI;IAACC,KAAK,EAAEC,MAAM,CAACC,WAAY;IAAAJ,QAAA,EAAEA;EAAQ,CAAO,CAAC;AAC3D;AAQA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,uBAAuBA,CAAC;EACtCC,OAAO;EACPC,gBAAgB;EAChBC,cAAc;EACdC;AACgB,CAAC,EAAuB;EACxC,IAAIH,OAAO,EAAE;IACX,oBAAOR,IAAA,CAACC,iBAAiB;MAAAC,QAAA,EAAEO,gBAAgB,iBAAIT,IAAA,CAACF,OAAO,IAAE;IAAC,CAAoB,CAAC;EACjF;EACA,IAAIa,OAAO,IAAID,cAAc,EAAE;IAC7B,oBAAOV,IAAA,CAACC,iBAAiB;MAAAC,QAAA,EAAEQ;IAAc,CAAoB,CAAC;EAChE;EACA,OAAO,IAAI;AACb;AAEA,MAAML,MAAM,GAAGR,UAAU,CAACe,MAAM,CAAC,OAAO;EACtCN,WAAW,EAAE;IACXO,QAAQ,EAAE,CAAC;IACXC,UAAU,EAAE,QAAQ;IACpBC,cAAc,EAAE;EAClB;AACF,CAAC,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["StyleSheet","Spinner","jsx","_jsx","ScreenPlaceholder","children","View","style","styles","placeholder","renderScreenPlaceholder","isLoading","loadingContent","emptyContent","isEmpty","undefined","create","flexGrow","alignItems","justifyContent"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenPlaceholder.tsx"],"mappings":";;;AAGA,SAASA,UAAU,QAAQ,wBAAwB;AAEnD,SAASC,OAAO;AAAwB,SAAAC,GAAA,IAAAC,IAAA;AAGxC;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAC;EAAEC;AAAkC,CAAC,EAAE;EACvE,oBAAOF,IAAA,CAACG,IAAI;IAACC,KAAK,EAAEC,MAAM,CAACC,WAAY;IAAAJ,QAAA,EAAEA;EAAQ,CAAO,CAAC;AAC3D;AAQA;AACA;AACA;AACA;AACA,OAAO,SAASK,uBAAuBA,CAAC;EACtCC,SAAS;EACTC,cAAc;EACdC,YAAY;EACZC;AACwB,CAAC,EAAuB;EAChD,IAAIH,SAAS,EAAE;IACb,oBACER,IAAA,CAACC,iBAAiB;MAAAC,QAAA,EAAEO,cAAc,KAAKG,SAAS,gBAAGZ,IAAA,CAACF,OAAO,IAAE,CAAC,GAAGW;IAAc,CAAoB,CAAC;EAExG;EACA,IAAIE,OAAO,IAAID,YAAY,KAAKE,SAAS,EAAE;IACzC,oBAAOZ,IAAA,CAACC,iBAAiB;MAAAC,QAAA,EAAEQ;IAAY,CAAoB,CAAC;EAC9D;EACA,OAAO,IAAI;AACb;AAEA,MAAML,MAAM,GAAGR,UAAU,CAACgB,MAAM,CAAC,OAAO;EACtCP,WAAW,EAAE;IACXQ,QAAQ,EAAE,CAAC;IACXC,UAAU,EAAE,QAAQ;IACpBC,cAAc,EAAE;EAClB;AACF,CAAC,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/screen/parts/ScreenSafeArea.android.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import { StyleSheet } from "react-native-unistyles";
+import { jsx as _jsx } from "react/jsx-runtime";
+// Keep native codegen declarations outside the library's generated public types.
+const {
+  SafeAreaView
+} = require("react-native-screens/src/components/safe-area");
+
+/** Android combines system and native interface insets and consumes the selected edges. */
+export function ScreenSafeArea({
+  children,
+  edges
+}) {
+  return /*#__PURE__*/_jsx(SafeAreaView, {
+    edges: edges,
+    insetType: "all",
+    style: styles.fill,
+    children: children
+  });
+}
+const styles = StyleSheet.create(() => ({
+  fill: {
+    flex: 1
+  }
+}));
+//# sourceMappingURL=ScreenSafeArea.android.js.map

package/lib/module/components/screen/parts/ScreenSafeArea.android.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StyleSheet","jsx","_jsx","SafeAreaView","require","ScreenSafeArea","children","edges","insetType","style","styles","fill","create","flex"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenSafeArea.android.tsx"],"mappings":";;AAGA,SAASA,UAAU,QAAQ,wBAAwB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAIpD;AACA,MAAM;EAAEC;AAAa,CAAC,GAAGC,OAAO,CAAC,+CAA+C,CAE/E;;AAED;AACA,OAAO,SAASC,cAAcA,CAAC;EAAEC,QAAQ;EAAEC;AAAyD,CAAC,EAAE;EACrG,oBACEL,IAAA,CAACC,YAAY;IAACI,KAAK,EAAEA,KAAM;IAACC,SAAS,EAAC,KAAK;IAACC,KAAK,EAAEC,MAAM,CAACC,IAAK;IAAAL,QAAA,EAC5DA;EAAQ,CACG,CAAC;AAEnB;AAEA,MAAMI,MAAM,GAAGV,UAAU,CAACY,MAAM,CAAC,OAAO;EAAED,IAAI,EAAE;IAAEE,IAAI,EAAE;EAAE;AAAE,CAAC,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/screen/parts/ScreenSafeArea.js

@@ -0,0 +1,26 @@
+"use strict";
+
+import { SafeAreaProvider, SafeAreaView } from "react-native-safe-area-context";
+import { StyleSheet } from "react-native-unistyles";
+import { jsx as _jsx } from "react/jsx-runtime";
+export function ScreenSafeArea({
+  children,
+  edges
+}) {
+  const enabledEdges = Object.keys(edges).filter(edge => edges[edge]);
+  // A local provider measures remaining UIKit/browser insets, including native iOS bars.
+  return /*#__PURE__*/_jsx(SafeAreaProvider, {
+    style: styles.fill,
+    children: /*#__PURE__*/_jsx(SafeAreaView, {
+      edges: enabledEdges,
+      style: styles.fill,
+      children: children
+    })
+  });
+}
+const styles = StyleSheet.create(() => ({
+  fill: {
+    flex: 1
+  }
+}));
+//# sourceMappingURL=ScreenSafeArea.js.map

package/lib/module/components/screen/parts/ScreenSafeArea.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SafeAreaProvider","SafeAreaView","StyleSheet","jsx","_jsx","ScreenSafeArea","children","edges","enabledEdges","Object","keys","filter","edge","style","styles","fill","create","flex"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenSafeArea.tsx"],"mappings":";;AAEA,SAASA,gBAAgB,EAAEC,YAAY,QAAQ,gCAAgC;AAC/E,SAASC,UAAU,QAAQ,wBAAwB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAIpD,OAAO,SAASC,cAAcA,CAAC;EAAEC,QAAQ;EAAEC;AAAyD,CAAC,EAAE;EACrG,MAAMC,YAAY,GAAIC,MAAM,CAACC,IAAI,CAACH,KAAK,CAAC,CAAmCI,MAAM,CAAEC,IAAI,IAAKL,KAAK,CAACK,IAAI,CAAC,CAAC;EACxG;EACA,oBACER,IAAA,CAACJ,gBAAgB;IAACa,KAAK,EAAEC,MAAM,CAACC,IAAK;IAAAT,QAAA,eACnCF,IAAA,CAACH,YAAY;MAACM,KAAK,EAAEC,YAAa;MAACK,KAAK,EAAEC,MAAM,CAACC,IAAK;MAAAT,QAAA,EACnDA;IAAQ,CACG;EAAC,CACC,CAAC;AAEvB;AAEA,MAAMQ,MAAM,GAAGZ,UAAU,CAACc,MAAM,CAAC,OAAO;EAAED,IAAI,EAAE;IAAEE,IAAI,EAAE;EAAE;AAAE,CAAC,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/screen/utils.js

@@ -1,16 +1,25 @@
 "use strict";
 
 import { createElement, isValidElement } from "react";
-/** Renders a `ListHeaderComponent`-shaped prop (element, component, or nullish) into an element. */
-export function renderListHeader(ListHeaderComponent) {
-  if (!ListHeaderComponent) return null;
-  if (/*#__PURE__*/isValidElement(ListHeaderComponent)) return ListHeaderComponent;
-  return /*#__PURE__*/createElement(ListHeaderComponent);
+/** Resolves a list header, footer, or empty component to an element. */
+export function renderListComponent(ListComponent) {
+  if (!ListComponent) return null;
+  if (/*#__PURE__*/isValidElement(ListComponent)) return ListComponent;
+  return /*#__PURE__*/createElement(ListComponent);
 }
 
-/** Whether `margins` pads the horizontal axis. */
-export const hasXMargin = margins => margins === "all" || margins === "x";
+/** Whether `padding` pads the horizontal axis. */
+export const hasHorizontalPadding = padding => padding === "all" || padding === "x";
 
-/** Whether `margins` pads the vertical axis (the bottom of the content area). */
-export const hasYMargin = margins => margins === "all" || margins === "y";
+/** Whether `padding` pads the vertical axis (top and bottom). */
+export const hasVerticalPadding = padding => padding === "all" || padding === "y";
+export function resolveSafeAreaEdges(safeArea) {
+  const includes = edge => safeArea === "auto" || safeArea !== "none" && safeArea.includes(edge);
+  return {
+    top: includes("top"),
+    bottom: includes("bottom"),
+    left: includes("left"),
+    right: includes("right")
+  };
+}
 //# sourceMappingURL=utils.js.map

package/lib/module/components/screen/utils.js.map

@@ -1 +1 @@
-{"version":3,"names":["createElement","isValidElement","renderListHeader","ListHeaderComponent","hasXMargin","margins","hasYMargin"],"sourceRoot":"../../../../src","sources":["components/screen/utils.ts"],"mappings":";;AAAA,SAA6BA,aAAa,EAAEC,cAAc,QAA2B,OAAO;AAM5F;AACA,OAAO,SAASC,gBAAgBA,CAACC,mBAAwC,EAAuB;EAC9F,IAAI,CAACA,mBAAmB,EAAE,OAAO,IAAI;EACrC,iBAAIF,cAAc,CAACE,mBAAmB,CAAC,EAAE,OAAOA,mBAAmB;EACnE,oBAAOH,aAAa,CAACG,mBAAmB,CAAC;AAC3C;;AAEA;AACA,OAAO,MAAMC,UAAU,GAAIC,OAAsB,IAAcA,OAAO,KAAK,KAAK,IAAIA,OAAO,KAAK,GAAG;;AAEnG;AACA,OAAO,MAAMC,UAAU,GAAID,OAAsB,IAAcA,OAAO,KAAK,KAAK,IAAIA,OAAO,KAAK,GAAG","ignoreList":[]}
+{"version":3,"names":["createElement","isValidElement","renderListComponent","ListComponent","hasHorizontalPadding","padding","hasVerticalPadding","resolveSafeAreaEdges","safeArea","includes","edge","top","bottom","left","right"],"sourceRoot":"../../../../src","sources":["components/screen/utils.ts"],"mappings":";;AAAA,SAA6BA,aAAa,EAAEC,cAAc,QAA2B,OAAO;AAM5F;AACA,OAAO,SAASC,mBAAmBA,CAACC,aAA4B,EAAuB;EACrF,IAAI,CAACA,aAAa,EAAE,OAAO,IAAI;EAC/B,iBAAIF,cAAc,CAACE,aAAa,CAAC,EAAE,OAAOA,aAAa;EACvD,oBAAOH,aAAa,CAACG,aAAa,CAAC;AACrC;;AAEA;AACA,OAAO,MAAMC,oBAAoB,GAAIC,OAA6B,IAChEA,OAAO,KAAK,KAAK,IAAIA,OAAO,KAAK,GAAG;;AAEtC;AACA,OAAO,MAAMC,kBAAkB,GAAID,OAA6B,IAC9DA,OAAO,KAAK,KAAK,IAAIA,OAAO,KAAK,GAAG;AAEtC,OAAO,SAASE,oBAAoBA,CAACC,QAAwB,EAAuB;EAClF,MAAMC,QAAQ,GAAIC,IAA+B,IAC/CF,QAAQ,KAAK,MAAM,IAAKA,QAAQ,KAAK,MAAM,IAAIA,QAAQ,CAACC,QAAQ,CAACC,IAAI,CAAE;EACzE,OAAO;IACLC,GAAG,EAAEF,QAAQ,CAAC,KAAK,CAAC;IACpBG,MAAM,EAAEH,QAAQ,CAAC,QAAQ,CAAC;IAC1BI,IAAI,EAAEJ,QAAQ,CAAC,MAAM,CAAC;IACtBK,KAAK,EAAEL,QAAQ,CAAC,OAAO;EACzB,CAAC;AACH","ignoreList":[]}

package/lib/module/components/spinner/Spinner.js

@@ -83,7 +83,7 @@ const SpinnerIcon = /*#__PURE__*/memo(function SpinnerIcon({
  */
 export function Spinner({
   size = "md",
-  color = "text.accent"
+  color = "accent.text"
 }) {
   const {
     theme
@@ -91,7 +91,7 @@ export function Spinner({
   const id = useId();
   const gradientId1 = `spinner-def-1-${id}`;
   const gradientId2 = `spinner-def-2-${id}`;
-  const resolvedColor = resolveThemeColor(color, theme) ?? theme.color["text.accent"] ?? "";
+  const resolvedColor = resolveThemeColor(color, theme) ?? theme.color["accent.text"] ?? "";
   const dim = DIMENSION[size];
   const rotation = useSharedValue(0);
   useEffect(() => {

package/lib/module/components/text/Text.js

@@ -51,7 +51,7 @@ export const Text = /*#__PURE__*/forwardRef(function Text({
     fontSize: v.fontSize,
     lineHeight: v.lineHeight,
     letterSpacing: v.letterSpacing,
-    color: resolveThemeColor(color, theme) ?? theme.color["text.default"] ?? ""
+    color: resolveThemeColor(color, theme) ?? theme.color["text.primary"] ?? ""
   };
   // System font: apply numeric weight. Custom font: family encodes the weight.
   if (isSystemFont) base.fontWeight = FONT_WEIGHT_VALUE[effectiveWeight];else base.fontFamily = resolvedFamily;