@salt-ds/lab 1.0.0-alpha.0

package/dist-cjs/packages/lab/src/common-hooks/useCollectionItems.js

@@ -0,0 +1,277 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var collectionItemUtils = require('./utils/collection-item-utils.js');
+var filterUtils = require('./utils/filter-utils.js');
+var itemToString = require('./itemToString.js');
+var collectionProvider = require('./collectionProvider.js');
+
+const defaultCollectionOptions = {};
+const useCollectionItems = ({
+  children,
+  id: idRoot,
+  label = "",
+  options = defaultCollectionOptions,
+  source
+}) => {
+  var _a;
+  const { getItemId } = options;
+  const [, forceUpdate] = React.useState(null);
+  const inheritedCollectionHook = collectionProvider.useCollection();
+  const dataRef = React.useRef([]);
+  const flattenedDataRef = React.useRef([]);
+  const EMPTY_COLLECTION = React.useMemo(() => [], []);
+  const filterPattern = React.useRef((_a = options.filterPattern) != null ? _a : "");
+  const {
+    getFilterRegex = filterUtils.getDefaultFilterRegex,
+    noChildrenLabel,
+    itemToString: itemToString$1 = itemToString.itemToString
+  } = options;
+  const isExpanded = React.useCallback(
+    (path) => {
+      return options.defaultExpanded || false;
+    },
+    [options.defaultExpanded]
+  );
+  const addMetadataToItems = React.useCallback(
+    (items, indexer, level = 1, path = "", results = [], flattenedCollection2 = [], flattenedSource2 = []) => {
+      items.forEach((item, i, all) => {
+        var _a2, _b;
+        const isCollapsibleHeader = item.header && options.collapsibleHeaders;
+        const isNonCollapsibleGroupNode = item.childNodes && options.collapsibleHeaders === false;
+        const isLeaf = !item.childNodes || item.childNodes.length === 0;
+        const nonCollapsible = isNonCollapsibleGroupNode || isLeaf && !isCollapsibleHeader;
+        const childPath = path ? `${path}.${i}` : `item-${i}`;
+        const id = (_a2 = item.id) != null ? _a2 : getItemId ? getItemId(i) : `${idRoot}-${childPath}`;
+        const expanded = nonCollapsible ? void 0 : (_b = item.expanded) != null ? _b : isExpanded(id);
+        const normalisedItem = {
+          ...item,
+          childNodes: void 0,
+          count: !isNonCollapsibleGroupNode && expanded === void 0 ? 0 : collectionItemUtils.countChildItems(item, all, i),
+          description: item.description,
+          disabled: collectionItemUtils.isDisabled(item.value),
+          focusable: collectionItemUtils.isFocusable(item.value) ? void 0 : false,
+          id,
+          index: indexer.value,
+          expanded,
+          level
+        };
+        results.push(normalisedItem);
+        flattenedCollection2.push(normalisedItem);
+        flattenedSource2.push(items[i].value);
+        indexer.value += 1;
+        if (item.childNodes) {
+          const [children2] = addMetadataToItems(
+            item.childNodes,
+            indexer,
+            level + 1,
+            childPath,
+            [],
+            flattenedCollection2,
+            flattenedSource2
+          );
+          normalisedItem.childNodes = children2;
+        }
+      });
+      return [results, flattenedSource2, flattenedCollection2];
+    },
+    [options.collapsibleHeaders, getItemId, idRoot, isExpanded]
+  );
+  const getFilter = React.useCallback(() => {
+    if (filterPattern.current) {
+      return filterUtils.getDefaultFilter(filterPattern.current, getFilterRegex);
+    } else {
+      return null;
+    }
+  }, [getFilterRegex]);
+  const collectVisibleItems = React.useCallback(
+    (items, filter = getFilter(), results = [], idx = { value: 0 }) => {
+      let skipToNextHeader = false;
+      for (const item of items) {
+        if (!(skipToNextHeader && !collectionItemUtils.isHeader(item))) {
+          if (item.value !== null && (filter === null || filter(itemToString$1(item.value)))) {
+            results[idx.value] = item;
+            idx.value += 1;
+          }
+          skipToNextHeader = false;
+          if (collectionItemUtils.isHeader(item) && item.expanded === false) {
+            skipToNextHeader = true;
+          } else if (collectionItemUtils.isGroupNode(item)) {
+            if (item.expanded !== false && item.childNodes) {
+              collectVisibleItems(item.childNodes, filter, results, idx);
+            }
+          }
+        }
+      }
+      return results;
+    },
+    [getFilter, itemToString$1]
+  );
+  const partialCollectionItems = React.useMemo(() => {
+    return inheritedCollectionHook ? EMPTY_COLLECTION : collectionItemUtils.sourceItems(source, { itemToString: itemToString$1, noChildrenLabel }) || collectionItemUtils.childItems(children) || [];
+  }, [
+    inheritedCollectionHook,
+    EMPTY_COLLECTION,
+    source,
+    itemToString$1,
+    noChildrenLabel,
+    children
+  ]);
+  const [collectionItems, flattenedSource, flattenedCollection] = React.useMemo(
+    () => inheritedCollectionHook ? [EMPTY_COLLECTION, EMPTY_COLLECTION, EMPTY_COLLECTION] : addMetadataToItems(partialCollectionItems, { value: 0 }),
+    [
+      EMPTY_COLLECTION,
+      addMetadataToItems,
+      inheritedCollectionHook,
+      partialCollectionItems
+    ]
+  );
+  flattenedDataRef.current = flattenedCollection;
+  React.useMemo(
+    () => inheritedCollectionHook ? EMPTY_COLLECTION : dataRef.current = collectVisibleItems(collectionItems),
+    [
+      EMPTY_COLLECTION,
+      collectVisibleItems,
+      collectionItems,
+      inheritedCollectionHook
+    ]
+  );
+  const collectionItemsRef = React.useRef(collectionItems);
+  const setFilterPattern = React.useCallback(
+    (pattern = "") => {
+      if (typeof pattern === "string") {
+        filterPattern.current = pattern;
+        dataRef.current = collectVisibleItems(collectionItemsRef.current);
+        forceUpdate({});
+      }
+    },
+    [collectVisibleItems]
+  );
+  const itemById = React.useCallback(
+    (id, target = collectionItems) => {
+      const sourceWithId = target.find(
+        (i) => {
+          var _a2;
+          return i.id === id || ((_a2 = i == null ? void 0 : i.childNodes) == null ? void 0 : _a2.length) && collectionItemUtils.isParentPath(i.id, id);
+        }
+      );
+      if ((sourceWithId == null ? void 0 : sourceWithId.id) === id) {
+        return flattenedSource == null ? void 0 : flattenedSource[sourceWithId.index];
+      } else if (sourceWithId) {
+        return itemById(id, sourceWithId.childNodes);
+      }
+      throw Error(`useCollectionData itemById, id ${id} not found `);
+    },
+    [flattenedSource, collectionItems]
+  );
+  const toCollectionItem = React.useCallback(
+    (item) => {
+      const collectionItem = flattenedDataRef.current.find(
+        (i) => React.isValidElement(i.value) ? i.label === item : i.value === item
+      );
+      if (collectionItem) {
+        return collectionItem;
+      }
+      throw Error(`useCollectionData toCollectionItem, item not found `);
+    },
+    []
+  );
+  const itemToCollectionItem = React.useCallback(
+    (sel) => {
+      if (sel === null) {
+        return null;
+      } else if (Array.isArray(sel)) {
+        const result = [];
+        for (const item of sel) {
+          const collectionItem = toCollectionItem(item);
+          result.push(collectionItem);
+        }
+        return result;
+      } else if (sel !== void 0) {
+        return toCollectionItem(sel);
+      }
+      return void 0;
+    },
+    [toCollectionItem]
+  );
+  const stringToCollectionItem = React.useCallback(
+    (value) => {
+      const toCollectionItem2 = (item) => {
+        const collectionItem = flattenedDataRef.current.find(
+          (i) => React.isValidElement(i.value) ? i.label === item : i.value !== null && itemToString$1(i.value) === item
+        );
+        if (collectionItem) {
+          return collectionItem;
+        }
+      };
+      if (value === null) {
+        return null;
+      } else if (Array.isArray(value)) {
+        const result = [];
+        for (const item of value) {
+          const collectionItem = toCollectionItem2(item);
+          if (collectionItem) {
+            result.push(collectionItem);
+          }
+        }
+        return result;
+      } else if (value !== void 0) {
+        return toCollectionItem2(value);
+      }
+      return void 0;
+    },
+    [itemToString$1]
+  );
+  const itemToId = React.useCallback((item) => {
+    for (const collectionItem of collectionItemsRef.current) {
+      if (item === collectionItem.value) {
+        return collectionItem.id;
+      }
+    }
+    throw Error("useCollectionData itemToId, item not found");
+  }, []);
+  const collapseGroupItem = React.useCallback(
+    (item) => {
+      collectionItemsRef.current = collectionItemUtils.replaceCollectionItem(
+        collectionItemsRef.current,
+        item.id,
+        {
+          expanded: false
+        }
+      );
+      dataRef.current = collectVisibleItems(collectionItemsRef.current);
+      forceUpdate({});
+    },
+    [collectVisibleItems]
+  );
+  const expandGroupItem = React.useCallback(
+    (item) => {
+      collectionItemsRef.current = collectionItemUtils.replaceCollectionItem(
+        collectionItemsRef.current,
+        item.id,
+        {
+          expanded: true
+        }
+      );
+      dataRef.current = collectVisibleItems(collectionItemsRef.current);
+      forceUpdate({});
+    },
+    [collectVisibleItems]
+  );
+  return inheritedCollectionHook || {
+    collapseGroupItem,
+    data: dataRef.current,
+    expandGroupItem,
+    setFilterPattern,
+    itemById,
+    itemToId,
+    toCollectionItem,
+    itemToCollectionItem,
+    stringToCollectionItem
+  };
+};
+
+exports.useCollectionItems = useCollectionItems;
+//# sourceMappingURL=useCollectionItems.js.map

