@salt-ds/lab 1.0.0-alpha.7 → 1.0.0-alpha.71

package/dist-cjs/list/VirtualizedList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualizedList.js","sources":["../src/list/VirtualizedList.tsx"],"sourcesContent":["import { makePrefixer, useForkRef, useIdMemo } from \"@salt-ds/core\";\nimport { clsx } from \"clsx\";\nimport {\n  type ForwardedRef,\n  type ReactElement,\n  forwardRef,\n  useRef,\n} from \"react\";\nimport {\n  type CollectionIndexer,\n  type SelectionStrategy,\n  isSelected,\n  useCollectionItems,\n  useImperativeScrollingAPI,\n} from \"../common-hooks\";\nimport { useListHeight } from \"./useListHeight\";\n\nimport { ListItem, ListItemProxy } from \"./ListItem\";\nimport type { ListProps } from \"./listTypes\";\nimport { useList } from \"./useList\";\nimport { type Row, useVirtualization } from \"./useVirtualization\";\n\nimport { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport listCss from \"./List.css\";\n\nconst defaultEmptyMessage = \"No data to display\";\n\nconst withBaseName = makePrefixer(\"saltList\");\n\nexport const VirtualizedList = forwardRef(function List<\n  Item,\n  Selection extends SelectionStrategy = \"default\",\n>(\n  {\n    borderless,\n    children,\n    className,\n    collapsibleHeaders = false,\n    defaultHighlightedIndex: defaultHighlightedIdx,\n    defaultSelected,\n    disabled: listDisabled = false,\n    disableFocus = false,\n    disableTypeToSelect,\n    displayedItemCount = 10,\n    emptyMessage,\n    getItemHeight,\n    getItemId,\n    height,\n    highlightedIndex: highlightedIdxProp,\n    id: idProp,\n    itemGapSize = 0,\n    itemHeight: itemHeightProp,\n    itemTextHighlightPattern,\n    itemToString,\n    maxHeight,\n    maxWidth,\n    minHeight,\n    minWidth,\n    onSelect,\n    onSelectionChange,\n    onHighlight,\n    restoreLastFocus,\n    selected: selectedProp,\n    selectionStrategy,\n    scrollingApiRef,\n    // TODO do we still need these ?\n    selectionKeys,\n    showEmptyMessage = false,\n    source,\n    style: styleProp,\n    stickyHeaders,\n    tabToSelect,\n    width,\n    ...htmlAttributes\n  }: ListProps<Item, Selection>,\n  forwardedRef?: ForwardedRef<HTMLDivElement>,\n) {\n  const targetWindow = useWindow();\n  useComponentCssInjection({\n    testId: \"salt-list\",\n    css: listCss,\n    window: targetWindow,\n  });\n\n  const id = useIdMemo(idProp);\n  const rootRef = useRef<HTMLDivElement>(null);\n  const rowHeightProxyRef = useRef<HTMLDivElement | null>(null);\n\n  const collectionHook = useCollectionItems<Item>({\n    id,\n    label: \"List\",\n    source,\n    children,\n    options: {\n      collapsibleHeaders,\n      getItemId,\n      itemToString,\n    },\n  });\n\n  const { preferredHeight } = useListHeight({\n    borderless,\n    displayedItemCount,\n    height,\n    itemCount: collectionHook.data.length,\n    itemGapSize,\n    itemHeight: itemHeightProp,\n    rowHeightRef: rowHeightProxyRef,\n  });\n  const {\n    focusVisible,\n    highlightedIndex,\n    listControlProps,\n    listHandlers,\n    scrollIntoView,\n    selected,\n  } = useList<Item, Selection>({\n    collapsibleHeaders,\n    collectionHook,\n    containerRef: rootRef,\n    defaultHighlightedIndex: defaultHighlightedIdx,\n    defaultSelected: collectionHook.itemToCollectionItem<\n      Selection,\n      typeof defaultSelected\n    >(defaultSelected),\n    disabled: listDisabled,\n    disableTypeToSelect,\n    highlightedIndex: highlightedIdxProp,\n    label: id,\n    onSelect,\n    onSelectionChange,\n    onHighlight,\n    restoreLastFocus,\n    selected: collectionHook.itemToCollectionItem<\n      Selection,\n      typeof defaultSelected\n    >(selectedProp),\n    selectionStrategy,\n    selectionKeys,\n    stickyHeaders,\n    tabToSelect,\n  });\n\n  // TODO move into useList\n  const {\n    rows: data,\n    contentHeight,\n    onVerticalScroll: onScroll,\n  } = useVirtualization<Item>({\n    viewportRef: rootRef,\n    data: collectionHook.data,\n    itemGapSize,\n  });\n\n  // FIXME: useImperativeScrollingAPI doesn't work when element is not rendered beyond `renderBuffer`\n  // One potential way: pass `scrollIntoView` to `useVirtualization` and update rows before original `scrollIntoView` been called\n  useImperativeScrollingAPI({\n    collectionHook,\n    forwardedRef: scrollingApiRef,\n    scrollableRef: rootRef,\n    scrollIntoView,\n  });\n\n  function addItem(\n    list: ReactElement[],\n    row: Row<Item>,\n    idx: { value: number },\n  ) {\n    const [key, offset, pos, item] = row;\n    const index = pos - 1;\n    list.push(\n      <ListItem\n        aria-setsize={collectionHook.data.length}\n        aria-posinset={pos}\n        className={clsx(className, {\n          saltHighlighted: index === highlightedIndex,\n          saltFocusVisible: focusVisible === index,\n        })}\n        data-idx={index}\n        key={key}\n        data-offset={offset}\n        role=\"option\"\n        selected={isSelected<Item>(selected, item)}\n        id={item.id}\n        style={{\n          transform: `translate3d(0px, ${offset}px, 0px)`,\n        }}\n      >\n        {item.label}\n      </ListItem>,\n    );\n    idx.value += 1;\n  }\n\n  function renderItems(\n    data: Row<Item>[],\n    idx: CollectionIndexer = { value: 0 },\n    end = data.length,\n  ) {\n    const listItems: ReactElement[] = [];\n    while (idx.value < end) {\n      const item = data[idx.value];\n      addItem(listItems, item, idx);\n    }\n    return listItems;\n  }\n\n  function renderEmpty() {\n    if (emptyMessage || showEmptyMessage) {\n      return (\n        <span className={withBaseName(\"empty-message\")}>\n          {emptyMessage ?? defaultEmptyMessage}\n        </span>\n      );\n    }\n    return null;\n  }\n\n  const renderContent = () => {\n    if (data.length) {\n      return renderItems(data);\n    }\n    renderEmpty();\n  };\n\n  const sizeStyles = {\n    \"--list-item-gap\": itemGapSize ? `${itemGapSize}px` : undefined,\n    minWidth,\n    minHeight,\n    width: width ?? \"100%\",\n    height: height ?? \"100%\",\n    maxWidth: maxWidth ?? width,\n    maxHeight: maxHeight ?? preferredHeight,\n  };\n  return (\n    <div\n      {...htmlAttributes}\n      {...listHandlers}\n      {...listControlProps}\n      className={clsx(withBaseName(), className, withBaseName(\"virtualized\"))}\n      id={`${id}`}\n      ref={useForkRef<HTMLDivElement>(rootRef, forwardedRef)}\n      role=\"listbox\"\n      onScroll={onScroll}\n      style={{ ...styleProp, ...sizeStyles }}\n      tabIndex={listDisabled || disableFocus ? undefined : 0}\n    >\n      <div\n        className={withBaseName(\"scrollingContentContainer\")}\n        style={{ height: contentHeight }}\n      >\n        <ListItemProxy ref={rowHeightProxyRef} />\n        {renderContent()}\n      </div>\n    </div>\n  );\n}) as <Item = string, Selection extends SelectionStrategy = \"default\">(\n  props: ListProps<Item, Selection> & {\n    ref?: ForwardedRef<HTMLDivElement>;\n  },\n) => ReactElement<ListProps<Item, Selection>>;\n"],"names":["makePrefixer","forwardRef","List","useWindow","useComponentCssInjection","listCss","useIdMemo","useRef","useCollectionItems","useListHeight","useList","useVirtualization","useImperativeScrollingAPI","jsx","ListItem","clsx","isSelected","data","useForkRef","jsxs","ListItemProxy"],"mappings":"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"}

