@itwin/tree-widget-react 4.0.0-alpha.25 → 4.0.0-alpha.26

package/lib/esm/tree-widget-react/components/trees/classifications-tree/ClassificationsTreeNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClassificationsTreeNode.js","sourceRoot":"","sources":["../../../../../../src/tree-widget-react/components/trees/classifications-tree/ClassificationsTreeNode.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAKhG;;;GAGG;AACH,MAAM,KAAW,uBAAuB,CA6BvC;AA7BD,WAAiB,uBAAuB;IACtC,iGAAiG;IACpF,iDAAyB,GAAG,CAAC,IAAyC,EAAgE,EAAE,CACnJ,IAAI,CAAC,YAAY,EAAE,IAAI,KAAK,qBAAqB,CAAC;IAEpD,4FAA4F;IAC/E,4CAAoB,GAAG,CAAC,IAAyC,EAAgE,EAAE,CAC9I,IAAI,CAAC,YAAY,EAAE,IAAI,KAAK,gBAAgB,CAAC;IAE/C;;;;;;;OAOG;IACU,8CAAsB,GAAG,CACpC,IAAyC,EAOzC,EAAE;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC;QACrC,OAAO,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,oBAAoB,CAAC;IACxE,CAAC,CAAC;AACJ,CAAC,EA7BgB,uBAAuB,KAAvB,uBAAuB,QA6BvC","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 type { Id64String } from \"@itwin/core-bentley\";\nimport type { HierarchyNode, InstancesNodeKey, NonGroupingHierarchyNode } from \"@itwin/presentation-hierarchies\";\n\n/**\n * Contains utility functions for working with Classifications Tree nodes.\n * @beta\n */\nexport namespace ClassificationsTreeNode {\n  /** Checks if the given node represents a `ClassificationSystems.ClassificationTable` element. */\n  export const isClassificationTableNode = (node: Pick<HierarchyNode, \"extendedData\">): node is NonGroupingHierarchyNode & { key: InstancesNodeKey } =>\n    node.extendedData?.type === \"ClassificationTable\";\n\n  /** Checks if the given node represents a `ClassificationSystems.Classification` element. */\n  export const isClassificationNode = (node: Pick<HierarchyNode, \"extendedData\">): node is NonGroupingHierarchyNode & { key: InstancesNodeKey } =>\n    node.extendedData?.type === \"Classification\";\n\n  /**\n   * Checks if the given node represents a `BisCore.GeometricElement` element.\n   *\n   * If it does, the node's `extendedData` will contain the following properties:\n   * - `type`: either `GeometricElement2d` or `GeometricElement3d`\n   * - `modelId`: `Id64String` of the model containing the element\n   * - `categoryId`: `Id64String` of the category of the element\n   */\n  export const isGeometricElementNode = (\n    node: Pick<HierarchyNode, \"extendedData\">,\n  ): node is Omit<NonGroupingHierarchyNode, \"extendedData\"> & { key: InstancesNodeKey } & {\n    extendedData: {\n      type: \"GeometricElement3d\" | \"GeometricElement2d\";\n      modelId: Id64String;\n      categoryId: Id64String;\n    };\n  } => {\n    const type = node.extendedData?.type;\n    return type === \"GeometricElement3d\" || type === \"GeometricElement2d\";\n  };\n}\n"]}
+{"version":3,"file":"ClassificationsTreeNode.js","sourceRoot":"","sources":["../../../../../../src/tree-widget-react/components/trees/classifications-tree/ClassificationsTreeNode.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAKhG;;;GAGG;AACH,MAAM,KAAW,uBAAuB,CA0BvC;AA1BD,WAAiB,uBAAuB;IACtC,iGAAiG;IACpF,iDAAyB,GAAG,CAAC,IAAyC,EAAgE,EAAE,CACnJ,IAAI,CAAC,YAAY,EAAE,IAAI,KAAK,qBAAqB,CAAC;IAEpD,4FAA4F;IAC/E,4CAAoB,GAAG,CAAC,IAAyC,EAAgE,EAAE,CAC9I,IAAI,CAAC,YAAY,EAAE,IAAI,KAAK,gBAAgB,CAAC;IAE/C;;;;;;OAMG;IACU,8CAAsB,GAAG,CACpC,IAAyC,EAMzC,EAAE;QACF,OAAO,IAAI,CAAC,YAAY,EAAE,IAAI,KAAK,oBAAoB,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC,EA1BgB,uBAAuB,KAAvB,uBAAuB,QA0BvC","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 type { Id64String } from \"@itwin/core-bentley\";\nimport type { HierarchyNode, InstancesNodeKey, NonGroupingHierarchyNode } from \"@itwin/presentation-hierarchies\";\n\n/**\n * Contains utility functions for working with Classifications Tree nodes.\n * @beta\n */\nexport namespace ClassificationsTreeNode {\n  /** Checks if the given node represents a `ClassificationSystems.ClassificationTable` element. */\n  export const isClassificationTableNode = (node: Pick<HierarchyNode, \"extendedData\">): node is NonGroupingHierarchyNode & { key: InstancesNodeKey } =>\n    node.extendedData?.type === \"ClassificationTable\";\n\n  /** Checks if the given node represents a `ClassificationSystems.Classification` element. */\n  export const isClassificationNode = (node: Pick<HierarchyNode, \"extendedData\">): node is NonGroupingHierarchyNode & { key: InstancesNodeKey } =>\n    node.extendedData?.type === \"Classification\";\n\n  /**\n   * Checks if the given node represents a `BisCore.GeometricElement3d` element.\n   *\n   * If it does, the node's `extendedData` will contain the following properties:\n   * - `modelId`: `Id64String` of the model containing the element\n   * - `categoryId`: `Id64String` of the category of the element\n   */\n  export const isGeometricElementNode = (\n    node: Pick<HierarchyNode, \"extendedData\">,\n  ): node is Omit<NonGroupingHierarchyNode, \"extendedData\"> & { key: InstancesNodeKey } & {\n    extendedData: {\n      modelId: Id64String;\n      categoryId: Id64String;\n    };\n  } => {\n    return node.extendedData?.type === \"GeometricElement3d\";\n  };\n}\n"]}

package/lib/esm/tree-widget-react/components/trees/classifications-tree/UseClassificationsTree.d.ts

@@ -1,4 +1,7 @@
+import { useSharedTreeContextInternal } from "../common/internal/SharedTreeContextProviderInternal.js";
+import { ClassificationsTreeIdsCache } from "./internal/ClassificationsTreeIdsCache.js";
 import type { ReactNode } from "react";
+import type { IModelConnection } from "@itwin/core-frontend";
 import type { VisibilityTreeProps } from "../common/components/VisibilityTree.js";
 import type { ExtendedVisibilityTreeRendererProps } from "../common/components/VisibilityTreeRenderer.js";
 import type { TreeWidgetViewport } from "../common/TreeWidgetViewport.js";
