@salt-ds/lab 1.0.0-alpha.5 → 1.0.0-alpha.51

package/dist-cjs/common-hooks/useSelection.js

@@ -0,0 +1,203 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@salt-ds/core');
+var react = require('react');
+
+const GROUP_SELECTION_NONE = "none";
+const defaultSelectionKeys = ["Enter", " "];
+const isSelectable = (item) => item && item.disabled !== true && item.selectable !== false;
+const byItemIndex = (i1, i2) => {
+  var _a, _b;
+  return ((_a = i1.index) != null ? _a : 0) - ((_b = i2.index) != null ? _b : 0);
+};
+const useSelection = ({
+  defaultSelected,
+  disableSelection = false,
+  highlightedIdx,
+  indexPositions,
+  label = "",
+  onSelect,
+  onSelectionChange,
+  selected: selectedProp,
+  selectionStrategy,
+  selectionKeys = defaultSelectionKeys,
+  tabToSelect
+}) => {
+  const isDeselectable = selectionStrategy === "deselectable";
+  const isMultipleSelect = selectionStrategy === "multiple";
+  const isExtendedSelect = selectionStrategy === "extended";
+  const lastActive = react.useRef(-1);
+  const isSelectionEvent = react.useCallback(
+    (evt) => selectionKeys.includes(evt.key),
+    [selectionKeys]
+  );
+  const emptyValue = react.useCallback(() => {
+    return isMultipleSelect || isExtendedSelect ? [] : null;
+  }, [isMultipleSelect, isExtendedSelect]);
+  const [selected, setSelected] = core.useControlled({
+    controlled: selectedProp,
+    default: defaultSelected != null ? defaultSelected : emptyValue(),
+    name: "UseSelection",
+    state: "selected"
+  });
+  const isItemSelected = react.useCallback(
+    (item) => {
+      return Array.isArray(selected) ? selected.includes(item) : selected === item;
+    },
+    [selected]
+  );
+  const selectDefault = react.useCallback((item) => item, []);
+  const selectDeselectable = react.useCallback(
+    (item) => isItemSelected(item) ? null : item,
+    [isItemSelected]
+  );
+  const selectMultiple = react.useCallback(
+    (item) => {
+      const nextItems = isItemSelected(item) ? selected.filter((i) => i !== item) : selected.concat(item);
+      nextItems.sort(byItemIndex);
+      return nextItems;
+    },
+    [isItemSelected, selected]
+  );
+  const selectRange = react.useCallback(
+    (idx, preserveExistingSelection) => {
+      const currentSelection = preserveExistingSelection ? selected : [];
+      const [lastSelectedItem] = selected.slice(-1);
+      const lastSelectedItemIndex = lastSelectedItem ? indexPositions.indexOf(lastSelectedItem) : 0;
+      const startRegion = Math.min(idx, lastSelectedItemIndex);
+      const endRegion = Math.max(idx, lastSelectedItemIndex);
+      const rangeSelection = indexPositions.slice(startRegion, endRegion + 1);
+      const nextItems = [.../* @__PURE__ */ new Set([...currentSelection, ...rangeSelection])];
+      nextItems.sort(byItemIndex);
+      return nextItems;
+    },
+    [indexPositions, selected]
+  );
+  const selectItemAtIndex = react.useCallback(
+    (evt, idx, item, rangeSelect, preserveExistingSelection) => {
+      let newSelected;
+      if (isMultipleSelect) {
+        newSelected = selectMultiple(item);
+      } else if (isExtendedSelect) {
+        if (preserveExistingSelection && !rangeSelect) {
+          newSelected = selectMultiple(item);
+        } else if (rangeSelect) {
+          newSelected = selectRange(
+            idx,
+            preserveExistingSelection
+          );
+        } else {
+          newSelected = [item];
+        }
+      } else if (isDeselectable) {
+        newSelected = selectDeselectable(item);
+      } else {
+        newSelected = selectDefault(item);
+      }
+      if (newSelected !== selected) {
+        setSelected(newSelected);
+      }
+      onSelect == null ? void 0 : onSelect(evt, item);
+      if (newSelected !== selected) {
+        if (onSelectionChange) {
+          onSelectionChange(evt, newSelected);
+        }
+      }
+    },
+    [
+      isMultipleSelect,
+      isExtendedSelect,
+      isDeselectable,
+      selected,
+      onSelect,
+      selectMultiple,
+      selectRange,
+      selectDeselectable,
+      selectDefault,
+      onSelectionChange
+    ]
+  );
+  const handleKeyDown = react.useCallback(
+    (evt) => {
+      const item = indexPositions[highlightedIdx];
+      if (isSelectable(item)) {
+        if (isSelectionEvent(evt) || tabToSelect && evt.key === "Tab") {
+          if (evt.key !== "Tab") {
+            evt.preventDefault();
+          }
+          selectItemAtIndex(
+            evt,
+            highlightedIdx,
+            item,
+            false,
+            evt.ctrlKey || evt.metaKey
+          );
+          if (isExtendedSelect) {
+            lastActive.current = highlightedIdx;
+          }
+        }
+      }
+    },
+    [
+      indexPositions,
+      highlightedIdx,
+      isSelectionEvent,
+      tabToSelect,
+      selectItemAtIndex,
+      isExtendedSelect
+    ]
+  );
+  const handleKeyboardNavigation = react.useCallback(
+    (evt, currentIndex) => {
+      if (isExtendedSelect && evt.shiftKey) {
+        const item = indexPositions[currentIndex];
+        if (isSelectable(item)) {
+          selectItemAtIndex(evt, currentIndex, item, true);
+        }
+      }
+    },
+    [isExtendedSelect, indexPositions, selectItemAtIndex]
+  );
+  const handleClick = react.useCallback(
+    (evt) => {
+      const item = indexPositions[highlightedIdx];
+      if (!disableSelection && isSelectable(item)) {
+        evt.preventDefault();
+        evt.stopPropagation();
+        selectItemAtIndex(
+          evt,
+          highlightedIdx,
+          item,
+          evt.shiftKey,
+          evt.ctrlKey || evt.metaKey
+        );
+        if (isExtendedSelect) {
+          lastActive.current = highlightedIdx;
+        }
+      }
+    },
+    [
+      disableSelection,
+      isExtendedSelect,
+      highlightedIdx,
+      indexPositions,
+      selectItemAtIndex
+    ]
+  );
+  const listHandlers = {
+    onClick: handleClick,
+    onKeyDown: handleKeyDown,
+    onKeyboardNavigation: handleKeyboardNavigation
+  };
+  return {
+    listHandlers,
+    selected,
+    setSelected
+  };
+};
+
+exports.GROUP_SELECTION_NONE = GROUP_SELECTION_NONE;
+exports.useSelection = useSelection;
+//# sourceMappingURL=useSelection.js.map

