@react-native-ohos/flash-list 1.8.3 → 2.1.1-rc.1

package/src/native/config/PlatformHelper.harmony.ts

@@ -22,31 +22,10 @@
  * SOFTWARE.
  */
 
-import { BaseItemAnimator } from "recyclerlistview";
-
 const PlatformConfig = {
   defaultDrawDistance: 250,
-  invertedTransformStyle: { transform: [{ scaleY: -1 }] },
-  invertedTransformStyleHorizontal: { transform: [{ scaleX: -1 }] },
-};
-const getCellContainerPlatformStyles = (
-  inverted: boolean,
-  parentProps: { x: number; y: number; isHorizontal?: boolean }
-): { transform: string; WebkitTransform: string } | undefined => {
-  return undefined;
-};
-
-const getItemAnimator = (): BaseItemAnimator | undefined => {
-  return undefined;
+  supportsOffsetCorrection: true,
+  trackAverageRenderTimeForOffsetProjection: false,
 };
 
-const getFooterContainer = (): React.ComponentClass | undefined => {
-  return undefined;
-};
-
-export {
-  PlatformConfig,
-  getCellContainerPlatformStyles,
-  getItemAnimator,
-  getFooterContainer,
-};
+export { PlatformConfig };

package/src/native/config/PlatformHelper.ios.ts

