@itwin/presentation-hierarchies-react 0.1.0

package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.d.ts

@@ -0,0 +1,16 @@
+import { SelectionChangeType } from "../UseSelectionHandler";
+import { TreeModelNode, TreeModelRootNode } from "./TreeModel";
+/** @internal */
+export interface TreeSelectionOptions {
+    isNodeSelected: (nodeId: string) => boolean;
+    selectNodes: (nodeIds: Array<string>, changeType: SelectionChangeType) => void;
+}
+/** @internal */
+export interface UseUnifiedTreeSelectionProps {
+    imodelKey: string;
+    sourceName: string;
+    getNode: (nodeId: string) => TreeModelNode | TreeModelRootNode | undefined;
+}
+/** @internal */
+export declare function useUnifiedTreeSelection({ imodelKey, sourceName, getNode }: UseUnifiedTreeSelectionProps): TreeSelectionOptions;
+//# sourceMappingURL=UseUnifiedSelection.d.ts.map

package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseUnifiedSelection.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/internal/UseUnifiedSelection.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAA4B,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEzF,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,WAAW,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChF;AAED,gBAAgB;AAChB,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAAC;CAC5E;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,4BAA4B,GAAG,oBAAoB,CA2B9H"}

package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.js

@@ -0,0 +1,92 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { useEffect, useState } from "react";
+import { HierarchyNode } from "@itwin/presentation-hierarchies";
+import { Selectables } from "@itwin/unified-selection";
+import { useUnifiedSelectionContext } from "../UnifiedSelectionContext";
+import { isTreeModelHierarchyNode } from "./TreeModel";
+/** @internal */
+export function useUnifiedTreeSelection({ imodelKey, sourceName, getNode }) {
+    const [options, setOptions] = useState(() => ({
+        isNodeSelected: /* istanbul ignore next */ () => false,
+        selectNodes: /* istanbul ignore next */ () => { },
+    }));
+    const selectionStorage = useUnifiedSelectionContext();
+    useEffect(() => {
+        if (!selectionStorage) {
+            setOptions({
+                isNodeSelected: () => false,
+                selectNodes: () => { },
+            });
+            return;
+        }
+        setOptions(createOptions(imodelKey, sourceName, selectionStorage, getNode));
+        return selectionStorage.selectionChangeEvent.addListener((args) => {
+            if (imodelKey !== args.imodelKey || args.level > 0) {
+                return;
+            }
+            setOptions(createOptions(imodelKey, sourceName, selectionStorage, getNode));
+        });
+    }, [selectionStorage, getNode, imodelKey, sourceName]);
+    return options;
+}
+function createOptions(key, source, storage, getNode) {
+    return {
+        isNodeSelected: (nodeId) => {
+            const node = getNode(nodeId);
+            if (!node || !isTreeModelHierarchyNode(node)) {
+                return false;
+            }
+            const selectables = storage.getSelection({ imodelKey: key, level: 0 });
+            const hierarchyNode = node.nodeData;
+            if (HierarchyNode.isInstancesNode(hierarchyNode)) {
+                return Selectables.hasAny(selectables, hierarchyNode.key.instanceKeys);
+            }
+            return Selectables.has(selectables, { identifier: node.id });
+        },
+        selectNodes: (nodeIds, changeType) => {
+            let selectables = [];
+            for (const nodeId of nodeIds) {
+                const node = getNode(nodeId);
+                if (!node || !isTreeModelHierarchyNode(node)) {
+                    return;
+                }
+                selectables = [...selectables, ...createSelectables(node.id, node.nodeData)];
+            }
+            const actionProps = { imodelKey: key, source, selectables, level: 0 };
+            switch (changeType) {
+                case "add":
+                    storage.addToSelection(actionProps);
+                    return;
+                case "remove":
+                    storage.removeFromSelection(actionProps);
+                    return;
+                case "replace":
+                    storage.replaceSelection(actionProps);
+                    return;
+            }
+        },
+    };
+}
+function createSelectables(nodeId, node) {
+    if (HierarchyNode.isInstancesNode(node)) {
+        return node.key.instanceKeys;
+    }
+    return [
+        {
+            identifier: nodeId,
+            async *loadInstanceKeys() {
+                if (!HierarchyNode.isGroupingNode(node)) {
+                    return;
+                }
+                for (const key of node.groupedInstanceKeys) {
+                    yield key;
+                }
+            },
+            data: node,
+        },
+    ];
+}
+//# sourceMappingURL=UseUnifiedSelection.js.map

