react-native-terra-ui 0.1.0 → 0.2.0

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

@@ -1,12 +1,16 @@
 import { type ReactNode } from 'react';
 import Animated, { type AnimatedRef, type ScrollHandlerProcessed, type SharedValue } from 'react-native-reanimated';
+import type { ScreenMargins } from './types.js';
 export type ScreenScrollRef = AnimatedRef<Animated.ScrollView>;
+/** `PortalHost` name shared by `Screen.ScrollView` / `Screen.FlatList` and header variants that portal content into them. */
+export declare const SCREEN_HEADER_PORTAL_HOST = "screen-header";
 export interface ScreenContextValue {
     /**
-     * Whether scroll containers apply `layout.screen.margin` padding.
-     * Overridable per `Screen.ScrollView` / `Screen.FlatList`.
+     * Which axes scroll containers pad with `layout.screen.margin`.
+     * Overridable per `Screen.ScrollView` / `Screen.FlatList` /
+     * `Screen.FlashList` via their own `margins` prop.
      */
-    margins: boolean;
+    margins: ScreenMargins;
     /** Whether a `Screen.Header` is present. Used by scroll containers to add top inset. */
     hasHeader: boolean;
     /**
@@ -32,24 +36,23 @@ export interface ScreenContextValue {
     scrollRef: ScreenScrollRef;
     /** Scroll handler that mirrors offset into `scrollY`. */
     scrollHandler: ScrollHandlerProcessed<Record<string, unknown>>;
-    /** Whether the screen is hosted inside a tab navigator (affects edges). */
-    isInTabView: boolean;
+    background?: string;
 }
 export declare const ScreenContext: import("react").Context<ScreenContextValue | null>;
 export interface ScreenScrollProviderProps {
     children: ReactNode;
-    isInTabView: boolean;
-    /** Apply `layout.screen.margin` to scroll containers. Default true. */
-    margins?: boolean;
+    /** Which axes scroll containers pad with `layout.screen.margin`. Default `'all'`. */
+    margins?: ScreenMargins;
     /** Whether a `Screen.Header` child is present. Default false. */
     hasHeader?: boolean;
+    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}.
  */
