@itwin/tree-widget-react 4.0.0-alpha.2 → 4.0.0-alpha.20

package/lib/esm/tree-widget-react/components/trees/models-tree/internal/visibility/ModelsTreeVisibilityHelper.js

@@ -0,0 +1,71 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { defer, mergeMap, of } from "rxjs";
+import { createVisibilityStatus } from "../../../common/internal/Tooltip.js";
+import { BaseVisibilityHelper } from "../../../common/internal/visibility/BaseVisibilityHelper.js";
+import { mergeVisibilityStatuses } from "../../../common/internal/VisibilityUtils.js";
+/**
+ * Visibility status helper for models tree.
+ *
+ * It extends base visibility status helper and provides methods to get and change visibility status of subjects and grouped elements.
+ * @internal
+ */
+export class ModelsTreeVisibilityHelper extends BaseVisibilityHelper {
+    #props;
+    constructor(props) {
+        super(props);
+        this.#props = props;
+    }
+    /**
+     * Gets visibility status of subjects.
+     *
+     * Determines visibility status by checking visibility status of related models.
+     */
+    getSubjectsVisibilityStatus(props) {
+        const result = defer(() => {
+            const { subjectIds } = props;
+            if (this.#props.viewport.viewType !== "3d") {
+                return of(createVisibilityStatus("disabled"));
+            }
+            return this.#props.idsCache.getSubjectModelIds(subjectIds).pipe(mergeMap((modelIds) => this.getModelsVisibilityStatus({ modelIds, type: "GeometricModel3d" })), mergeVisibilityStatuses);
+        });
+        return this.#props.overrideHandler
+            ? this.#props.overrideHandler.createVisibilityHandlerResult({
+                overrideProps: props,
+                nonOverriddenResult: result,
+                override: this.#props.overrides?.getSubjectsVisibilityStatus,
+            })
+            : result;
+    }
+    /** Gets visibility status of grouped elements */
+    getGroupedElementsVisibilityStatus(props) {
+        const { modelId, categoryId, elementIds } = props;
+        return this.getElementsVisibilityStatus({ elementIds, modelId, categoryId, type: "GeometricElement3d" });
+    }
+    /**
+     * Changes visibility status of subjects.
+     *
+     * Does this by changing visibility status of related models.
+     */
+    changeSubjectsVisibilityStatus(props) {
+        const result = defer(() => {
+            const { on, subjectIds } = props;
+            return this.#props.idsCache.getSubjectModelIds(subjectIds).pipe(mergeMap((modelIds) => this.changeModelsVisibilityStatus({ modelIds, on })));
+        });
+        return this.#props.overrideHandler
+            ? this.#props.overrideHandler.createVisibilityHandlerResult({
+                overrideProps: props,
+                nonOverriddenResult: result,
+                override: this.#props.overrides?.changeSubjectsVisibilityStatus,
+            })
+            : result;
+    }
+    /** Changes visibility of grouped elements. */
+    changeGroupedElementsVisibilityStatus(props) {
+        const { modelId, categoryId, elementIds, on } = props;
+        return this.changeElementsVisibilityStatus({ modelId, elementIds, categoryId, on });
+    }
+}
+//# sourceMappingURL=ModelsTreeVisibilityHelper.js.map