package/dist-cjs/common-hooks/useSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection.js","sources":["../src/common-hooks/useSelection.ts"],"sourcesContent":["import { useControlled } from \"@salt-ds/core\";\nimport {\n  type KeyboardEvent,\n  type MouseEvent,\n  useCallback,\n  useRef,\n} from \"react\";\nimport type { CollectionItem } from \"./collectionTypes\";\nimport type {\n  SelectionHookProps,\n  SelectionHookResult,\n  SelectionStrategy,\n  SingleSelectionStrategy,\n} from \"./selectionTypes\";\n\nexport const CHECKBOX = \"checkbox\";\n\nexport const GROUP_SELECTION_NONE = \"none\";\nexport const GROUP_SELECTION_SINGLE = \"single\";\nexport const GROUP_SELECTION_CASCADE = \"cascade\";\n\nexport type GroupSelectionMode = \"none\" | \"single\" | \"cascade\";\n\nconst defaultSelectionKeys = [\"Enter\", \" \"];\n\nconst isSelectable = (item?: CollectionItem<unknown>) =>\n  item && item.disabled !== true && item.selectable !== false;\n\nconst byItemIndex = (\n  i1: CollectionItem<unknown>,\n  i2: CollectionItem<unknown>,\n) => (i1.index ?? 0) - (i2.index ?? 0);\n\nexport const groupSelectionEnabled = (\n  groupSelection: GroupSelectionMode,\n): boolean => groupSelection && groupSelection !== GROUP_SELECTION_NONE;\n\nexport const useSelection = <\n  Item,\n  Selection extends SelectionStrategy = \"default\",\n>({\n  defaultSelected,\n  disableSelection = false,\n  // groupSelection = GROUP_SELECTION_NONE,\n  highlightedIdx,\n  indexPositions,\n  label = \"\",\n  onSelect,\n  onSelectionChange,\n  selected: selectedProp,\n  selectionStrategy,\n  selectionKeys = defaultSelectionKeys,\n  tabToSelect,\n}: SelectionHookProps<Item, Selection>): SelectionHookResult<\n  Item,\n  Selection\n> => {\n  type collectionItem = CollectionItem<Item>;\n\n  const isDeselectable = selectionStrategy === \"deselectable\";\n  const isMultipleSelect = selectionStrategy === \"multiple\";\n  const isExtendedSelect = selectionStrategy === \"extended\";\n\n  const lastActive = useRef(-1);\n\n  const isSelectionEvent = useCallback(\n    (evt: KeyboardEvent) => selectionKeys.includes(evt.key),\n    [selectionKeys],\n  );\n\n  const emptyValue = useCallback(<\n    Item,\n  >(): Selection extends SingleSelectionStrategy\n    ? null\n    : CollectionItem<Item>[] => {\n    type returnType = Selection extends SingleSelectionStrategy\n      ? null\n      : CollectionItem<Item>[];\n    return isMultipleSelect || isExtendedSelect\n      ? ([] as unknown as returnType)\n      : (null as returnType);\n  }, [isMultipleSelect, isExtendedSelect]);\n\n  const [selected, setSelected] = useControlled<\n    Selection extends SingleSelectionStrategy\n      ? CollectionItem<Item> | null\n      : CollectionItem<Item>[]\n  >({\n    controlled: selectedProp,\n    default: defaultSelected ?? emptyValue(),\n    name: \"UseSelection\",\n    state: \"selected\",\n  });\n\n  const isItemSelected = useCallback(\n    (item: collectionItem) => {\n      return Array.isArray(selected)\n        ? selected.includes(item)\n        : selected === item;\n    },\n    [selected],\n  );\n\n  const selectDefault = useCallback((item: collectionItem) => item, []);\n  const selectDeselectable = useCallback(\n    (item: collectionItem) => (isItemSelected(item) ? null : item),\n    [isItemSelected],\n  );\n  const selectMultiple = useCallback(\n    (item: collectionItem) => {\n      const nextItems = isItemSelected(item)\n        ? (selected as collectionItem[]).filter((i) => i !== item)\n        : (selected as collectionItem[]).concat(item);\n      nextItems.sort(byItemIndex);\n      return nextItems;\n    },\n    [isItemSelected, selected],\n  );\n  const selectRange = useCallback(\n    (idx: number, preserveExistingSelection?: boolean) => {\n      const currentSelection = preserveExistingSelection\n        ? (selected as collectionItem[])\n        : ([] as collectionItem[]);\n\n      const [lastSelectedItem] = (selected as collectionItem[]).slice(-1);\n      const lastSelectedItemIndex = lastSelectedItem\n        ? indexPositions.indexOf(lastSelectedItem)\n        : 0;\n\n      const startRegion = Math.min(idx, lastSelectedItemIndex);\n      const endRegion = Math.max(idx, lastSelectedItemIndex);\n      const rangeSelection = indexPositions.slice(startRegion, endRegion + 1);\n      // concat the current selection with a new selection and remove duplicates for overlaps\n      const nextItems = [...new Set([...currentSelection, ...rangeSelection])];\n      nextItems.sort(byItemIndex);\n      return nextItems;\n    },\n    [indexPositions, selected],\n  );\n\n  const selectItemAtIndex = useCallback(\n    (\n      evt: any,\n      idx: number,\n      item: collectionItem,\n      rangeSelect: boolean,\n      preserveExistingSelection?: boolean,\n    ) => {\n      type returnType = Selection extends SingleSelectionStrategy\n        ? CollectionItem<Item> | null\n        : CollectionItem<Item>[];\n      let newSelected: returnType;\n      if (isMultipleSelect) {\n        newSelected = selectMultiple(item) as returnType;\n      } else if (isExtendedSelect) {\n        if (preserveExistingSelection && !rangeSelect) {\n          newSelected = selectMultiple(item) as returnType;\n        } else if (rangeSelect) {\n          newSelected = selectRange(\n            idx,\n            preserveExistingSelection,\n          ) as returnType;\n        } else {\n          newSelected = [item] as returnType;\n        }\n      } else if (isDeselectable) {\n        newSelected = selectDeselectable(item) as returnType;\n      } else {\n        newSelected = selectDefault(item) as returnType;\n      }\n\n      if (newSelected !== selected) {\n        setSelected(newSelected);\n      }\n\n      // We fire onSelect irrespective of whether selection changes\n      onSelect?.(evt, item);\n\n      if (newSelected !== selected) {\n        if (onSelectionChange) {\n          onSelectionChange(evt, newSelected);\n        }\n      }\n    },\n    [\n      isMultipleSelect,\n      isExtendedSelect,\n      isDeselectable,\n      selected,\n      onSelect,\n      selectMultiple,\n      selectRange,\n      selectDeselectable,\n      selectDefault,\n      onSelectionChange,\n    ],\n  );\n\n  const handleKeyDown = useCallback(\n    (evt: KeyboardEvent) => {\n      const item = indexPositions[highlightedIdx];\n      if (isSelectable(item)) {\n        if (isSelectionEvent(evt) || (tabToSelect && evt.key === \"Tab\")) {\n          // We do not inhibit Tab behaviour, if we are selecting on Tab then we apply\n          // selection as a side effect of the Tab, not as a replacement for Tabbing.\n          if (evt.key !== \"Tab\") {\n            evt.preventDefault();\n          }\n          selectItemAtIndex(\n            evt,\n            highlightedIdx,\n            item,\n            false,\n            evt.ctrlKey || evt.metaKey,\n          );\n          if (isExtendedSelect) {\n            lastActive.current = highlightedIdx;\n          }\n        }\n      }\n    },\n    [\n      indexPositions,\n      highlightedIdx,\n      isSelectionEvent,\n      tabToSelect,\n      selectItemAtIndex,\n      isExtendedSelect,\n    ],\n  );\n\n  const handleKeyboardNavigation = useCallback(\n    (evt: KeyboardEvent, currentIndex: number) => {\n      if (isExtendedSelect && evt.shiftKey) {\n        const item = indexPositions[currentIndex];\n        if (isSelectable(item)) {\n          selectItemAtIndex(evt, currentIndex, item, true);\n        }\n      }\n    },\n    [isExtendedSelect, indexPositions, selectItemAtIndex],\n  );\n\n  const handleClick = useCallback(\n    (evt: MouseEvent) => {\n      const item = indexPositions[highlightedIdx];\n      if (!disableSelection && isSelectable(item)) {\n        // if (!isCollapsibleItem(item)) {\n        evt.preventDefault();\n        evt.stopPropagation();\n        selectItemAtIndex(\n          evt,\n          highlightedIdx,\n          item,\n          evt.shiftKey,\n          evt.ctrlKey || evt.metaKey,\n        );\n        if (isExtendedSelect) {\n          lastActive.current = highlightedIdx;\n        }\n        // }\n      }\n    },\n    [\n      disableSelection,\n      isExtendedSelect,\n      highlightedIdx,\n      indexPositions,\n      selectItemAtIndex,\n    ],\n  );\n\n  const listHandlers = {\n    onClick: handleClick,\n    onKeyDown: handleKeyDown,\n    onKeyboardNavigation: handleKeyboardNavigation,\n  };\n\n  return {\n    listHandlers,\n    selected,\n    setSelected,\n  };\n};\n"],"names":["useRef","useCallback","useControlled"],"mappings":"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"}

