react-native-terra-ui 0.7.2 → 0.8.0

package/lib/typescript/src/components/screen/ScreenContext.d.ts

@@ -1,67 +1,83 @@
 import { type ReactNode } from "react";
 import Animated, { type AnimatedRef, type ScrollHandlerProcessed, type SharedValue } from "react-native-reanimated";
-import type { ScreenMargins } from "./types.js";
+import type { ScreenContentPadding, ScreenSafeArea } from "./types.js";
+/** Internal animated ref shared by the screen's primary scroll container. */
 export type ScreenScrollRef = AnimatedRef<Animated.ScrollView>;
-/** `PortalHost` name shared by `Screen.ScrollView` / `Screen.FlatList` and header variants that portal content into them. */
+/** Local portal target for scrollable header content. */
 export declare const SCREEN_HEADER_PORTAL_HOST = "screen-header";
+/** Shared configuration and UI-thread scroll values returned by `useScreen`. */
 export interface ScreenContextValue {
     /**
-     * Which axes scroll containers pad with `layout.screen.margin`.
-     * Overridable per `Screen.ScrollView` / `Screen.FlatList` / `Screen.List`
-     * via their own `margins` prop.
+     * Which axes scroll containers pad with `layout.screen.padding`.
+     * Each scroll container can override this with its own `contentPadding` prop.
      */
-    margins: ScreenMargins;
+    contentPadding: ScreenContentPadding;
+    /** Safe-area policy applied by the root; descendants must not reapply it. */
+    safeArea: ScreenSafeArea;
+    /** @deprecated Use contentPadding. */
+    margins: ScreenContentPadding;
     /** Whether a `Screen.Header` is present. Used by scroll containers to add top inset. */
     hasHeader: boolean;
-    /**
-     * Live vertical scroll offset of the screen's scroll container, driven by
-     * `Screen.ScrollView` / `Screen.FlatList`. Headers (and consumer UI) read it
-     * to animate on scroll.
-     */
+    /** Vertical scroll offset, updated on the UI thread for header animations. */
     scrollY: SharedValue<number>;
     /**
-     * Scroll distance (px) over which the active header collapses — measured by
-     * the header (e.g. large-title portal height, parallax hero height). `0`
-     * disables snap and collapse-range animations (`Header.Title` screens).
+     * Optional collapse distance for custom headers. Set via setHeaderCollapseHeight.
+     * Built-in headers derive their animation range from the theme.
      */
     headerCollapseHeight: SharedValue<number>;
     /**
-     * Native `snapToOffsets` for the scroll container. `[0, height]` when a
-     * collapsible header is active; `undefined` otherwise.
+     * Native list snap offsets set by setHeaderCollapseHeight. Undefined by default.
+     * For Screen.ScrollView, pass these explicitly as snapToOffsets.
      */
     headerSnapOffsets: number[] | undefined;
-    /** Updates collapse height for animations and native snap offsets. */
+    /** Rounds the height and sets `[0, height]` snap offsets; nonpositive heights clear snapping. */
     setHeaderCollapseHeight: (height: number) => void;
-    /** Shared scroll container ref — bound by `Screen.ScrollView` / `Screen.FlatList`. */
+    /**
+     * Ref bound by ScrollView and FlatList containers, including `Screen.List`
+     * with FlatList. Custom list implementations do not bind this ref.
+     * Its declared ScrollView type does not expose FlatList-specific methods.
+     */
     scrollRef: ScreenScrollRef;
     /** Scroll handler that mirrors offset into `scrollY`. */
     scrollHandler: ScrollHandlerProcessed<Record<string, unknown>>;
+    /** Resolved background color shared with scroll containers. */
     background?: string;
 }
 export declare const ScreenContext: import("react").Context<ScreenContextValue | null>;