package/lib/esm/tree-widget-react/components/trees/models-tree/internal/visibility/ModelsTreeVisibilityHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelsTreeVisibilityHelper.js","sourceRoot":"","sources":["../../../../../../../../src/tree-widget-react/components/trees/models-tree/internal/visibility/ModelsTreeVisibilityHelper.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 { defer, mergeMap, of } from \"rxjs\";\nimport { createVisibilityStatus } from \"../../../common/internal/Tooltip.js\";\nimport { BaseVisibilityHelper } from \"../../../common/internal/visibility/BaseVisibilityHelper.js\";\nimport { mergeVisibilityStatuses } from \"../../../common/internal/VisibilityUtils.js\";\n\nimport type { Observable } from \"rxjs\";\nimport type { Id64Arg, Id64String } from \"@itwin/core-bentley\";\nimport type { BaseVisibilityHelperProps } from \"../../../common/internal/visibility/BaseVisibilityHelper.js\";\nimport type { VisibilityStatus } from \"../../../common/UseHierarchyVisibility.js\";\nimport type { ModelsTreeIdsCache } from \"../ModelsTreeIdsCache.js\";\nimport type { ModelsTreeVisibilityHandlerOverrides } from \"./ModelsTreeVisibilityHandler.js\";\n\n/** @internal */\nexport type ModelsTreeVisibilityHelperProps = BaseVisibilityHelperProps & {\n  idsCache: ModelsTreeIdsCache;\n  overrides?: ModelsTreeVisibilityHandlerOverrides;\n};\n\n/**\n * Visibility status helper for models tree.\n *\n * It extends base visibility status helper and provides methods to get and change visibility status of subjects and grouped elements.\n * @internal\n */\nexport class ModelsTreeVisibilityHelper extends BaseVisibilityHelper {\n  #props: ModelsTreeVisibilityHelperProps;\n  constructor(props: ModelsTreeVisibilityHelperProps) {\n    super(props);\n    this.#props = props;\n  }\n\n  /**\n   * Gets visibility status of subjects.\n   *\n   * Determines visibility status by checking visibility status of related models.\n   */\n  public getSubjectsVisibilityStatus(props: { subjectIds: Id64Arg }): Observable<VisibilityStatus> {\n    const result = defer(() => {\n      const { subjectIds } = props;\n      if (this.#props.viewport.viewType !== \"3d\") {\n        return of(createVisibilityStatus(\"disabled\"));\n      }\n\n      return this.#props.idsCache.getSubjectModelIds(subjectIds).pipe(\n        mergeMap((modelIds) => this.getModelsVisibilityStatus({ modelIds, type: \"GeometricModel3d\" })),\n        mergeVisibilityStatuses,\n      );\n    });\n    return this.#props.overrideHandler\n      ? this.#props.overrideHandler.createVisibilityHandlerResult({\n          overrideProps: props,\n          nonOverriddenResult: result,\n          override: this.#props.overrides?.getSubjectsVisibilityStatus,\n        })\n      : result;\n  }\n\n  /** Gets visibility status of grouped elements */\n  public getGroupedElementsVisibilityStatus(props: { modelId: Id64String; categoryId: Id64String; elementIds: Id64Arg }): Observable<VisibilityStatus> {\n    const { modelId, categoryId, elementIds } = props;\n    return this.getElementsVisibilityStatus({ elementIds, modelId, categoryId, type: \"GeometricElement3d\" });\n  }\n\n  /**\n   * Changes visibility status of subjects.\n   *\n   * Does this by changing visibility status of related models.\n   */\n  public changeSubjectsVisibilityStatus(props: { subjectIds: Id64Arg; on: boolean }): Observable<void> {\n    const result = defer(() => {\n      const { on, subjectIds } = props;\n      return this.#props.idsCache.getSubjectModelIds(subjectIds).pipe(mergeMap((modelIds) => this.changeModelsVisibilityStatus({ modelIds, on })));\n    });\n    return this.#props.overrideHandler\n      ? this.#props.overrideHandler.createVisibilityHandlerResult({\n          overrideProps: props,\n          nonOverriddenResult: result,\n          override: this.#props.overrides?.changeSubjectsVisibilityStatus,\n        })\n      : result;\n  }\n\n  /** Changes visibility of grouped elements. */\n  public changeGroupedElementsVisibilityStatus(props: { modelId: Id64String; categoryId: Id64String; elementIds: Id64Arg; on: boolean }): Observable<void> {\n    const { modelId, categoryId, elementIds, on } = props;\n    return this.changeElementsVisibilityStatus({ modelId, elementIds, categoryId, on });\n  }\n}\n"]}

package/lib/esm/tree-widget-react-internal.d.ts

@@ -0,0 +1,12 @@
+export { toVoidPromise, collect } from "./tree-widget-react/components/trees/common/internal/Rxjs.js";
+export { ModelsTreeDefinition, defaultHierarchyConfiguration as defaultModelsTreeHierarchyConfiguration, } from "./tree-widget-react/components/trees/models-tree/ModelsTreeDefinition.js";
+export { ModelsTreeIdsCache } from "./tree-widget-react/components/trees/models-tree/internal/ModelsTreeIdsCache.js";
+export { createModelsTreeVisibilityHandler } from "./tree-widget-react/components/trees/models-tree/internal/visibility/ModelsTreeVisibilityHandler.js";
+export { CategoriesTreeDefinition, defaultHierarchyConfiguration as defaultCategoriesTreeHierarchyConfiguration, } from "./tree-widget-react/components/trees/categories-tree/CategoriesTreeDefinition.js";
+export { CategoriesTreeIdsCache } from "./tree-widget-react/components/trees/categories-tree/internal/CategoriesTreeIdsCache.js";
+export { createCategoriesTreeVisibilityHandler } from "./tree-widget-react/components/trees/categories-tree/internal/visibility/CategoriesTreeVisibilityHandler.js";
+export { CategoriesTreeNode } from "./tree-widget-react/components/trees/categories-tree/internal/CategoriesTreeNode.js";
+export { ClassificationsTreeDefinition } from "./tree-widget-react/components/trees/classifications-tree/ClassificationsTreeDefinition.js";
+export { ClassificationsTreeIdsCache } from "./tree-widget-react/components/trees/classifications-tree/internal/ClassificationsTreeIdsCache.js";
+export { releaseMainThreadOnItemsCount } from "./tree-widget-react/components/trees/common/internal/Utils.js";
+//# sourceMappingURL=tree-widget-react-internal.d.ts.map

package/lib/esm/tree-widget-react-internal.js