@@ -17,9 +20,18 @@ interface UseClassificationsTreeResult {
     getTreeItemProps: Required<ExtendedVisibilityTreeRendererProps>["getTreeItemProps"];
 }
 /**
- * Custom hook to create and manage state for the categories tree.
+ * Custom hook to create and manage state for the classifications tree.
+ *
+ * **Note:** Requires `SharedTreeContextProvider` to be present in components tree above.
  * @alpha
  */
 export declare function useClassificationsTree({ activeView, emptyTreeContent, searchText, getTreeItemProps, ...rest }: UseClassificationsTreeProps): UseClassificationsTreeResult;
+/** @internal */
+export declare function getClassificationsTreeIdsCache({ getBaseIdsCache, getCache, imodel, hierarchyConfig, }: {
+    getCache: ReturnType<typeof useSharedTreeContextInternal>["getCache"];
+    getBaseIdsCache: ReturnType<typeof useSharedTreeContextInternal>["getBaseIdsCache"];
+    imodel: IModelConnection;
+    hierarchyConfig: ClassificationsTreeHierarchyConfiguration;
+}): ClassificationsTreeIdsCache;
 export {};
 //# sourceMappingURL=UseClassificationsTree.d.ts.map

package/lib/esm/tree-widget-react/components/trees/classifications-tree/UseClassificationsTree.js

@@ -3,68 +3,86 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-import { useCallback, useEffect, useMemo } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { createECSqlQueryExecutor } from "@itwin/presentation-core-interop";
 import iconBisCategory3d from "@stratakit/icons/bis-category-3d.svg";
 import { EmptyTreeContent, NoSearchMatches, SearchUnknownError, TooManySearchMatches } from "../common/components/EmptyTree.js";
+import { useSharedTreeContextInternal } from "../common/internal/SharedTreeContextProviderInternal.js";
 import { useGuid } from "../common/internal/useGuid.js";
 import { useCachedVisibility } from "../common/internal/useTreeHooks/UseCachedVisibility.js";
-import { useIdsCache } from "../common/internal/useTreeHooks/UseIdsCache.js";
+import { getClassesByView } from "../common/internal/Utils.js";
+import { SearchLimitExceededError } from "../common/TreeErrors.js";
+import { useTelemetryContext } from "../common/UseTelemetryContext.js";
 import { ClassificationsTreeComponent } from "./ClassificationsTreeComponent.js";
-import { ClassificationsTreeDefinition } from "./ClassificationsTreeDefinition.js";
 import { ClassificationsTreeIcon } from "./ClassificationsTreeIcon.js";
 import { ClassificationsTreeIdsCache } from "./internal/ClassificationsTreeIdsCache.js";
-import { useSearchPaths } from "./internal/UseSearchPaths.js";
 import { ClassificationsTreeVisibilityHandler } from "./internal/visibility/ClassificationsTreeVisibilityHandler.js";
 import { createClassificationsSearchResultsTree } from "./internal/visibility/SearchResultsTree.js";
