@salt-ds/lab 1.0.0-alpha.0

package/dist-es/packages/lab/src/common-hooks/useSelection.js

@@ -0,0 +1,199 @@
+import { useControlled } from '@salt-ds/core';
+import { useRef, useCallback } from '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 = useRef(-1);
+  const isSelectionEvent = useCallback(
+    (evt) => selectionKeys.includes(evt.key),
+    [selectionKeys]
+  );
+  const emptyValue = useCallback(() => {
+    return isMultipleSelect || isExtendedSelect ? [] : null;
+  }, [isMultipleSelect, isExtendedSelect]);
+  const [selected, setSelected] = useControlled({
+    controlled: selectedProp,
+    default: defaultSelected != null ? defaultSelected : emptyValue(),
+    name: "UseSelection",
+    state: "selected"
+  });
+  const isItemSelected = useCallback(
+    (item) => {
+      return Array.isArray(selected) ? selected.includes(item) : selected === item;
+    },
+    [selected]
+  );
+  const selectDefault = useCallback((item) => item, []);
+  const selectDeselectable = useCallback(
+    (item) => isItemSelected(item) ? null : item,
+    [isItemSelected]
+  );
+  const selectMultiple = useCallback(
+    (item) => {
+      const nextItems = isItemSelected(item) ? selected.filter((i) => i !== item) : selected.concat(item);
+      nextItems.sort(byItemIndex);
+      return nextItems;
+    },
+    [isItemSelected, selected]
+  );
+  const selectRange = 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 = 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,
+      setSelected,
+      onSelectionChange
+    ]
+  );
+  const handleKeyDown = 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 = useCallback(
+    (evt, currentIndex) => {
+      if (isExtendedSelect && evt.shiftKey) {
+        const item = indexPositions[currentIndex];
+        if (isSelectable(item)) {
+          selectItemAtIndex(evt, currentIndex, item, true);
+        }
+      }
+    },
+    [isExtendedSelect, indexPositions, selectItemAtIndex]
+  );
+  const handleClick = 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
+  };
+};
+
+export { GROUP_SELECTION_NONE, useSelection };
+//# sourceMappingURL=useSelection.js.map

package/dist-es/packages/lab/src/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 { KeyboardEvent, MouseEvent, useCallback, useRef } from \"react\";\nimport { CollectionItem } from \"./collectionTypes\";\nimport {\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      setSelected,\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":[],"mappings":"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"}

package/dist-es/packages/lab/src/common-hooks/useTypeahead.js