-export declare function ScreenScrollProvider({ children, isInTabView, margins, hasHeader, }: ScreenScrollProviderProps): import("react").JSX.Element;
+export declare function ScreenScrollProvider({ background, children, margins, hasHeader, }: ScreenScrollProviderProps): import("react").JSX.Element;
 /**
  * Access the enclosing `Screen`'s shared scroll state, ref, and snap offsets.
  *

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,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAEf,OAAO,QAAQ,EAAE,EACf,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,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;IAC/D,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,WAAW,EACX,OAAc,EACd,SAAiB,GAClB,EAAE,yBAAyB,+BAiD3B;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,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAEf,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,+BAiD3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}

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

@@ -0,0 +1,43 @@
+import { type FlashListProps } from '@shopify/flash-list';
+import type { ScreenScrollableProps } from './types.js';
+export interface ScreenFlashListProps<T> extends Omit<FlashListProps<T>, '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;
+}
+/**
+ * `FlashList` variant of `Screen.ScrollView`: mirrors scroll offset into the
+ * screen's shared `scrollY`, hosts the portal target above the list, and
+ * applies token-driven content padding.
+ *
+ * Requires `@shopify/flash-list` — it is a peer dependency of
+ * `react-native-terra-ui` and must be installed in the consuming app.
+ *
+ * Note: unlike `Screen.FlatList`, this does not bind the screen's shared
+ * imperative `scrollRef` — `FlashList`'s ref exposes a different (non
+ * Reanimated-compatible) imperative API.
+ *
+ * Shares `loading` / `LoadingComponent` / `EmptyComponent` / `margins` /
+ * `horizontal` with `Screen.ScrollView`, so a screen can swap one container for
+ * another without relearning its API.
+ *
+ * @example
+ * ```tsx
+ * <Screen.FlashList data={items} renderItem={({ item }) => <Row item={item} />} />
+ * ```
+ *
+ * @example Loading and empty placeholders
+ * ```tsx
+ * <Screen.FlashList
+ *   data={items}
+ *   loading={isLoading}
+ *   EmptyComponent={<EmptyState icon="status.info" title="Nothing yet" fill />}
+ *   renderItem={({ item }) => <Row item={item} />}
+ * />
+ * ```
+ */
+export declare function ScreenFlashList<T>({ data, style, contentContainerStyle, ListHeaderComponent, ListFooterComponent, ListEmptyComponent, horizontal, loading, LoadingComponent, EmptyComponent, margins, bottomInset, onScroll, ...rest }: ScreenFlashListProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=ScreenFlashList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenFlashList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenFlashList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrE,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAOpE,MAAM,WAAW,oBAAoB,CAAC,CAAC,CACrC,SAAQ,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAC3C,qBAAqB;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EACjC,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,oBAAoB,CAAC,CAAC,CAAC,+BAkFzB"}

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

@@ -1,10 +1,6 @@
 import { type FlatListProps } from 'react-native';
-export interface ScreenFlatListProps<T> extends Omit<FlatListProps<T>, 'CellRendererComponent'> {
-    /**
-     * Apply `layout.screen.margin` padding. Defaults to the enclosing `Screen`'s
-     * `margins` value.
-     */
-    margins?: boolean;
+import type { ScreenScrollableProps } from './types.js';
+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
@@ -17,10 +13,24 @@ export interface ScreenFlatListProps<T> extends Omit<FlatListProps<T>, 'CellRend
  * 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.
+ *
  * @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>({ style, contentContainerStyle, ListHeaderComponent, margins, bottomInset, onScroll, ...rest }: ScreenFlatListProps<T>): import("react").JSX.Element;
+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;
 //# 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":"AAMA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,cAAc,CAAC;AActB,MAAM,WAAW,mBAAmB,CAAC,CAAC,CACpC,SAAQ,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACvD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,EAChC,KAAK,EACL,qBAAqB,EACrB,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,mBAAmB,CAAC,CAAC,CAAC,+BAsDxB"}
+{"version":3,"file":"ScreenFlatList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenFlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,cAAc,CAAC;AAatB,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAGpE,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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;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,+BA2ExB"}

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

@@ -1,22 +1,14 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import { type ScrollViewProps } from 'react-native';
 import { type ScrollHandlerProcessed } from 'react-native-reanimated';
-export interface ScreenScrollViewProps extends ScrollViewProps {
+import type { ScreenScrollableProps } from './types.js';
+export interface ScreenScrollViewProps extends Omit<ScrollViewProps, 'horizontal'>, ScreenScrollableProps {
     children?: ReactNode;
     /**
-     * Apply `layout.screen.margin` padding. Defaults to the enclosing `Screen`'s
-     * `margins` value.
-     */
-    hasMargins?: boolean;
-    /**
-     * Extra bottom padding on the scroll 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;
-    /**
-     * Optional Reanimated scroll handler composed with the screen's own scroll
-     * tracking and any JS `onScroll` callback.
+     * 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>>;
 }
@@ -25,12 +17,55 @@ export interface ScreenScrollViewProps extends ScrollViewProps {
  * ref, mirrors offset into `scrollY`, hosts the portal target at the top (where
  * header content is injected), and applies token-driven content padding.
  *
+ * 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.
+ *
  * @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>
+ * ```
  */
-export declare function ScreenScrollView({ children, style, contentContainerStyle, hasMargins, bottomInset, scrollHandler: externalScrollHandler, onScroll: onScrollProp, horizontal, ...rest }: ScreenScrollViewProps): import("react").JSX.Element;
+export declare function ScreenScrollView({ children, style, contentContainerStyle, scrollHandler: externalScrollHandler, onScroll: onScrollProp, horizontal, loading, LoadingComponent, EmptyComponent, margins, ...rest }: ScreenScrollViewProps): import("react").JSX.Element;
 //# 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,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,cAAc,CAAC;AAEtB,OAAiB,EACf,KAAK,sBAAsB,EAG5B,MAAM,yBAAyB,CAAC;AAQjC,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,KAAK,EACL,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,aAAa,EAAE,qBAAqB,EACpC,QAAQ,EAAE,YAAY,EACtB,UAAkB,EAClB,GAAG,IAAI,EACR,EAAE,qBAAqB,+BAmEvB"}
+{"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,EAGL,KAAK,eAAe,EAErB,MAAM,cAAc,CAAC;AAEtB,OAAiB,EACf,KAAK,sBAAsB,EAG5B,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAGpE,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,EACzC,qBAAqB;IACvB,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,+BAoEvB"}

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

@@ -2,8 +2,11 @@ export type { ScreenHeaderProps, ScreenProps } from './Screen.js';
 export { Screen } from './Screen.js';
 export type { ScreenContextValue } from './ScreenContext.js';
 export { useScreen } from './ScreenContext.js';
+export type { ScreenFlashListProps } from './ScreenFlashList.js';
+export { ScreenFlashList } from './ScreenFlashList.js';
 export type { ScreenFlatListProps } from './ScreenFlatList.js';
 export { ScreenFlatList } from './ScreenFlatList.js';
 export type { ScreenScrollViewProps } from './ScreenScrollView.js';
 export { ScreenScrollView } from './ScreenScrollView.js';
+export type { ScreenMargins, 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,qBAAqB,EAAE,MAAM,uBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,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,oBAAoB,EAAE,MAAM,sBAAmB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAmB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAkB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,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"}

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

@@ -0,0 +1,30 @@
+/**
+ * Bottom clearance that measures itself.
+ *
+ * The insets Unistyles reports are the window's, which cover the system bars and
+ * nothing else — 24dp for the gesture bar on a Pixel — while a native tab bar
+ * sits on top of them for another 80dp and overlaps the content beneath it.
+ * `react-native-screens` tracks that second one separately, as an *interface*
+ * inset, and reports it to its own `SafeAreaView`; asking a view is the only way
+ * to learn it. Neither `runtime.insets.bottom` nor `useSafeAreaInsets()` knows
+ * about it — both read 24 on a tab screen — and a constant would be wrong the
+ * moment the bar is absent, which is every pushed screen.
+ *
+ * `insetType="all"` covers system and interface both, so this view owns the
+ * whole bottom edge — which is why the scroll containers pad only their margin;
+ * adding the window inset there too would double-count the gesture bar.
+ * `"interface"` alone would be wrong: it measures the same on a tab screen (the
+ * bar's inset already spans the gesture bar beneath it) but reports nothing on a
+ * pushed screen, which would then lose its gesture-bar clearance.
+ *
+ * `insetType` is Android-only; on iOS the bottom safe area of a view inside a
+ * tab controller already includes the bar. Measured on a tab screen: 132dp on a
+ * Pixel, 95pt on an iPhone 17 — against the 24dp / 34pt the window insets
+ * report, which is the gap this closes.
+ *
+ * `flex: 0` cancels the `flex: 1` that `SafeAreaView` sets on itself, which
+ * would otherwise stretch it into the leftover space of a list shorter than the
+ * viewport. With no children, its height is exactly the padding it applies.
+ */
+export declare function BottomSafeArea(): import("react").JSX.Element;
+//# sourceMappingURL=BottomSafeArea.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BottomSafeArea.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/BottomSafeArea.tsx"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,gCAE7B"}

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

@@ -0,0 +1,22 @@
+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.
+ */
+export declare function ScreenPlaceholder({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+interface PlaceholderInput extends Pick<ScreenScrollableProps, 'loading' | 'LoadingComponent' | 'EmptyComponent'> {
+    /** 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.
+ */
+export declare function renderScreenPlaceholder({ loading, LoadingComponent, EmptyComponent, isEmpty, }: PlaceholderInput): ReactElement | null;
+export {};
+//# sourceMappingURL=ScreenPlaceholder.d.ts.map

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

@@ -0,0 +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,CACV,qBAAqB,EACrB,SAAS,GAAG,kBAAkB,GAAG,gBAAgB,CAClD;IACD,+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,CAUxC"}

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

@@ -0,0 +1,42 @@
+import type { ReactNode } from 'react';
+/**
+ * Which axes of the `layout.screen.margin` token a scroll container pads its
+ * content with.
+ *
+ * `'y'` pads the top and bottom of the content area. It stacks on top of the
+ * structural insets — the header height and the safe area — which apply
+ * whether or not margins are on.
+ */
+export type ScreenMargins = 'all' | 'x' | 'y' | 'none';
+/**
+ * Props shared by `Screen.ScrollView`, `Screen.FlatList` and
+ * `Screen.FlashList`, so a screen can swap one container for another without
+ * relearning its API.
+ */
+export interface ScreenScrollableProps {
+    /** Lay content out along the x axis. Defaults to `false`. */
+    horizontal?: boolean;
+    /**
+     * Renders a centred placeholder in the content area instead of the content —
+     * spares every screen from hand-rolling a loading branch while its data
+     * arrives. The `Screen.Header` still renders, so the chrome stays put.
+     */
+    loading?: boolean;
+    /**
+     * Node shown while `loading`. Defaults to a `Spinner`; it is centred in the
+     * content area either way.
+     */
+    LoadingComponent?: ReactNode;
+    /**
+     * Node shown, centred, when there is nothing to render and `loading` is
+     * false — an empty `data` array on the list containers, no children on
+     * `Screen.ScrollView`. Omit it to render nothing.
+     */
+    EmptyComponent?: ReactNode;
+    /**
+     * Which axes get `layout.screen.margin` padding. Defaults to the enclosing
+     * `Screen`'s `margins`.
+     */
+    margins?: ScreenMargins;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB"}

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

@@ -1,10 +1,10 @@
-import type { LayoutTokens } from '#theme/types';
-export declare function resolveScreenContentInsets(margin: LayoutTokens['screen']['margin'], margins: boolean, bottomInset?: number, topInset?: number): {
-    contentPadding: {
-        flexGrow: 1;
-        paddingTop: number;
-        paddingHorizontal: number;
-        paddingBottom: number;
-    };
-};
+import { type ComponentType, type ReactElement } from 'react';
+import type { ScreenMargins } from './types.js';
+export type ListHeaderComponent = ComponentType | ReactElement | null | undefined;
+/** Renders a `ListHeaderComponent`-shaped prop (element, component, or nullish) into an element. */
+export declare function renderListHeader(ListHeaderComponent: ListHeaderComponent): ReactElement | null;
+/** Whether `margins` pads the horizontal axis. */
+export declare const hasXMargin: (margins: ScreenMargins) => boolean;
+/** Whether `margins` pads the vertical axis (the bottom of the content area). */
+export declare const hasYMargin: (margins: ScreenMargins) => boolean;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EACxC,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM;;;;;;;EAUlB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGlB,KAAK,YAAY,EAClB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAS,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,YAAY,GACZ,IAAI,GACJ,SAAS,CAAC;AAEd,oGAAoG;AACpG,wBAAgB,gBAAgB,CAC9B,mBAAmB,EAAE,mBAAmB,GACvC,YAAY,GAAG,IAAI,CAIrB;AAED,kDAAkD;AAClD,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,KAAG,OACd,CAAC;AAEvC,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,KAAG,OACd,CAAC"}

package/lib/typescript/src/components/spinner/Spinner.d.ts

@@ -1,4 +1,4 @@
-import type { ColorToken } from '#theme/types';
+import type { ColorToken } from '../../theme/types';
 export type SpinnerSize = 'sm' | 'md' | 'lg';
 export interface SpinnerProps {
     /** Spinner diameter preset. Defaults to `'md'`. */

package/lib/typescript/src/components/surface/Surface.d.ts

@@ -1,4 +1,4 @@
-import type { ElevationKey } from '#theme/types';
+import type { ElevationKey } from '../../theme/types';
 import { type BoxProps } from '../box/index.js';
 /** Background level of a {@link Surface}. */
 export type SurfaceVariant = 'base' | 'raised' | 'sunken' | 'transparent';
@@ -20,6 +20,13 @@ export interface SurfaceProps extends Omit<BoxProps, 'bg'> {
  * default (overridable via `radius`), and an optional drop shadow via
  * `elevation`. All other Box style-props are accepted.
  *
+ * Every visual decision is expressed as a **theme token key** handed to `Box`,
+ * which resolves it against the active theme. Surface therefore never reads the
+ * theme itself — no `useUnistyles()` in the render path, and no stylesheet
+ * crossing a component boundary (a Unistyles style handed to `Box` would land
+ * on a plain `View` the Babel plugin has not processed, and so would freeze at
+ * whichever theme was active when it was created).
+ *
  * @example
  * ```tsx
  * <Surface variant="raised" elevation="md" p="4" radius="lg">

package/lib/typescript/src/components/surface/Surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/components/surface/Surface.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,iBAAQ,CAAC;AAEnE,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1E,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxD,sDAAsD;IACtD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AA6BD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,0LAiCnB,CAAC"}
+{"version":3,"file":"Surface.d.ts","sourceRoot":"","sources":["../../../../../src/components/surface/Surface.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,iBAAQ,CAAC;AAEnE,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE1E,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxD,sDAAsD;IACtD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AAmCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,0LAmBnB,CAAC"}

package/lib/typescript/src/components/text/Text.d.ts

@@ -1,5 +1,5 @@
 import { type TextProps as RNTextProps } from 'react-native';
-import type { ColorToken, FontWeightToken, TextVariant } from '#theme/types';
+import type { ColorToken, FontWeightToken, TextVariant } from '../../theme/types';
 export type TextAlign = 'left' | 'center' | 'right' | 'justify';
 export interface TextProps extends RNTextProps {
     /** Typographic role. Defaults to `body-md`. */

package/lib/typescript/src/components/text/Text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/Text.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,IAAI,WAAW,EAE9B,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAGf,WAAW,EACZ,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAiBhE,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,uLA2DhB,CAAC"}
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../../../src/components/text/Text.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,IAAI,WAAW,EAE9B,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAGf,WAAW,EACZ,MAAM,cAAc,CAAC;AAKtB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAiBhE,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC5C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,uLAkEhB,CAAC"}

package/lib/typescript/src/components/toast/Toast.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from 'react';
 import type { PressableProps } from 'react-native';
-import type { TerraIconName } from '#theme/types';
+import type { TerraIconName } from '../../theme/types';
 import { type ButtonProps } from '../button/index.js';
 import { type IconProps } from '../icon/index.js';
 import { type SurfaceProps } from '../surface/index.js';

package/lib/typescript/src/components/toolbar/Toolbar.d.ts

@@ -0,0 +1,115 @@
+import { type ReactNode } from 'react';
+import { type PressableProps, type ViewProps } from 'react-native';
+import type { ColorToken, SpacingKey, TerraIconName } from '../../theme/types';
+interface ToolbarButtonBaseProps extends Omit<PressableProps, 'children' | 'style'> {
+    /** Icon to render, before the label when both are given. */
+    icon?: TerraIconName;
+    /** Icon size in density-independent pixels. Defaults to `20`. */
+    iconSize?: number;
+    /**
+     * Foreground token for the icon and label. Defaults to the group's `tint`,
+     * or `text.default` outside a group.
+     */
+    tint?: ColorToken;
+    /**
+     * Fill. Defaults to `surface.default` standalone, and to `transparent`
+     * inside a {@link ToolbarGroup}, which paints the shared capsule instead.
+     * Set it explicitly to opt back out of the group's fill.
+     */
+    background?: ColorToken;
+    /**
+     * Label content. A `string` or `number` renders as themed text in the
+     * button's `tint`; anything else renders as given. The cell grows
+     * horizontally to fit, so a text item is a pill rather than a circle.
+     */
+    children?: ReactNode;
+    /**
+     * Merged over the base style, so a single item can be repositioned (e.g.
+     * pinned over a hero image) without a wrapper view. Supports `Pressable`'s
+     * function form for press-state styling.
+     */
+    style?: PressableProps['style'];
+}
+/**
+ * An icon-only button has no visible text, so it must carry an
+ * `accessibilityLabel`; one with children may rely on them instead.
+ */
+export type ToolbarButtonProps = ToolbarButtonBaseProps & ({
+    children: ReactNode;
+    accessibilityLabel?: string;
+} | {
+    icon: TerraIconName;
+    accessibilityLabel: string;
+});
+/**
+ * An action inside a toolbar — a circular icon button, a text pill, or both.
+ * Paints its own capsule standalone, and goes transparent inside a
+ * {@link ToolbarGroup} so the group's shared capsule shows through.
+ *
+ * @example
+ * ```tsx
+ * <Toolbar.Button icon="share" accessibilityLabel="Share" onPress={share} />
+ * <Toolbar.Button onPress={save}>Save</Toolbar.Button>
+ * ```
+ */
+export declare function ToolbarButton({ icon, iconSize, tint, background, children, accessibilityLabel, onPress, hitSlop, style, ...rest }: ToolbarButtonProps): import("react").JSX.Element;
+export interface ToolbarGroupProps extends ViewProps {
+    /** Capsule fill. Defaults to `surface.default`. */
+    background?: ColorToken;
+    /**
+     * Foreground token inherited by every item's icon and label. Defaults to
+     * `text.default`; a per-item `tint` still wins.
+     */
+    tint?: ColorToken;
+    children?: ReactNode;
+}
+/**
+ * Wraps several {@link ToolbarButton}s in one shared capsule — the iOS
+ * `ToolbarItemGroup` look. Children drop their individual circular fill and
+ * inherit the group's, so the row reads as a single segmented pill.
+ *
+ * No height of its own: the capsule takes the height of its tallest child, and
+ * its full radius clamps to half of that for an exact stadium.
+ *
+ * @example
+ * ```tsx
+ * <Toolbar.Group>
+ *   <Toolbar.Button icon="add" accessibilityLabel="Add" onPress={add} />
+ *   <Toolbar.Button icon="download" accessibilityLabel="Save" onPress={save} />
+ * </Toolbar.Group>
+ * ```
+ */
+export declare const ToolbarGroup: import("react").ForwardRefExoticComponent<ToolbarGroupProps & import("react").RefAttributes<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>>;
+export interface ToolbarProps extends ViewProps {
+    /**
+     * Space between groups and standalone items. Defaults to `'2'` (8dp) — the
+     * separator between a capsule and an adjacent standalone item.
+     */
+    gap?: SpacingKey;
+    children?: ReactNode;
+}
+/**
+ * A row of {@link ToolbarGroup}s and standalone {@link ToolbarButton}s. The
+ * header's `LeftToolbar` / `RightToolbar` slots supply one automatically, so
+ * you only need to render it yourself when placing a toolbar elsewhere — over
+ * a hero image, or floating above content.
+ *
+ * @example
+ * ```tsx
+ * <Toolbar style={{ position: 'absolute', right: 16, bottom: 24 }}>
+ *   <Toolbar.Group>
+ *     <Toolbar.Button icon="add" accessibilityLabel="Add" onPress={add} />
+ *     <Toolbar.Button icon="download" accessibilityLabel="Save" onPress={save} />
+ *   </Toolbar.Group>
+ *   <Toolbar.Button icon="share" accessibilityLabel="Share" onPress={share} />
+ * </Toolbar>
+ * ```
+ */
+declare const ToolbarRoot: import("react").ForwardRefExoticComponent<ToolbarProps & import("react").RefAttributes<import("react-native/types_generated/src/private/webapis/dom/nodes/ReactNativeElement").default>>;
+type ToolbarComponent = typeof ToolbarRoot & {
+    Group: typeof ToolbarGroup;
+    Button: typeof ToolbarButton;
+};
+export declare const Toolbar: ToolbarComponent;
+export {};
+//# sourceMappingURL=Toolbar.d.ts.map

package/lib/typescript/src/components/toolbar/Toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../../../../../src/components/toolbar/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4C1E,UAAU,sBACR,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,OAAO,CAAC;IAClD,4DAA4D;IAC5D,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GACrD,CACI;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,CACtD,CAAC;AAEJ;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,QAAa,EACb,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,OAAO,EACP,OAAkB,EAClB,KAAK,EACL,GAAG,IAAI,EACR,EAAE,kBAAkB,+BAwCpB;AAyBD,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,mDAAmD;IACnD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,+LAyBvB,CAAC;AAIH,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C;;;OAGG;IACH,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,WAAW,0LAQhB,CAAC;AAEF,KAAK,gBAAgB,GAAG,OAAO,WAAW,GAAG;IAC3C,KAAK,EAAE,OAAO,YAAY,CAAC;IAC3B,MAAM,EAAE,OAAO,aAAa,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAkB,gBAAgB,CAAC"}

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

@@ -0,0 +1,3 @@
+export type { ToolbarButtonProps, ToolbarGroupProps, ToolbarProps, } from './Toolbar.js';
+export { Toolbar } from './Toolbar.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/toolbar/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,cAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAW,CAAC"}

package/lib/typescript/src/context/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/context/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EAKvB,MAAM,OAAO,CAAC;AAMf,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAgB,CAAC;AAezD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,iBAAiB,gCAkB9D,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAezC"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/context/ThemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EAKvB,MAAM,OAAO,CAAC;AAKf,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAgB,CAAC;AAezD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,iBAAiB,gCAoB9D,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kCAAkC;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAezC"}

package/lib/typescript/src/{components/icon/utils.d.ts → theme/defaults/icons.d.ts}

@@ -1,4 +1,4 @@
-import type { TerraIconComponent, TerraSemanticIconName } from '#theme/types';
+import type { TerraIconComponent, TerraSemanticIconName } from '../types.js';
 export declare const PersonIcon: TerraIconComponent;
 export declare const defaultIcons: Record<TerraSemanticIconName, TerraIconComponent>;
-//# sourceMappingURL=utils.d.ts.map
+//# sourceMappingURL=icons.d.ts.map

package/lib/typescript/src/theme/defaults/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../../src/theme/defaults/icons.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAElB,qBAAqB,EACtB,MAAM,aAAU,CAAC;AAsHlB,eAAO,MAAM,UAAU,EAAE,kBAWxB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,CAS1E,CAAC"}

package/lib/typescript/src/theme/defaults/image.d.ts

@@ -0,0 +1,4 @@
+import type { TerraImageComponent } from '../types.js';
+/** Default image implementation, backed by React Native's `Image`. */
+export declare const defaultImage: TerraImageComponent;
+//# sourceMappingURL=image.d.ts.map