@itwin/presentation-hierarchies-react 1.6.0 → 2.0.0-alpha.0

package/lib/cjs/presentation-hierarchies-react/UseIModelTree.js

@@ -1,66 +0,0 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
- * See LICENSE.md in the project root for license terms and full copyright notice.
- *--------------------------------------------------------------------------------------------*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useIModelTree = useIModelTree;
-exports.useIModelUnifiedSelectionTree = useIModelUnifiedSelectionTree;
-const react_1 = require("react");
-const presentation_hierarchies_1 = require("@itwin/presentation-hierarchies");
-const UseTree_js_1 = require("./UseTree.js");
-/**
- * A React hook that creates state for a tree component whose displayed hierarchy is based on
- * iModel data.
- *
- * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a
- * component-agnostic result which may be used to render the hierarchy using any UI framework.
- *
- * See `README.md` for an example
- *
- * @see `useTree`
- * @see `useIModelUnifiedSelectionTree`
- * @public
- */
-function useIModelTree(props) {
-    const { imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings, ...rest } = props;
-    return (0, UseTree_js_1.useTree)({
-        ...rest,
-        ...useIModelTreeProps({ imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings }),
-    });
-}
-/**
- * A React hook that creates state for a tree component whose displayed hierarchy is based on
- * iModel data and that is integrated with unified selection through the given selection
- * storage (previously the storage was provided through the, now deprecated, `UnifiedSelectionProvider`).
- *
- * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a
- * component-agnostic result which may be used to render the hierarchy using any UI framework.
- *
- * See `README.md` for an example
- *
- * @see `useIModelTree`
- * @see `useUnifiedSelectionTree`
- * @see `UnifiedSelectionProvider`
- * @public
- */
-function useIModelUnifiedSelectionTree(props) {
-    const { imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings, ...rest } = props;
-    return (0, UseTree_js_1.useUnifiedSelectionTree)({
-        ...rest,
-        ...useIModelTreeProps({ imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings }),
-    });
-}
-function useIModelTreeProps(props) {
-    const { imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings } = props;
-    return {
-        getHierarchyProvider: (0, react_1.useCallback)(() => (0, presentation_hierarchies_1.createIModelHierarchyProvider)({
-            imodelAccess,
-            imodelChanged,
-            hierarchyDefinition: getHierarchyDefinition({ imodelAccess }),
-            localizedStrings,
-        }), [imodelAccess, imodelChanged, getHierarchyDefinition, localizedStrings]),
-        getFilteredPaths: (0, react_1.useCallback)(async () => getFilteredPaths?.({ imodelAccess }), [imodelAccess, getFilteredPaths]),
-    };
-}
-//# sourceMappingURL=UseIModelTree.js.map