package/dist-cjs/packages/lab/src/common-hooks/useCollectionItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionItems.js","sources":["../src/common-hooks/useCollectionItems.ts"],"sourcesContent":["import { useCallback, useMemo, useRef, useState, isValidElement } from \"react\";\nimport {\n  CollectionItem,\n  CollectionIndexer,\n  CollectionHookProps,\n  CollectionHookResult,\n} from \"./collectionTypes\";\nimport {\n  isHeader,\n  isGroupNode,\n  childItems,\n  countChildItems,\n  FilterPredicate,\n  getDefaultFilter,\n  getDefaultFilterRegex,\n  isDisabled,\n  isFocusable,\n  isParentPath,\n  replaceCollectionItem,\n  sourceItems,\n} from \"./utils\";\nimport { itemToString as defaultItemToString } from \"./itemToString\";\n\nimport { SelectionStrategy, SingleSelectionStrategy } from \"./selectionTypes\";\nimport { useCollection } from \"./collectionProvider\";\n\nconst defaultCollectionOptions = {};\n\nexport const useCollectionItems = <Item>({\n  children,\n  id: idRoot,\n  label = \"\",\n  options = defaultCollectionOptions,\n  // revealSelected = false,\n  source,\n}: CollectionHookProps<Item>): CollectionHookResult<Item> => {\n  const { getItemId } = options;\n\n  const [, forceUpdate] = useState<unknown>(null);\n  const inheritedCollectionHook = useCollection<Item>();\n  const dataRef = useRef<CollectionItem<Item>[]>([]);\n  const flattenedDataRef = useRef<CollectionItem<Item>[]>([]);\n  const EMPTY_COLLECTION: CollectionItem<Item>[] = useMemo(() => [], []);\n  const filterPattern = useRef<string>(options.filterPattern ?? \"\");\n\n  // destructure individual option values so we can safely reference them in dependency arrays\n  const {\n    getFilterRegex = getDefaultFilterRegex,\n    noChildrenLabel,\n    itemToString = defaultItemToString,\n  } = options;\n\n  const isExpanded = useCallback(\n    (path: string) => {\n      // We can't do this here because itemToId won't work until we complete this phase\n      // if (Array.isArray(revealSelected)) {\n      //   const selectedIds = revealSelected.map(itemToId);\n      //   return selectedIds.some((id) => isParentPath(path, id));\n      // }\n      return options.defaultExpanded || false;\n    },\n    [options.defaultExpanded]\n  );\n\n  const addMetadataToItems = useCallback(\n    <Item>(\n      items: CollectionItem<Item>[],\n      indexer: CollectionIndexer,\n      level = 1,\n      path = \"\",\n      results: CollectionItem<Item>[] = [],\n      flattenedCollection: CollectionItem<Item>[] = [],\n      flattenedSource: (Item | null)[] = []\n    ): [CollectionItem<Item>[], (Item | null)[], CollectionItem<Item>[]] => {\n      items.forEach((item, i, all) => {\n        const isCollapsibleHeader = item.header && options.collapsibleHeaders;\n        const isNonCollapsibleGroupNode =\n          item.childNodes && options.collapsibleHeaders === false;\n        const isLeaf = !item.childNodes || item.childNodes.length === 0;\n        const nonCollapsible =\n          isNonCollapsibleGroupNode || (isLeaf && !isCollapsibleHeader);\n        const childPath = path ? `${path}.${i}` : `item-${i}`;\n        // getItemId is backward compatible with earlier List implementation.\n        // It is not appropriate for a nested source structure, where index\n        // will not always be an absolute offset.\n        const id =\n          item.id ?? (getItemId ? getItemId(i) : `${idRoot}-${childPath}`);\n\n        const expanded = nonCollapsible\n          ? undefined\n          : item.expanded ?? isExpanded(id);\n        //TODO dev time check - if id is provided by user, make sure\n        // hierarchical pattern is consistent\n        const normalisedItem: CollectionItem<Item> = {\n          ...item,\n          childNodes: undefined,\n          count:\n            !isNonCollapsibleGroupNode && expanded === undefined\n              ? 0\n              : countChildItems(item, all, i),\n          description: item.description,\n          disabled: isDisabled(item.value),\n          focusable: isFocusable(item.value) ? undefined : false,\n          id,\n          index: indexer.value,\n          expanded,\n          level,\n        };\n        results.push(normalisedItem);\n        flattenedCollection.push(normalisedItem);\n        flattenedSource.push(items[i].value);\n\n        indexer.value += 1;\n\n        // if ((isNonCollapsibleGroupNode || expanded !== undefined) && !isCollapsibleHeader) {\n        if (item.childNodes) {\n          const [children] = addMetadataToItems<Item>(\n            item.childNodes,\n            indexer,\n            level + 1,\n            childPath,\n            [],\n            flattenedCollection,\n            flattenedSource\n          );\n          normalisedItem.childNodes = children;\n        }\n      });\n      return [results, flattenedSource, flattenedCollection];\n    },\n    [options.collapsibleHeaders, getItemId, idRoot, isExpanded]\n  );\n\n  const getFilter = useCallback(() => {\n    if (filterPattern.current) {\n      return getDefaultFilter(filterPattern.current, getFilterRegex);\n    } else {\n      return null;\n    }\n  }, [getFilterRegex]);\n\n  const collectVisibleItems = useCallback(\n    (\n      items: CollectionItem<Item>[],\n      filter: null | FilterPredicate = getFilter(),\n      results: CollectionItem<Item>[] = [],\n      idx: { value: number } = { value: 0 }\n    ): CollectionItem<Item>[] => {\n      let skipToNextHeader = false;\n      for (const item of items) {\n        if (!(skipToNextHeader && !isHeader(item))) {\n          if (\n            item.value !== null &&\n            (filter === null || filter(itemToString(item.value)))\n          ) {\n            results[idx.value] = item;\n            idx.value += 1;\n          }\n          skipToNextHeader = false;\n          if (isHeader(item) && item.expanded === false) {\n            skipToNextHeader = true;\n          } else if (isGroupNode(item)) {\n            if (item.expanded !== false && item.childNodes) {\n              collectVisibleItems(item.childNodes, filter, results, idx);\n            }\n          }\n        }\n      }\n      return results;\n    },\n    [getFilter, itemToString]\n  );\n\n  // Stage 1 - convert source or children to CollectionItems.\n  const partialCollectionItems = useMemo(() => {\n    return inheritedCollectionHook\n      ? EMPTY_COLLECTION\n      : sourceItems<Item>(source, { itemToString, noChildrenLabel }) ||\n          childItems(children) ||\n          [];\n  }, [\n    inheritedCollectionHook,\n    EMPTY_COLLECTION,\n    source,\n    itemToString,\n    noChildrenLabel,\n    children,\n  ]);\n\n  // Stage 2 - extend the collectionItems with additional metadata\n  const [collectionItems, flattenedSource, flattenedCollection] = useMemo(\n    () =>\n      inheritedCollectionHook\n        ? [EMPTY_COLLECTION, EMPTY_COLLECTION, EMPTY_COLLECTION]\n        : //@ts-ignore\n          addMetadataToItems<Item>(partialCollectionItems, { value: 0 }),\n    [\n      EMPTY_COLLECTION,\n      addMetadataToItems,\n      inheritedCollectionHook,\n      partialCollectionItems,\n    ]\n  );\n  flattenedDataRef.current = flattenedCollection;\n\n  // Stage 3 prepare the list of visible items, this is what will be rendered\n  useMemo(\n    () =>\n      inheritedCollectionHook\n        ? EMPTY_COLLECTION\n        : (dataRef.current = collectVisibleItems(collectionItems)),\n    [\n      EMPTY_COLLECTION,\n      collectVisibleItems,\n      collectionItems,\n      inheritedCollectionHook,\n    ]\n  );\n\n  const collectionItemsRef = useRef(collectionItems);\n\n  const setFilterPattern = useCallback(\n    (pattern = \"\") => {\n      if (typeof pattern === \"string\") {\n        filterPattern.current = pattern;\n        dataRef.current = collectVisibleItems(collectionItemsRef.current);\n        forceUpdate({});\n      }\n    },\n    [collectVisibleItems]\n  );\n\n  const itemById = useCallback(\n    (\n      id: string,\n      target: CollectionItem<Item>[] = collectionItems\n    ): Item | never => {\n      const sourceWithId = target.find(\n        (i) => i.id === id || (i?.childNodes?.length && isParentPath(i.id, id))\n      );\n      if (sourceWithId?.id === id) {\n        //TODO do we need the flattered source at all ?\n        return flattenedSource?.[sourceWithId.index!] as Item;\n      } else if (sourceWithId) {\n        return itemById(id, sourceWithId.childNodes);\n      }\n      throw Error(`useCollectionData itemById, id ${id} not found `);\n    },\n    [flattenedSource, collectionItems]\n  );\n\n  const toCollectionItem = useCallback(\n    (item: Item): CollectionItem<Item> | never => {\n      // TODO what about Tree structures, we need to search flattened source\n      const collectionItem = flattenedDataRef.current.find((i) =>\n        // const collectionItem = collectionItemsRef.current.find((i) =>\n        //@ts-ignore\n        isValidElement(i.value) ? i.label === item : i.value === item\n      );\n      if (collectionItem) {\n        return collectionItem;\n      }\n      throw Error(`useCollectionData toCollectionItem, item not found `);\n    },\n    []\n  );\n\n  // TODO types need more work, these are correct but we\n  // don't really want references to Selection in here\n  const itemToCollectionItem = useCallback(\n    <\n      Selection extends SelectionStrategy,\n      U extends Item | Item[] | null | undefined\n    >(\n      sel: U\n    ): Selection extends SingleSelectionStrategy\n      ? CollectionItem<Item> | null\n      : CollectionItem<Item>[] => {\n      type returnType = Selection extends SingleSelectionStrategy\n        ? CollectionItem<Item> | null\n        : CollectionItem<Item>[];\n\n      if (sel === null) {\n        return null as returnType;\n      } else if (Array.isArray(sel)) {\n        const result: CollectionItem<Item>[] = [];\n        for (const item of sel) {\n          const collectionItem = toCollectionItem(item);\n          result.push(collectionItem);\n        }\n        return result as returnType;\n      } else if (sel !== undefined) {\n        return toCollectionItem(sel as Item) as returnType;\n      }\n\n      return undefined as unknown as returnType;\n    },\n    [toCollectionItem]\n  );\n\n  const stringToCollectionItem = useCallback(\n    <Selection extends SelectionStrategy>(\n      value: string | null | undefined\n    ): Selection extends SingleSelectionStrategy\n      ? CollectionItem<Item> | null\n      : CollectionItem<Item>[] => {\n      type returnType = Selection extends SingleSelectionStrategy\n        ? CollectionItem<Item> | null\n        : CollectionItem<Item>[];\n\n      const toCollectionItem = (\n        item: string\n      ): undefined | CollectionItem<Item> | never => {\n        // TODO what about Tree structures, we need to search flattened source\n        const collectionItem = flattenedDataRef.current.find((i) =>\n          // const collectionItem = collectionItemsRef.current.find((i) =>\n          //@ts-ignore\n          isValidElement(i.value)\n            ? i.label === item\n            : i.value !== null && itemToString(i.value) === item\n        );\n        if (collectionItem) {\n          return collectionItem;\n        }\n      };\n\n      if (value === null) {\n        return null as returnType;\n      } else if (Array.isArray(value)) {\n        const result: CollectionItem<Item>[] = [];\n        for (const item of value) {\n          const collectionItem = toCollectionItem(item);\n          if (collectionItem) {\n            result.push(collectionItem);\n          }\n        }\n        return result as returnType;\n      } else if (value !== undefined) {\n        return toCollectionItem(value) as returnType;\n      }\n\n      return undefined as unknown as returnType;\n    },\n    [itemToString]\n  );\n\n  const itemToId = useCallback((item: Item): string => {\n    for (const collectionItem of collectionItemsRef.current) {\n      if (item === collectionItem.value) {\n        return collectionItem.id;\n      }\n    }\n    throw Error(\"useCollectionData itemToId, item not found\");\n  }, []);\n\n  const collapseGroupItem = useCallback(\n    (item: CollectionItem<Item>) => {\n      collectionItemsRef.current = replaceCollectionItem(\n        collectionItemsRef.current,\n        item.id,\n        {\n          expanded: false,\n        }\n      );\n      dataRef.current = collectVisibleItems(collectionItemsRef.current);\n      forceUpdate({});\n    },\n    [collectVisibleItems]\n  );\n\n  const expandGroupItem = useCallback(\n    (item: CollectionItem<Item>) => {\n      collectionItemsRef.current = replaceCollectionItem<Item>(\n        collectionItemsRef.current,\n        item.id,\n        {\n          expanded: true,\n        }\n      );\n      dataRef.current = collectVisibleItems(collectionItemsRef.current);\n      forceUpdate({});\n    },\n    [collectVisibleItems]\n  );\n\n  return (\n    inheritedCollectionHook || {\n      collapseGroupItem,\n      data: dataRef.current,\n      expandGroupItem, // why not toggle, or just rely on setdata ?\n      setFilterPattern,\n      itemById,\n      itemToId,\n      toCollectionItem,\n      itemToCollectionItem,\n      stringToCollectionItem,\n    }\n  );\n};\n"],"names":["useState","useCollection","useRef","useMemo","getDefaultFilterRegex","itemToString","defaultItemToString","useCallback","flattenedCollection","flattenedSource","_a","countChildItems","isDisabled","isFocusable","children","getDefaultFilter","isHeader","isGroupNode","sourceItems","childItems","isParentPath","isValidElement","toCollectionItem","replaceCollectionItem"],"mappings":"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"}

