@itwin/presentation-hierarchies-react 2.0.0-alpha.5 → 2.0.0-alpha.51

package/lib/esm/presentation-hierarchies-react/stratakit/ErrorItemRenderer.js

@@ -0,0 +1,74 @@
+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 { Anchor, Text } from "@stratakit/bricks";
+import { unstable_ErrorRegion as ErrorRegion } from "@stratakit/structures";
+import { MAX_LIMIT_OVERRIDE } from "../internal/Utils.js";
+import { useLocalizationContext } from "./LocalizationContext.js";
+/**
+ * Renders StrataKit `<ErrorRegion.Item />` for all supported error types:
+ * - `ResultSetTooLarge` - renders `LocalizedStrings.resultLimitExceeded` message with actions to increase limit or apply filtering
+ * - `NoFilterMatches` - renders `LocalizedStrings.noFilteredChildren` message with action to change filter
+ * - `ChildrenLoad` - renders `LocalizedStrings.failedToCreateHierarchy` message with action to retry loading
+ * - `Unknown` - renders message set on error object.
+ *
+ * @alpha
+ */
+export function ErrorItemRenderer({ errorNode, getHierarchyLevelDetails, filterHierarchyLevel, reloadTree, scrollToNode }) {
+    const { localizedStrings } = useLocalizationContext();
+    if (errorNode.error.type === "ResultSetTooLarge") {
+        const limit = errorNode.error.resultSetSizeLimit;
+        const onOverrideLimit = getHierarchyLevelDetails ? () => getHierarchyLevelDetails(errorNode.id)?.setSizeLimit(MAX_LIMIT_OVERRIDE) : undefined;
+        return (_jsx(ErrorItemContainer, { errorNode: errorNode, actions: [
+                {
+                    action: () => {
+                        onOverrideLimit?.();
+                    },
+                    label: localizedStrings.increaseHierarchyLimit.replace("{{limit}}", MAX_LIMIT_OVERRIDE.toString()),
+                    condition: () => !!onOverrideLimit && limit < MAX_LIMIT_OVERRIDE,
+                },
+                {
+                    action: () => {
+                        const hierarchyLevelDetails = getHierarchyLevelDetails?.(errorNode.id);
+                        hierarchyLevelDetails && filterHierarchyLevel?.(hierarchyLevelDetails);
+                    },
+                    label: localizedStrings.increaseHierarchyLimitWithFiltering,
+                    condition: () => !!filterHierarchyLevel && !!errorNode?.isFilterable,
+                },
+            ], message: localizedStrings.resultLimitExceeded.replace("{{limit}}", limit.toString()), scrollToElement: () => scrollToNode(errorNode) }));
+    }
+    if (errorNode.error.type === "NoFilterMatches") {
+        return (_jsx(ErrorItemContainer, { errorNode: errorNode, actions: [
+                {
+                    action: () => {
+                        const hierarchyLevelDetails = getHierarchyLevelDetails?.(errorNode.id);
+                        hierarchyLevelDetails && filterHierarchyLevel?.(hierarchyLevelDetails);
+                    },
+                    label: localizedStrings.noFilteredChildrenChangeFilter,
+                    condition: () => true,
+                },
+            ], message: localizedStrings.noFilteredChildren, scrollToElement: () => scrollToNode(errorNode) }));
+    }
+    if (errorNode.error.type === "ChildrenLoad") {
+        return (_jsx(ErrorItemContainer, { errorNode: errorNode, actions: [
+                {
+                    action: () => reloadTree({ parentNodeId: errorNode.id }),
+                    label: localizedStrings.retry,
+                    condition: () => true,
+                },
+            ], message: localizedStrings.failedToCreateHierarchy, scrollToElement: () => scrollToNode(errorNode) }));
+    }
+    return _jsx(ErrorItemContainer, { errorNode: errorNode, message: errorNode.error.message, scrollToElement: () => scrollToNode(errorNode) });
+}
+function ErrorItemContainer({ errorNode, message, actions, scrollToElement }) {
+    return (_jsx(ErrorRegion.Item, { message: _jsx(MessageWithLink, { linkLabel: errorNode.label, scrollToElement: scrollToElement, message: message }), messageId: errorNode.id, actions: actions
+            ?.filter(({ condition }) => condition())
+            .map(({ label, action }) => (_jsx(Text, { variant: "body-sm", children: _jsx(Anchor, { onClick: action, render: _jsx("button", {}), children: label }) }, label))) }));
+}
+function MessageWithLink({ linkLabel, scrollToElement, message }) {
+    const splitMessage = message.split("{{node}}", 2);
+    return (_jsxs("div", { style: { display: "flex", whiteSpace: "pre", flexWrap: "wrap" }, children: [splitMessage[0], _jsx(Anchor, { onClick: scrollToElement, render: _jsx("button", {}), children: linkLabel }), splitMessage[1] ? splitMessage[1] : null] }));
+}
+//# sourceMappingURL=ErrorItemRenderer.js.map