package/lib/cjs/presentation-hierarchies-react/UseIModelTree.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UseIModelTree.js","sourceRoot":"","sources":["../../../src/presentation-hierarchies-react/UseIModelTree.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;AA2ChG,sCAMC;AAiBD,sEAMC;AAtED,iCAAoC;AACpC,8EAA6H;AAG7H,6CAA6F;AAwB7F;;;;;;;;;;;;GAYG;AACH,SAAgB,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACnH,OAAO,IAAA,oBAAO,EAAC;QACb,GAAG,IAAI;QACP,GAAG,kBAAkB,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACnH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,6BAA6B,CAAC,KAAwD;IACpG,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACnH,OAAO,IAAA,oCAAuB,EAAC;QAC7B,GAAG,IAAI;QACP,GAAG,kBAAkB,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACnH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAsI;IAEtI,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAC1G,OAAO;QACL,oBAAoB,EAAE,IAAA,mBAAW,EAC/B,GAAG,EAAE,CACH,IAAA,wDAA6B,EAAC;YAC5B,YAAY;YACZ,aAAa;YACb,mBAAmB,EAAE,sBAAsB,CAAC,EAAE,YAAY,EAAE,CAAC;YAC7D,gBAAgB;SACjB,CAAC,EACJ,CAAC,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,CAAC,CACxE;QACD,gBAAgB,EAAE,IAAA,mBAAW,EAAC,KAAK,IAAI,EAAE,CAAC,gBAAgB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;KAClH,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { useCallback } from \"react\";\nimport { createIModelHierarchyProvider, HierarchyDefinition, HierarchyFilteringPath } from \"@itwin/presentation-hierarchies\";\nimport { Props } from \"@itwin/presentation-shared\";\nimport { UseUnifiedTreeSelectionProps } from \"./internal/UseUnifiedSelection.js\";\nimport { useTree, UseTreeProps, UseTreeResult, useUnifiedSelectionTree } from \"./UseTree.js\";\n\n/** @public */\ntype IModelHierarchyProviderProps = Props<typeof createIModelHierarchyProvider>;\n\n/** @public */\ntype IModelAccess = IModelHierarchyProviderProps[\"imodelAccess\"];\n\n/**\n * Props for `useIModelTree` and `useIModelUnifiedSelectionTree` hooks.\n * @public\n */\ntype UseIModelTreeProps = Omit<UseTreeProps, \"getHierarchyProvider\" | \"getFilteredPaths\"> &\n  Pick<IModelHierarchyProviderProps, \"localizedStrings\" | \"imodelAccess\" | \"imodelChanged\"> & {\n    /** Provides the hierarchy definition for the tree. */\n    getHierarchyDefinition: (props: { imodelAccess: IModelAccess }) => HierarchyDefinition;\n\n    /** Provides paths to filtered nodes. */\n    getFilteredPaths?: (props: {\n      /** Object that provides access to the iModel schema and can run queries against the iModel. */\n      imodelAccess: IModelAccess;\n    }) => Promise<HierarchyFilteringPath[] | undefined>;\n  };\n\n/**\n * A React hook that creates state for a tree component whose displayed hierarchy is based on\n * iModel data.\n *\n * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a\n * component-agnostic result which may be used to render the hierarchy using any UI framework.\n *\n * See `README.md` for an example\n *\n * @see `useTree`\n * @see `useIModelUnifiedSelectionTree`\n * @public\n */\nexport function useIModelTree(props: UseIModelTreeProps): UseTreeResult {\n  const { imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings, ...rest } = props;\n  return useTree({\n    ...rest,\n    ...useIModelTreeProps({ imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings }),\n  });\n}\n\n/**\n * A React hook that creates state for a tree component whose displayed hierarchy is based on\n * iModel data and that is integrated with unified selection through the given selection\n * storage (previously the storage was provided through the, now deprecated, `UnifiedSelectionProvider`).\n *\n * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a\n * component-agnostic result which may be used to render the hierarchy using any UI framework.\n *\n * See `README.md` for an example\n *\n * @see `useIModelTree`\n * @see `useUnifiedSelectionTree`\n * @see `UnifiedSelectionProvider`\n * @public\n */\nexport function useIModelUnifiedSelectionTree(props: UseIModelTreeProps & UseUnifiedTreeSelectionProps): UseTreeResult {\n  const { imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings, ...rest } = props;\n  return useUnifiedSelectionTree({\n    ...rest,\n    ...useIModelTreeProps({ imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings }),\n  });\n}\n\nfunction useIModelTreeProps(\n  props: Pick<UseIModelTreeProps, \"imodelAccess\" | \"imodelChanged\" | \"getHierarchyDefinition\" | \"getFilteredPaths\" | \"localizedStrings\">,\n): Pick<UseTreeProps, \"getHierarchyProvider\" | \"getFilteredPaths\"> {\n  const { imodelAccess, imodelChanged, getHierarchyDefinition, getFilteredPaths, localizedStrings } = props;\n  return {\n    getHierarchyProvider: useCallback(\n      () =>\n        createIModelHierarchyProvider({\n          imodelAccess,\n          imodelChanged,\n          hierarchyDefinition: getHierarchyDefinition({ imodelAccess }),\n          localizedStrings,\n        }),\n      [imodelAccess, imodelChanged, getHierarchyDefinition, localizedStrings],\n    ),\n    getFilteredPaths: useCallback(async () => getFilteredPaths?.({ imodelAccess }), [imodelAccess, getFilteredPaths]),\n  };\n}\n"]}

package/lib/cjs/presentation-hierarchies-react/UseSelectionHandler.d.ts