package/dist-cjs/list/keyset.js

@@ -0,0 +1,40 @@
+'use strict';
+
+class KeySet {
+  constructor(from = 0, to = 0) {
+    this.keys = /* @__PURE__ */ new Map();
+    this.free = [];
+    this.nextKeyValue = 0;
+    this.reset(from, to);
+  }
+  next() {
+    if (this.free.length) {
+      return this.free.pop();
+    }
+    return this.nextKeyValue++;
+  }
+  reset(from, to) {
+    this.keys.forEach((keyValue, rowIndex) => {
+      if (rowIndex < from || rowIndex >= to) {
+        this.free.push(keyValue);
+        this.keys.delete(rowIndex);
+      }
+    });
+    const size = to - from;
+    if (this.keys.size + this.free.length > size) {
+      this.free.length = size - this.keys.size;
+    }
+    for (let rowIndex = from; rowIndex < to; rowIndex++) {
+      if (!this.keys.has(rowIndex)) {
+        const nextKeyValue = this.next();
+        this.keys.set(rowIndex, nextKeyValue);
+      }
+    }
+  }
+  keyFor(rowIndex) {
+    return this.keys.get(rowIndex);
+  }
+}
+
+exports.KeySet = KeySet;
+//# sourceMappingURL=keyset.js.map

package/dist-cjs/list/keyset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyset.js","sources":["../src/list/keyset.ts"],"sourcesContent":["export class KeySet {\n  private keys: Map<number, number>;\n\n  private free: number[];\n\n  private nextKeyValue: number;\n\n  constructor(from = 0, to = 0) {\n    this.keys = new Map<number, number>();\n    this.free = [];\n    this.nextKeyValue = 0;\n    this.reset(from, to);\n  }\n\n  next(): number {\n    if (this.free.length) {\n      return this.free.pop()!;\n    }\n    return this.nextKeyValue++;\n  }\n\n  reset(from: number, to: number) {\n    this.keys.forEach((keyValue, rowIndex) => {\n      if (rowIndex < from || rowIndex >= to) {\n        this.free.push(keyValue);\n        this.keys.delete(rowIndex);\n      }\n    });\n\n    const size = to - from;\n    if (this.keys.size + this.free.length > size) {\n      this.free.length = size - this.keys.size;\n    }\n\n    for (let rowIndex = from; rowIndex < to; rowIndex++) {\n      if (!this.keys.has(rowIndex)) {\n        const nextKeyValue = this.next();\n        this.keys.set(rowIndex, nextKeyValue);\n      }\n    }\n  }\n\n  keyFor(rowIndex: number) {\n    return this.keys.get(rowIndex);\n  }\n}\n"],"names":[],"mappings":";;AAAO,MAAM,MAAO,CAAA;AAAA,EAOlB,WAAY,CAAA,IAAA,GAAO,CAAG,EAAA,EAAA,GAAK,CAAG,EAAA;AAC5B,IAAK,IAAA,CAAA,IAAA,uBAAW,GAAoB,EAAA;AACpC,IAAA,IAAA,CAAK,OAAO,EAAC;AACb,IAAA,IAAA,CAAK,YAAe,GAAA,CAAA;AACpB,IAAK,IAAA,CAAA,KAAA,CAAM,MAAM,EAAE,CAAA;AAAA;AACrB,EAEA,IAAe,GAAA;AACb,IAAI,IAAA,IAAA,CAAK,KAAK,MAAQ,EAAA;AACpB,MAAO,OAAA,IAAA,CAAK,KAAK,GAAI,EAAA;AAAA;AAEvB,IAAA,OAAO,IAAK,CAAA,YAAA,EAAA;AAAA;AACd,EAEA,KAAA,CAAM,MAAc,EAAY,EAAA;AAC9B,IAAA,IAAA,CAAK,IAAK,CAAA,OAAA,CAAQ,CAAC,QAAA,EAAU,QAAa,KAAA;AACxC,MAAI,IAAA,QAAA,GAAW,IAAQ,IAAA,QAAA,IAAY,EAAI,EAAA;AACrC,QAAK,IAAA,CAAA,IAAA,CAAK,KAAK,QAAQ,CAAA;AACvB,QAAK,IAAA,CAAA,IAAA,CAAK,OAAO,QAAQ,CAAA;AAAA;AAC3B,KACD,CAAA;AAED,IAAA,MAAM,OAAO,EAAK,GAAA,IAAA;AAClB,IAAA,IAAI,KAAK,IAAK,CAAA,IAAA,GAAO,IAAK,CAAA,IAAA,CAAK,SAAS,IAAM,EAAA;AAC5C,MAAA,IAAA,CAAK,IAAK,CAAA,MAAA,GAAS,IAAO,GAAA,IAAA,CAAK,IAAK,CAAA,IAAA;AAAA;AAGtC,IAAA,KAAA,IAAS,QAAW,GAAA,IAAA,EAAM,QAAW,GAAA,EAAA,EAAI,QAAY,EAAA,EAAA;AACnD,MAAA,IAAI,CAAC,IAAA,CAAK,IAAK,CAAA,GAAA,CAAI,QAAQ,CAAG,EAAA;AAC5B,QAAM,MAAA,YAAA,GAAe,KAAK,IAAK,EAAA;AAC/B,QAAK,IAAA,CAAA,IAAA,CAAK,GAAI,CAAA,QAAA,EAAU,YAAY,CAAA;AAAA;AACtC;AACF;AACF,EAEA,OAAO,QAAkB,EAAA;AACvB,IAAO,OAAA,IAAA,CAAK,IAAK,CAAA,GAAA,CAAI,QAAQ,CAAA;AAAA;AAEjC;;;;"}

package/dist-cjs/list/useList.js

