@react-aria/collections 3.0.0-alpha.1 → 3.0.0-nightly.2986

package/dist/module.js

@@ -1,324 +1,23 @@
-import _babelRuntimeHelpersEsmExtends from "@babel/runtime/helpers/esm/extends";
-import _babelRuntimeHelpersEsmObjectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
-import { chain, focusWithoutScrolling } from "@react-aria/utils";
-import _react, { useRef, useCallback, useLayoutEffect, useEffect, useState } from "react";
-import { Size, Rect, useCollectionState } from "@react-stately/collections";
-import _babelRuntimeHelpersEsmObjectSpread from "@babel/runtime/helpers/esm/objectSpread2";
-import { flushSync } from "react-dom";
-export function useCollectionItem(options) {
-  let {
-    reusableView: {
-      layoutInfo,
-      collectionManager
-    },
-    ref
-  } = options;
-  let updateSize = useCallback(() => {
-    let size = $e5e366cd21c786f9652cd90121bc5e$var$getSize(ref.current);
-    collectionManager.updateItemSize(layoutInfo.key, size);
-  }, [collectionManager, layoutInfo.key, ref]);
-  useLayoutEffect(() => {
-    if (layoutInfo.estimatedSize) {
-      updateSize();
-    }
-  });
-  return {
-    updateSize
-  };
-}
+import {Collection as $e1995378a142960e$export$fb8073518f34e6ec, CollectionBuilder as $e1995378a142960e$export$bf788dd355e3a401, createBranchComponent as $e1995378a142960e$export$e953bb1cd0f19726, createLeafComponent as $e1995378a142960e$export$18af5c7a9e9b3664} from "./CollectionBuilder.module.js";
+import {createHideableComponent as $f39a9eba43920ace$export$86427a43e3e48ebb, useIsHidden as $f39a9eba43920ace$export$b5d7cc18bb8d2b59} from "./Hidden.module.js";
+import {useCachedChildren as $e948873055cbafe4$export$727c8fc270210f13} from "./useCachedChildren.module.js";
+import {BaseCollection as $23b9f4fcf0fe224b$export$408d25a4e12db025, NodeValue as $23b9f4fcf0fe224b$export$f5d856d854e74713} from "./BaseCollection.module.js";
 
-function $e5e366cd21c786f9652cd90121bc5e$var$getSize(node) {
-  return new Size(node.scrollWidth, node.scrollHeight);
-}
+/*
+ * Copyright 2024 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 function CollectionItem(props) {
-  let {
-    reusableView,
-    parent
-  } = props;
-  let ref = useRef();
-  useCollectionItem({
-    reusableView,
-    ref
-  });
-  return (/*#__PURE__*/_react.createElement("div", {
-      role: "presentation",
-      ref: ref,
-      style: layoutInfoToStyle(reusableView.layoutInfo, parent && parent.layoutInfo)
-    }, reusableView.rendered)
-  );
-}
-export function layoutInfoToStyle(layoutInfo, parent) {
-  return {
-    position: 'absolute',
-    overflow: 'hidden',
-    top: layoutInfo.rect.y - (parent ? parent.rect.y : 0),
-    left: layoutInfo.rect.x - (parent ? parent.rect.x : 0),
-    transition: 'all',
-    WebkitTransition: 'all',
-    WebkitTransitionDuration: 'inherit',
-    transitionDuration: 'inherit',
-    width: layoutInfo.rect.width + 'px',
-    height: layoutInfo.rect.height + 'px',
-    opacity: layoutInfo.opacity,
-    zIndex: layoutInfo.zIndex,
-    transform: layoutInfo.transform,
-    contain: 'size layout style paint'
-  };
-}
 
