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

package/dist-es/common-hooks/useCollapsibleGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollapsibleGroups.js","sources":["../src/common-hooks/useCollapsibleGroups.ts"],"sourcesContent":["import { type KeyboardEvent, type MouseEvent, useCallback } from \"react\";\nimport type { CollectionHookResult, CollectionItem } from \"./collectionTypes\";\nimport { ArrowLeft, ArrowRight, Enter } from \"./keyUtils\";\nimport type { ListHandlers } from \"./selectionTypes\";\n\nconst NO_HANDLERS = {};\nconst canToggleItem = (item: CollectionItem<unknown>) =>\n  Array.isArray(item.childNodes);\n// TODO how do we determine this and where does this function belong = in the collectionHook ?\nconst canSelectItem = (item: CollectionItem<unknown>) => true;\n\nconst toggleIconClicked = (el: HTMLElement) => {\n  const closestToggle = el.closest(\n    \"[data-toggle],[aria-expanded]\",\n  ) as HTMLElement;\n  return closestToggle.dataset.toggle === \"true\";\n};\n\ninterface CollapsibleHookProps<Item> {\n  collapsibleHeaders?: boolean;\n  collectionHook: CollectionHookResult<Item>;\n  highlightedIdx: number;\n  onToggle?: (node: Item) => void;\n}\n\ninterface CollapsibleHookResult<Item> {\n  onClick?: ListHandlers[\"onClick\"];\n  onKeyDown?: ListHandlers[\"onKeyDown\"];\n}\n\nexport const useCollapsibleGroups = <Item>({\n  collapsibleHeaders,\n  collectionHook,\n  highlightedIdx,\n  onToggle,\n}: CollapsibleHookProps<Item>): CollapsibleHookResult<Item> => {\n  const handleKeyDown = useCallback(\n    (e: KeyboardEvent) => {\n      if (e.key === ArrowRight || e.key === Enter) {\n        const item = collectionHook.data[highlightedIdx];\n        if (item) {\n          if (item.expanded === false && item.value) {\n            e.preventDefault();\n            collectionHook.expandGroupItem(item);\n            onToggle?.(item.value);\n          }\n        }\n      }\n\n      if (e.key === ArrowLeft || e.key === Enter) {\n        const item = collectionHook.data[highlightedIdx];\n        if (item) {\n          if (item.expanded && item.value) {\n            e.preventDefault();\n            collectionHook.collapseGroupItem(item);\n            onToggle?.(item.value);\n          }\n        }\n      }\n    },\n    [\n      collectionHook.collapseGroupItem,\n      collectionHook.data,\n      collectionHook.expandGroupItem,\n      highlightedIdx,\n    ],\n  );\n\n  const handleClick = useCallback(\n    (evt: MouseEvent<HTMLElement>) => {\n      console.log(`useCollapsibleGroups idx=${highlightedIdx}`);\n      const item = collectionHook.data[highlightedIdx];\n      console.log(evt.target, evt.currentTarget);\n      if (\n        item &&\n        canToggleItem(item) &&\n        (!canSelectItem(item) || toggleIconClicked(evt.target as HTMLElement))\n      ) {\n        evt.stopPropagation();\n        evt.preventDefault();\n        if (item.expanded === false && item.value) {\n          collectionHook.expandGroupItem(item);\n          onToggle?.(item.value);\n        } else if (item.expanded === true && item.value) {\n          collectionHook.collapseGroupItem(item);\n          onToggle?.(item.value);\n        }\n      }\n    },\n    [\n      collectionHook.collapseGroupItem,\n      collectionHook.data,\n      collectionHook.expandGroupItem,\n      highlightedIdx,\n    ],\n  );\n\n  /**\n   * These are List handlers, so we will not have reference to the actual node\n   * element. We must rely on highlightedIdx to tell us which node is interactive.\n   */\n  const listHandlers = {\n    onClick: handleClick,\n    onKeyDown: handleKeyDown,\n  };\n\n  return collapsibleHeaders ? listHandlers : NO_HANDLERS;\n};\n"],"names":[],"mappings":";;;AAKA,MAAM,cAAc,EAAC;AACrB,MAAM,gBAAgB,CAAC,IAAA,KACrB,KAAM,CAAA,OAAA,CAAQ,KAAK,UAAU,CAAA;AAI/B,MAAM,iBAAA,GAAoB,CAAC,EAAoB,KAAA;AAC7C,EAAA,MAAM,gBAAgB,EAAG,CAAA,OAAA;AAAA,IACvB;AAAA,GACF;AACA,EAAO,OAAA,aAAA,CAAc,QAAQ,MAAW,KAAA,MAAA;AAC1C,CAAA;AAcO,MAAM,uBAAuB,CAAO;AAAA,EACzC,kBAAA;AAAA,EACA,cAAA;AAAA,EACA,cAAA;AAAA,EACA;AACF,CAA+D,KAAA;AAC7D,EAAA,MAAM,aAAgB,GAAA,WAAA;AAAA,IACpB,CAAC,CAAqB,KAAA;AACpB,MAAA,IAAI,CAAE,CAAA,GAAA,KAAQ,UAAc,IAAA,CAAA,CAAE,QAAQ,KAAO,EAAA;AAC3C,QAAM,MAAA,IAAA,GAAO,cAAe,CAAA,IAAA,CAAK,cAAc,CAAA;AAC/C,QAAA,IAAI,IAAM,EAAA;AACR,UAAA,IAAI,IAAK,CAAA,QAAA,KAAa,KAAS,IAAA,IAAA,CAAK,KAAO,EAAA;AACzC,YAAA,CAAA,CAAE,cAAe,EAAA;AACjB,YAAA,cAAA,CAAe,gBAAgB,IAAI,CAAA;AACnC,YAAA,QAAA,IAAA,IAAA,GAAA,MAAA,GAAA,QAAA,CAAW,IAAK,CAAA,KAAA,CAAA;AAAA;AAClB;AACF;AAGF,MAAA,IAAI,CAAE,CAAA,GAAA,KAAQ,SAAa,IAAA,CAAA,CAAE,QAAQ,KAAO,EAAA;AAC1C,QAAM,MAAA,IAAA,GAAO,cAAe,CAAA,IAAA,CAAK,cAAc,CAAA;AAC/C,QAAA,IAAI,IAAM,EAAA;AACR,UAAI,IAAA,IAAA,CAAK,QAAY,IAAA,IAAA,CAAK,KAAO,EAAA;AAC/B,YAAA,CAAA,CAAE,cAAe,EAAA;AACjB,YAAA,cAAA,CAAe,kBAAkB,IAAI,CAAA;AACrC,YAAA,QAAA,IAAA,IAAA,GAAA,MAAA,GAAA,QAAA,CAAW,IAAK,CAAA,KAAA,CAAA;AAAA;AAClB;AACF;AACF,KACF;AAAA,IACA;AAAA,MACE,cAAe,CAAA,iBAAA;AAAA,MACf,cAAe,CAAA,IAAA;AAAA,MACf,cAAe,CAAA,eAAA;AAAA,MACf;AAAA;AACF,GACF;AAEA,EAAA,MAAM,WAAc,GAAA,WAAA;AAAA,IAClB,CAAC,GAAiC,KAAA;AAChC,MAAQ,OAAA,CAAA,GAAA,CAAI,CAA4B,yBAAA,EAAA,cAAc,CAAE,CAAA,CAAA;AACxD,MAAM,MAAA,IAAA,GAAO,cAAe,CAAA,IAAA,CAAK,cAAc,CAAA;AAC/C,MAAA,OAAA,CAAQ,GAAI,CAAA,GAAA,CAAI,MAAQ,EAAA,GAAA,CAAI,aAAa,CAAA;AACzC,MACE,IAAA,IAAA,IACA,aAAc,CAAA,IAAI,CACjB,KAAwB,iBAAA,CAAkB,GAAI,CAAA,MAAqB,CACpE,CAAA,EAAA;AACA,QAAA,GAAA,CAAI,eAAgB,EAAA;AACpB,QAAA,GAAA,CAAI,cAAe,EAAA;AACnB,QAAA,IAAI,IAAK,CAAA,QAAA,KAAa,KAAS,IAAA,IAAA,CAAK,KAAO,EAAA;AACzC,UAAA,cAAA,CAAe,gBAAgB,IAAI,CAAA;AACnC,UAAA,QAAA,IAAA,IAAA,GAAA,MAAA,GAAA,QAAA,CAAW,IAAK,CAAA,KAAA,CAAA;AAAA,SACP,MAAA,IAAA,IAAA,CAAK,QAAa,KAAA,IAAA,IAAQ,KAAK,KAAO,EAAA;AAC/C,UAAA,cAAA,CAAe,kBAAkB,IAAI,CAAA;AACrC,UAAA,QAAA,IAAA,IAAA,GAAA,MAAA,GAAA,QAAA,CAAW,IAAK,CAAA,KAAA,CAAA;AAAA;AAClB;AACF,KACF;AAAA,IACA;AAAA,MACE,cAAe,CAAA,iBAAA;AAAA,MACf,cAAe,CAAA,IAAA;AAAA,MACf,cAAe,CAAA,eAAA;AAAA,MACf;AAAA;AACF,GACF;AAMA,EAAA,MAAM,YAAe,GAAA;AAAA,IACnB,OAAS,EAAA,WAAA;AAAA,IACT,SAAW,EAAA;AAAA,GACb;AAEA,EAAA,OAAO,qBAAqB,YAAe,GAAA,WAAA;AAC7C;;;;"}