@@ -0,0 +1,208 @@
+'use strict';
+
+var react = require('react');
+require('@salt-ds/core');
+require('../common-hooks/collectionProvider.js');
+require('../common-hooks/keyUtils.js');
+var useCollapsibleGroups = require('../common-hooks/useCollapsibleGroups.js');
+var listDomUtils = require('../common-hooks/list-dom-utils.js');
+var useKeyboardNavigation = require('../common-hooks/useKeyboardNavigation.js');
+var useSelection = require('../common-hooks/useSelection.js');
+var useTypeahead = require('../common-hooks/useTypeahead.js');
+var useViewportTracking = require('../common-hooks/useViewportTracking.js');
+
+const useList = ({
+  collapsibleHeaders,
+  collectionHook: dataHook,
+  containerRef,
+  contentRef,
+  defaultHighlightedIndex,
+  defaultSelected,
+  disabled,
+  disableAriaActiveDescendant,
+  disableHighlightOnFocus,
+  disableTypeToSelect,
+  highlightedIndex: highlightedIndexProp,
+  label = "",
+  listHandlers: listHandlersProp,
+  onSelect,
+  onSelectionChange,
+  onHighlight,
+  onKeyboardNavigation,
+  onKeyDown,
+  restoreLastFocus,
+  selected,
+  selectionStrategy,
+  selectionKeys,
+  stickyHeaders,
+  tabToSelect
+}) => {
+  const lastSelection = react.useRef(selected || defaultSelected);
+  const handleKeyboardNavigation = (evt, nextIndex) => {
+    var _a, _b;
+    (_b = (_a = selectionHook.listHandlers).onKeyboardNavigation) == null ? void 0 : _b.call(_a, evt, nextIndex);
+    onKeyboardNavigation == null ? void 0 : onKeyboardNavigation(evt, nextIndex);
+  };
+  const handleSelect = react.useCallback(
+    (evt, selectedItem) => {
+      if (onSelect) {
+        if (react.isValidElement(selectedItem.value)) {
+          onSelect(evt, selectedItem.label);
+        } else if (selectedItem.value !== null) {
+          onSelect(evt, selectedItem.value);
+        }
+      }
+    },
+    [onSelect]
+  );
+  const handleSelectionChange = react.useCallback(
+    (evt, selected2) => {
+      if (onSelectionChange) {
+        onSelectionChange(
+          evt,
+          Array.isArray(selected2) ? selected2.map(
+            (s) => react.isValidElement(s.value) ? s.label : s.value
+          ) : selected2 && (react.isValidElement(selected2.value) ? selected2.label : selected2.value)
+        );
+      }
+    },
+    [onSelectionChange]
+  );
+  const {
+    highlightedIndex,
+    listProps: {
+      onKeyDown: navigationKeyDown,
+      onMouseMove: navigationMouseMove,
+      ...navigationControlProps
+    },
+    setHighlightedIndex,
+    ...keyboardHook
+  } = useKeyboardNavigation.useKeyboardNavigation({
+    containerRef,
+    defaultHighlightedIndex,
+    disableHighlightOnFocus,
+    highlightedIndex: highlightedIndexProp,
+    indexPositions: dataHook.data,
+    onHighlight,
+    onKeyboardNavigation: handleKeyboardNavigation,
+    restoreLastFocus,
+    selected: lastSelection.current
+  });
+  const collapsibleHook = useCollapsibleGroups.useCollapsibleGroups({
+    collapsibleHeaders,
+    highlightedIdx: highlightedIndex,
+    collectionHook: dataHook
+  });
+  const selectionHook = useSelection.useSelection({
+    defaultSelected,
+    highlightedIdx: highlightedIndex,
+    indexPositions: dataHook.data,
+    label,
+    onSelect: handleSelect,
+    onSelectionChange: handleSelectionChange,
+    selected,
+    selectionStrategy,
+    selectionKeys,
+    tabToSelect
+  });
+  const { onKeyDown: typeaheadOnKeyDown } = useTypeahead.useTypeahead({
+    disableTypeToSelect,
+    highlightedIdx: highlightedIndex,
+    highlightItemAtIndex: setHighlightedIndex,
+    typeToNavigate: true,
+    items: dataHook.data
+  });
+  const handleKeyDown = react.useCallback(
+    (evt) => {
+      var _a, _b, _c;
+      if (!evt.defaultPrevented) {
+        typeaheadOnKeyDown == null ? void 0 : typeaheadOnKeyDown(evt);
+      }
+      navigationKeyDown(evt);
+      if (!evt.defaultPrevented) {
+        (_b = (_a = selectionHook.listHandlers).onKeyDown) == null ? void 0 : _b.call(_a, evt);
+      }
+      if (!evt.defaultPrevented) {
+        (_c = collapsibleHook == null ? void 0 : collapsibleHook.onKeyDown) == null ? void 0 : _c.call(collapsibleHook, evt);
+      }
+      if (!evt.defaultPrevented) {
+        onKeyDown == null ? void 0 : onKeyDown(evt);
+      }
+    },
+    [
+      collapsibleHook,
+      navigationKeyDown,
+      onKeyDown,
+      selectionHook.listHandlers,
+      typeaheadOnKeyDown
+    ]
+  );
+  const { isScrolling, scrollIntoView } = useViewportTracking.useViewportTracking({
+    containerRef,
+    contentRef,
+    highlightedIdx: highlightedIndex,
+    indexPositions: dataHook.data,
+    stickyHeaders
+  });
+  const handleMouseMove = react.useCallback(
+    (evt) => {
+      if (!isScrolling.current && !disabled) {
+        navigationMouseMove();
+        const idx = listDomUtils.closestListItemIndex(evt.target);
+        if (idx !== highlightedIndex) {
+          const item = dataHook.data[idx];
+          if (!item || item.disabled) {
+            setHighlightedIndex(-1);
+          } else {
+            setHighlightedIndex(idx);
+          }
+        }
+      }
+    },
+    [
+      isScrolling,
+      disabled,
+      setHighlightedIndex,
+      navigationMouseMove,
+      highlightedIndex,
+      dataHook.data
+    ]
+  );
+  const getActiveDescendant = () => {
+    var _a;
+    return highlightedIndex === void 0 || highlightedIndex === -1 || disableAriaActiveDescendant ? void 0 : (_a = dataHook.data[highlightedIndex]) == null ? void 0 : _a.id;
+  };
+  lastSelection.current = selectionHook.selected;
+  const listControlProps = {
+    "aria-activedescendant": getActiveDescendant(),
+    onBlur: navigationControlProps.onBlur,
+    onFocus: navigationControlProps.onFocus,
+    onKeyDown: handleKeyDown,
+    onMouseDownCapture: navigationControlProps.onMouseDownCapture,
+    onMouseLeave: navigationControlProps.onMouseLeave
+  };
+  const listHandlers = listHandlersProp || {
+    onClick: selectionHook.listHandlers.onClick,
+    // MouseEnter would be much better for this. There is a bug in Cypress
+    // wheby it emits spurious MouseEnter (and MouseOver) events around
+    // keypress events, which break many tests.
+    onMouseMove: handleMouseMove
+  };
+  return {
+    focusVisible: keyboardHook.focusVisible,
+    controlledHighlighting: keyboardHook.controlledHighlighting,
+    highlightedIndex,
+    keyboardNavigation: keyboardHook.keyboardNavigation,
+    listHandlers,
+    listItemHeaderHandlers: collapsibleHook,
+    listControlProps,
+    scrollIntoView,
+    selected: selectionHook.selected,
+    setHighlightedIndex,
+    setIgnoreFocus: keyboardHook.setIgnoreFocus,
+    setSelected: selectionHook.setSelected
+  };
+};
+
+exports.useList = useList;
+//# sourceMappingURL=useList.js.map

