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

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

@@ -3,8 +3,20 @@ import type { NativeListSnapshot, RowPatch } from './models';
 export declare function containNativeListInput<T>(operation: () => T): T | undefined;
 export declare function emptyNativeListSnapshot(): NativeListSnapshot;
 export declare function validateSnapshot(snapshot: NativeListSnapshot): NativeListSnapshot;
+/** Capture caller data once before validation, including accessor values. */
+export declare function captureNativeListInput<T>(value: T): T;
+/** Private native-wrapper ownership; exported validators keep their public identity. */
+export declare function ownValidatedNativeSnapshot(snapshot: NativeListSnapshot): NativeListSnapshot;
 export declare function validatePatches(patches: readonly RowPatch[]): readonly RowPatch[];
+/** Plan value-only patches; callers own valid immutable snapshots and commit state. */
+export declare function planNativeListPatches(previous: NativeListSnapshot, next: NativeListSnapshot): readonly RowPatch[] | undefined;
 export declare function applyRowPatches(snapshot: NativeListSnapshot, patches: readonly RowPatch[]): NativeListSnapshot;
+/** Native wrapper only: preserve full public validation for unsupported patches. */
+export declare function applyOwnedNativePatches(snapshot: NativeListSnapshot, patches: readonly RowPatch[]): {
+    patches: readonly RowPatch[];
+    snapshot: NativeListSnapshot;
+    json: string;
+};
 export declare function serializeSnapshot(snapshot: NativeListSnapshot): string;
 export declare function serializePatches(patches: readonly RowPatch[]): string;
 //# sourceMappingURL=validation.d.ts.map

package/lib/typescript/src/web/NativeListWebEngine.d.ts