+/** Internal provider inputs resolved by the Screen root. */
 export interface ScreenScrollProviderProps {
     children: ReactNode;
-    /** Which axes scroll containers pad with `layout.screen.margin`. Default `'all'`. */
-    margins?: ScreenMargins;
+    /** Which axes scroll containers pad with `layout.screen.padding`. Default `'all'`. */
+    contentPadding?: ScreenContentPadding;
+    safeArea?: ScreenSafeArea;
     /** Whether a `Screen.Header` child is present. Default false. */
     hasHeader?: boolean;
+    /** Resolved background color shared with scroll containers. */
     background?: string;
 }
 /**
  * Owns the screen's shared scroll ref, offset, snap offsets, and header collapse
- * metrics. Header variants call {@link ScreenContextValue.setHeaderCollapseHeight};
- * scroll containers bind the ref via {@link useScreen}.
+ * metrics. Scroll containers bind the ref via {@link useScreen}.
  */
-export declare function ScreenScrollProvider({ background, children, margins, hasHeader, }: ScreenScrollProviderProps): import("react").JSX.Element;
+export declare function ScreenScrollProvider({ background, children, contentPadding, safeArea, hasHeader, }: ScreenScrollProviderProps): import("react").JSX.Element;
 /**
- * Access the enclosing `Screen`'s shared scroll state, ref, and snap offsets.
+ * Reads the nearest `Screen`'s configuration, shared scroll state, and ref.
+ * Read `scrollY.value` in Reanimated worklets to animate without React renders.
+ * The ref belongs to the primary scroll container, not the screen root.
  *
  * @example
  * ```tsx
- * const { scrollY, scrollRef, headerSnapOffsets } = useScreen();
+ * function FadingContent() {
+ *   const { scrollY } = useScreen();
+ *   const style = useAnimatedStyle(() => ({
+ *     opacity: interpolate(scrollY.value, [0, 100], [1, 0], "clamp"),
+ *   }));
+ *   return <Animated.View style={style}>{content}</Animated.View>;
+ * }
  * ```
  *
- * @throws if called outside a `Screen`.
+ * @returns The nearest Screen's configuration and scroll state.
+ * @throws Error when called outside a Screen provider.
  */
 export declare function useScreen(): ScreenContextValue;
 //# sourceMappingURL=ScreenContext.d.ts.map