package/dist-cjs/list/useList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useList.js","sources":["../src/list/useList.ts"],"sourcesContent":["import {\n  type KeyboardEvent,\n  type MouseEvent,\n  isValidElement,\n  useCallback,\n  useRef,\n} from \"react\";\nimport {\n  type CollectionItem,\n  type ListHandlers,\n  type SelectHandler,\n  type SelectionChangeHandler,\n  type SelectionStrategy,\n  closestListItemIndex,\n  type selectedType,\n  useCollapsibleGroups,\n  useKeyboardNavigation,\n  useSelection,\n  useTypeahead,\n  useViewportTracking,\n} from \"../common-hooks\";\n\nimport type {\n  ListControlProps,\n  ListHookProps,\n  ListHookResult,\n} from \"./listTypes\";\n\nexport const useList = <Item, Selection extends SelectionStrategy = \"default\">({\n  collapsibleHeaders,\n  collectionHook: dataHook,\n  containerRef,\n  contentRef,\n  defaultHighlightedIndex,\n  defaultSelected,\n  disabled,\n  disableAriaActiveDescendant,\n  disableHighlightOnFocus,\n  disableTypeToSelect,\n  highlightedIndex: highlightedIndexProp,\n  label = \"\",\n  listHandlers: listHandlersProp,\n  onSelect,\n  onSelectionChange,\n  onHighlight,\n  onKeyboardNavigation,\n  onKeyDown,\n  restoreLastFocus,\n  selected,\n  selectionStrategy,\n  selectionKeys,\n  stickyHeaders,\n  tabToSelect,\n}: ListHookProps<Item, Selection>): ListHookResult<Item, Selection> => {\n  type selectedItem = selectedType<Item, Selection>;\n\n  const lastSelection = useRef<typeof selected>(selected || defaultSelected);\n  const handleKeyboardNavigation = (\n    evt: KeyboardEvent<HTMLElement>,\n    nextIndex: number,\n  ) => {\n    selectionHook.listHandlers.onKeyboardNavigation?.(evt, nextIndex);\n    onKeyboardNavigation?.(evt, nextIndex);\n  };\n\n  // TODO where do these belong ?\n  const handleSelect = useCallback<SelectHandler<CollectionItem<Item>>>(\n    (evt, selectedItem) => {\n      if (onSelect) {\n        if (isValidElement(selectedItem.value)) {\n          onSelect(evt, selectedItem.label as any);\n        } else if (selectedItem.value !== null) {\n          onSelect(evt, selectedItem.value);\n        }\n      }\n    },\n    [onSelect],\n  );\n\n  const handleSelectionChange = useCallback<\n    SelectionChangeHandler<CollectionItem<Item>, Selection>\n  >(\n    (evt, selected) => {\n      if (onSelectionChange) {\n        onSelectionChange(\n          evt,\n          Array.isArray(selected)\n            ? (selected.map((s) =>\n                isValidElement(s.value) ? s.label : s.value,\n              ) as selectedItem)\n            : selected &&\n                ((isValidElement(selected.value)\n                  ? selected.label\n                  : selected.value) as any),\n        );\n      }\n    },\n    [onSelectionChange],\n  );\n\n  const {\n    highlightedIndex,\n    listProps: {\n      onKeyDown: navigationKeyDown,\n      onMouseMove: navigationMouseMove,\n      ...navigationControlProps\n    },\n    setHighlightedIndex,\n    ...keyboardHook\n  } = useKeyboardNavigation<Item, Selection>({\n    containerRef,\n    defaultHighlightedIndex,\n    disableHighlightOnFocus,\n    highlightedIndex: highlightedIndexProp,\n    indexPositions: dataHook.data,\n    label,\n    onHighlight,\n    onKeyboardNavigation: handleKeyboardNavigation,\n    restoreLastFocus,\n    selected: lastSelection.current,\n  });\n\n  const collapsibleHook = useCollapsibleGroups({\n    collapsibleHeaders,\n    highlightedIdx: highlightedIndex,\n    collectionHook: dataHook,\n  });\n\n  const selectionHook = useSelection<Item, Selection>({\n    defaultSelected,\n    highlightedIdx: highlightedIndex,\n    indexPositions: dataHook.data,\n    label,\n    onSelect: handleSelect,\n    onSelectionChange: handleSelectionChange,\n    selected,\n    selectionStrategy,\n    selectionKeys,\n    tabToSelect,\n  });\n\n  const { onKeyDown: typeaheadOnKeyDown } = useTypeahead<Item>({\n    disableTypeToSelect,\n    highlightedIdx: highlightedIndex,\n    highlightItemAtIndex: setHighlightedIndex,\n    typeToNavigate: true,\n    items: dataHook.data,\n  });\n\n  const handleKeyDown = useCallback(\n    (evt: KeyboardEvent<HTMLElement>) => {\n      if (!evt.defaultPrevented) {\n        typeaheadOnKeyDown?.(evt);\n      }\n      // We still let the keyboard navigation hook process the event even\n      // if it has been handled by the typeahead hook. That is so it can\n      // correctly manage the focusVisible state.\n      navigationKeyDown(evt);\n      if (!evt.defaultPrevented) {\n        selectionHook.listHandlers.onKeyDown?.(evt);\n      }\n      if (!evt.defaultPrevented) {\n        collapsibleHook?.onKeyDown?.(evt);\n      }\n\n      if (!evt.defaultPrevented) {\n        onKeyDown?.(evt);\n      }\n    },\n    [\n      collapsibleHook,\n      navigationKeyDown,\n      onKeyDown,\n      selectionHook.listHandlers,\n      typeaheadOnKeyDown,\n    ],\n  );\n\n  // This is only appropriate when we are directly controlling a List,\n  // not when a control is manipulating the list\n  const { isScrolling, scrollIntoView } = useViewportTracking({\n    containerRef,\n    contentRef,\n    highlightedIdx: highlightedIndex,\n    indexPositions: dataHook.data,\n    stickyHeaders,\n  });\n\n  const handleMouseMove = useCallback(\n    (evt: MouseEvent) => {\n      if (!isScrolling.current && !disabled) {\n        navigationMouseMove();\n        const idx = closestListItemIndex(evt.target as HTMLElement);\n        if (idx !== highlightedIndex) {\n          const item = dataHook.data[idx];\n          if (!item || item.disabled) {\n            setHighlightedIndex(-1);\n          } else {\n            setHighlightedIndex(idx);\n          }\n        }\n      }\n    },\n    [\n      isScrolling,\n      disabled,\n      setHighlightedIndex,\n      navigationMouseMove,\n      highlightedIndex,\n      dataHook.data,\n    ],\n  );\n\n  const getActiveDescendant = () =>\n    highlightedIndex === undefined ||\n    highlightedIndex === -1 ||\n    disableAriaActiveDescendant\n      ? undefined\n      : dataHook.data[highlightedIndex]?.id;\n\n  // We need this on reEntry for navigation hook to handle focus\n  lastSelection.current = selectionHook.selected;\n\n  // controlProps ?\n  const listControlProps: ListControlProps = {\n    \"aria-activedescendant\": getActiveDescendant(),\n    onBlur: navigationControlProps.onBlur,\n    onFocus: navigationControlProps.onFocus,\n    onKeyDown: handleKeyDown,\n    onMouseDownCapture: navigationControlProps.onMouseDownCapture,\n    onMouseLeave: navigationControlProps.onMouseLeave,\n  };\n\n  const listHandlers: ListHandlers = listHandlersProp || {\n    onClick: selectionHook.listHandlers.onClick,\n    // MouseEnter would be much better for this. There is a bug in Cypress\n    // wheby it emits spurious MouseEnter (and MouseOver) events around\n    // keypress events, which break many tests.\n    onMouseMove: handleMouseMove,\n  };\n\n  return {\n    focusVisible: keyboardHook.focusVisible,\n    controlledHighlighting: keyboardHook.controlledHighlighting,\n    highlightedIndex,\n    keyboardNavigation: keyboardHook.keyboardNavigation,\n    listHandlers,\n    listItemHeaderHandlers: collapsibleHook,\n    listControlProps,\n    scrollIntoView,\n    selected: selectionHook.selected,\n    setHighlightedIndex,\n    setIgnoreFocus: keyboardHook.setIgnoreFocus,\n    setSelected: selectionHook.setSelected,\n  };\n};\n"],"names":["useRef","useCallback","isValidElement","selected","useKeyboardNavigation","useCollapsibleGroups","useSelection","useTypeahead","useViewportTracking","closestListItemIndex"],"mappings":"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"}