@@ -1,46 +0,0 @@
-import { PresentationHierarchyNode } from "./TreeNode.js";
-import { useTree } from "./UseTree.js";
-/**
- * A union of different supported selection modes in a tree component:
- * - `none` - no selection is allowed,
- * - `single` - only one node can be selected at a time,
- * - `extended` - multiple nodes can be selected using shift and ctrl keys,
- * - `multiple` - multiple nodes can be selected without using shift or ctrl keys.
- *
- * @public
- */
-export type SelectionMode = "none" | "single" | "extended" | "multiple";
-/**
- * Type of selection change.
- * - `add` - a node was added to the selection,
- * - `replace` - a selected node was replaced with a different one,
- * - `remove` - a node was removed from the selection.
- *
- * @public
- */
-export type SelectionChangeType = "add" | "replace" | "remove";
-/**
- * Props for `useSelectionHandler` hook.
- * @public
- */
-type UseSelectionHandlerProps = Pick<ReturnType<typeof useTree>, "rootNodes" | "selectNodes"> & {
-    /** Selection mode that the component is working in. */
-    selectionMode: SelectionMode;
-};
-/**
- * Result of `useSelectionHandler` hook.
- * @public
- */
-interface UseSelectionHandlerResult {
-    /** Should be called by node renderer when a node component is clicked. */
-    onNodeClick: (node: PresentationHierarchyNode, isSelected: boolean, event: React.MouseEvent<HTMLElement, MouseEvent>) => void;
-    /** Should be called by node renderer when a keyboard event happens on a node. */
-    onNodeKeyDown: (node: PresentationHierarchyNode, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => void;
-}
-/**
- * A react hook that helps implement different selection modes in a tree component created using `useTree` hook.
- * @public
- */
-export declare function useSelectionHandler(props: UseSelectionHandlerProps): UseSelectionHandlerResult;
-export {};
-//# sourceMappingURL=UseSelectionHandler.d.ts.map

package/lib/cjs/presentation-hierarchies-react/UseSelectionHandler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UseSelectionHandler.d.ts","sourceRoot":"","sources":["../../../src/presentation-hierarchies-react/UseSelectionHandler.ts"],"names":[],"mappings":"AAMA,OAAO,EAA+B,yBAAyB,EAAwB,MAAM,eAAe,CAAC;AAC7G,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D;;;GAGG;AACH,KAAK,wBAAwB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,GAAG;IAC9F,uDAAuD;IACvD,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,UAAU,yBAAyB;IACjC,0EAA0E;IAC1E,WAAW,EAAE,CAAC,IAAI,EAAE,yBAAyB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,KAAK,IAAI,CAAC;IAC9H,iFAAiF;IACjF,aAAa,EAAE,CAAC,IAAI,EAAE,yBAAyB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACxH;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,yBAAyB,CAiE9F"}

package/lib/cjs/presentation-hierarchies-react/UseSelectionHandler.js

@@ -1,101 +0,0 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
- * See LICENSE.md in the project root for license terms and full copyright notice.
- *--------------------------------------------------------------------------------------------*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useSelectionHandler = useSelectionHandler;
-const react_1 = require("react");
-const TreeNode_js_1 = require("./TreeNode.js");
-/**
- * A react hook that helps implement different selection modes in a tree component created using `useTree` hook.
- * @public
- */
-function useSelectionHandler(props) {
-    const { rootNodes, selectionMode, selectNodes } = props;
-    const previousSelectionRef = (0, react_1.useRef)(undefined);
-    const state = (0, react_1.useRef)({
-        flatNodeList: [],
-        nodeIdToIndexMap: new Map(),
-    });
-    (0, react_1.useEffect)(() => {
-        if (!rootNodes) {
-            return;
-        }
-        state.current = computeFlatNodeList(rootNodes);
-    }, [rootNodes]);
-    const getNodeRange = (firstId, secondId) => {
-        const getIndex = (nodeId) => {
-            return nodeId ? state.current.nodeIdToIndexMap.get(nodeId) : 0;
-        };
-        const firstIndex = getIndex(firstId);
-        const secondIndex = getIndex(secondId);
-        if (firstIndex === undefined || secondIndex === undefined) {
-            return [];
-        }
-        const startingIndex = Math.min(firstIndex, secondIndex);
-        const endIndex = Math.max(firstIndex, secondIndex);
-        return state.current.flatNodeList.slice(startingIndex, endIndex + 1);
-    };
-    const onNodeSelect = (0, react_1.useCallback)((nodeId, isSelected, shiftDown, ctrlDown) => {
-        const selection = getSelectionAction(selectionMode, isSelected, shiftDown, ctrlDown);
-        if (selection.type === "disabled") {
-            return;
-        }
-        const nodes = selection.select === "range" ? getNodeRange(previousSelectionRef.current, nodeId) : [nodeId];
-        if (!nodes.length) {
-            return;
-        }
-        selection.select !== "range" && (previousSelectionRef.current = nodeId);
-        selectNodes(nodes, selection.type);
-    }, [selectionMode, selectNodes]);
-    const onNodeClick = (0, react_1.useCallback)((node, isSelected, event) => {
-        return onNodeSelect(node.id, isSelected, event.shiftKey, event.ctrlKey);
-    }, [onNodeSelect]);
-    const onNodeKeyDown = (0, react_1.useCallback)((node, isSelected, event) => {
-        if (event.key === " " || event.key === "Spacebar" || event.key === "Enter") {
-            return onNodeSelect(node.id, isSelected, event.shiftKey, event.ctrlKey);
-        }
-    }, [onNodeSelect]);
-    return { onNodeClick, onNodeKeyDown };
-}
-function getSelectionAction(selectionMode, isSelected, shiftDown, ctrlDown) {
-    switch (selectionMode) {
-        case "none":
-            return { select: "node", type: "disabled" };
-        case "single":
-            return { select: "node", type: isSelected ? "replace" : "remove" };
-        case "multiple":
-            return { select: "node", type: isSelected ? "add" : "remove" };
-        case "extended":
-            return getExtendedSelectionAction(isSelected, shiftDown, ctrlDown);
-    }
-}
-function getExtendedSelectionAction(isSelected, shiftDown, ctrlDown) {
-    if (shiftDown) {
-        return { select: "range", type: "replace" };
-    }
-    if (ctrlDown) {
-        return { select: "node", type: isSelected ? "add" : "remove" };
-    }
-    return { select: "node", type: isSelected ? "replace" : "disabled" };
-}
-function computeFlatNodeList(rootNodes) {
-    const flatNodeList = [];
-    const nodeIdToIndexMap = new Map();
-    const flattenNodeRecursively = (nodes) => {
-        nodes.forEach((node) => {
-            if (!(0, TreeNode_js_1.isPresentationHierarchyNode)(node)) {
-                return;
-            }
-            nodeIdToIndexMap.set(node.id, flatNodeList.length);
-            flatNodeList.push(node.id);
-            if (node.isExpanded && typeof node.children !== "boolean") {
-                flattenNodeRecursively(node.children);
-            }
-        });
-    };
-    flattenNodeRecursively(rootNodes);
-    return { flatNodeList, nodeIdToIndexMap };
-}
-//# sourceMappingURL=UseSelectionHandler.js.map

package/lib/cjs/presentation-hierarchies-react/UseSelectionHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UseSelectionHandler.js","sourceRoot":"","sources":["../../../src/presentation-hierarchies-react/UseSelectionHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { useCallback, useEffect, useRef } from \"react\";\nimport { isPresentationHierarchyNode, PresentationHierarchyNode, PresentationTreeNode } from \"./TreeNode.js\";\nimport { useTree } from \"./UseTree.js\";\n\n/**\n * A union of different supported selection modes in a tree component:\n * - `none` - no selection is allowed,\n * - `single` - only one node can be selected at a time,\n * - `extended` - multiple nodes can be selected using shift and ctrl keys,\n * - `multiple` - multiple nodes can be selected without using shift or ctrl keys.\n *\n * @public\n */\nexport type SelectionMode = \"none\" | \"single\" | \"extended\" | \"multiple\";\n\n/**\n * Type of selection change.\n * - `add` - a node was added to the selection,\n * - `replace` - a selected node was replaced with a different one,\n * - `remove` - a node was removed from the selection.\n *\n * @public\n */\nexport type SelectionChangeType = \"add\" | \"replace\" | \"remove\";\n\n/**\n * Props for `useSelectionHandler` hook.\n * @public\n */\ntype UseSelectionHandlerProps = Pick<ReturnType<typeof useTree>, \"rootNodes\" | \"selectNodes\"> & {\n  /** Selection mode that the component is working in. */\n  selectionMode: SelectionMode;\n};\n\n/**\n * Result of `useSelectionHandler` hook.\n * @public\n */\ninterface UseSelectionHandlerResult {\n  /** Should be called by node renderer when a node component is clicked. */\n  onNodeClick: (node: PresentationHierarchyNode, isSelected: boolean, event: React.MouseEvent<HTMLElement, MouseEvent>) => void;\n  /** Should be called by node renderer when a keyboard event happens on a node. */\n  onNodeKeyDown: (node: PresentationHierarchyNode, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => void;\n}\n\ninterface FlatTreeState {\n  flatNodeList: Array<string>;\n  nodeIdToIndexMap: Map<string, number>;\n}\n\n/**\n * A react hook that helps implement different selection modes in a tree component created using `useTree` hook.\n * @public\n */\nexport function useSelectionHandler(props: UseSelectionHandlerProps): UseSelectionHandlerResult {\n  const { rootNodes, selectionMode, selectNodes } = props;\n  const previousSelectionRef = useRef<string | undefined>(undefined);\n  const state = useRef<FlatTreeState>({\n    flatNodeList: [],\n    nodeIdToIndexMap: new Map(),\n  });\n\n  useEffect(() => {\n    if (!rootNodes) {\n      return;\n    }\n    state.current = computeFlatNodeList(rootNodes);\n  }, [rootNodes]);\n\n  const getNodeRange = (firstId?: string, secondId?: string) => {\n    const getIndex = (nodeId?: string) => {\n      return nodeId ? state.current.nodeIdToIndexMap.get(nodeId) : 0;\n    };\n    const firstIndex = getIndex(firstId);\n    const secondIndex = getIndex(secondId);\n    if (firstIndex === undefined || secondIndex === undefined) {\n      return [];\n    }\n\n    const startingIndex = Math.min(firstIndex, secondIndex);\n    const endIndex = Math.max(firstIndex, secondIndex);\n    return state.current.flatNodeList.slice(startingIndex, endIndex + 1);\n  };\n\n  const onNodeSelect = useCallback(\n    (nodeId: string, isSelected: boolean, shiftDown: boolean, ctrlDown: boolean) => {\n      const selection = getSelectionAction(selectionMode, isSelected, shiftDown, ctrlDown);\n      if (selection.type === \"disabled\") {\n        return;\n      }\n\n      const nodes = selection.select === \"range\" ? getNodeRange(previousSelectionRef.current, nodeId) : [nodeId];\n      if (!nodes.length) {\n        return;\n      }\n\n      selection.select !== \"range\" && (previousSelectionRef.current = nodeId);\n      selectNodes(nodes, selection.type);\n    },\n    [selectionMode, selectNodes],\n  );\n\n  const onNodeClick = useCallback(\n    (node: PresentationHierarchyNode, isSelected: boolean, event: React.MouseEvent<HTMLElement, MouseEvent>) => {\n      return onNodeSelect(node.id, isSelected, event.shiftKey, event.ctrlKey);\n    },\n    [onNodeSelect],\n  );\n\n  const onNodeKeyDown = useCallback(\n    (node: PresentationHierarchyNode, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => {\n      if (event.key === \" \" || event.key === \"Spacebar\" || event.key === \"Enter\") {\n        return onNodeSelect(node.id, isSelected, event.shiftKey, event.ctrlKey);\n      }\n    },\n    [onNodeSelect],\n  );\n\n  return { onNodeClick, onNodeKeyDown };\n}\n\ninterface SelectionAction {\n  select: \"node\" | \"range\";\n  type: SelectionChangeType | \"disabled\";\n}\n\nfunction getSelectionAction(selectionMode: SelectionMode, isSelected: boolean, shiftDown: boolean, ctrlDown: boolean): SelectionAction {\n  switch (selectionMode) {\n    case \"none\":\n      return { select: \"node\", type: \"disabled\" };\n    case \"single\":\n      return { select: \"node\", type: isSelected ? \"replace\" : \"remove\" };\n    case \"multiple\":\n      return { select: \"node\", type: isSelected ? \"add\" : \"remove\" };\n    case \"extended\":\n      return getExtendedSelectionAction(isSelected, shiftDown, ctrlDown);\n  }\n}\n\nfunction getExtendedSelectionAction(isSelected: boolean, shiftDown: boolean, ctrlDown: boolean): SelectionAction {\n  if (shiftDown) {\n    return { select: \"range\", type: \"replace\" };\n  }\n  if (ctrlDown) {\n    return { select: \"node\", type: isSelected ? \"add\" : \"remove\" };\n  }\n  return { select: \"node\", type: isSelected ? \"replace\" : \"disabled\" };\n}\n\nfunction computeFlatNodeList(rootNodes: Array<PresentationTreeNode>): FlatTreeState {\n  const flatNodeList: Array<string> = [];\n  const nodeIdToIndexMap: Map<string, number> = new Map();\n\n  const flattenNodeRecursively = (nodes: Array<PresentationTreeNode>) => {\n    nodes.forEach((node) => {\n      if (!isPresentationHierarchyNode(node)) {\n        return;\n      }\n      nodeIdToIndexMap.set(node.id, flatNodeList.length);\n      flatNodeList.push(node.id);\n      if (node.isExpanded && typeof node.children !== \"boolean\") {\n        flattenNodeRecursively(node.children);\n      }\n    });\n  };\n\n  flattenNodeRecursively(rootNodes);\n  return { flatNodeList, nodeIdToIndexMap };\n}\n"]}