package/dist-cjs/packages/lab/src/common-hooks/useImperativeScrollingAPI.js

@@ -0,0 +1,54 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+
+const noScrolling = {
+  scrollToIndex: (itemIndex) => void 0,
+  scrollToItem: (item) => void 0,
+  scrollTo: (scrollOffset) => void 0
+};
+const useImperativeScrollingAPI = ({
+  collectionHook,
+  forwardedRef,
+  scrollableRef,
+  scrollIntoView
+}) => {
+  const scrollHandles = React.useMemo(
+    () => ({
+      scrollToIndex: (itemIndex) => {
+        const collectionItem = collectionHook.data[itemIndex];
+        if (collectionItem) {
+          scrollIntoView == null ? void 0 : scrollIntoView(collectionItem);
+        }
+      },
+      scrollToItem: (item) => {
+        const collectionItem = collectionHook.toCollectionItem(item);
+        if (collectionItem) {
+          scrollIntoView == null ? void 0 : scrollIntoView(collectionItem);
+        }
+      },
+      scrollTo: (scrollOffset) => {
+        if (scrollableRef == null ? void 0 : scrollableRef.current) {
+          scrollableRef.current.scrollTop = scrollOffset;
+        }
+      }
+    }),
+    [collectionHook.data, collectionHook.toCollectionItem, scrollIntoView]
+  );
+  React.useImperativeHandle(
+    forwardedRef,
+    () => {
+      if (scrollableRef.current) {
+        return scrollHandles;
+      } else {
+        return noScrolling;
+      }
+    },
+    [scrollHandles]
+  );
+};
+
+exports.useImperativeScrollingAPI = useImperativeScrollingAPI;
+//# sourceMappingURL=useImperativeScrollingAPI.js.map