@@ -0,0 +1,18 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+// WARNING: This barrel file exports internal APIs only for use by `@itwin/presentation-backend` and `@itwin/presentation-frontend` packages.
+// They should not be used outside of these packages. These APIs may be broken or removed at any time without notice.
+export { toVoidPromise, collect } from "./tree-widget-react/components/trees/common/internal/Rxjs.js";
+export { ModelsTreeDefinition, defaultHierarchyConfiguration as defaultModelsTreeHierarchyConfiguration, } from "./tree-widget-react/components/trees/models-tree/ModelsTreeDefinition.js";
+export { ModelsTreeIdsCache } from "./tree-widget-react/components/trees/models-tree/internal/ModelsTreeIdsCache.js";
+export { createModelsTreeVisibilityHandler } from "./tree-widget-react/components/trees/models-tree/internal/visibility/ModelsTreeVisibilityHandler.js";
+export { CategoriesTreeDefinition, defaultHierarchyConfiguration as defaultCategoriesTreeHierarchyConfiguration, } from "./tree-widget-react/components/trees/categories-tree/CategoriesTreeDefinition.js";
+export { CategoriesTreeIdsCache } from "./tree-widget-react/components/trees/categories-tree/internal/CategoriesTreeIdsCache.js";
+export { createCategoriesTreeVisibilityHandler } from "./tree-widget-react/components/trees/categories-tree/internal/visibility/CategoriesTreeVisibilityHandler.js";
+export { CategoriesTreeNode } from "./tree-widget-react/components/trees/categories-tree/internal/CategoriesTreeNode.js";
+export { ClassificationsTreeDefinition } from "./tree-widget-react/components/trees/classifications-tree/ClassificationsTreeDefinition.js";
+export { ClassificationsTreeIdsCache } from "./tree-widget-react/components/trees/classifications-tree/internal/ClassificationsTreeIdsCache.js";
+export { releaseMainThreadOnItemsCount } from "./tree-widget-react/components/trees/common/internal/Utils.js";
+//# sourceMappingURL=tree-widget-react-internal.js.map

package/lib/esm/tree-widget-react-internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-widget-react-internal.js","sourceRoot":"","sources":["../../src/tree-widget-react-internal.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,6IAA6I;AAC7I,qHAAqH;AAErH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,8DAA8D,CAAC;AAEtG,OAAO,EACL,oBAAoB,EACpB,6BAA6B,IAAI,uCAAuC,GACzE,MAAM,0EAA0E,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iFAAiF,CAAC;AACrH,OAAO,EAAE,iCAAiC,EAAE,MAAM,qGAAqG,CAAC;AAExJ,OAAO,EACL,wBAAwB,EACxB,6BAA6B,IAAI,2CAA2C,GAC7E,MAAM,kFAAkF,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,yFAAyF,CAAC;AACjI,OAAO,EAAE,qCAAqC,EAAE,MAAM,6GAA6G,CAAC;AACpK,OAAO,EAAE,kBAAkB,EAAE,MAAM,qFAAqF,CAAC;AAEzH,OAAO,EAAE,6BAA6B,EAAE,MAAM,4FAA4F,CAAC;AAC3I,OAAO,EAAE,2BAA2B,EAAE,MAAM,mGAAmG,CAAC;AAChJ,OAAO,EAAE,6BAA6B,EAAE,MAAM,+DAA+D,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\n// WARNING: This barrel file exports internal APIs only for use by `@itwin/presentation-backend` and `@itwin/presentation-frontend` packages.\n// They should not be used outside of these packages. These APIs may be broken or removed at any time without notice.\n\nexport { toVoidPromise, collect } from \"./tree-widget-react/components/trees/common/internal/Rxjs.js\";\n\nexport {\n  ModelsTreeDefinition,\n  defaultHierarchyConfiguration as defaultModelsTreeHierarchyConfiguration,\n} from \"./tree-widget-react/components/trees/models-tree/ModelsTreeDefinition.js\";\nexport { ModelsTreeIdsCache } from \"./tree-widget-react/components/trees/models-tree/internal/ModelsTreeIdsCache.js\";\nexport { createModelsTreeVisibilityHandler } from \"./tree-widget-react/components/trees/models-tree/internal/visibility/ModelsTreeVisibilityHandler.js\";\n\nexport {\n  CategoriesTreeDefinition,\n  defaultHierarchyConfiguration as defaultCategoriesTreeHierarchyConfiguration,\n} from \"./tree-widget-react/components/trees/categories-tree/CategoriesTreeDefinition.js\";\nexport { CategoriesTreeIdsCache } from \"./tree-widget-react/components/trees/categories-tree/internal/CategoriesTreeIdsCache.js\";\nexport { createCategoriesTreeVisibilityHandler } from \"./tree-widget-react/components/trees/categories-tree/internal/visibility/CategoriesTreeVisibilityHandler.js\";\nexport { CategoriesTreeNode } from \"./tree-widget-react/components/trees/categories-tree/internal/CategoriesTreeNode.js\";\n\nexport { ClassificationsTreeDefinition } from \"./tree-widget-react/components/trees/classifications-tree/ClassificationsTreeDefinition.js\";\nexport { ClassificationsTreeIdsCache } from \"./tree-widget-react/components/trees/classifications-tree/internal/ClassificationsTreeIdsCache.js\";\nexport { releaseMainThreadOnItemsCount } from \"./tree-widget-react/components/trees/common/internal/Utils.js\";\n"]}