+import { useClassificationsTreeDefinition } from "./UseClassificationsTreeDefinition.js";
 /**
- * Custom hook to create and manage state for the categories tree.
+ * Custom hook to create and manage state for the classifications tree.
+ *
+ * **Note:** Requires `SharedTreeContextProvider` to be present in components tree above.
  * @alpha
  */
 export function useClassificationsTree({ activeView, emptyTreeContent, searchText, getTreeItemProps, ...rest }) {
+    const { getBaseIdsCache, getCache } = useSharedTreeContextInternal();
+    const { onFeatureUsed } = useTelemetryContext();
+    const [searchError, setSearchError] = useState();
     const hierarchyConfig = useMemo(() => ({ ...rest.hierarchyConfig }), 
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [...Object.values(rest.hierarchyConfig)]);
     const componentId = useGuid();
-    const { getCache: getClassificationsTreeIdsCache } = useIdsCache({
-        imodel: activeView.iModel,
-        createCache,
-        cacheSpecificProps: useMemo(() => ({ hierarchyConfig }), [hierarchyConfig]),
-        componentId,
-    });
+    const idsCache = getClassificationsTreeIdsCache({ getCache, getBaseIdsCache, imodel: activeView.iModel, hierarchyConfig });
     const { visibilityHandlerFactory, onSearchPathsChanged } = useClassificationsCachedVisibility({
         activeView,
-        getCache: getClassificationsTreeIdsCache,
+        idsCache,
         componentId,
     });
-    const getHierarchyDefinition = useCallback((props) => {
-        return new ClassificationsTreeDefinition({ ...props, getIdsCache: getClassificationsTreeIdsCache, hierarchyConfig });
-    }, [getClassificationsTreeIdsCache, hierarchyConfig]);
-    const { getPaths, searchError } = useSearchPaths({
-        hierarchyConfiguration: hierarchyConfig,
-        searchText,
-        getClassificationsTreeIdsCache,
+    const { getSearchPaths, definition } = useClassificationsTreeDefinition({
+        imodels: useMemo(() => [activeView.iModel], [activeView.iModel]),
+        hierarchyConfig,
+        search: useMemo(() => (searchText ? { searchText } : undefined), [searchText]),
         onSearchPathsChanged,
-        componentId,
     });
+    useEffect(() => {
+        setSearchError(undefined);
+    }, [searchText]);
+    const getPaths = useMemo(() => {
+        if (!searchText || !getSearchPaths) {
+            return undefined;
+        }
+        return async (props) => {
+            try {
+                return await getSearchPaths(props);
+            }
+            catch (e) {
+                const newError = e instanceof SearchLimitExceededError ? "tooManySearchMatches" : "unknownSearchError";
+                if (newError !== "tooManySearchMatches") {
+                    const feature = e instanceof Error && e.message.includes("query too long to execute or server is too busy") ? "error-timeout" : "error-unknown";
+                    onFeatureUsed({ featureId: feature, reportInteraction: false });
+                }
+                setSearchError(newError);
+                return [];
+            }
+        };
+    }, [searchText, getSearchPaths, onFeatureUsed]);
     return {
         treeProps: {
             treeName: ClassificationsTreeComponent.id,
-            getHierarchyDefinition,
+            getHierarchyDefinition: useCallback(() => definition, [definition]),
             visibilityHandlerFactory,
             getSearchPaths: getPaths,
             emptyTreeContent: useMemo(() => getEmptyTreeContentComponent(searchText, searchError, emptyTreeContent), [searchText, searchError, emptyTreeContent]),
             highlightText: searchText,
         },
         getTreeItemProps: (node, rendererProps) => ({
+            ...rendererProps.getTreeItemProps?.(node),
             decorations: _jsx(ClassificationsTreeIcon, { node: node }),
             ...getTreeItemProps?.(node, rendererProps),
         }),
     };
 }
-function createCache(props) {
-    return new ClassificationsTreeIdsCache(createECSqlQueryExecutor(props.imodel), props.specificProps.hierarchyConfig, props.componentId);
-}
 function getEmptyTreeContentComponent(searchText, error, emptyTreeContent) {
     if (error) {
         if (error === "tooManySearchMatches") {
@@ -81,36 +99,48 @@ function getEmptyTreeContentComponent(searchText, error, emptyTreeContent) {
     return _jsx(EmptyTreeContent, { icon: iconBisCategory3d });
 }
 function useClassificationsCachedVisibility(props) {
-    const { activeView, getCache, componentId } = props;
+    const { activeView, idsCache, componentId } = props;
     const { visibilityHandlerFactory, searchPaths, onSearchPathsChanged } = useCachedVisibility({
         activeView,
-        getCache,
+        idsCache,
         createSearchResultsTree,
         createTreeSpecificVisibilityHandler,
         componentId,
     });
     useEffect(() => {
-        getCache().clearFilteredElementsData();
-    }, [searchPaths, getCache]);
+        idsCache.clearFilteredElementsData();
+    }, [searchPaths, idsCache]);
     return {
         visibilityHandlerFactory,
         onSearchPathsChanged,
     };
 }
 async function createSearchResultsTree(props) {
-    const { searchPaths, getCache, imodelAccess } = props;
+    const { searchPaths, idsCache, imodelAccess } = props;
     return createClassificationsSearchResultsTree({
-        idsCache: getCache(),
+        idsCache,
         searchPaths,
         imodelAccess,
     });
 }
 function createTreeSpecificVisibilityHandler(props) {
-    const { info, getCache, viewport } = props;
+    const { info, idsCache, viewport } = props;
     return new ClassificationsTreeVisibilityHandler({
         alwaysAndNeverDrawnElementInfo: info,
-        idsCache: getCache(),
+        idsCache,
         viewport,
     });
 }
+/** @internal */
+export function getClassificationsTreeIdsCache({ getBaseIdsCache, getCache, imodel, hierarchyConfig, }) {
+    return getCache({
+        imodel,
+        createCache: () => new ClassificationsTreeIdsCache({
+            baseIdsCache: getBaseIdsCache({ type: "3d", elementClassName: getClassesByView("3d").elementClass, imodel }),
+            hierarchyConfig,
+            queryExecutor: createECSqlQueryExecutor(imodel),
+        }),
+        cacheKey: `${hierarchyConfig.rootClassificationSystemCode}-ClassificationsTreeIdsCache`,
+    });
+}
 //# sourceMappingURL=UseClassificationsTree.js.map

package/lib/esm/tree-widget-react/components/trees/classifications-tree/UseClassificationsTree.js.map

@@ -1 +1 @@
-{"version":3,"file":"UseClassificationsTree.js","sourceRoot":"","sources":["../../../../../../src/tree-widget-react/components/trees/classifications-tree/UseClassificationsTree.tsx"],"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, useMemo } from \"react\";\nimport { createECSqlQueryExecutor } from \"@itwin/presentation-core-interop\";\nimport iconBisCategory3d from \"@stratakit/icons/bis-category-3d.svg\";\nimport { EmptyTreeContent, NoSearchMatches, SearchUnknownError, TooManySearchMatches } from \"../common/components/EmptyTree.js\";\nimport { useGuid } from \"../common/internal/useGuid.js\";\nimport { useCachedVisibility } from \"../common/internal/useTreeHooks/UseCachedVisibility.js\";\nimport { useIdsCache } from \"../common/internal/useTreeHooks/UseIdsCache.js\";\nimport { ClassificationsTreeComponent } from \"./ClassificationsTreeComponent.js\";\nimport { ClassificationsTreeDefinition } from \"./ClassificationsTreeDefinition.js\";\nimport { ClassificationsTreeIcon } from \"./ClassificationsTreeIcon.js\";\nimport { ClassificationsTreeIdsCache } from \"./internal/ClassificationsTreeIdsCache.js\";\nimport { useSearchPaths } from \"./internal/UseSearchPaths.js\";\nimport { ClassificationsTreeVisibilityHandler } from \"./internal/visibility/ClassificationsTreeVisibilityHandler.js\";\nimport { createClassificationsSearchResultsTree } from \"./internal/visibility/SearchResultsTree.js\";\n\nimport type { ReactNode } from \"react\";\nimport type { GuidString } from \"@itwin/core-bentley\";\nimport type { VisibilityTreeProps } from \"../common/components/VisibilityTree.js\";\nimport type { ExtendedVisibilityTreeRendererProps } from \"../common/components/VisibilityTreeRenderer.js\";\nimport type { CreateSearchResultsTreeProps, CreateTreeSpecificVisibilityHandlerProps } from \"../common/internal/useTreeHooks/UseCachedVisibility.js\";\nimport type { CreateCacheProps } from \"../common/internal/useTreeHooks/UseIdsCache.js\";\nimport type { SearchResultsTree } from \"../common/internal/visibility/BaseSearchResultsTree.js\";\nimport type { TreeWidgetViewport } from \"../common/TreeWidgetViewport.js\";\nimport type { ClassificationsTreeHierarchyConfiguration } from \"./ClassificationsTreeDefinition.js\";\nimport type { ClassificationsTreeSearchError } from \"./internal/UseSearchPaths.js\";\nimport type { ClassificationsTreeSearchTargets } from \"./internal/visibility/SearchResultsTree.js\";\n\n/** @alpha */\nexport interface UseClassificationsTreeProps {\n  activeView: TreeWidgetViewport;\n  hierarchyConfig: ClassificationsTreeHierarchyConfiguration;\n  emptyTreeContent?: ReactNode;\n  searchText?: string;\n  getTreeItemProps?: ExtendedVisibilityTreeRendererProps[\"getTreeItemProps\"];\n}\n\n/** @alpha */\ninterface UseClassificationsTreeResult {\n  treeProps: Pick<\n    VisibilityTreeProps,\n    \"treeName\" | \"getHierarchyDefinition\" | \"visibilityHandlerFactory\" | \"getSearchPaths\" | \"emptyTreeContent\" | \"highlightText\"\n  >;\n  getTreeItemProps: Required<ExtendedVisibilityTreeRendererProps>[\"getTreeItemProps\"];\n}\n\n/**\n * Custom hook to create and manage state for the categories tree.\n * @alpha\n */\nexport function useClassificationsTree({\n  activeView,\n  emptyTreeContent,\n  searchText,\n  getTreeItemProps,\n  ...rest\n}: UseClassificationsTreeProps): UseClassificationsTreeResult {\n  const hierarchyConfig = useMemo(\n    () => ({ ...rest.hierarchyConfig }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [...Object.values(rest.hierarchyConfig)],\n  );\n  const componentId = useGuid();\n\n  const { getCache: getClassificationsTreeIdsCache } = useIdsCache<ClassificationsTreeIdsCache, { hierarchyConfig: ClassificationsTreeHierarchyConfiguration }>(\n    {\n      imodel: activeView.iModel,\n      createCache,\n      cacheSpecificProps: useMemo(() => ({ hierarchyConfig }), [hierarchyConfig]),\n      componentId,\n    },\n  );\n\n  const { visibilityHandlerFactory, onSearchPathsChanged } = useClassificationsCachedVisibility({\n    activeView,\n    getCache: getClassificationsTreeIdsCache,\n    componentId,\n  });\n\n  const getHierarchyDefinition = useCallback<VisibilityTreeProps[\"getHierarchyDefinition\"]>(\n    (props) => {\n      return new ClassificationsTreeDefinition({ ...props, getIdsCache: getClassificationsTreeIdsCache, hierarchyConfig });\n    },\n    [getClassificationsTreeIdsCache, hierarchyConfig],\n  );\n\n  const { getPaths, searchError } = useSearchPaths({\n    hierarchyConfiguration: hierarchyConfig,\n    searchText,\n    getClassificationsTreeIdsCache,\n    onSearchPathsChanged,\n    componentId,\n  });\n\n  return {\n    treeProps: {\n      treeName: ClassificationsTreeComponent.id,\n      getHierarchyDefinition,\n      visibilityHandlerFactory,\n      getSearchPaths: getPaths,\n      emptyTreeContent: useMemo(() => getEmptyTreeContentComponent(searchText, searchError, emptyTreeContent), [searchText, searchError, emptyTreeContent]),\n      highlightText: searchText,\n    },\n    getTreeItemProps: (node, rendererProps) => ({\n      decorations: <ClassificationsTreeIcon node={node} />,\n      ...getTreeItemProps?.(node, rendererProps),\n    }),\n  };\n}\n\nfunction createCache(props: CreateCacheProps<{ hierarchyConfig: ClassificationsTreeHierarchyConfiguration }>) {\n  return new ClassificationsTreeIdsCache(createECSqlQueryExecutor(props.imodel), props.specificProps.hierarchyConfig, props.componentId);\n}\n\nfunction getEmptyTreeContentComponent(searchText?: string, error?: ClassificationsTreeSearchError, emptyTreeContent?: React.ReactNode) {\n  if (error) {\n    if (error === \"tooManySearchMatches\") {\n      return <TooManySearchMatches base={\"classificationsTree\"} />;\n    }\n    return <SearchUnknownError base={\"classificationsTree\"} />;\n  }\n  if (searchText) {\n    return <NoSearchMatches base={\"classificationsTree\"} />;\n  }\n  if (emptyTreeContent) {\n    return emptyTreeContent;\n  }\n  return <EmptyTreeContent icon={iconBisCategory3d} />;\n}\n\nfunction useClassificationsCachedVisibility(props: { activeView: TreeWidgetViewport; getCache: () => ClassificationsTreeIdsCache; componentId: GuidString }) {\n  const { activeView, getCache, componentId } = props;\n  const { visibilityHandlerFactory, searchPaths, onSearchPathsChanged } = useCachedVisibility<ClassificationsTreeIdsCache, ClassificationsTreeSearchTargets>({\n    activeView,\n    getCache,\n    createSearchResultsTree,\n    createTreeSpecificVisibilityHandler,\n    componentId,\n  });\n\n  useEffect(() => {\n    getCache().clearFilteredElementsData();\n  }, [searchPaths, getCache]);\n\n  return {\n    visibilityHandlerFactory,\n    onSearchPathsChanged,\n  };\n}\n\nasync function createSearchResultsTree(\n  props: CreateSearchResultsTreeProps<ClassificationsTreeIdsCache>,\n): Promise<SearchResultsTree<ClassificationsTreeSearchTargets>> {\n  const { searchPaths, getCache, imodelAccess } = props;\n  return createClassificationsSearchResultsTree({\n    idsCache: getCache(),\n    searchPaths,\n    imodelAccess,\n  });\n}\n\nfunction createTreeSpecificVisibilityHandler(props: CreateTreeSpecificVisibilityHandlerProps<ClassificationsTreeIdsCache>) {\n  const { info, getCache, viewport } = props;\n  return new ClassificationsTreeVisibilityHandler({\n    alwaysAndNeverDrawnElementInfo: info,\n    idsCache: getCache(),\n    viewport,\n  });\n}\n"]}
+{"version":3,"file":"UseClassificationsTree.js","sourceRoot":"","sources":["../../../../../../src/tree-widget-react/components/trees/classifications-tree/UseClassificationsTree.tsx"],"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, useMemo, useState } from \"react\";\nimport { createECSqlQueryExecutor } from \"@itwin/presentation-core-interop\";\nimport iconBisCategory3d from \"@stratakit/icons/bis-category-3d.svg\";\nimport { EmptyTreeContent, NoSearchMatches, SearchUnknownError, TooManySearchMatches } from \"../common/components/EmptyTree.js\";\nimport { useSharedTreeContextInternal } from \"../common/internal/SharedTreeContextProviderInternal.js\";\nimport { useGuid } from \"../common/internal/useGuid.js\";\nimport { useCachedVisibility } from \"../common/internal/useTreeHooks/UseCachedVisibility.js\";\nimport { getClassesByView } from \"../common/internal/Utils.js\";\nimport { SearchLimitExceededError } from \"../common/TreeErrors.js\";\nimport { useTelemetryContext } from \"../common/UseTelemetryContext.js\";\nimport { ClassificationsTreeComponent } from \"./ClassificationsTreeComponent.js\";\nimport { ClassificationsTreeIcon } from \"./ClassificationsTreeIcon.js\";\nimport { ClassificationsTreeIdsCache } from \"./internal/ClassificationsTreeIdsCache.js\";\nimport { ClassificationsTreeVisibilityHandler } from \"./internal/visibility/ClassificationsTreeVisibilityHandler.js\";\nimport { createClassificationsSearchResultsTree } from \"./internal/visibility/SearchResultsTree.js\";\nimport { useClassificationsTreeDefinition } from \"./UseClassificationsTreeDefinition.js\";\n\nimport type { ReactNode } from \"react\";\nimport type { GuidString } from \"@itwin/core-bentley\";\nimport type { IModelConnection } from \"@itwin/core-frontend\";\nimport type { useTree } from \"@itwin/presentation-hierarchies-react\";\nimport type { VisibilityTreeProps } from \"../common/components/VisibilityTree.js\";\nimport type { ExtendedVisibilityTreeRendererProps } from \"../common/components/VisibilityTreeRenderer.js\";\nimport type { CreateSearchResultsTreeProps, CreateTreeSpecificVisibilityHandlerProps } from \"../common/internal/useTreeHooks/UseCachedVisibility.js\";\nimport type { SearchResultsTree } from \"../common/internal/visibility/BaseSearchResultsTree.js\";\nimport type { TreeWidgetViewport } from \"../common/TreeWidgetViewport.js\";\nimport type { FunctionProps } from \"../common/Utils.js\";\nimport type { ClassificationsTreeHierarchyConfiguration } from \"./ClassificationsTreeDefinition.js\";\nimport type { ClassificationsTreeSearchTargets } from \"./internal/visibility/SearchResultsTree.js\";\n\n/** @alpha */\nexport interface UseClassificationsTreeProps {\n  activeView: TreeWidgetViewport;\n  hierarchyConfig: ClassificationsTreeHierarchyConfiguration;\n  emptyTreeContent?: ReactNode;\n  searchText?: string;\n  getTreeItemProps?: ExtendedVisibilityTreeRendererProps[\"getTreeItemProps\"];\n}\n\ntype ClassificationsTreeSearchError = \"tooManySearchMatches\" | \"unknownSearchError\";\n\n/** @alpha */\ninterface UseClassificationsTreeResult {\n  treeProps: Pick<\n    VisibilityTreeProps,\n    \"treeName\" | \"getHierarchyDefinition\" | \"visibilityHandlerFactory\" | \"getSearchPaths\" | \"emptyTreeContent\" | \"highlightText\"\n  >;\n  getTreeItemProps: Required<ExtendedVisibilityTreeRendererProps>[\"getTreeItemProps\"];\n}\n\n/**\n * Custom hook to create and manage state for the classifications tree.\n *\n * **Note:** Requires `SharedTreeContextProvider` to be present in components tree above.\n * @alpha\n */\nexport function useClassificationsTree({\n  activeView,\n  emptyTreeContent,\n  searchText,\n  getTreeItemProps,\n  ...rest\n}: UseClassificationsTreeProps): UseClassificationsTreeResult {\n  const { getBaseIdsCache, getCache } = useSharedTreeContextInternal();\n  const { onFeatureUsed } = useTelemetryContext();\n\n  const [searchError, setSearchError] = useState<ClassificationsTreeSearchError | undefined>();\n\n  const hierarchyConfig = useMemo(\n    () => ({ ...rest.hierarchyConfig }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [...Object.values(rest.hierarchyConfig)],\n  );\n  const componentId = useGuid();\n\n  const idsCache = getClassificationsTreeIdsCache({ getCache, getBaseIdsCache, imodel: activeView.iModel, hierarchyConfig });\n\n  const { visibilityHandlerFactory, onSearchPathsChanged } = useClassificationsCachedVisibility({\n    activeView,\n    idsCache,\n    componentId,\n  });\n\n  const { getSearchPaths, definition } = useClassificationsTreeDefinition({\n    imodels: useMemo(() => [activeView.iModel], [activeView.iModel]),\n    hierarchyConfig,\n    search: useMemo(() => (searchText ? { searchText } : undefined), [searchText]),\n    onSearchPathsChanged,\n  });\n\n  useEffect(() => {\n    setSearchError(undefined);\n  }, [searchText]);\n\n  const getPaths = useMemo<FunctionProps<typeof useTree>[\"getSearchPaths\"]>(() => {\n    if (!searchText || !getSearchPaths) {\n      return undefined;\n    }\n    return async (props) => {\n      try {\n        return await getSearchPaths(props);\n      } catch (e) {\n        const newError = e instanceof SearchLimitExceededError ? \"tooManySearchMatches\" : \"unknownSearchError\";\n        if (newError !== \"tooManySearchMatches\") {\n          const feature = e instanceof Error && e.message.includes(\"query too long to execute or server is too busy\") ? \"error-timeout\" : \"error-unknown\";\n          onFeatureUsed({ featureId: feature, reportInteraction: false });\n        }\n        setSearchError(newError);\n        return [];\n      }\n    };\n  }, [searchText, getSearchPaths, onFeatureUsed]);\n\n  return {\n    treeProps: {\n      treeName: ClassificationsTreeComponent.id,\n      getHierarchyDefinition: useCallback(() => definition, [definition]),\n      visibilityHandlerFactory,\n      getSearchPaths: getPaths,\n      emptyTreeContent: useMemo(() => getEmptyTreeContentComponent(searchText, searchError, emptyTreeContent), [searchText, searchError, emptyTreeContent]),\n      highlightText: searchText,\n    },\n    getTreeItemProps: (node, rendererProps) => ({\n      ...rendererProps.getTreeItemProps?.(node),\n      decorations: <ClassificationsTreeIcon node={node} />,\n      ...getTreeItemProps?.(node, rendererProps),\n    }),\n  };\n}\n\nfunction getEmptyTreeContentComponent(searchText?: string, error?: ClassificationsTreeSearchError, emptyTreeContent?: React.ReactNode) {\n  if (error) {\n    if (error === \"tooManySearchMatches\") {\n      return <TooManySearchMatches base={\"classificationsTree\"} />;\n    }\n    return <SearchUnknownError base={\"classificationsTree\"} />;\n  }\n  if (searchText) {\n    return <NoSearchMatches base={\"classificationsTree\"} />;\n  }\n  if (emptyTreeContent) {\n    return emptyTreeContent;\n  }\n  return <EmptyTreeContent icon={iconBisCategory3d} />;\n}\n\nfunction useClassificationsCachedVisibility(props: { activeView: TreeWidgetViewport; idsCache: ClassificationsTreeIdsCache; componentId: GuidString }) {\n  const { activeView, idsCache, componentId } = props;\n  const { visibilityHandlerFactory, searchPaths, onSearchPathsChanged } = useCachedVisibility<ClassificationsTreeIdsCache, ClassificationsTreeSearchTargets>({\n    activeView,\n    idsCache,\n    createSearchResultsTree,\n    createTreeSpecificVisibilityHandler,\n    componentId,\n  });\n\n  useEffect(() => {\n    idsCache.clearFilteredElementsData();\n  }, [searchPaths, idsCache]);\n\n  return {\n    visibilityHandlerFactory,\n    onSearchPathsChanged,\n  };\n}\n\nasync function createSearchResultsTree(\n  props: CreateSearchResultsTreeProps<ClassificationsTreeIdsCache>,\n): Promise<SearchResultsTree<ClassificationsTreeSearchTargets>> {\n  const { searchPaths, idsCache, imodelAccess } = props;\n  return createClassificationsSearchResultsTree({\n    idsCache,\n    searchPaths,\n    imodelAccess,\n  });\n}\n\nfunction createTreeSpecificVisibilityHandler(props: CreateTreeSpecificVisibilityHandlerProps<ClassificationsTreeIdsCache>) {\n  const { info, idsCache, viewport } = props;\n  return new ClassificationsTreeVisibilityHandler({\n    alwaysAndNeverDrawnElementInfo: info,\n    idsCache,\n    viewport,\n  });\n}\n\n/** @internal */\nexport function getClassificationsTreeIdsCache({\n  getBaseIdsCache,\n  getCache,\n  imodel,\n  hierarchyConfig,\n}: {\n  getCache: ReturnType<typeof useSharedTreeContextInternal>[\"getCache\"];\n  getBaseIdsCache: ReturnType<typeof useSharedTreeContextInternal>[\"getBaseIdsCache\"];\n  imodel: IModelConnection;\n  hierarchyConfig: ClassificationsTreeHierarchyConfiguration;\n}) {\n  return getCache({\n    imodel,\n    createCache: () =>\n      new ClassificationsTreeIdsCache({\n        baseIdsCache: getBaseIdsCache({ type: \"3d\", elementClassName: getClassesByView(\"3d\").elementClass, imodel }),\n        hierarchyConfig,\n        queryExecutor: createECSqlQueryExecutor(imodel),\n      }),\n    cacheKey: `${hierarchyConfig.rootClassificationSystemCode}-ClassificationsTreeIdsCache`,\n  });\n}\n"]}

package/lib/esm/tree-widget-react/components/trees/classifications-tree/UseClassificationsTreeDefinition.d.ts

@@ -1,5 +1,6 @@
-import type { HierarchyDefinition } from "@itwin/presentation-hierarchies";
-import type { useIModelTree, useTree } from "@itwin/presentation-hierarchies-react";
+import type { IModelConnection } from "@itwin/core-frontend";
+import type { HierarchyDefinition, HierarchySearchPath } from "@itwin/presentation-hierarchies";
+import type { useTree } from "@itwin/presentation-hierarchies-react";
 import type { InstanceKey } from "@itwin/presentation-shared";
 import type { FunctionProps } from "../common/Utils.js";
 import type { ClassificationsTreeHierarchyConfiguration } from "./ClassificationsTreeDefinition.js";
@@ -11,12 +12,7 @@ interface UseClassificationsTreeDefinitionProps {
      * **Warning:** These **must** all be different versions of the same iModel, ordered from the earliest to the
      * latest version. Not obeying this rule may result in undefined behavior.
      */
-    imodels: Array<{
-        /**
-         * An object that provides access to iModel's data and metadata.
-         */
-        imodelAccess: FunctionProps<typeof useIModelTree>["imodelAccess"];
-    }>;
+    imodels: Array<IModelConnection>;
     hierarchyConfig: ClassificationsTreeHierarchyConfiguration;
     /**
      * Optional parameters to search for tree nodes.
@@ -32,13 +28,20 @@ interface UseClassificationsTreeDefinitionProps {
          */
         targetItems: Array<InstanceKey>;
     };
+    /**
+     * Action to perform when search paths change.
+     */
+    onSearchPathsChanged?: (paths: HierarchySearchPath[] | undefined) => void;
 }
 /** @alpha */
 interface UseClassificationsTreeDefinitionResult {
     definition: HierarchyDefinition;
     getSearchPaths?: FunctionProps<typeof useTree>["getSearchPaths"];
 }