package/lib/cjs/presentation-hierarchies-react/UseTree.d.ts

@@ -1,132 +0,0 @@
-import { GenericInstanceFilter, HierarchyFilteringPath, HierarchyNode, HierarchyProvider } from "@itwin/presentation-hierarchies";
-import { InstanceKey, IPrimitiveValueFormatter } from "@itwin/presentation-shared";
-import { UseUnifiedTreeSelectionProps } from "./internal/UseUnifiedSelection.js";
-import { PresentationHierarchyNode, PresentationTreeNode } from "./TreeNode.js";
-import { SelectionChangeType } from "./UseSelectionHandler.js";
-/**
- * A data structure that contains information about a single hierarchy level.
- * @public
- */
-export interface HierarchyLevelDetails {
-    /** The parent node whose hierarchy level's information is contained in this data structure */
-    hierarchyNode: HierarchyNode | undefined;
-    /** A function to get instance keys of the hierarchy level. */
-    getInstanceKeysIterator: (props?: {
-        instanceFilter?: GenericInstanceFilter;
-        hierarchyLevelSizeLimit?: number | "unbounded";
-    }) => AsyncIterableIterator<InstanceKey>;
-    /** Get the limit of how many nodes can be loaded in this hierarchy level. */
-    sizeLimit?: number | "unbounded";
-    /** Set the limit of how many nodes can be loaded in this hierarchy level. */
-    setSizeLimit: (value: undefined | number | "unbounded") => void;
-    /** Get the active instance filter applied to this hierarchy level. */
-    instanceFilter?: GenericInstanceFilter;
-    /** Set the instance filter to apply to this hierarchy level */
-    setInstanceFilter: (filter: GenericInstanceFilter | undefined) => void;
-}
-/**
- * A React hook that creates state for a tree component.
- *
- * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a
- * component-agnostic result which may be used to render the hierarchy using any UI framework.
- *
- * See `README.md` for an example
- *
- * @see `useUnifiedSelectionTree`
- * @see `useIModelTree`
- * @public
- */
-export declare function useTree(props: UseTreeProps): UseTreeResult;
-/**
- * A React hook that creates state for a tree component, that is integrated with unified selection
- * through the given selection storage (previously the storage was provided through the, now
- * deprecated, `UnifiedSelectionProvider`).
- *
- * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a
- * component-agnostic result which may be used to render the hierarchy using any UI framework.
- *
- * See `README.md` for an example
- *
- * @see `useTree`
- * @see `useIModelUnifiedSelectionTree`
- * @see `UnifiedSelectionProvider`
- * @public
- */
-export declare function useUnifiedSelectionTree({ sourceName, selectionStorage, ...props }: UseTreeProps & UseUnifiedTreeSelectionProps): UseTreeResult;
-/** @public */
-export interface UseTreeProps {
-    /** Provides the hierarchy provider for the tree. */
-    getHierarchyProvider: () => HierarchyProvider;
-    /** Provides paths to filtered nodes. */
-    getFilteredPaths?: () => Promise<HierarchyFilteringPath[] | undefined>;
-    /**
-     * Callback that is called just after a certain action is finished.
-     * Can be used for performance tracking.
-     */
-    onPerformanceMeasured?: (action: "initial-load" | "hierarchy-level-load" | "reload", duration: number) => void;
-    /** Action to perform when hierarchy level contains more items that the specified limit. */
-    onHierarchyLimitExceeded?: (props: {
-        parentId?: string;
-        filter?: GenericInstanceFilter;
-        limit?: number | "unbounded";
-    }) => void;
-    /** Action to perform when an error occurs while loading hierarchy. */
-    onHierarchyLoadError?: (props: {
-        parentId?: string;
-        type: "timeout" | "unknown";
-        error: unknown;
-    }) => void;
-}
-/**
- * Options for doing either full or a sub tree reload.
- * @public
- */
-interface ReloadTreeOptions {
-    /** Specifies parent node under which sub tree should be reloaded. */
-    parentNodeId: string | undefined;
-    /**
-     * Specifies how current tree state should be handled:
-     * - `keep` - try to keep current tree state (expanded/collapsed nodes, instance filters, etc.).
-     * - `discard` - do not try to keep current tree state. Tree model will be update after nodes are reloaded.
-     * - `reset` - remove subtree from the model before reloading and reload nodes ignoring cache.
-     *
-     * Defaults to `"keep"`.
-     */
-    state?: "keep" | "discard" | "reset";
-}
-/** @public */
-export interface UseTreeResult {
-    /**
-     * Array containing root tree nodes. It is `undefined` on initial render until any nodes are loaded.
-     */
-    rootNodes: PresentationTreeNode[] | undefined;
-    /**
-     * Specifies whether tree is loading or not. It is set to `true` when initial tree load is in progress
-     * or tree is reloading.
-     */
-    isLoading: boolean;
-    /**
-     * A function that should be called to reload the tree.
-     */
-    reloadTree: (options?: ReloadTreeOptions) => void;
-    /**
-     * A function that should be called to either expand or collapse the given node.
-     */
-    expandNode: (nodeId: string, isExpanded: boolean) => void;
-    /**
-     * A function that should be called to select nodes in the tree.
-     * @param nodeIds Ids of the nodes that are selected.
-     * @param changeType Type of change that occurred for the selection.
-     */
-    selectNodes: (nodeIds: Array<string>, changeType: SelectionChangeType) => void;
-    /** Determines whether a given node is selected. */
-    isNodeSelected: (nodeId: string) => boolean;
-    /** Get a tree node by id */
-    getNode: (nodeId: string) => PresentationHierarchyNode | undefined;
-    /** Returns hierarchy level details for a given node ID. */
-    getHierarchyLevelDetails: (nodeId: string | undefined) => HierarchyLevelDetails | undefined;
-    /** Sets a formatter for the primitive values that are displayed in the hierarchy. */
-    setFormatter: (formatter: IPrimitiveValueFormatter | undefined) => void;
-}
-export {};
-//# sourceMappingURL=UseTree.d.ts.map

