react-native-terra-ui 0.11.11 → 0.11.12

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.11.12](https://github.com/earthlin9/react-native-terra-ui/compare/v0.11.11...v0.11.12) (2026-09-17)
+
+### Features
+
+* **ui:** [surface] add default content padding ([966c38a](https://github.com/earthlin9/react-native-terra-ui/commit/966c38adb42d3b596e577f6c4116896680d27d6e))
+
+### Bug Fixes
+
+* **ui:** [header] unify layout and preserve accessory gradients and padding ([637e3e1](https://github.com/earthlin9/react-native-terra-ui/commit/637e3e19fab4b4e30b6f80873d72acd7167a3a69))
+
 ## [0.11.11](https://github.com/earthlin9/react-native-terra-ui/compare/v0.11.10...v0.11.11) (2026-09-17)
 
 ### Features

package/lib/module/components/header/hooks/use-header-color.js

@@ -0,0 +1,16 @@
+"use strict";
+
+import { useContext } from "react";
+import { useUnistyles } from "react-native-unistyles";
+import { resolveThemeColor } from "../../../utils/resolve-theme-color.js";
+import { ScreenContext } from "../../screen/ScreenContext.js";
+
+/** Explicit header color wins, then Screen, then the theme canvas. */
+export function useHeaderColor(token) {
+  const {
+    theme
+  } = useUnistyles();
+  const screen = useContext(ScreenContext);
+  return (token ? resolveThemeColor(token, theme) : screen?.background) ?? theme.color["surface.canvas"];
+}
+//# sourceMappingURL=use-header-color.js.map

package/lib/module/components/header/hooks/use-header-color.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","useUnistyles","resolveThemeColor","ScreenContext","useHeaderColor","token","theme","screen","background","color"],"sourceRoot":"../../../../../src","sources":["components/header/hooks/use-header-color.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAElC,SAASC,YAAY,QAAQ,wBAAwB;AAGrD,SAASC,iBAAiB;AAC1B,SAASC,aAAa;;AAEtB;AACA,OAAO,SAASC,cAAcA,CAACC,KAAkB,EAAE;EACjD,MAAM;IAAEC;EAAM,CAAC,GAAGL,YAAY,CAAC,CAAC;EAChC,MAAMM,MAAM,GAAGP,UAAU,CAACG,aAAa,CAAC;EACxC,OAAO,CAACE,KAAK,GAAGH,iBAAiB,CAACG,KAAK,EAAEC,KAAK,CAAC,GAAGC,MAAM,EAAEC,UAAU,KAAKF,KAAK,CAACG,KAAK,CAAC,gBAAgB,CAAC;AACxG","ignoreList":[]}

package/lib/module/components/header/hooks/use-large-title-header.js

@@ -0,0 +1,81 @@
+"use strict";
+
+import { useEffect, useLayoutEffect, useState } from "react";
+import { interpolate, useAnimatedStyle, useSharedValue } from "react-native-reanimated";
+import { useUnistyles } from "react-native-unistyles";
+import { useScreen } from "../../screen/ScreenContext.js";
+/** Coordinates measured layout and UI-thread animation without animating accessory padding. */
+export function useLargeTitleHeader({
+  hasAccessory,
+  accessoryBehavior,
+  isLargeTitleHidden
+}) {
+  const {
+    theme
+  } = useUnistyles();
+  const {
+    scrollY,
+    contentTopPadding,
+    setHeaderAccessoryHeight
+  } = useScreen();
+  const [accessoryHeight, setAccessoryHeight] = useState(0);
+  const [largeTitleHeight, setLargeTitleHeight] = useState(0);
+  const hidden = useSharedValue(isLargeTitleHidden);
+  useEffect(() => {
+    hidden.value = isLargeTitleHidden;
+  }, [hidden, isLargeTitleHidden]);
+  const barHeight = theme.layout.header.height;
+  const isSticky = hasAccessory && accessoryBehavior === "sticky" && !isLargeTitleHidden;
+  // The measured overlay always includes bottom padding. Expanded scroll content
+  // excludes it; compact-only screens reserve the entire accessory.
+  const reservedAccessoryHeight = hasAccessory ? Math.max(0, Math.round(accessoryHeight - (isLargeTitleHidden ? 0 : theme.spacing["2"]))) : 0;
+  const accessoryOffset = isSticky ? Math.max(0, contentTopPadding + largeTitleHeight - barHeight) : 0;
+  useLayoutEffect(() => {
+    setHeaderAccessoryHeight(isSticky ? 0 : reservedAccessoryHeight);
+    return () => setHeaderAccessoryHeight(0);
+  }, [isSticky, reservedAccessoryHeight, setHeaderAccessoryHeight]);
+  const accessoryStyle = useAnimatedStyle(() => ({
+    transform: [{
+      translateY: isSticky && !hidden.value ? Math.max(0, accessoryOffset - scrollY.value) : 0
+    }]
+  }));
+  const surfaceStyle = useAnimatedStyle(() => {
+    if (hidden.value) return {
+      opacity: 1
+    };
+    const distance = isSticky ? accessoryOffset : barHeight;
+    return {
+      opacity: distance > 0 ? interpolate(scrollY.value, [0, distance], [0, 1], "clamp") : isSticky ? 1 : 0
+    };
+  });
+  const compactTitleStyle = useAnimatedStyle(() => {
+    const progress = hidden.value ? 1 : barHeight > 0 ? interpolate(scrollY.value, [0, barHeight], [0, 1], "clamp") : 0;
+    return {
+      opacity: progress,
+      transform: [{
+        translateY: (1 - progress) * 8
+      }]
+    };
+  });
+  const largeTitleStyle = useAnimatedStyle(() => {
+    const progress = barHeight > 0 ? interpolate(scrollY.value, [0, barHeight], [0, 1], "clamp") : 0;
+    return {
+      opacity: 1 - progress,
+      transform: [{
+        translateY: -progress * 6
+      }]
+    };
+  });
+  return {
+    isSticky,
+    accessoryOffset,
+    reservedAccessoryHeight,
+    setAccessoryHeight,
+    setLargeTitleHeight,
+    accessoryStyle,
+    surfaceStyle,
+    compactTitleStyle,
+    largeTitleStyle
+  };
+}
+//# sourceMappingURL=use-large-title-header.js.map

package/lib/module/components/header/hooks/use-large-title-header.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useLayoutEffect","useState","interpolate","useAnimatedStyle","useSharedValue","useUnistyles","useScreen","useLargeTitleHeader","hasAccessory","accessoryBehavior","isLargeTitleHidden","theme","scrollY","contentTopPadding","setHeaderAccessoryHeight","accessoryHeight","setAccessoryHeight","largeTitleHeight","setLargeTitleHeight","hidden","value","barHeight","layout","header","height","isSticky","reservedAccessoryHeight","Math","max","round","spacing","accessoryOffset","accessoryStyle","transform","translateY","surfaceStyle","opacity","distance","compactTitleStyle","progress","largeTitleStyle"],"sourceRoot":"../../../../../src","sources":["components/header/hooks/use-large-title-header.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,eAAe,EAAEC,QAAQ,QAAQ,OAAO;AAE5D,SAASC,WAAW,EAAEC,gBAAgB,EAAEC,cAAc,QAAQ,yBAAyB;AACvF,SAASC,YAAY,QAAQ,wBAAwB;AAErD,SAASC,SAAS;AASlB;AACA,OAAO,SAASC,mBAAmBA,CAAC;EAClCC,YAAY;EACZC,iBAAiB;EACjBC;AACuB,CAAC,EAAE;EAC1B,MAAM;IAAEC;EAAM,CAAC,GAAGN,YAAY,CAAC,CAAC;EAChC,MAAM;IAAEO,OAAO;IAAEC,iBAAiB;IAAEC;EAAyB,CAAC,GAAGR,SAAS,CAAC,CAAC;EAC5E,MAAM,CAACS,eAAe,EAAEC,kBAAkB,CAAC,GAAGf,QAAQ,CAAC,CAAC,CAAC;EACzD,MAAM,CAACgB,gBAAgB,EAAEC,mBAAmB,CAAC,GAAGjB,QAAQ,CAAC,CAAC,CAAC;EAC3D,MAAMkB,MAAM,GAAGf,cAAc,CAACM,kBAAkB,CAAC;EACjDX,SAAS,CAAC,MAAM;IACdoB,MAAM,CAACC,KAAK,GAAGV,kBAAkB;EACnC,CAAC,EAAE,CAACS,MAAM,EAAET,kBAAkB,CAAC,CAAC;EAEhC,MAAMW,SAAS,GAAGV,KAAK,CAACW,MAAM,CAACC,MAAM,CAACC,MAAM;EAC5C,MAAMC,QAAQ,GAAGjB,YAAY,IAAIC,iBAAiB,KAAK,QAAQ,IAAI,CAACC,kBAAkB;EACtF;EACA;EACA,MAAMgB,uBAAuB,GAAGlB,YAAY,GACxCmB,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,KAAK,CAACd,eAAe,IAAIL,kBAAkB,GAAG,CAAC,GAAGC,KAAK,CAACmB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GACxF,CAAC;EACL,MAAMC,eAAe,GAAGN,QAAQ,GAAGE,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEf,iBAAiB,GAAGI,gBAAgB,GAAGI,SAAS,CAAC,GAAG,CAAC;EAEpGrB,eAAe,CAAC,MAAM;IACpBc,wBAAwB,CAACW,QAAQ,GAAG,CAAC,GAAGC,uBAAuB,CAAC;IAChE,OAAO,MAAMZ,wBAAwB,CAAC,CAAC,CAAC;EAC1C,CAAC,EAAE,CAACW,QAAQ,EAAEC,uBAAuB,EAAEZ,wBAAwB,CAAC,CAAC;EAEjE,MAAMkB,cAAc,GAAG7B,gBAAgB,CAAC,OAAO;IAC7C8B,SAAS,EAAE,CAAC;MAAEC,UAAU,EAAET,QAAQ,IAAI,CAACN,MAAM,CAACC,KAAK,GAAGO,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEG,eAAe,GAAGnB,OAAO,CAACQ,KAAK,CAAC,GAAG;IAAE,CAAC;EAC1G,CAAC,CAAC,CAAC;EACH,MAAMe,YAAY,GAAGhC,gBAAgB,CAAC,MAAM;IAC1C,IAAIgB,MAAM,CAACC,KAAK,EAAE,OAAO;MAAEgB,OAAO,EAAE;IAAE,CAAC;IACvC,MAAMC,QAAQ,GAAGZ,QAAQ,GAAGM,eAAe,GAAGV,SAAS;IACvD,OAAO;MACLe,OAAO,EAAEC,QAAQ,GAAG,CAAC,GAAGnC,WAAW,CAACU,OAAO,CAACQ,KAAK,EAAE,CAAC,CAAC,EAAEiB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,GAAGZ,QAAQ,GAAG,CAAC,GAAG;IACtG,CAAC;EACH,CAAC,CAAC;EACF,MAAMa,iBAAiB,GAAGnC,gBAAgB,CAAC,MAAM;IAC/C,MAAMoC,QAAQ,GAAGpB,MAAM,CAACC,KAAK,GACzB,CAAC,GACDC,SAAS,GAAG,CAAC,GACXnB,WAAW,CAACU,OAAO,CAACQ,KAAK,EAAE,CAAC,CAAC,EAAEC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,GAC3D,CAAC;IACP,OAAO;MAAEe,OAAO,EAAEG,QAAQ;MAAEN,SAAS,EAAE,CAAC;QAAEC,UAAU,EAAE,CAAC,CAAC,GAAGK,QAAQ,IAAI;MAAE,CAAC;IAAE,CAAC;EAC/E,CAAC,CAAC;EACF,MAAMC,eAAe,GAAGrC,gBAAgB,CAAC,MAAM;IAC7C,MAAMoC,QAAQ,GAAGlB,SAAS,GAAG,CAAC,GAAGnB,WAAW,CAACU,OAAO,CAACQ,KAAK,EAAE,CAAC,CAAC,EAAEC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC;IAChG,OAAO;MAAEe,OAAO,EAAE,CAAC,GAAGG,QAAQ;MAAEN,SAAS,EAAE,CAAC;QAAEC,UAAU,EAAE,CAACK,QAAQ,GAAG;MAAE,CAAC;IAAE,CAAC;EAC9E,CAAC,CAAC;EAEF,OAAO;IACLd,QAAQ;IACRM,eAAe;IACfL,uBAAuB;IACvBV,kBAAkB;IAClBE,mBAAmB;IACnBc,cAAc;IACdG,YAAY;IACZG,iBAAiB;IACjBE;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/components/header/parts/HeaderAccessory.js

@@ -1,32 +1,44 @@
 "use strict";
 
 import { View } from "react-native-unistyles/components/native/View";
-import { useCallback, useEffect } from "react";
+import { useCallback, useLayoutEffect, useRef } from "react";
 import Animated from "react-native-reanimated";
 import { StyleSheet } from "react-native-unistyles";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { HeaderSurface } from "./HeaderSurface.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /** Measures accessory content so the header can reserve space in the scroll container. */
 export function HeaderAccessory({
   children,
   padding,
+  color,
+  surfaceStyle,
   onHeightChange,
   style
 }) {
+  const measuredHeight = useRef(0);
   const handleLayout = useCallback(event => {
-    onHeightChange(event.nativeEvent.layout.height);
+    measuredHeight.current = event.nativeEvent.layout.height;
+    onHeightChange?.(measuredHeight.current);
   }, [onHeightChange]);
 
   // Release the previous owner’s space when the callback changes or the accessory unmounts.
-  useEffect(() => () => onHeightChange(0), [onHeightChange]);
+  useLayoutEffect(() => {
+    onHeightChange?.(measuredHeight.current);
+    return () => onHeightChange?.(0);
+  }, [onHeightChange]);
   const _styles = styles;
   {
     const styles = _styles.useVariants({
       padding
     });
-    return /*#__PURE__*/_jsx(Animated.View, {
+    return /*#__PURE__*/_jsxs(Animated.View, {
       style: [styles.accessory, style],
       onLayout: handleLayout,
-      children: children
+      children: [/*#__PURE__*/_jsx(HeaderSurface, {
+        color: color,
+        animatedStyle: surfaceStyle,
+        accessory: true
+      }), children]
     });
   }
 }
@@ -41,6 +53,9 @@ export function HeaderAccessorySpacer({
 }
 const styles = StyleSheet.create(theme => ({
   accessory: {
+    // Static layout padding is intentional: the background must measure the full
+    // padded height even when a horizontal ScrollView is the accessory content.
+    paddingBottom: theme.spacing["2"],
     variants: {
       padding: {
         x: {

package/lib/module/components/header/parts/HeaderAccessory.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useEffect","Animated","StyleSheet","jsx","_jsx","HeaderAccessory","children","padding","onHeightChange","style","handleLayout","event","nativeEvent","layout","height","_styles","styles","useVariants","View","accessory","onLayout","HeaderAccessorySpacer","spacer","create","theme","variants","x","paddingHorizontal","screen","none","uni__dependencies"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderAccessory.tsx"],"mappings":";;;AAAA,SAAyBA,WAAW,EAAEC,SAAS,QAAQ,OAAO;AAG9D,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,UAAU,QAAQ,wBAAwB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAcpD;AACA,OAAO,SAASC,eAAeA,CAAC;EAAEC,QAAQ;EAAEC,OAAO;EAAEC,cAAc;EAAEC;AAA4B,CAAC,EAAE;EAClG,MAAMC,YAAY,GAAGX,WAAW,CAC7BY,KAAwB,IAAK;IAC5BH,cAAc,CAACG,KAAK,CAACC,WAAW,CAACC,MAAM,CAACC,MAAM,CAAC;EACjD,CAAC,EACD,CAACN,cAAc,CACjB,CAAC;;EAED;EACAR,SAAS,CAAC,MAAM,MAAMQ,cAAc,CAAC,CAAC,CAAC,EAAE,CAACA,cAAc,CAAC,CAAC;EAAC,MAAAO,OAAA,GAAAC,MAAA;EAAA;IAAA,MAAAA,MAAA,GAAAD,OAAA,CAAAE,WAAA,CAExC;MAAEV;IAAQ,CAAC;IAE9B,oBACEH,IAAA,CAACH,QAAQ,CAACiB,IAAI;MAACT,KAAK,EAAE,CAACO,MAAM,CAACG,SAAS,EAAEV,KAAK,CAAE;MAACW,QAAQ,EAAEV,YAAa;MAAAJ,QAAA,EACrEA;IAAQ,CACI,CAAC;EAChB;AACJ;;AAEA;AACA,OAAO,SAASe,qBAAqBA,CAAC;EAAEP;AAA2B,CAAC,EAAE;EACpE,oBAAOV,IAAA,CAACc,IAAI;IAACT,KAAK,EAAEO,MAAM,CAACM,MAAM,CAACR,MAAM;EAAE,CAAE,CAAC;AAC/C;AAEA,MAAME,MAAM,GAAGd,UAAU,CAACqB,MAAM,CAAEC,KAAK,KAAM;EAC3CL,SAAS,EAAE;IACTM,QAAQ,EAAE;MACRlB,OAAO,EAAE;QACPmB,CAAC,EAAE;UAAEC,iBAAiB,EAAEH,KAAK,CAACX,MAAM,CAACe,MAAM,CAACrB,OAAO,CAACmB;QAAE,CAAC;QACvDG,IAAI,EAAE,CAAC;MACT;IACF,CAAC;IAAAC,iBAAA;EACH,CAAC;EACDR,MAAM,EAAGR,MAAc,KAAM;IAAEA;EAAO,CAAC;AACzC,CAAC,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["useCallback","useLayoutEffect","useRef","Animated","StyleSheet","HeaderSurface","jsx","_jsx","jsxs","_jsxs","HeaderAccessory","children","padding","color","surfaceStyle","onHeightChange","style","measuredHeight","handleLayout","event","current","nativeEvent","layout","height","_styles","styles","useVariants","View","accessory","onLayout","animatedStyle","HeaderAccessorySpacer","spacer","create","theme","paddingBottom","spacing","variants","x","paddingHorizontal","screen","none","uni__dependencies"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderAccessory.tsx"],"mappings":";;;AAAA,SAA8CA,WAAW,EAAEC,eAAe,EAAEC,MAAM,QAAQ,OAAO;AAGjG,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,UAAU,QAAQ,wBAAwB;AAGnD,SAASC,aAAa;AAAmD,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAczE;AACA,OAAO,SAASC,eAAeA,CAAC;EAC9BC,QAAQ;EACRC,OAAO;EACPC,KAAK;EACLC,YAAY;EACZC,cAAc;EACdC;AACoB,CAAC,EAAE;EACvB,MAAMC,cAAc,GAAGf,MAAM,CAAC,CAAC,CAAC;EAChC,MAAMgB,YAAY,GAAGlB,WAAW,CAC7BmB,KAAwB,IAAK;IAC5BF,cAAc,CAACG,OAAO,GAAGD,KAAK,CAACE,WAAW,CAACC,MAAM,CAACC,MAAM;IACxDR,cAAc,GAAGE,cAAc,CAACG,OAAO,CAAC;EAC1C,CAAC,EACD,CAACL,cAAc,CACjB,CAAC;;EAED;EACAd,eAAe,CAAC,MAAM;IACpBc,cAAc,GAAGE,cAAc,CAACG,OAAO,CAAC;IACxC,OAAO,MAAML,cAAc,GAAG,CAAC,CAAC;EAClC,CAAC,EAAE,CAACA,cAAc,CAAC,CAAC;EAAC,MAAAS,OAAA,GAAAC,MAAA;EAAA;IAAA,MAAAA,MAAA,GAAAD,OAAA,CAAAE,WAAA,CAEF;MAAEd;IAAQ,CAAC;IAE9B,oBACEH,KAAA,CAACN,QAAQ,CAACwB,IAAI;MAACX,KAAK,EAAE,CAACS,MAAM,CAACG,SAAS,EAAEZ,KAAK,CAAE;MAACa,QAAQ,EAAEX,YAAa;MAAAP,QAAA,gBACtEJ,IAAA,CAACF,aAAa;QAACQ,KAAK,EAAEA,KAAM;QAACiB,aAAa,EAAEhB,YAAa;QAACc,SAAS;MAAA,CAAE,CAAC,EACrEjB,QAAQ;IAAA,CACI,CAAC;EAChB;AACJ;;AAEA;AACA,OAAO,SAASoB,qBAAqBA,CAAC;EAAER;AAA2B,CAAC,EAAE;EACpE,oBAAOhB,IAAA,CAACoB,IAAI;IAACX,KAAK,EAAES,MAAM,CAACO,MAAM,CAACT,MAAM;EAAE,CAAE,CAAC;AAC/C;AAEA,MAAME,MAAM,GAAGrB,UAAU,CAAC6B,MAAM,CAAEC,KAAK,KAAM;EAC3CN,SAAS,EAAE;IACT;IACA;IACAO,aAAa,EAAED,KAAK,CAACE,OAAO,CAAC,GAAG,CAAC;IACjCC,QAAQ,EAAE;MACRzB,OAAO,EAAE;QACP0B,CAAC,EAAE;UAAEC,iBAAiB,EAAEL,KAAK,CAACZ,MAAM,CAACkB,MAAM,CAAC5B,OAAO,CAAC0B;QAAE,CAAC;QACvDG,IAAI,EAAE,CAAC;MACT;IACF,CAAC;IAAAC,iBAAA;EACH,CAAC;EACDV,MAAM,EAAGT,MAAc,KAAM;IAAEA;EAAO,CAAC;AACzC,CAAC,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/header/parts/HeaderBar.js

@@ -0,0 +1,122 @@
+"use strict";
+
+import { View } from "react-native-unistyles/components/native/View";
+import { Text } from "react-native-unistyles/components/native/Text";
+import Animated from "react-native-reanimated";
+import { StyleSheet, useUnistyles } from "react-native-unistyles";
+import { FONT_WEIGHT_VALUE } from "../../../utils/typography.js";
+import { Toolbar } from "../../toolbar/index.js";
+import { HeaderDismissButton } from "../header-buttons.js";
+import { isCustomTitle, isTextTitle } from "../utils.js";
+import { HeaderSurface } from "./HeaderSurface.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** Shared compact bar. Only the title and background animate; actions stay interactive. */
+export function HeaderBar({
+  title,
+  leading,
+  trailing,
+  titleAlignment,
+  color,
+  surfaceStyle,
+  titleStyle,
+  dismissAction = "none",
+  navigation,
+  onDismiss
+}) {
+  const {
+    theme
+  } = useUnistyles();
+  const _styles = styles;
+  {
+    const styles = _styles.useVariants({
+      titleAlignment
+    });
+    const dismiss = /*#__PURE__*/_jsx(HeaderDismissButton, {
+      dismissAction: dismissAction,
+      navigation: navigation,
+      onDismiss: onDismiss
+    });
+    return /*#__PURE__*/_jsxs(View, {
+      style: styles.bar,
+      children: [/*#__PURE__*/_jsx(HeaderSurface, {
+        color: color,
+        animatedStyle: surfaceStyle
+      }), (leading != null || dismissAction === "back") && /*#__PURE__*/_jsxs(Toolbar, {
+        children: [dismissAction === "back" && dismiss, leading]
+      }), /*#__PURE__*/_jsx(Animated.View, {
+        style: [styles.titleContainer, titleStyle],
+        pointerEvents: isCustomTitle(title) ? "box-none" : "none",
+        children: isTextTitle(title) ? String(title).trim().length > 0 && /*#__PURE__*/_jsx(Text, {
+          style: styles.title,
+          maxFontSizeMultiplier: theme.typography.variants["title-md"].maxFontSizeMultiplier,
+          children: title
+        }) : title
+      }), (trailing != null || dismissAction === "close") && /*#__PURE__*/_jsxs(Toolbar, {
+        style: styles.trailing,
+        children: [dismissAction === "close" && dismiss, trailing]
+      })]
+    });
+  }
+}
+const styles = StyleSheet.create(theme => ({
+  bar: {
+    height: theme.layout.header.height,
+    flexDirection: "row",
+    alignItems: "center",
+    paddingHorizontal: theme.layout.screen.padding.x,
+    gap: theme.spacing["3"],
+    justifyContent: "space-between",
+    uni__dependencies: [0]
+  },
+  // A centered title is absolutely positioned, so it leaves the flex row. With
+  // no leading slot the trailing toolbar would be the only in-flow child and
+  // `space-between` would park it on the left — the auto margin pins it right.
+  trailing: {
+    justifyContent: "flex-end",
+    variants: {
+      titleAlignment: {
+        center: {
+          marginLeft: "auto"
+        },
+        left: {}
+      }
+    },
+    uni__dependencies: [4]
+  },
+  titleContainer: {
+    variants: {
+      titleAlignment: {
+        center: {
+          position: "absolute",
+          left: 0,
+          right: 0,
+          alignItems: "center"
+        },
+        left: {
+          flex: 1,
+          alignItems: "flex-start"
+        }
+      }
+    },
+    uni__dependencies: [4]
+  },
+  title: {
+    fontSize: theme.typography.variants["title-md"].fontSize,
+    lineHeight: theme.typography.variants["title-md"].lineHeight,
+    letterSpacing: theme.typography.variants["title-md"].letterSpacing,
+    fontWeight: FONT_WEIGHT_VALUE[theme.typography.variants["title-md"].fontWeight],
+    color: theme.color["text.primary"] ?? "",
+    variants: {
+      titleAlignment: {
+        center: {
+          textAlign: "center"
+        },
+        left: {
+          textAlign: "left"
+        }
+      }
+    },
+    uni__dependencies: [0, 4]
+  }
+}));
+//# sourceMappingURL=HeaderBar.js.map

package/lib/module/components/header/parts/HeaderBar.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Animated","StyleSheet","useUnistyles","FONT_WEIGHT_VALUE","Toolbar","HeaderDismissButton","isCustomTitle","isTextTitle","HeaderSurface","jsx","_jsx","jsxs","_jsxs","HeaderBar","title","leading","trailing","titleAlignment","color","surfaceStyle","titleStyle","dismissAction","navigation","onDismiss","theme","_styles","styles","useVariants","dismiss","View","style","bar","children","animatedStyle","titleContainer","pointerEvents","String","trim","length","Text","maxFontSizeMultiplier","typography","variants","create","height","layout","header","flexDirection","alignItems","paddingHorizontal","screen","padding","x","gap","spacing","justifyContent","uni__dependencies","center","marginLeft","left","position","right","flex","fontSize","lineHeight","letterSpacing","fontWeight","textAlign"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderBar.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/header/parts/HeaderGradientOverlay.js

@@ -18,7 +18,9 @@ export const HEADER_FADE_END_OPACITY = 0.85;
  * the ramp simply spans whatever they gave it.
  */
 export function HeaderGradientOverlay({
-  color
+  color,
+  startOpacity = 1,
+  endOpacity = HEADER_FADE_END_OPACITY
 }) {
   const gradientId = useId();
   return /*#__PURE__*/_jsxs(Svg, {
@@ -34,11 +36,11 @@ export function HeaderGradientOverlay({
         children: [/*#__PURE__*/_jsx(Stop, {
           offset: 0,
           stopColor: color,
-          stopOpacity: 1
+          stopOpacity: startOpacity
         }), /*#__PURE__*/_jsx(Stop, {
           offset: 1,
           stopColor: color,
-          stopOpacity: HEADER_FADE_END_OPACITY
+          stopOpacity: endOpacity
         })]
       })
     }), /*#__PURE__*/_jsx(Rect, {

package/lib/module/components/header/parts/HeaderGradientOverlay.js.map

@@ -1 +1 @@
-{"version":3,"names":["useId","Svg","Defs","Rect","Stop","LinearGradient","SvgLinearGradient","jsx","_jsx","jsxs","_jsxs","HEADER_FADE_END_OPACITY","HeaderGradientOverlay","color","gradientId","height","width","children","id","x1","y1","x2","y2","offset","stopColor","stopOpacity","fill"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderGradientOverlay.tsx"],"mappings":";;AAAA,SAASA,KAAK,QAAQ,OAAO;AAE7B,OAAOC,GAAG,IAAIC,IAAI,EAAEC,IAAI,EAAEC,IAAI,EAAEC,cAAc,IAAIC,iBAAiB,QAAQ,kBAAkB;;AAE7F;AACA;AACA;AACA;AACA;AAJA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAKA,OAAO,MAAMC,uBAAuB,GAAG,IAAI;AAO3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAC;EAAEC;AAAkC,CAAC,EAAE;EAC3E,MAAMC,UAAU,GAAGd,KAAK,CAAC,CAAC;EAE1B,oBACEU,KAAA,CAACT,GAAG;IAACc,MAAM,EAAC,MAAM;IAACC,KAAK,EAAC,MAAM;IAAAC,QAAA,gBAC7BT,IAAA,CAACN,IAAI;MAAAe,QAAA,eACHP,KAAA,CAACJ,iBAAiB;QAACY,EAAE,EAAEJ,UAAW;QAACK,EAAE,EAAC,GAAG;QAACC,EAAE,EAAC,GAAG;QAACC,EAAE,EAAC,GAAG;QAACC,EAAE,EAAC,GAAG;QAAAL,QAAA,gBAC5DT,IAAA,CAACJ,IAAI;UAACmB,MAAM,EAAE,CAAE;UAACC,SAAS,EAAEX,KAAM;UAACY,WAAW,EAAE;QAAE,CAAE,CAAC,eACrDjB,IAAA,CAACJ,IAAI;UAACmB,MAAM,EAAE,CAAE;UAACC,SAAS,EAAEX,KAAM;UAACY,WAAW,EAAEd;QAAwB,CAAE,CAAC;MAAA,CAC1D;IAAC,CAChB,CAAC,eACPH,IAAA,CAACL,IAAI;MAACa,KAAK,EAAC,MAAM;MAACD,MAAM,EAAC,MAAM;MAACW,IAAI,EAAE,QAAQZ,UAAU;IAAI,CAAE,CAAC;EAAA,CAC7D,CAAC;AAEV","ignoreList":[]}
+{"version":3,"names":["useId","Svg","Defs","Rect","Stop","LinearGradient","SvgLinearGradient","jsx","_jsx","jsxs","_jsxs","HEADER_FADE_END_OPACITY","HeaderGradientOverlay","color","startOpacity","endOpacity","gradientId","height","width","children","id","x1","y1","x2","y2","offset","stopColor","stopOpacity","fill"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderGradientOverlay.tsx"],"mappings":";;AAAA,SAASA,KAAK,QAAQ,OAAO;AAE7B,OAAOC,GAAG,IAAIC,IAAI,EAAEC,IAAI,EAAEC,IAAI,EAAEC,cAAc,IAAIC,iBAAiB,QAAQ,kBAAkB;;AAE7F;AACA;AACA;AACA;AACA;AAJA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAKA,OAAO,MAAMC,uBAAuB,GAAG,IAAI;AAS3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAAC;EACpCC,KAAK;EACLC,YAAY,GAAG,CAAC;EAChBC,UAAU,GAAGJ;AACa,CAAC,EAAE;EAC7B,MAAMK,UAAU,GAAGhB,KAAK,CAAC,CAAC;EAE1B,oBACEU,KAAA,CAACT,GAAG;IAACgB,MAAM,EAAC,MAAM;IAACC,KAAK,EAAC,MAAM;IAAAC,QAAA,gBAC7BX,IAAA,CAACN,IAAI;MAAAiB,QAAA,eACHT,KAAA,CAACJ,iBAAiB;QAACc,EAAE,EAAEJ,UAAW;QAACK,EAAE,EAAC,GAAG;QAACC,EAAE,EAAC,GAAG;QAACC,EAAE,EAAC,GAAG;QAACC,EAAE,EAAC,GAAG;QAAAL,QAAA,gBAC5DX,IAAA,CAACJ,IAAI;UAACqB,MAAM,EAAE,CAAE;UAACC,SAAS,EAAEb,KAAM;UAACc,WAAW,EAAEb;QAAa,CAAE,CAAC,eAChEN,IAAA,CAACJ,IAAI;UAACqB,MAAM,EAAE,CAAE;UAACC,SAAS,EAAEb,KAAM;UAACc,WAAW,EAAEZ;QAAW,CAAE,CAAC;MAAA,CAC7C;IAAC,CAChB,CAAC,eACPP,IAAA,CAACL,IAAI;MAACe,KAAK,EAAC,MAAM;MAACD,MAAM,EAAC,MAAM;MAACW,IAAI,EAAE,QAAQZ,UAAU;IAAI,CAAE,CAAC;EAAA,CAC7D,CAAC;AAEV","ignoreList":[]}

package/lib/module/components/header/parts/HeaderSurface.js

@@ -1,13 +1,11 @@
 "use strict";
 
-import { View } from "react-native-unistyles/components/native/View";
 import Animated from "react-native-reanimated";
 import { StyleSheet } from "react-native-unistyles";
-import { HeaderGradientOverlay } from "./HeaderGradientOverlay.js";
+import { HEADER_FADE_END_OPACITY, HeaderGradientOverlay } from "./HeaderGradientOverlay.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * Header background covering the bar and any accessory as one surface, so
- * content scrolling under the header meets a single boundary rather than two.
+ * Header background with matching gradient boundaries for the bar and accessory.
  *
  * The ramp spans the surface itself: it is sized by the caller and stays inside
  * those bounds, so a taller surface stretches the fade rather than adding to it.
@@ -15,15 +13,15 @@ import { jsx as _jsx } from "react/jsx-runtime";
 export function HeaderSurface({
   color,
   animatedStyle,
-  solid
+  accessory
 }) {
   return /*#__PURE__*/_jsx(Animated.View, {
     style: [styles.surface, animatedStyle],
     pointerEvents: "none",
-    children: solid ? /*#__PURE__*/_jsx(View, {
-      style: styles.fill(color)
-    }) : /*#__PURE__*/_jsx(HeaderGradientOverlay, {
-      color: color
+    children: /*#__PURE__*/_jsx(HeaderGradientOverlay, {
+      color: color,
+      startOpacity: accessory ? HEADER_FADE_END_OPACITY : 1,
+      endOpacity: accessory ? 0.8 : HEADER_FADE_END_OPACITY
     })
   });
 }
@@ -34,10 +32,6 @@ const styles = StyleSheet.create(() => ({
     left: 0,
     right: 0,
     bottom: 0
-  },
-  fill: color => ({
-    flex: 1,
-    backgroundColor: color
-  })
+  }
 }));
 //# sourceMappingURL=HeaderSurface.js.map

package/lib/module/components/header/parts/HeaderSurface.js.map

@@ -1 +1 @@
-{"version":3,"names":["Animated","StyleSheet","HeaderGradientOverlay","jsx","_jsx","HeaderSurface","color","animatedStyle","solid","View","style","styles","surface","pointerEvents","children","fill","create","position","top","left","right","bottom","flex","backgroundColor"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderSurface.tsx"],"mappings":";;;AAEA,OAAOA,QAAQ,MAAiC,yBAAyB;AACzE,SAASC,UAAU,QAAQ,wBAAwB;AAEnD,SAASC,qBAAqB;AAAkC,SAAAC,GAAA,IAAAC,IAAA;AAgBhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAC;EAAEC,KAAK;EAAEC,aAAa;EAAEC;AAA0B,CAAC,EAAE;EACjF,oBACEJ,IAAA,CAACJ,QAAQ,CAACS,IAAI;IAACC,KAAK,EAAE,CAACC,MAAM,CAACC,OAAO,EAAEL,aAAa,CAAE;IAACM,aAAa,EAAC,MAAM;IAAAC,QAAA,EACxEN,KAAK,gBAAGJ,IAAA,CAACK,IAAI;MAACC,KAAK,EAAEC,MAAM,CAACI,IAAI,CAACT,KAAK;IAAE,CAAE,CAAC,gBAAGF,IAAA,CAACF,qBAAqB;MAACI,KAAK,EAAEA;IAAM,CAAE;EAAC,CACzE,CAAC;AAEpB;AAEA,MAAMK,MAAM,GAAGV,UAAU,CAACe,MAAM,CAAC,OAAO;EACtCJ,OAAO,EAAE;IACPK,QAAQ,EAAE,UAAU;IACpBC,GAAG,EAAE,CAAC;IACNC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRC,MAAM,EAAE;EACV,CAAC;EACDN,IAAI,EAAGT,KAAa,KAAM;IACxBgB,IAAI,EAAE,CAAC;IACPC,eAAe,EAAEjB;EACnB,CAAC;AACH,CAAC,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["Animated","StyleSheet","HEADER_FADE_END_OPACITY","HeaderGradientOverlay","jsx","_jsx","HeaderSurface","color","animatedStyle","accessory","View","style","styles","surface","pointerEvents","children","startOpacity","endOpacity","create","position","top","left","right","bottom"],"sourceRoot":"../../../../../src","sources":["components/header/parts/HeaderSurface.tsx"],"mappings":";;AAAA,OAAOA,QAAQ,MAAiC,yBAAyB;AACzE,SAASC,UAAU,QAAQ,wBAAwB;AAEnD,SAASC,uBAAuB,EAAEC,qBAAqB;AAAkC,SAAAC,GAAA,IAAAC,IAAA;AAazF;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAC;EAAEC,KAAK;EAAEC,aAAa;EAAEC;AAA8B,CAAC,EAAE;EACrF,oBACEJ,IAAA,CAACL,QAAQ,CAACU,IAAI;IAACC,KAAK,EAAE,CAACC,MAAM,CAACC,OAAO,EAAEL,aAAa,CAAE;IAACM,aAAa,EAAC,MAAM;IAAAC,QAAA,eACzEV,IAAA,CAACF,qBAAqB;MACpBI,KAAK,EAAEA,KAAM;MACbS,YAAY,EAAEP,SAAS,GAAGP,uBAAuB,GAAG,CAAE;MACtDe,UAAU,EAAER,SAAS,GAAG,GAAG,GAAGP;IAAwB,CACvD;EAAC,CACW,CAAC;AAEpB;AAEA,MAAMU,MAAM,GAAGX,UAAU,CAACiB,MAAM,CAAC,OAAO;EACtCL,OAAO,EAAE;IACPM,QAAQ,EAAE,UAAU;IACpBC,GAAG,EAAE,CAAC;IACNC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRC,MAAM,EAAE;EACV;AACF,CAAC,CAAC,CAAC","ignoreList":[]}