package/lib/typescript/src/components/screen/ScreenContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AAElG,OAAO,QAAQ,EAAE,EACf,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAS,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAE/D,6HAA6H;AAC7H,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C;;;OAGG;IACH,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,sEAAsE;IACtE,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,sFAAsF;IACtF,SAAS,EAAE,eAAe,CAAC;IAC3B,yDAAyD;IACzD,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,qFAAqF;IACrF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAA0B,EAC1B,QAAQ,EACR,OAAe,EACf,SAAiB,GAClB,EAAE,yBAAyB,+BA+C3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}
+{"version":3,"file":"ScreenContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AAElG,OAAO,QAAQ,EAAE,EACf,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAS,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAE/D,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,cAAc,EAAE,oBAAoB,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,EAAE,cAAc,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C;;;OAGG;IACH,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,iGAAiG;IACjG,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAC;IAC3B,yDAAyD;IACzD,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/D,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,sFAAsF;IACtF,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAA0B,EAC1B,QAAQ,EACR,cAAsB,EACtB,QAAiB,EACjB,SAAiB,GAClB,EAAE,yBAAyB,+BAkD3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}

package/lib/typescript/src/components/screen/ScreenFlatList.d.ts

@@ -1,47 +1,6 @@
-import { type FlatListProps } from "react-native";
-import type { ScreenScrollableProps } from "./types.js";
-/**
- * @deprecated Use {@link ScreenListProps} (`Screen.List`) instead —
- * `Screen.List` renders `FlatList` by default and binds the screen's shared
- * scroll ref exactly as `Screen.FlatList` does, but also lets a screen swap in
- * any other FlatList-shaped list (e.g. `FlashList`) via its `as` prop.
- */
-export interface ScreenFlatListProps<T> extends Omit<FlatListProps<T>, "CellRendererComponent" | "horizontal">, ScreenScrollableProps {
-    /**
-     * Extra bottom padding on the list content — clearance for a tab bar or home
-     * indicator. Defaults to the `layout.screen.margin.y` token when margins are
-     * enabled, otherwise `0`.
-     */
-    bottomInset?: number;
-}
-/**
- * `FlatList` variant of `Screen.ScrollView`: binds the screen's shared scroll
- * ref, mirrors offset into `scrollY`, hosts the portal target above the list,
- * and applies token-driven content padding.
- *
- * Shares `loading` / `LoadingComponent` / `EmptyComponent` / `margins` /
- * `horizontal` with `Screen.ScrollView`, so a screen can swap one container for
- * another without relearning its API.
- *
- * @deprecated Use {@link ScreenList} (`Screen.List`) instead — it renders
- * `FlatList` by default and behaves identically, but also accepts an `as`
- * prop for swapping in another list implementation later without changing
- * the surrounding API.
- *
- * @example
- * ```tsx
- * <Screen.FlatList data={items} renderItem={({ item }) => <Row item={item} />} />
- * ```
- *
- * @example Loading and empty placeholders
- * ```tsx
- * <Screen.FlatList
- *   data={items}
- *   loading={isLoading}
- *   EmptyComponent={<EmptyState icon="status.info" title="Nothing yet" fill />}
- *   renderItem={({ item }) => <Row item={item} />}
- * />
- * ```
- */
-export declare function ScreenFlatList<T>({ data, style, contentContainerStyle, ListHeaderComponent, ListFooterComponent, ListEmptyComponent, horizontal, loading, LoadingComponent, EmptyComponent, margins, bottomInset, onScroll, ...rest }: ScreenFlatListProps<T>): import("react").JSX.Element;
+import { ScreenList, type ScreenListProps } from "./ScreenList.js";
+/** @deprecated Use ScreenListProps. */
+export type ScreenFlatListProps<T> = ScreenListProps<T>;
+/** @deprecated Use Screen.List, which exposes the same native FlatList and ref. */
+export declare const ScreenFlatList: typeof ScreenList;
 //# sourceMappingURL=ScreenFlatList.d.ts.map

package/lib/typescript/src/components/screen/ScreenFlatList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenFlatList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenFlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAA2D,MAAM,cAAc,CAAC;AAc3G,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAGpE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,CACpC,SAAQ,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,uBAAuB,GAAG,YAAY,CAAC,EACpE,qBAAqB;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,IAAI,EACJ,KAAK,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,UAAkB,EAClB,OAAe,EACf,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,WAAW,EACX,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,mBAAmB,CAAC,CAAC,CAAC,+BA0ExB"}
+{"version":3,"file":"ScreenFlatList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenFlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAc,CAAC;AAEhE,uCAAuC;AACvC,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;AACxD,mFAAmF;AACnF,eAAO,MAAM,cAAc,EAAE,OAAO,UAAuB,CAAC"}

package/lib/typescript/src/components/screen/ScreenList.d.ts

@@ -1,65 +1,77 @@
-import { type ComponentPropsWithoutRef, type ElementType, type ReactElement } from "react";
-import { FlatList, type NativeScrollEvent, type NativeSyntheticEvent, type StyleProp, type ViewStyle } from "react-native";
+import { type ComponentPropsWithoutRef, type ComponentPropsWithRef, type ElementType, type ReactElement, type RefAttributes } from "react";
+import { FlatList, type FlatListProps, type ListRenderItem } from "react-native";
 import type { ScreenScrollableProps } from "./types.js";
-import { type ListHeaderComponent } from "./utils.js";
+/** Minimal row information supported by custom list adapters. FlatList also supplies separators. */
 export interface ScreenListRenderItemInfo<T> {
     item: T;
     index: number;
 }
-export type ScreenListProps<T = unknown, As extends ElementType = typeof FlatList> = ScreenScrollableProps & Omit<ComponentPropsWithoutRef<As>, "data" | "renderItem" | "keyExtractor" | "style" | "contentContainerStyle" | "onScroll" | "ListHeaderComponent" | "ListFooterComponent" | "ListEmptyComponent" | keyof ScreenScrollableProps> & {
-    /**
-     * Which list component to render as. Defaults to React Native's
-     * `FlatList` — pass any list with a FlatList-shaped prop surface
-     * (`data`, `renderItem`, `ListHeaderComponent`, …), e.g. `FlashList`
-     * from `@shopify/flash-list`, or a custom virtualized list.
-     *
-     * Only the default `FlatList` binds the screen's shared imperative
-     * scroll ref — a custom `as` is responsible for its own ref if it needs
-     * one, since not every list exposes a Reanimated-compatible ref (e.g.
-     * `FlashList`'s ref exposes a different, non Reanimated-compatible
-     * imperative API).
-     */
-    as?: As;
+/** Native viewability token with the item inferred from data. */
+type NativeViewToken = Parameters<NonNullable<FlatListProps<unknown>["onViewableItemsChanged"]>>[0]["viewableItems"][number];
+export type ScreenListViewToken<T> = Omit<NativeViewToken, "item"> & {
+    item: T;
+};
+type ViewabilityCallback<T> = (info: {
+    viewableItems: ScreenListViewToken<T>[];
+    changed: ScreenListViewToken<T>[];
+}) => void;
+type ListLayoutProps = ScreenScrollableProps & {
+    /** @deprecated Use extraBottomPadding. This replaces themed bottom padding; safeArea belongs to Screen. */
+    bottomInset?: number;
+};
+/** Native FlatList props with item inference retained across callbacks and refs. */
+type NativeScreenListProps<T> = ListLayoutProps & Omit<FlatListProps<T>, keyof ListLayoutProps | "data" | "renderItem" | "onViewableItemsChanged" | "viewabilityConfigCallbackPairs"> & {
+    /** Native FlatList is used by default. */
+    as?: typeof FlatList;
+    /** Null, undefined, and empty data use the empty slot. */
     data?: readonly T[] | null;
-    renderItem?: (info: ScreenListRenderItemInfo<T>) => ReactElement | null;
+    /** Render a row, including native separator helpers. */
+    renderItem: ListRenderItem<T>;
+    /** Item-typed native viewability callback. */
+    onViewableItemsChanged?: ViewabilityCallback<T> | null;
+    /** Item-typed native viewability callback/configuration pairs. */
+    viewabilityConfigCallbackPairs?: {
+        viewabilityConfig: NonNullable<FlatListProps<T>["viewabilityConfig"]>;
+        onViewableItemsChanged: ViewabilityCallback<T>;
+    }[];
+};
+/** Props an adapter must accept and forward to its scrollable list implementation. */
+export type ScreenListAdapterProps<T> = Pick<FlatListProps<T>, "style" | "contentContainerStyle" | "onScroll" | "ListHeaderComponent" | "ListFooterComponent" | "ListEmptyComponent" | "horizontal" | "scrollEventThrottle" | "contentInsetAdjustmentBehavior" | "automaticallyAdjustContentInsets" | "automaticallyAdjustsScrollIndicatorInsets" | "showsVerticalScrollIndicator" | "snapToOffsets"> & {
+    data?: readonly T[] | null;
+    renderItem: (info: ScreenListRenderItemInfo<T>) => ReactElement | null;
     keyExtractor?: (item: T, index: number) => string;
-    ListHeaderComponent?: ListHeaderComponent;
-    ListFooterComponent?: ListHeaderComponent;
-    ListEmptyComponent?: ListHeaderComponent;
-    style?: StyleProp<ViewStyle>;
-    contentContainerStyle?: StyleProp<ViewStyle>;
-    onScroll?: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
-    /**
-     * Extra bottom padding on the list content — clearance for a tab bar or
-     * home indicator. Defaults to the `layout.screen.margin.y` token when
-     * margins are enabled, otherwise `0`.
-     */
-    bottomInset?: number;
 };
+type AdapterKeys = "data" | "renderItem" | "onScroll" | "contentContainerStyle" | "ListHeaderComponent" | "ListFooterComponent" | "ListEmptyComponent";
+/** Custom lists must accept the adapter contract and forward a ref for Reanimated. */
+export type ScreenCustomListProps<T, As extends ElementType> = ListLayoutProps & ScreenListAdapterProps<T> & Omit<ComponentPropsWithoutRef<As>, keyof ListLayoutProps | keyof ScreenListAdapterProps<T>> & {
+    as: As & (As extends typeof FlatList ? never : AdapterKeys extends keyof ComponentPropsWithoutRef<As> ? readonly T[] extends NonNullable<ComponentPropsWithoutRef<As>["data"]> ? "ref" extends keyof ComponentPropsWithRef<As> ? unknown : never : never : never);
+    ref?: ComponentPropsWithRef<As>["ref"];
+};
+/** Screen list props, optionally parameterized by a custom adapter component. */
+export type ScreenListProps<T = unknown, As extends ElementType = typeof FlatList> = As extends typeof FlatList ? NativeScreenListProps<T> : ScreenCustomListProps<T, As>;
+interface ScreenListComponent {
+    <T>(props: ScreenListProps<T> & RefAttributes<FlatList<T>>): ReactElement | null;
+    <T, As extends ElementType>(props: ScreenCustomListProps<T, As>): ReactElement | null;
+    displayName?: string;
+}
 /**
- * Polymorphic list container — renders whichever list `as` names (defaults
- * to `FlatList`), applying the same margin/header/safe-area/scroll-handler
- * chrome regardless of which one it is. A screen can swap list
- * implementations by changing `as`, without relearning the surrounding API.
+ * Virtualized Screen content. FlatList is the default and its native ref and
+ * item callbacks retain their types. Native refreshing keeps rows visible;
+ * isLoading replaces them with loadingContent (a Spinner by default).
  *
- * @example
- * ```tsx
- * <Screen.List data={items} renderItem={({ item }) => <Row item={item} />} />
- * ```
+ * Custom `as` components must implement ScreenListAdapterProps, forward their
+ * ref, and forward the supplied scroll events, styles, and header/footer slots.
+ * Their native ref is forwarded to callers; useScreen().scrollRef is FlatList-only here.
+ * JS onScroll receives nativeEvent data without SyntheticEvent methods.
  *
- * @example Any other list component
+ * @example
  * ```tsx
- * import { FlashList } from '@shopify/flash-list';
- *
- * <Screen.List
- *   as={FlashList}
- *   data={items}
- *   renderItem={({ item }) => <Row item={item} />}
- * />
+ * <Screen safeArea="auto">
+ *   <Screen.List data={items} renderItem={({ item }) => <Row item={item} />}
+ *     isLoading={isLoading} refreshing={isRefreshing} onRefresh={refresh} />
+ * </Screen>
  * ```
  */
-export declare function ScreenList<T = unknown, As extends ElementType = typeof FlatList>({ as, data, renderItem, style, contentContainerStyle, ListHeaderComponent, ListFooterComponent, ListEmptyComponent, horizontal, loading, LoadingComponent, EmptyComponent, margins, bottomInset, onScroll, ...rest }: ScreenListProps<T, As>): import("react").JSX.Element;
-export declare namespace ScreenList {
-    var displayName: string;
-}
+export declare const ScreenList: ScreenListComponent;
+export {};
 //# sourceMappingURL=ScreenList.d.ts.map

package/lib/typescript/src/components/screen/ScreenList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenList.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EAEd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AActB,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AACpE,OAAO,EAA0B,KAAK,mBAAmB,EAAoB,MAAM,YAAS,CAAC;AAE7F,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,SAAS,WAAW,GAAG,OAAO,QAAQ,IAAI,qBAAqB,GACxG,IAAI,CACF,wBAAwB,CAAC,EAAE,CAAC,EAC1B,MAAM,GACN,YAAY,GACZ,cAAc,GACd,OAAO,GACP,uBAAuB,GACvB,UAAU,GACV,qBAAqB,GACrB,qBAAqB,GACrB,oBAAoB,GACpB,MAAM,qBAAqB,CAC9B,GAAG;IACF;;;;;;;;;;;OAWG;IACH,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,IAAI,CAAC;IACxE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,qBAAqB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACpE;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,SAAS,WAAW,GAAG,OAAO,QAAQ,EAAE,EAChF,EAAE,EACF,IAAI,EACJ,UAAU,EACV,KAAK,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,UAAkB,EAClB,OAAe,EACf,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,WAAW,EACX,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,+BAoFxB;yBArGe,UAAU"}
+{"version":3,"file":"ScreenList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenList.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/screen/ScreenScrollView.d.ts

@@ -1,71 +1,31 @@
 import { type ReactNode } from "react";
-import { type ScrollViewProps } from "react-native";
-import { type ScrollHandlerProcessed } from "react-native-reanimated";
+import { type ScrollViewProps, type StyleProp, type ViewStyle } from "react-native";
 import type { ScreenScrollableProps } from "./types.js";
+/** Native ScrollView props plus Screen layout, placeholders, and worklet support. */
 export interface ScreenScrollViewProps extends Omit<ScrollViewProps, "horizontal">, ScreenScrollableProps {
+    /** Content replaced while loading or empty. */
     children?: ReactNode;
-    /**
-     * Reanimated scroll handler for custom scroll-driven animation, composed
-     * alongside the screen's own scroll tracking and any JS `onScroll`
-     * callback. Runs on the UI thread — for simple JS-side callbacks, use
-     * `onScroll` instead; it doesn't require writing a worklet.
-     */
-    scrollHandler?: ScrollHandlerProcessed<Record<string, unknown>>;
+    /** Style the inner content View, excluding the header portal. */
+    contentStyle?: StyleProp<ViewStyle>;
+    /** Override empty-child detection, for example when a child component renders null. */
+    isEmpty?: boolean;
 }
 /**
- * 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 declare function ScreenScrollView({ children, style, contentContainerStyle, scrollHandler: externalScrollHandler, onScroll: onScrollProp, horizontal, loading, LoadingComponent, EmptyComponent, margins, ...rest }: ScreenScrollViewProps): import("react").JSX.Element;
+export declare const ScreenScrollView: import("react").ForwardRefExoticComponent<ScreenScrollViewProps & import("react").RefAttributes<import("react-native/types_generated/Libraries/Components/ScrollView/ScrollView").PublicScrollViewInstance>>;
 //# sourceMappingURL=ScreenScrollView.d.ts.map

package/lib/typescript/src/components/screen/ScreenScrollView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenScrollView.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAqD,KAAK,eAAe,EAAQ,MAAM,cAAc,CAAC;AAE7G,OAAiB,EACf,KAAK,sBAAsB,EAG5B,MAAM,yBAAyB,CAAC;AASjC,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAGpE,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,qBAAqB;IACvG,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,aAAa,EAAE,qBAAqB,EACpC,QAAQ,EAAE,YAAY,EACtB,UAAkB,EAClB,OAAe,EACf,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,GAAG,IAAI,EACR,EAAE,qBAAqB,+BA+DvB"}
+{"version":3,"file":"ScreenScrollView.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAW3G,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAG3E,qFAAqF;AACrF,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,qBAAqB;IACvG,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,8MA2D5B,CAAC"}

package/lib/typescript/src/components/screen/hooks/use-screen-ref.d.ts

@@ -0,0 +1,5 @@
+import { type Ref } from "react";
+import type { ScreenScrollRef } from "../ScreenContext.js";
+/** Bind the animated ref and the caller's native ref to the same instance. */
+export declare function useScreenRef<T>(screenRef: ScreenScrollRef | undefined, ref: Ref<T> | undefined): (instance: T | null) => (() => void) | undefined;
+//# sourceMappingURL=use-screen-ref.d.ts.map

package/lib/typescript/src/components/screen/hooks/use-screen-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-screen-ref.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/hooks/use-screen-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAe,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAkB,CAAC;AAExD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,cAEhF,CAAC,GAAG,IAAI,8BAgBtB"}

package/lib/typescript/src/components/screen/hooks/use-screen-scroll-handler.d.ts

@@ -0,0 +1,53 @@
+import type { ScrollViewProps } from "react-native";
+import { type ScrollHandlerProcessed } from "react-native-reanimated";
+/** Keeps scroll tracking on the UI thread and schedules optional JS callbacks on RN. */
+export declare function useScreenScrollHandler(screenScrollHandler: ScrollHandlerProcessed<Record<string, unknown>>, onScroll?: ScrollViewProps["onScroll"], externalScrollHandler?: ScrollHandlerProcessed<Record<string, unknown>>): (event: Readonly<{
+    bubbles: boolean | undefined;
+    cancelable: boolean | undefined;
+    currentTarget: number | import("react-native").HostInstance;
+    defaultPrevented: boolean | undefined;
+    dispatchConfig: Readonly<{
+        registrationName: string;
+    }>;
+    eventPhase: number | undefined;
+    preventDefault: () => void;
+    isDefaultPrevented: () => boolean;
+    stopPropagation: () => void;
+    isPropagationStopped: () => boolean;
+    isTrusted: boolean | undefined;
+    nativeEvent: Readonly<{
+        contentInset: Readonly<{
+            bottom: number;
+            left: number;
+            right: number;
+            top: number;
+        }>;
+        contentOffset: Readonly<{
+            y: number;
+            x: number;
+        }>;
+        contentSize: Readonly<{
+            height: number;
+            width: number;
+        }>;
+        layoutMeasurement: Readonly<{
+            height: number;
+            width: number;
+        }>;
+        velocity?: Readonly<{
+            y: number;
+            x: number;
+        }>;
+        zoomScale?: number;
+        responderIgnoreScroll?: boolean;
+        targetContentOffset?: Readonly<{
+            y: number;
+            x: number;
+        }>;
+    }>;
+    persist: () => void;
+    target: (number | undefined) | import("react-native").HostInstance;
+    timeStamp: number;
+    type: string | undefined;
+}>, context?: Record<string, unknown> | undefined) => void;
+//# sourceMappingURL=use-screen-scroll-handler.d.ts.map

package/lib/typescript/src/components/screen/hooks/use-screen-scroll-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-screen-scroll-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/hooks/use-screen-scroll-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2C,eAAe,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,yBAAyB,CAAC;AAGjC,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,mBAAmB,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpE,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,EACtC,qBAAqB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAiBxE"}

package/lib/typescript/src/components/screen/index.d.ts

@@ -4,9 +4,9 @@ export type { ScreenContextValue } from "./ScreenContext.js";
 export { useScreen } from "./ScreenContext.js";
 export type { ScreenFlatListProps } from "./ScreenFlatList.js";
 export { ScreenFlatList } from "./ScreenFlatList.js";
-export type { ScreenListProps } from "./ScreenList.js";
+export type { ScreenCustomListProps, ScreenListAdapterProps, ScreenListProps, ScreenListRenderItemInfo, ScreenListViewToken, } from "./ScreenList.js";
 export { ScreenList } from "./ScreenList.js";
 export type { ScreenScrollViewProps } from "./ScreenScrollView.js";
 export { ScreenScrollView } from "./ScreenScrollView.js";
-export type { ScreenMargins, ScreenScrollableProps } from "./types.js";
+export type { ScreenContentPadding, ScreenMargins, ScreenSafeArea, ScreenScrollableProps } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/screen/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAU,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAU,CAAC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAiB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAiB,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAkB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAU,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAU,CAAC;AAClC,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAiB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAiB,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAkB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,iBAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAC1C,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAS,CAAC"}

package/lib/typescript/src/components/screen/parts/ScreenFrame.d.ts

@@ -0,0 +1,6 @@
+import { type PropsWithChildren } from "react";
+import type { ScreenSafeAreaEdges } from "../types.js";
+export declare function ScreenFrame({ children, edges }: PropsWithChildren<{
+    edges: ScreenSafeAreaEdges;
+}>): import("react").JSX.Element;
+//# sourceMappingURL=ScreenFrame.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenFrame.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAqC,MAAM,OAAO,CAAC;AAMlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAU,CAAC;AAIpD,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,+BA0BjG"}

package/lib/typescript/src/components/screen/parts/ScreenHeaderAppearance.d.ts

@@ -0,0 +1,21 @@
+import { type Dispatch, type PropsWithChildren, type SetStateAction } from "react";
+import type { useAnimatedStyle } from "react-native-reanimated";
+type HeaderOpacityStyle = ReturnType<typeof useAnimatedStyle<{
+    opacity: number;
+}>>;
+interface HeaderBackground {
+    color: string;
+    animatedStyle?: HeaderOpacityStyle;
+}
+interface HeaderAppearance {
+    background: HeaderBackground | undefined;
+    setBackground: Dispatch<SetStateAction<HeaderBackground | undefined>>;
+}
+export declare const ScreenHeaderAppearanceContext: import("react").Context<HeaderAppearance | null>;
+export declare function ScreenHeaderAppearanceProvider({ children }: PropsWithChildren): import("react").JSX.Element;
+/** Only the designated header slot controls the screen's top safe-area color. */
+export declare function ScreenHeaderAppearanceSlot({ children }: PropsWithChildren): import("react").JSX.Element;
+/** Share the overlay's animated style so safe-area fading stays on the UI thread. */
+export declare function useHeaderBackground(color: string, animatedStyle?: HeaderOpacityStyle): void;
+export {};
+//# sourceMappingURL=ScreenHeaderAppearance.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenHeaderAppearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenHeaderAppearance.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenHeaderAppearance.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAKpB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAEnF,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED,UAAU,gBAAgB;IACxB,UAAU,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACzC,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC;CACvE;AAED,eAAO,MAAM,6BAA6B,kDAA+C,CAAC;AAG1F,wBAAgB,8BAA8B,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAM7E;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAKzE;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,kBAAkB,QAMpF"}

package/lib/typescript/src/components/screen/parts/ScreenPlaceholder.d.ts

@@ -1,22 +1,20 @@
 import type { ReactElement, ReactNode } from "react";
 import type { ScreenScrollableProps } from "../types.js";
 /**
- * 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 declare function ScreenPlaceholder({ children }: {
     children: ReactNode;
 }): import("react").JSX.Element;
-interface PlaceholderInput extends Pick<ScreenScrollableProps, "loading" | "LoadingComponent" | "EmptyComponent"> {
+interface ScreenPlaceholderOptions extends Pick<ScreenScrollableProps, "isLoading" | "loadingContent" | "emptyContent"> {
     /** Whether the container has nothing to render (empty `data`, no children). */
     isEmpty: boolean;
 }
 /**
- * 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 declare function renderScreenPlaceholder({ loading, LoadingComponent, EmptyComponent, isEmpty, }: PlaceholderInput): ReactElement | null;
+export declare function renderScreenPlaceholder({ isLoading, loadingContent, emptyContent, isEmpty, }: ScreenPlaceholderOptions): ReactElement | null;
 export {};
 //# sourceMappingURL=ScreenPlaceholder.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenPlaceholder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenPlaceholder.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenPlaceholder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAU,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAEtE;AAED,UAAU,gBACR,SAAQ,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;IACtF,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,OAAO,EACP,gBAAgB,EAChB,cAAc,EACd,OAAO,GACR,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI,CAQxC"}
+{"version":3,"file":"ScreenPlaceholder.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenPlaceholder.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAU,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAEtE;AAED,UAAU,wBACR,SAAQ,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACpF,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,SAAS,EACT,cAAc,EACd,YAAY,EACZ,OAAO,GACR,EAAE,wBAAwB,GAAG,YAAY,GAAG,IAAI,CAUhD"}

package/lib/typescript/src/components/screen/parts/ScreenSafeArea.android.d.ts

@@ -0,0 +1,7 @@
+import type { PropsWithChildren } from "react";
+import type { ScreenSafeAreaEdges } from "../types.js";
+/** Android combines system and native interface insets and consumes the selected edges. */
+export declare function ScreenSafeArea({ children, edges }: PropsWithChildren<{
+    edges: ScreenSafeAreaEdges;
+}>): import("react").JSX.Element;
+//# sourceMappingURL=ScreenSafeArea.android.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenSafeArea.android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenSafeArea.android.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenSafeArea.android.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAK9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAU,CAAC;AAOpD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,+BAMpG"}