-/** @alpha */
+/**
+ * Requires `SharedTreeContextProvider` to be present in components tree above.
+ * @alpha
+ */
 export declare function useClassificationsTreeDefinition(props: UseClassificationsTreeDefinitionProps): UseClassificationsTreeDefinitionResult;
 export {};
 //# sourceMappingURL=UseClassificationsTreeDefinition.d.ts.map

package/lib/esm/tree-widget-react/components/trees/classifications-tree/UseClassificationsTreeDefinition.js

@@ -2,61 +2,65 @@
  * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
  * See LICENSE.md in the project root for license terms and full copyright notice.
  *--------------------------------------------------------------------------------------------*/
-import { useMemo, useRef } from "react";
-import { assert } from "@itwin/core-bentley";
+import { useEffect, useMemo } from "react";
+import { useSharedTreeContextInternal } from "../common/internal/SharedTreeContextProviderInternal.js";
+import { createIModelAccess } from "../common/internal/UseIModelAccess.js";
+import { useTelemetryContext } from "../common/UseTelemetryContext.js";
 import { ClassificationsTreeDefinition } from "./ClassificationsTreeDefinition.js";
-import { ClassificationsTreeIdsCache } from "./internal/ClassificationsTreeIdsCache.js";
-/** @alpha */
+import { getClassificationsTreeIdsCache } from "./UseClassificationsTree.js";
+/**
+ * Requires `SharedTreeContextProvider` to be present in components tree above.
+ * @alpha
+ */
 export function useClassificationsTreeDefinition(props) {
-    const { imodels, hierarchyConfig, search } = props;
-    const idsCaches = useRef(new Map());
+    const { imodels, hierarchyConfig, search, onSearchPathsChanged } = props;
+    const { getBaseIdsCache, getCache } = useSharedTreeContextInternal();
+    const { onFeatureUsed } = useTelemetryContext();
+    const imodelsWithCaches = useMemo(() => {
+        return imodels.map((imodel) => {
+            return {
+                imodelAccess: createIModelAccess({ imodel, hierarchyLevelSizeLimit: 1000 }),
+                cache: getClassificationsTreeIdsCache({ getBaseIdsCache, getCache, imodel, hierarchyConfig }),
+            };
+        });
+    }, [imodels, getBaseIdsCache, getCache, hierarchyConfig]);
     const definition = useMemo(() => {
         return new ClassificationsTreeDefinition({
-            imodelAccess: imodels[imodels.length - 1].imodelAccess,
-            getIdsCache: (imodelKey) => getOrCreateIdsCache({
-                imodelKey,
-                imodels,
-                idsCaches,
-                hierarchyConfig,
-            }),
+            imodelAccess: imodelsWithCaches[imodelsWithCaches.length - 1].imodelAccess,
+            getIdsCache: (imodelKey) => imodelsWithCaches.find(({ imodelAccess }) => imodelAccess.imodelKey === imodelKey).cache,
             hierarchyConfig,
         });
-    }, [imodels, hierarchyConfig]);
+    }, [hierarchyConfig, imodelsWithCaches]);
     const searchTerm = search ? ("searchText" in search ? search.searchText : search.targetItems) : undefined;