package/dist-cjs/packages/lab/src/common-hooks/useImperativeScrollingAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImperativeScrollingAPI.js","sources":["../src/common-hooks/useImperativeScrollingAPI.ts"],"sourcesContent":["import {\n  ForwardedRef,\n  MutableRefObject,\n  useImperativeHandle,\n  useMemo,\n} from \"react\";\nimport { CollectionHookResult, CollectionItem } from \"./collectionTypes\";\n\nexport interface ScrollingAPI<Item> {\n  scrollToIndex: (itemIndex: number) => void;\n  scrollToItem: (item: Item) => void;\n  scrollTo: (scrollOffset: number) => void;\n}\n\nexport interface ScrollingAPIHook<Item> {\n  collectionHook: CollectionHookResult<Item>;\n  forwardedRef?: ForwardedRef<ScrollingAPI<Item>>;\n  scrollableRef: MutableRefObject<HTMLElement | null>;\n  scrollIntoView?: (item: CollectionItem<Item>) => void;\n}\n\nconst noScrolling: ScrollingAPI<unknown> = {\n  scrollToIndex: (itemIndex: number) => undefined,\n  scrollToItem: (item) => undefined,\n  scrollTo: (scrollOffset: number) => undefined,\n};\n\nexport const useImperativeScrollingAPI = <Item>({\n  collectionHook,\n  forwardedRef,\n  scrollableRef,\n  scrollIntoView,\n}: ScrollingAPIHook<Item>) => {\n  const scrollHandles: ScrollingAPI<Item> = useMemo(\n    () => ({\n      scrollToIndex: (itemIndex: number) => {\n        const collectionItem = collectionHook.data[itemIndex];\n        if (collectionItem) {\n          scrollIntoView?.(collectionItem);\n        }\n      },\n      scrollToItem: (item: Item) => {\n        const collectionItem = collectionHook.toCollectionItem(item);\n        if (collectionItem) {\n          scrollIntoView?.(collectionItem);\n        }\n      },\n      scrollTo: (scrollOffset: number) => {\n        if (scrollableRef?.current) {\n          scrollableRef.current.scrollTop = scrollOffset;\n        }\n      },\n    }),\n    [collectionHook.data, collectionHook.toCollectionItem, scrollIntoView]\n  );\n\n  useImperativeHandle(\n    forwardedRef,\n    () => {\n      if (scrollableRef.current) {\n        return scrollHandles;\n      } else {\n        return noScrolling;\n      }\n    },\n    [scrollHandles]\n  );\n};\n"],"names":["useMemo","useImperativeHandle"],"mappings":";;;;;;AAqBA,MAAM,WAAqC,GAAA;AAAA,EACzC,aAAA,EAAe,CAAC,SAAsB,KAAA,KAAA,CAAA;AAAA,EACtC,YAAA,EAAc,CAAC,IAAS,KAAA,KAAA,CAAA;AAAA,EACxB,QAAA,EAAU,CAAC,YAAyB,KAAA,KAAA,CAAA;AACtC,CAAA,CAAA;AAEO,MAAM,4BAA4B,CAAO;AAAA,EAC9C,cAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA,cAAA;AACF,CAA8B,KAAA;AAC5B,EAAA,MAAM,aAAoC,GAAAA,aAAA;AAAA,IACxC,OAAO;AAAA,MACL,aAAA,EAAe,CAAC,SAAsB,KAAA;AACpC,QAAM,MAAA,cAAA,GAAiB,eAAe,IAAK,CAAA,SAAA,CAAA,CAAA;AAC3C,QAAA,IAAI,cAAgB,EAAA;AAClB,UAAiB,cAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,cAAA,CAAA,cAAA,CAAA,CAAA;AAAA,SACnB;AAAA,OACF;AAAA,MACA,YAAA,EAAc,CAAC,IAAe,KAAA;AAC5B,QAAM,MAAA,cAAA,GAAiB,cAAe,CAAA,gBAAA,CAAiB,IAAI,CAAA,CAAA;AAC3D,QAAA,IAAI,cAAgB,EAAA;AAClB,UAAiB,cAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,cAAA,CAAA,cAAA,CAAA,CAAA;AAAA,SACnB;AAAA,OACF;AAAA,MACA,QAAA,EAAU,CAAC,YAAyB,KAAA;AAClC,QAAA,IAAI,+CAAe,OAAS,EAAA;AAC1B,UAAA,aAAA,CAAc,QAAQ,SAAY,GAAA,YAAA,CAAA;AAAA,SACpC;AAAA,OACF;AAAA,KACF,CAAA;AAAA,IACA,CAAC,cAAA,CAAe,IAAM,EAAA,cAAA,CAAe,kBAAkB,cAAc,CAAA;AAAA,GACvE,CAAA;AAEA,EAAAC,yBAAA;AAAA,IACE,YAAA;AAAA,IACA,MAAM;AACJ,MAAA,IAAI,cAAc,OAAS,EAAA;AACzB,QAAO,OAAA,aAAA,CAAA;AAAA,OACF,MAAA;AACL,QAAO,OAAA,WAAA,CAAA;AAAA,OACT;AAAA,KACF;AAAA,IACA,CAAC,aAAa,CAAA;AAAA,GAChB,CAAA;AACF;;;;"}