@@ -145,6 +145,7 @@ export declare class NativeListWebEngine {
     private pullDistance;
     private virtualizationEnabled;
     private actionAnchor;
+    private pressedHelpElement;
     private readonly actionAnchorInstanceId;
     private actionAnchorCounter;
     private bindingEpochCounter;
@@ -153,6 +154,26 @@ export declare class NativeListWebEngine {
     private lastViewportWidth;
     private lastViewportHeight;
     private destroyed;
+    private hasAppliedSnapshot;
+    private lastStructuralTransitionId;
+    private structuralFrame;
+    private structuralFinish;
+    private structuralRevision;
+    private structuralAnimations;
+    private structuralScrollInterrupted;
+    private structuralRenderedHeight;
+    private structuralTargetHeight;
+    private reactFooterHeight;
+    private structuralFooterCompensation;
+    private structuralFooterExpansion;
+    private structuralFooterFromHeight;
+    private structuralFooterElement;
+    private structuralFooterStyles;
+    private structuralProgress;
+    private structuralAnchorStyles;
+    private structuralContentOverflow;
+    private structuralPrefixTransition;
+    private structuralTail;
     private sectionIndexAlignStart;
     private measuredRendererHeights;
     private notifyScrollCommandAccepted;
@@ -168,6 +189,15 @@ export declare class NativeListWebEngine {
     updateCallbacks(callbacks: NativeListWebCallbacks): void;
     setVirtualizationEnabled(enabled: boolean): void;
     applySnapshot(snapshot: NativeListSnapshot): void;
+    private applyValidatedSnapshot;
+    private cancelStructuralAnimation;
+    private handleStructuralUserScroll;
+    private updateStructuralTailWindow;
+    private writeStructuralHeight;
+    private reactFooterElement;
+    private readReactFooterHeight;
+    private applyStructuralFooterVisual;
+    private applyStructuralSnapshot;
     currentContentHeight(): number;
     currentSnapshot(): NativeListSnapshot;
     applyPatches(patches: readonly RowPatch[]): void;
@@ -239,6 +269,8 @@ export declare class NativeListWebEngine {
     private handleMarketTouchMove;
     private handleMarketPointerEnd;
     private handleTitlePointerOver;
+    private emitHoverAction;
+    private handleIconHelpPointerDown;
     private handleTitlePointerOut;
     private handleClick;
     private handleKeyDown;

package/lib/typescript/src/web/templates/ButtonGroupRowRenderer.d.ts

@@ -0,0 +1,14 @@
+import type { ButtonGroupRow } from '../../models';
+import type { RowPrimitives } from './RowVisual';
+declare function bind(body: HTMLElement, row: ButtonGroupRow): void;
+declare function create(document: Document, row: ButtonGroupRow, _primitives: RowPrimitives): HTMLDivElement;
+export declare const buttonGroupRowRenderer: {
+    key: "buttonGroup";
+    create: typeof create;
+    bind: typeof bind;
+    recycle: (body: HTMLElement) => void;
+    measure: (_row: ButtonGroupRow, _width: number) => number;
+    measureRendered: (body: HTMLElement) => number;
+};
+export {};
+//# sourceMappingURL=ButtonGroupRowRenderer.d.ts.map

package/lib/typescript/src/web/templates/IdentityRowRenderer.d.ts

@@ -10,7 +10,7 @@ export declare const identityRowRenderer: {
     recycle: typeof recycle;
     appliesSizePreset: (row: IdentityRow) => boolean;
     measure: (row: IdentityRow, _width: number) => number;
-    measureRendered: (_body: HTMLElement, _row: IdentityRow) => number | undefined;
+    measureRendered: (body: HTMLElement, row: IdentityRow) => number | undefined;
 };
 export {};
 //# sourceMappingURL=IdentityRowRenderer.d.ts.map

package/lib/typescript/src/web/templates/MessageRowRenderer.d.ts

@@ -3,15 +3,21 @@ import type { MessageRow, NativeListTextStyle } from '../../models';
 export declare function resolveMessageRow(row: MessageRow): {
     title: Readonly<{
         value: string;
-        style: Required<Pick<NativeListTextStyle, "fontSize" | "lineHeight" | "lines">> & NativeListTextStyle;
+        style: Required<Pick<NativeListTextStyle, "fontSize" | "lineHeight">> & Omit<NativeListTextStyle, "lines"> & {
+            lines: 0 | 1 | 2 | 3;
+        };
     }>;
     body: Readonly<{
         value: string;
-        style: Required<Pick<NativeListTextStyle, "fontSize" | "lineHeight" | "lines">> & NativeListTextStyle;
+        style: Required<Pick<NativeListTextStyle, "fontSize" | "lineHeight">> & Omit<NativeListTextStyle, "lines"> & {
+            lines: 0 | 1 | 2 | 3;
+        };
     }>;
     time: Readonly<{
         value: string;
-        style: Required<Pick<NativeListTextStyle, "fontSize" | "lineHeight" | "lines">> & NativeListTextStyle;
+        style: Required<Pick<NativeListTextStyle, "fontSize" | "lineHeight">> & Omit<NativeListTextStyle, "lines"> & {
+            lines: 0 | 1 | 2 | 3;
+        };
     }>;
     horizontalPadding: number;
     verticalPadding: number;

package/nitrogen/generated/android/c++/JHybridNativeListSpec.cpp

@@ -88,6 +88,15 @@ namespace margelo::nitro::nativelist {
     static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* containerSlotHeightsJson */)>("setContainerSlotHeightsJson");
     method(_javaPart, jni::make_jstring(containerSlotHeightsJson));
   }
+  std::string JHybridNativeListSpec::getSidecarLayoutJson() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<jni::JString>()>("getSidecarLayoutJson");
+    auto __result = method(_javaPart);
+    return __result->toStdString();
+  }
+  void JHybridNativeListSpec::setSidecarLayoutJson(const std::string& sidecarLayoutJson) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<jni::JString> /* sidecarLayoutJson */)>("setSidecarLayoutJson");
+    method(_javaPart, jni::make_jstring(sidecarLayoutJson));
+  }
   NativeListScrollEdgeEffect JHybridNativeListSpec::getTopScrollEdgeEffect() {
     static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<JNativeListScrollEdgeEffect>()>("getTopScrollEdgeEffect");
     auto __result = method(_javaPart);
@@ -252,6 +261,23 @@ namespace margelo::nitro::nativelist {
     static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_std__string::javaobject> /* onVisibleRangeChanged */)>("setOnVisibleRangeChanged_cxx");
     method(_javaPart, onVisibleRangeChanged.has_value() ? JFunc_void_std__string_cxx::fromCpp(onVisibleRangeChanged.value()) : nullptr);
   }
+  std::optional<std::function<void(const std::string& /* payloadJson */)>> JHybridNativeListSpec::getOnStructuralTransitionSettled() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<JFunc_void_std__string::javaobject>()>("getOnStructuralTransitionSettled_cxx");
+    auto __result = method(_javaPart);
+    return __result != nullptr ? std::make_optional([&]() -> std::function<void(const std::string& /* payloadJson */)> {
+      if (__result->isInstanceOf(JFunc_void_std__string_cxx::javaClassStatic())) [[likely]] {
+        auto downcast = jni::static_ref_cast<JFunc_void_std__string_cxx::javaobject>(__result);
+        return downcast->cthis()->getFunction();
+      } else {
+        auto __resultRef = jni::make_global(__result);
+        return JNICallable<JFunc_void_std__string, void(std::string)>(std::move(__resultRef));
+      }
+    }()) : std::nullopt;
+  }
+  void JHybridNativeListSpec::setOnStructuralTransitionSettled(const std::optional<std::function<void(const std::string& /* payloadJson */)>>& onStructuralTransitionSettled) {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<void(jni::alias_ref<JFunc_void_std__string::javaobject> /* onStructuralTransitionSettled */)>("setOnStructuralTransitionSettled_cxx");
+    method(_javaPart, onStructuralTransitionSettled.has_value() ? JFunc_void_std__string_cxx::fromCpp(onStructuralTransitionSettled.value()) : nullptr);
+  }
 
   // Methods
   void JHybridNativeListSpec::applySnapshot(const std::string& snapshotJson) {

package/nitrogen/generated/android/c++/JHybridNativeListSpec.hpp

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

package/nitrogen/generated/android/c++/views/JHybridNativeListStateUpdater.cpp

@@ -68,6 +68,11 @@ void JHybridNativeListStateUpdater::updateViewProps(jni::alias_ref<jni::JClass>
         : !newProps->containerSlotHeightsJson.hasSameValue(oldProps->containerSlotHeightsJson)) {
     hybridView->setContainerSlotHeightsJson(newProps->containerSlotHeightsJson.get());
   }
+  if (oldProps == nullptr
+        ? newProps->sidecarLayoutJson.isProvided()
+        : !newProps->sidecarLayoutJson.hasSameValue(oldProps->sidecarLayoutJson)) {
+    hybridView->setSidecarLayoutJson(newProps->sidecarLayoutJson.get());
+  }
   if (oldProps == nullptr
         ? newProps->topScrollEdgeEffect.isProvided()
         : !newProps->topScrollEdgeEffect.hasSameValue(oldProps->topScrollEdgeEffect)) {
@@ -128,6 +133,11 @@ void JHybridNativeListStateUpdater::updateViewProps(jni::alias_ref<jni::JClass>
         : !newProps->onVisibleRangeChanged.hasSameValue(oldProps->onVisibleRangeChanged)) {
     hybridView->setOnVisibleRangeChanged(newProps->onVisibleRangeChanged.get());
   }
+  if (oldProps == nullptr
+        ? newProps->onStructuralTransitionSettled.isProvided()
+        : !newProps->onStructuralTransitionSettled.hasSameValue(oldProps->onStructuralTransitionSettled)) {
+    hybridView->setOnStructuralTransitionSettled(newProps->onStructuralTransitionSettled.get());
+  }
 
   // Update hybridRef if it changed
   if (oldProps == nullptr

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nativelist/HybridNativeListSpec.kt

@@ -45,6 +45,12 @@ abstract class HybridNativeListSpec: HybridView() {
   @set:Keep
   abstract var containerSlotHeightsJson: String
   
+  @get:DoNotStrip
+  @get:Keep
+  @set:DoNotStrip
+  @set:Keep
+  abstract var sidecarLayoutJson: String
+  
   @get:DoNotStrip
   @get:Keep
   @set:DoNotStrip
@@ -172,6 +178,20 @@ abstract class HybridNativeListSpec: HybridView() {
     set(value) {
       onVisibleRangeChanged = value?.let { it }
     }
+  
+  abstract var onStructuralTransitionSettled: ((payloadJson: String) -> Unit)?
+  
+  private var onStructuralTransitionSettled_cxx: Func_void_std__string?
+    @Keep
+    @DoNotStrip
+    get() {
+      return onStructuralTransitionSettled?.let { Func_void_std__string_java(it) }
+    }
+    @Keep
+    @DoNotStrip
+    set(value) {
+      onStructuralTransitionSettled = value?.let { it }
+    }
 
   // Methods
   @DoNotStrip

package/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/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/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/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/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/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/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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-native-list",
-  "version": "6.7.0-alpha.375",
+  "version": "6.7.0-alpha.382",
   "description": "Template-driven native RecyclerView and UICollectionView for React Native",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",
@@ -86,8 +86,8 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "@onekeyfe/react-native-image": "6.7.0-alpha.375",
-    "@onekeyfe/react-native-native-logger": "6.7.0-alpha.375",
+    "@onekeyfe/react-native-image": "6.7.0-alpha.382",
+    "@onekeyfe/react-native-native-logger": "6.7.0-alpha.382",
     "react": "*",
     "react-native": "*",
     "react-native-nitro-modules": "0.37.0"

package/react-native-native-list.podspec

@@ -33,6 +33,7 @@ Pod::Spec.new do |s|
   s.dependency "React-callinvoker"
 
   s.test_spec "Tests" do |test_spec|
+    test_spec.requires_app_host = true
     test_spec.source_files = "ios/tests/**/*.swift"
     test_spec.pod_target_xcconfig = {
       "PRODUCT_MODULE_NAME" => "NativeListModuleTests",

package/src/NativeList.nitro.ts

@@ -13,6 +13,7 @@ export interface NativeListNativeProps extends HybridViewProps {
   snapshotJson: string;
   fontFamiliesJson: string;
   containerSlotHeightsJson: string;
+  sidecarLayoutJson: string;
   topScrollEdgeEffect: NativeListScrollEdgeEffect;
   topOverlayHeight: number;
   scrollPositionThresholdsJson: string;
@@ -25,6 +26,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';