package/dist-cjs/list/useListHeight.js

@@ -0,0 +1,53 @@
+'use strict';
+
+var react = require('react');
+require('@salt-ds/core');
+require('react/jsx-runtime');
+var useResizeObserver = require('../responsive/useResizeObserver.js');
+
+const useListHeight = ({
+  borderless,
+  displayedItemCount,
+  getItemHeight,
+  // TODO no need to incur the cost of a resizeObserver if height is explicit
+  height,
+  itemCount,
+  itemGapSize,
+  itemHeight: itemHeightProp,
+  rowHeightRef
+}) => {
+  const [measuredItemHeight, setMeasuredItemHeight] = react.useState(36);
+  const preferredHeight = react.useMemo(() => {
+    let result = borderless ? 0 : 2;
+    const itemHeight = itemHeightProp ?? measuredItemHeight;
+    const preferredItemCount = Math.min(displayedItemCount, itemCount) || displayedItemCount;
+    if (typeof getItemHeight === "function") {
+      result += Array(preferredItemCount).fill(0).reduce(
+        (total, _, index) => total + getItemHeight(index) + itemGapSize,
+        0
+      ) - // We don't want gap after the last item
+      itemGapSize;
+    } else {
+      result += preferredItemCount * Number(itemHeight) + (preferredItemCount - 1) * itemGapSize;
+    }
+    return Number.isNaN(result) ? void 0 : result;
+  }, [
+    borderless,
+    displayedItemCount,
+    getItemHeight,
+    itemCount,
+    itemGapSize,
+    itemHeightProp,
+    measuredItemHeight
+  ]);
+  const handleRowHeight = react.useCallback(({ height: height2 }) => {
+    setMeasuredItemHeight(height2);
+  }, []);
+  useResizeObserver.useResizeObserver(rowHeightRef, useResizeObserver.HeightOnly, handleRowHeight, true);
+  return {
+    preferredHeight
+  };
+};
+
+exports.useListHeight = useListHeight;
+//# sourceMappingURL=useListHeight.js.map

package/dist-cjs/list/useListHeight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListHeight.js","sources":["../src/list/useListHeight.ts"],"sourcesContent":["import { type RefObject, useCallback, useMemo, useState } from \"react\";\nimport {\n  HeightOnly,\n  type ResizeHandler,\n  useResizeObserver,\n} from \"../responsive\";\n\nexport interface ListHeightHookProps {\n  borderless?: boolean;\n  displayedItemCount: number;\n  getItemHeight?: (index: number) => number;\n  height?: number | string;\n  itemCount: number;\n  itemGapSize: number;\n  itemHeight?: number | string;\n  rowHeightRef: RefObject<HTMLElement | null>;\n}\n\nexport interface HeightHookResult {\n  preferredHeight: number | undefined;\n}\n\nexport const useListHeight = ({\n  borderless,\n  displayedItemCount,\n  getItemHeight,\n  // TODO no need to incur the cost of a resizeObserver if height is explicit\n  height,\n  itemCount,\n  itemGapSize,\n  itemHeight: itemHeightProp,\n  rowHeightRef,\n}: ListHeightHookProps): HeightHookResult => {\n  // TODO default by density\n  const [measuredItemHeight, setMeasuredItemHeight] = useState<\n    number | undefined\n  >(36);\n\n  const preferredHeight = useMemo(() => {\n    let result = borderless ? 0 : 2;\n    const itemHeight = itemHeightProp ?? measuredItemHeight;\n\n    // if there are 0 items we render with the preferred count\n    const preferredItemCount =\n      Math.min(displayedItemCount, itemCount) || displayedItemCount;\n\n    if (typeof getItemHeight === \"function\") {\n      result +=\n        Array(preferredItemCount)\n          .fill(0)\n          .reduce<number>(\n            (total, _, index) => total + getItemHeight(index) + itemGapSize,\n            0,\n          ) -\n        // We don't want gap after the last item\n        itemGapSize;\n    } else {\n      result +=\n        preferredItemCount * Number(itemHeight) +\n        (preferredItemCount - 1) * itemGapSize;\n    }\n\n    // list height will be undefined if the item height can not be\n    // converted to a number, for example rem or a percentage string\n    return Number.isNaN(result) ? undefined : result;\n  }, [\n    borderless,\n    displayedItemCount,\n    getItemHeight,\n    itemCount,\n    itemGapSize,\n    itemHeightProp,\n    measuredItemHeight,\n  ]);\n\n  const handleRowHeight: ResizeHandler = useCallback(({ height }) => {\n    setMeasuredItemHeight(height);\n  }, []);\n\n  useResizeObserver(rowHeightRef, HeightOnly, handleRowHeight, true);\n\n  return {\n    preferredHeight,\n  };\n};\n"],"names":["useState","useMemo","useCallback","height","useResizeObserver","HeightOnly"],"mappings":";;;;;;;AAsBO,MAAM,gBAAgB,CAAC;AAAA,EAC5B,UAAA;AAAA,EACA,kBAAA;AAAA,EACA,aAAA;AAAA;AAAA,EAEA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,UAAY,EAAA,cAAA;AAAA,EACZ;AACF,CAA6C,KAAA;AAE3C,EAAA,MAAM,CAAC,kBAAA,EAAoB,qBAAqB,CAAA,GAAIA,eAElD,EAAE,CAAA;AAEJ,EAAM,MAAA,eAAA,GAAkBC,cAAQ,MAAM;AACpC,IAAI,IAAA,MAAA,GAAS,aAAa,CAAI,GAAA,CAAA;AAC9B,IAAA,MAAM,aAAa,cAAkB,IAAA,kBAAA;AAGrC,IAAA,MAAM,kBACJ,GAAA,IAAA,CAAK,GAAI,CAAA,kBAAA,EAAoB,SAAS,CAAK,IAAA,kBAAA;AAE7C,IAAI,IAAA,OAAO,kBAAkB,UAAY,EAAA;AACvC,MAAA,MAAA,IACE,KAAM,CAAA,kBAAkB,CACrB,CAAA,IAAA,CAAK,CAAC,CACN,CAAA,MAAA;AAAA,QACC,CAAC,KAAO,EAAA,CAAA,EAAG,UAAU,KAAQ,GAAA,aAAA,CAAc,KAAK,CAAI,GAAA,WAAA;AAAA,QACpD;AAAA,OACF;AAAA,MAEF,WAAA;AAAA,KACG,MAAA;AACL,MAAA,MAAA,IACE,kBAAqB,GAAA,MAAA,CAAO,UAAU,CAAA,GAAA,CACrC,qBAAqB,CAAK,IAAA,WAAA;AAAA;AAK/B,IAAA,OAAO,MAAO,CAAA,KAAA,CAAM,MAAM,CAAA,GAAI,MAAY,GAAA,MAAA;AAAA,GACzC,EAAA;AAAA,IACD,UAAA;AAAA,IACA,kBAAA;AAAA,IACA,aAAA;AAAA,IACA,SAAA;AAAA,IACA,WAAA;AAAA,IACA,cAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,MAAM,kBAAiCC,iBAAY,CAAA,CAAC,EAAE,MAAA,EAAAC,SAAa,KAAA;AACjE,IAAA,qBAAA,CAAsBA,OAAM,CAAA;AAAA,GAC9B,EAAG,EAAE,CAAA;AAEL,EAAkBC,mCAAA,CAAA,YAAA,EAAcC,4BAAY,EAAA,eAAA,EAAiB,IAAI,CAAA;AAEjE,EAAO,OAAA;AAAA,IACL;AAAA,GACF;AACF;;;;"}