@@ -0,0 +1,72 @@
+import { useRef, useCallback } from 'react';
+import { isCharacterKey, Space } from './keyUtils.js';
+
+const useTypeahead = ({
+  disableTypeToSelect,
+  highlightedIdx,
+  highlightItemAtIndex,
+  typeToNavigate,
+  items,
+  applyIncrementalSearch = true
+}) => {
+  const keyDownTimer = useRef(null);
+  const searchChars = useRef("");
+  const startIdx = useRef(-1);
+  const applySearch = 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 = useCallback(
+    (e) => {
+      const searchInProgress = startIdx.current !== -1;
+      if (isCharacterKey(e) || searchInProgress && e.key === 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
+  };
+};
+
+export { useTypeahead };
+//# sourceMappingURL=useTypeahead.js.map

package/dist-es/packages/lab/src/common-hooks/useTypeahead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTypeahead.js","sources":["../src/common-hooks/useTypeahead.ts"],"sourcesContent":["import { useCallback, useRef } from \"react\";\nimport { isCharacterKey, Space } from \"./keyUtils\";\nimport { CollectionItem } from \"./collectionTypes\";\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: React.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: React.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":[],"mappings":"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"}

package/dist-es/packages/lab/src/common-hooks/useViewportTracking.js

@@ -0,0 +1,131 @@
+import { useRef, useCallback, useLayoutEffect } from 'react';
+import '@salt-ds/core';
+import 'react/jsx-runtime';
+import { useResizeObserver } from '../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 parseInt(transform.slice(pos + 1));
+  } else {
+    let offsetParent = element.offsetParent;
+    if (offsetParent === offsetContainer || offsetContainer === null) {
+      return element.offsetTop;
+    } else {
+      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 = useRef(false);
+  const viewport = useRef({
+    height: 0,
+    contentHeight: 0
+  });
+  const scrollTo = useCallback((scrollPos) => {
+    scrolling.current = true;
+    if (containerRef.current) {
+      containerRef.current.scrollTop = scrollPos;
+    }
+    setTimeout(() => {
+      scrolling.current = false;
+    });
+  }, []);
+  const scrollToStart = useCallback(() => scrollTo(0), [scrollTo]);
+  const scrollToEnd = useCallback(() => {
+    scrollTo(viewport.current.contentHeight - viewport.current.height);
+  }, [scrollTo]);
+  const scrollIntoViewIfNeeded = 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]
+  );
+  useLayoutEffect(() => {
+    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 = useCallback(
+    ({ height, scrollHeight }) => {
+      if (typeof height === "number") {
+        viewport.current.height = height;
+      }
+      if (typeof scrollHeight === "number") {
+        viewport.current.contentHeight = scrollHeight;
+      }
+    },
+    []
+  );
+  const onContentResize = useCallback(({ height }) => {
+    if (typeof height === "number") {
+      viewport.current.contentHeight = height;
+    }
+  }, []);
+  const [containerDimensions, contentDimensions] = getObservedDimensions(
+    contentRef === NULL_REF
+  );
+  useResizeObserver(containerRef, containerDimensions, onContainerResize, true);
+  useResizeObserver(contentRef, contentDimensions, onContentResize, true);
+  return {
+    isScrolling: scrolling,
+    scrollIntoView: scrollIntoViewIfNeeded
+  };
+};
+
+export { useViewportTracking };
+//# sourceMappingURL=useViewportTracking.js.map

package/dist-es/packages/lab/src/common-hooks/useViewportTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewportTracking.js","sources":["../src/common-hooks/useViewportTracking.ts"],"sourcesContent":["import {\n  MutableRefObject,\n  RefObject,\n  useCallback,\n  useLayoutEffect,\n  useRef,\n} from \"react\";\nimport { CollectionItem } from \"./collectionTypes\";\nimport { ResizeHandler, useResizeObserver } from \"../responsive\";\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 parseInt(transform.slice(pos + 1));\n  } else {\n    let offsetParent = element.offsetParent as HTMLElement;\n    if (offsetParent === offsetContainer || offsetContainer === null) {\n      return element.offsetTop;\n    } else {\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  }\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((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\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  useLayoutEffect(() => {\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":[],"mappings":"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"}

package/dist-es/packages/lab/src/common-hooks/utils/collection-item-utils.js

@@ -0,0 +1,170 @@
+import { isValidElement, Children } from 'react';
+import { ListItemGroup } from '../../list/ListItemGroup.js';
+import { ListItemHeader } from '../../list/ListItemHeader.js';
+import { itemToString } from '../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 (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 (isValidElement(item)) {
+    if (childItemHasProp(item, "focusable")) {
+      return item.props.focusable;
+    }
+  }
+  return true;
+};
+const countChildItems = (item, items, idx) => {
+  if (item.childNodes) {
+    return item.childNodes.length;
+  } else if (item.header) {
+    let i = idx + 1;
+    let count = 0;
+    while (i < items.length && !items[i].header) {
+      count++;
+      i++;
+    }
+    return count;
+  } else {
+    return 0;
+  }
+};
+const getChildLabel = (element) => {
+  if (typeof element.props.children === "string") {
+    return element.props.children;
+  } else if (element.props.title) {
+    return element.props.title;
+  } else if (element.props.label) {
+    return element.props.label;
+  }
+};
+const childIsHeader = (child) => child.type === ListItemHeader || childItemHasProp(child, "data-header");
+const childIsGroup = (child) => child.type === ListItemGroup || childItemHasProp(child, "data-group");
+const childIsSelectable = (child) => {
+  if (childItemHasProp(child, "selectable")) {
+    return child.props.selectable === true;
+  } else {
+    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 = [];
+  Children.forEach(children, (child) => {
+    if (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
+        }
+      ];
+    } else {
+      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(item)
+          };
+        }
+      );
+    }
+  } else 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;
+  } else {
+    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
+      };
+    } else if (isDescendantOf(node.id, id) && node.childNodes) {
+      childNodes = replaceCollectionItem(node.childNodes, id, props);
+      return {
+        ...node,
+        childNodes
+      };
+    } else {
+      return node;
+    }
+  });
+  return newNodes;
+}
+
+export { childIsGroup, childItems, countChildItems, getChildLabel, getChildNodes, isDisabled, isFocusable, isGroupNode, isHeader, isParentPath, replaceCollectionItem, sourceItemHasProp, sourceItems };
+//# sourceMappingURL=collection-item-utils.js.map