@@ -1,52 +1,7 @@
-/**
- * MIT License
- *
- * Copyright (C) 2024 Huawei Device Co., Ltd.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { BaseItemAnimator } from "recyclerlistview";
-
 const PlatformConfig = {
   defaultDrawDistance: 250,
-  invertedTransformStyle: { transform: [{ scaleY: -1 }] },
-  invertedTransformStyleHorizontal: { transform: [{ scaleX: -1 }] },
-};
-const getCellContainerPlatformStyles = (
-  inverted: boolean,
-  parentProps: { x: number; y: number; isHorizontal?: boolean }
-): { transform: string; WebkitTransform: string } | undefined => {
-  return undefined;
-};
-
-const getItemAnimator = (): BaseItemAnimator | undefined => {
-  return undefined;
-};
-
-const getFooterContainer = (): React.ComponentClass | undefined => {
-  return undefined;
+  supportsOffsetCorrection: true,
+  trackAverageRenderTimeForOffsetProjection: false,
 };
 
-export {
-  PlatformConfig,
-  getCellContainerPlatformStyles,
-  getItemAnimator,
-  getFooterContainer,
-};
+export { PlatformConfig };

package/src/native/config/PlatformHelper.ts

@@ -1,53 +1,7 @@
-/**
- * MIT License
- *
- * Copyright (C) 2024 Huawei Device Co., Ltd.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import { BaseItemAnimator } from "recyclerlistview";
-import { DefaultJSItemAnimator } from "recyclerlistview/dist/reactnative/platform/reactnative/itemanimators/defaultjsanimator/DefaultJSItemAnimator";
-
 const PlatformConfig = {
   defaultDrawDistance: 250,
-  invertedTransformStyle: { transform: [{ scaleY: -1 }] },
-  invertedTransformStyleHorizontal: { transform: [{ scaleX: -1 }] },
-};
-const getCellContainerPlatformStyles = (
-  inverted: boolean,
-  parentProps: { x: number; y: number; isHorizontal?: boolean }
-): { transform: string; WebkitTransform: string } | undefined => {
-  return undefined;
-};
-
-const getItemAnimator = (): BaseItemAnimator | undefined => {
-  return new DefaultJSItemAnimator();
-};
-
-const getFooterContainer = (): React.ComponentClass | undefined => {
-  return undefined;
+  supportsOffsetCorrection: false,
+  trackAverageRenderTimeForOffsetProjection: false,
 };
 
-export {
-  PlatformConfig,
-  getCellContainerPlatformStyles,
-  getItemAnimator,
-  getFooterContainer,
-};
+export { PlatformConfig };

package/src/native/config/PlatformHelper.web.ts

@@ -1,58 +1,7 @@
-/**
- * MIT License
- *
- * Copyright (C) 2024 Huawei Device Co., Ltd.
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
-import React from "react";
-import { View } from "react-native";
-import { BaseItemAnimator } from "recyclerlistview";
-import { DefaultJSItemAnimator } from "recyclerlistview/dist/reactnative/platform/reactnative/itemanimators/defaultjsanimator/DefaultJSItemAnimator";
-
 const PlatformConfig = {
-  defaultDrawDistance: 2000,
-  invertedTransformStyle: { transform: [{ scaleY: -1 }] },
-  invertedTransformStyleHorizontal: { transform: [{ scaleX: -1 }] },
-};
-const getCellContainerPlatformStyles = (
-  inverted: boolean,
-  parentProps: { x: number; y: number; isHorizontal?: boolean }
-): { transform: string; WebkitTransform: string } | undefined => {
-  const transformValue = `translate(${parentProps.x}px,${parentProps.y}px)${
-    inverted ? ` ${parentProps.isHorizontal ? `scaleX` : `scaleY`}(-1)` : ``
-  }`;
-  return { transform: transformValue, WebkitTransform: transformValue };
-};
-
-const getItemAnimator = (): BaseItemAnimator | undefined => {
-  return new DefaultJSItemAnimator();
-};
-
-const getFooterContainer = (): React.ComponentClass | undefined => {
-  return View;
+  defaultDrawDistance: 500,
+  supportsOffsetCorrection: false,
+  trackAverageRenderTimeForOffsetProjection: false,
 };
 
-export {
-  PlatformConfig,
-  getCellContainerPlatformStyles,
-  getItemAnimator,
-  getFooterContainer,
-};
+export { PlatformConfig };

package/src/recyclerview/LayoutCommitObserver.tsx

@@ -0,0 +1,74 @@
+import React, { useLayoutEffect, useMemo, useRef } from "react";
+
+import {
+  RecyclerViewContext,
+  RecyclerViewContextProvider,
+  useRecyclerViewContext,
+} from "./RecyclerViewContextProvider";
+import { useLayoutState } from "./hooks/useLayoutState";
+
+export interface LayoutCommitObserverProps {
+  children: React.ReactNode;
+  onCommitLayoutEffect?: () => void;
+}
+
+/**
+ * LayoutCommitObserver can be used to observe when FlashList commits a layout.
+ * It is useful when your component has one or more FlashLists somewhere down the tree.
+ * LayoutCommitObserver will trigger `onCommitLayoutEffect` when all of the FlashLists in the tree have finished their first commit.
+ */
+export const LayoutCommitObserver = React.memo(
+  (props: LayoutCommitObserverProps) => {
+    const { children, onCommitLayoutEffect } = props;
+    const parentRecyclerViewContext = useRecyclerViewContext();
+    const [_, setRenderId] = useLayoutState(0);
+    const pendingChildIds = useRef<Set<string>>(new Set()).current;
+
+    useLayoutEffect(() => {
+      if (pendingChildIds.size > 0) {
+        return;
+      }
+      onCommitLayoutEffect?.();
+    });
+
+    // Create context for child components
+    const recyclerViewContext: RecyclerViewContext<unknown> = useMemo(() => {
+      return {
+        layout: () => {
+          setRenderId((prev) => prev + 1);
+        },
+        getRef: () => {
+          return parentRecyclerViewContext?.getRef() ?? null;
+        },
+        getParentRef: () => {
+          return parentRecyclerViewContext?.getParentRef() ?? null;
+        },
+        getParentScrollViewRef: () => {
+          return parentRecyclerViewContext?.getParentScrollViewRef() ?? null;
+        },
+        getScrollViewRef: () => {
+          return parentRecyclerViewContext?.getScrollViewRef() ?? null;
+        },
+        markChildLayoutAsPending: (id: string) => {
+          parentRecyclerViewContext?.markChildLayoutAsPending(id);
+          pendingChildIds.add(id);
+        },
+        unmarkChildLayoutAsPending: (id: string) => {
+          parentRecyclerViewContext?.unmarkChildLayoutAsPending(id);
+          if (pendingChildIds.has(id)) {
+            pendingChildIds.delete(id);
+            recyclerViewContext.layout();
+          }
+        },
+      };
+    }, [parentRecyclerViewContext, pendingChildIds, setRenderId]);
+
+    return (
+      <RecyclerViewContextProvider value={recyclerViewContext}>
+        {children}
+      </RecyclerViewContextProvider>
+    );
+  }
+);
+
+LayoutCommitObserver.displayName = "LayoutCommitObserver";