@onekeyfe/react-native-native-list 6.7.0-alpha.375 → 6.7.0-alpha.382

package/lib/nitrogen/generated/ios/c++/HybridNativeListSpecSwift.hpp

@@ -96,6 +96,13 @@ namespace margelo::nitro::nativelist {
     inline void setContainerSlotHeightsJson(const std::string& containerSlotHeightsJson) noexcept override {
       _swiftPart.setContainerSlotHeightsJson(containerSlotHeightsJson);
     }
+    inline std::string getSidecarLayoutJson() noexcept override {
+      auto __result = _swiftPart.getSidecarLayoutJson();
+      return __result;
+    }
+    inline void setSidecarLayoutJson(const std::string& sidecarLayoutJson) noexcept override {
+      _swiftPart.setSidecarLayoutJson(sidecarLayoutJson);
+    }
     inline NativeListScrollEdgeEffect getTopScrollEdgeEffect() noexcept override {
       auto __result = _swiftPart.getTopScrollEdgeEffect();
       return static_cast<NativeListScrollEdgeEffect>(__result);
@@ -179,6 +186,13 @@ namespace margelo::nitro::nativelist {
     inline void setOnVisibleRangeChanged(const std::optional<std::function<void(const std::string& /* payloadJson */)>>& onVisibleRangeChanged) noexcept override {
       _swiftPart.setOnVisibleRangeChanged(onVisibleRangeChanged);
     }
+    inline std::optional<std::function<void(const std::string& /* payloadJson */)>> getOnStructuralTransitionSettled() noexcept override {
+      auto __result = _swiftPart.getOnStructuralTransitionSettled();
+      return __result;
+    }
+    inline void setOnStructuralTransitionSettled(const std::optional<std::function<void(const std::string& /* payloadJson */)>>& onStructuralTransitionSettled) noexcept override {
+      _swiftPart.setOnStructuralTransitionSettled(onStructuralTransitionSettled);
+    }
 
   public:
     // Methods

package/lib/nitrogen/generated/ios/c++/views/HybridNativeListComponent.mm

@@ -130,6 +130,12 @@ using namespace margelo::nitro::nativelist::views;
           : !newViewProps.containerSlotHeightsJson.hasSameValue(oldViewProps->containerSlotHeightsJson)) {
       swiftPart.setContainerSlotHeightsJson(newViewProps.containerSlotHeightsJson.get());
     }
+    // sidecarLayoutJson: string
+    if (oldViewProps == nullptr
+          ? newViewProps.sidecarLayoutJson.isProvided()
+          : !newViewProps.sidecarLayoutJson.hasSameValue(oldViewProps->sidecarLayoutJson)) {
+      swiftPart.setSidecarLayoutJson(newViewProps.sidecarLayoutJson.get());
+    }
     // topScrollEdgeEffect: enum
     if (oldViewProps == nullptr
           ? newViewProps.topScrollEdgeEffect.isProvided()
@@ -202,6 +208,12 @@ using namespace margelo::nitro::nativelist::views;
           : !newViewProps.onVisibleRangeChanged.hasSameValue(oldViewProps->onVisibleRangeChanged)) {
       swiftPart.setOnVisibleRangeChanged(newViewProps.onVisibleRangeChanged.get());
     }
+    // onStructuralTransitionSettled: optional
+    if (oldViewProps == nullptr
+          ? newViewProps.onStructuralTransitionSettled.isProvided()
+          : !newViewProps.onStructuralTransitionSettled.hasSameValue(oldViewProps->onStructuralTransitionSettled)) {
+      swiftPart.setOnStructuralTransitionSettled(newViewProps.onStructuralTransitionSettled.get());
+    }
 
     // Update hybridRef if it changed
     if (oldViewProps == nullptr

package/lib/nitrogen/generated/ios/swift/HybridNativeListSpec.swift

@@ -13,6 +13,7 @@ public protocol HybridNativeListSpec_protocol: HybridObject, HybridView {
   var snapshotJson: String { get set }
   var fontFamiliesJson: String { get set }
   var containerSlotHeightsJson: String { get set }
+  var sidecarLayoutJson: String { get set }
   var topScrollEdgeEffect: NativeListScrollEdgeEffect { get set }
   var topOverlayHeight: Double { get set }
   var scrollPositionThresholdsJson: String { get set }
@@ -25,6 +26,7 @@ public protocol HybridNativeListSpec_protocol: HybridObject, HybridView {
   var onReorder: ((_ payloadJson: String) -> Void)? { get set }
   var onEndReached: ((_ payloadJson: String) -> Void)? { get set }
   var onVisibleRangeChanged: ((_ payloadJson: String) -> Void)? { get set }
+  var onStructuralTransitionSettled: ((_ payloadJson: String) -> Void)? { get set }
 
   // Methods
   func applySnapshot(snapshotJson: String) throws -> Void

package/lib/nitrogen/generated/ios/swift/HybridNativeListSpec_cxx.swift

@@ -154,6 +154,17 @@ open class HybridNativeListSpec_cxx {
     }
   }
   
+  public final var sidecarLayoutJson: std.string {
+    @inline(__always)
+    get {
+      return std.string(self.__implementation.sidecarLayoutJson)
+    }
+    @inline(__always)
+    set {
+      self.__implementation.sidecarLayoutJson = String(newValue)
+    }
+  }
+  
   public final var topScrollEdgeEffect: Int32 {
     @inline(__always)
     get {
@@ -432,6 +443,38 @@ open class HybridNativeListSpec_cxx {
       }()
     }
   }
+  
+  public final var onStructuralTransitionSettled: bridge.std__optional_std__function_void_const_std__string_____payloadJson______ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__function_void_const_std__string_____payloadJson______ in
+        if let __unwrappedValue = self.__implementation.onStructuralTransitionSettled {
+          return bridge.create_std__optional_std__function_void_const_std__string_____payloadJson______({ () -> bridge.Func_void_std__string in
+            let __closureWrapper = Func_void_std__string(__unwrappedValue)
+            return bridge.create_Func_void_std__string(__closureWrapper.toUnsafe())
+          }())
+        } else {
+          return .init()
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.onStructuralTransitionSettled = { () -> ((_ payloadJson: String) -> Void)? in
+        if bridge.has_value_std__optional_std__function_void_const_std__string_____payloadJson______(newValue) {
+          let __unwrapped = bridge.get_std__optional_std__function_void_const_std__string_____payloadJson______(newValue)
+          return { () -> (String) -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void_std__string(__unwrapped)
+            return { (__payloadJson: String) -> Void in
+              __wrappedFunction.call(std.string(__payloadJson))
+            }
+          }()
+        } else {
+          return nil
+        }
+      }()
+    }
+  }
 
   // Methods
   @inline(__always)

package/lib/nitrogen/generated/shared/c++/HybridNativeListSpec.cpp

@@ -20,6 +20,8 @@ namespace margelo::nitro::nativelist {
       prototype.registerHybridSetter("fontFamiliesJson", &HybridNativeListSpec::setFontFamiliesJson);
       prototype.registerHybridGetter("containerSlotHeightsJson", &HybridNativeListSpec::getContainerSlotHeightsJson);
       prototype.registerHybridSetter("containerSlotHeightsJson", &HybridNativeListSpec::setContainerSlotHeightsJson);
+      prototype.registerHybridGetter("sidecarLayoutJson", &HybridNativeListSpec::getSidecarLayoutJson);
+      prototype.registerHybridSetter("sidecarLayoutJson", &HybridNativeListSpec::setSidecarLayoutJson);
       prototype.registerHybridGetter("topScrollEdgeEffect", &HybridNativeListSpec::getTopScrollEdgeEffect);
       prototype.registerHybridSetter("topScrollEdgeEffect", &HybridNativeListSpec::setTopScrollEdgeEffect);
       prototype.registerHybridGetter("topOverlayHeight", &HybridNativeListSpec::getTopOverlayHeight);
@@ -44,6 +46,8 @@ namespace margelo::nitro::nativelist {
       prototype.registerHybridSetter("onEndReached", &HybridNativeListSpec::setOnEndReached);
       prototype.registerHybridGetter("onVisibleRangeChanged", &HybridNativeListSpec::getOnVisibleRangeChanged);
       prototype.registerHybridSetter("onVisibleRangeChanged", &HybridNativeListSpec::setOnVisibleRangeChanged);
+      prototype.registerHybridGetter("onStructuralTransitionSettled", &HybridNativeListSpec::getOnStructuralTransitionSettled);
+      prototype.registerHybridSetter("onStructuralTransitionSettled", &HybridNativeListSpec::setOnStructuralTransitionSettled);
       prototype.registerHybridMethod("applySnapshot", &HybridNativeListSpec::applySnapshot);
       prototype.registerHybridMethod("applyPatches", &HybridNativeListSpec::applyPatches);
       prototype.registerHybridMethod("reconcileSelection", &HybridNativeListSpec::reconcileSelection);

package/lib/nitrogen/generated/shared/c++/HybridNativeListSpec.hpp

@@ -63,6 +63,8 @@ namespace margelo::nitro::nativelist {
       virtual void setFontFamiliesJson(const std::string& fontFamiliesJson) = 0;
       virtual std::string getContainerSlotHeightsJson() = 0;
       virtual void setContainerSlotHeightsJson(const std::string& containerSlotHeightsJson) = 0;
+      virtual std::string getSidecarLayoutJson() = 0;
+      virtual void setSidecarLayoutJson(const std::string& sidecarLayoutJson) = 0;
       virtual NativeListScrollEdgeEffect getTopScrollEdgeEffect() = 0;
       virtual void setTopScrollEdgeEffect(NativeListScrollEdgeEffect topScrollEdgeEffect) = 0;
       virtual double getTopOverlayHeight() = 0;
@@ -87,6 +89,8 @@ namespace margelo::nitro::nativelist {
       virtual void setOnEndReached(const std::optional<std::function<void(const std::string& /* payloadJson */)>>& onEndReached) = 0;
       virtual std::optional<std::function<void(const std::string& /* payloadJson */)>> getOnVisibleRangeChanged() = 0;
       virtual void setOnVisibleRangeChanged(const std::optional<std::function<void(const std::string& /* payloadJson */)>>& onVisibleRangeChanged) = 0;
+      virtual std::optional<std::function<void(const std::string& /* payloadJson */)>> getOnStructuralTransitionSettled() = 0;
+      virtual void setOnStructuralTransitionSettled(const std::optional<std::function<void(const std::string& /* payloadJson */)>>& onStructuralTransitionSettled) = 0;
 
     public:
       // Methods

package/lib/nitrogen/generated/shared/c++/views/HybridNativeListComponent.cpp

@@ -23,6 +23,7 @@ namespace margelo::nitro::nativelist::views {
     snapshotJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "snapshotJson", rawProps, sourceProps.snapshotJson)),
     fontFamiliesJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "fontFamiliesJson", rawProps, sourceProps.fontFamiliesJson)),
     containerSlotHeightsJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "containerSlotHeightsJson", rawProps, sourceProps.containerSlotHeightsJson)),
+    sidecarLayoutJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "sidecarLayoutJson", rawProps, sourceProps.sidecarLayoutJson)),
     topScrollEdgeEffect(nitro::ReactProp<NativeListScrollEdgeEffect>::fromRawValue("NativeList", "topScrollEdgeEffect", rawProps, sourceProps.topScrollEdgeEffect)),
     topOverlayHeight(nitro::ReactProp<double>::fromRawValue("NativeList", "topOverlayHeight", rawProps, sourceProps.topOverlayHeight)),
     scrollPositionThresholdsJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "scrollPositionThresholdsJson", rawProps, sourceProps.scrollPositionThresholdsJson)),