package/dist-cjs/common-hooks/useTypeahead.js

@@ -0,0 +1,76 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+var keyUtils = require('./keyUtils.js');
+
+const useTypeahead = ({
+  disableTypeToSelect,
+  highlightedIdx,
+  highlightItemAtIndex,
+  typeToNavigate,
+  items,
+  applyIncrementalSearch = true
+}) => {
+  const keyDownTimer = react.useRef(null);
+  const searchChars = react.useRef("");
+  const startIdx = react.useRef(-1);
+  const applySearch = react.useCallback(
+    (intermediateSearch) => {
+      if (intermediateSearch || !applyIncrementalSearch) {
+        const regex = new RegExp(`^${searchChars.current}`, "i");
+        let idx = items.findIndex(
+          ({ label }, i) => i > startIdx.current && regex.test(label)
+        );
+        if (idx === -1) {
+          idx = items.findIndex(
+            ({ label }, i) => i <= startIdx.current && regex.test(label)
+          );
+        }
+        if (idx !== -1) {
+          highlightItemAtIndex(idx);
+        }
+      } else {
+        searchChars.current = "";
+        keyDownTimer.current = null;
+        startIdx.current = -1;
+      }
+    },
+    [applyIncrementalSearch, highlightItemAtIndex, items]
+  );
+  const handleKeyDown = react.useCallback(
+    (e) => {
+      const searchInProgress = startIdx.current !== -1;
+      if (keyUtils.isCharacterKey(e) || searchInProgress && e.key === keyUtils.Space) {
+        if (typeToNavigate) {
+          e.preventDefault();
+          e.stopPropagation();
+          if (startIdx.current === -1 || e.key === searchChars.current) {
+            startIdx.current = highlightedIdx;
+          }
+          if (keyDownTimer.current !== null) {
+            clearTimeout(keyDownTimer.current);
+            keyDownTimer.current = null;
+          }
+          if (e.key !== searchChars.current) {
+            searchChars.current += e.key;
+          }
+          if (applyIncrementalSearch) {
+            applySearch(true);
+          }
+          keyDownTimer.current = window.setTimeout(() => {
+            applySearch();
+          }, 100);
+        }
+      }
+    },
+    [typeToNavigate, applyIncrementalSearch, highlightedIdx, applySearch]
+  );
+  return {
+    onKeyDown: disableTypeToSelect ? void 0 : handleKeyDown
+  };
+};
+
+exports.useTypeahead = useTypeahead;
+//# sourceMappingURL=useTypeahead.js.map