package/lib/esm/presentation-hierarchies-react/stratakit/ErrorItemRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorItemRenderer.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/ErrorItemRenderer.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 { Anchor, Text } from \"@stratakit/bricks\";\nimport { unstable_ErrorRegion as ErrorRegion } from \"@stratakit/structures\";\nimport { MAX_LIMIT_OVERRIDE } from \"../internal/Utils.js\";\nimport { HierarchyLevelDetails, TreeRendererProps } from \"../Renderers.js\";\nimport { TreeNode } from \"../TreeNode.js\";\nimport { useErrorNodes } from \"./FlatTreeNode.js\";\nimport { useLocalizationContext } from \"./LocalizationContext.js\";\n\n/** @alpha */\nexport interface ErrorItemRendererProps extends Pick<TreeRendererProps, \"getHierarchyLevelDetails\"> {\n  /** A node containing an error. */\n  errorNode: ReturnType<typeof useErrorNodes>[number];\n  /** A callback to reload a hierarchy level when an error occurs and `retry` button is clicked. */\n  reloadTree: (options: { parentNodeId: string | undefined }) => void;\n  /** A callback to scroll to the node associated with the error. */\n  scrollToNode: (errorNode: TreeNode) => void;\n  /** A callback to initiate filtering of the given hierarchy level. */\n  filterHierarchyLevel?: (hierarchyLevelDetails: HierarchyLevelDetails) => void;\n}\n\n/**\n * Renders StrataKit `<ErrorRegion.Item />` for all supported error types:\n * - `ResultSetTooLarge` - renders `LocalizedStrings.resultLimitExceeded` message with actions to increase limit or apply filtering\n * - `NoFilterMatches` - renders `LocalizedStrings.noFilteredChildren` message with action to change filter\n * - `ChildrenLoad` - renders `LocalizedStrings.failedToCreateHierarchy` message with action to retry loading\n * - `Unknown` - renders message set on error object.\n *\n * @alpha\n */\nexport function ErrorItemRenderer({ errorNode, getHierarchyLevelDetails, filterHierarchyLevel, reloadTree, scrollToNode }: ErrorItemRendererProps) {\n  const { localizedStrings } = useLocalizationContext();\n\n  if (errorNode.error.type === \"ResultSetTooLarge\") {\n    const limit = errorNode.error.resultSetSizeLimit;\n    const onOverrideLimit = getHierarchyLevelDetails ? () => getHierarchyLevelDetails(errorNode.id)?.setSizeLimit(MAX_LIMIT_OVERRIDE) : undefined;\n    return (\n      <ErrorItemContainer\n        errorNode={errorNode}\n        actions={[\n          {\n            action: () => {\n              onOverrideLimit?.();\n            },\n            label: localizedStrings.increaseHierarchyLimit.replace(\"{{limit}}\", MAX_LIMIT_OVERRIDE.toString()),\n            condition: () => !!onOverrideLimit && limit < MAX_LIMIT_OVERRIDE,\n          },\n          {\n            action: () => {\n              const hierarchyLevelDetails = getHierarchyLevelDetails?.(errorNode.id);\n              hierarchyLevelDetails && filterHierarchyLevel?.(hierarchyLevelDetails);\n            },\n            label: localizedStrings.increaseHierarchyLimitWithFiltering,\n            condition: () => !!filterHierarchyLevel && !!errorNode?.isFilterable,\n          },\n        ]}\n        message={localizedStrings.resultLimitExceeded.replace(\"{{limit}}\", limit.toString())}\n        scrollToElement={() => scrollToNode(errorNode)}\n      />\n    );\n  }\n  if (errorNode.error.type === \"NoFilterMatches\") {\n    return (\n      <ErrorItemContainer\n        errorNode={errorNode}\n        actions={[\n          {\n            action: () => {\n              const hierarchyLevelDetails = getHierarchyLevelDetails?.(errorNode.id);\n              hierarchyLevelDetails && filterHierarchyLevel?.(hierarchyLevelDetails);\n            },\n            label: localizedStrings.noFilteredChildrenChangeFilter,\n            condition: () => true,\n          },\n        ]}\n        message={localizedStrings.noFilteredChildren}\n        scrollToElement={() => scrollToNode(errorNode)}\n      />\n    );\n  }\n  if (errorNode.error.type === \"ChildrenLoad\") {\n    return (\n      <ErrorItemContainer\n        errorNode={errorNode}\n        actions={[\n          {\n            action: () => reloadTree({ parentNodeId: errorNode.id }),\n            label: localizedStrings.retry,\n            condition: () => true,\n          },\n        ]}\n        message={localizedStrings.failedToCreateHierarchy}\n        scrollToElement={() => scrollToNode(errorNode)}\n      />\n    );\n  }\n\n  return <ErrorItemContainer errorNode={errorNode} message={errorNode.error.message} scrollToElement={() => scrollToNode(errorNode)} />;\n}\n\ntype ErrorItemContainerProps = {\n  errorNode: TreeNode;\n  message: string;\n  actions?: { action: () => void; label: string; condition: () => boolean }[];\n} & Pick<MessageWithLinkProps, \"scrollToElement\">;\n\nfunction ErrorItemContainer({ errorNode, message, actions, scrollToElement }: ErrorItemContainerProps) {\n  return (\n    <ErrorRegion.Item\n      message={<MessageWithLink linkLabel={errorNode.label} scrollToElement={scrollToElement} message={message} />}\n      messageId={errorNode.id}\n      actions={actions\n        ?.filter(({ condition }) => condition())\n        .map(({ label, action }) => (\n          <Text key={label} variant=\"body-sm\">\n            <Anchor onClick={action} render={<button />}>\n              {label}\n            </Anchor>\n          </Text>\n        ))}\n    />\n  );\n}\n\ninterface MessageWithLinkProps {\n  scrollToElement: () => void;\n  message: string;\n  linkLabel?: string;\n}\n\nfunction MessageWithLink({ linkLabel, scrollToElement, message }: MessageWithLinkProps) {\n  const splitMessage = message.split(\"{{node}}\", 2);\n  return (\n    <div style={{ display: \"flex\", whiteSpace: \"pre\", flexWrap: \"wrap\" }}>\n      {splitMessage[0]}\n      <Anchor onClick={scrollToElement} render={<button />}>\n        {linkLabel}\n      </Anchor>\n      {splitMessage[1] ? splitMessage[1] : null}\n    </div>\n  );\n}\n"]}

package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.d.ts