+    useEffect(() => {
+        if (!searchTerm) {
+            onSearchPathsChanged?.(undefined);
+        }
+    }, [onSearchPathsChanged, searchTerm]);
     const getSearchPaths = useMemo(() => {
         if (!searchTerm) {
             return undefined;
         }
         return async ({ abortSignal }) => {
-            const [first, ...rest] = await Promise.all(imodels.map(async ({ imodelAccess }) => ClassificationsTreeDefinition.createInstanceKeyPaths({
-                hierarchyConfig,
-                idsCache: getOrCreateIdsCache({
-                    imodelKey: imodelAccess.imodelKey,
-                    imodels,
-                    idsCaches,
+            onFeatureUsed({ featureId: "search", reportInteraction: true });
+            const [first, ...rest] = await Promise.all(imodelsWithCaches.map(async ({ imodelAccess, cache }) => {
+                return ClassificationsTreeDefinition.createInstanceKeyPaths({
                     hierarchyConfig,
-                }),
-                imodelAccess,
-                abortSignal,
-                limit: typeof searchTerm !== "string" ? "unbounded" : undefined,
-                ...(typeof searchTerm === "string" ? { label: searchTerm } : { targetItems: searchTerm }),
-            })));
-            return first.concat(...rest);
+                    idsCache: cache,
+                    imodelAccess,
+                    abortSignal,
+                    limit: typeof searchTerm !== "string" ? "unbounded" : undefined,
+                    ...(typeof searchTerm === "string" ? { label: searchTerm } : { targetItems: searchTerm }),
+                });
+            }));
+            const joinedPaths = first.concat(...rest);
+            onSearchPathsChanged?.(joinedPaths);
+            return joinedPaths;
         };
-    }, [imodels, hierarchyConfig, searchTerm]);
+    }, [searchTerm, onFeatureUsed, imodelsWithCaches, onSearchPathsChanged, hierarchyConfig]);
     return {
         definition,
         getSearchPaths,
     };
 }