package/dist-cjs/common-hooks/useTypeahead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTypeahead.js","sources":["../src/common-hooks/useTypeahead.ts"],"sourcesContent":["import { type KeyboardEvent, useCallback, useRef } from \"react\";\nimport type { CollectionItem } from \"./collectionTypes\";\nimport { Space, isCharacterKey } from \"./keyUtils\";\n\ninterface TypeaheadHookProps<Item> {\n  disableTypeToSelect?: boolean;\n  highlightedIdx: number;\n  highlightItemAtIndex: (idx: number) => void;\n  applyIncrementalSearch?: boolean;\n  typeToNavigate: boolean;\n  items: CollectionItem<Item>[];\n}\n\ninterface TypeaheadHookResult {\n  onKeyDown?: (e: KeyboardEvent) => void;\n}\n\nexport const useTypeahead = <Item>({\n  disableTypeToSelect,\n  highlightedIdx,\n  highlightItemAtIndex,\n  typeToNavigate,\n  items,\n  applyIncrementalSearch = true,\n}: TypeaheadHookProps<Item>): TypeaheadHookResult => {\n  const keyDownTimer = useRef<number | null>(null);\n  const searchChars = useRef(\"\");\n  const startIdx = useRef(-1);\n\n  const applySearch = useCallback(\n    (intermediateSearch?: true | undefined) => {\n      if (intermediateSearch || !applyIncrementalSearch) {\n        const regex = new RegExp(`^${searchChars.current}`, \"i\");\n        let idx = items.findIndex(\n          ({ label }, i) => i > startIdx.current && regex.test(label!),\n        );\n        if (idx === -1) {\n          idx = items.findIndex(\n            ({ label }, i) => i <= startIdx.current && regex.test(label!),\n          );\n        }\n        if (idx !== -1) {\n          highlightItemAtIndex(idx);\n        }\n      } else {\n        searchChars.current = \"\";\n        keyDownTimer.current = null;\n        startIdx.current = -1;\n      }\n    },\n    [applyIncrementalSearch, highlightItemAtIndex, items],\n  );\n\n  const handleKeyDown = useCallback(\n    (e: KeyboardEvent) => {\n      const searchInProgress = startIdx.current !== -1;\n      if (isCharacterKey(e) || (searchInProgress && e.key === Space)) {\n        if (typeToNavigate) {\n          e.preventDefault();\n          e.stopPropagation();\n          // If we type the same key repeatedly, we cycle through the matches\n          if (startIdx.current === -1 || e.key === searchChars.current) {\n            startIdx.current = highlightedIdx;\n          }\n          if (keyDownTimer.current !== null) {\n            clearTimeout(keyDownTimer.current);\n            keyDownTimer.current = null;\n          }\n          if (e.key !== searchChars.current) {\n            searchChars.current += e.key;\n          }\n          if (applyIncrementalSearch) {\n            applySearch(true);\n          }\n          // keyDownTimer.current = window.setTimeout(applySearch, 100);\n          keyDownTimer.current = window.setTimeout(() => {\n            applySearch();\n          }, 100);\n        }\n      }\n    },\n    [typeToNavigate, applyIncrementalSearch, highlightedIdx, applySearch],\n  );\n\n  return {\n    onKeyDown: disableTypeToSelect ? undefined : handleKeyDown,\n  };\n};\n"],"names":["useRef","useCallback","isCharacterKey","Space"],"mappings":"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"}