@@ -0,0 +1,48 @@
+import { TreeNode } from "../TreeNode.js";
+/**
+ * Placeholder item that is added to hierarchy as a child for a parent item while its child items are loading.
+ *
+ * @alpha
+ */
+interface FlatPlaceholderItem {
+    id: string;
+    level: number;
+    placeholder: true;
+}
+/**
+ * An item containing `TreeNode` node with properties needed for a flat tree structure.
+ *
+ * @alpha
+ */
+export interface FlatTreeNodeItem {
+    id: string;
+    level: number;
+    levelSize: number;
+    posInLevel: number;
+    node: TreeNode;
+}
+/**
+ * An Item describing single tree item position and its content inside tree.
+ * Returned by `useFlatTreeNodeList` hook.
+ *
+ *  @alpha
+ */
+export type FlatTreeItem = FlatTreeNodeItem | FlatPlaceholderItem;
+/** @alpha */
+export declare function isPlaceholderItem(item: FlatTreeItem): item is FlatPlaceholderItem;
+/**
+ * Used to get a list of `FlatTreeItem` objects for the given list of `TreeNode` objects that represent
+ * a hierarchical structure. The resulting items can be used to render the hierarchy in a flat manner, e.g. using a
+ * virtualized list.
+ *
+ * @alpha
+ */
+export declare function useFlatTreeItems(rootNodes: TreeNode[]): FlatTreeItem[];
+/**
+ * Finds and returns all nodes containing errors in a given hierarchy.
+ *
+ * @alpha
+ */
+export declare function useErrorNodes(rootNodes: TreeNode[]): Array<TreeNode & Pick<Required<TreeNode>, "error">>;
+export {};
+//# sourceMappingURL=FlatTreeNode.d.ts.map

package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatTreeNode.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/FlatTreeNode.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;;;GAIG;AACH,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAElE,aAAa;AACb,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,IAAI,mBAAmB,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,kBAErD;AAoBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAcxG"}

package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.js

@@ -0,0 +1,73 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { useMemo } from "react";
+/** @alpha */
+export function isPlaceholderItem(item) {
+    return "placeholder" in item;
+}
+/**
+ * Used to get a list of `FlatTreeItem` objects for the given list of `TreeNode` objects that represent
+ * a hierarchical structure. The resulting items can be used to render the hierarchy in a flat manner, e.g. using a
+ * virtualized list.
+ *
+ * @alpha
+ */
+export function useFlatTreeItems(rootNodes) {
+    return useMemo(() => getFlatItems(rootNodes, 1), [rootNodes]);
+}
+function getFlatItems(nodes, level) {
+    const flatItems = [];
+    nodes.forEach((node, index) => {
+        flatItems.push({ node, id: node.id, level, levelSize: nodes.length, posInLevel: index + 1 });
+        if (!node.isExpanded || node.error) {
+            return;
+        }
+        if (node.children !== true) {
+            const childNodes = getFlatItems(node.children, level + 1);
+            flatItems.push(...childNodes);
+            return;
+        }
+        flatItems.push({ id: `${node.id}-children-placeholder`, level: level + 1, placeholder: true });
+    });
+    return flatItems;
+}
+/**
+ * Finds and returns all nodes containing errors in a given hierarchy.
+ *
+ * @alpha
+ */
+export function useErrorNodes(rootNodes) {
+    return useMemo(() => rootNodes.flatMap((rootNode) => {
+        if (isErrorNode(rootNode)) {
+            return [rootNode];
+        }
+        if (rootNode.children === true) {
+            return [];
+        }
+        return getErrorNodes(rootNode);
+    }), [rootNodes]);
+}
+function getErrorNodes(parent) {
+    const errorList = [];
+    if (parent.children === true) {
+        return [];
+    }
+    parent.children.forEach((node) => {
+        if (isErrorNode(node)) {
+            errorList.push(node);
+            return;
+        }
+        if (node.children !== true) {
+            const childErrorList = getErrorNodes(node);
+            errorList.push(...childErrorList);
+            return;
+        }
+    });
+    return errorList;
+}
+function isErrorNode(node) {
+    return node.error !== undefined;
+}
+//# sourceMappingURL=FlatTreeNode.js.map

package/lib/esm/presentation-hierarchies-react/stratakit/FlatTreeNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatTreeNode.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/FlatTreeNode.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAmChC,aAAa;AACb,MAAM,UAAU,iBAAiB,CAAC,IAAkB;IAClD,OAAO,aAAa,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAqB;IACpD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB,EAAE,KAAa;IACpD,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC1D,SAAS,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,uBAAuB,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAgC,CAAC,CAAC;IAC/H,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAqB;IACjD,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7B,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC,CAAC,EACJ,CAAC,SAAS,CAAC,CACZ,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAgB;IACrC,MAAM,SAAS,GAAqC,EAAE,CAAC;IAEvD,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAC3C,SAAS,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,IAAc;IACjC,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;AAClC,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 { useMemo } from \"react\";\nimport { TreeNode } from \"../TreeNode.js\";\n\n/**\n * Placeholder item that is added to hierarchy as a child for a parent item while its child items are loading.\n *\n * @alpha\n */\ninterface FlatPlaceholderItem {\n  id: string;\n  level: number;\n  placeholder: true;\n}\n\n/**\n * An item containing `TreeNode` node with properties needed for a flat tree structure.\n *\n * @alpha\n */\nexport interface FlatTreeNodeItem {\n  id: string;\n  level: number;\n  levelSize: number;\n  posInLevel: number;\n  node: TreeNode;\n}\n\n/**\n * An Item describing single tree item position and its content inside tree.\n * Returned by `useFlatTreeNodeList` hook.\n *\n *  @alpha\n */\nexport type FlatTreeItem = FlatTreeNodeItem | FlatPlaceholderItem;\n\n/** @alpha */\nexport function isPlaceholderItem(item: FlatTreeItem): item is FlatPlaceholderItem {\n  return \"placeholder\" in item;\n}\n\n/**\n * Used to get a list of `FlatTreeItem` objects for the given list of `TreeNode` objects that represent\n * a hierarchical structure. The resulting items can be used to render the hierarchy in a flat manner, e.g. using a\n * virtualized list.\n *\n * @alpha\n */\nexport function useFlatTreeItems(rootNodes: TreeNode[]) {\n  return useMemo(() => getFlatItems(rootNodes, 1), [rootNodes]);\n}\n\nfunction getFlatItems(nodes: TreeNode[], level: number) {\n  const flatItems: FlatTreeItem[] = [];\n  nodes.forEach((node, index) => {\n    flatItems.push({ node, id: node.id, level, levelSize: nodes.length, posInLevel: index + 1 });\n    if (!node.isExpanded || node.error) {\n      return;\n    }\n    if (node.children !== true) {\n      const childNodes = getFlatItems(node.children, level + 1);\n      flatItems.push(...childNodes);\n      return;\n    }\n\n    flatItems.push({ id: `${node.id}-children-placeholder`, level: level + 1, placeholder: true } satisfies FlatPlaceholderItem);\n  });\n  return flatItems;\n}\n\n/**\n * Finds and returns all nodes containing errors in a given hierarchy.\n *\n * @alpha\n */\nexport function useErrorNodes(rootNodes: TreeNode[]): Array<TreeNode & Pick<Required<TreeNode>, \"error\">> {\n  return useMemo(\n    () =>\n      rootNodes.flatMap((rootNode) => {\n        if (isErrorNode(rootNode)) {\n          return [rootNode];\n        }\n        if (rootNode.children === true) {\n          return [];\n        }\n        return getErrorNodes(rootNode);\n      }),\n    [rootNodes],\n  );\n}\n\nfunction getErrorNodes(parent: TreeNode) {\n  const errorList: ReturnType<typeof useErrorNodes> = [];\n\n  if (parent.children === true) {\n    return [];\n  }\n\n  parent.children.forEach((node) => {\n    if (isErrorNode(node)) {\n      errorList.push(node);\n      return;\n    }\n\n    if (node.children !== true) {\n      const childErrorList = getErrorNodes(node);\n      errorList.push(...childErrorList);\n      return;\n    }\n  });\n  return errorList;\n}\n\nfunction isErrorNode(node: TreeNode): node is TreeNode & Pick<Required<TreeNode>, \"error\"> {\n  return node.error !== undefined;\n}\n"]}

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