-function getOrCreateIdsCache({ imodelKey, imodels, hierarchyConfig, idsCaches, }) {
-    let idsCache = idsCaches.current.get(imodelKey);
-    if (!idsCache) {
-        const imodel = imodels.find((currImodel) => currImodel.imodelAccess.imodelKey === imodelKey);
-        assert(!!imodel);
-        idsCache = new ClassificationsTreeIdsCache(imodel.imodelAccess, hierarchyConfig);
-        idsCaches.current.set(imodelKey, idsCache);
-    }
-    return idsCache;
-}
 //# sourceMappingURL=UseClassificationsTreeDefinition.js.map

package/lib/esm/tree-widget-react/components/trees/classifications-tree/UseClassificationsTreeDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"UseClassificationsTreeDefinition.js","sourceRoot":"","sources":["../../../../../../src/tree-widget-react/components/trees/classifications-tree/UseClassificationsTreeDefinition.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 { useMemo, useRef } from \"react\";\nimport { assert } from \"@itwin/core-bentley\";\nimport { ClassificationsTreeDefinition } from \"./ClassificationsTreeDefinition.js\";\nimport { ClassificationsTreeIdsCache } from \"./internal/ClassificationsTreeIdsCache.js\";\n\nimport type { MutableRefObject } from \"react\";\nimport type { HierarchyDefinition } from \"@itwin/presentation-hierarchies\";\nimport type { useIModelTree, useTree } from \"@itwin/presentation-hierarchies-react\";\nimport type { InstanceKey } from \"@itwin/presentation-shared\";\nimport type { FunctionProps } from \"../common/Utils.js\";\nimport type { ClassificationsTreeHierarchyConfiguration } from \"./ClassificationsTreeDefinition.js\";\n\n/** @alpha */\ninterface UseClassificationsTreeDefinitionProps {\n  /**\n   * A list of iModels to create merged hierarchy for.\n   *\n   * **Warning:** These **must** all be different versions of the same iModel, ordered from the earliest to the\n   * latest version. Not obeying this rule may result in undefined behavior.\n   */\n  imodels: Array<{\n    /**\n     * An object that provides access to iModel's data and metadata.\n     */\n    imodelAccess: FunctionProps<typeof useIModelTree>[\"imodelAccess\"];\n  }>;\n  hierarchyConfig: ClassificationsTreeHierarchyConfiguration;\n  /**\n   * Optional parameters to search for tree nodes.\n   */\n  search?:\n    | {\n        /**\n         * Text used to search tree nodes by label.\n         */\n        searchText: string;\n      }\n    | {\n        /**\n         * List of instance keys to search tree nodes by.\n         */\n        targetItems: Array<InstanceKey>;\n      };\n}\n\n/** @alpha */\ninterface UseClassificationsTreeDefinitionResult {\n  definition: HierarchyDefinition;\n  getSearchPaths?: FunctionProps<typeof useTree>[\"getSearchPaths\"];\n}\n\n/** @alpha */\nexport function useClassificationsTreeDefinition(props: UseClassificationsTreeDefinitionProps): UseClassificationsTreeDefinitionResult {\n  const { imodels, hierarchyConfig, search } = props;\n\n  const idsCaches = useRef<Map<string, ClassificationsTreeIdsCache>>(new Map());\n\n  const definition = useMemo(() => {\n    return new ClassificationsTreeDefinition({\n      imodelAccess: imodels[imodels.length - 1].imodelAccess,\n      getIdsCache: (imodelKey: string) =>\n        getOrCreateIdsCache({\n          imodelKey,\n          imodels,\n          idsCaches,\n          hierarchyConfig,\n        }),\n      hierarchyConfig,\n    });\n  }, [imodels, hierarchyConfig]);\n\n  const searchTerm = search ? (\"searchText\" in search ? search.searchText : search.targetItems) : undefined;\n  const getSearchPaths = useMemo<FunctionProps<typeof useTree>[\"getSearchPaths\"]>(() => {\n    if (!searchTerm) {\n      return undefined;\n    }\n\n    return async ({ abortSignal }) => {\n      const [first, ...rest] = await Promise.all(\n        imodels.map(async ({ imodelAccess }) =>\n          ClassificationsTreeDefinition.createInstanceKeyPaths({\n            hierarchyConfig,\n            idsCache: getOrCreateIdsCache({\n              imodelKey: imodelAccess.imodelKey,\n              imodels,\n              idsCaches,\n              hierarchyConfig,\n            }),\n            imodelAccess,\n            abortSignal,\n            limit: typeof searchTerm !== \"string\" ? \"unbounded\" : undefined,\n            ...(typeof searchTerm === \"string\" ? { label: searchTerm } : { targetItems: searchTerm }),\n          }),\n        ),\n      );\n\n      return first.concat(...rest);\n    };\n  }, [imodels, hierarchyConfig, searchTerm]);\n\n  return {\n    definition,\n    getSearchPaths,\n  };\n}\n\nfunction getOrCreateIdsCache({\n  imodelKey,\n  imodels,\n  hierarchyConfig,\n  idsCaches,\n}: {\n  imodelKey: string;\n  imodels: Array<{\n    imodelAccess: FunctionProps<typeof useIModelTree>[\"imodelAccess\"];\n  }>;\n  hierarchyConfig: ClassificationsTreeHierarchyConfiguration;\n  idsCaches: MutableRefObject<Map<string, ClassificationsTreeIdsCache>>;\n}) {\n  let idsCache = idsCaches.current.get(imodelKey);\n  if (!idsCache) {\n    const imodel = imodels.find((currImodel) => currImodel.imodelAccess.imodelKey === imodelKey);\n    assert(!!imodel);\n    idsCache = new ClassificationsTreeIdsCache(imodel.imodelAccess, hierarchyConfig);\n    idsCaches.current.set(imodelKey, idsCache);\n  }\n  return idsCache;\n}\n"]}
+{"version":3,"file":"UseClassificationsTreeDefinition.js","sourceRoot":"","sources":["../../../../../../src/tree-widget-react/components/trees/classifications-tree/UseClassificationsTreeDefinition.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 { useEffect, useMemo } from \"react\";\nimport { useSharedTreeContextInternal } from \"../common/internal/SharedTreeContextProviderInternal.js\";\nimport { createIModelAccess } from \"../common/internal/UseIModelAccess.js\";\nimport { useTelemetryContext } from \"../common/UseTelemetryContext.js\";\nimport { ClassificationsTreeDefinition } from \"./ClassificationsTreeDefinition.js\";\nimport { getClassificationsTreeIdsCache } from \"./UseClassificationsTree.js\";\n\nimport type { IModelConnection } from \"@itwin/core-frontend\";\nimport type { HierarchyDefinition, HierarchySearchPath } from \"@itwin/presentation-hierarchies\";\nimport type { useTree } from \"@itwin/presentation-hierarchies-react\";\nimport type { InstanceKey } from \"@itwin/presentation-shared\";\nimport type { FunctionProps } from \"../common/Utils.js\";\nimport type { ClassificationsTreeHierarchyConfiguration } from \"./ClassificationsTreeDefinition.js\";\n\n/** @alpha */\ninterface UseClassificationsTreeDefinitionProps {\n  /**\n   * A list of iModels to create merged hierarchy for.\n   *\n   * **Warning:** These **must** all be different versions of the same iModel, ordered from the earliest to the\n   * latest version. Not obeying this rule may result in undefined behavior.\n   */\n  imodels: Array<IModelConnection>;\n  hierarchyConfig: ClassificationsTreeHierarchyConfiguration;\n  /**\n   * Optional parameters to search for tree nodes.\n   */\n  search?:\n    | {\n        /**\n         * Text used to search tree nodes by label.\n         */\n        searchText: string;\n      }\n    | {\n        /**\n         * List of instance keys to search tree nodes by.\n         */\n        targetItems: Array<InstanceKey>;\n      };\n  /**\n   * Action to perform when search paths change.\n   */\n  onSearchPathsChanged?: (paths: HierarchySearchPath[] | undefined) => void;\n}\n\n/** @alpha */\ninterface UseClassificationsTreeDefinitionResult {\n  definition: HierarchyDefinition;\n  getSearchPaths?: FunctionProps<typeof useTree>[\"getSearchPaths\"];\n}\n\n/**\n * Requires `SharedTreeContextProvider` to be present in components tree above.\n * @alpha\n */\nexport function useClassificationsTreeDefinition(props: UseClassificationsTreeDefinitionProps): UseClassificationsTreeDefinitionResult {\n  const { imodels, hierarchyConfig, search, onSearchPathsChanged } = props;\n  const { getBaseIdsCache, getCache } = useSharedTreeContextInternal();\n  const { onFeatureUsed } = useTelemetryContext();\n\n  const imodelsWithCaches = useMemo(() => {\n    return imodels.map((imodel) => {\n      return {\n        imodelAccess: createIModelAccess({ imodel, hierarchyLevelSizeLimit: 1000 }),\n        cache: getClassificationsTreeIdsCache({ getBaseIdsCache, getCache, imodel, hierarchyConfig }),\n      };\n    });\n  }, [imodels, getBaseIdsCache, getCache, hierarchyConfig]);\n\n  const definition = useMemo(() => {\n    return new ClassificationsTreeDefinition({\n      imodelAccess: imodelsWithCaches[imodelsWithCaches.length - 1].imodelAccess,\n      getIdsCache: (imodelKey: string) => imodelsWithCaches.find(({ imodelAccess }) => imodelAccess.imodelKey === imodelKey)!.cache,\n      hierarchyConfig,\n    });\n  }, [hierarchyConfig, imodelsWithCaches]);\n\n  const searchTerm = search ? (\"searchText\" in search ? search.searchText : search.targetItems) : undefined;\n\n  useEffect(() => {\n    if (!searchTerm) {\n      onSearchPathsChanged?.(undefined);\n    }\n  }, [onSearchPathsChanged, searchTerm]);\n\n  const getSearchPaths = useMemo<FunctionProps<typeof useTree>[\"getSearchPaths\"]>(() => {\n    if (!searchTerm) {\n      return undefined;\n    }\n\n    return async ({ abortSignal }) => {\n      onFeatureUsed({ featureId: \"search\", reportInteraction: true });\n      const [first, ...rest] = await Promise.all(\n        imodelsWithCaches.map(async ({ imodelAccess, cache }) => {\n          return ClassificationsTreeDefinition.createInstanceKeyPaths({\n            hierarchyConfig,\n            idsCache: cache,\n            imodelAccess,\n            abortSignal,\n            limit: typeof searchTerm !== \"string\" ? \"unbounded\" : undefined,\n            ...(typeof searchTerm === \"string\" ? { label: searchTerm } : { targetItems: searchTerm }),\n          });\n        }),\n      );\n\n      const joinedPaths = first.concat(...rest);\n      onSearchPathsChanged?.(joinedPaths);\n      return joinedPaths;\n    };\n  }, [searchTerm, onFeatureUsed, imodelsWithCaches, onSearchPathsChanged, hierarchyConfig]);\n\n  return {\n    definition,\n    getSearchPaths,\n  };\n}\n"]}