package/lib/public/locales/en/TreeWidget.json

@@ -13,6 +13,10 @@
       "previous": "Previous"
     }
   },
+  "loading": {
+    "filter": "Filtering in progress",
+    "skeleton": "Loading tree"
+  },
   "selectableTree": {
     "noTrees": "There are no trees available for this iModel."
   },
@@ -23,49 +27,11 @@
   },
   "visibilityTooltips": {
     "status": {
-      "visible": "Visible",
-      "hidden": "Hidden",
+      "visible": "Hide",
+      "hidden": "Show",
       "disabled": "Disabled",
-      "partial": "Partially visible"
-    },
-    "modelsTree": {
-      "subject": {
-        "nonSpatialView": "Active view is not spatial",
-        "allModelsHidden": "All models are hidden",
-        "someModelsHidden": "Some models are hidden",
-        "allModelsVisible": "All models are visible"
-      },
-      "model": {
-        "nonSpatialView": "Active view is not spatial",
-        "hiddenThroughModelSelector": "Model display is hidden through model selector",
-        "someCategoriesHidden": "Some categories are visible and some are hidden",
-        "allCategoriesVisible": "All categories visible",
-        "allCategoriesHidden": "All categories hidden"
-      },
-      "category": {
-        "displayedThroughPerModelOverride": "Per-model category override set to 'Show'",
-        "hiddenThroughPerModelOverride": "Per-model category override set to 'Hide'",
-        "displayedThroughCategorySelector": "Category display enabled through category selector",
-        "hiddenThroughCategorySelector": "Category display disabled through category selector",
-        "allElementsHidden": "All category elements are in the never drawn list or none of the category elements are in the exclusive always drawn list",
-        "someElementsAreHidden": "There are both visible and hidden elements in this category",
-        "allElementsVisible": "All category elements are in the always drawn list",
-        "hiddenThroughModel": "Model is hidden"
-      },
-      "element": {
-        "hiddenThroughNeverDrawnList": "Element(s) in \"never drawn\" list",
-        "displayedThroughAlwaysDrawnList": "Element(s) in \"always drawn\" list",
-        "hiddenDueToOtherElementsExclusivelyAlwaysDrawn": "Other elements in \"exclusively always drawn\" list",
-        "hiddenThroughModel": "Model is not displayed",
-        "hiddenThroughCategory": "Category is not displayed"
-      },
-      "groupingNode": {
-        "allElementsHidden": "All elements are in the never drawn list or none of the elements are in the exclusive always drawn list",
-        "someElementsAreHidden": "There are both visible and hidden elements",
-        "allElementsVisible": "All elements are in the always drawn list",
-        "visibleThroughCategory": "All elements are visible through category",
-        "hiddenThroughCategory": "All elements are hidden through category"
-      }
+      "partial": "Show",
+      "determining": "Determining visibility..."
     }
   },
   "categoriesTree": {
@@ -82,9 +48,21 @@
       }
     },
     "filtering": {
-      "noMatches": "There are no categories matching filter \"{{filter}}\"",
+      "noMatches": "No results were found for your search query.",
+      "noMatchesRetry": "Please modify your search and try again.",
+      "unknownFilterError": "An unknown error occurred while filtering the tree.",
+      "tooManyFilterMatches": "There are too many matches for your search query.",
+      "tooManyFilterMatchesRetry": "Please refine your search and try again."
+    }
+  },
+  "classificationsTree": {
+    "label": "Classifications",
+    "filtering": {
+      "noMatches": "No results were found for your search query.",
+      "noMatchesRetry": "Please modify your search and try again.",
       "unknownFilterError": "An unknown error occurred while filtering the tree.",
-      "tooManyFilterMatches": "There are too many matches for the given filter. Please be more specific."
+      "tooManyFilterMatches": "There are too many matches for your search query.",
+      "tooManyFilterMatchesRetry": "Please refine your search and try again."
     }
   },
   "modelsTree": {
@@ -119,12 +97,18 @@
         }
       }
     },