package/lib/cjs/presentation-hierarchies-react/UseTree.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UseTree.d.ts","sourceRoot":"","sources":["../../../src/presentation-hierarchies-react/UseTree.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAClI,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGnF,OAAO,EAA2B,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAE1G,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,8FAA8F;IAC9F,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAEzC,8DAA8D;IAC9D,uBAAuB,EAAE,CAAC,KAAK,CAAC,EAAE;QAChC,cAAc,CAAC,EAAE,qBAAqB,CAAC;QACvC,uBAAuB,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;KAChD,KAAK,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAEzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,6EAA6E;IAC7E,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC;IAEhE,sEAAsE;IACtE,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,+DAA+D;IAC/D,iBAAiB,EAAE,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,KAAK,IAAI,CAAC;CACxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CAG1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,4BAA4B,GAAG,aAAa,CAM9I;AAED,cAAc;AACd,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;IAC9C,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,GAAG,SAAS,CAAC,CAAC;IACvE;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,GAAG,sBAAsB,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/G,2FAA2F;IAC3F,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;IAChI,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5G;AAED;;;GAGG;AACH,UAAU,iBAAiB;IACzB,qEAAqE;IACrE,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CACtC;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAC;IAC9C;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAClD;;OAEG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D;;;;OAIG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/E,mDAAmD;IACnD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,4BAA4B;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,yBAAyB,GAAG,SAAS,CAAC;IACnE,2DAA2D;IAC3D,wBAAwB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,qBAAqB,GAAG,SAAS,CAAC;IAC5F,qFAAqF;IACrF,YAAY,EAAE,CAAC,SAAS,EAAE,wBAAwB,GAAG,SAAS,KAAK,IAAI,CAAC;CACzE"}

