react-native-terra-ui 0.1.0 → 0.2.0

package/lib/module/components/portal/Portal.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { useContext, useEffect, useRef } from 'react';
+import { PortalContext } from "./PortalContext.js";
+import { PortalHost } from "./PortalHost.js";
+import { PortalProvider } from "./PortalProvider.js";
+let nextPortalKey = 1;
+const PortalComponent = ({
+  hostName,
+  children
+}) => {
+  const context = useContext(PortalContext);
+  const upsertPortal = context?.upsertPortal;
+  const removePortal = context?.removePortal;
+  const portalKeyRef = useRef(nextPortalKey++);
+  useEffect(() => {
+    if (!upsertPortal || !removePortal) {
+      return;
+    }
+    upsertPortal(hostName, portalKeyRef.current, children ?? null);
+    return () => {
+      removePortal(hostName, portalKeyRef.current);
+    };
+  }, [children, hostName, removePortal, upsertPortal]);
+  return null;
+};
+/**
+ * Declaratively teleports `children` into the `PortalHost` named `hostName`,
+ * for as long as this component stays mounted.
+ *
+ * @example
+ * ```tsx
+ * <Portal hostName="screen-header">
+ *   <LargeTitle />
+ * </Portal>
+ * ```
+ */
+export const Portal = Object.assign(PortalComponent, {
+  Provider: PortalProvider,
+  Host: PortalHost
+});
+//# sourceMappingURL=Portal.js.map

package/lib/module/components/portal/Portal.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","useEffect","useRef","PortalContext","PortalHost","PortalProvider","nextPortalKey","PortalComponent","hostName","children","context","upsertPortal","removePortal","portalKeyRef","current","Portal","Object","assign","Provider","Host"],"sourceRoot":"../../../../src","sources":["components/portal/Portal.tsx"],"mappings":";;AAAA,SAAkCA,UAAU,EAAEC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AAE9E,SAASC,aAAa;AACtB,SAASC,UAAU;AACnB,SAASC,cAAc;AAEvB,IAAIC,aAAa,GAAG,CAAC;AAQrB,MAAMC,eAAgC,GAAGA,CAAC;EAAEC,QAAQ;EAAEC;AAAS,CAAC,KAAK;EACnE,MAAMC,OAAO,GAAGV,UAAU,CAACG,aAAa,CAAC;EACzC,MAAMQ,YAAY,GAAGD,OAAO,EAAEC,YAAY;EAC1C,MAAMC,YAAY,GAAGF,OAAO,EAAEE,YAAY;EAC1C,MAAMC,YAAY,GAAGX,MAAM,CAASI,aAAa,EAAE,CAAC;EAEpDL,SAAS,CAAC,MAAM;IACd,IAAI,CAACU,YAAY,IAAI,CAACC,YAAY,EAAE;MAClC;IACF;IAEAD,YAAY,CAACH,QAAQ,EAAEK,YAAY,CAACC,OAAO,EAAEL,QAAQ,IAAI,IAAI,CAAC;IAE9D,OAAO,MAAM;MACXG,YAAY,CAACJ,QAAQ,EAAEK,YAAY,CAACC,OAAO,CAAC;IAC9C,CAAC;EACH,CAAC,EAAE,CAACL,QAAQ,EAAED,QAAQ,EAAEI,YAAY,EAAED,YAAY,CAAC,CAAC;EAEpD,OAAO,IAAI;AACb,CAAC;AAOD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,MAAM,GAAGC,MAAM,CAACC,MAAM,CAACV,eAAe,EAAE;EACnDW,QAAQ,EAAEb,cAAc;EACxBc,IAAI,EAAEf;AACR,CAAC,CAAwB","ignoreList":[]}

package/lib/module/components/portal/PortalContext.js

@@ -1,20 +1,5 @@
 "use strict";
 
-import { createContext, useContext } from 'react';
+import { createContext } from 'react';
 export const PortalContext = /*#__PURE__*/createContext(null);
-
-/**
- * Access the nearest {@link PortalProvider}. Used by components that need to
- * teleport content into a `PortalHost` rendered elsewhere in the tree (e.g. the
- * large-title header injecting its title into the scroll content).
- *
- * @throws if called outside a `PortalProvider`.
- */
-export function usePortal() {
-  const context = useContext(PortalContext);
-  if (!context) {
-    throw new Error('usePortal must be used within a PortalProvider');
-  }
-  return context;
-}
 //# sourceMappingURL=PortalContext.js.map

package/lib/module/components/portal/PortalContext.js.map