@@ -35,6 +36,7 @@ namespace margelo::nitro::nativelist::views {
     onReorder(nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>>::fromRawValue("NativeList", "onReorder", rawProps, sourceProps.onReorder)),
     onEndReached(nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>>::fromRawValue("NativeList", "onEndReached", rawProps, sourceProps.onEndReached)),
     onVisibleRangeChanged(nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>>::fromRawValue("NativeList", "onVisibleRangeChanged", rawProps, sourceProps.onVisibleRangeChanged)),
+    onStructuralTransitionSettled(nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>>::fromRawValue("NativeList", "onStructuralTransitionSettled", rawProps, sourceProps.onStructuralTransitionSettled)),
     hybridRef(nitro::ReactProp<std::optional<std::function<void(const std::shared_ptr<HybridNativeListSpec>& /* ref */)>>>::fromRawValue("NativeList", "hybridRef", rawProps, sourceProps.hybridRef)) { }
 
   bool HybridNativeListProps::filterObjectKeys(const std::string& propName) {
@@ -42,6 +44,7 @@ namespace margelo::nitro::nativelist::views {
       case hashString("snapshotJson"): return true;
       case hashString("fontFamiliesJson"): return true;
       case hashString("containerSlotHeightsJson"): return true;
+      case hashString("sidecarLayoutJson"): return true;
       case hashString("topScrollEdgeEffect"): return true;
       case hashString("topOverlayHeight"): return true;
       case hashString("scrollPositionThresholdsJson"): return true;
@@ -54,6 +57,7 @@ namespace margelo::nitro::nativelist::views {
       case hashString("onReorder"): return true;
       case hashString("onEndReached"): return true;
       case hashString("onVisibleRangeChanged"): return true;
+      case hashString("onStructuralTransitionSettled"): return true;
       case hashString("hybridRef"): return true;
       default: return false;
     }

package/lib/nitrogen/generated/shared/c++/views/HybridNativeListComponent.hpp

@@ -49,6 +49,7 @@ namespace margelo::nitro::nativelist::views {
     nitro::ReactProp<std::string> snapshotJson;
     nitro::ReactProp<std::string> fontFamiliesJson;
     nitro::ReactProp<std::string> containerSlotHeightsJson;
+    nitro::ReactProp<std::string> sidecarLayoutJson;
     nitro::ReactProp<NativeListScrollEdgeEffect> topScrollEdgeEffect;
     nitro::ReactProp<double> topOverlayHeight;
     nitro::ReactProp<std::string> scrollPositionThresholdsJson;
@@ -61,6 +62,7 @@ namespace margelo::nitro::nativelist::views {
     nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>> onReorder;
     nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>> onEndReached;
     nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>> onVisibleRangeChanged;
+    nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>> onStructuralTransitionSettled;
     nitro::ReactProp<std::optional<std::function<void(const std::shared_ptr<HybridNativeListSpec>& /* ref */)>>> hybridRef;
 
     [[nodiscard]]
@@ -68,6 +70,7 @@ namespace margelo::nitro::nativelist::views {
       return snapshotJson.hasSameValue(other.snapshotJson) &&
              fontFamiliesJson.hasSameValue(other.fontFamiliesJson) &&
              containerSlotHeightsJson.hasSameValue(other.containerSlotHeightsJson) &&
+             sidecarLayoutJson.hasSameValue(other.sidecarLayoutJson) &&
              topScrollEdgeEffect.hasSameValue(other.topScrollEdgeEffect) &&
              topOverlayHeight.hasSameValue(other.topOverlayHeight) &&
              scrollPositionThresholdsJson.hasSameValue(other.scrollPositionThresholdsJson) &&
@@ -80,6 +83,7 @@ namespace margelo::nitro::nativelist::views {
              onReorder.hasSameValue(other.onReorder) &&
              onEndReached.hasSameValue(other.onEndReached) &&
              onVisibleRangeChanged.hasSameValue(other.onVisibleRangeChanged) &&
+             onStructuralTransitionSettled.hasSameValue(other.onStructuralTransitionSettled) &&
              hybridRef.hasSameValue(other.hybridRef);
     }
 
@@ -88,6 +92,7 @@ namespace margelo::nitro::nativelist::views {
       return snapshotJson.isProvided() ||
              fontFamiliesJson.isProvided() ||
              containerSlotHeightsJson.isProvided() ||
+             sidecarLayoutJson.isProvided() ||
              topScrollEdgeEffect.isProvided() ||
              topOverlayHeight.isProvided() ||
              scrollPositionThresholdsJson.isProvided() ||
@@ -100,6 +105,7 @@ namespace margelo::nitro::nativelist::views {
              onReorder.isProvided() ||
              onEndReached.isProvided() ||
              onVisibleRangeChanged.isProvided() ||
+             onStructuralTransitionSettled.isProvided() ||
              hybridRef.isProvided();
     }
 

package/lib/nitrogen/generated/shared/json/NativeListConfig.json

@@ -7,6 +7,7 @@
     "snapshotJson": true,
     "fontFamiliesJson": true,
     "containerSlotHeightsJson": true,
+    "sidecarLayoutJson": true,
     "topScrollEdgeEffect": true,
     "topOverlayHeight": true,
     "scrollPositionThresholdsJson": true,
@@ -19,6 +20,7 @@
     "onReorder": true,
     "onEndReached": true,
     "onVisibleRangeChanged": true,
+    "onStructuralTransitionSettled": true,
     "hybridRef": true
   }
 }

package/lib/typescript/src/NativeList.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { ImageSource, NativeListSnapshot } from './models';
 import type { NativeListProps } from './NativeList.types';
-export type { NativeListProps, NativeListRef } from './NativeList.types';
+export type { NativeListProps, NativeListRef, StructuralTransitionSettledEvent, } from './NativeList.types';
 export type { ActionAnchorState, NativeListKeyboardDismissMode, NativeListKeyboardShouldPersistTaps, ScrollAlignment, ScrollPositionOptions, ScrollToEndParams, ScrollToIndexFailedInfo, ScrollToIndexParams, ScrollToItemParams, ScrollToKeyParams, ScrollToLocationParams, ScrollToOffsetParams, } from './NativeList.types';
 export declare function preloadNativeListAvatarImages(sources: readonly ImageSource[]): Promise<boolean>;
 export declare const NativeList: React.ForwardRefExoticComponent<NativeListProps & React.RefAttributes<Readonly<{

package/lib/typescript/src/NativeList.nitro.d.ts

@@ -8,6 +8,7 @@ export interface NativeListNativeProps extends HybridViewProps {
     snapshotJson: string;
     fontFamiliesJson: string;
     containerSlotHeightsJson: string;
+    sidecarLayoutJson: string;
     topScrollEdgeEffect: NativeListScrollEdgeEffect;
     topOverlayHeight: number;
     scrollPositionThresholdsJson: string;
@@ -20,6 +21,7 @@ export interface NativeListNativeProps extends HybridViewProps {
     onReorder?: (payloadJson: string) => void;
     onEndReached?: (payloadJson: string) => void;
     onVisibleRangeChanged?: (payloadJson: string) => void;
+    onStructuralTransitionSettled?: (payloadJson: string) => void;
 }
 export type NativeListKeyboardDismissMode = 'none' | 'on-drag' | 'interactive';
 export type NativeListKeyboardShouldPersistTaps = 'never' | 'always' | 'handled';

package/lib/typescript/src/NativeList.types.d.ts

@@ -49,6 +49,16 @@ export type NativeListWebScrollHost = Readonly<{
     clientHeight: number;
     scrollTop: number;
 }>;
+export type NativeListSidecarLayout = Readonly<{
+    width: number;
+    gap: number;
+    maxContentWidth: number;
+}>;
+export type StructuralTransitionSettledEvent = Readonly<{
+    transitionId: string;
+    status: 'completed' | 'interrupted';
+    settledExpanded: boolean;
+}>;
 type InitialScrollProps = Readonly<{
     initialScrollIndex?: never;
     initialScrollKey?: never;
@@ -86,6 +96,13 @@ export type NativeListProps = Omit<ViewProps, 'children'> & Readonly<{
     listHeader?: ReactNode;
     listFooter?: ReactNode;
     listEmpty?: ReactNode;
+    /** Native disclosure content, retained until its transition settles. */
+    listExpandedContent?: ReactNode;
+    /** Stable native disclosure toggle after expanded content. */
+    listStructureToggle?: ReactNode;
+    /** Scrolling right column for a vertical linear list. Requires sidecarLayout. */
+    listSidecar?: ReactNode;
+    sidecarLayout?: NativeListSidecarLayout;
     /** Fixed overlay above scrolling rows on iOS 26 and newer. */
     topOverlay?: ReactNode;
     /** Selects UIKit's top scroll-edge effect on iOS 26 and newer. */
@@ -111,6 +128,7 @@ export type NativeListProps = Omit<ViewProps, 'children'> & Readonly<{
     onReorder?: (event: ReorderEvent) => void;
     onEndReached?: (event: EndReachedEvent) => void;
     onVisibleRangeChanged?: (event: VisibleRangeChangedEvent) => void;
+    onStructuralTransitionSettled?: (event: StructuralTransitionSettledEvent) => void;
     /** Native only. Emits initial state and hysteresis transitions, not scroll frames. */
     scrollPositionThresholds?: Readonly<{
         start: number;

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

@@ -1,7 +1,7 @@
 export { NativeList, preloadNativeListAvatarImages } from './NativeList';
-export type { ActionAnchorState, NativeListKeyboardDismissMode, NativeListKeyboardShouldPersistTaps, NativeListProps, NativeListRef, ScrollAlignment, ScrollPositionOptions, ScrollToEndParams, ScrollToIndexFailedInfo, ScrollToIndexParams, ScrollToItemParams, ScrollToKeyParams, ScrollToLocationParams, ScrollToOffsetParams, } from './NativeList';
+export type { ActionAnchorState, NativeListKeyboardDismissMode, NativeListKeyboardShouldPersistTaps, NativeListProps, NativeListRef, ScrollAlignment, ScrollPositionOptions, ScrollToEndParams, ScrollToIndexFailedInfo, ScrollToIndexParams, ScrollToItemParams, ScrollToKeyParams, ScrollToLocationParams, ScrollToOffsetParams, StructuralTransitionSettledEvent, } from './NativeList';
 export type * from './models';
-export { applyRowPatches, serializePatches, serializeSnapshot, validatePatches, validateSnapshot, } from './validation';
+export { applyRowPatches, planNativeListPatches, serializePatches, serializeSnapshot, validatePatches, validateSnapshot, } from './validation';
 export { checkboxStateForKeys, checkboxStateForSection, isSelectableRow, reduceSelection, selectionStateFromSnapshot, } from './selection';
 export type { SelectionAction, SelectionResult, SelectionState, } from './selection';
 export { configureNativeListFonts } from './fonts';

package/lib/typescript/src/models.d.ts

@@ -97,6 +97,7 @@ export declare const ROW_BOX_STYLE_KEYS_BY_TYPE: {
     readonly metricCard: readonly ["horizontalPadding", "verticalPadding", "leadingGap", "lineGap", "image"];
     readonly sectionHeader: readonly ["horizontalPadding", "verticalPadding", "lineGap", "trailingGap"];
     readonly action: readonly ["horizontalPadding", "verticalPadding", "leadingGap", "trailingGap", "image"];
+    readonly buttonGroup: readonly [];
     readonly system: readonly ["horizontalPadding", "verticalPadding", "lineGap"];
 };
 type TemplateBoxStyle<T extends keyof typeof ROW_BOX_STYLE_KEYS_BY_TYPE> = Pick<RowBoxStyle, (typeof ROW_BOX_STYLE_KEYS_BY_TYPE)[T][number] | 'container'>;
@@ -107,6 +108,7 @@ type TemplateBoxStyle<T extends keyof typeof ROW_BOX_STYLE_KEYS_BY_TYPE> = Pick<
  * the same key name keeps one meaning across platforms. See docs/STYLE_SPEC.md §4.
  */
 export type IdentityRowStyle = TemplateBoxStyle<'identity'> & Readonly<{
+    leadingContentMaxWidthRatio?: number;
     title?: NativeListTextStyle;
     subtitle?: NativeListTextStyle;
     tertiary?: NativeListTextStyle;
@@ -168,6 +170,13 @@ export type SectionHeaderRowStyle = TemplateBoxStyle<'sectionHeader'> & Readonly
     title?: NativeListTextStyle;
     subtitle?: NativeListTextStyle;
     value?: NativeListTextStyle;
+    valuePlacement?: 'afterTitle';
+    titleDecoration?: 'none' | 'dashed';
+}>;
+export type RowTextHelp = Readonly<{
+    actionKey: string;
+    presentation: 'tooltip' | 'popover';
+    underline?: 'dashed';
 }>;
 export type ActionRowStyle = TemplateBoxStyle<'action'> & Readonly<{
     title?: NativeListTextStyle;
@@ -225,8 +234,13 @@ export type VisualOverlay = Readonly<{
     offsetX?: number;
     offsetY?: number;
     image?: ImageSource;
+    fallbackIcon?: Readonly<{
+        name: string;
+        tintColor?: string;
+    }>;
     name?: string;
     text?: string;
+    fontWeight?: NativeListTextStyle['fontWeight'];
     tintColor?: string;
     backgroundColor?: string;
 }>;
@@ -234,12 +248,15 @@ type VisualWithImage = Readonly<{
     fallbackIcon?: Readonly<{
         name: string;
         tintColor?: string;
+        size?: number;
+        backgroundColor?: string;
     }>;
     overlays?: readonly VisualOverlay[];
     borderStyle?: 'dashed';
     borderColor?: string;
     image?: ImageSource;
     fallbackText?: string;
+    fallbackTextColor?: string;
     backgroundColor?: string;
     shape?: 'circle' | 'rounded' | 'square';
     cornerIcon?: Readonly<{
@@ -291,8 +308,24 @@ export type TrailingAccessory = Readonly<{
     kind: 'valuePair';
     primary: string;
     secondary: string;
+    primaryFontWeight?: 'medium';
+    primaryHelp?: RowTextHelp;
+    primaryTextSegments?: readonly ValueTextSegment[];
+    secondaryTextSegments?: readonly ValueTextSegment[];
     primaryTone?: TextTone;
     secondaryTone?: TextTone;
+}> | Readonly<{
+    kind: 'button';
+    label: string;
+    actionKey: string;
+    disabled?: boolean;
+    testID?: string;
+    accessibilityLabel?: string;
+    textColor?: string;
+    backgroundColor?: string;
+    pressedBackgroundColor?: string;
+    hoverBackgroundColor?: string;
+    focusRingColor?: string;
 }> | Readonly<{
     kind: 'checkbox';
     state: CheckboxState;
@@ -323,6 +356,7 @@ export type TrailingAccessory = Readonly<{
     kind: 'icon';
     name: string;
     tintColor?: string;
+    buttonStyle?: 'tertiary';
     disabled?: boolean;
     actionKey?: string;
     testID?: string;
@@ -362,6 +396,10 @@ export type RowBase = Readonly<{
 }>;
 export type IdentityRow = RowBase & Readonly<{
     type: 'identity';
+    /** Opt in to content-based height; explicit row/container height still wins. */
+    contentHeight?: 'auto';
+    /** Emits a row action instead of a press after a successful long press. */
+    longPressActionKey?: string;
     titleMatch?: readonly Readonly<{
         start: number;
         end: number;
@@ -375,11 +413,27 @@ export type IdentityRow = RowBase & Readonly<{
         kind: 'icon';
     }>;
     title: string;
+    /** Plain 12/16 labels beside the title, preserving independent tones. */
+    titleSuffixes?: readonly Readonly<{
+        text: string;
+        tone: 'secondary' | 'disabled';
+        maxWidth?: number;
+    }>[];
+    titleIcon?: Readonly<{
+        name: string;
+        tintColor?: string;
+        accessibilityLabel?: string;
+        /** Web-only anchored help from this icon; does not add a click action. */
+        hoverActionKey?: string;
+    }>;
+    /** Web-only additional help icon after titleIcon. */
+    secondaryTitleIcon?: IdentityRow['titleIcon'];
     subtitle?: string;
     tertiary?: string;
     tertiaryTone?: 'secondary' | 'info';
     titleLines?: 1 | 2;
-    subtitleLines?: 1 | 2;
+    /** Zero displays the complete subtitle. */
+    subtitleLines?: 0 | 1 | 2;
     badges?: readonly BadgeModel[];
     trailing?: readonly TrailingAccessory[];
     draggable?: boolean;
@@ -413,6 +467,7 @@ export type ActivityAmount = Readonly<{
 export type ActivityRow = RowBase & Readonly<{
     type: 'activity';
     leading: LeadingVisual;
+    hideLeading?: boolean;
     secondaryLeading?: LeadingVisual;
     title: string;
     description?: string;
@@ -436,11 +491,14 @@ export type ActivityRow = RowBase & Readonly<{
 }>;
 export type MessageRow = RowBase & Readonly<{
     type: 'message';
+    /** Draws only top and bottom container borders when a border is supplied. */
+    presentation?: 'inlineWarning';
     unread?: boolean;
     leading?: LeadingVisual;
     title: string;
     body: string;
-    bodyLines?: 1 | 2 | 3;
+    /** Zero displays the complete body. */
+    bodyLines?: 0 | 1 | 2 | 3;
     time: string;
     thumbnail?: ImageSource;
     style?: MessageRowStyle;
@@ -448,8 +506,12 @@ export type MessageRow = RowBase & Readonly<{
 export type DataColumn = Readonly<{
     key: string;
     text: string;
+    textSegments?: readonly ValueTextSegment[];
+    titleIcon?: IdentityRow['titleIcon'];
+    secondaryTitleIcon?: IdentityRow['titleIcon'];
     secondaryLeadingText?: string;
     secondaryText?: string;
+    secondaryTextSegments?: readonly ValueTextSegment[];
     weight?: 1 | 2 | 3;
     alignment?: 'start' | 'center' | 'end';
     tone?: 'primary' | 'secondary' | 'positive' | 'negative';
@@ -459,6 +521,7 @@ export type DataRow = RowBase & Readonly<{
     type: 'dataRow';
     leading?: LeadingVisual;
     columns: readonly DataColumn[];
+    trailing?: readonly TrailingAccessory[];
     checkbox?: Extract<TrailingAccessory, {
         kind: 'checkbox';
     }>;
@@ -611,9 +674,11 @@ export type SectionHeaderRow = RowBase & Readonly<{
     indexTitle?: string;
     variant?: 'summary' | 'gallery' | 'history';
     title: string;
+    leadingBadge?: BadgeModel;
     titleLoading?: boolean;
     subtitle?: string;
     value?: string;
+    valueHelp?: RowTextHelp;
     valueActionKey?: string;
     titleIcon?: Extract<TrailingAccessory, {
         kind: 'icon';
@@ -641,6 +706,19 @@ export type ActionRow = RowBase & Readonly<{
     trailing?: readonly TrailingAccessory[];
     style?: ActionRowStyle;
 }>;
+export type ButtonGroupRow = RowBase & Readonly<{
+    type: 'buttonGroup';
+    buttons: readonly Readonly<{
+        key: string;
+        label: string;
+        actionKey: string;
+        disabled?: boolean;
+        loading?: boolean;
+        testID?: string;
+        accessibilityLabel?: string;
+    }>[];
+    style?: TemplateBoxStyle<'buttonGroup'>;
+}>;
 export type SystemRow = RowBase & Readonly<{
     style?: SystemRowStyle;
 }> & (Readonly<{
@@ -677,7 +755,7 @@ export type SystemRow = RowBase & Readonly<{
     variant: 'spacer';
     height: number;
 }>);
-export type RowModel = IdentityRow | WalletGroupRow | RailRow | ActivityRow | MessageRow | DataRow | MarketRow | MediaTileRow | MetricCardRow | SectionHeaderRow | ActionRow | SystemRow;
+export type RowModel = IdentityRow | WalletGroupRow | RailRow | ActivityRow | MessageRow | DataRow | MarketRow | MediaTileRow | MetricCardRow | SectionHeaderRow | ActionRow | ButtonGroupRow | SystemRow;
 export type NativeListTheme = Readonly<{
     checkboxBackground?: string;
     checkboxBorder?: string;
@@ -687,6 +765,8 @@ export type NativeListTheme = Readonly<{
     rowBackground: string;
     rowSelectedBackground: string;
     rowPressedBackground?: string;
+    /** Web-only enabled-row hover color; defaults to rowPressedBackground. */
+    rowHoverBackground?: string;
     subduedBackground?: string;
     strongBackground?: string;
     /** Web-only background for a displayed declared image fallback. */
@@ -699,6 +779,8 @@ export type NativeListTheme = Readonly<{
     separator: string;
     accent: string;
     positive: string;
+    /** Optional exact background for the success tone of section leading badges. */
+    successBackground?: string;
     negative: string;
     criticalBackground?: string;
     inverseBackground?: string;
@@ -740,6 +822,16 @@ export type NativeListListStyle = Readonly<{
 export type NativeListSnapshot = Readonly<{
     schemaVersion: 1;
     generation: number;
+    /** One-shot animation for a user-initiated row-key insertion or removal. */
+    structuralTransition?: Readonly<{
+        id: string;
+        durationMs?: number;
+        anchorKey?: string;
+    }>;
+    disclosure?: Readonly<{
+        expanded: boolean;
+        expandedTrailingInset?: number;
+    }>;
     layout: Readonly<{
         kind: NativeListLayout;
         orientation?: NativeListOrientation;
@@ -775,7 +867,7 @@ type CommonPatchFields = 'revision' | 'disabled' | 'selected' | 'separator' | 'h
 export type RowPatch = Readonly<{
     type: 'identity';
     key: string;
-    changes: Partial<Pick<IdentityRow, CommonPatchFields | 'title' | 'subtitle' | 'tertiary' | 'tertiaryTone' | 'badges' | 'trailing' | 'leading' | 'leadingAction' | 'titleMatch' | 'titleActionKey' | 'titleActionOnHover' | 'subtitleSegments'>>;
+    changes: Partial<Pick<IdentityRow, CommonPatchFields | 'title' | 'titleSuffixes' | 'titleIcon' | 'secondaryTitleIcon' | 'subtitle' | 'subtitleLines' | 'contentHeight' | 'longPressActionKey' | 'tertiary' | 'tertiaryTone' | 'badges' | 'trailing' | 'leading' | 'leadingAction' | 'titleMatch' | 'titleActionKey' | 'titleActionOnHover' | 'subtitleSegments'>>;
 }> | Readonly<{
     type: 'rail';
     key: string;
@@ -783,15 +875,15 @@ export type RowPatch = Readonly<{
 }> | Readonly<{
     type: 'activity';
     key: string;
-    changes: Partial<Pick<ActivityRow, CommonPatchFields | 'title' | 'description' | 'status' | 'amounts' | 'badges' | 'presentation' | 'fee' | 'descriptionActionKey' | 'primaryAmount' | 'secondaryAmount' | 'leading' | 'secondaryLeading' | 'footerActions'>>;
+    changes: Partial<Pick<ActivityRow, CommonPatchFields | 'title' | 'description' | 'status' | 'amounts' | 'badges' | 'presentation' | 'fee' | 'descriptionActionKey' | 'primaryAmount' | 'secondaryAmount' | 'leading' | 'hideLeading' | 'secondaryLeading' | 'footerActions'>>;
 }> | Readonly<{
     type: 'message';
     key: string;
-    changes: Partial<Pick<MessageRow, CommonPatchFields | 'unread' | 'title' | 'body' | 'bodyLines' | 'time' | 'thumbnail'>>;
+    changes: Partial<Pick<MessageRow, CommonPatchFields | 'unread' | 'title' | 'body' | 'bodyLines' | 'presentation' | 'time' | 'thumbnail'>>;
 }> | Readonly<{
     type: 'dataRow';
     key: string;
-    changes: Partial<Pick<DataRow, CommonPatchFields | 'leading' | 'columns' | 'checkbox' | 'index' | 'badge' | 'badges' | 'favorite' | 'favoriteActive'>>;
+    changes: Partial<Pick<DataRow, CommonPatchFields | 'leading' | 'columns' | 'trailing' | 'checkbox' | 'index' | 'badge' | 'badges' | 'favorite' | 'favoriteActive'>>;
 }> | Readonly<{
     type: 'market';
     key: string;
@@ -807,11 +899,15 @@ export type RowPatch = Readonly<{
 }> | Readonly<{
     type: 'sectionHeader';
     key: string;
-    changes: Partial<Pick<SectionHeaderRow, CommonPatchFields | 'variant' | 'titleLoading' | 'title' | 'subtitle' | 'value' | 'valueActionKey' | 'titleActionKey' | 'titleActionOnHover' | 'titleIcon' | 'valueIcon' | 'checkbox'>>;
+    changes: Partial<Pick<SectionHeaderRow, CommonPatchFields | 'variant' | 'titleLoading' | 'title' | 'subtitle' | 'value' | 'valueHelp' | 'leadingBadge' | 'valueActionKey' | 'titleActionKey' | 'titleActionOnHover' | 'titleIcon' | 'valueIcon' | 'checkbox'>>;
 }> | Readonly<{
     type: 'action';
     key: string;
     changes: Partial<Pick<ActionRow, CommonPatchFields | 'title' | 'tone' | 'icon' | 'checkbox' | 'trailing'>>;
+}> | Readonly<{
+    type: 'buttonGroup';
+    key: string;
+    changes: Partial<Pick<ButtonGroupRow, CommonPatchFields | 'buttons'>>;
 }> | Readonly<{
     type: 'system';
     key: string;
@@ -821,7 +917,7 @@ export type RowPatch = Readonly<{
         message?: string;
     }>;
 }>;
-export type NativeListActionSource = 'row' | 'marketBadge' | 'leadingAction' | 'trailingAccessory' | 'footerAction' | 'description' | 'mediaClose';
+export type NativeListActionSource = 'row' | 'marketBadge' | 'leadingAction' | 'trailingAccessory' | 'footerAction' | 'buttonGroup' | 'description' | 'mediaClose';
 export type NativeListWindowRect = Readonly<{
     x: number;
     y: number;