@oracle/oraclejet-preact 18.0.5 → 18.0.7

package/es/List-e6886091.js

@@ -0,0 +1,717 @@
+/* @oracle/oraclejet-preact: undefined */
+import { jsx } from 'preact/jsx-runtime';
+import { useRef, useMemo, useState, useEffect, useCallback, useImperativeHandle } from 'preact/hooks';
+import { c as classNames } from './classNames-4e12b00d.js';
+import { m as mergeProps } from './mergeProps-88ea8306.js';
+import { b as addKeys, i as isKeyDefined, c as containsKey } from './keys-49c92dbb.js';
+import { L as LOADMORE_STYLE_CLASS, a as LoadMoreCollection } from './LoadMoreCollection-7df1be36.js';
+import { P as PLACEHOLDER_STYLE_CLASS, V as VirtualizedCollection } from './VirtualizedCollection-f048fbb8.js';
+import { memo } from 'preact/compat';
+import { T as TabbableModeContext } from './TabbableModeContext-7d8ad946.js';
+import { u as useId } from './useId-03dbfdf0.js';
+import { F as FocusTrap } from './FocusTrap-c31d16c5.js';
+import { u as useInteractionStyle } from './useInteractionStyle-1faefed7.js';
+import { m as mergeInterpolations } from './mergeInterpolations-e2db2a66.js';
+import { f as flexitemInterpolations } from './flexitem-7b7f7920.js';
+import { listItemMultiVariantStyles, paddingStyles, listItemStyles, skeletonStyles, sparkleStyles, listStyles } from './PRIVATE_List/themes/ListStyles.css.js';
+import { e as compareListItemContext, m as getPrevNextKey, k as keyExtractor, f as findElementByKey, d as getFirstVisibleKey } from './collectionUtils-ccfce5b4.js';
+import { S as Skeleton } from './Skeleton-4d1ce61b.js';
+import { F as Flex } from './Flex-2d51e914.js';
+import { S as Selector } from './Selector-5892544f.js';
+import { g as globalImages } from './ImageVars.css-7b3180c8.js';
+import { u as useTheme } from './useTheme-73aca0e4.js';
+import { u as useTestId } from './useTestId-af32a9eb.js';
+import './CollectionInteractionContext-7cf19abc.js';
+import { u as useCollectionInteractionContext } from './useCollectionInteractionContext-3895c632.js';
+import { u as useSelection } from './useSelection-c46ba985.js';
+import { u as useDropDownSelection } from './useDropDownSelection-28285b15.js';
+import { u as useCurrentKey } from './useCurrentKey-aa75ec92.js';
+import { u as useCollectionFocusRing } from './useCollectionFocusRing-0395110a.js';
+import { u as useItemAction } from './useItemAction-0183650e.js';
+import { u as useTabbableModeSet } from './useTabbableModeSet-92034cf1.js';
+import { u as useReorderableContext } from './useReorderableContext-79b1c941.js';
+import { I as Inset } from './Inset-f310ac0b.js';
+import './PRIVATE_List/themes/redwood/ListBaseTheme.styles.css';
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+/**
+ * List Roles need to be kept in matching sets, this module encapsulates the sets
+ *
+ * @param ariaRole
+ * @returns matching, valid set of roles
+ */
+const getListViewRoles = (ariaRole) => {
+    switch (ariaRole) {
+        case 'listbox':
+            return { list: 'listbox', item: 'presentation', cell: 'option' };
+        case 'treegrid':
+            return { list: 'treegrid', item: 'row', cell: 'gridcell' };
+        default:
+            return { list: 'grid', item: 'row', cell: 'gridcell' };
+    }
+};
+
+const ITEM_SELECTOR = '[data-oj-key]';
+/**
+ * The internal component used to render a single item in ListView.
+ */
+function ListViewItem({ children, context, itemDepth, isFocused, isFocusRingVisible, isActive, isGridlineVisible, isSelected, isTopGridlineVisible = false, isTabbable = false, role, selectionMode, suggestion, currentItemVariant, padding }) {
+    const rootRef = useRef(null);
+    const roles = useMemo(() => getListViewRoles(role), [role]);
+    const itemKey = context.metadata.key;
+    const itemIndex = context.index;
+    // some roles come with related aria attributes which need to be set
+    const cellRoleAttributes = roles.cell === 'option'
+        ? {
+            role: roles.cell,
+            'aria-posinset': itemIndex + 1,
+            'aria-setsize': -1
+        }
+        : {
+            role: roles.cell
+        };
+    // don't bubble Arrow Up and Down events to parent when in isTabbable mode
+    // this bubbling causes the outer CollectionFocus ring to change index while in the isTabbable mode.
+    const handleKeyDown = (event) => {
+        if (isTabbable && (event.key === 'ArrowDown' || event.key === 'ArrowUp')) {
+            event.stopPropagation();
+        }
+    };
+    const { interactionProps, applyActiveStyle, applyHoverStyle, applyPseudoHoverStyle } = useInteractionStyle();
+    const variantClasses = listItemMultiVariantStyles({
+        selectable: isSelectable(selectionMode, isSelected) ? 'isSelectable' : 'notSelectable',
+        selected: isSelected ? 'isSelected' : 'notSelected',
+        selectedSingle: isSelected && selectionMode === 'single' ? 'isSelectedSingle' : 'notSelectedSingle',
+        needsEventsHover: applyHoverStyle ? 'isNeedsEventsHover' : 'notNeedsEventsHover',
+        pseudoHover: applyPseudoHoverStyle ? 'isPseudoHover' : 'notPseudoHover',
+        active: applyActiveStyle || isActive ? 'isActive' : 'notActive',
+        focusHighlight: currentItemVariant === 'highlight' && isFocused ? 'isFocusHighlight' : 'notFocusHighlight',
+        focusRingVisible: isFocusRingVisible && isFocused ? 'isFocusRingVisible' : 'notFocusRingVisible',
+        gridlineTop: isTopGridlineVisible ? 'visible' : 'hidden',
+        gridlineBottom: isGridlineVisible ||
+            (suggestion === 'end' && !isGridlineVisible && (!isSelected || selectionMode !== 'single'))
+            ? 'visible'
+            : 'hidden'
+    });
+    const paddingClasses = [];
+    if (padding) {
+        if (padding === 'enabled') {
+            paddingClasses.push(paddingStyles.allPadding);
+        }
+        else if (padding !== 'disabled') {
+            if (padding.top === 'enabled') {
+                paddingClasses.push(paddingStyles.topItemPadding);
+            }
+            if (padding.bottom === 'enabled') {
+                paddingClasses.push(paddingStyles.bottomItemPadding);
+            }
+            if (padding.start === 'enabled') {
+                paddingClasses.push(paddingStyles.startItemPadding);
+            }
+            if (padding.end === 'enabled') {
+                paddingClasses.push(paddingStyles.endItemPadding);
+            }
+        }
+    }
+    const classes = classNames([variantClasses, ...paddingClasses]);
+    const styleInterpolations = mergeInterpolations([
+        ...Object.values(flexitemInterpolations)
+    ]);
+    const { class: cls, ...cellStyles } = styleInterpolations({
+        flex: '1 1 auto',
+        alignSelf: 'center'
+    });
+    const cellClasses = classNames([
+        cls,
+        selectionMode === 'multiple' && listItemStyles.checkboxContainer
+    ]);
+    // todo: use translated text for selector
+    // note cannot put focus on gridcell div since JAWS will not read the aria-rowindex
+    // correctly, so unfortunately needed another div
+    return (jsx("div", { "aria-rowindex": role === 'grid' ? itemIndex + 1 : undefined, "aria-level": itemDepth, "data-oj-key": itemKey, class: classes, ref: rootRef, role: roles.item, ...(suggestion && { 'data-oj-suggestion': true }), ...(typeof itemKey === 'number' && { 'data-oj-key-type': 'number' }), ...interactionProps, children: jsx("div", { id: useId(), style: cellStyles, class: cellClasses, "aria-posinset": role === 'grid' ? undefined : itemIndex + 1, "aria-setsize": role === 'grid' ? undefined : -1, onKeyDown: handleKeyDown, "aria-colindex": role === 'grid' ? 1 : undefined, "aria-selected": selectionMode !== 'none' ? isSelected : undefined, ...cellRoleAttributes, children: jsx(TabbableModeContext.Provider, { value: { isTabbable }, children: jsx(FocusTrap, { isDisabled: !isTabbable, restoreFocusRef: false, children: children(context) }) }) }) }));
+}
+/**
+ * Helper method to determine whether item is selectable
+ * @returns true if item is selectable (show hover effect), false otherwise
+ */
+const isSelectable = (selectionMode, isItemSelected) => {
+    return selectionMode !== 'none' && (selectionMode === 'multiple' || !isItemSelected);
+};
+const MemoizeListViewItem = memo(ListViewItem, (prev, next) => {
+    if (prev && next) {
+        return (prev.children === next.children &&
+            prev.isFocused === next.isFocused &&
+            prev.isFocusRingVisible === next.isFocusRingVisible &&
+            prev.isSelected === next.isSelected &&
+            prev.isTabbable === next.isTabbable &&
+            prev.isActive === next.isActive &&
+            prev.suggestion === next.suggestion &&
+            prev.isGridlineVisible === next.isGridlineVisible &&
+            prev.isTopGridlineVisible === next.isTopGridlineVisible &&
+            prev.padding === next.padding &&
+            compareListItemContext(prev.context, next.context));
+    }
+    return false;
+});
+
+/**
+ * Allows to specify the time delay for rendering the component
+ **/
+const timerValue = 50;
+/**
+ * SkeletonContainer renders 'minimumCount' number of skeletons
+ * of the variant specified from its child element - Skeleton's prop after
+ * 'timerValue' ms delay
+ **/
+function SkeletonContainer({ children, minimumCount = 1 }) {
+    const [isVisible, setIsVisible] = useState(false);
+    useEffect(() => {
+        setTimeout(() => {
+            setIsVisible(true);
+        }, timerValue);
+    }, []);
+    const containerClasses = classNames([skeletonStyles.container]);
+    return isVisible && children ? (jsx("div", { class: containerClasses, role: "presentation", children: [...Array(minimumCount)].map((_element, index) => children(index)) })) : null;
+}
+
+const SPARKLE_STYLE_CLASS = 'oj-collection-sparkle';
+/**
+ * A sparkle component for smart suggestion indicator in ListView
+ * @param sparkleHeight the height of sparkle
+ */
+function Sparkle({ sparkleHeight }) {
+    const { name } = useTheme();
+    if (sparkleHeight <= 0) {
+        return null;
+    }
+    const height = sparkleHeight + 'px';
+    const sparkleClasses = classNames([sparkleStyles.base]);
+    const containerClasses = classNames([
+        sparkleStyles.container,
+        SPARKLE_STYLE_CLASS,
+        // TODO: this component should create separate theme definitions to only show the image in redwood
+        name === 'redwood' && globalImages
+    ]);
+    return (jsx("div", { class: containerClasses, children: jsx("div", { class: sparkleClasses, style: { height } }) }, "sparkle"));
+}
+
+const usePromotedSection = (data, promotedSection, rootRef) => {
+    // tracking sparkle height
+    const [sparkleHeight, setSparkleHeight] = useState(0);
+    const suggestions = useMemo(() => data && promotedSection && findSuggestions(data.data, promotedSection.count), [data, promotedSection]);
+    useEffect(() => {
+        // update sparkleHeight only when we have suggestions
+        // avoid unnecessary iterating through elements
+        if (suggestions) {
+            const placeholder = rootRef.current?.querySelector('.' + PLACEHOLDER_STYLE_CLASS);
+            let height = placeholder?.offsetHeight || 0;
+            const suggestionItems = rootRef.current?.querySelectorAll('[data-oj-suggestion]');
+            suggestionItems?.forEach((item) => (height += item.offsetHeight));
+            setSparkleHeight(height);
+        }
+    }, [rootRef, suggestions]);
+    return { sparkleHeight, suggestions };
+};
+/**
+ * A helper function that finds the data with suggestions, and
+ * returns the corresponding keys
+ * @param dataState
+ */
+const findSuggestions = (data, count) => {
+    if (count === 0) {
+        return null;
+    }
+    const suggestionsData = data.slice(0, count);
+    return suggestionsData.reduce((suggestions, value, index) => {
+        const key = value.metadata.key;
+        if (index === count - 1) {
+            suggestions.set(key, 'end');
+        }
+        else {
+            suggestions.set(key, true);
+        }
+        return suggestions;
+    }, new Map());
+};
+
+/**
+ * Helper function to only include keys of leaf items.
+ */
+const excludeGroup = (data, keys) => {
+    if (!keys.all) {
+        const groups = data.data
+            .filter((dataMetadata) => {
+            return !dataMetadata.metadata.isLeaf;
+        })
+            .map((dataMetadata) => {
+            return dataMetadata.metadata.key;
+        });
+        const leafOnly = Array.from(keys.keys.values()).filter((key) => {
+            return !groups.includes(key);
+        });
+        return { ...keys, keys: new Set(leafOnly) };
+    }
+    return keys;
+};
+/**
+ * A helper function to make sure specified elem is visible in the specified container
+ */
+const scrollToVisible = (elem, scroller, offset) => {
+    if (elem && scroller) {
+        if (elem.scrollIntoViewIfNeeded) {
+            // for Safari, we'll need the non-standard scrollIntoViewIfNeeded
+            elem.scrollIntoViewIfNeeded();
+        }
+        else {
+            elem.scrollIntoView({ block: 'nearest' });
+        }
+        if (offset > 0) {
+            const scrollerBounds = scroller.getBoundingClientRect();
+            const elemBounds = elem.getBoundingClientRect();
+            const diff = scrollerBounds.top + offset - elemBounds.top;
+            if (diff > 0) {
+                scroller.scrollTop = scroller.scrollTop - diff;
+            }
+        }
+    }
+};
+
+const useSelectionAndNavigation = (currentKey, selectedKeys, selectionMode = 'none', onCurrentKeyChange, onSelectionChange, onItemAction, data, viewportConfig, role = 'grid', scrollToVisibleOffset, rootRef, pendingSelectionCallback, isCurrentItemOverridden, isEmbedded) => {
+    const listRoles = useMemo(() => getListViewRoles(role), [role]);
+    // tracking the anchor key which is used for shift+click selection
+    const anchorKey = useRef();
+    const { currentKeyProps } = useCurrentKey((element) => keyExtractor(element, ITEM_SELECTOR), selectionMode !== 'multiple' || isEmbedded, getPrevNextKey(rootRef.current, currentKey, true, ITEM_SELECTOR), getPrevNextKey(rootRef.current, currentKey, false, ITEM_SELECTOR), undefined, undefined, currentKey, onCurrentKeyChange);
+    const [showFocusRing, focusRingProps] = useCollectionFocusRing(rootRef, ['ArrowUp', 'ArrowDown']);
+    useEffect(() => {
+        if (currentKey != null && rootRef.current) {
+            const elem = findElementByKey(rootRef.current, currentKey, ITEM_SELECTOR);
+            if (elem) {
+                const activeDescendant = rootRef.current.getAttribute('aria-activedescendant');
+                const cell = elem.querySelector(`[role=${listRoles.cell}]`);
+                if (cell && activeDescendant !== cell.id) {
+                    // update aria-activedescendant for screenreader
+                    rootRef.current.setAttribute('aria-activedescendant', cell.id);
+                    // scroll the current item into view only when the current item is updated internally and listview has focus
+                    // or when the collection gesture is 'embedded' if the current item is updated by the app
+                    const hasFocus = rootRef.current?.contains(document.activeElement);
+                    if ((!isCurrentItemOverridden && hasFocus) || isEmbedded) {
+                        const scroller = viewportConfig?.scroller();
+                        const offset = scrollToVisibleOffset ? scrollToVisibleOffset(rootRef.current) : 0;
+                        // make sure item is visible
+                        scrollToVisible(elem, scroller != null ? scroller : rootRef.current, offset);
+                    }
+                }
+            }
+        }
+        // listen to data because the current item would re-render when the virtualizer
+        // is fetching data or updating the data, i.e. the id of current item would be updated,
+        // so the currentKey itself couldn't guarantee the root has latest aria-activedescendant
+    }, [
+        currentKey,
+        data,
+        listRoles.cell,
+        viewportConfig,
+        scrollToVisibleOffset,
+        rootRef,
+        isCurrentItemOverridden,
+        isEmbedded
+    ]);
+    const handleSelectionChange = useCallback((detail) => {
+        if (onSelectionChange) {
+            if (detail.value.all === false && detail.value.keys.size > 0) {
+                // during regular selection, the last key selected by a user gesture is the anchor key
+                anchorKey.current = Array.from(detail.value.keys.values()).pop();
+            }
+            onSelectionChange(detail);
+        }
+    }, [anchorKey, onSelectionChange]);
+    const handleSelectionRangeChange = useCallback((detail) => {
+        if (data && onSelectionChange) {
+            const value = handleSelectionRange(detail, data);
+            if (Array.isArray(value)) {
+                if (detail.eventType === 'shiftSpace') {
+                    // during range selection by shift+space, the first key selected by a user gesture is the anchor key
+                    anchorKey.current = detail.value.start;
+                }
+                else {
+                    // during range selection by shift+click/arrow keys, the last key selected by a user gesture is the anchor key
+                    anchorKey.current = detail.value.end;
+                }
+                if (!isEmbedded) {
+                    onSelectionChange({ value: { all: false, keys: new Set(value) }, target: null });
+                }
+                else {
+                    const keys = addKeys(selectedKeys, value);
+                    onSelectionChange({ value: keys, target: null });
+                }
+            }
+            else {
+                pendingSelectionCallback(detail, value);
+            }
+        }
+    }, [data, isEmbedded, selectedKeys, onSelectionChange, pendingSelectionCallback]);
+    const { selectionProps } = useSelection((element) => {
+        if (element === rootRef.current) {
+            return currentKey === undefined ? null : currentKey;
+        }
+        return keyExtractor(element, ITEM_SELECTOR);
+    }, selectedKeys, isEmbedded ? 'none' : selectionMode, false, 'replace', handleSelectionChange, anchorKey.current, currentKey, (currentKey, isPrev) => getPrevNextKey(rootRef.current, currentKey, isPrev, ITEM_SELECTOR), undefined, (key) => {
+        if (rootRef.current) {
+            const elem = findElementByKey(rootRef.current, key, ITEM_SELECTOR);
+            if (elem) {
+                const scroller = viewportConfig?.scroller();
+                const offset = scrollToVisibleOffset ? scrollToVisibleOffset(rootRef.current) : 0;
+                scrollToVisible(elem, scroller != null ? scroller : rootRef.current, offset);
+            }
+        }
+    }, handleSelectionRangeChange);
+    const { dropDownSelectionProps } = useDropDownSelection((element) => {
+        if (element === rootRef.current) {
+            return currentKey === undefined ? null : currentKey;
+        }
+        return keyExtractor(element, ITEM_SELECTOR);
+    }, selectedKeys, isEmbedded ? selectionMode : 'none', false, (key) => {
+        if (data) {
+            return data.data.findIndex((value) => value.metadata.key === key);
+        }
+        return -1;
+    }, (startIndex, endIndex) => {
+        if (data) {
+            const keys = data.data.map((value) => value.metadata.key);
+            return keys.slice(startIndex, endIndex);
+        }
+        return [];
+    }, (currentKey, isPrev) => getPrevNextKey(rootRef.current, currentKey, isPrev, ITEM_SELECTOR), currentKey, handleSelectionChange, handleSelectionRangeChange);
+    const itemActionProps = useItemAction(currentKey, data, onItemAction, ITEM_SELECTOR, isEmbedded);
+    return {
+        eventProps: mergeProps(currentKeyProps, focusRingProps, selectionProps, itemActionProps, dropDownSelectionProps),
+        showFocusRing,
+        handleSelectionChange
+    };
+};
+const handleSelectionRange = (detail, dataState) => {
+    const keys = dataState.data.map((value) => {
+        return value.metadata.key;
+    });
+    const startIndex = keys.indexOf(detail.value.start);
+    const endIndex = keys.indexOf(detail.value.end);
+    const minIndex = Math.min(startIndex, endIndex);
+    const maxIndex = Math.max(startIndex, endIndex);
+    if (minIndex === -1) {
+        // return a range to fetch so we can find all the keys, maxIndex should not be -1
+        return { offset: 0, count: dataState.totalSize };
+    }
+    else {
+        // range of keys are in the current viewport, return them
+        return keys.slice(minIndex, maxIndex + 1);
+    }
+};
+
+const useFocusTabbableMode = (currentKey, onCurrentKeyChange, allowTabbableMode, rootRef, viewportConfig, scrollToVisibleOffset) => {
+    const pendingCurrentKey = useRef();
+    // ensure current item scroll into view when listview regains focus
+    // unless pendingCurrentKey gets updated to something different than currentKey
+    const focusAndScrollIntoView = useRef(true);
+    const [isCurrentTabbableKey, tabbableModeProps] = useTabbableModeSet(rootRef, (element) => {
+        // we don't want List to go into Tabbable mode when user clicks on expander
+        return isExpander(element) ? null : keyExtractor(element, ITEM_SELECTOR);
+    }, currentKey, onCurrentKeyChange);
+    const handleInitialFocus = useCallback(() => {
+        if (rootRef.current &&
+            onCurrentKeyChange &&
+            (!allowTabbableMode || isCurrentTabbableKey(undefined))) {
+            const firstKey = pendingCurrentKey.current || getFirstVisibleKey(rootRef.current, ITEM_SELECTOR);
+            if (isKeyDefined(firstKey)) {
+                onCurrentKeyChange({ value: firstKey });
+            }
+        }
+    }, [rootRef, onCurrentKeyChange, allowTabbableMode, isCurrentTabbableKey]);
+    const handleFocus = useCallback((event) => {
+        if (isExpander(event.target)) {
+            rootRef.current?.focus();
+            const key = keyExtractor(event.target, ITEM_SELECTOR);
+            if (onCurrentKeyChange && isKeyDefined(key)) {
+                onCurrentKeyChange({ value: key });
+            }
+            return;
+        }
+        if (!isKeyDefined(currentKey)) {
+            onCurrentKeyChange && handleInitialFocus();
+        }
+        else if (rootRef.current) {
+            const elem = findElementByKey(rootRef.current, currentKey, ITEM_SELECTOR);
+            if (elem) {
+                // if currentKey is defined, make sure scroll the current item into view only when listview regains focus
+                // unless pendingCurrentKey gets updated to something different than currentKey
+                if (focusAndScrollIntoView.current) {
+                    const scroller = viewportConfig?.scroller();
+                    const offset = scrollToVisibleOffset ? scrollToVisibleOffset(rootRef.current) : 0;
+                    scrollToVisible(elem, scroller != null ? scroller : rootRef.current, offset);
+                }
+                focusAndScrollIntoView.current = true;
+            }
+            else {
+                // if elem is not found, meaning the currentKey is not valid, we should pick the first item as current item
+                onCurrentKeyChange && handleInitialFocus();
+            }
+        }
+    }, [
+        currentKey,
+        handleInitialFocus,
+        onCurrentKeyChange,
+        scrollToVisibleOffset,
+        viewportConfig,
+        rootRef
+    ]);
+    /**
+     * Need to track pointer down element to set currentItem when initial focus happens
+     */
+    const handlePointerDown = useCallback((event) => {
+        const key = keyExtractor(event.target, ITEM_SELECTOR);
+        if (isKeyDefined(key)) {
+            pendingCurrentKey.current = key;
+            if (key !== currentKey) {
+                focusAndScrollIntoView.current = false;
+            }
+        }
+    }, [currentKey]);
+    return {
+        eventProps: mergeProps(allowTabbableMode ? tabbableModeProps : {}, {
+            onFocus: handleFocus,
+            onPointerDown: handlePointerDown
+        }),
+        isCurrentTabbableKey
+    };
+};
+const isExpander = (elem) => {
+    if (elem.parentElement && elem.parentElement.classList.contains('oj-listview-expander')) {
+        return true;
+    }
+    return false;
+};
+
+/**
+ * This hook converts the new API (i.e. currentItemOverride and onPersistCurrentItem) back to
+ * the old API (i.e. currentKey and onCurrentKeyChange), keeps the internal current item, and
+ * also triggers an update when a new currentItemOverride is passed by the app
+ *
+ * @param currentItemOverride
+ * @param onPersistCurrentItem
+ */
+const useCurrentItemOverride = (currentItemOverride, onPersistCurrentItem) => {
+    // the internal state of current item
+    const [currentItem, setCurrentItem] = useState();
+    // track the currentItemOverride props
+    const currentItemOverrideRef = useRef();
+    // whether the current item is overridden by the app
+    const isCurrentItemOverridden = useRef(false);
+    // if reorder is enabled, need to update the context here when current item is changed
+    const reorderContext = useReorderableContext();
+    // intercept onPersistCurrentItem calls to ensure internal state is updated appropriately
+    const handleCurrentItemChanged = useMemo(() => {
+        return (detail) => {
+            const rowKey = detail.value;
+            setCurrentItem({ rowKey });
+            onPersistCurrentItem?.(detail);
+            if (reorderContext?.currentItemKey != null) {
+                reorderContext.currentItemKey.current = rowKey;
+            }
+        };
+    }, [onPersistCurrentItem, reorderContext?.currentItemKey]);
+    // ensure any new currentItemOverride settings are applied only on that render
+    // (same as how Table handles the changes)
+    if (currentItemOverrideRef.current !== currentItemOverride) {
+        currentItemOverrideRef.current = currentItemOverride;
+        if (currentItem?.rowKey !== currentItemOverride?.rowKey) {
+            isCurrentItemOverridden.current = true;
+            handleCurrentItemChanged({ value: currentItemOverride?.rowKey });
+        }
+    }
+    useEffect(() => {
+        isCurrentItemOverridden.current = false;
+    });
+    return {
+        currentKey: currentItem?.rowKey,
+        onCurrentKeyChange: handleCurrentItemChanged,
+        isCurrentItemOverridden: isCurrentItemOverridden.current
+    };
+};
+
+/**
+ * Component that renders items as a flat list.
+ * In order to maximize performance, only items that are visible in the viewport are rendered.
+ */
+function List({ 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, allowTabbableMode = true, children, data, gridlines, loadingIndicator = defaultLoadingIndicator, currentItemOverride, onPersistCurrentItem, onLoadRange, onSelectionChange, onItemAction, rangeExtractor, role = 'grid', selectedKeys = emptyKeys, selectionMode = 'none', viewportConfig, currentItemVariant, promotedSection, isVirtualized = false, customItemRenderer, scrollToVisibleOffset, testId, scrollerRef, reorderProps, contextMenuTriggerProps, itemPadding, ...props }) {
+    const rootRef = useRef(null);
+    const isFetching = useRef(false);
+    // tracking pending selection key that is not in current data
+    const pendingSelection = useRef();
+    const [active, setActive] = useState(false);
+    const showGridline = (index) => {
+        // show bottom gridlines for each item, and for the last item if specified
+        return (gridlines?.item === 'visible' &&
+            (index + 1 !== data?.totalSize || gridlines?.bottom === 'visible'));
+    };
+    const showGridlineTop = () => {
+        // show the top gridline for the first item
+        return gridlines?.item === 'visible' && gridlines?.top === 'visible';
+    };
+    const ariaMultiSelectable = selectionMode === 'none' ? undefined : selectionMode === 'multiple';
+    const ariaRowCount = data === null ? undefined : data.sizePrecision === 'exact' ? data.totalSize : -1;
+    const classes = classNames([listStyles.base]);
+    const isEmbedded = useCollectionInteractionContext() === 'embedded';
+    const itemVariant = currentItemVariant !== undefined ? currentItemVariant : isEmbedded ? 'highlight' : 'none';
+    const pendingSelectionCallback = useCallback((detail, value) => {
+        if (data) {
+            pendingSelection.current = {
+                detail: detail,
+                range: { offset: data.offset, count: data.data.length }
+            };
+            onLoadRange(value);
+        }
+    }, [data, onLoadRange]);
+    /*****************************************************************************************/
+    /************************************* Load More *****************************************/
+    /*****************************************************************************************/
+    const lastRange = useRef({ offset: 0, count: 0 });
+    const handleLoadRange = useCallback((newRange) => {
+        // check isFetching to avoid multiple load more at the same time (details in JET-68994)
+        if (!isFetching.current ||
+            lastRange.current.offset !== newRange.offset ||
+            lastRange.current.count !== newRange.count) {
+            isFetching.current = true;
+            lastRange.current = newRange;
+            onLoadRange(newRange);
+        }
+    }, [isFetching, onLoadRange]);
+    useEffect(() => {
+        isFetching.current = false;
+        // listen to data because when one of them gets updated, the fetching is done
+    }, [data]);
+    const { currentKey, onCurrentKeyChange, isCurrentItemOverridden } = useCurrentItemOverride(currentItemOverride, onPersistCurrentItem);
+    const { eventProps, showFocusRing, handleSelectionChange } = useSelectionAndNavigation(currentKey, selectedKeys, selectionMode, onCurrentKeyChange, onSelectionChange, onItemAction, data, viewportConfig, role, scrollToVisibleOffset, rootRef, pendingSelectionCallback, isCurrentItemOverridden, isEmbedded);
+    const { eventProps: focusTabbableProps, isCurrentTabbableKey } = useFocusTabbableMode(currentKey, onCurrentKeyChange, allowTabbableMode, rootRef, viewportConfig, scrollToVisibleOffset);
+    if (data && pendingSelection.current !== undefined && onSelectionChange) {
+        const keys = handleSelectionRange(pendingSelection.current.detail, data);
+        if (Array.isArray(keys)) {
+            if (!isEmbedded) {
+                onSelectionChange({ value: { all: false, keys: new Set(keys) }, target: null });
+            }
+            else {
+                const value = addKeys(selectedKeys, keys);
+                onSelectionChange({ value, target: null });
+            }
+        }
+        const range = pendingSelection.current
+            ? pendingSelection.current.range
+            : { offset: data.offset, count: data.data.length };
+        data = adjustDataState(data, range);
+        pendingSelection.current = undefined;
+        onLoadRange(range);
+    }
+    const { sparkleHeight, suggestions } = usePromotedSection(data, promotedSection, rootRef);
+    // TODO: check suggestions before Sparkle would cause a scrolling issue
+    const sparkleIndicator = jsx(Sparkle, { sparkleHeight: sparkleHeight });
+    // returns an ListItemContext based on ItemContext (added metadata and selector)
+    // note the type for ItemContext, this is the context coming from Collection
+    const getItemContext = useCallback((context) => {
+        const dataStateData = context.data;
+        const selectorRenderer = selectionMode === 'multiple'
+            ? () => (jsx(Selector, { onChange: handleSelectionChange, rowKey: dataStateData.metadata.key, selectedKeys: selectedKeys }))
+            : undefined;
+        return {
+            index: context.index,
+            data: dataStateData.data,
+            metadata: dataStateData.metadata,
+            selector: selectorRenderer
+        };
+    }, [selectionMode, selectedKeys, handleSelectionChange]);
+    const ItemComponent = isVirtualized ? ListViewItem : MemoizeListViewItem;
+    const childrenComponent = (context) => {
+        const listItemContext = getItemContext(context);
+        const suggestion = suggestions?.get(listItemContext.metadata.key);
+        const isTabbable = allowTabbableMode && isCurrentTabbableKey(listItemContext.metadata.key);
+        const isFocused = currentKey === listItemContext.metadata.key && !isTabbable;
+        const isActive = isFocused && active;
+        const isSelected = containsKey(selectedKeys, listItemContext.metadata.key);
+        const isFocusRingVisible = isFocused && showFocusRing;
+        const listItemFunc = (ctx, otherProps) => (jsx(ItemComponent, { context: ctx, isFocused: isFocused, isFocusRingVisible: isFocusRingVisible, isActive: isActive, isGridlineVisible: showGridline(listItemContext.index), isSelected: isSelected, isTabbable: allowTabbableMode && isCurrentTabbableKey(listItemContext.metadata.key), role: role, selectionMode: selectionMode, currentItemVariant: itemVariant, padding: itemPadding, ...(suggestion && { suggestion }), ...(listItemContext.index === 0 && { isTopGridlineVisible: showGridlineTop() }), ...otherProps, children: children }, listItemContext.metadata.key));
+        // if customItemRenderer is specified (ExpandableList and GroupedList)
+        // create a custom context with additional info including a function
+        // that helps create the default item component
+        if (customItemRenderer) {
+            const customRendererContext = {
+                listItemContext,
+                isFocused,
+                isFocusRingVisible,
+                isSelected,
+                isTabbable,
+                isActive,
+                defaultListItem: listItemFunc
+            };
+            return customItemRenderer(customRendererContext);
+        }
+        return listItemFunc(listItemContext);
+    };
+    viewportConfig = getViewportConfig(rootRef, viewportConfig);
+    const handleKeyDown = useCallback((event) => {
+        if (event.key === ' ' && isKeyDefined(currentKey) && selectionMode !== 'none') {
+            setActive(true);
+        }
+    }, [currentKey, selectionMode, setActive]);
+    const handleKeyUp = useCallback(() => {
+        setActive(false);
+    }, [setActive]);
+    useImperativeHandle(scrollerRef, () => rootRef.current);
+    // if data is not specified, listview should show loading indicator
+    // todo: replace placeholder with actual SkeletonContainer component (Ash is working on)
+    const testIdProps = useTestId(testId);
+    return (jsx("div", { ...mergeProps(eventProps, focusTabbableProps, contextMenuTriggerProps || {}, reorderProps || {}, {
+            onKeyDown: handleKeyDown,
+            onKeyUp: handleKeyUp
+        }, props), ...testIdProps, role: role, "aria-rowcount": role === 'grid' ? ariaRowCount : undefined, "aria-colcount": role === 'grid' ? 1 : undefined, ref: rootRef, class: classes, tabIndex: 0, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-multiselectable": ariaMultiSelectable, children: data == null ? (loadingIndicator) : isVirtualized ? (jsx(VirtualizedCollection, { data: data, itemSelector: ITEM_SELECTOR, loadMoreIndicator: defaultLoadMoreIndicator, onLoadRange: onLoadRange, rangeExtractor: rangeExtractor, suggestions: sparkleIndicator, viewportConfig: viewportConfig, children: childrenComponent })) : (jsx(LoadMoreCollection, { data: data.data, loadMoreIndicator: defaultLoadMoreIndicator, hasMore: data.sizePrecision === 'atLeast' && data.data.length <= data.totalSize, onLoadMore: () => {
+                data && handleLoadRange({ offset: 0, count: data.data.length + 25 });
+            }, suggestions: sparkleIndicator, viewportConfig: viewportConfig, children: childrenComponent })) }));
+}
+const getViewportConfig = (rootRef, config) => {
+    return (config ?? {
+        scroller: () => {
+            return rootRef.current;
+        }
+    });
+};
+const emptyKeys = { all: false, keys: new Set() };
+const defaultLoadingIndicator = (jsx(SkeletonContainer, { minimumCount: 25, children: () => {
+        return (jsx(Inset, { variant: "listview", children: jsx(Flex, { height: "6x", align: "center", children: jsx(Skeleton, { height: "4x" }) }) }));
+    } }));
+const defaultLoadMoreIndicator = (jsx("div", { class: LOADMORE_STYLE_CLASS, children: jsx(SkeletonContainer, { minimumCount: 3, children: () => {
+            return (jsx(Inset, { variant: "listview", children: jsx(Flex, { height: "6x", align: "center", children: jsx(Skeleton, { height: "4x" }) }) }));
+        } }) }));
+/**
+ * Adjust the DataState as needed if it contains more than needed for the specified range
+ */
+const adjustDataState = (dataState, range) => {
+    if (range) {
+        // prevent range offset from being larger than the data state
+        const safeRangeOffset = Math.min(range.offset, dataState.offset + dataState.totalSize);
+        const diff = safeRangeOffset - dataState.offset;
+        if (diff > 0) {
+            dataState = {
+                offset: safeRangeOffset,
+                data: dataState.data.slice(diff, diff + range.count),
+                totalSize: dataState.totalSize,
+                sizePrecision: dataState.sizePrecision
+            };
+        }
+    }
+    return dataState;
+};
+
+export { List as L, SkeletonContainer as S, excludeGroup as e, scrollToVisible as s };
+//# sourceMappingURL=List-e6886091.js.map