@react-stately/virtualizer 3.0.0-nightly-641446f65-240905

package/dist/utils.main.js

@@ -0,0 +1,27 @@
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "isSetEqual", () => $abed55ea619a7a17$export$a8d0d0c8d1c5df64);
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ /** Returns whether two sets are equal. */ function $abed55ea619a7a17$export$a8d0d0c8d1c5df64(a, b) {
+    if (a === b) return true;
+    if (a.size !== b.size) return false;
+    for (let key of a){
+        if (!b.has(key)) return false;
+    }
+    return true;
+}
+
+
+//# sourceMappingURL=utils.main.js.map

package/dist/utils.main.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;AAAA;;;;;;;;;;CAUC,GAED,wCAAwC,GACjC,SAAS,0CAAc,CAAS,EAAE,CAAS;IAChD,IAAI,MAAM,GACR,OAAO;IAGT,IAAI,EAAE,IAAI,KAAK,EAAE,IAAI,EACnB,OAAO;IAGT,KAAK,IAAI,OAAO,EAAG;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC,MACT,OAAO;IAEX;IAEA,OAAO;AACT","sources":["packages/@react-stately/virtualizer/src/utils.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/** Returns whether two sets are equal. */\nexport function isSetEqual<T>(a: Set<T>, b: Set<T>): boolean {\n  if (a === b) {\n    return true;\n  }\n\n  if (a.size !== b.size) {\n    return false;\n  }\n\n  for (let key of a) {\n    if (!b.has(key)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"],"names":[],"version":3,"file":"utils.main.js.map"}

package/dist/utils.mjs

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ /** Returns whether two sets are equal. */ function $fc36f9a046a9ce79$export$a8d0d0c8d1c5df64(a, b) {
+    if (a === b) return true;
+    if (a.size !== b.size) return false;
+    for (let key of a){
+        if (!b.has(key)) return false;
+    }
+    return true;
+}
+
+
+export {$fc36f9a046a9ce79$export$a8d0d0c8d1c5df64 as isSetEqual};
+//# sourceMappingURL=utils.module.js.map

package/dist/utils.module.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ /** Returns whether two sets are equal. */ function $fc36f9a046a9ce79$export$a8d0d0c8d1c5df64(a, b) {
+    if (a === b) return true;
+    if (a.size !== b.size) return false;
+    for (let key of a){
+        if (!b.has(key)) return false;
+    }
+    return true;
+}
+
+
+export {$fc36f9a046a9ce79$export$a8d0d0c8d1c5df64 as isSetEqual};
+//# sourceMappingURL=utils.module.js.map

package/dist/utils.module.js.map

@@ -0,0 +1 @@
+{"mappings":"AAAA;;;;;;;;;;CAUC,GAED,wCAAwC,GACjC,SAAS,0CAAc,CAAS,EAAE,CAAS;IAChD,IAAI,MAAM,GACR,OAAO;IAGT,IAAI,EAAE,IAAI,KAAK,EAAE,IAAI,EACnB,OAAO;IAGT,KAAK,IAAI,OAAO,EAAG;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC,MACT,OAAO;IAEX;IAEA,OAAO;AACT","sources":["packages/@react-stately/virtualizer/src/utils.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/** Returns whether two sets are equal. */\nexport function isSetEqual<T>(a: Set<T>, b: Set<T>): boolean {\n  if (a === b) {\n    return true;\n  }\n\n  if (a.size !== b.size) {\n    return false;\n  }\n\n  for (let key of a) {\n    if (!b.has(key)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"],"names":[],"version":3,"file":"utils.module.js.map"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@react-stately/virtualizer",
+  "version": "3.0.0-nightly-641446f65-240905",
+  "description": "Spectrum UI components in React",
+  "license": "Apache-2.0",
+  "main": "dist/main.js",
+  "module": "dist/module.js",
+  "exports": {
+    "types": "./dist/types.d.ts",
+    "import": "./dist/import.mjs",
+    "require": "./dist/main.js"
+  },
+  "types": "dist/types.d.ts",
+  "source": "src/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adobe/react-spectrum"
+  },
+  "dependencies": {
+    "@react-aria/utils": "^3.0.0-nightly-641446f65-240905",
+    "@react-types/shared": "^3.0.0-nightly-641446f65-240905",
+    "@swc/helpers": "^0.5.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "stableVersion": "4.0.2"
+}

package/src/Layout.ts

@@ -0,0 +1,93 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {InvalidationContext} from './types';
+import {ItemDropTarget, Key, LayoutDelegate} from '@react-types/shared';
+import {LayoutInfo} from './LayoutInfo';
+import {Rect} from './Rect';
+import {Size} from './Size';
+import {Virtualizer} from './Virtualizer';
+
+/**
+ * [Virtualizer]{@link Virtualizer} supports arbitrary layout objects, which compute what views are visible, and how
+ * to position and style them. However, layouts do not create the views themselves directly. Instead,
+ * layouts produce lightweight {@link LayoutInfo} objects which describe various properties of a view,
+ * such as its position and size. The {@link Virtualizer} is then responsible for creating the actual
+ * views as needed, based on this layout information.
+ *
+ * Every layout extends from the {@link Layout} abstract base class. Layouts must implement a minimum of the
+ * two methods listed below. All other methods can be optionally overridden to implement custom behavior.
+ *
+ * @see {@link getVisibleLayoutInfos}
+ * @see {@link getLayoutInfo}
+ */
+export abstract class Layout<T extends object, O = any> implements LayoutDelegate {
+  /** The Virtualizer the layout is currently attached to. */
+  virtualizer: Virtualizer<T, any>;
+
+  /**
+   * Returns whether the layout should invalidate in response to
+   * visible rectangle changes. By default, it only invalidates
+   * when the virtualizer's size changes. Return true always
+   * to make the layout invalidate while scrolling (e.g. sticky headers).
+   */
+  shouldInvalidate(newRect: Rect, oldRect: Rect): boolean {
+    // By default, invalidate when the size changes
+    return newRect.width !== oldRect.width
+        || newRect.height !== oldRect.height;
+  }
+
+  /**
+   * This method allows the layout to perform any pre-computation
+   * it needs to in order to prepare {@link LayoutInfo}s for retrieval.
+   * Called by the virtualizer before {@link getVisibleLayoutInfos}
+   * or {@link getLayoutInfo} are called.
+   */
+  update(invalidationContext: InvalidationContext<O>) {} // eslint-disable-line @typescript-eslint/no-unused-vars
+
+  /**
+   * Returns an array of {@link LayoutInfo} objects which are inside the given rectangle.
+   * Should be implemented by subclasses.
+   * @param rect The rectangle that should contain the returned LayoutInfo objects.
+   */
+  abstract getVisibleLayoutInfos(rect: Rect): LayoutInfo[];
+
+  /**
+   * Returns a {@link LayoutInfo} for the given key.
+   * Should be implemented by subclasses.
+   * @param key The key of the LayoutInfo to retrieve.
+   */
+  abstract getLayoutInfo(key: Key): LayoutInfo | null;
+
+  /**
+   * Returns size of the content. By default, it returns collectionView's size.
+   */
+  abstract getContentSize(): Size;
+
+  /** 
+   * Updates the size of the given item.
+   */
+  updateItemSize?(key: Key, size: Size): boolean;
+
+  /**
+   * Returns a LayoutInfo for the given drop target.
+   */
+  getDropTargetLayoutInfo?(target: ItemDropTarget): LayoutInfo;
+
+  getItemRect(key: Key): Rect {
+    return this.getLayoutInfo(key)?.rect;
+  }
+
+  getVisibleRect(): Rect {
+    return this.virtualizer.visibleRect;
+  }
+}

package/src/LayoutInfo.ts

@@ -0,0 +1,108 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {Key} from '@react-types/shared';
+import {Rect} from './Rect';
+
+/**
+ * Instances of this lightweight class are created by {@link Layout} subclasses
+ * to represent each view in the {@link Virtualizer}. LayoutInfo objects describe
+ * various properties of a view, such as its position and size, and style information.
+ * The virtualizer uses this information when creating actual views to display.
+ */
+export class LayoutInfo {
+  /**
+   * A string representing the view type. Should be `'item'` for item views.
+   * Other types are used by supplementary views.
+   */
+  type: string;
+
+  /**
+   * A unique key for this view. For item views, it should match the content key.
+   */
+  key: Key;
+
+  /**
+   * The key for a parent layout info, if any.
+   */
+  parentKey: Key | null;
+
+  /**
+   * The rectangle describing the size and position of this view.
+   */
+  rect: Rect;
+
+  /**
+   * Whether the size is estimated. `false` by default.
+   */
+  estimatedSize: boolean;
+
+  /**
+   * Whether the layout info sticks to the viewport when scrolling.
+   */
+  isSticky: boolean;
+
+  /**
+   * The view's opacity. 1 by default.
+   */
+  opacity: number;
+
+  /**
+   * A CSS transform string to apply to the view. `null` by default.
+   */
+  transform: string | null;
+
+  /**
+   * The z-index of the view. 0 by default.
+   */
+  zIndex: number;
+
+  /**
+   * Whether the layout info allows its contents to overflow its container.
+   * @default false
+   */
+  allowOverflow: boolean;
+
+  /**
+   * @param type A string representing the view type. Should be `'item'` for item views.
+                            Other types are used by supplementary views.
+   * @param key The unique key for this view.
+   * @param rect The rectangle describing the size and position of this view.
+   */
+  constructor(type: string, key: Key, rect: Rect) {
+    this.type = type;
+    this.key = key;
+    this.parentKey = null;
+    this.rect = rect;
+    this.estimatedSize = false;
+    this.isSticky = false;
+    this.opacity = 1;
+    this.transform = null;
+    this.zIndex = 0;
+    this.allowOverflow = false;
+  }
+
+  /**
+   * Returns a copy of the LayoutInfo.
+   */
+  copy(): LayoutInfo {
+    let res = new LayoutInfo(this.type, this.key, this.rect.copy());
+    res.estimatedSize = this.estimatedSize;
+    res.opacity = this.opacity;
+    res.transform = this.transform;
+    res.parentKey = this.parentKey;
+    res.isSticky = this.isSticky;
+    res.zIndex = this.zIndex;
+    res.allowOverflow = this.allowOverflow;
+    return res;
+  }
+}

package/src/OverscanManager.ts

@@ -0,0 +1,56 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {Point} from './Point';
+import {Rect} from './Rect';
+
+export class OverscanManager {
+  private startTime = 0;
+  private velocity = new Point(0, 0);
+  private visibleRect = new Rect();
+
+  setVisibleRect(rect: Rect) {
+    let time = performance.now() - this.startTime;
+    if (time < 500) {
+      if (rect.x !== this.visibleRect.x && time > 0) {
+        this.velocity.x = (rect.x - this.visibleRect.x) / time;
+      }
+
+      if (rect.y !== this.visibleRect.y && time > 0) {
+        this.velocity.y = (rect.y - this.visibleRect.y) / time;
+      }
+    }
+
+    this.startTime = performance.now();
+    this.visibleRect = rect;
+  }
+
+  getOverscannedRect() {
+    let overscanned = this.visibleRect.copy();
+
+    let overscanY = this.visibleRect.height / 3;
+    overscanned.height += overscanY;
+    if (this.velocity.y < 0) {
+      overscanned.y -= overscanY;
+    }
+
+    if (this.velocity.x !== 0) {
+      let overscanX = this.visibleRect.width / 3;
+      overscanned.width += overscanX;
+      if (this.velocity.x < 0) {
+        overscanned.x -= overscanX;
+      }
+    }
+
+    return overscanned;
+  }
+}

package/src/Point.ts

@@ -0,0 +1,45 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+export class Point {
+  /** The x-coordinate of the point. */
+  x: number;
+
+  /** The y-coordinate of the point. */
+  y: number;
+
+  constructor(x = 0, y = 0) {
+    this.x = x;
+    this.y = y;
+  }
+
+  /**
+   * Returns a copy of this point.
+   */
+  copy(): Point {
+    return new Point(this.x, this.y);
+  }
+
+  /**
+   * Checks if two points are equal.
+   */
+  equals(point: Point): boolean {
+    return this.x === point.x && this.y === point.y;
+  }
+
+  /**
+   * Returns true if this point is the origin.
+   */
+  isOrigin(): boolean {
+    return this.x === 0 && this.y === 0;
+  }
+}

package/src/Rect.ts

@@ -0,0 +1,191 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {Point} from './Point';
+import {Size} from './Size';
+
+export type RectCorner = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+
+/**
+ * Represents a rectangle.
+ */
+export class Rect {
+  /** The x-coordinate of the rectangle. */
+  x: number;
+
+  /** The y-coordinate of the rectangle. */
+  y: number;
+
+  /** The width of the rectangle. */
+  width: number;
+
+  /** The height of the rectangle. */
+  height: number;
+
+  constructor(x = 0, y = 0, width = 0, height = 0) {
+    this.x = x;
+    this.y = y;
+    this.width = width;
+    this.height = height;
+  }
+
+  /**
+   * The maximum x-coordinate in the rectangle.
+   */
+  get maxX(): number {
+    return this.x + this.width;
+  }
+
+  /**
+   * The maximum y-coordinate in the rectangle.
+   */
+  get maxY(): number {
+    return this.y + this.height;
+  }
+
+  /**
+   * The area of the rectangle.
+   */
+  get area(): number {
+    return this.width * this.height;
+  }
+
+  /**
+   * The top left corner of the rectangle.
+   */
+  get topLeft(): Point {
+    return new Point(this.x, this.y);
+  }
+
+  /**
+   * The top right corner of the rectangle.
+   */
+  get topRight(): Point {
+    return new Point(this.maxX, this.y);
+  }
+
+  /**
+   * The bottom left corner of the rectangle.
+   */
+  get bottomLeft(): Point {
+    return new Point(this.x, this.maxY);
+  }
+
+  /**
+   * The bottom right corner of the rectangle.
+   */
+  get bottomRight(): Point {
+    return new Point(this.maxX, this.maxY);
+  }
+
+  /**
+   * Returns whether this rectangle intersects another rectangle.
+   * @param rect - The rectangle to check.
+   */
+  intersects(rect: Rect): boolean {
+    return this.x <= rect.x + rect.width
+        && rect.x <= this.x + this.width
+        && this.y <= rect.y + rect.height
+        && rect.y <= this.y + this.height;
+  }
+
+  /**
+   * Returns whether this rectangle fully contains another rectangle.
+   * @param rect - The rectangle to check.
+   */
+  containsRect(rect: Rect): boolean {
+    return this.x <= rect.x
+        && this.y <= rect.y
+        && this.maxX >= rect.maxX
+        && this.maxY >= rect.maxY;
+  }
+
+  /**
+   * Returns whether the rectangle contains the given point.
+   * @param point - The point to check.
+   */
+  containsPoint(point: Point): boolean {
+    return this.x <= point.x
+        && this.y <= point.y
+        && this.maxX >= point.x
+        && this.maxY >= point.y;
+  }
+
+  /**
+   * Returns the first corner of this rectangle (from top to bottom, left to right)
+   * that is contained in the given rectangle, or null of the rectangles do not intersect.
+   * @param rect - The rectangle to check.
+   */
+  getCornerInRect(rect: Rect): RectCorner | null {
+    for (let key of ['topLeft', 'topRight', 'bottomLeft', 'bottomRight']) {
+      if (rect.containsPoint(this[key])) {
+        return key as RectCorner;
+      }
+    }
+
+    return null;
+  }
+
+  equals(rect: Rect) {
+    return rect.x === this.x
+        && rect.y === this.y
+        && rect.width === this.width
+        && rect.height === this.height;
+  }
+
+  pointEquals(point: Point | Rect) {
+    return this.x === point.x
+        && this.y === point.y;
+  }
+
+  sizeEquals(size: Size | Rect) {
+    return this.width === size.width
+        && this.height === size.height;
+  }
+
+  /**
+   * Returns the union of this Rect and another.
+   */
+  union(other: Rect) {
+    let x = Math.min(this.x, other.x);
+    let y = Math.min(this.y, other.y);
+    let width = Math.max(this.maxX, other.maxX) - x;
+    let height = Math.max(this.maxY, other.maxY) - y;
+    return new Rect(x, y, width, height);
+  }
+
+  /**
+   * Returns the intersection of this Rect with another.
+   * If the rectangles do not intersect, an all zero Rect is returned.
+   */
+  intersection(other: Rect): Rect {
+    if (!this.intersects(other)) {
+      return new Rect(0, 0, 0, 0);
+    }
+
+    let x = Math.max(this.x, other.x);
+    let y = Math.max(this.y, other.y);
+    return new Rect(
+      x,
+      y,
+      Math.min(this.maxX, other.maxX) - x,
+      Math.min(this.maxY, other.maxY) - y
+    );
+  }
+
+  /**
+   * Returns a copy of this rectangle.
+   */
+  copy(): Rect {
+    return new Rect(this.x, this.y, this.width, this.height);
+  }
+}