package/dist-cjs/common-hooks/useViewportTracking.js

@@ -0,0 +1,136 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@salt-ds/core');
+var react = require('react');
+require('react/jsx-runtime');
+var useResizeObserver = require('../responsive/useResizeObserver.js');
+
+const HeightOnly = ["height"];
+const HeightWithScroll = ["height", "scrollHeight"];
+const EMPTY_ARRAY = [];
+const ObservedDimensions = {
+  containerOnly: [HeightWithScroll, EMPTY_ARRAY],
+  withContent: [HeightOnly, HeightOnly]
+};
+const getObservedDimensions = (containerOnly) => containerOnly ? ObservedDimensions.containerOnly : ObservedDimensions.withContent;
+const NULL_REF = { current: null };
+const getItemTop = (element, offsetContainer) => {
+  const { transform = "none" } = getComputedStyle(element);
+  if (transform.startsWith("matrix")) {
+    const pos = transform.lastIndexOf(",");
+    return Number.parseInt(transform.slice(pos + 1));
+  }
+  let offsetParent = element.offsetParent;
+  if (offsetParent === offsetContainer || offsetContainer === null) {
+    return element.offsetTop;
+  }
+  let top = element.offsetTop;
+  while (offsetParent !== null && offsetParent !== offsetContainer) {
+    top += offsetParent.offsetTop;
+    offsetParent = offsetParent.offsetParent;
+  }
+  return top;
+};
+const useViewportTracking = ({
+  containerRef,
+  contentRef = NULL_REF,
+  highlightedIdx = -1,
+  indexPositions,
+  stickyHeaders = false
+}) => {
+  const scrolling = react.useRef(false);
+  const viewport = react.useRef({
+    height: 0,
+    contentHeight: 0
+  });
+  const scrollTo = react.useCallback(
+    (scrollPos) => {
+      scrolling.current = true;
+      if (containerRef.current) {
+        containerRef.current.scrollTop = scrollPos;
+      }
+      setTimeout(() => {
+        scrolling.current = false;
+      });
+    },
+    [containerRef]
+  );
+  const scrollToStart = react.useCallback(() => scrollTo(0), [scrollTo]);
+  const scrollToEnd = react.useCallback(() => {
+    scrollTo(viewport.current.contentHeight - viewport.current.height);
+  }, [scrollTo]);
+  const scrollIntoViewIfNeeded = react.useCallback(
+    (item) => {
+      const offsetContainer = contentRef.current || containerRef.current;
+      if (item.id) {
+        const el = document.getElementById(item.id);
+        if (el && containerRef.current) {
+          const { height: viewportHeight } = viewport.current;
+          const targetEl = el.ariaExpanded && el.firstChild ? el.firstChild : el;
+          const headerHeight = stickyHeaders ? 36 : 0;
+          const itemTop = getItemTop(targetEl, offsetContainer);
+          const itemHeight = targetEl.offsetHeight;
+          const { scrollTop } = containerRef.current;
+          const viewportStart = scrollTop + headerHeight;
+          const viewportEnd = viewportStart + viewportHeight - headerHeight;
+          if (itemTop + itemHeight > viewportEnd || itemTop < viewportStart) {
+            const newScrollTop = itemTop + itemHeight > viewportEnd ? scrollTop + (itemTop + itemHeight) - viewportEnd : itemTop - headerHeight;
+            scrollTo(newScrollTop);
+          }
+        }
+      }
+    },
+    [containerRef, contentRef, scrollTo, stickyHeaders]
+  );
+  core.useIsomorphicLayoutEffect(() => {
+    const { height, contentHeight } = viewport.current;
+    const item = indexPositions[highlightedIdx];
+    if (contentHeight > height && item) {
+      const [firstItem] = indexPositions;
+      const [lastItem] = indexPositions.slice(-1);
+      if (item === firstItem) {
+        scrollToStart();
+      } else if (item === lastItem) {
+        scrollToEnd();
+      } else {
+        scrollIntoViewIfNeeded(indexPositions[highlightedIdx]);
+      }
+    }
+  }, [
+    highlightedIdx,
+    indexPositions,
+    scrollIntoViewIfNeeded,
+    scrollToEnd,
+    scrollToStart
+  ]);
+  const onContainerResize = react.useCallback(
+    ({ height, scrollHeight }) => {
+      if (typeof height === "number") {
+        viewport.current.height = height;
+      }
+      if (typeof scrollHeight === "number") {
+        viewport.current.contentHeight = scrollHeight;
+      }
+    },
+    []
+  );
+  const onContentResize = react.useCallback(({ height }) => {
+    if (typeof height === "number") {
+      viewport.current.contentHeight = height;
+    }
+  }, []);
+  const [containerDimensions, contentDimensions] = getObservedDimensions(
+    contentRef === NULL_REF
+  );
+  useResizeObserver.useResizeObserver(containerRef, containerDimensions, onContainerResize, true);
+  useResizeObserver.useResizeObserver(contentRef, contentDimensions, onContentResize, true);
+  return {
+    isScrolling: scrolling,
+    scrollIntoView: scrollIntoViewIfNeeded
+  };
+};
+
+exports.useViewportTracking = useViewportTracking;
+//# sourceMappingURL=useViewportTracking.js.map