@@ -0,0 +1,133 @@
+import { PropsWithChildren } from "react";
+/**
+ * Localized strings used in the components.
+ * @public
+ */
+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;
+    /**
+     * Accessible description for applied hierarchy filter button.
+     * Default value: `Filter is applied`.
+     */
+    filterHierarchyLevelActiveDescription: 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 matches for current filter for {{node}}.`.
+     */
+    noFilteredChildren: string;
+    /**
+     * Label for change filter action.
+     * Default value: `Change filter`.
+     */
+    noFilteredChildrenChangeFilter: string;
+    /**
+     * Message displayed when hierarchy creation for a node failed.
+     * Default value: `Failed to create hierarchy for {{node}}.`.
+     */
+    failedToCreateHierarchy: string;
+    /**
+     * Message displayed when hierarchy creation for a node failed.
+     * Default value: `Failed to load tree.`.
+     */
+    failedToCreateRootHierarchy: string;
+    /**
+     * Message displayed when result limit exceeds hierarchy size limit.
+     * Default value: `The hierarchy for {{node}} contains {{limit}}+ items. Try using filters or increase the limit.`.
+     */
+    resultLimitExceeded: string;
+    /**
+     * Message displayed when result limit exceeds hierarchy size limit.
+     * Default value: `The root item hierarchy contains {{limit}}+ items. Try increasing the limit.`.
+     */
+    rootResultLimitExceeded: string;
+    /**
+     * Name for the error region landmark.
+     * Default value: `Issues for {{tree_label}}.`.
+     */
+    issuesForTree: string;
+    /**
+     * Label displayed on the error region, when errors are detected.
+     * Default value: `{{number_of_issues}} issue(s) found.`.
+     */
+    issuesFound: string;
+    /**
+     * Label displayed on the error region, when no issues are found.
+     * Default value: `No issues found.`.
+     */
+    noIssuesFound: string;
+    /**
+     * Message displayed when hierarchy size limit can be overridden.
+     * Default value: `Increase limit to {{limit}}`.
+     */
+    increaseHierarchyLimit: string;
+    /**
+     * Message displayed when hierarchy size limit can be overridden.
+     * Default value: `Remove limit`.
+     */
+    increaseHierarchyLimitToUnlimited: string;
+    /**
+     * Message displayed when hierarchy size limit can be overridden and hierarchy filtering is enabled.
+     * Default value: `Add Filter`.
+     */
+    increaseHierarchyLimitWithFiltering: string;
+    /**
+     * Label for retry action.
+     * Default value: `Retry`.
+     */
+    retry: string;
+    /**
+     * Label for rename action.
+     * Default value: `Rename`.
+     */
+    rename: string;
+    /**
+     * Label for more actions button.
+     * Default value: `More`.
+     */
+    more: string;
+    /**
+     * Label for confirm button.
+     * Default value: `Confirm`.
+     */
+    confirm: string;
+    /**
+     * Label for cancel button.
+     * Default value: `Cancel`.
+     */
+    cancel: string;
+}
+/** @internal */
+export interface LocalizationContext {
+    localizedStrings: LocalizedStrings;
+}
+/**
+ * Properties for `LocalizationContextProvider`.
+ * @public
+ */
+interface LocalizationContextProviderProps {
+    /** Localized strings used in the components. */
+    localizedStrings?: Partial<LocalizedStrings>;
+}
+/**
+ * Context provider for localized strings used in the components.
+ * @public
+ */
+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/stratakit/LocalizationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationContext.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/LocalizationContext.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAiB,iBAAiB,EAAmC,MAAM,OAAO,CAAC;AAE1F;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,qCAAqC,EAAE,MAAM,CAAC;IAC9C;;;OAGG;IACH,yBAAyB,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,8BAA8B,EAAE,MAAM,CAAC;IACvC;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,2BAA2B,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,iCAAiC,EAAE,MAAM,CAAC;IAC1C;;;OAGG;IACH,mCAAmC,EAAE,MAAM,CAAC;IAC5C;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AA4BD;;;GAGG;AACH,UAAU,gCAAgC;IACxC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,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 → stratakit}/LocalizationContext.js

@@ -7,13 +7,25 @@ import { createContext, useContext, useEffect, useState } from "react";
 const defaultLocalizedStrings = {
     loading: "Loading...",
     filterHierarchyLevel: "Apply filter",
+    filterHierarchyLevelActiveDescription: "Filter is applied",
     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>",
+    noFilteredChildren: "No matches for current filter for {{node}}.",
+    noFilteredChildrenChangeFilter: "Change filter",
+    failedToCreateHierarchy: "Failed to create hierarchy for {{node}}.",
+    failedToCreateRootHierarchy: "Failed to load tree.",
+    resultLimitExceeded: "The hierarchy for {{node}} contains {{limit}}+ items. Try using filters or increase the limit.",
+    rootResultLimitExceeded: "The root item hierarchy contains {{limit}}+ items. Try increasing the limit.",
+    issuesForTree: "Issues for {{tree_label}}.",
+    issuesFound: "{{number_of_issues}} issue(s) found.",
+    noIssuesFound: "No issues found.",
+    increaseHierarchyLimit: "Increase limit to {{limit}}",
+    increaseHierarchyLimitToUnlimited: "Remove limit",
+    increaseHierarchyLimitWithFiltering: "Add Filter",
     retry: "Retry",
+    rename: "Rename",
+    more: "More",
+    confirm: "Confirm",
+    cancel: "Cancel",
 };
 const localizationContext = createContext({ localizedStrings: defaultLocalizedStrings });
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationContext.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/LocalizationContext.tsx"],"names":[],"mappings":";AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,aAAa,EAAqB,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAuH1F,MAAM,uBAAuB,GAAqB;IAChD,OAAO,EAAE,YAAY;IACrB,oBAAoB,EAAE,cAAc;IACpC,qCAAqC,EAAE,mBAAmB;IAC1D,yBAAyB,EAAE,qBAAqB;IAChD,kBAAkB,EAAE,6CAA6C;IACjE,8BAA8B,EAAE,eAAe;IAC/C,uBAAuB,EAAE,0CAA0C;IACnE,2BAA2B,EAAE,sBAAsB;IACnD,mBAAmB,EAAE,gGAAgG;IACrH,uBAAuB,EAAE,8EAA8E;IACvG,aAAa,EAAE,4BAA4B;IAC3C,WAAW,EAAE,sCAAsC;IACnD,aAAa,EAAE,kBAAkB;IACjC,sBAAsB,EAAE,6BAA6B;IACrD,iCAAiC,EAAE,cAAc;IACjD,mCAAmC,EAAE,YAAY;IACjD,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,MAAM,mBAAmB,GAAG,aAAa,CAAsB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC,CAAC;AAW9G;;;GAGG;AACH,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/**\n * Localized strings used in the components.\n * @public\n */\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   * Accessible description for applied hierarchy filter button.\n   * Default value: `Filter is applied`.\n   */\n  filterHierarchyLevelActiveDescription: 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 matches for current filter for {{node}}.`.\n   */\n  noFilteredChildren: string;\n  /**\n   * Label for change filter action.\n   * Default value: `Change filter`.\n   */\n  noFilteredChildrenChangeFilter: string;\n  /**\n   * Message displayed when hierarchy creation for a node failed.\n   * Default value: `Failed to create hierarchy for {{node}}.`.\n   */\n  failedToCreateHierarchy: string;\n  /**\n   * Message displayed when hierarchy creation for a node failed.\n   * Default value: `Failed to load tree.`.\n   */\n  failedToCreateRootHierarchy: string;\n  /**\n   * Message displayed when result limit exceeds hierarchy size limit.\n   * Default value: `The hierarchy for {{node}} contains {{limit}}+ items. Try using filters or increase the limit.`.\n   */\n  resultLimitExceeded: string;\n  /**\n   * Message displayed when result limit exceeds hierarchy size limit.\n   * Default value: `The root item hierarchy contains {{limit}}+ items. Try increasing the limit.`.\n   */\n  rootResultLimitExceeded: string;\n  /**\n   * Name for the error region landmark.\n   * Default value: `Issues for {{tree_label}}.`.\n   */\n  issuesForTree: string;\n  /**\n   * Label displayed on the error region, when errors are detected.\n   * Default value: `{{number_of_issues}} issue(s) found.`.\n   */\n  issuesFound: string;\n  /**\n   * Label displayed on the error region, when no issues are found.\n   * Default value: `No issues found.`.\n   */\n  noIssuesFound: string;\n  /**\n   * Message displayed when hierarchy size limit can be overridden.\n   * Default value: `Increase limit to {{limit}}`.\n   */\n  increaseHierarchyLimit: string;\n  /**\n   * Message displayed when hierarchy size limit can be overridden.\n   * Default value: `Remove limit`.\n   */\n  increaseHierarchyLimitToUnlimited: string;\n  /**\n   * Message displayed when hierarchy size limit can be overridden and hierarchy filtering is enabled.\n   * Default value: `Add Filter`.\n   */\n  increaseHierarchyLimitWithFiltering: string;\n  /**\n   * Label for retry action.\n   * Default value: `Retry`.\n   */\n  retry: string;\n  /**\n   * Label for rename action.\n   * Default value: `Rename`.\n   */\n  rename: string;\n  /**\n   * Label for more actions button.\n   * Default value: `More`.\n   */\n  more: string;\n  /**\n   * Label for confirm button.\n   * Default value: `Confirm`.\n   */\n  confirm: string;\n  /**\n   * Label for cancel button.\n   * Default value: `Cancel`.\n   */\n  cancel: string;\n}\n\n/** @internal */\nexport interface LocalizationContext {\n  localizedStrings: LocalizedStrings;\n}\n\nconst defaultLocalizedStrings: LocalizedStrings = {\n  loading: \"Loading...\",\n  filterHierarchyLevel: \"Apply filter\",\n  filterHierarchyLevelActiveDescription: \"Filter is applied\",\n  clearHierarchyLevelFilter: \"Clear active filter\",\n  noFilteredChildren: \"No matches for current filter for {{node}}.\",\n  noFilteredChildrenChangeFilter: \"Change filter\",\n  failedToCreateHierarchy: \"Failed to create hierarchy for {{node}}.\",\n  failedToCreateRootHierarchy: \"Failed to load tree.\",\n  resultLimitExceeded: \"The hierarchy for {{node}} contains {{limit}}+ items. Try using filters or increase the limit.\",\n  rootResultLimitExceeded: \"The root item hierarchy contains {{limit}}+ items. Try increasing the limit.\",\n  issuesForTree: \"Issues for {{tree_label}}.\",\n  issuesFound: \"{{number_of_issues}} issue(s) found.\",\n  noIssuesFound: \"No issues found.\",\n  increaseHierarchyLimit: \"Increase limit to {{limit}}\",\n  increaseHierarchyLimitToUnlimited: \"Remove limit\",\n  increaseHierarchyLimitWithFiltering: \"Add Filter\",\n  retry: \"Retry\",\n  rename: \"Rename\",\n  more: \"More\",\n  confirm: \"Confirm\",\n  cancel: \"Cancel\",\n};\n\nconst localizationContext = createContext<LocalizationContext>({ localizedStrings: defaultLocalizedStrings });\n\n/**\n * Properties for `LocalizationContextProvider`.\n * @public\n */\ninterface LocalizationContextProviderProps {\n  /** Localized strings used in the components. */\n  localizedStrings?: Partial<LocalizedStrings>;\n}\n\n/**\n * Context provider for localized strings used in the components.\n * @public\n */\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/stratakit/RootErrorRenderer.d.ts

@@ -0,0 +1,16 @@
+import { RootErrorRendererProps } from "../Renderers.js";
+import { ErrorInfo } from "../TreeNode.js";
+/**
+ * @alpha
+ */
+export type StrataKitRootErrorRendererProps = {
+    /** Root error to be displayed */
+    error: ErrorInfo;
+} & RootErrorRendererProps;
+/**
+ * A component that renders root node error state.
+ *
+ * @alpha
+ */
+export declare function StrataKitRootErrorRenderer({ error, getHierarchyLevelDetails, reloadTree }: StrataKitRootErrorRendererProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=RootErrorRenderer.d.ts.map

package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootErrorRenderer.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/RootErrorRenderer.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,iCAAiC;IACjC,KAAK,EAAE,SAAS,CAAC;CAClB,GAAG,sBAAsB,CAAC;AAE3B;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,EAAE,+BAA+B,2CA+B1H"}

package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.js

@@ -0,0 +1,42 @@
+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 { Button, Text } from "@stratakit/bricks";
+import { Icon } from "@stratakit/foundations";
+import errorSvg from "@stratakit/icons/status-error.svg";
+import { useLocalizationContext } from "./LocalizationContext.js";
+/**
+ * A component that renders root node error state.
+ *
+ * @alpha
+ */
+export function StrataKitRootErrorRenderer({ error, getHierarchyLevelDetails, reloadTree }) {
+    const { localizedStrings } = useLocalizationContext();
+    if (error.type === "ResultSetTooLarge") {
+        const onOverrideLimit = () => getHierarchyLevelDetails(undefined)?.setSizeLimit("unbounded");
+        return (_jsx(RootErrorContainer, { message: localizedStrings.rootResultLimitExceeded.replace("{{limit}}", error.resultSetSizeLimit.toString()), actions: [
+                {
+                    action: onOverrideLimit,
+                    label: localizedStrings.increaseHierarchyLimitToUnlimited,
+                    condition: () => true,
+                },
+            ] }));
+    }
+    return (_jsx(RootErrorContainer, { message: localizedStrings.failedToCreateRootHierarchy, actions: [
+            {
+                action: () => reloadTree({ parentNodeId: undefined, state: "reset" }),
+                label: localizedStrings.retry,
+                condition: () => true,
+            },
+        ] }));
+}
+function RootErrorContainer({ actions, message }) {
+    return (_jsxs("div", { style: { height: "100%", display: "flex", flexDirection: "column", justifyContent: "center", alignItems: "center", gap: "0.5rem" }, children: [_jsx(Icon, { href: errorSvg, size: "large" }), _jsx(Text, { variant: "body-sm", style: { textAlign: "center" }, children: message }), actions
+                ?.filter(({ condition }) => condition())
+                .map((action) => {
+                return (_jsx(Button, { onClick: () => action.action(), children: action.label }, action.label));
+            })] }));
+}
+//# sourceMappingURL=RootErrorRenderer.js.map

package/lib/esm/presentation-hierarchies-react/stratakit/RootErrorRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootErrorRenderer.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/RootErrorRenderer.tsx"],"names":[],"mappings":";AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,QAAQ,MAAM,mCAAmC,CAAC;AAGzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAUlE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAmC;IACzH,MAAM,EAAE,gBAAgB,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAEtD,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACvC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,wBAAwB,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;QAC7F,OAAO,CACL,KAAC,kBAAkB,IACjB,OAAO,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,EAC3G,OAAO,EAAE;gBACP;oBACE,MAAM,EAAE,eAAe;oBACvB,KAAK,EAAE,gBAAgB,CAAC,iCAAiC;oBACzD,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;iBACtB;aACF,GACD,CACH,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,kBAAkB,IACjB,OAAO,EAAE,gBAAgB,CAAC,2BAA2B,EACrD,OAAO,EAAE;YACP;gBACE,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;gBACrE,KAAK,EAAE,gBAAgB,CAAC,KAAK;gBAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;aACtB;SACF,GACD,CACH,CAAC;AACJ,CAAC;AAOD,SAAS,kBAAkB,CAAC,EAAE,OAAO,EAAE,OAAO,EAA2B;IACvE,OAAO,CACL,eAAK,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,aACrI,KAAC,IAAI,IAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAC,OAAO,GAAG,EACrC,KAAC,IAAI,IAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,YACrD,OAAO,GACH,EACN,OAAO;gBACN,EAAE,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC;iBACvC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBACd,OAAO,CACL,KAAC,MAAM,IAAoB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,YACtD,MAAM,CAAC,KAAK,IADF,MAAM,CAAC,KAAK,CAEhB,CACV,CAAC;YACJ,CAAC,CAAC,IACA,CACP,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\nimport { Button, Text } from \"@stratakit/bricks\";\nimport { Icon } from \"@stratakit/foundations\";\nimport errorSvg from \"@stratakit/icons/status-error.svg\";\nimport { RootErrorRendererProps } from \"../Renderers.js\";\nimport { ErrorInfo } from \"../TreeNode.js\";\nimport { useLocalizationContext } from \"./LocalizationContext.js\";\n\n/**\n * @alpha\n */\nexport type StrataKitRootErrorRendererProps = {\n  /** Root error to be displayed */\n  error: ErrorInfo;\n} & RootErrorRendererProps;\n\n/**\n * A component that renders root node error state.\n *\n * @alpha\n */\nexport function StrataKitRootErrorRenderer({ error, getHierarchyLevelDetails, reloadTree }: StrataKitRootErrorRendererProps) {\n  const { localizedStrings } = useLocalizationContext();\n\n  if (error.type === \"ResultSetTooLarge\") {\n    const onOverrideLimit = () => getHierarchyLevelDetails(undefined)?.setSizeLimit(\"unbounded\");\n    return (\n      <RootErrorContainer\n        message={localizedStrings.rootResultLimitExceeded.replace(\"{{limit}}\", error.resultSetSizeLimit.toString())}\n        actions={[\n          {\n            action: onOverrideLimit,\n            label: localizedStrings.increaseHierarchyLimitToUnlimited,\n            condition: () => true,\n          },\n        ]}\n      />\n    );\n  }\n\n  return (\n    <RootErrorContainer\n      message={localizedStrings.failedToCreateRootHierarchy}\n      actions={[\n        {\n          action: () => reloadTree({ parentNodeId: undefined, state: \"reset\" }),\n          label: localizedStrings.retry,\n          condition: () => true,\n        },\n      ]}\n    />\n  );\n}\n\ninterface RootErrorContainerProps {\n  message: string;\n  actions?: { action: () => void; label: string; condition: () => boolean }[];\n}\n\nfunction RootErrorContainer({ actions, message }: RootErrorContainerProps) {\n  return (\n    <div style={{ height: \"100%\", display: \"flex\", flexDirection: \"column\", justifyContent: \"center\", alignItems: \"center\", gap: \"0.5rem\" }}>\n      <Icon href={errorSvg} size=\"large\" />\n      <Text variant={\"body-sm\"} style={{ textAlign: \"center\" }}>\n        {message}\n      </Text>\n      {actions\n        ?.filter(({ condition }) => condition())\n        .map((action) => {\n          return (\n            <Button key={action.label} onClick={() => action.action()}>\n              {action.label}\n            </Button>\n          );\n        })}\n    </div>\n  );\n}\n"]}