package/lib/cjs/presentation-hierarchies-react/UseTree.js

@@ -1,246 +0,0 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
- * See LICENSE.md in the project root for license terms and full copyright notice.
- *--------------------------------------------------------------------------------------------*/
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTree = useTree;
-exports.useUnifiedSelectionTree = useUnifiedSelectionTree;
-const react_1 = require("react");
-const presentation_hierarchies_1 = require("@itwin/presentation-hierarchies");
-const TreeActions_js_1 = require("./internal/TreeActions.js");
-const TreeModel_js_1 = require("./internal/TreeModel.js");
-const UseUnifiedSelection_js_1 = require("./internal/UseUnifiedSelection.js");
-const Utils_js_1 = require("./internal/Utils.js");
-/**
- * A React hook that creates state for a tree component.
- *
- * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a
- * component-agnostic result which may be used to render the hierarchy using any UI framework.
- *
- * See `README.md` for an example
- *
- * @see `useUnifiedSelectionTree`
- * @see `useIModelTree`
- * @public
- */
-function useTree(props) {
-    const { getTreeModelNode: _, ...rest } = useTreeInternal(props);
-    return rest;
-}
-/**
- * A React hook that creates state for a tree component, that is integrated with unified selection
- * through the given selection storage (previously the storage was provided through the, now
- * deprecated, `UnifiedSelectionProvider`).
- *
- * The hook uses `@itwin/presentation-hierarchies` package to load the hierarchy data and returns a
- * component-agnostic result which may be used to render the hierarchy using any UI framework.
- *
- * See `README.md` for an example
- *
- * @see `useTree`
- * @see `useIModelUnifiedSelectionTree`
- * @see `UnifiedSelectionProvider`
- * @public
- */
-function useUnifiedSelectionTree({ sourceName, selectionStorage, ...props }) {
-    const { getTreeModelNode, ...rest } = useTreeInternal(props);
-    return {
-        ...rest,
-        ...(0, UseUnifiedSelection_js_1.useUnifiedTreeSelection)({ sourceName, selectionStorage, getTreeModelNode }),
-    };
-}
-function useTreeInternal({ getHierarchyProvider, getFilteredPaths, onPerformanceMeasured, onHierarchyLimitExceeded, onHierarchyLoadError, }) {
-    const [state, setState] = (0, react_1.useState)({
-        model: { idToNode: new Map(), parentChildMap: new Map(), rootNode: { id: undefined, nodeData: undefined } },
-        rootNodes: undefined,
-    });
-    const onPerformanceMeasuredRef = useLatest(onPerformanceMeasured);
-    const onHierarchyLimitExceededRef = useLatest(onHierarchyLimitExceeded);
-    const onHierarchyLoadErrorRef = useLatest(onHierarchyLoadError);
-    const [actions] = (0, react_1.useState)(() => new TreeActions_js_1.TreeActions((model) => {
-        const rootNodes = model.parentChildMap.get(undefined) !== undefined ? generateTreeStructure(undefined, model) : undefined;
-        setState({
-            model,
-            rootNodes,
-        });
-    }, (actionType, duration) => onPerformanceMeasuredRef.current?.(actionType, duration), (props) => onHierarchyLimitExceededRef.current?.(props), (props) => onHierarchyLoadErrorRef.current?.(props)));
-    const currentFormatter = (0, react_1.useRef)();
-    const [hierarchyProvider, setHierarchyProvider] = (0, react_1.useState)();
-    (0, react_1.useEffect)(() => {
-        const provider = getHierarchyProvider();
-        provider.setFormatter(currentFormatter.current);
-        const removeHierarchyChangedListener = provider.hierarchyChanged.addListener((hierarchyChangeArgs) => {
-            const shouldDiscardState = hierarchyChangeArgs?.filterChange?.newFilter !== undefined;
-            actions.reloadTree({ state: shouldDiscardState ? "discard" : "keep" });
-        });
-        actions.setHierarchyProvider(provider);
-        setHierarchyProvider(provider);
-        return () => {
-            removeHierarchyChangedListener();
-            actions.reset();
-            (0, Utils_js_1.safeDispose)(provider);
-        };
-    }, [actions, getHierarchyProvider]);
-    const [isFiltering, setIsFiltering] = (0, react_1.useState)(false);
-    (0, react_1.useEffect)(() => {
-        let disposed = false;
-        void (async () => {
-            if (!hierarchyProvider) {
-                return;
-            }
-            if (!getFilteredPaths) {
-                hierarchyProvider.setHierarchyFilter(undefined);
-                // reload tree in case hierarchy provider does not use hierarchy filter to load initial nodes
-                actions.reloadTree({ state: "keep" });
-                setIsFiltering(false);
-                return;
-            }
-            setIsFiltering(true);
-            let paths;
-            try {
-                paths = await getFilteredPaths();
-            }
-            catch {
-            }
-            finally {
-                if (!disposed) {
-                    hierarchyProvider.setHierarchyFilter(paths ? { paths } : undefined);
-                    setIsFiltering(false);
-                }
-            }
-        })();
-        return () => {
-            disposed = true;
-        };
-    }, [hierarchyProvider, getFilteredPaths, actions]);
-    const getTreeModelNode = (0, react_1.useCallback)((nodeId) => {
-        return actions.getNode(nodeId);
-    }, [actions]);
-    const getNode = (0, react_1.useCallback)((nodeId) => {
-        const node = actions.getNode(nodeId);
-        if (!node || !(0, TreeModel_js_1.isTreeModelHierarchyNode)(node)) {
-            return undefined;
-        }
-        return createPresentationHierarchyNode(node, state.model);
-    }, [actions, state.model]);
-    const expandNode = (0, react_1.useCallback)((nodeId, isExpanded) => {
-        actions.expandNode(nodeId, isExpanded);
-    }, [actions]);
-    const reloadTree = (0, react_1.useCallback)((options) => {
-        actions.reloadTree(options);
-    }, [actions]);
-    const selectNodes = (0, react_1.useCallback)((nodeIds, changeType) => {
-        actions.selectNodes(nodeIds, changeType);
-    }, [actions]);
-    const isNodeSelected = (0, react_1.useCallback)((nodeId) => TreeModel_js_1.TreeModel.isNodeSelected(state.model, nodeId), [state]);
-    const setFormatter = (0, react_1.useCallback)((formatter) => {
-        currentFormatter.current = formatter;
-        /* c8 ignore next 3 */
-        if (!hierarchyProvider) {
-            return;
-        }
-        hierarchyProvider.setFormatter(formatter);
-    }, [hierarchyProvider]);
-    const getHierarchyLevelDetails = (0, react_1.useCallback)((nodeId) => {
-        const node = actions.getNode(nodeId);
-        if (!hierarchyProvider || !node || (0, TreeModel_js_1.isTreeModelInfoNode)(node)) {
-            return undefined;
-        }
-        const hierarchyNode = node.nodeData;
-        if (hierarchyNode && presentation_hierarchies_1.HierarchyNode.isGroupingNode(hierarchyNode)) {
-            return undefined;
-        }
-        return {
-            hierarchyNode,
-            getInstanceKeysIterator: (props) => hierarchyProvider.getNodeInstanceKeys({
-                parentNode: hierarchyNode,
-                instanceFilter: props?.instanceFilter,
-                hierarchyLevelSizeLimit: props?.hierarchyLevelSizeLimit,
-            }),
-            instanceFilter: node.instanceFilter,
-            setInstanceFilter: (filter) => actions.setInstanceFilter(nodeId, filter),
-            sizeLimit: node.hierarchyLimit,
-            setSizeLimit: (value) => actions.setHierarchyLimit(nodeId, value),
-        };
-    }, [actions, hierarchyProvider]);
-    return {
-        rootNodes: state.rootNodes,
-        isLoading: !!state.model.rootNode.isLoading || isFiltering,
-        expandNode,
-        reloadTree,
-        selectNodes,
-        isNodeSelected,
-        getTreeModelNode,
-        getNode,
-        getHierarchyLevelDetails,
-        setFormatter,
-    };
-}
-function generateTreeStructure(parentNodeId, model) {
-    const currentChildren = model.parentChildMap.get(parentNodeId);
-    if (!currentChildren) {
-        return undefined;
-    }
-    return currentChildren
-        .map((childId) => model.idToNode.get(childId))
-        .filter((node) => !!node)
-        .map((node) => {
-        if ((0, TreeModel_js_1.isTreeModelHierarchyNode)(node)) {
-            return createPresentationHierarchyNode(node, model);
-        }
-        if (node.type === "ResultSetTooLarge") {
-            return {
-                id: node.id,
-                parentNodeId,
-                type: node.type,
-                resultSetSizeLimit: node.resultSetSizeLimit,
-            };
-        }
-        if (node.type === "NoFilterMatches") {
-            return {
-                id: node.id,
-                parentNodeId,
-                type: node.type,
-            };
-        }
-        return {
-            id: node.id,
-            parentNodeId,
-            type: node.type,
-            message: node.message,
-        };
-    });
-}
-function createPresentationHierarchyNode(modelNode, model) {
-    let children;
-    return {
-        ...toPresentationHierarchyNodeBase(modelNode),
-        get children() {
-            if (!children) {
-                children = generateTreeStructure(modelNode.id, model);
-            }
-            return children ? children : modelNode.children === true ? true : [];
-        },
-    };
-}
-function toPresentationHierarchyNodeBase(node) {
-    return {
-        id: node.id,
-        label: node.label,
-        nodeData: node.nodeData,
-        isLoading: !!node.isLoading,
-        isExpanded: !!node.isExpanded,
-        isFilterable: !presentation_hierarchies_1.HierarchyNode.isGroupingNode(node.nodeData) && !!node.nodeData.supportsFiltering && node.children,
-        isFiltered: !!node.instanceFilter,
-        extendedData: node.nodeData.extendedData,
-    };
-}
-function useLatest(value) {
-    const ref = (0, react_1.useRef)(value);
-    (0, react_1.useEffect)(() => {
-        ref.current = value;
-    }, [value]);
-    return ref;
-}
-//# sourceMappingURL=UseTree.js.map