package/dist-cjs/common-hooks/useViewportTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewportTracking.js","sources":["../src/common-hooks/useViewportTracking.ts"],"sourcesContent":["import { useIsomorphicLayoutEffect } from \"@salt-ds/core\";\nimport {\n  type MutableRefObject,\n  type RefObject,\n  useCallback,\n  useRef,\n} from \"react\";\nimport { type ResizeHandler, useResizeObserver } from \"../responsive\";\nimport type { CollectionItem } from \"./collectionTypes\";\n\nconst HeightOnly = [\"height\"];\nconst HeightWithScroll = [\"height\", \"scrollHeight\"];\nconst EMPTY_ARRAY: any[] = [];\n\nconst ObservedDimensions = {\n  containerOnly: [HeightWithScroll, EMPTY_ARRAY],\n  withContent: [HeightOnly, HeightOnly],\n};\nconst getObservedDimensions = (containerOnly: boolean) =>\n  containerOnly\n    ? ObservedDimensions.containerOnly\n    : ObservedDimensions.withContent;\n\nconst NULL_REF = { current: null };\n\nconst getItemTop = (\n  element: HTMLElement,\n  offsetContainer: HTMLElement | null,\n) => {\n  const { transform = \"none\" } = getComputedStyle(element);\n  if (transform.startsWith(\"matrix\")) {\n    const pos = transform.lastIndexOf(\",\");\n    return Number.parseInt(transform.slice(pos + 1));\n  }\n  let offsetParent = element.offsetParent as HTMLElement;\n  if (offsetParent === offsetContainer || offsetContainer === null) {\n    return element.offsetTop;\n  }\n  let top = element.offsetTop;\n  while (offsetParent !== null && offsetParent !== offsetContainer) {\n    top += offsetParent.offsetTop;\n    offsetParent = offsetParent.offsetParent as HTMLElement;\n  }\n  return top;\n};\n\nexport interface ViewportTrackingProps<Item> {\n  containerRef: RefObject<HTMLElement>;\n  contentRef?: RefObject<HTMLElement>;\n  highlightedIdx?: number;\n  indexPositions: CollectionItem<Item>[];\n  stickyHeaders?: boolean;\n}\n\nexport interface ViewportTrackingResult<Item> {\n  isScrolling: MutableRefObject<boolean>;\n  scrollIntoView: (item: CollectionItem<Item>) => void;\n}\n\nexport const useViewportTracking = <Item>({\n  containerRef,\n  contentRef = NULL_REF,\n  highlightedIdx = -1,\n  indexPositions,\n  stickyHeaders = false,\n}: ViewportTrackingProps<Item>): ViewportTrackingResult<Item> => {\n  const scrolling = useRef<boolean>(false);\n  const viewport = useRef({\n    height: 0,\n    contentHeight: 0,\n  });\n\n  const scrollTo = useCallback(\n    (scrollPos: number) => {\n      scrolling.current = true;\n      if (containerRef.current) {\n        containerRef.current.scrollTop = scrollPos;\n      }\n      setTimeout(() => {\n        scrolling.current = false;\n      });\n    },\n    [containerRef],\n  );\n\n  const scrollToStart = useCallback(() => scrollTo(0), [scrollTo]);\n\n  const scrollToEnd = useCallback(() => {\n    scrollTo(viewport.current.contentHeight - viewport.current.height);\n  }, [scrollTo]);\n\n  const scrollIntoViewIfNeeded = useCallback(\n    (item: CollectionItem<Item>) => {\n      const offsetContainer = contentRef.current || containerRef.current;\n      if (item.id) {\n        const el = document.getElementById(item.id);\n        if (el && containerRef.current) {\n          const { height: viewportHeight } = viewport.current;\n          const targetEl =\n            el.ariaExpanded && el.firstChild\n              ? (el.firstChild as HTMLElement)\n              : el;\n          const headerHeight = stickyHeaders ? 36 : 0;\n          const itemTop = getItemTop(targetEl, offsetContainer);\n          const itemHeight = targetEl.offsetHeight;\n          const { scrollTop } = containerRef.current;\n          const viewportStart = scrollTop + headerHeight;\n          const viewportEnd = viewportStart + viewportHeight - headerHeight;\n\n          if (itemTop + itemHeight > viewportEnd || itemTop < viewportStart) {\n            const newScrollTop =\n              itemTop + itemHeight > viewportEnd\n                ? scrollTop + (itemTop + itemHeight) - viewportEnd\n                : itemTop - headerHeight;\n\n            scrollTo(newScrollTop);\n          }\n        }\n      }\n    },\n    [containerRef, contentRef, scrollTo, stickyHeaders],\n  );\n\n  useIsomorphicLayoutEffect(() => {\n    const { height, contentHeight } = viewport.current;\n    const item = indexPositions[highlightedIdx];\n    if (contentHeight > height && item) {\n      const [firstItem] = indexPositions;\n      const [lastItem] = indexPositions.slice(-1);\n      if (item === firstItem) {\n        scrollToStart();\n      } else if (item === lastItem) {\n        scrollToEnd();\n      } else {\n        scrollIntoViewIfNeeded(indexPositions[highlightedIdx]);\n      }\n    }\n  }, [\n    highlightedIdx,\n    indexPositions,\n    scrollIntoViewIfNeeded,\n    scrollToEnd,\n    scrollToStart,\n  ]);\n\n  const onContainerResize: ResizeHandler = useCallback(\n    ({ height, scrollHeight }) => {\n      if (typeof height === \"number\") {\n        viewport.current.height = height;\n      }\n      if (typeof scrollHeight === \"number\") {\n        viewport.current.contentHeight = scrollHeight;\n      }\n    },\n    [],\n  );\n\n  const onContentResize: ResizeHandler = useCallback(({ height }) => {\n    if (typeof height === \"number\") {\n      viewport.current.contentHeight = height;\n    }\n  }, []);\n\n  // If we only have a container, then we will observe its height and scrollHeight,\n  // contentRef will be null, so second call to observer will observe nothing.\n  // If we have both container and content, then we observe the height of each.\n  const [containerDimensions, contentDimensions] = getObservedDimensions(\n    contentRef === NULL_REF,\n  );\n  useResizeObserver(containerRef, containerDimensions, onContainerResize, true);\n  useResizeObserver(contentRef, contentDimensions, onContentResize, true);\n\n  return {\n    isScrolling: scrolling,\n    scrollIntoView: scrollIntoViewIfNeeded,\n  };\n};\n"],"names":["useRef","useCallback","useIsomorphicLayoutEffect","useResizeObserver"],"mappings":"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"}