package/lib/esm/presentation-hierarchies-react/internal/UseUnifiedSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseUnifiedSelection.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/internal/UseUnifiedSelection.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, useState } from \"react\";\nimport { HierarchyNode } from \"@itwin/presentation-hierarchies\";\nimport { Selectable, Selectables, SelectionStorage } from \"@itwin/unified-selection\";\nimport { useUnifiedSelectionContext } from \"../UnifiedSelectionContext\";\nimport { SelectionChangeType } from \"../UseSelectionHandler\";\nimport { isTreeModelHierarchyNode, TreeModelNode, TreeModelRootNode } from \"./TreeModel\";\n\n/** @internal */\nexport interface TreeSelectionOptions {\n  isNodeSelected: (nodeId: string) => boolean;\n  selectNodes: (nodeIds: Array<string>, changeType: SelectionChangeType) => void;\n}\n\n/** @internal */\nexport interface UseUnifiedTreeSelectionProps {\n  imodelKey: string;\n  sourceName: string;\n  getNode: (nodeId: string) => TreeModelNode | TreeModelRootNode | undefined;\n}\n\n/** @internal */\nexport function useUnifiedTreeSelection({ imodelKey, sourceName, getNode }: UseUnifiedTreeSelectionProps): TreeSelectionOptions {\n  const [options, setOptions] = useState<TreeSelectionOptions>(() => ({\n    isNodeSelected: /* istanbul ignore next */ () => false,\n    selectNodes: /* istanbul ignore next */ () => {},\n  }));\n\n  const selectionStorage = useUnifiedSelectionContext();\n  useEffect(() => {\n    if (!selectionStorage) {\n      setOptions({\n        isNodeSelected: () => false,\n        selectNodes: () => {},\n      });\n      return;\n    }\n\n    setOptions(createOptions(imodelKey, sourceName, selectionStorage, getNode));\n    return selectionStorage.selectionChangeEvent.addListener((args) => {\n      if (imodelKey !== args.imodelKey || args.level > 0) {\n        return;\n      }\n\n      setOptions(createOptions(imodelKey, sourceName, selectionStorage, getNode));\n    });\n  }, [selectionStorage, getNode, imodelKey, sourceName]);\n\n  return options;\n}\n\nfunction createOptions(\n  key: string,\n  source: string,\n  storage: SelectionStorage,\n  getNode: (nodeId: string) => TreeModelNode | TreeModelRootNode | undefined,\n): TreeSelectionOptions {\n  return {\n    isNodeSelected: (nodeId: string) => {\n      const node = getNode(nodeId);\n      if (!node || !isTreeModelHierarchyNode(node)) {\n        return false;\n      }\n\n      const selectables = storage.getSelection({ imodelKey: key, level: 0 });\n\n      const hierarchyNode = node.nodeData;\n      if (HierarchyNode.isInstancesNode(hierarchyNode)) {\n        return Selectables.hasAny(selectables, hierarchyNode.key.instanceKeys);\n      }\n\n      return Selectables.has(selectables, { identifier: node.id });\n    },\n\n    selectNodes: (nodeIds: Array<string>, changeType: SelectionChangeType) => {\n      let selectables: Selectable[] = [];\n\n      for (const nodeId of nodeIds) {\n        const node = getNode(nodeId);\n        if (!node || !isTreeModelHierarchyNode(node)) {\n          return;\n        }\n        selectables = [...selectables, ...createSelectables(node.id, node.nodeData)];\n      }\n\n      const actionProps = { imodelKey: key, source, selectables, level: 0 };\n\n      switch (changeType) {\n        case \"add\":\n          storage.addToSelection(actionProps);\n          return;\n        case \"remove\":\n          storage.removeFromSelection(actionProps);\n          return;\n        case \"replace\":\n          storage.replaceSelection(actionProps);\n          return;\n      }\n    },\n  };\n}\n\nfunction createSelectables(nodeId: string, node: HierarchyNode): Selectable[] {\n  if (HierarchyNode.isInstancesNode(node)) {\n    return node.key.instanceKeys;\n  }\n\n  return [\n    {\n      identifier: nodeId,\n      async *loadInstanceKeys() {\n        if (!HierarchyNode.isGroupingNode(node)) {\n          return;\n        }\n\n        for (const key of node.groupedInstanceKeys) {\n          yield key;\n        }\n      },\n      data: node,\n    },\n  ];\n}\n"]}

package/lib/esm/presentation-hierarchies-react/internal/Utils.d.ts

@@ -0,0 +1,8 @@
+import { HierarchyNode } from "@itwin/presentation-hierarchies";
+/** @internal */
+export declare function createNodeId(node: Pick<HierarchyNode, "key" | "parentKeys">): string;
+/** @internal */
+export declare function sameNodes(lhs: HierarchyNode, rhs: HierarchyNode): boolean;
+/** @internal */
+export declare const MAX_LIMIT_OVERRIDE = 10000;
+//# sourceMappingURL=Utils.d.ts.map

package/lib/esm/presentation-hierarchies-react/internal/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/internal/Utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAoB,MAAM,iCAAiC,CAAC;AAElF,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,YAAY,CAAC,UAE3E;AAiBD,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAezE;AAED,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,QAAQ,CAAC"}

package/lib/esm/presentation-hierarchies-react/internal/Utils.js

@@ -0,0 +1,40 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { HierarchyNodeKey } from "@itwin/presentation-hierarchies";
+/** @internal */
+export function createNodeId(node) {
+    return [...node.parentKeys.map(serializeNodeKey), serializeNodeKey(node.key)].join(";");
+}
+function serializeNodeKey(key) {
+    return HierarchyNodeKey.isCustom(key) ? key : convertObjectValuesToString(key);
+}
+function convertObjectValuesToString(obj) {
+    return Object.entries(obj)
+        .map(([, value]) => {
+        if (typeof value === "object") {
+            return convertObjectValuesToString(value);
+        }
+        return String(value);
+    })
+        .join(",");
+}
+/** @internal */
+export function sameNodes(lhs, rhs) {
+    if (HierarchyNodeKey.compare(lhs.key, rhs.key) !== 0) {
+        return false;
+    }
+    if (lhs.parentKeys.length !== rhs.parentKeys.length) {
+        return false;
+    }
+    for (let i = lhs.parentKeys.length - 1; i >= 0; --i) {
+        if (HierarchyNodeKey.compare(lhs.parentKeys[i], rhs.parentKeys[i]) !== 0) {
+            return false;
+        }
+    }
+    return true;
+}
+/** @internal */
+export const MAX_LIMIT_OVERRIDE = 10000;
+//# sourceMappingURL=Utils.js.map

package/lib/esm/presentation-hierarchies-react/internal/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/internal/Utils.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAiB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAElF,gBAAgB;AAChB,MAAM,UAAU,YAAY,CAAC,IAA+C;IAC1E,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAqB;IAC7C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAW;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE;QACjB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,2BAA2B,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,SAAS,CAAC,GAAkB,EAAE,GAAkB;IAC9D,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACpD,IAAI,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { HierarchyNode, HierarchyNodeKey } from \"@itwin/presentation-hierarchies\";\n\n/** @internal */\nexport function createNodeId(node: Pick<HierarchyNode, \"key\" | \"parentKeys\">) {\n  return [...node.parentKeys.map(serializeNodeKey), serializeNodeKey(node.key)].join(\";\");\n}\n\nfunction serializeNodeKey(key: HierarchyNodeKey): string {\n  return HierarchyNodeKey.isCustom(key) ? key : convertObjectValuesToString(key);\n}\n\nfunction convertObjectValuesToString(obj: object): string {\n  return Object.entries(obj)\n    .map(([, value]) => {\n      if (typeof value === \"object\") {\n        return convertObjectValuesToString(value);\n      }\n      return String(value);\n    })\n    .join(\",\");\n}\n\n/** @internal */\nexport function sameNodes(lhs: HierarchyNode, rhs: HierarchyNode): boolean {\n  if (HierarchyNodeKey.compare(lhs.key, rhs.key) !== 0) {\n    return false;\n  }\n\n  if (lhs.parentKeys.length !== rhs.parentKeys.length) {\n    return false;\n  }\n\n  for (let i = lhs.parentKeys.length - 1; i >= 0; --i) {\n    if (HierarchyNodeKey.compare(lhs.parentKeys[i], rhs.parentKeys[i]) !== 0) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** @internal */\nexport const MAX_LIMIT_OVERRIDE = 10000;\n"]}