package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.d.ts

@@ -0,0 +1,45 @@
+import { ComponentProps } from "react";
+import { Tree } from "@stratakit/structures";
+/**
+ * Attributes used to decide how to render tree actions. They allow to differentiate action style based on the context
+ * where that action is used.
+ * @alpha
+ */
+export interface TreeActionBaseAttributes {
+    /**
+     * Specifies action variant supported by tree nodes:
+     *
+     * - "default" - standard action displayed in the dropdown menu accessible through the ellipsis button on the node.
+     * - "inline" - actions displayed directly on the tree node.
+     * - "context-menu" - actions displayed in the context menu opened by right-clicking the tree node.
+     */
+    variant?: "default" | "inline" | "context-menu";
+    /**
+     * Indicates that the actions is not applicable for current tree node and should be hidden.
+     * When set to true, the action will not be rendered at all.
+     */
+    hide?: boolean;
+}
+/** @alpha */
+export type TreeActionBaseProps = ComponentProps<typeof Tree.ItemAction> & TreeActionBaseAttributes;
+/**
+ * Base component used to render tree actions. It is designed to allow rendering same action in different contexts: inline, dropdown, context menu.
+ * Should be used together with `StrataKitTreeNodeRenderer` and returned from `getInlineActions`, `getMenuActions` and `getContextMenuActions` callbacks.
+ *
+ * When implementing custom action that returns this component, make sure to forward `TreeActionBaseAttributes` props to it. Example:
+ *
+ * ```tsx
+ * interface MyCustomTreeActionProps extends TreeActionBaseAttributes {
+ *   myProp: string
+ * }
+ *
+ * function MyCustomTreeAction({ myProp, ...attributes }: MyCustomTreeActionProps) {
+ *   // custom button logic goes here
+ *   return <TreeActionBase {...attributes} icon={...} onClick={...} />
+ * }
+ * ```
+ *
+ * @alpha
+ */
+export declare const TreeActionBase: import("react").NamedExoticComponent<TreeActionBaseProps>;
+//# sourceMappingURL=TreeAction.d.ts.map