-function $f6363181241b7deb808b097c5c1c95$var$ScrollView(props, ref) {
-  let {
-    contentSize,
-    visibleRect,
-    onVisibleRectChange,
-    children,
-    innerStyle,
-    sizeToFit,
-    onScrollStart,
-    onScrollEnd,
-    scrollDirection = 'both'
-  } = props,
-      otherProps = _babelRuntimeHelpersEsmObjectWithoutProperties(props, ["contentSize", "visibleRect", "onVisibleRectChange", "children", "innerStyle", "sizeToFit", "onScrollStart", "onScrollEnd", "scrollDirection"]);
 
-  let defaultRef = useRef();
-  ref = ref || defaultRef;
-  let state = useRef({
-    scrollTop: 0,
-    scrollLeft: 0,
-    scrollEndTime: 0,
-    scrollTimeout: null,
-    width: 0,
-    height: 0
-  }).current;
-  let [isScrolling, setScrolling] = useState(false);
-  let onScroll = useCallback(e => {
-    flushSync(() => {
-      let {
-        scrollTop,
-        scrollLeft,
-        scrollHeight,
-        scrollWidth,
-        clientHeight,
-        clientWidth
-      } = e.currentTarget; // Prevent rubber band scrolling from shaking when scrolling out of bounds
 
-      state.scrollTop = Math.max(0, Math.min(scrollTop, scrollHeight - clientHeight));
-      state.scrollLeft = Math.max(0, Math.min(scrollLeft, scrollWidth - clientWidth));
-      onVisibleRectChange(new Rect(state.scrollLeft, state.scrollTop, state.width, state.height));
 
-      if (!isScrolling) {
-        setScrolling(true);
-
-        if (onScrollStart) {
-          onScrollStart();
-        }
-      } // So we don't constantly call clearTimeout and setTimeout,
-      // keep track of the current timeout time and only reschedule
-      // the timer when it is getting close.
-
-
-      let now = Date.now();
-
-      if (state.scrollEndTime <= now + 50) {
-        state.scrollEndTime = now + 300;
-        clearTimeout(state.scrollTimeout);
-        state.scrollTimeout = setTimeout(() => {
-          setScrolling(false);
-          state.scrollTimeout = null;
-
-          if (onScrollEnd) {
-            onScrollEnd();
-          }
-        }, 300);
-      }
-    });
-  }, [isScrolling, onScrollEnd, onScrollStart, onVisibleRectChange, state.height, state.scrollEndTime, state.scrollLeft, state.scrollTimeout, state.scrollTop, state.width]);
-  useEffect(() => {
-    // TODO: resize observer
-    // https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver
-    let updateSize = () => {
-      let dom = ref.current;
-
-      if (!dom) {
-        return;
-      }
-
-      let w = dom.clientWidth;
-      let h = dom.clientHeight;
-
-      if (sizeToFit && contentSize.width > 0 && contentSize.height > 0) {
-        let style = window.getComputedStyle(dom);
-
-        if (sizeToFit === 'width') {
-          w = contentSize.width;
-          let maxWidth = parseInt(style.maxWidth, 10);
-
-          if (!isNaN(maxWidth)) {
-            w = Math.min(maxWidth, w);
-          }
-        } else if (sizeToFit === 'height') {
-          h = contentSize.height;
-          let maxHeight = parseInt(style.maxHeight, 10);
-
-          if (!isNaN(maxHeight)) {
-            h = Math.min(maxHeight, h);
-          }
-        }
-      }
-
-      if (state.width !== w || state.height !== h) {
-        state.width = w;
-        state.height = h;
-        onVisibleRectChange(new Rect(state.scrollLeft, state.scrollTop, w, h));
-      }
-    };
-
-    updateSize();
-    window.addEventListener('resize', updateSize, false);
-    return () => {
-      window.removeEventListener('resize', updateSize, false);
-    };
-  }, [onVisibleRectChange, ref, state.height, state.scrollLeft, state.scrollTop, state.width, sizeToFit, contentSize.width, contentSize.height]);
-  useLayoutEffect(() => {
-    let dom = ref.current;
-
-    if (!dom) {
-      return;
-    }
-
-    if (visibleRect.x !== state.scrollLeft) {
-      state.scrollLeft = visibleRect.x;
-      dom.scrollLeft = visibleRect.x;
-    }
-
-    if (visibleRect.y !== state.scrollTop) {
-      state.scrollTop = visibleRect.y;
-      dom.scrollTop = visibleRect.y;
-    }
-  }, [ref, state.scrollLeft, state.scrollTop, visibleRect.x, visibleRect.y]);
-
-  let style = _babelRuntimeHelpersEsmObjectSpread({}, otherProps.style, {
-    position: 'relative',
-    // Reset padding so that relative positioning works correctly. Padding will be done in JS layout.
-    padding: 0
-  });
-
-  if (scrollDirection === 'horizontal') {
-    style.overflowX = 'auto';
-    style.overflowY = 'hidden';
-  } else if (scrollDirection === 'vertical') {
-    style.overflowY = 'auto';
-    style.overflowX = 'hidden';
-  } else {
-    style.overflow = 'auto';
-  }
-
-  return (/*#__PURE__*/_react.createElement("div", _babelRuntimeHelpersEsmExtends({}, otherProps, {
-      style: style,
-      ref: ref,
-      onScroll: onScroll
-    }), /*#__PURE__*/_react.createElement("div", {
-      role: "presentation",
-      style: _babelRuntimeHelpersEsmObjectSpread({
-        width: contentSize.width,
-        height: contentSize.height,
-        pointerEvents: isScrolling ? 'none' : 'auto'
-      }, innerStyle)
-    }, children))
-  );
-}
-
-const $f6363181241b7deb808b097c5c1c95$export$ScrollView = _react.forwardRef($f6363181241b7deb808b097c5c1c95$var$ScrollView);
-
-function $ebc1e5916247e7181d0a82c4b9f2$var$CollectionView(props, ref) {
-  let {
-    children: renderView,
-    renderWrapper,
-    layout,
-    collection,
-    focusedKey,
-    sizeToFit,
-    scrollDirection
-  } = props,
-      otherProps = _babelRuntimeHelpersEsmObjectWithoutProperties(props, ["children", "renderWrapper", "layout", "collection", "focusedKey", "sizeToFit", "scrollDirection"]);
-
-  let {
-    visibleViews,
-    visibleRect,
-    setVisibleRect,
-    contentSize,
-    isAnimating,
-    collectionManager,
-    startScrolling,
-    endScrolling
-  } = useCollectionState({
-    layout,
-    collection,
-    renderView,
-    renderWrapper: renderWrapper || $ebc1e5916247e7181d0a82c4b9f2$var$defaultRenderWrapper
-  });
-  let fallbackRef = useRef();
-  ref = ref || fallbackRef; // Scroll to the focusedKey when it changes. Actually focusing the focusedKey
-  // is up to the implementation using CollectionView since we don't have refs
-  // to all of the item DOM nodes.
-
-  useEffect(() => {
-    if (focusedKey) {
-      collectionManager.scrollToItem(focusedKey, 0);
-    }
-  }, [focusedKey, collectionManager]);
-  let isFocusWithin = useRef(false);
-  let onFocus = useCallback(e => {
-    // If the focused item is scrolled out of view and is not in the DOM, the CollectionView
-    // will have tabIndex={0}. When tabbing in from outside, scroll the focused item into view.
-    // We only want to do this if the CollectionView itself is receiving focus, not a child
-    // element, and we aren't moving focus to the CollectionView from within (see below).
-    if (e.target === ref.current && !isFocusWithin.current) {
-      collectionManager.scrollToItem(focusedKey, 0);
-    }
-
-    isFocusWithin.current = e.target !== ref.current;
-  }, [ref, collectionManager, focusedKey]);
-  let onBlur = useCallback(e => {
-    isFocusWithin.current = ref.current.contains(e.relatedTarget);
-  }, [ref]); // When the focused item is scrolled out of view and is removed from the DOM, 
-  // move focus to the collection view as a whole if focus was within before.
-
-  let focusedView = collectionManager.getItemView(focusedKey);
-  useEffect(() => {
-    if (focusedKey && !focusedView && isFocusWithin.current && document.activeElement !== ref.current) {
-      focusWithoutScrolling(ref.current);
-    }
-  });
-  return (/*#__PURE__*/_react.createElement($f6363181241b7deb808b097c5c1c95$export$ScrollView, _babelRuntimeHelpersEsmExtends({}, otherProps, {
-      tabIndex: focusedView ? -1 : 0,
-      ref: ref,
-      onFocus: chain(otherProps.onFocus, onFocus),
-      onBlur: chain(otherProps.onBlur, onBlur),
-      innerStyle: isAnimating ? {
-        transition: "none ".concat(collectionManager.transitionDuration, "ms")
-      } : undefined,
-      contentSize: contentSize,
-      visibleRect: visibleRect,
-      onVisibleRectChange: setVisibleRect,
-      onScrollStart: startScrolling,
-      onScrollEnd: endScrolling,
-      sizeToFit: sizeToFit,
-      scrollDirection: scrollDirection
-    }), visibleViews)
-  );
-} // forwardRef doesn't support generic parameters, so cast the result to the correct type
-// https://stackoverflow.com/questions/58469229/react-with-typescript-generics-while-using-react-forwardref
-
-
-export const CollectionView = _react.forwardRef($ebc1e5916247e7181d0a82c4b9f2$var$CollectionView);
-
-function $ebc1e5916247e7181d0a82c4b9f2$var$defaultRenderWrapper(parent, reusableView) {
-  return (/*#__PURE__*/_react.createElement(CollectionItem, {
-      key: reusableView.key,
-      reusableView: reusableView,
-      parent: parent
-    })
-  );
-}
+export {$e1995378a142960e$export$bf788dd355e3a401 as CollectionBuilder, $e1995378a142960e$export$fb8073518f34e6ec as Collection, $e1995378a142960e$export$18af5c7a9e9b3664 as createLeafComponent, $e1995378a142960e$export$e953bb1cd0f19726 as createBranchComponent, $f39a9eba43920ace$export$86427a43e3e48ebb as createHideableComponent, $f39a9eba43920ace$export$b5d7cc18bb8d2b59 as useIsHidden, $e948873055cbafe4$export$727c8fc270210f13 as useCachedChildren, $23b9f4fcf0fe224b$export$408d25a4e12db025 as BaseCollection, $23b9f4fcf0fe224b$export$f5d856d854e74713 as NodeValue};
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/collections/src/index.ts"],"sourcesContent":["/*\n * Copyright 2024 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\nexport {CollectionBuilder, Collection, createLeafComponent, createBranchComponent} from './CollectionBuilder';\nexport {createHideableComponent, useIsHidden} from './Hidden';\nexport {useCachedChildren} from './useCachedChildren';\nexport {BaseCollection, NodeValue} from './BaseCollection';\n\nexport type {CollectionBuilderProps, CollectionProps} from './CollectionBuilder';\nexport type {CachedChildrenOptions} from './useCachedChildren';\n"],"names":[],"version":3,"file":"module.js.map"}

package/dist/types.d.ts

@@ -1,29 +1,86 @@
-import { RefObject, CSSProperties, HTMLAttributes, Key, ReactElement } from "react";
-import { ReusableView, LayoutInfo, Collection, Layout } from "@react-stately/collections";
-interface CollectionItemOptions<T extends object, V, W> {
-    reusableView: ReusableView<T, V>;
-    ref: RefObject<HTMLElement>;
+import { Collection as _Collection1, Key, Node } from "@react-types/shared";
+import React, { ReactElement, ReactNode, ForwardedRef, JSX } from "react";
+/** An immutable object representing a Node in a Collection. */
+export class NodeValue<T> implements Node<T> {
+    readonly type: string;
+    readonly key: Key;
+    readonly value: T | null;
+    readonly level: number;
+    readonly hasChildNodes: boolean;
+    readonly rendered: ReactNode;
+    readonly textValue: string;
+    readonly 'aria-label'?: string;
+    readonly index: number;
+    readonly parentKey: Key | null;
+    readonly prevKey: Key | null;
+    readonly nextKey: Key | null;
+    readonly firstChildKey: Key | null;
+    readonly lastChildKey: Key | null;
+    readonly props: any;
+    readonly render?: (node: Node<any>) => ReactElement;
+    constructor(type: string, key: Key);
+    get childNodes(): Iterable<Node<T>>;
+    clone(): NodeValue<T>;
 }