package/dist-es/common-hooks/useCollectionItems.js

@@ -0,0 +1,288 @@
+import { useState, useRef, useMemo, useCallback, isValidElement } from 'react';
+import { itemToString } from './itemToString.js';
+import { isFocusable, isDisabled, countChildItems, isHeader, isGroupNode, sourceItems, childItems, isParentPath, replaceCollectionItem } from './utils/collection-item-utils.js';
+import { getDefaultFilter, getDefaultFilterRegex } from './utils/filter-utils.js';
+import { useCollection } from './collectionProvider.js';
+
+const defaultCollectionOptions = {};
+const useCollectionItems = ({
+  children,
+  id: idRoot,
+  label = "",
+  options = defaultCollectionOptions,
+  // revealSelected = false,
+  source
+}) => {
+  const { getItemId } = options;
+  const [, forceUpdate] = useState(null);
+  const inheritedCollectionHook = useCollection();
+  const dataRef = useRef([]);
+  const flattenedDataRef = useRef([]);
+  const EMPTY_COLLECTION = useMemo(() => [], []);
+  const filterPattern = useRef(options.filterPattern ?? "");
+  const {
+    getFilterRegex = getDefaultFilterRegex,
+    noChildrenLabel,
+    itemToString: itemToString$1 = itemToString
+  } = options;
+  const isExpanded = useCallback(
+    (path) => {
+      return options.defaultExpanded || false;
+    },
+    [options.defaultExpanded]
+  );
+  const addMetadataToItems = useCallback(
+    (items, indexer, level = 1, path = "", results = [], flattenedCollection2 = [], flattenedSource2 = []) => {
+      items.forEach((item, i, all) => {
+        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 = item.id ?? (getItemId ? getItemId(i) : `${idRoot}-${childPath}`);
+        const expanded = nonCollapsible ? void 0 : item.expanded ?? isExpanded(id);
+        const normalisedItem = {
+          ...item,
+          childNodes: void 0,
+          count: !isNonCollapsibleGroupNode && expanded === void 0 ? 0 : countChildItems(item, all, i),
+          description: item.description,
+          disabled: isDisabled(item.value),
+          focusable: 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 = useCallback(() => {
+    if (filterPattern.current) {
+      return getDefaultFilter(filterPattern.current, getFilterRegex);
+    }
+    return null;
+  }, [getFilterRegex]);
+  const collectVisibleItems = useCallback(
+    (items, filter = getFilter(), results = [], idx = { value: 0 }) => {
+      let skipToNextHeader = false;
+      for (const item of items) {
+        if (!(skipToNextHeader && !isHeader(item))) {
+          if (item.value !== null && (filter === null || filter(itemToString$1(item.value)))) {
+            results[idx.value] = item;
+            idx.value += 1;
+          }
+          skipToNextHeader = false;
+          if (isHeader(item) && item.expanded === false) {
+            skipToNextHeader = true;
+          } else if (isGroupNode(item)) {
+            if (item.expanded !== false && item.childNodes) {
+              collectVisibleItems(item.childNodes, filter, results, idx);
+            }
+          }
+        }
+      }
+      return results;
+    },
+    [getFilter, itemToString$1]
+  );
+  const partialCollectionItems = useMemo(() => {
+    return inheritedCollectionHook ? EMPTY_COLLECTION : sourceItems(source, { itemToString: itemToString$1, noChildrenLabel }) || childItems(children) || [];
+  }, [
+    inheritedCollectionHook,
+    EMPTY_COLLECTION,
+    source,
+    itemToString$1,
+    noChildrenLabel,
+    children
+  ]);
+  const [collectionItems, flattenedSource, flattenedCollection] = useMemo(
+    () => inheritedCollectionHook ? [EMPTY_COLLECTION, EMPTY_COLLECTION, EMPTY_COLLECTION] : (
+      //@ts-ignore
+      addMetadataToItems(partialCollectionItems, { value: 0 })
+    ),
+    [
+      EMPTY_COLLECTION,
+      addMetadataToItems,
+      inheritedCollectionHook,
+      partialCollectionItems
+    ]
+  );
+  flattenedDataRef.current = flattenedCollection;
+  useMemo(
+    () => inheritedCollectionHook ? EMPTY_COLLECTION : dataRef.current = collectVisibleItems(collectionItems),
+    [
+      EMPTY_COLLECTION,
+      collectVisibleItems,
+      collectionItems,
+      inheritedCollectionHook
+    ]
+  );
+  const collectionItemsRef = useRef(collectionItems);
+  const setFilterPattern = useCallback(
+    (pattern = "") => {
+      if (typeof pattern === "string") {
+        filterPattern.current = pattern;
+        dataRef.current = collectVisibleItems(collectionItems);
+        forceUpdate({});
+      }
+    },
+    [collectionItems, collectVisibleItems]
+  );
+  const itemById = useCallback(
+    (id, target = collectionItems) => {
+      const sourceWithId = target.find(
+        (i) => {
+          var _a;
+          return i.id === id || ((_a = i == null ? void 0 : i.childNodes) == null ? void 0 : _a.length) && isParentPath(i.id, id);
+        }
+      );
+      if ((sourceWithId == null ? void 0 : sourceWithId.id) === id) {
+        return flattenedSource == null ? void 0 : flattenedSource[sourceWithId.index];
+      }
+      if (sourceWithId) {
+        return itemById(id, sourceWithId.childNodes);
+      }
+      throw Error(`useCollectionData itemById, id ${id} not found `);
+    },
+    [flattenedSource, collectionItems]
+  );
+  const toCollectionItem = useCallback(
+    (item) => {
+      const collectionItem = flattenedDataRef.current.find(
+        (i) => (
+          // const collectionItem = collectionItemsRef.current.find((i) =>
+          //@ts-ignore
+          isValidElement(i.value) ? i.label === item : i.value === item
+        )
+      );
+      if (collectionItem) {
+        return collectionItem;
+      }
+      throw Error("useCollectionData toCollectionItem, item not found ");
+    },
+    []
+  );
+  const itemToCollectionItem = useCallback(
+    (sel) => {
+      if (sel === null) {
+        return null;
+      }
+      if (Array.isArray(sel)) {
+        const result = [];
+        for (const item of sel) {
+          const collectionItem = toCollectionItem(item);
+          result.push(collectionItem);
+        }
+        return result;
+      }
+      if (sel !== void 0) {
+        return toCollectionItem(sel);
+      }
+      return void 0;
+    },
+    [toCollectionItem]
+  );
+  const stringToCollectionItem = useCallback(
+    (value) => {
+      const toCollectionItem2 = (item) => {
+        const collectionItem = flattenedDataRef.current.find(
+          (i) => (
+            // const collectionItem = collectionItemsRef.current.find((i) =>
+            //@ts-ignore
+            isValidElement(i.value) ? i.label === item : i.value !== null && itemToString$1(i.value) === item
+          )
+        );
+        if (collectionItem) {
+          return collectionItem;
+        }
+      };
+      if (value === null) {
+        return null;
+      }
+      if (Array.isArray(value)) {
+        const result = [];
+        for (const item of value) {
+          const collectionItem = toCollectionItem2(item);
+          if (collectionItem) {
+            result.push(collectionItem);
+          }
+        }
+        return result;
+      }
+      if (value !== void 0) {
+        return toCollectionItem2(value);
+      }
+      return void 0;
+    },
+    [itemToString$1]
+  );
+  const itemToId = useCallback((item) => {
+    for (const collectionItem of collectionItemsRef.current) {
+      if (item === collectionItem.value) {
+        return collectionItem.id;
+      }
+    }
+    throw Error("useCollectionData itemToId, item not found");
+  }, []);
+  const collapseGroupItem = useCallback(
+    (item) => {
+      collectionItemsRef.current = replaceCollectionItem(
+        collectionItemsRef.current,
+        item.id,
+        {
+          expanded: false
+        }
+      );
+      dataRef.current = collectVisibleItems(collectionItemsRef.current);
+      forceUpdate({});
+    },
+    [collectVisibleItems]
+  );
+  const expandGroupItem = useCallback(
+    (item) => {
+      collectionItemsRef.current = replaceCollectionItem(
+        collectionItemsRef.current,
+        item.id,
+        {
+          expanded: true
+        }
+      );
+      dataRef.current = collectVisibleItems(collectionItemsRef.current);
+      forceUpdate({});
+    },
+    [collectVisibleItems]
+  );
+  return inheritedCollectionHook || {
+    collapseGroupItem,
+    data: dataRef.current,
+    expandGroupItem,
+    // why not toggle, or just rely on setdata ?
+    setFilterPattern,
+    itemById,
+    itemToId,
+    toCollectionItem,
+    itemToCollectionItem,
+    stringToCollectionItem
+  };
+};
+
+export { useCollectionItems };
+//# sourceMappingURL=useCollectionItems.js.map

package/dist-es/common-hooks/useCollectionItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollectionItems.js","sources":["../src/common-hooks/useCollectionItems.ts"],"sourcesContent":["import { isValidElement, useCallback, useMemo, useRef, useState } from \"react\";\nimport type {\n  CollectionHookProps,\n  CollectionHookResult,\n  CollectionIndexer,\n  CollectionItem,\n} from \"./collectionTypes\";\nimport { itemToString as defaultItemToString } from \"./itemToString\";\nimport {\n  type FilterPredicate,\n  childItems,\n  countChildItems,\n  getDefaultFilter,\n  getDefaultFilterRegex,\n  isDisabled,\n  isFocusable,\n  isGroupNode,\n  isHeader,\n  isParentPath,\n  replaceCollectionItem,\n  sourceItems,\n} from \"./utils\";\n\nimport { useCollection } from \"./collectionProvider\";\nimport type {\n  SelectionStrategy,\n  SingleSelectionStrategy,\n} from \"./selectionTypes\";\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    }\n    return null;\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(collectionItems);\n        forceUpdate({});\n      }\n    },\n    [collectionItems, 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      }\n      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      }\n      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      }\n      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      }\n      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      }\n      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":["itemToString","defaultItemToString","flattenedCollection","flattenedSource","children","toCollectionItem"],"mappings":"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"}

package/dist-es/common-hooks/useImperativeScrollingAPI.js

@@ -0,0 +1,54 @@
+import { useMemo, useImperativeHandle } from 'react';
+
+const noScrolling = {
+  scrollToIndex: () => void 0,
+  scrollToItem: () => void 0,
+  scrollTo: () => void 0
+};
+const useImperativeScrollingAPI = ({
+  collectionHook,
+  forwardedRef,
+  scrollableRef,
+  scrollIntoView
+}) => {
+  const scrollHandles = 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,
+      scrollableRef
+    ]
+  );
+  useImperativeHandle(
+    forwardedRef,
+    () => {
+      if (scrollableRef.current) {
+        return scrollHandles;
+      }
+      return noScrolling;
+    },
+    [scrollHandles, scrollableRef]
+  );
+};
+
+export { useImperativeScrollingAPI };
+//# sourceMappingURL=useImperativeScrollingAPI.js.map

package/dist-es/common-hooks/useImperativeScrollingAPI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImperativeScrollingAPI.js","sources":["../src/common-hooks/useImperativeScrollingAPI.ts"],"sourcesContent":["import {\n  type ForwardedRef,\n  type MutableRefObject,\n  useImperativeHandle,\n  useMemo,\n} from \"react\";\nimport type { 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: () => undefined,\n  scrollToItem: () => undefined,\n  scrollTo: () => 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    [\n      collectionHook.data,\n      collectionHook.toCollectionItem,\n      scrollIntoView,\n      scrollableRef,\n    ],\n  );\n\n  useImperativeHandle(\n    forwardedRef,\n    () => {\n      if (scrollableRef.current) {\n        return scrollHandles;\n      }\n      return noScrolling;\n    },\n    [scrollHandles, scrollableRef],\n  );\n};\n"],"names":[],"mappings":";;AAqBA,MAAM,WAAqC,GAAA;AAAA,EACzC,eAAe,MAAM,MAAA;AAAA,EACrB,cAAc,MAAM,MAAA;AAAA,EACpB,UAAU,MAAM;AAClB,CAAA;AAEO,MAAM,4BAA4B,CAAO;AAAA,EAC9C,cAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAA8B,KAAA;AAC5B,EAAA,MAAM,aAAoC,GAAA,OAAA;AAAA,IACxC,OAAO;AAAA,MACL,aAAA,EAAe,CAAC,SAAsB,KAAA;AACpC,QAAM,MAAA,cAAA,GAAiB,cAAe,CAAA,IAAA,CAAK,SAAS,CAAA;AACpD,QAAA,IAAI,cAAgB,EAAA;AAClB,UAAiB,cAAA,IAAA,IAAA,GAAA,MAAA,GAAA,cAAA,CAAA,cAAA,CAAA;AAAA;AACnB,OACF;AAAA,MACA,YAAA,EAAc,CAAC,IAAe,KAAA;AAC5B,QAAM,MAAA,cAAA,GAAiB,cAAe,CAAA,gBAAA,CAAiB,IAAI,CAAA;AAC3D,QAAA,IAAI,cAAgB,EAAA;AAClB,UAAiB,cAAA,IAAA,IAAA,GAAA,MAAA,GAAA,cAAA,CAAA,cAAA,CAAA;AAAA;AACnB,OACF;AAAA,MACA,QAAA,EAAU,CAAC,YAAyB,KAAA;AAClC,QAAA,IAAI,+CAAe,OAAS,EAAA;AAC1B,UAAA,aAAA,CAAc,QAAQ,SAAY,GAAA,YAAA;AAAA;AACpC;AACF,KACF,CAAA;AAAA,IACA;AAAA,MACE,cAAe,CAAA,IAAA;AAAA,MACf,cAAe,CAAA,gBAAA;AAAA,MACf,cAAA;AAAA,MACA;AAAA;AACF,GACF;AAEA,EAAA,mBAAA;AAAA,IACE,YAAA;AAAA,IACA,MAAM;AACJ,MAAA,IAAI,cAAc,OAAS,EAAA;AACzB,QAAO,OAAA,aAAA;AAAA;AAET,MAAO,OAAA,WAAA;AAAA,KACT;AAAA,IACA,CAAC,eAAe,aAAa;AAAA,GAC/B;AACF;;;;"}