@@ -1 +1 @@
-{"version":3,"names":["createContext","useContext","PortalContext","usePortal","context","Error"],"sourceRoot":"../../../../src","sources":["components/portal/PortalContext.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAkBC,UAAU,QAAQ,OAAO;AAWjE,OAAO,MAAMC,aAAa,gBAAGF,aAAa,CAA4B,IAAI,CAAC;;AAE3E;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,SAASA,CAAA,EAAuB;EAC9C,MAAMC,OAAO,GAAGH,UAAU,CAACC,aAAa,CAAC;EACzC,IAAI,CAACE,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,gDAAgD,CAAC;EACnE;EACA,OAAOD,OAAO;AAChB","ignoreList":[]}
+{"version":3,"names":["createContext","PortalContext"],"sourceRoot":"../../../../src","sources":["components/portal/PortalContext.tsx"],"mappings":";;AAAA,SAASA,aAAa,QAAwB,OAAO;AAkBrD,OAAO,MAAMC,aAAa,gBAAGD,aAAa,CAA4B,IAAI,CAAC","ignoreList":[]}

package/lib/module/components/portal/PortalHost.js

@@ -1,23 +1,25 @@
 "use strict";
 
+import { Fragment, useContext } from 'react';
 import { View } from 'react-native';
-import { usePortal } from "./PortalContext.js";
-
+import { PortalContext } from "./PortalContext.js";
+import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * Renders every node currently registered with the nearest
- * {@link PortalProvider}, in insertion order. Place it where teleported content
- * should appear (e.g. at the top of a `Screen.ScrollView`).
+ * Renders every entry currently registered under `name` on the nearest
+ * {@link PortalProvider}. Place it where teleported content should appear
+ * (e.g. at the top of a `Screen.ScrollView`).
  */
-import { jsx as _jsx } from "react/jsx-runtime";
-export function PortalHost() {
-  const {
-    contents
-  } = usePortal();
+export function PortalHost({
+  name,
+  ...viewProps
+}) {
+  const context = useContext(PortalContext);
+  const hostPortals = context?.portals[name] ?? [];
   return /*#__PURE__*/_jsx(View, {
-    collapsable: false,
-    children: Array.from(contents.entries()).map(([id, content]) => /*#__PURE__*/_jsx(View, {
-      children: content
-    }, id))
+    ...viewProps,
+    children: hostPortals.map(entry => /*#__PURE__*/_jsx(Fragment, {
+      children: entry.node
+    }, entry.key))
   });
 }
 //# sourceMappingURL=PortalHost.js.map

package/lib/module/components/portal/PortalHost.js.map

@@ -1 +1 @@
-{"version":3,"names":["View","usePortal","jsx","_jsx","PortalHost","contents","collapsable","children","Array","from","entries","map","id","content"],"sourceRoot":"../../../../src","sources":["components/portal/PortalHost.tsx"],"mappings":";;AAAA,SAASA,IAAI,QAAQ,cAAc;AAEnC,SAASC,SAAS,QAAQ,oBAAiB;;AAE3C;AACA;AACA;AACA;AACA;AAJA,SAAAC,GAAA,IAAAC,IAAA;AAKA,OAAO,SAASC,UAAUA,CAAA,EAAG;EAC3B,MAAM;IAAEC;EAAS,CAAC,GAAGJ,SAAS,CAAC,CAAC;EAEhC,oBACEE,IAAA,CAACH,IAAI;IAACM,WAAW,EAAE,KAAM;IAAAC,QAAA,EACtBC,KAAK,CAACC,IAAI,CAACJ,QAAQ,CAACK,OAAO,CAAC,CAAC,CAAC,CAACC,GAAG,CAAC,CAAC,CAACC,EAAE,EAAEC,OAAO,CAAC,kBAChDV,IAAA,CAACH,IAAI;MAAAO,QAAA,EAAWM;IAAO,GAAZD,EAAmB,CAC/B;EAAC,CACE,CAAC;AAEX","ignoreList":[]}
+{"version":3,"names":["Fragment","useContext","View","PortalContext","jsx","_jsx","PortalHost","name","viewProps","context","hostPortals","portals","children","map","entry","node","key"],"sourceRoot":"../../../../src","sources":["components/portal/PortalHost.tsx"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,UAAU,QAAQ,OAAO;AAC5C,SAASC,IAAI,QAAwB,cAAc;AAEnD,SAASC,aAAa;AAA0B,SAAAC,GAAA,IAAAC,IAAA;AAOhD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAAC;EAAEC,IAAI;EAAE,GAAGC;AAA2B,CAAC,EAAE;EAClE,MAAMC,OAAO,GAAGR,UAAU,CAACE,aAAa,CAAC;EACzC,MAAMO,WAAW,GAAGD,OAAO,EAAEE,OAAO,CAACJ,IAAI,CAAC,IAAI,EAAE;EAEhD,oBACEF,IAAA,CAACH,IAAI;IAAA,GAAKM,SAAS;IAAAI,QAAA,EAChBF,WAAW,CAACG,GAAG,CAAEC,KAAK,iBACrBT,IAAA,CAACL,QAAQ;MAAAY,QAAA,EAAkBE,KAAK,CAACC;IAAI,GAAtBD,KAAK,CAACE,GAA2B,CACjD;EAAC,CACE,CAAC;AAEX","ignoreList":[]}

package/lib/module/components/portal/PortalProvider.js

@@ -4,34 +4,66 @@ import { useCallback, useMemo, useState } from 'react';
 import { PortalContext } from "./PortalContext.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * Holds a registry of teleported content. Children register/unregister nodes by
- * id (see {@link usePortal}); a `PortalHost` placed anywhere below renders them.
- * Context-only — no animation dependency.
+ * Holds a registry of teleported content, keyed by host name. Descendant
+ * `Portal` components register/unregister entries; a `PortalHost` placed
+ * anywhere below renders the entries for its `name`.
  */
 export function PortalProvider({
   children
 }) {
-  const [contents, setContents] = useState(() => new Map());
-  const registerContent = useCallback((id, content) => {
-    setContents(prev => {
-      const next = new Map(prev);
-      next.set(id, content);
-      return next;
+  const [portals, setPortals] = useState({});
+  const upsertPortal = useCallback((hostName, key, node) => {
+    setPortals(prev => {
+      const hostPortals = prev[hostName] ?? [];
+      const existingIndex = hostPortals.findIndex(entry => entry.key === key);
+      if (existingIndex === -1) {
+        return {
+          ...prev,
+          [hostName]: [...hostPortals, {
+            key,
+            node
+          }]
+        };
+      }
+      if (hostPortals[existingIndex]?.node === node) {
+        return prev;
+      }
+      const nextHostPortals = [...hostPortals];
+      nextHostPortals[existingIndex] = {
+        key,
+        node
+      };
+      return {
+        ...prev,
+        [hostName]: nextHostPortals
+      };
     });
   }, []);
-  const unregisterContent = useCallback(id => {
-    setContents(prev => {
-      if (!prev.has(id)) return prev;
-      const next = new Map(prev);
-      next.delete(id);
-      return next;
+  const removePortal = useCallback((hostName, key) => {
+    setPortals(prev => {
+      const hostPortals = prev[hostName] ?? [];
+      const nextHostPortals = hostPortals.filter(entry => entry.key !== key);
+      if (nextHostPortals.length === hostPortals.length) {
+        return prev;
+      }
+      if (nextHostPortals.length === 0) {
+        const {
+          [hostName]: _removed,
+          ...rest
+        } = prev;
+        return rest;
+      }
+      return {
+        ...prev,
+        [hostName]: nextHostPortals
+      };
     });
   }, []);
   const value = useMemo(() => ({
-    registerContent,
-    unregisterContent,
-    contents
-  }), [registerContent, unregisterContent, contents]);
+    portals,
+    upsertPortal,
+    removePortal
+  }), [portals, removePortal, upsertPortal]);
   return /*#__PURE__*/_jsx(PortalContext.Provider, {
     value: value,
     children: children

package/lib/module/components/portal/PortalProvider.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useMemo","useState","PortalContext","jsx","_jsx","PortalProvider","children","contents","setContents","Map","registerContent","id","content","prev","next","set","unregisterContent","has","delete","value","Provider"],"sourceRoot":"../../../../src","sources":["components/portal/PortalProvider.tsx"],"mappings":";;AAAA,SAAyBA,WAAW,EAAEC,OAAO,EAAEC,QAAQ,QAAQ,OAAO;AAEtE,SAASC,aAAa,QAAiC,oBAAiB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAMzE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAC;EAAEC;AAA8B,CAAC,EAAE;EAChE,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGP,QAAQ,CACtC,MAAM,IAAIQ,GAAG,CAAC,CAChB,CAAC;EAED,MAAMC,eAAe,GAAGX,WAAW,CAAC,CAACY,EAAU,EAAEC,OAAkB,KAAK;IACtEJ,WAAW,CAAEK,IAAI,IAAK;MACpB,MAAMC,IAAI,GAAG,IAAIL,GAAG,CAACI,IAAI,CAAC;MAC1BC,IAAI,CAACC,GAAG,CAACJ,EAAE,EAAEC,OAAO,CAAC;MACrB,OAAOE,IAAI;IACb,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,iBAAiB,GAAGjB,WAAW,CAAEY,EAAU,IAAK;IACpDH,WAAW,CAAEK,IAAI,IAAK;MACpB,IAAI,CAACA,IAAI,CAACI,GAAG,CAACN,EAAE,CAAC,EAAE,OAAOE,IAAI;MAC9B,MAAMC,IAAI,GAAG,IAAIL,GAAG,CAACI,IAAI,CAAC;MAC1BC,IAAI,CAACI,MAAM,CAACP,EAAE,CAAC;MACf,OAAOG,IAAI;IACb,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMK,KAAK,GAAGnB,OAAO,CACnB,OAAO;IAAEU,eAAe;IAAEM,iBAAiB;IAAET;EAAS,CAAC,CAAC,EACxD,CAACG,eAAe,EAAEM,iBAAiB,EAAET,QAAQ,CAC/C,CAAC;EAED,oBACEH,IAAA,CAACF,aAAa,CAACkB,QAAQ;IAACD,KAAK,EAAEA,KAAM;IAAAb,QAAA,EAAEA;EAAQ,CAAyB,CAAC;AAE7E","ignoreList":[]}
+{"version":3,"names":["useCallback","useMemo","useState","PortalContext","jsx","_jsx","PortalProvider","children","portals","setPortals","upsertPortal","hostName","key","node","prev","hostPortals","existingIndex","findIndex","entry","nextHostPortals","removePortal","filter","length","_removed","rest","value","Provider"],"sourceRoot":"../../../../src","sources":["components/portal/PortalProvider.tsx"],"mappings":";;AAAA,SAAyBA,WAAW,EAAEC,OAAO,EAAEC,QAAQ,QAAQ,OAAO;AAEtE,SACEC,aAAa;AAGU,SAAAC,GAAA,IAAAC,IAAA;AAMzB;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAC;EAAEC;AAA8B,CAAC,EAAE;EAChE,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGP,QAAQ,CAAc,CAAC,CAAC,CAAC;EAEvD,MAAMQ,YAAY,GAAGV,WAAW,CAC9B,CAACW,QAAgB,EAAEC,GAAW,EAAEC,IAAe,KAAK;IAClDJ,UAAU,CAAEK,IAAI,IAAK;MACnB,MAAMC,WAAW,GAAGD,IAAI,CAACH,QAAQ,CAAC,IAAI,EAAE;MACxC,MAAMK,aAAa,GAAGD,WAAW,CAACE,SAAS,CACxCC,KAAK,IAAKA,KAAK,CAACN,GAAG,KAAKA,GAC3B,CAAC;MAED,IAAII,aAAa,KAAK,CAAC,CAAC,EAAE;QACxB,OAAO;UACL,GAAGF,IAAI;UACP,CAACH,QAAQ,GAAG,CAAC,GAAGI,WAAW,EAAE;YAAEH,GAAG;YAAEC;UAAK,CAAC;QAC5C,CAAC;MACH;MAEA,IAAIE,WAAW,CAACC,aAAa,CAAC,EAAEH,IAAI,KAAKA,IAAI,EAAE;QAC7C,OAAOC,IAAI;MACb;MAEA,MAAMK,eAAe,GAAG,CAAC,GAAGJ,WAAW,CAAC;MACxCI,eAAe,CAACH,aAAa,CAAC,GAAG;QAAEJ,GAAG;QAAEC;MAAK,CAAC;MAE9C,OAAO;QACL,GAAGC,IAAI;QACP,CAACH,QAAQ,GAAGQ;MACd,CAAC;IACH,CAAC,CAAC;EACJ,CAAC,EACD,EACF,CAAC;EAED,MAAMC,YAAY,GAAGpB,WAAW,CAAC,CAACW,QAAgB,EAAEC,GAAW,KAAK;IAClEH,UAAU,CAAEK,IAAI,IAAK;MACnB,MAAMC,WAAW,GAAGD,IAAI,CAACH,QAAQ,CAAC,IAAI,EAAE;MACxC,MAAMQ,eAAe,GAAGJ,WAAW,CAACM,MAAM,CAAEH,KAAK,IAAKA,KAAK,CAACN,GAAG,KAAKA,GAAG,CAAC;MAExE,IAAIO,eAAe,CAACG,MAAM,KAAKP,WAAW,CAACO,MAAM,EAAE;QACjD,OAAOR,IAAI;MACb;MAEA,IAAIK,eAAe,CAACG,MAAM,KAAK,CAAC,EAAE;QAChC,MAAM;UAAE,CAACX,QAAQ,GAAGY,QAAQ;UAAE,GAAGC;QAAK,CAAC,GAAGV,IAAI;QAC9C,OAAOU,IAAI;MACb;MAEA,OAAO;QACL,GAAGV,IAAI;QACP,CAACH,QAAQ,GAAGQ;MACd,CAAC;IACH,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMM,KAAK,GAAGxB,OAAO,CACnB,OAAO;IAAEO,OAAO;IAAEE,YAAY;IAAEU;EAAa,CAAC,CAAC,EAC/C,CAACZ,OAAO,EAAEY,YAAY,EAAEV,YAAY,CACtC,CAAC;EAED,oBACEL,IAAA,CAACF,aAAa,CAACuB,QAAQ;IAACD,KAAK,EAAEA,KAAM;IAAAlB,QAAA,EAAEA;EAAQ,CAAyB,CAAC;AAE7E","ignoreList":[]}

package/lib/module/components/portal/index.js

@@ -1,6 +1,6 @@
 "use strict";
 
-export { usePortal } from "./PortalContext.js";
+export { Portal } from "./Portal.js";
 export { PortalHost } from "./PortalHost.js";
 export { PortalProvider } from "./PortalProvider.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["usePortal","PortalHost","PortalProvider"],"sourceRoot":"../../../../src","sources":["components/portal/index.ts"],"mappings":";;AACA,SAASA,SAAS,QAAQ,oBAAiB;AAC3C,SAASC,UAAU,QAAQ,iBAAc;AAEzC,SAASC,cAAc,QAAQ,qBAAkB","ignoreList":[]}
+{"version":3,"names":["Portal","PortalHost","PortalProvider"],"sourceRoot":"../../../../src","sources":["components/portal/index.ts"],"mappings":";;AACA,SAASA,MAAM;AAGf,SAASC,UAAU;AAEnB,SAASC,cAAc","ignoreList":[]}

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

@@ -1,11 +1,12 @@
 "use strict";
 
 import { Children, Fragment, forwardRef, isValidElement, useMemo } from 'react';
-import { SafeAreaView } from 'react-native-safe-area-context';
-import { useUnistyles } from 'react-native-unistyles';
-import { resolveThemeColor } from '#utils/resolve-theme-color';
+import { View } from 'react-native';
+import { StyleSheet, useUnistyles } from 'react-native-unistyles';
+import { resolveThemeColor } from "../../utils/resolve-theme-color.js";
 import { PortalProvider } from "../portal/index.js";
 import { ScreenScrollProvider } from "./ScreenContext.js";
+import { ScreenFlashList } from "./ScreenFlashList.js";
 import { ScreenFlatList } from "./ScreenFlatList.js";
 import { ScreenScrollView } from "./ScreenScrollView.js";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -32,13 +33,14 @@ function ScreenHeader({
     children: children
   });
 }
+ScreenHeader.displayName = 'Screen.Header';
 
 /** True if `children` directly contains a `Screen.Header`. */
 function hasScreenHeader(children) {
   let found = false;
   Children.forEach(children, child => {
     if (found) return;
-    if (/*#__PURE__*/isValidElement(child) && child.type === ScreenHeader) found = true;
+    if (/*#__PURE__*/isValidElement(child) && typeof child.type !== 'string' && child.type.displayName === 'Screen.Header') found = true;
   });
   return found;
 }
@@ -58,36 +60,25 @@ function hasScreenHeader(children) {
 const ScreenBase = /*#__PURE__*/forwardRef(function Screen({
   children,
   bg = 'background',
-  edges,
-  inTabView = false,
-  margins = true,
+  margins,
+  hasMargins,
   style,
   ...rest
-}, ref) {
+}, _ref) {
+  const hasHeader = useMemo(() => hasScreenHeader(children), [children]);
+  const resolvedMargins = margins ?? (hasMargins === false ? 'none' : 'all');
   const {
     theme
   } = useUnistyles();
-  const backgroundColor = resolveThemeColor(bg, theme) ?? theme.color.background;
-  const hasHeader = useMemo(() => hasScreenHeader(children), [children]);
-  const safeEdges = useMemo(() => {
-    if (edges) {
-      return hasHeader ? edges.filter(edge => edge !== 'top') : edges;
-    }
-    return hasHeader ? [] : ['top', 'bottom'];
-  }, [edges, hasHeader]);
-  return /*#__PURE__*/_jsx(ScreenScrollProvider, {
-    isInTabView: inTabView,
-    margins: margins,
-    hasHeader: hasHeader,
-    children: /*#__PURE__*/_jsx(PortalProvider, {
-      children: /*#__PURE__*/_jsx(SafeAreaView, {
-        ref: ref,
-        edges: safeEdges,
-        style: [{
-          flex: 1,
-          backgroundColor
-        }, style],
-        ...rest,
+  const resolvedBg = resolveThemeColor(bg, theme) ?? theme.color.background;
+  return /*#__PURE__*/_jsx(View, {
+    style: [styles.container, style],
+    ...rest,
+    children: /*#__PURE__*/_jsx(ScreenScrollProvider, {
+      background: resolvedBg,
+      margins: resolvedMargins,
+      hasHeader: hasHeader,
+      children: /*#__PURE__*/_jsx(PortalProvider, {
         children: children
       })
     })
@@ -96,5 +87,11 @@ const ScreenBase = /*#__PURE__*/forwardRef(function Screen({
 ScreenBase.Header = ScreenHeader;
 ScreenBase.ScrollView = ScreenScrollView;
 ScreenBase.FlatList = ScreenFlatList;
+ScreenBase.FlashList = ScreenFlashList;
 export const Screen = ScreenBase;
+const styles = StyleSheet.create((_theme, _runtime) => ({
+  container: {
+    flex: 1
+  }
+}));
 //# sourceMappingURL=Screen.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["Children","Fragment","forwardRef","isValidElement","useMemo","SafeAreaView","useUnistyles","resolveThemeColor","PortalProvider","ScreenScrollProvider","ScreenFlatList","ScreenScrollView","jsx","_jsx","ScreenHeader","children","as","rest","Component","hasScreenHeader","found","forEach","child","type","ScreenBase","Screen","bg","edges","inTabView","margins","style","ref","theme","backgroundColor","color","background","hasHeader","safeEdges","filter","edge","isInTabView","flex","Header","ScrollView","FlatList"],"sourceRoot":"../../../../src","sources":["components/screen/Screen.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Children","Fragment","forwardRef","isValidElement","useMemo","View","StyleSheet","useUnistyles","resolveThemeColor","PortalProvider","ScreenScrollProvider","ScreenFlashList","ScreenFlatList","ScreenScrollView","jsx","_jsx","ScreenHeader","children","as","rest","Component","displayName","hasScreenHeader","found","forEach","child","type","ScreenBase","Screen","bg","margins","hasMargins","style","_ref","hasHeader","resolvedMargins","theme","resolvedBg","color","background","styles","container","Header","ScrollView","FlatList","FlashList","create","_theme","_runtime","flex"],"sourceRoot":"../../../../src","sources":["components/screen/Screen.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -3,6 +3,8 @@
 import { createContext, useCallback, useContext, useMemo, useState } from 'react';
 import { useAnimatedRef, useAnimatedScrollHandler, useSharedValue } from 'react-native-reanimated';
 import { jsx as _jsx } from "react/jsx-runtime";
+/** `PortalHost` name shared by `Screen.ScrollView` / `Screen.FlatList` and header variants that portal content into them. */
+export const SCREEN_HEADER_PORTAL_HOST = 'screen-header';
 export const ScreenContext = /*#__PURE__*/createContext(null);
 /**
  * Owns the screen's shared scroll ref, offset, snap offsets, and header collapse
@@ -10,9 +12,9 @@ export const ScreenContext = /*#__PURE__*/createContext(null);
  * scroll containers bind the ref via {@link useScreen}.
  */
 export function ScreenScrollProvider({
+  background = 'transparent',
   children,
-  isInTabView,
-  margins = true,
+  margins = 'all',
   hasHeader = false
 }) {
   const scrollY = useSharedValue(0);
@@ -30,6 +32,7 @@ export function ScreenScrollProvider({
     }
   });
   const value = useMemo(() => ({
+    background,
     margins,
     hasHeader,
     scrollY,
@@ -37,9 +40,8 @@ export function ScreenScrollProvider({
     headerSnapOffsets,
     setHeaderCollapseHeight,
     scrollRef,
-    scrollHandler,
-    isInTabView
-  }), [margins, hasHeader, scrollY, headerCollapseHeight, headerSnapOffsets, setHeaderCollapseHeight, scrollRef, scrollHandler, isInTabView]);
+    scrollHandler
+  }), [background, margins, hasHeader, scrollY, headerCollapseHeight, headerSnapOffsets, setHeaderCollapseHeight, scrollRef, scrollHandler]);
   return /*#__PURE__*/_jsx(ScreenContext.Provider, {
     value: value,
     children: children

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

@@ -1 +1 @@
-{"version":3,"names":["createContext","useCallback","useContext","useMemo","useState","useAnimatedRef","useAnimatedScrollHandler","useSharedValue","jsx","_jsx","ScreenContext","ScreenScrollProvider","children","isInTabView","margins","hasHeader","scrollY","headerCollapseHeight","headerSnapOffsets","setHeaderSnapOffsets","scrollRef","setHeaderCollapseHeight","height","rounded","Math","round","value","undefined","scrollHandler","onScroll","event","contentOffset","y","Provider","useScreen","context","Error"],"sourceRoot":"../../../../src","sources":["components/screen/ScreenContext.tsx"],"mappings":";;AAAA,SACEA,aAAa,EAEbC,WAAW,EACXC,UAAU,EACVC,OAAO,EACPC,QAAQ,QACH,OAAO;AAEd,SAIEC,cAAc,EACdC,wBAAwB,EACxBC,cAAc,QACT,yBAAyB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAuCjC,OAAO,MAAMC,aAAa,gBAAGV,aAAa,CAA4B,IAAI,CAAC;AAW3E;AACA;AACA;AACA;AACA;AACA,OAAO,SAASW,oBAAoBA,CAAC;EACnCC,QAAQ;EACRC,WAAW;EACXC,OAAO,GAAG,IAAI;EACdC,SAAS,GAAG;AACa,CAAC,EAAE;EAC5B,MAAMC,OAAO,GAAGT,cAAc,CAAC,CAAC,CAAC;EACjC,MAAMU,oBAAoB,GAAGV,cAAc,CAAC,CAAC,CAAC;EAC9C,MAAM,CAACW,iBAAiB,EAAEC,oBAAoB,CAAC,GAAGf,QAAQ,CAAW,CAAC;EACtE,MAAMgB,SAAS,GAAGf,cAAc,CAAsB,CAAC;EAEvD,MAAMgB,uBAAuB,GAAGpB,WAAW,CACxCqB,MAAc,IAAK;IAClB,MAAMC,OAAO,GAAGC,IAAI,CAACC,KAAK,CAACH,MAAM,CAAC;IAClCL,oBAAoB,CAACS,KAAK,GAAGH,OAAO;IACpCJ,oBAAoB,CAACI,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAEA,OAAO,CAAC,GAAGI,SAAS,CAAC;EAC9D,CAAC,EACD,CAACV,oBAAoB,CACvB,CAAC;EAED,MAAMW,aAAa,GAAGtB,wBAAwB,CAAC;IAC7CuB,QAAQ,EAAGC,KAAK,IAAK;MACnBd,OAAO,CAACU,KAAK,GAAGI,KAAK,CAACC,aAAa,CAACC,CAAC;IACvC;EACF,CAAC,CAAC;EAEF,MAAMN,KAAK,GAAGvB,OAAO,CACnB,OAAO;IACLW,OAAO;IACPC,SAAS;IACTC,OAAO;IACPC,oBAAoB;IACpBC,iBAAiB;IACjBG,uBAAuB;IACvBD,SAAS;IACTQ,aAAa;IACbf;EACF,CAAC,CAAC,EACF,CACEC,OAAO,EACPC,SAAS,EACTC,OAAO,EACPC,oBAAoB,EACpBC,iBAAiB,EACjBG,uBAAuB,EACvBD,SAAS,EACTQ,aAAa,EACbf,WAAW,CAEf,CAAC;EAED,oBACEJ,IAAA,CAACC,aAAa,CAACuB,QAAQ;IAACP,KAAK,EAAEA,KAAM;IAAAd,QAAA,EAAEA;EAAQ,CAAyB,CAAC;AAE7E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASsB,SAASA,CAAA,EAAuB;EAC9C,MAAMC,OAAO,GAAGjC,UAAU,CAACQ,aAAa,CAAC;EACzC,IAAI,CAACyB,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;EACrE;EACA,OAAOD,OAAO;AAChB","ignoreList":[]}
+{"version":3,"names":["createContext","useCallback","useContext","useMemo","useState","useAnimatedRef","useAnimatedScrollHandler","useSharedValue","jsx","_jsx","SCREEN_HEADER_PORTAL_HOST","ScreenContext","ScreenScrollProvider","background","children","margins","hasHeader","scrollY","headerCollapseHeight","headerSnapOffsets","setHeaderSnapOffsets","scrollRef","setHeaderCollapseHeight","height","rounded","Math","round","value","undefined","scrollHandler","onScroll","event","contentOffset","y","Provider","useScreen","context","Error"],"sourceRoot":"../../../../src","sources":["components/screen/ScreenContext.tsx"],"mappings":";;AAAA,SACEA,aAAa,EAEbC,WAAW,EACXC,UAAU,EACVC,OAAO,EACPC,QAAQ,QACH,OAAO;AAEd,SAIEC,cAAc,EACdC,wBAAwB,EACxBC,cAAc,QACT,yBAAyB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAMjC;AACA,OAAO,MAAMC,yBAAyB,GAAG,eAAe;AAsCxD,OAAO,MAAMC,aAAa,gBAAGX,aAAa,CAA4B,IAAI,CAAC;AAY3E;AACA;AACA;AACA;AACA;AACA,OAAO,SAASY,oBAAoBA,CAAC;EACnCC,UAAU,GAAG,aAAa;EAC1BC,QAAQ;EACRC,OAAO,GAAG,KAAK;EACfC,SAAS,GAAG;AACa,CAAC,EAAE;EAC5B,MAAMC,OAAO,GAAGV,cAAc,CAAC,CAAC,CAAC;EACjC,MAAMW,oBAAoB,GAAGX,cAAc,CAAC,CAAC,CAAC;EAC9C,MAAM,CAACY,iBAAiB,EAAEC,oBAAoB,CAAC,GAAGhB,QAAQ,CAAW,CAAC;EACtE,MAAMiB,SAAS,GAAGhB,cAAc,CAAsB,CAAC;EAEvD,MAAMiB,uBAAuB,GAAGrB,WAAW,CACxCsB,MAAc,IAAK;IAClB,MAAMC,OAAO,GAAGC,IAAI,CAACC,KAAK,CAACH,MAAM,CAAC;IAClCL,oBAAoB,CAACS,KAAK,GAAGH,OAAO;IACpCJ,oBAAoB,CAACI,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAEA,OAAO,CAAC,GAAGI,SAAS,CAAC;EAC9D,CAAC,EACD,CAACV,oBAAoB,CACvB,CAAC;EAED,MAAMW,aAAa,GAAGvB,wBAAwB,CAAC;IAC7CwB,QAAQ,EAAGC,KAAK,IAAK;MACnBd,OAAO,CAACU,KAAK,GAAGI,KAAK,CAACC,aAAa,CAACC,CAAC;IACvC;EACF,CAAC,CAAC;EAEF,MAAMN,KAAK,GAAGxB,OAAO,CACnB,OAAO;IACLU,UAAU;IACVE,OAAO;IACPC,SAAS;IACTC,OAAO;IACPC,oBAAoB;IACpBC,iBAAiB;IACjBG,uBAAuB;IACvBD,SAAS;IACTQ;EACF,CAAC,CAAC,EACF,CACEhB,UAAU,EACVE,OAAO,EACPC,SAAS,EACTC,OAAO,EACPC,oBAAoB,EACpBC,iBAAiB,EACjBG,uBAAuB,EACvBD,SAAS,EACTQ,aAAa,CAEjB,CAAC;EAED,oBACEpB,IAAA,CAACE,aAAa,CAACuB,QAAQ;IAACP,KAAK,EAAEA,KAAM;IAAAb,QAAA,EAAEA;EAAQ,CAAyB,CAAC;AAE7E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASqB,SAASA,CAAA,EAAuB;EAC9C,MAAMC,OAAO,GAAGlC,UAAU,CAACS,aAAa,CAAC;EACzC,IAAI,CAACyB,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,kDAAkD,CAAC;EACrE;EACA,OAAOD,OAAO;AAChB","ignoreList":[]}

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

@@ -0,0 +1,144 @@
+"use strict";
+
+import { FlashList } from '@shopify/flash-list';
+import { View } from 'react-native';
+import Animated, { useAnimatedScrollHandler, useComposedEventHandler } from 'react-native-reanimated';
+import { StyleSheet } from 'react-native-unistyles';
+import { PortalHost } from "../portal/index.js";
+import { BottomSafeArea } from "./parts/BottomSafeArea.js";
+import { renderScreenPlaceholder } from "./parts/ScreenPlaceholder.js";
+import { SCREEN_HEADER_PORTAL_HOST, useScreen } from "./ScreenContext.js";
+import { hasXMargin, hasYMargin, renderListHeader } from "./utils.js";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+const AnimatedFlashList = Animated.createAnimatedComponent(FlashList);
+/**
+ * `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 function ScreenFlashList({
+  data,
+  style,
+  contentContainerStyle,
+  ListHeaderComponent,
+  ListFooterComponent,
+  ListEmptyComponent,
+  horizontal = false,
+  loading = false,
+  LoadingComponent,
+  EmptyComponent,
+  margins,
+  bottomInset,
+  onScroll,
+  ...rest
+}) {
+  if (FlashList == null) {
+    throw new Error('[react-native-terra-ui] Screen.FlashList requires "@shopify/flash-list" to be installed in your app. Run `yarn add @shopify/flash-list` (or the npm/pnpm equivalent) and rebuild.');
+  }
+  const {
+    background,
+    scrollHandler,
+    headerSnapOffsets,
+    margins: screenMargins,
+    hasHeader
+  } = useScreen();
+  const resolvedMargins = margins ?? screenMargins;
+  // The placeholder rides in on `ListEmptyComponent` rather than replacing the
+  // list, so the header portal and snap offsets stay put. While loading the
+  // list is fed an empty `data` so that slot is the one that renders.
+  const placeholder = renderScreenPlaceholder({
+    loading,
+    LoadingComponent,
+    EmptyComponent,
+    isEmpty: !data || data.length === 0
+  });
+  const jsScrollHandler = useAnimatedScrollHandler(event => {
+    if (onScroll) onScroll(event);
+  }, [onScroll]);
+  const composedHandler = useComposedEventHandler([scrollHandler, jsScrollHandler]);
+
+  // `AnimatedFlashList` is typed for `unknown` items, so the remaining props
+  // are cast back to its prop type — minus the ones set explicitly below,
+  // which the spread would otherwise re-supply.
+  const listProps = rest;
+
+  // A caller naming its own `bottomInset` has taken the bottom over entirely,
+  // and a horizontal list has no bottom edge to clear.
+  const needsBottomSafeArea = bottomInset === undefined && !horizontal;
+  const footerComponent = /*#__PURE__*/_jsxs(_Fragment, {
+    children: [renderListHeader(ListFooterComponent), needsBottomSafeArea ? /*#__PURE__*/_jsx(BottomSafeArea, {}) : null]
+  });
+  const headerComponent = /*#__PURE__*/_jsxs(View, {
+    style: styles.headerWrapper(resolvedMargins),
+    children: [/*#__PURE__*/_jsx(PortalHost, {
+      name: SCREEN_HEADER_PORTAL_HOST
+    }), renderListHeader(ListHeaderComponent)]
+  });
+  return /*#__PURE__*/_jsx(AnimatedFlashList, {
+    data: loading ? [] : data,
+    style: [{
+      backgroundColor: background
+    }, style],
+    horizontal: horizontal,
+    contentInsetAdjustmentBehavior: hasHeader ? 'never' : undefined,
+    contentContainerStyle: [styles.content(resolvedMargins, hasHeader, bottomInset), contentContainerStyle],
+    ListHeaderComponent: headerComponent,
+    ListFooterComponent: footerComponent,
+    ListEmptyComponent: placeholder ?? ListEmptyComponent,
+    showsVerticalScrollIndicator: false,
+    scrollEventThrottle: 16,
+    snapToOffsets: headerSnapOffsets,
+    ...listProps,
+    onScroll: composedHandler
+  });
+}
+const styles = StyleSheet.create((theme, runtime) => ({
+  content: (margins, hasHeader, bottomInset) => {
+    return {
+      flexGrow: 1,
+      // The header is absolutely positioned, so the list reserves its full
+      // height — bar plus top safe area. This assumes the scroll view does not
+      // also get UIKit's automatic inset adjustment: on a native tab screen
+      // that means `disableAutomaticContentInsets` on the tab, or the two
+      // insets are counted twice.
+      paddingTop: (hasHeader ? theme.layout.header.height + runtime.insets.top : 0) + (hasYMargin(margins) ? theme.layout.screen.margin.y : 0),
+      paddingHorizontal: hasXMargin(margins) ? theme.layout.screen.margin.x : 0,
+      // The safe area is `BottomSafeArea`'s job; counting it here as well
+      // would leave a gap the height of the gesture bar.
+      paddingBottom: bottomInset ?? (hasYMargin(margins) ? theme.layout.screen.margin.y : 0)
+    };
+  },
+  safeArea: {
+    height: runtime.insets.top
+  },
+  headerWrapper: margins => ({
+    marginHorizontal: hasXMargin(margins) ? -theme.layout.screen.margin.x : 0
+  })
+}));
+//# sourceMappingURL=ScreenFlashList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["FlashList","View","Animated","useAnimatedScrollHandler","useComposedEventHandler","StyleSheet","PortalHost","BottomSafeArea","renderScreenPlaceholder","SCREEN_HEADER_PORTAL_HOST","useScreen","hasXMargin","hasYMargin","renderListHeader","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","AnimatedFlashList","createAnimatedComponent","ScreenFlashList","data","style","contentContainerStyle","ListHeaderComponent","ListFooterComponent","ListEmptyComponent","horizontal","loading","LoadingComponent","EmptyComponent","margins","bottomInset","onScroll","rest","Error","background","scrollHandler","headerSnapOffsets","screenMargins","hasHeader","resolvedMargins","placeholder","isEmpty","length","jsScrollHandler","event","composedHandler","listProps","needsBottomSafeArea","undefined","footerComponent","children","headerComponent","styles","headerWrapper","name","backgroundColor","contentInsetAdjustmentBehavior","content","showsVerticalScrollIndicator","scrollEventThrottle","snapToOffsets","create","theme","runtime","flexGrow","paddingTop","layout","header","height","insets","top","screen","margin","y","paddingHorizontal","x","paddingBottom","safeArea","marginHorizontal"],"sourceRoot":"../../../../src","sources":["components/screen/ScreenFlashList.tsx"],"mappings":"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","ignoreList":[]}