-export function useCollectionItem<T extends object, V, W>(options: CollectionItemOptions<T, V, W>): {
-    updateSize: () => void;
-};
-interface CollectionItemProps<T extends object, V> {
-    reusableView: ReusableView<T, V>;
-    parent?: ReusableView<T, V>;
+/**
+ * An immutable Collection implementation. Updates are only allowed
+ * when it is not marked as frozen. This can be subclassed to implement
+ * custom collection behaviors.
+ */
+export class BaseCollection<T> implements _Collection1<Node<T>> {
+    get size(): number;
+    getKeys(): IterableIterator<Key>;
+    [Symbol.iterator](): Generator<Node<T>, void, unknown>;
+    getChildren(key: Key): Iterable<Node<T>>;
+    getKeyBefore(key: Key): Key;
+    getKeyAfter(key: Key): Key;
+    getFirstKey(): Key;
+    getLastKey(): Key;
+    getItem(key: Key): Node<T> | null;
+    at(): Node<T>;
+    clone(): this;
+    addNode(node: NodeValue<T>): void;
+    removeNode(key: Key): void;
+    commit(firstKey: Key | null, lastKey: Key | null, isSSR?: boolean): void;
 }
-export function CollectionItem<T extends object, V>(props: CollectionItemProps<T, V>): JSX.Element;
-export function layoutInfoToStyle(layoutInfo: LayoutInfo, parent?: LayoutInfo | null): CSSProperties;
-interface CollectionViewProps<T extends object, V> extends HTMLAttributes<HTMLElement> {
-    children: (type: string, content: T) => V;
-    renderWrapper?: (parent: ReusableView<T, V> | null, reusableView: ReusableView<T, V>, children: ReusableView<T, V>[], renderChildren: (views: ReusableView<T, V>[]) => ReactElement[]) => ReactElement;
-    layout: Layout<T>;
-    collection: Collection<T>;
-    focusedKey?: Key;
-    sizeToFit?: 'width' | 'height';
-    scrollDirection?: 'horizontal' | 'vertical' | 'both';
+export interface CachedChildrenOptions<T> {
+    /** Item objects in the collection. */
+    items?: Iterable<T>;
+    /** The contents of the collection. */
+    children?: ReactNode | ((item: T) => ReactNode);
+    /** Values that should invalidate the item cache when using dynamic collections. */
+    dependencies?: any[];
+    /** A scope to prepend to all child item ids to ensure they are unique. */
+    idScope?: Key;
+    /** Whether to add `id` and `value` props to all child items. */
+    addIdAndValue?: boolean;
 }
-export const CollectionView: <T extends object, V>(props: CollectionViewProps<T, V> & {
-    ref?: React.RefObject<HTMLDivElement>;
-}) => React.ReactElement<any, string | ((props: any) => React.ReactElement<any, string | any | (new (props: any) => React.Component<any, any, any>)>) | (new (props: any) => React.Component<any, any, any>)>;
+/**
+ * Maps over a list of items and renders React elements for them. Each rendered item is
+ * cached based on object identity, and React keys are generated from the `key` or `id` property.
+ */
+export function useCachedChildren<T extends object>(props: CachedChildrenOptions<T>): ReactNode;
+/** Creates a component that forwards its ref and returns null if it is in a hidden subtree. */
+export function createHideableComponent<T, P = {}>(fn: (props: P, ref: React.Ref<T>) => ReactNode | null): (props: P & React.RefAttributes<T>) => ReactNode | null;
+/** Returns whether the component is in a hidden subtree. */
+export function useIsHidden(): boolean;
+export interface CollectionBuilderProps<C extends BaseCollection<object>> {
+    content: ReactNode;
+    children: (collection: C) => ReactNode;
+    createCollection?: () => C;
+}
+/**
+ * Builds a `Collection` from the children provided to the `content` prop, and passes it to the child render prop function.
+ */
+export function CollectionBuilder<C extends BaseCollection<object>>(props: CollectionBuilderProps<C>): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.ReactPortal | Iterable<React.ReactNode>> | JSX.Element;
+export function createLeafComponent<T extends object, P extends object, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>) => ReactNode): (props: P & React.RefAttributes<T>) => ReactNode | null;
+export function createLeafComponent<T extends object, P extends object, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>, node: Node<T>) => ReactNode): (props: P & React.RefAttributes<T>) => ReactNode | null;
+export function createBranchComponent<T extends object, P extends {
+    children?: any;
+}, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>, node: Node<T>) => ReactNode, useChildren?: (props: P) => ReactNode): (props: P & React.RefAttributes<E>) => React.ReactNode | null;
+export interface CollectionProps<T> extends CachedChildrenOptions<T> {
+}
+/** A Collection renders a list of items, automatically managing caching and keys. */
+export function Collection<T extends object>(props: CollectionProps<T>): JSX.Element;
 
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/govett/dev/react-spectrum/packages/@react-aria/collections/src/packages/@react-aria/collections/src/useCollectionItem.ts","/Users/govett/dev/react-spectrum/packages/@react-aria/collections/src/packages/@react-aria/collections/src/CollectionItem.tsx","/Users/govett/dev/react-spectrum/packages/@react-aria/collections/src/packages/@react-aria/collections/src/CollectionView.tsx"],"names":[],"mappings":";;AAgBA,gCAAgC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACpD,YAAY,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,GAAG,EAAE,UAAU,WAAW,CAAC,CAAA;CAC5B;AAED,kCAAkC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;;EAehG;ACnBD,8BAA8B,CAAC,SAAS,MAAM,EAAE,CAAC;IAC/C,YAAY,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;CAC5B;AAED,+BAA+B,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC,eAanF;AAED,kCAAkC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,aAAa,CAiBnG;AClCD,8BAA8B,CAAC,SAAS,MAAM,EAAE,CAAC,CAAE,SAAQ,eAAe,WAAW,CAAC;IACpF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,CACd,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EACjC,YAAY,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,EAChC,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,EAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,YAAY,EAAE,KAC5D,YAAY,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClB,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1B,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,eAAe,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAA;CACrD;AAgFD,OAAA,MAAM;;6MAAiK,CAAC","file":"types.d.ts.map"}
+{"mappings":"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","sources":["packages/@react-aria/collections/src/packages/@react-aria/collections/src/BaseCollection.ts","packages/@react-aria/collections/src/packages/@react-aria/collections/src/Document.ts","packages/@react-aria/collections/src/packages/@react-aria/collections/src/useCachedChildren.ts","packages/@react-aria/collections/src/packages/@react-aria/collections/src/Hidden.tsx","packages/@react-aria/collections/src/packages/@react-aria/collections/src/CollectionBuilder.tsx","packages/@react-aria/collections/src/packages/@react-aria/collections/src/index.ts","packages/@react-aria/collections/src/index.ts"],"sourcesContent":[null,null,null,null,null,null,"/*\n * Copyright 2024 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\nexport {CollectionBuilder, Collection, createLeafComponent, createBranchComponent} from './CollectionBuilder';\nexport {createHideableComponent, useIsHidden} from './Hidden';\nexport {useCachedChildren} from './useCachedChildren';\nexport {BaseCollection, NodeValue} from './BaseCollection';\n\nexport type {CollectionBuilderProps, CollectionProps} from './CollectionBuilder';\nexport type {CachedChildrenOptions} from './useCachedChildren';\n"],"names":[],"version":3,"file":"types.d.ts.map"}

