virtua 0.4.4 → 0.4.5

package/lib/react/VList.d.ts

@@ -2,12 +2,17 @@ import { ReactNode } from "react";
 import { WindowComponentAttributes } from "..";
 import { CustomWindowComponent } from "./Window";
 import { CustomItemComponent } from "./ListItem";
+import { CacheSnapshot } from "../core/types";
 export type ScrollMode = "reverse" | "rtl";
 type CustomItemComponentOrElement = keyof JSX.IntrinsicElements | CustomItemComponent;
 /**
  * Methods of {@link VList}.
  */
 export interface VListHandle {
+    /**
+     * Get current {@link CacheSnapshot}.
+     */
+    readonly cache: CacheSnapshot;
     /**
      * Get current scrollTop or scrollLeft.
      */
@@ -71,6 +76,10 @@ export interface VListProps extends WindowComponentAttributes {
      * - `rtl`: You have to set this mode if you use this component under `direction: rtl` style.
      */
     mode?: ScrollMode;
+    /**
+     * You can restore cache by passing a {@link CacheSnapshot} on mount. This is useful when you want to restore scroll position after navigation. The snapshot can be obtained from {@link VListHandle.cache}.
+     */
+    cache?: CacheSnapshot;
     /**
      * Customized element type for scrollable element. This element will get {@link CustomWindowComponentProps} as props.
      * @defaultValue {@link Window}

package/lib/react/WVList.d.ts

@@ -1,8 +1,17 @@
-import { ReactElement, ReactNode } from "react";
-import { WindowComponentAttributes } from "..";
+import { ReactNode } from "react";
+import { CacheSnapshot, WindowComponentAttributes } from "..";
 import { CustomWindowComponent } from "./Window";
 import { CustomItemComponent } from "./ListItem";
 type CustomItemComponentOrElement = keyof JSX.IntrinsicElements | CustomItemComponent;
+/**
+ * Methods of {@link WVList}.
+ */
+export interface WVListHandle {
+    /**
+     * Get current {@link CacheSnapshot}.
+     */
+    readonly cache: CacheSnapshot;
+}
 /**
  * Props of {@link WVList}.
  */
@@ -31,6 +40,10 @@ export interface WVListProps extends WindowComponentAttributes {
      * If true, rendered as a horizontally scrollable list. Otherwise rendered as a vertically scrollable list.
      */
     horizontal?: boolean;
+    /**
+     * You can restore cache by passing a {@link CacheSnapshot} on mount. This is useful when you want to restore scroll position after navigation. The snapshot can be obtained from {@link WVListHandle.cache}.
+     */
+    cache?: CacheSnapshot;
     /**
      * Customized element type for scrollable element. This element will get {@link CustomWindowComponentProps} as props.
      * @defaultValue {@link Window}
@@ -66,5 +79,5 @@ export interface WVListProps extends WindowComponentAttributes {
 /**
  * Virtualized list component controlled by the window scrolling. See {@link WVListProps}.
  */
-export declare const WVList: ({ children, overscan, initialItemSize, initialItemCount, horizontal: horizontalProp, element: Window, itemElement, onScrollStop: onScrollStopProp, onRangeChange: onRangeChangeProp, ...windowAttrs }: WVListProps) => ReactElement;
+export declare const WVList: import("react").ForwardRefExoticComponent<WVListProps & import("react").RefAttributes<WVListHandle>>;
 export {};

package/lib/react/utils.d.ts

@@ -1,3 +1,6 @@
 import { ReactElement, ReactFragment, ReactNode } from "react";
 export declare const refKey = "current";
 export declare const flattenChildren: (children: ReactNode) => (string | number | ReactElement<any, string | import("react").JSXElementConstructor<any>> | ReactFragment)[];
+export type MayHaveKey = {
+    key?: React.Key;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "virtua",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "A zero-config, fast and small (~3kB) virtual list and grid component for React.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",
@@ -23,7 +23,7 @@
     "prepublishOnly": "npm run typedoc && rimraf lib && npm run build"
   },
   "devDependencies": {
-    "@babel/plugin-transform-react-pure-annotations": "7.18.6",
+    "@babel/plugin-transform-react-pure-annotations": "7.22.5",
     "@dnd-kit/core": "6.0.8",
     "@dnd-kit/sortable": "7.0.2",
     "@emotion/react": "11.10.8",
@@ -41,7 +41,7 @@
     "@storybook/test-runner": "0.11.0",
     "@tanstack/react-virtual": "3.0.0-alpha.0",
     "@testing-library/react": "14.0.0",
-    "@types/react": "18.2.14",
+    "@types/react": "18.2.15",
     "@types/react-virtualized": "9.21.22",
     "@types/react-window": "1.8.5",
     "@typescript-eslint/parser": "6.1.0",
@@ -62,17 +62,17 @@
     "react-virtualized": "9.22.5",
     "react-virtuoso": "4.4.1",
     "react-window": "1.8.9",
-    "rimraf": "5.0.0",
-    "rollup": "3.23.0",
+    "rimraf": "5.0.1",
+    "rollup": "3.26.3",
     "rollup-plugin-banner2": "1.2.2",
     "size-limit": "^8.2.6",
     "storybook": "^7.1.0",
-    "ts-jest": "29.1.0",
+    "ts-jest": "29.1.1",
     "typedoc": "0.24.7",
     "typedoc-plugin-markdown": "3.15.3",
     "typescript": "5.1.6",
-    "virtua": "^0.4.3",
-    "vite": "4.4.4",
+    "virtua": "^0.4.4",
+    "vite": "4.4.6",
     "wait-on": "7.0.1"
   },
   "peerDependencies": {
@@ -92,6 +92,7 @@
     "grid",
     "table",
     "flex",
+    "scroller",
     "scrolling",
     "virtual",
     "virtualized",