package/dist-cjs/list/useVirtualization.js

@@ -0,0 +1,82 @@
+'use strict';
+
+var core = require('@salt-ds/core');
+var react = require('react');
+var keyset = require('./keyset.js');
+
+const byKey = ([k1], [k2]) => k1 - k2;
+const renderBuffer = 5;
+const useVirtualization = ({
+  viewportRef,
+  data,
+  itemGapSize = 0
+}) => {
+  const viewportMeasures = react.useRef({
+    contentHeight: 1e4,
+    firstVisibleRow: 0,
+    rowCount: 0,
+    rowHeight: 0,
+    scrollPos: 0
+  });
+  const [rows, setRows] = react.useState([]);
+  const keys = react.useMemo(() => new keyset.KeySet(0, 1), []);
+  const updateRows = react.useCallback(
+    (from, to) => {
+      const { rowHeight } = viewportMeasures.current;
+      const rowHeightWithGap = rowHeight + itemGapSize;
+      const lo = Math.max(0, from - renderBuffer);
+      const hi = Math.min(data.length, to + renderBuffer);
+      keys.reset(lo, hi);
+      const newRows = data.slice(lo, hi).map(
+        (value, idx) => [
+          keys.keyFor(idx + lo),
+          (idx + lo) * rowHeightWithGap,
+          idx + lo + 1,
+          value
+        ]
+      ).sort(byKey);
+      setRows(newRows);
+    },
+    [data, itemGapSize, keys]
+  );
+  core.useIsomorphicLayoutEffect(() => {
+    const viewport = viewportMeasures.current;
+    const viewportEl = viewportRef.current;
+    if (viewportEl) {
+      const listItemEl = viewportEl.querySelector(".saltListItem");
+      if (listItemEl) {
+        const { height: viewportHeight } = viewportEl.getBoundingClientRect();
+        const { height: rowHeight } = listItemEl.getBoundingClientRect();
+        viewport.rowHeight = rowHeight;
+        viewport.rowCount = Math.ceil(viewportHeight / rowHeight);
+        viewport.contentHeight = (rowHeight + itemGapSize) * data.length;
+        updateRows(0, viewport.rowCount);
+      }
+    }
+  }, [data, itemGapSize, updateRows, viewportRef]);
+  const handleVerticalScroll = react.useCallback(
+    (e) => {
+      const viewport = viewportMeasures.current;
+      const scrollTop = e.target.scrollTop;
+      if (scrollTop !== viewport.scrollPos) {
+        viewport.scrollPos = scrollTop;
+        const firstRow = Math.floor(scrollTop / viewport.rowHeight);
+        if (firstRow !== viewport.firstVisibleRow) {
+          viewport.firstVisibleRow = firstRow;
+          const from = firstRow;
+          const to = firstRow + viewport.rowCount;
+          updateRows(from, to);
+        }
+      }
+    },
+    [updateRows]
+  );
+  return {
+    rows,
+    contentHeight: viewportMeasures.current.contentHeight,
+    onVerticalScroll: handleVerticalScroll
+  };
+};
+
+exports.useVirtualization = useVirtualization;
+//# sourceMappingURL=useVirtualization.js.map

package/dist-cjs/list/useVirtualization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualization.js","sources":["../src/list/useVirtualization.ts"],"sourcesContent":["import { useIsomorphicLayoutEffect } from \"@salt-ds/core\";\nimport {\n  type RefObject,\n  type UIEvent,\n  useCallback,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { CollectionItem } from \"../common-hooks\";\nimport { KeySet } from \"./keyset\";\n\n/**\n * [ item key, total height before the item, next row index, CollectionItem<Item>]\n * e.g. first item: [0, 0, 1, data[0]]\n */\nexport type Row<Item> = [number, number, number, CollectionItem<Item>];\n\nconst byKey = ([k1]: Row<unknown>, [k2]: Row<unknown>) => k1 - k2;\n\nconst renderBuffer = 5;\n\ninterface VirtualizationHookProps<Item> {\n  viewportRef: RefObject<HTMLElement>;\n  data: CollectionItem<Item>[];\n  itemGapSize?: number;\n}\n\ninterface VirtualizationHookResult<Item> {\n  rows: Row<Item>[];\n  contentHeight: number;\n  onVerticalScroll: (e: UIEvent<HTMLElement>) => void;\n}\n\nexport const useVirtualization = <Item>({\n  viewportRef,\n  data,\n  itemGapSize = 0,\n}: VirtualizationHookProps<Item>): VirtualizationHookResult<Item> => {\n  const viewportMeasures = useRef({\n    contentHeight: 10000,\n    firstVisibleRow: 0,\n    rowCount: 0,\n    rowHeight: 0,\n    scrollPos: 0,\n  });\n  const [rows, setRows] = useState<Row<Item>[]>([]);\n  const keys = useMemo(() => new KeySet(0, 1), []);\n\n  const updateRows = useCallback(\n    (from: number, to: number) => {\n      const { rowHeight } = viewportMeasures.current;\n      const rowHeightWithGap = rowHeight + itemGapSize;\n      const lo = Math.max(0, from - renderBuffer);\n      const hi = Math.min(data.length, to + renderBuffer);\n      keys.reset(lo, hi);\n      const newRows = data\n        .slice(lo, hi)\n        .map(\n          (value, idx) =>\n            [\n              keys.keyFor(idx + lo),\n              (idx + lo) * rowHeightWithGap,\n              idx + lo + 1,\n              value,\n            ] as Row<Item>,\n        )\n        .sort(byKey);\n      setRows(newRows);\n    },\n    [data, itemGapSize, keys],\n  );\n\n  useIsomorphicLayoutEffect(() => {\n    const viewport = viewportMeasures.current;\n    const viewportEl = viewportRef.current;\n    if (viewportEl) {\n      // TODO no reference to ListItem className\n      const listItemEl = viewportEl.querySelector(\".saltListItem\");\n      if (listItemEl) {\n        const { height: viewportHeight } = viewportEl.getBoundingClientRect();\n        const { height: rowHeight } = listItemEl.getBoundingClientRect();\n        viewport.rowHeight = rowHeight;\n        viewport.rowCount = Math.ceil(viewportHeight / rowHeight);\n        viewport.contentHeight = (rowHeight + itemGapSize) * data.length;\n        updateRows(0, viewport.rowCount);\n      }\n    }\n  }, [data, itemGapSize, updateRows, viewportRef]);\n\n  const handleVerticalScroll = useCallback(\n    (e: UIEvent<HTMLElement>) => {\n      const viewport = viewportMeasures.current;\n      // TODO: check `as` cast\n      const scrollTop = (e.target as HTMLElement).scrollTop;\n      if (scrollTop !== viewport.scrollPos) {\n        viewport.scrollPos = scrollTop;\n        const firstRow = Math.floor(scrollTop / viewport.rowHeight);\n        if (firstRow !== viewport.firstVisibleRow) {\n          viewport.firstVisibleRow = firstRow;\n          const from = firstRow;\n          const to = firstRow + viewport.rowCount;\n          updateRows(from, to);\n        }\n      }\n    },\n    [updateRows],\n  );\n\n  return {\n    rows,\n    contentHeight: viewportMeasures.current.contentHeight,\n    onVerticalScroll: handleVerticalScroll,\n  };\n};\n"],"names":["useRef","useState","useMemo","KeySet","useCallback","useIsomorphicLayoutEffect"],"mappings":"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"}