package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeAction.d.ts","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeAction.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAQ,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAgB,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;IAChD;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,aAAa;AACb,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,wBAAwB,CAAC;AAEpG;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,2DAUzB,CAAC"}

package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.js

@@ -0,0 +1,36 @@
+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 { memo } from "react";
+import { DropdownMenu, Tree } from "@stratakit/structures";
+/**
+ * Base component used to render tree actions. It is designed to allow rendering same action in different contexts: inline, dropdown, context menu.
+ * Should be used together with `StrataKitTreeNodeRenderer` and returned from `getInlineActions`, `getMenuActions` and `getContextMenuActions` callbacks.
+ *
+ * When implementing custom action that returns this component, make sure to forward `TreeActionBaseAttributes` props to it. Example:
+ *
+ * ```tsx
+ * interface MyCustomTreeActionProps extends TreeActionBaseAttributes {
+ *   myProp: string
+ * }
+ *
+ * function MyCustomTreeAction({ myProp, ...attributes }: MyCustomTreeActionProps) {
+ *   // custom button logic goes here
+ *   return <TreeActionBase {...attributes} icon={...} onClick={...} />
+ * }
+ * ```
+ *
+ * @alpha
+ */
+export const TreeActionBase = memo(function TreeActionBase({ hide, variant = "default", dot, visible, ...actionProps }) {
+    if (hide) {
+        return variant === "inline" ? _jsx(Tree.ItemAction, { ...actionProps, visible: false }) : undefined;
+    }
+    if (variant === "context-menu") {
+        return _jsx(DropdownMenu.Item, { ...actionProps });
+    }
+    return _jsx(Tree.ItemAction, { ...actionProps, dot: dot, visible: variant === "inline" ? visible : undefined });
+});
+//# sourceMappingURL=TreeAction.js.map