package/lib/esm/presentation-hierarchies-react/itwinui/LocalizationContext.d.ts

@@ -0,0 +1,57 @@
+import { PropsWithChildren } from "react";
+/** @internal */
+export interface LocalizedStrings {
+    /**
+     * Message displayed when nodes are loading.
+     * Default value: `Loading...`.
+     */
+    loading: string;
+    /**
+     * Title for apply hierarchy filter button.
+     * Default value: `Apply filter`.
+     */
+    filterHierarchyLevel: string;
+    /**
+     * Title for clear hierarchy filter button.
+     * Default value: `Clear active filter`.
+     */
+    clearHierarchyLevelFilter: string;
+    /**
+     * Message displayed when no nodes matching filter are found.
+     * Default value: `No child nodes match current filter`.
+     */
+    noFilteredChildren: string;
+    /**
+     * Message displayed when result limit exceeds hierarchy size limit.
+     * Default value: `There are more items than allowed limit of {{limit}}.`.
+     */
+    resultLimitExceeded: string;
+    /**
+     * Message displayed when result limit exceeds hierarchy size limit and hierarchy filtering is enabled.
+     * Default value: `Please provide <link>additional filtering</link> - there are more items than allowed limit of {{limit}}.`.
+     */
+    resultLimitExceededWithFiltering: string;
+    /**
+     * Message displayed when hierarchy size limit can be overridden.
+     * Default value: `<link>Increase the hierarchy level size limit to {{limit}}.</link>`.
+     */
+    increaseHierarchyLimit: string;
+    /**
+     * Message displayed when hierarchy size limit can be overridden and hierarchy filtering is enabled.
+     * Default value: `Or, <link>increase the hierarchy level size limit to {{limit}}.</link>`.
+     */
+    increaseHierarchyLimitWithFiltering: string;
+}
+/** @internal */
+export interface LocalizationContext {
+    localizedStrings: LocalizedStrings;
+}
+interface LocalizationContextProviderProps {
+    localizedStrings?: Partial<LocalizedStrings>;
+}
+/** @beta */
+export declare function LocalizationContextProvider({ localizedStrings, children }: PropsWithChildren<LocalizationContextProviderProps>): import("react/jsx-runtime").JSX.Element;
+/** @internal */
+export declare function useLocalizationContext(): LocalizationContext;
+export {};
+//# sourceMappingURL=LocalizationContext.d.ts.map

package/lib/esm/presentation-hierarchies-react/itwinui/LocalizationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationContext.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/itwinui/LocalizationContext.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAiB,iBAAiB,EAAmC,MAAM,OAAO,CAAC;AAE1F,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,yBAAyB,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gCAAgC,EAAE,MAAM,CAAC;IACzC;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,mCAAmC,EAAE,MAAM,CAAC;CAC7C;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAeD,UAAU,gCAAgC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED,YAAY;AACZ,wBAAgB,2BAA2B,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC,gCAAgC,CAAC,2CAQ9H;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,wBAErC"}

package/lib/esm/presentation-hierarchies-react/itwinui/LocalizationContext.js

@@ -0,0 +1,30 @@
+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 { createContext, useContext, useEffect, useState } from "react";
+const defaultLocalizedStrings = {
+    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>",
+};
+const localizationContext = createContext({ localizedStrings: defaultLocalizedStrings });
+/** @beta */
+export function LocalizationContextProvider({ localizedStrings, children }) {
+    const [state, setState] = useState({ localizedStrings: { ...defaultLocalizedStrings, ...localizedStrings } });
+    useEffect(() => {
+        setState({ localizedStrings: { ...defaultLocalizedStrings, ...localizedStrings } });
+    }, [localizedStrings]);
+    return _jsx(localizationContext.Provider, { value: state, children: children });
+}
+/** @internal */
+export function useLocalizationContext() {
+    return useContext(localizationContext);
+}
+//# sourceMappingURL=LocalizationContext.js.map