package/lib/esm/tree-widget-react/components/trees/classifications-tree/internal/ClassificationsTreeIdsCache.d.ts

@@ -1,56 +1,33 @@
+import { BaseIdsCacheImpl } from "../../common/internal/caches/BaseIdsCache.js";
 import type { Observable } from "rxjs";
-import type { GuidString, Id64Arg, Id64Array, Id64Set, Id64String } from "@itwin/core-bentley";
+import type { Id64Arg, Id64Array, Id64String } from "@itwin/core-bentley";
 import type { HierarchyNodeIdentifiersPath, LimitingECSqlQueryExecutor } from "@itwin/presentation-hierarchies";
-import type { CategoryId, ElementId, ModelId, SubCategoryId } from "../../common/internal/Types.js";
+import type { BaseIdsCacheImplProps } from "../../common/internal/caches/BaseIdsCache.js";
+import type { CategoryId, ClassificationId, ElementId } from "../../common/internal/Types.js";
 import type { ClassificationsTreeHierarchyConfiguration } from "../ClassificationsTreeDefinition.js";
+interface ClassificationsTreeIdsCacheProps extends BaseIdsCacheImplProps {
+    queryExecutor: LimitingECSqlQueryExecutor;
+    hierarchyConfig: ClassificationsTreeHierarchyConfiguration;
+}
 /** @internal */