package/lib/esm/presentation-hierarchies-react/stratakit/TreeAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeAction.js","sourceRoot":"","sources":["../../../../src/presentation-hierarchies-react/stratakit/TreeAction.tsx"],"names":[],"mappings":";AAAA;;;gGAGgG;AAEhG,OAAO,EAAkB,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AA0B3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,WAAW,EAAuB;IACzI,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAC,IAAI,CAAC,UAAU,OAAK,WAAW,EAAE,OAAO,EAAE,KAAK,GAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACjG,CAAC;IAED,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;QAC/B,OAAO,KAAC,YAAY,CAAC,IAAI,OAAK,WAAW,GAAI,CAAC;IAChD,CAAC;IAED,OAAO,KAAC,IAAI,CAAC,UAAU,OAAK,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,GAAI,CAAC;AAC7G,CAAC,CAAC,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 { ComponentProps, memo } from \"react\";\nimport { DropdownMenu, Tree } from \"@stratakit/structures\";\n\n/**\n * Attributes used to decide how to render tree actions. They allow to differentiate action style based on the context\n * where that action is used.\n * @alpha\n */\nexport interface TreeActionBaseAttributes {\n  /**\n   * Specifies action variant supported by tree nodes:\n   *\n   * - \"default\" - standard action displayed in the dropdown menu accessible through the ellipsis button on the node.\n   * - \"inline\" - actions displayed directly on the tree node.\n   * - \"context-menu\" - actions displayed in the context menu opened by right-clicking the tree node.\n   */\n  variant?: \"default\" | \"inline\" | \"context-menu\";\n  /**\n   * Indicates that the actions is not applicable for current tree node and should be hidden.\n   * When set to true, the action will not be rendered at all.\n   */\n  hide?: boolean;\n}\n\n/** @alpha */\nexport type TreeActionBaseProps = ComponentProps<typeof Tree.ItemAction> & TreeActionBaseAttributes;\n\n/**\n * Base component used to render tree actions. It is designed to allow rendering same action in different contexts: inline, dropdown, context menu.\n * Should be used together with `StrataKitTreeNodeRenderer` and returned from `getInlineActions`, `getMenuActions` and `getContextMenuActions` callbacks.\n *\n * When implementing custom action that returns this component, make sure to forward `TreeActionBaseAttributes` props to it. Example:\n *\n * ```tsx\n * interface MyCustomTreeActionProps extends TreeActionBaseAttributes {\n *   myProp: string\n * }\n *\n * function MyCustomTreeAction({ myProp, ...attributes }: MyCustomTreeActionProps) {\n *   // custom button logic goes here\n *   return <TreeActionBase {...attributes} icon={...} onClick={...} />\n * }\n * ```\n *\n * @alpha\n */\nexport const TreeActionBase = memo(function TreeActionBase({ hide, variant = \"default\", dot, visible, ...actionProps }: TreeActionBaseProps) {\n  if (hide) {\n    return variant === \"inline\" ? <Tree.ItemAction {...actionProps} visible={false} /> : undefined;\n  }\n\n  if (variant === \"context-menu\") {\n    return <DropdownMenu.Item {...actionProps} />;\n  }\n\n  return <Tree.ItemAction {...actionProps} dot={dot} visible={variant === \"inline\" ? visible : undefined} />;\n});\n"]}