package/dist/useCachedChildren.main.js

@@ -0,0 +1,63 @@
+var $6Tq0m$react = require("react");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "useCachedChildren", () => $245f3f827bea6653$export$727c8fc270210f13);
+/*
+ * Copyright 2024 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.
+ */ 
+function $245f3f827bea6653$export$727c8fc270210f13(props) {
+    let { children: children, items: items, idScope: idScope, addIdAndValue: addIdAndValue, dependencies: dependencies = [] } = props;
+    // Invalidate the cache whenever the parent value changes.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    let cache = (0, $6Tq0m$react.useMemo)(()=>new WeakMap(), dependencies);
+    return (0, $6Tq0m$react.useMemo)(()=>{
+        if (items && typeof children === 'function') {
+            let res = [];
+            for (let item of items){
+                let rendered = cache.get(item);
+                if (!rendered) {
+                    rendered = children(item);
+                    var _rendered_props_id, _ref;
+                    // @ts-ignore
+                    let key = (_ref = (_rendered_props_id = rendered.props.id) !== null && _rendered_props_id !== void 0 ? _rendered_props_id : item.key) !== null && _ref !== void 0 ? _ref : item.id;
+                    // eslint-disable-next-line max-depth
+                    if (key == null) throw new Error('Could not determine key for item');
+                    // eslint-disable-next-line max-depth
+                    if (idScope) key = idScope + ':' + key;
+                    // Note: only works if wrapped Item passes through id...
+                    rendered = (0, $6Tq0m$react.cloneElement)(rendered, addIdAndValue ? {
+                        key: key,
+                        id: key,
+                        value: item
+                    } : {
+                        key: key
+                    });
+                    cache.set(item, rendered);
+                }
+                res.push(rendered);
+            }
+            return res;
+        } else if (typeof children !== 'function') return children;
+    }, [
+        children,
+        items,
+        cache,
+        idScope,
+        addIdAndValue
+    ]);
+}
+
+
+//# sourceMappingURL=useCachedChildren.main.js.map