-export type ClassificationId = Id64String;
-/** @internal */
-export type ClassificationTableId = Id64String;
-/** @internal */
-export declare class ClassificationsTreeIdsCache implements Disposable {
+export declare class ClassificationsTreeIdsCache extends BaseIdsCacheImpl {
     #private;
-    constructor(queryExecutor: LimitingECSqlQueryExecutor, hierarchyConfig: ClassificationsTreeHierarchyConfiguration, componentId?: GuidString);
-    [Symbol.dispose](): void;
-    private querySubCategories;
-    private getSubCategoriesInfo;
-    getSubCategories(categoryId: Id64String): Observable<Array<SubCategoryId>>;
-    private queryElementModelCategories;
-    private getElementModelsCategories;
-    private queryModeledElements;
-    private getModelWithCategoryModeledElements;
-    getCategoriesModeledElements(modelId: Id64String, categoryIds: Id64Arg): Observable<Id64Array>;
-    getCategoriesElementModels(categoryIds: Id64Arg, includeSubModels?: boolean): Observable<{
-        id: CategoryId;
-        models: Array<ModelId> | undefined;
-    }>;
-    getModelCategoryIds(modelId: Id64String): Observable<{
-        drawing: Id64Array;
-        spatial: Id64Array;
-    }>;
-    getAllCategories(): Observable<{
-        drawing: Id64Set;
-        spatial: Id64Set;
-    }>;
-    hasSubModel(elementId: Id64String): Observable<boolean>;
-    getCategoryElementsCount(modelId: Id64String, categoryId: Id64String): Observable<number>;
+    constructor(props: ClassificationsTreeIdsCacheProps);
     private queryClassifications;
     private getClassificationsInfo;
-    getAllContainedCategories(classificationOrTableIds: Id64Arg): Observable<{
-        drawing: Id64Array;
-        spatial: Id64Array;
-    }>;
+    getAllContainedCategories(classificationOrTableIds: Id64Arg): Observable<Id64Array>;
     getDirectChildClassifications(classificationOrTableIds: Id64Arg): Observable<ClassificationId[]>;
     getClassificationsPathObs(classificationIds: Id64Arg): Observable<HierarchyNodeIdentifiersPath>;
     getAllClassifications(): Observable<ClassificationId[]>;
     private queryFilteredElementsData;
-    getFilteredElementsData({ element2dIds, element3dIds, }: {
-        element2dIds: Id64Arg;
-        element3dIds: Id64Arg;
+    getFilteredElementsData({ elementIds, }: {
+        elementIds: Id64Arg;
     }): Observable<Map<ElementId, {
         categoryId: Id64String;
         modelId: Id64String;
+        categoryOfTopMostParentElement: CategoryId;
     }>>;
     clearFilteredElementsData(): void;
 }
+export {};
 //# sourceMappingURL=ClassificationsTreeIdsCache.d.ts.map