package/lib/esm/presentation-hierarchies-react/itwinui/LocalizationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationContext.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/itwinui/LocalizationContext.tsx"],"names":[],"mappings":";AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,aAAa,EAAqB,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAmD1F,MAAM,uBAAuB,GAAqB;IAChD,OAAO,EAAE,YAAY;IACrB,oBAAoB,EAAE,cAAc;IACpC,yBAAyB,EAAE,qBAAqB;IAChD,kBAAkB,EAAE,qCAAqC;IACzD,mBAAmB,EAAE,uDAAuD;IAC5E,gCAAgC,EAAE,0GAA0G;IAC5I,sBAAsB,EAAE,oEAAoE;IAC5F,mCAAmC,EAAE,wEAAwE;CAC9G,CAAC;AAEF,MAAM,mBAAmB,GAAG,aAAa,CAAsB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC,CAAC;AAM9G,YAAY;AACZ,MAAM,UAAU,2BAA2B,CAAC,EAAE,gBAAgB,EAAE,QAAQ,EAAuD;IAC7H,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,gBAAgB,EAAE,EAAE,GAAG,uBAAuB,EAAE,GAAG,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAE9G,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,EAAE,gBAAgB,EAAE,EAAE,GAAG,uBAAuB,EAAE,GAAG,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEvB,OAAO,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAgC,CAAC;AAC/F,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,sBAAsB;IACpC,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { createContext, PropsWithChildren, useContext, useEffect, useState } from \"react\";\n\n/** @internal */\nexport interface LocalizedStrings {\n  /**\n   * Message displayed when nodes are loading.\n   * Default value: `Loading...`.\n   */\n  loading: string;\n  /**\n   * Title for apply hierarchy filter button.\n   * Default value: `Apply filter`.\n   */\n  filterHierarchyLevel: string;\n  /**\n   * Title for clear hierarchy filter button.\n   * Default value: `Clear active filter`.\n   */\n  clearHierarchyLevelFilter: string;\n  /**\n   * Message displayed when no nodes matching filter are found.\n   * Default value: `No child nodes match current filter`.\n   */\n  noFilteredChildren: string;\n  /**\n   * Message displayed when result limit exceeds hierarchy size limit.\n   * Default value: `There are more items than allowed limit of {{limit}}.`.\n   */\n  resultLimitExceeded: string;\n  /**\n   * Message displayed when result limit exceeds hierarchy size limit and hierarchy filtering is enabled.\n   * Default value: `Please provide <link>additional filtering</link> - there are more items than allowed limit of {{limit}}.`.\n   */\n  resultLimitExceededWithFiltering: string;\n  /**\n   * Message displayed when hierarchy size limit can be overridden.\n   * Default value: `<link>Increase the hierarchy level size limit to {{limit}}.</link>`.\n   */\n  increaseHierarchyLimit: string;\n  /**\n   * Message displayed when hierarchy size limit can be overridden and hierarchy filtering is enabled.\n   * Default value: `Or, <link>increase the hierarchy level size limit to {{limit}}.</link>`.\n   */\n  increaseHierarchyLimitWithFiltering: string;\n}\n\n/** @internal */\nexport interface LocalizationContext {\n  localizedStrings: LocalizedStrings;\n}\n\nconst defaultLocalizedStrings: LocalizedStrings = {\n  loading: \"Loading...\",\n  filterHierarchyLevel: \"Apply filter\",\n  clearHierarchyLevelFilter: \"Clear active filter\",\n  noFilteredChildren: \"No child nodes match current filter\",\n  resultLimitExceeded: \"There are more items than allowed limit of {{limit}}.\",\n  resultLimitExceededWithFiltering: \"Please provide <link>additional filtering</link> - there are more items than allowed limit of {{limit}}.\",\n  increaseHierarchyLimit: \"<link>Increase the hierarchy level size limit to {{limit}}.</link>\",\n  increaseHierarchyLimitWithFiltering: \"Or, <link>increase the hierarchy level size limit to {{limit}}.</link>\",\n};\n\nconst localizationContext = createContext<LocalizationContext>({ localizedStrings: defaultLocalizedStrings });\n\ninterface LocalizationContextProviderProps {\n  localizedStrings?: Partial<LocalizedStrings>;\n}\n\n/** @beta */\nexport function LocalizationContextProvider({ localizedStrings, children }: PropsWithChildren<LocalizationContextProviderProps>) {\n  const [state, setState] = useState({ localizedStrings: { ...defaultLocalizedStrings, ...localizedStrings } });\n\n  useEffect(() => {\n    setState({ localizedStrings: { ...defaultLocalizedStrings, ...localizedStrings } });\n  }, [localizedStrings]);\n\n  return <localizationContext.Provider value={state}>{children}</localizationContext.Provider>;\n}\n\n/** @internal */\nexport function useLocalizationContext() {\n  return useContext(localizationContext);\n}\n"]}

package/lib/esm/presentation-hierarchies-react/itwinui/TreeNodeRenderer.css

@@ -0,0 +1,17 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+
+.stateless-tree-node {
+  user-select: none;
+}
+
+.stateless-tree-node .action-buttons {
+  visibility: hidden;
+}
+
+.stateless-tree-node:hover .action-buttons,
+.stateless-tree-node.filtered .action-buttons {
+  visibility: visible;
+}

package/lib/esm/presentation-hierarchies-react/itwinui/TreeNodeRenderer.d.ts