package/dist-cjs/list-deprecated/List.css.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var css_248z = "/* TODO: Should the outer most container being 'wrapper'? */\n.saltListDeprecated-wrapper {\n  /* Color */\n  --list-background: var(--salt-container-primary-background);\n  /* Border */\n  --list-borderColor: var(--salt-container-primary-borderColor);\n  --list-borderStyle: var(--salt-container-borderStyle);\n  --list-borderWidth: var(--salt-size-fixed-100);\n  --list-borderRadius: 0;\n\n  /* Text, Font */\n  /* TODO: Do we necessary want to set this? Should rely on inheritance? */\n  /* --list-fontFamily: var(--salt-typography-fontFamily); */\n\n  /* Misc. */\n  --list-boxShadow: none;\n  --list-disabled-cursor: var(--salt-cursor-disabled);\n}\n\n.saltListDeprecated-wrapper {\n  position: relative;\n}\n\n.saltListDeprecated {\n  /* font-family: var(--list-fontFamily); */\n  overflow-y: auto;\n}\n.saltListDeprecated:focus {\n  outline: none;\n}\n\n.saltListDeprecated-wrapper:not(.saltListDeprecated-borderless) {\n  border-color: var(--list-borderColor);\n  border-style: var(--list-borderStyle);\n  border-width: var(--list-borderWidth);\n  border-radius: var(--list-borderRadius);\n}\n.saltListDeprecated-wrapper {\n  background: var(--list-background);\n  box-shadow: var(--list-boxShadow);\n  position: relative;\n}\n\n.saltListDeprecated-borderless {\n  border: none;\n}\n.saltListDeprecated-disabled {\n  cursor: var(--list-disabled-cursor);\n  /* TODO: Design: Check whether we want things behind the list to actually show through opacity */\n  /* Or instead of using `opacity` in favor of dedicated color setting, on background, border-color, etc. */\n}\n";
+
+module.exports = css_248z;
+//# sourceMappingURL=List.css.js.map

package/dist-cjs/list-deprecated/List.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"List.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist-cjs/list-deprecated/List.js