package/lib/esm/presentation-hierarchies-react/stratakit/TreeErrorRenderer.d.ts

@@ -0,0 +1,30 @@
+import { ReactElement } from "react";
+import { ErrorItemRendererProps } from "./ErrorItemRenderer.js";
+import { useErrorNodes } from "./FlatTreeNode.js";
+/**
+ * Interface containing building blocks for `TreeErrorRenderer`.
+ *
+ * @alpha
+ */
+interface TreeErrorRendererOwnProps {
+    /**
+     * A user friendly display label of the tree. Should be unique within the consuming application,
+     * as it's used for creating a unique accessible label for the error region.
+     */
+    treeLabel: string;
+    /** List of error nodes to render errors for. */
+    errorNodes: ReturnType<typeof useErrorNodes>;
+    /** Callback to render custom error messages. Component should be wrapped in `ErrorRegion.Item` from `@itwin/itwinui-react` package. */
+    renderError?: (props: ErrorItemRendererProps) => ReactElement;
+}
+/** @alpha */
+export type TreeErrorRendererProps = TreeErrorRendererOwnProps & Omit<ErrorItemRendererProps, "errorNode">;
+/**
+ * A component that renders error display dropdown using the `unstable_ErrorRegion` component from `@itwin/itwinui-react`.
+ * As input, the component uses a list of `ErrorNode` objects, which are generally created using the `useErrorList` hook.
+ *
+ * @alpha
+ */
+export declare function TreeErrorRenderer({ treeLabel, errorNodes, renderError, ...errorItemRendererProps }: TreeErrorRendererProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TreeErrorRenderer.d.ts.map