package/dist-cjs/common-hooks/utils/collection-item-utils.js

@@ -0,0 +1,186 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var react = require('react');
+var ListItemGroup = require('../../list/ListItemGroup.js');
+var ListItemHeader = require('../../list/ListItemHeader.js');
+var itemToString = require('../itemToString.js');
+
+const sourceItemHasProp = (item, propertyName) => {
+  return item !== null && Object.prototype.hasOwnProperty.call(item, propertyName);
+};
+const isHeader = (item) => sourceItemHasProp(item, "header");
+const isGroupNode = (item) => sourceItemHasProp(item, "childNodes");
+const childItemHasProp = (item, propertyName) => {
+  return item && Object.prototype.hasOwnProperty.call(item.props, propertyName);
+};
+const isDisabled = (item) => {
+  if (react.isValidElement(item)) {
+    if (childItemHasProp(item, "disabled")) {
+      return item.props.disabled === true;
+    }
+  } else if (sourceItemHasProp(item, "disabled")) {
+    return item.disabled === true;
+  }
+  return false;
+};
+const isFocusable = (item) => {
+  if (react.isValidElement(item)) {
+    if (childItemHasProp(item, "focusable")) {
+      return item.props.focusable;
+    }
+  }
+  return true;
+};
+const countChildItems = (item, items, idx) => {
+  if (item.childNodes) {
+    return item.childNodes.length;
+  }
+  if (item.header) {
+    let i = idx + 1;
+    let count = 0;
+    while (i < items.length && !items[i].header) {
+      count++;
+      i++;
+    }
+    return count;
+  }
+  return 0;
+};
+const getChildLabel = (element) => {
+  if (typeof element.props.children === "string") {
+    return element.props.children;
+  }
+  if (element.props.title) {
+    return element.props.title;
+  }
+  if (element.props.label) {
+    return element.props.label;
+  }
+};
+const childIsHeader = (child) => child.type === ListItemHeader.ListItemHeader || childItemHasProp(child, "data-header");
+const childIsGroup = (child) => child.type === ListItemGroup.ListItemGroup || childItemHasProp(child, "data-group");
+const childIsSelectable = (child) => {
+  if (childItemHasProp(child, "selectable")) {
+    return child.props.selectable === true;
+  }
+  return !childIsGroup(child) && !childIsHeader(child);
+};
+const getChildNodes = (element) => {
+  if (childIsGroup(element)) {
+    const {
+      props: { children }
+    } = element;
+    if (typeof children !== "string") {
+      return childItems(children);
+    }
+  }
+};
+const mapReactElementChildren = (children, fn) => {
+  const childElements = [];
+  react.Children.forEach(children, (child) => {
+    if (react.isValidElement(child)) {
+      childElements.push(fn(child));
+    }
+  });
+  return childElements;
+};
+const sourceItems = (source, options) => {
+  if (Array.isArray(source)) {
+    if (source.length === 0 && (options == null ? void 0 : options.noChildrenLabel)) {
+      return [
+        {
+          label: options.noChildrenLabel,
+          value: null
+        }
+      ];
+    }
+    return source.map(
+      (item, index) => {
+        var _a, _b;
+        return {
+          childNodes: sourceItems(
+            item.childNodes,
+            options
+          ),
+          description: item.description,
+          expanded: item.expanded,
+          value: item,
+          label: (_b = (_a = options == null ? void 0 : options.itemToString) == null ? void 0 : _a.call(options, item)) != null ? _b : itemToString.itemToString(item)
+        };
+      }
+    );
+  }
+  if (source) {
+    throw Error("list-child-items expects source to be an array");
+  }
+};
+const childItems = (children) => {
+  if (children) {
+    return mapReactElementChildren(children, (child) => {
+      const {
+        "data-id": dataId,
+        disabled,
+        id = dataId,
+        "data-expanded": dataExpanded,
+        expanded = dataExpanded
+      } = child.props;
+      return {
+        childNodes: getChildNodes(child),
+        disabled,
+        expanded,
+        header: childIsHeader(child),
+        id,
+        label: getChildLabel(child),
+        selectable: childIsSelectable(child),
+        value: child
+      };
+    });
+  }
+};
+const PathSeparators = /* @__PURE__ */ new Set(["/", "-", "."]);
+const isPathSeparator = (char) => PathSeparators.has(char);
+const isParentPath = (parentPath, childPath) => childPath.startsWith(parentPath) && isPathSeparator(childPath[parentPath.length]);
+const PATH_SEPARATORS = /* @__PURE__ */ new Set([".", "/"]);
+function isDescendantOf(basePath, targetPath) {
+  if (!targetPath.startsWith(basePath)) {
+    return false;
+  }
+  return PATH_SEPARATORS.has(targetPath.charAt(basePath.length));
+}
+function replaceCollectionItem(nodes, id, props) {
+  let childNodes;
+  const newNodes = nodes.map((node) => {
+    if (node.id === id) {
+      return {
+        ...node,
+        ...props
+      };
+    }
+    if (isDescendantOf(node.id, id) && node.childNodes) {
+      childNodes = replaceCollectionItem(node.childNodes, id, props);
+      return {
+        ...node,
+        childNodes
+      };
+    }
+    return node;
+  });
+  return newNodes;
+}
+
+exports.childIsGroup = childIsGroup;
+exports.childItems = childItems;
+exports.countChildItems = countChildItems;
+exports.getChildLabel = getChildLabel;
+exports.getChildNodes = getChildNodes;
+exports.isDisabled = isDisabled;
+exports.isFocusable = isFocusable;
+exports.isGroupNode = isGroupNode;
+exports.isHeader = isHeader;
+exports.isParentPath = isParentPath;
+exports.replaceCollectionItem = replaceCollectionItem;
+exports.sourceItemHasProp = sourceItemHasProp;
+exports.sourceItems = sourceItems;
+//# sourceMappingURL=collection-item-utils.js.map