@@ -0,0 +1,69 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var core = require('@salt-ds/core');
+var react = require('react');
+var ListBase = require('./ListBase.js');
+var ListStateContext = require('./ListStateContext.js');
+var useList = require('./useList.js');
+var useTypeSelect = require('./useTypeSelect.js');
+var DescendantContext = require('./internal/DescendantContext.js');
+
+const ListWithDescendants = react.forwardRef(function ListWithDescendants2(props, ref) {
+  const { items } = react.useContext(DescendantContext.DescendantContext);
+  const { focusedRef, state, helpers, listProps } = useList.useList({
+    source: items.current.length ? items.current : [],
+    ...props
+  });
+  const { highlightedIndex } = state;
+  const { setHighlightedIndex, setFocusVisible } = helpers;
+  const {
+    disabled,
+    disableTypeToSelect,
+    getItemAtIndex,
+    itemCount,
+    itemToString,
+    onKeyDownCapture: onListKeyDownCapture,
+    ...restListProps
+  } = listProps;
+  const { onKeyDownCapture: onTypeSelectKeyDownCapture } = useTypeSelect.useTypeSelect({
+    getItemAtIndex,
+    highlightedIndex,
+    itemCount,
+    itemToString,
+    setFocusVisible,
+    setHighlightedIndex
+  });
+  const setListRef = core.useForkRef(focusedRef, props.listRef);
+  const handleKeyDownCapture = (event) => {
+    if (disabled) {
+      return;
+    }
+    if (onListKeyDownCapture) {
+      onListKeyDownCapture(event);
+    }
+    if (!disableTypeToSelect && onTypeSelectKeyDownCapture) {
+      onTypeSelectKeyDownCapture(event);
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(ListStateContext.ListStateContext.Provider, { value: { state, helpers }, children: /* @__PURE__ */ jsxRuntime.jsx(
+    ListBase.ListBase,
+    {
+      listRef: setListRef,
+      ref,
+      ...restListProps,
+      disabled,
+      getItemAtIndex,
+      itemCount,
+      itemToString,
+      onKeyDownCapture: handleKeyDownCapture
+    }
+  ) });
+});
+const List = react.forwardRef(function List2(props, ref) {
+  const itemsRef = react.useRef([]);
+  return /* @__PURE__ */ jsxRuntime.jsx(DescendantContext.DescendantProvider, { items: itemsRef, children: /* @__PURE__ */ jsxRuntime.jsx(ListWithDescendants, { ref, ...props }) });
+});
+
+exports.List = List;
+//# sourceMappingURL=List.js.map

package/dist-cjs/list-deprecated/List.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"List.js","sources":["../src/list-deprecated/List.tsx"],"sourcesContent":["import { useForkRef } from \"@salt-ds/core\";\n\nimport {\n  type ForwardedRef,\n  type KeyboardEvent,\n  type ReactElement,\n  forwardRef,\n  useContext,\n  useRef,\n} from \"react\";\n\nimport { ListBase, type ListScrollHandles } from \"./ListBase\";\nimport type { ListProps, ListSelectionVariant } from \"./ListProps\";\nimport { ListStateContext } from \"./ListStateContext\";\nimport { useList } from \"./useList\";\nimport { useTypeSelect } from \"./useTypeSelect\";\n\nimport {\n  DescendantContext,\n  DescendantProvider,\n} from \"./internal/DescendantContext\";\n\nconst ListWithDescendants = forwardRef(function ListWithDescendants<\n  Item,\n  Variant extends ListSelectionVariant,\n>(\n  props: ListProps<Item, Variant>,\n  ref?: ForwardedRef<ListScrollHandles<Item>>,\n) {\n  const { items } = useContext(DescendantContext);\n\n  const { focusedRef, state, helpers, listProps } = useList({\n    source: items.current.length ? items.current : [],\n    ...props,\n  });\n\n  const { highlightedIndex } = state;\n  const { setHighlightedIndex, setFocusVisible } = helpers;\n\n  const {\n    disabled,\n    disableTypeToSelect,\n    getItemAtIndex,\n    itemCount,\n    itemToString,\n    onKeyDownCapture: onListKeyDownCapture,\n    ...restListProps\n  } = listProps;\n\n  const { onKeyDownCapture: onTypeSelectKeyDownCapture } = useTypeSelect({\n    getItemAtIndex,\n    highlightedIndex,\n    itemCount,\n    itemToString,\n    setFocusVisible,\n    setHighlightedIndex,\n  });\n\n  const setListRef = useForkRef(focusedRef, props.listRef);\n\n  const handleKeyDownCapture = (event: KeyboardEvent<HTMLDivElement>) => {\n    if (disabled) {\n      return;\n    }\n\n    if (onListKeyDownCapture) {\n      onListKeyDownCapture(event);\n    }\n\n    if (!disableTypeToSelect && onTypeSelectKeyDownCapture) {\n      onTypeSelectKeyDownCapture(event);\n    }\n  };\n\n  return (\n    <ListStateContext.Provider value={{ state, helpers }}>\n      <ListBase\n        listRef={setListRef}\n        ref={ref}\n        {...restListProps}\n        disabled={disabled}\n        getItemAtIndex={getItemAtIndex}\n        itemCount={itemCount}\n        itemToString={itemToString}\n        onKeyDownCapture={handleKeyDownCapture}\n      />\n    </ListStateContext.Provider>\n  );\n}) as <Item, Variant extends ListSelectionVariant>(\n  props: ListProps<Item, Variant> & {\n    ref?: ForwardedRef<ListScrollHandles<Item>>;\n  },\n) => ReactElement<ListProps<Item, Variant>>;\n\nexport const List = forwardRef(function List<\n  Item,\n  Variant extends ListSelectionVariant,\n>(\n  props: ListProps<Item, Variant>,\n  ref?: ForwardedRef<ListScrollHandles<Item>>,\n) {\n  const itemsRef = useRef([]);\n\n  return (\n    <DescendantProvider items={itemsRef}>\n      <ListWithDescendants<Item, Variant> ref={ref} {...props} />\n    </DescendantProvider>\n  );\n}) as <Item = string, Variant extends ListSelectionVariant = \"default\">(\n  props: ListProps<Item, Variant> & {\n    ref?: ForwardedRef<ListScrollHandles<Item>>;\n  },\n) => ReactElement<ListProps<Item, Variant>>;\n"],"names":["forwardRef","ListWithDescendants","useContext","DescendantContext","useList","useTypeSelect","useForkRef","jsx","ListStateContext","ListBase","List","useRef","DescendantProvider"],"mappings":";;;;;;;;;;;AAsBA,MAAM,mBAAsB,GAAAA,gBAAA,CAAW,SAASC,oBAAAA,CAI9C,OACA,GACA,EAAA;AACA,EAAA,MAAM,EAAE,KAAA,EAAU,GAAAC,gBAAA,CAAWC,mCAAiB,CAAA;AAE9C,EAAA,MAAM,EAAE,UAAY,EAAA,KAAA,EAAO,OAAS,EAAA,SAAA,KAAcC,eAAQ,CAAA;AAAA,IACxD,QAAQ,KAAM,CAAA,OAAA,CAAQ,MAAS,GAAA,KAAA,CAAM,UAAU,EAAC;AAAA,IAChD,GAAG;AAAA,GACJ,CAAA;AAED,EAAM,MAAA,EAAE,kBAAqB,GAAA,KAAA;AAC7B,EAAM,MAAA,EAAE,mBAAqB,EAAA,eAAA,EAAoB,GAAA,OAAA;AAEjD,EAAM,MAAA;AAAA,IACJ,QAAA;AAAA,IACA,mBAAA;AAAA,IACA,cAAA;AAAA,IACA,SAAA;AAAA,IACA,YAAA;AAAA,IACA,gBAAkB,EAAA,oBAAA;AAAA,IAClB,GAAG;AAAA,GACD,GAAA,SAAA;AAEJ,EAAA,MAAM,EAAE,gBAAA,EAAkB,0BAA2B,EAAA,GAAIC,2BAAc,CAAA;AAAA,IACrE,cAAA;AAAA,IACA,gBAAA;AAAA,IACA,SAAA;AAAA,IACA,YAAA;AAAA,IACA,eAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,MAAM,UAAa,GAAAC,eAAA,CAAW,UAAY,EAAA,KAAA,CAAM,OAAO,CAAA;AAEvD,EAAM,MAAA,oBAAA,GAAuB,CAAC,KAAyC,KAAA;AACrE,IAAA,IAAI,QAAU,EAAA;AACZ,MAAA;AAAA;AAGF,IAAA,IAAI,oBAAsB,EAAA;AACxB,MAAA,oBAAA,CAAqB,KAAK,CAAA;AAAA;AAG5B,IAAI,IAAA,CAAC,uBAAuB,0BAA4B,EAAA;AACtD,MAAA,0BAAA,CAA2B,KAAK,CAAA;AAAA;AAClC,GACF;AAEA,EACE,uBAAAC,cAAA,CAACC,kCAAiB,QAAjB,EAAA,EAA0B,OAAO,EAAE,KAAA,EAAO,SACzC,EAAA,QAAA,kBAAAD,cAAA;AAAA,IAACE,iBAAA;AAAA,IAAA;AAAA,MACC,OAAS,EAAA,UAAA;AAAA,MACT,GAAA;AAAA,MACC,GAAG,aAAA;AAAA,MACJ,QAAA;AAAA,MACA,cAAA;AAAA,MACA,SAAA;AAAA,MACA,YAAA;AAAA,MACA,gBAAkB,EAAA;AAAA;AAAA,GAEtB,EAAA,CAAA;AAEJ,CAAC,CAAA;AAMM,MAAM,IAAO,GAAAT,gBAAA,CAAW,SAASU,KAAAA,CAItC,OACA,GACA,EAAA;AACA,EAAM,MAAA,QAAA,GAAWC,YAAO,CAAA,EAAE,CAAA;AAE1B,EACE,uBAAAJ,cAAA,CAACK,wCAAmB,KAAO,EAAA,QAAA,EACzB,yCAAC,mBAAmC,EAAA,EAAA,GAAA,EAAW,GAAG,KAAA,EAAO,CAC3D,EAAA,CAAA;AAEJ,CAAC;;;;"}