package/dist-cjs/packages/lab/src/common-hooks/useKeyboardNavigation.js

@@ -0,0 +1,297 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@salt-ds/core');
+var React = require('react');
+var keyUtils = require('./keyUtils.js');
+var selectionTypes = require('./selectionTypes.js');
+
+const LIST_FOCUS_VISIBLE = -2;
+function nextItemIdx(count, key, idx) {
+  if (key === keyUtils.ArrowUp || key === keyUtils.End) {
+    if (idx > 0) {
+      return idx - 1;
+    } else {
+      return idx;
+    }
+  } else {
+    if (idx === null) {
+      return 0;
+    } else if (idx === count - 1) {
+      return idx;
+    } else {
+      return idx + 1;
+    }
+  }
+}
+const getIndexOfSelectedItem = (items, selected) => {
+  const selectedItem = selectionTypes.getFirstSelectedItem(selected);
+  if (selectedItem) {
+    return items.indexOf(selectedItem);
+  } else {
+    return -1;
+  }
+};
+const getStartIdx = (key, idx, selectedIdx, length) => {
+  if (key === keyUtils.End) {
+    return length;
+  } else if (key === keyUtils.Home) {
+    return -1;
+  } else if (idx !== -1) {
+    return idx;
+  } else {
+    return selectedIdx;
+  }
+};
+const getItemRect = (item) => {
+  const el = document.getElementById(item.id);
+  if (el) {
+    return el.getBoundingClientRect();
+  } else {
+    throw Error(
+      `useKeyboardNavigation.getItemRect no element found for item  #${item == null ? void 0 : item.id}`
+    );
+  }
+};
+const pageDown = (containerEl, itemEl, indexPositions, index) => {
+  const { top: itemTop } = itemEl.getBoundingClientRect();
+  const { scrollTop, clientHeight, scrollHeight } = containerEl;
+  const lastIndexPosition = indexPositions.length - 1;
+  const newScrollTop = Math.min(
+    scrollTop + clientHeight,
+    scrollHeight - clientHeight
+  );
+  if (newScrollTop !== scrollTop && index < lastIndexPosition) {
+    containerEl.scrollTo(0, newScrollTop);
+    let nextIdx = index;
+    let nextRect;
+    do {
+      nextIdx += 1;
+      nextRect = getItemRect(indexPositions[nextIdx]);
+    } while (nextRect.top < itemTop && nextIdx < lastIndexPosition);
+    return nextIdx;
+  }
+};
+const pageUp = async (containerEl, itemEl, indexPositions, index) => {
+  const { top: itemTop } = itemEl.getBoundingClientRect();
+  const { scrollTop, clientHeight } = containerEl;
+  const newScrollTop = Math.max(scrollTop - clientHeight, 0);
+  if (newScrollTop !== scrollTop && index > 0) {
+    containerEl.scrollTo(0, newScrollTop);
+    return new Promise((resolve) => {
+      requestAnimationFrame(() => {
+        let nextIdx = index;
+        let nextRect;
+        do {
+          nextIdx -= 1;
+          nextRect = getItemRect(indexPositions[nextIdx]);
+        } while (nextRect.top > itemTop && nextIdx > 0);
+        resolve(nextIdx);
+      });
+    });
+  }
+};
+const isLeaf = (item) => !item.header && !item.childNodes;
+const isFocusable = (item) => isLeaf(item) || item.expanded !== void 0;
+const useKeyboardNavigation = ({
+  containerRef,
+  defaultHighlightedIndex = -1,
+  disableHighlightOnFocus,
+  highlightedIndex: highlightedIndexProp,
+  indexPositions,
+  onHighlight,
+  onKeyboardNavigation,
+  restoreLastFocus,
+  selected
+}) => {
+  const lastFocus = React.useRef(-1);
+  const [, forceRender] = React.useState({});
+  const [highlightedIndex, setHighlightedIdx, isControlledHighlighting] = core.useControlled({
+    controlled: highlightedIndexProp,
+    default: defaultHighlightedIndex,
+    name: "UseKeyboardNavigation"
+  });
+  const setHighlightedIndex = React.useCallback(
+    (idx, fromKeyboard = false) => {
+      onHighlight == null ? void 0 : onHighlight(idx);
+      setHighlightedIdx(idx);
+      if (fromKeyboard) {
+        lastFocus.current = idx;
+      }
+    },
+    [onHighlight, setHighlightedIdx]
+  );
+  const nextPageItemIdx = React.useCallback(
+    async (e, index) => {
+      const { id } = indexPositions[index];
+      let result;
+      if (id) {
+        const itemEl = document.getElementById(id);
+        const { current: containerEl } = containerRef;
+        if (itemEl && containerEl) {
+          result = e.key === keyUtils.PageDown ? pageDown(containerEl, itemEl, indexPositions, index) : await pageUp(containerEl, itemEl, indexPositions, index);
+        }
+      }
+      return result != null ? result : index;
+    },
+    [containerRef, indexPositions]
+  );
+  const nextFocusableItemIdx = React.useCallback(
+    (key = keyUtils.ArrowDown, idx = key === keyUtils.ArrowDown ? -1 : indexPositions.length) => {
+      if (indexPositions.length === 0) {
+        return -1;
+      } else {
+        const indexOfSelectedItem = getIndexOfSelectedItem(
+          indexPositions,
+          selected
+        );
+        const startIdx = getStartIdx(
+          key,
+          idx,
+          indexOfSelectedItem,
+          indexPositions.length
+        );
+        let nextIdx = nextItemIdx(indexPositions.length, key, startIdx);
+        if (nextIdx === 0 && key === keyUtils.ArrowUp && !isFocusable(indexPositions[0])) {
+          return idx;
+        }
+        while (((key === keyUtils.ArrowDown || key === keyUtils.Home) && nextIdx < indexPositions.length || (key === keyUtils.ArrowUp || key === keyUtils.End) && nextIdx > 0) && !isFocusable(indexPositions[nextIdx])) {
+          nextIdx = nextItemIdx(indexPositions.length, key, nextIdx);
+        }
+        return nextIdx;
+      }
+    },
+    [indexPositions, selected]
+  );
+  const keyboardNavigation = React.useRef(false);
+  const ignoreFocus = React.useRef(false);
+  const setIgnoreFocus = (value) => ignoreFocus.current = value;
+  const handleFocus = React.useCallback(
+    (e) => {
+      if (ignoreFocus.current) {
+        ignoreFocus.current = false;
+      } else {
+        keyboardNavigation.current = true;
+        if (indexPositions.length === 0) {
+          setHighlightedIndex(LIST_FOCUS_VISIBLE);
+        } else if (highlightedIndex !== -1) {
+          forceRender({});
+        } else if (restoreLastFocus) {
+          if (lastFocus.current !== -1) {
+            setHighlightedIndex(lastFocus.current);
+          } else {
+            const selectedItemIdx = getIndexOfSelectedItem(
+              indexPositions,
+              selected
+            );
+            if (selectedItemIdx !== -1) {
+              setHighlightedIndex(selectedItemIdx);
+            } else {
+              setHighlightedIndex(0);
+            }
+          }
+        } else if (selectionTypes.hasSelection(selected)) {
+          const selectedItemIdx = getIndexOfSelectedItem(
+            indexPositions,
+            selected
+          );
+          setHighlightedIndex(selectedItemIdx);
+        } else if (disableHighlightOnFocus !== true) {
+          setHighlightedIndex(nextFocusableItemIdx());
+        }
+      }
+    },
+    [
+      disableHighlightOnFocus,
+      highlightedIndex,
+      indexPositions,
+      nextFocusableItemIdx,
+      restoreLastFocus,
+      selected,
+      setHighlightedIndex
+    ]
+  );
+  const navigateChildItems = React.useCallback(
+    async (e) => {
+      const nextIdx = e.key === keyUtils.PageDown || e.key === keyUtils.PageUp ? await nextPageItemIdx(e, highlightedIndex) : nextFocusableItemIdx(e.key, highlightedIndex);
+      console.log(
+        `useKeyboardNavigation navigateChildItems highlightedIndex = ${highlightedIndex} nextIdx = ${nextIdx}`
+      );
+      if (nextIdx !== highlightedIndex) {
+        setHighlightedIndex(nextIdx, true);
+      }
+      onKeyboardNavigation == null ? void 0 : onKeyboardNavigation(e, nextIdx);
+    },
+    [
+      highlightedIndex,
+      nextFocusableItemIdx,
+      nextPageItemIdx,
+      onKeyboardNavigation,
+      setHighlightedIndex
+    ]
+  );
+  const handleKeyDown = React.useCallback(
+    (e) => {
+      if (indexPositions.length > 0 && keyUtils.isNavigationKey(e)) {
+        e.preventDefault();
+        e.stopPropagation();
+        keyboardNavigation.current = true;
+        void navigateChildItems(e);
+      } else if (keyUtils.isCharacterKey(e)) {
+        keyboardNavigation.current = true;
+      }
+    },
+    [indexPositions, navigateChildItems]
+  );
+  const listProps = React.useMemo(() => {
+    return {
+      onBlur: (e) => {
+        const sourceTarget = e.target.closest(".saltList");
+        const destTarget = e.relatedTarget;
+        if (sourceTarget && !(sourceTarget == null ? void 0 : sourceTarget.contains(destTarget))) {
+          keyboardNavigation.current = false;
+          setHighlightedIdx(-1);
+          if (!restoreLastFocus) {
+            lastFocus.current = -1;
+          }
+        }
+      },
+      onFocus: handleFocus,
+      onKeyDown: handleKeyDown,
+      onMouseDownCapture: () => {
+        keyboardNavigation.current = false;
+        setIgnoreFocus(true);
+      },
+      onMouseMove: () => {
+        if (keyboardNavigation.current) {
+          keyboardNavigation.current = false;
+        }
+      },
+      onMouseLeave: () => {
+        keyboardNavigation.current = false;
+        setIgnoreFocus(false);
+        setHighlightedIndex(-1);
+      }
+    };
+  }, [
+    handleFocus,
+    handleKeyDown,
+    restoreLastFocus,
+    setHighlightedIdx,
+    setHighlightedIndex
+  ]);
+  return {
+    focusVisible: keyboardNavigation.current ? highlightedIndex : -1,
+    controlledHighlighting: isControlledHighlighting,
+    highlightedIndex,
+    setHighlightedIndex,
+    keyboardNavigation,
+    listProps,
+    setIgnoreFocus
+  };
+};
+
+exports.LIST_FOCUS_VISIBLE = LIST_FOCUS_VISIBLE;
+exports.useKeyboardNavigation = useKeyboardNavigation;
+//# sourceMappingURL=useKeyboardNavigation.js.map