@@ -0,0 +1,27 @@
+import "./TreeNodeRenderer.css";
+import { ComponentPropsWithoutRef, ReactElement } from "react";
+import { TreeNode } from "@itwin/itwinui-react";
+import { PresentationHierarchyNode } from "../TreeNode";
+import { useTree } from "../UseTree";
+import { RenderedTreeNode } from "./TreeRenderer";
+type TreeNodeProps = ComponentPropsWithoutRef<typeof TreeNode>;
+interface TreeNodeRendererOwnProps {
+    node: RenderedTreeNode;
+    onFilterClick?: (nodeId: string | undefined) => void;
+    getIcon?: (node: PresentationHierarchyNode) => ReactElement | undefined;
+    getSublabel?: (node: PresentationHierarchyNode) => ReactElement | undefined;
+    onNodeClick?: (nodeId: string, isSelected: boolean, event: React.MouseEvent<HTMLElement, MouseEvent>) => void;
+    onNodeKeyDown?: (nodeId: string, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => void;
+    actionButtonsClassName?: string;
+}
+type TreeNodeRendererProps = Pick<ReturnType<typeof useTree>, "expandNode"> & Partial<Pick<ReturnType<typeof useTree>, "getHierarchyLevelDetails">> & Omit<TreeNodeProps, "label" | "onExpanded" | "onSelected" | "icon"> & TreeNodeRendererOwnProps;
+/**
+ * A component that renders `RenderedTreeNode` using the `TreeNode` component from `@itwin/itwinui-react`.
+ *
+ * @see `TreeRenderer`
+ * @see https://itwinui.bentley.com/docs/tree
+ * @beta
+ */
+export declare function TreeNodeRenderer({ node, expandNode, getIcon, getSublabel, onFilterClick, onNodeClick, onNodeKeyDown, isSelected, isDisabled, actionButtonsClassName, getHierarchyLevelDetails, ...nodeProps }: TreeNodeRendererProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TreeNodeRenderer.d.ts.map

package/lib/esm/presentation-hierarchies-react/itwinui/TreeNodeRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodeRenderer.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/itwinui/TreeNodeRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAA+D,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE7G,OAAO,EAA+B,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,KAAK,aAAa,GAAG,wBAAwB,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE/D,UAAU,wBAAwB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,YAAY,GAAG,SAAS,CAAC;IACxE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,YAAY,GAAG,SAAS,CAAC;IAC5E,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,KAAK,IAAI,CAAC;IAC9G,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACvG,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,KAAK,qBAAqB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,EAAE,YAAY,CAAC,GACzE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,EAAE,0BAA0B,CAAC,CAAC,GACrE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC,GACnE,wBAAwB,CAAC;AAE3B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,UAAU,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAU,EACV,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,GAAG,SAAS,EACb,EAAE,qBAAqB,2CAuFvB"}

package/lib/esm/presentation-hierarchies-react/itwinui/TreeNodeRenderer.js

@@ -0,0 +1,94 @@
+import { jsx as _jsx, jsxs as _jsxs } 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 "./TreeNodeRenderer.css";
+import cx from "classnames";
+import { SvgFilter, SvgFilterHollow, SvgRemove } from "@itwin/itwinui-icons-react";
+import { Anchor, ButtonGroup, Flex, IconButton, ProgressRadial, Text, TreeNode } from "@itwin/itwinui-react";
+import { MAX_LIMIT_OVERRIDE } from "../internal/Utils";
+import { isPresentationHierarchyNode } from "../TreeNode";
+import { useLocalizationContext } from "./LocalizationContext";
+/**
+ * A component that renders `RenderedTreeNode` using the `TreeNode` component from `@itwin/itwinui-react`.
+ *
+ * @see `TreeRenderer`
+ * @see https://itwinui.bentley.com/docs/tree
+ * @beta
+ */
+export function TreeNodeRenderer({ node, expandNode, getIcon, getSublabel, onFilterClick, onNodeClick, onNodeKeyDown, isSelected, isDisabled, actionButtonsClassName, getHierarchyLevelDetails, ...nodeProps }) {
+    const { localizedStrings } = useLocalizationContext();
+    if ("type" in node && node.type === "ChildrenPlaceholder") {
+        return _jsx(PlaceholderNode, { ...nodeProps });
+    }
+    if (isPresentationHierarchyNode(node)) {
+        return (
+        // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions
+        _jsx("div", { onClick: (event) => !isDisabled && onNodeClick?.(node.id, !isSelected, event), onKeyDown: (event) => {
+                // Ignore if it is called on the element inside, e.g. checkbox or expander
+                if (!isDisabled && event.target instanceof HTMLElement && event.target.classList.contains("stateless-tree-node")) {
+                    onNodeKeyDown?.(node.id, !isSelected, event);
+                }
+            }, children: _jsx(TreeNode, { ...nodeProps, isSelected: isSelected, isDisabled: isDisabled, className: cx(nodeProps.className, "stateless-tree-node", { filtered: node.isFiltered }), label: node.label, onExpanded: (_, isExpanded) => {
+                    expandNode(node.id, isExpanded);
+                }, icon: getIcon ? getIcon(node) : undefined, sublabel: getSublabel ? getSublabel(node) : undefined, children: _jsxs(ButtonGroup, { className: cx("action-buttons", actionButtonsClassName), children: [getHierarchyLevelDetails && node.isFiltered ? (_jsx(IconButton, { className: "filtering-action-button", styleType: "borderless", size: "small", title: localizedStrings.clearHierarchyLevelFilter, onClick: (e) => {
+                                e.stopPropagation();
+                                getHierarchyLevelDetails(node.id)?.setInstanceFilter(undefined);
+                            }, children: _jsx(SvgRemove, {}) })) : null, onFilterClick && node.isFilterable ? (_jsx(IconButton, { className: "filtering-action-button", styleType: "borderless", size: "small", title: localizedStrings.filterHierarchyLevel, onClick: (e) => {
+                                e.stopPropagation();
+                                onFilterClick(node.id);
+                            }, children: node.isFiltered ? _jsx(SvgFilter, {}) : _jsx(SvgFilterHollow, {}) })) : null] }) }) }));
+    }
+    if (node.type === "ResultSetTooLarge") {
+        return (_jsx(ResultSetTooLargeNode, { ...nodeProps, limit: node.resultSetSizeLimit, onOverrideLimit: getHierarchyLevelDetails ? (limit) => getHierarchyLevelDetails(node.parentNodeId)?.setSizeLimit(limit) : undefined, onFilterClick: onFilterClick
+                ? () => {
+                    onFilterClick(node.parentNodeId);
+                }
+                : undefined }));
+    }
+    if (node.type === "NoFilterMatches") {
+        return _jsx(TreeNode, { ...nodeProps, label: localizedStrings.noFilteredChildren, isDisabled: true, onExpanded: /* istanbul ignore next */ () => { } });
+    }
+    return _jsx(TreeNode, { ...nodeProps, label: node.message, isDisabled: true, onExpanded: /* istanbul ignore next */ () => { } });
+}
+function PlaceholderNode(props) {
+    const { localizedStrings } = useLocalizationContext();
+    return (_jsx(TreeNode, { ...props, label: localizedStrings.loading, icon: _jsx(ProgressRadial, { size: "x-small", indeterminate: true, title: localizedStrings.loading }), onExpanded: /* istanbul ignore next */ () => { } }));
+}
+function ResultSetTooLargeNode({ onFilterClick, onOverrideLimit, limit, ...props }) {
+    return (_jsx(TreeNode, { ...props, className: "stateless-tree-node", label: _jsx(ResultSetTooLargeNodeLabel, { limit: limit, onFilterClick: onFilterClick, onOverrideLimit: onOverrideLimit }), onExpanded: /* istanbul ignore next */ () => { } }));
+}
+function ResultSetTooLargeNodeLabel({ onFilterClick, onOverrideLimit, limit }) {
+    const { localizedStrings } = useLocalizationContext();
+    const supportsFiltering = !!onFilterClick;
+    const supportsLimitOverride = !!onOverrideLimit && limit < MAX_LIMIT_OVERRIDE;
+    const limitExceededMessage = createLocalizedMessage(supportsFiltering ? localizedStrings.resultLimitExceededWithFiltering : localizedStrings.resultLimitExceeded, limit, onFilterClick);
+    const increaseLimitMessage = supportsLimitOverride
+        ? createLocalizedMessage(supportsFiltering ? localizedStrings.increaseHierarchyLimitWithFiltering : localizedStrings.increaseHierarchyLimit, MAX_LIMIT_OVERRIDE, () => onOverrideLimit(MAX_LIMIT_OVERRIDE))
+        : { title: "", element: null };
+    const title = `${limitExceededMessage.title} ${increaseLimitMessage.title}`;
+    return (_jsxs(Flex, { flexDirection: "column", gap: "3xs", title: title, alignItems: "start", children: [limitExceededMessage.element, increaseLimitMessage.element] }));
+}
+function createLocalizedMessage(message, limit, onClick) {
+    const limitStr = limit.toLocaleString(undefined, { useGrouping: true });
+    const messageWithLimit = message.replace("{{limit}}", limitStr);
+    const exp = new RegExp("<link>(.*)</link>");
+    const match = messageWithLimit.match(exp);
+    if (!match) {
+        return {
+            title: messageWithLimit,
+            element: (_jsx(Flex, { flexDirection: "row", gap: "3xs", children: _jsx(Text, { children: messageWithLimit }) })),
+        };
+    }
+    const [fullText, innerText] = match;
+    const [textBefore, textAfter] = messageWithLimit.split(fullText);
+    return {
+        title: messageWithLimit.replace(fullText, innerText),
+        element: (_jsxs(Flex, { flexDirection: "row", gap: "3xs", children: [textBefore ? _jsx(Text, { children: textBefore }) : null, _jsx(Anchor, { underline: true, onClick: (e) => {
+                        e.stopPropagation();
+                        onClick?.();
+                    }, children: innerText }), textAfter ? _jsx(Text, { children: textAfter }) : null] })),
+    };
+}
+//# sourceMappingURL=TreeNodeRenderer.js.map

package/lib/esm/presentation-hierarchies-react/itwinui/TreeNodeRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeNodeRenderer.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/itwinui/TreeNodeRenderer.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 \"./TreeNodeRenderer.css\";\nimport cx from \"classnames\";\nimport { ComponentPropsWithoutRef, ReactElement } from \"react\";\nimport { SvgFilter, SvgFilterHollow, SvgRemove } from \"@itwin/itwinui-icons-react\";\nimport { Anchor, ButtonGroup, Flex, IconButton, ProgressRadial, Text, TreeNode } from \"@itwin/itwinui-react\";\nimport { MAX_LIMIT_OVERRIDE } from \"../internal/Utils\";\nimport { isPresentationHierarchyNode, PresentationHierarchyNode } from \"../TreeNode\";\nimport { useTree } from \"../UseTree\";\nimport { useLocalizationContext } from \"./LocalizationContext\";\nimport { RenderedTreeNode } from \"./TreeRenderer\";\n\ntype TreeNodeProps = ComponentPropsWithoutRef<typeof TreeNode>;\n\ninterface TreeNodeRendererOwnProps {\n  node: RenderedTreeNode;\n  onFilterClick?: (nodeId: string | undefined) => void;\n  getIcon?: (node: PresentationHierarchyNode) => ReactElement | undefined;\n  getSublabel?: (node: PresentationHierarchyNode) => ReactElement | undefined;\n  onNodeClick?: (nodeId: string, isSelected: boolean, event: React.MouseEvent<HTMLElement, MouseEvent>) => void;\n  onNodeKeyDown?: (nodeId: string, isSelected: boolean, event: React.KeyboardEvent<HTMLElement>) => void;\n  actionButtonsClassName?: string;\n}\n\ntype TreeNodeRendererProps = Pick<ReturnType<typeof useTree>, \"expandNode\"> &\n  Partial<Pick<ReturnType<typeof useTree>, \"getHierarchyLevelDetails\">> &\n  Omit<TreeNodeProps, \"label\" | \"onExpanded\" | \"onSelected\" | \"icon\"> &\n  TreeNodeRendererOwnProps;\n\n/**\n * A component that renders `RenderedTreeNode` using the `TreeNode` component from `@itwin/itwinui-react`.\n *\n * @see `TreeRenderer`\n * @see https://itwinui.bentley.com/docs/tree\n * @beta\n */\nexport function TreeNodeRenderer({\n  node,\n  expandNode,\n  getIcon,\n  getSublabel,\n  onFilterClick,\n  onNodeClick,\n  onNodeKeyDown,\n  isSelected,\n  isDisabled,\n  actionButtonsClassName,\n  getHierarchyLevelDetails,\n  ...nodeProps\n}: TreeNodeRendererProps) {\n  const { localizedStrings } = useLocalizationContext();\n  if (\"type\" in node && node.type === \"ChildrenPlaceholder\") {\n    return <PlaceholderNode {...nodeProps} />;\n  }\n\n  if (isPresentationHierarchyNode(node)) {\n    return (\n      // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions\n      <div\n        onClick={(event) => !isDisabled && onNodeClick?.(node.id, !isSelected, event)}\n        onKeyDown={(event) => {\n          // Ignore if it is called on the element inside, e.g. checkbox or expander\n          if (!isDisabled && event.target instanceof HTMLElement && event.target.classList.contains(\"stateless-tree-node\")) {\n            onNodeKeyDown?.(node.id, !isSelected, event);\n          }\n        }}\n      >\n        <TreeNode\n          {...nodeProps}\n          isSelected={isSelected}\n          isDisabled={isDisabled}\n          className={cx(nodeProps.className, \"stateless-tree-node\", { filtered: node.isFiltered })}\n          label={node.label}\n          onExpanded={(_, isExpanded) => {\n            expandNode(node.id, isExpanded);\n          }}\n          icon={getIcon ? getIcon(node) : undefined}\n          sublabel={getSublabel ? getSublabel(node) : undefined}\n        >\n          <ButtonGroup className={cx(\"action-buttons\", actionButtonsClassName)}>\n            {getHierarchyLevelDetails && node.isFiltered ? (\n              <IconButton\n                className=\"filtering-action-button\"\n                styleType=\"borderless\"\n                size=\"small\"\n                title={localizedStrings.clearHierarchyLevelFilter}\n                onClick={(e) => {\n                  e.stopPropagation();\n                  getHierarchyLevelDetails(node.id)?.setInstanceFilter(undefined);\n                }}\n              >\n                <SvgRemove />\n              </IconButton>\n            ) : null}\n            {onFilterClick && node.isFilterable ? (\n              <IconButton\n                className=\"filtering-action-button\"\n                styleType=\"borderless\"\n                size=\"small\"\n                title={localizedStrings.filterHierarchyLevel}\n                onClick={(e) => {\n                  e.stopPropagation();\n                  onFilterClick(node.id);\n                }}\n              >\n                {node.isFiltered ? <SvgFilter /> : <SvgFilterHollow />}\n              </IconButton>\n            ) : null}\n          </ButtonGroup>\n        </TreeNode>\n      </div>\n    );\n  }\n\n  if (node.type === \"ResultSetTooLarge\") {\n    return (\n      <ResultSetTooLargeNode\n        {...nodeProps}\n        limit={node.resultSetSizeLimit}\n        onOverrideLimit={getHierarchyLevelDetails ? (limit) => getHierarchyLevelDetails(node.parentNodeId)?.setSizeLimit(limit) : undefined}\n        onFilterClick={\n          onFilterClick\n            ? () => {\n                onFilterClick(node.parentNodeId);\n              }\n            : undefined\n        }\n      />\n    );\n  }\n\n  if (node.type === \"NoFilterMatches\") {\n    return <TreeNode {...nodeProps} label={localizedStrings.noFilteredChildren} isDisabled={true} onExpanded={/* istanbul ignore next */ () => {}} />;\n  }\n\n  return <TreeNode {...nodeProps} label={node.message} isDisabled={true} onExpanded={/* istanbul ignore next */ () => {}} />;\n}\n\nfunction PlaceholderNode(props: Omit<TreeNodeProps, \"onExpanded\" | \"label\">) {\n  const { localizedStrings } = useLocalizationContext();\n  return (\n    <TreeNode\n      {...props}\n      label={localizedStrings.loading}\n      icon={<ProgressRadial size=\"x-small\" indeterminate title={localizedStrings.loading} />}\n      onExpanded={/* istanbul ignore next */ () => {}}\n    ></TreeNode>\n  );\n}\n\nfunction ResultSetTooLargeNode({\n  onFilterClick,\n  onOverrideLimit,\n  limit,\n  ...props\n}: Omit<TreeNodeProps, \"onExpanded\" | \"label\"> & ResultSetTooLargeNodeLabelProps) {\n  return (\n    <TreeNode\n      {...props}\n      className=\"stateless-tree-node\"\n      label={<ResultSetTooLargeNodeLabel limit={limit} onFilterClick={onFilterClick} onOverrideLimit={onOverrideLimit} />}\n      onExpanded={/* istanbul ignore next */ () => {}}\n    />\n  );\n}\n\ninterface ResultSetTooLargeNodeLabelProps {\n  limit: number;\n  onFilterClick?: () => void;\n  onOverrideLimit?: (limit: number) => void;\n}\n\nfunction ResultSetTooLargeNodeLabel({ onFilterClick, onOverrideLimit, limit }: ResultSetTooLargeNodeLabelProps) {\n  const { localizedStrings } = useLocalizationContext();\n  const supportsFiltering = !!onFilterClick;\n  const supportsLimitOverride = !!onOverrideLimit && limit < MAX_LIMIT_OVERRIDE;\n\n  const limitExceededMessage = createLocalizedMessage(\n    supportsFiltering ? localizedStrings.resultLimitExceededWithFiltering : localizedStrings.resultLimitExceeded,\n    limit,\n    onFilterClick,\n  );\n  const increaseLimitMessage = supportsLimitOverride\n    ? createLocalizedMessage(\n        supportsFiltering ? localizedStrings.increaseHierarchyLimitWithFiltering : localizedStrings.increaseHierarchyLimit,\n        MAX_LIMIT_OVERRIDE,\n        () => onOverrideLimit(MAX_LIMIT_OVERRIDE),\n      )\n    : { title: \"\", element: null };\n\n  const title = `${limitExceededMessage.title} ${increaseLimitMessage.title}`;\n\n  return (\n    <Flex flexDirection=\"column\" gap=\"3xs\" title={title} alignItems=\"start\">\n      {limitExceededMessage.element}\n      {increaseLimitMessage.element}\n    </Flex>\n  );\n}\n\nfunction createLocalizedMessage(message: string, limit: number, onClick?: () => void) {\n  const limitStr = limit.toLocaleString(undefined, { useGrouping: true });\n  const messageWithLimit = message.replace(\"{{limit}}\", limitStr);\n  const exp = new RegExp(\"<link>(.*)</link>\");\n  const match = messageWithLimit.match(exp);\n\n  if (!match) {\n    return {\n      title: messageWithLimit,\n      element: (\n        <Flex flexDirection=\"row\" gap=\"3xs\">\n          <Text>{messageWithLimit}</Text>\n        </Flex>\n      ),\n    };\n  }\n\n  const [fullText, innerText] = match;\n  const [textBefore, textAfter] = messageWithLimit.split(fullText);\n\n  return {\n    title: messageWithLimit.replace(fullText, innerText),\n    element: (\n      <Flex flexDirection=\"row\" gap=\"3xs\">\n        {textBefore ? <Text>{textBefore}</Text> : null}\n        <Anchor\n          underline\n          onClick={(e) => {\n            e.stopPropagation();\n            onClick?.();\n          }}\n        >\n          {innerText}\n        </Anchor>\n        {textAfter ? <Text>{textAfter}</Text> : null}\n      </Flex>\n    ),\n  };\n}\n"]}