package/dist-es/packages/lab/src/common-hooks/utils/collection-item-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-item-utils.js","sources":["../src/common-hooks/utils/collection-item-utils.ts"],"sourcesContent":["import { isValidElement, Children, ReactElement, ReactNode } from \"react\";\n\nimport {\n  CollectionItem,\n  CollectionOptions,\n  SourceGroup,\n} from \"../collectionTypes\";\n// TODO how do we configure these\nimport { ListItemGroup } from \"../../list/ListItemGroup\";\nimport { ListItemHeader } from \"../../list/ListItemHeader\";\nimport { itemToString as defaultItemToString } from \"../itemToString\";\n\ntype NonFocusableElement = ReactElement<{ focusable: false }>;\ntype DisablableElement = ReactElement<{ disabled: boolean }>;\ntype SelectableElement = ReactElement<{ selectable: boolean }>;\n\nexport const sourceItemHasProp = (\n  item: unknown,\n  propertyName: string\n): boolean => {\n  return (\n    item !== null && Object.prototype.hasOwnProperty.call(item, propertyName)\n  );\n};\n\nexport const isHeader = (item: unknown): boolean =>\n  sourceItemHasProp(item, \"header\");\n\nexport const isGroupNode = (item: unknown): boolean =>\n  sourceItemHasProp(item, \"childNodes\");\n\nconst childItemHasProp = (item: ReactElement, propertyName: string) => {\n  return item && Object.prototype.hasOwnProperty.call(item.props, propertyName);\n};\n\nexport const isDisabled = (item: unknown): boolean => {\n  if (isValidElement(item as DisablableElement)) {\n    if (childItemHasProp(item as DisablableElement, \"disabled\")) {\n      return (item as DisablableElement).props.disabled === true;\n    }\n  } else if (sourceItemHasProp(item, \"disabled\")) {\n    return (item as { disabled: boolean }).disabled === true;\n  }\n\n  return false;\n};\n\nexport const isFocusable = (item: unknown): boolean => {\n  if (isValidElement(item as NonFocusableElement)) {\n    if (childItemHasProp(item as NonFocusableElement, \"focusable\")) {\n      return (item as NonFocusableElement).props.focusable;\n    }\n  }\n  return true;\n};\n\nexport const countChildItems = <Item>(\n  item: CollectionItem<Item>,\n  items: CollectionItem<Item>[],\n  idx: number\n): number => {\n  if (item.childNodes) {\n    return item.childNodes.length;\n  } else if (item.header) {\n    let i = idx + 1;\n    let count = 0;\n    while (i < items.length && !items[i].header) {\n      count++;\n      i++;\n    }\n    return count;\n  } else {\n    return 0;\n  }\n};\n\nexport const getChildLabel = (\n  element: ReactElement<{\n    children?: ReactNode;\n    label?: string;\n    title?: string;\n  }>\n): string | undefined => {\n  if (typeof element.props.children === \"string\") {\n    return element.props.children;\n  } else if (element.props.title) {\n    return element.props.title;\n  } else if (element.props.label) {\n    return element.props.label;\n  }\n};\n\nconst childIsHeader = (child: ReactElement) =>\n  child.type === ListItemHeader || childItemHasProp(child, \"data-header\");\n\nexport const childIsGroup = (child: ReactElement): boolean =>\n  child.type === ListItemGroup || childItemHasProp(child, \"data-group\");\n\nconst childIsSelectable = (child: ReactElement) => {\n  if (childItemHasProp(child, \"selectable\")) {\n    return (child as SelectableElement).props.selectable === true;\n  } else {\n    return !childIsGroup(child) && !childIsHeader(child);\n  }\n};\n\nexport const getChildNodes = (\n  element: ReactElement\n): CollectionItem<ReactElement>[] | undefined => {\n  if (childIsGroup(element)) {\n    const {\n      props: { children },\n    } = element as ReactElement<{ children?: ReactNode }>;\n    if (typeof children !== \"string\") {\n      return childItems(children);\n    }\n  }\n};\n\nconst mapReactElementChildren = (\n  children: ReactNode,\n  fn: (el: ReactElement) => CollectionItem<ReactElement>\n): CollectionItem<ReactElement>[] => {\n  const childElements: CollectionItem<ReactElement>[] = [];\n  Children.forEach(children, (child) => {\n    if (isValidElement(child)) {\n      childElements.push(fn(child));\n    }\n  });\n  return childElements;\n};\n\ntype ListItemElementProps = {\n  \"data-id\"?: string;\n  disabled?: boolean;\n  id?: string;\n  \"data-expanded\"?: boolean;\n  expanded?: boolean;\n};\n\ntype CollectionItemWithoutId<T> = Omit<CollectionItem<T>, \"id\">;\n\nexport const sourceItems = <T>(\n  source?: ReadonlyArray<T>,\n  options?: CollectionOptions<T>\n): CollectionItemWithoutId<T>[] | undefined => {\n  if (Array.isArray(source)) {\n    if (source.length === 0 && options?.noChildrenLabel) {\n      return [\n        {\n          label: options.noChildrenLabel,\n          value: null,\n        },\n      ];\n    } else {\n      return source.map(\n        (item: { description?: string; expanded?: boolean }, index) =>\n          ({\n            childNodes: sourceItems(\n              (item as unknown as SourceGroup<T>).childNodes,\n              options\n            ),\n            description: item.description,\n            expanded: item.expanded,\n            value: item,\n            label:\n              options?.itemToString?.(item as T) ?? defaultItemToString(item),\n          } as CollectionItemWithoutId<T>)\n      );\n    }\n  } else if (source) {\n    throw Error(\"list-child-items expects source to be an array\");\n  }\n};\n\nexport const childItems = (\n  children: ReactNode\n): CollectionItem<ReactElement>[] | undefined => {\n  if (children) {\n    return mapReactElementChildren(children, (child) => {\n      const {\n        \"data-id\": dataId,\n        disabled,\n        id = dataId,\n        \"data-expanded\": dataExpanded,\n        expanded = dataExpanded,\n      } = (child as ReactElement<ListItemElementProps>).props;\n      return {\n        childNodes: getChildNodes(child),\n        disabled,\n        expanded,\n        header: childIsHeader(child),\n        id,\n        label: getChildLabel(child),\n        selectable: childIsSelectable(child),\n        value: child,\n      } as CollectionItem<ReactElement>;\n    });\n  }\n};\n\nconst PathSeparators = new Set<string>([\"/\", \"-\", \".\"]);\n// TODO where do we define or identify separators\nconst isPathSeparator = (char: string) => PathSeparators.has(char);\n\nexport const isParentPath = (parentPath: string, childPath: string): boolean =>\n  childPath.startsWith(parentPath) &&\n  isPathSeparator(childPath[parentPath.length]);\n\nconst PATH_SEPARATORS = new Set([\".\", \"/\"]);\n\nfunction isDescendantOf(basePath: string, targetPath: string) {\n  if (!targetPath.startsWith(basePath)) {\n    return false;\n  } else {\n    return PATH_SEPARATORS.has(targetPath.charAt(basePath.length));\n  }\n}\n\nexport function replaceCollectionItem<Item>(\n  nodes: CollectionItem<Item>[],\n  id: string,\n  props: Partial<CollectionItem<Item>>\n): CollectionItem<Item>[] {\n  let childNodes: CollectionItem<Item>[];\n  const newNodes: CollectionItem<Item>[] = nodes.map((node) => {\n    if (node.id === id) {\n      return {\n        ...node,\n        ...props,\n      };\n    } else if (isDescendantOf(node.id, id) && node.childNodes) {\n      childNodes = replaceCollectionItem<Item>(node.childNodes, id, props);\n      return {\n        ...node,\n        childNodes,\n      };\n    } else {\n      return node;\n    }\n  });\n\n  return newNodes;\n}\n"],"names":["defaultItemToString"],"mappings":"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"}