+    "subTree": {
+      "unknownSubTreeError": "An unknown error occurred while creating a sub-tree."
+    },
     "filtering": {
-      "noMatches": "There are no nodes matching filter \"{{filter}}\"",
+      "noMatches": "No results were found for your search query.",
+      "noMatchesRetry": "Please modify your search and try again.",
       "unknownFilterError": "An unknown error occurred while filtering the tree.",
-      "unknownInstanceFocusError": "An unknown error occurred while focusing instances. <link>Disable the focus mode</link>.",
-      "tooManyFilterMatches": "There are too many matches for the given filter. Please be more specific.",
-      "tooManyInstancesFocused": "There are too many elements selected for focus mode. Please select fewer elements or <link>disable the focus mode</link>."
+      "unknownInstanceFocusError": "An unknown error occurred while focusing instances.",
+      "tooManyFilterMatches": "There are too many matches for your search query.",
+      "tooManyFilterMatchesRetry": "Please refine your search and try again.",
+      "tooManyInstancesFocused": "There are too many elements selected for focus mode.",
+      "disableInstanceFocusMode": "Disable the focus mode"
     }
   },
   "imodelContentTree": {
@@ -146,12 +130,15 @@
     "other": "Other",
     "loading": "Loading...",
     "filterHierarchyLevel": "Apply filter",
-    "clearHierarchyLevelFilter": "Clear active filter",
-    "noFilteredChildren": "No child nodes match current filter",
-    "resultLimitExceeded": "There are more items than allowed limit of {{limit}}.",
-    "resultLimitExceededWithFiltering": "Please provide <link>additional filtering</link> - there are more items than allowed limit of {{limit}}.",
-    "increaseHierarchyLimit": "<link>Increase the hierarchy level size limit to {{limit}}.</link>",
-    "increaseHierarchyLimitWithFiltering": "Or, <link>increase the hierarchy level size limit to {{limit}}.</link>",
+    "filterHierarchyLevelActiveDescription": "Filter is applied",
+    "noFilteredChildrenChangeFilter": "Change filter",
+    "failedToCreateHierarchy": "Failed to create hierarchy for {{node}}.",
+    "clearHierarchyLevelFilter": "Clear active filter.",
+    "noFilteredChildren": "No matches for current filter for {{node}}.",
+    "resultLimitExceeded": "The hierarchy for {{node}} contains {{limit}}+ items. Try using filters or increase the limit.",
+    "issuesFound": "{{number_of_issues}} issue(s) found",
+    "increaseHierarchyLimit": "Increase limit to {{limit}}",
+    "increaseHierarchyLimitWithFiltering": "Add Filter",
     "retry": "Retry"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/tree-widget-react",
-  "version": "4.0.0-alpha.2",
+  "version": "4.0.0-alpha.20",
   "description": "Tree Widget React",
   "keywords": [
     "Bentley",
@@ -23,15 +23,19 @@
     ".": {
       "import": "./lib/esm/tree-widget-react.js"
     },
+    "./internal": {
+      "import": "./lib/esm/tree-widget-react-internal.js",
+      "require": "./lib/cjs/tree-widget-react-internal.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "npm run -s dual-build && npm run -s copy:assets",
-    "dual-build": "npm run -s build:esm",
+    "build": "npm run -s build:esm && npm run -s copy:assets",
     "build:esm": "tsc 1>&2 -p tsconfig.esm.json",
     "copy:assets": "npm run -s copy:public && npm run -s copy:esm",
     "copy:public": "cpx \"./public/**/*\" ./lib/public",
     "copy:esm": "cpx \"./src/**/*.{css,scss,json}\" ./lib/esm",
+    "cover": "c8 npm run test",
     "extract-api": "betools extract-api --entry=lib/esm/tree-widget-react --apiReportFolder=./api --apiReportTempFolder=./api/temp --apiSummaryFolder=./api --includeUnexportedApis",
     "check-internal": "node ../../../scripts/checkInternal.js --apiSummary ./api/tree-widget-react.api.md",
     "lint": "npm run lint:eslint && npm run lint:stylelint",
@@ -39,6 +43,8 @@
     "lint:stylelint": "stylelint \"./src/**/*.css\"",
     "lint:fix": "npm run lint:eslint -- --fix && npm run lint:stylelint -- --fix",
     "pseudolocalize": "betools pseudolocalize --englishDir ./public/locales/en --out ./lib/public/locales/en-PSEUDO",
+    "test:dev": "node --experimental-test-module-mocks --enable-source-maps --import ../../../node-hooks/ignore-styles/register.cjs ./node_modules/mocha/bin/mocha.js --config ./.mocharc.json",
+    "test": "npm run test:dev -- --parallel --jobs=4",
     "test:e2e": "node ../../../scripts/run-e2e-with-docker.js tree-widget",
     "test:e2e:local": "node ../../../scripts/run-e2e-tests.js",
     "test:e2e:debug": "cross-env PWDEBUG=1 playwright test --ui",
@@ -48,98 +54,97 @@
     "check-extractions": "node ../../../scripts/updateExtractions.js --targets=./README.md --check"
   },
   "peerDependencies": {
-    "@itwin/appui-abstract": "^4.0.0",
-    "@itwin/appui-react": "^4.10.0 || ^5.0.0",
-    "@itwin/components-react": "^4.10.0 || ^5.0.0",
-    "@itwin/core-frontend": "^4.0.0",
-    "@itwin/ecschema-metadata": "^4.0.0",
-    "@itwin/itwinui-react": "^5.0.0-alpha.7",
-    "@itwin/itwinui-icons": "^5.0.0-alpha.3",
-    "@itwin/presentation-components": "^5.0.0",
-    "react": "^17.0.0 || ^18.0.0",
-    "react-dom": "^17.0.0 || ^18.0.0"
+    "@itwin/appui-abstract": "^5.0.0",
+    "@itwin/appui-react": "^5.5.0",
+    "@itwin/core-bentley": "^5.0.0",
+    "@itwin/components-react": "^5.5.0",
+    "@itwin/core-common": "^5.0.0",
+    "@itwin/core-frontend": "^5.0.0",
+    "@itwin/ecschema-metadata": "^5.0.0",
+    "@stratakit/foundations": "^0.4",
+    "@stratakit/bricks": "^0.5",
+    "@stratakit/structures": "^0.5",
+    "@stratakit/icons": "^0.2",
+    "@itwin/presentation-common": "^5.0.0",
+    "@itwin/presentation-components": "^5.12.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
   },
   "dependencies": {
-    "@itwin/itwinui-icons-react": "^2.9.0",
-    "@itwin/itwinui-illustrations-react": "^2.1.0",
-    "@itwin/presentation-core-interop": "^1.2.0",
-    "@itwin/presentation-hierarchies": "^1.4.1",
-    "@itwin/presentation-hierarchies-react": "^2.0.0-alpha.5",
-    "@itwin/presentation-shared": "^1.2.0",
-    "@itwin/unified-selection": "^1.3.0",
-    "@itwin/unified-selection-react": "^1.0.0",
+    "@itwin/presentation-core-interop": "^1.4.0-alpha.3",
+    "@itwin/presentation-hierarchies": "^2.0.0-alpha.6",
+    "@itwin/presentation-hierarchies-react": "2.0.0-alpha.44",
+    "@itwin/presentation-shared": "^2.0.0-alpha.4",
+    "@itwin/unified-selection": "^1.6.2-alpha.0",
     "classnames": "^2.5.1",
-    "react-error-boundary": "^4.1.2",
+    "react-error-boundary": "^5.0.0",
     "rxjs": "^7.8.1"
   },
   "devDependencies": {
-    "@itwin/appui-abstract": "^4.10.2",
-    "@itwin/appui-react": "^5.0.5",
-    "@itwin/build-tools": "^4.10.2",
-    "@itwin/components-react": "^5.0.5",
-    "@itwin/core-backend": "^4.10.2",
-    "@itwin/core-bentley": "^4.10.2",
-    "@itwin/core-common": "^4.10.2",
-    "@itwin/core-frontend": "^4.10.2",
-    "@itwin/core-geometry": "^4.10.2",
-    "@itwin/core-i18n": "^4.10.2",
-    "@itwin/core-markup": "^4.10.2",
-    "@itwin/core-orbitgt": "^4.10.2",
-    "@itwin/core-quantity": "^4.10.2",
-    "@itwin/core-react": "^5.0.5",
-    "@itwin/core-telemetry": "^4.10.2",
-    "@itwin/ecschema-metadata": "^4.10.2",
-    "@itwin/ecschema-rpcinterface-common": "^4.10.2",
-    "@itwin/ecschema-rpcinterface-impl": "^4.10.2",
-    "@itwin/eslint-plugin": "^4.1.1",
-    "@itwin/imodel-components-react": "^5.0.5",
-    "@itwin/itwinui-react": "^5.0.0-alpha.7",
-    "@itwin/itwinui-icons": "^5.0.0-alpha.3",
-    "@itwin/oidc-signin-tool": "^4.4.0",
-    "@itwin/presentation-backend": "^4.10.2",
-    "@itwin/presentation-common": "^4.10.2",
-    "@itwin/presentation-components": "^5.9.0",
-    "@itwin/presentation-frontend": "^4.10.2",
-    "@itwin/presentation-testing": "^5.3.0",
-    "@itwin/webgl-compatibility": "^4.10.2",
+    "@bentley/classification-systems-schema": "1.0.4-dev.4",
+    "@itwin/appui-abstract": "^5.0.0",
+    "@itwin/appui-react": "^5.10.0",
+    "@itwin/build-tools": "^5.0.0",
+    "@itwin/components-react": "^5.10.0",
+    "@itwin/core-backend": "^5.0.0",
+    "@itwin/core-bentley": "^5.0.0",
+    "@itwin/core-common": "^5.0.0",
+    "@itwin/core-frontend": "^5.0.0",
+    "@itwin/core-geometry": "^5.0.0",
+    "@itwin/core-i18n": "^5.0.0",
+    "@itwin/core-markup": "^5.0.0",
+    "@itwin/core-orbitgt": "^5.0.0",
+    "@itwin/core-quantity": "^5.0.0",
+    "@itwin/core-react": "^5.10.0",
+    "@itwin/ecschema-metadata": "^5.0.0",
+    "@itwin/ecschema-rpcinterface-common": "^5.0.0",
+    "@itwin/ecschema-rpcinterface-impl": "^5.0.0",
+    "@itwin/eslint-plugin": "^5.2.1",
+    "@itwin/imodel-components-react": "^5.10.0",
+    "@itwin/oidc-signin-tool": "^5.0.0",
+    "@itwin/presentation-backend": "^5.0.0",
+    "@itwin/presentation-common": "^5.0.0",
+    "@itwin/presentation-components": "5.12.15-alpha.0",
+    "@itwin/presentation-frontend": "^5.0.0",
+    "@itwin/presentation-testing": "5.4.11-alpha.0",
+    "@itwin/webgl-compatibility": "^5.0.0",
+    "@stratakit/foundations": "^0.4.0",
+    "@stratakit/bricks": "^0.5.0",
+    "@stratakit/structures": "^0.5.0",
+    "@stratakit/icons": "^0.2.0",
     "@playwright/test": "^1.48.2",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.2.0",
-    "@testing-library/user-event": "^14.6.0",
-    "@types/chai": "^4.3.16",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/chai": "^5.2.1",
     "@types/chai-as-promised": "^8.0.1",
     "@types/chai-jest-snapshot": "^1.3.8",
-    "@types/chai-subset": "^1.3.5",
     "@types/deep-equal": "^1.0.1",
-    "@types/jsdom": "^21.1.6",
+    "@types/jsdom": "^21.1.7",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^18.18.10",
+    "@types/node": "^22.13.9",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "@types/sinon": "^17.0.3",
     "@types/sinon-chai": "^4.0.0",
-    "@typescript-eslint/eslint-plugin": "^7.16.1",
-    "@typescript-eslint/parser": "^7.16.1",
     "c8": "^10.1.3",
-    "chai": "^4.5.0",
+    "chai": "^5.2.0",
     "chai-as-promised": "^8.0.1",
     "chai-jest-snapshot": "^2.0.0",
-    "chai-subset": "^1.6.0",
     "cpx2": "^3.0.0",
     "cross-env": "^7.0.3",
-    "deep-equal": "^1.0.0",
     "dotenv": "^16.3.1",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-react": "^7.34.4",
-    "eslint-plugin-unused-imports": "^3.2.0",
+    "eslint": "^9.26.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-unused-imports": "^4.1.4",
     "fast-xml-parser": "^4.3.6",
-    "global-jsdom": "^9.2.0",
+    "global-jsdom": "^26.0.0",
     "http-server": "^14.1.1",
     "ignore-styles": "^5.0.1",
-    "jsdom": "^23.1.0",
-    "mocha": "^11.0.1",
+    "jsdom": "^26.0.0",
+    "mocha": "^11.1.0",
     "postcss": "^8.4.32",
     "raf": "^3.4.0",
     "react": "^18.3.1",
@@ -148,22 +153,14 @@
     "redux": "^4.1.0",
     "rimraf": "^6.0.1",
     "sinon": "^19.0.2",
-    "sinon-chai": "^3.7.0",
+    "sinon-chai": "^4.0.0",
     "stylelint": "^15.11.0",
     "stylelint-config-standard-scss": "^11.1.0",
-    "testdouble": "^3.20.2",
-    "typemoq": "^2.1.0",
-    "typescript": "~5.2.0"
+    "typescript": "~5.8.3"
   },
   "eslintConfig": {
     "extends": [
       ".eslintrc.js"
     ]
-  },
-  "pnpm": {
-    "overrides": {
-      "@itwin/oidc-signin-tool>@itwin/core-common": "4.10.2",
-      "@itwin/service-authorization>@itwin/core-common": "4.10.2"
-    }
   }
 }

package/lib/esm/tree-widget-react/components/trees/categories-tree/CategoriesVisibilityHandler.d.ts

@@ -1,28 +0,0 @@
-import { BeEvent } from "@itwin/core-bentley";
-import { HierarchyNode } from "@itwin/presentation-hierarchies";
-import type { Viewport } from "@itwin/core-frontend";
-import type { HierarchyVisibilityHandler, VisibilityStatus } from "../common/UseHierarchyVisibility.js";
-interface CategoriesVisibilityHandlerProps {
-    viewport: Viewport;
-}
-/** @internal */
-export declare class CategoriesVisibilityHandler implements HierarchyVisibilityHandler {
-    private _pendingVisibilityChange;
-    private _viewport;
-    constructor(props: CategoriesVisibilityHandlerProps);
-    dispose(): void;
-    onVisibilityChange: BeEvent<import("@itwin/core-bentley").Listener>;
-    /** Returns visibility status of the tree node. */
-    getVisibilityStatus(node: HierarchyNode): Promise<VisibilityStatus> | VisibilityStatus;
-    changeVisibility(node: HierarchyNode, on: boolean): Promise<void>;
-    getSubCategoryVisibility(node: HierarchyNode): "hidden" | "visible";
-    getCategoryVisibility(node: HierarchyNode): "hidden" | "visible";
-    private onDisplayStyleChanged;
-    private onViewedCategoriesChanged;
-    private onVisibilityChangeInternal;
-    static getInstanceIdFromHierarchyNode(node: HierarchyNode): string;
-    enableCategory(ids: string[], enabled: boolean, enableAllSubCategories?: boolean): Promise<void>;
-    enableSubCategory(key: string, enabled: boolean): void;
-}
-export {};
-//# sourceMappingURL=CategoriesVisibilityHandler.d.ts.map

package/lib/esm/tree-widget-react/components/trees/categories-tree/CategoriesVisibilityHandler.js

@@ -1,87 +0,0 @@
-/*---------------------------------------------------------------------------------------------
- * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
- * See LICENSE.md in the project root for license terms and full copyright notice.
- *--------------------------------------------------------------------------------------------*/
-import { BeEvent } from "@itwin/core-bentley";
-import { HierarchyNode } from "@itwin/presentation-hierarchies";
-import { enableCategoryDisplay, enableSubCategoryDisplay } from "../common/CategoriesVisibilityUtils.js";
-import { createVisibilityStatus } from "../common/Tooltip.js";
-/** @internal */
-export class CategoriesVisibilityHandler {
-    constructor(props) {
-        this.onVisibilityChange = new BeEvent();
-        // eslint-disable-next-line @typescript-eslint/naming-convention
-        this.onDisplayStyleChanged = () => {
-            this.onVisibilityChangeInternal();
-        };
-        // eslint-disable-next-line @typescript-eslint/naming-convention
-        this.onViewedCategoriesChanged = () => {
-            this.onVisibilityChangeInternal();
-        };
-        this._viewport = props.viewport;
-        this._viewport.onDisplayStyleChanged.addListener(this.onDisplayStyleChanged);
-        this._viewport.onViewedCategoriesChanged.addListener(this.onViewedCategoriesChanged);
-    }
-    dispose() {
-        this._viewport.onDisplayStyleChanged.removeListener(this.onDisplayStyleChanged);
-        this._viewport.onViewedCategoriesChanged.removeListener(this.onViewedCategoriesChanged);
-        clearTimeout(this._pendingVisibilityChange);
-    }
-    /** Returns visibility status of the tree node. */
-    getVisibilityStatus(node) {
-        if (!HierarchyNode.isInstancesNode(node)) {
-            return { state: "hidden", isDisabled: true };
-        }
-        return createVisibilityStatus(node.parentKeys.length ? this.getSubCategoryVisibility(node) : this.getCategoryVisibility(node));
-    }
-    async changeVisibility(node, on) {
-        if (!HierarchyNode.isInstancesNode(node)) {
-            return;
-        }
-        // handle subcategory visibility change
-        if (node.parentKeys.length) {
-            const childId = CategoriesVisibilityHandler.getInstanceIdFromHierarchyNode(node);
-            const parentCategoryId = node.extendedData?.categoryId;
-            // make sure parent category is enabled
-            if (on && parentCategoryId) {
-                await this.enableCategory([parentCategoryId], true, false);
-            }
-            this.enableSubCategory(childId, on);
-            return;
-        }
-        const instanceId = CategoriesVisibilityHandler.getInstanceIdFromHierarchyNode(node);
-        await this.enableCategory([instanceId], on, true);
-    }
-    getSubCategoryVisibility(node) {
-        const parentCategoryId = node.extendedData?.categoryId;
-        if (!parentCategoryId) {
-            return "hidden";
-        }
-        const subcategoryId = CategoriesVisibilityHandler.getInstanceIdFromHierarchyNode(node);
-        const isVisible = this._viewport.view.viewsCategory(parentCategoryId) && this._viewport.isSubCategoryVisible(subcategoryId);
-        return isVisible ? "visible" : "hidden";
-    }
-    getCategoryVisibility(node) {
-        const instanceId = CategoriesVisibilityHandler.getInstanceIdFromHierarchyNode(node);
-        return this._viewport.view.viewsCategory(instanceId) ? "visible" : "hidden";
-    }
-    onVisibilityChangeInternal() {
-        if (this._pendingVisibilityChange) {
-            return;
-        }
-        this._pendingVisibilityChange = setTimeout(() => {
-            this.onVisibilityChange.raiseEvent();
-            this._pendingVisibilityChange = undefined;
-        }, 0);
-    }
-    static getInstanceIdFromHierarchyNode(node) {
-        return HierarchyNode.isInstancesNode(node) && node.key.instanceKeys.length > 0 ? node.key.instanceKeys[0].id : "";
-    }
-    async enableCategory(ids, enabled, enableAllSubCategories = true) {
-        await enableCategoryDisplay(this._viewport, ids, enabled, enableAllSubCategories);
-    }
-    enableSubCategory(key, enabled) {
-        enableSubCategoryDisplay(this._viewport, key, enabled);
-    }
-}
-//# sourceMappingURL=CategoriesVisibilityHandler.js.map