package/dist/useCachedChildren.main.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;AAAA;;;;;;;;;;CAUC;AAsBM,SAAS,0CAAoC,KAA+B;IACjF,IAAI,YAAC,QAAQ,SAAE,KAAK,WAAE,OAAO,iBAAE,aAAa,gBAAE,eAAe,EAAE,EAAC,GAAG;IAEnE,0DAA0D;IAC1D,uDAAuD;IACvD,IAAI,QAAQ,CAAA,GAAA,oBAAM,EAAE,IAAM,IAAI,WAAW;IACzC,OAAO,CAAA,GAAA,oBAAM,EAAE;QACb,IAAI,SAAS,OAAO,aAAa,YAAY;YAC3C,IAAI,MAAsB,EAAE;YAC5B,KAAK,IAAI,QAAQ,MAAO;gBACtB,IAAI,WAAW,MAAM,GAAG,CAAC;gBACzB,IAAI,CAAC,UAAU;oBACb,WAAW,SAAS;wBAEV,oBAAA;oBADV,aAAa;oBACb,IAAI,MAAM,CAAA,OAAA,CAAA,qBAAA,SAAS,KAAK,CAAC,EAAE,cAAjB,gCAAA,qBAAqB,KAAK,GAAG,cAA7B,kBAAA,OAAiC,KAAK,EAAE;oBAClD,qCAAqC;oBACrC,IAAI,OAAO,MACT,MAAM,IAAI,MAAM;oBAElB,qCAAqC;oBACrC,IAAI,SACF,MAAM,UAAU,MAAM;oBAExB,wDAAwD;oBACxD,WAAW,CAAA,GAAA,yBAAW,EACpB,UACA,gBAAgB;6BAAC;wBAAK,IAAI;wBAAK,OAAO;oBAAI,IAAI;6BAAC;oBAAG;oBAEpD,MAAM,GAAG,CAAC,MAAM;gBAClB;gBACA,IAAI,IAAI,CAAC;YACX;YACA,OAAO;QACT,OAAO,IAAI,OAAO,aAAa,YAC7B,OAAO;IAEX,GAAG;QAAC;QAAU;QAAO;QAAO;QAAS;KAAc;AACrD","sources":["packages/@react-aria/collections/src/useCachedChildren.ts"],"sourcesContent":["/*\n * Copyright 2024 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\nimport {cloneElement, ReactElement, ReactNode, useMemo} from 'react';\nimport {Key} from '@react-types/shared';\n\nexport interface CachedChildrenOptions<T> {\n  /** Item objects in the collection. */\n  items?: Iterable<T>,\n  /** The contents of the collection. */\n  children?: ReactNode | ((item: T) => ReactNode),\n  /** Values that should invalidate the item cache when using dynamic collections. */\n  dependencies?: any[],\n  /** A scope to prepend to all child item ids to ensure they are unique. */\n  idScope?: Key,\n  /** Whether to add `id` and `value` props to all child items. */\n  addIdAndValue?: boolean\n}\n\n/**\n * Maps over a list of items and renders React elements for them. Each rendered item is\n * cached based on object identity, and React keys are generated from the `key` or `id` property.\n */\nexport function useCachedChildren<T extends object>(props: CachedChildrenOptions<T>): ReactNode {\n  let {children, items, idScope, addIdAndValue, dependencies = []} = props;\n\n  // Invalidate the cache whenever the parent value changes.\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  let cache = useMemo(() => new WeakMap(), dependencies);\n  return useMemo(() => {\n    if (items && typeof children === 'function') {\n      let res: ReactElement[] = [];\n      for (let item of items) {\n        let rendered = cache.get(item);\n        if (!rendered) {\n          rendered = children(item);\n          // @ts-ignore\n          let key = rendered.props.id ?? item.key ?? item.id;\n          // eslint-disable-next-line max-depth\n          if (key == null) {\n            throw new Error('Could not determine key for item');\n          }\n          // eslint-disable-next-line max-depth\n          if (idScope) {\n            key = idScope + ':' + key;\n          }\n          // Note: only works if wrapped Item passes through id...\n          rendered = cloneElement(\n            rendered,\n            addIdAndValue ? {key, id: key, value: item} : {key}\n          );\n          cache.set(item, rendered);\n        }\n        res.push(rendered);\n      }\n      return res;\n    } else if (typeof children !== 'function') {\n      return children;\n    }\n  }, [children, items, cache, idScope, addIdAndValue]);\n}\n"],"names":[],"version":3,"file":"useCachedChildren.main.js.map"}

package/dist/useCachedChildren.mjs

@@ -0,0 +1,58 @@
+import {useMemo as $luMFQ$useMemo, cloneElement as $luMFQ$cloneElement} from "react";
+
+/*
+ * Copyright 2024 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.
+ */ 
+function $e948873055cbafe4$export$727c8fc270210f13(props) {
+    let { children: children, items: items, idScope: idScope, addIdAndValue: addIdAndValue, dependencies: dependencies = [] } = props;
+    // Invalidate the cache whenever the parent value changes.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    let cache = (0, $luMFQ$useMemo)(()=>new WeakMap(), dependencies);
+    return (0, $luMFQ$useMemo)(()=>{
+        if (items && typeof children === 'function') {
+            let res = [];
+            for (let item of items){
+                let rendered = cache.get(item);
+                if (!rendered) {
+                    rendered = children(item);
+                    var _rendered_props_id, _ref;
+                    // @ts-ignore
+                    let key = (_ref = (_rendered_props_id = rendered.props.id) !== null && _rendered_props_id !== void 0 ? _rendered_props_id : item.key) !== null && _ref !== void 0 ? _ref : item.id;
+                    // eslint-disable-next-line max-depth
+                    if (key == null) throw new Error('Could not determine key for item');
+                    // eslint-disable-next-line max-depth
+                    if (idScope) key = idScope + ':' + key;
+                    // Note: only works if wrapped Item passes through id...
+                    rendered = (0, $luMFQ$cloneElement)(rendered, addIdAndValue ? {
+                        key: key,
+                        id: key,
+                        value: item
+                    } : {
+                        key: key
+                    });
+                    cache.set(item, rendered);
+                }
+                res.push(rendered);
+            }
+            return res;
+        } else if (typeof children !== 'function') return children;
+    }, [
+        children,
+        items,
+        cache,
+        idScope,
+        addIdAndValue
+    ]);
+}
+
+
+export {$e948873055cbafe4$export$727c8fc270210f13 as useCachedChildren};
+//# sourceMappingURL=useCachedChildren.module.js.map