package/lib/esm/presentation-hierarchies-react/itwinui/TreeRenderer.d.ts

@@ -0,0 +1,55 @@
+import { ComponentPropsWithoutRef } from "react";
+import { NodeData, Tree } from "@itwin/itwinui-react";
+import { PresentationTreeNode } from "../TreeNode";
+import { SelectionMode } from "../UseSelectionHandler";
+import { useTree } from "../UseTree";
+import { LocalizedStrings } from "./LocalizationContext";
+import { TreeNodeRenderer } from "./TreeNodeRenderer";
+type TreeProps = ComponentPropsWithoutRef<typeof Tree<RenderedTreeNode>>;
+type TreeNodeRendererProps = ComponentPropsWithoutRef<typeof TreeNodeRenderer>;
+interface TreeRendererOwnProps {
+    rootNodes: PresentationTreeNode[];
+    selectionMode?: SelectionMode;
+    localizedStrings?: Partial<LocalizedStrings>;
+}
+type TreeRendererProps = Pick<ReturnType<typeof useTree>, "rootNodes" | "expandNode"> & Partial<Pick<ReturnType<typeof useTree>, "selectNodes" | "isNodeSelected" | "getHierarchyLevelDetails">> & Pick<TreeNodeRendererProps, "onFilterClick" | "getIcon" | "getSublabel"> & TreeRendererOwnProps & Omit<TreeProps, "data" | "nodeRenderer" | "getNode" | "enableVirtualization">;
+/**
+ * A component that renders a tree using the `Tree` component from `@itwin/itwinui-react`. The tree nodes
+ * are rendered using `TreeNodeRenderer` component from this package.
+ *
+ * @see https://itwinui.bentley.com/docs/tree
+ * @beta
+ */
+export declare function TreeRenderer({ rootNodes, expandNode, selectNodes, isNodeSelected, onFilterClick, getIcon, getSublabel, getHierarchyLevelDetails, selectionMode, localizedStrings, ...treeProps }: TreeRendererProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * A data structure for a tree node that is rendered using the `TreeRenderer` component.
+ *
+ * In addition to the `PresentationTreeNode` union, this type may have one additional variation - an informational
+ * type of node with `ChildrenPlaceholder` type. This type of node is returned as the single child node of a parent
+ * while its children are being loaded. This allows the node renderer to show a placeholder under the parent during
+ * the process.
+ *
+ * @beta
+ */
+export type RenderedTreeNode = PresentationTreeNode | {
+    id: string;
+    parentNodeId: string | undefined;
+    type: "ChildrenPlaceholder";
+};
+/**
+ * An utility function that creates an `@itwin/itwinui-react` `NodeData` object for the `Tree` component from a
+ * `RenderedTreeNode` object.
+ *
+ * Usage example:
+ * ```tsx
+ * function MyComponent({ rootNodes, nodeRenderer }: MyComponentProps) {
+ *   const getNode = useCallback<TreeProps["getNode"]>((node) => createRenderedTreeNodeData(node, () => false), []);
+ *   return <Tree<RenderedTreeNode> data={rootNodes} getNode={getNode} nodeRenderer={nodeRenderer} />;
+ * }
+ * ```
+ *
+ * @beta
+ */
+export declare function createRenderedTreeNodeData(node: RenderedTreeNode, isNodeSelected: (nodeId: string) => boolean): NodeData<RenderedTreeNode>;
+export {};
+//# sourceMappingURL=TreeRenderer.d.ts.map

package/lib/esm/presentation-hierarchies-react/itwinui/TreeRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeRenderer.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/itwinui/TreeRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAe,MAAM,OAAO,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAuB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAA+B,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,KAAK,SAAS,GAAG,wBAAwB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACzE,KAAK,qBAAqB,GAAG,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/E,UAAU,oBAAoB;IAC5B,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED,KAAK,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC,GACnF,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,EAAE,aAAa,GAAG,gBAAgB,GAAG,0BAA0B,CAAC,CAAC,GACxG,IAAI,CAAC,qBAAqB,EAAE,eAAe,GAAG,SAAS,GAAG,aAAa,CAAC,GACxE,oBAAoB,GACpB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,sBAAsB,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,OAAO,EACP,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,GAAG,SAAS,EACb,EAAE,iBAAiB,2CA+BnB;AAOD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB;IACE,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,qBAAqB,CAAC;CAC7B,CAAC;AAEN;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CA6B1I"}

package/lib/esm/presentation-hierarchies-react/itwinui/TreeRenderer.js

@@ -0,0 +1,78 @@
+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 } from "react";
+import { Tree } from "@itwin/itwinui-react";
+import { useSelectionHandler } from "../UseSelectionHandler";
+import { LocalizationContextProvider } from "./LocalizationContext";
+import { TreeNodeRenderer } from "./TreeNodeRenderer";
+/**
+ * A component that renders a tree using the `Tree` component from `@itwin/itwinui-react`. The tree nodes
+ * are rendered using `TreeNodeRenderer` component from this package.
+ *
+ * @see https://itwinui.bentley.com/docs/tree
+ * @beta
+ */
+export function TreeRenderer({ rootNodes, expandNode, selectNodes, isNodeSelected, onFilterClick, getIcon, getSublabel, getHierarchyLevelDetails, selectionMode, localizedStrings, ...treeProps }) {
+    const { onNodeClick, onNodeKeyDown } = useSelectionHandler({
+        rootNodes,
+        selectNodes: selectNodes ?? noopSelectNodes,
+        selectionMode: selectionMode ?? "single",
+    });
+    const nodeRenderer = useCallback((nodeProps) => {
+        return (_jsx(TreeNodeRenderer, { ...nodeProps, expandNode: expandNode, getHierarchyLevelDetails: getHierarchyLevelDetails, onFilterClick: onFilterClick, onNodeClick: onNodeClick, onNodeKeyDown: onNodeKeyDown, getIcon: getIcon, getSublabel: getSublabel }));
+    }, [expandNode, getHierarchyLevelDetails, onFilterClick, onNodeClick, onNodeKeyDown, getIcon, getSublabel]);
+    const getNode = useCallback((node) => createRenderedTreeNodeData(node, isNodeSelected ?? noopIsNodeSelected), [isNodeSelected]);
+    return (_jsx(LocalizationContextProvider, { localizedStrings: localizedStrings, children: _jsx(Tree, { ...treeProps, data: rootNodes, nodeRenderer: nodeRenderer, getNode: getNode, enableVirtualization: true }) }));
+}
+function noopSelectNodes() { }
+function noopIsNodeSelected() {
+    return false;
+}
+/**
+ * An utility function that creates an `@itwin/itwinui-react` `NodeData` object for the `Tree` component from a
+ * `RenderedTreeNode` object.
+ *
+ * Usage example:
+ * ```tsx
+ * function MyComponent({ rootNodes, nodeRenderer }: MyComponentProps) {
+ *   const getNode = useCallback<TreeProps["getNode"]>((node) => createRenderedTreeNodeData(node, () => false), []);
+ *   return <Tree<RenderedTreeNode> data={rootNodes} getNode={getNode} nodeRenderer={nodeRenderer} />;
+ * }
+ * ```
+ *
+ * @beta
+ */
+export function createRenderedTreeNodeData(node, isNodeSelected) {
+    if ("type" in node) {
+        return {
+            nodeId: node.id,
+            node,
+            hasSubNodes: false,
+            isExpanded: false,
+            isSelected: false,
+            isDisabled: true,
+        };
+    }
+    return {
+        nodeId: node.id,
+        node,
+        hasSubNodes: node.children === true || node.children.length > 0,
+        subNodes: 
+        // returns placeholder node to show as child while children is loading.
+        node.children === true
+            ? [
+                {
+                    id: `Loading-${node.id}`,
+                    parentNodeId: node.id,
+                    type: "ChildrenPlaceholder",
+                },
+            ]
+            : node.children,
+        isExpanded: node.isExpanded,
+        isSelected: isNodeSelected(node.id),
+    };
+}
+//# sourceMappingURL=TreeRenderer.js.map